npm - @wildo-ai/saas-models - Versions diffs - 1.1.4 → 1.1.6 - Mend

@wildo-ai/saas-models 1.1.4 → 1.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1399) hide show

package/dist/esm/config/frontend/navigation.shared.schemas.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"navigation.shared.schemas.js","sourceRoot":"","sources":["../../../../../src/config/frontend/navigation.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Navigation — Configuration Schemas\n \n Zone-first, operation-driven navigation configuration model.\n * Decomposes navigation into four independent axes:\n \n 1. Meaning (input signals) — contextual facts at navigation time (source zone, operation,\n * cardinality, viewport, depth). NOT configured — these are inputs to resolution.\n * 2. Transition (verb) — HOW content arrives: push, replace, split, overlay, inplace, promote.\n * This is the primary thing that gets configured per zone.\n * 3. Placement (zones) — WHERE content lives: primary, secondary, companion, overlay.\n * Zones are structural layout areas AND source context for resolution.\n * 4. Appearance (visual) — HOW content renders in its slot: panel, drawer, dialog, sheet.\n * Only meaningful for split and overlay transitions.\n \n Key design decisions:\n * - Zones own their complete behavior (no global defaults + override pattern)\n * - Operations are transition keys; cardinality drives appearance only\n * - Embedding (tabs/sections within a parent) is view composition, not navigation\n * - `contentModel` (single/tabbed) is orthogonal to transitions\n \n @see _code_archive/docs-archive/navigation/navigation-v3-reflection.md\n /\n\nimport { z } from 'zod';\nimport { ViewportBreakpoint, DisplayDirection } from '@wildo-ai/zod-decorators';\nimport { CoreResourceOperation } from '../../resources/resources.shared.core.definitions';\n\n\n// ════════════════════════════════════════════════════════════════\n// Enums\n// ════════════════════════════════════════════════════════════════\n\n/\n Navigation transition verbs — HOW content arrives at its destination.\n \n These are the six fundamental navigation actions. Every user-triggered\n * navigation event resolves to exactly one of these verbs. The source zone's\n * `transitions` map determines which verb fires for each operation.\n \n Four zone-level transitions: `push`, `replace`, `split`, `overlay`\n * Two cross-context transitions: `inplace` (element-level), `promote` (escape to primary)\n \n `push` behavior depends on the zone's `contentModel`:\n * - In `single` zones: stack-based (new content on top, back pops)\n * - In `tabbed` zones: opens a new tab (or activates existing for same resource)\n \n @wildo_source:part:start saas.models.navigation.transition-vocabulary facet:layer:shared facet:family:navigation-config\n /\nexport enum NavigationTransition {\n /\n Content added to the zone's stack (single) or as a new tab (tabbed).\n * Back navigation pops the stack or switches to the previous tab.\n * URL adds a new path segment.\n /\n PUSH = 'push',\n /\n Content replaces the current content in the zone. No stack entry — the previous\n * content is gone from the zone's state (but remains in browser history).\n * URL replaces the current segment.\n /\n REPLACE = 'replace',\n /\n Content opens in an adjacent zone (secondary or companion).\n * Creates a side-by-side layout. The source zone's content remains visible.\n * Back navigation un-splits (closes the adjacent zone).\n * URL adds a split segment.\n /\n SPLIT = 'split',\n /\n Content opens in a floating layer above the entire layout (dialog, sheet, or drawer).\n * The underlying layout remains visible but non-interactive.\n * Back navigation or Escape dismisses the overlay.\n * URL adds an overlay param/hash.\n /\n OVERLAY = 'overlay',\n /\n Element-level transformation within the current view. A specific item in a\n * list/section transforms from one mode to another (read → edit); a CREATE\n * materializes a new element beside the existing ones. The parent view stays,\n * the zone stack is unchanged, and surrounding items remain visible.\n \n Fundamentally different from `replace` (which swaps the entire zone content).\n * `inplace` operates at the element level, not the zone level.\n \n No lifecycle modifiers (`persistent`/`ephemeral`) are valid on `inplace`.\n * No appearance to configure — the element transforms within its existing slot.\n \n It is the one transition that does not place content in a zone, which is\n * why the controller hands it to the element-level host\n * (`InPlaceOperationContext`) instead of resolving a target zone for it. That\n * host is provided by the COLLECTION the element belongs to, so a transition\n * resolving to `inplace` on a surface with no collection above it — a detail\n * page, a breadcrumb, a picker — degrades to an OVERLAY.\n \n It is TRANSIENT: no URL, and a reload returns the view to rest. Earlier\n * revisions of this comment promised a query param (`?editing=<childId>` /\n * `?creating=<resourceType>`) and none was ever written. It is not written now\n * either, and that is a decision rather than an omission: an inline row-edit is\n * a momentary state of a listing, not a place — no comparable admin framework\n * deep-links one, and anything that should survive a reload or a back button\n * wants `push`. `ResourceOperationActionPresentation.INLINE`, the per-operation\n * tier that selects the same host, is transient for the same reason.\n \n @example\n * // Click \"edit\" on a child in parent's inline section → item transforms to edit form\n * transitions: { [CoreResourceOperation.UPDATE]: NavigationTransition.INPLACE }\n \n // Click \"add\" in a relationship section → create form appears inline in the list\n * transitions: { [CoreResourceOperation.CREATE]: NavigationTransition.INPLACE }\n /\n INPLACE = 'inplace',\n /\n Escape the current context and open content at primary scope.\n * Abandons the current context: overlays close, companion/secondary dismiss.\n * The promoted content becomes the primary zone's top content.\n \n Use case: a link within an overlay should open as a full primary view,\n * or a nested detail in a companion zone should \"pop out\" to primary.\n \n Fundamentally different from `push` (which stays in the current zone) and\n * from `replace` (which replaces content within the same zone). `promote`\n * crosses zones and always targets primary.\n \n No lifecycle modifiers (`persistent`/`ephemeral`) are valid on `promote`.\n * No appearance to configure — content fills primary (same as push/replace).\n \n URL serialization: full URL change (promoted resource becomes the primary route).\n \n @example\n * // From an overlay, a link should open as primary (close overlay, show in primary)\n * transitions: { [CoreResourceOperation.READ]: NavigationTransition.PROMOTE }\n /\n PROMOTE = 'promote',\n}\n/* @wildo_source:part:end saas.models.navigation.transition-vocabulary /\n\n/\n Named layout zones — configurable structural areas WHERE content lives.\n \n Zones serve four purposes:\n * 1. Structural — which physical areas exist in the layout (declared in config)\n * 2. Source context — the same operation resolves differently FROM primary vs FROM secondary\n * 3. Responsive — each zone carries its own collapse behavior per viewport\n * 4. Content model — each zone independently manages single-stack or tabbed content\n \n Note: `overlay` is NOT a named zone — it's an implicit layer always available.\n * Overlay is a runtime destination, not a configurable zone. See `NavigationZone`\n * in the frontend runtime types for the full set including overlay.\n \n @wildo_source:part:start saas.models.navigation.surface-vocabulary facet:layer:shared facet:family:navigation-config\n /\nexport enum NavigationZoneName {\n /* Main content area. Lists, root-level reads, primary workspace. Always exists. /\n PRIMARY = 'primary',\n /\n First adjacent zone. Detail content in list-detail patterns.\n * Only exists if declared in config. Appears when a `split` transition targets it.\n * Typical use: showing item details alongside a list.\n /\n SECONDARY = 'secondary',\n /\n Persistent supplementary content. Reference panels, docs, notes, threads.\n * Only exists if declared in config. Usually hidden by default (`defaultVisible: false`).\n * Activated by `split` with `persistent: true` or explicit user toggle.\n * Typical use: Slack thread panel, VS Code terminal, documentation sidebar.\n /\n COMPANION = 'companion',\n}\n\n/\n How a zone manages multiple items. Orthogonal to transitions.\n \n The transition says \"content arrives\" — the content model says\n * \"how does the zone accommodate it.\" Any zone can use any content model,\n * regardless of which transitions it supports.\n /\nexport enum NavigationZoneContentModel {\n /\n Navigation stack: new content pushes on top, previous preserved underneath.\n * Only one item visible at a time. Back navigation pops the stack.\n * `replace` replaces the top without adding to the stack.\n * This is the default for all zones.\n /\n SINGLE = 'single',\n /\n Parallel tabs: `push` creates a new tab (or activates existing for the same resource).\n * Tab bar is visible, showing all open tabs. No depth stack within tabs.\n * `replace` replaces the active tab's content. Close is an explicit action (not back).\n * When no tabs remain, `onEmpty` behavior applies.\n /\n TABBED = 'tabbed',\n}\n\n/\n Responsive collapse behavior when viewport shrinks below a zone's breakpoint.\n \n Only applies to secondary and companion zones. Primary never collapses.\n * When viewport grows back past the breakpoint, collapsed content migrates\n * back to its original zone (content is preserved).\n /\nexport enum ResponsiveCollapseMode {\n /\n Zone hides. Its content joins primary's navigation stack.\n * The user sees the content in-context within primary.\n * Back navigation pops back to primary's previous content.\n /\n PUSH = 'push',\n /\n Zone hides. Its content opens as an overlay on top of primary.\n * The user sees the content as a floating sheet/dialog.\n * Dismiss returns to the underlying primary content.\n /\n OVERLAY = 'overlay',\n}\n/* @wildo_source:part:end saas.models.navigation.surface-vocabulary /\n\n/\n @wildo_source:part:start saas.models.navigation.zone-declaration facet:layer:shared facet:family:navigation-config\n \n What happens when a zone's last content is dismissed.\n * Only meaningful for secondary and companion zones (primary never empties,\n * overlay auto-dismisses by definition).\n /\nexport enum ZoneEmptyBehavior {\n /\n Zone hides, adjacent zones expand to fill the space.\n * Example: closing the last detail → layout returns to list-only.\n * This is the default for all non-primary zones.\n /\n COLLAPSE = 'collapse',\n /\n Zone stays visible with an empty-state placeholder.\n * Example: \"Select an item to view details\" message. Keeps layout stable.\n * Useful when the user frequently toggles between items.\n /\n EMPTY_STATE = 'emptyState',\n}\n/* @wildo_source:part:end saas.models.navigation.zone-declaration /\n\n/\n @wildo_source:part:start saas.models.navigation.surface-vocabulary facet:layer:shared facet:family:navigation-config\n \n Visual presentation for overlay transitions.\n * Determines how floating content renders above the layout.\n /\nexport enum OverlayAppearance {\n /\n Centered modal dialog with backdrop.\n * Best for focused tasks: create forms, confirmations, destructive actions.\n * Blocks underlying content visually. Escape or backdrop click dismisses.\n /\n DIALOG = 'dialog',\n /\n Side or bottom drawer panel that slides in from an edge.\n * Best for contextual content that benefits from seeing the underlying layout.\n * Less disruptive than dialog. Common for detail views on mobile.\n /\n SHEET = 'sheet',\n /\n Vaul-backed mobile drawer.\n * Use when the navigation resolver should choose a drawer directly rather\n * than relying on a dialog appearance plus mobileShape policy.\n /\n DRAWER = 'drawer',\n}\n\n/\n Visual presentation for split transitions.\n * Determines how adjacent zone content renders alongside the source zone.\n /\nexport enum SplitAppearance {\n /\n Standard vertical side panel.\n * Content appears beside the source zone with a resizable divider.\n * Most common for list-detail patterns.\n /\n PANEL = 'panel',\n /\n Horizontal drawer (bottom panel).\n * Content appears below the source zone.\n * Used for companion panels like terminals, output logs, reference docs.\n /\n DRAWER = 'drawer',\n}\n/* @wildo_source:part:end saas.models.navigation.surface-vocabulary /\n\n// ════════════════════════════════════════════════════════════════\n// ViewportDiscriminated — Generic responsive override pattern\n// ════════════════════════════════════════════════════════════════\n\n/\n A value that is either a plain `T` (applies at all viewports) or a\n * viewport-keyed partial record for per-breakpoint control.\n \n This pattern is used throughout the navigation config for responsive properties:\n * `responsiveCollapse`, `appearance`, `contentSectionConfig`, `transition`.\n \n @example\n * // Plain value — same everywhere\n * responsiveCollapse: ResponsiveCollapseMode.PUSH\n \n // Viewport-discriminated — different per breakpoint\n * responsiveCollapse: { [ViewportBreakpoint.VERT_TABLET]: ResponsiveCollapseMode.PUSH, [ViewportBreakpoint.MOBILE]: ResponsiveCollapseMode.OVERLAY }\n \n // Overlay appearance — sheet on tablet, drawer on mobile\n * overlay: { [ViewportBreakpoint.VERT_TABLET]: OverlayAppearance.SHEET, [ViewportBreakpoint.MOBILE]: OverlayAppearance.DRAWER }\n /\nexport type ViewportDiscriminated<T> = T \| Partial<Record<ViewportBreakpoint, T>>;\n\n/\n Zod schema factory for `ViewportDiscriminated<T>`.\n \n Produces a union: the plain inner schema OR a record keyed by `ViewportBreakpoint`\n * with inner schema values. The record must have at least one key.\n \n @param innerSchema - Zod schema for the value type at each breakpoint.\n /\nexport function viewportDiscriminatedSchema<T extends z.ZodType>(innerSchema: T) {\n return z.union([\n innerSchema,\n z.partialRecord(z.enum(ViewportBreakpoint), innerSchema).refine(\n (obj) => Object.keys(obj).length > 0,\n { message: 'Viewport-discriminated object must have at least one breakpoint key' },\n ),\n ]);\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Transition Config\n// ════════════════════════════════════════════════════════════════\n\n/\n Extended transition with lifecycle modifiers.\n \n Most transitions are simple verbs (just the enum value). The object form\n * adds lifecycle semantics for two specific patterns:\n \n - Companion pattern: `{ transition: NavigationTransition.SPLIT, persistent: true }`\n * The split zone persists when the source zone's content changes.\n * Without `persistent`, a split zone would clear when primary navigates away.\n \n - Inspect pattern: `{ transition: NavigationTransition.OVERLAY, ephemeral: true }`\n * The overlay auto-closes when the source zone's stack changes.\n * Without `ephemeral`, overlays stay open until explicitly dismissed.\n \n Semantic constraints (enforced by `.refine()`):\n * - `persistent` is only valid on `split` transitions\n * - `ephemeral` is only valid on `overlay` transitions\n * - `persistent` and `ephemeral` are mutually exclusive\n * - `inplace` and `promote` do not accept any modifier (they are always simple verbs)\n /\nexport const TransitionObjectSchema = z.object({\n /* The transition verb. /\n transition: z.enum(NavigationTransition),\n /\n When `true`, the split zone persists when the source zone navigates away.\n * Only valid on `split` transitions. Targets the companion zone specifically\n * (rather than the default adjacent zone resolution).\n \n Example: Slack thread panel stays open when switching channels.\n /\n persistent: z.boolean().optional(),\n /\n When `true`, the overlay auto-closes when the source zone's stack changes.\n * Only valid on `overlay` transitions.\n \n Example: Quick-inspect preview that dismisses when the user clicks another item.\n /\n ephemeral: z.boolean().optional(),\n}).refine(\n (obj) => {\n if (obj.persistent && obj.transition !== NavigationTransition.SPLIT) return false;\n if (obj.ephemeral && obj.transition !== NavigationTransition.OVERLAY) return false;\n if (obj.persistent && obj.ephemeral) return false;\n return true;\n },\n { message: 'persistent is only valid on split; ephemeral is only valid on overlay; they are mutually exclusive' },\n);\nexport type TransitionObject = z.infer<typeof TransitionObjectSchema>;\n\n/\n A transition configuration: either a simple verb string or an object with modifiers.\n \n @example\n * // Simple verb\n * transitions: { read: NavigationTransition.SPLIT, create: NavigationTransition.OVERLAY }\n \n // Object with lifecycle modifier\n * transitions: { read: { transition: NavigationTransition.SPLIT, persistent: true } }\n /\nexport const TransitionConfigSchema = z.union([\n z.enum(NavigationTransition),\n TransitionObjectSchema,\n]);\nexport type TransitionConfig = z.infer<typeof TransitionConfigSchema>;\n\n\n// ════════════════════════════════════════════════════════════════\n// Zone Configuration\n// ════════════════════════════════════════════════════════════════\n\n/\n Operation → transition mapping for a zone.\n \n Partial record — only operations that the zone handles need entries.\n * Missing operations fall back to the framework's hardcoded defaults.\n \n Keys are `CoreResourceOperation` values such as `read`, `list`, `create`,\n * `update`, `delete`, and `search`.\n \n @example\n * transitions: {\n * read: NavigationTransition.SPLIT, // click item → split to secondary\n * list: NavigationTransition.REPLACE, // \"View all\" → replace primary\n * create: NavigationTransition.OVERLAY, // new item → dialog\n * update: NavigationTransition.INPLACE, // edit → transform element inline\n * delete: NavigationTransition.OVERLAY, // confirm → dialog\n * search: NavigationTransition.PUSH, // advanced search → full-surface route\n * }\n \n // From an overlay, promote a link to primary view\n * transitions: {\n * read: NavigationTransition.PROMOTE, // link in overlay → escape to primary\n * }\n /\n/* Partial record — only operations that the zone handles need entries. Missing operations fall back to framework defaults. /\nexport const ZoneTransitionsSchema = z.partialRecord(\n z.enum(CoreResourceOperation),\n TransitionConfigSchema,\n) as unknown as z.ZodType<Partial<Record<CoreResourceOperation, TransitionConfig>>>;\nexport type ZoneTransitions = Partial<Record<CoreResourceOperation, TransitionConfig>>;\n\n/\n Transition → visual appearance for a zone. Values are viewport-discriminated.\n \n Only `split` and `overlay` transitions have meaningful appearance choices.\n * `push`, `replace`, `inplace`, and `promote` have no appearance to configure:\n * - `push`/`replace` fill the zone\n * - `inplace` transforms an element within the current view\n * - `promote` fills primary (same as push/replace)\n \n @example\n * appearance: {\n * split: SplitAppearance.PANEL, // always side panel\n * overlay: { [ViewportBreakpoint.VERT_TABLET]: OverlayAppearance.SHEET, [ViewportBreakpoint.MOBILE]: OverlayAppearance.DRAWER }, // sheet on tablet, drawer on mobile\n * }\n /\nexport const ZoneAppearanceSchema = z.object({\n /* How split content renders. Default: `SplitAppearance.PANEL` (vertical side panel). /\n split: viewportDiscriminatedSchema(z.enum(SplitAppearance)).optional(),\n /* How overlay content renders. Default: `OverlayAppearance.DIALOG` (centered modal). /\n overlay: viewportDiscriminatedSchema(z.enum(OverlayAppearance)).optional(),\n});\nexport type ZoneAppearance = z.infer<typeof ZoneAppearanceSchema>;\n\n/\n @wildo_source:part:start saas.models.navigation.zone-declaration facet:layer:shared facet:family:navigation-config\n \n How much of its zone a DESTINATION's content occupies.\n \n The primary zone caps and centres its content at `var(--content-max-width, 80rem)` and gives it no\n * definite-height ancestor. That is correct for almost everything a zone hosts — a form, a list, a\n * settings page stretched across a 2560px monitor is unreadable — and wrong for content whose whole\n * value is the space it occupies. Until this enum existed there was no way to tell the two apart, so\n * a canvas had to hand-roll a viewport fraction (`h-[70vh]`), which sizes against the WINDOW rather\n * than the container and therefore ignores whatever chrome sits above it.\n \n Declared per DESTINATION rather than per zone: the same primary zone hosts a list that wants the\n * cap, a detail page that caps itself, and a graph that wants neither.\n \n Width and height are separable on purpose. A wide data table wants the cap gone and its natural\n * height; collapsing both into one boolean would merge two meanings, and two independent booleans\n * would make \"full height, still capped at 80rem\" representable — a combination nothing wants and\n * someone would eventually author by accident.\n /\n\n/\n Full zone configuration.\n \n Each declared zone in the layout owns its complete behavior:\n * which transition fires for each operation, how content appears,\n * and how the zone responds to viewport changes.\n \n Note: `minWidth`, `maxWidth`, `defaultVisible`, `onEmpty`,\n * and `responsiveCollapse` are only meaningful for secondary and companion zones.\n * Primary never collapses, never empties, and takes remaining space.\n * Setting these on primary has no effect.\n /\nexport const ZoneConfigSchema = z.object({\n /\n How this zone manages multiple items.\n * - `NavigationZoneContentModel.SINGLE` (default): stack-based navigation. One item visible, back pops.\n * - `NavigationZoneContentModel.TABBED`: parallel tabs. Tab bar visible, multiple items accessible.\n * @default NavigationZoneContentModel.SINGLE\n /\n contentModel: z.enum(NavigationZoneContentModel).default(NavigationZoneContentModel.SINGLE),\n\n /* Operation → transition mapping. Defines what happens for each user action in this zone. /\n transitions: ZoneTransitionsSchema,\n\n /* Transition → visual appearance. Only split and overlay have appearance choices. /\n appearance: ZoneAppearanceSchema.optional(),\n\n /\n Minimum pixel width when resizing. Constrains how far this side of the\n * split divider can be dragged. Only meaningful for secondary and companion zones.\n * Works in conjunction with `SplitConfigSchema.resizable`.\n /\n minWidth: z.number().positive().optional(),\n\n /\n Maximum pixel width when resizing. Constrains how far this side of the\n * split divider can be dragged. Only meaningful for secondary and companion zones.\n * Works in conjunction with `SplitConfigSchema.resizable`.\n /\n maxWidth: z.number().positive().optional(),\n\n /\n Whether this zone is visible on first render (before any transition targets it).\n * - Primary: always visible (this field is ignored).\n * - Secondary: defaults to `true` when `split.autoSplit` is `true`, `false` otherwise.\n * - Companion: defaults to `false` (hidden until a `split` transition targets it or user toggles).\n /\n defaultVisible: z.boolean().optional(),\n\n /\n What happens when this zone's last content is dismissed (stack empty, last tab closed).\n * - `ZoneEmptyBehavior.COLLAPSE` (default): zone hides, adjacent zones expand to fill.\n * - `ZoneEmptyBehavior.EMPTY_STATE`: zone stays visible with placeholder (\"Select an item to view details\").\n * Only meaningful for secondary and companion zones. Primary never empties.\n /\n onEmpty: z.enum(ZoneEmptyBehavior).optional(),\n\n /\n Responsive collapse rules: what happens when viewport shrinks below the zone's breakpoint.\n * Accepts a plain `ResponsiveCollapseMode` (all breakpoints) or viewport-discriminated object.\n * Only meaningful for secondary and companion zones. Primary never collapses.\n \n When viewport grows back past the breakpoint, collapsed content migrates back\n * to its original zone (content is preserved).\n \n @example\n * responsiveCollapse: ResponsiveCollapseMode.PUSH // always push into primary\n * responsiveCollapse: { [ViewportBreakpoint.VERT_TABLET]: ResponsiveCollapseMode.PUSH, [ViewportBreakpoint.MOBILE]: ResponsiveCollapseMode.OVERLAY } // tablet: push, mobile: overlay\n /\n responsiveCollapse: viewportDiscriminatedSchema(z.enum(ResponsiveCollapseMode)).optional(),\n});\nexport type ZoneConfig = z.infer<typeof ZoneConfigSchema>;\n/* @wildo_source:part:end saas.models.navigation.zone-declaration /\n\n\n// ════════════════════════════════════════════════════════════════\n// App-Level & From-Overlay Configuration\n// ════════════════════════════════════════════════════════════════\n\n/\n App-level navigation configuration: from OUTSIDE the zone system.\n \n Covers navigation triggered by sidebar clicks, command palette selections,\n * hotkey shortcuts, toast actions, and notification clicks.\n \n App-level navigation causes a layout reset: primary content is replaced,\n * secondary and companion zones are cleared. This is fundamentally different\n * from zone-level navigation where the source zone's content persists.\n \n @example\n * appLevel: {\n * transitions: {\n * list: NavigationTransition.REPLACE, // sidebar \"Projects\" → replace primary, clear others\n * read: NavigationTransition.REPLACE, // command palette \"Go to X\" → replace primary\n * create: NavigationTransition.OVERLAY, // quick action \"New X\" → dialog\n * search: NavigationTransition.REPLACE, // command/menu search surface → replace primary\n * },\n * appearance: { overlay: OverlayAppearance.DIALOG },\n * }\n /\nexport const AppLevelConfigSchema = z.object({\n /* Operation → transition mapping for app-level navigation. /\n transitions: ZoneTransitionsSchema,\n /* Appearance overrides for app-level transitions. /\n appearance: ZoneAppearanceSchema.optional(),\n});\nexport type AppLevelConfig = z.infer<typeof AppLevelConfigSchema>;\n\n/\n Navigation from within an overlay (dialog, sheet, or drawer).\n \n When already in an overlay, transitions behave differently to avoid\n * nesting overlays. Typically all operations `push` within the overlay's\n * own stack instead of opening new overlays.\n \n No appearance config — the content is already inside an overlay.\n \n @example\n * fromOverlay: {\n * transitions: {\n * read: NavigationTransition.PUSH, // push within overlay — don't nest modals\n * list: NavigationTransition.PUSH,\n * create: NavigationTransition.PUSH,\n * search: NavigationTransition.PUSH,\n * },\n * }\n /\nexport const FromOverlayConfigSchema = z.object({\n /* Operation → transition mapping when navigating from within an overlay. /\n transitions: ZoneTransitionsSchema,\n});\nexport type FromOverlayConfig = z.infer<typeof FromOverlayConfigSchema>;\n\n\n// ════════════════════════════════════════════════════════════════\n// Split Geometry\n// ════════════════════════════════════════════════════════════════\n\n/\n Companion-specific split geometry.\n * Controls how the companion zone is sized and positioned relative to the main content area.\n /\nexport const CompanionSplitConfigSchema = z.object({\n /\n Main-area-to-companion size ratio.\n * @example [70, 30] — companion takes 30% of available space\n * @default [70, 30]\n /\n ratio: z.tuple([z.number(), z.number()]).default([70, 30]),\n /\n How the companion is positioned relative to the main area.\n * - `DisplayDirection.VERTICAL`: companion on the side (left/right)\n * - `DisplayDirection.HORIZONTAL`: companion below (bottom panel, e.g. VS Code terminal)\n * @default DisplayDirection.VERTICAL\n /\n orientation: z.enum(DisplayDirection).default(DisplayDirection.VERTICAL),\n /\n Whether the companion split boundary is user-draggable.\n * When `true`, a draggable divider appears between the main area and the companion zone.\n * Per-side drag constraints use `ZoneConfig.minWidth`/`maxWidth` on the companion zone.\n * @default false\n /\n resizable: z.boolean().default(false),\n});\nexport type CompanionSplitConfig = z.infer<typeof CompanionSplitConfigSchema>;\n\n/\n Top-level split geometry — describes the physical relationship between zones.\n \n This is a top-level config (not per-zone) because it describes the INTER-zone\n * layout: how much space each zone gets, and the split direction.\n \n @example\n * split: {\n * autoSplit: true, // LIST pre-splits when primary.read = NavigationTransition.SPLIT\n * ratio: [40, 60], // 40% primary, 60% secondary\n * orientation: DisplayDirection.VERTICAL, // side-by-side\n * resizable: true, // divider is draggable\n * companion: {\n * ratio: [70, 30], // companion takes 30%\n * orientation: DisplayDirection.HORIZONTAL, // bottom panel\n * resizable: true,\n * },\n * }\n /\nexport const SplitConfigSchema = z.object({\n /\n Whether the primary zone pre-splits on initial load.\n * When `true` and `primary.transitions.read === NavigationTransition.SPLIT`, the secondary zone\n * appears immediately with the first list item selected (or empty state).\n * @default false\n /\n autoSplit: z.boolean().default(false),\n /\n Primary-to-secondary width/height ratio. Defines the initial proportion.\n * When `resizable` is `true`, user drag overrides this (persisted to localStorage).\n * @example [40, 60] — primary gets 40%, secondary gets 60%\n * @default [50, 50]\n /\n ratio: z.tuple([z.number(), z.number()]).default([50, 50]),\n /\n Split direction between primary and secondary.\n * - `DisplayDirection.VERTICAL` (default): side-by-side (most common for list-detail)\n * - `DisplayDirection.HORIZONTAL`: top-bottom (less common)\n * @default DisplayDirection.VERTICAL\n /\n orientation: z.enum(DisplayDirection).default(DisplayDirection.VERTICAL),\n /\n Whether the primary↔secondary split boundary is user-draggable.\n * When `true`, a draggable divider appears between primary and secondary zones.\n * Per-side drag constraints use `ZoneConfig.minWidth`/`maxWidth` on each zone.\n * @default false\n /\n resizable: z.boolean().default(false),\n /* Companion zone split geometry. Only relevant if companion zone is declared. /\n companion: CompanionSplitConfigSchema.optional(),\n});\nexport type SplitConfig = z.infer<typeof SplitConfigSchema>;\n\n\n// ════════════════════════════════════════════════════════════════\n// Viewport Override Block\n// ════════════════════════════════════════════════════════════════\n\n/\n Global viewport override — applies across ALL zones at a given breakpoint.\n \n Use for sweeping mobile/tablet overrides that affect the entire app.\n * For per-zone responsive behavior, use `ZoneConfig.responsiveCollapse` and\n * viewport-discriminated appearance values instead.\n \n @example\n * // In NavigationLayout:\n * [ViewportBreakpoint.MOBILE]: {\n * transitions: {\n * read: NavigationTransition.PUSH, // mobile: no splits, everything pushes\n * create: { transition: NavigationTransition.OVERLAY, ephemeral: true }, // mobile: create opens as an inspect-style ephemeral overlay\n * },\n * }\n /\nexport const ViewportOverrideSchema = z.object({\n /* Operation → transition overrides at this viewport. Merged over zone defaults. /\n transitions: (z.partialRecord(\n z.enum(CoreResourceOperation),\n TransitionConfigSchema,\n ) as unknown as z.ZodType<Partial<Record<CoreResourceOperation, TransitionConfig>>>).optional(),\n});\nexport type ViewportOverride = z.infer<typeof ViewportOverrideSchema>;\n\n\n// ════════════════════════════════════════════════════════════════\n// NavigationLayout — Top-Level App Configuration\n// ════════════════════════════════════════════════════════════════\n\n/\n @wildo_source:part:start saas.models.navigation.layout facet:layer:shared facet:family:navigation-config\n \n The complete navigation layout configuration for an application.\n \n This is the single configuration object that defines the entire navigation\n * behavior. It specifies which zones exist, how each zone handles operations,\n * how zones are sized relative to each other, and global overrides.\n \n Resolution order (from highest to lowest priority):\n * 1. Per-operation frontend override (`operation.operationFrontendConfig.navigationOverrides`)\n * 2. Per-relationship override (`display.inParentNavigation.transition`)\n * 3. Global viewport override (`ViewportBreakpoint.MOBILE` / `ViewportBreakpoint.VERT_TABLET` blocks)\n * 4. Source context `transitions[operation]` + `appearance[transition]`\n * 5. Framework hardcoded fallback\n \n @example\n * const layout: NavigationLayout = {\n * zones: {\n * primary: { transitions: { read: NavigationTransition.SPLIT, create: NavigationTransition.OVERLAY, update: NavigationTransition.INPLACE } },\n * secondary: { transitions: { read: NavigationTransition.PUSH }, onEmpty: ZoneEmptyBehavior.COLLAPSE },\n * },\n * appLevel: { transitions: { list: NavigationTransition.REPLACE, create: NavigationTransition.OVERLAY } },\n * fromOverlay: { transitions: { read: NavigationTransition.PROMOTE } },\n * split: { autoSplit: true, ratio: [40, 60] },\n * maxDepth: 2,\n * };\n /\n/\n WHICH LAYER OWNS THE BACK AFFORDANCE.\n \n Two layers can render a back control for the same navigation stack: the app\n * SHELL (the menubar's hosted navigation control) and the current SURFACE (a\n * resource/view header, beside the icon + title + breadcrumb). Both mount the\n * same component, so without an explicit owner an app that hosts the shell\n * control gets TWO back arrows on every pushed page — one floating in the bar\n * with no context, one attached to the thing it goes back from.\n \n This is deliberately a POLICY rather than a per-surface flag: \"who owns this\n * chrome\" is one application-wide decision, and expressing it as an owner makes\n * the duplication unrepresentable instead of asking every surface to remember\n * to suppress itself.\n /\nexport enum NavigationBackAffordanceOwner {\n /\n The current surface's own header owns it — the back control sits beside the\n * surface's icon/title/breadcrumb, so it reads as \"back from THIS\". The shell\n * control renders nothing even when hosted. Default: it keeps the affordance\n * attached to its context, and matches the shell staying free of a lone,\n * context-free arrow.\n /\n SURFACE = 'surface',\n /\n The app shell's navigation control owns it — one fixed back control in the\n * menubar (the Notion-style top-left placement). Surface headers render none.\n * Requires the shell to actually host `NAVIGATION_CONTROL`; if it does not,\n * the application has no back affordance at all.\n /\n SHELL = 'shell',\n /\n BOTH layers render one. An explicit opt-in for layouts where the two\n * genuinely differ — e.g. a multi-zone shell whose bar control pops the\n * focused zone while each zone's header pops its own stack. Chosen\n * deliberately; never a default.\n /\n BOTH = 'both',\n}\n\n/* Default owner when a layout declares none — see {@link NavigationBackAffordanceOwner.SURFACE}. /\nexport const DEFAULT_NAVIGATION_BACK_AFFORDANCE_OWNER: NavigationBackAffordanceOwner = NavigationBackAffordanceOwner.SURFACE;\n\n/\n Does `owner` grant the SHELL (menubar navigation control) a back affordance?\n * Shared by both render sites so the two can never disagree about one policy.\n /\nexport function navigationBackAffordanceAdmitsShell(owner: NavigationBackAffordanceOwner \| undefined): boolean {\n const resolved = owner ?? DEFAULT_NAVIGATION_BACK_AFFORDANCE_OWNER;\n return resolved === NavigationBackAffordanceOwner.SHELL \|\| resolved === NavigationBackAffordanceOwner.BOTH;\n}\n\n/* Does `owner` grant the current SURFACE's header a back affordance? /\nexport function navigationBackAffordanceAdmitsSurface(owner: NavigationBackAffordanceOwner \| undefined): boolean {\n const resolved = owner ?? DEFAULT_NAVIGATION_BACK_AFFORDANCE_OWNER;\n return resolved === NavigationBackAffordanceOwner.SURFACE \|\| resolved === NavigationBackAffordanceOwner.BOTH;\n}\n\nexport const NavigationLayoutSchema = z.object({\n /\n Zone declarations. Primary is required, secondary and companion are optional.\n * Undeclared zones cannot be targeted by transitions — `NavigationTransition.SPLIT` in a layout\n * without secondary will escalate to overlay.\n /\n zones: z.object({\n /* Primary zone — always exists. Main content area (lists, root reads). /\n primary: ZoneConfigSchema,\n /* Secondary zone — optional. First adjacent zone for detail content. /\n secondary: ZoneConfigSchema.optional(),\n /* Companion zone — optional. Persistent supplementary content. /\n companion: ZoneConfigSchema.optional(),\n }),\n /\n How navigation from the app shell (sidebar, command palette, hotkey) behaves.\n * Causes a layout reset when targeting primary.\n /\n appLevel: AppLevelConfigSchema.optional(),\n /\n How navigation within an overlay behaves.\n * Prevents overlay nesting — typically everything pushes within the overlay stack.\n /\n fromOverlay: FromOverlayConfigSchema.optional(),\n /* Split geometry: ratios, orientations, autoSplit. /\n split: SplitConfigSchema.optional(),\n /\n Maximum push depth before the framework escalates to overlay.\n * When a zone's stack depth reaches `maxDepth`, the next `push` opens an overlay instead.\n * Prevents infinitely deep navigation stacks. Per-relationship `maxDepth` can override.\n /\n maxDepth: z.number().int().positive().optional(),\n\n /\n Which layer renders the back control — see {@link NavigationBackAffordanceOwner}.\n * Omitted means {@link DEFAULT_NAVIGATION_BACK_AFFORDANCE_OWNER} (the surface's\n * own header), which is what keeps a shell that hosts `NAVIGATION_CONTROL`\n * from rendering a second, context-free back arrow beside every page's own.\n /\n backAffordanceOwner: z.enum(NavigationBackAffordanceOwner).optional(),\n\n /\n Mobile viewport override — applies across all zones when viewport is `<md` (< 768px).\n * Use for sweeping mobile behavior changes (e.g., all splits become pushes).\n /\n [ViewportBreakpoint.MOBILE]: ViewportOverrideSchema.optional(),\n /\n Tablet viewport override — applies across all zones when viewport is `<lg` (768–1023px).\n * Use for tablet-specific behavior changes.\n /\n [ViewportBreakpoint.VERT_TABLET]: ViewportOverrideSchema.optional(),\n});\nexport type NavigationLayout = z.infer<typeof NavigationLayoutSchema>;\n/* @wildo_source:part:end saas.models.navigation.layout */\n\n// ════════════════════════════════════════════════════════════════\n// Per-Resource Operation Override\n// ════════════════════════════════════════════════════════════════\n\n// DELETED — NavigationOperationOverrideSchema and NavigationOperationOverride\n// Transferred to @wildo-ai/saas-frontend-lib (resources.frontend.schemas)\n"]}
1	+ {"version":3,"file":"navigation.shared.schemas.js","sourceRoot":"","sources":["../../../../../src/config/frontend/navigation.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Navigation — Configuration Schemas\n \n Zone-first, operation-driven navigation configuration model.\n * Decomposes navigation into four independent axes:\n \n 1. Meaning (input signals) — contextual facts at navigation time (source zone, operation,\n * cardinality, viewport, depth). NOT configured — these are inputs to resolution.\n * 2. Transition (verb) — HOW content arrives: push, replace, split, overlay, inplace, promote.\n * This is the primary thing that gets configured per zone.\n * 3. Placement (zones) — WHERE content lives: primary, secondary, companion, overlay.\n * Zones are structural layout areas AND source context for resolution.\n * 4. Appearance (visual) — HOW content renders in its slot: panel, drawer, dialog, sheet.\n * Only meaningful for split and overlay transitions.\n \n Key design decisions:\n * - Zones own their complete behavior (no global defaults + override pattern)\n * - Operations are transition keys; cardinality drives appearance only\n * - Embedding (tabs/sections within a parent) is view composition, not navigation\n * - `contentModel` (single/tabbed) is orthogonal to transitions\n \n @see _code_archive/docs-archive/navigation/navigation-v3-reflection.md\n /\n\nimport { z } from 'zod';\nimport { ViewportBreakpoint, DisplayDirection } from '@wildo-ai/zod-decorators';\nimport { CoreResourceOperation } from '../../resources/resources.shared.core.definitions';\n\n\n// ════════════════════════════════════════════════════════════════\n// Enums\n// ════════════════════════════════════════════════════════════════\n\n/\n Navigation transition verbs — HOW content arrives at its destination.\n \n These are the six fundamental navigation actions. Every user-triggered\n * navigation event resolves to exactly one of these verbs. The source zone's\n * `transitions` map determines which verb fires for each operation.\n \n Four zone-level transitions: `push`, `replace`, `split`, `overlay`\n * Two cross-context transitions: `inplace` (element-level), `promote` (escape to primary)\n \n `push` behavior depends on the zone's `contentModel`:\n * - In `single` zones: stack-based (new content on top, back pops)\n * - In `tabbed` zones: opens a new tab and makes it active (an already-open record is NOT\n * de-duplicated — it opens again)\n \n @wildo_source:part:start saas.models.navigation.transition-vocabulary facet:layer:shared facet:family:navigation-config\n /\nexport enum NavigationTransition {\n /\n Content added to the zone's stack (single) or as a new tab (tabbed).\n * Back navigation pops the stack or switches to the previous tab.\n * URL adds a new path segment.\n /\n PUSH = 'push',\n /\n Content replaces the current content in the zone. No stack entry — the previous\n * content is gone from the zone's state (but remains in browser history).\n * URL replaces the current segment.\n /\n REPLACE = 'replace',\n /\n Content opens in an adjacent zone (secondary or companion).\n * Creates a side-by-side layout. The source zone's content remains visible.\n * Back navigation un-splits (closes the adjacent zone).\n * URL: the detail's own address beside a resource primary; beside any other primary the host\n * keeps its URL and a RESOURCE detail rides as `?pane=`. There is no split segment.\n /\n SPLIT = 'split',\n /\n Content opens in a floating layer above the entire layout (dialog, sheet, or drawer).\n * The underlying layout remains visible; it is non-interactive while the overlay is modal (the\n * default), and stays interactive under `overlayBehavior.modal: false`.\n * Back navigation or Escape dismisses the overlay.\n * NOT URL-addressed: opening an overlay leaves the browser URL where it was, so its content cannot\n * be linked to or restored by a reload. Choose it knowing that.\n /\n OVERLAY = 'overlay',\n /\n Element-level transformation within the current view. A specific item in a\n * list/section transforms from one mode to another (read → edit); a CREATE\n * materializes a new element beside the existing ones. The parent view stays,\n * the zone stack is unchanged, and surrounding items remain visible.\n \n Fundamentally different from `replace` (which swaps the entire zone content).\n * `inplace` operates at the element level, not the zone level.\n \n No lifecycle modifiers (`persistent`/`ephemeral`) are valid on `inplace`.\n * No appearance to configure — the element transforms within its existing slot.\n \n It is the one transition that does not place content in a zone, which is\n * why the controller hands it to the element-level host\n * (`InPlaceOperationContext`) instead of resolving a target zone for it. That\n * host is provided by the COLLECTION the element belongs to, so a transition\n * resolving to `inplace` on a surface with no collection above it — a detail\n * page, a breadcrumb, a picker — degrades to an OVERLAY.\n \n It is TRANSIENT: no URL, and a reload returns the view to rest. Earlier\n * revisions of this comment promised a query param (`?editing=<childId>` /\n * `?creating=<resourceType>`) and none was ever written. It is not written now\n * either, and that is a decision rather than an omission: an inline row-edit is\n * a momentary state of a listing, not a place — no comparable admin framework\n * deep-links one, and anything that should survive a reload or a back button\n * wants `push`. `ResourceOperationActionPresentation.INLINE`, the per-operation\n * tier that selects the same host, is transient for the same reason.\n \n @example\n * // Click \"edit\" on a child in parent's inline section → item transforms to edit form\n * transitions: { [CoreResourceOperation.UPDATE]: NavigationTransition.INPLACE }\n \n // Click \"add\" in a relationship section → create form appears inline in the list\n * transitions: { [CoreResourceOperation.CREATE]: NavigationTransition.INPLACE }\n /\n INPLACE = 'inplace',\n /\n Escape the current context and open content at primary scope.\n * Abandons the current context: overlays close, companion/secondary dismiss — except a pane\n * placed by a `persistent` split, which survives a reset by design.\n * The promoted content becomes the primary zone's top content.\n \n Use case: a link within an overlay should open as a full primary view,\n * or a nested detail in a companion zone should \"pop out\" to primary.\n \n Fundamentally different from `push` (which stays in the current zone) and\n * from `replace` (which replaces content within the same zone). `promote`\n * crosses zones and always targets primary.\n \n No lifecycle modifiers (`persistent`/`ephemeral`) are valid on `promote`.\n * No appearance to configure — content fills primary (same as push/replace).\n \n URL serialization: full URL change (promoted resource becomes the primary route).\n \n @example\n * // From an overlay, a link should open as primary (close overlay, show in primary)\n * transitions: { [CoreResourceOperation.READ]: NavigationTransition.PROMOTE }\n /\n PROMOTE = 'promote',\n}\n/* @wildo_source:part:end saas.models.navigation.transition-vocabulary /\n\n/\n Named layout zones — configurable structural areas WHERE content lives.\n \n Zones serve four purposes:\n * 1. Structural — which physical areas exist in the layout (declared in config)\n * 2. Source context — the same operation resolves differently FROM primary vs FROM secondary\n * 3. Responsive — each zone carries its own collapse behavior per viewport\n * 4. Content model — each zone independently manages single-stack or tabbed content\n \n Note: `overlay` is NOT a named zone — it's an implicit layer always available.\n * Overlay is a runtime destination, not a configurable zone. See `NavigationZone`\n * in the frontend runtime types for the full set including overlay.\n \n @wildo_source:part:start saas.models.navigation.surface-vocabulary facet:layer:shared facet:family:navigation-config\n /\nexport enum NavigationZoneName {\n /* Main content area. Lists, root-level reads, primary workspace. Always exists. /\n PRIMARY = 'primary',\n /\n First adjacent zone. Detail content in list-detail patterns.\n * Only exists if declared in config. Appears when a `split` transition targets it.\n * Typical use: showing item details alongside a list.\n /\n SECONDARY = 'secondary',\n /\n Persistent supplementary content. Reference panels, docs, notes, threads.\n * Only exists if declared in config, and starts hidden.\n * Reached by a `split` with `persistent: true`, or by an ordinary `split` when the secondary zone\n * is already occupied.\n * Typical use: Slack thread panel, VS Code terminal, documentation sidebar.\n /\n COMPANION = 'companion',\n}\n\n/\n How a zone manages multiple items. Orthogonal to transitions.\n \n The transition says \"content arrives\" — the content model says\n * \"how does the zone accommodate it.\" Any zone can use any content model,\n * regardless of which transitions it supports.\n /\nexport enum NavigationZoneContentModel {\n /\n Navigation stack: new content pushes on top, previous preserved underneath.\n * Only one item visible at a time. Back navigation pops the stack.\n * `replace` replaces the top without adding to the stack.\n * This is the default for all zones.\n /\n SINGLE = 'single',\n /\n Parallel tabs: every navigation landing in the zone opens a new tab and makes it active (no\n * de-duplication). Tab bar is visible, showing all open tabs. No depth stack within tabs.\n * `replace` replaces the active tab's content, and back closes the active tab and shows its\n * neighbour. The model changes RENDERING only — it does not change how navigation resolves.\n * When no tabs remain, `onEmpty` behavior applies.\n /\n TABBED = 'tabbed',\n}\n\n/\n Responsive collapse behavior when viewport shrinks below a zone's breakpoint.\n \n Only applies to secondary and companion zones. Primary never collapses.\n * It applies to content ALREADY in the zone, not only to new navigations: when the zone collapses its\n * whole history moves (a tabbed zone's tabs too, the one on screen on top), and when the viewport\n * grows back what is still on top of primary migrates home with every field intact. Whatever the\n * reader navigated past at the narrow width stays where it is.\n /\nexport enum ResponsiveCollapseMode {\n /\n Zone hides. Its content joins primary's navigation stack.\n * The user sees the content in-context within primary.\n * Back navigation pops back to primary's previous content.\n /\n PUSH = 'push',\n /\n Zone hides. Its content opens as an overlay on top of primary.\n * The user sees the content as a floating sheet/dialog.\n * Dismiss returns to the underlying primary content.\n /\n OVERLAY = 'overlay',\n}\n/* @wildo_source:part:end saas.models.navigation.surface-vocabulary /\n\n/\n @wildo_source:part:start saas.models.navigation.zone-declaration facet:layer:shared facet:family:navigation-config\n \n What happens when a zone's last content is dismissed.\n * Only meaningful for secondary and companion zones (primary never empties,\n * overlay auto-dismisses by definition).\n /\nexport enum ZoneEmptyBehavior {\n /\n Zone hides, adjacent zones expand to fill the space.\n * Example: closing the last detail → layout returns to list-only.\n * This is the default for all non-primary zones.\n /\n COLLAPSE = 'collapse',\n /\n Zone stays visible with an empty-state placeholder.\n * Example: \"Select an item to view details\" message. Keeps layout stable.\n * Useful when the user frequently toggles between items.\n /\n EMPTY_STATE = 'emptyState',\n}\n/* @wildo_source:part:end saas.models.navigation.zone-declaration /\n\n/\n @wildo_source:part:start saas.models.navigation.surface-vocabulary facet:layer:shared facet:family:navigation-config\n \n Visual presentation for overlay transitions.\n * Determines how floating content renders above the layout.\n /\nexport enum OverlayAppearance {\n /\n Centered modal dialog with backdrop.\n * Best for focused tasks: create forms, confirmations, destructive actions.\n * Blocks underlying content visually. Escape or backdrop click dismisses.\n /\n DIALOG = 'dialog',\n /\n Side or bottom drawer panel that slides in from an edge.\n * Best for contextual content that benefits from seeing the underlying layout.\n * Less disruptive than dialog. Common for detail views on mobile.\n /\n SHEET = 'sheet',\n /\n Vaul-backed mobile drawer.\n * Use when the navigation resolver should choose a drawer directly rather\n * than relying on a dialog appearance plus mobileShape policy.\n /\n DRAWER = 'drawer',\n}\n\n/\n * ─── `SplitAppearance` was REMOVED on 2026-09-25, and the reason is worth keeping ───────────────\n \n It declared `PANEL` (\"vertical side panel\") and `DRAWER` (\"horizontal drawer, bottom panel\"), and\n * the whole sub-tree was WRITE-ONLY: the resolver computed it, the controller stored it on the stack\n * entry, and the ONLY site reading `entry.appearance` cast it to `OverlayAppearance` for the overlay\n * container. No split renderer branched on it. So `DRAWER` could never render — an author who wrote\n * it got a vertical side panel with no diagnostic — and `PANEL` was a value meaning \"the default\".\n \n It was also a SECOND vocabulary for an axis `SplitConfig.orientation` already owns:\n * `orientation: HORIZONTAL` is \"top-bottom\", which is what `DRAWER` described. The two were\n * independently authorable in contradiction, with no refine and nothing honouring either against the\n * other.\n \n Collapsed to ONE source — `SplitConfig.orientation`, which the renderer genuinely reads — per\n * \"measure what the runtime actually reads, then collapse to one source of truth\". `orientation` was\n * additionally made live on the STATIC render branch in the same change; it had been read only by\n * the resizable branch, so `HORIZONTAL` + `resizable: false` silently produced a side panel.\n \n `entry.appearance` is now `OverlayAppearance` alone, which removes the unchecked downcast at its\n * one reader. The removal follows the precedent already set here for `defaultVisible`, `autoSplit`\n * and `CompanionSplitConfig.orientation`: a declared-but-unread field is deleted, not deprecated.\n /\n/* @wildo_source:part:end saas.models.navigation.surface-vocabulary /\n\n// ════════════════════════════════════════════════════════════════\n// ViewportDiscriminated — Generic responsive override pattern\n// ════════════════════════════════════════════════════════════════\n\n/\n A value that is either a plain `T` (applies at all viewports) or a\n * viewport-keyed partial record for per-breakpoint control.\n \n This pattern is used throughout the navigation config for responsive properties:\n * `responsiveCollapse`, `appearance`, `contentSectionConfig`, `transition`.\n \n @example\n * // Plain value — same everywhere\n * responsiveCollapse: ResponsiveCollapseMode.PUSH\n \n // Viewport-discriminated — different per breakpoint\n * responsiveCollapse: { [ViewportBreakpoint.VERT_TABLET]: ResponsiveCollapseMode.PUSH, [ViewportBreakpoint.MOBILE]: ResponsiveCollapseMode.OVERLAY }\n \n // Overlay appearance — sheet on tablet, drawer on mobile\n * overlay: { [ViewportBreakpoint.VERT_TABLET]: OverlayAppearance.SHEET, [ViewportBreakpoint.MOBILE]: OverlayAppearance.DRAWER }\n /\nexport type ViewportDiscriminated<T> = T \| Partial<Record<ViewportBreakpoint, T>>;\n\n/\n Zod schema factory for `ViewportDiscriminated<T>`.\n \n Produces a union: the plain inner schema OR a record keyed by `ViewportBreakpoint`\n * with inner schema values. The record must have at least one key.\n \n @param innerSchema - Zod schema for the value type at each breakpoint.\n /\nexport function viewportDiscriminatedSchema<T extends z.ZodType>(innerSchema: T) {\n return z.union([\n innerSchema,\n z.partialRecord(z.enum(ViewportBreakpoint), innerSchema).refine(\n (obj) => Object.keys(obj).length > 0,\n { message: 'Viewport-discriminated object must have at least one breakpoint key' },\n ),\n ]);\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Transition Config\n// ════════════════════════════════════════════════════════════════\n\n/\n Extended transition with lifecycle modifiers.\n \n Most transitions are simple verbs (just the enum value). The object form\n * adds lifecycle semantics for two specific patterns:\n \n - Companion pattern: `{ transition: NavigationTransition.SPLIT, persistent: true }`\n * The split zone persists when the source zone's content changes.\n * Without `persistent`, a split zone would clear when primary navigates away.\n \n - Inspect pattern: `{ transition: NavigationTransition.OVERLAY, ephemeral: true }`\n * The overlay auto-closes when the source zone's stack changes.\n * Without `ephemeral`, overlays stay open until explicitly dismissed.\n \n Semantic constraints (enforced by `.refine()`):\n * - `persistent` is only valid on `split` transitions\n * - `ephemeral` is only valid on `overlay` transitions\n * - `persistent` and `ephemeral` are mutually exclusive\n * - `inplace` and `promote` do not accept any modifier (they are always simple verbs)\n /\nexport const TransitionObjectSchema = z.object({\n /* The transition verb. /\n transition: z.enum(NavigationTransition),\n /\n When `true`, the split zone persists when the source zone navigates away.\n * Only valid on `split` transitions. Targets the companion zone specifically\n * (rather than the default adjacent zone resolution).\n \n Example: Slack thread panel stays open when switching channels.\n /\n persistent: z.boolean().optional(),\n /\n When `true`, the overlay auto-closes when the source zone's stack changes.\n * Only valid on `overlay` transitions.\n \n Example: Quick-inspect preview that dismisses when the user clicks another item.\n /\n ephemeral: z.boolean().optional(),\n}).refine(\n (obj) => {\n if (obj.persistent && obj.transition !== NavigationTransition.SPLIT) return false;\n if (obj.ephemeral && obj.transition !== NavigationTransition.OVERLAY) return false;\n if (obj.persistent && obj.ephemeral) return false;\n return true;\n },\n { message: 'persistent is only valid on split; ephemeral is only valid on overlay; they are mutually exclusive' },\n);\nexport type TransitionObject = z.infer<typeof TransitionObjectSchema>;\n\n/\n A transition configuration: either a simple verb string or an object with modifiers.\n \n @example\n * // Simple verb\n * transitions: { read: NavigationTransition.SPLIT, create: NavigationTransition.OVERLAY }\n \n // Object with lifecycle modifier\n * transitions: { read: { transition: NavigationTransition.SPLIT, persistent: true } }\n /\nexport const TransitionConfigSchema = z.union([\n z.enum(NavigationTransition),\n TransitionObjectSchema,\n]);\nexport type TransitionConfig = z.infer<typeof TransitionConfigSchema>;\n\n\n// ════════════════════════════════════════════════════════════════\n// Zone Configuration\n// ════════════════════════════════════════════════════════════════\n\n/\n Operation → transition mapping for a zone.\n \n Partial record — only operations that the zone handles need entries.\n * Missing operations fall back to the framework's hardcoded defaults.\n \n Keys are `CoreResourceOperation` values such as `read`, `list`, `create`,\n * `update`, `delete`, and `search`.\n \n @example\n * transitions: {\n * read: NavigationTransition.SPLIT, // click item → split to secondary\n * list: NavigationTransition.REPLACE, // \"View all\" → replace primary\n * create: NavigationTransition.OVERLAY, // new item → dialog\n * update: NavigationTransition.INPLACE, // edit → transform element inline\n * delete: NavigationTransition.OVERLAY, // confirm → dialog\n * search: NavigationTransition.PUSH, // advanced search → full-surface route\n * }\n \n // From an overlay, promote a link to primary view\n * transitions: {\n * read: NavigationTransition.PROMOTE, // link in overlay → escape to primary\n * }\n /\n/* Partial record — only operations that the zone handles need entries. Missing operations fall back to framework defaults. /\nexport const ZoneTransitionsSchema = z.partialRecord(\n z.enum(CoreResourceOperation),\n TransitionConfigSchema,\n) as unknown as z.ZodType<Partial<Record<CoreResourceOperation, TransitionConfig>>>;\nexport type ZoneTransitions = Partial<Record<CoreResourceOperation, TransitionConfig>>;\n\n/\n Transition → visual appearance for a zone. Values are viewport-discriminated.\n \n Only the `overlay` transition has an appearance choice. The others have none to configure:\n * - `push`/`replace` fill the zone\n * - `split` opens a pane whose shape is `split.orientation` (there is no split appearance)\n * - `inplace` transforms an element within the current view\n * - `promote` fills primary (same as push/replace)\n \n @example\n * appearance: {\n * overlay: { [ViewportBreakpoint.VERT_TABLET]: OverlayAppearance.SHEET, [ViewportBreakpoint.MOBILE]: OverlayAppearance.DRAWER }, // sheet on tablet, drawer on mobile\n * }\n /\nexport const ZoneAppearanceSchema = z.object({\n /\n How overlay content renders. Default: `OverlayAppearance.DIALOG` (centered modal).\n \n There is deliberately no `split` sibling: how a PANE renders is `SplitConfig.orientation` plus\n * the zone's width bounds, which the renderer reads. See the note where `SplitAppearance` used to\n * be declared.\n /\n overlay: viewportDiscriminatedSchema(z.enum(OverlayAppearance)).optional(),\n});\nexport type ZoneAppearance = z.infer<typeof ZoneAppearanceSchema>;\n\n/\n @wildo_source:part:start saas.models.navigation.zone-declaration facet:layer:shared facet:family:navigation-config\n \n How much of its zone a destination's content occupies is NOT declared here: it is the\n * destination's `ZoneContentGeometry` (a `maxWidth` and a `fillsHeight`), because the same primary\n * zone hosts a list that wants the width cap, a detail that caps itself, and a graph that wants\n * neither. A zone's own declaration follows.\n /\n\n/\n Full zone configuration.\n \n Each declared zone in the layout owns its complete behavior:\n * which transition fires for each operation, how content appears,\n * and how the zone responds to viewport changes.\n \n Note: `minWidth`, `maxWidth`, `onEmpty` and `responsiveCollapse` are only meaningful for\n * secondary and companion zones. Primary never collapses, never empties, and takes remaining space.\n * Setting these on primary has no effect.\n \n ## Every field here is READ by the runtime, and that was checked rather than assumed (#211)\n \n \| field \| the reader \|\n * \|---\|---\|\n * \| `contentModel` \| `NavigationContentAreas.tsx` (TABBED detection) + `zone-visible-entry.ts` \|\n * \| `transitions` \| `navigation-policy-resolver.service.ts` \|\n * \| `appearance` \| the policy resolver (`appearance.overlay` — there is no split appearance) \|\n * \| `minWidth` / `maxWidth` \| `NavigationContentAreas.tsx` drag constraints, both split branches \|\n * \| `onEmpty` \| `zone-empty-behavior.ts` \|\n * \| `responsiveCollapse` \| `navigation-policy-resolver.service.ts` \|\n \n `defaultVisible` was REMOVED by that audit: nothing read it, and its only documented meaning was\n * \"defaults to `true` when `split.autoSplit` is `true`\" — a field defined in terms of another field\n * that was also dead. What it was reaching for is `onEmpty`, which every current layout already uses\n * (`zoneOccupiesSpaceWhenEmpty`) and which the runtime genuinely reads.\n /\nexport const ZoneConfigSchema = z.object({\n /\n How this zone manages multiple items.\n * - `NavigationZoneContentModel.SINGLE` (default): stack-based navigation. One item visible, back pops.\n * - `NavigationZoneContentModel.TABBED`: parallel tabs. Tab bar visible, multiple items accessible.\n * @default NavigationZoneContentModel.SINGLE\n /\n contentModel: z.enum(NavigationZoneContentModel).default(NavigationZoneContentModel.SINGLE),\n\n /* Operation → transition mapping. Defines what happens for each user action in this zone. /\n transitions: ZoneTransitionsSchema,\n\n /* Which shape an OVERLAY opened from this zone takes. Only overlays have an appearance: a pane's shape is `split.orientation`. /\n appearance: ZoneAppearanceSchema.optional(),\n\n /\n Minimum pixel width when resizing. Constrains how far this side of the\n * split divider can be dragged. Only meaningful for secondary and companion zones, and only when\n * that zone is resizable — `SplitConfigSchema.resizable` for secondary, `split.companion.resizable`\n * for companion (independent flags).\n \n The pixel value is converted to a share of the content area and clamped to 5–70%. When OMITTED on\n * a resizable zone the floor is 25% of the content area — or the zone's own ratio share, if that is\n * smaller — never zero. A pane is never collapsed by dragging it: closing a pane is navigation.\n \n A declared `maxWidth` narrower than this floor lowers the floor to it. When the shown side panes ask\n * for more than primary's 25% leaves, they shrink in proportion and none opens below its floor (a\n * non-resizable pane's floor is 25%, or its own ratio share if smaller); primary opens at exactly 25%.\n * The floors are pixels, so at a narrow window they may not fit together at all — they then give way\n * to each other in proportion, and the smaller floor a pane opens at is its drag floor. Primary never\n * gives way.\n \n ## It is ALSO a COLLAPSE TRIGGER, on every zone — not only a drag bound\n \n The paragraph above restricts this to resizing, and that stopped being the whole truth when the\n * content-area fit escalation landed: `resolveCollapseMode` feeds `minWidth` to\n * `contentAreaFitsSplit`, for resizable and non-resizable zones alike. A zone declaring\n * `minWidth: W` needs `W / 0.75` of content width beside primary's 25% floor, and below that the\n * split escalates rather than squeezing both panes under their floors.\n \n So a NON-resizable pane with `minWidth: 600` stops splitting on a 1000px content area at full\n * desktop width — correct behaviour, and the opposite of what this field's own contract said until\n * 2026-09-25. Declare it when you mean \"this pane is not worth opening narrower than W\", and omit\n * it when you only want a drag floor on a layout that is not resizable anyway.\n /\n minWidth: z.number().positive().optional(),\n\n /\n Maximum pixel width when resizing. Constrains how far this side of the\n * split divider can be dragged. Only meaningful for secondary and companion zones, and only when\n * that zone is resizable — `SplitConfigSchema.resizable` for secondary, `split.companion.resizable`\n * for companion (independent flags).\n \n The pixel value is converted to a share of the content area and clamped to 5–70%. When OMITTED on\n * a resizable zone the ceiling is whatever leaves the primary zone 25% of the content area.\n /\n maxWidth: z.number().positive().optional(),\n\n /\n What happens when this zone's last content is dismissed (stack empty, last tab closed).\n * - `ZoneEmptyBehavior.COLLAPSE` (default): zone hides, adjacent zones expand to fill.\n * - `ZoneEmptyBehavior.EMPTY_STATE`: zone stays visible with placeholder (\"Select an item to view details\").\n * Only meaningful for secondary and companion zones. Primary never empties.\n /\n onEmpty: z.enum(ZoneEmptyBehavior).optional(),\n\n /\n Responsive collapse rules: what happens when viewport shrinks below the zone's breakpoint.\n * Accepts a plain `ResponsiveCollapseMode` (all breakpoints) or viewport-discriminated object.\n * Only meaningful for secondary and companion zones. Primary never collapses.\n \n It moves content already in the zone as well as new navigations: the zone's whole history\n * moves when it collapses, and what is still on top of primary goes home when it returns — see\n * `ResponsiveCollapseMode`.\n \n @example\n * responsiveCollapse: ResponsiveCollapseMode.PUSH // always push into primary\n * responsiveCollapse: { [ViewportBreakpoint.VERT_TABLET]: ResponsiveCollapseMode.PUSH, [ViewportBreakpoint.MOBILE]: ResponsiveCollapseMode.OVERLAY } // tablet: push, mobile: overlay\n /\n responsiveCollapse: viewportDiscriminatedSchema(z.enum(ResponsiveCollapseMode)).optional(),\n});\nexport type ZoneConfig = z.infer<typeof ZoneConfigSchema>;\n/* @wildo_source:part:end saas.models.navigation.zone-declaration /\n\n\n// ════════════════════════════════════════════════════════════════\n// App-Level & From-Overlay Configuration\n// ════════════════════════════════════════════════════════════════\n\n/\n App-level navigation configuration: from OUTSIDE the zone system.\n \n Covers navigation triggered by sidebar clicks, command palette selections,\n * hotkey shortcuts, toast actions, and notification clicks.\n \n App-level navigation causes a layout reset: primary content is replaced,\n * secondary and companion zones are cleared. This is fundamentally different\n * from zone-level navigation where the source zone's content persists.\n \n @example\n * appLevel: {\n * transitions: {\n * list: NavigationTransition.REPLACE, // sidebar \"Projects\" → replace primary, clear others\n * read: NavigationTransition.REPLACE, // command palette \"Go to X\" → replace primary\n * create: NavigationTransition.OVERLAY, // quick action \"New X\" → dialog\n * search: NavigationTransition.REPLACE, // command/menu search surface → replace primary\n * },\n * appearance: { overlay: OverlayAppearance.DIALOG },\n * }\n /\nexport const AppLevelConfigSchema = z.object({\n /* Operation → transition mapping for app-level navigation. /\n transitions: ZoneTransitionsSchema,\n /* Appearance overrides for app-level transitions. /\n appearance: ZoneAppearanceSchema.optional(),\n});\nexport type AppLevelConfig = z.infer<typeof AppLevelConfigSchema>;\n\n/\n Navigation from within an overlay (dialog, sheet, or drawer).\n \n When already in an overlay, transitions behave differently to avoid\n * nesting overlays. Typically all operations `push` within the overlay's\n * own stack instead of opening new overlays.\n \n No appearance config — the content is already inside an overlay.\n \n @example\n * fromOverlay: {\n * transitions: {\n * read: NavigationTransition.PUSH, // push within overlay — don't nest modals\n * list: NavigationTransition.PUSH,\n * create: NavigationTransition.PUSH,\n * search: NavigationTransition.PUSH,\n * },\n * }\n /\nexport const FromOverlayConfigSchema = z.object({\n /* Operation → transition mapping when navigating from within an overlay. /\n transitions: ZoneTransitionsSchema,\n});\nexport type FromOverlayConfig = z.infer<typeof FromOverlayConfigSchema>;\n\n\n// ════════════════════════════════════════════════════════════════\n// Split Geometry\n// ════════════════════════════════════════════════════════════════\n\n/\n Companion-specific split geometry.\n * Controls how the companion zone is sized and positioned relative to the main content area.\n /\nexport const CompanionSplitConfigSchema = z.object({\n /\n Main-area-to-companion size ratio.\n * @example [70, 30] — companion takes 30% of available space\n * @default [70, 30]\n /\n ratio: z.tuple([z.number(), z.number()]).default([70, 30]),\n /\n Whether the companion split boundary is user-draggable.\n * When `true`, a draggable divider appears between the main area and the companion zone.\n * Per-side drag constraints use `ZoneConfig.minWidth`/`maxWidth` on the companion zone.\n * @default false\n /\n resizable: z.boolean().default(false),\n});/\n * `orientation` was REMOVED here by the #211 audit, and it is the one removal that took a\n * capability with it. It claimed the companion could sit BELOW the main area (\"bottom panel, e.g.\n * VS Code terminal\") and nothing read it: all three zones share ONE `ResizablePanelGroup` whose\n * `direction` comes from `split.orientation`, so an author writing HORIZONTAL here got a side panel\n * and no diagnostic. Honouring it needs a NESTED panel group, with its own sizes, autoSaveId, drag\n * constraints and responsive-collapse behaviour — a feature, not a field fix. Left as a declared\n * lie it was worse than absent: it ships to application builders in the compiled\n * `config-navigation` skill and answers with silence. Build the nested group first; the field comes\n * back when something reads it.\n /\n\nexport type CompanionSplitConfig = z.infer<typeof CompanionSplitConfigSchema>;\n\n/\n Top-level split geometry — describes the physical relationship between zones.\n \n This is a top-level config (not per-zone) because it describes the INTER-zone\n * layout: how much space each zone gets, and the split direction.\n \n @example\n * split: {\n * ratio: [40, 60], // 40% primary, 60% secondary\n * orientation: DisplayDirection.VERTICAL, // side-by-side\n * resizable: true, // divider is draggable\n * companion: {\n * ratio: [70, 30], // companion takes 30%\n * resizable: true, // its own divider is draggable\n * },\n * }\n /\nexport const SplitConfigSchema = z.object({\n /\n Primary-to-secondary width/height ratio. Defines the initial proportion.\n * When `resizable` is `true`, user drag overrides this (persisted to localStorage).\n * @example [40, 60] — primary gets 40%, secondary gets 60%\n * @default [50, 50]\n /\n /\n * ONLY `ratio[1]` is read. Primary takes what the side panes leave — `100 − Σ(side defaults)` in\n * the static branch, the resizable branch's own clamping otherwise — so the first element has no\n * reader anywhere, and with BOTH a secondary and a companion shown it is not even well defined.\n \n Kept as a 2-tuple rather than narrowed to one number, deliberately: `[50, 50]` reads as a\n * proportion, which is what an author is thinking about, and changing the shape would break every\n * authored layout for a field whose value is already ignored. What changed on 2026-09-25 is that\n * it says so — `ratio: [40, 30]` silently rendered a 30% pane and a 70% primary, with the authored\n * 40 discarded and no diagnostic.\n /\n ratio: z.tuple([z.number(), z.number()]).default([50, 50]),\n /\n Split direction between primary and secondary — the ONE axis vocabulary.\n \n - `DisplayDirection.VERTICAL` (default): side-by-side (most common for list-detail)\n * - `DisplayDirection.HORIZONTAL`: top-bottom — the shape `SplitAppearance.DRAWER` used to\n * describe before that duplicate vocabulary was removed (2026-09-25).\n \n Read by BOTH render branches since the same change. It was read only by the resizable branch\n * before, so `HORIZONTAL` on a non-resizable layout silently produced a side panel.\n \n Note this names the DIVIDER's orientation, not the stacking axis — `VERTICAL` divider, content\n * side by side. `splitDividerOrientationToPanelGroupDirection` is the one place that inverts it.\n \n @default DisplayDirection.VERTICAL\n /\n orientation: z.enum(DisplayDirection).default(DisplayDirection.VERTICAL),\n /\n Whether the primary↔secondary split boundary is user-draggable.\n * When `true`, a draggable divider appears between primary and secondary zones.\n * Per-side drag constraints use `ZoneConfig.minWidth`/`maxWidth` on each zone.\n * @default false\n /\n resizable: z.boolean().default(false),\n /* Companion zone split geometry. Only relevant if companion zone is declared. /\n companion: CompanionSplitConfigSchema.optional(),\n});\n/\n * Every field above is READ by the runtime, checked rather than assumed (#211):\n * `ratio` and `resizable` by `NavigationContentAreas.tsx` (both the panel sizes and the\n * is-anything-draggable decision), `orientation` by `splitDividerOrientationToPanelGroupDirection`,\n * `companion` by the companion panel branch.\n \n `autoSplit` was REMOVED by that audit. It was declared, defaulted, documented, shipped to\n * application builders in the compiled `config-navigation` skill, authored by three preset layouts\n * and two applications — and read by nothing, so every one of those authors got `false`'s behaviour\n * whatever they wrote. Removing rather than implementing was the deliberate answer: what it\n * described is auto-SELECTING a record the user did not choose and stamping its URL, which is a\n * product decision nobody has taken, and the case people actually hit — a detail URL restoring\n * beside its list — was covered by the deep-link restoration in `528d132a` without it.\n /\nexport type SplitConfig = z.infer<typeof SplitConfigSchema>;\n\n\n// ════════════════════════════════════════════════════════════════\n// Viewport Override Block\n// ════════════════════════════════════════════════════════════════\n\n/\n Global viewport override — applies across ALL zones at a given breakpoint.\n \n Use for sweeping mobile/tablet overrides that affect the entire app.\n * For per-zone responsive behavior, use `ZoneConfig.responsiveCollapse` and\n * viewport-discriminated appearance values instead.\n \n @example\n * // In NavigationLayout:\n * [ViewportBreakpoint.MOBILE]: {\n * transitions: {\n * read: NavigationTransition.PUSH, // mobile: no splits, everything pushes\n * create: { transition: NavigationTransition.OVERLAY, ephemeral: true }, // mobile: create opens as an inspect-style ephemeral overlay\n * },\n * }\n /\nexport const ViewportOverrideSchema = z.object({\n /* Operation → transition overrides at this viewport. Merged over zone defaults. /\n transitions: (z.partialRecord(\n z.enum(CoreResourceOperation),\n TransitionConfigSchema,\n ) as unknown as z.ZodType<Partial<Record<CoreResourceOperation, TransitionConfig>>>).optional(),\n});\nexport type ViewportOverride = z.infer<typeof ViewportOverrideSchema>;\n\n\n// ════════════════════════════════════════════════════════════════\n// NavigationLayout — Top-Level App Configuration\n// ════════════════════════════════════════════════════════════════\n\n/\n @wildo_source:part:start saas.models.navigation.layout facet:layer:shared facet:family:navigation-config\n \n The complete navigation layout configuration for an application.\n \n This is the single configuration object that defines the entire navigation\n * behavior. It specifies which zones exist, how each zone handles operations,\n * how zones are sized relative to each other, and global overrides.\n \n Resolution order (from highest to lowest priority; the first tier that answers wins):\n * 1. Per-operation frontend override (`operation.operationFrontendConfig.navigationOverrides`)\n * 2. Authored action presentation (an operation's explicit presentation)\n * 3. Per-relationship override (`display.inParentNavigation.transition`)\n * 4. Global viewport override (`ViewportBreakpoint.MOBILE` / `ViewportBreakpoint.VERT_TABLET` blocks)\n * 5. Source context `transitions[operation]` — an overlay source with no `fromOverlay` entry falls\n * back to primary's map\n * 6. Derived action presentation (inferred by the framework, used only after authored policy)\n * 7. Framework hardcoded fallback\n \n @example\n * const layout: NavigationLayout = {\n * zones: {\n * primary: { transitions: { read: NavigationTransition.SPLIT, create: NavigationTransition.OVERLAY, update: NavigationTransition.INPLACE } },\n * secondary: { transitions: { read: NavigationTransition.PUSH }, onEmpty: ZoneEmptyBehavior.COLLAPSE },\n * },\n * appLevel: { transitions: { list: NavigationTransition.REPLACE, create: NavigationTransition.OVERLAY } },\n * fromOverlay: { transitions: { read: NavigationTransition.PROMOTE } },\n * split: { ratio: [40, 60] },\n * maxDepth: 2,\n * };\n /\n/\n WHICH LAYER OWNS THE BACK AFFORDANCE.\n \n Two layers can render a back control for the same navigation stack: the app\n * SHELL (the menubar's hosted navigation control) and the current SURFACE (a\n * resource/view header, beside the icon + title + breadcrumb). Both mount the\n * same component, so without an explicit owner an app that hosts the shell\n * control gets TWO back arrows on every pushed page — one floating in the bar\n * with no context, one attached to the thing it goes back from.\n \n This is deliberately a POLICY rather than a per-surface flag: \"who owns this\n * chrome\" is one application-wide decision, and expressing it as an owner makes\n * the duplication unrepresentable instead of asking every surface to remember\n * to suppress itself.\n /\nexport enum NavigationBackAffordanceOwner {\n /\n The current surface's own header owns it — the back control sits beside the\n * surface's icon/title/breadcrumb, so it reads as \"back from THIS\". The shell\n * control renders nothing even when hosted. Default: it keeps the affordance\n * attached to its context, and matches the shell staying free of a lone,\n * context-free arrow.\n /\n SURFACE = 'surface',\n /\n The app shell's navigation control owns it — one fixed back control in the\n * menubar (the Notion-style top-left placement). Surface headers render none.\n * Requires the shell to actually host `NAVIGATION_CONTROL`; if it does not,\n * the application has no back affordance at all.\n /\n SHELL = 'shell',\n /\n BOTH layers render one. An explicit opt-in for layouts where the two\n * genuinely differ — e.g. a multi-zone shell whose bar control pops the\n * focused zone while each zone's header pops its own stack. Chosen\n * deliberately; never a default.\n /\n BOTH = 'both',\n}\n\n/* Default owner when a layout declares none — see {@link NavigationBackAffordanceOwner.SURFACE}. /\nexport const DEFAULT_NAVIGATION_BACK_AFFORDANCE_OWNER: NavigationBackAffordanceOwner = NavigationBackAffordanceOwner.SURFACE;\n\n/\n Does `owner` grant the SHELL (menubar navigation control) a back affordance?\n * Shared by both render sites so the two can never disagree about one policy.\n /\nexport function navigationBackAffordanceAdmitsShell(owner: NavigationBackAffordanceOwner \| undefined): boolean {\n const resolved = owner ?? DEFAULT_NAVIGATION_BACK_AFFORDANCE_OWNER;\n return resolved === NavigationBackAffordanceOwner.SHELL \|\| resolved === NavigationBackAffordanceOwner.BOTH;\n}\n\n/* Does `owner` grant the current SURFACE's header a back affordance? /\nexport function navigationBackAffordanceAdmitsSurface(owner: NavigationBackAffordanceOwner \| undefined): boolean {\n const resolved = owner ?? DEFAULT_NAVIGATION_BACK_AFFORDANCE_OWNER;\n return resolved === NavigationBackAffordanceOwner.SURFACE \|\| resolved === NavigationBackAffordanceOwner.BOTH;\n}\n\nexport const NavigationLayoutSchema = z.object({\n /\n Zone declarations. Primary is required, secondary and companion are optional.\n * Undeclared zones cannot be targeted by transitions — `NavigationTransition.SPLIT` in a layout\n * without secondary will escalate to overlay.\n /\n zones: z.object({\n /* Primary zone — always exists. Main content area (lists, root reads). /\n primary: ZoneConfigSchema,\n /* Secondary zone — optional. First adjacent zone for detail content. /\n secondary: ZoneConfigSchema.optional(),\n /* Companion zone — optional. Persistent supplementary content. /\n companion: ZoneConfigSchema.optional(),\n }),\n /\n How navigation from the app shell (sidebar, command palette, hotkey) behaves.\n * Causes a layout reset when targeting primary.\n /\n appLevel: AppLevelConfigSchema.optional(),\n /\n How navigation that STARTS in an overlay resolves. `PUSH` or `REPLACE` from an overlay leaves it\n * and lands in PRIMARY (the page changes); `OVERLAY` stacks a second overlay on the first. A\n * missing entry falls back to primary's own map. Nothing here keeps a link inside the dialog.\n /\n fromOverlay: FromOverlayConfigSchema.optional(),\n /* Split geometry: ratios, orientation, resizability. /\n split: SplitConfigSchema.optional(),\n /\n Maximum push depth before the framework escalates to overlay.\n * When a zone's stack depth reaches `maxDepth`, the next `push` opens an overlay instead.\n * Prevents infinitely deep navigation stacks. Per-relationship `maxDepth` can override.\n /\n maxDepth: z.number().int().positive().optional(),\n\n /\n Which layer renders the back control — see {@link NavigationBackAffordanceOwner}.\n * Omitted means {@link DEFAULT_NAVIGATION_BACK_AFFORDANCE_OWNER} (the surface's\n * own header), which is what keeps a shell that hosts `NAVIGATION_CONTROL`\n * from rendering a second, context-free back arrow beside every page's own.\n /\n backAffordanceOwner: z.enum(NavigationBackAffordanceOwner).optional(),\n\n /\n Mobile viewport override — applies across all zones when viewport is `<md` (< 768px).\n * Use for sweeping mobile behavior changes (e.g., all splits become pushes).\n /\n [ViewportBreakpoint.MOBILE]: ViewportOverrideSchema.optional(),\n /\n Tablet viewport override — applies across all zones when viewport is `<lg` (768–1023px).\n * Use for tablet-specific behavior changes.\n /\n [ViewportBreakpoint.VERT_TABLET]: ViewportOverrideSchema.optional(),\n});\nexport type NavigationLayout = z.infer<typeof NavigationLayoutSchema>;\n/* @wildo_source:part:end saas.models.navigation.layout /\n\n\n// ════════════════════════════════════════════════════════════════\n// Transition Config Helpers\n// ════════════════════════════════════════════════════════════════\n\n/\n The transition verb of a {@link TransitionConfig}, which is either the verb itself or an object\n * carrying it alongside its modifiers.\n \n Exported from here rather than from the frontend resolver — where all three of these lived until\n * 2026-09-25 — because they are pure functions of an AUTHORING type this file owns, and the layout\n * diagnostics below need them too. A second copy beside the diagnostics would have been a second\n * answer to \"what verb did the author write\".\n /\nexport function getTransitionVerb(config: TransitionConfig): NavigationTransition {\n if (typeof config === 'string') return config;\n return (config as TransitionObject).transition;\n}\n\n/* Whether a {@link TransitionConfig} carries the `ephemeral` modifier. /\nexport function isEphemeralTransition(config: TransitionConfig): boolean {\n if (typeof config === 'string') return false;\n return (config as TransitionObject).ephemeral === true;\n}\n\n/* Whether a {@link TransitionConfig} carries the `persistent` modifier — a split that targets companion. /\nexport function isPersistentTransition(config: TransitionConfig): boolean {\n if (typeof config === 'string') return false;\n return (config as TransitionObject).persistent === true;\n}\n\n\n// ════════════════════════════════════════════════════════════════\n// Navigation Layout Diagnostics\n// ════════════════════════════════════════════════════════════════\n\n/\n What a {@link NavigationLayoutDiagnostic} says about the layout.\n \n `ERROR` means the runtime will do something the author did not ask for — a declared split that\n * silently becomes a dialog. `WARNING` means a declaration is INERT: nothing goes wrong, and the\n * author believes they configured something they did not.\n \n Neither is fatal. See {@link collectNavigationLayoutDiagnostics} for why.\n /\nexport enum NavigationLayoutDiagnosticSeverity {\n ERROR = 'error',\n WARNING = 'warning',\n}\n\n/* The closed set of layout defects {@link collectNavigationLayoutDiagnostics} can recognise. /\nexport enum NavigationLayoutDiagnosticCode {\n /\n A `SPLIT` is declared somewhere in the layout and NO adjacent zone is declared, so every one of\n * those splits silently becomes an overlay.\n \n The single most surprising thing in the navigation runtime, and it was documented in\n * `NavigationLayoutSchema`'s own JSDoc — \"`NavigationTransition.SPLIT` in a layout without\n secondary will escalate to overlay\"* — while nothing checked it. An author gets a dialog where\n * they asked for a pane, with no diagnostic anywhere.\n /\n SPLIT_WITHOUT_ADJACENT_ZONE = 'split-without-adjacent-zone',\n /\n A `persistent` split is declared and no `companion` zone exists. A persistent split targets\n * companion SPECIFICALLY — it does not fall back to secondary — so it escalates to an overlay even\n * in a layout that declares a perfectly good `secondary`.\n \n Separate from {@link SPLIT_WITHOUT_ADJACENT_ZONE} because the remedy is different and the\n * surprise is larger: the author is looking at a declared pane and cannot see why their split\n * refuses to use it.\n /\n PERSISTENT_SPLIT_WITHOUT_COMPANION = 'persistent-split-without-companion',\n /\n `minWidth`, `maxWidth`, `onEmpty` or `responsiveCollapse` declared on PRIMARY, where every one of\n * them is inert: primary never collapses, never empties and takes the remaining space.\n \n `ZoneConfigSchema`'s JSDoc states this — \"Setting these on primary has no effect\" — so the\n * diagnostic enforces a rule the contract already carries.\n /\n INERT_PRIMARY_ZONE_FIELD = 'inert-primary-zone-field',\n /* A zone whose `minWidth` exceeds its `maxWidth`. The drag constraints cannot both be honoured. /\n ZONE_WIDTH_BOUNDS_INVERTED = 'zone-width-bounds-inverted',\n}\n\n/* One finding about an authored {@link NavigationLayout}. /\nexport interface NavigationLayoutDiagnostic {\n code: NavigationLayoutDiagnosticCode;\n severity: NavigationLayoutDiagnosticSeverity;\n /* Where in the layout, as an authoring path: `zones.primary.transitions.read`. /\n path: string;\n /* What is wrong and what the runtime will do instead. /\n message: string;\n /* The edit that fixes it. Always present — a diagnostic with no remedy is a complaint. /\n remedy: string;\n}\n\n/\n Read an authored {@link NavigationLayout} and report what the runtime will silently do differently\n * from what it says.\n \n ## Why this exists\n \n Nothing validated a navigation layout beyond its SHAPE until 2026-09-25 — there was no `refine`\n * anywhere in this file — so three classes of declaration were accepted and quietly ignored. The\n * escalation in {@link NavigationLayoutDiagnosticCode.SPLIT_WITHOUT_ADJACENT_ZONE} is the expensive\n * one: it is documented in this file's own prose and produces a dialog where a pane was asked for.\n \n ## It REPORTS; it never refuses, and that is deliberate\n \n A `superRefine` on {@link NavigationLayoutSchema} was the obvious implementation and was rejected.\n * The layout is parsed inside `AppConfiguration_Frontend_Schema` at application boot, so a refusal\n * there would stop an application from starting over a split that renders as a dialog — wildly\n * disproportionate, and the exact shape `.claude/rules/application-creation-directive.md` forbids:\n * a mechanism that refuses rather than marks. The precedent for the chosen shape is the\n * administrative-continuity boot report, which is non-fatal for the same reason.\n \n Pure, so it is equally usable from a test, a CLI check or a future authoring-time gate.\n \n ## What this CANNOT see, and what covers it instead\n \n A layout is not the only place a `SPLIT` is declared. A resource's `navigationOverrides`, a\n * relationship transition and an action presentation all reach the resolver, and none of them is in\n * the layout — so the only real instance of `SPLIT_WITHOUT_ADJACENT_ZONE` in this repository was\n * INVISIBLE here: Wonder Todos declared `SPLIT` on `todos.READ` against a single-zone layout, every\n * drill-in became a dialog for the life of the declaration, and this check reported clean.\n \n Re-deriving that population statically would mean a second enumeration of every tier that can\n * produce a SPLIT, kept in step with the resolver by hand. The resolver has already decided, so the\n * report lives at the DECISION instead: `useNavigationController` warns once per resource+operation\n * when a resolution carries `SPLIT_ESCALATED_NO_ADJACENT_ZONE`. That covers every tier by\n * construction and cannot drift. This function keeps the half a boot check can answer — the layout's\n * own declarations, before anything navigates.\n \n ## The rule that was considered and REJECTED, because it fires on correct code\n \n \"A `secondary` zone is declared and no transition in the layout resolves to `SPLIT`, so the pane\n can never open.\"* It reads like the natural companion to the rules above and it is wrong: Wonder\n * CRM declares `secondary` while `zones.primary.transitions.read` is `PUSH`, and its pane is reached\n * ONLY by `deal`'s per-resource `navigationOverrides: [{ transition: SPLIT }]` — a declaration this\n * function cannot see, because it lives in a resource's ui-behavior rather than in the layout. The\n * rule would have reported the repository's one deliberate two-zone application as misconfigured.\n \n A checker that mostly reports correct code trains its reader to skim the reports that matter.\n \n (That rationale also mis-named Wonder CRM as \"the repository's one deliberate two-zone\n * application\". The workbench declares `zones.secondary` too — and unlike CRM its pane IS reached\n * from the layout, so the rejected rule would not have fired on it. The rejection stands on CRM\n * alone.)\n /\nexport function collectNavigationLayoutDiagnostics(layout: NavigationLayout): NavigationLayoutDiagnostic[] {\n const diagnostics: NavigationLayoutDiagnostic[] = [];\n const hasSecondary = layout.zones.secondary !== undefined;\n const hasCompanion = layout.zones.companion !== undefined;\n const hasAdjacentZone = hasSecondary \|\| hasCompanion;\n\n /\n * Every place a layout can declare a transition. Enumerated rather than walked, because the set is\n * closed by `NavigationLayoutSchema` and a structural walk would also reach the per-resource\n * overrides this function deliberately cannot see (see the rejected rule above).\n */\n const transitionSources: { path: string; transitions: ZoneTransitions \| undefined }[] = [\n { path: 'zones.primary.transitions', transitions: layout.zones.primary?.transitions },\n { path: 'zones.secondary.transitions', transitions: layout.zones.secondary?.transitions },\n { path: 'zones.companion.transitions', transitions: layout.zones.companion?.transitions },\n { path: 'appLevel.transitions', transitions: layout.appLevel?.transitions },\n { path: 'fromOverlay.transitions', transitions: layout.fromOverlay?.transitions },\n { path: `['${ViewportBreakpoint.MOBILE}'].transitions`, transitions: layout[ViewportBreakpoint.MOBILE]?.transitions },\n { path: `['${ViewportBreakpoint.VERT_TABLET}'].transitions`, transitions: layout[ViewportBreakpoint.VERT_TABLET]?.transitions },\n ];\n\n for (const source of transitionSources) {\n if (!source.transitions) continue;\n for (const [operation, config] of Object.entries(source.transitions)) {\n if (config === undefined) continue;\n if (getTransitionVerb(config as TransitionConfig) !== NavigationTransition.SPLIT) continue;\n const path = `${source.path}.${operation}`;\n\n if (!hasAdjacentZone) {\n diagnostics.push({\n code: NavigationLayoutDiagnosticCode.SPLIT_WITHOUT_ADJACENT_ZONE,\n severity: NavigationLayoutDiagnosticSeverity.ERROR,\n path,\n message:\n 'Declares SPLIT, and the layout declares no `secondary` or `companion` zone. '\n + 'The split escalates to an OVERLAY, so this operation opens as a dialog rather than beside its source.',\n remedy: 'Declare `zones.secondary`, or change this transition to the one you want (PUSH, REPLACE or OVERLAY).',\n });\n continue;\n }\n\n if (isPersistentTransition(config as TransitionConfig) && !hasCompanion) {\n diagnostics.push({\n code: NavigationLayoutDiagnosticCode.PERSISTENT_SPLIT_WITHOUT_COMPANION,\n severity: NavigationLayoutDiagnosticSeverity.ERROR,\n path,\n message:\n 'Declares a `persistent` SPLIT, which targets the `companion` zone specifically and does NOT '\n + 'fall back to `secondary`. With no companion declared it escalates to an OVERLAY.',\n remedy: 'Declare `zones.companion`, or drop `persistent` so the split may use `secondary`.',\n });\n }\n }\n }\n\n const primary = layout.zones.primary;\n if (primary) {\n const inertOnPrimary = (['minWidth', 'maxWidth', 'onEmpty', 'responsiveCollapse'] as const)\n .filter(field => primary[field] !== undefined);\n for (const field of inertOnPrimary) {\n diagnostics.push({\n code: NavigationLayoutDiagnosticCode.INERT_PRIMARY_ZONE_FIELD,\n severity: NavigationLayoutDiagnosticSeverity.WARNING,\n path: `zones.primary.${field}`,\n message:\n `\\`${field}\\` has no effect on the primary zone: primary never collapses, never empties, and takes `\n + 'the space the other zones leave.',\n remedy: `Move \\`${field}\\` to \\`zones.secondary\\` or \\`zones.companion\\`, or remove it.`,\n });\n }\n }\n\n for (const zoneName of ['primary', 'secondary', 'companion'] as const) {\n const zone = layout.zones[zoneName];\n if (zone?.minWidth !== undefined && zone.maxWidth !== undefined && zone.minWidth > zone.maxWidth) {\n diagnostics.push({\n code: NavigationLayoutDiagnosticCode.ZONE_WIDTH_BOUNDS_INVERTED,\n severity: NavigationLayoutDiagnosticSeverity.ERROR,\n path: `zones.${zoneName}`,\n message: `\\`minWidth\\` (${zone.minWidth}) exceeds \\`maxWidth\\` (${zone.maxWidth}); the drag constraints cannot both hold.`,\n remedy: 'Lower `minWidth` or raise `maxWidth` so the range is non-empty.',\n });\n }\n }\n\n return diagnostics;\n}\n\n// ════════════════════════════════════════════════════════════════\n// Per-Resource Operation Override\n// ════════════════════════════════════════════════════════════════\n\n// DELETED — NavigationOperationOverrideSchema and NavigationOperationOverride\n// Transferred to @wildo-ai/saas-frontend-lib (resources.frontend.schemas)\n"]}

