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

package/dist/esm/core/billing/useBillingPlanChange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingPlanChange.js","sourceRoot":"","sources":["../../../../../src/core/billing/useBillingPlanChange.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\nimport { currencyMinorUnitDecimals } from '@wildo-ai/zod-decorators';\nimport { BillingStateSlice, type InvoicePreview } from '@wildo-ai/saas-models';\nimport type { BillingContextType, BillingPlanChangeTarget, BillingPlanChangePreviewResponse } from './BillingContext';\n\nexport enum BillingPlanChangePhase {\n  IDLE = 'idle',\n  PREVIEWING = 'previewing',\n  READY = 'ready',\n  CONFIRMING = 'confirming',\n  FAILED = 'failed',\n}\n\ntype Selection = { target: BillingPlanChangeTarget; scopeIdentity: string };\nexport type BillingPlanChangeState =\n  | { phase: BillingPlanChangePhase.IDLE }\n  | (Selection & { phase: BillingPlanChangePhase.PREVIEWING | BillingPlanChangePhase.FAILED })\n  | (Selection & { phase: BillingPlanChangePhase.READY | BillingPlanChangePhase.CONFIRMING; response: BillingPlanChangePreviewResponse; preview: InvoicePreview; hasError?: boolean });\n\n/** A provider amount uses the currency's own minor units, not an authored price's arbitrary scale. */\nexport function invoicePreviewForDisplay(response: BillingPlanChangePreviewResponse): InvoicePreview {\n  const currency = response.currency.toUpperCase();\n  const decimals = currencyMinorUnitDecimals(currency);\n  if (decimals === undefined || !Number.isSafeInteger(response.amount) || response.lineItems.some(item => !Number.isSafeInteger(item.amount))) {\n    throw new Error('The invoice estimate contains unsupported monetary values.');\n  }\n  return {\n    amount: { amount: BigInt(response.amount), currency, decimals },\n    lineItems: response.lineItems.map(item => ({ ...item, amount: { amount: BigInt(item.amount), currency, decimals } })),\n    periodStart: response.periodStart,\n    periodEnd: response.periodEnd,\n  };\n}\n\n/** Owns the composed selection flow. A server token is only usable with its original selection.\n * Request generation fences late responses; cancellation aborts only a preview, never an accepted mutation.\n * A failed confirmation retains its token for the server's idempotent retry path.\n */\nexport function useBillingPlanChange(billing: BillingContextType | undefined) {\n  const [state, setState] = useState<BillingPlanChangeState>({ phase: BillingPlanChangePhase.IDLE });\n  const generation = useRef(0);\n  const pendingPreview = useRef<AbortController | null>(null);\n  const confirming = useRef(false);\n  const stateRef = useRef(state);\n  stateRef.current = state;\n  const scopeIdentity = JSON.stringify([billing?.currentScope, billing?.billingAccount?._id, billing?.subscription?._id]);\n  const currentIdentity = useRef(scopeIdentity);\n  currentIdentity.current = scopeIdentity;\n  const ready = !!billing?.isEnabled && [BillingStateSlice.BILLING_ACCOUNT, BillingStateSlice.SUBSCRIPTION, BillingStateSlice.PRODUCTS, BillingStateSlice.PRICES].every(billing.isSliceAvailable);\n\n  useEffect(() => {\n    generation.current += 1;\n    pendingPreview.current?.abort();\n    setState({ phase: BillingPlanChangePhase.IDLE });\n    return () => { generation.current += 1; pendingPreview.current?.abort(); };\n  }, [scopeIdentity]);\n\n  // A same-scope refresh cannot revoke an already submitted confirmation or its retry token.\n  // Availability controls whether another dispatch is allowed; it is not evidence that the\n  // provider did not accept the first one. The server validates the quote's semantic basis.\n  useEffect(() => {\n    const current = stateRef.current;\n    if (confirming.current || (current.phase === BillingPlanChangePhase.READY && current.hasError)) return;\n    if (!ready) {\n      generation.current += 1;\n      pendingPreview.current?.abort();\n      setState({ phase: BillingPlanChangePhase.IDLE });\n    }\n  }, [ready]);\n\n  const select = useCallback(async (target: BillingPlanChangeTarget) => {\n    if (!billing || !ready || !billing.subscription || confirming.current) return;\n    const requestGeneration = ++generation.current;\n    pendingPreview.current?.abort();\n    const controller = new AbortController();\n    pendingPreview.current = controller;\n    const selection = { target, scopeIdentity };\n    setState({ ...selection, phase: BillingPlanChangePhase.PREVIEWING });\n    try {\n      const response = await billing.previewPlanChange(target, { signal: controller.signal });\n      const preview = invoicePreviewForDisplay(response);\n      if (!response.previewToken) throw new Error('The invoice estimate has no confirmation binding.');\n      if (generation.current !== requestGeneration || currentIdentity.current !== scopeIdentity) return;\n      setState({ ...selection, phase: BillingPlanChangePhase.READY, response, preview });\n    } catch {\n      if (generation.current !== requestGeneration || controller.signal.aborted) return;\n      setState({ ...selection, phase: BillingPlanChangePhase.FAILED });\n    }\n  }, [billing, ready, scopeIdentity]);\n\n  const cancel = useCallback(() => {\n    if (confirming.current) return;\n    generation.current += 1;\n    pendingPreview.current?.abort();\n    setState({ phase: BillingPlanChangePhase.IDLE });\n  }, []);\n\n  const confirm = useCallback(async () => {\n    const current = stateRef.current;\n    if (!billing || !ready || confirming.current || current.phase !== BillingPlanChangePhase.READY || current.scopeIdentity !== currentIdentity.current) return;\n    confirming.current = true;\n    const requestGeneration = generation.current;\n    setState({ ...current, phase: BillingPlanChangePhase.CONFIRMING, hasError: false });\n    try {\n      await billing.confirmPlanChange({ ...current.target, previewToken: current.response.previewToken });\n      if (generation.current === requestGeneration) setState({ phase: BillingPlanChangePhase.IDLE });\n    } catch {\n      if (generation.current === requestGeneration) setState({ ...current, phase: BillingPlanChangePhase.READY, hasError: true });\n    } finally {\n      confirming.current = false;\n    }\n  }, [billing, ready]);\n\n  return { state, select, cancel, confirm };\n}\n"]}

package/dist/esm/core/billing/useSafeBillingActionExecutor.d.ts

@@ -1,6 +1,9 @@
 /**
  * Wrap billing UI actions so user-triggered checkout / portal failures surface
  * through the notification system instead of becoming dropped promise rejections.
+ *
+ * The notification shows the failure's localized words, never the error's own `message` (a reference key
+ * for a backend rejection, developer text for a thrown `Error`).
  */
 export declare function useSafeBillingActionExecutor(): (action: () => Promise<void>) => void;
 //# sourceMappingURL=useSafeBillingActionExecutor.d.ts.map

package/dist/esm/core/billing/useSafeBillingActionExecutor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSafeBillingActionExecutor.d.ts","sourceRoot":"","sources":["../../../../src/core/billing/useSafeBillingActionExecutor.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAWpF"}
+{"version":3,"file":"useSafeBillingActionExecutor.d.ts","sourceRoot":"","sources":["../../../../../src/core/billing/useSafeBillingActionExecutor.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAgB,4BAA4B,IAAI,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CASpF"}

package/dist/esm/core/billing/useSafeBillingActionExecutor.js

@@ -1,18 +1,20 @@
 import { useCallback } from 'react';
 import { useNotification } from '../../core/events/useNotification.js';
+import { useUserFacingErrorMessage } from '../../core/errors/useUserFacingErrorMessage.js';
 /**
  * Wrap billing UI actions so user-triggered checkout / portal failures surface
  * through the notification system instead of becoming dropped promise rejections.
+ *
+ * The notification shows the failure's localized words, never the error's own `message` (a reference key
+ * for a backend rejection, developer text for a thrown `Error`).
  */
 export function useSafeBillingActionExecutor() {
     const { notifyError } = useNotification();
+    const toUserFacingErrorMessage = useUserFacingErrorMessage();
     return useCallback((action) => {
         void action().catch((error) => {
-            const message = error instanceof Error
-                ? error.message
-                : 'An unexpected billing error occurred';
-            notifyError(message);
+            notifyError(toUserFacingErrorMessage(error));
         });
-    }, [notifyError]);
+    }, [notifyError, toUserFacingErrorMessage]);
 }
 //# sourceMappingURL=useSafeBillingActionExecutor.js.map

