tempest-react-sdk 0.43.0 → 0.44.0

package/dist/components/DataTable/LoadingRows.js

@@ -0,0 +1,18 @@
+import { Skeleton as e } from "../Skeleton/Skeleton.js";
+import t from "./DataTable.module.js";
+import { jsx as n } from "react/jsx-runtime";
+//#region src/components/DataTable/LoadingRows.tsx
+function r({ columns: r, rows: i }) {
+	return /* @__PURE__ */ n("div", {
+		className: t.loading,
+		"aria-hidden": "true",
+		children: Array.from({ length: i }, (i, a) => /* @__PURE__ */ n("div", {
+			className: t.loadingRow,
+			children: Array.from({ length: Math.max(r, 1) }, (t, r) => /* @__PURE__ */ n(e, { variant: "text" }, r))
+		}, a))
+	});
+}
+//#endregion
+export { r as LoadingRows };
+
+//# sourceMappingURL=LoadingRows.js.map

package/dist/components/DataTable/LoadingRows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadingRows.js","names":[],"sources":["../../../src/components/DataTable/LoadingRows.tsx"],"sourcesContent":["import { Skeleton } from \"../Skeleton\";\nimport styles from \"./DataTable.module.css\";\n\n/** Props for {@link LoadingRows}. */\nexport interface LoadingRowsProps {\n    /** How many placeholder cells to draw per row. */\n    columns: number;\n    /** How many placeholder rows to draw. */\n    rows: number;\n}\n\n/**\n * Placeholder rows for a table that has nothing to show yet.\n *\n * A first load and an empty result are different statements, and the usual\n * shortcut — showing `emptyMessage` while the request is in flight — tells the\n * user \"there is nothing here\" and then contradicts itself a moment later.\n * Drawing rows at roughly the real height also keeps whatever sits below the\n * table from jumping when the data lands.\n *\n * The whole block is `aria-hidden`: it carries no information a screen reader can\n * use, and the busy state is already on the wrapper. It also stays out of\n * `role=\"status\"`, which the table's announcement region already occupies —\n * two status regions on one table means the second one is what gets ignored.\n *\n * @param props - Grid size to fill.\n * @returns The placeholder block.\n */\nexport function LoadingRows({ columns, rows }: LoadingRowsProps) {\n    return (\n        <div className={styles.loading} aria-hidden=\"true\">\n            {Array.from({ length: rows }, (_, rowIndex) => (\n                <div key={rowIndex} className={styles.loadingRow}>\n                    {Array.from({ length: Math.max(columns, 1) }, (_, cellIndex) => (\n                        <Skeleton key={cellIndex} variant=\"text\" />\n                    ))}\n                </div>\n            ))}\n        </div>\n    );\n}\n"],"mappings":";;;;AA4BA,SAAgB,EAAY,EAAE,YAAS,WAA0B;CAC7D,OACI,kBAAC,OAAD;EAAK,WAAW,EAAO;EAAS,eAAY;EACvC,UAAA,MAAM,KAAK,EAAE,QAAQ,EAAK,IAAI,GAAG,MAC9B,kBAAC,OAAD;GAAoB,WAAW,EAAO;GACjC,UAAA,MAAM,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAS,CAAC,EAAE,IAAI,GAAG,MAC9C,kBAAC,GAAD,EAA0B,SAAQ,OAAQ,GAA3B,CAA2B,CAC7C;EACA,GAJK,CAIL,CACR;CACA,CAAA;AAEb"}

package/dist/components/DataTable/use-dev-warnings.cjs

@@ -0,0 +1,2 @@
+let e=require("react");function t({serverMode:t,controlledPage:n,onPageChange:r,sortIsManual:i,onSortChange:a}){(0,e.useEffect)(()=>{process.env.NODE_ENV!==`production`&&(t&&n===void 0&&console.warn("[tempest] <DataTable totalItems> is server mode, which needs a controlled `page`. Without it the pager moves the internal page while `data` keeps showing page 1."),n!==void 0&&!r&&console.warn("[tempest] <DataTable page> is controlled but `onPageChange` is missing, so the pager cannot do anything."),i&&!a&&console.warn("[tempest] <DataTable> is sorting manually but `onSortChange` is missing: clicking a sortable header changes the arrow and nothing else."))},[t,n,r,i,a])}exports.useDevWarnings=t;
+//# sourceMappingURL=use-dev-warnings.cjs.map

package/dist/components/DataTable/use-dev-warnings.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-dev-warnings.cjs","names":[],"sources":["../../../src/components/DataTable/use-dev-warnings.ts"],"sourcesContent":["import { useEffect } from \"react\";\n\n/** What {@link useDevWarnings} needs to judge the prop combination. */\nexport interface DataTableDevWarningsInput {\n    /** Whether `totalItems` was passed. */\n    serverMode: boolean;\n    /** The controlled `page`, if any. */\n    controlledPage: number | undefined;\n    /** The page callback, if any. */\n    onPageChange: ((page: number) => void) | undefined;\n    /** Whether sorting is delegated. */\n    sortIsManual: boolean;\n    /** The sort callback, if any. */\n    onSortChange: ((sort: never) => void) | undefined;\n}\n\n/**\n * Warn, in development only, about prop combinations that render a table which\n * silently lies.\n *\n * Each of these produces a screen that looks like it works: the header sorts and\n * nothing moves, the pager renders and clicking it does nothing. They are not\n * type errors — every prop is optional on its own — so the only place to catch\n * them is at runtime, once, in dev.\n *\n * @param input - The resolved prop combination.\n */\nexport function useDevWarnings({\n    serverMode,\n    controlledPage,\n    onPageChange,\n    sortIsManual,\n    onSortChange,\n}: DataTableDevWarningsInput): void {\n    useEffect(() => {\n        if (process.env.NODE_ENV === \"production\") return;\n\n        if (serverMode && controlledPage === undefined) {\n            console.warn(\n                \"[tempest] <DataTable totalItems> is server mode, which needs a controlled `page`. \" +\n                    \"Without it the pager moves the internal page while `data` keeps showing page 1.\",\n            );\n        }\n        if (controlledPage !== undefined && !onPageChange) {\n            console.warn(\n                \"[tempest] <DataTable page> is controlled but `onPageChange` is missing, so the pager cannot do anything.\",\n            );\n        }\n        if (sortIsManual && !onSortChange) {\n            console.warn(\n                \"[tempest] <DataTable> is sorting manually but `onSortChange` is missing: clicking a sortable header changes the arrow and nothing else.\",\n            );\n        }\n    }, [serverMode, controlledPage, onPageChange, sortIsManual, onSortChange]);\n}\n"],"mappings":"uBA2BA,SAAgB,EAAe,CAC3B,aACA,iBACA,eACA,eACA,gBACgC,EAChC,EAAA,EAAA,UAAA,KAAgB,CACZ,QAAA,IAAA,WAA6B,eAEzB,GAAc,IAAmB,IAAA,IACjC,QAAQ,KACJ,mKAEJ,EAEA,IAAmB,IAAA,IAAa,CAAC,GACjC,QAAQ,KACJ,0GACJ,EAEA,GAAgB,CAAC,GACjB,QAAQ,KACJ,yIACJ,EAER,EAAG,CAAC,EAAY,EAAgB,EAAc,EAAc,CAAY,CAAC,CAC7E"}

package/dist/components/DataTable/use-dev-warnings.js

@@ -0,0 +1,17 @@
+import { useEffect as e } from "react";
+//#region src/components/DataTable/use-dev-warnings.ts
+function t({ serverMode: t, controlledPage: n, onPageChange: r, sortIsManual: i, onSortChange: a }) {
+	e(() => {
+		process.env.NODE_ENV !== "production" && (t && n === void 0 && console.warn("[tempest] <DataTable totalItems> is server mode, which needs a controlled `page`. Without it the pager moves the internal page while `data` keeps showing page 1."), n !== void 0 && !r && console.warn("[tempest] <DataTable page> is controlled but `onPageChange` is missing, so the pager cannot do anything."), i && !a && console.warn("[tempest] <DataTable> is sorting manually but `onSortChange` is missing: clicking a sortable header changes the arrow and nothing else."));
+	}, [
+		t,
+		n,
+		r,
+		i,
+		a
+	]);
+}
+//#endregion
+export { t as useDevWarnings };
+
+//# sourceMappingURL=use-dev-warnings.js.map

package/dist/components/DataTable/use-dev-warnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-dev-warnings.js","names":[],"sources":["../../../src/components/DataTable/use-dev-warnings.ts"],"sourcesContent":["import { useEffect } from \"react\";\n\n/** What {@link useDevWarnings} needs to judge the prop combination. */\nexport interface DataTableDevWarningsInput {\n    /** Whether `totalItems` was passed. */\n    serverMode: boolean;\n    /** The controlled `page`, if any. */\n    controlledPage: number | undefined;\n    /** The page callback, if any. */\n    onPageChange: ((page: number) => void) | undefined;\n    /** Whether sorting is delegated. */\n    sortIsManual: boolean;\n    /** The sort callback, if any. */\n    onSortChange: ((sort: never) => void) | undefined;\n}\n\n/**\n * Warn, in development only, about prop combinations that render a table which\n * silently lies.\n *\n * Each of these produces a screen that looks like it works: the header sorts and\n * nothing moves, the pager renders and clicking it does nothing. They are not\n * type errors — every prop is optional on its own — so the only place to catch\n * them is at runtime, once, in dev.\n *\n * @param input - The resolved prop combination.\n */\nexport function useDevWarnings({\n    serverMode,\n    controlledPage,\n    onPageChange,\n    sortIsManual,\n    onSortChange,\n}: DataTableDevWarningsInput): void {\n    useEffect(() => {\n        if (process.env.NODE_ENV === \"production\") return;\n\n        if (serverMode && controlledPage === undefined) {\n            console.warn(\n                \"[tempest] <DataTable totalItems> is server mode, which needs a controlled `page`. \" +\n                    \"Without it the pager moves the internal page while `data` keeps showing page 1.\",\n            );\n        }\n        if (controlledPage !== undefined && !onPageChange) {\n            console.warn(\n                \"[tempest] <DataTable page> is controlled but `onPageChange` is missing, so the pager cannot do anything.\",\n            );\n        }\n        if (sortIsManual && !onSortChange) {\n            console.warn(\n                \"[tempest] <DataTable> is sorting manually but `onSortChange` is missing: clicking a sortable header changes the arrow and nothing else.\",\n            );\n        }\n    }, [serverMode, controlledPage, onPageChange, sortIsManual, onSortChange]);\n}\n"],"mappings":";;AA2BA,SAAgB,EAAe,EAC3B,eACA,mBACA,iBACA,iBACA,mBACgC;CAChC,QAAgB;EACZ,QAAA,IAAA,aAA6B,iBAEzB,KAAc,MAAmB,KAAA,KACjC,QAAQ,KACJ,mKAEJ,GAEA,MAAmB,KAAA,KAAa,CAAC,KACjC,QAAQ,KACJ,0GACJ,GAEA,KAAgB,CAAC,KACjB,QAAQ,KACJ,yIACJ;CAER,GAAG;EAAC;EAAY;EAAgB;EAAc;EAAc;CAAY,CAAC;AAC7E"}

package/dist/components/FilterBar/filter-apply.cjs

@@ -0,0 +1,2 @@
+const e=require("./filter-model.cjs");var t=/^\d{4}-\d{2}-\d{2}$/;function n(e,t){if(!(typeof e!=`object`||!e))return e[t]}function r(e){if(typeof e==`string`&&t.test(e))return e;let n=e instanceof Date?e:typeof e==`string`&&e.trim()!==``?new Date(e):null;if(n===null||Number.isNaN(n.getTime()))return null;let r=`${n.getMonth()+1}`.padStart(2,`0`),i=`${n.getDate()}`.padStart(2,`0`);return`${n.getFullYear()}-${r}-${i}`}function i(e,n){if(e==null)return null;if(typeof e==`number`){let t=Number(n);return Number.isNaN(t)?null:e-t}if(typeof e==`boolean`){let t=n===`true`||n!==`false`&&null;return t===null?null:Number(e)-Number(t)}if(t.test(n)){let t=r(e);return t===null?null:t.localeCompare(n)}return String(e).localeCompare(n,void 0,{numeric:!0})}function a(e,t){let n=i(e,t);return n===null?String(e??``)===t:n===0}function o(e){return e==null?!0:typeof e==`string`?e.trim()===``:Array.isArray(e)?e.length===0:!1}function s(e){return e.value===void 0?[]:Array.isArray(e.value)?[...e.value]:[String(e.value)]}function c(e,t,n){switch(e){case`empty`:return o(t);case`notEmpty`:return!o(t);case`eq`:return a(t,n[0]??``);case`ne`:return!a(t,n[0]??``);case`contains`:return String(t??``).toLowerCase().includes((n[0]??``).toLowerCase());case`in`:return n.some(e=>a(t,e));case`between`:{let[e=``,r=``]=n,a=i(t,e),o=i(t,r);return a===null||o===null?!1:a>=0&&o<=0}default:{let r=i(t,n[0]??``);return r===null?!1:e===`gt`?r>0:e===`gte`?r>=0:e===`lt`?r<0:r<=0}}}function l(e){let[n=``,r=``]=e;if(t.test(n)&&t.test(r))return n<=r?[n,r]:[r,n];let i=Number(n),a=Number(r);return!Number.isNaN(i)&&!Number.isNaN(a)?i<=a?[n,r]:[r,n]:n.localeCompare(r,void 0,{numeric:!0})<=0?[n,r]:[r,n]}function u(t,r){let i=r.filter(e.isComplete);return i.length===0?[...t]:t.filter(t=>i.every(r=>{let i=n(t,r.field);if(e.isValueless(r.operator))return c(r.operator,i,[]);let a=r.operator===`between`?l(s(r)):s(r);return c(r.operator,i,a)}))}exports.applyFilters=u,exports.orderRange=l;
+//# sourceMappingURL=filter-apply.cjs.map

