@wildo-ai/saas-frontend-lib 1.1.9 → 1.1.11

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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAYpF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2DAA2D,CAAC;AAEpG,OAAO,EAAE,gDAAgD,EAAE,MAAM,mEAAmE,CAAC;AAErI,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,EAClC,kCAAkC,EAClC,4BAA4B,EAC5B,wBAAwB,EACxB,4BAA4B,GAG7B,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD;;;;;;;OAOG;IACH,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,QAAQ,CAAC;IACjD,2BAA2B,EAAE,gDAAgD,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IAChG,8BAA8B,EAAE,gDAAgD,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IAEnG,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,eAAe,EAAE,qBAAqB;IACtC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAEzC;;;;;;;;;;OAUG;IACH,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC;IAChF,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,aAAa,CAAC;IACtF,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC,QAAQ,EAAE;CAClE,CAAC,CAAC;AAaH,2EAA2E;AAE3E,MAAM,UAAU,qCAAqC,CACnD,SAA+C;IAE/C,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5D,QAAQ,EAAE,kCAAkC;IAC5C,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,eAAe,EAAE,qBAAqB;IACtC,0BAA0B,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5D,cAAc,EAAE,sBAAsB,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAeH,MAAM,CAAC,MAAM,sCAAsC,GAAG,YAAY,CAAC;AACnE,iHAAiH;AACjH,MAAM,CAAC,MAAM,uBAAuB,GAAG,SAAS,CAAC;AAEjD,MAAM,UAAU,kCAAkC,CAChD,YAAoB,EACpB,SAAgD;IAEhD,OAAO,kCAAkC,CAAC;QACxC,QAAQ,EAAE,4BAA4B,CAAC,QAAQ;QAC/C,OAAO,EAAE,YAAY;QACrB,QAAQ,EAAE,wBAAwB,CAAC,UAAU;QAC7C,QAAQ,EAAE,SAAS,CAAC,GAAG;KACxB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oCAAoC,CAAC,MAKpD;IACC,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,iBAAiB,EAAE,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,GAAG;QACvD,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,eAAe;QACjD,0BAA0B,EAAE,MAAM,CAAC,0BAA0B;QAC7D,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAGxC;IACC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IACrC,MAAM,gBAAgB,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IAC/D,IACE,CAAC,gBAAgB;WACd,gBAAgB,CAAC,QAAQ,KAAK,4BAA4B,CAAC,QAAQ;WACnE,gBAAgB,CAAC,QAAQ,KAAK,wBAAwB,CAAC,UAAU,EACpE,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,OAAO,CAAC;QAC1E,EAAE,qBAAqB;QACvB,EAAE,UAAU;QACZ,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,KAAK,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACrE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,gBAAgB;QAC1B,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oCAAoC,CAClD,QAAmC;IAEnC,MAAM,IAAI,GAAmC,EAAE,CAAC;IAChD,MAAM,cAAc,GAAG,QAAQ,CAAC,sBAAsB,IAAI,EAAE,CAAC;IAC7D,KAAK,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAC3E,yBAAyB,CAAC,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,UAAU,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kDAAkD,CAChE,UAA8B;IAE9B,MAAM,IAAI,GAAmC,EAAE,CAAC;IAChD,KAAK,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;QAC7E,yBAAyB,CAAC,IAAI,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sGAAsG;AACtG,SAAS,yBAAyB,CAChC,GAAmC,EACnC,YAAoB,EACpB,UAAkD;IAElD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;IACT,CAAC;IACD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,GAAG,CAAC,IAAI,CAAC;YACP,kBAAkB,EAAE,SAAS,CAAC,eAAe,CAAC,GAAG;YACjD,YAAY;YACZ,YAAY,EAAE,SAAS,CAAC,GAAG;SAC5B,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,0BAAmD,EACnD,cAAuC;IAEvC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,0BAA0B,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,sCAAsC,GAAG,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC,sCAAsC,CAAC,EAAE,CAAC;YACrE,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IACjC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,uBAAuB,GAAG,OAAO,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,uBAAuB,GAAG,OAAO,EAAE,CAAC;AACvH,CAAC;AAED,MAAM,UAAU,2CAA2C,CACzD,YAA6B;IAE7B,MAAM,0BAA0B,GAA2B,EAAE,CAAC;IAE9D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;QAClD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,sCAAsC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACtE,SAAS;QACX,CAAC;QACD,0BAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,sCAAsC,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC;IAC/F,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,SAAS,CAAC;AACrG,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,YAA6B;IAE7B,MAAM,cAAc,GAA2B,EAAE,CAAC;IAElD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;QAClD,yFAAyF;QACzF,0CAA0C;QAC1C,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC,sCAAsC,CAAC,IAAI,GAAG,KAAK,uBAAuB,EAAE,CAAC;YACxG,SAAS;QACX,CAAC;QAED,cAAc,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC","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 type { IconLike } from '@wildo-ai/zod-decorators';\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  /**\n   * Chart icon — lucide component reference (not `<JSX />`) or a StandardIconReference string.\n   * Surfaces on every launcher that targets this chart (a `RESOURCE_VIEW` sidebar or command-menu\n   * entry); without it that launcher renders the icon registry's alert-circle placeholder, which\n   * reads as a warning (#2281). Optional because a chart is first inline CONTENT of its operation\n   * host and is often never launched at all. Registered by the `IconRegistryBridge` under the\n   * `view-chart-{ref}` custom-icon key, the key `resolveConcreteResourceViewTarget` asks for.\n   * Declared in BOTH the schema and the interface — this object is Zod-parsed and strips unknown keys.\n   */\n  icon: z.custom<IconLike>().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  /** Chart icon (lucide component reference or StandardIconReference string) for launcher surfaces. */\n  icon?: IconLike;\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

