@broberg/pwa 0.4.1 → 0.5.0

package/README.md

@@ -8,6 +8,11 @@ as one small, framework- and bundler-agnostic package instead of a fifth copy.
 npm i @broberg/pwa
 ```
 
+## 0.5.0 — PNG icons, so «Add to Home Screen» on an iPhone shows the logo (F021.9)
+
+New `pwa-icons` bin + `@broberg/pwa/raster` — see «PNG icons» below. Additive:
+nothing existing changed output, and the core entries are still dependency-free.
+
 ## 0.4.1 — «Update now» now always updates (F054.9)
 
 **Take 0.4.1 if you show an update button.** In 0.4.0 a press could do nothing,
@@ -226,8 +231,8 @@ new Serwist({ /* … */, skipWaiting: false, clientsClaim: true });
 The *other* half of a PWA: the `manifest.webmanifest`, the icon set, and the
 apple-touch `<meta>` tags — all as **pure, zero-dep** factories so you stop
 hand-rolling `app/manifest.ts`, a `gen-pwa-icons.cjs` script, and a wall of
-`<meta>` tags. Icons are emitted as self-contained **SVG** (modern manifests +
-apple-touch accept SVG); no rasteriser is bundled.
+`<meta>` tags. Icons are emitted as self-contained **SVG**; for the PNGs an
+iPhone needs, see «PNG icons» below (0.5.0).
 
 ```ts
 import { defineManifest, serializeManifest, buildIconSet, pwaMetaTags } from "@broberg/pwa/manifest";
@@ -251,8 +256,38 @@ pwaMetaTags({ themeColor: "#141969", title: "AK" });
   apple-touch `<link>`, not the manifest `icons[]`.
 - **Everything is a pure return value** — you own the filesystem write and the head
   render. Runs in a build script, a Route Handler, or the browser.
-- Need PNG? Rasterise the returned SVGs with `sharp` on your side — the package
-  stays dependency-free.
+- **iOS needs PNG.** Safari does not use an SVG `apple-touch-icon`: with only SVG
+  icons, «Add to Home Screen» on an iPhone shows a screenshot of the page instead
+  of the logo. (This README said the opposite until 0.5.0 — it was wrong.)
+
+## PNG icons — `pwa-icons` and `@broberg/pwa/raster` (0.5.0, F021.9)
+
+One command, run at build time; no sharp script per app:
+
+```sh
+npm i -D @resvg/resvg-js            # the renderer — an optional peer, prebuilt binaries
+npx pwa-icons --svg logo.svg --background "#141969" --out public/icons
+#   or: --monogram AK --color "#fff"     (also --base-path /icons)
+```
+
+It writes `icon-180/192/512.{svg,png}` + `icon-maskable-512.{svg,png}` and prints
+the manifest `icons[]` (PNG) and `appleTouchIcon`. Point the head tags at the PNG:
+
+```ts
+pwaMetaTags({ themeColor: "#141969", appleTouchIcon: "/icons/icon-180.png" });
+```
+
+Or in code:
+
+```ts
+import { buildIconSet } from "@broberg/pwa/manifest";
+import { rasterizeIconSet } from "@broberg/pwa/raster";
+const { files, icons, appleTouchIcon } = await rasterizeIconSet(buildIconSet({ svg, background: "#141969" }));
+// files → [{ path: "/icons/icon-180.png", content: Uint8Array, … }] — you write them
+```
+
+`@broberg/pwa` and `/manifest` stay dependency-free; only `/raster` and the bin
+need `@resvg/resvg-js`, and without it they fail with the install command.
 
 ## Gotchas (baked into this package so you don't rediscover them)
 

