tempest-react-sdk 0.52.0 → 0.54.0

package/dist/http/parse-response.cjs

@@ -1,3 +1,3 @@
-function e(e,t,n){let r=e.safeParse(t);if(r.success)return r.data;if(typeof process<`u`&&(process.env.NODE_ENV===`development`||process.env.NODE_ENV===`test`)){let e=r.error.issues.map(e=>`  - ${e.path.join(`.`)||`<root>`}: ${e.message}`).join(`
-`);throw Error(`[parseResponse] Contract drift on ${n}:\n${e}\n\nRaw payload: ${JSON.stringify(t,null,2)}`)}throw Error(`Resposta inválida do servidor (${n}).`)}exports.parseResponse=e;
+const e=require("../utils/dev-mode.cjs");function t(t,n,r){let i=t.safeParse(n);if(i.success)return i.data;if(e.isDevBuild()){let e=i.error.issues.map(e=>`  - ${e.path.join(`.`)||`<root>`}: ${e.message}`).join(`
+`);throw Error(`[parseResponse] Contract drift on ${r}:\n${e}\n\nRaw payload: ${JSON.stringify(n,null,2)}`)}throw Error(`Resposta inválida do servidor (${r}).`)}exports.parseResponse=t;
 //# sourceMappingURL=parse-response.cjs.map

package/dist/http/parse-response.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"parse-response.cjs","names":[],"sources":["../../src/http/parse-response.ts"],"sourcesContent":["import type { z } from \"zod\";\n\n/**\n * Validate an unknown response payload against a zod schema.\n *\n * In development, throws a detailed error pointing at the divergent field.\n * In production, throws a generic error so internals do not leak to users.\n *\n * @param schema - The zod schema to parse against.\n * @param raw - The raw response payload.\n * @param context - A label used in error messages, e.g. \"POST /auth/login\".\n * @returns The parsed, typed payload.\n */\nexport function parseResponse<TSchema extends z.ZodTypeAny>(\n    schema: TSchema,\n    raw: unknown,\n    context: string,\n): z.infer<TSchema> {\n    const result = schema.safeParse(raw);\n    if (result.success) {\n        return result.data;\n    }\n\n    const isDev =\n        typeof process !== \"undefined\" &&\n        (process.env?.NODE_ENV === \"development\" || process.env?.NODE_ENV === \"test\");\n\n    if (isDev) {\n        const issues = result.error.issues\n            .map((i) => `  - ${i.path.join(\".\") || \"<root>\"}: ${i.message}`)\n            .join(\"\\n\");\n        throw new Error(\n            `[parseResponse] Contract drift on ${context}:\\n${issues}\\n\\nRaw payload: ${JSON.stringify(raw, null, 2)}`,\n        );\n    }\n    throw new Error(`Resposta inválida do servidor (${context}).`);\n}\n"],"mappings":"AAaA,SAAgB,EACZ,EACA,EACA,EACgB,CAChB,IAAM,EAAS,EAAO,UAAU,CAAG,EACnC,GAAI,EAAO,QACP,OAAO,EAAO,KAOlB,GAHI,OAAO,QAAY,MAAA,QAAA,IAAA,WACQ,eAAA,QAAA,IAAA,WAA2C,QAE/D,CACP,IAAM,EAAS,EAAO,MAAM,OACvB,IAAK,GAAM,OAAO,EAAE,KAAK,KAAK,GAAG,GAAK,SAAS,IAAI,EAAE,SAAS,CAAC,CAC/D,KAAK;CAAI,EACd,MAAU,MACN,qCAAqC,EAAQ,KAAK,EAAO,mBAAmB,KAAK,UAAU,EAAK,KAAM,CAAC,GAC3G,CACJ,CACA,MAAU,MAAM,kCAAkC,EAAQ,GAAG,CACjE"}
+{"version":3,"file":"parse-response.cjs","names":[],"sources":["../../src/http/parse-response.ts"],"sourcesContent":["import type { z } from \"zod\";\n\nimport { isDevBuild } from \"../utils/dev-mode\";\n\n/**\n * Validate an unknown response payload against a zod schema.\n *\n * A development build throws a detailed error naming every divergent field path\n * and embedding the raw payload; every other build throws a generic sentence, so\n * server internals never reach a user's screen or an error tracker.\n *\n * Which one you get comes from `isDevBuild()`, the SDK's single answer to that\n * question, rather than from a check written here. This function used to ask\n * `typeof process !== \"undefined\" && process.env?.NODE_ENV === \"development\"`,\n * and a browser has no `process` identifier at all — so the guard short-circuited\n * and the detailed branch was dead in exactly the build it was written for, no\n * matter what the bundler substituted behind it.\n *\n * The rule `isDevBuild()` applies is `NODE_ENV !== \"production\"`, which is wider\n * than the old `\"development\" || \"test\"`: a staging build that never sets\n * `NODE_ENV=production` gets the drift report, raw payload included.\n *\n * @param schema - The zod schema to parse against.\n * @param raw - The raw response payload.\n * @param context - A label used in error messages, e.g. \"POST /auth/login\".\n * @returns The parsed, typed payload.\n * @throws Error When the payload does not match the schema: `[parseResponse]\n * Contract drift on <context>` with the field paths and the raw payload in a\n * development build, `Resposta inválida do servidor (<context>).` otherwise.\n */\nexport function parseResponse<TSchema extends z.ZodTypeAny>(\n    schema: TSchema,\n    raw: unknown,\n    context: string,\n): z.infer<TSchema> {\n    const result = schema.safeParse(raw);\n    if (result.success) {\n        return result.data;\n    }\n\n    if (isDevBuild()) {\n        const issues = result.error.issues\n            .map((i) => `  - ${i.path.join(\".\") || \"<root>\"}: ${i.message}`)\n            .join(\"\\n\");\n        throw new Error(\n            `[parseResponse] Contract drift on ${context}:\\n${issues}\\n\\nRaw payload: ${JSON.stringify(raw, null, 2)}`,\n        );\n    }\n    throw new Error(`Resposta inválida do servidor (${context}).`);\n}\n"],"mappings":"yCA8BA,SAAgB,EACZ,EACA,EACA,EACgB,CAChB,IAAM,EAAS,EAAO,UAAU,CAAG,EACnC,GAAI,EAAO,QACP,OAAO,EAAO,KAGlB,GAAI,EAAA,WAAW,EAAG,CACd,IAAM,EAAS,EAAO,MAAM,OACvB,IAAK,GAAM,OAAO,EAAE,KAAK,KAAK,GAAG,GAAK,SAAS,IAAI,EAAE,SAAS,CAAC,CAC/D,KAAK;CAAI,EACd,MAAU,MACN,qCAAqC,EAAQ,KAAK,EAAO,mBAAmB,KAAK,UAAU,EAAK,KAAM,CAAC,GAC3G,CACJ,CACA,MAAU,MAAM,kCAAkC,EAAQ,GAAG,CACjE"}

package/dist/http/parse-response.js

@@ -1,14 +1,15 @@
+import { isDevBuild as e } from "../utils/dev-mode.js";
 //#region src/http/parse-response.ts
-function e(e, t, n) {
-	let r = e.safeParse(t);
-	if (r.success) return r.data;
-	if (typeof process < "u" && (process.env.NODE_ENV === "development" || process.env.NODE_ENV === "test")) {
-		let e = r.error.issues.map((e) => `  - ${e.path.join(".") || "<root>"}: ${e.message}`).join("\n");
-		throw Error(`[parseResponse] Contract drift on ${n}:\n${e}\n\nRaw payload: ${JSON.stringify(t, null, 2)}`);
+function t(t, n, r) {
+	let i = t.safeParse(n);
+	if (i.success) return i.data;
+	if (e()) {
+		let e = i.error.issues.map((e) => `  - ${e.path.join(".") || "<root>"}: ${e.message}`).join("\n");
+		throw Error(`[parseResponse] Contract drift on ${r}:\n${e}\n\nRaw payload: ${JSON.stringify(n, null, 2)}`);
 	}
-	throw Error(`Resposta inválida do servidor (${n}).`);
+	throw Error(`Resposta inválida do servidor (${r}).`);
 }
 //#endregion
-export { e as parseResponse };
+export { t as parseResponse };
 
 //# sourceMappingURL=parse-response.js.map

package/dist/http/parse-response.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse-response.js","names":[],"sources":["../../src/http/parse-response.ts"],"sourcesContent":["import type { z } from \"zod\";\n\n/**\n * Validate an unknown response payload against a zod schema.\n *\n * In development, throws a detailed error pointing at the divergent field.\n * In production, throws a generic error so internals do not leak to users.\n *\n * @param schema - The zod schema to parse against.\n * @param raw - The raw response payload.\n * @param context - A label used in error messages, e.g. \"POST /auth/login\".\n * @returns The parsed, typed payload.\n */\nexport function parseResponse<TSchema extends z.ZodTypeAny>(\n    schema: TSchema,\n    raw: unknown,\n    context: string,\n): z.infer<TSchema> {\n    const result = schema.safeParse(raw);\n    if (result.success) {\n        return result.data;\n    }\n\n    const isDev =\n        typeof process !== \"undefined\" &&\n        (process.env?.NODE_ENV === \"development\" || process.env?.NODE_ENV === \"test\");\n\n    if (isDev) {\n        const issues = result.error.issues\n            .map((i) => `  - ${i.path.join(\".\") || \"<root>\"}: ${i.message}`)\n            .join(\"\\n\");\n        throw new Error(\n            `[parseResponse] Contract drift on ${context}:\\n${issues}\\n\\nRaw payload: ${JSON.stringify(raw, null, 2)}`,\n        );\n    }\n    throw new Error(`Resposta inválida do servidor (${context}).`);\n}\n"],"mappings":";AAaA,SAAgB,EACZ,GACA,GACA,GACgB;CAChB,IAAM,IAAS,EAAO,UAAU,CAAG;CACnC,IAAI,EAAO,SACP,OAAO,EAAO;CAOlB,IAHI,OAAO,UAAY,QAAA,QAAA,IAAA,aACQ,iBAAA,QAAA,IAAA,aAA2C,SAE/D;EACP,IAAM,IAAS,EAAO,MAAM,OACvB,KAAK,MAAM,OAAO,EAAE,KAAK,KAAK,GAAG,KAAK,SAAS,IAAI,EAAE,SAAS,CAAC,CAC/D,KAAK,IAAI;EACd,MAAU,MACN,qCAAqC,EAAQ,KAAK,EAAO,mBAAmB,KAAK,UAAU,GAAK,MAAM,CAAC,GAC3G;CACJ;CACA,MAAU,MAAM,kCAAkC,EAAQ,GAAG;AACjE"}
+{"version":3,"file":"parse-response.js","names":[],"sources":["../../src/http/parse-response.ts"],"sourcesContent":["import type { z } from \"zod\";\n\nimport { isDevBuild } from \"../utils/dev-mode\";\n\n/**\n * Validate an unknown response payload against a zod schema.\n *\n * A development build throws a detailed error naming every divergent field path\n * and embedding the raw payload; every other build throws a generic sentence, so\n * server internals never reach a user's screen or an error tracker.\n *\n * Which one you get comes from `isDevBuild()`, the SDK's single answer to that\n * question, rather than from a check written here. This function used to ask\n * `typeof process !== \"undefined\" && process.env?.NODE_ENV === \"development\"`,\n * and a browser has no `process` identifier at all — so the guard short-circuited\n * and the detailed branch was dead in exactly the build it was written for, no\n * matter what the bundler substituted behind it.\n *\n * The rule `isDevBuild()` applies is `NODE_ENV !== \"production\"`, which is wider\n * than the old `\"development\" || \"test\"`: a staging build that never sets\n * `NODE_ENV=production` gets the drift report, raw payload included.\n *\n * @param schema - The zod schema to parse against.\n * @param raw - The raw response payload.\n * @param context - A label used in error messages, e.g. \"POST /auth/login\".\n * @returns The parsed, typed payload.\n * @throws Error When the payload does not match the schema: `[parseResponse]\n * Contract drift on <context>` with the field paths and the raw payload in a\n * development build, `Resposta inválida do servidor (<context>).` otherwise.\n */\nexport function parseResponse<TSchema extends z.ZodTypeAny>(\n    schema: TSchema,\n    raw: unknown,\n    context: string,\n): z.infer<TSchema> {\n    const result = schema.safeParse(raw);\n    if (result.success) {\n        return result.data;\n    }\n\n    if (isDevBuild()) {\n        const issues = result.error.issues\n            .map((i) => `  - ${i.path.join(\".\") || \"<root>\"}: ${i.message}`)\n            .join(\"\\n\");\n        throw new Error(\n            `[parseResponse] Contract drift on ${context}:\\n${issues}\\n\\nRaw payload: ${JSON.stringify(raw, null, 2)}`,\n        );\n    }\n    throw new Error(`Resposta inválida do servidor (${context}).`);\n}\n"],"mappings":";;AA8BA,SAAgB,EACZ,GACA,GACA,GACgB;CAChB,IAAM,IAAS,EAAO,UAAU,CAAG;CACnC,IAAI,EAAO,SACP,OAAO,EAAO;CAGlB,IAAI,EAAW,GAAG;EACd,IAAM,IAAS,EAAO,MAAM,OACvB,KAAK,MAAM,OAAO,EAAE,KAAK,KAAK,GAAG,KAAK,SAAS,IAAI,EAAE,SAAS,CAAC,CAC/D,KAAK,IAAI;EACd,MAAU,MACN,qCAAqC,EAAQ,KAAK,EAAO,mBAAmB,KAAK,UAAU,GAAK,MAAM,CAAC,GAC3G;CACJ;CACA,MAAU,MAAM,kCAAkC,EAAQ,GAAG;AACjE"}

package/dist/i18n/create-i18n.cjs

@@ -1,2 +1,2 @@
-function e(e,t){return t?e.replace(/\{(\w+)\}/g,(e,n)=>{let r=t[n];return r===void 0?`{${n}}`:String(r)}):e}function t(e,t,n,r){let i=e[t]?.[r];if(i!==void 0)return i;if(n){let t=e[n]?.[r];if(t!==void 0)return t}return null}function n(r){let{locale:i,fallbackLocale:a=null,messages:o}=r;function s(n,r,s){let c=t(o,i,a,n)??s?.default;return c===void 0?n:e(c,r)}function c(n,r,s,c){let l=t(o,i,a,`${n}${r===1?`_one`:`_other`}`)??t(o,i,a,n)??c?.default;return l===void 0?n:e(l,{count:r,...s??{}})}function l(e,t){return new Intl.NumberFormat(i,t).format(e)}function u(e,t){let n=typeof e==`string`?new Date(e):e;return Number.isNaN(n.getTime())?``:new Intl.DateTimeFormat(i,t).format(n)}return{locale:i,fallbackLocale:a,t:s,plural:c,formatNumber:l,formatDate:u,withLocale:e=>n({locale:e,fallbackLocale:a??void 0,messages:o})}}exports.createI18n=n;
+const e=require("../utils/intl-cache.cjs");function t(e,t){return t?e.replace(/\{(\w+)\}/g,(e,n)=>{let r=t[n];return r===void 0?`{${n}}`:String(r)}):e}function n(e,t,n,r){let i=e[t]?.[r];if(i!==void 0)return i;if(n){let t=e[n]?.[r];if(t!==void 0)return t}return null}function r(i){let{locale:a,fallbackLocale:o=null,messages:s}=i;function c(e,r,i){let c=n(s,a,o,e)??i?.default;return c===void 0?e:t(c,r)}function l(e,r,i,c){let l=n(s,a,o,`${e}${r===1?`_one`:`_other`}`)??n(s,a,o,e)??c?.default;return l===void 0?e:t(l,{count:r,...i??{}})}function u(t,n){return e.numberFormat(a,n).format(t)}function d(t,n){let r=typeof t==`string`?new Date(t):t;return Number.isNaN(r.getTime())?``:e.dateTimeFormat(a,n).format(r)}return{locale:a,fallbackLocale:o,t:c,plural:l,formatNumber:u,formatDate:d,withLocale:e=>r({locale:e,fallbackLocale:o??void 0,messages:s})}}exports.createI18n=r;
 //# sourceMappingURL=create-i18n.cjs.map