package/dist/components/FilterBar/filter-apply.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-apply.cjs","names":[],"sources":["../../../src/components/FilterBar/filter-apply.ts"],"sourcesContent":["// The other half of the filter model: evaluating a `Filter[]` instead of only\n// describing it. `FilterBar` produces filters, `applyFilters` runs them over an\n// in-memory list, and `filtersToQueryParams` (filter-query.ts) hands the same set\n// to a paginated backend. Without these two the model stops one step short of\n// useful and every app writes the eleven operator branches again.\n\nimport type { Filter, FilterOperator } from \"./filter-model\";\nimport { isComplete, isValueless } from \"./filter-model\";\n\n/** Matches a plain `yyyy-mm-dd`, the shape `<input type=\"date\">` produces. */\nconst DATE_ONLY = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n/**\n * Read a property off a row without asserting the row's shape.\n *\n * `Filter.field` is a string chosen by the app's field list, so it cannot be a\n * `keyof T`; the lookup goes through an index signature and a missing property\n * yields `undefined`, which the operators treat as an empty value.\n *\n * @param item - The row being tested.\n * @param field - Property name from the filter.\n * @returns The property value, or `undefined` when the row has no such key.\n */\nfunction readField(item: unknown, field: string): unknown {\n    if (item == null || typeof item !== \"object\") return undefined;\n    return (item as Record<string, unknown>)[field];\n}\n\n/**\n * Local `yyyy-mm-dd` for a value that represents a date, or `null`.\n *\n * Built from the local calendar parts rather than `toISOString`, which converts\n * to UTC first and therefore reports the next day for anything after 21:00 in\n * UTC-3. A `yyyy-mm-dd` string is returned untouched, so a filter value and a\n * row value that already agree never round-trip through `Date` at all.\n *\n * @param value - A `Date`, a date-ish string, or anything else.\n * @returns The day key, or `null` when the value does not denote a date.\n */\nfunction dayKey(value: unknown): string | null {\n    if (typeof value === \"string\" && DATE_ONLY.test(value)) return value;\n\n    const date =\n        value instanceof Date\n            ? value\n            : typeof value === \"string\" && value.trim() !== \"\"\n              ? new Date(value)\n              : null;\n    if (date === null || Number.isNaN(date.getTime())) return null;\n\n    const month = `${date.getMonth() + 1}`.padStart(2, \"0\");\n    const day = `${date.getDate()}`.padStart(2, \"0\");\n    return `${date.getFullYear()}-${month}-${day}`;\n}\n\n/**\n * Compare a row value against a filter value, in the row value's own type.\n *\n * The filter always carries strings — it comes from form inputs and from the\n * URL — while the row carries whatever the API returned. Comparing them as text\n * gets the two common cases wrong: `10` would sort before `9`, and a date would\n * be compared by however it happens to be formatted. So the row value picks the\n * comparison, and the filter value is coerced into it.\n *\n * Dates compare by **day**, not by instant: a row stamped `2026-03-05T13:00:00Z`\n * is `>= 2026-03-05`, which is what the person picking a date in the UI means.\n *\n * @param left - The row value.\n * @param right - The raw filter value.\n * @returns Negative, zero or positive, or `null` when the two cannot be compared.\n */\nfunction compare(left: unknown, right: string): number | null {\n    if (left == null) return null;\n\n    if (typeof left === \"number\") {\n        const parsed = Number(right);\n        return Number.isNaN(parsed) ? null : left - parsed;\n    }\n\n    if (typeof left === \"boolean\") {\n        const parsed = right === \"true\" ? true : right === \"false\" ? false : null;\n        return parsed === null ? null : Number(left) - Number(parsed);\n    }\n\n    if (DATE_ONLY.test(right)) {\n        const key = dayKey(left);\n        return key === null ? null : key.localeCompare(right);\n    }\n\n    return String(left).localeCompare(right, undefined, { numeric: true });\n}\n\n/**\n * Equality in the row value's type, falling back to exact text.\n *\n * Case-sensitive on purpose: `eq` maps to a plain `WHERE column = value` on the\n * server side, so a case-insensitive client would quietly disagree with the\n * backend for the same filter. `contains` is the case-insensitive operator, and\n * it is also the default one for text fields, so the friendly behaviour is what\n * people get without asking.\n *\n * @param left - The row value.\n * @param right - The raw filter value.\n * @returns Whether the two are equal.\n */\nfunction equals(left: unknown, right: string): boolean {\n    const result = compare(left, right);\n    if (result !== null) return result === 0;\n    return String(left ?? \"\") === right;\n}\n\n/**\n * Is this row value empty?\n *\n * Empty means absent, blank text or an empty list — never falsy. `0` and `false`\n * are values somebody chose, and a filter that hid them would be reporting the\n * wrong count on every dashboard that tracks zeroes.\n *\n * @param value - The row value.\n * @returns Whether the value counts as empty.\n */\nfunction isEmptyValue(value: unknown): boolean {\n    if (value == null) return true;\n    if (typeof value === \"string\") return value.trim() === \"\";\n    if (Array.isArray(value)) return value.length === 0;\n    return false;\n}\n\n/**\n * The filter's value as a list, whatever arity the operator uses.\n *\n * @param filter - The filter to read.\n * @returns Its values, trimmed of nothing — a leading space may be meaningful text.\n */\nfunction valuesOf(filter: Filter): string[] {\n    if (filter.value === undefined) return [];\n    return Array.isArray(filter.value) ? [...filter.value] : [String(filter.value)];\n}\n\n/**\n * Evaluate one operator against one row value.\n *\n * @param operator - The comparison to make.\n * @param left - The row value.\n * @param values - The filter values (one, two for `between`, many for `in`).\n * @returns Whether the row value satisfies the operator.\n */\nfunction matchesOperator(operator: FilterOperator, left: unknown, values: string[]): boolean {\n    switch (operator) {\n        case \"empty\":\n            return isEmptyValue(left);\n        case \"notEmpty\":\n            return !isEmptyValue(left);\n        case \"eq\":\n            return equals(left, values[0] ?? \"\");\n        case \"ne\":\n            return !equals(left, values[0] ?? \"\");\n        case \"contains\":\n            return String(left ?? \"\")\n                .toLowerCase()\n                .includes((values[0] ?? \"\").toLowerCase());\n        case \"in\":\n            return values.some((value) => equals(left, value));\n        case \"between\": {\n            const [first = \"\", second = \"\"] = values;\n            const low = compare(left, first);\n            const high = compare(left, second);\n            if (low === null || high === null) return false;\n            return low >= 0 && high <= 0;\n        }\n        default: {\n            const result = compare(left, values[0] ?? \"\");\n            if (result === null) return false;\n            if (operator === \"gt\") return result > 0;\n            if (operator === \"gte\") return result >= 0;\n            if (operator === \"lt\") return result < 0;\n            return result <= 0;\n        }\n    }\n}\n\n/**\n * Order the two values of a `between` so the range is never empty by accident.\n *\n * A person who picks the later date first means the range between the two dates,\n * not \"no rows\". The server-side `BETWEEN` needs `(lo, hi)` in order too, which\n * is why the normalisation lives here and is shared by `filtersToQueryParams`.\n *\n * @param values - The raw pair.\n * @returns The pair, ascending.\n */\nexport function orderRange(values: readonly string[]): string[] {\n    const [first = \"\", second = \"\"] = values;\n    if (DATE_ONLY.test(first) && DATE_ONLY.test(second)) {\n        return first <= second ? [first, second] : [second, first];\n    }\n    const low = Number(first);\n    const high = Number(second);\n    if (!Number.isNaN(low) && !Number.isNaN(high)) {\n        return low <= high ? [first, second] : [second, first];\n    }\n    return first.localeCompare(second, undefined, { numeric: true }) <= 0\n        ? [first, second]\n        : [second, first];\n}\n\n/**\n * Run a filter set over an in-memory list.\n *\n * Closes the loop `FilterBar` opens: the bar produces `Filter[]`, this applies\n * them. Filters combine with `AND`, matching the flat model the bar builds, and\n * an incomplete filter is skipped rather than treated as a match of nothing — a\n * half-filled form should not empty the table underneath it.\n *\n * Comparison follows the row's type, not the filter's: numbers compare\n * numerically, dates compare by day, and everything else compares as text with\n * `numeric: true` so `\"item 2\"` lands before `\"item 10\"`.\n *\n * A few behaviours differ from the SQL the server-side twin produces, and the\n * difference is deliberate rather than accidental:\n *\n * - `ne` matches rows whose value is absent. In SQL, `column <> 'x'` is `NULL`\n *   for a `NULL` column and the row drops out. Here \"is not paid\" shows the rows\n *   with no status at all, which is what the chip claims.\n * - `empty` matches `NULL`, blank text and empty lists; `__isnull` on the server\n *   only matches `NULL`. A column that stores `\"\"` instead of `NULL` is where\n *   the two disagree.\n *\n * @example\n * const visible = applyFilters(orders, filters);\n *\n * @param items - The full list.\n * @param filters - Applied filters; incomplete ones are ignored.\n * @returns A new array with the rows that satisfy every complete filter.\n */\nexport function applyFilters<T>(items: readonly T[], filters: readonly Filter[]): T[] {\n    const active = filters.filter(isComplete);\n    if (active.length === 0) return [...items];\n\n    return items.filter((item) =>\n        active.every((filter) => {\n            const left = readField(item, filter.field);\n            if (isValueless(filter.operator)) {\n                return matchesOperator(filter.operator, left, []);\n            }\n            const values =\n                filter.operator === \"between\" ? orderRange(valuesOf(filter)) : valuesOf(filter);\n            return matchesOperator(filter.operator, left, values);\n        }),\n    );\n}\n"],"mappings":"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"}

package/dist/components/FilterBar/filter-apply.js

@@ -0,0 +1,76 @@
+import { isComplete as e, isValueless as t } from "./filter-model.js";
+//#region src/components/FilterBar/filter-apply.ts
+var n = /^\d{4}-\d{2}-\d{2}$/;
+function r(e, t) {
+	if (!(typeof e != "object" || !e)) return e[t];
+}
+function i(e) {
+	if (typeof e == "string" && n.test(e)) return e;
+	let t = e instanceof Date ? e : typeof e == "string" && e.trim() !== "" ? new Date(e) : null;
+	if (t === null || Number.isNaN(t.getTime())) return null;
+	let r = `${t.getMonth() + 1}`.padStart(2, "0"), i = `${t.getDate()}`.padStart(2, "0");
+	return `${t.getFullYear()}-${r}-${i}`;
+}
+function a(e, t) {
+	if (e == null) return null;
+	if (typeof e == "number") {
+		let n = Number(t);
+		return Number.isNaN(n) ? null : e - n;
+	}
+	if (typeof e == "boolean") {
+		let n = t === "true" || t !== "false" && null;
+		return n === null ? null : Number(e) - Number(n);
+	}
+	if (n.test(t)) {
+		let n = i(e);
+		return n === null ? null : n.localeCompare(t);
+	}
+	return String(e).localeCompare(t, void 0, { numeric: !0 });
+}
+function o(e, t) {
+	let n = a(e, t);
+	return n === null ? String(e ?? "") === t : n === 0;
+}
+function s(e) {
+	return e == null ? !0 : typeof e == "string" ? e.trim() === "" : Array.isArray(e) ? e.length === 0 : !1;
+}
+function c(e) {
+	return e.value === void 0 ? [] : Array.isArray(e.value) ? [...e.value] : [String(e.value)];
+}
+function l(e, t, n) {
+	switch (e) {
+		case "empty": return s(t);
+		case "notEmpty": return !s(t);
+		case "eq": return o(t, n[0] ?? "");
+		case "ne": return !o(t, n[0] ?? "");
+		case "contains": return String(t ?? "").toLowerCase().includes((n[0] ?? "").toLowerCase());
+		case "in": return n.some((e) => o(t, e));
+		case "between": {
+			let [e = "", r = ""] = n, i = a(t, e), o = a(t, r);
+			return i === null || o === null ? !1 : i >= 0 && o <= 0;
+		}
+		default: {
+			let r = a(t, n[0] ?? "");
+			return r === null ? !1 : e === "gt" ? r > 0 : e === "gte" ? r >= 0 : e === "lt" ? r < 0 : r <= 0;
+		}
+	}
+}
+function u(e) {
+	let [t = "", r = ""] = e;
+	if (n.test(t) && n.test(r)) return t <= r ? [t, r] : [r, t];
+	let i = Number(t), a = Number(r);
+	return !Number.isNaN(i) && !Number.isNaN(a) ? i <= a ? [t, r] : [r, t] : t.localeCompare(r, void 0, { numeric: !0 }) <= 0 ? [t, r] : [r, t];
+}
+function d(n, i) {
+	let a = i.filter(e);
+	return a.length === 0 ? [...n] : n.filter((e) => a.every((n) => {
+		let i = r(e, n.field);
+		if (t(n.operator)) return l(n.operator, i, []);
+		let a = n.operator === "between" ? u(c(n)) : c(n);
+		return l(n.operator, i, a);
+	}));
+}
+//#endregion
+export { d as applyFilters, u as orderRange };
+
+//# sourceMappingURL=filter-apply.js.map

