@joystyk/pwa 0.0.0-stage → 0.2.0

package/dist/control.js

@@ -0,0 +1,88 @@
+import { decodeSync, isRecord, validator } from "./validate.js";
+//#region src/control.ts
+/** An RFC 3339 date-time with seconds and a zone: what `git show -s --format=%cI` prints, or UTC. */
+var RELEASE_TIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?(?:Z|[+-]\d{2}:\d{2})$/;
+/** A release time in milliseconds since the epoch, or null when it isn't a valid date-time. */
+var releaseTimeMs = (value) => {
+	if (typeof value !== "string" || !RELEASE_TIME.test(value)) return null;
+	const ms = Date.parse(value);
+	return Number.isNaN(ms) ? null : ms;
+};
+/** A release time in its canonical form: UTC, whole seconds, e.g. "2026-10-09T14:03:12Z". */
+var canonicalReleaseTime = (value) => {
+	const ms = releaseTimeMs(value);
+	return ms === null ? null : `${(/* @__PURE__ */ new Date(Math.floor(ms / 1e3) * 1e3)).toISOString().slice(0, 19)}Z`;
+};
+var ControlSchema = validator((value, issues) => {
+	if (!isRecord(value)) {
+		issues.push("Expected an object");
+		return;
+	}
+	const { schemaVersion, serviceWorker, minimumRelease } = value;
+	if (schemaVersion !== 1) issues.push("schemaVersion: expected 1");
+	if (serviceWorker !== "enabled" && serviceWorker !== "disabled") issues.push("serviceWorker: expected \"enabled\" or \"disabled\"");
+	if (minimumRelease !== void 0 && releaseTimeMs(minimumRelease) === null) issues.push("minimumRelease: expected a date-time such as \"2026-10-09T14:03:12Z\"");
+	if (issues.length > 0) return void 0;
+	const control = {
+		schemaVersion: 1,
+		serviceWorker
+	};
+	return minimumRelease === void 0 ? control : {
+		...control,
+		minimumRelease
+	};
+});
+var DEFAULT_CONTROL = {
+	schemaVersion: 1,
+	serviceWorker: "enabled"
+};
+/**
+* What the flag file says. Anything unreadable, a network failure included, reads as "no
+* instruction": a broken flag file must not wipe every player's offline games, and a page
+* that can't reach the server keeps playing.
+*/
+var parseControl = (value) => decodeSync(ControlSchema, value);
+var isDisabled = (control) => control?.serviceWorker === "disabled";
+/**
+* True when a page running the release built at `releaseTime` must update now: the flag
+* file names a minimum release, and this one is older. An unreadable time on either side
+* never forces anything.
+*/
+var mustUpdate = (control, releaseTime) => {
+	const minimum = releaseTimeMs(control?.minimumRelease);
+	const own = releaseTimeMs(releaseTime);
+	return minimum !== null && own !== null && own < minimum;
+};
+/**
+* The flag file as the server running `releaseTime` serves it: a minimum later than that
+* release comes down to it. Raising the minimum past what the site serves would otherwise
+* send every page into a reload that can never reach a new enough release.
+*/
+var capMinimumRelease = (control, releaseTime) => {
+	const minimum = releaseTimeMs(control.minimumRelease);
+	const own = releaseTimeMs(releaseTime);
+	if (minimum === null || own === null || minimum <= own) return control;
+	return {
+		...control,
+		minimumRelease: releaseTime
+	};
+};
+var RELEASE_RECORD_FILE = "release.json";
+var ReleaseRecordSchema = validator((value, issues) => {
+	if (!isRecord(value)) {
+		issues.push("Expected an object");
+		return;
+	}
+	const { release, releaseTime } = value;
+	if (typeof release !== "string" || release === "") issues.push("release: expected text");
+	if (releaseTimeMs(releaseTime) === null) issues.push("releaseTime: expected a date-time");
+	return issues.length === 0 ? {
+		release,
+		releaseTime
+	} : void 0;
+});
+var parseReleaseRecord = (value) => decodeSync(ReleaseRecordSchema, value);
+//#endregion
+export { ControlSchema, DEFAULT_CONTROL, RELEASE_RECORD_FILE, ReleaseRecordSchema, canonicalReleaseTime, capMinimumRelease, isDisabled, mustUpdate, parseControl, parseReleaseRecord, releaseTimeMs };
+
+//# sourceMappingURL=control.js.map

