tempest-react-sdk 0.39.0 → 0.40.0

package/dist/vite/tempest-pwa-dev-sw.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tempest-pwa-dev-sw.cjs","names":[],"sources":["../../src/vite/tempest-pwa-dev-sw.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport type { Plugin } from \"vite\";\nimport type { TempestVitePlugin } from \"./tempest-pwa-manifest\";\n\n/** Options for {@link tempestPwaDevSw}. */\nexport interface TempestPwaDevSwOptions {\n    /** Service-worker entry, relative to the project root. Default `src/sw.ts`. */\n    swSrc?: string;\n    /** URL the worker is served at (must match `registerServiceWorker`). Default `/sw.js`. */\n    swUrl?: string;\n    /** Dev URL of the precache manifest. Default `/precache-manifest.json`. */\n    manifestUrl?: string;\n    /** Serve the worker in dev. Default `true`; set `false` to opt out. */\n    enabled?: boolean;\n}\n\n/**\n * Dev-server plugin that makes the service worker available under `npm run dev`.\n *\n * The production worker is bundled at build time (`vite.sw.config.ts`), so in\n * dev there is no `/sw.js` to register. This plugin compiles `swSrc` on the fly\n * with esbuild and serves it as a classic worker, plus an empty\n * `precache-manifest.json` (there are no hashed build assets to precache in\n * dev — push and runtime caching still work). It closes the \"SW in dev\" gap\n * that otherwise only `vite-plugin-pwa`'s `devOptions` covered.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestPwaDevSw } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({ plugins: [tempestPwaDevSw()] });\n */\nexport function tempestPwaDevSw(options: TempestPwaDevSwOptions = {}): TempestVitePlugin {\n    const {\n        swSrc = \"src/sw.ts\",\n        swUrl = \"/sw.js\",\n        manifestUrl = \"/precache-manifest.json\",\n        enabled = true,\n    } = options;\n\n    let root = process.cwd();\n\n    const plugin: Plugin = {\n        name: \"tempest-pwa-dev-sw\",\n        apply: \"serve\",\n        configResolved(config) {\n            root = config.root ?? process.cwd();\n        },\n        configureServer(server) {\n            if (!enabled) return;\n            server.middlewares.use(async (req, res, next) => {\n                const url = (req.url ?? \"\").split(\"?\")[0];\n\n                if (url === swUrl) {\n                    try {\n                        const esbuild = await import(\"esbuild\");\n                        const result = await esbuild.build({\n                            entryPoints: [resolve(root, swSrc)],\n                            bundle: true,\n                            format: \"iife\",\n                            platform: \"browser\",\n                            target: \"es2020\",\n                            write: false,\n                            absWorkingDir: root,\n                            logLevel: \"silent\",\n                        });\n                        res.setHeader(\"Content-Type\", \"application/javascript\");\n                        res.setHeader(\"Service-Worker-Allowed\", \"/\");\n                        res.setHeader(\"Cache-Control\", \"no-cache\");\n                        res.end(result.outputFiles[0].text);\n                    } catch (error) {\n                        res.statusCode = 500;\n                        res.end(`// SW dev build failed:\\n// ${String(error)}`);\n                    }\n                    return;\n                }\n\n                if (url === manifestUrl) {\n                    res.setHeader(\"Content-Type\", \"application/json\");\n                    res.setHeader(\"Cache-Control\", \"no-cache\");\n                    res.end(JSON.stringify({ version: \"dev\", urls: [] }));\n                    return;\n                }\n\n                next();\n            });\n        },\n    };\n\n    return plugin as TempestVitePlugin;\n}\n"],"mappings":"2BAgCA,SAAgB,EAAgB,EAAkC,CAAC,EAAsB,CACrF,GAAM,CACF,QAAQ,YACR,QAAQ,SACR,cAAc,0BACd,UAAU,IACV,EAEA,EAAO,QAAQ,IAAI,EAiDvB,MAAO,CA9CH,KAAM,qBACN,MAAO,QACP,eAAe,EAAQ,CACnB,EAAO,EAAO,MAAQ,QAAQ,IAAI,CACtC,EACA,gBAAgB,EAAQ,CACf,GACL,EAAO,YAAY,IAAI,MAAO,EAAK,EAAK,IAAS,CAC7C,IAAM,GAAO,EAAI,KAAO,GAAA,CAAI,MAAM,GAAG,CAAC,CAAC,GAEvC,GAAI,IAAQ,EAAO,CACf,GAAI,CAEA,IAAM,EAAS,MAAM,MADC,OAAO,WAAA,CACA,MAAM,CAC/B,YAAa,EAAA,EAAA,EAAA,QAAA,CAAS,EAAM,CAAK,CAAC,EAClC,OAAQ,GACR,OAAQ,OACR,SAAU,UACV,OAAQ,SACR,MAAO,GACP,cAAe,EACf,SAAU,QACd,CAAC,EACD,EAAI,UAAU,eAAgB,wBAAwB,EACtD,EAAI,UAAU,yBAA0B,GAAG,EAC3C,EAAI,UAAU,gBAAiB,UAAU,EACzC,EAAI,IAAI,EAAO,YAAY,EAAE,CAAC,IAAI,CACtC,OAAS,EAAO,CACZ,EAAI,WAAa,IACjB,EAAI,IAAI,+BAA+B,OAAO,CAAK,GAAG,CAC1D,CACA,MACJ,CAEA,GAAI,IAAQ,EAAa,CACrB,EAAI,UAAU,eAAgB,kBAAkB,EAChD,EAAI,UAAU,gBAAiB,UAAU,EACzC,EAAI,IAAI,KAAK,UAAU,CAAE,QAAS,MAAO,KAAM,CAAC,CAAE,CAAC,CAAC,EACpD,MACJ,CAEA,EAAK,CACT,CAAC,CACL,CAGG,CACX"}
+{"version":3,"file":"tempest-pwa-dev-sw.cjs","names":[],"sources":["../../src/vite/tempest-pwa-dev-sw.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport type { Plugin } from \"vite\";\nimport type { TempestVitePlugin } from \"./tempest-pwa-manifest\";\n\n/** Options for {@link tempestPwaDevSw}. */\nexport interface TempestPwaDevSwOptions {\n    /** Service-worker entry, relative to the project root. Default `src/sw.ts`. */\n    swSrc?: string;\n    /** URL the worker is served at (must match `registerServiceWorker`). Default `/sw.js`. */\n    swUrl?: string;\n    /** Dev URL of the precache manifest. Default `/precache-manifest.json`. */\n    manifestUrl?: string;\n    /** Serve the worker in dev. Default `true`; set `false` to opt out. */\n    enabled?: boolean;\n}\n\n/**\n * Dev-server plugin that makes the service worker available under `npm run dev`.\n *\n * The production worker is bundled at build time (`vite.sw.config.ts`), so in\n * dev there is no `/sw.js` to register. This plugin compiles `swSrc` on the fly\n * with esbuild and serves it as a classic worker, plus an empty\n * `precache-manifest.json` (there are no hashed build assets to precache in\n * dev — push and runtime caching still work). It closes the \"SW in dev\" gap\n * that otherwise only `vite-plugin-pwa`'s `devOptions` covered.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestPwaDevSw } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({ plugins: [tempestPwaDevSw()] });\n */\nexport function tempestPwaDevSw(options: TempestPwaDevSwOptions = {}): TempestVitePlugin {\n    const {\n        swSrc = \"src/sw.ts\",\n        swUrl = \"/sw.js\",\n        manifestUrl = \"/precache-manifest.json\",\n        enabled = true,\n    } = options;\n\n    let root = process.cwd();\n\n    const plugin: Plugin = {\n        name: \"tempest-pwa-dev-sw\",\n        apply: \"serve\",\n        configResolved(config) {\n            root = config.root ?? process.cwd();\n        },\n        configureServer(server) {\n            if (!enabled) return;\n            server.middlewares.use(async (req, res, next) => {\n                const url = (req.url ?? \"\").split(\"?\")[0];\n\n                if (url === swUrl) {\n                    try {\n                        const esbuild = await import(\"esbuild\");\n                        const result = await esbuild.build({\n                            entryPoints: [resolve(root, swSrc)],\n                            bundle: true,\n                            format: \"iife\",\n                            platform: \"browser\",\n                            target: \"es2020\",\n                            write: false,\n                            absWorkingDir: root,\n                            logLevel: \"silent\",\n                        });\n                        res.setHeader(\"Content-Type\", \"application/javascript\");\n                        res.setHeader(\"Service-Worker-Allowed\", \"/\");\n                        res.setHeader(\"Cache-Control\", \"no-cache\");\n                        res.end(result.outputFiles[0].text);\n                    } catch (error) {\n                        res.statusCode = 500;\n                        res.end(`// SW dev build failed:\\n// ${String(error)}`);\n                    }\n                    return;\n                }\n\n                if (url === manifestUrl) {\n                    res.setHeader(\"Content-Type\", \"application/json\");\n                    res.setHeader(\"Cache-Control\", \"no-cache\");\n                    res.end(JSON.stringify({ version: \"dev\", urls: [] }));\n                    return;\n                }\n\n                next();\n            });\n        },\n    };\n\n    return plugin as TempestVitePlugin;\n}\n"],"mappings":"2BAgCA,SAAgB,EAAgB,EAAkC,CAAC,EAAsB,CACrF,GAAM,CACF,QAAQ,YACR,QAAQ,SACR,cAAc,0BACd,UAAU,IACV,EAEA,EAAO,QAAQ,IAAI,EAiDvB,MAAO,CA9CH,KAAM,qBACN,MAAO,QACP,eAAe,EAAQ,CACnB,EAAO,EAAO,MAAQ,QAAQ,IAAI,CACtC,EACA,gBAAgB,EAAQ,CACf,GACL,EAAO,YAAY,IAAI,MAAO,EAAK,EAAK,IAAS,CAC7C,IAAM,GAAO,EAAI,KAAO,GAAA,CAAI,MAAM,GAAG,CAAC,CAAC,GAEvC,GAAI,IAAQ,EAAO,CACf,GAAI,CAEA,IAAM,EAAS,MAAM,MADC,OAAO,WAAA,CACA,MAAM,CAC/B,YAAa,EAAA,EAAC,EAAA,QAAA,CAAQ,EAAM,CAAK,CAAC,EAClC,OAAQ,GACR,OAAQ,OACR,SAAU,UACV,OAAQ,SACR,MAAO,GACP,cAAe,EACf,SAAU,QACd,CAAC,EACD,EAAI,UAAU,eAAgB,wBAAwB,EACtD,EAAI,UAAU,yBAA0B,GAAG,EAC3C,EAAI,UAAU,gBAAiB,UAAU,EACzC,EAAI,IAAI,EAAO,YAAY,EAAE,CAAC,IAAI,CACtC,OAAS,EAAO,CACZ,EAAI,WAAa,IACjB,EAAI,IAAI,+BAA+B,OAAO,CAAK,GAAG,CAC1D,CACA,MACJ,CAEA,GAAI,IAAQ,EAAa,CACrB,EAAI,UAAU,eAAgB,kBAAkB,EAChD,EAAI,UAAU,gBAAiB,UAAU,EACzC,EAAI,IAAI,KAAK,UAAU,CAAE,QAAS,MAAO,KAAM,CAAC,CAAE,CAAC,CAAC,EACpD,MACJ,CAEA,EAAK,CACT,CAAC,CACL,CAGG,CACX"}

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

