@wildo-ai/saas-frontend-lib 1.0.1 → 1.1.1

package/dist/esm/core/config/launcher-items.frontend.schemas.d.ts

@@ -18,10 +18,11 @@
  * @see component-taxonomy-deep-review.md §3.5
  */
 import { z } from 'zod';
-import { SidebarItemDisplayPolicy, CommandMenuDisplayPolicy, QuickActionDisplayPolicy, HotkeyScope } from './app-level-components.frontend.schemas.js';
-import { HorizontalPlacement } from '@wildo-ai/presets-components-models';
-import { ViewportBreakpoint } from '@wildo-ai/zod-decorators';
-import type { AppScopeValue } from '../../core/scope/scope.frontend.schemas.js';
+import { SidebarItemDisplayPolicy, CommandMenuDisplayPolicy, QuickActionDisplayPolicy, HotkeyScope } from './app-level-components.frontend.schemas';
+import { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';
+import { ViewportBreakpoint, ForeignKeyDisplayMode } from '@wildo-ai/zod-decorators';
+import { StandardIconReference } from '../../core/icons/icon-registry.frontend.schemas';
+import type { AppScopeValue } from '../../core/scope/scope.frontend.schemas';
 /**
  * What kind of target a launcher item points to.
  *
@@ -43,7 +44,9 @@ export declare enum LauncherItemTargetKind {
     /** Navigate to a framework-provided page (home, security settings, etc.). */
     ENGINE_PAGE = "engine_page",
     /** Render a custom registered React component. */
-    CUSTOM_COMPONENT = "custom_component"
+    CUSTOM_COMPONENT = "custom_component",
+    /** Open the unified Settings Hub (overlay), optionally at a specific section. */
+    SETTINGS_SECTION = "settings_section"
 }
 /**
  * Framework-provided navigable pages.
@@ -57,18 +60,33 @@ export declare enum LauncherItemTargetKind {
  */
 export declare enum EnginePageRef {
     /** Home page — maps to `CommonRoutePaths.home` (`/`) */
-    HOME = "home",
-    /** Security settings page — maps to `CommonRoutePaths.securitySettings` (`/settings/security`) */
-    SECURITY_SETTINGS = "security_settings"
+    HOME = "home"
 }
 /**
- * Canonical mapping from `EnginePageRef` to route paths.
+ * Per-engine-page metadata: route, i18n label key, standard icon.
+ *
+ * Single source of truth — consumed by:
+ * - `launcher-resolution.ts` (route + label + icon for resolved engine pages)
+ * - `verify-launcher-content.ts` (pageRef existence check)
+ * - `useNavigationBehaviors.ts` (home route lookup)
+ * - companion `planEnginePageUnits()` (label-key generation)
  *
- * Single source of truth — consumed by both the resolution layer
- * (`launcher-resolution.ts`) and the verification layer
- * (`verify-launcher-content.ts`).
+ * Adding a new engine page = adding the `EnginePageRef` enum entry above
+ * + one record entry here. No other touch-up needed.
  */
-export declare const ENGINE_PAGE_ROUTES: Record<EnginePageRef, string>;
+export interface EnginePageMetadata {
+    /** Route path under the app. */
+    route: string;
+    /**
+     * i18n key used to resolve the page's display label at
+     * `engine.pages.<key>.title` (the companion's `planEnginePageUnits()`
+     * emits matching keys for label generation).
+     */
+    i18nKey: string;
+    /** Standard icon to render for navigation entries pointing at this page. */
+    icon: StandardIconReference;
+}
+export declare const ENGINE_PAGE_METADATA: Record<EnginePageRef, EnginePageMetadata>;
 /**
  * How the Activity Bar renders at different breakpoints.
  *
@@ -99,10 +117,60 @@ export declare enum SidebarResponsivePolicy {
     /** Sidebar stays visible but auto-expands on desktop. */
     DRAWER = "DRAWER"
 }
