tempest-react-sdk 0.22.0 → 0.23.0

package/dist/vite.js

@@ -1,265 +1,11 @@
-import { resolve as k } from "node:path";
-import { defineConfig as z } from "vite";
-import B from "@vitejs/plugin-react";
-import { readFile as P } from "node:fs/promises";
-function H(t) {
-  const e = {};
-  for (const [o, a] of Object.entries(t))
-    e[o] = typeof a == "string" ? { target: a, changeOrigin: !0 } : a;
-  return e;
-}
-function N(t = {}) {
-  const {
-    srcDir: e = "src",
-    port: o = 5173,
-    host: a = "127.0.0.1",
-    open: h = !1,
-    proxy: s,
-    alias: d = {},
-    plugins: f = [],
-    overrides: u = {}
-  } = t, r = u, c = {
-    plugins: [B(), ...f],
-    resolve: {
-      alias: {
-        "@": k(process.cwd(), e),
-        ...d
-      }
-    },
-    server: {
-      port: o,
-      host: a,
-      open: h,
-      ...s ? { proxy: H(s) } : {}
-    }
-  }, l = {
-    ...c,
-    ...r,
-    plugins: [...c.plugins ?? [], ...r.plugins ?? []],
-    resolve: { ...c.resolve, ...r.resolve },
-    server: { ...c.server, ...r.server }
-  };
-  return z(l);
-}
-function I(t, e) {
-  return `${t.endsWith("/") ? t : `${t}/`}${e}`.replace(/([^:]\/)\/+/g, "$1");
-}
-function A(t) {
-  let e = 5381;
-  for (let o = 0; o < t.length; o++)
-    e = (e << 5) + e + t.charCodeAt(o) >>> 0;
-  return e.toString(16);
-}
-function U(t = {}) {
-  const {
-    fileName: e = "precache-manifest.json",
-    additionalUrls: o = [],
-    exclude: a = /\.map$/,
-    includeHtml: h = !0,
-    appShell: s = "/index.html"
-  } = t;
-  let d = "/";
-  return {
-    name: "tempest-pwa-manifest",
-    apply: "build",
-    configResolved(u) {
-      d = u.base ?? "/";
-    },
-    generateBundle(u, r) {
-      const c = new Set(o);
-      s && c.add(s);
-      for (const m of Object.keys(r))
-        m !== e && (a.test(m) || !h && m.endsWith(".html") || c.add(I(d, m)));
-      const l = [...c].sort(), g = A(l.join(`
-`));
-      this.emitFile({
-        type: "asset",
-        fileName: e,
-        source: JSON.stringify({ version: g, urls: l })
-      });
-    }
-  };
-}
-const D = [
-  { width: 375, height: 667, ratio: 2 },
-  // iPhone SE / 8
-  { width: 375, height: 812, ratio: 3 },
-  // iPhone X / 11 Pro
-  { width: 390, height: 844, ratio: 3 },
-  // iPhone 12 / 13 / 14
-  { width: 393, height: 852, ratio: 3 },
-  // iPhone 14 Pro / 15
-  { width: 414, height: 896, ratio: 2 },
-  // iPhone XR / 11
-  { width: 414, height: 896, ratio: 3 },
-  // iPhone XS Max / 11 Pro Max
-  { width: 428, height: 926, ratio: 3 },
-  // iPhone 13/14 Pro Max
-  { width: 430, height: 932, ratio: 3 },
-  // iPhone 15 Pro Max
-  { width: 768, height: 1024, ratio: 2 },
-  // iPad
-  { width: 834, height: 1194, ratio: 2 },
-  // iPad Pro 11"
-  { width: 1024, height: 1366, ratio: 2 }
-  // iPad Pro 12.9"
-];
-function $(t) {
-  return `splash/apple-splash-${t.width * t.ratio}x${t.height * t.ratio}.png`;
-}
-function F(t) {
-  return `(device-width: ${t.width}px) and (device-height: ${t.height}px) and (-webkit-device-pixel-ratio: ${t.ratio}) and (orientation: portrait)`;
-}
-function M(t) {
-  const e = t.replace("#", ""), o = e.length === 3 ? e.split("").map((a) => a + a).join("") : e;
-  return {
-    r: parseInt(o.slice(0, 2), 16),
-    g: parseInt(o.slice(2, 4), 16),
-    b: parseInt(o.slice(4, 6), 16)
-  };
-}
-function L(t = {}) {
-  const {
-    source: e = "public/icon.svg",
-    sizes: o = [192, 512],
-    maskableSizes: a = [512],
-    appleTouchIcon: h = 180,
-    outDir: s = "icons",
-    background: d = "#ffffff",
-    maskablePadding: f = 0.1,
-    appleSplash: u = !1,
-    splashBackground: r,
-    splashIconScale: c = 0.3
-  } = t, l = u ? Array.isArray(u) ? u : D : [];
-  let g = process.cwd();
-  return {
-    name: "tempest-pwa-icons",
-    apply: "build",
-    configResolved(p) {
-      g = p.root ?? process.cwd();
-    },
-    transformIndexHtml() {
-      if (l.length)
-        return l.map((p) => ({
-          tag: "link",
-          attrs: {
-            rel: "apple-touch-startup-image",
-            media: F(p),
-            href: `/${$(p)}`
-          },
-          injectTo: "head"
-        }));
-    },
-    async generateBundle() {
-      let p;
-      try {
-        const i = await import("sharp");
-        p = i.default ?? i;
-      } catch {
-        this.warn(
-          "tempestPwaIcons: `sharp` is not installed — skipping icon generation. Run `npm i -D sharp` to enable it."
-        );
-        return;
-      }
-      const w = await P(k(g, e)), y = M(d), b = (n, i) => {
-        this.emitFile({ type: "asset", fileName: n, source: i });
-      };
-      for (const n of o) {
-        const i = await p(w, { density: Math.max(n, 512) }).resize(n, n, {
-          fit: "contain",
-          background: { r: 0, g: 0, b: 0, alpha: 0 }
-        }).png().toBuffer();
-        b(`${s}/icon-${n}.png`, i);
-      }
-      for (const n of a) {
-        const i = Math.round(n * (1 - f * 2)), v = await p(w, { density: Math.max(n, 512) }).resize(i, i, {
-          fit: "contain",
-          background: { r: 0, g: 0, b: 0, alpha: 0 }
-        }).extend({
-          top: Math.round((n - i) / 2),
-          bottom: Math.round((n - i) / 2),
-          left: Math.round((n - i) / 2),
-          right: Math.round((n - i) / 2),
-          background: { ...y, alpha: 1 }
-        }).resize(n, n).png().toBuffer();
-        b(`${s}/maskable-${n}.png`, v);
-      }
-      if (h) {
-        const n = await p(w, { density: Math.max(h, 512) }).resize(h, h, {
-          fit: "contain",
-          background: { ...y, alpha: 1 }
-        }).flatten({ background: y }).png().toBuffer();
-        b("apple-touch-icon.png", n);
-      }
-      if (l.length) {
-        const n = M(r ?? d);
-        for (const i of l) {
-          const v = i.width * i.ratio, S = i.height * i.ratio, x = Math.round(Math.min(v, S) * c), j = await p(w, { density: Math.max(x, 512) }).resize(x, x, {
-            fit: "contain",
-            background: { r: 0, g: 0, b: 0, alpha: 0 }
-          }).png().toBuffer(), C = await p({
-            create: {
-              width: v,
-              height: S,
-              channels: 4,
-              background: { ...n, alpha: 1 }
-            }
-          }).composite([{ input: j, gravity: "center" }]).png().toBuffer();
-          b($(i), C);
-        }
-      }
-    }
-  };
-}
-function J(t = {}) {
-  const {
-    swSrc: e = "src/sw.ts",
-    swUrl: o = "/sw.js",
-    manifestUrl: a = "/precache-manifest.json",
-    enabled: h = !0
-  } = t;
-  let s = process.cwd();
-  return {
-    name: "tempest-pwa-dev-sw",
-    apply: "serve",
-    configResolved(f) {
-      s = f.root ?? process.cwd();
-    },
-    configureServer(f) {
-      h && f.middlewares.use(async (u, r, c) => {
-        const l = (u.url ?? "").split("?")[0];
-        if (l === o) {
-          try {
-            const m = await (await import("esbuild")).build({
-              entryPoints: [k(s, e)],
-              bundle: !0,
-              format: "iife",
-              platform: "browser",
-              target: "es2020",
-              write: !1,
-              absWorkingDir: s,
-              logLevel: "silent"
-            });
-            r.setHeader("Content-Type", "application/javascript"), r.setHeader("Service-Worker-Allowed", "/"), r.setHeader("Cache-Control", "no-cache"), r.end(m.outputFiles[0].text);
-          } catch (g) {
-            r.statusCode = 500, r.end(`// SW dev build failed:
-// ${String(g)}`);
-          }
-          return;
-        }
-        if (l === a) {
-          r.setHeader("Content-Type", "application/json"), r.setHeader("Cache-Control", "no-cache"), r.end(JSON.stringify({ version: "dev", urls: [] }));
-          return;
-        }
-        c();
-      });
-    }
-  };
-}
+import { createViteConfig as o } from "./vite/create-vite-config.js";
+import { tempestPwaManifest as m } from "./vite/tempest-pwa-manifest.js";
+import { tempestPwaIcons as f } from "./vite/tempest-pwa-icons.js";
+import { tempestPwaDevSw as s } from "./vite/tempest-pwa-dev-sw.js";
 export {
-  N as createViteConfig,
-  J as tempestPwaDevSw,
-  L as tempestPwaIcons,
-  U as tempestPwaManifest
+  o as createViteConfig,
+  s as tempestPwaDevSw,
+  f as tempestPwaIcons,
+  m as tempestPwaManifest
 };
 //# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite.js","sources":["../src/vite/create-vite-config.ts","../src/vite/tempest-pwa-manifest.ts","../src/vite/tempest-pwa-icons.ts","../src/vite/tempest-pwa-dev-sw.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","import type { Plugin } from \"vite\";\n\n/**\n * A Vite plugin object. Typed loosely so the SDK's published declarations stay\n * free of `vite`'s internal types (which the `.d.ts` rollup can't analyze);\n * assign the result straight into a `plugins: [...]` array.\n */\nexport type TempestVitePlugin = { name: string } & Record<string, unknown>;\n\n/** Options for {@link tempestPwaManifest}. */\nexport interface TempestPwaManifestOptions {\n    /** Output file name (under the build root). Default `precache-manifest.json`. */\n    fileName?: string;\n    /**\n     * Extra URLs to precache that Vite doesn't emit into the bundle — typically\n     * `public/` assets like the web manifest and icons. Default `[]`.\n     */\n    additionalUrls?: string[];\n    /** Emitted files matching this are skipped. Default `/\\.map$/` (source maps). */\n    exclude?: RegExp;\n    /** Include emitted `.html` documents (the app shell). Default `true`. */\n    includeHtml?: boolean;\n    /**\n     * App-shell document always added to the manifest, even if Vite emits it\n     * after this plugin runs. Must match `installPrecache`'s `navigateFallback`\n     * so offline navigations resolve. Pass `false` to disable. Default `/index.html`.\n     */\n    appShell?: string | false;\n}\n\nfunction joinBase(base: string, file: string): string {\n    const prefix = base.endsWith(\"/\") ? base : `${base}/`;\n    return `${prefix}${file}`.replace(/([^:]\\/)\\/+/g, \"$1\");\n}\n\n/** Deterministic djb2 hash → hex. Stable across rebuilds with the same assets. */\nfunction hash(input: string): string {\n    let h = 5381;\n    for (let i = 0; i < input.length; i++) {\n        h = ((h << 5) + h + input.charCodeAt(i)) >>> 0;\n    }\n    return h.toString(16);\n}\n\n/**\n * Vite build plugin that emits a `precache-manifest.json` listing every built\n * asset (plus any `additionalUrls`) as root-absolute URLs, with a content-based\n * `version`. It is the dependency-free counterpart to Workbox's `__WB_MANIFEST`:\n * `installPrecache` (from `tempest-react-sdk/sw`) reads this file at the service\n * worker's `install` event to cache the app shell for offline use.\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig, tempestPwaManifest } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *   plugins: [tempestPwaManifest({ additionalUrls: [\"/manifest.webmanifest\", \"/icon.svg\"] })],\n * });\n */\nexport function tempestPwaManifest(options: TempestPwaManifestOptions = {}): TempestVitePlugin {\n    const {\n        fileName = \"precache-manifest.json\",\n        additionalUrls = [],\n        exclude = /\\.map$/,\n        includeHtml = true,\n        appShell = \"/index.html\",\n    } = options;\n\n    let base = \"/\";\n\n    const plugin: Plugin = {\n        name: \"tempest-pwa-manifest\",\n        apply: \"build\",\n        configResolved(config) {\n            base = config.base ?? \"/\";\n        },\n        generateBundle(_outputOptions, bundle) {\n            const urls = new Set<string>(additionalUrls);\n            // Vite may emit index.html after this hook, so guarantee the shell.\n            if (appShell) urls.add(appShell);\n            for (const file of Object.keys(bundle)) {\n                if (file === fileName) continue;\n                if (exclude.test(file)) continue;\n                if (!includeHtml && file.endsWith(\".html\")) continue;\n                urls.add(joinBase(base, file));\n            }\n\n            const list = [...urls].sort();\n            const version = hash(list.join(\"\\n\"));\n            this.emitFile({\n                type: \"asset\",\n                fileName,\n                source: JSON.stringify({ version, urls: list }),\n            });\n        },\n    };\n\n    return plugin as TempestVitePlugin;\n}\n","import { 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","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"],"names":["normalizeProxy","proxy","out","path","value","createViteConfig","options","srcDir","port","host","open","alias","plugins","overrides","overridesConfig","base","react","resolve","merged","defineConfig","joinBase","file","hash","input","h","i","tempestPwaManifest","fileName","additionalUrls","exclude","includeHtml","appShell","config","_outputOptions","bundle","urls","list","version","DEFAULT_SPLASH","splashFileName","spec","splashMedia","hexToRgb","hex","full","c","tempestPwaIcons","source","sizes","maskableSizes","appleTouchIcon","outDir","background","maskablePadding","appleSplash","splashBackground","splashIconScale","splashSpecs","root","sharp","mod","readFile","bg","emit","data","size","png","content","splashBg","w","iconPx","icon","tempestPwaDevSw","swSrc","swUrl","manifestUrl","enabled","server","req","res","next","url","result","error"],"mappings":"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"}
