@wildo-ai/saas-frontend-lib 1.0.1

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

@@ -0,0 +1,821 @@
+/**
+ * Launcher Item Types & Schemas
+ *
+ * Per-launcher content declaration model. Each launcher (sidebar, command menu,
+ * quick action button, etc.) declares its own content using these types.
+ *
+ * `LauncherItemTargetKind` is the discriminant for `LauncherItemRef` — it tells
+ * the resolution layer what kind of target a launcher item points to.
+ *
+ * `SidebarSectionContentKind` is the discriminant for sidebar section content —
+ * determines whether a section renders a navigation list, a resource browser,
+ * a guidance widget, or a custom component.
+ *
+ * These types are config-time types. The resolution layer (Step 2) transforms
+ * them into runtime `ResolvedNavigationItem` instances.
+ *
+ * @see launcher-operation-binding-analysis.md §3.1.1, §3.2
+ * @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';
+/**
+ * What kind of target a launcher item points to.
+ *
+ * This is a config-time concept — the resolution layer maps each kind to a
+ * navigation action. Different from `NavigationContentType` which is a runtime
+ * concept for zone content rendering. Both have `RESOURCE_OPERATION` but serve
+ * different axes: `LauncherItemTargetKind` = what a launcher item targets,
+ * `NavigationContentType` = what renders in a navigation zone.
+ *
+ * @see launcher-operation-binding-analysis.md §3.1.1
+ */
+export declare enum LauncherItemTargetKind {
+    /** Navigate to a resource operation (list, create, read, etc.). */
+    RESOURCE_OPERATION = "resource_operation",
+    /** Navigate to an application-scoped special view. */
+    VIEW = "view",
+    /** Navigate to a resource-scoped special view. */
+    RESOURCE_VIEW = "resource_view",
+    /** Navigate to a framework-provided page (home, security settings, etc.). */
+    ENGINE_PAGE = "engine_page",
+    /** Render a custom registered React component. */
+    CUSTOM_COMPONENT = "custom_component"
+}
+/**
+ * Framework-provided navigable pages.
+ *
+ * Closed enum — only framework pages belong here. Auth routes (login, register, etc.)
+ * are NOT engine pages. Dev routes (devTest, devThemeGallery) are excluded.
+ *
+ * The resolution layer maps these to `CommonRoutePaths` in `routes.frontend.definitions.ts`.
+ *
+ * @see app-shell-implementation-plan.md Step 0 item 1
+ */
+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"
+}
+/**
+ * Canonical mapping from `EnginePageRef` to route paths.
+ *
+ * Single source of truth — consumed by both the resolution layer
+ * (`launcher-resolution.ts`) and the verification layer
+ * (`verify-launcher-content.ts`).
+ */
+export declare const ENGINE_PAGE_ROUTES: Record<EnginePageRef, string>;
+/**
+ * How the Activity Bar renders at different breakpoints.
+ *
+ * The activity bar is the mode selector — it shows available `AppMode`s and
+ * lets the user switch between them. Its rendering varies by breakpoint.
+ *
+ * @see component-taxonomy-deep-review.md §3.5.2
+ */
+export declare enum ActivityBarRendering {
+    /** Vertical icon column on the left side (desktop default). */
+    VERTICAL_RAIL = "vertical_rail",
+    /** Horizontal icon row at the top (alternative desktop layout). */
+    HORIZONTAL_BAR = "horizontal_bar",
+    /** Persistent bottom tab bar (mobile). */
+    BOTTOM_TAB_BAR = "bottom_tab_bar"
+}
+/**
+ * Sidebar responsive behavior on mobile breakpoints.
+ *
+ * Controls how the sidebar adapts when the viewport shrinks below
+ * its responsive breakpoint.
+ *
+ * @see component-taxonomy-deep-review.md §7.1
+ */
+export declare enum SidebarResponsivePolicy {
+    /** Sidebar becomes a burger menu / drawer overlay on mobile. */
+    BURGER = "BURGER",
+    /** Sidebar stays visible but auto-expands on desktop. */
+    DRAWER = "DRAWER"
+}
+/** Sidebar section behavior mode. */
+export declare enum SidebarSectionBehavior {
+    STATIC = "static",
+    DYNAMIC = "dynamic",
+    FAVORITES = "favorites"
+}
+/** Sidebar section inline create mode. */
+export declare enum SidebarSectionInlineCreate {
+    NONE = "none",
+    INPUT = "input",
+    DIALOG = "dialog"
+}
+/**
+ * Quick Action Button placement mode.
+ *
+ * Replaces the literal string `"FLOATING"` patterns in existing schemas.
+ * After container inversion (Step 4), the only placement is `FLOATING` or
+ * `CONTAINED` (hosted by menubar/sidebar via `hostedComponents`).
+ */
+export declare enum QuickActionButtonPlacement {
+    /** Floating action button overlaying the content area. */
+    FLOATING = "FLOATING",
+    /** Contained within a parent component (menubar or sidebar). */
+    CONTAINED = "CONTAINED"
+}
+/**
+ * What kind of content a sidebar section renders.
+ *
+ * This is the discriminant for the `SidebarSection` discriminated union.
+ * Each content kind has its own set of properties and rendering behavior.
+ *
+ * @see launcher-operation-binding-analysis.md §3.3.1
+ */
+export declare enum SidebarSectionContentKind {
+    /** Traditional navigation item list (tree, collapsible, inline create). */
+    NAVIGATION_LIST = "navigation_list",
+    /** Filterable resource instance list — fetches from a bound operation. */
+    RESOURCE_BROWSER = "resource_browser",
+    /** Guidance/onboarding widget — renders a registered guidance component. */
+    GUIDANCE_WIDGET = "guidance_widget",
+    /** Arbitrary registered React component. */
+    CUSTOM_COMPONENT = "custom_component"
+}
+/**
+ * Points to a resource operation (list, create, read, etc.).
+ * The resolution layer resolves this via the resource registry.
+ */
+export interface ResourceOperationItemRef {
+    kind: LauncherItemTargetKind.RESOURCE_OPERATION;
+    resourceType: string;
+    operation: string;
+    operationVariant?: string;
+}
+/** Points to an application-scoped special view. */
+export interface ViewItemRef {
+    kind: LauncherItemTargetKind.VIEW;
+    viewRef: string;
+}
+/** Points to a resource-scoped special view. */
+export interface ResourceViewItemRef {
+    kind: LauncherItemTargetKind.RESOURCE_VIEW;
+    resourceType: string;
+    viewRef: string;
+}
+/** Points to a framework page (home, security settings). */
+export interface EnginePageItemRef {
+    kind: LauncherItemTargetKind.ENGINE_PAGE;
+    pageRef: EnginePageRef;
+}
+/** Points to a registered custom React component. */
+export interface CustomComponentItemRef {
+    kind: LauncherItemTargetKind.CUSTOM_COMPONENT;
+    componentRef: string;
+}
+/**
+ * A launcher item reference — identifies WHAT a launcher item targets.
+ * Discriminated on `kind`. The resolution layer dispatches on this to
+ * produce a `ResolvedNavigationItem`.
+ *
+ * @see launcher-operation-binding-analysis.md §3.2
+ */
+export type LauncherItemRef = ResourceOperationItemRef | ViewItemRef | ResourceViewItemRef | EnginePageItemRef | CustomComponentItemRef;
+/**
+ * Toolbar items are navigation-only launcher refs.
+ * Custom-component materialization belongs to other app-level surfaces and is
+ * intentionally excluded from the global app-level toolbar contract.
+ */
+export type ToolbarItemRef = ResourceOperationItemRef | ViewItemRef | ResourceViewItemRef | EnginePageItemRef;
+/**
+ * A sidebar navigation item — extends `LauncherItemRef` with sidebar-specific
+ * display properties. Supports all launcher target kinds as targets.
+ */
+export type SidebarItem = LauncherItemRef & {
+    displayPolicy?: SidebarItemDisplayPolicy;
+    badgeReference?: string;
+    children?: SidebarItem[];
+    runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
+};
+/** A command menu entry. */
+export type CommandMenuCommand = LauncherItemRef & {
+    category?: string;
+    shortcut?: string;
+    searchKeywords?: string[];
+    displayPolicy?: CommandMenuDisplayPolicy;
+    runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
+};
+/** A quick action button entry. */
+export type QuickActionItem = LauncherItemRef & {
+    displayPolicy?: QuickActionDisplayPolicy;
+    runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
+};
+/**
+ * A keyboard shortcut binding to a navigation target (`LauncherItemRef`).
+ *
+ * `description` overrides the registry/help label. When omitted, the framework uses
+ * `tResourceOperation(…, 'title')` for `RESOURCE_OPERATION` targets and the resolved
+ * navigation `label` for all other kinds.
+ */
+export type HotkeyBinding = LauncherItemRef & {
+    shortcut: string;
+    scope?: HotkeyScope;
+    description?: string;
+    runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
+};
+/** 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;
+};
+/** A control panel item. */
+export type ControlPanelItem = LauncherItemRef & {
+    section?: string;
+    badgeReference?: string;
+    runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
+};
+/** A utility panel item (Gmail-style right-side panel). */
+export interface UtilityPanelItem {
+    kind: LauncherItemTargetKind.CUSTOM_COMPONENT;
+    componentRef: string;
+    icon: string;
+    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`.
+ */
+export interface MenubarHostedComponent {
+    componentType: string;
+    placement?: HorizontalPlacement;
+    breakpoint?: ViewportBreakpoint;
+    /** Override the preset name used for component resolution. Defaults to `CorePresetNames.DEFAULT`. */
+    presetName?: string;
+}
+/** A menubar-specific launcher item (config-time declaration). */
+export type MenubarLauncherItem = LauncherItemRef & {
+    group?: string;
+    runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
+};
+/**
+ * Generic runtime availability contract for launcher declarations.
+ *
+ * This is intentionally distinct from `requiredFeatures` on resolved
+ * view/resource targets:
+ * - `runtimeAvailability` decides whether a launcher declaration should survive
+ *   the app-shell filtering pass at all
+ * - `requiredFeatures` stays the canonical plan/subscription gating mechanism
+ *   once an item has already survived launcher filtering and is being resolved
+ */
+export interface LauncherRuntimeAvailabilityConfig {
+    requiredCapabilities?: string[];
+}
+export declare const LauncherRuntimeAvailabilityConfigSchema: z.ZodObject<{
+    requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+/**
+ * Parameters passed to a `ScopeConditionFn` for evaluating section visibility.
+ *
+ * @see component-taxonomy-deep-review.md §3.5.3
+ */
+export interface ScopeConditionParams {
+    /** Current app scope values (workspace, project, environment, etc.). */
+    appScopeValues: Record<string, AppScopeValue>;
+    /** Currently active mode ref, or `null` if no mode system. */
+    activeMode: string | null;
+    /** All defined app modes (for inspecting mode metadata). */
+    availableModes: AppModeDefinition[];
+}
+/**
+ * Predicate function that determines whether a sidebar section should be visible
+ * based on the current scope and mode state.
+ *
+ * Returns `true` to show the section, `false` to hide it.
+ * Called reactively whenever scope or mode changes.
+ */
+export type ScopeConditionFn = (params: ScopeConditionParams) => boolean;
+/**
+ * Context provided to a `ResourceBrowser` section's `onInstanceClick` callback.
+ */
+export interface ResourceBrowserClickContext {
+    resourceType: string;
+    instanceId: string;
+    instanceData: Record<string, unknown>;
+}
+/**
+ * Defines an application mode (e.g., "explorer", "search", "admin").
+ *
+ * Modes filter which sidebar sections are visible. The `ACTIVITY_BAR`
+ * renders available modes as selectable icons.
+ *
+ * @see component-taxonomy-deep-review.md §7.3
+ */
+export interface AppModeDefinition {
+    /** Unique reference for this mode. */
+    ref: string;
+    /** Display label (i18n ref). */
+    label: string;
+    /** Icon identifier for the activity bar. */
+    icon: string;
+    /** Whether this is the default mode when none is persisted. */
+    isDefault?: boolean;
+    /** Restrict mode visibility to specific user types. */
+    visibleToUserTypes?: string[];
+}
+/**
+ * Base properties shared by all sidebar section types.
+ * `ref` is `string`-typed — no framework enum, apps define their own refs.
+ */
+export interface SidebarSectionBase {
+    contentKind: SidebarSectionContentKind;
+    /** Section reference — app-defined, used for i18n and configuration matching. */
+    ref: string;
+    /** Display label (i18n ref). If omitted, section renders without a header. */
+    label?: string;
+    /** Icon for the section header. */
+    icon?: string;
+    /** Whether the section header (label + icon) is rendered. Defaults to `true`. */
+    showLabel?: boolean;
+    /** Whether the section can be collapsed by the user. */
+    collapsible?: boolean;
+    /** Whether the section starts collapsed. */
+    defaultCollapsed?: boolean;
+    /**
+     * Mode refs this section is visible in. If omitted, visible in all modes.
+     * String-based — validated at startup against `appModes[].ref`.
+     * Evaluated in Macro B (Step 6).
+     */
+    visibleInModes?: string[];
+    /**
+     * Function-based visibility condition for complex scope-dependent logic.
+     * Evaluated in Macro B (Step 6).
+     */
+    scopeCondition?: ScopeConditionFn;
+    /** Declarative runtime capability gating evaluated by the app-shell layer. */
+    runtimeAvailability?: LauncherRuntimeAvailabilityConfig;
+}
+/**
+ * Traditional navigation item list section.
+ * Supports tree hierarchy, inline create, drag-reorder (via behavior).
+ */
+export interface SidebarSection_NavigationList extends SidebarSectionBase {
+    contentKind: SidebarSectionContentKind.NAVIGATION_LIST;
+    children: SidebarItem[];
+    behavior?: SidebarSectionBehavior;
+    inlineCreate?: SidebarSectionInlineCreate;
+    inlineCreateResourceType?: string;
+    /** Field that receives the user's input during inline creation. Defaults to `'title'`. */
+    inlineCreateField?: string;
+    nested?: boolean;
+    maxNestingDepth?: number;
+}
+/**
+ * Filterable resource instance list section.
+ * Fetches data from a bound operation and displays resource instances.
+ *
+ * @see launcher-operation-binding-analysis.md §3.3.6
+ */
+export interface SidebarSection_ResourceBrowser extends SidebarSectionBase {
+    contentKind: SidebarSectionContentKind.RESOURCE_BROWSER;
+    /** Resource type to browse. */
+    resourceType: string;
+    /** Override the default LIST operation (optional — defaults to LIST). */
+    operation?: string;
+    /** Operation variant for filtered views. */
+    operationVariant?: string;
+    /**
+     * Operation used when the user clicks a listed instance.
+     * Defaults to READ when available; otherwise falls back to the bound operation.
+     */
+    navigateOperation?: string;
+    /** Variant for the click/navigation operation. */
+    navigateOperationVariant?: string;
+    /**
+     * Client-side filter predicate applied after fetching.
+     * Enables display restrictions (e.g., "starred only").
+     */
+    instanceFilter?: (instance: Record<string, unknown>) => boolean;
+    /**
+     * Custom click handler for resource instances.
+     * Default: navigate to instance via `NavigationUtils.resolveResourceUrl()`.
+     */
+    onInstanceClick?: (context: ResourceBrowserClickContext) => void;
+}
+/** Guidance/onboarding widget section. */
+export interface SidebarSection_GuidanceWidget extends SidebarSectionBase {
+    contentKind: SidebarSectionContentKind.GUIDANCE_WIDGET;
+    /** Reference to a registered guidance component. */
+    guidanceRef: string;
+}
+/** Arbitrary custom component section. */
+export interface SidebarSection_CustomComponent extends SidebarSectionBase {
+    contentKind: SidebarSectionContentKind.CUSTOM_COMPONENT;
+    /** Reference to a registered React component. */
+    componentRef: string;
+}
+/**
+ * Discriminated union of all sidebar section types.
+ * Narrow on `contentKind` to access type-specific properties.
+ */
+export type SidebarSection = SidebarSection_NavigationList | SidebarSection_ResourceBrowser | SidebarSection_GuidanceWidget | SidebarSection_CustomComponent;
+export declare const LauncherItemTargetKindSchema: z.ZodEnum<typeof LauncherItemTargetKind>;
+export declare const EnginePageRefSchema: z.ZodEnum<typeof EnginePageRef>;
+export declare const ActivityBarRenderingSchema: z.ZodEnum<typeof ActivityBarRendering>;
+export declare const SidebarResponsivePolicySchema: z.ZodEnum<typeof SidebarResponsivePolicy>;
+export declare const QuickActionButtonPlacementSchema: z.ZodEnum<typeof QuickActionButtonPlacement>;
+export declare const SidebarSectionContentKindSchema: z.ZodEnum<typeof SidebarSectionContentKind>;
+/** Zod schema for `ResourceOperationItemRef`. */
+export declare const ResourceOperationItemRefSchema: z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_OPERATION>;
+    resourceType: z.ZodString;
+    operation: z.ZodString;
+    operationVariant: z.ZodOptional<z.ZodString>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+/** Zod schema for `ViewItemRef`. */
+export declare const ViewItemRefSchema: z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>;
+/** 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>;
+/** 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>;
+/** Zod schema for `CustomComponentItemRef`. */
+export declare const CustomComponentItemRefSchema: z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
+    componentRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>;
+/**
+ * Zod schema for `LauncherItemRef` — discriminated union on `kind`.
+ * Validates config-time launcher item references.
+ */
+export declare const LauncherItemRefSchema: 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<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
+    resourceType: z.ZodString;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
+    pageRef: z.ZodEnum<typeof EnginePageRef>;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
+    componentRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>], "kind">;
+/** Zod schema for `SidebarItem`. */
+export declare const SidebarItemSchema: z.ZodType<SidebarItem>;
+/** Zod schema for `CommandMenuCommand`. */
+export declare const CommandMenuCommandSchema: 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<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
+    resourceType: z.ZodString;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
+    pageRef: z.ZodEnum<typeof EnginePageRef>;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
+    componentRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>], "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>>;
+/** 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<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
+    resourceType: z.ZodString;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
+    pageRef: z.ZodEnum<typeof EnginePageRef>;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
+    componentRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>], "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>>;
+/** 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<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
+    resourceType: z.ZodString;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
+    pageRef: z.ZodEnum<typeof EnginePageRef>;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
+    componentRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>], "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>>;
+/** 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<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
+    resourceType: z.ZodString;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
+    pageRef: z.ZodEnum<typeof EnginePageRef>;
+}, z.core.$strip, core.$ZodObjectExtra>], "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<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
+    resourceType: z.ZodString;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
+    pageRef: z.ZodEnum<typeof EnginePageRef>;
+}, z.core.$strip, core.$ZodObjectExtra>], "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>>;
+/** 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<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
+    resourceType: z.ZodString;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
+    pageRef: z.ZodEnum<typeof EnginePageRef>;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
+    componentRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>], "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>>;
+/** 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>;
+/**
+ * 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`.
+ */
+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>;
+/** 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<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.VIEW>;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.RESOURCE_VIEW>;
+    resourceType: z.ZodString;
+    viewRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.ENGINE_PAGE>;
+    pageRef: z.ZodEnum<typeof EnginePageRef>;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    kind: z.ZodLiteral<LauncherItemTargetKind.CUSTOM_COMPONENT>;
+    componentRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>], "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>>;
+export declare const SidebarSection_NavigationListSchema: z.ZodObject<{
+    ref: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    showLabel: z.ZodOptional<z.ZodBoolean>;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    runtimeAvailability: z.ZodOptional<z.ZodObject<{
+        requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    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>>;
+    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>;
+export declare const SidebarSection_ResourceBrowserSchema: z.ZodObject<{
+    ref: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    showLabel: z.ZodOptional<z.ZodBoolean>;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    runtimeAvailability: z.ZodOptional<z.ZodObject<{
+        requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    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>;
+export declare const SidebarSection_GuidanceWidgetSchema: z.ZodObject<{
+    ref: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    showLabel: z.ZodOptional<z.ZodBoolean>;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    runtimeAvailability: z.ZodOptional<z.ZodObject<{
+        requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    contentKind: z.ZodLiteral<SidebarSectionContentKind.GUIDANCE_WIDGET>;
+    guidanceRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export declare const SidebarSection_CustomComponentSchema: z.ZodObject<{
+    ref: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    showLabel: z.ZodOptional<z.ZodBoolean>;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    runtimeAvailability: z.ZodOptional<z.ZodObject<{
+        requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    contentKind: z.ZodLiteral<SidebarSectionContentKind.CUSTOM_COMPONENT>;
+    componentRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>;
+/**
+ * Zod schema for `SidebarSection` — discriminated union on `contentKind`.
+ *
+ * Note: `scopeCondition` (on `SidebarSectionBase`), `instanceFilter`, and
+ * `onInstanceClick` (on `SidebarSection_ResourceBrowser`) are function types
+ * that cannot be validated by Zod. They are typed on the TypeScript interfaces
+ * but excluded from the Zod schema (runtime code handles them directly).
+ */
+export declare const SidebarSectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    ref: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    showLabel: z.ZodOptional<z.ZodBoolean>;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    runtimeAvailability: z.ZodOptional<z.ZodObject<{
+        requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    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>>;
+    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<{
+    ref: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    showLabel: z.ZodOptional<z.ZodBoolean>;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    runtimeAvailability: z.ZodOptional<z.ZodObject<{
+        requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    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<{
+    ref: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    showLabel: z.ZodOptional<z.ZodBoolean>;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    runtimeAvailability: z.ZodOptional<z.ZodObject<{
+        requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    contentKind: z.ZodLiteral<SidebarSectionContentKind.GUIDANCE_WIDGET>;
+    guidanceRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    ref: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    showLabel: z.ZodOptional<z.ZodBoolean>;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    defaultCollapsed: z.ZodOptional<z.ZodBoolean>;
+    visibleInModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    runtimeAvailability: z.ZodOptional<z.ZodObject<{
+        requiredCapabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    contentKind: z.ZodLiteral<SidebarSectionContentKind.CUSTOM_COMPONENT>;
+    componentRef: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>], "contentKind">;
+/** Zod schema for `AppModeDefinition`. */
+export declare const AppModeDefinitionSchema: z.ZodObject<{
+    ref: z.ZodString;
+    label: z.ZodString;
+    icon: z.ZodString;
+    isDefault: z.ZodOptional<z.ZodBoolean>;
+    visibleToUserTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+//# sourceMappingURL=launcher-items.frontend.schemas.d.ts.map