tempest-react-sdk 0.24.0 → 0.26.0

package/dist/vite/create-vite-config.js

@@ -1,8 +1,9 @@
-import { resolve as e } from "node:path";
-import { defineConfig as t } from "vite";
-import n from "@vitejs/plugin-react";
+import { tempestIcons as e } from "./tempest-icons.js";
+import { resolve as t } from "node:path";
+import { defineConfig as n } from "vite";
+import r from "@vitejs/plugin-react";
 //#region src/vite/create-vite-config.ts
-function r(e) {
+function i(e) {
 	let t = {};
 	for (let [n, r] of Object.entries(e)) t[n] = typeof r == "string" ? {
 		target: r,
@@ -10,35 +11,42 @@ function r(e) {
 	} : r;
 	return t;
 }
-function i(i = {}) {
-	let { srcDir: a = "src", port: o = 5173, host: s = "127.0.0.1", open: c = !1, proxy: l, alias: u = {}, plugins: d = [], overrides: f = {} } = i, p = f, m = {
-		plugins: [n(), ...d],
+function a(a = {}) {
+	let { srcDir: o = "src", port: s = 5173, host: c = "127.0.0.1", open: l = !1, proxy: u, alias: d = {}, plugins: f = [], icons: p = !0, overrides: m = {} } = a, h = m, g = p ? [e({
+		dir: o,
+		...typeof p == "object" ? p : {}
+	})] : [], _ = {
+		plugins: [
+			r(),
+			...g,
+			...f
+		],
 		resolve: { alias: {
-			"@": e(process.cwd(), a),
-			...u
+			"@": t(process.cwd(), o),
+			...d
 		} },
 		server: {
-			port: o,
-			host: s,
-			open: c,
-			...l ? { proxy: r(l) } : {}
+			port: s,
+			host: c,
+			open: l,
+			...u ? { proxy: i(u) } : {}
 		}
 	};
-	return t({
-		...m,
-		...p,
-		plugins: [...m.plugins ?? [], ...p.plugins ?? []],
+	return n({
+		..._,
+		...h,
+		plugins: [..._.plugins ?? [], ...h.plugins ?? []],
 		resolve: {
-			...m.resolve,
-			...p.resolve
+			..._.resolve,
+			...h.resolve
 		},
 		server: {
-			...m.server,
-			...p.server
+			..._.server,
+			...h.server
 		}
 	});
 }
 //#endregion
-export { i as createViteConfig };
+export { a as createViteConfig };
 
 //# sourceMappingURL=create-vite-config.js.map

package/dist/vite/create-vite-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-vite-config.js","names":[],"sources":["../../src/vite/create-vite-config.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { defineConfig } from \"vite\";\nimport type { ProxyOptions, UserConfig } from \"vite\";\nimport react from \"@vitejs/plugin-react\";\n\n/**\n * A Vite proxy entry: either a target URL string (expanded to\n * `{ target, changeOrigin: true }`) or a raw Vite `ProxyOptions` object.\n */\nexport type ProxyEntry = string | Record<string, unknown>;\n\nexport interface CreateViteConfigOptions {\n    /**\n     * Source directory aliased to `@`, relative to the project root.\n     * Default: `\"src\"` (so `@/components/Button` → `<root>/src/components/Button`).\n     */\n    srcDir?: string;\n    /** Dev server port. Default: `5173`. */\n    port?: number;\n    /** Dev server host. Default: `\"127.0.0.1\"`. */\n    host?: string | boolean;\n    /** Open the browser on `dev` start. Default: `false`. */\n    open?: boolean;\n    /**\n     * Dev proxy table. String values are expanded to\n     * `{ target, changeOrigin: true }`; objects are passed through untouched.\n     *\n     * @example { \"/api\": \"http://127.0.0.1:8000\" }\n     */\n    proxy?: Record<string, ProxyEntry>;\n    /** Extra path aliases merged on top of the default `@` → src alias. */\n    alias?: Record<string, string>;\n    /** Vite plugins appended after `@vitejs/plugin-react`. */\n    plugins?: unknown[];\n    /**\n     * Arbitrary Vite config (a `UserConfig` object) deep-merged last, for\n     * escape-hatch overrides (build target, define, extra `server` keys, …).\n     */\n    overrides?: Record<string, unknown>;\n}\n\n/**\n * The resulting Vite config object. Typed loosely so the SDK's published\n * declarations stay free of `vite`'s internal types; assign it straight to a\n * `vite.config.ts` default export.\n */\nexport type TempestViteConfig = Record<string, unknown>;\n\nfunction normalizeProxy(proxy: Record<string, ProxyEntry>): Record<string, ProxyOptions> {\n    const out: Record<string, ProxyOptions> = {};\n    for (const [path, value] of Object.entries(proxy)) {\n        out[path] =\n            typeof value === \"string\"\n                ? { target: value, changeOrigin: true }\n                : (value as ProxyOptions);\n    }\n    return out;\n}\n\n/**\n * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`\n * plugin, the `@` → `src` import alias, and sane dev-server defaults — so a\n * consuming app's `vite.config.ts` is a single call instead of repeated\n * boilerplate. Everything is overridable.\n *\n * Import it from the dedicated Node entry point:\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *     proxy: { \"/api\": \"http://127.0.0.1:8000\" },\n * });\n */\nexport function createViteConfig(options: CreateViteConfigOptions = {}): TempestViteConfig {\n    const {\n        srcDir = \"src\",\n        port = 5173,\n        host = \"127.0.0.1\",\n        open = false,\n        proxy,\n        alias = {},\n        plugins = [],\n        overrides = {},\n    } = options;\n\n    const overridesConfig = overrides as UserConfig;\n\n    const base: UserConfig = {\n        plugins: [react(), ...plugins] as UserConfig[\"plugins\"],\n        resolve: {\n            alias: {\n                \"@\": resolve(process.cwd(), srcDir),\n                ...alias,\n            },\n        },\n        server: {\n            port,\n            host,\n            open,\n            ...(proxy ? { proxy: normalizeProxy(proxy) } : {}),\n        },\n    };\n\n    const merged: UserConfig = {\n        ...base,\n        ...overridesConfig,\n        plugins: [...(base.plugins ?? []), ...(overridesConfig.plugins ?? [])],\n        resolve: { ...base.resolve, ...overridesConfig.resolve },\n        server: { ...base.server, ...overridesConfig.server },\n    };\n\n    return defineConfig(merged) as TempestViteConfig;\n}\n"],"mappings":";;;;AAgDA,SAAS,EAAe,GAAiE;CACrF,IAAM,IAAoC,CAAC;CAC3C,KAAK,IAAM,CAAC,GAAM,MAAU,OAAO,QAAQ,CAAK,GAC5C,EAAI,KACA,OAAO,KAAU,WACX;EAAE,QAAQ;EAAO,cAAc;CAAK,IACnC;CAEf,OAAO;AACX;AAkBA,SAAgB,EAAiB,IAAmC,CAAC,GAAsB;CACvF,IAAM,EACF,YAAS,OACT,UAAO,MACP,UAAO,aACP,UAAO,IACP,UACA,WAAQ,CAAC,GACT,aAAU,CAAC,GACX,eAAY,CAAC,MACb,GAEE,IAAkB,GAElB,IAAmB;EACrB,SAAS,CAAC,EAAM,GAAG,GAAG,CAAO;EAC7B,SAAS,EACL,OAAO;GACH,KAAK,EAAQ,QAAQ,IAAI,GAAG,CAAM;GAClC,GAAG;EACP,EACJ;EACA,QAAQ;GACJ;GACA;GACA;GACA,GAAI,IAAQ,EAAE,OAAO,EAAe,CAAK,EAAE,IAAI,CAAC;EACpD;CACJ;CAUA,OAAO,EAAa;EAPhB,GAAG;EACH,GAAG;EACH,SAAS,CAAC,GAAI,EAAK,WAAW,CAAC,GAAI,GAAI,EAAgB,WAAW,CAAC,CAAE;EACrE,SAAS;GAAE,GAAG,EAAK;GAAS,GAAG,EAAgB;EAAQ;EACvD,QAAQ;GAAE,GAAG,EAAK;GAAQ,GAAG,EAAgB;EAAO;CAGpC,CAAM;AAC9B"}
+{"version":3,"file":"create-vite-config.js","names":[],"sources":["../../src/vite/create-vite-config.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { defineConfig } from \"vite\";\nimport type { ProxyOptions, UserConfig } from \"vite\";\nimport react from \"@vitejs/plugin-react\";\n\nimport { tempestIcons, type TempestIconsOptions } from \"./tempest-icons\";\n\n/**\n * A Vite proxy entry: either a target URL string (expanded to\n * `{ target, changeOrigin: true }`) or a raw Vite `ProxyOptions` object.\n */\nexport type ProxyEntry = string | Record<string, unknown>;\n\nexport interface CreateViteConfigOptions {\n    /**\n     * Source directory aliased to `@`, relative to the project root.\n     * Default: `\"src\"` (so `@/components/Button` → `<root>/src/components/Button`).\n     */\n    srcDir?: string;\n    /** Dev server port. Default: `5173`. */\n    port?: number;\n    /** Dev server host. Default: `\"127.0.0.1\"`. */\n    host?: string | boolean;\n    /** Open the browser on `dev` start. Default: `false`. */\n    open?: boolean;\n    /**\n     * Dev proxy table. String values are expanded to\n     * `{ target, changeOrigin: true }`; objects are passed through untouched.\n     *\n     * @example { \"/api\": \"http://127.0.0.1:8000\" }\n     */\n    proxy?: Record<string, ProxyEntry>;\n    /** Extra path aliases merged on top of the default `@` → src alias. */\n    alias?: Record<string, string>;\n    /** Vite plugins appended after `@vitejs/plugin-react`. */\n    plugins?: unknown[];\n    /**\n     * The `tempestIcons()` plugin, which generates `virtual:tempest-icons` from the\n     * icon slugs your source mentions. On by default — it only ever removes\n     * requests. Pass `false` to leave it out, or an options object to configure the\n     * scan.\n     */\n    icons?: boolean | TempestIconsOptions;\n    /**\n     * Arbitrary Vite config (a `UserConfig` object) deep-merged last, for\n     * escape-hatch overrides (build target, define, extra `server` keys, …).\n     */\n    overrides?: Record<string, unknown>;\n}\n\n/**\n * The resulting Vite config object. Typed loosely so the SDK's published\n * declarations stay free of `vite`'s internal types; assign it straight to a\n * `vite.config.ts` default export.\n */\nexport type TempestViteConfig = Record<string, unknown>;\n\nfunction normalizeProxy(proxy: Record<string, ProxyEntry>): Record<string, ProxyOptions> {\n    const out: Record<string, ProxyOptions> = {};\n    for (const [path, value] of Object.entries(proxy)) {\n        out[path] =\n            typeof value === \"string\"\n                ? { target: value, changeOrigin: true }\n                : (value as ProxyOptions);\n    }\n    return out;\n}\n\n/**\n * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`\n * plugin, the `@` → `src` import alias, and sane dev-server defaults — so a\n * consuming app's `vite.config.ts` is a single call instead of repeated\n * boilerplate. Everything is overridable.\n *\n * Import it from the dedicated Node entry point:\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *     proxy: { \"/api\": \"http://127.0.0.1:8000\" },\n * });\n */\nexport function createViteConfig(options: CreateViteConfigOptions = {}): TempestViteConfig {\n    const {\n        srcDir = \"src\",\n        port = 5173,\n        host = \"127.0.0.1\",\n        open = false,\n        proxy,\n        alias = {},\n        plugins = [],\n        icons = true,\n        overrides = {},\n    } = options;\n\n    const overridesConfig = overrides as UserConfig;\n    const iconsPlugin = icons\n        ? [tempestIcons({ dir: srcDir, ...(typeof icons === \"object\" ? icons : {}) })]\n        : [];\n\n    const base: UserConfig = {\n        plugins: [react(), ...iconsPlugin, ...plugins] as UserConfig[\"plugins\"],\n        resolve: {\n            alias: {\n                \"@\": resolve(process.cwd(), srcDir),\n                ...alias,\n            },\n        },\n        server: {\n            port,\n            host,\n            open,\n            ...(proxy ? { proxy: normalizeProxy(proxy) } : {}),\n        },\n    };\n\n    const merged: UserConfig = {\n        ...base,\n        ...overridesConfig,\n        plugins: [...(base.plugins ?? []), ...(overridesConfig.plugins ?? [])],\n        resolve: { ...base.resolve, ...overridesConfig.resolve },\n        server: { ...base.server, ...overridesConfig.server },\n    };\n\n    return defineConfig(merged) as TempestViteConfig;\n}\n"],"mappings":";;;;;AAyDA,SAAS,EAAe,GAAiE;CACrF,IAAM,IAAoC,CAAC;CAC3C,KAAK,IAAM,CAAC,GAAM,MAAU,OAAO,QAAQ,CAAK,GAC5C,EAAI,KACA,OAAO,KAAU,WACX;EAAE,QAAQ;EAAO,cAAc;CAAK,IACnC;CAEf,OAAO;AACX;AAkBA,SAAgB,EAAiB,IAAmC,CAAC,GAAsB;CACvF,IAAM,EACF,YAAS,OACT,UAAO,MACP,UAAO,aACP,UAAO,IACP,UACA,WAAQ,CAAC,GACT,aAAU,CAAC,GACX,WAAQ,IACR,eAAY,CAAC,MACb,GAEE,IAAkB,GAClB,IAAc,IACd,CAAC,EAAa;EAAE,KAAK;EAAQ,GAAI,OAAO,KAAU,WAAW,IAAQ,CAAC;CAAG,CAAC,CAAC,IAC3E,CAAC,GAED,IAAmB;EACrB,SAAS;GAAC,EAAM;GAAG,GAAG;GAAa,GAAG;EAAO;EAC7C,SAAS,EACL,OAAO;GACH,KAAK,EAAQ,QAAQ,IAAI,GAAG,CAAM;GAClC,GAAG;EACP,EACJ;EACA,QAAQ;GACJ;GACA;GACA;GACA,GAAI,IAAQ,EAAE,OAAO,EAAe,CAAK,EAAE,IAAI,CAAC;EACpD;CACJ;CAUA,OAAO,EAAa;EAPhB,GAAG;EACH,GAAG;EACH,SAAS,CAAC,GAAI,EAAK,WAAW,CAAC,GAAI,GAAI,EAAgB,WAAW,CAAC,CAAE;EACrE,SAAS;GAAE,GAAG,EAAK;GAAS,GAAG,EAAgB;EAAQ;EACvD,QAAQ;GAAE,GAAG,EAAK;GAAQ,GAAG,EAAgB;EAAO;CAGpC,CAAM;AAC9B"}

package/dist/vite/tempest-icons.cjs

@@ -0,0 +1,9 @@
+const e=require("../icons/generated/aliases.cjs"),t=require("../icons/generated/icon-names.cjs");let n=require("node:path"),r=require("node:fs/promises");var i=`virtual:tempest-icons`,a=`\0${i}`,o=[/\bname\s*=\s*["']([a-z0-9-]+)["']/g,/\bname\s*=\s*\{\s*["']([a-z0-9-]+)["']\s*\}/g,/\bname\s*:\s*["']([a-z0-9-]+)["']/g],s=/\.[cm]?[jt]sx?$/,c=new Set([`node_modules`,`dist`,`build`,`coverage`]);function l(e,t){let n=new Set;for(let r of o){r.lastIndex=0;let i;for(;(i=r.exec(e))!==null;)t.has(i[1])&&n.add(i[1])}return[...n]}function u(e,t){let n=[...new Set(e)].sort();if(!n.length)return`export const staticIcons = {};
+`;let r=new Map;for(let e of n)r.set(e,d(t[e]??e));return`import { ${[...new Set(r.values())].sort().map(e=>p(e)===e?e:`${e} as ${p(e)}`).join(`, `)} } from "lucide-react";
+
+export const staticIcons = {
+${n.map(e=>`    "${e}": ${p(r.get(e))},`).join(`
+`)}
+};
+`}function d(e){return e.split(`-`).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(``)}var f=new Set([`Infinity`,`NaN`,`undefined`,`eval`,`arguments`]);function p(e){return f.has(e)?`${e}Icon`:e}async function m(e,t){let i=[],a;try{a=await(0,r.readdir)(e,{withFileTypes:!0})}catch{return i}for(let r of a)if(r.isDirectory()){if(t.has(r.name)||r.name.startsWith(`.`))continue;i.push(...await m((0,n.join)(e,r.name),t))}else r.isFile()&&s.test(r.name)&&i.push((0,n.join)(e,r.name));return i}function h(i={}){let{dir:o=`src`,include:d=[],skipDirs:f}=i,p=new Set(t.iconNames),h=new Set(f??c),g=new Set(d.filter(e=>p.has(e))),_=process.cwd(),v=async()=>{let e=await m((0,n.resolve)(_,o),h);for(let t of e)try{let e=await(0,r.readFile)(t,`utf8`);for(let t of l(e,p))g.add(t)}catch{}};return{name:`tempest-icons`,enforce:`pre`,configResolved(e){_=e.root??_},async buildStart(){await v()},resolveId(e){return e===`virtual:tempest-icons`?a:null},load(t){return t===a?u([...g],e.iconAliases):null},async handleHotUpdate(e){if(!s.test(e.file))return;let t=g.size;for(let t of l(await e.read(),p))g.add(t);if(g.size===t)return;let n=e.server.moduleGraph.getModuleById(a);if(n)return[n]}}}exports.TEMPEST_ICONS_ID=i,exports.buildIconsModule=u,exports.scanIconSlugs=l,exports.tempestIcons=h;
+//# sourceMappingURL=tempest-icons.cjs.map

package/dist/vite/tempest-icons.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tempest-icons.cjs","names":[],"sources":["../../src/vite/tempest-icons.ts"],"sourcesContent":["import { readdir, readFile } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\n\nimport { iconAliases } from \"@/icons/generated/aliases\";\nimport { iconNames } from \"@/icons/generated/icon-names\";\n\nimport type { TempestVitePlugin } from \"./tempest-pwa-manifest\";\n\n/** The module id an app imports to get its static registry. */\nexport const TEMPEST_ICONS_ID = \"virtual:tempest-icons\";\n\nconst RESOLVED_ID = `\\0${TEMPEST_ICONS_ID}`;\n\n/**\n * Slugs written as a literal `name` prop or a literal `name:` field.\n *\n * Matching the *attribute* rather than any kebab-case string is what keeps the\n * scan from sweeping in unrelated text — a CSS class, a translation key and a\n * route segment all look like slugs otherwise. Everything matched is still\n * validated against lucide's real slug list before it reaches the module.\n */\nconst NAME_PATTERNS = [\n    /\\bname\\s*=\\s*[\"']([a-z0-9-]+)[\"']/g,\n    /\\bname\\s*=\\s*\\{\\s*[\"']([a-z0-9-]+)[\"']\\s*\\}/g,\n    /\\bname\\s*:\\s*[\"']([a-z0-9-]+)[\"']/g,\n];\n\nconst SOURCE_FILE = /\\.[cm]?[jt]sx?$/;\nconst SKIP_DIRS = new Set([\"node_modules\", \"dist\", \"build\", \"coverage\"]);\n\nexport interface TempestIconsOptions {\n    /**\n     * Directory to scan, relative to the Vite root. Default: `\"src\"`.\n     */\n    dir?: string;\n    /**\n     * Extra slugs to include even when the scan cannot see them — a name built by\n     * concatenation, or one that only ever arrives from the API but is worth\n     * paying for statically because it is on the first screen.\n     */\n    include?: readonly string[];\n    /** Directory names to skip. Default: `node_modules`, `dist`, `build`, `coverage`. */\n    skipDirs?: readonly string[];\n}\n\n/**\n * Collect the icon slugs a source file references literally.\n *\n * @param code - File contents.\n * @param known - The set of real lucide slugs, aliases included.\n * @returns The slugs found, validated against `known`.\n */\nexport function scanIconSlugs(code: string, known: ReadonlySet<string>): string[] {\n    const found = new Set<string>();\n    for (const pattern of NAME_PATTERNS) {\n        pattern.lastIndex = 0;\n        let match: RegExpExecArray | null;\n        while ((match = pattern.exec(code)) !== null) {\n            if (known.has(match[1])) found.add(match[1]);\n        }\n    }\n    return [...found];\n}\n\n/**\n * Build the virtual module source for a set of slugs.\n *\n * Aliases resolve to their canonical slug before importing, because only the\n * canonical name is a real lucide export — but the alias key still points at the\n * component, so `<Icon name=\"alert-circle\" />` stays a zero-request lookup.\n *\n * @param slugs - Validated slugs to include.\n * @param aliases - Alias slug → canonical slug.\n * @returns ES module source.\n */\nexport function buildIconsModule(\n    slugs: readonly string[],\n    aliases: Record<string, string>,\n): string {\n    const sorted = [...new Set(slugs)].sort();\n    if (!sorted.length) return \"export const staticIcons = {};\\n\";\n\n    const componentOf = new Map<string, string>();\n    for (const slug of sorted) componentOf.set(slug, pascalCase(aliases[slug] ?? slug));\n\n    const named = [...new Set(componentOf.values())]\n        .sort()\n        .map((name) => (localName(name) === name ? name : `${name} as ${localName(name)}`))\n        .join(\", \");\n    const entries = sorted\n        .map((slug) => `    \"${slug}\": ${localName(componentOf.get(slug) as string)},`)\n        .join(\"\\n\");\n    return `import { ${named} } from \"lucide-react\";\n\nexport const staticIcons = {\n${entries}\n};\n`;\n}\n\n/** `circle-alert` → `CircleAlert`; `a-arrow-down` → `AArrowDown`. */\nfunction pascalCase(slug: string): string {\n    return slug\n        .split(\"-\")\n        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n        .join(\"\");\n}\n\n/**\n * Export names that would shadow a restricted global if bound directly.\n *\n * Lucide ships an icon literally called `infinity`, whose export is `Infinity`.\n * Binding that at module scope shadows the global, so the import is aliased.\n */\nconst RESERVED_NAMES = new Set([\"Infinity\", \"NaN\", \"undefined\", \"eval\", \"arguments\"]);\n\n/** The local binding to use for a lucide export name. */\nfunction localName(name: string): string {\n    return RESERVED_NAMES.has(name) ? `${name}Icon` : name;\n}\n\n/**\n * Walk a directory and collect every source file path.\n *\n * @param dir - Absolute directory to walk.\n * @param skip - Directory names to skip.\n * @returns Absolute file paths.\n */\nasync function collectSourceFiles(dir: string, skip: ReadonlySet<string>): Promise<string[]> {\n    const out: string[] = [];\n    let entries;\n    try {\n        entries = await readdir(dir, { withFileTypes: true });\n    } catch {\n        return out;\n    }\n    for (const entry of entries) {\n        if (entry.isDirectory()) {\n            if (skip.has(entry.name) || entry.name.startsWith(\".\")) continue;\n            out.push(...(await collectSourceFiles(join(dir, entry.name), skip)));\n        } else if (entry.isFile() && SOURCE_FILE.test(entry.name)) {\n            out.push(join(dir, entry.name));\n        }\n    }\n    return out;\n}\n\n/**\n * Generate a static icon registry from the slugs your source mentions.\n *\n * Removes the reason to reach for `lucide-react`'s `DynamicIcon`: the slugs an app\n * writes as literals become ordinary static imports, so the bundler keeps exactly\n * those icons and the browser makes **no** extra request for them. A slug that only\n * exists at runtime still works — `<Icon>` falls back to fetching one shard per\n * initial letter.\n *\n * The scan reads the source tree directly at `buildStart` rather than harvesting\n * modules as they pass through `transform`: relying on transform order would let\n * the virtual module load before every consumer had been seen, and the registry\n * would come out short on a cold dev start — silently, since the missing slugs\n * would still render via the lazy path.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestIcons } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({ plugins: [tempestIcons()] });\n *\n * @example\n * // src/main.tsx\n * import { IconProvider } from \"tempest-react-sdk/icons\";\n * import { staticIcons } from \"virtual:tempest-icons\";\n *\n * <IconProvider registry={staticIcons}>\n *     <App />\n * </IconProvider>\n */\nexport function tempestIcons(options: TempestIconsOptions = {}): TempestVitePlugin {\n    const { dir = \"src\", include = [], skipDirs } = options;\n    const known = new Set<string>(iconNames);\n    const skip = new Set<string>(skipDirs ?? SKIP_DIRS);\n    const slugs = new Set<string>(include.filter((slug) => known.has(slug)));\n    let root = process.cwd();\n\n    /** Rescan the source tree, keeping the explicitly included slugs. */\n    const rescan = async (): Promise<void> => {\n        const files = await collectSourceFiles(resolve(root, dir), skip);\n        for (const file of files) {\n            try {\n                const code = await readFile(file, \"utf8\");\n                for (const slug of scanIconSlugs(code, known)) slugs.add(slug);\n            } catch {\n                /* an unreadable file just contributes nothing */\n            }\n        }\n    };\n\n    return {\n        name: \"tempest-icons\",\n        enforce: \"pre\",\n\n        configResolved(config: { root?: string }) {\n            root = config.root ?? root;\n        },\n\n        async buildStart() {\n            await rescan();\n        },\n\n        resolveId(id: string) {\n            return id === TEMPEST_ICONS_ID ? RESOLVED_ID : null;\n        },\n\n        load(id: string) {\n            return id === RESOLVED_ID ? buildIconsModule([...slugs], iconAliases) : null;\n        },\n\n        /**\n         * Pick up a slug added while the dev server is running.\n         *\n         * A newly written `<Icon name=\"save\" />` would otherwise only render via\n         * the lazy path until the next restart. Rescanning the changed file and\n         * invalidating the virtual module keeps dev and build agreeing on what the\n         * static registry contains.\n         */\n        async handleHotUpdate(ctx: {\n            file: string;\n            read: () => Promise<string>;\n            server: { moduleGraph: { getModuleById: (id: string) => unknown } };\n        }) {\n            if (!SOURCE_FILE.test(ctx.file)) return;\n            const before = slugs.size;\n            for (const slug of scanIconSlugs(await ctx.read(), known)) slugs.add(slug);\n            if (slugs.size === before) return;\n            const mod = ctx.server.moduleGraph.getModuleById(RESOLVED_ID);\n            if (mod) return [mod];\n        },\n    } as TempestVitePlugin;\n}\n"],"mappings":"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"}

package/dist/vite/tempest-icons.js

@@ -0,0 +1,99 @@
+import { iconAliases as e } from "../icons/generated/aliases.js";
+import { iconNames as t } from "../icons/generated/icon-names.js";
+import { join as n, resolve as r } from "node:path";
+import { readFile as i, readdir as a } from "node:fs/promises";
+//#region src/vite/tempest-icons.ts
+var o = "virtual:tempest-icons", s = `\0${o}`, c = [
+	/\bname\s*=\s*["']([a-z0-9-]+)["']/g,
+	/\bname\s*=\s*\{\s*["']([a-z0-9-]+)["']\s*\}/g,
+	/\bname\s*:\s*["']([a-z0-9-]+)["']/g
+], l = /\.[cm]?[jt]sx?$/, u = /* @__PURE__ */ new Set([
+	"node_modules",
+	"dist",
+	"build",
+	"coverage"
+]);
+function d(e, t) {
+	let n = /* @__PURE__ */ new Set();
+	for (let r of c) {
+		r.lastIndex = 0;
+		let i;
+		for (; (i = r.exec(e)) !== null;) t.has(i[1]) && n.add(i[1]);
+	}
+	return [...n];
+}
+function f(e, t) {
+	let n = [...new Set(e)].sort();
+	if (!n.length) return "export const staticIcons = {};\n";
+	let r = /* @__PURE__ */ new Map();
+	for (let e of n) r.set(e, p(t[e] ?? e));
+	return `import { ${[...new Set(r.values())].sort().map((e) => h(e) === e ? e : `${e} as ${h(e)}`).join(", ")} } from "lucide-react";
+
+export const staticIcons = {
+${n.map((e) => `    "${e}": ${h(r.get(e))},`).join("\n")}
+};
+`;
+}
+function p(e) {
+	return e.split("-").map((e) => e.charAt(0).toUpperCase() + e.slice(1)).join("");
+}
+var m = /* @__PURE__ */ new Set([
+	"Infinity",
+	"NaN",
+	"undefined",
+	"eval",
+	"arguments"
+]);
+function h(e) {
+	return m.has(e) ? `${e}Icon` : e;
+}
+async function g(e, t) {
+	let r = [], i;
+	try {
+		i = await a(e, { withFileTypes: !0 });
+	} catch {
+		return r;
+	}
+	for (let a of i) if (a.isDirectory()) {
+		if (t.has(a.name) || a.name.startsWith(".")) continue;
+		r.push(...await g(n(e, a.name), t));
+	} else a.isFile() && l.test(a.name) && r.push(n(e, a.name));
+	return r;
+}
+function _(n = {}) {
+	let { dir: a = "src", include: o = [], skipDirs: c } = n, p = new Set(t), m = new Set(c ?? u), h = new Set(o.filter((e) => p.has(e))), _ = process.cwd(), v = async () => {
+		let e = await g(r(_, a), m);
+		for (let t of e) try {
+			let e = await i(t, "utf8");
+			for (let t of d(e, p)) h.add(t);
+		} catch {}
+	};
+	return {
+		name: "tempest-icons",
+		enforce: "pre",
+		configResolved(e) {
+			_ = e.root ?? _;
+		},
+		async buildStart() {
+			await v();
+		},
+		resolveId(e) {
+			return e === "virtual:tempest-icons" ? s : null;
+		},
+		load(t) {
+			return t === s ? f([...h], e) : null;
+		},
+		async handleHotUpdate(e) {
+			if (!l.test(e.file)) return;
+			let t = h.size;
+			for (let t of d(await e.read(), p)) h.add(t);
+			if (h.size === t) return;
+			let n = e.server.moduleGraph.getModuleById(s);
+			if (n) return [n];
+		}
+	};
+}
+//#endregion
+export { o as TEMPEST_ICONS_ID, f as buildIconsModule, d as scanIconSlugs, _ as tempestIcons };
+
+//# sourceMappingURL=tempest-icons.js.map

package/dist/vite/tempest-icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tempest-icons.js","names":[],"sources":["../../src/vite/tempest-icons.ts"],"sourcesContent":["import { readdir, readFile } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\n\nimport { iconAliases } from \"@/icons/generated/aliases\";\nimport { iconNames } from \"@/icons/generated/icon-names\";\n\nimport type { TempestVitePlugin } from \"./tempest-pwa-manifest\";\n\n/** The module id an app imports to get its static registry. */\nexport const TEMPEST_ICONS_ID = \"virtual:tempest-icons\";\n\nconst RESOLVED_ID = `\\0${TEMPEST_ICONS_ID}`;\n\n/**\n * Slugs written as a literal `name` prop or a literal `name:` field.\n *\n * Matching the *attribute* rather than any kebab-case string is what keeps the\n * scan from sweeping in unrelated text — a CSS class, a translation key and a\n * route segment all look like slugs otherwise. Everything matched is still\n * validated against lucide's real slug list before it reaches the module.\n */\nconst NAME_PATTERNS = [\n    /\\bname\\s*=\\s*[\"']([a-z0-9-]+)[\"']/g,\n    /\\bname\\s*=\\s*\\{\\s*[\"']([a-z0-9-]+)[\"']\\s*\\}/g,\n    /\\bname\\s*:\\s*[\"']([a-z0-9-]+)[\"']/g,\n];\n\nconst SOURCE_FILE = /\\.[cm]?[jt]sx?$/;\nconst SKIP_DIRS = new Set([\"node_modules\", \"dist\", \"build\", \"coverage\"]);\n\nexport interface TempestIconsOptions {\n    /**\n     * Directory to scan, relative to the Vite root. Default: `\"src\"`.\n     */\n    dir?: string;\n    /**\n     * Extra slugs to include even when the scan cannot see them — a name built by\n     * concatenation, or one that only ever arrives from the API but is worth\n     * paying for statically because it is on the first screen.\n     */\n    include?: readonly string[];\n    /** Directory names to skip. Default: `node_modules`, `dist`, `build`, `coverage`. */\n    skipDirs?: readonly string[];\n}\n\n/**\n * Collect the icon slugs a source file references literally.\n *\n * @param code - File contents.\n * @param known - The set of real lucide slugs, aliases included.\n * @returns The slugs found, validated against `known`.\n */\nexport function scanIconSlugs(code: string, known: ReadonlySet<string>): string[] {\n    const found = new Set<string>();\n    for (const pattern of NAME_PATTERNS) {\n        pattern.lastIndex = 0;\n        let match: RegExpExecArray | null;\n        while ((match = pattern.exec(code)) !== null) {\n            if (known.has(match[1])) found.add(match[1]);\n        }\n    }\n    return [...found];\n}\n\n/**\n * Build the virtual module source for a set of slugs.\n *\n * Aliases resolve to their canonical slug before importing, because only the\n * canonical name is a real lucide export — but the alias key still points at the\n * component, so `<Icon name=\"alert-circle\" />` stays a zero-request lookup.\n *\n * @param slugs - Validated slugs to include.\n * @param aliases - Alias slug → canonical slug.\n * @returns ES module source.\n */\nexport function buildIconsModule(\n    slugs: readonly string[],\n    aliases: Record<string, string>,\n): string {\n    const sorted = [...new Set(slugs)].sort();\n    if (!sorted.length) return \"export const staticIcons = {};\\n\";\n\n    const componentOf = new Map<string, string>();\n    for (const slug of sorted) componentOf.set(slug, pascalCase(aliases[slug] ?? slug));\n\n    const named = [...new Set(componentOf.values())]\n        .sort()\n        .map((name) => (localName(name) === name ? name : `${name} as ${localName(name)}`))\n        .join(\", \");\n    const entries = sorted\n        .map((slug) => `    \"${slug}\": ${localName(componentOf.get(slug) as string)},`)\n        .join(\"\\n\");\n    return `import { ${named} } from \"lucide-react\";\n\nexport const staticIcons = {\n${entries}\n};\n`;\n}\n\n/** `circle-alert` → `CircleAlert`; `a-arrow-down` → `AArrowDown`. */\nfunction pascalCase(slug: string): string {\n    return slug\n        .split(\"-\")\n        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n        .join(\"\");\n}\n\n/**\n * Export names that would shadow a restricted global if bound directly.\n *\n * Lucide ships an icon literally called `infinity`, whose export is `Infinity`.\n * Binding that at module scope shadows the global, so the import is aliased.\n */\nconst RESERVED_NAMES = new Set([\"Infinity\", \"NaN\", \"undefined\", \"eval\", \"arguments\"]);\n\n/** The local binding to use for a lucide export name. */\nfunction localName(name: string): string {\n    return RESERVED_NAMES.has(name) ? `${name}Icon` : name;\n}\n\n/**\n * Walk a directory and collect every source file path.\n *\n * @param dir - Absolute directory to walk.\n * @param skip - Directory names to skip.\n * @returns Absolute file paths.\n */\nasync function collectSourceFiles(dir: string, skip: ReadonlySet<string>): Promise<string[]> {\n    const out: string[] = [];\n    let entries;\n    try {\n        entries = await readdir(dir, { withFileTypes: true });\n    } catch {\n        return out;\n    }\n    for (const entry of entries) {\n        if (entry.isDirectory()) {\n            if (skip.has(entry.name) || entry.name.startsWith(\".\")) continue;\n            out.push(...(await collectSourceFiles(join(dir, entry.name), skip)));\n        } else if (entry.isFile() && SOURCE_FILE.test(entry.name)) {\n            out.push(join(dir, entry.name));\n        }\n    }\n    return out;\n}\n\n/**\n * Generate a static icon registry from the slugs your source mentions.\n *\n * Removes the reason to reach for `lucide-react`'s `DynamicIcon`: the slugs an app\n * writes as literals become ordinary static imports, so the bundler keeps exactly\n * those icons and the browser makes **no** extra request for them. A slug that only\n * exists at runtime still works — `<Icon>` falls back to fetching one shard per\n * initial letter.\n *\n * The scan reads the source tree directly at `buildStart` rather than harvesting\n * modules as they pass through `transform`: relying on transform order would let\n * the virtual module load before every consumer had been seen, and the registry\n * would come out short on a cold dev start — silently, since the missing slugs\n * would still render via the lazy path.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestIcons } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({ plugins: [tempestIcons()] });\n *\n * @example\n * // src/main.tsx\n * import { IconProvider } from \"tempest-react-sdk/icons\";\n * import { staticIcons } from \"virtual:tempest-icons\";\n *\n * <IconProvider registry={staticIcons}>\n *     <App />\n * </IconProvider>\n */\nexport function tempestIcons(options: TempestIconsOptions = {}): TempestVitePlugin {\n    const { dir = \"src\", include = [], skipDirs } = options;\n    const known = new Set<string>(iconNames);\n    const skip = new Set<string>(skipDirs ?? SKIP_DIRS);\n    const slugs = new Set<string>(include.filter((slug) => known.has(slug)));\n    let root = process.cwd();\n\n    /** Rescan the source tree, keeping the explicitly included slugs. */\n    const rescan = async (): Promise<void> => {\n        const files = await collectSourceFiles(resolve(root, dir), skip);\n        for (const file of files) {\n            try {\n                const code = await readFile(file, \"utf8\");\n                for (const slug of scanIconSlugs(code, known)) slugs.add(slug);\n            } catch {\n                /* an unreadable file just contributes nothing */\n            }\n        }\n    };\n\n    return {\n        name: \"tempest-icons\",\n        enforce: \"pre\",\n\n        configResolved(config: { root?: string }) {\n            root = config.root ?? root;\n        },\n\n        async buildStart() {\n            await rescan();\n        },\n\n        resolveId(id: string) {\n            return id === TEMPEST_ICONS_ID ? RESOLVED_ID : null;\n        },\n\n        load(id: string) {\n            return id === RESOLVED_ID ? buildIconsModule([...slugs], iconAliases) : null;\n        },\n\n        /**\n         * Pick up a slug added while the dev server is running.\n         *\n         * A newly written `<Icon name=\"save\" />` would otherwise only render via\n         * the lazy path until the next restart. Rescanning the changed file and\n         * invalidating the virtual module keeps dev and build agreeing on what the\n         * static registry contains.\n         */\n        async handleHotUpdate(ctx: {\n            file: string;\n            read: () => Promise<string>;\n            server: { moduleGraph: { getModuleById: (id: string) => unknown } };\n        }) {\n            if (!SOURCE_FILE.test(ctx.file)) return;\n            const before = slugs.size;\n            for (const slug of scanIconSlugs(await ctx.read(), known)) slugs.add(slug);\n            if (slugs.size === before) return;\n            const mod = ctx.server.moduleGraph.getModuleById(RESOLVED_ID);\n            if (mod) return [mod];\n        },\n    } as TempestVitePlugin;\n}\n"],"mappings":"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"}

package/dist/vite.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./vite/create-vite-config.cjs"),t=require("./vite/tempest-pwa-manifest.cjs"),n=require("./vite/tempest-pwa-icons.cjs"),r=require("./vite/tempest-pwa-dev-sw.cjs");exports.createViteConfig=e.createViteConfig,exports.tempestPwaDevSw=r.tempestPwaDevSw,exports.tempestPwaIcons=n.tempestPwaIcons,exports.tempestPwaManifest=t.tempestPwaManifest;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./vite/tempest-icons.cjs"),t=require("./vite/create-vite-config.cjs"),n=require("./vite/tempest-pwa-manifest.cjs"),r=require("./vite/tempest-pwa-icons.cjs"),i=require("./vite/tempest-pwa-dev-sw.cjs");exports.TEMPEST_ICONS_ID=e.TEMPEST_ICONS_ID,exports.buildIconsModule=e.buildIconsModule,exports.createViteConfig=t.createViteConfig,exports.scanIconSlugs=e.scanIconSlugs,exports.tempestIcons=e.tempestIcons,exports.tempestPwaDevSw=i.tempestPwaDevSw,exports.tempestPwaIcons=r.tempestPwaIcons,exports.tempestPwaManifest=n.tempestPwaManifest;

package/dist/vite.d.ts

@@ -8,6 +8,19 @@ export declare interface AppleSplashSpec {
     ratio: number;
 }
 
+/**
+ * Build the virtual module source for a set of slugs.
+ *
+ * Aliases resolve to their canonical slug before importing, because only the
+ * canonical name is a real lucide export — but the alias key still points at the
+ * component, so `<Icon name="alert-circle" />` stays a zero-request lookup.
+ *
+ * @param slugs - Validated slugs to include.
+ * @param aliases - Alias slug → canonical slug.
+ * @returns ES module source.
+ */
+export declare function buildIconsModule(slugs: readonly string[], aliases: Record<string, string>): string;
+
 /**
  * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`
  * plugin, the `@` → `src` import alias, and sane dev-server defaults — so a
@@ -49,6 +62,13 @@ export declare interface CreateViteConfigOptions {
     alias?: Record<string, string>;
     /** Vite plugins appended after `@vitejs/plugin-react`. */
     plugins?: unknown[];
+    /**
+     * The `tempestIcons()` plugin, which generates `virtual:tempest-icons` from the
+     * icon slugs your source mentions. On by default — it only ever removes
+     * requests. Pass `false` to leave it out, or an options object to configure the
+     * scan.
+     */
+    icons?: boolean | TempestIconsOptions;
     /**
      * Arbitrary Vite config (a `UserConfig` object) deep-merged last, for
      * escape-hatch overrides (build target, define, extra `server` keys, …).
@@ -62,6 +82,65 @@ export declare interface CreateViteConfigOptions {
  */
 export declare type ProxyEntry = string | Record<string, unknown>;
 
+/**
+ * Collect the icon slugs a source file references literally.
+ *
+ * @param code - File contents.
+ * @param known - The set of real lucide slugs, aliases included.
+ * @returns The slugs found, validated against `known`.
+ */
+export declare function scanIconSlugs(code: string, known: ReadonlySet<string>): string[];
+
+/** The module id an app imports to get its static registry. */
+export declare const TEMPEST_ICONS_ID = "virtual:tempest-icons";
+
+/**
+ * Generate a static icon registry from the slugs your source mentions.
+ *
+ * Removes the reason to reach for `lucide-react`'s `DynamicIcon`: the slugs an app
+ * writes as literals become ordinary static imports, so the bundler keeps exactly
+ * those icons and the browser makes **no** extra request for them. A slug that only
+ * exists at runtime still works — `<Icon>` falls back to fetching one shard per
+ * initial letter.
+ *
+ * The scan reads the source tree directly at `buildStart` rather than harvesting
+ * modules as they pass through `transform`: relying on transform order would let
+ * the virtual module load before every consumer had been seen, and the registry
+ * would come out short on a cold dev start — silently, since the missing slugs
+ * would still render via the lazy path.
+ *
+ * @example
+ * // vite.config.ts
+ * import { createViteConfig, tempestIcons } from "tempest-react-sdk/vite";
+ *
+ * export default createViteConfig({ plugins: [tempestIcons()] });
+ *
+ * @example
+ * // src/main.tsx
+ * import { IconProvider } from "tempest-react-sdk/icons";
+ * import { staticIcons } from "virtual:tempest-icons";
+ *
+ * <IconProvider registry={staticIcons}>
+ *     <App />
+ * </IconProvider>
+ */
+export declare function tempestIcons(options?: TempestIconsOptions): TempestVitePlugin;
+
+export declare interface TempestIconsOptions {
+    /**
+     * Directory to scan, relative to the Vite root. Default: `"src"`.
+     */
+    dir?: string;
+    /**
+     * Extra slugs to include even when the scan cannot see them — a name built by
+     * concatenation, or one that only ever arrives from the API but is worth
+     * paying for statically because it is on the first screen.
+     */
+    include?: readonly string[];
+    /** Directory names to skip. Default: `node_modules`, `dist`, `build`, `coverage`. */
+    skipDirs?: readonly string[];
+}
+
 /**
  * Dev-server plugin that makes the service worker available under `npm run dev`.
  *

package/dist/vite.js

@@ -1,5 +1,6 @@
-import { createViteConfig as e } from "./vite/create-vite-config.js";
-import { tempestPwaManifest as t } from "./vite/tempest-pwa-manifest.js";
-import { tempestPwaIcons as n } from "./vite/tempest-pwa-icons.js";
-import { tempestPwaDevSw as r } from "./vite/tempest-pwa-dev-sw.js";
-export { e as createViteConfig, r as tempestPwaDevSw, n as tempestPwaIcons, t as tempestPwaManifest };
+import { TEMPEST_ICONS_ID as e, buildIconsModule as t, scanIconSlugs as n, tempestIcons as r } from "./vite/tempest-icons.js";
+import { createViteConfig as i } from "./vite/create-vite-config.js";
+import { tempestPwaManifest as a } from "./vite/tempest-pwa-manifest.js";
+import { tempestPwaIcons as o } from "./vite/tempest-pwa-icons.js";
+import { tempestPwaDevSw as s } from "./vite/tempest-pwa-dev-sw.js";
+export { e as TEMPEST_ICONS_ID, t as buildIconsModule, i as createViteConfig, n as scanIconSlugs, r as tempestIcons, s as tempestPwaDevSw, o as tempestPwaIcons, a as tempestPwaManifest };

package/dist/ws/use-web-socket.cjs

@@ -1,2 +1,2 @@
-const e=require("./create-web-socket.cjs");let t=require("react");function n(n,r={}){let{enabled:i=!0,onMessage:a,...o}=r,[s,c]=(0,t.useState)(`idle`),[l,u]=(0,t.useState)(null),d=(0,t.useRef)(null),f=(0,t.useRef)(a);return f.current=a,(0,t.useEffect)(()=>{if(!i||!n){c(`idle`);return}let t=e.createWebSocket(n,{...o,onStatusChange:c,onMessage:e=>{u(e),f.current?.(e)}});return d.current=t,()=>{t.close(),d.current=null}},[n,i]),{status:s,lastMessage:l,send:(0,t.useCallback)(e=>d.current?.send(e)??!1,[]),reconnect:(0,t.useCallback)(()=>{d.current?.reconnect()},[])}}exports.useWebSocket=n;
+const e=require("./create-web-socket.cjs");let t=require("react");function n(n,r={}){let{enabled:i=!0,onMessage:a,...o}=r,[s,c]=(0,t.useState)(`idle`),[l,u]=(0,t.useState)(null),d=(0,t.useRef)(null),f=(0,t.useRef)(a);return(0,t.useEffect)(()=>{f.current=a},[a]),(0,t.useEffect)(()=>{if(!i||!n){c(`idle`);return}let t=e.createWebSocket(n,{...o,onStatusChange:c,onMessage:e=>{u(e),f.current?.(e)}});return d.current=t,()=>{t.close(),d.current=null}},[n,i]),{status:s,lastMessage:l,send:(0,t.useCallback)(e=>d.current?.send(e)??!1,[]),reconnect:(0,t.useCallback)(()=>{d.current?.reconnect()},[])}}exports.useWebSocket=n;
 //# sourceMappingURL=use-web-socket.cjs.map

package/dist/ws/use-web-socket.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-web-socket.cjs","names":[],"sources":["../../src/ws/use-web-socket.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    createWebSocket,\n    type CreateWebSocketOptions,\n    type WebSocketController,\n    type WebSocketMessage,\n    type WebSocketStatus,\n} from \"./create-web-socket\";\n\nexport interface UseWebSocketOptions<T> extends Omit<CreateWebSocketOptions<T>, \"onStatusChange\"> {\n    /** When false, the socket is not opened. Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseWebSocketResult<T> {\n    status: WebSocketStatus;\n    /** Last decoded frame received. */\n    lastMessage: WebSocketMessage<T> | null;\n    /** Send a payload through the active connection. Returns false when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Force a reconnect, resetting the retry counter. */\n    reconnect: () => void;\n}\n\n/**\n * React hook around {@link createWebSocket}. Manages the connection lifecycle\n * for the host component and tears it down on unmount.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const { enabled = true, onMessage, ...rest } = options;\n    const [status, setStatus] = useState<WebSocketStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<WebSocketMessage<T> | null>(null);\n    const controllerRef = useRef<WebSocketController | null>(null);\n\n    const onMessageRef = useRef(onMessage);\n    onMessageRef.current = onMessage;\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createWebSocket<T>(url, {\n            ...rest,\n            onStatusChange: setStatus,\n            onMessage: (message) => {\n                setLastMessage(message);\n                onMessageRef.current?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [url, enabled]);\n\n    const send = useCallback((payload: string | Blob | BufferSource): boolean => {\n        return controllerRef.current?.send(payload) ?? false;\n    }, []);\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    return { status, lastMessage, send, reconnect };\n}\n"],"mappings":"kEA4BA,SAAgB,EACZ,EACA,EAAkC,CAAC,EACd,CACrB,GAAM,CAAE,UAAU,GAAM,YAAW,GAAG,GAAS,EACzC,CAAC,EAAQ,IAAA,EAAA,EAAA,SAAA,CAAuC,MAAM,EACtD,CAAC,EAAa,IAAA,EAAA,EAAA,SAAA,CAAuD,IAAI,EACzE,GAAA,EAAA,EAAA,OAAA,CAAmD,IAAI,EAEvD,GAAA,EAAA,EAAA,OAAA,CAAsB,CAAS,EAkCrC,MAjCA,GAAa,QAAU,GAEvB,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,CAAC,GAAW,CAAC,EAAK,CAClB,EAAU,MAAM,EAChB,MACJ,CAEA,IAAM,EAAa,EAAA,gBAAmB,EAAK,CACvC,GAAG,EACH,eAAgB,EAChB,UAAY,GAAY,CACpB,EAAe,CAAO,EACtB,EAAa,UAAU,CAAO,CAClC,CACJ,CAAC,EAGD,MAFA,GAAc,QAAU,MAEX,CACT,EAAW,MAAM,EACjB,EAAc,QAAU,IAC5B,CAEJ,EAAG,CAAC,EAAK,CAAO,CAAC,EAUV,CAAE,SAAQ,cAAa,MAAA,EAAA,EAAA,YAAA,CARJ,GACf,EAAc,SAAS,KAAK,CAAO,GAAK,GAChD,CAAC,CAM0B,EAAM,WAAA,EAAA,EAAA,YAAA,KAJM,CACtC,EAAc,SAAS,UAAU,CACrC,EAAG,CAAC,CAEgC,CAAU,CAClD"}
+{"version":3,"file":"use-web-socket.cjs","names":[],"sources":["../../src/ws/use-web-socket.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    createWebSocket,\n    type CreateWebSocketOptions,\n    type WebSocketController,\n    type WebSocketMessage,\n    type WebSocketStatus,\n} from \"./create-web-socket\";\n\nexport interface UseWebSocketOptions<T> extends Omit<CreateWebSocketOptions<T>, \"onStatusChange\"> {\n    /** When false, the socket is not opened. Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseWebSocketResult<T> {\n    status: WebSocketStatus;\n    /** Last decoded frame received. */\n    lastMessage: WebSocketMessage<T> | null;\n    /** Send a payload through the active connection. Returns false when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Force a reconnect, resetting the retry counter. */\n    reconnect: () => void;\n}\n\n/**\n * React hook around {@link createWebSocket}. Manages the connection lifecycle\n * for the host component and tears it down on unmount.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const { enabled = true, onMessage, ...rest } = options;\n    const [status, setStatus] = useState<WebSocketStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<WebSocketMessage<T> | null>(null);\n    const controllerRef = useRef<WebSocketController | null>(null);\n\n    const onMessageRef = useRef(onMessage);\n    useEffect(() => {\n        onMessageRef.current = onMessage;\n    }, [onMessage]);\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createWebSocket<T>(url, {\n            ...rest,\n            onStatusChange: setStatus,\n            onMessage: (message) => {\n                setLastMessage(message);\n                onMessageRef.current?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [url, enabled]);\n\n    const send = useCallback((payload: string | Blob | BufferSource): boolean => {\n        return controllerRef.current?.send(payload) ?? false;\n    }, []);\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    return { status, lastMessage, send, reconnect };\n}\n"],"mappings":"kEA4BA,SAAgB,EACZ,EACA,EAAkC,CAAC,EACd,CACrB,GAAM,CAAE,UAAU,GAAM,YAAW,GAAG,GAAS,EACzC,CAAC,EAAQ,IAAA,EAAA,EAAA,SAAA,CAAuC,MAAM,EACtD,CAAC,EAAa,IAAA,EAAA,EAAA,SAAA,CAAuD,IAAI,EACzE,GAAA,EAAA,EAAA,OAAA,CAAmD,IAAI,EAEvD,GAAA,EAAA,EAAA,OAAA,CAAsB,CAAS,EAoCrC,OAnCA,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAa,QAAU,CAC3B,EAAG,CAAC,CAAS,CAAC,GAEd,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,CAAC,GAAW,CAAC,EAAK,CAClB,EAAU,MAAM,EAChB,MACJ,CAEA,IAAM,EAAa,EAAA,gBAAmB,EAAK,CACvC,GAAG,EACH,eAAgB,EAChB,UAAY,GAAY,CACpB,EAAe,CAAO,EACtB,EAAa,UAAU,CAAO,CAClC,CACJ,CAAC,EAGD,MAFA,GAAc,QAAU,MAEX,CACT,EAAW,MAAM,EACjB,EAAc,QAAU,IAC5B,CAEJ,EAAG,CAAC,EAAK,CAAO,CAAC,EAUV,CAAE,SAAQ,cAAa,MAAA,EAAA,EAAA,YAAA,CARJ,GACf,EAAc,SAAS,KAAK,CAAO,GAAK,GAChD,CAAC,CAM0B,EAAM,WAAA,EAAA,EAAA,YAAA,KAJM,CACtC,EAAc,SAAS,UAAU,CACrC,EAAG,CAAC,CAEgC,CAAU,CAClD"}

package/dist/ws/use-web-socket.js

@@ -3,7 +3,9 @@ import { useCallback as t, useEffect as n, useRef as r, useState as i } from "re
 //#region src/ws/use-web-socket.ts
 function a(a, o = {}) {
 	let { enabled: s = !0, onMessage: c, ...l } = o, [u, d] = i("idle"), [f, p] = i(null), m = r(null), h = r(c);
-	return h.current = c, n(() => {
+	return n(() => {
+		h.current = c;
+	}, [c]), n(() => {
 		if (!s || !a) {
 			d("idle");
 			return;

package/dist/ws/use-web-socket.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-web-socket.js","names":[],"sources":["../../src/ws/use-web-socket.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    createWebSocket,\n    type CreateWebSocketOptions,\n    type WebSocketController,\n    type WebSocketMessage,\n    type WebSocketStatus,\n} from \"./create-web-socket\";\n\nexport interface UseWebSocketOptions<T> extends Omit<CreateWebSocketOptions<T>, \"onStatusChange\"> {\n    /** When false, the socket is not opened. Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseWebSocketResult<T> {\n    status: WebSocketStatus;\n    /** Last decoded frame received. */\n    lastMessage: WebSocketMessage<T> | null;\n    /** Send a payload through the active connection. Returns false when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Force a reconnect, resetting the retry counter. */\n    reconnect: () => void;\n}\n\n/**\n * React hook around {@link createWebSocket}. Manages the connection lifecycle\n * for the host component and tears it down on unmount.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const { enabled = true, onMessage, ...rest } = options;\n    const [status, setStatus] = useState<WebSocketStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<WebSocketMessage<T> | null>(null);\n    const controllerRef = useRef<WebSocketController | null>(null);\n\n    const onMessageRef = useRef(onMessage);\n    onMessageRef.current = onMessage;\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createWebSocket<T>(url, {\n            ...rest,\n            onStatusChange: setStatus,\n            onMessage: (message) => {\n                setLastMessage(message);\n                onMessageRef.current?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [url, enabled]);\n\n    const send = useCallback((payload: string | Blob | BufferSource): boolean => {\n        return controllerRef.current?.send(payload) ?? false;\n    }, []);\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    return { status, lastMessage, send, reconnect };\n}\n"],"mappings":";;;AA4BA,SAAgB,EACZ,GACA,IAAkC,CAAC,GACd;CACrB,IAAM,EAAE,aAAU,IAAM,cAAW,GAAG,MAAS,GACzC,CAAC,GAAQ,KAAa,EAA0B,MAAM,GACtD,CAAC,GAAa,KAAkB,EAAqC,IAAI,GACzE,IAAgB,EAAmC,IAAI,GAEvD,IAAe,EAAO,CAAS;CAkCrC,OAjCA,EAAa,UAAU,GAEvB,QAAgB;EACZ,IAAI,CAAC,KAAW,CAAC,GAAK;GAClB,EAAU,MAAM;GAChB;EACJ;EAEA,IAAM,IAAa,EAAmB,GAAK;GACvC,GAAG;GACH,gBAAgB;GAChB,YAAY,MAAY;IAEpB,AADA,EAAe,CAAO,GACtB,EAAa,UAAU,CAAO;GAClC;EACJ,CAAC;EAGD,OAFA,EAAc,UAAU,SAEX;GAET,AADA,EAAW,MAAM,GACjB,EAAc,UAAU;EAC5B;CAEJ,GAAG,CAAC,GAAK,CAAO,CAAC,GAUV;EAAE;EAAQ;EAAa,MARjB,GAAa,MACf,EAAc,SAAS,KAAK,CAAO,KAAK,IAChD,CAAC,CAM0B;EAAM,WAJlB,QAAwB;GACtC,EAAc,SAAS,UAAU;EACrC,GAAG,CAAC,CAEgC;CAAU;AAClD"}
+{"version":3,"file":"use-web-socket.js","names":[],"sources":["../../src/ws/use-web-socket.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport {\n    createWebSocket,\n    type CreateWebSocketOptions,\n    type WebSocketController,\n    type WebSocketMessage,\n    type WebSocketStatus,\n} from \"./create-web-socket\";\n\nexport interface UseWebSocketOptions<T> extends Omit<CreateWebSocketOptions<T>, \"onStatusChange\"> {\n    /** When false, the socket is not opened. Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseWebSocketResult<T> {\n    status: WebSocketStatus;\n    /** Last decoded frame received. */\n    lastMessage: WebSocketMessage<T> | null;\n    /** Send a payload through the active connection. Returns false when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Force a reconnect, resetting the retry counter. */\n    reconnect: () => void;\n}\n\n/**\n * React hook around {@link createWebSocket}. Manages the connection lifecycle\n * for the host component and tears it down on unmount.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const { enabled = true, onMessage, ...rest } = options;\n    const [status, setStatus] = useState<WebSocketStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<WebSocketMessage<T> | null>(null);\n    const controllerRef = useRef<WebSocketController | null>(null);\n\n    const onMessageRef = useRef(onMessage);\n    useEffect(() => {\n        onMessageRef.current = onMessage;\n    }, [onMessage]);\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createWebSocket<T>(url, {\n            ...rest,\n            onStatusChange: setStatus,\n            onMessage: (message) => {\n                setLastMessage(message);\n                onMessageRef.current?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [url, enabled]);\n\n    const send = useCallback((payload: string | Blob | BufferSource): boolean => {\n        return controllerRef.current?.send(payload) ?? false;\n    }, []);\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    return { status, lastMessage, send, reconnect };\n}\n"],"mappings":";;;AA4BA,SAAgB,EACZ,GACA,IAAkC,CAAC,GACd;CACrB,IAAM,EAAE,aAAU,IAAM,cAAW,GAAG,MAAS,GACzC,CAAC,GAAQ,KAAa,EAA0B,MAAM,GACtD,CAAC,GAAa,KAAkB,EAAqC,IAAI,GACzE,IAAgB,EAAmC,IAAI,GAEvD,IAAe,EAAO,CAAS;CAoCrC,OAnCA,QAAgB;EACZ,EAAa,UAAU;CAC3B,GAAG,CAAC,CAAS,CAAC,GAEd,QAAgB;EACZ,IAAI,CAAC,KAAW,CAAC,GAAK;GAClB,EAAU,MAAM;GAChB;EACJ;EAEA,IAAM,IAAa,EAAmB,GAAK;GACvC,GAAG;GACH,gBAAgB;GAChB,YAAY,MAAY;IAEpB,AADA,EAAe,CAAO,GACtB,EAAa,UAAU,CAAO;GAClC;EACJ,CAAC;EAGD,OAFA,EAAc,UAAU,SAEX;GAET,AADA,EAAW,MAAM,GACjB,EAAc,UAAU;EAC5B;CAEJ,GAAG,CAAC,GAAK,CAAO,CAAC,GAUV;EAAE;EAAQ;EAAa,MARjB,GAAa,MACf,EAAc,SAAS,KAAK,CAAO,KAAK,IAChD,CAAC,CAM0B;EAAM,WAJlB,QAAwB;GACtC,EAAc,SAAS,UAAU;EACrC,GAAG,CAAC,CAEgC;CAAU;AAClD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tempest-react-sdk",
-  "version": "0.24.0",
+  "version": "0.26.0",
   "description": "SDK público da Tempest com componentes, hooks e integrações para projetos React.",
   "type": "module",
   "license": "MIT",
@@ -80,12 +80,21 @@
       "import": "./dist/br.js",
       "require": "./dist/br.cjs"
     },
+    "./icons": {
+      "types": "./dist/icons.d.ts",
+      "import": "./dist/icons.js",
+      "require": "./dist/icons.cjs"
+    },
+    "./icons/virtual": {
+      "types": "./dist/icons-virtual.d.ts"
+    },
     "./styles.css": "./dist/styles.css",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./utilities.css": "./dist/utilities.css"
   },
   "scripts": {
     "dev": "vite build --watch",
-    "build": "tsc -b tsconfig.build.json && vite build",
+    "build": "tsc -b tsconfig.build.json && node --max-old-space-size=6144 ./node_modules/vite/bin/vite.js build && node scripts/copy-css-assets.mjs",
     "typecheck": "tsc -b tsconfig.json --noEmit",
     "lint": "eslint .",
     "format": "prettier --write .",
@@ -97,6 +106,7 @@
     "size": "size-limit",
     "docs:llms": "node scripts/gen-llms.mjs",
     "gen:geodata": "node scripts/gen-br-geodata.mjs",
+    "gen:icons": "node scripts/gen-icons.mjs",
     "vendor:vision": "node scripts/vendor-vision.mjs",
     "prepare": "husky",
     "prepublishOnly": "npm run typecheck && npm run lint && npm run test:run && npm run build",
@@ -116,7 +126,7 @@
     "@tanstack/react-query": "^5.0.0",
     "dexie": "^4.4.2",
     "fflate": "^0.8.3",
-    "lucide-react": ">=0.400.0",
+    "lucide-react": "^1.26.0",
     "react-hook-form": "^7.76.0",
     "react-router": "^8.3.0",
     "zod": "^3.23.0 || ^4.0.0",

package/template/package.json

@@ -17,7 +17,7 @@
   "dependencies": {
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
-    "tempest-react-sdk": "^0.6.0"
+    "tempest-react-sdk": "^0.26.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",