diff --git a/docs/content/architecture/configuration.md b/docs/content/architecture/configuration.md index df4e9a4..3eb11bc 100644 --- a/docs/content/architecture/configuration.md +++ b/docs/content/architecture/configuration.md @@ -1,6 +1,6 @@ # Configuration -`config/redot.php` is the single configuration file for `redot/core`. It controls which application surfaces are mounted, the locales the app supports, and locale-aware routing. Its values are available as `config('redot.*')` out of the box. Runtime-editable settings are defined separately in `app/settings.php`. +`config/redot.php` is the single configuration file for `redot/core`. It controls which application surfaces are mounted, the locales the app supports, locale-aware routing, and the bundled packages (Datatables and Toastify). Its values are available as `config('redot.*')` out of the box. Runtime-editable settings are defined separately in `app/settings.php`. ## Publishing the config @@ -15,7 +15,7 @@ The config is merged at runtime, so every key is readable without publishing. Pu `redot.features` toggles the four mountable surfaces and, where relevant, their URL prefix. The package reads these flags both when registering routes and to conditionally render UI (e.g. hiding a "Preview website" link). - **`website`** — mounts the public website routes. Set `enabled` to turn it on or off. -- **`dashboard`** — mounts the back-office routes. `enabled` toggles it; `prefix` sets the URL segment it lives under (default `dashboard`). +- **`dashboard`** — mounts the back-office routes. `enabled` toggles it; `prefix` sets the URL segment it lives under (default `dashboard`); `guard` names the auth guard dashboard users sign in with (default `admins`). The sidebar, `route_allowed()`, and `permissions:sync` fall back to this guard when a route doesn't name one. - **`website-api`** — mounts the public website API routes under `api/`. Set `enabled` to toggle it. - **`dashboard-api`** — mounts the dashboard API routes. `enabled` toggles it; `prefix` sets the segment under `api/` (default `dashboard`). @@ -43,6 +43,30 @@ Once languages exist in the database, the active locale list is built from them, - **`append_locale_to_url`** — when on, the website/dashboard routes are prefixed with a two-letter `{locale}` segment. Turn it off to serve those routes without a locale segment. - **`redirect_non_locale_urls`** — when on, a request to a non-prefixed URL is redirected to its locale-prefixed equivalent (preserving the query string). When off, such URLs return a 404 instead. +## Paths + +`redot.paths` tells core where your application keeps the files it loads by convention. Paths are relative to the application base path. + +- **`routes`** — the `global`, `website`, `dashboard`, `website-api`, and `dashboard-api` route files. Core registers its own global routes (select search, uploads) before yours, so a route in your global file with the same URI and name replaces the package one. +- **`layouts.path`** / **`layouts.namespace`** — where `` finds anonymous layout views and layout classes. + +When you change one path, copy the whole `paths` block into your config: Laravel merges package config only at the top level, so a partial block leaves the other paths undefined. + +## Components + +`redot.components` controls the routes behind three components: `select` (the search endpoint of ``), `uploader` (the upload endpoint of ``), and `hugerte` (image uploads in ``). Each takes: + +- **`enabled`** — registers the routes. Turn it off when the application doesn't use the component; the rich editor keeps working without image uploads. +- **`middleware`** — middleware added to those routes, `throttle:120,1` by default. Add `auth:admins` (or another guard) to limit who can call them. + +## Datatables + +`redot.datatables` configures the [Datatables](/packages/datatables/overview) package: `assets` holds the CSS/JS paths the table loads, and `export` lists each export format with its `enabled` flag and exporter class (plus the template, adapter, and engine options for [PDF](/packages/datatables/export)). + +## Toastify + +`redot.toastify` configures [Toastify](/packages/toastify): `toastifiers` maps each toast type to its icon and color, and `defaults` sets the position, delay, and close button applied to every toast. + ## Permissions `redot.permissions` controls local development shortcuts around route gating. diff --git a/docs/content/commands/overview.md b/docs/content/commands/overview.md index 2ed10ec..aefdc48 100644 --- a/docs/content/commands/overview.md +++ b/docs/content/commands/overview.md @@ -42,18 +42,13 @@ Creates a symbolic link from the framework's `public/` directory to a sibling di - **`--name`** — the name of the link to create (defaults to `public_html`). -## `datatables:link` +## `redot:publish` ```bash -php artisan datatables:link -php artisan datatables:link --force -php artisan datatables:link --relative +php artisan redot:publish ``` -Creates a symbolic link from `public/vendor/datatables` to the Datatables package assets. Required once per install (and again after upgrades) so the table's CSS/JS are served statically. Prefer `vendor:publish --tag=datatables::assets` if symlinks are unavailable. - -- **`--force`** — recreate the symlink if it already exists. -- **`--relative`** — create a relative symlink. +Publishes the Redot front-end assets — the shared runtime, plugins, styles, Datatables assets, and the third-party libraries they use — to `public/vendor/redot`. It replaces the whole directory, so files removed from the package don't linger. The starter kit runs it from Composer's `post-install-cmd` and `post-update-cmd`, so the published assets always match the installed `redot/core`. ## `permissions:sync` diff --git a/docs/content/components/overview.md b/docs/content/components/overview.md index 19dd2c7..460191c 100644 --- a/docs/content/components/overview.md +++ b/docs/content/components/overview.md @@ -30,6 +30,17 @@ To give a custom control the same label, hint, and required marker, wrap it in [ Components that wrap a JavaScript widget (date pickers, selects, the rich editor, uploader, …) light up automatically through the [asset & init system](/frontend/asset-system) — you don't wire up any JS yourself. +## Overriding a component + +The components on this page ship inside the `redot/core` package, so they update with `composer update`. Only the branding and integration components ([Logo](/components/logo), [Favicon](/components/favicon), [Page Loader](/components/page-loader), [Countries](/components/countries), [Facebook Pixel](/components/facebook-pixel), and [Google Analytics](/components/google-analytics)) live in your application. You can still replace a package component in your application without renaming it: + +- **Markup** — add a view with the same name under `resources/components`, such as `resources/components/toasts.blade.php`. Your view is used instead of the package's. +- **Behavior** — add a class with the same name under `App\View\Components`, such as `App\View\Components\Toasts`. Extend the package class (`Redot\View\Components\Toasts`) to change only what you need. + +A markup override of a component that has a class still runs the package class, so your view receives the same props and data as the package view. To add, remove, or rename props, override the class as well. + +The JavaScript and CSS these components load ship with core, along with the third-party libraries they use (jQuery, Tabler, Tom Select, HugeRTE, Coloris, …). `php artisan redot:publish` copies them to `public/vendor/redot` and runs after every `composer install` and `composer update`, so don't edit them there. + ## Component index ### Form inputs @@ -61,6 +72,7 @@ Components that wrap a JavaScript widget (date pickers, selects, the rich editor - [Form Card](/components/form-card) — `` - [Page Header](/components/page-header), [Page Loader](/components/page-loader) - [Pagination](/components/pagination) +- [Redot Styles & Scripts](/frontend/asset-system#loading-the-runtime) — `` / ``, the shared runtime for a layout - [Empty](/components/empty) — empty-state placeholder - [Layouts](/layouts/overview) — page shells (``, …) diff --git a/docs/content/foundation/helpers.md b/docs/content/foundation/helpers.md index 534af1f..b446bef 100644 --- a/docs/content/foundation/helpers.md +++ b/docs/content/foundation/helpers.md @@ -20,7 +20,7 @@ ## URLs & routing -- **`route_allowed('route.name')`** — whether the current admin may access a named route. Use it to show/hide permission-gated UI. It applies the same conventional and explicit permission aliases as route middleware. Routes that opt out of permission middleware are allowed; protected routes defer to the gate. The guard is guessed from the route's `auth` middleware (falling back to `admins`); pass one explicitly as the second argument to override. See [Datatables](/packages/datatables/overview) for the common use. +- **`route_allowed('route.name')`** — whether the current admin may access a named route. Use it to show/hide permission-gated UI. It applies the same conventional and explicit permission aliases as route middleware. Routes that opt out of permission middleware are allowed; protected routes defer to the gate. The guard is guessed from the route's `auth` middleware (falling back to `redot.features.dashboard.guard`); pass one explicitly as the second argument to override. See [Datatables](/packages/datatables/overview) for the common use. ```php Action::edit('posts.edit')->visible(route_allowed('posts.edit')); @@ -42,6 +42,8 @@ {{ __('Back') }} ``` +- **`is_dashboard_request()`** — whether the current request belongs to the dashboard, including unmatched URLs (such as 404s) under the dashboard prefix. Useful in shared views like error pages. + ## Requests & API responses - **`throw_api_exception($e)`** — turn any caught exception into the standard JSON error envelope (mapping common exceptions to the right HTTP status). You rarely call this directly — it is wired in as the global JSON exception renderer. See [Controllers & API Responses](/foundation/controllers-and-responses). @@ -54,6 +56,8 @@ } ``` +- **`current_sessions('admins')`** — the active browser sessions of the account signed in on the given guard, newest first. Returns an empty collection unless the `database` session driver is used. + - **`is_mobile()` / `is_desktop()`** — detect the device from the request's user agent. Both return `false` safely when there is no request (e.g. console). ```php diff --git a/docs/content/frontend/asset-system.md b/docs/content/frontend/asset-system.md index 687c98b..f03fa6a 100644 --- a/docs/content/frontend/asset-system.md +++ b/docs/content/frontend/asset-system.md @@ -1,6 +1,6 @@ # Asset & Init System -The dashboard frontend is shipped as static assets under `public/assets` — there is no Vite/Webpack build for the platform layer. A small artisan step compiles per-feature "init" scripts and translations, and a runtime `init()` bootstrap attaches them to any element that carries an `init="..."` attribute. This page is the canonical reference for how JavaScript widgets get wired up. +The dashboard frontend is shipped as static assets — there is no Vite/Webpack build for the platform layer. The shared runtime (`functions.js`, `themer.js`, the `redot-*` plugins, and `redot.css`) ships with `redot/core`, together with the third-party libraries it relies on, and `php artisan redot:publish` copies all of it to `public/vendor/redot`. Your application's own assets live under `public/assets`. A small artisan step compiles per-feature "init" scripts and translations, and a runtime `init()` bootstrap attaches them to any element that carries an `init="..."` attribute. This page is the canonical reference for how JavaScript widgets get wired up. ## Enabling a widget with `init` @@ -33,6 +33,33 @@ Each has its own page with the options it accepts: - [Turnstile](/frontend/inits/turnstile) — Cloudflare captcha - [Uploader](/frontend/inits/uploader) +## Loading the runtime + +A layout loads the whole shared runtime with two components, so the list of libraries and their order stays with `redot/core` and updates with it: + +```blade + + ... + + + + + + {{ $slot }} + + + + + @stack('plugins-scripts') + @stack('scripts') + +``` + +- **``** — Tabler (in the given `direction`, defaulting to the current language's), Tabler Icons, Glare, OverlayScrollbars, the `plugins-styles` stack, and `redot.css`. Load your application CSS right after it so your rules win. +- **``** — jQuery, Lodash, Tabler, `functions.js`, the bundled plugins, the translations and initializer bundles, the runtime (`runtime.js`: running initializers as markup appears, client-side form validation, the CSRF header and session-expiry dialog for AJAX, lightbox links, and Bootbox defaults), toasts, and the restoring of submitted input and validation errors. Load your application script right after it; `app.js` is yours to fill. + +The scaffold layout already uses both. To change what they load, [override](/components/overview) `resources/components/redot-styles.blade.php` or `redot-scripts.blade.php`. + ## Loading a widget's vendor files Components load the third-party scripts and styles their widget needs. If you put an `init` attribute on your own markup instead, include the matching `` component so those files are on the page: @@ -93,9 +120,12 @@ php artisan dependencies:build 2. Use it from Blade: `
`. 3. The next request rebuilds `dist/` and your initializer is live as `init="my-widget"`. +The built-in initializers ship with `redot/core`. To change one, add a file with the same name to `public/assets/inits` (for example `public/assets/inits/tomselect.js`); it replaces the package version in the build. + ## Gotchas - **Never edit `public/assets/dist/*` by hand** — it is regenerated. Edit the source `public/assets/inits/*.js` and `lang/*` files instead. +- **Never edit `public/vendor/redot/*`** — `redot:publish` replaces it after every `composer install` and `composer update`. Override a component or initializer in your application instead. - An element is initialized only once. If you re-render it and need it re-initialized, render fresh markup rather than reusing an already-initialized element. ## Related diff --git a/docs/content/frontend/inits/hugerte.md b/docs/content/frontend/inits/hugerte.md index 65f9cbc..193c5be 100644 --- a/docs/content/frontend/inits/hugerte.md +++ b/docs/content/frontend/inits/hugerte.md @@ -21,7 +21,7 @@ See [Asset & Init System](/frontend/asset-system) for how the `init` attribute i ## Options -The toolbar, plugins, and height come preconfigured, and the editor reads its language, direction, and skin from the page — so there is little to set per field. Images pasted or picked in the editor upload automatically through the configured upload endpoint. +The toolbar, plugins, and height come preconfigured, and the editor reads its language, direction, and skin from the page — so there is little to set per field. Images pasted or picked in the editor upload automatically to the URL in the field's `hugerte-upload-url` attribute, which `` fills in from the `global.hugerte.upload` route. Without that attribute (for example when `redot.components.hugerte.enabled` is off), image uploads are turned off. The field must have an `id` (the component generates one if you omit it). When the user toggles light/dark, the editor rebuilds to pick up the new skin. diff --git a/docs/content/getting-started/installation.md b/docs/content/getting-started/installation.md index 46f13b9..daa145b 100644 --- a/docs/content/getting-started/installation.md +++ b/docs/content/getting-started/installation.md @@ -53,11 +53,10 @@ php artisan migrate ## Sub-package publish tags -The bundled packages expose their own tags, all following the `package::resource` convention. Their config, views, lang, and routes load automatically; publish only to override. +The bundled packages share the Redot configuration and publish tags: their settings live in `config/redot.php` (under `datatables` and `toastify`), and their assets are published by `php artisan redot:publish`. Views and translations load automatically; publish only to override. -- **Datatables** — `datatables::config`, `datatables::views`, `datatables::lang`, `datatables::assets`. Run `php artisan datatables:link` (or publish `datatables::assets`) so CSS/JS are available under `public/vendor/datatables`. See [Datatables](/packages/datatables/overview). -- **Toastify** — `toastify::config`. See [Toastify](/packages/toastify). -- **Auth, Sidebar, LangExtractor** — nothing to publish; they are wired up for you. +- **Datatables** — `redot::datatables-views`, `redot::datatables-lang`. See [Datatables](/packages/datatables/overview). +- **Toastify, Auth, Sidebar, LangExtractor** — nothing extra to publish; they are wired up for you. ## Publish everything at once diff --git a/docs/content/packages/datatables/export.md b/docs/content/packages/datatables/export.md index 9c5a1cc..64248a1 100644 --- a/docs/content/packages/datatables/export.md +++ b/docs/content/packages/datatables/export.md @@ -4,10 +4,10 @@ Every datatable can offer an export menu so users download the current dataset. ## Enabling PDF export -PDF is configured in `config/datatables.php` under the `export` block. Publish the config first: +PDF is configured under `datatables.export` in `config/redot.php`. Publish the Redot config first if you haven't: ```bash -php artisan vendor:publish --tag=datatables::config +php artisan vendor:publish --tag=redot::config ``` PDF export needs a rendering library installed. The default uses mPDF — install it and you're done: @@ -20,7 +20,7 @@ If the export menu offers PDF but the library isn't installed, the export fails ## Options -Configure these under `export.pdf` in `config/datatables.php`: +Configure these under `datatables.export.pdf` in `config/redot.php`: - **`enabled`** — whether PDF appears among the table's export choices. - **`template`** — the Blade view rendered into the PDF. Defaults to the packaged template; point it at your own for a custom layout. @@ -38,7 +38,7 @@ composer require barryvdh/laravel-dompdf ``` ```php -// config/datatables.php +// config/redot.php — datatables.export.pdf 'adapter' => \Redot\Datatables\Adapters\PDF\DomPdf::class, ``` @@ -76,14 +76,14 @@ Set `template` to your own Blade view. Your template receives `$headings` (an ar ``` ```php -// config/datatables.php +// config/redot.php — datatables.export.pdf 'template' => 'templates.pdf.datatable', ``` To tweak the packaged template instead of replacing it, publish the views and edit your copy: ```bash -php artisan vendor:publish --tag=datatables::views +php artisan vendor:publish --tag=redot::datatables-views ``` ### Per-table overrides diff --git a/docs/content/packages/datatables/frontend.md b/docs/content/packages/datatables/frontend.md index 1262ffd..946cd6c 100644 --- a/docs/content/packages/datatables/frontend.md +++ b/docs/content/packages/datatables/frontend.md @@ -69,24 +69,7 @@ A datatable is a Livewire component, so mount it with Livewire's tag syntax. Pub ## Assets -The package ships plain JS and CSS under `public/vendor/datatables` — there's no build step or `npm` publish. Link them once (like `storage:link`), then the table injects them automatically the first time one renders: - -```bash -php artisan datatables:link -php artisan datatables:link --force -php artisan datatables:link --relative -``` - -- **`--force`** — recreate the symlink if it already exists. -- **`--relative`** — create a relative symlink (useful in some deploy layouts). - -Prefer a copy instead of a symlink? Publish the assets: - -```bash -php artisan vendor:publish --tag=datatables::assets --force -``` - -Re-run the link (or publish with `--force`) after upgrading `redot/core` so CSS/JS stay current. The scripts expect the dashboard's globals: jQuery, Bootstrap dropdowns, Livewire, and the helpers from `functions.js` — confirmable [actions](/packages/datatables/actions) prompt through `warnBeforeAction`, and non-GET actions submit through `formRequest` (which reads the CSRF token from the layout's `csrf-token` meta tag). See the [Asset & Init System](/frontend/asset-system) for how front-end assets are served. +The package ships plain JS and CSS — there's no build step or `npm` publish. [`redot:publish`](/commands/overview) copies them to `public/vendor/redot/datatables` with the rest of the Redot assets, and the table injects them automatically the first time one renders. The scripts expect the dashboard's globals: jQuery, Bootstrap dropdowns, Livewire, and the helpers from `functions.js` — confirmable [actions](/packages/datatables/actions) prompt through `warnBeforeAction`, and non-GET actions submit through `formRequest` (which reads the CSRF token from the layout's `csrf-token` meta tag). See the [Asset & Init System](/frontend/asset-system) for how front-end assets are served. The script exposes its helpers as `window.Datatables` — the package views consume them (the Alpine components behind the root card, the select-page checkbox, and the action click handling) instead of inlining the logic. If you publish and customize the views, reuse the same helpers: `Datatables.table()` and `Datatables.pageSelection()` for the Alpine state, and `Datatables.confirmed()` / `Datatables.submit()` / `Datatables.url()` / `Datatables.invoke()` for action behavior. @@ -95,11 +78,11 @@ The script exposes its helpers as `window.Datatables` — the package views cons Publish the package's views or translations to override them: ```bash -# Blade views -> resources/views/vendor/datatables -php artisan vendor:publish --tag=datatables::views +# Blade views -> resources/views/vendor/redot/datatables +php artisan vendor:publish --tag=redot::datatables-views -# Translations -> lang/vendor/datatables -php artisan vendor:publish --tag=datatables::lang +# Translations -> lang/vendor/redot +php artisan vendor:publish --tag=redot::datatables-lang ``` All built-in labels, placeholders, and messages are localizable through the published translation files. diff --git a/docs/content/packages/lang-extractor.md b/docs/content/packages/lang-extractor.md index 4236f9c..3e3737e 100644 --- a/docs/content/packages/lang-extractor.md +++ b/docs/content/packages/lang-extractor.md @@ -41,7 +41,7 @@ Arguments that are not fully literal — `__($label)` or `__('Prefix ' . $suffix Extraction deliberately skips file-based keys such as `__('validation.required')`, since those live in PHP language files rather than the editable JSON set. A string only counts as file-based when it has no whitespace and starts with the name of a PHP language file in the fallback locale, so a sentence like `__('validation.rules are strict here')` is still extracted. File-based keys enter the editor only through `lang:sync`. -By default the scan covers `app`, `resources`, `routes`, `database/seeders`, and `public/assets`; directories that don't exist are ignored. Only `.php` and `.js` files are searched. Files ignored by Git are skipped. +By default the scan covers `app`, `resources`, `routes`, `database/seeders`, and `public/assets`, plus the views and scripts shipped by `redot/core`; directories that don't exist are ignored. Only `.php` and `.js` files are searched. Files ignored by Git are skipped in your application's directories, but not in `redot/core`'s, which live under the ignored `vendor` directory. ## Limitations @@ -51,7 +51,7 @@ Extraction is static pattern matching, not a full PHP or JavaScript parser: - **Only the listed helpers.** Calls through a translator instance (`$translator->get(...)`) or other APIs are not scanned. `Lang::get` / `Lang::choice` must appear with that `Lang::` prefix (an aliased `use` is fine; a renamed import is not). - **File-based PHP language keys stay out of extract.** Keys like `__('validation.required')` are filtered out; bring them into the editor with `lang:sync` instead. - **Empty strings are dropped.** `__('')` never becomes a token. -- **Scan scope is fixed for the Artisan command.** `lang:extract` only walks the directories and extensions above. Other paths (packages under `vendor`, custom folders, `.vue` files, and so on) are ignored unless you drive `LangExtractor` yourself. +- **Scan scope is fixed for the Artisan command.** `lang:extract` only walks the directories and extensions above. Other paths (other packages under `vendor`, custom folders, `.vue` files, and so on) are ignored unless you drive `LangExtractor` yourself. When you do, pass package sources to `searchInPackages()` instead of `searchIn()` so Git ignore rules don't filter them out. ## Notes diff --git a/docs/content/packages/toastify.md b/docs/content/packages/toastify.md index 43585d2..cf2f352 100644 --- a/docs/content/packages/toastify.md +++ b/docs/content/packages/toastify.md @@ -76,10 +76,10 @@ toastify().success('Saved', 'Your changes were saved.', { delay: 5000 }); ## Customizing toast types -The available types and their styling live in `config/toastify.php`. Publish it to add or restyle types: +The available types and their styling live under the `toastify` key of `config/redot.php`. Publish the Redot config if you haven't already, then add or restyle types there: ```bash -php artisan vendor:publish --tag=toastify::config +php artisan vendor:publish --tag=redot::config ``` - **`toastifiers`** — the map of toast types. Out of the box: `toast`, `error`, `success`, `info`, and `warning`, each with an icon and optional icon color. Add a key here to create a new type — it becomes callable as `toastify()->yourType(...)` and from JavaScript. diff --git a/src/Datatables/config/datatables.php b/src/Datatables/config/datatables.php deleted file mode 100644 index 9062ae5..0000000 --- a/src/Datatables/config/datatables.php +++ /dev/null @@ -1,52 +0,0 @@ - [ - 'css' => 'vendor/datatables/datatables.css', - 'js' => 'vendor/datatables/datatables.js', - ], - - 'export' => [ - 'xlsx' => [ - 'enabled' => true, - 'exporter' => XlsxExporter::class, - ], - - 'csv' => [ - 'enabled' => true, - 'exporter' => CsvExporter::class, - ], - - 'json' => [ - 'enabled' => true, - 'exporter' => JsonExporter::class, - ], - - 'pdf' => [ - 'enabled' => true, - 'exporter' => PdfExporter::class, - 'template' => 'datatables::pdf.default', - 'adapter' => LaravelMpdf::class, - 'options' => [ - 'format' => 'A4', - 'orientation' => 'P', - ], - ], - ], -]; diff --git a/src/Datatables/lang/ar/datatable.php b/src/Datatables/lang/ar/datatables.php similarity index 100% rename from src/Datatables/lang/ar/datatable.php rename to src/Datatables/lang/ar/datatables.php diff --git a/src/Datatables/lang/en/datatable.php b/src/Datatables/lang/en/datatables.php similarity index 100% rename from src/Datatables/lang/en/datatable.php rename to src/Datatables/lang/en/datatables.php diff --git a/src/Datatables/resources/views/datatable.blade.php b/src/Datatables/resources/views/datatables/datatable.blade.php similarity index 56% rename from src/Datatables/resources/views/datatable.blade.php rename to src/Datatables/resources/views/datatables/datatable.blade.php index 404c3bc..f9f7c9f 100644 --- a/src/Datatables/resources/views/datatable.blade.php +++ b/src/Datatables/resources/views/datatables/datatable.blade.php @@ -1,52 +1,52 @@ @assets - - + + @endassets
- @include('datatables::partials.per-page') + @include('redot::datatables.partials.per-page')
@if ($searchable)
- @include('datatables::partials.search') + @include('redot::datatables.partials.search')
@endif @if ($exportable)
- @include('datatables::partials.export') + @include('redot::datatables.partials.export')
@endif @if ($filterable)
- @include('datatables::partials.filters-toggle') + @include('redot::datatables.partials.filters-toggle')
@endif
- @include('datatables::partials.refresh') + @include('redot::datatables.partials.refresh')
@if ($filterable)
- @include('datatables::partials.filters') + @include('redot::datatables.partials.filters')
@endif @if ($selectable)
- @include('datatables::partials.bulk-actions') + @include('redot::datatables.partials.bulk-actions')
@endif - @include('datatables::partials.table') + @include('redot::datatables.partials.table')
- @include('datatables::partials.pagination') + @include('redot::datatables.partials.pagination')
diff --git a/src/Datatables/resources/views/filters/date.blade.php b/src/Datatables/resources/views/datatables/filters/date.blade.php similarity index 100% rename from src/Datatables/resources/views/filters/date.blade.php rename to src/Datatables/resources/views/datatables/filters/date.blade.php diff --git a/src/Datatables/resources/views/filters/number.blade.php b/src/Datatables/resources/views/datatables/filters/number.blade.php similarity index 100% rename from src/Datatables/resources/views/filters/number.blade.php rename to src/Datatables/resources/views/datatables/filters/number.blade.php diff --git a/src/Datatables/resources/views/filters/select.blade.php b/src/Datatables/resources/views/datatables/filters/select.blade.php similarity index 100% rename from src/Datatables/resources/views/filters/select.blade.php rename to src/Datatables/resources/views/datatables/filters/select.blade.php diff --git a/src/Datatables/resources/views/filters/string.blade.php b/src/Datatables/resources/views/datatables/filters/string.blade.php similarity index 100% rename from src/Datatables/resources/views/filters/string.blade.php rename to src/Datatables/resources/views/datatables/filters/string.blade.php diff --git a/src/Datatables/resources/views/filters/ternary.blade.php b/src/Datatables/resources/views/datatables/filters/ternary.blade.php similarity index 100% rename from src/Datatables/resources/views/filters/ternary.blade.php rename to src/Datatables/resources/views/datatables/filters/ternary.blade.php diff --git a/src/Datatables/resources/views/datatables/filters/trashed.blade.php b/src/Datatables/resources/views/datatables/filters/trashed.blade.php new file mode 100644 index 0000000..5c7cfef --- /dev/null +++ b/src/Datatables/resources/views/datatables/filters/trashed.blade.php @@ -0,0 +1,5 @@ + diff --git a/src/Datatables/resources/views/pagination/default.blade.php b/src/Datatables/resources/views/datatables/pagination/default.blade.php similarity index 89% rename from src/Datatables/resources/views/pagination/default.blade.php rename to src/Datatables/resources/views/datatables/pagination/default.blade.php index 3134589..0ac5e65 100644 --- a/src/Datatables/resources/views/pagination/default.blade.php +++ b/src/Datatables/resources/views/datatables/pagination/default.blade.php @@ -4,7 +4,7 @@
    {{-- Previous Page Link --}} @if ($paginator->onFirstPage()) -
  • +
    • @else @@ -12,7 +12,7 @@ + wire:loading.attr="disabled" rel="prev" aria-label="@lang('redot::datatables.pagination.previous')">‹ @endif @@ -48,10 +48,10 @@ class="page-link">{{ $element }} + wire:loading.attr="disabled" rel="next" aria-label="@lang('redot::datatables.pagination.next')">› @else -
  • +
    • @endif diff --git a/src/Datatables/resources/views/partials/action-group.blade.php b/src/Datatables/resources/views/datatables/partials/action-group.blade.php similarity index 90% rename from src/Datatables/resources/views/partials/action-group.blade.php rename to src/Datatables/resources/views/datatables/partials/action-group.blade.php index 1243995..d81ae0d 100644 --- a/src/Datatables/resources/views/partials/action-group.blade.php +++ b/src/Datatables/resources/views/datatables/partials/action-group.blade.php @@ -12,7 +12,7 @@
    @foreach ($action->actions as $action) @if ($action->shouldRender($row)) - @include('datatables::partials.action', [ + @include('redot::datatables.partials.action', [ 'action' => $action, 'row' => $row, ]) diff --git a/src/Datatables/resources/views/partials/action.blade.php b/src/Datatables/resources/views/datatables/partials/action.blade.php similarity index 100% rename from src/Datatables/resources/views/partials/action.blade.php rename to src/Datatables/resources/views/datatables/partials/action.blade.php diff --git a/src/Datatables/resources/views/partials/bulk-actions.blade.php b/src/Datatables/resources/views/datatables/partials/bulk-actions.blade.php similarity index 64% rename from src/Datatables/resources/views/partials/bulk-actions.blade.php rename to src/Datatables/resources/views/datatables/partials/bulk-actions.blade.php index 7a2ec35..e5d48ac 100644 --- a/src/Datatables/resources/views/partials/bulk-actions.blade.php +++ b/src/Datatables/resources/views/datatables/partials/bulk-actions.blade.php @@ -1,17 +1,17 @@
    - +
    - - @lang('datatables::datatable.bulk.actions') + + @lang('redot::datatables.bulk.actions')
    - + @foreach ($bulkActions as $bulkAction) - @include('datatables::partials.action', [ + @include('redot::datatables.partials.action', [ 'action' => $bulkAction, 'row' => null, ]) @@ -25,7 +25,7 @@ - @lang('datatables::datatable.bulk.cancel') + @lang('redot::datatables.bulk.cancel')
    diff --git a/src/Datatables/resources/views/partials/empty.blade.php b/src/Datatables/resources/views/datatables/partials/empty.blade.php similarity index 100% rename from src/Datatables/resources/views/partials/empty.blade.php rename to src/Datatables/resources/views/datatables/partials/empty.blade.php diff --git a/src/Datatables/resources/views/partials/export.blade.php b/src/Datatables/resources/views/datatables/partials/export.blade.php similarity index 86% rename from src/Datatables/resources/views/partials/export.blade.php rename to src/Datatables/resources/views/datatables/partials/export.blade.php index 2552fa2..9e1ef40 100644 --- a/src/Datatables/resources/views/partials/export.blade.php +++ b/src/Datatables/resources/views/datatables/partials/export.blade.php @@ -11,7 +11,7 @@ - @lang('datatables::datatable.exports.pdf') + @lang('redot::datatables.exports.pdf') @endif @@ -23,7 +23,7 @@ - @lang('datatables::datatable.exports.excel') + @lang('redot::datatables.exports.excel') @endif @@ -35,7 +35,7 @@ - @lang('datatables::datatable.exports.csv') + @lang('redot::datatables.exports.csv') @endif @@ -47,7 +47,7 @@ - @lang('datatables::datatable.exports.json') + @lang('redot::datatables.exports.json') @endif diff --git a/src/Datatables/resources/views/partials/filters-toggle.blade.php b/src/Datatables/resources/views/datatables/partials/filters-toggle.blade.php similarity index 100% rename from src/Datatables/resources/views/partials/filters-toggle.blade.php rename to src/Datatables/resources/views/datatables/partials/filters-toggle.blade.php diff --git a/src/Datatables/resources/views/partials/filters.blade.php b/src/Datatables/resources/views/datatables/partials/filters.blade.php similarity index 100% rename from src/Datatables/resources/views/partials/filters.blade.php rename to src/Datatables/resources/views/datatables/partials/filters.blade.php diff --git a/src/Datatables/resources/views/partials/pagination.blade.php b/src/Datatables/resources/views/datatables/partials/pagination.blade.php similarity index 85% rename from src/Datatables/resources/views/partials/pagination.blade.php rename to src/Datatables/resources/views/datatables/partials/pagination.blade.php index 4041669..9183d02 100644 --- a/src/Datatables/resources/views/partials/pagination.blade.php +++ b/src/Datatables/resources/views/datatables/partials/pagination.blade.php @@ -1,6 +1,6 @@
    - @lang('datatables::datatable.pagination.showing', [ + @lang('redot::datatables.pagination.showing', [ 'first' => $rows->firstItem() ?? 0, 'last' => $rows->lastItem() ?? 0, 'total' => $rows->total(), diff --git a/src/Datatables/resources/views/partials/per-page.blade.php b/src/Datatables/resources/views/datatables/partials/per-page.blade.php similarity index 100% rename from src/Datatables/resources/views/partials/per-page.blade.php rename to src/Datatables/resources/views/datatables/partials/per-page.blade.php diff --git a/src/Datatables/resources/views/partials/refresh.blade.php b/src/Datatables/resources/views/datatables/partials/refresh.blade.php similarity index 100% rename from src/Datatables/resources/views/partials/refresh.blade.php rename to src/Datatables/resources/views/datatables/partials/refresh.blade.php diff --git a/src/Datatables/resources/views/partials/search.blade.php b/src/Datatables/resources/views/datatables/partials/search.blade.php similarity index 74% rename from src/Datatables/resources/views/partials/search.blade.php rename to src/Datatables/resources/views/datatables/partials/search.blade.php index 427c7c9..ee6032d 100644 --- a/src/Datatables/resources/views/partials/search.blade.php +++ b/src/Datatables/resources/views/datatables/partials/search.blade.php @@ -1,6 +1,6 @@
    + placeholder="@lang('redot::datatables.search')" /> diff --git a/src/Datatables/resources/views/partials/table.blade.php b/src/Datatables/resources/views/datatables/partials/table.blade.php similarity index 90% rename from src/Datatables/resources/views/partials/table.blade.php rename to src/Datatables/resources/views/datatables/partials/table.blade.php index 40d0415..88bffec 100644 --- a/src/Datatables/resources/views/partials/table.blade.php +++ b/src/Datatables/resources/views/datatables/partials/table.blade.php @@ -13,7 +13,7 @@ @@ -59,7 +59,7 @@ @if ($selectable) @endif @@ -76,9 +76,9 @@ @foreach ($actions as $action) @if ($action->shouldRender($row)) @if ($action->isActionGroup) - @include('datatables::partials.action-group') + @include('redot::datatables.partials.action-group') @else - @include('datatables::partials.action') + @include('redot::datatables.partials.action') @endif @endif @endforeach @@ -89,7 +89,7 @@ @empty - @include('datatables::partials.empty') + @include('redot::datatables.partials.empty') @endforelse diff --git a/src/Datatables/resources/views/pdf/default.blade.php b/src/Datatables/resources/views/datatables/pdf/default.blade.php similarity index 94% rename from src/Datatables/resources/views/pdf/default.blade.php rename to src/Datatables/resources/views/datatables/pdf/default.blade.php index 254da40..a2f0228 100644 --- a/src/Datatables/resources/views/pdf/default.blade.php +++ b/src/Datatables/resources/views/datatables/pdf/default.blade.php @@ -10,7 +10,7 @@ - @lang('datatables::datatable.export') {{ date('Y-m-d H:i:s') }} + @lang('redot::datatables.export') {{ date('Y-m-d H:i:s') }} ");const m=c(e),v=i(e),y=' +@endPushOnce diff --git a/src/Foundation/resources/components/assets/cloudflare-turnstile.blade.php b/src/Foundation/resources/components/assets/cloudflare-turnstile.blade.php new file mode 100644 index 0000000..34dfa9e --- /dev/null +++ b/src/Foundation/resources/components/assets/cloudflare-turnstile.blade.php @@ -0,0 +1,7 @@ +@pushOnce('meta', 'cloudflare-turnstile-meta') + +@endPushOnce + +@pushOnce('plugins-scripts', 'cloudflare-turnstile-scripts') + +@endPushOnce diff --git a/src/Foundation/resources/components/assets/coloris.blade.php b/src/Foundation/resources/components/assets/coloris.blade.php new file mode 100644 index 0000000..5755b37 --- /dev/null +++ b/src/Foundation/resources/components/assets/coloris.blade.php @@ -0,0 +1,7 @@ +@pushOnce('plugins-styles', 'coloris-styles') + +@endPushOnce + +@pushOnce('plugins-scripts', 'coloris-scripts') + +@endPushOnce diff --git a/src/Foundation/resources/components/assets/hugerte.blade.php b/src/Foundation/resources/components/assets/hugerte.blade.php new file mode 100644 index 0000000..523d341 --- /dev/null +++ b/src/Foundation/resources/components/assets/hugerte.blade.php @@ -0,0 +1,3 @@ +@pushOnce('plugins-scripts', 'hugerte-scripts') + +@endPushOnce diff --git a/src/Foundation/resources/components/assets/query-builder.blade.php b/src/Foundation/resources/components/assets/query-builder.blade.php new file mode 100644 index 0000000..92766b5 --- /dev/null +++ b/src/Foundation/resources/components/assets/query-builder.blade.php @@ -0,0 +1,11 @@ + + + +@pushOnce('plugins-styles', 'query-builder-styles') + +@endPushOnce + +@pushOnce('plugins-scripts', 'query-builder-scripts') + + +@endPushOnce diff --git a/src/Foundation/resources/components/assets/redot-icon-picker.blade.php b/src/Foundation/resources/components/assets/redot-icon-picker.blade.php new file mode 100644 index 0000000..2e08bd7 --- /dev/null +++ b/src/Foundation/resources/components/assets/redot-icon-picker.blade.php @@ -0,0 +1,53 @@ +@pushOnce('plugins-scripts', 'icon-picker-scripts') + +@endPushOnce + +@pushOnce('templates', 'icon-picker-template') + +@endPushOnce diff --git a/src/Foundation/resources/components/assets/redot-repeater.blade.php b/src/Foundation/resources/components/assets/redot-repeater.blade.php new file mode 100644 index 0000000..b633a2e --- /dev/null +++ b/src/Foundation/resources/components/assets/redot-repeater.blade.php @@ -0,0 +1,3 @@ +@pushOnce('plugins-scripts', 'repeater-scripts') + +@endPushOnce diff --git a/src/Foundation/resources/components/assets/redot-toasts.blade.php b/src/Foundation/resources/components/assets/redot-toasts.blade.php new file mode 100644 index 0000000..116fe33 --- /dev/null +++ b/src/Foundation/resources/components/assets/redot-toasts.blade.php @@ -0,0 +1,3 @@ +@pushOnce('plugins-scripts', 'redot-toasts-scripts') + +@endPushOnce diff --git a/src/Foundation/resources/components/assets/redot-uploader.blade.php b/src/Foundation/resources/components/assets/redot-uploader.blade.php new file mode 100644 index 0000000..8313105 --- /dev/null +++ b/src/Foundation/resources/components/assets/redot-uploader.blade.php @@ -0,0 +1,3 @@ +@pushOnce('plugins-scripts', 'uploader-scripts') + +@endPushOnce diff --git a/src/Foundation/resources/components/assets/tabler-flags.blade.php b/src/Foundation/resources/components/assets/tabler-flags.blade.php new file mode 100644 index 0000000..caa43c8 --- /dev/null +++ b/src/Foundation/resources/components/assets/tabler-flags.blade.php @@ -0,0 +1,3 @@ +@pushOnce('plugins-styles', 'tabler-flags-styles') + +@endPushOnce diff --git a/src/Foundation/resources/components/assets/tabler-socials.blade.php b/src/Foundation/resources/components/assets/tabler-socials.blade.php new file mode 100644 index 0000000..8d8b01c --- /dev/null +++ b/src/Foundation/resources/components/assets/tabler-socials.blade.php @@ -0,0 +1,3 @@ +@pushOnce('plugins-styles', 'tabler-socials-styles') + +@endPushOnce diff --git a/src/Foundation/resources/components/assets/tempus-dominus.blade.php b/src/Foundation/resources/components/assets/tempus-dominus.blade.php new file mode 100644 index 0000000..7dfc320 --- /dev/null +++ b/src/Foundation/resources/components/assets/tempus-dominus.blade.php @@ -0,0 +1,11 @@ +@pushOnce('plugins-styles', 'tempus-dominus-styles') + +@endPushOnce + +@pushOnce('plugins-scripts', 'popper-scripts') + +@endPushOnce + +@pushOnce('plugins-scripts', 'tempus-dominus-scripts') + +@endPushOnce diff --git a/src/Foundation/resources/components/assets/tom-select.blade.php b/src/Foundation/resources/components/assets/tom-select.blade.php new file mode 100644 index 0000000..6ddde3f --- /dev/null +++ b/src/Foundation/resources/components/assets/tom-select.blade.php @@ -0,0 +1,7 @@ +@pushOnce('plugins-styles', 'tom-select-styles') + +@endPushOnce + +@pushOnce('plugins-scripts', 'tom-select-scripts') + +@endPushOnce diff --git a/src/Foundation/resources/components/attachments.blade.php b/src/Foundation/resources/components/attachments.blade.php new file mode 100644 index 0000000..6eeb25e --- /dev/null +++ b/src/Foundation/resources/components/attachments.blade.php @@ -0,0 +1,43 @@ +@if ($title) + +@endif + +
    class(['form-control', 'overflow-hidden', 'rounded-3', 'p-0']) }}> +
    + +
    +
    diff --git a/src/Foundation/resources/components/avatar.blade.php b/src/Foundation/resources/components/avatar.blade.php new file mode 100644 index 0000000..45c218b --- /dev/null +++ b/src/Foundation/resources/components/avatar.blade.php @@ -0,0 +1,4 @@ + diff --git a/src/Foundation/resources/components/captcha.blade.php b/src/Foundation/resources/components/captcha.blade.php new file mode 100644 index 0000000..d4c371a --- /dev/null +++ b/src/Foundation/resources/components/captcha.blade.php @@ -0,0 +1,7 @@ + + + +
    + +
    +     diff --git a/src/Foundation/resources/components/checkboxes.blade.php b/src/Foundation/resources/components/checkboxes.blade.php new file mode 100644 index 0000000..1f41726 --- /dev/null +++ b/src/Foundation/resources/components/checkboxes.blade.php @@ -0,0 +1,15 @@ + +
    only('class') }}> + @foreach ($options as $key => $label) + + @endforeach + + {{ $slot }} +
    +     diff --git a/src/Foundation/resources/components/color-picker.blade.php b/src/Foundation/resources/components/color-picker.blade.php new file mode 100644 index 0000000..c233391 --- /dev/null +++ b/src/Foundation/resources/components/color-picker.blade.php @@ -0,0 +1,5 @@ + + + + class(['form-control'])->merge(['init' => 'coloris']) }} /> + diff --git a/src/Foundation/resources/components/date-picker.blade.php b/src/Foundation/resources/components/date-picker.blade.php new file mode 100644 index 0000000..f7494aa --- /dev/null +++ b/src/Foundation/resources/components/date-picker.blade.php @@ -0,0 +1,12 @@ + + + +
    + class(['form-control'])->merge(['init' => 'tempus-dominus']) }} /> + + + + +
    +     diff --git a/src/Foundation/resources/components/empty.blade.php b/src/Foundation/resources/components/empty.blade.php new file mode 100644 index 0000000..22ec017 --- /dev/null +++ b/src/Foundation/resources/components/empty.blade.php @@ -0,0 +1,31 @@ +@props([ + 'icon' => 'ti ti-circle-x', + 'title' => __('Nothing to show here'), + 'subtitle' => __('Trust me, I\'ve looked everywhere, there\'s nothing here :('), +]) + +
    class(['card']) }}> +
    + @if ($icon) +
    + +
    + @endif + +

    + {{ $title }} +

    + + @if ($subtitle) +

    + {{ $subtitle }} +

    + @endif + + @if (isset($slot) && $slot->isNotEmpty()) +
    + {{ $slot }} +
    + @endif +
    +
    diff --git a/src/Foundation/resources/components/field.blade.php b/src/Foundation/resources/components/field.blade.php new file mode 100644 index 0000000..1f8e51d --- /dev/null +++ b/src/Foundation/resources/components/field.blade.php @@ -0,0 +1,16 @@ +@props([ + 'id' => null, + 'title' => null, + 'hint' => null, + 'required' => false, +]) + +@if ($title) + +@endif + +{{ $slot }} + +@if ($hint) + {{ $hint }} +@endif diff --git a/src/Foundation/resources/components/file-hint.blade.php b/src/Foundation/resources/components/file-hint.blade.php new file mode 100644 index 0000000..4d0e0b6 --- /dev/null +++ b/src/Foundation/resources/components/file-hint.blade.php @@ -0,0 +1,5 @@ +@if ($file) + + {{ __('Click here to view the current file.') }} + +@endif diff --git a/src/Foundation/resources/components/flag.blade.php b/src/Foundation/resources/components/flag.blade.php new file mode 100644 index 0000000..9643d71 --- /dev/null +++ b/src/Foundation/resources/components/flag.blade.php @@ -0,0 +1,8 @@ +@props([ + 'code' => 'eg', + 'size' => 'md', +]) + + + +class(['flag', "flag-$size", "flag-country-$code"]) }}> diff --git a/src/Foundation/resources/components/form-card.blade.php b/src/Foundation/resources/components/form-card.blade.php new file mode 100644 index 0000000..ca22f41 --- /dev/null +++ b/src/Foundation/resources/components/form-card.blade.php @@ -0,0 +1,27 @@ +class('card') }}> +
    isset($header)])> +

    {{ $title }}

    + + @isset($header) + {{ $header }} + @endisset +
    + + @if ($slot->isEmpty()) +
    + @include("dashboard.$resource.partials.form", ['entry' => $entry]) +
    + @else + {{ $slot }} + @endif + +
    + @if ($back) + {{ __('Back') }} + @endif + + {{ $actions ?? '' }} + + +
    +     diff --git a/src/Foundation/resources/components/form.blade.php b/src/Foundation/resources/components/form.blade.php new file mode 100644 index 0000000..9e18e43 --- /dev/null +++ b/src/Foundation/resources/components/form.blade.php @@ -0,0 +1,14 @@ +
    + @csrf + + {{-- Method spoofing --}} + @if (in_array($method, ['PUT', 'PATCH', 'DELETE'])) + @method($method) + @endif + + {{-- Identifier to know which form is being submitted --}} + + + {{ $slot }} +
    diff --git a/src/Foundation/resources/components/hint.blade.php b/src/Foundation/resources/components/hint.blade.php new file mode 100644 index 0000000..1773a43 --- /dev/null +++ b/src/Foundation/resources/components/hint.blade.php @@ -0,0 +1,3 @@ +merge(['class' => 'form-hint']) }}> + {{ $slot }} + diff --git a/src/Foundation/resources/components/icon-picker.blade.php b/src/Foundation/resources/components/icon-picker.blade.php new file mode 100644 index 0000000..d965ada --- /dev/null +++ b/src/Foundation/resources/components/icon-picker.blade.php @@ -0,0 +1,20 @@ + + + +
    +
    + + + + + class(['form-control'])->merge(['init' => 'icon-picker', 'iconpicker-source' => hashed_asset('vendor/redot/libraries/tabler-icons/tabler-icons.json')]) }} /> +
    + +
    + +
    +
    +     diff --git a/src/Foundation/resources/components/icon.blade.php b/src/Foundation/resources/components/icon.blade.php new file mode 100644 index 0000000..2e760bc --- /dev/null +++ b/src/Foundation/resources/components/icon.blade.php @@ -0,0 +1,7 @@ +@props(['icon']) + +@if (str_starts_with($icon, '<')) + {!! $icon !!} +@else + +@endif diff --git a/src/Foundation/resources/components/input.blade.php b/src/Foundation/resources/components/input.blade.php new file mode 100644 index 0000000..3ac9d7a --- /dev/null +++ b/src/Foundation/resources/components/input.blade.php @@ -0,0 +1,42 @@ + +
    $isInputGroup, + 'input-group-flat' => $isInputGroup && $flat, + ])> + @if ($prepend instanceof \Illuminate\View\ComponentSlot) + {{ $prepend }} + @elseif ($prepend) + {{ $prepend }} + @endif + + class(['form-control']) }} /> + + @if ($isPassword) + + @endif + + @if ($append instanceof \Illuminate\View\ComponentSlot) + {{ $append }} + @elseif ($append) + {{ $append }} + @endif +
    +     + +@if ($isPassword) + @pushOnce('scripts', 'password-toggle-scripts') + + @endPushOnce +@endif diff --git a/src/Foundation/resources/components/label.blade.php b/src/Foundation/resources/components/label.blade.php new file mode 100644 index 0000000..351c8d4 --- /dev/null +++ b/src/Foundation/resources/components/label.blade.php @@ -0,0 +1,10 @@ +@props([ + 'title' => null, + 'for' => null, + 'required' => false, +]) + + diff --git a/src/Foundation/resources/components/page-header.blade.php b/src/Foundation/resources/components/page-header.blade.php new file mode 100644 index 0000000..3e4e9fb --- /dev/null +++ b/src/Foundation/resources/components/page-header.blade.php @@ -0,0 +1,32 @@ +@aware([ + 'title' => __('Dashboard'), +]) + +@props([ + 'title' => null, + 'pretitle' => __('Overview'), + 'create' => null, +]) + +
    class(['page-header d-print-none mt-0']) }}> +
    +
    +
    {{ $pretitle }}
    +

    {{ $title }}

    +
    + +
    +
    + @if ($create && url_allowed($create)) + + + + {{ __('Create') }} + + @endif + + {{ $slot }} +
    +
    +
    +
    diff --git a/src/Foundation/resources/components/pagination.blade.php b/src/Foundation/resources/components/pagination.blade.php new file mode 100644 index 0000000..016db43 --- /dev/null +++ b/src/Foundation/resources/components/pagination.blade.php @@ -0,0 +1,94 @@ + diff --git a/src/Foundation/resources/components/query-builder.blade.php b/src/Foundation/resources/components/query-builder.blade.php new file mode 100644 index 0000000..e2ceeaf --- /dev/null +++ b/src/Foundation/resources/components/query-builder.blade.php @@ -0,0 +1,8 @@ + + + +
    + merge(['init' => 'query-builder']) }} /> +
    +
    +     diff --git a/src/Foundation/resources/components/radios-colored.blade.php b/src/Foundation/resources/components/radios-colored.blade.php new file mode 100644 index 0000000..be6eee1 --- /dev/null +++ b/src/Foundation/resources/components/radios-colored.blade.php @@ -0,0 +1,15 @@ + +
    only('class') }}> + @foreach ($options as $key => $color) + + @endforeach + + {{ $slot }} +
    +     diff --git a/src/Foundation/resources/components/radios.blade.php b/src/Foundation/resources/components/radios.blade.php new file mode 100644 index 0000000..769b0e6 --- /dev/null +++ b/src/Foundation/resources/components/radios.blade.php @@ -0,0 +1,15 @@ + +
    only('class') }}> + @foreach ($options as $key => $label) + + @endforeach + + {{ $slot }} +
    +     diff --git a/src/Foundation/resources/components/rating.blade.php b/src/Foundation/resources/components/rating.blade.php new file mode 100644 index 0000000..0253f88 --- /dev/null +++ b/src/Foundation/resources/components/rating.blade.php @@ -0,0 +1,13 @@ + +
    only('class')->class(['rating-field']) }}> + @for ($i = $stars; $i > 0; $i--) + except('class') }} /> + + + @endfor +
    +     diff --git a/src/Foundation/resources/components/redot-scripts.blade.php b/src/Foundation/resources/components/redot-scripts.blade.php new file mode 100644 index 0000000..c9ed7f7 --- /dev/null +++ b/src/Foundation/resources/components/redot-scripts.blade.php @@ -0,0 +1,45 @@ +{{-- Core --}} + + + + + +{{-- Plugins --}} + + + + + + + + +{{-- Language Script --}} + + +{{-- Initializers --}} + + +{{-- Runtime --}} + + + + + + +@if (isset($errors) && $errors->any()) + +@endif diff --git a/src/Foundation/resources/components/redot-styles.blade.php b/src/Foundation/resources/components/redot-styles.blade.php new file mode 100644 index 0000000..7e21363 --- /dev/null +++ b/src/Foundation/resources/components/redot-styles.blade.php @@ -0,0 +1,13 @@ +@props(['direction' => null]) + +@php($direction ??= \Redot\Models\Language::current()?->direction ?? 'ltr') + + + + + + +@stack('plugins-styles') + + + diff --git a/src/Foundation/resources/components/repeater-card.blade.php b/src/Foundation/resources/components/repeater-card.blade.php new file mode 100644 index 0000000..d4b3b01 --- /dev/null +++ b/src/Foundation/resources/components/repeater-card.blade.php @@ -0,0 +1,21 @@ +
    +
    + + + + +
    + + + +
    +
    + +
    class(['card-body']) }}> + {{ $slot }} +
    +
    diff --git a/src/Foundation/resources/components/repeater.blade.php b/src/Foundation/resources/components/repeater.blade.php new file mode 100644 index 0000000..4f45003 --- /dev/null +++ b/src/Foundation/resources/components/repeater.blade.php @@ -0,0 +1,50 @@ + + +@push('templates') + +@endpush + +
    + merge(['init' => 'repeater']) }}> + +
    + @if (isset($wrapper)) + {{ $wrapper }} + @else +
    +
    + @if ($title) + + @endif +
    + +
    + + + +
    +
    + +
    + @if (isset($empty)) +
    attributes->merge(['repeater-empty' => true]) }}> + {{ $empty }} +
    + @else + + @endif +
    + @endif +
    +
    + +@if ($hint) + {{ $hint }} +@endif diff --git a/src/Foundation/resources/components/rich-editor.blade.php b/src/Foundation/resources/components/rich-editor.blade.php new file mode 100644 index 0000000..bf9ad32 --- /dev/null +++ b/src/Foundation/resources/components/rich-editor.blade.php @@ -0,0 +1,3 @@ + + +@include('components.textarea') diff --git a/src/Foundation/resources/components/select-remote.blade.php b/src/Foundation/resources/components/select-remote.blade.php new file mode 100644 index 0000000..46bc983 --- /dev/null +++ b/src/Foundation/resources/components/select-remote.blade.php @@ -0,0 +1,11 @@ + + {{ $slot }} + + @if ($create) + + + + + + @endif + diff --git a/src/Foundation/resources/components/select.blade.php b/src/Foundation/resources/components/select.blade.php new file mode 100644 index 0000000..bb1a0e1 --- /dev/null +++ b/src/Foundation/resources/components/select.blade.php @@ -0,0 +1,19 @@ +@if ($tom) + +@endif + + +
    +
    + + + {{ $append ?? '' }} +
    +
    +     diff --git a/src/Foundation/resources/components/social-icon.blade.php b/src/Foundation/resources/components/social-icon.blade.php new file mode 100644 index 0000000..a83fefe --- /dev/null +++ b/src/Foundation/resources/components/social-icon.blade.php @@ -0,0 +1,8 @@ +@props([ + 'social' => 'google', + 'size' => 'md', +]) + + + +class(['social', "social-$size", "social-app-$social"]) }}> diff --git a/src/Foundation/resources/components/status.blade.php b/src/Foundation/resources/components/status.blade.php new file mode 100644 index 0000000..b11164c --- /dev/null +++ b/src/Foundation/resources/components/status.blade.php @@ -0,0 +1,11 @@ + + @if (is_array(session($status))) +
      + @foreach (session($status) as $message) +
    • {{ $message }}
      • + @endforeach +
    + @else + {{ session($status) }} + @endif +     diff --git a/src/Foundation/resources/components/textarea.blade.php b/src/Foundation/resources/components/textarea.blade.php new file mode 100644 index 0000000..f36b406 --- /dev/null +++ b/src/Foundation/resources/components/textarea.blade.php @@ -0,0 +1,3 @@ + + + diff --git a/src/Foundation/resources/components/toasts.blade.php b/src/Foundation/resources/components/toasts.blade.php new file mode 100644 index 0000000..c5bfe3b --- /dev/null +++ b/src/Foundation/resources/components/toasts.blade.php @@ -0,0 +1,20 @@ +{{-- Pushed here rather than through : stacks keep pushes in order only within the same view depth --}} +@pushOnce('plugins-scripts', 'redot-toasts-scripts') + +@endPushOnce + +@pushOnce('plugins-scripts', 'redot-toasts-init') + +@endPushOnce diff --git a/src/Foundation/resources/components/toggle.blade.php b/src/Foundation/resources/components/toggle.blade.php new file mode 100644 index 0000000..ae87417 --- /dev/null +++ b/src/Foundation/resources/components/toggle.blade.php @@ -0,0 +1,8 @@ + + + diff --git a/src/Foundation/resources/components/translatable-switcher.blade.php b/src/Foundation/resources/components/translatable-switcher.blade.php new file mode 100644 index 0000000..58cc991 --- /dev/null +++ b/src/Foundation/resources/components/translatable-switcher.blade.php @@ -0,0 +1,30 @@ +@props([ + 'id' => uniqid('translatable-'), + 'locales' => array_keys(config('app.locales')), +]) + +
    class(['dropdown'])->merge(['translatable-switcher' => true]) }}> + + +
    + @foreach ($locales as $locale) + + @endforeach +
    +
    + +@pushOnce('scripts') + +@endPushOnce diff --git a/src/Foundation/resources/components/translatable.blade.php b/src/Foundation/resources/components/translatable.blade.php new file mode 100644 index 0000000..77c7a6f --- /dev/null +++ b/src/Foundation/resources/components/translatable.blade.php @@ -0,0 +1,24 @@ +
    +
    + @foreach ($localesConfig as $locale => $config) +
    + +
    + @endforeach +
    + + @if (count($locales) > 1) + + @endif +
    diff --git a/src/Foundation/resources/components/uploader.blade.php b/src/Foundation/resources/components/uploader.blade.php new file mode 100644 index 0000000..0280988 --- /dev/null +++ b/src/Foundation/resources/components/uploader.blade.php @@ -0,0 +1,28 @@ + + + +
    + + +
    +
    +
    +
    + + +
    +
    +     diff --git a/src/Foundation/resources/inits/apex-chart.js b/src/Foundation/resources/inits/apex-chart.js new file mode 100644 index 0000000..d115ce1 --- /dev/null +++ b/src/Foundation/resources/inits/apex-chart.js @@ -0,0 +1,45 @@ +/** + * Initialize an ApexCharts chart. + * + * @param {string} selector + * @param {object} options + * @returns {object|null} + * @see https://apexcharts.com/docs/options/ + */ +return (selector, options = {}) => { + const $chart = $(selector); + + if (!window.ApexCharts) { + console.error('ApexCharts is not loaded.'); + return null; + } + + const defaultOptions = { + chart: { + type: 'line', + height: 350, + toolbar: { + show: false, + }, + }, + series: [], + }; + + const selectorOptions = getOptionsFromSelector(selector, 'chart-'); + + for (const key of ['height', 'type', 'width']) { + if (!selectorOptions.hasOwnProperty(key)) continue; + + _.set(selectorOptions, `chart.${key}`, selectorOptions[key]); + delete selectorOptions[key]; + } + + options = _.merge(defaultOptions, selectorOptions, options); + + const chart = new ApexCharts($chart.get(0), options); + + chart.render(); + $chart.data('apexcharts', chart); + + return chart; +}; diff --git a/src/Foundation/resources/inits/coloris.js b/src/Foundation/resources/inits/coloris.js new file mode 100644 index 0000000..14b7fbe --- /dev/null +++ b/src/Foundation/resources/inits/coloris.js @@ -0,0 +1,28 @@ +return (selector, options = {}) => { + const $input = $(selector); + + // Ensure the input has an ID for Coloris selector + if (!$input.hasAttr('coloris-id')) { + $input.attr('coloris-id', _.uniqueId('coloris-')); + } + + const defaultOptions = { + rtl: $('html').attr('dir') === 'rtl', + themeMode: localStorage.getItem(window.themerKey), + theme: 'polaroid', + formatToggle: true, + }; + + // Get the options from the selector + const selectorOptions = getOptionsFromSelector(selector, 'coloris-'); + options = _.merge(defaultOptions, selectorOptions, options); + + // Initialize the color picker + const picker = new Coloris({ + el: `[coloris-id="${$input.attr('coloris-id')}"`, + ...options, + }); + + // Set the instance on the input element. + $input.data('coloris', picker); +}; diff --git a/src/Foundation/resources/inits/hugerte.js b/src/Foundation/resources/inits/hugerte.js new file mode 100644 index 0000000..7398bf8 --- /dev/null +++ b/src/Foundation/resources/inits/hugerte.js @@ -0,0 +1,121 @@ +/** + * Initialize the HugeRTE editor. + * + * @param {string} selector + * @param {object} options + * @returns {object} + * @see https://github.com/hugerte/hugerte-docs + */ +return async (selector, options = {}) => { + if (typeof hugerte === 'undefined') { + console.error('HugeRTE is not loaded.'); + return; + } + + // Get the theme from the data-bs-theme attribute + let theme = $('html').attr('data-bs-theme'); + + if (theme === 'auto') { + theme = window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'; + } + + // Resolve Tabler tokens for the iframe body (parent CSS cannot style it). + const css = getCssProperties(document.documentElement, [ + '--tblr-bg-forms', + '--tblr-body-bg', + '--tblr-body-color', + '--tblr-primary', + ]); + + // Uploads go to the URL the component passes; without one, image uploads are off. + const uploadUrl = $(selector).attr('hugerte-upload-url'); + + options = Object.assign({}, options, { + selector: '#' + $(selector).attr('id'), + language: document.documentElement.lang, + directionality: document.documentElement.dir, + height: 300, + menubar: false, + branding: false, + skin: theme === 'dark' ? 'oxide-dark' : 'oxide', + content_css: theme === 'dark' ? 'dark' : 'default', + content_style: `body { background-color: ${css['--tblr-bg-forms'] || css['--tblr-body-bg']}; color: ${css['--tblr-body-color']}; } a { color: ${css['--tblr-primary']}; }`, + plugins: 'advlist autolink code directionality link lists table image', + toolbar: + 'undo redo | styles | bold italic underline forecolor backcolor | alignleft aligncenter alignright alignjustify outdent indent ltr rtl | bullist numlist | table image', + toolbar_mode: 'sliding', + image_title: true, + automatic_uploads: Boolean(uploadUrl), + images_upload_handler: (blobInfo, progress) => + new Promise((resolve, reject) => { + const xhr = new XMLHttpRequest(); + xhr.withCredentials = false; + xhr.open('POST', uploadUrl); + xhr.setRequestHeader('X-CSRF-TOKEN', $('meta[name="csrf-token"]').attr('content')); + + xhr.upload.onprogress = (e) => { + progress((e.loaded / e.total) * 100); + }; + + xhr.onload = () => { + if (xhr.status === 403) { + reject({ message: 'HTTP Error: ' + xhr.status, remove: true }); + return; + } + + if (xhr.status < 200 || xhr.status >= 300) { + reject('HTTP Error: ' + xhr.status); + return; + } + + const json = JSON.parse(xhr.responseText); + + if (!json || typeof json.location != 'string') { + reject('Invalid JSON: ' + xhr.responseText); + return; + } + + resolve(json.location); + }; + + xhr.onerror = () => { + reject('Image upload failed due to a XHR Transport error. Code: ' + xhr.status); + }; + + const formData = new FormData(); + formData.append('file', blobInfo.blob(), blobInfo.filename()); + + xhr.send(formData); + }), + file_picker_types: uploadUrl ? 'image' : '', + file_picker_callback: (cb, value, meta) => { + const input = document.createElement('input'); + input.setAttribute('type', 'file'); + input.setAttribute('accept', 'image/*'); + + input.onchange = () => { + const file = input.files[0]; + const reader = new FileReader(); + + reader.onload = () => { + const id = 'blobid' + new Date().getTime(); + const blobCache = hugerte.activeEditor.editorUpload.blobCache; + const base64 = reader.result.split(',')[1]; + const blobInfo = blobCache.create(id, file, base64); + blobCache.add(blobInfo); + + cb(blobInfo.blobUri(), { title: file.name }); + }; + + reader.readAsDataURL(file); + }; + + input.click(); + }, + }); + + const [instance] = await hugerte.init(options); + $(selector).data('hugerte', instance); + + document.addEventListener('theme:changed', () => instance?.destroy(), { once: true }); +}; diff --git a/src/Foundation/resources/inits/icon-picker.js b/src/Foundation/resources/inits/icon-picker.js new file mode 100644 index 0000000..aeec6ea --- /dev/null +++ b/src/Foundation/resources/inits/icon-picker.js @@ -0,0 +1,21 @@ +/** + * Initialize the icon picker input. + * + * @param {string} selector + * @param {object} options + * @see RedotIconPicker + */ +return (selector, options = {}) => { + const defaultOptions = { + maxResults: 100, + searchDebounce: 100, + }; + + const selectorOptions = getOptionsFromSelector(selector, 'iconpicker-'); + options = _.merge(defaultOptions, selectorOptions, options); + + const iconPicker = new RedotIconPicker(selector, options); + + // Set the instance on the input element. + $(selector).data('iconPicker', iconPicker); +}; diff --git a/src/Foundation/resources/inits/overlay-scrollbars.js b/src/Foundation/resources/inits/overlay-scrollbars.js new file mode 100644 index 0000000..3f59fcd --- /dev/null +++ b/src/Foundation/resources/inits/overlay-scrollbars.js @@ -0,0 +1,104 @@ +/** + * Initialize OverlayScrollbars on the given element. + * + * Besides the regular OverlayScrollbars options, three extras are supported + * (usually set through `os-*` attributes on the element): + * + * - `media`: only activate while this media query matches, e.g. "(min-width: 992px)". + * - `viewport`: selector for the viewport element, or "self" for the element itself. + * - `slot`: selector for the element that holds the scrollbars, or "self". + * + * @param {string|HTMLElement} selector + * @param {object} options + * @returns {object|null} + * @see https://kingsora.github.io/OverlayScrollbars + */ +return (selector, options = {}) => { + const $element = $(selector); + const element = $element.get(0); + + // Dark containers get the light scrollbar theme, and vice versa. + const currentTheme = () => ($element.theme() === 'dark' ? 'os-theme-light' : 'os-theme-dark'); + + const defaultOptions = { + overflow: { + y: 'scroll', + }, + scrollbars: { + theme: currentTheme(), + autoHide: 'leave', + autoHideDelay: 300, + autoHideSuspend: true, + }, + }; + + const { media, viewport, slot, ...scrollbarOptions } = _.merge(getOptionsFromSelector(selector, 'os-'), options); + options = _.merge(defaultOptions, scrollbarOptions); + + const resolve = (value) => (value === 'self' ? element : element.querySelector(value)); + + const target = { + target: element, + ...(viewport && { elements: { viewport: resolve(viewport) } }), + ...(slot && { scrollbars: { slot: resolve(slot) } }), + }; + + let instance = null; + const mediaQuery = media ? window.matchMedia(media) : null; + + const $initialized = element === document.body ? $element.add(document.documentElement) : $element; + + // Create or destroy the instance depending on whether the media query matches. + const sync = () => { + if (mediaQuery && !mediaQuery.matches) { + instance?.destroy(); + instance = null; + $initialized.removeAttr('data-overlayscrollbars-initialize'); + return; + } + + if (instance) return; + + $initialized.attr('data-overlayscrollbars-initialize', ''); + instance = OverlayScrollbarsGlobal.OverlayScrollbars(target, options); + }; + + mediaQuery?.addEventListener('change', sync); + document.addEventListener('theme:changed', () => instance?.options({ scrollbars: { theme: currentTheme() } })); + + sync(); + + // Bootstrap modals are their own overflow container, so give each open + // modal its own instance and pause the body scrolling behind it. Overlay + // scrollbars take no layout space, so neither step shifts the page. + // Bound through jQuery: dialogs removed on hide (e.g. bootbox) detach + // before the native event dispatch, so it never bubbles to the document. + if (element === document.body) { + const modalInstance = (modal) => OverlayScrollbarsGlobal.OverlayScrollbars(modal); + + $(document).on('show.bs.modal', (event) => { + if (!instance) return; + + if (!modalInstance(event.target)) { + OverlayScrollbarsGlobal.OverlayScrollbars( + { target: event.target, elements: { viewport: event.target } }, + _.merge({}, options, { overflow: { x: 'hidden' }, scrollbars: { theme: currentTheme() } }), + ); + } + + instance?.options({ overflow: { y: 'hidden' } }); + }); + + $(document).on('shown.bs.modal', (event) => modalInstance(event.target)?.update(true)); + + $(document).on('hidden.bs.modal', (event) => { + modalInstance(event.target)?.destroy(); + + if (!document.querySelector('.modal.show')) { + instance?.options({ overflow: { y: options.overflow.y } }); + } + }); + } + + return instance; +}; diff --git a/src/Foundation/resources/inits/query-builder.js b/src/Foundation/resources/inits/query-builder.js new file mode 100644 index 0000000..0b67a92 --- /dev/null +++ b/src/Foundation/resources/inits/query-builder.js @@ -0,0 +1,114 @@ +/** + * jQuery QueryBuilder plugin wrapper for TomSelect. + * + * @see https://querybuilder.js.org/ + * @see https://tom-select.js.org/ + */ +$.fn.tomselect = function (options = {}) { + return this.each(function () { + const $select = $(this); + + if ($select.data('tomselect')) { + return; + } + + if (!window.__inits?.['tomselect']) { + console.error('TomSelect init is not loaded.'); + return; + } + + window.__inits['tomselect'](this, options); + }); +}; + +/** + * jQuery QueryBuilder plugin wrapper for Tempus Dominus. + * + * @see https://querybuilder.js.org/ + * @see https://getdatepicker.com/ + */ +$.fn.datepicker = function (options = {}) { + return this.each(function () { + const $input = $(this); + + if ($input.data('picker')) { + return; + } + + if (!window.__inits?.['tempus-dominus']) { + console.error('Tempus Dominus init is not loaded.'); + return; + } + + window.__inits['tempus-dominus'](this, options); + }); +}; + +/** + * Initialize the query builder. + * + * @param {string} selector + * @param {object} options + * @see https://querybuilder.js.org/ + */ +return (selector, options = {}) => { + const defaultOptions = { + lang_code: $('html').attr('lang'), + display_empty_filter: false, + display_errors: true, + allow_groups: 2, + allow_empty: true, + default_filter: null, + icons: { + add_group: 'ti ti-folder-plus', + add_rule: 'ti ti-circle-plus', + remove_group: 'ti ti-trash', + remove_rule: 'ti ti-x', + }, + }; + + const selectorOptions = getOptionsFromSelector(selector, 'query-'); + options = _.merge(defaultOptions, selectorOptions, options); + + // Loop through the filters and apply the value setter and getter. + for (const filter of options.filters) { + filter.valueSetter = function (rule, value) { + let count = rule.operator.nb_inputs; + let values = count > 1 ? value : [value]; + let $inputs = rule.$el.find('.rule-value-container').find('input, select'); + + // Set the values for the input and select elements. + $inputs.each((index, element) => setFieldValue($(element), values[index])); + }; + + filter.valueGetter = function (rule) { + let count = rule.operator.nb_inputs; + let $inputs = rule.$el.find('.rule-value-container').find('input, select'); + let values = []; + + // Get the values for the input and select elements. + $inputs.each((index, element) => values.push(getFieldValue($(element)))); + + return count > 1 ? values : values[0]; + }; + } + + // If the input has a value, parse it and set the rules. + options.rules = $(selector).val() ? JSON.parse($(selector).val()) : []; + + // Render the query builder. + let $builder = $(selector).closest('[query-builder-container]').find('[query-builder]'); + let instance = $builder.queryBuilder(options).data('queryBuilder'); + + // Serialize the query builder data when the form is submitted. + let $form = $(selector).closest('form'); + $form.on('submit', () => { + let rules = instance.getRules(); + let value = _.isEmpty(rules) ? null : JSON.stringify(rules); + + $(selector).val(value); + }); + + // Set the instance on the input element. + $(selector).data('queryBuilder', instance); +}; diff --git a/src/Foundation/resources/inits/repeater.js b/src/Foundation/resources/inits/repeater.js new file mode 100644 index 0000000..ccff148 --- /dev/null +++ b/src/Foundation/resources/inits/repeater.js @@ -0,0 +1,22 @@ +/** + * Initialize the repeater input. + * + * @param {string} selector + * @param {object} options + * @see RedotRepeater + */ +return (selector, options = {}) => { + const defaultOptions = { + sortable: true, + scrollable: true, + confirmable: true, + }; + + const selectorOptions = getOptionsFromSelector(selector, 'repeater-'); + options = _.merge(defaultOptions, selectorOptions, options); + + const repeater = new RedotRepeater(selector, options); + + // Set the instance on the input element. + $(selector).data('repeater', repeater); +}; diff --git a/src/Foundation/resources/inits/sortable.js b/src/Foundation/resources/inits/sortable.js new file mode 100644 index 0000000..81e1bfe --- /dev/null +++ b/src/Foundation/resources/inits/sortable.js @@ -0,0 +1,22 @@ +/** + * Initialize the sortable list. + * + * @param {string} selector + * @param {object} options + * @see https://sortablejs.github.io/Sortable/ + */ +return (selector, options = {}) => { + const defaultOptions = { + animation: 150, + }; + + const selectorOptions = getOptionsFromSelector(selector, 'sortable-'); + options = _.merge(defaultOptions, selectorOptions, options); + + const sortable = new Sortable($(selector).get(0), options); + + // Set the instance on the input element. + $(selector).data('sortable', sortable); + + return sortable; +}; diff --git a/src/Foundation/resources/inits/tempus-dominus.js b/src/Foundation/resources/inits/tempus-dominus.js new file mode 100644 index 0000000..d563409 --- /dev/null +++ b/src/Foundation/resources/inits/tempus-dominus.js @@ -0,0 +1,80 @@ +/** + * Initialize the tempus dominus date picker. + * + * @param {string} selector + * @param {object} options + * @returns {object} + * @see https://getdatepicker.com/ + */ +return (selector, options = {}) => { + const $picker = $(selector); + + // Determine if the picker inside a rtl direction + const isRtl = getComputedStyle($picker.get(0)).direction === 'rtl'; + + const defaultOptions = { + display: { + theme: $('html').attr('data-bs-theme'), + + components: { + calendar: true, + clock: false, + }, + + icons: { + previous: isRtl ? 'ti ti-chevron-right' : 'ti ti-chevron-left', + next: isRtl ? 'ti ti-chevron-left' : 'ti ti-chevron-right', + }, + }, + + localization: { + locale: document.documentElement.lang || 'en', + format: 'yyyy-MM-dd', + hourCycle: 'h12', + }, + }; + + // Get the options from the selector + const selectorOptions = getOptionsFromSelector(selector, 'date-'); + options = _.merge(defaultOptions, selectorOptions, options); + + // If the picker has the datetime attribute, add the time components + if ($picker.hasAttr('datetime') || options.type === 'datetime') { + options.display.components.clock = true; + options.display.components.calendar = true; + options.localization.format = 'yyyy-MM-dd hh:mm T'; + } + + // If the picker has only-time attribute, remove the date components + if ($picker.hasAttr('only-time') || options.type === 'time') { + options.display.components.calendar = false; + options.display.components.clock = true; + options.localization.format = 'hh:mm T'; + } + + // Remove the type option because it's not needed anymore + delete options.type; + + // Locale drives month/weekday names via Intl, but the `T` token uses + // dayPeriod (ص/م in Arabic) which Laravel's `date` rule cannot parse. + tempusDominus.DateTime.prototype.meridiem = function () { + return this.getHours() < 12 ? 'AM' : 'PM'; + }; + + tempusDominus.DateTime.prototype.getLocaleAfternoon = function () { + return 'PM'; + }; + + // Initialize the picker + const picker = new tempusDominus.TempusDominus($picker.get(0), options); + $picker.data('picker', picker); + + // Update the theme when the theme changes + document.addEventListener('theme:changed', () => { + const theme = $('html').attr('data-bs-theme'); + + // Hide the picker + picker.hide(); + picker.updateOptions({ display: { theme: theme } }); + }); +}; diff --git a/src/Foundation/resources/inits/tomselect.js b/src/Foundation/resources/inits/tomselect.js new file mode 100644 index 0000000..4d3e9bf --- /dev/null +++ b/src/Foundation/resources/inits/tomselect.js @@ -0,0 +1,214 @@ +/** + * Prepare the options for the remote select box. + */ +function prepareRemoteOptions($select, options) { + let fields = options.searchField || []; + + return _.merge(options, { + preload: 'focus', + placeholder: __('Type to search...'), + valueField: '__value', + labelField: '__text', + searchField: ['__text', '__value', ...fields], + load: function (term, callback) { + const endpoint = new URL(options.queryRoute); + + // Add the search term to the endpoint. + endpoint.searchParams.append('term', term); + endpoint.searchParams.append('data', options.query); + + // If options has limit, add it to the endpoint. + if (options.limit) { + endpoint.searchParams.append('limit', options.limit); + } + + // Append the bindings to the endpoint. + let bindings = getSelectBindings($select); + for (const key in bindings) { + endpoint.searchParams.append(`parameters[${key}]`, bindings[key]); + } + + fetch(endpoint) + .then((response) => response.json()) + .then((response) => callback(response.payload.data)) + .catch(() => callback([])); + }, + }); +} + +/** + * Preload values into the select box using AJAX request. + */ +function preloadValues($select) { + let ids = $select.attr('select-preload-values').trim(); + + // Early exit if there are no ids to preload. + if (ids.length === 0) { + return; + } + + let options = getOptionsFromSelector($select, 'select-'); + let endpoint = new URL(options.fetchRoute); + let instance = $select.data('tomselect'); + + endpoint.searchParams.append('data', options.query); + endpoint.searchParams.append('ids', ids); + + // Append the bindings to the endpoint. + let bindings = getSelectBindings($select); + for (const key in bindings) { + endpoint.searchParams.append(`parameters[${key}]`, bindings[key]); + } + + fetch(endpoint) + .then((response) => response.json()) + .then((response) => { + const data = response.payload.data; + + instance.addOptions(data); + instance.setValue(data.map((item) => item.__value)); + }); +} + +/** + * Get the bindings from the select box. + */ +function getSelectBindings($select) { + let result = {}; + let bindings = getOptionsFromSelector($select, 'bind-'); + + for (const binding in bindings) { + let bind = bindings[binding]; + + if (typeof bind !== 'object') { + result[binding] = bind; + } else if (bind.hasOwnProperty('value')) { + result[binding] = bind.value; + } else if (bind.hasOwnProperty('selector')) { + result[binding] = getFieldValue($.query(bind.selector)); + } + } + + return result; +} + +/** + * Bind the select box to it's bindings inputs. + */ +function bindSelectBindings($select) { + let instance = $select.data('tomselect'); + let bindings = getOptionsFromSelector($select, 'bind-'); + + for (const binding in bindings) { + let value = bindings[binding]; + + // Early exit if the value is not an object or doesn't have a selector. + if (typeof value !== 'object' || !value.hasOwnProperty('selector')) { + continue; + } + + // Get the input element. + let $input = $.query(value.selector); + + // Early exit if the input element is not found. + if ($input.length === 0) { + return console.error(`Input element with selector "${value.selector}" not found.`); + } + + // Bind the input element to the select box. + $input.on('change', function () { + instance.clear(); + instance.clearOptions(); + + $select.attr(`bind-${binding}.value`, $(this).val()); + + // Reset the loaded searches. + instance.loadedSearches = {}; + $(instance.control).closest('.ts-wrapper').removeClass('preloaded'); + }); + } +} + +/** + * Initialize the tom select input. + * + * @param {string} selector + * @param {object} options + * @see https://tom-select.js.org/ + */ +return (selector, options = {}) => { + const $select = $(selector); + + const defaultOptions = { + create: $select.hasAttr('tags'), + placeholder: __('Select an option'), + + onInitialize: function () { + const selected = $select.find('option[selected]'); + + if (selected.length === 0 && $select.hasAttr('removable')) { + this.clear(); + } + }, + + render: { + option: function (data, escape) { + return `
    ${data.__html || escape(data.__text || data.text)}
    `; + }, + }, + }; + + const selectorOptions = getOptionsFromSelector(selector, 'select-'); + options = _.merge(defaultOptions, selectorOptions, options); + + if ($select.hasAttr('same-template')) { + options.render.item = options.render.option; + } + + if ($select.hasAttr('multiple') || $select.hasAttr('removable')) { + options.plugins = options.plugins || []; + options.plugins.push('remove_button'); + } + + if (options.hasOwnProperty('query')) { + options = prepareRemoteOptions($select, options); + } + + const instance = new TomSelect(selector, options); + + // Set the instance on the input element. + $select.data('tomselect', instance); + + // Bind the select box to it's bindings inputs. + bindSelectBindings($select); + + // Bind the select box to browser messages that should preload a value. + window.addEventListener('message', function (event) { + const message = event.data; + if (!message || message.key !== $select.attr('id')) return; + + // If a lightbox is still open, close the last opened lightbox. + Glare.close(); + + const value = _.get(message, 'data.value'); + if (value === undefined || value === null || value === '') return; + + $select.attr('select-preload-values', value); + preloadValues($select); + }); + + // Initial preload values if the attribute is present + if ($select.hasAttr('select-preload-values')) { + preloadValues($select); + } + + // Preload values when `select:preload` event is triggered. + $select.on('select:preload', function () { + preloadValues($select); + }); + + // Enable or disable the select box when the visibility changes. + $select.on('visibility:updated', function (event, visibility) { + visibility ? instance.enable() : instance.disable(); + }); +}; diff --git a/src/Foundation/resources/inits/turnstile.js b/src/Foundation/resources/inits/turnstile.js new file mode 100644 index 0000000..99eb4b1 --- /dev/null +++ b/src/Foundation/resources/inits/turnstile.js @@ -0,0 +1,28 @@ +/** + * Initialize the turnstile captcha. + * + * @param {string} selector + * @param {object} options + * @see https://developers.cloudflare.com/turnstile/get-started/client-side-rendering/ + */ +return (selector, options = {}) => { + const defaultOptions = { + sitekey: $('meta[name="cloudflare-turnstile-site-key"]').attr('content'), + theme: $('html').attr('data-bs-theme'), + language: $('html').attr('lang'), + size: 'flexible', + }; + + const selectorOptions = getOptionsFromSelector(selector, 'captcha-'); + options = _.merge(defaultOptions, selectorOptions, options); + + // Define the callback function. + options.callback = function (token) { + $(selector).find('input').val(token); + }; + + const instance = turnstile.render(selector, options); + + // Set the instance on the input element. + $(selector).data('captcha', instance); +}; diff --git a/src/Foundation/resources/inits/uploader.js b/src/Foundation/resources/inits/uploader.js new file mode 100644 index 0000000..6b25fbd --- /dev/null +++ b/src/Foundation/resources/inits/uploader.js @@ -0,0 +1,26 @@ +/** + * Initialize the uploader input. + * + * @param {string} selector + * @param {object} options + * @see RedotUploader + */ +return (selector, options = {}) => { + const defaultOptions = { + sortable: true, + multiple: true, + accept: '*', + autoUpload: true, + maxSize: 10 * 1024 * 1024, + confirmable: true, + returnType: 'object', + }; + + const selectorOptions = getOptionsFromSelector(selector, 'uploader-'); + options = _.merge(defaultOptions, selectorOptions, options); + + const uploader = new RedotUploader(selector, options); + + // Set the instance on the input element. + $(selector).data('uploader', uploader); +}; diff --git a/src/Foundation/routes/global.php b/src/Foundation/routes/global.php new file mode 100644 index 0000000..d197eb4 --- /dev/null +++ b/src/Foundation/routes/global.php @@ -0,0 +1,21 @@ +middleware(config('redot.components.hugerte.middleware'))->name('hugerte.upload'); +} + +if (config('redot.components.select.enabled')) { + Route::middleware(config('redot.components.select.middleware'))->group(function () { + Route::get('tomselect/search', [SelectController::class, 'index'])->name('select.search'); + Route::get('tomselect/fetch', [SelectController::class, 'show'])->name('select.fetch'); + }); +} + +if (config('redot.components.uploader.enabled')) { + Route::post('uploader/upload', [UploaderController::class, 'store'])->middleware(config('redot.components.uploader.middleware'))->name('uploader.upload'); +} diff --git a/src/Foundation/src/Application.php b/src/Foundation/src/Application.php index b6a8617..06f8b91 100644 --- a/src/Foundation/src/Application.php +++ b/src/Foundation/src/Application.php @@ -36,16 +36,18 @@ public static function configure(?string $basePath = null): ApplicationBuilder // Load the API routes for the website and dashboard Route::middleware('api')->as('api.')->prefix('api')->group(function () { if (config('redot.features.website-api.enabled')) { - Route::as('website.')->group(base_path('routes/api/website.php')); + Route::as('website.')->group(base_path(config('redot.paths.routes.website-api'))); } if (config('redot.features.dashboard-api.enabled')) { - Route::as('dashboard.')->prefix(config('redot.features.dashboard-api.prefix'))->middleware(RoutePermission::class)->group(base_path('routes/api/dashboard.php')); + Route::as('dashboard.')->prefix(config('redot.features.dashboard-api.prefix'))->middleware(RoutePermission::class)->group(base_path(config('redot.paths.routes.dashboard-api'))); } }); - // Load the global routes - Route::as('global.')->middleware(['web', Localization::class . ':website'])->group(base_path('routes/global.php')); + // Load the package and application global routes, so the application can override package routes + foreach ([__DIR__ . '/../routes/global.php', base_path(config('redot.paths.routes.global'))] as $routes) { + Route::as('global.')->middleware(['web', Localization::class . ':website'])->group($routes); + } // Load the website and dashboard routes $group = Route::middleware('web'); @@ -59,11 +61,11 @@ public static function configure(?string $basePath = null): ApplicationBuilder $group->group(function () { if (config('redot.features.website.enabled')) { - Route::as('website.')->middleware(Localization::class . ':website')->group(base_path('routes/website.php')); + Route::as('website.')->middleware(Localization::class . ':website')->group(base_path(config('redot.paths.routes.website'))); } if (config('redot.features.dashboard.enabled')) { - Route::as('dashboard.')->prefix(config('redot.features.dashboard.prefix'))->middleware('dashboard')->group(base_path('routes/dashboard.php')); + Route::as('dashboard.')->prefix(config('redot.features.dashboard.prefix'))->middleware('dashboard')->group(base_path(config('redot.paths.routes.dashboard'))); } }); diff --git a/src/Foundation/src/Commands/BuildDependenciesCommand.php b/src/Foundation/src/Commands/BuildDependenciesCommand.php index 588f664..295bfed 100644 --- a/src/Foundation/src/Commands/BuildDependenciesCommand.php +++ b/src/Foundation/src/Commands/BuildDependenciesCommand.php @@ -109,19 +109,26 @@ protected function buildLanguageFile(string $locale) protected function buildInitFiles() { $inits = []; - foreach (glob(public_path('assets/inits/*.js')) as $file) { - $inits[] = $file; + + // Application inits override the package inits with the same name. + foreach ([dirname(__DIR__, 2) . '/resources/inits', public_path('assets/inits')] as $directory) { + if (! File::isDirectory($directory)) continue; + + // Push path to the dependencies array. + $this->dependsOnDirectory($directory); + + foreach (glob($directory . '/*.js') as $file) { + $inits[basename($file, '.js')] = $file; + } } - // Push path to the dependencies array. - $this->dependsOnDirectory(public_path('assets/inits')); - $this->dependsOnFile(...$inits); + $this->dependsOnFile(...array_values($inits)); $javascriptFile = 'window.__inits = {};' . "\n"; - foreach ($inits as $file) { + foreach ($inits as $name => $file) { $javascriptFile .= sprintf( 'window.__inits["%s"] = (() => { %s })();', - basename($file, '.js'), + $name, File::get($file) ); } diff --git a/src/Foundation/src/Commands/PublishAssetsCommand.php b/src/Foundation/src/Commands/PublishAssetsCommand.php new file mode 100644 index 0000000..219cca1 --- /dev/null +++ b/src/Foundation/src/Commands/PublishAssetsCommand.php @@ -0,0 +1,41 @@ +callSilently('vendor:publish', [ + '--tag' => 'redot::assets', + '--force' => true, + ]); + + info('Redot assets published successfully!'); + } +} diff --git a/src/Foundation/src/Commands/SyncPermissionsCommand.php b/src/Foundation/src/Commands/SyncPermissionsCommand.php index 2b85450..f44de45 100644 --- a/src/Foundation/src/Commands/SyncPermissionsCommand.php +++ b/src/Foundation/src/Commands/SyncPermissionsCommand.php @@ -171,13 +171,14 @@ protected function resolveGrantee(string $grant): ?Model } /** - * Resolve the eloquent model behind the admins guard. + * Resolve the eloquent model behind the dashboard guard. * * @return class-string */ protected function adminModel(): string { - $provider = config('auth.guards.admins.provider', 'admins'); + $guard = config('redot.features.dashboard.guard'); + $provider = config("auth.guards.{$guard}.provider", $guard); return config("auth.providers.{$provider}.model"); } diff --git a/src/Foundation/src/Http/Controllers/HugeRteController.php b/src/Foundation/src/Http/Controllers/HugeRteController.php new file mode 100644 index 0000000..8426a15 --- /dev/null +++ b/src/Foundation/src/Http/Controllers/HugeRteController.php @@ -0,0 +1,28 @@ +validate([ + 'file' => 'required|image', + ]); + + $url = $this->uploadFile(request()->file('file'), 'hugerte'); + + return response()->json([ + 'location' => $url, + ]); + } +} diff --git a/src/Foundation/src/Http/Controllers/SelectController.php b/src/Foundation/src/Http/Controllers/SelectController.php new file mode 100644 index 0000000..f09ca7c --- /dev/null +++ b/src/Foundation/src/Http/Controllers/SelectController.php @@ -0,0 +1,132 @@ +validate([ + 'data' => 'required', + 'term' => 'nullable|string', + 'limit' => 'nullable|integer|min:1|max:100', + 'parameters' => 'nullable|array', + ]); + + $data = json_decode(decrypt($request->data)); + $term = trim($request->query('term', '')); + $limit = (int) $request->query('limit', 20); + + // Merge the parameters with the term. + $parameters = array_merge($request->query('parameters', []), [$data->term => $term]); + $parameters = collect($parameters)->mapWithKeys(fn ($value, $key) => [sprintf('{%s}', $key) => $value])->toArray(); + $bindings = str_replace(array_keys($parameters), array_values($parameters), $data->bindings ?? []); + + // Prepare the query. + $query = $data->query . " limit $limit"; + + $items = $this->prepareResults(DB::select($query, $bindings), $data); + + return $this->respond([ + 'data' => $items, + 'count' => count($items), + ]); + } + + /** + * Display the specified resource. + */ + public function show(Request $request) + { + $request->validate([ + 'data' => 'required', + 'ids' => 'required|string', + 'parameters' => 'nullable|array', + ]); + + $data = json_decode(decrypt($request->data)); + $ids = array_values(array_filter(parse_csv($request->query('ids')), fn ($id) => filled($id))); + + if (blank($ids)) { + return $this->respond([ + 'data' => [], + 'count' => 0, + ]); + } + + $uniqid = uniqid('cte_'); + $key = $data->key; + + // Merge the parameters with the term. + $parameters = array_merge($request->query('parameters', []), [$data->term => '']); + $parameters = collect($parameters)->mapWithKeys(fn ($value, $key) => [sprintf('{%s}', $key) => $value])->toArray(); + $bindings = str_replace(array_keys($parameters), array_values($parameters), $data->bindings ?? []); + $bindings = array_values((array) $bindings); + + // Prepare the query. + $placeholders = implode(',', array_fill(0, count($ids), '?')); + $query = "select $key from ($data->query) as $uniqid where $uniqid.$key in ($placeholders)"; + $bindings = [...$bindings, ...$ids]; + + $items = $this->prepareResults(DB::select($query, $bindings), $data); + + return $this->respond([ + 'data' => $items, + 'count' => count($items), + ]); + } + + /** + * Prepare the results to be returned. + */ + protected function prepareResults(array $items, $data): array + { + $model = $data->model; + $columns = array_merge($data->columns, $data->appends ?? []); + + $relations = []; + foreach ($columns as $column) { + $relations = array_merge($relations, $this->extractRelations($column)); + } + + $items = array_column($items, $data->key); + $items = $model::whereIn($data->key, $items)->with(array_unique($relations))->get(); + + // Map the items to the required format. + $items = $items->map(function ($item) use ($data, $columns) { + $arr = $item->toArray(); + $arr = Arr::only(Arr::dot($arr), $columns); + + return array_merge([ + '__value' => Arr::get($arr, $data->key), + '__text' => Arr::get($arr, $data->text), + '__html' => $data->template ? view($data->template, ['item' => $item])->render() : '', + ], $arr); + }); + + return $items->toArray(); + } + + /** + * Extract relations from the column. + */ + protected function extractRelations($column) + { + $relations = explode('.', $column); + + // Remove the last element. + array_pop($relations); + + return $relations; + } +} diff --git a/src/Foundation/src/Http/Controllers/UploaderController.php b/src/Foundation/src/Http/Controllers/UploaderController.php new file mode 100644 index 0000000..7d3f82a --- /dev/null +++ b/src/Foundation/src/Http/Controllers/UploaderController.php @@ -0,0 +1,121 @@ +validate([ + 'file' => 'required|file', + 'config' => 'required|string', + ]); + + $config = json_decode(decrypt($request->config)); + + // If config is null, return an error to prevent unauthorized access + if ($config === null) { + throw ValidationException::withMessages([ + 'config' => [__('Unauthorized access.')], + ]); + } + + $file = $request->file('file'); + + // Set the locale + if ($config->locale) { + app()->setLocale($config->locale); + } + + // Validate the file type + if ($config->accept) { + $this->validateFileType($file, $config->accept); + } + + // Run the server validation + if ($config->serverValidation) { + $request->validate(['file' => $config->serverValidation]); + } + + // Get the path to store the file + $url = $this->uploadFile($file, $config->directory, $config->optimize); + $path = str_replace(URL::to('/'), '', $url); + + // Fix for windows directory separator + $path = str_replace(['/', '\\'], DIRECTORY_SEPARATOR, $path); + + $payload = [ + 'url' => $url, + 'path' => $path, + 'size' => filesize(public_path($path)), + ]; + + if ($config->thumbnail && is_image(public_path($path))) { + try { + $payload['thumbnail'] = create_thumbnail(public_path($path)); + } catch (\Exception $e) { + $payload['thumbnail'] = null; + } + } + + return $this->respond($payload); + } + + /** + * Validate file type based on accept parameter. + */ + protected function validateFileType(UploadedFile $file, string $accept) + { + $acceptedTypes = parse_csv($accept); + $fileMimeType = $file->getMimeType(); + $fileExtension = '.' . strtolower($file->getClientOriginalExtension()); + + $isValid = false; + + foreach ($acceptedTypes as $type) { + // Check wildcard accept all + if ($type === '*' || $type === '*/*') { + $isValid = true; + break; + } + + // Check file extension + if (str_starts_with($type, '.')) { + if (strtolower($type) === $fileExtension) { + $isValid = true; + break; + } + } elseif (str_ends_with($type, '/*')) { + $category = str_replace('/*', '', $type); + if (str_starts_with($fileMimeType, $category . '/')) { + $isValid = true; + break; + } + } else { + if ($fileMimeType === $type) { + $isValid = true; + break; + } + } + } + + if (! $isValid) { + throw ValidationException::withMessages([ + 'file' => [__('The file type is not allowed. Accepted types: :types', ['types' => $accept])], + ]); + } + } +} diff --git a/src/Foundation/src/Http/Middleware/EnsureDependenciesBuilt.php b/src/Foundation/src/Http/Middleware/EnsureDependenciesBuilt.php index 981e4d0..ad5702d 100644 --- a/src/Foundation/src/Http/Middleware/EnsureDependenciesBuilt.php +++ b/src/Foundation/src/Http/Middleware/EnsureDependenciesBuilt.php @@ -49,7 +49,8 @@ protected function dependenciesNeedBuilding(string $lockFile): bool foreach (['files', 'directories'] as $type) { foreach ($lock[$type] as $path => $timestamp) { - $path = base_path($path); + // Paths outside the application, such as a symlinked package, are stored as absolute paths. + $path = file_exists(base_path($path)) ? base_path($path) : $path; if (! file_exists($path) || $timestamp !== filemtime($path)) { return true; diff --git a/src/Foundation/src/Jobs/ExtractLanguageTokens.php b/src/Foundation/src/Jobs/ExtractLanguageTokens.php index b727b15..f652cfb 100644 --- a/src/Foundation/src/Jobs/ExtractLanguageTokens.php +++ b/src/Foundation/src/Jobs/ExtractLanguageTokens.php @@ -35,7 +35,9 @@ public function handle(): void ]; $extractor = new LangExtractor; - $extractor->searchIn(...$directories)->withExtensions('php', 'js'); + $extractor->searchIn(...$directories) + ->searchInPackages(dirname(__DIR__, 2) . '/public', dirname(__DIR__, 2) . '/resources') + ->withExtensions('php', 'js'); $translations = $extractor->extract()->all(); foreach ($translations as $key => $value) { diff --git a/src/Foundation/src/RedotServiceProvider.php b/src/Foundation/src/RedotServiceProvider.php index 4d0fe5d..f55e21b 100644 --- a/src/Foundation/src/RedotServiceProvider.php +++ b/src/Foundation/src/RedotServiceProvider.php @@ -20,6 +20,7 @@ use Illuminate\Support\Facades\Session; use Illuminate\Support\Facades\URL; use Illuminate\Support\Facades\Validator; +use Illuminate\Support\Facades\View; use Illuminate\Support\ServiceProvider; use Redot\Auth\RedotAuthServiceProvider; use Redot\Commands\BuildDependenciesCommand; @@ -29,6 +30,7 @@ use Redot\Commands\LintCommand; use Redot\Commands\ModelPopulateCommand; use Redot\Commands\PublicLinkCommand; +use Redot\Commands\PublishAssetsCommand; use Redot\Commands\PublishLanguageTokensCommand; use Redot\Commands\RevertLanguageTokensCommand; use Redot\Commands\SyncLanguageTokensCommand; @@ -42,14 +44,51 @@ use Redot\Sidebar\Sidebar; use Redot\Support\PermissionNameResolver; use Redot\Toastify\LaravelToastifyServiceProvider; +use Redot\View\Components; class RedotServiceProvider extends ServiceProvider { + /** + * The package Blade components. + * + * @var array + */ + protected array $components = [ + 'alert' => Components\Alert::class, + 'apex-chart' => Components\ApexChart::class, + 'attachments' => Components\Attachments::class, + 'avatar' => Components\Avatar::class, + 'captcha' => Components\Captcha::class, + 'checkboxes' => Components\Checkboxes::class, + 'color-picker' => Components\ColorPicker::class, + 'date-picker' => Components\DatePicker::class, + 'file-hint' => Components\FileHint::class, + 'form' => Components\Form::class, + 'form-card' => Components\FormCard::class, + 'icon-picker' => Components\IconPicker::class, + 'input' => Components\Input::class, + 'query-builder' => Components\QueryBuilder::class, + 'radios' => Components\Radios::class, + 'radios-colored' => Components\RadiosColored::class, + 'rating' => Components\Rating::class, + 'repeater' => Components\Repeater::class, + 'rich-editor' => Components\RichEditor::class, + 'select' => Components\Select::class, + 'select-remote' => Components\SelectRemote::class, + 'status' => Components\Status::class, + 'textarea' => Components\Textarea::class, + 'toasts' => Components\Toasts::class, + 'toggle' => Components\Toggle::class, + 'translatable' => Components\Translatable::class, + 'uploader' => Components\Uploader::class, + ]; + public function register(): void { $this->config(); $this->stubs(); $this->migrations(); + $this->assets(); $this->commands([ BuildDependenciesCommand::class, @@ -59,6 +98,7 @@ public function register(): void LintCommand::class, ModelPopulateCommand::class, PublicLinkCommand::class, + PublishAssetsCommand::class, PublishLanguageTokensCommand::class, RevertLanguageTokensCommand::class, SyncLanguageTokensCommand::class, @@ -106,6 +146,16 @@ protected function migrations(): void ], 'redot::migrations'); } + /** + * Register the package public assets and the third-party libraries they use. + */ + protected function assets(): void + { + $this->publishes([ + __DIR__ . '/../public' => public_path('vendor/redot'), + ], 'redot::assets'); + } + /** * Bootstrap any application services. */ @@ -182,8 +232,18 @@ protected function configureAboutCommand(): void */ protected function configureBlade(): void { - Blade::anonymousComponentPath(resource_path('layouts'), 'layouts'); - Blade::componentNamespace('App\\View\\Layouts', 'layouts'); + Blade::anonymousComponentPath(base_path(config('redot.paths.layouts.path')), 'layouts'); + Blade::componentNamespace(config('redot.paths.layouts.namespace'), 'layouts'); + + // Package views resolve after the application's, so a same-named view overrides them. + View::addLocation(__DIR__ . '/../resources'); + + // An application component class with the same name takes precedence over the package one. + foreach ($this->components as $alias => $component) { + if (class_exists($this->app->getNamespace() . 'View\\Components\\' . class_basename($component))) continue; + + Blade::component($alias, $component); + } Blade::directive('themer', function ($expression = 'theme') { $expression = str_replace(['"', "'", '`'], '', $expression); @@ -194,7 +254,7 @@ protected function configureBlade(): void @push('pre-content') - + @endpush EOT ); diff --git a/src/Foundation/src/View/Components/Alert.php b/src/Foundation/src/View/Components/Alert.php new file mode 100644 index 0000000..a8dff99 --- /dev/null +++ b/src/Foundation/src/View/Components/Alert.php @@ -0,0 +1,54 @@ + 'ti ti-circle-check', + 'error' => 'ti ti-circle-x', + 'warning' => 'ti ti-alert-triangle', + 'info' => 'ti ti-info-circle', + ]; + + /** + * Create a new component instance. + */ + public function __construct( + public ?string $icon = null, + public ?string $title = null, + public ?string $description = null, + public string $type = 'success', + public bool $dismissible = false, + ) {} + + /** + * Get the view / contents that represent the component. + */ + public function render(): View|Closure|string + { + $this->type = in_array($this->type, array_keys(self::TYPES_ICONS)) ? $this->type : 'success'; + $this->icon ??= self::TYPES_ICONS[$this->type]; + + return function (): View { + $this->attributes(function (ComponentAttributeBag $attributes) { + return $attributes->class([ + 'alert', + 'alert-' . ($this->type === 'error' ? 'danger' : $this->type), + 'alert-dismissible' => $this->dismissible, + ]); + }); + + return view($this->view); + }; + } +} diff --git a/src/Foundation/src/View/Components/ApexChart.php b/src/Foundation/src/View/Components/ApexChart.php new file mode 100644 index 0000000..41bca67 --- /dev/null +++ b/src/Foundation/src/View/Components/ApexChart.php @@ -0,0 +1,87 @@ +id ??= uniqid('apex-chart-'); + + $options = $this->normalizeOptions($this->options); + $series = $this->normalizeOptions($this->series); + + if ($series !== []) { + $options['series'] = $series; + } + + if ($this->type) { + data_set($options, 'chart.type', $this->type); + } + + if ($this->height !== null) { + data_set($options, 'chart.height', $this->height); + } + + if ($this->width !== null) { + data_set($options, 'chart.width', $this->width); + } + + return function () use ($options): View { + $this->attributes(function (ComponentAttributeBag $attributes) use ($options) { + return $attributes->merge([ + 'apex-chart' => json_encode($options, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES), + ]); + }); + + return view($this->view); + }; + } + + /** + * Normalize chart options from arrays, collections, or JSON strings. + */ + protected function normalizeOptions(array|string|Collection|null $options): array + { + if ($options instanceof Collection) { + return $options->toArray(); + } + + if (is_array($options)) { + return $options; + } + + if (is_string($options) && trim($options) !== '') { + $decoded = json_decode($options, true); + + return is_array($decoded) ? $decoded : []; + } + + return []; + } +} diff --git a/src/Foundation/src/View/Components/Attachments.php b/src/Foundation/src/View/Components/Attachments.php new file mode 100644 index 0000000..3e975a3 --- /dev/null +++ b/src/Foundation/src/View/Components/Attachments.php @@ -0,0 +1,81 @@ +id ??= uniqid('attachments-'); + + return view($this->view); + } + + /** + * Get the file icon for the given MIME type. + */ + public function getFileIcon(string $mimeType): string + { + $icons = [ + 'application/pdf' => 'ti ti-file-type-pdf', + 'application/msword' => 'ti ti-file-type-doc', + 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' => 'ti ti-file-type-doc', + 'application/vnd.ms-excel' => 'ti ti-file-type-xls', + 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' => 'ti ti-file-type-xls', + 'application/vnd.ms-powerpoint' => 'ti ti-file-type-ppt', + 'application/vnd.openxmlformats-officedocument.presentationml.presentation' => 'ti ti-file-type-ppt', + 'application/zip' => 'ti ti-file-zip', + 'application/x-rar-compressed' => 'ti ti-file-zip', + 'application/x-7z-compressed' => 'ti ti-file-zip', + 'text/plain' => 'ti ti-file-text', + 'text/html' => 'ti ti-file-code', + 'text/css' => 'ti ti-file-code', + 'text/javascript' => 'ti ti-file-code', + 'application/json' => 'ti ti-file-code', + 'video/' => 'ti ti-video', + 'audio/' => 'ti ti-file-music', + ]; + + foreach ($icons as $type => $icon) { + if (str_starts_with($mimeType, $type)) return $icon; + } + + return 'ti ti-file'; + } + + /** + * Format the file size. + */ + public function formatFileSize(int $size): string + { + $units = ['B', 'KB', 'MB', 'GB', 'TB']; + $index = 0; + + while ($size >= 1024 && $index < count($units) - 1) { + $size /= 1024; + $index++; + } + + return round($size, 2) . ' ' . $units[$index]; + } +} diff --git a/src/Foundation/src/View/Components/Avatar.php b/src/Foundation/src/View/Components/Avatar.php new file mode 100644 index 0000000..f2caf83 --- /dev/null +++ b/src/Foundation/src/View/Components/Avatar.php @@ -0,0 +1,45 @@ +attributes(function (ComponentAttributeBag $attributes) { + $style = sprintf('background-image: url(%s)', $this->image); + + return $attributes->class([ + 'avatar', + "avatar-{$this->size}", + ])->style([ + $style => $this->image, + ]); + }); + + return view($this->view); + }; + } +} diff --git a/src/Foundation/src/View/Components/Captcha.php b/src/Foundation/src/View/Components/Captcha.php new file mode 100644 index 0000000..134d2dc --- /dev/null +++ b/src/Foundation/src/View/Components/Captcha.php @@ -0,0 +1,43 @@ +id ??= uniqid('captcha-'); + + return function (): View { + $this->attributes(function (ComponentAttributeBag $attributes) { + return $attributes->class(['cf-turnstile'])->merge([ + 'init' => 'turnstile', + ]); + }); + + return view($this->view); + }; + } +} diff --git a/src/Foundation/src/View/Components/Checkboxes.php b/src/Foundation/src/View/Components/Checkboxes.php new file mode 100644 index 0000000..188b23f --- /dev/null +++ b/src/Foundation/src/View/Components/Checkboxes.php @@ -0,0 +1,56 @@ +disabled)) { + $this->disabled = is_string($this->disabled) ? parse_csv($this->disabled) : [$this->disabled]; + } + + return parent::render(); + } + + /** + * Prepare the attributes and any extra view data once attributes are available. + */ + protected function prepare(array $data): array + { + // If the value is csv, we will convert it to an array. + if (! is_array($this->value)) { + $this->value = is_string($this->value) ? parse_csv($this->value) : [$this->value]; + } + + return []; + } +} diff --git a/src/Foundation/src/View/Components/ColorPicker.php b/src/Foundation/src/View/Components/ColorPicker.php new file mode 100644 index 0000000..4e32e44 --- /dev/null +++ b/src/Foundation/src/View/Components/ColorPicker.php @@ -0,0 +1,20 @@ +attributes->getAttributes()); + + $this->withAttributes($callback($attributes)->getAttributes()); + } +} diff --git a/src/Foundation/src/View/Components/DatePicker.php b/src/Foundation/src/View/Components/DatePicker.php new file mode 100644 index 0000000..da25ef9 --- /dev/null +++ b/src/Foundation/src/View/Components/DatePicker.php @@ -0,0 +1,20 @@ +attributes(function (ComponentAttributeBag $attributes) { + $attributes = $attributes->class(['text-decoration-none']); + + if ($this->lightbox) { + $attributes = $attributes->merge([ + 'data-lightbox' => '', + ]); + } + + return $attributes; + }); + + return view($this->view); + }; + } +} diff --git a/src/Foundation/src/View/Components/Form.php b/src/Foundation/src/View/Components/Form.php new file mode 100644 index 0000000..7e00f63 --- /dev/null +++ b/src/Foundation/src/View/Components/Form.php @@ -0,0 +1,63 @@ +id ??= uniqid('form-'); + $this->method = strtoupper($this->method); + $this->formMethod = $this->method === 'GET' ? 'GET' : 'POST'; + + if ($this->route) { + $this->action = route($this->route, $this->routeParams); + } + + $this->identifier = base64_encode(sprintf('%s:%s', $this->action, $this->method)); + + $keep = request()->query('keep', []); + + // Append the keep params to the action as query params. + if (is_array($keep) && ! empty($keep)) { + $this->action .= str_contains($this->action, '?') ? '&' : '?'; + $this->action .= Arr::query($keep); + } + + return view($this->view); + } +} diff --git a/src/Foundation/src/View/Components/FormCard.php b/src/Foundation/src/View/Components/FormCard.php new file mode 100644 index 0000000..171c91a --- /dev/null +++ b/src/Foundation/src/View/Components/FormCard.php @@ -0,0 +1,70 @@ +title ??= $this->entry ? __('Edit') : __('Create'); + $this->submit ??= $this->entry ? __('Update') : __('Create'); + + // When no explicit URL is passed, resolve `dashboard.{resource}.store|update` and build the action. + if (! $this->action) { + // Route name suffix matches Laravel conventions: store for new records, update for existing. + $this->route ??= "dashboard.$this->resource." . ($this->entry ? 'update' : 'store'); + + // Update routes expect the model (or key) as the last route parameter; merge it into `params`. + if ($this->entry) { + $this->routeParams = array_merge($this->routeParams, [$this->entry]); + } + + // Build the action URL using the route and params. + $this->action = route($this->route, $this->routeParams); + } + + // Form method: PUT for updates, POST for creates. + $this->method ??= $this->entry ? 'PUT' : 'POST'; + + // Back link defaults to the resource index route name. + $this->back ??= "dashboard.$this->resource.index"; + + // If the page is inline, unset the back link. + if (request()->has('inline')) $this->back = null; + + $this->data = array_merge($this->data, [ + 'entry' => $this->entry, + ]); + + return view($this->view, $this->data); + } +} diff --git a/src/Foundation/src/View/Components/FormField.php b/src/Foundation/src/View/Components/FormField.php new file mode 100644 index 0000000..6536ca6 --- /dev/null +++ b/src/Foundation/src/View/Components/FormField.php @@ -0,0 +1,75 @@ +id ??= uniqid(Str::kebab(class_basename($this)) . '-'); + + return function (array $data): View { + $this->fillOldInput(); + + $with = array_merge(['required' => $this->isRequired()], $this->prepare($data)); + + if (property_exists($this, 'value')) { + $with['value'] = $this->value; + } + + return view($this->view, $with); + }; + } + + /** + * Prepare the attributes and any extra view data once attributes are available. + */ + protected function prepare(array $data): array + { + return []; + } + + /** + * Determine if the validation rules contain the `required` rule. + */ + protected function isRequired(): bool + { + $rules = explode('|', (string) $this->attributes->get('validation', $this->validation)); + + return in_array('required', array_map('trim', $rules), true); + } + + /** + * Replace the value with the old input when the field's name was flashed. + */ + protected function fillOldInput(): void + { + $key = str_replace(['[]', '[', ']'], ['', '.', ''], (string) $this->attributes->get('name', $this->name)); + + if (! Arr::has(old(), $key)) return; + + if (property_exists($this, 'value')) { + $this->value = old($key); + } else { + $this->attributes['value'] = old($key); + } + } +} diff --git a/src/Foundation/src/View/Components/IconPicker.php b/src/Foundation/src/View/Components/IconPicker.php new file mode 100644 index 0000000..1db4f7f --- /dev/null +++ b/src/Foundation/src/View/Components/IconPicker.php @@ -0,0 +1,20 @@ +isPassword = strtolower($this->type) === 'password'; + + if ($this->isPassword) { + $this->flat = true; + } + + return parent::render(); + } + + /** + * Prepare the attributes and any extra view data once attributes are available. + */ + protected function prepare(array $data): array + { + return [ + 'isInputGroup' => $data['prepend'] || $data['append'] || $this->isPassword, + ]; + } +} diff --git a/src/Foundation/src/View/Components/QueryBuilder.php b/src/Foundation/src/View/Components/QueryBuilder.php new file mode 100644 index 0000000..aa68057 --- /dev/null +++ b/src/Foundation/src/View/Components/QueryBuilder.php @@ -0,0 +1,56 @@ +filters = QueryFilters::resolve($this->model, $this->filters); + + return parent::render(); + } + + /** + * Prepare the attributes and any extra view data once attributes are available. + */ + protected function prepare(array $data): array + { + // Convert array to JSON string + if (is_array($this->value) || $this->value instanceof Collection) { + $this->value = json_encode($this->value, JSON_UNESCAPED_UNICODE); + } + + $this->attributes(function (ComponentAttributeBag $attributes) { + return $attributes->merge(['query-filters' => is_array($this->filters) ? json_encode($this->filters, JSON_UNESCAPED_UNICODE) : $this->filters]); + }); + + return []; + } +} diff --git a/src/Foundation/src/View/Components/Radios.php b/src/Foundation/src/View/Components/Radios.php new file mode 100644 index 0000000..53d159c --- /dev/null +++ b/src/Foundation/src/View/Components/Radios.php @@ -0,0 +1,43 @@ +disabled)) { + $this->disabled = is_string($this->disabled) ? parse_csv($this->disabled) : [$this->disabled]; + } + + return parent::render(); + } +} diff --git a/src/Foundation/src/View/Components/RadiosColored.php b/src/Foundation/src/View/Components/RadiosColored.php new file mode 100644 index 0000000..79bec1e --- /dev/null +++ b/src/Foundation/src/View/Components/RadiosColored.php @@ -0,0 +1,37 @@ +options as $index => $option) { + $this->options[$index] = $this->getColor($option); + } + + return parent::render(); + } + + /** + * Get the color for the given option. + */ + protected function getColor(string $color): string + { + $color = trim($color); + $isDirectColor = preg_match('/^[a-zA-Z]+$/', $color); + + return $isDirectColor ? "var(--tblr-$color, $color)" : $color; + } +} diff --git a/src/Foundation/src/View/Components/Rating.php b/src/Foundation/src/View/Components/Rating.php new file mode 100644 index 0000000..368a570 --- /dev/null +++ b/src/Foundation/src/View/Components/Rating.php @@ -0,0 +1,39 @@ +size = is_numeric($this->size) ? $this->size . 'px' : $this->size; + + return parent::render(); + } +} diff --git a/src/Foundation/src/View/Components/Repeater.php b/src/Foundation/src/View/Components/Repeater.php new file mode 100644 index 0000000..e0580a7 --- /dev/null +++ b/src/Foundation/src/View/Components/Repeater.php @@ -0,0 +1,36 @@ +value) || $this->value instanceof Collection) { + $this->value = json_encode($this->value, JSON_UNESCAPED_UNICODE); + } + + return []; + } +} diff --git a/src/Foundation/src/View/Components/RichEditor.php b/src/Foundation/src/View/Components/RichEditor.php new file mode 100644 index 0000000..b3bc71b --- /dev/null +++ b/src/Foundation/src/View/Components/RichEditor.php @@ -0,0 +1,30 @@ +attributes(function (ComponentAttributeBag $attributes) { + return $attributes->merge([ + 'init' => 'hugerte', + // Image uploads are offered only while the package endpoints are enabled. + 'hugerte-upload-url' => Route::has('global.hugerte.upload') ? route('global.hugerte.upload') : null, + ]); + }); + + return []; + } +} diff --git a/src/Foundation/src/View/Components/Select.php b/src/Foundation/src/View/Components/Select.php new file mode 100644 index 0000000..4494c23 --- /dev/null +++ b/src/Foundation/src/View/Components/Select.php @@ -0,0 +1,49 @@ +value)) { + $this->value = parse_csv(is_string($this->value) ? $this->value : [$this->value]); + } + + $this->attributes(function (ComponentAttributeBag $attributes) { + $attributes = $attributes->class(['form-select']); + + if ($this->tom) { + $attributes = $attributes->merge(['init' => 'tomselect']); + } + + return $attributes; + }); + + return []; + } +} diff --git a/src/Foundation/src/View/Components/SelectRemote.php b/src/Foundation/src/View/Components/SelectRemote.php new file mode 100644 index 0000000..9c8d205 --- /dev/null +++ b/src/Foundation/src/View/Components/SelectRemote.php @@ -0,0 +1,128 @@ +id ??= uniqid('select-'); + + // If the search is a csv, we will convert it to an array. + if (is_string($this->search)) { + $this->search = parse_csv($this->search); + } + + // If the appends is a csv, we will convert it to an array. + if (is_string($this->appends)) { + $this->appends = parse_csv($this->appends); + } + + // If the query is a string and a class exists, we will instantiate the class and get the query. + if (is_string($this->query) && class_exists($this->query)) { + $this->query = app($this->query)->query(); + } + + // If template doesn't start with `templates.select`, we will prefix it. + if ($this->template && ! str_starts_with($this->template, 'templates.select')) { + $this->template = 'templates.select.' . $this->template; + } + + // Append required params to the create route. + if ($this->create) { + $this->createParams = array_merge($this->createParams, [ + 'inline' => true, + 'keep' => ['from-select' => $this->id], + ]); + } + + return parent::render(); + } + + /** + * Prepare the attributes and any extra view data once attributes are available. + */ + protected function prepare(array $data): array + { + // If the value is csv, we will convert it to an array. + if (! is_array($this->value)) { + $this->value = parse_csv(is_string($this->value) ? $this->value : [$this->value]); + } + + $this->attributes(function (ComponentAttributeBag $attributes) { + return $attributes->merge([ + 'select-query' => $this->getQueryData(), + 'select-query-route' => route('global.select.search'), + 'select-fetch-route' => route('global.select.fetch'), + 'select-search-field' => json_encode($this->search), + 'select-preload-values' => implode(',', $this->value), + ]); + }); + + return []; + } + + /** + * Get the query data as encrypted string. + */ + protected function getQueryData(): string + { + $search = $this->search; + $columns = array_values(array_unique(array_merge($search, [$this->key, $this->text]))); + + $term = uniqid('term_'); + $query = $this->query->clone()->select($this->key); + $query = search_model($query, $columns, sprintf('{%s}', $term)); + + if ($this->template && ! view()->exists($this->template)) { + throw new InvalidArgumentException(sprintf('The template [%s] does not exist.', $this->template)); + } + + $data = [ + 'key' => $this->key, + 'text' => $this->text, + 'template' => $this->template, + + 'query' => $query->toSql(), + 'bindings' => $query->getBindings(), + 'model' => get_class($query->getModel()), + + 'term' => $term, + 'columns' => $columns, + 'appends' => $this->appends, + ]; + + return encrypt(json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)); + } +} diff --git a/src/Foundation/src/View/Components/Status.php b/src/Foundation/src/View/Components/Status.php new file mode 100644 index 0000000..7699390 --- /dev/null +++ b/src/Foundation/src/View/Components/Status.php @@ -0,0 +1,50 @@ +has($status)) { + $this->status = $status; + + return view($this->view); + } + } + + return ''; + } +} diff --git a/src/Foundation/src/View/Components/Textarea.php b/src/Foundation/src/View/Components/Textarea.php new file mode 100644 index 0000000..baa51e1 --- /dev/null +++ b/src/Foundation/src/View/Components/Textarea.php @@ -0,0 +1,38 @@ +autosize) { + $this->attributes(function (ComponentAttributeBag $attributes) { + return $attributes->merge(['data-bs-toggle' => 'autosize']); + }); + } + + return []; + } +} diff --git a/src/Foundation/src/View/Components/Toasts.php b/src/Foundation/src/View/Components/Toasts.php new file mode 100644 index 0000000..51e7ff0 --- /dev/null +++ b/src/Foundation/src/View/Components/Toasts.php @@ -0,0 +1,41 @@ +config = config('redot.toastify', []); + $this->messages = session()->pull('toastify', []); + } + + /** + * Get the view / contents that represent the component. + */ + public function render(): View|Closure|string + { + return view($this->view); + } +} diff --git a/src/Foundation/src/View/Components/Toggle.php b/src/Foundation/src/View/Components/Toggle.php new file mode 100644 index 0000000..c733386 --- /dev/null +++ b/src/Foundation/src/View/Components/Toggle.php @@ -0,0 +1,33 @@ +value = (bool) $this->value; + + return []; + } +} diff --git a/src/Foundation/src/View/Components/Translatable.php b/src/Foundation/src/View/Components/Translatable.php new file mode 100644 index 0000000..7f5cfb8 --- /dev/null +++ b/src/Foundation/src/View/Components/Translatable.php @@ -0,0 +1,91 @@ +id ??= uniqid('translatable-'); + + if (! $this->locales) { + $this->locales = array_keys(config('app.locales')); + } + + if (is_null($this->value)) { + $this->value = []; + } + + if (is_string($this->locales)) { + $this->locales = parse_csv($this->locales); + } + + if (is_string($this->validateLocales)) { + $this->validateLocales = parse_csv($this->validateLocales); + } + + foreach ($this->locales as $index => $locale) { + $validation = $this->validation; + + if ($this->validateLocales && ! in_array($locale, $this->validateLocales)) { + $validation = $this->validationWithoutRequiredRule(); + } + + if ($this->validateOnlyMainLocale && $index > 0) { + $validation = $this->validationWithoutRequiredRule(); + } + + $this->localesConfig[$locale] = [ + 'id' => sprintf('%s-%s', $this->id, $locale), + 'name' => $this->name ? sprintf('%s[%s]', $this->name, $locale) : null, + 'value' => $this->value[$locale] ?? null, + 'validation' => $validation, + ]; + } + + return view($this->view); + } + + /** + * Get the validation rules without the required rule. + */ + protected function validationWithoutRequiredRule(): ?string + { + $rules = array_filter( + array_map('trim', explode('|', $this->validation ?? '')), + fn (string $rule): bool => $rule !== '' && $rule !== 'required', + ); + + return $rules ? implode('|', $rules) : null; + } +} diff --git a/src/Foundation/src/View/Components/Uploader.php b/src/Foundation/src/View/Components/Uploader.php new file mode 100644 index 0000000..8ab8cfd --- /dev/null +++ b/src/Foundation/src/View/Components/Uploader.php @@ -0,0 +1,68 @@ +value) || $this->value instanceof Collection) { + $this->value = json_encode($this->value, JSON_UNESCAPED_UNICODE); + } + + $this->attributes(function (ComponentAttributeBag $attributes) { + return $attributes->merge([ + 'init' => 'uploader', + 'uploader-accept' => $this->accept, + 'uploader-config' => $this->getUploaderConfig(), + 'uploader-endpoint' => route('global.uploader.upload'), + ]); + }); + + return []; + } + + /** + * Get the uploader data. + */ + protected function getUploaderConfig(): string + { + $data = [ + 'accept' => $this->accept, + 'directory' => $this->directory, + 'locale' => app()->getLocale(), + 'serverValidation' => $this->serverValidation, + 'optimize' => $this->optimize, + 'thumbnail' => $this->thumbnail, + ]; + + return encrypt(json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)); + } +} diff --git a/src/Foundation/src/utilities/authorization.php b/src/Foundation/src/utilities/authorization.php index 9a6cbc9..654db49 100644 --- a/src/Foundation/src/utilities/authorization.php +++ b/src/Foundation/src/utilities/authorization.php @@ -2,6 +2,7 @@ use Illuminate\Auth\Middleware\Authenticate; use Illuminate\Routing\Route as RoutingRoute; +use Illuminate\Support\Collection; use Illuminate\Support\Facades\Gate; use Illuminate\Support\Facades\Request; use Illuminate\Support\Facades\Route; @@ -26,7 +27,7 @@ function route_from_url(string $url): ?string /** * Resolve the guard a route authenticates against. */ -function route_guard(RoutingRoute $route, string $default = 'admins'): string +function route_guard(RoutingRoute $route, ?string $default = null): string { foreach (Route::gatherRouteMiddleware($route) as $middleware) { if (is_string($middleware) && str($middleware)->startsWith(Authenticate::class . ':')) { @@ -34,7 +35,7 @@ function route_guard(RoutingRoute $route, string $default = 'admins'): string } } - return $default; + return $default ?? config('redot.features.dashboard.guard'); } /** @@ -45,7 +46,7 @@ function route_allowed(RoutingRoute|string $route, ?string $guard = null): bool $registeredRoute = PermissionNameResolver::route($route); // Guess the guard from the route's auth middleware when none is given - $guard ??= $registeredRoute ? route_guard($registeredRoute) : 'admins'; + $guard ??= $registeredRoute ? route_guard($registeredRoute) : config('redot.features.dashboard.guard'); if (! auth($guard)->check()) { return false; @@ -78,3 +79,17 @@ function url_allowed(string $url, ?string $guard = null): bool return route_allowed(route_from_url($url) ?: '', $guard); } + +/** + * Get the active browser sessions for the current account on the given guard. + */ +function current_sessions(string $guard): Collection +{ + if (config('session.driver') !== 'database' || ! $user = auth($guard)->user()) { + return collect(); + } + + return $user->sessions()->wherePivot('guard', $guard) + ->where('last_activity', '>=', now()->subMinutes(config('session.lifetime'))->timestamp) + ->orderByDesc('last_activity')->get(); +} diff --git a/src/Foundation/src/utilities/navigation.php b/src/Foundation/src/utilities/navigation.php index 9951ecf..ce432a2 100644 --- a/src/Foundation/src/utilities/navigation.php +++ b/src/Foundation/src/utilities/navigation.php @@ -38,3 +38,21 @@ function back_or_route(string $route, mixed $parameters = [], bool $absolute = t return $sameOrigin && $insideApp ? $url : $route; } + +/** + * Determine whether the current request belongs to the dashboard scope. + */ +function is_dashboard_request(): bool +{ + if (request()->routeIs('dashboard.*')) { + return true; + } + + // Unmatched requests (e.g. 404s) carry no dashboard route, so compare the + // URL against the dashboard root built from the configured prefix and, + // when locales are part of the URL, the current locale. + $prefix = config('redot.features.dashboard.prefix'); + $root = url(config('redot.routing.append_locale_to_url') ? app()->getLocale() . '/' . $prefix : $prefix); + + return url()->current() === $root || str_starts_with(url()->current(), "{$root}/"); +} diff --git a/src/LangExtractor/src/LangExtractor.php b/src/LangExtractor/src/LangExtractor.php index 4d4edb1..43d17cd 100644 --- a/src/LangExtractor/src/LangExtractor.php +++ b/src/LangExtractor/src/LangExtractor.php @@ -17,6 +17,11 @@ class LangExtractor */ protected array $directories = []; + /** + * Directories to search even when version control ignores them, such as installed packages. + */ + protected array $packageDirectories = []; + /** * File extensions to search for. */ @@ -77,6 +82,20 @@ public function searchIn(string ...$directories): static return $this; } + /** + * Set package directories to search regardless of version control ignore rules. + */ + public function searchInPackages(string ...$directories): static + { + foreach ($directories as $directory) { + if (! in_array($directory, $this->packageDirectories)) { + $this->packageDirectories[] = $directory; + } + } + + return $this; + } + /** * Set the file extensions to search for. */ @@ -123,16 +142,19 @@ protected function generatePatternUsing(string ...$functions): string */ public function extract(): static { - if (count($this->directories) === 0) { + if (count($this->directories) === 0 && count($this->packageDirectories) === 0) { $this->searchIn(app_path(), resource_path(), base_path('routes'), database_path('seeders')); } - $directories = array_values(array_filter($this->directories, fn ($directory) => is_dir($directory))); - $translations = collect(); - if (count($directories) > 0) { - $files = Finder::create()->files()->ignoreVCSIgnored(true); + // Application directories honor version control ignore rules; package directories usually live in an ignored vendor directory. + foreach ([[$this->directories, true], [$this->packageDirectories, false]] as [$directories, $ignoreVcs]) { + $directories = array_values(array_filter($directories, fn ($directory) => is_dir($directory))); + + if (count($directories) === 0) continue; + + $files = Finder::create()->files()->ignoreVCSIgnored($ignoreVcs); $files->in($directories)->name(array_map(fn ($extension) => '*.' . $extension, $this->extensions)); foreach ($files as $file) { diff --git a/src/Sidebar/src/Sidebar.php b/src/Sidebar/src/Sidebar.php index 4a89c9d..e2c0ba0 100644 --- a/src/Sidebar/src/Sidebar.php +++ b/src/Sidebar/src/Sidebar.php @@ -19,21 +19,21 @@ class Sidebar /** * Sidebar guard. */ - public string $guard = 'admins'; + public string $guard; /** * Create a new sidebar instance. */ - public function __construct(array $items = [], string $guard = 'admins') + public function __construct(array $items = [], ?string $guard = null) { $this->items = $items; - $this->guard = $guard; + $this->guard = $guard ?? config('redot.features.dashboard.guard'); } /** * Create a new sidebar instance statically. */ - public static function make(array $items = [], string $guard = 'admins'): static + public static function make(array $items = [], ?string $guard = null): static { return new static($items, $guard); } diff --git a/src/Toastify/config/toastify.php b/src/Toastify/config/toastify.php deleted file mode 100644 index 0f1caba..0000000 --- a/src/Toastify/config/toastify.php +++ /dev/null @@ -1,50 +0,0 @@ - [ - 'toast' => [ - 'icon' => 'ti ti-bell', - 'color' => 'var(--tblr-secondary)', - ], - 'error' => [ - 'icon' => 'ti ti-circle-x', - 'color' => 'var(--tblr-danger)', - ], - 'success' => [ - 'icon' => 'ti ti-circle-check', - 'color' => 'var(--tblr-success)', - ], - 'info' => [ - 'icon' => 'ti ti-info-circle', - 'color' => 'var(--tblr-info)', - ], - 'warning' => [ - 'icon' => 'ti ti-alert-triangle', - 'color' => 'var(--tblr-warning)', - ], - ], - - /*-------------------------------------------------------------------------- - | Toastify Defaults - |-------------------------------------------------------------------------- - | - | The default values for the toastifiers. - | - */ - - 'defaults' => [ - 'position' => 'bottom-right', - 'close' => true, - 'autohide' => true, - 'delay' => 5000, - ], -]; diff --git a/src/Toastify/src/LaravelToastifyServiceProvider.php b/src/Toastify/src/LaravelToastifyServiceProvider.php index 0e12c88..545f98e 100644 --- a/src/Toastify/src/LaravelToastifyServiceProvider.php +++ b/src/Toastify/src/LaravelToastifyServiceProvider.php @@ -11,19 +11,7 @@ class LaravelToastifyServiceProvider extends ServiceProvider */ public function register(): void { - $this->mergeConfigFrom(__DIR__ . '/../config/toastify.php', 'toastify'); - $this->app->singleton(Toastify::class, fn () => new Toastify); $this->app->alias(Toastify::class, 'toastify'); } - - /** - * Bootstrap the application services. - */ - public function boot(): void - { - $this->publishes([ - __DIR__ . '/../config/toastify.php' => config_path('toastify.php'), - ], 'toastify::config'); - } } diff --git a/src/Toastify/src/Toastify.php b/src/Toastify/src/Toastify.php index abc01dd..570afd3 100644 --- a/src/Toastify/src/Toastify.php +++ b/src/Toastify/src/Toastify.php @@ -28,7 +28,7 @@ protected function push(string $title, ?string $message, string $type, array $op */ public function __call(string $name, array $arguments) { - if (! array_key_exists($name, config('toastify.toastifiers', []))) { + if (! array_key_exists($name, config('redot.toastify.toastifiers', []))) { throw new BadMethodCallException(sprintf('Toast type [%s] is not defined in the toastify configuration.', $name)); } diff --git a/tests/Feature/.gitkeep b/tests/Feature/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/tests/Feature/Core/ApplicationTest.php b/tests/Feature/Core/ApplicationTest.php deleted file mode 100644 index 278b90c..0000000 --- a/tests/Feature/Core/ApplicationTest.php +++ /dev/null @@ -1,53 +0,0 @@ -app['env']; - $basePath = $this->app->basePath(); - $routes = Route::getRoutes(); - $property = new ReflectionProperty(RouteServiceProvider::class, 'alwaysLoadRoutesUsing'); - $original = $property->getValue(); - - try { - Application::configure(dirname(__DIR__, 2) . '/Fixtures/Application'); - $registerRoutes = $property->getValue(); - Container::setInstance($this->app); - $this->app->setBasePath(dirname(__DIR__, 2) . '/Fixtures/Application'); - Route::setRoutes(new RouteCollection); - config(["redot.features.{$feature}.enabled" => $enabled]); - - $this->app['env'] = $environment; - if ($enableAllFeatures !== null) { - config(['redot.testing.enable_all_features' => $enableAllFeatures]); - } - $expected = $enabled || ($environment === 'testing' && ($enableAllFeatures ?? true)); - - $registerRoutes(); - Route::getRoutes()->refreshNameLookups(); - - expect(app()->runningUnitTests())->toBe($environment === 'testing') - ->and(config("redot.features.{$feature}.enabled"))->toBe($expected) - ->and(Route::has($route))->toBe($expected) - ->and(Route::has('global.index'))->toBeTrue(); - } finally { - $this->app['env'] = $originalEnvironment; - Container::setInstance($this->app); - $this->app->setBasePath($basePath); - Route::setRoutes($routes); - RouteServiceProvider::loadRoutesUsing($original); - } -})->with([ - ['website', 'website.index'], - ['dashboard', 'dashboard.index'], - ['website-api', 'api.website.index'], - ['dashboard-api', 'api.dashboard.index'], -])->with([true, false])->with([ - 'shared suite default' => [null, 'testing'], - 'feature configuration tests' => [false, 'testing'], - 'production' => [true, 'production'], -]); diff --git a/tests/Feature/Core/Commands/SyncPermissionsCommandTest.php b/tests/Feature/Core/Commands/SyncPermissionsCommandTest.php deleted file mode 100644 index d647e72..0000000 --- a/tests/Feature/Core/Commands/SyncPermissionsCommandTest.php +++ /dev/null @@ -1,121 +0,0 @@ -group(function () { - Route::get('/permission-test/users/create', fn () => 'create')->name('permission-test.users.create'); - Route::post('/permission-test/users', fn () => 'store')->name('permission-test.users.store'); - Route::get('/permission-test/users/{user}/edit', fn () => 'edit')->name('permission-test.users.edit'); - Route::put('/permission-test/users/{user}', fn () => 'update')->name('permission-test.users.update'); - Route::delete('/permission-test/users/{user}', fn () => 'destroy')->name('permission-test.users.destroy'); - Route::post('/permission-test/users/{user}/suspend', fn () => 'suspend') - ->name('permission-test.users.suspend.store') - ->usePermission('permission-test.users.suspend'); - - Route::resource('/permission-test/articles', stdClass::class) - ->only(['store', 'update']) - ->names([ - 'store' => 'permission-test.articles.store', - 'update' => 'permission-test.articles.update', - ]) - ->usePermissions([ - 'store' => 'permission-test.articles.publish', - ]); - }); - - Route::post('/permission-test/unprotected', fn () => 'unprotected') - ->name('permission-test.unprotected'); - - $this->artisan('permissions:sync')->assertSuccessful(); - - expect(Permission::query() - ->where('name', 'like', 'permission-test.%') - ->orderBy('name') - ->get(['name', 'guard_name']) - ->map(fn (Permission $permission) => [$permission->name, $permission->guard_name]) - ->all())->toBe([ - ['permission-test.articles.edit', 'admins'], - ['permission-test.articles.publish', 'admins'], - ['permission-test.users.create', 'admins'], - ['permission-test.users.destroy', 'admins'], - ['permission-test.users.edit', 'admins'], - ['permission-test.users.suspend', 'admins'], - ]); -}); - -it('stores one permission for guards sharing a provider', function () { - config(['auth.guards.admins-api' => ['driver' => 'session', 'provider' => 'admins']]); - - Route::middleware(RoutePermission::class)->group(function () { - Route::post('/permission-test/admins', fn () => 'store') - ->middleware('auth:admins') - ->name('permission-test.admins.store'); - - Route::post('/permission-test/api/admins', fn () => 'store') - ->middleware('auth:admins-api') - ->name('permission-test.api.admins.store') - ->usePermission('permission-test.admins.create'); - }); - - $this->artisan('permissions:sync')->assertSuccessful(); - - expect(Permission::query() - ->where('name', 'like', 'permission-test.%') - ->get(['name', 'guard_name']) - ->map(fn (Permission $permission) => [$permission->name, $permission->guard_name]) - ->all())->toBe([ - ['permission-test.admins.create', 'admins'], - ]); -}); - -it('stamps discovered permissions without touching manually created ones', function () { - Route::middleware(RoutePermission::class)->group(function () { - Route::get('/permission-test/users', fn () => 'index')->name('permission-test.users.index'); - }); - - $custom = Permission::create(['name' => 'permission-test.custom', 'guard_name' => 'admins']); - - $this->artisan('permissions:sync')->assertSuccessful(); - - expect(Permission::findByName('permission-test.users.index', 'admins')->discovered_at)->not->toBeNull() - ->and($custom->fresh()->discovered_at)->toBeNull(); -}); - -it('prunes stale discovered permissions but keeps custom and current ones', function () { - Route::middleware(RoutePermission::class)->group(function () { - Route::get('/permission-test/users', fn () => 'index')->name('permission-test.users.index'); - }); - - Permission::create(['name' => 'permission-test.stale', 'guard_name' => 'admins', 'discovered_at' => now()]); - Permission::create(['name' => 'permission-test.custom', 'guard_name' => 'admins']); - - $this->artisan('permissions:sync --prune') - ->expectsConfirmation('Delete 1 stale permission(s)?', 'yes') - ->assertSuccessful(); - - expect(Permission::query() - ->where('name', 'like', 'permission-test.%') - ->orderBy('name') - ->pluck('name') - ->all())->toBe([ - 'permission-test.custom', - 'permission-test.users.index', - ]); -}); - -it('keeps stale permissions when pruning is not confirmed', function () { - Route::middleware(RoutePermission::class)->group(function () { - Route::get('/permission-test/users', fn () => 'index')->name('permission-test.users.index'); - }); - - Permission::create(['name' => 'permission-test.stale', 'guard_name' => 'admins', 'discovered_at' => now()]); - - $this->artisan('permissions:sync --prune') - ->expectsConfirmation('Delete 1 stale permission(s)?') - ->assertSuccessful(); - - expect(Permission::where('name', 'permission-test.stale')->exists())->toBeTrue(); -}); diff --git a/tests/Feature/Core/Commands/ViewMakeCommandTest.php b/tests/Feature/Core/Commands/ViewMakeCommandTest.php deleted file mode 100644 index d387591..0000000 --- a/tests/Feature/Core/Commands/ViewMakeCommandTest.php +++ /dev/null @@ -1,26 +0,0 @@ -app->make(Kernel::class) - ->all()['make:view'] - ->getDefinition(); - - expect($definition->hasOption('template'))->toBeTrue() - ->and($definition->hasOption('params'))->toBeTrue(); -}); - -it('renders a dashboard stub when make:view is given a template and params', function () { - $this->artisan('make:view', [ - 'name' => 'dashboard/posts/index', - '--template' => 'dashboard.index', - '--params' => 'resource=posts&entity=post&datatable=posts', - '--force' => true, - ])->assertSuccessful(); - - $path = resource_path('views/dashboard/posts/index.blade.php'); - - expect($path)->toBeFile() - ->and(file_get_contents($path))->toContain("route('dashboard.posts.create')"); -}); diff --git a/tests/Feature/Core/Http/Middleware/EnsureDependenciesBuiltTest.php b/tests/Feature/Core/Http/Middleware/EnsureDependenciesBuiltTest.php deleted file mode 100644 index 9be35ea..0000000 --- a/tests/Feature/Core/Http/Middleware/EnsureDependenciesBuiltTest.php +++ /dev/null @@ -1,131 +0,0 @@ -shouldReceive('call') - ->once() - ->with('dependencies:build') - ->andReturnUsing(function () { - File::replace(dist_path('lock.json'), json_encode([ - 'files' => [], - 'directories' => [], - ])); - }); - Artisan::swap($artisan); - - $response = (new EnsureDependenciesBuilt)->handle( - Request::create('/'), - fn () => new Response('next') - ); - - expect($response->getContent())->toBe('next'); -})->with([ - 'partial JSON' => '{"files":', - 'JSON null' => 'null', - 'missing directories' => '{"files":[]}', - 'non-array files' => '{"files":null,"directories":[]}', -]); - -it('checks the lock file again after acquiring the build lock', function () { - File::put(dist_path('lock.json'), '{'); - - $lock = Mockery::mock(Lock::class); - $lock->shouldReceive('block') - ->once() - ->with(60, Mockery::type(Closure::class)) - ->andReturnUsing(function (int $seconds, Closure $callback) { - File::replace(dist_path('lock.json'), json_encode([ - 'files' => [], - 'directories' => [], - ])); - - return $callback(); - }); - - Cache::shouldReceive('lock') - ->once() - ->with('redot.dependencies.build', 60) - ->andReturn($lock); - $artisan = Mockery::mock(); - $artisan->shouldReceive('call')->never(); - Artisan::swap($artisan); - - (new EnsureDependenciesBuilt)->handle( - Request::create('/'), - fn () => new Response('next') - ); -}); - -it('does not acquire the build lock when dependencies are current', function () { - File::put(dist_path('lock.json'), json_encode([ - 'files' => [], - 'directories' => [], - ])); - - Cache::shouldReceive('lock')->never(); - $artisan = Mockery::mock(); - $artisan->shouldReceive('call')->never(); - Artisan::swap($artisan); - - (new EnsureDependenciesBuilt)->handle( - Request::create('/'), - fn () => new Response('next') - ); -}); - -it('rebuilds dependencies when a tracked source file is modified', function () { - $source = base_path('lang/en.json'); - File::ensureDirectoryExists(dirname($source)); - File::put($source, '{}'); - - $relative = str_replace(base_path(), '', $source); - - File::put(dist_path('lock.json'), json_encode([ - 'files' => [ - $relative => filemtime($source) - 10, - ], - 'directories' => [], - ])); - - $artisan = Mockery::mock(); - $artisan->shouldReceive('call') - ->once() - ->with('dependencies:build') - ->andReturnUsing(function () use ($relative, $source) { - File::replace(dist_path('lock.json'), json_encode([ - 'files' => [ - $relative => filemtime($source), - ], - 'directories' => [], - ])); - }); - Artisan::swap($artisan); - - $response = (new EnsureDependenciesBuilt)->handle( - Request::create('/'), - fn () => new Response('next') - ); - - expect($response->getContent())->toBe('next'); -}); - -it('clears the build output when a dependencies build is triggered', function () { - File::ensureDirectoryExists(dist_path('translations')); - File::put(dist_path('lock.json'), '{}'); - File::put(dist_path('init.js'), 'window.__inits = {};'); - - trigger_dependencies_build(); - - expect(File::exists(dist_path('lock.json')))->toBeFalse() - ->and(File::exists(dist_path('init.js')))->toBeFalse(); -}); diff --git a/tests/Feature/Core/Middleware/LocalizationTest.php b/tests/Feature/Core/Middleware/LocalizationTest.php deleted file mode 100644 index df647b0..0000000 --- a/tests/Feature/Core/Middleware/LocalizationTest.php +++ /dev/null @@ -1,125 +0,0 @@ -array()->default(['en', 'ar']); - Setting::define('dashboard_locales')->array()->default(['en', 'ar']); -}); - -it('sets the application locale from the route parameter', function () { - Route::middleware(Localization::class . ':website') - ->get('/{locale}/localized-probe', fn () => response(app()->getLocale() . '|' . request()->route('locale', 'missing'))) - ->name('website.localized-probe'); - - $this->get('/ar/localized-probe') - ->assertOk() - ->assertSee('ar|missing') - ->assertPlainCookie('website_locale', 'ar'); - - expect(session('website_locale'))->toBe('ar') - ->and(app()->getLocale())->toBe('ar'); -}); - -it('redirects unsupported route locales to the fallback locale and preserves the query string', function () { - Route::middleware(Localization::class . ':website') - ->get('/{locale}/fallback-probe', fn () => response('ok')) - ->name('website.fallback-probe'); - - $this->get('/fr/fallback-probe?foo=bar') - ->assertRedirect('/en/fallback-probe?foo=bar') - ->assertStatus(301); -}); - -it('preserves a two-character path when adding the fallback locale', function () { - Route::middleware(Localization::class . ':website') - ->get('/{locale}', fn () => response('home')) - ->where('locale', '[a-zA-Z]{2}') - ->name('website.home'); - - Route::middleware(Localization::class . ':website') - ->get('/{locale}/up', fn () => response('up')) - ->where('locale', '[a-zA-Z]{2}') - ->name('website.up'); - - $this->get('/up?foo=bar') - ->assertRedirect('/en/up?foo=bar') - ->assertStatus(301); -}); - -it('lets the locale query string override the route locale', function () { - Route::middleware(Localization::class . ':website') - ->get('/{locale}/query-locale-probe', fn () => response('ok')) - ->name('website.query-locale-probe'); - - $this->get('/en/query-locale-probe?locale=ar') - ->assertRedirect('/ar/query-locale-probe?locale=ar') - ->assertStatus(301); -}); - -it('stores the active locale in the dashboard-scoped session key when the dashboard scope is passed', function () { - Route::middleware(Localization::class . ':dashboard') - ->get('/{locale}/dashboard/scope-probe', fn () => response(app()->getLocale())) - ->name('dashboard.scope-probe'); - - $this->get('/ar/dashboard/scope-probe') - ->assertOk() - ->assertSee('ar') - ->assertPlainCookie('dashboard_locale', 'ar') - ->assertCookieMissing('website_locale'); - - expect(session('dashboard_locale'))->toBe('ar') - ->and(session('website_locale'))->toBeNull(); -}); - -it('falls back to the last language from the cookie when the route locale is not allowed', function () { - Route::middleware(Localization::class . ':website') - ->get('/{locale}/cookie-fallback-probe', fn () => response('ok')) - ->name('website.cookie-fallback-probe'); - - $this->withUnencryptedCookie('website_locale', 'ar') - ->get('/fr/cookie-fallback-probe?foo=bar') - ->assertRedirect('/ar/cookie-fallback-probe?foo=bar') - ->assertStatus(301) - ->assertPlainCookie('website_locale', 'ar'); -}); - -it('falls back to the last language from the session when the route locale is not allowed', function () { - Route::middleware(Localization::class . ':website') - ->get('/{locale}/session-fallback-probe', fn () => response('ok')) - ->name('website.session-fallback-probe'); - - $this->withSession(['website_locale' => 'ar']) - ->get('/fr/session-fallback-probe') - ->assertRedirect('/ar/session-fallback-probe') - ->assertStatus(301); -}); - -it('lets a valid route locale override the stored cookie language', function () { - Route::middleware(Localization::class . ':website') - ->get('/{locale}/cookie-override-probe', fn () => response(app()->getLocale())) - ->name('website.cookie-override-probe'); - - $this->withUnencryptedCookie('website_locale', 'ar') - ->get('/en/cookie-override-probe') - ->assertOk() - ->assertSee('en') - ->assertPlainCookie('website_locale', 'en'); -}); - -it('uses the passed scope even when the route name looks like the other scope', function () { - Route::middleware(Localization::class . ':website') - ->get('/{locale}/dashboard/explicit-scope-probe', fn () => response(app()->getLocale())) - ->name('dashboard.explicit-scope-probe'); - - $this->get('/ar/dashboard/explicit-scope-probe') - ->assertOk() - ->assertSee('ar') - ->assertPlainCookie('website_locale', 'ar') - ->assertCookieMissing('dashboard_locale'); - - expect(session('website_locale'))->toBe('ar') - ->and(session('dashboard_locale'))->toBeNull(); -}); diff --git a/tests/Feature/Core/Middleware/RoutePermissionTest.php b/tests/Feature/Core/Middleware/RoutePermissionTest.php deleted file mode 100644 index 6a26cca..0000000 --- a/tests/Feature/Core/Middleware/RoutePermissionTest.php +++ /dev/null @@ -1,131 +0,0 @@ -setAttribute('id', 1); - - $this->actingAs($user, 'admins'); -}); - -it('denies named protected routes when no gate grants their permission', function () { - Route::get('/permission-test/denied', fn () => 'denied') - ->middleware(RoutePermission::class) - ->name('permission-test.denied'); - - $this->get('/permission-test/denied')->assertForbidden(); -}); - -it('does not cache permission decisions between requests', function () { - $allowed = true; - - Gate::define('permission-test.revoked', function (User $user) use (&$allowed) { - return $allowed; - }); - - Route::get('/permission-test/revoked', fn () => 'revoked') - ->middleware(RoutePermission::class) - ->name('permission-test.revoked'); - - $this->get('/permission-test/revoked')->assertOk(); - - $allowed = false; - - $this->get('/permission-test/revoked')->assertForbidden(); -}); - -it('uses one permission for create and store routes', function () { - Gate::define('permission-test.users.create', fn (User $user) => true); - - Route::get('/permission-test/users/create', fn () => 'create') - ->middleware(RoutePermission::class) - ->name('permission-test.users.create'); - Route::post('/permission-test/users', fn () => 'store') - ->middleware(RoutePermission::class) - ->name('permission-test.users.store'); - - $this->get('/permission-test/users/create')->assertOk(); - $this->post('/permission-test/users')->assertOk(); -}); - -it('uses one permission for edit and update routes', function () { - Gate::define('permission-test.users.edit', fn (User $user) => true); - - Route::get('/permission-test/users/1/edit', fn () => 'edit') - ->middleware(RoutePermission::class) - ->name('permission-test.users.edit'); - Route::patch('/permission-test/users/1', fn () => 'update') - ->middleware(RoutePermission::class) - ->name('permission-test.users.update'); - - $this->get('/permission-test/users/1/edit')->assertOk(); - $this->patch('/permission-test/users/1')->assertOk(); -}); - -it('honours an explicit permission alias', function () { - Gate::define('permission-test.users.suspend', fn (User $user) => true); - - Route::post('/permission-test/users/1/suspend', fn () => 'suspended') - ->middleware(RoutePermission::class) - ->name('permission-test.users.suspend.store') - ->usePermission('permission-test.users.suspend'); - - $this->post('/permission-test/users/1/suspend')->assertOk(); -}); - -it('authorizes against the guard of the route auth middleware', function () { - config(['auth.guards.admins-api' => ['driver' => 'session', 'provider' => 'admins']]); - - Gate::define('permission-test.api.show', fn (User $user) => $user->id === 2); - - Route::get('/permission-test/api', fn () => 'api') - ->middleware(['auth:admins-api', RoutePermission::class]) - ->name('permission-test.api.show'); - - $apiUser = new User; - $apiUser->setAttribute('id', 2); - - $this->actingAs($apiUser, 'admins-api'); - - $this->get('/permission-test/api')->assertOk(); - - // UI checks guess the same guard when none is given - Route::getRoutes()->refreshNameLookups(); - - expect(route_allowed('permission-test.api.show'))->toBeTrue(); -}); - -it('denies api-guard routes when no gate grants their permission', function () { - config(['auth.guards.admins-api' => ['driver' => 'session', 'provider' => 'admins']]); - - Route::get('/permission-test/api-denied', fn () => 'denied') - ->middleware(['auth:admins-api', RoutePermission::class]) - ->name('permission-test.api-denied'); - - $apiUser = new User; - $apiUser->setAttribute('id', 2); - - $this->actingAs($apiUser, 'admins-api'); - - $this->get('/permission-test/api-denied')->assertForbidden(); -}); - -it('preserves the existing unnamed route bypass', function () { - Route::get('/permission-test/unnamed', fn () => 'unnamed') - ->middleware(RoutePermission::class); - - $this->get('/permission-test/unnamed')->assertOk(); -}); - -it('allows permission-aware UI checks for routes that opt out of protection', function () { - Route::get('/permission-test/unprotected', fn () => 'unprotected') - ->name('permission-test.unprotected'); - - Route::getRoutes()->refreshNameLookups(); - - expect(route_allowed('permission-test.unprotected'))->toBeTrue(); -}); diff --git a/tests/Feature/Core/ServiceProviderTest.php b/tests/Feature/Core/ServiceProviderTest.php deleted file mode 100644 index 489ce1b..0000000 --- a/tests/Feature/Core/ServiceProviderTest.php +++ /dev/null @@ -1,51 +0,0 @@ -set('redot.features.dashboard.prefix', 'admin'); - - app()->register(RedotServiceProvider::class, force: true); - - expect(config('redot.features.dashboard.prefix'))->toBe('admin') - ->and(config('redot.features.dashboard.enabled'))->toBeTrue() - ->and(config('redot.locales'))->toHaveCount(2); -}); - -it('uses the package pagination view as the paginator default', function () { - expect(Paginator::$defaultView)->toBe('components.pagination'); -}); - -it('compiles the themer Blade directive into a script tag with the configured theme', function () { - $compiled = Blade::compileString('@themer(custom)'); - - expect($compiled) - ->toContain("window.themerKey = 'custom'") - ->toContain('window.themeConfig =') - ->toContain('themer.js'); -}); - -it('resolves the themer script URL when the view renders instead of when it compiles', function () { - URL::forceRootUrl('http://compiled.test'); - $compiled = Blade::compileString("@themer(custom)@stack('pre-content')"); - - URL::forceRootUrl('http://rendered.test'); - $__env = app('view'); - ob_start(); - eval('?>' . $compiled); - $html = ob_get_clean(); - - expect($html) - ->toContain('http://rendered.test/assets/js/themer.js') - ->not->toContain('compiled.test'); -}); - -it('encodes arrays through the configured JSON cast without escaping slashes', function () { - $value = Json::encode(['url' => 'https://example.test/path']); - - expect($value)->toBe('{"url":"https://example.test/path"}'); -}); diff --git a/tests/Feature/Packages/Datatables/ExportTest.php b/tests/Feature/Packages/Datatables/ExportTest.php deleted file mode 100644 index 6368f45..0000000 --- a/tests/Feature/Packages/Datatables/ExportTest.php +++ /dev/null @@ -1,111 +0,0 @@ -id(); - $table->boolean('approved')->default(false); - $table->string('title')->nullable(); - $table->timestamps(); - }); -}); - -it('exports actual values for XLSX, CSV, and JSON without encoding or stripping them', function () { - RunActionPost::query()->create(['title' => 'Tom & Jerry ']); - - $datatable = new class extends RunActionDatatable - { - public function columns(): array - { - return [Column::make('title', 'Title')]; - } - - public function exportData(): array - { - return $this->getExportData(raw: true); - } - }; - - [$headings, $rows] = $datatable->exportData(); - - expect($headings)->toBe(['Title']) - ->and($rows->first())->toBe(['Tom & Jerry ']); -}); - -it('exports email text without the mailto anchor', function () { - RunActionPost::query()->create(['title' => 'taylor@example.com']); - - $datatable = new class extends RunActionDatatable - { - public function columns(): array - { - return [TextColumn::make('title', 'Email')->email()]; - } - - public function exportData(): array - { - return $this->getExportData(raw: true); - } - }; - - [$headings, $rows] = $datatable->exportData(); - - expect($headings)->toBe(['Email']) - ->and($rows->first())->toBe(['taylor@example.com']); -}); - -it('rejects export calls when exporting is disabled', function (string $method) { - Livewire::test(RunActionDatatable::class, [ - 'exportable' => false, - 'allowedExports' => ['xlsx', 'csv', 'json', 'pdf'], - ]) - ->call($method) - ->assertForbidden(); -})->with([ - 'XLSX' => 'toXlsx', - 'CSV' => 'toCsv', - 'JSON' => 'toJson', - 'PDF' => 'toPdf', -]); - -it('rejects export formats outside the datatable allowlist', function (string $method) { - Livewire::test(RunActionDatatable::class, [ - 'exportable' => true, - 'allowedExports' => [], - ]) - ->call($method) - ->assertForbidden(); -})->with([ - 'XLSX' => 'toXlsx', - 'CSV' => 'toCsv', - 'JSON' => 'toJson', - 'PDF' => 'toPdf', -]); - -it('allows configured export formats', function () { - Livewire::test(RunActionDatatable::class, [ - 'exportable' => true, - 'allowedExports' => ['json'], - ]) - ->call('toJson') - ->assertFileDownloaded(); -}); - -it('prevents the client from mutating export settings', function (string $property, mixed $value) { - $component = Livewire::test(RunActionDatatable::class); - - expect(fn () => $component->set($property, $value)) - ->toThrow(CannotUpdateLockedPropertyException::class); -})->with([ - 'exportable flag' => ['exportable', true], - 'allowed formats' => ['allowedExports', ['xlsx', 'csv', 'json', 'pdf']], - 'pdf adapter class' => ['pdfAdapter', 'App\\Evil'], -]); diff --git a/tests/Feature/Packages/Datatables/QueryBuilderTest.php b/tests/Feature/Packages/Datatables/QueryBuilderTest.php deleted file mode 100644 index 50c7420..0000000 --- a/tests/Feature/Packages/Datatables/QueryBuilderTest.php +++ /dev/null @@ -1,202 +0,0 @@ -id(); - $table->string('name'); - }); - - Schema::create('blog_posts', function (Blueprint $table) { - $table->id(); - $table->foreignId('author_id'); - $table->string('title'); - }); - - Schema::create('blog_comments', function (Blueprint $table) { - $table->id(); - $table->foreignId('post_id'); - $table->string('body'); - }); - - $amy = BlogAuthor::query()->create(['name' => 'Amy']); - $bob = BlogAuthor::query()->create(['name' => 'Bob']); - - $laravel = BlogPost::query()->create(['author_id' => $amy->id, 'title' => 'Laravel Tips']); - $testing = BlogPost::query()->create(['author_id' => $bob->id, 'title' => 'Testing Guide']); - - BlogComment::query()->create(['post_id' => $laravel->id, 'body' => 'Great post']); - BlogComment::query()->create(['post_id' => $laravel->id, 'body' => 'Nice work']); - BlogComment::query()->create(['post_id' => $testing->id, 'body' => 'Great insights']); -}); - -it('sorts by the primary key descending when no sort is active', function () { - $datatable = new BlogCommentsDatatable; - - expect($datatable->compiledQuery()->pluck('id')->all())->toBe([3, 2, 1]); -}); - -it('searches direct and relation columns globally', function () { - $datatable = new BlogCommentsDatatable; - $datatable->search = 'Great'; - - expect($datatable->compiledQuery()->pluck('id')->all())->toBe([3, 1]); - - $datatable->search = 'Laravel'; - - expect($datatable->compiledQuery()->pluck('id')->all())->toBe([2, 1]); -}); - -it('searches for zero in direct and relation columns while allowing an empty search', function () { - BlogComment::query()->findOrFail(1)->update(['body' => '0']); - BlogPost::query()->findOrFail(2)->update(['title' => 'Version 0']); - - $datatable = new BlogCommentsDatatable; - $datatable->search = '0'; - - expect($datatable->compiledQuery()->pluck('id')->all())->toBe([3, 1]); - - $datatable->search = ''; - - expect($datatable->compiledQuery()->pluck('id')->all())->toBe([3, 2, 1]); -}); - -it('sorts by a single-level relation column', function () { - $datatable = new BlogCommentsDatatable; - $datatable->sortColumn = '-post.title'; - - expect($datatable->compiledQuery()->pluck('id')->all())->toBe([3, 1, 2]); -}); - -it('sorts by a nested relation column', function () { - $datatable = new BlogCommentsDatatable; - $datatable->sortColumn = '-post.author.name,body'; - - expect($datatable->compiledQuery()->pluck('id')->all())->toBe([3, 1, 2]); -}); - -it('applies nested and global filters', function () { - $datatable = new BlogCommentsDatatable; - [$body, $title] = $datatable->filters(); - - $datatable->filtered = [ - $body->index => ['operator' => 'contains', 'value' => 'Great'], - $title->index => 'Laravel Tips', - ]; - - expect($datatable->compiledQuery()->pluck('id')->all())->toBe([1]); -}); - -it('produces the same SQL as before the refactor for a fully loaded query', function () { - $datatable = new BlogCommentsDatatable; - [$body, $title] = $datatable->filters(); - - $datatable->search = 'Great'; - $datatable->sortColumn = '-post.author.name,body'; - $datatable->filtered = [ - $body->index => ['operator' => 'contains', 'value' => 'Great'], - $title->index => 'Laravel Tips', - ]; - - $query = $datatable->compiledQuery(); - - expect($query->toSql())->toBe( - 'select "blog_comments".*, (select (select "blog_authors"."name" from "blog_authors" where "blog_posts"."author_id" = "blog_authors"."id" limit 1) as "nested_relation_value" from "blog_posts" where "blog_comments"."post_id" = "blog_posts"."id" limit 1) as "post_author_name" from "blog_comments" where (exists (select * from "blog_posts" where "blog_comments"."post_id" = "blog_posts"."id" and "title" = ?)) and (("body" like ?)) and ("body" like ? or exists (select * from "blog_posts" where "blog_comments"."post_id" = "blog_posts"."id" and "title" like ?)) order by "post_author_name" desc, "body" asc' - )->and($query->getBindings())->toBe(['Laravel Tips', '%Great%', '%Great%', '%Great%']); -}); - -it('ignores client-supplied sorts for unknown or non-sortable columns', function () { - $datatable = new BlogCommentsDatatable; - - $datatable->sortColumn = 'password'; - expect($datatable->compiledQuery()->pluck('id')->all())->toBe([3, 2, 1]); - - // The id column exists but is not sortable. - $datatable->sortColumn = 'id'; - expect($datatable->compiledQuery()->pluck('id')->all())->toBe([3, 2, 1]); -}); - -it('cycles sorts through the livewire sort endpoint', function () { - Livewire\Livewire::test(BlogCommentsDatatable::class) - ->call('sort', 'body')->assertSet('sortColumn', 'body') - ->call('sort', 'body')->assertSet('sortColumn', '-body') - ->call('sort', 'body')->assertSet('sortColumn', '') - ->call('sort', 'body')->assertSet('sortColumn', 'body') - ->call('sort', 'post.title', true)->assertSet('sortColumn', 'body,post.title') - ->call('sort', 'post.title', true)->assertSet('sortColumn', 'body,-post.title') - ->call('sort', 'post.title', true)->assertSet('sortColumn', 'body') - ->call('sort')->assertSet('sortColumn', ''); -}); - -describe('pagination updates', function () { - beforeEach(function () { - for ($i = 0; $i < 22; $i++) { - BlogComment::query()->create(['post_id' => 1, 'body' => 'Extra comment']); - } - }); - - it('returns to the first page when search changes or clears', function (string $search, array $expectedIds) { - Livewire\Livewire::test(BlogCommentsDatatable::class) - ->set('search', 'Extra') - ->call('gotoPage', 2) - ->assertSet('paginators.page', 2) - ->assertViewHas('rows', fn ($rows) => $rows->currentPage() === 2 && $rows->count() === 10) - ->set('search', $search) - ->assertSet('paginators.page', 1) - ->assertViewHas('rows', fn ($rows) => $rows->pluck('id')->all() === $expectedIds); - })->with([ - 'narrow search' => ['Nice work', [2]], - 'clear search' => ['', range(25, 16)], - ]); - - it('returns to the first page when the filter array changes', function () { - [$body] = (new BlogCommentsDatatable)->filters(); - - Livewire\Livewire::test(BlogCommentsDatatable::class) - ->call('gotoPage', 2) - ->set('filtered', [$body->index => ['operator' => 'equals', 'value' => 'Nice work']]) - ->assertSet('paginators.page', 1) - ->assertViewHas('rows', fn ($rows) => $rows->pluck('id')->all() === [2]); - }); - - it('returns to the first page when a nested filter value or operator changes', function (string $property, string $value, array $expectedIds) { - [$body] = (new BlogCommentsDatatable)->filters(); - - Livewire\Livewire::test(BlogCommentsDatatable::class) - ->set('filtered', [$body->index => ['operator' => 'contains', 'value' => 'Extra']]) - ->call('gotoPage', 2) - ->assertSet('paginators.page', 2) - ->set("filtered.{$body->index}.$property", $value) - ->assertSet('paginators.page', 1) - ->assertViewHas('rows', fn ($rows) => $rows->pluck('id')->all() === $expectedIds); - })->with([ - 'value' => ['value', 'Nice', [2]], - 'operator' => ['operator', 'not_contains', [3, 2, 1]], - ]); - - it('returns to the first page when all filters are cleared', function () { - [$body] = (new BlogCommentsDatatable)->filters(); - - Livewire\Livewire::test(BlogCommentsDatatable::class) - ->set('filtered', [$body->index => ['operator' => 'contains', 'value' => 'Extra']]) - ->call('gotoPage', 2) - ->set('filtered', []) - ->assertSet('paginators.page', 1) - ->assertViewHas('rows', fn ($rows) => $rows->pluck('id')->all() === range(25, 16)); - }); - - it('returns to the first page when the page size changes', function () { - Livewire\Livewire::test(BlogCommentsDatatable::class) - ->call('gotoPage', 3) - ->assertViewHas('rows', fn ($rows) => $rows->currentPage() === 3 && $rows->count() === 5) - ->set('perPage', 25) - ->assertSet('paginators.page', 1) - ->assertViewHas('rows', fn ($rows) => $rows->currentPage() === 1 && $rows->count() === 25); - }); -}); diff --git a/tests/Feature/Packages/Datatables/RunActionTest.php b/tests/Feature/Packages/Datatables/RunActionTest.php deleted file mode 100644 index a1c33ac..0000000 --- a/tests/Feature/Packages/Datatables/RunActionTest.php +++ /dev/null @@ -1,86 +0,0 @@ -id(); - $table->boolean('approved')->default(false); - $table->timestamps(); - }); -}); - -it('runs an inline action against a row and refreshes the datatable data', function () { - $post = RunActionPost::query()->create(['approved' => false]); - - Livewire::test(RunActionDatatable::class) - ->call('runAction', 'approve', $post->getKey()) - ->assertSet('search', ''); - - expect($post->fresh()->approved)->toBeTrue(); -}); - -it('runs inline actions nested inside action groups', function () { - $post = RunActionPost::query()->create(['approved' => true]); - - Livewire::test(RunActionDatatable::class) - ->call('runAction', 'archive', $post->getKey()); - - expect($post->fresh()->approved)->toBeFalse(); -}); - -it('rejects grouped inline actions when the action group is not available for the row', function () { - $post = RunActionPost::query()->create(['approved' => false]); - - Livewire::test(RunActionDatatable::class) - ->call('runAction', 'archive', $post->getKey()); -})->throws(InvalidActionException::class, 'Action [archive] not found.'); - -it('throws when the inline action name is unknown', function () { - $post = RunActionPost::query()->create(['approved' => false]); - - Livewire::test(RunActionDatatable::class) - ->call('runAction', 'missing', $post->getKey()); -})->throws(InvalidActionException::class, 'Action [missing] not found.'); - -it('throws when the row is missing for a model without soft deletes', function () { - Livewire::test(RunActionDatatable::class) - ->call('runAction', 'approve', 999); -})->throws(InvalidActionException::class, 'Row [999] not found.'); - -it('throws when the inline action is not available for the row', function () { - $post = RunActionPost::query()->create(['approved' => true]); - - Livewire::test(RunActionDatatable::class) - ->call('runAction', 'approve', $post->getKey()); -})->throws(InvalidActionException::class, 'Action [approve] is not available for this row.'); - -it('fires the success callback after a successful inline action', function () { - $post = RunActionPost::query()->create(['approved' => false]); - - Livewire::test(RunActionDatatable::class) - ->call('runAction', 'succeed', $post->getKey()) - ->assertSet('successCallbackFired', true) - ->assertSet('successResult', 'done'); -}); - -it('fires the failure callback when an inline action throws and suppresses the exception', function () { - $post = RunActionPost::query()->create(['approved' => false]); - - Livewire::test(RunActionDatatable::class) - ->call('runAction', 'fail', $post->getKey()) - ->assertSet('failureCallbackFired', true) - ->assertSet('failureExceptionMessage', 'Action failed'); -}); - -it('rethrows inline action exceptions when no failure callback is registered', function () { - $post = RunActionPost::query()->create(['approved' => false]); - - Livewire::test(RunActionDatatable::class) - ->call('runAction', 'explode', $post->getKey()); -})->throws(RuntimeException::class, 'Unhandled failure'); diff --git a/tests/Feature/Packages/Datatables/RunBulkActionTest.php b/tests/Feature/Packages/Datatables/RunBulkActionTest.php deleted file mode 100644 index 1e66aee..0000000 --- a/tests/Feature/Packages/Datatables/RunBulkActionTest.php +++ /dev/null @@ -1,108 +0,0 @@ -id(); - $table->boolean('approved')->default(false); - $table->string('title')->nullable(); - $table->timestamps(); - }); -}); - -it('runs a bulk action against the selected rows and clears the selection', function () { - $first = RunActionPost::query()->create(['approved' => false]); - $second = RunActionPost::query()->create(['approved' => false]); - - Livewire::test(BulkActionDatatable::class) - ->call('runBulkAction', 'approve', [$first->getKey(), $second->getKey()]) - ->assertSet('selectionCleared', true); - - expect($first->fresh()->approved)->toBeTrue() - ->and($second->fresh()->approved)->toBeTrue(); -}); - -it('throws when the bulk action name is unknown', function () { - $post = RunActionPost::query()->create(['approved' => false]); - - Livewire::test(BulkActionDatatable::class) - ->call('runBulkAction', 'missing', [$post->getKey()]); -})->throws(InvalidActionException::class, 'Bulk action [missing] not found.'); - -it('throws when the selection is empty or matches no rows', function (array $keys) { - RunActionPost::query()->create(['approved' => false]); - - Livewire::test(BulkActionDatatable::class) - ->call('runBulkAction', 'approve', $keys); -})->with([ - 'no keys' => [[]], - 'unknown keys' => [[999]], -])->throws(InvalidActionException::class, 'Bulk action [approve] is not available for the selected rows.'); - -it('drops non-scalar keys from the selection', function () { - $post = RunActionPost::query()->create(['approved' => false]); - - Livewire::test(BulkActionDatatable::class) - ->call('runBulkAction', 'approve', [['nested' => 'array'], $post->getKey()]); - - expect($post->fresh()->approved)->toBeTrue(); -}); - -it('deduplicates keys before the records reach the action', function () { - $post = RunActionPost::query()->create(['approved' => false]); - - // The "limited" action only renders for fewer than two records, so a - // duplicated key must collapse to a single record for it to run. - Livewire::test(BulkActionDatatable::class) - ->call('runBulkAction', 'limited', [$post->getKey(), $post->getKey(), (string) $post->getKey()]); - - expect(RunActionPost::query()->whereKey($post->getKey())->exists())->toBeFalse(); -}); - -it('rejects hidden bulk actions', function () { - $post = RunActionPost::query()->create(['approved' => false]); - - Livewire::test(BulkActionDatatable::class) - ->call('runBulkAction', 'hidden', [$post->getKey()]); -})->throws(InvalidActionException::class, 'Bulk action [hidden] is not available for the selected rows.'); - -it('rejects bulk actions whose condition fails for the selection', function () { - $first = RunActionPost::query()->create(['approved' => false]); - $second = RunActionPost::query()->create(['approved' => false]); - - Livewire::test(BulkActionDatatable::class) - ->call('runBulkAction', 'limited', [$first->getKey(), $second->getKey()]); -})->throws(InvalidActionException::class, 'Bulk action [limited] is not available for the selected rows.'); - -it('fires the success callback after a successful bulk action', function () { - $post = RunActionPost::query()->create(['approved' => false]); - - Livewire::test(BulkActionDatatable::class) - ->call('runBulkAction', 'succeed', [$post->getKey()]) - ->assertSet('successCallbackFired', true) - ->assertSet('successResult', 1) - ->assertSet('selectionCleared', true); -}); - -it('fires the failure callback without clearing the selection when a bulk action throws', function () { - $post = RunActionPost::query()->create(['approved' => false]); - - Livewire::test(BulkActionDatatable::class) - ->call('runBulkAction', 'fail', [$post->getKey()]) - ->assertSet('failureCallbackFired', true) - ->assertSet('failureExceptionMessage', 'Bulk action failed') - ->assertSet('selectionCleared', false); -}); - -it('rethrows bulk action exceptions when no failure callback is registered', function () { - $post = RunActionPost::query()->create(['approved' => false]); - - Livewire::test(BulkActionDatatable::class) - ->call('runBulkAction', 'explode', [$post->getKey()]); -})->throws(RuntimeException::class, 'Unhandled bulk failure'); diff --git a/tests/Feature/Packages/Datatables/VisibleActionsTest.php b/tests/Feature/Packages/Datatables/VisibleActionsTest.php deleted file mode 100644 index 1998d06..0000000 --- a/tests/Feature/Packages/Datatables/VisibleActionsTest.php +++ /dev/null @@ -1,86 +0,0 @@ -actions([ - Action::make('Approve'), - Action::make('Hidden')->hidden(), - ]); - - $datatable = new class($group) extends RunActionDatatable - { - public function __construct(protected ActionGroup $group) - { - parent::__construct(); - } - - public function actions(): array - { - return [$this->group]; - } - - public function visibleActions(): array - { - return $this->getVisibleActions(); - } - }; - - [$visible] = $datatable->visibleActions(); - - expect($visible->actions)->toHaveCount(1) - ->and($visible)->not->toBe($group) - ->and($group->actions)->toHaveCount(2); -}); - -it('drops groups whose actions are all hidden', function () { - $group = ActionGroup::make('More')->actions([Action::make('Hidden')->hidden()]); - - $datatable = new class($group) extends RunActionDatatable - { - public function __construct(protected ActionGroup $group) - { - parent::__construct(); - } - - public function actions(): array - { - return [$this->group]; - } - - public function visibleActions(): array - { - return $this->getVisibleActions(); - } - }; - - expect($datatable->visibleActions())->toBe([]); -}); - -it('keeps bulk actions grouped by default without mutating them', function () { - $action = BulkAction::make('Delete'); - - $datatable = new class($action) extends RunActionDatatable - { - public function __construct(protected BulkAction $action) - { - parent::__construct(); - } - - public function bulkActions(): array - { - return [$this->action]; - } - - public function visibleBulkActions(): array - { - return $this->getVisibleBulkActions(); - } - }; - - expect($datatable->visibleBulkActions())->toBe([$action]) - ->and($action->grouped)->toBeTrue(); -}); diff --git a/tests/Fixtures/Application/routes/api/dashboard.php b/tests/Fixtures/Application/routes/api/dashboard.php deleted file mode 100644 index d0dc72a..0000000 --- a/tests/Fixtures/Application/routes/api/dashboard.php +++ /dev/null @@ -1,5 +0,0 @@ - 'dashboard api')->name('index'); diff --git a/tests/Fixtures/Application/routes/api/website.php b/tests/Fixtures/Application/routes/api/website.php deleted file mode 100644 index 5b62311..0000000 --- a/tests/Fixtures/Application/routes/api/website.php +++ /dev/null @@ -1,5 +0,0 @@ - 'website api')->name('index'); diff --git a/tests/Fixtures/Application/routes/dashboard.php b/tests/Fixtures/Application/routes/dashboard.php deleted file mode 100644 index a9d0cf0..0000000 --- a/tests/Fixtures/Application/routes/dashboard.php +++ /dev/null @@ -1,5 +0,0 @@ - 'dashboard')->name('index'); diff --git a/tests/Fixtures/Application/routes/global.php b/tests/Fixtures/Application/routes/global.php deleted file mode 100644 index 07aff06..0000000 --- a/tests/Fixtures/Application/routes/global.php +++ /dev/null @@ -1,5 +0,0 @@ - 'global')->name('index'); diff --git a/tests/Fixtures/Application/routes/website.php b/tests/Fixtures/Application/routes/website.php deleted file mode 100644 index 39094eb..0000000 --- a/tests/Fixtures/Application/routes/website.php +++ /dev/null @@ -1,5 +0,0 @@ - 'website')->name('index'); diff --git a/tests/Fixtures/Auth/ApiUser.php b/tests/Fixtures/Auth/ApiUser.php deleted file mode 100644 index 29d70f4..0000000 --- a/tests/Fixtures/Auth/ApiUser.php +++ /dev/null @@ -1,18 +0,0 @@ - 'hashed']; -} diff --git a/tests/Fixtures/Auth/NotifiableUser.php b/tests/Fixtures/Auth/NotifiableUser.php deleted file mode 100644 index af41b01..0000000 --- a/tests/Fixtures/Auth/NotifiableUser.php +++ /dev/null @@ -1,16 +0,0 @@ -hasMany(BlogPost::class, 'author_id'); - } -} diff --git a/tests/Fixtures/Datatables/BlogComment.php b/tests/Fixtures/Datatables/BlogComment.php deleted file mode 100644 index b03b3a4..0000000 --- a/tests/Fixtures/Datatables/BlogComment.php +++ /dev/null @@ -1,20 +0,0 @@ -belongsTo(BlogPost::class, 'post_id'); - } -} diff --git a/tests/Fixtures/Datatables/BlogCommentsDatatable.php b/tests/Fixtures/Datatables/BlogCommentsDatatable.php deleted file mode 100644 index 17925cb..0000000 --- a/tests/Fixtures/Datatables/BlogCommentsDatatable.php +++ /dev/null @@ -1,40 +0,0 @@ -searchable()->sortable(), - Column::make('post.title')->searchable()->sortable(), - Column::make('post.author.name')->sortable(), - ]; - } - - public function filters(): array - { - return [ - StringFilter::make('body'), - SelectFilter::make('post.title')->global(), - ]; - } - - /** - * Expose the built query for SQL snapshot assertions. - */ - public function compiledQuery(): Builder - { - return $this->buildQuery(); - } -} diff --git a/tests/Fixtures/Datatables/BlogPost.php b/tests/Fixtures/Datatables/BlogPost.php deleted file mode 100644 index cc9e464..0000000 --- a/tests/Fixtures/Datatables/BlogPost.php +++ /dev/null @@ -1,26 +0,0 @@ -belongsTo(BlogAuthor::class, 'author_id'); - } - - public function comments(): HasMany - { - return $this->hasMany(BlogComment::class, 'post_id'); - } -} diff --git a/tests/Fixtures/Datatables/BulkActionDatatable.php b/tests/Fixtures/Datatables/BulkActionDatatable.php deleted file mode 100644 index ee8725d..0000000 --- a/tests/Fixtures/Datatables/BulkActionDatatable.php +++ /dev/null @@ -1,67 +0,0 @@ -selectionCleared = true; - - parent::clearSelection(); - } - - public function columns(): array - { - return [ - Column::make('id'), - Column::make('approved'), - ]; - } - - public function bulkActions(): array - { - return [ - BulkAction::make('Approve', 'ti ti-check') - ->action('approve', fn (Collection $records) => $records->each->update(['approved' => true])), - BulkAction::make('Limited', 'ti ti-lock') - ->action('limited', fn (Collection $records) => $records->each->delete()) - ->condition(fn (Collection $records) => $records->count() < 2), - BulkAction::make('Hidden', 'ti ti-eye-off') - ->action('hidden', fn (Collection $records) => $records->each->delete()) - ->hidden(), - BulkAction::make('Fail', 'ti ti-x') - ->action('fail', fn () => throw new RuntimeException('Bulk action failed')) - ->failure(function ($records, $exception, BulkActionDatatable $datatable) { - $datatable->failureCallbackFired = true; - $datatable->failureExceptionMessage = $exception->getMessage(); - }), - BulkAction::make('Succeed', 'ti ti-checks') - ->action('succeed', fn (Collection $records) => $records->count()) - ->success(function ($records, $result, BulkActionDatatable $datatable) { - $datatable->successCallbackFired = true; - $datatable->successResult = $result; - }), - BulkAction::make('Explode', 'ti ti-bomb') - ->action('explode', fn () => throw new RuntimeException('Unhandled bulk failure')), - ]; - } -} diff --git a/tests/Fixtures/Datatables/RunActionDatatable.php b/tests/Fixtures/Datatables/RunActionDatatable.php deleted file mode 100644 index 529f28c..0000000 --- a/tests/Fixtures/Datatables/RunActionDatatable.php +++ /dev/null @@ -1,60 +0,0 @@ -action('approve', fn (RunActionPost $row) => $row->update(['approved' => true])) - ->condition(fn (RunActionPost $row) => ! $row->approved), - Action::make('Fail', 'ti ti-x') - ->action('fail', fn () => throw new RuntimeException('Action failed')) - ->success(fn () => null) - ->failure(function ($row, $exception, RunActionDatatable $datatable) { - $datatable->failureCallbackFired = true; - $datatable->failureExceptionMessage = $exception->getMessage(); - }), - Action::make('Succeed', 'ti ti-checks') - ->action('succeed', fn (RunActionPost $row) => 'done') - ->success(function ($row, $result, RunActionDatatable $datatable) { - $datatable->successCallbackFired = true; - $datatable->successResult = $result; - }), - Action::make('Explode', 'ti ti-bomb') - ->action('explode', fn () => throw new RuntimeException('Unhandled failure')), - ActionGroup::make('More', 'ti ti-dots-vertical') - ->condition(fn (RunActionPost $row) => $row->approved) - ->actions([ - Action::make('Archive', 'ti ti-archive') - ->action('archive', fn (RunActionPost $row) => $row->update(['approved' => false])), - ]), - ]; - } -} diff --git a/tests/Fixtures/Datatables/RunActionPost.php b/tests/Fixtures/Datatables/RunActionPost.php deleted file mode 100644 index c0f5efa..0000000 --- a/tests/Fixtures/Datatables/RunActionPost.php +++ /dev/null @@ -1,16 +0,0 @@ - 'boolean', - ]; -} diff --git a/tests/Fixtures/EmptyModel.php b/tests/Fixtures/EmptyModel.php deleted file mode 100644 index 3d4c6b1..0000000 --- a/tests/Fixtures/EmptyModel.php +++ /dev/null @@ -1,11 +0,0 @@ -app['config']->get('view.compiled')); - File::ensureDirectoryExists(dist_path()); + // Parallel workers create the same directories at once, so tolerate one that already exists. + File::makeDirectory($this->app['config']->get('view.compiled'), 0755, true, true); + File::makeDirectory(dist_path(), 0755, true, true); + } + + /** + * Resolve the application with a public directory private to the current test process. + * + * Tests build, publish, and upload into the public directory, and the package + * registers its publish paths before the environment is defined. + */ + protected function resolveApplication() + { + return tap(parent::resolveApplication(), fn ($app) => $app->usePublicPath(static::processPath('public'))); + } + + /** + * Get a scratch directory private to the current test process. + */ + protected static function processPath(string $path): string + { + $token = $_SERVER['TEST_TOKEN'] ?? getenv('TEST_TOKEN') ?: 'serial'; + + return sys_get_temp_dir() . "/redot-core-tests/{$token}/{$path}"; } /** @@ -57,13 +79,21 @@ protected function defineEnvironment($app): void $app['config']->set('permission.testing', true); $app['config']->set('queue.default', 'sync'); $app['config']->set('session.driver', 'array'); - $app['config']->set('view.compiled', sys_get_temp_dir() . '/redot-core-tests/views'); + $app['config']->set('view.compiled', static::processPath('views')); $app['config']->set('auth.guards.admins', ['driver' => 'session', 'provider' => 'admins']); $app['config']->set('auth.providers.admins', ['driver' => 'eloquent', 'model' => User::class]); $app['config']->set('auth.passwords.admins', ['provider' => 'admins']); } + /** + * Register the package endpoints the way Redot\Application does. + */ + protected function defineRoutes($router): void + { + $router->as('global.')->middleware('web')->group(dirname(__DIR__) . '/src/Foundation/routes/global.php'); + } + /** * Load the database migrations for the testbench application. */ diff --git a/tests/Unit/Core/Casts/UnionTest.php b/tests/Unit/Core/Casts/UnionTest.php deleted file mode 100644 index 5e7fb85..0000000 --- a/tests/Unit/Core/Casts/UnionTest.php +++ /dev/null @@ -1,34 +0,0 @@ -get(new EmptyModel, 'value', $stored, []))->toBe($expected); -})->with([ - ['true', true], - ['false', false], - ['15', 15], - ['-15', -15], - ['0', 0], - ['3.14', 3.14], - ['0.5', 0.5], - ['01001234567', '01001234567'], - ['999999999999999999999999', '999999999999999999999999'], - ['{"primary":"blue"}', ['primary' => 'blue']], - ['["en","ar"]', ['en', 'ar']], - ['plain text', 'plain text'], -]); - -it('prepares booleans and arrays for storage', function (mixed $value, mixed $expected) { - $cast = new Union; - - expect($cast->set(new EmptyModel, 'value', $value, []))->toBe($expected); -})->with([ - [true, 'true'], - [false, 'false'], - [['primary' => 'blue'], '{"primary":"blue"}'], - ['plain text', 'plain text'], -]); diff --git a/tests/Unit/Core/HelpersTest.php b/tests/Unit/Core/HelpersTest.php deleted file mode 100644 index deda42f..0000000 --- a/tests/Unit/Core/HelpersTest.php +++ /dev/null @@ -1,237 +0,0 @@ -toBe(['alpha', 'beta', 'gamma']) - ->and(parse_csv([' one ', '', ' two ']))->toBe(['one', 'two']); -}); - -it('honours a custom separator and callback when parsing csv input', function () { - $parsed = parse_csv(' a |B|c ', '|', fn (string $value): string => strtoupper(trim($value))); - - expect($parsed)->toBe(['A', 'B', 'C']); -}); - -it('limits collections and appends a localized remaining-count notice', function () { - expect(collect_ellipsis(['a', 'b', 'c', 'd'], 2, ':count more')->all()) - ->toBe(['a', 'b', '2 more']); -}); - -it('returns the input unchanged when the collection is at or under the limit', function () { - expect(collect_ellipsis(['a', 'b'], 2)->all())->toBe(['a', 'b']) - ->and(collect_ellipsis(['a'], 2)->all())->toBe(['a']); -}); - -it('creates proportionally scaled image thumbnails', function () { - $directory = public_path('helper-image-test'); - $source = $directory . '/source.png'; - File::ensureDirectoryExists($directory); - - $image = imagecreatetruecolor(200, 100); - imagepng($image, $source); - unset($image); - - $thumbnail = create_thumbnail($source, 100, 100, 90); - $thumbnailPath = public_path($thumbnail); - - expect($thumbnail)->toBe('/helper-image-test/thumbnails/source-thumb-100x100-q90.png') - ->and(File::exists($thumbnailPath))->toBeTrue() - ->and(getimagesize($thumbnailPath))->toMatchArray([100, 50]); -}); - -it('caches separate thumbnails for different rendering options', function (int $width, int $height, int $quality, array $dimensions) { - $directory = public_path('helper-image-test'); - $source = $directory . '/source.png'; - File::ensureDirectoryExists($directory); - - $image = imagecreatetruecolor(200, 100); - imagepng($image, $source); - unset($image); - - $original = create_thumbnail($source, 100, 100, 90); - $variant = create_thumbnail($source, $width, $height, $quality); - - expect($variant)->not->toBe($original) - ->and(File::exists(public_path($original)))->toBeTrue() - ->and(File::exists(public_path($variant)))->toBeTrue() - ->and(getimagesize(public_path($original)))->toMatchArray([100, 50]) - ->and(getimagesize(public_path($variant)))->toMatchArray($dimensions); -})->with([ - 'width' => [150, 100, 90, [150, 75]], - 'height' => [100, 25, 90, [50, 25]], - 'quality' => [100, 100, 80, [100, 50]], -]); - -it('reuses a current thumbnail for identical rendering options', function () { - $directory = public_path('helper-image-test'); - $source = $directory . '/source.png'; - File::ensureDirectoryExists($directory); - - $image = imagecreatetruecolor(200, 100); - imagepng($image, $source); - unset($image); - - $thumbnail = create_thumbnail($source, 100, 100, 90); - - Image::shouldReceive('fromPath')->never(); - - expect(create_thumbnail($source, 100, 100, 90))->toBe($thumbnail); -}); - -it('regenerates a thumbnail when its source image changes', function () { - $directory = public_path('helper-image-test'); - $source = $directory . '/source.png'; - File::ensureDirectoryExists($directory); - - $image = imagecreatetruecolor(200, 100); - imagepng($image, $source); - unset($image); - - $thumbnail = create_thumbnail($source, 100, 100, 90); - - $image = imagecreatetruecolor(200, 200); - imagepng($image, $source); - unset($image); - touch($source, filemtime(public_path($thumbnail)) + 1); - clearstatcache(); - - expect(create_thumbnail($source, 100, 100, 90))->toBe($thumbnail) - ->and(getimagesize(public_path($thumbnail)))->toMatchArray([100, 100]); -}); - -it('returns an authenticated json error payload for authentication exceptions', function () { - config()->set('app.debug', false); - - $response = throw_api_exception(new AuthenticationException); - - expect($response->getStatusCode())->toBe(401) - ->and($response->getData(true))->toMatchArray([ - 'code' => 401, - 'success' => false, - 'message' => 'Unauthenticated.', - 'payload' => [], - ]); -}); - -it('exposes validator errors when converting a validation exception to an api payload', function () { - $exception = ValidationException::withMessages([ - 'email' => ['The email field is required.'], - ]); - - $response = throw_api_exception($exception); - - expect($response->getStatusCode())->toBe(422) - ->and($response->getData(true)['payload'])->toBe([ - 'email' => ['The email field is required.'], - ]); -}); - -it('hides the raw exception message for 5xx responses when debug mode is off', function () { - config()->set('app.debug', false); - - $response = throw_api_exception(new RuntimeException('internal database failure')); - - expect($response->getStatusCode())->toBe(500) - ->and($response->getData(true))->toMatchArray([ - 'code' => 500, - 'success' => false, - 'message' => 'Internal Server Error', - 'payload' => [], - ]); -}); - -it('forwards http exception status codes to the api payload', function () { - $response = throw_api_exception(new HttpException(418, "I'm a teapot")); - - expect($response->getStatusCode())->toBe(418) - ->and($response->getData(true)['message'])->toBe("I'm a teapot"); -}); - -it('returns the locale-aware application name from the setting, falling back to app.name', function () { - Setting::set('app_name', ['en' => 'My Site', 'ar' => 'موقعي']); - - app()->setLocale('ar'); - expect(app_name())->toBe('موقعي'); - - app()->setLocale('en'); - expect(app_name())->toBe('My Site'); - - Setting::set('app_name', ['en' => '']); - app()->setLocale('en'); - config()->set('app.name', 'Configured Fallback'); - - expect(app_name())->toBe('Configured Fallback'); -}); - -it('resolves a route name from a url that matches a registered route', function () { - Route::name('posts.show')->get('/posts/{post}', fn () => 'show'); - - expect(route_from_url(url('/posts/42')))->toBe('posts.show'); -}); - -it('returns null when the url does not match any registered route', function () { - expect(route_from_url('http://localhost/no-such-route'))->toBeNull(); -}); - -it('only applies route authorization to urls on the application host', function () { - Route::get('/protected', fn () => 'protected') - ->middleware(RoutePermission::class) - ->name('protected'); - Route::getRoutes()->refreshNameLookups(); - - expect(url_allowed('https://evil.example/protected?return=http://localhost'))->toBeTrue() - ->and(url_allowed('http://localhost/protected'))->toBeFalse() - ->and(url_allowed('/protected'))->toBeFalse(); -}); - -it('goes back to previous urls that belong to the application', function (string $appUrl, string $previous) { - Route::get('/fallback', fn () => 'fallback')->name('fallback'); - Route::getRoutes()->refreshNameLookups(); - - config()->set('app.url', $appUrl); - URL::useOrigin($appUrl); - - request()->headers->set('referer', $previous); - - expect(back_or_route('fallback'))->toBe($previous); -})->with([ - 'same origin' => ['https://app.com', 'https://app.com/users'], - 'mixed case with default port' => ['https://app.com', 'HTTPS://APP.com:443/users'], - 'inside the base path' => ['https://app.com/admin', 'https://app.com/admin/users'], - 'the base path itself' => ['https://app.com/admin', 'https://app.com/admin'], - 'base path with trailing slash' => ['https://app.com/admin/', 'https://app.com/admin/users'], -]); - -it('falls back to the route for previous urls outside the application', function (string $appUrl, string $previous) { - Route::get('/fallback', fn () => 'fallback')->name('fallback'); - Route::getRoutes()->refreshNameLookups(); - - config()->set('app.url', $appUrl); - URL::useOrigin($appUrl); - - request()->headers->set('referer', $previous); - - expect(back_or_route('fallback'))->toBe(route('fallback')); -})->with([ - 'look-alike host' => ['https://app.com', 'https://app.com.evil.com/users'], - 'different scheme' => ['https://app.com', 'http://app.com/users'], - 'different port' => ['https://app.com', 'https://app.com:8443/users'], - 'scheme-relative url' => ['https://app.com', '//app.com/users'], - 'javascript url' => ['https://app.com', 'javascript:alert(1)'], - 'malformed url' => ['https://app.com', 'http://[bad'], - 'path sharing the base prefix' => ['https://app.com/admin', 'https://app.com/administrator'], - 'path outside the base path' => ['https://app.com/admin', 'https://app.com/other'], -]); diff --git a/tests/Unit/Core/Jobs/PublishLanguageTokensTest.php b/tests/Unit/Core/Jobs/PublishLanguageTokensTest.php deleted file mode 100644 index 344b16a..0000000 --- a/tests/Unit/Core/Jobs/PublishLanguageTokensTest.php +++ /dev/null @@ -1,51 +0,0 @@ - 'Arabic original', -]; -PHP); - - app()->useLangPath($langPath); - app()->setLocale('en'); - app('translator')->addLines(['messages.greeting+' => 'English original'], 'en'); - app('translator')->addLines(['messages.greeting+' => 'Arabic original'], 'ar'); - - $language = Language::create(['code' => 'AR', 'name' => 'Arabic', 'is_rtl' => true]); - $token = $language->tokens()->create([ - 'key' => 'messages.greeting+', - 'value' => 'A "double", single \' and \\ slash', - 'original_translation' => 'Arabic original', - 'from_json' => false, - 'is_published' => false, - ]); - $missingToken = $language->tokens()->create([ - 'key' => 'messages.missing', - 'value' => 'Still missing', - 'original_translation' => 'Missing original', - 'from_json' => false, - 'is_published' => false, - ]); - - try { - (new PublishLanguageTokens($language))->handle(); - - $translations = require $langPath . '/ar/messages.php'; - - expect($translations['greeting+'])->toBe('A "double", single \' and \\ slash') - ->and($language->refresh()->code)->toBe('AR') - ->and($token->refresh()->is_published)->toBeTrue() - ->and($missingToken->refresh()->is_published)->toBeFalse(); - } finally { - File::deleteDirectory($langPath); - } -}); diff --git a/tests/Unit/Core/Models/LanguageTest.php b/tests/Unit/Core/Models/LanguageTest.php deleted file mode 100644 index 218af64..0000000 --- a/tests/Unit/Core/Models/LanguageTest.php +++ /dev/null @@ -1,24 +0,0 @@ - false])->direction)->toBe('ltr') - ->and(Language::make(['is_rtl' => true])->direction)->toBe('rtl'); -}); - -it('resolves the current language from the active application locale', function () { - Language::create(['code' => 'en', 'name' => 'English', 'is_rtl' => false]); - Language::create(['code' => 'ar', 'name' => 'Arabic', 'is_rtl' => true]); - - app()->setLocale('ar'); - - expect(Language::current()) - ->toBeInstanceOf(Language::class) - ->code->toBe('ar') - ->direction->toBe('rtl'); -}); - -it('uses the language code as the route key for implicit route-model binding', function () { - expect((new Language)->getRouteKeyName())->toBe('code'); -}); diff --git a/tests/Unit/Core/Models/LanguageTokenTest.php b/tests/Unit/Core/Models/LanguageTokenTest.php deleted file mode 100644 index fd1167d..0000000 --- a/tests/Unit/Core/Models/LanguageTokenTest.php +++ /dev/null @@ -1,66 +0,0 @@ - 'en', 'name' => 'English', 'is_rtl' => false]); - - $token = LanguageToken::create([ - 'language_id' => $language->id, - 'key' => 'Hello', - 'value' => 'Hello', - 'original_translation' => 'Hello', - 'from_json' => 1, - 'is_published' => 1, - ]); - - expect($token->from_json)->toBeTrue() - ->and($token->is_published)->toBeTrue() - ->and($token->language->is($language))->toBeTrue(); -}); - -it('marks published tokens as unpublished when their value changes', function () { - $language = Language::create(['code' => 'en', 'name' => 'English', 'is_rtl' => false]); - $token = LanguageToken::create([ - 'language_id' => $language->id, - 'key' => 'Hello', - 'value' => 'Hello', - 'original_translation' => 'Hello', - 'from_json' => true, - 'is_published' => true, - ]); - - $token->update(['value' => 'Hi']); - - expect($token->refresh()->is_published)->toBeFalse(); -}); - -it('scopes language tokens by state', function () { - $language = Language::create(['code' => 'en', 'name' => 'English', 'is_rtl' => false]); - - LanguageToken::create([ - 'language_id' => $language->id, - 'key' => 'Published', - 'value' => 'Published', - 'original_translation' => 'Published', - 'from_json' => true, - 'is_published' => true, - ]); - - LanguageToken::create([ - 'language_id' => $language->id, - 'key' => 'Modified', - 'value' => 'Changed', - 'original_translation' => 'Original', - 'from_json' => false, - 'is_published' => false, - ]); - - expect(LanguageToken::published()->count())->toBe(1) - ->and(LanguageToken::unpublished()->count())->toBe(1) - ->and(LanguageToken::modified()->count())->toBe(1) - ->and(LanguageToken::notModified()->count())->toBe(1) - ->and(LanguageToken::query()->fromJson()->count())->toBe(1) - ->and(LanguageToken::query()->notFromJson()->count())->toBe(1); -}); diff --git a/tests/Unit/Core/Models/SettingTest.php b/tests/Unit/Core/Models/SettingTest.php deleted file mode 100644 index 50ab2bc..0000000 --- a/tests/Unit/Core/Models/SettingTest.php +++ /dev/null @@ -1,191 +0,0 @@ -array() - ->rules([ - 'app_name' => ['required', 'array'], - 'app_name.*' => ['required', 'string'], - ]) - ->default(['en' => 'Nexus', 'ar' => 'نيكسس']); - - Setting::define('website_locales') - ->array() - ->rules(['required', 'array', 'min:1']) - ->default(['en', 'ar']); - - Setting::define('page_loader_enabled') - ->boolean() - ->default(false); - - Setting::define('theme') - ->array() - ->default(['primary' => 'blue', 'radius' => 1]); -}); - -it('falls back to the defined schema default when the setting is not persisted', function () { - expect(Setting::get('page_loader_enabled'))->toBeFalse() - ->and(Setting::get('items_per_page', 25))->toBe(25) - ->and(Setting::get('theme.primary'))->toBe('blue'); -}); - -it('does not cache caller defaults for settings that are not persisted', function () { - expect(Setting::get('items_per_page', 25))->toBe(25) - ->and(Setting::get('items_per_page', 50))->toBe(50) - ->and(cache()->has('settings.items_per_page'))->toBeFalse(); -}); - -it('continues to cache persisted setting values', function () { - Setting::set('items_per_page', 25); - - expect(Setting::get('items_per_page'))->toBe(25); - - Setting::where('key', 'items_per_page')->update(['value' => 50]); - - expect(Setting::get('items_per_page'))->toBe(25) - ->and(Setting::get('items_per_page', fresh: true))->toBe(50); -}); - -it('returns the defined default for a key including nested dot paths', function () { - expect(Setting::default('theme.primary'))->toBe('blue') - ->and(Setting::default('app_name.en'))->toBe('Nexus') - ->and(Setting::default('missing'))->toBeNull(); -}); - -it('persists and round-trips scalars, booleans, and arrays through the Union cast', function () { - Setting::set('page_loader_enabled', true); - Setting::set('items_per_page', 25); - Setting::set('theme', ['primary' => 'red', 'radius' => 2]); - - expect(Setting::get('page_loader_enabled', fresh: true))->toBeTrue() - ->and(Setting::get('items_per_page', fresh: true))->toBe(25) - ->and(Setting::get('theme', fresh: true))->toBe(['primary' => 'red', 'radius' => 2]) - ->and(Setting::get('theme.primary', fresh: true))->toBe('red'); -}); - -it('invalidates the top-level cache when the setting record changes', function () { - Setting::set('app_name', ['en' => 'Old']); - - expect(Setting::get('app_name.en'))->toBe('Old'); - - Setting::where('key', 'app_name')->first()->update(['value' => ['en' => 'New']]); - - expect(Setting::get('app_name.en'))->toBe('New'); -}); - -it('invalidates the cache when the setting record is deleted', function () { - Setting::set('page_loader_enabled', true); - - expect(Setting::get('page_loader_enabled'))->toBeTrue(); - - Setting::where('key', 'page_loader_enabled')->first()->delete(); - - expect(Setting::get('page_loader_enabled'))->toBeFalse(); -}); - -it('invalidates removed nested values and branches', function (string $path, mixed $value) { - Setting::set('theme', ['colors' => ['accent' => 'red']]); - - expect(Setting::get($path))->toBe($value); - - Setting::set('theme', []); - - expect(Setting::get($path))->toBeNull(); -})->with([ - 'leaf' => ['theme.colors.accent', 'red'], - 'branch' => ['theme.colors', ['accent' => 'red']], -]); - -it('refreshes cached nested arrays when their members change', function () { - Setting::set('theme', ['colors' => ['accent' => 'red', 'secondary' => 'blue']]); - - expect(Setting::get('theme.colors'))->toBe(['accent' => 'red', 'secondary' => 'blue']) - ->and(Setting::get('theme.colors.secondary'))->toBe('blue'); - - Setting::set('theme', ['colors' => ['accent' => 'green']]); - - expect(Setting::get('theme.colors'))->toBe(['accent' => 'green']) - ->and(Setting::get('theme.colors.secondary'))->toBeNull(); -}); - -it('invalidates nested caches when an array setting becomes a scalar', function () { - Setting::set('theme', ['colors' => ['accent' => 'red']]); - - expect(Setting::get('theme.colors'))->toBe(['accent' => 'red']) - ->and(Setting::get('theme.colors.accent'))->toBe('red'); - - Setting::set('theme', 'automatic'); - - expect(Setting::get('theme'))->toBe('automatic') - ->and(Setting::get('theme.colors'))->toBeNull() - ->and(Setting::get('theme.colors.accent'))->toBeNull(); -}); - -it('restores nested defaults after deletion and keeps unrelated settings cached', function () { - Setting::define('theme')->array()->default(['colors' => ['accent' => 'blue']]); - Setting::set('theme', ['colors' => ['accent' => 'red', 'secondary' => 'yellow']]); - Setting::set('items_per_page', 25); - - expect(Setting::get('theme.colors'))->toBe(['accent' => 'red', 'secondary' => 'yellow']) - ->and(Setting::get('theme.colors.accent'))->toBe('red') - ->and(Setting::get('theme.colors.secondary'))->toBe('yellow') - ->and(Setting::get('items_per_page'))->toBe(25); - - Setting::where('key', 'theme')->firstOrFail()->delete(); - - expect(Setting::get('theme.colors'))->toBe(['accent' => 'blue']) - ->and(Setting::get('theme.colors.accent'))->toBe('blue') - ->and(Setting::get('theme.colors.secondary'))->toBeNull() - ->and(cache()->get('settings.items_per_page'))->toBe(25); -}); - -it('exposes the validation rules declared per setting and per nested path', function () { - $rules = Setting::rules(); - - expect($rules)->toHaveKey('app_name') - ->and($rules)->toHaveKey('app_name.*') - ->and($rules)->toHaveKey('website_locales') - ->and($rules['website_locales'])->toContain('required'); -}); - -it('registers fluent setting types and exposes their schema metadata', function () { - $logo = Setting::define('logo')->file()->rules(['nullable'])->default('logo.svg'); - Setting::define('enabled')->boolean(); - Setting::define('title')->string(); - Setting::define('limit')->integer(); - Setting::define('ratio')->float(); - Setting::define('options')->array(); - Setting::define('custom')->type('color'); - - expect(Setting::type('logo'))->toBe('file') - ->and(Setting::type('enabled'))->toBe('boolean') - ->and(Setting::type('title'))->toBe('string') - ->and(Setting::type('limit'))->toBe('integer') - ->and(Setting::type('ratio'))->toBe('float') - ->and(Setting::type('options'))->toBe('array') - ->and(Setting::type('custom'))->toBe('color') - ->and(Setting::type('theme.primary'))->toBe('array') - ->and(Setting::type('missing'))->toBeNull() - ->and($logo->getType())->toBe('file') - ->and($logo->getRules())->toBe(['nullable']) - ->and($logo->getDefault())->toBe('logo.svg') - ->and(Setting::schema()['logo'])->toBe([ - 'type' => 'file', - 'rules' => ['nullable'], - 'default' => 'logo.svg', - ]); -}); - -it('returns the full settings collection as a key-value map when no key is provided', function () { - Setting::set('foo', 'bar'); - Setting::set('items_per_page', 42); - - $all = setting(); - - expect($all)->toMatchArray([ - 'foo' => 'bar', - 'items_per_page' => 42, - ]); -}); diff --git a/tests/Unit/Core/Rules/CaptchaTest.php b/tests/Unit/Core/Rules/CaptchaTest.php deleted file mode 100644 index 84a835d..0000000 --- a/tests/Unit/Core/Rules/CaptchaTest.php +++ /dev/null @@ -1,55 +0,0 @@ -passes('captcha', 'anything'))->toBeTrue(); -}); - -it('verifies captcha tokens against cloudflare in production', function () { - app()->detectEnvironment(fn () => 'production'); - Setting::set('cloudflare_turnstile_secret_key', 'secret'); - - Http::fake([ - 'https://challenges.cloudflare.com/turnstile/v0/siteverify' => Http::response(['success' => true]), - ]); - - expect((new Captcha)->passes('captcha', 'token'))->toBeTrue(); - - Http::assertSent(fn ($request) => $request->url() === 'https://challenges.cloudflare.com/turnstile/v0/siteverify' - && $request['secret'] === 'secret' - && $request['response'] === 'token'); -}); - -it('fails captcha validation in production without a secret', function () { - app()->detectEnvironment(fn () => 'production'); - - expect((new Captcha)->passes('captcha', 'token'))->toBeFalse(); -}); - -it('fails captcha validation when cloudflare returns an unsuccessful or malformed response', function (array|string $body, int $status) { - app()->detectEnvironment(fn () => 'production'); - Setting::set('cloudflare_turnstile_secret_key', 'secret'); - - Http::fake([ - 'https://challenges.cloudflare.com/turnstile/v0/siteverify' => Http::response($body, $status), - ]); - - expect((new Captcha)->passes('captcha', 'token'))->toBeFalse(); -})->with([ - 'server error' => ['Unavailable', 503], - 'missing success key' => [['messages' => []], 200], -]); - -it('fails captcha validation when cloudflare is unreachable', function () { - app()->detectEnvironment(fn () => 'production'); - Setting::set('cloudflare_turnstile_secret_key', 'secret'); - - Http::fake([ - 'https://challenges.cloudflare.com/turnstile/v0/siteverify' => Http::failedConnection(), - ]); - - expect((new Captcha)->passes('captcha', 'token'))->toBeFalse(); -}); diff --git a/tests/Unit/Core/Rules/PhoneTest.php b/tests/Unit/Core/Rules/PhoneTest.php deleted file mode 100644 index 4018bc0..0000000 --- a/tests/Unit/Core/Rules/PhoneTest.php +++ /dev/null @@ -1,13 +0,0 @@ -passes('phone', '01001234567'))->toBeTrue() - ->and((new Phone('US'))->passes('phone', '+14155552671'))->toBeTrue(); -}); - -it('rejects invalid phone numbers', function () { - expect((new Phone('EG'))->passes('phone', '123'))->toBeFalse() - ->and((new Phone('US'))->passes('phone', 'not-a-phone'))->toBeFalse(); -}); diff --git a/tests/Unit/Core/Session/DatabaseSessionHandlerTest.php b/tests/Unit/Core/Session/DatabaseSessionHandlerTest.php deleted file mode 100644 index dcf6620..0000000 --- a/tests/Unit/Core/Session/DatabaseSessionHandlerTest.php +++ /dev/null @@ -1,198 +0,0 @@ -id(); - $table->string('name')->nullable(); - $table->rememberToken(); - $table->timestamps(); - }); - } - - config()->set('auth.guards.session_admins', ['driver' => 'session', 'provider' => 'session_admins']); - config()->set('auth.guards.session_members', ['driver' => 'session', 'provider' => 'session_members']); - config()->set('auth.guards.token', ['driver' => 'sanctum', 'provider' => 'session_members']); - config()->set('auth.providers.session_admins', ['driver' => 'eloquent', 'model' => SessionAdmin::class]); - config()->set('auth.providers.session_members', ['driver' => 'eloquent', 'model' => SessionMember::class]); -}); - -function handler(): DatabaseSessionHandler -{ - return new DatabaseSessionHandler(DB::connection(), 'sessions', 120, app()); -} - -function writeSession(string $id, ?string $guard = null, $user = null): void -{ - if ($guard) { - Auth::guard($guard)->setUser($user); - } - - handler()->write($id, serialize(['_token' => $id])); - - if ($guard) { - Auth::guard($guard)->forgetUser(); - } -} - -it('registers the polymorphic handler as the database session driver', function () { - expect(Session::driver('database')->getHandler()) - ->toBeInstanceOf(DatabaseSessionHandler::class); -}); - -it('records the authenticated owner polymorphically per session guard', function () { - $admin = SessionAdmin::create(['name' => 'admin']); - $member = SessionMember::create(['name' => 'member']); - - writeSession('admin-session', 'session_admins', $admin); - writeSession('member-session', 'session_members', $member); - writeSession('guest-session'); - - expect(DB::table('session_authentications')->where('session_id', 'admin-session')->first()) - ->guard->toBe('session_admins') - ->user_type->toBe(SessionAdmin::class) - ->user_id->toBe($admin->id); - - expect(DB::table('session_authentications')->where('session_id', 'member-session')->first()) - ->guard->toBe('session_members') - ->user_type->toBe(SessionMember::class) - ->user_id->toBe($member->id); - - expect(DB::table('sessions')->where('id', 'guest-session')->exists())->toBeTrue() - ->and(DB::table('session_authentications')->where('session_id', 'guest-session')->exists())->toBeFalse(); -}); - -it('associates one browser session with every authenticated session guard', function () { - $admin = SessionAdmin::create(['name' => 'admin']); - $member = SessionMember::create(['name' => 'member']); - - Auth::guard('session_admins')->setUser($admin); - Auth::guard('session_members')->setUser($member); - - handler()->write('shared-session', serialize(['_token' => 'shared-session'])); - - expect(DB::table('session_authentications')->where('session_id', 'shared-session')->count())->toBe(2) - ->and(DB::table('session_authentications') - ->where('session_id', 'shared-session') - ->where('guard', 'session_admins') - ->where('user_type', SessionAdmin::class) - ->where('user_id', $admin->id) - ->exists())->toBeTrue() - ->and(DB::table('session_authentications') - ->where('session_id', 'shared-session') - ->where('guard', 'session_members') - ->where('user_type', SessionMember::class) - ->where('user_id', $member->id) - ->exists())->toBeTrue() - ->and($admin->sessions()->sole()->getKey())->toBe('shared-session') - ->and($member->sessions()->sole()->getKey())->toBe('shared-session'); -}); - -it('does not restore a remembered guard while persisting an unauthenticated session', function () { - $admin = SessionAdmin::create(['name' => 'admin', 'remember_token' => 'remember-token']); - $sessionId = str_repeat('a', 40); - - config()->set('session.driver', 'database'); - Session::forgetDrivers(); - app()->forgetInstance('session.store'); - Auth::forgetGuards(); - - $session = app('session.store'); - $session->setId($sessionId); - $session->start(); - - $guard = Auth::guard('session_admins'); - $guard->setRequest(Request::create('/', 'GET', cookies: [ - $guard->getRecallerName() => "{$admin->id}|remember-token|hash", - ])); - - expect($guard->hasUser())->toBeFalse() - ->and($session->has($guard->getName()))->toBeFalse(); - - handler()->write($sessionId, serialize(['_token' => $sessionId])); - - expect(DB::table('sessions')->where('id', $sessionId)->exists())->toBeTrue() - ->and(DB::table('session_authentications')->where('session_id', $sessionId)->exists())->toBeFalse() - ->and($guard->hasUser())->toBeFalse(); -}); - -it('exposes sessions per entity through the HasSessions trait', function () { - $admin = SessionAdmin::create(['name' => 'admin']); - $member = SessionMember::create(['name' => 'member']); - - writeSession('admin-1', 'session_admins', $admin); - writeSession('admin-2', 'session_admins', $admin); - writeSession('member-1', 'session_members', $member); - - expect($admin->sessions()->count())->toBe(2) - ->and($member->sessions()->count())->toBe(1); -}); - -it('revokes only the owning entity sessions when logging out everywhere', function () { - $admin = SessionAdmin::create(['name' => 'admin']); - $member = SessionMember::create(['name' => 'member']); - - writeSession('admin-1', 'session_admins', $admin); - writeSession('admin-2', 'session_admins', $admin); - writeSession('member-1', 'session_members', $member); - writeSession('guest', null); - - $deleted = $admin->logoutAllSessions(); - - expect($deleted)->toBe(2) - ->and($admin->sessions()->count())->toBe(0) - ->and($member->sessions()->count())->toBe(1) - ->and(DB::table('sessions')->where('id', 'guest')->exists())->toBeTrue() - ->and(DB::table('session_authentications')->where('session_id', 'guest')->exists())->toBeFalse(); -}); - -it('cycles the remember token so remember-me cookies cannot restore revoked sessions', function () { - $admin = SessionAdmin::create(['name' => 'admin', 'remember_token' => 'original-token']); - - writeSession('admin-1', 'session_admins', $admin); - - $admin->logoutAllSessions(); - - expect($admin->fresh()->remember_token)->not->toBe('original-token'); -}); - -it('leaves the remember token untouched when none was issued', function () { - $admin = SessionAdmin::create(['name' => 'admin']); - - writeSession('admin-1', 'session_admins', $admin); - - $admin->logoutAllSessions(); - - expect($admin->fresh()->remember_token)->toBeNull(); -}); - -it('revokes a shared browser session for every associated guard', function () { - $admin = SessionAdmin::create(['name' => 'admin']); - $member = SessionMember::create(['name' => 'member']); - - Auth::guard('session_admins')->setUser($admin); - Auth::guard('session_members')->setUser($member); - - handler()->write('shared-session', serialize(['_token' => 'shared-session'])); - - Auth::guard('session_admins')->forgetUser(); - Auth::guard('session_members')->forgetUser(); - writeSession('member-session', 'session_members', $member); - - $deleted = $admin->logoutAllSessions(); - - expect($deleted)->toBe(1) - ->and(DB::table('sessions')->where('id', 'shared-session')->exists())->toBeFalse() - ->and(DB::table('session_authentications')->where('session_id', 'shared-session')->exists())->toBeFalse() - ->and($member->sessions()->pluck('sessions.id')->all())->toBe(['member-session']); -}); diff --git a/tests/Unit/Core/Support/PermissionNameResolverTest.php b/tests/Unit/Core/Support/PermissionNameResolverTest.php deleted file mode 100644 index d16cf88..0000000 --- a/tests/Unit/Core/Support/PermissionNameResolverTest.php +++ /dev/null @@ -1,82 +0,0 @@ -toBe($permission); -})->with([ - ['users.create', 'users.create'], - ['users.store', 'users.create'], - ['users.edit', 'users.edit'], - ['users.update', 'users.edit'], - ['users.destroy', 'users.destroy'], - ['store', 'create'], - ['update', 'edit'], -]); - -it('uses an explicit permission for routes outside the conventional groups', function () { - $route = Route::post('/users/{user}/suspend', fn () => 'suspended') - ->name('users.suspend.store') - ->usePermission('users.suspend'); - - Route::getRoutes()->refreshNameLookups(); - - expect(PermissionNameResolver::resolve($route))->toBe('users.suspend') - ->and(PermissionNameResolver::resolve('users.suspend.store'))->toBe('users.suspend'); -}); - -it('uses action-specific permissions on resource routes', function () { - Route::resource('articles', stdClass::class)->usePermissions([ - 'store' => 'articles.publish', - 'destroy' => 'articles.archive', - ]); - - expect(PermissionNameResolver::resolve('articles.store'))->toBe('articles.publish') - ->and(PermissionNameResolver::resolve('articles.destroy'))->toBe('articles.archive') - ->and(PermissionNameResolver::resolve('articles.update'))->toBe('articles.edit') - ->and(PermissionNameResolver::resolve('articles.index'))->toBe('articles.index'); -}); - -it('mirrors api routes onto their dashboard counterparts', function () { - Route::get('/dashboard/users', fn () => 'index')->name('dashboard.users.index'); - Route::post('/dashboard/users/{user}/suspend', fn () => 'suspend') - ->name('dashboard.users.suspend.store') - ->usePermission('dashboard.users.suspend'); - Route::resource('/dashboard/articles', stdClass::class) - ->names('dashboard.articles') - ->usePermissions(['store' => 'dashboard.articles.publish']); - - $index = Route::get('/api/dashboard/users', fn () => 'index')->name('api.dashboard.users.index'); - $suspend = Route::post('/api/dashboard/users/{user}/suspend', fn () => 'suspend')->name('api.dashboard.users.suspend.store'); - $publish = Route::post('/api/dashboard/articles', fn () => 'store')->name('api.dashboard.articles.store'); - - Route::getRoutes()->refreshNameLookups(); - - expect(PermissionNameResolver::resolve($index))->toBe('dashboard.users.index') - ->and(PermissionNameResolver::resolve('api.dashboard.users.index'))->toBe('dashboard.users.index') - ->and(PermissionNameResolver::resolve($suspend))->toBe('dashboard.users.suspend') - ->and(PermissionNameResolver::resolve($publish))->toBe('dashboard.articles.publish'); -}); - -it('prefers an explicit permission on the api route over the dashboard counterpart', function () { - Route::get('/dashboard/reports', fn () => 'index')->name('dashboard.reports.index'); - $route = Route::get('/api/dashboard/reports', fn () => 'index') - ->name('api.dashboard.reports.index') - ->usePermission('dashboard.reports.export'); - - Route::getRoutes()->refreshNameLookups(); - - expect(PermissionNameResolver::resolve($route))->toBe('dashboard.reports.export'); -}); - -it('keeps the api name when no dashboard counterpart is registered', function () { - $route = Route::post('/api/dashboard/webhooks', fn () => 'store')->name('api.dashboard.webhooks.store'); - - Route::getRoutes()->refreshNameLookups(); - - expect(PermissionNameResolver::resolve($route))->toBe('api.dashboard.webhooks.create') - ->and(PermissionNameResolver::resolve('api.dashboard.webhooks.store'))->toBe('api.dashboard.webhooks.create') - ->and(PermissionNameResolver::dashboardRoute('api.dashboard.webhooks.store'))->toBeNull() - ->and(PermissionNameResolver::dashboardRoute('dashboard.webhooks.store'))->toBeNull(); -}); diff --git a/tests/Unit/Core/Traits/CanUploadFileTest.php b/tests/Unit/Core/Traits/CanUploadFileTest.php deleted file mode 100644 index 59a61f5..0000000 --- a/tests/Unit/Core/Traits/CanUploadFileTest.php +++ /dev/null @@ -1,95 +0,0 @@ -uploader = new class - { - use CanUploadFile; - }; - - File::deleteDirectory(public_path('uploads/can-upload-file-test')); -}); - -afterEach(function () { - File::deleteDirectory(public_path('uploads/can-upload-file-test')); - File::delete(public_path('outside.txt')); - File::delete(dirname(public_path()) . '/outside.txt'); -}); - -it('uses the server detected extension instead of the client extension', function () { - $file = UploadedFile::fake()->create('avatar.php', 1, 'image/jpeg'); - - $url = $this->uploader->uploadFile($file, 'can-upload-file-test'); - $path = parse_url($url, PHP_URL_PATH); - - expect($path)->toEndWith('.jpg') - ->and(File::exists(public_path($path)))->toBeTrue(); -}); - -it('rejects executable and active web content', function (string $name, string $mime) { - $file = UploadedFile::fake()->create($name, 1, $mime); - - expect(fn () => $this->uploader->uploadFile($file, 'can-upload-file-test')) - ->toThrow(ValidationException::class); -})->with([ - ['shell.php', 'application/x-php'], - ['payload.html', 'text/html'], - ['graphic.svg', 'image/svg+xml'], -]); - -it('uses the configured allowed extensions', function () { - config()->set('redot.uploads.allowed_extensions', ['json']); - $file = UploadedFile::fake()->create('data.json', 1, 'application/json'); - - $url = $this->uploader->uploadFile($file, 'can-upload-file-test'); - $path = parse_url($url, PHP_URL_PATH); - - expect($path)->toEndWith('.json') - ->and(File::exists(public_path($path)))->toBeTrue(); -}); - -it('orients and optimizes image uploads when requested', function () { - app()->register(ImageOptimizerServiceProvider::class); - ImageOptimizer::shouldReceive('optimize')->once(); - $file = UploadedFile::fake()->image('avatar.jpg', 40, 20); - - $url = $this->uploader->uploadFile($file, 'can-upload-file-test', optimize: true); - $path = public_path(parse_url($url, PHP_URL_PATH)); - - expect(File::exists($path))->toBeTrue() - ->and(getimagesize($path))->toMatchArray([40, 20]); -}); - -it('rejects upload paths outside the uploads directory', function () { - $file = UploadedFile::fake()->create('avatar.jpg', 1, 'image/jpeg'); - - expect(fn () => $this->uploader->uploadFile($file, '../outside')) - ->toThrow(InvalidArgumentException::class); -}); - -it('deletes files only from local upload urls', function () { - $directory = public_path('uploads/can-upload-file-test'); - File::ensureDirectoryExists($directory); - File::put($directory . '/safe.txt', 'safe'); - File::put(public_path('outside.txt'), 'outside'); - - expect($this->uploader->deleteFileFromUrl(url('/uploads/can-upload-file-test/safe.txt')))->toBeTrue() - ->and(File::exists($directory . '/safe.txt'))->toBeFalse() - ->and($this->uploader->deleteFileFromUrl(url('/uploads/%2e%2e/outside.txt')))->toBeFalse() - ->and($this->uploader->deleteFileFromUrl('https://example.com/uploads/outside.txt'))->toBeFalse() - ->and(File::exists(public_path('outside.txt')))->toBeTrue(); -}); - -it('does not delete paths outside the public directory', function () { - $outsidePath = dirname(public_path()) . '/outside.txt'; - File::put($outsidePath, 'outside'); - - expect($this->uploader->deleteFile('../outside.txt'))->toBeFalse() - ->and(File::exists($outsidePath))->toBeTrue(); -}); diff --git a/tests/Unit/Packages/Auth/PanelTest.php b/tests/Unit/Packages/Auth/PanelTest.php deleted file mode 100644 index 2a8ae2d..0000000 --- a/tests/Unit/Packages/Auth/PanelTest.php +++ /dev/null @@ -1,130 +0,0 @@ -identifierInputName())->toBe('email') - ->and((new Panel('dashboard'))->identifiers(['email', 'phone'])->identifierInputName())->toBe('identifier'); -}); - -it('prefixes route names with the prefix it was registered under', function () { - $panel = (new Panel('dashboard'))->withRoutePrefix('dashboard.'); - - expect($panel->routeName('login'))->toBe('dashboard.login'); -}); - -it('does not leak the route prefix into the panel definition', function () { - $panel = new Panel('dashboard'); - $panel->withRoutePrefix('dashboard.'); - - expect($panel->routeName('login'))->toBe('login'); -}); - -it('resolves view names from the prefix and per-screen overrides', function () { - $panel = (new Panel('dashboard')) - ->views('dashboard.auth') - ->views(['unlock' => 'custom.unlock']); - - expect($panel->viewName('login'))->toBe('dashboard.auth.login') - ->and($panel->viewName('unlock'))->toBe('custom.unlock'); -}); - -it('resolves the home url from a route name, a callback, or the index route', function () { - Route::get('/home', fn () => 'home')->name('dashboard.index'); - Route::get('/welcome', fn () => 'welcome')->name('welcome'); - Route::getRoutes()->refreshNameLookups(); - - $panel = (new Panel('dashboard'))->withRoutePrefix('dashboard.'); - - expect($panel->homeUrl())->toBe(route('dashboard.index')) - ->and($panel->home('welcome')->homeUrl())->toBe(route('welcome')) - ->and($panel->home(fn (Panel $panel) => 'https://example.test/' . $panel->name)->homeUrl())->toBe('https://example.test/dashboard'); -}); - -it('adds the locked middleware to authenticated routes only when the lock screen is enabled', function () { - $panel = (new Panel('dashboard'))->guard('admins')->withRoutePrefix('dashboard.'); - - expect($panel->authMiddleware())->toBe(['auth:admins']); - - $panel->features(LockScreen::make()); - - expect($panel->authMiddleware())->toBe(['auth:admins', Locked::using('admins')]); -}); - -it('prefers the panel binding, then the container binding, then the class itself', function () { - $global = new class extends LogoutResponse {}; - $panel = new class extends LogoutResponse {}; - - expect((new Panel('web'))->make(LogoutResponse::class))->toBeInstanceOf(LogoutResponse::class); - - app()->bind(LogoutResponse::class, $global::class); - - expect((new Panel('web'))->make(LogoutResponse::class))->toBeInstanceOf($global::class) - ->and((new Panel('web'))->using(LogoutResponse::class, $panel::class)->make(LogoutResponse::class))->toBeInstanceOf($panel::class) - ->and((new Panel('web'))->using(LogoutResponse::class, fn (Panel $p) => new $panel)->make(LogoutResponse::class))->toBeInstanceOf($panel::class); -}); - -it('passes constructor parameters to the resolved class', function () { - $response = (new Panel('web'))->make(ResetLinkSentResponse::class, ['status' => 'passwords.sent']); - - expect($response->status)->toBe('passwords.sent'); -}); - -it('keeps the api response when only the web response is overridden', function () { - $custom = new class(new User, 'plain-token') extends LoginResponse - { - protected function web(Panel $panel): Response - { - return redirect('/welcome'); - } - }; - - expect($custom->toResponse((new Panel('web'))))->toBeInstanceOf(RedirectResponse::class) - ->and($custom->toResponse((new Panel('api'))->api())->getData(true)['payload'])->toBe(['token' => 'plain-token', 'token_type' => 'Bearer']); -}); - -it('fails loudly when a response has no version for the panel type', function () { - (new UnlockedResponse)->toResponse((new Panel('api'))->api()); -})->throws(LogicException::class, 'has no API response.'); - -it('returns the configured feature instance', function () { - $login = Login::make()->throttle(3); - $panel = (new Panel('dashboard'))->features($login); - - expect($panel->feature(Login::class))->toBe($login) - ->and($panel->hasFeature(Logout::class))->toBeFalse(); -}); - -it('resolves the provider, model, and password broker from the guard', function () { - $panel = (new Panel('dashboard'))->guard('admins'); - - expect($panel->provider())->toBe('admins') - ->and($panel->model())->toBe(User::class) - ->and($panel->broker())->toBe('admins'); -}); - -it('throws when the guard is missing or not configured', function (Panel $panel, string $message) { - expect(fn () => $panel->getGuard())->toThrow(InvalidArgumentException::class, $message); -})->with([ - 'no guard' => [fn () => new Panel('dashboard'), 'Auth panel [dashboard] has no guard.'], - 'unknown guard' => [fn () => (new Panel('dashboard'))->guard('missing'), 'Guard [missing] is not configured.'], -]); - -it('throws when the guard provider does not point at a real model class', function () { - config()->set('auth.guards.broken', ['driver' => 'session', 'provider' => 'broken']); - config()->set('auth.providers.broken', ['driver' => 'eloquent', 'model' => 'App\\Does\\Not\\Exist']); - - (new Panel('broken'))->guard('broken')->model(); -})->throws(InvalidArgumentException::class, 'Provider [broken] model is invalid.'); diff --git a/tests/Unit/Packages/Auth/RedotAuthManagerTest.php b/tests/Unit/Packages/Auth/RedotAuthManagerTest.php deleted file mode 100644 index ccf4174..0000000 --- a/tests/Unit/Packages/Auth/RedotAuthManagerTest.php +++ /dev/null @@ -1,617 +0,0 @@ -id(); - $table->string('email')->unique(); - $table->string('password')->nullable(); - $table->boolean('active')->default(true); - $table->timestamp('last_login_at')->nullable(); - $table->rememberToken(); - $table->timestamps(); - }); - - config()->set('auth.providers.admins.model', NotifiableUser::class); - config()->set('auth.guards.admins-api', ['driver' => 'sanctum', 'provider' => 'admins']); - - Route::get('/home', fn () => 'home')->name('dashboard.index'); -}); - -function challenge_feature(): Feature -{ - return new class extends Feature - { - public function verifiedSteps(array $steps): array - { - return [fn (LoginAttempt $attempt, Closure $next) => response('challenge: ' . $attempt->user->email), ...$steps]; - } - - public function routes(Panel $panel): void - { - Route::post('two-factor', function (Request $request, Panel $panel) { - $user = $panel->findUser('admin@example.com'); - $attempt = new LoginAttempt($request, $panel, identifier: 'admin@example.com', remember: true, user: $user); - - return $panel->make(Authenticator::class)->complete($attempt); - }); - } - }; -} - -function register_panel(string $name = 'dashboard', string $prefix = 'dashboard.'): void -{ - Route::middleware('web')->name($prefix)->group(fn () => RedotAuth::routes($name)); - Route::getRoutes()->refreshNameLookups(); -} - -it('registers the routes of enabled features only', function () { - RedotAuth::panel('dashboard')->guard('admins')->features( - Login::make(), - Logout::make(), - ); - - register_panel(); - - expect(Route::has('dashboard.login'))->toBeTrue() - ->and(Route::has('dashboard.login.store'))->toBeTrue() - ->and(Route::has('dashboard.logout'))->toBeTrue() - ->and(Route::has('dashboard.register.store'))->toBeFalse() - ->and(Route::has('dashboard.magic-link.store'))->toBeFalse() - ->and(Route::has('dashboard.unlock'))->toBeFalse(); -}); - -it('skips screen routes on api panels', function () { - RedotAuth::panel('api')->guard('admins-api')->api()->features( - Login::make(), - PasswordReset::make(), - ); - - register_panel('api', 'api.'); - - expect(Route::has('api.login.store'))->toBeTrue() - ->and(Route::has('api.login'))->toBeFalse() - ->and(Route::has('api.password.email'))->toBeTrue() - ->and(Route::has('api.password.request'))->toBeFalse(); -}); - -it('rejects session-only features on api panels', function () { - RedotAuth::panel('api')->guard('admins-api')->api()->features(MagicLink::make()); - - register_panel('api', 'api.'); -})->throws(InvalidArgumentException::class, 'is not supported by API panel [api]'); - -it('throws when routes are registered for an undefined panel', function () { - RedotAuth::routes('missing'); -})->throws(InvalidArgumentException::class, 'Auth panel [missing] is not defined.'); - -it('rejects token guards on panels not marked as api', function () { - RedotAuth::panel('api')->guard('admins-api')->features(Login::make()); - - register_panel('api', 'api.'); -})->throws(InvalidArgumentException::class, 'Guard [admins-api] cannot start sessions, mark auth panel [api] as api().'); - -it('cannot resolve a panel outside of a panel route', function () { - app(Panel::class); -})->throws(InvalidArgumentException::class, 'The current route does not belong to an auth panel.'); - -it('finds features by their parent class', function () { - $login = new class extends Login {}; - - RedotAuth::panel('dashboard')->guard('admins')->features($login); - - register_panel(); - - NotifiableUser::create(['email' => 'admin@example.com', 'password' => Hash::make('secret')]); - - $this->post('/login', ['email' => 'admin@example.com', 'password' => 'secret'])->assertRedirect('/home'); -}); - -it('keeps working after the routes are cached', function () { - RedotAuth::panel('dashboard') - ->guard('admins') - ->scope(fn ($query) => $query->where('active', true)) - ->features(Login::make(), Logout::make()); - - register_panel(); - - foreach (Route::getRoutes() as $route) { - $route->prepareForSerialization(); - } - - Route::setCompiledRoutes(unserialize(serialize(Route::getRoutes()->compile()))); - - NotifiableUser::create(['email' => 'admin@example.com', 'password' => Hash::make('secret')]); - NotifiableUser::create(['email' => 'inactive@example.com', 'password' => Hash::make('secret'), 'active' => false]); - - $this->post('/login', ['email' => 'inactive@example.com', 'password' => 'secret'])->assertInvalid('email'); - $this->post('/login', ['email' => 'admin@example.com', 'password' => 'secret'])->assertRedirect('/home'); - - $this->assertAuthenticated('admins'); -}); - -it('registers every auth route against a controller', function () { - RedotAuth::panel('dashboard')->guard('admins')->views('auth')->features( - Login::make(), - Registration::make(), - PasswordReset::make(), - MagicLink::make(), - EmailVerification::make(), - Logout::make(), - LockScreen::make(), - ); - - register_panel(); - - $uses = collect(Route::getRoutes()->getRoutes()) - ->filter(fn ($route) => str_starts_with((string) $route->getName(), 'dashboard.') && $route->getName() !== 'dashboard.index') - ->map(fn ($route) => $route->getAction('uses')); - - expect($uses)->not->toBeEmpty() - ->each->toBeString(); -}); - -it('runs custom credential steps', function () { - RedotAuth::panel('dashboard')->guard('admins')->features( - Login::make()->steps(fn (array $steps) => [ - ...$steps, - fn (LoginAttempt $attempt, Closure $next) => response('verified: ' . $attempt->user->email), - ]), - ); - - register_panel(); - - NotifiableUser::create(['email' => 'admin@example.com', 'password' => Hash::make('secret')]); - - $this->post('/login', ['email' => 'admin@example.com', 'password' => 'secret'])->assertSee('verified: admin@example.com'); - - $this->assertGuest('admins'); -}); - -it('passes the default rules to the rules callback', function () { - RedotAuth::panel('dashboard')->guard('admins')->features( - Login::make()->rules(fn (array $rules) => [...$rules, 'captcha' => ['required']]), - ); - - register_panel(); - - $this->post('/login', ['password' => 'secret'])->assertInvalid(['email', 'captcha']); -}); - -it('pauses logins at feature steps, and completes them afterwards', function () { - RedotAuth::panel('dashboard')->guard('admins')->features(Login::make(), challenge_feature()); - - register_panel(); - - NotifiableUser::create(['email' => 'admin@example.com', 'password' => Hash::make('secret')]); - - $this->post('/login', ['email' => 'admin@example.com', 'password' => 'secret'])->assertSee('challenge: admin@example.com'); - $this->assertGuest('admins'); - - $this->post('/two-factor')->assertRedirect('/home'); - $this->assertAuthenticated('admins'); - - expect(NotifiableUser::firstOrFail()->remember_token)->not->toBeNull(); -}); - -it('keeps feature steps when the credential steps are replaced', function () { - RedotAuth::panel('dashboard')->guard('admins')->features( - Login::make()->steps([EnsureLoginIsNotThrottled::class, AttemptToAuthenticate::class]), - challenge_feature(), - ); - - register_panel(); - - NotifiableUser::create(['email' => 'admin@example.com', 'password' => Hash::make('secret')]); - - $this->post('/login', ['email' => 'admin@example.com', 'password' => 'secret'])->assertSee('challenge: admin@example.com'); -}); - -it('signs magic-link users in by the email the token was issued to', function () { - Schema::table('users', fn (Blueprint $table) => $table->string('username')->nullable()); - - RedotAuth::panel('dashboard')->guard('admins')->identifiers(['email', 'username'])->features(MagicLink::make()); - - register_panel(); - - NotifiableUser::create(['email' => 'other@example.com', 'username' => 'admin@example.com']); - $owner = NotifiableUser::create(['email' => 'admin@example.com', 'username' => 'owner']); - $token = LoginToken::generate('admin@example.com', 'admins'); - - $this->get('/magic-link/verify/' . $token->token)->assertRedirect('/home'); - - expect(auth('admins')->id())->toBe($owner->id); -}); - -it('runs feature steps for magic-link sign-ins too', function () { - RedotAuth::panel('dashboard')->guard('admins')->features(MagicLink::make(), challenge_feature()); - - register_panel(); - - NotifiableUser::create(['email' => 'admin@example.com']); - $token = LoginToken::generate('admin@example.com', 'admins'); - - $this->get('/magic-link/verify/' . $token->token)->assertSee('challenge: admin@example.com'); - $this->assertGuest('admins'); -}); - -it('upgrades outdated password hashes on login', function (bool $enabled) { - config()->set('hashing.rehash_on_login', $enabled); - - RedotAuth::panel('dashboard')->guard('admins')->features(Login::make()); - - register_panel(); - - $outdated = Hash::make('secret', ['rounds' => 4]); - NotifiableUser::create(['email' => 'admin@example.com', 'password' => $outdated]); - - $this->post('/login', ['email' => 'admin@example.com', 'password' => 'secret'])->assertRedirect('/home'); - - $password = NotifiableUser::firstOrFail()->password; - - expect($password === $outdated)->toBe(! $enabled) - ->and(Hash::check('secret', $password))->toBeTrue() - ->and(Hash::needsRehash($password))->toBe(! $enabled); -})->with(['enabled' => true, 'disabled' => false]); - -it('sends the password reset link after the response', function () { - Notification::fake(); - config()->set('auth.passwords.admins', ['provider' => 'admins', 'table' => 'password_reset_tokens', 'expire' => 60]); - - Schema::create('password_reset_tokens', function (Blueprint $table) { - $table->string('email')->primary(); - $table->string('token'); - $table->timestamp('created_at')->nullable(); - }); - - RedotAuth::panel('dashboard')->guard('admins')->features(PasswordReset::make()); - - register_panel(); - - $user = NotifiableUser::create(['email' => 'admin@example.com', 'password' => Hash::make('secret')]); - - $this->post('/forgot-password', ['email' => 'unknown@example.com'])->assertSessionHas('success'); - Notification::assertNothingSent(); - - $this->post('/forgot-password', ['email' => 'admin@example.com'])->assertSessionHas('success'); - Notification::assertSentTo($user, ResetPassword::class); -}); - -it('finishes a password reset on panels with or without the login screen', function (bool $withLogin, string $redirect) { - config()->set('auth.passwords.admins', ['provider' => 'admins', 'table' => 'password_reset_tokens', 'expire' => 60]); - - Schema::create('password_reset_tokens', function (Blueprint $table) { - $table->string('email')->primary(); - $table->string('token'); - $table->timestamp('created_at')->nullable(); - }); - - config()->set('auth.providers.admins.model', ApiUser::class); - - RedotAuth::panel('dashboard')->guard('admins')->features(PasswordReset::make(), ...($withLogin ? [Login::make()] : [])); - - register_panel(); - - $user = ApiUser::create(['email' => 'admin@example.com', 'password' => 'secret']); - $token = Password::broker('admins')->createToken($user); - - $this->post('/reset-password', [ - 'token' => $token, - 'email' => 'admin@example.com', - 'password' => 'New-secret-123', - 'password_confirmation' => 'New-secret-123', - ])->assertRedirect($redirect)->assertSessionHas('success'); - - expect(Hash::check('New-secret-123', ApiUser::firstOrFail()->password))->toBeTrue(); -})->with([ - 'with login' => [true, '/login'], - 'without login' => [false, '/home'], -]); - -it('throttles failed logins using the feature limits', function () { - RedotAuth::panel('dashboard')->guard('admins')->features(Login::make()->throttle(2)); - - register_panel(); - - foreach (range(1, 2) as $attempt) { - $this->post('/login', ['email' => 'admin@example.com', 'password' => 'wrong']) - ->assertInvalid(['email' => __('auth.failed')]); - } - - $this->post('/login', ['email' => 'admin@example.com', 'password' => 'wrong']) - ->assertInvalid(['email' => 'Too many attempts']); -}); - -it('creates users with the panel\'s user creator', function () { - $creator = new class implements CreatesUsers - { - public function rules(Panel $panel): array - { - return ['email' => ['required', 'email']]; - } - - public function create(array $input, Panel $panel): Model&Authenticatable - { - return $panel->model()::create([...$input, 'password' => Hash::make('generated')]); - } - }; - - RedotAuth::panel('dashboard') - ->guard('admins') - ->using(CreatesUsers::class, fn () => $creator) - ->features(Registration::make()); - - register_panel(); - - $this->post('/register', ['email' => 'new@example.com'])->assertRedirect('/home'); - - expect(Hash::check('generated', NotifiableUser::firstOrFail()->password))->toBeTrue(); - $this->assertAuthenticated('admins'); -}); - -it('throttles magic-link code confirmation attempts', function () { - RedotAuth::panel('dashboard')->guard('admins')->features(MagicLink::make()); - - register_panel(); - - expect(Route::getRoutes()->getByName('dashboard.magic-link-code.store')->gatherMiddleware()) - ->toContain('guest:admins', 'throttle:6,1'); - - foreach (range(1, 6) as $attempt) { - $this->post('/magic-link/code', ['email' => 'admin@example.com', 'code' => '000000'])->assertRedirect(); - } - - $this->post('/magic-link/code', ['email' => 'admin@example.com', 'code' => '000000'])->assertStatus(429); -}); - -it('throttles magic-link requests for unknown identifiers too', function () { - RedotAuth::panel('dashboard')->guard('admins')->features(MagicLink::make()->throttle(3, 3600)); - - register_panel(); - - foreach (range(1, 3) as $attempt) { - $this->post('/magic-link', ['email' => 'unknown@example.com'])->assertSessionHasNoErrors(); - } - - $this->post('/magic-link', ['email' => 'unknown@example.com']) - ->assertInvalid(['email' => 'Too many attempts. Please try again in 1 hour.']); -}); - -it('falls back to the auth config for magic-link settings the panel leaves unset', function () { - config()->set('auth.magic_link', ['expire' => 30, 'throttle' => ['max_attempts' => 2, 'decay_minutes' => 10]]); - - $configured = MagicLink::make(); - $overridden = MagicLink::make()->expiresIn(5)->throttle(9, 120); - - expect([$configured->getExpiresIn(), $configured->getMaxAttempts(), $configured->getDecaySeconds()])->toBe([30, 2, 600]) - ->and([$overridden->getExpiresIn(), $overridden->getMaxAttempts(), $overridden->getDecaySeconds()])->toBe([5, 9, 120]); - - config()->set('auth.magic_link', null); - - expect([$configured->getExpiresIn(), $configured->getMaxAttempts(), $configured->getDecaySeconds()])->toBe([15, 5, 3600]); -}); - -it('signs in with a magic-link code and clears the request throttle', function () { - Notification::fake(); - - RedotAuth::panel('dashboard')->guard('admins')->features(MagicLink::make()->expiresIn(30)); - - register_panel(); - - $user = NotifiableUser::create(['email' => 'admin@example.com']); - - foreach (range(1, 5) as $attempt) { - $this->post('/magic-link', ['email' => 'admin@example.com'])->assertSessionHasNoErrors(); - } - - $this->post('/magic-link', ['email' => 'admin@example.com'])->assertInvalid(['email' => 'Too many attempts']); - - // Codes are hashed at rest, so grab the plaintext code from the sent notification. - $code = null; - - Notification::assertSentTo($user, MagicLinkNotification::class, function (MagicLinkNotification $notification) use (&$code) { - $code = $notification->loginToken->code; - - return $notification->expiresIn === 30 - && $notification->url === route('dashboard.magic-link.verify', ['token' => $notification->loginToken->token]); - }); - - $this->post('/magic-link/code', ['email' => 'admin@example.com', 'code' => $code])->assertRedirect('/home'); - - $this->assertAuthenticated('admins'); - - auth('admins')->logout(); - - $this->post('/magic-link', ['email' => 'admin@example.com']) - ->assertSessionHasNoErrors() - ->assertRedirect(route('dashboard.magic-link-code.create', ['email' => base64_encode('admin@example.com')])); -}); - -it('locks the session and the protected middleware groups until the password is re-entered', function () { - RedotAuth::panel('dashboard')->guard('admins')->features(LockScreen::make()->protect('web'), Logout::make()); - RedotAuth::protectLockedGroups(); - - register_panel(); - - Route::middleware(['web', 'auth:admins'])->get('/secret', fn () => 'secret'); - - $user = NotifiableUser::create(['email' => 'admin@example.com', 'password' => Hash::make('secret')]); - - $this->actingAs($user, 'admins')->post('/lock')->assertRedirect('/unlock'); - $this->get('/secret')->assertRedirect('/unlock'); - - $this->post('/unlock', ['password' => 'wrong'])->assertInvalid('password'); - $this->post('/unlock', ['password' => 'secret'])->assertRedirect(); - $this->get('/secret')->assertOk(); - - $this->post('/lock'); - $this->post('/logout')->assertRedirect('/home'); - $this->assertGuest('admins'); -}); - -it('throttles unlock attempts', function () { - RedotAuth::panel('dashboard')->guard('admins')->features(LockScreen::make()); - - register_panel(); - - $user = NotifiableUser::create(['email' => 'admin@example.com', 'password' => Hash::make('secret')]); - - $this->actingAs($user, 'admins')->post('/lock'); - - foreach (range(1, 6) as $attempt) { - $this->post('/unlock', ['password' => 'wrong'])->assertInvalid('password'); - } - - $this->post('/unlock', ['password' => 'wrong'])->assertStatus(429); -}); - -it('issues and revokes bearer tokens on api panels', function () { - $this->artisan('migrate', ['--path' => dirname(__DIR__, 4) . '/vendor/laravel/sanctum/database/migrations', '--realpath' => true]); - config()->set('auth.providers.admins.model', ApiUser::class); - - RedotAuth::panel('api')->guard('admins-api')->api()->features( - Login::make(), - Registration::make(), - Logout::make(), - ); - - register_panel('api', 'api.'); - - $this->postJson('/register', ['email' => 'new@example.com', 'password' => 'Secret-123', 'password_confirmation' => 'Secret-123']) - ->assertCreated() - ->assertJsonPath('payload.token_type', 'Bearer'); - - $token = $this->postJson('/login', ['email' => 'new@example.com', 'password' => 'Secret-123']) - ->assertOk() - ->json('payload.token'); - - $this->withToken($token)->deleteJson('/logout')->assertOk(); - - expect(ApiUser::firstOrFail()->tokens()->count())->toBe(1); -}); - -it('protects every listed middleware group on the application kernel', function () { - RedotAuth::panel('dashboard')->guard('admins')->features(LockScreen::make()->protect('web', 'api')); - RedotAuth::protectLockedGroups(); - - $locked = Locked::using('admins'); - - expect(Route::getMiddlewareGroups()['web'])->toContain($locked) - ->and(Route::getMiddlewareGroups()['api'])->toContain($locked) - ->and(app(Kernel::class)->getMiddlewareGroups()['web'])->toContain($locked); -}); - -it('redirects to the unlock route of the panel that locked the session', function () { - RedotAuth::panel('dashboard')->guard('admins')->features(LockScreen::make()->protect('web')); - RedotAuth::protectLockedGroups(); - - Route::middleware('web')->prefix('admin')->name('admin.')->group(fn () => RedotAuth::routes('dashboard')); - Route::middleware(['web', 'auth:admins'])->get('/secret', fn () => 'secret'); - Route::getRoutes()->refreshNameLookups(); - - $user = NotifiableUser::create(['email' => 'admin@example.com', 'password' => Hash::make('secret')]); - - $this->actingAs($user, 'admins')->post('/admin/lock')->assertRedirect('/admin/unlock'); - $this->get('/secret')->assertRedirect('/admin/unlock'); -}); - -it('drops stale locks instead of trapping the user in redirects', function (array $session) { - RedotAuth::panel('dashboard')->guard('admins')->features(LockScreen::make()->protect('web')); - RedotAuth::protectLockedGroups(); - - register_panel(); - - Route::middleware('web')->get('/open', fn () => 'open'); - - $this->withSession($session)->get('/open')->assertOk()->assertSessionMissing('auth.admins.locked'); -})->with([ - 'signed out' => [['auth.admins.locked' => 'dashboard.unlock']], - 'unknown unlock route' => [['auth.admins.locked' => 'removed.unlock']], -]); - -it('keeps the home url query when confirming a verified email', function () { - Schema::table('users', fn (Blueprint $table) => $table->timestamp('email_verified_at')->nullable()); - - RedotAuth::panel('dashboard')->guard('admins')->home(fn () => url('/home?tab=profile'))->features(EmailVerification::make()); - - register_panel(); - - $user = NotifiableUser::create(['email' => 'admin@example.com', 'email_verified_at' => now()]); - $url = URL::signedRoute('dashboard.verification.verify', ['id' => $user->id, 'hash' => sha1('admin@example.com')]); - - $this->actingAs($user, 'admins')->get($url)->assertRedirect(url('/home?tab=profile&verified=1')); -}); - -it('lets a panel replace a single response', function () { - $magicLinkSent = new class('') extends MagicLinkSentResponse - { - protected function web(Panel $panel): Response - { - return redirect('/check-your-inbox?for=' . $this->identifier); - } - }; - - $unlocked = new class extends UnlockedResponse - { - protected function web(Panel $panel): Response - { - return redirect('/welcome-back'); - } - }; - - RedotAuth::panel('dashboard') - ->guard('admins') - ->using(MagicLinkSentResponse::class, $magicLinkSent::class) - ->using(UnlockedResponse::class, $unlocked::class) - ->features(MagicLink::make(), LockScreen::make()); - - register_panel(); - - $user = NotifiableUser::create(['email' => 'admin@example.com', 'password' => Hash::make('secret')]); - - $this->post('/magic-link', ['email' => 'admin@example.com'])->assertRedirect('/check-your-inbox?for=admin@example.com'); - - $this->actingAs($user, 'admins')->post('/lock'); - $this->post('/unlock', ['password' => 'secret'])->assertRedirect('/welcome-back'); -}); - -it('refuses to protect an undefined middleware group', function () { - RedotAuth::panel('dashboard')->guard('admins')->features(LockScreen::make()->protect('missing')); - - RedotAuth::protectLockedGroups(); -})->throws(InvalidArgumentException::class, 'The [missing] middleware group has not been defined.'); diff --git a/tests/Unit/Packages/Datatables/ActionTest.php b/tests/Unit/Packages/Datatables/ActionTest.php deleted file mode 100644 index 5899966..0000000 --- a/tests/Unit/Packages/Datatables/ActionTest.php +++ /dev/null @@ -1,155 +0,0 @@ -method('trace'); -})->throws(InvalidArgumentException::class, 'Invalid method provided "trace"'); - -it('builds confirmable get actions with a confirm attribute', function () { - Route::name('admins.export')->get('/admins/export', fn () => 'export'); - - $action = Action::make('Export')->route('admins.export', bounded: false)->confirmable(); - - $attributes = $action->buildAttributes(new EmptyModel)->getAttributes(); - - expect($attributes['method'])->toBe('get') - ->and($attributes)->toHaveKey('confirm'); -}); - -it('rejects combining confirmable with lightbox when attributes are built', function () { - Action::make('View')->lightbox()->confirmable()->buildAttributes(new EmptyModel); -})->throws(InvalidArgumentException::class, 'Confirmable actions cannot be combined with lightbox.'); - -it('uses an explicit href closure to compute the action url per row', function () { - $action = Action::make('Edit')->href(fn (Model $row) => '/users/' . $row->getAttribute('id') . '/edit'); - - $attributes = $action->buildAttributes(new EmptyModel(['id' => 5]))->getAttributes(); - - expect($attributes['href'])->toBe('/users/5/edit'); -}); - -it('resolves the href and method from a named route binding the row as the first parameter', function () { - Route::name('admins.edit')->get('/admins/{user}/edit', fn () => 'edit'); - - $action = Action::make('Edit')->route('admins.edit')->method('post'); - - $attributes = $action->buildAttributes(new EmptyModel(['id' => 12]))->getAttributes(); - - expect($attributes['href'])->toContain('/admins/12/edit') - ->and($attributes['method'])->toBe('post'); -}); - -it('opens links in a new tab when newTab is enabled', function () { - $action = Action::make('Open')->href('/anywhere')->newTab(); - - expect($action->buildAttributes(new EmptyModel)->getAttributes()) - ->toMatchArray(['target' => '_blank']); -}); - -it('opens links in a lightbox when lightbox is enabled', function () { - $action = Action::make('View')->href('/anywhere')->lightbox(); - - expect($action->buildAttributes(new EmptyModel)->getAttributes()) - ->toMatchArray(['data-lightbox' => '', 'data-type' => 'iframe']); -}); - -it('renders only when the visible flag is set and the condition callback returns true', function () { - $row = new EmptyModel(['active' => false]); - - $visible = Action::make('Edit'); - $conditionFails = Action::make('Edit')->condition(fn ($row) => $row->getAttribute('active')); - $hidden = Action::make('Edit')->hidden(); - - expect($visible->shouldRender($row))->toBeTrue() - ->and($conditionFails->shouldRender($row))->toBeFalse() - ->and($hidden->shouldRender($row))->toBeFalse(); -}); - -it('exposes a delete factory that defaults to a confirmable delete request', function () { - Route::name('admins.destroy')->delete('/admins/{user}', fn () => 'destroy'); - - $action = Action::delete('admins.destroy'); - - $attributes = $action->buildAttributes(new EmptyModel(['id' => 7]))->getAttributes(); - - expect($attributes['method'])->toBe('delete') - ->and($attributes)->toHaveKey('confirm'); -}); - -it('flags grouped actions and renders the group only when at least one child can render', function () { - $row = new EmptyModel(['id' => 1]); - - $visible = Action::make('Visible'); - $hidden = Action::make('Hidden')->hidden(); - - $populatedGroup = ActionGroup::make('More')->actions([$visible, $hidden]); - $emptyGroup = ActionGroup::make('Hidden Only')->actions([Action::make('Hidden Too')->hidden()]); - - expect($populatedGroup->shouldRender($row))->toBeTrue() - ->and($emptyGroup->shouldRender($row))->toBeFalse(); -}); - -it('rejects empty inline action names at configuration time', function () { - Action::make('Approve')->action(' ', fn () => null); -})->throws(InvalidArgumentException::class, 'Inline action requires a non-empty name.'); - -it('rejects combining inline actions with route or href when attributes are built', function () { - Action::make('Approve') - ->route('admins.edit') - ->action('approve', fn () => null) - ->buildAttributes(new EmptyModel(['id' => 1])); -})->throws(InvalidArgumentException::class, 'Inline actions cannot be combined with route or href.'); - -it('builds inline action attributes for livewire execution', function () { - $action = Action::make('Approve', 'ti ti-check') - ->action('approve', fn () => null) - ->confirmable(message: 'Are you sure?'); - - $attributes = $action->buildAttributes(new EmptyModel(['id' => 9]))->getAttributes(); - - expect($attributes['href'])->toBe('#') - ->and($attributes['action-name'])->toBe('approve') - ->and($attributes['action-key'])->toBe(9) - ->and($attributes)->not->toHaveKey('method') - ->and($attributes['confirm'])->toBe('Are you sure?'); -}); - -it('finds grouped actions by their unique name', function () { - $group = ActionGroup::make('More')->actions([ - Action::make('Approve')->action('approve', fn () => null), - Action::make('Archive')->action('archive', fn () => null), - ]); - - expect($group->find('archive')?->label)->toBe('Archive') - ->and($group->find('missing'))->toBeNull(); -}); - -it('copies the group with the given actions without touching the original', function () { - $approve = Action::make('Approve'); - $hidden = Action::make('Hidden')->hidden(); - $group = ActionGroup::make('More')->actions([$approve, $hidden]); - - $copy = $group->withActions([$approve]); - - expect($copy)->not->toBe($group) - ->and($copy->actions)->toBe([$approve]) - ->and($group->actions)->toBe([$approve, $hidden]); -}); - -it('keeps short action lists inline and folds longer lists into a dropdown group', function () { - $short = [Action::make('One'), Action::make('Two'), Action::make('Three')]; - $long = [...$short, Action::make('Four')]; - - $inline = ActionGroup::auto($short); - $folded = ActionGroup::auto($long, 'More'); - - expect($inline)->toBe($short) - ->and($folded)->toHaveCount(3) - ->and($folded[2])->toBeInstanceOf(ActionGroup::class) - ->and($folded[2]->actions)->toHaveCount(2); -}); diff --git a/tests/Unit/Packages/Datatables/BulkActionTest.php b/tests/Unit/Packages/Datatables/BulkActionTest.php deleted file mode 100644 index 77271b3..0000000 --- a/tests/Unit/Packages/Datatables/BulkActionTest.php +++ /dev/null @@ -1,44 +0,0 @@ -action('approve', fn () => null) - ->confirmable(message: 'Are you sure?'); - - $attributes = $action->buildAttributes()->getAttributes(); - - expect($attributes['href'])->toBe('#') - ->and($attributes['action-name'])->toBe('approve') - ->and($attributes['action-scope'])->toBe('bulk') - ->and($attributes)->not->toHaveKey('action-key') - ->and($attributes['confirm'])->toBe('Are you sure?'); -}); - -it('names the request key carrying the selection on route driven bulk actions', function () { - Route::name('posts.bulk-destroy')->delete('/posts', fn () => 'destroy'); - - $action = BulkAction::delete('posts.bulk-destroy'); - - $attributes = $action->buildAttributes()->getAttributes(); - - expect($attributes['method'])->toBe('delete') - ->and($attributes['bulk-keys'])->toBe('keys') - ->and(json_decode(base64_decode($attributes['request-body']), true))->toBe([]); -}); - -it('marks a get bulk action so the selection can be appended to the query string', function () { - Route::name('posts.bulk-export')->get('/posts/export', fn () => 'export'); - - $attributes = BulkAction::make('Export', 'ti ti-file-export') - ->route('posts.bulk-export') - ->keys('ids') - ->buildAttributes() - ->getAttributes(); - - expect($attributes['method'])->toBe('get') - ->and($attributes['bulk-keys'])->toBe('ids') - ->and($attributes['href'])->toContain('/posts/export'); -}); diff --git a/tests/Unit/Packages/Datatables/ColumnTest.php b/tests/Unit/Packages/Datatables/ColumnTest.php deleted file mode 100644 index 09115a1..0000000 --- a/tests/Unit/Packages/Datatables/ColumnTest.php +++ /dev/null @@ -1,234 +0,0 @@ - 'Taylor', - ]); - - expect(Column::make('name')->get($row))->toBe('<strong>Taylor</strong>'); -}); - -it('preserves the original value when the column is explicitly marked as html', function () { - $row = new EmptyModel([ - 'name' => 'Taylor', - ]); - - expect(Column::make('name')->html()->get($row))->toBe('Taylor'); -}); - -it('uses the configured default value for nameless columns that have no attribute to read', function () { - $row = new EmptyModel; - - expect(Column::make()->default('static')->get($row))->toBe('static'); -}); - -it('runs the supplied getter closure to transform the raw value before output', function () { - $row = new EmptyModel([ - 'email' => 'taylor@example.com', - ]); - - $value = Column::make('email') - ->getter(fn (string $email) => strtoupper($email)) - ->get($row); - - expect($value)->toBe('TAYLOR@EXAMPLE.COM'); -}); - -it('returns the placeholder string when the resolved value is null', function () { - $row = new EmptyModel; - - expect(Column::make('missing_attribute')->empty('—')->get($row))->toBe('—'); -}); - -it('returns the actual unescaped value when requested explicitly', function () { - $row = new EmptyModel([ - 'name' => 'Taylor', - ]); - - expect(Column::make('name')->get($row, raw: true))->toBe('Taylor'); -}); - -it('returns the actual value before applying column display formatting', function () { - $row = new EmptyModel([ - 'amount' => 1234.5, - ]); - - $column = NumericColumn::make('amount')->precision(2); - - expect($column->get($row))->toBe('1,234.50') - ->and($column->get($row, raw: true))->toBe(1234.5); -}); - -it('wraps emails into mailto anchors when the email modifier is set', function () { - $row = new EmptyModel([ - 'email' => 'taylor@example.com', - ]); - - expect(TextColumn::make('email')->email()->get($row)) - ->toBe('taylor@example.com'); -}); - -it('returns email text without the mailto anchor when the actual value is requested', function () { - $row = new EmptyModel([ - 'email' => 'taylor@example.com', - ]); - - expect(TextColumn::make('email')->email()->get($row, raw: true)) - ->toBe('taylor@example.com'); -}); - -it('truncates long text values to the configured character limit', function () { - $row = new EmptyModel(['name' => str_repeat('a', 50)]); - - expect(TextColumn::make('name')->truncate(10)->get($row))->toBe('aaaaaaaaaa...'); -}); - -it('escapes the value inside email anchors to prevent stored xss', function () { - $row = new EmptyModel([ - 'email' => '">@x.com', - ]); - - $value = TextColumn::make('email')->email()->get($row); - - expect($value)->not->toContain('and($value)->toBe(sprintf( - '%1$s', - e('">@x.com'), - )); -}); - -it('escapes the value inside phone anchors to prevent stored xss', function () { - $row = new EmptyModel([ - 'phone' => '', - ]); - - expect(TextColumn::make('phone')->phone()->get($row))->not->toContain('', - ]); - - $value = TextColumn::make('website')->url()->get($row); - - expect($value)->not->toContain('']); - - expect(IconColumn::make('icon')->get($row))->not->toContain('', 'safe']]); - - $value = TagsColumn::make('tags')->get($row); - - expect($value)->not->toContain('