@@ -235,11 +235,11 @@ export declare const CompositeView_BaseFieldsSchema: z.ZodObject<{
     zoneContentMaxWidth: z.ZodOptional<z.ZodEnum<{
         none: "none";
         content: "content";
-        full: "full";
         sm: "sm";
         md: "md";
         lg: "lg";
         xl: "xl";
+        full: "full";
         measure: "measure";
         "centered-readable": "centered-readable";
     }>>;
@@ -302,11 +302,11 @@ export declare const CompositeViewDefinitionBaseSchema: z.ZodIntersection<z.ZodD
     zoneContentMaxWidth: z.ZodOptional<z.ZodEnum<{
         none: "none";
         content: "content";
-        full: "full";
         sm: "sm";
         md: "md";
         lg: "lg";
         xl: "xl";
+        full: "full";
         measure: "measure";
         "centered-readable": "centered-readable";
     }>>;

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

@@ -35,9 +35,6 @@
  *   },
  * };
  * ```
- *
- * @see component-taxonomy-deep-review.md §7.8
- * @see app-shell-implementation-plan.md Step 8
  */
 import type { QuickSwitcherScopeField } from './app-configuration-frontend.schemas';
 import type { FullCustomViewDefinition } from './full-custom-view.schemas';
@@ -68,6 +65,8 @@ export declare function mergeAppScope(base: AppScopeConfig | undefined, override
  */
 export declare function mergeAppModes(base: AppModeDefinition[] | undefined, override: AppModeDefinition[] | undefined): AppModeDefinition[];
 /**
+ * @wildo_source:part:start saas.frontend.launcher.merge-rules facet:layer:frontend facet:family:app-shell facet:audience:app-developer
+ *
  * Merges two `contentSections` arrays.
  *
  * **Merge key:** `ref`
@@ -80,9 +79,37 @@ export declare function mergeAppModes(base: AppModeDefinition[] | undefined, ove
  * @returns Merged sections array
  */
 export declare function mergeSidebarSections(base: SidebarSection[] | undefined, override: SidebarSection[] | undefined): SidebarSection[];
+/** @wildo_source:part:end saas.frontend.launcher.merge-rules */
+/**
+ * Combines the sidebar sections of PEER frontend modules — the fold that assembles an application's module registry.
+ *
+ * Modules are peers: none is a base the next one overrides. Every module scaffolded by `wildo init` and `add-module`
+ * declares the primary `main` navigation section and `add-resource` appends its launcher items to that section's
+ * children, so the same section is declared by every module, each with its own entries. Folding them with
+ * {@link mergeSidebarSections} (whole-section replace) kept only the LAST module's entries, in module order: measured
+ * 2026-10-05 in Wonder Procurement (a member's sidebar came out empty), Wonder CRM and Wonder Ledger.
+ *
+ * - A NAVIGATION section declared by several modules keeps the FIRST declaration's properties and gathers every
+ *   module's children in module order, through {@link appendNavChildrenToSidebarSection} (an item already present by
+ *   its launcher target is not added twice).
+ * - A section of any other kind holds ONE content (a resource browser, a widget, a component), which two
+ *   declarations cannot share: the later one stands, as {@link mergeSidebarSections} decides.
+ *
+ * An application's own shell configuration still overrides the combined result through {@link mergeSidebarSections}:
+ * that is a base and an override, and replacing is what an override means.
+ */
+export declare function combineModuleSidebarSections(sections: SidebarSection[], moduleSections: SidebarSection[] | undefined): SidebarSection[];
 export declare function mergeQuickSwitcherFields(base: QuickSwitcherScopeField[], extra: QuickSwitcherScopeField[]): QuickSwitcherScopeField[];
+/** @wildo_source:part:start saas.frontend.launcher.merge-rules facet:layer:frontend facet:family:app-shell facet:audience:app-developer */
 /**
  * Stable key for deduping launcher rows (sidebar children, command list, etc.).
+ *
+ * Two entries with the same key open the same target, so they are one entry. Every `kind` has its own key, and a
+ * settings command keys on its `sectionRef`, so commands opening different settings sections never collapse.
+ *
+ * Exhaustive over `LauncherItemTargetKind` on purpose. It used to end in a `default` that answered `'unknown'`, and
+ * `SETTINGS_SECTION` fell into it: every settings command then shared one key, so an application's `members` command
+ * collapsed into the engine's billing command and disappeared. A kind added to the enum is now a compile error here.
  */
 export declare function launcherItemRefKey(item: LauncherItemRef): string;
 /**
@@ -94,6 +121,7 @@ export declare function appendNavChildrenToSidebarSection(sections: SidebarSecti
  * Merges command menu command arrays by `launcherItemRefKey` — override wins on collision.
  */
 export declare function mergeCommandMenuCommandLists(base: CommandMenuCommand[] | undefined, extra: CommandMenuCommand[] | undefined): CommandMenuCommand[];
+/** @wildo_source:part:end saas.frontend.launcher.merge-rules */
 /**
  * Merges menubar launcher rows by launcher identity + menubar group.
  * Override wins on collision.

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;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;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,cAAc,EAAE,GAAG,SAAS,EAClC,QAAQ,EAAE,cAAc,EAAE,GAAG,SAAS,GACrC,cAAc,EAAE,CAMlB;AACD,gEAAgE;AAEhE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,cAAc,EAAE,EAC1B,cAAc,EAAE,cAAc,EAAE,GAAG,SAAS,GAC3C,cAAc,EAAE,CAiBlB;AAyDD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,uBAAuB,EAAE,EAC/B,KAAK,EAAE,uBAAuB,EAAE,GAC/B,uBAAuB,EAAE,CAc3B;AAMD,2IAA2I;AAC3I;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAuBhE;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;AACD,gEAAgE;AAEhE;;;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

@@ -35,9 +35,6 @@
  *   },
  * };
  * ```