package/dist/i18n/create-i18n.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-i18n.cjs","names":[],"sources":["../../src/i18n/create-i18n.ts"],"sourcesContent":["export type Messages = Record<string, string>;\nexport type Catalog = Record<string, Messages>;\nexport type InterpolationValues = Record<string, string | number>;\n\nexport interface CreateI18nOptions {\n    /** Initial locale. */\n    locale: string;\n    /** Fallback locale used when a key is missing in the active locale. */\n    fallbackLocale?: string;\n    /** Catalog `{ [locale]: { [key]: \"...\" } }`. */\n    messages: Catalog;\n}\n\n/** Per-call options for {@link I18n.t} and {@link I18n.plural}. */\nexport interface TranslateOptions {\n    /**\n     * Text to use when the catalog defines neither the key nor its fallback.\n     *\n     * Without this, a miss returns the key, and a caller that wants its own text\n     * instead has to *detect* the miss — which from the outside means comparing\n     * the result against the key it just passed in. That heuristic is wrong for a\n     * catalog that legitimately maps a key to itself, and it is what every\n     * translatable string the SDK ships would otherwise have to copy.\n     *\n     * Interpolated like any other message, so a default carries `{placeholders}`\n     * too and is not second-class.\n     */\n    default?: string;\n}\n\nexport interface I18n {\n    /** Currently active locale. */\n    locale: string;\n    /** Fallback locale (or `null` when not configured). */\n    fallbackLocale: string | null;\n    /**\n     * Translate `key`, interpolating `{name}` placeholders from `params`.\n     * Falls back to the configured fallback locale, then to `options.default`,\n     * then to the key itself.\n     */\n    t: (key: string, params?: InterpolationValues, options?: TranslateOptions) => string;\n    /**\n     * Plural-aware translation. Tries `${key}_one` for `count === 1` and\n     * `${key}_other` otherwise, with `{count}` available for interpolation.\n     * Falls back to `options.default`, then to the key itself.\n     */\n    plural: (\n        key: string,\n        count: number,\n        params?: InterpolationValues,\n        options?: TranslateOptions,\n    ) => string;\n    /** Format a number using `Intl.NumberFormat` on the active locale. */\n    formatNumber: (value: number, options?: Intl.NumberFormatOptions) => string;\n    /** Format a Date using `Intl.DateTimeFormat` on the active locale. */\n    formatDate: (value: Date | string, options?: Intl.DateTimeFormatOptions) => string;\n    /** Build a new `I18n` instance pointing at a different locale. */\n    withLocale: (locale: string) => I18n;\n}\n\nfunction interpolate(template: string, params?: InterpolationValues): string {\n    if (!params) return template;\n    return template.replace(/\\{(\\w+)\\}/g, (_match, name: string) => {\n        const value = params[name];\n        return value === undefined ? `{${name}}` : String(value);\n    });\n}\n\nfunction lookup(\n    catalog: Catalog,\n    locale: string,\n    fallback: string | null,\n    key: string,\n): string | null {\n    const direct = catalog[locale]?.[key];\n    if (direct !== undefined) return direct;\n    if (fallback) {\n        const fallbackValue = catalog[fallback]?.[key];\n        if (fallbackValue !== undefined) return fallbackValue;\n    }\n    return null;\n}\n\n/**\n * Create an i18n object with translation, pluralization and Intl helpers.\n *\n * The catalog is a plain `{ [locale]: { [key]: \"...\" } }` map — bring your\n * own keys, namespaces, or nested-key conventions. The SDK does not enforce\n * a schema so you can plug it into any string-loading pipeline.\n *\n * @example\n * const i18n = createI18n({\n *     locale: \"pt-BR\",\n *     fallbackLocale: \"en\",\n *     messages: {\n *         \"pt-BR\": {\n *             \"greet\": \"Olá, {name}\",\n *             \"alos_one\": \"{count} Alô\",\n *             \"alos_other\": \"{count} Alôs\",\n *         },\n *         \"en\": { greet: \"Hi, {name}\", alos_one: \"{count} Alo\", alos_other: \"{count} Alos\" },\n *     },\n * });\n * i18n.t(\"greet\", { name: \"Mau\" });          // \"Olá, Mau\"\n * i18n.plural(\"alos\", 3);                     // \"3 Alôs\"\n *\n * @example\n * // A key the catalog does not define, with text to show instead of the key.\n * i18n.t(\"cart.empty\", undefined, { default: \"Seu carrinho está vazio\" });\n */\nexport function createI18n(options: CreateI18nOptions): I18n {\n    const { locale, fallbackLocale = null, messages } = options;\n\n    function t(key: string, params?: InterpolationValues, options?: TranslateOptions): string {\n        const template = lookup(messages, locale, fallbackLocale, key) ?? options?.default;\n        if (template === undefined) return key;\n        return interpolate(template, params);\n    }\n\n    function plural(\n        key: string,\n        count: number,\n        params?: InterpolationValues,\n        options?: TranslateOptions,\n    ): string {\n        const suffix = count === 1 ? \"_one\" : \"_other\";\n        const template =\n            lookup(messages, locale, fallbackLocale, `${key}${suffix}`) ??\n            lookup(messages, locale, fallbackLocale, key) ??\n            options?.default;\n        if (template === undefined) return key;\n        return interpolate(template, { count, ...(params ?? {}) });\n    }\n\n    function formatNumber(value: number, opts?: Intl.NumberFormatOptions): string {\n        return new Intl.NumberFormat(locale, opts).format(value);\n    }\n\n    function formatDate(value: Date | string, opts?: Intl.DateTimeFormatOptions): string {\n        const date = typeof value === \"string\" ? new Date(value) : value;\n        if (Number.isNaN(date.getTime())) return \"\";\n        return new Intl.DateTimeFormat(locale, opts).format(date);\n    }\n\n    return {\n        locale,\n        fallbackLocale,\n        t,\n        plural,\n        formatNumber,\n        formatDate,\n        withLocale: (nextLocale) =>\n            createI18n({\n                locale: nextLocale,\n                fallbackLocale: fallbackLocale ?? undefined,\n                messages,\n            }),\n    };\n}\n"],"mappings":"AA4DA,SAAS,EAAY,EAAkB,EAAsC,CAEzE,OADK,EACE,EAAS,QAAQ,cAAe,EAAQ,IAAiB,CAC5D,IAAM,EAAQ,EAAO,GACrB,OAAO,IAAU,IAAA,GAAY,IAAI,EAAK,GAAK,OAAO,CAAK,CAC3D,CAAC,EAJmB,CAKxB,CAEA,SAAS,EACL,EACA,EACA,EACA,EACa,CACb,IAAM,EAAS,EAAQ,EAAO,GAAG,GACjC,GAAI,IAAW,IAAA,GAAW,OAAO,EACjC,GAAI,EAAU,CACV,IAAM,EAAgB,EAAQ,EAAS,GAAG,GAC1C,GAAI,IAAkB,IAAA,GAAW,OAAO,CAC5C,CACA,OAAO,IACX,CA6BA,SAAgB,EAAW,EAAkC,CACzD,GAAM,CAAE,SAAQ,iBAAiB,KAAM,YAAa,EAEpD,SAAS,EAAE,EAAa,EAA8B,EAAoC,CACtF,IAAM,EAAW,EAAO,EAAU,EAAQ,EAAgB,CAAG,GAAK,GAAS,QAE3E,OADI,IAAa,IAAA,GAAkB,EAC5B,EAAY,EAAU,CAAM,CACvC,CAEA,SAAS,EACL,EACA,EACA,EACA,EACM,CAEN,IAAM,EACF,EAAO,EAAU,EAAQ,EAAgB,GAAG,IAFjC,IAAU,EAAI,OAAS,UAEwB,GAC1D,EAAO,EAAU,EAAQ,EAAgB,CAAG,GAC5C,GAAS,QAEb,OADI,IAAa,IAAA,GAAkB,EAC5B,EAAY,EAAU,CAAE,QAAO,GAAI,GAAU,CAAC,CAAG,CAAC,CAC7D,CAEA,SAAS,EAAa,EAAe,EAAyC,CAC1E,OAAO,IAAI,KAAK,aAAa,EAAQ,CAAI,CAAC,CAAC,OAAO,CAAK,CAC3D,CAEA,SAAS,EAAW,EAAsB,EAA2C,CACjF,IAAM,EAAO,OAAO,GAAU,SAAW,IAAI,KAAK,CAAK,EAAI,EAE3D,OADI,OAAO,MAAM,EAAK,QAAQ,CAAC,EAAU,GAClC,IAAI,KAAK,eAAe,EAAQ,CAAI,CAAC,CAAC,OAAO,CAAI,CAC5D,CAEA,MAAO,CACH,SACA,iBACA,IACA,SACA,eACA,aACA,WAAa,GACT,EAAW,CACP,OAAQ,EACR,eAAgB,GAAkB,IAAA,GAClC,UACJ,CAAC,CACT,CACJ"}
+{"version":3,"file":"create-i18n.cjs","names":[],"sources":["../../src/i18n/create-i18n.ts"],"sourcesContent":["import { dateTimeFormat, numberFormat } from \"@/utils/intl-cache\";\nexport type Messages = Record<string, string>;\nexport type Catalog = Record<string, Messages>;\nexport type InterpolationValues = Record<string, string | number>;\n\nexport interface CreateI18nOptions {\n    /** Initial locale. */\n    locale: string;\n    /** Fallback locale used when a key is missing in the active locale. */\n    fallbackLocale?: string;\n    /** Catalog `{ [locale]: { [key]: \"...\" } }`. */\n    messages: Catalog;\n}\n\n/** Per-call options for {@link I18n.t} and {@link I18n.plural}. */\nexport interface TranslateOptions {\n    /**\n     * Text to use when the catalog defines neither the key nor its fallback.\n     *\n     * Without this, a miss returns the key, and a caller that wants its own text\n     * instead has to *detect* the miss — which from the outside means comparing\n     * the result against the key it just passed in. That heuristic is wrong for a\n     * catalog that legitimately maps a key to itself, and it is what every\n     * translatable string the SDK ships would otherwise have to copy.\n     *\n     * Interpolated like any other message, so a default carries `{placeholders}`\n     * too and is not second-class.\n     */\n    default?: string;\n}\n\nexport interface I18n {\n    /** Currently active locale. */\n    locale: string;\n    /** Fallback locale (or `null` when not configured). */\n    fallbackLocale: string | null;\n    /**\n     * Translate `key`, interpolating `{name}` placeholders from `params`.\n     * Falls back to the configured fallback locale, then to `options.default`,\n     * then to the key itself.\n     */\n    t: (key: string, params?: InterpolationValues, options?: TranslateOptions) => string;\n    /**\n     * Plural-aware translation. Tries `${key}_one` for `count === 1` and\n     * `${key}_other` otherwise, with `{count}` available for interpolation.\n     * Falls back to `options.default`, then to the key itself.\n     */\n    plural: (\n        key: string,\n        count: number,\n        params?: InterpolationValues,\n        options?: TranslateOptions,\n    ) => string;\n    /** Format a number using `Intl.NumberFormat` on the active locale. */\n    formatNumber: (value: number, options?: Intl.NumberFormatOptions) => string;\n    /** Format a Date using `Intl.DateTimeFormat` on the active locale. */\n    formatDate: (value: Date | string, options?: Intl.DateTimeFormatOptions) => string;\n    /** Build a new `I18n` instance pointing at a different locale. */\n    withLocale: (locale: string) => I18n;\n}\n\nfunction interpolate(template: string, params?: InterpolationValues): string {\n    if (!params) return template;\n    return template.replace(/\\{(\\w+)\\}/g, (_match, name: string) => {\n        const value = params[name];\n        return value === undefined ? `{${name}}` : String(value);\n    });\n}\n\nfunction lookup(\n    catalog: Catalog,\n    locale: string,\n    fallback: string | null,\n    key: string,\n): string | null {\n    const direct = catalog[locale]?.[key];\n    if (direct !== undefined) return direct;\n    if (fallback) {\n        const fallbackValue = catalog[fallback]?.[key];\n        if (fallbackValue !== undefined) return fallbackValue;\n    }\n    return null;\n}\n\n/**\n * Create an i18n object with translation, pluralization and Intl helpers.\n *\n * The catalog is a plain `{ [locale]: { [key]: \"...\" } }` map — bring your\n * own keys, namespaces, or nested-key conventions. The SDK does not enforce\n * a schema so you can plug it into any string-loading pipeline.\n *\n * @example\n * const i18n = createI18n({\n *     locale: \"pt-BR\",\n *     fallbackLocale: \"en\",\n *     messages: {\n *         \"pt-BR\": {\n *             \"greet\": \"Olá, {name}\",\n *             \"alos_one\": \"{count} Alô\",\n *             \"alos_other\": \"{count} Alôs\",\n *         },\n *         \"en\": { greet: \"Hi, {name}\", alos_one: \"{count} Alo\", alos_other: \"{count} Alos\" },\n *     },\n * });\n * i18n.t(\"greet\", { name: \"Mau\" });          // \"Olá, Mau\"\n * i18n.plural(\"alos\", 3);                     // \"3 Alôs\"\n *\n * @example\n * // A key the catalog does not define, with text to show instead of the key.\n * i18n.t(\"cart.empty\", undefined, { default: \"Seu carrinho está vazio\" });\n */\nexport function createI18n(options: CreateI18nOptions): I18n {\n    const { locale, fallbackLocale = null, messages } = options;\n\n    function t(key: string, params?: InterpolationValues, options?: TranslateOptions): string {\n        const template = lookup(messages, locale, fallbackLocale, key) ?? options?.default;\n        if (template === undefined) return key;\n        return interpolate(template, params);\n    }\n\n    function plural(\n        key: string,\n        count: number,\n        params?: InterpolationValues,\n        options?: TranslateOptions,\n    ): string {\n        const suffix = count === 1 ? \"_one\" : \"_other\";\n        const template =\n            lookup(messages, locale, fallbackLocale, `${key}${suffix}`) ??\n            lookup(messages, locale, fallbackLocale, key) ??\n            options?.default;\n        if (template === undefined) return key;\n        return interpolate(template, { count, ...(params ?? {}) });\n    }\n\n    function formatNumber(value: number, opts?: Intl.NumberFormatOptions): string {\n        return numberFormat(locale, opts).format(value);\n    }\n\n    function formatDate(value: Date | string, opts?: Intl.DateTimeFormatOptions): string {\n        const date = typeof value === \"string\" ? new Date(value) : value;\n        if (Number.isNaN(date.getTime())) return \"\";\n        return dateTimeFormat(locale, opts).format(date);\n    }\n\n    return {\n        locale,\n        fallbackLocale,\n        t,\n        plural,\n        formatNumber,\n        formatDate,\n        withLocale: (nextLocale) =>\n            createI18n({\n                locale: nextLocale,\n                fallbackLocale: fallbackLocale ?? undefined,\n                messages,\n            }),\n    };\n}\n"],"mappings":"2CA6DA,SAAS,EAAY,EAAkB,EAAsC,CAEzE,OADK,EACE,EAAS,QAAQ,cAAe,EAAQ,IAAiB,CAC5D,IAAM,EAAQ,EAAO,GACrB,OAAO,IAAU,IAAA,GAAY,IAAI,EAAK,GAAK,OAAO,CAAK,CAC3D,CAAC,EAJmB,CAKxB,CAEA,SAAS,EACL,EACA,EACA,EACA,EACa,CACb,IAAM,EAAS,EAAQ,EAAO,GAAG,GACjC,GAAI,IAAW,IAAA,GAAW,OAAO,EACjC,GAAI,EAAU,CACV,IAAM,EAAgB,EAAQ,EAAS,GAAG,GAC1C,GAAI,IAAkB,IAAA,GAAW,OAAO,CAC5C,CACA,OAAO,IACX,CA6BA,SAAgB,EAAW,EAAkC,CACzD,GAAM,CAAE,SAAQ,iBAAiB,KAAM,YAAa,EAEpD,SAAS,EAAE,EAAa,EAA8B,EAAoC,CACtF,IAAM,EAAW,EAAO,EAAU,EAAQ,EAAgB,CAAG,GAAK,GAAS,QAE3E,OADI,IAAa,IAAA,GAAkB,EAC5B,EAAY,EAAU,CAAM,CACvC,CAEA,SAAS,EACL,EACA,EACA,EACA,EACM,CAEN,IAAM,EACF,EAAO,EAAU,EAAQ,EAAgB,GAAG,IAFjC,IAAU,EAAI,OAAS,UAEwB,GAC1D,EAAO,EAAU,EAAQ,EAAgB,CAAG,GAC5C,GAAS,QAEb,OADI,IAAa,IAAA,GAAkB,EAC5B,EAAY,EAAU,CAAE,QAAO,GAAI,GAAU,CAAC,CAAG,CAAC,CAC7D,CAEA,SAAS,EAAa,EAAe,EAAyC,CAC1E,OAAO,EAAA,aAAa,EAAQ,CAAI,CAAC,CAAC,OAAO,CAAK,CAClD,CAEA,SAAS,EAAW,EAAsB,EAA2C,CACjF,IAAM,EAAO,OAAO,GAAU,SAAW,IAAI,KAAK,CAAK,EAAI,EAE3D,OADI,OAAO,MAAM,EAAK,QAAQ,CAAC,EAAU,GAClC,EAAA,eAAe,EAAQ,CAAI,CAAC,CAAC,OAAO,CAAI,CACnD,CAEA,MAAO,CACH,SACA,iBACA,IACA,SACA,eACA,aACA,WAAa,GACT,EAAW,CACP,OAAQ,EACR,eAAgB,GAAkB,IAAA,GAClC,UACJ,CAAC,CACT,CACJ"}

