@wildo-ai/saas-frontend-lib 1.1.2 → 1.1.3

package/dist/esm/core/app-shell/app-shell.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.schemas.js","sourceRoot":"","sources":["../../../../../src/core/app-shell/app-shell.schemas.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAiM1E,MAAM,UAAU,qBAAqB,CAAC,MAAe;IACnD,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,WAAW,IAAI,MAAM,IAAI,aAAa,IAAI,MAAM,CAAC;AAC3G,CAAC;AAsBD,MAAM,UAAU,uBAAuB,CAAC,MAAe;IACrD,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AACjF,CAAC;AAWD,MAAM,UAAU,0BAA0B,CAAC,MAAe;IACxD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,MAAiC,CAAC;IACpD,MAAM,eAAe,GACnB,SAAS,CAAC,QAAQ,KAAK,SAAS;QAChC,SAAS,CAAC,QAAQ,KAAK,mBAAmB,CAAC,KAAK;QAChD,SAAS,CAAC,QAAQ,KAAK,mBAAmB,CAAC,GAAG,CAAC;IACjD,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAErF,OAAO,eAAe,IAAI,YAAY,CAAC;AACzC,CAAC;AAyKD,MAAM,CAAN,IAAY,6BAIX;AAJD,WAAY,6BAA6B;IACvC,8CAAa,CAAA;IACb,0EAAyC,CAAA;IACzC,4CAAW,CAAA;AACb,CAAC,EAJW,6BAA6B,KAA7B,6BAA6B,QAIxC;AAkHD,MAAM,CAAN,IAAY,+BAIX;AAJD,WAAY,+BAA+B;IACzC,oDAAiB,CAAA;IACjB,gDAAa,CAAA;IACb,oDAAiB,CAAA;AACnB,CAAC,EAJW,+BAA+B,KAA/B,+BAA+B,QAI1C;AA8CD,MAAM,CAAN,IAAY,uBAKX;AALD,WAAY,uBAAuB;IACjC,4CAAiB,CAAA;IACjB,4CAAiB,CAAA;IACjB,4CAAiB,CAAA;IACjB,4CAAiB,CAAA;AACnB,CAAC,EALW,uBAAuB,KAAvB,uBAAuB,QAKlC;AAED,MAAM,CAAN,IAAY,wBAGX;AAHD,WAAY,wBAAwB;IAClC,uCAAW,CAAA;IACX,6CAAiB,CAAA;AACnB,CAAC,EAHW,wBAAwB,KAAxB,wBAAwB,QAGnC;AAoMD;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,2BAGX;AAHD,WAAY,2BAA2B;IACrC,oDAAqB,CAAA;IACrB,kDAAmB,CAAA;AACrB,CAAC,EAHW,2BAA2B,KAA3B,2BAA2B,QAGtC","sourcesContent":["import type React from 'react';\nimport type { UseFormReturn } from 'react-hook-form';\nimport type { z } from 'zod';\n\nimport { HorizontalPlacement } from '@wildo-ai/presets-components-models';\nimport type { ForeignKeyDisplayMode, ViewportBreakpoint } from '@wildo-ai/zod-decorators';\nimport type { AppScopeFieldDefinition } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { ApplicationLevelComponentType, StatusBarItemType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport type { VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport type {\n  QuickSwitcherFieldPresentation,\n  UserDropdownAvatarDisplay,\n  UserDropdownSection,\n} from '~wildo-frontend-lib/core/config/app-configuration-frontend.schemas';\nimport type { FrontendComponentType, PlacementSide } from '@wildo-ai/presets-components-models';\nimport type { StandardIconReference } from '~wildo-frontend-lib/core/icons/icon-registry.frontend.schemas';\nimport type { HorizontalAlign, LayoutDirection } from '@wildo-ai/zod-decorators';\nimport type { Notification } from '~wildo-frontend-lib/core/events/NotificationContext';\nimport type { AnyNavigationItem } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { ResolvedControlPanelItem, ResolvedNavigationTarget } from '~wildo-frontend-lib/core/navigation/launcher-resolution';\nimport type { WebSocketStatus } from '~wildo-frontend-lib/core/requests/websockets/WebSocketContext';\nimport type {\n  ActivityBarRendering,\n  AppModeDefinition,\n  ResourceBrowserClickContext,\n  SidebarHomeDisplayMode,\n  SidebarSection,\n  SidebarSectionBehavior,\n  SidebarSectionContentKind,\n  SidebarSectionInlineCreate,\n  SidebarHostedComponent,\n  UtilityPanelItem,\n} from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport type { BrandAssetTheme } from '@wildo-ai/saas-models';\nimport type { BrandIdentity } from '~wildo-frontend-lib/core/branding/useBrandIdentity';\nimport { SidebarResponsivePolicy } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport type { HostedTriggerAppearance } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\n\n\n/** Navigation item with optional children for hierarchical rendering */\nexport type HierarchicalNavigationItem = AnyNavigationItem & {\n  children?: AnyNavigationItem[];\n  /**\n   * Canonical favorite identity for FAVORITES-section copies. A favorited item\n   * renders twice (its origin section AND the favorites section); the favorites\n   * copy carries a DISTINCT `id` (so the exactly-one-active invariant keeps a\n   * single highlighted row) and `favoriteId` = the origin item's id — the key\n   * the favorites store persists and the star toggle operates on. Absent on\n   * origin items (their own `id` IS the favorite key).\n   */\n  favoriteId?: string;\n};\n\n/**\n * A hosted component resolved from a surface's `hostedComponents` config entry,\n * ready for the preset to mount. Shared by BOTH the menubar and the sidebar —\n * they run one hosting pipeline (`resolveHostedComponents`) so the container\n * inversion model, interaction ownership, and per-placement width thread through\n * a single implementation rather than being duplicated per surface.\n *\n * `instanceId` is SURFACE-QUALIFIED (e.g. `menubar:command_menu-0`) so the\n * shell-level interaction owner can disambiguate the same component hosted in\n * two surfaces at once (a command-menu trigger in the menubar AND the sidebar).\n */\nexport interface ResolvedHostedComponent {\n  instanceId: string;\n  component: ApplicationLevelComponentType;\n  frontendComponentType: FrontendComponentType;\n  /**\n   * Horizontal zone (menubar) or vertical end (sidebar). Always concrete:\n   * `resolveHostedComponents` normalizes an omitted config `placement` to the\n   * surface's default zone (menubar START / sidebar TOP), so preset-side\n   * per-zone equality filters can never silently drop a hosted component.\n   */\n  placement: HorizontalPlacement | VerticalPlacement;\n  presetName?: string;\n  /** Per-placement trigger width override (see `MenubarHostedComponent.triggerWidth`). */\n  triggerWidth?: string | number;\n  /** Per-placement trigger appearance (see `HostedTriggerAppearance`). */\n  triggerAppearance?: HostedTriggerAppearance;\n}\n\n/**\n * Lightweight rendering props extracted from a sidebar section definition.\n * Used by the rendering layer (sidebar preset) to render section headers,\n * collapse behavior, and inline create — without coupling to the config schema.\n */\nexport interface SectionRenderProps {\n  ref: string;\n  label?: string;\n  icon?: string;\n  /** Whether the section header (label + icon) is rendered. Defaults to `true`. */\n  showLabel: boolean;\n  collapsible: boolean;\n  defaultCollapsed: boolean;\n  /**\n   * Primary navigation group — rendered at the top of the sidebar (no header,\n   * not collapsible), sharing that group with the framework Home row when\n   * `homeDisplayMode` is `NAVIGATION_ITEM`. See\n   * `SidebarSection_NavigationList.isPrimary`.\n   */\n  isPrimary?: boolean;\n  behavior?: SidebarSectionBehavior;\n  inlineCreate?: SidebarSectionInlineCreate;\n  inlineCreateResourceType?: string;\n  nested?: boolean;\n  maxNestingDepth?: number;\n}\n\n/**\n * A grouped sidebar section for rendering.\n *\n * When `contentKind` is undefined or `NAVIGATION_LIST`, this is a traditional\n * navigation item list. When `contentKind` is a different variant, the section\n * renders specialized content and `items` will be empty.\n */\nexport interface SectionGroup {\n  section: SectionRenderProps;\n  items: HierarchicalNavigationItem[];\n  moreMenuItems: HierarchicalNavigationItem[];\n  /**\n   * Discriminant from the new per-launcher config. When undefined, this section\n   * was produced by the old scan-based path (treat as NAVIGATION_LIST).\n   */\n  contentKind?: SidebarSectionContentKind;\n  /** RESOURCE_BROWSER: resource type to browse. */\n  resourceType?: string;\n  /** RESOURCE_BROWSER: operation override. */\n  operation?: string;\n  /** RESOURCE_BROWSER: operation variant. */\n  operationVariant?: string;\n  /** RESOURCE_BROWSER: click/navigation operation override. */\n  navigateOperation?: string;\n  /** RESOURCE_BROWSER: click/navigation operation variant. */\n  navigateOperationVariant?: string;\n  /** RESOURCE_BROWSER: client-side instance filter. */\n  instanceFilter?: (instance: Record<string, unknown>) => boolean;\n  /** RESOURCE_BROWSER: custom click handler. */\n  onInstanceClick?: (context: ResourceBrowserClickContext) => void;\n  /** GUIDANCE_WIDGET: guidance component ref. */\n  guidanceRef?: string;\n  /** CUSTOM_COMPONENT: custom component ref. */\n  componentRef?: string;\n}\n\n/**\n * Sidebar config object — matches the transformed shape from `UIContext`\n * (`ViewportAwareAppLevelComponentConfigurationSchema` → transformer →\n * `{ placement, collapsible, policy }`).\n *\n * The raw model uses `responsivePolicy`, but the transformer renames it\n * to `policy` in the runtime config.\n */\nexport interface SidebarConfigObject {\n  placement: HorizontalPlacement.START | HorizontalPlacement.END;\n  collapsible: boolean;\n  /**\n   * Starting rail state for a visitor with NO stored preference. Absent means\n   * the framework default, expanded. A persisted\n   * `LOCAL_STORAGE_KEYS.SIDEBAR_COLLAPSED` always wins over it — this is a\n   * starting position, not a lock.\n   */\n  defaultCollapsed?: boolean;\n  policy: SidebarResponsivePolicy;\n  /**\n   * Viewport threshold at (or below) which the responsive `policy` applies.\n   * Authored as `responsiveBreakpoint` in the raw model and carried through the\n   * UIContext transformer's rest-spread. Defaults to `ViewportBreakpoint.MOBILE`\n   * (the Zod schema default) when absent.\n   */\n  responsiveBreakpoint?: ViewportBreakpoint;\n  /**\n   * How the sidebar surfaces HOME (hidden / pinned brand header / navigation\n   * row). Absent means the framework default, `NAVIGATION_ITEM`, applied by\n   * `useSidebarBehavior`.\n   */\n  homeDisplayMode?: SidebarHomeDisplayMode;\n  /**\n   * Pins which brand-mark variant the BRAND_HEADER mode renders (e.g.\n   * `MONOCHROME`). Absent means adaptive light/dark.\n   */\n  brandMarkTheme?: BrandAssetTheme;\n  /** Per-launcher content declarations — discriminated union on `contentKind`. */\n  contentSections?: SidebarSection[];\n  /** Components hosted inside the sidebar via container inversion (mirror of menubar `hostedComponents`). */\n  hostedComponents?: SidebarHostedComponent[];\n  defaultSection?: string;\n  /** Desktop sidebar width in px. Defaults to 256. */\n  width?: number;\n  /** Mobile sidebar width in px. Defaults to 280. */\n  mobileWidth?: number;\n  /** Desktop collapsed width in px. Defaults to 64. */\n  collapsedWidth?: number;\n  /** Mobile collapsed width in px. Defaults to 56. */\n  mobileCollapsedWidth?: number;\n}\n\nexport function isSidebarConfigObject(config: unknown): config is SidebarConfigObject {\n  return typeof config === 'object' && config !== null && 'placement' in config && 'collapsible' in config;\n}\n\n/**\n * Narrowing guard for StatusBar object config.\n * StatusBar config can be `boolean | VerticalPlacement (string) | object`.\n * This guard identifies the object form, distinguishing it from both\n * the boolean and string-shorthand variants.\n */\nexport interface StatusBarConfigObject {\n  placement?: VerticalPlacement;\n  showMemoryUsage?: boolean;\n  showNotificationCount?: boolean;\n  showConnectionStatus?: boolean;\n  showConnectionStatusOnMobile?: boolean;\n  backgroundClassName?: string;\n  textClassName?: string;\n  showBorder?: boolean;\n  height?: number;\n  statusItems?: StatusBarConfigItem[];\n  style?: React.CSSProperties;\n}\n\nexport function isStatusBarConfigObject(config: unknown): config is StatusBarConfigObject {\n  return typeof config === 'object' && config !== null && !Array.isArray(config);\n}\n\nexport type UtilityPanelPlacement =\n  | HorizontalPlacement.START\n  | HorizontalPlacement.END;\n\nexport interface UtilityPanelConfigObject {\n  items?: UtilityPanelItem[];\n  position?: UtilityPanelPlacement;\n}\n\nexport function isUtilityPanelConfigObject(config: unknown): config is UtilityPanelConfigObject {\n  if (typeof config !== 'object' || config === null || Array.isArray(config)) {\n    return false;\n  }\n\n  const candidate = config as Record<string, unknown>;\n  const isValidPosition =\n    candidate.position === undefined ||\n    candidate.position === HorizontalPlacement.START ||\n    candidate.position === HorizontalPlacement.END;\n  const isValidItems = candidate.items === undefined || Array.isArray(candidate.items);\n\n  return isValidPosition && isValidItems;\n}\n\n\n// ---------------------------------------------------------------------------\n// Behavior hook return types\n// ---------------------------------------------------------------------------\n\n/**\n * Standalone navigation behavioral utilities — active-state checking,\n * display policy evaluation, click dispatch, and home navigation.\n *\n * Does NOT include items — consumers obtain items from per-launcher\n * resolution or auto-items.\n *\n * `handleNavigationClick` accepts `launcher` as a second parameter since\n * this interface is not scoped to a single launcher.\n */\nexport interface NavigationBehaviors {\n  isNavigationItemActive: (urlPath: string) => boolean;\n  shouldShowItem: (item: AnyNavigationItem) => 'visible' | 'more_menu' | 'hidden';\n  handleNavigationClick: (item: AnyNavigationItem, launcher: ApplicationLevelComponentType) => void;\n  handleHomeClick: () => void;\n  isHomeActive: boolean;\n}\n\nexport interface SidebarBehavior {\n  groupedSections: SectionGroup[];\n  /**\n   * Components hosted in the sidebar (container inversion), resolved from\n   * `[SIDEBAR].hostedComponents` through the SAME pipeline the menubar uses.\n   * The preset resolves each via the component registry and mounts it with the\n   * shell-level interaction-owner props.\n   */\n  hostedComponents: ResolvedHostedComponent[];\n  isCollapsed: boolean;\n  isHomeActive: boolean;\n  dimensions: { width: number; collapsedWidth: number };\n  sidebarConfig: {\n    isCollapsible: boolean;\n    responsivePolicy: SidebarResponsivePolicy;\n    placementClass: string;\n    currentWidth: number;\n  };\n  isNavigationLoading: boolean;\n  hasItems: boolean;\n  placement: HorizontalPlacement;\n\n  /**\n   * How the sidebar must surface HOME — hidden, the pinned brand header, or a\n   * navigation row. Resolved from config with the framework default applied, so\n   * a preset never re-derives it.\n   */\n  homeDisplayMode: SidebarHomeDisplayMode;\n  /**\n   * App name + resolved brand-asset URL for the pinned header. Present ONLY in\n   * `SidebarHomeDisplayMode.BRAND_HEADER`; `logoUrl` is itself optional because\n   * an application may not have generated a brand yet.\n   */\n  brandHeader?: BrandIdentity;\n\n  /**\n   * `true` when the current viewport is at (or below) the sidebar's configured\n   * `responsiveBreakpoint` AND the responsive policy is `BURGER`. In this mode the\n   * sidebar renders NOTHING inline (width 0) and instead opens as an overlay drawer\n   * (`isMobileDrawerOpen`) toggled by the menubar burger / `HOTKEY_SIDEBAR_TOGGLE`.\n   */\n  isMobileDrawerMode: boolean;\n  /** Drawer open state — only meaningful while `isMobileDrawerMode` is true. */\n  isMobileDrawerOpen: boolean;\n  /** Closes the mobile drawer (backdrop click, Escape, post-navigation dismiss). */\n  closeMobileDrawer: () => void;\n\n  /**\n   * Active-state check keyed on the ITEM's resolved `id`, not on the raw path:\n   * two DISTINCT items sharing an identical `urlPath` (e.g. an item and its\n   * favorites-section copy, which carries a `favorite-` prefixed id) must not\n   * both highlight — one id (the first in section order carrying the winning\n   * path) is elected (frontend-ux-quality-audit E2). Caveat: resolved ids are\n   * deterministic per TARGET (`resolved-<type>-<op>-<variant>`), so declaring\n   * the SAME launcher target in two sections yields two rows with one shared\n   * id, and both still highlight — dedupe such declarations in config instead\n   * (WT once declared Todos twice and hit exactly this).\n   */\n  isNavigationItemActive: (item: { id: string; urlPath?: string }) => boolean;\n  isSectionCollapsed: (section: SectionRenderProps) => boolean;\n  isItemCollapsed: (itemId: string) => boolean;\n\n  handleNavigationClick: (item: AnyNavigationItem) => void;\n  handleHomeClick: () => void;\n  handleToggleCollapse: () => void;\n  handleToggleSectionCollapse: (sectionRef: string) => void;\n  handleToggleItemCollapse: (itemId: string) => void;\n\n  /**\n   * `true` when the item is in the user's favorites. Accepts either an origin\n   * item (keyed by its own `id`) or a favorites-section copy (keyed by its\n   * `favoriteId`).\n   */\n  isItemFavorite: (item: Pick<HierarchicalNavigationItem, 'id' | 'favoriteId'>) => boolean;\n  /**\n   * Toggles the item in the persisted favorites set (star affordance). The\n   * favorites section re-populates immediately; storage is machine-local\n   * (`LOCAL_STORAGE_KEYS.SIDEBAR_FAVORITES`).\n   */\n  handleToggleItemFavorite: (item: Pick<HierarchicalNavigationItem, 'id' | 'favoriteId'>) => void;\n  /**\n   * Whether any `SidebarSectionBehavior.FAVORITES` section is configured — the\n   * preset only offers the star affordance when favoriting has a destination.\n   */\n  hasFavoritesSection: boolean;\n\n  inlineCreate: {\n    activeSection: string | null;\n    value: string;\n    start: (sectionRef: string) => void;\n    cancel: () => void;\n    submit: (sectionRef: string, resourceType?: string) => void;\n    setValue: (value: string) => void;\n  };\n}\n\nexport interface AppShellLayoutInfo {\n  hasMenubar: boolean;\n  hasSidebar: boolean;\n  hasStatusBar: boolean;\n  hasToolbar: boolean;\n  hasActivityBar: boolean;\n  hasQuickActionButton: boolean;\n  hasUtilityPanel: boolean;\n  sidebarPlacement: HorizontalPlacement;\n  statusBarPlacement: VerticalPlacement;\n  utilityPanelPlacement: UtilityPanelPlacement;\n  isLayoutReady: boolean;\n}\n\nexport interface PublicShellLayoutInfo {\n  useCardLayout: boolean;\n  isReady: boolean;\n  /**\n   * The identity to present above the public card, or `undefined` when the application has not\n   * opted in via `publicShellIdentityMode`.\n   *\n   * EXPOSED only in the opted-in mode rather than always, mirroring `useSidebarBehavior`'s\n   * `brandHeader`: a preset that receives an identity unconditionally can render a mark on a\n   * surface the application never asked to brand, and no type would catch it.\n   */\n  brandHeader?: BrandIdentity;\n}\n\nexport interface ToolbarDisplayItem {\n  id: string;\n  label: string;\n  icon?: React.ReactNode;\n  iconOnly?: boolean;\n  onClick: () => void;\n}\n\nexport interface ToolbarBehavior {\n  tools: ToolbarDisplayItem[];\n  toolbarConfig: {\n    placement: 'top' | 'bottom';\n    compact: boolean;\n    showSeparator: boolean;\n    hideOnMobile: boolean;\n  };\n  shouldRender: boolean;\n  currentBreakpoint: string | undefined;\n}\n\nexport enum QuickSwitcherFieldControlKind {\n  ENUM = 'enum',\n  RESOURCE_REFERENCE = 'resource_reference',\n  RAW = 'raw',\n}\n\nexport interface QuickSwitcherResolvedField {\n  fieldId: string;\n  /** Guaranteed non-empty (config label → resource title → humanized field id → field id). */\n  label: string;\n  schema: z.ZodTypeAny;\n  valueSchema: z.ZodTypeAny;\n  disabled: boolean;\n  isMultiple: boolean;\n  controlKind: QuickSwitcherFieldControlKind;\n  /**\n   * Explicit target for `RESOURCE_REFERENCE` controls whose schema carries no\n   * `isForeignKey` metadata — i.e. the primary-key fallback, where the switcher\n   * is by definition selecting an instance of the scope field's `resourceType`.\n   * `undefined` for FK-decorated schemas (the FK metadata names the target).\n   */\n  targetResourceType?: string;\n  /** Input placeholder — localized resource title, falling back to `label`. Non-empty. */\n  placeholder: string;\n  /**\n   * How each dropdown option renders — the declared\n   * `appScope.fields[].optionDisplayMode`, defaulted to `LABEL`. Reuses the\n   * framework's FK-rendering vocabulary: `LABEL` is the resource's own display\n   * label, `SUMMARY` is its summary card.\n   */\n  optionDisplayMode: ForeignKeyDisplayMode;\n  /**\n   * Clear this field's ambient scope. A scope is inherently OPTIONAL — \"no list\n   * selected\" is a first-class state the collection surfaces already produce —\n   * so the control always offers an explicit way back to it rather than relying\n   * on the combobox's undiscoverable re-click-to-toggle.\n   */\n  onClear: () => void;\n  /** Whether anything is currently selected (drives the clear affordance). */\n  hasValue: boolean;\n  /**\n   * How the closed control presents — the declared\n   * `appScope.fields[].presentation`, defaulted to `CONTROL_ONLY`.\n   *\n   * Carried as DATA, never as a rendered node: resolving the resource's icon is\n   * component-registry work, so the preset does it. Behavior hooks in this\n   * framework never return `ReactNode` nor perform registry resolution.\n   */\n  presentation: QuickSwitcherFieldPresentation;\n  definition: AppScopeFieldDefinition;\n}\n\nexport interface QuickSwitcherBehavior {\n  fields: QuickSwitcherResolvedField[];\n  formMethods: UseFormReturn;\n  layoutDirection: 'horizontal' | 'vertical';\n  /**\n   * Monotonically increasing counter — incremented when the\n   * `HOTKEY_QUICK_SWITCHER_OPEN` event fires. Presets should watch\n   * this value and focus the first enabled field when it changes.\n   */\n  focusTrigger: number;\n}\n\nexport interface StatusBarBehavior {\n  totalBadgeCount: number;\n  connectionStatus: WebSocketStatus;\n  showConnectionStatus: boolean;\n  showConnectionStatusOnMobile: boolean;\n  shouldShowConnectionStatus: boolean;\n  showNotificationCount: boolean;\n  shouldShowNotificationCount: boolean;\n  showMemoryUsage: boolean;\n  memoryUsageLabel: string | null;\n  notificationCountLabel: string;\n  notificationCountAriaLabel: string;\n  connectionStatusLabel: string;\n  statusItems: StatusBarDisplayItem[];\n  dimensions: { height: number };\n  statusBarConfig: {\n    isTop: boolean;\n    isBottom: boolean;\n    isMobile: boolean;\n    backgroundClassName: string;\n    textClassName: string;\n    showBorder: boolean;\n  };\n  customStyle?: React.CSSProperties;\n  currentBreakpoint: string | undefined;\n}\n\nexport interface StatusBarConfigItemBase {\n  id: string;\n  label: string;\n  type: StatusBarItemType;\n  icon?: string;\n  value?: string | number;\n}\n\nexport interface StatusBarConfigItem_Link extends StatusBarConfigItemBase {\n  type: StatusBarItemType.LINK;\n  href: string;\n}\n\nexport interface StatusBarConfigItem_Button extends StatusBarConfigItemBase {\n  type: StatusBarItemType.BUTTON;\n  onClick: () => void;\n}\n\nexport interface StatusBarConfigItem_Text extends StatusBarConfigItemBase {\n  type: StatusBarItemType.TEXT;\n}\n\nexport type StatusBarConfigItem =\n  | StatusBarConfigItem_Link\n  | StatusBarConfigItem_Button\n  | StatusBarConfigItem_Text;\n\nexport enum StatusBarDisplayInteractionType {\n  STATIC = 'static',\n  LINK = 'link',\n  BUTTON = 'button',\n}\n\nexport interface StatusBarDisplayInteraction_Static {\n  type: StatusBarDisplayInteractionType.STATIC;\n}\n\nexport interface StatusBarDisplayInteraction_Link {\n  type: StatusBarDisplayInteractionType.LINK;\n  href: string;\n}\n\nexport interface StatusBarDisplayInteraction_Button {\n  type: StatusBarDisplayInteractionType.BUTTON;\n  onClick: () => void;\n}\n\nexport type StatusBarDisplayInteraction =\n  | StatusBarDisplayInteraction_Static\n  | StatusBarDisplayInteraction_Link\n  | StatusBarDisplayInteraction_Button;\n\nexport interface StatusBarDisplayItem {\n  id: string;\n  label: string;\n  iconReference?: string;\n  valueText?: string;\n  interaction: StatusBarDisplayInteraction;\n}\n\nexport interface ActivityBarLayout {\n  direction: LayoutDirection;\n  borderSide: PlacementSide;\n  tooltipSide: PlacementSide;\n  orientation: LayoutDirection;\n}\n\nexport interface ActivityBarBehavior {\n  availableModes: AppModeDefinition[];\n  activeMode: string | null;\n  setActiveMode: (mode: string) => void;\n  hasModes: boolean;\n  activeRenderingMode: ActivityBarRendering;\n  layout: ActivityBarLayout;\n  isNavigationLoading: boolean;\n}\n\nexport enum ControlPanelControlType {\n  BUTTON = 'button',\n  TOGGLE = 'toggle',\n  SLIDER = 'slider',\n  SELECT = 'select',\n}\n\nexport enum NotificationCenterFilter {\n  ALL = 'all',\n  UNREAD = 'unread',\n}\n\nexport interface ControlPanelBehavior {\n  isOpen: boolean;\n  setIsOpen: (open: boolean) => void;\n  groupedItems: Record<string, ControlPanelNavigationItem[]>;\n  sections: ControlPanelSection[];\n  controls: ControlPanelDisplayControl[];\n  handleItemClick: (item: ControlPanelNavigationItem) => void;\n  sheetSide: PlacementSide;\n  isNavigationLoading: boolean;\n  navigationItemCount: number;\n  currentBreakpoint: string | undefined;\n}\n\nexport type ControlPanelNavigationItem = ResolvedControlPanelItem;\n\nexport interface ControlPanelSection {\n  id: string;\n  label: string;\n  items: ControlPanelNavigationItem[];\n}\n\nexport interface ControlPanelDisplayControlBase {\n  id: string;\n  label: string;\n  type: ControlPanelControlType;\n  disabled: boolean;\n}\n\nexport interface ControlPanelDisplayControl_Button extends ControlPanelDisplayControlBase {\n  type: ControlPanelControlType.BUTTON;\n  onTrigger: () => void;\n}\n\nexport interface ControlPanelDisplayControl_Toggle extends ControlPanelDisplayControlBase {\n  type: ControlPanelControlType.TOGGLE;\n  value: boolean;\n  onToggle: () => void;\n}\n\nexport interface ControlPanelDisplayControl_SelectOption {\n  label: string;\n  value: unknown;\n  isSelected: boolean;\n  onSelect: () => void;\n}\n\nexport interface ControlPanelDisplayControl_Select extends ControlPanelDisplayControlBase {\n  type: ControlPanelControlType.SELECT;\n  value?: unknown;\n  options: ControlPanelDisplayControl_SelectOption[];\n}\n\nexport interface ControlPanelDisplayControl_Slider extends ControlPanelDisplayControlBase {\n  type: ControlPanelControlType.SLIDER;\n  value: number;\n  min: number;\n  max: number;\n  step: number;\n  onValueChange: (value: number) => void;\n}\n\nexport type ControlPanelDisplayControl =\n  | ControlPanelDisplayControl_Button\n  | ControlPanelDisplayControl_Toggle\n  | ControlPanelDisplayControl_Select\n  | ControlPanelDisplayControl_Slider;\n\nexport interface UtilityPanelDisplayItem {\n  componentRef: string;\n  componentType: FrontendComponentType | null;\n  icon: string;\n  label: string;\n}\n\nexport interface UtilityPanelBehavior {\n  /** Whether the panel is expanded/open. */\n  isOpen: boolean;\n  setIsOpen: (open: boolean) => void;\n  /** Panel items normalized for display without moving registry resolution into the hook. */\n  items: UtilityPanelDisplayItem[];\n  /** Number of items. */\n  itemCount: number;\n  /** Horizontal position (START or END only). */\n  position: UtilityPanelPlacement;\n  /** Current breakpoint for responsive adjustments. */\n  currentBreakpoint: string | undefined;\n}\n\nexport interface NotificationCenterBehavior {\n  isOpen: boolean;\n  setIsOpen: (open: boolean) => void;\n  filter: NotificationCenterFilter;\n  setFilter: (filter: NotificationCenterFilter) => void;\n  unreadCount: number;\n  filteredNotifications: NotificationCenterDisplayNotification[];\n  groupedNotifications: {\n    today: NotificationCenterDisplayNotification[];\n    yesterday: NotificationCenterDisplayNotification[];\n    older: NotificationCenterDisplayNotification[];\n  };\n  notificationCount: number;\n  handleNotificationClick: (notification: NotificationCenterDisplayNotification) => void;\n  handleMarkAllAsRead: () => void;\n  handleClearAll: () => void;\n  dismissNotification: (notificationId: string) => void;\n}\n\nexport interface NotificationCenterDisplayNotification {\n  id: string;\n  type: Notification['type'];\n  source: Notification['source'];\n  timestamp: number;\n  isRead: boolean;\n  displayTitle: string;\n  displayMessage: string;\n  relativeTimeLabel: string;\n  iconReference: StandardIconReference;\n  nextStep?: Notification['nextStep'];\n}\n\nexport interface QuickActionButtonDisplayItem {\n  id: string;\n  label: string;\n  icon?: React.ReactNode;\n  displayPolicy?: string;\n  onClick: () => void;\n}\n\nexport interface QuickActionButtonBehavior {\n  allItems: QuickActionButtonDisplayItem[];\n  primaryAction: QuickActionButtonDisplayItem | null;\n  menuActions: QuickActionButtonDisplayItem[];\n  isOpen: boolean;\n  setIsOpen: (open: boolean) => void;\n  handleActionClick: (item: QuickActionButtonDisplayItem) => void;\n  hasActions: boolean;\n  isNavigationLoading: boolean;\n  currentBreakpoint: string | undefined;\n}\n\nexport interface CommandMenuItem {\n  id: string;\n  label: string;\n  shortcut: string;\n  icon?: React.ReactNode;\n  category: string;\n  keywords: string[];\n  /** Internal policy from config — used by the hook to control grouping/visibility. */\n  displayPolicy?: string;\n  onExecute: () => void;\n}\n\nexport interface CommandMenuGroup {\n  category: string;\n  label: string;\n  items: CommandMenuItem[];\n}\n\n/**\n * One live omnibox record-search result. Intentionally DISTINCT from\n * {@link CommandMenuItem}: a search result is a resource RECORD (it carries the\n * full summary-mode DTO in `record` + its `resourceType`) so the palette can\n * render it as the resource's summary VIEW (summary card), whereas a\n * `CommandMenuItem` is a static navigation command that only ever renders a\n * label + icon. Merging the two would collapse that semantic distinction and\n * force every static command to carry a nullable record.\n */\nexport interface CommandMenuSearchResultItem {\n  id: string;\n  /** Resource type of the matched record — drives summary-view + navigation. */\n  resourceType: string;\n  /** Full summary-mode DTO returned by SEARCH — fed to the summary renderer. */\n  record: Record<string, unknown>;\n  /** Resolved one-line label (LABEL display mode + summary-card fallback). */\n  label: string;\n  /**\n   * Client-side match terms carried so cmdk's filter never drops a legitimate\n   * server hit (always includes the raw query; matches may be on a field absent\n   * from the label, e.g. `description`).\n   */\n  keywords: string[];\n  /** Navigate to the matched record's addressable READ view, then close. */\n  onExecute: () => void;\n}\n\n/** A group of omnibox search results for one searched resource. */\nexport interface CommandMenuSearchResultGroup {\n  category: string;\n  label: string;\n  /** How each item in this group renders (summary card vs. one-line label). */\n  displayMode: ForeignKeyDisplayMode;\n  items: CommandMenuSearchResultItem[];\n}\n\n/**\n * Discriminant for {@link CommandMenuPaletteGroup} — whether an entry in the\n * unified, ordered palette list is a static command-category group or a live\n * record-search result group. The two stay DISTINCT types (a command is a\n * navigation target rendering a label; a record carries a full DTO rendering a\n * summary card) — this union only sequences them in one render order, it does\n * not merge their semantics.\n */\nexport enum CommandMenuPaletteGroupKind {\n  COMMANDS = 'commands',\n  RECORDS = 'records',\n}\n\n/**\n * One entry in the palette's SINGLE ordered group list — either a static\n * command-category group or a live record-search group, tagged with the numeric\n * `order` weight the palette sorted by (lower = higher). Produced by\n * `useCommandMenuBehavior` so the preset renders one uniform, ordered sequence\n * (record groups default above command groups while searching) instead of two\n * hard-coded blocks. The recent-commands group is rendered separately (always\n * pinned to the top) and is not part of this list.\n */\nexport type CommandMenuPaletteGroup =\n  | { kind: CommandMenuPaletteGroupKind.COMMANDS; order: number; group: CommandMenuGroup }\n  | { kind: CommandMenuPaletteGroupKind.RECORDS; order: number; group: CommandMenuSearchResultGroup };\n\nexport interface CommandMenuBehavior {\n  isOpen: boolean;\n  handleOpenChange: (open: boolean) => void;\n  searchQuery: string;\n  setSearchQuery: (query: string) => void;\n  commandItems: CommandMenuItem[];\n  groupedItems: CommandMenuGroup[];\n  recentItems: CommandMenuItem[];\n  /**\n   * Live record-search result groups (omnibox layer). Empty unless the\n   * `COMMAND_MENU` config sets `policy: OMNIBOX` with `searchResources` and the\n   * current query meets the minimum length. Each item's `onExecute` navigates\n   * to the matched record's READ view. Items render as the resource's summary\n   * view (or a one-line label per the resource's `resultDisplay` config).\n   */\n  searchResultGroups: CommandMenuSearchResultGroup[];\n  /**\n   * The unified, ORDERED render list the preset iterates: record groups and\n   * static command-category groups merged and sorted by a single numeric `order`\n   * weight (record groups default above command groups while searching; apps\n   * override per record group via `CommandMenuSearchResource.order`, and command\n   * categories sequence among themselves via `[COMMAND_MENU].categoryOrder`).\n   * The recent-commands group is NOT included here — it is always rendered first,\n   * separately. Derived from `groupedItems` + `searchResultGroups` (which remain\n   * available as the raw, per-source building blocks).\n   */\n  orderedGroups: CommandMenuPaletteGroup[];\n  /** True while an omnibox record search is in flight for the current query. */\n  isSearching: boolean;\n  isNavigationLoading: boolean;\n  showRecent: boolean;\n  showShortcuts: boolean;\n  /**\n   * Global open-shortcut string (e.g. `'Cmd+K'`) from config, or `undefined`\n   * when none is declared. The preset renders it as the trigger's `⌘K` hint.\n   */\n  openShortcut: string | undefined;\n  /**\n   * Desktop max-width Tailwind class for the palette dialog (see\n   * `[COMMAND_MENU].dialogWidth`). Always `sm:`-prefixed so mobile stays\n   * near-full-width. Defaults to `sm:max-w-2xl`.\n   */\n  dialogWidth: string;\n}\n\nexport interface MenuUserOrgBehavior {\n  isOpen: boolean;\n  setIsOpen: (open: boolean) => void;\n  isUserAuthenticated: boolean;\n  userInitials: string;\n  displayName: string;\n  email: string;\n  avatarUrl: string | undefined;\n  currentOrganization: { _id: string; name: string } | undefined;\n  organizations: { _id: string; name: string }[];\n  /** Dropdown sections to render. The `SETTINGS` entry opens the unified Settings Hub. */\n  sections: UserDropdownSection[];\n  avatarDisplay: UserDropdownAvatarDisplay;\n  showOrgSwitcher: boolean;\n  showLogout: boolean;\n  settingsTarget: ResolvedNavigationTarget | null;\n  settingsTargets: ResolvedNavigationTarget[];\n  popupAlignment: { align: HorizontalAlign; side: PlacementSide };\n  handleLogout: () => void;\n  handleSwitchOrg: (orgId: string) => void;\n  handleNavigateToSettingsTarget: (target: ResolvedNavigationTarget) => void;\n}\n\nexport interface MenuBarBehavior {\n  containerComponents: ResolvedHostedComponent[];\n  items: {\n    id: string;\n    label: string;\n    icon?: React.ReactNode;\n    group?: string;\n    onExecute: () => void;\n  }[];\n  menubarConfig: {\n    mode: string;\n    isOverlay: boolean;\n    showMobileLayout: boolean;\n  };\n  mapToFrontendComponentType: (type: ApplicationLevelComponentType) => FrontendComponentType | null;\n}\n"]}
+{"version":3,"file":"app-shell.schemas.js","sourceRoot":"","sources":["../../../../src/core/app-shell/app-shell.schemas.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAkM1E,MAAM,UAAU,qBAAqB,CAAC,MAAe;IACnD,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,WAAW,IAAI,MAAM,IAAI,aAAa,IAAI,MAAM,CAAC;AAC3G,CAAC;AAsBD,MAAM,UAAU,uBAAuB,CAAC,MAAe;IACrD,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AACjF,CAAC;AAWD,MAAM,UAAU,0BAA0B,CAAC,MAAe;IACxD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,MAAiC,CAAC;IACpD,MAAM,eAAe,GACnB,SAAS,CAAC,QAAQ,KAAK,SAAS;QAChC,SAAS,CAAC,QAAQ,KAAK,mBAAmB,CAAC,KAAK;QAChD,SAAS,CAAC,QAAQ,KAAK,mBAAmB,CAAC,GAAG,CAAC;IACjD,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAErF,OAAO,eAAe,IAAI,YAAY,CAAC;AACzC,CAAC;AAyKD,MAAM,CAAN,IAAY,6BAIX;AAJD,WAAY,6BAA6B;IACvC,8CAAa,CAAA;IACb,0EAAyC,CAAA;IACzC,4CAAW,CAAA;AACb,CAAC,EAJW,6BAA6B,KAA7B,6BAA6B,QAIxC;AAkHD,MAAM,CAAN,IAAY,+BAIX;AAJD,WAAY,+BAA+B;IACzC,oDAAiB,CAAA;IACjB,gDAAa,CAAA;IACb,oDAAiB,CAAA;AACnB,CAAC,EAJW,+BAA+B,KAA/B,+BAA+B,QAI1C;AA8CD,MAAM,CAAN,IAAY,uBAKX;AALD,WAAY,uBAAuB;IACjC,4CAAiB,CAAA;IACjB,4CAAiB,CAAA;IACjB,4CAAiB,CAAA;IACjB,4CAAiB,CAAA;AACnB,CAAC,EALW,uBAAuB,KAAvB,uBAAuB,QAKlC;AA+ND;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,2BAGX;AAHD,WAAY,2BAA2B;IACrC,oDAAqB,CAAA;IACrB,kDAAmB,CAAA;AACrB,CAAC,EAHW,2BAA2B,KAA3B,2BAA2B,QAGtC","sourcesContent":["import type React from 'react';\nimport type { UseFormReturn } from 'react-hook-form';\nimport type { z } from 'zod';\n\nimport { HorizontalPlacement } from '@wildo-ai/presets-components-models';\nimport type { ForeignKeyDisplayMode, ViewportBreakpoint } from '@wildo-ai/zod-decorators';\nimport type { AppScopeFieldDefinition } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport type { ApplicationLevelComponentType, StatusBarItemType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport type { VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport type {\n  QuickSwitcherFieldPresentation,\n  UserDropdownAvatarDisplay,\n  UserDropdownSection,\n} from '~wildo-frontend-lib/core/config/app-configuration-frontend.schemas';\nimport type { FrontendComponentType, PlacementSide } from '@wildo-ai/presets-components-models';\nimport type { StandardIconReference } from '~wildo-frontend-lib/core/icons/icon-registry.frontend.schemas';\nimport type { LauncherItemTargetKind } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport type { HorizontalAlign, LayoutDirection } from '@wildo-ai/zod-decorators';\nimport type { Notification } from '~wildo-frontend-lib/core/events/NotificationContext';\nimport type { AnyNavigationItem } from '~wildo-frontend-lib/core/navigation/navigation.schemas';\nimport type { ResolvedControlPanelItem, ResolvedNavigationTarget } from '~wildo-frontend-lib/core/navigation/launcher-resolution';\nimport type { WebSocketStatus } from '~wildo-frontend-lib/core/requests/websockets/WebSocketContext';\nimport type {\n  ActivityBarRendering,\n  AppModeDefinition,\n  ResourceBrowserClickContext,\n  SidebarHomeDisplayMode,\n  SidebarSection,\n  SidebarSectionBehavior,\n  SidebarSectionContentKind,\n  SidebarSectionInlineCreate,\n  SidebarHostedComponent,\n  UtilityPanelItem,\n} from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport type { BrandAssetTheme } from '@wildo-ai/saas-models';\nimport type { BrandIdentity } from '~wildo-frontend-lib/core/branding/useBrandIdentity';\nimport { SidebarResponsivePolicy } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport type { HostedTriggerAppearance } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\n\n\n/** Navigation item with optional children for hierarchical rendering */\nexport type HierarchicalNavigationItem = AnyNavigationItem & {\n  children?: AnyNavigationItem[];\n  /**\n   * Canonical favorite identity for FAVORITES-section copies. A favorited item\n   * renders twice (its origin section AND the favorites section); the favorites\n   * copy carries a DISTINCT `id` (so the exactly-one-active invariant keeps a\n   * single highlighted row) and `favoriteId` = the origin item's id — the key\n   * the favorites store persists and the star toggle operates on. Absent on\n   * origin items (their own `id` IS the favorite key).\n   */\n  favoriteId?: string;\n};\n\n/**\n * A hosted component resolved from a surface's `hostedComponents` config entry,\n * ready for the preset to mount. Shared by BOTH the menubar and the sidebar —\n * they run one hosting pipeline (`resolveHostedComponents`) so the container\n * inversion model, interaction ownership, and per-placement width thread through\n * a single implementation rather than being duplicated per surface.\n *\n * `instanceId` is SURFACE-QUALIFIED (e.g. `menubar:command_menu-0`) so the\n * shell-level interaction owner can disambiguate the same component hosted in\n * two surfaces at once (a command-menu trigger in the menubar AND the sidebar).\n */\nexport interface ResolvedHostedComponent {\n  instanceId: string;\n  component: ApplicationLevelComponentType;\n  frontendComponentType: FrontendComponentType;\n  /**\n   * Horizontal zone (menubar) or vertical end (sidebar). Always concrete:\n   * `resolveHostedComponents` normalizes an omitted config `placement` to the\n   * surface's default zone (menubar START / sidebar TOP), so preset-side\n   * per-zone equality filters can never silently drop a hosted component.\n   */\n  placement: HorizontalPlacement | VerticalPlacement;\n  presetName?: string;\n  /** Per-placement trigger width override (see `MenubarHostedComponent.triggerWidth`). */\n  triggerWidth?: string | number;\n  /** Per-placement trigger appearance (see `HostedTriggerAppearance`). */\n  triggerAppearance?: HostedTriggerAppearance;\n}\n\n/**\n * Lightweight rendering props extracted from a sidebar section definition.\n * Used by the rendering layer (sidebar preset) to render section headers,\n * collapse behavior, and inline create — without coupling to the config schema.\n */\nexport interface SectionRenderProps {\n  ref: string;\n  label?: string;\n  icon?: string;\n  /** Whether the section header (label + icon) is rendered. Defaults to `true`. */\n  showLabel: boolean;\n  collapsible: boolean;\n  defaultCollapsed: boolean;\n  /**\n   * Primary navigation group — rendered at the top of the sidebar (no header,\n   * not collapsible), sharing that group with the framework Home row when\n   * `homeDisplayMode` is `NAVIGATION_ITEM`. See\n   * `SidebarSection_NavigationList.isPrimary`.\n   */\n  isPrimary?: boolean;\n  behavior?: SidebarSectionBehavior;\n  inlineCreate?: SidebarSectionInlineCreate;\n  inlineCreateResourceType?: string;\n  nested?: boolean;\n  maxNestingDepth?: number;\n}\n\n/**\n * A grouped sidebar section for rendering.\n *\n * When `contentKind` is undefined or `NAVIGATION_LIST`, this is a traditional\n * navigation item list. When `contentKind` is a different variant, the section\n * renders specialized content and `items` will be empty.\n */\nexport interface SectionGroup {\n  section: SectionRenderProps;\n  items: HierarchicalNavigationItem[];\n  moreMenuItems: HierarchicalNavigationItem[];\n  /**\n   * Discriminant from the new per-launcher config. When undefined, this section\n   * was produced by the old scan-based path (treat as NAVIGATION_LIST).\n   */\n  contentKind?: SidebarSectionContentKind;\n  /** RESOURCE_BROWSER: resource type to browse. */\n  resourceType?: string;\n  /** RESOURCE_BROWSER: operation override. */\n  operation?: string;\n  /** RESOURCE_BROWSER: operation variant. */\n  operationVariant?: string;\n  /** RESOURCE_BROWSER: click/navigation operation override. */\n  navigateOperation?: string;\n  /** RESOURCE_BROWSER: click/navigation operation variant. */\n  navigateOperationVariant?: string;\n  /** RESOURCE_BROWSER: client-side instance filter. */\n  instanceFilter?: (instance: Record<string, unknown>) => boolean;\n  /** RESOURCE_BROWSER: custom click handler. */\n  onInstanceClick?: (context: ResourceBrowserClickContext) => void;\n  /** GUIDANCE_WIDGET: guidance component ref. */\n  guidanceRef?: string;\n  /** CUSTOM_COMPONENT: custom component ref. */\n  componentRef?: string;\n}\n\n/**\n * Sidebar config object — matches the transformed shape from `UIContext`\n * (`ViewportAwareAppLevelComponentConfigurationSchema` → transformer →\n * `{ placement, collapsible, policy }`).\n *\n * The raw model uses `responsivePolicy`, but the transformer renames it\n * to `policy` in the runtime config.\n */\nexport interface SidebarConfigObject {\n  placement: HorizontalPlacement.START | HorizontalPlacement.END;\n  collapsible: boolean;\n  /**\n   * Starting rail state for a visitor with NO stored preference. Absent means\n   * the framework default, expanded. A persisted\n   * `LOCAL_STORAGE_KEYS.SIDEBAR_COLLAPSED` always wins over it — this is a\n   * starting position, not a lock.\n   */\n  defaultCollapsed?: boolean;\n  policy: SidebarResponsivePolicy;\n  /**\n   * Viewport threshold at (or below) which the responsive `policy` applies.\n   * Authored as `responsiveBreakpoint` in the raw model and carried through the\n   * UIContext transformer's rest-spread. Defaults to `ViewportBreakpoint.MOBILE`\n   * (the Zod schema default) when absent.\n   */\n  responsiveBreakpoint?: ViewportBreakpoint;\n  /**\n   * How the sidebar surfaces HOME (hidden / pinned brand header / navigation\n   * row). Absent means the framework default, `NAVIGATION_ITEM`, applied by\n   * `useSidebarBehavior`.\n   */\n  homeDisplayMode?: SidebarHomeDisplayMode;\n  /**\n   * Pins which brand-mark variant the BRAND_HEADER mode renders (e.g.\n   * `MONOCHROME`). Absent means adaptive light/dark.\n   */\n  brandMarkTheme?: BrandAssetTheme;\n  /** Per-launcher content declarations — discriminated union on `contentKind`. */\n  contentSections?: SidebarSection[];\n  /** Components hosted inside the sidebar via container inversion (mirror of menubar `hostedComponents`). */\n  hostedComponents?: SidebarHostedComponent[];\n  defaultSection?: string;\n  /** Desktop sidebar width in px. Defaults to 256. */\n  width?: number;\n  /** Mobile sidebar width in px. Defaults to 280. */\n  mobileWidth?: number;\n  /** Desktop collapsed width in px. Defaults to 64. */\n  collapsedWidth?: number;\n  /** Mobile collapsed width in px. Defaults to 56. */\n  mobileCollapsedWidth?: number;\n}\n\nexport function isSidebarConfigObject(config: unknown): config is SidebarConfigObject {\n  return typeof config === 'object' && config !== null && 'placement' in config && 'collapsible' in config;\n}\n\n/**\n * Narrowing guard for StatusBar object config.\n * StatusBar config can be `boolean | VerticalPlacement (string) | object`.\n * This guard identifies the object form, distinguishing it from both\n * the boolean and string-shorthand variants.\n */\nexport interface StatusBarConfigObject {\n  placement?: VerticalPlacement;\n  showMemoryUsage?: boolean;\n  showNotificationCount?: boolean;\n  showConnectionStatus?: boolean;\n  showConnectionStatusOnMobile?: boolean;\n  backgroundClassName?: string;\n  textClassName?: string;\n  showBorder?: boolean;\n  height?: number;\n  statusItems?: StatusBarConfigItem[];\n  style?: React.CSSProperties;\n}\n\nexport function isStatusBarConfigObject(config: unknown): config is StatusBarConfigObject {\n  return typeof config === 'object' && config !== null && !Array.isArray(config);\n}\n\nexport type UtilityPanelPlacement =\n  | HorizontalPlacement.START\n  | HorizontalPlacement.END;\n\nexport interface UtilityPanelConfigObject {\n  items?: UtilityPanelItem[];\n  position?: UtilityPanelPlacement;\n}\n\nexport function isUtilityPanelConfigObject(config: unknown): config is UtilityPanelConfigObject {\n  if (typeof config !== 'object' || config === null || Array.isArray(config)) {\n    return false;\n  }\n\n  const candidate = config as Record<string, unknown>;\n  const isValidPosition =\n    candidate.position === undefined ||\n    candidate.position === HorizontalPlacement.START ||\n    candidate.position === HorizontalPlacement.END;\n  const isValidItems = candidate.items === undefined || Array.isArray(candidate.items);\n\n  return isValidPosition && isValidItems;\n}\n\n\n// ---------------------------------------------------------------------------\n// Behavior hook return types\n// ---------------------------------------------------------------------------\n\n/**\n * Standalone navigation behavioral utilities — active-state checking,\n * display policy evaluation, click dispatch, and home navigation.\n *\n * Does NOT include items — consumers obtain items from per-launcher\n * resolution or auto-items.\n *\n * `handleNavigationClick` accepts `launcher` as a second parameter since\n * this interface is not scoped to a single launcher.\n */\nexport interface NavigationBehaviors {\n  isNavigationItemActive: (urlPath: string) => boolean;\n  shouldShowItem: (item: AnyNavigationItem) => 'visible' | 'more_menu' | 'hidden';\n  handleNavigationClick: (item: AnyNavigationItem, launcher: ApplicationLevelComponentType) => void;\n  handleHomeClick: () => void;\n  isHomeActive: boolean;\n}\n\nexport interface SidebarBehavior {\n  groupedSections: SectionGroup[];\n  /**\n   * Components hosted in the sidebar (container inversion), resolved from\n   * `[SIDEBAR].hostedComponents` through the SAME pipeline the menubar uses.\n   * The preset resolves each via the component registry and mounts it with the\n   * shell-level interaction-owner props.\n   */\n  hostedComponents: ResolvedHostedComponent[];\n  isCollapsed: boolean;\n  isHomeActive: boolean;\n  dimensions: { width: number; collapsedWidth: number };\n  sidebarConfig: {\n    isCollapsible: boolean;\n    responsivePolicy: SidebarResponsivePolicy;\n    placementClass: string;\n    currentWidth: number;\n  };\n  isNavigationLoading: boolean;\n  hasItems: boolean;\n  placement: HorizontalPlacement;\n\n  /**\n   * How the sidebar must surface HOME — hidden, the pinned brand header, or a\n   * navigation row. Resolved from config with the framework default applied, so\n   * a preset never re-derives it.\n   */\n  homeDisplayMode: SidebarHomeDisplayMode;\n  /**\n   * App name + resolved brand-asset URL for the pinned header. Present ONLY in\n   * `SidebarHomeDisplayMode.BRAND_HEADER`; `logoUrl` is itself optional because\n   * an application may not have generated a brand yet.\n   */\n  brandHeader?: BrandIdentity;\n\n  /**\n   * `true` when the current viewport is at (or below) the sidebar's configured\n   * `responsiveBreakpoint` AND the responsive policy is `BURGER`. In this mode the\n   * sidebar renders NOTHING inline (width 0) and instead opens as an overlay drawer\n   * (`isMobileDrawerOpen`) toggled by the menubar burger / `HOTKEY_SIDEBAR_TOGGLE`.\n   */\n  isMobileDrawerMode: boolean;\n  /** Drawer open state — only meaningful while `isMobileDrawerMode` is true. */\n  isMobileDrawerOpen: boolean;\n  /** Closes the mobile drawer (backdrop click, Escape, post-navigation dismiss). */\n  closeMobileDrawer: () => void;\n\n  /**\n   * Active-state check keyed on the ITEM's resolved `id`, not on the raw path:\n   * two DISTINCT items sharing an identical `urlPath` (e.g. an item and its\n   * favorites-section copy, which carries a `favorite-` prefixed id) must not\n   * both highlight — one id (the first in section order carrying the winning\n   * path) is elected (frontend-ux-quality-audit E2). Caveat: resolved ids are\n   * deterministic per TARGET (`resolved-<type>-<op>-<variant>`), so declaring\n   * the SAME launcher target in two sections yields two rows with one shared\n   * id, and both still highlight — dedupe such declarations in config instead\n   * (WT once declared Todos twice and hit exactly this).\n   */\n  isNavigationItemActive: (item: { id: string; urlPath?: string }) => boolean;\n  isSectionCollapsed: (section: SectionRenderProps) => boolean;\n  isItemCollapsed: (itemId: string) => boolean;\n\n  handleNavigationClick: (item: AnyNavigationItem) => void;\n  handleHomeClick: () => void;\n  handleToggleCollapse: () => void;\n  handleToggleSectionCollapse: (sectionRef: string) => void;\n  handleToggleItemCollapse: (itemId: string) => void;\n\n  /**\n   * `true` when the item is in the user's favorites. Accepts either an origin\n   * item (keyed by its own `id`) or a favorites-section copy (keyed by its\n   * `favoriteId`).\n   */\n  isItemFavorite: (item: Pick<HierarchicalNavigationItem, 'id' | 'favoriteId'>) => boolean;\n  /**\n   * Toggles the item in the persisted favorites set (star affordance). The\n   * favorites section re-populates immediately; storage is machine-local\n   * (`LOCAL_STORAGE_KEYS.SIDEBAR_FAVORITES`).\n   */\n  handleToggleItemFavorite: (item: Pick<HierarchicalNavigationItem, 'id' | 'favoriteId'>) => void;\n  /**\n   * Whether any `SidebarSectionBehavior.FAVORITES` section is configured — the\n   * preset only offers the star affordance when favoriting has a destination.\n   */\n  hasFavoritesSection: boolean;\n\n  inlineCreate: {\n    activeSection: string | null;\n    value: string;\n    start: (sectionRef: string) => void;\n    cancel: () => void;\n    submit: (sectionRef: string, resourceType?: string) => void;\n    setValue: (value: string) => void;\n  };\n}\n\nexport interface AppShellLayoutInfo {\n  hasMenubar: boolean;\n  hasSidebar: boolean;\n  hasStatusBar: boolean;\n  hasToolbar: boolean;\n  hasActivityBar: boolean;\n  hasQuickActionButton: boolean;\n  hasUtilityPanel: boolean;\n  sidebarPlacement: HorizontalPlacement;\n  statusBarPlacement: VerticalPlacement;\n  utilityPanelPlacement: UtilityPanelPlacement;\n  isLayoutReady: boolean;\n}\n\nexport interface PublicShellLayoutInfo {\n  useCardLayout: boolean;\n  isReady: boolean;\n  /**\n   * The identity to present above the public card, or `undefined` when the application has not\n   * opted in via `publicShellIdentityMode`.\n   *\n   * EXPOSED only in the opted-in mode rather than always, mirroring `useSidebarBehavior`'s\n   * `brandHeader`: a preset that receives an identity unconditionally can render a mark on a\n   * surface the application never asked to brand, and no type would catch it.\n   */\n  brandHeader?: BrandIdentity;\n}\n\nexport interface ToolbarDisplayItem {\n  id: string;\n  label: string;\n  icon?: React.ReactNode;\n  iconOnly?: boolean;\n  onClick: () => void;\n}\n\nexport interface ToolbarBehavior {\n  tools: ToolbarDisplayItem[];\n  toolbarConfig: {\n    placement: 'top' | 'bottom';\n    compact: boolean;\n    showSeparator: boolean;\n    hideOnMobile: boolean;\n  };\n  shouldRender: boolean;\n  currentBreakpoint: string | undefined;\n}\n\nexport enum QuickSwitcherFieldControlKind {\n  ENUM = 'enum',\n  RESOURCE_REFERENCE = 'resource_reference',\n  RAW = 'raw',\n}\n\nexport interface QuickSwitcherResolvedField {\n  fieldId: string;\n  /** Guaranteed non-empty (config label → resource title → humanized field id → field id). */\n  label: string;\n  schema: z.ZodTypeAny;\n  valueSchema: z.ZodTypeAny;\n  disabled: boolean;\n  isMultiple: boolean;\n  controlKind: QuickSwitcherFieldControlKind;\n  /**\n   * Explicit target for `RESOURCE_REFERENCE` controls whose schema carries no\n   * `isForeignKey` metadata — i.e. the primary-key fallback, where the switcher\n   * is by definition selecting an instance of the scope field's `resourceType`.\n   * `undefined` for FK-decorated schemas (the FK metadata names the target).\n   */\n  targetResourceType?: string;\n  /** Input placeholder — localized resource title, falling back to `label`. Non-empty. */\n  placeholder: string;\n  /**\n   * How each dropdown option renders — the declared\n   * `appScope.fields[].optionDisplayMode`, defaulted to `LABEL`. Reuses the\n   * framework's FK-rendering vocabulary: `LABEL` is the resource's own display\n   * label, `SUMMARY` is its summary card.\n   */\n  optionDisplayMode: ForeignKeyDisplayMode;\n  /**\n   * Clear this field's ambient scope. A scope is inherently OPTIONAL — \"no list\n   * selected\" is a first-class state the collection surfaces already produce —\n   * so the control always offers an explicit way back to it rather than relying\n   * on the combobox's undiscoverable re-click-to-toggle.\n   */\n  onClear: () => void;\n  /** Whether anything is currently selected (drives the clear affordance). */\n  hasValue: boolean;\n  /**\n   * How the closed control presents — the declared\n   * `appScope.fields[].presentation`, defaulted to `CONTROL_ONLY`.\n   *\n   * Carried as DATA, never as a rendered node: resolving the resource's icon is\n   * component-registry work, so the preset does it. Behavior hooks in this\n   * framework never return `ReactNode` nor perform registry resolution.\n   */\n  presentation: QuickSwitcherFieldPresentation;\n  definition: AppScopeFieldDefinition;\n}\n\nexport interface QuickSwitcherBehavior {\n  fields: QuickSwitcherResolvedField[];\n  formMethods: UseFormReturn;\n  layoutDirection: 'horizontal' | 'vertical';\n  /**\n   * Monotonically increasing counter — incremented when the\n   * `HOTKEY_QUICK_SWITCHER_OPEN` event fires. Presets should watch\n   * this value and focus the first enabled field when it changes.\n   */\n  focusTrigger: number;\n}\n\nexport interface StatusBarBehavior {\n  totalBadgeCount: number;\n  connectionStatus: WebSocketStatus;\n  showConnectionStatus: boolean;\n  showConnectionStatusOnMobile: boolean;\n  shouldShowConnectionStatus: boolean;\n  showNotificationCount: boolean;\n  shouldShowNotificationCount: boolean;\n  showMemoryUsage: boolean;\n  memoryUsageLabel: string | null;\n  notificationCountLabel: string;\n  notificationCountAriaLabel: string;\n  connectionStatusLabel: string;\n  statusItems: StatusBarDisplayItem[];\n  dimensions: { height: number };\n  statusBarConfig: {\n    isTop: boolean;\n    isBottom: boolean;\n    isMobile: boolean;\n    backgroundClassName: string;\n    textClassName: string;\n    showBorder: boolean;\n  };\n  customStyle?: React.CSSProperties;\n  currentBreakpoint: string | undefined;\n}\n\nexport interface StatusBarConfigItemBase {\n  id: string;\n  label: string;\n  type: StatusBarItemType;\n  icon?: string;\n  value?: string | number;\n}\n\nexport interface StatusBarConfigItem_Link extends StatusBarConfigItemBase {\n  type: StatusBarItemType.LINK;\n  href: string;\n}\n\nexport interface StatusBarConfigItem_Button extends StatusBarConfigItemBase {\n  type: StatusBarItemType.BUTTON;\n  onClick: () => void;\n}\n\nexport interface StatusBarConfigItem_Text extends StatusBarConfigItemBase {\n  type: StatusBarItemType.TEXT;\n}\n\nexport type StatusBarConfigItem =\n  | StatusBarConfigItem_Link\n  | StatusBarConfigItem_Button\n  | StatusBarConfigItem_Text;\n\nexport enum StatusBarDisplayInteractionType {\n  STATIC = 'static',\n  LINK = 'link',\n  BUTTON = 'button',\n}\n\nexport interface StatusBarDisplayInteraction_Static {\n  type: StatusBarDisplayInteractionType.STATIC;\n}\n\nexport interface StatusBarDisplayInteraction_Link {\n  type: StatusBarDisplayInteractionType.LINK;\n  href: string;\n}\n\nexport interface StatusBarDisplayInteraction_Button {\n  type: StatusBarDisplayInteractionType.BUTTON;\n  onClick: () => void;\n}\n\nexport type StatusBarDisplayInteraction =\n  | StatusBarDisplayInteraction_Static\n  | StatusBarDisplayInteraction_Link\n  | StatusBarDisplayInteraction_Button;\n\nexport interface StatusBarDisplayItem {\n  id: string;\n  label: string;\n  iconReference?: string;\n  valueText?: string;\n  interaction: StatusBarDisplayInteraction;\n}\n\nexport interface ActivityBarLayout {\n  direction: LayoutDirection;\n  borderSide: PlacementSide;\n  tooltipSide: PlacementSide;\n  orientation: LayoutDirection;\n}\n\nexport interface ActivityBarBehavior {\n  availableModes: AppModeDefinition[];\n  activeMode: string | null;\n  setActiveMode: (mode: string) => void;\n  hasModes: boolean;\n  activeRenderingMode: ActivityBarRendering;\n  layout: ActivityBarLayout;\n  isNavigationLoading: boolean;\n}\n\nexport enum ControlPanelControlType {\n  BUTTON = 'button',\n  TOGGLE = 'toggle',\n  SLIDER = 'slider',\n  SELECT = 'select',\n}\n\nexport interface ControlPanelBehavior {\n  isOpen: boolean;\n  setIsOpen: (open: boolean) => void;\n  groupedItems: Record<string, ControlPanelNavigationItem[]>;\n  sections: ControlPanelSection[];\n  controls: ControlPanelDisplayControl[];\n  handleItemClick: (item: ControlPanelNavigationItem) => void;\n  sheetSide: PlacementSide;\n  isNavigationLoading: boolean;\n  navigationItemCount: number;\n  currentBreakpoint: string | undefined;\n}\n\nexport type ControlPanelNavigationItem = ResolvedControlPanelItem;\n\nexport interface ControlPanelSection {\n  id: string;\n  label: string;\n  items: ControlPanelNavigationItem[];\n}\n\nexport interface ControlPanelDisplayControlBase {\n  id: string;\n  label: string;\n  type: ControlPanelControlType;\n  disabled: boolean;\n}\n\nexport interface ControlPanelDisplayControl_Button extends ControlPanelDisplayControlBase {\n  type: ControlPanelControlType.BUTTON;\n  onTrigger: () => void;\n}\n\nexport interface ControlPanelDisplayControl_Toggle extends ControlPanelDisplayControlBase {\n  type: ControlPanelControlType.TOGGLE;\n  value: boolean;\n  onToggle: () => void;\n}\n\nexport interface ControlPanelDisplayControl_SelectOption {\n  label: string;\n  value: unknown;\n  isSelected: boolean;\n  onSelect: () => void;\n}\n\nexport interface ControlPanelDisplayControl_Select extends ControlPanelDisplayControlBase {\n  type: ControlPanelControlType.SELECT;\n  value?: unknown;\n  options: ControlPanelDisplayControl_SelectOption[];\n}\n\nexport interface ControlPanelDisplayControl_Slider extends ControlPanelDisplayControlBase {\n  type: ControlPanelControlType.SLIDER;\n  value: number;\n  min: number;\n  max: number;\n  step: number;\n  onValueChange: (value: number) => void;\n}\n\nexport type ControlPanelDisplayControl =\n  | ControlPanelDisplayControl_Button\n  | ControlPanelDisplayControl_Toggle\n  | ControlPanelDisplayControl_Select\n  | ControlPanelDisplayControl_Slider;\n\n/**\n * One panel item, normalized for display, discriminated the same way its config is (#504).\n *\n * `componentType` and `resolvedViewRef` are both nullable and both mean the SAME thing: the item\n * names something this panel cannot host, and the preset must show that rather than render chrome\n * that looks like a component with nothing to say. Keeping the two kinds apart here is what stops\n * the preset guessing which ref an item meant.\n */\nexport type UtilityPanelDisplayItem =\n  | {\n      kind: LauncherItemTargetKind.CUSTOM_COMPONENT;\n      componentRef: string;\n      /** `null` when the ref names no `FrontendComponentType` — the panel hosts engine components only. */\n      componentType: FrontendComponentType | null;\n      icon: string;\n      label: string;\n    }\n  | {\n      kind: LauncherItemTargetKind.VIEW;\n      viewRef: string;\n      /** `null` when no declared view carries that ref, so an unknown ref is reported and not rendered blank. */\n      resolvedViewRef: string | null;\n      icon: string;\n      label: string;\n    };\n\nexport interface UtilityPanelBehavior {\n  /** Whether the panel is expanded/open. */\n  isOpen: boolean;\n  setIsOpen: (open: boolean) => void;\n  /** Panel items normalized for display without moving registry resolution into the hook. */\n  items: UtilityPanelDisplayItem[];\n  /** Number of items. */\n  itemCount: number;\n  /** Horizontal position (START or END only). */\n  position: UtilityPanelPlacement;\n  /** Current breakpoint for responsive adjustments. */\n  currentBreakpoint: string | undefined;\n}\n\n/**\n * The notification centre's contract — a SESSION FEED, not a message history (#412).\n *\n * Four members were removed on 2026-09-08 and each was asserting something the store cannot hold.\n * The store behind this is a `useReducer` with no hydration: it starts empty on every page load, and\n * nothing that arrived while the tab was closed is recoverable.\n *\n * | removed | why it could not be true |\n * |---|---|\n * | `unreadCount` / `handleMarkAllAsRead` | \"unread\" was a function of when the tab OPENED, and marking something read meant nothing — the state died with the page. A badge counting it was counting the current session's arrivals and calling them unread. |\n * | `filter` / `setFilter` | the only filter was ALL vs UNREAD, so it filtered on the read state above. Filtering \"what arrived since this page loaded\" by whether you had glanced at it is not a question anyone has. |\n * | `groupedNotifications` | today / yesterday / older, over a buffer that cannot contain a yesterday. The `older` bucket was unreachable and `yesterday` only fillable by leaving a tab open overnight. |\n *\n * What is left says what it is: the arrivals, newest first, each dismissable, and a way to clear\n * them. Persisting instead was weighed and declined — it creates a per-user personal-data store\n * carrying retention, privacy-classification, subject-export and erasure obligations for message\n * content, which is the real cost, not the table.\n */\nexport interface NotificationCenterBehavior {\n  isOpen: boolean;\n  setIsOpen: (open: boolean) => void;\n  /** Everything that has arrived since this page loaded, newest first. */\n  sessionNotifications: NotificationCenterDisplayNotification[];\n  notificationCount: number;\n  handleClearAll: () => void;\n  dismissNotification: (notificationId: string) => void;\n}\n\nexport interface NotificationCenterDisplayNotification {\n  id: string;\n  type: Notification['type'];\n  source: Notification['source'];\n  timestamp: number;\n  displayTitle: string;\n  displayMessage: string;\n  relativeTimeLabel: string;\n  iconReference: StandardIconReference;\n  nextStep?: Notification['nextStep'];\n}\n\nexport interface QuickActionButtonDisplayItem {\n  id: string;\n  label: string;\n  icon?: React.ReactNode;\n  displayPolicy?: string;\n  onClick: () => void;\n}\n\nexport interface QuickActionButtonBehavior {\n  allItems: QuickActionButtonDisplayItem[];\n  primaryAction: QuickActionButtonDisplayItem | null;\n  menuActions: QuickActionButtonDisplayItem[];\n  isOpen: boolean;\n  setIsOpen: (open: boolean) => void;\n  handleActionClick: (item: QuickActionButtonDisplayItem) => void;\n  hasActions: boolean;\n  isNavigationLoading: boolean;\n  currentBreakpoint: string | undefined;\n}\n\nexport interface CommandMenuItem {\n  id: string;\n  label: string;\n  shortcut: string;\n  icon?: React.ReactNode;\n  category: string;\n  keywords: string[];\n  /** Internal policy from config — used by the hook to control grouping/visibility. */\n  displayPolicy?: string;\n  onExecute: () => void;\n}\n\nexport interface CommandMenuGroup {\n  category: string;\n  label: string;\n  items: CommandMenuItem[];\n}\n\n/**\n * One live omnibox record-search result. Intentionally DISTINCT from\n * {@link CommandMenuItem}: a search result is a resource RECORD (it carries the\n * full summary-mode DTO in `record` + its `resourceType`) so the palette can\n * render it as the resource's summary VIEW (summary card), whereas a\n * `CommandMenuItem` is a static navigation command that only ever renders a\n * label + icon. Merging the two would collapse that semantic distinction and\n * force every static command to carry a nullable record.\n */\nexport interface CommandMenuSearchResultItem {\n  id: string;\n  /** Resource type of the matched record — drives summary-view + navigation. */\n  resourceType: string;\n  /** Full summary-mode DTO returned by SEARCH — fed to the summary renderer. */\n  record: Record<string, unknown>;\n  /** Resolved one-line label (LABEL display mode + summary-card fallback). */\n  label: string;\n  /**\n   * Client-side match terms carried so cmdk's filter never drops a legitimate\n   * server hit (always includes the raw query; matches may be on a field absent\n   * from the label, e.g. `description`).\n   */\n  keywords: string[];\n  /** Navigate to the matched record's addressable READ view, then close. */\n  onExecute: () => void;\n}\n\n/** A group of omnibox search results for one searched resource. */\nexport interface CommandMenuSearchResultGroup {\n  category: string;\n  label: string;\n  /** How each item in this group renders (summary card vs. one-line label). */\n  displayMode: ForeignKeyDisplayMode;\n  items: CommandMenuSearchResultItem[];\n}\n\n/**\n * Discriminant for {@link CommandMenuPaletteGroup} — whether an entry in the\n * unified, ordered palette list is a static command-category group or a live\n * record-search result group. The two stay DISTINCT types (a command is a\n * navigation target rendering a label; a record carries a full DTO rendering a\n * summary card) — this union only sequences them in one render order, it does\n * not merge their semantics.\n */\nexport enum CommandMenuPaletteGroupKind {\n  COMMANDS = 'commands',\n  RECORDS = 'records',\n}\n\n/**\n * One entry in the palette's SINGLE ordered group list — either a static\n * command-category group or a live record-search group, tagged with the numeric\n * `order` weight the palette sorted by (lower = higher). Produced by\n * `useCommandMenuBehavior` so the preset renders one uniform, ordered sequence\n * (record groups default above command groups while searching) instead of two\n * hard-coded blocks. The recent-commands group is rendered separately (always\n * pinned to the top) and is not part of this list.\n */\nexport type CommandMenuPaletteGroup =\n  | { kind: CommandMenuPaletteGroupKind.COMMANDS; order: number; group: CommandMenuGroup }\n  | { kind: CommandMenuPaletteGroupKind.RECORDS; order: number; group: CommandMenuSearchResultGroup };\n\nexport interface CommandMenuBehavior {\n  isOpen: boolean;\n  handleOpenChange: (open: boolean) => void;\n  searchQuery: string;\n  setSearchQuery: (query: string) => void;\n  commandItems: CommandMenuItem[];\n  groupedItems: CommandMenuGroup[];\n  recentItems: CommandMenuItem[];\n  /**\n   * Live record-search result groups (omnibox layer). Empty unless the\n   * `COMMAND_MENU` config sets `policy: OMNIBOX` with `searchResources` and the\n   * current query meets the minimum length. Each item's `onExecute` navigates\n   * to the matched record's READ view. Items render as the resource's summary\n   * view (or a one-line label per the resource's `resultDisplay` config).\n   */\n  searchResultGroups: CommandMenuSearchResultGroup[];\n  /**\n   * The unified, ORDERED render list the preset iterates: record groups and\n   * static command-category groups merged and sorted by a single numeric `order`\n   * weight (record groups default above command groups while searching; apps\n   * override per record group via `CommandMenuSearchResource.order`, and command\n   * categories sequence among themselves via `[COMMAND_MENU].categoryOrder`).\n   * The recent-commands group is NOT included here — it is always rendered first,\n   * separately. Derived from `groupedItems` + `searchResultGroups` (which remain\n   * available as the raw, per-source building blocks).\n   */\n  orderedGroups: CommandMenuPaletteGroup[];\n  /** True while an omnibox record search is in flight for the current query. */\n  isSearching: boolean;\n  isNavigationLoading: boolean;\n  showRecent: boolean;\n  showShortcuts: boolean;\n  /**\n   * Global open-shortcut string (e.g. `'Cmd+K'`) from config, or `undefined`\n   * when none is declared. The preset renders it as the trigger's `⌘K` hint.\n   */\n  openShortcut: string | undefined;\n  /**\n   * Desktop max-width Tailwind class for the palette dialog (see\n   * `[COMMAND_MENU].dialogWidth`). Always `sm:`-prefixed so mobile stays\n   * near-full-width. Defaults to `sm:max-w-2xl`.\n   */\n  dialogWidth: string;\n}\n\nexport interface MenuUserOrgBehavior {\n  isOpen: boolean;\n  setIsOpen: (open: boolean) => void;\n  isUserAuthenticated: boolean;\n  userInitials: string;\n  displayName: string;\n  email: string;\n  avatarUrl: string | undefined;\n  currentOrganization: { _id: string; name: string } | undefined;\n  organizations: { _id: string; name: string }[];\n  /** Dropdown sections to render. The `SETTINGS` entry opens the unified Settings Hub. */\n  sections: UserDropdownSection[];\n  avatarDisplay: UserDropdownAvatarDisplay;\n  showOrgSwitcher: boolean;\n  showLogout: boolean;\n  settingsTarget: ResolvedNavigationTarget | null;\n  settingsTargets: ResolvedNavigationTarget[];\n  popupAlignment: { align: HorizontalAlign; side: PlacementSide };\n  handleLogout: () => void;\n  handleSwitchOrg: (orgId: string) => void;\n  handleNavigateToSettingsTarget: (target: ResolvedNavigationTarget) => void;\n}\n\nexport interface MenuBarBehavior {\n  containerComponents: ResolvedHostedComponent[];\n  items: {\n    id: string;\n    label: string;\n    icon?: React.ReactNode;\n    group?: string;\n    onExecute: () => void;\n  }[];\n  menubarConfig: {\n    mode: string;\n    isOverlay: boolean;\n    showMobileLayout: boolean;\n  };\n  mapToFrontendComponentType: (type: ApplicationLevelComponentType) => FrontendComponentType | null;\n}\n"]}

package/dist/esm/core/app-shell/app-shell.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/app-shell/app-shell.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;;;;;;GAOG;AACH,wBAAgB,0CAA0C,CACxD,IAAI,EAAE,6BAA6B,GAClC,qBAAqB,GAAG,IAAI,CAqB9B"}
+{"version":3,"file":"app-shell.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/app-shell/app-shell.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;;;;;;GAOG;AACH,wBAAgB,0CAA0C,CACxD,IAAI,EAAE,6BAA6B,GAClC,qBAAqB,GAAG,IAAI,CAqB9B"}

package/dist/esm/core/app-shell/app-shell.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.utils.js","sourceRoot":"","sources":["../../../../../src/core/app-shell/app-shell.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,UAAU,0CAA0C,CACxD,IAAmC;IAEnC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,6BAA6B,CAAC,YAAY;YAC7C,OAAO,qBAAqB,CAAC,8BAA8B,CAAC;QAC9D,KAAK,6BAA6B,CAAC,mBAAmB;YACpD,OAAO,qBAAqB,CAAC,qCAAqC,CAAC;QACrE,KAAK,6BAA6B,CAAC,mBAAmB;YACpD,OAAO,qBAAqB,CAAC,qCAAqC,CAAC;QACrE,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D,KAAK,6BAA6B,CAAC,cAAc;YAC/C,OAAO,qBAAqB,CAAC,gCAAgC,CAAC;QAChE,KAAK,6BAA6B,CAAC,kBAAkB;YACnD,OAAO,qBAAqB,CAAC,iCAAiC,CAAC;QACjE,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC","sourcesContent":["import { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\n\n/**\n * Maps an `ApplicationLevelComponentType` (config key) to the corresponding\n * `FrontendComponentType` (DI registry key).\n *\n * Single source of truth — consumed by `useMenuBarBehavior` and any future\n * code that needs to resolve an app-level config entry to a renderable\n * component.\n */\nexport function mapApplicationLevelToFrontendComponentType(\n  type: ApplicationLevelComponentType,\n): FrontendComponentType | null {\n  switch (type) {\n    case ApplicationLevelComponentType.COMMAND_MENU:\n      return FrontendComponentType.APPLICATION_LEVEL_COMMAND_MENU;\n    case ApplicationLevelComponentType.QUICK_ACTION_BUTTON:\n      return FrontendComponentType.APPLICATION_LEVEL_QUICK_ACTION_BUTTON;\n    case ApplicationLevelComponentType.NOTIFICATION_CENTER:\n      return FrontendComponentType.APPLICATION_LEVEL_NOTIFICATION_CENTER;\n    case ApplicationLevelComponentType.USER_DROPDOWN:\n      return FrontendComponentType.APPLICATION_LEVEL_USER_DROPDOWN;\n    case ApplicationLevelComponentType.CONTROL_PANEL:\n      return FrontendComponentType.APPLICATION_LEVEL_CONTROL_PANEL;\n    case ApplicationLevelComponentType.QUICK_SWITCHER:\n      return FrontendComponentType.APPLICATION_LEVEL_QUICK_SWITCHER;\n    case ApplicationLevelComponentType.NAVIGATION_CONTROL:\n      return FrontendComponentType.APPLICATION_LEVEL_NAVIGATION_BACK;\n    case ApplicationLevelComponentType.UTILITY_PANEL:\n      return FrontendComponentType.APPLICATION_LEVEL_UTILITY_PANEL;\n    default:\n      return null;\n  }\n}\n"]}
+{"version":3,"file":"app-shell.utils.js","sourceRoot":"","sources":["../../../../src/core/app-shell/app-shell.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,UAAU,0CAA0C,CACxD,IAAmC;IAEnC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,6BAA6B,CAAC,YAAY;YAC7C,OAAO,qBAAqB,CAAC,8BAA8B,CAAC;QAC9D,KAAK,6BAA6B,CAAC,mBAAmB;YACpD,OAAO,qBAAqB,CAAC,qCAAqC,CAAC;QACrE,KAAK,6BAA6B,CAAC,mBAAmB;YACpD,OAAO,qBAAqB,CAAC,qCAAqC,CAAC;QACrE,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D,KAAK,6BAA6B,CAAC,cAAc;YAC/C,OAAO,qBAAqB,CAAC,gCAAgC,CAAC;QAChE,KAAK,6BAA6B,CAAC,kBAAkB;YACnD,OAAO,qBAAqB,CAAC,iCAAiC,CAAC;QACjE,KAAK,6BAA6B,CAAC,aAAa;YAC9C,OAAO,qBAAqB,CAAC,+BAA+B,CAAC;QAC/D;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC","sourcesContent":["import { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\n\n/**\n * Maps an `ApplicationLevelComponentType` (config key) to the corresponding\n * `FrontendComponentType` (DI registry key).\n *\n * Single source of truth — consumed by `useMenuBarBehavior` and any future\n * code that needs to resolve an app-level config entry to a renderable\n * component.\n */\nexport function mapApplicationLevelToFrontendComponentType(\n  type: ApplicationLevelComponentType,\n): FrontendComponentType | null {\n  switch (type) {\n    case ApplicationLevelComponentType.COMMAND_MENU:\n      return FrontendComponentType.APPLICATION_LEVEL_COMMAND_MENU;\n    case ApplicationLevelComponentType.QUICK_ACTION_BUTTON:\n      return FrontendComponentType.APPLICATION_LEVEL_QUICK_ACTION_BUTTON;\n    case ApplicationLevelComponentType.NOTIFICATION_CENTER:\n      return FrontendComponentType.APPLICATION_LEVEL_NOTIFICATION_CENTER;\n    case ApplicationLevelComponentType.USER_DROPDOWN:\n      return FrontendComponentType.APPLICATION_LEVEL_USER_DROPDOWN;\n    case ApplicationLevelComponentType.CONTROL_PANEL:\n      return FrontendComponentType.APPLICATION_LEVEL_CONTROL_PANEL;\n    case ApplicationLevelComponentType.QUICK_SWITCHER:\n      return FrontendComponentType.APPLICATION_LEVEL_QUICK_SWITCHER;\n    case ApplicationLevelComponentType.NAVIGATION_CONTROL:\n      return FrontendComponentType.APPLICATION_LEVEL_NAVIGATION_BACK;\n    case ApplicationLevelComponentType.UTILITY_PANEL:\n      return FrontendComponentType.APPLICATION_LEVEL_UTILITY_PANEL;\n    default:\n      return null;\n  }\n}\n"]}

package/dist/esm/core/app-shell/hosted-components.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-components.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/app-shell/hosted-components.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAClG,OAAO,EAAuC,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,iEAAiE,CAAC;AAEzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAEpG,gFAAgF;AAChF,KAAK,wBAAwB,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,6BAA6B,EACtC,gBAAgB,EAAE,wBAAwB,EAAE,GAAG,SAAS,EACxD,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC/D,iBAAiB,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,EAC1D,gBAAgB,EAAE,mBAAmB,GAAG,iBAAiB,EACzD,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,uBAAuB,EAAE,CAmD3B"}
+{"version":3,"file":"hosted-components.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/app-shell/hosted-components.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAClG,OAAO,EAAuC,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,iEAAiE,CAAC;AAEzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sDAAsD,CAAC;AAEpG,gFAAgF;AAChF,KAAK,wBAAwB,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,6BAA6B,EACtC,gBAAgB,EAAE,wBAAwB,EAAE,GAAG,SAAS,EACxD,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC/D,iBAAiB,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,EAC1D,gBAAgB,EAAE,mBAAmB,GAAG,iBAAiB,EACzD,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,uBAAuB,EAAE,CAmD3B"}

package/dist/esm/core/app-shell/hosted-components.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-components.utils.js","sourceRoot":"","sources":["../../../../../src/core/app-shell/hosted-components.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mCAAmC,EAAyB,MAAM,uBAAuB,CAAC;AAGnG,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AAKtH,OAAO,EAAE,0CAA0C,EAAE,MAAM,oDAAoD,CAAC;AAMhH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAsC,EACtC,gBAAwD,EACxD,0BAA+D,EAC/D,iBAA0D,EAC1D,gBAAyD,EACzD,gBAAmC;IAEnC,IAAI,CAAC,0BAA0B,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAC/C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAyC,CAAC;IAEzE,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,EAAE,CAAC,aAA8C,CAAC;QAEnE,IAAI,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,UAAU,KAAK,iBAAiB,EAAE,CAAC;YACzD,SAAS;QACX,CAAC;QACD,IAAI,0BAA0B,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;YACnD,SAAS;QACX,CAAC;QAED,yEAAyE;QACzE,yEAAyE;QACzE,0EAA0E;QAC1E,0EAA0E;QAC1E,wEAAwE;QACxE,2EAA2E;QAC3E,wEAAwE;QACxE,+CAA+C;QAC/C,IACE,QAAQ,KAAK,6BAA6B,CAAC,kBAAkB;eAC1D,CAAC,mCAAmC,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,EAC9E,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,0CAA0C,CAAC,QAAQ,CAAC,CAAC;QAC1E,IAAI,CAAC,YAAY;YAAE,SAAS;QAE5B,MAAM,aAAa,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzD,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC;QAEjD,QAAQ,CAAC,IAAI,CAAC;YACZ,UAAU,EAAE,GAAG,OAAO,IAAI,QAAQ,IAAI,aAAa,EAAE;YACrD,SAAS,EAAE,QAAQ;YACnB,qBAAqB,EAAE,YAAY;YACnC,SAAS,EAAG,EAAE,CAAC,SAAiE,IAAI,gBAAgB;YACpG,UAAU,EAAE,EAAE,CAAC,UAAU;YACzB,YAAY,EAAE,EAAE,CAAC,YAAY;YAC7B,iBAAiB,EAAE,EAAE,CAAC,iBAAiB;SACxC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import type { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport { navigationBackAffordanceAdmitsShell, type NavigationLayout } from '@wildo-ai/saas-models';\nimport type { ViewportBreakpoint } from '@wildo-ai/zod-decorators';\n\nimport { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport type {\n  MenubarHostedComponent,\n  SidebarHostedComponent,\n} from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { mapApplicationLevelToFrontendComponentType } from '~wildo-frontend-lib/core/app-shell/app-shell.utils';\nimport type { ResolvedHostedComponent } from '~wildo-frontend-lib/core/app-shell/app-shell.schemas';\n\n/** A hosted-component config entry from EITHER surface (menubar or sidebar). */\ntype AnyHostedComponentConfig = MenubarHostedComponent | SidebarHostedComponent;\n\n/**\n * Resolve a surface's raw `hostedComponents` config entries into renderable\n * {@link ResolvedHostedComponent} descriptors.\n *\n * This is the SINGLE hosting pipeline shared by the menubar and the sidebar —\n * container inversion, breakpoint gating, per-component enable/disable, registry\n * type mapping, and per-placement `triggerWidth` all live here so the two\n * surfaces never drift. The shell-level interaction owner\n * (`HostedComponentInteractionsProvider`) calls it for BOTH surfaces to compute\n * a single global open-state/hotkey owner across them.\n *\n * `surface` (MENUBAR or SIDEBAR) prefixes each `instanceId` so the same\n * component hosted in both surfaces at once gets distinct, stable ids\n * (`menubar:command_menu-0` vs `sidebar:command_menu-0`).\n *\n * Entries are dropped when: their `breakpoint` doesn't match the current\n * breakpoint, the component is globally disabled (`config[type] === false`), or\n * the component type has no registry mapping.\n *\n * `defaultPlacement` is the surface's documented default zone\n * (menubar → `HorizontalPlacement.START`, sidebar → `VerticalPlacement.TOP`).\n * It is REQUIRED — not optional — because the surface presets place components\n * with a strict per-zone equality filter: before this normalization existed, an\n * entry that omitted `placement` matched NO zone and silently vanished from the\n * shell. Normalizing here (the single shared pipeline) rather than in each\n * preset keeps the menubar and sidebar from drifting on that rule, and lets\n * every resolved descriptor carry a concrete placement by construction.\n */\nexport function resolveHostedComponents(\n  surface: ApplicationLevelComponentType,\n  hostedComponents: AnyHostedComponentConfig[] | undefined,\n  appComponentsConfiguration: Record<string, unknown> | undefined,\n  currentBreakpoint: ViewportBreakpoint | string | undefined,\n  defaultPlacement: HorizontalPlacement | VerticalPlacement,\n  navigationLayout?: NavigationLayout,\n): ResolvedHostedComponent[] {\n  if (!appComponentsConfiguration || !hostedComponents || hostedComponents.length === 0) {\n    return [];\n  }\n\n  const resolved: ResolvedHostedComponent[] = [];\n  const componentCounts = new Map<ApplicationLevelComponentType, number>();\n\n  for (const hc of hostedComponents) {\n    const compType = hc.componentType as ApplicationLevelComponentType;\n\n    if (hc.breakpoint && hc.breakpoint !== currentBreakpoint) {\n      continue;\n    }\n    if (appComponentsConfiguration[compType] === false) {\n      continue;\n    }\n\n    // OWNERSHIP POLICY: the back affordance can be rendered by the app SHELL\n    // (this hosted control) or by the current SURFACE's own header, and both\n    // mount the same control — so an app that hosts it here without owning it\n    // would show two back arrows on every pushed page. The drop lives in this\n    // shared resolver, not in each surface preset, because the shell mounts\n    // hosted components through the generic component REGISTRY (which resolves\n    // the preset directly and never sees the wrapper's gate); one site here\n    // covers the menubar and the sidebar together.\n    if (\n      compType === ApplicationLevelComponentType.NAVIGATION_CONTROL\n      && !navigationBackAffordanceAdmitsShell(navigationLayout?.backAffordanceOwner)\n    ) {\n      continue;\n    }\n\n    const frontendType = mapApplicationLevelToFrontendComponentType(compType);\n    if (!frontendType) continue;\n\n    const instanceIndex = componentCounts.get(compType) ?? 0;\n    componentCounts.set(compType, instanceIndex + 1);\n\n    resolved.push({\n      instanceId: `${surface}:${compType}-${instanceIndex}`,\n      component: compType,\n      frontendComponentType: frontendType,\n      placement: (hc.placement as HorizontalPlacement | VerticalPlacement | undefined) ?? defaultPlacement,\n      presetName: hc.presetName,\n      triggerWidth: hc.triggerWidth,\n      triggerAppearance: hc.triggerAppearance,\n    });\n  }\n\n  return resolved;\n}\n"]}
+{"version":3,"file":"hosted-components.utils.js","sourceRoot":"","sources":["../../../../src/core/app-shell/hosted-components.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mCAAmC,EAAyB,MAAM,uBAAuB,CAAC;AAGnG,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AAKtH,OAAO,EAAE,0CAA0C,EAAE,MAAM,oDAAoD,CAAC;AAMhH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAsC,EACtC,gBAAwD,EACxD,0BAA+D,EAC/D,iBAA0D,EAC1D,gBAAyD,EACzD,gBAAmC;IAEnC,IAAI,CAAC,0BAA0B,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAC/C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAyC,CAAC;IAEzE,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,EAAE,CAAC,aAA8C,CAAC;QAEnE,IAAI,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,UAAU,KAAK,iBAAiB,EAAE,CAAC;YACzD,SAAS;QACX,CAAC;QACD,IAAI,0BAA0B,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;YACnD,SAAS;QACX,CAAC;QAED,yEAAyE;QACzE,yEAAyE;QACzE,0EAA0E;QAC1E,0EAA0E;QAC1E,wEAAwE;QACxE,2EAA2E;QAC3E,wEAAwE;QACxE,+CAA+C;QAC/C,IACE,QAAQ,KAAK,6BAA6B,CAAC,kBAAkB;eAC1D,CAAC,mCAAmC,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,EAC9E,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,0CAA0C,CAAC,QAAQ,CAAC,CAAC;QAC1E,IAAI,CAAC,YAAY;YAAE,SAAS;QAE5B,MAAM,aAAa,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzD,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC;QAEjD,QAAQ,CAAC,IAAI,CAAC;YACZ,UAAU,EAAE,GAAG,OAAO,IAAI,QAAQ,IAAI,aAAa,EAAE;YACrD,SAAS,EAAE,QAAQ;YACnB,qBAAqB,EAAE,YAAY;YACnC,SAAS,EAAG,EAAE,CAAC,SAAiE,IAAI,gBAAgB;YACpG,UAAU,EAAE,EAAE,CAAC,UAAU;YACzB,YAAY,EAAE,EAAE,CAAC,YAAY;YAC7B,iBAAiB,EAAE,EAAE,CAAC,iBAAiB;SACxC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import type { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport { navigationBackAffordanceAdmitsShell, type NavigationLayout } from '@wildo-ai/saas-models';\nimport type { ViewportBreakpoint } from '@wildo-ai/zod-decorators';\n\nimport { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport type {\n  MenubarHostedComponent,\n  SidebarHostedComponent,\n} from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { mapApplicationLevelToFrontendComponentType } from '~wildo-frontend-lib/core/app-shell/app-shell.utils';\nimport type { ResolvedHostedComponent } from '~wildo-frontend-lib/core/app-shell/app-shell.schemas';\n\n/** A hosted-component config entry from EITHER surface (menubar or sidebar). */\ntype AnyHostedComponentConfig = MenubarHostedComponent | SidebarHostedComponent;\n\n/**\n * Resolve a surface's raw `hostedComponents` config entries into renderable\n * {@link ResolvedHostedComponent} descriptors.\n *\n * This is the SINGLE hosting pipeline shared by the menubar and the sidebar —\n * container inversion, breakpoint gating, per-component enable/disable, registry\n * type mapping, and per-placement `triggerWidth` all live here so the two\n * surfaces never drift. The shell-level interaction owner\n * (`HostedComponentInteractionsProvider`) calls it for BOTH surfaces to compute\n * a single global open-state/hotkey owner across them.\n *\n * `surface` (MENUBAR or SIDEBAR) prefixes each `instanceId` so the same\n * component hosted in both surfaces at once gets distinct, stable ids\n * (`menubar:command_menu-0` vs `sidebar:command_menu-0`).\n *\n * Entries are dropped when: their `breakpoint` doesn't match the current\n * breakpoint, the component is globally disabled (`config[type] === false`), or\n * the component type has no registry mapping.\n *\n * `defaultPlacement` is the surface's documented default zone\n * (menubar → `HorizontalPlacement.START`, sidebar → `VerticalPlacement.TOP`).\n * It is REQUIRED — not optional — because the surface presets place components\n * with a strict per-zone equality filter: before this normalization existed, an\n * entry that omitted `placement` matched NO zone and silently vanished from the\n * shell. Normalizing here (the single shared pipeline) rather than in each\n * preset keeps the menubar and sidebar from drifting on that rule, and lets\n * every resolved descriptor carry a concrete placement by construction.\n */\nexport function resolveHostedComponents(\n  surface: ApplicationLevelComponentType,\n  hostedComponents: AnyHostedComponentConfig[] | undefined,\n  appComponentsConfiguration: Record<string, unknown> | undefined,\n  currentBreakpoint: ViewportBreakpoint | string | undefined,\n  defaultPlacement: HorizontalPlacement | VerticalPlacement,\n  navigationLayout?: NavigationLayout,\n): ResolvedHostedComponent[] {\n  if (!appComponentsConfiguration || !hostedComponents || hostedComponents.length === 0) {\n    return [];\n  }\n\n  const resolved: ResolvedHostedComponent[] = [];\n  const componentCounts = new Map<ApplicationLevelComponentType, number>();\n\n  for (const hc of hostedComponents) {\n    const compType = hc.componentType as ApplicationLevelComponentType;\n\n    if (hc.breakpoint && hc.breakpoint !== currentBreakpoint) {\n      continue;\n    }\n    if (appComponentsConfiguration[compType] === false) {\n      continue;\n    }\n\n    // OWNERSHIP POLICY: the back affordance can be rendered by the app SHELL\n    // (this hosted control) or by the current SURFACE's own header, and both\n    // mount the same control — so an app that hosts it here without owning it\n    // would show two back arrows on every pushed page. The drop lives in this\n    // shared resolver, not in each surface preset, because the shell mounts\n    // hosted components through the generic component REGISTRY (which resolves\n    // the preset directly and never sees the wrapper's gate); one site here\n    // covers the menubar and the sidebar together.\n    if (\n      compType === ApplicationLevelComponentType.NAVIGATION_CONTROL\n      && !navigationBackAffordanceAdmitsShell(navigationLayout?.backAffordanceOwner)\n    ) {\n      continue;\n    }\n\n    const frontendType = mapApplicationLevelToFrontendComponentType(compType);\n    if (!frontendType) continue;\n\n    const instanceIndex = componentCounts.get(compType) ?? 0;\n    componentCounts.set(compType, instanceIndex + 1);\n\n    resolved.push({\n      instanceId: `${surface}:${compType}-${instanceIndex}`,\n      component: compType,\n      frontendComponentType: frontendType,\n      placement: (hc.placement as HorizontalPlacement | VerticalPlacement | undefined) ?? defaultPlacement,\n      presetName: hc.presetName,\n      triggerWidth: hc.triggerWidth,\n      triggerAppearance: hc.triggerAppearance,\n    });\n  }\n\n  return resolved;\n}\n"]}

package/dist/esm/core/app-shell/useAppShellLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAppShellLayout.d.ts","sourceRoot":"","sources":["../../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,CAyDtD"}
+{"version":3,"file":"useAppShellLayout.d.ts","sourceRoot":"","sources":["../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,CAyDtD"}

package/dist/esm/core/app-shell/useAppShellLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAppShellLayout.js","sourceRoot":"","sources":["../../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useMemo } from 'react';\n\nimport { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { MainContextInitComponents } from '~wildo-frontend-lib/core/runtime/runtime.frontend.schemas';\n\nimport type { AppShellLayoutInfo } from './app-shell.schemas';\nimport { isSidebarConfigObject, isStatusBarConfigObject, isUtilityPanelConfigObject } from './app-shell.schemas';\n\n/**\n * Pure behavior hook for the app shell layout — computes which app-level\n * components are present and their placement, and gates application\n * initialization via `markComponentInitialized`.\n *\n * `has*` flags reflect *config presence*, not visibility (breakpoint-gated\n * visibility is the preset's responsibility).\n */\nexport function useAppShellLayout(): AppShellLayoutInfo {\n  const { UIConfig, navigationLayout: resolvedNavigationLayout, appComponentsConfiguration } = useUI();\n  const { markComponentInitialized } = useApplication();\n\n  const isLayoutReady = Boolean(resolvedNavigationLayout && appComponentsConfiguration);\n\n  useEffect(() => {\n    if (isLayoutReady) {\n      markComponentInitialized(MainContextInitComponents.APP_MAIN_CONTAINER);\n    }\n  }, [isLayoutReady, markComponentInitialized]);\n\n  return useMemo((): AppShellLayoutInfo => {\n    if (!isLayoutReady || !resolvedNavigationLayout || !appComponentsConfiguration) {\n      return {\n        hasMenubar: false,\n        hasSidebar: false,\n        hasStatusBar: false,\n        hasToolbar: false,\n        hasActivityBar: false,\n        hasQuickActionButton: false,\n        hasUtilityPanel: false,\n        sidebarPlacement: HorizontalPlacement.START,\n        statusBarPlacement: VerticalPlacement.BOTTOM,\n        utilityPanelPlacement: HorizontalPlacement.END,\n        isLayoutReady: false,\n      };\n    }\n\n    const sidebarConfig = appComponentsConfiguration[ApplicationLevelComponentType.SIDEBAR] as unknown;\n    const statusBarConfig = appComponentsConfiguration[ApplicationLevelComponentType.STATUS_BAR];\n    const utilityPanelConfig = appComponentsConfiguration[ApplicationLevelComponentType.UTILITY_PANEL];\n\n    const sidebarPlacement = isSidebarConfigObject(sidebarConfig)\n      ? sidebarConfig.placement\n      : HorizontalPlacement.START;\n\n    return {\n      hasMenubar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.MENUBAR]),\n      hasSidebar: Boolean(sidebarConfig),\n      hasStatusBar: Boolean(statusBarConfig),\n      hasToolbar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.TOOLBAR]),\n      hasActivityBar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.ACTIVITY_BAR]),\n      hasQuickActionButton: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.QUICK_ACTION_BUTTON]),\n      hasUtilityPanel: Boolean(utilityPanelConfig),\n      sidebarPlacement,\n      statusBarPlacement: typeof statusBarConfig === 'string'\n        ? statusBarConfig as VerticalPlacement\n        : isStatusBarConfigObject(statusBarConfig)\n          ? statusBarConfig.placement ?? VerticalPlacement.BOTTOM\n          : VerticalPlacement.BOTTOM,\n      utilityPanelPlacement: isUtilityPanelConfigObject(utilityPanelConfig)\n        ? utilityPanelConfig.position ?? HorizontalPlacement.END\n        : HorizontalPlacement.END,\n      isLayoutReady: true,\n    };\n  }, [isLayoutReady, resolvedNavigationLayout, appComponentsConfiguration]);\n}\n"]}
+{"version":3,"file":"useAppShellLayout.js","sourceRoot":"","sources":["../../../../src/core/app-shell/useAppShellLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7F,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAGtG,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAEjH;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,GAAG,KAAK,EAAE,CAAC;IACrG,MAAM,EAAE,wBAAwB,EAAE,GAAG,cAAc,EAAE,CAAC;IAEtD,MAAM,aAAa,GAAG,OAAO,CAAC,wBAAwB,IAAI,0BAA0B,CAAC,CAAC;IAEtF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,aAAa,EAAE,CAAC;YAClB,wBAAwB,CAAC,yBAAyB,CAAC,kBAAkB,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,EAAE,CAAC,aAAa,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAE9C,OAAO,OAAO,CAAC,GAAuB,EAAE;QACtC,IAAI,CAAC,aAAa,IAAI,CAAC,wBAAwB,IAAI,CAAC,0BAA0B,EAAE,CAAC;YAC/E,OAAO;gBACL,UAAU,EAAE,KAAK;gBACjB,UAAU,EAAE,KAAK;gBACjB,YAAY,EAAE,KAAK;gBACnB,UAAU,EAAE,KAAK;gBACjB,cAAc,EAAE,KAAK;gBACrB,oBAAoB,EAAE,KAAK;gBAC3B,eAAe,EAAE,KAAK;gBACtB,gBAAgB,EAAE,mBAAmB,CAAC,KAAK;gBAC3C,kBAAkB,EAAE,iBAAiB,CAAC,MAAM;gBAC5C,qBAAqB,EAAE,mBAAmB,CAAC,GAAG;gBAC9C,aAAa,EAAE,KAAK;aACrB,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GAAG,0BAA0B,CAAC,6BAA6B,CAAC,OAAO,CAAY,CAAC;QACnG,MAAM,eAAe,GAAG,0BAA0B,CAAC,6BAA6B,CAAC,UAAU,CAAC,CAAC;QAC7F,MAAM,kBAAkB,GAAG,0BAA0B,CAAC,6BAA6B,CAAC,aAAa,CAAC,CAAC;QAEnG,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,aAAa,CAAC;YAC3D,CAAC,CAAC,aAAa,CAAC,SAAS;YACzB,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC;QAE9B,OAAO;YACL,UAAU,EAAE,OAAO,CAAC,0BAA0B,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC;YACtF,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC;YAClC,YAAY,EAAE,OAAO,CAAC,eAAe,CAAC;YACtC,UAAU,EAAE,OAAO,CAAC,0BAA0B,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC;YACtF,cAAc,EAAE,OAAO,CAAC,0BAA0B,CAAC,6BAA6B,CAAC,YAAY,CAAC,CAAC;YAC/F,oBAAoB,EAAE,OAAO,CAAC,0BAA0B,CAAC,6BAA6B,CAAC,mBAAmB,CAAC,CAAC;YAC5G,eAAe,EAAE,OAAO,CAAC,kBAAkB,CAAC;YAC5C,gBAAgB;YAChB,kBAAkB,EAAE,OAAO,eAAe,KAAK,QAAQ;gBACrD,CAAC,CAAC,eAAoC;gBACtC,CAAC,CAAC,uBAAuB,CAAC,eAAe,CAAC;oBACxC,CAAC,CAAC,eAAe,CAAC,SAAS,IAAI,iBAAiB,CAAC,MAAM;oBACvD,CAAC,CAAC,iBAAiB,CAAC,MAAM;YAC9B,qBAAqB,EAAE,0BAA0B,CAAC,kBAAkB,CAAC;gBACnE,CAAC,CAAC,kBAAkB,CAAC,QAAQ,IAAI,mBAAmB,CAAC,GAAG;gBACxD,CAAC,CAAC,mBAAmB,CAAC,GAAG;YAC3B,aAAa,EAAE,IAAI;SACpB,CAAC;IACJ,CAAC,EAAE,CAAC,aAAa,EAAE,wBAAwB,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAC5E,CAAC","sourcesContent":["import { useEffect, useMemo } from 'react';\n\nimport { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { MainContextInitComponents } from '~wildo-frontend-lib/core/runtime/runtime.frontend.schemas';\n\nimport type { AppShellLayoutInfo } from './app-shell.schemas';\nimport { isSidebarConfigObject, isStatusBarConfigObject, isUtilityPanelConfigObject } from './app-shell.schemas';\n\n/**\n * Pure behavior hook for the app shell layout — computes which app-level\n * components are present and their placement, and gates application\n * initialization via `markComponentInitialized`.\n *\n * `has*` flags reflect *config presence*, not visibility (breakpoint-gated\n * visibility is the preset's responsibility).\n */\nexport function useAppShellLayout(): AppShellLayoutInfo {\n  const { UIConfig, navigationLayout: resolvedNavigationLayout, appComponentsConfiguration } = useUI();\n  const { markComponentInitialized } = useApplication();\n\n  const isLayoutReady = Boolean(resolvedNavigationLayout && appComponentsConfiguration);\n\n  useEffect(() => {\n    if (isLayoutReady) {\n      markComponentInitialized(MainContextInitComponents.APP_MAIN_CONTAINER);\n    }\n  }, [isLayoutReady, markComponentInitialized]);\n\n  return useMemo((): AppShellLayoutInfo => {\n    if (!isLayoutReady || !resolvedNavigationLayout || !appComponentsConfiguration) {\n      return {\n        hasMenubar: false,\n        hasSidebar: false,\n        hasStatusBar: false,\n        hasToolbar: false,\n        hasActivityBar: false,\n        hasQuickActionButton: false,\n        hasUtilityPanel: false,\n        sidebarPlacement: HorizontalPlacement.START,\n        statusBarPlacement: VerticalPlacement.BOTTOM,\n        utilityPanelPlacement: HorizontalPlacement.END,\n        isLayoutReady: false,\n      };\n    }\n\n    const sidebarConfig = appComponentsConfiguration[ApplicationLevelComponentType.SIDEBAR] as unknown;\n    const statusBarConfig = appComponentsConfiguration[ApplicationLevelComponentType.STATUS_BAR];\n    const utilityPanelConfig = appComponentsConfiguration[ApplicationLevelComponentType.UTILITY_PANEL];\n\n    const sidebarPlacement = isSidebarConfigObject(sidebarConfig)\n      ? sidebarConfig.placement\n      : HorizontalPlacement.START;\n\n    return {\n      hasMenubar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.MENUBAR]),\n      hasSidebar: Boolean(sidebarConfig),\n      hasStatusBar: Boolean(statusBarConfig),\n      hasToolbar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.TOOLBAR]),\n      hasActivityBar: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.ACTIVITY_BAR]),\n      hasQuickActionButton: Boolean(appComponentsConfiguration[ApplicationLevelComponentType.QUICK_ACTION_BUTTON]),\n      hasUtilityPanel: Boolean(utilityPanelConfig),\n      sidebarPlacement,\n      statusBarPlacement: typeof statusBarConfig === 'string'\n        ? statusBarConfig as VerticalPlacement\n        : isStatusBarConfigObject(statusBarConfig)\n          ? statusBarConfig.placement ?? VerticalPlacement.BOTTOM\n          : VerticalPlacement.BOTTOM,\n      utilityPanelPlacement: isUtilityPanelConfigObject(utilityPanelConfig)\n        ? utilityPanelConfig.position ?? HorizontalPlacement.END\n        : HorizontalPlacement.END,\n      isLayoutReady: true,\n    };\n  }, [isLayoutReady, resolvedNavigationLayout, appComponentsConfiguration]);\n}\n"]}

package/dist/esm/core/app-shell/usePublicShellLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePublicShellLayout.d.ts","sourceRoot":"","sources":["../../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,UAAQ,GAAG,qBAAqB,CA2BjF"}
+{"version":3,"file":"usePublicShellLayout.d.ts","sourceRoot":"","sources":["../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,UAAQ,GAAG,qBAAqB,CA2BjF"}

package/dist/esm/core/app-shell/usePublicShellLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePublicShellLayout.js","sourceRoot":"","sources":["../../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AACtG,OAAO,EAAE,uBAAuB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AAItF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAa,GAAG,KAAK;IACxD,MAAM,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,GAAG,cAAc,EAAE,CAAC;IAE7E,SAAS,CAAC,GAAG,EAAE;QACb,wBAAwB,CAAC,yBAAyB,CAAC,oBAAoB,CAAC,CAAC;IAC3E,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAE/B;;;;;;;;;;OAUG;IACH,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,MAAM,WAAW,GACf,qBAAqB,CAAC,uBAAuB,KAAK,uBAAuB,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;IAErH,OAAO;QACL,aAAa;QACb,OAAO,EAAE,IAAI;QACb,WAAW;KACZ,CAAC;AACJ,CAAC","sourcesContent":["import { useEffect } from 'react';\n\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { MainContextInitComponents } from '~wildo-frontend-lib/core/runtime/runtime.frontend.schemas';\nimport { PublicShellIdentityMode } from '~wildo-frontend-lib/core/config/app-configuration-frontend.schemas';\nimport { useBrandIdentity } from '~wildo-frontend-lib/core/branding/useBrandIdentity';\n\nimport type { PublicShellLayoutInfo } from './app-shell.schemas';\n\n/**\n * Pure behavior hook for the public shell layout.\n *\n * Gates application initialization via `markComponentInitialized` on mount, exposes layout mode\n * (`useCardLayout`), and resolves the identity the public pages may present.\n */\nexport function usePublicShellLayout(useCardLayout = false): PublicShellLayoutInfo {\n  const { markComponentInitialized, frontendConfiguration } = useApplication();\n\n  useEffect(() => {\n    markComponentInitialized(MainContextInitComponents.PUBLIC_APP_CONTAINER);\n  }, [markComponentInitialized]);\n\n  /*\n   * Read UNCONDITIONALLY (rules of hooks) but EXPOSED only in the opted-in mode, which is exactly\n   * how `useSidebarBehavior` gates its own brand header — so a preset cannot render an application's\n   * mark on a surface the application never opted into, and the gate lives in one place rather than\n   * in each preset that happens to remember it.\n   *\n   * `SYMBOL` is the requested composition (the default): the header renders the NAME as text beside\n   * the mark, and a lockup would print the name twice. `resolveBrandAsset`'s last fallback rung can\n   * still return a wordmark or lockup for a brand that generated no symbol, which is why the\n   * presentation layer branches on the composition it ACTUALLY got.\n   */\n  const brandIdentity = useBrandIdentity();\n  const brandHeader =\n    frontendConfiguration.publicShellIdentityMode === PublicShellIdentityMode.BRAND_HEADER ? brandIdentity : undefined;\n\n  return {\n    useCardLayout,\n    isReady: true,\n    brandHeader,\n  };\n}\n"]}
+{"version":3,"file":"usePublicShellLayout.js","sourceRoot":"","sources":["../../../../src/core/app-shell/usePublicShellLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AACtG,OAAO,EAAE,uBAAuB,EAAE,MAAM,oEAAoE,CAAC;AAC7G,OAAO,EAAE,gBAAgB,EAAE,MAAM,oDAAoD,CAAC;AAItF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAa,GAAG,KAAK;IACxD,MAAM,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,GAAG,cAAc,EAAE,CAAC;IAE7E,SAAS,CAAC,GAAG,EAAE;QACb,wBAAwB,CAAC,yBAAyB,CAAC,oBAAoB,CAAC,CAAC;IAC3E,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAE/B;;;;;;;;;;OAUG;IACH,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,MAAM,WAAW,GACf,qBAAqB,CAAC,uBAAuB,KAAK,uBAAuB,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;IAErH,OAAO;QACL,aAAa;QACb,OAAO,EAAE,IAAI;QACb,WAAW;KACZ,CAAC;AACJ,CAAC","sourcesContent":["import { useEffect } from 'react';\n\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { MainContextInitComponents } from '~wildo-frontend-lib/core/runtime/runtime.frontend.schemas';\nimport { PublicShellIdentityMode } from '~wildo-frontend-lib/core/config/app-configuration-frontend.schemas';\nimport { useBrandIdentity } from '~wildo-frontend-lib/core/branding/useBrandIdentity';\n\nimport type { PublicShellLayoutInfo } from './app-shell.schemas';\n\n/**\n * Pure behavior hook for the public shell layout.\n *\n * Gates application initialization via `markComponentInitialized` on mount, exposes layout mode\n * (`useCardLayout`), and resolves the identity the public pages may present.\n */\nexport function usePublicShellLayout(useCardLayout = false): PublicShellLayoutInfo {\n  const { markComponentInitialized, frontendConfiguration } = useApplication();\n\n  useEffect(() => {\n    markComponentInitialized(MainContextInitComponents.PUBLIC_APP_CONTAINER);\n  }, [markComponentInitialized]);\n\n  /*\n   * Read UNCONDITIONALLY (rules of hooks) but EXPOSED only in the opted-in mode, which is exactly\n   * how `useSidebarBehavior` gates its own brand header — so a preset cannot render an application's\n   * mark on a surface the application never opted into, and the gate lives in one place rather than\n   * in each preset that happens to remember it.\n   *\n   * `SYMBOL` is the requested composition (the default): the header renders the NAME as text beside\n   * the mark, and a lockup would print the name twice. `resolveBrandAsset`'s last fallback rung can\n   * still return a wordmark or lockup for a brand that generated no symbol, which is why the\n   * presentation layer branches on the composition it ACTUALLY got.\n   */\n  const brandIdentity = useBrandIdentity();\n  const brandHeader =\n    frontendConfiguration.publicShellIdentityMode === PublicShellIdentityMode.BRAND_HEADER ? brandIdentity : undefined;\n\n  return {\n    useCardLayout,\n    isReady: true,\n    brandHeader,\n  };\n}\n"]}

package/dist/esm/core/automated-layout/automated-layout.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"automated-layout.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/automated-layout/automated-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAO7B;;;GAGG;AACH,eAAO,MAAM,uBAAuB,yBAAyB,CAAC;AAM9D;;;GAGG;AACH,oBAAY,eAAe;IACzB,yCAAyC;IACzC,OAAO,YAAY;IACnB,gDAAgD;IAChD,OAAO,YAAY;IACnB,mCAAmC;IACnC,MAAM,WAAW;IACjB,+EAA+E;IAC/E,KAAK,UAAU;IACf,iCAAiC;IACjC,KAAK,UAAU;CAChB;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACzB,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,IAAI,GAC1B,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAMlB;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,0CAA0C,CAAC,EAAE,MAAM,EAAE,CAAC;IACtD,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,+CAA+C;QAC/C,uBAAuB,EAAE,MAAM,CAAC;QAChC,2CAA2C;QAC3C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;QACrB,8DAA8D;QAC9D,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;KAC3D,CAAC,CAAC;CACJ"}
+{"version":3,"file":"automated-layout.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/automated-layout/automated-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAO7B;;;GAGG;AACH,eAAO,MAAM,uBAAuB,yBAAyB,CAAC;AAM9D;;;GAGG;AACH,oBAAY,eAAe;IACzB,yCAAyC;IACzC,OAAO,YAAY;IACnB,gDAAgD;IAChD,OAAO,YAAY;IACnB,mCAAmC;IACnC,MAAM,WAAW;IACjB,+EAA+E;IAC/E,KAAK,UAAU;IACf,iCAAiC;IACjC,KAAK,UAAU;CAChB;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACzB,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,IAAI,GAC1B,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAMlB;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,0CAA0C,CAAC,EAAE,MAAM,EAAE,CAAC;IACtD,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,+CAA+C;QAC/C,uBAAuB,EAAE,MAAM,CAAC;QAChC,2CAA2C;QAC3C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;QACrB,8DAA8D;QAC9D,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;KAC3D,CAAC,CAAC;CACJ"}

package/dist/esm/core/automated-layout/automated-layout.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"automated-layout.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/automated-layout/automated-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GACf,MAAM,0BAA0B,CAAC;AAOlC,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAC,OAAO,CAAC;AAE9D,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAN,IAAY,eAWX;AAXD,WAAY,eAAe;IACzB,yCAAyC;IACzC,sCAAmB,CAAA;IACnB,gDAAgD;IAChD,sCAAmB,CAAA;IACnB,mCAAmC;IACnC,oCAAiB,CAAA;IACjB,+EAA+E;IAC/E,kCAAe,CAAA;IACf,iCAAiC;IACjC,kCAAe,CAAA;AACjB,CAAC,EAXW,eAAe,KAAf,eAAe,QAW1B","sourcesContent":["import {\n  ValidationMode,\n} from '@wildo-ai/zod-decorators';\n\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\n\nimport type { z } from 'zod';\n\n\n// =============================================================================\n// VALIDATION CONSTANTS\n// =============================================================================\n\n/**\n * Default validation mode for all forms.\n * Centralized constant for consistent default behavior.\n */\nexport const DEFAULT_VALIDATION_MODE = ValidationMode.ON_BLUR;\n\n// =============================================================================\n// INLINE EDIT STATE\n// =============================================================================\n\n/**\n * State enum for inline field editing.\n * Represents the different states a field can be in during inline editing.\n */\nexport enum InlineEditState {\n  /** Displaying value, not in edit mode */\n  DISPLAY = 'display',\n  /** In edit mode, user is modifying the value */\n  EDITING = 'editing',\n  /** Saving changes to the server */\n  SAVING = 'saving',\n  /** Save completed successfully (brief feedback before returning to DISPLAY) */\n  SAVED = 'saved',\n  /** Save failed, showing error */\n  ERROR = 'error',\n}\n\n// =============================================================================\n// FORM OPERATION TYPE\n// =============================================================================\n\n/**\n * Operation type for controlling field visibility based on operation context.\n * Uses CoreResourceOperation enum values for type safety.\n * Used with excludeFromCreate, excludeFromUpdate, and isHidden(operations) decorators.\n * \n * Branded with `& {}` to allow custom string values through type assertion\n * without collapsing the entire union to `string` (which kills autocomplete).\n */\nexport type FormOperationType = \n  | CoreResourceOperation.CREATE \n  | CoreResourceOperation.UPDATE \n  | CoreResourceOperation.READ\n  | (string & {});\n\n// =============================================================================\n// INHERITANCE SCHEMA DEFINITION\n// =============================================================================\n\n/**\n * Inheritance schema definition for discriminated unions.\n * Used to track which fields belong to which variants for conditional visibility.\n * \n * This is a simplified, non-generic version of ResourceConfiguration_InheritanceSchemaDefinition\n * from @wildo-ai/saas-models, optimized for frontend use. It is structurally compatible\n * with the backend type but avoids complex generics that aren't needed for UI rendering.\n */\nexport interface InheritanceSchemaDefinition {\n  /** Field name used for discrimination (e.g., 'type', 'recurringType') */\n  discriminatorField: string;\n  /** Discriminator values that use base schema only (no variant extension) */\n  withoutInheritanceDiscriminatorFieldValues?: string[];\n  /** Variant schemas for each discriminator value */\n  inheritedSchemas?: Array<{\n    /** The discriminator value for this variant */\n    discriminatorFieldValue: string;\n    /** The extended schema for this variant */\n    schema: z.ZodTypeAny;\n    /** Nested inheritance for multi-level discriminated unions */\n    inheritenceSchemaDefinition?: InheritanceSchemaDefinition;\n  }>;\n}\n"]}
+{"version":3,"file":"automated-layout.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/automated-layout/automated-layout.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GACf,MAAM,0BAA0B,CAAC;AAOlC,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAC,OAAO,CAAC;AAE9D,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAN,IAAY,eAWX;AAXD,WAAY,eAAe;IACzB,yCAAyC;IACzC,sCAAmB,CAAA;IACnB,gDAAgD;IAChD,sCAAmB,CAAA;IACnB,mCAAmC;IACnC,oCAAiB,CAAA;IACjB,+EAA+E;IAC/E,kCAAe,CAAA;IACf,iCAAiC;IACjC,kCAAe,CAAA;AACjB,CAAC,EAXW,eAAe,KAAf,eAAe,QAW1B","sourcesContent":["import {\n  ValidationMode,\n} from '@wildo-ai/zod-decorators';\n\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\n\nimport type { z } from 'zod';\n\n\n// =============================================================================\n// VALIDATION CONSTANTS\n// =============================================================================\n\n/**\n * Default validation mode for all forms.\n * Centralized constant for consistent default behavior.\n */\nexport const DEFAULT_VALIDATION_MODE = ValidationMode.ON_BLUR;\n\n// =============================================================================\n// INLINE EDIT STATE\n// =============================================================================\n\n/**\n * State enum for inline field editing.\n * Represents the different states a field can be in during inline editing.\n */\nexport enum InlineEditState {\n  /** Displaying value, not in edit mode */\n  DISPLAY = 'display',\n  /** In edit mode, user is modifying the value */\n  EDITING = 'editing',\n  /** Saving changes to the server */\n  SAVING = 'saving',\n  /** Save completed successfully (brief feedback before returning to DISPLAY) */\n  SAVED = 'saved',\n  /** Save failed, showing error */\n  ERROR = 'error',\n}\n\n// =============================================================================\n// FORM OPERATION TYPE\n// =============================================================================\n\n/**\n * Operation type for controlling field visibility based on operation context.\n * Uses CoreResourceOperation enum values for type safety.\n * Used with excludeFromCreate, excludeFromUpdate, and isHidden(operations) decorators.\n * \n * Branded with `& {}` to allow custom string values through type assertion\n * without collapsing the entire union to `string` (which kills autocomplete).\n */\nexport type FormOperationType = \n  | CoreResourceOperation.CREATE \n  | CoreResourceOperation.UPDATE \n  | CoreResourceOperation.READ\n  | (string & {});\n\n// =============================================================================\n// INHERITANCE SCHEMA DEFINITION\n// =============================================================================\n\n/**\n * Inheritance schema definition for discriminated unions.\n * Used to track which fields belong to which variants for conditional visibility.\n * \n * This is a simplified, non-generic version of ResourceConfiguration_InheritanceSchemaDefinition\n * from @wildo-ai/saas-models, optimized for frontend use. It is structurally compatible\n * with the backend type but avoids complex generics that aren't needed for UI rendering.\n */\nexport interface InheritanceSchemaDefinition {\n  /** Field name used for discrimination (e.g., 'type', 'recurringType') */\n  discriminatorField: string;\n  /** Discriminator values that use base schema only (no variant extension) */\n  withoutInheritanceDiscriminatorFieldValues?: string[];\n  /** Variant schemas for each discriminator value */\n  inheritedSchemas?: Array<{\n    /** The discriminator value for this variant */\n    discriminatorFieldValue: string;\n    /** The extended schema for this variant */\n    schema: z.ZodTypeAny;\n    /** Nested inheritance for multi-level discriminated unions */\n    inheritenceSchemaDefinition?: InheritanceSchemaDefinition;\n  }>;\n}\n"]}

package/dist/esm/core/automated-layout/automated-layout.frontend.utils.d.ts

@@ -7,20 +7,40 @@ export declare class AutomatedLayoutFrontendUtils {
     private static areFileMetadataCompatible;
     private static collectFileFieldMetadata;
     /**
-     * Fallback: convert a single field key segment from camelCase / snake_case / kebab-case
-     * into sentence case. Used when i18n label resolution is not available or returns no match.
+     * What a field renders as when no label resolved — the RAW KEY SEGMENT, unchanged.
      *
-     * Handles acronym sequences correctly:
-     * - `HTMLContent` → `HTML Content`
-     * - `APIKey` → `API Key`
-     * - `userId` → `User ID`
-     * - `firstName` → `First Name`
-     * - `created_at` → `Created At`
-     * - `is-active` → `Is Active`
+     * ## Why this returns the key rather than words
+     *
+     * Until 2026-09-08 this was `unresolvedFieldLabel`, and it produced sentence case from the
+     * identifier: `firstName` -> `First Name`, `created_at` -> `Created At`, with a special case
+     * turning `Id` into `ID`. It was convincing, which is exactly what made it a defect (#420):
+     *
+     * - **a missing label did not look missing**, so nobody ever authored one. The fallback ran only
+     *   where the label was absent — precisely the case somebody needed to notice;
+     * - **it was English in every locale**, because it was code producing words rather than a
+     *   translation, and no translator could find it — it was not in the label tree;
+     * - **it was silently wrong on anything it could not know**: `GDPR` -> `Gdpr`, `EUR` -> `Eur`.
+     *   Which all-caps token is an acronym is not derivable from the string, so the `Id` special case
+     *   was a guess that happened to be right once.
+     *
+     * The key itself is honest: visible, greppable, obviously not a label, identical in every locale.
+     * It is what `t()` already returns for an unresolved key.
+     *
+     * ## Why an identity function rather than nothing
+     *
+     * The call is kept, named and documented in one place so the surfaces that reach it share ONE
+     * decision rather than nine inlined ones — and so a future author who wants to "improve the
+     * fallback" finds this argument instead of an anonymous expression. See
+     * `.claude/rules/display-text-comes-from-i18n.md`.
+     *
+     * ## When it is reached
+     *
+     * Only AFTER label resolution has SETTLED. Surfaces gate on `useI18n().isReady`, which settles on
+     * a failed bundle as well as a loaded one, so a key is never flashed while labels are in flight.
      *
      * @param key - A single field key segment (no dots)
      */
-    static formatFieldLabelFallback(key: string): string;
+    static unresolvedFieldLabel(key: string): string;
     /**
      * Fallback: format a full dotted field path for display in error messages and breadcrumbs.
      * Each segment is formatted individually and joined with ` › `.
@@ -47,7 +67,7 @@ export declare class AutomatedLayoutFrontendUtils {
      * Returns a function that resolves a dot-path to a human-readable label.
      *
      * When `resourceType` is provided, each path segment is resolved via `tResourceFieldEdit`.
-     * If the i18n lookup returns the raw key (not found), falls back to `formatFieldLabelFallback`.
+     * If the i18n lookup returns the raw key (not found), falls back to `unresolvedFieldLabel`.
      * When `resourceType` is not provided, uses `formatFieldPathFallback` directly.
      *
      * @param resourceType - The resource type for i18n lookup

package/dist/esm/core/automated-layout/automated-layout.frontend.utils.d.ts.map

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

package/dist/esm/core/automated-layout/automated-layout.frontend.utils.js

@@ -74,32 +74,41 @@ export class AutomatedLayoutFrontendUtils {
     // FIELD LABEL FORMATTING
     // =============================================================================
     /**
-     * Fallback: convert a single field key segment from camelCase / snake_case / kebab-case
-     * into sentence case. Used when i18n label resolution is not available or returns no match.
+     * What a field renders as when no label resolved — the RAW KEY SEGMENT, unchanged.
      *
-     * Handles acronym sequences correctly:
-     * - `HTMLContent` → `HTML Content`
-     * - `APIKey` → `API Key`
-     * - `userId` → `User ID`
-     * - `firstName` → `First Name`
-     * - `created_at` → `Created At`
-     * - `is-active` → `Is Active`
+     * ## Why this returns the key rather than words
+     *
+     * Until 2026-09-08 this was `unresolvedFieldLabel`, and it produced sentence case from the
+     * identifier: `firstName` -> `First Name`, `created_at` -> `Created At`, with a special case
+     * turning `Id` into `ID`. It was convincing, which is exactly what made it a defect (#420):
+     *
+     * - **a missing label did not look missing**, so nobody ever authored one. The fallback ran only
+     *   where the label was absent — precisely the case somebody needed to notice;
+     * - **it was English in every locale**, because it was code producing words rather than a
+     *   translation, and no translator could find it — it was not in the label tree;
+     * - **it was silently wrong on anything it could not know**: `GDPR` -> `Gdpr`, `EUR` -> `Eur`.
+     *   Which all-caps token is an acronym is not derivable from the string, so the `Id` special case
+     *   was a guess that happened to be right once.
+     *
+     * The key itself is honest: visible, greppable, obviously not a label, identical in every locale.
+     * It is what `t()` already returns for an unresolved key.
+     *
+     * ## Why an identity function rather than nothing
+     *
+     * The call is kept, named and documented in one place so the surfaces that reach it share ONE
+     * decision rather than nine inlined ones — and so a future author who wants to "improve the
+     * fallback" finds this argument instead of an anonymous expression. See
+     * `.claude/rules/display-text-comes-from-i18n.md`.
+     *
+     * ## When it is reached
+     *
+     * Only AFTER label resolution has SETTLED. Surfaces gate on `useI18n().isReady`, which settles on
+     * a failed bundle as well as a loaded one, so a key is never flashed while labels are in flight.
      *
      * @param key - A single field key segment (no dots)
      */
-    static formatFieldLabelFallback(key) {
-        return key
-            // Consecutive uppercase followed by uppercase+lowercase: HTMLContent → HTML Content
-            .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
-            // Lowercase/digit followed by uppercase: firstName → first Name, item2Name → item2 Name
-            .replace(/([a-z\d])([A-Z])/g, '$1 $2')
-            // Replace underscores and hyphens with spaces
-            .replace(/[_-]/g, ' ')
-            // Normalize "Id" standalone word to "ID"
-            .replace(/\bId\b/g, 'ID')
-            // Capitalize first letter
-            .replace(/^\w/, (c) => c.toUpperCase())
-            .trim();
+    static unresolvedFieldLabel(key) {
+        return key;
     }
     /**
      * Fallback: format a full dotted field path for display in error messages and breadcrumbs.
@@ -116,7 +125,7 @@ export class AutomatedLayoutFrontendUtils {
             .split('.')
             .map((part) => /^\d+$/.test(part)
             ? `[${parseInt(part, 10) + 1}]`
-            : AutomatedLayoutFrontendUtils.formatFieldLabelFallback(part))
+            : AutomatedLayoutFrontendUtils.unresolvedFieldLabel(part))
             .join(' › ');
     }
     /**
@@ -136,7 +145,7 @@ export class AutomatedLayoutFrontendUtils {
      * Returns a function that resolves a dot-path to a human-readable label.
      *
      * When `resourceType` is provided, each path segment is resolved via `tResourceFieldEdit`.
-     * If the i18n lookup returns the raw key (not found), falls back to `formatFieldLabelFallback`.
+     * If the i18n lookup returns the raw key (not found), falls back to `unresolvedFieldLabel`.
      * When `resourceType` is not provided, uses `formatFieldPathFallback` directly.
      *
      * @param resourceType - The resource type for i18n lookup
@@ -158,7 +167,7 @@ export class AutomatedLayoutFrontendUtils {
                 const label = tResourceFieldEdit(resourceType, fieldPath, 'label');
                 const rawI18nKey = `${resourceType}.${fieldPath}.label`;
                 if (label === rawI18nKey) {
-                    return AutomatedLayoutFrontendUtils.formatFieldLabelFallback(segment);
+                    return AutomatedLayoutFrontendUtils.unresolvedFieldLabel(segment);
                 }
                 return label;
             })