tempest-react-sdk 0.22.0 → 0.24.0

package/dist/testing/create-mock-handlers.cjs

@@ -0,0 +1,2 @@
+function e(e){return e.map(e=>({method:e.method,path:e.path,status:e.status??200,body:e.body??null,headers:e.headers??{"Content-Type":`application/json`},delayMs:e.delayMs??0}))}exports.createMockHandlers=e;
+//# sourceMappingURL=create-mock-handlers.cjs.map

package/dist/testing/create-mock-handlers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mock-handlers.cjs","names":[],"sources":["../../src/testing/create-mock-handlers.ts"],"sourcesContent":["/**\n * Lightweight, MSW-shaped mock request handler factory. Returns plain\n * objects with `{ method, path, status, body }` that callers feed into\n * `msw`'s `http.<method>` helpers OR a custom test harness — the SDK\n * does **not** declare `msw` as a peer dep, so this helper is purely\n * data-driven.\n *\n * Use cases:\n * - Define request fixtures in a single file, share between tests and\n *   Storybook stories (when used).\n * - Standardise the \"happy path\" + \"error path\" shape across services.\n *\n * @example\n * import { http, HttpResponse } from \"msw\";\n * import { setupServer } from \"msw/node\";\n * import { createMockHandlers } from \"tempest-react-sdk/testing\";\n *\n * const fixtures = createMockHandlers([\n *     { method: \"GET\", path: \"/users/me\", status: 200, body: { id: \"u1\", name: \"Mauricio\" } },\n *     { method: \"POST\", path: \"/orders\", status: 201, body: { id: \"o1\" } },\n *     { method: \"GET\", path: \"/explode\", status: 500, body: { detail: \"kaboom\" } },\n * ]);\n *\n * const handlers = fixtures.map((f) =>\n *     (http as Record<string, Function>)[f.method.toLowerCase()](f.path, () =>\n *         HttpResponse.json(f.body, { status: f.status }),\n *     ),\n * );\n *\n * setupServer(...handlers);\n */\n\nexport type MockHandlerMethod = \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\nexport interface MockHandlerInput {\n    method: MockHandlerMethod;\n    path: string;\n    /** HTTP status code. Default `200`. */\n    status?: number;\n    /** Response body — anything JSON-serialisable. Default `null`. */\n    body?: unknown;\n    /** Optional response headers. */\n    headers?: Record<string, string>;\n    /** Optional artificial delay in ms. Useful to test loading states. */\n    delayMs?: number;\n}\n\nexport interface MockHandler {\n    method: MockHandlerMethod;\n    path: string;\n    status: number;\n    body: unknown;\n    headers: Record<string, string>;\n    delayMs: number;\n}\n\n/**\n * Normalise a list of request fixtures into MSW-friendly handler descriptors.\n * Default `status` is `200`, default `body` is `null`, default `delayMs` is `0`,\n * default `headers` is `{ \"Content-Type\": \"application/json\" }`.\n */\nexport function createMockHandlers(handlers: MockHandlerInput[]): MockHandler[] {\n    return handlers.map((handler) => ({\n        method: handler.method,\n        path: handler.path,\n        status: handler.status ?? 200,\n        body: handler.body ?? null,\n        headers: handler.headers ?? { \"Content-Type\": \"application/json\" },\n        delayMs: handler.delayMs ?? 0,\n    }));\n}\n"],"mappings":"AA6DA,SAAgB,EAAmB,EAA6C,CAC5E,OAAO,EAAS,IAAK,IAAa,CAC9B,OAAQ,EAAQ,OAChB,KAAM,EAAQ,KACd,OAAQ,EAAQ,QAAU,IAC1B,KAAM,EAAQ,MAAQ,KACtB,QAAS,EAAQ,SAAW,CAAE,eAAgB,kBAAmB,EACjE,QAAS,EAAQ,SAAW,CAChC,EAAE,CACN"}

package/dist/testing/create-mock-handlers.js

@@ -0,0 +1,15 @@
+//#region src/testing/create-mock-handlers.ts
+function e(e) {
+	return e.map((e) => ({
+		method: e.method,
+		path: e.path,
+		status: e.status ?? 200,
+		body: e.body ?? null,
+		headers: e.headers ?? { "Content-Type": "application/json" },
+		delayMs: e.delayMs ?? 0
+	}));
+}
+//#endregion
+export { e as createMockHandlers };
+
+//# sourceMappingURL=create-mock-handlers.js.map

package/dist/testing/create-mock-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mock-handlers.js","names":[],"sources":["../../src/testing/create-mock-handlers.ts"],"sourcesContent":["/**\n * Lightweight, MSW-shaped mock request handler factory. Returns plain\n * objects with `{ method, path, status, body }` that callers feed into\n * `msw`'s `http.<method>` helpers OR a custom test harness — the SDK\n * does **not** declare `msw` as a peer dep, so this helper is purely\n * data-driven.\n *\n * Use cases:\n * - Define request fixtures in a single file, share between tests and\n *   Storybook stories (when used).\n * - Standardise the \"happy path\" + \"error path\" shape across services.\n *\n * @example\n * import { http, HttpResponse } from \"msw\";\n * import { setupServer } from \"msw/node\";\n * import { createMockHandlers } from \"tempest-react-sdk/testing\";\n *\n * const fixtures = createMockHandlers([\n *     { method: \"GET\", path: \"/users/me\", status: 200, body: { id: \"u1\", name: \"Mauricio\" } },\n *     { method: \"POST\", path: \"/orders\", status: 201, body: { id: \"o1\" } },\n *     { method: \"GET\", path: \"/explode\", status: 500, body: { detail: \"kaboom\" } },\n * ]);\n *\n * const handlers = fixtures.map((f) =>\n *     (http as Record<string, Function>)[f.method.toLowerCase()](f.path, () =>\n *         HttpResponse.json(f.body, { status: f.status }),\n *     ),\n * );\n *\n * setupServer(...handlers);\n */\n\nexport type MockHandlerMethod = \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\nexport interface MockHandlerInput {\n    method: MockHandlerMethod;\n    path: string;\n    /** HTTP status code. Default `200`. */\n    status?: number;\n    /** Response body — anything JSON-serialisable. Default `null`. */\n    body?: unknown;\n    /** Optional response headers. */\n    headers?: Record<string, string>;\n    /** Optional artificial delay in ms. Useful to test loading states. */\n    delayMs?: number;\n}\n\nexport interface MockHandler {\n    method: MockHandlerMethod;\n    path: string;\n    status: number;\n    body: unknown;\n    headers: Record<string, string>;\n    delayMs: number;\n}\n\n/**\n * Normalise a list of request fixtures into MSW-friendly handler descriptors.\n * Default `status` is `200`, default `body` is `null`, default `delayMs` is `0`,\n * default `headers` is `{ \"Content-Type\": \"application/json\" }`.\n */\nexport function createMockHandlers(handlers: MockHandlerInput[]): MockHandler[] {\n    return handlers.map((handler) => ({\n        method: handler.method,\n        path: handler.path,\n        status: handler.status ?? 200,\n        body: handler.body ?? null,\n        headers: handler.headers ?? { \"Content-Type\": \"application/json\" },\n        delayMs: handler.delayMs ?? 0,\n    }));\n}\n"],"mappings":";AA6DA,SAAgB,EAAmB,GAA6C;CAC5E,OAAO,EAAS,KAAK,OAAa;EAC9B,QAAQ,EAAQ;EAChB,MAAM,EAAQ;EACd,QAAQ,EAAQ,UAAU;EAC1B,MAAM,EAAQ,QAAQ;EACtB,SAAS,EAAQ,WAAW,EAAE,gBAAgB,mBAAmB;EACjE,SAAS,EAAQ,WAAW;CAChC,EAAE;AACN"}

package/dist/testing.cjs

@@ -1,2 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function o(e){return e.map(t=>({method:t.method,path:t.path,status:t.status??200,body:t.body??null,headers:t.headers??{"Content-Type":"application/json"},delayMs:t.delayMs??0}))}exports.createMockHandlers=o;
-//# sourceMappingURL=testing.cjs.map
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./testing/create-mock-handlers.cjs");exports.createMockHandlers=e.createMockHandlers;

package/dist/testing.js

@@ -1,14 +1,2 @@
-function o(e) {
-  return e.map((t) => ({
-    method: t.method,
-    path: t.path,
-    status: t.status ?? 200,
-    body: t.body ?? null,
-    headers: t.headers ?? { "Content-Type": "application/json" },
-    delayMs: t.delayMs ?? 0
-  }));
-}
-export {
-  o as createMockHandlers
-};
-//# sourceMappingURL=testing.js.map
+import { createMockHandlers as e } from "./testing/create-mock-handlers.js";
+export { e as createMockHandlers };

package/dist/theme/ThemeProvider.cjs

@@ -0,0 +1,2 @@
+let e=require("react"),t=require("react/jsx-runtime");var n=(0,e.createContext)(null);function r(e){return e===`dark`||e===`light`?e:typeof window>`u`?`light`:window.matchMedia(`(prefers-color-scheme: dark)`).matches?`dark`:`light`}function i(e,t,n,r){let i=Array.isArray(n)?n:[n];for(let n of i)e.setAttribute(n,t);if(r&&typeof document<`u`){let e=document.querySelector(`meta[name="theme-color"]`);e&&(e.content=r[t])}}function a(e){if(!e||typeof window>`u`)return null;try{let t=window.localStorage.getItem(e);return t===`light`||t===`dark`||t===`system`?t:null}catch{return null}}function o({children:o,defaultTheme:s=`system`,storageKey:c=`tempest-theme`,target:l,attribute:u=`data-tempest-theme`,themeColor:d}){let[f,p]=(0,e.useState)(()=>a(c)??s),[m,h]=(0,e.useState)(()=>r(f)),g=(0,e.useRef)(l);g.current=l;let _=Array.isArray(u)?u.join(`,`):u,v=(0,e.useRef)(d);v.current=d,(0,e.useEffect)(()=>{let e=g.current?.()??document.documentElement;if(!e)return;let t=r(f);i(e,t,u,v.current),h(t)},[f,_]),(0,e.useEffect)(()=>{if(f!==`system`||typeof window>`u`)return;let e=window.matchMedia(`(prefers-color-scheme: dark)`),t=()=>{let t=g.current?.()??document.documentElement;if(!t)return;let n=e.matches?`dark`:`light`;i(t,n,u,v.current),h(n)};return e.addEventListener(`change`,t),()=>e.removeEventListener(`change`,t)},[f,_]);let y=(0,e.useCallback)(e=>{if(p(e),c&&typeof window<`u`)try{window.localStorage.setItem(c,e)}catch{}},[c]),b=(0,e.useCallback)(()=>{y(m===`dark`?`light`:`dark`)},[m,y]),x=(0,e.useMemo)(()=>({theme:f,resolvedTheme:m,setTheme:y,toggle:b}),[f,m,y,b]);return(0,t.jsx)(n.Provider,{value:x,children:o})}function s(){let t=(0,e.useContext)(n);if(!t)throw Error(`useTheme must be used inside a <ThemeProvider>`);return t}exports.ThemeProvider=o,exports.useTheme=s;
+//# sourceMappingURL=ThemeProvider.cjs.map

package/dist/theme/ThemeProvider.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.cjs","names":[],"sources":["../../src/theme/ThemeProvider.tsx"],"sourcesContent":["import {\n    createContext,\n    useCallback,\n    useContext,\n    useEffect,\n    useMemo,\n    useRef,\n    useState,\n} from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { ResolvedTheme, ThemeMode } from \"./types\";\n\nexport interface ThemeContextValue {\n    /** Raw user preference (light / dark / system). */\n    theme: ThemeMode;\n    /** Effective theme actually applied to the DOM (light or dark). */\n    resolvedTheme: ResolvedTheme;\n    /** Update the preference. Persisted to localStorage when `storageKey` is set. */\n    setTheme: (next: ThemeMode) => void;\n    /** Convenience: flip light ↔ dark. When in `system` mode, switches to the opposite of the current resolved theme. */\n    toggle: () => void;\n}\n\nconst ThemeContext = createContext<ThemeContextValue | null>(null);\n\nexport interface ThemeProviderProps {\n    children: ReactNode;\n    /** Initial preference when nothing is stored. Default: `\"system\"`. */\n    defaultTheme?: ThemeMode;\n    /** localStorage key used to persist the preference. Pass `null` to disable persistence. Default: `\"tempest-theme\"`. */\n    storageKey?: string | null;\n    /**\n     * Element that receives the theme attribute(s). Defaults to\n     * `document.documentElement`. Override when scoping the theme to a subtree.\n     */\n    target?: () => HTMLElement | null;\n    /**\n     * Attribute name(s) written on the target with the resolved theme\n     * (`\"light\"` / `\"dark\"`). Default: `\"data-tempest-theme\"`.\n     *\n     * Pass an array to mirror the theme onto more than one attribute — handy\n     * when the SDK components read `data-tempest-theme` but the host app's own\n     * CSS keys off a different attribute (e.g. `[\"data-tempest-theme\",\n     * \"data-theme\"]`). Avoids a separate sync effect in the consumer.\n     */\n    attribute?: string | string[];\n    /**\n     * When set, keeps `<meta name=\"theme-color\">` in sync with the resolved\n     * theme — `content` becomes `themeColor.dark` in dark mode and\n     * `themeColor.light` in light mode. The meta tag must already exist in the\n     * document `<head>`. No-op when omitted.\n     */\n    themeColor?: { light: string; dark: string };\n}\n\nfunction resolve(mode: ThemeMode): ResolvedTheme {\n    if (mode === \"dark\" || mode === \"light\") return mode;\n    if (typeof window === \"undefined\") return \"light\";\n    return window.matchMedia(\"(prefers-color-scheme: dark)\").matches ? \"dark\" : \"light\";\n}\n\n/**\n * Write the resolved theme onto every configured attribute and, when a\n * `themeColor` map is provided, sync the `<meta name=\"theme-color\">` tag.\n */\nfunction applyResolved(\n    element: HTMLElement,\n    resolved: ResolvedTheme,\n    attribute: string | string[],\n    themeColor?: { light: string; dark: string },\n): void {\n    const attrs = Array.isArray(attribute) ? attribute : [attribute];\n    for (const attr of attrs) element.setAttribute(attr, resolved);\n    if (themeColor && typeof document !== \"undefined\") {\n        const meta = document.querySelector<HTMLMetaElement>('meta[name=\"theme-color\"]');\n        if (meta) meta.content = themeColor[resolved];\n    }\n}\n\nfunction readStored(storageKey: string | null): ThemeMode | null {\n    if (!storageKey || typeof window === \"undefined\") return null;\n    try {\n        const value = window.localStorage.getItem(storageKey);\n        if (value === \"light\" || value === \"dark\" || value === \"system\") return value;\n        return null;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Wire dark/light theming. Writes a data attribute on a target element (the\n * `<html>` element by default) and exposes the current preference via\n * {@link useTheme}.\n *\n * Pair with `themeInitScript()` in the HTML head to prevent the flash of\n * incorrect theme on first paint.\n */\nexport function ThemeProvider({\n    children,\n    defaultTheme = \"system\",\n    storageKey = \"tempest-theme\",\n    target,\n    attribute = \"data-tempest-theme\",\n    themeColor,\n}: ThemeProviderProps) {\n    const [theme, setThemeState] = useState<ThemeMode>(\n        () => readStored(storageKey) ?? defaultTheme,\n    );\n    const [resolvedTheme, setResolvedTheme] = useState<ResolvedTheme>(() => resolve(theme));\n\n    const targetRef = useRef<typeof target>(target);\n    targetRef.current = target;\n\n    const attributeKey = Array.isArray(attribute) ? attribute.join(\",\") : attribute;\n    const themeColorRef = useRef(themeColor);\n    themeColorRef.current = themeColor;\n\n    useEffect(() => {\n        const element = targetRef.current?.() ?? document.documentElement;\n        if (!element) return;\n        const next = resolve(theme);\n        applyResolved(element, next, attribute, themeColorRef.current);\n        setResolvedTheme(next);\n        // attributeKey is the stable string form of `attribute`.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [theme, attributeKey]);\n\n    useEffect(() => {\n        if (theme !== \"system\" || typeof window === \"undefined\") return;\n        const list = window.matchMedia(\"(prefers-color-scheme: dark)\");\n        const handler = (): void => {\n            const element = targetRef.current?.() ?? document.documentElement;\n            if (!element) return;\n            const next: ResolvedTheme = list.matches ? \"dark\" : \"light\";\n            applyResolved(element, next, attribute, themeColorRef.current);\n            setResolvedTheme(next);\n        };\n        list.addEventListener(\"change\", handler);\n        return () => list.removeEventListener(\"change\", handler);\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [theme, attributeKey]);\n\n    const setTheme = useCallback(\n        (next: ThemeMode) => {\n            setThemeState(next);\n            if (storageKey && typeof window !== \"undefined\") {\n                try {\n                    window.localStorage.setItem(storageKey, next);\n                } catch {\n                    /* ignore quota errors */\n                }\n            }\n        },\n        [storageKey],\n    );\n\n    const toggle = useCallback(() => {\n        setTheme(resolvedTheme === \"dark\" ? \"light\" : \"dark\");\n    }, [resolvedTheme, setTheme]);\n\n    const value = useMemo<ThemeContextValue>(\n        () => ({ theme, resolvedTheme, setTheme, toggle }),\n        [theme, resolvedTheme, setTheme, toggle],\n    );\n\n    return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;\n}\n\n/**\n * Read and mutate the current theme. Must be used inside a {@link ThemeProvider}.\n */\nexport function useTheme(): ThemeContextValue {\n    const ctx = useContext(ThemeContext);\n    if (!ctx) throw new Error(\"useTheme must be used inside a <ThemeProvider>\");\n    return ctx;\n}\n"],"mappings":"sDAuBA,IAAM,GAAA,EAAA,EAAA,cAAA,CAAuD,IAAI,EAgCjE,SAAS,EAAQ,EAAgC,CAG7C,OAFI,IAAS,QAAU,IAAS,QAAgB,EAC5C,OAAO,OAAW,IAAoB,QACnC,OAAO,WAAW,8BAA8B,CAAC,CAAC,QAAU,OAAS,OAChF,CAMA,SAAS,EACL,EACA,EACA,EACA,EACI,CACJ,IAAM,EAAQ,MAAM,QAAQ,CAAS,EAAI,EAAY,CAAC,CAAS,EAC/D,IAAK,IAAM,KAAQ,EAAO,EAAQ,aAAa,EAAM,CAAQ,EAC7D,GAAI,GAAc,OAAO,SAAa,IAAa,CAC/C,IAAM,EAAO,SAAS,cAA+B,0BAA0B,EAC3E,IAAM,EAAK,QAAU,EAAW,GACxC,CACJ,CAEA,SAAS,EAAW,EAA6C,CAC7D,GAAI,CAAC,GAAc,OAAO,OAAW,IAAa,OAAO,KACzD,GAAI,CACA,IAAM,EAAQ,OAAO,aAAa,QAAQ,CAAU,EAEpD,OADI,IAAU,SAAW,IAAU,QAAU,IAAU,SAAiB,EACjE,IACX,MAAQ,CACJ,OAAO,IACX,CACJ,CAUA,SAAgB,EAAc,CAC1B,WACA,eAAe,SACf,aAAa,gBACb,SACA,YAAY,qBACZ,cACmB,CACnB,GAAM,CAAC,EAAO,IAAA,EAAA,EAAA,SAAA,KACJ,EAAW,CAAU,GAAK,CACpC,EACM,CAAC,EAAe,IAAA,EAAA,EAAA,SAAA,KAAkD,EAAQ,CAAK,CAAC,EAEhF,GAAA,EAAA,EAAA,OAAA,CAAkC,CAAM,EAC9C,EAAU,QAAU,EAEpB,IAAM,EAAe,MAAM,QAAQ,CAAS,EAAI,EAAU,KAAK,GAAG,EAAI,EAChE,GAAA,EAAA,EAAA,OAAA,CAAuB,CAAU,EACvC,EAAc,QAAU,GAExB,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAU,EAAU,UAAU,GAAK,SAAS,gBAClD,GAAI,CAAC,EAAS,OACd,IAAM,EAAO,EAAQ,CAAK,EAC1B,EAAc,EAAS,EAAM,EAAW,EAAc,OAAO,EAC7D,EAAiB,CAAI,CAGzB,EAAG,CAAC,EAAO,CAAY,CAAC,GAExB,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,IAAU,UAAY,OAAO,OAAW,IAAa,OACzD,IAAM,EAAO,OAAO,WAAW,8BAA8B,EACvD,MAAsB,CACxB,IAAM,EAAU,EAAU,UAAU,GAAK,SAAS,gBAClD,GAAI,CAAC,EAAS,OACd,IAAM,EAAsB,EAAK,QAAU,OAAS,QACpD,EAAc,EAAS,EAAM,EAAW,EAAc,OAAO,EAC7D,EAAiB,CAAI,CACzB,EAEA,OADA,EAAK,iBAAiB,SAAU,CAAO,MAC1B,EAAK,oBAAoB,SAAU,CAAO,CAE3D,EAAG,CAAC,EAAO,CAAY,CAAC,EAExB,IAAM,GAAA,EAAA,EAAA,YAAA,CACD,GAAoB,CAEjB,GADA,EAAc,CAAI,EACd,GAAc,OAAO,OAAW,IAChC,GAAI,CACA,OAAO,aAAa,QAAQ,EAAY,CAAI,CAChD,MAAQ,CAER,CAER,EACA,CAAC,CAAU,CACf,EAEM,GAAA,EAAA,EAAA,YAAA,KAA2B,CAC7B,EAAS,IAAkB,OAAS,QAAU,MAAM,CACxD,EAAG,CAAC,EAAe,CAAQ,CAAC,EAEtB,GAAA,EAAA,EAAA,QAAA,MACK,CAAE,QAAO,gBAAe,WAAU,QAAO,GAChD,CAAC,EAAO,EAAe,EAAU,CAAM,CAC3C,EAEA,OAAO,EAAA,EAAA,IAAA,CAAC,EAAa,SAAd,CAA8B,QAAQ,UAAgC,CAAA,CACjF,CAKA,SAAgB,GAA8B,CAC1C,IAAM,GAAA,EAAA,EAAA,WAAA,CAAiB,CAAY,EACnC,GAAI,CAAC,EAAK,MAAU,MAAM,gDAAgD,EAC1E,OAAO,CACX"}

package/dist/theme/ThemeProvider.js

@@ -0,0 +1,74 @@
+import { createContext as e, useCallback as t, useContext as n, useEffect as r, useMemo as i, useRef as a, useState as o } from "react";
+import { jsx as s } from "react/jsx-runtime";
+//#region src/theme/ThemeProvider.tsx
+var c = e(null);
+function l(e) {
+	return e === "dark" || e === "light" ? e : typeof window > "u" ? "light" : window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+}
+function u(e, t, n, r) {
+	let i = Array.isArray(n) ? n : [n];
+	for (let n of i) e.setAttribute(n, t);
+	if (r && typeof document < "u") {
+		let e = document.querySelector("meta[name=\"theme-color\"]");
+		e && (e.content = r[t]);
+	}
+}
+function d(e) {
+	if (!e || typeof window > "u") return null;
+	try {
+		let t = window.localStorage.getItem(e);
+		return t === "light" || t === "dark" || t === "system" ? t : null;
+	} catch {
+		return null;
+	}
+}
+function f({ children: e, defaultTheme: n = "system", storageKey: f = "tempest-theme", target: p, attribute: m = "data-tempest-theme", themeColor: h }) {
+	let [g, _] = o(() => d(f) ?? n), [v, y] = o(() => l(g)), b = a(p);
+	b.current = p;
+	let x = Array.isArray(m) ? m.join(",") : m, S = a(h);
+	S.current = h, r(() => {
+		let e = b.current?.() ?? document.documentElement;
+		if (!e) return;
+		let t = l(g);
+		u(e, t, m, S.current), y(t);
+	}, [g, x]), r(() => {
+		if (g !== "system" || typeof window > "u") return;
+		let e = window.matchMedia("(prefers-color-scheme: dark)"), t = () => {
+			let t = b.current?.() ?? document.documentElement;
+			if (!t) return;
+			let n = e.matches ? "dark" : "light";
+			u(t, n, m, S.current), y(n);
+		};
+		return e.addEventListener("change", t), () => e.removeEventListener("change", t);
+	}, [g, x]);
+	let C = t((e) => {
+		if (_(e), f && typeof window < "u") try {
+			window.localStorage.setItem(f, e);
+		} catch {}
+	}, [f]), w = t(() => {
+		C(v === "dark" ? "light" : "dark");
+	}, [v, C]), T = i(() => ({
+		theme: g,
+		resolvedTheme: v,
+		setTheme: C,
+		toggle: w
+	}), [
+		g,
+		v,
+		C,
+		w
+	]);
+	return /* @__PURE__ */ s(c.Provider, {
+		value: T,
+		children: e
+	});
+}
+function p() {
+	let e = n(c);
+	if (!e) throw Error("useTheme must be used inside a <ThemeProvider>");
+	return e;
+}
+//#endregion
+export { f as ThemeProvider, p as useTheme };
+
+//# sourceMappingURL=ThemeProvider.js.map

package/dist/theme/ThemeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.js","names":[],"sources":["../../src/theme/ThemeProvider.tsx"],"sourcesContent":["import {\n    createContext,\n    useCallback,\n    useContext,\n    useEffect,\n    useMemo,\n    useRef,\n    useState,\n} from \"react\";\nimport type { ReactNode } from \"react\";\nimport type { ResolvedTheme, ThemeMode } from \"./types\";\n\nexport interface ThemeContextValue {\n    /** Raw user preference (light / dark / system). */\n    theme: ThemeMode;\n    /** Effective theme actually applied to the DOM (light or dark). */\n    resolvedTheme: ResolvedTheme;\n    /** Update the preference. Persisted to localStorage when `storageKey` is set. */\n    setTheme: (next: ThemeMode) => void;\n    /** Convenience: flip light ↔ dark. When in `system` mode, switches to the opposite of the current resolved theme. */\n    toggle: () => void;\n}\n\nconst ThemeContext = createContext<ThemeContextValue | null>(null);\n\nexport interface ThemeProviderProps {\n    children: ReactNode;\n    /** Initial preference when nothing is stored. Default: `\"system\"`. */\n    defaultTheme?: ThemeMode;\n    /** localStorage key used to persist the preference. Pass `null` to disable persistence. Default: `\"tempest-theme\"`. */\n    storageKey?: string | null;\n    /**\n     * Element that receives the theme attribute(s). Defaults to\n     * `document.documentElement`. Override when scoping the theme to a subtree.\n     */\n    target?: () => HTMLElement | null;\n    /**\n     * Attribute name(s) written on the target with the resolved theme\n     * (`\"light\"` / `\"dark\"`). Default: `\"data-tempest-theme\"`.\n     *\n     * Pass an array to mirror the theme onto more than one attribute — handy\n     * when the SDK components read `data-tempest-theme` but the host app's own\n     * CSS keys off a different attribute (e.g. `[\"data-tempest-theme\",\n     * \"data-theme\"]`). Avoids a separate sync effect in the consumer.\n     */\n    attribute?: string | string[];\n    /**\n     * When set, keeps `<meta name=\"theme-color\">` in sync with the resolved\n     * theme — `content` becomes `themeColor.dark` in dark mode and\n     * `themeColor.light` in light mode. The meta tag must already exist in the\n     * document `<head>`. No-op when omitted.\n     */\n    themeColor?: { light: string; dark: string };\n}\n\nfunction resolve(mode: ThemeMode): ResolvedTheme {\n    if (mode === \"dark\" || mode === \"light\") return mode;\n    if (typeof window === \"undefined\") return \"light\";\n    return window.matchMedia(\"(prefers-color-scheme: dark)\").matches ? \"dark\" : \"light\";\n}\n\n/**\n * Write the resolved theme onto every configured attribute and, when a\n * `themeColor` map is provided, sync the `<meta name=\"theme-color\">` tag.\n */\nfunction applyResolved(\n    element: HTMLElement,\n    resolved: ResolvedTheme,\n    attribute: string | string[],\n    themeColor?: { light: string; dark: string },\n): void {\n    const attrs = Array.isArray(attribute) ? attribute : [attribute];\n    for (const attr of attrs) element.setAttribute(attr, resolved);\n    if (themeColor && typeof document !== \"undefined\") {\n        const meta = document.querySelector<HTMLMetaElement>('meta[name=\"theme-color\"]');\n        if (meta) meta.content = themeColor[resolved];\n    }\n}\n\nfunction readStored(storageKey: string | null): ThemeMode | null {\n    if (!storageKey || typeof window === \"undefined\") return null;\n    try {\n        const value = window.localStorage.getItem(storageKey);\n        if (value === \"light\" || value === \"dark\" || value === \"system\") return value;\n        return null;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Wire dark/light theming. Writes a data attribute on a target element (the\n * `<html>` element by default) and exposes the current preference via\n * {@link useTheme}.\n *\n * Pair with `themeInitScript()` in the HTML head to prevent the flash of\n * incorrect theme on first paint.\n */\nexport function ThemeProvider({\n    children,\n    defaultTheme = \"system\",\n    storageKey = \"tempest-theme\",\n    target,\n    attribute = \"data-tempest-theme\",\n    themeColor,\n}: ThemeProviderProps) {\n    const [theme, setThemeState] = useState<ThemeMode>(\n        () => readStored(storageKey) ?? defaultTheme,\n    );\n    const [resolvedTheme, setResolvedTheme] = useState<ResolvedTheme>(() => resolve(theme));\n\n    const targetRef = useRef<typeof target>(target);\n    targetRef.current = target;\n\n    const attributeKey = Array.isArray(attribute) ? attribute.join(\",\") : attribute;\n    const themeColorRef = useRef(themeColor);\n    themeColorRef.current = themeColor;\n\n    useEffect(() => {\n        const element = targetRef.current?.() ?? document.documentElement;\n        if (!element) return;\n        const next = resolve(theme);\n        applyResolved(element, next, attribute, themeColorRef.current);\n        setResolvedTheme(next);\n        // attributeKey is the stable string form of `attribute`.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [theme, attributeKey]);\n\n    useEffect(() => {\n        if (theme !== \"system\" || typeof window === \"undefined\") return;\n        const list = window.matchMedia(\"(prefers-color-scheme: dark)\");\n        const handler = (): void => {\n            const element = targetRef.current?.() ?? document.documentElement;\n            if (!element) return;\n            const next: ResolvedTheme = list.matches ? \"dark\" : \"light\";\n            applyResolved(element, next, attribute, themeColorRef.current);\n            setResolvedTheme(next);\n        };\n        list.addEventListener(\"change\", handler);\n        return () => list.removeEventListener(\"change\", handler);\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [theme, attributeKey]);\n\n    const setTheme = useCallback(\n        (next: ThemeMode) => {\n            setThemeState(next);\n            if (storageKey && typeof window !== \"undefined\") {\n                try {\n                    window.localStorage.setItem(storageKey, next);\n                } catch {\n                    /* ignore quota errors */\n                }\n            }\n        },\n        [storageKey],\n    );\n\n    const toggle = useCallback(() => {\n        setTheme(resolvedTheme === \"dark\" ? \"light\" : \"dark\");\n    }, [resolvedTheme, setTheme]);\n\n    const value = useMemo<ThemeContextValue>(\n        () => ({ theme, resolvedTheme, setTheme, toggle }),\n        [theme, resolvedTheme, setTheme, toggle],\n    );\n\n    return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;\n}\n\n/**\n * Read and mutate the current theme. Must be used inside a {@link ThemeProvider}.\n */\nexport function useTheme(): ThemeContextValue {\n    const ctx = useContext(ThemeContext);\n    if (!ctx) throw new Error(\"useTheme must be used inside a <ThemeProvider>\");\n    return ctx;\n}\n"],"mappings":";;;AAuBA,IAAM,IAAe,EAAwC,IAAI;AAgCjE,SAAS,EAAQ,GAAgC;CAG7C,OAFI,MAAS,UAAU,MAAS,UAAgB,IAC5C,OAAO,SAAW,MAAoB,UACnC,OAAO,WAAW,8BAA8B,CAAC,CAAC,UAAU,SAAS;AAChF;AAMA,SAAS,EACL,GACA,GACA,GACA,GACI;CACJ,IAAM,IAAQ,MAAM,QAAQ,CAAS,IAAI,IAAY,CAAC,CAAS;CAC/D,KAAK,IAAM,KAAQ,GAAO,EAAQ,aAAa,GAAM,CAAQ;CAC7D,IAAI,KAAc,OAAO,WAAa,KAAa;EAC/C,IAAM,IAAO,SAAS,cAA+B,4BAA0B;EAC/E,AAAI,MAAM,EAAK,UAAU,EAAW;CACxC;AACJ;AAEA,SAAS,EAAW,GAA6C;CAC7D,IAAI,CAAC,KAAc,OAAO,SAAW,KAAa,OAAO;CACzD,IAAI;EACA,IAAM,IAAQ,OAAO,aAAa,QAAQ,CAAU;EAEpD,OADI,MAAU,WAAW,MAAU,UAAU,MAAU,WAAiB,IACjE;CACX,QAAQ;EACJ,OAAO;CACX;AACJ;AAUA,SAAgB,EAAc,EAC1B,aACA,kBAAe,UACf,gBAAa,iBACb,WACA,eAAY,sBACZ,iBACmB;CACnB,IAAM,CAAC,GAAO,KAAiB,QACrB,EAAW,CAAU,KAAK,CACpC,GACM,CAAC,GAAe,KAAoB,QAA8B,EAAQ,CAAK,CAAC,GAEhF,IAAY,EAAsB,CAAM;CAC9C,EAAU,UAAU;CAEpB,IAAM,IAAe,MAAM,QAAQ,CAAS,IAAI,EAAU,KAAK,GAAG,IAAI,GAChE,IAAgB,EAAO,CAAU;CAavC,AAZA,EAAc,UAAU,GAExB,QAAgB;EACZ,IAAM,IAAU,EAAU,UAAU,KAAK,SAAS;EAClD,IAAI,CAAC,GAAS;EACd,IAAM,IAAO,EAAQ,CAAK;EAE1B,AADA,EAAc,GAAS,GAAM,GAAW,EAAc,OAAO,GAC7D,EAAiB,CAAI;CAGzB,GAAG,CAAC,GAAO,CAAY,CAAC,GAExB,QAAgB;EACZ,IAAI,MAAU,YAAY,OAAO,SAAW,KAAa;EACzD,IAAM,IAAO,OAAO,WAAW,8BAA8B,GACvD,UAAsB;GACxB,IAAM,IAAU,EAAU,UAAU,KAAK,SAAS;GAClD,IAAI,CAAC,GAAS;GACd,IAAM,IAAsB,EAAK,UAAU,SAAS;GAEpD,AADA,EAAc,GAAS,GAAM,GAAW,EAAc,OAAO,GAC7D,EAAiB,CAAI;EACzB;EAEA,OADA,EAAK,iBAAiB,UAAU,CAAO,SAC1B,EAAK,oBAAoB,UAAU,CAAO;CAE3D,GAAG,CAAC,GAAO,CAAY,CAAC;CAExB,IAAM,IAAW,GACZ,MAAoB;EAEjB,IADA,EAAc,CAAI,GACd,KAAc,OAAO,SAAW,KAChC,IAAI;GACA,OAAO,aAAa,QAAQ,GAAY,CAAI;EAChD,QAAQ,CAER;CAER,GACA,CAAC,CAAU,CACf,GAEM,IAAS,QAAkB;EAC7B,EAAS,MAAkB,SAAS,UAAU,MAAM;CACxD,GAAG,CAAC,GAAe,CAAQ,CAAC,GAEtB,IAAQ,SACH;EAAE;EAAO;EAAe;EAAU;CAAO,IAChD;EAAC;EAAO;EAAe;EAAU;CAAM,CAC3C;CAEA,OAAO,kBAAC,EAAa,UAAd;EAA8B;EAAQ;CAAgC,CAAA;AACjF;AAKA,SAAgB,IAA8B;CAC1C,IAAM,IAAM,EAAW,CAAY;CACnC,IAAI,CAAC,GAAK,MAAU,MAAM,gDAAgD;CAC1E,OAAO;AACX"}

package/dist/theme/initial-theme.cjs

@@ -0,0 +1,11 @@
+function e(e={}){let{storageKey:t=`tempest-theme`,defaultTheme:n=`system`}=e;if(typeof window>`u`)return n===`dark`?`dark`:`light`;let r;try{r=window.localStorage.getItem(t)}catch{r=null}let i=r??n;return i===`dark`||i===`light`?i:window.matchMedia(`(prefers-color-scheme: dark)`).matches?`dark`:`light`}function t(e={}){let t=e.storageKey??`tempest-theme`,n=e.defaultTheme??`system`;return`
+(function(){try{
+  var key=${JSON.stringify(t)};
+  var def=${JSON.stringify(n)};
+  var stored=localStorage.getItem(key);
+  var mode=stored||def;
+  var resolved=mode==="dark"||mode==="light"?mode:(matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light");
+  document.documentElement.setAttribute("data-tempest-theme",resolved);
+}catch(e){}})();
+`.trim()}exports.getInitialTheme=e,exports.themeInitScript=t;
+//# sourceMappingURL=initial-theme.cjs.map

package/dist/theme/initial-theme.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"initial-theme.cjs","names":[],"sources":["../../src/theme/initial-theme.ts"],"sourcesContent":["import type { ResolvedTheme, ThemeMode } from \"./types\";\n\nexport interface GetInitialThemeOptions {\n    /** localStorage key. Default: `\"tempest-theme\"`. */\n    storageKey?: string;\n    /** Theme used when nothing is stored and the user has no system preference. */\n    defaultTheme?: ThemeMode;\n}\n\n/**\n * Inline-safe theme resolution intended for early bootstrap (e.g. inside the\n * `<head>` script that prevents the flash of incorrect theme). Reads from\n * localStorage and falls back to `prefers-color-scheme`.\n */\nexport function getInitialTheme(options: GetInitialThemeOptions = {}): ResolvedTheme {\n    const { storageKey = \"tempest-theme\", defaultTheme = \"system\" } = options;\n\n    if (typeof window === \"undefined\") {\n        return defaultTheme === \"dark\" ? \"dark\" : \"light\";\n    }\n\n    let stored: ThemeMode | null;\n    try {\n        stored = window.localStorage.getItem(storageKey) as ThemeMode | null;\n    } catch {\n        stored = null;\n    }\n\n    const mode: ThemeMode = stored ?? defaultTheme;\n    if (mode === \"dark\" || mode === \"light\") return mode;\n\n    return window.matchMedia(\"(prefers-color-scheme: dark)\").matches ? \"dark\" : \"light\";\n}\n\n/**\n * Plain HTML snippet that sets `data-tempest-theme` on `<html>` before React\n * hydrates. Inline this in `<head>` to avoid a flash of the wrong theme on\n * first paint.\n *\n * @example\n * <script dangerouslySetInnerHTML={{ __html: themeInitScript() }} />\n */\nexport function themeInitScript(options: GetInitialThemeOptions = {}): string {\n    const storageKey = options.storageKey ?? \"tempest-theme\";\n    const defaultTheme = options.defaultTheme ?? \"system\";\n    return `\n(function(){try{\n  var key=${JSON.stringify(storageKey)};\n  var def=${JSON.stringify(defaultTheme)};\n  var stored=localStorage.getItem(key);\n  var mode=stored||def;\n  var resolved=mode===\"dark\"||mode===\"light\"?mode:(matchMedia(\"(prefers-color-scheme: dark)\").matches?\"dark\":\"light\");\n  document.documentElement.setAttribute(\"data-tempest-theme\",resolved);\n}catch(e){}})();\n`.trim();\n}\n"],"mappings":"AAcA,SAAgB,EAAgB,EAAkC,CAAC,EAAkB,CACjF,GAAM,CAAE,aAAa,gBAAiB,eAAe,UAAa,EAElE,GAAI,OAAO,OAAW,IAClB,OAAO,IAAiB,OAAS,OAAS,QAG9C,IAAI,EACJ,GAAI,CACA,EAAS,OAAO,aAAa,QAAQ,CAAU,CACnD,MAAQ,CACJ,EAAS,IACb,CAEA,IAAM,EAAkB,GAAU,EAGlC,OAFI,IAAS,QAAU,IAAS,QAAgB,EAEzC,OAAO,WAAW,8BAA8B,CAAC,CAAC,QAAU,OAAS,OAChF,CAUA,SAAgB,EAAgB,EAAkC,CAAC,EAAW,CAC1E,IAAM,EAAa,EAAQ,YAAc,gBACnC,EAAe,EAAQ,cAAgB,SAC7C,MAAO;;YAEC,KAAK,UAAU,CAAU,EAAE;YAC3B,KAAK,UAAU,CAAY,EAAE;;;;;;EAMvC,KAAK,CACP"}

package/dist/theme/initial-theme.js

@@ -0,0 +1,30 @@
+//#region src/theme/initial-theme.ts
+function e(e = {}) {
+	let { storageKey: t = "tempest-theme", defaultTheme: n = "system" } = e;
+	if (typeof window > "u") return n === "dark" ? "dark" : "light";
+	let r;
+	try {
+		r = window.localStorage.getItem(t);
+	} catch {
+		r = null;
+	}
+	let i = r ?? n;
+	return i === "dark" || i === "light" ? i : window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+}
+function t(e = {}) {
+	let t = e.storageKey ?? "tempest-theme", n = e.defaultTheme ?? "system";
+	return `
+(function(){try{
+  var key=${JSON.stringify(t)};
+  var def=${JSON.stringify(n)};
+  var stored=localStorage.getItem(key);
+  var mode=stored||def;
+  var resolved=mode==="dark"||mode==="light"?mode:(matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light");
+  document.documentElement.setAttribute("data-tempest-theme",resolved);
+}catch(e){}})();
+`.trim();
+}
+//#endregion
+export { e as getInitialTheme, t as themeInitScript };
+
+//# sourceMappingURL=initial-theme.js.map

package/dist/theme/initial-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initial-theme.js","names":[],"sources":["../../src/theme/initial-theme.ts"],"sourcesContent":["import type { ResolvedTheme, ThemeMode } from \"./types\";\n\nexport interface GetInitialThemeOptions {\n    /** localStorage key. Default: `\"tempest-theme\"`. */\n    storageKey?: string;\n    /** Theme used when nothing is stored and the user has no system preference. */\n    defaultTheme?: ThemeMode;\n}\n\n/**\n * Inline-safe theme resolution intended for early bootstrap (e.g. inside the\n * `<head>` script that prevents the flash of incorrect theme). Reads from\n * localStorage and falls back to `prefers-color-scheme`.\n */\nexport function getInitialTheme(options: GetInitialThemeOptions = {}): ResolvedTheme {\n    const { storageKey = \"tempest-theme\", defaultTheme = \"system\" } = options;\n\n    if (typeof window === \"undefined\") {\n        return defaultTheme === \"dark\" ? \"dark\" : \"light\";\n    }\n\n    let stored: ThemeMode | null;\n    try {\n        stored = window.localStorage.getItem(storageKey) as ThemeMode | null;\n    } catch {\n        stored = null;\n    }\n\n    const mode: ThemeMode = stored ?? defaultTheme;\n    if (mode === \"dark\" || mode === \"light\") return mode;\n\n    return window.matchMedia(\"(prefers-color-scheme: dark)\").matches ? \"dark\" : \"light\";\n}\n\n/**\n * Plain HTML snippet that sets `data-tempest-theme` on `<html>` before React\n * hydrates. Inline this in `<head>` to avoid a flash of the wrong theme on\n * first paint.\n *\n * @example\n * <script dangerouslySetInnerHTML={{ __html: themeInitScript() }} />\n */\nexport function themeInitScript(options: GetInitialThemeOptions = {}): string {\n    const storageKey = options.storageKey ?? \"tempest-theme\";\n    const defaultTheme = options.defaultTheme ?? \"system\";\n    return `\n(function(){try{\n  var key=${JSON.stringify(storageKey)};\n  var def=${JSON.stringify(defaultTheme)};\n  var stored=localStorage.getItem(key);\n  var mode=stored||def;\n  var resolved=mode===\"dark\"||mode===\"light\"?mode:(matchMedia(\"(prefers-color-scheme: dark)\").matches?\"dark\":\"light\");\n  document.documentElement.setAttribute(\"data-tempest-theme\",resolved);\n}catch(e){}})();\n`.trim();\n}\n"],"mappings":";AAcA,SAAgB,EAAgB,IAAkC,CAAC,GAAkB;CACjF,IAAM,EAAE,gBAAa,iBAAiB,kBAAe,aAAa;CAElE,IAAI,OAAO,SAAW,KAClB,OAAO,MAAiB,SAAS,SAAS;CAG9C,IAAI;CACJ,IAAI;EACA,IAAS,OAAO,aAAa,QAAQ,CAAU;CACnD,QAAQ;EACJ,IAAS;CACb;CAEA,IAAM,IAAkB,KAAU;CAGlC,OAFI,MAAS,UAAU,MAAS,UAAgB,IAEzC,OAAO,WAAW,8BAA8B,CAAC,CAAC,UAAU,SAAS;AAChF;AAUA,SAAgB,EAAgB,IAAkC,CAAC,GAAW;CAC1E,IAAM,IAAa,EAAQ,cAAc,iBACnC,IAAe,EAAQ,gBAAgB;CAC7C,OAAO;;YAEC,KAAK,UAAU,CAAU,EAAE;YAC3B,KAAK,UAAU,CAAY,EAAE;;;;;;EAMvC,KAAK;AACP"}

