@genesislcap/vite-builder 15.80.0 → 15.81.0

package/README.md

@@ -2,7 +2,23 @@
 
 Builder wrapping [Vite](https://vitejs.dev/) bundler.
 
-
+## PWA and Service Worker
+
+The `pwa` and `serviceWorker` options in `genx.config.ts` are supported by the Vite builder, matching the Webpack builder:
+
+- `pwa`: emits `manifest.json` and injects `<link rel="manifest">`, `theme-color` and, when `ios` is set, the Apple meta and touch-icon tags into `index.html`. Icon and manifest URLs use `pwa.publicPath`, falling back to `PUBLIC_PATH`.
+  - Icons under `public/` are served from there. Other icon paths are resolved from the app root and emitted to `destination` (default `icons/`). When two different files share a name there, the later one gets a content hash appended.
+  - Icons are not resized, so a raster icon needs one entry per size. A warning is logged when one file is declared at several sizes.
+  - Tags `index.html` already has (same `meta` name, or same `link` rel and sizes) are not added again.
+- `serviceWorker`: compiles `serviceWorker.worker` (relative to `src/`) into a classic script at `assetName` (default: the worker's file name with a `.js` extension). `assetName` may include a directory.
+  - `registration` is added to `index.html`. Without it, genx adds a script that registers the worker once the page has loaded. Set `registration: false` when the app registers the worker itself.
+  - Workbox `injectManifest` fills `self.__WB_MANIFEST` with every emitted file except those matched by `exclude`. As in the Webpack builder, strings match as prefixes, functions receive `{ asset }`, and the default is `[/\.map$/, /^manifest.*\.js$/]`.
+  - Files Vite names with a content hash are precached without a revision. Every other file, including those copied from `public/` and icons emitted under a fixed name, gets one, so a changed file is fetched again.
+  - Files over `maximumFileSizeToCache` that `exclude` doesn't already drop are left out of the precache with a warning.
+  - `precache: false` builds a worker that doesn't precache, so it needn't reference `self.__WB_MANIFEST`.
+  - Under `genx dev` the worker is bundled on request and served at `assetName` under the public path, the URL it has in the build, with an empty precache manifest.
+
+When neither option is configured, output remains unchanged.
 
 ## Installation
 

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;yBA4CrC,KAAK,YAAY;AAAvC,wBA6RE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;yBA6CrC,KAAK,YAAY;AAAvC,wBAgSE"}

package/dist/index.js

@@ -5,6 +5,7 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const build_kit_1 = require("@genesislcap/build-kit");
 const consola_1 = tslib_1.__importDefault(require("consola"));
+const pwa_js_1 = require("./pwa.js");
 const vite_js_1 = require("./vite.js");
 /**
  * There seems to be various documented issues using Vite in a monorepo setup that are impacted by various factors.
@@ -154,6 +155,7 @@ exports.default = (ctx) => tslib_1.__awaiter(void 0, void 0, void 0, function* (
             typescript: { tsconfigPath, buildMode },
         })
         : null;
+    const pwaPlugins = yield (0, pwa_js_1.resolvePwaPlugins)(ctx);
     const baseHrefPlugin = {
         name: 'genesis-base-href',
         transformIndexHtml(html) {
@@ -179,6 +181,7 @@ exports.default = (ctx) => tslib_1.__awaiter(void 0, void 0, void 0, function* (
                     insertEntryPoint: true,
                 },
             }),
+            ...pwaPlugins,
         ],
         resolve: {
             alias: Object.assign(Object.assign({}, alias), { 'foundationRapid/RapidDesignSystem': '@genesislcap/rapid-design-system' }),

package/dist/pwa.d.ts

@@ -0,0 +1,39 @@
+import type { BuildContext, PWAIcon, PWAManifest } from '@genesislcap/build-kit';
+import type { HtmlTagDescriptor, Plugin, ResolvedConfig } from 'vite';
+import type { VitePWAOptions } from 'vite-plugin-pwa';
+import type { ManifestTransform } from 'workbox-build';
+type ServiceWorkerConfig = BuildContext['config']['serviceWorker'];
+export interface ManifestIcon {
+    src: string;
+    sizes: string;
+    type: string;
+    purpose?: string;
+}
+export interface ResolvedManifestIcons {
+    icons: ManifestIcon[];
+    appleTags: HtmlTagDescriptor[];
+    /** Output file name to source path, for icons that are not served from `public/` */
+    files: Map<string, string>;
+}
+export declare const iconMimeType: (src: string) => string;
+export declare const resolveManifestIcons: (icons: PWAIcon | PWAIcon[] | undefined, base: string, cwd: string) => ResolvedManifestIcons;
+export declare const appleHeadTags: (pwa: PWAManifest) => HtmlTagDescriptor[];
+export declare const resolveManifest: (pwa: PWAManifest, base: string, cwd: string) => {
+    manifest: Record<string, unknown>;
+    appleTags: HtmlTagDescriptor[];
+    iconFiles: Map<string, string>;
+};
+export declare const createManifestPlugin: (pwa: PWAManifest, cwd: string) => Plugin;
+/**
+ * Applies `exclude` before the size limit, as workbox-webpack-plugin does, and precaches only the
+ * files in `hashedFiles` without a revision.
+ */
+export declare const createPrecacheTransform: ({ exclude, maximumFileSizeToCache }: ServiceWorkerConfig, hashedFiles?: ReadonlySet<string>) => ManifestTransform;
+export declare const createServiceWorkerOptions: (serviceWorker: ServiceWorkerConfig, hashedFiles?: ReadonlySet<string>) => Partial<VitePWAOptions>;
+export declare const bundleServiceWorker: (swSrc: string, config: ResolvedConfig) => Promise<{
+    code: string;
+    moduleIds: Set<string>;
+}>;
+export declare const resolvePwaPlugins: (ctx: BuildContext) => Promise<Plugin[]>;
+export {};
+//# sourceMappingURL=pwa.d.ts.map

package/dist/pwa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwa.d.ts","sourceRoot":"","sources":["../src/pwa.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EAGP,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAShC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,cAAc,EAAU,MAAM,MAAM,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD,KAAK,mBAAmB,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,CAAC;AAGnE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,oFAAoF;IACpF,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5B;AAsED,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAK1C,CAAC;AAuCF,eAAO,MAAM,oBAAoB,GAC/B,OAAO,OAAO,GAAG,OAAO,EAAE,GAAG,SAAS,EACtC,MAAM,MAAM,EACZ,KAAK,MAAM,KACV,qBA4BF,CAAC;AAWF,eAAO,MAAM,aAAa,GAAI,KAAK,WAAW,KAAG,iBAAiB,EAqBjE,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,KAAK,WAAW,EAAE,MAAM,MAAM,EAAE,KAAK,MAAM;;;;CAc1E,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,KAAK,WAAW,EAAE,KAAK,MAAM,KAAG,MAqDpE,CAAC;AA0DF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAEhC,qCAAqC,mBAAmB,EACxD,cAAa,WAAW,CAAC,MAAM,CAAa,KAC3C,iBAeF,CAAC;AAWJ,eAAO,MAAM,0BAA0B,GACrC,eAAe,mBAAmB,EAClC,cAAa,WAAW,CAAC,MAAM,CAAa,KAC3C,OAAO,CAAC,cAAc,CA4BxB,CAAC;AAmCF,eAAO,MAAM,mBAAmB,GAAU,OAAO,MAAM,EAAE,QAAQ,cAAc;;;EAyB9E,CAAC;AA2DF,eAAO,MAAM,iBAAiB,GAAU,KAAK,YAAY,KAAG,OAAO,CAAC,MAAM,EAAE,CAyB3E,CAAC"}

package/dist/pwa.js

@@ -0,0 +1,453 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePwaPlugins = exports.bundleServiceWorker = exports.createServiceWorkerOptions = exports.createPrecacheTransform = exports.createManifestPlugin = exports.resolveManifest = exports.appleHeadTags = exports.resolveManifestIcons = exports.iconMimeType = void 0;
+const tslib_1 = require("tslib");
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const build_kit_1 = require("@genesislcap/build-kit");
+const consola_1 = tslib_1.__importDefault(require("consola"));
+const vite_js_1 = require("./vite.js");
+const MANIFEST_FILE_NAME = 'manifest.json';
+// workbox-webpack-plugin's default `exclude`
+const DEFAULT_SW_EXCLUDE = [/\.map$/, /^manifest.*\.js$/];
+// Workbox's default `maximumFileSizeToCacheInBytes`
+const DEFAULT_MAXIMUM_FILE_SIZE_TO_CACHE = 2097152;
+// webpack-pwa-manifest options (snake_cased) that are not Web App Manifest members
+const NON_MANIFEST_KEYS = [
+    'crossorigin',
+    'filename',
+    'fingerprints',
+    'icon',
+    'include_directory',
+    'inject',
+    'ios',
+    'public_path',
+    'use_webpack_public_path',
+];
+const APPLE_META_TAGS = [
+    'apple-mobile-web-app-title',
+    'apple-mobile-web-app-capable',
+    'apple-mobile-web-app-status-bar-style',
+];
+const ICON_MIME_TYPES = {
+    svg: 'image/svg+xml',
+    png: 'image/png',
+    ico: 'image/x-icon',
+    webp: 'image/webp',
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+};
+const ICON_HASH_LENGTH = 8;
+const PUBLIC_DIR_PREFIX = /^(\.\/)?public\//;
+const REMOTE_SRC = /^(https?:|data:)/;
+const withTrailingSlash = (path) => (path.endsWith('/') ? path : `${path}/`);
+const formatSize = (size) => /^\d+$/.test(String(size)) ? `${size}x${size}` : String(size);
+const headTag = (tag, attrs) => ({
+    tag,
+    attrs,
+    injectTo: 'head',
+});
+const parseAttrs = (source) => {
+    var _a, _b, _c;
+    const attrs = {};
+    const pattern = /([^\s=/>]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'>]+)))?/g;
+    for (let match = pattern.exec(source); match; match = pattern.exec(source)) {
+        attrs[match[1].toLowerCase()] = (_c = (_b = (_a = match[2]) !== null && _a !== void 0 ? _a : match[3]) !== null && _b !== void 0 ? _b : match[4]) !== null && _c !== void 0 ? _c : '';
+    }
+    return attrs;
+};
+const htmlTags = (html) => {
+    const tags = [];
+    const pattern = /<(link|meta|script)\b([^>]*)>/gi;
+    for (let match = pattern.exec(html); match; match = pattern.exec(html)) {
+        tags.push({ tag: match[1].toLowerCase(), attrs: parseAttrs(match[2]) });
+    }
+    return tags;
+};
+const headTagKey = (tag, attrs) => {
+    const value = (name) => { var _a; return String((_a = attrs[name]) !== null && _a !== void 0 ? _a : '').toLowerCase(); };
+    return tag === 'meta' ? `meta:${value('name')}` : `${tag}:${value('rel')}:${value('sizes')}`;
+};
+const iconMimeType = (src) => {
+    var _a, _b;
+    const dataUriType = (_a = /^data:([^;,]+)/.exec(src)) === null || _a === void 0 ? void 0 : _a[1];
+    if (dataUriType)
+        return dataUriType;
+    const ext = (0, node_path_1.extname)(src.split(/[?#]/)[0]).slice(1).toLowerCase();
+    return (_b = ICON_MIME_TYPES[ext]) !== null && _b !== void 0 ? _b : 'image/png';
+};
+exports.iconMimeType = iconMimeType;
+const iconOutputDir = (destination = 'icons') => destination.replace(/^\.?\/+/, '').replace(/\/+$/, '');
+// Distinct files that share a base name would otherwise be emitted over each other
+const uniqueIconFileName = (fileName, file, files) => {
+    const claimedBy = files.get(fileName);
+    if (claimedBy === undefined || claimedBy === file)
+        return fileName;
+    const { dir, name, ext } = node_path_1.posix.parse(fileName);
+    const hash = (0, node_crypto_1.createHash)('sha256')
+        .update((0, node_fs_1.readFileSync)(file))
+        .digest('hex')
+        .slice(0, ICON_HASH_LENGTH);
+    return node_path_1.posix.join(dir, `${name}-${hash}${ext}`);
+};
+const locateIcon = (icon, base, cwd, files) => {
+    const { src } = icon;
+    const publicUrl = `${base}${src.replace(PUBLIC_DIR_PREFIX, '').replace(/^\//, '')}`;
+    if (REMOTE_SRC.test(src))
+        return src;
+    if (PUBLIC_DIR_PREFIX.test(src) || src.startsWith('/'))
+        return publicUrl;
+    const file = (0, node_path_1.resolve)(cwd, src);
+    if ((0, node_fs_1.existsSync)(file)) {
+        const fileName = uniqueIconFileName(node_path_1.posix.join(iconOutputDir(icon.destination), (0, node_path_1.basename)(src)), file, files);
+        files.set(fileName, file);
+        return `${base}${fileName}`;
+    }
+    if (!(0, node_fs_1.existsSync)((0, node_path_1.resolve)(cwd, 'public', src))) {
+        consola_1.default.warn(`PWA icon ${src} not found in ${cwd} or its public directory.`);
+    }
+    return publicUrl;
+};
+const resolveManifestIcons = (icons, base, cwd) => {
+    var _a;
+    const resolved = { icons: [], appleTags: [], files: new Map() };
+    for (const icon of icons ? [icons].flat() : []) {
+        const url = locateIcon(icon, base, cwd, resolved.files);
+        const type = icon.type || (0, exports.iconMimeType)(icon.src);
+        const declaredSizes = [(_a = icon.sizes) !== null && _a !== void 0 ? _a : icon.size].flat().filter(Boolean);
+        const sizes = declaredSizes.length ? declaredSizes.map(formatSize) : ['any'];
+        if (sizes.length > 1 && type !== 'image/svg+xml') {
+            consola_1.default.warn(`PWA icon ${icon.src} is declared at ${sizes.join(', ')}, but the Vite builder does not resize icons. Add one icon entry per size.`);
+        }
+        for (const size of sizes) {
+            resolved.icons.push(Object.assign({ src: url, sizes: size, type }, (icon.purpose ? { purpose: icon.purpose } : {})));
+            if (icon.ios) {
+                const rel = icon.ios === 'startup' ? 'apple-touch-startup-image' : 'apple-touch-icon';
+                resolved.appleTags.push(headTag('link', { rel, sizes: size, href: url }));
+            }
+        }
+    }
+    return resolved;
+};
+exports.resolveManifestIcons = resolveManifestIcons;
+const appleTouchIconTag = (value) => {
+    const { href, sizes } = typeof value === 'string' ? { href: value, sizes: undefined } : value;
+    return headTag('link', Object.assign({ rel: 'apple-touch-icon', href }, (sizes ? { sizes: String(sizes) } : {})));
+};
+const appleHeadTags = (pwa) => {
+    if (!pwa.ios)
+        return [];
+    const apple = Object.assign({ 'apple-mobile-web-app-title': pwa.name, 'apple-mobile-web-app-capable': 'yes', 'apple-mobile-web-app-status-bar-style': 'default' }, (typeof pwa.ios === 'object' ? pwa.ios : {}));
+    return Object.entries(apple).flatMap(([name, value]) => {
+        if (APPLE_META_TAGS.includes(name)) {
+            const content = typeof value === 'boolean' ? (value ? 'yes' : 'no') : String(value);
+            return [headTag('meta', { name, content })];
+        }
+        if (name === 'apple-touch-icon') {
+            return [appleTouchIconTag(value)];
+        }
+        if (name === 'apple-touch-startup-image') {
+            return [headTag('link', { rel: name, href: String(value) })];
+        }
+        return [];
+    });
+};
+exports.appleHeadTags = appleHeadTags;
+const resolveManifest = (pwa, base, cwd) => {
+    var _a, _b, _c, _d;
+    const fields = Object.fromEntries(Object.entries((0, build_kit_1.objToSnakeCase)(pwa)).filter(([key]) => !NON_MANIFEST_KEYS.includes(key)));
+    const { icons, appleTags, files } = (0, exports.resolveManifestIcons)(pwa.icons, base, cwd);
+    const manifest = Object.assign(Object.assign(Object.assign({}, fields), { short_name: (_a = fields.short_name) !== null && _a !== void 0 ? _a : pwa.name, start_url: (_b = fields.start_url) !== null && _b !== void 0 ? _b : '.', scope: (_c = fields.scope) !== null && _c !== void 0 ? _c : base, display: (_d = fields.display) !== null && _d !== void 0 ? _d : 'standalone' }), (pwa.icons ? { icons } : {}));
+    return { manifest, appleTags, iconFiles: files };
+};
+exports.resolveManifest = resolveManifest;
+const createManifestPlugin = (pwa, cwd) => {
+    let base;
+    let resolved;
+    const manifestJson = () => JSON.stringify(resolved.manifest, null, 2);
+    return {
+        name: 'genesis-pwa-manifest',
+        configResolved(config) {
+            // Resolved per config so a dev restart picks up a changed PUBLIC_PATH
+            base = withTrailingSlash(typeof pwa.publicPath === 'string' ? pwa.publicPath : config.base);
+            resolved = (0, exports.resolveManifest)(pwa, base, cwd);
+        },
+        transformIndexHtml(html) {
+            const themeColor = resolved.manifest.theme_color;
+            const existing = new Set(htmlTags(html).map(({ tag, attrs }) => headTagKey(tag, attrs)));
+            const tags = [
+                headTag('link', Object.assign({ rel: 'manifest', href: `${base}${MANIFEST_FILE_NAME}` }, (pwa.crossorigin ? { crossorigin: pwa.crossorigin } : {}))),
+                ...(typeof themeColor === 'string'
+                    ? [headTag('meta', { name: 'theme-color', content: themeColor })]
+                    : []),
+                ...(0, exports.appleHeadTags)(pwa),
+                ...resolved.appleTags,
+            ].filter(({ tag, attrs }) => !existing.has(headTagKey(tag, attrs)));
+            return { html, tags };
+        },
+        configureServer(server) {
+            server.middlewares.use((req, res, next) => {
+                var _a, _b;
+                const path = (_b = (_a = req.url) === null || _a === void 0 ? void 0 : _a.split('?')[0]) !== null && _b !== void 0 ? _b : '';
+                if (path === `${base}${MANIFEST_FILE_NAME}`) {
+                    res.setHeader('Content-Type', 'application/manifest+json');
+                    res.end(manifestJson());
+                    return;
+                }
+                const iconFile = path.startsWith(base) && resolved.iconFiles.get(path.slice(base.length));
+                if (iconFile) {
+                    res.setHeader('Content-Type', (0, exports.iconMimeType)(iconFile));
+                    res.end((0, node_fs_1.readFileSync)(iconFile));
+                    return;
+                }
+                next();
+            });
+        },
+        generateBundle() {
+            this.emitFile({ type: 'asset', fileName: MANIFEST_FILE_NAME, source: manifestJson() });
+            for (const [fileName, file] of resolved.iconFiles) {
+                this.emitFile({ type: 'asset', fileName, source: (0, node_fs_1.readFileSync)(file) });
+            }
+        },
+    };
+};
+exports.createManifestPlugin = createManifestPlugin;
+const createRegistrationPlugin = (registration) => {
+    const regPath = (0, build_kit_1.getSrcRelativePath)(registration);
+    const isRegistrationScript = ({ tag, attrs }) => { var _a; return tag === 'script' && (0, build_kit_1.getSrcRelativePath)((_a = attrs.src) !== null && _a !== void 0 ? _a : '') === regPath; };
+    return {
+        name: 'genesis-sw-registration',
+        transformIndexHtml: {
+            order: 'pre',
+            handler: (html) => ({
+                html,
+                tags: htmlTags(html).some(isRegistrationScript)
+                    ? []
+                    : [
+                        {
+                            tag: 'script',
+                            attrs: { type: 'module', src: `/src/${regPath}` },
+                            injectTo: 'head',
+                        },
+                    ],
+            }),
+        },
+    };
+};
+const createDefaultRegistrationPlugin = (serviceWorker) => {
+    let url;
+    return {
+        name: 'genesis-sw-registration',
+        configResolved(config) {
+            url = (0, build_kit_1.getServiceWorkerUrl)(config.base, serviceWorker);
+        },
+        transformIndexHtml: {
+            order: 'pre',
+            handler: (html) => ({
+                html,
+                tags: [
+                    {
+                        tag: 'script',
+                        attrs: { type: 'module' },
+                        children: (0, build_kit_1.createServiceWorkerRegistration)(url),
+                        injectTo: 'head',
+                    },
+                ],
+            }),
+        },
+    };
+};
+// Matches workbox-webpack-plugin: strings are prefixes and functions receive `{ asset }`
+const excludeMatches = (url, pattern) => {
+    if (typeof pattern === 'string')
+        return url.startsWith(pattern);
+    if (pattern instanceof RegExp)
+        return pattern.test(url);
+    return pattern({ asset: { name: url } });
+};
+/**
+ * Applies `exclude` before the size limit, as workbox-webpack-plugin does, and precaches only the
+ * files in `hashedFiles` without a revision.
+ */
+const createPrecacheTransform = ({ exclude, maximumFileSizeToCache }, hashedFiles = new Set()) => (entries) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const patterns = exclude !== null && exclude !== void 0 ? exclude : DEFAULT_SW_EXCLUDE;
+    const limit = maximumFileSizeToCache || DEFAULT_MAXIMUM_FILE_SIZE_TO_CACHE;
+    const included = entries.filter(({ url }) => !patterns.some((p) => excludeMatches(url, p)));
+    const oversized = included.filter(({ size }) => size > limit);
+    return {
+        manifest: included
+            .filter((entry) => !oversized.includes(entry))
+            .map((entry) => (hashedFiles.has(entry.url) ? Object.assign(Object.assign({}, entry), { revision: null }) : entry)),
+        warnings: oversized.map(({ url, size }) => `${url} is ${size} bytes, over the serviceWorker.maximumFileSizeToCache limit of ${limit} bytes, so it won't be precached.`),
+    };
+});
+exports.createPrecacheTransform = createPrecacheTransform;
+const precacheOptions = (serviceWorker, hashedFiles) => ({
+    globPatterns: ['**/*'],
+    // Replaced by createPrecacheTransform: vite-plugin-pwa drops the revision of everything under
+    // `assets/`, including unhashed files copied from `public/assets/`
+    dontCacheBustURLsMatching: undefined,
+    maximumFileSizeToCacheInBytes: Number.MAX_SAFE_INTEGER,
+    manifestTransforms: [(0, exports.createPrecacheTransform)(serviceWorker, hashedFiles)],
+});
+const createServiceWorkerOptions = (serviceWorker, hashedFiles = new Set()) => {
+    const assetName = (0, build_kit_1.getServiceWorkerAssetName)(serviceWorker);
+    let swDest;
+    return {
+        strategies: 'injectManifest',
+        srcDir: 'src',
+        filename: (0, build_kit_1.getSrcRelativePath)(serviceWorker.worker),
+        manifest: false,
+        injectRegister: false,
+        injectManifest: Object.assign({ rollupFormat: 'iife' }, (serviceWorker.precache === false
+            ? { injectionPoint: undefined }
+            : precacheOptions(serviceWorker, hashedFiles))),
+        integration: {
+            beforeBuildServiceWorker(options) {
+                swDest = (0, node_path_1.resolve)(options.injectManifest.globDirectory, assetName);
+                options.swDest = swDest;
+                options.injectManifest.swDest = swDest;
+            },
+            // vite-plugin-pwa writes the worker under its base name to `outDir`, losing any directory
+            configureCustomSWViteBuild(inlineConfig) {
+                inlineConfig.build.outDir = (0, node_path_1.dirname)(swDest);
+            },
+        },
+    };
+};
+exports.createServiceWorkerOptions = createServiceWorkerOptions;
+// Files Rollup names land in `assetsDir` with a content hash. Assets emitted with a fixed `fileName`,
+// such as the manifest plugin's icons, keep their name, and `public/` files aren't emitted at all.
+const createHashedFilesPlugin = (hashedFiles) => {
+    let assetsDir;
+    return {
+        name: 'genesis-sw-hashed-files',
+        apply: 'build',
+        configResolved(config) {
+            assetsDir = withTrailingSlash(config.build.assetsDir);
+        },
+        buildStart() {
+            hashedFiles.clear();
+        },
+        writeBundle(_, bundle) {
+            for (const output of Object.values(bundle)) {
+                const namedByRollup = output.type === 'chunk' || output.names.length > 0;
+                if (namedByRollup && output.fileName.startsWith(assetsDir)) {
+                    hashedFiles.add(output.fileName);
+                }
+            }
+        },
+    };
+};
+const createServiceWorkerBuildPlugins = (serviceWorker) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const hashedFiles = new Set();
+    const VitePWA = yield (0, vite_js_1.getPwaModule)();
+    return [
+        createHashedFilesPlugin(hashedFiles),
+        ...VitePWA((0, exports.createServiceWorkerOptions)(serviceWorker, hashedFiles)),
+    ];
+});
+const bundleServiceWorker = (swSrc, config) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { build } = yield (0, vite_js_1.getViteModule)();
+    const result = yield build({
+        configFile: false,
+        root: config.root,
+        mode: config.mode,
+        logLevel: 'warn',
+        publicDir: false,
+        resolve: { alias: config.resolve.alias, dedupe: config.resolve.dedupe },
+        define: Object.assign(Object.assign({}, config.define), { 'process.env.NODE_ENV': JSON.stringify('development'), 'self.__WB_MANIFEST': '[]' }),
+        build: {
+            write: false,
+            minify: false,
+            emptyOutDir: false,
+            // vite-plugin-pwa's production name; `serviceWorker` is a worker-scope global
+            lib: { entry: swSrc, name: 'app', formats: ['iife'], fileName: 'service-worker' },
+        },
+    });
+    const [{ output }] = [result].flat();
+    const [chunk] = output;
+    return { code: chunk.code, moduleIds: new Set(chunk.moduleIds) };
+});
+exports.bundleServiceWorker = bundleServiceWorker;
+// Rollup reports module ids as real paths, while the dev watcher reports them as configured
+const toRealPath = (file) => {
+    try {
+        return (0, node_fs_1.realpathSync)(file);
+    }
+    catch (_a) {
+        return file;
+    }
+};
+// Serves the worker at its built URL so the app's own registration script works under `genx dev`
+const createDevServiceWorkerPlugin = (serviceWorker, cwd) => {
+    const swSrc = (0, node_path_1.resolve)(cwd, 'src', (0, build_kit_1.getSrcRelativePath)(serviceWorker.worker));
+    return {
+        name: 'genesis-sw-dev',
+        apply: 'serve',
+        configureServer(server) {
+            const url = (0, build_kit_1.getServiceWorkerUrl)(server.config.base, serviceWorker);
+            let worker;
+            let moduleIds = new Set();
+            const changesDuringBundles = new Set();
+            server.watcher.on('change', (file) => {
+                const id = toRealPath(file);
+                for (const changes of changesDuringBundles)
+                    changes.add(id);
+                if (moduleIds.has(id))
+                    worker = undefined;
+            });
+            const bundle = () => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                const changes = new Set();
+                changesDuringBundles.add(changes);
+                try {
+                    const bundled = yield (0, exports.bundleServiceWorker)(swSrc, server.config);
+                    moduleIds = bundled.moduleIds;
+                    if ([...changes].some((id) => moduleIds.has(id)))
+                        worker = undefined;
+                    return bundled;
+                }
+                finally {
+                    changesDuringBundles.delete(changes);
+                }
+            });
+            server.middlewares.use((req, res, next) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                var _a;
+                if (((_a = req.url) === null || _a === void 0 ? void 0 : _a.split('?')[0]) !== url)
+                    return next();
+                try {
+                    worker !== null && worker !== void 0 ? worker : (worker = bundle());
+                    const { code } = yield worker;
+                    res.setHeader('Content-Type', 'text/javascript');
+                    res.end(code);
+                }
+                catch (error) {
+                    worker = undefined;
+                    next(error);
+                }
+            }));
+        },
+    };
+};
+const resolvePwaPlugins = (ctx) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { config: { pwa, serviceWorker }, dirs: { cwd }, cli: { isDev }, } = ctx;
+    const plugins = [];
+    if (pwa) {
+        plugins.push((0, exports.createManifestPlugin)(pwa, cwd));
+    }
+    if (serviceWorker) {
+        const { registration } = serviceWorker;
+        if (registration) {
+            plugins.push(createRegistrationPlugin(registration));
+        }
+        else if (registration !== false) {
+            plugins.push(createDefaultRegistrationPlugin(serviceWorker));
+        }
+        plugins.push(...(isDev
+            ? [createDevServiceWorkerPlugin(serviceWorker, cwd)]
+            : yield createServiceWorkerBuildPlugins(serviceWorker)));
+    }
+    return plugins;
+});
+exports.resolvePwaPlugins = resolvePwaPlugins;

