Give Laravel docs their own top-level nav section

The flat sidebar array was shown on every page regardless of section, and kept growing as Laravel-specific pages (Eloquent casting, Livewire, #[WhenLoaded]) got added under "Features" alongside framework-agnostic content — Laravel content ended up scattered across three different places (Features, Integrations, Attributes) with no single home.

Moved features/laravel.md, features/eloquent-casting.md, and features/livewire.md into docs/laravel/, added a top-level "Laravel" nav entry, and converted the sidebar config from a flat array into a path-keyed object so /laravel/* pages get their own compact 4-item sidebar (Overview, Eloquent Attribute Casting, Livewire Integration, #[WhenLoaded]) instead of the full ~40-entry list. #[WhenLoaded] is now an explicit sidebar entry in that section, not just a prose link buried in the fromModel() docs.

Fixed a resulting break in the custom Breadcrumb.vue component, which assumed theme.sidebar was always a flat array — it now resolves the current page's group via the same longest-prefix-match VitePress itself uses for multi-sidebars.

Folded the Octane/long-running-workers note from integrations/laravel.md into the new laravel/index.md, since that page's content is otherwise now fully covered by the consolidated section; integrations/laravel.md stays as the short per-framework quickstart entry (parallel to Plain PHP/Symfony/PSR-7) and points into /laravel/ for the full reference.

Updated every internal link that pointed at the old features/laravel.md path (guide/quick-start.md, attributes/when-loaded.md, integrations/laravel.md, and two published-docs URLs in CHANGELOG.md).

Author: yuriizee

CHANGELOG.md

@@ -19,7 +19,7 @@ and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.
   `#[Discriminator]` class as the cast target. Fully decoupled, like
   `HasLaravelIntegration` and `WireableData`: no dependency on
   `illuminate/database`. See
-  [Eloquent Attribute Casting](https://std-out.github.io/simple-data-objects/features/eloquent-casting).
+  [Eloquent Attribute Casting](https://std-out.github.io/simple-data-objects/laravel/eloquent-casting).
 - **`#[WhenLoaded]`.** `fromModel()` now hydrates from `$model->attributesToArray()`
   (no relations) and adds a relation only when its property is marked
   `#[WhenLoaded('relationName')]` and the relation is actually loaded;
@@ -39,7 +39,7 @@ and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.
   so the trait's methods already satisfy it structurally. The consuming
   class adds `implements \Livewire\Wireable` itself, which is the only
   place `livewire/livewire` needs to be installed. See
-  [Livewire Integration](https://std-out.github.io/simple-data-objects/features/livewire).
+  [Livewire Integration](https://std-out.github.io/simple-data-objects/laravel/livewire).
 
 ## [1.14.0] — 2026-07-25
 

docs/.vitepress/config.mjs

@@ -37,83 +37,95 @@ export default defineConfig({
     nav: [
       { text: 'Guide', link: '/guide/installation' },
       { text: 'Features', link: '/features/hydration' },
+      { text: 'Laravel', link: '/laravel/' },
       { text: 'Casts', link: '/casts/' },
       {
         text: 'GitHub',
         link: 'https://github.com/std-out/simple-data-objects',
       },
     ],
 
-    sidebar: [
-      {
-        text: 'Getting Started',
-        items: [
-          { text: 'Introduction', link: '/guide/introduction' },
-          { text: 'Installation', link: '/guide/installation' },
-          { text: 'Quick Start', link: '/guide/quick-start' },
-          { text: 'Performance', link: '/guide/performance' },
-        ],
-      },
-      {
-        text: 'Features',
-        items: [
-          { text: 'Hydration', link: '/features/hydration' },
-          { text: 'Serialization', link: '/features/serialization' },
-          { text: 'Validation', link: '/features/validation' },
-          { text: 'DataPipe — Preprocessing', link: '/features/pipes' },
-          { text: 'Immutable Copies — with()', link: '/features/with' },
-          { text: 'Comparison — equals() & diff()', link: '/features/comparison' },
-          { text: 'Collections', link: '/features/collections' },
-          { text: 'Laravel Integration', link: '/features/laravel' },
-          { text: 'Eloquent Attribute Casting', link: '/features/eloquent-casting' },
-          { text: 'Livewire Integration', link: '/features/livewire' },
-          { text: 'Metadata Cache', link: '/features/cache' },
-        ],
-      },
-      {
-        text: 'Integrations',
-        items: [
-          { text: 'Plain PHP', link: '/integrations/plain-php' },
-          { text: 'Laravel', link: '/integrations/laravel' },
-          { text: 'Symfony', link: '/integrations/symfony' },
-          { text: 'Slim & PSR-7', link: '/integrations/psr-7' },
-        ],
-      },
-      {
-        text: 'Attributes',
-        items: [
-          { text: 'Overview', link: '/attributes/' },
-          { text: '#[Cast]', link: '/attributes/cast' },
-          { text: '#[Rules]', link: '/attributes/rules' },
-          { text: '#[Pipe]', link: '/attributes/pipe' },
-          { text: '#[Flatten]', link: '/attributes/flatten' },
-          { text: '#[Hidden]', link: '/attributes/hidden' },
-          { text: '#[IgnoreIfNull]', link: '/attributes/ignore-if-null' },
-          { text: '#[MapPropertyName]', link: '/attributes/map-property-name' },
-          { text: '#[TransformKeys]', link: '/attributes/transform-keys' },
-          { text: '#[Discriminator]', link: '/attributes/discriminator' },
-          { text: '#[DataCollection]', link: '/attributes/data-collection' },
-          { text: '#[WhenLoaded]', link: '/attributes/when-loaded' },
-        ],
-      },
-      {
-        text: 'Built-in Casts',
-        items: [
-          { text: 'Overview', link: '/casts/' },
-          { text: 'DateTimeCast', link: '/casts/date-time' },
-          { text: 'EnumCast', link: '/casts/enum' },
-          { text: 'BooleanCast', link: '/casts/boolean' },
-          { text: 'IntegerCast & FloatCast', link: '/casts/numeric' },
-          { text: 'TrimCast', link: '/casts/trim' },
-          { text: 'JsonCast', link: '/casts/json' },
-          { text: 'EncryptedCast', link: '/casts/encrypted' },
-          { text: 'UuidCast', link: '/casts/uuid' },
-          { text: 'CommaSeparatedCast', link: '/casts/comma-separated' },
-          { text: 'MoneyCast', link: '/casts/money' },
-          { text: 'Custom Casts', link: '/casts/custom' },
-        ],
-      },
-    ],
+    sidebar: {
+      '/laravel/': [
+        {
+          text: 'Laravel',
+          items: [
+            { text: 'Overview', link: '/laravel/' },
+            { text: 'Eloquent Attribute Casting', link: '/laravel/eloquent-casting' },
+            { text: 'Livewire Integration', link: '/laravel/livewire' },
+            { text: '#[WhenLoaded]', link: '/attributes/when-loaded' },
+          ],
+        },
+      ],
+
+      '/': [
+        {
+          text: 'Getting Started',
+          items: [
+            { text: 'Introduction', link: '/guide/introduction' },
+            { text: 'Installation', link: '/guide/installation' },
+            { text: 'Quick Start', link: '/guide/quick-start' },
+            { text: 'Performance', link: '/guide/performance' },
+          ],
+        },
+        {
+          text: 'Features',
+          items: [
+            { text: 'Hydration', link: '/features/hydration' },
+            { text: 'Serialization', link: '/features/serialization' },
+            { text: 'Validation', link: '/features/validation' },
+            { text: 'DataPipe — Preprocessing', link: '/features/pipes' },
+            { text: 'Immutable Copies — with()', link: '/features/with' },
+            { text: 'Comparison — equals() & diff()', link: '/features/comparison' },
+            { text: 'Collections', link: '/features/collections' },
+            { text: 'Metadata Cache', link: '/features/cache' },
+          ],
+        },
+        {
+          text: 'Integrations',
+          items: [
+            { text: 'Plain PHP', link: '/integrations/plain-php' },
+            { text: 'Laravel', link: '/integrations/laravel' },
+            { text: 'Symfony', link: '/integrations/symfony' },
+            { text: 'Slim & PSR-7', link: '/integrations/psr-7' },
+          ],
+        },
+        {
+          text: 'Attributes',
+          items: [
+            { text: 'Overview', link: '/attributes/' },
+            { text: '#[Cast]', link: '/attributes/cast' },
+            { text: '#[Rules]', link: '/attributes/rules' },
+            { text: '#[Pipe]', link: '/attributes/pipe' },
+            { text: '#[Flatten]', link: '/attributes/flatten' },
+            { text: '#[Hidden]', link: '/attributes/hidden' },
+            { text: '#[IgnoreIfNull]', link: '/attributes/ignore-if-null' },
+            { text: '#[MapPropertyName]', link: '/attributes/map-property-name' },
+            { text: '#[TransformKeys]', link: '/attributes/transform-keys' },
+            { text: '#[Discriminator]', link: '/attributes/discriminator' },
+            { text: '#[DataCollection]', link: '/attributes/data-collection' },
+            { text: '#[WhenLoaded]', link: '/attributes/when-loaded' },
+          ],
+        },
+        {
+          text: 'Built-in Casts',
+          items: [
+            { text: 'Overview', link: '/casts/' },
+            { text: 'DateTimeCast', link: '/casts/date-time' },
+            { text: 'EnumCast', link: '/casts/enum' },
+            { text: 'BooleanCast', link: '/casts/boolean' },
+            { text: 'IntegerCast & FloatCast', link: '/casts/numeric' },
+            { text: 'TrimCast', link: '/casts/trim' },
+            { text: 'JsonCast', link: '/casts/json' },
+            { text: 'EncryptedCast', link: '/casts/encrypted' },
+            { text: 'UuidCast', link: '/casts/uuid' },
+            { text: 'CommaSeparatedCast', link: '/casts/comma-separated' },
+            { text: 'MoneyCast', link: '/casts/money' },
+            { text: 'Custom Casts', link: '/casts/custom' },
+          ],
+        },
+      ],
+    },
 
     socialLinks: [
       { icon: 'github', link: 'https://github.com/std-out/simple-data-objects' },

docs/.vitepress/theme/Breadcrumb.vue

@@ -18,7 +18,19 @@ const trail = computed(() => {
   const section = segment.charAt(0).toUpperCase() + segment.slice(1)
 
   const link = '/' + path.replace(/(index)?\.md$/, '')
-  const group = (theme.value.sidebar ?? []).find((g) =>
+
+  // sidebar may be a flat array or a multi-sidebar object keyed by path
+  // prefix — resolve it the same way VitePress does: the most specific
+  // (longest) matching prefix wins.
+  const rawSidebar = theme.value.sidebar
+  const groups = Array.isArray(rawSidebar)
+    ? rawSidebar
+    : Object.keys(rawSidebar ?? {})
+        .filter((prefix) => link.startsWith(prefix))
+        .sort((a, b) => b.length - a.length)
+        .flatMap((prefix) => rawSidebar[prefix] ?? [])
+
+  const group = groups.find((g) =>
     g.items?.some((item) => item.link === link || item.link + '/' === link),
   )?.text
 

docs/attributes/when-loaded.md

@@ -1,6 +1,6 @@
 # #[WhenLoaded]
 
-Includes an Eloquent relation in `fromModel()` hydration only when that relation is actually loaded on the model. Requires [`HasLaravelIntegration`](../features/laravel.md).
+Includes an Eloquent relation in `fromModel()` hydration only when that relation is actually loaded on the model. Requires [`HasLaravelIntegration`](../laravel/index.md).
 
 ## Syntax
 

docs/guide/quick-start.md

@@ -134,4 +134,4 @@ $updated->email; // 'newemail@example.com'
 - [Hydration →](../features/hydration.md) — all input formats, enums, nested DTOs
 - [Cast System →](../casts/index.md) — built-in and custom casts
 - [Validation →](../features/validation.md) — full Laravel rule support
-- [Laravel Integration →](../features/laravel.md) — `fromRequest()`, `fromModel()`, `toResponse()`
+- [Laravel Integration →](../laravel/index.md) — `fromRequest()`, `fromModel()`, `toResponse()`

docs/integrations/laravel.md

@@ -39,7 +39,7 @@ $order = OrderData::fromModel($orderModel);
 $order = OrderData::from($orderModel);       // same thing — from() understands models
 ```
 
-See [Laravel Integration](../features/laravel.md) for the full trait reference and [Validation](../features/validation.md) for `#[Rules]`.
+See the [Laravel section](../laravel/index.md) for the full trait reference, [Eloquent attribute casting](../laravel/eloquent-casting.md), and [Livewire integration](../laravel/livewire.md), and [Validation](../features/validation.md) for `#[Rules]`.
 
 ## Deploy
 

docs/features/eloquent-casting.md docs/laravel/eloquent-casting.mddocs/features/eloquent-casting.md renamed to docs/laravel/eloquent-casting.md

@@ -149,8 +149,8 @@ Add it wherever your other build-time steps live — a Forge/Envoyer deploy
 script, a Vapor build hook, or a CI job — right before workers restart, so
 every worker starts from an already-compiled cache instead of building it
 on the first request it happens to serve. See [Metadata
-Cache](./cache.md#pre-warming-on-deploy) for what the command actually
-scans and writes, and [opcache.preload](./cache.md#going-further-opcachepreload)
+Cache](../features/cache.md#pre-warming-on-deploy) for what the command actually
+scans and writes, and [opcache.preload](../features/cache.md#going-further-opcachepreload)
 to skip the file-read cost too.
 
 ### 3. Clear it on rollback
@@ -161,3 +161,10 @@ php artisan tinker --execute="StdOut\SimpleDataObjects\Support\MetadataRegistry:
 
 Run this whenever DTO classes or their attributes change between deploys —
 a stale cache entry keeps serving the old compiled shape otherwise.
+
+## Octane / Long-Running Workers
+
+Nothing to configure: metadata and compiled closures live in per-worker
+static caches, so after the first request each worker runs entirely from
+memory. The validator factory is resolved from the container per call, so
+container rebinds between requests are picked up correctly.

docs/features/laravel.md docs/laravel/index.mddocs/features/laravel.md renamed to docs/laravel/index.md

@@ -56,7 +56,7 @@ class Counter extends Component
 
 ## Combining with Laravel Integration
 
-`WireableData` and [`HasLaravelIntegration`](./laravel.md) are independent traits — use either, both, or neither on a given class:
+`WireableData` and [`HasLaravelIntegration`](./index.md) are independent traits — use either, both, or neither on a given class:
 
 ```php
 class OrderData extends BaseData implements \Livewire\Wireable