npm - @wildo-ai/saas-models - Versions diffs - 1.1.1 → 1.1.3 - Mend

@wildo-ai/saas-models 1.1.1 → 1.1.3

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 (588) 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 /\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\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 /\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\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\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\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 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\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 (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"]}

package/dist/esm/errors/errors.custom-message-ref.shared.definitions.d.ts CHANGED Viewed

@@ -113,6 +113,17 @@ export declare enum ErrorCustomMessageReference {
     CROSS_ORG_SSO_BLOCKED = "cross_org_sso_blocked",
     APP_CONFIGURATION_UNAUTHORIZED = "app_configuration_unauthorized",
     APP_CONFIGURATION_NOT_INITIALIZED = "app_configuration_not_initialized",
+    /**
+     * An invitation could not be accepted because no user type resolved for the organization being
+     * joined — so no auth policy could be fetched and NO method could be enabled.
+     *
+     * Distinct from `AUTHENTICATION_METHOD_NOT_SUPPORTED` on purpose, and the distinction is the whole
+     * point: an unresolvable policy makes the enabled-method set EMPTY, so every method fails
+     * identically and reporting it as a method problem sends the reader to the auth configuration —
+     * which is typically present and correct. The cause is one level up, in
+     * `organizationTypes[<org type>].userTypes`, and nothing in a method-shaped error points there.
+     */
+    INVITATION_ORGANIZATION_TYPE_UNRESOLVED = "invitation_organization_type_unresolved",
     FRONTEND_FORM_READ_OPERATION_NOT_AVAILABLE = "frontend_form_read_operation_not_available",
     FRONTEND_NAVIGATION_INVALID_URL_PARAMETERS = "frontend_navigation_invalid_url_parameters",
     FRONTEND_NAVIGATION_MISSING_REQUIRED_PARAMETERS = "frontend_navigation_missing_required_parameters",
@@ -172,6 +183,14 @@ export declare enum ErrorCustomMessageReference {
     CONSUMABLE_TOKEN_NOT_ACCEPTED_FOR_OPERATION = "consumable_token_not_accepted_for_operation",
     CONSUMABLE_TOKEN_RACE_CONDITION = "consumable_token_race_condition",
     CONSUMABLE_TOKEN_FILE_SHARING_DISABLED = "consumable_token_file_sharing_disabled",
+    /** An upload grant was presented on an upload route it was not minted for (other resource, field, operation kind, or row). */
+    FILE_UPLOAD_GRANT_TARGET_MISMATCH = "file_upload_grant_target_mismatch",
+    /** A grant was requested with a lifetime above the engine ceiling; refused, never clamped. */
+    FILE_UPLOAD_GRANT_DURATION_EXCEEDS_MAX = "file_upload_grant_duration_exceeds_max",
+    /** The caller's execution type may not mint a grant: a grant may not mint a grant, and an anonymous session has no subject to attribute the file to. */
+    FILE_UPLOAD_GRANT_MINTER_NOT_ELIGIBLE = "file_upload_grant_minter_not_eligible",
+    /** No upload grant matches the presented value (never says whether one existed). */
+    FILE_UPLOAD_GRANT_NOT_FOUND = "file_upload_grant_not_found",
     /** W7.3b: ADDITIVE policy requires x-consumable-token header alongside JWT/API-key auth. */
     ADDITIVE_TOKEN_REQUIRED = "additive_token_required",
     /** revocation-B1: requested one-off session `expiresIn` exceeds this user type's max-duration cap. */
@@ -401,6 +420,23 @@ export declare enum ErrorCustomMessageReference {
      * Raised as `ErrorType.VALIDATION` (400) — the payload is internally inconsistent, not unauthorized.
      */
     BILLING_PRICE_PRODUCT_MISMATCH = "billing_price_product_mismatch",
+    /**
+     * A purchase named a product that has been RETIRED from the code catalogue.
+     *
+     * `Product.isActive` was the declared off-boarding path — `assertNoBillingAccountDependents`'s own
+     * comment calls the soft retire "the product off-boarding path" — and until 2026-09-09 no purchase
+     * path consulted it. `readProductByKey` returned an inactive product exactly like an active one, so
+     * a product could be withdrawn and still be bought, granting entitlements frozen at whatever the
+     * last catalogue sync wrote.
+     *
+     * Raised as `ErrorType.CONFLICT` (409), not 400 and not 404: the request is well-formed and the
+     * caller is authorized, and the product genuinely exists — what forbids the purchase is the
+     * catalogue's current STATE. A 404 would additionally be a lie to any existing subscriber, whose
+     * subscription still points at this very row.
+     *
+     * Never raised for a REMOVE_ADDON: a customer holding a retired add-on must be able to drop it.
+     */
+    BILLING_PRODUCT_RETIRED = "billing_product_retired",
     BILLING_SCOPE_NOT_ENABLED = "billing_scope_not_enabled",
     /**
      * Hard removal of a billing account was refused because retained financial children
@@ -510,7 +546,10 @@ export declare enum ErrorCustomMessageReference {
     /** File cannot move to the requested status from its current state. */
     FILE_INVALID_STATUS_TRANSITION = "file_invalid_status_transition",
     /** File must be in UPLOADED status before it can be linked to a resource. */
-    FILE_NOT_IN_UPLOADED_STATUS = "file_not_in_uploaded_status",
+    /** The file's status is not one from which it may be linked (`FILE_LINKABLE_STATUSES`); the context carries the status and the admitted set. */
+    FILE_NOT_LINKABLE = "file_not_linkable",
+    /** The file's antivirus scan is still in flight; linking is refused until it lands `CLEAN`. Retryable — the file is not wrong, only not yet known to be safe. */
+    FILE_SCAN_IN_PROGRESS = "file_scan_in_progress",
     /** File is already linked to a different resource. */
     FILE_ALREADY_LINKED = "file_already_linked",
     /** File has already been deleted. */

package/dist/esm/errors/errors.custom-message-ref.shared.definitions.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"errors.custom-message-ref.shared.definitions.d.ts","sourceRoot":"","sources":["../../../../src/errors/errors.custom-message-ref.shared.definitions.ts"],"names":[],"mappings":"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~~IAIvE~~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~~2BAA2B~~,~~gCAAgC~~;~~IAC3D~~,sDAAsD;IACtD,mBAAmB,wBAAwB;IAC3C,qCAAqC;IACrC,oBAAoB,yBAAyB;IAC7C,8CAA8C;IAC9C,kBAAkB,uBAAuB;IACzC,+DAA+D;IAC/D,4BAA4B,iCAAiC;IAC7D,sEAAsE;IACtE,0BAA0B,+BAA+B;IACzD,uDAAuD;IACvD,yBAAyB,8BAA8B;IACvD,8CAA8C;IAC9C,0BAA0B,+BAA+B;IACzD,kDAAkD;IAClD,mBAAmB,wBAAwB;IAC3C,+EAA+E;IAC/E,mBAAmB,wBAAwB;IAC3C,6EAA6E;IAC7E,iCAAiC,sCAAsC;IACvE,wFAAwF;IACxF,0BAA0B,+BAA+B;IACzD,gGAAgG;IAChG,wBAAwB,6BAA6B;IACrD,oGAAoG;IACpG,4BAA4B,iCAAiC;IAC7D,4EAA4E;IAC5E,iCAAiC,sCAAsC;IACvE,kFAAkF;IAClF,sBAAsB,2BAA2B;IACjD,yGAAyG;IACzG,6BAA6B,kCAAkC;IAC/D,yEAAyE;IACzE,6BAA6B,kCAAkC;IAC/D,6EAA6E;IAC7E,4BAA4B,iCAAiC;IAC7D,kEAAkE;IAClE,qCAAqC,0CAA0C;IAC/E;;;;;;;;OAQG;IACH,2BAA2B,gCAAgC;IAC3D,4DAA4D;IAC5D,yBAAyB,8BAA8B;IACvD,gDAAgD;IAChD,0BAA0B,+BAA+B;IACzD,yEAAyE;IACzE,mCAAmC,wCAAwC;IAC3E,0DAA0D;IAC1D,wBAAwB,6BAA6B;IACrD,kFAAkF;IAClF,0BAA0B,+BAA+B;IACzD,qEAAqE;IACrE,4BAA4B,iCAAiC;IAE7D,mFAAmF;IACnF,mCAAmC,wCAAwC;CAC5E"}
1	+ {"version":3,"file":"errors.custom-message-ref.shared.definitions.d.ts","sourceRoot":"","sources":["../../../../src/errors/errors.custom-message-ref.shared.definitions.ts"],"names":[],"mappings":"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"}

package/dist/esm/errors/errors.custom-message-ref.shared.definitions.js CHANGED Viewed

@@ -117,6 +117,17 @@ export var ErrorCustomMessageReference;
     ErrorCustomMessageReference["CROSS_ORG_SSO_BLOCKED"] = "cross_org_sso_blocked";
     ErrorCustomMessageReference["APP_CONFIGURATION_UNAUTHORIZED"] = "app_configuration_unauthorized";
     ErrorCustomMessageReference["APP_CONFIGURATION_NOT_INITIALIZED"] = "app_configuration_not_initialized";
+    /**
+     * An invitation could not be accepted because no user type resolved for the organization being
+     * joined — so no auth policy could be fetched and NO method could be enabled.
+     *
+     * Distinct from `AUTHENTICATION_METHOD_NOT_SUPPORTED` on purpose, and the distinction is the whole
+     * point: an unresolvable policy makes the enabled-method set EMPTY, so every method fails
+     * identically and reporting it as a method problem sends the reader to the auth configuration —
+     * which is typically present and correct. The cause is one level up, in
+     * `organizationTypes[<org type>].userTypes`, and nothing in a method-shaped error points there.
+     */
+    ErrorCustomMessageReference["INVITATION_ORGANIZATION_TYPE_UNRESOLVED"] = "invitation_organization_type_unresolved";
     // Frontend form errors
     ErrorCustomMessageReference["FRONTEND_FORM_READ_OPERATION_NOT_AVAILABLE"] = "frontend_form_read_operation_not_available";
     // Frontend navigation errors
@@ -187,6 +198,14 @@ export var ErrorCustomMessageReference;
     ErrorCustomMessageReference["CONSUMABLE_TOKEN_NOT_ACCEPTED_FOR_OPERATION"] = "consumable_token_not_accepted_for_operation";
     ErrorCustomMessageReference["CONSUMABLE_TOKEN_RACE_CONDITION"] = "consumable_token_race_condition";
     ErrorCustomMessageReference["CONSUMABLE_TOKEN_FILE_SHARING_DISABLED"] = "consumable_token_file_sharing_disabled";
+    /** An upload grant was presented on an upload route it was not minted for (other resource, field, operation kind, or row). */
+    ErrorCustomMessageReference["FILE_UPLOAD_GRANT_TARGET_MISMATCH"] = "file_upload_grant_target_mismatch";
+    /** A grant was requested with a lifetime above the engine ceiling; refused, never clamped. */
+    ErrorCustomMessageReference["FILE_UPLOAD_GRANT_DURATION_EXCEEDS_MAX"] = "file_upload_grant_duration_exceeds_max";
+    /** The caller's execution type may not mint a grant: a grant may not mint a grant, and an anonymous session has no subject to attribute the file to. */
+    ErrorCustomMessageReference["FILE_UPLOAD_GRANT_MINTER_NOT_ELIGIBLE"] = "file_upload_grant_minter_not_eligible";
+    /** No upload grant matches the presented value (never says whether one existed). */
+    ErrorCustomMessageReference["FILE_UPLOAD_GRANT_NOT_FOUND"] = "file_upload_grant_not_found";
     /** W7.3b: ADDITIVE policy requires x-consumable-token header alongside JWT/API-key auth. */
     ErrorCustomMessageReference["ADDITIVE_TOKEN_REQUIRED"] = "additive_token_required";
     /** revocation-B1: requested one-off session `expiresIn` exceeds this user type's max-duration cap. */
@@ -422,6 +441,23 @@ export var ErrorCustomMessageReference;
      * Raised as `ErrorType.VALIDATION` (400) — the payload is internally inconsistent, not unauthorized.
      */
     ErrorCustomMessageReference["BILLING_PRICE_PRODUCT_MISMATCH"] = "billing_price_product_mismatch";
+    /**
+     * A purchase named a product that has been RETIRED from the code catalogue.
+     *
+     * `Product.isActive` was the declared off-boarding path — `assertNoBillingAccountDependents`'s own
+     * comment calls the soft retire "the product off-boarding path" — and until 2026-09-09 no purchase
+     * path consulted it. `readProductByKey` returned an inactive product exactly like an active one, so
+     * a product could be withdrawn and still be bought, granting entitlements frozen at whatever the
+     * last catalogue sync wrote.
+     *
+     * Raised as `ErrorType.CONFLICT` (409), not 400 and not 404: the request is well-formed and the
+     * caller is authorized, and the product genuinely exists — what forbids the purchase is the
+     * catalogue's current STATE. A 404 would additionally be a lie to any existing subscriber, whose
+     * subscription still points at this very row.
+     *
+     * Never raised for a REMOVE_ADDON: a customer holding a retired add-on must be able to drop it.
+     */
+    ErrorCustomMessageReference["BILLING_PRODUCT_RETIRED"] = "billing_product_retired";
     ErrorCustomMessageReference["BILLING_SCOPE_NOT_ENABLED"] = "billing_scope_not_enabled";
     /**
      * Hard removal of a billing account was refused because retained financial children
@@ -537,7 +573,10 @@ export var ErrorCustomMessageReference;
     /** File cannot move to the requested status from its current state. */
     ErrorCustomMessageReference["FILE_INVALID_STATUS_TRANSITION"] = "file_invalid_status_transition";
     /** File must be in UPLOADED status before it can be linked to a resource. */
-    ErrorCustomMessageReference["FILE_NOT_IN_UPLOADED_STATUS"] = "file_not_in_uploaded_status";
+    /** The file's status is not one from which it may be linked (`FILE_LINKABLE_STATUSES`); the context carries the status and the admitted set. */
+    ErrorCustomMessageReference["FILE_NOT_LINKABLE"] = "file_not_linkable";
+    /** The file's antivirus scan is still in flight; linking is refused until it lands `CLEAN`. Retryable — the file is not wrong, only not yet known to be safe. */
+    ErrorCustomMessageReference["FILE_SCAN_IN_PROGRESS"] = "file_scan_in_progress";
     /** File is already linked to a different resource. */
     ErrorCustomMessageReference["FILE_ALREADY_LINKED"] = "file_already_linked";
     /** File has already been deleted. */