package/dist/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","names":[],"sources":["../src/control.ts"],"sourcesContent":["// The flag file (offline-and-updates.md, Rules 2 and 5): a small `no-cache` JSON file the site\n// serves at /pwa-control.json, which operators change without a deploy. It carries two flags.\n//\n// - The kill switch. When it says the worker is disabled, pages stop registering it, and\n//   every installed worker unregisters itself and deletes the PWA's caches. Saves and other\n//   IndexedDB data are never touched.\n// - The minimum release, for forced security updates. A page whose release is older shows a\n//   blocking notice, saves the game and reloads into the current release.\n//\n// Releases are ordered by their release time: the UTC time of the commit a release is built\n// from (apps/site/vite.config.ts). Release IDs are commit hashes, which have no order.\nimport { decodeSync, isRecord, validator } from './validate.ts';\n\nexport type Control = {\n  readonly schemaVersion: 1;\n  readonly serviceWorker: 'enabled' | 'disabled';\n  /**\n   * The release time of the oldest release that may keep running, as an RFC 3339 date-time\n   * such as \"2026-10-09T14:03:12Z\". An open page from an older release must update.\n   */\n  readonly minimumRelease?: string;\n};\n\n/** An RFC 3339 date-time with seconds and a zone: what `git show -s --format=%cI` prints, or UTC. */\nconst RELEASE_TIME = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,9})?(?:Z|[+-]\\d{2}:\\d{2})$/;\n\n/** A release time in milliseconds since the epoch, or null when it isn't a valid date-time. */\nexport const releaseTimeMs = (value: unknown): number | null => {\n  if (typeof value !== 'string' || !RELEASE_TIME.test(value)) return null;\n  const ms = Date.parse(value);\n  return Number.isNaN(ms) ? null : ms;\n};\n\n/** A release time in its canonical form: UTC, whole seconds, e.g. \"2026-10-09T14:03:12Z\". */\nexport const canonicalReleaseTime = (value: string): string | null => {\n  const ms = releaseTimeMs(value);\n  return ms === null ? null : `${new Date(Math.floor(ms / 1000) * 1000).toISOString().slice(0, 19)}Z`;\n};\n\nexport const ControlSchema = validator<Control>((value, issues) => {\n  if (!isRecord(value)) {\n    issues.push('Expected an object');\n    return undefined;\n  }\n  const { schemaVersion, serviceWorker, minimumRelease } = value;\n  if (schemaVersion !== 1) issues.push('schemaVersion: expected 1');\n  if (serviceWorker !== 'enabled' && serviceWorker !== 'disabled')\n    issues.push('serviceWorker: expected \"enabled\" or \"disabled\"');\n  if (minimumRelease !== undefined && releaseTimeMs(minimumRelease) === null) {\n    issues.push('minimumRelease: expected a date-time such as \"2026-10-09T14:03:12Z\"');\n  }\n  if (issues.length > 0) return undefined;\n  const control: Control = { schemaVersion: 1, serviceWorker: serviceWorker as Control['serviceWorker'] };\n  return minimumRelease === undefined ? control : { ...control, minimumRelease: minimumRelease as string };\n});\n\nexport const DEFAULT_CONTROL: Control = { schemaVersion: 1, serviceWorker: 'enabled' };\n\n/**\n * What the flag file says. Anything unreadable, a network failure included, reads as \"no\n * instruction\": a broken flag file must not wipe every player's offline games, and a page\n * that can't reach the server keeps playing.\n */\nexport const parseControl = (value: unknown): Control | null => decodeSync(ControlSchema, value);\n\nexport const isDisabled = (control: Control | null): boolean => control?.serviceWorker === 'disabled';\n\n/**\n * True when a page running the release built at `releaseTime` must update now: the flag\n * file names a minimum release, and this one is older. An unreadable time on either side\n * never forces anything.\n */\nexport const mustUpdate = (control: Control | null, releaseTime: string): boolean => {\n  const minimum = releaseTimeMs(control?.minimumRelease);\n  const own = releaseTimeMs(releaseTime);\n  return minimum !== null && own !== null && own < minimum;\n};\n\n/**\n * The flag file as the server running `releaseTime` serves it: a minimum later than that\n * release comes down to it. Raising the minimum past what the site serves would otherwise\n * send every page into a reload that can never reach a new enough release.\n */\nexport const capMinimumRelease = (control: Control, releaseTime: string): Control => {\n  const minimum = releaseTimeMs(control.minimumRelease);\n  const own = releaseTimeMs(releaseTime);\n  if (minimum === null || own === null || minimum <= own) return control;\n  return { ...control, minimumRelease: releaseTime };\n};\n\n/**\n * The build's record of its release, written beside `sw.js` as `release.json` and never\n * served: the site reads it to cap the minimum release it serves.\n */\nexport type ReleaseRecord = {\n  readonly release: string;\n  /** Canonical: UTC, whole seconds. */\n  readonly releaseTime: string;\n};\n\nexport const RELEASE_RECORD_FILE = 'release.json';\n\nexport const ReleaseRecordSchema = validator<ReleaseRecord>((value, issues) => {\n  if (!isRecord(value)) {\n    issues.push('Expected an object');\n    return undefined;\n  }\n  const { release, releaseTime } = value;\n  if (typeof release !== 'string' || release === '') issues.push('release: expected text');\n  if (releaseTimeMs(releaseTime) === null) issues.push('releaseTime: expected a date-time');\n  return issues.length === 0 ? { release: release as string, releaseTime: releaseTime as string } : undefined;\n});\n\nexport const parseReleaseRecord = (value: unknown): ReleaseRecord | null => decodeSync(ReleaseRecordSchema, value);\n"],"mappings":";;;AAwBA,IAAM,eAAe;;AAGrB,IAAa,iBAAiB,UAAkC;CAC9D,IAAI,OAAO,UAAU,YAAY,CAAC,aAAa,KAAK,KAAK,GAAG,OAAO;CACnE,MAAM,KAAK,KAAK,MAAM,KAAK;CAC3B,OAAO,OAAO,MAAM,EAAE,IAAI,OAAO;AACnC;;AAGA,IAAa,wBAAwB,UAAiC;CACpE,MAAM,KAAK,cAAc,KAAK;CAC9B,OAAO,OAAO,OAAO,OAAO,oBAAG,IAAI,KAAK,KAAK,MAAM,KAAK,GAAI,IAAI,GAAI,EAAA,CAAE,YAAY,CAAC,CAAC,MAAM,GAAG,EAAE,EAAE;AACnG;AAEA,IAAa,gBAAgB,WAAoB,OAAO,WAAW;CACjE,IAAI,CAAC,SAAS,KAAK,GAAG;EACpB,OAAO,KAAK,oBAAoB;EAChC;CACF;CACA,MAAM,EAAE,eAAe,eAAe,mBAAmB;CACzD,IAAI,kBAAkB,GAAG,OAAO,KAAK,2BAA2B;CAChE,IAAI,kBAAkB,aAAa,kBAAkB,YACnD,OAAO,KAAK,qDAAiD;CAC/D,IAAI,mBAAmB,KAAA,KAAa,cAAc,cAAc,MAAM,MACpE,OAAO,KAAK,uEAAqE;CAEnF,IAAI,OAAO,SAAS,GAAG,OAAO,KAAA;CAC9B,MAAM,UAAmB;EAAE,eAAe;EAAkB;CAA0C;CACtG,OAAO,mBAAmB,KAAA,IAAY,UAAU;EAAE,GAAG;EAAyB;CAAyB;AACzG,CAAC;AAED,IAAa,kBAA2B;CAAE,eAAe;CAAG,eAAe;AAAU;;;;;;AAOrF,IAAa,gBAAgB,UAAmC,WAAW,eAAe,KAAK;AAE/F,IAAa,cAAc,YAAqC,SAAS,kBAAkB;;;;;;AAO3F,IAAa,cAAc,SAAyB,gBAAiC;CACnF,MAAM,UAAU,cAAc,SAAS,cAAc;CACrD,MAAM,MAAM,cAAc,WAAW;CACrC,OAAO,YAAY,QAAQ,QAAQ,QAAQ,MAAM;AACnD;;;;;;AAOA,IAAa,qBAAqB,SAAkB,gBAAiC;CACnF,MAAM,UAAU,cAAc,QAAQ,cAAc;CACpD,MAAM,MAAM,cAAc,WAAW;CACrC,IAAI,YAAY,QAAQ,QAAQ,QAAQ,WAAW,KAAK,OAAO;CAC/D,OAAO;EAAE,GAAG;EAAS,gBAAgB;CAAY;AACnD;AAYA,IAAa,sBAAsB;AAEnC,IAAa,sBAAsB,WAA0B,OAAO,WAAW;CAC7E,IAAI,CAAC,SAAS,KAAK,GAAG;EACpB,OAAO,KAAK,oBAAoB;EAChC;CACF;CACA,MAAM,EAAE,SAAS,gBAAgB;CACjC,IAAI,OAAO,YAAY,YAAY,YAAY,IAAI,OAAO,KAAK,wBAAwB;CACvF,IAAI,cAAc,WAAW,MAAM,MAAM,OAAO,KAAK,mCAAmC;CACxF,OAAO,OAAO,WAAW,IAAI;EAAW;EAAgC;CAAsB,IAAI,KAAA;AACpG,CAAC;AAED,IAAa,sBAAsB,UAAyC,WAAW,qBAAqB,KAAK"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { ASSET_MANIFEST_VERSION, AssetFileSchema, FILE_KINDS, formatBytes, GameAssetManifestSchema, parseAssetManifest, planPin, referencedAssets, type AssetFile, type FileKind, type GameAssetManifest, type PinPlan, } from './asset-manifest.js';
+export { markOfflineHtml, markOfflineResponse } from './offline-mark.js';
+export { parsePinRecord, PinRecordSchema, type PinRecord } from './pin-record.js';
+export { canonicalReleaseTime, capMinimumRelease, ControlSchema, DEFAULT_CONTROL, isDisabled, mustUpdate, parseControl, parseReleaseRecord, RELEASE_RECORD_FILE, ReleaseRecordSchema, releaseTimeMs, type Control, type ReleaseRecord, } from './control.js';
+export { CONTROL_URL, isPwaCache, MESSAGES, OFFLINE_ATTRIBUTE, OFFLINE_URL, parsePinnedCacheName, PIN_RECORD_PATH, pinnedCacheName, PRECACHE_NAME, PRECACHE_PREFIX, RECENT_KINDS, recentCacheName, SW_URL, WEB_MANIFEST_URL, type RecentKind, } from './names.js';
+export { ASSETS_PREFIX, fileKind, RECENT_LIMITS, routeFor, shouldOfferUpdate, type PromptInput, type Route, type RouteInput, } from './routing.js';
+export { decodeSync, validator } from './validate.js';

