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

package/dist/esm/core/config/launcher-items.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"launcher-items.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/config/launcher-items.frontend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Launcher Item Types & Schemas\n *\n * Per-launcher content declaration model. Each launcher (sidebar, command menu,\n * quick action button, etc.) declares its own content using these types.\n *\n * `LauncherItemTargetKind` is the discriminant for `LauncherItemRef` — it tells\n * the resolution layer what kind of target a launcher item points to.\n *\n * `SidebarSectionContentKind` is the discriminant for sidebar section content —\n * determines whether a section renders a navigation list, a resource browser,\n * a guidance widget, or a custom component.\n *\n * These types are config-time types. The resolution layer (Step 2) transforms\n * them into runtime `ResolvedNavigationItem` instances.\n *\n * @see launcher-operation-binding-analysis.md §3.1.1, §3.2\n * @see component-taxonomy-deep-review.md §3.5\n */\n\nimport { z } from 'zod';\nimport {\n  SidebarItemDisplayPolicy,\n  CommandMenuDisplayPolicy,\n  QuickActionDisplayPolicy,\n  HotkeyScope,\n} from './app-level-components.frontend.schemas';\nimport { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport { ViewportBreakpoint, ForeignKeyDisplayMode } from '@wildo-ai/zod-decorators';\nimport { CommonRoutePaths } from '~wildo-frontend-lib/core/runtime/routes.frontend.definitions';\nimport { StandardIconReference } from '~wildo-frontend-lib/core/icons/icon-registry.frontend.schemas';\nimport type { AppScopeValue } from '~wildo-frontend-lib/core/scope/scope.frontend.schemas';\n\n// ════════════════════════════════════════════════════════════════\n// Launcher Item Target Kind\n// ════════════════════════════════════════════════════════════════\n\n/**\n * What kind of target a launcher item points to.\n *\n * This is a config-time concept — the resolution layer maps each kind to a\n * navigation action. Different from `NavigationContentType` which is a runtime\n * concept for zone content rendering. Both have `RESOURCE_OPERATION` but serve\n * different axes: `LauncherItemTargetKind` = what a launcher item targets,\n * `NavigationContentType` = what renders in a navigation zone.\n *\n * @see launcher-operation-binding-analysis.md §3.1.1\n */\nexport enum LauncherItemTargetKind {\n  /** Navigate to a resource operation (list, create, read, etc.). */\n  RESOURCE_OPERATION = 'resource_operation',\n  /** Navigate to an application-scoped special view. */\n  VIEW = 'view',\n  /** Navigate to a resource-scoped special view. */\n  RESOURCE_VIEW = 'resource_view',\n  /** Navigate to a framework-provided page (home, security settings, etc.). */\n  ENGINE_PAGE = 'engine_page',\n  /** Render a custom registered React component. */\n  CUSTOM_COMPONENT = 'custom_component',\n  /** Open the unified Settings Hub (overlay), optionally at a specific section. */\n  SETTINGS_SECTION = 'settings_section',\n}\n\n// ════════════════════════════════════════════════════════════════\n// Engine Page Ref (closed enum)\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Framework-provided navigable pages.\n *\n * Closed enum — only framework pages belong here. Auth routes (login, register, etc.)\n * are NOT engine pages. Dev routes (devTest, devThemeGallery) are excluded.\n *\n * The resolution layer maps these to `CommonRoutePaths` in `routes.frontend.definitions.ts`.\n *\n * @see app-shell-implementation-plan.md Step 0 item 1\n */\nexport enum EnginePageRef {\n  /** Home page — maps to `CommonRoutePaths.home` (`/`) */\n  HOME = 'home',\n  // NOTE: security settings is no longer a standalone engine page — it is a\n  // section panel inside the unified Settings Hub (`/settings/security` opens the\n  // hub at its Security section via `SETTINGS_SECTION` / `useSettingsHubOverlaySync`).\n}\n\n/**\n * Per-engine-page metadata: route, i18n label key, standard icon.\n *\n * Single source of truth — consumed by:\n * - `launcher-resolution.ts` (route + label + icon for resolved engine pages)\n * - `verify-launcher-content.ts` (pageRef existence check)\n * - `useNavigationBehaviors.ts` (home route lookup)\n * - companion `planEnginePageUnits()` (label-key generation)\n *\n * Adding a new engine page = adding the `EnginePageRef` enum entry above\n * + one record entry here. No other touch-up needed.\n */\nexport interface EnginePageMetadata {\n  /** Route path under the app. */\n  route: string;\n  /**\n   * i18n key used to resolve the page's display label at\n   * `engine.pages.<key>.title` (the companion's `planEnginePageUnits()`\n   * emits matching keys for label generation).\n   */\n  i18nKey: string;\n  /** Standard icon to render for navigation entries pointing at this page. */\n  icon: StandardIconReference;\n}\n\nexport const ENGINE_PAGE_METADATA: Record<EnginePageRef, EnginePageMetadata> = {\n  [EnginePageRef.HOME]: {\n    route: CommonRoutePaths.home,\n    i18nKey: 'engine.pages.home',\n    icon: StandardIconReference.HOME,\n  },\n};\n\n// ════════════════════════════════════════════════════════════════\n// Activity Bar & Sidebar Enums\n// ════════════════════════════════════════════════════════════════\n\n/**\n * How the Activity Bar renders at different breakpoints.\n *\n * The activity bar is the mode selector — it shows available `AppMode`s and\n * lets the user switch between them. Its rendering varies by breakpoint.\n *\n * @see component-taxonomy-deep-review.md §3.5.2\n */\nexport enum ActivityBarRendering {\n  /** Vertical icon column on the left side (desktop default). */\n  VERTICAL_RAIL = 'vertical_rail',\n  /** Horizontal icon row at the top (alternative desktop layout). */\n  HORIZONTAL_BAR = 'horizontal_bar',\n  /** Persistent bottom tab bar (mobile). */\n  BOTTOM_TAB_BAR = 'bottom_tab_bar',\n}\n\n/**\n * Sidebar responsive behavior on mobile breakpoints.\n *\n * Controls how the sidebar adapts when the viewport shrinks below\n * its responsive breakpoint.\n *\n * @see component-taxonomy-deep-review.md §7.1\n */\nexport enum SidebarResponsivePolicy {\n  /** Sidebar becomes a burger menu / drawer overlay on mobile. */\n  BURGER = 'BURGER',\n  /** Sidebar stays visible but auto-expands on desktop. */\n  DRAWER = 'DRAWER',\n}\n\n/**\n * How the sidebar surfaces the application's HOME destination.\n *\n * Three mutually-exclusive presentations of ONE concept — an app picks the one\n * matching its shell identity, and the framework never renders two home\n * affordances at once.\n */\nexport enum SidebarHomeDisplayMode {\n  /**\n   * No home affordance in the sidebar at all. For apps whose home is reached\n   * elsewhere (a menubar brand, a logo in the shell header) or that have no\n   * meaningful home surface.\n   */\n  HIDDEN = 'hidden',\n  /**\n   * The application's brand header: its SYMBOL brand asset plus the application\n   * display name, PINNED at the very top of the sidebar — above the scroll\n   * region and therefore above any hosted component (e.g. the command-menu\n   * search trigger). Clicking it navigates home. This is the Slack / Linear /\n   * Notion shell convention: the product identity doubles as the home button,\n   * so no separate \"Home\" row is needed. Collapsed to the icon rail it shows\n   * the symbol alone.\n   *\n   * The logo resolves from the app's `brandAssets` (see `RuntimeBrandAsset` /\n   * `resolveBrandAsset` in `@wildo-ai/saas-models`) for the active light/dark\n   * theme; an app with no generated brand shows the name alone (and the\n   * framework home icon on the collapsed rail).\n   */\n  BRAND_HEADER = 'brand_header',\n  /**\n   * A \"Home\" navigation ROW at the top of the primary navigation group, beside\n   * the app's other top-level destinations. The framework default — it assumes\n   * nothing about brand assets.\n   */\n  NAVIGATION_ITEM = 'navigation_item',\n}\n\n/** Sidebar section behavior mode — where a section's ITEMS come from. */\nexport enum SidebarSectionBehavior {\n  /** Items are exactly the declared `children`. */\n  STATIC = 'static',\n  /** Items are produced at runtime by the section's content kind. */\n  DYNAMIC = 'dynamic',\n  /**\n   * Items are the USER'S FAVORITED navigation items: the engine populates the\n   * section from starred items across the other navigation-list sections\n   * (persisted machine-locally under `LOCAL_STORAGE_KEYS.SIDEBAR_FAVORITES`),\n   * REPLACING any declared `children` — author none. Declaring a FAVORITES\n   * section is what enables the hover-star affordance on sidebar rows; the\n   * section is hidden entirely while no favorites exist, and the engine\n   * ordering policy places it right after the primary group. Declare at most\n   * ONE favorites section: several would render the same favorited copies\n   * (same ids) in each, and the active-row election would highlight one row\n   * per duplicate id.\n   */\n  FAVORITES = 'favorites',\n}\n\n/** Sidebar section inline create mode. */\nexport enum SidebarSectionInlineCreate {\n  NONE = 'none',\n  INPUT = 'input',\n  DIALOG = 'dialog',\n}\n\n/**\n * Quick Action Button placement mode.\n *\n * Replaces the literal string `\"FLOATING\"` patterns in existing schemas.\n * After container inversion (Step 4), the only placement is `FLOATING` or\n * `CONTAINED` (hosted by menubar/sidebar via `hostedComponents`).\n */\nexport enum QuickActionButtonPlacement {\n  /** Floating action button overlaying the content area. */\n  FLOATING = 'FLOATING',\n  /** Contained within a parent component (menubar or sidebar). */\n  CONTAINED = 'CONTAINED',\n}\n\n// ════════════════════════════════════════════════════════════════\n// Sidebar Section Content Kind\n// ════════════════════════════════════════════════════════════════\n\n/**\n * What kind of content a sidebar section renders.\n *\n * This is the discriminant for the `SidebarSection` discriminated union.\n * Each content kind has its own set of properties and rendering behavior.\n *\n * @see launcher-operation-binding-analysis.md §3.3.1\n */\nexport enum SidebarSectionContentKind {\n  /** Traditional navigation item list (tree, collapsible, inline create). */\n  NAVIGATION_LIST = 'navigation_list',\n  /** Filterable resource instance list — fetches from a bound operation. */\n  RESOURCE_BROWSER = 'resource_browser',\n  /** Guidance/onboarding widget — renders a registered guidance component. */\n  GUIDANCE_WIDGET = 'guidance_widget',\n  /** Arbitrary registered React component. */\n  CUSTOM_COMPONENT = 'custom_component',\n}\n\n// ════════════════════════════════════════════════════════════════\n// LauncherItemRef — Discriminated Union\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Points to a resource operation (list, create, read, etc.).\n * The resolution layer resolves this via the resource registry.\n */\nexport interface ResourceOperationItemRef {\n  kind: LauncherItemTargetKind.RESOURCE_OPERATION;\n  resourceType: string;\n  operation: string;\n  operationVariant?: string;\n}\n\n/** Points to an application-scoped special view. */\nexport interface ViewItemRef {\n  kind: LauncherItemTargetKind.VIEW;\n  viewRef: string;\n}\n\n/** Points to a resource-scoped special view. */\nexport interface ResourceViewItemRef {\n  kind: LauncherItemTargetKind.RESOURCE_VIEW;\n  resourceType: string;\n  viewRef: string;\n}\n\n/** Points to a framework page (home, security settings). */\nexport interface EnginePageItemRef {\n  kind: LauncherItemTargetKind.ENGINE_PAGE;\n  pageRef: EnginePageRef;\n}\n\n/** Points to a registered custom React component. */\nexport interface CustomComponentItemRef {\n  kind: LauncherItemTargetKind.CUSTOM_COMPONENT;\n  componentRef: string;\n}\n\n/**\n * Opens the unified Settings Hub (overlay), optionally pre-selecting a section.\n * Resolves to a `/settings` / `/settings/:sectionRef` URL navigation — the hub\n * is URL-driven (`useSettingsHubRouterSync` reconstructs it), so every settings\n * entry point converges on one destination.\n */\nexport interface SettingsSectionItemRef {\n  kind: LauncherItemTargetKind.SETTINGS_SECTION;\n  /** Section to pre-open; omit to open the hub's default section. */\n  sectionRef?: string;\n}\n\n/**\n * A launcher item reference — identifies WHAT a launcher item targets.\n * Discriminated on `kind`. The resolution layer dispatches on this to\n * produce a `ResolvedNavigationItem`.\n *\n * @see launcher-operation-binding-analysis.md §3.2\n */\nexport type LauncherItemRef =\n  | ResourceOperationItemRef\n  | ViewItemRef\n  | ResourceViewItemRef\n  | EnginePageItemRef\n  | CustomComponentItemRef\n  | SettingsSectionItemRef;\n\n/**\n * Toolbar items are navigation-only launcher refs.\n * Custom-component materialization belongs to other app-level surfaces and is\n * intentionally excluded from the global app-level toolbar contract.\n */\nexport type ToolbarItemRef =\n  | ResourceOperationItemRef\n  | ViewItemRef\n  | ResourceViewItemRef\n  | EnginePageItemRef;\n\n// ════════════════════════════════════════════════════════════════\n// Per-Launcher Item Types\n// ════════════════════════════════════════════════════════════════\n\n/**\n * A sidebar navigation item — extends `LauncherItemRef` with sidebar-specific\n * display properties. Supports all launcher target kinds as targets.\n */\nexport type SidebarItem = LauncherItemRef & {\n  displayPolicy?: SidebarItemDisplayPolicy;\n  /**\n   * Typed reference to a registered `NotificationBadgeDefinition` (its\n   * `identifier`). Unlike the retired free-string `badgeReference`, this resolves\n   * against the app's `notificationBadgeDefinitions` — the resolved definition\n   * supplies the display mode / tone / pulse, and the live count comes from\n   * `useNotificationBadges`. Validated in `verify-launcher-content`.\n   */\n  notificationBadgeRef?: string;\n  children?: SidebarItem[];\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n};\n\n/** A command menu entry. */\nexport type CommandMenuCommand = LauncherItemRef & {\n  category?: string;\n  shortcut?: string;\n  /**\n   * OPTIONAL extra literal match terms, appended to the localized keyword set\n   * the palette already resolves for this command. These literals are NOT\n   * translated — reserve them for genuinely app-specific jargon that no\n   * localized label or operation-verb synonym covers (e.g. an internal codename\n   * like `\"boards\"` for a Todo-Lists list command).\n   *\n   * You do NOT need to author generic action verbs here: for a\n   * `RESOURCE_OPERATION` command the framework already folds in the LOCALIZED\n   * operation-verb synonyms (`components.APPLICATION_LEVEL_COMMAND_MENU.keywords*`,\n   * generated + translated by the labelling pipeline) keyed off the command's\n   * core operation semantic, and the record/command noun is covered by the\n   * command's already-localized label. So a French user finds \"Create Todo\" by\n   * typing \"nouveau\"/\"créer\" without any literal being authored here.\n   */\n  searchKeywords?: string[];\n  displayPolicy?: CommandMenuDisplayPolicy;\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n};\n\n/**\n * @wildo_source:part:start saas.frontend.command-menu.search-resource facet:layer:frontend facet:family:app-shell\n *\n * Declares one resource whose `SEARCH` operation feeds the command menu's\n * **omnibox** record-search layer. Import from `@wildo-ai/saas-frontend-lib`.\n *\n * You list these on the `[ApplicationLevelComponentType.COMMAND_MENU]`\n * config's `searchResources` array (in `frontend/src/config/app-shell.config.ts`);\n * they take effect **only** when that config also sets\n * `policy: CommandBarPolicy.OMNIBOX`. Each entry opts one resource into live,\n * debounced record search inside the Cmd+K palette.\n *\n * Unlike a {@link CommandMenuCommand} — a static, declarative navigation target\n * — this drives a live, debounced query (≥2 chars, 300ms) against the\n * resource's addressable `SEARCH` operation (falling back to `LIST`). Results\n * are labelled with the resource's own frontend label config and, on\n * selection, navigate to the record's addressable `READ` view. Name the\n * searchable set explicitly so the palette never fires queries against\n * resources the app did not opt in.\n *\n * @example\n * // In frontend/src/config/app-shell.config.ts, on [COMMAND_MENU]:\n * searchResources: [\n *   { resourceType: 'todos', category: 'todos', maxResults: 5 },\n *   { resourceType: 'tasks', category: 'tasks', maxResults: 5 },\n * ]\n */\nexport type CommandMenuSearchResource = {\n  /** Resource type whose SEARCH operation is queried (e.g. `'todos'`). */\n  resourceType: string;\n  /**\n   * Group/category ref the results are placed under in the palette. Defaults\n   * to the `resourceType` (humanized) when omitted. Resolved through the same\n   * i18n category-label path as static command categories.\n   */\n  category?: string;\n  /** Max results fetched per resource per keystroke. Defaults to 5. */\n  maxResults?: number;\n  /**\n   * Relative order weight of this record group in the palette result list —\n   * lower renders higher. This is the SINGLE ordering axis the palette sorts\n   * every group (record groups AND static command-category groups) by.\n   *\n   * When omitted, record groups default to a weight ABOVE the static command\n   * groups, so live record matches surface FIRST while the user is searching —\n   * `searchResources` array position breaks ties among record groups. Static\n   * command categories sit on a higher (later) default band, sequenced among\n   * themselves by `[COMMAND_MENU].categoryOrder`. Set an explicit `order` to\n   * pin a record group anywhere in that merged list (e.g. a large value to push\n   * a low-signal resource below the command groups, or a negative value to pin\n   * it at the very top).\n   */\n  order?: number;\n  /**\n   * How each matched record renders in the palette:\n   * - `SUMMARY` (default) — the resource's summary VIEW (its summary card, no\n   *   action bar), via `ResourceSummaryDisplayer`. Reuses the SUMMARY-mode DTO\n   *   the `SEARCH` operation already returns, so there is no extra fetch. This\n   *   is the richer, default representation.\n   * - `LABEL` — a single-line resolved label (opt-out / compact fallback).\n   *\n   * `ID` is treated as `LABEL` here (there is no id-only palette row).\n   * Reuses {@link ForeignKeyDisplayMode} — the same LABEL-vs-SUMMARY vocabulary\n   * the foreign-key reference picker uses for its dropdown rows — rather than\n   * inventing a parallel command-menu-only enum.\n   */\n  resultDisplay?: ForeignKeyDisplayMode;\n  /**\n   * OPTIONAL extra literal match terms appended to every result of this\n   * resource for client-side fuzzy matching. NOT translated — the raw query is\n   * always kept as a keyword (so server hits never drop) and the framework also\n   * folds in the LOCALIZED \"search\" verb synonyms\n   * (`components.APPLICATION_LEVEL_COMMAND_MENU.keywordsSearch`) for the group.\n   * Reserve this field for app-specific jargon a localized label/synonym cannot\n   * cover.\n   */\n  searchKeywords?: string[];\n};\n/** @wildo_source:part:end saas.frontend.command-menu.search-resource */\n\n/** A quick action button entry. */\nexport type QuickActionItem = LauncherItemRef & {\n  displayPolicy?: QuickActionDisplayPolicy;\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n};\n\n/**\n * A keyboard shortcut binding to a navigation target (`LauncherItemRef`).\n *\n * `description` overrides the registry/help label. When omitted, the framework uses\n * `tResourceOperation(…, 'title')` for `RESOURCE_OPERATION` targets and the resolved\n * navigation `label` for all other kinds.\n */\nexport type HotkeyBinding = LauncherItemRef & {\n  shortcut: string;\n  scope?: HotkeyScope;\n  description?: string;\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n};\n\n/** A toolbar item. */\nexport type ToolbarItem = ToolbarItemRef & {\n  group?: string;\n  /** When true, only the icon is shown (label is hidden). */\n  iconOnly?: boolean;\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n};\n\n/** A control panel item. */\nexport type ControlPanelItem = LauncherItemRef & {\n  section?: string;\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n};\n\n/** A utility panel item (Gmail-style right-side panel). */\nexport interface UtilityPanelItem {\n  kind: LauncherItemTargetKind.CUSTOM_COMPONENT;\n  componentRef: string;\n  icon: string;\n  label: string;\n}\n\n/**\n * How a hosted component's TRIGGER renders inside its host surface.\n *\n * The same trigger serves two very different chrome shapes: a menubar's\n * trailing cluster is a row of small icon controls, while a sidebar rail (or a\n * wide top bar) can carry a full input-like control. Declaring the appearance\n * keeps that a per-PLACEMENT decision rather than a component-wide compromise —\n * this application hosts the identical command menu in both surfaces.\n */\nexport enum HostedTriggerAppearance {\n  /**\n   * Full input-like \"false button\": leading glyph, placeholder text and the\n   * shortcut hint. Honors `triggerWidth`. Default.\n   */\n  EXPANDED = 'expanded',\n  /**\n   * Square icon-only button sized to the chrome row — what belongs beside the\n   * notification bell and the avatar. `triggerWidth` is deliberately IGNORED\n   * here: a 240px icon button is dead space, not a wide control.\n   */\n  COMPACT = 'compact',\n}\n\n/**\n * @wildo_source:part:start saas.frontend.app-shell.hosted-components facet:layer:frontend facet:family:app-shell\n *\n * Hosts an app-level component (the Cmd+K command-menu trigger, a quick-action\n * button, the notification center, …) INSIDE the menubar via container\n * inversion. Import from `@wildo-ai/saas-frontend-lib`.\n *\n * You list these on the `[ApplicationLevelComponentType.MENUBAR]` config's\n * `hostedComponents` array (in `frontend/src/config/app-shell.config.ts`).\n * `componentType` is an `ApplicationLevelComponentType.*` member; `placement`\n * is a {@link HorizontalPlacement} (`START`/`MIDDLE`/`END`) selecting the\n * menubar zone; `breakpoint` restricts the component to one viewport\n * breakpoint. Render order follows array position in `hostedComponents`.\n *\n * The sidebar is the vertical mirror of this contract — see\n * {@link SidebarHostedComponent}. Both surfaces share ONE hosting pipeline, so\n * hosting the SAME component (e.g. the command menu) in both places yields two\n * triggers driving one shared dialog / one hotkey registration, never two.\n *\n * @example\n * // In frontend/src/config/app-shell.config.ts, on [MENUBAR]:\n * hostedComponents: [\n *   { componentType: ApplicationLevelComponentType.COMMAND_MENU,\n *     placement: HorizontalPlacement.START, triggerWidth: 240 },\n *   { componentType: ApplicationLevelComponentType.USER_DROPDOWN,\n *     placement: HorizontalPlacement.END },\n * ]\n */\nexport interface MenubarHostedComponent {\n  componentType: string;\n  /** Which menubar zone the component renders in. Defaults to `START`. */\n  placement?: HorizontalPlacement;\n  breakpoint?: ViewportBreakpoint;\n  /** Override the preset name used for component resolution. Defaults to `CorePresetNames.DEFAULT`. */\n  presetName?: string;\n  /**\n   * Per-placement width override for hosted components that render an\n   * input-like trigger (today: the command-menu \"false button\"). Accepts an\n   * explicit CSS length — a plain number is treated as pixels (`240` → 240px),\n   * or a CSS width string (`'240px'`, `'100%'`, `'16rem'`). Applied as an\n   * inline `style.width` because tailwind-merge cannot override the trigger's\n   * default width utility. Omit to use the component's built-in default width.\n   */\n  triggerWidth?: string | number;\n  /**\n   * How the trigger renders here — see {@link HostedTriggerAppearance}.\n   * Defaults to `EXPANDED`. A menubar's trailing cluster normally wants\n   * `COMPACT`, so the control is an icon button beside the bell and the avatar;\n   * a sidebar rail keeps the full input-like control. `triggerWidth` above is\n   * ignored under `COMPACT`.\n   */\n  triggerAppearance?: HostedTriggerAppearance;\n}\n\n/**\n * Hosts an app-level component INSIDE the sidebar (container inversion — the\n * vertical mirror of {@link MenubarHostedComponent}). Import from\n * `@wildo-ai/saas-frontend-lib`.\n *\n * You list these on the `[ApplicationLevelComponentType.SIDEBAR]` config's\n * `hostedComponents` array. Both surfaces share ONE hosting pipeline\n * (`resolveHostedComponents` + the shell-level interaction owner); the only\n * difference is the placement axis: the sidebar is a vertical column, so\n * `placement` is a {@link VerticalPlacement} (`TOP` renders above the nav,\n * `BOTTOM` below it) rather than the menubar's horizontal axis. `breakpoint`\n * restricts the component to a viewport breakpoint; render order follows array\n * position in `hostedComponents`.\n *\n * @example\n * // In frontend/src/config/app-shell.config.ts, on [SIDEBAR] — the same command\n * // menu ALSO placed in the sidebar, filling the rail width:\n * hostedComponents: [\n *   { componentType: ApplicationLevelComponentType.COMMAND_MENU,\n *     placement: VerticalPlacement.TOP, triggerWidth: '100%' },\n * ]\n */\nexport interface SidebarHostedComponent {\n  componentType: string;\n  /** Which end of the sidebar column the component renders at. Defaults to `TOP`. */\n  placement?: VerticalPlacement;\n  breakpoint?: ViewportBreakpoint;\n  /** Override the preset name used for component resolution. Defaults to `CorePresetNames.DEFAULT`. */\n  presetName?: string;\n  /**\n   * Per-placement width override for the hosted trigger (see\n   * {@link MenubarHostedComponent.triggerWidth} — number = px, or a CSS width\n   * string). A sidebar trigger commonly uses `'100%'` to fill the rail; the\n   * menubar copy is typically narrower.\n   */\n  triggerWidth?: string | number;\n  /**\n   * How the trigger renders here — see {@link HostedTriggerAppearance}.\n   * Defaults to `EXPANDED`. A menubar's trailing cluster normally wants\n   * `COMPACT`, so the control is an icon button beside the bell and the avatar;\n   * a sidebar rail keeps the full input-like control. `triggerWidth` above is\n   * ignored under `COMPACT`.\n   */\n  triggerAppearance?: HostedTriggerAppearance;\n}\n/** @wildo_source:part:end saas.frontend.app-shell.hosted-components */\n\n/** A menubar-specific launcher item (config-time declaration). */\nexport type MenubarLauncherItem = LauncherItemRef & {\n  group?: string;\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n};\n\n/**\n * Generic runtime availability contract for launcher declarations.\n *\n * This is intentionally distinct from `requiredFeatures` on resolved\n * view/resource targets:\n * - `runtimeAvailability` decides whether a launcher declaration should survive\n *   the app-shell filtering pass at all\n * - `requiredFeatures` stays the canonical plan/subscription gating mechanism\n *   once an item has already survived launcher filtering and is being resolved\n */\nexport interface LauncherRuntimeAvailabilityConfig {\n  requiredCapabilities?: string[];\n}\n\nexport const LauncherRuntimeAvailabilityConfigSchema = z.object({\n  requiredCapabilities: z.array(z.string()).optional(),\n});\n\n// ════════════════════════════════════════════════════════════════\n// Scope Condition Types (used by sidebar sections, evaluated in Macro B)\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Parameters passed to a `ScopeConditionFn` for evaluating section visibility.\n *\n * @see component-taxonomy-deep-review.md §3.5.3\n */\nexport interface ScopeConditionParams {\n  /** Current app scope values (workspace, project, environment, etc.). */\n  appScopeValues: Record<string, AppScopeValue>;\n  /** Currently active mode ref, or `null` if no mode system. */\n  activeMode: string | null;\n  /** All defined app modes (for inspecting mode metadata). */\n  availableModes: AppModeDefinition[];\n}\n\n/**\n * Predicate function that determines whether a sidebar section should be visible\n * based on the current scope and mode state.\n *\n * Returns `true` to show the section, `false` to hide it.\n * Called reactively whenever scope or mode changes.\n */\nexport type ScopeConditionFn = (params: ScopeConditionParams) => boolean;\n\n/**\n * Context provided to a `ResourceBrowser` section's `onInstanceClick` callback.\n */\nexport interface ResourceBrowserClickContext {\n  resourceType: string;\n  instanceId: string;\n  instanceData: Record<string, unknown>;\n}\n\n// ════════════════════════════════════════════════════════════════\n// AppMode Definition\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Defines an application mode (e.g., \"explorer\", \"search\", \"admin\").\n *\n * Modes filter which sidebar sections are visible. The `ACTIVITY_BAR`\n * renders available modes as selectable icons.\n *\n * @see component-taxonomy-deep-review.md §7.3\n */\nexport interface AppModeDefinition {\n  /** Unique reference for this mode. */\n  ref: string;\n  /** Display label (i18n ref). */\n  label: string;\n  /** Icon identifier for the activity bar. */\n  icon: string;\n  /** Whether this is the default mode when none is persisted. */\n  isDefault?: boolean;\n  /** Restrict mode visibility to specific user types. */\n  visibleToUserTypes?: string[];\n}\n\n// ════════════════════════════════════════════════════════════════\n// Sidebar Section Types — Discriminated Union on `contentKind`\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Base properties shared by all sidebar section types.\n * `ref` is `string`-typed — no framework enum, apps define their own refs.\n */\nexport interface SidebarSectionBase {\n  contentKind: SidebarSectionContentKind;\n  /** Section reference — app-defined, used for i18n and configuration matching. */\n  ref: string;\n  /** Display label (i18n ref). If omitted, section renders without a header. */\n  label?: string;\n  /** Icon for the section header. */\n  icon?: string;\n  /** Whether the section header (label + icon) is rendered. Defaults to `true`. */\n  showLabel?: boolean;\n  /** Whether the section can be collapsed by the user. */\n  collapsible?: boolean;\n  /** Whether the section starts collapsed. */\n  defaultCollapsed?: boolean;\n  /**\n   * Mode refs this section is visible in. If omitted, visible in all modes.\n   * String-based — validated at startup against `appModes[].ref`.\n   * Evaluated in Macro B (Step 6).\n   */\n  visibleInModes?: string[];\n  /**\n   * Function-based visibility condition for complex scope-dependent logic.\n   * Evaluated in Macro B (Step 6).\n   */\n  scopeCondition?: ScopeConditionFn;\n  /** Declarative runtime capability gating evaluated by the app-shell layer. */\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n}\n\n/**\n * Traditional navigation item list section.\n * Supports tree hierarchy, inline create, drag-reorder (via behavior).\n */\nexport interface SidebarSection_NavigationList extends SidebarSectionBase {\n  contentKind: SidebarSectionContentKind.NAVIGATION_LIST;\n  children: SidebarItem[];\n  behavior?: SidebarSectionBehavior;\n  /**\n   * Marks this section as the sidebar's PRIMARY navigation group — the app's\n   * top-level destinations (the \"Home group\"). Primary sections render at the\n   * top of the sidebar with no section header and never collapsible. When\n   * `SIDEBAR.homeDisplayMode` is `NAVIGATION_ITEM` (the default) the framework's\n   * Home row heads that same group, giving the Linear/Notion \"Inbox / My Issues\n   * right under Home\" shape; the other home modes surface home elsewhere and\n   * leave this group to the app's own destinations.\n   *\n   * This is a PLACEMENT/CHROME role, deliberately distinct from\n   * `SidebarSectionBehavior` (which describes where a section's ITEMS come\n   * from). Section ordering is engine policy and ignores declaration order for\n   * the special roles: primary section(s) first, then non-empty\n   * `SidebarSectionBehavior.FAVORITES` section(s), then the remaining sections\n   * in declared order. Modules can therefore contribute a primary section\n   * without the app config having to interleave it manually.\n   */\n  isPrimary?: boolean;\n  inlineCreate?: SidebarSectionInlineCreate;\n  inlineCreateResourceType?: string;\n  /** Field that receives the user's input during inline creation. Defaults to `'title'`. */\n  inlineCreateField?: string;\n  nested?: boolean;\n  maxNestingDepth?: number;\n}\n\n/**\n * Filterable resource instance list section.\n * Fetches data from a bound operation and displays resource instances.\n *\n * @see launcher-operation-binding-analysis.md §3.3.6\n */\nexport interface SidebarSection_ResourceBrowser extends SidebarSectionBase {\n  contentKind: SidebarSectionContentKind.RESOURCE_BROWSER;\n  /** Resource type to browse. */\n  resourceType: string;\n  /** Override the default LIST operation (optional — defaults to LIST). */\n  operation?: string;\n  /** Operation variant for filtered views. */\n  operationVariant?: string;\n  /**\n   * Operation used when the user clicks a listed instance.\n   * Defaults to READ when available; otherwise falls back to the bound operation.\n   */\n  navigateOperation?: string;\n  /** Variant for the click/navigation operation. */\n  navigateOperationVariant?: string;\n  /**\n   * Client-side filter predicate applied after fetching.\n   * Enables display restrictions (e.g., \"starred only\").\n   */\n  instanceFilter?: (instance: Record<string, unknown>) => boolean;\n  /**\n   * Custom click handler for resource instances.\n   * Default: navigate to instance via `NavigationUtils.resolveResourceUrl()`.\n   */\n  onInstanceClick?: (context: ResourceBrowserClickContext) => void;\n}\n\n/** Guidance/onboarding widget section. */\nexport interface SidebarSection_GuidanceWidget extends SidebarSectionBase {\n  contentKind: SidebarSectionContentKind.GUIDANCE_WIDGET;\n  /** Reference to a registered guidance component. */\n  guidanceRef: string;\n}\n\n/** Arbitrary custom component section. */\nexport interface SidebarSection_CustomComponent extends SidebarSectionBase {\n  contentKind: SidebarSectionContentKind.CUSTOM_COMPONENT;\n  /** Reference to a registered React component. */\n  componentRef: string;\n}\n\n/**\n * Discriminated union of all sidebar section types.\n * Narrow on `contentKind` to access type-specific properties.\n */\nexport type SidebarSection =\n  | SidebarSection_NavigationList\n  | SidebarSection_ResourceBrowser\n  | SidebarSection_GuidanceWidget\n  | SidebarSection_CustomComponent;\n\n// ════════════════════════════════════════════════════════════════\n// Zod Schemas\n// ════════════════════════════════════════════════════════════════\n\nexport const LauncherItemTargetKindSchema = z.enum(LauncherItemTargetKind);\nexport const EnginePageRefSchema = z.enum(EnginePageRef);\nexport const ActivityBarRenderingSchema = z.enum(ActivityBarRendering);\nexport const SidebarResponsivePolicySchema = z.enum(SidebarResponsivePolicy);\nexport const QuickActionButtonPlacementSchema = z.enum(QuickActionButtonPlacement);\nexport const SidebarSectionContentKindSchema = z.enum(SidebarSectionContentKind);\n\n/** Zod schema for `ResourceOperationItemRef`. */\nexport const ResourceOperationItemRefSchema = z.object({\n  kind: z.literal(LauncherItemTargetKind.RESOURCE_OPERATION),\n  resourceType: z.string(),\n  operation: z.string(),\n  operationVariant: z.string().optional(),\n});\n\n/** Zod schema for `ViewItemRef`. */\nexport const ViewItemRefSchema = z.object({\n  kind: z.literal(LauncherItemTargetKind.VIEW),\n  viewRef: z.string(),\n});\n\n/** Zod schema for `ResourceViewItemRef`. */\nexport const ResourceViewItemRefSchema = z.object({\n  kind: z.literal(LauncherItemTargetKind.RESOURCE_VIEW),\n  resourceType: z.string(),\n  viewRef: z.string(),\n});\n\n/** Zod schema for `EnginePageItemRef`. */\nexport const EnginePageItemRefSchema = z.object({\n  kind: z.literal(LauncherItemTargetKind.ENGINE_PAGE),\n  pageRef: EnginePageRefSchema,\n});\n\n/** Zod schema for `CustomComponentItemRef`. */\nexport const CustomComponentItemRefSchema = z.object({\n  kind: z.literal(LauncherItemTargetKind.CUSTOM_COMPONENT),\n  componentRef: z.string(),\n});\n\nexport const SettingsSectionItemRefSchema = z.object({\n  kind: z.literal(LauncherItemTargetKind.SETTINGS_SECTION),\n  sectionRef: z.string().optional(),\n});\n\n/**\n * Zod schema for `LauncherItemRef` — discriminated union on `kind`.\n * Validates config-time launcher item references.\n */\nexport const LauncherItemRefSchema = z.discriminatedUnion('kind', [\n  ResourceOperationItemRefSchema,\n  ViewItemRefSchema,\n  ResourceViewItemRefSchema,\n  EnginePageItemRefSchema,\n  CustomComponentItemRefSchema,\n  SettingsSectionItemRefSchema,\n]);\n\n/** Zod schema for `SidebarItem`. */\nexport const SidebarItemSchema: z.ZodType<SidebarItem> = z.lazy(() =>\n  LauncherItemRefSchema.and(z.object({\n    displayPolicy: z.enum(SidebarItemDisplayPolicy).optional(),\n    notificationBadgeRef: z.string().optional(),\n    children: z.array(SidebarItemSchema).optional(),\n    runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n  }))\n);\n\n/** Zod schema for `CommandMenuCommand`. */\nexport const CommandMenuCommandSchema = LauncherItemRefSchema.and(z.object({\n  category: z.string().optional(),\n  shortcut: z.string().optional(),\n  searchKeywords: z.array(z.string()).optional(),\n  displayPolicy: z.enum(CommandMenuDisplayPolicy).optional(),\n  runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n}));\n\n/**\n * @wildo_source:part:start saas.frontend.command-menu.search-resource facet:layer:frontend facet:family:app-shell\n *\n * Zod schema for `CommandMenuSearchResource` — validates each entry in the\n * `[COMMAND_MENU].searchResources` array.\n */\nexport const CommandMenuSearchResourceSchema: z.ZodType<CommandMenuSearchResource> = z.object({\n  resourceType: z.string(),\n  category: z.string().optional(),\n  maxResults: z.number().optional(),\n  order: z.number().optional(),\n  resultDisplay: z.enum([\n    ForeignKeyDisplayMode.ID,\n    ForeignKeyDisplayMode.LABEL,\n    ForeignKeyDisplayMode.SUMMARY,\n  ]).optional(),\n  searchKeywords: z.array(z.string()).optional(),\n});\n/** @wildo_source:part:end saas.frontend.command-menu.search-resource */\n\n/** Zod schema for `QuickActionItem`. */\nexport const QuickActionItemSchema = LauncherItemRefSchema.and(z.object({\n  displayPolicy: z.enum(QuickActionDisplayPolicy).optional(),\n  runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n}));\n\n/** Zod schema for `HotkeyBinding`. */\nexport const HotkeyBindingSchema = LauncherItemRefSchema.and(z.object({\n  shortcut: z.string(),\n  scope: z.enum(HotkeyScope).optional(),\n  description: z.string().optional(),\n  runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n}));\n\n/** Zod schema for `ToolbarItemRef`. */\nexport const ToolbarItemRefSchema = z.discriminatedUnion('kind', [\n  ResourceOperationItemRefSchema,\n  ViewItemRefSchema,\n  ResourceViewItemRefSchema,\n  EnginePageItemRefSchema,\n]);\n\n/** Zod schema for `ToolbarItem`. */\nexport const ToolbarItemSchema = ToolbarItemRefSchema.and(z.object({\n  group: z.string().optional(),\n  iconOnly: z.boolean().optional(),\n  runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n}));\n\n/** Zod schema for `ControlPanelItem`. */\nexport const ControlPanelItemSchema = LauncherItemRefSchema.and(z.object({\n  section: z.string().optional(),\n  runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n}));\n\n/** Zod schema for `UtilityPanelItem`. */\nexport const UtilityPanelItemSchema = z.object({\n  kind: z.literal(LauncherItemTargetKind.CUSTOM_COMPONENT),\n  componentRef: z.string(),\n  icon: z.string(),\n  label: z.string(),\n});\n\n/**\n * @wildo_source:part:start saas.frontend.app-shell.hosted-components facet:layer:frontend facet:family:app-shell\n *\n * Zod schema for `MenubarHostedComponent` — validates each entry in the\n * `[MENUBAR].hostedComponents` array. `placement` determines which zone\n * (START/MIDDLE/END) the component renders in; `breakpoint` restricts the\n * component to a specific viewport breakpoint. Render order follows array\n * position in `hostedComponents`.\n */\nexport const MenubarHostedComponentSchema = z.object({\n  componentType: z.string(),\n  placement: z.enum(HorizontalPlacement).optional(),\n  breakpoint: z.enum(ViewportBreakpoint).optional(),\n  presetName: z.string().optional(),\n  triggerWidth: z.union([z.string(), z.number()]).optional(),\n  triggerAppearance: z.enum(HostedTriggerAppearance).optional(),\n});\n\n/**\n * Zod schema for `SidebarHostedComponent` — declares a component hosted within\n * the sidebar (the vertical mirror of `MenubarHostedComponentSchema`).\n * `placement` selects which end of the sidebar column the component renders at\n * (`TOP`/`BOTTOM`); `breakpoint` restricts it to a viewport breakpoint. Render\n * order follows array position in `hostedComponents`.\n */\nexport const SidebarHostedComponentSchema = z.object({\n  componentType: z.string(),\n  placement: z.enum(VerticalPlacement).optional(),\n  breakpoint: z.enum(ViewportBreakpoint).optional(),\n  presetName: z.string().optional(),\n  triggerWidth: z.union([z.string(), z.number()]).optional(),\n  triggerAppearance: z.enum(HostedTriggerAppearance).optional(),\n});\n/** @wildo_source:part:end saas.frontend.app-shell.hosted-components */\n\n/** Zod schema for `MenubarLauncherItem`. */\nexport const MenubarLauncherItemSchema = LauncherItemRefSchema.and(z.object({\n  group: z.string().optional(),\n  runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n}));\n\n// ── Sidebar Section Schemas (discriminated union on contentKind) ──\n\nconst SidebarSectionBaseSchema = z.object({\n  ref: z.string(),\n  label: z.string().optional(),\n  icon: z.string().optional(),\n  showLabel: z.boolean().optional(),\n  collapsible: z.boolean().optional(),\n  defaultCollapsed: z.boolean().optional(),\n  visibleInModes: z.array(z.string()).optional(),\n  runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n});\n\nexport const SidebarSection_NavigationListSchema = SidebarSectionBaseSchema.extend({\n  contentKind: z.literal(SidebarSectionContentKind.NAVIGATION_LIST),\n  children: z.array(SidebarItemSchema),\n  behavior: z.enum(SidebarSectionBehavior).optional(),\n  isPrimary: z.boolean().optional(),\n  inlineCreate: z.enum(SidebarSectionInlineCreate).optional(),\n  inlineCreateResourceType: z.string().optional(),\n  inlineCreateField: z.string().optional(),\n  nested: z.boolean().optional(),\n  maxNestingDepth: z.number().optional(),\n});\n\nexport const SidebarSection_ResourceBrowserSchema = SidebarSectionBaseSchema.extend({\n  contentKind: z.literal(SidebarSectionContentKind.RESOURCE_BROWSER),\n  resourceType: z.string(),\n  operation: z.string().optional(),\n  operationVariant: z.string().optional(),\n  navigateOperation: z.string().optional(),\n  navigateOperationVariant: z.string().optional(),\n});\n\nexport const SidebarSection_GuidanceWidgetSchema = SidebarSectionBaseSchema.extend({\n  contentKind: z.literal(SidebarSectionContentKind.GUIDANCE_WIDGET),\n  guidanceRef: z.string(),\n});\n\nexport const SidebarSection_CustomComponentSchema = SidebarSectionBaseSchema.extend({\n  contentKind: z.literal(SidebarSectionContentKind.CUSTOM_COMPONENT),\n  componentRef: z.string(),\n});\n\n/**\n * Zod schema for `SidebarSection` — discriminated union on `contentKind`.\n *\n * Note: `scopeCondition` (on `SidebarSectionBase`), `instanceFilter`, and\n * `onInstanceClick` (on `SidebarSection_ResourceBrowser`) are function types\n * that cannot be validated by Zod. They are typed on the TypeScript interfaces\n * but excluded from the Zod schema (runtime code handles them directly).\n */\nexport const SidebarSectionSchema = z.discriminatedUnion('contentKind', [\n  SidebarSection_NavigationListSchema,\n  SidebarSection_ResourceBrowserSchema,\n  SidebarSection_GuidanceWidgetSchema,\n  SidebarSection_CustomComponentSchema,\n]);\n\n/** Zod schema for `AppModeDefinition`. */\nexport const AppModeDefinitionSchema = z.object({\n  ref: z.string(),\n  label: z.string(),\n  icon: z.string(),\n  isDefault: z.boolean().optional(),\n  visibleToUserTypes: z.array(z.string()).optional(),\n});\n"]}
+{"version":3,"file":"launcher-items.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/config/launcher-items.frontend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Launcher Item Types & Schemas\n *\n * Per-launcher content declaration model. Each launcher (sidebar, command menu,\n * quick action button, etc.) declares its own content using these types.\n *\n * `LauncherItemTargetKind` is the discriminant for `LauncherItemRef` — it tells\n * the resolution layer what kind of target a launcher item points to.\n *\n * `SidebarSectionContentKind` is the discriminant for sidebar section content —\n * determines whether a section renders a navigation list, a resource browser,\n * a guidance widget, or a custom component.\n *\n * These types are config-time types. The resolution layer (Step 2) transforms\n * them into runtime `ResolvedNavigationItem` instances.\n *\n * @see launcher-operation-binding-analysis.md §3.1.1, §3.2\n * @see component-taxonomy-deep-review.md §3.5\n */\n\nimport { z } from 'zod';\nimport {\n  SidebarItemDisplayPolicy,\n  CommandMenuDisplayPolicy,\n  QuickActionDisplayPolicy,\n  HotkeyScope,\n} from './app-level-components.frontend.schemas';\nimport { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport { ViewportBreakpoint, ForeignKeyDisplayMode } from '@wildo-ai/zod-decorators';\nimport { CommonRoutePaths } from '~wildo-frontend-lib/core/runtime/routes.frontend.definitions';\nimport { StandardIconReference } from '~wildo-frontend-lib/core/icons/icon-registry.frontend.schemas';\nimport type { AppScopeValue } from '~wildo-frontend-lib/core/scope/scope.frontend.schemas';\n\n// ════════════════════════════════════════════════════════════════\n// Launcher Item Target Kind\n// ════════════════════════════════════════════════════════════════\n\n/**\n * What kind of target a launcher item points to.\n *\n * This is a config-time concept — the resolution layer maps each kind to a\n * navigation action. Different from `NavigationContentType` which is a runtime\n * concept for zone content rendering. Both have `RESOURCE_OPERATION` but serve\n * different axes: `LauncherItemTargetKind` = what a launcher item targets,\n * `NavigationContentType` = what renders in a navigation zone.\n *\n * @see launcher-operation-binding-analysis.md §3.1.1\n */\nexport enum LauncherItemTargetKind {\n  /** Navigate to a resource operation (list, create, read, etc.). */\n  RESOURCE_OPERATION = 'resource_operation',\n  /** Navigate to an application-scoped special view. */\n  VIEW = 'view',\n  /** Navigate to a resource-scoped special view. */\n  RESOURCE_VIEW = 'resource_view',\n  /** Navigate to a framework-provided page (home, security settings, etc.). */\n  ENGINE_PAGE = 'engine_page',\n  /** Render a custom registered React component. */\n  CUSTOM_COMPONENT = 'custom_component',\n  /** Open the unified Settings Hub (overlay), optionally at a specific section. */\n  SETTINGS_SECTION = 'settings_section',\n}\n\n// ════════════════════════════════════════════════════════════════\n// Engine Page Ref (closed enum)\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Framework-provided navigable pages.\n *\n * Closed enum — only framework pages belong here. Auth routes (login, register, etc.)\n * are NOT engine pages. Dev routes (devTest, devThemeGallery) are excluded.\n *\n * The resolution layer maps these to `CommonRoutePaths` in `routes.frontend.definitions.ts`.\n *\n * @see app-shell-implementation-plan.md Step 0 item 1\n */\nexport enum EnginePageRef {\n  /** Home page — maps to `CommonRoutePaths.home` (`/`) */\n  HOME = 'home',\n  // NOTE: security settings is no longer a standalone engine page — it is a\n  // section panel inside the unified Settings Hub (`/settings/security` opens the\n  // hub at its Security section via `SETTINGS_SECTION` / `useSettingsHubOverlaySync`).\n}\n\n/**\n * Per-engine-page metadata: route, i18n label key, standard icon.\n *\n * Single source of truth — consumed by:\n * - `launcher-resolution.ts` (route + label + icon for resolved engine pages)\n * - `verify-launcher-content.ts` (pageRef existence check)\n * - `useNavigationBehaviors.ts` (home route lookup)\n * - companion `planEnginePageUnits()` (label-key generation)\n *\n * Adding a new engine page = adding the `EnginePageRef` enum entry above\n * + one record entry here. No other touch-up needed.\n */\nexport interface EnginePageMetadata {\n  /** Route path under the app. */\n  route: string;\n  /**\n   * i18n key used to resolve the page's display label at\n   * `engine.pages.<key>.title` (the companion's `planEnginePageUnits()`\n   * emits matching keys for label generation).\n   */\n  i18nKey: string;\n  /** Standard icon to render for navigation entries pointing at this page. */\n  icon: StandardIconReference;\n}\n\nexport const ENGINE_PAGE_METADATA: Record<EnginePageRef, EnginePageMetadata> = {\n  [EnginePageRef.HOME]: {\n    route: CommonRoutePaths.home,\n    i18nKey: 'engine.pages.home',\n    icon: StandardIconReference.HOME,\n  },\n};\n\n// ════════════════════════════════════════════════════════════════\n// Activity Bar & Sidebar Enums\n// ════════════════════════════════════════════════════════════════\n\n/**\n * How the Activity Bar renders at different breakpoints.\n *\n * The activity bar is the mode selector — it shows available `AppMode`s and\n * lets the user switch between them. Its rendering varies by breakpoint.\n *\n * @see component-taxonomy-deep-review.md §3.5.2\n */\nexport enum ActivityBarRendering {\n  /** Vertical icon column on the left side (desktop default). */\n  VERTICAL_RAIL = 'vertical_rail',\n  /** Horizontal icon row at the top (alternative desktop layout). */\n  HORIZONTAL_BAR = 'horizontal_bar',\n  /** Persistent bottom tab bar (mobile). */\n  BOTTOM_TAB_BAR = 'bottom_tab_bar',\n}\n\n/**\n * Sidebar responsive behavior on mobile breakpoints.\n *\n * Controls how the sidebar adapts when the viewport shrinks below\n * its responsive breakpoint.\n *\n * @see component-taxonomy-deep-review.md §7.1\n */\nexport enum SidebarResponsivePolicy {\n  /** Sidebar becomes a burger menu / drawer overlay on mobile. */\n  BURGER = 'BURGER',\n  /** Sidebar stays visible but auto-expands on desktop. */\n  DRAWER = 'DRAWER',\n}\n\n/**\n * How the sidebar surfaces the application's HOME destination.\n *\n * Three mutually-exclusive presentations of ONE concept — an app picks the one\n * matching its shell identity, and the framework never renders two home\n * affordances at once.\n */\nexport enum SidebarHomeDisplayMode {\n  /**\n   * No home affordance in the sidebar at all. For apps whose home is reached\n   * elsewhere (a menubar brand, a logo in the shell header) or that have no\n   * meaningful home surface.\n   */\n  HIDDEN = 'hidden',\n  /**\n   * The application's brand header: its SYMBOL brand asset plus the application\n   * display name, PINNED at the very top of the sidebar — above the scroll\n   * region and therefore above any hosted component (e.g. the command-menu\n   * search trigger). Clicking it navigates home. This is the Slack / Linear /\n   * Notion shell convention: the product identity doubles as the home button,\n   * so no separate \"Home\" row is needed. Collapsed to the icon rail it shows\n   * the symbol alone.\n   *\n   * The logo resolves from the app's `brandAssets` (see `RuntimeBrandAsset` /\n   * `resolveBrandAsset` in `@wildo-ai/saas-models`) for the active light/dark\n   * theme; an app with no generated brand shows the name alone (and the\n   * framework home icon on the collapsed rail).\n   */\n  BRAND_HEADER = 'brand_header',\n  /**\n   * A \"Home\" navigation ROW at the top of the primary navigation group, beside\n   * the app's other top-level destinations. The framework default — it assumes\n   * nothing about brand assets.\n   */\n  NAVIGATION_ITEM = 'navigation_item',\n}\n\n/** Sidebar section behavior mode — where a section's ITEMS come from. */\nexport enum SidebarSectionBehavior {\n  /** Items are exactly the declared `children`. */\n  STATIC = 'static',\n  /** Items are produced at runtime by the section's content kind. */\n  DYNAMIC = 'dynamic',\n  /**\n   * Items are the USER'S FAVORITED navigation items: the engine populates the\n   * section from starred items across the other navigation-list sections\n   * (persisted machine-locally under `LOCAL_STORAGE_KEYS.SIDEBAR_FAVORITES`),\n   * REPLACING any declared `children` — author none. Declaring a FAVORITES\n   * section is what enables the hover-star affordance on sidebar rows; the\n   * section is hidden entirely while no favorites exist, and the engine\n   * ordering policy places it right after the primary group. Declare at most\n   * ONE favorites section: several would render the same favorited copies\n   * (same ids) in each, and the active-row election would highlight one row\n   * per duplicate id.\n   */\n  FAVORITES = 'favorites',\n}\n\n/** Sidebar section inline create mode. */\nexport enum SidebarSectionInlineCreate {\n  NONE = 'none',\n  INPUT = 'input',\n  DIALOG = 'dialog',\n}\n\n/**\n * Quick Action Button placement mode.\n *\n * Replaces the literal string `\"FLOATING\"` patterns in existing schemas.\n * After container inversion (Step 4), the only placement is `FLOATING` or\n * `CONTAINED` (hosted by menubar/sidebar via `hostedComponents`).\n */\nexport enum QuickActionButtonPlacement {\n  /** Floating action button overlaying the content area. */\n  FLOATING = 'FLOATING',\n  /** Contained within a parent component (menubar or sidebar). */\n  CONTAINED = 'CONTAINED',\n}\n\n// ════════════════════════════════════════════════════════════════\n// Sidebar Section Content Kind\n// ════════════════════════════════════════════════════════════════\n\n/**\n * What kind of content a sidebar section renders.\n *\n * This is the discriminant for the `SidebarSection` discriminated union.\n * Each content kind has its own set of properties and rendering behavior.\n *\n * @see launcher-operation-binding-analysis.md §3.3.1\n */\nexport enum SidebarSectionContentKind {\n  /** Traditional navigation item list (tree, collapsible, inline create). */\n  NAVIGATION_LIST = 'navigation_list',\n  /** Filterable resource instance list — fetches from a bound operation. */\n  RESOURCE_BROWSER = 'resource_browser',\n  /** Guidance/onboarding widget — renders a registered guidance component. */\n  GUIDANCE_WIDGET = 'guidance_widget',\n  /** Arbitrary registered React component. */\n  CUSTOM_COMPONENT = 'custom_component',\n}\n\n// ════════════════════════════════════════════════════════════════\n// LauncherItemRef — Discriminated Union\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Points to a resource operation (list, create, read, etc.).\n * The resolution layer resolves this via the resource registry.\n */\nexport interface ResourceOperationItemRef {\n  kind: LauncherItemTargetKind.RESOURCE_OPERATION;\n  resourceType: string;\n  operation: string;\n  operationVariant?: string;\n}\n\n/** Points to an application-scoped special view. */\nexport interface ViewItemRef {\n  kind: LauncherItemTargetKind.VIEW;\n  viewRef: string;\n}\n\n/** Points to a resource-scoped special view. */\nexport interface ResourceViewItemRef {\n  kind: LauncherItemTargetKind.RESOURCE_VIEW;\n  resourceType: string;\n  viewRef: string;\n}\n\n/** Points to a framework page (home, security settings). */\nexport interface EnginePageItemRef {\n  kind: LauncherItemTargetKind.ENGINE_PAGE;\n  pageRef: EnginePageRef;\n}\n\n/** Points to a registered custom React component. */\nexport interface CustomComponentItemRef {\n  kind: LauncherItemTargetKind.CUSTOM_COMPONENT;\n  componentRef: string;\n}\n\n/**\n * Opens the unified Settings Hub (overlay), optionally pre-selecting a section.\n * Resolves to a `/settings` / `/settings/:sectionRef` URL navigation — the hub\n * is URL-driven (`useSettingsHubRouterSync` reconstructs it), so every settings\n * entry point converges on one destination.\n */\nexport interface SettingsSectionItemRef {\n  kind: LauncherItemTargetKind.SETTINGS_SECTION;\n  /** Section to pre-open; omit to open the hub's default section. */\n  sectionRef?: string;\n}\n\n/**\n * A launcher item reference — identifies WHAT a launcher item targets.\n * Discriminated on `kind`. The resolution layer dispatches on this to\n * produce a `ResolvedNavigationItem`.\n *\n * @see launcher-operation-binding-analysis.md §3.2\n */\nexport type LauncherItemRef =\n  | ResourceOperationItemRef\n  | ViewItemRef\n  | ResourceViewItemRef\n  | EnginePageItemRef\n  | CustomComponentItemRef\n  | SettingsSectionItemRef;\n\n/**\n * Toolbar items are navigation-only launcher refs.\n * Custom-component materialization belongs to other app-level surfaces and is\n * intentionally excluded from the global app-level toolbar contract.\n */\nexport type ToolbarItemRef =\n  | ResourceOperationItemRef\n  | ViewItemRef\n  | ResourceViewItemRef\n  | EnginePageItemRef;\n\n// ════════════════════════════════════════════════════════════════\n// Per-Launcher Item Types\n// ════════════════════════════════════════════════════════════════\n\n/**\n * A sidebar navigation item — extends `LauncherItemRef` with sidebar-specific\n * display properties. Supports all launcher target kinds as targets.\n */\nexport type SidebarItem = LauncherItemRef & {\n  displayPolicy?: SidebarItemDisplayPolicy;\n  /**\n   * Typed reference to a registered `NotificationBadgeDefinition` — its badge KEY,\n   * `<scope>:<identifier>`, built by `buildNotificationBadgeKey` /\n   * `notificationBadgeIdentityKey` from `@wildo-ai/saas-models`.\n   *\n   * The key, not the bare `identifier`: a definition is `(scope, identifier)`, so an identifier\n   * alone names a definition only while no second scope declares the same one. Matching on it made\n   * the second definition unreachable and gave it the first's count.\n   *\n   * The resolved definition supplies the display mode / tone / pulse, and the live count comes from\n   * `useNotificationBadges`, which indexes by the same key. Reported by `verify-launcher-content`\n   * when it resolves to nothing.\n   */\n  notificationBadgeRef?: string;\n  children?: SidebarItem[];\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n};\n\n/** A command menu entry. */\nexport type CommandMenuCommand = LauncherItemRef & {\n  category?: string;\n  shortcut?: string;\n  /**\n   * OPTIONAL extra literal match terms, appended to the localized keyword set\n   * the palette already resolves for this command. These literals are NOT\n   * translated — reserve them for genuinely app-specific jargon that no\n   * localized label or operation-verb synonym covers (e.g. an internal codename\n   * like `\"boards\"` for a Todo-Lists list command).\n   *\n   * You do NOT need to author generic action verbs here: for a\n   * `RESOURCE_OPERATION` command the framework already folds in the LOCALIZED\n   * operation-verb synonyms (`components.APPLICATION_LEVEL_COMMAND_MENU.keywords*`,\n   * generated + translated by the labelling pipeline) keyed off the command's\n   * core operation semantic, and the record/command noun is covered by the\n   * command's already-localized label. So a French user finds \"Create Todo\" by\n   * typing \"nouveau\"/\"créer\" without any literal being authored here.\n   */\n  searchKeywords?: string[];\n  displayPolicy?: CommandMenuDisplayPolicy;\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n};\n\n/**\n * @wildo_source:part:start saas.frontend.command-menu.search-resource facet:layer:frontend facet:family:app-shell\n *\n * Declares one resource whose `SEARCH` operation feeds the command menu's\n * **omnibox** record-search layer. Import from `@wildo-ai/saas-frontend-lib`.\n *\n * You list these on the `[ApplicationLevelComponentType.COMMAND_MENU]`\n * config's `searchResources` array (in `frontend/src/config/app-shell.config.ts`);\n * they take effect **only** when that config also sets\n * `policy: CommandBarPolicy.OMNIBOX`. Each entry opts one resource into live,\n * debounced record search inside the Cmd+K palette.\n *\n * Unlike a {@link CommandMenuCommand} — a static, declarative navigation target\n * — this drives a live, debounced query (≥2 chars, 300ms) against the\n * resource's addressable `SEARCH` operation (falling back to `LIST`). Results\n * are labelled with the resource's own frontend label config and, on\n * selection, navigate to the record's addressable `READ` view. Name the\n * searchable set explicitly so the palette never fires queries against\n * resources the app did not opt in.\n *\n * @example\n * // In frontend/src/config/app-shell.config.ts, on [COMMAND_MENU]:\n * searchResources: [\n *   { resourceType: 'todos', category: 'todos', maxResults: 5 },\n *   { resourceType: 'tasks', category: 'tasks', maxResults: 5 },\n * ]\n */\nexport type CommandMenuSearchResource = {\n  /** Resource type whose SEARCH operation is queried (e.g. `'todos'`). */\n  resourceType: string;\n  /**\n   * Group/category ref the results are placed under in the palette. Defaults\n   * to the `resourceType` (humanized) when omitted. Resolved through the same\n   * i18n category-label path as static command categories.\n   */\n  category?: string;\n  /** Max results fetched per resource per keystroke. Defaults to 5. */\n  maxResults?: number;\n  /**\n   * Relative order weight of this record group in the palette result list —\n   * lower renders higher. This is the SINGLE ordering axis the palette sorts\n   * every group (record groups AND static command-category groups) by.\n   *\n   * When omitted, record groups default to a weight ABOVE the static command\n   * groups, so live record matches surface FIRST while the user is searching —\n   * `searchResources` array position breaks ties among record groups. Static\n   * command categories sit on a higher (later) default band, sequenced among\n   * themselves by `[COMMAND_MENU].categoryOrder`. Set an explicit `order` to\n   * pin a record group anywhere in that merged list (e.g. a large value to push\n   * a low-signal resource below the command groups, or a negative value to pin\n   * it at the very top).\n   */\n  order?: number;\n  /**\n   * How each matched record renders in the palette:\n   * - `SUMMARY` (default) — the resource's summary VIEW (its summary card, no\n   *   action bar), via `ResourceSummaryDisplayer`. Reuses the SUMMARY-mode DTO\n   *   the `SEARCH` operation already returns, so there is no extra fetch. This\n   *   is the richer, default representation.\n   * - `LABEL` — a single-line resolved label (opt-out / compact fallback).\n   *\n   * `ID` is treated as `LABEL` here (there is no id-only palette row).\n   * Reuses {@link ForeignKeyDisplayMode} — the same LABEL-vs-SUMMARY vocabulary\n   * the foreign-key reference picker uses for its dropdown rows — rather than\n   * inventing a parallel command-menu-only enum.\n   */\n  resultDisplay?: ForeignKeyDisplayMode;\n  /**\n   * OPTIONAL extra literal match terms appended to every result of this\n   * resource for client-side fuzzy matching. NOT translated — the raw query is\n   * always kept as a keyword (so server hits never drop) and the framework also\n   * folds in the LOCALIZED \"search\" verb synonyms\n   * (`components.APPLICATION_LEVEL_COMMAND_MENU.keywordsSearch`) for the group.\n   * Reserve this field for app-specific jargon a localized label/synonym cannot\n   * cover.\n   */\n  searchKeywords?: string[];\n};\n/** @wildo_source:part:end saas.frontend.command-menu.search-resource */\n\n/** A quick action button entry. */\nexport type QuickActionItem = LauncherItemRef & {\n  displayPolicy?: QuickActionDisplayPolicy;\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n};\n\n/**\n * A keyboard shortcut binding to a navigation target (`LauncherItemRef`).\n *\n * `description` overrides the registry/help label. When omitted, the framework uses\n * `tResourceOperation(…, 'title')` for `RESOURCE_OPERATION` targets and the resolved\n * navigation `label` for all other kinds.\n */\nexport type HotkeyBinding = LauncherItemRef & {\n  shortcut: string;\n  scope?: HotkeyScope;\n  description?: string;\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n};\n\n/** A toolbar item. */\nexport type ToolbarItem = ToolbarItemRef & {\n  group?: string;\n  /** When true, only the icon is shown (label is hidden). */\n  iconOnly?: boolean;\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n};\n\n/** A control panel item. */\nexport type ControlPanelItem = LauncherItemRef & {\n  section?: string;\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n};\n\n/**\n * A utility panel item (Gmail-style right-side panel).\n *\n * Two target kinds, because the panel hosts two genuinely different things and collapsing them\n * would have meant an untyped props bag (#504):\n *\n * - `CUSTOM_COMPONENT` names a component the ENGINE ships, rendered with no arguments. The registry\n *   is typed on `FrontendComponentType` from `register` through `resolve`, so an application cannot\n *   name its own here however the free-string ref reads — that contract gap is filed separately.\n * - `VIEW` names an application-scoped view by ref, rendered INLINE in the panel. The panel does not\n *   navigate, so this is the same target a launcher item names and a different verb applied to it:\n *   the kind says WHAT, the host decides HOW.\n *\n * `VIEW` exists because the content applications actually want beside the workspace is their own —\n * an actor flow, a report — and such a surface needs to know WHICH instance it is showing. A\n * component rendered with no arguments cannot be told, which is why a ref rather than a props object\n * is the right shape: it is the one parameter that identifies an instance, and it is typed.\n */\nexport type UtilityPanelItem =\n  | {\n      kind: LauncherItemTargetKind.CUSTOM_COMPONENT;\n      componentRef: string;\n      icon: string;\n      label: string;\n    }\n  | {\n      kind: LauncherItemTargetKind.VIEW;\n      /** The `ref` of an application-scoped view definition — today, a `FlowsActorsViewDefinition`. */\n      viewRef: string;\n      icon: string;\n      label: string;\n    };\n\n/**\n * How a hosted component's TRIGGER renders inside its host surface.\n *\n * The same trigger serves two very different chrome shapes: a menubar's\n * trailing cluster is a row of small icon controls, while a sidebar rail (or a\n * wide top bar) can carry a full input-like control. Declaring the appearance\n * keeps that a per-PLACEMENT decision rather than a component-wide compromise —\n * this application hosts the identical command menu in both surfaces.\n */\nexport enum HostedTriggerAppearance {\n  /**\n   * Full input-like \"false button\": leading glyph, placeholder text and the\n   * shortcut hint. Honors `triggerWidth`. Default.\n   */\n  EXPANDED = 'expanded',\n  /**\n   * Square icon-only button sized to the chrome row — what belongs beside the\n   * notification bell and the avatar. `triggerWidth` is deliberately IGNORED\n   * here: a 240px icon button is dead space, not a wide control.\n   */\n  COMPACT = 'compact',\n}\n\n/**\n * @wildo_source:part:start saas.frontend.app-shell.hosted-components facet:layer:frontend facet:family:app-shell\n *\n * Hosts an app-level component (the Cmd+K command-menu trigger, a quick-action\n * button, the notification center, …) INSIDE the menubar via container\n * inversion. Import from `@wildo-ai/saas-frontend-lib`.\n *\n * You list these on the `[ApplicationLevelComponentType.MENUBAR]` config's\n * `hostedComponents` array (in `frontend/src/config/app-shell.config.ts`).\n * `componentType` is an `ApplicationLevelComponentType.*` member; `placement`\n * is a {@link HorizontalPlacement} (`START`/`MIDDLE`/`END`) selecting the\n * menubar zone; `breakpoint` restricts the component to one viewport\n * breakpoint. Render order follows array position in `hostedComponents`.\n *\n * The sidebar is the vertical mirror of this contract — see\n * {@link SidebarHostedComponent}. Both surfaces share ONE hosting pipeline, so\n * hosting the SAME component (e.g. the command menu) in both places yields two\n * triggers driving one shared dialog / one hotkey registration, never two.\n *\n * @example\n * // In frontend/src/config/app-shell.config.ts, on [MENUBAR]:\n * hostedComponents: [\n *   { componentType: ApplicationLevelComponentType.COMMAND_MENU,\n *     placement: HorizontalPlacement.START, triggerWidth: 240 },\n *   { componentType: ApplicationLevelComponentType.USER_DROPDOWN,\n *     placement: HorizontalPlacement.END },\n * ]\n */\nexport interface MenubarHostedComponent {\n  componentType: string;\n  /** Which menubar zone the component renders in. Defaults to `START`. */\n  placement?: HorizontalPlacement;\n  breakpoint?: ViewportBreakpoint;\n  /** Override the preset name used for component resolution. Defaults to `CorePresetNames.DEFAULT`. */\n  presetName?: string;\n  /**\n   * Per-placement width override for hosted components that render an\n   * input-like trigger (today: the command-menu \"false button\"). Accepts an\n   * explicit CSS length — a plain number is treated as pixels (`240` → 240px),\n   * or a CSS width string (`'240px'`, `'100%'`, `'16rem'`). Applied as an\n   * inline `style.width` because tailwind-merge cannot override the trigger's\n   * default width utility. Omit to use the component's built-in default width.\n   */\n  triggerWidth?: string | number;\n  /**\n   * How the trigger renders here — see {@link HostedTriggerAppearance}.\n   * Defaults to `EXPANDED`. A menubar's trailing cluster normally wants\n   * `COMPACT`, so the control is an icon button beside the bell and the avatar;\n   * a sidebar rail keeps the full input-like control. `triggerWidth` above is\n   * ignored under `COMPACT`.\n   */\n  triggerAppearance?: HostedTriggerAppearance;\n}\n\n/**\n * Hosts an app-level component INSIDE the sidebar (container inversion — the\n * vertical mirror of {@link MenubarHostedComponent}). Import from\n * `@wildo-ai/saas-frontend-lib`.\n *\n * You list these on the `[ApplicationLevelComponentType.SIDEBAR]` config's\n * `hostedComponents` array. Both surfaces share ONE hosting pipeline\n * (`resolveHostedComponents` + the shell-level interaction owner); the only\n * difference is the placement axis: the sidebar is a vertical column, so\n * `placement` is a {@link VerticalPlacement} (`TOP` renders above the nav,\n * `BOTTOM` below it) rather than the menubar's horizontal axis. `breakpoint`\n * restricts the component to a viewport breakpoint; render order follows array\n * position in `hostedComponents`.\n *\n * @example\n * // In frontend/src/config/app-shell.config.ts, on [SIDEBAR] — the same command\n * // menu ALSO placed in the sidebar, filling the rail width:\n * hostedComponents: [\n *   { componentType: ApplicationLevelComponentType.COMMAND_MENU,\n *     placement: VerticalPlacement.TOP, triggerWidth: '100%' },\n * ]\n */\nexport interface SidebarHostedComponent {\n  componentType: string;\n  /** Which end of the sidebar column the component renders at. Defaults to `TOP`. */\n  placement?: VerticalPlacement;\n  breakpoint?: ViewportBreakpoint;\n  /** Override the preset name used for component resolution. Defaults to `CorePresetNames.DEFAULT`. */\n  presetName?: string;\n  /**\n   * Per-placement width override for the hosted trigger (see\n   * {@link MenubarHostedComponent.triggerWidth} — number = px, or a CSS width\n   * string). A sidebar trigger commonly uses `'100%'` to fill the rail; the\n   * menubar copy is typically narrower.\n   */\n  triggerWidth?: string | number;\n  /**\n   * How the trigger renders here — see {@link HostedTriggerAppearance}.\n   * Defaults to `EXPANDED`. A menubar's trailing cluster normally wants\n   * `COMPACT`, so the control is an icon button beside the bell and the avatar;\n   * a sidebar rail keeps the full input-like control. `triggerWidth` above is\n   * ignored under `COMPACT`.\n   */\n  triggerAppearance?: HostedTriggerAppearance;\n}\n/** @wildo_source:part:end saas.frontend.app-shell.hosted-components */\n\n/** A menubar-specific launcher item (config-time declaration). */\nexport type MenubarLauncherItem = LauncherItemRef & {\n  group?: string;\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n};\n\n/**\n * Generic runtime availability contract for launcher declarations.\n *\n * This is intentionally distinct from `requiredFeatures` on resolved\n * view/resource targets:\n * - `runtimeAvailability` decides whether a launcher declaration should survive\n *   the app-shell filtering pass at all\n * - `requiredFeatures` stays the canonical plan/subscription gating mechanism\n *   once an item has already survived launcher filtering and is being resolved\n */\nexport interface LauncherRuntimeAvailabilityConfig {\n  requiredCapabilities?: string[];\n}\n\nexport const LauncherRuntimeAvailabilityConfigSchema = z.object({\n  requiredCapabilities: z.array(z.string()).optional(),\n});\n\n// ════════════════════════════════════════════════════════════════\n// Scope Condition Types (used by sidebar sections, evaluated in Macro B)\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Parameters passed to a `ScopeConditionFn` for evaluating section visibility.\n *\n * @see component-taxonomy-deep-review.md §3.5.3\n */\nexport interface ScopeConditionParams {\n  /** Current app scope values (workspace, project, environment, etc.). */\n  appScopeValues: Record<string, AppScopeValue>;\n  /** Currently active mode ref, or `null` if no mode system. */\n  activeMode: string | null;\n  /** All defined app modes (for inspecting mode metadata). */\n  availableModes: AppModeDefinition[];\n}\n\n/**\n * Predicate function that determines whether a sidebar section should be visible\n * based on the current scope and mode state.\n *\n * Returns `true` to show the section, `false` to hide it.\n * Called reactively whenever scope or mode changes.\n */\nexport type ScopeConditionFn = (params: ScopeConditionParams) => boolean;\n\n/**\n * Context provided to a `ResourceBrowser` section's `onInstanceClick` callback.\n */\nexport interface ResourceBrowserClickContext {\n  resourceType: string;\n  instanceId: string;\n  instanceData: Record<string, unknown>;\n}\n\n// ════════════════════════════════════════════════════════════════\n// AppMode Definition\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Defines an application mode (e.g., \"explorer\", \"search\", \"admin\").\n *\n * Modes filter which sidebar sections are visible. The `ACTIVITY_BAR`\n * renders available modes as selectable icons.\n *\n * @see component-taxonomy-deep-review.md §7.3\n */\nexport interface AppModeDefinition {\n  /** Unique reference for this mode. */\n  ref: string;\n  /** Display label (i18n ref). */\n  label: string;\n  /** Icon identifier for the activity bar. */\n  icon: string;\n  /** Whether this is the default mode when none is persisted. */\n  isDefault?: boolean;\n  /** Restrict mode visibility to specific user types. */\n  visibleToUserTypes?: string[];\n}\n\n// ════════════════════════════════════════════════════════════════\n// Sidebar Section Types — Discriminated Union on `contentKind`\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Base properties shared by all sidebar section types.\n * `ref` is `string`-typed — no framework enum, apps define their own refs.\n */\nexport interface SidebarSectionBase {\n  contentKind: SidebarSectionContentKind;\n  /** Section reference — app-defined, used for i18n and configuration matching. */\n  ref: string;\n  /** Display label (i18n ref). If omitted, section renders without a header. */\n  label?: string;\n  /** Icon for the section header. */\n  icon?: string;\n  /** Whether the section header (label + icon) is rendered. Defaults to `true`. */\n  showLabel?: boolean;\n  /** Whether the section can be collapsed by the user. */\n  collapsible?: boolean;\n  /** Whether the section starts collapsed. */\n  defaultCollapsed?: boolean;\n  /**\n   * Mode refs this section is visible in. If omitted, visible in all modes.\n   * String-based — validated at startup against `appModes[].ref`.\n   * Evaluated in Macro B (Step 6).\n   */\n  visibleInModes?: string[];\n  /**\n   * Function-based visibility condition for complex scope-dependent logic.\n   * Evaluated in Macro B (Step 6).\n   */\n  scopeCondition?: ScopeConditionFn;\n  /** Declarative runtime capability gating evaluated by the app-shell layer. */\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n}\n\n/**\n * Traditional navigation item list section.\n * Supports tree hierarchy, inline create, drag-reorder (via behavior).\n */\nexport interface SidebarSection_NavigationList extends SidebarSectionBase {\n  contentKind: SidebarSectionContentKind.NAVIGATION_LIST;\n  children: SidebarItem[];\n  behavior?: SidebarSectionBehavior;\n  /**\n   * Marks this section as the sidebar's PRIMARY navigation group — the app's\n   * top-level destinations (the \"Home group\"). Primary sections render at the\n   * top of the sidebar with no section header and never collapsible. When\n   * `SIDEBAR.homeDisplayMode` is `NAVIGATION_ITEM` (the default) the framework's\n   * Home row heads that same group, giving the Linear/Notion \"Inbox / My Issues\n   * right under Home\" shape; the other home modes surface home elsewhere and\n   * leave this group to the app's own destinations.\n   *\n   * This is a PLACEMENT/CHROME role, deliberately distinct from\n   * `SidebarSectionBehavior` (which describes where a section's ITEMS come\n   * from). Section ordering is engine policy and ignores declaration order for\n   * the special roles: primary section(s) first, then non-empty\n   * `SidebarSectionBehavior.FAVORITES` section(s), then the remaining sections\n   * in declared order. Modules can therefore contribute a primary section\n   * without the app config having to interleave it manually.\n   */\n  isPrimary?: boolean;\n  inlineCreate?: SidebarSectionInlineCreate;\n  inlineCreateResourceType?: string;\n  /** Field that receives the user's input during inline creation. Defaults to `'title'`. */\n  inlineCreateField?: string;\n  nested?: boolean;\n  maxNestingDepth?: number;\n}\n\n/**\n * Filterable resource instance list section.\n * Fetches data from a bound operation and displays resource instances.\n *\n * @see launcher-operation-binding-analysis.md §3.3.6\n */\nexport interface SidebarSection_ResourceBrowser extends SidebarSectionBase {\n  contentKind: SidebarSectionContentKind.RESOURCE_BROWSER;\n  /** Resource type to browse. */\n  resourceType: string;\n  /** Override the default LIST operation (optional — defaults to LIST). */\n  operation?: string;\n  /** Operation variant for filtered views. */\n  operationVariant?: string;\n  /**\n   * Operation used when the user clicks a listed instance.\n   * Defaults to READ when available; otherwise falls back to the bound operation.\n   */\n  navigateOperation?: string;\n  /** Variant for the click/navigation operation. */\n  navigateOperationVariant?: string;\n  /**\n   * Client-side filter predicate applied after fetching.\n   * Enables display restrictions (e.g., \"starred only\").\n   */\n  instanceFilter?: (instance: Record<string, unknown>) => boolean;\n  /**\n   * Custom click handler for resource instances.\n   * Default: navigate to instance via `NavigationUtils.resolveResourceUrl()`.\n   */\n  onInstanceClick?: (context: ResourceBrowserClickContext) => void;\n}\n\n/** Guidance/onboarding widget section. */\nexport interface SidebarSection_GuidanceWidget extends SidebarSectionBase {\n  contentKind: SidebarSectionContentKind.GUIDANCE_WIDGET;\n  /** Reference to a registered guidance component. */\n  guidanceRef: string;\n}\n\n/** Arbitrary custom component section. */\nexport interface SidebarSection_CustomComponent extends SidebarSectionBase {\n  contentKind: SidebarSectionContentKind.CUSTOM_COMPONENT;\n  /** Reference to a registered React component. */\n  componentRef: string;\n}\n\n/**\n * Discriminated union of all sidebar section types.\n * Narrow on `contentKind` to access type-specific properties.\n */\nexport type SidebarSection =\n  | SidebarSection_NavigationList\n  | SidebarSection_ResourceBrowser\n  | SidebarSection_GuidanceWidget\n  | SidebarSection_CustomComponent;\n\n// ════════════════════════════════════════════════════════════════\n// Zod Schemas\n// ════════════════════════════════════════════════════════════════\n\nexport const LauncherItemTargetKindSchema = z.enum(LauncherItemTargetKind);\nexport const EnginePageRefSchema = z.enum(EnginePageRef);\nexport const ActivityBarRenderingSchema = z.enum(ActivityBarRendering);\nexport const SidebarResponsivePolicySchema = z.enum(SidebarResponsivePolicy);\nexport const QuickActionButtonPlacementSchema = z.enum(QuickActionButtonPlacement);\nexport const SidebarSectionContentKindSchema = z.enum(SidebarSectionContentKind);\n\n/** Zod schema for `ResourceOperationItemRef`. */\nexport const ResourceOperationItemRefSchema = z.object({\n  kind: z.literal(LauncherItemTargetKind.RESOURCE_OPERATION),\n  resourceType: z.string(),\n  operation: z.string(),\n  operationVariant: z.string().optional(),\n});\n\n/** Zod schema for `ViewItemRef`. */\nexport const ViewItemRefSchema = z.object({\n  kind: z.literal(LauncherItemTargetKind.VIEW),\n  viewRef: z.string(),\n});\n\n/** Zod schema for `ResourceViewItemRef`. */\nexport const ResourceViewItemRefSchema = z.object({\n  kind: z.literal(LauncherItemTargetKind.RESOURCE_VIEW),\n  resourceType: z.string(),\n  viewRef: z.string(),\n});\n\n/** Zod schema for `EnginePageItemRef`. */\nexport const EnginePageItemRefSchema = z.object({\n  kind: z.literal(LauncherItemTargetKind.ENGINE_PAGE),\n  pageRef: EnginePageRefSchema,\n});\n\n/** Zod schema for `CustomComponentItemRef`. */\nexport const CustomComponentItemRefSchema = z.object({\n  kind: z.literal(LauncherItemTargetKind.CUSTOM_COMPONENT),\n  componentRef: z.string(),\n});\n\nexport const SettingsSectionItemRefSchema = z.object({\n  kind: z.literal(LauncherItemTargetKind.SETTINGS_SECTION),\n  sectionRef: z.string().optional(),\n});\n\n/**\n * Zod schema for `LauncherItemRef` — discriminated union on `kind`.\n * Validates config-time launcher item references.\n */\nexport const LauncherItemRefSchema = z.discriminatedUnion('kind', [\n  ResourceOperationItemRefSchema,\n  ViewItemRefSchema,\n  ResourceViewItemRefSchema,\n  EnginePageItemRefSchema,\n  CustomComponentItemRefSchema,\n  SettingsSectionItemRefSchema,\n]);\n\n/** Zod schema for `SidebarItem`. */\nexport const SidebarItemSchema: z.ZodType<SidebarItem> = z.lazy(() =>\n  LauncherItemRefSchema.and(z.object({\n    displayPolicy: z.enum(SidebarItemDisplayPolicy).optional(),\n    notificationBadgeRef: z.string().optional(),\n    children: z.array(SidebarItemSchema).optional(),\n    runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n  }))\n);\n\n/** Zod schema for `CommandMenuCommand`. */\nexport const CommandMenuCommandSchema = LauncherItemRefSchema.and(z.object({\n  category: z.string().optional(),\n  shortcut: z.string().optional(),\n  searchKeywords: z.array(z.string()).optional(),\n  displayPolicy: z.enum(CommandMenuDisplayPolicy).optional(),\n  runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n}));\n\n/**\n * @wildo_source:part:start saas.frontend.command-menu.search-resource facet:layer:frontend facet:family:app-shell\n *\n * Zod schema for `CommandMenuSearchResource` — validates each entry in the\n * `[COMMAND_MENU].searchResources` array.\n */\nexport const CommandMenuSearchResourceSchema: z.ZodType<CommandMenuSearchResource> = z.object({\n  resourceType: z.string(),\n  category: z.string().optional(),\n  maxResults: z.number().optional(),\n  order: z.number().optional(),\n  resultDisplay: z.enum([\n    ForeignKeyDisplayMode.ID,\n    ForeignKeyDisplayMode.LABEL,\n    ForeignKeyDisplayMode.SUMMARY,\n  ]).optional(),\n  searchKeywords: z.array(z.string()).optional(),\n});\n/** @wildo_source:part:end saas.frontend.command-menu.search-resource */\n\n/** Zod schema for `QuickActionItem`. */\nexport const QuickActionItemSchema = LauncherItemRefSchema.and(z.object({\n  displayPolicy: z.enum(QuickActionDisplayPolicy).optional(),\n  runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n}));\n\n/** Zod schema for `HotkeyBinding`. */\nexport const HotkeyBindingSchema = LauncherItemRefSchema.and(z.object({\n  shortcut: z.string(),\n  scope: z.enum(HotkeyScope).optional(),\n  description: z.string().optional(),\n  runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n}));\n\n/** Zod schema for `ToolbarItemRef`. */\nexport const ToolbarItemRefSchema = z.discriminatedUnion('kind', [\n  ResourceOperationItemRefSchema,\n  ViewItemRefSchema,\n  ResourceViewItemRefSchema,\n  EnginePageItemRefSchema,\n]);\n\n/** Zod schema for `ToolbarItem`. */\nexport const ToolbarItemSchema = ToolbarItemRefSchema.and(z.object({\n  group: z.string().optional(),\n  iconOnly: z.boolean().optional(),\n  runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n}));\n\n/** Zod schema for `ControlPanelItem`. */\nexport const ControlPanelItemSchema = LauncherItemRefSchema.and(z.object({\n  section: z.string().optional(),\n  runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n}));\n\n/**\n * Zod schema for `UtilityPanelItem`.\n *\n * A DISCRIMINATED union rather than one object with two optional refs: an item that carried both a\n * `componentRef` and a `viewRef`, or neither, would parse — and the render path would then have to\n * invent a precedence rule that no author wrote down.\n */\nexport const UtilityPanelItemSchema = z.discriminatedUnion('kind', [\n  z.object({\n    kind: z.literal(LauncherItemTargetKind.CUSTOM_COMPONENT),\n    componentRef: z.string(),\n    icon: z.string(),\n    label: z.string(),\n  }),\n  z.object({\n    kind: z.literal(LauncherItemTargetKind.VIEW),\n    viewRef: z.string(),\n    icon: z.string(),\n    label: z.string(),\n  }),\n]);\n\n/**\n * @wildo_source:part:start saas.frontend.app-shell.hosted-components facet:layer:frontend facet:family:app-shell\n *\n * Zod schema for `MenubarHostedComponent` — validates each entry in the\n * `[MENUBAR].hostedComponents` array. `placement` determines which zone\n * (START/MIDDLE/END) the component renders in; `breakpoint` restricts the\n * component to a specific viewport breakpoint. Render order follows array\n * position in `hostedComponents`.\n */\nexport const MenubarHostedComponentSchema = z.object({\n  componentType: z.string(),\n  placement: z.enum(HorizontalPlacement).optional(),\n  breakpoint: z.enum(ViewportBreakpoint).optional(),\n  presetName: z.string().optional(),\n  triggerWidth: z.union([z.string(), z.number()]).optional(),\n  triggerAppearance: z.enum(HostedTriggerAppearance).optional(),\n});\n\n/**\n * Zod schema for `SidebarHostedComponent` — declares a component hosted within\n * the sidebar (the vertical mirror of `MenubarHostedComponentSchema`).\n * `placement` selects which end of the sidebar column the component renders at\n * (`TOP`/`BOTTOM`); `breakpoint` restricts it to a viewport breakpoint. Render\n * order follows array position in `hostedComponents`.\n */\nexport const SidebarHostedComponentSchema = z.object({\n  componentType: z.string(),\n  placement: z.enum(VerticalPlacement).optional(),\n  breakpoint: z.enum(ViewportBreakpoint).optional(),\n  presetName: z.string().optional(),\n  triggerWidth: z.union([z.string(), z.number()]).optional(),\n  triggerAppearance: z.enum(HostedTriggerAppearance).optional(),\n});\n/** @wildo_source:part:end saas.frontend.app-shell.hosted-components */\n\n/** Zod schema for `MenubarLauncherItem`. */\nexport const MenubarLauncherItemSchema = LauncherItemRefSchema.and(z.object({\n  group: z.string().optional(),\n  runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n}));\n\n// ── Sidebar Section Schemas (discriminated union on contentKind) ──\n\nconst SidebarSectionBaseSchema = z.object({\n  ref: z.string(),\n  label: z.string().optional(),\n  icon: z.string().optional(),\n  showLabel: z.boolean().optional(),\n  collapsible: z.boolean().optional(),\n  defaultCollapsed: z.boolean().optional(),\n  visibleInModes: z.array(z.string()).optional(),\n  runtimeAvailability: LauncherRuntimeAvailabilityConfigSchema.optional(),\n});\n\nexport const SidebarSection_NavigationListSchema = SidebarSectionBaseSchema.extend({\n  contentKind: z.literal(SidebarSectionContentKind.NAVIGATION_LIST),\n  children: z.array(SidebarItemSchema),\n  behavior: z.enum(SidebarSectionBehavior).optional(),\n  isPrimary: z.boolean().optional(),\n  inlineCreate: z.enum(SidebarSectionInlineCreate).optional(),\n  inlineCreateResourceType: z.string().optional(),\n  inlineCreateField: z.string().optional(),\n  nested: z.boolean().optional(),\n  maxNestingDepth: z.number().optional(),\n});\n\nexport const SidebarSection_ResourceBrowserSchema = SidebarSectionBaseSchema.extend({\n  contentKind: z.literal(SidebarSectionContentKind.RESOURCE_BROWSER),\n  resourceType: z.string(),\n  operation: z.string().optional(),\n  operationVariant: z.string().optional(),\n  navigateOperation: z.string().optional(),\n  navigateOperationVariant: z.string().optional(),\n});\n\nexport const SidebarSection_GuidanceWidgetSchema = SidebarSectionBaseSchema.extend({\n  contentKind: z.literal(SidebarSectionContentKind.GUIDANCE_WIDGET),\n  guidanceRef: z.string(),\n});\n\nexport const SidebarSection_CustomComponentSchema = SidebarSectionBaseSchema.extend({\n  contentKind: z.literal(SidebarSectionContentKind.CUSTOM_COMPONENT),\n  componentRef: z.string(),\n});\n\n/**\n * Zod schema for `SidebarSection` — discriminated union on `contentKind`.\n *\n * Note: `scopeCondition` (on `SidebarSectionBase`), `instanceFilter`, and\n * `onInstanceClick` (on `SidebarSection_ResourceBrowser`) are function types\n * that cannot be validated by Zod. They are typed on the TypeScript interfaces\n * but excluded from the Zod schema (runtime code handles them directly).\n */\nexport const SidebarSectionSchema = z.discriminatedUnion('contentKind', [\n  SidebarSection_NavigationListSchema,\n  SidebarSection_ResourceBrowserSchema,\n  SidebarSection_GuidanceWidgetSchema,\n  SidebarSection_CustomComponentSchema,\n]);\n\n/** Zod schema for `AppModeDefinition`. */\nexport const AppModeDefinitionSchema = z.object({\n  ref: z.string(),\n  label: z.string(),\n  icon: z.string(),\n  isDefault: z.boolean().optional(),\n  visibleToUserTypes: z.array(z.string()).optional(),\n});\n"]}