package/dist/i18n/create-i18n.js

@@ -1,11 +1,12 @@
+import { dateTimeFormat as e, numberFormat as t } from "../utils/intl-cache.js";
 //#region src/i18n/create-i18n.ts
-function e(e, t) {
+function n(e, t) {
 	return t ? e.replace(/\{(\w+)\}/g, (e, n) => {
 		let r = t[n];
 		return r === void 0 ? `{${n}}` : String(r);
 	}) : e;
 }
-function t(e, t, n, r) {
+function r(e, t, n, r) {
 	let i = e[t]?.[r];
 	if (i !== void 0) return i;
 	if (n) {
@@ -14,41 +15,41 @@ function t(e, t, n, r) {
 	}
 	return null;
 }
-function n(r) {
-	let { locale: i, fallbackLocale: a = null, messages: o } = r;
-	function s(n, r, s) {
-		let c = t(o, i, a, n) ?? s?.default;
-		return c === void 0 ? n : e(c, r);
+function i(a) {
+	let { locale: o, fallbackLocale: s = null, messages: c } = a;
+	function l(e, t, i) {
+		let a = r(c, o, s, e) ?? i?.default;
+		return a === void 0 ? e : n(a, t);
 	}
-	function c(n, r, s, c) {
-		let l = t(o, i, a, `${n}${r === 1 ? "_one" : "_other"}`) ?? t(o, i, a, n) ?? c?.default;
-		return l === void 0 ? n : e(l, {
-			count: r,
-			...s ?? {}
+	function u(e, t, i, a) {
+		let l = r(c, o, s, `${e}${t === 1 ? "_one" : "_other"}`) ?? r(c, o, s, e) ?? a?.default;
+		return l === void 0 ? e : n(l, {
+			count: t,
+			...i ?? {}
 		});
 	}
-	function l(e, t) {
-		return new Intl.NumberFormat(i, t).format(e);
+	function d(e, n) {
+		return t(o, n).format(e);
 	}
-	function u(e, t) {
-		let n = typeof e == "string" ? new Date(e) : e;
-		return Number.isNaN(n.getTime()) ? "" : new Intl.DateTimeFormat(i, t).format(n);
+	function f(t, n) {
+		let r = typeof t == "string" ? new Date(t) : t;
+		return Number.isNaN(r.getTime()) ? "" : e(o, n).format(r);
 	}
 	return {
-		locale: i,
-		fallbackLocale: a,
-		t: s,
-		plural: c,
-		formatNumber: l,
-		formatDate: u,
-		withLocale: (e) => n({
+		locale: o,
+		fallbackLocale: s,
+		t: l,
+		plural: u,
+		formatNumber: d,
+		formatDate: f,
+		withLocale: (e) => i({
 			locale: e,
-			fallbackLocale: a ?? void 0,
-			messages: o
+			fallbackLocale: s ?? void 0,
+			messages: c
 		})
 	};
 }
 //#endregion
-export { n as createI18n };
+export { i as createI18n };
 
 //# sourceMappingURL=create-i18n.js.map

package/dist/i18n/create-i18n.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-i18n.js","names":[],"sources":["../../src/i18n/create-i18n.ts"],"sourcesContent":["export type Messages = Record<string, string>;\nexport type Catalog = Record<string, Messages>;\nexport type InterpolationValues = Record<string, string | number>;\n\nexport interface CreateI18nOptions {\n    /** Initial locale. */\n    locale: string;\n    /** Fallback locale used when a key is missing in the active locale. */\n    fallbackLocale?: string;\n    /** Catalog `{ [locale]: { [key]: \"...\" } }`. */\n    messages: Catalog;\n}\n\n/** Per-call options for {@link I18n.t} and {@link I18n.plural}. */\nexport interface TranslateOptions {\n    /**\n     * Text to use when the catalog defines neither the key nor its fallback.\n     *\n     * Without this, a miss returns the key, and a caller that wants its own text\n     * instead has to *detect* the miss — which from the outside means comparing\n     * the result against the key it just passed in. That heuristic is wrong for a\n     * catalog that legitimately maps a key to itself, and it is what every\n     * translatable string the SDK ships would otherwise have to copy.\n     *\n     * Interpolated like any other message, so a default carries `{placeholders}`\n     * too and is not second-class.\n     */\n    default?: string;\n}\n\nexport interface I18n {\n    /** Currently active locale. */\n    locale: string;\n    /** Fallback locale (or `null` when not configured). */\n    fallbackLocale: string | null;\n    /**\n     * Translate `key`, interpolating `{name}` placeholders from `params`.\n     * Falls back to the configured fallback locale, then to `options.default`,\n     * then to the key itself.\n     */\n    t: (key: string, params?: InterpolationValues, options?: TranslateOptions) => string;\n    /**\n     * Plural-aware translation. Tries `${key}_one` for `count === 1` and\n     * `${key}_other` otherwise, with `{count}` available for interpolation.\n     * Falls back to `options.default`, then to the key itself.\n     */\n    plural: (\n        key: string,\n        count: number,\n        params?: InterpolationValues,\n        options?: TranslateOptions,\n    ) => string;\n    /** Format a number using `Intl.NumberFormat` on the active locale. */\n    formatNumber: (value: number, options?: Intl.NumberFormatOptions) => string;\n    /** Format a Date using `Intl.DateTimeFormat` on the active locale. */\n    formatDate: (value: Date | string, options?: Intl.DateTimeFormatOptions) => string;\n    /** Build a new `I18n` instance pointing at a different locale. */\n    withLocale: (locale: string) => I18n;\n}\n\nfunction interpolate(template: string, params?: InterpolationValues): string {\n    if (!params) return template;\n    return template.replace(/\\{(\\w+)\\}/g, (_match, name: string) => {\n        const value = params[name];\n        return value === undefined ? `{${name}}` : String(value);\n    });\n}\n\nfunction lookup(\n    catalog: Catalog,\n    locale: string,\n    fallback: string | null,\n    key: string,\n): string | null {\n    const direct = catalog[locale]?.[key];\n    if (direct !== undefined) return direct;\n    if (fallback) {\n        const fallbackValue = catalog[fallback]?.[key];\n        if (fallbackValue !== undefined) return fallbackValue;\n    }\n    return null;\n}\n\n/**\n * Create an i18n object with translation, pluralization and Intl helpers.\n *\n * The catalog is a plain `{ [locale]: { [key]: \"...\" } }` map — bring your\n * own keys, namespaces, or nested-key conventions. The SDK does not enforce\n * a schema so you can plug it into any string-loading pipeline.\n *\n * @example\n * const i18n = createI18n({\n *     locale: \"pt-BR\",\n *     fallbackLocale: \"en\",\n *     messages: {\n *         \"pt-BR\": {\n *             \"greet\": \"Olá, {name}\",\n *             \"alos_one\": \"{count} Alô\",\n *             \"alos_other\": \"{count} Alôs\",\n *         },\n *         \"en\": { greet: \"Hi, {name}\", alos_one: \"{count} Alo\", alos_other: \"{count} Alos\" },\n *     },\n * });\n * i18n.t(\"greet\", { name: \"Mau\" });          // \"Olá, Mau\"\n * i18n.plural(\"alos\", 3);                     // \"3 Alôs\"\n *\n * @example\n * // A key the catalog does not define, with text to show instead of the key.\n * i18n.t(\"cart.empty\", undefined, { default: \"Seu carrinho está vazio\" });\n */\nexport function createI18n(options: CreateI18nOptions): I18n {\n    const { locale, fallbackLocale = null, messages } = options;\n\n    function t(key: string, params?: InterpolationValues, options?: TranslateOptions): string {\n        const template = lookup(messages, locale, fallbackLocale, key) ?? options?.default;\n        if (template === undefined) return key;\n        return interpolate(template, params);\n    }\n\n    function plural(\n        key: string,\n        count: number,\n        params?: InterpolationValues,\n        options?: TranslateOptions,\n    ): string {\n        const suffix = count === 1 ? \"_one\" : \"_other\";\n        const template =\n            lookup(messages, locale, fallbackLocale, `${key}${suffix}`) ??\n            lookup(messages, locale, fallbackLocale, key) ??\n            options?.default;\n        if (template === undefined) return key;\n        return interpolate(template, { count, ...(params ?? {}) });\n    }\n\n    function formatNumber(value: number, opts?: Intl.NumberFormatOptions): string {\n        return new Intl.NumberFormat(locale, opts).format(value);\n    }\n\n    function formatDate(value: Date | string, opts?: Intl.DateTimeFormatOptions): string {\n        const date = typeof value === \"string\" ? new Date(value) : value;\n        if (Number.isNaN(date.getTime())) return \"\";\n        return new Intl.DateTimeFormat(locale, opts).format(date);\n    }\n\n    return {\n        locale,\n        fallbackLocale,\n        t,\n        plural,\n        formatNumber,\n        formatDate,\n        withLocale: (nextLocale) =>\n            createI18n({\n                locale: nextLocale,\n                fallbackLocale: fallbackLocale ?? undefined,\n                messages,\n            }),\n    };\n}\n"],"mappings":";AA4DA,SAAS,EAAY,GAAkB,GAAsC;CAEzE,OADK,IACE,EAAS,QAAQ,eAAe,GAAQ,MAAiB;EAC5D,IAAM,IAAQ,EAAO;EACrB,OAAO,MAAU,KAAA,IAAY,IAAI,EAAK,KAAK,OAAO,CAAK;CAC3D,CAAC,IAJmB;AAKxB;AAEA,SAAS,EACL,GACA,GACA,GACA,GACa;CACb,IAAM,IAAS,EAAQ,EAAO,GAAG;CACjC,IAAI,MAAW,KAAA,GAAW,OAAO;CACjC,IAAI,GAAU;EACV,IAAM,IAAgB,EAAQ,EAAS,GAAG;EAC1C,IAAI,MAAkB,KAAA,GAAW,OAAO;CAC5C;CACA,OAAO;AACX;AA6BA,SAAgB,EAAW,GAAkC;CACzD,IAAM,EAAE,WAAQ,oBAAiB,MAAM,gBAAa;CAEpD,SAAS,EAAE,GAAa,GAA8B,GAAoC;EACtF,IAAM,IAAW,EAAO,GAAU,GAAQ,GAAgB,CAAG,KAAK,GAAS;EAE3E,OADI,MAAa,KAAA,IAAkB,IAC5B,EAAY,GAAU,CAAM;CACvC;CAEA,SAAS,EACL,GACA,GACA,GACA,GACM;EAEN,IAAM,IACF,EAAO,GAAU,GAAQ,GAAgB,GAAG,IAFjC,MAAU,IAAI,SAAS,UAEwB,KAC1D,EAAO,GAAU,GAAQ,GAAgB,CAAG,KAC5C,GAAS;EAEb,OADI,MAAa,KAAA,IAAkB,IAC5B,EAAY,GAAU;GAAE;GAAO,GAAI,KAAU,CAAC;EAAG,CAAC;CAC7D;CAEA,SAAS,EAAa,GAAe,GAAyC;EAC1E,OAAO,IAAI,KAAK,aAAa,GAAQ,CAAI,CAAC,CAAC,OAAO,CAAK;CAC3D;CAEA,SAAS,EAAW,GAAsB,GAA2C;EACjF,IAAM,IAAO,OAAO,KAAU,WAAW,IAAI,KAAK,CAAK,IAAI;EAE3D,OADI,OAAO,MAAM,EAAK,QAAQ,CAAC,IAAU,KAClC,IAAI,KAAK,eAAe,GAAQ,CAAI,CAAC,CAAC,OAAO,CAAI;CAC5D;CAEA,OAAO;EACH;EACA;EACA;EACA;EACA;EACA;EACA,aAAa,MACT,EAAW;GACP,QAAQ;GACR,gBAAgB,KAAkB,KAAA;GAClC;EACJ,CAAC;CACT;AACJ"}
+{"version":3,"file":"create-i18n.js","names":[],"sources":["../../src/i18n/create-i18n.ts"],"sourcesContent":["import { dateTimeFormat, numberFormat } from \"@/utils/intl-cache\";\nexport type Messages = Record<string, string>;\nexport type Catalog = Record<string, Messages>;\nexport type InterpolationValues = Record<string, string | number>;\n\nexport interface CreateI18nOptions {\n    /** Initial locale. */\n    locale: string;\n    /** Fallback locale used when a key is missing in the active locale. */\n    fallbackLocale?: string;\n    /** Catalog `{ [locale]: { [key]: \"...\" } }`. */\n    messages: Catalog;\n}\n\n/** Per-call options for {@link I18n.t} and {@link I18n.plural}. */\nexport interface TranslateOptions {\n    /**\n     * Text to use when the catalog defines neither the key nor its fallback.\n     *\n     * Without this, a miss returns the key, and a caller that wants its own text\n     * instead has to *detect* the miss — which from the outside means comparing\n     * the result against the key it just passed in. That heuristic is wrong for a\n     * catalog that legitimately maps a key to itself, and it is what every\n     * translatable string the SDK ships would otherwise have to copy.\n     *\n     * Interpolated like any other message, so a default carries `{placeholders}`\n     * too and is not second-class.\n     */\n    default?: string;\n}\n\nexport interface I18n {\n    /** Currently active locale. */\n    locale: string;\n    /** Fallback locale (or `null` when not configured). */\n    fallbackLocale: string | null;\n    /**\n     * Translate `key`, interpolating `{name}` placeholders from `params`.\n     * Falls back to the configured fallback locale, then to `options.default`,\n     * then to the key itself.\n     */\n    t: (key: string, params?: InterpolationValues, options?: TranslateOptions) => string;\n    /**\n     * Plural-aware translation. Tries `${key}_one` for `count === 1` and\n     * `${key}_other` otherwise, with `{count}` available for interpolation.\n     * Falls back to `options.default`, then to the key itself.\n     */\n    plural: (\n        key: string,\n        count: number,\n        params?: InterpolationValues,\n        options?: TranslateOptions,\n    ) => string;\n    /** Format a number using `Intl.NumberFormat` on the active locale. */\n    formatNumber: (value: number, options?: Intl.NumberFormatOptions) => string;\n    /** Format a Date using `Intl.DateTimeFormat` on the active locale. */\n    formatDate: (value: Date | string, options?: Intl.DateTimeFormatOptions) => string;\n    /** Build a new `I18n` instance pointing at a different locale. */\n    withLocale: (locale: string) => I18n;\n}\n\nfunction interpolate(template: string, params?: InterpolationValues): string {\n    if (!params) return template;\n    return template.replace(/\\{(\\w+)\\}/g, (_match, name: string) => {\n        const value = params[name];\n        return value === undefined ? `{${name}}` : String(value);\n    });\n}\n\nfunction lookup(\n    catalog: Catalog,\n    locale: string,\n    fallback: string | null,\n    key: string,\n): string | null {\n    const direct = catalog[locale]?.[key];\n    if (direct !== undefined) return direct;\n    if (fallback) {\n        const fallbackValue = catalog[fallback]?.[key];\n        if (fallbackValue !== undefined) return fallbackValue;\n    }\n    return null;\n}\n\n/**\n * Create an i18n object with translation, pluralization and Intl helpers.\n *\n * The catalog is a plain `{ [locale]: { [key]: \"...\" } }` map — bring your\n * own keys, namespaces, or nested-key conventions. The SDK does not enforce\n * a schema so you can plug it into any string-loading pipeline.\n *\n * @example\n * const i18n = createI18n({\n *     locale: \"pt-BR\",\n *     fallbackLocale: \"en\",\n *     messages: {\n *         \"pt-BR\": {\n *             \"greet\": \"Olá, {name}\",\n *             \"alos_one\": \"{count} Alô\",\n *             \"alos_other\": \"{count} Alôs\",\n *         },\n *         \"en\": { greet: \"Hi, {name}\", alos_one: \"{count} Alo\", alos_other: \"{count} Alos\" },\n *     },\n * });\n * i18n.t(\"greet\", { name: \"Mau\" });          // \"Olá, Mau\"\n * i18n.plural(\"alos\", 3);                     // \"3 Alôs\"\n *\n * @example\n * // A key the catalog does not define, with text to show instead of the key.\n * i18n.t(\"cart.empty\", undefined, { default: \"Seu carrinho está vazio\" });\n */\nexport function createI18n(options: CreateI18nOptions): I18n {\n    const { locale, fallbackLocale = null, messages } = options;\n\n    function t(key: string, params?: InterpolationValues, options?: TranslateOptions): string {\n        const template = lookup(messages, locale, fallbackLocale, key) ?? options?.default;\n        if (template === undefined) return key;\n        return interpolate(template, params);\n    }\n\n    function plural(\n        key: string,\n        count: number,\n        params?: InterpolationValues,\n        options?: TranslateOptions,\n    ): string {\n        const suffix = count === 1 ? \"_one\" : \"_other\";\n        const template =\n            lookup(messages, locale, fallbackLocale, `${key}${suffix}`) ??\n            lookup(messages, locale, fallbackLocale, key) ??\n            options?.default;\n        if (template === undefined) return key;\n        return interpolate(template, { count, ...(params ?? {}) });\n    }\n\n    function formatNumber(value: number, opts?: Intl.NumberFormatOptions): string {\n        return numberFormat(locale, opts).format(value);\n    }\n\n    function formatDate(value: Date | string, opts?: Intl.DateTimeFormatOptions): string {\n        const date = typeof value === \"string\" ? new Date(value) : value;\n        if (Number.isNaN(date.getTime())) return \"\";\n        return dateTimeFormat(locale, opts).format(date);\n    }\n\n    return {\n        locale,\n        fallbackLocale,\n        t,\n        plural,\n        formatNumber,\n        formatDate,\n        withLocale: (nextLocale) =>\n            createI18n({\n                locale: nextLocale,\n                fallbackLocale: fallbackLocale ?? undefined,\n                messages,\n            }),\n    };\n}\n"],"mappings":";;AA6DA,SAAS,EAAY,GAAkB,GAAsC;CAEzE,OADK,IACE,EAAS,QAAQ,eAAe,GAAQ,MAAiB;EAC5D,IAAM,IAAQ,EAAO;EACrB,OAAO,MAAU,KAAA,IAAY,IAAI,EAAK,KAAK,OAAO,CAAK;CAC3D,CAAC,IAJmB;AAKxB;AAEA,SAAS,EACL,GACA,GACA,GACA,GACa;CACb,IAAM,IAAS,EAAQ,EAAO,GAAG;CACjC,IAAI,MAAW,KAAA,GAAW,OAAO;CACjC,IAAI,GAAU;EACV,IAAM,IAAgB,EAAQ,EAAS,GAAG;EAC1C,IAAI,MAAkB,KAAA,GAAW,OAAO;CAC5C;CACA,OAAO;AACX;AA6BA,SAAgB,EAAW,GAAkC;CACzD,IAAM,EAAE,WAAQ,oBAAiB,MAAM,gBAAa;CAEpD,SAAS,EAAE,GAAa,GAA8B,GAAoC;EACtF,IAAM,IAAW,EAAO,GAAU,GAAQ,GAAgB,CAAG,KAAK,GAAS;EAE3E,OADI,MAAa,KAAA,IAAkB,IAC5B,EAAY,GAAU,CAAM;CACvC;CAEA,SAAS,EACL,GACA,GACA,GACA,GACM;EAEN,IAAM,IACF,EAAO,GAAU,GAAQ,GAAgB,GAAG,IAFjC,MAAU,IAAI,SAAS,UAEwB,KAC1D,EAAO,GAAU,GAAQ,GAAgB,CAAG,KAC5C,GAAS;EAEb,OADI,MAAa,KAAA,IAAkB,IAC5B,EAAY,GAAU;GAAE;GAAO,GAAI,KAAU,CAAC;EAAG,CAAC;CAC7D;CAEA,SAAS,EAAa,GAAe,GAAyC;EAC1E,OAAO,EAAa,GAAQ,CAAI,CAAC,CAAC,OAAO,CAAK;CAClD;CAEA,SAAS,EAAW,GAAsB,GAA2C;EACjF,IAAM,IAAO,OAAO,KAAU,WAAW,IAAI,KAAK,CAAK,IAAI;EAE3D,OADI,OAAO,MAAM,EAAK,QAAQ,CAAC,IAAU,KAClC,EAAe,GAAQ,CAAI,CAAC,CAAC,OAAO,CAAI;CACnD;CAEA,OAAO;EACH;EACA;EACA;EACA;EACA;EACA;EACA,aAAa,MACT,EAAW;GACP,QAAQ;GACR,gBAAgB,KAAkB,KAAA;GAClC;EACJ,CAAC;CACT;AACJ"}

package/dist/query/QueryProvider.cjs

@@ -1,2 +1,2 @@
-const e=require("./constants.cjs"),t=require("./retry-policy.cjs");let n=require("react"),r=require("react/jsx-runtime"),i=require("@tanstack/react-query");function a({children:a,client:o,defaultOptions:s}){let[c]=(0,n.useState)(()=>o??new i.QueryClient({defaultOptions:{queries:{staleTime:e.STALE_TIME.DEFAULT,gcTime:e.CACHE_TIME.DEFAULT,retry:t.shouldRetryQuery,refetchOnWindowFocus:!1,...s?.queries??{}},mutations:{retry:0,...s?.mutations??{}}}}));return(0,r.jsx)(i.QueryClientProvider,{client:c,children:a})}exports.QueryProvider=a;
+const e=require("./constants.cjs"),t=require("./retry-policy.cjs"),n=require("./foreign-client-warning.cjs");let r=require("react"),i=require("react/jsx-runtime"),a=require("@tanstack/react-query");function o({children:o,client:s,defaultOptions:c}){n.warnOnForeignClient(s);let[l]=(0,r.useState)(()=>s??new a.QueryClient({defaultOptions:{queries:{staleTime:e.STALE_TIME.DEFAULT,gcTime:e.CACHE_TIME.DEFAULT,retry:t.shouldRetryQuery,refetchOnWindowFocus:!1,...c?.queries??{}},mutations:{retry:0,...c?.mutations??{}}}}));return(0,i.jsx)(a.QueryClientProvider,{client:l,children:o})}exports.QueryProvider=o;
 //# sourceMappingURL=QueryProvider.cjs.map

package/dist/query/QueryProvider.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"QueryProvider.cjs","names":[],"sources":["../../src/query/QueryProvider.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport type { DefaultOptions } from \"@tanstack/react-query\";\nimport { STALE_TIME, CACHE_TIME } from \"./constants\";\nimport { shouldRetryQuery } from \"./retry-policy\";\n\nexport interface QueryProviderProps {\n    children: ReactNode;\n    /** Pass an existing client to share it across roots. */\n    client?: QueryClient;\n    /** Overrides for the default options applied when no `client` is provided. */\n    defaultOptions?: DefaultOptions;\n}\n\n/**\n * Wrapper around `QueryClientProvider` that bootstraps a `QueryClient` with\n * sane SDK defaults (5-minute stale time, 30-minute gc time, one retry for\n * failures worth replaying).\n *\n * Retries follow {@link shouldRetryQuery} rather than a flat count: a 4xx other\n * than 408/429 is the server refusing on purpose, and replaying it only doubles\n * the network log while the spinner keeps turning.\n */\nexport function QueryProvider({ children, client, defaultOptions }: QueryProviderProps) {\n    const [internalClient] = useState<QueryClient>(\n        () =>\n            client ??\n            new QueryClient({\n                defaultOptions: {\n                    queries: {\n                        staleTime: STALE_TIME.DEFAULT,\n                        gcTime: CACHE_TIME.DEFAULT,\n                        retry: shouldRetryQuery,\n                        refetchOnWindowFocus: false,\n                        ...(defaultOptions?.queries ?? {}),\n                    },\n                    mutations: {\n                        retry: 0,\n                        ...(defaultOptions?.mutations ?? {}),\n                    },\n                },\n            }),\n    );\n\n    return <QueryClientProvider client={internalClient}>{children}</QueryClientProvider>;\n}\n"],"mappings":"4JAwBA,SAAgB,EAAc,CAAE,WAAU,SAAQ,kBAAsC,CACpF,GAAM,CAAC,IAAA,EAAkB,EAAA,SAAA,KAEjB,GACA,IAAI,EAAA,YAAY,CACZ,eAAgB,CACZ,QAAS,CACL,UAAW,EAAA,WAAW,QACtB,OAAQ,EAAA,WAAW,QACnB,MAAO,EAAA,iBACP,qBAAsB,GACtB,GAAI,GAAgB,SAAW,CAAC,CACpC,EACA,UAAW,CACP,MAAO,EACP,GAAI,GAAgB,WAAa,CAAC,CACtC,CACJ,CACJ,CAAC,CACT,EAEA,OAAO,EAAA,EAAA,IAAA,CAAC,EAAA,oBAAD,CAAqB,OAAQ,EAAiB,UAA8B,CAAA,CACvF"}
+{"version":3,"file":"QueryProvider.cjs","names":[],"sources":["../../src/query/QueryProvider.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport type { DefaultOptions } from \"@tanstack/react-query\";\nimport { STALE_TIME, CACHE_TIME } from \"./constants\";\nimport { shouldRetryQuery } from \"./retry-policy\";\nimport { warnOnForeignClient } from \"./foreign-client-warning\";\n\nexport interface QueryProviderProps {\n    children: ReactNode;\n    /** Pass an existing client to share it across roots. */\n    client?: QueryClient;\n    /** Overrides for the default options applied when no `client` is provided. */\n    defaultOptions?: DefaultOptions;\n}\n\n/**\n * Wrapper around `QueryClientProvider` that bootstraps a `QueryClient` with\n * sane SDK defaults (5-minute stale time, 30-minute gc time, one retry for\n * failures worth replaying).\n *\n * Retries follow {@link shouldRetryQuery} rather than a flat count: a 4xx other\n * than 408/429 is the server refusing on purpose, and replaying it only doubles\n * the network log while the spinner keeps turning.\n */\nexport function QueryProvider({ children, client, defaultOptions }: QueryProviderProps) {\n    warnOnForeignClient(client);\n\n    const [internalClient] = useState<QueryClient>(\n        () =>\n            client ??\n            new QueryClient({\n                defaultOptions: {\n                    queries: {\n                        staleTime: STALE_TIME.DEFAULT,\n                        gcTime: CACHE_TIME.DEFAULT,\n                        retry: shouldRetryQuery,\n                        refetchOnWindowFocus: false,\n                        ...(defaultOptions?.queries ?? {}),\n                    },\n                    mutations: {\n                        retry: 0,\n                        ...(defaultOptions?.mutations ?? {}),\n                    },\n                },\n            }),\n    );\n\n    return <QueryClientProvider client={internalClient}>{children}</QueryClientProvider>;\n}\n"],"mappings":"sMAyBA,SAAgB,EAAc,CAAE,WAAU,SAAQ,kBAAsC,CACpF,EAAA,oBAAoB,CAAM,EAE1B,GAAM,CAAC,IAAA,EAAkB,EAAA,SAAA,KAEjB,GACA,IAAI,EAAA,YAAY,CACZ,eAAgB,CACZ,QAAS,CACL,UAAW,EAAA,WAAW,QACtB,OAAQ,EAAA,WAAW,QACnB,MAAO,EAAA,iBACP,qBAAsB,GACtB,GAAI,GAAgB,SAAW,CAAC,CACpC,EACA,UAAW,CACP,MAAO,EACP,GAAI,GAAgB,WAAa,CAAC,CACtC,CACJ,CACJ,CAAC,CACT,EAEA,OAAO,EAAA,EAAA,IAAA,CAAC,EAAA,oBAAD,CAAqB,OAAQ,EAAiB,UAA8B,CAAA,CACvF"}

package/dist/query/QueryProvider.js

@@ -1,29 +1,31 @@
 import { CACHE_TIME as e, STALE_TIME as t } from "./constants.js";
 import { shouldRetryQuery as n } from "./retry-policy.js";
-import { useState as r } from "react";
-import { jsx as i } from "react/jsx-runtime";
-import { QueryClient as a, QueryClientProvider as o } from "@tanstack/react-query";
+import { warnOnForeignClient as r } from "./foreign-client-warning.js";
+import { useState as i } from "react";
+import { jsx as a } from "react/jsx-runtime";
+import { QueryClient as o, QueryClientProvider as s } from "@tanstack/react-query";
 //#region src/query/QueryProvider.tsx
-function s({ children: s, client: c, defaultOptions: l }) {
-	let [u] = r(() => c ?? new a({ defaultOptions: {
+function c({ children: c, client: l, defaultOptions: u }) {
+	r(l);
+	let [d] = i(() => l ?? new o({ defaultOptions: {
 		queries: {
 			staleTime: t.DEFAULT,
 			gcTime: e.DEFAULT,
 			retry: n,
 			refetchOnWindowFocus: !1,
-			...l?.queries ?? {}
+			...u?.queries ?? {}
 		},
 		mutations: {
 			retry: 0,
-			...l?.mutations ?? {}
+			...u?.mutations ?? {}
 		}
 	} }));
-	return /* @__PURE__ */ i(o, {
-		client: u,
-		children: s
+	return /* @__PURE__ */ a(s, {
+		client: d,
+		children: c
 	});
 }
 //#endregion
-export { s as QueryProvider };
+export { c as QueryProvider };
 
 //# sourceMappingURL=QueryProvider.js.map

package/dist/query/QueryProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"QueryProvider.js","names":[],"sources":["../../src/query/QueryProvider.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport type { DefaultOptions } from \"@tanstack/react-query\";\nimport { STALE_TIME, CACHE_TIME } from \"./constants\";\nimport { shouldRetryQuery } from \"./retry-policy\";\n\nexport interface QueryProviderProps {\n    children: ReactNode;\n    /** Pass an existing client to share it across roots. */\n    client?: QueryClient;\n    /** Overrides for the default options applied when no `client` is provided. */\n    defaultOptions?: DefaultOptions;\n}\n\n/**\n * Wrapper around `QueryClientProvider` that bootstraps a `QueryClient` with\n * sane SDK defaults (5-minute stale time, 30-minute gc time, one retry for\n * failures worth replaying).\n *\n * Retries follow {@link shouldRetryQuery} rather than a flat count: a 4xx other\n * than 408/429 is the server refusing on purpose, and replaying it only doubles\n * the network log while the spinner keeps turning.\n */\nexport function QueryProvider({ children, client, defaultOptions }: QueryProviderProps) {\n    const [internalClient] = useState<QueryClient>(\n        () =>\n            client ??\n            new QueryClient({\n                defaultOptions: {\n                    queries: {\n                        staleTime: STALE_TIME.DEFAULT,\n                        gcTime: CACHE_TIME.DEFAULT,\n                        retry: shouldRetryQuery,\n                        refetchOnWindowFocus: false,\n                        ...(defaultOptions?.queries ?? {}),\n                    },\n                    mutations: {\n                        retry: 0,\n                        ...(defaultOptions?.mutations ?? {}),\n                    },\n                },\n            }),\n    );\n\n    return <QueryClientProvider client={internalClient}>{children}</QueryClientProvider>;\n}\n"],"mappings":";;;;;;AAwBA,SAAgB,EAAc,EAAE,aAAU,WAAQ,qBAAsC;CACpF,IAAM,CAAC,KAAkB,QAEjB,KACA,IAAI,EAAY,EACZ,gBAAgB;EACZ,SAAS;GACL,WAAW,EAAW;GACtB,QAAQ,EAAW;GACnB,OAAO;GACP,sBAAsB;GACtB,GAAI,GAAgB,WAAW,CAAC;EACpC;EACA,WAAW;GACP,OAAO;GACP,GAAI,GAAgB,aAAa,CAAC;EACtC;CACJ,EACJ,CAAC,CACT;CAEA,OAAO,kBAAC,GAAD;EAAqB,QAAQ;EAAiB;CAA8B,CAAA;AACvF"}
+{"version":3,"file":"QueryProvider.js","names":[],"sources":["../../src/query/QueryProvider.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport type { DefaultOptions } from \"@tanstack/react-query\";\nimport { STALE_TIME, CACHE_TIME } from \"./constants\";\nimport { shouldRetryQuery } from \"./retry-policy\";\nimport { warnOnForeignClient } from \"./foreign-client-warning\";\n\nexport interface QueryProviderProps {\n    children: ReactNode;\n    /** Pass an existing client to share it across roots. */\n    client?: QueryClient;\n    /** Overrides for the default options applied when no `client` is provided. */\n    defaultOptions?: DefaultOptions;\n}\n\n/**\n * Wrapper around `QueryClientProvider` that bootstraps a `QueryClient` with\n * sane SDK defaults (5-minute stale time, 30-minute gc time, one retry for\n * failures worth replaying).\n *\n * Retries follow {@link shouldRetryQuery} rather than a flat count: a 4xx other\n * than 408/429 is the server refusing on purpose, and replaying it only doubles\n * the network log while the spinner keeps turning.\n */\nexport function QueryProvider({ children, client, defaultOptions }: QueryProviderProps) {\n    warnOnForeignClient(client);\n\n    const [internalClient] = useState<QueryClient>(\n        () =>\n            client ??\n            new QueryClient({\n                defaultOptions: {\n                    queries: {\n                        staleTime: STALE_TIME.DEFAULT,\n                        gcTime: CACHE_TIME.DEFAULT,\n                        retry: shouldRetryQuery,\n                        refetchOnWindowFocus: false,\n                        ...(defaultOptions?.queries ?? {}),\n                    },\n                    mutations: {\n                        retry: 0,\n                        ...(defaultOptions?.mutations ?? {}),\n                    },\n                },\n            }),\n    );\n\n    return <QueryClientProvider client={internalClient}>{children}</QueryClientProvider>;\n}\n"],"mappings":";;;;;;;AAyBA,SAAgB,EAAc,EAAE,aAAU,WAAQ,qBAAsC;CACpF,EAAoB,CAAM;CAE1B,IAAM,CAAC,KAAkB,QAEjB,KACA,IAAI,EAAY,EACZ,gBAAgB;EACZ,SAAS;GACL,WAAW,EAAW;GACtB,QAAQ,EAAW;GACnB,OAAO;GACP,sBAAsB;GACtB,GAAI,GAAgB,WAAW,CAAC;EACpC;EACA,WAAW;GACP,OAAO;GACP,GAAI,GAAgB,aAAa,CAAC;EACtC;CACJ,EACJ,CAAC,CACT;CAEA,OAAO,kBAAC,GAAD;EAAqB,QAAQ;EAAiB;CAA8B,CAAA;AACvF"}

package/dist/query/foreign-client-warning.cjs

@@ -0,0 +1,2 @@
+const e=require("../utils/dev-mode.cjs"),t=require("../utils/duplicate-instance.cjs");let n=require("@tanstack/react-query");var r=!1;function i(i){r||i===void 0||!e.isDevBuild()||i instanceof n.QueryClient||typeof i.getQueryCache==`function`&&typeof i.mount==`function`&&(r=!0,console.warn(`[tempest-react-sdk] <QueryProvider client={...} /> received a QueryClient built by a different copy of @tanstack/react-query. The SDK publishes it on its own copy's context, so the app's \`useQuery\` calls will throw "No QueryClient set" even though this provider is mounted. `+t.DUPLICATE_COPY_REMEDY))}exports.warnOnForeignClient=i;
+//# sourceMappingURL=foreign-client-warning.cjs.map

package/dist/query/foreign-client-warning.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreign-client-warning.cjs","names":[],"sources":["../../src/query/foreign-client-warning.ts"],"sourcesContent":["/**\n * Internal, in its own file for the reason the AppBar warning is: a module that\n * exports a component may export nothing else without breaking Fast Refresh\n * (`react-refresh/only-export-components`), and the warn-once latch needs a\n * reset for tests to assert the warning more than once.\n */\nimport { QueryClient } from \"@tanstack/react-query\";\n\nimport { isDevBuild } from \"../utils/dev-mode\";\nimport { DUPLICATE_COPY_REMEDY } from \"../utils/duplicate-instance\";\n\n/** Set once the warning has printed, so a re-render does not bury the console. */\nlet warnedForeignClient = false;\n\n/**\n * Reset the warn-once latch. Test-only: the latch is module state, so a suite\n * asserting the warning more than once would otherwise see it only the first time.\n */\nexport function resetForeignClientWarning(): void {\n    warnedForeignClient = false;\n}\n\n/**\n * Warn when the `client` handed in was built by a different copy of\n * `@tanstack/react-query`.\n *\n * This prop is the one place the app's copy and the SDK's copy touch: the app\n * constructs a `QueryClient` and passes it in, and `QueryClientProvider` —\n * resolved from the SDK's copy — publishes it on *that* copy's context. Every\n * `useQuery` in the app then reads the app copy's context, finds nothing, and\n * throws `No QueryClient set, use QueryClientProvider to set one` while a\n * provider is plainly mounted three lines up. Nothing in that message points at\n * the duplicate, which is why it costs an afternoon.\n *\n * `instanceof` is the discriminator, and it is exactly the right one: two copies\n * define two distinct `QueryClient` classes, so a client from the other copy\n * duck-types perfectly and fails the identity check. The duck-type guard runs\n * first so the warning fires only on the shape that is actually a client —\n * without it, every hand-rolled test double would trip it.\n *\n * @param client - The client the caller passed, if any.\n */\nexport function warnOnForeignClient(client: QueryClient | undefined): void {\n    if (warnedForeignClient || client === undefined || !isDevBuild()) return;\n    if (client instanceof QueryClient) return;\n    const looksLikeClient =\n        typeof (client as Partial<QueryClient>).getQueryCache === \"function\" &&\n        typeof (client as Partial<QueryClient>).mount === \"function\";\n    if (!looksLikeClient) return;\n    warnedForeignClient = true;\n    console.warn(\n        \"[tempest-react-sdk] <QueryProvider client={...} /> received a QueryClient \" +\n            \"built by a different copy of @tanstack/react-query. The SDK publishes it on \" +\n            \"its own copy's context, so the app's `useQuery` calls will throw \" +\n            '\"No QueryClient set\" even though this provider is mounted. ' +\n            DUPLICATE_COPY_REMEDY,\n    );\n}\n"],"mappings":"6HAYA,IAAI,EAAsB,GA8B1B,SAAgB,EAAoB,EAAuC,CACnE,GAAuB,IAAW,IAAA,IAAa,CAAC,EAAA,WAAW,GAC3D,aAAkB,EAAA,aAElB,OAAQ,EAAgC,eAAkB,YAC1D,OAAQ,EAAgC,OAAU,aAEtD,EAAsB,GACtB,QAAQ,KACJ,uRAII,EAAA,qBACR,EACJ"}

package/dist/query/foreign-client-warning.js

@@ -0,0 +1,12 @@
+import { isDevBuild as e } from "../utils/dev-mode.js";
+import { DUPLICATE_COPY_REMEDY as t } from "../utils/duplicate-instance.js";
+import { QueryClient as n } from "@tanstack/react-query";
+//#region src/query/foreign-client-warning.ts
+var r = !1;
+function i(i) {
+	r || i === void 0 || !e() || i instanceof n || typeof i.getQueryCache == "function" && typeof i.mount == "function" && (r = !0, console.warn("[tempest-react-sdk] <QueryProvider client={...} /> received a QueryClient built by a different copy of @tanstack/react-query. The SDK publishes it on its own copy's context, so the app's `useQuery` calls will throw \"No QueryClient set\" even though this provider is mounted. " + t));
+}
+//#endregion
+export { i as warnOnForeignClient };
+
+//# sourceMappingURL=foreign-client-warning.js.map

package/dist/query/foreign-client-warning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreign-client-warning.js","names":[],"sources":["../../src/query/foreign-client-warning.ts"],"sourcesContent":["/**\n * Internal, in its own file for the reason the AppBar warning is: a module that\n * exports a component may export nothing else without breaking Fast Refresh\n * (`react-refresh/only-export-components`), and the warn-once latch needs a\n * reset for tests to assert the warning more than once.\n */\nimport { QueryClient } from \"@tanstack/react-query\";\n\nimport { isDevBuild } from \"../utils/dev-mode\";\nimport { DUPLICATE_COPY_REMEDY } from \"../utils/duplicate-instance\";\n\n/** Set once the warning has printed, so a re-render does not bury the console. */\nlet warnedForeignClient = false;\n\n/**\n * Reset the warn-once latch. Test-only: the latch is module state, so a suite\n * asserting the warning more than once would otherwise see it only the first time.\n */\nexport function resetForeignClientWarning(): void {\n    warnedForeignClient = false;\n}\n\n/**\n * Warn when the `client` handed in was built by a different copy of\n * `@tanstack/react-query`.\n *\n * This prop is the one place the app's copy and the SDK's copy touch: the app\n * constructs a `QueryClient` and passes it in, and `QueryClientProvider` —\n * resolved from the SDK's copy — publishes it on *that* copy's context. Every\n * `useQuery` in the app then reads the app copy's context, finds nothing, and\n * throws `No QueryClient set, use QueryClientProvider to set one` while a\n * provider is plainly mounted three lines up. Nothing in that message points at\n * the duplicate, which is why it costs an afternoon.\n *\n * `instanceof` is the discriminator, and it is exactly the right one: two copies\n * define two distinct `QueryClient` classes, so a client from the other copy\n * duck-types perfectly and fails the identity check. The duck-type guard runs\n * first so the warning fires only on the shape that is actually a client —\n * without it, every hand-rolled test double would trip it.\n *\n * @param client - The client the caller passed, if any.\n */\nexport function warnOnForeignClient(client: QueryClient | undefined): void {\n    if (warnedForeignClient || client === undefined || !isDevBuild()) return;\n    if (client instanceof QueryClient) return;\n    const looksLikeClient =\n        typeof (client as Partial<QueryClient>).getQueryCache === \"function\" &&\n        typeof (client as Partial<QueryClient>).mount === \"function\";\n    if (!looksLikeClient) return;\n    warnedForeignClient = true;\n    console.warn(\n        \"[tempest-react-sdk] <QueryProvider client={...} /> received a QueryClient \" +\n            \"built by a different copy of @tanstack/react-query. The SDK publishes it on \" +\n            \"its own copy's context, so the app's `useQuery` calls will throw \" +\n            '\"No QueryClient set\" even though this provider is mounted. ' +\n            DUPLICATE_COPY_REMEDY,\n    );\n}\n"],"mappings":";;;;AAYA,IAAI,IAAsB;AA8B1B,SAAgB,EAAoB,GAAuC;CACnE,KAAuB,MAAW,KAAA,KAAa,CAAC,EAAW,KAC3D,aAAkB,KAElB,OAAQ,EAAgC,iBAAkB,cAC1D,OAAQ,EAAgC,SAAU,eAEtD,IAAsB,IACtB,QAAQ,KACJ,yRAII,CACR;AACJ"}

package/dist/router/AppRouter.cjs

@@ -1,2 +1,2 @@
-const e=require("../auth/lazy-with-retry.cjs"),t=require("./RouteGuard.cjs");let n=require("react"),r=require("react/jsx-runtime"),i=require("react-router");function a(e){return e}var o=new WeakMap;function s(t){let n=o.get(t);return n||(n=e.lazyWithRetry(t.lazy),o.set(t,n)),n}function c({guard:e,redirectTo:n,children:i}){let a=typeof e==`function`?e():e;return(0,r.jsx)(t.RouteGuard,{when:a,redirectTo:n,children:i})}function l(e){return e.map((e,t)=>{let n=e.element;if(e.lazy){let t=s(e);n=(0,r.jsx)(t,{})}return e.guard!==void 0&&(n=(0,r.jsx)(c,{guard:e.guard,redirectTo:e.redirectTo,children:n})),e.index?(0,r.jsx)(i.Route,{index:!0,element:n},`index-${t}`):(0,r.jsx)(i.Route,{path:e.path,element:n,caseSensitive:e.caseSensitive,children:e.children?l(e.children):null},e.path??`route-${t}`)})}var u={browser:i.BrowserRouter,hash:i.HashRouter,memory:i.MemoryRouter};function d({routes:e,router:t=`browser`,basename:a,initialEntries:o,fallback:s=null}){let c=(0,n.useMemo)(()=>l(e),[e]),d=u[t];return(0,r.jsx)(d,{...t===`memory`?{basename:a,initialEntries:o}:{basename:a},children:(0,r.jsx)(n.Suspense,{fallback:s,children:(0,r.jsx)(i.Routes,{children:c})})})}exports.AppRouter=d,exports.defineRoutes=a;
+const e=require("../auth/lazy-with-retry.cjs"),t=require("./RouteGuard.cjs");let n=require("react"),r=require("react/jsx-runtime"),i=require("react-router");function a(e){return e}var o=new WeakMap;function s(t){let n=o.get(t);return n||(n=e.lazyWithRetry(t.lazy),o.set(t,n)),n}function c({guard:e,guardFallback:n,redirectTo:i,children:a}){let o=typeof e==`function`?e():e;return(0,r.jsx)(t.RouteGuard,{when:o,fallback:n,redirectTo:i,children:a})}var l=new WeakMap,u=0;function d(e){let t=l.get(e);return t||(t=`guard-${++u}`,l.set(e,t)),t}function f(e,t){return e.map((e,n)=>{let a=e.element;if(e.lazy){let t=s(e);a=(0,r.jsx)(t,{})}return e.guard!==void 0&&(a=(0,r.jsx)(c,{guard:e.guard,guardFallback:e.guardFallback??t,redirectTo:e.redirectTo,children:a},d(e))),e.index?(0,r.jsx)(i.Route,{index:!0,element:a},`index-${n}`):(0,r.jsx)(i.Route,{path:e.path,element:a,caseSensitive:e.caseSensitive,children:e.children?f(e.children,t):null},e.path??`route-${n}`)})}var p={browser:i.BrowserRouter,hash:i.HashRouter,memory:i.MemoryRouter};function m({routes:e,router:t=`browser`,basename:a,initialEntries:o,fallback:s=null}){let c=(0,n.useMemo)(()=>f(e,s),[e,s]),l=p[t];return(0,r.jsx)(l,{...t===`memory`?{basename:a,initialEntries:o}:{basename:a},children:(0,r.jsx)(n.Suspense,{fallback:s,children:(0,r.jsx)(i.Routes,{children:c})})})}exports.AppRouter=m,exports.defineRoutes=a;
 //# sourceMappingURL=AppRouter.cjs.map

package/dist/router/AppRouter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"AppRouter.cjs","names":[],"sources":["../../src/router/AppRouter.tsx"],"sourcesContent":["import { Suspense, useMemo } from \"react\";\nimport type { ComponentType, ReactNode } from \"react\";\nimport { BrowserRouter, HashRouter, MemoryRouter, Routes, Route } from \"react-router\";\nimport { lazyWithRetry } from \"../auth/lazy-with-retry\";\nimport { RouteGuard } from \"./RouteGuard\";\nimport type { RouterKind, TempestRouteObject } from \"./types\";\n\n/**\n * Identity helper that types a declarative route tree. Use it so editors give\n * autocomplete and type-checking on every node; the array is returned as-is.\n *\n * @example\n * export const routes = defineRoutes([\n *     { path: \"/\", element: <Layout />, children: [\n *         { index: true, lazy: () => import(\"./pages/Home\") },\n *         { path: \"settings\", lazy: () => import(\"./pages/Settings\"),\n *           guard: () => useAuth.getState().isAuthenticated, redirectTo: \"/login\" },\n *     ] },\n * ]);\n */\nexport function defineRoutes(routes: TempestRouteObject[]): TempestRouteObject[] {\n    return routes;\n}\n\nconst lazyCache = new WeakMap<TempestRouteObject, ComponentType<unknown>>();\n\nfunction resolveLazy(route: TempestRouteObject): ComponentType<unknown> {\n    let comp = lazyCache.get(route);\n    if (!comp) {\n        comp = lazyWithRetry(route.lazy!);\n        lazyCache.set(route, comp);\n    }\n    return comp;\n}\n\nfunction GuardedElement({\n    guard,\n    redirectTo,\n    children,\n}: {\n    guard: boolean | (() => boolean);\n    redirectTo?: string;\n    children: ReactNode;\n}) {\n    const allowed = typeof guard === \"function\" ? guard() : guard;\n    return (\n        <RouteGuard when={allowed} redirectTo={redirectTo}>\n            {children}\n        </RouteGuard>\n    );\n}\n\nfunction toRouteElements(routes: TempestRouteObject[]): ReactNode {\n    return routes.map((route, i) => {\n        let element: ReactNode = route.element;\n        if (route.lazy) {\n            const LazyComponent = resolveLazy(route);\n            element = <LazyComponent />;\n        }\n        if (route.guard !== undefined) {\n            element = (\n                <GuardedElement guard={route.guard} redirectTo={route.redirectTo}>\n                    {element}\n                </GuardedElement>\n            );\n        }\n\n        if (route.index) {\n            return <Route key={`index-${i}`} index element={element} />;\n        }\n\n        return (\n            <Route\n                key={route.path ?? `route-${i}`}\n                path={route.path}\n                element={element}\n                caseSensitive={route.caseSensitive}\n            >\n                {route.children ? toRouteElements(route.children) : null}\n            </Route>\n        );\n    });\n}\n\nconst ROUTERS: Record<RouterKind, typeof BrowserRouter> = {\n    browser: BrowserRouter,\n    hash: HashRouter,\n    memory: MemoryRouter,\n};\n\nexport interface AppRouterProps {\n    /** Declarative route tree, ideally built with {@link defineRoutes}. */\n    routes: TempestRouteObject[];\n    /** History strategy (default: `\"browser\"`). */\n    router?: RouterKind;\n    /** App-wide base path forwarded to the underlying router. */\n    basename?: string;\n    /** Initial URLs for the `\"memory\"` router (tests / non-DOM hosts). */\n    initialEntries?: string[];\n    /** Suspense fallback shown while a `lazy` route chunk loads. */\n    fallback?: ReactNode;\n}\n\n/**\n * Render a full React Router (v7 or v8, declarative mode) from a\n * {@link defineRoutes}\n * tree: picks the history strategy, wraps everything in a `<Suspense>` boundary\n * for `lazy` routes, and applies per-route `guard` redirects. This is the\n * single entry point apps mount at their root.\n *\n * @example\n * <AppRouter routes={routes} fallback={<Spinner />} />\n */\nexport function AppRouter({\n    routes,\n    router = \"browser\",\n    basename,\n    initialEntries,\n    fallback = null,\n}: AppRouterProps) {\n    const tree = useMemo(() => toRouteElements(routes), [routes]);\n    const Router = ROUTERS[router];\n    const routerProps = router === \"memory\" ? { basename, initialEntries } : { basename };\n\n    return (\n        <Router {...routerProps}>\n            <Suspense fallback={fallback}>\n                <Routes>{tree}</Routes>\n            </Suspense>\n        </Router>\n    );\n}\n"],"mappings":"6JAoBA,SAAgB,EAAa,EAAoD,CAC7E,OAAO,CACX,CAEA,IAAM,EAAY,IAAI,QAEtB,SAAS,EAAY,EAAmD,CACpE,IAAI,EAAO,EAAU,IAAI,CAAK,EAK9B,OAJK,IACD,EAAO,EAAA,cAAc,EAAM,IAAK,EAChC,EAAU,IAAI,EAAO,CAAI,GAEtB,CACX,CAEA,SAAS,EAAe,CACpB,QACA,aACA,YAKD,CACC,IAAM,EAAU,OAAO,GAAU,WAAa,EAAM,EAAI,EACxD,OACI,EAAA,EAAA,IAAA,CAAC,EAAA,WAAD,CAAY,KAAM,EAAqB,aAClC,UACO,CAAA,CAEpB,CAEA,SAAS,EAAgB,EAAyC,CAC9D,OAAO,EAAO,KAAK,EAAO,IAAM,CAC5B,IAAI,EAAqB,EAAM,QAC/B,GAAI,EAAM,KAAM,CACZ,IAAM,EAAgB,EAAY,CAAK,EACvC,GAAU,EAAA,EAAA,IAAA,CAAC,EAAD,CAAgB,CAAA,CAC9B,CAaA,OAZI,EAAM,QAAU,IAAA,KAChB,GACI,EAAA,EAAA,IAAA,CAAC,EAAD,CAAgB,MAAO,EAAM,MAAO,WAAY,EAAM,WACjD,SAAA,CACW,CAAA,GAIpB,EAAM,OACC,EAAA,EAAA,IAAA,CAAC,EAAA,MAAD,CAA0B,MAAA,GAAe,SAAU,EAAvC,SAAS,GAA8B,GAI1D,EAAA,EAAA,IAAA,CAAC,EAAA,MAAD,CAEI,KAAM,EAAM,KACH,UACT,cAAe,EAAM,cAEpB,SAAA,EAAM,SAAW,EAAgB,EAAM,QAAQ,EAAI,IACjD,EANE,EAAM,MAAQ,SAAS,GAMzB,CAEf,CAAC,CACL,CAEA,IAAM,EAAoD,CACtD,QAAS,EAAA,cACT,KAAM,EAAA,WACN,OAAQ,EAAA,YACZ,EAyBA,SAAgB,EAAU,CACtB,SACA,SAAS,UACT,WACA,iBACA,WAAW,MACI,CACf,IAAM,GAAA,EAAO,EAAA,QAAA,KAAc,EAAgB,CAAM,EAAG,CAAC,CAAM,CAAC,EACtD,EAAS,EAAQ,GAGvB,OACI,EAAA,EAAA,IAAA,CAAC,EAAD,CAAQ,GAHQ,IAAW,SAAW,CAAE,WAAU,gBAAe,EAAI,CAAE,UAAS,EAI5E,UAAA,EAAA,EAAA,IAAA,CAAC,EAAA,SAAD,CAAoB,WAChB,UAAA,EAAA,EAAA,IAAA,CAAC,EAAA,OAAD,CAAA,SAAS,CAAa,CAAA,CAChB,CAAA,CACN,CAAA,CAEhB"}
+{"version":3,"file":"AppRouter.cjs","names":[],"sources":["../../src/router/AppRouter.tsx"],"sourcesContent":["import { Suspense, useMemo } from \"react\";\nimport type { ComponentType, ReactNode } from \"react\";\nimport { BrowserRouter, HashRouter, MemoryRouter, Routes, Route } from \"react-router\";\nimport { lazyWithRetry } from \"../auth/lazy-with-retry\";\nimport { RouteGuard } from \"./RouteGuard\";\nimport type { RouteGuardResult, RouterKind, TempestRouteObject } from \"./types\";\n\n/**\n * Identity helper that types a declarative route tree. Use it so editors give\n * autocomplete and type-checking on every node; the array is returned as-is.\n *\n * @example\n * export const routes = defineRoutes([\n *     { path: \"/\", element: <Layout />, children: [\n *         { index: true, lazy: () => import(\"./pages/Home\") },\n *         { path: \"settings\", lazy: () => import(\"./pages/Settings\"),\n *           guard: () => useAuth.getState().isAuthenticated, redirectTo: \"/login\" },\n *     ] },\n * ]);\n */\nexport function defineRoutes(routes: TempestRouteObject[]): TempestRouteObject[] {\n    return routes;\n}\n\nconst lazyCache = new WeakMap<TempestRouteObject, ComponentType<unknown>>();\n\nfunction resolveLazy(route: TempestRouteObject): ComponentType<unknown> {\n    let comp = lazyCache.get(route);\n    if (!comp) {\n        comp = lazyWithRetry(route.lazy!);\n        lazyCache.set(route, comp);\n    }\n    return comp;\n}\n\n/**\n * Runs one route's `guard` and renders the outcome.\n *\n * The guard is called during this component's render, which is what lets it\n * call hooks — `useCan` returning `{ allowed, isLoading }` maps straight onto\n * the three outcomes. See {@link guardKey} for why each guarded route gets its\n * own instance.\n */\nfunction GuardedElement({\n    guard,\n    guardFallback,\n    redirectTo,\n    children,\n}: {\n    guard: boolean | (() => RouteGuardResult);\n    guardFallback?: ReactNode;\n    redirectTo?: string;\n    children: ReactNode;\n}) {\n    const allowed = typeof guard === \"function\" ? guard() : guard;\n    return (\n        <RouteGuard when={allowed} fallback={guardFallback} redirectTo={redirectTo}>\n            {children}\n        </RouteGuard>\n    );\n}\n\nconst guardKeys = new WeakMap<TempestRouteObject, string>();\nlet guardKeySeq = 0;\n\n/**\n * A key unique to each route object, so React remounts `GuardedElement` when\n * the matched route changes instead of reusing the instance.\n *\n * Load-bearing once guards may call hooks. React Router renders the matched\n * route's element at the same position in the tree, so without a differing key\n * React reconciles two different routes onto the same `GuardedElement`\n * instance and the previous route's guard state survives into the next one's —\n * a guard reading `useState(\"from-a\")` still reads `\"from-a\"` after navigating\n * to a route whose guard initialises it to `\"from-b\"`. Path is not enough on\n * its own: two routes in different branches can share one.\n */\nfunction guardKey(route: TempestRouteObject): string {\n    let key = guardKeys.get(route);\n    if (!key) {\n        key = `guard-${++guardKeySeq}`;\n        guardKeys.set(route, key);\n    }\n    return key;\n}\n\nfunction toRouteElements(routes: TempestRouteObject[], fallback: ReactNode): ReactNode {\n    return routes.map((route, i) => {\n        let element: ReactNode = route.element;\n        if (route.lazy) {\n            const LazyComponent = resolveLazy(route);\n            element = <LazyComponent />;\n        }\n        if (route.guard !== undefined) {\n            element = (\n                <GuardedElement\n                    key={guardKey(route)}\n                    guard={route.guard}\n                    guardFallback={route.guardFallback ?? fallback}\n                    redirectTo={route.redirectTo}\n                >\n                    {element}\n                </GuardedElement>\n            );\n        }\n\n        if (route.index) {\n            return <Route key={`index-${i}`} index element={element} />;\n        }\n\n        return (\n            <Route\n                key={route.path ?? `route-${i}`}\n                path={route.path}\n                element={element}\n                caseSensitive={route.caseSensitive}\n            >\n                {route.children ? toRouteElements(route.children, fallback) : null}\n            </Route>\n        );\n    });\n}\n\nconst ROUTERS: Record<RouterKind, typeof BrowserRouter> = {\n    browser: BrowserRouter,\n    hash: HashRouter,\n    memory: MemoryRouter,\n};\n\nexport interface AppRouterProps {\n    /** Declarative route tree, ideally built with {@link defineRoutes}. */\n    routes: TempestRouteObject[];\n    /** History strategy (default: `\"browser\"`). */\n    router?: RouterKind;\n    /** App-wide base path forwarded to the underlying router. */\n    basename?: string;\n    /** Initial URLs for the `\"memory\"` router (tests / non-DOM hosts). */\n    initialEntries?: string[];\n    /**\n     * Suspense fallback shown while a `lazy` route chunk loads, and the default\n     * for a route whose `guard` answers `\"pending\"` — one spinner covers both\n     * kinds of \"not ready yet\". A route overrides it with its own\n     * `guardFallback`.\n     */\n    fallback?: ReactNode;\n}\n\n/**\n * Render a full React Router (v7 or v8, declarative mode) from a\n * {@link defineRoutes}\n * tree: picks the history strategy, wraps everything in a `<Suspense>` boundary\n * for `lazy` routes, and applies per-route `guard` redirects. This is the\n * single entry point apps mount at their root.\n *\n * @example\n * <AppRouter routes={routes} fallback={<Spinner />} />\n */\nexport function AppRouter({\n    routes,\n    router = \"browser\",\n    basename,\n    initialEntries,\n    fallback = null,\n}: AppRouterProps) {\n    const tree = useMemo(() => toRouteElements(routes, fallback), [routes, fallback]);\n    const Router = ROUTERS[router];\n    const routerProps = router === \"memory\" ? { basename, initialEntries } : { basename };\n\n    return (\n        <Router {...routerProps}>\n            <Suspense fallback={fallback}>\n                <Routes>{tree}</Routes>\n            </Suspense>\n        </Router>\n    );\n}\n"],"mappings":"6JAoBA,SAAgB,EAAa,EAAoD,CAC7E,OAAO,CACX,CAEA,IAAM,EAAY,IAAI,QAEtB,SAAS,EAAY,EAAmD,CACpE,IAAI,EAAO,EAAU,IAAI,CAAK,EAK9B,OAJK,IACD,EAAO,EAAA,cAAc,EAAM,IAAK,EAChC,EAAU,IAAI,EAAO,CAAI,GAEtB,CACX,CAUA,SAAS,EAAe,CACpB,QACA,gBACA,aACA,YAMD,CACC,IAAM,EAAU,OAAO,GAAU,WAAa,EAAM,EAAI,EACxD,OACI,EAAA,EAAA,IAAA,CAAC,EAAA,WAAD,CAAY,KAAM,EAAS,SAAU,EAA2B,aAC3D,UACO,CAAA,CAEpB,CAEA,IAAM,EAAY,IAAI,QAClB,EAAc,EAclB,SAAS,EAAS,EAAmC,CACjD,IAAI,EAAM,EAAU,IAAI,CAAK,EAK7B,OAJK,IACD,EAAM,SAAS,EAAE,IACjB,EAAU,IAAI,EAAO,CAAG,GAErB,CACX,CAEA,SAAS,EAAgB,EAA8B,EAAgC,CACnF,OAAO,EAAO,KAAK,EAAO,IAAM,CAC5B,IAAI,EAAqB,EAAM,QAC/B,GAAI,EAAM,KAAM,CACZ,IAAM,EAAgB,EAAY,CAAK,EACvC,GAAU,EAAA,EAAA,IAAA,CAAC,EAAD,CAAgB,CAAA,CAC9B,CAkBA,OAjBI,EAAM,QAAU,IAAA,KAChB,GACI,EAAA,EAAA,IAAA,CAAC,EAAD,CAEI,MAAO,EAAM,MACb,cAAe,EAAM,eAAiB,EACtC,WAAY,EAAM,WAEjB,SAAA,CACW,EANP,EAAS,CAAK,CAMP,GAIpB,EAAM,OACC,EAAA,EAAA,IAAA,CAAC,EAAA,MAAD,CAA0B,MAAA,GAAe,SAAU,EAAvC,SAAS,GAA8B,GAI1D,EAAA,EAAA,IAAA,CAAC,EAAA,MAAD,CAEI,KAAM,EAAM,KACH,UACT,cAAe,EAAM,cAEpB,SAAA,EAAM,SAAW,EAAgB,EAAM,SAAU,CAAQ,EAAI,IAC3D,EANE,EAAM,MAAQ,SAAS,GAMzB,CAEf,CAAC,CACL,CAEA,IAAM,EAAoD,CACtD,QAAS,EAAA,cACT,KAAM,EAAA,WACN,OAAQ,EAAA,YACZ,EA8BA,SAAgB,EAAU,CACtB,SACA,SAAS,UACT,WACA,iBACA,WAAW,MACI,CACf,IAAM,GAAA,EAAO,EAAA,QAAA,KAAc,EAAgB,EAAQ,CAAQ,EAAG,CAAC,EAAQ,CAAQ,CAAC,EAC1E,EAAS,EAAQ,GAGvB,OACI,EAAA,EAAA,IAAA,CAAC,EAAD,CAAQ,GAHQ,IAAW,SAAW,CAAE,WAAU,gBAAe,EAAI,CAAE,UAAS,EAI5E,UAAA,EAAA,EAAA,IAAA,CAAC,EAAA,SAAD,CAAoB,WAChB,UAAA,EAAA,EAAA,IAAA,CAAC,EAAA,OAAD,CAAA,SAAS,CAAa,CAAA,CAChB,CAAA,CACN,CAAA,CAEhB"}

package/dist/router/AppRouter.js

@@ -12,43 +12,50 @@ function f(t) {
 	let n = d.get(t);
 	return n || (n = e(t.lazy), d.set(t, n)), n;
 }
-function p({ guard: e, redirectTo: n, children: r }) {
-	let a = typeof e == "function" ? e() : e;
+function p({ guard: e, guardFallback: n, redirectTo: r, children: a }) {
+	let o = typeof e == "function" ? e() : e;
 	return /* @__PURE__ */ i(t, {
-		when: a,
-		redirectTo: n,
-		children: r
+		when: o,
+		fallback: n,
+		redirectTo: r,
+		children: a
 	});
 }
-function m(e) {
-	return e.map((e, t) => {
-		let n = e.element;
+var m = /* @__PURE__ */ new WeakMap(), h = 0;
+function g(e) {
+	let t = m.get(e);
+	return t || (t = `guard-${++h}`, m.set(e, t)), t;
+}
+function _(e, t) {
+	return e.map((e, n) => {
+		let r = e.element;
 		if (e.lazy) {
 			let t = f(e);
-			n = /* @__PURE__ */ i(t, {});
+			r = /* @__PURE__ */ i(t, {});
 		}
-		return e.guard !== void 0 && (n = /* @__PURE__ */ i(p, {
+		return e.guard !== void 0 && (r = /* @__PURE__ */ i(p, {
 			guard: e.guard,
+			guardFallback: e.guardFallback ?? t,
 			redirectTo: e.redirectTo,
-			children: n
-		})), e.index ? /* @__PURE__ */ i(c, {
+			children: r
+		}, g(e))), e.index ? /* @__PURE__ */ i(c, {
 			index: !0,
-			element: n
-		}, `index-${t}`) : /* @__PURE__ */ i(c, {
+			element: r
+		}, `index-${n}`) : /* @__PURE__ */ i(c, {
 			path: e.path,
-			element: n,
+			element: r,
 			caseSensitive: e.caseSensitive,
-			children: e.children ? m(e.children) : null
-		}, e.path ?? `route-${t}`);
+			children: e.children ? _(e.children, t) : null
+		}, e.path ?? `route-${n}`);
 	});
 }
-var h = {
+var v = {
 	browser: a,
 	hash: o,
 	memory: s
 };
-function g({ routes: e, router: t = "browser", basename: a, initialEntries: o, fallback: s = null }) {
-	let c = r(() => m(e), [e]), u = h[t];
+function y({ routes: e, router: t = "browser", basename: a, initialEntries: o, fallback: s = null }) {
+	let c = r(() => _(e, s), [e, s]), u = v[t];
 	return /* @__PURE__ */ i(u, {
 		...t === "memory" ? {
 			basename: a,
@@ -61,6 +68,6 @@ function g({ routes: e, router: t = "browser", basename: a, initialEntries: o, f
 	});
 }
 //#endregion
-export { g as AppRouter, u as defineRoutes };
+export { y as AppRouter, u as defineRoutes };
 
 //# sourceMappingURL=AppRouter.js.map

package/dist/router/AppRouter.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppRouter.js","names":[],"sources":["../../src/router/AppRouter.tsx"],"sourcesContent":["import { Suspense, useMemo } from \"react\";\nimport type { ComponentType, ReactNode } from \"react\";\nimport { BrowserRouter, HashRouter, MemoryRouter, Routes, Route } from \"react-router\";\nimport { lazyWithRetry } from \"../auth/lazy-with-retry\";\nimport { RouteGuard } from \"./RouteGuard\";\nimport type { RouterKind, TempestRouteObject } from \"./types\";\n\n/**\n * Identity helper that types a declarative route tree. Use it so editors give\n * autocomplete and type-checking on every node; the array is returned as-is.\n *\n * @example\n * export const routes = defineRoutes([\n *     { path: \"/\", element: <Layout />, children: [\n *         { index: true, lazy: () => import(\"./pages/Home\") },\n *         { path: \"settings\", lazy: () => import(\"./pages/Settings\"),\n *           guard: () => useAuth.getState().isAuthenticated, redirectTo: \"/login\" },\n *     ] },\n * ]);\n */\nexport function defineRoutes(routes: TempestRouteObject[]): TempestRouteObject[] {\n    return routes;\n}\n\nconst lazyCache = new WeakMap<TempestRouteObject, ComponentType<unknown>>();\n\nfunction resolveLazy(route: TempestRouteObject): ComponentType<unknown> {\n    let comp = lazyCache.get(route);\n    if (!comp) {\n        comp = lazyWithRetry(route.lazy!);\n        lazyCache.set(route, comp);\n    }\n    return comp;\n}\n\nfunction GuardedElement({\n    guard,\n    redirectTo,\n    children,\n}: {\n    guard: boolean | (() => boolean);\n    redirectTo?: string;\n    children: ReactNode;\n}) {\n    const allowed = typeof guard === \"function\" ? guard() : guard;\n    return (\n        <RouteGuard when={allowed} redirectTo={redirectTo}>\n            {children}\n        </RouteGuard>\n    );\n}\n\nfunction toRouteElements(routes: TempestRouteObject[]): ReactNode {\n    return routes.map((route, i) => {\n        let element: ReactNode = route.element;\n        if (route.lazy) {\n            const LazyComponent = resolveLazy(route);\n            element = <LazyComponent />;\n        }\n        if (route.guard !== undefined) {\n            element = (\n                <GuardedElement guard={route.guard} redirectTo={route.redirectTo}>\n                    {element}\n                </GuardedElement>\n            );\n        }\n\n        if (route.index) {\n            return <Route key={`index-${i}`} index element={element} />;\n        }\n\n        return (\n            <Route\n                key={route.path ?? `route-${i}`}\n                path={route.path}\n                element={element}\n                caseSensitive={route.caseSensitive}\n            >\n                {route.children ? toRouteElements(route.children) : null}\n            </Route>\n        );\n    });\n}\n\nconst ROUTERS: Record<RouterKind, typeof BrowserRouter> = {\n    browser: BrowserRouter,\n    hash: HashRouter,\n    memory: MemoryRouter,\n};\n\nexport interface AppRouterProps {\n    /** Declarative route tree, ideally built with {@link defineRoutes}. */\n    routes: TempestRouteObject[];\n    /** History strategy (default: `\"browser\"`). */\n    router?: RouterKind;\n    /** App-wide base path forwarded to the underlying router. */\n    basename?: string;\n    /** Initial URLs for the `\"memory\"` router (tests / non-DOM hosts). */\n    initialEntries?: string[];\n    /** Suspense fallback shown while a `lazy` route chunk loads. */\n    fallback?: ReactNode;\n}\n\n/**\n * Render a full React Router (v7 or v8, declarative mode) from a\n * {@link defineRoutes}\n * tree: picks the history strategy, wraps everything in a `<Suspense>` boundary\n * for `lazy` routes, and applies per-route `guard` redirects. This is the\n * single entry point apps mount at their root.\n *\n * @example\n * <AppRouter routes={routes} fallback={<Spinner />} />\n */\nexport function AppRouter({\n    routes,\n    router = \"browser\",\n    basename,\n    initialEntries,\n    fallback = null,\n}: AppRouterProps) {\n    const tree = useMemo(() => toRouteElements(routes), [routes]);\n    const Router = ROUTERS[router];\n    const routerProps = router === \"memory\" ? { basename, initialEntries } : { basename };\n\n    return (\n        <Router {...routerProps}>\n            <Suspense fallback={fallback}>\n                <Routes>{tree}</Routes>\n            </Suspense>\n        </Router>\n    );\n}\n"],"mappings":";;;;;;AAoBA,SAAgB,EAAa,GAAoD;CAC7E,OAAO;AACX;AAEA,IAAM,oBAAY,IAAI,QAAoD;AAE1E,SAAS,EAAY,GAAmD;CACpE,IAAI,IAAO,EAAU,IAAI,CAAK;CAK9B,OAJK,MACD,IAAO,EAAc,EAAM,IAAK,GAChC,EAAU,IAAI,GAAO,CAAI,IAEtB;AACX;AAEA,SAAS,EAAe,EACpB,UACA,eACA,eAKD;CACC,IAAM,IAAU,OAAO,KAAU,aAAa,EAAM,IAAI;CACxD,OACI,kBAAC,GAAD;EAAY,MAAM;EAAqB;EAClC;CACO,CAAA;AAEpB;AAEA,SAAS,EAAgB,GAAyC;CAC9D,OAAO,EAAO,KAAK,GAAO,MAAM;EAC5B,IAAI,IAAqB,EAAM;EAC/B,IAAI,EAAM,MAAM;GACZ,IAAM,IAAgB,EAAY,CAAK;GACvC,IAAU,kBAAC,GAAD,CAAgB,CAAA;EAC9B;EAaA,OAZI,EAAM,UAAU,KAAA,MAChB,IACI,kBAAC,GAAD;GAAgB,OAAO,EAAM;GAAO,YAAY,EAAM;GACjD,UAAA;EACW,CAAA,IAIpB,EAAM,QACC,kBAAC,GAAD;GAA0B,OAAA;GAAe;EAAU,GAAvC,SAAS,GAA8B,IAI1D,kBAAC,GAAD;GAEI,MAAM,EAAM;GACH;GACT,eAAe,EAAM;GAEpB,UAAA,EAAM,WAAW,EAAgB,EAAM,QAAQ,IAAI;EACjD,GANE,EAAM,QAAQ,SAAS,GAMzB;CAEf,CAAC;AACL;AAEA,IAAM,IAAoD;CACtD,SAAS;CACT,MAAM;CACN,QAAQ;AACZ;AAyBA,SAAgB,EAAU,EACtB,WACA,YAAS,WACT,aACA,mBACA,cAAW,QACI;CACf,IAAM,IAAO,QAAc,EAAgB,CAAM,GAAG,CAAC,CAAM,CAAC,GACtD,IAAS,EAAQ;CAGvB,OACI,kBAAC,GAAD;EAAQ,GAHQ,MAAW,WAAW;GAAE;GAAU;EAAe,IAAI,EAAE,YAAS;EAI5E,UAAA,kBAAC,GAAD;GAAoB;GAChB,UAAA,kBAAC,GAAD,EAAA,UAAS,EAAa,CAAA;EAChB,CAAA;CACN,CAAA;AAEhB"}
+{"version":3,"file":"AppRouter.js","names":[],"sources":["../../src/router/AppRouter.tsx"],"sourcesContent":["import { Suspense, useMemo } from \"react\";\nimport type { ComponentType, ReactNode } from \"react\";\nimport { BrowserRouter, HashRouter, MemoryRouter, Routes, Route } from \"react-router\";\nimport { lazyWithRetry } from \"../auth/lazy-with-retry\";\nimport { RouteGuard } from \"./RouteGuard\";\nimport type { RouteGuardResult, RouterKind, TempestRouteObject } from \"./types\";\n\n/**\n * Identity helper that types a declarative route tree. Use it so editors give\n * autocomplete and type-checking on every node; the array is returned as-is.\n *\n * @example\n * export const routes = defineRoutes([\n *     { path: \"/\", element: <Layout />, children: [\n *         { index: true, lazy: () => import(\"./pages/Home\") },\n *         { path: \"settings\", lazy: () => import(\"./pages/Settings\"),\n *           guard: () => useAuth.getState().isAuthenticated, redirectTo: \"/login\" },\n *     ] },\n * ]);\n */\nexport function defineRoutes(routes: TempestRouteObject[]): TempestRouteObject[] {\n    return routes;\n}\n\nconst lazyCache = new WeakMap<TempestRouteObject, ComponentType<unknown>>();\n\nfunction resolveLazy(route: TempestRouteObject): ComponentType<unknown> {\n    let comp = lazyCache.get(route);\n    if (!comp) {\n        comp = lazyWithRetry(route.lazy!);\n        lazyCache.set(route, comp);\n    }\n    return comp;\n}\n\n/**\n * Runs one route's `guard` and renders the outcome.\n *\n * The guard is called during this component's render, which is what lets it\n * call hooks — `useCan` returning `{ allowed, isLoading }` maps straight onto\n * the three outcomes. See {@link guardKey} for why each guarded route gets its\n * own instance.\n */\nfunction GuardedElement({\n    guard,\n    guardFallback,\n    redirectTo,\n    children,\n}: {\n    guard: boolean | (() => RouteGuardResult);\n    guardFallback?: ReactNode;\n    redirectTo?: string;\n    children: ReactNode;\n}) {\n    const allowed = typeof guard === \"function\" ? guard() : guard;\n    return (\n        <RouteGuard when={allowed} fallback={guardFallback} redirectTo={redirectTo}>\n            {children}\n        </RouteGuard>\n    );\n}\n\nconst guardKeys = new WeakMap<TempestRouteObject, string>();\nlet guardKeySeq = 0;\n\n/**\n * A key unique to each route object, so React remounts `GuardedElement` when\n * the matched route changes instead of reusing the instance.\n *\n * Load-bearing once guards may call hooks. React Router renders the matched\n * route's element at the same position in the tree, so without a differing key\n * React reconciles two different routes onto the same `GuardedElement`\n * instance and the previous route's guard state survives into the next one's —\n * a guard reading `useState(\"from-a\")` still reads `\"from-a\"` after navigating\n * to a route whose guard initialises it to `\"from-b\"`. Path is not enough on\n * its own: two routes in different branches can share one.\n */\nfunction guardKey(route: TempestRouteObject): string {\n    let key = guardKeys.get(route);\n    if (!key) {\n        key = `guard-${++guardKeySeq}`;\n        guardKeys.set(route, key);\n    }\n    return key;\n}\n\nfunction toRouteElements(routes: TempestRouteObject[], fallback: ReactNode): ReactNode {\n    return routes.map((route, i) => {\n        let element: ReactNode = route.element;\n        if (route.lazy) {\n            const LazyComponent = resolveLazy(route);\n            element = <LazyComponent />;\n        }\n        if (route.guard !== undefined) {\n            element = (\n                <GuardedElement\n                    key={guardKey(route)}\n                    guard={route.guard}\n                    guardFallback={route.guardFallback ?? fallback}\n                    redirectTo={route.redirectTo}\n                >\n                    {element}\n                </GuardedElement>\n            );\n        }\n\n        if (route.index) {\n            return <Route key={`index-${i}`} index element={element} />;\n        }\n\n        return (\n            <Route\n                key={route.path ?? `route-${i}`}\n                path={route.path}\n                element={element}\n                caseSensitive={route.caseSensitive}\n            >\n                {route.children ? toRouteElements(route.children, fallback) : null}\n            </Route>\n        );\n    });\n}\n\nconst ROUTERS: Record<RouterKind, typeof BrowserRouter> = {\n    browser: BrowserRouter,\n    hash: HashRouter,\n    memory: MemoryRouter,\n};\n\nexport interface AppRouterProps {\n    /** Declarative route tree, ideally built with {@link defineRoutes}. */\n    routes: TempestRouteObject[];\n    /** History strategy (default: `\"browser\"`). */\n    router?: RouterKind;\n    /** App-wide base path forwarded to the underlying router. */\n    basename?: string;\n    /** Initial URLs for the `\"memory\"` router (tests / non-DOM hosts). */\n    initialEntries?: string[];\n    /**\n     * Suspense fallback shown while a `lazy` route chunk loads, and the default\n     * for a route whose `guard` answers `\"pending\"` — one spinner covers both\n     * kinds of \"not ready yet\". A route overrides it with its own\n     * `guardFallback`.\n     */\n    fallback?: ReactNode;\n}\n\n/**\n * Render a full React Router (v7 or v8, declarative mode) from a\n * {@link defineRoutes}\n * tree: picks the history strategy, wraps everything in a `<Suspense>` boundary\n * for `lazy` routes, and applies per-route `guard` redirects. This is the\n * single entry point apps mount at their root.\n *\n * @example\n * <AppRouter routes={routes} fallback={<Spinner />} />\n */\nexport function AppRouter({\n    routes,\n    router = \"browser\",\n    basename,\n    initialEntries,\n    fallback = null,\n}: AppRouterProps) {\n    const tree = useMemo(() => toRouteElements(routes, fallback), [routes, fallback]);\n    const Router = ROUTERS[router];\n    const routerProps = router === \"memory\" ? { basename, initialEntries } : { basename };\n\n    return (\n        <Router {...routerProps}>\n            <Suspense fallback={fallback}>\n                <Routes>{tree}</Routes>\n            </Suspense>\n        </Router>\n    );\n}\n"],"mappings":";;;;;;AAoBA,SAAgB,EAAa,GAAoD;CAC7E,OAAO;AACX;AAEA,IAAM,oBAAY,IAAI,QAAoD;AAE1E,SAAS,EAAY,GAAmD;CACpE,IAAI,IAAO,EAAU,IAAI,CAAK;CAK9B,OAJK,MACD,IAAO,EAAc,EAAM,IAAK,GAChC,EAAU,IAAI,GAAO,CAAI,IAEtB;AACX;AAUA,SAAS,EAAe,EACpB,UACA,kBACA,eACA,eAMD;CACC,IAAM,IAAU,OAAO,KAAU,aAAa,EAAM,IAAI;CACxD,OACI,kBAAC,GAAD;EAAY,MAAM;EAAS,UAAU;EAA2B;EAC3D;CACO,CAAA;AAEpB;AAEA,IAAM,oBAAY,IAAI,QAAoC,GACtD,IAAc;AAclB,SAAS,EAAS,GAAmC;CACjD,IAAI,IAAM,EAAU,IAAI,CAAK;CAK7B,OAJK,MACD,IAAM,SAAS,EAAE,KACjB,EAAU,IAAI,GAAO,CAAG,IAErB;AACX;AAEA,SAAS,EAAgB,GAA8B,GAAgC;CACnF,OAAO,EAAO,KAAK,GAAO,MAAM;EAC5B,IAAI,IAAqB,EAAM;EAC/B,IAAI,EAAM,MAAM;GACZ,IAAM,IAAgB,EAAY,CAAK;GACvC,IAAU,kBAAC,GAAD,CAAgB,CAAA;EAC9B;EAkBA,OAjBI,EAAM,UAAU,KAAA,MAChB,IACI,kBAAC,GAAD;GAEI,OAAO,EAAM;GACb,eAAe,EAAM,iBAAiB;GACtC,YAAY,EAAM;GAEjB,UAAA;EACW,GANP,EAAS,CAAK,CAMP,IAIpB,EAAM,QACC,kBAAC,GAAD;GAA0B,OAAA;GAAe;EAAU,GAAvC,SAAS,GAA8B,IAI1D,kBAAC,GAAD;GAEI,MAAM,EAAM;GACH;GACT,eAAe,EAAM;GAEpB,UAAA,EAAM,WAAW,EAAgB,EAAM,UAAU,CAAQ,IAAI;EAC3D,GANE,EAAM,QAAQ,SAAS,GAMzB;CAEf,CAAC;AACL;AAEA,IAAM,IAAoD;CACtD,SAAS;CACT,MAAM;CACN,QAAQ;AACZ;AA8BA,SAAgB,EAAU,EACtB,WACA,YAAS,WACT,aACA,mBACA,cAAW,QACI;CACf,IAAM,IAAO,QAAc,EAAgB,GAAQ,CAAQ,GAAG,CAAC,GAAQ,CAAQ,CAAC,GAC1E,IAAS,EAAQ;CAGvB,OACI,kBAAC,GAAD;EAAQ,GAHQ,MAAW,WAAW;GAAE;GAAU;EAAe,IAAI,EAAE,YAAS;EAI5E,UAAA,kBAAC,GAAD;GAAoB;GAChB,UAAA,kBAAC,GAAD,EAAA,UAAS,EAAa,CAAA;EAChB,CAAA;CACN,CAAA;AAEhB"}

package/dist/router/RouteGuard.cjs

@@ -1,2 +1,2 @@
-let e=require("react/jsx-runtime"),t=require("react-router");function n({when:n,redirectTo:r=`/`,replace:i=!0,children:a}){return(0,e.jsx)(e.Fragment,{children:n?a:(0,e.jsx)(t.Navigate,{to:r,replace:i})})}exports.RouteGuard=n;
+let e=require("react/jsx-runtime"),t=require("react-router");function n({when:n,fallback:r=null,redirectTo:i=`/`,replace:a=!0,children:o}){return n===`pending`?(0,e.jsx)(e.Fragment,{children:r}):(0,e.jsx)(e.Fragment,{children:n?o:(0,e.jsx)(t.Navigate,{to:i,replace:a})})}exports.RouteGuard=n;
 //# sourceMappingURL=RouteGuard.cjs.map

package/dist/router/RouteGuard.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"RouteGuard.cjs","names":[],"sources":["../../src/router/RouteGuard.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { Navigate } from \"react-router\";\n\nexport interface RouteGuardProps {\n    /**\n     * Whether access is allowed. Pass a boolean or anything truthy/falsy —\n     * typically `useAuthStore((s) => s.isAuthenticated)`.\n     */\n    when: boolean;\n    /** Where to redirect when `when` is falsy (default: `\"/\"`). */\n    redirectTo?: string;\n    /** Replace history entry on redirect instead of pushing (default: true). */\n    replace?: boolean;\n    /** Protected content, usually `<Outlet />` for a guarded layout route. */\n    children: ReactNode;\n}\n\n/**\n * Declarative route guard built on React Router's `<Navigate>`. Renders its\n * children when `when` is truthy, otherwise redirects. Pairs naturally with\n * `createAuthStore` for protected areas.\n *\n * @example\n * <RouteGuard when={useAuthStore((s) => s.isAuthenticated)} redirectTo=\"/login\">\n *     <Outlet />\n * </RouteGuard>\n */\nexport function RouteGuard({ when, redirectTo = \"/\", replace = true, children }: RouteGuardProps) {\n    return <>{when ? children : <Navigate to={redirectTo} replace={replace} />}</>;\n}\n"],"mappings":"6DA2BA,SAAgB,EAAW,CAAE,OAAM,aAAa,IAAK,UAAU,GAAM,YAA6B,CAC9F,OAAO,EAAA,EAAA,IAAA,CAAA,EAAA,SAAA,CAAA,SAAG,EAAO,GAAW,EAAA,EAAA,IAAA,CAAC,EAAA,SAAD,CAAU,GAAI,EAAqB,SAAU,CAAA,CAAI,CAAA,CACjF"}
+{"version":3,"file":"RouteGuard.cjs","names":[],"sources":["../../src/router/RouteGuard.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { Navigate } from \"react-router\";\nimport type { RouteGuardResult } from \"./types\";\n\nexport interface RouteGuardProps {\n    /**\n     * Whether access is allowed — typically\n     * `useAuthStore((s) => s.isAuthenticated)`.\n     *\n     * `\"pending\"` is the third answer, for a permission that has not resolved\n     * yet: it holds the decision and renders {@link fallback} instead of\n     * choosing between two wrong moves — redirecting someone who does have\n     * access, or showing the screen to someone who does not.\n     */\n    when: RouteGuardResult;\n    /**\n     * Rendered while `when` is `\"pending\"`. Defaults to nothing, which is a\n     * blank screen — pass the same spinner the rest of the app uses.\n     */\n    fallback?: ReactNode;\n    /** Where to redirect when `when` is falsy (default: `\"/\"`). */\n    redirectTo?: string;\n    /** Replace history entry on redirect instead of pushing (default: true). */\n    replace?: boolean;\n    /** Protected content, usually `<Outlet />` for a guarded layout route. */\n    children: ReactNode;\n}\n\n/**\n * Declarative route guard built on React Router's `<Navigate>`. Renders its\n * children when `when` is `true`, redirects when it is `false`, and holds on\n * `\"pending\"`. Pairs naturally with `createAuthStore` for protected areas, and\n * with `useCan` for permissions that resolve over the network.\n *\n * @example\n * <RouteGuard when={useAuthStore((s) => s.isAuthenticated)} redirectTo=\"/login\">\n *     <Outlet />\n * </RouteGuard>\n *\n * @example\n * const { allowed, isLoading } = useCan({ action: \"read\", resource: \"finance\" });\n *\n * <RouteGuard when={isLoading ? \"pending\" : allowed} fallback={<Spinner />}>\n *     <Outlet />\n * </RouteGuard>\n */\nexport function RouteGuard({\n    when,\n    fallback = null,\n    redirectTo = \"/\",\n    replace = true,\n    children,\n}: RouteGuardProps) {\n    if (when === \"pending\") return <>{fallback}</>;\n    return <>{when ? children : <Navigate to={redirectTo} replace={replace} />}</>;\n}\n"],"mappings":"6DA8CA,SAAgB,EAAW,CACvB,OACA,WAAW,KACX,aAAa,IACb,UAAU,GACV,YACgB,CAEhB,OADI,IAAS,WAAkB,EAAA,EAAA,IAAA,CAAA,EAAA,SAAA,CAAA,SAAG,CAAW,CAAA,GACtC,EAAA,EAAA,IAAA,CAAA,EAAA,SAAA,CAAA,SAAG,EAAO,GAAW,EAAA,EAAA,IAAA,CAAC,EAAA,SAAD,CAAU,GAAI,EAAqB,SAAU,CAAA,CAAI,CAAA,CACjF"}

package/dist/router/RouteGuard.js

@@ -1,10 +1,10 @@
 import { Fragment as e, jsx as t } from "react/jsx-runtime";
 import { Navigate as n } from "react-router";
 //#region src/router/RouteGuard.tsx
-function r({ when: r, redirectTo: i = "/", replace: a = !0, children: o }) {
-	return /* @__PURE__ */ t(e, { children: r ? o : /* @__PURE__ */ t(n, {
-		to: i,
-		replace: a
+function r({ when: r, fallback: i = null, redirectTo: a = "/", replace: o = !0, children: s }) {
+	return r === "pending" ? /* @__PURE__ */ t(e, { children: i }) : /* @__PURE__ */ t(e, { children: r ? s : /* @__PURE__ */ t(n, {
+		to: a,
+		replace: o
 	}) });
 }
 //#endregion

package/dist/router/RouteGuard.js.map

@@ -1 +1 @@
-{"version":3,"file":"RouteGuard.js","names":[],"sources":["../../src/router/RouteGuard.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { Navigate } from \"react-router\";\n\nexport interface RouteGuardProps {\n    /**\n     * Whether access is allowed. Pass a boolean or anything truthy/falsy —\n     * typically `useAuthStore((s) => s.isAuthenticated)`.\n     */\n    when: boolean;\n    /** Where to redirect when `when` is falsy (default: `\"/\"`). */\n    redirectTo?: string;\n    /** Replace history entry on redirect instead of pushing (default: true). */\n    replace?: boolean;\n    /** Protected content, usually `<Outlet />` for a guarded layout route. */\n    children: ReactNode;\n}\n\n/**\n * Declarative route guard built on React Router's `<Navigate>`. Renders its\n * children when `when` is truthy, otherwise redirects. Pairs naturally with\n * `createAuthStore` for protected areas.\n *\n * @example\n * <RouteGuard when={useAuthStore((s) => s.isAuthenticated)} redirectTo=\"/login\">\n *     <Outlet />\n * </RouteGuard>\n */\nexport function RouteGuard({ when, redirectTo = \"/\", replace = true, children }: RouteGuardProps) {\n    return <>{when ? children : <Navigate to={redirectTo} replace={replace} />}</>;\n}\n"],"mappings":";;;AA2BA,SAAgB,EAAW,EAAE,SAAM,gBAAa,KAAK,aAAU,IAAM,eAA6B;CAC9F,OAAO,kBAAA,GAAA,EAAA,UAAG,IAAO,IAAW,kBAAC,GAAD;EAAU,IAAI;EAAqB;CAAU,CAAA,EAAI,CAAA;AACjF"}
+{"version":3,"file":"RouteGuard.js","names":[],"sources":["../../src/router/RouteGuard.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { Navigate } from \"react-router\";\nimport type { RouteGuardResult } from \"./types\";\n\nexport interface RouteGuardProps {\n    /**\n     * Whether access is allowed — typically\n     * `useAuthStore((s) => s.isAuthenticated)`.\n     *\n     * `\"pending\"` is the third answer, for a permission that has not resolved\n     * yet: it holds the decision and renders {@link fallback} instead of\n     * choosing between two wrong moves — redirecting someone who does have\n     * access, or showing the screen to someone who does not.\n     */\n    when: RouteGuardResult;\n    /**\n     * Rendered while `when` is `\"pending\"`. Defaults to nothing, which is a\n     * blank screen — pass the same spinner the rest of the app uses.\n     */\n    fallback?: ReactNode;\n    /** Where to redirect when `when` is falsy (default: `\"/\"`). */\n    redirectTo?: string;\n    /** Replace history entry on redirect instead of pushing (default: true). */\n    replace?: boolean;\n    /** Protected content, usually `<Outlet />` for a guarded layout route. */\n    children: ReactNode;\n}\n\n/**\n * Declarative route guard built on React Router's `<Navigate>`. Renders its\n * children when `when` is `true`, redirects when it is `false`, and holds on\n * `\"pending\"`. Pairs naturally with `createAuthStore` for protected areas, and\n * with `useCan` for permissions that resolve over the network.\n *\n * @example\n * <RouteGuard when={useAuthStore((s) => s.isAuthenticated)} redirectTo=\"/login\">\n *     <Outlet />\n * </RouteGuard>\n *\n * @example\n * const { allowed, isLoading } = useCan({ action: \"read\", resource: \"finance\" });\n *\n * <RouteGuard when={isLoading ? \"pending\" : allowed} fallback={<Spinner />}>\n *     <Outlet />\n * </RouteGuard>\n */\nexport function RouteGuard({\n    when,\n    fallback = null,\n    redirectTo = \"/\",\n    replace = true,\n    children,\n}: RouteGuardProps) {\n    if (when === \"pending\") return <>{fallback}</>;\n    return <>{when ? children : <Navigate to={redirectTo} replace={replace} />}</>;\n}\n"],"mappings":";;;AA8CA,SAAgB,EAAW,EACvB,SACA,cAAW,MACX,gBAAa,KACb,aAAU,IACV,eACgB;CAEhB,OADI,MAAS,YAAkB,kBAAA,GAAA,EAAA,UAAG,EAAW,CAAA,IACtC,kBAAA,GAAA,EAAA,UAAG,IAAO,IAAW,kBAAC,GAAD;EAAU,IAAI;EAAqB;CAAU,CAAA,EAAI,CAAA;AACjF"}

package/dist/sse/create-event-stream.cjs

@@ -1,2 +1,2 @@
-function e(e){try{return JSON.parse(e)}catch{return e}}function t(t,n={}){let{withCredentials:r=!1,namedEvents:i=[],heartbeatEvents:a=[`ping`],maxRetries:o=10,initialBackoff:s=1e3,maxBackoff:c=3e4,parser:l=e,onOpen:u,onMessage:d,onError:f,onStatusChange:p}=n,m=null,h=null,g=0,_=`idle`,v=!1;function y(e){_!==e&&(_=e,p?.(e))}function b(e,t){a.includes(e)||d?.({event:e,data:l(t.data),id:t.lastEventId||void 0,raw:t})}function x(){if(v)return;if(g>=o){y(`error`);return}let e=Math.min(s*2**g,c);g+=1,h=setTimeout(S,e)}function S(){if(v)return;m&&m.close(),y(`connecting`);let e=new EventSource(t,{withCredentials:r});m=e,e.onopen=()=>{g=0,y(`open`),u?.()},e.onmessage=e=>b(`message`,e);for(let t of i)e.addEventListener(t,e=>b(t,e));for(let t of a)e.addEventListener(t,()=>{});e.onerror=t=>{f?.(t),e.close(),m=null,y(`closed`),x()}}function C(){v=!0,h&&=(clearTimeout(h),null),g=0,m&&=(m.close(),null),y(`closed`)}function w(){h&&=(clearTimeout(h),null),g=0,v=!1,S()}return S(),{close:C,reconnect:w,get status(){return _}}}exports.createEventStream=t;
+const e=require("../utils/json-frame.cjs");function t(t,n={}){let{withCredentials:r=!1,namedEvents:i=[],heartbeatEvents:a=[`ping`],maxRetries:o=10,initialBackoff:s=1e3,maxBackoff:c=3e4,parser:l,onOpen:u,onMessage:d,onError:f,onParseError:p,onStatusChange:m}=n,h=null,g=null,_=0,v=`idle`,y=!1;function b(e){v!==e&&(v=e,m?.(e))}function x(t,n){if(a.includes(t))return;let r=e.decodeFrame(typeof n.data==`string`?n.data:``,l,p,`createEventStream`);r.delivered&&d?.({event:t,data:r.data,id:n.lastEventId||void 0,raw:n})}function S(){if(y)return;if(_>=o){b(`error`);return}let e=Math.min(s*2**_,c);_+=1,g=setTimeout(C,e)}function C(){if(y)return;h&&h.close(),b(`connecting`);let e=new EventSource(t,{withCredentials:r});h=e,e.onopen=()=>{_=0,b(`open`),u?.()},e.onmessage=e=>x(`message`,e);for(let t of i)e.addEventListener(t,e=>x(t,e));for(let t of a)e.addEventListener(t,()=>{});e.onerror=t=>{f?.(t),e.close(),h=null,b(`closed`),S()}}function w(){y=!0,g&&=(clearTimeout(g),null),_=0,h&&=(h.close(),null),b(`closed`)}function T(){g&&=(clearTimeout(g),null),_=0,y=!1,C()}return C(),{close:w,reconnect:T,get status(){return v}}}exports.createEventStream=t;
 //# sourceMappingURL=create-event-stream.cjs.map