package/dist/components/FilterBar/filter-apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-apply.js","names":[],"sources":["../../../src/components/FilterBar/filter-apply.ts"],"sourcesContent":["// The other half of the filter model: evaluating a `Filter[]` instead of only\n// describing it. `FilterBar` produces filters, `applyFilters` runs them over an\n// in-memory list, and `filtersToQueryParams` (filter-query.ts) hands the same set\n// to a paginated backend. Without these two the model stops one step short of\n// useful and every app writes the eleven operator branches again.\n\nimport type { Filter, FilterOperator } from \"./filter-model\";\nimport { isComplete, isValueless } from \"./filter-model\";\n\n/** Matches a plain `yyyy-mm-dd`, the shape `<input type=\"date\">` produces. */\nconst DATE_ONLY = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n/**\n * Read a property off a row without asserting the row's shape.\n *\n * `Filter.field` is a string chosen by the app's field list, so it cannot be a\n * `keyof T`; the lookup goes through an index signature and a missing property\n * yields `undefined`, which the operators treat as an empty value.\n *\n * @param item - The row being tested.\n * @param field - Property name from the filter.\n * @returns The property value, or `undefined` when the row has no such key.\n */\nfunction readField(item: unknown, field: string): unknown {\n    if (item == null || typeof item !== \"object\") return undefined;\n    return (item as Record<string, unknown>)[field];\n}\n\n/**\n * Local `yyyy-mm-dd` for a value that represents a date, or `null`.\n *\n * Built from the local calendar parts rather than `toISOString`, which converts\n * to UTC first and therefore reports the next day for anything after 21:00 in\n * UTC-3. A `yyyy-mm-dd` string is returned untouched, so a filter value and a\n * row value that already agree never round-trip through `Date` at all.\n *\n * @param value - A `Date`, a date-ish string, or anything else.\n * @returns The day key, or `null` when the value does not denote a date.\n */\nfunction dayKey(value: unknown): string | null {\n    if (typeof value === \"string\" && DATE_ONLY.test(value)) return value;\n\n    const date =\n        value instanceof Date\n            ? value\n            : typeof value === \"string\" && value.trim() !== \"\"\n              ? new Date(value)\n              : null;\n    if (date === null || Number.isNaN(date.getTime())) return null;\n\n    const month = `${date.getMonth() + 1}`.padStart(2, \"0\");\n    const day = `${date.getDate()}`.padStart(2, \"0\");\n    return `${date.getFullYear()}-${month}-${day}`;\n}\n\n/**\n * Compare a row value against a filter value, in the row value's own type.\n *\n * The filter always carries strings — it comes from form inputs and from the\n * URL — while the row carries whatever the API returned. Comparing them as text\n * gets the two common cases wrong: `10` would sort before `9`, and a date would\n * be compared by however it happens to be formatted. So the row value picks the\n * comparison, and the filter value is coerced into it.\n *\n * Dates compare by **day**, not by instant: a row stamped `2026-03-05T13:00:00Z`\n * is `>= 2026-03-05`, which is what the person picking a date in the UI means.\n *\n * @param left - The row value.\n * @param right - The raw filter value.\n * @returns Negative, zero or positive, or `null` when the two cannot be compared.\n */\nfunction compare(left: unknown, right: string): number | null {\n    if (left == null) return null;\n\n    if (typeof left === \"number\") {\n        const parsed = Number(right);\n        return Number.isNaN(parsed) ? null : left - parsed;\n    }\n\n    if (typeof left === \"boolean\") {\n        const parsed = right === \"true\" ? true : right === \"false\" ? false : null;\n        return parsed === null ? null : Number(left) - Number(parsed);\n    }\n\n    if (DATE_ONLY.test(right)) {\n        const key = dayKey(left);\n        return key === null ? null : key.localeCompare(right);\n    }\n\n    return String(left).localeCompare(right, undefined, { numeric: true });\n}\n\n/**\n * Equality in the row value's type, falling back to exact text.\n *\n * Case-sensitive on purpose: `eq` maps to a plain `WHERE column = value` on the\n * server side, so a case-insensitive client would quietly disagree with the\n * backend for the same filter. `contains` is the case-insensitive operator, and\n * it is also the default one for text fields, so the friendly behaviour is what\n * people get without asking.\n *\n * @param left - The row value.\n * @param right - The raw filter value.\n * @returns Whether the two are equal.\n */\nfunction equals(left: unknown, right: string): boolean {\n    const result = compare(left, right);\n    if (result !== null) return result === 0;\n    return String(left ?? \"\") === right;\n}\n\n/**\n * Is this row value empty?\n *\n * Empty means absent, blank text or an empty list — never falsy. `0` and `false`\n * are values somebody chose, and a filter that hid them would be reporting the\n * wrong count on every dashboard that tracks zeroes.\n *\n * @param value - The row value.\n * @returns Whether the value counts as empty.\n */\nfunction isEmptyValue(value: unknown): boolean {\n    if (value == null) return true;\n    if (typeof value === \"string\") return value.trim() === \"\";\n    if (Array.isArray(value)) return value.length === 0;\n    return false;\n}\n\n/**\n * The filter's value as a list, whatever arity the operator uses.\n *\n * @param filter - The filter to read.\n * @returns Its values, trimmed of nothing — a leading space may be meaningful text.\n */\nfunction valuesOf(filter: Filter): string[] {\n    if (filter.value === undefined) return [];\n    return Array.isArray(filter.value) ? [...filter.value] : [String(filter.value)];\n}\n\n/**\n * Evaluate one operator against one row value.\n *\n * @param operator - The comparison to make.\n * @param left - The row value.\n * @param values - The filter values (one, two for `between`, many for `in`).\n * @returns Whether the row value satisfies the operator.\n */\nfunction matchesOperator(operator: FilterOperator, left: unknown, values: string[]): boolean {\n    switch (operator) {\n        case \"empty\":\n            return isEmptyValue(left);\n        case \"notEmpty\":\n            return !isEmptyValue(left);\n        case \"eq\":\n            return equals(left, values[0] ?? \"\");\n        case \"ne\":\n            return !equals(left, values[0] ?? \"\");\n        case \"contains\":\n            return String(left ?? \"\")\n                .toLowerCase()\n                .includes((values[0] ?? \"\").toLowerCase());\n        case \"in\":\n            return values.some((value) => equals(left, value));\n        case \"between\": {\n            const [first = \"\", second = \"\"] = values;\n            const low = compare(left, first);\n            const high = compare(left, second);\n            if (low === null || high === null) return false;\n            return low >= 0 && high <= 0;\n        }\n        default: {\n            const result = compare(left, values[0] ?? \"\");\n            if (result === null) return false;\n            if (operator === \"gt\") return result > 0;\n            if (operator === \"gte\") return result >= 0;\n            if (operator === \"lt\") return result < 0;\n            return result <= 0;\n        }\n    }\n}\n\n/**\n * Order the two values of a `between` so the range is never empty by accident.\n *\n * A person who picks the later date first means the range between the two dates,\n * not \"no rows\". The server-side `BETWEEN` needs `(lo, hi)` in order too, which\n * is why the normalisation lives here and is shared by `filtersToQueryParams`.\n *\n * @param values - The raw pair.\n * @returns The pair, ascending.\n */\nexport function orderRange(values: readonly string[]): string[] {\n    const [first = \"\", second = \"\"] = values;\n    if (DATE_ONLY.test(first) && DATE_ONLY.test(second)) {\n        return first <= second ? [first, second] : [second, first];\n    }\n    const low = Number(first);\n    const high = Number(second);\n    if (!Number.isNaN(low) && !Number.isNaN(high)) {\n        return low <= high ? [first, second] : [second, first];\n    }\n    return first.localeCompare(second, undefined, { numeric: true }) <= 0\n        ? [first, second]\n        : [second, first];\n}\n\n/**\n * Run a filter set over an in-memory list.\n *\n * Closes the loop `FilterBar` opens: the bar produces `Filter[]`, this applies\n * them. Filters combine with `AND`, matching the flat model the bar builds, and\n * an incomplete filter is skipped rather than treated as a match of nothing — a\n * half-filled form should not empty the table underneath it.\n *\n * Comparison follows the row's type, not the filter's: numbers compare\n * numerically, dates compare by day, and everything else compares as text with\n * `numeric: true` so `\"item 2\"` lands before `\"item 10\"`.\n *\n * A few behaviours differ from the SQL the server-side twin produces, and the\n * difference is deliberate rather than accidental:\n *\n * - `ne` matches rows whose value is absent. In SQL, `column <> 'x'` is `NULL`\n *   for a `NULL` column and the row drops out. Here \"is not paid\" shows the rows\n *   with no status at all, which is what the chip claims.\n * - `empty` matches `NULL`, blank text and empty lists; `__isnull` on the server\n *   only matches `NULL`. A column that stores `\"\"` instead of `NULL` is where\n *   the two disagree.\n *\n * @example\n * const visible = applyFilters(orders, filters);\n *\n * @param items - The full list.\n * @param filters - Applied filters; incomplete ones are ignored.\n * @returns A new array with the rows that satisfy every complete filter.\n */\nexport function applyFilters<T>(items: readonly T[], filters: readonly Filter[]): T[] {\n    const active = filters.filter(isComplete);\n    if (active.length === 0) return [...items];\n\n    return items.filter((item) =>\n        active.every((filter) => {\n            const left = readField(item, filter.field);\n            if (isValueless(filter.operator)) {\n                return matchesOperator(filter.operator, left, []);\n            }\n            const values =\n                filter.operator === \"between\" ? orderRange(valuesOf(filter)) : valuesOf(filter);\n            return matchesOperator(filter.operator, left, values);\n        }),\n    );\n}\n"],"mappings":"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"}

package/dist/components/FilterBar/filter-query.cjs

@@ -0,0 +1,2 @@
+const e=require("./filter-model.cjs"),t=require("./filter-apply.cjs");var n={eq:``,ne:`__ne`,contains:`__icontains`,gt:`__gt`,gte:`__gte`,lt:`__lt`,lte:`__lte`,between:`__between`,in:`__in`,empty:`__isnull`,notEmpty:`__isnull`},r=`name`;function i(i){let a=new URLSearchParams;for(let o of i){if(!e.isComplete(o))continue;let i=n[o.operator],s=o.operator===`eq`&&o.field===r?`${o.field}__iexact`:`${o.field}${i}`;if(o.operator===`empty`||o.operator===`notEmpty`){a.append(s,o.operator===`empty`?`true`:`false`);continue}let c=Array.isArray(o.value)?[...o.value]:[String(o.value??``)];if(o.operator===`between`){for(let e of t.orderRange(c))a.append(s,e);continue}for(let e of c)a.append(s,e)}return a}exports.filtersToQueryParams=i;
+//# sourceMappingURL=filter-query.cjs.map

