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

package/dist/esm/core/i18n/component-label-resolution.utils.d.ts

@@ -1,47 +1,45 @@
 import type { FrontendComponentType } from '@wildo-ai/presets-components-models';
-/**
- * Detect whether `tComponent`/`t` returned the key path itself (which
- * happens when the i18n bundle has no entry for that key) and substitute
- * an empty string instead of leaking the key path into the UI.
- *
- * Note: the substitution is empty-string only. Missing-key fallback belongs
- * in the i18n runtime, where it can use the configured fallback language
- * consistently instead of accepting component-local literal fallbacks.
- */
-export declare function normalizeMissingI18nValue(resolved: string, missingKey: string): string;
 export declare function resolveComponentLabel(params: {
     tComponent: (componentType: FrontendComponentType, key: string, kvPairs?: Record<string, string | number>) => string;
     componentType: FrontendComponentType;
     key: string;
     params?: Record<string, string | number>;
 }): string;
+/**
+ * The OPTIONAL form of {@link resolveComponentLabel}: `undefined` when the key has no label.
+ *
+ * Use it only where a missing label is a legitimate state and not a gap somebody must close:
+ *
+ * - SUPPLEMENTARY text — a description or a tooltip under a primary label that is itself shown.
+ *   This is the runtime's own convention (`tResourceFieldDisplay`, `tBillingProduct`, … in
+ *   `I18nContext.tsx` answer the unresolved key for a `label`/`name` and nothing for a
+ *   `description`), because an absent description collapses cleanly and a key path in its place
+ *   reads as broken copy under a heading that is fine.
+ * - A key built from an APPLICATION-defined identifier no framework declaration can enumerate,
+ *   where the caller falls back to that identifier — a value, never invented words.
+ *
+ * Never use it for a primary label (a title, a button, a tab, an accessible name). A primary label
+ * that is missing must look missing; hiding it is the defect #1414 records.
+ */
+export declare function resolveOptionalComponentLabel(params: Parameters<typeof resolveComponentLabel>[0]): string | undefined;
 /**
  * Curried form of {@link resolveComponentLabel}, for a component that resolves
- * SEVERAL keys or hands its resolver down to a helper.
+ * SEVERAL keys or hands its resolver down to a helper. It binds the component
+ * type once, so the namespace lives in one place.
  *
- * Prefer this over `makeTrComponent` wherever the caller writes a fallback.
- * `makeTrComponent` returns the KEY PATH on a miss — deliberately, so a missing
- * label is visible in development rather than silently blank — which makes the
- * natural `t('x') || 'Fallback'` idiom DEAD: the key path is a non-empty string,
- * so `||` never fires and the raw key reaches the user. That defect shipped on
- * the 404 page (`components.APP_LAYOUTS_ROUTER_ERROR_BOUNDARY.errorPage_action_navigate`
- * rendered as a button label) and was written the same way at ten call sites
- * across five components, each author believing their fallback protected them.
+ * Like every resolver here it answers a miss with the KEY PATH. Do not write
+ * `t('x') || 'Fallback'` after it: the key path is a non-empty string, so the
+ * `||` never fires — and it must not, because a component-local English literal
+ * is a second source for words the label tree owns. A key that should always
+ * exist belongs in that component's `*.labels.ts` so the labelling pipeline
+ * generates real text in every locale; until it has, the key is what shows.
  *
- * A resolver from here returns `''` on a miss, so `|| fallback` means what it
- * reads as.
+ * (Between 2026-08 and #1414 this returned `''` on a miss precisely so that idiom
+ * would be live. That traded a visible gap for an invisible one and is retired.)
  *
  * There is ONE benign variant of the idiom, so a reader sweeping for it does not
  * "fix" a dozen correct sites: `t('File attached') ?? 'File attached'`, on the
- * PLAIN `t`, where the key IS the English text. A miss returns the key, which is
- * the fallback, so the result is right by construction and the `??` is decorative.
- * It is only dead-and-wrong when the key is an identifier the user must not see.
- *
- * Note the standing design constraint from {@link normalizeMissingI18nValue}: a
- * component-local literal fallback is a stopgap, not the destination. A key that
- * SHOULD always exist belongs in that component's `*.labels.ts` so the labelling
- * pipeline generates real text in every locale. Keep a literal only where the key
- * is genuinely dynamic — an app-defined ref no declaration can enumerate.
+ * PLAIN `t`, where the key IS the English text.
  */
 export declare function makeComponentLabelResolver(tComponent: (componentType: FrontendComponentType, key: string, kvPairs?: Record<string, string | number>) => string, componentType: FrontendComponentType): (key: string, params?: Record<string, string | number>) => string;
 export declare function resolveResourceHeaderLabel(params: {
@@ -50,6 +48,19 @@ export declare function resolveResourceHeaderLabel(params: {
     key: 'title' | 'description';
     params?: Record<string, string | number>;
 }): string;
+/**
+ * A resource header's DESCRIPTION, or `undefined` when none is authored.
+ *
+ * The key is typed `'description'` alone on purpose: a header TITLE is a primary label and must
+ * look missing (use {@link resolveResourceHeaderLabel}); only the description is supplementary
+ * text whose absence lets the header collapse cleanly. See {@link resolveOptionalComponentLabel}
+ * for the convention this follows.
+ */
+export declare function resolveOptionalResourceHeaderDescription(params: {
+    tResourceHeader: (resourceType: string, key: 'title' | 'description', kvPairs?: Record<string, string | number>) => string;
+    resourceType: string;
+    params?: Record<string, string | number>;
+}): string | undefined;
 export declare function resolveTranslationKey(params: {
     t: (key: string, kvPairs?: Record<string, string | number>) => string;
     key: string;

package/dist/esm/core/i18n/component-label-resolution.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-label-resolution.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/i18n/component-label-resolution.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAEjF;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,UAAU,EAAE,CACV,aAAa,EAAE,qBAAqB,EACpC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KACtC,MAAM,CAAC;IACZ,aAAa,EAAE,qBAAqB,CAAC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C,GAAG,MAAM,CAQT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,CACV,aAAa,EAAE,qBAAqB,EACpC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KACtC,MAAM,EACX,aAAa,EAAE,qBAAqB,GACnC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAEnE;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,eAAe,EAAE,CACf,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,OAAO,GAAG,aAAa,EAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KACtC,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,OAAO,GAAG,aAAa,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C,GAAG,MAAM,CAQT;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,CAAC,EAAE,CACD,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KACtC,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C,GAAG,MAAM,CAGT"}
+{"version":3,"file":"component-label-resolution.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/i18n/component-label-resolution.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AA2BjF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,UAAU,EAAE,CACV,aAAa,EAAE,qBAAqB,EACpC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KACtC,MAAM,CAAC;IACZ,aAAa,EAAE,qBAAqB,CAAC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C,GAAG,MAAM,CAQT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC,GAClD,MAAM,GAAG,SAAS,CAGpB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,CACV,aAAa,EAAE,qBAAqB,EACpC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KACtC,MAAM,EACX,aAAa,EAAE,qBAAqB,GACnC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAEnE;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,eAAe,EAAE,CACf,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,OAAO,GAAG,aAAa,EAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KACtC,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,OAAO,GAAG,aAAa,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C,GAAG,MAAM,CAQT;AAED;;;;;;;GAOG;AACH,wBAAgB,wCAAwC,CAAC,MAAM,EAAE;IAC/D,eAAe,EAAE,CACf,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,OAAO,GAAG,aAAa,EAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KACtC,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C,GAAG,MAAM,GAAG,SAAS,CAGrB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,CAAC,EAAE,CACD,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KACtC,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C,GAAG,MAAM,CAGT"}

package/dist/esm/core/i18n/component-label-resolution.utils.js

@@ -1,58 +1,93 @@
 /**
- * Detect whether `tComponent`/`t` returned the key path itself (which
- * happens when the i18n bundle has no entry for that key) and substitute
- * an empty string instead of leaking the key path into the UI.
+ * A MISSING LABEL LOOKS MISSING — the contract of every resolver in this module (#1414).
  *
- * Note: the substitution is empty-string only. Missing-key fallback belongs
- * in the i18n runtime, where it can use the configured fallback language
- * consistently instead of accepting component-local literal fallbacks.
+ * `tComponent` / `tResourceHeader` / `t` answer an unresolved key with the KEY PATH itself. Every
+ * resolver here hands that answer on unchanged: the key is visible, greppable, obviously not a
+ * label, and names exactly what somebody has to author. It is the same unresolved form
+ * `unresolvedLabel` in `I18nContext.tsx` gives the rest of the runtime, and it is what
+ * `.claude/rules/display-text-comes-from-i18n.md` requires.
+ *
+ * Until 2026-09-21 this module did the opposite: a miss became `''`, "instead of leaking the key
+ * path into the UI". An empty string is the LEAST visible answer available. It shipped a
+ * relationship tab with no text and 16px of width, found only by listing the page's `role=tab`
+ * elements, and it made `resolve(...) || 'English literal'` a live idiom at a dozen sites — a
+ * second, untranslatable source for words the label tree owns.
+ *
+ * So a resolver here never answers a MISS with `''`, and a caller never writes `|| fallback` after
+ * one: a miss is a non-empty key path, so the fallback is dead. (An AUTHORED empty string still
+ * comes back as authored — that is somebody's decision, not a gap.) Where ABSENCE is a legitimate
+ * authored state rather than a gap, say so by calling one of the `resolveOptional…` functions
+ * below — a named decision, never a falsy check on a label.
  */
-export function normalizeMissingI18nValue(resolved, missingKey) {
-    return resolved === missingKey ? '' : resolved;
+function isMissingI18nValue(resolved, missingKey) {
+    return resolved === missingKey;
 }
 export function resolveComponentLabel(params) {
     const resolved = params.tComponent(params.componentType, params.key, params.params);
-    const missingKey = `components.${params.componentType}.${params.key}`;
-    return normalizeMissingI18nValue(resolved, missingKey);
+    // On a miss `resolved` IS the key path — the unresolved form. It stands.
+    return resolved;
+}
+/**
+ * The OPTIONAL form of {@link resolveComponentLabel}: `undefined` when the key has no label.
+ *
+ * Use it only where a missing label is a legitimate state and not a gap somebody must close:
+ *
+ * - SUPPLEMENTARY text — a description or a tooltip under a primary label that is itself shown.
+ *   This is the runtime's own convention (`tResourceFieldDisplay`, `tBillingProduct`, … in
+ *   `I18nContext.tsx` answer the unresolved key for a `label`/`name` and nothing for a
+ *   `description`), because an absent description collapses cleanly and a key path in its place
+ *   reads as broken copy under a heading that is fine.
+ * - A key built from an APPLICATION-defined identifier no framework declaration can enumerate,
+ *   where the caller falls back to that identifier — a value, never invented words.
+ *
+ * Never use it for a primary label (a title, a button, a tab, an accessible name). A primary label
+ * that is missing must look missing; hiding it is the defect #1414 records.
+ */
+export function resolveOptionalComponentLabel(params) {
+    const resolved = params.tComponent(params.componentType, params.key, params.params);
+    return isMissingI18nValue(resolved, `components.${params.componentType}.${params.key}`) ? undefined : resolved;
 }
 /**
  * Curried form of {@link resolveComponentLabel}, for a component that resolves
- * SEVERAL keys or hands its resolver down to a helper.
+ * SEVERAL keys or hands its resolver down to a helper. It binds the component
+ * type once, so the namespace lives in one place.
  *
- * Prefer this over `makeTrComponent` wherever the caller writes a fallback.
- * `makeTrComponent` returns the KEY PATH on a miss — deliberately, so a missing
- * label is visible in development rather than silently blank — which makes the
- * natural `t('x') || 'Fallback'` idiom DEAD: the key path is a non-empty string,
- * so `||` never fires and the raw key reaches the user. That defect shipped on
- * the 404 page (`components.APP_LAYOUTS_ROUTER_ERROR_BOUNDARY.errorPage_action_navigate`
- * rendered as a button label) and was written the same way at ten call sites
- * across five components, each author believing their fallback protected them.
+ * Like every resolver here it answers a miss with the KEY PATH. Do not write
+ * `t('x') || 'Fallback'` after it: the key path is a non-empty string, so the
+ * `||` never fires — and it must not, because a component-local English literal
+ * is a second source for words the label tree owns. A key that should always
+ * exist belongs in that component's `*.labels.ts` so the labelling pipeline
+ * generates real text in every locale; until it has, the key is what shows.
  *
- * A resolver from here returns `''` on a miss, so `|| fallback` means what it
- * reads as.
+ * (Between 2026-08 and #1414 this returned `''` on a miss precisely so that idiom
+ * would be live. That traded a visible gap for an invisible one and is retired.)
  *
  * There is ONE benign variant of the idiom, so a reader sweeping for it does not
  * "fix" a dozen correct sites: `t('File attached') ?? 'File attached'`, on the
- * PLAIN `t`, where the key IS the English text. A miss returns the key, which is
- * the fallback, so the result is right by construction and the `??` is decorative.
- * It is only dead-and-wrong when the key is an identifier the user must not see.
- *
- * Note the standing design constraint from {@link normalizeMissingI18nValue}: a
- * component-local literal fallback is a stopgap, not the destination. A key that
- * SHOULD always exist belongs in that component's `*.labels.ts` so the labelling
- * pipeline generates real text in every locale. Keep a literal only where the key
- * is genuinely dynamic — an app-defined ref no declaration can enumerate.
+ * PLAIN `t`, where the key IS the English text.
  */
 export function makeComponentLabelResolver(tComponent, componentType) {
     return (key, params) => resolveComponentLabel({ tComponent, componentType, key, params });
 }
 export function resolveResourceHeaderLabel(params) {
     const resolved = params.tResourceHeader(params.resourceType, params.key, params.params);
-    const missingKey = `resources.${params.resourceType}.header.${params.key}`;
-    return normalizeMissingI18nValue(resolved, missingKey);
+    // On a miss `resolved` IS `resources.<type>.header.<key>` — the unresolved form. It stands.
+    return resolved;
+}
+/**
+ * A resource header's DESCRIPTION, or `undefined` when none is authored.
+ *
+ * The key is typed `'description'` alone on purpose: a header TITLE is a primary label and must
+ * look missing (use {@link resolveResourceHeaderLabel}); only the description is supplementary
+ * text whose absence lets the header collapse cleanly. See {@link resolveOptionalComponentLabel}
+ * for the convention this follows.
+ */
+export function resolveOptionalResourceHeaderDescription(params) {
+    const resolved = params.tResourceHeader(params.resourceType, 'description', params.params);
+    return isMissingI18nValue(resolved, `resources.${params.resourceType}.header.description`) ? undefined : resolved;
 }
 export function resolveTranslationKey(params) {
-    const resolved = params.t(params.key, params.params);
-    return normalizeMissingI18nValue(resolved, params.key);
+    // On a miss `t` answers the key — the unresolved form. It stands.
+    return params.t(params.key, params.params);
 }
 //# sourceMappingURL=component-label-resolution.utils.js.map

package/dist/esm/core/i18n/component-label-resolution.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-label-resolution.utils.js","sourceRoot":"","sources":["../../../../src/core/i18n/component-label-resolution.utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAAgB,EAChB,UAAkB;IAElB,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MASrC;IACC,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAChC,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,GAAG,EACV,MAAM,CAAC,MAAM,CACd,CAAC;IACF,MAAM,UAAU,GAAG,cAAc,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;IACtE,OAAO,yBAAyB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAIW,EACX,aAAoC;IAEpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,qBAAqB,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAS1C;IACC,MAAM,QAAQ,GAAG,MAAM,CAAC,eAAe,CACrC,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,GAAG,EACV,MAAM,CAAC,MAAM,CACd,CAAC;IACF,MAAM,UAAU,GAAG,aAAa,MAAM,CAAC,YAAY,WAAW,MAAM,CAAC,GAAG,EAAE,CAAC;IAC3E,OAAO,yBAAyB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAOrC;IACC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AACzD,CAAC","sourcesContent":["import type { FrontendComponentType } from '@wildo-ai/presets-components-models';\n\n/**\n * Detect whether `tComponent`/`t` returned the key path itself (which\n * happens when the i18n bundle has no entry for that key) and substitute\n * an empty string instead of leaking the key path into the UI.\n *\n * Note: the substitution is empty-string only. Missing-key fallback belongs\n * in the i18n runtime, where it can use the configured fallback language\n * consistently instead of accepting component-local literal fallbacks.\n */\nexport function normalizeMissingI18nValue(\n  resolved: string,\n  missingKey: string,\n): string {\n  return resolved === missingKey ? '' : resolved;\n}\n\nexport function resolveComponentLabel(params: {\n  tComponent: (\n    componentType: FrontendComponentType,\n    key: string,\n    kvPairs?: Record<string, string | number>,\n  ) => string;\n  componentType: FrontendComponentType;\n  key: string;\n  params?: Record<string, string | number>;\n}): string {\n  const resolved = params.tComponent(\n    params.componentType,\n    params.key,\n    params.params,\n  );\n  const missingKey = `components.${params.componentType}.${params.key}`;\n  return normalizeMissingI18nValue(resolved, missingKey);\n}\n\n/**\n * Curried form of {@link resolveComponentLabel}, for a component that resolves\n * SEVERAL keys or hands its resolver down to a helper.\n *\n * Prefer this over `makeTrComponent` wherever the caller writes a fallback.\n * `makeTrComponent` returns the KEY PATH on a miss — deliberately, so a missing\n * label is visible in development rather than silently blank — which makes the\n * natural `t('x') || 'Fallback'` idiom DEAD: the key path is a non-empty string,\n * so `||` never fires and the raw key reaches the user. That defect shipped on\n * the 404 page (`components.APP_LAYOUTS_ROUTER_ERROR_BOUNDARY.errorPage_action_navigate`\n * rendered as a button label) and was written the same way at ten call sites\n * across five components, each author believing their fallback protected them.\n *\n * A resolver from here returns `''` on a miss, so `|| fallback` means what it\n * reads as.\n *\n * There is ONE benign variant of the idiom, so a reader sweeping for it does not\n * \"fix\" a dozen correct sites: `t('File attached') ?? 'File attached'`, on the\n * PLAIN `t`, where the key IS the English text. A miss returns the key, which is\n * the fallback, so the result is right by construction and the `??` is decorative.\n * It is only dead-and-wrong when the key is an identifier the user must not see.\n *\n * Note the standing design constraint from {@link normalizeMissingI18nValue}: a\n * component-local literal fallback is a stopgap, not the destination. A key that\n * SHOULD always exist belongs in that component's `*.labels.ts` so the labelling\n * pipeline generates real text in every locale. Keep a literal only where the key\n * is genuinely dynamic — an app-defined ref no declaration can enumerate.\n */\nexport function makeComponentLabelResolver(\n  tComponent: (\n    componentType: FrontendComponentType,\n    key: string,\n    kvPairs?: Record<string, string | number>,\n  ) => string,\n  componentType: FrontendComponentType,\n): (key: string, params?: Record<string, string | number>) => string {\n  return (key, params) => resolveComponentLabel({ tComponent, componentType, key, params });\n}\n\nexport function resolveResourceHeaderLabel(params: {\n  tResourceHeader: (\n    resourceType: string,\n    key: 'title' | 'description',\n    kvPairs?: Record<string, string | number>,\n  ) => string;\n  resourceType: string;\n  key: 'title' | 'description';\n  params?: Record<string, string | number>;\n}): string {\n  const resolved = params.tResourceHeader(\n    params.resourceType,\n    params.key,\n    params.params,\n  );\n  const missingKey = `resources.${params.resourceType}.header.${params.key}`;\n  return normalizeMissingI18nValue(resolved, missingKey);\n}\n\nexport function resolveTranslationKey(params: {\n  t: (\n    key: string,\n    kvPairs?: Record<string, string | number>,\n  ) => string;\n  key: string;\n  params?: Record<string, string | number>;\n}): string {\n  const resolved = params.t(params.key, params.params);\n  return normalizeMissingI18nValue(resolved, params.key);\n}\n"]}
+{"version":3,"file":"component-label-resolution.utils.js","sourceRoot":"","sources":["../../../../../src/core/i18n/component-label-resolution.utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAS,kBAAkB,CAAC,QAAgB,EAAE,UAAkB;IAC9D,OAAO,QAAQ,KAAK,UAAU,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MASrC;IACC,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAChC,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,GAAG,EACV,MAAM,CAAC,MAAM,CACd,CAAC;IACF,yEAAyE;IACzE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,6BAA6B,CAC3C,MAAmD;IAEnD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACpF,OAAO,kBAAkB,CAAC,QAAQ,EAAE,cAAc,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;AACjH,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAIW,EACX,aAAoC;IAEpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,qBAAqB,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAS1C;IACC,MAAM,QAAQ,GAAG,MAAM,CAAC,eAAe,CACrC,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,GAAG,EACV,MAAM,CAAC,MAAM,CACd,CAAC;IACF,4FAA4F;IAC5F,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wCAAwC,CAAC,MAQxD;IACC,MAAM,QAAQ,GAAG,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3F,OAAO,kBAAkB,CAAC,QAAQ,EAAE,aAAa,MAAM,CAAC,YAAY,qBAAqB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;AACpH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAOrC;IACC,kEAAkE;IAClE,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC","sourcesContent":["import type { FrontendComponentType } from '@wildo-ai/presets-components-models';\n\n/**\n * A MISSING LABEL LOOKS MISSING — the contract of every resolver in this module (#1414).\n *\n * `tComponent` / `tResourceHeader` / `t` answer an unresolved key with the KEY PATH itself. Every\n * resolver here hands that answer on unchanged: the key is visible, greppable, obviously not a\n * label, and names exactly what somebody has to author. It is the same unresolved form\n * `unresolvedLabel` in `I18nContext.tsx` gives the rest of the runtime, and it is what\n * `.claude/rules/display-text-comes-from-i18n.md` requires.\n *\n * Until 2026-09-21 this module did the opposite: a miss became `''`, \"instead of leaking the key\n * path into the UI\". An empty string is the LEAST visible answer available. It shipped a\n * relationship tab with no text and 16px of width, found only by listing the page's `role=tab`\n * elements, and it made `resolve(...) || 'English literal'` a live idiom at a dozen sites — a\n * second, untranslatable source for words the label tree owns.\n *\n * So a resolver here never answers a MISS with `''`, and a caller never writes `|| fallback` after\n * one: a miss is a non-empty key path, so the fallback is dead. (An AUTHORED empty string still\n * comes back as authored — that is somebody's decision, not a gap.) Where ABSENCE is a legitimate\n * authored state rather than a gap, say so by calling one of the `resolveOptional…` functions\n * below — a named decision, never a falsy check on a label.\n */\nfunction isMissingI18nValue(resolved: string, missingKey: string): boolean {\n  return resolved === missingKey;\n}\n\nexport function resolveComponentLabel(params: {\n  tComponent: (\n    componentType: FrontendComponentType,\n    key: string,\n    kvPairs?: Record<string, string | number>,\n  ) => string;\n  componentType: FrontendComponentType;\n  key: string;\n  params?: Record<string, string | number>;\n}): string {\n  const resolved = params.tComponent(\n    params.componentType,\n    params.key,\n    params.params,\n  );\n  // On a miss `resolved` IS the key path — the unresolved form. It stands.\n  return resolved;\n}\n\n/**\n * The OPTIONAL form of {@link resolveComponentLabel}: `undefined` when the key has no label.\n *\n * Use it only where a missing label is a legitimate state and not a gap somebody must close:\n *\n * - SUPPLEMENTARY text — a description or a tooltip under a primary label that is itself shown.\n *   This is the runtime's own convention (`tResourceFieldDisplay`, `tBillingProduct`, … in\n *   `I18nContext.tsx` answer the unresolved key for a `label`/`name` and nothing for a\n *   `description`), because an absent description collapses cleanly and a key path in its place\n *   reads as broken copy under a heading that is fine.\n * - A key built from an APPLICATION-defined identifier no framework declaration can enumerate,\n *   where the caller falls back to that identifier — a value, never invented words.\n *\n * Never use it for a primary label (a title, a button, a tab, an accessible name). A primary label\n * that is missing must look missing; hiding it is the defect #1414 records.\n */\nexport function resolveOptionalComponentLabel(\n  params: Parameters<typeof resolveComponentLabel>[0],\n): string | undefined {\n  const resolved = params.tComponent(params.componentType, params.key, params.params);\n  return isMissingI18nValue(resolved, `components.${params.componentType}.${params.key}`) ? undefined : resolved;\n}\n\n/**\n * Curried form of {@link resolveComponentLabel}, for a component that resolves\n * SEVERAL keys or hands its resolver down to a helper. It binds the component\n * type once, so the namespace lives in one place.\n *\n * Like every resolver here it answers a miss with the KEY PATH. Do not write\n * `t('x') || 'Fallback'` after it: the key path is a non-empty string, so the\n * `||` never fires — and it must not, because a component-local English literal\n * is a second source for words the label tree owns. A key that should always\n * exist belongs in that component's `*.labels.ts` so the labelling pipeline\n * generates real text in every locale; until it has, the key is what shows.\n *\n * (Between 2026-08 and #1414 this returned `''` on a miss precisely so that idiom\n * would be live. That traded a visible gap for an invisible one and is retired.)\n *\n * There is ONE benign variant of the idiom, so a reader sweeping for it does not\n * \"fix\" a dozen correct sites: `t('File attached') ?? 'File attached'`, on the\n * PLAIN `t`, where the key IS the English text.\n */\nexport function makeComponentLabelResolver(\n  tComponent: (\n    componentType: FrontendComponentType,\n    key: string,\n    kvPairs?: Record<string, string | number>,\n  ) => string,\n  componentType: FrontendComponentType,\n): (key: string, params?: Record<string, string | number>) => string {\n  return (key, params) => resolveComponentLabel({ tComponent, componentType, key, params });\n}\n\nexport function resolveResourceHeaderLabel(params: {\n  tResourceHeader: (\n    resourceType: string,\n    key: 'title' | 'description',\n    kvPairs?: Record<string, string | number>,\n  ) => string;\n  resourceType: string;\n  key: 'title' | 'description';\n  params?: Record<string, string | number>;\n}): string {\n  const resolved = params.tResourceHeader(\n    params.resourceType,\n    params.key,\n    params.params,\n  );\n  // On a miss `resolved` IS `resources.<type>.header.<key>` — the unresolved form. It stands.\n  return resolved;\n}\n\n/**\n * A resource header's DESCRIPTION, or `undefined` when none is authored.\n *\n * The key is typed `'description'` alone on purpose: a header TITLE is a primary label and must\n * look missing (use {@link resolveResourceHeaderLabel}); only the description is supplementary\n * text whose absence lets the header collapse cleanly. See {@link resolveOptionalComponentLabel}\n * for the convention this follows.\n */\nexport function resolveOptionalResourceHeaderDescription(params: {\n  tResourceHeader: (\n    resourceType: string,\n    key: 'title' | 'description',\n    kvPairs?: Record<string, string | number>,\n  ) => string;\n  resourceType: string;\n  params?: Record<string, string | number>;\n}): string | undefined {\n  const resolved = params.tResourceHeader(params.resourceType, 'description', params.params);\n  return isMissingI18nValue(resolved, `resources.${params.resourceType}.header.description`) ? undefined : resolved;\n}\n\nexport function resolveTranslationKey(params: {\n  t: (\n    key: string,\n    kvPairs?: Record<string, string | number>,\n  ) => string;\n  key: string;\n  params?: Record<string, string | number>;\n}): string {\n  // On a miss `t` answers the key — the unresolved form. It stands.\n  return params.t(params.key, params.params);\n}\n"]}

package/dist/esm/core/i18n/operation-title-resolution.utils.d.ts

@@ -0,0 +1,23 @@
+import type { I18nContextType } from '../../core/i18n/I18nContext';
+/**
+ * The words that NAME a resource operation to a person: its generated per-operation title
+ * (`resources.{resource}.operations.{operation}.title`), else the operation IDENTIFIER verbatim.
+ *
+ * One function, because three surfaces must agree on it: the action bar's label for a custom
+ * operation, and the type-to-confirm phrase a CRITICAL operation demands on the form-submit path and
+ * on the zero-input action path. The phrase a person is asked to type has to be the name they were
+ * shown on the button; when each surface derived it on its own they could disagree.
+ *
+ * The identifier is the fallback, never a humanized form of it. All three sites used to turn
+ * `reset_to_defaults` into "Reset to defaults" — English produced by code, invisible to translators,
+ * and indistinguishable from a finished label, so nobody generated the real one (#1283,
+ * `.claude/rules/display-text-comes-from-i18n.md`). An identifier is a value rather than invented
+ * words: it keeps an unlabelled operation visible and addressable, and it plainly looks unlabelled.
+ *
+ * `tResourceOperation` answers a missing title with its `resources.` key path (#1450; `''` before
+ * that, and a test double may still send it). Both are misses, and here the IDENTIFIER stands in:
+ * this name is also the phrase a person must TYPE to confirm a critical operation, and nobody should
+ * be asked to type a key path.
+ */
+export declare function resolveOperationDisplayTitle(tResourceOperation: I18nContextType['tResourceOperation'], resourceType: string, operationIdentifier: string): string;
+//# sourceMappingURL=operation-title-resolution.utils.d.ts.map

package/dist/esm/core/i18n/operation-title-resolution.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-title-resolution.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/i18n/operation-title-resolution.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAC1C,kBAAkB,EAAE,eAAe,CAAC,oBAAoB,CAAC,EACzD,YAAY,EAAE,MAAM,EACpB,mBAAmB,EAAE,MAAM,GAC1B,MAAM,CAGR"}

package/dist/esm/core/i18n/operation-title-resolution.utils.js

@@ -0,0 +1,25 @@
+/**
+ * The words that NAME a resource operation to a person: its generated per-operation title
+ * (`resources.{resource}.operations.{operation}.title`), else the operation IDENTIFIER verbatim.
+ *
+ * One function, because three surfaces must agree on it: the action bar's label for a custom
+ * operation, and the type-to-confirm phrase a CRITICAL operation demands on the form-submit path and
+ * on the zero-input action path. The phrase a person is asked to type has to be the name they were
+ * shown on the button; when each surface derived it on its own they could disagree.
+ *
+ * The identifier is the fallback, never a humanized form of it. All three sites used to turn
+ * `reset_to_defaults` into "Reset to defaults" — English produced by code, invisible to translators,
+ * and indistinguishable from a finished label, so nobody generated the real one (#1283,
+ * `.claude/rules/display-text-comes-from-i18n.md`). An identifier is a value rather than invented
+ * words: it keeps an unlabelled operation visible and addressable, and it plainly looks unlabelled.
+ *
+ * `tResourceOperation` answers a missing title with its `resources.` key path (#1450; `''` before
+ * that, and a test double may still send it). Both are misses, and here the IDENTIFIER stands in:
+ * this name is also the phrase a person must TYPE to confirm a critical operation, and nobody should
+ * be asked to type a key path.
+ */
+export function resolveOperationDisplayTitle(tResourceOperation, resourceType, operationIdentifier) {
+    const title = tResourceOperation(resourceType, operationIdentifier, 'title');
+    return title && !title.startsWith('resources.') ? title : operationIdentifier;
+}
+//# sourceMappingURL=operation-title-resolution.utils.js.map

package/dist/esm/core/i18n/operation-title-resolution.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-title-resolution.utils.js","sourceRoot":"","sources":["../../../../../src/core/i18n/operation-title-resolution.utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,4BAA4B,CAC1C,kBAAyD,EACzD,YAAoB,EACpB,mBAA2B;IAE3B,MAAM,KAAK,GAAG,kBAAkB,CAAC,YAAY,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAC7E,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC;AAChF,CAAC","sourcesContent":["import type { I18nContextType } from '~wildo-frontend-lib/core/i18n/I18nContext';\n\n/**\n * The words that NAME a resource operation to a person: its generated per-operation title\n * (`resources.{resource}.operations.{operation}.title`), else the operation IDENTIFIER verbatim.\n *\n * One function, because three surfaces must agree on it: the action bar's label for a custom\n * operation, and the type-to-confirm phrase a CRITICAL operation demands on the form-submit path and\n * on the zero-input action path. The phrase a person is asked to type has to be the name they were\n * shown on the button; when each surface derived it on its own they could disagree.\n *\n * The identifier is the fallback, never a humanized form of it. All three sites used to turn\n * `reset_to_defaults` into \"Reset to defaults\" — English produced by code, invisible to translators,\n * and indistinguishable from a finished label, so nobody generated the real one (#1283,\n * `.claude/rules/display-text-comes-from-i18n.md`). An identifier is a value rather than invented\n * words: it keeps an unlabelled operation visible and addressable, and it plainly looks unlabelled.\n *\n * `tResourceOperation` answers a missing title with its `resources.` key path (#1450; `''` before\n * that, and a test double may still send it). Both are misses, and here the IDENTIFIER stands in:\n * this name is also the phrase a person must TYPE to confirm a critical operation, and nobody should\n * be asked to type a key path.\n */\nexport function resolveOperationDisplayTitle(\n  tResourceOperation: I18nContextType['tResourceOperation'],\n  resourceType: string,\n  operationIdentifier: string,\n): string {\n  const title = tResourceOperation(resourceType, operationIdentifier, 'title');\n  return title && !title.startsWith('resources.') ? title : operationIdentifier;\n}\n"]}

package/dist/esm/core/i18n/regional-preference-resolution.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"regional-preference-resolution.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/i18n/regional-preference-resolution.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,wBAAwB,EAAc,MAAM,qCAAqC,CAAC;AAE5G,OAAO,KAAK,EAAE,+BAA+B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE9F;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mCAAmC,EAAE,wBAAuD,CAAC;AAE1G;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,EACtD,YAAY,EAAE,+BAA+B,GAAG,IAAI,GAAG,SAAS,EAChE,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACzC,wBAAwB,CAgB1B"}
+{"version":3,"file":"regional-preference-resolution.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/i18n/regional-preference-resolution.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,wBAAwB,EAAc,MAAM,qCAAqC,CAAC;AAE5G,OAAO,KAAK,EAAE,+BAA+B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE9F;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mCAAmC,EAAE,wBAAuD,CAAC;AAE1G;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,EACtD,YAAY,EAAE,+BAA+B,GAAG,IAAI,GAAG,SAAS,EAChE,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACzC,wBAAwB,CAgB1B"}

package/dist/esm/core/i18n/regional-preference-resolution.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"regional-preference-resolution.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/i18n/regional-preference-resolution.frontend.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAGnF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAA6B,4BAA4B,CAAC;AAE1G;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAsD,EACtD,YAAgE,EAChE,eAA0C;IAE1C,OAAO;QACL,MAAM,EAAE,MAAM,EAAE,MAAM;eACjB,YAAY,EAAE,MAAM;eACpB,eAAe;eACf,mCAAmC,CAAC,MAAM;QAC/C,QAAQ,EAAE,MAAM,EAAE,QAAQ;eACrB,YAAY,EAAE,QAAQ;eACtB,mCAAmC,CAAC,QAAQ;QACjD,UAAU,EAAG,MAAM,EAAE,UAAyB;eACxC,YAAY,EAAE,UAAyB;eACxC,mCAAmC,CAAC,UAAU;QACnD,UAAU,EAAG,MAAM,EAAE,UAAyB;eACxC,YAAY,EAAE,UAAyB;eACxC,mCAAmC,CAAC,UAAU;KACpD,CAAC;AACJ,CAAC","sourcesContent":["import type { DateFormat, RegionalFormattingConfig, TimeFormat } from '@wildo-ai/presets-components-models';\nimport { REGIONAL_FORMATTING_DEFAULTS } from '@wildo-ai/presets-components-models';\nimport type { OrganizationRegionalPreferences, UserPreferences } from '@wildo-ai/saas-models';\n\n/**\n * The framework FLOOR for regional formatting — what a member in a tenant that has authored nothing\n * sees, and the last link of the chain below.\n *\n * This is `REGIONAL_FORMATTING_DEFAULTS` from `@wildo-ai/presets-components-models`, aliased rather\n * than copied, so the two cannot drift. The name is kept because it is what reads correctly at the\n * end of the `??` chain: \"floor\" states its position in a precedence order, which \"defaults\" does\n * not.\n *\n * **They used to disagree, and the disagreement is why this alias is worth stating.** Until\n * 2026-09-08 this module restated the floor with `dateFormat: LOCALE_DEFAULT` while\n * `REGIONAL_FORMATTING_DEFAULTS` declared `ISO_8601`, and a comment here explained the divergence as\n * deliberate-but-unconsolidated. Enumerating the constant's consumers settled it: there were none\n * that rendered — `I18nContext` imported it without using it, and the only other reference was a\n * test fixture whose formatters are stubs. So nothing depended on `ISO_8601`, the framework floor is\n * locale-driven exactly as `DateFormat.LOCALE_DEFAULT`'s own JSDoc always said, and one constant now\n * answers for both.\n */\nexport const REGIONAL_PREFERENCE_FRAMEWORK_FLOOR: RegionalFormattingConfig = REGIONAL_FORMATTING_DEFAULTS;\n\n/**\n * Resolve regional formatting: MEMBER -> ORGANIZATION -> FRAMEWORK, one field at a time (#410).\n *\n * A pure function rather than an inline `useMemo` body, because this is where the whole decision\n * lives and it is the only thing worth pinning: the React plumbing around it can be changed freely,\n * the precedence cannot.\n *\n * **Per FIELD, never per block.** A member who set only a timezone has expressed nothing about date\n * format, and must still inherit the tenant's. Resolving the block as a unit would make one\n * expressed field silence three unexpressed ones.\n *\n * **Why this could not exist before 2026-09-08.** `UserPreferences_RegionalSchema`'s four fields\n * carried Zod `.default(...)`, and a default MATERIALIZES at parse — so every member with a\n * preferences row carried `'UTC'`, `EN`, `LOCALE_DEFAULT` and `TWENTY_FOUR_HOUR` whether or not they\n * had ever opened the settings screen. The member link was therefore always populated, an\n * organization's setting could reach nobody, and `currentLanguage` was never consulted for `locale`\n * either — so a member reading the application in French got `en` date, time and number formatting.\n * The defaults were not a convenience; they were what made the layer beneath them unreachable.\n *\n * @param member the member's OWN expressed preferences; every field optional, and absence is the\n *   state that lets the organization be heard\n * @param organization the tenant's regional record. It is seeded at provisioning and always carries\n *   all four values, so a tenant that has edited nothing answers with the framework's own values and\n *   this link is a no-op for it\n * @param currentLanguage the resolved UI language, consulted for `locale` only, between the tenant\n *   and the literal floor: absent any declared locale, formatting should follow the language the\n *   person is actually reading\n */\nexport function resolveRegionalFormatting(\n  member: UserPreferences['regional'] | null | undefined,\n  organization: OrganizationRegionalPreferences | null | undefined,\n  currentLanguage: string | null | undefined,\n): RegionalFormattingConfig {\n  return {\n    locale: member?.locale\n      ?? organization?.locale\n      ?? currentLanguage\n      ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.locale,\n    timezone: member?.timezone\n      ?? organization?.timezone\n      ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.timezone,\n    dateFormat: (member?.dateFormat as DateFormat)\n      ?? (organization?.dateFormat as DateFormat)\n      ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.dateFormat,\n    timeFormat: (member?.timeFormat as TimeFormat)\n      ?? (organization?.timeFormat as TimeFormat)\n      ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.timeFormat,\n  };\n}\n"]}
+{"version":3,"file":"regional-preference-resolution.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/i18n/regional-preference-resolution.frontend.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAGnF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAA6B,4BAA4B,CAAC;AAE1G;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAsD,EACtD,YAAgE,EAChE,eAA0C;IAE1C,OAAO;QACL,MAAM,EAAE,MAAM,EAAE,MAAM;eACjB,YAAY,EAAE,MAAM;eACpB,eAAe;eACf,mCAAmC,CAAC,MAAM;QAC/C,QAAQ,EAAE,MAAM,EAAE,QAAQ;eACrB,YAAY,EAAE,QAAQ;eACtB,mCAAmC,CAAC,QAAQ;QACjD,UAAU,EAAG,MAAM,EAAE,UAAyB;eACxC,YAAY,EAAE,UAAyB;eACxC,mCAAmC,CAAC,UAAU;QACnD,UAAU,EAAG,MAAM,EAAE,UAAyB;eACxC,YAAY,EAAE,UAAyB;eACxC,mCAAmC,CAAC,UAAU;KACpD,CAAC;AACJ,CAAC","sourcesContent":["import type { DateFormat, RegionalFormattingConfig, TimeFormat } from '@wildo-ai/presets-components-models';\nimport { REGIONAL_FORMATTING_DEFAULTS } from '@wildo-ai/presets-components-models';\nimport type { OrganizationRegionalPreferences, UserPreferences } from '@wildo-ai/saas-models';\n\n/**\n * The framework FLOOR for regional formatting — what a member in a tenant that has authored nothing\n * sees, and the last link of the chain below.\n *\n * This is `REGIONAL_FORMATTING_DEFAULTS` from `@wildo-ai/presets-components-models`, aliased rather\n * than copied, so the two cannot drift. The name is kept because it is what reads correctly at the\n * end of the `??` chain: \"floor\" states its position in a precedence order, which \"defaults\" does\n * not.\n *\n * **They used to disagree, and the disagreement is why this alias is worth stating.** Until\n * 2026-09-08 this module restated the floor with `dateFormat: LOCALE_DEFAULT` while\n * `REGIONAL_FORMATTING_DEFAULTS` declared `ISO_8601`, and a comment here explained the divergence as\n * deliberate-but-unconsolidated. Enumerating the constant's consumers settled it: there were none\n * that rendered — `I18nContext` imported it without using it, and the only other reference was a\n * test fixture whose formatters are stubs. So nothing depended on `ISO_8601`, the framework floor is\n * locale-driven exactly as `DateFormat.LOCALE_DEFAULT`'s own JSDoc always said, and one constant now\n * answers for both.\n */\nexport const REGIONAL_PREFERENCE_FRAMEWORK_FLOOR: RegionalFormattingConfig = REGIONAL_FORMATTING_DEFAULTS;\n\n/**\n * Resolve regional formatting: MEMBER -> ORGANIZATION -> FRAMEWORK, one field at a time (#410).\n *\n * A pure function rather than an inline `useMemo` body, because this is where the whole decision\n * lives and it is the only thing worth pinning: the React plumbing around it can be changed freely,\n * the precedence cannot.\n *\n * **Per FIELD, never per block.** A member who set only a timezone has expressed nothing about date\n * format, and must still inherit the tenant's. Resolving the block as a unit would make one\n * expressed field silence three unexpressed ones.\n *\n * **Why this could not exist before 2026-09-08.** `UserPreferences_RegionalSchema`'s four fields\n * carried Zod `.default(...)`, and a default MATERIALIZES at parse — so every member with a\n * preferences row carried `'UTC'`, `EN`, `LOCALE_DEFAULT` and `TWENTY_FOUR_HOUR` whether or not they\n * had ever opened the settings screen. The member link was therefore always populated, an\n * organization's setting could reach nobody, and `currentLanguage` was never consulted for `locale`\n * either — so a member reading the application in French got `en` date, time and number formatting.\n * The defaults were not a convenience; they were what made the layer beneath them unreachable.\n *\n * @param member the member's OWN expressed preferences; every field optional, and absence is the\n *   state that lets the organization be heard\n * @param organization the tenant's regional record. It is seeded at provisioning and always carries\n *   all four values, so a tenant that has edited nothing answers with the framework's own values and\n *   this link is a no-op for it\n * @param currentLanguage the resolved UI language, consulted for `locale` only, between the tenant\n *   and the literal floor: absent any declared locale, formatting should follow the language the\n *   person is actually reading\n */\nexport function resolveRegionalFormatting(\n  member: UserPreferences['regional'] | null | undefined,\n  organization: OrganizationRegionalPreferences | null | undefined,\n  currentLanguage: string | null | undefined,\n): RegionalFormattingConfig {\n  return {\n    locale: member?.locale\n      ?? organization?.locale\n      ?? currentLanguage\n      ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.locale,\n    timezone: member?.timezone\n      ?? organization?.timezone\n      ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.timezone,\n    dateFormat: (member?.dateFormat as DateFormat)\n      ?? (organization?.dateFormat as DateFormat)\n      ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.dateFormat,\n    timeFormat: (member?.timeFormat as TimeFormat)\n      ?? (organization?.timeFormat as TimeFormat)\n      ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.timeFormat,\n  };\n}\n"]}

package/dist/esm/core/i18n/useI18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useI18n.d.ts","sourceRoot":"","sources":["../../../../src/core/i18n/useI18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAGlE,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,qBAAqB,GAAG,qBAAqB,EAAE,CAAC;IAC5D,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,oBAAoB,KAAG,eAAe,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CA+DzF,CAAC"}
+{"version":3,"file":"useI18n.d.ts","sourceRoot":"","sources":["../../../../../src/core/i18n/useI18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAGlE,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,qBAAqB,GAAG,qBAAqB,EAAE,CAAC;IAC5D,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,oBAAoB,KAAG,eAAe,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CA+DzF,CAAC"}

package/dist/esm/core/i18n/useI18n.js.map

@@ -1 +1 @@
-{"version":3,"file":"useI18n.js","sourceRoot":"","sources":["../../../../src/core/i18n/useI18n.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useI18n Hook\n *\n * ARCHITECTURE NOTE:\n * This hook is separated from I18nContext.tsx for React Fast Refresh compatibility.\n *\n * React Fast Refresh requires files to export EITHER:\n * - Only React components, OR\n * - Only non-component values (hooks, utilities)\n *\n * Mixing both in a single file causes HMR invalidation loops because Vite cannot\n * determine if the file should be hot-refreshed (components) or fully reloaded (utilities).\n *\n * By separating the hook:\n * - I18nContext.tsx exports only components and types → Fast Refresh works\n * - This file exports only the hook → Clean module boundary\n */\n\nimport { useContext, useEffect, useMemo } from 'react';\nimport type { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { I18nContext, type I18nContextType } from './I18nContext';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nexport interface I18nDependencyConfig {\n  /** Component type(s) — resolves to key path `components.${componentType}` */\n  component?: FrontendComponentType | FrontendComponentType[];\n  /** Resource type(s) — resolves to `resources.${rt}` */\n  resource?: string | string[];\n  /**\n   * Explicit key paths — used directly without transformation.\n   * Must be memoized by the caller (useMemo) when passed inline\n   * to avoid unnecessary requestKeys calls on every render.\n   */\n  keys?: string[];\n}\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('useI18n');\nlogger.setDebugTypeLogging('useI18n', false);\n\n/**\n * Hook to access the internationalization context with optional lazy dependency tracking.\n *\n * Without deps (backward-compatible):\n *   `const { t, tComponent } = useI18n();`\n *   `isReady` is always `true`.\n *\n * With deps (standard pattern for all i18n consumers):\n *   `const { tComponent, isReady } = useI18n({ component: FrontendComponentType.X });`\n *   Declares which translations are needed. Internally calls `requestKeys`\n *   (microbatched) and tracks loading via `isKeyLoaded`.\n *\n * For eager sections (system_enums, errors_*, sidebar_sections, lifecycle),\n * `isReady` is true on first render — zero overhead.\n *\n * @throws Error if used outside of I18nProvider\n */\nexport const useI18n = (deps?: I18nDependencyConfig): I18nContextType & { isReady: boolean } => {\n  const context = useContext(I18nContext);\n  if (!context) {\n    throw new Error('useI18n must be used within an I18nProvider');\n  }\n\n  const resolvedKeys = useMemo(() => {\n    if (!deps) return [];\n    const keys: string[] = [];\n\n    if (deps.component) {\n      const types = Array.isArray(deps.component) ? deps.component : [deps.component];\n      keys.push(...types.map(ct => `components.${ct}`));\n    }\n\n    if (deps.resource) {\n      const resources = Array.isArray(deps.resource) ? deps.resource : [deps.resource];\n      for (const rt of resources) {\n        keys.push(`resources.${rt}`);\n      }\n    }\n\n    if (deps.keys) {\n      keys.push(...deps.keys);\n    }\n\n    return keys;\n  }, [deps?.component, deps?.resource, deps?.keys]);\n\n  useEffect(() => {\n    if (resolvedKeys.length === 0) return;\n    logDebug(`requestKeys [${resolvedKeys.join(', ')}]`);\n    /*\n     * The rejection is CAUGHT here, not floated.\n     *\n     * `requestKeys` rejects when a bundle fetch fails, and this call was fire-and-forget — so every\n     * failed bundle produced an unhandled promise rejection in the browser, on top of the readiness\n     * hang that failure used to cause. The failure is already reported once, by the provider's own\n     * `reportError`; a second, uncatchable copy at the window level is noise that buries it.\n     *\n     * Swallowing is right precisely BECAUSE readiness now settles on failure: the surface renders\n     * with the labels it has and a missing label looks missing, so there is nothing left for a\n     * caller of this hook to do about the rejection.\n     */\n    void context.requestKeys(resolvedKeys).catch(() => undefined);\n  }, [resolvedKeys, context.requestKeys]);\n\n  /*\n   * SETTLED, not loaded. A bundle whose fetch failed is never added to the loaded set, so a\n   * readiness gate keyed on `isKeyLoaded` waited forever: `AutomatedForm` renders a skeleton until\n   * `isReady`, and one failed request made that skeleton permanent. Settling on failure lets the\n   * surface render with the labels it has — a missing label then LOOKS missing, which is the\n   * outcome `.claude/rules/display-text-comes-from-i18n.md` wants, rather than a page that never\n   * arrives.\n   */\n  const isReady = resolvedKeys.length === 0 || resolvedKeys.every(k => context.isKeySettled(k));\n\n  useEffect(() => {\n    if (resolvedKeys.length === 0) return;\n    logDebug(`isReady=${isReady ? 'true' : 'false'} [${resolvedKeys.join(', ')}]`);\n  }, [isReady, resolvedKeys]);\n\n  return { ...context, isReady };\n};\n"]}
+{"version":3,"file":"useI18n.js","sourceRoot":"","sources":["../../../../../src/core/i18n/useI18n.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useI18n Hook\n *\n * ARCHITECTURE NOTE:\n * This hook is separated from I18nContext.tsx for React Fast Refresh compatibility.\n *\n * React Fast Refresh requires files to export EITHER:\n * - Only React components, OR\n * - Only non-component values (hooks, utilities)\n *\n * Mixing both in a single file causes HMR invalidation loops because Vite cannot\n * determine if the file should be hot-refreshed (components) or fully reloaded (utilities).\n *\n * By separating the hook:\n * - I18nContext.tsx exports only components and types → Fast Refresh works\n * - This file exports only the hook → Clean module boundary\n */\n\nimport { useContext, useEffect, useMemo } from 'react';\nimport type { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { I18nContext, type I18nContextType } from './I18nContext';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nexport interface I18nDependencyConfig {\n  /** Component type(s) — resolves to key path `components.${componentType}` */\n  component?: FrontendComponentType | FrontendComponentType[];\n  /** Resource type(s) — resolves to `resources.${rt}` */\n  resource?: string | string[];\n  /**\n   * Explicit key paths — used directly without transformation.\n   * Must be memoized by the caller (useMemo) when passed inline\n   * to avoid unnecessary requestKeys calls on every render.\n   */\n  keys?: string[];\n}\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('useI18n');\nlogger.setDebugTypeLogging('useI18n', false);\n\n/**\n * Hook to access the internationalization context with optional lazy dependency tracking.\n *\n * Without deps (backward-compatible):\n *   `const { t, tComponent } = useI18n();`\n *   `isReady` is always `true`.\n *\n * With deps (standard pattern for all i18n consumers):\n *   `const { tComponent, isReady } = useI18n({ component: FrontendComponentType.X });`\n *   Declares which translations are needed. Internally calls `requestKeys`\n *   (microbatched) and tracks loading via `isKeyLoaded`.\n *\n * For eager sections (system_enums, errors_*, sidebar_sections, lifecycle),\n * `isReady` is true on first render — zero overhead.\n *\n * @throws Error if used outside of I18nProvider\n */\nexport const useI18n = (deps?: I18nDependencyConfig): I18nContextType & { isReady: boolean } => {\n  const context = useContext(I18nContext);\n  if (!context) {\n    throw new Error('useI18n must be used within an I18nProvider');\n  }\n\n  const resolvedKeys = useMemo(() => {\n    if (!deps) return [];\n    const keys: string[] = [];\n\n    if (deps.component) {\n      const types = Array.isArray(deps.component) ? deps.component : [deps.component];\n      keys.push(...types.map(ct => `components.${ct}`));\n    }\n\n    if (deps.resource) {\n      const resources = Array.isArray(deps.resource) ? deps.resource : [deps.resource];\n      for (const rt of resources) {\n        keys.push(`resources.${rt}`);\n      }\n    }\n\n    if (deps.keys) {\n      keys.push(...deps.keys);\n    }\n\n    return keys;\n  }, [deps?.component, deps?.resource, deps?.keys]);\n\n  useEffect(() => {\n    if (resolvedKeys.length === 0) return;\n    logDebug(`requestKeys [${resolvedKeys.join(', ')}]`);\n    /*\n     * The rejection is CAUGHT here, not floated.\n     *\n     * `requestKeys` rejects when a bundle fetch fails, and this call was fire-and-forget — so every\n     * failed bundle produced an unhandled promise rejection in the browser, on top of the readiness\n     * hang that failure used to cause. The failure is already reported once, by the provider's own\n     * `reportError`; a second, uncatchable copy at the window level is noise that buries it.\n     *\n     * Swallowing is right precisely BECAUSE readiness now settles on failure: the surface renders\n     * with the labels it has and a missing label looks missing, so there is nothing left for a\n     * caller of this hook to do about the rejection.\n     */\n    void context.requestKeys(resolvedKeys).catch(() => undefined);\n  }, [resolvedKeys, context.requestKeys]);\n\n  /*\n   * SETTLED, not loaded. A bundle whose fetch failed is never added to the loaded set, so a\n   * readiness gate keyed on `isKeyLoaded` waited forever: `AutomatedForm` renders a skeleton until\n   * `isReady`, and one failed request made that skeleton permanent. Settling on failure lets the\n   * surface render with the labels it has — a missing label then LOOKS missing, which is the\n   * outcome `.claude/rules/display-text-comes-from-i18n.md` wants, rather than a page that never\n   * arrives.\n   */\n  const isReady = resolvedKeys.length === 0 || resolvedKeys.every(k => context.isKeySettled(k));\n\n  useEffect(() => {\n    if (resolvedKeys.length === 0) return;\n    logDebug(`isReady=${isReady ? 'true' : 'false'} [${resolvedKeys.join(', ')}]`);\n  }, [isReady, resolvedKeys]);\n\n  return { ...context, isReady };\n};\n"]}

package/dist/esm/core/icons/IconRegistryBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IconRegistryBridge.d.ts","sourceRoot":"","sources":["../../../../src/core/icons/IconRegistryBridge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAavC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CA2EtE,CAAC"}
+{"version":3,"file":"IconRegistryBridge.d.ts","sourceRoot":"","sources":["../../../../../src/core/icons/IconRegistryBridge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAavC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CA2EtE,CAAC"}

package/dist/esm/core/icons/IconRegistryBridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"IconRegistryBridge.js","sourceRoot":"","sources":["../../../../src/core/icons/IconRegistryBridge.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAQ7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA4C,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC1F,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC3C,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,KAAK,EAAE,CAAC;IAEpD,MAAM,cAAc,GAA0B,OAAO,CAAC,GAAG,EAAE;QACzD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAsB,CAAC;QAChD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAsB,CAAC;QACzD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAsB,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;QAE7C,IAAI,QAAQ,EAAE,sBAAsB,EAAE,CAAC;YACrC,KAAK,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;gBACrF,MAAM,YAAY,GAAG,MAAM,CAAC,qBAAqB,EAAE,IAA4B,CAAC;gBAChF,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;gBACjE,IAAI,kBAAkB,EAAE,CAAC;oBACvB,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;gBAClD,CAAC;gBAED,uEAAuE;gBACvE,oEAAoE;gBACpE,2EAA2E;gBAC3E,MAAM,sBAAsB,GAAG,MAAM,CAAC,qBAAqB,EAAE,cAAc,IAAI,EAAE,CAAC;gBAClF,KAAK,MAAM,uBAAuB,IAAI,sBAAsB,EAAE,CAAC;oBAC7D,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;oBAClF,IAAI,mBAAmB,EAAE,CAAC;wBACxB,aAAa,CAAC,GAAG,CAAC,uBAAuB,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;oBACtE,CAAC;gBACH,CAAC;gBAED,wEAAwE;gBACxE,2DAA2D;gBAC3D,0EAA0E;gBAC1E,MAAM,sBAAsB,GAAG,MAAM,CAAC,qBAAqB,EAAE,cAAc,IAAI,EAAE,CAAC;gBAClF,KAAK,MAAM,uBAAuB,IAAI,sBAAsB,EAAE,CAAC;oBAC7D,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;oBAClF,IAAI,mBAAmB,EAAE,CAAC;wBACxB,MAAM,CAAC,GAAG,CAAC,kBAAkB,uBAAuB,CAAC,GAAG,EAAE,EAAE,mBAAmB,CAAC,CAAC;oBACnF,CAAC;gBACH,CAAC;gBAED,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7E,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;oBAC5B,MAAM,cAAc,GAAG,EAAE,CAAC,uBAAuB,EAAE,YAAoC,CAAC;oBACxF,MAAM,YAAY,GAAG,uBAAuB,CAAC,cAAc,CAAC,CAAC;oBAC7D,IAAI,CAAC,YAAY;wBAAE,SAAS;oBAC5B,MAAM,YAAY,GAAG,GAAG,YAAY,IAAI,MAAM,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC;oBACzE,kBAAkB,CAAC,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;QACH,CAAC;QAED,wEAAwE;QACxE,sEAAsE;QACtE,0CAA0C;QAC1C,KAAK,MAAM,uBAAuB,IAAI,cAAc,IAAI,EAAE,EAAE,CAAC;YAC3D,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;YAClF,IAAI,mBAAmB,EAAE,CAAC;gBACxB,aAAa,CAAC,GAAG,CAAC,uBAAuB,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QAED,wEAAwE;QACxE,8CAA8C;QAC9C,6EAA6E;QAC7E,KAAK,MAAM,wBAAwB,IAAI,eAAe,IAAI,EAAE,EAAE,CAAC;YAC7D,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;YACpF,IAAI,oBAAoB,EAAE,CAAC;gBACzB,MAAM,CAAC,GAAG,CAAC,eAAe,wBAAwB,CAAC,GAAG,EAAE,EAAE,oBAAoB,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;IAClE,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;IAEhD,OAAO,KAAC,oBAAoB,IAAC,cAAc,EAAE,cAAc,YAAG,QAAQ,GAAwB,CAAC;AACjG,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,SAAS,uBAAuB,CAAC,IAA0B;IACzD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,IAA6B,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAqB,EAAE,CAAC;AACzC,CAAC","sourcesContent":["import React, { useMemo } from 'react';\nimport type { IconLike } from '@wildo-ai/zod-decorators';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { CoreIconRegistry } from './icon-registry.frontend.definitions';\nimport { IconRegistryProvider } from './IconRegistryContext';\nimport {\n  type IconConfig,\n  type IconComponent,\n  type IconRegistry,\n  type StandardIconReference,\n} from './icon-registry.frontend.schemas';\n\n/**\n * Data-driven bridge from `ResourceRegistry` + `UIContext` → `IconRegistryProvider`.\n *\n * ## Why this exists\n *\n * Icons are authored on data structures (`ResourceUIBehaviorConfig.icon`,\n * `ResourceOperationFrontendConfig.iconOverride`, `CompositeViewDefinition.icon`).\n * The renderer (`useIconRegistry`) reads them from `CoreIconRegistry` Maps keyed\n * by category. This bridge is the single point that walks the data and produces\n * the Maps, then passes them to {@link IconRegistryProvider} via its existing\n * `customRegistry` prop.\n *\n * ## Why not mutate `CoreIconRegistry.*` directly\n *\n * The historical pattern (`registerResourceIcon` mutating `CoreIconRegistry.resources`\n * from inside the resources-repository) is structurally fragile: it depends on\n * the mutation happening BEFORE `IconRegistryProvider`'s `useMemo` snapshots the\n * core registry. With `IconRegistryProvider` mounted ABOVE `ResourceRegistryProvider`,\n * registry building (and thus the mutation) runs AFTER the first snapshot, and\n * the provider only re-snapshots when its parent re-renders — incidentally\n * triggered by the `customRegistry = {}` default re-allocating each render. Authored\n * icons may not surface until something unrelated forces a re-render.\n *\n * ## Architecture\n *\n * Mount this component BELOW `ResourceRegistryProvider` and `UIProvider`, ABOVE\n * `RouterProvider` (and anything else that may call `useIconRegistry()`). The\n * bridge re-computes its `customRegistry` whenever the resources registry or the\n * `compositeViews` array reference changes — both are stable across renders\n * unless real data changes, so the memo is cheap.\n */\nexport const IconRegistryBridge: React.FC<{ children: React.ReactNode }> = ({ children }) => {\n  const { registry } = useResourceRegistry();\n  const { compositeViews, fullCustomViews } = useUI();\n\n  const customRegistry: Partial<IconRegistry> = useMemo(() => {\n    const resources = new Map<string, IconConfig>();\n    const operationResources = new Map<string, IconConfig>();\n    const compositeView = new Map<string, IconConfig>();\n    const custom = new Map<string, IconConfig>();\n\n    if (registry?.resourceConfigurations) {\n      for (const [resourceType, config] of Object.entries(registry.resourceConfigurations)) {\n        const resourceIcon = config.frontendConfiguration?.icon as IconLike | undefined;\n        const resourceIconConfig = resolveIconLikeToConfig(resourceIcon);\n        if (resourceIconConfig) {\n          resources.set(resourceType, resourceIconConfig);\n        }\n\n        // Resource-owned composite views — surface each composite's icon under\n        // its own `ref` (the same key the sidebar's view resolver uses when\n        // calling `renderIcon({ category: COMPOSITE_VIEW, viewReference: ref })`).\n        const resourceCompositeViews = config.frontendConfiguration?.compositeViews ?? [];\n        for (const compositeViewDefinition of resourceCompositeViews) {\n          const compositeIconConfig = resolveIconLikeToConfig(compositeViewDefinition.icon);\n          if (compositeIconConfig) {\n            compositeView.set(compositeViewDefinition.ref, compositeIconConfig);\n          }\n        }\n\n        // Resource-owned execution views — the launcher resolver looks these up\n        // under the CUSTOM category as `view-execution-{ref}` (see\n        // `resolveConcreteResourceViewTarget`), so register under that exact key.\n        const resourceExecutionViews = config.frontendConfiguration?.executionViews ?? [];\n        for (const executionViewDefinition of resourceExecutionViews) {\n          const executionIconConfig = resolveIconLikeToConfig(executionViewDefinition.icon);\n          if (executionIconConfig) {\n            custom.set(`view-execution-${executionViewDefinition.ref}`, executionIconConfig);\n          }\n        }\n\n        const operations = Array.isArray(config.operations) ? config.operations : [];\n        for (const op of operations) {\n          const opIconOverride = op.operationFrontendConfig?.iconOverride as IconLike | undefined;\n          const opIconConfig = resolveIconLikeToConfig(opIconOverride);\n          if (!opIconConfig) continue;\n          const operationKey = `${resourceType}:${String(op.operationIdentifier)}`;\n          operationResources.set(operationKey, opIconConfig);\n        }\n      }\n    }\n\n    // Application-level composite views live on `UIContext.compositeViews`.\n    // They are siblings of resource-owned composite views for icon lookup\n    // (same registry Map, same `ref` keying).\n    for (const compositeViewDefinition of compositeViews ?? []) {\n      const compositeIconConfig = resolveIconLikeToConfig(compositeViewDefinition.icon);\n      if (compositeIconConfig) {\n        compositeView.set(compositeViewDefinition.ref, compositeIconConfig);\n      }\n    }\n\n    // Application-level full-custom views — resolved by launchers under the\n    // CUSTOM category as `view-custom-{ref}` (see\n    // `resolveConcreteApplicationViewTarget`), so register under that exact key.\n    for (const fullCustomViewDefinition of fullCustomViews ?? []) {\n      const fullCustomIconConfig = resolveIconLikeToConfig(fullCustomViewDefinition.icon);\n      if (fullCustomIconConfig) {\n        custom.set(`view-custom-${fullCustomViewDefinition.ref}`, fullCustomIconConfig);\n      }\n    }\n\n    return { resources, operationResources, compositeView, custom };\n  }, [registry, compositeViews, fullCustomViews]);\n\n  return <IconRegistryProvider customRegistry={customRegistry}>{children}</IconRegistryProvider>;\n};\n\n/**\n * Convert an `IconLike` to a renderable `IconConfig`.\n *\n * - `string` icon → looked up in `CoreIconRegistry.standard` (set during preset\n *   registration). Returns `undefined` if the ref is not a standard icon.\n * - React component → wrapped as `IconConfig { icon: component }`.\n * - `undefined` / empty → `undefined` (caller skips registration).\n */\nfunction resolveIconLikeToConfig(icon: IconLike | undefined): IconConfig | undefined {\n  if (!icon) return undefined;\n  if (typeof icon === 'string') {\n    return CoreIconRegistry.standard.get(icon as StandardIconReference);\n  }\n  return { icon: icon as IconComponent };\n}\n"]}
+{"version":3,"file":"IconRegistryBridge.js","sourceRoot":"","sources":["../../../../../src/core/icons/IconRegistryBridge.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, { useMemo } from 'react';\nimport type { IconLike } from '@wildo-ai/zod-decorators';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { CoreIconRegistry } from './icon-registry.frontend.definitions';\nimport { IconRegistryProvider } from './IconRegistryContext';\nimport {\n  type IconConfig,\n  type IconComponent,\n  type IconRegistry,\n  type StandardIconReference,\n} from './icon-registry.frontend.schemas';\n\n/**\n * Data-driven bridge from `ResourceRegistry` + `UIContext` → `IconRegistryProvider`.\n *\n * ## Why this exists\n *\n * Icons are authored on data structures (`ResourceUIBehaviorConfig.icon`,\n * `ResourceOperationFrontendConfig.iconOverride`, `CompositeViewDefinition.icon`).\n * The renderer (`useIconRegistry`) reads them from `CoreIconRegistry` Maps keyed\n * by category. This bridge is the single point that walks the data and produces\n * the Maps, then passes them to {@link IconRegistryProvider} via its existing\n * `customRegistry` prop.\n *\n * ## Why not mutate `CoreIconRegistry.*` directly\n *\n * The historical pattern (`registerResourceIcon` mutating `CoreIconRegistry.resources`\n * from inside the resources-repository) is structurally fragile: it depends on\n * the mutation happening BEFORE `IconRegistryProvider`'s `useMemo` snapshots the\n * core registry. With `IconRegistryProvider` mounted ABOVE `ResourceRegistryProvider`,\n * registry building (and thus the mutation) runs AFTER the first snapshot, and\n * the provider only re-snapshots when its parent re-renders — incidentally\n * triggered by the `customRegistry = {}` default re-allocating each render. Authored\n * icons may not surface until something unrelated forces a re-render.\n *\n * ## Architecture\n *\n * Mount this component BELOW `ResourceRegistryProvider` and `UIProvider`, ABOVE\n * `RouterProvider` (and anything else that may call `useIconRegistry()`). The\n * bridge re-computes its `customRegistry` whenever the resources registry or the\n * `compositeViews` array reference changes — both are stable across renders\n * unless real data changes, so the memo is cheap.\n */\nexport const IconRegistryBridge: React.FC<{ children: React.ReactNode }> = ({ children }) => {\n  const { registry } = useResourceRegistry();\n  const { compositeViews, fullCustomViews } = useUI();\n\n  const customRegistry: Partial<IconRegistry> = useMemo(() => {\n    const resources = new Map<string, IconConfig>();\n    const operationResources = new Map<string, IconConfig>();\n    const compositeView = new Map<string, IconConfig>();\n    const custom = new Map<string, IconConfig>();\n\n    if (registry?.resourceConfigurations) {\n      for (const [resourceType, config] of Object.entries(registry.resourceConfigurations)) {\n        const resourceIcon = config.frontendConfiguration?.icon as IconLike | undefined;\n        const resourceIconConfig = resolveIconLikeToConfig(resourceIcon);\n        if (resourceIconConfig) {\n          resources.set(resourceType, resourceIconConfig);\n        }\n\n        // Resource-owned composite views — surface each composite's icon under\n        // its own `ref` (the same key the sidebar's view resolver uses when\n        // calling `renderIcon({ category: COMPOSITE_VIEW, viewReference: ref })`).\n        const resourceCompositeViews = config.frontendConfiguration?.compositeViews ?? [];\n        for (const compositeViewDefinition of resourceCompositeViews) {\n          const compositeIconConfig = resolveIconLikeToConfig(compositeViewDefinition.icon);\n          if (compositeIconConfig) {\n            compositeView.set(compositeViewDefinition.ref, compositeIconConfig);\n          }\n        }\n\n        // Resource-owned execution views — the launcher resolver looks these up\n        // under the CUSTOM category as `view-execution-{ref}` (see\n        // `resolveConcreteResourceViewTarget`), so register under that exact key.\n        const resourceExecutionViews = config.frontendConfiguration?.executionViews ?? [];\n        for (const executionViewDefinition of resourceExecutionViews) {\n          const executionIconConfig = resolveIconLikeToConfig(executionViewDefinition.icon);\n          if (executionIconConfig) {\n            custom.set(`view-execution-${executionViewDefinition.ref}`, executionIconConfig);\n          }\n        }\n\n        const operations = Array.isArray(config.operations) ? config.operations : [];\n        for (const op of operations) {\n          const opIconOverride = op.operationFrontendConfig?.iconOverride as IconLike | undefined;\n          const opIconConfig = resolveIconLikeToConfig(opIconOverride);\n          if (!opIconConfig) continue;\n          const operationKey = `${resourceType}:${String(op.operationIdentifier)}`;\n          operationResources.set(operationKey, opIconConfig);\n        }\n      }\n    }\n\n    // Application-level composite views live on `UIContext.compositeViews`.\n    // They are siblings of resource-owned composite views for icon lookup\n    // (same registry Map, same `ref` keying).\n    for (const compositeViewDefinition of compositeViews ?? []) {\n      const compositeIconConfig = resolveIconLikeToConfig(compositeViewDefinition.icon);\n      if (compositeIconConfig) {\n        compositeView.set(compositeViewDefinition.ref, compositeIconConfig);\n      }\n    }\n\n    // Application-level full-custom views — resolved by launchers under the\n    // CUSTOM category as `view-custom-{ref}` (see\n    // `resolveConcreteApplicationViewTarget`), so register under that exact key.\n    for (const fullCustomViewDefinition of fullCustomViews ?? []) {\n      const fullCustomIconConfig = resolveIconLikeToConfig(fullCustomViewDefinition.icon);\n      if (fullCustomIconConfig) {\n        custom.set(`view-custom-${fullCustomViewDefinition.ref}`, fullCustomIconConfig);\n      }\n    }\n\n    return { resources, operationResources, compositeView, custom };\n  }, [registry, compositeViews, fullCustomViews]);\n\n  return <IconRegistryProvider customRegistry={customRegistry}>{children}</IconRegistryProvider>;\n};\n\n/**\n * Convert an `IconLike` to a renderable `IconConfig`.\n *\n * - `string` icon → looked up in `CoreIconRegistry.standard` (set during preset\n *   registration). Returns `undefined` if the ref is not a standard icon.\n * - React component → wrapped as `IconConfig { icon: component }`.\n * - `undefined` / empty → `undefined` (caller skips registration).\n */\nfunction resolveIconLikeToConfig(icon: IconLike | undefined): IconConfig | undefined {\n  if (!icon) return undefined;\n  if (typeof icon === 'string') {\n    return CoreIconRegistry.standard.get(icon as StandardIconReference);\n  }\n  return { icon: icon as IconComponent };\n}\n"]}

package/dist/esm/core/icons/IconRegistryContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IconRegistryContext.d.ts","sourceRoot":"","sources":["../../../../src/core/icons/IconRegistryContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmF,MAAM,OAAO,CAAC;AAExG,OAAO,EACL,YAAY,EACZ,WAAW,EAEX,UAAU,EACV,QAAQ,EACR,qBAAqB,EAQrB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAGnB,MAAM,kCAAkC,CAAC;AA6G1C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,UAAU,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM,GAAG,WAAW,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAAC;IAExH;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAAC;IAE1C;;OAEG;IACH,eAAe,CAAC,aAAa,EAAE,qBAAqB,GAAG,UAAU,CAAC;IAElE;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,qBAAqB,GAAG,aAAa,CAAC;IAElE;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,iBAAiB,CAAC;IAEnF;;OAEG;IACH,OAAO,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;IAE7E;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEpC;;OAEG;IACH,QAAQ,EAAE,YAAY,CAAC;IAEvB;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,QAAA,MAAM,2BAA2B,EAAE,KAAK,CAAC,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAuD,CAAC;AAEvI,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CA8UpE,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,OAAO,2BAAyD,CAAC"}
+{"version":3,"file":"IconRegistryContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/icons/IconRegistryContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmF,MAAM,OAAO,CAAC;AAExG,OAAO,EACL,YAAY,EACZ,WAAW,EAEX,UAAU,EACV,QAAQ,EACR,qBAAqB,EAQrB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAGnB,MAAM,kCAAkC,CAAC;AA6G1C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,UAAU,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM,GAAG,WAAW,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAAC;IAExH;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAAC;IAE1C;;OAEG;IACH,eAAe,CAAC,aAAa,EAAE,qBAAqB,GAAG,UAAU,CAAC;IAElE;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,qBAAqB,GAAG,aAAa,CAAC;IAElE;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,iBAAiB,CAAC;IAEnF;;OAEG;IACH,OAAO,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;IAE7E;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEpC;;OAEG;IACH,QAAQ,EAAE,YAAY,CAAC;IAEvB;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,QAAA,MAAM,2BAA2B,EAAE,KAAK,CAAC,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAuD,CAAC;AAEvI,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAwVpE,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,OAAO,2BAAyD,CAAC"}

package/dist/esm/core/icons/IconRegistryContext.js

@@ -187,6 +187,16 @@ export const IconRegistryProvider = ({ children, customRegistry = {}, coreRegist
                 if (!config && Resources_SharedUtils.parseGeneratedFileRegenerateOperationIdentifier(req.operationReference)) {
                     config = mergedRegistry.standard.get(StandardIconReference.REFRESH);
                 }
+                // The SAME argument, for the framework's OTHER generated operation family
+                // (`collectionExport:<source>`). It was missing, so every collection export — a first-class
+                // toolbar button — rendered `DEFAULT_ICON_CONFIG`, the unresolved-icon placeholder, and two
+                // exports side by side were two identical mystery glyphs. An app CANNOT author its way out:
+                // the operation is synthesized by the framework, so no `iconOverride` exists to write until
+                // the author knows the generated identifier. A download glyph is the uniform semantic —
+                // every export, of every format and row scope, hands the browser a file.
+                if (!config && Resources_SharedUtils.parseGeneratedCollectionExportOperationIdentifier(req.operationReference)) {
+                    config = mergedRegistry.standard.get(StandardIconReference.DOWNLOAD);
+                }
                 if (!config) {
                     warnMissingOperationIcon(req.resourceType, req.operationReference);
                 }