package/dist/index.js

@@ -0,0 +1,8 @@
+import { CONTROL_URL, MESSAGES, OFFLINE_ATTRIBUTE, OFFLINE_URL, PIN_RECORD_PATH, PRECACHE_NAME, PRECACHE_PREFIX, RECENT_KINDS, SW_URL, WEB_MANIFEST_URL, isPwaCache, parsePinnedCacheName, pinnedCacheName, recentCacheName } from "./names.js";
+import { ASSETS_PREFIX, RECENT_LIMITS, fileKind, routeFor, shouldOfferUpdate } from "./routing.js";
+import { ASSET_MANIFEST_VERSION, AssetFileSchema, FILE_KINDS, GameAssetManifestSchema, formatBytes, parseAssetManifest, planPin, referencedAssets } from "./asset-manifest.js";
+import { decodeSync, validator } from "./validate.js";
+import { ControlSchema, DEFAULT_CONTROL, RELEASE_RECORD_FILE, ReleaseRecordSchema, canonicalReleaseTime, capMinimumRelease, isDisabled, mustUpdate, parseControl, parseReleaseRecord, releaseTimeMs } from "./control.js";
+import { PinRecordSchema, parsePinRecord } from "./pin-record.js";
+import { markOfflineHtml, markOfflineResponse } from "./offline-mark.js";
+export { ASSETS_PREFIX, ASSET_MANIFEST_VERSION, AssetFileSchema, CONTROL_URL, ControlSchema, DEFAULT_CONTROL, FILE_KINDS, GameAssetManifestSchema, MESSAGES, OFFLINE_ATTRIBUTE, OFFLINE_URL, PIN_RECORD_PATH, PRECACHE_NAME, PRECACHE_PREFIX, PinRecordSchema, RECENT_KINDS, RECENT_LIMITS, RELEASE_RECORD_FILE, ReleaseRecordSchema, SW_URL, WEB_MANIFEST_URL, canonicalReleaseTime, capMinimumRelease, decodeSync, fileKind, formatBytes, isDisabled, isPwaCache, markOfflineHtml, markOfflineResponse, mustUpdate, parseAssetManifest, parseControl, parsePinRecord, parsePinnedCacheName, parseReleaseRecord, pinnedCacheName, planPin, recentCacheName, referencedAssets, releaseTimeMs, routeFor, shouldOfferUpdate, validator };

package/dist/names.d.ts

@@ -0,0 +1,47 @@
+/** Tier 1: Workbox's precache, one per release; Workbox tracks revisions inside it. */
+export declare const PRECACHE_PREFIX = "joystyk";
+export declare const PRECACHE_NAME = "shell";
+/** Tier 2 kinds: each has its own capped cache. */
+export declare const RECENT_KINDS: readonly ["code", "art", "audio", "wasm"];
+export type RecentKind = (typeof RECENT_KINDS)[number];
+/** Bump the suffix when a Tier 2 cache's contents change shape; old ones are then deleted. */
+export declare const recentCacheName: (kind: RecentKind) => string;
+/** Tier 3: one cache per pinned game build, `game:<id>:<version>` (offline-and-updates.md). */
+export declare const pinnedCacheName: (id: string, version: string) => string;
+/** The game and version a pinned cache holds, or null for any other cache. */
+export declare const parsePinnedCacheName: (name: string) => {
+    readonly id: string;
+    readonly version: string;
+} | null;
+/** Every cache this site's PWA may create; the kill switch deletes them all. */
+export declare const isPwaCache: (name: string) => boolean;
+/** The service worker's own URL. Always served `no-cache`. */
+export declare const SW_URL = "/sw.js";
+/** The kill-switch flag file. Always served `no-cache`. */
+export declare const CONTROL_URL = "/pwa-control.json";
+/** The offline fallback page. */
+export declare const OFFLINE_URL = "/offline";
+/**
+ * The attribute the worker adds to the <html> tag of a page it answers from a cache because
+ * the network failed (offline-mark.ts). @joystyk/ui's tokens.css reads it to keep ad slots
+ * collapsed from the first paint.
+ */
+export declare const OFFLINE_ATTRIBUTE = "data-offline";
+/** The web app manifest. */
+export declare const WEB_MANIFEST_URL = "/manifest.webmanifest";
+/**
+ * Inside each pinned cache, the pin's own record (game name, version, asset list URL) lives
+ * at this path. No request ever asks for it, so routing never serves it.
+ */
+export declare const PIN_RECORD_PATH = "/.joystyk-pin.json";
+/** Messages between the page and the worker. */
+export declare const MESSAGES: {
+    /** Page → waiting worker: the player accepted the update. */
+    readonly skipWaiting: "SKIP_WAITING";
+    /** Page → worker: read the flag file now. */
+    readonly checkControl: "CHECK_CONTROL";
+    /** Page → worker, with a MessagePort: which release are you? */
+    readonly release: "GET_RELEASE";
+    /** Worker → pages: the kill switch fired; the worker unregistered and cleared its caches. */
+    readonly disabled: "PWA_DISABLED";
+};

package/dist/names.js

