@joystyk/pwa 0.0.0-stage → 0.2.0

package/dist/build/plugin.js

@@ -0,0 +1,172 @@
+import { OFFLINE_URL, WEB_MANIFEST_URL } from "../names.js";
+import { iconPng, iconSvg } from "./icons.js";
+import { contentHash, gameAssetManifest, injectManifest, offlinePage, precacheEntries, webManifest } from "./documents.js";
+import { fileSets } from "./graph.js";
+import { DEFAULT_CONTROL, RELEASE_RECORD_FILE, canonicalReleaseTime } from "../control.js";
+import * as z from "zod/mini";
+import { dirname, join, resolve } from "node:path";
+import { existsSync, statSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { build } from "vite";
+//#region src/build/plugin.ts
+var SOURCE = fileURLToPath(new URL("..", import.meta.url));
+var script = (folder, name) => {
+	const source = join(SOURCE, folder, `${name}.ts`);
+	return existsSync(source) ? source : join(SOURCE, folder, `${name}.js`);
+};
+/** Bundles one browser or worker script into a single minified classic script. */
+var bundleScript = async (entry, define = {}) => {
+	const result = await build({
+		configFile: false,
+		root: SOURCE,
+		logLevel: "warn",
+		publicDir: false,
+		define: {
+			"process.env.NODE_ENV": JSON.stringify("production"),
+			...define
+		},
+		build: {
+			write: false,
+			emptyOutDir: false,
+			copyPublicDir: false,
+			minify: true,
+			target: "es2022",
+			sourcemap: false,
+			reportCompressedSize: false,
+			lib: {
+				entry,
+				formats: ["iife"],
+				name: "joystykPwa",
+				fileName: () => "bundle.js"
+			}
+		}
+	});
+	for (const output of Array.isArray(result) ? result : [result]) {
+		if (!("output" in output)) continue;
+		for (const item of output.output) if (item.type === "chunk" && item.isEntry) return item.code;
+	}
+	throw new Error(`[pwa] Bundling ${entry} produced no script.`);
+};
+var write = async (file, content) => {
+	await mkdir(dirname(file), { recursive: true });
+	await writeFile(file, content);
+};
+var manifestSchema = z.record(z.string(), z.object({
+	file: z.string(),
+	name: z.optional(z.string()),
+	src: z.optional(z.string()),
+	isEntry: z.optional(z.boolean()),
+	isDynamicEntry: z.optional(z.boolean()),
+	imports: z.optional(z.array(z.string())),
+	dynamicImports: z.optional(z.array(z.string())),
+	css: z.optional(z.array(z.string())),
+	assets: z.optional(z.array(z.string()))
+}));
+/** The plugin. Add it to the site's client build only. */
+var joystykPwa = (options) => {
+	const releaseTime = canonicalReleaseTime(options.releaseTime);
+	if (releaseTime === null) throw new Error(`[pwa] releaseTime "${options.releaseTime}" isn't a date-time such as 2026-10-09T14:03:12Z.`);
+	let config;
+	let logger;
+	return {
+		name: "joystyk-pwa",
+		apply: "build",
+		enforce: "post",
+		configResolved(resolved) {
+			config = resolved;
+			logger = resolved.logger;
+		},
+		async writeBundle(output, bundle) {
+			if (config === void 0 || config.build.ssr !== false) return;
+			const outDir = resolve(config.root, output.dir ?? config.build.outDir);
+			const manifestPath = join(outDir, ".vite", "manifest.json");
+			if (!existsSync(manifestPath)) throw new Error("[pwa] The client build needs `build.manifest: true`.");
+			const manifest = manifestSchema.parse(JSON.parse(await readFile(manifestPath, "utf8")));
+			const sources = new Map(Object.values(bundle).filter((item) => item.type === "chunk").map((chunk) => [chunk.fileName, chunk.moduleIds]));
+			const site = await options.site({ outDir });
+			const hashed = async (name, ext, content) => {
+				const file = `assets/${name}-${contentHash(content)}.${ext}`;
+				await write(join(outDir, file), content);
+				return file;
+			};
+			const iconFiles = {
+				svg: await hashed("icon", "svg", iconSvg()),
+				png192: await hashed("icon-192", "png", iconPng(192)),
+				png512: await hashed("icon-512", "png", iconPng(512)),
+				maskable512: await hashed("icon-maskable-512", "png", iconPng(512, true))
+			};
+			const offlineCss = await hashed("offline", "css", await readFile(join(SOURCE, "offline", "offline.css")));
+			const offlineJs = await hashed("offline", "js", await bundleScript(script("offline", "offline")));
+			const url = (file) => `/${file}`;
+			const manifestJson = `${JSON.stringify(webManifest({
+				svg: url(iconFiles.svg),
+				png192: url(iconFiles.png192),
+				png512: url(iconFiles.png512),
+				maskable512: url(iconFiles.maskable512)
+			}), null, 2)}\n`;
+			await write(join(outDir, "manifest.webmanifest"), manifestJson);
+			const offlineHtml = offlinePage({
+				css: url(offlineCss),
+				js: url(offlineJs),
+				icon: url(iconFiles.svg)
+			});
+			await write(join(outDir, "offline.html"), offlineHtml);
+			const sets = fileSets(manifest, site.games, config.root, site.unlisted ?? [], sources);
+			const sizeOf = (file) => statSync(join(outDir, file)).size;
+			for (const game of site.games) {
+				const assets = gameAssetManifest(game, options.release, sets.shell, sets.games.get(game.id) ?? /* @__PURE__ */ new Set(), sizeOf);
+				if (!game.assets.startsWith("/") || game.assets.includes("..")) throw new Error(`[pwa] ${game.id}: assets "${game.assets}" must be a site path.`);
+				await write(join(outDir, game.assets), `${JSON.stringify(assets, null, 2)}\n`);
+			}
+			const rendered = [];
+			for (const path of site.shellPages) {
+				const response = await site.render(path);
+				if (response.status !== 200) throw new Error(`[pwa] Precaching ${path}: the server answers ${String(response.status)}, not 200.`);
+				rendered.push({
+					url: path,
+					hashed: false,
+					body: new Uint8Array(await response.arrayBuffer())
+				});
+			}
+			const files = [
+				...sets.shell,
+				...Object.values(iconFiles),
+				offlineCss,
+				offlineJs
+			];
+			const entries = precacheEntries([
+				...rendered,
+				{
+					url: OFFLINE_URL,
+					hashed: false,
+					body: offlineHtml
+				},
+				{
+					url: WEB_MANIFEST_URL,
+					hashed: false,
+					body: manifestJson
+				},
+				...files.map((file) => ({
+					url: url(file),
+					hashed: true,
+					file
+				}))
+			], (file) => existsSync(join(outDir, file)));
+			const worker = injectManifest(await bundleScript(script("sw", "sw"), { __JOYSTYK_RELEASE__: JSON.stringify(options.release) }), entries);
+			await write(join(outDir, "sw.js"), worker);
+			await write(join(outDir, "sw-remove.js"), await bundleScript(script("sw", "remove-sw")));
+			await write(join(outDir, "pwa-control.json"), `${JSON.stringify(DEFAULT_CONTROL, null, 2)}\n`);
+			const record = {
+				release: options.release,
+				releaseTime
+			};
+			await write(join(outDir, RELEASE_RECORD_FILE), `${JSON.stringify(record, null, 2)}\n`);
+			logger?.info(`[pwa] sw.js ${(worker.length / 1024).toFixed(1)} kB for release ${options.release} (${releaseTime}):${String(entries.length)} precache entries; asset manifests for ${site.games.map((g) => g.id).join(", ") || "no games"}.`);
+		}
+	};
+};
+//#endregion
+export { joystykPwa };
+
+//# sourceMappingURL=plugin.js.map

package/dist/build/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","names":[],"sources":["../../src/build/plugin.ts"],"sourcesContent":["// The PWA build step, as a Vite plugin for the site's client build. After Vite writes the\n// client, it adds, from the built output:\n//\n//   assets/icon-*.svg|png, assets/offline-*.js|css   hashed, immutable (Rule 1)\n//   manifest.webmanifest, offline.html                served no-cache\n//   games/<id>/manifest.json                          every file each game needs (Rule 1)\n//   sw.js                                             one classic script, precache list injected\n//   sw-remove.js                                      the emergency self-removing worker (Rule 5)\n//   pwa-control.json                                  the default flag file\n//   release.json                                      the release ID and time, for the server\n//\n// The worker is bundled from Workbox modules with Vite itself, so the build needs no other\n// bundler. Precache revisions hash the rendered output (the blog's lesson): the site renders\n// its shell pages at build time exactly as the server will, and the build fails if any\n// precache entry is missing.\nimport { existsSync, statSync } from 'node:fs';\nimport { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { build, type Logger, type Plugin, type ResolvedConfig } from 'vite';\nimport * as z from 'zod/mini';\nimport { canonicalReleaseTime, DEFAULT_CONTROL, RELEASE_RECORD_FILE, type ReleaseRecord } from '../control.ts';\nimport { OFFLINE_URL, WEB_MANIFEST_URL } from '../names.ts';\nimport {\n  contentHash,\n  gameAssetManifest,\n  injectManifest,\n  offlinePage,\n  precacheEntries,\n  webManifest,\n  type BuildGame,\n  type PrecacheSource,\n} from './documents.ts';\nimport { fileSets, type GameSource } from './graph.ts';\nimport { iconPng, iconSvg } from './icons.ts';\n\n/** What the site supplies at build time, once the client build is on disk. */\nexport type SiteBuildInput = {\n  /** The games this build lists: each gets an asset manifest. */\n  readonly games: readonly BuildGame[];\n  /**\n   * Games whose code is in the bundle but which this build doesn't list, such as test games\n   * outside test builds. Their code is kept out of the shell and gets no asset manifest.\n   */\n  readonly unlisted?: readonly GameSource[];\n  /** Answers a request exactly as the production server will; used to hash the shell pages. */\n  readonly render: (path: string) => Promise<Response>;\n  /** Server-rendered paths to precache, such as '/' and '/favicon.svg'. */\n  readonly shellPages: readonly string[];\n};\n\nexport type PwaPluginOptions = {\n  /** The release ID baked into the worker (git SHA + date). */\n  readonly release: string;\n  /**\n   * When the release's code was committed, as an RFC 3339 date-time. Releases are ordered by\n   * it: the flag file's minimum release is one (control.ts).\n   */\n  readonly releaseTime: string;\n  /** Loads the site's half, given the output directory. Called after the client is written. */\n  readonly site: (context: { readonly outDir: string }) => Promise<SiteBuildInput>;\n};\n\nconst SOURCE = fileURLToPath(new URL('..', import.meta.url));\n\n// Workspace builds use TypeScript; installed tarballs carry the same modules as JS.\nconst script = (folder: string, name: string): string => {\n  const source = join(SOURCE, folder, `${name}.ts`);\n  return existsSync(source) ? source : join(SOURCE, folder, `${name}.js`);\n};\n\n/** Bundles one browser or worker script into a single minified classic script. */\nconst bundleScript = async (entry: string, define: Record<string, string> = {}): Promise<string> => {\n  const result = await build({\n    configFile: false,\n    root: SOURCE,\n    logLevel: 'warn',\n    publicDir: false,\n    define: { 'process.env.NODE_ENV': JSON.stringify('production'), ...define },\n    build: {\n      write: false,\n      emptyOutDir: false,\n      copyPublicDir: false,\n      minify: true,\n      target: 'es2022',\n      sourcemap: false,\n      reportCompressedSize: false,\n      lib: { entry, formats: ['iife'], name: 'joystykPwa', fileName: () => 'bundle.js' },\n    },\n  });\n  for (const output of Array.isArray(result) ? result : [result]) {\n    if (!('output' in output)) continue;\n    for (const item of output.output) if (item.type === 'chunk' && item.isEntry) return item.code;\n  }\n  throw new Error(`[pwa] Bundling ${entry} produced no script.`);\n};\n\nconst write = async (file: string, content: string | Uint8Array): Promise<void> => {\n  await mkdir(dirname(file), { recursive: true });\n  await writeFile(file, content);\n};\n\nconst manifestSchema = z.record(\n  z.string(),\n  z.object({\n    file: z.string(),\n    name: z.optional(z.string()),\n    src: z.optional(z.string()),\n    isEntry: z.optional(z.boolean()),\n    isDynamicEntry: z.optional(z.boolean()),\n    imports: z.optional(z.array(z.string())),\n    dynamicImports: z.optional(z.array(z.string())),\n    css: z.optional(z.array(z.string())),\n    assets: z.optional(z.array(z.string())),\n  }),\n);\n\n/** The plugin. Add it to the site's client build only. */\nexport const joystykPwa = (options: PwaPluginOptions): Plugin => {\n  const releaseTime = canonicalReleaseTime(options.releaseTime);\n  if (releaseTime === null)\n    throw new Error(`[pwa] releaseTime \"${options.releaseTime}\" isn't a date-time such as 2026-10-09T14:03:12Z.`);\n  let config: ResolvedConfig | undefined;\n  let logger: Logger | undefined;\n  return {\n    name: 'joystyk-pwa',\n    apply: 'build',\n    enforce: 'post',\n    configResolved(resolved) {\n      config = resolved;\n      logger = resolved.logger;\n    },\n    async writeBundle(output, bundle) {\n      if (config === undefined || config.build.ssr !== false) return;\n      const outDir = resolve(config.root, output.dir ?? config.build.outDir);\n      const manifestPath = join(outDir, '.vite', 'manifest.json');\n      if (!existsSync(manifestPath)) throw new Error('[pwa] The client build needs `build.manifest: true`.');\n      const manifest = manifestSchema.parse(JSON.parse(await readFile(manifestPath, 'utf8')));\n      const sources = new Map(\n        Object.values(bundle)\n          .filter((item) => item.type === 'chunk')\n          .map((chunk) => [chunk.fileName, chunk.moduleIds]),\n      );\n      const site = await options.site({ outDir });\n\n      // Hashed, immutable files beside Vite's own.\n      const hashed = async (name: string, ext: string, content: string | Uint8Array): Promise<string> => {\n        const file = `assets/${name}-${contentHash(content)}.${ext}`;\n        await write(join(outDir, file), content);\n        return file;\n      };\n      const iconFiles = {\n        svg: await hashed('icon', 'svg', iconSvg()),\n        png192: await hashed('icon-192', 'png', iconPng(192)),\n        png512: await hashed('icon-512', 'png', iconPng(512)),\n        maskable512: await hashed('icon-maskable-512', 'png', iconPng(512, true)),\n      };\n      const offlineCss = await hashed('offline', 'css', await readFile(join(SOURCE, 'offline', 'offline.css')));\n      const offlineJs = await hashed('offline', 'js', await bundleScript(script('offline', 'offline')));\n      const url = (file: string): string => `/${file}`;\n\n      const manifestJson = `${JSON.stringify(webManifest({ svg: url(iconFiles.svg), png192: url(iconFiles.png192), png512: url(iconFiles.png512), maskable512: url(iconFiles.maskable512) }), null, 2)}\\n`;\n      await write(join(outDir, 'manifest.webmanifest'), manifestJson);\n      const offlineHtml = offlinePage({ css: url(offlineCss), js: url(offlineJs), icon: url(iconFiles.svg) });\n      await write(join(outDir, 'offline.html'), offlineHtml);\n\n      // Each game's asset manifest.\n      const sets = fileSets(manifest, site.games, config.root, site.unlisted ?? [], sources);\n      const sizeOf = (file: string): number => statSync(join(outDir, file)).size;\n      for (const game of site.games) {\n        const assets = gameAssetManifest(\n          game,\n          options.release,\n          sets.shell,\n          sets.games.get(game.id) ?? new Set(),\n          sizeOf,\n        );\n        if (!game.assets.startsWith('/') || game.assets.includes('..'))\n          throw new Error(`[pwa] ${game.id}: assets \"${game.assets}\" must be a site path.`);\n        await write(join(outDir, game.assets), `${JSON.stringify(assets, null, 2)}\\n`);\n      }\n\n      // Tier 1: the shell's code, the icons, the offline page and the rendered shell pages.\n      const rendered: PrecacheSource[] = [];\n      for (const path of site.shellPages) {\n        const response = await site.render(path);\n        if (response.status !== 200)\n          throw new Error(`[pwa] Precaching ${path}: the server answers ${String(response.status)}, not 200.`);\n        rendered.push({ url: path, hashed: false, body: new Uint8Array(await response.arrayBuffer()) });\n      }\n      const files = [...sets.shell, ...Object.values(iconFiles), offlineCss, offlineJs];\n      const entries = precacheEntries(\n        [\n          ...rendered,\n          { url: OFFLINE_URL, hashed: false, body: offlineHtml },\n          { url: WEB_MANIFEST_URL, hashed: false, body: manifestJson },\n          ...files.map((file): PrecacheSource => ({ url: url(file), hashed: true, file })),\n        ],\n        (file) => existsSync(join(outDir, file)),\n      );\n\n      const worker = injectManifest(\n        await bundleScript(script('sw', 'sw'), { __JOYSTYK_RELEASE__: JSON.stringify(options.release) }),\n        entries,\n      );\n      await write(join(outDir, 'sw.js'), worker);\n      await write(join(outDir, 'sw-remove.js'), await bundleScript(script('sw', 'remove-sw')));\n      await write(join(outDir, 'pwa-control.json'), `${JSON.stringify(DEFAULT_CONTROL, null, 2)}\\n`);\n      const record: ReleaseRecord = { release: options.release, releaseTime };\n      await write(join(outDir, RELEASE_RECORD_FILE), `${JSON.stringify(record, null, 2)}\\n`);\n      logger?.info(\n        `[pwa] sw.js ${(worker.length / 1024).toFixed(1)} kB for release ${options.release} (${releaseTime}):${String(entries.length)} precache entries; asset manifests for ${site.games.map((g) => g.id).join(', ') || 'no games'}.`,\n      );\n    },\n  };\n};\n"],"mappings":"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"}

package/dist/client/availability.d.ts

@@ -0,0 +1,12 @@
+export declare const PIN_CHANGED = "joystyk:pin-changed";
+export type AvailabilityPorts = {
+    readonly root: Document;
+    readonly online: () => boolean;
+    readonly pins: () => Promise<readonly {
+        readonly id: string;
+    }[]>;
+};
+/** Keep catalog labels accurate across SPA navigation and pin changes. One cache read per
+ * refresh serves the entire listing. Unavailable links explain their state and do not
+ * navigate to a broken game while offline. */
+export declare const watchOfflineAvailability: (ports?: AvailabilityPorts) => (() => void);

package/dist/client/availability.js

@@ -0,0 +1,94 @@
+import { pinnedGames } from "./pinned.js";
+import { isGameId } from "@joystyk/contracts";
+//#region src/client/availability.ts
+var PIN_CHANGED = "joystyk:pin-changed";
+/** Keep catalog labels accurate across SPA navigation and pin changes. One cache read per
+* refresh serves the entire listing. Unavailable links explain their state and do not
+* navigate to a broken game while offline. */
+var watchOfflineAvailability = (ports = {
+	root: document,
+	online: () => navigator.onLine,
+	pins: () => pinnedGames()
+}) => {
+	let disposed = false;
+	let generation = 0;
+	let scheduled = false;
+	const roots = () => {
+		const found = [];
+		const visit = (root) => {
+			found.push(root);
+			for (const element of root.querySelectorAll("*")) if (element.shadowRoot !== null) visit(element.shadowRoot);
+		};
+		visit(ports.root);
+		return found;
+	};
+	const refresh = async () => {
+		const current = ++generation;
+		const ids = new Set((await ports.pins().catch(() => [])).map((pin) => pin.id));
+		if (disposed || current !== generation) return;
+		const offline = !ports.online();
+		const surfaces = roots();
+		observer.disconnect();
+		for (const surface of surfaces) observer.observe(surface, {
+			childList: true,
+			subtree: true
+		});
+		for (const label of surfaces.flatMap((surface) => [...surface.querySelectorAll("jy-offline-availability[game-id]")])) {
+			const id = label.getAttribute("game-id");
+			if (!isGameId(id)) continue;
+			const pinned = ids.has(id);
+			const message = pinned ? "Available offline" : offline ? "Unavailable offline" : "";
+			if (label.textContent !== message) label.textContent = message;
+			label.hidden = message === "";
+			label.dataset["available"] = String(pinned);
+			const link = (label.closest("article, li, tr") ?? label.parentElement)?.querySelector(`a[href="/games/${id}"]`);
+			if (link !== null && link !== void 0) {
+				if (offline && !pinned) link.setAttribute("aria-disabled", "true");
+				else link.removeAttribute("aria-disabled");
+			}
+		}
+	};
+	const schedule = () => {
+		if (disposed || scheduled) return;
+		scheduled = true;
+		queueMicrotask(() => {
+			scheduled = false;
+			if (!disposed) refresh();
+		});
+	};
+	const onClick = (event) => {
+		if (event.composedPath().find((target) => target instanceof Element && target.matches("a[aria-disabled=\"true\"]")) !== void 0 && !ports.online()) {
+			event.preventDefault();
+			event.stopImmediatePropagation();
+		}
+	};
+	const observer = new MutationObserver((changes) => {
+		if (changes.some((change) => [...change.addedNodes].some((node) => node instanceof Element))) schedule();
+	});
+	observer.observe(ports.root, {
+		childList: true,
+		subtree: true
+	});
+	for (const name of [
+		"online",
+		"offline",
+		PIN_CHANGED
+	]) addEventListener(name, schedule);
+	ports.root.addEventListener("click", onClick, true);
+	schedule();
+	return () => {
+		disposed = true;
+		generation += 1;
+		observer.disconnect();
+		for (const name of [
+			"online",
+			"offline",
+			PIN_CHANGED
+		]) removeEventListener(name, schedule);
+		ports.root.removeEventListener("click", onClick, true);
+	};
+};
+//#endregion
+export { PIN_CHANGED, watchOfflineAvailability };
+
+//# sourceMappingURL=availability.js.map

package/dist/client/availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.js","names":[],"sources":["../../src/client/availability.ts"],"sourcesContent":["import { isGameId } from '@joystyk/contracts';\nimport { pinnedGames } from './pinned.ts';\n\nexport const PIN_CHANGED = 'joystyk:pin-changed';\nexport type AvailabilityPorts = {\n  readonly root: Document;\n  readonly online: () => boolean;\n  readonly pins: () => Promise<readonly { readonly id: string }[]>;\n};\n\n/** Keep catalog labels accurate across SPA navigation and pin changes. One cache read per\n * refresh serves the entire listing. Unavailable links explain their state and do not\n * navigate to a broken game while offline. */\nexport const watchOfflineAvailability = (\n  ports: AvailabilityPorts = {\n    root: document,\n    online: () => navigator.onLine,\n    pins: () => pinnedGames(),\n  },\n): (() => void) => {\n  let disposed = false;\n  let generation = 0;\n  let scheduled = false;\n  const roots = (): (Document | ShadowRoot)[] => {\n    const found: (Document | ShadowRoot)[] = [];\n    const visit = (root: Document | ShadowRoot): void => {\n      found.push(root);\n      for (const element of root.querySelectorAll('*')) if (element.shadowRoot !== null) visit(element.shadowRoot);\n    };\n    visit(ports.root);\n    return found;\n  };\n  const refresh = async (): Promise<void> => {\n    const current = ++generation;\n    const ids = new Set((await ports.pins().catch(() => [])).map((pin) => pin.id));\n    if (disposed || current !== generation) return;\n    const offline = !ports.online();\n    const surfaces = roots();\n    observer.disconnect();\n    for (const surface of surfaces) observer.observe(surface, { childList: true, subtree: true });\n    for (const label of surfaces.flatMap((surface) => [\n      ...surface.querySelectorAll<HTMLElement>('jy-offline-availability[game-id]'),\n    ])) {\n      const id = label.getAttribute('game-id');\n      if (!isGameId(id)) continue;\n      const pinned = ids.has(id);\n      const message = pinned ? 'Available offline' : offline ? 'Unavailable offline' : '';\n      if (label.textContent !== message) label.textContent = message;\n      label.hidden = message === '';\n      label.dataset['available'] = String(pinned);\n      const scope = label.closest('article, li, tr') ?? label.parentElement;\n      const link = scope?.querySelector<HTMLAnchorElement>(`a[href=\"/games/${id}\"]`);\n      if (link !== null && link !== undefined) {\n        if (offline && !pinned) link.setAttribute('aria-disabled', 'true');\n        else link.removeAttribute('aria-disabled');\n      }\n    }\n  };\n  const schedule = (): void => {\n    if (disposed || scheduled) return;\n    scheduled = true;\n    queueMicrotask(() => {\n      scheduled = false;\n      if (!disposed) void refresh();\n    });\n  };\n  const onClick = (event: Event): void => {\n    const link = event\n      .composedPath()\n      .find((target) => target instanceof Element && target.matches('a[aria-disabled=\"true\"]'));\n    if (link !== undefined && !ports.online()) {\n      event.preventDefault();\n      event.stopImmediatePropagation();\n    }\n  };\n  const observer = new MutationObserver((changes) => {\n    // A newly mounted custom element may hold its labels inside a shadow root;\n    // querySelector on the added host cannot see them. Text-only label updates\n    // do not schedule another refresh.\n    if (changes.some((change) => [...change.addedNodes].some((node) => node instanceof Element))) schedule();\n  });\n  observer.observe(ports.root, { childList: true, subtree: true });\n  for (const name of ['online', 'offline', PIN_CHANGED]) addEventListener(name, schedule);\n  ports.root.addEventListener('click', onClick, true);\n  schedule();\n  return () => {\n    disposed = true;\n    generation += 1;\n    observer.disconnect();\n    for (const name of ['online', 'offline', PIN_CHANGED]) removeEventListener(name, schedule);\n    ports.root.removeEventListener('click', onClick, true);\n  };\n};\n"],"mappings":";;;AAGA,IAAa,cAAc;;;;AAU3B,IAAa,4BACX,QAA2B;CACzB,MAAM;CACN,cAAc,UAAU;CACxB,YAAY,YAAY;AAC1B,MACiB;CACjB,IAAI,WAAW;CACf,IAAI,aAAa;CACjB,IAAI,YAAY;CAChB,MAAM,cAAyC;EAC7C,MAAM,QAAmC,CAAC;EAC1C,MAAM,SAAS,SAAsC;GACnD,MAAM,KAAK,IAAI;GACf,KAAK,MAAM,WAAW,KAAK,iBAAiB,GAAG,GAAG,IAAI,QAAQ,eAAe,MAAM,MAAM,QAAQ,UAAU;EAC7G;EACA,MAAM,MAAM,IAAI;EAChB,OAAO;CACT;CACA,MAAM,UAAU,YAA2B;EACzC,MAAM,UAAU,EAAE;EAClB,MAAM,MAAM,IAAI,KAAK,MAAM,MAAM,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,EAAA,CAAG,KAAK,QAAQ,IAAI,EAAE,CAAC;EAC7E,IAAI,YAAY,YAAY,YAAY;EACxC,MAAM,UAAU,CAAC,MAAM,OAAO;EAC9B,MAAM,WAAW,MAAM;EACvB,SAAS,WAAW;EACpB,KAAK,MAAM,WAAW,UAAU,SAAS,QAAQ,SAAS;GAAE,WAAW;GAAM,SAAS;EAAK,CAAC;EAC5F,KAAK,MAAM,SAAS,SAAS,SAAS,YAAY,CAChD,GAAG,QAAQ,iBAA8B,kCAAkC,CAC7E,CAAC,GAAG;GACF,MAAM,KAAK,MAAM,aAAa,SAAS;GACvC,IAAI,CAAC,SAAS,EAAE,GAAG;GACnB,MAAM,SAAS,IAAI,IAAI,EAAE;GACzB,MAAM,UAAU,SAAS,sBAAsB,UAAU,wBAAwB;GACjF,IAAI,MAAM,gBAAgB,SAAS,MAAM,cAAc;GACvD,MAAM,SAAS,YAAY;GAC3B,MAAM,QAAQ,eAAe,OAAO,MAAM;GAE1C,MAAM,QADQ,MAAM,QAAQ,iBAAiB,KAAK,MAAM,cAAA,EACpC,cAAiC,kBAAkB,GAAG,GAAG;GAC7E,IAAI,SAAS,QAAQ,SAAS,KAAA,GAAW;IACvC,IAAI,WAAW,CAAC,QAAQ,KAAK,aAAa,iBAAiB,MAAM;SAC5D,KAAK,gBAAgB,eAAe;GAC3C;EACF;CACF;CACA,MAAM,iBAAuB;EAC3B,IAAI,YAAY,WAAW;EAC3B,YAAY;EACZ,qBAAqB;GACnB,YAAY;GACZ,IAAI,CAAC,UAAU,QAAa;EAC9B,CAAC;CACH;CACA,MAAM,WAAW,UAAuB;EAItC,IAHa,MACV,aAAa,CAAC,CACd,MAAM,WAAW,kBAAkB,WAAW,OAAO,QAAQ,2BAAyB,CACrF,MAAS,KAAA,KAAa,CAAC,MAAM,OAAO,GAAG;GACzC,MAAM,eAAe;GACrB,MAAM,yBAAyB;EACjC;CACF;CACA,MAAM,WAAW,IAAI,kBAAkB,YAAY;EAIjD,IAAI,QAAQ,MAAM,WAAW,CAAC,GAAG,OAAO,UAAU,CAAC,CAAC,MAAM,SAAS,gBAAgB,OAAO,CAAC,GAAG,SAAS;CACzG,CAAC;CACD,SAAS,QAAQ,MAAM,MAAM;EAAE,WAAW;EAAM,SAAS;CAAK,CAAC;CAC/D,KAAK,MAAM,QAAQ;EAAC;EAAU;EAAW;CAAW,GAAG,iBAAiB,MAAM,QAAQ;CACtF,MAAM,KAAK,iBAAiB,SAAS,SAAS,IAAI;CAClD,SAAS;CACT,aAAa;EACX,WAAW;EACX,cAAc;EACd,SAAS,WAAW;EACpB,KAAK,MAAM,QAAQ;GAAC;GAAU;GAAW;EAAW,GAAG,oBAAoB,MAAM,QAAQ;EACzF,MAAM,KAAK,oBAAoB,SAAS,SAAS,IAAI;CACvD;AACF"}

package/dist/client/control.d.ts

@@ -0,0 +1,3 @@
+import { type Control } from '../control.js';
+/** Reads the flag file. A failure (offline, a bad file) reads as no instruction. */
+export declare const readControl: () => Promise<Control | null>;

package/dist/client/control.js

@@ -0,0 +1,19 @@
+import { CONTROL_URL } from "../names.js";
+import { parseControl } from "../control.js";
+//#region src/client/control.ts
+/** Reads the flag file. A failure (offline, a bad file) reads as no instruction. */
+var readControl = async () => {
+	try {
+		const response = await fetch(CONTROL_URL, {
+			cache: "no-store",
+			credentials: "omit"
+		});
+		return response.ok ? parseControl(await response.json()) : null;
+	} catch {
+		return null;
+	}
+};
+//#endregion
+export { readControl };
+
+//# sourceMappingURL=control.js.map

package/dist/client/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","names":[],"sources":["../../src/client/control.ts"],"sourcesContent":["// The page reads the flag file (../control.ts) straight from the network: the worker never\n// caches it, and the request skips the HTTP cache too.\nimport { parseControl, type Control } from '../control.ts';\nimport { CONTROL_URL } from '../names.ts';\n\n/** Reads the flag file. A failure (offline, a bad file) reads as no instruction. */\nexport const readControl = async (): Promise<Control | null> => {\n  try {\n    const response = await fetch(CONTROL_URL, { cache: 'no-store', credentials: 'omit' });\n    return response.ok ? parseControl(await response.json()) : null;\n  } catch {\n    return null;\n  }\n};\n"],"mappings":";;;;AAMA,IAAa,cAAc,YAAqC;CAC9D,IAAI;EACF,MAAM,WAAW,MAAM,MAAM,aAAa;GAAE,OAAO;GAAY,aAAa;EAAO,CAAC;EACpF,OAAO,SAAS,KAAK,aAAa,MAAM,SAAS,KAAK,CAAC,IAAI;CAC7D,QAAQ;EACN,OAAO;CACT;AACF"}

package/dist/client/elements.d.ts

@@ -0,0 +1,45 @@
+import { type PinPorts } from './pins.js';
+/** `<jy-update-toast>`: says an update is ready and offers Refresh or Later. */
+export declare class UpdateToast extends HTMLElement {
+    #private;
+    /** Called with 'refresh' or 'later'. */
+    onChoice: (choice: 'refresh' | 'later') => void;
+    constructor();
+}
+/**
+ * `<jy-security-update>`: the forced update's notice (offline-and-updates.md, Rule 2). A
+ * modal dialog that takes focus and blocks the page: it gives the reason and one action,
+ * Update now. Escape doesn't close it; the page reloads instead.
+ */
+export declare class SecurityUpdate extends HTMLElement {
+    #private;
+    /** Called once, when the player chooses Update now. */
+    onUpdate: () => void;
+    constructor();
+    connectedCallback(): void;
+}
+/**
+ * `<jy-offline-toggle game-id="nim" game-name="Nim" assets="/games/nim/manifest.json">`: a
+ * toggle button that pins the game for offline play or removes it. It stays empty (its box
+ * reserved by the page's stylesheet) until a service worker is active, so a player never
+ * sees a control that can't work.
+ */
+export declare class OfflineToggle extends HTMLElement {
+    #private;
+    static readonly observedAttributes: string[];
+    /** Swapped in tests. */
+    ports: () => PinPorts;
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+}
+/** Registers the elements once. */
+export declare const definePwaElements: () => void;
+declare global {
+    interface HTMLElementTagNameMap {
+        'jy-update-toast': UpdateToast;
+        'jy-security-update': SecurityUpdate;
+        'jy-offline-toggle': OfflineToggle;
+    }
+}