tempest-react-sdk 0.7.0 → 0.9.0

package/dist/vite.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite.js","sources":["../src/vite/create-vite-config.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { defineConfig } from \"vite\";\nimport type { ProxyOptions, UserConfig } from \"vite\";\nimport react from \"@vitejs/plugin-react\";\n\n/**\n * A Vite proxy entry: either a target URL string (expanded to\n * `{ target, changeOrigin: true }`) or a raw Vite `ProxyOptions` object.\n */\nexport type ProxyEntry = string | Record<string, unknown>;\n\nexport interface CreateViteConfigOptions {\n    /**\n     * Source directory aliased to `@`, relative to the project root.\n     * Default: `\"src\"` (so `@/components/Button` → `<root>/src/components/Button`).\n     */\n    srcDir?: string;\n    /** Dev server port. Default: `5173`. */\n    port?: number;\n    /** Dev server host. Default: `\"127.0.0.1\"`. */\n    host?: string | boolean;\n    /** Open the browser on `dev` start. Default: `false`. */\n    open?: boolean;\n    /**\n     * Dev proxy table. String values are expanded to\n     * `{ target, changeOrigin: true }`; objects are passed through untouched.\n     *\n     * @example { \"/api\": \"http://127.0.0.1:8000\" }\n     */\n    proxy?: Record<string, ProxyEntry>;\n    /** Extra path aliases merged on top of the default `@` → src alias. */\n    alias?: Record<string, string>;\n    /** Vite plugins appended after `@vitejs/plugin-react`. */\n    plugins?: unknown[];\n    /**\n     * Arbitrary Vite config (a `UserConfig` object) deep-merged last, for\n     * escape-hatch overrides (build target, define, extra `server` keys, …).\n     */\n    overrides?: Record<string, unknown>;\n}\n\n/**\n * The resulting Vite config object. Typed loosely so the SDK's published\n * declarations stay free of `vite`'s internal types; assign it straight to a\n * `vite.config.ts` default export.\n */\nexport type TempestViteConfig = Record<string, unknown>;\n\nfunction normalizeProxy(proxy: Record<string, ProxyEntry>): Record<string, ProxyOptions> {\n    const out: Record<string, ProxyOptions> = {};\n    for (const [path, value] of Object.entries(proxy)) {\n        out[path] =\n            typeof value === \"string\"\n                ? { target: value, changeOrigin: true }\n                : (value as ProxyOptions);\n    }\n    return out;\n}\n\n/**\n * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`\n * plugin, the `@` → `src` import alias, and sane dev-server defaults — so a\n * consuming app's `vite.config.ts` is a single call instead of repeated\n * boilerplate. Everything is overridable.\n *\n * Import it from the dedicated Node entry point:\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *     proxy: { \"/api\": \"http://127.0.0.1:8000\" },\n * });\n */\nexport function createViteConfig(options: CreateViteConfigOptions = {}): TempestViteConfig {\n    const {\n        srcDir = \"src\",\n        port = 5173,\n        host = \"127.0.0.1\",\n        open = false,\n        proxy,\n        alias = {},\n        plugins = [],\n        overrides = {},\n    } = options;\n\n    const overridesConfig = overrides as UserConfig;\n\n    const base: UserConfig = {\n        plugins: [react(), ...plugins] as UserConfig[\"plugins\"],\n        resolve: {\n            alias: {\n                \"@\": resolve(process.cwd(), srcDir),\n                ...alias,\n            },\n        },\n        server: {\n            port,\n            host,\n            open,\n            ...(proxy ? { proxy: normalizeProxy(proxy) } : {}),\n        },\n    };\n\n    const merged: UserConfig = {\n        ...base,\n        ...overridesConfig,\n        plugins: [...(base.plugins ?? []), ...(overridesConfig.plugins ?? [])],\n        resolve: { ...base.resolve, ...overridesConfig.resolve },\n        server: { ...base.server, ...overridesConfig.server },\n    };\n\n    return defineConfig(merged) as TempestViteConfig;\n}\n"],"names":["normalizeProxy","proxy","out","path","value","createViteConfig","options","srcDir","port","host","open","alias","plugins","overrides","overridesConfig","base","react","resolve","merged","defineConfig"],"mappings":";;;AAgDA,SAASA,EAAeC,GAAiE;AACrF,QAAMC,IAAoC,CAAA;AAC1C,aAAW,CAACC,GAAMC,CAAK,KAAK,OAAO,QAAQH,CAAK;AAC5C,IAAAC,EAAIC,CAAI,IACJ,OAAOC,KAAU,WACX,EAAE,QAAQA,GAAO,cAAc,GAAA,IAC9BA;AAEf,SAAOF;AACX;AAkBO,SAASG,EAAiBC,IAAmC,IAAuB;AACvF,QAAM;AAAA,IACF,QAAAC,IAAS;AAAA,IACT,MAAAC,IAAO;AAAA,IACP,MAAAC,IAAO;AAAA,IACP,MAAAC,IAAO;AAAA,IACP,OAAAT;AAAA,IACA,OAAAU,IAAQ,CAAA;AAAA,IACR,SAAAC,IAAU,CAAA;AAAA,IACV,WAAAC,IAAY,CAAA;AAAA,EAAC,IACbP,GAEEQ,IAAkBD,GAElBE,IAAmB;AAAA,IACrB,SAAS,CAACC,KAAS,GAAGJ,CAAO;AAAA,IAC7B,SAAS;AAAA,MACL,OAAO;AAAA,QACH,KAAKK,EAAQ,QAAQ,IAAA,GAAOV,CAAM;AAAA,QAClC,GAAGI;AAAA,MAAA;AAAA,IACP;AAAA,IAEJ,QAAQ;AAAA,MACJ,MAAAH;AAAA,MACA,MAAAC;AAAA,MACA,MAAAC;AAAA,MACA,GAAIT,IAAQ,EAAE,OAAOD,EAAeC,CAAK,EAAA,IAAM,CAAA;AAAA,IAAC;AAAA,EACpD,GAGEiB,IAAqB;AAAA,IACvB,GAAGH;AAAA,IACH,GAAGD;AAAA,IACH,SAAS,CAAC,GAAIC,EAAK,WAAW,CAAA,GAAK,GAAID,EAAgB,WAAW,EAAG;AAAA,IACrE,SAAS,EAAE,GAAGC,EAAK,SAAS,GAAGD,EAAgB,QAAA;AAAA,IAC/C,QAAQ,EAAE,GAAGC,EAAK,QAAQ,GAAGD,EAAgB,OAAA;AAAA,EAAO;AAGxD,SAAOK,EAAaD,CAAM;AAC9B;"}
+{"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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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tempest-react-sdk",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "SDK público da Tempest com componentes, hooks e integrações para projetos React.",
   "type": "module",
   "license": "MIT",
@@ -25,11 +25,13 @@
     "dist",
     "bin",
     "template",
+    "template-pwa",
     "README.md",
     "LICENSE"
   ],
   "bin": {
-    "create-tempest-app": "./bin/create-tempest-app.mjs"
+    "create-tempest-app": "./bin/create-tempest-app.mjs",
+    "tempest": "./bin/tempest.mjs"
   },
   "main": "./dist/tempest-react-sdk.cjs",
   "module": "./dist/tempest-react-sdk.js",