+{"version":3,"file":"vite.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

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

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function B(a){try{return JSON.parse(a)}catch{return a}}function J(a,g={}){const{protocols:p,maxRetries:S=10,initialBackoff:m=1e3,maxBackoff:y=3e4,pingInterval:i=0,pingPayload:k=JSON.stringify({type:"ping"}),parser:b=B,onOpen:P,onMessage:O,onClose:T,onError:W,onStatusChange:h}=g;let e=null,r=null,s=null,o=0,u="idle",c=!1;function l(n){u!==n&&(u=n,h?.(n))}function f(){s&&(clearInterval(s),s=null)}function w(){!i||i<=0||(f(),s=setInterval(()=>{e?.readyState===WebSocket.OPEN&&e.send(k)},i))}function N(){if(c)return;if(o>=S){l("error");return}const n=Math.min(m*2**o,y);o+=1,r=setTimeout(d,n)}function d(){if(c)return;e&&(e.onopen=null,e.onmessage=null,e.onclose=null,e.onerror=null,e.close()),l("connecting");const n=new WebSocket(a,p);e=n,n.onopen=t=>{o=0,l("open"),w(),P?.(t)},n.onmessage=t=>{const M=typeof t.data=="string"?t.data:"";O?.({data:b(M),raw:t})},n.onerror=t=>{W?.(t)},n.onclose=t=>{f(),T?.(t),e=null,l("closed"),!c&&!t.wasClean&&N()}}function C(n){return e?.readyState!==WebSocket.OPEN?!1:(e.send(n),!0)}function E(n,t){c=!0,r&&(clearTimeout(r),r=null),f(),o=0,e&&(l("closing"),e.close(n,t),e=null),l("closed")}function I(){r&&(clearTimeout(r),r=null),o=0,c=!1,d()}return d(),{send:C,close:E,reconnect:I,get status(){return u}}}exports.createWebSocket=J;
+//# sourceMappingURL=create-web-socket.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-web-socket.cjs","sources":["../../src/ws/create-web-socket.ts"],"sourcesContent":["export type WebSocketStatus = \"idle\" | \"connecting\" | \"open\" | \"closing\" | \"closed\" | \"error\";\n\nexport interface WebSocketMessage<T> {\n    /** Parsed payload — JSON-decoded when possible, raw string otherwise. */\n    data: T;\n    /** The original `MessageEvent`. */\n    raw: MessageEvent;\n}\n\nexport interface CreateWebSocketOptions<T> {\n    /** Subprotocol(s) forwarded to the `WebSocket` constructor. */\n    protocols?: string | string[];\n    /** Max reconnect attempts. Default: 10. Pass 0 to disable. */\n    maxRetries?: number;\n    /** Initial backoff (ms). Doubles each attempt, capped at `maxBackoff`. Default: 1000. */\n    initialBackoff?: number;\n    /** Maximum backoff (ms). Default: 30000. */\n    maxBackoff?: number;\n    /**\n     * Ping interval (ms). When set, the client sends `pingPayload` periodically\n     * to keep the socket alive. Default: 0 (disabled).\n     */\n    pingInterval?: number;\n    /** Payload sent on each ping. Default: `JSON.stringify({ type: \"ping\" })`. */\n    pingPayload?: string | ArrayBufferLike | Blob | ArrayBufferView;\n    /** Parse incoming frames. Default: JSON with raw-string fallback. */\n    parser?: (raw: string) => T;\n    onOpen?: (event: Event) => void;\n    onMessage?: (message: WebSocketMessage<T>) => void;\n    onClose?: (event: CloseEvent) => void;\n    onError?: (event: Event) => void;\n    onStatusChange?: (status: WebSocketStatus) => void;\n}\n\nexport interface WebSocketController {\n    /** Send a payload over the current connection. No-op when not open. */\n    send: (payload: string | ArrayBufferLike | Blob | ArrayBufferView) => boolean;\n    /** Close the connection and stop reconnecting. */\n    close: (code?: number, reason?: string) => void;\n    /** Force an immediate reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /** Current connection status. */\n    readonly status: WebSocketStatus;\n}\n\nfunction defaultParser<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 * Open a WebSocket with automatic exponential-backoff reconnect, optional\n * heartbeat pings, and typed JSON parsing.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Controller exposing `send`, `close`, `reconnect`, and `status`.\n */\nexport function createWebSocket<T = unknown>(\n    url: string,\n    options: CreateWebSocketOptions<T> = {},\n): WebSocketController {\n    const {\n        protocols,\n        maxRetries = 10,\n        initialBackoff = 1000,\n        maxBackoff = 30000,\n        pingInterval = 0,\n        pingPayload = JSON.stringify({ type: \"ping\" }),\n        parser = defaultParser<T>,\n        onOpen,\n        onMessage,\n        onClose,\n        onError,\n        onStatusChange,\n    } = options;\n\n    let socket: WebSocket | null = null;\n    let retryTimer: ReturnType<typeof setTimeout> | null = null;\n    let pingTimer: ReturnType<typeof setInterval> | null = null;\n    let retries = 0;\n    let status: WebSocketStatus = \"idle\";\n    let closed = false;\n\n    function setStatus(next: WebSocketStatus): void {\n        if (status === next) return;\n        status = next;\n        onStatusChange?.(next);\n    }\n\n    function clearPing(): void {\n        if (pingTimer) {\n            clearInterval(pingTimer);\n            pingTimer = null;\n        }\n    }\n\n    function startPing(): void {\n        if (!pingInterval || pingInterval <= 0) return;\n        clearPing();\n        pingTimer = setInterval(() => {\n            if (socket?.readyState === WebSocket.OPEN) {\n                socket.send(pingPayload);\n            }\n        }, pingInterval);\n    }\n\n    function scheduleReconnect(): void {\n        if (closed) return;\n        if (retries >= maxRetries) {\n            setStatus(\"error\");\n            return;\n        }\n        const delay = Math.min(initialBackoff * 2 ** retries, maxBackoff);\n        retries += 1;\n        retryTimer = setTimeout(connect, delay);\n    }\n\n    function connect(): void {\n        if (closed) return;\n        if (socket) {\n            socket.onopen = null;\n            socket.onmessage = null;\n            socket.onclose = null;\n            socket.onerror = null;\n            socket.close();\n        }\n        setStatus(\"connecting\");\n\n        const ws = new WebSocket(url, protocols);\n        socket = ws;\n\n        ws.onopen = (event) => {\n            retries = 0;\n            setStatus(\"open\");\n            startPing();\n            onOpen?.(event);\n        };\n\n        ws.onmessage = (event) => {\n            const raw = typeof event.data === \"string\" ? event.data : \"\";\n            onMessage?.({\n                data: parser(raw),\n                raw: event,\n            });\n        };\n\n        ws.onerror = (event) => {\n            onError?.(event);\n        };\n\n        ws.onclose = (event) => {\n            clearPing();\n            onClose?.(event);\n            socket = null;\n            setStatus(\"closed\");\n            if (!closed && !event.wasClean) {\n                scheduleReconnect();\n            }\n        };\n    }\n\n    function send(payload: string | ArrayBufferLike | Blob | ArrayBufferView): boolean {\n        if (socket?.readyState !== WebSocket.OPEN) return false;\n        socket.send(payload);\n        return true;\n    }\n\n    function close(code?: number, reason?: string): void {\n        closed = true;\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        clearPing();\n        retries = 0;\n        if (socket) {\n            setStatus(\"closing\");\n            socket.close(code, reason);\n            socket = null;\n        }\n        setStatus(\"closed\");\n    }\n\n    function reconnect(): void {\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        retries = 0;\n        closed = false;\n        connect();\n    }\n\n    connect();\n\n    return {\n        send,\n        close,\n        reconnect,\n        get status() {\n            return status;\n        },\n    };\n}\n"],"names":["defaultParser","raw","createWebSocket","url","options","protocols","maxRetries","initialBackoff","maxBackoff","pingInterval","pingPayload","parser","onOpen","onMessage","onClose","onError","onStatusChange","socket","retryTimer","pingTimer","retries","status","closed","setStatus","next","clearPing","startPing","scheduleReconnect","delay","connect","ws","event","send","payload","close","code","reason","reconnect"],"mappings":"gFA6CA,SAASA,EAAiBC,EAAgB,CACtC,GAAI,CACA,OAAO,KAAK,MAAMA,CAAG,CACzB,MAAQ,CACJ,OAAOA,CACX,CACJ,CAUO,SAASC,EACZC,EACAC,EAAqC,GAClB,CACnB,KAAM,CACF,UAAAC,EACA,WAAAC,EAAa,GACb,eAAAC,EAAiB,IACjB,WAAAC,EAAa,IACb,aAAAC,EAAe,EACf,YAAAC,EAAc,KAAK,UAAU,CAAE,KAAM,OAAQ,EAC7C,OAAAC,EAASX,EACT,OAAAY,EACA,UAAAC,EACA,QAAAC,EACA,QAAAC,EACA,eAAAC,CAAA,EACAZ,EAEJ,IAAIa,EAA2B,KAC3BC,EAAmD,KACnDC,EAAmD,KACnDC,EAAU,EACVC,EAA0B,OAC1BC,EAAS,GAEb,SAASC,EAAUC,EAA6B,CACxCH,IAAWG,IACfH,EAASG,EACTR,IAAiBQ,CAAI,EACzB,CAEA,SAASC,GAAkB,CACnBN,IACA,cAAcA,CAAS,EACvBA,EAAY,KAEpB,CAEA,SAASO,GAAkB,CACnB,CAACjB,GAAgBA,GAAgB,IACrCgB,EAAA,EACAN,EAAY,YAAY,IAAM,CACtBF,GAAQ,aAAe,UAAU,MACjCA,EAAO,KAAKP,CAAW,CAE/B,EAAGD,CAAY,EACnB,CAEA,SAASkB,GAA0B,CAC/B,GAAIL,EAAQ,OACZ,GAAIF,GAAWd,EAAY,CACvBiB,EAAU,OAAO,EACjB,MACJ,CACA,MAAMK,EAAQ,KAAK,IAAIrB,EAAiB,GAAKa,EAASZ,CAAU,EAChEY,GAAW,EACXF,EAAa,WAAWW,EAASD,CAAK,CAC1C,CAEA,SAASC,GAAgB,CACrB,GAAIP,EAAQ,OACRL,IACAA,EAAO,OAAS,KAChBA,EAAO,UAAY,KACnBA,EAAO,QAAU,KACjBA,EAAO,QAAU,KACjBA,EAAO,MAAA,GAEXM,EAAU,YAAY,EAEtB,MAAMO,EAAK,IAAI,UAAU3B,EAAKE,CAAS,EACvCY,EAASa,EAETA,EAAG,OAAUC,GAAU,CACnBX,EAAU,EACVG,EAAU,MAAM,EAChBG,EAAA,EACAd,IAASmB,CAAK,CAClB,EAEAD,EAAG,UAAaC,GAAU,CACtB,MAAM9B,EAAM,OAAO8B,EAAM,MAAS,SAAWA,EAAM,KAAO,GAC1DlB,IAAY,CACR,KAAMF,EAAOV,CAAG,EAChB,IAAK8B,CAAA,CACR,CACL,EAEAD,EAAG,QAAWC,GAAU,CACpBhB,IAAUgB,CAAK,CACnB,EAEAD,EAAG,QAAWC,GAAU,CACpBN,EAAA,EACAX,IAAUiB,CAAK,EACfd,EAAS,KACTM,EAAU,QAAQ,EACd,CAACD,GAAU,CAACS,EAAM,UAClBJ,EAAA,CAER,CACJ,CAEA,SAASK,EAAKC,EAAqE,CAC/E,OAAIhB,GAAQ,aAAe,UAAU,KAAa,IAClDA,EAAO,KAAKgB,CAAO,EACZ,GACX,CAEA,SAASC,EAAMC,EAAeC,EAAuB,CACjDd,EAAS,GACLJ,IACA,aAAaA,CAAU,EACvBA,EAAa,MAEjBO,EAAA,EACAL,EAAU,EACNH,IACAM,EAAU,SAAS,EACnBN,EAAO,MAAMkB,EAAMC,CAAM,EACzBnB,EAAS,MAEbM,EAAU,QAAQ,CACtB,CAEA,SAASc,GAAkB,CACnBnB,IACA,aAAaA,CAAU,EACvBA,EAAa,MAEjBE,EAAU,EACVE,EAAS,GACTO,EAAA,CACJ,CAEA,OAAAA,EAAA,EAEO,CACH,KAAAG,EACA,MAAAE,EACA,UAAAG,EACA,IAAI,QAAS,CACT,OAAOhB,CACX,CAAA,CAER"}

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

@@ -0,0 +1,83 @@
+function J(a) {
+  try {
+    return JSON.parse(a);
+  } catch {
+    return a;
+  }
+}
+function M(a, g = {}) {
+  const {
+    protocols: p,
+    maxRetries: m = 10,
+    initialBackoff: S = 1e3,
+    maxBackoff: y = 3e4,
+    pingInterval: i = 0,
+    pingPayload: k = JSON.stringify({ type: "ping" }),
+    parser: P = J,
+    onOpen: O,
+    onMessage: T,
+    onClose: b,
+    onError: h,
+    onStatusChange: w
+  } = g;
+  let e = null, r = null, c = null, o = 0, u = "idle", s = !1;
+  function l(n) {
+    u !== n && (u = n, w?.(n));
+  }
+  function f() {
+    c && (clearInterval(c), c = null);
+  }
+  function N() {
+    !i || i <= 0 || (f(), c = setInterval(() => {
+      e?.readyState === WebSocket.OPEN && e.send(k);
+    }, i));
+  }
+  function W() {
+    if (s) return;
+    if (o >= m) {
+      l("error");
+      return;
+    }
+    const n = Math.min(S * 2 ** o, y);
+    o += 1, r = setTimeout(d, n);
+  }
+  function d() {
+    if (s) return;
+    e && (e.onopen = null, e.onmessage = null, e.onclose = null, e.onerror = null, e.close()), l("connecting");
+    const n = new WebSocket(a, p);
+    e = n, n.onopen = (t) => {
+      o = 0, l("open"), N(), O?.(t);
+    }, n.onmessage = (t) => {
+      const B = typeof t.data == "string" ? t.data : "";
+      T?.({
+        data: P(B),
+        raw: t
+      });
+    }, n.onerror = (t) => {
+      h?.(t);
+    }, n.onclose = (t) => {
+      f(), b?.(t), e = null, l("closed"), !s && !t.wasClean && W();
+    };
+  }
+  function C(n) {
+    return e?.readyState !== WebSocket.OPEN ? !1 : (e.send(n), !0);
+  }
+  function E(n, t) {
+    s = !0, r && (clearTimeout(r), r = null), f(), o = 0, e && (l("closing"), e.close(n, t), e = null), l("closed");
+  }
+  function I() {
+    r && (clearTimeout(r), r = null), o = 0, s = !1, d();
+  }
+  return d(), {
+    send: C,
+    close: E,
+    reconnect: I,
+    get status() {
+      return u;
+    }
+  };
+}
+export {
+  M as createWebSocket
+};
+//# sourceMappingURL=create-web-socket.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-web-socket.js","sources":["../../src/ws/create-web-socket.ts"],"sourcesContent":["export type WebSocketStatus = \"idle\" | \"connecting\" | \"open\" | \"closing\" | \"closed\" | \"error\";\n\nexport interface WebSocketMessage<T> {\n    /** Parsed payload — JSON-decoded when possible, raw string otherwise. */\n    data: T;\n    /** The original `MessageEvent`. */\n    raw: MessageEvent;\n}\n\nexport interface CreateWebSocketOptions<T> {\n    /** Subprotocol(s) forwarded to the `WebSocket` constructor. */\n    protocols?: string | string[];\n    /** Max reconnect attempts. Default: 10. Pass 0 to disable. */\n    maxRetries?: number;\n    /** Initial backoff (ms). Doubles each attempt, capped at `maxBackoff`. Default: 1000. */\n    initialBackoff?: number;\n    /** Maximum backoff (ms). Default: 30000. */\n    maxBackoff?: number;\n    /**\n     * Ping interval (ms). When set, the client sends `pingPayload` periodically\n     * to keep the socket alive. Default: 0 (disabled).\n     */\n    pingInterval?: number;\n    /** Payload sent on each ping. Default: `JSON.stringify({ type: \"ping\" })`. */\n    pingPayload?: string | ArrayBufferLike | Blob | ArrayBufferView;\n    /** Parse incoming frames. Default: JSON with raw-string fallback. */\n    parser?: (raw: string) => T;\n    onOpen?: (event: Event) => void;\n    onMessage?: (message: WebSocketMessage<T>) => void;\n    onClose?: (event: CloseEvent) => void;\n    onError?: (event: Event) => void;\n    onStatusChange?: (status: WebSocketStatus) => void;\n}\n\nexport interface WebSocketController {\n    /** Send a payload over the current connection. No-op when not open. */\n    send: (payload: string | ArrayBufferLike | Blob | ArrayBufferView) => boolean;\n    /** Close the connection and stop reconnecting. */\n    close: (code?: number, reason?: string) => void;\n    /** Force an immediate reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /** Current connection status. */\n    readonly status: WebSocketStatus;\n}\n\nfunction defaultParser<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 * Open a WebSocket with automatic exponential-backoff reconnect, optional\n * heartbeat pings, and typed JSON parsing.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Controller exposing `send`, `close`, `reconnect`, and `status`.\n */\nexport function createWebSocket<T = unknown>(\n    url: string,\n    options: CreateWebSocketOptions<T> = {},\n): WebSocketController {\n    const {\n        protocols,\n        maxRetries = 10,\n        initialBackoff = 1000,\n        maxBackoff = 30000,\n        pingInterval = 0,\n        pingPayload = JSON.stringify({ type: \"ping\" }),\n        parser = defaultParser<T>,\n        onOpen,\n        onMessage,\n        onClose,\n        onError,\n        onStatusChange,\n    } = options;\n\n    let socket: WebSocket | null = null;\n    let retryTimer: ReturnType<typeof setTimeout> | null = null;\n    let pingTimer: ReturnType<typeof setInterval> | null = null;\n    let retries = 0;\n    let status: WebSocketStatus = \"idle\";\n    let closed = false;\n\n    function setStatus(next: WebSocketStatus): void {\n        if (status === next) return;\n        status = next;\n        onStatusChange?.(next);\n    }\n\n    function clearPing(): void {\n        if (pingTimer) {\n            clearInterval(pingTimer);\n            pingTimer = null;\n        }\n    }\n\n    function startPing(): void {\n        if (!pingInterval || pingInterval <= 0) return;\n        clearPing();\n        pingTimer = setInterval(() => {\n            if (socket?.readyState === WebSocket.OPEN) {\n                socket.send(pingPayload);\n            }\n        }, pingInterval);\n    }\n\n    function scheduleReconnect(): void {\n        if (closed) return;\n        if (retries >= maxRetries) {\n            setStatus(\"error\");\n            return;\n        }\n        const delay = Math.min(initialBackoff * 2 ** retries, maxBackoff);\n        retries += 1;\n        retryTimer = setTimeout(connect, delay);\n    }\n\n    function connect(): void {\n        if (closed) return;\n        if (socket) {\n            socket.onopen = null;\n            socket.onmessage = null;\n            socket.onclose = null;\n            socket.onerror = null;\n            socket.close();\n        }\n        setStatus(\"connecting\");\n\n        const ws = new WebSocket(url, protocols);\n        socket = ws;\n\n        ws.onopen = (event) => {\n            retries = 0;\n            setStatus(\"open\");\n            startPing();\n            onOpen?.(event);\n        };\n\n        ws.onmessage = (event) => {\n            const raw = typeof event.data === \"string\" ? event.data : \"\";\n            onMessage?.({\n                data: parser(raw),\n                raw: event,\n            });\n        };\n\n        ws.onerror = (event) => {\n            onError?.(event);\n        };\n\n        ws.onclose = (event) => {\n            clearPing();\n            onClose?.(event);\n            socket = null;\n            setStatus(\"closed\");\n            if (!closed && !event.wasClean) {\n                scheduleReconnect();\n            }\n        };\n    }\n\n    function send(payload: string | ArrayBufferLike | Blob | ArrayBufferView): boolean {\n        if (socket?.readyState !== WebSocket.OPEN) return false;\n        socket.send(payload);\n        return true;\n    }\n\n    function close(code?: number, reason?: string): void {\n        closed = true;\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        clearPing();\n        retries = 0;\n        if (socket) {\n            setStatus(\"closing\");\n            socket.close(code, reason);\n            socket = null;\n        }\n        setStatus(\"closed\");\n    }\n\n    function reconnect(): void {\n        if (retryTimer) {\n            clearTimeout(retryTimer);\n            retryTimer = null;\n        }\n        retries = 0;\n        closed = false;\n        connect();\n    }\n\n    connect();\n\n    return {\n        send,\n        close,\n        reconnect,\n        get status() {\n            return status;\n        },\n    };\n}\n"],"names":["defaultParser","raw","createWebSocket","url","options","protocols","maxRetries","initialBackoff","maxBackoff","pingInterval","pingPayload","parser","onOpen","onMessage","onClose","onError","onStatusChange","socket","retryTimer","pingTimer","retries","status","closed","setStatus","next","clearPing","startPing","scheduleReconnect","delay","connect","ws","event","send","payload","close","code","reason","reconnect"],"mappings":"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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-web-socket.cjs","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 | ArrayBufferLike | Blob | ArrayBufferView) => 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(\n        (payload: string | ArrayBufferLike | Blob | ArrayBufferView): boolean => {\n            return controllerRef.current?.send(payload) ?? false;\n        },\n        [],\n    );\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    return { status, lastMessage, send, reconnect };\n}\n"],"names":["useWebSocket","url","options","enabled","onMessage","rest","status","setStatus","useState","lastMessage","setLastMessage","controllerRef","useRef","onMessageRef","useEffect","controller","createWebSocket","message","send","useCallback","payload","reconnect"],"mappings":"8IA4BO,SAASA,EACZC,EACAC,EAAkC,GACb,CACrB,KAAM,CAAE,QAAAC,EAAU,GAAM,UAAAC,EAAW,GAAGC,GAASH,EACzC,CAACI,EAAQC,CAAS,EAAIC,EAAAA,SAA0B,MAAM,EACtD,CAACC,EAAaC,CAAc,EAAIF,EAAAA,SAAqC,IAAI,EACzEG,EAAgBC,EAAAA,OAAmC,IAAI,EAEvDC,EAAeD,EAAAA,OAAOR,CAAS,EACrCS,EAAa,QAAUT,EAEvBU,EAAAA,UAAU,IAAM,CACZ,GAAI,CAACX,GAAW,CAACF,EAAK,CAClBM,EAAU,MAAM,EAChB,MACJ,CAEA,MAAMQ,EAAaC,EAAAA,gBAAmBf,EAAK,CACvC,GAAGI,EACH,eAAgBE,EAChB,UAAYU,GAAY,CACpBP,EAAeO,CAAO,EACtBJ,EAAa,UAAUI,CAAO,CAClC,CAAA,CACH,EACD,OAAAN,EAAc,QAAUI,EAEjB,IAAM,CACTA,EAAW,MAAA,EACXJ,EAAc,QAAU,IAC5B,CAEJ,EAAG,CAACV,EAAKE,CAAO,CAAC,EAEjB,MAAMe,EAAOC,EAAAA,YACRC,GACUT,EAAc,SAAS,KAAKS,CAAO,GAAK,GAEnD,CAAA,CAAC,EAGCC,EAAYF,EAAAA,YAAY,IAAY,CACtCR,EAAc,SAAS,UAAA,CAC3B,EAAG,CAAA,CAAE,EAEL,MAAO,CAAE,OAAAL,EAAQ,YAAAG,EAAa,KAAAS,EAAM,UAAAG,CAAA,CACxC"}

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

@@ -0,0 +1,32 @@
+import { useState as a, useRef as l, useEffect as m, useCallback as f } from "react";
+import { createWebSocket as p } from "./create-web-socket.js";
+function W(n, i = {}) {
+  const { enabled: s = !0, onMessage: r, ...d } = i, [g, c] = a("idle"), [M, S] = a(null), e = l(null), o = l(r);
+  o.current = r, m(() => {
+    if (!s || !n) {
+      c("idle");
+      return;
+    }
+    const t = p(n, {
+      ...d,
+      onStatusChange: c,
+      onMessage: (u) => {
+        S(u), o.current?.(u);
+      }
+    });
+    return e.current = t, () => {
+      t.close(), e.current = null;
+    };
+  }, [n, s]);
+  const b = f(
+    (t) => e.current?.send(t) ?? !1,
+    []
+  ), k = f(() => {
+    e.current?.reconnect();
+  }, []);
+  return { status: g, lastMessage: M, send: b, reconnect: k };
+}
+export {
+  W as useWebSocket
+};
+//# sourceMappingURL=use-web-socket.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-web-socket.js","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 | ArrayBufferLike | Blob | ArrayBufferView) => 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(\n        (payload: string | ArrayBufferLike | Blob | ArrayBufferView): boolean => {\n            return controllerRef.current?.send(payload) ?? false;\n        },\n        [],\n    );\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    return { status, lastMessage, send, reconnect };\n}\n"],"names":["useWebSocket","url","options","enabled","onMessage","rest","status","setStatus","useState","lastMessage","setLastMessage","controllerRef","useRef","onMessageRef","useEffect","controller","createWebSocket","message","send","useCallback","payload","reconnect"],"mappings":";;AA4BO,SAASA,EACZC,GACAC,IAAkC,IACb;AACrB,QAAM,EAAE,SAAAC,IAAU,IAAM,WAAAC,GAAW,GAAGC,MAASH,GACzC,CAACI,GAAQC,CAAS,IAAIC,EAA0B,MAAM,GACtD,CAACC,GAAaC,CAAc,IAAIF,EAAqC,IAAI,GACzEG,IAAgBC,EAAmC,IAAI,GAEvDC,IAAeD,EAAOR,CAAS;AACrC,EAAAS,EAAa,UAAUT,GAEvBU,EAAU,MAAM;AACZ,QAAI,CAACX,KAAW,CAACF,GAAK;AAClB,MAAAM,EAAU,MAAM;AAChB;AAAA,IACJ;AAEA,UAAMQ,IAAaC,EAAmBf,GAAK;AAAA,MACvC,GAAGI;AAAA,MACH,gBAAgBE;AAAA,MAChB,WAAW,CAACU,MAAY;AACpB,QAAAP,EAAeO,CAAO,GACtBJ,EAAa,UAAUI,CAAO;AAAA,MAClC;AAAA,IAAA,CACH;AACD,WAAAN,EAAc,UAAUI,GAEjB,MAAM;AACT,MAAAA,EAAW,MAAA,GACXJ,EAAc,UAAU;AAAA,IAC5B;AAAA,EAEJ,GAAG,CAACV,GAAKE,CAAO,CAAC;AAEjB,QAAMe,IAAOC;AAAA,IACT,CAACC,MACUT,EAAc,SAAS,KAAKS,CAAO,KAAK;AAAA,IAEnD,CAAA;AAAA,EAAC,GAGCC,IAAYF,EAAY,MAAY;AACtC,IAAAR,EAAc,SAAS,UAAA;AAAA,EAC3B,GAAG,CAAA,CAAE;AAEL,SAAO,EAAE,QAAAL,GAAQ,aAAAG,GAAa,MAAAS,GAAM,WAAAG,EAAA;AACxC;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tempest-react-sdk",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "SDK público da Tempest com componentes, hooks e integrações para projetos React.",
   "type": "module",
   "license": "MIT",
@@ -99,7 +99,9 @@
     "gen:geodata": "node scripts/gen-br-geodata.mjs",
     "vendor:vision": "node scripts/vendor-vision.mjs",
     "prepare": "husky",
-    "prepublishOnly": "npm run typecheck && npm run lint && npm run test:run && npm run build"
+    "prepublishOnly": "npm run typecheck && npm run lint && npm run test:run && npm run build",
+    "e2e": "playwright test",
+    "e2e:build": "npm run build && npm --prefix examples/gallery run build"
   },
   "lint-staged": {
     "*.{ts,tsx}": [
@@ -156,6 +158,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.36.0",
+    "@playwright/test": "^1.61.1",
     "@size-limit/preset-small-lib": "^12.1.0",
     "@tanstack/react-query": "^5.90.0",
     "@testing-library/jest-dom": "^6.9.1",
@@ -169,6 +172,7 @@
     "@types/react-dom": "^19.1.0",
     "@vitejs/plugin-react": "^5.0.0",
     "@vitest/coverage-v8": "^4.1.6",
+    "axe-core": "^4.12.1",
     "dexie": "^4.4.2",
     "eslint": "^9.36.0",
     "eslint-plugin-react-hooks": "^5.2.0",

package/template-pwa/src/main.tsx

@@ -1,29 +1,20 @@
 import { StrictMode } from "react";
 import { createRoot } from "react-dom/client";
-import { registerServiceWorker, skipWaiting } from "tempest-react-sdk";
 import "tempest-react-sdk/styles.css";
 import { App } from "@/App";
+import { PwaShell } from "@/pwa";
 
+/**
+ * PWA entrypoint. `<PwaShell>` registers the service worker (the bundled
+ * `/sw.js` in production, the `tempestPwaDevSw` plugin under `npm run dev`) and
+ * layers the update prompt, offline indicator, persistent-storage request and
+ * periodic background sync on top of the base app. Swap it for a bare `<App />`
+ * to opt out of any of that.
+ */
 createRoot(document.getElementById("root")!).render(
     <StrictMode>
-        <App />
+        <PwaShell>
+            <App />
+        </PwaShell>
     </StrictMode>,
 );
-
-// Register the service worker in both dev and prod. In production it's the
-// bundled `/sw.js` (built by `vite.sw.config.ts`); in dev the `tempestPwaDevSw`
-// plugin (in `vite.config.ts`) compiles and serves it on the fly, so push and
-// runtime caching work under `npm run dev` too. Drop the `tempestPwaDevSw`
-// plugin if you'd rather keep dev SW-free.
-void registerServiceWorker({
-    url: "/sw.js",
-    onUpdate: (waiting) => {
-        // A new worker is ready. Prompt your users however you like; here we
-        // just activate it and reload so the next visit is up to date.
-        if (confirm("Nova versão disponível. Atualizar agora?")) {
-            skipWaiting(waiting);
-            window.location.reload();
-        }
-    },
-    onError: (err) => console.warn("[sw] registration failed", err),
-});