package/dist/utils/arrays.cjs

@@ -0,0 +1,2 @@
+function e(e,t){let n={};for(let r of e){let e=t(r);(n[e]??=[]).push(r)}return n}function t(e,t){let n=new Set,r=[];for(let i of e){let e=t(i);n.has(e)||(n.add(e),r.push(i))}return r}function n(e,t){if(t<1)throw RangeError(`chunk size must be >= 1, received ${t}`);let n=[];for(let r=0;r<e.length;r+=t)n.push(e.slice(r,r+t));return n}function r(e,t,n=1){let r=[];if(n===0)return r;if(n>0)for(let i=e;i<t;i+=n)r.push(i);else for(let i=e;i>t;i+=n)r.push(i);return r}exports.chunk=n,exports.groupBy=e,exports.range=r,exports.uniqueBy=t;
+//# sourceMappingURL=arrays.cjs.map

package/dist/utils/arrays.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrays.cjs","names":[],"sources":["../../src/utils/arrays.ts"],"sourcesContent":["/**\n * Group items of a list into buckets keyed by the result of `key`.\n *\n * Items preserve their original order within each bucket.\n *\n * @example\n * groupBy([1, 2, 3, 4], (n) => (n % 2 === 0 ? \"even\" : \"odd\"));\n * // { odd: [1, 3], even: [2, 4] }\n *\n * @example\n * groupBy([{ city: \"SP\" }, { city: \"RJ\" }, { city: \"SP\" }], (u) => u.city);\n * // { SP: [{ city: \"SP\" }, { city: \"SP\" }], RJ: [{ city: \"RJ\" }] }\n */\nexport function groupBy<T, K extends PropertyKey>(items: T[], key: (item: T) => K): Record<K, T[]> {\n    const result = {} as Record<K, T[]>;\n    for (const item of items) {\n        const k = key(item);\n        (result[k] ??= []).push(item);\n    }\n    return result;\n}\n\n/**\n * Remove duplicate items, keeping the first occurrence of each distinct key.\n *\n * Equality is determined by the value returned from `key` (compared with `===`).\n *\n * @example\n * uniqueBy([1, 2, 2, 3, 1], (n) => n); // [1, 2, 3]\n *\n * @example\n * uniqueBy(\n *   [{ id: 1, v: \"a\" }, { id: 1, v: \"b\" }, { id: 2, v: \"c\" }],\n *   (u) => u.id,\n * );\n * // [{ id: 1, v: \"a\" }, { id: 2, v: \"c\" }]\n */\nexport function uniqueBy<T>(items: T[], key: (item: T) => unknown): T[] {\n    const seen = new Set<unknown>();\n    const result: T[] = [];\n    for (const item of items) {\n        const k = key(item);\n        if (!seen.has(k)) {\n            seen.add(k);\n            result.push(item);\n        }\n    }\n    return result;\n}\n\n/**\n * Split a list into consecutive chunks of at most `size` items.\n *\n * The final chunk may be smaller than `size`. An empty input yields `[]`.\n *\n * @param items - The list to split.\n * @param size - Maximum chunk length; must be `>= 1`.\n * @throws {RangeError} When `size` is less than `1`.\n *\n * @example\n * chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]\n *\n * @example\n * chunk([], 3); // []\n */\nexport function chunk<T>(items: T[], size: number): T[][] {\n    if (size < 1) {\n        throw new RangeError(`chunk size must be >= 1, received ${size}`);\n    }\n    const result: T[][] = [];\n    for (let i = 0; i < items.length; i += size) {\n        result.push(items.slice(i, i + size));\n    }\n    return result;\n}\n\n/**\n * Build a numeric range from `start` (inclusive) to `end` (exclusive).\n *\n * - `step` defaults to `1` and may be negative for descending ranges.\n * - Returns an empty array when no progress can be made toward `end`\n *   (wrong-direction step, zero step, or `start === end`).\n *\n * @param start - First value of the range.\n * @param end - Exclusive upper (or lower, for negative step) bound.\n * @param step - Increment between values; defaults to `1`.\n *\n * @example\n * range(0, 5);        // [0, 1, 2, 3, 4]\n * range(0, 10, 2);    // [0, 2, 4, 6, 8]\n * range(5, 0, -1);    // [5, 4, 3, 2, 1]\n * range(0, 5, -1);    // [] (wrong direction)\n * range(3, 3);        // []\n */\nexport function range(start: number, end: number, step: number = 1): number[] {\n    const result: number[] = [];\n    if (step === 0) return result;\n    if (step > 0) {\n        for (let i = start; i < end; i += step) result.push(i);\n    } else {\n        for (let i = start; i > end; i += step) result.push(i);\n    }\n    return result;\n}\n"],"mappings":"AAaA,SAAgB,EAAkC,EAAY,EAAqC,CAC/F,IAAM,EAAS,CAAC,EAChB,IAAK,IAAM,KAAQ,EAAO,CACtB,IAAM,EAAI,EAAI,CAAI,GACjB,EAAO,KAAO,CAAC,EAAA,CAAG,KAAK,CAAI,CAChC,CACA,OAAO,CACX,CAiBA,SAAgB,EAAY,EAAY,EAAgC,CACpE,IAAM,EAAO,IAAI,IACX,EAAc,CAAC,EACrB,IAAK,IAAM,KAAQ,EAAO,CACtB,IAAM,EAAI,EAAI,CAAI,EACb,EAAK,IAAI,CAAC,IACX,EAAK,IAAI,CAAC,EACV,EAAO,KAAK,CAAI,EAExB,CACA,OAAO,CACX,CAiBA,SAAgB,EAAS,EAAY,EAAqB,CACtD,GAAI,EAAO,EACP,MAAU,WAAW,qCAAqC,GAAM,EAEpE,IAAM,EAAgB,CAAC,EACvB,IAAK,IAAI,EAAI,EAAG,EAAI,EAAM,OAAQ,GAAK,EACnC,EAAO,KAAK,EAAM,MAAM,EAAG,EAAI,CAAI,CAAC,EAExC,OAAO,CACX,CAoBA,SAAgB,EAAM,EAAe,EAAa,EAAe,EAAa,CAC1E,IAAM,EAAmB,CAAC,EAC1B,GAAI,IAAS,EAAG,OAAO,EACvB,GAAI,EAAO,EACP,IAAK,IAAI,EAAI,EAAO,EAAI,EAAK,GAAK,EAAM,EAAO,KAAK,CAAC,OAErD,IAAK,IAAI,EAAI,EAAO,EAAI,EAAK,GAAK,EAAM,EAAO,KAAK,CAAC,EAEzD,OAAO,CACX"}