-/** Sidebar section behavior mode. */
+/**
+ * How the sidebar surfaces the application's HOME destination.
+ *
+ * Three mutually-exclusive presentations of ONE concept — an app picks the one
+ * matching its shell identity, and the framework never renders two home
+ * affordances at once.
+ */
+export declare enum SidebarHomeDisplayMode {
+    /**
+     * No home affordance in the sidebar at all. For apps whose home is reached
+     * elsewhere (a menubar brand, a logo in the shell header) or that have no
+     * meaningful home surface.
+     */
+    HIDDEN = "hidden",
+    /**
+     * The application's brand header: its SYMBOL brand asset plus the application
+     * display name, PINNED at the very top of the sidebar — above the scroll
+     * region and therefore above any hosted component (e.g. the command-menu
+     * search trigger). Clicking it navigates home. This is the Slack / Linear /
+     * Notion shell convention: the product identity doubles as the home button,
+     * so no separate "Home" row is needed. Collapsed to the icon rail it shows
+     * the symbol alone.
+     *
+     * The logo resolves from the app's `brandAssets` (see `RuntimeBrandAsset` /
+     * `resolveBrandAsset` in `@wildo-ai/saas-models`) for the active light/dark
+     * theme; an app with no generated brand shows the name alone (and the
+     * framework home icon on the collapsed rail).
+     */
+    BRAND_HEADER = "brand_header",
+    /**
+     * A "Home" navigation ROW at the top of the primary navigation group, beside
+     * the app's other top-level destinations. The framework default — it assumes
+     * nothing about brand assets.
+     */
+    NAVIGATION_ITEM = "navigation_item"
+}
+/** Sidebar section behavior mode — where a section's ITEMS come from. */
 export declare enum SidebarSectionBehavior {
+    /** Items are exactly the declared `children`. */
     STATIC = "static",
+    /** Items are produced at runtime by the section's content kind. */
     DYNAMIC = "dynamic",
+    /**
+     * Items are the USER'S FAVORITED navigation items: the engine populates the
+     * section from starred items across the other navigation-list sections
+     * (persisted machine-locally under `LOCAL_STORAGE_KEYS.SIDEBAR_FAVORITES`),
+     * REPLACING any declared `children` — author none. Declaring a FAVORITES
+     * section is what enables the hover-star affordance on sidebar rows; the
+     * section is hidden entirely while no favorites exist, and the engine
+     * ordering policy places it right after the primary group. Declare at most
+     * ONE favorites section: several would render the same favorited copies
+     * (same ids) in each, and the active-row election would highlight one row
+     * per duplicate id.
+     */
     FAVORITES = "favorites"
 }
 /** Sidebar section inline create mode. */
@@ -173,6 +241,17 @@ export interface CustomComponentItemRef {
     kind: LauncherItemTargetKind.CUSTOM_COMPONENT;
     componentRef: string;
 }
+/**
+ * Opens the unified Settings Hub (overlay), optionally pre-selecting a section.
+ * Resolves to a `/settings` / `/settings/:sectionRef` URL navigation — the hub
+ * is URL-driven (`useSettingsHubRouterSync` reconstructs it), so every settings
+ * entry point converges on one destination.
+ */
+export interface SettingsSectionItemRef {
+    kind: LauncherItemTargetKind.SETTINGS_SECTION;
+    /** Section to pre-open; omit to open the hub's default section. */
+    sectionRef?: string;
+}
 /**
  * A launcher item reference — identifies WHAT a launcher item targets.
  * Discriminated on `kind`. The resolution layer dispatches on this to
@@ -180,7 +259,7 @@ export interface CustomComponentItemRef {
  *
  * @see launcher-operation-binding-analysis.md §3.2
  */
-export type LauncherItemRef = ResourceOperationItemRef | ViewItemRef | ResourceViewItemRef | EnginePageItemRef | CustomComponentItemRef;
+export type LauncherItemRef = ResourceOperationItemRef | ViewItemRef | ResourceViewItemRef | EnginePageItemRef | CustomComponentItemRef | SettingsSectionItemRef;
 /**
  * Toolbar items are navigation-only launcher refs.
  * Custom-component materialization belongs to other app-level surfaces and is
@@ -193,7 +272,14 @@ export type ToolbarItemRef = ResourceOperationItemRef | ViewItemRef | ResourceVi
  */
 export type SidebarItem = LauncherItemRef & {
     displayPolicy?: SidebarItemDisplayPolicy;
-    badgeReference?: string;
+    /**
+     * Typed reference to a registered `NotificationBadgeDefinition` (its
+     * `identifier`). Unlike the retired free-string `badgeReference`, this resolves
+     * against the app's `notificationBadgeDefinitions` — the resolved definition
+     * supplies the display mode / tone / pulse, and the live count comes from
+     * `useNotificationBadges`. Validated in `verify-launcher-content`.
+     */
+    notificationBadgeRef?: string;
     children?: SidebarItem[];
     runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
 };