@@ -0,0 +1,64 @@
+//#region src/names.ts
+/** Tier 1: Workbox's precache, one per release; Workbox tracks revisions inside it. */
+var PRECACHE_PREFIX = "joystyk";
+var PRECACHE_NAME = "shell";
+/** Tier 2 kinds: each has its own capped cache. */
+var RECENT_KINDS = [
+	"code",
+	"art",
+	"audio",
+	"wasm"
+];
+/** Bump the suffix when a Tier 2 cache's contents change shape; old ones are then deleted. */
+var recentCacheName = (kind) => `recent:${kind}:v1`;
+var PINNED = /^game:([a-z0-9]+(?:-[a-z0-9]+)*):([0-9A-Za-z.+-]+)$/;
+/** Tier 3: one cache per pinned game build, `game:<id>:<version>` (offline-and-updates.md). */
+var pinnedCacheName = (id, version) => {
+	const name = `game:${id}:${version}`;
+	if (!PINNED.test(name)) throw new RangeError(`Can't name a pinned cache for game ${JSON.stringify(id)} at version ${JSON.stringify(version)}.`);
+	return name;
+};
+/** The game and version a pinned cache holds, or null for any other cache. */
+var parsePinnedCacheName = (name) => {
+	const match = PINNED.exec(name);
+	return match === null ? null : {
+		id: match[1] ?? "",
+		version: match[2] ?? ""
+	};
+};
+/** Every cache this site's PWA may create; the kill switch deletes them all. */
+var isPwaCache = (name) => name.startsWith(`joystyk-`) || name.startsWith("recent:") || name.startsWith("game:") || name.startsWith("workbox-");
+/** The service worker's own URL. Always served `no-cache`. */
+var SW_URL = "/sw.js";
+/** The kill-switch flag file. Always served `no-cache`. */
+var CONTROL_URL = "/pwa-control.json";
+/** The offline fallback page. */
+var OFFLINE_URL = "/offline";
+/**
+* The attribute the worker adds to the <html> tag of a page it answers from a cache because
+* the network failed (offline-mark.ts). @joystyk/ui's tokens.css reads it to keep ad slots
+* collapsed from the first paint.
+*/
+var OFFLINE_ATTRIBUTE = "data-offline";
+/** The web app manifest. */
+var WEB_MANIFEST_URL = "/manifest.webmanifest";
+/**
+* Inside each pinned cache, the pin's own record (game name, version, asset list URL) lives
+* at this path. No request ever asks for it, so routing never serves it.
+*/
+var PIN_RECORD_PATH = "/.joystyk-pin.json";
+/** Messages between the page and the worker. */
+var MESSAGES = {
+	/** Page → waiting worker: the player accepted the update. */
+	skipWaiting: "SKIP_WAITING",
+	/** Page → worker: read the flag file now. */
+	checkControl: "CHECK_CONTROL",
+	/** Page → worker, with a MessagePort: which release are you? */
+	release: "GET_RELEASE",
+	/** Worker → pages: the kill switch fired; the worker unregistered and cleared its caches. */
+	disabled: "PWA_DISABLED"
+};
+//#endregion
+export { CONTROL_URL, MESSAGES, OFFLINE_ATTRIBUTE, OFFLINE_URL, PIN_RECORD_PATH, PRECACHE_NAME, PRECACHE_PREFIX, RECENT_KINDS, SW_URL, WEB_MANIFEST_URL, isPwaCache, parsePinnedCacheName, pinnedCacheName, recentCacheName };
+
+//# sourceMappingURL=names.js.map

package/dist/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","names":[],"sources":["../src/names.ts"],"sourcesContent":["// Cache names and fixed URLs, shared by the service worker, the page and the build. Every\n// cache the PWA owns says what it holds and, where it can go stale, which version\n// (offline-and-updates.md, \"Cache tiers\"), so cleanup after an update is exact.\n\n/** Tier 1: Workbox's precache, one per release; Workbox tracks revisions inside it. */\nexport const PRECACHE_PREFIX = 'joystyk';\nexport const PRECACHE_NAME = 'shell';\n\n/** Tier 2 kinds: each has its own capped cache. */\nexport const RECENT_KINDS = ['code', 'art', 'audio', 'wasm'] as const;\nexport type RecentKind = (typeof RECENT_KINDS)[number];\n\n/** Bump the suffix when a Tier 2 cache's contents change shape; old ones are then deleted. */\nexport const recentCacheName = (kind: RecentKind): string => `recent:${kind}:v1`;\n\nconst PINNED = /^game:([a-z0-9]+(?:-[a-z0-9]+)*):([0-9A-Za-z.+-]+)$/;\n\n/** Tier 3: one cache per pinned game build, `game:<id>:<version>` (offline-and-updates.md). */\nexport const pinnedCacheName = (id: string, version: string): string => {\n  const name = `game:${id}:${version}`;\n  if (!PINNED.test(name))\n    throw new RangeError(\n      `Can't name a pinned cache for game ${JSON.stringify(id)} at version ${JSON.stringify(version)}.`,\n    );\n  return name;\n};\n\n/** The game and version a pinned cache holds, or null for any other cache. */\nexport const parsePinnedCacheName = (name: string): { readonly id: string; readonly version: string } | null => {\n  const match = PINNED.exec(name);\n  return match === null ? null : { id: match[1] ?? '', version: match[2] ?? '' };\n};\n\n/** Every cache this site's PWA may create; the kill switch deletes them all. */\nexport const isPwaCache = (name: string): boolean =>\n  name.startsWith(`${PRECACHE_PREFIX}-`) ||\n  name.startsWith('recent:') ||\n  name.startsWith('game:') ||\n  name.startsWith('workbox-');\n\n/** The service worker's own URL. Always served `no-cache`. */\nexport const SW_URL = '/sw.js';\n/** The kill-switch flag file. Always served `no-cache`. */\nexport const CONTROL_URL = '/pwa-control.json';\n/** The offline fallback page. */\nexport const OFFLINE_URL = '/offline';\n/**\n * The attribute the worker adds to the <html> tag of a page it answers from a cache because\n * the network failed (offline-mark.ts). @joystyk/ui's tokens.css reads it to keep ad slots\n * collapsed from the first paint.\n */\nexport const OFFLINE_ATTRIBUTE = 'data-offline';\n/** The web app manifest. */\nexport const WEB_MANIFEST_URL = '/manifest.webmanifest';\n/**\n * Inside each pinned cache, the pin's own record (game name, version, asset list URL) lives\n * at this path. No request ever asks for it, so routing never serves it.\n */\nexport const PIN_RECORD_PATH = '/.joystyk-pin.json';\n\n/** Messages between the page and the worker. */\nexport const MESSAGES = {\n  /** Page → waiting worker: the player accepted the update. */\n  skipWaiting: 'SKIP_WAITING',\n  /** Page → worker: read the flag file now. */\n  checkControl: 'CHECK_CONTROL',\n  /** Page → worker, with a MessagePort: which release are you? */\n  release: 'GET_RELEASE',\n  /** Worker → pages: the kill switch fired; the worker unregistered and cleared its caches. */\n  disabled: 'PWA_DISABLED',\n} as const;\n"],"mappings":";;AAKA,IAAa,kBAAkB;AAC/B,IAAa,gBAAgB;;AAG7B,IAAa,eAAe;CAAC;CAAQ;CAAO;CAAS;AAAM;;AAI3D,IAAa,mBAAmB,SAA6B,UAAU,KAAK;AAE5E,IAAM,SAAS;;AAGf,IAAa,mBAAmB,IAAY,YAA4B;CACtE,MAAM,OAAO,QAAQ,GAAG,GAAG;CAC3B,IAAI,CAAC,OAAO,KAAK,IAAI,GACnB,MAAM,IAAI,WACR,sCAAsC,KAAK,UAAU,EAAE,EAAE,cAAc,KAAK,UAAU,OAAO,EAAE,EACjG;CACF,OAAO;AACT;;AAGA,IAAa,wBAAwB,SAA2E;CAC9G,MAAM,QAAQ,OAAO,KAAK,IAAI;CAC9B,OAAO,UAAU,OAAO,OAAO;EAAE,IAAI,MAAM,MAAM;EAAI,SAAS,MAAM,MAAM;CAAG;AAC/E;;AAGA,IAAa,cAAc,SACzB,KAAK,WAAW,UAAqB,KACrC,KAAK,WAAW,SAAS,KACzB,KAAK,WAAW,OAAO,KACvB,KAAK,WAAW,UAAU;;AAG5B,IAAa,SAAS;;AAEtB,IAAa,cAAc;;AAE3B,IAAa,cAAc;;;;;;AAM3B,IAAa,oBAAoB;;AAEjC,IAAa,mBAAmB;;;;;AAKhC,IAAa,kBAAkB;;AAG/B,IAAa,WAAW;;CAEtB,aAAa;;CAEb,cAAc;;CAEd,SAAS;;CAET,UAAU;AACZ"}

package/dist/offline/offline.css

