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

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;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;;;;;;;;;;;;;;;;;;;;GAoBG;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"}
+{"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;;;;;;;;;;;;;;;;;;;;GAoBG;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/operation-title-resolution.utils.d.ts.map

@@ -1 +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"}
+{"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/regional-preference-resolution.frontend.utils.d.ts

@@ -1,5 +1,81 @@
 import type { RegionalFormattingConfig } from '@wildo-ai/presets-components-models';
 import type { OrganizationRegionalPreferences, UserPreferences } from '@wildo-ai/saas-models';
+/**
+ * Whether a READER exists whose preferences could speak, as `UserOrgsProvider` knows it (#2242).
+ *
+ * Regional formatting resolves member → organization → framework floor. That chain answers for a
+ * signed-in person, and it answers WRONGLY for somebody with no account: neither link exists, so every
+ * value falls to the floor, and the floor's `UTC` is the value a tenant is SEEDED with — a provisioning
+ * default, not evidence about the person reading. A visitor in New York opening a public legal page would
+ * be told its effective date in UTC. For that reader the only evidence there is comes from their browser,
+ * which is why the three states are kept apart rather than inferred from "both links are null" (that is
+ * equally true of a member whose preferences have not loaded yet, who must NOT be read as accountless).
+ */
+export declare enum RegionalReaderStanding {
+    /**
+     * Not known yet: a session is being restored, or a token exists and no restore has concluded for it.
+     * Resolution is exactly what it was before this distinction existed (member → organization → floor), so
+     * nothing changes for a person who turns out to be signed in. A surface that must not show a provisional
+     * value — a legal date — waits for a settled standing instead.
+     */
+    UNSETTLED = "unsettled",
+    /**
+     * Settled, and no person is loaded: an anonymous visitor (with or without an anonymous session, which
+     * carries no regional preferences), or a session whose restore concluded without a person (the
+     * authorization-error branch keeps the token and loads nobody). No member and no organization can speak,
+     * so the browser's zone, locale and hour cycle stand in — the same evidence the application already uses
+     * for this reader's LANGUAGE (`appPreferences.languages.autoDetectFromBrowser`).
+     */
+    ACCOUNTLESS = "accountless",
+    /**
+     * A person is signed in and their preferences and active organization's have been published. A member
+     * who expressed nothing in a tenant that did not load still falls to the framework floor — that is a
+     * known person in a known system, and the floor is the system's declared answer for them.
+     */
+    SIGNED_IN = "signed-in"
+}
+/**
+ * Derive the reader's standing from the session as `UserOrgsProvider` holds it. Pure, so the ordering —
+ * which is the whole decision — is pinned directly.
+ *
+ * - **Restoring → UNSETTLED**, even with a user loaded: the restore stores preferences LAST (after the
+ *   organizations load), so a loaded user without a finished restore may not have published them yet.
+ * - **A user → SIGNED_IN.**
+ * - **A token, no user, and no restore concluded for that token → UNSETTLED.** The token is persisted, so
+ *   this is the first render of every returning visitor (and of a one-off session, which starts with
+ *   `sessionRestored: true` before its restore runs); reading it as accountless would format their page in
+ *   the browser's zone until their own preferences replaced it.
+ * - **Otherwise → ACCOUNTLESS**: no token, or a restore that concluded for this token without a person.
+ *   Without that second half, a restore ending on an authorization error — which keeps the token — would
+ *   leave the standing UNSETTLED for good, and a surface waiting on it would wait forever.
+ */
+export declare function deriveRegionalReaderStanding(session: {
+    readonly isRestoringSession: boolean;
+    readonly hasUser: boolean;
+    readonly hasAccessToken: boolean;
+    /** A restore has CONCLUDED (whatever its outcome) for the access token held now. */
+    readonly restoreConcludedForAccessToken: boolean;
+}): RegionalReaderStanding;
+/**
+ * What the browser says about where and how its user reads, used ONLY for an
+ * {@link RegionalReaderStanding.ACCOUNTLESS} reader. Each field is `null` when the runtime cannot say.
+ */
+export interface BrowserRegionalEvidence {
+    /** IANA zone the browser runs in (`Intl.DateTimeFormat().resolvedOptions().timeZone`). */
+    readonly timeZone: string | null;
+    /** The browser's own formatting locale, e.g. `en-GB` — which carries the date order `en` alone does not. */
+    readonly locale: string | null;
+}
+/** The reader the resolution is for: whether one is known, and what their browser says. */
+export interface RegionalReader {
+    readonly standing: RegionalReaderStanding;
+    readonly browser: BrowserRegionalEvidence;
+}
+/**
+ * Read the browser's regional evidence. Kept apart from {@link resolveRegionalFormatting} so that function
+ * stays pure and every test can hand it a browser in any zone; this is the one impure read.
+ */
+export declare function readBrowserRegionalEvidence(): BrowserRegionalEvidence;
 /**
  * The framework FLOOR for regional formatting — what a member in a tenant that has authored nothing
  * sees, and the last link of the chain below.
@@ -46,6 +122,11 @@ export declare const REGIONAL_PREFERENCE_FRAMEWORK_FLOOR: RegionalFormattingConf
  * @param currentLanguage the resolved UI language, consulted for `locale` only, between the tenant
  *   and the literal floor: absent any declared locale, formatting should follow the language the
  *   person is actually reading
+ * @param reader whether a reader is known at all (#2242). Only an
+ *   {@link RegionalReaderStanding.ACCOUNTLESS} reader adds a layer — the browser's zone, its locale when it
+ *   is the page's language, and that locale's hour cycle — between the organization and the floor. For the
+ *   other two standings the chain is exactly member → organization → (reading language) → floor. Required,
+ *   not defaulted, so a caller cannot resolve for "nobody" by forgetting to say who is reading.
  */
-export declare function resolveRegionalFormatting(member: UserPreferences['regional'] | null | undefined, organization: OrganizationRegionalPreferences | null | undefined, currentLanguage: string | null | undefined): RegionalFormattingConfig;
+export declare function resolveRegionalFormatting(member: UserPreferences['regional'] | null | undefined, organization: OrganizationRegionalPreferences | null | undefined, currentLanguage: string | null | undefined, reader: RegionalReader): RegionalFormattingConfig;
 //# sourceMappingURL=regional-preference-resolution.frontend.utils.d.ts.map

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,EAAE,MAAM,qCAAqC,CAAC;AAEhG,OAAO,KAAK,EAAE,+BAA+B,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE9F;;;;;;;;;;GAUG;AACH,oBAAY,sBAAsB;IAChC;;;;;OAKG;IACH,SAAS,cAAc;IACvB;;;;;;OAMG;IACH,WAAW,gBAAgB;IAC3B;;;;OAIG;IACH,SAAS,cAAc;CACxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,oFAAoF;IACpF,QAAQ,CAAC,8BAA8B,EAAE,OAAO,CAAC;CAClD,GAAG,sBAAsB,CAKzB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,4GAA4G;IAC5G,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,2FAA2F;AAC3F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;CAC3C;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,uBAAuB,CAOrE;AAkCD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mCAAmC,EAAE,wBAAuD,CAAC;AAE1G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;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,EAC1C,MAAM,EAAE,cAAc,GACrB,wBAAwB,CAsB1B"}

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

@@ -1,4 +1,109 @@
-import { REGIONAL_FORMATTING_DEFAULTS } from '@wildo-ai/presets-components-models';
+import { REGIONAL_FORMATTING_DEFAULTS, TimeFormat } from '@wildo-ai/presets-components-models';
+/**
+ * Whether a READER exists whose preferences could speak, as `UserOrgsProvider` knows it (#2242).
+ *
+ * Regional formatting resolves member → organization → framework floor. That chain answers for a
+ * signed-in person, and it answers WRONGLY for somebody with no account: neither link exists, so every
+ * value falls to the floor, and the floor's `UTC` is the value a tenant is SEEDED with — a provisioning
+ * default, not evidence about the person reading. A visitor in New York opening a public legal page would
+ * be told its effective date in UTC. For that reader the only evidence there is comes from their browser,
+ * which is why the three states are kept apart rather than inferred from "both links are null" (that is
+ * equally true of a member whose preferences have not loaded yet, who must NOT be read as accountless).
+ */
+export var RegionalReaderStanding;
+(function (RegionalReaderStanding) {
+    /**
+     * Not known yet: a session is being restored, or a token exists and no restore has concluded for it.
+     * Resolution is exactly what it was before this distinction existed (member → organization → floor), so
+     * nothing changes for a person who turns out to be signed in. A surface that must not show a provisional
+     * value — a legal date — waits for a settled standing instead.
+     */
+    RegionalReaderStanding["UNSETTLED"] = "unsettled";
+    /**
+     * Settled, and no person is loaded: an anonymous visitor (with or without an anonymous session, which
+     * carries no regional preferences), or a session whose restore concluded without a person (the
+     * authorization-error branch keeps the token and loads nobody). No member and no organization can speak,
+     * so the browser's zone, locale and hour cycle stand in — the same evidence the application already uses
+     * for this reader's LANGUAGE (`appPreferences.languages.autoDetectFromBrowser`).
+     */
+    RegionalReaderStanding["ACCOUNTLESS"] = "accountless";
+    /**
+     * A person is signed in and their preferences and active organization's have been published. A member
+     * who expressed nothing in a tenant that did not load still falls to the framework floor — that is a
+     * known person in a known system, and the floor is the system's declared answer for them.
+     */
+    RegionalReaderStanding["SIGNED_IN"] = "signed-in";
+})(RegionalReaderStanding || (RegionalReaderStanding = {}));
+/**
+ * Derive the reader's standing from the session as `UserOrgsProvider` holds it. Pure, so the ordering —
+ * which is the whole decision — is pinned directly.
+ *
+ * - **Restoring → UNSETTLED**, even with a user loaded: the restore stores preferences LAST (after the
+ *   organizations load), so a loaded user without a finished restore may not have published them yet.
+ * - **A user → SIGNED_IN.**
+ * - **A token, no user, and no restore concluded for that token → UNSETTLED.** The token is persisted, so
+ *   this is the first render of every returning visitor (and of a one-off session, which starts with
+ *   `sessionRestored: true` before its restore runs); reading it as accountless would format their page in
+ *   the browser's zone until their own preferences replaced it.
+ * - **Otherwise → ACCOUNTLESS**: no token, or a restore that concluded for this token without a person.
+ *   Without that second half, a restore ending on an authorization error — which keeps the token — would
+ *   leave the standing UNSETTLED for good, and a surface waiting on it would wait forever.
+ */
+export function deriveRegionalReaderStanding(session) {
+    if (session.isRestoringSession)
+        return RegionalReaderStanding.UNSETTLED;
+    if (session.hasUser)
+        return RegionalReaderStanding.SIGNED_IN;
+    if (session.hasAccessToken && !session.restoreConcludedForAccessToken)
+        return RegionalReaderStanding.UNSETTLED;
+    return RegionalReaderStanding.ACCOUNTLESS;
+}
+/**
+ * Read the browser's regional evidence. Kept apart from {@link resolveRegionalFormatting} so that function
+ * stays pure and every test can hand it a browser in any zone; this is the one impure read.
+ */
+export function readBrowserRegionalEvidence() {
+    try {
+        const options = new Intl.DateTimeFormat().resolvedOptions();
+        return { timeZone: options.timeZone || null, locale: options.locale || null };
+    }
+    catch {
+        return { timeZone: null, locale: null };
+    }
+}
+/** `en-GB` → `en`. Compared case-insensitively, since `pt-BR` and `pt-br` name one language. */
+function primaryLanguageSubtag(locale) {
+    return locale.split('-')[0].toLowerCase();
+}
+/**
+ * The browser's locale, adopted for an accountless reader only when it is the SAME LANGUAGE the page is
+ * being read in. A French browser on a page served in English keeps English formatting — month names in
+ * a language the rest of the page is not in would be worse than a date order that is merely generic — but
+ * an `en-GB` browser on an English page gets `02/10/2026`, the order its user actually reads.
+ */
+function accountlessLocale(browserLocale, currentLanguage) {
+    if (!browserLocale || !currentLanguage)
+        return undefined;
+    return primaryLanguageSubtag(browserLocale) === primaryLanguageSubtag(currentLanguage) ? browserLocale : undefined;
+}
+/**
+ * The hour cycle a locale reads by default, for an accountless reader. `TimeFormat` has no
+ * "follow the locale" member, so the floor's `24h` would otherwise reach an anonymous American as surely
+ * as the floor's `UTC` reaches an anonymous New Yorker. `undefined` when the runtime cannot say.
+ */
+function localeTimeFormat(locale) {
+    try {
+        const hourCycle = new Intl.DateTimeFormat(locale, { hour: 'numeric' }).resolvedOptions().hourCycle;
+        if (hourCycle === 'h11' || hourCycle === 'h12')
+            return TimeFormat.TWELVE_HOUR;
+        if (hourCycle === 'h23' || hourCycle === 'h24')
+            return TimeFormat.TWENTY_FOUR_HOUR;
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 /**
  * The framework FLOOR for regional formatting — what a member in a tenant that has authored nothing
  * sees, and the last link of the chain below.
@@ -45,21 +150,31 @@ export const REGIONAL_PREFERENCE_FRAMEWORK_FLOOR = REGIONAL_FORMATTING_DEFAULTS;
  * @param currentLanguage the resolved UI language, consulted for `locale` only, between the tenant
  *   and the literal floor: absent any declared locale, formatting should follow the language the
  *   person is actually reading
+ * @param reader whether a reader is known at all (#2242). Only an
+ *   {@link RegionalReaderStanding.ACCOUNTLESS} reader adds a layer — the browser's zone, its locale when it
+ *   is the page's language, and that locale's hour cycle — between the organization and the floor. For the
+ *   other two standings the chain is exactly member → organization → (reading language) → floor. Required,
+ *   not defaulted, so a caller cannot resolve for "nobody" by forgetting to say who is reading.
  */
-export function resolveRegionalFormatting(member, organization, currentLanguage) {
+export function resolveRegionalFormatting(member, organization, currentLanguage, reader) {
+    const accountless = reader.standing === RegionalReaderStanding.ACCOUNTLESS;
+    const locale = member?.locale
+        ?? organization?.locale
+        ?? (accountless ? accountlessLocale(reader.browser.locale, currentLanguage) : undefined)
+        ?? currentLanguage
+        ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.locale;
     return {
-        locale: member?.locale
-            ?? organization?.locale
-            ?? currentLanguage
-            ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.locale,
+        locale,
         timezone: member?.timezone
             ?? organization?.timezone
+            ?? (accountless ? reader.browser.timeZone ?? undefined : undefined)
             ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.timezone,
         dateFormat: member?.dateFormat
             ?? organization?.dateFormat
             ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.dateFormat,
         timeFormat: member?.timeFormat
             ?? organization?.timeFormat
+            ?? (accountless ? localeTimeFormat(locale) : undefined)
             ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.timeFormat,
     };
 }

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":"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","sourcesContent":["import type { DateFormat, RegionalFormattingConfig } from '@wildo-ai/presets-components-models';\nimport { REGIONAL_FORMATTING_DEFAULTS, TimeFormat } from '@wildo-ai/presets-components-models';\nimport type { OrganizationRegionalPreferences, UserPreferences } from '@wildo-ai/saas-models';\n\n/**\n * Whether a READER exists whose preferences could speak, as `UserOrgsProvider` knows it (#2242).\n *\n * Regional formatting resolves member → organization → framework floor. That chain answers for a\n * signed-in person, and it answers WRONGLY for somebody with no account: neither link exists, so every\n * value falls to the floor, and the floor's `UTC` is the value a tenant is SEEDED with — a provisioning\n * default, not evidence about the person reading. A visitor in New York opening a public legal page would\n * be told its effective date in UTC. For that reader the only evidence there is comes from their browser,\n * which is why the three states are kept apart rather than inferred from \"both links are null\" (that is\n * equally true of a member whose preferences have not loaded yet, who must NOT be read as accountless).\n */\nexport enum RegionalReaderStanding {\n  /**\n   * Not known yet: a session is being restored, or a token exists and no restore has concluded for it.\n   * Resolution is exactly what it was before this distinction existed (member → organization → floor), so\n   * nothing changes for a person who turns out to be signed in. A surface that must not show a provisional\n   * value — a legal date — waits for a settled standing instead.\n   */\n  UNSETTLED = 'unsettled',\n  /**\n   * Settled, and no person is loaded: an anonymous visitor (with or without an anonymous session, which\n   * carries no regional preferences), or a session whose restore concluded without a person (the\n   * authorization-error branch keeps the token and loads nobody). No member and no organization can speak,\n   * so the browser's zone, locale and hour cycle stand in — the same evidence the application already uses\n   * for this reader's LANGUAGE (`appPreferences.languages.autoDetectFromBrowser`).\n   */\n  ACCOUNTLESS = 'accountless',\n  /**\n   * A person is signed in and their preferences and active organization's have been published. A member\n   * who expressed nothing in a tenant that did not load still falls to the framework floor — that is a\n   * known person in a known system, and the floor is the system's declared answer for them.\n   */\n  SIGNED_IN = 'signed-in',\n}\n\n/**\n * Derive the reader's standing from the session as `UserOrgsProvider` holds it. Pure, so the ordering —\n * which is the whole decision — is pinned directly.\n *\n * - **Restoring → UNSETTLED**, even with a user loaded: the restore stores preferences LAST (after the\n *   organizations load), so a loaded user without a finished restore may not have published them yet.\n * - **A user → SIGNED_IN.**\n * - **A token, no user, and no restore concluded for that token → UNSETTLED.** The token is persisted, so\n *   this is the first render of every returning visitor (and of a one-off session, which starts with\n *   `sessionRestored: true` before its restore runs); reading it as accountless would format their page in\n *   the browser's zone until their own preferences replaced it.\n * - **Otherwise → ACCOUNTLESS**: no token, or a restore that concluded for this token without a person.\n *   Without that second half, a restore ending on an authorization error — which keeps the token — would\n *   leave the standing UNSETTLED for good, and a surface waiting on it would wait forever.\n */\nexport function deriveRegionalReaderStanding(session: {\n  readonly isRestoringSession: boolean;\n  readonly hasUser: boolean;\n  readonly hasAccessToken: boolean;\n  /** A restore has CONCLUDED (whatever its outcome) for the access token held now. */\n  readonly restoreConcludedForAccessToken: boolean;\n}): RegionalReaderStanding {\n  if (session.isRestoringSession) return RegionalReaderStanding.UNSETTLED;\n  if (session.hasUser) return RegionalReaderStanding.SIGNED_IN;\n  if (session.hasAccessToken && !session.restoreConcludedForAccessToken) return RegionalReaderStanding.UNSETTLED;\n  return RegionalReaderStanding.ACCOUNTLESS;\n}\n\n/**\n * What the browser says about where and how its user reads, used ONLY for an\n * {@link RegionalReaderStanding.ACCOUNTLESS} reader. Each field is `null` when the runtime cannot say.\n */\nexport interface BrowserRegionalEvidence {\n  /** IANA zone the browser runs in (`Intl.DateTimeFormat().resolvedOptions().timeZone`). */\n  readonly timeZone: string | null;\n  /** The browser's own formatting locale, e.g. `en-GB` — which carries the date order `en` alone does not. */\n  readonly locale: string | null;\n}\n\n/** The reader the resolution is for: whether one is known, and what their browser says. */\nexport interface RegionalReader {\n  readonly standing: RegionalReaderStanding;\n  readonly browser: BrowserRegionalEvidence;\n}\n\n/**\n * Read the browser's regional evidence. Kept apart from {@link resolveRegionalFormatting} so that function\n * stays pure and every test can hand it a browser in any zone; this is the one impure read.\n */\nexport function readBrowserRegionalEvidence(): BrowserRegionalEvidence {\n  try {\n    const options = new Intl.DateTimeFormat().resolvedOptions();\n    return { timeZone: options.timeZone || null, locale: options.locale || null };\n  } catch {\n    return { timeZone: null, locale: null };\n  }\n}\n\n/** `en-GB` → `en`. Compared case-insensitively, since `pt-BR` and `pt-br` name one language. */\nfunction primaryLanguageSubtag(locale: string): string {\n  return locale.split('-')[0]!.toLowerCase();\n}\n\n/**\n * The browser's locale, adopted for an accountless reader only when it is the SAME LANGUAGE the page is\n * being read in. A French browser on a page served in English keeps English formatting — month names in\n * a language the rest of the page is not in would be worse than a date order that is merely generic — but\n * an `en-GB` browser on an English page gets `02/10/2026`, the order its user actually reads.\n */\nfunction accountlessLocale(browserLocale: string | null, currentLanguage: string | null | undefined): string | undefined {\n  if (!browserLocale || !currentLanguage) return undefined;\n  return primaryLanguageSubtag(browserLocale) === primaryLanguageSubtag(currentLanguage) ? browserLocale : undefined;\n}\n\n/**\n * The hour cycle a locale reads by default, for an accountless reader. `TimeFormat` has no\n * \"follow the locale\" member, so the floor's `24h` would otherwise reach an anonymous American as surely\n * as the floor's `UTC` reaches an anonymous New Yorker. `undefined` when the runtime cannot say.\n */\nfunction localeTimeFormat(locale: string): TimeFormat | undefined {\n  try {\n    const hourCycle = new Intl.DateTimeFormat(locale, { hour: 'numeric' }).resolvedOptions().hourCycle;\n    if (hourCycle === 'h11' || hourCycle === 'h12') return TimeFormat.TWELVE_HOUR;\n    if (hourCycle === 'h23' || hourCycle === 'h24') return TimeFormat.TWENTY_FOUR_HOUR;\n    return undefined;\n  } catch {\n    return undefined;\n  }\n}\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 * @param reader whether a reader is known at all (#2242). Only an\n *   {@link RegionalReaderStanding.ACCOUNTLESS} reader adds a layer — the browser's zone, its locale when it\n *   is the page's language, and that locale's hour cycle — between the organization and the floor. For the\n *   other two standings the chain is exactly member → organization → (reading language) → floor. Required,\n *   not defaulted, so a caller cannot resolve for \"nobody\" by forgetting to say who is reading.\n */\nexport function resolveRegionalFormatting(\n  member: UserPreferences['regional'] | null | undefined,\n  organization: OrganizationRegionalPreferences | null | undefined,\n  currentLanguage: string | null | undefined,\n  reader: RegionalReader,\n): RegionalFormattingConfig {\n  const accountless = reader.standing === RegionalReaderStanding.ACCOUNTLESS;\n  const locale = member?.locale\n    ?? organization?.locale\n    ?? (accountless ? accountlessLocale(reader.browser.locale, currentLanguage) : undefined)\n    ?? currentLanguage\n    ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.locale;\n\n  return {\n    locale,\n    timezone: member?.timezone\n      ?? organization?.timezone\n      ?? (accountless ? reader.browser.timeZone ?? undefined : undefined)\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      ?? (accountless ? localeTimeFormat(locale) : undefined)\n      ?? REGIONAL_PREFERENCE_FRAMEWORK_FLOOR.timeFormat,\n  };\n}\n"]}

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

@@ -12,7 +12,9 @@
  * determine if the file should be hot-refreshed (components) or fully reloaded (utilities).
  *
  * By separating the hook:
- * - I18nContext.tsx exports only components and types → Fast Refresh works
+ * - The hook is not mixed into I18nContext.tsx. That file is not purely components either (it also exports
+ *   context objects, `unresolvedLabel` and a re-exported enum), so it is fully reloaded on edit rather than
+ *   hot-refreshed; keeping the hook out of it is what keeps this module's boundary clean.
  * - This file exports only the hook → Clean module boundary
  */
 import type { FrontendComponentType } from '@wildo-ai/presets-components-models';

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;;;;;;;;;;;;;;;;;GAiBG;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;;;;;;;;;;;;;;;;;;GAkBG;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;;;;;;;;;;;;;;;;;GAiBG;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

@@ -12,7 +12,9 @@
  * determine if the file should be hot-refreshed (components) or fully reloaded (utilities).
  *
  * By separating the hook:
- * - I18nContext.tsx exports only components and types → Fast Refresh works
+ * - The hook is not mixed into I18nContext.tsx. That file is not purely components either (it also exports
+ *   context objects, `unresolvedLabel` and a re-exported enum), so it is fully reloaded on edit rather than
+ *   hot-refreshed; keeping the hook out of it is what keeps this module's boundary clean.
  * - This file exports only the hook → Clean module boundary
  */
 import { useContext, useEffect, useMemo } from 'react';

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 (`EAGER_I18N_SECTIONS`: system_enums, errors_*, sidebar_sections, settings_hub, lifecycle,\n * billing_features, billing_limits),\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 * - The hook is not mixed into I18nContext.tsx. That file is not purely components either (it also exports\n *   context objects, `unresolvedLabel` and a re-exported enum), so it is fully reloaded on edit rather than\n *   hot-refreshed; keeping the hook out of it is what keeps this module's boundary clean.\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 (`EAGER_I18N_SECTIONS`: system_enums, errors_*, sidebar_sections, settings_hub, lifecycle,\n * billing_features, billing_limits),\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

@@ -1,11 +1,16 @@
 import React from 'react';
+import type { FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas';
+import type { CompositeViewDefinition } from '../../core/config/composite-view.schemas';
+import type { FullCustomViewDefinition } from '../../core/config/full-custom-view.schemas';
+import type { FlowsActorsViewDefinition } from '../../core/config/flows-actors-view.schemas';
+import { type IconRegistry } from './icon-registry.frontend.schemas';
 /**
  * Data-driven bridge from `ResourceRegistry` + `UIContext` → `IconRegistryProvider`.
  *
  * ## Why this exists
  *
  * Icons are authored on data structures (`ResourceUIBehaviorConfig.icon`,
- * `ResourceOperationFrontendConfig.iconOverride`, `CompositeViewDefinition.icon`).
+ * `ResourceOperationFrontendConfig.iconOverride`, and every view definition's `icon`).
  * The renderer (`useIconRegistry`) reads them from `CoreIconRegistry` Maps keyed
  * by category. This bridge is the single point that walks the data and produces
  * the Maps, then passes them to {@link IconRegistryProvider} via its existing
@@ -26,11 +31,40 @@ import React from 'react';
  *
  * Mount this component BELOW `ResourceRegistryProvider` and `UIProvider`, ABOVE
  * `RouterProvider` (and anything else that may call `useIconRegistry()`). The
- * bridge re-computes its `customRegistry` whenever the resources registry or the
- * `compositeViews` array reference changes — both are stable across renders
- * unless real data changes, so the memo is cheap.
+ * bridge re-computes its `customRegistry` (through {@link buildAuthoredIconRegistry})
+ * whenever the resources registry or one of the app-level view arrays changes —
+ * all are stable across renders unless real data changes, so the memo is cheap.
  */
 export declare const IconRegistryBridge: React.FC<{
     children: React.ReactNode;
 }>;
+/** The authored data {@link buildAuthoredIconRegistry} walks — every surface an icon can be declared on. */
+export interface AuthoredIconRegistrySources {
+    registry: FrontendResourcesRegistry | null | undefined;
+    compositeViews: CompositeViewDefinition[] | undefined;
+    fullCustomViews: FullCustomViewDefinition[] | undefined;
+    flowsActorsViews: FlowsActorsViewDefinition[] | undefined;
+}
+/**
+ * Walk every authored icon and key it exactly as its consumers look it up.
+ *
+ * Pure, so the key vocabulary can be pinned without mounting the provider tree. Each family's key
+ * must match what the launcher resolution (`launcher-resolution.ts`) and the view header
+ * (`ViewLayout_Header`'s `VIEW_ICON_KEY_PREFIX`) ask the registry for:
+ *
+ * | family | category | key |
+ * |---|---|---|
+ * | resource | `resources` | `<resourceType>` |
+ * | operation override | `operationResources` | `<resourceType>:<operation>` |
+ * | composite view (resource-owned or app-level) | `compositeView` | `<ref>` |
+ * | execution view (resource-owned) | `custom` | `view-execution-<ref>` |
+ * | chart view (resource-owned) | `custom` | `view-chart-<ref>` |
+ * | full-custom view (app-level) | `custom` | `view-custom-<ref>` |
+ * | flows-actors view (app-level) | `custom` | `view-flows-<ref>` |
+ *
+ * Chart and flows-actors views were absent until #2281: their definitions carried no `icon`, so a
+ * launcher for either could only resolve the alert-circle placeholder and an author had no field to
+ * fix it with.
+ */
+export declare function buildAuthoredIconRegistry(sources: AuthoredIconRegistrySources): Partial<IconRegistry>;
 //# sourceMappingURL=IconRegistryBridge.d.ts.map

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;AAIvC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAC/G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wDAAwD,CAAC;AACtG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0DAA0D,CAAC;AACzG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAG3G,OAAO,EAGL,KAAK,YAAY,EAElB,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAUtE,CAAC;AAEF,4GAA4G;AAC5G,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,CAAC;IACvD,cAAc,EAAE,uBAAuB,EAAE,GAAG,SAAS,CAAC;IACtD,eAAe,EAAE,wBAAwB,EAAE,GAAG,SAAS,CAAC;IACxD,gBAAgB,EAAE,yBAAyB,EAAE,GAAG,SAAS,CAAC;CAC3D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,YAAY,CAAC,CAwFrG"}