@@ -53,6 +55,11 @@
       "import": "./dist/vite.js",
       "require": "./dist/vite.cjs"
     },
+    "./sw": {
+      "types": "./dist/sw.d.ts",
+      "import": "./dist/sw.js",
+      "require": "./dist/sw.cjs"
+    },
     "./styles.css": "./dist/styles.css",
     "./package.json": "./package.json"
   },
@@ -68,6 +75,7 @@
     "test:coverage": "vitest run --coverage",
     "clean": "rm -rf dist coverage",
     "size": "size-limit",
+    "docs:llms": "node scripts/gen-llms.mjs",
     "prepare": "husky",
     "prepublishOnly": "npm run typecheck && npm run lint && npm run test:run && npm run build"
   },

package/template/_prettierrc.json

@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "singleQuote": false,
+  "tabWidth": 2,
+  "printWidth": 100,
+  "trailingComma": "all",
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

package/template/eslint.config.js

@@ -2,6 +2,8 @@ import js from "@eslint/js";
 import globals from "globals";
 import reactHooks from "eslint-plugin-react-hooks";
 import reactRefresh from "eslint-plugin-react-refresh";
+import simpleImportSort from "eslint-plugin-simple-import-sort";
+import unusedImports from "eslint-plugin-unused-imports";
 import tseslint from "typescript-eslint";
 
 export default tseslint.config(
@@ -16,12 +18,27 @@ export default tseslint.config(
         plugins: {
             "react-hooks": reactHooks,
             "react-refresh": reactRefresh,
+            "simple-import-sort": simpleImportSort,
+            "unused-imports": unusedImports,
         },
         rules: {
             ...reactHooks.configs.recommended.rules,
             "react-refresh/only-export-components": ["warn", { allowConstantExport: true }],
             "@typescript-eslint/consistent-type-imports": "error",
-            "@typescript-eslint/no-unused-vars": ["error", { argsIgnorePattern: "^_" }],
+            // Organize imports/exports (tempest fix).
+            "simple-import-sort/imports": "error",
+            "simple-import-sort/exports": "error",
+            // Remove dead imports + flag unused vars (tempest fix).
+            "@typescript-eslint/no-unused-vars": "off",
+            "unused-imports/no-unused-imports": "error",
+            "unused-imports/no-unused-vars": [
+                "warn",
+                { argsIgnorePattern: "^_", varsIgnorePattern: "^_" },
+            ],
+            // Tidy whitespace (tempest fix).
+            "no-multiple-empty-lines": ["error", { max: 1, maxEOF: 0, maxBOF: 0 }],
+            "no-trailing-spaces": "error",
+            "eol-last": ["error", "always"],
         },
     },
 );