package/dist/vite.d.ts

@@ -1,8 +1,10 @@
 import { Plugin } from 'vite';
+import type { VitePWAOptions } from 'vite-plugin-pwa';
 export declare const getHandlebarsModule: () => Promise<(...args: any) => Promise<Plugin>>;
 export declare const getCheckerModule: () => Promise<(...args: any) => Plugin>;
 export declare const getViteModule: () => Promise<{
     build: any;
     createServer: any;
 }>;
+export declare const getPwaModule: () => Promise<(options: Partial<VitePWAOptions>) => Plugin[]>;
 //# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAW9B,eAAO,MAAM,mBAAmB,0BACuC,GAAG,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA,CAAC;AAE/F,eAAO,MAAM,gBAAgB,0BACuC,GAAG,KAAK,MAAM,CAAA,CAAC;AAEnF,eAAO,MAAM,aAAa;;;EAMzB,CAAC"}
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAWtD,eAAO,MAAM,mBAAmB,0BACuC,GAAG,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA,CAAC;AAE/F,eAAO,MAAM,gBAAgB,0BACuC,GAAG,KAAK,MAAM,CAAA,CAAC;AAEnF,eAAO,MAAM,aAAa;;;EAMzB,CAAC;AAEF,eAAO,MAAM,YAAY,0BAEZ,OAAO,CAAC,cAAc,CAAC,KAC7B,MAAM,EAAE,CAAA,CAAC"}