package/dist/components/FilterBar/filter-query.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-query.cjs","names":[],"sources":["../../../src/components/FilterBar/filter-query.ts"],"sourcesContent":["// Server-side half of the filter model: the same `Filter[]` the bar produces,\n// encoded the way a paginated backend expects to read it. Kept apart from\n// `filtersToSearchParams` (filter-model.ts) because the two answer different\n// questions — that one round-trips the UI state through the URL, this one talks\n// to an API and its shape is the API's, not ours.\n\nimport type { Filter, FilterOperator } from \"./filter-model\";\nimport { isComplete } from \"./filter-model\";\nimport { orderRange } from \"./filter-apply\";\n\n/**\n * Operator suffix per filter operator, following the `<column>__<op>` convention\n * of `tempest-fastapi-sdk`.\n *\n * Ported from `build_filter_condition` in\n * `tempest_fastapi_sdk/db/expressions.py`, which is what `BaseRepository`\n * dict filters and `Q` both resolve through. An empty suffix means the bare\n * column name, which that function resolves to plain equality.\n *\n * `contains` maps to `icontains` (case-insensitive, and the backend escapes the\n * `LIKE` wildcards) and both emptiness operators map to `isnull`, whose value\n * carries the direction.\n */\nconst OPERATOR_SUFFIX: Record<FilterOperator, string> = {\n    eq: \"\",\n    ne: \"__ne\",\n    contains: \"__icontains\",\n    gt: \"__gt\",\n    gte: \"__gte\",\n    lt: \"__lt\",\n    lte: \"__lte\",\n    between: \"__between\",\n    in: \"__in\",\n    empty: \"__isnull\",\n    notEmpty: \"__isnull\",\n};\n\n/**\n * Column name the backend treats as a substring search when it carries no\n * operator suffix.\n *\n * Ported from `build_filter_condition`, which special-cases a string `name` into\n * `ILIKE %value%`. Sending a bare `name=` for an `eq` filter would therefore ask\n * for \"contains\" while the chip says \"is\", so `eq` on this column is emitted as\n * `name__iexact` instead.\n */\nconst SUBSTRING_COLUMN = \"name\";\n\n/**\n * Encode filters as query params for a paginated backend.\n *\n * The counterpart of {@link applyFilters}: same filter set, evaluated by the\n * database instead of by the browser, which is the only option once the list is\n * paginated on the server and the page in memory is not the whole result.\n *\n * The encoding is the `<column>__<op>` convention `tempest-fastapi-sdk` already\n * reads (`BaseRepository._apply_filters` → `build_filter_condition`):\n *\n * | Operator | Param |\n * | --- | --- |\n * | `eq` | `field` (or `field__iexact` for the `name` column) |\n * | `ne` | `field__ne` |\n * | `contains` | `field__icontains` |\n * | `gt` `gte` `lt` `lte` | `field__gt` … `field__lte` |\n * | `between` | `field__between` twice, low value first |\n * | `in` | `field__in` once per value |\n * | `empty` / `notEmpty` | `field__isnull=true` / `=false` |\n *\n * Returns `URLSearchParams` rather than a plain object because `between` carries\n * a pair and `in` carries a list: an object would keep only the last value of\n * each, silently narrowing the filter. Repeated params are also how FastAPI\n * receives a `list[str]` declared with `Query`.\n *\n * Two things the backend has to hold up its end of, or the filter fails quietly:\n *\n * - **Every key must be declared.** `BasePaginationFilterSchema.get_conditions()`\n *   only forwards fields the subclass declares, so a `status__ne` the schema\n *   never mentions is dropped by FastAPI before the repository sees it — no\n *   error, no filtering.\n * - **`isnull` matches `NULL` only.** A column that stores `\"\"` for \"no value\"\n *   will not answer an `empty` filter, while {@link applyFilters} treats blank\n *   text as empty.\n *\n * @example\n * const params = filtersToQueryParams(filters);\n * params.set(\"page\", String(page));\n * const data = await api.get(`/orders?${params}`);\n *\n * @param filters - Applied filters; incomplete ones are ignored.\n * @returns Params ready to append to a request URL.\n */\nexport function filtersToQueryParams(filters: readonly Filter[]): URLSearchParams {\n    const params = new URLSearchParams();\n\n    for (const filter of filters) {\n        if (!isComplete(filter)) continue;\n\n        const suffix = OPERATOR_SUFFIX[filter.operator];\n        const key =\n            filter.operator === \"eq\" && filter.field === SUBSTRING_COLUMN\n                ? `${filter.field}__iexact`\n                : `${filter.field}${suffix}`;\n\n        if (filter.operator === \"empty\" || filter.operator === \"notEmpty\") {\n            params.append(key, filter.operator === \"empty\" ? \"true\" : \"false\");\n            continue;\n        }\n\n        const values = Array.isArray(filter.value)\n            ? [...filter.value]\n            : [String(filter.value ?? \"\")];\n\n        if (filter.operator === \"between\") {\n            for (const value of orderRange(values)) params.append(key, value);\n            continue;\n        }\n\n        for (const value of values) params.append(key, value);\n    }\n\n    return params;\n}\n"],"mappings":"sEAuBA,IAAM,EAAkD,CACpD,GAAI,GACJ,GAAI,OACJ,SAAU,cACV,GAAI,OACJ,IAAK,QACL,GAAI,OACJ,IAAK,QACL,QAAS,YACT,GAAI,OACJ,MAAO,WACP,SAAU,UACd,EAWM,EAAmB,OA6CzB,SAAgB,EAAqB,EAA6C,CAC9E,IAAM,EAAS,IAAI,gBAEnB,IAAK,IAAM,KAAU,EAAS,CAC1B,GAAI,CAAC,EAAA,WAAW,CAAM,EAAG,SAEzB,IAAM,EAAS,EAAgB,EAAO,UAChC,EACF,EAAO,WAAa,MAAQ,EAAO,QAAU,EACvC,GAAG,EAAO,MAAM,UAChB,GAAG,EAAO,QAAQ,IAE5B,GAAI,EAAO,WAAa,SAAW,EAAO,WAAa,WAAY,CAC/D,EAAO,OAAO,EAAK,EAAO,WAAa,QAAU,OAAS,OAAO,EACjE,QACJ,CAEA,IAAM,EAAS,MAAM,QAAQ,EAAO,KAAK,EACnC,CAAC,GAAG,EAAO,KAAK,EAChB,CAAC,OAAO,EAAO,OAAS,EAAE,CAAC,EAEjC,GAAI,EAAO,WAAa,UAAW,CAC/B,IAAK,IAAM,KAAS,EAAA,WAAW,CAAM,EAAG,EAAO,OAAO,EAAK,CAAK,EAChE,QACJ,CAEA,IAAK,IAAM,KAAS,EAAQ,EAAO,OAAO,EAAK,CAAK,CACxD,CAEA,OAAO,CACX"}

package/dist/components/FilterBar/filter-query.js

@@ -0,0 +1,38 @@
+import { isComplete as e } from "./filter-model.js";
+import { orderRange as t } from "./filter-apply.js";
+//#region src/components/FilterBar/filter-query.ts
+var n = {
+	eq: "",
+	ne: "__ne",
+	contains: "__icontains",
+	gt: "__gt",
+	gte: "__gte",
+	lt: "__lt",
+	lte: "__lte",
+	between: "__between",
+	in: "__in",
+	empty: "__isnull",
+	notEmpty: "__isnull"
+}, r = "name";
+function i(i) {
+	let a = new URLSearchParams();
+	for (let o of i) {
+		if (!e(o)) continue;
+		let i = n[o.operator], s = o.operator === "eq" && o.field === r ? `${o.field}__iexact` : `${o.field}${i}`;
+		if (o.operator === "empty" || o.operator === "notEmpty") {
+			a.append(s, o.operator === "empty" ? "true" : "false");
+			continue;
+		}
+		let c = Array.isArray(o.value) ? [...o.value] : [String(o.value ?? "")];
+		if (o.operator === "between") {
+			for (let e of t(c)) a.append(s, e);
+			continue;
+		}
+		for (let e of c) a.append(s, e);
+	}
+	return a;
+}
+//#endregion
+export { i as filtersToQueryParams };
+
+//# sourceMappingURL=filter-query.js.map

package/dist/components/FilterBar/filter-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-query.js","names":[],"sources":["../../../src/components/FilterBar/filter-query.ts"],"sourcesContent":["// Server-side half of the filter model: the same `Filter[]` the bar produces,\n// encoded the way a paginated backend expects to read it. Kept apart from\n// `filtersToSearchParams` (filter-model.ts) because the two answer different\n// questions — that one round-trips the UI state through the URL, this one talks\n// to an API and its shape is the API's, not ours.\n\nimport type { Filter, FilterOperator } from \"./filter-model\";\nimport { isComplete } from \"./filter-model\";\nimport { orderRange } from \"./filter-apply\";\n\n/**\n * Operator suffix per filter operator, following the `<column>__<op>` convention\n * of `tempest-fastapi-sdk`.\n *\n * Ported from `build_filter_condition` in\n * `tempest_fastapi_sdk/db/expressions.py`, which is what `BaseRepository`\n * dict filters and `Q` both resolve through. An empty suffix means the bare\n * column name, which that function resolves to plain equality.\n *\n * `contains` maps to `icontains` (case-insensitive, and the backend escapes the\n * `LIKE` wildcards) and both emptiness operators map to `isnull`, whose value\n * carries the direction.\n */\nconst OPERATOR_SUFFIX: Record<FilterOperator, string> = {\n    eq: \"\",\n    ne: \"__ne\",\n    contains: \"__icontains\",\n    gt: \"__gt\",\n    gte: \"__gte\",\n    lt: \"__lt\",\n    lte: \"__lte\",\n    between: \"__between\",\n    in: \"__in\",\n    empty: \"__isnull\",\n    notEmpty: \"__isnull\",\n};\n\n/**\n * Column name the backend treats as a substring search when it carries no\n * operator suffix.\n *\n * Ported from `build_filter_condition`, which special-cases a string `name` into\n * `ILIKE %value%`. Sending a bare `name=` for an `eq` filter would therefore ask\n * for \"contains\" while the chip says \"is\", so `eq` on this column is emitted as\n * `name__iexact` instead.\n */\nconst SUBSTRING_COLUMN = \"name\";\n\n/**\n * Encode filters as query params for a paginated backend.\n *\n * The counterpart of {@link applyFilters}: same filter set, evaluated by the\n * database instead of by the browser, which is the only option once the list is\n * paginated on the server and the page in memory is not the whole result.\n *\n * The encoding is the `<column>__<op>` convention `tempest-fastapi-sdk` already\n * reads (`BaseRepository._apply_filters` → `build_filter_condition`):\n *\n * | Operator | Param |\n * | --- | --- |\n * | `eq` | `field` (or `field__iexact` for the `name` column) |\n * | `ne` | `field__ne` |\n * | `contains` | `field__icontains` |\n * | `gt` `gte` `lt` `lte` | `field__gt` … `field__lte` |\n * | `between` | `field__between` twice, low value first |\n * | `in` | `field__in` once per value |\n * | `empty` / `notEmpty` | `field__isnull=true` / `=false` |\n *\n * Returns `URLSearchParams` rather than a plain object because `between` carries\n * a pair and `in` carries a list: an object would keep only the last value of\n * each, silently narrowing the filter. Repeated params are also how FastAPI\n * receives a `list[str]` declared with `Query`.\n *\n * Two things the backend has to hold up its end of, or the filter fails quietly:\n *\n * - **Every key must be declared.** `BasePaginationFilterSchema.get_conditions()`\n *   only forwards fields the subclass declares, so a `status__ne` the schema\n *   never mentions is dropped by FastAPI before the repository sees it — no\n *   error, no filtering.\n * - **`isnull` matches `NULL` only.** A column that stores `\"\"` for \"no value\"\n *   will not answer an `empty` filter, while {@link applyFilters} treats blank\n *   text as empty.\n *\n * @example\n * const params = filtersToQueryParams(filters);\n * params.set(\"page\", String(page));\n * const data = await api.get(`/orders?${params}`);\n *\n * @param filters - Applied filters; incomplete ones are ignored.\n * @returns Params ready to append to a request URL.\n */\nexport function filtersToQueryParams(filters: readonly Filter[]): URLSearchParams {\n    const params = new URLSearchParams();\n\n    for (const filter of filters) {\n        if (!isComplete(filter)) continue;\n\n        const suffix = OPERATOR_SUFFIX[filter.operator];\n        const key =\n            filter.operator === \"eq\" && filter.field === SUBSTRING_COLUMN\n                ? `${filter.field}__iexact`\n                : `${filter.field}${suffix}`;\n\n        if (filter.operator === \"empty\" || filter.operator === \"notEmpty\") {\n            params.append(key, filter.operator === \"empty\" ? \"true\" : \"false\");\n            continue;\n        }\n\n        const values = Array.isArray(filter.value)\n            ? [...filter.value]\n            : [String(filter.value ?? \"\")];\n\n        if (filter.operator === \"between\") {\n            for (const value of orderRange(values)) params.append(key, value);\n            continue;\n        }\n\n        for (const value of values) params.append(key, value);\n    }\n\n    return params;\n}\n"],"mappings":";;;AAuBA,IAAM,IAAkD;CACpD,IAAI;CACJ,IAAI;CACJ,UAAU;CACV,IAAI;CACJ,KAAK;CACL,IAAI;CACJ,KAAK;CACL,SAAS;CACT,IAAI;CACJ,OAAO;CACP,UAAU;AACd,GAWM,IAAmB;AA6CzB,SAAgB,EAAqB,GAA6C;CAC9E,IAAM,IAAS,IAAI,gBAAgB;CAEnC,KAAK,IAAM,KAAU,GAAS;EAC1B,IAAI,CAAC,EAAW,CAAM,GAAG;EAEzB,IAAM,IAAS,EAAgB,EAAO,WAChC,IACF,EAAO,aAAa,QAAQ,EAAO,UAAU,IACvC,GAAG,EAAO,MAAM,YAChB,GAAG,EAAO,QAAQ;EAE5B,IAAI,EAAO,aAAa,WAAW,EAAO,aAAa,YAAY;GAC/D,EAAO,OAAO,GAAK,EAAO,aAAa,UAAU,SAAS,OAAO;GACjE;EACJ;EAEA,IAAM,IAAS,MAAM,QAAQ,EAAO,KAAK,IACnC,CAAC,GAAG,EAAO,KAAK,IAChB,CAAC,OAAO,EAAO,SAAS,EAAE,CAAC;EAEjC,IAAI,EAAO,aAAa,WAAW;GAC/B,KAAK,IAAM,KAAS,EAAW,CAAM,GAAG,EAAO,OAAO,GAAK,CAAK;GAChE;EACJ;EAEA,KAAK,IAAM,KAAS,GAAQ,EAAO,OAAO,GAAK,CAAK;CACxD;CAEA,OAAO;AACX"}

