@wildo-ai/saas-models 1.1.4 → 1.1.6

package/dist/esm/config/frontend/chart-registration-alignment.shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"chart-registration-alignment.shared.js","sourceRoot":"","sources":["../../../../src/config/frontend/chart-registration-alignment.shared.ts"],"names":[],"mappings":"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","sourcesContent":["/** ──────────────────────────────────────────────────────────────\n * Chart registration alignment (drift guard)\n *\n * A resource-owned chart must be wired on BOTH sides:\n *   - FRONTEND: authored in `ResourceUIBehaviorConfig.chartViews[].chartDefinition`\n *     (frontend-only — the backend cannot import it), and\n *   - BACKEND: registered via `BackendDomainModule.chartDefinitions`, which feeds\n *     the backend `ChartRegistry` so `POST /charts/:ref/data` can execute.\n *\n * A frontend chartView whose `chartDefinition.ref` has NO backend registration\n * produces a runtime 404 (`chart_not_found`) — the host renders but the data\n * fetch fails. This module is the pure, framework-general comparator that a\n * build-time / CLI guard uses to catch that drift before it ships.\n *\n * ## The failure is LOUD but LATE, and the distinction decides what this guard is for\n * Earlier revisions of this file, the CLI verb and the CI workflow all called that 404\n * \"silent\". Measured on the runtime path, it is not: `ChartView` renders `ChartErrorState`\n * (an error card with a retry action), a standalone chart page also raises the global error\n * toast (`localErrorOnly` is only set by EMBEDDED hosts), and the backend answers a NOT_FOUND\n * whose context names the resolved ref.\n *\n * So this guard does not exist to make an invisible failure visible. It exists because the\n * failure is only visible to whoever OPENS the chart — a chart on a rarely-visited surface\n * ships broken and is discovered by a user. Everything here moves that discovery to authoring\n * time. Do not restate \"silent\"; it overstates the defect and misdescribes what is being fixed.\n *\n * ## Why this is a comparator and not a boot refusal\n * Neither runtime process can perform this join, so there is no boot to refuse at:\n *   - the BACKEND cannot see `chartViews` — it lives on `ResourceUIBehaviorConfig` in `.tsx`\n *     ui-behavior modules the backend cannot import, which is why the dev companion needs a\n *     dedicated introspection SUBPROCESS to materialize it (and why the backend module slot\n *     exists as a second wiring in the first place);\n *   - the FRONTEND has `chartViews` but never receives the backend's registered set — nothing\n *     serializes `ChartRegistry.getRegisteredChartRefs()` into any boot payload.\n * The only process that sees both is the companion, which is where every channel that runs\n * this comparator lives: `POST /api/companion/charts/audit`, `wildo charts audit`, and the CI\n * gate. The BACKEND-visible half of chart wiring — a chart naming a resource type that does\n * not exist — is refused at boot by `ChartRegistryBackendService.registerChart`.\n *\n * ## The backend set has TWO possible sources, and only ONE of them is the answer\n * `ApplicationInitializationConfig.chartDefinitions` — the array `StartApplicationBackendService`\n * actually registers — is assembled as\n * `overrides.chartDefinitions ?? input.backendRegistry.chartDefinitions`\n * (`buildApplicationInitializationConfigFromModules`). That is a REPLACE, not a merge. So an\n * application supplying `overrides.chartDefinitions` makes the module DECLARATIONS an arbitrary set\n * with no relation to what registers: it may drop a declared chart (a comparison built on the\n * declarations then reports ALIGNED while the chart 404s) and it may add one that is not declared\n * (the same comparison then reports a false FAIL).\n *\n * Hence {@link ChartRegistrationBackendRefsProvenance}. A caller must say WHICH set it brought, and\n * a comparison built on the declarations yields\n * {@link ChartRegistrationAlignmentVerdict.CANNOT_VOUCH} — never `ALIGNED`. A guard that says \"I\n * cannot answer\" beats one that answers about a different population; that is the same class as a\n * green report read off a stale artifact\n * (`.claude/rules/staleness-presents-as-a-logic-defect.md`).\n *\n * ## The effective set IS reachable — no contract change is needed\n * An earlier note on `ChartRegistryBackendService.getRegisteredChartRefs` said closing this \"needs\n * the overrides to reach the companion, which the `companion-exports` contract does not currently\n * carry\". **That was wrong, and the contract had already answered it**:\n * `BackendCompanionExports.buildApplicationInitializationConfig()` is REQUIRED, is the same pure\n * builder backend startup uses, starts nothing, and its JSDoc says in as many words that \"tooling\n * must not reconstruct selected runtime capabilities from lower-level registries\". Composing the\n * backend side from `mergeBackendDomainModules(...)` was exactly that reconstruction.\n *\n * Residual, stated rather than hidden: the companion calls the builder with NO host overrides, so it\n * sees the set the APPLICATION declares. A HOST that passed `chartDefinitions` in its own overrides\n * would diverge — neither dogfood host does (both pass only `customControllers`, `container`,\n * `serviceIdentifier`, `providerRuntime`), and a host-level chart override has no use case today.\n *\n * ## Join key\n * The comparison key is `chartView.chartDefinition.ref` (the execution ref the\n * frontend runtime sends), NOT the outer `chartView.ref` (the view identity).\n *\n * This module is import-safe (pure functions + types, no frontend-lib /\n * backend-lib deps) so it can run from the companion subprocess, a CLI audit,\n * and unit tests alike.\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * Normalize a chart execution reference to its canonical registry key. This is\n * the SINGLE source of truth for ref normalization, shared by the backend\n * `ChartRegistry` (registration + lookup) and this alignment guard, so the two\n * can never diverge on whitespace and silently disagree about whether a chart is\n * registered.\n */\nexport function normalizeChartExecutionRef(rawRef: string): string {\n  return rawRef.trim();\n}\n\n/** One frontend chartView's registration identity (the drift-guard input). */\nexport interface FrontendChartRegistrationRef {\n  /** `chartView.chartDefinition.ref` — the execution/registry join key. */\n  chartDefinitionRef: string;\n  /** The resource type whose ui-behavior authored this chartView. */\n  resourceType: string;\n  /** `chartView.ref` — the view identity (for a precise, locatable error). */\n  chartViewRef: string;\n}\n\n/**\n * WHERE a caller's `backendRegisteredRefs` came from — the input that decides whether this\n * comparison is about the population that actually registers.\n *\n * A closed vocabulary with a named home rather than a boolean, because the two members are not\n * \"good/bad\": each names a concrete assembly step, and the reason one of them cannot be vouched for\n * is a specific line of code (`overrides.chartDefinitions ?? input.backendRegistry.chartDefinitions`)\n * that a `trusted: false` flag could never carry.\n */\nexport enum ChartRegistrationBackendRefsProvenance {\n  /**\n   * From `BackendCompanionExports.buildApplicationInitializationConfig().chartDefinitions` — the\n   * exact array `StartApplicationBackendService` registers, with any\n   * `ApplicationInitializationOverrides.chartDefinitions` already applied. The only provenance that\n   * supports a vouched verdict.\n   */\n  EFFECTIVE_INITIALIZATION_CONFIG = 'effective-initialization-config',\n  /**\n   * From `mergeBackendDomainModules(...).chartDefinitions` — what the modules DECLARE. Equal to the\n   * effective set only while no application supplies `overrides.chartDefinitions`; nothing in this\n   * set records whether one does, which is why a caller supplying it gets `CANNOT_VOUCH` rather\n   * than a verdict.\n   *\n   * This is also what an ABSENT provenance means. The permissive reading was deliberately NOT\n   * chosen for the default: a caller that has not thought about which set it brought has, by\n   * definition, brought the one it could reach without asking.\n   */\n  MODULE_DECLARATIONS = 'module-declarations',\n}\n\n/** What the comparison is entitled to conclude, given where its backend set came from. */\nexport enum ChartRegistrationAlignmentVerdict {\n  /** Every frontend chartView resolves against the set that actually registers. */\n  ALIGNED = 'aligned',\n  /** At least one frontend chartView has no registration in the set that actually registers. */\n  MISALIGNED = 'misaligned',\n  /**\n   * The comparison ran and its channels are populated, but the backend set was not the effective\n   * one — so NEITHER a clean nor a dirty result may be reported as fact. Report the channels as\n   * evidence; do not report alignment.\n   */\n  CANNOT_VOUCH = 'cannot-vouch',\n}\n\n/** The two-channel drift report. */\nexport interface ChartRegistrationAlignmentReport {\n  /** Echoed so a consumer renders, logs or gates on the same answer the comparison used. */\n  backendRefsProvenance: ChartRegistrationBackendRefsProvenance;\n  /** What this comparison is entitled to conclude. See {@link ChartRegistrationAlignmentVerdict}. */\n  verdict: ChartRegistrationAlignmentVerdict;\n  /**\n   * Frontend chartViews whose `chartDefinition.ref` has NO backend registration.\n   * FAIL channel — each one is a guaranteed runtime 404.\n   */\n  unregisteredFrontendCharts: FrontendChartRegistrationRef[];\n  /**\n   * Backend-registered chart refs referenced by NO frontend chartView. WARN\n   * channel — a backend-only chart is valid (e.g. a programmatic/API-only chart\n   * consumed directly via `/charts/:ref/data`), so this is never a hard failure.\n   */\n  orphanBackendCharts: string[];\n}\n\n/**\n * Compare the set of frontend chartView refs against the set of backend-registered\n * chart refs. Both sides are normalized via {@link normalizeChartExecutionRef}\n * before comparison so whitespace never causes a phantom mismatch.\n */\nexport function computeChartRegistrationAlignment(params: {\n  frontendChartRefs: FrontendChartRegistrationRef[];\n  backendRegisteredRefs: string[];\n  /**\n   * WHERE `backendRegisteredRefs` came from. Optional so that adding it did not red-line an\n   * existing caller this change could not reach — absence is read as\n   * {@link ChartRegistrationBackendRefsProvenance.MODULE_DECLARATIONS}, i.e. the answer that\n   * yields `CANNOT_VOUCH`, never the permissive one.\n   */\n  backendRefsProvenance?: ChartRegistrationBackendRefsProvenance;\n}): ChartRegistrationAlignmentReport {\n  const normalizedBackend = params.backendRegisteredRefs.map(normalizeChartExecutionRef);\n  const backendSet = new Set(normalizedBackend);\n  const frontendSet = new Set(\n    params.frontendChartRefs.map((r) => normalizeChartExecutionRef(r.chartDefinitionRef)),\n  );\n\n  const unregisteredFrontendCharts = params.frontendChartRefs.filter(\n    (r) => !backendSet.has(normalizeChartExecutionRef(r.chartDefinitionRef)),\n  );\n\n  const orphanBackendCharts = [\n    ...new Set(normalizedBackend.filter((ref) => !frontendSet.has(ref))),\n  ];\n\n  const backendRefsProvenance =\n    params.backendRefsProvenance ?? ChartRegistrationBackendRefsProvenance.MODULE_DECLARATIONS;\n\n  const verdict =\n    backendRefsProvenance !== ChartRegistrationBackendRefsProvenance.EFFECTIVE_INITIALIZATION_CONFIG\n      ? ChartRegistrationAlignmentVerdict.CANNOT_VOUCH\n      : unregisteredFrontendCharts.length > 0\n        ? ChartRegistrationAlignmentVerdict.MISALIGNED\n        : ChartRegistrationAlignmentVerdict.ALIGNED;\n\n  return { backendRefsProvenance, verdict, unregisteredFrontendCharts, orphanBackendCharts };\n}\n\n/**\n * Render the provenance caveat, or `undefined` when the report may be taken at face value.\n *\n * Exists so the two surfaces a person reads — the CLI's summary line and the thrown gate message —\n * cannot word this differently, or one of them forget it. A caveat that appears on one surface is\n * the state this whole change is repairing.\n */\nexport function describeChartRegistrationVerdictCaveat(\n  report: ChartRegistrationAlignmentReport,\n): string | undefined {\n  if (report.verdict !== ChartRegistrationAlignmentVerdict.CANNOT_VOUCH) return undefined;\n  return (\n    'This comparison used the module DECLARATIONS '\n    + `(provenance: ${report.backendRefsProvenance}), not the set the backend registers. `\n    + 'An application supplying `ApplicationInitializationOverrides.chartDefinitions` REPLACES the '\n    + 'declared array, so a dropped chart would read as aligned here and 404 at runtime. '\n    + 'Fix: take the backend refs from '\n    + '`backendCompanionExports.buildApplicationInitializationConfig().chartDefinitions` and pass '\n    + `backendRefsProvenance: ${ChartRegistrationBackendRefsProvenance.EFFECTIVE_INITIALIZATION_CONFIG}.`\n  );\n}\n\n/**\n * Throw a verbose, locatable error if any frontend chartView is unregistered\n * backend-side. Only the FAIL channel throws; `orphanBackendCharts` (WARN) never\n * throws. Use in the `--strict` path of the CLI audit / a CI gate.\n *\n * ## `requireVouchedVerdict` defaults to `true`, and that is the point of the parameter\n *\n * A clean FAIL channel is only evidence of alignment when the backend set was the EFFECTIVE one — a\n * chart dropped by an `ApplicationInitializationOverrides.chartDefinitions` override is registered\n * nowhere and declared everywhere, so a comparison against the DECLARATIONS reports ALIGNED about a\n * population the application does not run. So this refuses a\n * {@link ChartRegistrationAlignmentVerdict.CANNOT_VOUCH} report rather than returning quietly, and a\n * caller has to say deliberately that it does not want that.\n *\n * It shipped defaulting to `false` (2026-09-09) for one turn, because the companion's own CI-gate\n * test still composed its backend set from `mergeBackendDomainModules(...)` and defaulting to `true`\n * would have turned a green gate red with no hand able to repair it. That caller was fixed the same\n * day and the default flipped with it. The permissive default is gone deliberately: it protected one\n * known caller and would have silently absolved every future one.\n *\n * Pass `false` only where the verdict is being REPORTED rather than gated — a summary line that\n * prints {@link describeChartRegistrationVerdictCaveat} beside it is honest; a gate that returns\n * quietly is not.\n */\nexport function assertChartRegistrationAligned(\n  report: ChartRegistrationAlignmentReport,\n  errorPrefix = 'ChartRegistrationAlignment',\n  requireVouchedVerdict = true,\n): void {\n  if (requireVouchedVerdict && report.verdict === ChartRegistrationAlignmentVerdict.CANNOT_VOUCH) {\n    throw new Error(\n      `${errorPrefix}: refusing to report alignment. `\n      + describeChartRegistrationVerdictCaveat(report),\n    );\n  }\n  if (report.unregisteredFrontendCharts.length === 0) return;\n  const lines = report.unregisteredFrontendCharts.map(\n    (r) =>\n      `  - ${r.resourceType}.${r.chartViewRef} → chartDefinition.ref '${r.chartDefinitionRef}' has no backend chartDefinitions registration`,\n  );\n  throw new Error(\n    `${errorPrefix}: ${report.unregisteredFrontendCharts.length} chart view(s) reference a chart that is NOT registered backend-side (each would 404 with chart_not_found at runtime):\\n` +\n      `${lines.join('\\n')}\\n` +\n      `Fix: add the shared ChartDefinition to the owning backend module's \\`chartDefinitions\\` array.`,\n  );\n}\n"]}
+{"version":3,"file":"chart-registration-alignment.shared.js","sourceRoot":"","sources":["../../../../../src/config/frontend/chart-registration-alignment.shared.ts"],"names":[],"mappings":"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","sourcesContent":["/** ──────────────────────────────────────────────────────────────\n * Chart registration alignment (drift guard)\n *\n * A resource-owned chart must be wired on BOTH sides:\n *   - FRONTEND: authored in `ResourceUIBehaviorConfig.chartViews[].chartDefinition`\n *     (frontend-only — the backend cannot import it), and\n *   - BACKEND: registered via `BackendDomainModule.chartDefinitions`, which feeds\n *     the backend `ChartRegistry` so `POST /charts/:ref/data` can execute.\n *\n * A frontend chartView whose `chartDefinition.ref` has NO backend registration\n * produces a runtime 404 (`chart_not_found`) — the host renders but the data\n * fetch fails. This module is the pure, framework-general comparator that a\n * build-time / CLI guard uses to catch that drift before it ships.\n *\n * ## The failure is LOUD but LATE, and the distinction decides what this guard is for\n * Earlier revisions of this file, the CLI verb and the CI workflow all called that 404\n * \"silent\". Measured on the runtime path, it is not: `ChartView` renders `ChartErrorState`\n * (an error card with a retry action), a standalone chart page also raises the global error\n * toast (`localErrorOnly` is only set by EMBEDDED hosts), and the backend answers a NOT_FOUND\n * whose context names the resolved ref.\n *\n * So this guard does not exist to make an invisible failure visible. It exists because the\n * failure is only visible to whoever OPENS the chart — a chart on a rarely-visited surface\n * ships broken and is discovered by a user. Everything here moves that discovery to authoring\n * time. Do not restate \"silent\"; it overstates the defect and misdescribes what is being fixed.\n *\n * ## Why this is a comparator and not a boot refusal\n * Neither runtime process can perform this join, so there is no boot to refuse at:\n *   - the BACKEND cannot see `chartViews` — it lives on `ResourceUIBehaviorConfig` in `.tsx`\n *     ui-behavior modules the backend cannot import, which is why the dev companion needs a\n *     dedicated introspection SUBPROCESS to materialize it (and why the backend module slot\n *     exists as a second wiring in the first place);\n *   - the FRONTEND has `chartViews` but never receives the backend's registered set — nothing\n *     serializes `ChartRegistry.getRegisteredChartRefs()` into any boot payload.\n * The only process that sees both is the companion, which is where every channel that runs\n * this comparator lives: `POST /api/companion/charts/audit`, `wildo charts audit`, and the CI\n * gate. The BACKEND-visible half of chart wiring — a chart naming a resource type that does\n * not exist — is refused at boot by `ChartRegistryBackendService.registerChart`.\n *\n * ## The backend set has TWO possible sources, and only ONE of them is the answer\n * `ApplicationInitializationConfig.chartDefinitions` — the array `StartApplicationBackendService`\n * actually registers — is assembled as\n * `overrides.chartDefinitions ?? input.backendRegistry.chartDefinitions`\n * (`buildApplicationInitializationConfigFromModules`). That is a REPLACE, not a merge. So an\n * application supplying `overrides.chartDefinitions` makes the module DECLARATIONS an arbitrary set\n * with no relation to what registers: it may drop a declared chart (a comparison built on the\n * declarations then reports ALIGNED while the chart 404s) and it may add one that is not declared\n * (the same comparison then reports a false FAIL).\n *\n * Hence {@link ChartRegistrationBackendRefsProvenance}. A caller must say WHICH set it brought, and\n * a comparison built on the declarations yields\n * {@link ChartRegistrationAlignmentVerdict.CANNOT_VOUCH} — never `ALIGNED`. A guard that says \"I\n * cannot answer\" beats one that answers about a different population; that is the same class as a\n * green report read off a stale artifact\n * (`.claude/rules/staleness-presents-as-a-logic-defect.md`).\n *\n * ## The effective set IS reachable — no contract change is needed\n * An earlier note on `ChartRegistryBackendService.getRegisteredChartRefs` said closing this \"needs\n * the overrides to reach the companion, which the `companion-exports` contract does not currently\n * carry\". **That was wrong, and the contract had already answered it**:\n * `BackendCompanionExports.buildApplicationInitializationConfig()` is REQUIRED, is the same pure\n * builder backend startup uses, starts nothing, and its JSDoc says in as many words that \"tooling\n * must not reconstruct selected runtime capabilities from lower-level registries\". Composing the\n * backend side from `mergeBackendDomainModules(...)` was exactly that reconstruction.\n *\n * Residual, stated rather than hidden: the companion calls the builder with NO host overrides, so it\n * sees the set the APPLICATION declares. A HOST that passed `chartDefinitions` in its own overrides\n * would diverge — neither dogfood host does (both pass only `customControllers`, `container`,\n * `serviceIdentifier`, `providerRuntime`), and a host-level chart override has no use case today.\n *\n * ## Join key\n * The comparison key is `chartView.chartDefinition.ref` (the execution ref the\n * frontend runtime sends), NOT the outer `chartView.ref` (the view identity).\n *\n * This module is import-safe (pure functions + types, no frontend-lib /\n * backend-lib deps) so it can run from the companion subprocess, a CLI audit,\n * and unit tests alike.\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * Normalize a chart execution reference to its canonical registry key. This is\n * the SINGLE source of truth for ref normalization, shared by the backend\n * `ChartRegistry` (registration + lookup) and this alignment guard, so the two\n * can never diverge on whitespace and silently disagree about whether a chart is\n * registered.\n */\nexport function normalizeChartExecutionRef(rawRef: string): string {\n  return rawRef.trim();\n}\n\n/** One frontend chartView's registration identity (the drift-guard input). */\nexport interface FrontendChartRegistrationRef {\n  /** `chartView.chartDefinition.ref` — the execution/registry join key. */\n  chartDefinitionRef: string;\n  /** The resource type whose ui-behavior authored this chartView. */\n  resourceType: string;\n  /** `chartView.ref` — the view identity (for a precise, locatable error). */\n  chartViewRef: string;\n}\n\n/**\n * WHERE a caller's `backendRegisteredRefs` came from — the input that decides whether this\n * comparison is about the population that actually registers.\n *\n * A closed vocabulary with a named home rather than a boolean, because the two members are not\n * \"good/bad\": each names a concrete assembly step, and the reason one of them cannot be vouched for\n * is a specific line of code (`overrides.chartDefinitions ?? input.backendRegistry.chartDefinitions`)\n * that a `trusted: false` flag could never carry.\n */\nexport enum ChartRegistrationBackendRefsProvenance {\n  /**\n   * From `BackendCompanionExports.buildApplicationInitializationConfig().chartDefinitions` — the\n   * exact array `StartApplicationBackendService` registers, with any\n   * `ApplicationInitializationOverrides.chartDefinitions` already applied. The only provenance that\n   * supports a vouched verdict.\n   */\n  EFFECTIVE_INITIALIZATION_CONFIG = 'effective-initialization-config',\n  /**\n   * From `mergeBackendDomainModules(...).chartDefinitions` — what the modules DECLARE. Equal to the\n   * effective set only while no application supplies `overrides.chartDefinitions`; nothing in this\n   * set records whether one does, which is why a caller supplying it gets `CANNOT_VOUCH` rather\n   * than a verdict.\n   *\n   * This is also what an ABSENT provenance means. The permissive reading was deliberately NOT\n   * chosen for the default: a caller that has not thought about which set it brought has, by\n   * definition, brought the one it could reach without asking.\n   */\n  MODULE_DECLARATIONS = 'module-declarations',\n}\n\n/** What the comparison is entitled to conclude, given where its backend set came from. */\nexport enum ChartRegistrationAlignmentVerdict {\n  /** Every frontend chartView resolves against the set that actually registers. */\n  ALIGNED = 'aligned',\n  /** At least one frontend chartView has no registration in the set that actually registers. */\n  MISALIGNED = 'misaligned',\n  /**\n   * The comparison ran and its channels are populated, but the backend set was not the effective\n   * one — so NEITHER a clean nor a dirty result may be reported as fact. Report the channels as\n   * evidence; do not report alignment.\n   */\n  CANNOT_VOUCH = 'cannot-vouch',\n}\n\n/** The two-channel drift report. */\nexport interface ChartRegistrationAlignmentReport {\n  /** Echoed so a consumer renders, logs or gates on the same answer the comparison used. */\n  backendRefsProvenance: ChartRegistrationBackendRefsProvenance;\n  /** What this comparison is entitled to conclude. See {@link ChartRegistrationAlignmentVerdict}. */\n  verdict: ChartRegistrationAlignmentVerdict;\n  /**\n   * Frontend chartViews whose `chartDefinition.ref` has NO backend registration.\n   * FAIL channel — each one is a guaranteed runtime 404.\n   */\n  unregisteredFrontendCharts: FrontendChartRegistrationRef[];\n  /**\n   * Backend-registered chart refs referenced by NO frontend chartView. WARN\n   * channel — a backend-only chart is valid (e.g. a programmatic/API-only chart\n   * consumed directly via `/charts/:ref/data`), so this is never a hard failure.\n   */\n  orphanBackendCharts: string[];\n}\n\n/**\n * Compare the set of frontend chartView refs against the set of backend-registered\n * chart refs. Both sides are normalized via {@link normalizeChartExecutionRef}\n * before comparison so whitespace never causes a phantom mismatch.\n */\nexport function computeChartRegistrationAlignment(params: {\n  frontendChartRefs: FrontendChartRegistrationRef[];\n  backendRegisteredRefs: string[];\n  /**\n   * WHERE `backendRegisteredRefs` came from. Optional so that adding it did not red-line an\n   * existing caller this change could not reach — absence is read as\n   * {@link ChartRegistrationBackendRefsProvenance.MODULE_DECLARATIONS}, i.e. the answer that\n   * yields `CANNOT_VOUCH`, never the permissive one.\n   */\n  backendRefsProvenance?: ChartRegistrationBackendRefsProvenance;\n}): ChartRegistrationAlignmentReport {\n  const normalizedBackend = params.backendRegisteredRefs.map(normalizeChartExecutionRef);\n  const backendSet = new Set(normalizedBackend);\n  const frontendSet = new Set(\n    params.frontendChartRefs.map((r) => normalizeChartExecutionRef(r.chartDefinitionRef)),\n  );\n\n  const unregisteredFrontendCharts = params.frontendChartRefs.filter(\n    (r) => !backendSet.has(normalizeChartExecutionRef(r.chartDefinitionRef)),\n  );\n\n  const orphanBackendCharts = [\n    ...new Set(normalizedBackend.filter((ref) => !frontendSet.has(ref))),\n  ];\n\n  const backendRefsProvenance =\n    params.backendRefsProvenance ?? ChartRegistrationBackendRefsProvenance.MODULE_DECLARATIONS;\n\n  const verdict =\n    backendRefsProvenance !== ChartRegistrationBackendRefsProvenance.EFFECTIVE_INITIALIZATION_CONFIG\n      ? ChartRegistrationAlignmentVerdict.CANNOT_VOUCH\n      : unregisteredFrontendCharts.length > 0\n        ? ChartRegistrationAlignmentVerdict.MISALIGNED\n        : ChartRegistrationAlignmentVerdict.ALIGNED;\n\n  return { backendRefsProvenance, verdict, unregisteredFrontendCharts, orphanBackendCharts };\n}\n\n/**\n * Render the provenance caveat, or `undefined` when the report may be taken at face value.\n *\n * Exists so the two surfaces a person reads — the CLI's summary line and the thrown gate message —\n * cannot word this differently, or one of them forget it. A caveat that appears on one surface is\n * the state this whole change is repairing.\n */\nexport function describeChartRegistrationVerdictCaveat(\n  report: ChartRegistrationAlignmentReport,\n): string | undefined {\n  if (report.verdict !== ChartRegistrationAlignmentVerdict.CANNOT_VOUCH) return undefined;\n  return (\n    'This comparison used the module DECLARATIONS '\n    + `(provenance: ${report.backendRefsProvenance}), not the set the backend registers. `\n    + 'An application supplying `ApplicationInitializationOverrides.chartDefinitions` REPLACES the '\n    + 'declared array, so a dropped chart would read as aligned here and 404 at runtime. '\n    + 'Fix: take the backend refs from '\n    + '`backendCompanionExports.buildApplicationInitializationConfig().chartDefinitions` and pass '\n    + `backendRefsProvenance: ${ChartRegistrationBackendRefsProvenance.EFFECTIVE_INITIALIZATION_CONFIG}.`\n  );\n}\n\n/**\n * Throw a verbose, locatable error if any frontend chartView is unregistered\n * backend-side. Only the FAIL channel throws; `orphanBackendCharts` (WARN) never\n * throws. Use in the `--strict` path of the CLI audit / a CI gate.\n *\n * ## `requireVouchedVerdict` defaults to `true`, and that is the point of the parameter\n *\n * A clean FAIL channel is only evidence of alignment when the backend set was the EFFECTIVE one — a\n * chart dropped by an `ApplicationInitializationOverrides.chartDefinitions` override is registered\n * nowhere and declared everywhere, so a comparison against the DECLARATIONS reports ALIGNED about a\n * population the application does not run. So this refuses a\n * {@link ChartRegistrationAlignmentVerdict.CANNOT_VOUCH} report rather than returning quietly, and a\n * caller has to say deliberately that it does not want that.\n *\n * It shipped defaulting to `false` (2026-09-09) for one turn, because the companion's own CI-gate\n * test still composed its backend set from `mergeBackendDomainModules(...)` and defaulting to `true`\n * would have turned a green gate red with no hand able to repair it. That caller was fixed the same\n * day and the default flipped with it. The permissive default is gone deliberately: it protected one\n * known caller and would have silently absolved every future one.\n *\n * Pass `false` only where the verdict is being REPORTED rather than gated — a summary line that\n * prints {@link describeChartRegistrationVerdictCaveat} beside it is honest; a gate that returns\n * quietly is not.\n */\nexport function assertChartRegistrationAligned(\n  report: ChartRegistrationAlignmentReport,\n  errorPrefix = 'ChartRegistrationAlignment',\n  requireVouchedVerdict = true,\n): void {\n  if (requireVouchedVerdict && report.verdict === ChartRegistrationAlignmentVerdict.CANNOT_VOUCH) {\n    throw new Error(\n      `${errorPrefix}: refusing to report alignment. `\n      + describeChartRegistrationVerdictCaveat(report),\n    );\n  }\n  if (report.unregisteredFrontendCharts.length === 0) return;\n  const lines = report.unregisteredFrontendCharts.map(\n    (r) =>\n      `  - ${r.resourceType}.${r.chartViewRef} → chartDefinition.ref '${r.chartDefinitionRef}' has no backend chartDefinitions registration`,\n  );\n  throw new Error(\n    `${errorPrefix}: ${report.unregisteredFrontendCharts.length} chart view(s) reference a chart that is NOT registered backend-side (each would 404 with chart_not_found at runtime):\\n` +\n      `${lines.join('\\n')}\\n` +\n      `Fix: add the shared ChartDefinition to the owning backend module's \\`chartDefinitions\\` array.`,\n  );\n}\n"]}

