@pilotiq/pilotiq 0.7.2 → 0.8.1

package/.turbo/turbo-build.log

@@ -1,8 +1,8 @@
 
-> @pilotiq/pilotiq@0.7.2 build /home/runner/work/pilotiq/pilotiq/packages/pilotiq
+> @pilotiq/pilotiq@0.8.1 build /home/runner/work/pilotiq/pilotiq/packages/pilotiq
 > tsc -p tsconfig.build.json && pnpm run copy-assets
 
 
-> @pilotiq/pilotiq@0.7.2 copy-assets /home/runner/work/pilotiq/pilotiq/packages/pilotiq
+> @pilotiq/pilotiq@0.8.1 copy-assets /home/runner/work/pilotiq/pilotiq/packages/pilotiq
 > mkdir -p dist/styles && cp -R src/styles/*.css dist/styles/
 

package/CHANGELOG.md

@@ -1,5 +1,213 @@
 # @pilotiq/pilotiq
 
+## 0.8.1
+
+### Patch Changes
+
+- cc7a292: fix(pilotiq): wire `FormStateProvider` through `FormCollabBinding` (Phase F2)
+
+  The F1 registry slot from 0.8.0 was inert — nothing in pilotiq core
+  consumed `FormCollabBinding`. This patch makes the wiring actually
+  fire: when a `<RecordCollabRoom>` is mounted up-tree AND a plugin
+  (e.g. `@pilotiq-pro/collab@0.1`) registered a binding factory,
+  `FormStateProvider` now:
+
+  1. **Mounts on collab activity, not just `stateUrl`.** `FormRenderer`'s
+     `useControlled` gate widens from `!!stateUrl` to
+     `!!stateUrl || collabActive`. Forms with zero `.live()` fields but
+     a record-edit collab room get the controlled path so every
+     `useFieldState(name)` consumer (TextInput / Select / Toggle /
+     Date / Slider / …) becomes synchronizable.
+
+  2. **Constructs a binding on mount.** Calls the registered factory
+     with `{ room, formId, initial }`. The binding owns the CRDT
+     storage (typically a `Y.Map` on the room's shared ydoc) — pilotiq
+     stays Yjs-free.
+
+  3. **Lifts already-synced state.** On mount, `binding.get()`'s
+     snapshot is shallow-merged on top of the SSR-rendered defaults,
+     so subsequent joiners see the room's authoritative state.
+
+  4. **Subscribes to remote changes.** `binding.subscribe(snapshot)`
+     fires on every Yjs transaction (local + remote). Per-key
+     `Object.is` short-circuit collapses local-write echoes into
+     no-op renders; remote changes flow through `setValuesState` into
+     the controlled inputs.
+
+  5. **Proxies `setValue` through the binding.** Every controlled
+     write fires `binding.set(name, value)` after the local React
+     state update — UNLESS the field opted out via `Field.collab(false)`
+     OR the name is a dotted path (Repeater / Builder row leaves stay
+     local-only in v1; Phase F.5 tackles `Y.Array<Y.Map>` row identity).
+
+  6. **Forwards server-derived values through the binding.** When a
+     `.live()` POST response carries `values`, the derived fields
+     (e.g. auto-`slug` from `title`) also write through the binding so
+     every peer sees the derivation without each peer roundtripping the
+     server (Q2 from the F-phase plan).
+
+  ### Plan + decisions
+
+  `pilotiq-pro/docs/plans/collab-form-fields.md` captures the full
+  phase breakdown; the three open Q's resolved before this patch:
+
+  - **Q1** — Idempotent client-side seed (`!ymap.has(k)` per key).
+  - **Q2** — Server response writes to Y.Map (above).
+  - **Q3** — `.collab(false)` suppresses both value sync AND presence
+    (presence chips land in F4).
+
+  ### Tested
+
+  - All 2938 pilotiq tests pass.
+  - Two-window smoke test (playground): typing in `title` / changing
+    `status` in one window propagates to the other ~instantly.
+    Tiptap fields (`body` / `content`) continue to sync via their own
+    `Y.XmlFragment` selectors — non-Tiptap fields now share the same
+    `Y.Doc` via the `form-data` Y.Map managed by `@pilotiq-pro/collab`'s
+    `formCollabBinding` factory.
+
+## 0.8.0
+
+### Minor Changes
+
+- 92b99a1: feat(pilotiq): collab open-core wiring + `Field.collab()` opt-out
+
+  Three new module-singleton registries + a URL gate + a `.collab()` setter
+  on the `Field` base — the open-core scaffolding pro collab plugins (e.g.
+  `@pilotiq-pro/collab`) plug into. Pilotiq core stays Yjs-free; the
+  registries hand opaque values back and forth.
+
+  ### Registries (all exported from `@pilotiq/pilotiq/react`)
+
+  - **`CollabRoomContext`** — React context exposing the active record's
+    `{ ydoc, provider, user? }` triplet. `useCollabRoom()` returns `null`
+    when no `<RecordCollabRoom>` is mounted up-tree.
+  - **`registerCollabExtensions(factory)`** / **`getCollabExtensions()`** —
+    module slot for a `CollabExtensionFactory` that returns Tiptap-style
+    collab extensions for a given `{ ydoc, provider, fieldName, user }`.
+    Pilotiq treats the returned values as opaque `unknown[]`; the consumer
+    (typically `@pilotiq/tiptap`) spreads them into its editor.
+  - **`registerRecordWrapper(C)`** / **`getRecordWrapper()`** — module
+    slot for a record-scoped React wrapper. `AppShell` wraps every
+    record-edit page's children with the registered wrapper, scoped to
+    `{ resourceSlug, recordId }`.
+  - **`registerFormCollabBinding(factory)`** / **`getFormCollabBinding()`** —
+    module slot for a form-level CRDT binding (form-data `Y.Map` proxy);
+    consumed by `FormStateProvider` in Phase F2.
+
+  ### URL gate
+
+  - **`RecordWrapperGate`** — internal component AppShell mounts around
+    `props.children`. Parses the current path against `basePath`; when it
+    matches a `/.../:id/edit` URL AND a wrapper is registered, wraps with
+    `<Wrapper resourceSlug={slug} recordId={id}>{children}</Wrapper>`.
+    Pass-through otherwise.
+  - **`parseRecordEditUrl(currentPath, basePath)`** — pure helper exported
+    alongside. Handles bare resource edit, cluster-prefixed edits, and
+    nested-relation edits (slash-joined slug-path picks up the parent +
+    relation chain so two URLs that target different records always
+    produce different rooms downstream).
+
+  ### `Field.collab(enabled = true)`
+
+  New setter on the base class — every subclass (Text, Toggle, Select,
+  Date, Slider, …, RichText) inherits. `.collab(false)` stamps
+  `meta.collab === false`; the renderer is expected to skip the collab
+  layer entirely (no value sync, no presence chip). Absent = inherit the
+  panel default.
+
+  ### Acceptance
+
+  - Pilotiq builds + 2938 tests pass (12 new for `parseRecordEditUrl`).
+  - Consumers (e.g. `@pilotiq-pro/collab`) wire collab through these
+    registries; pilotiq core carries no Yjs / Tiptap dep.
+
+- fd06c0d: feat(pilotiq): `Pilotiq.components({ nav, header, footer })` chrome slots
+
+  Three new chrome-slot overrides let a panel swap an entire region of
+  the default layout for a custom React component, alongside the
+  existing render-hook splicing surface. Use slots when render hooks
+  can't reach far enough — slots _replace_ a whole region; hooks
+  _splice_ at named positions.
+
+  ```ts
+  import { Pilotiq } from "@pilotiq/pilotiq";
+  import { MyCustomSidebar } from "./MyCustomSidebar.tsx";
+  import { MyTopBar } from "./MyTopBar.tsx";
+  import { MyFooter } from "./MyFooter.tsx";
+
+  Pilotiq.make("admin").components({
+    nav: MyCustomSidebar,
+    header: MyTopBar,
+    footer: MyFooter,
+  });
+  ```
+
+  ### Slots
+
+  - **`nav`** — replaces the default nav tree. In `SidebarLayout`
+    that's the `<SidebarContent>` body (`<SidebarMenu>` tree); in
+    `TopbarLayout` it's the `<nav>` cluster between the brand and
+    the right-side controls. Surrounding chrome (branding header,
+    render-hook splices, footer, sign-out menu) stays.
+  - **`header`** — replaces the whole `<header>` chrome bar. In
+    `SidebarLayout` that's the top bar with search / theme / bell /
+    user menu; in `TopbarLayout` it's the whole top region including
+    the brand cluster AND the nav (setting `header` makes the `nav`
+    slot irrelevant there).
+  - **`footer`** — mounts a `<footer>` element below the main content
+    area in both layouts. Separate from the `panels::footer` render
+    hook, which keeps firing INSIDE the content area for per-page
+    trailing chrome.
+
+  ### Prop contracts
+
+  `nav` and `header` both receive `{ navigation, basePath, currentPath? }`
+  (matching `NavComponentProps` / `HeaderComponentProps`) — same
+  pre-grouped, pre-sorted nav tree the default renderers consume, so a
+  custom topbar can render its own nav inline without juggling two
+  slots. `footer` receives the minimal `{ basePath, currentPath? }`.
+
+  ### Render-hook caveat for `header`
+
+  Hooks rooted _inside_ the default header — `panels::topbar.start`,
+  `panels::topbar.end`, `panels::user-menu.before`,
+  `panels::user-menu.after` — do NOT fire when the header is replaced
+  (the surrounding container is gone). Hooks rooted outside
+  (`panels::sidebar.*`, `panels::footer`, `panels::sidebar.nav.*`) keep
+  firing. Consumers rebuilding the header can mount
+  `<RenderHookSlot name="…" hooks={panel.renderHooks} />` themselves
+  from inside the custom component to preserve the splice contract for
+  plugins.
+
+  ### Chrome components exported for rebuilding headers
+
+  `SearchTrigger`, `ThemeToggle`, `NotificationBell`,
+  `RightSidebarTrigger`, and `UserMenu` are all re-exported from
+  `@pilotiq/pilotiq/react` so a `header` slot consumer can drop the
+  default controls back in à la carte rather than reimplementing every
+  one. `HeaderComponentProps`, `FooterComponentProps`, and
+  `isNavItemActive` are also re-exported alongside the existing
+  `NavComponentProps` and `ComponentSlotRegistry`.
+
+  ### Authoring `.tsx` inside the panel module
+
+  The Vite plugin loads `app/Pilotiq/AdminPanel.ts` through `jiti` at
+  boot to harvest `cfg.components` into the build-time
+  `_components.ts` manifest. To make this play nicely with `.tsx`
+  component files alongside the panel module, the jiti loader now
+  enables JSX support (`jsx: { runtime: 'automatic' }`). Two gotchas to
+  know:
+
+  1. JSX support is enabled by default — no per-file `import React from 'react'`
+     needed when authoring `.tsx` panel-adjacent files.
+  2. jiti's resolver falls through `.js` → `.ts` but NOT `.js` → `.tsx`.
+     The import in the panel module must use the literal `.tsx`
+     extension: `import { MyCustomSidebar } from './MyCustomSidebar.tsx'`.
+     `allowImportingTsExtensions: true` in your tsconfig keeps TS happy.
+
+  See `docs/guide/component-slots.md` for the full guide.
+
 ## 0.7.2
 
 ### Patch Changes

package/CLAUDE.md

@@ -41,7 +41,16 @@ Deep notes for many of these also live in `~/.claude/projects/-Users-sleman-Proj
 - `src/sessionFilters.ts` — Tier-3 filter persistence helpers. `Resource.persistFiltersInSession = true` opts in; the GET list handler in `routes.ts` writes the active query slice (filters / `group` / `search` / `sort` / `perPage`; `page` + `tab` excluded) to `req.session` under `pilotiq:filters:<basePath>:<slug>` on every non-bare visit, and 302-redirects bare visits (zero query params) to the persisted slice. Duck-typed `req.session.get / put` (mirrors `notifications/flash.ts`) so it no-ops when `@rudderjs/session` isn't installed. Idempotent — short-circuits the `put()` when the slice deep-equals the stored value to avoid `Set-Cookie` churn on revisits. v1 = one slot per resource (all tabs share one filter slot); guide: `docs/guide/filter-persistence.md`.
 - `src/PilotiqServiceProvider.ts` — Provider + `pilotiq()` factory.
 - `src/search.ts` — Plan #12 `searchAllResources(pilotiq, query, user, opts?) → GlobalSearchResult[]`. Walks `cfg.resources` filtered by `globalSearch=true`, runs `canAccess + canViewAny` in parallel, builds a per-resource `ModelQuery` (override-or-default LIKE chain on `globallySearchableAttributes()`), `paginate(1, limitPerResource)`. Returns `[]` for queries shorter than 2 chars. Throws on a single resource silently drop its results; others still resolve. No new ORM contract — reuses the existing `paginate` from Plan #2/#6.
-- `src/pageData.ts` — Per-page-role data builders (`dashboardData, resourceIndexData, resourceCreateData, resourceEditData, resourceViewData, globalEditData, globalViewData, customPageData, formStateData, formWizardData, searchData`) + `dispatchPageData(pageContext)` switchboard. **Plan #5 `formStateData(pilotiq, scope, body, req?)`** drives partial-resolve — runs `applyStateUpdate`, re-resolves form with bound read-only `$get` (resolve-time `$set` is a no-op closure; only `afterStateUpdated` writes survive), returns `{ ok, form: FormMeta, dirty }` or 404/422. **`tagFormStateUrls(elements, urlBuilder)`** stamps `Form.withStateUrl()` only on forms with at least one `live()` descendant. **Plan #8 `formWizardData(pilotiq, scope, body, req?)`** runs `validateSchema` over the requested step's children only — returns `{ ok }` (200) or `{ ok:false, status:422, errors }`. **`tagFormWizardUrls(elements, urlBuilder)`** stamps `Form.withWizardUrl()` only on forms with a `Wizard` descendant. **Navigation tree:** `panelInfo(pilotiq, req?)` is async — flattens resources/globals/pages, resolves `navigationParentItem` refs, sorts by `navigationSort`, parallel-resolves `navigationBadge()` via `Promise.all` (errors swallow). `buildNavigation` pre-evaluates `canAccess(user)` in parallel; failed items dropped. Both rudder GET handlers AND the auto-gen Vike `+data` hook call these so SSR + SPA-nav serve identical data; renderers read from `(ctx.data ?? ctx.viewProps)`. `resolveActiveTab(elements, query, currentPath)` stamps active tab + per-tab URL + parallel-resolved badge counts before `loadTableRecords`.
+- `src/pageData.ts` — Barrel module (~480 lines) + `dispatchPageData(pageContext)` Vike `+data` switchboard. Re-exports the per-page-role builders (`dashboardData`, `resourceIndexData`, `resourceCreateData`, `resourceEditData`, `resourceViewData`, `resourceRecordPageData`, `globalEditData`, `globalViewData`, `customPageData`, `formStateData`, `formWizardData`, `formCreateOptionData`, `mentionResolveData`, `widgetData`, `searchData`, `relationManagerData`, `panelInfo`, `applyRoleHooks`, `resolvePageHooks`) + the URL-tag helpers + the fill pipeline through the `./pageData.js` import path so external callers (`routes.ts`, tests, custom dispatchers) stay stable. **Plan #5 `formStateData(pilotiq, scope, body, req?)`** drives partial-resolve — runs `applyStateUpdate`, re-resolves form with bound read-only `$get` (resolve-time `$set` is a no-op closure; only `afterStateUpdated` writes survive), returns `{ ok, form: FormMeta, dirty }` or 404/422. **`tagFormStateUrls(elements, urlBuilder)`** stamps `Form.withStateUrl()` only on forms with at least one `live()` descendant. **Plan #8 `formWizardData(pilotiq, scope, body, req?)`** runs `validateSchema` over the requested step's children only — returns `{ ok }` (200) or `{ ok:false, status:422, errors }`. **`tagFormWizardUrls(elements, urlBuilder)`** stamps `Form.withWizardUrl()` only on forms with a `Wizard` descendant. **Navigation tree:** `panelInfo(pilotiq, req?)` is async — flattens resources/globals/pages, resolves `navigationParentItem` refs, sorts by `navigationSort`, parallel-resolves `navigationBadge()` via `Promise.all` (errors swallow). `buildNavigation` pre-evaluates `canAccess(user)` in parallel; failed items dropped. Both rudder GET handlers AND the auto-gen Vike `+data` hook call these so SSR + SPA-nav serve identical data; renderers read from `(ctx.data ?? ctx.viewProps)`. `resolveActiveTab(elements, query, currentPath)` stamps active tab + per-tab URL + parallel-resolved badge counts before `loadTableRecords`.
+- `src/pageData/` — Modular page-data subtree. Split out of `pageData.ts` in 6 phases (PR #34–#39, 4,948 → 481 lines):
+  - `breadcrumbs.ts` — 16 builder helpers (home / cluster / resource×4 / global / customPage / relation×4 + prefix / nestedRelation×4 + prefix) + `RelationChainStep` type.
+  - `helpers.ts` — `userCtx` / `uploadCtx` (`SchemaContext` builders), `callPageSchema`, 12 URL-tag helpers (`tagFormActions` / `tagFormStateUrls` / `tagTableReorderUrls` / `tagTableDeferred` / `tagCellEditUrls` / `tagFormWizardUrls` / `tagFieldAiUrls` / `tagSelectCreateOptionUrls` / `tagRichTextMentionUrls` / `tagWidgetUrls` / `tagActionDispatch`), the fill pipeline (`applyFillPipeline` + `applyRelationshipRepeaterFill` + `applyRelationshipBuilderFill` + `pickChildPrimaryKey` / `pickChildForeignKey` / `findRelationshipRepeaters` / `findRelationshipBuilders` / `parseBuilderDataPayload`), `resolveServerDataElements` + `collectServerDataElements` + `ServerDataMap`, and field-walker helpers (`walkSelectFields` / `isAsyncMentionField` / `formHasLiveField` / `formHasWizard`).
+  - `navigation.ts` — `panelInfo` (entry point for chrome envelopes), the meta interfaces (`UserMenuMeta` / `DatabaseNotificationsMeta` / `RightPanelMeta` / `RightSidebarMeta` / `NavItem` / `PanelInfoRoute`), `buildNavigation` + `nestAndSort` + `RawNavItem`, the render-hook resolvers (`resolveChromeHooks` / `applyRoleHooks` / `resolvePageHooks`), and the user-menu / sidebar / notification-meta builders.
+  - `resourcePages.ts` — `dashboardData`, `resourceIndexData`, `resourceTableData`, `collectTableMetas`, `resolveActiveTab` + `findListTabs` + `buildTabUrl`, `resourceCreateData`, `resourceEditData`, `resourceViewData`, `resourceRecordPageData`.
+  - `relationPages.ts` — Plan #11 relation manager builders. Types (`RelationManagerScope` / `RelationManagerResult` / `ResolvedChain`), lookup helpers (`findRelatedResource` / `findManager` / `childBelongsToParent` for IDOR), auto-wiring (`autoWireManagerTable` / `injectManagerTrashedFilter` / `autoWireManagerForm` / `safePolicy` / `safeManagerPolicy`), depth-1 builders (`relationManagerData` + `buildRelation*Data`), depth-2 chain resolution + builders (`resolveRelationChain` + `nestedRelationManagerData` + `nestedManagerCtx` + `nestedResponseEnvelope` + `buildNestedRelation*Data`).
+  - `relationTabs.ts` — `buildRelationTabs` (depth 1) + `buildNestedRelationTabs` (depth 2) + `deriveParentTitle` + `safeBool`. Lives in its own module because both `resourcePages.ts` (parent record view/edit strip) AND `relationPages.ts` (nested-tab strip on record manager pages) consume them — keeps the resource ↔ relation sibling import graph acyclic.
+  - `forms.ts` — Plan #5 `formStateData`, Plan #8 `formWizardData`, `formCreateOptionData` (SelectField inline-create), `mentionResolveData` (async-mention typeahead), plus per-builder helpers (`stepHookErrorMessage` / `findSelectFieldByName` / `isMentionResolverField` / `findRichTextFieldByName` / `stripRepeaterRowPrefix` / `stripBuilderRowPrefix`) and 9 wire-shape types.
+  - `misc.ts` — `globalEditData`, `globalViewData`, `customPageData`, `widgetData` (Plan #15 widget polling) + `findWidgetById`, `searchData` (Plan #12 global search), plus the `WidgetScope` / `WidgetRequest` / `WidgetSuccess` / `WidgetFailure` wire-shape types.
 - `src/routes.ts` — `registerPilotiqRoutes()` using `view()`. Each GET handler delegates to `pageData.ts`; POST handlers stay here. **Plan #10 wiring:** every handler runs `checkPolicy(() => R.canX(user, …))`; failure → `forbidden(res, json)` (403 JSON or HTML). Record-aware predicates load via `R.model.find(id)` when set. 403 ≠ 401 — `Pilotiq.guard()` is the 401 layer. Routes:
   - `GET ${base}` → dashboard
   - `GET ${base}/${slug}` → resource list
@@ -91,8 +100,15 @@ Deep notes for many of these also live in `~/.claude/projects/-Users-sleman-Proj
 
   **Conditional visibility**: `.visible / .hidden / .disabled / .authorize` — rule is `boolean | (ctx) => boolean | Promise<boolean>` with `ActionVisibilityContext { record?, records?, user? }`. `Action.evaluate(ctx)` async; throws → `visible: false`. Non-row placements eval at schema-resolve. Row-placement actions defer to per-row eval in `loadTableRecords`, stamping `_visibleActions` / `_disabledActions`.
 
+- `src/actions/Action.ts` — `Action` class itself (~1,515 lines): types (`ActionContext / ActionResult / ActionHandler / ActionVisibilityContext / VisibilityRule / ResourceLike / ReplicateOptions` etc), instance fields + setters, modal chrome, link / form / submit mode wiring, `evaluate()` and `toMeta()`. Static factory methods stay on the class as thin delegators (`Action.create / .edit / .view / .delete / .replicate / .restore / .forceDelete / .markAsRead / .bulkDelete / .bulkRestore / .bulkForceDelete / .bulkReplicate / .relationCreate / .relationEdit / .relationDelete / .relationRestore / .relationForceDelete / .relationReplicate / .relationBulkReplicate / .relationAttach / .relationDetach / .relationBulkDetach`) — call sites stay stable; bodies live in the factory sub-modules. `Action.import / .export / .bulkExport` are the exceptions — their bodies stay in Action.ts since they already delegate their internals to the older `*Factory.ts` files via static + dynamic imports. Split via 4 phases (`docs/plans/action-split.md`, 2,159 → 1,515 lines).
+- `src/actions/factoryHelpers.ts` — Shared helpers consumed by every factory sub-module: `resourceBase(basePath, R)` (cluster-aware URL builder), `callPredicate(fn, user, record?)` (Plan #10 fail-open predicate caller), `isTrashed(record, R)` (soft-delete state probe), `isM2MMode(mode)` (true for `belongsToMany / morphToMany / morphedByMany`), `relationUrlPrefix(ctx)` (depth-1 + depth-2 relation URL prefix).
+- `src/actions/crudFactories.ts` — Single-row resource factories: `createAction / editAction / viewAction / deleteAction / replicateAction / restoreAction / forceDeleteAction / markAsReadAction`. Each builds an `Action` shaped by `ResourceLike`'s policy predicates + soft-delete flags.
+- `src/actions/bulkFactories.ts` — Bulk-placement factories: `bulkDeleteAction / bulkRestoreAction / bulkForceDeleteAction / bulkReplicateAction`. Handler-style — iterate `ctx.records`, run per-row policy, call matching model method, return notification with the count succeeded. Owns the phase-local `labelForCount(R, n)` helper for "1 post" / "5 posts" pluralization.
+- `src/actions/relationFactories.ts` — Relation hasMany / morph factories: `relationCreateAction / relationEditAction / relationDeleteAction / relationRestoreAction / relationForceDeleteAction` plus the replicate pair `relationReplicateAction / relationBulkReplicateAction`. Replicate helpers (`computeRelationPin / persistRelationReplica / runRelationReplicateRow`) are private to this file — they force-pin the parent attachment columns (`<foreignKey>` for hasMany; `<morphName>Id` + `<morphName>Type` for morphMany via `computeMorphPayload`) AFTER the strip + BEFORE `beforeReplicaSaved`, so a tampered source row can't slip a different parent in. All factories auto-hide under M2M (factories deferred to `m2mFactories.ts`) and under `morphTo` (child-side polymorphic — no single owner to pin to).
+- `src/actions/m2mFactories.ts` — Pivot factories: `relationAttachAction / relationDetachAction / relationBulkDetachAction`. All three auto-hide outside any M2M mode. `relationAttach` builds a modal-form `SelectField` picker via `attachFactory.buildAttachModalSchema` and POSTs the selected id to the manager's `_action/relationAttach` endpoint; `relationDetach` is a direct row-POST to `_detach/:childId`; `relationBulkDetach` runs the per-row `canDetach` gate inside the handler before calling `parent.related(rel).detach(ids)` once.
 - `src/actions/exportFactory.ts` — `Action.export / Action.bulkExport` internals (resolveExportColumns / collectExportRows / buildExportRow / encodeExport / defaultExportFilename). Lives in its own module so the Action ↔ Table cycle stays clean — `Action.export`'s handler dynamic-imports it at request time. Drives the table's existing `records()` handler in pages so filters / search / sort flow through unchanged. CSV body via `src/io/csv.ts` (RFC 4180 encoder + parser, in-memory only). Handler return shape extended with `{ download: { filename, contentType, body } }` on `ActionResult` + `DispatchActionSuccess`; route layer detects, sets `Content-Type` + `Content-Disposition: attachment` + `res.send(body)` (mutually exclusive with `redirect`); client `dispatchHandlerAction` content-sniffs `Content-Disposition` and triggers a synthetic `<a download>` blob download. Plan: `docs/plans/import-export-actions.md`.
 - `src/actions/importFactory.ts` — `Action.import` internals (parseImportText / runImport / buildImportSchema / buildImportNotification). Auto-builds the modal-form schema (FileUpload + a Mode select when `upsertBy` is set); handler reads `ctx.values.file`, fetches the URL the FileUpload stamped, parses CSV/JSON, walks rows through `R.model.create` (or `R.model.update` for matched upserts). Per-row `validate / beforeCreate / beforeUpdate` hooks; partial-failure-soft (rows that throw / fail validate accumulate in `summary.errors` and the import keeps going). Format auto-detected from filename when not set; `maxRows` cap (default 10_000). Visibility delegates to `R.canCreate`. No transaction wrapper in v1 (rudder ORM doesn't expose one to pilotiq yet).
+- `src/actions/attachFactory.ts` — `Action.relationAttach` modal-form internals: `buildAttachModalSchema({ Related, relationship, recordTitleAttr, labelSingular })` returns a `[SelectField]` populated by `loadAttachableCandidates(parent, rel, relatedModel, recordTitleAttr, limit?)` which fetches up to 50 candidate rows and filters out already-attached ids server-side. Mirrors the `importFactory.ts` / `exportFactory.ts` split — lives outside the Action class so M2M-specific imports (SelectField + ORM helpers) stay out of the main file.
 - `src/io/csv.ts` — `encodeCsv(rows, columns) / parseCsv(input)`. RFC 4180: CRLF emit, LF/CRLF accept, double-quote escaping for embedded quotes, BOM stripped on input. Every cell parsed as a string — type coercion is the importer's job. No third-party dep.
 - `src/actions/ActionGroup.ts` — `ActionGroup.make(name).label().icon().tooltip().actions([Action, ...])`. Renders as DropdownMenu. Same trigger styling + visibility rules as Action. Nested groups flatten. Bulk placement unsupported.
 - `src/schema/Heading.ts` — `Heading.actions([Action…])` — title left + actions right. Used by `CreatePage / EditPage` to put Save in header.
@@ -108,7 +124,39 @@ Deep notes for many of these also live in `~/.claude/projects/-Users-sleman-Proj
 - `src/react/layouts/SidebarLayout.tsx` — shadcn Sidebar. `<SidebarGroup>` per nav group, `<SidebarMenuSub>` for children, `<SidebarMenuBadge>` for badges. Active = longest URL prefix.
 - `src/react/layouts/TopbarLayout.tsx` — horizontal nav variant. Group label → dropdown trigger.
 - `src/react/ThemeSettingsPage.tsx` — Theme editor: controls + live iframe preview.
-- `src/react/SchemaRenderer.tsx` — Renders resolved schema. `TableRenderer` segregates actions by placement (header/inline top bar; bulk toolbar shown when rows selected; row inline). Heading/description/striped/emptyState chrome via Table builders. **Row click navigation:** `Table.recordUrl(r => …)` stamps `_recordUrl`; each *data cell* wraps content in a real `<a href>` (`RecordCellLink`). Plain left-clicks SPA-nav via `useNavigate()`; modified clicks fall through. Action and bulk-select cells stay unwrapped. Per-column overrides: `Column.recordUrl(fn|false)`. `formatCell` switches on `col.columnType`, applies built-in `format` spec, reads `row._formatted[colName]` first. **Per-row classes:** `Table.recordClasses(r => '…')` stamps `_recordClasses` and the renderer concatenates onto the `<tr>` className (after striped + cursor-pointer). **Auto-refresh:** `Table.poll(seconds)` emits `pollInterval` on the meta; `TableRenderer`'s `useEffect` runs `setInterval(navigate(pathname+search), n*1000)` and pauses while `document.visibilityState !== 'visible'`. **Group banding:** `Table.defaultGroup(col)` stable-sorts rows via `sortRowsByGroupValue` in `dispatchTable` (empty/null group values bubble to the bottom), stamps `_groupValue` per row; the renderer inserts a heading `<TableRow>` whenever the value changes between adjacent rows. **Footer summaries:** `Column.summarize([…])` makes `loadTableRecords` compute aggregates over the rendered rows; renderer mounts a `<TableFooter>` row aligned to the columns when `meta.summaries` is non-empty.
+- `src/react/SchemaRenderer.tsx` — Thin top-level dispatcher (~550 lines) for resolved schema. Walks elements via `renderElement` and delegates each type to a sibling renderer under `src/react/schemaRenderer/`. Public surface: `<SchemaRenderer elements={...} widgetData={...} />` + the `FormFields` helper. Re-exports `dispatchHandlerAction` + `renderFormChild` for consumers (`RepeaterInput.tsx`, `SelectFieldInput.tsx`). Page-chrome renderers that don't fit a sub-namespace (`ListTabsRenderer`, `BreadcrumbsRenderer`, `RelationTabsRenderer`, `RelationTabIcon`) still live here.
+- `src/react/schemaRenderer/` — Modular renderer subtree. Split out of `SchemaRenderer.tsx` in 5 phases (PR #29–#33, 6,798 → 549 lines):
+  - `constants.ts` — `TEXT_*` / `COLUMN_*` / `BADGE_COLOR_CLASSES` lookup tables + `alertStyles`.
+  - `columnFormat.ts` — `applyColumnFormat` (dateTime / since / money / numeric / limit / words). Used by both table cells and entries.
+  - `helpers.tsx` — `resolveIcon`, `layoutClasses`, `renderChildren`, `withTooltip`, `IconCmp` type.
+  - `SimpleElements.tsx` — 13 stateless leaf + layout primitives (text/image/icon/markdown/html/heading/emptyState/divider/unorderedList/card/grid/group/split/fieldset). Exports `renderSimpleElement(el, index, deps)`; deps inject `renderElement` + `renderActionLike` for cases that recurse or mount action children.
+  - `AlertRenderer.tsx` — dismissible alert + localStorage persist.
+  - `SectionRenderer.tsx` — collapsible / persistable Section; takes `renderElement` prop for child recursion.
+  - `TabsRenderer.tsx` — pills + underline variants.
+  - `WizardRenderer.tsx` — multi-step form, URL/localStorage step persist, `WizardNavButton` chrome customizers.
+  - `EntryRenderer.tsx` — `renderEntry` (8 entry types: text/badge/icon/image/keyValue/color/code/component/repeatable) + `EntryShell` chrome + tooltip/copy helpers.
+  - `action/` — Phase 3 action layer:
+    - `renderAction.tsx` — main switch (submit / href / method / handler / disabled placeholder) + `renderActionLike` (action / actionGroup / slotComponent).
+    - `ActionModalDialog.tsx` / `ConfirmActionDialog.tsx` — modal + confirm dialogs.
+    - `MethodActionButton.tsx` / `HandlerActionButton.tsx` — POST-style and JSON-dispatch buttons.
+    - `ActionGroupTrigger.tsx` — dropdown trigger + pending-dialog state.
+    - `buttons.tsx` — `actionButtonClass` / `renderActionIcon` / `renderActionBadge` + `COLOR_VARIANTS` / `OUTLINED_VARIANTS` / `SIZE_CLASSES` / `ICON_SIZE_CLASSES` + `RenderActionOptions` interface.
+    - `helpers.ts` — `dispatchNotifications`, `dispatchMethodAction`, `dispatchHandlerAction`, attachment-download helpers + `Notify` / `Navigate` types.
+  - `form/` — Phase 4 form layer:
+    - `FormRenderer.tsx` — HTML form chrome + fetch+JSON submit + error stamping + `FormStateProvider` mount + `FormBody` / `renderFormChild` / `renderFieldWithValue`.
+    - `renderField.tsx` — 13-way field-type switch + `TextFieldShell` (handles password reveal / mask / datalist via `useTextInputControls`).
+  - `table/` — Phase 5 table layer:
+    - `TableRenderer.tsx` — deferred-load wrapper + `TableSkeleton`.
+    - `TableRendererBody.tsx` — the body itself. Column rendering / sort+pagination+search URL state / group banding+drill-in / per-row inline edit+delete / bulk-action toolbar / cards-layout dispatch / empty+loading states. Accepts a `TableBodyDeps` bag (`renderElement` + `renderActionLike` + `renderFormChild`).
+    - `CardsLayoutBody.tsx` — `contentLayout('cards')` body + responsive `CARDS_GRID_COLS_*` lookup tables + `pickCardCols` / `cardsPerRowClasses`.
+    - `filters.tsx` — every filter widget (`FilterSelect` / `FilterMultiSelect` / `FilterDateRange` / `FilterForm` / `FilterQueryBuilder` + query-builder sub-components) plus chrome (`FilterPopover` / `FilterStrip` / `FilterStripToggle` / `ActiveFiltersBar`) plus toolbar siblings (`TableGroupPicker` / `SortByPicker` / `ColumnsToggleDropdown` / `GroupHeaderText` / `renderFilterControl` / `resolveColumnUrl`).
+    - `formatCell.tsx` — `formatCell` (8 column-type dispatch) + `wrapCell` / `wrapCellList` + `CellCopyButton` + `rowId`.
+    - `url.tsx` — `TableUrlState` + `prefixK` / `buildTableQuery` / `nextSortDir` / `SearchFormHiddenInputs` / `getCurrentSearchParams`.
+    - `links.tsx` — `RecordCellLink` (cell-level SPA link wrapper) + `ActiveGroupKeyChip` + `GroupHeadingLink`.
+    - `renderRowActions.tsx` — per-row action strip; takes `renderActionLike` as a parameter so it stays free of the action import cycle.
+  - **Dependency injection convention.** Renderers that need to recurse take `renderElement` (and sometimes `renderActionLike` / `renderFormChild`) as props or function arguments. `SchemaRenderer.tsx` binds them via closure with thin wrappers (`renderActionLike`, `renderField`, `renderFormChild`, `FormRenderer`, `TableRenderer`) so the rest of the file passes the closure-bound versions into the switch.
+
+  **Row click navigation (table layer):** `Table.recordUrl(r => …)` stamps `_recordUrl`; each *data cell* wraps content in a real `<a href>` (`RecordCellLink`). Plain left-clicks SPA-nav via `useNavigate()`; modified clicks fall through. Action and bulk-select cells stay unwrapped. Per-column overrides: `Column.recordUrl(fn|false)`. `formatCell` switches on `col.columnType`, applies built-in `format` spec, reads `row._formatted[colName]` first. **Per-row classes:** `Table.recordClasses(r => '…')` stamps `_recordClasses` and the renderer concatenates onto the `<tr>` className (after striped + cursor-pointer). **Auto-refresh:** `Table.poll(seconds)` emits `pollInterval` on the meta; `TableRendererBody`'s `useEffect` runs `setInterval(navigate(pathname+search), n*1000)` and pauses while `document.visibilityState !== 'visible'`. **Group banding:** `Table.defaultGroup(col)` stable-sorts rows via `sortRowsByGroupValue` in `dispatchTable` (empty/null group values bubble to the bottom), stamps `_groupValue` per row; the renderer inserts a heading `<TableRow>` whenever the value changes between adjacent rows. **Footer summaries:** `Column.summarize([…])` makes `loadTableRecords` compute aggregates over the rendered rows; renderer mounts a `<TableFooter>` row aligned to the columns when `meta.summaries` is non-empty.
 
   **All non-modal action triggers SPA-update:** `dispatchHandlerAction / dispatchMethodAction` fetch with `Accept: application/json`, drain notifications via `useToast()`, then `useNavigate()` to redirect. Handler actions WITH confirm/modal → `ActionModalDialog` (controlled or uncontrolled). Confirm-only modals reuse same dialog.
 
@@ -120,7 +168,7 @@ Deep notes for many of these also live in `~/.claude/projects/-Users-sleman-Proj
 
   **Plan #5 reactive fields (client).** `react/FormStateContext.tsx` ships `FormStateProvider` + `useFieldState(name)` + `useFormState()`. `FormRenderer` is dual-path: with `stateUrl` set it wraps children in the provider (controlled inputs); without it, falls back to today's uncontrolled `defaultValue` path. Each field renderer (`TextLikeInput` for text/email/number/textarea/slug; specialized inputs for toggle/select/date) consults `useFieldState` first, falls back to `defaultValue` when outside the provider — so non-live forms cost nothing. `triggerLive(name)` reads each field's `live` config and POSTs `{ changed, values }` to `stateUrl` (immediate / debounced via `setTimeout` / on blur). In-flight race handling via `requestSeqRef + latestSeenRef` (refs, not state — StrictMode trap). 422 → inline errors; other failures → toast. **Live forms must pin `Form.make().formId('stable-id')`** — see `feedback_pilotiq_live_forms_pin_formid.md`. Public exports: `FormStateProvider`, `useFieldState`, `useFormState` from `@pilotiq/pilotiq/react`.
 - `src/react/ui/` — shadcn primitives (sidebar, button, sheet, separator, tooltip, skeleton, input, checkbox, calendar, dialog, dropdown-menu, popover, select, switch, table, tabs, textarea, **slider** added in Plan #6).
-- `src/react/fields/` — extracted per-fieldtype renderers (`FieldShell`, `TextLikeInput`, `SelectFieldInput`, `ToggleFieldInput`, `DateFieldInput`, `HiddenInput`, `CheckboxInput`, `RadioInput`, `ToggleButtonsInput`, `CheckboxListInput`, `SliderInput`, `ColorInput`, `DateTimeInput`, `KeyValueInput`, `TagsInput`, `FileUploadInput`, `MarkdownInput`). `FieldShell` wraps every input with the label / required asterisk / prefix / suffix / helperText chrome — `SchemaRenderer` is now a thin dispatcher.
+- `src/react/fields/` — extracted per-fieldtype renderers (`FieldShell`, `TextLikeInput`, `SelectFieldInput`, `ToggleFieldInput`, `DateFieldInput`, `HiddenInput`, `CheckboxInput`, `RadioInput`, `ToggleButtonsInput`, `CheckboxListInput`, `SliderInput`, `ColorInput`, `DateTimeInput`, `KeyValueInput`, `TagsInput`, `FileUploadInput`, `MarkdownInput`). `FieldShell` wraps every input with the label / required asterisk / prefix / suffix / helperText chrome — consumed by `schemaRenderer/form/renderField.tsx`'s 13-way field-type switch.
 - `src/uploads/` — `UploadAdapter` interface + `localUpload({ root, urlPrefix })` adapter for FileUpload. Apps register via `Pilotiq.uploads({ adapter })`; route `POST {base}/_uploads` (multipart) hands the file off to the adapter and returns `{ ok, url }`. `_uploads` route validates `accept` + `maxSize` server-side from the field meta (re-checked even though the client also enforces, so a tampered client can't bypass). Adapter contract is storage-agnostic — disk / S3 / R2 / `@pilotiq/media` all implement the same shape. **`RenderContext.uploadUrl` vs `hasUploadAdapter` (2026-05-04 cont'd):** `uploadUrl` is *always* stamped by `pageData.uploadCtx` (so `FileUpload` can show a clear "no upload route configured" error when missed); the companion `hasUploadAdapter: true` is only set when `cfg.uploads` is present, and tells fields with *optional* upload affordances (e.g. `MarkdownField`'s `attachFiles` toolbar button) to hide themselves rather than render a broken control. `uploadCtx(ctx, cfg)` takes the full PilotiqConfig now (was: `basePath`).
 - `src/plugins/themeEditor.ts` — `themeEditor()` plugin.
 
@@ -166,6 +214,14 @@ Deep notes for many of these also live in `~/.claude/projects/-Users-sleman-Proj
 - Plugin authors expose factories: `panel.rightPanel(...)` from inside their `register(panel)` so consumers wire via `.plugins([…])`.
 - Plan: `docs/plans/right-sidebar.md`. Guide: `docs/guide/right-sidebar.md`.
 
+### Component slots
+
+- `Pilotiq.components({ nav, header, footer })` registers build-time chrome-slot overrides. Three slots ship: `nav` (replaces default nav tree — `<SidebarMenu>` body in `SidebarLayout`, `<nav>` cluster in `TopbarLayout`), `header` (replaces the whole `<header>` chrome bar in both layouts — in `TopbarLayout` this subsumes the nav region, so setting `header` makes `nav` irrelevant for that layout), `footer` (mounts a `<footer>` element below the main content area in both layouts — separate from the `panels::footer` render hook, which keeps firing INSIDE the content area). The shape is open-ended so additions don't break this surface. `.components()` is order-independent and merges across calls (later call wins per slot; unset keys preserved).
+- Build-time wiring mirrors `rightPanels` — the Vite plugin's `_components.ts` emitter walks `cfg.components` and stamps `componentSlotRegistry: { [slot]: Component }` parallel to `componentRegistry` + `rightPanelRegistry`. The component ref never travels over the wire; the auto-gen `+Layout.tsx` imports the registry and forwards it to `<AppShell componentSlotRegistry=…>`, which threads it through to the layout via `AppShellProps`.
+- Render-hooks vs slots: render-hooks (`panels::sidebar.nav.start` / `panels::sidebar.nav.end`) *splice* around the nav region — they still fire whether the nav is the framework default OR a custom slot component, so plugins that just want to inject a header banner above the nav don't fight with consumers that swap the whole nav. **`header` is the exception** — render hooks rooted INSIDE the default header (`panels::topbar.start`, `panels::topbar.end`, `panels::user-menu.before`, `panels::user-menu.after`) do NOT fire when the header is replaced, since the container they splice into is gone. Plugin authors who care about preserving those splices inside a custom header can mount `<RenderHookSlot name="…" hooks={panel.renderHooks} />` themselves from within the custom header.
+- Public surface: `NavComponentProps`, `HeaderComponentProps`, `FooterComponentProps`, `isNavItemActive` re-exported from `@pilotiq/pilotiq/react`. `NavItem` is also re-exported there for convenience (it already exists on the main barrel). Prop contracts: `nav` + `header` both receive `{ navigation: NavItem[]; basePath: string; currentPath?: string }` (header mirrors nav so a topbar-replacement header can render the nav inline without juggling a second slot); `footer` receives `{ basePath: string; currentPath?: string }` (minimal — footers rarely need the nav tree). For `header` replacements, the existing pilotiq chrome components (`SearchTrigger`, `ThemeToggle`, `NotificationBell`, `RightSidebarTrigger`, `UserMenu`) are exported from `@pilotiq/pilotiq/react` so consumers can drop them back in à la carte rather than reimplementing every control. Authoring example: a user-defined `MyCustomSidebar` lives in `app/Pilotiq/` next to the panel module, gets registered via `Pilotiq.make('Admin').components({ nav: MyCustomSidebar })`.
+- **Authoring `.tsx` inside the panel module dir:** the Vite plugin jiti-loads the panel module at boot so it can harvest `cfg.components` into `_components.ts`. Two gotchas surfaced when this happens: (1) jiti needs JSX support enabled to parse `.tsx` — the plugin passes `jsx: { runtime: 'automatic' }` to `createJiti`, matching the playground tsconfig's `"jsx": "react-jsx"` (no per-file React import needed); (2) jiti's resolver falls through `.js` → `.ts` but NOT `.js` → `.tsx`, so the import statement in the panel module must use the literal `.tsx` extension (e.g. `import { MyCustomSidebar } from './MyCustomSidebar.tsx'`). `allowImportingTsExtensions: true` in the playground tsconfig keeps TS happy with this. The non-panel-module sibling pattern (a `.tsx` registered via `registerWidgetComponents` / `registerEntryComponents` from `+Layout.tsx`) sidesteps both — it's read by Vite, not jiti — but that pattern doesn't apply to component slots because the slot needs a real component ref at panel-build time, not a registry name.
+
 ---
 
 ## Theme system

package/dist/Pilotiq.d.ts

@@ -12,6 +12,7 @@ import type { NavigationBadgeColor } from './Resource.js';
 import type { RenderHookEntry, RenderHookFn, RenderHookName, RenderHookScope } from './RenderHook.js';
 import type { NotificationActionHandler } from './notifications/types.js';
 import { type RightPanelContribution } from './RightPanel.js';
+import type { NavComponentProps, HeaderComponentProps, FooterComponentProps } from './react/component-slots.js';
 export type PilotiqLayout = 'sidebar' | 'topbar';
 /** Plugin interface for extending Pilotiq panels. */
 export interface PilotiqPlugin {
@@ -234,6 +235,19 @@ export interface PilotiqConfig {
      * closest to the page tree (innermost wrap).
      */
     layoutProviders?: LayoutProviderComponent[];
+    /**
+     * Build-time component overrides for panel chrome slots. Registered
+     * via `Pilotiq.components({ nav })`. The Vite plugin harvests the
+     * actual React refs into `pages/(pilotiq)/_components.ts`; component
+     * refs never travel over the wire.
+     *
+     * v1 ships only the `nav` slot — full replacement of the sidebar's
+     * `<SidebarContent>` body and the topbar's `<nav>` element. Other
+     * slots (`header`, `footer`, …) will land when a concrete consumer
+     * asks; the shape is open-ended so additions don't break this
+     * surface.
+     */
+    components?: ComponentSlots;
     /**
      * AI suggestion mode — controls what happens when an AI agent calls a
      * write tool against a form field.
@@ -261,6 +275,41 @@ export type LayoutProviderComponent = React.ComponentType<{
     children: React.ReactNode;
     basePath?: string;
 }>;
+/**
+ * Chrome-slot overrides registered through `Pilotiq.components({ … })`.
+ *
+ * Three slots ship today:
+ *
+ * - `nav` — replaces the default nav tree (`<SidebarMenu>` body in
+ *   `SidebarLayout`, the `<nav>` cluster in `TopbarLayout`). Surrounding
+ *   chrome (branding header, render-hook splices, footer, sign-out
+ *   menu) stays.
+ * - `header` — replaces the whole `<header>` chrome bar. In
+ *   `SidebarLayout` that's the top bar with search / theme / bell /
+ *   user menu; in `TopbarLayout` that's the whole top region including
+ *   the brand cluster AND the nav (setting `header` makes `nav`
+ *   irrelevant in `TopbarLayout`). Render hooks that splice INSIDE the
+ *   default header (`panels::topbar.*`, `panels::user-menu.*`) don't
+ *   fire when the header is replaced — the surrounding container is
+ *   gone. The consumer reimplements the chrome controls they want
+ *   (import `<SearchTrigger>`, `<ThemeToggle>`, `<NotificationBell>`,
+ *   `<RightSidebarTrigger>`, `<UserMenu>` from `@pilotiq/pilotiq/react`).
+ * - `footer` — mounts a `<footer>` element BELOW the main content area
+ *   in both layouts (outside the scroll region). Separate from the
+ *   `panels::footer` render hook, which keeps firing inside the content
+ *   area for per-page trailing chrome.
+ *
+ * The shape is open-ended so additional slots can land without a
+ * breaking change when a concrete consumer asks for them.
+ */
+export interface ComponentSlots {
+    /** Component rendered in place of the default nav tree. */
+    nav?: React.ComponentType<NavComponentProps>;
+    /** Component rendered in place of the default `<header>` chrome. */
+    header?: React.ComponentType<HeaderComponentProps>;
+    /** Component rendered as the panel footer, below the main content. */
+    footer?: React.ComponentType<FooterComponentProps>;
+}
 export declare class Pilotiq {
     private config;
     private installedPlugins;
@@ -578,6 +627,40 @@ export declare class Pilotiq {
     layoutProviders(list: LayoutProviderComponent[]): this;
     /** @internal — read by the Vite plugin's `_components.ts` emitter. */
     getLayoutProviders(): readonly LayoutProviderComponent[];
+    /**
+     * Override one of pilotiq's built-in chrome slots with a custom React
+     * component. Calling twice merges — the latest registration wins per
+     * slot; unset keys preserve the prior value (so a plugin can override
+     * `nav` without clearing a host app's `footer`).
+     *
+     * Three slots ship today: `nav` (replaces the default nav tree),
+     * `header` (replaces the whole `<header>` chrome bar in both
+     * layouts — in `TopbarLayout` this subsumes the nav), and `footer`
+     * (mounts a `<footer>` below the main content area in both layouts).
+     * See {@link ComponentSlots} for the per-slot semantics and which
+     * render hooks compose vs. stop firing under each replacement.
+     *
+     * Component refs are harvested by the Vite plugin into
+     * `pages/(pilotiq)/_components.ts` — they never travel over the wire,
+     * so authoring inside the panel module (which is import-safe on both
+     * server and client) is the supported entry point.
+     *
+     * @example
+     * ```ts
+     * import { MyCustomSidebar } from './MyCustomSidebar.js'
+     *
+     * Pilotiq.make('Admin').components({ nav: MyCustomSidebar })
+     * ```
+     *
+     * The supplied component receives `{ navigation, basePath, currentPath }`
+     * — the same shape `panelInfo()` produces for the default renderers.
+     * Import `NavComponentProps` and `isNavItemActive` from
+     * `@pilotiq/pilotiq/react` to author a typed component that reuses
+     * the framework's longest-prefix active-link semantics.
+     */
+    components(slots: ComponentSlots): this;
+    /** @internal — read by the Vite plugin's `_components.ts` emitter. */
+    getComponentSlots(): Readonly<ComponentSlots>;
     /**
      * Set the panel-wide AI suggestion mode.
      *

package/dist/Pilotiq.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pilotiq.d.ts","sourceRoot":"","sources":["../src/Pilotiq.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Pilotiq.d.ts","sourceRoot":"","sources":["../src/Pilotiq.ts"],"names":[],"mappings":"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"}

package/dist/Pilotiq.js

@@ -475,6 +475,45 @@ export class Pilotiq {
     getLayoutProviders() {
         return this.config.layoutProviders ?? [];
     }
+    /**
+     * Override one of pilotiq's built-in chrome slots with a custom React
+     * component. Calling twice merges — the latest registration wins per
+     * slot; unset keys preserve the prior value (so a plugin can override
+     * `nav` without clearing a host app's `footer`).
+     *
+     * Three slots ship today: `nav` (replaces the default nav tree),
+     * `header` (replaces the whole `<header>` chrome bar in both
+     * layouts — in `TopbarLayout` this subsumes the nav), and `footer`
+     * (mounts a `<footer>` below the main content area in both layouts).
+     * See {@link ComponentSlots} for the per-slot semantics and which
+     * render hooks compose vs. stop firing under each replacement.
+     *
+     * Component refs are harvested by the Vite plugin into
+     * `pages/(pilotiq)/_components.ts` — they never travel over the wire,
+     * so authoring inside the panel module (which is import-safe on both
+     * server and client) is the supported entry point.
+     *
+     * @example
+     * ```ts
+     * import { MyCustomSidebar } from './MyCustomSidebar.js'
+     *
+     * Pilotiq.make('Admin').components({ nav: MyCustomSidebar })
+     * ```
+     *
+     * The supplied component receives `{ navigation, basePath, currentPath }`
+     * — the same shape `panelInfo()` produces for the default renderers.
+     * Import `NavComponentProps` and `isNavItemActive` from
+     * `@pilotiq/pilotiq/react` to author a typed component that reuses
+     * the framework's longest-prefix active-link semantics.
+     */
+    components(slots) {
+        this.config.components = { ...(this.config.components ?? {}), ...slots };
+        return this;
+    }
+    /** @internal — read by the Vite plugin's `_components.ts` emitter. */
+    getComponentSlots() {
+        return this.config.components ?? {};
+    }
     /**
      * Set the panel-wide AI suggestion mode.
      *

package/dist/Pilotiq.js.map

@@ -1 +1 @@
-{"version":3,"file":"Pilotiq.js","sourceRoot":"","sources":["../src/Pilotiq.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Pilotiq.js","sourceRoot":"","sources":["../src/Pilotiq.ts"],"names":[],"mappings":"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"}