package/dist/utils/arrays.js

@@ -0,0 +1,34 @@
+//#region src/utils/arrays.ts
+function e(e, t) {
+	let n = {};
+	for (let r of e) {
+		let e = t(r);
+		(n[e] ??= []).push(r);
+	}
+	return n;
+}
+function t(e, t) {
+	let n = /* @__PURE__ */ new Set(), r = [];
+	for (let i of e) {
+		let e = t(i);
+		n.has(e) || (n.add(e), r.push(i));
+	}
+	return r;
+}
+function n(e, t) {
+	if (t < 1) throw RangeError(`chunk size must be >= 1, received ${t}`);
+	let n = [];
+	for (let r = 0; r < e.length; r += t) n.push(e.slice(r, r + t));
+	return n;
+}
+function r(e, t, n = 1) {
+	let r = [];
+	if (n === 0) return r;
+	if (n > 0) for (let i = e; i < t; i += n) r.push(i);
+	else for (let i = e; i > t; i += n) r.push(i);
+	return r;
+}
+//#endregion
+export { n as chunk, e as groupBy, r as range, t as uniqueBy };
+
+//# sourceMappingURL=arrays.js.map

package/dist/utils/arrays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrays.js","names":[],"sources":["../../src/utils/arrays.ts"],"sourcesContent":["/**\n * Group items of a list into buckets keyed by the result of `key`.\n *\n * Items preserve their original order within each bucket.\n *\n * @example\n * groupBy([1, 2, 3, 4], (n) => (n % 2 === 0 ? \"even\" : \"odd\"));\n * // { odd: [1, 3], even: [2, 4] }\n *\n * @example\n * groupBy([{ city: \"SP\" }, { city: \"RJ\" }, { city: \"SP\" }], (u) => u.city);\n * // { SP: [{ city: \"SP\" }, { city: \"SP\" }], RJ: [{ city: \"RJ\" }] }\n */\nexport function groupBy<T, K extends PropertyKey>(items: T[], key: (item: T) => K): Record<K, T[]> {\n    const result = {} as Record<K, T[]>;\n    for (const item of items) {\n        const k = key(item);\n        (result[k] ??= []).push(item);\n    }\n    return result;\n}\n\n/**\n * Remove duplicate items, keeping the first occurrence of each distinct key.\n *\n * Equality is determined by the value returned from `key` (compared with `===`).\n *\n * @example\n * uniqueBy([1, 2, 2, 3, 1], (n) => n); // [1, 2, 3]\n *\n * @example\n * uniqueBy(\n *   [{ id: 1, v: \"a\" }, { id: 1, v: \"b\" }, { id: 2, v: \"c\" }],\n *   (u) => u.id,\n * );\n * // [{ id: 1, v: \"a\" }, { id: 2, v: \"c\" }]\n */\nexport function uniqueBy<T>(items: T[], key: (item: T) => unknown): T[] {\n    const seen = new Set<unknown>();\n    const result: T[] = [];\n    for (const item of items) {\n        const k = key(item);\n        if (!seen.has(k)) {\n            seen.add(k);\n            result.push(item);\n        }\n    }\n    return result;\n}\n\n/**\n * Split a list into consecutive chunks of at most `size` items.\n *\n * The final chunk may be smaller than `size`. An empty input yields `[]`.\n *\n * @param items - The list to split.\n * @param size - Maximum chunk length; must be `>= 1`.\n * @throws {RangeError} When `size` is less than `1`.\n *\n * @example\n * chunk([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]\n *\n * @example\n * chunk([], 3); // []\n */\nexport function chunk<T>(items: T[], size: number): T[][] {\n    if (size < 1) {\n        throw new RangeError(`chunk size must be >= 1, received ${size}`);\n    }\n    const result: T[][] = [];\n    for (let i = 0; i < items.length; i += size) {\n        result.push(items.slice(i, i + size));\n    }\n    return result;\n}\n\n/**\n * Build a numeric range from `start` (inclusive) to `end` (exclusive).\n *\n * - `step` defaults to `1` and may be negative for descending ranges.\n * - Returns an empty array when no progress can be made toward `end`\n *   (wrong-direction step, zero step, or `start === end`).\n *\n * @param start - First value of the range.\n * @param end - Exclusive upper (or lower, for negative step) bound.\n * @param step - Increment between values; defaults to `1`.\n *\n * @example\n * range(0, 5);        // [0, 1, 2, 3, 4]\n * range(0, 10, 2);    // [0, 2, 4, 6, 8]\n * range(5, 0, -1);    // [5, 4, 3, 2, 1]\n * range(0, 5, -1);    // [] (wrong direction)\n * range(3, 3);        // []\n */\nexport function range(start: number, end: number, step: number = 1): number[] {\n    const result: number[] = [];\n    if (step === 0) return result;\n    if (step > 0) {\n        for (let i = start; i < end; i += step) result.push(i);\n    } else {\n        for (let i = start; i > end; i += step) result.push(i);\n    }\n    return result;\n}\n"],"mappings":";AAaA,SAAgB,EAAkC,GAAY,GAAqC;CAC/F,IAAM,IAAS,CAAC;CAChB,KAAK,IAAM,KAAQ,GAAO;EACtB,IAAM,IAAI,EAAI,CAAI;EAClB,CAAC,EAAO,OAAO,CAAC,EAAA,CAAG,KAAK,CAAI;CAChC;CACA,OAAO;AACX;AAiBA,SAAgB,EAAY,GAAY,GAAgC;CACpE,IAAM,oBAAO,IAAI,IAAa,GACxB,IAAc,CAAC;CACrB,KAAK,IAAM,KAAQ,GAAO;EACtB,IAAM,IAAI,EAAI,CAAI;EAClB,AAAK,EAAK,IAAI,CAAC,MACX,EAAK,IAAI,CAAC,GACV,EAAO,KAAK,CAAI;CAExB;CACA,OAAO;AACX;AAiBA,SAAgB,EAAS,GAAY,GAAqB;CACtD,IAAI,IAAO,GACP,MAAU,WAAW,qCAAqC,GAAM;CAEpE,IAAM,IAAgB,CAAC;CACvB,KAAK,IAAI,IAAI,GAAG,IAAI,EAAM,QAAQ,KAAK,GACnC,EAAO,KAAK,EAAM,MAAM,GAAG,IAAI,CAAI,CAAC;CAExC,OAAO;AACX;AAoBA,SAAgB,EAAM,GAAe,GAAa,IAAe,GAAa;CAC1E,IAAM,IAAmB,CAAC;CAC1B,IAAI,MAAS,GAAG,OAAO;CACvB,IAAI,IAAO,GACP,KAAK,IAAI,IAAI,GAAO,IAAI,GAAK,KAAK,GAAM,EAAO,KAAK,CAAC;MAErD,KAAK,IAAI,IAAI,GAAO,IAAI,GAAK,KAAK,GAAM,EAAO,KAAK,CAAC;CAEzD,OAAO;AACX"}