package/dist/esm/config/frontend/navigation.shared.schemas.d.ts

@@ -36,7 +36,8 @@ import { CoreResourceOperation } from '../../resources/resources.shared.core.def
  *
  * `push` behavior depends on the zone's `contentModel`:
  * - In `single` zones: stack-based (new content on top, back pops)
- * - In `tabbed` zones: opens a new tab (or activates existing for same resource)
+ * - In `tabbed` zones: opens a new tab and makes it active (an already-open record is NOT
+ *   de-duplicated — it opens again)
  *
  * @wildo_source:part:start saas.models.navigation.transition-vocabulary facet:layer:shared facet:family:navigation-config
  */
@@ -57,14 +58,17 @@ export declare enum NavigationTransition {
      * Content opens in an adjacent zone (secondary or companion).
      * Creates a side-by-side layout. The source zone's content remains visible.
      * Back navigation un-splits (closes the adjacent zone).
-     * URL adds a split segment.
+     * URL: the detail's own address beside a resource primary; beside any other primary the host
+     * keeps its URL and a RESOURCE detail rides as `?pane=`. There is no split segment.
      */
     SPLIT = "split",
     /**
      * Content opens in a floating layer above the entire layout (dialog, sheet, or drawer).
-     * The underlying layout remains visible but non-interactive.
+     * The underlying layout remains visible; it is non-interactive while the overlay is modal (the
+     * default), and stays interactive under `overlayBehavior.modal: false`.
      * Back navigation or Escape dismisses the overlay.
-     * URL adds an overlay param/hash.
+     * NOT URL-addressed: opening an overlay leaves the browser URL where it was, so its content cannot
+     * be linked to or restored by a reload. Choose it knowing that.
      */
     OVERLAY = "overlay",
     /**
@@ -105,7 +109,8 @@ export declare enum NavigationTransition {
     INPLACE = "inplace",
     /**
      * Escape the current context and open content at primary scope.
-     * Abandons the current context: overlays close, companion/secondary dismiss.
+     * Abandons the current context: overlays close, companion/secondary dismiss — except a pane
+     * placed by a `persistent` split, which survives a reset by design.
      * The promoted content becomes the primary zone's top content.
      *
      * Use case: a link within an overlay should open as a full primary view,
@@ -153,8 +158,9 @@ export declare enum NavigationZoneName {
     SECONDARY = "secondary",
     /**
      * Persistent supplementary content. Reference panels, docs, notes, threads.
-     * Only exists if declared in config. Usually hidden by default (`defaultVisible: false`).
-     * Activated by `split` with `persistent: true` or explicit user toggle.
+     * Only exists if declared in config, and starts hidden.
+     * Reached by a `split` with `persistent: true`, or by an ordinary `split` when the secondary zone
+     * is already occupied.
      * Typical use: Slack thread panel, VS Code terminal, documentation sidebar.
      */
     COMPANION = "companion"
@@ -175,9 +181,10 @@ export declare enum NavigationZoneContentModel {
      */
     SINGLE = "single",
     /**
-     * Parallel tabs: `push` creates a new tab (or activates existing for the same resource).
-     * Tab bar is visible, showing all open tabs. No depth stack within tabs.
-     * `replace` replaces the active tab's content. Close is an explicit action (not back).
+     * Parallel tabs: every navigation landing in the zone opens a new tab and makes it active (no
+     * de-duplication). Tab bar is visible, showing all open tabs. No depth stack within tabs.
+     * `replace` replaces the active tab's content, and back closes the active tab and shows its
+     * neighbour. The model changes RENDERING only — it does not change how navigation resolves.
      * When no tabs remain, `onEmpty` behavior applies.
      */
     TABBED = "tabbed"
@@ -186,8 +193,10 @@ export declare enum NavigationZoneContentModel {
  * Responsive collapse behavior when viewport shrinks below a zone's breakpoint.
  *
  * Only applies to secondary and companion zones. Primary never collapses.
- * When viewport grows back past the breakpoint, collapsed content migrates
- * back to its original zone (content is preserved).
+ * It applies to content ALREADY in the zone, not only to new navigations: when the zone collapses its
+ * whole history moves (a tabbed zone's tabs too, the one on screen on top), and when the viewport
+ * grows back what is still on top of primary migrates home with every field intact. Whatever the
+ * reader navigated past at the narrow width stays where it is.
  */
 export declare enum ResponsiveCollapseMode {
     /**
@@ -252,24 +261,6 @@ export declare enum OverlayAppearance {
      */
     DRAWER = "drawer"
 }
-/**
- * Visual presentation for split transitions.
- * Determines how adjacent zone content renders alongside the source zone.
- */
-export declare enum SplitAppearance {
-    /**
-     * Standard vertical side panel.
-     * Content appears beside the source zone with a resizable divider.
-     * Most common for list-detail patterns.
-     */
-    PANEL = "panel",
-    /**
-     * Horizontal drawer (bottom panel).
-     * Content appears below the source zone.
-     * Used for companion panels like terminals, output logs, reference docs.
-     */
-    DRAWER = "drawer"
-}
 /** @wildo_source:part:end saas.models.navigation.surface-vocabulary */
 /**
  * A value that is either a plain `T` (applies at all viewports) or a
@@ -370,42 +361,28 @@ export type ZoneTransitions = Partial<Record<CoreResourceOperation, TransitionCo
 /**
  * Transition → visual appearance for a zone. Values are viewport-discriminated.
  *
- * Only `split` and `overlay` transitions have meaningful appearance choices.
- * `push`, `replace`, `inplace`, and `promote` have no appearance to configure:
+ * Only the `overlay` transition has an appearance choice. The others have none to configure:
  * - `push`/`replace` fill the zone
+ * - `split` opens a pane whose shape is `split.orientation` (there is no split appearance)
  * - `inplace` transforms an element within the current view
  * - `promote` fills primary (same as push/replace)
  *
  * @example
  * appearance: {
- *   split:   SplitAppearance.PANEL,                                                       // always side panel
  *   overlay: { [ViewportBreakpoint.VERT_TABLET]: OverlayAppearance.SHEET, [ViewportBreakpoint.MOBILE]: OverlayAppearance.DRAWER },   // sheet on tablet, drawer on mobile
  * }
  */
 export declare const ZoneAppearanceSchema: z.ZodObject<{
-    split: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof SplitAppearance>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof SplitAppearance>>]>>;
     overlay: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof OverlayAppearance>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof OverlayAppearance>>]>>;
 }, z.core.$strip>;
 export type ZoneAppearance = z.infer<typeof ZoneAppearanceSchema>;
 /**
  * @wildo_source:part:start saas.models.navigation.zone-declaration facet:layer:shared facet:family:navigation-config
  *
- * How much of its zone a DESTINATION's content occupies.
- *
- * The primary zone caps and centres its content at `var(--content-max-width, 80rem)` and gives it no
- * definite-height ancestor. That is correct for almost everything a zone hosts — a form, a list, a
- * settings page stretched across a 2560px monitor is unreadable — and wrong for content whose whole
- * value is the space it occupies. Until this enum existed there was no way to tell the two apart, so
- * a canvas had to hand-roll a viewport fraction (`h-[70vh]`), which sizes against the WINDOW rather
- * than the container and therefore ignores whatever chrome sits above it.
- *
- * Declared per DESTINATION rather than per zone: the same primary zone hosts a list that wants the
- * cap, a detail page that caps itself, and a graph that wants neither.
- *
- * Width and height are separable on purpose. A wide data table wants the cap gone and its natural
- * height; collapsing both into one boolean would merge two meanings, and two independent booleans
- * would make "full height, still capped at 80rem" representable — a combination nothing wants and
- * someone would eventually author by accident.
+ * How much of its zone a destination's content occupies is NOT declared here: it is the
+ * destination's `ZoneContentGeometry` (a `maxWidth` and a `fillsHeight`), because the same primary
+ * zone hosts a list that wants the width cap, a detail that caps itself, and a graph that wants
+ * neither. A zone's own declaration follows.
  */
 /**
  * Full zone configuration.
@@ -414,10 +391,25 @@ export type ZoneAppearance = z.infer<typeof ZoneAppearanceSchema>;
  * which transition fires for each operation, how content appears,
  * and how the zone responds to viewport changes.
  *
- * Note: `minWidth`, `maxWidth`, `defaultVisible`, `onEmpty`,
- * and `responsiveCollapse` are only meaningful for secondary and companion zones.
- * Primary never collapses, never empties, and takes remaining space.
+ * Note: `minWidth`, `maxWidth`, `onEmpty` and `responsiveCollapse` are only meaningful for
+ * secondary and companion zones. Primary never collapses, never empties, and takes remaining space.
  * Setting these on primary has no effect.
+ *
+ * ## Every field here is READ by the runtime, and that was checked rather than assumed (#211)
+ *
+ * | field | the reader |
+ * |---|---|
+ * | `contentModel` | `NavigationContentAreas.tsx` (TABBED detection) + `zone-visible-entry.ts` |
+ * | `transitions` | `navigation-policy-resolver.service.ts` |
+ * | `appearance` | the policy resolver (`appearance.overlay` — there is no split appearance) |
+ * | `minWidth` / `maxWidth` | `NavigationContentAreas.tsx` drag constraints, both split branches |
+ * | `onEmpty` | `zone-empty-behavior.ts` |
+ * | `responsiveCollapse` | `navigation-policy-resolver.service.ts` |
+ *
+ * `defaultVisible` was REMOVED by that audit: nothing read it, and its only documented meaning was
+ * "defaults to `true` when `split.autoSplit` is `true`" — a field defined in terms of another field
+ * that was also dead. What it was reaching for is `onEmpty`, which every current layout already uses
+ * (`zoneOccupiesSpaceWhenEmpty`) and which the runtime genuinely reads.
  */
 export declare const ZoneConfigSchema: z.ZodObject<{
     contentModel: z.ZodDefault<z.ZodEnum<typeof NavigationZoneContentModel>>;
@@ -431,12 +423,10 @@ export declare const ZoneConfigSchema: z.ZodObject<{
         ephemeral?: boolean;
     }>>, unknown>>;
     appearance: z.ZodOptional<z.ZodObject<{
-        split: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof SplitAppearance>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof SplitAppearance>>]>>;
         overlay: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof OverlayAppearance>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof OverlayAppearance>>]>>;
     }, z.core.$strip>>;
     minWidth: z.ZodOptional<z.ZodNumber>;
     maxWidth: z.ZodOptional<z.ZodNumber>;
-    defaultVisible: z.ZodOptional<z.ZodBoolean>;
     onEmpty: z.ZodOptional<z.ZodEnum<typeof ZoneEmptyBehavior>>;
     responsiveCollapse: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof ResponsiveCollapseMode>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof ResponsiveCollapseMode>>]>>;
 }, z.core.$strip>;