package/template/package.json

@@ -9,7 +9,10 @@
     "preview": "vite preview",
     "typecheck": "tsc --noEmit",
     "lint": "eslint .",
-    "lint:fix": "eslint . --fix"
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "fix": "tempest fix",
+    "doctor": "tempest doctor"
   },
   "dependencies": {
     "react": "^19.0.0",
@@ -24,7 +27,10 @@
     "eslint": "^9.36.0",
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-react-refresh": "^0.4.22",
+    "eslint-plugin-simple-import-sort": "^12.1.0",
+    "eslint-plugin-unused-imports": "^4.1.4",
     "globals": "^16.0.0",
+    "prettier": "^3.8.0",
     "typescript": "~5.9.0",
     "typescript-eslint": "^8.45.0",
     "vite": "^7.0.0"

package/template-pwa/README.md

@@ -0,0 +1,64 @@
+# Tempest App (PWA)
+
+Scaffolded with [`create-tempest-app --pwa`](https://www.npmjs.com/package/tempest-react-sdk) and powered by [`tempest-react-sdk`](https://www.npmjs.com/package/tempest-react-sdk).
+
+## Stack
+
+- **Vite** with the `@` → `src` alias (`tempest-react-sdk/vite` → `createViteConfig`)
+- **React Router v7** declarative routing (`defineRoutes` + `<AppRouter>`)
+- **Zustand** state (`createAuthStore` + `createSelectors`)
+- **TanStack Query** cache (mounted by `<AppProviders>`)
+- **PWA**: installable manifest + a service worker built from `tempest-react-sdk/sw`, with web-push wiring
+
+## Getting started
+
+```bash
+npm install
+cp .env.example .env   # adjust VITE_API_URL + VITE_VAPID_PUBLIC_KEY
+npm run dev            # http://127.0.0.1:5173
+```
+
+## PWA layout
+
+```text
+public/manifest.webmanifest   # install metadata (name, icons, theme color)
+public/icon.svg               # app icon (replace with your brand; PNG 192/512 recommended)
+src/sw.ts                     # service worker — push + notificationclick + skip-waiting
+vite.sw.config.ts             # bundles src/sw.ts → dist/sw.js (classic worker)
+index.html                    # manifest link + theme-color + apple meta tags
+src/main.tsx                  # registers /sw.js in production, cleans up SW in dev
+src/pages/Dashboard.tsx       # Install button + push notifications toggle
+```
+
+## How it works
+
+- **Install**: `index.html` links the manifest; `useBeforeInstallPrompt` (in
+  `Dashboard.tsx`) surfaces a custom Install button when the browser offers one.
+- **Service worker**: `src/sw.ts` imports `installPushHandler`,
+  `installNotificationClickHandler` and `installSkipWaitingListener` from
+  `tempest-react-sdk/sw`. `npm run build` bundles it to `dist/sw.js` via
+  `vite.sw.config.ts`, and `src/main.tsx` registers it in production.
+- **Web push**: `usePushSubscription` reads `VITE_VAPID_PUBLIC_KEY`, subscribes
+  through the active service worker, and hands the subscription to your
+  `onSubscribe` callback to POST to your backend.
+
+> ⚠️ The service worker is bundled at **build time**, so push and offline behave
+> only in a production build. Test them with:
+>
+> ```bash
+> npm run build && npm run preview
+> ```
+>
+> In `npm run dev` the worker is intentionally unregistered to avoid stale caches.
+
+## Replace the icons
+
+`public/icon.svg` is a placeholder. For guaranteed installability across all
+browsers, add PNG icons (192×192 and 512×512) to `public/` and point the
+`manifest.webmanifest` `icons` entries at them.
+
+## Next steps
+
+- Add a route: drop a page in `src/pages/` and an entry in `src/routes.tsx`.
+- Fetch data: `useQuery({ queryKey: queryKeys.me(), queryFn: () => api.get("/me") })`.
+- Generate VAPID keys on your backend and set `VITE_VAPID_PUBLIC_KEY` in `.env`.

package/template-pwa/_env.example

@@ -0,0 +1,7 @@
+# Base URL of your backend API (consumed by src/lib/api.ts).
+VITE_API_URL=http://127.0.0.1:8000
+
+# VAPID public key for web push (consumed by usePushSubscription in
+# src/pages/Dashboard.tsx). Generate a key pair on your backend; the private
+# half stays on the server, this public half ships to the browser.
+VITE_VAPID_PUBLIC_KEY=

package/template-pwa/index.html

@@ -0,0 +1,22 @@
+<!doctype html>
+<html lang="pt-BR">
+    <head>
+        <meta charset="UTF-8" />
+        <link rel="icon" type="image/svg+xml" href="/icon.svg" />
+        <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
+        <meta name="theme-color" content="#0b1a36" />
+        <meta name="description" content="App React fiado com tempest-react-sdk." />
+        <meta name="application-name" content="Tempest App" />
+        <meta name="apple-mobile-web-app-capable" content="yes" />
+        <meta name="apple-mobile-web-app-title" content="Tempest App" />
+        <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
+        <meta name="mobile-web-app-capable" content="yes" />
+        <link rel="manifest" href="/manifest.webmanifest" />
+        <title>Tempest App</title>
+    </head>
+    <body>
+        <div id="root"></div>
+        <script type="module" src="/src/main.tsx"></script>
+    </body>
+</html>

package/template-pwa/package.json

@@ -0,0 +1,9 @@
+{
+  "scripts": {
+    "build": "tsc --noEmit && vite build && npm run build:sw",
+    "build:sw": "vite build --config vite.sw.config.ts"
+  },
+  "devDependencies": {
+    "sharp": "^0.34.0"
+  }
+}

package/template-pwa/public/icon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" role="img" aria-label="Tempest">
+    <rect width="512" height="512" rx="96" fill="#0b1a36" />
+    <path d="M152 168h208l-40 64h-72v176l-64 32V232h-72z" fill="#ffffff" />
+</svg>

package/template-pwa/public/manifest.webmanifest

@@ -0,0 +1,35 @@
+{
+    "name": "Tempest App",
+    "short_name": "Tempest",
+    "description": "App React fiado com tempest-react-sdk.",
+    "id": "/",
+    "start_url": "/?source=pwa",
+    "scope": "/",
+    "display": "standalone",
+    "orientation": "portrait",
+    "lang": "pt-BR",
+    "dir": "ltr",
+    "background_color": "#ffffff",
+    "theme_color": "#0b1a36",
+    "categories": ["productivity", "utilities"],
+    "icons": [
+        {
+            "src": "/icons/icon-192.png",
+            "sizes": "192x192",
+            "type": "image/png",
+            "purpose": "any"
+        },
+        {
+            "src": "/icons/icon-512.png",
+            "sizes": "512x512",
+            "type": "image/png",
+            "purpose": "any"
+        },
+        {
+            "src": "/icons/maskable-512.png",
+            "sizes": "512x512",
+            "type": "image/png",
+            "purpose": "maskable"
+        }
+    ]
+}

package/template-pwa/src/main.tsx

@@ -0,0 +1,29 @@
+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";
+
+createRoot(document.getElementById("root")!).render(
+    <StrictMode>
+        <App />
+    </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),
+});