@@ -201,10 +287,104 @@ export type SidebarItem = LauncherItemRef & {
 export type CommandMenuCommand = LauncherItemRef & {
     category?: string;
     shortcut?: string;
+    /**
+     * OPTIONAL extra literal match terms, appended to the localized keyword set
+     * the palette already resolves for this command. These literals are NOT
+     * translated — reserve them for genuinely app-specific jargon that no
+     * localized label or operation-verb synonym covers (e.g. an internal codename
+     * like `"boards"` for a Todo-Lists list command).
+     *
+     * You do NOT need to author generic action verbs here: for a
+     * `RESOURCE_OPERATION` command the framework already folds in the LOCALIZED
+     * operation-verb synonyms (`components.APPLICATION_LEVEL_COMMAND_MENU.keywords*`,
+     * generated + translated by the labelling pipeline) keyed off the command's
+     * core operation semantic, and the record/command noun is covered by the
+     * command's already-localized label. So a French user finds "Create Todo" by
+     * typing "nouveau"/"créer" without any literal being authored here.
+     */
     searchKeywords?: string[];
     displayPolicy?: CommandMenuDisplayPolicy;
     runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
 };
+/**
+ * @wildo_source:part:start saas.frontend.command-menu.search-resource facet:layer:frontend facet:family:app-shell
+ *
+ * Declares one resource whose `SEARCH` operation feeds the command menu's
+ * **omnibox** record-search layer. Import from `@wildo-ai/saas-frontend-lib`.
+ *
+ * You list these on the `[ApplicationLevelComponentType.COMMAND_MENU]`
+ * config's `searchResources` array (in `frontend/src/config/app-shell.config.ts`);
+ * they take effect **only** when that config also sets
+ * `policy: CommandBarPolicy.OMNIBOX`. Each entry opts one resource into live,
+ * debounced record search inside the Cmd+K palette.
+ *
+ * Unlike a {@link CommandMenuCommand} — a static, declarative navigation target
+ * — this drives a live, debounced query (≥2 chars, 300ms) against the
+ * resource's addressable `SEARCH` operation (falling back to `LIST`). Results
+ * are labelled with the resource's own frontend label config and, on
+ * selection, navigate to the record's addressable `READ` view. Name the
+ * searchable set explicitly so the palette never fires queries against
+ * resources the app did not opt in.
+ *
+ * @example
+ * // In frontend/src/config/app-shell.config.ts, on [COMMAND_MENU]:
+ * searchResources: [
+ *   { resourceType: 'todos', category: 'todos', maxResults: 5 },
+ *   { resourceType: 'tasks', category: 'tasks', maxResults: 5 },
+ * ]
+ */
+export type CommandMenuSearchResource = {
+    /** Resource type whose SEARCH operation is queried (e.g. `'todos'`). */
+    resourceType: string;
+    /**
+     * Group/category ref the results are placed under in the palette. Defaults
+     * to the `resourceType` (humanized) when omitted. Resolved through the same
+     * i18n category-label path as static command categories.
+     */
+    category?: string;
+    /** Max results fetched per resource per keystroke. Defaults to 5. */
+    maxResults?: number;
+    /**
+     * Relative order weight of this record group in the palette result list —
+     * lower renders higher. This is the SINGLE ordering axis the palette sorts
+     * every group (record groups AND static command-category groups) by.
+     *
+     * When omitted, record groups default to a weight ABOVE the static command
+     * groups, so live record matches surface FIRST while the user is searching —
+     * `searchResources` array position breaks ties among record groups. Static
+     * command categories sit on a higher (later) default band, sequenced among
+     * themselves by `[COMMAND_MENU].categoryOrder`. Set an explicit `order` to
+     * pin a record group anywhere in that merged list (e.g. a large value to push
+     * a low-signal resource below the command groups, or a negative value to pin
+     * it at the very top).
+     */
+    order?: number;
+    /**
+     * How each matched record renders in the palette:
+     * - `SUMMARY` (default) — the resource's summary VIEW (its summary card, no
+     *   action bar), via `ResourceSummaryDisplayer`. Reuses the SUMMARY-mode DTO
+     *   the `SEARCH` operation already returns, so there is no extra fetch. This
+     *   is the richer, default representation.
+     * - `LABEL` — a single-line resolved label (opt-out / compact fallback).
+     *
+     * `ID` is treated as `LABEL` here (there is no id-only palette row).
+     * Reuses {@link ForeignKeyDisplayMode} — the same LABEL-vs-SUMMARY vocabulary
+     * the foreign-key reference picker uses for its dropdown rows — rather than
+     * inventing a parallel command-menu-only enum.
+     */
+    resultDisplay?: ForeignKeyDisplayMode;
+    /**
+     * OPTIONAL extra literal match terms appended to every result of this
+     * resource for client-side fuzzy matching. NOT translated — the raw query is
+     * always kept as a keyword (so server hits never drop) and the framework also
+     * folds in the LOCALIZED "search" verb synonyms
+     * (`components.APPLICATION_LEVEL_COMMAND_MENU.keywordsSearch`) for the group.
+     * Reserve this field for app-specific jargon a localized label/synonym cannot
+     * cover.
+     */
+    searchKeywords?: string[];
+};
+/** @wildo_source:part:end saas.frontend.command-menu.search-resource */
 /** A quick action button entry. */
 export type QuickActionItem = LauncherItemRef & {
     displayPolicy?: QuickActionDisplayPolicy;
@@ -226,7 +406,6 @@ export type HotkeyBinding = LauncherItemRef & {
 /** A toolbar item. */
 export type ToolbarItem = ToolbarItemRef & {
     group?: string;
-    badgeReference?: string;
     /** When true, only the icon is shown (label is hidden). */
     iconOnly?: boolean;
     runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
@@ -234,7 +413,6 @@ export type ToolbarItem = ToolbarItemRef & {
 /** A control panel item. */
 export type ControlPanelItem = LauncherItemRef & {
     section?: string;
-    badgeReference?: string;
     runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
 };
 /** A utility panel item (Gmail-style right-side panel). */
@@ -245,18 +423,126 @@ export interface UtilityPanelItem {
     label: string;
 }
 /**
- * A component hosted in the menubar (container inversion).
- * `placement` determines which zone (START/END/MIDDLE) the component renders in.
- * `breakpoint` restricts the component to a specific viewport breakpoint.
- * Render order follows array position in `hostedComponents`.
+ * How a hosted component's TRIGGER renders inside its host surface.
+ *
+ * The same trigger serves two very different chrome shapes: a menubar's
+ * trailing cluster is a row of small icon controls, while a sidebar rail (or a
+ * wide top bar) can carry a full input-like control. Declaring the appearance
+ * keeps that a per-PLACEMENT decision rather than a component-wide compromise —
+ * this application hosts the identical command menu in both surfaces.
+ */
+export declare enum HostedTriggerAppearance {
+    /**
+     * Full input-like "false button": leading glyph, placeholder text and the
+     * shortcut hint. Honors `triggerWidth`. Default.
+     */
+    EXPANDED = "expanded",
+    /**
+     * Square icon-only button sized to the chrome row — what belongs beside the
+     * notification bell and the avatar. `triggerWidth` is deliberately IGNORED
+     * here: a 240px icon button is dead space, not a wide control.
+     */
+    COMPACT = "compact"
+}
+/**
+ * @wildo_source:part:start saas.frontend.app-shell.hosted-components facet:layer:frontend facet:family:app-shell
+ *
+ * Hosts an app-level component (the Cmd+K command-menu trigger, a quick-action
+ * button, the notification center, …) INSIDE the menubar via container
+ * inversion. Import from `@wildo-ai/saas-frontend-lib`.
+ *
+ * You list these on the `[ApplicationLevelComponentType.MENUBAR]` config's
+ * `hostedComponents` array (in `frontend/src/config/app-shell.config.ts`).
+ * `componentType` is an `ApplicationLevelComponentType.*` member; `placement`
+ * is a {@link HorizontalPlacement} (`START`/`MIDDLE`/`END`) selecting the
+ * menubar zone; `breakpoint` restricts the component to one viewport
+ * breakpoint. Render order follows array position in `hostedComponents`.
+ *
+ * The sidebar is the vertical mirror of this contract — see
+ * {@link SidebarHostedComponent}. Both surfaces share ONE hosting pipeline, so
+ * hosting the SAME component (e.g. the command menu) in both places yields two
+ * triggers driving one shared dialog / one hotkey registration, never two.
+ *
+ * @example
+ * // In frontend/src/config/app-shell.config.ts, on [MENUBAR]:
+ * hostedComponents: [
+ *   { componentType: ApplicationLevelComponentType.COMMAND_MENU,
+ *     placement: HorizontalPlacement.START, triggerWidth: 240 },
+ *   { componentType: ApplicationLevelComponentType.USER_DROPDOWN,
+ *     placement: HorizontalPlacement.END },
+ * ]
  */
 export interface MenubarHostedComponent {
     componentType: string;
+    /** Which menubar zone the component renders in. Defaults to `START`. */
     placement?: HorizontalPlacement;
     breakpoint?: ViewportBreakpoint;
     /** Override the preset name used for component resolution. Defaults to `CorePresetNames.DEFAULT`. */
     presetName?: string;
+    /**
+     * Per-placement width override for hosted components that render an
+     * input-like trigger (today: the command-menu "false button"). Accepts an
+     * explicit CSS length — a plain number is treated as pixels (`240` → 240px),
+     * or a CSS width string (`'240px'`, `'100%'`, `'16rem'`). Applied as an
+     * inline `style.width` because tailwind-merge cannot override the trigger's
+     * default width utility. Omit to use the component's built-in default width.
+     */
+    triggerWidth?: string | number;
+    /**
+     * How the trigger renders here — see {@link HostedTriggerAppearance}.
+     * Defaults to `EXPANDED`. A menubar's trailing cluster normally wants
+     * `COMPACT`, so the control is an icon button beside the bell and the avatar;
+     * a sidebar rail keeps the full input-like control. `triggerWidth` above is
+     * ignored under `COMPACT`.
+     */
+    triggerAppearance?: HostedTriggerAppearance;
 }
+/**
+ * Hosts an app-level component INSIDE the sidebar (container inversion — the
+ * vertical mirror of {@link MenubarHostedComponent}). Import from
+ * `@wildo-ai/saas-frontend-lib`.
+ *
+ * You list these on the `[ApplicationLevelComponentType.SIDEBAR]` config's
+ * `hostedComponents` array. Both surfaces share ONE hosting pipeline
+ * (`resolveHostedComponents` + the shell-level interaction owner); the only
+ * difference is the placement axis: the sidebar is a vertical column, so
+ * `placement` is a {@link VerticalPlacement} (`TOP` renders above the nav,
+ * `BOTTOM` below it) rather than the menubar's horizontal axis. `breakpoint`
+ * restricts the component to a viewport breakpoint; render order follows array
+ * position in `hostedComponents`.
+ *
+ * @example
+ * // In frontend/src/config/app-shell.config.ts, on [SIDEBAR] — the same command
+ * // menu ALSO placed in the sidebar, filling the rail width:
+ * hostedComponents: [
+ *   { componentType: ApplicationLevelComponentType.COMMAND_MENU,
+ *     placement: VerticalPlacement.TOP, triggerWidth: '100%' },
+ * ]
+ */
+export interface SidebarHostedComponent {
+    componentType: string;
+    /** Which end of the sidebar column the component renders at. Defaults to `TOP`. */
+    placement?: VerticalPlacement;
+    breakpoint?: ViewportBreakpoint;
+    /** Override the preset name used for component resolution. Defaults to `CorePresetNames.DEFAULT`. */
+    presetName?: string;
+    /**
+     * Per-placement width override for the hosted trigger (see
+     * {@link MenubarHostedComponent.triggerWidth} — number = px, or a CSS width
+     * string). A sidebar trigger commonly uses `'100%'` to fill the rail; the
+     * menubar copy is typically narrower.
+     */
+    triggerWidth?: string | number;
+    /**
+     * How the trigger renders here — see {@link HostedTriggerAppearance}.
+     * Defaults to `EXPANDED`. A menubar's trailing cluster normally wants
+     * `COMPACT`, so the control is an icon button beside the bell and the avatar;
+     * a sidebar rail keeps the full input-like control. `triggerWidth` above is
+     * ignored under `COMPACT`.
+     */
+    triggerAppearance?: HostedTriggerAppearance;
+}
+/** @wildo_source:part:end saas.frontend.app-shell.hosted-components */
 /** A menubar-specific launcher item (config-time declaration). */
 export type MenubarLauncherItem = LauncherItemRef & {
     group?: string;
@@ -277,7 +563,7 @@ export interface LauncherRuntimeAvailabilityConfig {
 }
 export declare const LauncherRuntimeAvailabilityConfigSchema: z.ZodObject<{
     requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 /**
  * Parameters passed to a `ScopeConditionFn` for evaluating section visibility.
  *
@@ -367,6 +653,24 @@ export interface SidebarSection_NavigationList extends SidebarSectionBase {
     contentKind: SidebarSectionContentKind.NAVIGATION_LIST;
     children: SidebarItem[];
     behavior?: SidebarSectionBehavior;
+    /**
+     * Marks this section as the sidebar's PRIMARY navigation group — the app's
+     * top-level destinations (the "Home group"). Primary sections render at the
+     * top of the sidebar with no section header and never collapsible. When
+     * `SIDEBAR.homeDisplayMode` is `NAVIGATION_ITEM` (the default) the framework's
+     * Home row heads that same group, giving the Linear/Notion "Inbox / My Issues
+     * right under Home" shape; the other home modes surface home elsewhere and
+     * leave this group to the app's own destinations.
+     *
+     * This is a PLACEMENT/CHROME role, deliberately distinct from
+     * `SidebarSectionBehavior` (which describes where a section's ITEMS come
+     * from). Section ordering is engine policy and ignores declaration order for
+     * the special roles: primary section(s) first, then non-empty
+     * `SidebarSectionBehavior.FAVORITES` section(s), then the remaining sections
+     * in declared order. Modules can therefore contribute a primary section
+     * without the app config having to interleave it manually.
+     */
+    isPrimary?: boolean;
     inlineCreate?: SidebarSectionInlineCreate;
     inlineCreateResourceType?: string;
     /** Field that receives the user's input during inline creation. Defaults to `'title'`. */
@@ -435,28 +739,32 @@ export declare const ResourceOperationItemRefSchema: z.ZodObject<{
     resourceType: z.ZodString;
     operation: z.ZodString;
     operationVariant: z.ZodOptional<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 /** Zod schema for `ViewItemRef`. */
 export declare const ViewItemRefSchema: z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 /** Zod schema for `ResourceViewItemRef`. */
 export declare const ResourceViewItemRefSchema: z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
     resourceType: z.ZodString;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 /** Zod schema for `EnginePageItemRef`. */
 export declare const EnginePageItemRefSchema: z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
     pageRef: z.ZodEnum<typeof EnginePageRef>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 /** Zod schema for `CustomComponentItemRef`. */
 export declare const CustomComponentItemRefSchema: z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
     componentRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
+export declare const SettingsSectionItemRefSchema: z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.SETTINGS_SECTION>;
+    sectionRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 /**
  * Zod schema for `LauncherItemRef` — discriminated union on `kind`.
  * Validates config-time launcher item references.
@@ -466,20 +774,23 @@ export declare const LauncherItemRefSchema: z.ZodDiscriminatedUnion<[z.ZodObject
     resourceType: z.ZodString;
     operation: z.ZodString;
     operationVariant: z.ZodOptional<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
     resourceType: z.ZodString;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
     pageRef: z.ZodEnum<typeof EnginePageRef>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
     componentRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>], "kind">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.SETTINGS_SECTION>;
+    sectionRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">;
 /** Zod schema for `SidebarItem`. */
 export declare const SidebarItemSchema: z.ZodType<SidebarItem>;
 /** Zod schema for `CommandMenuCommand`. */
@@ -488,191 +799,233 @@ export declare const CommandMenuCommandSchema: z.ZodIntersection<z.ZodDiscrimina
     resourceType: z.ZodString;
     operation: z.ZodString;
     operationVariant: z.ZodOptional<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
     resourceType: z.ZodString;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
     pageRef: z.ZodEnum<typeof EnginePageRef>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
     componentRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>], "kind">, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.SETTINGS_SECTION>;
+    sectionRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">, z.ZodObject<{
     category: z.ZodOptional<z.ZodString>;
     shortcut: z.ZodOptional<z.ZodString>;
     searchKeywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
     displayPolicy: z.ZodOptional<z.ZodEnum<typeof CommandMenuDisplayPolicy>>;
     runtimeAvailability: z.ZodOptional<z.ZodObject<{
         requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
-}, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+/**
+ * @wildo_source:part:start saas.frontend.command-menu.search-resource facet:layer:frontend facet:family:app-shell
+ *
+ * Zod schema for `CommandMenuSearchResource` — validates each entry in the
+ * `[COMMAND_MENU].searchResources` array.
+ */
+export declare const CommandMenuSearchResourceSchema: z.ZodType<CommandMenuSearchResource>;
+/** @wildo_source:part:end saas.frontend.command-menu.search-resource */
 /** Zod schema for `QuickActionItem`. */
 export declare const QuickActionItemSchema: z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_OPERATION>;
     resourceType: z.ZodString;
     operation: z.ZodString;
     operationVariant: z.ZodOptional<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
     resourceType: z.ZodString;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
     pageRef: z.ZodEnum<typeof EnginePageRef>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
     componentRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>], "kind">, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.SETTINGS_SECTION>;
+    sectionRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">, z.ZodObject<{
     displayPolicy: z.ZodOptional<z.ZodEnum<typeof QuickActionDisplayPolicy>>;
     runtimeAvailability: z.ZodOptional<z.ZodObject<{
         requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
-}, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
 /** Zod schema for `HotkeyBinding`. */
 export declare const HotkeyBindingSchema: z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_OPERATION>;
     resourceType: z.ZodString;
     operation: z.ZodString;
     operationVariant: z.ZodOptional<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
     resourceType: z.ZodString;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
     pageRef: z.ZodEnum<typeof EnginePageRef>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
     componentRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>], "kind">, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.SETTINGS_SECTION>;
+    sectionRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">, z.ZodObject<{
     shortcut: z.ZodString;
     scope: z.ZodOptional<z.ZodEnum<typeof HotkeyScope>>;
     description: z.ZodOptional<z.ZodString>;
     runtimeAvailability: z.ZodOptional<z.ZodObject<{
         requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
-}, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
 /** Zod schema for `ToolbarItemRef`. */
 export declare const ToolbarItemRefSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_OPERATION>;
     resourceType: z.ZodString;
     operation: z.ZodString;
     operationVariant: z.ZodOptional<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
     resourceType: z.ZodString;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
     pageRef: z.ZodEnum<typeof EnginePageRef>;
-}, z.core.$strip, core.$ZodObjectExtra>], "kind">;
+}, z.core.$strip>], "kind">;
 /** Zod schema for `ToolbarItem`. */
 export declare const ToolbarItemSchema: z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_OPERATION>;
     resourceType: z.ZodString;
     operation: z.ZodString;
     operationVariant: z.ZodOptional<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
     resourceType: z.ZodString;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
     pageRef: z.ZodEnum<typeof EnginePageRef>;
-}, z.core.$strip, core.$ZodObjectExtra>], "kind">, z.ZodObject<{
+}, z.core.$strip>], "kind">, z.ZodObject<{
     group: z.ZodOptional<z.ZodString>;
-    badgeReference: z.ZodOptional<z.ZodString>;
     iconOnly: z.ZodOptional<z.ZodBoolean>;
     runtimeAvailability: z.ZodOptional<z.ZodObject<{
         requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
-}, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
 /** Zod schema for `ControlPanelItem`. */
 export declare const ControlPanelItemSchema: z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_OPERATION>;
     resourceType: z.ZodString;
     operation: z.ZodString;
     operationVariant: z.ZodOptional<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
     resourceType: z.ZodString;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
     pageRef: z.ZodEnum<typeof EnginePageRef>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
     componentRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>], "kind">, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.SETTINGS_SECTION>;