package/dist/bin.cjs

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+
+// src/manifest.ts
+var DEFAULT_SIZES = [180, 192, 512];
+function escapeXml(s) {
+  return s.replace(
+    /[<>&"']/g,
+    (c) => c === "<" ? "&lt;" : c === ">" ? "&gt;" : c === "&" ? "&amp;" : c === '"' ? "&quot;" : "&apos;"
+  );
+}
+function toBase64(s) {
+  const g = globalThis;
+  if (typeof g.Buffer !== "undefined") return g.Buffer.from(s, "utf-8").toString("base64");
+  const bytes = new TextEncoder().encode(s);
+  let bin = "";
+  for (const b of bytes) bin += String.fromCharCode(b);
+  return g.btoa(bin);
+}
+function renderIcon(size, inset, opts) {
+  const bg = opts.background ?? "#111827";
+  const fg = opts.color ?? "#ffffff";
+  const pad = Math.round(size * inset);
+  const inner = size - pad * 2;
+  let art;
+  if (opts.svg) {
+    const href = `data:image/svg+xml;base64,${toBase64(opts.svg)}`;
+    art = `<image x="${pad}" y="${pad}" width="${inner}" height="${inner}" href="${href}" preserveAspectRatio="xMidYMid meet"/>`;
+  } else {
+    const text = escapeXml((opts.monogram ?? "").slice(0, 3).toUpperCase());
+    const fontSize = Math.round(inner * (text.length >= 3 ? 0.42 : 0.52));
+    art = `<text x="50%" y="50%" fill="${fg}" font-family="system-ui, -apple-system, Segoe UI, Roboto, sans-serif" font-weight="700" font-size="${fontSize}" text-anchor="middle" dominant-baseline="central">${text}</text>`;
+  }
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${size}" height="${size}" viewBox="0 0 ${size} ${size}"><rect width="${size}" height="${size}" fill="${bg}"/>` + art + `</svg>`;
+}
+function buildIconSet(opts) {
+  if (!opts?.svg && !opts?.monogram) {
+    throw new Error("buildIconSet: provide either `svg` or `monogram`");
+  }
+  const base = (opts.basePath ?? "/icons").replace(/\/$/, "");
+  const sizes = opts.sizes ?? DEFAULT_SIZES;
+  const files = [];
+  const icons = [];
+  for (const size of sizes) {
+    const path = `${base}/icon-${size}.svg`;
+    files.push({ path, content: renderIcon(size, 0, opts), type: "image/svg+xml", size, purpose: "any" });
+    if (size !== 180) {
+      icons.push({ src: path, sizes: `${size}x${size}`, type: "image/svg+xml", purpose: "any" });
+    }
+  }
+  if (opts.maskable !== false) {
+    const path = `${base}/icon-maskable-512.svg`;
+    files.push({ path, content: renderIcon(512, 0.1, opts), type: "image/svg+xml", size: 512, purpose: "maskable" });
+    icons.push({ src: path, sizes: "512x512", type: "image/svg+xml", purpose: "maskable" });
+  }
+  return { files, icons };
+}
+
+// src/raster.ts
+var RESVG_MISSING = "rasterizeIconSet needs @resvg/resvg-js \u2014 install it as a dev dependency: npm i -D @resvg/resvg-js";
+var toPng = (p) => p.replace(/\.svg$/, ".png");
+async function rasterizeIconSet(set, opts = {}) {
+  let Resvg;
+  try {
+    ({ Resvg } = await import('@resvg/resvg-js'));
+  } catch {
+    throw new Error(RESVG_MISSING);
+  }
+  const files = set.files.map((f) => {
+    const png = new Resvg(f.content, {
+      fitTo: { mode: "width", value: f.size },
+      font: { loadSystemFonts: true, fontFiles: opts.fontFiles ?? [] }
+    }).render().asPng();
+    return { path: toPng(f.path), content: new Uint8Array(png), type: "image/png", size: f.size, purpose: f.purpose };
+  });
+  const icons = set.icons.map((i) => ({ ...i, src: toPng(i.src), type: "image/png" }));
+  const apple = files.find((f) => f.size === 180 && f.purpose === "any");
+  return { files, icons, appleTouchIcon: apple?.path };
+}
+
+// src/cli.ts
+var USAGE = "usage: pwa-icons (--svg <file> | --monogram <text>) [--background <hex>] [--color <hex>] [--out public/icons] [--base-path /icons]";
+async function main(argv) {
+  const arg = (name) => {
+    const i = argv.indexOf(`--${name}`);
+    return i >= 0 ? argv[i + 1] : void 0;
+  };
+  const svgFile = arg("svg");
+  const monogram = arg("monogram");
+  if (!svgFile && !monogram) {
+    console.error(`pwa-icons: give --svg <file> or --monogram <text>
+${USAGE}`);
+    return 1;
+  }
+  const out = arg("out") ?? "public/icons";
+  const set = buildIconSet({
+    svg: svgFile ? fs.readFileSync(svgFile, "utf8") : void 0,
+    monogram,
+    background: arg("background"),
+    color: arg("color"),
+    basePath: arg("base-path") ?? "/icons"
+  });
+  let raster;
+  try {
+    raster = await rasterizeIconSet(set);
+  } catch (e) {
+    console.error(`pwa-icons: ${e.message}`);
+    return 1;
+  }
+  fs.mkdirSync(out, { recursive: true });
+  for (const f of set.files) fs.writeFileSync(path.join(out, path.basename(f.path)), f.content);
+  for (const f of raster.files) fs.writeFileSync(path.join(out, path.basename(f.path)), f.content);
+  console.log(JSON.stringify({ icons: raster.icons, appleTouchIcon: raster.appleTouchIcon }, null, 2));
+  return 0;
+}
+
+// src/bin.ts
+main(process.argv.slice(2)).then((code) => process.exit(code));
+//# sourceMappingURL=bin.cjs.map
+//# sourceMappingURL=bin.cjs.map

package/dist/bin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manifest.ts","../src/raster.ts","../src/cli.ts","../src/bin.ts"],"names":["readFileSync","mkdirSync","writeFileSync","join","basename"],"mappings":"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","file":"bin.cjs","sourcesContent":["/**\n * @broberg/pwa/manifest — the PWA *install* half (the update half lives in the\n * root export). A dependency-free manifest/meta factory + an SVG-based icon\n * generator, so a repo stops hand-rolling `app/manifest.ts`, a\n * `gen-pwa-icons.cjs` script, and a pile of apple-touch `<meta>` tags.\n *\n * Everything here is PURE string/object generation — no filesystem, no\n * rasteriser, no runtime deps — so it runs in Node, Bun, edge, a build script,\n * or the browser, and every piece is offline-unit-testable. Icons are emitted\n * as self-contained SVG documents. iOS does NOT use an SVG apple-touch-icon —\n * rasterise with `@broberg/pwa/raster` / the `pwa-icons` bin (F021.9).\n */\n\n// ---------------------------------------------------------------------------\n// Manifest\n// ---------------------------------------------------------------------------\n\nexport type Display = \"standalone\" | \"fullscreen\" | \"minimal-ui\" | \"browser\";\n\nexport interface ManifestIcon {\n  src: string;\n  sizes: string;\n  type: string;\n  /** \"any\" | \"maskable\" | \"monochrome\" (space-separated allowed). */\n  purpose?: string;\n}\n\nexport interface WebAppManifest {\n  name: string;\n  short_name: string;\n  start_url: string;\n  scope: string;\n  display: Display;\n  theme_color: string;\n  background_color: string;\n  icons: ManifestIcon[];\n  description?: string;\n  lang?: string;\n  orientation?: string;\n  categories?: string[];\n  id?: string;\n  [key: string]: unknown;\n}\n\nexport interface DefineManifestOptions {\n  /** App name (required). */\n  name: string;\n  /** Home-screen label. Default: `name`. */\n  shortName?: string;\n  /** Default `/`. */\n  startUrl?: string;\n  /** Default `/`. */\n  scope?: string;\n  /** Default `standalone`. */\n  display?: Display;\n  /** Address-bar / task-switcher colour. Default `#ffffff`. */\n  themeColor?: string;\n  /** Splash background. Default `#ffffff`. */\n  backgroundColor?: string;\n  description?: string;\n  lang?: string;\n  orientation?: string;\n  categories?: string[];\n  id?: string;\n  /** Manifest `icons[]` — typically `buildIconSet(...).icons`. */\n  icons?: ManifestIcon[];\n  /** Escape hatch: extra top-level manifest members, merged last. */\n  extra?: Record<string, unknown>;\n}\n\n/**\n * Build a spec-valid Web App Manifest object. Required members are defaulted so\n * a one-liner produces an installable manifest; every default is overridable\n * and `extra` merges last for anything not modelled (shortcuts, screenshots…).\n */\nexport function defineManifest(opts: DefineManifestOptions): WebAppManifest {\n  if (!opts?.name) throw new Error(\"defineManifest: `name` is required\");\n  const manifest: WebAppManifest = {\n    name: opts.name,\n    short_name: opts.shortName ?? opts.name,\n    start_url: opts.startUrl ?? \"/\",\n    scope: opts.scope ?? \"/\",\n    display: opts.display ?? \"standalone\",\n    theme_color: opts.themeColor ?? \"#ffffff\",\n    background_color: opts.backgroundColor ?? \"#ffffff\",\n    icons: opts.icons ?? [],\n  };\n  if (opts.description) manifest.description = opts.description;\n  if (opts.lang) manifest.lang = opts.lang;\n  if (opts.orientation) manifest.orientation = opts.orientation;\n  if (opts.categories) manifest.categories = opts.categories;\n  if (opts.id) manifest.id = opts.id;\n  return { ...manifest, ...(opts.extra ?? {}) };\n}\n\n/** JSON-stringify a manifest for a `manifest.webmanifest` file. */\nexport function serializeManifest(\n  manifest: WebAppManifest,\n  opts: { pretty?: boolean } = {},\n): string {\n  return JSON.stringify(manifest, null, opts.pretty === false ? undefined : 2);\n}\n\n// ---------------------------------------------------------------------------\n// Icon generation (SVG, zero-dep)\n// ---------------------------------------------------------------------------\n\nexport interface GeneratedIcon {\n  /** URL path, e.g. `/icons/icon-192.svg`. */\n  path: string;\n  /** The SVG document. */\n  content: string;\n  type: \"image/svg+xml\";\n  size: number;\n  purpose: \"any\" | \"maskable\";\n}\n\nexport interface IconSet {\n  files: GeneratedIcon[];\n  /** Ready to drop into `defineManifest({ icons })`. */\n  icons: ManifestIcon[];\n}\n\nexport interface IconSetOptions {\n  /**\n   * Source artwork as a full SVG document (`<svg …>…</svg>`). Embedded via a\n   * data-URI `<image>` so it scales cleanly at any size regardless of its\n   * internal coordinate system. Mutually exclusive with `monogram`.\n   */\n  svg?: string;\n  /** Fallback artwork: 1–3 letters rendered centred (e.g. \"AK\"). */\n  monogram?: string;\n  /** Foreground (monogram text) colour. Default `#ffffff`. */\n  color?: string;\n  /** Background fill. Default `#111827`. */\n  background?: string;\n  /** Icon sizes to emit. Default `[180, 192, 512]` (180 = apple-touch). */\n  sizes?: number[];\n  /** Also emit a maskable 512 with a padded safe-zone. Default `true`. */\n  maskable?: boolean;\n  /** URL prefix for every icon `src`. Default `/icons`. */\n  basePath?: string;\n}\n\nconst DEFAULT_SIZES = [180, 192, 512];\n\nfunction escapeXml(s: string): string {\n  return s.replace(/[<>&\"']/g, (c) =>\n    c === \"<\" ? \"&lt;\" : c === \">\" ? \"&gt;\" : c === \"&\" ? \"&amp;\" : c === '\"' ? \"&quot;\" : \"&apos;\",\n  );\n}\n\n/** UTF-8-safe base64 for the data-URI embed (works in Node/Bun/browser). */\nfunction toBase64(s: string): string {\n  // Reached via globalThis so the package needs no @types/node (browser-safe).\n  const g = globalThis as unknown as {\n    Buffer?: { from(input: string, enc: string): { toString(enc: string): string } };\n    btoa?: (data: string) => string;\n  };\n  if (typeof g.Buffer !== \"undefined\") return g.Buffer.from(s, \"utf-8\").toString(\"base64\");\n  const bytes = new TextEncoder().encode(s);\n  let bin = \"\";\n  for (const b of bytes) bin += String.fromCharCode(b);\n  return g.btoa!(bin);\n}\n\n/** Render one square SVG icon document at `size`. `inset` = safe-zone fraction (maskable). */\nfunction renderIcon(size: number, inset: number, opts: IconSetOptions): string {\n  const bg = opts.background ?? \"#111827\";\n  const fg = opts.color ?? \"#ffffff\";\n  const pad = Math.round(size * inset);\n  const inner = size - pad * 2;\n  let art: string;\n  if (opts.svg) {\n    const href = `data:image/svg+xml;base64,${toBase64(opts.svg)}`;\n    art = `<image x=\"${pad}\" y=\"${pad}\" width=\"${inner}\" height=\"${inner}\" href=\"${href}\" preserveAspectRatio=\"xMidYMid meet\"/>`;\n  } else {\n    const text = escapeXml((opts.monogram ?? \"\").slice(0, 3).toUpperCase());\n    // Font sized to the safe inner box; a touch smaller for breathing room.\n    const fontSize = Math.round(inner * (text.length >= 3 ? 0.42 : 0.52));\n    art =\n      `<text x=\"50%\" y=\"50%\" fill=\"${fg}\" font-family=\"system-ui, -apple-system, Segoe UI, Roboto, sans-serif\" ` +\n      `font-weight=\"700\" font-size=\"${fontSize}\" text-anchor=\"middle\" dominant-baseline=\"central\">${text}</text>`;\n  }\n  return (\n    `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${size}\" height=\"${size}\" viewBox=\"0 0 ${size} ${size}\">` +\n    `<rect width=\"${size}\" height=\"${size}\" fill=\"${bg}\"/>` +\n    art +\n    `</svg>`\n  );\n}\n\n/**\n * Generate a full icon set (SVG) + the matching manifest `icons[]`. Deterministic,\n * zero-dep. Give it either a source `svg` or a `monogram`; it emits apple-touch\n * (180), 192, 512 by default plus a padded maskable-512.\n */\nexport function buildIconSet(opts: IconSetOptions): IconSet {\n  if (!opts?.svg && !opts?.monogram) {\n    throw new Error(\"buildIconSet: provide either `svg` or `monogram`\");\n  }\n  const base = (opts.basePath ?? \"/icons\").replace(/\\/$/, \"\");\n  const sizes = opts.sizes ?? DEFAULT_SIZES;\n  const files: GeneratedIcon[] = [];\n  const icons: ManifestIcon[] = [];\n\n  for (const size of sizes) {\n    const path = `${base}/icon-${size}.svg`;\n    files.push({ path, content: renderIcon(size, 0, opts), type: \"image/svg+xml\", size, purpose: \"any\" });\n    // apple-touch-icon is referenced via a <link> (see pwaMetaTags), not the\n    // manifest, so only real manifest sizes go into icons[].\n    if (size !== 180) {\n      icons.push({ src: path, sizes: `${size}x${size}`, type: \"image/svg+xml\", purpose: \"any\" });\n    }\n  }\n\n  if (opts.maskable !== false) {\n    // Maskable safe-zone: keep content within the central 80% (10% inset).\n    const path = `${base}/icon-maskable-512.svg`;\n    files.push({ path, content: renderIcon(512, 0.1, opts), type: \"image/svg+xml\", size: 512, purpose: \"maskable\" });\n    icons.push({ src: path, sizes: \"512x512\", type: \"image/svg+xml\", purpose: \"maskable\" });\n  }\n\n  return { files, icons };\n}\n\n// ---------------------------------------------------------------------------\n// Head meta tags\n// ---------------------------------------------------------------------------\n\nexport interface MetaTag {\n  tag: \"meta\" | \"link\";\n  attrs: Record<string, string>;\n}\n\nexport interface MetaTagsOptions {\n  /** `<meta name=\"theme-color\">`. Default `#ffffff`. */\n  themeColor?: string;\n  /** apple-touch-icon href. Default `/icons/icon-180.svg`. */\n  appleTouchIcon?: string;\n  /** Manifest href for the `<link rel=\"manifest\">`. Default `/manifest.webmanifest`. */\n  manifest?: string;\n  /** apple-mobile-web-app-title. Default: omitted. */\n  title?: string;\n  /** apple-mobile-web-app-status-bar-style. Default `default`. */\n  statusBarStyle?: \"default\" | \"black\" | \"black-translucent\";\n  /** Emit the `*-web-app-capable` tags. Default `true`. */\n  capable?: boolean;\n}\n\n/**\n * The head tags a PWA needs beyond the manifest link — returned as typed\n * descriptors so a consumer renders them in Next.js `metadata`, a Hono/JSX\n * head, or plain HTML. No framework assumption.\n */\nexport function pwaMetaTags(opts: MetaTagsOptions = {}): MetaTag[] {\n  const tags: MetaTag[] = [];\n  tags.push({ tag: \"link\", attrs: { rel: \"manifest\", href: opts.manifest ?? \"/manifest.webmanifest\" } });\n  tags.push({ tag: \"meta\", attrs: { name: \"theme-color\", content: opts.themeColor ?? \"#ffffff\" } });\n  tags.push({ tag: \"link\", attrs: { rel: \"apple-touch-icon\", href: opts.appleTouchIcon ?? \"/icons/icon-180.svg\" } });\n  if (opts.capable !== false) {\n    tags.push({ tag: \"meta\", attrs: { name: \"mobile-web-app-capable\", content: \"yes\" } });\n    tags.push({ tag: \"meta\", attrs: { name: \"apple-mobile-web-app-capable\", content: \"yes\" } });\n    tags.push({\n      tag: \"meta\",\n      attrs: { name: \"apple-mobile-web-app-status-bar-style\", content: opts.statusBarStyle ?? \"default\" },\n    });\n  }\n  if (opts.title) {\n    tags.push({ tag: \"meta\", attrs: { name: \"apple-mobile-web-app-title\", content: opts.title } });\n  }\n  return tags;\n}\n","/**\n * @broberg/pwa/raster — F021.9: PNG icons, because iOS does not use an SVG\n * apple-touch-icon. «Add to Home Screen» on an iPhone with only SVG icons shows\n * a screenshot of the page instead of the logo (measured by sales, 10/10).\n *\n * Kept OUT of the core entries so `@broberg/pwa` and `/manifest` stay\n * dependency-free: the renderer, @resvg/resvg-js (prebuilt binaries, no system\n * libraries), is an optional peer loaded only when this runs.\n */\nimport type { IconSet, ManifestIcon } from \"./manifest.js\";\n\nexport interface RasterIcon {\n  /** URL path, e.g. `/icons/icon-180.png`. */\n  path: string;\n  content: Uint8Array;\n  type: \"image/png\";\n  size: number;\n  purpose: \"any\" | \"maskable\";\n}\n\nexport interface RasterIconSet {\n  files: RasterIcon[];\n  /** Manifest `icons[]` pointing at the PNGs. */\n  icons: ManifestIcon[];\n  /** Href for `<link rel=\"apple-touch-icon\">` — pass it to `pwaMetaTags({ appleTouchIcon })`. Undefined when 180 was not generated. */\n  appleTouchIcon?: string;\n}\n\nexport interface RasterizeOptions {\n  /** Extra font files for monogram text (system fonts are loaded too). */\n  fontFiles?: string[];\n}\n\nexport const RESVG_MISSING =\n  \"rasterizeIconSet needs @resvg/resvg-js — install it as a dev dependency: npm i -D @resvg/resvg-js\";\n\nconst toPng = (p: string) => p.replace(/\\.svg$/, \".png\");\n\n/** Rasterise every SVG from `buildIconSet` to a PNG of the same size. */\nexport async function rasterizeIconSet(set: IconSet, opts: RasterizeOptions = {}): Promise<RasterIconSet> {\n  let Resvg: typeof import(\"@resvg/resvg-js\").Resvg;\n  try {\n    ({ Resvg } = await import(\"@resvg/resvg-js\"));\n  } catch {\n    throw new Error(RESVG_MISSING);\n  }\n  const files: RasterIcon[] = set.files.map((f) => {\n    const png = new Resvg(f.content, {\n      fitTo: { mode: \"width\", value: f.size },\n      font: { loadSystemFonts: true, fontFiles: opts.fontFiles ?? [] },\n    })\n      .render()\n      .asPng();\n    return { path: toPng(f.path), content: new Uint8Array(png), type: \"image/png\", size: f.size, purpose: f.purpose };\n  });\n  const icons = set.icons.map((i) => ({ ...i, src: toPng(i.src), type: \"image/png\" }));\n  const apple = files.find((f) => f.size === 180 && f.purpose === \"any\");\n  return { files, icons, appleTouchIcon: apple?.path };\n}\n","/// <reference types=\"node\" />\n// F021.9 — `pwa-icons`: SVG + PNG icon set in one command, so no app keeps its\n// own sharp script. Prints the manifest icons[] and the apple-touch href.\nimport { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { basename, join } from \"node:path\";\nimport { buildIconSet } from \"./manifest.js\";\nimport { rasterizeIconSet } from \"./raster.js\";\n\nconst USAGE =\n  \"usage: pwa-icons (--svg <file> | --monogram <text>) [--background <hex>] [--color <hex>] [--out public/icons] [--base-path /icons]\";\n\nexport async function main(argv: string[]): Promise<number> {\n  const arg = (name: string) => {\n    const i = argv.indexOf(`--${name}`);\n    return i >= 0 ? argv[i + 1] : undefined;\n  };\n  const svgFile = arg(\"svg\");\n  const monogram = arg(\"monogram\");\n  if (!svgFile && !monogram) {\n    console.error(`pwa-icons: give --svg <file> or --monogram <text>\\n${USAGE}`);\n    return 1;\n  }\n  const out = arg(\"out\") ?? \"public/icons\";\n  const set = buildIconSet({\n    svg: svgFile ? readFileSync(svgFile, \"utf8\") : undefined,\n    monogram,\n    background: arg(\"background\"),\n    color: arg(\"color\"),\n    basePath: arg(\"base-path\") ?? \"/icons\",\n  });\n  let raster;\n  try {\n    raster = await rasterizeIconSet(set);\n  } catch (e) {\n    console.error(`pwa-icons: ${(e as Error).message}`);\n    return 1;\n  }\n  mkdirSync(out, { recursive: true });\n  for (const f of set.files) writeFileSync(join(out, basename(f.path)), f.content);\n  for (const f of raster.files) writeFileSync(join(out, basename(f.path)), f.content);\n  console.log(JSON.stringify({ icons: raster.icons, appleTouchIcon: raster.appleTouchIcon }, null, 2));\n  return 0;\n}\n\n","#!/usr/bin/env node\n/// <reference types=\"node\" />\n// F021.9 — the `pwa-icons` entry point; the logic lives in cli.ts so tests can call it.\nimport { main } from \"./cli.js\";\n\nmain(process.argv.slice(2)).then((code) => process.exit(code));\n"]}

package/dist/bin.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+import { rasterizeIconSet } from './chunk-JWKQNVNE.js';
+import { readFileSync, mkdirSync, writeFileSync } from 'fs';
+import { join, basename } from 'path';
+
+// src/manifest.ts
+var DEFAULT_SIZES = [180, 192, 512];
+function escapeXml(s) {
+  return s.replace(
+    /[<>&"']/g,
+    (c) => c === "<" ? "&lt;" : c === ">" ? "&gt;" : c === "&" ? "&amp;" : c === '"' ? "&quot;" : "&apos;"
+  );
+}
+function toBase64(s) {
+  const g = globalThis;
+  if (typeof g.Buffer !== "undefined") return g.Buffer.from(s, "utf-8").toString("base64");
+  const bytes = new TextEncoder().encode(s);
+  let bin = "";
+  for (const b of bytes) bin += String.fromCharCode(b);
+  return g.btoa(bin);
+}
+function renderIcon(size, inset, opts) {
+  const bg = opts.background ?? "#111827";
+  const fg = opts.color ?? "#ffffff";
+  const pad = Math.round(size * inset);
+  const inner = size - pad * 2;
+  let art;
+  if (opts.svg) {
+    const href = `data:image/svg+xml;base64,${toBase64(opts.svg)}`;
+    art = `<image x="${pad}" y="${pad}" width="${inner}" height="${inner}" href="${href}" preserveAspectRatio="xMidYMid meet"/>`;
+  } else {
+    const text = escapeXml((opts.monogram ?? "").slice(0, 3).toUpperCase());
+    const fontSize = Math.round(inner * (text.length >= 3 ? 0.42 : 0.52));
+    art = `<text x="50%" y="50%" fill="${fg}" font-family="system-ui, -apple-system, Segoe UI, Roboto, sans-serif" font-weight="700" font-size="${fontSize}" text-anchor="middle" dominant-baseline="central">${text}</text>`;
+  }
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${size}" height="${size}" viewBox="0 0 ${size} ${size}"><rect width="${size}" height="${size}" fill="${bg}"/>` + art + `</svg>`;
+}
+function buildIconSet(opts) {
+  if (!opts?.svg && !opts?.monogram) {
+    throw new Error("buildIconSet: provide either `svg` or `monogram`");
+  }
+  const base = (opts.basePath ?? "/icons").replace(/\/$/, "");
+  const sizes = opts.sizes ?? DEFAULT_SIZES;
+  const files = [];
+  const icons = [];
+  for (const size of sizes) {
+    const path = `${base}/icon-${size}.svg`;
+    files.push({ path, content: renderIcon(size, 0, opts), type: "image/svg+xml", size, purpose: "any" });
+    if (size !== 180) {
+      icons.push({ src: path, sizes: `${size}x${size}`, type: "image/svg+xml", purpose: "any" });
+    }
+  }
+  if (opts.maskable !== false) {
+    const path = `${base}/icon-maskable-512.svg`;
+    files.push({ path, content: renderIcon(512, 0.1, opts), type: "image/svg+xml", size: 512, purpose: "maskable" });
+    icons.push({ src: path, sizes: "512x512", type: "image/svg+xml", purpose: "maskable" });
+  }
+  return { files, icons };
+}
+
+// src/cli.ts
+var USAGE = "usage: pwa-icons (--svg <file> | --monogram <text>) [--background <hex>] [--color <hex>] [--out public/icons] [--base-path /icons]";
+async function main(argv) {
+  const arg = (name) => {
+    const i = argv.indexOf(`--${name}`);
+    return i >= 0 ? argv[i + 1] : void 0;
+  };
+  const svgFile = arg("svg");
+  const monogram = arg("monogram");
+  if (!svgFile && !monogram) {
+    console.error(`pwa-icons: give --svg <file> or --monogram <text>
+${USAGE}`);
+    return 1;
+  }
+  const out = arg("out") ?? "public/icons";
+  const set = buildIconSet({
+    svg: svgFile ? readFileSync(svgFile, "utf8") : void 0,
+    monogram,
+    background: arg("background"),
+    color: arg("color"),
+    basePath: arg("base-path") ?? "/icons"
+  });
+  let raster;
+  try {
+    raster = await rasterizeIconSet(set);
+  } catch (e) {
+    console.error(`pwa-icons: ${e.message}`);
+    return 1;
+  }
+  mkdirSync(out, { recursive: true });
+  for (const f of set.files) writeFileSync(join(out, basename(f.path)), f.content);
+  for (const f of raster.files) writeFileSync(join(out, basename(f.path)), f.content);
+  console.log(JSON.stringify({ icons: raster.icons, appleTouchIcon: raster.appleTouchIcon }, null, 2));
+  return 0;
+}
+
+// src/bin.ts
+main(process.argv.slice(2)).then((code) => process.exit(code));
+//# sourceMappingURL=bin.js.map
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manifest.ts","../src/cli.ts","../src/bin.ts"],"names":[],"mappings":"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","file":"bin.js","sourcesContent":["/**\n * @broberg/pwa/manifest — the PWA *install* half (the update half lives in the\n * root export). A dependency-free manifest/meta factory + an SVG-based icon\n * generator, so a repo stops hand-rolling `app/manifest.ts`, a\n * `gen-pwa-icons.cjs` script, and a pile of apple-touch `<meta>` tags.\n *\n * Everything here is PURE string/object generation — no filesystem, no\n * rasteriser, no runtime deps — so it runs in Node, Bun, edge, a build script,\n * or the browser, and every piece is offline-unit-testable. Icons are emitted\n * as self-contained SVG documents. iOS does NOT use an SVG apple-touch-icon —\n * rasterise with `@broberg/pwa/raster` / the `pwa-icons` bin (F021.9).\n */\n\n// ---------------------------------------------------------------------------\n// Manifest\n// ---------------------------------------------------------------------------\n\nexport type Display = \"standalone\" | \"fullscreen\" | \"minimal-ui\" | \"browser\";\n\nexport interface ManifestIcon {\n  src: string;\n  sizes: string;\n  type: string;\n  /** \"any\" | \"maskable\" | \"monochrome\" (space-separated allowed). */\n  purpose?: string;\n}\n\nexport interface WebAppManifest {\n  name: string;\n  short_name: string;\n  start_url: string;\n  scope: string;\n  display: Display;\n  theme_color: string;\n  background_color: string;\n  icons: ManifestIcon[];\n  description?: string;\n  lang?: string;\n  orientation?: string;\n  categories?: string[];\n  id?: string;\n  [key: string]: unknown;\n}\n\nexport interface DefineManifestOptions {\n  /** App name (required). */\n  name: string;\n  /** Home-screen label. Default: `name`. */\n  shortName?: string;\n  /** Default `/`. */\n  startUrl?: string;\n  /** Default `/`. */\n  scope?: string;\n  /** Default `standalone`. */\n  display?: Display;\n  /** Address-bar / task-switcher colour. Default `#ffffff`. */\n  themeColor?: string;\n  /** Splash background. Default `#ffffff`. */\n  backgroundColor?: string;\n  description?: string;\n  lang?: string;\n  orientation?: string;\n  categories?: string[];\n  id?: string;\n  /** Manifest `icons[]` — typically `buildIconSet(...).icons`. */\n  icons?: ManifestIcon[];\n  /** Escape hatch: extra top-level manifest members, merged last. */\n  extra?: Record<string, unknown>;\n}\n\n/**\n * Build a spec-valid Web App Manifest object. Required members are defaulted so\n * a one-liner produces an installable manifest; every default is overridable\n * and `extra` merges last for anything not modelled (shortcuts, screenshots…).\n */\nexport function defineManifest(opts: DefineManifestOptions): WebAppManifest {\n  if (!opts?.name) throw new Error(\"defineManifest: `name` is required\");\n  const manifest: WebAppManifest = {\n    name: opts.name,\n    short_name: opts.shortName ?? opts.name,\n    start_url: opts.startUrl ?? \"/\",\n    scope: opts.scope ?? \"/\",\n    display: opts.display ?? \"standalone\",\n    theme_color: opts.themeColor ?? \"#ffffff\",\n    background_color: opts.backgroundColor ?? \"#ffffff\",\n    icons: opts.icons ?? [],\n  };\n  if (opts.description) manifest.description = opts.description;\n  if (opts.lang) manifest.lang = opts.lang;\n  if (opts.orientation) manifest.orientation = opts.orientation;\n  if (opts.categories) manifest.categories = opts.categories;\n  if (opts.id) manifest.id = opts.id;\n  return { ...manifest, ...(opts.extra ?? {}) };\n}\n\n/** JSON-stringify a manifest for a `manifest.webmanifest` file. */\nexport function serializeManifest(\n  manifest: WebAppManifest,\n  opts: { pretty?: boolean } = {},\n): string {\n  return JSON.stringify(manifest, null, opts.pretty === false ? undefined : 2);\n}\n\n// ---------------------------------------------------------------------------\n// Icon generation (SVG, zero-dep)\n// ---------------------------------------------------------------------------\n\nexport interface GeneratedIcon {\n  /** URL path, e.g. `/icons/icon-192.svg`. */\n  path: string;\n  /** The SVG document. */\n  content: string;\n  type: \"image/svg+xml\";\n  size: number;\n  purpose: \"any\" | \"maskable\";\n}\n\nexport interface IconSet {\n  files: GeneratedIcon[];\n  /** Ready to drop into `defineManifest({ icons })`. */\n  icons: ManifestIcon[];\n}\n\nexport interface IconSetOptions {\n  /**\n   * Source artwork as a full SVG document (`<svg …>…</svg>`). Embedded via a\n   * data-URI `<image>` so it scales cleanly at any size regardless of its\n   * internal coordinate system. Mutually exclusive with `monogram`.\n   */\n  svg?: string;\n  /** Fallback artwork: 1–3 letters rendered centred (e.g. \"AK\"). */\n  monogram?: string;\n  /** Foreground (monogram text) colour. Default `#ffffff`. */\n  color?: string;\n  /** Background fill. Default `#111827`. */\n  background?: string;\n  /** Icon sizes to emit. Default `[180, 192, 512]` (180 = apple-touch). */\n  sizes?: number[];\n  /** Also emit a maskable 512 with a padded safe-zone. Default `true`. */\n  maskable?: boolean;\n  /** URL prefix for every icon `src`. Default `/icons`. */\n  basePath?: string;\n}\n\nconst DEFAULT_SIZES = [180, 192, 512];\n\nfunction escapeXml(s: string): string {\n  return s.replace(/[<>&\"']/g, (c) =>\n    c === \"<\" ? \"&lt;\" : c === \">\" ? \"&gt;\" : c === \"&\" ? \"&amp;\" : c === '\"' ? \"&quot;\" : \"&apos;\",\n  );\n}\n\n/** UTF-8-safe base64 for the data-URI embed (works in Node/Bun/browser). */\nfunction toBase64(s: string): string {\n  // Reached via globalThis so the package needs no @types/node (browser-safe).\n  const g = globalThis as unknown as {\n    Buffer?: { from(input: string, enc: string): { toString(enc: string): string } };\n    btoa?: (data: string) => string;\n  };\n  if (typeof g.Buffer !== \"undefined\") return g.Buffer.from(s, \"utf-8\").toString(\"base64\");\n  const bytes = new TextEncoder().encode(s);\n  let bin = \"\";\n  for (const b of bytes) bin += String.fromCharCode(b);\n  return g.btoa!(bin);\n}\n\n/** Render one square SVG icon document at `size`. `inset` = safe-zone fraction (maskable). */\nfunction renderIcon(size: number, inset: number, opts: IconSetOptions): string {\n  const bg = opts.background ?? \"#111827\";\n  const fg = opts.color ?? \"#ffffff\";\n  const pad = Math.round(size * inset);\n  const inner = size - pad * 2;\n  let art: string;\n  if (opts.svg) {\n    const href = `data:image/svg+xml;base64,${toBase64(opts.svg)}`;\n    art = `<image x=\"${pad}\" y=\"${pad}\" width=\"${inner}\" height=\"${inner}\" href=\"${href}\" preserveAspectRatio=\"xMidYMid meet\"/>`;\n  } else {\n    const text = escapeXml((opts.monogram ?? \"\").slice(0, 3).toUpperCase());\n    // Font sized to the safe inner box; a touch smaller for breathing room.\n    const fontSize = Math.round(inner * (text.length >= 3 ? 0.42 : 0.52));\n    art =\n      `<text x=\"50%\" y=\"50%\" fill=\"${fg}\" font-family=\"system-ui, -apple-system, Segoe UI, Roboto, sans-serif\" ` +\n      `font-weight=\"700\" font-size=\"${fontSize}\" text-anchor=\"middle\" dominant-baseline=\"central\">${text}</text>`;\n  }\n  return (\n    `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${size}\" height=\"${size}\" viewBox=\"0 0 ${size} ${size}\">` +\n    `<rect width=\"${size}\" height=\"${size}\" fill=\"${bg}\"/>` +\n    art +\n    `</svg>`\n  );\n}\n\n/**\n * Generate a full icon set (SVG) + the matching manifest `icons[]`. Deterministic,\n * zero-dep. Give it either a source `svg` or a `monogram`; it emits apple-touch\n * (180), 192, 512 by default plus a padded maskable-512.\n */\nexport function buildIconSet(opts: IconSetOptions): IconSet {\n  if (!opts?.svg && !opts?.monogram) {\n    throw new Error(\"buildIconSet: provide either `svg` or `monogram`\");\n  }\n  const base = (opts.basePath ?? \"/icons\").replace(/\\/$/, \"\");\n  const sizes = opts.sizes ?? DEFAULT_SIZES;\n  const files: GeneratedIcon[] = [];\n  const icons: ManifestIcon[] = [];\n\n  for (const size of sizes) {\n    const path = `${base}/icon-${size}.svg`;\n    files.push({ path, content: renderIcon(size, 0, opts), type: \"image/svg+xml\", size, purpose: \"any\" });\n    // apple-touch-icon is referenced via a <link> (see pwaMetaTags), not the\n    // manifest, so only real manifest sizes go into icons[].\n    if (size !== 180) {\n      icons.push({ src: path, sizes: `${size}x${size}`, type: \"image/svg+xml\", purpose: \"any\" });\n    }\n  }\n\n  if (opts.maskable !== false) {\n    // Maskable safe-zone: keep content within the central 80% (10% inset).\n    const path = `${base}/icon-maskable-512.svg`;\n    files.push({ path, content: renderIcon(512, 0.1, opts), type: \"image/svg+xml\", size: 512, purpose: \"maskable\" });\n    icons.push({ src: path, sizes: \"512x512\", type: \"image/svg+xml\", purpose: \"maskable\" });\n  }\n\n  return { files, icons };\n}\n\n// ---------------------------------------------------------------------------\n// Head meta tags\n// ---------------------------------------------------------------------------\n\nexport interface MetaTag {\n  tag: \"meta\" | \"link\";\n  attrs: Record<string, string>;\n}\n\nexport interface MetaTagsOptions {\n  /** `<meta name=\"theme-color\">`. Default `#ffffff`. */\n  themeColor?: string;\n  /** apple-touch-icon href. Default `/icons/icon-180.svg`. */\n  appleTouchIcon?: string;\n  /** Manifest href for the `<link rel=\"manifest\">`. Default `/manifest.webmanifest`. */\n  manifest?: string;\n  /** apple-mobile-web-app-title. Default: omitted. */\n  title?: string;\n  /** apple-mobile-web-app-status-bar-style. Default `default`. */\n  statusBarStyle?: \"default\" | \"black\" | \"black-translucent\";\n  /** Emit the `*-web-app-capable` tags. Default `true`. */\n  capable?: boolean;\n}\n\n/**\n * The head tags a PWA needs beyond the manifest link — returned as typed\n * descriptors so a consumer renders them in Next.js `metadata`, a Hono/JSX\n * head, or plain HTML. No framework assumption.\n */\nexport function pwaMetaTags(opts: MetaTagsOptions = {}): MetaTag[] {\n  const tags: MetaTag[] = [];\n  tags.push({ tag: \"link\", attrs: { rel: \"manifest\", href: opts.manifest ?? \"/manifest.webmanifest\" } });\n  tags.push({ tag: \"meta\", attrs: { name: \"theme-color\", content: opts.themeColor ?? \"#ffffff\" } });\n  tags.push({ tag: \"link\", attrs: { rel: \"apple-touch-icon\", href: opts.appleTouchIcon ?? \"/icons/icon-180.svg\" } });\n  if (opts.capable !== false) {\n    tags.push({ tag: \"meta\", attrs: { name: \"mobile-web-app-capable\", content: \"yes\" } });\n    tags.push({ tag: \"meta\", attrs: { name: \"apple-mobile-web-app-capable\", content: \"yes\" } });\n    tags.push({\n      tag: \"meta\",\n      attrs: { name: \"apple-mobile-web-app-status-bar-style\", content: opts.statusBarStyle ?? \"default\" },\n    });\n  }\n  if (opts.title) {\n    tags.push({ tag: \"meta\", attrs: { name: \"apple-mobile-web-app-title\", content: opts.title } });\n  }\n  return tags;\n}\n","/// <reference types=\"node\" />\n// F021.9 — `pwa-icons`: SVG + PNG icon set in one command, so no app keeps its\n// own sharp script. Prints the manifest icons[] and the apple-touch href.\nimport { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { basename, join } from \"node:path\";\nimport { buildIconSet } from \"./manifest.js\";\nimport { rasterizeIconSet } from \"./raster.js\";\n\nconst USAGE =\n  \"usage: pwa-icons (--svg <file> | --monogram <text>) [--background <hex>] [--color <hex>] [--out public/icons] [--base-path /icons]\";\n\nexport async function main(argv: string[]): Promise<number> {\n  const arg = (name: string) => {\n    const i = argv.indexOf(`--${name}`);\n    return i >= 0 ? argv[i + 1] : undefined;\n  };\n  const svgFile = arg(\"svg\");\n  const monogram = arg(\"monogram\");\n  if (!svgFile && !monogram) {\n    console.error(`pwa-icons: give --svg <file> or --monogram <text>\\n${USAGE}`);\n    return 1;\n  }\n  const out = arg(\"out\") ?? \"public/icons\";\n  const set = buildIconSet({\n    svg: svgFile ? readFileSync(svgFile, \"utf8\") : undefined,\n    monogram,\n    background: arg(\"background\"),\n    color: arg(\"color\"),\n    basePath: arg(\"base-path\") ?? \"/icons\",\n  });\n  let raster;\n  try {\n    raster = await rasterizeIconSet(set);\n  } catch (e) {\n    console.error(`pwa-icons: ${(e as Error).message}`);\n    return 1;\n  }\n  mkdirSync(out, { recursive: true });\n  for (const f of set.files) writeFileSync(join(out, basename(f.path)), f.content);\n  for (const f of raster.files) writeFileSync(join(out, basename(f.path)), f.content);\n  console.log(JSON.stringify({ icons: raster.icons, appleTouchIcon: raster.appleTouchIcon }, null, 2));\n  return 0;\n}\n\n","#!/usr/bin/env node\n/// <reference types=\"node\" />\n// F021.9 — the `pwa-icons` entry point; the logic lives in cli.ts so tests can call it.\nimport { main } from \"./cli.js\";\n\nmain(process.argv.slice(2)).then((code) => process.exit(code));\n"]}

package/dist/chunk-JWKQNVNE.js

@@ -0,0 +1,25 @@
+// src/raster.ts
+var RESVG_MISSING = "rasterizeIconSet needs @resvg/resvg-js \u2014 install it as a dev dependency: npm i -D @resvg/resvg-js";
+var toPng = (p) => p.replace(/\.svg$/, ".png");
+async function rasterizeIconSet(set, opts = {}) {
+  let Resvg;
+  try {
+    ({ Resvg } = await import('@resvg/resvg-js'));
+  } catch {
+    throw new Error(RESVG_MISSING);
+  }
+  const files = set.files.map((f) => {
+    const png = new Resvg(f.content, {
+      fitTo: { mode: "width", value: f.size },
+      font: { loadSystemFonts: true, fontFiles: opts.fontFiles ?? [] }
+    }).render().asPng();
+    return { path: toPng(f.path), content: new Uint8Array(png), type: "image/png", size: f.size, purpose: f.purpose };
+  });
+  const icons = set.icons.map((i) => ({ ...i, src: toPng(i.src), type: "image/png" }));
+  const apple = files.find((f) => f.size === 180 && f.purpose === "any");
+  return { files, icons, appleTouchIcon: apple?.path };
+}
+
+export { RESVG_MISSING, rasterizeIconSet };
+//# sourceMappingURL=chunk-JWKQNVNE.js.map
+//# sourceMappingURL=chunk-JWKQNVNE.js.map

package/dist/chunk-JWKQNVNE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/raster.ts"],"names":[],"mappings":";AAiCO,IAAM,aAAA,GACX;AAEF,IAAM,QAAQ,CAAC,CAAA,KAAc,CAAA,CAAE,OAAA,CAAQ,UAAU,MAAM,CAAA;AAGvD,eAAsB,gBAAA,CAAiB,GAAA,EAAc,IAAA,GAAyB,EAAC,EAA2B;AACxG,EAAA,IAAI,KAAA;AACJ,EAAA,IAAI;AACF,IAAA,CAAC,EAAE,KAAA,EAAM,GAAI,MAAM,OAAO,iBAAiB,CAAA;AAAA,EAC7C,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,MAAM,aAAa,CAAA;AAAA,EAC/B;AACA,EAAA,MAAM,KAAA,GAAsB,GAAA,CAAI,KAAA,CAAM,GAAA,CAAI,CAAC,CAAA,KAAM;AAC/C,IAAA,MAAM,GAAA,GAAM,IAAI,KAAA,CAAM,CAAA,CAAE,OAAA,EAAS;AAAA,MAC/B,OAAO,EAAE,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,EAAE,IAAA,EAAK;AAAA,MACtC,IAAA,EAAM,EAAE,eAAA,EAAiB,IAAA,EAAM,WAAW,IAAA,CAAK,SAAA,IAAa,EAAC;AAAE,KAChE,CAAA,CACE,MAAA,EAAO,CACP,KAAA,EAAM;AACT,IAAA,OAAO,EAAE,IAAA,EAAM,KAAA,CAAM,EAAE,IAAI,CAAA,EAAG,SAAS,IAAI,UAAA,CAAW,GAAG,CAAA,EAAG,MAAM,WAAA,EAAa,IAAA,EAAM,EAAE,IAAA,EAAM,OAAA,EAAS,EAAE,OAAA,EAAQ;AAAA,EAClH,CAAC,CAAA;AACD,EAAA,MAAM,QAAQ,GAAA,CAAI,KAAA,CAAM,GAAA,CAAI,CAAC,OAAO,EAAE,GAAG,CAAA,EAAG,GAAA,EAAK,MAAM,CAAA,CAAE,GAAG,CAAA,EAAG,IAAA,EAAM,aAAY,CAAE,CAAA;AACnF,EAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,IAAA,CAAK,CAAC,CAAA,KAAM,EAAE,IAAA,KAAS,GAAA,IAAO,CAAA,CAAE,OAAA,KAAY,KAAK,CAAA;AACrE,EAAA,OAAO,EAAE,KAAA,EAAO,KAAA,EAAO,cAAA,EAAgB,OAAO,IAAA,EAAK;AACrD","file":"chunk-JWKQNVNE.js","sourcesContent":["/**\n * @broberg/pwa/raster — F021.9: PNG icons, because iOS does not use an SVG\n * apple-touch-icon. «Add to Home Screen» on an iPhone with only SVG icons shows\n * a screenshot of the page instead of the logo (measured by sales, 10/10).\n *\n * Kept OUT of the core entries so `@broberg/pwa` and `/manifest` stay\n * dependency-free: the renderer, @resvg/resvg-js (prebuilt binaries, no system\n * libraries), is an optional peer loaded only when this runs.\n */\nimport type { IconSet, ManifestIcon } from \"./manifest.js\";\n\nexport interface RasterIcon {\n  /** URL path, e.g. `/icons/icon-180.png`. */\n  path: string;\n  content: Uint8Array;\n  type: \"image/png\";\n  size: number;\n  purpose: \"any\" | \"maskable\";\n}\n\nexport interface RasterIconSet {\n  files: RasterIcon[];\n  /** Manifest `icons[]` pointing at the PNGs. */\n  icons: ManifestIcon[];\n  /** Href for `<link rel=\"apple-touch-icon\">` — pass it to `pwaMetaTags({ appleTouchIcon })`. Undefined when 180 was not generated. */\n  appleTouchIcon?: string;\n}\n\nexport interface RasterizeOptions {\n  /** Extra font files for monogram text (system fonts are loaded too). */\n  fontFiles?: string[];\n}\n\nexport const RESVG_MISSING =\n  \"rasterizeIconSet needs @resvg/resvg-js — install it as a dev dependency: npm i -D @resvg/resvg-js\";\n\nconst toPng = (p: string) => p.replace(/\\.svg$/, \".png\");\n\n/** Rasterise every SVG from `buildIconSet` to a PNG of the same size. */\nexport async function rasterizeIconSet(set: IconSet, opts: RasterizeOptions = {}): Promise<RasterIconSet> {\n  let Resvg: typeof import(\"@resvg/resvg-js\").Resvg;\n  try {\n    ({ Resvg } = await import(\"@resvg/resvg-js\"));\n  } catch {\n    throw new Error(RESVG_MISSING);\n  }\n  const files: RasterIcon[] = set.files.map((f) => {\n    const png = new Resvg(f.content, {\n      fitTo: { mode: \"width\", value: f.size },\n      font: { loadSystemFonts: true, fontFiles: opts.fontFiles ?? [] },\n    })\n      .render()\n      .asPng();\n    return { path: toPng(f.path), content: new Uint8Array(png), type: \"image/png\", size: f.size, purpose: f.purpose };\n  });\n  const icons = set.icons.map((i) => ({ ...i, src: toPng(i.src), type: \"image/png\" }));\n  const apple = files.find((f) => f.size === 180 && f.purpose === \"any\");\n  return { files, icons, appleTouchIcon: apple?.path };\n}\n"]}