package/dist/esm/core/config/onboarding-view.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding-view.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/onboarding-view.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAiC,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AAEpI;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2B1C,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,sBAAsB,CAAC;IAC9B,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC3E,8BAA8B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC9E,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C"}
+{"version":3,"file":"onboarding-view.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/config/onboarding-view.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAiC,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AAEpI;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2B1C,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,sBAAsB,CAAC;IAC9B,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC3E,8BAA8B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC9E,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C"}

package/dist/esm/core/config/onboarding-view.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding-view.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/config/onboarding-view.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAAE,6BAA6B,EAA0B,MAAM,0BAA0B,CAAC;AAGjG;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,YAAY,CAC1D,6BAA6B,EAC7B,CAAC,CAAC,MAAM,CAAC;IACP;;;;;;;;;;;;;;;;;OAiBG;IACH,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,OAAO,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IAC3C,OAAO,EAAE,2BAA2B;IACpC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAC1C,gBAAgB,EAAE,4BAA4B,CAAC,QAAQ,EAAE;CAC1D,CAAC,CACH,CAAC","sourcesContent":["import { z } from 'zod';\nimport {\n  OnboardingTriggerSchema,\n  OnboardingViewOptionsSchema,\n  OnboardingElementSchema,\n  RequiredFeaturesConfigSchema,\n} from '@wildo-ai/saas-models';\nimport type {\n  OnboardingTrigger,\n  OnboardingViewOptions,\n  OnboardingElement,\n  RequiredFeaturesConfig,\n} from '@wildo-ai/saas-models';\nimport { FrontendView_DefinitionSchema, FrontendView_ScopeMode } from './views-frontend.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\n\n/**\n * OnboardingViewDefinition — intersects onboarding primitives (saas-models)\n * with view wiring (FrontendView_DefinitionSchema) for frontend rendering.\n *\n * The onboarding primitives (triggers, elements, options) are shared because\n * the backend guidance system inspects them. The view definition wrapper\n * (scope, parent requirements) is frontend-only.\n */\nexport const OnboardingViewDefinitionSchema = z.intersection(\n  FrontendView_DefinitionSchema,\n  z.object({\n    /**\n     * Stable string identity for this onboarding view. Used by:\n     * - The companion spec layer (`OnboardingViewSpecification` keys\n     *   this ref against `app.<ref>` for application-scope views and\n     *   `resources.<resourceType>.<ref>` for resource-scope views).\n     * - Future ref-based registry lookups (today the runtime accesses\n     *   onboarding documents by direct array reference via\n     *   `<EmbedOnboarding document={…} />`, but per-ref lookup is the\n     *   coming convention — guidance flows already work this way).\n     *\n     * NOTE on uniqueness: `buildFrontendModuleRegistry` collapses\n     * onboarding views to ref-keyed dedup (mirrors guidance-flow\n     * merge). Two modules contributing the same ref therefore overwrite,\n     * with the last-merged module winning — same semantics as\n     * guidance flows. Spec-layer\n     * `buildOnboardingViewSpecificationMap` ALSO fails closed on\n     * duplicate keys for any app that authors the spec.\n     */\n    ref: z.string().min(1),\n    trigger: OnboardingTriggerSchema.optional(),\n    options: OnboardingViewOptionsSchema,\n    elements: z.array(OnboardingElementSchema),\n    requiredFeatures: RequiredFeaturesConfigSchema.optional(),\n  }),\n);\n\nexport interface OnboardingViewDefinition {\n  ref: string;\n  scope: FrontendView_ScopeMode;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];\n  trigger?: OnboardingTrigger;\n  options: OnboardingViewOptions;\n  elements: OnboardingElement[];\n  requiredFeatures?: RequiredFeaturesConfig;\n}\n"]}
+{"version":3,"file":"onboarding-view.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/config/onboarding-view.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAAE,6BAA6B,EAA0B,MAAM,0BAA0B,CAAC;AAGjG;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,YAAY,CAC1D,6BAA6B,EAC7B,CAAC,CAAC,MAAM,CAAC;IACP;;;;;;;;;;;;;;;;;OAiBG;IACH,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,OAAO,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IAC3C,OAAO,EAAE,2BAA2B;IACpC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAC1C,gBAAgB,EAAE,4BAA4B,CAAC,QAAQ,EAAE;CAC1D,CAAC,CACH,CAAC","sourcesContent":["import { z } from 'zod';\nimport {\n  OnboardingTriggerSchema,\n  OnboardingViewOptionsSchema,\n  OnboardingElementSchema,\n  RequiredFeaturesConfigSchema,\n} from '@wildo-ai/saas-models';\nimport type {\n  OnboardingTrigger,\n  OnboardingViewOptions,\n  OnboardingElement,\n  RequiredFeaturesConfig,\n} from '@wildo-ai/saas-models';\nimport { FrontendView_DefinitionSchema, FrontendView_ScopeMode } from './views-frontend.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\n\n/**\n * OnboardingViewDefinition — intersects onboarding primitives (saas-models)\n * with view wiring (FrontendView_DefinitionSchema) for frontend rendering.\n *\n * The onboarding primitives (triggers, elements, options) are shared because\n * the backend guidance system inspects them. The view definition wrapper\n * (scope, parent requirements) is frontend-only.\n */\nexport const OnboardingViewDefinitionSchema = z.intersection(\n  FrontendView_DefinitionSchema,\n  z.object({\n    /**\n     * Stable string identity for this onboarding view. Used by:\n     * - The companion spec layer (`OnboardingViewSpecification` keys\n     *   this ref against `app.<ref>` for application-scope views and\n     *   `resources.<resourceType>.<ref>` for resource-scope views).\n     * - Future ref-based registry lookups (today the runtime accesses\n     *   onboarding documents by direct array reference via\n     *   `<EmbedOnboarding document={…} />`, but per-ref lookup is the\n     *   coming convention — guidance flows already work this way).\n     *\n     * NOTE on uniqueness: `buildFrontendModuleRegistry` collapses\n     * onboarding views to ref-keyed dedup (mirrors guidance-flow\n     * merge). Two modules contributing the same ref therefore overwrite,\n     * with the last-merged module winning — same semantics as\n     * guidance flows. Spec-layer\n     * `buildOnboardingViewSpecificationMap` ALSO fails closed on\n     * duplicate keys for any app that authors the spec.\n     */\n    ref: z.string().min(1),\n    trigger: OnboardingTriggerSchema.optional(),\n    options: OnboardingViewOptionsSchema,\n    elements: z.array(OnboardingElementSchema),\n    requiredFeatures: RequiredFeaturesConfigSchema.optional(),\n  }),\n);\n\nexport interface OnboardingViewDefinition {\n  ref: string;\n  scope: FrontendView_ScopeMode;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];\n  trigger?: OnboardingTrigger;\n  options: OnboardingViewOptions;\n  elements: OnboardingElement[];\n  requiredFeatures?: RequiredFeaturesConfig;\n}\n"]}