package/template-pwa/src/pages/Dashboard.tsx

@@ -0,0 +1,73 @@
+import { Button, useBeforeInstallPrompt, usePushSubscription } from "tempest-react-sdk";
+import { useAuth } from "@/stores/auth";
+
+/**
+ * Protected page (see the `guard` in src/routes.tsx). Lazy-loaded, so it is
+ * code-split into its own chunk. Default export because `lazy` expects one.
+ *
+ * Adds two PWA controls:
+ *  - Install button (`useBeforeInstallPrompt`) — appears only when the browser
+ *    offers an install prompt and the app is not yet installed.
+ *  - Push toggle (`usePushSubscription`) — subscribes/unsubscribes to web push.
+ *    The service worker must be active, so this works in a production build
+ *    (`npm run build && npm run preview`), not in `npm run dev`.
+ */
+export default function Dashboard() {
+    const user = useAuth.use.user();
+    const install = useBeforeInstallPrompt();
+
+    const push = usePushSubscription({
+        vapidPublicKey: import.meta.env.VITE_VAPID_PUBLIC_KEY ?? "",
+        onSubscribe: async (subscription) => {
+            // Send the subscription to your backend so it can deliver pushes.
+            // await api.post("/webpush/subscribe", { body: subscription });
+            console.log("push subscription", subscription);
+        },
+        onUnsubscribe: async () => {
+            // await api.delete("/webpush/my");
+            console.log("push unsubscribed");
+        },
+    });
+
+    return (
+        <section>
+            <h1>Dashboard</h1>
+            <p>
+                Signed in as <strong>{user?.name}</strong> ({user?.email}).
+            </p>
+            <p>This route is only reachable while authenticated.</p>
+
+            <h2>PWA</h2>
+
+            {install.installed ? (
+                <p>✅ App installed.</p>
+            ) : install.installable ? (
+                <Button onClick={() => void install.prompt()}>Install app</Button>
+            ) : (
+                <p>Install prompt not available in this browser/context.</p>
+            )}
+
+            <h2>Notifications</h2>
+
+            {!push.supported ? (
+                <p>Web push is not supported here (needs HTTPS + an active service worker).</p>
+            ) : (
+                <>
+                    <Button
+                        onClick={() =>
+                            void (push.subscribed ? push.unsubscribe() : push.subscribe())
+                        }
+                        disabled={push.loading}
+                    >
+                        {push.subscribed ? "Disable notifications" : "Enable notifications"}
+                    </Button>
+                    <p>
+                        Permission: <strong>{push.permission}</strong> · Subscribed:{" "}
+                        <strong>{String(push.subscribed)}</strong>
+                    </p>
+                    {push.error && <p style={{ color: "crimson" }}>{push.error.message}</p>}
+                </>
+            )}
+        </section>
+    );
+}