package/dist/manifest.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/manifest.ts"],"names":[],"mappings":"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","file":"manifest.cjs","sourcesContent":["/**\n * @broberg/pwa/manifest — the PWA *install* half (the update half lives in the\n * root export). A dependency-free manifest/meta factory + an SVG-based icon\n * generator, so a repo stops hand-rolling `app/manifest.ts`, a\n * `gen-pwa-icons.cjs` script, and a pile of apple-touch `<meta>` tags.\n *\n * Everything here is PURE string/object generation — no filesystem, no\n * rasteriser, no runtime deps — so it runs in Node, Bun, edge, a build script,\n * or the browser, and every piece is offline-unit-testable. Icons are emitted\n * as self-contained SVG documents (modern manifests + apple-touch accept SVG);\n * a consumer that specifically needs PNG can rasterise the SVGs with `sharp`\n * on their side — the package stays dep-free.\n */\n\n// ---------------------------------------------------------------------------\n// Manifest\n// ---------------------------------------------------------------------------\n\nexport type Display = \"standalone\" | \"fullscreen\" | \"minimal-ui\" | \"browser\";\n\nexport interface ManifestIcon {\n  src: string;\n  sizes: string;\n  type: string;\n  /** \"any\" | \"maskable\" | \"monochrome\" (space-separated allowed). */\n  purpose?: string;\n}\n\nexport interface WebAppManifest {\n  name: string;\n  short_name: string;\n  start_url: string;\n  scope: string;\n  display: Display;\n  theme_color: string;\n  background_color: string;\n  icons: ManifestIcon[];\n  description?: string;\n  lang?: string;\n  orientation?: string;\n  categories?: string[];\n  id?: string;\n  [key: string]: unknown;\n}\n\nexport interface DefineManifestOptions {\n  /** App name (required). */\n  name: string;\n  /** Home-screen label. Default: `name`. */\n  shortName?: string;\n  /** Default `/`. */\n  startUrl?: string;\n  /** Default `/`. */\n  scope?: string;\n  /** Default `standalone`. */\n  display?: Display;\n  /** Address-bar / task-switcher colour. Default `#ffffff`. */\n  themeColor?: string;\n  /** Splash background. Default `#ffffff`. */\n  backgroundColor?: string;\n  description?: string;\n  lang?: string;\n  orientation?: string;\n  categories?: string[];\n  id?: string;\n  /** Manifest `icons[]` — typically `buildIconSet(...).icons`. */\n  icons?: ManifestIcon[];\n  /** Escape hatch: extra top-level manifest members, merged last. */\n  extra?: Record<string, unknown>;\n}\n\n/**\n * Build a spec-valid Web App Manifest object. Required members are defaulted so\n * a one-liner produces an installable manifest; every default is overridable\n * and `extra` merges last for anything not modelled (shortcuts, screenshots…).\n */\nexport function defineManifest(opts: DefineManifestOptions): WebAppManifest {\n  if (!opts?.name) throw new Error(\"defineManifest: `name` is required\");\n  const manifest: WebAppManifest = {\n    name: opts.name,\n    short_name: opts.shortName ?? opts.name,\n    start_url: opts.startUrl ?? \"/\",\n    scope: opts.scope ?? \"/\",\n    display: opts.display ?? \"standalone\",\n    theme_color: opts.themeColor ?? \"#ffffff\",\n    background_color: opts.backgroundColor ?? \"#ffffff\",\n    icons: opts.icons ?? [],\n  };\n  if (opts.description) manifest.description = opts.description;\n  if (opts.lang) manifest.lang = opts.lang;\n  if (opts.orientation) manifest.orientation = opts.orientation;\n  if (opts.categories) manifest.categories = opts.categories;\n  if (opts.id) manifest.id = opts.id;\n  return { ...manifest, ...(opts.extra ?? {}) };\n}\n\n/** JSON-stringify a manifest for a `manifest.webmanifest` file. */\nexport function serializeManifest(\n  manifest: WebAppManifest,\n  opts: { pretty?: boolean } = {},\n): string {\n  return JSON.stringify(manifest, null, opts.pretty === false ? undefined : 2);\n}\n\n// ---------------------------------------------------------------------------\n// Icon generation (SVG, zero-dep)\n// ---------------------------------------------------------------------------\n\nexport interface GeneratedIcon {\n  /** URL path, e.g. `/icons/icon-192.svg`. */\n  path: string;\n  /** The SVG document. */\n  content: string;\n  type: \"image/svg+xml\";\n  size: number;\n  purpose: \"any\" | \"maskable\";\n}\n\nexport interface IconSet {\n  files: GeneratedIcon[];\n  /** Ready to drop into `defineManifest({ icons })`. */\n  icons: ManifestIcon[];\n}\n\nexport interface IconSetOptions {\n  /**\n   * Source artwork as a full SVG document (`<svg …>…</svg>`). Embedded via a\n   * data-URI `<image>` so it scales cleanly at any size regardless of its\n   * internal coordinate system. Mutually exclusive with `monogram`.\n   */\n  svg?: string;\n  /** Fallback artwork: 1–3 letters rendered centred (e.g. \"AK\"). */\n  monogram?: string;\n  /** Foreground (monogram text) colour. Default `#ffffff`. */\n  color?: string;\n  /** Background fill. Default `#111827`. */\n  background?: string;\n  /** Icon sizes to emit. Default `[180, 192, 512]` (180 = apple-touch). */\n  sizes?: number[];\n  /** Also emit a maskable 512 with a padded safe-zone. Default `true`. */\n  maskable?: boolean;\n  /** URL prefix for every icon `src`. Default `/icons`. */\n  basePath?: string;\n}\n\nconst DEFAULT_SIZES = [180, 192, 512];\n\nfunction escapeXml(s: string): string {\n  return s.replace(/[<>&\"']/g, (c) =>\n    c === \"<\" ? \"&lt;\" : c === \">\" ? \"&gt;\" : c === \"&\" ? \"&amp;\" : c === '\"' ? \"&quot;\" : \"&apos;\",\n  );\n}\n\n/** UTF-8-safe base64 for the data-URI embed (works in Node/Bun/browser). */\nfunction toBase64(s: string): string {\n  // Reached via globalThis so the package needs no @types/node (browser-safe).\n  const g = globalThis as unknown as {\n    Buffer?: { from(input: string, enc: string): { toString(enc: string): string } };\n    btoa?: (data: string) => string;\n  };\n  if (typeof g.Buffer !== \"undefined\") return g.Buffer.from(s, \"utf-8\").toString(\"base64\");\n  const bytes = new TextEncoder().encode(s);\n  let bin = \"\";\n  for (const b of bytes) bin += String.fromCharCode(b);\n  return g.btoa!(bin);\n}\n\n/** Render one square SVG icon document at `size`. `inset` = safe-zone fraction (maskable). */\nfunction renderIcon(size: number, inset: number, opts: IconSetOptions): string {\n  const bg = opts.background ?? \"#111827\";\n  const fg = opts.color ?? \"#ffffff\";\n  const pad = Math.round(size * inset);\n  const inner = size - pad * 2;\n  let art: string;\n  if (opts.svg) {\n    const href = `data:image/svg+xml;base64,${toBase64(opts.svg)}`;\n    art = `<image x=\"${pad}\" y=\"${pad}\" width=\"${inner}\" height=\"${inner}\" href=\"${href}\" preserveAspectRatio=\"xMidYMid meet\"/>`;\n  } else {\n    const text = escapeXml((opts.monogram ?? \"\").slice(0, 3).toUpperCase());\n    // Font sized to the safe inner box; a touch smaller for breathing room.\n    const fontSize = Math.round(inner * (text.length >= 3 ? 0.42 : 0.52));\n    art =\n      `<text x=\"50%\" y=\"50%\" fill=\"${fg}\" font-family=\"system-ui, -apple-system, Segoe UI, Roboto, sans-serif\" ` +\n      `font-weight=\"700\" font-size=\"${fontSize}\" text-anchor=\"middle\" dominant-baseline=\"central\">${text}</text>`;\n  }\n  return (\n    `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${size}\" height=\"${size}\" viewBox=\"0 0 ${size} ${size}\">` +\n    `<rect width=\"${size}\" height=\"${size}\" fill=\"${bg}\"/>` +\n    art +\n    `</svg>`\n  );\n}\n\n/**\n * Generate a full icon set (SVG) + the matching manifest `icons[]`. Deterministic,\n * zero-dep. Give it either a source `svg` or a `monogram`; it emits apple-touch\n * (180), 192, 512 by default plus a padded maskable-512.\n */\nexport function buildIconSet(opts: IconSetOptions): IconSet {\n  if (!opts?.svg && !opts?.monogram) {\n    throw new Error(\"buildIconSet: provide either `svg` or `monogram`\");\n  }\n  const base = (opts.basePath ?? \"/icons\").replace(/\\/$/, \"\");\n  const sizes = opts.sizes ?? DEFAULT_SIZES;\n  const files: GeneratedIcon[] = [];\n  const icons: ManifestIcon[] = [];\n\n  for (const size of sizes) {\n    const path = `${base}/icon-${size}.svg`;\n    files.push({ path, content: renderIcon(size, 0, opts), type: \"image/svg+xml\", size, purpose: \"any\" });\n    // apple-touch-icon is referenced via a <link> (see pwaMetaTags), not the\n    // manifest, so only real manifest sizes go into icons[].\n    if (size !== 180) {\n      icons.push({ src: path, sizes: `${size}x${size}`, type: \"image/svg+xml\", purpose: \"any\" });\n    }\n  }\n\n  if (opts.maskable !== false) {\n    // Maskable safe-zone: keep content within the central 80% (10% inset).\n    const path = `${base}/icon-maskable-512.svg`;\n    files.push({ path, content: renderIcon(512, 0.1, opts), type: \"image/svg+xml\", size: 512, purpose: \"maskable\" });\n    icons.push({ src: path, sizes: \"512x512\", type: \"image/svg+xml\", purpose: \"maskable\" });\n  }\n\n  return { files, icons };\n}\n\n// ---------------------------------------------------------------------------\n// Head meta tags\n// ---------------------------------------------------------------------------\n\nexport interface MetaTag {\n  tag: \"meta\" | \"link\";\n  attrs: Record<string, string>;\n}\n\nexport interface MetaTagsOptions {\n  /** `<meta name=\"theme-color\">`. Default `#ffffff`. */\n  themeColor?: string;\n  /** apple-touch-icon href. Default `/icons/icon-180.svg`. */\n  appleTouchIcon?: string;\n  /** Manifest href for the `<link rel=\"manifest\">`. Default `/manifest.webmanifest`. */\n  manifest?: string;\n  /** apple-mobile-web-app-title. Default: omitted. */\n  title?: string;\n  /** apple-mobile-web-app-status-bar-style. Default `default`. */\n  statusBarStyle?: \"default\" | \"black\" | \"black-translucent\";\n  /** Emit the `*-web-app-capable` tags. Default `true`. */\n  capable?: boolean;\n}\n\n/**\n * The head tags a PWA needs beyond the manifest link — returned as typed\n * descriptors so a consumer renders them in Next.js `metadata`, a Hono/JSX\n * head, or plain HTML. No framework assumption.\n */\nexport function pwaMetaTags(opts: MetaTagsOptions = {}): MetaTag[] {\n  const tags: MetaTag[] = [];\n  tags.push({ tag: \"link\", attrs: { rel: \"manifest\", href: opts.manifest ?? \"/manifest.webmanifest\" } });\n  tags.push({ tag: \"meta\", attrs: { name: \"theme-color\", content: opts.themeColor ?? \"#ffffff\" } });\n  tags.push({ tag: \"link\", attrs: { rel: \"apple-touch-icon\", href: opts.appleTouchIcon ?? \"/icons/icon-180.svg\" } });\n  if (opts.capable !== false) {\n    tags.push({ tag: \"meta\", attrs: { name: \"mobile-web-app-capable\", content: \"yes\" } });\n    tags.push({ tag: \"meta\", attrs: { name: \"apple-mobile-web-app-capable\", content: \"yes\" } });\n    tags.push({\n      tag: \"meta\",\n      attrs: { name: \"apple-mobile-web-app-status-bar-style\", content: opts.statusBarStyle ?? \"default\" },\n    });\n  }\n  if (opts.title) {\n    tags.push({ tag: \"meta\", attrs: { name: \"apple-mobile-web-app-title\", content: opts.title } });\n  }\n  return tags;\n}\n"]}
+{"version":3,"sources":["../src/manifest.ts"],"names":[],"mappings":"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","file":"manifest.cjs","sourcesContent":["/**\n * @broberg/pwa/manifest — the PWA *install* half (the update half lives in the\n * root export). A dependency-free manifest/meta factory + an SVG-based icon\n * generator, so a repo stops hand-rolling `app/manifest.ts`, a\n * `gen-pwa-icons.cjs` script, and a pile of apple-touch `<meta>` tags.\n *\n * Everything here is PURE string/object generation — no filesystem, no\n * rasteriser, no runtime deps — so it runs in Node, Bun, edge, a build script,\n * or the browser, and every piece is offline-unit-testable. Icons are emitted\n * as self-contained SVG documents. iOS does NOT use an SVG apple-touch-icon —\n * rasterise with `@broberg/pwa/raster` / the `pwa-icons` bin (F021.9).\n */\n\n// ---------------------------------------------------------------------------\n// Manifest\n// ---------------------------------------------------------------------------\n\nexport type Display = \"standalone\" | \"fullscreen\" | \"minimal-ui\" | \"browser\";\n\nexport interface ManifestIcon {\n  src: string;\n  sizes: string;\n  type: string;\n  /** \"any\" | \"maskable\" | \"monochrome\" (space-separated allowed). */\n  purpose?: string;\n}\n\nexport interface WebAppManifest {\n  name: string;\n  short_name: string;\n  start_url: string;\n  scope: string;\n  display: Display;\n  theme_color: string;\n  background_color: string;\n  icons: ManifestIcon[];\n  description?: string;\n  lang?: string;\n  orientation?: string;\n  categories?: string[];\n  id?: string;\n  [key: string]: unknown;\n}\n\nexport interface DefineManifestOptions {\n  /** App name (required). */\n  name: string;\n  /** Home-screen label. Default: `name`. */\n  shortName?: string;\n  /** Default `/`. */\n  startUrl?: string;\n  /** Default `/`. */\n  scope?: string;\n  /** Default `standalone`. */\n  display?: Display;\n  /** Address-bar / task-switcher colour. Default `#ffffff`. */\n  themeColor?: string;\n  /** Splash background. Default `#ffffff`. */\n  backgroundColor?: string;\n  description?: string;\n  lang?: string;\n  orientation?: string;\n  categories?: string[];\n  id?: string;\n  /** Manifest `icons[]` — typically `buildIconSet(...).icons`. */\n  icons?: ManifestIcon[];\n  /** Escape hatch: extra top-level manifest members, merged last. */\n  extra?: Record<string, unknown>;\n}\n\n/**\n * Build a spec-valid Web App Manifest object. Required members are defaulted so\n * a one-liner produces an installable manifest; every default is overridable\n * and `extra` merges last for anything not modelled (shortcuts, screenshots…).\n */\nexport function defineManifest(opts: DefineManifestOptions): WebAppManifest {\n  if (!opts?.name) throw new Error(\"defineManifest: `name` is required\");\n  const manifest: WebAppManifest = {\n    name: opts.name,\n    short_name: opts.shortName ?? opts.name,\n    start_url: opts.startUrl ?? \"/\",\n    scope: opts.scope ?? \"/\",\n    display: opts.display ?? \"standalone\",\n    theme_color: opts.themeColor ?? \"#ffffff\",\n    background_color: opts.backgroundColor ?? \"#ffffff\",\n    icons: opts.icons ?? [],\n  };\n  if (opts.description) manifest.description = opts.description;\n  if (opts.lang) manifest.lang = opts.lang;\n  if (opts.orientation) manifest.orientation = opts.orientation;\n  if (opts.categories) manifest.categories = opts.categories;\n  if (opts.id) manifest.id = opts.id;\n  return { ...manifest, ...(opts.extra ?? {}) };\n}\n\n/** JSON-stringify a manifest for a `manifest.webmanifest` file. */\nexport function serializeManifest(\n  manifest: WebAppManifest,\n  opts: { pretty?: boolean } = {},\n): string {\n  return JSON.stringify(manifest, null, opts.pretty === false ? undefined : 2);\n}\n\n// ---------------------------------------------------------------------------\n// Icon generation (SVG, zero-dep)\n// ---------------------------------------------------------------------------\n\nexport interface GeneratedIcon {\n  /** URL path, e.g. `/icons/icon-192.svg`. */\n  path: string;\n  /** The SVG document. */\n  content: string;\n  type: \"image/svg+xml\";\n  size: number;\n  purpose: \"any\" | \"maskable\";\n}\n\nexport interface IconSet {\n  files: GeneratedIcon[];\n  /** Ready to drop into `defineManifest({ icons })`. */\n  icons: ManifestIcon[];\n}\n\nexport interface IconSetOptions {\n  /**\n   * Source artwork as a full SVG document (`<svg …>…</svg>`). Embedded via a\n   * data-URI `<image>` so it scales cleanly at any size regardless of its\n   * internal coordinate system. Mutually exclusive with `monogram`.\n   */\n  svg?: string;\n  /** Fallback artwork: 1–3 letters rendered centred (e.g. \"AK\"). */\n  monogram?: string;\n  /** Foreground (monogram text) colour. Default `#ffffff`. */\n  color?: string;\n  /** Background fill. Default `#111827`. */\n  background?: string;\n  /** Icon sizes to emit. Default `[180, 192, 512]` (180 = apple-touch). */\n  sizes?: number[];\n  /** Also emit a maskable 512 with a padded safe-zone. Default `true`. */\n  maskable?: boolean;\n  /** URL prefix for every icon `src`. Default `/icons`. */\n  basePath?: string;\n}\n\nconst DEFAULT_SIZES = [180, 192, 512];\n\nfunction escapeXml(s: string): string {\n  return s.replace(/[<>&\"']/g, (c) =>\n    c === \"<\" ? \"&lt;\" : c === \">\" ? \"&gt;\" : c === \"&\" ? \"&amp;\" : c === '\"' ? \"&quot;\" : \"&apos;\",\n  );\n}\n\n/** UTF-8-safe base64 for the data-URI embed (works in Node/Bun/browser). */\nfunction toBase64(s: string): string {\n  // Reached via globalThis so the package needs no @types/node (browser-safe).\n  const g = globalThis as unknown as {\n    Buffer?: { from(input: string, enc: string): { toString(enc: string): string } };\n    btoa?: (data: string) => string;\n  };\n  if (typeof g.Buffer !== \"undefined\") return g.Buffer.from(s, \"utf-8\").toString(\"base64\");\n  const bytes = new TextEncoder().encode(s);\n  let bin = \"\";\n  for (const b of bytes) bin += String.fromCharCode(b);\n  return g.btoa!(bin);\n}\n\n/** Render one square SVG icon document at `size`. `inset` = safe-zone fraction (maskable). */\nfunction renderIcon(size: number, inset: number, opts: IconSetOptions): string {\n  const bg = opts.background ?? \"#111827\";\n  const fg = opts.color ?? \"#ffffff\";\n  const pad = Math.round(size * inset);\n  const inner = size - pad * 2;\n  let art: string;\n  if (opts.svg) {\n    const href = `data:image/svg+xml;base64,${toBase64(opts.svg)}`;\n    art = `<image x=\"${pad}\" y=\"${pad}\" width=\"${inner}\" height=\"${inner}\" href=\"${href}\" preserveAspectRatio=\"xMidYMid meet\"/>`;\n  } else {\n    const text = escapeXml((opts.monogram ?? \"\").slice(0, 3).toUpperCase());\n    // Font sized to the safe inner box; a touch smaller for breathing room.\n    const fontSize = Math.round(inner * (text.length >= 3 ? 0.42 : 0.52));\n    art =\n      `<text x=\"50%\" y=\"50%\" fill=\"${fg}\" font-family=\"system-ui, -apple-system, Segoe UI, Roboto, sans-serif\" ` +\n      `font-weight=\"700\" font-size=\"${fontSize}\" text-anchor=\"middle\" dominant-baseline=\"central\">${text}</text>`;\n  }\n  return (\n    `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${size}\" height=\"${size}\" viewBox=\"0 0 ${size} ${size}\">` +\n    `<rect width=\"${size}\" height=\"${size}\" fill=\"${bg}\"/>` +\n    art +\n    `</svg>`\n  );\n}\n\n/**\n * Generate a full icon set (SVG) + the matching manifest `icons[]`. Deterministic,\n * zero-dep. Give it either a source `svg` or a `monogram`; it emits apple-touch\n * (180), 192, 512 by default plus a padded maskable-512.\n */\nexport function buildIconSet(opts: IconSetOptions): IconSet {\n  if (!opts?.svg && !opts?.monogram) {\n    throw new Error(\"buildIconSet: provide either `svg` or `monogram`\");\n  }\n  const base = (opts.basePath ?? \"/icons\").replace(/\\/$/, \"\");\n  const sizes = opts.sizes ?? DEFAULT_SIZES;\n  const files: GeneratedIcon[] = [];\n  const icons: ManifestIcon[] = [];\n\n  for (const size of sizes) {\n    const path = `${base}/icon-${size}.svg`;\n    files.push({ path, content: renderIcon(size, 0, opts), type: \"image/svg+xml\", size, purpose: \"any\" });\n    // apple-touch-icon is referenced via a <link> (see pwaMetaTags), not the\n    // manifest, so only real manifest sizes go into icons[].\n    if (size !== 180) {\n      icons.push({ src: path, sizes: `${size}x${size}`, type: \"image/svg+xml\", purpose: \"any\" });\n    }\n  }\n\n  if (opts.maskable !== false) {\n    // Maskable safe-zone: keep content within the central 80% (10% inset).\n    const path = `${base}/icon-maskable-512.svg`;\n    files.push({ path, content: renderIcon(512, 0.1, opts), type: \"image/svg+xml\", size: 512, purpose: \"maskable\" });\n    icons.push({ src: path, sizes: \"512x512\", type: \"image/svg+xml\", purpose: \"maskable\" });\n  }\n\n  return { files, icons };\n}\n\n// ---------------------------------------------------------------------------\n// Head meta tags\n// ---------------------------------------------------------------------------\n\nexport interface MetaTag {\n  tag: \"meta\" | \"link\";\n  attrs: Record<string, string>;\n}\n\nexport interface MetaTagsOptions {\n  /** `<meta name=\"theme-color\">`. Default `#ffffff`. */\n  themeColor?: string;\n  /** apple-touch-icon href. Default `/icons/icon-180.svg`. */\n  appleTouchIcon?: string;\n  /** Manifest href for the `<link rel=\"manifest\">`. Default `/manifest.webmanifest`. */\n  manifest?: string;\n  /** apple-mobile-web-app-title. Default: omitted. */\n  title?: string;\n  /** apple-mobile-web-app-status-bar-style. Default `default`. */\n  statusBarStyle?: \"default\" | \"black\" | \"black-translucent\";\n  /** Emit the `*-web-app-capable` tags. Default `true`. */\n  capable?: boolean;\n}\n\n/**\n * The head tags a PWA needs beyond the manifest link — returned as typed\n * descriptors so a consumer renders them in Next.js `metadata`, a Hono/JSX\n * head, or plain HTML. No framework assumption.\n */\nexport function pwaMetaTags(opts: MetaTagsOptions = {}): MetaTag[] {\n  const tags: MetaTag[] = [];\n  tags.push({ tag: \"link\", attrs: { rel: \"manifest\", href: opts.manifest ?? \"/manifest.webmanifest\" } });\n  tags.push({ tag: \"meta\", attrs: { name: \"theme-color\", content: opts.themeColor ?? \"#ffffff\" } });\n  tags.push({ tag: \"link\", attrs: { rel: \"apple-touch-icon\", href: opts.appleTouchIcon ?? \"/icons/icon-180.svg\" } });\n  if (opts.capable !== false) {\n    tags.push({ tag: \"meta\", attrs: { name: \"mobile-web-app-capable\", content: \"yes\" } });\n    tags.push({ tag: \"meta\", attrs: { name: \"apple-mobile-web-app-capable\", content: \"yes\" } });\n    tags.push({\n      tag: \"meta\",\n      attrs: { name: \"apple-mobile-web-app-status-bar-style\", content: opts.statusBarStyle ?? \"default\" },\n    });\n  }\n  if (opts.title) {\n    tags.push({ tag: \"meta\", attrs: { name: \"apple-mobile-web-app-title\", content: opts.title } });\n  }\n  return tags;\n}\n"]}