package/dist/esm/core/config/resource-owned-view-resolution.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-owned-view-resolution.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/resource-owned-view-resolution.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAE/G,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,uBAAuB,CAAC;IAChC,KAAK,EAAE,sBAAsB,CAAC;CAC/B;AAED,MAAM,WAAW,+BAAgC,SAAQ,iCAAiC;IACxF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,yBAAyB,CAAC;CACrC,GAAG,+BAA+B,EAAE,CAoBpC;AAED,wBAAgB,qCAAqC,CAAC,MAAM,EAAE;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,yBAAyB,CAAC;CACrC,GAAG,+BAA+B,EAAE,CAKpC;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,yBAAyB,CAAC;CACrC,GAAG,iCAAiC,GAAG,IAAI,CAU3C"}
+{"version":3,"file":"resource-owned-view-resolution.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/config/resource-owned-view-resolution.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAE/G,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,uBAAuB,CAAC;IAChC,KAAK,EAAE,sBAAsB,CAAC;CAC/B;AAED,MAAM,WAAW,+BAAgC,SAAQ,iCAAiC;IACxF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,yBAAyB,CAAC;CACrC,GAAG,+BAA+B,EAAE,CAoBpC;AAED,wBAAgB,qCAAqC,CAAC,MAAM,EAAE;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,yBAAyB,CAAC;CACrC,GAAG,+BAA+B,EAAE,CAKpC;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,yBAAyB,CAAC;CACrC,GAAG,iCAAiC,GAAG,IAAI,CAU3C"}

