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

package/dist/esm/core/config/app-level-components.frontend.schemas.js

@@ -29,6 +29,20 @@ export var ApplicationLevelComponentType;
     ApplicationLevelComponentType["COMMAND_MENU"] = "command_menu";
     ApplicationLevelComponentType["QUICK_ACTION_BUTTON"] = "quick_action_button";
     ApplicationLevelComponentType["QUICK_SWITCHER"] = "quick_switcher";
+    /**
+     * Settings/actions rail.
+     *
+     * **Off in both dogfood applications, and that is an ANSWER rather than an omission (#504).**
+     * Decided 2026-09-09: not withdrawn, because it is an implemented, working preset and deleting a
+     * shell surface because no dogfood happens to use one yet is the weakest possible evidence; and
+     * not switched on, because doing so would mean inventing product concepts for a dogfood
+     * application in order to justify a surface.
+     *
+     * **It is switched on by the first application whose settings and actions genuinely want a
+     * persistent rail rather than the settings hub overlay.** Wonder Todos does not — its settings
+     * reach is served by the hub — so enabling it there would demonstrate an empty rail, not the
+     * surface.
+     */
     ApplicationLevelComponentType["CONTROL_PANEL"] = "control_panel";
     ApplicationLevelComponentType["STATUS_BAR"] = "status_bar";
     ApplicationLevelComponentType["USER_DROPDOWN"] = "user_dropdown";
@@ -38,16 +52,39 @@ export var ApplicationLevelComponentType;
      * the user dropdown component. For distinct UX, register a dedicated preset.
      */
     ApplicationLevelComponentType["NAVIGATION_CONTROL"] = "navigation_control";
-    /** Mode selector — renders available `AppMode`s as selectable icons. */
+    /**
+     * Mode selector — renders available `AppMode`s as selectable icons.
+     *
+     * **Off in both dogfood applications, and that is an ANSWER rather than an omission (#504).**
+     * Decided 2026-09-09, on the same reasoning as `CONTROL_PANEL`: neither withdrawn nor switched on.
+     *
+     * **Its condition is mechanical and checkable: it is switched on by the first application that
+     * declares more than one `AppMode`.** Wonder Todos declares none, so the bar it would render is
+     * empty — enabling it there would demonstrate the gap rather than the surface, which is exactly
+     * what "switched on with something real in it" is meant to prevent.
+     */
     ApplicationLevelComponentType["ACTIVITY_BAR"] = "activity_bar";
     /**
-     * Gmail-style right-side utility panel — references resource operations and
-     * renders views inside a collapsible side panel. Requires navigation zone
-     * containment (in-panel navigation that bypasses main zones).
+     * Gmail-style right-side utility panel — renders configured components inside a collapsible
+     * side sheet.
+     *
+     * **Status, corrected 2026-09-09 (#504).** The panel renders its `items` INLINE and does not
+     * navigate at all: `useUtilityPanelBehavior` resolves an open/close state and a component list,
+     * and the preset renders each `componentRef` through the component registry. Nothing in the panel
+     * calls a navigation API.
+     *
+     * The previous wording said in-panel navigation "still needs its own dedicated navigation zone
+     * instead of reusing main navigation", which reads as a description of what the panel does today
+     * and is not one — there is no in-panel navigation, so nothing is reusing anything. Acting on it
+     * would mean adding a member to the closed `NavigationZoneName` vocabulary that no producer emits
+     * and no consumer reads: the declared-with-no-reader shape, created while removing it.
      *
-     * **Status:** Base app-level surface now renders custom components inside a
-     * side sheet. FE-5 remains deferred: in-panel navigation still needs its own
-     * dedicated navigation zone instead of reusing main navigation.
+     * A dedicated zone becomes real work the moment a panel item NAVIGATES. Then it is genuinely
+     * needed, because a push from inside a side sheet would otherwise land in `PRIMARY` and replace
+     * the workspace the panel is meant to sit beside. Design it then, against the zone vocabulary as
+     * it now stands (`maxDepth`, `responsiveCollapse`, `TABBED` all became live with #411) — and note
+     * `COMPANION` already describes "persistent supplementary content … a Slack thread panel", so the
+     * first question is whether the panel's zone IS `COMPANION` rather than a fourth member.
      */
     ApplicationLevelComponentType["UTILITY_PANEL"] = "utility_panel";
 })(ApplicationLevelComponentType || (ApplicationLevelComponentType = {}));