package/dist/manifest.d.cts

@@ -7,9 +7,8 @@
  * Everything here is PURE string/object generation — no filesystem, no
  * rasteriser, no runtime deps — so it runs in Node, Bun, edge, a build script,
  * or the browser, and every piece is offline-unit-testable. Icons are emitted
- * as self-contained SVG documents (modern manifests + apple-touch accept SVG);
- * a consumer that specifically needs PNG can rasterise the SVGs with `sharp`
- * on their side — the package stays dep-free.
+ * as self-contained SVG documents. iOS does NOT use an SVG apple-touch-icon —
+ * rasterise with `@broberg/pwa/raster` / the `pwa-icons` bin (F021.9).
  */
 type Display = "standalone" | "fullscreen" | "minimal-ui" | "browser";
 interface ManifestIcon {

package/dist/manifest.d.ts

@@ -7,9 +7,8 @@
  * Everything here is PURE string/object generation — no filesystem, no
  * rasteriser, no runtime deps — so it runs in Node, Bun, edge, a build script,
  * or the browser, and every piece is offline-unit-testable. Icons are emitted
- * as self-contained SVG documents (modern manifests + apple-touch accept SVG);
- * a consumer that specifically needs PNG can rasterise the SVGs with `sharp`
- * on their side — the package stays dep-free.
+ * as self-contained SVG documents. iOS does NOT use an SVG apple-touch-icon —
+ * rasterise with `@broberg/pwa/raster` / the `pwa-icons` bin (F021.9).
  */
 type Display = "standalone" | "fullscreen" | "minimal-ui" | "browser";
 interface ManifestIcon {

package/dist/manifest.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/manifest.ts"],"names":[],"mappings":"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","file":"manifest.js","sourcesContent":["/**\n * @broberg/pwa/manifest — the PWA *install* half (the update half lives in the\n * root export). A dependency-free manifest/meta factory + an SVG-based icon\n * generator, so a repo stops hand-rolling `app/manifest.ts`, a\n * `gen-pwa-icons.cjs` script, and a pile of apple-touch `<meta>` tags.\n *\n * Everything here is PURE string/object generation — no filesystem, no\n * rasteriser, no runtime deps — so it runs in Node, Bun, edge, a build script,\n * or the browser, and every piece is offline-unit-testable. Icons are emitted\n * as self-contained SVG documents (modern manifests + apple-touch accept SVG);\n * a consumer that specifically needs PNG can rasterise the SVGs with `sharp`\n * on their side — the package stays dep-free.\n */\n\n// ---------------------------------------------------------------------------\n// Manifest\n// ---------------------------------------------------------------------------\n\nexport type Display = \"standalone\" | \"fullscreen\" | \"minimal-ui\" | \"browser\";\n\nexport interface ManifestIcon {\n  src: string;\n  sizes: string;\n  type: string;\n  /** \"any\" | \"maskable\" | \"monochrome\" (space-separated allowed). */\n  purpose?: string;\n}\n\nexport interface WebAppManifest {\n  name: string;\n  short_name: string;\n  start_url: string;\n  scope: string;\n  display: Display;\n  theme_color: string;\n  background_color: string;\n  icons: ManifestIcon[];\n  description?: string;\n  lang?: string;\n  orientation?: string;\n  categories?: string[];\n  id?: string;\n  [key: string]: unknown;\n}\n\nexport interface DefineManifestOptions {\n  /** App name (required). */\n  name: string;\n  /** Home-screen label. Default: `name`. */\n  shortName?: string;\n  /** Default `/`. */\n  startUrl?: string;\n  /** Default `/`. */\n  scope?: string;\n  /** Default `standalone`. */\n  display?: Display;\n  /** Address-bar / task-switcher colour. Default `#ffffff`. */\n  themeColor?: string;\n  /** Splash background. Default `#ffffff`. */\n  backgroundColor?: string;\n  description?: string;\n  lang?: string;\n  orientation?: string;\n  categories?: string[];\n  id?: string;\n  /** Manifest `icons[]` — typically `buildIconSet(...).icons`. */\n  icons?: ManifestIcon[];\n  /** Escape hatch: extra top-level manifest members, merged last. */\n  extra?: Record<string, unknown>;\n}\n\n/**\n * Build a spec-valid Web App Manifest object. Required members are defaulted so\n * a one-liner produces an installable manifest; every default is overridable\n * and `extra` merges last for anything not modelled (shortcuts, screenshots…).\n */\nexport function defineManifest(opts: DefineManifestOptions): WebAppManifest {\n  if (!opts?.name) throw new Error(\"defineManifest: `name` is required\");\n  const manifest: WebAppManifest = {\n    name: opts.name,\n    short_name: opts.shortName ?? opts.name,\n    start_url: opts.startUrl ?? \"/\",\n    scope: opts.scope ?? \"/\",\n    display: opts.display ?? \"standalone\",\n    theme_color: opts.themeColor ?? \"#ffffff\",\n    background_color: opts.backgroundColor ?? \"#ffffff\",\n    icons: opts.icons ?? [],\n  };\n  if (opts.description) manifest.description = opts.description;\n  if (opts.lang) manifest.lang = opts.lang;\n  if (opts.orientation) manifest.orientation = opts.orientation;\n  if (opts.categories) manifest.categories = opts.categories;\n  if (opts.id) manifest.id = opts.id;\n  return { ...manifest, ...(opts.extra ?? {}) };\n}\n\n/** JSON-stringify a manifest for a `manifest.webmanifest` file. */\nexport function serializeManifest(\n  manifest: WebAppManifest,\n  opts: { pretty?: boolean } = {},\n): string {\n  return JSON.stringify(manifest, null, opts.pretty === false ? undefined : 2);\n}\n\n// ---------------------------------------------------------------------------\n// Icon generation (SVG, zero-dep)\n// ---------------------------------------------------------------------------\n\nexport interface GeneratedIcon {\n  /** URL path, e.g. `/icons/icon-192.svg`. */\n  path: string;\n  /** The SVG document. */\n  content: string;\n  type: \"image/svg+xml\";\n  size: number;\n  purpose: \"any\" | \"maskable\";\n}\n\nexport interface IconSet {\n  files: GeneratedIcon[];\n  /** Ready to drop into `defineManifest({ icons })`. */\n  icons: ManifestIcon[];\n}\n\nexport interface IconSetOptions {\n  /**\n   * Source artwork as a full SVG document (`<svg …>…</svg>`). Embedded via a\n   * data-URI `<image>` so it scales cleanly at any size regardless of its\n   * internal coordinate system. Mutually exclusive with `monogram`.\n   */\n  svg?: string;\n  /** Fallback artwork: 1–3 letters rendered centred (e.g. \"AK\"). */\n  monogram?: string;\n  /** Foreground (monogram text) colour. Default `#ffffff`. */\n  color?: string;\n  /** Background fill. Default `#111827`. */\n  background?: string;\n  /** Icon sizes to emit. Default `[180, 192, 512]` (180 = apple-touch). */\n  sizes?: number[];\n  /** Also emit a maskable 512 with a padded safe-zone. Default `true`. */\n  maskable?: boolean;\n  /** URL prefix for every icon `src`. Default `/icons`. */\n  basePath?: string;\n}\n\nconst DEFAULT_SIZES = [180, 192, 512];\n\nfunction escapeXml(s: string): string {\n  return s.replace(/[<>&\"']/g, (c) =>\n    c === \"<\" ? \"&lt;\" : c === \">\" ? \"&gt;\" : c === \"&\" ? \"&amp;\" : c === '\"' ? \"&quot;\" : \"&apos;\",\n  );\n}\n\n/** UTF-8-safe base64 for the data-URI embed (works in Node/Bun/browser). */\nfunction toBase64(s: string): string {\n  // Reached via globalThis so the package needs no @types/node (browser-safe).\n  const g = globalThis as unknown as {\n    Buffer?: { from(input: string, enc: string): { toString(enc: string): string } };\n    btoa?: (data: string) => string;\n  };\n  if (typeof g.Buffer !== \"undefined\") return g.Buffer.from(s, \"utf-8\").toString(\"base64\");\n  const bytes = new TextEncoder().encode(s);\n  let bin = \"\";\n  for (const b of bytes) bin += String.fromCharCode(b);\n  return g.btoa!(bin);\n}\n\n/** Render one square SVG icon document at `size`. `inset` = safe-zone fraction (maskable). */\nfunction renderIcon(size: number, inset: number, opts: IconSetOptions): string {\n  const bg = opts.background ?? \"#111827\";\n  const fg = opts.color ?? \"#ffffff\";\n  const pad = Math.round(size * inset);\n  const inner = size - pad * 2;\n  let art: string;\n  if (opts.svg) {\n    const href = `data:image/svg+xml;base64,${toBase64(opts.svg)}`;\n    art = `<image x=\"${pad}\" y=\"${pad}\" width=\"${inner}\" height=\"${inner}\" href=\"${href}\" preserveAspectRatio=\"xMidYMid meet\"/>`;\n  } else {\n    const text = escapeXml((opts.monogram ?? \"\").slice(0, 3).toUpperCase());\n    // Font sized to the safe inner box; a touch smaller for breathing room.\n    const fontSize = Math.round(inner * (text.length >= 3 ? 0.42 : 0.52));\n    art =\n      `<text x=\"50%\" y=\"50%\" fill=\"${fg}\" font-family=\"system-ui, -apple-system, Segoe UI, Roboto, sans-serif\" ` +\n      `font-weight=\"700\" font-size=\"${fontSize}\" text-anchor=\"middle\" dominant-baseline=\"central\">${text}</text>`;\n  }\n  return (\n    `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${size}\" height=\"${size}\" viewBox=\"0 0 ${size} ${size}\">` +\n    `<rect width=\"${size}\" height=\"${size}\" fill=\"${bg}\"/>` +\n    art +\n    `</svg>`\n  );\n}\n\n/**\n * Generate a full icon set (SVG) + the matching manifest `icons[]`. Deterministic,\n * zero-dep. Give it either a source `svg` or a `monogram`; it emits apple-touch\n * (180), 192, 512 by default plus a padded maskable-512.\n */\nexport function buildIconSet(opts: IconSetOptions): IconSet {\n  if (!opts?.svg && !opts?.monogram) {\n    throw new Error(\"buildIconSet: provide either `svg` or `monogram`\");\n  }\n  const base = (opts.basePath ?? \"/icons\").replace(/\\/$/, \"\");\n  const sizes = opts.sizes ?? DEFAULT_SIZES;\n  const files: GeneratedIcon[] = [];\n  const icons: ManifestIcon[] = [];\n\n  for (const size of sizes) {\n    const path = `${base}/icon-${size}.svg`;\n    files.push({ path, content: renderIcon(size, 0, opts), type: \"image/svg+xml\", size, purpose: \"any\" });\n    // apple-touch-icon is referenced via a <link> (see pwaMetaTags), not the\n    // manifest, so only real manifest sizes go into icons[].\n    if (size !== 180) {\n      icons.push({ src: path, sizes: `${size}x${size}`, type: \"image/svg+xml\", purpose: \"any\" });\n    }\n  }\n\n  if (opts.maskable !== false) {\n    // Maskable safe-zone: keep content within the central 80% (10% inset).\n    const path = `${base}/icon-maskable-512.svg`;\n    files.push({ path, content: renderIcon(512, 0.1, opts), type: \"image/svg+xml\", size: 512, purpose: \"maskable\" });\n    icons.push({ src: path, sizes: \"512x512\", type: \"image/svg+xml\", purpose: \"maskable\" });\n  }\n\n  return { files, icons };\n}\n\n// ---------------------------------------------------------------------------\n// Head meta tags\n// ---------------------------------------------------------------------------\n\nexport interface MetaTag {\n  tag: \"meta\" | \"link\";\n  attrs: Record<string, string>;\n}\n\nexport interface MetaTagsOptions {\n  /** `<meta name=\"theme-color\">`. Default `#ffffff`. */\n  themeColor?: string;\n  /** apple-touch-icon href. Default `/icons/icon-180.svg`. */\n  appleTouchIcon?: string;\n  /** Manifest href for the `<link rel=\"manifest\">`. Default `/manifest.webmanifest`. */\n  manifest?: string;\n  /** apple-mobile-web-app-title. Default: omitted. */\n  title?: string;\n  /** apple-mobile-web-app-status-bar-style. Default `default`. */\n  statusBarStyle?: \"default\" | \"black\" | \"black-translucent\";\n  /** Emit the `*-web-app-capable` tags. Default `true`. */\n  capable?: boolean;\n}\n\n/**\n * The head tags a PWA needs beyond the manifest link — returned as typed\n * descriptors so a consumer renders them in Next.js `metadata`, a Hono/JSX\n * head, or plain HTML. No framework assumption.\n */\nexport function pwaMetaTags(opts: MetaTagsOptions = {}): MetaTag[] {\n  const tags: MetaTag[] = [];\n  tags.push({ tag: \"link\", attrs: { rel: \"manifest\", href: opts.manifest ?? \"/manifest.webmanifest\" } });\n  tags.push({ tag: \"meta\", attrs: { name: \"theme-color\", content: opts.themeColor ?? \"#ffffff\" } });\n  tags.push({ tag: \"link\", attrs: { rel: \"apple-touch-icon\", href: opts.appleTouchIcon ?? \"/icons/icon-180.svg\" } });\n  if (opts.capable !== false) {\n    tags.push({ tag: \"meta\", attrs: { name: \"mobile-web-app-capable\", content: \"yes\" } });\n    tags.push({ tag: \"meta\", attrs: { name: \"apple-mobile-web-app-capable\", content: \"yes\" } });\n    tags.push({\n      tag: \"meta\",\n      attrs: { name: \"apple-mobile-web-app-status-bar-style\", content: opts.statusBarStyle ?? \"default\" },\n    });\n  }\n  if (opts.title) {\n    tags.push({ tag: \"meta\", attrs: { name: \"apple-mobile-web-app-title\", content: opts.title } });\n  }\n  return tags;\n}\n"]}
+{"version":3,"sources":["../src/manifest.ts"],"names":[],"mappings":"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","file":"manifest.js","sourcesContent":["/**\n * @broberg/pwa/manifest — the PWA *install* half (the update half lives in the\n * root export). A dependency-free manifest/meta factory + an SVG-based icon\n * generator, so a repo stops hand-rolling `app/manifest.ts`, a\n * `gen-pwa-icons.cjs` script, and a pile of apple-touch `<meta>` tags.\n *\n * Everything here is PURE string/object generation — no filesystem, no\n * rasteriser, no runtime deps — so it runs in Node, Bun, edge, a build script,\n * or the browser, and every piece is offline-unit-testable. Icons are emitted\n * as self-contained SVG documents. iOS does NOT use an SVG apple-touch-icon —\n * rasterise with `@broberg/pwa/raster` / the `pwa-icons` bin (F021.9).\n */\n\n// ---------------------------------------------------------------------------\n// Manifest\n// ---------------------------------------------------------------------------\n\nexport type Display = \"standalone\" | \"fullscreen\" | \"minimal-ui\" | \"browser\";\n\nexport interface ManifestIcon {\n  src: string;\n  sizes: string;\n  type: string;\n  /** \"any\" | \"maskable\" | \"monochrome\" (space-separated allowed). */\n  purpose?: string;\n}\n\nexport interface WebAppManifest {\n  name: string;\n  short_name: string;\n  start_url: string;\n  scope: string;\n  display: Display;\n  theme_color: string;\n  background_color: string;\n  icons: ManifestIcon[];\n  description?: string;\n  lang?: string;\n  orientation?: string;\n  categories?: string[];\n  id?: string;\n  [key: string]: unknown;\n}\n\nexport interface DefineManifestOptions {\n  /** App name (required). */\n  name: string;\n  /** Home-screen label. Default: `name`. */\n  shortName?: string;\n  /** Default `/`. */\n  startUrl?: string;\n  /** Default `/`. */\n  scope?: string;\n  /** Default `standalone`. */\n  display?: Display;\n  /** Address-bar / task-switcher colour. Default `#ffffff`. */\n  themeColor?: string;\n  /** Splash background. Default `#ffffff`. */\n  backgroundColor?: string;\n  description?: string;\n  lang?: string;\n  orientation?: string;\n  categories?: string[];\n  id?: string;\n  /** Manifest `icons[]` — typically `buildIconSet(...).icons`. */\n  icons?: ManifestIcon[];\n  /** Escape hatch: extra top-level manifest members, merged last. */\n  extra?: Record<string, unknown>;\n}\n\n/**\n * Build a spec-valid Web App Manifest object. Required members are defaulted so\n * a one-liner produces an installable manifest; every default is overridable\n * and `extra` merges last for anything not modelled (shortcuts, screenshots…).\n */\nexport function defineManifest(opts: DefineManifestOptions): WebAppManifest {\n  if (!opts?.name) throw new Error(\"defineManifest: `name` is required\");\n  const manifest: WebAppManifest = {\n    name: opts.name,\n    short_name: opts.shortName ?? opts.name,\n    start_url: opts.startUrl ?? \"/\",\n    scope: opts.scope ?? \"/\",\n    display: opts.display ?? \"standalone\",\n    theme_color: opts.themeColor ?? \"#ffffff\",\n    background_color: opts.backgroundColor ?? \"#ffffff\",\n    icons: opts.icons ?? [],\n  };\n  if (opts.description) manifest.description = opts.description;\n  if (opts.lang) manifest.lang = opts.lang;\n  if (opts.orientation) manifest.orientation = opts.orientation;\n  if (opts.categories) manifest.categories = opts.categories;\n  if (opts.id) manifest.id = opts.id;\n  return { ...manifest, ...(opts.extra ?? {}) };\n}\n\n/** JSON-stringify a manifest for a `manifest.webmanifest` file. */\nexport function serializeManifest(\n  manifest: WebAppManifest,\n  opts: { pretty?: boolean } = {},\n): string {\n  return JSON.stringify(manifest, null, opts.pretty === false ? undefined : 2);\n}\n\n// ---------------------------------------------------------------------------\n// Icon generation (SVG, zero-dep)\n// ---------------------------------------------------------------------------\n\nexport interface GeneratedIcon {\n  /** URL path, e.g. `/icons/icon-192.svg`. */\n  path: string;\n  /** The SVG document. */\n  content: string;\n  type: \"image/svg+xml\";\n  size: number;\n  purpose: \"any\" | \"maskable\";\n}\n\nexport interface IconSet {\n  files: GeneratedIcon[];\n  /** Ready to drop into `defineManifest({ icons })`. */\n  icons: ManifestIcon[];\n}\n\nexport interface IconSetOptions {\n  /**\n   * Source artwork as a full SVG document (`<svg …>…</svg>`). Embedded via a\n   * data-URI `<image>` so it scales cleanly at any size regardless of its\n   * internal coordinate system. Mutually exclusive with `monogram`.\n   */\n  svg?: string;\n  /** Fallback artwork: 1–3 letters rendered centred (e.g. \"AK\"). */\n  monogram?: string;\n  /** Foreground (monogram text) colour. Default `#ffffff`. */\n  color?: string;\n  /** Background fill. Default `#111827`. */\n  background?: string;\n  /** Icon sizes to emit. Default `[180, 192, 512]` (180 = apple-touch). */\n  sizes?: number[];\n  /** Also emit a maskable 512 with a padded safe-zone. Default `true`. */\n  maskable?: boolean;\n  /** URL prefix for every icon `src`. Default `/icons`. */\n  basePath?: string;\n}\n\nconst DEFAULT_SIZES = [180, 192, 512];\n\nfunction escapeXml(s: string): string {\n  return s.replace(/[<>&\"']/g, (c) =>\n    c === \"<\" ? \"&lt;\" : c === \">\" ? \"&gt;\" : c === \"&\" ? \"&amp;\" : c === '\"' ? \"&quot;\" : \"&apos;\",\n  );\n}\n\n/** UTF-8-safe base64 for the data-URI embed (works in Node/Bun/browser). */\nfunction toBase64(s: string): string {\n  // Reached via globalThis so the package needs no @types/node (browser-safe).\n  const g = globalThis as unknown as {\n    Buffer?: { from(input: string, enc: string): { toString(enc: string): string } };\n    btoa?: (data: string) => string;\n  };\n  if (typeof g.Buffer !== \"undefined\") return g.Buffer.from(s, \"utf-8\").toString(\"base64\");\n  const bytes = new TextEncoder().encode(s);\n  let bin = \"\";\n  for (const b of bytes) bin += String.fromCharCode(b);\n  return g.btoa!(bin);\n}\n\n/** Render one square SVG icon document at `size`. `inset` = safe-zone fraction (maskable). */\nfunction renderIcon(size: number, inset: number, opts: IconSetOptions): string {\n  const bg = opts.background ?? \"#111827\";\n  const fg = opts.color ?? \"#ffffff\";\n  const pad = Math.round(size * inset);\n  const inner = size - pad * 2;\n  let art: string;\n  if (opts.svg) {\n    const href = `data:image/svg+xml;base64,${toBase64(opts.svg)}`;\n    art = `<image x=\"${pad}\" y=\"${pad}\" width=\"${inner}\" height=\"${inner}\" href=\"${href}\" preserveAspectRatio=\"xMidYMid meet\"/>`;\n  } else {\n    const text = escapeXml((opts.monogram ?? \"\").slice(0, 3).toUpperCase());\n    // Font sized to the safe inner box; a touch smaller for breathing room.\n    const fontSize = Math.round(inner * (text.length >= 3 ? 0.42 : 0.52));\n    art =\n      `<text x=\"50%\" y=\"50%\" fill=\"${fg}\" font-family=\"system-ui, -apple-system, Segoe UI, Roboto, sans-serif\" ` +\n      `font-weight=\"700\" font-size=\"${fontSize}\" text-anchor=\"middle\" dominant-baseline=\"central\">${text}</text>`;\n  }\n  return (\n    `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${size}\" height=\"${size}\" viewBox=\"0 0 ${size} ${size}\">` +\n    `<rect width=\"${size}\" height=\"${size}\" fill=\"${bg}\"/>` +\n    art +\n    `</svg>`\n  );\n}\n\n/**\n * Generate a full icon set (SVG) + the matching manifest `icons[]`. Deterministic,\n * zero-dep. Give it either a source `svg` or a `monogram`; it emits apple-touch\n * (180), 192, 512 by default plus a padded maskable-512.\n */\nexport function buildIconSet(opts: IconSetOptions): IconSet {\n  if (!opts?.svg && !opts?.monogram) {\n    throw new Error(\"buildIconSet: provide either `svg` or `monogram`\");\n  }\n  const base = (opts.basePath ?? \"/icons\").replace(/\\/$/, \"\");\n  const sizes = opts.sizes ?? DEFAULT_SIZES;\n  const files: GeneratedIcon[] = [];\n  const icons: ManifestIcon[] = [];\n\n  for (const size of sizes) {\n    const path = `${base}/icon-${size}.svg`;\n    files.push({ path, content: renderIcon(size, 0, opts), type: \"image/svg+xml\", size, purpose: \"any\" });\n    // apple-touch-icon is referenced via a <link> (see pwaMetaTags), not the\n    // manifest, so only real manifest sizes go into icons[].\n    if (size !== 180) {\n      icons.push({ src: path, sizes: `${size}x${size}`, type: \"image/svg+xml\", purpose: \"any\" });\n    }\n  }\n\n  if (opts.maskable !== false) {\n    // Maskable safe-zone: keep content within the central 80% (10% inset).\n    const path = `${base}/icon-maskable-512.svg`;\n    files.push({ path, content: renderIcon(512, 0.1, opts), type: \"image/svg+xml\", size: 512, purpose: \"maskable\" });\n    icons.push({ src: path, sizes: \"512x512\", type: \"image/svg+xml\", purpose: \"maskable\" });\n  }\n\n  return { files, icons };\n}\n\n// ---------------------------------------------------------------------------\n// Head meta tags\n// ---------------------------------------------------------------------------\n\nexport interface MetaTag {\n  tag: \"meta\" | \"link\";\n  attrs: Record<string, string>;\n}\n\nexport interface MetaTagsOptions {\n  /** `<meta name=\"theme-color\">`. Default `#ffffff`. */\n  themeColor?: string;\n  /** apple-touch-icon href. Default `/icons/icon-180.svg`. */\n  appleTouchIcon?: string;\n  /** Manifest href for the `<link rel=\"manifest\">`. Default `/manifest.webmanifest`. */\n  manifest?: string;\n  /** apple-mobile-web-app-title. Default: omitted. */\n  title?: string;\n  /** apple-mobile-web-app-status-bar-style. Default `default`. */\n  statusBarStyle?: \"default\" | \"black\" | \"black-translucent\";\n  /** Emit the `*-web-app-capable` tags. Default `true`. */\n  capable?: boolean;\n}\n\n/**\n * The head tags a PWA needs beyond the manifest link — returned as typed\n * descriptors so a consumer renders them in Next.js `metadata`, a Hono/JSX\n * head, or plain HTML. No framework assumption.\n */\nexport function pwaMetaTags(opts: MetaTagsOptions = {}): MetaTag[] {\n  const tags: MetaTag[] = [];\n  tags.push({ tag: \"link\", attrs: { rel: \"manifest\", href: opts.manifest ?? \"/manifest.webmanifest\" } });\n  tags.push({ tag: \"meta\", attrs: { name: \"theme-color\", content: opts.themeColor ?? \"#ffffff\" } });\n  tags.push({ tag: \"link\", attrs: { rel: \"apple-touch-icon\", href: opts.appleTouchIcon ?? \"/icons/icon-180.svg\" } });\n  if (opts.capable !== false) {\n    tags.push({ tag: \"meta\", attrs: { name: \"mobile-web-app-capable\", content: \"yes\" } });\n    tags.push({ tag: \"meta\", attrs: { name: \"apple-mobile-web-app-capable\", content: \"yes\" } });\n    tags.push({\n      tag: \"meta\",\n      attrs: { name: \"apple-mobile-web-app-status-bar-style\", content: opts.statusBarStyle ?? \"default\" },\n    });\n  }\n  if (opts.title) {\n    tags.push({ tag: \"meta\", attrs: { name: \"apple-mobile-web-app-title\", content: opts.title } });\n  }\n  return tags;\n}\n"]}

package/dist/raster.cjs

@@ -0,0 +1,28 @@
+'use strict';
+
+// src/raster.ts
+var RESVG_MISSING = "rasterizeIconSet needs @resvg/resvg-js \u2014 install it as a dev dependency: npm i -D @resvg/resvg-js";
+var toPng = (p) => p.replace(/\.svg$/, ".png");
+async function rasterizeIconSet(set, opts = {}) {
+  let Resvg;
+  try {
+    ({ Resvg } = await import('@resvg/resvg-js'));
+  } catch {
+    throw new Error(RESVG_MISSING);
+  }
+  const files = set.files.map((f) => {
+    const png = new Resvg(f.content, {
+      fitTo: { mode: "width", value: f.size },
+      font: { loadSystemFonts: true, fontFiles: opts.fontFiles ?? [] }
+    }).render().asPng();
+    return { path: toPng(f.path), content: new Uint8Array(png), type: "image/png", size: f.size, purpose: f.purpose };
+  });
+  const icons = set.icons.map((i) => ({ ...i, src: toPng(i.src), type: "image/png" }));
+  const apple = files.find((f) => f.size === 180 && f.purpose === "any");
+  return { files, icons, appleTouchIcon: apple?.path };
+}
+
+exports.RESVG_MISSING = RESVG_MISSING;
+exports.rasterizeIconSet = rasterizeIconSet;
+//# sourceMappingURL=raster.cjs.map
+//# sourceMappingURL=raster.cjs.map

package/dist/raster.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/raster.ts"],"names":[],"mappings":";;;AAiCO,IAAM,aAAA,GACX;AAEF,IAAM,QAAQ,CAAC,CAAA,KAAc,CAAA,CAAE,OAAA,CAAQ,UAAU,MAAM,CAAA;AAGvD,eAAsB,gBAAA,CAAiB,GAAA,EAAc,IAAA,GAAyB,EAAC,EAA2B;AACxG,EAAA,IAAI,KAAA;AACJ,EAAA,IAAI;AACF,IAAA,CAAC,EAAE,KAAA,EAAM,GAAI,MAAM,OAAO,iBAAiB,CAAA;AAAA,EAC7C,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,MAAM,aAAa,CAAA;AAAA,EAC/B;AACA,EAAA,MAAM,KAAA,GAAsB,GAAA,CAAI,KAAA,CAAM,GAAA,CAAI,CAAC,CAAA,KAAM;AAC/C,IAAA,MAAM,GAAA,GAAM,IAAI,KAAA,CAAM,CAAA,CAAE,OAAA,EAAS;AAAA,MAC/B,OAAO,EAAE,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,EAAE,IAAA,EAAK;AAAA,MACtC,IAAA,EAAM,EAAE,eAAA,EAAiB,IAAA,EAAM,WAAW,IAAA,CAAK,SAAA,IAAa,EAAC;AAAE,KAChE,CAAA,CACE,MAAA,EAAO,CACP,KAAA,EAAM;AACT,IAAA,OAAO,EAAE,IAAA,EAAM,KAAA,CAAM,EAAE,IAAI,CAAA,EAAG,SAAS,IAAI,UAAA,CAAW,GAAG,CAAA,EAAG,MAAM,WAAA,EAAa,IAAA,EAAM,EAAE,IAAA,EAAM,OAAA,EAAS,EAAE,OAAA,EAAQ;AAAA,EAClH,CAAC,CAAA;AACD,EAAA,MAAM,QAAQ,GAAA,CAAI,KAAA,CAAM,GAAA,CAAI,CAAC,OAAO,EAAE,GAAG,CAAA,EAAG,GAAA,EAAK,MAAM,CAAA,CAAE,GAAG,CAAA,EAAG,IAAA,EAAM,aAAY,CAAE,CAAA;AACnF,EAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,IAAA,CAAK,CAAC,CAAA,KAAM,EAAE,IAAA,KAAS,GAAA,IAAO,CAAA,CAAE,OAAA,KAAY,KAAK,CAAA;AACrE,EAAA,OAAO,EAAE,KAAA,EAAO,KAAA,EAAO,cAAA,EAAgB,OAAO,IAAA,EAAK;AACrD","file":"raster.cjs","sourcesContent":["/**\n * @broberg/pwa/raster — F021.9: PNG icons, because iOS does not use an SVG\n * apple-touch-icon. «Add to Home Screen» on an iPhone with only SVG icons shows\n * a screenshot of the page instead of the logo (measured by sales, 10/10).\n *\n * Kept OUT of the core entries so `@broberg/pwa` and `/manifest` stay\n * dependency-free: the renderer, @resvg/resvg-js (prebuilt binaries, no system\n * libraries), is an optional peer loaded only when this runs.\n */\nimport type { IconSet, ManifestIcon } from \"./manifest.js\";\n\nexport interface RasterIcon {\n  /** URL path, e.g. `/icons/icon-180.png`. */\n  path: string;\n  content: Uint8Array;\n  type: \"image/png\";\n  size: number;\n  purpose: \"any\" | \"maskable\";\n}\n\nexport interface RasterIconSet {\n  files: RasterIcon[];\n  /** Manifest `icons[]` pointing at the PNGs. */\n  icons: ManifestIcon[];\n  /** Href for `<link rel=\"apple-touch-icon\">` — pass it to `pwaMetaTags({ appleTouchIcon })`. Undefined when 180 was not generated. */\n  appleTouchIcon?: string;\n}\n\nexport interface RasterizeOptions {\n  /** Extra font files for monogram text (system fonts are loaded too). */\n  fontFiles?: string[];\n}\n\nexport const RESVG_MISSING =\n  \"rasterizeIconSet needs @resvg/resvg-js — install it as a dev dependency: npm i -D @resvg/resvg-js\";\n\nconst toPng = (p: string) => p.replace(/\\.svg$/, \".png\");\n\n/** Rasterise every SVG from `buildIconSet` to a PNG of the same size. */\nexport async function rasterizeIconSet(set: IconSet, opts: RasterizeOptions = {}): Promise<RasterIconSet> {\n  let Resvg: typeof import(\"@resvg/resvg-js\").Resvg;\n  try {\n    ({ Resvg } = await import(\"@resvg/resvg-js\"));\n  } catch {\n    throw new Error(RESVG_MISSING);\n  }\n  const files: RasterIcon[] = set.files.map((f) => {\n    const png = new Resvg(f.content, {\n      fitTo: { mode: \"width\", value: f.size },\n      font: { loadSystemFonts: true, fontFiles: opts.fontFiles ?? [] },\n    })\n      .render()\n      .asPng();\n    return { path: toPng(f.path), content: new Uint8Array(png), type: \"image/png\", size: f.size, purpose: f.purpose };\n  });\n  const icons = set.icons.map((i) => ({ ...i, src: toPng(i.src), type: \"image/png\" }));\n  const apple = files.find((f) => f.size === 180 && f.purpose === \"any\");\n  return { files, icons, appleTouchIcon: apple?.path };\n}\n"]}

