tempest-react-sdk 0.47.0 → 0.49.0

package/dist/http/retry.js

@@ -1,5 +1,9 @@
+import { isApiError as e, isRetriableStatus as t } from "./errors.js";
 //#region src/http/retry.ts
-function e(e, t) {
+function n(n) {
+	return !e(n) || t(n.status);
+}
+function r(e, t) {
 	return new Promise((n, r) => {
 		if (t?.aborted) {
 			r(new DOMException("Aborted", "AbortError"));
@@ -11,25 +15,25 @@ function e(e, t) {
 		}, { once: !0 });
 	});
 }
-async function t(t, n = {}) {
-	let { retries: r = 3, initialDelay: i = 300, maxDelay: a = 1e4, respectRetryAfter: o = !0, shouldRetry: s = () => !0, onRetry: c, signal: l } = n, u = 0, d;
-	for (; u < r;) {
-		if (l?.aborted) throw new DOMException("Aborted", "AbortError");
+async function i(e, t = {}) {
+	let { retries: i = 3, initialDelay: a = 300, maxDelay: o = 1e4, respectRetryAfter: s = !0, shouldRetry: c = n, onRetry: l, signal: u } = t, d = 0, f;
+	for (; d < i;) {
+		if (u?.aborted) throw new DOMException("Aborted", "AbortError");
 		try {
-			return await t();
-		} catch (t) {
-			if (d = t, u += 1, u >= r || !s(t, u)) throw t;
-			let n = o && typeof t?.retryAfter == "number" ? t.retryAfter * 1e3 : null, f = Math.min(n === null ? i * 2 ** (u - 1) : n, a);
-			c?.({
-				attempt: u,
-				delay: f,
-				error: t
-			}), await e(f, l);
+			return await e();
+		} catch (e) {
+			if (f = e, d += 1, d >= i || !c(e, d)) throw e;
+			let t = s && typeof e?.retryAfter == "number" ? e.retryAfter * 1e3 : null, n = Math.min(t === null ? a * 2 ** (d - 1) : t, o);
+			l?.({
+				attempt: d,
+				delay: n,
+				error: e
+			}), await r(n, u);
 		}
 	}
-	throw d;
+	throw f;
 }
 //#endregion
-export { t as retry };
+export { i as retry };
 
 //# sourceMappingURL=retry.js.map

package/dist/http/retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.js","names":[],"sources":["../../src/http/retry.ts"],"sourcesContent":["export interface RetryOptions {\n    /** Max attempts (including the first). Default: 3. */\n    retries?: number;\n    /** Initial backoff in ms. Doubles each attempt, capped at `maxDelay`. Default: 300. */\n    initialDelay?: number;\n    /** Maximum delay between attempts. Default: 10_000. */\n    maxDelay?: number;\n    /**\n     * Honor a `Retry-After` hint on the thrown error (`error.retryAfter`, in\n     * seconds — populated by {@link createApiClient} on `429`/`503`). When\n     * present it overrides the exponential backoff for that attempt. The value\n     * is capped at `maxDelay`. Default: true.\n     */\n    respectRetryAfter?: boolean;\n    /**\n     * Return false to stop retrying for a specific error.\n     * Default: retry on any thrown error.\n     */\n    shouldRetry?: (error: unknown, attempt: number) => boolean;\n    /** Called before each retry with the upcoming delay. */\n    onRetry?: (info: { attempt: number; delay: number; error: unknown }) => void;\n    /** Cancel pending retries. */\n    signal?: AbortSignal;\n}\n\nfunction wait(ms: number, signal?: AbortSignal): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n        if (signal?.aborted) {\n            reject(new DOMException(\"Aborted\", \"AbortError\"));\n            return;\n        }\n        const timer = setTimeout(resolve, ms);\n        signal?.addEventListener(\n            \"abort\",\n            () => {\n                clearTimeout(timer);\n                reject(new DOMException(\"Aborted\", \"AbortError\"));\n            },\n            { once: true },\n        );\n    });\n}\n\n/**\n * Run `factory()` with exponential backoff. Each attempt awaits an\n * increasing delay capped at `maxDelay`. Throws the last error if every\n * attempt fails.\n *\n * @example\n * const data = await retry(() => api.get(\"/flaky\"), { retries: 5 });\n */\nexport async function retry<T>(factory: () => Promise<T>, options: RetryOptions = {}): Promise<T> {\n    const {\n        retries = 3,\n        initialDelay = 300,\n        maxDelay = 10_000,\n        respectRetryAfter = true,\n        shouldRetry = () => true,\n        onRetry,\n        signal,\n    } = options;\n\n    let attempt = 0;\n    let lastError: unknown;\n\n    while (attempt < retries) {\n        if (signal?.aborted) throw new DOMException(\"Aborted\", \"AbortError\");\n        try {\n            return await factory();\n        } catch (error) {\n            lastError = error;\n            attempt += 1;\n            if (attempt >= retries || !shouldRetry(error, attempt)) {\n                throw error;\n            }\n            const retryAfter =\n                respectRetryAfter &&\n                typeof (error as { retryAfter?: unknown })?.retryAfter === \"number\"\n                    ? (error as { retryAfter: number }).retryAfter * 1000\n                    : null;\n            const delay =\n                retryAfter !== null\n                    ? Math.min(retryAfter, maxDelay)\n                    : Math.min(initialDelay * 2 ** (attempt - 1), maxDelay);\n            onRetry?.({ attempt, delay, error });\n            await wait(delay, signal);\n        }\n    }\n\n    throw lastError;\n}\n"],"mappings":";AAyBA,SAAS,EAAK,GAAY,GAAqC;CAC3D,OAAO,IAAI,SAAe,GAAS,MAAW;EAC1C,IAAI,GAAQ,SAAS;GACjB,EAAO,IAAI,aAAa,WAAW,YAAY,CAAC;GAChD;EACJ;EACA,IAAM,IAAQ,WAAW,GAAS,CAAE;EACpC,GAAQ,iBACJ,eACM;GAEF,AADA,aAAa,CAAK,GAClB,EAAO,IAAI,aAAa,WAAW,YAAY,CAAC;EACpD,GACA,EAAE,MAAM,GAAK,CACjB;CACJ,CAAC;AACL;AAUA,eAAsB,EAAS,GAA2B,IAAwB,CAAC,GAAe;CAC9F,IAAM,EACF,aAAU,GACV,kBAAe,KACf,cAAW,KACX,uBAAoB,IACpB,uBAAoB,IACpB,YACA,cACA,GAEA,IAAU,GACV;CAEJ,OAAO,IAAU,IAAS;EACtB,IAAI,GAAQ,SAAS,MAAM,IAAI,aAAa,WAAW,YAAY;EACnE,IAAI;GACA,OAAO,MAAM,EAAQ;EACzB,SAAS,GAAO;GAGZ,IAFA,IAAY,GACZ,KAAW,GACP,KAAW,KAAW,CAAC,EAAY,GAAO,CAAO,GACjD,MAAM;GAEV,IAAM,IACF,KACA,OAAQ,GAAoC,cAAe,WACpD,EAAiC,aAAa,MAC/C,MACJ,IAGI,KAAK,IAFX,MAAe,OAEA,IAAe,MAAM,IAAU,KAD/B,GACmC,CAAQ;GAE9D,AADA,IAAU;IAAE;IAAS;IAAO;GAAM,CAAC,GACnC,MAAM,EAAK,GAAO,CAAM;EAC5B;CACJ;CAEA,MAAM;AACV"}
+{"version":3,"file":"retry.js","names":[],"sources":["../../src/http/retry.ts"],"sourcesContent":["import { isApiError, isRetriableStatus } from \"./errors\";\n\nexport interface RetryOptions {\n    /** Max attempts (including the first). Default: 3. */\n    retries?: number;\n    /** Initial backoff in ms. Doubles each attempt, capped at `maxDelay`. Default: 300. */\n    initialDelay?: number;\n    /** Maximum delay between attempts. Default: 10_000. */\n    maxDelay?: number;\n    /**\n     * Honor a `Retry-After` hint on the thrown error (`error.retryAfter`, in\n     * seconds — populated by {@link createApiClient} on `429`/`503`). When\n     * present it overrides the exponential backoff for that attempt. The value\n     * is capped at `maxDelay`. Default: true.\n     */\n    respectRetryAfter?: boolean;\n    /**\n     * Return false to stop retrying for a specific error.\n     *\n     * Default: replay anything that is not a recognisable API error — a\n     * transport failure has no status to judge — and, for one that is, only the\n     * statuses {@link isRetriableStatus} accepts. A `403` on an admin-only\n     * endpoint and a `404` for a deleted record are the server's final answer;\n     * repeating them spends the caller's time to show the same error twice.\n     */\n    shouldRetry?: (error: unknown, attempt: number) => boolean;\n    /** Called before each retry with the upcoming delay. */\n    onRetry?: (info: { attempt: number; delay: number; error: unknown }) => void;\n    /** Cancel pending retries. */\n    signal?: AbortSignal;\n}\n\n/**\n * The default {@link RetryOptions.shouldRetry}.\n *\n * Permissive about what it cannot classify and strict about what it can: an\n * error with no API shape may well be a transport failure, while an API error\n * carrying a deliberate refusal will answer the same on every attempt.\n *\n * @param error - Whatever the attempt threw.\n * @returns Whether the helper should try again.\n */\nfunction defaultShouldRetry(error: unknown): boolean {\n    return !isApiError(error) || isRetriableStatus(error.status);\n}\n\nfunction wait(ms: number, signal?: AbortSignal): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n        if (signal?.aborted) {\n            reject(new DOMException(\"Aborted\", \"AbortError\"));\n            return;\n        }\n        const timer = setTimeout(resolve, ms);\n        signal?.addEventListener(\n            \"abort\",\n            () => {\n                clearTimeout(timer);\n                reject(new DOMException(\"Aborted\", \"AbortError\"));\n            },\n            { once: true },\n        );\n    });\n}\n\n/**\n * Run `factory()` with exponential backoff. Each attempt awaits an\n * increasing delay capped at `maxDelay`. Throws the last error if every\n * attempt fails.\n *\n * @example\n * const data = await retry(() => api.get(\"/flaky\"), { retries: 5 });\n */\nexport async function retry<T>(factory: () => Promise<T>, options: RetryOptions = {}): Promise<T> {\n    const {\n        retries = 3,\n        initialDelay = 300,\n        maxDelay = 10_000,\n        respectRetryAfter = true,\n        shouldRetry = defaultShouldRetry,\n        onRetry,\n        signal,\n    } = options;\n\n    let attempt = 0;\n    let lastError: unknown;\n\n    while (attempt < retries) {\n        if (signal?.aborted) throw new DOMException(\"Aborted\", \"AbortError\");\n        try {\n            return await factory();\n        } catch (error) {\n            lastError = error;\n            attempt += 1;\n            if (attempt >= retries || !shouldRetry(error, attempt)) {\n                throw error;\n            }\n            const retryAfter =\n                respectRetryAfter &&\n                typeof (error as { retryAfter?: unknown })?.retryAfter === \"number\"\n                    ? (error as { retryAfter: number }).retryAfter * 1000\n                    : null;\n            const delay =\n                retryAfter !== null\n                    ? Math.min(retryAfter, maxDelay)\n                    : Math.min(initialDelay * 2 ** (attempt - 1), maxDelay);\n            onRetry?.({ attempt, delay, error });\n            await wait(delay, signal);\n        }\n    }\n\n    throw lastError;\n}\n"],"mappings":";;AA0CA,SAAS,EAAmB,GAAyB;CACjD,OAAO,CAAC,EAAW,CAAK,KAAK,EAAkB,EAAM,MAAM;AAC/D;AAEA,SAAS,EAAK,GAAY,GAAqC;CAC3D,OAAO,IAAI,SAAe,GAAS,MAAW;EAC1C,IAAI,GAAQ,SAAS;GACjB,EAAO,IAAI,aAAa,WAAW,YAAY,CAAC;GAChD;EACJ;EACA,IAAM,IAAQ,WAAW,GAAS,CAAE;EACpC,GAAQ,iBACJ,eACM;GAEF,AADA,aAAa,CAAK,GAClB,EAAO,IAAI,aAAa,WAAW,YAAY,CAAC;EACpD,GACA,EAAE,MAAM,GAAK,CACjB;CACJ,CAAC;AACL;AAUA,eAAsB,EAAS,GAA2B,IAAwB,CAAC,GAAe;CAC9F,IAAM,EACF,aAAU,GACV,kBAAe,KACf,cAAW,KACX,uBAAoB,IACpB,iBAAc,GACd,YACA,cACA,GAEA,IAAU,GACV;CAEJ,OAAO,IAAU,IAAS;EACtB,IAAI,GAAQ,SAAS,MAAM,IAAI,aAAa,WAAW,YAAY;EACnE,IAAI;GACA,OAAO,MAAM,EAAQ;EACzB,SAAS,GAAO;GAGZ,IAFA,IAAY,GACZ,KAAW,GACP,KAAW,KAAW,CAAC,EAAY,GAAO,CAAO,GACjD,MAAM;GAEV,IAAM,IACF,KACA,OAAQ,GAAoC,cAAe,WACpD,EAAiC,aAAa,MAC/C,MACJ,IAGI,KAAK,IAFX,MAAe,OAEA,IAAe,MAAM,IAAU,KAD/B,GACmC,CAAQ;GAE9D,AADA,IAAU;IAAE;IAAS;IAAO;GAAM,CAAC,GACnC,MAAM,EAAK,GAAO,CAAM;EAC5B;CACJ;CAEA,MAAM;AACV"}

package/dist/http/use-describe-api-error.cjs

@@ -1,2 +1,2 @@
-const e=require("./describe-api-error.cjs"),t=require("../i18n/I18nProvider.cjs");let n=require("react");function r(){let r=t.useOptionalI18n()?.t;return(0,n.useCallback)((t,n)=>{let i=r?.(e.API_ERROR_OFFLINE_KEY),a=i&&i!==`tempest.error.offline`?i:e.DEFAULT_API_ERROR_STRINGS.offline;return e.describeApiError(t,n,{offline:a})},[r])}exports.useDescribeApiError=r;
+const e=require("./describe-api-error.cjs"),t=require("../i18n/I18nProvider.cjs");let n=require("react");function r(t,n,r){let i=e.DEFAULT_API_ERROR_STRINGS[r];return t?.(n,void 0,{default:i})??i}function i(){let i=t.useOptionalI18n()?.t;return(0,n.useCallback)((t,n)=>e.describeApiError(t,n,{offline:r(i,e.API_ERROR_OFFLINE_KEY,`offline`),validation:r(i,e.API_ERROR_VALIDATION_KEY,`validation`)}),[i])}exports.useDescribeApiError=i;
 //# sourceMappingURL=use-describe-api-error.cjs.map

package/dist/http/use-describe-api-error.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-describe-api-error.cjs","names":[],"sources":["../../src/http/use-describe-api-error.ts"],"sourcesContent":["import { useCallback } from \"react\";\n\nimport { useOptionalI18n } from \"../i18n/I18nProvider\";\nimport {\n    API_ERROR_OFFLINE_KEY,\n    DEFAULT_API_ERROR_STRINGS,\n    describeApiError,\n} from \"./describe-api-error\";\n\n/**\n * {@link describeApiError} with its fixed sentences resolved through the active\n * `I18nProvider`.\n *\n * The funnel is not duplicated — this hook only supplies the strings and calls\n * the pure function. Which is also why both exist: the pure one runs in an\n * interceptor or a logger, where there is no React tree to read a context from,\n * and this one runs in a component without every caller passing translations\n * down by hand.\n *\n * Works with no provider at all: i18n is opt-in in this SDK, so a missing\n * provider — or a catalog that never defined `tempest.error.offline` — falls\n * back to the pt-BR default rather than crashing or printing the raw key.\n *\n * @example\n * const describe = useDescribeApiError();\n * const { mutate } = useMutation({\n *     mutationFn: save,\n *     onError: (error) => toast(describe(error, t(\"orders.saveFailed\"))),\n * });\n *\n * @returns A stable `(error, fallback) => string` function.\n */\nexport function useDescribeApiError(): (error: unknown, fallback: string) => string {\n    const i18n = useOptionalI18n();\n    const translate = i18n?.t;\n\n    return useCallback(\n        (error: unknown, fallback: string) => {\n            const translated = translate?.(API_ERROR_OFFLINE_KEY);\n            const offline =\n                translated && translated !== API_ERROR_OFFLINE_KEY\n                    ? translated\n                    : DEFAULT_API_ERROR_STRINGS.offline;\n            return describeApiError(error, fallback, { offline });\n        },\n        [translate],\n    );\n}\n"],"mappings":"yGAgCA,SAAgB,GAAoE,CAEhF,IAAM,EADO,EAAA,gBACK,CAAA,EAAM,EAExB,OAAA,EAAO,EAAA,YAAA,EACF,EAAgB,IAAqB,CAClC,IAAM,EAAa,IAAY,EAAA,qBAAqB,EAC9C,EACF,GAAc,IAAA,wBACR,EACA,EAAA,0BAA0B,QACpC,OAAO,EAAA,iBAAiB,EAAO,EAAU,CAAE,SAAQ,CAAC,CACxD,EACA,CAAC,CAAS,CACd,CACJ"}
+{"version":3,"file":"use-describe-api-error.cjs","names":[],"sources":["../../src/http/use-describe-api-error.ts"],"sourcesContent":["import { useCallback } from \"react\";\n\nimport type { I18n } from \"../i18n/create-i18n\";\nimport { useOptionalI18n } from \"../i18n/I18nProvider\";\nimport {\n    API_ERROR_OFFLINE_KEY,\n    API_ERROR_VALIDATION_KEY,\n    DEFAULT_API_ERROR_STRINGS,\n    describeApiError,\n} from \"./describe-api-error\";\n\n/**\n * {@link describeApiError} with its fixed sentences resolved through the active\n * `I18nProvider`.\n *\n * The funnel is not duplicated — this hook only supplies the strings and calls\n * the pure function. Which is also why both exist: the pure one runs in an\n * interceptor or a logger, where there is no React tree to read a context from,\n * and this one runs in a component without every caller passing translations\n * down by hand.\n *\n * Works with no provider at all: i18n is opt-in in this SDK, so a missing\n * provider — or a catalog that never defined `tempest.error.offline` — falls\n * back to the pt-BR default rather than crashing or printing the raw key.\n *\n * @example\n * const describe = useDescribeApiError();\n * const { mutate } = useMutation({\n *     mutationFn: save,\n *     onError: (error) => toast(describe(error, t(\"orders.saveFailed\"))),\n * });\n *\n * @returns A stable `(error, fallback) => string` function.\n */\n/**\n * Look one sentence up in the active catalog, falling back to the pt-BR default.\n *\n * The miss is the i18n layer's answer, through `t`'s `default`. It used to be\n * re-derived here by comparing the result against the key that had just been\n * passed in, which is wrong for a catalog that maps a key to itself —\n * `{ \"tempest.error.offline\": \"tempest.error.offline\" }`, which is what a\n * machine-generated or placeholder catalog produces. There the app's own\n * translation lost to the pt-BR default. Only the catalog's owner can answer\n * \"was this key defined\", and `lookup()` already knows.\n *\n * @param translate - The active catalog's `t`, if any provider is mounted.\n * @param key - The translation key to look up.\n * @param fallbackKey - Which {@link DEFAULT_API_ERROR_STRINGS} entry to use on a miss.\n * @returns The sentence to hand to `describeApiError`.\n */\nfunction resolve(\n    translate: I18n[\"t\"] | undefined,\n    key: string,\n    fallbackKey: keyof typeof DEFAULT_API_ERROR_STRINGS,\n): string {\n    const fallback = DEFAULT_API_ERROR_STRINGS[fallbackKey];\n    return translate?.(key, undefined, { default: fallback }) ?? fallback;\n}\n\nexport function useDescribeApiError(): (error: unknown, fallback: string) => string {\n    const i18n = useOptionalI18n();\n    const translate = i18n?.t;\n\n    return useCallback(\n        (error: unknown, fallback: string) => {\n            return describeApiError(error, fallback, {\n                offline: resolve(translate, API_ERROR_OFFLINE_KEY, \"offline\"),\n                validation: resolve(translate, API_ERROR_VALIDATION_KEY, \"validation\"),\n            });\n        },\n        [translate],\n    );\n}\n"],"mappings":"yGAkDA,SAAS,EACL,EACA,EACA,EACM,CACN,IAAM,EAAW,EAAA,0BAA0B,GAC3C,OAAO,IAAY,EAAK,IAAA,GAAW,CAAE,QAAS,CAAS,CAAC,GAAK,CACjE,CAEA,SAAgB,GAAoE,CAEhF,IAAM,EADO,EAAA,gBACK,CAAA,EAAM,EAExB,OAAA,EAAO,EAAA,YAAA,EACF,EAAgB,IACN,EAAA,iBAAiB,EAAO,EAAU,CACrC,QAAS,EAAQ,EAAW,EAAA,sBAAuB,SAAS,EAC5D,WAAY,EAAQ,EAAW,EAAA,yBAA0B,YAAY,CACzE,CAAC,EAEL,CAAC,CAAS,CACd,CACJ"}

package/dist/http/use-describe-api-error.js

@@ -1,15 +1,19 @@
-import { API_ERROR_OFFLINE_KEY as e, DEFAULT_API_ERROR_STRINGS as t, describeApiError as n } from "./describe-api-error.js";
-import { useOptionalI18n as r } from "../i18n/I18nProvider.js";
-import { useCallback as i } from "react";
+import { API_ERROR_OFFLINE_KEY as e, API_ERROR_VALIDATION_KEY as t, DEFAULT_API_ERROR_STRINGS as n, describeApiError as r } from "./describe-api-error.js";
+import { useOptionalI18n as i } from "../i18n/I18nProvider.js";
+import { useCallback as a } from "react";
 //#region src/http/use-describe-api-error.ts
-function a() {
-	let a = r()?.t;
-	return i((r, i) => {
-		let o = a?.(e), s = o && o !== "tempest.error.offline" ? o : t.offline;
-		return n(r, i, { offline: s });
-	}, [a]);
+function o(e, t, r) {
+	let i = n[r];
+	return e?.(t, void 0, { default: i }) ?? i;
+}
+function s() {
+	let n = i()?.t;
+	return a((i, a) => r(i, a, {
+		offline: o(n, e, "offline"),
+		validation: o(n, t, "validation")
+	}), [n]);
 }
 //#endregion
-export { a as useDescribeApiError };
+export { s as useDescribeApiError };
 
 //# sourceMappingURL=use-describe-api-error.js.map

package/dist/http/use-describe-api-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-describe-api-error.js","names":[],"sources":["../../src/http/use-describe-api-error.ts"],"sourcesContent":["import { useCallback } from \"react\";\n\nimport { useOptionalI18n } from \"../i18n/I18nProvider\";\nimport {\n    API_ERROR_OFFLINE_KEY,\n    DEFAULT_API_ERROR_STRINGS,\n    describeApiError,\n} from \"./describe-api-error\";\n\n/**\n * {@link describeApiError} with its fixed sentences resolved through the active\n * `I18nProvider`.\n *\n * The funnel is not duplicated — this hook only supplies the strings and calls\n * the pure function. Which is also why both exist: the pure one runs in an\n * interceptor or a logger, where there is no React tree to read a context from,\n * and this one runs in a component without every caller passing translations\n * down by hand.\n *\n * Works with no provider at all: i18n is opt-in in this SDK, so a missing\n * provider — or a catalog that never defined `tempest.error.offline` — falls\n * back to the pt-BR default rather than crashing or printing the raw key.\n *\n * @example\n * const describe = useDescribeApiError();\n * const { mutate } = useMutation({\n *     mutationFn: save,\n *     onError: (error) => toast(describe(error, t(\"orders.saveFailed\"))),\n * });\n *\n * @returns A stable `(error, fallback) => string` function.\n */\nexport function useDescribeApiError(): (error: unknown, fallback: string) => string {\n    const i18n = useOptionalI18n();\n    const translate = i18n?.t;\n\n    return useCallback(\n        (error: unknown, fallback: string) => {\n            const translated = translate?.(API_ERROR_OFFLINE_KEY);\n            const offline =\n                translated && translated !== API_ERROR_OFFLINE_KEY\n                    ? translated\n                    : DEFAULT_API_ERROR_STRINGS.offline;\n            return describeApiError(error, fallback, { offline });\n        },\n        [translate],\n    );\n}\n"],"mappings":";;;;AAgCA,SAAgB,IAAoE;CAEhF,IAAM,IADO,EACK,CAAA,EAAM;CAExB,OAAO,GACF,GAAgB,MAAqB;EAClC,IAAM,IAAa,IAAY,CAAqB,GAC9C,IACF,KAAc,MAAA,0BACR,IACA,EAA0B;EACpC,OAAO,EAAiB,GAAO,GAAU,EAAE,WAAQ,CAAC;CACxD,GACA,CAAC,CAAS,CACd;AACJ"}
+{"version":3,"file":"use-describe-api-error.js","names":[],"sources":["../../src/http/use-describe-api-error.ts"],"sourcesContent":["import { useCallback } from \"react\";\n\nimport type { I18n } from \"../i18n/create-i18n\";\nimport { useOptionalI18n } from \"../i18n/I18nProvider\";\nimport {\n    API_ERROR_OFFLINE_KEY,\n    API_ERROR_VALIDATION_KEY,\n    DEFAULT_API_ERROR_STRINGS,\n    describeApiError,\n} from \"./describe-api-error\";\n\n/**\n * {@link describeApiError} with its fixed sentences resolved through the active\n * `I18nProvider`.\n *\n * The funnel is not duplicated — this hook only supplies the strings and calls\n * the pure function. Which is also why both exist: the pure one runs in an\n * interceptor or a logger, where there is no React tree to read a context from,\n * and this one runs in a component without every caller passing translations\n * down by hand.\n *\n * Works with no provider at all: i18n is opt-in in this SDK, so a missing\n * provider — or a catalog that never defined `tempest.error.offline` — falls\n * back to the pt-BR default rather than crashing or printing the raw key.\n *\n * @example\n * const describe = useDescribeApiError();\n * const { mutate } = useMutation({\n *     mutationFn: save,\n *     onError: (error) => toast(describe(error, t(\"orders.saveFailed\"))),\n * });\n *\n * @returns A stable `(error, fallback) => string` function.\n */\n/**\n * Look one sentence up in the active catalog, falling back to the pt-BR default.\n *\n * The miss is the i18n layer's answer, through `t`'s `default`. It used to be\n * re-derived here by comparing the result against the key that had just been\n * passed in, which is wrong for a catalog that maps a key to itself —\n * `{ \"tempest.error.offline\": \"tempest.error.offline\" }`, which is what a\n * machine-generated or placeholder catalog produces. There the app's own\n * translation lost to the pt-BR default. Only the catalog's owner can answer\n * \"was this key defined\", and `lookup()` already knows.\n *\n * @param translate - The active catalog's `t`, if any provider is mounted.\n * @param key - The translation key to look up.\n * @param fallbackKey - Which {@link DEFAULT_API_ERROR_STRINGS} entry to use on a miss.\n * @returns The sentence to hand to `describeApiError`.\n */\nfunction resolve(\n    translate: I18n[\"t\"] | undefined,\n    key: string,\n    fallbackKey: keyof typeof DEFAULT_API_ERROR_STRINGS,\n): string {\n    const fallback = DEFAULT_API_ERROR_STRINGS[fallbackKey];\n    return translate?.(key, undefined, { default: fallback }) ?? fallback;\n}\n\nexport function useDescribeApiError(): (error: unknown, fallback: string) => string {\n    const i18n = useOptionalI18n();\n    const translate = i18n?.t;\n\n    return useCallback(\n        (error: unknown, fallback: string) => {\n            return describeApiError(error, fallback, {\n                offline: resolve(translate, API_ERROR_OFFLINE_KEY, \"offline\"),\n                validation: resolve(translate, API_ERROR_VALIDATION_KEY, \"validation\"),\n            });\n        },\n        [translate],\n    );\n}\n"],"mappings":";;;;AAkDA,SAAS,EACL,GACA,GACA,GACM;CACN,IAAM,IAAW,EAA0B;CAC3C,OAAO,IAAY,GAAK,KAAA,GAAW,EAAE,SAAS,EAAS,CAAC,KAAK;AACjE;AAEA,SAAgB,IAAoE;CAEhF,IAAM,IADO,EACK,CAAA,EAAM;CAExB,OAAO,GACF,GAAgB,MACN,EAAiB,GAAO,GAAU;EACrC,SAAS,EAAQ,GAAW,GAAuB,SAAS;EAC5D,YAAY,EAAQ,GAAW,GAA0B,YAAY;CACzE,CAAC,GAEL,CAAC,CAAS,CACd;AACJ"}

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){let s=t(o,i,a,n);return s===null?n:e(s,r)}function c(n,r,s){let c=t(o,i,a,`${n}${r===1?`_one`:`_other`}`)??t(o,i,a,n);return c===null?n:e(c,{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;
+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;
 //# 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\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 the key itself.\n     */\n    t: (key: string, params?: InterpolationValues) => string;\n    /**\n     * Plural-aware translation. Tries `${key}_one` for `count === 1` and\n     * `${key}_other` otherwise, with `{count}` available for interpolation.\n     */\n    plural: (key: string, count: number, params?: InterpolationValues) => 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 */\nexport function createI18n(options: CreateI18nOptions): I18n {\n    const { locale, fallbackLocale = null, messages } = options;\n\n    function t(key: string, params?: InterpolationValues): string {\n        const template = lookup(messages, locale, fallbackLocale, key);\n        if (template === null) return key;\n        return interpolate(template, params);\n    }\n\n    function plural(key: string, count: number, params?: InterpolationValues): 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        if (template === null) 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":"AAoCA,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,CAyBA,SAAgB,EAAW,EAAkC,CACzD,GAAM,CAAE,SAAQ,iBAAiB,KAAM,YAAa,EAEpD,SAAS,EAAE,EAAa,EAAsC,CAC1D,IAAM,EAAW,EAAO,EAAU,EAAQ,EAAgB,CAAG,EAE7D,OADI,IAAa,KAAa,EACvB,EAAY,EAAU,CAAM,CACvC,CAEA,SAAS,EAAO,EAAa,EAAe,EAAsC,CAE9E,IAAM,EACF,EAAO,EAAU,EAAQ,EAAgB,GAAG,IAFjC,IAAU,EAAI,OAAS,UAEwB,GAC1D,EAAO,EAAU,EAAQ,EAAgB,CAAG,EAEhD,OADI,IAAa,KAAa,EACvB,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":["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"}

package/dist/i18n/create-i18n.js

@@ -16,13 +16,13 @@ function t(e, t, n, r) {
 }
 function n(r) {
 	let { locale: i, fallbackLocale: a = null, messages: o } = r;
-	function s(n, r) {
-		let s = t(o, i, a, n);
-		return s === null ? n : e(s, 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) {
-		let c = t(o, i, a, `${n}${r === 1 ? "_one" : "_other"}`) ?? t(o, i, a, n);
-		return c === null ? n : e(c, {
+	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 ?? {}
 		});

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\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 the key itself.\n     */\n    t: (key: string, params?: InterpolationValues) => string;\n    /**\n     * Plural-aware translation. Tries `${key}_one` for `count === 1` and\n     * `${key}_other` otherwise, with `{count}` available for interpolation.\n     */\n    plural: (key: string, count: number, params?: InterpolationValues) => 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 */\nexport function createI18n(options: CreateI18nOptions): I18n {\n    const { locale, fallbackLocale = null, messages } = options;\n\n    function t(key: string, params?: InterpolationValues): string {\n        const template = lookup(messages, locale, fallbackLocale, key);\n        if (template === null) return key;\n        return interpolate(template, params);\n    }\n\n    function plural(key: string, count: number, params?: InterpolationValues): 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        if (template === null) 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":";AAoCA,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;AAyBA,SAAgB,EAAW,GAAkC;CACzD,IAAM,EAAE,WAAQ,oBAAiB,MAAM,gBAAa;CAEpD,SAAS,EAAE,GAAa,GAAsC;EAC1D,IAAM,IAAW,EAAO,GAAU,GAAQ,GAAgB,CAAG;EAE7D,OADI,MAAa,OAAa,IACvB,EAAY,GAAU,CAAM;CACvC;CAEA,SAAS,EAAO,GAAa,GAAe,GAAsC;EAE9E,IAAM,IACF,EAAO,GAAU,GAAQ,GAAgB,GAAG,IAFjC,MAAU,IAAI,SAAS,UAEwB,KAC1D,EAAO,GAAU,GAAQ,GAAgB,CAAG;EAEhD,OADI,MAAa,OAAa,IACvB,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":["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"}

package/dist/icons/Icon.cjs

@@ -1,2 +1,2 @@
-const e=require("../utils/dev-mode.cjs"),t=require("./icon-context.cjs"),n=require("./shard-cache.cjs"),r=require("./use-icon.cjs");let i=require("react");function a({name:a,size:o,strokeWidth:c,fallback:l=null,...u}){let d=t.useIconContext(),f=r.useIcon(a);return f?(0,i.createElement)(f,{size:o??d?.size,strokeWidth:c??d?.strokeWidth,...u}):(e.isDevBuild()&&n.iconStatus(a)===`missing`&&s(a),l)}var o=new Set;function s(e){o.has(e)||(o.add(e),console.warn(`[tempest-react-sdk] <Icon name="${e}" /> — no such lucide icon. Slugs are kebab-case ("circle-alert", not "CircleAlert"); check against \`iconNames\`.`))}exports.Icon=a;
+const e=require("../utils/dev-mode.cjs"),t=require("./icon-context.cjs"),n=require("./normalize-icon-name.cjs"),r=require("./shard-cache.cjs"),i=require("./use-icon.cjs");let a=require("react");function o({name:o,icon:s,size:l,strokeWidth:u,fallback:d=null,normalize:f=!0,...p}){let m=t.useIconContext(),h=o===void 0?void 0:f?n.normalizeIconName(o):o,g=i.useIcon(h),_=s??g;return _?(0,a.createElement)(_,{size:l??m?.size,strokeWidth:u??m?.strokeWidth,...p}):(e.isDevBuild()&&o!==void 0&&h!==void 0&&r.iconStatus(h)===`missing`&&c(o),d)}var s=new Set;function c(e){s.has(e)||(s.add(e),console.warn(`[tempest-react-sdk] <Icon name="${e}" /> — no such lucide icon. Slugs are kebab-case ("circle-alert", not "CircleAlert"); check against \`iconNames\`.`))}exports.Icon=o;
 //# sourceMappingURL=Icon.cjs.map

package/dist/icons/Icon.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Icon.cjs","names":[],"sources":["../../src/icons/Icon.tsx"],"sourcesContent":["import { createElement, type ReactNode, type SVGProps } from \"react\";\n\nimport type { IconName } from \"./generated/icon-name\";\nimport { useIconContext } from \"./icon-context\";\nimport { iconStatus } from \"./shard-cache\";\nimport { useIcon } from \"./use-icon\";\nimport { isDevBuild } from \"../utils\";\n\nexport interface IconProps extends Omit<SVGProps<SVGSVGElement>, \"ref\"> {\n    /**\n     * The lucide slug, kebab-case: `\"save\"`, `\"trash-2\"`, `\"circle-alert\"`.\n     *\n     * Typed as the union of every slug lucide ships, so a typo is a compile\n     * error — while still accepting a plain `string` for the case this component\n     * exists for: a name that arrives from an API, a CMS or a config table.\n     */\n    name: IconName | (string & {});\n    /** Width and height in px. Defaults to the provider's value, then lucide's `24`. */\n    size?: number | string;\n    /** Stroke width. Defaults to the provider's value, then lucide's `2`. */\n    strokeWidth?: number;\n    /**\n     * Rendered while the icon's shard is in flight, and for a slug that does not\n     * exist at all. Defaults to nothing.\n     *\n     * Pass a same-sized placeholder when the surrounding layout would otherwise\n     * shift. Note that a slug already in the registry or the cache never renders\n     * this — it resolves during render.\n     */\n    fallback?: ReactNode;\n}\n\n/**\n * Render a lucide icon by slug.\n *\n * All ~2000 lucide icons are addressable, without the cost that makes\n * `lucide-react`'s own `DynamicIcon` unusable: its icon map holds a dynamic\n * `import()` per icon, so a bundler has to emit ~2000 chunk boundaries and the\n * browser floods with requests. Here a slug the app wrote as a literal is\n * resolved from a static registry, and a slug only known at runtime pulls a\n * single shard covering every icon sharing its initial letter.\n *\n * An unknown slug renders `fallback` (nothing, by default) and warns in dev only\n * — it never throws, because a bad name from an API must not take down the tree.\n *\n * @example\n * <Icon name=\"save\" size={18} />\n * <Icon name={row.iconSlug} fallback={<span className=\"skeleton\" />} />\n */\nexport function Icon({ name, size, strokeWidth, fallback = null, ...rest }: IconProps): ReactNode {\n    const context = useIconContext();\n    const resolved = useIcon(name);\n\n    if (!resolved) {\n        if (isDevBuild() && iconStatus(name) === \"missing\") warnUnknownIcon(name);\n        return fallback;\n    }\n\n    return createElement(resolved, {\n        size: size ?? context?.size,\n        strokeWidth: strokeWidth ?? context?.strokeWidth,\n        ...rest,\n    });\n}\n\nconst warnedSlugs = new Set<string>();\n\n/**\n * Warn once per unknown slug.\n *\n * Once, because `<Icon>` re-renders and a warning per render would bury the\n * console; the set is never cleared, since a slug that does not exist will not\n * start existing within the life of the page.\n *\n * @param name - The slug that resolved to nothing.\n */\nfunction warnUnknownIcon(name: string): void {\n    if (warnedSlugs.has(name)) return;\n    warnedSlugs.add(name);\n    console.warn(\n        `[tempest-react-sdk] <Icon name=\"${name}\" /> — no such lucide icon. ` +\n            `Slugs are kebab-case (\"circle-alert\", not \"CircleAlert\"); check against \\`iconNames\\`.`,\n    );\n}\n"],"mappings":"2JAiDA,SAAgB,EAAK,CAAE,OAAM,OAAM,cAAa,WAAW,KAAM,GAAG,GAA8B,CAC9F,IAAM,EAAU,EAAA,eAAe,EACzB,EAAW,EAAA,QAAQ,CAAI,EAO7B,OALK,GAKL,EAAO,EAAA,cAAA,CAAc,EAAU,CAC3B,KAAM,GAAQ,GAAS,KACvB,YAAa,GAAe,GAAS,YACrC,GAAG,CACP,CAAC,GARO,EAAA,WAAW,GAAK,EAAA,WAAW,CAAI,IAAM,WAAW,EAAgB,CAAI,EACjE,EAQf,CAEA,IAAM,EAAc,IAAI,IAWxB,SAAS,EAAgB,EAAoB,CACrC,EAAY,IAAI,CAAI,IACxB,EAAY,IAAI,CAAI,EACpB,QAAQ,KACJ,mCAAmC,EAAK,mHAE5C,EACJ"}
+{"version":3,"file":"Icon.cjs","names":[],"sources":["../../src/icons/Icon.tsx"],"sourcesContent":["import { createElement, type ReactNode, type SVGProps } from \"react\";\nimport type { LucideIcon } from \"lucide-react\";\n\nimport type { IconName } from \"./generated/icon-name\";\nimport { useIconContext } from \"./icon-context\";\nimport { normalizeIconName } from \"./normalize-icon-name\";\nimport { iconStatus } from \"./shard-cache\";\nimport { useIcon } from \"./use-icon\";\nimport { isDevBuild } from \"../utils/dev-mode\";\n\ninterface IconBaseProps extends Omit<SVGProps<SVGSVGElement>, \"ref\" | \"name\"> {\n    /** Width and height in px. Defaults to the provider's value, then lucide's `24`. */\n    size?: number | string;\n    /** Stroke width. Defaults to the provider's value, then lucide's `2`. */\n    strokeWidth?: number;\n    /**\n     * Rendered while the icon's shard is in flight, and for a slug that does not\n     * exist at all. Defaults to nothing.\n     *\n     * Pass a same-sized placeholder when the surrounding layout would otherwise\n     * shift. Note that a slug already in the registry or the cache never renders\n     * this — it resolves during render.\n     */\n    fallback?: ReactNode;\n    /**\n     * Clean up `name` before looking it up. Default `true`.\n     *\n     * A stored `icon_code` arrives dirty — `shopping_cart`, `\" Save\"`, a slug\n     * lucide deprecated two releases ago — and normalizing is what makes those\n     * render instead of falling back. `false` asks for a strict lookup, for the\n     * case where you want an unexpected spelling to be visible rather than\n     * quietly repaired.\n     *\n     * Ignored when the icon is passed as a component.\n     */\n    normalize?: boolean;\n}\n\n/**\n * Address the icon by slug — the reason this component exists.\n *\n * The slug is typed as the union of every name lucide ships, so a typo is a\n * compile error, while still accepting a plain `string` for the case that\n * motivates the whole module: a name arriving from an API, a CMS or a config\n * table.\n */\ninterface IconByNameProps extends IconBaseProps {\n    name: IconName | (string & {});\n    icon?: never;\n}\n\n/**\n * Address the icon by component, for a call site that already imported it.\n *\n * No lookup, no registry, no shard: the component is rendered as passed. It is\n * there so a screen mixing literal icons with data-driven ones can keep using one\n * component instead of alternating between `<Icon name>` and `<Wrench />`, which\n * is what makes the shared `size`/`strokeWidth` defaults apply to both.\n */\ninterface IconByComponentProps extends IconBaseProps {\n    icon: LucideIcon;\n    name?: never;\n}\n\nexport type IconProps = IconByNameProps | IconByComponentProps;\n\n/**\n * Render a lucide icon by slug.\n *\n * All ~2000 lucide icons are addressable, without the cost that makes\n * `lucide-react`'s own `DynamicIcon` unusable: its icon map holds a dynamic\n * `import()` per icon, so a bundler has to emit ~2000 chunk boundaries and the\n * browser floods with requests. Here a slug the app wrote as a literal is\n * resolved from a static registry, and a slug only known at runtime pulls a\n * single shard covering every icon sharing its initial letter.\n *\n * An unknown slug renders `fallback` (nothing, by default) and warns in dev only\n * — it never throws, because a bad name from an API must not take down the tree.\n *\n * `name` is normalized before the lookup, so a stored `icon_code` renders whether\n * it was written `shopping_cart`, `\" Save\"` or under a slug lucide has since\n * deprecated. Pass `normalize={false}` for a strict lookup.\n *\n * @example\n * <Icon name=\"save\" size={18} />\n * <Icon name={row.iconSlug} fallback={<span className=\"skeleton\" />} />\n * <Icon icon={Wrench} size={18} />\n */\nexport function Icon({\n    name,\n    icon,\n    size,\n    strokeWidth,\n    fallback = null,\n    normalize = true,\n    ...rest\n}: IconProps): ReactNode {\n    const context = useIconContext();\n    const slug = name === undefined ? undefined : normalize ? normalizeIconName(name) : name;\n    const fromSlug = useIcon(slug);\n    const resolved = icon ?? fromSlug;\n\n    if (!resolved) {\n        if (isDevBuild() && name !== undefined && slug !== undefined) {\n            if (iconStatus(slug) === \"missing\") warnUnknownIcon(name);\n        }\n        return fallback;\n    }\n\n    return createElement(resolved, {\n        size: size ?? context?.size,\n        strokeWidth: strokeWidth ?? context?.strokeWidth,\n        ...rest,\n    });\n}\n\nconst warnedSlugs = new Set<string>();\n\n/**\n * Warn once per unknown slug.\n *\n * Once, because `<Icon>` re-renders and a warning per render would bury the\n * console; the set is never cleared, since a slug that does not exist will not\n * start existing within the life of the page.\n *\n * Reports the name **as written**, not the normalized slug: the reader is the\n * developer who typed it, and `\"CircleAlert\"` is a far more useful thing to see in\n * the console than the `\"circlealert\"` it normalizes to.\n *\n * @param name - The slug that resolved to nothing, as passed.\n */\nfunction warnUnknownIcon(name: string): void {\n    if (warnedSlugs.has(name)) return;\n    warnedSlugs.add(name);\n    console.warn(\n        `[tempest-react-sdk] <Icon name=\"${name}\" /> — no such lucide icon. ` +\n            `Slugs are kebab-case (\"circle-alert\", not \"CircleAlert\"); check against \\`iconNames\\`.`,\n    );\n}\n"],"mappings":"kMAwFA,SAAgB,EAAK,CACjB,OACA,OACA,OACA,cACA,WAAW,KACX,YAAY,GACZ,GAAG,GACkB,CACrB,IAAM,EAAU,EAAA,eAAe,EACzB,EAAO,IAAS,IAAA,GAAY,IAAA,GAAY,EAAY,EAAA,kBAAkB,CAAI,EAAI,EAC9E,EAAW,EAAA,QAAQ,CAAI,EACvB,EAAW,GAAQ,EASzB,OAPK,GAOL,EAAO,EAAA,cAAA,CAAc,EAAU,CAC3B,KAAM,GAAQ,GAAS,KACvB,YAAa,GAAe,GAAS,YACrC,GAAG,CACP,CAAC,GAVO,EAAA,WAAW,GAAK,IAAS,IAAA,IAAa,IAAS,IAAA,IAC3C,EAAA,WAAW,CAAI,IAAM,WAAW,EAAgB,CAAI,EAErD,EAQf,CAEA,IAAM,EAAc,IAAI,IAexB,SAAS,EAAgB,EAAoB,CACrC,EAAY,IAAI,CAAI,IACxB,EAAY,IAAI,CAAI,EACpB,QAAQ,KACJ,mCAAmC,EAAK,mHAE5C,EACJ"}

package/dist/icons/Icon.js

@@ -1,22 +1,23 @@
 import { isDevBuild as e } from "../utils/dev-mode.js";
 import { useIconContext as t } from "./icon-context.js";
-import { iconStatus as n } from "./shard-cache.js";
-import { useIcon as r } from "./use-icon.js";
-import { createElement as i } from "react";
+import { normalizeIconName as n } from "./normalize-icon-name.js";
+import { iconStatus as r } from "./shard-cache.js";
+import { useIcon as i } from "./use-icon.js";
+import { createElement as a } from "react";
 //#region src/icons/Icon.tsx
-function a({ name: a, size: o, strokeWidth: c, fallback: l = null, ...u }) {
-	let d = t(), f = r(a);
-	return f ? i(f, {
-		size: o ?? d?.size,
-		strokeWidth: c ?? d?.strokeWidth,
-		...u
-	}) : (e() && n(a) === "missing" && s(a), l);
+function o({ name: o, icon: s, size: l, strokeWidth: u, fallback: d = null, normalize: f = !0, ...p }) {
+	let m = t(), h = o === void 0 ? void 0 : f ? n(o) : o, g = i(h), _ = s ?? g;
+	return _ ? a(_, {
+		size: l ?? m?.size,
+		strokeWidth: u ?? m?.strokeWidth,
+		...p
+	}) : (e() && o !== void 0 && h !== void 0 && r(h) === "missing" && c(o), d);
 }
-var o = /* @__PURE__ */ new Set();
-function s(e) {
-	o.has(e) || (o.add(e), console.warn(`[tempest-react-sdk] <Icon name="${e}" /> — no such lucide icon. Slugs are kebab-case ("circle-alert", not "CircleAlert"); check against \`iconNames\`.`));
+var s = /* @__PURE__ */ new Set();
+function c(e) {
+	s.has(e) || (s.add(e), console.warn(`[tempest-react-sdk] <Icon name="${e}" /> — no such lucide icon. Slugs are kebab-case ("circle-alert", not "CircleAlert"); check against \`iconNames\`.`));
 }
 //#endregion
-export { a as Icon };
+export { o as Icon };
 
 //# sourceMappingURL=Icon.js.map

package/dist/icons/Icon.js.map

@@ -1 +1 @@
-{"version":3,"file":"Icon.js","names":[],"sources":["../../src/icons/Icon.tsx"],"sourcesContent":["import { createElement, type ReactNode, type SVGProps } from \"react\";\n\nimport type { IconName } from \"./generated/icon-name\";\nimport { useIconContext } from \"./icon-context\";\nimport { iconStatus } from \"./shard-cache\";\nimport { useIcon } from \"./use-icon\";\nimport { isDevBuild } from \"../utils\";\n\nexport interface IconProps extends Omit<SVGProps<SVGSVGElement>, \"ref\"> {\n    /**\n     * The lucide slug, kebab-case: `\"save\"`, `\"trash-2\"`, `\"circle-alert\"`.\n     *\n     * Typed as the union of every slug lucide ships, so a typo is a compile\n     * error — while still accepting a plain `string` for the case this component\n     * exists for: a name that arrives from an API, a CMS or a config table.\n     */\n    name: IconName | (string & {});\n    /** Width and height in px. Defaults to the provider's value, then lucide's `24`. */\n    size?: number | string;\n    /** Stroke width. Defaults to the provider's value, then lucide's `2`. */\n    strokeWidth?: number;\n    /**\n     * Rendered while the icon's shard is in flight, and for a slug that does not\n     * exist at all. Defaults to nothing.\n     *\n     * Pass a same-sized placeholder when the surrounding layout would otherwise\n     * shift. Note that a slug already in the registry or the cache never renders\n     * this — it resolves during render.\n     */\n    fallback?: ReactNode;\n}\n\n/**\n * Render a lucide icon by slug.\n *\n * All ~2000 lucide icons are addressable, without the cost that makes\n * `lucide-react`'s own `DynamicIcon` unusable: its icon map holds a dynamic\n * `import()` per icon, so a bundler has to emit ~2000 chunk boundaries and the\n * browser floods with requests. Here a slug the app wrote as a literal is\n * resolved from a static registry, and a slug only known at runtime pulls a\n * single shard covering every icon sharing its initial letter.\n *\n * An unknown slug renders `fallback` (nothing, by default) and warns in dev only\n * — it never throws, because a bad name from an API must not take down the tree.\n *\n * @example\n * <Icon name=\"save\" size={18} />\n * <Icon name={row.iconSlug} fallback={<span className=\"skeleton\" />} />\n */\nexport function Icon({ name, size, strokeWidth, fallback = null, ...rest }: IconProps): ReactNode {\n    const context = useIconContext();\n    const resolved = useIcon(name);\n\n    if (!resolved) {\n        if (isDevBuild() && iconStatus(name) === \"missing\") warnUnknownIcon(name);\n        return fallback;\n    }\n\n    return createElement(resolved, {\n        size: size ?? context?.size,\n        strokeWidth: strokeWidth ?? context?.strokeWidth,\n        ...rest,\n    });\n}\n\nconst warnedSlugs = new Set<string>();\n\n/**\n * Warn once per unknown slug.\n *\n * Once, because `<Icon>` re-renders and a warning per render would bury the\n * console; the set is never cleared, since a slug that does not exist will not\n * start existing within the life of the page.\n *\n * @param name - The slug that resolved to nothing.\n */\nfunction warnUnknownIcon(name: string): void {\n    if (warnedSlugs.has(name)) return;\n    warnedSlugs.add(name);\n    console.warn(\n        `[tempest-react-sdk] <Icon name=\"${name}\" /> — no such lucide icon. ` +\n            `Slugs are kebab-case (\"circle-alert\", not \"CircleAlert\"); check against \\`iconNames\\`.`,\n    );\n}\n"],"mappings":";;;;;;AAiDA,SAAgB,EAAK,EAAE,SAAM,SAAM,gBAAa,cAAW,MAAM,GAAG,KAA8B;CAC9F,IAAM,IAAU,EAAe,GACzB,IAAW,EAAQ,CAAI;CAO7B,OALK,IAKE,EAAc,GAAU;EAC3B,MAAM,KAAQ,GAAS;EACvB,aAAa,KAAe,GAAS;EACrC,GAAG;CACP,CAAC,KARO,EAAW,KAAK,EAAW,CAAI,MAAM,aAAW,EAAgB,CAAI,GACjE;AAQf;AAEA,IAAM,oBAAc,IAAI,IAAY;AAWpC,SAAS,EAAgB,GAAoB;CACrC,EAAY,IAAI,CAAI,MACxB,EAAY,IAAI,CAAI,GACpB,QAAQ,KACJ,mCAAmC,EAAK,mHAE5C;AACJ"}
+{"version":3,"file":"Icon.js","names":[],"sources":["../../src/icons/Icon.tsx"],"sourcesContent":["import { createElement, type ReactNode, type SVGProps } from \"react\";\nimport type { LucideIcon } from \"lucide-react\";\n\nimport type { IconName } from \"./generated/icon-name\";\nimport { useIconContext } from \"./icon-context\";\nimport { normalizeIconName } from \"./normalize-icon-name\";\nimport { iconStatus } from \"./shard-cache\";\nimport { useIcon } from \"./use-icon\";\nimport { isDevBuild } from \"../utils/dev-mode\";\n\ninterface IconBaseProps extends Omit<SVGProps<SVGSVGElement>, \"ref\" | \"name\"> {\n    /** Width and height in px. Defaults to the provider's value, then lucide's `24`. */\n    size?: number | string;\n    /** Stroke width. Defaults to the provider's value, then lucide's `2`. */\n    strokeWidth?: number;\n    /**\n     * Rendered while the icon's shard is in flight, and for a slug that does not\n     * exist at all. Defaults to nothing.\n     *\n     * Pass a same-sized placeholder when the surrounding layout would otherwise\n     * shift. Note that a slug already in the registry or the cache never renders\n     * this — it resolves during render.\n     */\n    fallback?: ReactNode;\n    /**\n     * Clean up `name` before looking it up. Default `true`.\n     *\n     * A stored `icon_code` arrives dirty — `shopping_cart`, `\" Save\"`, a slug\n     * lucide deprecated two releases ago — and normalizing is what makes those\n     * render instead of falling back. `false` asks for a strict lookup, for the\n     * case where you want an unexpected spelling to be visible rather than\n     * quietly repaired.\n     *\n     * Ignored when the icon is passed as a component.\n     */\n    normalize?: boolean;\n}\n\n/**\n * Address the icon by slug — the reason this component exists.\n *\n * The slug is typed as the union of every name lucide ships, so a typo is a\n * compile error, while still accepting a plain `string` for the case that\n * motivates the whole module: a name arriving from an API, a CMS or a config\n * table.\n */\ninterface IconByNameProps extends IconBaseProps {\n    name: IconName | (string & {});\n    icon?: never;\n}\n\n/**\n * Address the icon by component, for a call site that already imported it.\n *\n * No lookup, no registry, no shard: the component is rendered as passed. It is\n * there so a screen mixing literal icons with data-driven ones can keep using one\n * component instead of alternating between `<Icon name>` and `<Wrench />`, which\n * is what makes the shared `size`/`strokeWidth` defaults apply to both.\n */\ninterface IconByComponentProps extends IconBaseProps {\n    icon: LucideIcon;\n    name?: never;\n}\n\nexport type IconProps = IconByNameProps | IconByComponentProps;\n\n/**\n * Render a lucide icon by slug.\n *\n * All ~2000 lucide icons are addressable, without the cost that makes\n * `lucide-react`'s own `DynamicIcon` unusable: its icon map holds a dynamic\n * `import()` per icon, so a bundler has to emit ~2000 chunk boundaries and the\n * browser floods with requests. Here a slug the app wrote as a literal is\n * resolved from a static registry, and a slug only known at runtime pulls a\n * single shard covering every icon sharing its initial letter.\n *\n * An unknown slug renders `fallback` (nothing, by default) and warns in dev only\n * — it never throws, because a bad name from an API must not take down the tree.\n *\n * `name` is normalized before the lookup, so a stored `icon_code` renders whether\n * it was written `shopping_cart`, `\" Save\"` or under a slug lucide has since\n * deprecated. Pass `normalize={false}` for a strict lookup.\n *\n * @example\n * <Icon name=\"save\" size={18} />\n * <Icon name={row.iconSlug} fallback={<span className=\"skeleton\" />} />\n * <Icon icon={Wrench} size={18} />\n */\nexport function Icon({\n    name,\n    icon,\n    size,\n    strokeWidth,\n    fallback = null,\n    normalize = true,\n    ...rest\n}: IconProps): ReactNode {\n    const context = useIconContext();\n    const slug = name === undefined ? undefined : normalize ? normalizeIconName(name) : name;\n    const fromSlug = useIcon(slug);\n    const resolved = icon ?? fromSlug;\n\n    if (!resolved) {\n        if (isDevBuild() && name !== undefined && slug !== undefined) {\n            if (iconStatus(slug) === \"missing\") warnUnknownIcon(name);\n        }\n        return fallback;\n    }\n\n    return createElement(resolved, {\n        size: size ?? context?.size,\n        strokeWidth: strokeWidth ?? context?.strokeWidth,\n        ...rest,\n    });\n}\n\nconst warnedSlugs = new Set<string>();\n\n/**\n * Warn once per unknown slug.\n *\n * Once, because `<Icon>` re-renders and a warning per render would bury the\n * console; the set is never cleared, since a slug that does not exist will not\n * start existing within the life of the page.\n *\n * Reports the name **as written**, not the normalized slug: the reader is the\n * developer who typed it, and `\"CircleAlert\"` is a far more useful thing to see in\n * the console than the `\"circlealert\"` it normalizes to.\n *\n * @param name - The slug that resolved to nothing, as passed.\n */\nfunction warnUnknownIcon(name: string): void {\n    if (warnedSlugs.has(name)) return;\n    warnedSlugs.add(name);\n    console.warn(\n        `[tempest-react-sdk] <Icon name=\"${name}\" /> — no such lucide icon. ` +\n            `Slugs are kebab-case (\"circle-alert\", not \"CircleAlert\"); check against \\`iconNames\\`.`,\n    );\n}\n"],"mappings":";;;;;;;AAwFA,SAAgB,EAAK,EACjB,SACA,SACA,SACA,gBACA,cAAW,MACX,eAAY,IACZ,GAAG,KACkB;CACrB,IAAM,IAAU,EAAe,GACzB,IAAO,MAAS,KAAA,IAAY,KAAA,IAAY,IAAY,EAAkB,CAAI,IAAI,GAC9E,IAAW,EAAQ,CAAI,GACvB,IAAW,KAAQ;CASzB,OAPK,IAOE,EAAc,GAAU;EAC3B,MAAM,KAAQ,GAAS;EACvB,aAAa,KAAe,GAAS;EACrC,GAAG;CACP,CAAC,KAVO,EAAW,KAAK,MAAS,KAAA,KAAa,MAAS,KAAA,KAC3C,EAAW,CAAI,MAAM,aAAW,EAAgB,CAAI,GAErD;AAQf;AAEA,IAAM,oBAAc,IAAI,IAAY;AAepC,SAAS,EAAgB,GAAoB;CACrC,EAAY,IAAI,CAAI,MACxB,EAAY,IAAI,CAAI,GACpB,QAAQ,KACJ,mCAAmC,EAAK,mHAE5C;AACJ"}

package/dist/icons/IconPicker.cjs

@@ -0,0 +1,2 @@
+const e=require("../utils/cn.cjs"),t=require("./generated/icon-names.cjs"),n=require("./normalize-icon-name.cjs"),r=require("./Icon.cjs"),i=require("./validate-icon-name.cjs"),a=require("./IconPicker.module.cjs");let o=require("react"),s=require("react/jsx-runtime");function c({value:c,onChange:l,limit:u=40,previewSize:d=20,invalidMessage:f,emptyPreview:p=null,className:m,...h}){let g=(0,o.useId)(),_=(0,o.useRef)(null),v=i.validateIconName(c,f),y=(0,o.useMemo)(()=>{let e=n.normalizeIconName(c);return(e===``?t.iconNames:t.iconNames.filter(t=>t.includes(e))).slice(0,u)},[c,u]);return(0,o.useEffect)(()=>{_.current?.setCustomValidity(v??``)},[v]),(0,s.jsxs)(`span`,{className:e.cn(a.default.picker,m),children:[(0,s.jsx)(`span`,{className:a.default.preview,"aria-hidden":`true`,children:v===void 0&&c.trim()!==``?(0,s.jsx)(r.Icon,{name:c,size:d,fallback:p}):p}),(0,s.jsx)(`input`,{...h,ref:_,type:`text`,className:a.default.input,list:g,value:c,"aria-invalid":v!==void 0||void 0,onChange:e=>l(n.normalizeIconName(e.target.value))}),(0,s.jsx)(`datalist`,{id:g,children:y.map(e=>(0,s.jsx)(`option`,{value:e},e))})]})}exports.IconPicker=c;
+//# sourceMappingURL=IconPicker.cjs.map

package/dist/icons/IconPicker.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconPicker.cjs","names":[],"sources":["../../src/icons/IconPicker.tsx"],"sourcesContent":["import { useEffect, useId, useMemo, useRef, type InputHTMLAttributes, type ReactNode } from \"react\";\n\nimport { cn } from \"../utils/cn\";\nimport { iconNames } from \"./generated/icon-names\";\nimport { Icon } from \"./Icon\";\nimport { normalizeIconName } from \"./normalize-icon-name\";\nimport { validateIconName } from \"./validate-icon-name\";\nimport styles from \"./IconPicker.module.css\";\n\n/**\n * @tempest-limits props-count — value/onChange are the field, limit/placeholder\n * the suggestion list, and previewSize/invalidMessage the two things a form\n * around it needs to restyle or translate.\n */\nexport interface IconPickerProps extends Omit<\n    InputHTMLAttributes<HTMLInputElement>,\n    \"value\" | \"onChange\" | \"list\" | \"type\"\n> {\n    /** The chosen slug. Always canonical — see `onChange`. */\n    value: string;\n    /**\n     * Fires with the **canonical** slug on every keystroke.\n     *\n     * Legacy spellings are normalized on the way out (`Shopping_Cart` →\n     * `shopping-cart`, `alert-circle` → `circle-alert`), so what a form stores is\n     * what `<Icon>` resolves without further cleanup.\n     */\n    onChange: (slug: string) => void;\n    /**\n     * How many suggestions to render. Default `40`.\n     *\n     * There are 2024 slugs, and building every one as an `<option>` on each\n     * keystroke freezes the datalist — which is the reason this prop exists rather\n     * than a \"show everything\" default.\n     */\n    limit?: number;\n    /** Size of the preview glyph, in px. Default `20`. */\n    previewSize?: number;\n    /** Overrides the message shown for a slug that does not exist. */\n    invalidMessage?: string;\n    /** Rendered in the preview box while nothing valid is chosen. */\n    emptyPreview?: ReactNode;\n}\n\n/**\n * An icon field: native autocomplete over every lucide slug, plus a preview.\n *\n * Every panel that lets someone choose an icon was rewriting this — filter the\n * list, cap the suggestions, build the `<datalist>`, and block submit when the\n * typed name does not exist. That last step is the one that matters: without it\n * an invalid value reaches the database and only shows up later as a missing icon\n * on every screen that renders the record.\n *\n * Validation is wired to the **native** form: the input carries a custom validity\n * message, so a plain `<form>` refuses to submit and the browser points at the\n * field. `validateIconName` is exported for react-hook-form and zod.\n *\n * Built on `<datalist>` rather than a custom listbox on purpose: keyboard,\n * screen-reader and mobile behaviour come from the platform, and the component\n * stays small enough that its cost is the slug list it has to import — ~7 KB\n * brotli, which only a picker pays.\n *\n * @example\n * const [icon, setIcon] = useState(\"\");\n *\n * <form onSubmit={save}>\n *     <IconPicker value={icon} onChange={setIcon} required />\n *     <button type=\"submit\">Salvar</button>\n * </form>\n */\nexport function IconPicker({\n    value,\n    onChange,\n    limit = 40,\n    previewSize = 20,\n    invalidMessage,\n    emptyPreview = null,\n    className,\n    ...rest\n}: IconPickerProps): ReactNode {\n    const listId = useId();\n    const input = useRef<HTMLInputElement>(null);\n    const error = validateIconName(value, invalidMessage);\n\n    const suggestions = useMemo(() => {\n        const query = normalizeIconName(value);\n        const matches = query === \"\" ? iconNames : iconNames.filter((name) => name.includes(query));\n        return matches.slice(0, limit);\n    }, [value, limit]);\n\n    useEffect(() => {\n        input.current?.setCustomValidity(error ?? \"\");\n    }, [error]);\n\n    return (\n        <span className={cn(styles.picker, className)}>\n            <span className={styles.preview} aria-hidden=\"true\">\n                {error === undefined && value.trim() !== \"\" ? (\n                    <Icon name={value} size={previewSize} fallback={emptyPreview} />\n                ) : (\n                    emptyPreview\n                )}\n            </span>\n            <input\n                {...rest}\n                ref={input}\n                type=\"text\"\n                className={styles.input}\n                list={listId}\n                value={value}\n                aria-invalid={error !== undefined || undefined}\n                onChange={(event) => onChange(normalizeIconName(event.target.value))}\n            />\n            <datalist id={listId}>\n                {suggestions.map((name) => (\n                    <option key={name} value={name} />\n                ))}\n            </datalist>\n        </span>\n    );\n}\n"],"mappings":"2QAsEA,SAAgB,EAAW,CACvB,QACA,WACA,QAAQ,GACR,cAAc,GACd,iBACA,eAAe,KACf,YACA,GAAG,GACwB,CAC3B,IAAM,GAAA,EAAS,EAAA,MAAA,CAAM,EACf,GAAA,EAAQ,EAAA,OAAA,CAAyB,IAAI,EACrC,EAAQ,EAAA,iBAAiB,EAAO,CAAc,EAE9C,GAAA,EAAc,EAAA,QAAA,KAAc,CAC9B,IAAM,EAAQ,EAAA,kBAAkB,CAAK,EAErC,OADgB,IAAU,GAAK,EAAA,UAAY,EAAA,UAAU,OAAQ,GAAS,EAAK,SAAS,CAAK,CAAC,EAAA,CAC3E,MAAM,EAAG,CAAK,CACjC,EAAG,CAAC,EAAO,CAAK,CAAC,EAMjB,OAJA,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAM,SAAS,kBAAkB,GAAS,EAAE,CAChD,EAAG,CAAC,CAAK,CAAC,GAGN,EAAA,EAAA,KAAA,CAAC,OAAD,CAAM,UAAW,EAAA,GAAG,EAAA,QAAO,OAAQ,CAAS,EAA5C,SAAA,EACI,EAAA,EAAA,IAAA,CAAC,OAAD,CAAM,UAAW,EAAA,QAAO,QAAS,cAAY,OACxC,SAAA,IAAU,IAAA,IAAa,EAAM,KAAK,IAAM,IACrC,EAAA,EAAA,IAAA,CAAC,EAAA,KAAD,CAAM,KAAM,EAAO,KAAM,EAAa,SAAU,CAAe,CAAA,EAE/D,CAEF,CAAA,GACN,EAAA,EAAA,IAAA,CAAC,QAAD,CACI,GAAI,EACJ,IAAK,EACL,KAAK,OACL,UAAW,EAAA,QAAO,MAClB,KAAM,EACC,QACP,eAAc,IAAU,IAAA,IAAa,IAAA,GACrC,SAAW,GAAU,EAAS,EAAA,kBAAkB,EAAM,OAAO,KAAK,CAAC,CACtE,CAAA,GACD,EAAA,EAAA,IAAA,CAAC,WAAD,CAAU,GAAI,EACT,SAAA,EAAY,IAAK,IACd,EAAA,EAAA,IAAA,CAAC,SAAD,CAAmB,MAAO,CAAO,EAApB,CAAoB,CACpC,CACK,CAAA,CACR,GAEd"}

package/dist/icons/IconPicker.js

@@ -0,0 +1,49 @@
+import { cn as e } from "../utils/cn.js";
+import { iconNames as t } from "./generated/icon-names.js";
+import { normalizeIconName as n } from "./normalize-icon-name.js";
+import { Icon as r } from "./Icon.js";
+import { validateIconName as i } from "./validate-icon-name.js";
+import a from "./IconPicker.module.js";
+import { useEffect as o, useId as s, useMemo as c, useRef as l } from "react";
+import { jsx as u, jsxs as d } from "react/jsx-runtime";
+//#region src/icons/IconPicker.tsx
+function f({ value: f, onChange: p, limit: m = 40, previewSize: h = 20, invalidMessage: g, emptyPreview: _ = null, className: v, ...y }) {
+	let b = s(), x = l(null), S = i(f, g), C = c(() => {
+		let e = n(f);
+		return (e === "" ? t : t.filter((t) => t.includes(e))).slice(0, m);
+	}, [f, m]);
+	return o(() => {
+		x.current?.setCustomValidity(S ?? "");
+	}, [S]), /* @__PURE__ */ d("span", {
+		className: e(a.picker, v),
+		children: [
+			/* @__PURE__ */ u("span", {
+				className: a.preview,
+				"aria-hidden": "true",
+				children: S === void 0 && f.trim() !== "" ? /* @__PURE__ */ u(r, {
+					name: f,
+					size: h,
+					fallback: _
+				}) : _
+			}),
+			/* @__PURE__ */ u("input", {
+				...y,
+				ref: x,
+				type: "text",
+				className: a.input,
+				list: b,
+				value: f,
+				"aria-invalid": S !== void 0 || void 0,
+				onChange: (e) => p(n(e.target.value))
+			}),
+			/* @__PURE__ */ u("datalist", {
+				id: b,
+				children: C.map((e) => /* @__PURE__ */ u("option", { value: e }, e))
+			})
+		]
+	});
+}
+//#endregion
+export { f as IconPicker };
+
+//# sourceMappingURL=IconPicker.js.map

package/dist/icons/IconPicker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconPicker.js","names":[],"sources":["../../src/icons/IconPicker.tsx"],"sourcesContent":["import { useEffect, useId, useMemo, useRef, type InputHTMLAttributes, type ReactNode } from \"react\";\n\nimport { cn } from \"../utils/cn\";\nimport { iconNames } from \"./generated/icon-names\";\nimport { Icon } from \"./Icon\";\nimport { normalizeIconName } from \"./normalize-icon-name\";\nimport { validateIconName } from \"./validate-icon-name\";\nimport styles from \"./IconPicker.module.css\";\n\n/**\n * @tempest-limits props-count — value/onChange are the field, limit/placeholder\n * the suggestion list, and previewSize/invalidMessage the two things a form\n * around it needs to restyle or translate.\n */\nexport interface IconPickerProps extends Omit<\n    InputHTMLAttributes<HTMLInputElement>,\n    \"value\" | \"onChange\" | \"list\" | \"type\"\n> {\n    /** The chosen slug. Always canonical — see `onChange`. */\n    value: string;\n    /**\n     * Fires with the **canonical** slug on every keystroke.\n     *\n     * Legacy spellings are normalized on the way out (`Shopping_Cart` →\n     * `shopping-cart`, `alert-circle` → `circle-alert`), so what a form stores is\n     * what `<Icon>` resolves without further cleanup.\n     */\n    onChange: (slug: string) => void;\n    /**\n     * How many suggestions to render. Default `40`.\n     *\n     * There are 2024 slugs, and building every one as an `<option>` on each\n     * keystroke freezes the datalist — which is the reason this prop exists rather\n     * than a \"show everything\" default.\n     */\n    limit?: number;\n    /** Size of the preview glyph, in px. Default `20`. */\n    previewSize?: number;\n    /** Overrides the message shown for a slug that does not exist. */\n    invalidMessage?: string;\n    /** Rendered in the preview box while nothing valid is chosen. */\n    emptyPreview?: ReactNode;\n}\n\n/**\n * An icon field: native autocomplete over every lucide slug, plus a preview.\n *\n * Every panel that lets someone choose an icon was rewriting this — filter the\n * list, cap the suggestions, build the `<datalist>`, and block submit when the\n * typed name does not exist. That last step is the one that matters: without it\n * an invalid value reaches the database and only shows up later as a missing icon\n * on every screen that renders the record.\n *\n * Validation is wired to the **native** form: the input carries a custom validity\n * message, so a plain `<form>` refuses to submit and the browser points at the\n * field. `validateIconName` is exported for react-hook-form and zod.\n *\n * Built on `<datalist>` rather than a custom listbox on purpose: keyboard,\n * screen-reader and mobile behaviour come from the platform, and the component\n * stays small enough that its cost is the slug list it has to import — ~7 KB\n * brotli, which only a picker pays.\n *\n * @example\n * const [icon, setIcon] = useState(\"\");\n *\n * <form onSubmit={save}>\n *     <IconPicker value={icon} onChange={setIcon} required />\n *     <button type=\"submit\">Salvar</button>\n * </form>\n */\nexport function IconPicker({\n    value,\n    onChange,\n    limit = 40,\n    previewSize = 20,\n    invalidMessage,\n    emptyPreview = null,\n    className,\n    ...rest\n}: IconPickerProps): ReactNode {\n    const listId = useId();\n    const input = useRef<HTMLInputElement>(null);\n    const error = validateIconName(value, invalidMessage);\n\n    const suggestions = useMemo(() => {\n        const query = normalizeIconName(value);\n        const matches = query === \"\" ? iconNames : iconNames.filter((name) => name.includes(query));\n        return matches.slice(0, limit);\n    }, [value, limit]);\n\n    useEffect(() => {\n        input.current?.setCustomValidity(error ?? \"\");\n    }, [error]);\n\n    return (\n        <span className={cn(styles.picker, className)}>\n            <span className={styles.preview} aria-hidden=\"true\">\n                {error === undefined && value.trim() !== \"\" ? (\n                    <Icon name={value} size={previewSize} fallback={emptyPreview} />\n                ) : (\n                    emptyPreview\n                )}\n            </span>\n            <input\n                {...rest}\n                ref={input}\n                type=\"text\"\n                className={styles.input}\n                list={listId}\n                value={value}\n                aria-invalid={error !== undefined || undefined}\n                onChange={(event) => onChange(normalizeIconName(event.target.value))}\n            />\n            <datalist id={listId}>\n                {suggestions.map((name) => (\n                    <option key={name} value={name} />\n                ))}\n            </datalist>\n        </span>\n    );\n}\n"],"mappings":";;;;;;;;;AAsEA,SAAgB,EAAW,EACvB,UACA,aACA,WAAQ,IACR,iBAAc,IACd,mBACA,kBAAe,MACf,cACA,GAAG,KACwB;CAC3B,IAAM,IAAS,EAAM,GACf,IAAQ,EAAyB,IAAI,GACrC,IAAQ,EAAiB,GAAO,CAAc,GAE9C,IAAc,QAAc;EAC9B,IAAM,IAAQ,EAAkB,CAAK;EAErC,QADgB,MAAU,KAAK,IAAY,EAAU,QAAQ,MAAS,EAAK,SAAS,CAAK,CAAC,EAAA,CAC3E,MAAM,GAAG,CAAK;CACjC,GAAG,CAAC,GAAO,CAAK,CAAC;CAMjB,OAJA,QAAgB;EACZ,EAAM,SAAS,kBAAkB,KAAS,EAAE;CAChD,GAAG,CAAC,CAAK,CAAC,GAGN,kBAAC,QAAD;EAAM,WAAW,EAAG,EAAO,QAAQ,CAAS;EAA5C,UAAA;GACI,kBAAC,QAAD;IAAM,WAAW,EAAO;IAAS,eAAY;IACxC,UAAA,MAAU,KAAA,KAAa,EAAM,KAAK,MAAM,KACrC,kBAAC,GAAD;KAAM,MAAM;KAAO,MAAM;KAAa,UAAU;IAAe,CAAA,IAE/D;GAEF,CAAA;GACN,kBAAC,SAAD;IACI,GAAI;IACJ,KAAK;IACL,MAAK;IACL,WAAW,EAAO;IAClB,MAAM;IACC;IACP,gBAAc,MAAU,KAAA,KAAa,KAAA;IACrC,WAAW,MAAU,EAAS,EAAkB,EAAM,OAAO,KAAK,CAAC;GACtE,CAAA;GACD,kBAAC,YAAD;IAAU,IAAI;IACT,UAAA,EAAY,KAAK,MACd,kBAAC,UAAD,EAAmB,OAAO,EAAO,GAApB,CAAoB,CACpC;GACK,CAAA;EACR;;AAEd"}

package/dist/icons/IconPicker.module.cjs

@@ -0,0 +1,2 @@
+var e=`tempest_picker_TP94V`,t=`tempest_preview_lo-Gg`,n=`tempest_input_5dPK-`,r={picker:e,preview:t,input:n};exports.default=r,exports.input=n,exports.picker=e,exports.preview=t;
+//# sourceMappingURL=IconPicker.module.cjs.map

package/dist/icons/IconPicker.module.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconPicker.module.cjs","names":[],"sources":["../../src/icons/IconPicker.module.css"],"sourcesContent":[".picker {\n    display: inline-flex;\n    align-items: center;\n    gap: var(--tempest-space-2);\n    font-family: var(--tempest-font-sans);\n}\n\n.preview {\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    flex: 0 0 auto;\n    width: 34px;\n    height: 34px;\n    border: 1px solid var(--tempest-border);\n    border-radius: var(--tempest-radius-md);\n    background: var(--tempest-surface);\n    color: var(--tempest-text);\n}\n\n.input {\n    flex: 1 1 auto;\n    min-width: 0;\n    padding: var(--tempest-space-2) var(--tempest-space-3);\n    border: 1px solid var(--tempest-border);\n    border-radius: var(--tempest-radius-md);\n    background: var(--tempest-bg);\n    color: var(--tempest-text);\n    font-family: inherit;\n    font-size: var(--tempest-text-sm);\n    min-height: 34px;\n}\n\n.input:focus-visible {\n    outline: 2px solid var(--tempest-primary);\n    outline-offset: 1px;\n}\n\n.input[aria-invalid=\"true\"] {\n    border-color: var(--tempest-danger);\n}\n"],"mappings":""}

package/dist/icons/IconPicker.module.js

@@ -0,0 +1,10 @@
+//#region src/icons/IconPicker.module.css
+var e = "tempest_picker_TP94V", t = "tempest_preview_lo-Gg", n = "tempest_input_5dPK-", r = {
+	picker: e,
+	preview: t,
+	input: n
+};
+//#endregion
+export { r as default, n as input, e as picker, t as preview };
+
+//# sourceMappingURL=IconPicker.module.js.map

package/dist/icons/IconPicker.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconPicker.module.js","names":[],"sources":["../../src/icons/IconPicker.module.css"],"sourcesContent":[".picker {\n    display: inline-flex;\n    align-items: center;\n    gap: var(--tempest-space-2);\n    font-family: var(--tempest-font-sans);\n}\n\n.preview {\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    flex: 0 0 auto;\n    width: 34px;\n    height: 34px;\n    border: 1px solid var(--tempest-border);\n    border-radius: var(--tempest-radius-md);\n    background: var(--tempest-surface);\n    color: var(--tempest-text);\n}\n\n.input {\n    flex: 1 1 auto;\n    min-width: 0;\n    padding: var(--tempest-space-2) var(--tempest-space-3);\n    border: 1px solid var(--tempest-border);\n    border-radius: var(--tempest-radius-md);\n    background: var(--tempest-bg);\n    color: var(--tempest-text);\n    font-family: inherit;\n    font-size: var(--tempest-text-sm);\n    min-height: 34px;\n}\n\n.input:focus-visible {\n    outline: 2px solid var(--tempest-primary);\n    outline-offset: 1px;\n}\n\n.input[aria-invalid=\"true\"] {\n    border-color: var(--tempest-danger);\n}\n"],"mappings":""}

package/dist/icons/alias.cjs

@@ -0,0 +1,2 @@
+const e=require("./generated/aliases.cjs");function t(t){return e.iconAliases[t]??t}exports.resolveIconAlias=t;
+//# sourceMappingURL=alias.cjs.map

package/dist/icons/alias.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias.cjs","names":[],"sources":["../../src/icons/alias.ts"],"sourcesContent":["import { iconAliases } from \"./generated/aliases\";\n\n/**\n * Map a slug to the canonical slug that owns the icon.\n *\n * Lucide keeps 257 deprecated aliases (`alert-circle` → `circle-alert`), and a\n * slug persisted in a database years ago is exactly the case this feature exists\n * for, so an alias must keep resolving after a lucide bump renames it. Resolution\n * happens before the shard lookup, since only canonical slugs are sharded.\n *\n * Its own module, not part of `shard-cache`: everything that merely *names* an\n * icon needs this — `normalizeIconName`, `validateIconName`, a form checking a\n * value before submit — and none of that needs the shard loader index. Sharing a\n * module made a validator that never renders anything drag in all 45 shard\n * modules.\n *\n * @param slug - Any icon slug, canonical or deprecated.\n * @returns The canonical slug.\n */\nexport function resolveIconAlias(slug: string): string {\n    return iconAliases[slug] ?? slug;\n}\n"],"mappings":"2CAmBA,SAAgB,EAAiB,EAAsB,CACnD,OAAO,EAAA,YAAY,IAAS,CAChC"}