package/dist/utils/cn.cjs

@@ -0,0 +1,2 @@
+function e(...t){let n=[];for(let r of t)if(!(r==null||r===!1||r===!0)){if(typeof r==`string`)r&&n.push(r);else if(typeof r==`number`||typeof r==`bigint`)n.push(String(r));else if(Array.isArray(r)){let t=e(...r);t&&n.push(t)}}return n.join(` `)}exports.cn=e;
+//# sourceMappingURL=cn.cjs.map

package/dist/utils/cn.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.cjs","names":[],"sources":["../../src/utils/cn.ts"],"sourcesContent":["type ClassValue = string | number | bigint | boolean | null | undefined | ClassValue[];\n\n/**\n * Tiny classnames helper. Accepts strings, falsy values and nested arrays.\n *\n * @param values - Class entries, conditionally truthy.\n * @returns A single space-joined class string.\n */\nexport function cn(...values: ClassValue[]): string {\n    const out: string[] = [];\n    for (const value of values) {\n        if (value === null || value === undefined || value === false || value === true) {\n            continue;\n        }\n        if (typeof value === \"string\") {\n            if (value) out.push(value);\n        } else if (typeof value === \"number\" || typeof value === \"bigint\") {\n            out.push(String(value));\n        } else if (Array.isArray(value)) {\n            const nested = cn(...value);\n            if (nested) out.push(nested);\n        }\n    }\n    return out.join(\" \");\n}\n"],"mappings":"AAQA,SAAgB,EAAG,GAAG,EAA8B,CAChD,IAAM,EAAgB,CAAC,EACvB,IAAK,IAAM,KAAS,EACZ,QAAU,MAA+B,IAAU,IAAS,IAAU,IAG1E,IAAI,OAAO,GAAU,SACb,GAAO,EAAI,KAAK,CAAK,OACtB,GAAI,OAAO,GAAU,UAAY,OAAO,GAAU,SACrD,EAAI,KAAK,OAAO,CAAK,CAAC,OACnB,GAAI,MAAM,QAAQ,CAAK,EAAG,CAC7B,IAAM,EAAS,EAAG,GAAG,CAAK,EACtB,GAAQ,EAAI,KAAK,CAAM,CAC/B,EAEJ,OAAO,EAAI,KAAK,GAAG,CACvB"}

package/dist/utils/cn.js

@@ -0,0 +1,17 @@
+//#region src/utils/cn.ts
+function e(...t) {
+	let n = [];
+	for (let r of t) if (!(r == null || r === !1 || r === !0)) {
+		if (typeof r == "string") r && n.push(r);
+		else if (typeof r == "number" || typeof r == "bigint") n.push(String(r));
+		else if (Array.isArray(r)) {
+			let t = e(...r);
+			t && n.push(t);
+		}
+	}
+	return n.join(" ");
+}
+//#endregion
+export { e as cn };
+
+//# sourceMappingURL=cn.js.map

package/dist/utils/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.js","names":[],"sources":["../../src/utils/cn.ts"],"sourcesContent":["type ClassValue = string | number | bigint | boolean | null | undefined | ClassValue[];\n\n/**\n * Tiny classnames helper. Accepts strings, falsy values and nested arrays.\n *\n * @param values - Class entries, conditionally truthy.\n * @returns A single space-joined class string.\n */\nexport function cn(...values: ClassValue[]): string {\n    const out: string[] = [];\n    for (const value of values) {\n        if (value === null || value === undefined || value === false || value === true) {\n            continue;\n        }\n        if (typeof value === \"string\") {\n            if (value) out.push(value);\n        } else if (typeof value === \"number\" || typeof value === \"bigint\") {\n            out.push(String(value));\n        } else if (Array.isArray(value)) {\n            const nested = cn(...value);\n            if (nested) out.push(nested);\n        }\n    }\n    return out.join(\" \");\n}\n"],"mappings":";AAQA,SAAgB,EAAG,GAAG,GAA8B;CAChD,IAAM,IAAgB,CAAC;CACvB,KAAK,IAAM,KAAS,GACZ,WAAU,QAA+B,MAAU,MAAS,MAAU,KAG1E;MAAI,OAAO,KAAU,UACb,KAAO,EAAI,KAAK,CAAK;OACtB,IAAI,OAAO,KAAU,YAAY,OAAO,KAAU,UACrD,EAAI,KAAK,OAAO,CAAK,CAAC;OACnB,IAAI,MAAM,QAAQ,CAAK,GAAG;GAC7B,IAAM,IAAS,EAAG,GAAG,CAAK;GAC1B,AAAI,KAAQ,EAAI,KAAK,CAAM;EAC/B;;CAEJ,OAAO,EAAI,KAAK,GAAG;AACvB"}

package/dist/utils/format.cjs

@@ -0,0 +1,2 @@
+function e(e){return new Intl.NumberFormat(`pt-BR`,{style:`currency`,currency:`BRL`}).format(e)}function t(e){let t=typeof e==`string`?new Date(e):e;return Number.isNaN(t.getTime())?``:new Intl.DateTimeFormat(`pt-BR`).format(t)}function n(e){let t=typeof e==`string`?new Date(e):e;return Number.isNaN(t.getTime())?``:new Intl.DateTimeFormat(`pt-BR`,{dateStyle:`short`,timeStyle:`short`}).format(t)}function r(e){let t=e.replace(/\D/g,``).slice(0,11);return t.length<=10?t.replace(/(\d{2})(\d)/,`($1) $2`).replace(/(\d{4})(\d)/,`$1-$2`):t.replace(/(\d{2})(\d)/,`($1) $2`).replace(/(\d{5})(\d)/,`$1-$2`)}function i(e){return e.replace(/\D/g,``).slice(0,11).replace(/(\d{3})(\d)/,`$1.$2`).replace(/(\d{3})(\d)/,`$1.$2`).replace(/(\d{3})(\d{1,2})$/,`$1-$2`)}function a(e){return new Intl.NumberFormat(`pt-BR`,{style:`percent`,minimumFractionDigits:1,maximumFractionDigits:1}).format(e)}exports.formatCPF=i,exports.formatCurrency=e,exports.formatDate=t,exports.formatDateTime=n,exports.formatPercent=a,exports.formatPhone=r;
+//# sourceMappingURL=format.cjs.map

package/dist/utils/format.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.cjs","names":[],"sources":["../../src/utils/format.ts"],"sourcesContent":["/**\n * Format a number as Brazilian Real currency.\n *\n * @param value - The amount in BRL.\n * @returns A locale-formatted string, e.g. \"R$ 1.234,56\".\n */\nexport function formatCurrency(value: number): string {\n    return new Intl.NumberFormat(\"pt-BR\", {\n        style: \"currency\",\n        currency: \"BRL\",\n    }).format(value);\n}\n\n/**\n * Format an ISO date or Date instance as `dd/MM/yyyy`.\n *\n * @param value - ISO string or Date.\n * @returns Formatted date string, or empty string when input is invalid.\n */\nexport function formatDate(value: string | Date): string {\n    const date = typeof value === \"string\" ? new Date(value) : value;\n    if (Number.isNaN(date.getTime())) return \"\";\n    return new Intl.DateTimeFormat(\"pt-BR\").format(date);\n}\n\n/**\n * Format an ISO date or Date instance as `dd/MM/yyyy HH:mm`.\n *\n * @param value - ISO string or Date.\n * @returns Formatted datetime string, or empty string when input is invalid.\n */\nexport function formatDateTime(value: string | Date): string {\n    const date = typeof value === \"string\" ? new Date(value) : value;\n    if (Number.isNaN(date.getTime())) return \"\";\n    return new Intl.DateTimeFormat(\"pt-BR\", {\n        dateStyle: \"short\",\n        timeStyle: \"short\",\n    }).format(date);\n}\n\n/**\n * Apply the Brazilian phone mask `(XX) XXXXX-XXXX` or `(XX) XXXX-XXXX`.\n *\n * @param value - Raw digits or partially masked string.\n * @returns Masked phone string.\n */\nexport function formatPhone(value: string): string {\n    const digits = value.replace(/\\D/g, \"\").slice(0, 11);\n    if (digits.length <= 10) {\n        return digits.replace(/(\\d{2})(\\d)/, \"($1) $2\").replace(/(\\d{4})(\\d)/, \"$1-$2\");\n    }\n    return digits.replace(/(\\d{2})(\\d)/, \"($1) $2\").replace(/(\\d{5})(\\d)/, \"$1-$2\");\n}\n\n/**\n * Apply the Brazilian CPF mask `XXX.XXX.XXX-XX`.\n *\n * @param value - Raw digits or partially masked string.\n * @returns Masked CPF string.\n */\nexport function formatCPF(value: string): string {\n    return value\n        .replace(/\\D/g, \"\")\n        .slice(0, 11)\n        .replace(/(\\d{3})(\\d)/, \"$1.$2\")\n        .replace(/(\\d{3})(\\d)/, \"$1.$2\")\n        .replace(/(\\d{3})(\\d{1,2})$/, \"$1-$2\");\n}\n\n/**\n * Format a fraction (0-1) as a percentage with one decimal.\n *\n * @param value - Fraction between 0 and 1.\n * @returns Formatted percent string, e.g. \"12,5%\".\n */\nexport function formatPercent(value: number): string {\n    return new Intl.NumberFormat(\"pt-BR\", {\n        style: \"percent\",\n        minimumFractionDigits: 1,\n        maximumFractionDigits: 1,\n    }).format(value);\n}\n"],"mappings":"AAMA,SAAgB,EAAe,EAAuB,CAClD,OAAO,IAAI,KAAK,aAAa,QAAS,CAClC,MAAO,WACP,SAAU,KACd,CAAC,CAAC,CAAC,OAAO,CAAK,CACnB,CAQA,SAAgB,EAAW,EAA8B,CACrD,IAAM,EAAO,OAAO,GAAU,SAAW,IAAI,KAAK,CAAK,EAAI,EAE3D,OADI,OAAO,MAAM,EAAK,QAAQ,CAAC,EAAU,GAClC,IAAI,KAAK,eAAe,OAAO,CAAC,CAAC,OAAO,CAAI,CACvD,CAQA,SAAgB,EAAe,EAA8B,CACzD,IAAM,EAAO,OAAO,GAAU,SAAW,IAAI,KAAK,CAAK,EAAI,EAE3D,OADI,OAAO,MAAM,EAAK,QAAQ,CAAC,EAAU,GAClC,IAAI,KAAK,eAAe,QAAS,CACpC,UAAW,QACX,UAAW,OACf,CAAC,CAAC,CAAC,OAAO,CAAI,CAClB,CAQA,SAAgB,EAAY,EAAuB,CAC/C,IAAM,EAAS,EAAM,QAAQ,MAAO,EAAE,CAAC,CAAC,MAAM,EAAG,EAAE,EAInD,OAHI,EAAO,QAAU,GACV,EAAO,QAAQ,cAAe,SAAS,CAAC,CAAC,QAAQ,cAAe,OAAO,EAE3E,EAAO,QAAQ,cAAe,SAAS,CAAC,CAAC,QAAQ,cAAe,OAAO,CAClF,CAQA,SAAgB,EAAU,EAAuB,CAC7C,OAAO,EACF,QAAQ,MAAO,EAAE,CAAC,CAClB,MAAM,EAAG,EAAE,CAAC,CACZ,QAAQ,cAAe,OAAO,CAAC,CAC/B,QAAQ,cAAe,OAAO,CAAC,CAC/B,QAAQ,oBAAqB,OAAO,CAC7C,CAQA,SAAgB,EAAc,EAAuB,CACjD,OAAO,IAAI,KAAK,aAAa,QAAS,CAClC,MAAO,UACP,sBAAuB,EACvB,sBAAuB,CAC3B,CAAC,CAAC,CAAC,OAAO,CAAK,CACnB"}

package/dist/utils/format.js

@@ -0,0 +1,36 @@
+//#region src/utils/format.ts
+function e(e) {
+	return new Intl.NumberFormat("pt-BR", {
+		style: "currency",
+		currency: "BRL"
+	}).format(e);
+}
+function t(e) {
+	let t = typeof e == "string" ? new Date(e) : e;
+	return Number.isNaN(t.getTime()) ? "" : new Intl.DateTimeFormat("pt-BR").format(t);
+}
+function n(e) {
+	let t = typeof e == "string" ? new Date(e) : e;
+	return Number.isNaN(t.getTime()) ? "" : new Intl.DateTimeFormat("pt-BR", {
+		dateStyle: "short",
+		timeStyle: "short"
+	}).format(t);
+}
+function r(e) {
+	let t = e.replace(/\D/g, "").slice(0, 11);
+	return t.length <= 10 ? t.replace(/(\d{2})(\d)/, "($1) $2").replace(/(\d{4})(\d)/, "$1-$2") : t.replace(/(\d{2})(\d)/, "($1) $2").replace(/(\d{5})(\d)/, "$1-$2");
+}
+function i(e) {
+	return e.replace(/\D/g, "").slice(0, 11).replace(/(\d{3})(\d)/, "$1.$2").replace(/(\d{3})(\d)/, "$1.$2").replace(/(\d{3})(\d{1,2})$/, "$1-$2");
+}
+function a(e) {
+	return new Intl.NumberFormat("pt-BR", {
+		style: "percent",
+		minimumFractionDigits: 1,
+		maximumFractionDigits: 1
+	}).format(e);
+}
+//#endregion
+export { i as formatCPF, e as formatCurrency, t as formatDate, n as formatDateTime, a as formatPercent, r as formatPhone };
+
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","names":[],"sources":["../../src/utils/format.ts"],"sourcesContent":["/**\n * Format a number as Brazilian Real currency.\n *\n * @param value - The amount in BRL.\n * @returns A locale-formatted string, e.g. \"R$ 1.234,56\".\n */\nexport function formatCurrency(value: number): string {\n    return new Intl.NumberFormat(\"pt-BR\", {\n        style: \"currency\",\n        currency: \"BRL\",\n    }).format(value);\n}\n\n/**\n * Format an ISO date or Date instance as `dd/MM/yyyy`.\n *\n * @param value - ISO string or Date.\n * @returns Formatted date string, or empty string when input is invalid.\n */\nexport function formatDate(value: string | Date): string {\n    const date = typeof value === \"string\" ? new Date(value) : value;\n    if (Number.isNaN(date.getTime())) return \"\";\n    return new Intl.DateTimeFormat(\"pt-BR\").format(date);\n}\n\n/**\n * Format an ISO date or Date instance as `dd/MM/yyyy HH:mm`.\n *\n * @param value - ISO string or Date.\n * @returns Formatted datetime string, or empty string when input is invalid.\n */\nexport function formatDateTime(value: string | Date): string {\n    const date = typeof value === \"string\" ? new Date(value) : value;\n    if (Number.isNaN(date.getTime())) return \"\";\n    return new Intl.DateTimeFormat(\"pt-BR\", {\n        dateStyle: \"short\",\n        timeStyle: \"short\",\n    }).format(date);\n}\n\n/**\n * Apply the Brazilian phone mask `(XX) XXXXX-XXXX` or `(XX) XXXX-XXXX`.\n *\n * @param value - Raw digits or partially masked string.\n * @returns Masked phone string.\n */\nexport function formatPhone(value: string): string {\n    const digits = value.replace(/\\D/g, \"\").slice(0, 11);\n    if (digits.length <= 10) {\n        return digits.replace(/(\\d{2})(\\d)/, \"($1) $2\").replace(/(\\d{4})(\\d)/, \"$1-$2\");\n    }\n    return digits.replace(/(\\d{2})(\\d)/, \"($1) $2\").replace(/(\\d{5})(\\d)/, \"$1-$2\");\n}\n\n/**\n * Apply the Brazilian CPF mask `XXX.XXX.XXX-XX`.\n *\n * @param value - Raw digits or partially masked string.\n * @returns Masked CPF string.\n */\nexport function formatCPF(value: string): string {\n    return value\n        .replace(/\\D/g, \"\")\n        .slice(0, 11)\n        .replace(/(\\d{3})(\\d)/, \"$1.$2\")\n        .replace(/(\\d{3})(\\d)/, \"$1.$2\")\n        .replace(/(\\d{3})(\\d{1,2})$/, \"$1-$2\");\n}\n\n/**\n * Format a fraction (0-1) as a percentage with one decimal.\n *\n * @param value - Fraction between 0 and 1.\n * @returns Formatted percent string, e.g. \"12,5%\".\n */\nexport function formatPercent(value: number): string {\n    return new Intl.NumberFormat(\"pt-BR\", {\n        style: \"percent\",\n        minimumFractionDigits: 1,\n        maximumFractionDigits: 1,\n    }).format(value);\n}\n"],"mappings":";AAMA,SAAgB,EAAe,GAAuB;CAClD,OAAO,IAAI,KAAK,aAAa,SAAS;EAClC,OAAO;EACP,UAAU;CACd,CAAC,CAAC,CAAC,OAAO,CAAK;AACnB;AAQA,SAAgB,EAAW,GAA8B;CACrD,IAAM,IAAO,OAAO,KAAU,WAAW,IAAI,KAAK,CAAK,IAAI;CAE3D,OADI,OAAO,MAAM,EAAK,QAAQ,CAAC,IAAU,KAClC,IAAI,KAAK,eAAe,OAAO,CAAC,CAAC,OAAO,CAAI;AACvD;AAQA,SAAgB,EAAe,GAA8B;CACzD,IAAM,IAAO,OAAO,KAAU,WAAW,IAAI,KAAK,CAAK,IAAI;CAE3D,OADI,OAAO,MAAM,EAAK,QAAQ,CAAC,IAAU,KAClC,IAAI,KAAK,eAAe,SAAS;EACpC,WAAW;EACX,WAAW;CACf,CAAC,CAAC,CAAC,OAAO,CAAI;AAClB;AAQA,SAAgB,EAAY,GAAuB;CAC/C,IAAM,IAAS,EAAM,QAAQ,OAAO,EAAE,CAAC,CAAC,MAAM,GAAG,EAAE;CAInD,OAHI,EAAO,UAAU,KACV,EAAO,QAAQ,eAAe,SAAS,CAAC,CAAC,QAAQ,eAAe,OAAO,IAE3E,EAAO,QAAQ,eAAe,SAAS,CAAC,CAAC,QAAQ,eAAe,OAAO;AAClF;AAQA,SAAgB,EAAU,GAAuB;CAC7C,OAAO,EACF,QAAQ,OAAO,EAAE,CAAC,CAClB,MAAM,GAAG,EAAE,CAAC,CACZ,QAAQ,eAAe,OAAO,CAAC,CAC/B,QAAQ,eAAe,OAAO,CAAC,CAC/B,QAAQ,qBAAqB,OAAO;AAC7C;AAQA,SAAgB,EAAc,GAAuB;CACjD,OAAO,IAAI,KAAK,aAAa,SAAS;EAClC,OAAO;EACP,uBAAuB;EACvB,uBAAuB;CAC3B,CAAC,CAAC,CAAC,OAAO,CAAK;AACnB"}

package/dist/utils/functions.cjs

@@ -0,0 +1,2 @@
+function e(e,t){let n,r=(...r)=>{n!==void 0&&clearTimeout(n),n=setTimeout(()=>{n=void 0,e(...r)},t)};return r.cancel=()=>{n!==void 0&&(clearTimeout(n),n=void 0)},r}function t(e,t){let n,r,i=0,a=t=>{i=Date.now(),e(...t)},o=(...e)=>{let o=t-(Date.now()-i);o<=0?(n!==void 0&&(clearTimeout(n),n=void 0),a(e)):(r=e,n===void 0&&(n=setTimeout(()=>{if(n=void 0,r!==void 0){let e=r;r=void 0,a(e)}},o)))};return o.cancel=()=>{n!==void 0&&(clearTimeout(n),n=void 0),r=void 0,i=0},o}function n(e){let t=!1,n;return(...r)=>(t||(t=!0,n=e(...r)),n)}function r(e){let t=!1,n,r,i=e=>{if(!t||e.length!==n.length)return!1;for(let t=0;t<e.length;t++)if(!Object.is(e[t],n[t]))return!1;return!0};return(...a)=>i(a)?r:(n=a,r=e(...a),t=!0,r)}exports.debounce=e,exports.memoizeOne=r,exports.once=n,exports.throttle=t;
+//# sourceMappingURL=functions.cjs.map

package/dist/utils/functions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.cjs","names":[],"sources":["../../src/utils/functions.ts"],"sourcesContent":["/**\n * Create a trailing-edge debounced version of `fn`.\n *\n * The wrapped function delays invoking `fn` until `wait` milliseconds have\n * elapsed since the last time it was called. Only the latest arguments are\n * used. Call `.cancel()` to clear any pending invocation.\n *\n * @example\n * const save = debounce((q: string) => search(q), 300);\n * save(\"a\"); save(\"ab\"); save(\"abc\"); // only \"abc\" runs after 300ms\n * save.cancel();                       // nothing runs\n */\nexport function debounce<A extends unknown[]>(\n    fn: (...args: A) => void,\n    wait: number,\n): ((...args: A) => void) & { cancel: () => void } {\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    const debounced = (...args: A): void => {\n        if (timer !== undefined) clearTimeout(timer);\n        timer = setTimeout(() => {\n            timer = undefined;\n            fn(...args);\n        }, wait);\n    };\n\n    debounced.cancel = (): void => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n            timer = undefined;\n        }\n    };\n\n    return debounced;\n}\n\n/**\n * Create a throttled version of `fn` with leading and trailing edges.\n *\n * `fn` runs immediately on the first call (leading edge), then at most once\n * per `wait` milliseconds. If calls happen during the wait window, the last\n * one fires on the trailing edge. Call `.cancel()` to drop any pending\n * trailing call and reset the window.\n *\n * @example\n * const onScroll = throttle(() => render(), 200);\n * window.addEventListener(\"scroll\", onScroll);\n * onScroll.cancel();\n */\nexport function throttle<A extends unknown[]>(\n    fn: (...args: A) => void,\n    wait: number,\n): ((...args: A) => void) & { cancel: () => void } {\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    let lastArgs: A | undefined;\n    let lastInvoke = 0;\n\n    const invoke = (args: A): void => {\n        lastInvoke = Date.now();\n        fn(...args);\n    };\n\n    const throttled = (...args: A): void => {\n        const now = Date.now();\n        const remaining = wait - (now - lastInvoke);\n\n        if (remaining <= 0) {\n            if (timer !== undefined) {\n                clearTimeout(timer);\n                timer = undefined;\n            }\n            invoke(args);\n        } else {\n            lastArgs = args;\n            if (timer === undefined) {\n                timer = setTimeout(() => {\n                    timer = undefined;\n                    if (lastArgs !== undefined) {\n                        const pending = lastArgs;\n                        lastArgs = undefined;\n                        invoke(pending);\n                    }\n                }, remaining);\n            }\n        }\n    };\n\n    throttled.cancel = (): void => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n            timer = undefined;\n        }\n        lastArgs = undefined;\n        lastInvoke = 0;\n    };\n\n    return throttled;\n}\n\n/**\n * Wrap `fn` so it runs at most once; subsequent calls return the cached result.\n *\n * @example\n * const init = once(() => expensiveSetup());\n * init(); // runs expensiveSetup()\n * init(); // returns the same cached result, no re-run\n */\nexport function once<A extends unknown[], R>(fn: (...args: A) => R): (...args: A) => R {\n    let called = false;\n    let result: R;\n\n    return (...args: A): R => {\n        if (!called) {\n            called = true;\n            result = fn(...args);\n        }\n        return result;\n    };\n}\n\n/**\n * Memoize only the most recent call of `fn`, keyed by shallow-equal arguments.\n *\n * If the next call has the same arguments (compared with `Object.is` per\n * position and equal length), the cached result is returned without re-running\n * `fn`. Any different argument list recomputes and replaces the cache.\n *\n * @example\n * const select = memoizeOne((a: number, b: number) => a + b);\n * select(1, 2); // computes 3\n * select(1, 2); // cached 3\n * select(2, 2); // recomputes 4\n */\nexport function memoizeOne<A extends unknown[], R>(fn: (...args: A) => R): (...args: A) => R {\n    let hasCache = false;\n    let lastArgs: A;\n    let lastResult: R;\n\n    const sameArgs = (next: A): boolean => {\n        if (!hasCache || next.length !== lastArgs.length) return false;\n        for (let i = 0; i < next.length; i++) {\n            if (!Object.is(next[i], lastArgs[i])) return false;\n        }\n        return true;\n    };\n\n    return (...args: A): R => {\n        if (sameArgs(args)) return lastResult;\n        lastArgs = args;\n        lastResult = fn(...args);\n        hasCache = true;\n        return lastResult;\n    };\n}\n"],"mappings":"AAYA,SAAgB,EACZ,EACA,EAC+C,CAC/C,IAAI,EAEE,GAAa,GAAG,IAAkB,CAChC,IAAU,IAAA,IAAW,aAAa,CAAK,EAC3C,EAAQ,eAAiB,CACrB,EAAQ,IAAA,GACR,EAAG,GAAG,CAAI,CACd,EAAG,CAAI,CACX,EASA,MAPA,GAAU,WAAqB,CACvB,IAAU,IAAA,KACV,aAAa,CAAK,EAClB,EAAQ,IAAA,GAEhB,EAEO,CACX,CAeA,SAAgB,EACZ,EACA,EAC+C,CAC/C,IAAI,EACA,EACA,EAAa,EAEX,EAAU,GAAkB,CAC9B,EAAa,KAAK,IAAI,EACtB,EAAG,GAAG,CAAI,CACd,EAEM,GAAa,GAAG,IAAkB,CAEpC,IAAM,EAAY,GADN,KAAK,IACS,EAAM,GAE5B,GAAa,GACT,IAAU,IAAA,KACV,aAAa,CAAK,EAClB,EAAQ,IAAA,IAEZ,EAAO,CAAI,IAEX,EAAW,EACP,IAAU,IAAA,KACV,EAAQ,eAAiB,CAErB,GADA,EAAQ,IAAA,GACJ,IAAa,IAAA,GAAW,CACxB,IAAM,EAAU,EAChB,EAAW,IAAA,GACX,EAAO,CAAO,CAClB,CACJ,EAAG,CAAS,GAGxB,EAWA,MATA,GAAU,WAAqB,CACvB,IAAU,IAAA,KACV,aAAa,CAAK,EAClB,EAAQ,IAAA,IAEZ,EAAW,IAAA,GACX,EAAa,CACjB,EAEO,CACX,CAUA,SAAgB,EAA6B,EAA0C,CACnF,IAAI,EAAS,GACT,EAEJ,OAAQ,GAAG,KACF,IACD,EAAS,GACT,EAAS,EAAG,GAAG,CAAI,GAEhB,EAEf,CAeA,SAAgB,EAAmC,EAA0C,CACzF,IAAI,EAAW,GACX,EACA,EAEE,EAAY,GAAqB,CACnC,GAAI,CAAC,GAAY,EAAK,SAAW,EAAS,OAAQ,MAAO,GACzD,IAAK,IAAI,EAAI,EAAG,EAAI,EAAK,OAAQ,IAC7B,GAAI,CAAC,OAAO,GAAG,EAAK,GAAI,EAAS,EAAE,EAAG,MAAO,GAEjD,MAAO,EACX,EAEA,OAAQ,GAAG,IACH,EAAS,CAAI,EAAU,GAC3B,EAAW,EACX,EAAa,EAAG,GAAG,CAAI,EACvB,EAAW,GACJ,EAEf"}