package/dist/raster.d.cts

@@ -0,0 +1,56 @@
+interface ManifestIcon {
+    src: string;
+    sizes: string;
+    type: string;
+    /** "any" | "maskable" | "monochrome" (space-separated allowed). */
+    purpose?: string;
+}
+interface GeneratedIcon {
+    /** URL path, e.g. `/icons/icon-192.svg`. */
+    path: string;
+    /** The SVG document. */
+    content: string;
+    type: "image/svg+xml";
+    size: number;
+    purpose: "any" | "maskable";
+}
+interface IconSet {
+    files: GeneratedIcon[];
+    /** Ready to drop into `defineManifest({ icons })`. */
+    icons: ManifestIcon[];
+}
+
+/**
+ * @broberg/pwa/raster — F021.9: PNG icons, because iOS does not use an SVG
+ * apple-touch-icon. «Add to Home Screen» on an iPhone with only SVG icons shows
+ * a screenshot of the page instead of the logo (measured by sales, 10/10).
+ *
+ * Kept OUT of the core entries so `@broberg/pwa` and `/manifest` stay
+ * dependency-free: the renderer, @resvg/resvg-js (prebuilt binaries, no system
+ * libraries), is an optional peer loaded only when this runs.
+ */
+
+interface RasterIcon {
+    /** URL path, e.g. `/icons/icon-180.png`. */
+    path: string;
+    content: Uint8Array;
+    type: "image/png";
+    size: number;
+    purpose: "any" | "maskable";
+}
+interface RasterIconSet {
+    files: RasterIcon[];
+    /** Manifest `icons[]` pointing at the PNGs. */
+    icons: ManifestIcon[];
+    /** Href for `<link rel="apple-touch-icon">` — pass it to `pwaMetaTags({ appleTouchIcon })`. Undefined when 180 was not generated. */
+    appleTouchIcon?: string;
+}
+interface RasterizeOptions {
+    /** Extra font files for monogram text (system fonts are loaded too). */
+    fontFiles?: string[];
+}
+declare const RESVG_MISSING = "rasterizeIconSet needs @resvg/resvg-js \u2014 install it as a dev dependency: npm i -D @resvg/resvg-js";
+/** Rasterise every SVG from `buildIconSet` to a PNG of the same size. */
+declare function rasterizeIconSet(set: IconSet, opts?: RasterizeOptions): Promise<RasterIconSet>;
+
+export { RESVG_MISSING, type RasterIcon, type RasterIconSet, type RasterizeOptions, rasterizeIconSet };