package/dist/icons/alias.js

@@ -0,0 +1,9 @@
+import { iconAliases as e } from "./generated/aliases.js";
+//#region src/icons/alias.ts
+function t(t) {
+	return e[t] ?? t;
+}
+//#endregion
+export { t as resolveIconAlias };
+
+//# sourceMappingURL=alias.js.map

package/dist/icons/alias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias.js","names":[],"sources":["../../src/icons/alias.ts"],"sourcesContent":["import { iconAliases } from \"./generated/aliases\";\n\n/**\n * Map a slug to the canonical slug that owns the icon.\n *\n * Lucide keeps 257 deprecated aliases (`alert-circle` → `circle-alert`), and a\n * slug persisted in a database years ago is exactly the case this feature exists\n * for, so an alias must keep resolving after a lucide bump renames it. Resolution\n * happens before the shard lookup, since only canonical slugs are sharded.\n *\n * Its own module, not part of `shard-cache`: everything that merely *names* an\n * icon needs this — `normalizeIconName`, `validateIconName`, a form checking a\n * value before submit — and none of that needs the shard loader index. Sharing a\n * module made a validator that never renders anything drag in all 45 shard\n * modules.\n *\n * @param slug - Any icon slug, canonical or deprecated.\n * @returns The canonical slug.\n */\nexport function resolveIconAlias(slug: string): string {\n    return iconAliases[slug] ?? slug;\n}\n"],"mappings":";;AAmBA,SAAgB,EAAiB,GAAsB;CACnD,OAAO,EAAY,MAAS;AAChC"}

