@pilotiq/pilotiq 0.23.1 → 0.24.2

package/src/pageData.ts

@@ -1,341 +0,0 @@
-/**
- * Per-page-role data builders. The framework's GET route handlers and
- * Vike's auto-generated `+data.ts` hooks both call these to produce the
- * exact props the page renderer needs.
- *
- * Why this exists: SSR runs through the rudder router (which calls
- * `view(...)` and populates `pageContext.viewProps`). SPA navigation only
- * triggers Vike's `+data` hook — the rudder handler doesn't run, so the
- * data needs to come from the same builder. Routing both paths through a
- * single builder keeps them in sync.
- */
-import { PilotiqRegistry } from './PilotiqRegistry.js'
-
-// Re-export `RelationChainStep` so external callsites importing it via
-// `./pageData.js` keep working.
-export type { RelationChainStep } from './pageData/breadcrumbs.js'
-
-// Re-export `ServerDataMap` so external imports via `./pageData.js` keep
-// working — the type is also surfaced from `packages/pilotiq/src/index.ts`.
-export type { ServerDataMap } from './pageData/helpers.js'
-
-// Re-export the URL-tag helpers + fill pipeline + server-data resolver
-// for consumers that import them through `./pageData.js`.
-export {
-  applyEditPageHydrators,
-  applyFillPipeline,
-  applyRelationshipBuilderFill,
-  applyRelationshipRepeaterFill,
-  callPageSchema,
-  normalizeArrayFieldStrings,
-  resolveServerDataElements,
-  tagActionDispatch,
-  tagCellEditUrls,
-  tagFieldAiUrls,
-  tagFormActions,
-  tagFormStateUrls,
-  tagFormWizardUrls,
-  tagRichTextMentionUrls,
-  tagSelectCreateOptionUrls,
-  tagTableDeferred,
-  tagTableReorderUrls,
-  tagWidgetUrls,
-} from './pageData/helpers.js'
-
-// Re-export navigation chrome surface so external callsites importing
-// it via `./pageData.js` keep working (e.g. routes/test harnesses).
-export type {
-  DatabaseNotificationsMeta,
-  NavItem,
-  PanelInfoRoute,
-  RightPanelMeta,
-  RightSidebarMeta,
-  UserMenuMeta,
-} from './pageData/navigation.js'
-export {
-  applyRoleHooks,
-  panelInfo,
-  resolvePageHooks,
-} from './pageData/navigation.js'
-
-import {
-  dashboardData,
-  resourceCreateData,
-  resourceEditData,
-  resourceIndexData,
-  resourceRecordPageData,
-  resourceViewData,
-} from './pageData/resourcePages.js'
-
-// Re-export resource page builders so external callsites importing
-// through `./pageData.js` keep working (e.g. routes.ts handlers, tests).
-export {
-  dashboardData,
-  resolveActiveTab,
-  resourceCreateData,
-  resourceEditData,
-  resourceIndexData,
-  resourceRecordPageData,
-  resourceTableData,
-  resourceViewData,
-} from './pageData/resourcePages.js'
-
-import { relationManagerData } from './pageData/relationPages.js'
-
-// Re-export relation manager builder surface for external consumers
-// (routes.ts dispatches every relation-* role through these).
-export type {
-  RelationManagerResult,
-  RelationManagerScope,
-  ResolvedChain,
-} from './pageData/relationPages.js'
-export {
-  findRelatedResource,
-  relationManagerData,
-  resolveRelationChain,
-  safeManagerPolicy,
-} from './pageData/relationPages.js'
-
-// Re-export form-related builders + types for external callsites.
-export type {
-  FormCreateOptionFailure,
-  FormCreateOptionRequest,
-  FormCreateOptionSuccess,
-  FormStateError,
-  FormStateRequest,
-  FormStateResult,
-  FormStateScope,
-  FormWizardFailure,
-  FormWizardRequest,
-  FormWizardSuccess,
-} from './pageData/forms.js'
-export {
-  formCreateOptionData,
-  formStateData,
-  formWizardData,
-  mentionResolveData,
-} from './pageData/forms.js'
-
-import {
-  customPageData,
-  globalEditData,
-  globalViewData,
-} from './pageData/misc.js'
-
-// Re-export the misc page builders for external callsites (routes.ts
-// dispatches into globals / custom-page / widget / search routes).
-export {
-  customPageData,
-  globalEditData,
-  globalViewData,
-  searchData,
-  widgetData,
-} from './pageData/misc.js'
-export type {
-  WidgetFailure,
-  WidgetRequest,
-  WidgetScope,
-  WidgetSuccess,
-} from './pageData/misc.js'
-
-
-// ─── Vike +data dispatcher ───────────────────────────────────
-
-export interface PageContextLike {
-  urlPathname?: string
-  urlOriginal?: string
-  urlParsed?:   { search?: Record<string, string>; searchOriginal?: string }
-  routeParams?: Record<string, string | undefined>
-  pageId?:      string
-}
-
-/**
- * Single entry point Vike's `+data` hook calls. Inspects the page id and
- * route params, finds the panel via `PilotiqRegistry`, and dispatches to
- * the matching builder. Returns the same shape SSR's `viewProps` carries.
- */
-export async function dispatchPageData(pageContext: PageContextLike): Promise<unknown | null> {
-  const { pageId, routeParams = {} } = pageContext
-  const search = pageContext.urlParsed?.search ?? {}
-  const basePathParam = routeParams['basePath']
-  const basePath = basePathParam ? `/${basePathParam}` : ''
-  const panel = basePath ? PilotiqRegistry.findByPath(basePath) : null
-
-  if (!panel) return null
-
-  switch (pageId) {
-    case '/pages/(pilotiq)/dashboard':
-      return dashboardData(panel)
-
-    case '/pages/(pilotiq)/slug': {
-      // 2-segment URL: could be a resource list, a global edit, or a custom page.
-      const slug = routeParams['slug']
-      if (!slug) return null
-      const cfg = panel.getConfig()
-      if (cfg.resources.some(R => R.getSlug() === slug)) {
-        return resourceIndexData(panel, slug, search)
-      }
-      if (cfg.globals.some(G => G.getSlug() === slug)) {
-        return globalEditData(panel, slug)
-      }
-      return customPageData(panel, slug)
-    }
-
-    case '/pages/(pilotiq)/resource-create': {
-      const slug = routeParams['slug']
-      if (!slug) return null
-      return resourceCreateData(panel, slug)
-    }
-
-    case '/pages/(pilotiq)/resource-edit': {
-      const slug = routeParams['slug']
-      const id = routeParams['id']
-      if (!slug || !id) return null
-      return resourceEditData(panel, slug, id)
-    }
-
-    case '/pages/(pilotiq)/resource-view': {
-      const slug = routeParams['slug']
-      const id = routeParams['id']
-      if (!slug) return null
-      // Globals also use this route under `/{slug}/view` — id will be 'view'.
-      if (id === 'view') return globalViewData(panel, slug)
-      if (!id) return null
-      return resourceViewData(panel, slug, id)
-    }
-
-    case '/pages/(pilotiq)/relation-list': {
-      const slug         = routeParams['slug']
-      const id           = routeParams['id']
-      const relationship = routeParams['relationship']
-      if (!slug || !id || !relationship) return null
-      const out = await relationManagerData(panel, {
-        kind: 'relation-list', slug, recordId: id, relationship,
-        query: search as Record<string, string>,
-      })
-      // Tagged failure shapes (`{ ok: false, status: 403 }`) leak straight
-      // through to the +Page renderer, which can branch on the shape.
-      // null = no manager named `relationship` on R; fall through to the
-      // record sub-page lookup so URLs like `/admin/users/u1/activity`
-      // (where `activity` is registered under `pages().record`) route
-      // through `resourceRecordPageData` rather than 404ing.
-      if (out !== null) return out as Record<string, unknown>
-      const recordOut = await resourceRecordPageData(panel, slug, id, relationship)
-      return recordOut === null ? null : (recordOut as Record<string, unknown>)
-    }
-
-    case '/pages/(pilotiq)/relation-create': {
-      const slug         = routeParams['slug']
-      const id           = routeParams['id']
-      const relationship = routeParams['relationship']
-      if (!slug || !id || !relationship) return null
-      const out = await relationManagerData(panel, {
-        kind: 'relation-create', slug, recordId: id, relationship,
-      })
-      return out === null ? null : (out as Record<string, unknown>)
-    }
-
-    case '/pages/(pilotiq)/relation-view': {
-      const slug         = routeParams['slug']
-      const id           = routeParams['id']
-      const relationship = routeParams['relationship']
-      const childId      = routeParams['childId']
-      if (!slug || !id || !relationship || !childId) return null
-      const out = await relationManagerData(panel, {
-        kind: 'relation-view', slug, recordId: id, relationship, childId,
-      })
-      return out === null ? null : (out as Record<string, unknown>)
-    }
-
-    case '/pages/(pilotiq)/relation-edit': {
-      const slug         = routeParams['slug']
-      const id           = routeParams['id']
-      const relationship = routeParams['relationship']
-      const childId      = routeParams['childId']
-      if (!slug || !id || !relationship || !childId) return null
-      const out = await relationManagerData(panel, {
-        kind: 'relation-edit', slug, recordId: id, relationship, childId,
-      })
-      return out === null ? null : (out as Record<string, unknown>)
-    }
-
-    // Phase B nested-relation routes. Param names match those declared
-    // by the auto-gen Vike stubs in `src/vite.ts`:
-    //   id, relationship, childId1, relationship2, childId2.
-    case '/pages/(pilotiq)/nested-relation-list': {
-      const slug          = routeParams['slug']
-      const id            = routeParams['id']
-      const relationship  = routeParams['relationship']
-      const childId1      = routeParams['childId1']
-      const relationship2 = routeParams['relationship2']
-      if (!slug || !id || !relationship || !childId1 || !relationship2) return null
-      const out = await relationManagerData(panel, {
-        kind: 'nested-relation-list', slug,
-        chain: [
-          { recordId: id,       relationship },
-          { recordId: childId1, relationship: relationship2 },
-        ],
-        query: search as Record<string, string>,
-      })
-      return out === null ? null : (out as Record<string, unknown>)
-    }
-
-    case '/pages/(pilotiq)/nested-relation-create': {
-      const slug          = routeParams['slug']
-      const id            = routeParams['id']
-      const relationship  = routeParams['relationship']
-      const childId1      = routeParams['childId1']
-      const relationship2 = routeParams['relationship2']
-      if (!slug || !id || !relationship || !childId1 || !relationship2) return null
-      const out = await relationManagerData(panel, {
-        kind: 'nested-relation-create', slug,
-        chain: [
-          { recordId: id,       relationship },
-          { recordId: childId1, relationship: relationship2 },
-        ],
-      })
-      return out === null ? null : (out as Record<string, unknown>)
-    }
-
-    case '/pages/(pilotiq)/nested-relation-view': {
-      const slug          = routeParams['slug']
-      const id            = routeParams['id']
-      const relationship  = routeParams['relationship']
-      const childId1      = routeParams['childId1']
-      const relationship2 = routeParams['relationship2']
-      const childId2      = routeParams['childId2']
-      if (!slug || !id || !relationship || !childId1 || !relationship2 || !childId2) return null
-      const out = await relationManagerData(panel, {
-        kind: 'nested-relation-view', slug,
-        chain: [
-          { recordId: id,       relationship },
-          { recordId: childId1, relationship: relationship2 },
-        ],
-        childId: childId2,
-      })
-      return out === null ? null : (out as Record<string, unknown>)
-    }
-
-    case '/pages/(pilotiq)/nested-relation-edit': {
-      const slug          = routeParams['slug']
-      const id            = routeParams['id']
-      const relationship  = routeParams['relationship']
-      const childId1      = routeParams['childId1']
-      const relationship2 = routeParams['relationship2']
-      const childId2      = routeParams['childId2']
-      if (!slug || !id || !relationship || !childId1 || !relationship2 || !childId2) return null
-      const out = await relationManagerData(panel, {
-        kind: 'nested-relation-edit', slug,
-        chain: [
-          { recordId: id,       relationship },
-          { recordId: childId1, relationship: relationship2 },
-        ],
-        childId: childId2,
-      })
-      return out === null ? null : (out as Record<string, unknown>)
-    }
-
-    default:
-      return null
-  }
-}