@@ -474,7 +464,6 @@ export declare const AppLevelConfigSchema: z.ZodObject<{
         ephemeral?: boolean;
     }>>, unknown>>;
     appearance: z.ZodOptional<z.ZodObject<{
-        split: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof SplitAppearance>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof SplitAppearance>>]>>;
         overlay: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof OverlayAppearance>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof OverlayAppearance>>]>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -516,7 +505,6 @@ export type FromOverlayConfig = z.infer<typeof FromOverlayConfigSchema>;
  */
 export declare const CompanionSplitConfigSchema: z.ZodObject<{
     ratio: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
-    orientation: z.ZodDefault<z.ZodEnum<typeof DisplayDirection>>;
     resizable: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type CompanionSplitConfig = z.infer<typeof CompanionSplitConfigSchema>;
@@ -528,25 +516,21 @@ export type CompanionSplitConfig = z.infer<typeof CompanionSplitConfigSchema>;
  *
  * @example
  * split: {
- *   autoSplit: true,                                    // LIST pre-splits when primary.read = NavigationTransition.SPLIT
  *   ratio: [40, 60],                                    // 40% primary, 60% secondary
  *   orientation: DisplayDirection.VERTICAL,              // side-by-side
  *   resizable: true,                                     // divider is draggable
  *   companion: {
  *     ratio: [70, 30],                                   // companion takes 30%
- *     orientation: DisplayDirection.HORIZONTAL,         // bottom panel
- *     resizable: true,
+ *     resizable: true,                                   // its own divider is draggable
  *   },
  * }
  */
 export declare const SplitConfigSchema: z.ZodObject<{
-    autoSplit: z.ZodDefault<z.ZodBoolean>;
     ratio: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
     orientation: z.ZodDefault<z.ZodEnum<typeof DisplayDirection>>;
     resizable: z.ZodDefault<z.ZodBoolean>;
     companion: z.ZodOptional<z.ZodObject<{
         ratio: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
-        orientation: z.ZodDefault<z.ZodEnum<typeof DisplayDirection>>;
         resizable: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -588,12 +572,15 @@ export type ViewportOverride = z.infer<typeof ViewportOverrideSchema>;
  * behavior. It specifies which zones exist, how each zone handles operations,
  * how zones are sized relative to each other, and global overrides.
  *
- * Resolution order (from highest to lowest priority):
+ * Resolution order (from highest to lowest priority; the first tier that answers wins):
  * 1. Per-operation frontend override (`operation.operationFrontendConfig.navigationOverrides`)
- * 2. Per-relationship override (`display.inParentNavigation.transition`)
- * 3. Global viewport override (`ViewportBreakpoint.MOBILE` / `ViewportBreakpoint.VERT_TABLET` blocks)
- * 4. Source context `transitions[operation]` + `appearance[transition]`
- * 5. Framework hardcoded fallback
+ * 2. Authored action presentation (an operation's explicit presentation)
+ * 3. Per-relationship override (`display.inParentNavigation.transition`)
+ * 4. Global viewport override (`ViewportBreakpoint.MOBILE` / `ViewportBreakpoint.VERT_TABLET` blocks)
+ * 5. Source context `transitions[operation]` — an overlay source with no `fromOverlay` entry falls
+ *    back to primary's map
+ * 6. Derived action presentation (inferred by the framework, used only after authored policy)
+ * 7. Framework hardcoded fallback
  *
  * @example
  * const layout: NavigationLayout = {
@@ -603,7 +590,7 @@ export type ViewportOverride = z.infer<typeof ViewportOverrideSchema>;
  *   },
  *   appLevel: { transitions: { list: NavigationTransition.REPLACE, create: NavigationTransition.OVERLAY } },
  *   fromOverlay: { transitions: { read: NavigationTransition.PROMOTE } },
- *   split: { autoSplit: true, ratio: [40, 60] },
+ *   split: { ratio: [40, 60] },
  *   maxDepth: 2,
  * };
  */
@@ -669,12 +656,10 @@ export declare const NavigationLayoutSchema: z.ZodObject<{
                 ephemeral?: boolean;
             }>>, unknown>>;
             appearance: z.ZodOptional<z.ZodObject<{
-                split: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof SplitAppearance>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof SplitAppearance>>]>>;
                 overlay: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof OverlayAppearance>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof OverlayAppearance>>]>>;
             }, z.core.$strip>>;
             minWidth: z.ZodOptional<z.ZodNumber>;
             maxWidth: z.ZodOptional<z.ZodNumber>;
-            defaultVisible: z.ZodOptional<z.ZodBoolean>;
             onEmpty: z.ZodOptional<z.ZodEnum<typeof ZoneEmptyBehavior>>;
             responsiveCollapse: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof ResponsiveCollapseMode>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof ResponsiveCollapseMode>>]>>;
         }, z.core.$strip>;