package/dist/esm/core/config/resource-owned-view-resolution.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource-owned-view-resolution.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/config/resource-owned-view-resolution.frontend.utils.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,+BAA+B,CAAC,MAG/C;IACC,MAAM,qBAAqB,GAAG,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAC;IAEjH,OAAO;QACL,GAAG,CAAC,qBAAqB,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,MAAM,EAAE,WAAoB;YAC5B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,GAAG,CAAC,qBAAqB,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1D,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,MAAM,EAAE,OAAgB;YACxB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,GAAG,CAAC,qBAAqB,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,MAAM,EAAE,WAAoB;YAC5B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,MAIrD;IACC,OAAO,+BAA+B,CAAC;QACrC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,MAIjD;IACC,MAAM,OAAO,GAAG,qCAAqC,CAAC,MAAM,CAAC,CAAC;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM;QACzB,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK;KACxB,CAAC;AACJ,CAAC","sourcesContent":["import { FrontendView_ScopeMode } from './views-frontend.schemas';\nimport type { FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\nexport type ResourceOwnedViewFamily = 'composite' | 'chart' | 'execution';\n\nexport interface ResourceOwnedViewResolutionResult {\n  family: ResourceOwnedViewFamily;\n  scope: FrontendView_ScopeMode;\n}\n\nexport interface ResourceOwnedViewReferenceMatch extends ResourceOwnedViewResolutionResult {\n  viewRef: string;\n}\n\nexport function listResourceOwnedViewReferences(params: {\n  resourceType: string;\n  registry: FrontendResourcesRegistry;\n}): ResourceOwnedViewReferenceMatch[] {\n  const frontendConfiguration = params.registry.resourceConfigurations[params.resourceType]?.frontendConfiguration;\n\n  return [\n    ...(frontendConfiguration?.compositeViews ?? []).map((view) => ({\n      viewRef: view.ref,\n      family: 'composite' as const,\n      scope: view.scope,\n    })),\n    ...(frontendConfiguration?.chartViews ?? []).map((view) => ({\n      viewRef: view.ref,\n      family: 'chart' as const,\n      scope: view.scope,\n    })),\n    ...(frontendConfiguration?.executionViews ?? []).map((view) => ({\n      viewRef: view.ref,\n      family: 'execution' as const,\n      scope: view.scope,\n    })),\n  ];\n}\n\nexport function findResourceOwnedViewReferenceMatches(params: {\n  resourceType: string;\n  viewRef: string;\n  registry: FrontendResourcesRegistry;\n}): ResourceOwnedViewReferenceMatch[] {\n  return listResourceOwnedViewReferences({\n    resourceType: params.resourceType,\n    registry: params.registry,\n  }).filter((view) => view.viewRef === params.viewRef);\n}\n\nexport function resolveResourceOwnedViewReference(params: {\n  resourceType: string;\n  viewRef: string;\n  registry: FrontendResourcesRegistry;\n}): ResourceOwnedViewResolutionResult | null {\n  const matches = findResourceOwnedViewReferenceMatches(params);\n  if (matches.length !== 1) {\n    return null;\n  }\n\n  return {\n    family: matches[0].family,\n    scope: matches[0].scope,\n  };\n}\n"]}
+{"version":3,"file":"resource-owned-view-resolution.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/config/resource-owned-view-resolution.frontend.utils.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,+BAA+B,CAAC,MAG/C;IACC,MAAM,qBAAqB,GAAG,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAC;IAEjH,OAAO;QACL,GAAG,CAAC,qBAAqB,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,MAAM,EAAE,WAAoB;YAC5B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,GAAG,CAAC,qBAAqB,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1D,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,MAAM,EAAE,OAAgB;YACxB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,GAAG,CAAC,qBAAqB,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,MAAM,EAAE,WAAoB;YAC5B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,MAIrD;IACC,OAAO,+BAA+B,CAAC;QACrC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,MAIjD;IACC,MAAM,OAAO,GAAG,qCAAqC,CAAC,MAAM,CAAC,CAAC;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM;QACzB,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK;KACxB,CAAC;AACJ,CAAC","sourcesContent":["import { FrontendView_ScopeMode } from './views-frontend.schemas';\nimport type { FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\nexport type ResourceOwnedViewFamily = 'composite' | 'chart' | 'execution';\n\nexport interface ResourceOwnedViewResolutionResult {\n  family: ResourceOwnedViewFamily;\n  scope: FrontendView_ScopeMode;\n}\n\nexport interface ResourceOwnedViewReferenceMatch extends ResourceOwnedViewResolutionResult {\n  viewRef: string;\n}\n\nexport function listResourceOwnedViewReferences(params: {\n  resourceType: string;\n  registry: FrontendResourcesRegistry;\n}): ResourceOwnedViewReferenceMatch[] {\n  const frontendConfiguration = params.registry.resourceConfigurations[params.resourceType]?.frontendConfiguration;\n\n  return [\n    ...(frontendConfiguration?.compositeViews ?? []).map((view) => ({\n      viewRef: view.ref,\n      family: 'composite' as const,\n      scope: view.scope,\n    })),\n    ...(frontendConfiguration?.chartViews ?? []).map((view) => ({\n      viewRef: view.ref,\n      family: 'chart' as const,\n      scope: view.scope,\n    })),\n    ...(frontendConfiguration?.executionViews ?? []).map((view) => ({\n      viewRef: view.ref,\n      family: 'execution' as const,\n      scope: view.scope,\n    })),\n  ];\n}\n\nexport function findResourceOwnedViewReferenceMatches(params: {\n  resourceType: string;\n  viewRef: string;\n  registry: FrontendResourcesRegistry;\n}): ResourceOwnedViewReferenceMatch[] {\n  return listResourceOwnedViewReferences({\n    resourceType: params.resourceType,\n    registry: params.registry,\n  }).filter((view) => view.viewRef === params.viewRef);\n}\n\nexport function resolveResourceOwnedViewReference(params: {\n  resourceType: string;\n  viewRef: string;\n  registry: FrontendResourcesRegistry;\n}): ResourceOwnedViewResolutionResult | null {\n  const matches = findResourceOwnedViewReferenceMatches(params);\n  if (matches.length !== 1) {\n    return null;\n  }\n\n  return {\n    family: matches[0].family,\n    scope: matches[0].scope,\n  };\n}\n"]}

package/dist/esm/core/config/settings-hub-gating.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-hub-gating.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/settings-hub-gating.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAEL,KAAK,kCAAkC,EACxC,MAAM,mEAAmE,CAAC;AAC3E,OAAO,KAAK,EACV,yBAAyB,EAG1B,MAAM,iCAAiC,CAAC;AAEzC,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,qEAAqE;AACrE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,8DAA8D;IAC9D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,4EAA4E;IAC5E,cAAc,EAAE,kCAAkC,CAAC;CACpD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,oBAAoB,GAAG,SAAS,EACvC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAaT;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EAAE,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAGT;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,gBAAgB,EAAE,sBAAsB,GAAG,SAAS,EACpD,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAYT;AAWD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,yBAAyB,EACjC,MAAM,EAAE,wBAAwB,GAC/B,yBAAyB,CA0B3B"}
+{"version":3,"file":"settings-hub-gating.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/config/settings-hub-gating.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAEL,KAAK,kCAAkC,EACxC,MAAM,mEAAmE,CAAC;AAC3E,OAAO,KAAK,EACV,yBAAyB,EAG1B,MAAM,iCAAiC,CAAC;AAEzC,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,qEAAqE;AACrE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,8DAA8D;IAC9D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,4EAA4E;IAC5E,cAAc,EAAE,kCAAkC,CAAC;CACpD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,oBAAoB,GAAG,SAAS,EACvC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAaT;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EAAE,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAGT;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,gBAAgB,EAAE,sBAAsB,GAAG,SAAS,EACpD,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAYT;AAWD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,yBAAyB,EACjC,MAAM,EAAE,wBAAwB,GAC/B,yBAAyB,CA0B3B"}

package/dist/esm/core/config/settings-hub-gating.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings-hub-gating.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/config/settings-hub-gating.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Settings Hub — Section Gating (\"face to right management of the user\")\n *\n * Pure, React-free evaluation of which categories/sections the current user may\n * see. Kept separate from the {@link useVisibleSettingsHubConfig} hook so the\n * gating decisions are unit-testable without a React tree.\n *\n * Four orthogonal gates, mirroring the framework's existing launcher/view gating\n * semantics so settings sections behave identically to every other gated surface:\n *\n * 1. **Scope** — a category bound to a {@link ResourcePrimaryScope} is hidden\n *    when that scope has no current value (e.g. the `ORGANIZATIONS` category is\n *    hidden when no organization is selected). Scope-agnostic categories always\n *    pass.\n * 2. **Capability** — `runtimeAvailability.requiredCapabilities` evaluated via\n *    the SAME {@link isLauncherRuntimeAvailabilitySatisfied} the sidebar/command\n *    menu use (e.g. `billingEnabled`).\n * 3. **Role** — `requiredRoles` (OR semantics) evaluated against the merged\n *    app-level + current-organization role set (`buildFeaturePolicyRoles`).\n * 4. **Feature** — `requiredFeatures` ({@link RequiredFeaturesConfig}) boolean\n *    presence check against the resolved feature list. `limitChecks` are\n *    intentionally ignored: a settings section is shown or hidden, never\n *    \"over-limit\".\n *\n * @see settings-hub.frontend.schemas.ts — the gated section contract\n * @see useVisibleSettingsHubConfig.ts — the hook that wires live signals into this\n */\n\nimport { ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport type { RequiredFeaturesConfig } from '@wildo-ai/saas-models';\nimport {\n  isLauncherRuntimeAvailabilitySatisfied,\n  type LauncherRuntimeAvailabilityContext,\n} from '~wildo-frontend-lib/core/navigation/launcher-runtime-availability';\nimport type {\n  ResolvedSettingsHubConfig,\n  SettingsCategory,\n  SettingsSection,\n} from './settings-hub.frontend.schemas';\n\n/** The current primary-scope values used to evaluate category scope availability. */\nexport interface SettingsScopeIds {\n  currentUserId?: string | null;\n  currentOrganizationId?: string | null;\n  currentApplicationId?: string | null;\n  currentAnonymousUserId?: string | null;\n}\n\n/** Everything the pure filter needs to decide section visibility. */\nexport interface SettingsHubGatingContext {\n  scopeIds: SettingsScopeIds;\n  /** Merged app-level + current-org roles (from `buildFeaturePolicyRoles`). */\n  userRoles: string[];\n  /** Resolved boolean feature identifiers currently enabled. */\n  enabledFeatures: string[];\n  /** Runtime-capability context (reused verbatim from the launcher layer). */\n  runtimeContext: LauncherRuntimeAvailabilityContext;\n}\n\n/**\n * Whether a category's primary scope currently has a value. A category without a\n * `scope` is scope-agnostic and always available.\n */\nexport function isSettingsScopeAvailable(\n  scope: ResourcePrimaryScope | undefined,\n  scopeIds: SettingsScopeIds,\n): boolean {\n  switch (scope) {\n    case undefined:\n      return true;\n    case ResourcePrimaryScope.USER_SELF:\n      return Boolean(scopeIds.currentUserId);\n    case ResourcePrimaryScope.ORGANIZATIONS:\n      return Boolean(scopeIds.currentOrganizationId);\n    case ResourcePrimaryScope.APPLICATION:\n      return Boolean(scopeIds.currentApplicationId);\n    case ResourcePrimaryScope.ANONYMOUS:\n      return Boolean(scopeIds.currentAnonymousUserId);\n  }\n}\n\n/**\n * OR-semantics role check: a section with no `requiredRoles` is open; otherwise\n * the user must hold AT LEAST ONE of the required roles. Matches the role\n * semantics in `evaluateGuidanceAudience`.\n */\nexport function hasRequiredSettingsRoles(\n  requiredRoles: string[] | undefined,\n  userRoles: string[],\n): boolean {\n  if (!requiredRoles?.length) return true;\n  return requiredRoles.some(role => userRoles.includes(role));\n}\n\n/**\n * Boolean feature gate mirroring {@link RequiredFeaturesConfig} semantics\n * (shorthand `string[]` = OR; full form honours `mode`). `limitChecks` are not\n * evaluated for visibility. A section with no `requiredFeatures` is open.\n */\nexport function areSettingsFeaturesSatisfied(\n  requiredFeatures: RequiredFeaturesConfig | undefined,\n  enabledFeatures: string[],\n): boolean {\n  if (!requiredFeatures) return true;\n\n  const featureList = Array.isArray(requiredFeatures)\n    ? requiredFeatures\n    : (requiredFeatures.features ?? []);\n  if (featureList.length === 0) return true;\n\n  const mode = Array.isArray(requiredFeatures) ? 'OR' : (requiredFeatures.mode ?? 'OR');\n  return mode === 'OR'\n    ? featureList.some(feature => enabledFeatures.includes(feature))\n    : featureList.every(feature => enabledFeatures.includes(feature));\n}\n\n/** A section passes every gate except its category's scope (checked at the category level). */\nfunction isSectionVisible(section: SettingsSection, gating: SettingsHubGatingContext): boolean {\n  return (\n    isLauncherRuntimeAvailabilitySatisfied(section.runtimeAvailability, gating.runtimeContext) &&\n    hasRequiredSettingsRoles(section.requiredRoles, gating.userRoles) &&\n    areSettingsFeaturesSatisfied(section.requiredFeatures, gating.enabledFeatures)\n  );\n}\n\n/**\n * Filter a raw {@link ResolvedSettingsHubConfig} down to what the current user may see.\n *\n * Categories are dropped when their scope is unavailable OR when every one of\n * their sections is gated out (an empty rail group would be visual noise). The\n * `defaultSectionRef` is recomputed when the configured default is no longer\n * visible, so the hub never tries to open a section the user cannot access.\n */\nexport function filterSettingsHubConfig(\n  config: ResolvedSettingsHubConfig,\n  gating: SettingsHubGatingContext,\n): ResolvedSettingsHubConfig {\n  const scopedCategories: SettingsCategory[] = config.categories.filter(category =>\n    isSettingsScopeAvailable(category.scope, gating.scopeIds),\n  );\n  const scopedCategoryRefs = new Set(scopedCategories.map(category => category.ref));\n\n  const visibleSections = config.sections.filter(\n    section => scopedCategoryRefs.has(section.categoryRef) && isSectionVisible(section, gating),\n  );\n\n  // Drop categories that ended up with zero visible sections.\n  const populatedCategoryRefs = new Set(visibleSections.map(section => section.categoryRef));\n  const visibleCategories = scopedCategories.filter(category =>\n    populatedCategoryRefs.has(category.ref),\n  );\n\n  const defaultSectionRef =\n    config.defaultSectionRef && visibleSections.some(section => section.ref === config.defaultSectionRef)\n      ? config.defaultSectionRef\n      : visibleSections[0]?.ref;\n\n  return {\n    categories: visibleCategories,\n    sections: visibleSections,\n    defaultSectionRef,\n  };\n}\n"]}
+{"version":3,"file":"settings-hub-gating.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/config/settings-hub-gating.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Settings Hub — Section Gating (\"face to right management of the user\")\n *\n * Pure, React-free evaluation of which categories/sections the current user may\n * see. Kept separate from the {@link useVisibleSettingsHubConfig} hook so the\n * gating decisions are unit-testable without a React tree.\n *\n * Four orthogonal gates, mirroring the framework's existing launcher/view gating\n * semantics so settings sections behave identically to every other gated surface:\n *\n * 1. **Scope** — a category bound to a {@link ResourcePrimaryScope} is hidden\n *    when that scope has no current value (e.g. the `ORGANIZATIONS` category is\n *    hidden when no organization is selected). Scope-agnostic categories always\n *    pass.\n * 2. **Capability** — `runtimeAvailability.requiredCapabilities` evaluated via\n *    the SAME {@link isLauncherRuntimeAvailabilitySatisfied} the sidebar/command\n *    menu use (e.g. `billingEnabled`).\n * 3. **Role** — `requiredRoles` (OR semantics) evaluated against the merged\n *    app-level + current-organization role set (`buildFeaturePolicyRoles`).\n * 4. **Feature** — `requiredFeatures` ({@link RequiredFeaturesConfig}) boolean\n *    presence check against the resolved feature list. `limitChecks` are\n *    intentionally ignored: a settings section is shown or hidden, never\n *    \"over-limit\".\n *\n * @see settings-hub.frontend.schemas.ts — the gated section contract\n * @see useVisibleSettingsHubConfig.ts — the hook that wires live signals into this\n */\n\nimport { ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport type { RequiredFeaturesConfig } from '@wildo-ai/saas-models';\nimport {\n  isLauncherRuntimeAvailabilitySatisfied,\n  type LauncherRuntimeAvailabilityContext,\n} from '~wildo-frontend-lib/core/navigation/launcher-runtime-availability';\nimport type {\n  ResolvedSettingsHubConfig,\n  SettingsCategory,\n  SettingsSection,\n} from './settings-hub.frontend.schemas';\n\n/** The current primary-scope values used to evaluate category scope availability. */\nexport interface SettingsScopeIds {\n  currentUserId?: string | null;\n  currentOrganizationId?: string | null;\n  currentApplicationId?: string | null;\n  currentAnonymousUserId?: string | null;\n}\n\n/** Everything the pure filter needs to decide section visibility. */\nexport interface SettingsHubGatingContext {\n  scopeIds: SettingsScopeIds;\n  /** Merged app-level + current-org roles (from `buildFeaturePolicyRoles`). */\n  userRoles: string[];\n  /** Resolved boolean feature identifiers currently enabled. */\n  enabledFeatures: string[];\n  /** Runtime-capability context (reused verbatim from the launcher layer). */\n  runtimeContext: LauncherRuntimeAvailabilityContext;\n}\n\n/**\n * Whether a category's primary scope currently has a value. A category without a\n * `scope` is scope-agnostic and always available.\n */\nexport function isSettingsScopeAvailable(\n  scope: ResourcePrimaryScope | undefined,\n  scopeIds: SettingsScopeIds,\n): boolean {\n  switch (scope) {\n    case undefined:\n      return true;\n    case ResourcePrimaryScope.USER_SELF:\n      return Boolean(scopeIds.currentUserId);\n    case ResourcePrimaryScope.ORGANIZATIONS:\n      return Boolean(scopeIds.currentOrganizationId);\n    case ResourcePrimaryScope.APPLICATION:\n      return Boolean(scopeIds.currentApplicationId);\n    case ResourcePrimaryScope.ANONYMOUS:\n      return Boolean(scopeIds.currentAnonymousUserId);\n  }\n}\n\n/**\n * OR-semantics role check: a section with no `requiredRoles` is open; otherwise\n * the user must hold AT LEAST ONE of the required roles. Matches the role\n * semantics in `evaluateGuidanceAudience`.\n */\nexport function hasRequiredSettingsRoles(\n  requiredRoles: string[] | undefined,\n  userRoles: string[],\n): boolean {\n  if (!requiredRoles?.length) return true;\n  return requiredRoles.some(role => userRoles.includes(role));\n}\n\n/**\n * Boolean feature gate mirroring {@link RequiredFeaturesConfig} semantics\n * (shorthand `string[]` = OR; full form honours `mode`). `limitChecks` are not\n * evaluated for visibility. A section with no `requiredFeatures` is open.\n */\nexport function areSettingsFeaturesSatisfied(\n  requiredFeatures: RequiredFeaturesConfig | undefined,\n  enabledFeatures: string[],\n): boolean {\n  if (!requiredFeatures) return true;\n\n  const featureList = Array.isArray(requiredFeatures)\n    ? requiredFeatures\n    : (requiredFeatures.features ?? []);\n  if (featureList.length === 0) return true;\n\n  const mode = Array.isArray(requiredFeatures) ? 'OR' : (requiredFeatures.mode ?? 'OR');\n  return mode === 'OR'\n    ? featureList.some(feature => enabledFeatures.includes(feature))\n    : featureList.every(feature => enabledFeatures.includes(feature));\n}\n\n/** A section passes every gate except its category's scope (checked at the category level). */\nfunction isSectionVisible(section: SettingsSection, gating: SettingsHubGatingContext): boolean {\n  return (\n    isLauncherRuntimeAvailabilitySatisfied(section.runtimeAvailability, gating.runtimeContext) &&\n    hasRequiredSettingsRoles(section.requiredRoles, gating.userRoles) &&\n    areSettingsFeaturesSatisfied(section.requiredFeatures, gating.enabledFeatures)\n  );\n}\n\n/**\n * Filter a raw {@link ResolvedSettingsHubConfig} down to what the current user may see.\n *\n * Categories are dropped when their scope is unavailable OR when every one of\n * their sections is gated out (an empty rail group would be visual noise). The\n * `defaultSectionRef` is recomputed when the configured default is no longer\n * visible, so the hub never tries to open a section the user cannot access.\n */\nexport function filterSettingsHubConfig(\n  config: ResolvedSettingsHubConfig,\n  gating: SettingsHubGatingContext,\n): ResolvedSettingsHubConfig {\n  const scopedCategories: SettingsCategory[] = config.categories.filter(category =>\n    isSettingsScopeAvailable(category.scope, gating.scopeIds),\n  );\n  const scopedCategoryRefs = new Set(scopedCategories.map(category => category.ref));\n\n  const visibleSections = config.sections.filter(\n    section => scopedCategoryRefs.has(section.categoryRef) && isSectionVisible(section, gating),\n  );\n\n  // Drop categories that ended up with zero visible sections.\n  const populatedCategoryRefs = new Set(visibleSections.map(section => section.categoryRef));\n  const visibleCategories = scopedCategories.filter(category =>\n    populatedCategoryRefs.has(category.ref),\n  );\n\n  const defaultSectionRef =\n    config.defaultSectionRef && visibleSections.some(section => section.ref === config.defaultSectionRef)\n      ? config.defaultSectionRef\n      : visibleSections[0]?.ref;\n\n  return {\n    categories: visibleCategories,\n    sections: visibleSections,\n    defaultSectionRef,\n  };\n}\n"]}