package/dist/esm/core/config/app-level-components.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-level-components.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/config/app-level-components.frontend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * App-Level Component Types & Display Policy Enums\n *\n * Canonical home for `ApplicationLevelComponentType`, display policy enums\n * (SidebarItemDisplayPolicy, CommandMenuDisplayPolicy, etc.), and HotkeyScope.\n *\n * Extracted from app-configuration-frontend.schemas.ts to break circular\n * dependencies — view definition schemas import from here, and\n * app-configuration-frontend imports those view definitions.\n *\n * Consumers import from this module or from `@wildo-ai/saas-frontend-lib`.\n */\n\nimport { z } from 'zod';\n\n// ════════════════════════════════════════════════════════════════\n// App-Level Component Types (canonical definition)\n// ════════════════════════════════════════════════════════════════\n\n/**\n * @wildo_source:part:start saas.frontend.app-level-component.vocabulary facet:layer:frontend facet:family:app-shell\n *\n * App-level surface identifiers (`ApplicationLevelComponentType`), per-surface display policies, and hotkey emit shortcuts used by shell configuration.\n */\nexport enum ApplicationLevelComponentType {\n  MENUBAR = 'menubar',\n  TOOLBAR = 'toolbar',\n  HOTKEY = 'hotkey',\n  NOTIFICATION_CENTER = 'notification_center',\n  \n  SIDEBAR = 'sidebar',\n  COMMAND_MENU = 'command_menu',\n  QUICK_ACTION_BUTTON = 'quick_action_button',\n  QUICK_SWITCHER = 'quick_switcher',\n  CONTROL_PANEL = 'control_panel',\n  \n  STATUS_BAR = 'status_bar',\n  USER_DROPDOWN = 'user_dropdown',\n  /**\n   * Intentional alias of USER_DROPDOWN — maps to the same `FrontendComponentType` and\n   * renders the same preset. Exists to allow separate config entries while reusing\n   * the user dropdown component. For distinct UX, register a dedicated preset.\n   */\n  NAVIGATION_CONTROL = 'navigation_control',\n  /** Mode selector — renders available `AppMode`s as selectable icons. */\n  ACTIVITY_BAR = 'activity_bar',\n  /**\n   * Gmail-style right-side utility panel — references resource operations and\n   * renders views inside a collapsible side panel. Requires navigation zone\n   * containment (in-panel navigation that bypasses main zones).\n   *\n   * **Status:** Base app-level surface now renders custom components inside a\n   * side sheet. FE-5 remains deferred: in-panel navigation still needs its own\n   * dedicated navigation zone instead of reusing main navigation.\n   */\n  UTILITY_PANEL = 'utility_panel',\n}\n\n// ════════════════════════════════════════════════════════════════\n// Per-Surface Display Policy Enums\n// ════════════════════════════════════════════════════════════════\n\n/** Sidebar item visibility policy */\nexport enum SidebarItemDisplayPolicy {\n  ALWAYS = 'always',\n  SECTION_MORE_MENU = 'section_more_menu',\n}\n\n/** Command menu command display policy */\nexport enum CommandMenuDisplayPolicy {\n  ALWAYS = 'always',\n  NEVER = 'never',\n  RECENT = 'recent',\n  CONTEXTUAL = 'contextual',\n}\n\n/** Quick action button display policy */\nexport enum QuickActionDisplayPolicy {\n  PRIMARY = 'primary',\n  MENU = 'menu',\n}\n\n/** Hotkey scope — determines where the shortcut is active */\nexport enum HotkeyScope {\n  GLOBAL = 'global',\n  PAGE = 'page',\n  COMPONENT = 'component',\n}\n\n/** Hotkey grouping for the shortcuts help dialog. */\nexport enum HotkeyGroup {\n  NAVIGATION = 'navigation',\n  ACTIONS = 'actions',\n  HELP = 'help',\n}\n\n/** Status bar item discriminator for rendering branching. */\nexport enum StatusBarItemType {\n  LINK = 'link',\n  BUTTON = 'button',\n  TEXT = 'text',\n}\n\n// ════════════════════════════════════════════════════════════════\n// Badge Display\n// ════════════════════════════════════════════════════════════════\n\n/** Maximum numeric count shown on badges before truncation. */\nexport const BADGE_DISPLAY_CAP = 99 as const;\n\n/** Formats a badge count for display — truncates above `BADGE_DISPLAY_CAP`. */\nexport function formatBadgeCount(count: number): string {\n  return count > BADGE_DISPLAY_CAP ? `${BADGE_DISPLAY_CAP}+` : String(count);\n}\n\n/**\n * Hotkey rows that only dispatch a `FrontendEvents` payload (no navigation target).\n * String values MUST stay aligned with `FrontendEvents` in `events.frontend.schemas.ts`.\n *\n * Command palette open is NOT listed here: when the command menu surface is enabled,\n * register `[COMMAND_MENU].openShortcut` from `useCommandMenuBehavior` instead.\n */\nexport enum HotkeyDispatchableEvent {\n  HOTKEY_SIDEBAR_TOGGLE = 'hotkey_sidebar_toggle',\n  HOTKEY_NOTIFICATIONS_OPEN = 'hotkey_notifications_open',\n  HOTKEY_QUICK_SWITCHER_OPEN = 'hotkey_quick_switcher_open',\n  HOTKEY_SHORTCUTS_HELP = 'hotkey_shortcuts_help',\n}\n\n/**\n * One declarative emit-only shortcut row in `[HOTKEY].emitShortcuts`.\n * Descriptions use `descriptionLabellingRef` (global i18n key via `t()`), not raw UI copy.\n */\nexport interface HotkeyEmitShortcut {\n  event: HotkeyDispatchableEvent;\n  shortcut: string;\n  /** When `false`, the handler does not register this row. */\n  enabled?: boolean;\n  /**\n   * Global i18n key resolved with `LauncherResolutionContext.t`.\n   * When omitted, `DefaultHotkeyHandler` uses `DEFAULT_HOTKEY_EMIT_DESCRIPTION_KEYS[event]`.\n   */\n  descriptionLabellingRef?: string;\n  scope?: HotkeyScope;\n  group?: HotkeyGroup;\n  preventDefault?: boolean;\n}\n\nexport const HotkeyEmitShortcutSchema = z.object({\n  event: z.enum(HotkeyDispatchableEvent),\n  shortcut: z.string(),\n  enabled: z.boolean().optional(),\n  descriptionLabellingRef: z.string().optional(),\n  scope: z.enum(HotkeyScope).optional(),\n  group: z.enum(HotkeyGroup).optional(),\n  preventDefault: z.boolean().optional(),\n});\n/** @wildo_source:part:end saas.frontend.app-level-component.vocabulary */\n\n"]}
+{"version":3,"file":"app-level-components.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/config/app-level-components.frontend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * App-Level Component Types & Display Policy Enums\n *\n * Canonical home for `ApplicationLevelComponentType`, display policy enums\n * (SidebarItemDisplayPolicy, CommandMenuDisplayPolicy, etc.), and HotkeyScope.\n *\n * Extracted from app-configuration-frontend.schemas.ts to break circular\n * dependencies — view definition schemas import from here, and\n * app-configuration-frontend imports those view definitions.\n *\n * Consumers import from this module or from `@wildo-ai/saas-frontend-lib`.\n */\n\nimport { z } from 'zod';\n\n// ════════════════════════════════════════════════════════════════\n// App-Level Component Types (canonical definition)\n// ════════════════════════════════════════════════════════════════\n\n/**\n * @wildo_source:part:start saas.frontend.app-level-component.vocabulary facet:layer:frontend facet:family:app-shell\n *\n * App-level surface identifiers (`ApplicationLevelComponentType`), per-surface display policies, and hotkey emit shortcuts used by shell configuration.\n */\nexport enum ApplicationLevelComponentType {\n  MENUBAR = 'menubar',\n  TOOLBAR = 'toolbar',\n  HOTKEY = 'hotkey',\n  NOTIFICATION_CENTER = 'notification_center',\n  \n  SIDEBAR = 'sidebar',\n  COMMAND_MENU = 'command_menu',\n  QUICK_ACTION_BUTTON = 'quick_action_button',\n  QUICK_SWITCHER = 'quick_switcher',\n  /**\n   * Settings/actions rail.\n   *\n   * **Off in both dogfood applications, and that is an ANSWER rather than an omission (#504).**\n   * Decided 2026-09-09: not withdrawn, because it is an implemented, working preset and deleting a\n   * shell surface because no dogfood happens to use one yet is the weakest possible evidence; and\n   * not switched on, because doing so would mean inventing product concepts for a dogfood\n   * application in order to justify a surface.\n   *\n   * **It is switched on by the first application whose settings and actions genuinely want a\n   * persistent rail rather than the settings hub overlay.** Wonder Todos does not — its settings\n   * reach is served by the hub — so enabling it there would demonstrate an empty rail, not the\n   * surface.\n   */\n  CONTROL_PANEL = 'control_panel',\n  \n  STATUS_BAR = 'status_bar',\n  USER_DROPDOWN = 'user_dropdown',\n  /**\n   * Intentional alias of USER_DROPDOWN — maps to the same `FrontendComponentType` and\n   * renders the same preset. Exists to allow separate config entries while reusing\n   * the user dropdown component. For distinct UX, register a dedicated preset.\n   */\n  NAVIGATION_CONTROL = 'navigation_control',\n  /**\n   * Mode selector — renders available `AppMode`s as selectable icons.\n   *\n   * **Off in both dogfood applications, and that is an ANSWER rather than an omission (#504).**\n   * Decided 2026-09-09, on the same reasoning as `CONTROL_PANEL`: neither withdrawn nor switched on.\n   *\n   * **Its condition is mechanical and checkable: it is switched on by the first application that\n   * declares more than one `AppMode`.** Wonder Todos declares none, so the bar it would render is\n   * empty — enabling it there would demonstrate the gap rather than the surface, which is exactly\n   * what \"switched on with something real in it\" is meant to prevent.\n   */\n  ACTIVITY_BAR = 'activity_bar',\n  /**\n   * Gmail-style right-side utility panel — renders configured components inside a collapsible\n   * side sheet.\n   *\n   * **Status, corrected 2026-09-09 (#504).** The panel renders its `items` INLINE and does not\n   * navigate at all: `useUtilityPanelBehavior` resolves an open/close state and a component list,\n   * and the preset renders each `componentRef` through the component registry. Nothing in the panel\n   * calls a navigation API.\n   *\n   * The previous wording said in-panel navigation \"still needs its own dedicated navigation zone\n   * instead of reusing main navigation\", which reads as a description of what the panel does today\n   * and is not one — there is no in-panel navigation, so nothing is reusing anything. Acting on it\n   * would mean adding a member to the closed `NavigationZoneName` vocabulary that no producer emits\n   * and no consumer reads: the declared-with-no-reader shape, created while removing it.\n   *\n   * A dedicated zone becomes real work the moment a panel item NAVIGATES. Then it is genuinely\n   * needed, because a push from inside a side sheet would otherwise land in `PRIMARY` and replace\n   * the workspace the panel is meant to sit beside. Design it then, against the zone vocabulary as\n   * it now stands (`maxDepth`, `responsiveCollapse`, `TABBED` all became live with #411) — and note\n   * `COMPANION` already describes \"persistent supplementary content … a Slack thread panel\", so the\n   * first question is whether the panel's zone IS `COMPANION` rather than a fourth member.\n   */\n  UTILITY_PANEL = 'utility_panel',\n}\n\n// ════════════════════════════════════════════════════════════════\n// Per-Surface Display Policy Enums\n// ════════════════════════════════════════════════════════════════\n\n/** Sidebar item visibility policy */\nexport enum SidebarItemDisplayPolicy {\n  ALWAYS = 'always',\n  SECTION_MORE_MENU = 'section_more_menu',\n}\n\n/** Command menu command display policy */\nexport enum CommandMenuDisplayPolicy {\n  ALWAYS = 'always',\n  NEVER = 'never',\n  RECENT = 'recent',\n  CONTEXTUAL = 'contextual',\n}\n\n/** Quick action button display policy */\nexport enum QuickActionDisplayPolicy {\n  PRIMARY = 'primary',\n  MENU = 'menu',\n}\n\n/** Hotkey scope — determines where the shortcut is active */\nexport enum HotkeyScope {\n  GLOBAL = 'global',\n  PAGE = 'page',\n  COMPONENT = 'component',\n}\n\n/** Hotkey grouping for the shortcuts help dialog. */\nexport enum HotkeyGroup {\n  NAVIGATION = 'navigation',\n  ACTIONS = 'actions',\n  HELP = 'help',\n}\n\n/** Status bar item discriminator for rendering branching. */\nexport enum StatusBarItemType {\n  LINK = 'link',\n  BUTTON = 'button',\n  TEXT = 'text',\n}\n\n// ════════════════════════════════════════════════════════════════\n// Badge Display\n// ════════════════════════════════════════════════════════════════\n\n/** Maximum numeric count shown on badges before truncation. */\nexport const BADGE_DISPLAY_CAP = 99 as const;\n\n/** Formats a badge count for display — truncates above `BADGE_DISPLAY_CAP`. */\nexport function formatBadgeCount(count: number): string {\n  return count > BADGE_DISPLAY_CAP ? `${BADGE_DISPLAY_CAP}+` : String(count);\n}\n\n/**\n * Hotkey rows that only dispatch a `FrontendEvents` payload (no navigation target).\n * String values MUST stay aligned with `FrontendEvents` in `events.frontend.schemas.ts`.\n *\n * Command palette open is NOT listed here: when the command menu surface is enabled,\n * register `[COMMAND_MENU].openShortcut` from `useCommandMenuBehavior` instead.\n */\nexport enum HotkeyDispatchableEvent {\n  HOTKEY_SIDEBAR_TOGGLE = 'hotkey_sidebar_toggle',\n  HOTKEY_NOTIFICATIONS_OPEN = 'hotkey_notifications_open',\n  HOTKEY_QUICK_SWITCHER_OPEN = 'hotkey_quick_switcher_open',\n  HOTKEY_SHORTCUTS_HELP = 'hotkey_shortcuts_help',\n}\n\n/**\n * One declarative emit-only shortcut row in `[HOTKEY].emitShortcuts`.\n * Descriptions use `descriptionLabellingRef` (global i18n key via `t()`), not raw UI copy.\n */\nexport interface HotkeyEmitShortcut {\n  event: HotkeyDispatchableEvent;\n  shortcut: string;\n  /** When `false`, the handler does not register this row. */\n  enabled?: boolean;\n  /**\n   * Global i18n key resolved with `LauncherResolutionContext.t`.\n   * When omitted, `DefaultHotkeyHandler` uses `DEFAULT_HOTKEY_EMIT_DESCRIPTION_KEYS[event]`.\n   */\n  descriptionLabellingRef?: string;\n  scope?: HotkeyScope;\n  group?: HotkeyGroup;\n  preventDefault?: boolean;\n}\n\nexport const HotkeyEmitShortcutSchema = z.object({\n  event: z.enum(HotkeyDispatchableEvent),\n  shortcut: z.string(),\n  enabled: z.boolean().optional(),\n  descriptionLabellingRef: z.string().optional(),\n  scope: z.enum(HotkeyScope).optional(),\n  group: z.enum(HotkeyGroup).optional(),\n  preventDefault: z.boolean().optional(),\n});\n/** @wildo_source:part:end saas.frontend.app-level-component.vocabulary */\n\n"]}

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

@@ -161,11 +161,11 @@ export declare const InsertedChartDeclarationSchema: z.ZodObject<{
                 }>>;
                 showLabel: z.ZodOptional<z.ZodBoolean>;
                 labelPosition: z.ZodOptional<z.ZodEnum<{
+                    center: "center";
                     left: "left";
                     right: "right";
                     top: "top";
                     bottom: "bottom";
-                    center: "center";
                     inside: "inside";
                     outside: "outside";
                 }>>;