package/dist/hooks/use-countdown.cjs

@@ -0,0 +1,2 @@
+let e=require("react");function t(t,n,r={}){let{tickMs:i=1e3}=r,a=(0,e.useCallback)(()=>Math.max(0,t-(Date.now()-n)),[t,n]),[o,s]=(0,e.useState)(a);return(0,e.useEffect)(()=>{let e=a();if(s(e),e<=0)return;let t=setInterval(()=>{let e=a();s(e),e<=0&&clearInterval(t)},i);return()=>clearInterval(t)},[a,i]),o}exports.useCountdown=t;
+//# sourceMappingURL=use-countdown.cjs.map

package/dist/hooks/use-countdown.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-countdown.cjs","names":[],"sources":["../../src/hooks/use-countdown.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/** Options for {@link useCountdown}. */\nexport interface UseCountdownOptions {\n    /**\n     * How often the remaining time is recomputed, in ms. Default `1000`, which\n     * suits a \"try again in 3s\" label; drop it to ~50 to drive a progress bar.\n     */\n    tickMs?: number;\n}\n\n/**\n * Counts down the time left on a window that started at a known instant.\n *\n * Written around a timestamp rather than a decrementing counter on purpose: the\n * remaining time is recomputed from `Date.now()` on every tick, so a throttled\n * background tab, a slow frame or a `setInterval` that drifts cannot make the\n * countdown disagree with the clock. Remounting recovers the correct value too,\n * which a counter held in state cannot do.\n *\n * The interval stops once it reaches zero instead of ticking forever behind a\n * clamp.\n *\n * @param durationMs - Length of the window.\n * @param startedAt - Epoch ms the window opened (`Date.now()` when it started).\n * @param options - Tick cadence.\n * @returns Milliseconds remaining, never below `0`.\n *\n * @example\n * const remaining = useCountdown(60_000, lastSentAt);\n *\n * <button disabled={remaining > 0}>\n *   {remaining > 0 ? `Reenviar em ${Math.ceil(remaining / 1000)}s` : \"Reenviar código\"}\n * </button>\n */\nexport function useCountdown(\n    durationMs: number,\n    startedAt: number,\n    options: UseCountdownOptions = {},\n): number {\n    const { tickMs = 1000 } = options;\n\n    const compute = useCallback(\n        () => Math.max(0, durationMs - (Date.now() - startedAt)),\n        [durationMs, startedAt],\n    );\n\n    const [remaining, setRemaining] = useState(compute);\n\n    useEffect(() => {\n        const initial = compute();\n        setRemaining(initial);\n        if (initial <= 0) return;\n\n        const id = setInterval(() => {\n            const next = compute();\n            setRemaining(next);\n            if (next <= 0) clearInterval(id);\n        }, tickMs);\n\n        return () => clearInterval(id);\n    }, [compute, tickMs]);\n\n    return remaining;\n}\n"],"mappings":"uBAmCA,SAAgB,EACZ,EACA,EACA,EAA+B,CAAC,EAC1B,CACN,GAAM,CAAE,SAAS,KAAS,EAEpB,GAAA,EAAU,EAAA,YAAA,KACN,KAAK,IAAI,EAAG,GAAc,KAAK,IAAI,EAAI,EAAU,EACvD,CAAC,EAAY,CAAS,CAC1B,EAEM,CAAC,EAAW,IAAA,EAAgB,EAAA,SAAA,CAAS,CAAO,EAgBlD,OAdA,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAU,EAAQ,EAExB,GADA,EAAa,CAAO,EAChB,GAAW,EAAG,OAElB,IAAM,EAAK,gBAAkB,CACzB,IAAM,EAAO,EAAQ,EACrB,EAAa,CAAI,EACb,GAAQ,GAAG,cAAc,CAAE,CACnC,EAAG,CAAM,EAET,UAAa,cAAc,CAAE,CACjC,EAAG,CAAC,EAAS,CAAM,CAAC,EAEb,CACX"}

package/dist/hooks/use-countdown.js

@@ -0,0 +1,18 @@
+import { useCallback as e, useEffect as t, useState as n } from "react";
+//#region src/hooks/use-countdown.ts
+function r(r, i, a = {}) {
+	let { tickMs: o = 1e3 } = a, s = e(() => Math.max(0, r - (Date.now() - i)), [r, i]), [c, l] = n(s);
+	return t(() => {
+		let e = s();
+		if (l(e), e <= 0) return;
+		let t = setInterval(() => {
+			let e = s();
+			l(e), e <= 0 && clearInterval(t);
+		}, o);
+		return () => clearInterval(t);
+	}, [s, o]), c;
+}
+//#endregion
+export { r as useCountdown };
+
+//# sourceMappingURL=use-countdown.js.map

package/dist/hooks/use-countdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-countdown.js","names":[],"sources":["../../src/hooks/use-countdown.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/** Options for {@link useCountdown}. */\nexport interface UseCountdownOptions {\n    /**\n     * How often the remaining time is recomputed, in ms. Default `1000`, which\n     * suits a \"try again in 3s\" label; drop it to ~50 to drive a progress bar.\n     */\n    tickMs?: number;\n}\n\n/**\n * Counts down the time left on a window that started at a known instant.\n *\n * Written around a timestamp rather than a decrementing counter on purpose: the\n * remaining time is recomputed from `Date.now()` on every tick, so a throttled\n * background tab, a slow frame or a `setInterval` that drifts cannot make the\n * countdown disagree with the clock. Remounting recovers the correct value too,\n * which a counter held in state cannot do.\n *\n * The interval stops once it reaches zero instead of ticking forever behind a\n * clamp.\n *\n * @param durationMs - Length of the window.\n * @param startedAt - Epoch ms the window opened (`Date.now()` when it started).\n * @param options - Tick cadence.\n * @returns Milliseconds remaining, never below `0`.\n *\n * @example\n * const remaining = useCountdown(60_000, lastSentAt);\n *\n * <button disabled={remaining > 0}>\n *   {remaining > 0 ? `Reenviar em ${Math.ceil(remaining / 1000)}s` : \"Reenviar código\"}\n * </button>\n */\nexport function useCountdown(\n    durationMs: number,\n    startedAt: number,\n    options: UseCountdownOptions = {},\n): number {\n    const { tickMs = 1000 } = options;\n\n    const compute = useCallback(\n        () => Math.max(0, durationMs - (Date.now() - startedAt)),\n        [durationMs, startedAt],\n    );\n\n    const [remaining, setRemaining] = useState(compute);\n\n    useEffect(() => {\n        const initial = compute();\n        setRemaining(initial);\n        if (initial <= 0) return;\n\n        const id = setInterval(() => {\n            const next = compute();\n            setRemaining(next);\n            if (next <= 0) clearInterval(id);\n        }, tickMs);\n\n        return () => clearInterval(id);\n    }, [compute, tickMs]);\n\n    return remaining;\n}\n"],"mappings":";;AAmCA,SAAgB,EACZ,GACA,GACA,IAA+B,CAAC,GAC1B;CACN,IAAM,EAAE,YAAS,QAAS,GAEpB,IAAU,QACN,KAAK,IAAI,GAAG,KAAc,KAAK,IAAI,IAAI,EAAU,GACvD,CAAC,GAAY,CAAS,CAC1B,GAEM,CAAC,GAAW,KAAgB,EAAS,CAAO;CAgBlD,OAdA,QAAgB;EACZ,IAAM,IAAU,EAAQ;EAExB,IADA,EAAa,CAAO,GAChB,KAAW,GAAG;EAElB,IAAM,IAAK,kBAAkB;GACzB,IAAM,IAAO,EAAQ;GAErB,AADA,EAAa,CAAI,GACb,KAAQ,KAAG,cAAc,CAAE;EACnC,GAAG,CAAM;EAET,aAAa,cAAc,CAAE;CACjC,GAAG,CAAC,GAAS,CAAM,CAAC,GAEb;AACX"}

package/dist/hooks/use-latest-ref.cjs

@@ -0,0 +1,2 @@
+let e=require("react");function t(t){let n=(0,e.useRef)(t);return n.current=t,n}exports.useLatestRef=t;
+//# sourceMappingURL=use-latest-ref.cjs.map

package/dist/hooks/use-latest-ref.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-latest-ref.cjs","names":[],"sources":["../../src/hooks/use-latest-ref.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- writing at render time is deliberate; an effect would add a staleness window (see the docstring) */\nimport { useRef, type RefObject } from \"react\";\n\n/**\n * Keeps a ref pointing at the most recent value it was given.\n *\n * The escape hatch for reading fresh state inside something that must not be\n * re-created when that state changes: an interval, a subscription, an event\n * listener registered once on mount. Listing the value in the effect's\n * dependencies would tear the effect down and set it back up on every change;\n * omitting it captures the value from the render that created the closure and\n * never sees another. The ref is neither — a stable object whose `current` is\n * always current.\n *\n * The assignment happens **during render**, for the same reason\n * {@link useStableCallback} does it: moving it into an effect opens a\n * one-commit staleness window, where an effect declared earlier in the same\n * commit reads the previous render's value.\n *\n * Reach for {@link useStableCallback} instead when the value is a function you\n * want to *call* — it hands back a callable with a stable identity, rather than\n * making every call site reach through `.current`.\n *\n * @typeParam T - The tracked value.\n * @param value - The value to track. Written on every render.\n * @returns A stable ref whose `current` holds the latest `value`.\n *\n * @example\n * const optionsRef = useLatestRef(options);\n *\n * useEffect(() => {\n *   const id = setInterval(() => poll(optionsRef.current), 5_000);\n *   return () => clearInterval(id);\n * }, []); // the interval survives every options change, and still reads the latest\n */\nexport function useLatestRef<T>(value: T): RefObject<T> {\n    const ref = useRef(value);\n    ref.current = value;\n    return ref;\n}\n"],"mappings":"uBAmCA,SAAgB,EAAgB,EAAwB,CACpD,IAAM,GAAA,EAAM,EAAA,OAAA,CAAO,CAAK,EAExB,MADA,GAAI,QAAU,EACP,CACX"}

package/dist/hooks/use-latest-ref.js

@@ -0,0 +1,10 @@
+import { useRef as e } from "react";
+//#region src/hooks/use-latest-ref.ts
+function t(t) {
+	let n = e(t);
+	return n.current = t, n;
+}
+//#endregion
+export { t as useLatestRef };
+
+//# sourceMappingURL=use-latest-ref.js.map

package/dist/hooks/use-latest-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-latest-ref.js","names":[],"sources":["../../src/hooks/use-latest-ref.ts"],"sourcesContent":["/* eslint-disable react-hooks/refs -- writing at render time is deliberate; an effect would add a staleness window (see the docstring) */\nimport { useRef, type RefObject } from \"react\";\n\n/**\n * Keeps a ref pointing at the most recent value it was given.\n *\n * The escape hatch for reading fresh state inside something that must not be\n * re-created when that state changes: an interval, a subscription, an event\n * listener registered once on mount. Listing the value in the effect's\n * dependencies would tear the effect down and set it back up on every change;\n * omitting it captures the value from the render that created the closure and\n * never sees another. The ref is neither — a stable object whose `current` is\n * always current.\n *\n * The assignment happens **during render**, for the same reason\n * {@link useStableCallback} does it: moving it into an effect opens a\n * one-commit staleness window, where an effect declared earlier in the same\n * commit reads the previous render's value.\n *\n * Reach for {@link useStableCallback} instead when the value is a function you\n * want to *call* — it hands back a callable with a stable identity, rather than\n * making every call site reach through `.current`.\n *\n * @typeParam T - The tracked value.\n * @param value - The value to track. Written on every render.\n * @returns A stable ref whose `current` holds the latest `value`.\n *\n * @example\n * const optionsRef = useLatestRef(options);\n *\n * useEffect(() => {\n *   const id = setInterval(() => poll(optionsRef.current), 5_000);\n *   return () => clearInterval(id);\n * }, []); // the interval survives every options change, and still reads the latest\n */\nexport function useLatestRef<T>(value: T): RefObject<T> {\n    const ref = useRef(value);\n    ref.current = value;\n    return ref;\n}\n"],"mappings":";;AAmCA,SAAgB,EAAgB,GAAwB;CACpD,IAAM,IAAM,EAAO,CAAK;CAExB,OADA,EAAI,UAAU,GACP;AACX"}