package/dist/icons/generated/loaders.cjs

@@ -1,2 +1,2 @@
-var e={a:()=>Promise.resolve().then(()=>require("./shard-a.cjs")),b:()=>Promise.resolve().then(()=>require("./shard-b.cjs")),c:()=>Promise.resolve().then(()=>require("./shard-c.cjs")),d:()=>Promise.resolve().then(()=>require("./shard-d.cjs")),e:()=>Promise.resolve().then(()=>require("./shard-e.cjs")),f:()=>Promise.resolve().then(()=>require("./shard-f.cjs")),g:()=>Promise.resolve().then(()=>require("./shard-g.cjs")),h:()=>Promise.resolve().then(()=>require("./shard-h.cjs")),i:()=>Promise.resolve().then(()=>require("./shard-i.cjs")),j:()=>Promise.resolve().then(()=>require("./shard-j.cjs")),k:()=>Promise.resolve().then(()=>require("./shard-k.cjs")),l:()=>Promise.resolve().then(()=>require("./shard-l.cjs")),m:()=>Promise.resolve().then(()=>require("./shard-m.cjs")),n:()=>Promise.resolve().then(()=>require("./shard-n.cjs")),o:()=>Promise.resolve().then(()=>require("./shard-o.cjs")),p:()=>Promise.resolve().then(()=>require("./shard-p.cjs")),q:()=>Promise.resolve().then(()=>require("./shard-q.cjs")),r:()=>Promise.resolve().then(()=>require("./shard-r.cjs")),s:()=>Promise.resolve().then(()=>require("./shard-s.cjs")),t:()=>Promise.resolve().then(()=>require("./shard-t.cjs")),u:()=>Promise.resolve().then(()=>require("./shard-u.cjs")),v:()=>Promise.resolve().then(()=>require("./shard-v.cjs")),w:()=>Promise.resolve().then(()=>require("./shard-w.cjs")),x:()=>Promise.resolve().then(()=>require("./shard-x.cjs")),z:()=>Promise.resolve().then(()=>require("./shard-z.cjs"))};exports.shardLoaders=e;
+var e=[{id:`shard-00`,from:`a-arrow-down`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-00.cjs"))},{id:`shard-01`,from:`amphora`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-01.cjs"))},{id:`shard-02`,from:`arrow-right-left`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-02.cjs"))},{id:`shard-03`,from:`badge-pound-sterling`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-03.cjs"))},{id:`shard-04`,from:`bell-electric`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-04.cjs"))},{id:`shard-05`,from:`book-image`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-05.cjs"))},{id:`shard-06`,from:`briefcase-conveyor-belt`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-06.cjs"))},{id:`shard-07`,from:`calendar-x`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-07.cjs"))},{id:`shard-08`,from:`chart-line`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-08.cjs"))},{id:`shard-09`,from:`circle-alert`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-09.cjs"))},{id:`shard-10`,from:`circle-small`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-10.cjs"))},{id:`shard-11`,from:`clock-fading`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-11.cjs"))},{id:`shard-12`,from:`concierge-bell`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-12.cjs"))},{id:`shard-13`,from:`database-arrow-up`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-13.cjs"))},{id:`shard-14`,from:`download`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-14.cjs"))},{id:`shard-15`,from:`face-slightly-frowning`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-15.cjs"))},{id:`shard-16`,from:`file-pen`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-16.cjs"))},{id:`shard-17`,from:`flashlight-off`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-17.cjs"))},{id:`shard-18`,from:`folder-up`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-18.cjs"))},{id:`shard-19`,from:`git-pull-request-closed`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-19.cjs"))},{id:`shard-20`,from:`hard-drive-download`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-20.cjs"))},{id:`shard-21`,from:`ice-cream-bowl`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-21.cjs"))},{id:`shard-22`,from:`languages`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-22.cjs"))},{id:`shard-23`,from:`list-checks`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-23.cjs"))},{id:`shard-24`,from:`mail-minus`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-24.cjs"))},{id:`shard-25`,from:`message-circle-dashed`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-25.cjs"))},{id:`shard-26`,from:`minimize-2`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-26.cjs"))},{id:`shard-27`,from:`move-horizontal`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-27.cjs"))},{id:`shard-28`,from:`package-open`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-28.cjs"))},{id:`shard-29`,from:`pen`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-29.cjs"))},{id:`shard-30`,from:`play-off`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-30.cjs"))},{id:`shard-31`,from:`receipt-japanese-yen`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-31.cjs"))},{id:`shard-32`,from:`rotate-ccw-key`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-32.cjs"))},{id:`shard-33`,from:`scan-text`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-33.cjs"))},{id:`shard-34`,from:`shield-ellipsis`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-34.cjs"))},{id:`shard-35`,from:`smartphone`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-35.cjs"))},{id:`shard-36`,from:`square-arrow-up-right`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-36.cjs"))},{id:`shard-37`,from:`square-power`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-37.cjs"))},{id:`shard-38`,from:`sticky-note-x`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-38.cjs"))},{id:`shard-39`,from:`tally-3`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-39.cjs"))},{id:`shard-40`,from:`timer-reset`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-40.cjs"))},{id:`shard-41`,from:`tv-minimal`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-41.cjs"))},{id:`shard-42`,from:`user-x`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-42.cjs"))},{id:`shard-43`,from:`waves-ladder`,size:40,load:()=>Promise.resolve().then(()=>require("./shard-43.cjs"))},{id:`shard-44`,from:`zodiac-pisces`,size:7,load:()=>Promise.resolve().then(()=>require("./shard-44.cjs"))}];exports.iconShards=e;
 //# sourceMappingURL=loaders.cjs.map

package/dist/icons/generated/loaders.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"loaders.cjs","names":[],"sources":["../../../src/icons/generated/loaders.ts"],"sourcesContent":["// GENERATED by scripts/gen-icons.mjs — do not edit.\n// Run `npm run gen:icons` after bumping lucide-react.\n\nimport type { LucideIcon } from \"lucide-react\";\n\n/**\n * One dynamic import per initial letter.\n *\n * These are the only references to the shard modules, which is what keeps them\n * out of whatever chunk imports `Icon`: a bundler that sees no static edge to a\n * shard emits it as an async chunk fetched on first use.\n */\nexport const shardLoaders: Record<string, () => Promise<{ default: Record<string, LucideIcon> }>> =\n    {\n        a: () => import(\"./shard-a\"),\n        b: () => import(\"./shard-b\"),\n        c: () => import(\"./shard-c\"),\n        d: () => import(\"./shard-d\"),\n        e: () => import(\"./shard-e\"),\n        f: () => import(\"./shard-f\"),\n        g: () => import(\"./shard-g\"),\n        h: () => import(\"./shard-h\"),\n        i: () => import(\"./shard-i\"),\n        j: () => import(\"./shard-j\"),\n        k: () => import(\"./shard-k\"),\n        l: () => import(\"./shard-l\"),\n        m: () => import(\"./shard-m\"),\n        n: () => import(\"./shard-n\"),\n        o: () => import(\"./shard-o\"),\n        p: () => import(\"./shard-p\"),\n        q: () => import(\"./shard-q\"),\n        r: () => import(\"./shard-r\"),\n        s: () => import(\"./shard-s\"),\n        t: () => import(\"./shard-t\"),\n        u: () => import(\"./shard-u\"),\n        v: () => import(\"./shard-v\"),\n        w: () => import(\"./shard-w\"),\n        x: () => import(\"./shard-x\"),\n        z: () => import(\"./shard-z\"),\n    };\n"],"mappings":"AAYA,IAAa,EACT,CACI,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,EACT,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAS,eAAA,CAAA,CACb"}
+{"version":3,"file":"loaders.cjs","names":[],"sources":["../../../src/icons/generated/loaders.ts"],"sourcesContent":["// GENERATED by scripts/gen-icons.mjs — do not edit.\n// Run `npm run gen:icons` after bumping lucide-react.\n\nimport type { LucideIcon } from \"lucide-react\";\n\n/** One lazily fetched range of icons. */\nexport interface IconShard {\n    /** The chunk's module id — what shows up in a bundle and in a 404. */\n    id: string;\n    /** First slug in the range, in sort order. Its lower bound. */\n    from: string;\n    /** How many icons the range holds. */\n    size: number;\n    /** The dynamic import for the chunk. */\n    load: () => Promise<{ default: Record<string, LucideIcon> }>;\n}\n\n/**\n * Every shard, in slug order.\n *\n * These are the only references to the shard modules, which is what keeps them\n * out of whatever chunk imports `Icon`: a bundler that sees no static edge to a\n * shard emits it as an async chunk fetched on first use.\n *\n * Sorted by `from`, so the owning shard for a slug is a binary search over this\n * array — 45 comparisons' worth of index instead of the 2000-entry\n * slug→chunk map that makes lucide's own `dynamicIconImports` cost 120 KB in the\n * main chunk.\n */\nexport const iconShards: readonly IconShard[] = [\n    { id: \"shard-00\", from: \"a-arrow-down\", size: 40, load: () => import(\"./shard-00\") },\n    { id: \"shard-01\", from: \"amphora\", size: 40, load: () => import(\"./shard-01\") },\n    { id: \"shard-02\", from: \"arrow-right-left\", size: 40, load: () => import(\"./shard-02\") },\n    { id: \"shard-03\", from: \"badge-pound-sterling\", size: 40, load: () => import(\"./shard-03\") },\n    { id: \"shard-04\", from: \"bell-electric\", size: 40, load: () => import(\"./shard-04\") },\n    { id: \"shard-05\", from: \"book-image\", size: 40, load: () => import(\"./shard-05\") },\n    { id: \"shard-06\", from: \"briefcase-conveyor-belt\", size: 40, load: () => import(\"./shard-06\") },\n    { id: \"shard-07\", from: \"calendar-x\", size: 40, load: () => import(\"./shard-07\") },\n    { id: \"shard-08\", from: \"chart-line\", size: 40, load: () => import(\"./shard-08\") },\n    { id: \"shard-09\", from: \"circle-alert\", size: 40, load: () => import(\"./shard-09\") },\n    { id: \"shard-10\", from: \"circle-small\", size: 40, load: () => import(\"./shard-10\") },\n    { id: \"shard-11\", from: \"clock-fading\", size: 40, load: () => import(\"./shard-11\") },\n    { id: \"shard-12\", from: \"concierge-bell\", size: 40, load: () => import(\"./shard-12\") },\n    { id: \"shard-13\", from: \"database-arrow-up\", size: 40, load: () => import(\"./shard-13\") },\n    { id: \"shard-14\", from: \"download\", size: 40, load: () => import(\"./shard-14\") },\n    { id: \"shard-15\", from: \"face-slightly-frowning\", size: 40, load: () => import(\"./shard-15\") },\n    { id: \"shard-16\", from: \"file-pen\", size: 40, load: () => import(\"./shard-16\") },\n    { id: \"shard-17\", from: \"flashlight-off\", size: 40, load: () => import(\"./shard-17\") },\n    { id: \"shard-18\", from: \"folder-up\", size: 40, load: () => import(\"./shard-18\") },\n    { id: \"shard-19\", from: \"git-pull-request-closed\", size: 40, load: () => import(\"./shard-19\") },\n    { id: \"shard-20\", from: \"hard-drive-download\", size: 40, load: () => import(\"./shard-20\") },\n    { id: \"shard-21\", from: \"ice-cream-bowl\", size: 40, load: () => import(\"./shard-21\") },\n    { id: \"shard-22\", from: \"languages\", size: 40, load: () => import(\"./shard-22\") },\n    { id: \"shard-23\", from: \"list-checks\", size: 40, load: () => import(\"./shard-23\") },\n    { id: \"shard-24\", from: \"mail-minus\", size: 40, load: () => import(\"./shard-24\") },\n    { id: \"shard-25\", from: \"message-circle-dashed\", size: 40, load: () => import(\"./shard-25\") },\n    { id: \"shard-26\", from: \"minimize-2\", size: 40, load: () => import(\"./shard-26\") },\n    { id: \"shard-27\", from: \"move-horizontal\", size: 40, load: () => import(\"./shard-27\") },\n    { id: \"shard-28\", from: \"package-open\", size: 40, load: () => import(\"./shard-28\") },\n    { id: \"shard-29\", from: \"pen\", size: 40, load: () => import(\"./shard-29\") },\n    { id: \"shard-30\", from: \"play-off\", size: 40, load: () => import(\"./shard-30\") },\n    { id: \"shard-31\", from: \"receipt-japanese-yen\", size: 40, load: () => import(\"./shard-31\") },\n    { id: \"shard-32\", from: \"rotate-ccw-key\", size: 40, load: () => import(\"./shard-32\") },\n    { id: \"shard-33\", from: \"scan-text\", size: 40, load: () => import(\"./shard-33\") },\n    { id: \"shard-34\", from: \"shield-ellipsis\", size: 40, load: () => import(\"./shard-34\") },\n    { id: \"shard-35\", from: \"smartphone\", size: 40, load: () => import(\"./shard-35\") },\n    { id: \"shard-36\", from: \"square-arrow-up-right\", size: 40, load: () => import(\"./shard-36\") },\n    { id: \"shard-37\", from: \"square-power\", size: 40, load: () => import(\"./shard-37\") },\n    { id: \"shard-38\", from: \"sticky-note-x\", size: 40, load: () => import(\"./shard-38\") },\n    { id: \"shard-39\", from: \"tally-3\", size: 40, load: () => import(\"./shard-39\") },\n    { id: \"shard-40\", from: \"timer-reset\", size: 40, load: () => import(\"./shard-40\") },\n    { id: \"shard-41\", from: \"tv-minimal\", size: 40, load: () => import(\"./shard-41\") },\n    { id: \"shard-42\", from: \"user-x\", size: 40, load: () => import(\"./shard-42\") },\n    { id: \"shard-43\", from: \"waves-ladder\", size: 40, load: () => import(\"./shard-43\") },\n    { id: \"shard-44\", from: \"zodiac-pisces\", size: 7, load: () => import(\"./shard-44\") },\n];\n"],"mappings":"AA6BA,IAAa,EAAmC,CAC5C,CAAE,GAAI,WAAY,KAAM,eAAgB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACnF,CAAE,GAAI,WAAY,KAAM,UAAW,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC9E,CAAE,GAAI,WAAY,KAAM,mBAAoB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACvF,CAAE,GAAI,WAAY,KAAM,uBAAwB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC3F,CAAE,GAAI,WAAY,KAAM,gBAAiB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACpF,CAAE,GAAI,WAAY,KAAM,aAAc,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACjF,CAAE,GAAI,WAAY,KAAM,0BAA2B,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC9F,CAAE,GAAI,WAAY,KAAM,aAAc,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACjF,CAAE,GAAI,WAAY,KAAM,aAAc,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACjF,CAAE,GAAI,WAAY,KAAM,eAAgB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACnF,CAAE,GAAI,WAAY,KAAM,eAAgB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACnF,CAAE,GAAI,WAAY,KAAM,eAAgB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACnF,CAAE,GAAI,WAAY,KAAM,iBAAkB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACrF,CAAE,GAAI,WAAY,KAAM,oBAAqB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACxF,CAAE,GAAI,WAAY,KAAM,WAAY,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC/E,CAAE,GAAI,WAAY,KAAM,yBAA0B,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC7F,CAAE,GAAI,WAAY,KAAM,WAAY,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC/E,CAAE,GAAI,WAAY,KAAM,iBAAkB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACrF,CAAE,GAAI,WAAY,KAAM,YAAa,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAChF,CAAE,GAAI,WAAY,KAAM,0BAA2B,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC9F,CAAE,GAAI,WAAY,KAAM,sBAAuB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC1F,CAAE,GAAI,WAAY,KAAM,iBAAkB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACrF,CAAE,GAAI,WAAY,KAAM,YAAa,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAChF,CAAE,GAAI,WAAY,KAAM,cAAe,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAClF,CAAE,GAAI,WAAY,KAAM,aAAc,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACjF,CAAE,GAAI,WAAY,KAAM,wBAAyB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC5F,CAAE,GAAI,WAAY,KAAM,aAAc,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACjF,CAAE,GAAI,WAAY,KAAM,kBAAmB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACtF,CAAE,GAAI,WAAY,KAAM,eAAgB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACnF,CAAE,GAAI,WAAY,KAAM,MAAO,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC1E,CAAE,GAAI,WAAY,KAAM,WAAY,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC/E,CAAE,GAAI,WAAY,KAAM,uBAAwB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC3F,CAAE,GAAI,WAAY,KAAM,iBAAkB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACrF,CAAE,GAAI,WAAY,KAAM,YAAa,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAChF,CAAE,GAAI,WAAY,KAAM,kBAAmB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACtF,CAAE,GAAI,WAAY,KAAM,aAAc,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACjF,CAAE,GAAI,WAAY,KAAM,wBAAyB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC5F,CAAE,GAAI,WAAY,KAAM,eAAgB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACnF,CAAE,GAAI,WAAY,KAAM,gBAAiB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACpF,CAAE,GAAI,WAAY,KAAM,UAAW,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC9E,CAAE,GAAI,WAAY,KAAM,cAAe,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAClF,CAAE,GAAI,WAAY,KAAM,aAAc,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACjF,CAAE,GAAI,WAAY,KAAM,SAAU,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EAC7E,CAAE,GAAI,WAAY,KAAM,eAAgB,KAAM,GAAI,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,EACnF,CAAE,GAAI,WAAY,KAAM,gBAAiB,KAAM,EAAG,SAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QAAY,gBAAA,CAAA,CAAqB,CACvF"}