@@ -0,0 +1,94 @@
+/* The offline page stands alone: it can't count on the site's inlined stylesheets, so it
+   carries the few Joystyk colors it needs. */
+:root {
+  color-scheme: light dark;
+  --surface: light-dark(oklch(98.5% 0.006 285), oklch(17% 0.02 285));
+  --text: light-dark(oklch(22% 0.03 285), oklch(94% 0.012 285));
+  --muted: color-mix(in oklch, var(--text) 68%, var(--surface));
+  --accent: light-dark(oklch(50% 0.2 285), oklch(76% 0.13 285));
+  --on-accent: light-dark(oklch(99% 0.005 285), oklch(18% 0.03 285));
+  --magenta: oklch(68% 0.25 350);
+}
+
+body {
+  margin: 0;
+  background: var(--surface);
+  color: var(--text);
+  font-family: system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif;
+  font-size: 1.0625rem;
+  line-height: 1.5;
+}
+
+main {
+  max-inline-size: 40rem;
+  margin-inline: auto;
+  padding: 2rem 1rem 3rem;
+}
+
+.kicker {
+  margin: 0;
+  font-weight: 800;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+  color: var(--magenta);
+}
+
+h1 {
+  margin-block: 0.25rem 0.5rem;
+  font-size: clamp(1.9rem, 1.5rem + 2vw, 2.8rem);
+  line-height: 1.1;
+}
+
+h2 {
+  font-size: 1.25rem;
+  margin-block: 2rem 0.5rem;
+}
+
+.lede,
+#none {
+  color: var(--muted);
+}
+
+a {
+  color: var(--accent);
+}
+
+#games {
+  padding-inline-start: 1.25rem;
+}
+
+#games a {
+  display: inline-block;
+  min-block-size: 2.75rem;
+  padding-block: 0.6rem;
+  font-weight: 600;
+}
+
+.actions {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 1rem;
+  margin-block-start: 2rem;
+}
+
+button {
+  min-block-size: 2.75rem;
+  padding: 0.25rem 1.25rem;
+  border: 0;
+  border-radius: 999px;
+  background: var(--accent);
+  color: var(--on-accent);
+  font: inherit;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+:focus-visible {
+  outline: 3px solid var(--accent);
+  outline-offset: 2px;
+}
+
+[hidden] {
+  display: none !important;
+}

package/dist/offline/offline.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/offline/offline.js

@@ -0,0 +1,26 @@
+import "../names.js";
+import { pinnedGames } from "../client/pinned.js";
+//#region src/offline/offline.ts
+var where = document.getElementById("where");
+var list = document.getElementById("games");
+var none = document.getElementById("none");
+if (where !== null && location.pathname !== "/offline") where.textContent = `This page (${decodeURI(location.pathname)}) isn't available offline. It needs an internet connection.`;
+document.getElementById("retry")?.addEventListener("click", () => location.reload());
+(async () => {
+	if (list === null || none === null || !("caches" in window)) return;
+	const games = await pinnedGames().catch(() => []);
+	for (const game of games) {
+		const item = document.createElement("li");
+		const link = document.createElement("a");
+		link.href = game.page;
+		link.textContent = game.name;
+		item.append(link);
+		list.append(item);
+	}
+	list.hidden = games.length === 0;
+	none.hidden = games.length > 0;
+})();
+//#endregion
+export {};
+
+//# sourceMappingURL=offline.js.map

package/dist/offline/offline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline.js","names":[],"sources":["../../src/offline/offline.ts"],"sourcesContent":["// The offline page's script: lists the games this device can play offline, read from the\n// pinned caches' own records. The worker serves this page, precached, for any page that\n// failed to load, so it also names the page that wasn't available.\nimport { OFFLINE_URL } from '../names.ts';\nimport { pinnedGames } from '../client/pinned.ts';\n\nconst where = document.getElementById('where');\nconst list = document.getElementById('games');\nconst none = document.getElementById('none');\n\nif (where !== null && location.pathname !== OFFLINE_URL) {\n  where.textContent = `This page (${decodeURI(location.pathname)}) isn't available offline. It needs an internet connection.`;\n}\n\ndocument.getElementById('retry')?.addEventListener('click', () => location.reload());\n\nvoid (async () => {\n  if (list === null || none === null || !('caches' in window)) return;\n  const games = await pinnedGames().catch(() => []);\n  for (const game of games) {\n    const item = document.createElement('li');\n    const link = document.createElement('a');\n    link.href = game.page;\n    link.textContent = game.name;\n    item.append(link);\n    list.append(item);\n  }\n  list.hidden = games.length === 0;\n  none.hidden = games.length > 0;\n})();\n"],"mappings":";;;AAMA,IAAM,QAAQ,SAAS,eAAe,OAAO;AAC7C,IAAM,OAAO,SAAS,eAAe,OAAO;AAC5C,IAAM,OAAO,SAAS,eAAe,MAAM;AAE3C,IAAI,UAAU,QAAQ,SAAS,aAAA,YAC7B,MAAM,cAAc,cAAc,UAAU,SAAS,QAAQ,EAAE;AAGjE,SAAS,eAAe,OAAO,CAAC,EAAE,iBAAiB,eAAe,SAAS,OAAO,CAAC;CAE7E,YAAY;CAChB,IAAI,SAAS,QAAQ,SAAS,QAAQ,EAAE,YAAY,SAAS;CAC7D,MAAM,QAAQ,MAAM,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC;CAChD,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,OAAO,SAAS,cAAc,IAAI;EACxC,MAAM,OAAO,SAAS,cAAc,GAAG;EACvC,KAAK,OAAO,KAAK;EACjB,KAAK,cAAc,KAAK;EACxB,KAAK,OAAO,IAAI;EAChB,KAAK,OAAO,IAAI;CAClB;CACA,KAAK,SAAS,MAAM,WAAW;CAC/B,KAAK,SAAS,MAAM,SAAS;AAC/B,EAAA,CAAG"}

package/dist/offline-mark.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `html` with `data-offline` on its <html> tag. A document without an <html> tag, or already
+ * marked, comes back unchanged. Only the tag changes: no script or style is added, so the
+ * page's Content-Security-Policy hashes still hold.
+ */
+export declare const markOfflineHtml: (html: string) => string;
+/** Render pin-derived labels before first paint, so hydration need not grow every
+ * catalog card and lineup row. Raw text and executable content keep their bytes. */
+export declare const markOfflineAvailability: (html: string, pinned: readonly string[]) => string;
+/**
+ * A cached page, marked as served offline. Status and headers carry over, except
+ * Content-Length, which no longer fits the body; anything that isn't an HTML document comes
+ * back as it is.
+ */
+export declare const markOfflineResponse: (response: Response, pinned?: readonly string[]) => Promise<Response>;

package/dist/offline-mark.js

@@ -0,0 +1,51 @@
+import { OFFLINE_ATTRIBUTE } from "./names.js";
+import { isGameId } from "@joystyk/contracts";
+//#region src/offline-mark.ts
+/** The <html> start tag: `<html` followed by whitespace, `>` or `/`. Never `<!doctype html>`. */
+var HTML_TAG = /<html(?=[\s/>])[^>]*>/i;
+var MARKED = new RegExp(`\\s${OFFLINE_ATTRIBUTE}(?=[\\s=/>])`, "i");
+/**
+* `html` with `data-offline` on its <html> tag. A document without an <html> tag, or already
+* marked, comes back unchanged. Only the tag changes: no script or style is added, so the
+* page's Content-Security-Policy hashes still hold.
+*/
+var markOfflineHtml = (html) => {
+	const match = HTML_TAG.exec(html);
+	if (match === null || MARKED.test(match[0])) return html;
+	const at = match.index + 5;
+	return `${html.slice(0, at)} ${OFFLINE_ATTRIBUTE}${html.slice(at)}`;
+};
+/** Render pin-derived labels before first paint, so hydration need not grow every
+* catalog card and lineup row. Raw text and executable content keep their bytes. */
+var markOfflineAvailability = (html, pinned) => {
+	const ids = new Set(pinned);
+	return html.replace(/<!--[\s\S]*?-->|<(script|style|textarea|title|xmp)\b[^>]*>[\s\S]*?<\/\1\s*>|<jy-offline-availability\b[^>]*>[\s\S]*?<\/jy-offline-availability\s*>/gi, (element) => {
+		if (!/^<jy-offline-availability\b/i.test(element)) return element;
+		const id = /\s+game-id\s*=\s*(?:"([^"]*)"|'([^']*)')/i.exec(element);
+		const game = id?.[1] ?? id?.[2];
+		if (!isGameId(game)) return element;
+		const available = ids.has(game);
+		return `<jy-offline-availability game-id="${game}" data-available="${String(available)}">${available ? "Available offline" : "Unavailable offline"}</jy-offline-availability>`;
+	});
+};
+/** Whether a response is an HTML document, by its Content-Type. */
+var isHtml = (response) => /^\s*text\/html\b/i.test(response.headers.get("content-type") ?? "");
+/**
+* A cached page, marked as served offline. Status and headers carry over, except
+* Content-Length, which no longer fits the body; anything that isn't an HTML document comes
+* back as it is.
+*/
+var markOfflineResponse = async (response, pinned = []) => {
+	if (!isHtml(response) || response.body === null) return response;
+	const headers = new Headers(response.headers);
+	headers.delete("content-length");
+	return new Response(markOfflineAvailability(markOfflineHtml(await response.text()), pinned), {
+		status: response.status,
+		statusText: response.statusText,
+		headers
+	});
+};
+//#endregion
+export { markOfflineAvailability, markOfflineHtml, markOfflineResponse };
+
+//# sourceMappingURL=offline-mark.js.map