@@ -1 +1 @@
-{"version":3,"file":"tempest-pwa-icons.cjs","names":[],"sources":["../../src/vite/tempest-pwa-icons.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines, function-lines — the plugin generates every icon size,\n * the maskable variants, the favicon and the Apple touch icons from one source\n * image, and wires them into the manifest it also writes. The sizes and the manifest\n * entries are the same list read twice, so they are produced together.\n */\nimport { readFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport type { Plugin } from \"vite\";\nimport type { TempestVitePlugin } from \"./tempest-pwa-manifest\";\n\n/** Options for {@link tempestPwaIcons}. */\nexport interface TempestPwaIconsOptions {\n    /** Source image (SVG or large PNG), relative to the project root. Default `public/icon.svg`. */\n    source?: string;\n    /** Square \"any\"-purpose icon sizes to emit. Default `[192, 512]`. */\n    sizes?: number[];\n    /** Square \"maskable\" icon sizes to emit (with safe-zone padding). Default `[512]`. */\n    maskableSizes?: number[];\n    /** Apple touch icon size, or `false` to skip. Default `180`. */\n    appleTouchIcon?: number | false;\n    /** Output directory for the icon set, under the build root. Default `icons`. */\n    outDir?: string;\n    /** Opaque background for maskable + apple icons (no transparency allowed). Default `#ffffff`. */\n    background?: string;\n    /** Maskable safe-zone padding as a fraction of the icon. Default `0.1` (10% each side). */\n    maskablePadding?: number;\n    /**\n     * Generate Apple splash screens (launch images) and inject the matching\n     * `<link rel=\"apple-touch-startup-image\">` tags. `true` uses a built-in set\n     * of common iPhone/iPad portrait sizes; pass an array to override. Default `false`.\n     */\n    appleSplash?: boolean | AppleSplashSpec[];\n    /** Background color for splash screens. Default: `background`. */\n    splashBackground?: string;\n    /** Icon size on the splash as a fraction of the shorter side. Default `0.3`. */\n    splashIconScale?: number;\n}\n\n/** A single Apple splash target (CSS px + device pixel ratio). */\nexport interface AppleSplashSpec {\n    /** CSS width (device-width in the media query). */\n    width: number;\n    /** CSS height (device-height in the media query). */\n    height: number;\n    /** Device pixel ratio. */\n    ratio: number;\n}\n\n/** Common iPhone/iPad portrait splash sizes (CSS px @ ratio). */\nconst DEFAULT_SPLASH: AppleSplashSpec[] = [\n    { width: 375, height: 667, ratio: 2 }, // iPhone SE / 8\n    { width: 375, height: 812, ratio: 3 }, // iPhone X / 11 Pro\n    { width: 390, height: 844, ratio: 3 }, // iPhone 12 / 13 / 14\n    { width: 393, height: 852, ratio: 3 }, // iPhone 14 Pro / 15\n    { width: 414, height: 896, ratio: 2 }, // iPhone XR / 11\n    { width: 414, height: 896, ratio: 3 }, // iPhone XS Max / 11 Pro Max\n    { width: 428, height: 926, ratio: 3 }, // iPhone 13/14 Pro Max\n    { width: 430, height: 932, ratio: 3 }, // iPhone 15 Pro Max\n    { width: 768, height: 1024, ratio: 2 }, // iPad\n    { width: 834, height: 1194, ratio: 2 }, // iPad Pro 11\"\n    { width: 1024, height: 1366, ratio: 2 }, // iPad Pro 12.9\"\n];\n\nfunction splashFileName(spec: AppleSplashSpec): string {\n    return `splash/apple-splash-${spec.width * spec.ratio}x${spec.height * spec.ratio}.png`;\n}\n\nfunction splashMedia(spec: AppleSplashSpec): string {\n    return (\n        `(device-width: ${spec.width}px) and (device-height: ${spec.height}px) ` +\n        `and (-webkit-device-pixel-ratio: ${spec.ratio}) and (orientation: portrait)`\n    );\n}\n\ninterface Rgb {\n    r: number;\n    g: number;\n    b: number;\n}\n\nfunction hexToRgb(hex: string): Rgb {\n    const value = hex.replace(\"#\", \"\");\n    const full =\n        value.length === 3\n            ? value\n                  .split(\"\")\n                  .map((c) => c + c)\n                  .join(\"\")\n            : value;\n    return {\n        r: parseInt(full.slice(0, 2), 16),\n        g: parseInt(full.slice(2, 4), 16),\n        b: parseInt(full.slice(4, 6), 16),\n    };\n}\n\n/**\n * Build plugin that rasterizes a single source image into a full PWA icon set\n * (regular + maskable + apple-touch-icon), the dependency-free counterpart to\n * `@vite-pwa/assets-generator`. Rendering uses **`sharp`**, imported lazily and\n * treated as optional: if it isn't installed the plugin logs a warning and skips\n * generation (your build still succeeds; the icons just aren't produced).\n *\n * Point your `manifest.webmanifest` icon entries at the emitted files\n * (`/icons/icon-192.png`, `/icons/icon-512.png`, `/icons/maskable-512.png`) and\n * the apple touch icon at `/apple-touch-icon.png`.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestPwaIcons } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *   plugins: [tempestPwaIcons({ source: \"public/icon.svg\" })],\n * });\n */\nexport function tempestPwaIcons(options: TempestPwaIconsOptions = {}): TempestVitePlugin {\n    const {\n        source = \"public/icon.svg\",\n        sizes = [192, 512],\n        maskableSizes = [512],\n        appleTouchIcon = 180,\n        outDir = \"icons\",\n        background = \"#ffffff\",\n        maskablePadding = 0.1,\n        appleSplash = false,\n        splashBackground,\n        splashIconScale = 0.3,\n    } = options;\n\n    const splashSpecs: AppleSplashSpec[] = appleSplash\n        ? Array.isArray(appleSplash)\n            ? appleSplash\n            : DEFAULT_SPLASH\n        : [];\n\n    let root = process.cwd();\n\n    const plugin: Plugin = {\n        name: \"tempest-pwa-icons\",\n        apply: \"build\",\n        configResolved(config) {\n            root = config.root ?? process.cwd();\n        },\n        transformIndexHtml() {\n            if (!splashSpecs.length) return;\n            return splashSpecs.map((spec) => ({\n                tag: \"link\",\n                attrs: {\n                    rel: \"apple-touch-startup-image\",\n                    media: splashMedia(spec),\n                    href: `/${splashFileName(spec)}`,\n                },\n                injectTo: \"head\" as const,\n            }));\n        },\n        async generateBundle() {\n            let sharp: SharpFactory;\n            try {\n                // Non-literal specifier so TS doesn't require `sharp`'s types\n                // (it is an optional, lazily-loaded dependency).\n                const specifier = \"sharp\";\n                const mod = (await import(specifier)) as { default?: SharpFactory } & SharpFactory;\n                sharp = (mod.default ?? mod) as SharpFactory;\n            } catch {\n                this.warn(\n                    \"tempestPwaIcons: `sharp` is not installed — skipping icon generation. \" +\n                        \"Run `npm i -D sharp` to enable it.\",\n                );\n                return;\n            }\n\n            const input = await readFile(resolve(root, source));\n            const bg = hexToRgb(background);\n            const emit = (fileName: string, data: Buffer): void => {\n                this.emitFile({ type: \"asset\", fileName, source: data });\n            };\n\n            // Regular \"any\" icons — transparent background, full bleed.\n            for (const size of sizes) {\n                const png = await sharp(input, { density: Math.max(size, 512) })\n                    .resize(size, size, {\n                        fit: \"contain\",\n                        background: { r: 0, g: 0, b: 0, alpha: 0 },\n                    })\n                    .png()\n                    .toBuffer();\n                emit(`${outDir}/icon-${size}.png`, png);\n            }\n\n            // Maskable icons — content shrunk into the safe zone over a solid bg.\n            for (const size of maskableSizes) {\n                const content = Math.round(size * (1 - maskablePadding * 2));\n                const png = await sharp(input, { density: Math.max(size, 512) })\n                    .resize(content, content, {\n                        fit: \"contain\",\n                        background: { r: 0, g: 0, b: 0, alpha: 0 },\n                    })\n                    .extend({\n                        top: Math.round((size - content) / 2),\n                        bottom: Math.round((size - content) / 2),\n                        left: Math.round((size - content) / 2),\n                        right: Math.round((size - content) / 2),\n                        background: { ...bg, alpha: 1 },\n                    })\n                    .resize(size, size)\n                    .png()\n                    .toBuffer();\n                emit(`${outDir}/maskable-${size}.png`, png);\n            }\n\n            // Apple touch icon — opaque, no alpha.\n            if (appleTouchIcon) {\n                const png = await sharp(input, { density: Math.max(appleTouchIcon, 512) })\n                    .resize(appleTouchIcon, appleTouchIcon, {\n                        fit: \"contain\",\n                        background: { ...bg, alpha: 1 },\n                    })\n                    .flatten({ background: bg })\n                    .png()\n                    .toBuffer();\n                emit(\"apple-touch-icon.png\", png);\n            }\n\n            // Apple splash screens — icon centered on a solid background.\n            if (splashSpecs.length) {\n                const splashBg = hexToRgb(splashBackground ?? background);\n                for (const spec of splashSpecs) {\n                    const w = spec.width * spec.ratio;\n                    const h = spec.height * spec.ratio;\n                    const iconPx = Math.round(Math.min(w, h) * splashIconScale);\n                    const icon = await sharp(input, { density: Math.max(iconPx, 512) })\n                        .resize(iconPx, iconPx, {\n                            fit: \"contain\",\n                            background: { r: 0, g: 0, b: 0, alpha: 0 },\n                        })\n                        .png()\n                        .toBuffer();\n                    const png = await sharp({\n                        create: {\n                            width: w,\n                            height: h,\n                            channels: 4,\n                            background: { ...splashBg, alpha: 1 },\n                        },\n                    })\n                        .composite([{ input: icon, gravity: \"center\" }])\n                        .png()\n                        .toBuffer();\n                    emit(splashFileName(spec), png);\n                }\n            }\n        },\n    };\n\n    return plugin as TempestVitePlugin;\n}\n\n/** Options for the sharp `create` (blank canvas) form. */\ninterface SharpCreate {\n    create: {\n        width: number;\n        height: number;\n        channels: number;\n        background: { r: number; g: number; b: number; alpha: number };\n    };\n}\n\n/** The sharp factory function (minimal typing — sharp is an optional dep). */\ntype SharpFactory = (input: Buffer | SharpCreate, opts?: { density?: number }) => SharpInstance;\n\n/** Minimal subset of the sharp chainable API this plugin uses. */\ninterface SharpInstance {\n    resize(\n        width: number,\n        height: number,\n        opts?: { fit?: string; background?: { r: number; g: number; b: number; alpha: number } },\n    ): SharpInstance;\n    extend(opts: {\n        top: number;\n        bottom: number;\n        left: number;\n        right: number;\n        background: { r: number; g: number; b: number; alpha: number };\n    }): SharpInstance;\n    flatten(opts: { background: Rgb }): SharpInstance;\n    composite(items: { input: Buffer; gravity?: string }[]): SharpInstance;\n    png(): SharpInstance;\n    toBuffer(): Promise<Buffer>;\n}\n"],"mappings":"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"}
+{"version":3,"file":"tempest-pwa-icons.cjs","names":[],"sources":["../../src/vite/tempest-pwa-icons.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines, function-lines — the plugin generates every icon size,\n * the maskable variants, the favicon and the Apple touch icons from one source\n * image, and wires them into the manifest it also writes. The sizes and the manifest\n * entries are the same list read twice, so they are produced together.\n */\nimport { readFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport type { Plugin } from \"vite\";\nimport type { TempestVitePlugin } from \"./tempest-pwa-manifest\";\n\n/** Options for {@link tempestPwaIcons}. */\nexport interface TempestPwaIconsOptions {\n    /** Source image (SVG or large PNG), relative to the project root. Default `public/icon.svg`. */\n    source?: string;\n    /** Square \"any\"-purpose icon sizes to emit. Default `[192, 512]`. */\n    sizes?: number[];\n    /** Square \"maskable\" icon sizes to emit (with safe-zone padding). Default `[512]`. */\n    maskableSizes?: number[];\n    /** Apple touch icon size, or `false` to skip. Default `180`. */\n    appleTouchIcon?: number | false;\n    /** Output directory for the icon set, under the build root. Default `icons`. */\n    outDir?: string;\n    /** Opaque background for maskable + apple icons (no transparency allowed). Default `#ffffff`. */\n    background?: string;\n    /** Maskable safe-zone padding as a fraction of the icon. Default `0.1` (10% each side). */\n    maskablePadding?: number;\n    /**\n     * Generate Apple splash screens (launch images) and inject the matching\n     * `<link rel=\"apple-touch-startup-image\">` tags. `true` uses a built-in set\n     * of common iPhone/iPad portrait sizes; pass an array to override. Default `false`.\n     */\n    appleSplash?: boolean | AppleSplashSpec[];\n    /** Background color for splash screens. Default: `background`. */\n    splashBackground?: string;\n    /** Icon size on the splash as a fraction of the shorter side. Default `0.3`. */\n    splashIconScale?: number;\n}\n\n/** A single Apple splash target (CSS px + device pixel ratio). */\nexport interface AppleSplashSpec {\n    /** CSS width (device-width in the media query). */\n    width: number;\n    /** CSS height (device-height in the media query). */\n    height: number;\n    /** Device pixel ratio. */\n    ratio: number;\n}\n\n/** Common iPhone/iPad portrait splash sizes (CSS px @ ratio). */\nconst DEFAULT_SPLASH: AppleSplashSpec[] = [\n    { width: 375, height: 667, ratio: 2 }, // iPhone SE / 8\n    { width: 375, height: 812, ratio: 3 }, // iPhone X / 11 Pro\n    { width: 390, height: 844, ratio: 3 }, // iPhone 12 / 13 / 14\n    { width: 393, height: 852, ratio: 3 }, // iPhone 14 Pro / 15\n    { width: 414, height: 896, ratio: 2 }, // iPhone XR / 11\n    { width: 414, height: 896, ratio: 3 }, // iPhone XS Max / 11 Pro Max\n    { width: 428, height: 926, ratio: 3 }, // iPhone 13/14 Pro Max\n    { width: 430, height: 932, ratio: 3 }, // iPhone 15 Pro Max\n    { width: 768, height: 1024, ratio: 2 }, // iPad\n    { width: 834, height: 1194, ratio: 2 }, // iPad Pro 11\"\n    { width: 1024, height: 1366, ratio: 2 }, // iPad Pro 12.9\"\n];\n\nfunction splashFileName(spec: AppleSplashSpec): string {\n    return `splash/apple-splash-${spec.width * spec.ratio}x${spec.height * spec.ratio}.png`;\n}\n\nfunction splashMedia(spec: AppleSplashSpec): string {\n    return (\n        `(device-width: ${spec.width}px) and (device-height: ${spec.height}px) ` +\n        `and (-webkit-device-pixel-ratio: ${spec.ratio}) and (orientation: portrait)`\n    );\n}\n\ninterface Rgb {\n    r: number;\n    g: number;\n    b: number;\n}\n\nfunction hexToRgb(hex: string): Rgb {\n    const value = hex.replace(\"#\", \"\");\n    const full =\n        value.length === 3\n            ? value\n                  .split(\"\")\n                  .map((c) => c + c)\n                  .join(\"\")\n            : value;\n    return {\n        r: parseInt(full.slice(0, 2), 16),\n        g: parseInt(full.slice(2, 4), 16),\n        b: parseInt(full.slice(4, 6), 16),\n    };\n}\n\n/**\n * Build plugin that rasterizes a single source image into a full PWA icon set\n * (regular + maskable + apple-touch-icon), the dependency-free counterpart to\n * `@vite-pwa/assets-generator`. Rendering uses **`sharp`**, imported lazily and\n * treated as optional: if it isn't installed the plugin logs a warning and skips\n * generation (your build still succeeds; the icons just aren't produced).\n *\n * Point your `manifest.webmanifest` icon entries at the emitted files\n * (`/icons/icon-192.png`, `/icons/icon-512.png`, `/icons/maskable-512.png`) and\n * the apple touch icon at `/apple-touch-icon.png`.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestPwaIcons } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *   plugins: [tempestPwaIcons({ source: \"public/icon.svg\" })],\n * });\n */\nexport function tempestPwaIcons(options: TempestPwaIconsOptions = {}): TempestVitePlugin {\n    const {\n        source = \"public/icon.svg\",\n        sizes = [192, 512],\n        maskableSizes = [512],\n        appleTouchIcon = 180,\n        outDir = \"icons\",\n        background = \"#ffffff\",\n        maskablePadding = 0.1,\n        appleSplash = false,\n        splashBackground,\n        splashIconScale = 0.3,\n    } = options;\n\n    const splashSpecs: AppleSplashSpec[] = appleSplash\n        ? Array.isArray(appleSplash)\n            ? appleSplash\n            : DEFAULT_SPLASH\n        : [];\n\n    let root = process.cwd();\n\n    const plugin: Plugin = {\n        name: \"tempest-pwa-icons\",\n        apply: \"build\",\n        configResolved(config) {\n            root = config.root ?? process.cwd();\n        },\n        transformIndexHtml() {\n            if (!splashSpecs.length) return;\n            return splashSpecs.map((spec) => ({\n                tag: \"link\",\n                attrs: {\n                    rel: \"apple-touch-startup-image\",\n                    media: splashMedia(spec),\n                    href: `/${splashFileName(spec)}`,\n                },\n                injectTo: \"head\" as const,\n            }));\n        },\n        async generateBundle() {\n            let sharp: SharpFactory;\n            try {\n                // Non-literal specifier so TS doesn't require `sharp`'s types\n                // (it is an optional, lazily-loaded dependency).\n                const specifier = \"sharp\";\n                const mod = (await import(specifier)) as { default?: SharpFactory } & SharpFactory;\n                sharp = (mod.default ?? mod) as SharpFactory;\n            } catch {\n                this.warn(\n                    \"tempestPwaIcons: `sharp` is not installed — skipping icon generation. \" +\n                        \"Run `npm i -D sharp` to enable it.\",\n                );\n                return;\n            }\n\n            const input = await readFile(resolve(root, source));\n            const bg = hexToRgb(background);\n            const emit = (fileName: string, data: Buffer): void => {\n                this.emitFile({ type: \"asset\", fileName, source: data });\n            };\n\n            // Regular \"any\" icons — transparent background, full bleed.\n            for (const size of sizes) {\n                const png = await sharp(input, { density: Math.max(size, 512) })\n                    .resize(size, size, {\n                        fit: \"contain\",\n                        background: { r: 0, g: 0, b: 0, alpha: 0 },\n                    })\n                    .png()\n                    .toBuffer();\n                emit(`${outDir}/icon-${size}.png`, png);\n            }\n\n            // Maskable icons — content shrunk into the safe zone over a solid bg.\n            for (const size of maskableSizes) {\n                const content = Math.round(size * (1 - maskablePadding * 2));\n                const png = await sharp(input, { density: Math.max(size, 512) })\n                    .resize(content, content, {\n                        fit: \"contain\",\n                        background: { r: 0, g: 0, b: 0, alpha: 0 },\n                    })\n                    .extend({\n                        top: Math.round((size - content) / 2),\n                        bottom: Math.round((size - content) / 2),\n                        left: Math.round((size - content) / 2),\n                        right: Math.round((size - content) / 2),\n                        background: { ...bg, alpha: 1 },\n                    })\n                    .resize(size, size)\n                    .png()\n                    .toBuffer();\n                emit(`${outDir}/maskable-${size}.png`, png);\n            }\n\n            // Apple touch icon — opaque, no alpha.\n            if (appleTouchIcon) {\n                const png = await sharp(input, { density: Math.max(appleTouchIcon, 512) })\n                    .resize(appleTouchIcon, appleTouchIcon, {\n                        fit: \"contain\",\n                        background: { ...bg, alpha: 1 },\n                    })\n                    .flatten({ background: bg })\n                    .png()\n                    .toBuffer();\n                emit(\"apple-touch-icon.png\", png);\n            }\n\n            // Apple splash screens — icon centered on a solid background.\n            if (splashSpecs.length) {\n                const splashBg = hexToRgb(splashBackground ?? background);\n                for (const spec of splashSpecs) {\n                    const w = spec.width * spec.ratio;\n                    const h = spec.height * spec.ratio;\n                    const iconPx = Math.round(Math.min(w, h) * splashIconScale);\n                    const icon = await sharp(input, { density: Math.max(iconPx, 512) })\n                        .resize(iconPx, iconPx, {\n                            fit: \"contain\",\n                            background: { r: 0, g: 0, b: 0, alpha: 0 },\n                        })\n                        .png()\n                        .toBuffer();\n                    const png = await sharp({\n                        create: {\n                            width: w,\n                            height: h,\n                            channels: 4,\n                            background: { ...splashBg, alpha: 1 },\n                        },\n                    })\n                        .composite([{ input: icon, gravity: \"center\" }])\n                        .png()\n                        .toBuffer();\n                    emit(splashFileName(spec), png);\n                }\n            }\n        },\n    };\n\n    return plugin as TempestVitePlugin;\n}\n\n/** Options for the sharp `create` (blank canvas) form. */\ninterface SharpCreate {\n    create: {\n        width: number;\n        height: number;\n        channels: number;\n        background: { r: number; g: number; b: number; alpha: number };\n    };\n}\n\n/** The sharp factory function (minimal typing — sharp is an optional dep). */\ntype SharpFactory = (input: Buffer | SharpCreate, opts?: { density?: number }) => SharpInstance;\n\n/** Minimal subset of the sharp chainable API this plugin uses. */\ninterface SharpInstance {\n    resize(\n        width: number,\n        height: number,\n        opts?: { fit?: string; background?: { r: number; g: number; b: number; alpha: number } },\n    ): SharpInstance;\n    extend(opts: {\n        top: number;\n        bottom: number;\n        left: number;\n        right: number;\n        background: { r: number; g: number; b: number; alpha: number };\n    }): SharpInstance;\n    flatten(opts: { background: Rgb }): SharpInstance;\n    composite(items: { input: Buffer; gravity?: string }[]): SharpInstance;\n    png(): SharpInstance;\n    toBuffer(): Promise<Buffer>;\n}\n"],"mappings":"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"}

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