package/template-pwa/src/sw.ts

@@ -0,0 +1,70 @@
+/// <reference lib="webworker" />
+import {
+    installBackgroundSync,
+    installNotificationClickHandler,
+    installPrecache,
+    installPushHandler,
+    installRuntimeCache,
+    installSkipWaitingListener,
+} from "tempest-react-sdk/sw";
+
+/**
+ * Service worker. Bundled to `dist/sw.js` by `vite.sw.config.ts` (see the
+ * `build:sw` script) and registered from `src/main.tsx`.
+ *
+ * Layers, in order:
+ *  1. Push + notifications + skip-waiting (the SDK push helpers).
+ *  2. Background sync — failed API mutations are queued and replayed online.
+ *  3. Runtime caching: API GETs (network-first) + media (cache-first with
+ *     Range support, so audio/video seeking works offline).
+ *  4. Precache of the app shell so the app launches offline. Reads the
+ *     `precache-manifest.json` emitted by `tempestPwaManifest()` in
+ *     `vite.config.ts`.
+ *
+ * `installRuntimeCache` is registered BEFORE `installPrecache` so its specific
+ * routes win over the precache catch-all.
+ */
+declare const self: ServiceWorkerGlobalScope;
+
+installPushHandler({
+    defaultTitle: "Notificação",
+    defaultIcon: "/icon.svg",
+    defaultBadge: "/icon.svg",
+});
+
+installNotificationClickHandler();
+installSkipWaitingListener();
+
+// Queue failed POST/PUT/PATCH/DELETE to /api and replay them when back online.
+installBackgroundSync({ match: (url) => url.pathname.startsWith("/api/") });
+
+installRuntimeCache([
+    {
+        match: (url) => url.pathname.startsWith("/api/"),
+        strategy: "network-first",
+        cacheName: "api",
+        networkTimeoutSeconds: 5,
+        maxEntries: 50,
+        maxAgeSeconds: 60 * 5,
+    },
+    {
+        // Audio/video: cache-first + Range support (seek/scrub works offline).
+        match: (url) => /\.(mp3|mp4|webm|ogg|wav)$/.test(url.pathname),
+        strategy: "cache-first",
+        cacheName: "media",
+        maxEntries: 20,
+        rangeRequests: true,
+    },
+]);
+
+installPrecache({
+    navigateFallback: "/index.html",
+    // Don't serve the app shell for API navigations.
+    navigateFallbackDenylist: [/^\/api\//],
+});
+
+// Take control of open pages as soon as this worker activates. `installPrecache`
+// also calls `clients.claim()`; this is harmless if you drop precaching.
+self.addEventListener("activate", (event) => {
+    event.waitUntil(self.clients.claim());
+});

package/template-pwa/src/vite-env.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+    /** Base URL of the backend API (src/lib/api.ts). */
+    readonly VITE_API_URL?: string;
+    /** VAPID public key for web push (src/pages/Dashboard.tsx). */
+    readonly VITE_VAPID_PUBLIC_KEY?: string;
+}
+
+interface ImportMeta {
+    readonly env: ImportMetaEnv;
+}