package/dist/offline-mark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-mark.js","names":[],"sources":["../src/offline-mark.ts"],"sourcesContent":["// Marking pages served offline (offline-and-updates.md, \"Pages served offline\"). When the\n// network fails and the worker answers a page from a cache, it adds `data-offline` to the\n// page's <html> tag, so the document's own CSS can lay the page out for offline from the first\n// paint: @joystyk/ui's tokens.css collapses every <ad-slot> under `:root[data-offline]` until\n// the slot hears the browser is online. Pure, so it is tested in Node; sw/sw.ts applies it.\nimport { OFFLINE_ATTRIBUTE } from './names.ts';\nimport { isGameId } from '@joystyk/contracts';\n\n/** The <html> start tag: `<html` followed by whitespace, `>` or `/`. Never `<!doctype html>`. */\nconst HTML_TAG = /<html(?=[\\s/>])[^>]*>/i;\nconst MARKED = new RegExp(`\\\\s${OFFLINE_ATTRIBUTE}(?=[\\\\s=/>])`, 'i');\n\n/**\n * `html` with `data-offline` on its <html> tag. A document without an <html> tag, or already\n * marked, comes back unchanged. Only the tag changes: no script or style is added, so the\n * page's Content-Security-Policy hashes still hold.\n */\nexport const markOfflineHtml = (html: string): string => {\n  const match = HTML_TAG.exec(html);\n  if (match === null || MARKED.test(match[0])) return html;\n  const at = match.index + '<html'.length;\n  return `${html.slice(0, at)} ${OFFLINE_ATTRIBUTE}${html.slice(at)}`;\n};\n\n/** Render pin-derived labels before first paint, so hydration need not grow every\n * catalog card and lineup row. Raw text and executable content keep their bytes. */\nexport const markOfflineAvailability = (html: string, pinned: readonly string[]): string => {\n  const ids = new Set(pinned);\n  return html.replace(\n    /<!--[\\s\\S]*?-->|<(script|style|textarea|title|xmp)\\b[^>]*>[\\s\\S]*?<\\/\\1\\s*>|<jy-offline-availability\\b[^>]*>[\\s\\S]*?<\\/jy-offline-availability\\s*>/gi,\n    (element) => {\n      if (!/^<jy-offline-availability\\b/i.test(element)) return element;\n      const id = /\\s+game-id\\s*=\\s*(?:\"([^\"]*)\"|'([^']*)')/i.exec(element);\n      const game = id?.[1] ?? id?.[2];\n      if (!isGameId(game)) return element;\n      const available = ids.has(game);\n      return `<jy-offline-availability game-id=\"${game}\" data-available=\"${String(available)}\">${available ? 'Available offline' : 'Unavailable offline'}</jy-offline-availability>`;\n    },\n  );\n};\n\n/** Whether a response is an HTML document, by its Content-Type. */\nconst isHtml = (response: Response): boolean => /^\\s*text\\/html\\b/i.test(response.headers.get('content-type') ?? '');\n\n/**\n * A cached page, marked as served offline. Status and headers carry over, except\n * Content-Length, which no longer fits the body; anything that isn't an HTML document comes\n * back as it is.\n */\nexport const markOfflineResponse = async (response: Response, pinned: readonly string[] = []): Promise<Response> => {\n  if (!isHtml(response) || response.body === null) return response;\n  const headers = new Headers(response.headers);\n  headers.delete('content-length');\n  return new Response(markOfflineAvailability(markOfflineHtml(await response.text()), pinned), {\n    status: response.status,\n    statusText: response.statusText,\n    headers,\n  });\n};\n"],"mappings":";;;;AASA,IAAM,WAAW;AACjB,IAAM,SAAS,IAAI,OAAO,MAAM,kBAAkB,eAAe,GAAG;;;;;;AAOpE,IAAa,mBAAmB,SAAyB;CACvD,MAAM,QAAQ,SAAS,KAAK,IAAI;CAChC,IAAI,UAAU,QAAQ,OAAO,KAAK,MAAM,EAAE,GAAG,OAAO;CACpD,MAAM,KAAK,MAAM,QAAQ;CACzB,OAAO,GAAG,KAAK,MAAM,GAAG,EAAE,EAAE,GAAG,oBAAoB,KAAK,MAAM,EAAE;AAClE;;;AAIA,IAAa,2BAA2B,MAAc,WAAsC;CAC1F,MAAM,MAAM,IAAI,IAAI,MAAM;CAC1B,OAAO,KAAK,QACV,yJACC,YAAY;EACX,IAAI,CAAC,+BAA+B,KAAK,OAAO,GAAG,OAAO;EAC1D,MAAM,KAAK,4CAA4C,KAAK,OAAO;EACnE,MAAM,OAAO,KAAK,MAAM,KAAK;EAC7B,IAAI,CAAC,SAAS,IAAI,GAAG,OAAO;EAC5B,MAAM,YAAY,IAAI,IAAI,IAAI;EAC9B,OAAO,qCAAqC,KAAK,oBAAoB,OAAO,SAAS,EAAE,IAAI,YAAY,sBAAsB,sBAAsB;CACrJ,CACF;AACF;;AAGA,IAAM,UAAU,aAAgC,oBAAoB,KAAK,SAAS,QAAQ,IAAI,cAAc,KAAK,EAAE;;;;;;AAOnH,IAAa,sBAAsB,OAAO,UAAoB,SAA4B,CAAC,MAAyB;CAClH,IAAI,CAAC,OAAO,QAAQ,KAAK,SAAS,SAAS,MAAM,OAAO;CACxD,MAAM,UAAU,IAAI,QAAQ,SAAS,OAAO;CAC5C,QAAQ,OAAO,gBAAgB;CAC/B,OAAO,IAAI,SAAS,wBAAwB,gBAAgB,MAAM,SAAS,KAAK,CAAC,GAAG,MAAM,GAAG;EAC3F,QAAQ,SAAS;EACjB,YAAY,SAAS;EACrB;CACF,CAAC;AACH"}