package/dist/hooks/use-typewriter.cjs

@@ -0,0 +1,2 @@
+let e=require("react");function t(t,n){let r=t??``,i=n>0?0:r.length,[a,o]=(0,e.useState)(r),[s,c]=(0,e.useState)(i);a!==r&&(o(r),c(i)),(0,e.useEffect)(()=>{if(n<=0||r.length===0){c(r.length);return}let e=setInterval(()=>{c(t=>{let n=t+1;return n>=r.length?(clearInterval(e),r.length):n})},n);return()=>clearInterval(e)},[r,n]);let l=(0,e.useCallback)(()=>c(r.length),[r.length]);return{displayedText:r.slice(0,s),isComplete:s>=r.length,skip:l}}exports.useTypewriter=t;
+//# sourceMappingURL=use-typewriter.cjs.map

package/dist/hooks/use-typewriter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-typewriter.cjs","names":[],"sources":["../../src/hooks/use-typewriter.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/** State returned by {@link useTypewriter}. */\nexport interface UseTypewriterResult {\n    /** The prefix of `text` revealed so far. */\n    displayedText: string;\n    /** `true` once the whole string is on screen. */\n    isComplete: boolean;\n    /** Reveal the rest immediately — wire it to a tap or a key press. */\n    skip: () => void;\n}\n\n/**\n * Reveals a string one character at a time.\n *\n * Changing `text` restarts the reveal. The reset happens during render rather\n * than in an effect, so the new string never flashes in full for one frame\n * before the animation takes over.\n *\n * Always give the reader a way out: an animation that cannot be skipped is a\n * tax on anyone re-reading or moving fast, which is what `skip` is for.\n *\n * @param text - The full string to reveal. Nullish is treated as empty.\n * @param speedMs - Delay between characters. `0` or less renders instantly,\n *   which is the hook-safe way to honour `prefers-reduced-motion`.\n * @returns The revealed prefix, whether it finished, and a `skip` action.\n *\n * @example\n * const reduced = useMediaQuery(\"(prefers-reduced-motion: reduce)\");\n * const { displayedText, isComplete, skip } = useTypewriter(line, reduced ? 0 : 30);\n *\n * return <p onClick={skip}>{displayedText}{isComplete ? \"\" : \"▌\"}</p>;\n */\nexport function useTypewriter(text: string, speedMs: number): UseTypewriterResult {\n    const safeText = text ?? \"\";\n    const initialCount = speedMs > 0 ? 0 : safeText.length;\n\n    const [renderedText, setRenderedText] = useState(safeText);\n    const [count, setCount] = useState(initialCount);\n\n    if (renderedText !== safeText) {\n        setRenderedText(safeText);\n        setCount(initialCount);\n    }\n\n    useEffect(() => {\n        if (speedMs <= 0 || safeText.length === 0) {\n            setCount(safeText.length);\n            return;\n        }\n\n        const id = setInterval(() => {\n            setCount((current) => {\n                const next = current + 1;\n                if (next >= safeText.length) {\n                    clearInterval(id);\n                    return safeText.length;\n                }\n                return next;\n            });\n        }, speedMs);\n\n        return () => clearInterval(id);\n    }, [safeText, speedMs]);\n\n    const skip = useCallback(() => setCount(safeText.length), [safeText.length]);\n\n    return {\n        displayedText: safeText.slice(0, count),\n        isComplete: count >= safeText.length,\n        skip,\n    };\n}\n"],"mappings":"uBAiCA,SAAgB,EAAc,EAAc,EAAsC,CAC9E,IAAM,EAAW,GAAQ,GACnB,EAAe,EAAU,EAAI,EAAI,EAAS,OAE1C,CAAC,EAAc,IAAA,EAAmB,EAAA,SAAA,CAAS,CAAQ,EACnD,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,CAAS,CAAY,EAE3C,IAAiB,IACjB,EAAgB,CAAQ,EACxB,EAAS,CAAY,IAGzB,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,GAAW,GAAK,EAAS,SAAW,EAAG,CACvC,EAAS,EAAS,MAAM,EACxB,MACJ,CAEA,IAAM,EAAK,gBAAkB,CACzB,EAAU,GAAY,CAClB,IAAM,EAAO,EAAU,EAKvB,OAJI,GAAQ,EAAS,QACjB,cAAc,CAAE,EACT,EAAS,QAEb,CACX,CAAC,CACL,EAAG,CAAO,EAEV,UAAa,cAAc,CAAE,CACjC,EAAG,CAAC,EAAU,CAAO,CAAC,EAEtB,IAAM,GAAA,EAAO,EAAA,YAAA,KAAkB,EAAS,EAAS,MAAM,EAAG,CAAC,EAAS,MAAM,CAAC,EAE3E,MAAO,CACH,cAAe,EAAS,MAAM,EAAG,CAAK,EACtC,WAAY,GAAS,EAAS,OAC9B,MACJ,CACJ"}

package/dist/hooks/use-typewriter.js

@@ -0,0 +1,28 @@
+import { useCallback as e, useEffect as t, useState as n } from "react";
+//#region src/hooks/use-typewriter.ts
+function r(r, i) {
+	let a = r ?? "", o = i > 0 ? 0 : a.length, [s, c] = n(a), [l, u] = n(o);
+	s !== a && (c(a), u(o)), t(() => {
+		if (i <= 0 || a.length === 0) {
+			u(a.length);
+			return;
+		}
+		let e = setInterval(() => {
+			u((t) => {
+				let n = t + 1;
+				return n >= a.length ? (clearInterval(e), a.length) : n;
+			});
+		}, i);
+		return () => clearInterval(e);
+	}, [a, i]);
+	let d = e(() => u(a.length), [a.length]);
+	return {
+		displayedText: a.slice(0, l),
+		isComplete: l >= a.length,
+		skip: d
+	};
+}
+//#endregion
+export { r as useTypewriter };
+
+//# sourceMappingURL=use-typewriter.js.map

package/dist/hooks/use-typewriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-typewriter.js","names":[],"sources":["../../src/hooks/use-typewriter.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\n/** State returned by {@link useTypewriter}. */\nexport interface UseTypewriterResult {\n    /** The prefix of `text` revealed so far. */\n    displayedText: string;\n    /** `true` once the whole string is on screen. */\n    isComplete: boolean;\n    /** Reveal the rest immediately — wire it to a tap or a key press. */\n    skip: () => void;\n}\n\n/**\n * Reveals a string one character at a time.\n *\n * Changing `text` restarts the reveal. The reset happens during render rather\n * than in an effect, so the new string never flashes in full for one frame\n * before the animation takes over.\n *\n * Always give the reader a way out: an animation that cannot be skipped is a\n * tax on anyone re-reading or moving fast, which is what `skip` is for.\n *\n * @param text - The full string to reveal. Nullish is treated as empty.\n * @param speedMs - Delay between characters. `0` or less renders instantly,\n *   which is the hook-safe way to honour `prefers-reduced-motion`.\n * @returns The revealed prefix, whether it finished, and a `skip` action.\n *\n * @example\n * const reduced = useMediaQuery(\"(prefers-reduced-motion: reduce)\");\n * const { displayedText, isComplete, skip } = useTypewriter(line, reduced ? 0 : 30);\n *\n * return <p onClick={skip}>{displayedText}{isComplete ? \"\" : \"▌\"}</p>;\n */\nexport function useTypewriter(text: string, speedMs: number): UseTypewriterResult {\n    const safeText = text ?? \"\";\n    const initialCount = speedMs > 0 ? 0 : safeText.length;\n\n    const [renderedText, setRenderedText] = useState(safeText);\n    const [count, setCount] = useState(initialCount);\n\n    if (renderedText !== safeText) {\n        setRenderedText(safeText);\n        setCount(initialCount);\n    }\n\n    useEffect(() => {\n        if (speedMs <= 0 || safeText.length === 0) {\n            setCount(safeText.length);\n            return;\n        }\n\n        const id = setInterval(() => {\n            setCount((current) => {\n                const next = current + 1;\n                if (next >= safeText.length) {\n                    clearInterval(id);\n                    return safeText.length;\n                }\n                return next;\n            });\n        }, speedMs);\n\n        return () => clearInterval(id);\n    }, [safeText, speedMs]);\n\n    const skip = useCallback(() => setCount(safeText.length), [safeText.length]);\n\n    return {\n        displayedText: safeText.slice(0, count),\n        isComplete: count >= safeText.length,\n        skip,\n    };\n}\n"],"mappings":";;AAiCA,SAAgB,EAAc,GAAc,GAAsC;CAC9E,IAAM,IAAW,KAAQ,IACnB,IAAe,IAAU,IAAI,IAAI,EAAS,QAE1C,CAAC,GAAc,KAAmB,EAAS,CAAQ,GACnD,CAAC,GAAO,KAAY,EAAS,CAAY;CAO/C,AALI,MAAiB,MACjB,EAAgB,CAAQ,GACxB,EAAS,CAAY,IAGzB,QAAgB;EACZ,IAAI,KAAW,KAAK,EAAS,WAAW,GAAG;GACvC,EAAS,EAAS,MAAM;GACxB;EACJ;EAEA,IAAM,IAAK,kBAAkB;GACzB,GAAU,MAAY;IAClB,IAAM,IAAO,IAAU;IAKvB,OAJI,KAAQ,EAAS,UACjB,cAAc,CAAE,GACT,EAAS,UAEb;GACX,CAAC;EACL,GAAG,CAAO;EAEV,aAAa,cAAc,CAAE;CACjC,GAAG,CAAC,GAAU,CAAO,CAAC;CAEtB,IAAM,IAAO,QAAkB,EAAS,EAAS,MAAM,GAAG,CAAC,EAAS,MAAM,CAAC;CAE3E,OAAO;EACH,eAAe,EAAS,MAAM,GAAG,CAAK;EACtC,YAAY,KAAS,EAAS;EAC9B;CACJ;AACJ"}

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