package/dist/utils/functions.js

@@ -0,0 +1,43 @@
+//#region src/utils/functions.ts
+function e(e, t) {
+	let n, r = (...r) => {
+		n !== void 0 && clearTimeout(n), n = setTimeout(() => {
+			n = void 0, e(...r);
+		}, t);
+	};
+	return r.cancel = () => {
+		n !== void 0 && (clearTimeout(n), n = void 0);
+	}, r;
+}
+function t(e, t) {
+	let n, r, i = 0, a = (t) => {
+		i = Date.now(), e(...t);
+	}, o = (...e) => {
+		let o = t - (Date.now() - i);
+		o <= 0 ? (n !== void 0 && (clearTimeout(n), n = void 0), a(e)) : (r = e, n === void 0 && (n = setTimeout(() => {
+			if (n = void 0, r !== void 0) {
+				let e = r;
+				r = void 0, a(e);
+			}
+		}, o)));
+	};
+	return o.cancel = () => {
+		n !== void 0 && (clearTimeout(n), n = void 0), r = void 0, i = 0;
+	}, o;
+}
+function n(e) {
+	let t = !1, n;
+	return (...r) => (t || (t = !0, n = e(...r)), n);
+}
+function r(e) {
+	let t = !1, n, r, i = (e) => {
+		if (!t || e.length !== n.length) return !1;
+		for (let t = 0; t < e.length; t++) if (!Object.is(e[t], n[t])) return !1;
+		return !0;
+	};
+	return (...a) => i(a) ? r : (n = a, r = e(...a), t = !0, r);
+}
+//#endregion
+export { e as debounce, r as memoizeOne, n as once, t as throttle };
+
+//# sourceMappingURL=functions.js.map