package/src/plugins/index.ts

@@ -1,8 +0,0 @@
-export { themeEditor } from './themeEditor.js'
-export type { ThemeEditorOptions } from './themeEditor.js'
-export { prismaThemeStorage } from '../theme/storage.js'
-export type {
-  ThemeStorageAdapter,
-  PanelGlobalDelegate,
-  PrismaThemeStorageOptions,
-} from '../theme/storage.js'

package/src/plugins/themeEditor.test.ts

@@ -1,36 +0,0 @@
-import { describe, it } from 'node:test'
-import assert from 'node:assert/strict'
-import { Pilotiq } from '../Pilotiq.js'
-import { themeEditor } from './themeEditor.js'
-import type { ThemeStorageAdapter } from '../theme/storage.js'
-
-function makeStubAdapter(): ThemeStorageAdapter {
-  return {
-    async load() { return null },
-    async save() { /* noop */ },
-    async clear() { /* noop */ },
-  }
-}
-
-describe('themeEditor() plugin', () => {
-  it('bare themeEditor() leaves the storage slot undefined (boot resolves it)', () => {
-    const panel = Pilotiq.make('admin').use(themeEditor())
-    assert.equal(panel.getConfig().themeEditor, true)
-    assert.equal(panel.getThemeStorage(), undefined)
-  })
-
-  it('themeEditor({ storage }) stamps the adapter onto the panel', () => {
-    const adapter = makeStubAdapter()
-    const panel = Pilotiq.make('admin').use(themeEditor({ storage: adapter }))
-    assert.equal(panel.getThemeStorage(), adapter)
-  })
-
-  it('themeEditor() can be called on multiple panels without leaking adapters', () => {
-    const a = makeStubAdapter()
-    const b = makeStubAdapter()
-    const panelA = Pilotiq.make('admin').use(themeEditor({ storage: a }))
-    const panelB = Pilotiq.make('billing').use(themeEditor({ storage: b }))
-    assert.equal(panelA.getThemeStorage(), a)
-    assert.equal(panelB.getThemeStorage(), b)
-  })
-})