@@ -0,0 +1,2 @@
+const e=require("./errors.cjs");var t={offline:`Sem conexão com o servidor. Verifique sua internet e tente de novo.`},n=`tempest.error.offline`;function r(e){return`Erro ${e}`}function i(){return typeof navigator<`u`&&navigator.onLine===!1}function a(n,a,o){let s=o?.offline??t.offline;if(e.isApiError(n)){if(n.status===0)return s;let e=n.detail.trim();return e!==``&&e!==r(n.status)?e:`${a} (HTTP ${n.status})`}return i()?s:a}exports.API_ERROR_OFFLINE_KEY=n,exports.DEFAULT_API_ERROR_STRINGS=t,exports.describeApiError=a;
+//# sourceMappingURL=describe-api-error.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"describe-api-error.cjs","names":[],"sources":["../../src/http/describe-api-error.ts"],"sourcesContent":["// The last mile of error handling: a typed error is what code reads, a sentence\n// is what a person reads, and every app was writing the funnel between the two.\n// The case everyone forgets is the request that never reached the server, which\n// without special handling renders as the nonsense \"erro 0\".\n\nimport { isApiError } from \"./errors\";\n\n/** The two fixed sentences {@link describeApiError} may need. */\nexport interface ApiErrorStrings {\n    /** Shown when the request never reached the server. */\n    offline: string;\n}\n\n/**\n * PT-BR defaults, used when no strings are supplied and no catalog answers.\n *\n * The SDK's copy is pt-BR everywhere else (`FilterBar`, `DataTable`, `Chat`), so\n * the default here matches rather than introducing an English string that only\n * shows up on a network failure.\n */\nexport const DEFAULT_API_ERROR_STRINGS: ApiErrorStrings = {\n    offline: \"Sem conexão com o servidor. Verifique sua internet e tente de novo.\",\n};\n\n/**\n * Translation key the {@link useDescribeApiError} hook looks up.\n *\n * A catalog that does not define it falls back to\n * {@link DEFAULT_API_ERROR_STRINGS}, because `t` returns the key itself when the\n * lookup misses and printing `tempest.error.offline` at the user would be worse\n * than printing pt-BR at them.\n */\nexport const API_ERROR_OFFLINE_KEY = \"tempest.error.offline\";\n\n/**\n * Detail text `buildApiError` synthesises when the response body carries none.\n *\n * Ported from `buildApiError` in `errors.ts`, which falls back to `Erro ${status}`.\n * Recognising it here is what lets the caller's `fallback` win: \"Erro 500\" says\n * strictly less than \"Não foi possível carregar os pedidos\".\n *\n * @param status - The HTTP status of the error.\n * @returns The synthetic detail for that status.\n */\nfunction syntheticDetail(status: number): string {\n    return `Erro ${status}`;\n}\n\n/**\n * Whether the browser currently reports itself as offline.\n *\n * `fetch` rejects a network failure with a plain `TypeError` whose message\n * differs per browser (\"Failed to fetch\", \"NetworkError when attempting to fetch\n * resource.\", \"Load failed\"), so sniffing the message is not portable. The online\n * flag is, and it is the signal that matters for the sentence being chosen.\n *\n * @returns `true` only when the environment positively says it is offline.\n */\nfunction browserIsOffline(): boolean {\n    return typeof navigator !== \"undefined\" && navigator.onLine === false;\n}\n\n/**\n * Turn any caught value into a sentence worth showing.\n *\n * The funnel, in order:\n *\n * 1. A request that never reached the server — `status === 0`, or a non-API\n *    error thrown while the browser reports itself offline — produces the\n *    offline sentence. This is the step apps skip, and skipping it renders\n *    \"erro 0\" or a raw `TypeError` at the user.\n * 2. The backend's own `detail`, which is the most specific thing available and\n *    is already written for a person.\n * 3. `fallback`, with `(HTTP <status>)` appended when a status is known, so the\n *    screenshot in the support ticket carries the one fact a developer needs.\n *\n * Pure on purpose: it works in an interceptor, in a logger and anywhere outside\n * the React tree. {@link useDescribeApiError} is the same funnel with the\n * sentences resolved through `I18nProvider`.\n *\n * @example\n * catch (error) {\n *     toast(describeApiError(error, \"Não foi possível salvar o pedido\"));\n * }\n *\n * @param error - The caught value, of any shape.\n * @param fallback - What to say when the error carries nothing better.\n * @param strings - Overrides for the fixed sentences.\n * @returns A sentence to show the user.\n */\nexport function describeApiError(\n    error: unknown,\n    fallback: string,\n    strings?: Partial<ApiErrorStrings>,\n): string {\n    const offline = strings?.offline ?? DEFAULT_API_ERROR_STRINGS.offline;\n\n    if (isApiError(error)) {\n        if (error.status === 0) return offline;\n        const detail = error.detail.trim();\n        if (detail !== \"\" && detail !== syntheticDetail(error.status)) return detail;\n        return `${fallback} (HTTP ${error.status})`;\n    }\n\n    if (browserIsOffline()) return offline;\n\n    return fallback;\n}\n"],"mappings":"gCAoBA,IAAa,EAA6C,CACtD,QAAS,qEACb,EAUa,EAAwB,wBAYrC,SAAS,EAAgB,EAAwB,CAC7C,MAAO,QAAQ,GACnB,CAYA,SAAS,GAA4B,CACjC,OAAO,OAAO,UAAc,KAAe,UAAU,SAAW,EACpE,CA8BA,SAAgB,EACZ,EACA,EACA,EACM,CACN,IAAM,EAAU,GAAS,SAAW,EAA0B,QAE9D,GAAI,EAAA,WAAW,CAAK,EAAG,CACnB,GAAI,EAAM,SAAW,EAAG,OAAO,EAC/B,IAAM,EAAS,EAAM,OAAO,KAAK,EAEjC,OADI,IAAW,IAAM,IAAW,EAAgB,EAAM,MAAM,EAAU,EAC/D,GAAG,EAAS,SAAS,EAAM,OAAO,EAC7C,CAIA,OAFI,EAAiB,EAAU,EAExB,CACX"}

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

@@ -0,0 +1,22 @@
+import { isApiError as e } from "./errors.js";
+//#region src/http/describe-api-error.ts
+var t = { offline: "Sem conexão com o servidor. Verifique sua internet e tente de novo." }, n = "tempest.error.offline";
+function r(e) {
+	return `Erro ${e}`;
+}
+function i() {
+	return typeof navigator < "u" && navigator.onLine === !1;
+}
+function a(n, a, o) {
+	let s = o?.offline ?? t.offline;
+	if (e(n)) {
+		if (n.status === 0) return s;
+		let e = n.detail.trim();
+		return e !== "" && e !== r(n.status) ? e : `${a} (HTTP ${n.status})`;
+	}
+	return i() ? s : a;
+}
+//#endregion
+export { n as API_ERROR_OFFLINE_KEY, t as DEFAULT_API_ERROR_STRINGS, a as describeApiError };
+
+//# sourceMappingURL=describe-api-error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"describe-api-error.js","names":[],"sources":["../../src/http/describe-api-error.ts"],"sourcesContent":["// The last mile of error handling: a typed error is what code reads, a sentence\n// is what a person reads, and every app was writing the funnel between the two.\n// The case everyone forgets is the request that never reached the server, which\n// without special handling renders as the nonsense \"erro 0\".\n\nimport { isApiError } from \"./errors\";\n\n/** The two fixed sentences {@link describeApiError} may need. */\nexport interface ApiErrorStrings {\n    /** Shown when the request never reached the server. */\n    offline: string;\n}\n\n/**\n * PT-BR defaults, used when no strings are supplied and no catalog answers.\n *\n * The SDK's copy is pt-BR everywhere else (`FilterBar`, `DataTable`, `Chat`), so\n * the default here matches rather than introducing an English string that only\n * shows up on a network failure.\n */\nexport const DEFAULT_API_ERROR_STRINGS: ApiErrorStrings = {\n    offline: \"Sem conexão com o servidor. Verifique sua internet e tente de novo.\",\n};\n\n/**\n * Translation key the {@link useDescribeApiError} hook looks up.\n *\n * A catalog that does not define it falls back to\n * {@link DEFAULT_API_ERROR_STRINGS}, because `t` returns the key itself when the\n * lookup misses and printing `tempest.error.offline` at the user would be worse\n * than printing pt-BR at them.\n */\nexport const API_ERROR_OFFLINE_KEY = \"tempest.error.offline\";\n\n/**\n * Detail text `buildApiError` synthesises when the response body carries none.\n *\n * Ported from `buildApiError` in `errors.ts`, which falls back to `Erro ${status}`.\n * Recognising it here is what lets the caller's `fallback` win: \"Erro 500\" says\n * strictly less than \"Não foi possível carregar os pedidos\".\n *\n * @param status - The HTTP status of the error.\n * @returns The synthetic detail for that status.\n */\nfunction syntheticDetail(status: number): string {\n    return `Erro ${status}`;\n}\n\n/**\n * Whether the browser currently reports itself as offline.\n *\n * `fetch` rejects a network failure with a plain `TypeError` whose message\n * differs per browser (\"Failed to fetch\", \"NetworkError when attempting to fetch\n * resource.\", \"Load failed\"), so sniffing the message is not portable. The online\n * flag is, and it is the signal that matters for the sentence being chosen.\n *\n * @returns `true` only when the environment positively says it is offline.\n */\nfunction browserIsOffline(): boolean {\n    return typeof navigator !== \"undefined\" && navigator.onLine === false;\n}\n\n/**\n * Turn any caught value into a sentence worth showing.\n *\n * The funnel, in order:\n *\n * 1. A request that never reached the server — `status === 0`, or a non-API\n *    error thrown while the browser reports itself offline — produces the\n *    offline sentence. This is the step apps skip, and skipping it renders\n *    \"erro 0\" or a raw `TypeError` at the user.\n * 2. The backend's own `detail`, which is the most specific thing available and\n *    is already written for a person.\n * 3. `fallback`, with `(HTTP <status>)` appended when a status is known, so the\n *    screenshot in the support ticket carries the one fact a developer needs.\n *\n * Pure on purpose: it works in an interceptor, in a logger and anywhere outside\n * the React tree. {@link useDescribeApiError} is the same funnel with the\n * sentences resolved through `I18nProvider`.\n *\n * @example\n * catch (error) {\n *     toast(describeApiError(error, \"Não foi possível salvar o pedido\"));\n * }\n *\n * @param error - The caught value, of any shape.\n * @param fallback - What to say when the error carries nothing better.\n * @param strings - Overrides for the fixed sentences.\n * @returns A sentence to show the user.\n */\nexport function describeApiError(\n    error: unknown,\n    fallback: string,\n    strings?: Partial<ApiErrorStrings>,\n): string {\n    const offline = strings?.offline ?? DEFAULT_API_ERROR_STRINGS.offline;\n\n    if (isApiError(error)) {\n        if (error.status === 0) return offline;\n        const detail = error.detail.trim();\n        if (detail !== \"\" && detail !== syntheticDetail(error.status)) return detail;\n        return `${fallback} (HTTP ${error.status})`;\n    }\n\n    if (browserIsOffline()) return offline;\n\n    return fallback;\n}\n"],"mappings":";;AAoBA,IAAa,IAA6C,EACtD,SAAS,sEACb,GAUa,IAAwB;AAYrC,SAAS,EAAgB,GAAwB;CAC7C,OAAO,QAAQ;AACnB;AAYA,SAAS,IAA4B;CACjC,OAAO,OAAO,YAAc,OAAe,UAAU,WAAW;AACpE;AA8BA,SAAgB,EACZ,GACA,GACA,GACM;CACN,IAAM,IAAU,GAAS,WAAW,EAA0B;CAE9D,IAAI,EAAW,CAAK,GAAG;EACnB,IAAI,EAAM,WAAW,GAAG,OAAO;EAC/B,IAAM,IAAS,EAAM,OAAO,KAAK;EAEjC,OADI,MAAW,MAAM,MAAW,EAAgB,EAAM,MAAM,IAAU,IAC/D,GAAG,EAAS,SAAS,EAAM,OAAO;CAC7C;CAIA,OAFI,EAAiB,IAAU,IAExB;AACX"}

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

@@ -0,0 +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;
+//# sourceMappingURL=use-describe-api-error.cjs.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,15 @@
+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";
+//#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]);
+}
+//#endregion
+export { a as useDescribeApiError };
+
+//# sourceMappingURL=use-describe-api-error.js.map

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

@@ -0,0 +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"}

package/dist/i18n/I18nProvider.cjs

@@ -1,2 +1,2 @@
-const e=require("./create-i18n.cjs");let t=require("react"),n=require("react/jsx-runtime");var r=(0,t.createContext)(null);function i(e,t){if(!e||typeof window>`u`)return null;try{let n=window.localStorage.getItem(e);return n&&t.includes(n)?n:null}catch{return null}}function a({children:a,locale:o,fallbackLocale:s,messages:c,storageKey:l=`tempest-locale`}){let u=(0,t.useMemo)(()=>Object.keys(c),[c]),[d,f]=(0,t.useState)(()=>i(l,u)??o);(0,t.useEffect)(()=>{typeof document<`u`&&document.documentElement.setAttribute(`lang`,d)},[d]);let p=(0,t.useCallback)(e=>{if(f(e),l&&typeof window<`u`)try{window.localStorage.setItem(l,e)}catch{}},[l]),m=(0,t.useMemo)(()=>({...e.createI18n({locale:d,fallbackLocale:s,messages:c}),setLocale:p,availableLocales:u}),[d,s,c,p,u]);return(0,n.jsx)(r.Provider,{value:m,children:a})}function o(){let e=(0,t.useContext)(r);if(!e)throw Error(`useI18n must be used inside an <I18nProvider>`);return e}function s(){return o().t}exports.I18nProvider=a,exports.useI18n=o,exports.useTranslate=s;
+const e=require("./create-i18n.cjs");let t=require("react"),n=require("react/jsx-runtime");var r=(0,t.createContext)(null);function i(e,t){if(!e||typeof window>`u`)return null;try{let n=window.localStorage.getItem(e);return n&&t.includes(n)?n:null}catch{return null}}function a({children:a,locale:o,fallbackLocale:s,messages:c,storageKey:l=`tempest-locale`}){let u=(0,t.useMemo)(()=>Object.keys(c),[c]),[d,f]=(0,t.useState)(()=>i(l,u)??o);(0,t.useEffect)(()=>{typeof document<`u`&&document.documentElement.setAttribute(`lang`,d)},[d]);let p=(0,t.useCallback)(e=>{if(f(e),l&&typeof window<`u`)try{window.localStorage.setItem(l,e)}catch{}},[l]),m=(0,t.useMemo)(()=>({...e.createI18n({locale:d,fallbackLocale:s,messages:c}),setLocale:p,availableLocales:u}),[d,s,c,p,u]);return(0,n.jsx)(r.Provider,{value:m,children:a})}function o(){let e=(0,t.useContext)(r);if(!e)throw Error(`useI18n must be used inside an <I18nProvider>`);return e}function s(){return(0,t.useContext)(r)}function c(){return o().t}exports.I18nProvider=a,exports.useI18n=o,exports.useOptionalI18n=s,exports.useTranslate=c;
 //# sourceMappingURL=I18nProvider.cjs.map