package/dist/esm/core/config/settings-hub.frontend.schemas.d.ts

@@ -75,7 +75,29 @@ export declare enum SettingsPanelRef {
      * and auto-creates the account, which makes it the correct settings-surface
      * data source.
      */
-    BILLING = "billing"
+    BILLING = "billing",
+    /**
+     * Where a person CONNECTS one of their own third-party accounts.
+     *
+     * Bespoke because connecting is not a row somebody creates: it is a flow that leaves the
+     * application, obtains consent at a vendor, and returns with a grant nobody typed. The generic
+     * resource surface can list, inspect and delete the resulting credentials perfectly — it simply has
+     * no mechanism for an ACTION of that shape, which is why the whole outbound-authorization lane had
+     * no surface that could begin it until this existed.
+     *
+     * Paired with, never replacing, the credential list: this panel answers what MAY be connected and
+     * the list answers what IS, and the empty answer to the second is exactly when the first matters.
+     */
+    CONNECTED_ACCOUNTS = "connected-accounts",
+    /**
+     * The same act at the TENANT's scope: connecting an account the whole organization acts as.
+     *
+     * A distinct ref rather than a parameterised one, because a settings destination resolves a ref to
+     * a panel and carries no arguments — and because the two must never be reachable from each other's
+     * screen. The component behind them IS shared: the act is identical, and duplicating it would
+     * guarantee the two drift. What is never shared is the data.
+     */
+    ORGANIZATION_CONNECTED_ACCOUNTS = "organization-connected-accounts"
 }
 /** Renders a framework-owned bespoke panel. */
 export interface SettingsEnginePanelTarget {

package/dist/esm/core/config/settings-hub.frontend.schemas.d.ts.map

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

package/dist/esm/core/config/settings-hub.frontend.schemas.js

@@ -81,6 +81,28 @@ export var SettingsPanelRef;
      * data source.
      */
     SettingsPanelRef["BILLING"] = "billing";
+    /**
+     * Where a person CONNECTS one of their own third-party accounts.
+     *
+     * Bespoke because connecting is not a row somebody creates: it is a flow that leaves the
+     * application, obtains consent at a vendor, and returns with a grant nobody typed. The generic
+     * resource surface can list, inspect and delete the resulting credentials perfectly — it simply has
+     * no mechanism for an ACTION of that shape, which is why the whole outbound-authorization lane had
+     * no surface that could begin it until this existed.
+     *
+     * Paired with, never replacing, the credential list: this panel answers what MAY be connected and
+     * the list answers what IS, and the empty answer to the second is exactly when the first matters.
+     */
+    SettingsPanelRef["CONNECTED_ACCOUNTS"] = "connected-accounts";
+    /**
+     * The same act at the TENANT's scope: connecting an account the whole organization acts as.
+     *
+     * A distinct ref rather than a parameterised one, because a settings destination resolves a ref to
+     * a panel and carries no arguments — and because the two must never be reachable from each other's
+     * screen. The component behind them IS shared: the act is identical, and duplicating it would
+     * guarantee the two drift. What is never shared is the data.
+     */
+    SettingsPanelRef["ORGANIZATION_CONNECTED_ACCOUNTS"] = "organization-connected-accounts";
 })(SettingsPanelRef || (SettingsPanelRef = {}));
 /** @wildo_source:part:end saas.frontend.settings-hub.placement */
 //# sourceMappingURL=settings-hub.frontend.schemas.js.map