package/dist/vite.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getViteModule = exports.getCheckerModule = exports.getHandlebarsModule = void 0;
+exports.getPwaModule = exports.getViteModule = exports.getCheckerModule = exports.getHandlebarsModule = void 0;
 const tslib_1 = require("tslib");
 /**
  * This is a glue layer to import the ESM modules into the commonjs plugin.
@@ -22,3 +22,7 @@ const getViteModule = () => tslib_1.__awaiter(void 0, void 0, void 0, function*
     };
 });
 exports.getViteModule = getViteModule;
+const getPwaModule = () => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    return (yield dynamicImport('vite-plugin-pwa')).VitePWA;
+});
+exports.getPwaModule = getPwaModule;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/vite-builder",
   "description": "Vite builder",
-  "version": "15.80.0",
+  "version": "15.81.0",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,16 +12,24 @@
     "build": "npm run clean && tsc -b ./tsconfig.json",
     "clean": "rimraf dist temp tsconfig.tsbuildinfo",
     "dev": "tsc -b ./tsconfig.json -w",
+    "test": "uvu -r tsx/cjs test 'test.ts'",
     "lint": "genx lint -l ox",
     "lint:fix": "genx lint -l ox --fix"
   },
+  "devDependencies": {
+    "tsx": "^4.7.0",
+    "uvu": "0.5.6"
+  },
   "dependencies": {
-    "@genesislcap/build-kit": "15.80.0",
+    "@genesislcap/build-kit": "15.81.0",
     "consola": "^3.0.2",
     "copyfiles": "^2.4.1",
     "vite": "^7.2.2",
     "vite-plugin-checker": "^0.11.0",
-    "vite-plugin-handlebars": "^2.0.3"
+    "vite-plugin-handlebars": "^2.0.3",
+    "vite-plugin-pwa": "^2.0.0",
+    "workbox-build": "^7.4.1",
+    "workbox-window": "^7.4.1"
   },
   "repository": {
     "type": "git",