package/src/plugins/themeEditor.ts

@@ -1,45 +0,0 @@
-import type { PilotiqPlugin } from '../Pilotiq.js'
-import type { ThemeStorageAdapter } from '../theme/storage.js'
-
-export interface ThemeEditorOptions {
-  /**
-   * Override persistence adapter. Defaults to the implicit Prisma
-   * fallback (auto-resolved from `app.make('prisma')` against the
-   * `panelGlobal` row) — that fallback is deprecated; pass an explicit
-   * adapter to opt out and silence the deprecation warning.
-   *
-   * @example
-   * ```ts
-   * import { prismaThemeStorage, themeEditor } from '@pilotiq/pilotiq/plugins'
-   *
-   * .use(themeEditor({
-   *   storage: prismaThemeStorage(prisma, { slug: 'admin__theme' }),
-   * }))
-   * ```
-   */
-  storage?: ThemeStorageAdapter
-}
-
-/**
- * Theme editor plugin — adds an interactive theme customization page
- * with live preview, save/reset functionality, and DB persistence.
- *
- * @example
- * ```ts
- * import { Pilotiq } from '@pilotiq/pilotiq'
- * import { themeEditor } from '@pilotiq/pilotiq/plugins'
- *
- * Pilotiq.make('Admin')
- *   .theme({ preset: 'vega', themeColor: 'blue' })
- *   .use(themeEditor())
- * ```
- */
-export function themeEditor(opts: ThemeEditorOptions = {}): PilotiqPlugin {
-  return {
-    name: 'theme-editor',
-    register(panel) {
-      panel.enableThemeEditor()
-      if (opts.storage) panel._setThemeStorage(opts.storage)
-    },
-  }
-}