package/dist/raster.d.ts

@@ -0,0 +1,56 @@
+interface ManifestIcon {
+    src: string;
+    sizes: string;
+    type: string;
+    /** "any" | "maskable" | "monochrome" (space-separated allowed). */
+    purpose?: string;
+}
+interface GeneratedIcon {
+    /** URL path, e.g. `/icons/icon-192.svg`. */
+    path: string;
+    /** The SVG document. */
+    content: string;
+    type: "image/svg+xml";
+    size: number;
+    purpose: "any" | "maskable";
+}
+interface IconSet {
+    files: GeneratedIcon[];
+    /** Ready to drop into `defineManifest({ icons })`. */
+    icons: ManifestIcon[];
+}
+
+/**
+ * @broberg/pwa/raster — F021.9: PNG icons, because iOS does not use an SVG
+ * apple-touch-icon. «Add to Home Screen» on an iPhone with only SVG icons shows
+ * a screenshot of the page instead of the logo (measured by sales, 10/10).
+ *
+ * Kept OUT of the core entries so `@broberg/pwa` and `/manifest` stay
+ * dependency-free: the renderer, @resvg/resvg-js (prebuilt binaries, no system
+ * libraries), is an optional peer loaded only when this runs.
+ */
+
+interface RasterIcon {
+    /** URL path, e.g. `/icons/icon-180.png`. */
+    path: string;
+    content: Uint8Array;
+    type: "image/png";
+    size: number;
+    purpose: "any" | "maskable";
+}
+interface RasterIconSet {
+    files: RasterIcon[];
+    /** Manifest `icons[]` pointing at the PNGs. */
+    icons: ManifestIcon[];
+    /** Href for `<link rel="apple-touch-icon">` — pass it to `pwaMetaTags({ appleTouchIcon })`. Undefined when 180 was not generated. */
+    appleTouchIcon?: string;
+}
+interface RasterizeOptions {
+    /** Extra font files for monogram text (system fonts are loaded too). */
+    fontFiles?: string[];
+}
+declare const RESVG_MISSING = "rasterizeIconSet needs @resvg/resvg-js \u2014 install it as a dev dependency: npm i -D @resvg/resvg-js";
+/** Rasterise every SVG from `buildIconSet` to a PNG of the same size. */
+declare function rasterizeIconSet(set: IconSet, opts?: RasterizeOptions): Promise<RasterIconSet>;
+
+export { RESVG_MISSING, type RasterIcon, type RasterIconSet, type RasterizeOptions, rasterizeIconSet };