package/template-pwa/vite.config.ts

@@ -0,0 +1,21 @@
+import {
+    createViteConfig,
+    tempestPwaDevSw,
+    tempestPwaIcons,
+    tempestPwaManifest,
+} from "tempest-react-sdk/vite";
+
+// `createViteConfig` wires `@vitejs/plugin-react`, the `@` → `src` alias and
+// dev-server defaults. The three PWA plugins (order matters):
+//  - tempestPwaIcons   — rasterizes public/icon.svg into the PNG icon set (sharp).
+//  - tempestPwaManifest — emits dist/precache-manifest.json (it sees the icons
+//    above because they're emitted first), for offline app-shell precaching.
+//  - tempestPwaDevSw   — serves /sw.js (and an empty manifest) under `npm run dev`.
+export default createViteConfig({
+    // proxy: { "/api": "http://127.0.0.1:8000" },
+    plugins: [
+        tempestPwaIcons({ source: "public/icon.svg", appleSplash: true }),
+        tempestPwaManifest({ additionalUrls: ["/manifest.webmanifest", "/icon.svg"] }),
+        tempestPwaDevSw(),
+    ],
+});

package/template-pwa/vite.sw.config.ts

@@ -0,0 +1,27 @@
+import { resolve } from "node:path";
+import { defineConfig } from "vite";
+
+/**
+ * Standalone build that bundles `src/sw.ts` (and the `tempest-react-sdk/sw`
+ * helpers it imports) into a single classic service worker at `dist/sw.js`.
+ *
+ * Run after the app build via the `build:sw` script — `emptyOutDir: false`
+ * keeps the app's `dist/` intact. The IIFE format produces a worker with no
+ * `import`/`export` tokens, so it registers as a classic worker (no
+ * `type: "module"` needed).
+ */
+export default defineConfig({
+    build: {
+        emptyOutDir: false,
+        sourcemap: true,
+        lib: {
+            entry: resolve(__dirname, "src/sw.ts"),
+            formats: ["iife"],
+            name: "sw",
+            fileName: () => "sw.js",
+        },
+        rollupOptions: {
+            output: { entryFileNames: "sw.js", inlineDynamicImports: true },
+        },
+    },
+});