package/dist/utils/functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.js","names":[],"sources":["../../src/utils/functions.ts"],"sourcesContent":["/**\n * Create a trailing-edge debounced version of `fn`.\n *\n * The wrapped function delays invoking `fn` until `wait` milliseconds have\n * elapsed since the last time it was called. Only the latest arguments are\n * used. Call `.cancel()` to clear any pending invocation.\n *\n * @example\n * const save = debounce((q: string) => search(q), 300);\n * save(\"a\"); save(\"ab\"); save(\"abc\"); // only \"abc\" runs after 300ms\n * save.cancel();                       // nothing runs\n */\nexport function debounce<A extends unknown[]>(\n    fn: (...args: A) => void,\n    wait: number,\n): ((...args: A) => void) & { cancel: () => void } {\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    const debounced = (...args: A): void => {\n        if (timer !== undefined) clearTimeout(timer);\n        timer = setTimeout(() => {\n            timer = undefined;\n            fn(...args);\n        }, wait);\n    };\n\n    debounced.cancel = (): void => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n            timer = undefined;\n        }\n    };\n\n    return debounced;\n}\n\n/**\n * Create a throttled version of `fn` with leading and trailing edges.\n *\n * `fn` runs immediately on the first call (leading edge), then at most once\n * per `wait` milliseconds. If calls happen during the wait window, the last\n * one fires on the trailing edge. Call `.cancel()` to drop any pending\n * trailing call and reset the window.\n *\n * @example\n * const onScroll = throttle(() => render(), 200);\n * window.addEventListener(\"scroll\", onScroll);\n * onScroll.cancel();\n */\nexport function throttle<A extends unknown[]>(\n    fn: (...args: A) => void,\n    wait: number,\n): ((...args: A) => void) & { cancel: () => void } {\n    let timer: ReturnType<typeof setTimeout> | undefined;\n    let lastArgs: A | undefined;\n    let lastInvoke = 0;\n\n    const invoke = (args: A): void => {\n        lastInvoke = Date.now();\n        fn(...args);\n    };\n\n    const throttled = (...args: A): void => {\n        const now = Date.now();\n        const remaining = wait - (now - lastInvoke);\n\n        if (remaining <= 0) {\n            if (timer !== undefined) {\n                clearTimeout(timer);\n                timer = undefined;\n            }\n            invoke(args);\n        } else {\n            lastArgs = args;\n            if (timer === undefined) {\n                timer = setTimeout(() => {\n                    timer = undefined;\n                    if (lastArgs !== undefined) {\n                        const pending = lastArgs;\n                        lastArgs = undefined;\n                        invoke(pending);\n                    }\n                }, remaining);\n            }\n        }\n    };\n\n    throttled.cancel = (): void => {\n        if (timer !== undefined) {\n            clearTimeout(timer);\n            timer = undefined;\n        }\n        lastArgs = undefined;\n        lastInvoke = 0;\n    };\n\n    return throttled;\n}\n\n/**\n * Wrap `fn` so it runs at most once; subsequent calls return the cached result.\n *\n * @example\n * const init = once(() => expensiveSetup());\n * init(); // runs expensiveSetup()\n * init(); // returns the same cached result, no re-run\n */\nexport function once<A extends unknown[], R>(fn: (...args: A) => R): (...args: A) => R {\n    let called = false;\n    let result: R;\n\n    return (...args: A): R => {\n        if (!called) {\n            called = true;\n            result = fn(...args);\n        }\n        return result;\n    };\n}\n\n/**\n * Memoize only the most recent call of `fn`, keyed by shallow-equal arguments.\n *\n * If the next call has the same arguments (compared with `Object.is` per\n * position and equal length), the cached result is returned without re-running\n * `fn`. Any different argument list recomputes and replaces the cache.\n *\n * @example\n * const select = memoizeOne((a: number, b: number) => a + b);\n * select(1, 2); // computes 3\n * select(1, 2); // cached 3\n * select(2, 2); // recomputes 4\n */\nexport function memoizeOne<A extends unknown[], R>(fn: (...args: A) => R): (...args: A) => R {\n    let hasCache = false;\n    let lastArgs: A;\n    let lastResult: R;\n\n    const sameArgs = (next: A): boolean => {\n        if (!hasCache || next.length !== lastArgs.length) return false;\n        for (let i = 0; i < next.length; i++) {\n            if (!Object.is(next[i], lastArgs[i])) return false;\n        }\n        return true;\n    };\n\n    return (...args: A): R => {\n        if (sameArgs(args)) return lastResult;\n        lastArgs = args;\n        lastResult = fn(...args);\n        hasCache = true;\n        return lastResult;\n    };\n}\n"],"mappings":";AAYA,SAAgB,EACZ,GACA,GAC+C;CAC/C,IAAI,GAEE,KAAa,GAAG,MAAkB;EAEpC,AADI,MAAU,KAAA,KAAW,aAAa,CAAK,GAC3C,IAAQ,iBAAiB;GAErB,AADA,IAAQ,KAAA,GACR,EAAG,GAAG,CAAI;EACd,GAAG,CAAI;CACX;CASA,OAPA,EAAU,eAAqB;EAC3B,AAAI,MAAU,KAAA,MACV,aAAa,CAAK,GAClB,IAAQ,KAAA;CAEhB,GAEO;AACX;AAeA,SAAgB,EACZ,GACA,GAC+C;CAC/C,IAAI,GACA,GACA,IAAa,GAEX,KAAU,MAAkB;EAE9B,AADA,IAAa,KAAK,IAAI,GACtB,EAAG,GAAG,CAAI;CACd,GAEM,KAAa,GAAG,MAAkB;EAEpC,IAAM,IAAY,KADN,KAAK,IACS,IAAM;EAEhC,AAAI,KAAa,KACT,MAAU,KAAA,MACV,aAAa,CAAK,GAClB,IAAQ,KAAA,IAEZ,EAAO,CAAI,MAEX,IAAW,GACP,MAAU,KAAA,MACV,IAAQ,iBAAiB;GAErB,IADA,IAAQ,KAAA,GACJ,MAAa,KAAA,GAAW;IACxB,IAAM,IAAU;IAEhB,AADA,IAAW,KAAA,GACX,EAAO,CAAO;GAClB;EACJ,GAAG,CAAS;CAGxB;CAWA,OATA,EAAU,eAAqB;EAM3B,AALI,MAAU,KAAA,MACV,aAAa,CAAK,GAClB,IAAQ,KAAA,IAEZ,IAAW,KAAA,GACX,IAAa;CACjB,GAEO;AACX;AAUA,SAAgB,EAA6B,GAA0C;CACnF,IAAI,IAAS,IACT;CAEJ,QAAQ,GAAG,OACF,MACD,IAAS,IACT,IAAS,EAAG,GAAG,CAAI,IAEhB;AAEf;AAeA,SAAgB,EAAmC,GAA0C;CACzF,IAAI,IAAW,IACX,GACA,GAEE,KAAY,MAAqB;EACnC,IAAI,CAAC,KAAY,EAAK,WAAW,EAAS,QAAQ,OAAO;EACzD,KAAK,IAAI,IAAI,GAAG,IAAI,EAAK,QAAQ,KAC7B,IAAI,CAAC,OAAO,GAAG,EAAK,IAAI,EAAS,EAAE,GAAG,OAAO;EAEjD,OAAO;CACX;CAEA,QAAQ,GAAG,MACH,EAAS,CAAI,IAAU,KAC3B,IAAW,GACX,IAAa,EAAG,GAAG,CAAI,GACvB,IAAW,IACJ;AAEf"}