package/dist/raster.js

@@ -0,0 +1,3 @@
+export { RESVG_MISSING, rasterizeIconSet } from './chunk-JWKQNVNE.js';
+//# sourceMappingURL=raster.js.map
+//# sourceMappingURL=raster.js.map

package/dist/raster.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"raster.js"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@broberg/pwa",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Fleet PWA primitive: a framework-agnostic service-worker update-detection controller (new-version-available lifecycle) + a React hook and unstyled banner skeleton + a service-worker skip-waiting helper. Zero runtime deps; ship-dark.",
   "type": "module",
   "license": "MIT",
@@ -38,6 +38,11 @@
       "import": "./dist/preact.js",
       "require": "./dist/preact.cjs"
     },
+    "./raster": {
+      "types": "./dist/raster.d.ts",
+      "import": "./dist/raster.js",
+      "require": "./dist/raster.cjs"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {
@@ -47,7 +52,8 @@
   },
   "peerDependencies": {
     "preact": ">=10.0.0",
-    "react": ">=18.0.0"
+    "react": ">=18.0.0",
+    "@resvg/resvg-js": ">=2.6.0"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -55,6 +61,9 @@
     },
     "preact": {
       "optional": true
+    },
+    "@resvg/resvg-js": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -67,7 +76,9 @@
     "react-dom": "^19.0.0",
     "tsup": "^8.3.0",
     "typescript": "^5.6.0",
-    "vitest": "^2.1.0"
+    "vitest": "^2.1.0",
+    "@resvg/resvg-js": "^2.6.2",
+    "@types/node": "^22.0.0"
   },
   "keywords": [
     "pwa",
@@ -92,5 +103,8 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "bin": {
+    "pwa-icons": "./dist/bin.js"
   }
 }