@@ -690,12 +675,10 @@ export declare const NavigationLayoutSchema: z.ZodObject<{
                 ephemeral?: boolean;
             }>>, unknown>>;
             appearance: z.ZodOptional<z.ZodObject<{
-                split: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof SplitAppearance>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof SplitAppearance>>]>>;
                 overlay: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof OverlayAppearance>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof OverlayAppearance>>]>>;
             }, z.core.$strip>>;
             minWidth: z.ZodOptional<z.ZodNumber>;
             maxWidth: z.ZodOptional<z.ZodNumber>;
-            defaultVisible: z.ZodOptional<z.ZodBoolean>;
             onEmpty: z.ZodOptional<z.ZodEnum<typeof ZoneEmptyBehavior>>;
             responsiveCollapse: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof ResponsiveCollapseMode>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof ResponsiveCollapseMode>>]>>;
         }, z.core.$strip>>;
@@ -711,12 +694,10 @@ export declare const NavigationLayoutSchema: z.ZodObject<{
                 ephemeral?: boolean;
             }>>, unknown>>;
             appearance: z.ZodOptional<z.ZodObject<{
-                split: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof SplitAppearance>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof SplitAppearance>>]>>;
                 overlay: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof OverlayAppearance>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof OverlayAppearance>>]>>;
             }, z.core.$strip>>;
             minWidth: z.ZodOptional<z.ZodNumber>;
             maxWidth: z.ZodOptional<z.ZodNumber>;