package/dist/utils/guards.cjs

@@ -0,0 +1,2 @@
+function e(e){return e!=null}function t(e){return typeof e==`string`}function n(e){return typeof e==`number`&&!Number.isNaN(e)}function r(e){if(typeof e!=`object`||!e)return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function i(e,t){throw Error(t??`Unexpected value: ${String(e)}`)}exports.assertNever=i,exports.isDefined=e,exports.isNumber=n,exports.isPlainObject=r,exports.isString=t;
+//# sourceMappingURL=guards.cjs.map

package/dist/utils/guards.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.cjs","names":[],"sources":["../../src/utils/guards.ts"],"sourcesContent":["/**\n * Type guard asserting a value is neither `null` nor `undefined`.\n *\n * Useful for narrowing in `Array.prototype.filter` to drop nullish entries\n * while preserving the element type.\n *\n * @example\n * const xs: (number | null)[] = [1, null, 2];\n * const clean: number[] = xs.filter(isDefined); // [1, 2]\n */\nexport function isDefined<T>(value: T | null | undefined): value is T {\n    return value !== null && value !== undefined;\n}\n\n/**\n * Type guard asserting a value is a string primitive.\n *\n * @example\n * isString(\"hi\"); // true\n * isString(42);   // false\n */\nexport function isString(value: unknown): value is string {\n    return typeof value === \"string\";\n}\n\n/**\n * Type guard asserting a value is a number, excluding `NaN`.\n *\n * @example\n * isNumber(42);       // true\n * isNumber(NaN);      // false\n * isNumber(\"42\");     // false\n */\nexport function isNumber(value: unknown): value is number {\n    return typeof value === \"number\" && !Number.isNaN(value);\n}\n\n/**\n * Type guard asserting a value is a plain object literal.\n *\n * Returns `false` for arrays, `null`, dates, maps, sets, and class instances —\n * only objects created from `{}` / `Object.create(null)` / object literals pass.\n *\n * @example\n * isPlainObject({ a: 1 });     // true\n * isPlainObject([]);           // false\n * isPlainObject(null);         // false\n * isPlainObject(new Date());   // false\n */\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n    if (typeof value !== \"object\" || value === null) return false;\n    const proto = Object.getPrototypeOf(value);\n    return proto === Object.prototype || proto === null;\n}\n\n/**\n * Assert that a code path is unreachable, throwing at runtime if reached.\n *\n * Use in the `default` branch of an exhaustive `switch` so TypeScript flags any\n * unhandled union member at compile time and the runtime fails loudly if an\n * unexpected value slips through.\n *\n * @param value - The value that should be of type `never`.\n * @param message - Optional custom error message.\n * @throws {Error} Always.\n *\n * @example\n * type Shape = \"circle\" | \"square\";\n * function area(shape: Shape): number {\n *   switch (shape) {\n *     case \"circle\": return 1;\n *     case \"square\": return 2;\n *     default: return assertNever(shape);\n *   }\n * }\n */\nexport function assertNever(value: never, message?: string): never {\n    throw new Error(message ?? `Unexpected value: ${String(value)}`);\n}\n"],"mappings":"AAUA,SAAgB,EAAa,EAAyC,CAClE,OAAO,GAAU,IACrB,CASA,SAAgB,EAAS,EAAiC,CACtD,OAAO,OAAO,GAAU,QAC5B,CAUA,SAAgB,EAAS,EAAiC,CACtD,OAAO,OAAO,GAAU,UAAY,CAAC,OAAO,MAAM,CAAK,CAC3D,CAcA,SAAgB,EAAc,EAAkD,CAC5E,GAAI,OAAO,GAAU,WAAY,EAAgB,MAAO,GACxD,IAAM,EAAQ,OAAO,eAAe,CAAK,EACzC,OAAO,IAAU,OAAO,WAAa,IAAU,IACnD,CAuBA,SAAgB,EAAY,EAAc,EAAyB,CAC/D,MAAU,MAAM,GAAW,qBAAqB,OAAO,CAAK,GAAG,CACnE"}