- *
- * @see component-taxonomy-deep-review.md §7.8
- * @see app-shell-implementation-plan.md Step 8
  */
 import { envLoader } from '../../core/runtime/env-variable-loader.frontend.service.js';
 import { LauncherItemTargetKind, SidebarSectionContentKind } from './launcher-items.frontend.schemas.js';
@@ -134,6 +131,8 @@ export function mergeAppModes(base, override) {
 // mergeSidebarSections
 // ════════════════════════════════════════════════════════════════
 /**
+ * @wildo_source:part:start saas.frontend.launcher.merge-rules facet:layer:frontend facet:family:app-shell facet:audience:app-developer
+ *
  * Merges two `contentSections` arrays.
  *
  * **Merge key:** `ref`
@@ -154,6 +153,44 @@ export function mergeSidebarSections(base, override) {
         return warnOnDuplicateLauncherTargets([...(base ?? [])]);
     return warnOnDuplicateLauncherTargets(mergeByKey(base, override, s => s.ref));
 }
+/** @wildo_source:part:end saas.frontend.launcher.merge-rules */
+/**
+ * Combines the sidebar sections of PEER frontend modules — the fold that assembles an application's module registry.
+ *
+ * Modules are peers: none is a base the next one overrides. Every module scaffolded by `wildo init` and `add-module`
+ * declares the primary `main` navigation section and `add-resource` appends its launcher items to that section's
+ * children, so the same section is declared by every module, each with its own entries. Folding them with
+ * {@link mergeSidebarSections} (whole-section replace) kept only the LAST module's entries, in module order: measured
+ * 2026-10-05 in Wonder Procurement (a member's sidebar came out empty), Wonder CRM and Wonder Ledger.
+ *
+ * - A NAVIGATION section declared by several modules keeps the FIRST declaration's properties and gathers every
+ *   module's children in module order, through {@link appendNavChildrenToSidebarSection} (an item already present by
+ *   its launcher target is not added twice).
+ * - A section of any other kind holds ONE content (a resource browser, a widget, a component), which two
+ *   declarations cannot share: the later one stands, as {@link mergeSidebarSections} decides.
+ *
+ * An application's own shell configuration still overrides the combined result through {@link mergeSidebarSections}:
+ * that is a base and an override, and replacing is what an override means.
+ */
+export function combineModuleSidebarSections(sections, moduleSections) {
+    if (!moduleSections?.length)
+        return sections;
+    let combined = [...sections];
+    for (const section of moduleSections) {
+        const index = combined.findIndex((existing) => existing.ref === section.ref);
+        if (index === -1) {
+            combined.push(section);
+        }
+        else if (combined[index].contentKind === SidebarSectionContentKind.NAVIGATION_LIST
+            && section.contentKind === SidebarSectionContentKind.NAVIGATION_LIST) {
+            combined = appendNavChildrenToSidebarSection(combined, section.ref, section.children);
+        }
+        else {
+            combined[index] = section;
+        }
+    }
+    return warnOnDuplicateLauncherTargets(combined);
+}
 /**
  * DEV-only diagnostic: report launcher items that resolve to the SAME navigation
  * target from more than one place in the merged sidebar (across sections and
@@ -165,7 +202,7 @@ export function mergeSidebarSections(base, override) {
  * a merge accident worth surfacing to the app author.
  */
 function warnOnDuplicateLauncherTargets(sections) {
-    // `mergeSidebarSections` legitimately runs at MODULE SCOPE (apps compose their
+    // `mergeSidebarSections` and `combineModuleSidebarSections` legitimately run at MODULE SCOPE (apps compose their
     // module registry at import time, before `ApplicationMainProvider` injects the
     // env source), where `envLoader.isDevelopment()` THROWS "No environment source
     // available". A diagnostic must never crash the surface it guards: treat "env
@@ -197,7 +234,7 @@ function warnOnDuplicateLauncherTargets(sections) {
     }
     for (const [key, locations] of keyLocations) {
         if (locations.length > 1) {
-            console.warn(`[mergeSidebarSections] Launcher target "${key}" appears ${locations.length} times in the merged sidebar `
+            console.warn(`[sidebar sections] Launcher target "${key}" appears ${locations.length} times in the merged sidebar `
                 + `(sections: ${locations.join(', ')}). Only one occurrence will highlight as active. `
                 + `If this duplication is unintentional, remove the extra item from one of the contributing configs.`);
         }
@@ -219,8 +256,16 @@ export function mergeQuickSwitcherFields(base, extra) {
 // ════════════════════════════════════════════════════════════════
 // Launcher item keys & command / sidebar append helpers
 // ════════════════════════════════════════════════════════════════
+/** @wildo_source:part:start saas.frontend.launcher.merge-rules facet:layer:frontend facet:family:app-shell facet:audience:app-developer */
 /**
  * Stable key for deduping launcher rows (sidebar children, command list, etc.).
+ *
+ * Two entries with the same key open the same target, so they are one entry. Every `kind` has its own key, and a
+ * settings command keys on its `sectionRef`, so commands opening different settings sections never collapse.
+ *
+ * Exhaustive over `LauncherItemTargetKind` on purpose. It used to end in a `default` that answered `'unknown'`, and
+ * `SETTINGS_SECTION` fell into it: every settings command then shared one key, so an application's `members` command
+ * collapsed into the engine's billing command and disappeared. A kind added to the enum is now a compile error here.
  */
 export function launcherItemRefKey(item) {
     switch (item.kind) {
@@ -234,8 +279,16 @@ export function launcherItemRefKey(item) {
             return `engine_page:${item.pageRef}`;
         case LauncherItemTargetKind.CUSTOM_COMPONENT:
             return `custom_component:${item.componentRef}`;
-        default:
-            return 'unknown';
+        // Keyed by the section it opens. The hub's own entry names no section: that is one destination, so it is one
+        // key, `settings_section:default`.
+        case LauncherItemTargetKind.SETTINGS_SECTION:
+            return `settings_section:${item.sectionRef ?? 'default'}`;
+        default: {
+            // Total over the kinds (see the JSDoc above): a kind added to `LauncherItemRef` without a key here is a
+            // compile error.
+            const unkeyed = item;
+            throw new Error(`launcherItemRefKey: no key for launcher item kind ${unkeyed.kind}`);
+        }
     }
 }
 /**
@@ -269,6 +322,7 @@ export function mergeCommandMenuCommandLists(base, extra) {
         return [...base];
     return mergeByKey(base, extra, launcherItemRefKey);
 }
+/** @wildo_source:part:end saas.frontend.launcher.merge-rules */
 /**
  * Merges menubar launcher rows by launcher identity + menubar group.
  * Override wins on collision.

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\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 * @wildo_source:part:start saas.frontend.launcher.merge-rules facet:layer:frontend facet:family:app-shell facet:audience:app-developer\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/** @wildo_source:part:end saas.frontend.launcher.merge-rules */\n\n/**\n * Combines the sidebar sections of PEER frontend modules — the fold that assembles an application's module registry.\n *\n * Modules are peers: none is a base the next one overrides. Every module scaffolded by `wildo init` and `add-module`\n * declares the primary `main` navigation section and `add-resource` appends its launcher items to that section's\n * children, so the same section is declared by every module, each with its own entries. Folding them with\n * {@link mergeSidebarSections} (whole-section replace) kept only the LAST module's entries, in module order: measured\n * 2026-10-05 in Wonder Procurement (a member's sidebar came out empty), Wonder CRM and Wonder Ledger.\n *\n * - A NAVIGATION section declared by several modules keeps the FIRST declaration's properties and gathers every\n *   module's children in module order, through {@link appendNavChildrenToSidebarSection} (an item already present by\n *   its launcher target is not added twice).\n * - A section of any other kind holds ONE content (a resource browser, a widget, a component), which two\n *   declarations cannot share: the later one stands, as {@link mergeSidebarSections} decides.\n *\n * An application's own shell configuration still overrides the combined result through {@link mergeSidebarSections}:\n * that is a base and an override, and replacing is what an override means.\n */\nexport function combineModuleSidebarSections(\n  sections: SidebarSection[],\n  moduleSections: SidebarSection[] | undefined,\n): SidebarSection[] {\n  if (!moduleSections?.length) return sections;\n  let combined = [...sections];\n  for (const section of moduleSections) {\n    const index = combined.findIndex((existing) => existing.ref === section.ref);\n    if (index === -1) {\n      combined.push(section);\n    } else if (\n      combined[index]!.contentKind === SidebarSectionContentKind.NAVIGATION_LIST\n      && section.contentKind === SidebarSectionContentKind.NAVIGATION_LIST\n    ) {\n      combined = appendNavChildrenToSidebarSection(combined, section.ref, section.children);\n    } else {\n      combined[index] = section;\n    }\n  }\n  return warnOnDuplicateLauncherTargets(combined);\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` and `combineModuleSidebarSections` legitimately run 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        `[sidebar sections] 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/** @wildo_source:part:start saas.frontend.launcher.merge-rules facet:layer:frontend facet:family:app-shell facet:audience:app-developer */\n/**\n * Stable key for deduping launcher rows (sidebar children, command list, etc.).\n *\n * Two entries with the same key open the same target, so they are one entry. Every `kind` has its own key, and a\n * settings command keys on its `sectionRef`, so commands opening different settings sections never collapse.\n *\n * Exhaustive over `LauncherItemTargetKind` on purpose. It used to end in a `default` that answered `'unknown'`, and\n * `SETTINGS_SECTION` fell into it: every settings command then shared one key, so an application's `members` command\n * collapsed into the engine's billing command and disappeared. A kind added to the enum is now a compile error here.\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    // Keyed by the section it opens. The hub's own entry names no section: that is one destination, so it is one\n    // key, `settings_section:default`.\n    case LauncherItemTargetKind.SETTINGS_SECTION:\n      return `settings_section:${item.sectionRef ?? 'default'}`;\n    default: {\n      // Total over the kinds (see the JSDoc above): a kind added to `LauncherItemRef` without a key here is a\n      // compile error.\n      const unkeyed: never = item;\n      throw new Error(`launcherItemRefKey: no key for launcher item kind ${(unkeyed as { kind: string }).kind}`);\n    }\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/** @wildo_source:part:end saas.frontend.launcher.merge-rules */\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/decision-inbox-capability.frontend.utils.d.ts

@@ -0,0 +1,83 @@
+/**
+ * The runtime capability that decides who is offered the engine's Decisions row (#2527, #2577).
+ *
+ * ## Why the row does not use `requiredRoles`
+ *
+ * `runtimeAvailability.requiredRoles` is evaluated against the viewer's application roles and their ORGANIZATION-WIDE
+ * roles in the CURRENT organization (`viewerHoldsOneOfRoles`). That is right for every other role-gated launcher entry,
+ * because each of them opens something acting in the current organization: a settings section, a view, an operation.
+ *
+ * The decision inbox is not about the current organization. The server lists a person's decisions from every
+ * organization, whatever the current one (`listPendingDecisions`, and each `HumanDecisionHost.listCards`): the
+ * decisions assigned to them, the OWNER decisions they raised, and the ROLE decisions of each organization they hold a
+ * role entry in, an organization reached through a live relationship included (#2792: read through the same role build
+ * as the access profile, `organizationIdsWithRoleEntries`). It then admits each one through the decision organization's
+ * role facts, re-read now (`resolveHumanDecisionRoleFacts`): the eligible role held organization-wide, OR in an
+ * organization unit that contains the decision's unit, OR through an organization relationship (an assigned decision
+ * is admitted that way: the reassignment candidates are the organization's active members, representatives included).
+ * Gated on `requiredRoles`, the row was hidden from two people the server answers decisions for:
+ * - a unit-only reviewer (a finance approver of one unit), who holds no organization-wide role;
+ * - a firm's expert whose current organization is the firm, while the decision waits in a client organization where
+ *   the expert stands through the service relationship.
+ *
+ * Both are LISTED what they may answer, not only offered the row (#2792): the listing used to select ROLE decisions from
+ * the organizations of the request's own roles, which a manual controller builds without relationship entries, so the
+ * expert was answerable and never listed. It now selects from the same role build the answer path re-reads.
+ *
+ * ## The decision
+ *
+ * The row is offered when the viewer holds one of the answering roles in an entry the server reads an answerer from:
+ * the application entry (an OWNER route's `APP_USER`), or ANY organization entry of the backend's access profile
+ * (`user-self | access_profile`): organization-wide, unit-scoped or relationship, in any organization. The access
+ * profile is built by the same role build a decision's role facts are re-read through, so the row follows the server's
+ * own facts rather than a second account of them.
+ *
+ * It is never wider than that: every decision the server lists needs one of those entries to hold the decision's
+ * eligible role (or the person to be the OWNER decision's requester, who holds `APP_USER`). It is not narrower than the
+ * population either, which a row cannot be without listing: whether a decision is actually waiting in the unit the
+ * reviewer covers is the page's question, and the page asks the server.
+ *
+ * ## Rejected alternatives
+ *
+ * - **Widen `requiredRoles` for every row** (the issue's option a, applied to the launcher). It would change what every
+ *   other role-gated entry means: an `office-manager` section would be offered in an organization where the viewer is
+ *   only a member, because they manage another one, and it would open screens the backend then refuses. The decision
+ *   inbox gets its own evaluation instead, as a capability, and `requiredRoles` keeps its meaning.
+ * - **Offer the row when a decision is pending** (option b's second half). That needs a server read on every shell load
+ *   to decide a navigation entry, and the row would come and go as decisions are answered. A reviewer who has answered
+ *   everything still has an inbox; its empty state says so.
+ *
+ * ## Without the access profile
+ *
+ * When the profile could not be loaded, the shell's documented degradation applies: the roles of the current
+ * organization decide, as they did before #2577. A standing elsewhere is then unknown, and the row stays hidden for it
+ * rather than being offered on a guess.
+ *
+ * Presentation, never authorization: the server decides every card on the decision's own route.
+ */
+import { type ApplicationDecisionInbox } from '@wildo-ai/saas-models';
+import { type LauncherEffectiveRoles } from '../../core/navigation/launcher-resolution';
+/** The runtime capability key the Decisions row requires (`runtimeAvailability.requiredCapabilities`). */
+export declare enum DecisionInboxCapability {
+    /**
+     * The viewer holds a role a decision can wait on, in an entry the server reads an answerer from: the application
+     * entry, or any organization entry (organization-wide, unit-scoped or relationship) in any organization. Gates the
+     * engine's Decisions row and its command. An application that places the page itself may require it too.
+     */
+    ANSWERER = "decisionInboxAnswerer"
+}
+/** What the derivation reads: the application's answering roles, and the viewer's roles with the access profile. */
+export interface DecisionInboxCapabilityInputs {
+    /** `appConfig.decisionInbox`, the roles a decision can wait on. Absent when the application declares none. */
+    readonly offer: ApplicationDecisionInbox | undefined;
+    /** The viewer's roles (`useViewerEffectiveRoles`), carrying the role tables and the backend's access profile. */
+    readonly effectiveRoles: LauncherEffectiveRoles;
+}
+/**
+ * Whether the viewer may have decisions waiting in the inbox: one of `offer.answeringRoles`, through the role
+ * hierarchy, held in the application entry or in any organization entry of the access profile. See the module comment.
+ */
+export declare function viewerMayHaveDecisionsWaiting(input: DecisionInboxCapabilityInputs): boolean;
+/** The capability. Pure, so the shell hook stays a call and the decision is pinned without providers. */
+export declare function deriveDecisionInboxCapabilities(input: DecisionInboxCapabilityInputs): Record<DecisionInboxCapability, boolean>;
+//# sourceMappingURL=decision-inbox-capability.frontend.utils.d.ts.map

package/dist/esm/core/config/decision-inbox-capability.frontend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-inbox-capability.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/decision-inbox-capability.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,OAAO,EAAwB,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAyB,KAAK,sBAAsB,EAAE,MAAM,yDAAyD,CAAC;AAE7H,0GAA0G;AAC1G,oBAAY,uBAAuB;IACjC;;;;OAIG;IACH,QAAQ,0BAA0B;CACnC;AAED,oHAAoH;AACpH,MAAM,WAAW,6BAA6B;IAC5C,8GAA8G;IAC9G,QAAQ,CAAC,KAAK,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACrD,iHAAiH;IACjH,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAC;CACjD;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAiB3F;AAED,yGAAyG;AACzG,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,6BAA6B,GAAG,MAAM,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAE9H"}

package/dist/esm/core/config/decision-inbox-capability.frontend.utils.js

@@ -0,0 +1,100 @@
+/**
+ * The runtime capability that decides who is offered the engine's Decisions row (#2527, #2577).
+ *
+ * ## Why the row does not use `requiredRoles`
+ *
+ * `runtimeAvailability.requiredRoles` is evaluated against the viewer's application roles and their ORGANIZATION-WIDE
+ * roles in the CURRENT organization (`viewerHoldsOneOfRoles`). That is right for every other role-gated launcher entry,
+ * because each of them opens something acting in the current organization: a settings section, a view, an operation.
+ *
+ * The decision inbox is not about the current organization. The server lists a person's decisions from every
+ * organization, whatever the current one (`listPendingDecisions`, and each `HumanDecisionHost.listCards`): the
+ * decisions assigned to them, the OWNER decisions they raised, and the ROLE decisions of each organization they hold a
+ * role entry in, an organization reached through a live relationship included (#2792: read through the same role build
+ * as the access profile, `organizationIdsWithRoleEntries`). It then admits each one through the decision organization's
+ * role facts, re-read now (`resolveHumanDecisionRoleFacts`): the eligible role held organization-wide, OR in an
+ * organization unit that contains the decision's unit, OR through an organization relationship (an assigned decision
+ * is admitted that way: the reassignment candidates are the organization's active members, representatives included).
+ * Gated on `requiredRoles`, the row was hidden from two people the server answers decisions for:
+ * - a unit-only reviewer (a finance approver of one unit), who holds no organization-wide role;
+ * - a firm's expert whose current organization is the firm, while the decision waits in a client organization where
+ *   the expert stands through the service relationship.
+ *
+ * Both are LISTED what they may answer, not only offered the row (#2792): the listing used to select ROLE decisions from
+ * the organizations of the request's own roles, which a manual controller builds without relationship entries, so the
+ * expert was answerable and never listed. It now selects from the same role build the answer path re-reads.
+ *
+ * ## The decision
+ *
+ * The row is offered when the viewer holds one of the answering roles in an entry the server reads an answerer from:
+ * the application entry (an OWNER route's `APP_USER`), or ANY organization entry of the backend's access profile
+ * (`user-self | access_profile`): organization-wide, unit-scoped or relationship, in any organization. The access
+ * profile is built by the same role build a decision's role facts are re-read through, so the row follows the server's
+ * own facts rather than a second account of them.
+ *
+ * It is never wider than that: every decision the server lists needs one of those entries to hold the decision's
+ * eligible role (or the person to be the OWNER decision's requester, who holds `APP_USER`). It is not narrower than the
+ * population either, which a row cannot be without listing: whether a decision is actually waiting in the unit the
+ * reviewer covers is the page's question, and the page asks the server.
+ *
+ * ## Rejected alternatives
+ *
+ * - **Widen `requiredRoles` for every row** (the issue's option a, applied to the launcher). It would change what every
+ *   other role-gated entry means: an `office-manager` section would be offered in an organization where the viewer is
+ *   only a member, because they manage another one, and it would open screens the backend then refuses. The decision
+ *   inbox gets its own evaluation instead, as a capability, and `requiredRoles` keeps its meaning.
+ * - **Offer the row when a decision is pending** (option b's second half). That needs a server read on every shell load
+ *   to decide a navigation entry, and the row would come and go as decisions are answered. A reviewer who has answered
+ *   everything still has an inbox; its empty state says so.
+ *
+ * ## Without the access profile
+ *
+ * When the profile could not be loaded, the shell's documented degradation applies: the roles of the current
+ * organization decide, as they did before #2577. A standing elsewhere is then unknown, and the row stays hidden for it
+ * rather than being offered on a guess.
+ *
+ * Presentation, never authorization: the server decides every card on the decision's own route.
+ */
+import { ResourcePrimaryScope } from '@wildo-ai/saas-models';
+import { viewerHoldsOneOfRoles } from '../../core/navigation/launcher-resolution.js';
+/** The runtime capability key the Decisions row requires (`runtimeAvailability.requiredCapabilities`). */
+export var DecisionInboxCapability;
+(function (DecisionInboxCapability) {
+    /**
+     * The viewer holds a role a decision can wait on, in an entry the server reads an answerer from: the application
+     * entry, or any organization entry (organization-wide, unit-scoped or relationship) in any organization. Gates the
+     * engine's Decisions row and its command. An application that places the page itself may require it too.
+     */
+    DecisionInboxCapability["ANSWERER"] = "decisionInboxAnswerer";
+})(DecisionInboxCapability || (DecisionInboxCapability = {}));
+/**
+ * Whether the viewer may have decisions waiting in the inbox: one of `offer.answeringRoles`, through the role
+ * hierarchy, held in the application entry or in any organization entry of the access profile. See the module comment.
+ */
+export function viewerMayHaveDecisionsWaiting(input) {
+    const answeringRoles = input.offer?.answeringRoles ?? [];
+    // No answering role: the application declares nothing a decision can wait on, and no row exists.
+    if (answeringRoles.length === 0)
+        return false;
+    const viewer = input.effectiveRoles;
+    const profile = viewer.accessProfile;
+    if (!profile)
+        return viewerHoldsOneOfRoles(answeringRoles, viewer);
+    const organizationRolesAnywhere = new Set();
+    for (const entry of profile.roleEntries) {
+        // Every organization entry the server can read an answerer from: organization-wide, unit-scoped (`organizationUnitId`)
+        // and relationship entries alike, in every organization. An application entry is read from `applicationRoles`.
+        if (entry.relatedPrimaryScope !== ResourcePrimaryScope.ORGANIZATIONS || !entry.relatedResourceId)
+            continue;
+        for (const role of entry.roles)
+            organizationRolesAnywhere.add(role);
+    }
+    // OR semantics through the organization role table, as `resolveHumanDecisionRoleFacts` expands a held role. One held
+    // role covering one answering role in one entry is enough, so pooling the entries' roles answers the same question.
+    return viewerHoldsOneOfRoles(answeringRoles, { ...viewer, organizationRoles: [...organizationRolesAnywhere] });
+}
+/** The capability. Pure, so the shell hook stays a call and the decision is pinned without providers. */
+export function deriveDecisionInboxCapabilities(input) {
+    return { [DecisionInboxCapability.ANSWERER]: viewerMayHaveDecisionsWaiting(input) };
+}
+//# sourceMappingURL=decision-inbox-capability.frontend.utils.js.map