@@ -1,2 +1,2 @@
-const e=require("./create-web-socket.cjs");let t=require("react");function n(e){try{return JSON.parse(e)}catch{return e}}function r(r,i={}){let{enabled:a=!0,protocols:o,maxRetries:s,initialBackoff:c,maxBackoff:l,pingInterval:u,respondToPing:d,queueWhileClosed:f,maxQueuedMessages:p}=i,[m,h]=(0,t.useState)(`idle`),[g,_]=(0,t.useState)(null),v=(0,t.useRef)(null),y=(0,t.useRef)(i);return(0,t.useEffect)(()=>{y.current=i}),(0,t.useEffect)(()=>{if(!a||!r){h(`idle`);return}let t=e.createWebSocket(r,{protocols:y.current.protocols,maxRetries:s,initialBackoff:c,maxBackoff:l,pingInterval:u,pingPayload:y.current.pingPayload,respondToPing:d,pongPayload:y.current.pongPayload,queueWhileClosed:f,maxQueuedMessages:p,parser:e=>(y.current.parser??n)(e),onStatusChange:h,onOpen:e=>y.current.onOpen?.(e),onClose:e=>y.current.onClose?.(e),onError:e=>y.current.onError?.(e),onMessage:e=>{_(e),y.current.onMessage?.(e)}});return v.current=t,()=>{t.close(),v.current=null}},[r,a,Array.isArray(o)?o.join(`,`):o??``,s,c,l,u,d,f,p]),{status:m,lastMessage:g,send:(0,t.useCallback)(e=>v.current?.send(e)??!1,[]),reconnect:(0,t.useCallback)(()=>{v.current?.reconnect()},[])}}exports.useWebSocket=r;
+const e=require("./create-web-socket.cjs");let t=require("react");function n(e){try{return JSON.parse(e)}catch{return e}}function r(r,i={}){let{enabled:a=!0,protocols:o,maxRetries:s,initialBackoff:c,maxBackoff:l,pingInterval:u,respondToPing:d,queueWhileClosed:f,maxQueuedMessages:p}=i,[m,h]=(0,t.useState)(`idle`),[g,_]=(0,t.useState)(null),v=(0,t.useRef)(null),y=(0,t.useRef)(i);(0,t.useEffect)(()=>{y.current=i});let b=Array.isArray(o)?o.join(`,`):o??``;return(0,t.useEffect)(()=>{if(!a||!r){h(`idle`);return}let t=e.createWebSocket(r,{protocols:y.current.protocols,maxRetries:s,initialBackoff:c,maxBackoff:l,pingInterval:u,pingPayload:y.current.pingPayload,respondToPing:d,pongPayload:y.current.pongPayload,queueWhileClosed:f,maxQueuedMessages:p,parser:e=>(y.current.parser??n)(e),onStatusChange:h,onOpen:e=>y.current.onOpen?.(e),onClose:e=>y.current.onClose?.(e),onError:e=>y.current.onError?.(e),onMessage:e=>{_(e),y.current.onMessage?.(e)}});return v.current=t,()=>{t.close(),v.current=null}},[r,a,b,s,c,l,u,d,f,p]),{status:m,lastMessage:g,send:(0,t.useCallback)(e=>v.current?.send(e)??!1,[]),reconnect:(0,t.useCallback)(()=>{v.current?.reconnect()},[])}}exports.useWebSocket=r;
 //# 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    /**\n     * Last decoded frame received.\n     *\n     * A snapshot, not a stream: two frames arriving in the same tick collapse\n     * into a single render and only the later one is ever visible. One server\n     * action often emits several frames in a row, so anything that must see\n     * every message has to use `onMessage`, which fires once per frame. Read\n     * `lastMessage` for \"what is the current state\" rendering only.\n     */\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/** Mirror of `createWebSocket`'s default parser: JSON, raw string on failure. */\nfunction defaultParse<T>(raw: string): T {\n    try {\n        return JSON.parse(raw) as T;\n    } catch {\n        return raw as unknown as T;\n    }\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 *\n * Every callback is read through a ref, so `onOpen` / `onMessage` / `onClose` /\n * `onError` always run the latest closure — an inline arrow function is fine\n * and never reopens the socket. Connection-shaping options (`protocols`,\n * `maxRetries`, `initialBackoff`, `maxBackoff`, `pingInterval`,\n * `queueWhileClosed`) are baked into the connection, so changing one reopens\n * it with the new value rather than being silently ignored.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Status, last frame, and the `send` / `reconnect` controls.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const {\n        enabled = true,\n        protocols,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n    } = 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 optionsRef = useRef(options);\n    useEffect(() => {\n        optionsRef.current = options;\n    });\n\n    const protocolsKey = Array.isArray(protocols) ? protocols.join(\",\") : (protocols ?? \"\");\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createWebSocket<T>(url, {\n            protocols: optionsRef.current.protocols,\n            maxRetries,\n            initialBackoff,\n            maxBackoff,\n            pingInterval,\n            pingPayload: optionsRef.current.pingPayload,\n            respondToPing,\n            pongPayload: optionsRef.current.pongPayload,\n            queueWhileClosed,\n            maxQueuedMessages,\n            parser: (raw) => (optionsRef.current.parser ?? defaultParse<T>)(raw),\n            onStatusChange: setStatus,\n            onOpen: (event) => optionsRef.current.onOpen?.(event),\n            onClose: (event) => optionsRef.current.onClose?.(event),\n            onError: (event) => optionsRef.current.onError?.(event),\n            onMessage: (message) => {\n                setLastMessage(message);\n                optionsRef.current.onMessage?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n    }, [\n        url,\n        enabled,\n        protocolsKey,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n    ]);\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":"kEAiCA,SAAS,EAAgB,EAAgB,CACrC,GAAI,CACA,OAAO,KAAK,MAAM,CAAG,CACzB,MAAQ,CACJ,OAAO,CACX,CACJ,CAiBA,SAAgB,EACZ,EACA,EAAkC,CAAC,EACd,CACrB,GAAM,CACF,UAAU,GACV,YACA,aACA,iBACA,aACA,eACA,gBACA,mBACA,qBACA,EACE,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,CAAoB,CAAO,EA6DjC,OA5DA,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAW,QAAU,CACzB,CAAC,GAID,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,CAAC,GAAW,CAAC,EAAK,CAClB,EAAU,MAAM,EAChB,MACJ,CAEA,IAAM,EAAa,EAAA,gBAAmB,EAAK,CACvC,UAAW,EAAW,QAAQ,UAC9B,aACA,iBACA,aACA,eACA,YAAa,EAAW,QAAQ,YAChC,gBACA,YAAa,EAAW,QAAQ,YAChC,mBACA,oBACA,OAAS,IAAS,EAAW,QAAQ,QAAU,EAAA,CAAiB,CAAG,EACnE,eAAgB,EAChB,OAAS,GAAU,EAAW,QAAQ,SAAS,CAAK,EACpD,QAAU,GAAU,EAAW,QAAQ,UAAU,CAAK,EACtD,QAAU,GAAU,EAAW,QAAQ,UAAU,CAAK,EACtD,UAAY,GAAY,CACpB,EAAe,CAAO,EACtB,EAAW,QAAQ,YAAY,CAAO,CAC1C,CACJ,CAAC,EAGD,MAFA,GAAc,QAAU,MAEX,CACT,EAAW,MAAM,EACjB,EAAc,QAAU,IAC5B,CACJ,EAAG,CACC,EACA,EArCiB,MAAM,QAAQ,CAAS,EAAI,EAAU,KAAK,GAAG,EAAK,GAAa,GAuChF,EACA,EACA,EACA,EACA,EACA,EACA,CACJ,CAAC,EAUM,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    /**\n     * Last decoded frame received.\n     *\n     * A snapshot, not a stream: two frames arriving in the same tick collapse\n     * into a single render and only the later one is ever visible. One server\n     * action often emits several frames in a row, so anything that must see\n     * every message has to use `onMessage`, which fires once per frame. Read\n     * `lastMessage` for \"what is the current state\" rendering only.\n     */\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/** Mirror of `createWebSocket`'s default parser: JSON, raw string on failure. */\nfunction defaultParse<T>(raw: string): T {\n    try {\n        return JSON.parse(raw) as T;\n    } catch {\n        return raw as unknown as T;\n    }\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 *\n * Every callback is read through a ref, so `onOpen` / `onMessage` / `onClose` /\n * `onError` always run the latest closure — an inline arrow function is fine\n * and never reopens the socket. Connection-shaping options (`protocols`,\n * `maxRetries`, `initialBackoff`, `maxBackoff`, `pingInterval`,\n * `queueWhileClosed`) are baked into the connection, so changing one reopens\n * it with the new value rather than being silently ignored.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Status, last frame, and the `send` / `reconnect` controls.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const {\n        enabled = true,\n        protocols,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n    } = 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 optionsRef = useRef(options);\n    useEffect(() => {\n        optionsRef.current = options;\n    });\n\n    const protocolsKey = Array.isArray(protocols) ? protocols.join(\",\") : (protocols ?? \"\");\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createWebSocket<T>(url, {\n            protocols: optionsRef.current.protocols,\n            maxRetries,\n            initialBackoff,\n            maxBackoff,\n            pingInterval,\n            pingPayload: optionsRef.current.pingPayload,\n            respondToPing,\n            pongPayload: optionsRef.current.pongPayload,\n            queueWhileClosed,\n            maxQueuedMessages,\n            parser: (raw) => (optionsRef.current.parser ?? defaultParse<T>)(raw),\n            onStatusChange: setStatus,\n            onOpen: (event) => optionsRef.current.onOpen?.(event),\n            onClose: (event) => optionsRef.current.onClose?.(event),\n            onError: (event) => optionsRef.current.onError?.(event),\n            onMessage: (message) => {\n                setLastMessage(message);\n                optionsRef.current.onMessage?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n    }, [\n        url,\n        enabled,\n        protocolsKey,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n    ]);\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":"kEAiCA,SAAS,EAAgB,EAAgB,CACrC,GAAI,CACA,OAAO,KAAK,MAAM,CAAG,CACzB,MAAQ,CACJ,OAAO,CACX,CACJ,CAiBA,SAAgB,EACZ,EACA,EAAkC,CAAC,EACd,CACrB,GAAM,CACF,UAAU,GACV,YACA,aACA,iBACA,aACA,eACA,gBACA,mBACA,qBACA,EACE,CAAC,EAAQ,IAAA,EAAa,EAAA,SAAA,CAA0B,MAAM,EACtD,CAAC,EAAa,IAAA,EAAkB,EAAA,SAAA,CAAqC,IAAI,EACzE,GAAA,EAAgB,EAAA,OAAA,CAAmC,IAAI,EAEvD,GAAA,EAAa,EAAA,OAAA,CAAO,CAAO,GACjC,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAW,QAAU,CACzB,CAAC,EAED,IAAM,EAAe,MAAM,QAAQ,CAAS,EAAI,EAAU,KAAK,GAAG,EAAK,GAAa,GAwDpF,OAtDA,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,CAAC,GAAW,CAAC,EAAK,CAClB,EAAU,MAAM,EAChB,MACJ,CAEA,IAAM,EAAa,EAAA,gBAAmB,EAAK,CACvC,UAAW,EAAW,QAAQ,UAC9B,aACA,iBACA,aACA,eACA,YAAa,EAAW,QAAQ,YAChC,gBACA,YAAa,EAAW,QAAQ,YAChC,mBACA,oBACA,OAAS,IAAS,EAAW,QAAQ,QAAU,EAAA,CAAiB,CAAG,EACnE,eAAgB,EAChB,OAAS,GAAU,EAAW,QAAQ,SAAS,CAAK,EACpD,QAAU,GAAU,EAAW,QAAQ,UAAU,CAAK,EACtD,QAAU,GAAU,EAAW,QAAQ,UAAU,CAAK,EACtD,UAAY,GAAY,CACpB,EAAe,CAAO,EACtB,EAAW,QAAQ,YAAY,CAAO,CAC1C,CACJ,CAAC,EAGD,MAFA,GAAc,QAAU,MAEX,CACT,EAAW,MAAM,EACjB,EAAc,QAAU,IAC5B,CACJ,EAAG,CACC,EACA,EACA,EACA,EACA,EACA,EACA,EACA,EACA,EACA,CACJ,CAAC,EAUM,CAAE,SAAQ,cAAa,MAAA,EARjB,EAAA,YAAA,CAAa,GACf,EAAc,SAAS,KAAK,CAAO,GAAK,GAChD,CAAC,CAM0B,EAAM,WAAA,EAJlB,EAAA,YAAA,KAAwB,CACtC,EAAc,SAAS,UAAU,CACrC,EAAG,CAAC,CAEgC,CAAU,CAClD"}

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