package/dist/utils/guards.js

@@ -0,0 +1,22 @@
+//#region src/utils/guards.ts
+function e(e) {
+	return e != null;
+}
+function t(e) {
+	return typeof e == "string";
+}
+function n(e) {
+	return typeof e == "number" && !Number.isNaN(e);
+}
+function r(e) {
+	if (typeof e != "object" || !e) return !1;
+	let t = Object.getPrototypeOf(e);
+	return t === Object.prototype || t === null;
+}
+function i(e, t) {
+	throw Error(t ?? `Unexpected value: ${String(e)}`);
+}
+//#endregion
+export { i as assertNever, e as isDefined, n as isNumber, r as isPlainObject, t as isString };
+
+//# sourceMappingURL=guards.js.map

package/dist/utils/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","names":[],"sources":["../../src/utils/guards.ts"],"sourcesContent":["/**\n * Type guard asserting a value is neither `null` nor `undefined`.\n *\n * Useful for narrowing in `Array.prototype.filter` to drop nullish entries\n * while preserving the element type.\n *\n * @example\n * const xs: (number | null)[] = [1, null, 2];\n * const clean: number[] = xs.filter(isDefined); // [1, 2]\n */\nexport function isDefined<T>(value: T | null | undefined): value is T {\n    return value !== null && value !== undefined;\n}\n\n/**\n * Type guard asserting a value is a string primitive.\n *\n * @example\n * isString(\"hi\"); // true\n * isString(42);   // false\n */\nexport function isString(value: unknown): value is string {\n    return typeof value === \"string\";\n}\n\n/**\n * Type guard asserting a value is a number, excluding `NaN`.\n *\n * @example\n * isNumber(42);       // true\n * isNumber(NaN);      // false\n * isNumber(\"42\");     // false\n */\nexport function isNumber(value: unknown): value is number {\n    return typeof value === \"number\" && !Number.isNaN(value);\n}\n\n/**\n * Type guard asserting a value is a plain object literal.\n *\n * Returns `false` for arrays, `null`, dates, maps, sets, and class instances —\n * only objects created from `{}` / `Object.create(null)` / object literals pass.\n *\n * @example\n * isPlainObject({ a: 1 });     // true\n * isPlainObject([]);           // false\n * isPlainObject(null);         // false\n * isPlainObject(new Date());   // false\n */\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n    if (typeof value !== \"object\" || value === null) return false;\n    const proto = Object.getPrototypeOf(value);\n    return proto === Object.prototype || proto === null;\n}\n\n/**\n * Assert that a code path is unreachable, throwing at runtime if reached.\n *\n * Use in the `default` branch of an exhaustive `switch` so TypeScript flags any\n * unhandled union member at compile time and the runtime fails loudly if an\n * unexpected value slips through.\n *\n * @param value - The value that should be of type `never`.\n * @param message - Optional custom error message.\n * @throws {Error} Always.\n *\n * @example\n * type Shape = \"circle\" | \"square\";\n * function area(shape: Shape): number {\n *   switch (shape) {\n *     case \"circle\": return 1;\n *     case \"square\": return 2;\n *     default: return assertNever(shape);\n *   }\n * }\n */\nexport function assertNever(value: never, message?: string): never {\n    throw new Error(message ?? `Unexpected value: ${String(value)}`);\n}\n"],"mappings":";AAUA,SAAgB,EAAa,GAAyC;CAClE,OAAO,KAAU;AACrB;AASA,SAAgB,EAAS,GAAiC;CACtD,OAAO,OAAO,KAAU;AAC5B;AAUA,SAAgB,EAAS,GAAiC;CACtD,OAAO,OAAO,KAAU,YAAY,CAAC,OAAO,MAAM,CAAK;AAC3D;AAcA,SAAgB,EAAc,GAAkD;CAC5E,IAAI,OAAO,KAAU,aAAY,GAAgB,OAAO;CACxD,IAAM,IAAQ,OAAO,eAAe,CAAK;CACzC,OAAO,MAAU,OAAO,aAAa,MAAU;AACnD;AAuBA,SAAgB,EAAY,GAAc,GAAyB;CAC/D,MAAU,MAAM,KAAW,qBAAqB,OAAO,CAAK,GAAG;AACnE"}

package/dist/utils/ids.cjs

@@ -0,0 +1,2 @@
+function e(e){let t;return t=typeof crypto<`u`&&typeof crypto.randomUUID==`function`?crypto.randomUUID():`${Date.now().toString(36)}-${Math.random().toString(36).slice(2,10)}`,e?`${e}-${t}`:t}exports.randomId=e;
+//# sourceMappingURL=ids.cjs.map

package/dist/utils/ids.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.cjs","names":[],"sources":["../../src/utils/ids.ts"],"sourcesContent":["/**\n * Generate a collision-resistant id suitable for client-side UI keys.\n *\n * Uses `crypto.randomUUID()` when available, falling back to a\n * timestamp + `Math.random()` combination otherwise. When `prefix` is given,\n * the result is formatted as `${prefix}-${id}`.\n *\n * @example\n * randomId();          // \"9f1c2b3a-...\" (uuid) or \"lq3f8k-4a9z1\" (fallback)\n * randomId(\"user\");    // \"user-9f1c2b3a-...\"\n */\nexport function randomId(prefix?: string): string {\n    let id: string;\n\n    if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n        id = crypto.randomUUID();\n    } else {\n        const time = Date.now().toString(36);\n        const rand = Math.random().toString(36).slice(2, 10);\n        id = `${time}-${rand}`;\n    }\n\n    return prefix ? `${prefix}-${id}` : id;\n}\n"],"mappings":"AAWA,SAAgB,EAAS,EAAyB,CAC9C,IAAI,EAUJ,MARA,CAKI,EALA,OAAO,OAAW,KAAe,OAAO,OAAO,YAAe,WACzD,OAAO,WAAW,EAIlB,GAFQ,KAAK,IAAI,CAAC,CAAC,SAAS,EAEzB,EAAK,GADA,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAG,EACjC,IAGb,EAAS,GAAG,EAAO,GAAG,IAAO,CACxC"}

package/dist/utils/ids.js

@@ -0,0 +1,9 @@
+//#region src/utils/ids.ts
+function e(e) {
+	let t;
+	return t = typeof crypto < "u" && typeof crypto.randomUUID == "function" ? crypto.randomUUID() : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`, e ? `${e}-${t}` : t;
+}
+//#endregion
+export { e as randomId };
+
+//# sourceMappingURL=ids.js.map

package/dist/utils/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","names":[],"sources":["../../src/utils/ids.ts"],"sourcesContent":["/**\n * Generate a collision-resistant id suitable for client-side UI keys.\n *\n * Uses `crypto.randomUUID()` when available, falling back to a\n * timestamp + `Math.random()` combination otherwise. When `prefix` is given,\n * the result is formatted as `${prefix}-${id}`.\n *\n * @example\n * randomId();          // \"9f1c2b3a-...\" (uuid) or \"lq3f8k-4a9z1\" (fallback)\n * randomId(\"user\");    // \"user-9f1c2b3a-...\"\n */\nexport function randomId(prefix?: string): string {\n    let id: string;\n\n    if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n        id = crypto.randomUUID();\n    } else {\n        const time = Date.now().toString(36);\n        const rand = Math.random().toString(36).slice(2, 10);\n        id = `${time}-${rand}`;\n    }\n\n    return prefix ? `${prefix}-${id}` : id;\n}\n"],"mappings":";AAWA,SAAgB,EAAS,GAAyB;CAC9C,IAAI;CAUJ,OARA,AAKI,IALA,OAAO,SAAW,OAAe,OAAO,OAAO,cAAe,aACzD,OAAO,WAAW,IAIlB,GAFQ,KAAK,IAAI,CAAC,CAAC,SAAS,EAEzB,EAAK,GADA,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,GAAG,EACjC,KAGb,IAAS,GAAG,EAAO,GAAG,MAAO;AACxC"}

package/dist/utils/numbers.cjs

@@ -0,0 +1,2 @@
+function e(e,t,n){if(Number.isNaN(e))return e;if(t>n){let e=t;t=n,n=e}return e<t?t:e>n?n:e}function t(e,t=1){if(e===0)return`0 B`;let n=[`B`,`KB`,`MB`,`GB`,`TB`],r=1024,i=Math.min(Math.floor(Math.log(Math.abs(e))/Math.log(r)),n.length-1),a=e/r**i,o=i===0?0:Math.max(0,t);return`${parseFloat(a.toFixed(o)).toString()} ${n[i]}`}function n(e,t=`en-US`){return new Intl.NumberFormat(t,{notation:`compact`,maximumFractionDigits:1}).format(e)}exports.clamp=e,exports.formatBytes=t,exports.formatCompactNumber=n;
+//# sourceMappingURL=numbers.cjs.map

package/dist/utils/numbers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.cjs","names":[],"sources":["../../src/utils/numbers.ts"],"sourcesContent":["/**\n * Clamp `value` between `min` and `max` (inclusive).\n *\n * @example\n * clamp(120, 0, 100); // 100\n * clamp(-5, 0, 100);  // 0\n * clamp(42, 0, 100);  // 42\n */\nexport function clamp(value: number, min: number, max: number): number {\n    if (Number.isNaN(value)) return value;\n    if (min > max) {\n        const swap = min;\n        min = max;\n        max = swap;\n    }\n    if (value < min) return min;\n    if (value > max) return max;\n    return value;\n}\n\n/**\n * Format a byte count as a human-readable size string.\n *\n * Scales through B, KB, MB, GB and TB using 1024 as the base. `decimals`\n * controls the fractional digits for scaled units (default 1); `0` bytes\n * always renders as `\"0 B\"`.\n *\n * @example\n * formatBytes(0);       // \"0 B\"\n * formatBytes(1536);    // \"1.5 KB\"\n * formatBytes(1048576); // \"1 MB\"\n * formatBytes(1536, 2); // \"1.50 KB\"\n */\nexport function formatBytes(bytes: number, decimals: number = 1): string {\n    if (bytes === 0) return \"0 B\";\n\n    const units = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\"];\n    const base = 1024;\n    const exponent = Math.min(\n        Math.floor(Math.log(Math.abs(bytes)) / Math.log(base)),\n        units.length - 1,\n    );\n    const value = bytes / base ** exponent;\n    const digits = exponent === 0 ? 0 : Math.max(0, decimals);\n    const formatted = parseFloat(value.toFixed(digits)).toString();\n\n    return `${formatted} ${units[exponent]}`;\n}\n\n/**\n * Format a number using compact notation (e.g. `1.2K`, `3.4M`).\n *\n * Wraps `Intl.NumberFormat` with `notation: \"compact\"`. The `locale` defaults\n * to `\"en-US\"`.\n *\n * @example\n * formatCompactNumber(1234);            // \"1.2K\"\n * formatCompactNumber(5600000);         // \"5.6M\"\n * formatCompactNumber(1234, \"pt-BR\");   // \"1,2 mil\"\n */\nexport function formatCompactNumber(value: number, locale: string = \"en-US\"): string {\n    return new Intl.NumberFormat(locale, { notation: \"compact\", maximumFractionDigits: 1 }).format(\n        value,\n    );\n}\n"],"mappings":"AAQA,SAAgB,EAAM,EAAe,EAAa,EAAqB,CACnE,GAAI,OAAO,MAAM,CAAK,EAAG,OAAO,EAChC,GAAI,EAAM,EAAK,CACX,IAAM,EAAO,EACb,EAAM,EACN,EAAM,CACV,CAGA,OAFI,EAAQ,EAAY,EACpB,EAAQ,EAAY,EACjB,CACX,CAeA,SAAgB,EAAY,EAAe,EAAmB,EAAW,CACrE,GAAI,IAAU,EAAG,MAAO,MAExB,IAAM,EAAQ,CAAC,IAAK,KAAM,KAAM,KAAM,IAAI,EACpC,EAAO,KACP,EAAW,KAAK,IAClB,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,CAAK,CAAC,EAAI,KAAK,IAAI,CAAI,CAAC,EACrD,EAAM,OAAS,CACnB,EACM,EAAQ,EAAQ,GAAQ,EACxB,EAAS,IAAa,EAAI,EAAI,KAAK,IAAI,EAAG,CAAQ,EAGxD,MAAO,GAFW,WAAW,EAAM,QAAQ,CAAM,CAAC,CAAC,CAAC,SAE1C,EAAU,GAAG,EAAM,IACjC,CAaA,SAAgB,EAAoB,EAAe,EAAiB,QAAiB,CACjF,OAAO,IAAI,KAAK,aAAa,EAAQ,CAAE,SAAU,UAAW,sBAAuB,CAAE,CAAC,CAAC,CAAC,OACpF,CACJ,CACJ"}