package/dist/pin-record.d.ts

@@ -0,0 +1,14 @@
+export type PinRecord = {
+    readonly id: string;
+    readonly name: string;
+    /** The game build the cache holds. */
+    readonly version: string;
+    /** The platform release that built it. */
+    readonly release: string;
+    readonly page: string;
+    /** Where the asset manifest came from (the game manifest's `assets`). */
+    readonly assets: string;
+    readonly totalBytes: number;
+};
+export declare const PinRecordSchema: import("@joystyk/contracts").Validator<PinRecord>;
+export declare const parsePinRecord: (value: unknown) => PinRecord | null;

package/dist/pin-record.js

@@ -0,0 +1,36 @@
+import { decodeSync, isPath, isRecord, validator } from "./validate.js";
+import { isGameId } from "@joystyk/contracts";
+//#region src/pin-record.ts
+var PinRecordSchema = validator((value, issues) => {
+	if (!isRecord(value)) {
+		issues.push("Expected an object");
+		return;
+	}
+	const { id, name, version, release, page, assets, totalBytes } = value;
+	if (!isGameId(id)) issues.push("id: expected a kebab-case game id");
+	for (const [key, field] of [
+		["name", name],
+		["version", version],
+		["release", release]
+	]) if (typeof field !== "string" || field === "") issues.push(`${key}: expected text`);
+	if (!isPath(page)) issues.push("page: expected a site path");
+	if (!isPath(assets)) issues.push("assets: expected a site path");
+	if (typeof totalBytes !== "number" || !Number.isInteger(totalBytes) || totalBytes < 0) issues.push("totalBytes: expected a whole number");
+	return issues.length === 0 ? value : void 0;
+});
+var parsePinRecord = (value) => {
+	const record = decodeSync(PinRecordSchema, value);
+	return record === null ? null : {
+		id: record.id,
+		name: record.name,
+		version: record.version,
+		release: record.release,
+		page: record.page,
+		assets: record.assets,
+		totalBytes: record.totalBytes
+	};
+};
+//#endregion
+export { PinRecordSchema, parsePinRecord };
+
+//# sourceMappingURL=pin-record.js.map

package/dist/pin-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin-record.js","names":[],"sources":["../src/pin-record.ts"],"sourcesContent":["// What a pinned cache keeps beside the files, at PIN_RECORD_PATH: enough to list the pin on\n// the offline page, refresh it and remove it. Read back from Cache Storage, so decoded.\nimport { isGameId } from '@joystyk/contracts';\nimport { decodeSync, isPath, isRecord, validator } from './validate.ts';\n\nexport type PinRecord = {\n  readonly id: string;\n  readonly name: string;\n  /** The game build the cache holds. */\n  readonly version: string;\n  /** The platform release that built it. */\n  readonly release: string;\n  readonly page: string;\n  /** Where the asset manifest came from (the game manifest's `assets`). */\n  readonly assets: string;\n  readonly totalBytes: number;\n};\n\nexport const PinRecordSchema = validator<PinRecord>((value, issues) => {\n  if (!isRecord(value)) {\n    issues.push('Expected an object');\n    return undefined;\n  }\n  const { id, name, version, release, page, assets, totalBytes } = value;\n  if (!isGameId(id)) issues.push('id: expected a kebab-case game id');\n  for (const [key, field] of [\n    ['name', name],\n    ['version', version],\n    ['release', release],\n  ] as const) {\n    if (typeof field !== 'string' || field === '') issues.push(`${key}: expected text`);\n  }\n  if (!isPath(page)) issues.push('page: expected a site path');\n  if (!isPath(assets)) issues.push('assets: expected a site path');\n  if (typeof totalBytes !== 'number' || !Number.isInteger(totalBytes) || totalBytes < 0)\n    issues.push('totalBytes: expected a whole number');\n  return issues.length === 0 ? (value as PinRecord) : undefined;\n});\n\nexport const parsePinRecord = (value: unknown): PinRecord | null => {\n  const record = decodeSync(PinRecordSchema, value);\n  return record === null\n    ? null\n    : {\n        id: record.id,\n        name: record.name,\n        version: record.version,\n        release: record.release,\n        page: record.page,\n        assets: record.assets,\n        totalBytes: record.totalBytes,\n      };\n};\n"],"mappings":";;;AAkBA,IAAa,kBAAkB,WAAsB,OAAO,WAAW;CACrE,IAAI,CAAC,SAAS,KAAK,GAAG;EACpB,OAAO,KAAK,oBAAoB;EAChC;CACF;CACA,MAAM,EAAE,IAAI,MAAM,SAAS,SAAS,MAAM,QAAQ,eAAe;CACjE,IAAI,CAAC,SAAS,EAAE,GAAG,OAAO,KAAK,mCAAmC;CAClE,KAAK,MAAM,CAAC,KAAK,UAAU;EACzB,CAAC,QAAQ,IAAI;EACb,CAAC,WAAW,OAAO;EACnB,CAAC,WAAW,OAAO;CACrB,GACE,IAAI,OAAO,UAAU,YAAY,UAAU,IAAI,OAAO,KAAK,GAAG,IAAI,gBAAgB;CAEpF,IAAI,CAAC,OAAO,IAAI,GAAG,OAAO,KAAK,4BAA4B;CAC3D,IAAI,CAAC,OAAO,MAAM,GAAG,OAAO,KAAK,8BAA8B;CAC/D,IAAI,OAAO,eAAe,YAAY,CAAC,OAAO,UAAU,UAAU,KAAK,aAAa,GAClF,OAAO,KAAK,qCAAqC;CACnD,OAAO,OAAO,WAAW,IAAK,QAAsB,KAAA;AACtD,CAAC;AAED,IAAa,kBAAkB,UAAqC;CAClE,MAAM,SAAS,WAAW,iBAAiB,KAAK;CAChD,OAAO,WAAW,OACd,OACA;EACE,IAAI,OAAO;EACX,MAAM,OAAO;EACb,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB,MAAM,OAAO;EACb,QAAQ,OAAO;EACf,YAAY,OAAO;CACrB;AACN"}

package/dist/preloads.d.ts

@@ -0,0 +1,2 @@
+export declare const withoutModulePreloads: (html: string) => string;
+export declare const withoutPreloadResponse: (response: Response) => Promise<Response>;

package/dist/preloads.js