@@ -174,8 +174,8 @@ export declare const InsertedChartDeclarationSchema: z.ZodObject<{
                 markLines: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     type: z.ZodOptional<z.ZodEnum<{
                         max: "max";
-                        min: "min";
                         average: "average";
+                        min: "min";
                     }>>;
                     yValue: z.ZodOptional<z.ZodNumber>;
                     xValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
@@ -190,8 +190,8 @@ export declare const InsertedChartDeclarationSchema: z.ZodObject<{
                 markPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     type: z.ZodOptional<z.ZodEnum<{
                         max: "max";
-                        min: "min";
                         average: "average";
+                        min: "min";
                     }>>;
                     label: z.ZodOptional<z.ZodString>;
                     symbol: z.ZodOptional<z.ZodEnum<{
@@ -268,10 +268,10 @@ export declare const InsertedChartDeclarationSchema: z.ZodObject<{
                 left: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
                 top: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
                 textAlign: z.ZodOptional<z.ZodEnum<{
+                    center: "center";
                     auto: "auto";
                     left: "left";
                     right: "right";
-                    center: "center";
                 }>>;
             }, z.core.$strip>>;
             animationDuration: z.ZodOptional<z.ZodNumber>;
@@ -432,9 +432,9 @@ export declare const InsertedChartDeclarationSchema: z.ZodObject<{
                 rightTop: "rightTop";
             }>>;
             funnelAlign: z.ZodOptional<z.ZodEnum<{
+                center: "center";
                 left: "left";
                 right: "right";
-                center: "center";
             }>>;
             showLabel: z.ZodOptional<z.ZodBoolean>;
             left: z.ZodOptional<z.ZodString>;
@@ -472,8 +472,8 @@ export declare const InsertedChartDeclarationSchema: z.ZodObject<{
         }, z.core.$loose>, z.ZodObject<{
             emphasisFocus: z.ZodOptional<z.ZodEnum<{
                 none: "none";
-                self: "self";
                 adjacency: "adjacency";
+                self: "self";
             }>>;
             nodeWidth: z.ZodOptional<z.ZodNumber>;
             nodeGap: z.ZodOptional<z.ZodNumber>;
@@ -514,9 +514,9 @@ export declare const InsertedChartDeclarationSchema: z.ZodObject<{
                     radial: "radial";
                 }>>;
                 level2LabelAlign: z.ZodOptional<z.ZodEnum<{
+                    center: "center";
                     left: "left";
                     right: "right";
-                    center: "center";
                 }>>;
                 level3LabelPosition: z.ZodOptional<z.ZodEnum<{
                     inside: "inside";
@@ -688,11 +688,11 @@ export declare const ResolvedInsertedChartDescriptorSchema: z.ZodObject<{
                 }>>;
                 showLabel: z.ZodOptional<z.ZodBoolean>;
                 labelPosition: z.ZodOptional<z.ZodEnum<{
+                    center: "center";
                     left: "left";
                     right: "right";
                     top: "top";
                     bottom: "bottom";
-                    center: "center";
                     inside: "inside";
                     outside: "outside";
                 }>>;
@@ -701,8 +701,8 @@ export declare const ResolvedInsertedChartDescriptorSchema: z.ZodObject<{
                 markLines: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     type: z.ZodOptional<z.ZodEnum<{
                         max: "max";
-                        min: "min";
                         average: "average";
+                        min: "min";
                     }>>;
                     yValue: z.ZodOptional<z.ZodNumber>;
                     xValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
@@ -717,8 +717,8 @@ export declare const ResolvedInsertedChartDescriptorSchema: z.ZodObject<{
                 markPoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     type: z.ZodOptional<z.ZodEnum<{
                         max: "max";
-                        min: "min";
                         average: "average";
+                        min: "min";
                     }>>;
                     label: z.ZodOptional<z.ZodString>;
                     symbol: z.ZodOptional<z.ZodEnum<{
@@ -795,10 +795,10 @@ export declare const ResolvedInsertedChartDescriptorSchema: z.ZodObject<{
                 left: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
                 top: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
                 textAlign: z.ZodOptional<z.ZodEnum<{
+                    center: "center";
                     auto: "auto";
                     left: "left";
                     right: "right";
-                    center: "center";
                 }>>;
             }, z.core.$strip>>;
             animationDuration: z.ZodOptional<z.ZodNumber>;
@@ -959,9 +959,9 @@ export declare const ResolvedInsertedChartDescriptorSchema: z.ZodObject<{
                 rightTop: "rightTop";
             }>>;
             funnelAlign: z.ZodOptional<z.ZodEnum<{
+                center: "center";
                 left: "left";
                 right: "right";
-                center: "center";
             }>>;
             showLabel: z.ZodOptional<z.ZodBoolean>;
             left: z.ZodOptional<z.ZodString>;
@@ -999,8 +999,8 @@ export declare const ResolvedInsertedChartDescriptorSchema: z.ZodObject<{
         }, z.core.$loose>, z.ZodObject<{
             emphasisFocus: z.ZodOptional<z.ZodEnum<{
                 none: "none";
-                self: "self";
                 adjacency: "adjacency";
+                self: "self";
             }>>;
             nodeWidth: z.ZodOptional<z.ZodNumber>;
             nodeGap: z.ZodOptional<z.ZodNumber>;
@@ -1041,9 +1041,9 @@ export declare const ResolvedInsertedChartDescriptorSchema: z.ZodObject<{
                     radial: "radial";
                 }>>;
                 level2LabelAlign: z.ZodOptional<z.ZodEnum<{
+                    center: "center";
                     left: "left";
                     right: "right";
-                    center: "center";
                 }>>;
                 level3LabelPosition: z.ZodOptional<z.ZodEnum<{
                     inside: "inside";

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"chart-view.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/config/chart-view.frontend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { CoreResourceOperation, ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport type {\n  ChartDefinition,\n  ChartSeriesDefinition,\n  ChartAccessControl,\n  ChartAppearance,\n  ChartTypeConfig,\n  ChartInputDefinition,\n  ChartInputValues,\n  AggregationQuery,\n  FrontendChartRegistrationRef,\n} from '@wildo-ai/saas-models';\nimport { ChartDefinitionSchema, ChartInputValuesSchema } from '@wildo-ai/saas-models';\nimport { FrontendView_ScopeMode } from './views-frontend.schemas';\nimport { HOSTED_PANE_QUERY_PARAM } from '~wildo-frontend-lib/core/navigation/hosted-pane.constants';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport { FrontendResource_ParentResourceRequirementSchema } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport type { FrontendResourcesRegistry, ResourceUIBehavior } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport {\n  InsertedViewInputBindingSchema,\n  FrontendInsertedViewIdentitySchema,\n  createFrontendInsertedViewIdentity,\n  FrontendInsertedViewHostKind,\n  FrontendInsertedViewKind,\n  parseFrontendInsertedViewRef,\n  type FrontendInsertedViewIdentity,\n  type InsertedViewInputBinding,\n} from './inserted-view.frontend.schemas';\n\n/**\n * @wildo_source:part:start saas.frontend.chart-view.inserted-declaration facet:layer:frontend facet:family:chart-view\n *\n * Host-owned inserted chart declaration — the **only** chart authoring surface.\n *\n * Design decision (framework mindset): chart views are intentionally\n * **resource-scoped only**. The former app-level `ChartViewDefinition` /\n * `ChartViewDefinitionSchema` and the `AppConfiguration_Frontend.charts`\n * authoring seam were removed because an application-scoped chart has no\n * meaningful operation host to be rendered inside of, and keeping a separate\n * app-level authoring contract for the same runtime concept created drift\n * between authoring sites and specification extraction.\n *\n * Operation surfacing is declared exclusively via `operationLike`:\n *\n * - `operationLike` names the single resource operation host this chart is\n *   rendered inside of (defaulting to `CoreResourceOperation.READ`).\n * - At render time, `ResourceLayout_InsertedViews` filters the resource's\n *   `chartViews` directly by the current operation host against `operationLike`.\n *   There is no operation-level view-ref list and no compiled derivation —\n *   the chart declaration itself carries the link.\n * - There is no list analogue (`surfaceInOperations`) for charts — charts\n *   are always rendered in exactly one operation host. The list-typed\n *   authoring field is reserved for execution views, which legitimately\n *   surface in multiple operation hosts.\n */\nexport const InsertedChartDeclarationSchema = z.object({\n  /**\n   * Charts are resource-owned inserted surfaces only.\n   *\n   * The scope is a Zod literal (rather than the open `FrontendView_ScopeMode`\n   * enum) so that an app-scoped chart is impossible by construction — the\n   * schema refuses to parse one at authoring time, and the TS type refuses\n   * to let a caller construct one at compile time.\n   */\n  scope: z.literal(FrontendView_ScopeMode.RESOURCE),\n  parentResourcesRequirements: FrontendResource_ParentResourceRequirementSchema.array().optional(),\n  additionalResourceRequirements: FrontendResource_ParentResourceRequirementSchema.array().optional(),\n\n  ref: z.string().min(1),\n  chartDefinition: ChartDefinitionSchema,\n  isAddressable: z.boolean().default(false),\n\n  /**\n   * Operation host this chart is rendered inside of.\n   *\n   * Also serves as the **single** declarative source of truth for which\n   * resource operation surface the chart is surfaced in. `ResourceLayout_InsertedViews`\n   * filters `chartViews` directly against this field at render time, and the\n   * specification layer uses `collectOperationLikeViewRefs` with the same\n   * default to mirror per-operation linked view refs. If this default is ever\n   * changed, the matching runtime default at both call sites MUST be updated\n   * in lockstep, otherwise host rendering and spec output disagree.\n   */\n  operationLike: z.enum(CoreResourceOperation).default(CoreResourceOperation.READ),\n  primaryScope: z.enum(ResourcePrimaryScope).default(ResourcePrimaryScope.ORGANIZATIONS),\n  inputBindings: z.array(InsertedViewInputBindingSchema).optional(),\n});\n\nexport interface InsertedChartDeclaration {\n  ref: string;\n  chartDefinition: ChartDefinition;\n  scope: FrontendView_ScopeMode.RESOURCE;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];\n  isAddressable: boolean;\n  operationLike: CoreResourceOperation;\n  primaryScope: ResourcePrimaryScope;\n  inputBindings?: InsertedViewInputBinding[];\n}\n/** @wildo_source:part:end saas.frontend.chart-view.inserted-declaration */\n\nexport function isStandaloneRoutableInsertedChartView(\n  chartView: InsertedChartDeclaration | undefined,\n): boolean {\n  if (!chartView || chartView.isAddressable !== true) {\n    return false;\n  }\n\n  return true;\n}\n\nexport const ResolvedInsertedChartDescriptorSchema = z.object({\n  identity: FrontendInsertedViewIdentitySchema,\n  executionChartRef: z.string().min(1),\n  chartDefinition: ChartDefinitionSchema,\n  contextResourceIdentifiers: z.record(z.string(), z.string()),\n  resolvedInputs: ChartInputValuesSchema.optional(),\n});\n\nexport interface ResolvedInsertedChartDescriptor {\n  identity: FrontendInsertedViewIdentity;\n  executionChartRef: string;\n  chartDefinition: ChartDefinition;\n  contextResourceIdentifiers: Record<string, string>;\n  resolvedInputs?: ChartInputValues;\n}\n\nexport interface ResolvedInsertedChartView {\n  identity: FrontendInsertedViewIdentity;\n  chartView: InsertedChartDeclaration;\n}\n\nexport const CHART_ROUTE_CONTEXT_QUERY_PARAM_PREFIX = 'chart_ctx_';\n/** The chart route's path prefix (`/chart/:viewRef`) — named once so the URL identity rules can recognise it. */\nexport const CHART_ROUTE_PATH_PREFIX = '/chart/';\n\nexport function buildResourceInsertedChartIdentity(\n  resourceType: string,\n  chartView: Pick<InsertedChartDeclaration, 'ref'>,\n): FrontendInsertedViewIdentity {\n  return createFrontendInsertedViewIdentity({\n    hostKind: FrontendInsertedViewHostKind.RESOURCE,\n    hostRef: resourceType,\n    viewKind: FrontendInsertedViewKind.CHART_VIEW,\n    localRef: chartView.ref,\n  });\n}\n\nexport function buildResolvedInsertedChartDescriptor(params: {\n  identity: FrontendInsertedViewIdentity;\n  chartView: InsertedChartDeclaration;\n  contextResourceIdentifiers: Record<string, string>;\n  resolvedInputs?: ChartInputValues;\n}): ResolvedInsertedChartDescriptor {\n  return {\n    identity: params.identity,\n    executionChartRef: params.chartView.chartDefinition.ref,\n    chartDefinition: params.chartView.chartDefinition,\n    contextResourceIdentifiers: params.contextResourceIdentifiers,\n    resolvedInputs: params.resolvedInputs,\n  };\n}\n\nexport function resolveInsertedChartView(params: {\n  viewRef: string | undefined;\n  registry?: FrontendResourcesRegistry;\n}): ResolvedInsertedChartView | undefined {\n  const { viewRef, registry } = params;\n  const insertedIdentity = parseFrontendInsertedViewRef(viewRef);\n  if (\n    !insertedIdentity\n    || insertedIdentity.hostKind !== FrontendInsertedViewHostKind.RESOURCE\n    || insertedIdentity.viewKind !== FrontendInsertedViewKind.CHART_VIEW\n  ) {\n    return undefined;\n  }\n\n  const chartView = registry?.resourceConfigurations[insertedIdentity.hostRef]\n    ?.frontendConfiguration\n    ?.chartViews\n    ?.find((candidate) => candidate.ref === insertedIdentity.localRef);\n  if (!chartView) {\n    return undefined;\n  }\n\n  return {\n    identity: insertedIdentity,\n    chartView,\n  };\n}\n\n/**\n * Collect every frontend chartView's registration identity across all resources,\n * for the chart-registration drift guard (compared against the backend\n * `ChartRegistry.getRegisteredChartRefs()`). Each entry carries the\n * `chartDefinition.ref` (the backend registry JOIN KEY — not the outer\n * `chartView.ref`), plus the owning `resourceType` and `chartView.ref` for a\n * locatable drift error.\n *\n * Reads the MERGED `resourceConfigurations` (shared base + ui-behavior overlay).\n * IMPORTANT for the companion integration: pass the FULL merged registry — a\n * subprocess that materializes only shared-base resources would miss\n * engine-resource-owned chartViews that live purely in the ui-behavior overlay,\n * silently narrowing the guard's frontend set.\n */\nexport function collectFrontendChartRegistrationRefs(\n  registry: FrontendResourcesRegistry,\n): FrontendChartRegistrationRef[] {\n  const refs: FrontendChartRegistrationRef[] = [];\n  const configurations = registry.resourceConfigurations ?? {};\n  for (const [resourceType, configuration] of Object.entries(configurations)) {\n    pushChartRegistrationRefs(refs, resourceType, configuration?.frontendConfiguration?.chartViews);\n  }\n  return refs;\n}\n\n/**\n * Collect chart-registration refs directly from the ui-behavior OVERLAY\n * (`ResourceUIBehavior` — the map `buildFrontendCompanionResourceUIBehavior`\n * produces), rather than the materialized `resourceConfigurations`.\n *\n * The overlay covers EVERY resource in the frontend module chain — including\n * engine resources (e.g. `organizations`) that have no materialized shared base\n * in a companion subprocess and are therefore dropped from\n * `resourceConfigurations`. This is the complete, drift-guard-truthful source\n * for the companion introspection: an engine-resource-owned chartView that is\n * overlay-only would be silently missed by\n * {@link collectFrontendChartRegistrationRefs}. `chartViews` is the SAME field\n * on both shapes (`frontendConfiguration` IS a `ResourceUIBehaviorConfig`), just\n * un-nested here.\n */\nexport function collectFrontendChartRegistrationRefsFromUIBehavior(\n  uiBehavior: ResourceUIBehavior,\n): FrontendChartRegistrationRef[] {\n  const refs: FrontendChartRegistrationRef[] = [];\n  for (const [resourceType, configuration] of Object.entries(uiBehavior ?? {})) {\n    pushChartRegistrationRefs(refs, resourceType, configuration?.chartViews);\n  }\n  return refs;\n}\n\n/** Shared per-resource chartView → registration-ref projection (join key = `chartDefinition.ref`). */\nfunction pushChartRegistrationRefs(\n  acc: FrontendChartRegistrationRef[],\n  resourceType: string,\n  chartViews: InsertedChartDeclaration[] | undefined,\n): void {\n  if (!chartViews) {\n    return;\n  }\n  for (const chartView of chartViews) {\n    acc.push({\n      chartDefinitionRef: chartView.chartDefinition.ref,\n      resourceType,\n      chartViewRef: chartView.ref,\n    });\n  }\n}\n\nexport function buildChartRouteUrlPath(\n  viewRef: string,\n  contextResourceIdentifiers?: Record<string, string>,\n  urlParamValues?: Record<string, string>,\n): string {\n  const params = new URLSearchParams();\n  for (const [key, value] of Object.entries(contextResourceIdentifiers ?? {})) {\n    if (!value) {\n      continue;\n    }\n    params.set(`${CHART_ROUTE_CONTEXT_QUERY_PARAM_PREFIX}${key}`, value);\n  }\n\n  for (const [key, value] of Object.entries(urlParamValues ?? {})) {\n    if (!value || key.startsWith(CHART_ROUTE_CONTEXT_QUERY_PARAM_PREFIX)) {\n      continue;\n    }\n    params.set(key, value);\n  }\n\n  const search = params.toString();\n  return search.length > 0 ? `${CHART_ROUTE_PATH_PREFIX}${viewRef}?${search}` : `${CHART_ROUTE_PATH_PREFIX}${viewRef}`;\n}\n\nexport function extractChartRouteContextResourceIdentifiers(\n  searchParams: URLSearchParams,\n): Record<string, string> | undefined {\n  const contextResourceIdentifiers: Record<string, string> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    if (!key.startsWith(CHART_ROUTE_CONTEXT_QUERY_PARAM_PREFIX) || !value) {\n      continue;\n    }\n    contextResourceIdentifiers[key.slice(CHART_ROUTE_CONTEXT_QUERY_PARAM_PREFIX.length)] = value;\n  }\n\n  return Object.keys(contextResourceIdentifiers).length > 0 ? contextResourceIdentifiers : undefined;\n}\n\nexport function extractChartRouteUrlParamValues(\n  searchParams: URLSearchParams,\n): Record<string, string> | undefined {\n  const urlParamValues: Record<string, string> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    // A hosted pane beside the chart rides on the chart's URL (`?pane=`); it is a navigation\n    // address, never a chart url-param value.\n    if (!value || key.startsWith(CHART_ROUTE_CONTEXT_QUERY_PARAM_PREFIX) || key === HOSTED_PANE_QUERY_PARAM) {\n      continue;\n    }\n\n    urlParamValues[key] = value;\n  }\n\n  return Object.keys(urlParamValues).length > 0 ? urlParamValues : undefined;\n}\n\nexport type {\n  ChartSeriesDefinition,\n  ChartAccessControl,\n  ChartAppearance,\n  ChartTypeConfig,\n  ChartInputDefinition,\n  AggregationQuery,\n};\n"]}
+{"version":3,"file":"chart-view.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/config/chart-view.frontend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { CoreResourceOperation, ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport type {\n  ChartDefinition,\n  ChartSeriesDefinition,\n  ChartAccessControl,\n  ChartAppearance,\n  ChartTypeConfig,\n  ChartInputDefinition,\n  ChartInputValues,\n  AggregationQuery,\n  FrontendChartRegistrationRef,\n} from '@wildo-ai/saas-models';\nimport { ChartDefinitionSchema, ChartInputValuesSchema } from '@wildo-ai/saas-models';\nimport { FrontendView_ScopeMode } from './views-frontend.schemas';\nimport { HOSTED_PANE_QUERY_PARAM } from '~wildo-frontend-lib/core/navigation/hosted-pane.constants';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport { FrontendResource_ParentResourceRequirementSchema } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport type { FrontendResourcesRegistry, ResourceUIBehavior } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport {\n  InsertedViewInputBindingSchema,\n  FrontendInsertedViewIdentitySchema,\n  createFrontendInsertedViewIdentity,\n  FrontendInsertedViewHostKind,\n  FrontendInsertedViewKind,\n  parseFrontendInsertedViewRef,\n  type FrontendInsertedViewIdentity,\n  type InsertedViewInputBinding,\n} from './inserted-view.frontend.schemas';\n\n/**\n * @wildo_source:part:start saas.frontend.chart-view.inserted-declaration facet:layer:frontend facet:family:chart-view\n *\n * Host-owned inserted chart declaration — the **only** chart authoring surface.\n *\n * Design decision (framework mindset): chart views are intentionally\n * **resource-scoped only**. The former app-level `ChartViewDefinition` /\n * `ChartViewDefinitionSchema` and the `AppConfiguration_Frontend.charts`\n * authoring seam were removed because an application-scoped chart has no\n * meaningful operation host to be rendered inside of, and keeping a separate\n * app-level authoring contract for the same runtime concept created drift\n * between authoring sites and specification extraction.\n *\n * Operation surfacing is declared exclusively via `operationLike`:\n *\n * - `operationLike` names the single resource operation host this chart is\n *   rendered inside of (defaulting to `CoreResourceOperation.READ`).\n * - At render time, `ResourceLayout_InsertedViews` filters the resource's\n *   `chartViews` directly by the current operation host against `operationLike`.\n *   There is no operation-level view-ref list and no compiled derivation —\n *   the chart declaration itself carries the link.\n * - There is no list analogue (`surfaceInOperations`) for charts — charts\n *   are always rendered in exactly one operation host. The list-typed\n *   authoring field is reserved for execution views, which legitimately\n *   surface in multiple operation hosts.\n */\nexport const InsertedChartDeclarationSchema = z.object({\n  /**\n   * Charts are resource-owned inserted surfaces only.\n   *\n   * The scope is a Zod literal (rather than the open `FrontendView_ScopeMode`\n   * enum) so that an app-scoped chart is impossible by construction — the\n   * schema refuses to parse one at authoring time, and the TS type refuses\n   * to let a caller construct one at compile time.\n   */\n  scope: z.literal(FrontendView_ScopeMode.RESOURCE),\n  parentResourcesRequirements: FrontendResource_ParentResourceRequirementSchema.array().optional(),\n  additionalResourceRequirements: FrontendResource_ParentResourceRequirementSchema.array().optional(),\n\n  ref: z.string().min(1),\n  chartDefinition: ChartDefinitionSchema,\n  isAddressable: z.boolean().default(false),\n\n  /**\n   * Operation host this chart is rendered inside of.\n   *\n   * Also serves as the **single** declarative source of truth for which\n   * resource operation surface the chart is surfaced in. `ResourceLayout_InsertedViews`\n   * filters `chartViews` directly against this field at render time, and the\n   * specification layer uses `collectOperationLikeViewRefs` with the same\n   * default to mirror per-operation linked view refs. If this default is ever\n   * changed, the matching runtime default at both call sites MUST be updated\n   * in lockstep, otherwise host rendering and spec output disagree.\n   */\n  operationLike: z.enum(CoreResourceOperation).default(CoreResourceOperation.READ),\n  primaryScope: z.enum(ResourcePrimaryScope).default(ResourcePrimaryScope.ORGANIZATIONS),\n  inputBindings: z.array(InsertedViewInputBindingSchema).optional(),\n});\n\nexport interface InsertedChartDeclaration {\n  ref: string;\n  chartDefinition: ChartDefinition;\n  scope: FrontendView_ScopeMode.RESOURCE;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];\n  isAddressable: boolean;\n  operationLike: CoreResourceOperation;\n  primaryScope: ResourcePrimaryScope;\n  inputBindings?: InsertedViewInputBinding[];\n}\n/** @wildo_source:part:end saas.frontend.chart-view.inserted-declaration */\n\nexport function isStandaloneRoutableInsertedChartView(\n  chartView: InsertedChartDeclaration | undefined,\n): boolean {\n  if (!chartView || chartView.isAddressable !== true) {\n    return false;\n  }\n\n  return true;\n}\n\nexport const ResolvedInsertedChartDescriptorSchema = z.object({\n  identity: FrontendInsertedViewIdentitySchema,\n  executionChartRef: z.string().min(1),\n  chartDefinition: ChartDefinitionSchema,\n  contextResourceIdentifiers: z.record(z.string(), z.string()),\n  resolvedInputs: ChartInputValuesSchema.optional(),\n});\n\nexport interface ResolvedInsertedChartDescriptor {\n  identity: FrontendInsertedViewIdentity;\n  executionChartRef: string;\n  chartDefinition: ChartDefinition;\n  contextResourceIdentifiers: Record<string, string>;\n  resolvedInputs?: ChartInputValues;\n}\n\nexport interface ResolvedInsertedChartView {\n  identity: FrontendInsertedViewIdentity;\n  chartView: InsertedChartDeclaration;\n}\n\nexport const CHART_ROUTE_CONTEXT_QUERY_PARAM_PREFIX = 'chart_ctx_';\n/** The chart route's path prefix (`/chart/:viewRef`) — named once so the URL identity rules can recognise it. */\nexport const CHART_ROUTE_PATH_PREFIX = '/chart/';\n\nexport function buildResourceInsertedChartIdentity(\n  resourceType: string,\n  chartView: Pick<InsertedChartDeclaration, 'ref'>,\n): FrontendInsertedViewIdentity {\n  return createFrontendInsertedViewIdentity({\n    hostKind: FrontendInsertedViewHostKind.RESOURCE,\n    hostRef: resourceType,\n    viewKind: FrontendInsertedViewKind.CHART_VIEW,\n    localRef: chartView.ref,\n  });\n}\n\nexport function buildResolvedInsertedChartDescriptor(params: {\n  identity: FrontendInsertedViewIdentity;\n  chartView: InsertedChartDeclaration;\n  contextResourceIdentifiers: Record<string, string>;\n  resolvedInputs?: ChartInputValues;\n}): ResolvedInsertedChartDescriptor {\n  return {\n    identity: params.identity,\n    executionChartRef: params.chartView.chartDefinition.ref,\n    chartDefinition: params.chartView.chartDefinition,\n    contextResourceIdentifiers: params.contextResourceIdentifiers,\n    resolvedInputs: params.resolvedInputs,\n  };\n}\n\nexport function resolveInsertedChartView(params: {\n  viewRef: string | undefined;\n  registry?: FrontendResourcesRegistry;\n}): ResolvedInsertedChartView | undefined {\n  const { viewRef, registry } = params;\n  const insertedIdentity = parseFrontendInsertedViewRef(viewRef);\n  if (\n    !insertedIdentity\n    || insertedIdentity.hostKind !== FrontendInsertedViewHostKind.RESOURCE\n    || insertedIdentity.viewKind !== FrontendInsertedViewKind.CHART_VIEW\n  ) {\n    return undefined;\n  }\n\n  const chartView = registry?.resourceConfigurations[insertedIdentity.hostRef]\n    ?.frontendConfiguration\n    ?.chartViews\n    ?.find((candidate) => candidate.ref === insertedIdentity.localRef);\n  if (!chartView) {\n    return undefined;\n  }\n\n  return {\n    identity: insertedIdentity,\n    chartView,\n  };\n}\n\n/**\n * Collect every frontend chartView's registration identity across all resources,\n * for the chart-registration drift guard (compared against the backend\n * `ChartRegistry.getRegisteredChartRefs()`). Each entry carries the\n * `chartDefinition.ref` (the backend registry JOIN KEY — not the outer\n * `chartView.ref`), plus the owning `resourceType` and `chartView.ref` for a\n * locatable drift error.\n *\n * Reads the MERGED `resourceConfigurations` (shared base + ui-behavior overlay).\n * IMPORTANT for the companion integration: pass the FULL merged registry — a\n * subprocess that materializes only shared-base resources would miss\n * engine-resource-owned chartViews that live purely in the ui-behavior overlay,\n * silently narrowing the guard's frontend set.\n */\nexport function collectFrontendChartRegistrationRefs(\n  registry: FrontendResourcesRegistry,\n): FrontendChartRegistrationRef[] {\n  const refs: FrontendChartRegistrationRef[] = [];\n  const configurations = registry.resourceConfigurations ?? {};\n  for (const [resourceType, configuration] of Object.entries(configurations)) {\n    pushChartRegistrationRefs(refs, resourceType, configuration?.frontendConfiguration?.chartViews);\n  }\n  return refs;\n}\n\n/**\n * Collect chart-registration refs directly from the ui-behavior OVERLAY\n * (`ResourceUIBehavior` — the map `buildFrontendCompanionResourceUIBehavior`\n * produces), rather than the materialized `resourceConfigurations`.\n *\n * The overlay covers EVERY resource in the frontend module chain — including\n * engine resources (e.g. `organizations`) that have no materialized shared base\n * in a companion subprocess and are therefore dropped from\n * `resourceConfigurations`. This is the complete, drift-guard-truthful source\n * for the companion introspection: an engine-resource-owned chartView that is\n * overlay-only would be silently missed by\n * {@link collectFrontendChartRegistrationRefs}. `chartViews` is the SAME field\n * on both shapes (`frontendConfiguration` IS a `ResourceUIBehaviorConfig`), just\n * un-nested here.\n */\nexport function collectFrontendChartRegistrationRefsFromUIBehavior(\n  uiBehavior: ResourceUIBehavior,\n): FrontendChartRegistrationRef[] {\n  const refs: FrontendChartRegistrationRef[] = [];\n  for (const [resourceType, configuration] of Object.entries(uiBehavior ?? {})) {\n    pushChartRegistrationRefs(refs, resourceType, configuration?.chartViews);\n  }\n  return refs;\n}\n\n/** Shared per-resource chartView → registration-ref projection (join key = `chartDefinition.ref`). */\nfunction pushChartRegistrationRefs(\n  acc: FrontendChartRegistrationRef[],\n  resourceType: string,\n  chartViews: InsertedChartDeclaration[] | undefined,\n): void {\n  if (!chartViews) {\n    return;\n  }\n  for (const chartView of chartViews) {\n    acc.push({\n      chartDefinitionRef: chartView.chartDefinition.ref,\n      resourceType,\n      chartViewRef: chartView.ref,\n    });\n  }\n}\n\nexport function buildChartRouteUrlPath(\n  viewRef: string,\n  contextResourceIdentifiers?: Record<string, string>,\n  urlParamValues?: Record<string, string>,\n): string {\n  const params = new URLSearchParams();\n  for (const [key, value] of Object.entries(contextResourceIdentifiers ?? {})) {\n    if (!value) {\n      continue;\n    }\n    params.set(`${CHART_ROUTE_CONTEXT_QUERY_PARAM_PREFIX}${key}`, value);\n  }\n\n  for (const [key, value] of Object.entries(urlParamValues ?? {})) {\n    if (!value || key.startsWith(CHART_ROUTE_CONTEXT_QUERY_PARAM_PREFIX)) {\n      continue;\n    }\n    params.set(key, value);\n  }\n\n  const search = params.toString();\n  return search.length > 0 ? `${CHART_ROUTE_PATH_PREFIX}${viewRef}?${search}` : `${CHART_ROUTE_PATH_PREFIX}${viewRef}`;\n}\n\nexport function extractChartRouteContextResourceIdentifiers(\n  searchParams: URLSearchParams,\n): Record<string, string> | undefined {\n  const contextResourceIdentifiers: Record<string, string> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    if (!key.startsWith(CHART_ROUTE_CONTEXT_QUERY_PARAM_PREFIX) || !value) {\n      continue;\n    }\n    contextResourceIdentifiers[key.slice(CHART_ROUTE_CONTEXT_QUERY_PARAM_PREFIX.length)] = value;\n  }\n\n  return Object.keys(contextResourceIdentifiers).length > 0 ? contextResourceIdentifiers : undefined;\n}\n\nexport function extractChartRouteUrlParamValues(\n  searchParams: URLSearchParams,\n): Record<string, string> | undefined {\n  const urlParamValues: Record<string, string> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    // A hosted pane beside the chart rides on the chart's URL (`?pane=`); it is a navigation\n    // address, never a chart url-param value.\n    if (!value || key.startsWith(CHART_ROUTE_CONTEXT_QUERY_PARAM_PREFIX) || key === HOSTED_PANE_QUERY_PARAM) {\n      continue;\n    }\n\n    urlParamValues[key] = value;\n  }\n\n  return Object.keys(urlParamValues).length > 0 ? urlParamValues : undefined;\n}\n\nexport type {\n  ChartSeriesDefinition,\n  ChartAccessControl,\n  ChartAppearance,\n  ChartTypeConfig,\n  ChartInputDefinition,\n  AggregationQuery,\n};\n"]}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"composite-view.schemas.js","sourceRoot":"","sources":["../../../../../src/core/config/composite-view.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { RESPONSIVE_MAX_WIDTH_VALUES, type ResponsiveMaxWidth } from '@wildo-ai/presets-components-models';\nimport type React from 'react';\nimport { z } from 'zod';\nimport type { IconLike } from '@wildo-ai/zod-decorators';\nimport {\n  CoreResourceOperation,\n  ResourcePrimaryScope,\n  RequiredFeaturesConfigSchema,\n  ZoneEmptyBehavior,\n  type RequiredFeaturesConfig,\n} from '@wildo-ai/saas-models';\nimport {\n  FrontendView_ScopeMode,\n  FrontendView_DefinitionSchema,\n  buildApplicationViewTranslationRef,\n} from './views-frontend.schemas';\nimport {\n  FrontendInsertedViewHostKind,\n  FrontendInsertedViewKind,\n  createFrontendInsertedViewIdentity,\n  parseFrontendInsertedViewRef,\n  type FrontendInsertedViewIdentity,\n} from './inserted-view.frontend.schemas';\nimport {\n  FrontendResource_ParentResourceRequirementSchema,\n  type FrontendResource_ParentResourceRequirement,\n} from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport type { FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\n/**\n * @wildo_source:part:start saas.frontend.composite-view.authoring facet:layer:frontend facet:family:composite-view\n *\n * Resource-owned composite view: props, authoring config, definition, `defineCompositeView()` helper.\n */\nexport interface CompositeViewComponentProps {\n  viewRef: string;\n  viewDefinition: CompositeViewDefinition;\n}\n\n/**\n * Base authoring shape shared by both app-level and resource-level composite\n * views. Fields on this base are valid at **either** scope.\n *\n * Design decision: `operationLike` is intentionally **NOT** on this base,\n * because app-level composites have no resource operation host to be\n * rendered inside of — the field would carry no semantic weight at app\n * scope. Only the resource-scoped subtype\n * {@link ResourceCompositeViewAuthoringConfig} carries `operationLike`.\n */\nexport interface CompositeViewAuthoringConfig {\n  viewComponent: React.ComponentType<CompositeViewComponentProps>;\n  /** Companion-readable section refs used by the view's `<Section name=\"...\">` nodes. */\n  sectionRefs?: string[];\n  /**\n   * Composite-view icon — `StandardIconReference` string or React component\n   * (Lucide / custom). Mirrored from authoring → {@link CompositeViewDefinition.icon},\n   * then surfaced into `CoreIconRegistry.compositeView` by the\n   * `IconRegistryBridge` so navigation launchers (sidebar, command menu,\n   * overlays) render the authored icon.\n   */\n  icon?: IconLike;\n  /**\n   * What happens to an ADJACENT zone (secondary / companion) this destination\n   * splits into, once that zone's last content is dismissed — overriding the\n   * zone's own `onEmpty` while this destination occupies primary.\n   *\n   * The zone-level `ZoneConfig.onEmpty` is one value for every destination that\n   * splits into that zone, and destinations legitimately disagree: a LIST wants\n   * the detail pane to stay put (`EMPTY_STATE`) so the layout does not reflow\n   * while a reviewer steps through rows, while a CANVAS wants its width back\n   * (`COLLAPSE`) the moment nothing is selected. Both share one secondary zone,\n   * so without this override one of them is always wrong.\n   *\n   * Omitted (the common case) defers to the zone, which itself defaults to\n   * `ZoneEmptyBehavior.COLLAPSE`. Resolution order is destination → zone →\n   * COLLAPSE; see `resolveZoneEmptyBehavior`.\n   */\n  adjacentZoneOnEmpty?: ZoneEmptyBehavior;\n  /**\n   * How wide this destination's content may grow in the zone, in the framework's shared width\n   * vocabulary — the SAME `ResponsiveMaxWidth` a Surface, a `DisplayLayout` and a `FormLayout` use.\n   *\n   * Omitted (the common case) is `'content'`: capped and centred at `var(--content-max-width, 80rem)`,\n   * right for a form, a list or a detail page and wrong only for content whose value IS the space it\n   * occupies — a board, a wide table, a canvas — which declare `'none'`.\n   */\n  zoneContentMaxWidth?: ResponsiveMaxWidth;\n  /**\n   * Whether this destination's content fills the zone's HEIGHT as well.\n   *\n   * `true` makes the zone's content boundary a definite-height flex column, so this view's root may use\n   * `flex-1 min-h-0` and resolve against something real. Without it a canvas has no intrinsic height\n   * and collapses to zero — which is why one had to hand-roll `h-[70vh]`, sizing against the WINDOW\n   * rather than the container it sits in. PRIMARY only: an adjacent zone scrolls, so a filling child\n   * and a scrolling parent contradict each other.\n   *\n   * Separate from the width above ON PURPOSE — see `zone-content-geometry.ts` for why the enum that\n   * fused them could not express a capped width with a definite height.\n   */\n  zoneContentFillsHeight?: boolean;\n}\n\n/**\n * Resource-scoped composite view authoring. Extends the base with\n * `operationLike`, which declares the **single** resource operation host\n * this composite is rendered inside of (and therefore the access policy it\n * exhibits). Composite views are always rendered inside exactly one\n * operation host, so `operationLike` is intentionally single-valued — the\n * list analogue is reserved for execution views, which can legitimately\n * surface in several operation hosts.\n *\n * `operationLike` is the **single declarative source of truth** for\n * composite surfacing: at render time, `ResourceLayout_InsertedViews` filters\n * the resource's `compositeViews` directly by the current operation host\n * against `operationLike`. There is no operation-level view-ref list and no\n * compiled derivation — the composite declaration itself carries the link.\n */\nexport interface ResourceCompositeViewAuthoringConfig extends CompositeViewAuthoringConfig {\n  /**\n   * Operation host this composite is rendered inside of, and the sole\n   * declarative link driving where this composite surfaces at runtime.\n   *\n   * Defaults to `CoreResourceOperation.READ` when omitted. This default\n   * MUST match the fallback passed to `collectOperationLikeViewRefs` at the\n   * specification-extraction call site — if it ever diverges, runtime host\n   * rendering (which reads `operationLike` directly) and the compiled\n   * specification output (which mirrors it via the collector) disagree\n   * silently.\n   */\n  operationLike?: CoreResourceOperation;\n}\n\nexport interface CompositeViewDefinition {\n  // Base FrontendView_Definition fields\n  scope: FrontendView_ScopeMode;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];\n  // CompositeView-specific fields\n  ref: string;\n  /** Stable translation identity used for composite-view label lookup/generation. */\n  translationRef: string;\n  isAddressable: boolean;\n  operationLike: CoreResourceOperation;\n  primaryScope: ResourcePrimaryScope;\n  sectionRefs?: string[];\n  viewComponent: React.ComponentType<CompositeViewComponentProps>;\n  /** Required features for this view — gates navigation + route access */\n  requiredFeatures?: RequiredFeaturesConfig;\n  /**\n   * Composite-view icon, propagated verbatim from authoring\n   * ({@link CompositeViewAuthoringConfig.icon}). The `IconRegistryBridge`\n   * walks all composite-view definitions and registers their icons into\n   * `CoreIconRegistry.compositeView`, keyed by `ref`.\n   */\n  icon?: IconLike;\n  /** See {@link CompositeViewAuthoringConfig.adjacentZoneOnEmpty}. Mirrored from authoring. */\n  adjacentZoneOnEmpty?: ZoneEmptyBehavior;\n  /** See {@link CompositeViewAuthoringConfig.zoneContentMaxWidth}. Mirrored from authoring. */\n  zoneContentMaxWidth?: ResponsiveMaxWidth;\n  /** See {@link CompositeViewAuthoringConfig.zoneContentFillsHeight}. Mirrored from authoring. */\n  zoneContentFillsHeight?: boolean;\n}\n\nexport type AppCompositeViewsConfig = Record<string, CompositeViewAuthoringConfig>;\n\nexport type InsertedCompositeDeclaration = CompositeViewDefinition;\n/** @wildo_source:part:end saas.frontend.composite-view.authoring */\n\nexport function buildApplicationCompositeViewTranslationRef(viewRef: string): string {\n  return buildApplicationViewTranslationRef(viewRef);\n}\n\nexport function buildResourceCompositeViewTranslationRef(\n  resourceType: string,\n  viewRef: string,\n): string {\n  return `resources.${resourceType}.${viewRef}`;\n}\n\n/**\n * @wildo_source:part:start saas.frontend.composite-view.define-helper facet:layer:frontend facet:family:composite-view\n *\n * Authoring helper: attach a composite view component with optional\n * `sectionRefs`. This helper targets the **base** authoring shape\n * ({@link CompositeViewAuthoringConfig}) and is suitable for app-level\n * composites. Resource-scoped composites additionally support\n * {@link ResourceCompositeViewAuthoringConfig.operationLike} and are\n * usually authored as plain object literals inside\n * `ResourceCompositeViewsConfig` so authors can declare `operationLike`\n * inline.\n */\nexport function defineCompositeView(\n  viewComponent: React.ComponentType<CompositeViewComponentProps>,\n  config: Omit<CompositeViewAuthoringConfig, 'viewComponent'> = {},\n): CompositeViewAuthoringConfig {\n  return {\n    viewComponent,\n    ...config,\n  };\n}\n/** @wildo_source:part:end saas.frontend.composite-view.define-helper */\n\nexport const COMPOSITE_ROUTE_CONTEXT_QUERY_PARAM_PREFIX = 'composite_ctx_';\n\nexport function isStandaloneRoutableCompositeView(\n  compositeView: CompositeViewDefinition | undefined,\n): boolean {\n  return (\n    compositeView?.isAddressable === true\n    && compositeView.scope === FrontendView_ScopeMode.APPLICATION\n  );\n}\n\nexport function buildApplicationCompositeViewDefinitions(\n  authoredCompositeViews: AppCompositeViewsConfig | undefined,\n): CompositeViewDefinition[] {\n  if (!authoredCompositeViews) {\n    return [];\n  }\n\n  return Object.entries(authoredCompositeViews).map(([ref, authoredView]) => ({\n    ref,\n    translationRef: buildApplicationCompositeViewTranslationRef(ref),\n    scope: FrontendView_ScopeMode.APPLICATION,\n    isAddressable: true,\n    operationLike: CoreResourceOperation.READ,\n    primaryScope: ResourcePrimaryScope.APPLICATION,\n    sectionRefs: authoredView.sectionRefs,\n    viewComponent: authoredView.viewComponent,\n    icon: authoredView.icon,\n    adjacentZoneOnEmpty: authoredView.adjacentZoneOnEmpty,\n    zoneContentMaxWidth: authoredView.zoneContentMaxWidth,\n    zoneContentFillsHeight: authoredView.zoneContentFillsHeight,\n  }));\n}\n\nexport function isStandaloneRoutableInsertedCompositeView(\n  compositeView: CompositeViewDefinition | undefined,\n): boolean {\n  return (\n    compositeView?.isAddressable === true\n    && compositeView.scope === FrontendView_ScopeMode.RESOURCE\n  );\n}\n\nexport function isStandaloneRoutableResolvedCompositeView(\n  compositeView: CompositeViewDefinition | undefined,\n): boolean {\n  if (!compositeView) {\n    return false;\n  }\n\n  return compositeView.scope === FrontendView_ScopeMode.APPLICATION\n    ? isStandaloneRoutableCompositeView(compositeView)\n    : isStandaloneRoutableInsertedCompositeView(compositeView);\n}\n\nexport function buildResourceInsertedCompositeIdentity(\n  resourceType: string,\n  compositeView: Pick<CompositeViewDefinition, 'ref'>,\n): FrontendInsertedViewIdentity {\n  return createFrontendInsertedViewIdentity({\n    hostKind: FrontendInsertedViewHostKind.RESOURCE,\n    hostRef: resourceType,\n    viewKind: FrontendInsertedViewKind.COMPOSITE_VIEW,\n    localRef: compositeView.ref,\n  });\n}\n\nexport function resolveCompositeViewDefinition(params: {\n  viewRef: string | undefined;\n  compositeViews?: CompositeViewDefinition[];\n  registry?: FrontendResourcesRegistry;\n}): CompositeViewDefinition | undefined {\n  const { viewRef, compositeViews, registry } = params;\n  if (!viewRef) {\n    return undefined;\n  }\n\n  const applicationCompositeView = compositeViews?.find((candidate) => candidate.ref === viewRef);\n  if (applicationCompositeView) {\n    return applicationCompositeView;\n  }\n\n  const insertedIdentity = parseFrontendInsertedViewRef(viewRef);\n  if (\n    !insertedIdentity\n    || insertedIdentity.hostKind !== FrontendInsertedViewHostKind.RESOURCE\n    || insertedIdentity.viewKind !== FrontendInsertedViewKind.COMPOSITE_VIEW\n  ) {\n    return undefined;\n  }\n\n  return registry?.resourceConfigurations[insertedIdentity.hostRef]\n    ?.frontendConfiguration\n    ?.compositeViews\n    ?.find((candidate) => candidate.ref === insertedIdentity.localRef);\n}\n\nexport function resolveCompositeViewPrimaryScope(params: {\n  viewRef: string | undefined;\n  compositeViews?: Array<{ ref: string; primaryScope?: ResourcePrimaryScope }>;\n  registry?: FrontendResourcesRegistry;\n}): ResourcePrimaryScope | undefined {\n  const { viewRef, compositeViews, registry } = params;\n  if (!viewRef) {\n    return undefined;\n  }\n\n  const applicationCompositeView = compositeViews?.find((candidate) => candidate.ref === viewRef);\n  if (applicationCompositeView?.primaryScope) {\n    return applicationCompositeView.primaryScope;\n  }\n\n  const insertedIdentity = parseFrontendInsertedViewRef(viewRef);\n  if (\n    !insertedIdentity\n    || insertedIdentity.hostKind !== FrontendInsertedViewHostKind.RESOURCE\n    || insertedIdentity.viewKind !== FrontendInsertedViewKind.COMPOSITE_VIEW\n  ) {\n    return undefined;\n  }\n\n  return registry?.resourceConfigurations[insertedIdentity.hostRef]\n    ?.frontendConfiguration\n    ?.compositeViews\n    ?.find((candidate) => candidate.ref === insertedIdentity.localRef)\n    ?.primaryScope;\n}\n\nexport function buildCompositeRouteUrlPath(\n  viewRef: string,\n  contextResourceIdentifiers?: Record<string, string>,\n): string {\n  const params = new URLSearchParams();\n  for (const [key, value] of Object.entries(contextResourceIdentifiers ?? {})) {\n    if (!value) {\n      continue;\n    }\n    params.set(`${COMPOSITE_ROUTE_CONTEXT_QUERY_PARAM_PREFIX}${key}`, value);\n  }\n\n  const search = params.toString();\n  return search.length > 0 ? `/composite/${viewRef}?${search}` : `/composite/${viewRef}`;\n}\n\nexport function extractCompositeRouteContextResourceIdentifiers(\n  searchParams: URLSearchParams,\n): Record<string, string> | undefined {\n  const contextResourceIdentifiers: Record<string, string> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    if (!key.startsWith(COMPOSITE_ROUTE_CONTEXT_QUERY_PARAM_PREFIX) || !value) {\n      continue;\n    }\n    contextResourceIdentifiers[key.slice(COMPOSITE_ROUTE_CONTEXT_QUERY_PARAM_PREFIX.length)] = value;\n  }\n\n  return Object.keys(contextResourceIdentifiers).length > 0 ? contextResourceIdentifiers : undefined;\n}\n\n/**\n * Base fields for authored top-level composite views.\n *\n * The old GridStack/document-era composite schema has been removed. Composite\n * views are now declared as direct authored React components plus ordinary\n * routed view metadata.\n */\nexport const CompositeView_BaseFieldsSchema = z.object({\n  /** Unique reference for this view */\n  ref: z.string().min(1),\n  /** Stable translation identity used for composite-view label lookup/generation */\n  translationRef: z.string().min(1),\n  /** Whether this view has its own URL route */\n  isAddressable: z.boolean().default(false),\n  /** Operation-like behavior for access control */\n  operationLike: z.enum(CoreResourceOperation).default(CoreResourceOperation.READ),\n  /** Primary scope for this view - determines which context identifiers are injected during navigation */\n  primaryScope: z.enum(ResourcePrimaryScope).default(ResourcePrimaryScope.ORGANIZATIONS),\n  /** Companion-readable section refs used by the view's `<Section name=\"...\">` nodes. */\n  sectionRefs: z.array(z.string()).optional(),\n  /**\n   * Direct authored composite view component.\n   *\n   * Top-level composite views are authored as direct React components.\n   */\n  viewComponent: z.any(),\n  /** Required features for this view — gates navigation + route access via feature availability policy */\n  requiredFeatures: RequiredFeaturesConfigSchema.optional(),\n  /**\n   * Composite-view icon (lucide component reference or StandardIconReference\n   * string) — see {@link CompositeViewDefinition.icon}.\n   *\n   * MUST stay declared here even though the TS interface already carries it:\n   * the resolved frontend config is Zod-parsed at startup\n   * (`AppConfiguration_Frontend_Schema.parse`), and a field missing from this\n   * schema is silently STRIPPED by that parse — authored icons then never reach\n   * the `IconRegistryBridge` and every launcher renders the fallback icon.\n   * (That exact drift shipped once: interface had `icon`, schema didn't.)\n   * Kept permissive like `viewComponent` — authored input, not user input.\n   */\n  icon: z.custom<IconLike>().optional(),\n  /**\n   * See {@link CompositeViewAuthoringConfig.adjacentZoneOnEmpty}.\n   *\n   * Declared here as well as on the interface for the reason spelled out on\n   * `icon` directly above: the resolved frontend config is Zod-parsed at\n   * startup, and a field the schema does not know is silently STRIPPED — the\n   * authored value would never reach `resolveZoneEmptyBehavior` and the zone\n   * default would win with nothing to show for it.\n   */\n  adjacentZoneOnEmpty: z.enum(ZoneEmptyBehavior).optional(),\n  /** See {@link CompositeViewAuthoringConfig.zoneContentFill}. Declared here for the strip reason on `icon`. */\n  zoneContentMaxWidth: z.enum(RESPONSIVE_MAX_WIDTH_VALUES).optional(),\n  zoneContentFillsHeight: z.boolean().optional(),\n});\n\nexport type CompositeView_BaseFields = z.infer<typeof CompositeView_BaseFieldsSchema>;\n\n/** Combine scope discriminated union with base composite view fields */\nexport const CompositeViewDefinitionBaseSchema = z.intersection(\n  FrontendView_DefinitionSchema,\n  CompositeView_BaseFieldsSchema\n);\nexport type CompositeViewDefinitionBase = z.infer<typeof CompositeViewDefinitionBaseSchema>;\n\n/** Top-level composite view contract */\nexport const CompositeViewDefinitionSchema: z.ZodType<CompositeViewDefinition> = CompositeViewDefinitionBaseSchema as z.ZodType<CompositeViewDefinition>;\n"]}
+{"version":3,"file":"composite-view.schemas.js","sourceRoot":"","sources":["../../../../src/core/config/composite-view.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { RESPONSIVE_MAX_WIDTH_VALUES, type ResponsiveMaxWidth } from '@wildo-ai/presets-components-models';\nimport type React from 'react';\nimport { z } from 'zod';\nimport type { IconLike } from '@wildo-ai/zod-decorators';\nimport {\n  CoreResourceOperation,\n  ResourcePrimaryScope,\n  RequiredFeaturesConfigSchema,\n  ZoneEmptyBehavior,\n  type RequiredFeaturesConfig,\n} from '@wildo-ai/saas-models';\nimport {\n  FrontendView_ScopeMode,\n  FrontendView_DefinitionSchema,\n  buildApplicationViewTranslationRef,\n} from './views-frontend.schemas';\nimport {\n  FrontendInsertedViewHostKind,\n  FrontendInsertedViewKind,\n  createFrontendInsertedViewIdentity,\n  parseFrontendInsertedViewRef,\n  type FrontendInsertedViewIdentity,\n} from './inserted-view.frontend.schemas';\nimport {\n  FrontendResource_ParentResourceRequirementSchema,\n  type FrontendResource_ParentResourceRequirement,\n} from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport type { FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\n/**\n * @wildo_source:part:start saas.frontend.composite-view.authoring facet:layer:frontend facet:family:composite-view\n *\n * Resource-owned composite view: props, authoring config, definition, `defineCompositeView()` helper.\n */\nexport interface CompositeViewComponentProps {\n  viewRef: string;\n  viewDefinition: CompositeViewDefinition;\n}\n\n/**\n * Base authoring shape shared by both app-level and resource-level composite\n * views. Fields on this base are valid at **either** scope.\n *\n * Design decision: `operationLike` is intentionally **NOT** on this base,\n * because app-level composites have no resource operation host to be\n * rendered inside of — the field would carry no semantic weight at app\n * scope. Only the resource-scoped subtype\n * {@link ResourceCompositeViewAuthoringConfig} carries `operationLike`.\n */\nexport interface CompositeViewAuthoringConfig {\n  viewComponent: React.ComponentType<CompositeViewComponentProps>;\n  /** Companion-readable section refs used by the view's `<Section name=\"...\">` nodes. */\n  sectionRefs?: string[];\n  /**\n   * Composite-view icon — `StandardIconReference` string or React component\n   * (Lucide / custom). Mirrored from authoring → {@link CompositeViewDefinition.icon},\n   * then surfaced into `CoreIconRegistry.compositeView` by the\n   * `IconRegistryBridge` so navigation launchers (sidebar, command menu,\n   * overlays) render the authored icon.\n   */\n  icon?: IconLike;\n  /**\n   * What happens to an ADJACENT zone (secondary / companion) this destination\n   * splits into, once that zone's last content is dismissed — overriding the\n   * zone's own `onEmpty` while this destination occupies primary.\n   *\n   * The zone-level `ZoneConfig.onEmpty` is one value for every destination that\n   * splits into that zone, and destinations legitimately disagree: a LIST wants\n   * the detail pane to stay put (`EMPTY_STATE`) so the layout does not reflow\n   * while a reviewer steps through rows, while a CANVAS wants its width back\n   * (`COLLAPSE`) the moment nothing is selected. Both share one secondary zone,\n   * so without this override one of them is always wrong.\n   *\n   * Omitted (the common case) defers to the zone, which itself defaults to\n   * `ZoneEmptyBehavior.COLLAPSE`. Resolution order is destination → zone →\n   * COLLAPSE; see `resolveZoneEmptyBehavior`.\n   */\n  adjacentZoneOnEmpty?: ZoneEmptyBehavior;\n  /**\n   * How wide this destination's content may grow in the zone, in the framework's shared width\n   * vocabulary — the SAME `ResponsiveMaxWidth` a Surface, a `DisplayLayout` and a `FormLayout` use.\n   *\n   * Omitted (the common case) is `'content'`: capped and centred at `var(--content-max-width, 80rem)`,\n   * right for a form, a list or a detail page and wrong only for content whose value IS the space it\n   * occupies — a board, a wide table, a canvas — which declare `'none'`.\n   */\n  zoneContentMaxWidth?: ResponsiveMaxWidth;\n  /**\n   * Whether this destination's content fills the zone's HEIGHT as well.\n   *\n   * `true` makes the zone's content boundary a definite-height flex column, so this view's root may use\n   * `flex-1 min-h-0` and resolve against something real. Without it a canvas has no intrinsic height\n   * and collapses to zero — which is why one had to hand-roll `h-[70vh]`, sizing against the WINDOW\n   * rather than the container it sits in. PRIMARY only: an adjacent zone scrolls, so a filling child\n   * and a scrolling parent contradict each other.\n   *\n   * Separate from the width above ON PURPOSE — see `zone-content-geometry.ts` for why the enum that\n   * fused them could not express a capped width with a definite height.\n   */\n  zoneContentFillsHeight?: boolean;\n}\n\n/**\n * Resource-scoped composite view authoring. Extends the base with\n * `operationLike`, which declares the **single** resource operation host\n * this composite is rendered inside of (and therefore the access policy it\n * exhibits). Composite views are always rendered inside exactly one\n * operation host, so `operationLike` is intentionally single-valued — the\n * list analogue is reserved for execution views, which can legitimately\n * surface in several operation hosts.\n *\n * `operationLike` is the **single declarative source of truth** for\n * composite surfacing: at render time, `ResourceLayout_InsertedViews` filters\n * the resource's `compositeViews` directly by the current operation host\n * against `operationLike`. There is no operation-level view-ref list and no\n * compiled derivation — the composite declaration itself carries the link.\n */\nexport interface ResourceCompositeViewAuthoringConfig extends CompositeViewAuthoringConfig {\n  /**\n   * Operation host this composite is rendered inside of, and the sole\n   * declarative link driving where this composite surfaces at runtime.\n   *\n   * Defaults to `CoreResourceOperation.READ` when omitted. This default\n   * MUST match the fallback passed to `collectOperationLikeViewRefs` at the\n   * specification-extraction call site — if it ever diverges, runtime host\n   * rendering (which reads `operationLike` directly) and the compiled\n   * specification output (which mirrors it via the collector) disagree\n   * silently.\n   */\n  operationLike?: CoreResourceOperation;\n}\n\nexport interface CompositeViewDefinition {\n  // Base FrontendView_Definition fields\n  scope: FrontendView_ScopeMode;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];\n  // CompositeView-specific fields\n  ref: string;\n  /** Stable translation identity used for composite-view label lookup/generation. */\n  translationRef: string;\n  isAddressable: boolean;\n  operationLike: CoreResourceOperation;\n  primaryScope: ResourcePrimaryScope;\n  sectionRefs?: string[];\n  viewComponent: React.ComponentType<CompositeViewComponentProps>;\n  /** Required features for this view — gates navigation + route access */\n  requiredFeatures?: RequiredFeaturesConfig;\n  /**\n   * Composite-view icon, propagated verbatim from authoring\n   * ({@link CompositeViewAuthoringConfig.icon}). The `IconRegistryBridge`\n   * walks all composite-view definitions and registers their icons into\n   * `CoreIconRegistry.compositeView`, keyed by `ref`.\n   */\n  icon?: IconLike;\n  /** See {@link CompositeViewAuthoringConfig.adjacentZoneOnEmpty}. Mirrored from authoring. */\n  adjacentZoneOnEmpty?: ZoneEmptyBehavior;\n  /** See {@link CompositeViewAuthoringConfig.zoneContentMaxWidth}. Mirrored from authoring. */\n  zoneContentMaxWidth?: ResponsiveMaxWidth;\n  /** See {@link CompositeViewAuthoringConfig.zoneContentFillsHeight}. Mirrored from authoring. */\n  zoneContentFillsHeight?: boolean;\n}\n\nexport type AppCompositeViewsConfig = Record<string, CompositeViewAuthoringConfig>;\n\nexport type InsertedCompositeDeclaration = CompositeViewDefinition;\n/** @wildo_source:part:end saas.frontend.composite-view.authoring */\n\nexport function buildApplicationCompositeViewTranslationRef(viewRef: string): string {\n  return buildApplicationViewTranslationRef(viewRef);\n}\n\nexport function buildResourceCompositeViewTranslationRef(\n  resourceType: string,\n  viewRef: string,\n): string {\n  return `resources.${resourceType}.${viewRef}`;\n}\n\n/**\n * @wildo_source:part:start saas.frontend.composite-view.define-helper facet:layer:frontend facet:family:composite-view\n *\n * Authoring helper: attach a composite view component with optional\n * `sectionRefs`. This helper targets the **base** authoring shape\n * ({@link CompositeViewAuthoringConfig}) and is suitable for app-level\n * composites. Resource-scoped composites additionally support\n * {@link ResourceCompositeViewAuthoringConfig.operationLike} and are\n * usually authored as plain object literals inside\n * `ResourceCompositeViewsConfig` so authors can declare `operationLike`\n * inline.\n */\nexport function defineCompositeView(\n  viewComponent: React.ComponentType<CompositeViewComponentProps>,\n  config: Omit<CompositeViewAuthoringConfig, 'viewComponent'> = {},\n): CompositeViewAuthoringConfig {\n  return {\n    viewComponent,\n    ...config,\n  };\n}\n/** @wildo_source:part:end saas.frontend.composite-view.define-helper */\n\nexport const COMPOSITE_ROUTE_CONTEXT_QUERY_PARAM_PREFIX = 'composite_ctx_';\n\nexport function isStandaloneRoutableCompositeView(\n  compositeView: CompositeViewDefinition | undefined,\n): boolean {\n  return (\n    compositeView?.isAddressable === true\n    && compositeView.scope === FrontendView_ScopeMode.APPLICATION\n  );\n}\n\nexport function buildApplicationCompositeViewDefinitions(\n  authoredCompositeViews: AppCompositeViewsConfig | undefined,\n): CompositeViewDefinition[] {\n  if (!authoredCompositeViews) {\n    return [];\n  }\n\n  return Object.entries(authoredCompositeViews).map(([ref, authoredView]) => ({\n    ref,\n    translationRef: buildApplicationCompositeViewTranslationRef(ref),\n    scope: FrontendView_ScopeMode.APPLICATION,\n    isAddressable: true,\n    operationLike: CoreResourceOperation.READ,\n    primaryScope: ResourcePrimaryScope.APPLICATION,\n    sectionRefs: authoredView.sectionRefs,\n    viewComponent: authoredView.viewComponent,\n    icon: authoredView.icon,\n    adjacentZoneOnEmpty: authoredView.adjacentZoneOnEmpty,\n    zoneContentMaxWidth: authoredView.zoneContentMaxWidth,\n    zoneContentFillsHeight: authoredView.zoneContentFillsHeight,\n  }));\n}\n\nexport function isStandaloneRoutableInsertedCompositeView(\n  compositeView: CompositeViewDefinition | undefined,\n): boolean {\n  return (\n    compositeView?.isAddressable === true\n    && compositeView.scope === FrontendView_ScopeMode.RESOURCE\n  );\n}\n\nexport function isStandaloneRoutableResolvedCompositeView(\n  compositeView: CompositeViewDefinition | undefined,\n): boolean {\n  if (!compositeView) {\n    return false;\n  }\n\n  return compositeView.scope === FrontendView_ScopeMode.APPLICATION\n    ? isStandaloneRoutableCompositeView(compositeView)\n    : isStandaloneRoutableInsertedCompositeView(compositeView);\n}\n\nexport function buildResourceInsertedCompositeIdentity(\n  resourceType: string,\n  compositeView: Pick<CompositeViewDefinition, 'ref'>,\n): FrontendInsertedViewIdentity {\n  return createFrontendInsertedViewIdentity({\n    hostKind: FrontendInsertedViewHostKind.RESOURCE,\n    hostRef: resourceType,\n    viewKind: FrontendInsertedViewKind.COMPOSITE_VIEW,\n    localRef: compositeView.ref,\n  });\n}\n\nexport function resolveCompositeViewDefinition(params: {\n  viewRef: string | undefined;\n  compositeViews?: CompositeViewDefinition[];\n  registry?: FrontendResourcesRegistry;\n}): CompositeViewDefinition | undefined {\n  const { viewRef, compositeViews, registry } = params;\n  if (!viewRef) {\n    return undefined;\n  }\n\n  const applicationCompositeView = compositeViews?.find((candidate) => candidate.ref === viewRef);\n  if (applicationCompositeView) {\n    return applicationCompositeView;\n  }\n\n  const insertedIdentity = parseFrontendInsertedViewRef(viewRef);\n  if (\n    !insertedIdentity\n    || insertedIdentity.hostKind !== FrontendInsertedViewHostKind.RESOURCE\n    || insertedIdentity.viewKind !== FrontendInsertedViewKind.COMPOSITE_VIEW\n  ) {\n    return undefined;\n  }\n\n  return registry?.resourceConfigurations[insertedIdentity.hostRef]\n    ?.frontendConfiguration\n    ?.compositeViews\n    ?.find((candidate) => candidate.ref === insertedIdentity.localRef);\n}\n\nexport function resolveCompositeViewPrimaryScope(params: {\n  viewRef: string | undefined;\n  compositeViews?: Array<{ ref: string; primaryScope?: ResourcePrimaryScope }>;\n  registry?: FrontendResourcesRegistry;\n}): ResourcePrimaryScope | undefined {\n  const { viewRef, compositeViews, registry } = params;\n  if (!viewRef) {\n    return undefined;\n  }\n\n  const applicationCompositeView = compositeViews?.find((candidate) => candidate.ref === viewRef);\n  if (applicationCompositeView?.primaryScope) {\n    return applicationCompositeView.primaryScope;\n  }\n\n  const insertedIdentity = parseFrontendInsertedViewRef(viewRef);\n  if (\n    !insertedIdentity\n    || insertedIdentity.hostKind !== FrontendInsertedViewHostKind.RESOURCE\n    || insertedIdentity.viewKind !== FrontendInsertedViewKind.COMPOSITE_VIEW\n  ) {\n    return undefined;\n  }\n\n  return registry?.resourceConfigurations[insertedIdentity.hostRef]\n    ?.frontendConfiguration\n    ?.compositeViews\n    ?.find((candidate) => candidate.ref === insertedIdentity.localRef)\n    ?.primaryScope;\n}\n\nexport function buildCompositeRouteUrlPath(\n  viewRef: string,\n  contextResourceIdentifiers?: Record<string, string>,\n): string {\n  const params = new URLSearchParams();\n  for (const [key, value] of Object.entries(contextResourceIdentifiers ?? {})) {\n    if (!value) {\n      continue;\n    }\n    params.set(`${COMPOSITE_ROUTE_CONTEXT_QUERY_PARAM_PREFIX}${key}`, value);\n  }\n\n  const search = params.toString();\n  return search.length > 0 ? `/composite/${viewRef}?${search}` : `/composite/${viewRef}`;\n}\n\nexport function extractCompositeRouteContextResourceIdentifiers(\n  searchParams: URLSearchParams,\n): Record<string, string> | undefined {\n  const contextResourceIdentifiers: Record<string, string> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    if (!key.startsWith(COMPOSITE_ROUTE_CONTEXT_QUERY_PARAM_PREFIX) || !value) {\n      continue;\n    }\n    contextResourceIdentifiers[key.slice(COMPOSITE_ROUTE_CONTEXT_QUERY_PARAM_PREFIX.length)] = value;\n  }\n\n  return Object.keys(contextResourceIdentifiers).length > 0 ? contextResourceIdentifiers : undefined;\n}\n\n/**\n * Base fields for authored top-level composite views.\n *\n * The old GridStack/document-era composite schema has been removed. Composite\n * views are now declared as direct authored React components plus ordinary\n * routed view metadata.\n */\nexport const CompositeView_BaseFieldsSchema = z.object({\n  /** Unique reference for this view */\n  ref: z.string().min(1),\n  /** Stable translation identity used for composite-view label lookup/generation */\n  translationRef: z.string().min(1),\n  /** Whether this view has its own URL route */\n  isAddressable: z.boolean().default(false),\n  /** Operation-like behavior for access control */\n  operationLike: z.enum(CoreResourceOperation).default(CoreResourceOperation.READ),\n  /** Primary scope for this view - determines which context identifiers are injected during navigation */\n  primaryScope: z.enum(ResourcePrimaryScope).default(ResourcePrimaryScope.ORGANIZATIONS),\n  /** Companion-readable section refs used by the view's `<Section name=\"...\">` nodes. */\n  sectionRefs: z.array(z.string()).optional(),\n  /**\n   * Direct authored composite view component.\n   *\n   * Top-level composite views are authored as direct React components.\n   */\n  viewComponent: z.any(),\n  /** Required features for this view — gates navigation + route access via feature availability policy */\n  requiredFeatures: RequiredFeaturesConfigSchema.optional(),\n  /**\n   * Composite-view icon (lucide component reference or StandardIconReference\n   * string) — see {@link CompositeViewDefinition.icon}.\n   *\n   * MUST stay declared here even though the TS interface already carries it:\n   * the resolved frontend config is Zod-parsed at startup\n   * (`AppConfiguration_Frontend_Schema.parse`), and a field missing from this\n   * schema is silently STRIPPED by that parse — authored icons then never reach\n   * the `IconRegistryBridge` and every launcher renders the fallback icon.\n   * (That exact drift shipped once: interface had `icon`, schema didn't.)\n   * Kept permissive like `viewComponent` — authored input, not user input.\n   */\n  icon: z.custom<IconLike>().optional(),\n  /**\n   * See {@link CompositeViewAuthoringConfig.adjacentZoneOnEmpty}.\n   *\n   * Declared here as well as on the interface for the reason spelled out on\n   * `icon` directly above: the resolved frontend config is Zod-parsed at\n   * startup, and a field the schema does not know is silently STRIPPED — the\n   * authored value would never reach `resolveZoneEmptyBehavior` and the zone\n   * default would win with nothing to show for it.\n   */\n  adjacentZoneOnEmpty: z.enum(ZoneEmptyBehavior).optional(),\n  /** See {@link CompositeViewAuthoringConfig.zoneContentFill}. Declared here for the strip reason on `icon`. */\n  zoneContentMaxWidth: z.enum(RESPONSIVE_MAX_WIDTH_VALUES).optional(),\n  zoneContentFillsHeight: z.boolean().optional(),\n});\n\nexport type CompositeView_BaseFields = z.infer<typeof CompositeView_BaseFieldsSchema>;\n\n/** Combine scope discriminated union with base composite view fields */\nexport const CompositeViewDefinitionBaseSchema = z.intersection(\n  FrontendView_DefinitionSchema,\n  CompositeView_BaseFieldsSchema\n);\nexport type CompositeViewDefinitionBase = z.infer<typeof CompositeViewDefinitionBaseSchema>;\n\n/** Top-level composite view contract */\nexport const CompositeViewDefinitionSchema: z.ZodType<CompositeViewDefinition> = CompositeViewDefinitionBaseSchema as z.ZodType<CompositeViewDefinition>;\n"]}

package/dist/esm/core/config/config-merge-utilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-merge-utilities.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/config-merge-utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,cAAc,EACf,MAAM,mCAAmC,CAAC;AAyD3C,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,QAAQ,EAAE,cAAc,GAAG,SAAS,GACnC,cAAc,CAehB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,iBAAiB,EAAE,GAAG,SAAS,EACrC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,SAAS,GACxC,iBAAiB,EAAE,CAMrB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,cAAc,EAAE,GAAG,SAAS,EAClC,QAAQ,EAAE,cAAc,EAAE,GAAG,SAAS,GACrC,cAAc,EAAE,CAMlB;AAyDD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,uBAAuB,EAAE,EAC/B,KAAK,EAAE,uBAAuB,EAAE,GAC/B,uBAAuB,EAAE,CAc3B;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAehE;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,cAAc,EAAE,GAAG,SAAS,EACtC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,EAAE,GACnB,cAAc,EAAE,CAclB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,kBAAkB,EAAE,GAAG,SAAS,EACtC,KAAK,EAAE,kBAAkB,EAAE,GAAG,SAAS,GACtC,kBAAkB,EAAE,CAItB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,mBAAmB,EAAE,GAAG,SAAS,EACvC,KAAK,EAAE,mBAAmB,EAAE,GAAG,SAAS,GACvC,mBAAmB,EAAE,CAQvB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,wBAAwB,EAAE,GAAG,SAAS,EAC5C,KAAK,EAAE,wBAAwB,EAAE,GAAG,SAAS,GAC5C,wBAAwB,EAAE,CAI5B"}
+{"version":3,"file":"config-merge-utilities.d.ts","sourceRoot":"","sources":["../../../../src/core/config/config-merge-utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,cAAc,EACf,MAAM,mCAAmC,CAAC;AAyD3C,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,QAAQ,EAAE,cAAc,GAAG,SAAS,GACnC,cAAc,CAehB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,iBAAiB,EAAE,GAAG,SAAS,EACrC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,SAAS,GACxC,iBAAiB,EAAE,CAMrB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,cAAc,EAAE,GAAG,SAAS,EAClC,QAAQ,EAAE,cAAc,EAAE,GAAG,SAAS,GACrC,cAAc,EAAE,CAMlB;AAyDD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,uBAAuB,EAAE,EAC/B,KAAK,EAAE,uBAAuB,EAAE,GAC/B,uBAAuB,EAAE,CAc3B;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAehE;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,cAAc,EAAE,GAAG,SAAS,EACtC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,EAAE,GACnB,cAAc,EAAE,CAclB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,kBAAkB,EAAE,GAAG,SAAS,EACtC,KAAK,EAAE,kBAAkB,EAAE,GAAG,SAAS,GACtC,kBAAkB,EAAE,CAItB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,mBAAmB,EAAE,GAAG,SAAS,EACvC,KAAK,EAAE,mBAAmB,EAAE,GAAG,SAAS,GACvC,mBAAmB,EAAE,CAQvB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,wBAAwB,EAAE,GAAG,SAAS,EAC5C,KAAK,EAAE,wBAAwB,EAAE,GAAG,SAAS,GAC5C,wBAAwB,EAAE,CAI5B"}