package/dist/i18n/I18nProvider.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"I18nProvider.cjs","names":[],"sources":["../../src/i18n/I18nProvider.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { createI18n, type Catalog, type I18n } from \"./create-i18n\";\n\nexport interface I18nContextValue extends I18n {\n    /** Switch the active locale. Persisted when `storageKey` is set. */\n    setLocale: (locale: string) => void;\n    /** Locales available in the catalog. */\n    availableLocales: string[];\n}\n\nconst I18nContext = createContext<I18nContextValue | null>(null);\n\nexport interface I18nProviderProps {\n    children: ReactNode;\n    /** Initial locale. */\n    locale: string;\n    /** Fallback locale used when a key is missing. */\n    fallbackLocale?: string;\n    /** Translation catalog. */\n    messages: Catalog;\n    /** localStorage key for persisting the user choice. Pass `null` to disable. Default: `\"tempest-locale\"`. */\n    storageKey?: string | null;\n}\n\nfunction readStored(storageKey: string | null, available: string[]): string | null {\n    if (!storageKey || typeof window === \"undefined\") return null;\n    try {\n        const value = window.localStorage.getItem(storageKey);\n        if (value && available.includes(value)) return value;\n        return null;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * React provider for the SDK's lightweight i18n. Exposes the translation\n * helpers and a `setLocale` setter to children.\n *\n * @tempest-limits empty-catch — remembering the chosen locale is best-effort. The\n * switch itself is React state and already happened by the time the write runs, so\n * a storage failure costs the preference on the next load and nothing in this one.\n */\nexport function I18nProvider({\n    children,\n    locale: initialLocale,\n    fallbackLocale,\n    messages,\n    storageKey = \"tempest-locale\",\n}: I18nProviderProps) {\n    const availableLocales = useMemo(() => Object.keys(messages), [messages]);\n    const [locale, setLocaleState] = useState<string>(\n        () => readStored(storageKey, availableLocales) ?? initialLocale,\n    );\n\n    useEffect(() => {\n        if (typeof document !== \"undefined\") {\n            document.documentElement.setAttribute(\"lang\", locale);\n        }\n    }, [locale]);\n\n    const setLocale = useCallback(\n        (next: string) => {\n            setLocaleState(next);\n            if (storageKey && typeof window !== \"undefined\") {\n                try {\n                    window.localStorage.setItem(storageKey, next);\n                } catch {\n                    /* empty */\n                }\n            }\n        },\n        [storageKey],\n    );\n\n    const value = useMemo<I18nContextValue>(() => {\n        const i18n = createI18n({ locale, fallbackLocale, messages });\n        return { ...i18n, setLocale, availableLocales };\n    }, [locale, fallbackLocale, messages, setLocale, availableLocales]);\n\n    return <I18nContext.Provider value={value}>{children}</I18nContext.Provider>;\n}\n\n/**\n * Access translation helpers. Must be used inside an {@link I18nProvider}.\n */\nexport function useI18n(): I18nContextValue {\n    const ctx = useContext(I18nContext);\n    if (!ctx) throw new Error(\"useI18n must be used inside an <I18nProvider>\");\n    return ctx;\n}\n\n/**\n * Shortcut for components that only need the `t` function — avoids destructuring.\n */\nexport function useTranslate(): I18nContextValue[\"t\"] {\n    return useI18n().t;\n}\n"],"mappings":"2FAWA,IAAM,GAAA,EAAc,EAAA,cAAA,CAAuC,IAAI,EAc/D,SAAS,EAAW,EAA2B,EAAoC,CAC/E,GAAI,CAAC,GAAc,OAAO,OAAW,IAAa,OAAO,KACzD,GAAI,CACA,IAAM,EAAQ,OAAO,aAAa,QAAQ,CAAU,EAEpD,OADI,GAAS,EAAU,SAAS,CAAK,EAAU,EACxC,IACX,MAAQ,CACJ,OAAO,IACX,CACJ,CAUA,SAAgB,EAAa,CACzB,WACA,OAAQ,EACR,iBACA,WACA,aAAa,kBACK,CAClB,IAAM,GAAA,EAAmB,EAAA,QAAA,KAAc,OAAO,KAAK,CAAQ,EAAG,CAAC,CAAQ,CAAC,EAClE,CAAC,EAAQ,IAAA,EAAkB,EAAA,SAAA,KACvB,EAAW,EAAY,CAAgB,GAAK,CACtD,GAEA,EAAA,EAAA,UAAA,KAAgB,CACR,OAAO,SAAa,KACpB,SAAS,gBAAgB,aAAa,OAAQ,CAAM,CAE5D,EAAG,CAAC,CAAM,CAAC,EAEX,IAAM,GAAA,EAAY,EAAA,YAAA,CACb,GAAiB,CAEd,GADA,EAAe,CAAI,EACf,GAAc,OAAO,OAAW,IAChC,GAAI,CACA,OAAO,aAAa,QAAQ,EAAY,CAAI,CAChD,MAAQ,CAER,CAER,EACA,CAAC,CAAU,CACf,EAEM,GAAA,EAAQ,EAAA,QAAA,MAEH,CAAE,GADI,EAAA,WAAW,CAAE,SAAQ,iBAAgB,UAAS,CAC/C,EAAM,YAAW,kBAAiB,GAC/C,CAAC,EAAQ,EAAgB,EAAU,EAAW,CAAgB,CAAC,EAElE,OAAO,EAAA,EAAA,IAAA,CAAC,EAAY,SAAb,CAA6B,QAAQ,UAA+B,CAAA,CAC/E,CAKA,SAAgB,GAA4B,CACxC,IAAM,GAAA,EAAM,EAAA,WAAA,CAAW,CAAW,EAClC,GAAI,CAAC,EAAK,MAAU,MAAM,+CAA+C,EACzE,OAAO,CACX,CAKA,SAAgB,GAAsC,CAClD,OAAO,EAAQ,CAAC,CAAC,CACrB"}
+{"version":3,"file":"I18nProvider.cjs","names":[],"sources":["../../src/i18n/I18nProvider.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useMemo, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { createI18n, type Catalog, type I18n } from \"./create-i18n\";\n\nexport interface I18nContextValue extends I18n {\n    /** Switch the active locale. Persisted when `storageKey` is set. */\n    setLocale: (locale: string) => void;\n    /** Locales available in the catalog. */\n    availableLocales: string[];\n}\n\nconst I18nContext = createContext<I18nContextValue | null>(null);\n\nexport interface I18nProviderProps {\n    children: ReactNode;\n    /** Initial locale. */\n    locale: string;\n    /** Fallback locale used when a key is missing. */\n    fallbackLocale?: string;\n    /** Translation catalog. */\n    messages: Catalog;\n    /** localStorage key for persisting the user choice. Pass `null` to disable. Default: `\"tempest-locale\"`. */\n    storageKey?: string | null;\n}\n\nfunction readStored(storageKey: string | null, available: string[]): string | null {\n    if (!storageKey || typeof window === \"undefined\") return null;\n    try {\n        const value = window.localStorage.getItem(storageKey);\n        if (value && available.includes(value)) return value;\n        return null;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * React provider for the SDK's lightweight i18n. Exposes the translation\n * helpers and a `setLocale` setter to children.\n *\n * @tempest-limits empty-catch — remembering the chosen locale is best-effort. The\n * switch itself is React state and already happened by the time the write runs, so\n * a storage failure costs the preference on the next load and nothing in this one.\n */\nexport function I18nProvider({\n    children,\n    locale: initialLocale,\n    fallbackLocale,\n    messages,\n    storageKey = \"tempest-locale\",\n}: I18nProviderProps) {\n    const availableLocales = useMemo(() => Object.keys(messages), [messages]);\n    const [locale, setLocaleState] = useState<string>(\n        () => readStored(storageKey, availableLocales) ?? initialLocale,\n    );\n\n    useEffect(() => {\n        if (typeof document !== \"undefined\") {\n            document.documentElement.setAttribute(\"lang\", locale);\n        }\n    }, [locale]);\n\n    const setLocale = useCallback(\n        (next: string) => {\n            setLocaleState(next);\n            if (storageKey && typeof window !== \"undefined\") {\n                try {\n                    window.localStorage.setItem(storageKey, next);\n                } catch {\n                    /* empty */\n                }\n            }\n        },\n        [storageKey],\n    );\n\n    const value = useMemo<I18nContextValue>(() => {\n        const i18n = createI18n({ locale, fallbackLocale, messages });\n        return { ...i18n, setLocale, availableLocales };\n    }, [locale, fallbackLocale, messages, setLocale, availableLocales]);\n\n    return <I18nContext.Provider value={value}>{children}</I18nContext.Provider>;\n}\n\n/**\n * Access translation helpers. Must be used inside an {@link I18nProvider}.\n */\nexport function useI18n(): I18nContextValue {\n    const ctx = useContext(I18nContext);\n    if (!ctx) throw new Error(\"useI18n must be used inside an <I18nProvider>\");\n    return ctx;\n}\n\n/**\n * Access translation helpers when there may be no {@link I18nProvider} above.\n *\n * Returns `null` instead of throwing, which is what a piece of the SDK needs\n * when it wants to be translated where a catalog exists and still work where one\n * does not — i18n is opt-in in this SDK, and a helper that demanded a provider\n * would turn \"you did not configure translations\" into a crash.\n *\n * @returns The context value, or `null` outside a provider.\n */\nexport function useOptionalI18n(): I18nContextValue | null {\n    return useContext(I18nContext);\n}\n\n/**\n * Shortcut for components that only need the `t` function — avoids destructuring.\n */\nexport function useTranslate(): I18nContextValue[\"t\"] {\n    return useI18n().t;\n}\n"],"mappings":"2FAWA,IAAM,GAAA,EAAc,EAAA,cAAA,CAAuC,IAAI,EAc/D,SAAS,EAAW,EAA2B,EAAoC,CAC/E,GAAI,CAAC,GAAc,OAAO,OAAW,IAAa,OAAO,KACzD,GAAI,CACA,IAAM,EAAQ,OAAO,aAAa,QAAQ,CAAU,EAEpD,OADI,GAAS,EAAU,SAAS,CAAK,EAAU,EACxC,IACX,MAAQ,CACJ,OAAO,IACX,CACJ,CAUA,SAAgB,EAAa,CACzB,WACA,OAAQ,EACR,iBACA,WACA,aAAa,kBACK,CAClB,IAAM,GAAA,EAAmB,EAAA,QAAA,KAAc,OAAO,KAAK,CAAQ,EAAG,CAAC,CAAQ,CAAC,EAClE,CAAC,EAAQ,IAAA,EAAkB,EAAA,SAAA,KACvB,EAAW,EAAY,CAAgB,GAAK,CACtD,GAEA,EAAA,EAAA,UAAA,KAAgB,CACR,OAAO,SAAa,KACpB,SAAS,gBAAgB,aAAa,OAAQ,CAAM,CAE5D,EAAG,CAAC,CAAM,CAAC,EAEX,IAAM,GAAA,EAAY,EAAA,YAAA,CACb,GAAiB,CAEd,GADA,EAAe,CAAI,EACf,GAAc,OAAO,OAAW,IAChC,GAAI,CACA,OAAO,aAAa,QAAQ,EAAY,CAAI,CAChD,MAAQ,CAER,CAER,EACA,CAAC,CAAU,CACf,EAEM,GAAA,EAAQ,EAAA,QAAA,MAEH,CAAE,GADI,EAAA,WAAW,CAAE,SAAQ,iBAAgB,UAAS,CAC/C,EAAM,YAAW,kBAAiB,GAC/C,CAAC,EAAQ,EAAgB,EAAU,EAAW,CAAgB,CAAC,EAElE,OAAO,EAAA,EAAA,IAAA,CAAC,EAAY,SAAb,CAA6B,QAAQ,UAA+B,CAAA,CAC/E,CAKA,SAAgB,GAA4B,CACxC,IAAM,GAAA,EAAM,EAAA,WAAA,CAAW,CAAW,EAClC,GAAI,CAAC,EAAK,MAAU,MAAM,+CAA+C,EACzE,OAAO,CACX,CAYA,SAAgB,GAA2C,CACvD,OAAA,EAAO,EAAA,WAAA,CAAW,CAAW,CACjC,CAKA,SAAgB,GAAsC,CAClD,OAAO,EAAQ,CAAC,CAAC,CACrB"}

package/dist/i18n/I18nProvider.js

@@ -47,9 +47,12 @@ function d() {
 	return e;
 }
 function f() {
+	return r(c);
+}
+function p() {
 	return d().t;
 }
 //#endregion
-export { u as I18nProvider, d as useI18n, f as useTranslate };
+export { u as I18nProvider, d as useI18n, f as useOptionalI18n, p as useTranslate };
 
 //# sourceMappingURL=I18nProvider.js.map