@wildo-ai/saas-frontend-lib 1.1.3 → 1.1.5

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

@@ -1,4 +1,5 @@
 import { type ResponsiveMaxWidth } from '@wildo-ai/presets-components-models';
+import type { DeclaredViewLabel } from './view-label-declaration.schemas';
 import type React from 'react';
 import { z } from 'zod';
 import type { IconLike } from '@wildo-ai/zod-decorators';
@@ -30,6 +31,20 @@ export interface CompositeViewAuthoringConfig {
     viewComponent: React.ComponentType<CompositeViewComponentProps>;
     /** Companion-readable section refs used by the view's `<Section name="...">` nodes. */
     sectionRefs?: string[];
+    /**
+     * View-local i18n label declarations (label refs + interpolation params) for this view's OWN
+     * text — the captions, KPI names and failure sentences its component renders, beyond the
+     * framework's baseline `title` / `description` (and each section's pair).
+     *
+     * The labelling pipeline plans `composite_views.<translationRef>.<labelRef>` from each entry, so
+     * the component resolves its words through the label tree and a translator can find them.
+     * Without a declaration there is no key, and the only remaining option is English written into
+     * the component — which no locale can translate and nobody who owns the wording can change.
+     *
+     * Item shape is `DeclaredViewLabel`; kept permissive like `viewComponent` — authored
+     * configuration, not user input.
+     */
+    labels?: DeclaredViewLabel[];
     /**
      * Composite-view icon — `StandardIconReference` string or React component
      * (Lucide / custom). Mirrored from authoring → {@link CompositeViewDefinition.icon},
@@ -118,6 +133,11 @@ export interface CompositeViewDefinition {
     operationLike: CoreResourceOperation;
     primaryScope: ResourcePrimaryScope;
     sectionRefs?: string[];
+    /**
+     * See {@link CompositeViewAuthoringConfig.labels}. Mirrored from authoring, and declared in the
+     * Zod schema too — the startup config parse strips schema-unknown keys.
+     */
+    labels?: DeclaredViewLabel[];
     viewComponent: React.ComponentType<CompositeViewComponentProps>;
     /** Required features for this view — gates navigation + route access */
     requiredFeatures?: RequiredFeaturesConfig;
@@ -189,6 +209,7 @@ export declare const CompositeView_BaseFieldsSchema: z.ZodObject<{
     operationLike: z.ZodDefault<z.ZodEnum<typeof CoreResourceOperation>>;
     primaryScope: z.ZodDefault<z.ZodEnum<typeof ResourcePrimaryScope>>;
     sectionRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodAny>>;
     viewComponent: z.ZodAny;
     requiredFeatures: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
         features: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -212,8 +233,6 @@ export declare const CompositeView_BaseFieldsSchema: z.ZodObject<{
     icon: z.ZodOptional<z.ZodCustom<IconLike, IconLike>>;
     adjacentZoneOnEmpty: z.ZodOptional<z.ZodEnum<typeof ZoneEmptyBehavior>>;
     zoneContentMaxWidth: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        content: "content";
         full: "full";
         sm: "sm";
         md: "md";
@@ -221,6 +240,8 @@ export declare const CompositeView_BaseFieldsSchema: z.ZodObject<{
         xl: "xl";
         measure: "measure";
         "centered-readable": "centered-readable";
+        content: "content";
+        none: "none";
     }>>;
     zoneContentFillsHeight: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -255,6 +276,7 @@ export declare const CompositeViewDefinitionBaseSchema: z.ZodIntersection<z.ZodD
     operationLike: z.ZodDefault<z.ZodEnum<typeof CoreResourceOperation>>;
     primaryScope: z.ZodDefault<z.ZodEnum<typeof ResourcePrimaryScope>>;
     sectionRefs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodAny>>;
     viewComponent: z.ZodAny;
     requiredFeatures: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
         features: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -278,8 +300,6 @@ export declare const CompositeViewDefinitionBaseSchema: z.ZodIntersection<z.ZodD
     icon: z.ZodOptional<z.ZodCustom<IconLike, IconLike>>;
     adjacentZoneOnEmpty: z.ZodOptional<z.ZodEnum<typeof ZoneEmptyBehavior>>;
     zoneContentMaxWidth: z.ZodOptional<z.ZodEnum<{
-        none: "none";
-        content: "content";
         full: "full";
         sm: "sm";
         md: "md";
@@ -287,6 +307,8 @@ export declare const CompositeViewDefinitionBaseSchema: z.ZodIntersection<z.ZodD
         xl: "xl";
         measure: "measure";
         "centered-readable": "centered-readable";
+        content: "content";
+        none: "none";
     }>>;
     zoneContentFillsHeight: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>>;

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

@@ -46,6 +46,7 @@ export function buildApplicationCompositeViewDefinitions(authoredCompositeViews)
         operationLike: CoreResourceOperation.READ,
         primaryScope: ResourcePrimaryScope.APPLICATION,
         sectionRefs: authoredView.sectionRefs,
+        labels: authoredView.labels,
         viewComponent: authoredView.viewComponent,
         icon: authoredView.icon,
         adjacentZoneOnEmpty: authoredView.adjacentZoneOnEmpty,
@@ -155,6 +156,15 @@ export const CompositeView_BaseFieldsSchema = z.object({
     primaryScope: z.enum(ResourcePrimaryScope).default(ResourcePrimaryScope.ORGANIZATIONS),
     /** Companion-readable section refs used by the view's `<Section name="...">` nodes. */
     sectionRefs: z.array(z.string()).optional(),
+    /**
+     * See {@link CompositeViewAuthoringConfig.labels}.
+     *
+     * MUST stay declared here as well as on the interface, for the reason spelled out on `icon`
+     * below: the resolved frontend config is Zod-parsed at startup and a field the schema does not
+     * know is silently STRIPPED — the authored declaration would never reach the labelling planner,
+     * so no key would be generated and the component would render its raw key for ever.
+     */
+    labels: z.array(z.any()).optional(),
     /**
      * Direct authored composite view component.
      *

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 { DeclaredViewLabel } from './view-label-declaration.schemas';\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   * View-local i18n label declarations (label refs + interpolation params) for this view's OWN\n   * text — the captions, KPI names and failure sentences its component renders, beyond the\n   * framework's baseline `title` / `description` (and each section's pair).\n   *\n   * The labelling pipeline plans `composite_views.<translationRef>.<labelRef>` from each entry, so\n   * the component resolves its words through the label tree and a translator can find them.\n   * Without a declaration there is no key, and the only remaining option is English written into\n   * the component — which no locale can translate and nobody who owns the wording can change.\n   *\n   * Item shape is `DeclaredViewLabel`; kept permissive like `viewComponent` — authored\n   * configuration, not user input.\n   */\n  labels?: DeclaredViewLabel[];\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  /**\n   * See {@link CompositeViewAuthoringConfig.labels}. Mirrored from authoring, and declared in the\n   * Zod schema too — the startup config parse strips schema-unknown keys.\n   */\n  labels?: DeclaredViewLabel[];\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    labels: authoredView.labels,\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   * See {@link CompositeViewAuthoringConfig.labels}.\n   *\n   * MUST stay declared here as well as on the interface, for the reason spelled out on `icon`\n   * below: the resolved frontend config is Zod-parsed at startup and a field the schema does not\n   * know is silently STRIPPED — the authored declaration would never reach the labelling planner,\n   * so no key would be generated and the component would render its raw key for ever.\n   */\n  labels: z.array(z.any()).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"}

package/dist/esm/core/config/config-merge-utilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-merge-utilities.js","sourceRoot":"","sources":["../../../../src/core/config/config-merge-utilities.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Configuration Merge Utilities\n *\n * Explicit merge functions for composing preset + app config. The engine\n * never merges implicitly — these are functions the app calls at config\n * time to produce a single flat configuration.\n *\n * All utilities follow the same semantic: **replace-by-ref on collision,\n * append new.** The `app` argument always wins over the `base` argument\n * on key collisions.\n *\n * @example\n * ```typescript\n * import {\n *   mergeAppScope, mergeAppModes, mergeSidebarSections,\n *   ApplicationLevelComponentType,\n * } from '@wildo-ai/saas-frontend-lib';\n *\n * // Compose a kit preset with app-specific overrides.\n * // Each merge utility produces a flat array/object — pass the result\n * // directly into the AppConfiguration_Frontend config object.\n * const frontendConfig: AppConfiguration_Frontend = {\n *   // ...other config...\n *   appScope: mergeAppScope(kitPreset.appScope, { fields: myAppScopeFields }),\n *   appModes: mergeAppModes(kitPreset.appModes, myAppModes),\n *   appComponentsConfiguration: {\n *     ...kitPreset.appComponentsConfiguration,\n *     [ApplicationLevelComponentType.SIDEBAR]: {\n *       ...kitPreset.appComponentsConfiguration.sidebar,\n *       contentSections: mergeSidebarSections(\n *         kitPreset.sidebarSections,\n *         myAppSections,\n *       ),\n *     },\n *   },\n * };\n * ```\n *\n * @see component-taxonomy-deep-review.md §7.8\n * @see app-shell-implementation-plan.md Step 8\n */\n\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\n\nimport type { QuickSwitcherScopeField } from './app-configuration-frontend.schemas';\nimport type { FullCustomViewDefinition } from './full-custom-view.schemas';\nimport type {\n  AppModeDefinition,\n  CommandMenuCommand,\n  LauncherItemRef,\n  MenubarLauncherItem,\n  SidebarItem,\n  SidebarSection,\n} from './launcher-items.frontend.schemas';\nimport { LauncherItemTargetKind, SidebarSectionContentKind } from './launcher-items.frontend.schemas';\n\n// ════════════════════════════════════════════════════════════════\n// Generic merge-by-key helper\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Merges two arrays by a key field. Items from `override` replace items\n * from `base` on key collision. Items unique to either array are preserved.\n * Order: base items first (with overrides applied in-place), then\n * override-only items appended at the end.\n *\n * **Invariant:** Keys must be unique within each input array. If duplicates\n * exist in `base`, only the first occurrence is kept. If duplicates exist\n * in `override`, only the last occurrence wins (Map semantics).\n */\nfunction mergeByKey<T>(\n  base: T[],\n  override: T[],\n  keyFn: (item: T) => string,\n): T[] {\n  const overrideMap = new Map<string, T>();\n  for (const item of override) {\n    overrideMap.set(keyFn(item), item);\n  }\n\n  const result: T[] = [];\n  const emittedKeys = new Set<string>();\n\n  for (const baseItem of base) {\n    const key = keyFn(baseItem);\n    if (emittedKeys.has(key)) continue;\n    emittedKeys.add(key);\n\n    if (overrideMap.has(key)) {\n      result.push(overrideMap.get(key)!);\n    } else {\n      result.push(baseItem);\n    }\n  }\n\n  for (const overrideItem of override) {\n    const key = keyFn(overrideItem);\n    if (!emittedKeys.has(key)) {\n      emittedKeys.add(key);\n      result.push(overrideItem);\n    }\n  }\n\n  return result;\n}\n\n// ════════════════════════════════════════════════════════════════\n// mergeAppScope\n// ════════════════════════════════════════════════════════════════\n\ninterface AppScopeConfig {\n  fields?: QuickSwitcherScopeField[];\n}\n\n/**\n * Merges two `appScope` configurations.\n *\n * **Merge key:** `fieldIdentifier`\n * **Semantics:** App fields win on collision. Base-only fields preserved.\n *\n * @param base   - Base scope config (e.g., from a kit preset)\n * @param override - App-specific scope config (wins on collision)\n * @returns Merged scope config\n */\nexport function mergeAppScope(\n  base: AppScopeConfig | undefined,\n  override: AppScopeConfig | undefined,\n): AppScopeConfig {\n  if (!base && !override) return {};\n  if (!base) return { ...override };\n  if (!override) return { ...base };\n\n  const baseFields = base.fields ?? [];\n  const overrideFields = override.fields ?? [];\n\n  if (baseFields.length === 0 && overrideFields.length === 0) {\n    return {};\n  }\n\n  return {\n    fields: mergeByKey(baseFields, overrideFields, f => f.fieldIdentifier),\n  };\n}\n\n// ════════════════════════════════════════════════════════════════\n// mergeAppModes\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Merges two `appModes` arrays.\n *\n * **Merge key:** `ref`\n * **Semantics:** App modes win on collision. Base-only modes preserved.\n *\n * @param base   - Base modes array (e.g., from a kit preset)\n * @param override - App-specific modes array (wins on collision)\n * @returns Merged modes array\n */\nexport function mergeAppModes(\n  base: AppModeDefinition[] | undefined,\n  override: AppModeDefinition[] | undefined,\n): AppModeDefinition[] {\n  if (!base && !override) return [];\n  if (!base) return [...(override ?? [])];\n  if (!override) return [...(base ?? [])];\n\n  return mergeByKey(base, override, m => m.ref);\n}\n\n// ════════════════════════════════════════════════════════════════\n// mergeSidebarSections\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Merges two `contentSections` arrays.\n *\n * **Merge key:** `ref`\n * **Semantics:** App sections **replace** base sections on collision\n * (full section replace, no item-level deep merge). Base-only sections\n * preserved.\n *\n * @param base   - Base sections array (e.g., from a kit preset)\n * @param override - App-specific sections array (wins on collision)\n * @returns Merged sections array\n */\nexport function mergeSidebarSections(\n  base: SidebarSection[] | undefined,\n  override: SidebarSection[] | undefined,\n): SidebarSection[] {\n  if (!base && !override) return [];\n  if (!base) return warnOnDuplicateLauncherTargets([...(override ?? [])]);\n  if (!override) return warnOnDuplicateLauncherTargets([...(base ?? [])]);\n\n  return warnOnDuplicateLauncherTargets(mergeByKey(base, override, s => s.ref));\n}\n\n/**\n * DEV-only diagnostic: report launcher items that resolve to the SAME navigation\n * target from more than one place in the merged sidebar (across sections and\n * nesting levels). The merge dedupes by section `ref` only — two sections each\n * carrying a `todoLists LIST` item are structurally valid and the app may WANT\n * that IA, so this warns and never auto-dedupes. It exists because duplicate\n * targets used to double-highlight in the sidebar (frontend-ux-quality-audit E2);\n * the active-state election now picks one, but the duplication itself is usually\n * a merge accident worth surfacing to the app author.\n */\nfunction warnOnDuplicateLauncherTargets(sections: SidebarSection[]): SidebarSection[] {\n  // `mergeSidebarSections` legitimately runs at MODULE SCOPE (apps compose their\n  // module registry at import time, before `ApplicationMainProvider` injects the\n  // env source), where `envLoader.isDevelopment()` THROWS \"No environment source\n  // available\". A diagnostic must never crash the surface it guards: treat \"env\n  // not yet resolvable\" as \"skip the warning\" — the merge itself is env-free.\n  let isDevelopment: boolean;\n  try {\n    isDevelopment = envLoader.isDevelopment();\n  } catch {\n    isDevelopment = false;\n  }\n  if (!isDevelopment) return sections;\n\n  const keyLocations = new Map<string, string[]>();\n  const collect = (items: SidebarItem[] | undefined, sectionRef: string): void => {\n    for (const item of items ?? []) {\n      const key = launcherItemRefKey(item);\n      const locations = keyLocations.get(key) ?? [];\n      locations.push(sectionRef);\n      keyLocations.set(key, locations);\n      collect(item.children, sectionRef);\n    }\n  };\n  for (const section of sections) {\n    if (section.contentKind === SidebarSectionContentKind.NAVIGATION_LIST) {\n      const nav = section as Extract<SidebarSection, { contentKind: SidebarSectionContentKind.NAVIGATION_LIST }>;\n      collect(nav.children, section.ref);\n    }\n  }\n\n  for (const [key, locations] of keyLocations) {\n    if (locations.length > 1) {\n      console.warn(\n        `[mergeSidebarSections] Launcher target \"${key}\" appears ${locations.length} times in the merged sidebar `\n        + `(sections: ${locations.join(', ')}). Only one occurrence will highlight as active. `\n        + `If this duplication is unintentional, remove the extra item from one of the contributing configs.`,\n      );\n    }\n  }\n\n  return sections;\n}\n\n\nexport function mergeQuickSwitcherFields(\n  base: QuickSwitcherScopeField[],\n  extra: QuickSwitcherScopeField[],\n): QuickSwitcherScopeField[] {\n  const seen = new Set<string>();\n  const merged: QuickSwitcherScopeField[] = [];\n\n  for (const field of [...base, ...extra]) {\n    if (seen.has(field.fieldIdentifier)) {\n      continue;\n    }\n\n    seen.add(field.fieldIdentifier);\n    merged.push(field);\n  }\n\n  return merged;\n}\n\n// ════════════════════════════════════════════════════════════════\n// Launcher item keys & command / sidebar append helpers\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Stable key for deduping launcher rows (sidebar children, command list, etc.).\n */\nexport function launcherItemRefKey(item: LauncherItemRef): string {\n  switch (item.kind) {\n    case LauncherItemTargetKind.RESOURCE_OPERATION:\n      return `resource_operation:${item.resourceType}:${item.operation}:${item.operationVariant ?? 'default'}`;\n    case LauncherItemTargetKind.VIEW:\n      return `${item.kind}:${item.viewRef}`;\n    case LauncherItemTargetKind.RESOURCE_VIEW:\n      return `${item.kind}:${item.resourceType}:${item.viewRef}`;\n    case LauncherItemTargetKind.ENGINE_PAGE:\n      return `engine_page:${item.pageRef}`;\n    case LauncherItemTargetKind.CUSTOM_COMPONENT:\n      return `custom_component:${item.componentRef}`;\n    default:\n      return 'unknown';\n  }\n}\n\n/**\n * Appends sidebar navigation children to the `NAVIGATION_LIST` section with `sectionRef`.\n * Skips items whose `launcherItemRefKey` already exists under that section (idempotent).\n */\nexport function appendNavChildrenToSidebarSection(\n  sections: SidebarSection[] | undefined,\n  sectionRef: string,\n  items: SidebarItem[],\n): SidebarSection[] {\n  if (!sections?.length) return sections ?? [];\n  if (!items.length) return [...sections];\n\n  return sections.map(section => {\n    if (section.ref !== sectionRef || section.contentKind !== SidebarSectionContentKind.NAVIGATION_LIST) {\n      return section;\n    }\n    const nav = section as Extract<SidebarSection, { contentKind: SidebarSectionContentKind.NAVIGATION_LIST }>;\n    const existing = new Set(nav.children.map(launcherItemRefKey));\n    const toAdd = items.filter(i => !existing.has(launcherItemRefKey(i)));\n    if (toAdd.length === 0) return section;\n    return { ...nav, children: [...nav.children, ...toAdd] };\n  });\n}\n\n/**\n * Merges command menu command arrays by `launcherItemRefKey` — override wins on collision.\n */\nexport function mergeCommandMenuCommandLists(\n  base: CommandMenuCommand[] | undefined,\n  extra: CommandMenuCommand[] | undefined,\n): CommandMenuCommand[] {\n  if (!base?.length) return [...(extra ?? [])];\n  if (!extra?.length) return [...base];\n  return mergeByKey(base, extra, launcherItemRefKey);\n}\n\n/**\n * Merges menubar launcher rows by launcher identity + menubar group.\n * Override wins on collision.\n */\nexport function mergeMenubarLauncherItems(\n  base: MenubarLauncherItem[] | undefined,\n  extra: MenubarLauncherItem[] | undefined,\n): MenubarLauncherItem[] {\n  if (!base?.length) return [...(extra ?? [])];\n  if (!extra?.length) return [...base];\n  return mergeByKey(\n    base,\n    extra,\n    item => `${launcherItemRefKey(item)}:${item.group ?? 'default'}`,\n  );\n}\n\n/**\n * Merges `fullCustomViews` by `ref` — override wins on collision.\n */\nexport function mergeFullCustomViewsByRef(\n  base: FullCustomViewDefinition[] | undefined,\n  extra: FullCustomViewDefinition[] | undefined,\n): FullCustomViewDefinition[] {\n  if (!base?.length) return [...(extra ?? [])];\n  if (!extra?.length) return [...base];\n  return mergeByKey(base, extra, v => v.ref);\n}\n"]}
+{"version":3,"file":"config-merge-utilities.js","sourceRoot":"","sources":["../../../../../src/core/config/config-merge-utilities.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Configuration Merge Utilities\n *\n * Explicit merge functions for composing preset + app config. The engine\n * never merges implicitly — these are functions the app calls at config\n * time to produce a single flat configuration.\n *\n * All utilities follow the same semantic: **replace-by-ref on collision,\n * append new.** The `app` argument always wins over the `base` argument\n * on key collisions.\n *\n * @example\n * ```typescript\n * import {\n *   mergeAppScope, mergeAppModes, mergeSidebarSections,\n *   ApplicationLevelComponentType,\n * } from '@wildo-ai/saas-frontend-lib';\n *\n * // Compose a kit preset with app-specific overrides.\n * // Each merge utility produces a flat array/object — pass the result\n * // directly into the AppConfiguration_Frontend config object.\n * const frontendConfig: AppConfiguration_Frontend = {\n *   // ...other config...\n *   appScope: mergeAppScope(kitPreset.appScope, { fields: myAppScopeFields }),\n *   appModes: mergeAppModes(kitPreset.appModes, myAppModes),\n *   appComponentsConfiguration: {\n *     ...kitPreset.appComponentsConfiguration,\n *     [ApplicationLevelComponentType.SIDEBAR]: {\n *       ...kitPreset.appComponentsConfiguration.sidebar,\n *       contentSections: mergeSidebarSections(\n *         kitPreset.sidebarSections,\n *         myAppSections,\n *       ),\n *     },\n *   },\n * };\n * ```\n *\n * @see component-taxonomy-deep-review.md §7.8\n * @see app-shell-implementation-plan.md Step 8\n */\n\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\n\nimport type { QuickSwitcherScopeField } from './app-configuration-frontend.schemas';\nimport type { FullCustomViewDefinition } from './full-custom-view.schemas';\nimport type {\n  AppModeDefinition,\n  CommandMenuCommand,\n  LauncherItemRef,\n  MenubarLauncherItem,\n  SidebarItem,\n  SidebarSection,\n} from './launcher-items.frontend.schemas';\nimport { LauncherItemTargetKind, SidebarSectionContentKind } from './launcher-items.frontend.schemas';\n\n// ════════════════════════════════════════════════════════════════\n// Generic merge-by-key helper\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Merges two arrays by a key field. Items from `override` replace items\n * from `base` on key collision. Items unique to either array are preserved.\n * Order: base items first (with overrides applied in-place), then\n * override-only items appended at the end.\n *\n * **Invariant:** Keys must be unique within each input array. If duplicates\n * exist in `base`, only the first occurrence is kept. If duplicates exist\n * in `override`, only the last occurrence wins (Map semantics).\n */\nfunction mergeByKey<T>(\n  base: T[],\n  override: T[],\n  keyFn: (item: T) => string,\n): T[] {\n  const overrideMap = new Map<string, T>();\n  for (const item of override) {\n    overrideMap.set(keyFn(item), item);\n  }\n\n  const result: T[] = [];\n  const emittedKeys = new Set<string>();\n\n  for (const baseItem of base) {\n    const key = keyFn(baseItem);\n    if (emittedKeys.has(key)) continue;\n    emittedKeys.add(key);\n\n    if (overrideMap.has(key)) {\n      result.push(overrideMap.get(key)!);\n    } else {\n      result.push(baseItem);\n    }\n  }\n\n  for (const overrideItem of override) {\n    const key = keyFn(overrideItem);\n    if (!emittedKeys.has(key)) {\n      emittedKeys.add(key);\n      result.push(overrideItem);\n    }\n  }\n\n  return result;\n}\n\n// ════════════════════════════════════════════════════════════════\n// mergeAppScope\n// ════════════════════════════════════════════════════════════════\n\ninterface AppScopeConfig {\n  fields?: QuickSwitcherScopeField[];\n}\n\n/**\n * Merges two `appScope` configurations.\n *\n * **Merge key:** `fieldIdentifier`\n * **Semantics:** App fields win on collision. Base-only fields preserved.\n *\n * @param base   - Base scope config (e.g., from a kit preset)\n * @param override - App-specific scope config (wins on collision)\n * @returns Merged scope config\n */\nexport function mergeAppScope(\n  base: AppScopeConfig | undefined,\n  override: AppScopeConfig | undefined,\n): AppScopeConfig {\n  if (!base && !override) return {};\n  if (!base) return { ...override };\n  if (!override) return { ...base };\n\n  const baseFields = base.fields ?? [];\n  const overrideFields = override.fields ?? [];\n\n  if (baseFields.length === 0 && overrideFields.length === 0) {\n    return {};\n  }\n\n  return {\n    fields: mergeByKey(baseFields, overrideFields, f => f.fieldIdentifier),\n  };\n}\n\n// ════════════════════════════════════════════════════════════════\n// mergeAppModes\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Merges two `appModes` arrays.\n *\n * **Merge key:** `ref`\n * **Semantics:** App modes win on collision. Base-only modes preserved.\n *\n * @param base   - Base modes array (e.g., from a kit preset)\n * @param override - App-specific modes array (wins on collision)\n * @returns Merged modes array\n */\nexport function mergeAppModes(\n  base: AppModeDefinition[] | undefined,\n  override: AppModeDefinition[] | undefined,\n): AppModeDefinition[] {\n  if (!base && !override) return [];\n  if (!base) return [...(override ?? [])];\n  if (!override) return [...(base ?? [])];\n\n  return mergeByKey(base, override, m => m.ref);\n}\n\n// ════════════════════════════════════════════════════════════════\n// mergeSidebarSections\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Merges two `contentSections` arrays.\n *\n * **Merge key:** `ref`\n * **Semantics:** App sections **replace** base sections on collision\n * (full section replace, no item-level deep merge). Base-only sections\n * preserved.\n *\n * @param base   - Base sections array (e.g., from a kit preset)\n * @param override - App-specific sections array (wins on collision)\n * @returns Merged sections array\n */\nexport function mergeSidebarSections(\n  base: SidebarSection[] | undefined,\n  override: SidebarSection[] | undefined,\n): SidebarSection[] {\n  if (!base && !override) return [];\n  if (!base) return warnOnDuplicateLauncherTargets([...(override ?? [])]);\n  if (!override) return warnOnDuplicateLauncherTargets([...(base ?? [])]);\n\n  return warnOnDuplicateLauncherTargets(mergeByKey(base, override, s => s.ref));\n}\n\n/**\n * DEV-only diagnostic: report launcher items that resolve to the SAME navigation\n * target from more than one place in the merged sidebar (across sections and\n * nesting levels). The merge dedupes by section `ref` only — two sections each\n * carrying a `todoLists LIST` item are structurally valid and the app may WANT\n * that IA, so this warns and never auto-dedupes. It exists because duplicate\n * targets used to double-highlight in the sidebar (frontend-ux-quality-audit E2);\n * the active-state election now picks one, but the duplication itself is usually\n * a merge accident worth surfacing to the app author.\n */\nfunction warnOnDuplicateLauncherTargets(sections: SidebarSection[]): SidebarSection[] {\n  // `mergeSidebarSections` legitimately runs at MODULE SCOPE (apps compose their\n  // module registry at import time, before `ApplicationMainProvider` injects the\n  // env source), where `envLoader.isDevelopment()` THROWS \"No environment source\n  // available\". A diagnostic must never crash the surface it guards: treat \"env\n  // not yet resolvable\" as \"skip the warning\" — the merge itself is env-free.\n  let isDevelopment: boolean;\n  try {\n    isDevelopment = envLoader.isDevelopment();\n  } catch {\n    isDevelopment = false;\n  }\n  if (!isDevelopment) return sections;\n\n  const keyLocations = new Map<string, string[]>();\n  const collect = (items: SidebarItem[] | undefined, sectionRef: string): void => {\n    for (const item of items ?? []) {\n      const key = launcherItemRefKey(item);\n      const locations = keyLocations.get(key) ?? [];\n      locations.push(sectionRef);\n      keyLocations.set(key, locations);\n      collect(item.children, sectionRef);\n    }\n  };\n  for (const section of sections) {\n    if (section.contentKind === SidebarSectionContentKind.NAVIGATION_LIST) {\n      const nav = section as Extract<SidebarSection, { contentKind: SidebarSectionContentKind.NAVIGATION_LIST }>;\n      collect(nav.children, section.ref);\n    }\n  }\n\n  for (const [key, locations] of keyLocations) {\n    if (locations.length > 1) {\n      console.warn(\n        `[mergeSidebarSections] Launcher target \"${key}\" appears ${locations.length} times in the merged sidebar `\n        + `(sections: ${locations.join(', ')}). Only one occurrence will highlight as active. `\n        + `If this duplication is unintentional, remove the extra item from one of the contributing configs.`,\n      );\n    }\n  }\n\n  return sections;\n}\n\n\nexport function mergeQuickSwitcherFields(\n  base: QuickSwitcherScopeField[],\n  extra: QuickSwitcherScopeField[],\n): QuickSwitcherScopeField[] {\n  const seen = new Set<string>();\n  const merged: QuickSwitcherScopeField[] = [];\n\n  for (const field of [...base, ...extra]) {\n    if (seen.has(field.fieldIdentifier)) {\n      continue;\n    }\n\n    seen.add(field.fieldIdentifier);\n    merged.push(field);\n  }\n\n  return merged;\n}\n\n// ════════════════════════════════════════════════════════════════\n// Launcher item keys & command / sidebar append helpers\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Stable key for deduping launcher rows (sidebar children, command list, etc.).\n */\nexport function launcherItemRefKey(item: LauncherItemRef): string {\n  switch (item.kind) {\n    case LauncherItemTargetKind.RESOURCE_OPERATION:\n      return `resource_operation:${item.resourceType}:${item.operation}:${item.operationVariant ?? 'default'}`;\n    case LauncherItemTargetKind.VIEW:\n      return `${item.kind}:${item.viewRef}`;\n    case LauncherItemTargetKind.RESOURCE_VIEW:\n      return `${item.kind}:${item.resourceType}:${item.viewRef}`;\n    case LauncherItemTargetKind.ENGINE_PAGE:\n      return `engine_page:${item.pageRef}`;\n    case LauncherItemTargetKind.CUSTOM_COMPONENT:\n      return `custom_component:${item.componentRef}`;\n    default:\n      return 'unknown';\n  }\n}\n\n/**\n * Appends sidebar navigation children to the `NAVIGATION_LIST` section with `sectionRef`.\n * Skips items whose `launcherItemRefKey` already exists under that section (idempotent).\n */\nexport function appendNavChildrenToSidebarSection(\n  sections: SidebarSection[] | undefined,\n  sectionRef: string,\n  items: SidebarItem[],\n): SidebarSection[] {\n  if (!sections?.length) return sections ?? [];\n  if (!items.length) return [...sections];\n\n  return sections.map(section => {\n    if (section.ref !== sectionRef || section.contentKind !== SidebarSectionContentKind.NAVIGATION_LIST) {\n      return section;\n    }\n    const nav = section as Extract<SidebarSection, { contentKind: SidebarSectionContentKind.NAVIGATION_LIST }>;\n    const existing = new Set(nav.children.map(launcherItemRefKey));\n    const toAdd = items.filter(i => !existing.has(launcherItemRefKey(i)));\n    if (toAdd.length === 0) return section;\n    return { ...nav, children: [...nav.children, ...toAdd] };\n  });\n}\n\n/**\n * Merges command menu command arrays by `launcherItemRefKey` — override wins on collision.\n */\nexport function mergeCommandMenuCommandLists(\n  base: CommandMenuCommand[] | undefined,\n  extra: CommandMenuCommand[] | undefined,\n): CommandMenuCommand[] {\n  if (!base?.length) return [...(extra ?? [])];\n  if (!extra?.length) return [...base];\n  return mergeByKey(base, extra, launcherItemRefKey);\n}\n\n/**\n * Merges menubar launcher rows by launcher identity + menubar group.\n * Override wins on collision.\n */\nexport function mergeMenubarLauncherItems(\n  base: MenubarLauncherItem[] | undefined,\n  extra: MenubarLauncherItem[] | undefined,\n): MenubarLauncherItem[] {\n  if (!base?.length) return [...(extra ?? [])];\n  if (!extra?.length) return [...base];\n  return mergeByKey(\n    base,\n    extra,\n    item => `${launcherItemRefKey(item)}:${item.group ?? 'default'}`,\n  );\n}\n\n/**\n * Merges `fullCustomViews` by `ref` — override wins on collision.\n */\nexport function mergeFullCustomViewsByRef(\n  base: FullCustomViewDefinition[] | undefined,\n  extra: FullCustomViewDefinition[] | undefined,\n): FullCustomViewDefinition[] {\n  if (!base?.length) return [...(extra ?? [])];\n  if (!extra?.length) return [...base];\n  return mergeByKey(base, extra, v => v.ref);\n}\n"]}

package/dist/esm/core/config/engine-settings-destinations.d.ts

@@ -1,71 +1,4 @@
 import type { SettingsDestination, SettingsHubConfig } from './settings-hub.frontend.schemas';
-/** @wildo_source:part:start saas.frontend.settings-hub.engine-destinations facet:layer:frontend facet:family:config facet:audience:app-developer */
-/**
- * Every settings destination the engine ships, as a named vocabulary.
- *
- * Exists because these refs are a CLOSED vocabulary that engine code addresses
- * by name — the billing command-menu entry opens `/settings/billing`, and any
- * future engine launcher will do the same. Before this enum, `'billing'` was a
- * bare literal in `billing-launcher.ts` with nothing tying it to the catalog
- * entry it names: rename the destination and the command silently resolves to
- * the hub's DEFAULT section instead of failing, so a menu item labelled
- * "Billing" would open Profile.
- *
- * **Engine code must address a destination through this enum. Application
- * config addresses one by string**, deliberately: a placement is authored data,
- * an application should not import an engine enum to write its own rail, and a
- * typo there is caught at DEV startup by `verifySettingsHubContent`.
- */
-export declare enum EngineSettingsDestinationRef {
-    /** The signed-in user's own profile record. */
-    PROFILE = "profile",
-    /** Password, MFA, sessions — a bespoke engine panel. */
-    SECURITY = "security",
-    /** Theme and appearance preferences — a bespoke engine panel. */
-    APPEARANCE = "appearance",
-    /** The signed-in user's own preference record. */
-    PREFERENCES = "preferences",
-    /** Invitations addressed TO the signed-in user, across organizations they have not joined. */
-    MY_INVITATIONS = "my-invitations",
-    /** The current organization's own record. Org owner/admin only. */
-    ORGANIZATION_GENERAL = "organization-general",
-    /** Organization membership list, including INVITED rows. Org owner/admin only. */
-    MEMBERS = "members",
-    /** Billing home — subscription, plans, usage, invoices. Gated on the `billingEnabled` capability. */
-    BILLING = "billing",
-    /** Organization API keys. Org owner/admin only. */
-    API_KEYS = "api-keys",
-    /**
-     * The tenant's OWN credentials toward third parties — its Slack workspace token, its CRM key.
-     *
-     * The mirror image of {@link API_KEYS} and easy to confuse with it: an API key is a credential
-     * somebody uses to reach THIS application, and one of these is a credential this application uses
-     * to reach somebody else ON THIS TENANT'S BEHALF. Same administrator, opposite direction.
-     */
-    PROVIDER_CREDENTIALS = "provider-credentials",
-    /**
-     * The signed-in person's OWN credentials toward third parties — their personal API key, the
-     * account they connected themselves.
-     *
-     * Distinct from {@link PROVIDER_CREDENTIALS} by OWNER, not by feature, and the two must never be
-     * merged into one screen. A tenant's credential is a shared integration an administrator
-     * configures for everyone; this one is an individual's own account, which nobody else may see,
-     * spend or remove. Putting them on one page would put a colleague's personal vendor token in an
-     * administrator's view — and the resource's authorization refuses that, so the screen would show
-     * an empty list nobody could explain.
-     */
-    MY_PROVIDER_CREDENTIALS = "my-provider-credentials",
-    /** Single sign-on configuration and connections. */
-    SSO = "sso",
-    /** SCIM directory provisioning configuration and tokens. */
-    SCIM = "scim",
-    /** Audit-event streaming configuration and failed-delivery queue. */
-    SIEM = "siem",
-    /** Outbound webhook endpoints and delivery log. */
-    WEBHOOKS = "webhooks",
-    /** The organization's audit log. Org owner/admin only. */
-    AUDIT_LOGS = "audit-logs"
-}
 /**
  * Every settings destination the engine ships, keyed by `ref`.
  *
@@ -75,8 +8,6 @@ export declare enum EngineSettingsDestinationRef {
  * meant to remove.
  */
 export declare const ENGINE_SETTINGS_DESTINATIONS: readonly SettingsDestination[];
-/** Every destination ref the engine ships — the set a placement is validated against. */
-export declare const ENGINE_SETTINGS_DESTINATION_REFS: ReadonlySet<string>;
 /**
  * The full placement set `wildo init` scaffolds into a new application's config.
  *

package/dist/esm/core/config/engine-settings-destinations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-settings-destinations.d.ts","sourceRoot":"","sources":["../../../../src/core/config/engine-settings-destinations.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAE9F,oJAAoJ;AACpJ;;;;;;;;;;;;;;;GAeG;AACH,oBAAY,4BAA4B;IACtC,+CAA+C;IAC/C,OAAO,YAAY;IACnB,wDAAwD;IACxD,QAAQ,aAAa;IACrB,iEAAiE;IACjE,UAAU,eAAe;IACzB,kDAAkD;IAClD,WAAW,gBAAgB;IAC3B,8FAA8F;IAC9F,cAAc,mBAAmB;IACjC,mEAAmE;IACnE,oBAAoB,yBAAyB;IAC7C,kFAAkF;IAClF,OAAO,YAAY;IACnB,qGAAqG;IACrG,OAAO,YAAY;IACnB,mDAAmD;IACnD,QAAQ,aAAa;IACrB;;;;;;OAMG;IACH,oBAAoB,yBAAyB;IAC7C;;;;;;;;;;OAUG;IACH,uBAAuB,4BAA4B;IACnD,oDAAoD;IACpD,GAAG,QAAQ;IACX,4DAA4D;IAC5D,IAAI,SAAS;IACb,qEAAqE;IACrE,IAAI,SAAS;IACb,mDAAmD;IACnD,QAAQ,aAAa;IACrB,0DAA0D;IAC1D,UAAU,eAAe;CAC1B;AA4BD;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,mBAAmB,EA6QtE,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,gCAAgC,EAAE,WAAW,CAAC,MAAM,CAEhE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,4BAA4B,EAAE,iBA0B1C,CAAC"}
+{"version":3,"file":"engine-settings-destinations.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/engine-settings-destinations.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AA0D9F;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,mBAAmB,EAklBtE,CAAC;AAGF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,4BAA4B,EAAE,iBAqE1C,CAAC"}