package/dist/esm/config/frontend/onboarding.shared.schemas.d.ts CHANGED Viewed

@@ -2,6 +2,7 @@ import { z } from 'zod';
 /** ──────────────────────────────────────────────────────────────
  * OnboardingView – Core primitives
  * ────────────────────────────────────────────────────────────── */
+/** @wildo_source:part:start saas.models.onboarding-trigger facet:layer:shared facet:family:guidance facet:audience:app-developer */
 /** Onboarding Trigger Types - when/how onboarding flows are activated */
 export declare const OnboardingTriggerType: {
     /** Triggered when user first visits the app */
@@ -16,6 +17,8 @@ export declare const OnboardingTriggerType: {
     readonly DELAYED: "delayed";
 };
 export type OnboardingTriggerType = typeof OnboardingTriggerType[keyof typeof OnboardingTriggerType];
+/** @wildo_source:part:end saas.models.onboarding-trigger */
+/** @wildo_source:part:start saas.models.onboarding-elements facet:layer:shared facet:family:guidance facet:audience:app-developer */
 /** Onboarding Element Types */
 export declare enum OnboardingElementType {
     CHECKLIST = "checklist",
@@ -37,6 +40,7 @@ export declare enum OnboardingStatus {
     SKIPPED = "skipped",
     DISMISSED = "dismissed"
 }
+/** @wildo_source:part:end saas.models.onboarding-elements */
 /**
  * Terminal onboarding/guidance statuses — the end states from which no further
  * lifecycle transition is valid. A flow in `COMPLETED`, `SKIPPED`, or
@@ -56,6 +60,7 @@ export declare enum OnboardingStatus {
  * not inlined per call site, to prevent drift between them.
  */
 export declare function isTerminalOnboardingStatus(status: OnboardingStatus | undefined): boolean;
+/** @wildo_source:part:start saas.models.onboarding-elements */
 /** Tour Step Placement */
 export declare enum TourStepPlacement {
     TOP = "top",
@@ -64,14 +69,6 @@ export declare enum TourStepPlacement {
     RIGHT = "right",
     CENTER = "center"
 }
-/** Onboarding Position */
-export declare enum OnboardingPosition {
-    CENTER = "center",
-    TOP = "top",
-    BOTTOM = "bottom",
-    LEFT = "left",
-    RIGHT = "right"
-}
 /** Onboarding Variant */
 export declare enum OnboardingVariant {
     INFO = "info",
@@ -108,19 +105,19 @@ export declare enum OnboardingBannerPosition {
     TOP = "top",
     BOTTOM = "bottom"
 }
+/** @wildo_source:part:end saas.models.onboarding-elements */
 /** ──────────────────────────────────────────────────────────────
  * OnboardingView – Schemas
  * ────────────────────────────────────────────────────────────── */
-/** Onboarding Trigger Conditions Schema */
-export declare const OnboardingTriggerConditionsSchema: z.ZodObject<{
-    newUsersOnly: z.ZodDefault<z.ZodBoolean>;
-    triggerOnce: z.ZodDefault<z.ZodBoolean>;
-    requiredRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
+/** @wildo_source:part:start saas.models.onboarding-trigger */
 /** Onboarding Trigger Schema - defines when/how an onboarding or guidance flow is activated.
  *  Important runtime note:
- *  - `EVENT` is the only trigger type evaluated by the backend operation pipeline.
- *  - `FIRST_VISIT`, `ROUTE_MATCH`, `DELAYED`, and `MANUAL` are frontend/manual concerns. */
+ *  - `EVENT` is the only trigger type evaluated by the backend operation pipeline. Its `eventName`
+ *    for a resource operation succeeding is `<resourceType>:<operationIdentifier>` — build it from
+ *    your resource-type enum and `CoreResourceOperation`, e.g.
+ *    `` `${MyModule_ResourceType.PROJECTS}:${CoreResourceOperation.CREATE}` ``.
+ *  - `FIRST_VISIT`, `ROUTE_MATCH`, `DELAYED`, and `MANUAL` are frontend/manual concerns.
+ *  - A flow shows once per subject: it does not re-trigger after it is completed, skipped or dismissed. */
 export declare const OnboardingTriggerSchema: z.ZodObject<{
     type: z.ZodDefault<z.ZodEnum<{
         /** Triggered when user first visits the app */
@@ -137,13 +134,10 @@ export declare const OnboardingTriggerSchema: z.ZodObject<{
     routePattern: z.ZodOptional<z.ZodString>;
     eventName: z.ZodOptional<z.ZodString>;
     delayMs: z.ZodOptional<z.ZodNumber>;
-    conditions: z.ZodOptional<z.ZodObject<{
-        newUsersOnly: z.ZodDefault<z.ZodBoolean>;
-        triggerOnce: z.ZodDefault<z.ZodBoolean>;
-        requiredRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
 }, z.core.$strip>;
-/** Onboarding View Options Schema */
+/** @wildo_source:part:end saas.models.onboarding-trigger */
+/** @wildo_source:part:start saas.frontend.onboarding-view */
+/** Onboarding View Options Schema — the `options` of an onboarding DOCUMENT (guidance flows have none). */
 export declare const OnboardingViewOptionsSchema: z.ZodObject<{
     showProgress: z.ZodDefault<z.ZodBoolean>;
     allowDismiss: z.ZodDefault<z.ZodBoolean>;
@@ -152,6 +146,7 @@ export declare const OnboardingViewOptionsSchema: z.ZodObject<{
     allowSkip: z.ZodDefault<z.ZodBoolean>;
     className: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/** @wildo_source:part:end saas.frontend.onboarding-view */
 /** ──────────────────────────────────────────────────────────────
  * OnboardingView – Reusable Config Schemas
  *
@@ -159,6 +154,7 @@ export declare const OnboardingViewOptionsSchema: z.ZodObject<{
  * for each onboarding element, separated from base identity/state fields.
  * for reuse across packages.
  * ────────────────────────────────────────────────────────────── */
+/** @wildo_source:part:start saas.models.onboarding-elements */
 /** Tour Step Schema */
 export declare const OnboardingTourStepSchema: z.ZodObject<{
     ref: z.ZodString;
@@ -178,6 +174,46 @@ export declare const OnboardingSurveyQuestionSchema: z.ZodObject<{
         ref: z.ZodString;
     }, z.core.$strip>>>;
     required: z.ZodDefault<z.ZodBoolean>;
+    bindToField: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * The question types a field binding accepts, because their answer IS the value.
+ *
+ * The choice types are excluded ON PURPOSE rather than by oversight. An option carries only a
+ * `ref`, which is an i18n key — so binding a RADIO, CHECKBOX or SINGLE_CHOICE question would write
+ * that key into an application's resource field and store `favouriteColourBlue` where the
+ * application expected a colour. Silently, and durably.
+ *
+ * Refused rather than documented, because a binding that stores the wrong thing is worse than one
+ * that does not exist: nothing downstream can tell a key from a value. Admitting the choice types
+ * means giving an option a VALUE alongside its ref, which is an additive change to this schema and
+ * the natural next step if an application needs it.
+ */
+export declare const SURVEY_QUESTION_TYPES_WHOSE_ANSWER_IS_A_VALUE: readonly OnboardingSurveyQuestionType[];
+/**
+ * Where a survey's answers land, beyond the guidance-state row.
+ *
+ * ## Why the resource is named once, and the field per question
+ *
+ * A survey writes ONE row in ONE submission. Naming the resource per question would let a single
+ * submit fan out across several resources, which buys nothing an application cannot express with two
+ * surveys, and costs partial-failure semantics: three writes, the second refused, and an element
+ * that is neither complete nor cleanly incomplete. One resource, one write, one outcome.
+ *
+ * ## What the target has to be
+ *
+ * A resource the current subject already has a row of, reachable without naming an id — the shape
+ * `userProfiles` has, and the shape an application's own `USERS → <resource>` composition has. The
+ * scope parameters are injected by `ScopedResourceRegistryProvider`, exactly as they are for the
+ * guidance-state write itself, so the binding never addresses a row by id and cannot reach another
+ * subject's data.
+ *
+ * v1 performs an UPDATE and does not create a missing row. That is a stated limitation rather than a
+ * silent one: the write is refused, loudly, and the element does not complete. Create-if-absent is
+ * additive and can be added against a real target that needs it.
+ */
+export declare const OnboardingSurveyBindingSchema: z.ZodObject<{
+    resourceType: z.ZodString;
 }, z.core.$strip>;
 /** Checklist Config Schema - type-specific fields only */
 export declare const OnboardingChecklistConfigSchema: z.ZodObject<{
@@ -253,9 +289,35 @@ export declare const OnboardingSurveyConfigSchema: z.ZodObject<{
             ref: z.ZodString;
         }, z.core.$strip>>>;
         required: z.ZodDefault<z.ZodBoolean>;
+        bindToField: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     allowSkip: z.ZodDefault<z.ZodBoolean>;
+    bindTo: z.ZodOptional<z.ZodObject<{
+        resourceType: z.ZodString;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
+/**
+ * A question may only name a field when its survey names a resource.
+ *
+ * Refused rather than ignored, because an ignored `bindToField` is the exact defect this capability
+ * was built alongside: an author declares where an answer should go, the runtime drops it on the
+ * floor, and nothing says so until somebody reads the row and finds it empty.
+ *
+ * It lives as a standalone function rather than a `.superRefine` on the config schema because that
+ * schema's `.shape` is SPREAD into a discriminated-union member, and a refinement wrapper has no
+ * `.shape`; and it cannot sit on the union member either, since `z.discriminatedUnion` requires
+ * plain object members. So the union applies it, once, for the SURVEY case.
+ */
+export declare function assertSurveyFieldBindingsHaveATarget(survey: {
+    bindTo?: {
+        resourceType: string;
+    };
+    questions: {
+        id: string;
+        type: OnboardingSurveyQuestionType;
+        bindToField?: string;
+    }[];
+}, ctx: z.RefinementCtx, pathPrefix?: (string | number)[]): void;
 /** ──────────────────────────────────────────────────────────────
  * OnboardingView – Element Base Schema (for reuse)
  *
@@ -271,115 +333,8 @@ export declare const OnboardingElementBaseSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type OnboardingElementBase = z.infer<typeof OnboardingElementBaseSchema>;
 /** ──────────────────────────────────────────────────────────────
- * OnboardingView – Element Schema Family
- *
- * Uses createSchemaFamily for discriminated union with automatic
- * inheritance configuration generation. Each variant extends the
- * base with type-specific fields from config schemas.
+ * OnboardingView – Element Union
  * ────────────────────────────────────────────────────────────── */
-export declare const OnboardingElementSchemaFamily: import("../..").SchemaFamily<z.ZodObject<{
-    ref: z.ZodString;
-    type: z.ZodEnum<typeof OnboardingElementType>;
-    status: z.ZodDefault<z.ZodEnum<typeof OnboardingStatus>>;
-    order: z.ZodNumber;
-    targetField: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, "type", {
-    checklist: {
-        extend: z.ZodObject<{
-            showProgress: z.ZodDefault<z.ZodBoolean>;
-            items: z.ZodArray<z.ZodString>;
-        }, z.core.$strip>;
-    };
-    "checklist-item": {
-        extend: z.ZodObject<{
-            actionRef: z.ZodOptional<z.ZodString>;
-            completed: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>;
-    };
-    tour: {
-        extend: z.ZodObject<{
-            steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                ref: z.ZodString;
-                order: z.ZodNumber;
-                placement: z.ZodDefault<z.ZodEnum<typeof TourStepPlacement>>;
-                targetSelector: z.ZodOptional<z.ZodString>;
-                targetField: z.ZodOptional<z.ZodString>;
-                imageUrl: z.ZodOptional<z.ZodURL>;
-                videoUrl: z.ZodOptional<z.ZodURL>;
-            }, z.core.$strip>>>;
-            autoStart: z.ZodDefault<z.ZodBoolean>;
-            allowSkip: z.ZodDefault<z.ZodBoolean>;
-            currentStepIndex: z.ZodDefault<z.ZodNumber>;
-        }, z.core.$strip>;
-    };
-    tooltip: {
-        extend: z.ZodObject<{
-            targetSelector: z.ZodString;
-            placement: z.ZodDefault<z.ZodEnum<typeof TourStepPlacement>>;
-            showOnce: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>;
-    };
-    modal: {
-        extend: z.ZodObject<{
-            imageUrl: z.ZodOptional<z.ZodURL>;
-            videoUrl: z.ZodOptional<z.ZodURL>;
-            ctaAction: z.ZodOptional<z.ZodString>;
-            dismissible: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>;
-    };
-    banner: {
-        extend: z.ZodObject<{
-            variant: z.ZodDefault<z.ZodEnum<typeof OnboardingVariant>>;
-            dismissible: z.ZodDefault<z.ZodBoolean>;
-            position: z.ZodDefault<z.ZodEnum<typeof OnboardingBannerPosition>>;
-            actionRef: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
-    };
-    announcement: {
-        extend: z.ZodObject<{
-            variant: z.ZodDefault<z.ZodEnum<typeof OnboardingVariant>>;
-            dismissible: z.ZodDefault<z.ZodBoolean>;
-            icon: z.ZodOptional<z.ZodString>;
-            actionRef: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
-    };
-    badge: {
-        extend: z.ZodObject<{
-            icon: z.ZodOptional<z.ZodString>;
-            variant: z.ZodDefault<z.ZodEnum<typeof OnboardingBadgeVariant>>;
-            color: z.ZodOptional<z.ZodString>;
-            unlocked: z.ZodDefault<z.ZodBoolean>;
-            actionRef: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
-    };
-    card: {
-        extend: z.ZodObject<{
-            icon: z.ZodOptional<z.ZodString>;
-            imageUrl: z.ZodOptional<z.ZodURL>;
-            variant: z.ZodDefault<z.ZodEnum<typeof OnboardingCardVariant>>;
-            actionRef: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
-    };
-    survey: {
-        extend: z.ZodObject<{
-            questions: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                id: z.ZodString;
-                ref: z.ZodOptional<z.ZodString>;
-                type: z.ZodEnum<typeof OnboardingSurveyQuestionType>;
-                options: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                    ref: z.ZodString;
-                }, z.core.$strip>>>;
-                required: z.ZodDefault<z.ZodBoolean>;
-            }, z.core.$strip>>>;
-            allowSkip: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>;
-    };
-}>;
-/**
- * Schema family with full access to base, variants, union, and inheritenceSchemaDefinition.
- * Use for resource configuration and cross-package integration.
- * Access variants via: OnboardingElementSchemaFamily.variants[OnboardingElementType.CHECKLIST]
- */
 /**
  * Typed discriminated union of all onboarding element types.
  * Use this for runtime validation and type inference.
@@ -492,14 +447,18 @@ export declare const OnboardingElementSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             ref: z.ZodString;
         }, z.core.$strip>>>;
         required: z.ZodDefault<z.ZodBoolean>;
+        bindToField: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     allowSkip: z.ZodDefault<z.ZodBoolean>;
+    bindTo: z.ZodOptional<z.ZodObject<{
+        resourceType: z.ZodString;
+    }, z.core.$strip>>;
     type: z.ZodLiteral<OnboardingElementType.SURVEY>;
 }, z.core.$strip>], "type">;
+/** @wildo_source:part:end saas.models.onboarding-elements */
 /** ──────────────────────────────────────────────────────────────
  * Onboarding – Type Definitions
  * ────────────────────────────────────────────────────────────── */
-export type OnboardingTriggerConditions = z.infer<typeof OnboardingTriggerConditionsSchema>;
 export type OnboardingTrigger = z.infer<typeof OnboardingTriggerSchema>;
 export type OnboardingViewOptions = z.infer<typeof OnboardingViewOptionsSchema>;
 export type OnboardingTourStep = z.infer<typeof OnboardingTourStepSchema>;
@@ -549,6 +508,4 @@ export type OnboardingCardElement = Extract<OnboardingElement, {
 export type OnboardingSurveyElement = Extract<OnboardingElement, {
     type: OnboardingElementType.SURVEY;
 }>;
-/** Alias for OnboardingChecklistItemElement (backward compatibility) */
-export type OnboardingChecklistItem = OnboardingChecklistItemElement;
 //# sourceMappingURL=onboarding.shared.schemas.d.ts.map