+    sectionRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">, z.ZodObject<{
     section: z.ZodOptional<z.ZodString>;
-    badgeReference: z.ZodOptional<z.ZodString>;
     runtimeAvailability: z.ZodOptional<z.ZodObject<{
         requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
-}, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
 /** Zod schema for `UtilityPanelItem`. */
 export declare const UtilityPanelItemSchema: z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
     componentRef: z.ZodString;
     icon: z.ZodString;
     label: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 /**
- * Zod schema for `MenubarHostedComponent` — declares a component hosted within the menubar.
- * `placement` determines which zone (START/MIDDLE/END) the component renders in.
- * `breakpoint` restricts the component to a specific viewport breakpoint.
- * Render order follows array position in `hostedComponents`.
+ * @wildo_source:part:start saas.frontend.app-shell.hosted-components facet:layer:frontend facet:family:app-shell
+ *
+ * Zod schema for `MenubarHostedComponent` — validates each entry in the
+ * `[MENUBAR].hostedComponents` array. `placement` determines which zone
+ * (START/MIDDLE/END) the component renders in; `breakpoint` restricts the
+ * component to a specific viewport breakpoint. Render order follows array
+ * position in `hostedComponents`.
  */
 export declare const MenubarHostedComponentSchema: z.ZodObject<{
     componentType: z.ZodString;
     placement: z.ZodOptional<z.ZodEnum<typeof HorizontalPlacement>>;
     breakpoint: z.ZodOptional<z.ZodEnum<typeof ViewportBreakpoint>>;
     presetName: z.ZodOptional<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+    triggerWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    triggerAppearance: z.ZodOptional<z.ZodEnum<typeof HostedTriggerAppearance>>;
+}, z.core.$strip>;
+/**
+ * Zod schema for `SidebarHostedComponent` — declares a component hosted within
+ * the sidebar (the vertical mirror of `MenubarHostedComponentSchema`).
+ * `placement` selects which end of the sidebar column the component renders at
+ * (`TOP`/`BOTTOM`); `breakpoint` restricts it to a viewport breakpoint. Render
+ * order follows array position in `hostedComponents`.
+ */
+export declare const SidebarHostedComponentSchema: z.ZodObject<{
+    componentType: z.ZodString;
+    placement: z.ZodOptional<z.ZodEnum<typeof VerticalPlacement>>;
+    breakpoint: z.ZodOptional<z.ZodEnum<typeof ViewportBreakpoint>>;
+    presetName: z.ZodOptional<z.ZodString>;
+    triggerWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    triggerAppearance: z.ZodOptional<z.ZodEnum<typeof HostedTriggerAppearance>>;
+}, z.core.$strip>;
+/** @wildo_source:part:end saas.frontend.app-shell.hosted-components */
 /** Zod schema for `MenubarLauncherItem`. */
 export declare const MenubarLauncherItemSchema: z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_OPERATION>;
     resourceType: z.ZodString;
     operation: z.ZodString;
     operationVariant: z.ZodOptional<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
     resourceType: z.ZodString;
     viewRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
     pageRef: z.ZodEnum<typeof EnginePageRef>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
     componentRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>], "kind">, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.SETTINGS_SECTION>;