@@ -10,9 +10,11 @@ function a(e) {
 }
 function o(o, s = {}) {
 	let { enabled: c = !0, protocols: l, maxRetries: u, initialBackoff: d, maxBackoff: f, pingInterval: p, respondToPing: m, queueWhileClosed: h, maxQueuedMessages: g } = s, [_, v] = i("idle"), [y, b] = i(null), x = r(null), S = r(s);
-	return n(() => {
+	n(() => {
 		S.current = s;
-	}), n(() => {
+	});
+	let C = Array.isArray(l) ? l.join(",") : l ?? "";
+	return n(() => {
 		if (!c || !o) {
 			v("idle");
 			return;
@@ -43,7 +45,7 @@ function o(o, s = {}) {
 	}, [
 		o,
 		c,
-		Array.isArray(l) ? l.join(",") : l ?? "",
+		C,
 		u,
 		d,
 		f,

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    /**\n     * Last decoded frame received.\n     *\n     * A snapshot, not a stream: two frames arriving in the same tick collapse\n     * into a single render and only the later one is ever visible. One server\n     * action often emits several frames in a row, so anything that must see\n     * every message has to use `onMessage`, which fires once per frame. Read\n     * `lastMessage` for \"what is the current state\" rendering only.\n     */\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/** Mirror of `createWebSocket`'s default parser: JSON, raw string on failure. */\nfunction defaultParse<T>(raw: string): T {\n    try {\n        return JSON.parse(raw) as T;\n    } catch {\n        return raw as unknown as T;\n    }\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 *\n * Every callback is read through a ref, so `onOpen` / `onMessage` / `onClose` /\n * `onError` always run the latest closure — an inline arrow function is fine\n * and never reopens the socket. Connection-shaping options (`protocols`,\n * `maxRetries`, `initialBackoff`, `maxBackoff`, `pingInterval`,\n * `queueWhileClosed`) are baked into the connection, so changing one reopens\n * it with the new value rather than being silently ignored.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Status, last frame, and the `send` / `reconnect` controls.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const {\n        enabled = true,\n        protocols,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n    } = 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 optionsRef = useRef(options);\n    useEffect(() => {\n        optionsRef.current = options;\n    });\n\n    const protocolsKey = Array.isArray(protocols) ? protocols.join(\",\") : (protocols ?? \"\");\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createWebSocket<T>(url, {\n            protocols: optionsRef.current.protocols,\n            maxRetries,\n            initialBackoff,\n            maxBackoff,\n            pingInterval,\n            pingPayload: optionsRef.current.pingPayload,\n            respondToPing,\n            pongPayload: optionsRef.current.pongPayload,\n            queueWhileClosed,\n            maxQueuedMessages,\n            parser: (raw) => (optionsRef.current.parser ?? defaultParse<T>)(raw),\n            onStatusChange: setStatus,\n            onOpen: (event) => optionsRef.current.onOpen?.(event),\n            onClose: (event) => optionsRef.current.onClose?.(event),\n            onError: (event) => optionsRef.current.onError?.(event),\n            onMessage: (message) => {\n                setLastMessage(message);\n                optionsRef.current.onMessage?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n    }, [\n        url,\n        enabled,\n        protocolsKey,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n    ]);\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":";;;AAiCA,SAAS,EAAgB,GAAgB;CACrC,IAAI;EACA,OAAO,KAAK,MAAM,CAAG;CACzB,QAAQ;EACJ,OAAO;CACX;AACJ;AAiBA,SAAgB,EACZ,GACA,IAAkC,CAAC,GACd;CACrB,IAAM,EACF,aAAU,IACV,cACA,eACA,mBACA,eACA,iBACA,kBACA,qBACA,yBACA,GACE,CAAC,GAAQ,KAAa,EAA0B,MAAM,GACtD,CAAC,GAAa,KAAkB,EAAqC,IAAI,GACzE,IAAgB,EAAmC,IAAI,GAEvD,IAAa,EAAO,CAAO;CA6DjC,OA5DA,QAAgB;EACZ,EAAW,UAAU;CACzB,CAAC,GAID,QAAgB;EACZ,IAAI,CAAC,KAAW,CAAC,GAAK;GAClB,EAAU,MAAM;GAChB;EACJ;EAEA,IAAM,IAAa,EAAmB,GAAK;GACvC,WAAW,EAAW,QAAQ;GAC9B;GACA;GACA;GACA;GACA,aAAa,EAAW,QAAQ;GAChC;GACA,aAAa,EAAW,QAAQ;GAChC;GACA;GACA,SAAS,OAAS,EAAW,QAAQ,UAAU,EAAA,CAAiB,CAAG;GACnE,gBAAgB;GAChB,SAAS,MAAU,EAAW,QAAQ,SAAS,CAAK;GACpD,UAAU,MAAU,EAAW,QAAQ,UAAU,CAAK;GACtD,UAAU,MAAU,EAAW,QAAQ,UAAU,CAAK;GACtD,YAAY,MAAY;IAEpB,AADA,EAAe,CAAO,GACtB,EAAW,QAAQ,YAAY,CAAO;GAC1C;EACJ,CAAC;EAGD,OAFA,EAAc,UAAU,SAEX;GAET,AADA,EAAW,MAAM,GACjB,EAAc,UAAU;EAC5B;CACJ,GAAG;EACC;EACA;EArCiB,MAAM,QAAQ,CAAS,IAAI,EAAU,KAAK,GAAG,IAAK,KAAa;EAuChF;EACA;EACA;EACA;EACA;EACA;EACA;CACJ,CAAC,GAUM;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    /**\n     * Last decoded frame received.\n     *\n     * A snapshot, not a stream: two frames arriving in the same tick collapse\n     * into a single render and only the later one is ever visible. One server\n     * action often emits several frames in a row, so anything that must see\n     * every message has to use `onMessage`, which fires once per frame. Read\n     * `lastMessage` for \"what is the current state\" rendering only.\n     */\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/** Mirror of `createWebSocket`'s default parser: JSON, raw string on failure. */\nfunction defaultParse<T>(raw: string): T {\n    try {\n        return JSON.parse(raw) as T;\n    } catch {\n        return raw as unknown as T;\n    }\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 *\n * Every callback is read through a ref, so `onOpen` / `onMessage` / `onClose` /\n * `onError` always run the latest closure — an inline arrow function is fine\n * and never reopens the socket. Connection-shaping options (`protocols`,\n * `maxRetries`, `initialBackoff`, `maxBackoff`, `pingInterval`,\n * `queueWhileClosed`) are baked into the connection, so changing one reopens\n * it with the new value rather than being silently ignored.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Status, last frame, and the `send` / `reconnect` controls.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const {\n        enabled = true,\n        protocols,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n    } = 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 optionsRef = useRef(options);\n    useEffect(() => {\n        optionsRef.current = options;\n    });\n\n    const protocolsKey = Array.isArray(protocols) ? protocols.join(\",\") : (protocols ?? \"\");\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createWebSocket<T>(url, {\n            protocols: optionsRef.current.protocols,\n            maxRetries,\n            initialBackoff,\n            maxBackoff,\n            pingInterval,\n            pingPayload: optionsRef.current.pingPayload,\n            respondToPing,\n            pongPayload: optionsRef.current.pongPayload,\n            queueWhileClosed,\n            maxQueuedMessages,\n            parser: (raw) => (optionsRef.current.parser ?? defaultParse<T>)(raw),\n            onStatusChange: setStatus,\n            onOpen: (event) => optionsRef.current.onOpen?.(event),\n            onClose: (event) => optionsRef.current.onClose?.(event),\n            onError: (event) => optionsRef.current.onError?.(event),\n            onMessage: (message) => {\n                setLastMessage(message);\n                optionsRef.current.onMessage?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n    }, [\n        url,\n        enabled,\n        protocolsKey,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n    ]);\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":";;;AAiCA,SAAS,EAAgB,GAAgB;CACrC,IAAI;EACA,OAAO,KAAK,MAAM,CAAG;CACzB,QAAQ;EACJ,OAAO;CACX;AACJ;AAiBA,SAAgB,EACZ,GACA,IAAkC,CAAC,GACd;CACrB,IAAM,EACF,aAAU,IACV,cACA,eACA,mBACA,eACA,iBACA,kBACA,qBACA,yBACA,GACE,CAAC,GAAQ,KAAa,EAA0B,MAAM,GACtD,CAAC,GAAa,KAAkB,EAAqC,IAAI,GACzE,IAAgB,EAAmC,IAAI,GAEvD,IAAa,EAAO,CAAO;CACjC,QAAgB;EACZ,EAAW,UAAU;CACzB,CAAC;CAED,IAAM,IAAe,MAAM,QAAQ,CAAS,IAAI,EAAU,KAAK,GAAG,IAAK,KAAa;CAwDpF,OAtDA,QAAgB;EACZ,IAAI,CAAC,KAAW,CAAC,GAAK;GAClB,EAAU,MAAM;GAChB;EACJ;EAEA,IAAM,IAAa,EAAmB,GAAK;GACvC,WAAW,EAAW,QAAQ;GAC9B;GACA;GACA;GACA;GACA,aAAa,EAAW,QAAQ;GAChC;GACA,aAAa,EAAW,QAAQ;GAChC;GACA;GACA,SAAS,OAAS,EAAW,QAAQ,UAAU,EAAA,CAAiB,CAAG;GACnE,gBAAgB;GAChB,SAAS,MAAU,EAAW,QAAQ,SAAS,CAAK;GACpD,UAAU,MAAU,EAAW,QAAQ,UAAU,CAAK;GACtD,UAAU,MAAU,EAAW,QAAQ,UAAU,CAAK;GACtD,YAAY,MAAY;IAEpB,AADA,EAAe,CAAO,GACtB,EAAW,QAAQ,YAAY,CAAO;GAC1C;EACJ,CAAC;EAGD,OAFA,EAAc,UAAU,SAEX;GAET,AADA,EAAW,MAAM,GACjB,EAAc,UAAU;EAC5B;CACJ,GAAG;EACC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACJ,CAAC,GAUM;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.39.0",
+  "version": "0.40.0",
   "description": "SDK público da Tempest com componentes, hooks e integrações para projetos React.",
   "type": "module",
   "license": "MIT",
@@ -198,7 +198,7 @@
     "eslint": "^10.8.0",
     "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-react-refresh": "^0.5.3",
-    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-simple-import-sort": "^14.0.0",
     "eslint-plugin-unused-imports": "^4.4.1",
     "fake-indexeddb": "^6.2.5",
     "globals": "^17.7.0",

package/template/package.json

@@ -27,7 +27,7 @@
     "eslint": "^10.8.0",
     "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-react-refresh": "^0.5.3",
-    "eslint-plugin-simple-import-sort": "^12.1.0",
+    "eslint-plugin-simple-import-sort": "^14.0.0",
     "eslint-plugin-unused-imports": "^4.4.1",
     "globals": "^17.7.0",
     "prettier": "^3.9.6",