@@ -0,0 +1,26 @@
+//#region src/preloads.ts
+/** Remove document preloads before a service-worker response reaches the HTML parser.
+* A controlled page imports through its worker; cross-world preload hints can fetch the
+* same modules twice. Scripts, stylesheet links and CSP-hashed inline content stay intact.
+*/
+var modulePreloadLink = (tag) => {
+	if (!/^<link\b/i.test(tag)) return false;
+	const attributes = tag.matchAll(/\s+([^\s="'<>/]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'=<>`]+)))?/g);
+	for (const attribute of attributes) if (attribute[1]?.toLowerCase() === "rel") return (attribute[2] ?? attribute[3] ?? attribute[4] ?? "").toLowerCase().split(/\s+/).includes("modulepreload");
+	return false;
+};
+var withoutModulePreloads = (html) => html.replace(/<!--[\s\S]*?-->|<(script|style|textarea|title|xmp)\b[^>]*>[\s\S]*?<\/\1\s*>|<link\b[^>]*>/gi, (tag) => modulePreloadLink(tag) ? "" : tag);
+var withoutPreloadResponse = async (response) => {
+	if (response.body === null || !/^\s*text\/html\b/i.test(response.headers.get("content-type") ?? "")) return response;
+	const headers = new Headers(response.headers);
+	headers.delete("content-length");
+	return new Response(withoutModulePreloads(await response.text()), {
+		status: response.status,
+		statusText: response.statusText,
+		headers
+	});
+};
+//#endregion
+export { withoutModulePreloads, withoutPreloadResponse };
+
+//# sourceMappingURL=preloads.js.map

package/dist/preloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preloads.js","names":[],"sources":["../src/preloads.ts"],"sourcesContent":["/** Remove document preloads before a service-worker response reaches the HTML parser.\n * A controlled page imports through its worker; cross-world preload hints can fetch the\n * same modules twice. Scripts, stylesheet links and CSP-hashed inline content stay intact.\n */\nconst modulePreloadLink = (tag: string): boolean => {\n  if (!/^<link\\b/i.test(tag)) return false;\n  const attributes = tag.matchAll(/\\s+([^\\s=\"'<>/]+)(?:\\s*=\\s*(?:\"([^\"]*)\"|'([^']*)'|([^\\s\"'=<>`]+)))?/g);\n  for (const attribute of attributes) {\n    if (attribute[1]?.toLowerCase() === 'rel') {\n      return (attribute[2] ?? attribute[3] ?? attribute[4] ?? '').toLowerCase().split(/\\s+/).includes('modulepreload');\n    }\n  }\n  return false;\n};\n\nexport const withoutModulePreloads = (html: string): string =>\n  html.replace(/<!--[\\s\\S]*?-->|<(script|style|textarea|title|xmp)\\b[^>]*>[\\s\\S]*?<\\/\\1\\s*>|<link\\b[^>]*>/gi, (tag) =>\n    modulePreloadLink(tag) ? '' : tag,\n  );\n\nexport const withoutPreloadResponse = async (response: Response): Promise<Response> => {\n  if (response.body === null || !/^\\s*text\\/html\\b/i.test(response.headers.get('content-type') ?? '')) return response;\n  const headers = new Headers(response.headers);\n  headers.delete('content-length');\n  return new Response(withoutModulePreloads(await response.text()), {\n    status: response.status,\n    statusText: response.statusText,\n    headers,\n  });\n};\n"],"mappings":";;;;;AAIA,IAAM,qBAAqB,QAAyB;CAClD,IAAI,CAAC,YAAY,KAAK,GAAG,GAAG,OAAO;CACnC,MAAM,aAAa,IAAI,SAAS,sEAAsE;CACtG,KAAK,MAAM,aAAa,YACtB,IAAI,UAAU,EAAE,EAAE,YAAY,MAAM,OAClC,QAAQ,UAAU,MAAM,UAAU,MAAM,UAAU,MAAM,GAAA,CAAI,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,SAAS,eAAe;CAGnH,OAAO;AACT;AAEA,IAAa,yBAAyB,SACpC,KAAK,QAAQ,gGAAgG,QAC3G,kBAAkB,GAAG,IAAI,KAAK,GAChC;AAEF,IAAa,yBAAyB,OAAO,aAA0C;CACrF,IAAI,SAAS,SAAS,QAAQ,CAAC,oBAAoB,KAAK,SAAS,QAAQ,IAAI,cAAc,KAAK,EAAE,GAAG,OAAO;CAC5G,MAAM,UAAU,IAAI,QAAQ,SAAS,OAAO;CAC5C,QAAQ,OAAO,gBAAgB;CAC/B,OAAO,IAAI,SAAS,sBAAsB,MAAM,SAAS,KAAK,CAAC,GAAG;EAChE,QAAQ,SAAS;EACjB,YAAY,SAAS;EACrB;CACF,CAAC;AACH"}

package/dist/routing.d.ts

@@ -0,0 +1,57 @@
+import type { RecentKind } from './names.js';
+/** The hashed, immutable files the site serves (apps/site's assets volume). */
+export declare const ASSETS_PREFIX = "/assets/";
+/** The kind of a file by its extension: a Tier 2 kind, `font`, or null for anything else. */
+export declare const fileKind: (pathname: string) => RecentKind | "font" | null;
+/** Tier 2 budgets: entries per kind and their age limit. Least recently used goes first. */
+export declare const RECENT_LIMITS: Readonly<Record<RecentKind, {
+    readonly maxEntries: number;
+    readonly maxAgeSeconds: number;
+}>>;
+/** How the worker answers one request. */
+export type Route = 
+/** Not ours: cross-origin, not a GET, the worker's own files or the flag file. The network answers. */
+{
+    readonly _tag: 'Network';
+}
+/** A page. Network first, then a pinned copy, then the precached shell, then the offline page. */
+ | {
+    readonly _tag: 'Document';
+}
+/** Catalog data for client-side navigation. Network first, then a pinned copy. */
+ | {
+    readonly _tag: 'Api';
+}
+/** A hashed file. The precache, then the pinned caches, then this kind's Tier 2 cache. */
+ | {
+    readonly _tag: 'Asset';
+    readonly kind: RecentKind;
+}
+/** A hashed font or another file with no Tier 2 cache: the precache or a pin, else the network. */
+ | {
+    readonly _tag: 'Pinned';
+};
+export type RouteInput = {
+    readonly method: string;
+    /** Explicit revalidation (pin refreshes) must reach the network, bypassing Cache Storage. */
+    readonly cache?: RequestCache;
+    readonly pinRefresh?: boolean;
+    /** `Request.destination`: 'document' for navigations. */
+    readonly destination: string;
+    /** `Request.mode`: 'navigate' for navigations. */
+    readonly mode: string;
+    readonly url: URL;
+    /** The worker's origin. */
+    readonly origin: string;
+};
+export declare const routeFor: (request: RouteInput) => Route;
+/** Whether a page's updates may be offered now (Rule 2): only at a safe point, never in play. */
+export type PromptInput = {
+    /** A new worker is installed and waiting, or another tab already switched workers. */
+    readonly ready: boolean;
+    /** The launcher's last safe-point report; true on pages without a launcher. */
+    readonly safe: boolean;
+    /** The player chose "Later" for this update. */
+    readonly dismissed: boolean;
+};
+export declare const shouldOfferUpdate: (input: PromptInput) => boolean;