package/src/react/AppShell.tsx

@@ -1,251 +0,0 @@
-import React, { useEffect, useState } from 'react'
-import { SidebarLayout } from './layouts/SidebarLayout.js'
-import { TopbarLayout } from './layouts/TopbarLayout.js'
-import { ToasterProvider } from './Toaster.js'
-import { CommandPalette, CommandPaletteProvider } from './CommandPalette.js'
-import type { NotificationMeta } from '../notifications/Notification.js'
-import type { ComponentRegistry } from './icon-context.js'
-import { ComponentRegistryProvider } from './icon-context.js'
-import type { RightPanelRegistry } from './right-panel-registry.js'
-import { RightPanelRegistryProvider } from './right-panel-registry.js'
-import { RightSidebarProvider, useRightSidebarOptional } from './RightSidebarContext.js'
-import { RightSidebar } from './RightSidebar.js'
-import { RecordWrapperGate, type RecordCollabMap } from './RecordWrapperGate.js'
-import { CustomPageWrapperGate, type PageCollabMap } from './CustomPageWrapperGate.js'
-import { useIsMobile } from './hooks/use-mobile.js'
-import type { NavItem, UserMenuMeta, DatabaseNotificationsMeta, RightSidebarMeta } from '../pageData.js'
-import type { RenderHookMap } from '../RenderHook.js'
-import { RenderHookSlot } from './RenderHookSlot.js'
-import type { ComponentSlotRegistry } from './component-slots.js'
-import { CurrentUserProvider } from './CurrentUserContext.js'
-
-export interface AppShellProps {
-  panel: {
-    name: string
-    branding: { title?: string; logo?: string }
-    /** Pre-grouped navigation tree built by `panelInfo()` (Plan #9). */
-    navigation?: NavItem[]
-    /** Top-right dropdown shape — `null`/absent suppresses the menu
-     *  entirely (no resolver configured or no logged-in user). */
-    userMenu?: UserMenuMeta | null
-    /** Bell-icon dropdown config — absent suppresses the bell.
-     *  `panelInfo()` only ships this when the panel opted in via
-     *  `Pilotiq.databaseNotifications()` AND a user resolved. */
-    databaseNotifications?: DatabaseNotificationsMeta
-    /** Right-sidebar plugin meta — absent suppresses the surface.
-     *  `panelInfo()` only ships this when at least one contribution
-     *  was registered AND passed the auth gate AND is non-hidden. */
-    rightSidebar?: RightSidebarMeta
-    /** Per-resource collab opt-in map — read by `RecordWrapperGate` to
-     *  decide whether to mount the plugin-registered RecordWrapper on
-     *  a record edit/view URL. Absent when no resource opted in. */
-    recordCollab?: RecordCollabMap
-    /** Per-custom-page collab opt-in map — read by `CustomPageWrapperGate`
-     *  to decide whether to mount the plugin-registered CustomPageWrapper
-     *  on a custom-page URL. Absent when no page opted in. */
-    pageCollab?: PageCollabMap
-    /** Pre-resolved render-hook slots for the panel chrome (body /
-     *  topbar / sidebar / user-menu / footer / head). Sparse map —
-     *  slots with no registered entries are absent. Built by
-     *  `panelInfo()` server-side. */
-    renderHooks?: RenderHookMap
-    themeEditor?: boolean
-    /** AI suggestion mode — absent means `'auto'` (the default). When
-     *  set to `'review'`, AI plugins read this and stage writes as
-     *  `PendingSuggestion`s for user approval instead of applying
-     *  immediately. Plan: `docs/plans/ai-review-mode.md`. */
-    aiSuggestionsMode?: 'auto' | 'review'
-  }
-  basePath: string
-  /** Pathname used to compute active-link state in the sidebar/topbar. */
-  currentPath?: string
-  layout?: 'sidebar' | 'topbar'
-  /** Server-flashed notifications from `viewProps.notifications`. The
-   * Toaster mounts them on first render. */
-  notifications?: NotificationMeta[]
-  /** Build-time class manifest emitted by the Pilotiq Vite plugin
-   * (`pages/(pilotiq)/_components.ts`). Maps Resource/Global/Page class
-   * names to the actual class refs so component-typed icons (e.g.,
-   * `Resource.icon = Newspaper`) render. Optional — when missing, only
-   * string-registry icons resolve. */
-  componentRegistry?: ComponentRegistry
-  /**
-   * Build-time right-panel registry from the Vite plugin. Maps each
-   * `RightPanelContribution.id` to the React component supplied as
-   * `render`. Phase C's `RightSidebar` chrome reads this via
-   * `useRightPanelComponent(id)`. Sparse `{}` is a valid value — the
-   * chrome simply doesn't mount.
-   */
-  rightPanelRegistry?: RightPanelRegistry
-  /**
-   * Build-time layout-provider registry from the Vite plugin. Each entry
-   * is a React component that wraps the panel's layout tree at the
-   * root. Plugins register via `Pilotiq.layoutProvider(C)`; the Vite
-   * plugin harvests refs into this array. Empty `[]` is the no-op
-   * default — chrome renders without any extra wrapping.
-   */
-  layoutProviderRegistry?: ReadonlyArray<React.ComponentType<{ children: React.ReactNode; basePath?: string }>>
-  /**
-   * Build-time chrome-slot overrides from the Vite plugin. Populated
-   * when the panel module calls `Pilotiq.components({ nav, … })`.
-   * Sparse `{}` is the no-op default. Currently only `nav` is honored;
-   * additional slots will land as concrete consumers ask.
-   */
-  componentSlotRegistry?: ComponentSlotRegistry
-  children: React.ReactNode
-}
-
-export function AppShell({ layout = 'sidebar', notifications, componentRegistry, rightPanelRegistry, layoutProviderRegistry, ...props }: AppShellProps) {
-  const Layout = layout === 'topbar' ? TopbarLayout : SidebarLayout
-  // exactOptionalPropertyTypes: only spread `initialNotifications` when set.
-  const toasterProps = notifications ? { initialNotifications: notifications } : {}
-
-  // Stamp the panel-wide AI suggestion mode on a window global so the
-  // AI plugin's `update_form_state` client-tool handler can read it
-  // without context plumbing. Singleton flag — doesn't change between
-  // pages within the same panel. Plan: `docs/plans/ai-review-mode.md`.
-  const aiSuggestionsMode = props.panel.aiSuggestionsMode ?? 'auto'
-  useEffect(() => {
-    if (typeof window === 'undefined') return
-    ;(window as unknown as { __pilotiqAiSuggestionsMode?: 'auto' | 'review' }).__pilotiqAiSuggestionsMode = aiSuggestionsMode
-  }, [aiSuggestionsMode])
-
-  // Plan #12 — palette open state lives at AppShell so the trigger pill
-  // (rendered inside the layout's header) and the palette dialog both
-  // observe the same flag via context.
-  const [paletteOpen, setPaletteOpen] = useState(false)
-  const paletteProps: {
-    basePath:     string
-    navigation?:  NavItem[]
-    open:         boolean
-    onOpenChange: (open: boolean) => void
-  } = {
-    basePath:     props.basePath,
-    open:         paletteOpen,
-    onOpenChange: setPaletteOpen,
-  }
-  if (props.panel.navigation) paletteProps.navigation = props.panel.navigation
-
-  const hooks = props.panel.renderHooks
-  const rightSidebarMeta = props.panel.rightSidebar
-
-  // Record-scoped wrapper (collab room, audit trail, …) — pass-through
-  // when no plugin registered a wrapper or when the URL isn't a
-  // record-edit page. Wrapping `children` before forwarding to `Layout`
-  // mounts the wrapper around the page content area only, leaving the
-  // sidebar / topbar chrome outside.
-  const layoutProps = {
-    ...props,
-    children: (
-      <RecordWrapperGate
-        basePath={props.basePath}
-        {...(props.currentPath !== undefined ? { currentPath: props.currentPath } : {})}
-        {...(props.panel.recordCollab !== undefined ? { recordCollab: props.panel.recordCollab } : {})}
-      >
-        <CustomPageWrapperGate
-          basePath={props.basePath}
-          {...(props.currentPath !== undefined ? { currentPath: props.currentPath } : {})}
-          {...(props.panel.pageCollab !== undefined ? { pageCollab: props.panel.pageCollab } : {})}
-        >
-          {props.children}
-        </CustomPageWrapperGate>
-      </RecordWrapperGate>
-    ),
-  }
-
-  const inner = (
-    <ToasterProvider {...toasterProps}>
-      <CommandPaletteProvider setOpen={setPaletteOpen}>
-        <RenderHookSlot name="panels::body.start" hooks={hooks} />
-        <RightSidebarLayoutFrame>
-          <Layout {...layoutProps} />
-        </RightSidebarLayoutFrame>
-        <RenderHookSlot name="panels::body.end" hooks={hooks} />
-        <CommandPalette {...paletteProps} />
-        {rightSidebarMeta && (
-          <RightSidebar
-            basePath={props.basePath}
-            {...(props.currentPath !== undefined ? { currentPath: props.currentPath } : {})}
-          />
-        )}
-      </CommandPaletteProvider>
-    </ToasterProvider>
-  )
-
-  // Plugin-registered layout providers (e.g. AI chat queue, tenant
-  // theme switcher). Wraps in registration order: the FIRST registered
-  // provider sits OUTERMOST (closest to the layout root); LAST sits
-  // INNERMOST (closest to the page tree). Empty / unset → no wrap.
-  const wrapped = wrapInLayoutProviders(
-    <ComponentRegistryProvider value={componentRegistry}>
-      <RightPanelRegistryProvider value={rightPanelRegistry}>
-        {rightSidebarMeta ? (
-          <RightSidebarProvider meta={rightSidebarMeta} basePath={props.basePath}>
-            {inner}
-          </RightSidebarProvider>
-        ) : (
-          inner
-        )}
-      </RightPanelRegistryProvider>
-    </ComponentRegistryProvider>,
-    layoutProviderRegistry,
-    props.basePath,
-  )
-
-  // `CurrentUserProvider` sits OUTSIDE the layout-provider chain so
-  // plugin-registered providers (e.g. `@pilotiq-pro/collab`'s
-  // CollabProvider, which threads the user into CollaborationCaret
-  // presence labels) can read the active user via `useCurrentUser()`.
-  // Value source mirrors what the top-right user dropdown renders.
-  return (
-    <CurrentUserProvider value={props.panel.userMenu?.user ?? null}>
-      {wrapped}
-    </CurrentUserProvider>
-  )
-}
-
-/**
- * Fold registered layout providers around `tree` from last to first so
- * the first-registered provider ends up outermost in the React tree
- * (closest to the layout root) — matches the registration-order
- * intuition documented on `Pilotiq.layoutProvider`.
- */
-function wrapInLayoutProviders(
-  tree:     React.ReactElement,
-  registry: ReadonlyArray<React.ComponentType<{ children: React.ReactNode; basePath?: string }>> | undefined,
-  basePath: string,
-): React.ReactElement {
-  if (!registry || registry.length === 0) return tree
-  let acc: React.ReactElement = tree
-  for (let i = registry.length - 1; i >= 0; i--) {
-    const Provider = registry[i]!
-    acc = <Provider basePath={basePath}>{acc}</Provider>
-  }
-  return acc
-}
-
-/**
- * Padding shim that compresses host content when the right sidebar is
- * open on desktop. The fixed-position rail would otherwise overlap
- * content; this wrapper reads the optional `RightSidebarProvider`
- * context (it's a no-op when the surface isn't mounted) and applies
- * `padding-inline-end` matching the active panel width.
- *
- * The shim avoids touching SidebarLayout / TopbarLayout internals — the
- * layouts expand to fill the wrapper's content box, so trimming inside
- * the wrapper compresses both the sticky header and the main scroll
- * region together.
- */
-function RightSidebarLayoutFrame({ children }: { children: React.ReactNode }) {
-  const sidebar = useRightSidebarOptional()
-  const isMobile = useIsMobile()
-  const apply = sidebar && sidebar.open && !isMobile
-  // Always render the same wrapper element so toggling open/closed
-  // doesn't remount the Layout subtree (which would drop the user's
-  // scroll position and any uncontrolled-input state). Only the inline
-  // style flips.
-  const style: React.CSSProperties | undefined = apply
-    ? { paddingInlineEnd: sidebar!.width, transition: 'padding-inline-end 150ms ease-out' }
-    : { transition: 'padding-inline-end 150ms ease-out' }
-  return <div style={style}>{children}</div>
-}