package/dist/esm/core/billing/useSafeBillingActionExecutor.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSafeBillingActionExecutor.js","sourceRoot":"","sources":["../../../../src/core/billing/useSafeBillingActionExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAElF;;;GAGG;AACH,MAAM,UAAU,4BAA4B;IAC1C,MAAM,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,CAAC;IAE1C,OAAO,WAAW,CAAC,CAAC,MAA2B,EAAE,EAAE;QACjD,KAAK,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK;gBACpC,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,sCAAsC,CAAC;YAC3C,WAAW,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;AACpB,CAAC","sourcesContent":["import { useCallback } from 'react';\nimport { useNotification } from '~wildo-frontend-lib/core/events/useNotification';\n\n/**\n * Wrap billing UI actions so user-triggered checkout / portal failures surface\n * through the notification system instead of becoming dropped promise rejections.\n */\nexport function useSafeBillingActionExecutor(): (action: () => Promise<void>) => void {\n  const { notifyError } = useNotification();\n\n  return useCallback((action: () => Promise<void>) => {\n    void action().catch((error: unknown) => {\n      const message = error instanceof Error\n        ? error.message\n        : 'An unexpected billing error occurred';\n      notifyError(message);\n    });\n  }, [notifyError]);\n}\n"]}
+{"version":3,"file":"useSafeBillingActionExecutor.js","sourceRoot":"","sources":["../../../../../src/core/billing/useSafeBillingActionExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAEtG;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B;IAC1C,MAAM,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,CAAC;IAC1C,MAAM,wBAAwB,GAAG,yBAAyB,EAAE,CAAC;IAE7D,OAAO,WAAW,CAAC,CAAC,MAA2B,EAAE,EAAE;QACjD,KAAK,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACrC,WAAW,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,WAAW,EAAE,wBAAwB,CAAC,CAAC,CAAC;AAC9C,CAAC","sourcesContent":["import { useCallback } from 'react';\nimport { useNotification } from '~wildo-frontend-lib/core/events/useNotification';\nimport { useUserFacingErrorMessage } from '~wildo-frontend-lib/core/errors/useUserFacingErrorMessage';\n\n/**\n * Wrap billing UI actions so user-triggered checkout / portal failures surface\n * through the notification system instead of becoming dropped promise rejections.\n *\n * The notification shows the failure's localized words, never the error's own `message` (a reference key\n * for a backend rejection, developer text for a thrown `Error`).\n */\nexport function useSafeBillingActionExecutor(): (action: () => Promise<void>) => void {\n  const { notifyError } = useNotification();\n  const toUserFacingErrorMessage = useUserFacingErrorMessage();\n\n  return useCallback((action: () => Promise<void>) => {\n    void action().catch((error: unknown) => {\n      notifyError(toUserFacingErrorMessage(error));\n    });\n  }, [notifyError, toUserFacingErrorMessage]);\n}\n"]}

package/dist/esm/core/branding/useBrandIdentity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBrandIdentity.d.ts","sourceRoot":"","sources":["../../../../src/core/branding/useBrandIdentity.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EAGhB,MAAM,uBAAuB,CAAC;AAK/B;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,oEAAoE;IACpE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,aAAa,CAqDrF"}
+{"version":3,"file":"useBrandIdentity.d.ts","sourceRoot":"","sources":["../../../../../src/core/branding/useBrandIdentity.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EAGhB,MAAM,uBAAuB,CAAC;AAK/B;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,oEAAoE;IACpE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,aAAa,CAqDrF"}

package/dist/esm/core/branding/useBrandIdentity.js.map

@@ -1 +1 @@
-{"version":3,"file":"useBrandIdentity.js","sourceRoot":"","sources":["../../../../src/core/branding/useBrandIdentity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAElB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAwD1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAmC,EAAE;IACpE,MAAM,EAAE,WAAW,GAAG,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC3G,MAAM,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,CAAC;IACvC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,KAAK,EAAE,CAAC;IAE1C,8EAA8E;IAC9E,EAAE;IACF,4EAA4E;IAC5E,wEAAwE;IACxE,uEAAuE;IACvE,yEAAyE;IACzE,sCAAsC;IACtC,EAAE;IACF,6EAA6E;IAC7E,+DAA+D;IAC/D,sFAAsF;IACtF,yEAAyE;IACzE,4EAA4E;IAC5E,eAAe;IACf,EAAE;IACF,+EAA+E;IAC/E,wEAAwE;IACxE,4EAA4E;IAC5E,0EAA0E;IAC1E,yDAAyD;IACzD,EAAE;IACF,+EAA+E;IAC/E,2EAA2E;IAC3E,6EAA6E;IAC7E,+EAA+E;IAC/E,MAAM,WAAW,GAAoC,aAAa;QAChE,CAAC,CAAC,aAAa,CAAC,WAAW;QAC3B,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC;IAC1B,MAAM,IAAI,GAAG,aAAa;QACxB,CAAC,CAAC,aAAa,CAAC,IAAI;QACpB,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,WAAW,IAAI,SAAS,CAAC,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAEjF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;QAC5B,IAAI,CAAC,WAAW,EAAE,MAAM;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,iBAAiB,CAAC,WAAW,EAAE;YACpC,WAAW;YACX,uEAAuE;YACvE,wEAAwE;YACxE,wEAAwE;YACxE,wEAAwE;YACxE,qEAAqE;YACrE,aAAa;YACb,KAAK,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC;YACvE,OAAO;SACR,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAEvD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AAClF,CAAC","sourcesContent":["import { useMemo } from 'react';\n\nimport {\n  BrandAssetComposition,\n  BrandAssetPurpose,\n  BrandAssetTheme,\n  resolveBrandAsset,\n  type RuntimeBrandAsset,\n} from '@wildo-ai/saas-models';\n\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\n\n/**\n * The application's brand identity as a shell surface needs it: a display name\n * plus the URL of the brand asset matching the requested composition and the\n * ACTIVE light/dark theme.\n */\nexport interface BrandIdentity {\n  /**\n   * Human-readable application name — `appIdentity.displayName` when authored,\n   * falling back to the technical `appName` (which the config schema requires,\n   * so this is always non-empty).\n   */\n  name: string;\n  /**\n   * Resolved brand-asset URL, or `undefined` when the application has generated\n   * no brand yet. Consumers must degrade gracefully rather than render a broken\n   * image (the schema documents brand assets as absent until generated).\n   */\n  logoUrl?: string;\n  /**\n   * Composition of the asset that was ACTUALLY resolved — which may differ from\n   * the one requested. `resolveBrandAsset`'s last fallback rung matches any\n   * composition at `(DEFAULT, PRIMARY)`, so an application whose brand contains\n   * no `SYMBOL` (a wordmark-only identity is a supported brand shape) yields its\n   * `WORDMARK`/`LOCKUP` master here.\n   *\n   * Surfaces MUST branch on this rather than assume they got what they asked\n   * for: a wordmark or lockup already CONTAINS the application name, so\n   * rendering it beside a name label duplicates the name, and squeezing a wide\n   * asset into a square icon slot letterboxes it.\n   */\n  logoComposition?: BrandAssetComposition;\n}\n\nexport interface UseBrandIdentityOptions {\n  /**\n   * Which brand composition the surface wants. Defaults to\n   * {@link BrandAssetComposition.SYMBOL} — the right choice for any surface that\n   * renders the application NAME as text beside the mark, because a `LOCKUP`\n   * already contains the name and would duplicate it.\n   */\n  composition?: BrandAssetComposition;\n  /** Asset purpose. Defaults to {@link BrandAssetPurpose.PRIMARY}. */\n  purpose?: BrandAssetPurpose;\n  /**\n   * PINS the mark variant instead of following the active UI theme — e.g.\n   * {@link BrandAssetTheme.MONOCHROME} for the single-colour mark, or\n   * {@link BrandAssetTheme.DEFAULT} to keep the colour mark on a dark shell.\n   *\n   * Omitted (the default) means ADAPTIVE: dark UI asks for `DARK`, light UI for\n   * `LIGHT`, both falling back through `DEFAULT` inside `resolveBrandAsset`.\n   */\n  theme?: BrandAssetTheme;\n}\n\n/**\n * @wildo_source:part:start saas.frontend.brand-identity facet:layer:frontend facet:audience:app-developer\n *\n * Reads the application's brand identity for a shell surface.\n *\n * Owns ONE decision every brand-rendering surface would otherwise re-derive:\n * how the active UI theme maps onto {@link BrandAssetTheme} (dark UI → `DARK`,\n * light UI → `LIGHT`), unless the caller PINS a variant via `options.theme`.\n * `resolveBrandAsset` then applies the framework's documented fallback chain, so\n * an app that generated only a default-theme mark still gets it in dark mode\n * instead of nothing.\n *\n * Must be used inside `ApplicationMainProvider` (it reads the application\n * config) and inside `UIProvider` (it reads the resolved dark-mode state).\n *\n * ## Two things a caller does not have to solve\n *\n * The MARK VARIANT follows the active UI theme by default — dark UI asks for the dark mark, light UI\n * for the light one, each falling back through the default. So an application that generated only a\n * default-theme mark still gets it in dark mode rather than nothing. Pin `options.theme` only when a\n * surface genuinely needs a fixed variant, such as a monochrome mark.\n *\n * WHOSE identity is rendered is decided here too, and it matters for any frontend that observes an\n * application rather than being one — a creation tool, a back office. Such a frontend declares\n * `shellIdentity` in its frontend configuration, and that identity WINS over the application config\n * it reads. Without that precedence the tool renders its customer's brand as its own, because there\n * is exactly one application-config endpoint and it belongs to the application.\n *\n * @wildo_source:part:end saas.frontend.brand-identity\n */\nexport function useBrandIdentity(options: UseBrandIdentityOptions = {}): BrandIdentity {\n  const { composition = BrandAssetComposition.SYMBOL, purpose = BrandAssetPurpose.PRIMARY, theme } = options;\n  const { appConfig } = useApplication();\n  const { isDark, shellIdentity } = useUI();\n\n  // ── WHOSE identity is this? ────────────────────────────────────────────────\n  //\n  // A frontend that declares `shellIdentity` in its frontend configuration is\n  // saying \"I am not the application I talk to\" — a creation tool, a back\n  // office, anything observing an application rather than being one. Its\n  // identity WINS here, because the alternative is silently presenting the\n  // customer's brand as the tool's own.\n  //\n  // That is not hypothetical. There is exactly ONE application-config endpoint\n  // and it belongs to the application: the dev companion answers\n  // `GET /api/v1/application-config?frontendServiceName=application-creation-workbench`\n  // with `appIdentity.displayName: \"Wonder CRM\"` (measured 2026-08-31), so\n  // without this precedence the workbench's brand header reads as the managed\n  // application.\n  //\n  // The two halves are taken TOGETHER, never mixed. A shell that declared a name\n  // but no assets must render its name UNMARKED rather than borrowing the\n  // application's mark — a foreign logo beside your own name is worse than no\n  // logo, and it is the exact mismatch this field exists to prevent. So the\n  // assets are read from whichever side supplied the name.\n  //\n  // `appConfig` is non-optional on the context type and the provider only mounts\n  // past the bootstrap gate, so it is read directly; `appIdentity` keeps its\n  // optional read because the runtime payload has historically been treated as\n  // possibly-absent (see `ApplicationMainContext`'s own `appIdentity?.version`).\n  const brandAssets: RuntimeBrandAsset[] | undefined = shellIdentity\n    ? shellIdentity.brandAssets\n    : appConfig.brandAssets;\n  const name = shellIdentity\n    ? shellIdentity.name\n    : (appConfig.appIdentity?.displayName || appConfig.appIdentity?.appName || '');\n\n  const resolved = useMemo(() => {\n    if (!brandAssets?.length) return undefined;\n    return resolveBrandAsset(brandAssets, {\n      composition,\n      // An explicit `theme` pins the variant (monochrome, or a forced side).\n      // Otherwise ADAPTIVE: LIGHT rather than DEFAULT for a light UI, because\n      // `resolveBrandAsset` tries the requested theme first and falls back to\n      // DEFAULT on its own — so asking for LIGHT strictly adds the ability to\n      // honor a light-specific asset, while asking for DEFAULT could never\n      // reach one.\n      theme: theme ?? (isDark ? BrandAssetTheme.DARK : BrandAssetTheme.LIGHT),\n      purpose,\n    });\n  }, [brandAssets, composition, purpose, theme, isDark]);\n\n  return { name, logoUrl: resolved?.url, logoComposition: resolved?.composition };\n}\n"]}
+{"version":3,"file":"useBrandIdentity.js","sourceRoot":"","sources":["../../../../../src/core/branding/useBrandIdentity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAElB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAwD1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAmC,EAAE;IACpE,MAAM,EAAE,WAAW,GAAG,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC3G,MAAM,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,CAAC;IACvC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,KAAK,EAAE,CAAC;IAE1C,8EAA8E;IAC9E,EAAE;IACF,4EAA4E;IAC5E,wEAAwE;IACxE,uEAAuE;IACvE,yEAAyE;IACzE,sCAAsC;IACtC,EAAE;IACF,6EAA6E;IAC7E,+DAA+D;IAC/D,sFAAsF;IACtF,yEAAyE;IACzE,4EAA4E;IAC5E,eAAe;IACf,EAAE;IACF,+EAA+E;IAC/E,wEAAwE;IACxE,4EAA4E;IAC5E,0EAA0E;IAC1E,yDAAyD;IACzD,EAAE;IACF,+EAA+E;IAC/E,2EAA2E;IAC3E,6EAA6E;IAC7E,+EAA+E;IAC/E,MAAM,WAAW,GAAoC,aAAa;QAChE,CAAC,CAAC,aAAa,CAAC,WAAW;QAC3B,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC;IAC1B,MAAM,IAAI,GAAG,aAAa;QACxB,CAAC,CAAC,aAAa,CAAC,IAAI;QACpB,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,WAAW,IAAI,SAAS,CAAC,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAEjF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;QAC5B,IAAI,CAAC,WAAW,EAAE,MAAM;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,iBAAiB,CAAC,WAAW,EAAE;YACpC,WAAW;YACX,uEAAuE;YACvE,wEAAwE;YACxE,wEAAwE;YACxE,wEAAwE;YACxE,qEAAqE;YACrE,aAAa;YACb,KAAK,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC;YACvE,OAAO;SACR,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAEvD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AAClF,CAAC","sourcesContent":["import { useMemo } from 'react';\n\nimport {\n  BrandAssetComposition,\n  BrandAssetPurpose,\n  BrandAssetTheme,\n  resolveBrandAsset,\n  type RuntimeBrandAsset,\n} from '@wildo-ai/saas-models';\n\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\n\n/**\n * The application's brand identity as a shell surface needs it: a display name\n * plus the URL of the brand asset matching the requested composition and the\n * ACTIVE light/dark theme.\n */\nexport interface BrandIdentity {\n  /**\n   * Human-readable application name — `appIdentity.displayName` when authored,\n   * falling back to the technical `appName` (which the config schema requires,\n   * so this is always non-empty).\n   */\n  name: string;\n  /**\n   * Resolved brand-asset URL, or `undefined` when the application has generated\n   * no brand yet. Consumers must degrade gracefully rather than render a broken\n   * image (the schema documents brand assets as absent until generated).\n   */\n  logoUrl?: string;\n  /**\n   * Composition of the asset that was ACTUALLY resolved — which may differ from\n   * the one requested. `resolveBrandAsset`'s last fallback rung matches any\n   * composition at `(DEFAULT, PRIMARY)`, so an application whose brand contains\n   * no `SYMBOL` (a wordmark-only identity is a supported brand shape) yields its\n   * `WORDMARK`/`LOCKUP` master here.\n   *\n   * Surfaces MUST branch on this rather than assume they got what they asked\n   * for: a wordmark or lockup already CONTAINS the application name, so\n   * rendering it beside a name label duplicates the name, and squeezing a wide\n   * asset into a square icon slot letterboxes it.\n   */\n  logoComposition?: BrandAssetComposition;\n}\n\nexport interface UseBrandIdentityOptions {\n  /**\n   * Which brand composition the surface wants. Defaults to\n   * {@link BrandAssetComposition.SYMBOL} — the right choice for any surface that\n   * renders the application NAME as text beside the mark, because a `LOCKUP`\n   * already contains the name and would duplicate it.\n   */\n  composition?: BrandAssetComposition;\n  /** Asset purpose. Defaults to {@link BrandAssetPurpose.PRIMARY}. */\n  purpose?: BrandAssetPurpose;\n  /**\n   * PINS the mark variant instead of following the active UI theme — e.g.\n   * {@link BrandAssetTheme.MONOCHROME} for the single-colour mark, or\n   * {@link BrandAssetTheme.DEFAULT} to keep the colour mark on a dark shell.\n   *\n   * Omitted (the default) means ADAPTIVE: dark UI asks for `DARK`, light UI for\n   * `LIGHT`, both falling back through `DEFAULT` inside `resolveBrandAsset`.\n   */\n  theme?: BrandAssetTheme;\n}\n\n/**\n * @wildo_source:part:start saas.frontend.brand-identity facet:layer:frontend facet:audience:app-developer\n *\n * Reads the application's brand identity for a shell surface.\n *\n * Owns ONE decision every brand-rendering surface would otherwise re-derive:\n * how the active UI theme maps onto {@link BrandAssetTheme} (dark UI → `DARK`,\n * light UI → `LIGHT`), unless the caller PINS a variant via `options.theme`.\n * `resolveBrandAsset` then applies the framework's documented fallback chain, so\n * an app that generated only a default-theme mark still gets it in dark mode\n * instead of nothing.\n *\n * Must be used inside `ApplicationMainProvider` (it reads the application\n * config) and inside `UIProvider` (it reads the resolved dark-mode state).\n *\n * ## Two things a caller does not have to solve\n *\n * The MARK VARIANT follows the active UI theme by default — dark UI asks for the dark mark, light UI\n * for the light one, each falling back through the default. So an application that generated only a\n * default-theme mark still gets it in dark mode rather than nothing. Pin `options.theme` only when a\n * surface genuinely needs a fixed variant, such as a monochrome mark.\n *\n * WHOSE identity is rendered is decided here too, and it matters for any frontend that observes an\n * application rather than being one — a creation tool, a back office. Such a frontend declares\n * `shellIdentity` in its frontend configuration, and that identity WINS over the application config\n * it reads. Without that precedence the tool renders its customer's brand as its own, because there\n * is exactly one application-config endpoint and it belongs to the application.\n *\n * @wildo_source:part:end saas.frontend.brand-identity\n */\nexport function useBrandIdentity(options: UseBrandIdentityOptions = {}): BrandIdentity {\n  const { composition = BrandAssetComposition.SYMBOL, purpose = BrandAssetPurpose.PRIMARY, theme } = options;\n  const { appConfig } = useApplication();\n  const { isDark, shellIdentity } = useUI();\n\n  // ── WHOSE identity is this? ────────────────────────────────────────────────\n  //\n  // A frontend that declares `shellIdentity` in its frontend configuration is\n  // saying \"I am not the application I talk to\" — a creation tool, a back\n  // office, anything observing an application rather than being one. Its\n  // identity WINS here, because the alternative is silently presenting the\n  // customer's brand as the tool's own.\n  //\n  // That is not hypothetical. There is exactly ONE application-config endpoint\n  // and it belongs to the application: the dev companion answers\n  // `GET /api/v1/application-config?frontendServiceName=application-creation-workbench`\n  // with `appIdentity.displayName: \"Wonder CRM\"` (measured 2026-08-31), so\n  // without this precedence the workbench's brand header reads as the managed\n  // application.\n  //\n  // The two halves are taken TOGETHER, never mixed. A shell that declared a name\n  // but no assets must render its name UNMARKED rather than borrowing the\n  // application's mark — a foreign logo beside your own name is worse than no\n  // logo, and it is the exact mismatch this field exists to prevent. So the\n  // assets are read from whichever side supplied the name.\n  //\n  // `appConfig` is non-optional on the context type and the provider only mounts\n  // past the bootstrap gate, so it is read directly; `appIdentity` keeps its\n  // optional read because the runtime payload has historically been treated as\n  // possibly-absent (see `ApplicationMainContext`'s own `appIdentity?.version`).\n  const brandAssets: RuntimeBrandAsset[] | undefined = shellIdentity\n    ? shellIdentity.brandAssets\n    : appConfig.brandAssets;\n  const name = shellIdentity\n    ? shellIdentity.name\n    : (appConfig.appIdentity?.displayName || appConfig.appIdentity?.appName || '');\n\n  const resolved = useMemo(() => {\n    if (!brandAssets?.length) return undefined;\n    return resolveBrandAsset(brandAssets, {\n      composition,\n      // An explicit `theme` pins the variant (monochrome, or a forced side).\n      // Otherwise ADAPTIVE: LIGHT rather than DEFAULT for a light UI, because\n      // `resolveBrandAsset` tries the requested theme first and falls back to\n      // DEFAULT on its own — so asking for LIGHT strictly adds the ability to\n      // honor a light-specific asset, while asking for DEFAULT could never\n      // reach one.\n      theme: theme ?? (isDark ? BrandAssetTheme.DARK : BrandAssetTheme.LIGHT),\n      purpose,\n    });\n  }, [brandAssets, composition, purpose, theme, isDark]);\n\n  return { name, logoUrl: resolved?.url, logoComposition: resolved?.composition };\n}\n"]}

package/dist/esm/core/branding/useBrandPresentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBrandPresentation.d.ts","sourceRoot":"","sources":["../../../../src/core/branding/useBrandPresentation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,8FAA8F;IAC9F,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB,+FAA+F;IAC/F,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,GAAG,iBAAiB,CAyB3F"}
+{"version":3,"file":"useBrandPresentation.d.ts","sourceRoot":"","sources":["../../../../../src/core/branding/useBrandPresentation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,8FAA8F;IAC9F,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB,+FAA+F;IAC/F,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,GAAG,iBAAiB,CAyB3F"}

package/dist/esm/core/branding/useBrandPresentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"useBrandPresentation.js","sourceRoot":"","sources":["../../../../src/core/branding/useBrandPresentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAuC9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAmC;IACtE,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,CAAC;IAClC,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC;IAElC;;;OAGG;IACH,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,SAAS,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjD,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAE/D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;IAChD,MAAM,eAAe,GACnB,OAAO,IAAI,QAAQ,EAAE,eAAe,KAAK,SAAS,IAAI,QAAQ,CAAC,eAAe,KAAK,qBAAqB,CAAC,MAAM,CAAC;IAElH,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACtC,OAAO;QACP,eAAe;QACf,OAAO,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QACtC,WAAW;KACZ,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback, useEffect, useState } from 'react';\n\nimport { BrandAssetComposition } from '@wildo-ai/saas-models';\n\nimport type { BrandIdentity } from './useBrandIdentity';\n\n/**\n * A brand identity, reduced to the decisions every surface that RENDERS one must take.\n *\n * {@link BrandIdentity} answers \"what did the brand resolve to\". This answers \"what may I therefore\n * draw\", which is a different question with four traps in it — and each trap is a visible defect\n * rather than a crash, so nothing fails loudly when a surface gets one wrong.\n */\nexport interface BrandPresentation {\n  /** The application (or shell) name. May be empty only if the identity itself carries none. */\n  name: string;\n  /** The mark's URL — present only when {@link hasMark} is true. */\n  logoUrl?: string;\n  /**\n   * A mark resolved AND has not failed to load. Distinct from `logoUrl !== undefined`: a URL that\n   * 404s is a resolved mark that must not be drawn.\n   */\n  hasMark: boolean;\n  /**\n   * The resolved mark CONTAINS the name — a `WORDMARK` or `LOCKUP`, which the resolver's last\n   * fallback rung can return for an application that generated no `SYMBOL`.\n   *\n   * Surfaces must not print the name beside such a mark: it would appear twice. They must also give\n   * it intrinsic width rather than a square slot, or it letterboxes.\n   */\n  markCarriesName: boolean;\n  /** Nothing identifiable at all — no usable mark and no name. Render no identity affordance. */\n  isEmpty: boolean;\n  /**\n   * Wire to the `<img>`'s `onError`. A brand asset URL comes from configuration and can point at a\n   * file that is not there; without this the surface renders a browser broken-image glyph where the\n   * product identity should be.\n   */\n  onMarkError: () => void;\n}\n\n/**\n * Turns a resolved {@link BrandIdentity} into the presentation decisions a surface needs.\n *\n * ## Why this is shared rather than re-derived\n *\n * The sidebar's `BRAND_HEADER` worked these out first, and every one of them is a rule about the\n * DATA rather than about a sidebar: a wordmark contains the name; a failed load must degrade to the\n * no-mark presentation instead of a broken image; the failure latch must reset when the URL changes\n * or a light/dark switch leaves the surface permanently markless; an identity with neither mark nor\n * name must render nothing rather than an empty click target.\n *\n * A second surface presenting a brand needs the same four answers, so they live here once. What is\n * NOT here is anything about layout — a rail collapses, a login page does not — because that is the\n * part that genuinely differs per surface.\n */\nexport function useBrandPresentation(identity: BrandIdentity | undefined): BrandPresentation {\n  const logoUrl = identity?.logoUrl;\n  const name = identity?.name ?? '';\n\n  /*\n   * Reset on every URL change, not only on mount. A light/dark switch resolves a DIFFERENT asset,\n   * and a latch left set from the previous one would suppress a mark that loads perfectly.\n   */\n  const [markFailed, setMarkFailed] = useState(false);\n  useEffect(() => setMarkFailed(false), [logoUrl]);\n\n  const onMarkError = useCallback(() => setMarkFailed(true), []);\n\n  const hasMark = Boolean(logoUrl) && !markFailed;\n  const markCarriesName =\n    hasMark && identity?.logoComposition !== undefined && identity.logoComposition !== BrandAssetComposition.SYMBOL;\n\n  return {\n    name,\n    logoUrl: hasMark ? logoUrl : undefined,\n    hasMark,\n    markCarriesName,\n    isEmpty: !hasMark && name.length === 0,\n    onMarkError,\n  };\n}\n"]}
+{"version":3,"file":"useBrandPresentation.js","sourceRoot":"","sources":["../../../../../src/core/branding/useBrandPresentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAuC9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAmC;IACtE,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,CAAC;IAClC,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC;IAElC;;;OAGG;IACH,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,SAAS,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjD,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAE/D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;IAChD,MAAM,eAAe,GACnB,OAAO,IAAI,QAAQ,EAAE,eAAe,KAAK,SAAS,IAAI,QAAQ,CAAC,eAAe,KAAK,qBAAqB,CAAC,MAAM,CAAC;IAElH,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACtC,OAAO;QACP,eAAe;QACf,OAAO,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QACtC,WAAW;KACZ,CAAC;AACJ,CAAC","sourcesContent":["import { useCallback, useEffect, useState } from 'react';\n\nimport { BrandAssetComposition } from '@wildo-ai/saas-models';\n\nimport type { BrandIdentity } from './useBrandIdentity';\n\n/**\n * A brand identity, reduced to the decisions every surface that RENDERS one must take.\n *\n * {@link BrandIdentity} answers \"what did the brand resolve to\". This answers \"what may I therefore\n * draw\", which is a different question with four traps in it — and each trap is a visible defect\n * rather than a crash, so nothing fails loudly when a surface gets one wrong.\n */\nexport interface BrandPresentation {\n  /** The application (or shell) name. May be empty only if the identity itself carries none. */\n  name: string;\n  /** The mark's URL — present only when {@link hasMark} is true. */\n  logoUrl?: string;\n  /**\n   * A mark resolved AND has not failed to load. Distinct from `logoUrl !== undefined`: a URL that\n   * 404s is a resolved mark that must not be drawn.\n   */\n  hasMark: boolean;\n  /**\n   * The resolved mark CONTAINS the name — a `WORDMARK` or `LOCKUP`, which the resolver's last\n   * fallback rung can return for an application that generated no `SYMBOL`.\n   *\n   * Surfaces must not print the name beside such a mark: it would appear twice. They must also give\n   * it intrinsic width rather than a square slot, or it letterboxes.\n   */\n  markCarriesName: boolean;\n  /** Nothing identifiable at all — no usable mark and no name. Render no identity affordance. */\n  isEmpty: boolean;\n  /**\n   * Wire to the `<img>`'s `onError`. A brand asset URL comes from configuration and can point at a\n   * file that is not there; without this the surface renders a browser broken-image glyph where the\n   * product identity should be.\n   */\n  onMarkError: () => void;\n}\n\n/**\n * Turns a resolved {@link BrandIdentity} into the presentation decisions a surface needs.\n *\n * ## Why this is shared rather than re-derived\n *\n * The sidebar's `BRAND_HEADER` worked these out first, and every one of them is a rule about the\n * DATA rather than about a sidebar: a wordmark contains the name; a failed load must degrade to the\n * no-mark presentation instead of a broken image; the failure latch must reset when the URL changes\n * or a light/dark switch leaves the surface permanently markless; an identity with neither mark nor\n * name must render nothing rather than an empty click target.\n *\n * A second surface presenting a brand needs the same four answers, so they live here once. What is\n * NOT here is anything about layout — a rail collapses, a login page does not — because that is the\n * part that genuinely differs per surface.\n */\nexport function useBrandPresentation(identity: BrandIdentity | undefined): BrandPresentation {\n  const logoUrl = identity?.logoUrl;\n  const name = identity?.name ?? '';\n\n  /*\n   * Reset on every URL change, not only on mount. A light/dark switch resolves a DIFFERENT asset,\n   * and a latch left set from the previous one would suppress a mark that loads perfectly.\n   */\n  const [markFailed, setMarkFailed] = useState(false);\n  useEffect(() => setMarkFailed(false), [logoUrl]);\n\n  const onMarkError = useCallback(() => setMarkFailed(true), []);\n\n  const hasMark = Boolean(logoUrl) && !markFailed;\n  const markCarriesName =\n    hasMark && identity?.logoComposition !== undefined && identity.logoComposition !== BrandAssetComposition.SYMBOL;\n\n  return {\n    name,\n    logoUrl: hasMark ? logoUrl : undefined,\n    hasMark,\n    markCarriesName,\n    isEmpty: !hasMark && name.length === 0,\n    onMarkError,\n  };\n}\n"]}

package/dist/esm/core/commons/devices.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"devices.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/commons/devices.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,oBAAY,UAAU;IACpB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,GAAG,QAAQ;CACZ;AAED;;GAEG;AACH,oBAAY,QAAQ;IAClB,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,eAAO,MAAM,gBAAgB;;;;;;iBAM3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAG1D,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC"}
+{"version":3,"file":"devices.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/commons/devices.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,oBAAY,UAAU;IACpB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,GAAG,QAAQ;CACZ;AAED;;GAEG;AACH,oBAAY,QAAQ;IAClB,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,eAAO,MAAM,gBAAgB;;;;;;iBAM3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAG1D,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC"}

package/dist/esm/core/commons/devices.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"devices.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/commons/devices.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,yBAAW,CAAA;AACb,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,6BAAiB,CAAA;IACjB,uBAAW,CAAA;IACX,yBAAa,CAAA;AACf,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IACtD,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;IACnB,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;IAC1D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC","sourcesContent":["/**\n * Device Shared Schemas\n * \n * Centralized device-related schemas and enums\n */\n\nimport { z } from 'zod';\n\n/**\n * Device type enum for authentication, sessions, and DTOs\n */\nexport enum DeviceType {\n  DESKTOP = 'desktop',\n  MOBILE = 'mobile',\n  TABLET = 'tablet',\n  API = 'api'\n}\n\n/**\n * SameSite cookie option enum\n */\nexport enum SameSite {\n  STRICT = 'strict',\n  LAX = 'lax',\n  NONE = 'none'\n}\n\nexport const DeviceInfoSchema = z.object({\n  userAgent: z.string().min(1, 'User agent is required'),\n  ipAddress: z.ipv4(),\n  deviceType: z.enum(DeviceType).default(DeviceType.DESKTOP),\n  location: z.string().optional(),\n  fingerprint: z.string().optional()\n});\n\nexport type DeviceInfo = z.infer<typeof DeviceInfoSchema>;\n\n// Type exports\nexport type DeviceTypeValue = DeviceType; \n"]}
+{"version":3,"file":"devices.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/commons/devices.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,yBAAW,CAAA;AACb,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,6BAAiB,CAAA;IACjB,uBAAW,CAAA;IACX,yBAAa,CAAA;AACf,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IACtD,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;IACnB,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;IAC1D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC","sourcesContent":["/**\n * Device Shared Schemas\n * \n * Centralized device-related schemas and enums\n */\n\nimport { z } from 'zod';\n\n/**\n * Device type enum for authentication, sessions, and DTOs\n */\nexport enum DeviceType {\n  DESKTOP = 'desktop',\n  MOBILE = 'mobile',\n  TABLET = 'tablet',\n  API = 'api'\n}\n\n/**\n * SameSite cookie option enum\n */\nexport enum SameSite {\n  STRICT = 'strict',\n  LAX = 'lax',\n  NONE = 'none'\n}\n\nexport const DeviceInfoSchema = z.object({\n  userAgent: z.string().min(1, 'User agent is required'),\n  ipAddress: z.ipv4(),\n  deviceType: z.enum(DeviceType).default(DeviceType.DESKTOP),\n  location: z.string().optional(),\n  fingerprint: z.string().optional()\n});\n\nexport type DeviceInfo = z.infer<typeof DeviceInfoSchema>;\n\n// Type exports\nexport type DeviceTypeValue = DeviceType; \n"]}

package/dist/esm/core/commons/local-storage.frontend.schemas.d.ts

@@ -22,6 +22,21 @@ export declare enum RUNTIME_SCOPED_STORAGE_KEYS {
      */
     CLIENT_INSTANCE_ID = "clientInstanceId"
 }
+/**
+ * Web-storage keys that always live in `sessionStorage` — scoped to ONE tab and gone when it closes.
+ *
+ * Its own registry rather than members of {@link LOCAL_STORAGE_KEYS}, for the same reason
+ * {@link RUNTIME_SCOPED_STORAGE_KEYS} is: the storage AREA is the key's contract. A value that must die with
+ * the tab written through a localStorage helper would silently outlive it on every tab of the origin.
+ */
+export declare enum SESSION_STORAGE_KEYS {
+    /**
+     * The MFA session this tab still owes a second factor on, so a reload of the enrollment gate can recover
+     * it (#1068). Written and forgotten ONLY through `pending-mfa-session-storage.frontend.utils.ts`, which
+     * records why this lives in `sessionStorage` rather than the URL or `localStorage`.
+     */
+    PENDING_MFA_SESSION = "wildo-pending-mfa-session"
+}
 export declare enum LOCAL_STORAGE_KEYS {
     JWT_TOKEN = "jwtToken",
     REFRESH_TOKEN = "refreshToken",

package/dist/esm/core/commons/local-storage.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-storage.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/commons/local-storage.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,oBAAY,2BAA2B;IACrC;;;;OAIG;IACH,kBAAkB,qBAAqB;CACxC;AAED,oBAAY,kBAAkB;IAC5B,SAAS,aAA4B;IACrC,aAAa,iBAA4B;IACzC,QAAQ,aAA6B;IACrC,uBAAuB,0BAA2B;IAClD,YAAY,gBAA4B;IACxC,yBAAyB,oCAAoC;IAC7D;;;;;;OAMG;IACH,iBAAiB,4BAAmC;IACpD;;;;;;;;OAQG;IACH,iBAAiB,4BAAmC;IACpD,iBAAiB,oBAA2B;IAC5C,uBAAuB,0BAA2B;CACnD;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAO1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,IAOhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,IAOpD,CAAC"}
+{"version":3,"file":"local-storage.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/commons/local-storage.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,oBAAY,2BAA2B;IACrC;;;;OAIG;IACH,kBAAkB,qBAAqB;CACxC;AAED;;;;;;GAMG;AACH,oBAAY,oBAAoB;IAC9B;;;;OAIG;IACH,mBAAmB,8BAA8B;CAClD;AAED,oBAAY,kBAAkB;IAC5B,SAAS,aAA4B;IACrC,aAAa,iBAA4B;IACzC,QAAQ,aAA6B;IACrC,uBAAuB,0BAA2B;IAClD,YAAY,gBAA4B;IACxC,yBAAyB,oCAAoC;IAC7D;;;;;;OAMG;IACH,iBAAiB,4BAAmC;IACpD;;;;;;;;OAQG;IACH,iBAAiB,4BAAmC;IACpD,iBAAiB,oBAA2B;IAC5C,uBAAuB,0BAA2B;CACnD;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAO1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,IAOhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,IAOpD,CAAC"}

package/dist/esm/core/commons/local-storage.frontend.schemas.js

@@ -23,6 +23,22 @@ export var RUNTIME_SCOPED_STORAGE_KEYS;
      */
     RUNTIME_SCOPED_STORAGE_KEYS["CLIENT_INSTANCE_ID"] = "clientInstanceId";
 })(RUNTIME_SCOPED_STORAGE_KEYS || (RUNTIME_SCOPED_STORAGE_KEYS = {}));
+/**
+ * Web-storage keys that always live in `sessionStorage` — scoped to ONE tab and gone when it closes.
+ *
+ * Its own registry rather than members of {@link LOCAL_STORAGE_KEYS}, for the same reason
+ * {@link RUNTIME_SCOPED_STORAGE_KEYS} is: the storage AREA is the key's contract. A value that must die with
+ * the tab written through a localStorage helper would silently outlive it on every tab of the origin.
+ */
+export var SESSION_STORAGE_KEYS;
+(function (SESSION_STORAGE_KEYS) {
+    /**
+     * The MFA session this tab still owes a second factor on, so a reload of the enrollment gate can recover
+     * it (#1068). Written and forgotten ONLY through `pending-mfa-session-storage.frontend.utils.ts`, which
+     * records why this lives in `sessionStorage` rather than the URL or `localStorage`.
+     */
+    SESSION_STORAGE_KEYS["PENDING_MFA_SESSION"] = "wildo-pending-mfa-session";
+})(SESSION_STORAGE_KEYS || (SESSION_STORAGE_KEYS = {}));
 export var LOCAL_STORAGE_KEYS;
 (function (LOCAL_STORAGE_KEYS) {
     LOCAL_STORAGE_KEYS["JWT_TOKEN"] = "jwtToken";

package/dist/esm/core/commons/local-storage.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-storage.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/commons/local-storage.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,2BAOX;AAPD,WAAY,2BAA2B;IACrC;;;;OAIG;IACH,sEAAuC,CAAA;AACzC,CAAC,EAPW,2BAA2B,KAA3B,2BAA2B,QAOtC;AAED,MAAM,CAAN,IAAY,kBA2BX;AA3BD,WAAY,kBAAkB;IAC5B,4CAAqC,CAAA;IACrC,oDAAyC,CAAA;IACzC,2CAAqC,CAAA;IACrC,uEAAkD,CAAA;IAClD,kDAAwC,CAAA;IACxC,mFAA6D,CAAA;IAC7D;;;;;;OAMG;IACH,mEAAoD,CAAA;IACpD;;;;;;;;OAQG;IACH,mEAAoD,CAAA;IACpD,2DAA4C,CAAA;IAC5C,uEAAkD,CAAA;AACpD,CAAC,EA3BW,kBAAkB,KAAlB,kBAAkB,QA2B7B;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAiB,EAAE;IAChE,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAE,KAAa,EAAQ,EAAE;IACtE,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAQ,EAAE;IAC1D,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,CAAC;QACH,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC,CAAC","sourcesContent":["/**\n * Single abstraction point for persistent key-value storage in the browser.\n *\n * Backed by `window.localStorage`. The framework targets web stacks\n * exclusively (the engine's value prop is sharing TypeScript across\n * browser-rendered surfaces — SAAS_APP, STATIC_WEBSITE, TECH_DOC), so\n * there is no native secure-storage variant to swap in.\n */\n\n/**\n * Web-storage keys whose STORAGE AREA is chosen at runtime rather than fixed.\n *\n * Kept separate from {@link LOCAL_STORAGE_KEYS} instead of merged into it: that enum is the registry of\n * keys that always live in `localStorage`, and a key which may live in either area is a different thing.\n * Merging them would make the enum's name a lie for one member — the kind of convenience merge the\n * framework's design rules exist to prevent.\n */\nexport enum RUNTIME_SCOPED_STORAGE_KEYS {\n  /**\n   * The client-install identifier. Lives in `sessionStorage` or `localStorage` depending on the\n   * application's authored `compliance.clientInstanceIdScope`, and in NEITHER when that is `DISABLED`\n   * (the default). Owned by `client-instance-id.frontend.service.ts`.\n   */\n  CLIENT_INSTANCE_ID = 'clientInstanceId',\n}\n\nexport enum LOCAL_STORAGE_KEYS {\n  JWT_TOKEN                = 'jwtToken',\n  REFRESH_TOKEN            = 'refreshToken',\n  LANGUAGE                 = 'language',\n  CURRENT_ORGANIZATION_ID  = 'currentOrganizationId',\n  SCOPE_VALUES             = 'scopeValues',\n  SIDEBAR_SECTION_COLLAPSED = 'wildo-sidebar-section-collapsed',\n  /**\n   * Whole-sidebar rail collapse state (`'true'` / `'false'`). Desktop-only semantics:\n   * hydrated synchronously by `useSidebarBehavior`'s lazy `useState` initializer so the\n   * first paint already renders the persisted width (no expand→collapse flash), and\n   * written on every user toggle. The mobile drawer open/close state is deliberately\n   * NOT persisted — a drawer is transient by definition.\n   */\n  SIDEBAR_COLLAPSED        = 'wildo-sidebar-collapsed',\n  /**\n   * User-curated sidebar favorites: a JSON `string[]` of resolved launcher item\n   * ids (deterministic — `resolved-<resourceType>-<operation>-<variant>`,\n   * `resolved-view-<ref>`, …), in the order the user favorited them. Read by\n   * `useSidebarBehavior` to populate `SidebarSectionBehavior.FAVORITES`\n   * sections and written on every star toggle. Same machine-local persistence\n   * tier as `SIDEBAR_COLLAPSED`; per-user server-side sync (user preferences)\n   * is a deliberate future extension, not this key's job.\n   */\n  SIDEBAR_FAVORITES        = 'wildo-sidebar-favorites',\n  ANONYMOUS_USER_ID        = 'anonymousUserId',\n  ANONYMOUS_SESSION_TOKEN  = 'anonymousSessionToken',\n}\n\n/**\n * Get an item from localStorage\n * @param key - The key to retrieve\n * @returns The stored value or null if not found or unavailable\n */\nexport const getLocalStorageItem = (key: string): string | null => {\n  if (typeof window === 'undefined') return null;\n  try {\n    return localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Set an item in localStorage\n * @param key - The key to store\n * @param value - The value to store\n */\nexport const setLocalStorageItem = (key: string, value: string): void => {\n  if (typeof window === 'undefined') return;\n  try {\n    localStorage.setItem(key, value);\n  } catch {\n    // Silently fail if localStorage is not available\n  }\n};\n\n/**\n * Remove an item from localStorage\n * @param key - The key to remove\n */\nexport const removeLocalStorageItem = (key: string): void => {\n  if (typeof window === 'undefined') return;\n  try {\n    localStorage.removeItem(key);\n  } catch {\n    // Silently fail if localStorage is not available\n  }\n};\n"]}
+{"version":3,"file":"local-storage.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/commons/local-storage.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,2BAOX;AAPD,WAAY,2BAA2B;IACrC;;;;OAIG;IACH,sEAAuC,CAAA;AACzC,CAAC,EAPW,2BAA2B,KAA3B,2BAA2B,QAOtC;AAED;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC9B;;;;OAIG;IACH,yEAAiD,CAAA;AACnD,CAAC,EAPW,oBAAoB,KAApB,oBAAoB,QAO/B;AAED,MAAM,CAAN,IAAY,kBA2BX;AA3BD,WAAY,kBAAkB;IAC5B,4CAAqC,CAAA;IACrC,oDAAyC,CAAA;IACzC,2CAAqC,CAAA;IACrC,uEAAkD,CAAA;IAClD,kDAAwC,CAAA;IACxC,mFAA6D,CAAA;IAC7D;;;;;;OAMG;IACH,mEAAoD,CAAA;IACpD;;;;;;;;OAQG;IACH,mEAAoD,CAAA;IACpD,2DAA4C,CAAA;IAC5C,uEAAkD,CAAA;AACpD,CAAC,EA3BW,kBAAkB,KAAlB,kBAAkB,QA2B7B;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAiB,EAAE;IAChE,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAE,KAAa,EAAQ,EAAE;IACtE,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAQ,EAAE;IAC1D,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,CAAC;QACH,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC,CAAC","sourcesContent":["/**\n * Single abstraction point for persistent key-value storage in the browser.\n *\n * Backed by `window.localStorage`. The framework targets web stacks\n * exclusively (the engine's value prop is sharing TypeScript across\n * browser-rendered surfaces — SAAS_APP, STATIC_WEBSITE, TECH_DOC), so\n * there is no native secure-storage variant to swap in.\n */\n\n/**\n * Web-storage keys whose STORAGE AREA is chosen at runtime rather than fixed.\n *\n * Kept separate from {@link LOCAL_STORAGE_KEYS} instead of merged into it: that enum is the registry of\n * keys that always live in `localStorage`, and a key which may live in either area is a different thing.\n * Merging them would make the enum's name a lie for one member — the kind of convenience merge the\n * framework's design rules exist to prevent.\n */\nexport enum RUNTIME_SCOPED_STORAGE_KEYS {\n  /**\n   * The client-install identifier. Lives in `sessionStorage` or `localStorage` depending on the\n   * application's authored `compliance.clientInstanceIdScope`, and in NEITHER when that is `DISABLED`\n   * (the default). Owned by `client-instance-id.frontend.service.ts`.\n   */\n  CLIENT_INSTANCE_ID = 'clientInstanceId',\n}\n\n/**\n * Web-storage keys that always live in `sessionStorage` — scoped to ONE tab and gone when it closes.\n *\n * Its own registry rather than members of {@link LOCAL_STORAGE_KEYS}, for the same reason\n * {@link RUNTIME_SCOPED_STORAGE_KEYS} is: the storage AREA is the key's contract. A value that must die with\n * the tab written through a localStorage helper would silently outlive it on every tab of the origin.\n */\nexport enum SESSION_STORAGE_KEYS {\n  /**\n   * The MFA session this tab still owes a second factor on, so a reload of the enrollment gate can recover\n   * it (#1068). Written and forgotten ONLY through `pending-mfa-session-storage.frontend.utils.ts`, which\n   * records why this lives in `sessionStorage` rather than the URL or `localStorage`.\n   */\n  PENDING_MFA_SESSION = 'wildo-pending-mfa-session',\n}\n\nexport enum LOCAL_STORAGE_KEYS {\n  JWT_TOKEN                = 'jwtToken',\n  REFRESH_TOKEN            = 'refreshToken',\n  LANGUAGE                 = 'language',\n  CURRENT_ORGANIZATION_ID  = 'currentOrganizationId',\n  SCOPE_VALUES             = 'scopeValues',\n  SIDEBAR_SECTION_COLLAPSED = 'wildo-sidebar-section-collapsed',\n  /**\n   * Whole-sidebar rail collapse state (`'true'` / `'false'`). Desktop-only semantics:\n   * hydrated synchronously by `useSidebarBehavior`'s lazy `useState` initializer so the\n   * first paint already renders the persisted width (no expand→collapse flash), and\n   * written on every user toggle. The mobile drawer open/close state is deliberately\n   * NOT persisted — a drawer is transient by definition.\n   */\n  SIDEBAR_COLLAPSED        = 'wildo-sidebar-collapsed',\n  /**\n   * User-curated sidebar favorites: a JSON `string[]` of resolved launcher item\n   * ids (deterministic — `resolved-<resourceType>-<operation>-<variant>`,\n   * `resolved-view-<ref>`, …), in the order the user favorited them. Read by\n   * `useSidebarBehavior` to populate `SidebarSectionBehavior.FAVORITES`\n   * sections and written on every star toggle. Same machine-local persistence\n   * tier as `SIDEBAR_COLLAPSED`; per-user server-side sync (user preferences)\n   * is a deliberate future extension, not this key's job.\n   */\n  SIDEBAR_FAVORITES        = 'wildo-sidebar-favorites',\n  ANONYMOUS_USER_ID        = 'anonymousUserId',\n  ANONYMOUS_SESSION_TOKEN  = 'anonymousSessionToken',\n}\n\n/**\n * Get an item from localStorage\n * @param key - The key to retrieve\n * @returns The stored value or null if not found or unavailable\n */\nexport const getLocalStorageItem = (key: string): string | null => {\n  if (typeof window === 'undefined') return null;\n  try {\n    return localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Set an item in localStorage\n * @param key - The key to store\n * @param value - The value to store\n */\nexport const setLocalStorageItem = (key: string, value: string): void => {\n  if (typeof window === 'undefined') return;\n  try {\n    localStorage.setItem(key, value);\n  } catch {\n    // Silently fail if localStorage is not available\n  }\n};\n\n/**\n * Remove an item from localStorage\n * @param key - The key to remove\n */\nexport const removeLocalStorageItem = (key: string): void => {\n  if (typeof window === 'undefined') return;\n  try {\n    localStorage.removeItem(key);\n  } catch {\n    // Silently fail if localStorage is not available\n  }\n};\n"]}

package/dist/esm/core/commons/window-event.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"window-event.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/commons/window-event.frontend.schemas.ts"],"names":[],"mappings":"AAEA,oBAAY,mBAAmB;IAC7B,MAAM,WAAW;IACjB,iBAAiB,oBAAoB;IACrC,aAAa,kBAAkB;CAChC;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;CACnC,CAAA"}
+{"version":3,"file":"window-event.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/commons/window-event.frontend.schemas.ts"],"names":[],"mappings":"AAEA,oBAAY,mBAAmB;IAC7B,MAAM,WAAW;IACjB,iBAAiB,oBAAoB;IACrC,aAAa,kBAAkB;CAChC;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;CACnC,CAAA"}

package/dist/esm/core/commons/window-event.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"window-event.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/commons/window-event.frontend.schemas.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,wCAAiB,CAAA;IACjB,4DAAqC,CAAA;IACrC,sDAA+B,CAAA;AACjC,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B","sourcesContent":["\n\nexport enum WINDOW_EVENTS_SLUGS {\n  LOGOUT = 'logout',\n  RESET_ALL_CONTEXT = 'resetAllContext',\n  REFRESH_TOKEN = 'refresh_token',\n}\n\nexport type WindowEventHandler = {\n  slugs: WINDOW_EVENTS_SLUGS,\n  handler: (e: CustomEvent) => void,\n}"]}
+{"version":3,"file":"window-event.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/commons/window-event.frontend.schemas.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,wCAAiB,CAAA;IACjB,4DAAqC,CAAA;IACrC,sDAA+B,CAAA;AACjC,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B","sourcesContent":["\n\nexport enum WINDOW_EVENTS_SLUGS {\n  LOGOUT = 'logout',\n  RESET_ALL_CONTEXT = 'resetAllContext',\n  REFRESH_TOKEN = 'refresh_token',\n}\n\nexport type WindowEventHandler = {\n  slugs: WINDOW_EVENTS_SLUGS,\n  handler: (e: CustomEvent) => void,\n}"]}

package/dist/esm/core/companion/companion-exports.frontend.definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"companion-exports.frontend.definitions.d.ts","sourceRoot":"","sources":["../../../../src/core/companion/companion-exports.frontend.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,KAAK,EACV,4BAA4B,EAC5B,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAEpF;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB,CACvC,mBAAmB,GAAG,wBAAwB,EAC9C,uBAAuB,GAAG,yBAAyB,CAAC,kBAAkB,CAAC,EACvE,eAAe,GAAG,yBAAyB,CAAC,4BAA4B,CAAC,EACzE,kBAAkB,GAAG,yBAAyB,CAAC,aAAa,CAAC,EAC7D,gBAAgB,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,EAC/D,eAAe,GAAG,yBAAyB,CAAC,gBAAgB,CAAC,CAC7D,SAAQ,4BAA4B;IACpC,kBAAkB,EAAE,mBAAmB,CAAC;IACxC,sBAAsB,EAAE,uBAAuB,CAAC;IAChD,cAAc,EAAE,eAAe,CAAC;IAChC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,gBAAgB,CAAC;IAClC,qBAAqB,EAAE,MAAM,eAAe,CAAC;IAC7C,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACtD,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACvD"}
+{"version":3,"file":"companion-exports.frontend.definitions.d.ts","sourceRoot":"","sources":["../../../../../src/core/companion/companion-exports.frontend.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,KAAK,EACV,4BAA4B,EAC5B,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAEpF;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB,CACvC,mBAAmB,GAAG,wBAAwB,EAC9C,uBAAuB,GAAG,yBAAyB,CAAC,kBAAkB,CAAC,EACvE,eAAe,GAAG,yBAAyB,CAAC,4BAA4B,CAAC,EACzE,kBAAkB,GAAG,yBAAyB,CAAC,aAAa,CAAC,EAC7D,gBAAgB,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,EAC/D,eAAe,GAAG,yBAAyB,CAAC,gBAAgB,CAAC,CAC7D,SAAQ,4BAA4B;IACpC,kBAAkB,EAAE,mBAAmB,CAAC;IACxC,sBAAsB,EAAE,uBAAuB,CAAC;IAChD,cAAc,EAAE,eAAe,CAAC;IAChC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,gBAAgB,CAAC;IAClC,qBAAqB,EAAE,MAAM,eAAe,CAAC;IAC7C,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACtD,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACvD"}

package/dist/esm/core/companion/companion-exports.frontend.definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"companion-exports.frontend.definitions.js","sourceRoot":"","sources":["../../../../src/core/companion/companion-exports.frontend.definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { DesignSystemSourceConfig } from '@wildo-ai/presets-components-models';\nimport type {\n  RuntimeOwnerCompanionExports,\n  SharedSaaSModule,\n} from '@wildo-ai/saas-models';\nimport type { AppConfiguration_Frontend } from '../config/app-configuration-frontend.schemas';\nimport type { FrontendModule } from '../runtime/domain-module.frontend.definitions';\n\n/**\n * Introspection-safe frontend companion surface for application packages.\n *\n * Apps can keep authored config in app-local files while still exposing one\n * typed contract for companion/tooling consumers. The framework owns the shape;\n * each application only provides its concrete authored values.\n */\nexport interface FrontendCompanionExports<\n  TDesignSystemConfig = DesignSystemSourceConfig,\n  TNavigationLayoutConfig = AppConfiguration_Frontend['navigationLayout'],\n  TAppShellConfig = AppConfiguration_Frontend['appComponentsConfiguration'],\n  TSettingsHubConfig = AppConfiguration_Frontend['settingsHub'],\n  TErrorPageConfig = AppConfiguration_Frontend['errorPageConfig'],\n  THomeDefinition = AppConfiguration_Frontend['homeDefinition'],\n> extends RuntimeOwnerCompanionExports {\n  designSystemConfig: TDesignSystemConfig;\n  navigationLayoutConfig: TNavigationLayoutConfig;\n  appShellConfig: TAppShellConfig;\n  /**\n   * The application's authored settings rail.\n   *\n   * Optional so an application that has not yet authored one still satisfies the\n   * contract — the companion then plans no settings-hub label units, which is\n   * correct: an unplaced rail has no labels to generate.\n   */\n  settingsHubConfig?: TSettingsHubConfig;\n  errorPageConfig: TErrorPageConfig;\n  homeDefinitionFactory: () => THomeDefinition;\n  loadFrontendModules?: () => Promise<FrontendModule[]>;\n  loadSharedModules?: () => Promise<SharedSaaSModule[]>;\n}\n"]}
+{"version":3,"file":"companion-exports.frontend.definitions.js","sourceRoot":"","sources":["../../../../../src/core/companion/companion-exports.frontend.definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { DesignSystemSourceConfig } from '@wildo-ai/presets-components-models';\nimport type {\n  RuntimeOwnerCompanionExports,\n  SharedSaaSModule,\n} from '@wildo-ai/saas-models';\nimport type { AppConfiguration_Frontend } from '../config/app-configuration-frontend.schemas';\nimport type { FrontendModule } from '../runtime/domain-module.frontend.definitions';\n\n/**\n * Introspection-safe frontend companion surface for application packages.\n *\n * Apps can keep authored config in app-local files while still exposing one\n * typed contract for companion/tooling consumers. The framework owns the shape;\n * each application only provides its concrete authored values.\n */\nexport interface FrontendCompanionExports<\n  TDesignSystemConfig = DesignSystemSourceConfig,\n  TNavigationLayoutConfig = AppConfiguration_Frontend['navigationLayout'],\n  TAppShellConfig = AppConfiguration_Frontend['appComponentsConfiguration'],\n  TSettingsHubConfig = AppConfiguration_Frontend['settingsHub'],\n  TErrorPageConfig = AppConfiguration_Frontend['errorPageConfig'],\n  THomeDefinition = AppConfiguration_Frontend['homeDefinition'],\n> extends RuntimeOwnerCompanionExports {\n  designSystemConfig: TDesignSystemConfig;\n  navigationLayoutConfig: TNavigationLayoutConfig;\n  appShellConfig: TAppShellConfig;\n  /**\n   * The application's authored settings rail.\n   *\n   * Optional so an application that has not yet authored one still satisfies the\n   * contract — the companion then plans no settings-hub label units, which is\n   * correct: an unplaced rail has no labels to generate.\n   */\n  settingsHubConfig?: TSettingsHubConfig;\n  errorPageConfig: TErrorPageConfig;\n  homeDefinitionFactory: () => THomeDefinition;\n  loadFrontendModules?: () => Promise<FrontendModule[]>;\n  loadSharedModules?: () => Promise<SharedSaaSModule[]>;\n}\n"]}

package/dist/esm/core/components-registry/ComponentNotInjected.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentNotInjected.d.ts","sourceRoot":"","sources":["../../../../src/core/components-registry/ComponentNotInjected.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,yBAAyB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,aAAa,EAAE,aAAa,EAAE,EAAE,yBAAyB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA2BnH"}
+{"version":3,"file":"ComponentNotInjected.d.ts","sourceRoot":"","sources":["../../../../../src/core/components-registry/ComponentNotInjected.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,yBAAyB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,aAAa,EAAE,aAAa,EAAE,EAAE,yBAAyB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA2BnH"}

package/dist/esm/core/components-registry/ComponentNotInjected.js.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentNotInjected.js","sourceRoot":"","sources":["../../../../src/core/components-registry/ComponentNotInjected.tsx"],"names":[],"mappings":";AAQA,MAAM,UAAU,oBAAoB,CAAC,EAAE,aAAa,EAAE,aAAa,EAA6B;IAC9F,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC1C,OAAO,mBAAK,CAAC;IACf,CAAC;IAED,OAAO,CACL,eACE,KAAK,EAAE;YACL,MAAM,EAAE,oBAAoB;YAC5B,YAAY,EAAE,KAAK;YACnB,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,OAAO;YACf,eAAe,EAAE,SAAS;YAC1B,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,uBAAuB;SACpC,aAED,cAAK,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,uCAE9C,EACN,eAAK,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,aAC5C,2BAAS,aAAa,GAAU,QAAG,aAAa,kDAChC,sDAAqC,iCACjD,IACF,CACP,CAAC;AACJ,CAAC","sourcesContent":["import React from 'react';\n\ninterface ComponentNotInjectedProps {\n  componentType: string;\n  componentName: string;\n  [key: string]: unknown;\n}\n\nexport function ComponentNotInjected({ componentType, componentName }: ComponentNotInjectedProps): React.JSX.Element {\n  if (process.env.NODE_ENV === 'production') {\n    return <></>;\n  }\n\n  return (\n    <div\n      style={{\n        border: '2px dashed #ef4444',\n        borderRadius: '6px',\n        padding: '12px 16px',\n        margin: '4px 0',\n        backgroundColor: '#fef2f2',\n        color: '#991b1b',\n        fontSize: '13px',\n        fontFamily: 'system-ui, sans-serif',\n      }}\n    >\n      <div style={{ fontWeight: 600, marginBottom: '4px' }}>\n        Component not injected\n      </div>\n      <div style={{ fontSize: '12px', opacity: 0.8 }}>\n        <strong>{componentName}</strong> ({componentType}) has no registered preset.\n        Register it via <code>registerDefaultPresets()</code> in your app entry point.\n      </div>\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"ComponentNotInjected.js","sourceRoot":"","sources":["../../../../../src/core/components-registry/ComponentNotInjected.tsx"],"names":[],"mappings":";AAQA,MAAM,UAAU,oBAAoB,CAAC,EAAE,aAAa,EAAE,aAAa,EAA6B;IAC9F,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC1C,OAAO,mBAAK,CAAC;IACf,CAAC;IAED,OAAO,CACL,eACE,KAAK,EAAE;YACL,MAAM,EAAE,oBAAoB;YAC5B,YAAY,EAAE,KAAK;YACnB,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,OAAO;YACf,eAAe,EAAE,SAAS;YAC1B,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,uBAAuB;SACpC,aAED,cAAK,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,uCAE9C,EACN,eAAK,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,aAC5C,2BAAS,aAAa,GAAU,QAAG,aAAa,kDAChC,sDAAqC,iCACjD,IACF,CACP,CAAC;AACJ,CAAC","sourcesContent":["import React from 'react';\n\ninterface ComponentNotInjectedProps {\n  componentType: string;\n  componentName: string;\n  [key: string]: unknown;\n}\n\nexport function ComponentNotInjected({ componentType, componentName }: ComponentNotInjectedProps): React.JSX.Element {\n  if (process.env.NODE_ENV === 'production') {\n    return <></>;\n  }\n\n  return (\n    <div\n      style={{\n        border: '2px dashed #ef4444',\n        borderRadius: '6px',\n        padding: '12px 16px',\n        margin: '4px 0',\n        backgroundColor: '#fef2f2',\n        color: '#991b1b',\n        fontSize: '13px',\n        fontFamily: 'system-ui, sans-serif',\n      }}\n    >\n      <div style={{ fontWeight: 600, marginBottom: '4px' }}>\n        Component not injected\n      </div>\n      <div style={{ fontSize: '12px', opacity: 0.8 }}>\n        <strong>{componentName}</strong> ({componentType}) has no registered preset.\n        Register it via <code>registerDefaultPresets()</code> in your app entry point.\n      </div>\n    </div>\n  );\n}\n"]}

package/dist/esm/core/components-registry/assert-registry-completeness.frontend.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assert-registry-completeness.frontend.helper.d.ts","sourceRoot":"","sources":["../../../../src/core/components-registry/assert-registry-completeness.frontend.helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAuG5E,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,0BAA0B,CAoBxE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE;IACnD;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,0BAA0B,CAwB7B"}
+{"version":3,"file":"assert-registry-completeness.frontend.helper.d.ts","sourceRoot":"","sources":["../../../../../src/core/components-registry/assert-registry-completeness.frontend.helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AA4H5E,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,0BAA0B,CAoBxE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE;IACnD;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,0BAA0B,CAwB7B"}

package/dist/esm/core/components-registry/assert-registry-completeness.frontend.helper.js

@@ -23,8 +23,11 @@ const logger = LoggerFrontendService.getLogger();
  *
  *   (a) i18n-bundle-only — exists for `useI18n({ component })` lookup
  *       but is rendered via direct composition, not via `resolve()`.
- *   (b) framework-internal — rendered directly by framework code (e.g.
- *       flows-actors, guidance, progression, lifecycle), not swappable.
+ *   (b) framework-internal — the framework ships the implementation, so no
+ *       preset is registered and this check must not demand one. It does NOT
+ *       mean unswappable: a slot in this category may still consult the
+ *       registry first and fall back to its built-in (see the guidance
+ *       renderers below). Read each entry's own justification.
  *   (c) deprecated — superseded by another slot, kept only for migration.
  *   (d) dispatcher — meta-slot that resolves to one of several concrete
  *       slots at render time (HIGH_LEVEL_VIEWS_COMPOSITE etc.).
@@ -50,7 +53,20 @@ const KNOWN_NON_REGISTERED_COMPONENT_TYPES = new Set([
     FrontendComponentType.LOW_LEVEL_AI_EXECUTION_STREAM,
     FrontendComponentType.LOW_LEVEL_AI_ARTIFACT_BROWSER,
     FrontendComponentType.LOW_LEVEL_AI_AGENT_CONFIG,
-    // (b) framework-internal — Guidance renderers (engine/saas-frontend-lib/src/core/guidance/renderers/*)
+    /**
+     * (b) framework-internal — Guidance renderers
+     * (`engine/saas-frontend-lib/src/core/guidance/renderers/*`).
+     *
+     * Deny-listed because the ENGINE registers no preset for them: `GuidanceRenderer` ships working
+     * built-in implementations and falls back to them. That is why they belong here and why the
+     * check must not demand a registration.
+     *
+     * They are NOT unswappable, and this entry used to say they were. `GuidanceRenderer` resolves
+     * each element type through `GUIDANCE_ELEMENT_COMPONENT_TYPE` against this registry BEFORE its
+     * built-in map, so an application that registers a preset under `CorePresetNames.DEFAULT` for any
+     * of these types replaces that renderer — which is what the frontend-component specifications for
+     * these slots have always advertised.
+     */
     FrontendComponentType.GUIDANCE_CHECKLIST,
     FrontendComponentType.GUIDANCE_CHECKLIST_ITEM,
     FrontendComponentType.GUIDANCE_TOUR,
@@ -93,6 +109,10 @@ const KNOWN_NON_REGISTERED_COMPONENT_TYPES = new Set([
     FrontendComponentType.APP_LAYOUTS_INVITATIONS_SETTINGS,
     FrontendComponentType.APP_LAYOUTS_BILLING_SETTINGS,
     FrontendComponentType.APP_LAYOUTS_CONNECTED_ACCOUNTS_SETTINGS,
+    // (a) i18n-bundle-only — SurfaceErrorBoundary is rendered directly by `Surface` when the surface
+    // policy asks for a boundary, never resolved through the registry. The enum entry exists so the
+    // fallback's words are addressable labels.
+    FrontendComponentType.APP_LAYOUTS_SURFACE_ERROR_BOUNDARY,
     // (e) orphan — H-5: FK editing AND display both flow through the
     // dedicated RESOURCES_FIELDS_RESOURCE_REFERENCE preset (registered by
     // category EDIT/DISPLAY in register-framework-layouts.ts) so there is no

package/dist/esm/core/components-registry/assert-registry-completeness.frontend.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"assert-registry-completeness.frontend.helper.js","sourceRoot":"","sources":["../../../../src/core/components-registry/assert-registry-completeness.frontend.helper.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tier-1 Registration Completeness Check\n *\n * Validates that every `FrontendComponentType` value that should have a\n * registered preset (Tier-1 — DI/registry-resolved) actually has one.\n *\n * Tier-2 / framework-internal / dispatcher / i18n-bundle-only slots are\n * explicitly deny-listed below. Any new addition to the enum that does\n * NOT belong on that list MUST be registered, otherwise this check fails.\n *\n * See `.cursor/plans/compound-component-system.md` Section 15 for the\n * full Tier-1 vs Tier-2 model.\n */\n\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { ComponentRegistryService } from './component-registry.frontend.service';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\n\n/**\n * Enum entries that intentionally have NO registered preset.\n *\n * Each entry MUST have a one-line justification explaining why it is not\n * registered. Categories:\n *\n *   (a) i18n-bundle-only — exists for `useI18n({ component })` lookup\n *       but is rendered via direct composition, not via `resolve()`.\n *   (b) framework-internal — rendered directly by framework code (e.g.\n *       flows-actors, guidance, progression, lifecycle), not swappable.\n *   (c) deprecated — superseded by another slot, kept only for migration.\n *   (d) dispatcher — meta-slot that resolves to one of several concrete\n *       slots at render time (HIGH_LEVEL_VIEWS_COMPOSITE etc.).\n *   (e) orphan — historical leftover, kept on the enum for back-compat\n *       of i18n keys but no longer wired to any wrapper.\n */\nconst KNOWN_NON_REGISTERED_COMPONENT_TYPES: ReadonlySet<FrontendComponentType> = new Set([\n  // (a) i18n-bundle-only — ContentSectionContainer uses direct composition. (The\n  // SECTION / GROUP / LEGEND slots are now registered ContentSection primitives.)\n  FrontendComponentType.LOW_LEVEL_CONTENT_SECTION_CONTAINER,\n  // (a) i18n-bundle-only — used by OverlayContainer direct composition\n  FrontendComponentType.LOW_LEVEL_OVERLAY_CONTAINER,\n\n  // (b) framework-internal — Flows-Actors orchestration shells (engine/saas-frontend-lib/src/components/flows-actors/*)\n  FrontendComponentType.LOW_LEVEL_AI_FLOW_NODE,\n  FrontendComponentType.LOW_LEVEL_AI_FLOW_EXECUTION,\n  FrontendComponentType.LOW_LEVEL_AI_SYSTEM_CATALOG,\n  FrontendComponentType.LOW_LEVEL_AI_ACTOR,\n  FrontendComponentType.LOW_LEVEL_AI_EXECUTION_PLAN,\n  FrontendComponentType.LOW_LEVEL_AI_TASK_DETAIL,\n  FrontendComponentType.LOW_LEVEL_AI_TASK_MEMORY,\n  FrontendComponentType.LOW_LEVEL_AI_APPROVAL,\n  FrontendComponentType.LOW_LEVEL_AI_DECISION,\n  FrontendComponentType.LOW_LEVEL_AI_EXECUTION_STREAM,\n  FrontendComponentType.LOW_LEVEL_AI_ARTIFACT_BROWSER,\n  FrontendComponentType.LOW_LEVEL_AI_AGENT_CONFIG,\n\n  // (b) framework-internal — Guidance renderers (engine/saas-frontend-lib/src/core/guidance/renderers/*)\n  FrontendComponentType.GUIDANCE_CHECKLIST,\n  FrontendComponentType.GUIDANCE_CHECKLIST_ITEM,\n  FrontendComponentType.GUIDANCE_TOUR,\n  FrontendComponentType.GUIDANCE_TOOLTIP,\n  FrontendComponentType.GUIDANCE_MODAL,\n  FrontendComponentType.GUIDANCE_BANNER,\n  FrontendComponentType.GUIDANCE_ANNOUNCEMENT,\n  FrontendComponentType.GUIDANCE_BADGE,\n  FrontendComponentType.GUIDANCE_CARD,\n  FrontendComponentType.GUIDANCE_SURVEY,\n  FrontendComponentType.GUIDANCE_ONBOARDING_VIEW,\n\n  // (b) framework-internal — Progression renderers (engine/saas-frontend-lib/src/components/progression/*)\n  FrontendComponentType.PROGRESSION_MILESTONE_TRACKER,\n  FrontendComponentType.PROGRESSION_ACHIEVEMENT_BADGE,\n\n  // (b) framework-internal — Lifecycle renderers (composed directly in app shells)\n  FrontendComponentType.LIFECYCLE_HOME_ACTIVATION_PROGRESS,\n  FrontendComponentType.LIFECYCLE_HOME_WELCOME_BACK,\n  FrontendComponentType.LIFECYCLE_HOME_DASHBOARD,\n\n  // (d) dispatcher — meta-slots that resolve to a concrete view at render time\n  FrontendComponentType.HIGH_LEVEL_VIEWS_COMPOSITE,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_CHART,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_FULL_CUSTOM,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_FLOWS_ACTORS,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_EXECUTION,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_NOT_FOUND,\n\n  // (b) framework-internal — H-8: app-owned shell slots. The enum entry is\n  // kept so that (1) host apps can register their own preset implementation\n  // for the slot if/when they need it, and (2) i18n labels remain\n  // addressable. The framework itself does not ship a default preset because\n  // the layout shape is intentionally app-owned (test harness page, security\n  // settings page).\n  FrontendComponentType.APP_LAYOUTS_TEST_COMPONENT,\n  FrontendComponentType.APP_LAYOUTS_SECURITY_SETTINGS,\n  // The Settings Hub + its bespoke panels are composed by the navigation\n  // runtime (NavigationContentRenderer → SettingsHub) and the hub's own panel\n  // resolver, NOT the ComponentRegistry. Their enum entries exist for i18n\n  // label addressability + spec coverage; the framework ships no default preset.\n  FrontendComponentType.APP_LAYOUTS_SETTINGS_HUB,\n  FrontendComponentType.APP_LAYOUTS_APPEARANCE_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_INVITATIONS_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_BILLING_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_CONNECTED_ACCOUNTS_SETTINGS,\n\n  // (e) orphan — H-5: FK editing AND display both flow through the\n  // dedicated RESOURCES_FIELDS_RESOURCE_REFERENCE preset (registered by\n  // category EDIT/DISPLAY in register-framework-layouts.ts) so there is no\n  // separate FORM_FIELD / DISPLAY_FIELD wrapper to register. The enum\n  // entries are kept on the schema for consumers that key i18n labels off\n  // them; renaming has cross-package blast radius (presets, generated\n  // specs, locale bundles), so we treat them as documented orphans rather\n  // than removing them.\n  FrontendComponentType.LOW_LEVEL_FORM_FIELD_FOREIGN_KEY,\n  FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FOREIGN_KEY,\n]);\n\nexport interface RegistryCompletenessReport {\n  totalEnumValues: number;\n  registeredCount: number;\n  denyListedCount: number;\n  missing: FrontendComponentType[];\n}\n\n/**\n * Compute (without throwing) the set of enum entries that should be\n * registered but are not. Useful for tests and for the boot-time check.\n */\nexport function computeRegistryCompleteness(): RegistryCompletenessReport {\n  const allValues = Object.values(FrontendComponentType) as FrontendComponentType[];\n  const missing: FrontendComponentType[] = [];\n  let registeredCount = 0;\n\n  for (const type of allValues) {\n    if (KNOWN_NON_REGISTERED_COMPONENT_TYPES.has(type)) continue;\n    if (ComponentRegistryService.hasComponentType(type)) {\n      registeredCount += 1;\n    } else {\n      missing.push(type);\n    }\n  }\n\n  return {\n    totalEnumValues: allValues.length,\n    registeredCount,\n    denyListedCount: KNOWN_NON_REGISTERED_COMPONENT_TYPES.size,\n    missing,\n  };\n}\n\n/**\n * Boot-time guard.\n *\n * Call this once after every `registerDefaultPresets()` /\n * `registerFrameworkLayouts()` invocation completes during app startup.\n *\n * Behaviour:\n *  - In `development`: throws a hard error listing all missing entries.\n *    The developer must either register the missing component or add\n *    its enum value to `KNOWN_NON_REGISTERED_COMPONENT_TYPES` with a\n *    justification.\n *  - In `production`: logs a warning and returns. Avoids breaking a\n *    deployed app over a registration omission, but surfaces it loudly\n *    in monitoring.\n *\n * @returns the same report `computeRegistryCompleteness()` returned.\n */\nexport function assertRegistryCompleteness(options?: {\n  /**\n   * When true, throw even outside `development`. Useful for CI / unit\n   * tests that want a strict gate regardless of NODE_ENV.\n   */\n  strict?: boolean;\n}): RegistryCompletenessReport {\n  const report = computeRegistryCompleteness();\n\n  if (report.missing.length === 0) {\n    return report;\n  }\n\n  const message =\n    `[ComponentRegistry] Tier-1 completeness check failed: ${report.missing.length} ` +\n    `FrontendComponentType value(s) have no registered preset.\\n\\n` +\n    `Missing entries:\\n${report.missing.map(t => `  - ${t}`).join('\\n')}\\n\\n` +\n    `For each missing entry you must EITHER:\\n` +\n    `  (1) register a default preset in registerDefaultPresets() / registerFrameworkLayouts(); OR\\n` +\n    `  (2) add the enum value to KNOWN_NON_REGISTERED_COMPONENT_TYPES in ` +\n    `assert-registry-completeness.frontend.helper.ts with a one-line justification ` +\n    `(see compound-component-system.md Section 15 for the Tier-1 vs Tier-2 model).`;\n\n  const isDev = typeof process !== 'undefined' && process.env?.NODE_ENV === 'development';\n  if (options?.strict || isDev) {\n    throw new Error(message);\n  }\n\n  logger.warn('component-registry.completeness-check.failed', { message, missing: report.missing });\n  return report;\n}\n"]}
+{"version":3,"file":"assert-registry-completeness.frontend.helper.js","sourceRoot":"","sources":["../../../../../src/core/components-registry/assert-registry-completeness.frontend.helper.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tier-1 Registration Completeness Check\n *\n * Validates that every `FrontendComponentType` value that should have a\n * registered preset (Tier-1 — DI/registry-resolved) actually has one.\n *\n * Tier-2 / framework-internal / dispatcher / i18n-bundle-only slots are\n * explicitly deny-listed below. Any new addition to the enum that does\n * NOT belong on that list MUST be registered, otherwise this check fails.\n *\n * See `.cursor/plans/compound-component-system.md` Section 15 for the\n * full Tier-1 vs Tier-2 model.\n */\n\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { ComponentRegistryService } from './component-registry.frontend.service';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\n\n/**\n * Enum entries that intentionally have NO registered preset.\n *\n * Each entry MUST have a one-line justification explaining why it is not\n * registered. Categories:\n *\n *   (a) i18n-bundle-only — exists for `useI18n({ component })` lookup\n *       but is rendered via direct composition, not via `resolve()`.\n *   (b) framework-internal — the framework ships the implementation, so no\n *       preset is registered and this check must not demand one. It does NOT\n *       mean unswappable: a slot in this category may still consult the\n *       registry first and fall back to its built-in (see the guidance\n *       renderers below). Read each entry's own justification.\n *   (c) deprecated — superseded by another slot, kept only for migration.\n *   (d) dispatcher — meta-slot that resolves to one of several concrete\n *       slots at render time (HIGH_LEVEL_VIEWS_COMPOSITE etc.).\n *   (e) orphan — historical leftover, kept on the enum for back-compat\n *       of i18n keys but no longer wired to any wrapper.\n */\nconst KNOWN_NON_REGISTERED_COMPONENT_TYPES: ReadonlySet<FrontendComponentType> = new Set([\n  // (a) i18n-bundle-only — ContentSectionContainer uses direct composition. (The\n  // SECTION / GROUP / LEGEND slots are now registered ContentSection primitives.)\n  FrontendComponentType.LOW_LEVEL_CONTENT_SECTION_CONTAINER,\n  // (a) i18n-bundle-only — used by OverlayContainer direct composition\n  FrontendComponentType.LOW_LEVEL_OVERLAY_CONTAINER,\n\n  // (b) framework-internal — Flows-Actors orchestration shells (engine/saas-frontend-lib/src/components/flows-actors/*)\n  FrontendComponentType.LOW_LEVEL_AI_FLOW_NODE,\n  FrontendComponentType.LOW_LEVEL_AI_FLOW_EXECUTION,\n  FrontendComponentType.LOW_LEVEL_AI_SYSTEM_CATALOG,\n  FrontendComponentType.LOW_LEVEL_AI_ACTOR,\n  FrontendComponentType.LOW_LEVEL_AI_EXECUTION_PLAN,\n  FrontendComponentType.LOW_LEVEL_AI_TASK_DETAIL,\n  FrontendComponentType.LOW_LEVEL_AI_TASK_MEMORY,\n  FrontendComponentType.LOW_LEVEL_AI_APPROVAL,\n  FrontendComponentType.LOW_LEVEL_AI_DECISION,\n  FrontendComponentType.LOW_LEVEL_AI_EXECUTION_STREAM,\n  FrontendComponentType.LOW_LEVEL_AI_ARTIFACT_BROWSER,\n  FrontendComponentType.LOW_LEVEL_AI_AGENT_CONFIG,\n\n  /**\n   * (b) framework-internal — Guidance renderers\n   * (`engine/saas-frontend-lib/src/core/guidance/renderers/*`).\n   *\n   * Deny-listed because the ENGINE registers no preset for them: `GuidanceRenderer` ships working\n   * built-in implementations and falls back to them. That is why they belong here and why the\n   * check must not demand a registration.\n   *\n   * They are NOT unswappable, and this entry used to say they were. `GuidanceRenderer` resolves\n   * each element type through `GUIDANCE_ELEMENT_COMPONENT_TYPE` against this registry BEFORE its\n   * built-in map, so an application that registers a preset under `CorePresetNames.DEFAULT` for any\n   * of these types replaces that renderer — which is what the frontend-component specifications for\n   * these slots have always advertised.\n   */\n  FrontendComponentType.GUIDANCE_CHECKLIST,\n  FrontendComponentType.GUIDANCE_CHECKLIST_ITEM,\n  FrontendComponentType.GUIDANCE_TOUR,\n  FrontendComponentType.GUIDANCE_TOOLTIP,\n  FrontendComponentType.GUIDANCE_MODAL,\n  FrontendComponentType.GUIDANCE_BANNER,\n  FrontendComponentType.GUIDANCE_ANNOUNCEMENT,\n  FrontendComponentType.GUIDANCE_BADGE,\n  FrontendComponentType.GUIDANCE_CARD,\n  FrontendComponentType.GUIDANCE_SURVEY,\n  FrontendComponentType.GUIDANCE_ONBOARDING_VIEW,\n\n  // (b) framework-internal — Progression renderers (engine/saas-frontend-lib/src/components/progression/*)\n  FrontendComponentType.PROGRESSION_MILESTONE_TRACKER,\n  FrontendComponentType.PROGRESSION_ACHIEVEMENT_BADGE,\n\n  // (b) framework-internal — Lifecycle renderers (composed directly in app shells)\n  FrontendComponentType.LIFECYCLE_HOME_ACTIVATION_PROGRESS,\n  FrontendComponentType.LIFECYCLE_HOME_WELCOME_BACK,\n  FrontendComponentType.LIFECYCLE_HOME_DASHBOARD,\n\n  // (d) dispatcher — meta-slots that resolve to a concrete view at render time\n  FrontendComponentType.HIGH_LEVEL_VIEWS_COMPOSITE,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_CHART,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_FULL_CUSTOM,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_FLOWS_ACTORS,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_EXECUTION,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_NOT_FOUND,\n\n  // (b) framework-internal — H-8: app-owned shell slots. The enum entry is\n  // kept so that (1) host apps can register their own preset implementation\n  // for the slot if/when they need it, and (2) i18n labels remain\n  // addressable. The framework itself does not ship a default preset because\n  // the layout shape is intentionally app-owned (test harness page, security\n  // settings page).\n  FrontendComponentType.APP_LAYOUTS_TEST_COMPONENT,\n  FrontendComponentType.APP_LAYOUTS_SECURITY_SETTINGS,\n  // The Settings Hub + its bespoke panels are composed by the navigation\n  // runtime (NavigationContentRenderer → SettingsHub) and the hub's own panel\n  // resolver, NOT the ComponentRegistry. Their enum entries exist for i18n\n  // label addressability + spec coverage; the framework ships no default preset.\n  FrontendComponentType.APP_LAYOUTS_SETTINGS_HUB,\n  FrontendComponentType.APP_LAYOUTS_APPEARANCE_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_INVITATIONS_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_BILLING_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_CONNECTED_ACCOUNTS_SETTINGS,\n\n  // (a) i18n-bundle-only — SurfaceErrorBoundary is rendered directly by `Surface` when the surface\n  // policy asks for a boundary, never resolved through the registry. The enum entry exists so the\n  // fallback's words are addressable labels.\n  FrontendComponentType.APP_LAYOUTS_SURFACE_ERROR_BOUNDARY,\n\n  // (e) orphan — H-5: FK editing AND display both flow through the\n  // dedicated RESOURCES_FIELDS_RESOURCE_REFERENCE preset (registered by\n  // category EDIT/DISPLAY in register-framework-layouts.ts) so there is no\n  // separate FORM_FIELD / DISPLAY_FIELD wrapper to register. The enum\n  // entries are kept on the schema for consumers that key i18n labels off\n  // them; renaming has cross-package blast radius (presets, generated\n  // specs, locale bundles), so we treat them as documented orphans rather\n  // than removing them.\n  FrontendComponentType.LOW_LEVEL_FORM_FIELD_FOREIGN_KEY,\n  FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FOREIGN_KEY,\n]);\n\nexport interface RegistryCompletenessReport {\n  totalEnumValues: number;\n  registeredCount: number;\n  denyListedCount: number;\n  missing: FrontendComponentType[];\n}\n\n/**\n * Compute (without throwing) the set of enum entries that should be\n * registered but are not. Useful for tests and for the boot-time check.\n */\nexport function computeRegistryCompleteness(): RegistryCompletenessReport {\n  const allValues = Object.values(FrontendComponentType) as FrontendComponentType[];\n  const missing: FrontendComponentType[] = [];\n  let registeredCount = 0;\n\n  for (const type of allValues) {\n    if (KNOWN_NON_REGISTERED_COMPONENT_TYPES.has(type)) continue;\n    if (ComponentRegistryService.hasComponentType(type)) {\n      registeredCount += 1;\n    } else {\n      missing.push(type);\n    }\n  }\n\n  return {\n    totalEnumValues: allValues.length,\n    registeredCount,\n    denyListedCount: KNOWN_NON_REGISTERED_COMPONENT_TYPES.size,\n    missing,\n  };\n}\n\n/**\n * Boot-time guard.\n *\n * Call this once after every `registerDefaultPresets()` /\n * `registerFrameworkLayouts()` invocation completes during app startup.\n *\n * Behaviour:\n *  - In `development`: throws a hard error listing all missing entries.\n *    The developer must either register the missing component or add\n *    its enum value to `KNOWN_NON_REGISTERED_COMPONENT_TYPES` with a\n *    justification.\n *  - In `production`: logs a warning and returns. Avoids breaking a\n *    deployed app over a registration omission, but surfaces it loudly\n *    in monitoring.\n *\n * @returns the same report `computeRegistryCompleteness()` returned.\n */\nexport function assertRegistryCompleteness(options?: {\n  /**\n   * When true, throw even outside `development`. Useful for CI / unit\n   * tests that want a strict gate regardless of NODE_ENV.\n   */\n  strict?: boolean;\n}): RegistryCompletenessReport {\n  const report = computeRegistryCompleteness();\n\n  if (report.missing.length === 0) {\n    return report;\n  }\n\n  const message =\n    `[ComponentRegistry] Tier-1 completeness check failed: ${report.missing.length} ` +\n    `FrontendComponentType value(s) have no registered preset.\\n\\n` +\n    `Missing entries:\\n${report.missing.map(t => `  - ${t}`).join('\\n')}\\n\\n` +\n    `For each missing entry you must EITHER:\\n` +\n    `  (1) register a default preset in registerDefaultPresets() / registerFrameworkLayouts(); OR\\n` +\n    `  (2) add the enum value to KNOWN_NON_REGISTERED_COMPONENT_TYPES in ` +\n    `assert-registry-completeness.frontend.helper.ts with a one-line justification ` +\n    `(see compound-component-system.md Section 15 for the Tier-1 vs Tier-2 model).`;\n\n  const isDev = typeof process !== 'undefined' && process.env?.NODE_ENV === 'development';\n  if (options?.strict || isDev) {\n    throw new Error(message);\n  }\n\n  logger.warn('component-registry.completeness-check.failed', { message, missing: report.missing });\n  return report;\n}\n"]}

package/dist/esm/core/components-registry/component-registry-loader.frontend.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-registry-loader.frontend.service.d.ts","sourceRoot":"","sources":["../../../../src/core/components-registry/component-registry-loader.frontend.service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AAOnG;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,GACpD,IAAI,CAsCN;AAED,wBAAgB,eAAe,IAAI;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAgBA;AAED,wBAAsB,sCAAsC,CAC1D,aAAa,EAAE,6BAA6B,EAAE,GAC7C,OAAO,CAAC,IAAI,CAAC,CAUf"}
+{"version":3,"file":"component-registry-loader.frontend.service.d.ts","sourceRoot":"","sources":["../../../../../src/core/components-registry/component-registry-loader.frontend.service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AAOnG;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,GACpD,IAAI,CAsCN;AAED,wBAAgB,eAAe,IAAI;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAgBA;AAED,wBAAsB,sCAAsC,CAC1D,aAAa,EAAE,6BAA6B,EAAE,GAC7C,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/esm/core/components-registry/component-registry-loader.frontend.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-registry-loader.frontend.service.js","sourceRoot":"","sources":["../../../../src/core/components-registry/component-registry-loader.frontend.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';\nimport { ComponentRegistryService } from './component-registry.frontend.service';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport type { FrontendComponentRegistration } from '../runtime/domain-module.frontend.definitions';\n\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('ComponentRegistryLoaderService');\nlogger.setDebugTypeLogging('ComponentRegistryLoaderService', false);\n\n/**\n * Load and register custom components from app-custom libraries\n *\n * Custom components are already imported in the runnable App.tsx,\n * so their modules are already loaded. This function ensures they\n * are registered in the ComponentRegistryService.\n *\n * This handles the case where custom components use the old\n * registry pattern (direct component in registry object).\n */\nexport function loadCustomComponents(\n  customRegistries: Array<Partial<Record<string, any>>>\n): void {\n  if (!customRegistries || customRegistries.length === 0) {\n    return;\n  }\n\n  let registeredCount = 0;\n\n  customRegistries.forEach(registry => {\n    if (!registry) return;\n\n    Object.entries(registry).forEach(([componentTypeStr, presets]) => {\n      const componentType = componentTypeStr as FrontendComponentType;\n\n      if (!presets || !Array.isArray(presets)) return;\n\n      presets.forEach(preset => {\n        if (!preset || !preset.component) return;\n\n        const presetName = preset.variant || preset.preset || CorePresetNames.DEFAULT;\n\n\n        const isAlreadyRegistered = ComponentRegistryService.isRegistered( componentType, presetName, preset.category );\n\n        if (!isAlreadyRegistered) {\n\n          ComponentRegistryService.register(\n            componentType, presetName, preset.component,\n            { isConfigurable: preset.isConfigurable !== false, category: preset.category } );\n\n          registeredCount++;\n        }\n      });\n    });\n  });\n\n  if (registeredCount > 0) {\n    logDebug(`✅ Custom components loaded: ${registeredCount} components registered`);\n  }\n}\n\nexport function getLoadingStats(): {\n  totalRegistered: number;\n  byCategory: Map<string, number>;\n} {\n  const byType = ComponentRegistryService.getRegistrationsByType();\n  const byCategory = new Map<string, number>();\n\n  // Group by category (LOW_LEVEL, APP_LAYOUTS, etc.)\n  byType.forEach((registrations, componentType) => {\n    // Extract category from component type\n    // e.g., \"LOW_LEVEL_BUTTON\" → \"LOW_LEVEL\"\n    const category = componentType.split('_').slice(0, -1).join('_') || 'OTHER';\n    byCategory.set(category, (byCategory.get(category) || 0) + registrations.length);\n  });\n\n  return {\n    totalRegistered: ComponentRegistryService.getRegistrationCount(),\n    byCategory\n  };\n}\n\nexport async function registerFrontendComponentRegistrations(\n  registrations: FrontendComponentRegistration[],\n): Promise<void> {\n  for (const registration of registrations) {\n    const component = await registration.loadComponent();\n    ComponentRegistryService.register(\n      registration.componentRef as FrontendComponentType,\n      registration.preset ?? CorePresetNames.DEFAULT,\n      component,\n      { isConfigurable: registration.isConfigurable ?? false },\n    );\n  }\n}\n"]}
+{"version":3,"file":"component-registry-loader.frontend.service.js","sourceRoot":"","sources":["../../../../../src/core/components-registry/component-registry-loader.frontend.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';\nimport { ComponentRegistryService } from './component-registry.frontend.service';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport type { FrontendComponentRegistration } from '../runtime/domain-module.frontend.definitions';\n\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('ComponentRegistryLoaderService');\nlogger.setDebugTypeLogging('ComponentRegistryLoaderService', false);\n\n/**\n * Load and register custom components from app-custom libraries\n *\n * Custom components are already imported in the runnable App.tsx,\n * so their modules are already loaded. This function ensures they\n * are registered in the ComponentRegistryService.\n *\n * This handles the case where custom components use the old\n * registry pattern (direct component in registry object).\n */\nexport function loadCustomComponents(\n  customRegistries: Array<Partial<Record<string, any>>>\n): void {\n  if (!customRegistries || customRegistries.length === 0) {\n    return;\n  }\n\n  let registeredCount = 0;\n\n  customRegistries.forEach(registry => {\n    if (!registry) return;\n\n    Object.entries(registry).forEach(([componentTypeStr, presets]) => {\n      const componentType = componentTypeStr as FrontendComponentType;\n\n      if (!presets || !Array.isArray(presets)) return;\n\n      presets.forEach(preset => {\n        if (!preset || !preset.component) return;\n\n        const presetName = preset.variant || preset.preset || CorePresetNames.DEFAULT;\n\n\n        const isAlreadyRegistered = ComponentRegistryService.isRegistered( componentType, presetName, preset.category );\n\n        if (!isAlreadyRegistered) {\n\n          ComponentRegistryService.register(\n            componentType, presetName, preset.component,\n            { isConfigurable: preset.isConfigurable !== false, category: preset.category } );\n\n          registeredCount++;\n        }\n      });\n    });\n  });\n\n  if (registeredCount > 0) {\n    logDebug(`✅ Custom components loaded: ${registeredCount} components registered`);\n  }\n}\n\nexport function getLoadingStats(): {\n  totalRegistered: number;\n  byCategory: Map<string, number>;\n} {\n  const byType = ComponentRegistryService.getRegistrationsByType();\n  const byCategory = new Map<string, number>();\n\n  // Group by category (LOW_LEVEL, APP_LAYOUTS, etc.)\n  byType.forEach((registrations, componentType) => {\n    // Extract category from component type\n    // e.g., \"LOW_LEVEL_BUTTON\" → \"LOW_LEVEL\"\n    const category = componentType.split('_').slice(0, -1).join('_') || 'OTHER';\n    byCategory.set(category, (byCategory.get(category) || 0) + registrations.length);\n  });\n\n  return {\n    totalRegistered: ComponentRegistryService.getRegistrationCount(),\n    byCategory\n  };\n}\n\nexport async function registerFrontendComponentRegistrations(\n  registrations: FrontendComponentRegistration[],\n): Promise<void> {\n  for (const registration of registrations) {\n    const component = await registration.loadComponent();\n    ComponentRegistryService.register(\n      registration.componentRef,\n      registration.preset ?? CorePresetNames.DEFAULT,\n      component,\n      { isConfigurable: registration.isConfigurable ?? false },\n    );\n  }\n}\n"]}

package/dist/esm/core/components-registry/component-registry.frontend.schemas.d.ts

@@ -1,4 +1,26 @@
 import type { FrontendComponentType, FrontEndComponentResourceFieldCategory, CorePresetNames } from '@wildo-ai/presets-components-models';
+/**
+ * The name a component is registered and resolved under — what every registry method keys on (#549).
+ *
+ * Two populations share ONE key space, and naming the union is what stops the type lying about it:
+ *
+ * - an ENGINE slot — a `FrontendComponentType` member, filled by a preset (`LOW_LEVEL_BUTTON`);
+ * - an APPLICATION component — the `componentRef` a domain module binds in its
+ *   `componentRegistrations` (`'FocusHubSmokeView'`), which shell surfaces (utility panel, sidebar
+ *   custom sections, full custom views, the settings hub, launcher `CUSTOM_COMPONENT` items) host.
+ *
+ * The store was always string-keyed at runtime and applications have always registered under their
+ * own names. What was closed was only the TYPE, so six call sites cast
+ * `componentRef as unknown as FrontendComponentType` to reach a registry that already worked, and
+ * the one surface that took the type at its word — the utility panel, which checked enum membership
+ * — could host no application component at all. The key is a plain name, not a namespaced one: a
+ * required prefix would have broken every existing application registration.
+ *
+ * Distinct from the type-checked population in `assert-registry-completeness`, which still walks the
+ * `FrontendComponentType` enum: completeness is a property of ENGINE slots only.
+ */
+export type ApplicationComponentRef = string;
+export type ComponentRegistryRef = FrontendComponentType | ApplicationComponentRef;
 export interface ComponentPresetProps {
     preset?: CorePresetNames | string;
 }
@@ -7,7 +29,7 @@ export interface RegistrationOptions {
     category?: FrontEndComponentResourceFieldCategory;
 }
 export interface RegistrationMetadata {
-    componentType: FrontendComponentType;
+    componentType: ComponentRegistryRef;
     preset: string;
     isConfigurable: boolean;
     category?: FrontEndComponentResourceFieldCategory;
@@ -15,7 +37,7 @@ export interface RegistrationMetadata {
 }
 export interface RegistrationInfo {
     key: string;
-    componentType: FrontendComponentType;
+    componentType: ComponentRegistryRef;
     preset: string;
     category?: FrontEndComponentResourceFieldCategory;
     isConfigurable: boolean;

package/dist/esm/core/components-registry/component-registry.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-registry.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/components-registry/component-registry.frontend.schemas.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,sCAAsC,EACtC,eAAe,EAChB,MAAM,qCAAqC,CAAC;AAI7C,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,sCAAsC,CAAC;CACnD;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,qBAAqB,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,sCAAsC,CAAC;IAClD,YAAY,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,qBAAqB,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,sCAAsC,CAAC;IAClD,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,IAAI,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,sCAAsC,CAAC;CAC5D;AAED,6EAA6E;AAC7E,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,gCAAgC,EAAE,CAAC;CAC/D;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"component-registry.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/components-registry/component-registry.frontend.schemas.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,sCAAsC,EACtC,eAAe,EAChB,MAAM,qCAAqC,CAAC;AAI7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAC7C,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,GAAG,uBAAuB,CAAC;AAEnF,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,sCAAsC,CAAC;CACnD;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,oBAAoB,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,sCAAsC,CAAC;IAClD,YAAY,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,oBAAoB,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,sCAAsC,CAAC;IAClD,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,IAAI,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,sCAAsC,CAAC;CAC5D;AAED,6EAA6E;AAC7E,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,gCAAgC,EAAE,CAAC;CAC/D;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/esm/core/components-registry/component-registry.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-registry.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/components-registry/component-registry.frontend.schemas.ts"],"names":[],"mappings":"","sourcesContent":["\nimport type {\n  FrontendComponentType, \n  FrontEndComponentResourceFieldCategory,\n  CorePresetNames \n} from '@wildo-ai/presets-components-models';\n\n\n\nexport interface ComponentPresetProps {\n  preset?: CorePresetNames | string;\n}\n\nexport interface RegistrationOptions {\n  isConfigurable: boolean;\n  category?: FrontEndComponentResourceFieldCategory;\n}\n\nexport interface RegistrationMetadata {\n  componentType: FrontendComponentType;\n  preset: string;\n  isConfigurable: boolean;\n  category?: FrontEndComponentResourceFieldCategory;\n  registeredAt: Date;\n}\n\nexport interface RegistrationInfo {\n  key: string;\n  componentType: FrontendComponentType;\n  preset: string;\n  category?: FrontEndComponentResourceFieldCategory;\n  isConfigurable: boolean;\n  registeredAt: Date;\n}\n\n/**\n * One exact component registration a frontend host requires before it can\n * mount. A component type registered under another preset or field category\n * does not satisfy this requirement.\n */\nexport interface ComponentRegistrationRequirement {\n  readonly componentType: FrontendComponentType;\n  readonly preset: CorePresetNames | string;\n  readonly category?: FrontEndComponentResourceFieldCategory;\n}\n\n/** Deterministic result of validating a host's declared component subset. */\nexport interface ComponentRegistrationRequirementsReport {\n  readonly requiredCount: number;\n  readonly registeredCount: number;\n  readonly missing: readonly ComponentRegistrationRequirement[];\n}\n\nexport interface ComponentRegistration_LoadResult {\n  success: boolean;\n  loadTime?: number;\n  componentsLoaded?: number;\n  error?: string;\n}\n"]}
+{"version":3,"file":"component-registry.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/components-registry/component-registry.frontend.schemas.ts"],"names":[],"mappings":"","sourcesContent":["\nimport type {\n  FrontendComponentType, \n  FrontEndComponentResourceFieldCategory,\n  CorePresetNames \n} from '@wildo-ai/presets-components-models';\n\n\n\n/**\n * The name a component is registered and resolved under — what every registry method keys on (#549).\n *\n * Two populations share ONE key space, and naming the union is what stops the type lying about it:\n *\n * - an ENGINE slot — a `FrontendComponentType` member, filled by a preset (`LOW_LEVEL_BUTTON`);\n * - an APPLICATION component — the `componentRef` a domain module binds in its\n *   `componentRegistrations` (`'FocusHubSmokeView'`), which shell surfaces (utility panel, sidebar\n *   custom sections, full custom views, the settings hub, launcher `CUSTOM_COMPONENT` items) host.\n *\n * The store was always string-keyed at runtime and applications have always registered under their\n * own names. What was closed was only the TYPE, so six call sites cast\n * `componentRef as unknown as FrontendComponentType` to reach a registry that already worked, and\n * the one surface that took the type at its word — the utility panel, which checked enum membership\n * — could host no application component at all. The key is a plain name, not a namespaced one: a\n * required prefix would have broken every existing application registration.\n *\n * Distinct from the type-checked population in `assert-registry-completeness`, which still walks the\n * `FrontendComponentType` enum: completeness is a property of ENGINE slots only.\n */\nexport type ApplicationComponentRef = string;\nexport type ComponentRegistryRef = FrontendComponentType | ApplicationComponentRef;\n\nexport interface ComponentPresetProps {\n  preset?: CorePresetNames | string;\n}\n\nexport interface RegistrationOptions {\n  isConfigurable: boolean;\n  category?: FrontEndComponentResourceFieldCategory;\n}\n\nexport interface RegistrationMetadata {\n  componentType: ComponentRegistryRef;\n  preset: string;\n  isConfigurable: boolean;\n  category?: FrontEndComponentResourceFieldCategory;\n  registeredAt: Date;\n}\n\nexport interface RegistrationInfo {\n  key: string;\n  componentType: ComponentRegistryRef;\n  preset: string;\n  category?: FrontEndComponentResourceFieldCategory;\n  isConfigurable: boolean;\n  registeredAt: Date;\n}\n\n/**\n * One exact component registration a frontend host requires before it can\n * mount. A component type registered under another preset or field category\n * does not satisfy this requirement.\n */\nexport interface ComponentRegistrationRequirement {\n  readonly componentType: FrontendComponentType;\n  readonly preset: CorePresetNames | string;\n  readonly category?: FrontEndComponentResourceFieldCategory;\n}\n\n/** Deterministic result of validating a host's declared component subset. */\nexport interface ComponentRegistrationRequirementsReport {\n  readonly requiredCount: number;\n  readonly registeredCount: number;\n  readonly missing: readonly ComponentRegistrationRequirement[];\n}\n\nexport interface ComponentRegistration_LoadResult {\n  success: boolean;\n  loadTime?: number;\n  componentsLoaded?: number;\n  error?: string;\n}\n"]}