tempest-react-sdk 0.8.0 → 0.9.0

package/dist/tempest-react-sdk.d.ts

@@ -1259,6 +1259,17 @@ export declare interface CreateLoggerOptions {
  */
 export declare function createOfflineStore<TItem, TKey extends string | number = string>(config: OfflineStoreConfig<TItem>): OfflineStore<TItem, TKey>;
 
+/**
+ * Build a `206 Partial Content` response from a full one for an HTTP `Range`
+ * request. Supports `bytes=start-end`, open-ended `bytes=start-` and suffix
+ * `bytes=-suffixLength`. Returns the original response when there is no usable
+ * `Range` header, or a `416` when the range is unsatisfiable.
+ *
+ * @param request The incoming request (its `Range` header drives the slice).
+ * @param response The full (200) response to slice.
+ */
+export declare function createPartialResponse(request: Request, response: Response): Promise<Response>;
+
 /**
  * Build a [[TelemetryAdapter]] backed by [`posthog-js`](https://posthog.com/docs/libraries/js).
  * The PostHog client is supplied by the caller (not bundled).
@@ -2455,6 +2466,42 @@ export declare interface InputProps extends Omit<InputHTMLAttributes<HTMLInputEl
 
 export declare type InputSize = "sm" | "md" | "lg";
 
+/**
+ * Install the background-sync queue: on a failed mutating request, the request
+ * is serialized to IndexedDB and a sync is registered; the original fetch still
+ * rejects (so your app can show an offline state), and the request is replayed
+ * later when the network returns.
+ */
+export declare function installBackgroundSync(options?: InstallBackgroundSyncOptions): void;
+
+/**
+ * Background-sync helper: queue failed mutating requests (POST/PUT/PATCH/DELETE)
+ * while offline and replay them when connectivity returns. A dependency-free
+ * take on Workbox's `BackgroundSyncPlugin`, backed by a tiny IndexedDB queue.
+ *
+ * Import inside your `sw.ts`. Uses the Background Sync API (`registration.sync`)
+ * when available, and also replays opportunistically on the next request as a
+ * fallback for browsers without it (e.g. Safari).
+ *
+ * @example
+ *   import { installBackgroundSync } from "tempest-react-sdk/sw";
+ *
+ *   installBackgroundSync({ match: (url) => url.pathname.startsWith("/api/") });
+ */
+/** Options for {@link installBackgroundSync}. */
+export declare interface InstallBackgroundSyncOptions {
+    /**
+     * Which requests to queue on failure. A `RegExp` against the URL or a
+     * predicate. Only non-`GET` requests are ever considered. Default: all
+     * non-`GET` requests.
+     */
+    match?: RegExp | ((url: URL, request: Request) => boolean);
+    /** IndexedDB database name, also used as the sync tag. Default `tempest-bg-sync`. */
+    queueName?: string;
+    /** Drop queued requests older than this (minutes) on replay. Default `1440` (24h). */
+    maxRetentionMinutes?: number;
+}
+
 /**
  * Install a `notificationclick` handler that focuses an existing client when
  * possible and falls back to opening a new window.
@@ -2466,6 +2513,32 @@ export declare interface InstallNotificationClickHandlerOptions {
     resolveUrl?: (data: unknown) => string;
 }
 
+/**
+ * Precache the app shell at `install` and serve it offline:
+ *  - reads `precache-manifest.json` (emitted by `tempestPwaManifest()`),
+ *  - caches every listed URL under a versioned cache,
+ *  - on `activate`, deletes stale precache versions and claims open clients,
+ *  - on `fetch`, serves precached assets cache-first and falls back to the
+ *    `navigateFallback` document for offline navigations (SPA routing).
+ *
+ * Same-origin only. Register this LAST, after any {@link installRuntimeCache}.
+ */
+export declare function installPrecache(options?: InstallPrecacheOptions): void;
+
+/** Options for {@link installPrecache}. */
+export declare interface InstallPrecacheOptions {
+    /** URL of the manifest emitted by `tempestPwaManifest()`. Default `/precache-manifest.json`. */
+    manifestUrl?: string;
+    /** Cache name prefix; the manifest `version` is appended. Default `tempest-precache`. */
+    cacheName?: string;
+    /** App-shell document served for navigation requests offline. Default `/index.html`. */
+    navigateFallback?: string;
+    /** Navigation paths that should NOT use the fallback (e.g. `[/^\/api\//]`). */
+    navigateFallbackDenylist?: RegExp[];
+    /** Activate the new worker immediately after precaching. Default `true`. */
+    skipWaiting?: boolean;
+}
+
 /**
  * Install a `push` event listener that parses the payload as JSON (with a
  * plain-text fallback) and shows a notification.
@@ -2486,6 +2559,18 @@ export declare interface InstallPushHandlerOptions {
     transform?: (payload: PushPayload) => PushPayload | null;
 }
 
+/**
+ * Install a `fetch` handler that resolves matching `GET` requests with the
+ * given runtime strategies. Non-matching requests are left untouched (no
+ * `respondWith`), so a later {@link installPrecache} can handle them.
+ *
+ * Register this BEFORE `installPrecache` so specific routes win over the
+ * precache catch-all.
+ *
+ * @param routes Ordered rules; the first whose `match` passes handles the request.
+ */
+export declare function installRuntimeCache(routes: RuntimeRoute[]): void;
+
 /**
  * Install a `message` listener that activates a waiting worker when the host
  * app sends `{ type: "SKIP_WAITING" }`.
@@ -3635,6 +3720,51 @@ export declare type RouterKind = "browser" | "hash" | "memory";
 
 export { Routes }
 
+/** A single runtime-caching rule, matched against each `GET` request. */
+export declare interface RuntimeRoute {
+    /** A `RegExp` tested against the full URL, or a predicate over the parsed URL. */
+    match: RegExp | ((url: URL, request: Request) => boolean);
+    /** How to resolve a match. */
+    strategy: RuntimeStrategy;
+    /** Cache bucket name for this route. */
+    cacheName: string;
+    /** Trim the cache to at most this many entries (FIFO) after each write. */
+    maxEntries?: number;
+    /** Treat a cached response older than this (seconds) as a miss. */
+    maxAgeSeconds?: number;
+    /** For `network-first`: fall back to cache after this timeout (seconds). */
+    networkTimeoutSeconds?: number;
+    /**
+     * Serve HTTP `Range` requests (206 Partial Content) by slicing the cached
+     * full response. Enable for audio/video so seeking works offline. The full
+     * resource is cached once (the `Range` header is stripped before caching).
+     */
+    rangeRequests?: boolean;
+}
+
+/**
+ * Service-worker caching helpers — a small, dependency-free subset of what
+ * Workbox provides: precaching of the build's app shell (so the app launches
+ * offline) plus runtime caching strategies for fonts, APIs and images.
+ *
+ * Import these inside your own `sw.ts`. They run in the service-worker global
+ * scope, not the main thread. Pair `installPrecache` with the
+ * `tempestPwaManifest()` Vite plugin (from `tempest-react-sdk/vite`), which
+ * emits the `precache-manifest.json` this reads at install time.
+ *
+ * @example
+ *   /// <reference lib="webworker" />
+ *   import { installRuntimeCache, installPrecache } from "tempest-react-sdk/sw";
+ *
+ *   // Register specific routes FIRST so they win over the precache catch-all.
+ *   installRuntimeCache([
+ *     { match: /\/api\//, strategy: "network-first", cacheName: "api", maxAgeSeconds: 300 },
+ *   ]);
+ *   installPrecache();
+ */
+/** Caching strategy for a runtime route. Mirrors the common Workbox trio. */
+export declare type RuntimeStrategy = "cache-first" | "network-first" | "stale-while-revalidate";
+
 /**
  * Apply `env(safe-area-inset-*)` padding so content avoids iOS notch /
  * Android navbar / device chrome. Wrap the outermost container of pages

package/dist/tempest-react-sdk.js

@@ -1,12 +1,12 @@
-import { installNotificationClickHandler as Dw, installPushHandler as Mw, installSkipWaitingListener as Iw, registerServiceWorker as Aw, skipWaiting as Rw, unregisterAllServiceWorkers as Pw } from "./sw.js";
+import { createPartialResponse as Dw, installBackgroundSync as Mw, installNotificationClickHandler as Iw, installPrecache as Aw, installPushHandler as Rw, installRuntimeCache as Pw, installSkipWaitingListener as Bw, registerServiceWorker as Ow, skipWaiting as Fw, unregisterAllServiceWorkers as zw } from "./sw.js";
 import { jsx as a, jsxs as v, Fragment as ce } from "react/jsx-runtime";
 import { useId as U, useState as N, useCallback as E, useEffect as S, useMemo as A, Fragment as lt, forwardRef as F, useRef as L, useContext as Ae, createContext as Re, cloneElement as tn, createElement as kn, lazy as Tn, Suspense as Sn, Component as En, isValidElement as Cn, useSyncExternalStore as nn } from "react";
 import { QueryClient as xn, QueryClientProvider as Ln } from "@tanstack/react-query";
 import { Navigate as Dn, MemoryRouter as Mn, HashRouter as In, BrowserRouter as An, Routes as Rn, Route as xt } from "react-router-dom";
-import { BrowserRouter as Ow, HashRouter as Fw, Link as zw, MemoryRouter as Ww, NavLink as jw, Navigate as Uw, Outlet as Hw, Route as Kw, Routes as qw, redirect as Gw, useLocation as Jw, useMatch as Qw, useNavigate as Yw, useParams as Vw, useRouteError as Zw, useSearchParams as Xw } from "react-router-dom";
+import { BrowserRouter as jw, HashRouter as Uw, Link as Hw, MemoryRouter as Kw, NavLink as qw, Navigate as Gw, Outlet as Jw, Route as Qw, Routes as Yw, redirect as Vw, useLocation as Zw, useMatch as Xw, useNavigate as ev, useParams as tv, useRouteError as nv, useSearchParams as rv } from "react-router-dom";
 import { createPortal as Ue } from "react-dom";
 import { useFormContext as Pn, Controller as Bn, useForm as On } from "react-hook-form";
-import { Controller as tv, FormProvider as nv, useFieldArray as rv, useForm as sv, useFormContext as ov, useFormState as iv, useWatch as av } from "react-hook-form";
+import { Controller as ov, FormProvider as iv, useFieldArray as av, useForm as cv, useFormContext as lv, useFormState as uv, useWatch as dv } from "react-hook-form";
 import { create as wt } from "zustand";
 import { persist as rn, createJSONStorage as sn } from "zustand/middleware";
 import Fn from "dexie";
@@ -6941,7 +6941,7 @@ export {
   Q_ as BottomNavigation,
   Y_ as BottomSheet,
   V_ as Breadcrumbs,
-  Ow as BrowserRouter,
+  jw as BrowserRouter,
   $t as Button,
   Xh as CACHE_TIME,
   Oy as CEPInput,
@@ -6961,7 +6961,7 @@ export {
   rg as ConfirmDialog,
   hg as Container,
   hb as ContextMenu,
-  tv as Controller,
+  ov as Controller,
   Zg as CopyButton,
   cb as DataList,
   Yb as DataTable,
@@ -6980,12 +6980,12 @@ export {
   dg as Form,
   fg as FormActions,
   Ty as FormField,
-  nv as FormProvider,
+  iv as FormProvider,
   mg as FormRow,
   pg as FormSection,
   ay as GoogleSignIn,
   gg as Grid,
-  Fw as HashRouter,
+  Uw as HashRouter,
   Lg as Hide,
   _b as HoverCard,
   c_ as I18nProvider,
@@ -6993,17 +6993,17 @@ export {
   Ct as Input,
   bg as Kbd,
   mb as Label,
-  zw as Link,
-  Ww as MemoryRouter,
+  Hw as Link,
+  Kw as MemoryRouter,
   $b as Menubar,
   ti as Modal,
   eb as Money,
   Fy as MoneyInput,
-  jw as NavLink,
+  qw as NavLink,
   yg as Navbar,
-  Uw as Navigate,
+  Gw as Navigate,
   vb as NavigationMenu,
-  Hw as Outlet,
+  Jw as Outlet,
   wg as Page,
   Kc as Pagination,
   vg as PasswordInput,
@@ -7020,9 +7020,9 @@ export {
   Cg as RatingStars,
   Xg as RelativeTime,
   yb as Resizable,
-  Kw as Route,
+  Qw as Route,
   t_ as RouteGuard,
-  qw as Routes,
+  Yw as Routes,
   Zh as STALE_TIME,
   Dg as SafeArea,
   bb as ScrollArea,
@@ -7075,6 +7075,7 @@ export {
   ew as createLaunchDarklyFeatureFlagsAdapter,
   x_ as createLogger,
   Ny as createOfflineStore,
+  Dw as createPartialResponse,
   Jy as createPostHogTelemetryAdapter,
   uy as createQueryKeys,
   iy as createRefreshQueue,
@@ -7100,9 +7101,12 @@ export {
   ty as generateIdempotencyKey,
   jy as getInitialTheme,
   uw as groupBy,
-  Dw as installNotificationClickHandler,
-  Mw as installPushHandler,
-  Iw as installSkipWaitingListener,
+  Mw as installBackgroundSync,
+  Iw as installNotificationClickHandler,
+  Aw as installPrecache,
+  Rw as installPushHandler,
+  Pw as installRuntimeCache,
+  Bw as installSkipWaitingListener,
   gw as isDefined,
   _w as isEmpty,
   oy as isJWTExpired,
@@ -7122,12 +7126,12 @@ export {
   lw as pluralize,
   Cw as randomId,
   mw as range,
-  Gw as redirect,
-  Aw as registerServiceWorker,
+  Vw as redirect,
+  Ow as registerServiceWorker,
   Mm as relativeTime,
   ey as retry,
   tw as share,
-  Rw as skipWaiting,
+  Fw as skipWaiting,
   Sw as sleep,
   sw as slugify,
   vy as stopAudio,
@@ -7137,7 +7141,7 @@ export {
   ow as truncate,
   dw as uniqueBy,
   Ly as unmask,
-  Pw as unregisterAllServiceWorkers,
+  zw as unregisterAllServiceWorkers,
   Xb as uploadWithProgress,
   f_ as urlBase64ToUint8Array,
   Lb as useAsync,
@@ -7153,12 +7157,12 @@ export {
   Eb as useEventListener,
   by as useEventStream,
   Yy as useFeatureFlag,
-  rv as useFieldArray,
+  av as useFieldArray,
   Vy as useFlagValue,
   kf as useFocusTrap,
-  sv as useForm,
-  ov as useFormContext,
-  iv as useFormState,
+  cv as useForm,
+  lv as useFormContext,
+  uv as useFormState,
   Fb as useGeolocation,
   Jb as useHover,
   l_ as useI18n,
@@ -7167,22 +7171,22 @@ export {
   Hb as useInterval,
   Pb as useKeyboardShortcut,
   Cb as useLocalStorage,
-  Jw as useLocation,
+  Zw as useLocation,
   Qb as useLongPress,
-  Qw as useMatch,
+  Xw as useMatch,
   Sb as useMediaQuery,
-  Yw as useNavigate,
+  ev as useNavigate,
   cy as useOAuthCallback,
   Db as useOnline,
   Ph as usePagination,
-  Vw as useParams,
+  tv as useParams,
   ny as usePoll,
   Ub as usePrevious,
   yy as usePushSubscription,
   Ab as useResizeObserver,
-  Zw as useRouteError,
+  nv as useRouteError,
   zb as useScrollLock,
-  Xw as useSearchParams,
+  rv as useSearchParams,
   Wb as useStableCallback,
   Ky as useTelemetry,
   hy as useTheme,
@@ -7192,7 +7196,7 @@ export {
   xb as useToggle,
   _y as useTranslate,
   zy as useViaCEP,
-  av as useWatch,
+  dv as useWatch,
   Wy as useWebSocket,
   Gb as useWindowSize,
   Ey as useZodForm,

package/dist/vite.cjs

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

package/dist/vite.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"vite.cjs","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":"iKAgDA,SAASA,EAAeC,EAAiE,CACrF,MAAMC,EAAoC,CAAA,EAC1C,SAAW,CAACC,EAAMC,CAAK,IAAK,OAAO,QAAQH,CAAK,EAC5CC,EAAIC,CAAI,EACJ,OAAOC,GAAU,SACX,CAAE,OAAQA,EAAO,aAAc,EAAA,EAC9BA,EAEf,OAAOF,CACX,CAkBO,SAASG,EAAiBC,EAAmC,GAAuB,CACvF,KAAM,CACF,OAAAC,EAAS,MACT,KAAAC,EAAO,KACP,KAAAC,EAAO,YACP,KAAAC,EAAO,GACP,MAAAT,EACA,MAAAU,EAAQ,CAAA,EACR,QAAAC,EAAU,CAAA,EACV,UAAAC,EAAY,CAAA,CAAC,EACbP,EAEEQ,EAAkBD,EAElBE,EAAmB,CACrB,QAAS,CAACC,IAAS,GAAGJ,CAAO,EAC7B,QAAS,CACL,MAAO,CACH,IAAKK,EAAAA,QAAQ,QAAQ,IAAA,EAAOV,CAAM,EAClC,GAAGI,CAAA,CACP,EAEJ,OAAQ,CACJ,KAAAH,EACA,KAAAC,EACA,KAAAC,EACA,GAAIT,EAAQ,CAAE,MAAOD,EAAeC,CAAK,CAAA,EAAM,CAAA,CAAC,CACpD,EAGEiB,EAAqB,CACvB,GAAGH,EACH,GAAGD,EACH,QAAS,CAAC,GAAIC,EAAK,SAAW,CAAA,EAAK,GAAID,EAAgB,SAAW,EAAG,EACrE,QAAS,CAAE,GAAGC,EAAK,QAAS,GAAGD,EAAgB,OAAA,EAC/C,OAAQ,CAAE,GAAGC,EAAK,OAAQ,GAAGD,EAAgB,MAAA,CAAO,EAGxD,OAAOK,EAAAA,aAAaD,CAAM,CAC9B"}
+{"version":3,"file":"vite.cjs","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/dist/vite.d.ts

@@ -1,3 +1,13 @@
+/** A single Apple splash target (CSS px + device pixel ratio). */
+export declare interface AppleSplashSpec {
+    /** CSS width (device-width in the media query). */
+    width: number;
+    /** CSS height (device-height in the media query). */
+    height: number;
+    /** Device pixel ratio. */
+    ratio: number;
+}
+
 /**
  * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`
  * plugin, the `@` → `src` import alias, and sane dev-server defaults — so a
@@ -52,6 +62,123 @@ export declare interface CreateViteConfigOptions {
  */
 export declare type ProxyEntry = string | Record<string, unknown>;
 
+/**
+ * Dev-server plugin that makes the service worker available under `npm run dev`.
+ *
+ * The production worker is bundled at build time (`vite.sw.config.ts`), so in
+ * dev there is no `/sw.js` to register. This plugin compiles `swSrc` on the fly
+ * with esbuild and serves it as a classic worker, plus an empty
+ * `precache-manifest.json` (there are no hashed build assets to precache in
+ * dev — push and runtime caching still work). It closes the "SW in dev" gap
+ * that otherwise only `vite-plugin-pwa`'s `devOptions` covered.
+ *
+ * @example
+ * // vite.config.ts
+ * import { createViteConfig, tempestPwaDevSw } from "tempest-react-sdk/vite";
+ *
+ * export default createViteConfig({ plugins: [tempestPwaDevSw()] });
+ */
+export declare function tempestPwaDevSw(options?: TempestPwaDevSwOptions): TempestVitePlugin;
+
+/** Options for {@link tempestPwaDevSw}. */
+export declare interface TempestPwaDevSwOptions {
+    /** Service-worker entry, relative to the project root. Default `src/sw.ts`. */
+    swSrc?: string;
+    /** URL the worker is served at (must match `registerServiceWorker`). Default `/sw.js`. */
+    swUrl?: string;
+    /** Dev URL of the precache manifest. Default `/precache-manifest.json`. */
+    manifestUrl?: string;
+    /** Serve the worker in dev. Default `true`; set `false` to opt out. */
+    enabled?: boolean;
+}
+
+/**
+ * Build plugin that rasterizes a single source image into a full PWA icon set
+ * (regular + maskable + apple-touch-icon), the dependency-free counterpart to
+ * `@vite-pwa/assets-generator`. Rendering uses **`sharp`**, imported lazily and
+ * treated as optional: if it isn't installed the plugin logs a warning and skips
+ * generation (your build still succeeds; the icons just aren't produced).
+ *
+ * Point your `manifest.webmanifest` icon entries at the emitted files
+ * (`/icons/icon-192.png`, `/icons/icon-512.png`, `/icons/maskable-512.png`) and
+ * the apple touch icon at `/apple-touch-icon.png`.
+ *
+ * @example
+ * // vite.config.ts
+ * import { createViteConfig, tempestPwaIcons } from "tempest-react-sdk/vite";
+ *
+ * export default createViteConfig({
+ *   plugins: [tempestPwaIcons({ source: "public/icon.svg" })],
+ * });
+ */
+export declare function tempestPwaIcons(options?: TempestPwaIconsOptions): TempestVitePlugin;
+
+/** Options for {@link tempestPwaIcons}. */
+export declare interface TempestPwaIconsOptions {
+    /** Source image (SVG or large PNG), relative to the project root. Default `public/icon.svg`. */
+    source?: string;
+    /** Square "any"-purpose icon sizes to emit. Default `[192, 512]`. */
+    sizes?: number[];
+    /** Square "maskable" icon sizes to emit (with safe-zone padding). Default `[512]`. */
+    maskableSizes?: number[];
+    /** Apple touch icon size, or `false` to skip. Default `180`. */
+    appleTouchIcon?: number | false;
+    /** Output directory for the icon set, under the build root. Default `icons`. */
+    outDir?: string;
+    /** Opaque background for maskable + apple icons (no transparency allowed). Default `#ffffff`. */
+    background?: string;
+    /** Maskable safe-zone padding as a fraction of the icon. Default `0.1` (10% each side). */
+    maskablePadding?: number;
+    /**
+     * Generate Apple splash screens (launch images) and inject the matching
+     * `<link rel="apple-touch-startup-image">` tags. `true` uses a built-in set
+     * of common iPhone/iPad portrait sizes; pass an array to override. Default `false`.
+     */
+    appleSplash?: boolean | AppleSplashSpec[];
+    /** Background color for splash screens. Default: `background`. */
+    splashBackground?: string;
+    /** Icon size on the splash as a fraction of the shorter side. Default `0.3`. */
+    splashIconScale?: number;
+}
+
+/**
+ * Vite build plugin that emits a `precache-manifest.json` listing every built
+ * asset (plus any `additionalUrls`) as root-absolute URLs, with a content-based
+ * `version`. It is the dependency-free counterpart to Workbox's `__WB_MANIFEST`:
+ * `installPrecache` (from `tempest-react-sdk/sw`) reads this file at the service
+ * worker's `install` event to cache the app shell for offline use.
+ *
+ * @example
+ * // vite.config.ts
+ * import { createViteConfig, tempestPwaManifest } from "tempest-react-sdk/vite";
+ *
+ * export default createViteConfig({
+ *   plugins: [tempestPwaManifest({ additionalUrls: ["/manifest.webmanifest", "/icon.svg"] })],
+ * });
+ */
+export declare function tempestPwaManifest(options?: TempestPwaManifestOptions): TempestVitePlugin;
+
+/** Options for {@link tempestPwaManifest}. */
+export declare interface TempestPwaManifestOptions {
+    /** Output file name (under the build root). Default `precache-manifest.json`. */
+    fileName?: string;
+    /**
+     * Extra URLs to precache that Vite doesn't emit into the bundle — typically
+     * `public/` assets like the web manifest and icons. Default `[]`.
+     */
+    additionalUrls?: string[];
+    /** Emitted files matching this are skipped. Default `/\.map$/` (source maps). */
+    exclude?: RegExp;
+    /** Include emitted `.html` documents (the app shell). Default `true`. */
+    includeHtml?: boolean;
+    /**
+     * App-shell document always added to the manifest, even if Vite emits it
+     * after this plugin runs. Must match `installPrecache`'s `navigateFallback`
+     * so offline navigations resolve. Pass `false` to disable. Default `/index.html`.
+     */
+    appShell?: string | false;
+}
+
 /**
  * The resulting Vite config object. Typed loosely so the SDK's published
  * declarations stay free of `vite`'s internal types; assign it straight to a
@@ -59,4 +186,13 @@ export declare type ProxyEntry = string | Record<string, unknown>;
  */
 export declare type TempestViteConfig = Record<string, unknown>;
 
+/**
+ * A Vite plugin object. Typed loosely so the SDK's published declarations stay
+ * free of `vite`'s internal types (which the `.d.ts` rollup can't analyze);
+ * assign the result straight into a `plugins: [...]` array.
+ */
+export declare type TempestVitePlugin = {
+    name: string;
+} & Record<string, unknown>;
+
 export { }