-            defaultVisible: z.ZodOptional<z.ZodBoolean>;
             onEmpty: z.ZodOptional<z.ZodEnum<typeof ZoneEmptyBehavior>>;
             responsiveCollapse: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof ResponsiveCollapseMode>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof ResponsiveCollapseMode>>]>>;
         }, z.core.$strip>>;
@@ -732,7 +713,6 @@ export declare const NavigationLayoutSchema: z.ZodObject<{
             ephemeral?: boolean;
         }>>, unknown>>;
         appearance: z.ZodOptional<z.ZodObject<{
-            split: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof SplitAppearance>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof SplitAppearance>>]>>;
             overlay: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof OverlayAppearance>, z.ZodRecord<z.ZodEnum<typeof ViewportBreakpoint> & z.core.$partial, z.ZodEnum<typeof OverlayAppearance>>]>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
@@ -748,13 +728,11 @@ export declare const NavigationLayoutSchema: z.ZodObject<{
         }>>, unknown>>;
     }, z.core.$strip>>;
     split: z.ZodOptional<z.ZodObject<{
-        autoSplit: z.ZodDefault<z.ZodBoolean>;
         ratio: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
         orientation: z.ZodDefault<z.ZodEnum<typeof DisplayDirection>>;
         resizable: z.ZodDefault<z.ZodBoolean>;
         companion: z.ZodOptional<z.ZodObject<{
             ratio: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
-            orientation: z.ZodDefault<z.ZodEnum<typeof DisplayDirection>>;
             resizable: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
@@ -785,4 +763,129 @@ export declare const NavigationLayoutSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type NavigationLayout = z.infer<typeof NavigationLayoutSchema>;
 /** @wildo_source:part:end saas.models.navigation.layout */
+/**
+ * The transition verb of a {@link TransitionConfig}, which is either the verb itself or an object
+ * carrying it alongside its modifiers.
+ *
+ * Exported from here rather than from the frontend resolver — where all three of these lived until
+ * 2026-09-25 — because they are pure functions of an AUTHORING type this file owns, and the layout
+ * diagnostics below need them too. A second copy beside the diagnostics would have been a second
+ * answer to "what verb did the author write".
+ */
+export declare function getTransitionVerb(config: TransitionConfig): NavigationTransition;
+/** Whether a {@link TransitionConfig} carries the `ephemeral` modifier. */
+export declare function isEphemeralTransition(config: TransitionConfig): boolean;
+/** Whether a {@link TransitionConfig} carries the `persistent` modifier — a split that targets companion. */
+export declare function isPersistentTransition(config: TransitionConfig): boolean;
+/**
+ * What a {@link NavigationLayoutDiagnostic} says about the layout.
+ *
+ * `ERROR` means the runtime will do something the author did not ask for — a declared split that
+ * silently becomes a dialog. `WARNING` means a declaration is INERT: nothing goes wrong, and the
+ * author believes they configured something they did not.
+ *
+ * Neither is fatal. See {@link collectNavigationLayoutDiagnostics} for why.
+ */
+export declare enum NavigationLayoutDiagnosticSeverity {
+    ERROR = "error",
+    WARNING = "warning"
+}
+/** The closed set of layout defects {@link collectNavigationLayoutDiagnostics} can recognise. */
+export declare enum NavigationLayoutDiagnosticCode {
+    /**
+     * A `SPLIT` is declared somewhere in the layout and NO adjacent zone is declared, so every one of
+     * those splits silently becomes an overlay.
+     *
+     * The single most surprising thing in the navigation runtime, and it was documented in
+     * `NavigationLayoutSchema`'s own JSDoc — *"`NavigationTransition.SPLIT` in a layout without
+     * secondary will escalate to overlay"* — while nothing checked it. An author gets a dialog where
+     * they asked for a pane, with no diagnostic anywhere.
+     */
+    SPLIT_WITHOUT_ADJACENT_ZONE = "split-without-adjacent-zone",
+    /**
+     * A `persistent` split is declared and no `companion` zone exists. A persistent split targets
+     * companion SPECIFICALLY — it does not fall back to secondary — so it escalates to an overlay even
+     * in a layout that declares a perfectly good `secondary`.
+     *
+     * Separate from {@link SPLIT_WITHOUT_ADJACENT_ZONE} because the remedy is different and the
+     * surprise is larger: the author is looking at a declared pane and cannot see why their split
+     * refuses to use it.
+     */
+    PERSISTENT_SPLIT_WITHOUT_COMPANION = "persistent-split-without-companion",
+    /**
+     * `minWidth`, `maxWidth`, `onEmpty` or `responsiveCollapse` declared on PRIMARY, where every one of
+     * them is inert: primary never collapses, never empties and takes the remaining space.
+     *
+     * `ZoneConfigSchema`'s JSDoc states this — *"Setting these on primary has no effect"* — so the
+     * diagnostic enforces a rule the contract already carries.
+     */
+    INERT_PRIMARY_ZONE_FIELD = "inert-primary-zone-field",
+    /** A zone whose `minWidth` exceeds its `maxWidth`. The drag constraints cannot both be honoured. */
+    ZONE_WIDTH_BOUNDS_INVERTED = "zone-width-bounds-inverted"
+}
+/** One finding about an authored {@link NavigationLayout}. */
+export interface NavigationLayoutDiagnostic {
+    code: NavigationLayoutDiagnosticCode;
+    severity: NavigationLayoutDiagnosticSeverity;
+    /** Where in the layout, as an authoring path: `zones.primary.transitions.read`. */
+    path: string;
+    /** What is wrong and what the runtime will do instead. */
+    message: string;
+    /** The edit that fixes it. Always present — a diagnostic with no remedy is a complaint. */
+    remedy: string;
+}
+/**
+ * Read an authored {@link NavigationLayout} and report what the runtime will silently do differently
+ * from what it says.
+ *
+ * ## Why this exists
+ *
+ * Nothing validated a navigation layout beyond its SHAPE until 2026-09-25 — there was no `refine`
+ * anywhere in this file — so three classes of declaration were accepted and quietly ignored. The
+ * escalation in {@link NavigationLayoutDiagnosticCode.SPLIT_WITHOUT_ADJACENT_ZONE} is the expensive
+ * one: it is documented in this file's own prose and produces a dialog where a pane was asked for.
+ *
+ * ## It REPORTS; it never refuses, and that is deliberate
+ *
+ * A `superRefine` on {@link NavigationLayoutSchema} was the obvious implementation and was rejected.
+ * The layout is parsed inside `AppConfiguration_Frontend_Schema` at application boot, so a refusal
+ * there would stop an application from starting over a split that renders as a dialog — wildly
+ * disproportionate, and the exact shape `.claude/rules/application-creation-directive.md` forbids:
+ * a mechanism that refuses rather than marks. The precedent for the chosen shape is the
+ * administrative-continuity boot report, which is non-fatal for the same reason.
+ *
+ * Pure, so it is equally usable from a test, a CLI check or a future authoring-time gate.
+ *
+ * ## What this CANNOT see, and what covers it instead
+ *
+ * A layout is not the only place a `SPLIT` is declared. A resource's `navigationOverrides`, a
+ * relationship transition and an action presentation all reach the resolver, and none of them is in
+ * the layout — so the only real instance of `SPLIT_WITHOUT_ADJACENT_ZONE` in this repository was
+ * INVISIBLE here: Wonder Todos declared `SPLIT` on `todos.READ` against a single-zone layout, every
+ * drill-in became a dialog for the life of the declaration, and this check reported clean.
+ *
+ * Re-deriving that population statically would mean a second enumeration of every tier that can
+ * produce a SPLIT, kept in step with the resolver by hand. The resolver has already decided, so the
+ * report lives at the DECISION instead: `useNavigationController` warns once per resource+operation
+ * when a resolution carries `SPLIT_ESCALATED_NO_ADJACENT_ZONE`. That covers every tier by
+ * construction and cannot drift. This function keeps the half a boot check can answer — the layout's
+ * own declarations, before anything navigates.
+ *
+ * ## The rule that was considered and REJECTED, because it fires on correct code
+ *
+ * *"A `secondary` zone is declared and no transition in the layout resolves to `SPLIT`, so the pane
+ * can never open."* It reads like the natural companion to the rules above and it is wrong: Wonder
+ * CRM declares `secondary` while `zones.primary.transitions.read` is `PUSH`, and its pane is reached
+ * ONLY by `deal`'s per-resource `navigationOverrides: [{ transition: SPLIT }]` — a declaration this
+ * function cannot see, because it lives in a resource's ui-behavior rather than in the layout. The
+ * rule would have reported the repository's one deliberate two-zone application as misconfigured.
+ *
+ * A checker that mostly reports correct code trains its reader to skim the reports that matter.
+ *
+ * (That rationale also mis-named Wonder CRM as "the repository's one deliberate two-zone
+ * application". The workbench declares `zones.secondary` too — and unlike CRM its pane IS reached
+ * from the layout, so the rejected rule would not have fired on it. The rejection stands on CRM
+ * alone.)
+ */
+export declare function collectNavigationLayoutDiagnostics(layout: NavigationLayout): NavigationLayoutDiagnostic[];
 //# sourceMappingURL=navigation.shared.schemas.d.ts.map

package/dist/esm/config/frontend/navigation.shared.schemas.d.ts.map

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