package/dist/esm/core/config/settings-hub.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings-hub.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/config/settings-hub.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,mEAAmE;AACnE,+DAA+D;AAC/D,mEAAmE;AAEnE;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,yBASX;AATD,WAAY,yBAAyB;IACnC,iEAAiE;IACjE,0DAA6B,CAAA;IAC7B,+FAA+F;IAC/F,sEAAyC,CAAA;IACzC,sFAAsF;IACtF,kEAAqC,CAAA;IACrC,0GAA0G;IAC1G,kDAAqB,CAAA;AACvB,CAAC,EATW,yBAAyB,KAAzB,yBAAyB,QASpC;AAED,mEAAmE;AACnE,6DAA6D;AAC7D,mEAAmE;AAEnE;;;;;;;;;;GAUG;AACH,MAAM,CAAN,IAAY,gBAoBX;AApBD,WAAY,gBAAgB;IAC1B,wGAAwG;IACxG,yCAAqB,CAAA;IACrB,qEAAqE;IACrE,6CAAyB,CAAA;IACzB,oFAAoF;IACpF,+CAA2B,CAAA;IAC3B;;;;;;;;;;;OAWG;IACH,uCAAmB,CAAA;AACrB,CAAC,EApBW,gBAAgB,KAAhB,gBAAgB,QAoB3B;AAgRD,kEAAkE","sourcesContent":["/**\n * Settings Hub — Declarative Section Registry\n *\n * The Settings Hub is the framework's single point of configuration: one overlay\n * surface that consolidates every settings destination (account, security,\n * appearance, organization, members, billing, …) behind a vertical `Tabs` rail\n * grouped by category. Many entry points (user dropdown, sidebar, command menu)\n * all converge on this one hub; links differ only by which section they pre-open.\n *\n * This file owns the **config-time** registry contract. It is declaration-first\n * and mirrors `launcher-items.frontend.schemas.ts`:\n * - `SettingsSectionTarget` is an interface-based discriminated union on `kind`\n *   (exactly like `LauncherItemRef`), because section targets are config-time\n *   descriptors resolved by the runtime — not Zod-validated wire payloads.\n * - The framework seeds a default `SettingsHubConfig`; apps merge/extend it\n *   (same model as the sidebar/launcher config).\n *\n * Runtime concerns live elsewhere:\n * - `NavigationContentType.SETTINGS_HUB` (navigation.schemas.ts) — what renders\n *   in the overlay zone.\n * - `SettingsHub` component (components/settings/) — resolves a section's target\n *   to a rendered panel.\n *\n * @see launcher-items.frontend.schemas.ts — the sibling launcher registry this mirrors\n * @see .claude/plans/unified-settings-hub.md — design + layer trace\n */\n\nimport { ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport type { RequiredFeaturesConfig } from '@wildo-ai/saas-models';\nimport type { LauncherRuntimeAvailabilityConfig } from './launcher-items.frontend.schemas';\n\n// ════════════════════════════════════════════════════════════════\n// Section Target Kind — discriminant for SettingsSectionTarget\n// ════════════════════════════════════════════════════════════════\n\n/**\n * What a settings section renders in its content panel.\n *\n * Discriminant for the `SettingsSectionTarget` union. The default for\n * data-backed settings is `RESOURCE_OPERATION` (reuse the auto-rendered\n * resource surface); `ENGINE_PANEL` is reserved for the few sections whose\n * bespoke layout earns it (Security, Appearance).\n */\nexport enum SettingsSectionTargetKind {\n  /** A framework-owned bespoke panel (Security, Appearance, …). */\n  ENGINE_PANEL = 'engine_panel',\n  /** An auto-rendered resource-operation surface (members, API tokens, billing, preferences). */\n  RESOURCE_OPERATION = 'resource_operation',\n  /** An app-registered custom React component (resolved via the component registry). */\n  CUSTOM_COMPONENT = 'custom_component',\n  /** A section that itself splits into horizontal sub-tabs (e.g. Teams → Members / Roles & Permissions). */\n  SUB_TABS = 'sub_tabs',\n}\n\n// ════════════════════════════════════════════════════════════════\n// Engine Panel Ref — framework-owned bespoke settings panels\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Framework-provided settings panels with bespoke (non-CRUD) layout.\n *\n * Closed enum — only framework panels belong here. Most settings sections should\n * be `RESOURCE_OPERATION` targets instead; a panel earns a slot here only when a\n * standard resource surface cannot express it (multi-factor enrollment flows,\n * theme/dark-mode toggles, …).\n *\n * The runtime maps each ref to a registered panel component in the\n * `SettingsHub` resolver.\n */\nexport enum SettingsPanelRef {\n  /** Password, MFA enrollment, passkeys, identity links (wraps the former `AppPage_SecuritySettings`). */\n  SECURITY = 'security',\n  /** Theme, dark-mode, density and other look-and-feel preferences. */\n  APPEARANCE = 'appearance',\n  /** The caller's own pending org invitations — accept/reject in-app (Approach P). */\n  INVITATIONS = 'invitations',\n  /**\n   * The billing home: subscription status, plan catalog + checkout, usage,\n   * invoices and the provider portal link — composed from the BillingContext\n   * aggregated state (`GET_STATE`), NOT from per-resource LIST surfaces.\n   *\n   * Bespoke on purpose: the billing child resources (subscriptions, invoice\n   * refs, usage records) are routed UNDER the billing account\n   * (`REQUIRES_CONTEXT`), so a generic org-scoped `RESOURCE_OPERATION` panel\n   * cannot build their URLs. The aggregated billing state is org-addressable\n   * and auto-creates the account, which makes it the correct settings-surface\n   * data source.\n   */\n  BILLING = 'billing',\n}\n\n// ════════════════════════════════════════════════════════════════\n// Section Target — discriminated union on `kind`\n// ════════════════════════════════════════════════════════════════\n\n/** Renders a framework-owned bespoke panel. */\nexport interface SettingsEnginePanelTarget {\n  kind: SettingsSectionTargetKind.ENGINE_PANEL;\n  panelRef: SettingsPanelRef;\n}\n\n/**\n * Renders an auto-generated resource-operation surface inside the section panel.\n * Resolved against the resource registry exactly like a launcher\n * `RESOURCE_OPERATION` target.\n */\nexport interface SettingsResourceOperationTarget {\n  kind: SettingsSectionTargetKind.RESOURCE_OPERATION;\n  resourceType: string;\n  operation: string;\n  operationVariant?: string;\n}\n\n/** Renders an app-registered custom React component (resolved by `componentRef`). */\nexport interface SettingsCustomComponentTarget {\n  kind: SettingsSectionTargetKind.CUSTOM_COMPONENT;\n  componentRef: string;\n}\n\n/**\n * Leaf targets renderable directly in a panel. Sub-tabs may only point at leaf\n * targets — sub-tabs cannot nest further sub-tabs (one level of in-section\n * tabbing, matching the BetterStack reference).\n */\nexport type SettingsLeafTarget =\n  | SettingsEnginePanelTarget\n  | SettingsResourceOperationTarget\n  | SettingsCustomComponentTarget;\n\n/**\n * One horizontal sub-tab within a section (e.g. the \"Members\" / \"Roles &\n * Permissions\" tabs inside a Teams section).\n */\nexport interface SettingsSubTab {\n  /** Sub-tab reference — app-defined, used for i18n + the `value` of the inner Tabs. */\n  ref: string;\n  /** Display label (i18n ref). */\n  label: string;\n  /** Optional icon ref for the sub-tab trigger. */\n  icon?: string;\n  /** What this sub-tab renders. Sub-tabs hold leaf targets only. */\n  target: SettingsLeafTarget;\n}\n\n/** Splits a section into horizontal sub-tabs rendered above the panel content. */\nexport interface SettingsSubTabsTarget {\n  kind: SettingsSectionTargetKind.SUB_TABS;\n  subTabs: SettingsSubTab[];\n}\n\n/**\n * What a settings section renders. Discriminated on `kind`; the `SettingsHub`\n * resolver dispatches on it to produce the panel content.\n */\nexport type SettingsSectionTarget = SettingsLeafTarget | SettingsSubTabsTarget;\n\n// ════════════════════════════════════════════════════════════════\n// Category — the rail group\n// ════════════════════════════════════════════════════════════════\n\n/**\n * A category groups sections in the vertical rail (the `Account` / `Organization`\n * group headers in the BetterStack reference). Rendered as a label + separator\n * inside the `TabsList` — NOT a separate nav widget (the `Tabs` primitive stays\n * the section mechanism).\n *\n * `scope` ties the category to a primary-scope axis so the runtime can hide it\n * when the scope is unavailable — e.g. an `ORGANIZATIONS` category is hidden when\n * no organization is selected. It is derived against `AppScope`, not authored\n * per-user.\n */\nexport interface SettingsCategory {\n  /** Category reference — app-defined, referenced by `SettingsSection.categoryRef`. */\n  ref: string;\n  /** Group header label (i18n ref). */\n  label: string;\n  /**\n   * Primary scope this category belongs to. Drives rail grouping order and\n   * scope-gated visibility (org categories hide when no org is selected).\n   * Omit for a scope-agnostic category.\n   */\n  scope?: ResourcePrimaryScope;\n  /** Optional icon ref for the group header. */\n  icon?: string;\n  /** Sort order among categories in the rail (lower = higher). */\n  order?: number;\n}\n\n// ════════════════════════════════════════════════════════════════\n// Section — one vertical tab in the rail\n// ════════════════════════════════════════════════════════════════\n\n/** @wildo_source:part:start saas.frontend.settings-hub.placement facet:layer:frontend facet:family:config facet:audience:app-developer */\n/**\n * An addressable settings DESTINATION — what a settings surface *is*, with no\n * opinion on where it appears.\n *\n * This is the half the engine ships (`ENGINE_SETTINGS_DESTINATIONS`). It carries\n * the target and the gating stack, and deliberately carries **no `categoryRef`,\n * no `order` and no `label`**: those are placement, and placement is the\n * application's decision (`SettingsPlacement`).\n *\n * The split exists because the engine shipping a PLACED hub is what made the\n * settings rail unauthorable — an application could not add, remove, reorder or\n * rename a section without the framework agreeing. Splitting destination from\n * placement lets the engine keep owning what a destination MEANS (its target,\n * its roles, its entitlement) while the application owns where it sits.\n */\nexport interface SettingsDestination {\n  /** Destination reference — the `/settings/:sectionRef` URL segment and the id a placement names. */\n  ref: string;\n  /** What the destination renders in its content panel. */\n  target: SettingsSectionTarget;\n  /** Declarative runtime capability gating (same contract as launcher items). */\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n  /** Feature flags required to surface this destination (plan/subscription gating). */\n  requiredFeatures?: RequiredFeaturesConfig;\n  /** RBAC roles required to surface this destination (OR semantics). */\n  requiredRoles?: string[];\n  /** Optional CoreFeature id this destination's content is ENTITLED by (soft gate — renders an upgrade prompt). */\n  entitlementFeatureId?: string;\n}\n\n/**\n * An application's explicit PLACEMENT of one destination in its settings rail.\n *\n * Authored in the application's own config. Nothing is placed implicitly: a\n * destination the application does not place does not render, which is the whole\n * point — \"we should just place things\", with no automatic inference.\n *\n * `label` is optional and is an OVERRIDE. The resolved label otherwise comes from\n * the `settings_hub.sections.<ref>.label` key, so a placed section is localizable\n * without the application authoring an English string.\n *\n * That namespace and its resolver (`tSettingsHubSection`) EXIST and already fall\n * back to the authored label. What does not exist is anything that generates the\n * units: `LabellingTypes.SETTINGS_HUB` is declared with an empty pattern and the\n * companion plans nothing for it, so today every rail label is the authored\n * English string. R9 is a wiring job, not a new mechanism.\n */\nexport interface SettingsPlacement {\n  /** The {@link SettingsDestination.ref} being placed. Refused at DEV startup when unknown. */\n  destinationRef: string;\n  /** Which category (rail group) this destination sits under. */\n  categoryRef: string;\n  /** Sort order within the category (lower = higher). */\n  order?: number;\n  /** Optional icon ref for the rail entry. */\n  icon?: string;\n  /** Rail label override. Omit to take `settings_hub.sections.<ref>.label`. */\n  label?: string;\n}\n/** @wildo_source:part:end saas.frontend.settings-hub.placement */\n\n/**\n * A settings section is one entry in the vertical rail (one `TabsTrigger`) —\n * the RESOLVED union of a {@link SettingsDestination} and the\n * {@link SettingsPlacement} that placed it.\n *\n * Produced by `resolveSettingsHubConfig()`; never authored directly. It\n * belongs to a category, addresses a target, and reuses the existing launcher\n * gating stack:\n * - `runtimeAvailability` — survives the app-shell filtering pass (capabilities).\n * - `requiredFeatures` — plan/subscription gating once resolved.\n * - `requiredRoles` — RBAC gating (e.g. org-admin-only sections).\n *\n * `ref` is the URL-addressable section id (`/settings/:sectionRef`).\n */\nexport interface SettingsSection {\n  /** Section reference — app-defined; the `/settings/:sectionRef` URL segment + Tabs `value`. */\n  ref: string;\n  /** Which category (rail group) this section sits under. */\n  categoryRef: string;\n  /** Rail label (i18n ref). */\n  label: string;\n  /** Optional icon ref for the rail entry. */\n  icon?: string;\n  /** Sort order within the category (lower = higher). */\n  order?: number;\n  /** What the section renders in its content panel. */\n  target: SettingsSectionTarget;\n  /** Declarative runtime capability gating (same contract as launcher items). */\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n  /**\n   * Feature flags required to surface this section (plan/subscription gating).\n   *\n   * Uses the framework-canonical {@link RequiredFeaturesConfig} contract shared\n   * with views and resource operations — shorthand `string[]` (OR semantics) or\n   * the full `{ features, mode: 'OR' | 'AND' }` form. `limitChecks` are not\n   * evaluated for section visibility (a section is shown or hidden, never\n   * \"over-limit\"); use {@link requiredRoles} / capabilities for hard gating.\n   */\n  requiredFeatures?: RequiredFeaturesConfig;\n  /**\n   * RBAC roles required to surface this section (OR semantics — the user needs\n   * ANY one of these roles). Evaluated against the merged app-level + current-\n   * organization role set, the same effective surface the rest of the frontend\n   * gating layer resolves (see `buildFeaturePolicyRoles`). Org-management\n   * sections gate on `[CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_ADMIN]`.\n   */\n  requiredRoles?: string[];\n  /**\n   * Optional CoreFeature id this section's content is ENTITLED by. Distinct from\n   * {@link requiredFeatures} (a HARD hide-gate): when set, the section still\n   * SURVIVES (per `runtimeAvailability`/roles) and its body is wrapped in a\n   * `FeatureGate` so an OFFERED-but-not-yet-entitled feature renders the\n   * policy-driven upgrade/add-on prompt (`unavailabilityPolicy`) instead of\n   * vanishing. Pair with a `runtimeAvailability.requiredCapabilities` gate whose\n   * capability is the plan-independent \"app offers X\" signal, so a feature the\n   * app does NOT offer at all is hidden outright while an offered one prompts.\n   */\n  entitlementFeatureId?: string;\n}\n\n// ════════════════════════════════════════════════════════════════\n// Hub Config — the registry root\n// ════════════════════════════════════════════════════════════════\n\n/** @wildo_source:part:start saas.frontend.settings-hub.placement */\n/**\n * The AUTHORED Settings Hub registry — an application's own settings rail.\n *\n * The framework ships destinations (`ENGINE_SETTINGS_DESTINATIONS`), never a\n * placed hub. This is the application's half: which categories exist, and which\n * destinations are placed where. `wildo init` scaffolds the full destination list\n * as placements so a new application starts complete and edits down.\n *\n * Resolve it with `resolveSettingsHubConfig()` to get the rendered\n * {@link SettingsSection} list; the render path never reads this shape directly.\n */\nexport interface SettingsHubConfig {\n  /** Rail groups, in render order (also orderable via `SettingsCategory.order`). */\n  categories: SettingsCategory[];\n  /**\n   * Every destination this application places, and where.\n   *\n   * A destination that appears in no placement does not render. That is\n   * deliberate: absence is how an application removes a settings section, and it\n   * must not be second-guessed by a merge against a framework default.\n   */\n  placements: SettingsPlacement[];\n  /**\n   * Section opened when the hub is launched without an explicit section\n   * (`/settings` with no `:sectionRef`). Falls back to the first section of the\n   * first category when omitted.\n   */\n  defaultSectionRef?: string;\n}\n\n/**\n * The RESOLVED hub — categories plus fully-resolved sections, ready to render.\n *\n * Distinct from {@link SettingsHubConfig} (what an application AUTHORS) because\n * conflating the two is what let a placed default ship from the engine. A\n * consumer that renders takes this; a consumer that configures takes the other.\n */\nexport interface ResolvedSettingsHubConfig {\n  categories: SettingsCategory[];\n  sections: SettingsSection[];\n  defaultSectionRef?: string;\n}\n/** @wildo_source:part:end saas.frontend.settings-hub.placement */\n"]}
+{"version":3,"file":"settings-hub.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/config/settings-hub.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,mEAAmE;AACnE,+DAA+D;AAC/D,mEAAmE;AAEnE;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,yBASX;AATD,WAAY,yBAAyB;IACnC,iEAAiE;IACjE,0DAA6B,CAAA;IAC7B,+FAA+F;IAC/F,sEAAyC,CAAA;IACzC,sFAAsF;IACtF,kEAAqC,CAAA;IACrC,0GAA0G;IAC1G,kDAAqB,CAAA;AACvB,CAAC,EATW,yBAAyB,KAAzB,yBAAyB,QASpC;AAED,mEAAmE;AACnE,6DAA6D;AAC7D,mEAAmE;AAEnE;;;;;;;;;;GAUG;AACH,MAAM,CAAN,IAAY,gBA0CX;AA1CD,WAAY,gBAAgB;IAC1B,wGAAwG;IACxG,yCAAqB,CAAA;IACrB,qEAAqE;IACrE,6CAAyB,CAAA;IACzB,oFAAoF;IACpF,+CAA2B,CAAA;IAC3B;;;;;;;;;;;OAWG;IACH,uCAAmB,CAAA;IACnB;;;;;;;;;;;OAWG;IACH,6DAAyC,CAAA;IACzC;;;;;;;OAOG;IACH,uFAAmE,CAAA;AACrE,CAAC,EA1CW,gBAAgB,KAAhB,gBAAgB,QA0C3B;AAgRD,kEAAkE","sourcesContent":["/**\n * Settings Hub — Declarative Section Registry\n *\n * The Settings Hub is the framework's single point of configuration: one overlay\n * surface that consolidates every settings destination (account, security,\n * appearance, organization, members, billing, …) behind a vertical `Tabs` rail\n * grouped by category. Many entry points (user dropdown, sidebar, command menu)\n * all converge on this one hub; links differ only by which section they pre-open.\n *\n * This file owns the **config-time** registry contract. It is declaration-first\n * and mirrors `launcher-items.frontend.schemas.ts`:\n * - `SettingsSectionTarget` is an interface-based discriminated union on `kind`\n *   (exactly like `LauncherItemRef`), because section targets are config-time\n *   descriptors resolved by the runtime — not Zod-validated wire payloads.\n * - The framework seeds a default `SettingsHubConfig`; apps merge/extend it\n *   (same model as the sidebar/launcher config).\n *\n * Runtime concerns live elsewhere:\n * - `NavigationContentType.SETTINGS_HUB` (navigation.schemas.ts) — what renders\n *   in the overlay zone.\n * - `SettingsHub` component (components/settings/) — resolves a section's target\n *   to a rendered panel.\n *\n * @see launcher-items.frontend.schemas.ts — the sibling launcher registry this mirrors\n * @see .claude/plans/unified-settings-hub.md — design + layer trace\n */\n\nimport { ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport type { RequiredFeaturesConfig } from '@wildo-ai/saas-models';\nimport type { LauncherRuntimeAvailabilityConfig } from './launcher-items.frontend.schemas';\n\n// ════════════════════════════════════════════════════════════════\n// Section Target Kind — discriminant for SettingsSectionTarget\n// ════════════════════════════════════════════════════════════════\n\n/**\n * What a settings section renders in its content panel.\n *\n * Discriminant for the `SettingsSectionTarget` union. The default for\n * data-backed settings is `RESOURCE_OPERATION` (reuse the auto-rendered\n * resource surface); `ENGINE_PANEL` is reserved for the few sections whose\n * bespoke layout earns it (Security, Appearance).\n */\nexport enum SettingsSectionTargetKind {\n  /** A framework-owned bespoke panel (Security, Appearance, …). */\n  ENGINE_PANEL = 'engine_panel',\n  /** An auto-rendered resource-operation surface (members, API tokens, billing, preferences). */\n  RESOURCE_OPERATION = 'resource_operation',\n  /** An app-registered custom React component (resolved via the component registry). */\n  CUSTOM_COMPONENT = 'custom_component',\n  /** A section that itself splits into horizontal sub-tabs (e.g. Teams → Members / Roles & Permissions). */\n  SUB_TABS = 'sub_tabs',\n}\n\n// ════════════════════════════════════════════════════════════════\n// Engine Panel Ref — framework-owned bespoke settings panels\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Framework-provided settings panels with bespoke (non-CRUD) layout.\n *\n * Closed enum — only framework panels belong here. Most settings sections should\n * be `RESOURCE_OPERATION` targets instead; a panel earns a slot here only when a\n * standard resource surface cannot express it (multi-factor enrollment flows,\n * theme/dark-mode toggles, …).\n *\n * The runtime maps each ref to a registered panel component in the\n * `SettingsHub` resolver.\n */\nexport enum SettingsPanelRef {\n  /** Password, MFA enrollment, passkeys, identity links (wraps the former `AppPage_SecuritySettings`). */\n  SECURITY = 'security',\n  /** Theme, dark-mode, density and other look-and-feel preferences. */\n  APPEARANCE = 'appearance',\n  /** The caller's own pending org invitations — accept/reject in-app (Approach P). */\n  INVITATIONS = 'invitations',\n  /**\n   * The billing home: subscription status, plan catalog + checkout, usage,\n   * invoices and the provider portal link — composed from the BillingContext\n   * aggregated state (`GET_STATE`), NOT from per-resource LIST surfaces.\n   *\n   * Bespoke on purpose: the billing child resources (subscriptions, invoice\n   * refs, usage records) are routed UNDER the billing account\n   * (`REQUIRES_CONTEXT`), so a generic org-scoped `RESOURCE_OPERATION` panel\n   * cannot build their URLs. The aggregated billing state is org-addressable\n   * and auto-creates the account, which makes it the correct settings-surface\n   * data source.\n   */\n  BILLING = 'billing',\n  /**\n   * Where a person CONNECTS one of their own third-party accounts.\n   *\n   * Bespoke because connecting is not a row somebody creates: it is a flow that leaves the\n   * application, obtains consent at a vendor, and returns with a grant nobody typed. The generic\n   * resource surface can list, inspect and delete the resulting credentials perfectly — it simply has\n   * no mechanism for an ACTION of that shape, which is why the whole outbound-authorization lane had\n   * no surface that could begin it until this existed.\n   *\n   * Paired with, never replacing, the credential list: this panel answers what MAY be connected and\n   * the list answers what IS, and the empty answer to the second is exactly when the first matters.\n   */\n  CONNECTED_ACCOUNTS = 'connected-accounts',\n  /**\n   * The same act at the TENANT's scope: connecting an account the whole organization acts as.\n   *\n   * A distinct ref rather than a parameterised one, because a settings destination resolves a ref to\n   * a panel and carries no arguments — and because the two must never be reachable from each other's\n   * screen. The component behind them IS shared: the act is identical, and duplicating it would\n   * guarantee the two drift. What is never shared is the data.\n   */\n  ORGANIZATION_CONNECTED_ACCOUNTS = 'organization-connected-accounts',\n}\n\n// ════════════════════════════════════════════════════════════════\n// Section Target — discriminated union on `kind`\n// ════════════════════════════════════════════════════════════════\n\n/** Renders a framework-owned bespoke panel. */\nexport interface SettingsEnginePanelTarget {\n  kind: SettingsSectionTargetKind.ENGINE_PANEL;\n  panelRef: SettingsPanelRef;\n}\n\n/**\n * Renders an auto-generated resource-operation surface inside the section panel.\n * Resolved against the resource registry exactly like a launcher\n * `RESOURCE_OPERATION` target.\n */\nexport interface SettingsResourceOperationTarget {\n  kind: SettingsSectionTargetKind.RESOURCE_OPERATION;\n  resourceType: string;\n  operation: string;\n  operationVariant?: string;\n}\n\n/** Renders an app-registered custom React component (resolved by `componentRef`). */\nexport interface SettingsCustomComponentTarget {\n  kind: SettingsSectionTargetKind.CUSTOM_COMPONENT;\n  componentRef: string;\n}\n\n/**\n * Leaf targets renderable directly in a panel. Sub-tabs may only point at leaf\n * targets — sub-tabs cannot nest further sub-tabs (one level of in-section\n * tabbing, matching the BetterStack reference).\n */\nexport type SettingsLeafTarget =\n  | SettingsEnginePanelTarget\n  | SettingsResourceOperationTarget\n  | SettingsCustomComponentTarget;\n\n/**\n * One horizontal sub-tab within a section (e.g. the \"Members\" / \"Roles &\n * Permissions\" tabs inside a Teams section).\n */\nexport interface SettingsSubTab {\n  /** Sub-tab reference — app-defined, used for i18n + the `value` of the inner Tabs. */\n  ref: string;\n  /** Display label (i18n ref). */\n  label: string;\n  /** Optional icon ref for the sub-tab trigger. */\n  icon?: string;\n  /** What this sub-tab renders. Sub-tabs hold leaf targets only. */\n  target: SettingsLeafTarget;\n}\n\n/** Splits a section into horizontal sub-tabs rendered above the panel content. */\nexport interface SettingsSubTabsTarget {\n  kind: SettingsSectionTargetKind.SUB_TABS;\n  subTabs: SettingsSubTab[];\n}\n\n/**\n * What a settings section renders. Discriminated on `kind`; the `SettingsHub`\n * resolver dispatches on it to produce the panel content.\n */\nexport type SettingsSectionTarget = SettingsLeafTarget | SettingsSubTabsTarget;\n\n// ════════════════════════════════════════════════════════════════\n// Category — the rail group\n// ════════════════════════════════════════════════════════════════\n\n/**\n * A category groups sections in the vertical rail (the `Account` / `Organization`\n * group headers in the BetterStack reference). Rendered as a label + separator\n * inside the `TabsList` — NOT a separate nav widget (the `Tabs` primitive stays\n * the section mechanism).\n *\n * `scope` ties the category to a primary-scope axis so the runtime can hide it\n * when the scope is unavailable — e.g. an `ORGANIZATIONS` category is hidden when\n * no organization is selected. It is derived against `AppScope`, not authored\n * per-user.\n */\nexport interface SettingsCategory {\n  /** Category reference — app-defined, referenced by `SettingsSection.categoryRef`. */\n  ref: string;\n  /** Group header label (i18n ref). */\n  label: string;\n  /**\n   * Primary scope this category belongs to. Drives rail grouping order and\n   * scope-gated visibility (org categories hide when no org is selected).\n   * Omit for a scope-agnostic category.\n   */\n  scope?: ResourcePrimaryScope;\n  /** Optional icon ref for the group header. */\n  icon?: string;\n  /** Sort order among categories in the rail (lower = higher). */\n  order?: number;\n}\n\n// ════════════════════════════════════════════════════════════════\n// Section — one vertical tab in the rail\n// ════════════════════════════════════════════════════════════════\n\n/** @wildo_source:part:start saas.frontend.settings-hub.placement facet:layer:frontend facet:family:config facet:audience:app-developer */\n/**\n * An addressable settings DESTINATION — what a settings surface *is*, with no\n * opinion on where it appears.\n *\n * This is the half the engine ships (`ENGINE_SETTINGS_DESTINATIONS`). It carries\n * the target and the gating stack, and deliberately carries **no `categoryRef`,\n * no `order` and no `label`**: those are placement, and placement is the\n * application's decision (`SettingsPlacement`).\n *\n * The split exists because the engine shipping a PLACED hub is what made the\n * settings rail unauthorable — an application could not add, remove, reorder or\n * rename a section without the framework agreeing. Splitting destination from\n * placement lets the engine keep owning what a destination MEANS (its target,\n * its roles, its entitlement) while the application owns where it sits.\n */\nexport interface SettingsDestination {\n  /** Destination reference — the `/settings/:sectionRef` URL segment and the id a placement names. */\n  ref: string;\n  /** What the destination renders in its content panel. */\n  target: SettingsSectionTarget;\n  /** Declarative runtime capability gating (same contract as launcher items). */\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n  /** Feature flags required to surface this destination (plan/subscription gating). */\n  requiredFeatures?: RequiredFeaturesConfig;\n  /** RBAC roles required to surface this destination (OR semantics). */\n  requiredRoles?: string[];\n  /** Optional CoreFeature id this destination's content is ENTITLED by (soft gate — renders an upgrade prompt). */\n  entitlementFeatureId?: string;\n}\n\n/**\n * An application's explicit PLACEMENT of one destination in its settings rail.\n *\n * Authored in the application's own config. Nothing is placed implicitly: a\n * destination the application does not place does not render, which is the whole\n * point — \"we should just place things\", with no automatic inference.\n *\n * `label` is optional and is an OVERRIDE. The resolved label otherwise comes from\n * the `settings_hub.sections.<ref>.label` key, so a placed section is localizable\n * without the application authoring an English string.\n *\n * That namespace and its resolver (`tSettingsHubSection`) EXIST and already fall\n * back to the authored label. What does not exist is anything that generates the\n * units: `LabellingTypes.SETTINGS_HUB` is declared with an empty pattern and the\n * companion plans nothing for it, so today every rail label is the authored\n * English string. R9 is a wiring job, not a new mechanism.\n */\nexport interface SettingsPlacement {\n  /** The {@link SettingsDestination.ref} being placed. Refused at DEV startup when unknown. */\n  destinationRef: string;\n  /** Which category (rail group) this destination sits under. */\n  categoryRef: string;\n  /** Sort order within the category (lower = higher). */\n  order?: number;\n  /** Optional icon ref for the rail entry. */\n  icon?: string;\n  /** Rail label override. Omit to take `settings_hub.sections.<ref>.label`. */\n  label?: string;\n}\n/** @wildo_source:part:end saas.frontend.settings-hub.placement */\n\n/**\n * A settings section is one entry in the vertical rail (one `TabsTrigger`) —\n * the RESOLVED union of a {@link SettingsDestination} and the\n * {@link SettingsPlacement} that placed it.\n *\n * Produced by `resolveSettingsHubConfig()`; never authored directly. It\n * belongs to a category, addresses a target, and reuses the existing launcher\n * gating stack:\n * - `runtimeAvailability` — survives the app-shell filtering pass (capabilities).\n * - `requiredFeatures` — plan/subscription gating once resolved.\n * - `requiredRoles` — RBAC gating (e.g. org-admin-only sections).\n *\n * `ref` is the URL-addressable section id (`/settings/:sectionRef`).\n */\nexport interface SettingsSection {\n  /** Section reference — app-defined; the `/settings/:sectionRef` URL segment + Tabs `value`. */\n  ref: string;\n  /** Which category (rail group) this section sits under. */\n  categoryRef: string;\n  /** Rail label (i18n ref). */\n  label: string;\n  /** Optional icon ref for the rail entry. */\n  icon?: string;\n  /** Sort order within the category (lower = higher). */\n  order?: number;\n  /** What the section renders in its content panel. */\n  target: SettingsSectionTarget;\n  /** Declarative runtime capability gating (same contract as launcher items). */\n  runtimeAvailability?: LauncherRuntimeAvailabilityConfig;\n  /**\n   * Feature flags required to surface this section (plan/subscription gating).\n   *\n   * Uses the framework-canonical {@link RequiredFeaturesConfig} contract shared\n   * with views and resource operations — shorthand `string[]` (OR semantics) or\n   * the full `{ features, mode: 'OR' | 'AND' }` form. `limitChecks` are not\n   * evaluated for section visibility (a section is shown or hidden, never\n   * \"over-limit\"); use {@link requiredRoles} / capabilities for hard gating.\n   */\n  requiredFeatures?: RequiredFeaturesConfig;\n  /**\n   * RBAC roles required to surface this section (OR semantics — the user needs\n   * ANY one of these roles). Evaluated against the merged app-level + current-\n   * organization role set, the same effective surface the rest of the frontend\n   * gating layer resolves (see `buildFeaturePolicyRoles`). Org-management\n   * sections gate on `[CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_ADMIN]`.\n   */\n  requiredRoles?: string[];\n  /**\n   * Optional CoreFeature id this section's content is ENTITLED by. Distinct from\n   * {@link requiredFeatures} (a HARD hide-gate): when set, the section still\n   * SURVIVES (per `runtimeAvailability`/roles) and its body is wrapped in a\n   * `FeatureGate` so an OFFERED-but-not-yet-entitled feature renders the\n   * policy-driven upgrade/add-on prompt (`unavailabilityPolicy`) instead of\n   * vanishing. Pair with a `runtimeAvailability.requiredCapabilities` gate whose\n   * capability is the plan-independent \"app offers X\" signal, so a feature the\n   * app does NOT offer at all is hidden outright while an offered one prompts.\n   */\n  entitlementFeatureId?: string;\n}\n\n// ════════════════════════════════════════════════════════════════\n// Hub Config — the registry root\n// ════════════════════════════════════════════════════════════════\n\n/** @wildo_source:part:start saas.frontend.settings-hub.placement */\n/**\n * The AUTHORED Settings Hub registry — an application's own settings rail.\n *\n * The framework ships destinations (`ENGINE_SETTINGS_DESTINATIONS`), never a\n * placed hub. This is the application's half: which categories exist, and which\n * destinations are placed where. `wildo init` scaffolds the full destination list\n * as placements so a new application starts complete and edits down.\n *\n * Resolve it with `resolveSettingsHubConfig()` to get the rendered\n * {@link SettingsSection} list; the render path never reads this shape directly.\n */\nexport interface SettingsHubConfig {\n  /** Rail groups, in render order (also orderable via `SettingsCategory.order`). */\n  categories: SettingsCategory[];\n  /**\n   * Every destination this application places, and where.\n   *\n   * A destination that appears in no placement does not render. That is\n   * deliberate: absence is how an application removes a settings section, and it\n   * must not be second-guessed by a merge against a framework default.\n   */\n  placements: SettingsPlacement[];\n  /**\n   * Section opened when the hub is launched without an explicit section\n   * (`/settings` with no `:sectionRef`). Falls back to the first section of the\n   * first category when omitted.\n   */\n  defaultSectionRef?: string;\n}\n\n/**\n * The RESOLVED hub — categories plus fully-resolved sections, ready to render.\n *\n * Distinct from {@link SettingsHubConfig} (what an application AUTHORS) because\n * conflating the two is what let a placed default ship from the engine. A\n * consumer that renders takes this; a consumer that configures takes the other.\n */\nexport interface ResolvedSettingsHubConfig {\n  categories: SettingsCategory[];\n  sections: SettingsSection[];\n  defaultSectionRef?: string;\n}\n/** @wildo_source:part:end saas.frontend.settings-hub.placement */\n"]}