+    sectionRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">, z.ZodObject<{
     group: z.ZodOptional<z.ZodString>;
     runtimeAvailability: z.ZodOptional<z.ZodObject<{
         requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
-}, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
 export declare const SidebarSection_NavigationListSchema: z.ZodObject<{
     ref: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
@@ -683,16 +1036,17 @@ export declare const SidebarSection_NavigationListSchema: z.ZodObject<{
     visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     runtimeAvailability: z.ZodOptional<z.ZodObject<{
         requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     contentKind: z.ZodLiteral<SidebarSectionContentKind.NAVIGATION_LIST>;
     children: z.ZodArray<z.ZodType<SidebarItem, unknown, z.core.$ZodTypeInternals<SidebarItem, unknown>>>;
     behavior: z.ZodOptional<z.ZodEnum<typeof SidebarSectionBehavior>>;
+    isPrimary: z.ZodOptional<z.ZodBoolean>;
     inlineCreate: z.ZodOptional<z.ZodEnum<typeof SidebarSectionInlineCreate>>;
     inlineCreateResourceType: z.ZodOptional<z.ZodString>;
     inlineCreateField: z.ZodOptional<z.ZodString>;
     nested: z.ZodOptional<z.ZodBoolean>;
     maxNestingDepth: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export declare const SidebarSection_ResourceBrowserSchema: z.ZodObject<{
     ref: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
@@ -703,14 +1057,14 @@ export declare const SidebarSection_ResourceBrowserSchema: z.ZodObject<{
     visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     runtimeAvailability: z.ZodOptional<z.ZodObject<{
         requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     contentKind: z.ZodLiteral<SidebarSectionContentKind.RESOURCE_BROWSER>;
     resourceType: z.ZodString;
     operation: z.ZodOptional<z.ZodString>;
     operationVariant: z.ZodOptional<z.ZodString>;
     navigateOperation: z.ZodOptional<z.ZodString>;
     navigateOperationVariant: z.ZodOptional<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export declare const SidebarSection_GuidanceWidgetSchema: z.ZodObject<{
     ref: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
@@ -721,10 +1075,10 @@ export declare const SidebarSection_GuidanceWidgetSchema: z.ZodObject<{
     visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     runtimeAvailability: z.ZodOptional<z.ZodObject<{
         requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     contentKind: z.ZodLiteral<SidebarSectionContentKind.GUIDANCE_WIDGET>;
     guidanceRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export declare const SidebarSection_CustomComponentSchema: z.ZodObject<{
     ref: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
@@ -735,10 +1089,10 @@ export declare const SidebarSection_CustomComponentSchema: z.ZodObject<{
     visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     runtimeAvailability: z.ZodOptional<z.ZodObject<{
         requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     contentKind: z.ZodLiteral<SidebarSectionContentKind.CUSTOM_COMPONENT>;
     componentRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 /**
  * Zod schema for `SidebarSection` — discriminated union on `contentKind`.
  *
@@ -757,16 +1111,17 @@ export declare const SidebarSectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     runtimeAvailability: z.ZodOptional<z.ZodObject<{
         requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     contentKind: z.ZodLiteral<SidebarSectionContentKind.NAVIGATION_LIST>;
     children: z.ZodArray<z.ZodType<SidebarItem, unknown, z.core.$ZodTypeInternals<SidebarItem, unknown>>>;
     behavior: z.ZodOptional<z.ZodEnum<typeof SidebarSectionBehavior>>;
+    isPrimary: z.ZodOptional<z.ZodBoolean>;
     inlineCreate: z.ZodOptional<z.ZodEnum<typeof SidebarSectionInlineCreate>>;
     inlineCreateResourceType: z.ZodOptional<z.ZodString>;
     inlineCreateField: z.ZodOptional<z.ZodString>;
     nested: z.ZodOptional<z.ZodBoolean>;
     maxNestingDepth: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     ref: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
     icon: z.ZodOptional<z.ZodString>;
@@ -776,14 +1131,14 @@ export declare const SidebarSectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     runtimeAvailability: z.ZodOptional<z.ZodObject<{
         requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     contentKind: z.ZodLiteral<SidebarSectionContentKind.RESOURCE_BROWSER>;
     resourceType: z.ZodString;
     operation: z.ZodOptional<z.ZodString>;
     operationVariant: z.ZodOptional<z.ZodString>;
     navigateOperation: z.ZodOptional<z.ZodString>;
     navigateOperationVariant: z.ZodOptional<z.ZodString>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     ref: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
     icon: z.ZodOptional<z.ZodString>;
@@ -793,10 +1148,10 @@ export declare const SidebarSectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     runtimeAvailability: z.ZodOptional<z.ZodObject<{
         requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     contentKind: z.ZodLiteral<SidebarSectionContentKind.GUIDANCE_WIDGET>;
     guidanceRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     ref: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
     icon: z.ZodOptional<z.ZodString>;
@@ -806,10 +1161,10 @@ export declare const SidebarSectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     runtimeAvailability: z.ZodOptional<z.ZodObject<{
         requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     contentKind: z.ZodLiteral<SidebarSectionContentKind.CUSTOM_COMPONENT>;
     componentRef: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>], "contentKind">;
+}, z.core.$strip>], "contentKind">;
 /** Zod schema for `AppModeDefinition`. */
 export declare const AppModeDefinitionSchema: z.ZodObject<{
     ref: z.ZodString;
@@ -817,5 +1172,5 @@ export declare const AppModeDefinitionSchema: z.ZodObject<{
     icon: z.ZodString;
     isDefault: z.ZodOptional<z.ZodBoolean>;
     visibleToUserTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 //# sourceMappingURL=launcher-items.frontend.schemas.d.ts.map