pattern-dump 0.3.0 → 0.4.0

package/dist/pd.js

@@ -2,9 +2,11 @@
 import {
   ConfigError,
   sameHostWorkbenchPath,
+  storefrontBasePath,
   suggest,
-  validateConfig
-} from "./chunks/chunk-5WFBNPXB.js";
+  validateConfig,
+  withOwnManifest
+} from "./chunks/chunk-DIDJPCLS.js";
 
 // packages/contracts/src/dev-protocol.ts
 var AUDIT_SCOPE = {
@@ -899,17 +901,78 @@ function checkSchemaHelperNames(schema, helpers) {
 }
 var isHelperNameProblem = (message) => message.includes(`" ${HELPER_NAME}, so {{`);
 
+// packages/renderer/src/helper-shadow.ts
+import Handlebars3 from "handlebars";
+function keysOf(data) {
+  const found = /* @__PURE__ */ new Map();
+  const walk = (v, path) => {
+    if (Array.isArray(v)) {
+      for (const item of v) walk(item, `${path}[]`);
+      return;
+    }
+    if (typeof v !== "object" || v === null) return;
+    for (const [k, child] of Object.entries(v)) {
+      const here = path ? `${path}.${k}` : k;
+      if (!found.has(k)) found.set(k, here);
+      walk(child, here);
+    }
+  };
+  walk(data, "");
+  return found;
+}
+function helperShadows(template, data, helpers, skip = /* @__PURE__ */ new Set()) {
+  let ast;
+  try {
+    ast = Handlebars3.parse(template);
+  } catch {
+    return [];
+  }
+  const helperNames = new Set(helpers);
+  const keys = keysOf(data);
+  const shadows = [];
+  const seen = /* @__PURE__ */ new Set();
+  const visit2 = (node) => {
+    if (Array.isArray(node)) {
+      node.forEach(visit2);
+      return;
+    }
+    if (typeof node !== "object" || node === null) return;
+    const n = node;
+    if (n.type === "MustacheStatement") {
+      const path = n["path"];
+      const params = n["params"];
+      const hash = n["hash"];
+      const name = path?.parts?.[0];
+      if (path?.type === "PathExpression" && !path.data && path.parts?.length === 1 && path.original === name && !params?.length && !hash?.pairs?.length && name && helperNames.has(name) && keys.has(name) && !skip.has(name)) {
+        const loc = n["loc"];
+        const key = `${name}@${loc?.start?.line}:${loc?.start?.column}`;
+        if (!seen.has(key)) {
+          seen.add(key);
+          shadows.push({ name, at: keys.get(name), line: loc?.start?.line ?? 1, column: (loc?.start?.column ?? 0) + 1 });
+        }
+      }
+    }
+    for (const [k, v] of Object.entries(n)) if (k !== "loc" && typeof v === "object") visit2(v);
+  };
+  visit2(ast);
+  return shadows;
+}
+
 // packages/renderer/src/index.ts
 import { HtmlValidate } from "html-validate";
-import Handlebars3 from "handlebars";
+import Handlebars4 from "handlebars";
 import { readFile } from "node:fs/promises";
 import { basename as basename2, isAbsolute, relative as relative2, sep } from "node:path";
+var COMPILE = { preventIndent: true };
 var htmlValidator = new HtmlValidate({
   rules: {
     "element-permitted-content": "error",
     "element-permitted-parent": "error"
   }
 });
+function renderPlainTemplate(source2, data) {
+  return Handlebars4.create().compile(source2, COMPILE)(data);
+}
 function deepMerge(target, ...sources) {
   for (const source2 of sources) {
     if (!source2) continue;
@@ -956,7 +1019,7 @@ async function readDataFile(path, display) {
   }
 }
 function imageTag(source2, o) {
-  const esc = Handlebars3.escapeExpression;
+  const esc = Handlebars4.escapeExpression;
   const rest = `alt="${esc(o.alt)}"${o.title !== void 0 ? ` title="${esc(o.title)}"` : ""} loading="${o.eager ? "eager" : "lazy"}" decoding="async"`;
   if (source2.kind === "single") return `<img src="${esc(source2.url)}" width="${source2.width}" height="${source2.height}" ${rest}>`;
   const widths = o.widths.filter((w) => w <= source2.width);
@@ -1102,7 +1165,7 @@ function makeDisplayPath(roots, displayPath) {
 }
 function dryRunHelperRegistrar(register) {
   try {
-    register(Handlebars3.create());
+    register(Handlebars4.create());
     return null;
   } catch (e) {
     return e instanceof Error ? e.message : String(e);
@@ -1153,7 +1216,7 @@ var createRenderer = (options) => {
       variantData,
       input.data
     );
-    const env = Handlebars3.create();
+    const env = Handlebars4.create();
     const componentSlug = safePart(componentId.replace(/[\\/]/g, "-"));
     let currentBase = `pd-${componentSlug}`;
     const idCache = /* @__PURE__ */ new Map();
@@ -1197,7 +1260,7 @@ var createRenderer = (options) => {
         const baseJsonPath = variantTilde > 0 ? discoveryMap.get(compId.slice(0, variantTilde))?.jsonPath : void 0;
         const baseData = baseJsonPath ? await readDataFile(baseJsonPath, display) : {};
         const childDefaults = deepMerge(structuredClone(baseData.data ?? {}), childData.data);
-        const childTemplate = env.compile(await slotted(partialSrc, compId));
+        const childTemplate = env.compile(await slotted(partialSrc, compId), COMPILE);
         const capturedDefaults = childDefaults;
         const partialSlug = safePart(compId.replace(/[\\/]/g, "-"));
         env.registerPartial(
@@ -1240,7 +1303,7 @@ var createRenderer = (options) => {
     }
     let html;
     try {
-      html = env.compile(await slotted(templateSrc, componentId))(data, {
+      html = env.compile(await slotted(templateSrc, componentId), COMPILE)(data, {
         partials: { ...env.partials, "@partial-block": () => "" },
         // The render's image settings, for {{pd-image}} here and in every partial (data frames pass on).
         data: { pdImages: input.images }
@@ -1321,6 +1384,16 @@ var createRenderer = (options) => {
       }
     } catch {
     }
+    const schemaNamed = new Set(diagnostics.filter((d) => d.kind === "SCHEMA_INVALID" && d.path).map((d) => /\/properties\/([^/]+)$/.exec(d.path)?.[1]).filter((n) => !!n));
+    for (const s of helperShadows(templateSrc, data, Object.keys(env.helpers), schemaNamed)) {
+      diagnostics.push({
+        kind: "HELPER_SHADOW",
+        severity: "warning",
+        source: "render",
+        message: `{{${s.name}}} calls the helper "${s.name}", so the data's "${s.at}" is never read here: write {{this.${s.name}}} to read the field, or give the field another name`,
+        location: { file: display(entry.hbsPath), line: s.line, column: s.column }
+      });
+    }
     const meta = diagnostics.length > 0 ? { componentId, variant, diagnostics } : void 0;
     return { html, document: buildDocument(html, options), ...meta ? { meta } : {} };
   };
@@ -1807,7 +1880,7 @@ function isOwnOrigin(origin, hosts, port2) {
 // packages/dev-server/src/index.ts
 import { createServer } from "node:http";
 import { stat as stat6 } from "node:fs/promises";
-import { join as join28, sep as sep11 } from "node:path";
+import { join as join29, sep as sep11 } from "node:path";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
 
 // packages/dev-server/src/themes.ts
@@ -2313,9 +2386,12 @@ function resolveServerConfig(config, cwd, opts = {}, packages = []) {
       workbenchUrl: config.storefront.workbenchUrl,
       image: config.storefront.image,
       url: config.storefront.url,
+      basePath: storefrontBasePath(config.storefront),
       lang: config.storefront.lang ?? "en",
       index: config.storefront.index !== false,
-      images: { ...images, ...config.storefront.images }
+      images: { ...images, ...config.storefront.images },
+      head: config.storefront.head !== void 0 ? resolve4(cwd, config.storefront.head) : void 0,
+      headName: config.storefront.head
     } : null,
     images,
     overviewsEnabled: config.overviews !== false,
@@ -2516,6 +2592,7 @@ async function buildAllStyleData(roots, componentIds, entryOverride) {
   const componentCssBuckets = /* @__PURE__ */ new Map();
   const baseCssByRoot = [];
   const outsideRules = /* @__PURE__ */ new Map();
+  const baseRulesByEntry = /* @__PURE__ */ new Map();
   for (const id of componentIds) styleUsesModules.set(id, []);
   const rootList = typeof roots === "string" ? [{ dir: roots, ...entryOverride ? { entries: entryOverride } : {} }] : roots;
   for (const styleRoot of rootList) {
@@ -2583,6 +2660,7 @@ async function buildAllStyleData(roots, componentIds, entryOverride) {
       if (!rawMap) continue;
       const consumer = new SourceMapConsumer(rawMap);
       const root = postcss3.parse(compiled.css);
+      const entryBase = /* @__PURE__ */ new Set();
       root.each((node) => {
         const originPath = originPathFor2(node);
         if (originPath === null) return;
@@ -2590,6 +2668,7 @@ async function buildAllStyleData(roots, componentIds, entryOverride) {
         const owner = inBase(originPath) ? "__base__" : resolveScssToComponent(originPath, stylesDir, componentIds) ?? "__base__";
         if (owner === "__base__") {
           addLastOccurrence(baseCssBucket, nodeText);
+          addLastOccurrence(entryBase, nodeText);
           if (reportOutside && !inBase(originPath)) {
             const seen = outsideRules.get(originPath) ?? /* @__PURE__ */ new Set();
             seen.add(nodeText);
@@ -2601,6 +2680,7 @@ async function buildAllStyleData(roots, componentIds, entryOverride) {
           componentCssBuckets.set(owner, bucket);
         }
       });
+      baseRulesByEntry.set(resolve5(entryFile), joinCssChunks(entryBase));
       const { classMap: perFileClasses, baseModules: perFileBaseModules, ranks: perFileRanks } = extractClassesFromCompiled(consumer, root, entryFile, stylesDir, componentIds);
       for (const [name, owner] of perFileClasses) {
         const rank = perFileRanks.get(name) ?? 0;
@@ -2631,7 +2711,8 @@ async function buildAllStyleData(roots, componentIds, entryOverride) {
     componentCssMap,
     // Packages' base rules first (later roots), the project's last — its own base wins the cascade.
     baseCss: joinCssChunks([...baseCssByRoot].reverse().flat()),
-    baseOutsideList: new Map([...outsideRules].map(([path, rules]) => [path, rules.size]))
+    baseOutsideList: new Map([...outsideRules].map(([path, rules]) => [path, rules.size])),
+    baseRulesByEntry
   };
 }
 
@@ -2644,7 +2725,7 @@ async function surfaceCollisions(collisions, cwd, hotreloader) {
     console.warn(`[dev-server] HANDLE_COLLISION: "${col.handle}" \u2014 incumbent: ${col.incumbentPath} \u2014 quarantined: ${col.quarantinedPath}`);
   }
   if (collisions.length > 0) console.warn(`[dev-server] collisions listed in ${join9(pdScratchDir(cwd), "CONFLICTS.generated.md")}`);
-  const md = collisions.length === 0 ? "# Conflicts\n\nNo handle collisions detected.\n" : [
+  const md2 = collisions.length === 0 ? "# Conflicts\n\nNo handle collisions detected.\n" : [
     "# Conflicts",
     "",
     `${collisions.length} handle collision${collisions.length > 1 ? "s" : ""} detected. Quarantined components are excluded from the tree until the collision is resolved.`,
@@ -2659,7 +2740,7 @@ async function surfaceCollisions(collisions, cwd, hotreloader) {
   try {
     const dir = pdScratchDir(cwd);
     await mkdir2(dir, { recursive: true });
-    await writeFile2(join9(dir, "CONFLICTS.generated.md"), md, "utf-8");
+    await writeFile2(join9(dir, "CONFLICTS.generated.md"), md2, "utf-8");
   } catch (e) {
     console.warn("[dev-server] Could not write CONFLICTS.generated.md to scratch dir:", e);
   }
@@ -2677,7 +2758,7 @@ async function surfaceFlattening(discoveryMap, registry, cwd) {
   }
   const hasEdge = (a, b) => (registry.uses.get(a)?.includes(b) ?? false) || (registry.uses.get(b)?.includes(a) ?? false);
   const clusters = detectFlattening(inputs, { hasEdge });
-  const md = renderFlatteningReport(clusters);
+  const md2 = renderFlatteningReport(clusters);
   if (clusters.length) {
     const members = clusters.reduce((n, c3) => n + c3.members.length, 0);
     console.warn(`[dev-server] FLATTENED: ${clusters.length} cluster(s) across ${members} components \u2014 see ${join9(pdScratchDir(cwd), "FLATTENED.generated.md")}`);
@@ -2685,7 +2766,7 @@ async function surfaceFlattening(discoveryMap, registry, cwd) {
   try {
     const dir = pdScratchDir(cwd);
     await mkdir2(dir, { recursive: true });
-    await writeFile2(join9(dir, "FLATTENED.generated.md"), md, "utf-8");
+    await writeFile2(join9(dir, "FLATTENED.generated.md"), md2, "utf-8");
   } catch (e) {
     console.warn("[dev-server] Could not write FLATTENED.generated.md to scratch dir:", e);
   }
@@ -2747,8 +2828,8 @@ async function assetFiles(roots, names) {
       if (!e.isFile()) continue;
       const path = join10(e.parentPath, e.name);
       const rel = relative5(root, path).split(sep2).join("/");
-      if (roots.length > 1) files.push({ url: `${PD_ROUTE_PREFIX.assets}${names[i]}/${rel}`, path });
-      if (i === 0) files.push({ url: `${PD_ROUTE_PREFIX.assets}${rel}`, path });
+      files.push({ url: `${PD_ROUTE_PREFIX.assets}${names[i]}/${rel}`, path });
+      if (i === 0 && !names.includes(rel.split("/")[0])) files.push({ url: `${PD_ROUTE_PREFIX.assets}${rel}`, path });
     }
   }
   return files;
@@ -3086,6 +3167,7 @@ var page_rule_tiers_generated_default = {
 var require4 = createRequire3(import.meta.url);
 var axeSource;
 var source = () => axeSource ??= readFileSync2(require4.resolve("axe-core/axe.min.js"), "utf8");
+var axeScript = () => source();
 var PAGE_TAGS = ["wcag2a", "wcag2aa", "wcag21a", "wcag21aa", "wcag22aa", "best-practice"];
 async function runAxeOnPage(html, rules) {
   const dom = new JSDOM2(html, { url: "http://site.invalid/", runScripts: "outside-only", pretendToBeVisual: true });
@@ -3116,6 +3198,7 @@ async function runPageA11y(html) {
     nodes: v.nodes.map((n) => ({ target: n.target.map(String).join(" "), html: n.html }))
   }));
 }
+var pageRuleTiers = page_rule_tiers_generated_default;
 
 // packages/dev-server/src/diagnostics.ts
 async function checkComponent(componentId, variant, render, quarantineEntry) {
@@ -3137,7 +3220,7 @@ async function checkComponent(componentId, variant, render, quarantineEntry) {
     const a11yDiags = await runA11yProducer(previewHtml);
     return { previewHtml, diagnostics: [...renderDiags, ...a11yDiags] };
   } catch (e) {
-    const location = e instanceof Error && "location" in e ? e.location : void 0;
+    const location2 = e instanceof Error && "location" in e ? e.location : void 0;
     return {
       previewHtml: "",
       diagnostics: [{
@@ -3145,7 +3228,7 @@ async function checkComponent(componentId, variant, render, quarantineEntry) {
         severity: "error",
         source: "render",
         message: e instanceof Error ? e.message : String(e),
-        ...location && Object.keys(location).length ? { location } : {}
+        ...location2 && Object.keys(location2).length ? { location: location2 } : {}
       }]
     };
   }
@@ -3232,7 +3315,8 @@ async function componentContentHash(id, discoveryMap, globalDataDigest2, checkCo
   const entry = discoveryMap.get(id);
   const hbs = entry?.hbsPath ? await readFile8(entry.hbsPath, "utf-8").catch(() => "") : "";
   const json2 = entry?.jsonPath ? await readFile8(entry.jsonPath, "utf-8").catch(() => "") : "";
-  return createHash4("sha1").update(id).update(" ").update(hbs).update(" ").update(json2).update(" ").update(globalDataDigest2).update(" ").update(checkCode).digest("hex");
+  const schema = entry?.schemaPath ? await readFile8(entry.schemaPath, "utf-8").catch(() => "") : "";
+  return createHash4("sha1").update(id).update(" ").update(hbs).update(" ").update(json2).update(" ").update(schema).update(" ").update(globalDataDigest2).update(" ").update(checkCode).digest("hex");
 }
 function globalDataDigest(globalData) {
   return createHash4("sha1").update(JSON.stringify(globalData ?? {})).digest("hex");
@@ -3446,8 +3530,8 @@ async function runDiagnosticsAudit(config, cwd) {
 }
 
 // packages/dev-server/src/static-build.ts
-import { cp, mkdir as mkdir5, readdir as readdir7, rm as rm3, stat as stat4, writeFile as writeFile5 } from "node:fs/promises";
-import { basename as basename4, join as join17, relative as relative9, resolve as resolve7, sep as sep6 } from "node:path";
+import { cp, mkdir as mkdir5, readdir as readdir8, rm as rm3, stat as stat5, writeFile as writeFile5 } from "node:fs/promises";
+import { basename as basename4, join as join19, relative as relative10, resolve as resolve7, sep as sep7 } from "node:path";
 
 // packages/dev-server/src/http-utils.ts
 import { readFile as readFile9 } from "node:fs/promises";
@@ -3568,12 +3652,12 @@ function imageCacheDir(cwd) {
 }
 var caches = /* @__PURE__ */ new WeakMap();
 var cacheFor = (cfg) => {
-  let cache = caches.get(cfg);
-  if (!cache) {
-    cache = createImageCache(imageCacheDir(cfg.cwd));
-    caches.set(cfg, cache);
+  let cache2 = caches.get(cfg);
+  if (!cache2) {
+    cache2 = createImageCache(imageCacheDir(cfg.cwd));
+    caches.set(cfg, cache2);
   }
-  return cache;
+  return cache2;
 };
 async function variantSource(name, hash, width, encoding, cfg) {
   const base2 = PD_ROUTE_PREFIX.assets + name.split("/").map(encodeURIComponent).join("/");
@@ -3611,11 +3695,11 @@ async function serveImageVariant(pathname, host, res, cfg) {
     return;
   }
   if (variant.width > (await imageSize(sharp, source2)).width) return notFound();
-  const cache = cacheFor(cfg);
-  let bytes = await cache.read(variant.hash);
+  const cache2 = cacheFor(cfg);
+  let bytes = await cache2.read(variant.hash);
   if (!bytes) {
     bytes = await encodeWebp(sharp, source2, variant.width, encoding);
-    await cache.write(variant.hash, bytes);
+    await cache2.write(variant.hash, bytes);
   }
   res.writeHead(200, { "Content-Type": "image/webp", "Cache-Control": "public, max-age=31536000, immutable" });
   res.end(bytes);
@@ -3681,172 +3765,618 @@ function createSnapshotWriter({ outDir, basePath, origin, report, fetch: get = (
   return { capture, store, failures };
 }
 
-// packages/dev-server/src/storefront/crawl.ts
-import { request } from "node:http";
-function hostTransport(port2, host) {
-  return (liveUrl) => new Promise((resolve15, reject) => {
-    const req = request({ host: "127.0.0.1", port: port2, path: liveUrl, headers: { host: `${host}:${port2}` } }, (res) => {
-      const chunks = [];
-      res.on("data", (c3) => chunks.push(c3));
-      res.on("end", () => {
-        const headers = new Headers();
-        for (const [k, v] of Object.entries(res.headers)) if (typeof v === "string") headers.set(k, v);
-        resolve15(new Response(Buffer.concat(chunks), { status: res.statusCode ?? 0, headers }));
-      });
-    });
-    req.on("error", reject);
-    req.end();
-  });
+// packages/dev-server/src/storefront/pages.ts
+import { readdir as readdir7, readFile as readFile11, stat as stat4 } from "node:fs/promises";
+import { join as join17, relative as relative9, sep as sep6 } from "node:path";
+
+// packages/dev-server/src/frontmatter.ts
+var BOM = "\uFEFF";
+var unquote = (s) => {
+  const t = s.trim();
+  return t.length >= 2 && (t[0] === '"' || t[0] === "'") && t.at(-1) === t[0] ? t.slice(1, -1) : t;
+};
+var unterminatedQuote = (s) => {
+  const t = s.trim();
+  return (t[0] === '"' || t[0] === "'") && (t.length < 2 || t.at(-1) !== t[0]);
+};
+function block(md2) {
+  const text = md2.startsWith(BOM) ? md2.slice(1) : md2;
+  const lines = text.split(/\r?\n/);
+  if (lines[0]?.trim() !== "---") return { text, lines, end: null };
+  return { text, lines, end: lines.findIndex((l, i) => i > 0 && l.trim() === "---") };
 }
-var unescapeHtml = (s) => s.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, `"`).replace(/&amp;/g, "&");
-var markupRefs = (html) => [
-  ...[...html.matchAll(/(?:href|src)="(\/(?:_pd|assets|preview)\/[^"]+)"/g)].map((m) => unescapeHtml(m[1])),
-  // Each candidate of a srcset: its URL, before the width or density that describes it.
-  ...[...html.matchAll(/srcset="([^"]+)"/g)].flatMap((m) => unescapeHtml(m[1]).split(",").map((c3) => c3.trim().split(/\s+/)[0] ?? "")).filter((u) => /^\/(?:_pd|assets)\//.test(u)),
-  ...[...html.matchAll(/<meta property="og:image" content="https?:\/\/[^/"]+(\/assets\/[^"]+)">/g)].map((m) => unescapeHtml(m[1]))
-];
-var cssRefs = (css) => [...css.matchAll(/url\(\s*(['"]?)(\/(?:_pd|assets)\/[^'")\s]+)\1\s*\)/g)].map((m) => m[2]);
-async function crawlStorefront(get, files = []) {
-  const problems = [];
-  const siteProblems = /* @__PURE__ */ new Set();
-  const list = await get(PD_ROUTES.pages);
-  if (list.status !== 200) {
-    const body = await list.text();
-    let error = body;
-    try {
-      error = JSON.parse(body).error ?? body;
-    } catch {
-    }
-    return { urls: [], problems: error.split("\n").filter(Boolean), documents: /* @__PURE__ */ new Map() };
+function scan(md2) {
+  const errors = [];
+  const err = (line, message) => {
+    errors.push({ line, message });
+  };
+  const { text, lines, end: blockEnd } = block(md2);
+  if (blockEnd === null) {
+    if (/^---\r(?!\n)/.test(text)) err(1, "lines end in a bare CR \u2014 use LF or CRLF line endings");
+    return { values: {}, errors, lines: {} };
   }
-  const { pages } = await list.json();
-  const urls = [];
-  const documents = /* @__PURE__ */ new Map();
-  const seen = /* @__PURE__ */ new Set();
-  const queue = [];
-  const add = (url) => {
-    if (!seen.has(url)) {
-      seen.add(url);
-      queue.push(url);
+  const end = blockEnd;
+  if (end < 0) {
+    err(1, "the frontmatter block opened here is never closed \u2014 end it with a line holding only ---");
+    return { values: {}, errors, lines: {} };
+  }
+  const out = {};
+  const keyLines = {};
+  let listKey = null;
+  for (let i = 1; i < end; i++) {
+    const line = lines[i];
+    const n = i + 1;
+    const bareCr = line.includes("\r");
+    if (bareCr) err(n, "line ends in a bare CR \u2014 use LF or CRLF line endings");
+    const lineErr = (message) => {
+      if (!bareCr) err(n, message);
+    };
+    const item = line.match(/^\s*-\s+(.*)$/);
+    if (item && listKey) {
+      if (unterminatedQuote(item[1])) lineErr(`list item ${item[1].trim()} has an opening quote with no closing one`);
+      out[listKey].push(unquote(item[1]));
+      continue;
     }
-  };
-  for (const p of pages) add(p.route);
-  for (const p of pages) for (const old of p.redirectFrom ?? []) add(old);
-  for (const f of files) add(f);
-  while (queue.length) {
-    const url = queue.shift();
-    const res = await get(url);
-    const type = res.headers.get("content-type") ?? "";
-    if (res.status !== (url === PD_ROUTES.notFound ? 404 : 200)) {
-      const body = await res.text();
-      const items = [...body.matchAll(/<li( data-pd-site)?>([\s\S]*?)<\/li>/g)].map((m) => ({ site: !!m[1], text: unescapeHtml(m[2]) }));
-      for (const i of items) {
-        if (!i.site) problems.push(`${url}: ${i.text}`);
-        else if (!siteProblems.has(i.text)) {
-          siteProblems.add(i.text);
-          problems.push(i.text);
-        }
+    const kv = line.match(/^([A-Za-z_][\w-]*):\s*(.*)$/);
+    if (!kv) {
+      if (line.trim() !== "") {
+        if (item) lineErr("list item with no key above it \u2014 a list follows a line `key:`");
+        else if (/^\s+[A-Za-z_][\w-]*:/.test(line)) lineErr("nested value \u2014 only top-level keys are supported, written at the start of the line");
+        else lineErr(`cannot read this line: ${line.trim()}`);
       }
-      if (!items.length) problems.push(`${url}: ${res.status} ${body.split("\n")[0]?.slice(0, 160) ?? ""}`.trimEnd());
+      listKey = null;
       continue;
     }
-    urls.push(url);
-    if (/text\/html/.test(type)) {
-      const html = await res.text();
-      documents.set(url, html);
-      for (const ref of markupRefs(html)) add(ref);
-    } else if (/text\/css/.test(type)) for (const ref of cssRefs(await res.text())) add(ref);
-  }
-  return { urls, problems, documents };
-}
-
-// packages/dev-server/src/storefront/html-tags.ts
-var MARKUP = /<!--[\s\S]*?-->|<([a-zA-Z][\w:-]*)((?:\s+[^\s"'>/=]+(?:\s*=\s*(?:"[^"]*"|'[^']*'|[^\s"'=<>`]+))?)*)\s*\/?>/g;
-var ATTRIBUTE = /(\s+)([^\s"'>/=]+)(?:(\s*=\s*)("[^"]*"|'[^']*'|[^\s"'=<>`]+))?/g;
-var RAW_TEXT = /* @__PURE__ */ new Set(["script", "style", "textarea", "title"]);
-function startTags(html) {
-  const tags = [];
-  const markup = new RegExp(MARKUP.source, "g");
-  const lower = html.toLowerCase();
-  for (let m = markup.exec(html); m; m = markup.exec(html)) {
-    const name = m[1];
-    if (name === void 0) continue;
-    const tag = { name, start: m.index, end: markup.lastIndex, attrs: m[2] ?? "" };
-    const key = name.toLowerCase();
-    if (RAW_TEXT.has(key)) {
-      const close = lower.indexOf(`</${key}`, tag.end);
-      tag.content = { start: tag.end, end: close < 0 ? html.length : close };
-      markup.lastIndex = tag.content.end;
+    const [, key, raw] = kv;
+    if (key in out) lineErr(`duplicate key "${key}"`);
+    keyLines[key] = n;
+    const value = raw.trim();
+    if (value === "") {
+      out[key] = [];
+      listKey = key;
+    } else if (value.startsWith("[") && value.endsWith("]")) {
+      const items = value.slice(1, -1).split(",");
+      for (const it of items) if (unterminatedQuote(it)) lineErr(`list item ${it.trim()} has an opening quote with no closing one`);
+      out[key] = items.map(unquote).filter(Boolean);
+      listKey = null;
+    } else {
+      if (value.startsWith("[")) lineErr(`"${key}": the list opened with [ is never closed with ]`);
+      else if (unterminatedQuote(value)) lineErr(`"${key}": the value has an opening quote with no closing one`);
+      out[key] = unquote(value);
+      listKey = null;
     }
-    tags.push(tag);
   }
-  return tags;
+  return { values: out, errors, lines: keyLines };
 }
-function decodeAttribute(written) {
-  const q = written[0] === '"' || written[0] === "'" ? written.slice(1, -1) : written;
-  return q.replace(/&(#x[0-9a-f]+|#[0-9]+|amp|lt|gt|quot|apos|#39);/gi, (_, e) => {
-    const k = e.toLowerCase();
-    if (k.startsWith("#x")) return String.fromCodePoint(parseInt(k.slice(2), 16));
-    if (k.startsWith("#")) return String.fromCodePoint(parseInt(k.slice(1), 10));
-    return { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" }[k] ?? `&${e};`;
-  });
+function readFrontmatter(md2) {
+  return scan(md2).values;
 }
-function attributesOf(tag) {
-  return [...tag.attrs.matchAll(ATTRIBUTE)].map((m) => ({ name: m[2].toLowerCase(), value: m[4] === void 0 ? void 0 : decodeAttribute(m[4]) }));
+function readFrontmatterStrict(md2) {
+  return scan(md2);
 }
-
-// packages/dev-server/src/storefront/links.ts
-var SKIPPED = /^(?:mailto|tel|data|javascript):/i;
-var OTHER_HOST = /^(?:[a-z][a-z0-9+.-]*:)?\/\//i;
-function idsOf(html) {
-  const ids = /* @__PURE__ */ new Set();
-  for (const tag of startTags(html)) {
-    for (const a of attributesOf(tag)) {
-      if (a.value === void 0) continue;
-      if (a.name === "id" || a.name === "name" && tag.name.toLowerCase() === "a") ids.add(a.value);
-    }
-  }
-  return ids;
+function frontmatterBodyOffset(md2) {
+  const { end } = block(md2);
+  return end === null || end < 0 ? 0 : end + 1;
 }
-function referencesOf(html) {
-  const refs = [];
-  for (const tag of startTags(html)) {
-    for (const a of attributesOf(tag)) {
-      if (a.value === void 0) continue;
-      if (a.name === "href" || a.name === "src") refs.push([tag.name.toLowerCase(), a.name, a.value.trim()]);
-      else if (a.name === "srcset") {
-        for (const c3 of a.value.split(",")) {
-          const url = c3.trim().split(/\s+/)[0];
-          if (url) refs.push([tag.name.toLowerCase(), a.name, url]);
-        }
-      }
-    }
-  }
-  return refs;
+function frontmatterBody(md2) {
+  const { text, lines, end } = block(md2);
+  if (end === null) return text;
+  if (end < 0) return "";
+  return lines.slice(end + 1).join("\n");
 }
-function linkedWorkbenchRoutes(documents, pages, workbenchUrl) {
-  const routes = /* @__PURE__ */ new Set();
-  for (const page of pages) {
-    for (const [, , ref] of referencesOf(documents.get(page) ?? "")) {
-      let rest;
-      if (OTHER_HOST.test(workbenchUrl)) {
-        if (ref.startsWith(workbenchUrl)) rest = ref.slice(workbenchUrl.length);
-      } else if (!OTHER_HOST.test(ref)) {
-        const path = new URL(ref, `http://site.invalid${page}`).pathname;
-        if (path.startsWith(workbenchUrl)) rest = path.slice(workbenchUrl.length);
-      }
-      if (rest !== void 0) routes.add(decodeURIComponent(rest.split(/[?#]/)[0].replace(/\/$/, "")));
-    }
-  }
-  return routes;
+
+// packages/dev-server/src/tree-order.ts
+function parseOrder(value) {
+  if (value === void 0) return void 0;
+  if (Array.isArray(value)) return { list: value };
+  if (/^-?\d+(\.\d+)?$/.test(value)) return { weight: Number(value) };
+  const list = value.split(",").map((s) => s.trim()).filter(Boolean);
+  return list.length ? { list } : void 0;
 }
-function checkLinks(site) {
-  const problems = [];
-  const external = /* @__PURE__ */ new Map();
-  const idCache = /* @__PURE__ */ new Map();
-  const ids = (url) => {
-    const html = site.documents.get(url);
-    if (html === void 0) return void 0;
+var collator = new Intl.Collator("en", { numeric: true });
+var REST = "...";
+function orderSiblings(items, list) {
+  const position = /* @__PURE__ */ new Map();
+  list?.forEach((name, i) => {
+    if (!position.has(name)) position.set(name, i);
+  });
+  const restPosition = position.get(REST) ?? Infinity;
+  const positionOf2 = (item) => list ? position.get(item.segment) ?? restPosition : 0;
+  return [...items].sort((a, b) => {
+    const ra = a.weight ?? 0;
+    const rb = b.weight ?? 0;
+    if (ra !== rb) return ra - rb;
+    const pa = positionOf2(a);
+    const pb = positionOf2(b);
+    if (pa !== pb) return pa - pb;
+    return collator.compare(a.segment, b.segment) || (a.segment < b.segment ? -1 : a.segment > b.segment ? 1 : 0);
+  });
+}
+
+// packages/dev-server/src/storefront/redirects.ts
+function redirectsOf(f) {
+  const v = f.frontmatter.values["redirectFrom"];
+  return Array.isArray(v) ? v : typeof v === "string" ? [v] : [];
+}
+var RESERVED = [PD_ROUTE_PREFIX.preview, "/_pd/", PD_ROUTE_PREFIX.assets, "/api/", PD_ROUTE_PREFIX.source];
+function redirectProblems(files, workbenchPath) {
+  const problems = [];
+  const claimed = /* @__PURE__ */ new Map();
+  for (const f of files.values()) {
+    const at = `${f.path}${f.frontmatter.lines["redirectFrom"] !== void 0 ? `:${f.frontmatter.lines["redirectFrom"]}` : ""}`;
+    for (const old of redirectsOf(f)) {
+      if (typeof old !== "string" || !old.startsWith("/") || !old.endsWith("/")) continue;
+      const page = files.get(old);
+      if (page) {
+        problems.push(`${at}: redirectFrom "${old}" is the page ${page.path}: a route can't both be a page and forward to one`);
+        continue;
+      }
+      const reserved = RESERVED.find((r) => old.startsWith(r));
+      if (reserved) {
+        problems.push(`${at}: redirectFrom "${old}" is under ${reserved}, which Pattern Dump serves itself`);
+        continue;
+      }
+      if (workbenchPath !== void 0 && old.startsWith(workbenchPath)) {
+        problems.push(`${at}: redirectFrom "${old}" is ${workbenchPlace(old, workbenchPath)}`);
+        continue;
+      }
+      const other = claimed.get(old);
+      if (other && other !== f) {
+        problems.push(`${at}: redirectFrom "${old}" is also claimed by ${other.path}: one old route forwards to one page`);
+        continue;
+      }
+      claimed.set(old, f);
+    }
+  }
+  return problems;
+}
+function workbenchPlace(route, workbenchPath) {
+  return `${route === workbenchPath ? "at" : "under"} ${workbenchPath}, where the workbench is published on this host (storefront.workbenchUrl), so the workbench would overwrite it there`;
+}
+function redirectStub(p) {
+  const target = escapeAttr(p.route);
+  const canonical2 = p.siteUrl !== void 0 ? `
+<link rel="canonical" href="${escapeAttr(new URL(p.route.slice(1), p.siteUrl).href)}">` : "";
+  return `<!DOCTYPE html>
+<html lang="${escapeAttr(p.lang)}">
+<head>
+<meta charset="UTF-8">
+<title>Moved to ${escapeHtml(p.title)}</title>${canonical2}
+<meta name="robots" content="noindex">
+<meta http-equiv="refresh" content="0; url=${target}">
+</head>
+<body>
+<p>This page has moved to <a href="${target}">${escapeHtml(p.title)}</a>.</p>
+</body>
+</html>
+`;
+}
+
+// packages/dev-server/src/storefront/listing-keys.ts
+var DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+var TAG = /^[a-z0-9-]+$/;
+var show = (v) => Array.isArray(v) ? `[${v.join(", ")}]` : `"${v}"`;
+function readDate(v) {
+  const m = typeof v === "string" ? DATE.exec(v) : null;
+  if (m) {
+    const [y, mo, d] = [Number(m[1]), Number(m[2]), Number(m[3])];
+    const t = new Date(Date.UTC(y, mo - 1, d));
+    if (t.getUTCFullYear() === y && t.getUTCMonth() === mo - 1 && t.getUTCDate() === d) return { ok: true, value: v };
+  }
+  return { ok: false, message: `date ${show(v)} is not a date: write it YYYY-MM-DD, such as "2026-11-14"` };
+}
+function readTags(v) {
+  const list = Array.isArray(v) ? v : [v];
+  const bad = list.filter((t) => !TAG.test(t));
+  if (bad.length) {
+    return { ok: false, message: `tags: ${bad.map((t) => `"${t}"`).join(", ")} ${bad.length === 1 ? "is" : "are"} not a tag: a tag is lowercase letters, digits and hyphens, such as "design-systems"` };
+  }
+  const twice = [...new Set(list.filter((t, i) => list.indexOf(t) !== i))];
+  if (twice.length) return { ok: false, message: `tags: ${twice.map((t) => `"${t}"`).join(", ")} ${twice.length === 1 ? "is" : "are"} listed twice` };
+  return { ok: true, value: list };
+}
+function readDraft(v) {
+  return v === "true" || v === "false" ? { ok: true, value: v === "true" } : { ok: false, message: "draft must be true or false" };
+}
+function readSort(v, path) {
+  if (path !== "index.md" && !path.endsWith("/index.md")) {
+    return { ok: false, message: `sort orders a folder's pages, so it belongs on the folder's index.md, not on a page` };
+  }
+  return v === "date" || v === "order" ? { ok: true, value: v } : { ok: false, message: `sort must be "date" (newest first) or "order" (the folder's order, the default)` };
+}
+
+// packages/dev-server/src/storefront/teaser.ts
+import { createHash as createHash5 } from "node:crypto";
+import MarkdownIt from "markdown-it";
+var md = new MarkdownIt({ html: true, linkify: false });
+function plainText(children) {
+  let depth = 0;
+  let out = "";
+  for (const t of children) {
+    if (t.type === "html_inline") {
+      if (/^<pd-[a-z0-9-]+(?:\s[^>]*)?(?<!\/)>$/i.test(t.content.trim())) depth++;
+      else if (/^<\/pd-/i.test(t.content.trim()) && depth > 0) depth--;
+      continue;
+    }
+    if (depth > 0) continue;
+    if (t.type === "text" || t.type === "code_inline") out += t.content;
+    else if (t.type === "softbreak" || t.type === "hardbreak") out += " ";
+  }
+  return out.replace(/\s+/g, " ").trim();
+}
+function firstParagraph(body) {
+  const tokens = md.parse(body, {});
+  for (let i = 0; i < tokens.length; i++) {
+    if (tokens[i].type !== "paragraph_open") continue;
+    const text = plainText(tokens[i + 1]?.children ?? []);
+    if (text !== "") return text;
+  }
+  return null;
+}
+var cache = /* @__PURE__ */ new Map();
+var LIMIT = 1e4;
+var teaserStats = { parses: 0 };
+function teaserOf(body) {
+  const key = createHash5("sha256").update(body).digest("hex");
+  if (cache.has(key)) return cache.get(key);
+  teaserStats.parses++;
+  const value = firstParagraph(body);
+  if (cache.size >= LIMIT) cache.delete(cache.keys().next().value);
+  cache.set(key, value);
+  return value;
+}
+
+// packages/dev-server/src/storefront/pages.ts
+var DEFAULT_LAYOUT = "page";
+var NOT_FOUND_FILE = "404.md";
+function routeFor(path) {
+  const parts = path.replace(/\.md$/, "").split("/");
+  if (parts.at(-1) === "index") parts.pop();
+  return parts.length ? `/${parts.join("/")}/` : "/";
+}
+var NAME = /^[a-z0-9-]+$/;
+async function markdownFiles(dir, root, problems) {
+  const out = [];
+  const entries = (await readdir7(dir, { withFileTypes: true }).catch(() => [])).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+  for (const e of entries) {
+    if (e.name.startsWith(".")) continue;
+    const p = join17(dir, e.name);
+    const rel = relative9(root, p).split(sep6).join("/");
+    if (e.isDirectory()) {
+      if (!NAME.test(e.name)) {
+        problems.push(`${rel}/: a folder name is part of the URL, so it is lowercase letters, digits and hyphens only`);
+        continue;
+      }
+      out.push(...await markdownFiles(p, root, problems));
+    } else if (!e.name.endsWith(".md")) {
+      problems.push(`${rel} is not a page: only .md files belong in the pages folder (images and other files go in the project's assets)`);
+    } else if (!NAME.test(e.name.slice(0, -".md".length))) {
+      problems.push(`${rel}: a page's file name is part of the URL, so it is lowercase letters, digits and hyphens only, then .md`);
+    } else {
+      out.push(rel);
+    }
+  }
+  return out;
+}
+var scalar = (v) => typeof v === "string" ? v : void 0;
+async function readPages(pagesDir, opts = {}) {
+  const problems = [];
+  const files = /* @__PURE__ */ new Map();
+  let notFound;
+  if (!await stat4(pagesDir).then((s) => s.isDirectory(), () => false)) {
+    return { pages: [], nav: [], files, entries: /* @__PURE__ */ new Map(), folders: /* @__PURE__ */ new Map(), drafts: [], problems: [`the pages folder ${pagesDir} does not exist`] };
+  }
+  const bodies = /* @__PURE__ */ new Map();
+  for (const path of (await markdownFiles(pagesDir, pagesDir, problems)).sort()) {
+    const route = routeFor(path);
+    const other = files.get(route);
+    if (other) {
+      problems.push(`${other.path} and ${path} are both the page at ${route}`);
+      continue;
+    }
+    const file = join17(pagesDir, ...path.split("/"));
+    const text = await readFile11(file, "utf8").catch((e) => {
+      if (e.code === "ENOENT") return null;
+      throw e;
+    });
+    if (text === null) continue;
+    if (path === NOT_FOUND_FILE) {
+      notFound = { route: PD_ROUTES.notFound, file, path, frontmatter: readFrontmatterStrict(text) };
+      continue;
+    }
+    files.set(route, { route, file, path, frontmatter: readFrontmatterStrict(text) });
+    bodies.set(route, text);
+  }
+  const isDraft = (f) => {
+    const v = f?.frontmatter.values["draft"];
+    return v !== void 0 && (() => {
+      const r = readDraft(v);
+      return r.ok && r.value;
+    })();
+  };
+  const drafts = [];
+  for (const [route, f] of [...files]) {
+    const segments = route.split("/").filter(Boolean);
+    const folderDraft = segments.slice(0, -1).some((_, i) => isDraft(files.get(`/${segments.slice(0, i + 1).join("/")}/`)));
+    if (!isDraft(f) && !(opts.drafts === "leave-out" && folderDraft)) continue;
+    drafts.push(f.path);
+    if (opts.drafts === "leave-out") {
+      files.delete(route);
+      bodies.delete(route);
+    }
+  }
+  drafts.sort();
+  const pageOf = (f) => {
+    const redirectFrom = redirectsOf(f);
+    return {
+      route: f.route,
+      title: scalar(f.frontmatter.values["title"]) ?? f.route,
+      layout: scalar(f.frontmatter.values["layout"]) ?? DEFAULT_LAYOUT,
+      ...redirectFrom.length ? { redirectFrom } : {}
+    };
+  };
+  const entryOf = (f) => {
+    const description = scalar(f.frontmatter.values["description"]);
+    return { route: f.route, title: pageOf(f).title, ...description !== void 0 ? { description } : {} };
+  };
+  const weightOf = (f) => {
+    const o = parseOrder(f?.frontmatter.values["order"]);
+    return o && "weight" in o ? o.weight : void 0;
+  };
+  const listOf = (f) => {
+    const o = parseOrder(f?.frontmatter.values["order"]);
+    return o && "list" in o ? o.list : void 0;
+  };
+  const folders = /* @__PURE__ */ new Set();
+  for (const f of files.values()) {
+    const parts = f.path.split("/").slice(0, -1);
+    for (let i = 1; i <= parts.length; i++) folders.add(`/${parts.slice(0, i).join("/")}/`);
+  }
+  if (!files.has("/")) problems.push("there is no home page: the pages folder needs an index.md at its top, the page at /");
+  for (const folder of [...folders].sort()) {
+    if (!files.has(folder)) problems.push(`the folder ${folder.slice(1)} holds pages but has no index.md \u2014 it needs one, as the folder's own page`);
+  }
+  const childrenOf = (folder) => {
+    const depth = folder === "/" ? 0 : folder.split("/").length - 2;
+    const out = /* @__PURE__ */ new Map();
+    for (const route of [...files.keys(), ...folders]) {
+      if (route === folder || !route.startsWith(folder)) continue;
+      const segs = route.split("/").filter(Boolean);
+      if (segs.length !== depth + 1) continue;
+      out.set(route, segs[depth]);
+    }
+    return [...out].map(([route, segment]) => ({ route, segment }));
+  };
+  const ordered = (folder, extra = []) => {
+    const items = childrenOf(folder).map((c3) => {
+      const w = weightOf(files.get(c3.route));
+      return { route: c3.route, segment: c3.segment, ...w !== void 0 ? { weight: w } : {} };
+    });
+    return orderSiblings([...extra, ...items], listOf(files.get(folder)));
+  };
+  const home = files.get("/");
+  const homeWeight = weightOf(home);
+  const top = ordered("/", home ? [{ route: "/", segment: "index", ...homeWeight !== void 0 ? { weight: homeWeight } : {} }] : []);
+  const nav = [];
+  for (const item of top) {
+    const page = files.get(item.route);
+    if (!page) continue;
+    const children = folders.has(item.route) && item.route !== "/" ? ordered(item.route).flatMap((c3) => {
+      const p = files.get(c3.route);
+      return p ? [entryOf(p)] : [];
+    }) : [];
+    nav.push({ ...entryOf(page), ...children.length ? { children } : {} });
+  }
+  const inNav = nav.flatMap((n) => [n.route, ...(n.children ?? []).map((c3) => c3.route)]);
+  const rest = [...files.keys()].filter((r) => !inNav.includes(r)).sort();
+  const routes = [...inNav, ...rest];
+  const pages = routes.map((r) => pageOf(files.get(r)));
+  const { workbenchPath } = opts;
+  if (workbenchPath !== void 0) {
+    for (const f of files.values()) {
+      if (f.route.startsWith(workbenchPath)) problems.push(`${f.path}: the page ${f.route} is ${workbenchPlace(f.route, workbenchPath)}`);
+    }
+  }
+  problems.push(...redirectProblems(files, workbenchPath));
+  const ok = (v, read) => {
+    if (v === void 0) return void 0;
+    const r = read(v);
+    return r.ok ? r.value : void 0;
+  };
+  const entries = /* @__PURE__ */ new Map();
+  for (const route of routes) {
+    const f = files.get(route);
+    const v = f.frontmatter.values;
+    const description = scalar(v["description"]);
+    const image = scalar(v["image"]);
+    entries.set(route, {
+      description: description ?? teaserOf(frontmatterBody(bodies.get(route))),
+      date: ok(v["date"], readDate) ?? null,
+      image: image !== void 0 && /^\/assets\/[^?#]+[^/?#]$/.test(image) ? image : null,
+      tags: ok(v["tags"], readTags) ?? [],
+      draft: ok(v["draft"], readDraft) ?? false
+    });
+  }
+  const listings = /* @__PURE__ */ new Map();
+  for (const folder of ["/", ...[...folders].sort()]) {
+    const index = files.get(folder);
+    if (!index) continue;
+    listings.set(folder, {
+      sort: ok(index.frontmatter.values["sort"], (v) => readSort(v, index.path)) ?? "order",
+      children: ordered(folder).map((c3) => c3.route).filter((r) => files.has(r))
+    });
+  }
+  return { pages, nav, files: new Map(routes.map((r) => [r, files.get(r)])), entries, folders: listings, drafts, problems, ...notFound ? { notFound } : {} };
+}
+
+// packages/dev-server/src/storefront/crawl.ts
+import { request } from "node:http";
+function hostTransport(port2, host, basePath = "/") {
+  return (liveUrl) => new Promise((resolve15, reject) => {
+    const path = basePath === "/" || !liveUrl.startsWith("/") ? liveUrl : `${basePath}${liveUrl.slice(1)}`;
+    const req = request({ host: "127.0.0.1", port: port2, path, headers: { host: `${host}:${port2}` } }, (res) => {
+      const chunks = [];
+      res.on("data", (c3) => chunks.push(c3));
+      res.on("end", () => {
+        const headers = new Headers();
+        for (const [k, v] of Object.entries(res.headers)) if (typeof v === "string") headers.set(k, v);
+        resolve15(new Response(Buffer.concat(chunks), { status: res.statusCode ?? 0, headers }));
+      });
+    });
+    req.on("error", reject);
+    req.end();
+  });
+}
+var unescapeHtml = (s) => s.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, `"`).replace(/&amp;/g, "&");
+var toSite = (ref, base2) => base2 === "/" ? ref : ref.startsWith(base2) ? `/${ref.slice(base2.length)}` : null;
+var markupRefs = (html, base2) => [
+  ...[...html.matchAll(/(?:href|src)="(\/[^"]+)"/g)].map((m) => unescapeHtml(m[1])),
+  // Each candidate of a srcset: its URL, before the width or density that describes it.
+  ...[...html.matchAll(/srcset="([^"]+)"/g)].flatMap((m) => unescapeHtml(m[1]).split(",").map((c3) => c3.trim().split(/\s+/)[0] ?? "")),
+  ...[...html.matchAll(/<meta property="og:image" content="https?:\/\/[^/"]+(\/[^"]+)">/g)].map((m) => unescapeHtml(m[1]))
+].map((u) => toSite(u, base2)).filter((u) => u !== null && /^\/(?:_pd|assets|preview)\//.test(u));
+var cssRefs = (css, base2) => [...css.matchAll(/url\(\s*(['"]?)(\/[^'")\s]+)\1\s*\)/g)].map((m) => toSite(m[2], base2)).filter((u) => u !== null && /^\/(?:_pd|assets)\//.test(u));
+async function crawlStorefront(get, files = [], basePath = "/") {
+  const problems = [];
+  const siteProblems = /* @__PURE__ */ new Set();
+  const list = await get(PD_ROUTES.pages);
+  if (list.status !== 200) {
+    const body = await list.text();
+    let error = body;
+    try {
+      error = JSON.parse(body).error ?? body;
+    } catch {
+    }
+    return { urls: [], problems: error.split("\n").filter(Boolean), documents: /* @__PURE__ */ new Map() };
+  }
+  const { pages } = await list.json();
+  const urls = [];
+  const documents = /* @__PURE__ */ new Map();
+  const seen = /* @__PURE__ */ new Set();
+  const queue = [];
+  const add = (url) => {
+    if (!seen.has(url)) {
+      seen.add(url);
+      queue.push(url);
+    }
+  };
+  for (const p of pages) add(p.route);
+  for (const p of pages) for (const old of p.redirectFrom ?? []) add(old);
+  for (const f of files) add(f);
+  while (queue.length) {
+    const url = queue.shift();
+    const res = await get(url);
+    const type = res.headers.get("content-type") ?? "";
+    if (res.status !== (url === PD_ROUTES.notFound ? 404 : 200)) {
+      const body = await res.text();
+      const items = [...body.matchAll(/<li( data-pd-site)?>([\s\S]*?)<\/li>/g)].map((m) => ({ site: !!m[1], text: unescapeHtml(m[2]) }));
+      for (const i of items) {
+        if (!i.site) problems.push(`${url}: ${i.text}`);
+        else if (!siteProblems.has(i.text)) {
+          siteProblems.add(i.text);
+          problems.push(i.text);
+        }
+      }
+      if (!items.length) problems.push(`${url}: ${res.status} ${body.split("\n")[0]?.slice(0, 160) ?? ""}`.trimEnd());
+      continue;
+    }
+    urls.push(url);
+    if (/text\/html/.test(type)) {
+      const html = await res.text();
+      documents.set(url, html);
+      for (const ref of markupRefs(html, basePath)) add(ref);
+    } else if (/text\/css/.test(type)) for (const ref of cssRefs(await res.text(), basePath)) add(ref);
+  }
+  return { urls, problems, documents };
+}
+
+// packages/dev-server/src/storefront/html-tags.ts
+var MARKUP = /<!--[\s\S]*?-->|<([a-zA-Z][\w:-]*)((?:\s+[^\s"'>/=]+(?:\s*=\s*(?:"[^"]*"|'[^']*'|[^\s"'=<>`]+))?)*)\s*\/?>/g;
+var ATTRIBUTE = /(\s+)([^\s"'>/=]+)(?:(\s*=\s*)("[^"]*"|'[^']*'|[^\s"'=<>`]+))?/g;
+var RAW_TEXT = /* @__PURE__ */ new Set(["script", "style", "textarea", "title"]);
+function startTags(html) {
+  const tags = [];
+  const markup = new RegExp(MARKUP.source, "g");
+  const lower = html.toLowerCase();
+  for (let m = markup.exec(html); m; m = markup.exec(html)) {
+    const name = m[1];
+    if (name === void 0) continue;
+    const tag = { name, start: m.index, end: markup.lastIndex, attrs: m[2] ?? "" };
+    const key = name.toLowerCase();
+    if (RAW_TEXT.has(key)) {
+      const close = lower.indexOf(`</${key}`, tag.end);
+      tag.content = { start: tag.end, end: close < 0 ? html.length : close };
+      markup.lastIndex = tag.content.end;
+    }
+    tags.push(tag);
+  }
+  return tags;
+}
+function decodeAttribute(written) {
+  const q = written[0] === '"' || written[0] === "'" ? written.slice(1, -1) : written;
+  return q.replace(/&(#x[0-9a-f]+|#[0-9]+|amp|lt|gt|quot|apos|#39);/gi, (_, e) => {
+    const k = e.toLowerCase();
+    if (k.startsWith("#x")) return String.fromCodePoint(parseInt(k.slice(2), 16));
+    if (k.startsWith("#")) return String.fromCodePoint(parseInt(k.slice(1), 10));
+    return { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" }[k] ?? `&${e};`;
+  });
+}
+function attributesOf(tag) {
+  return [...tag.attrs.matchAll(ATTRIBUTE)].map((m) => ({ name: m[2].toLowerCase(), value: m[4] === void 0 ? void 0 : decodeAttribute(m[4]) }));
+}
+
+// packages/dev-server/src/storefront/links.ts
+var SKIPPED = /^(?:mailto|tel|data|javascript):/i;
+var OTHER_HOST = /^(?:[a-z][a-z0-9+.-]*:)?\/\//i;
+function idsOf(html) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const tag of startTags(html)) {
+    for (const a of attributesOf(tag)) {
+      if (a.value === void 0) continue;
+      if (a.name === "id" || a.name === "name" && tag.name.toLowerCase() === "a") ids.add(a.value);
+    }
+  }
+  return ids;
+}
+function referencesOf(html) {
+  const refs = [];
+  for (const tag of startTags(html)) {
+    for (const a of attributesOf(tag)) {
+      if (a.value === void 0) continue;
+      if (a.name === "href" || a.name === "src") refs.push([tag.name.toLowerCase(), a.name, a.value.trim()]);
+      else if (a.name === "srcset") {
+        for (const c3 of a.value.split(",")) {
+          const url = c3.trim().split(/\s+/)[0];
+          if (url) refs.push([tag.name.toLowerCase(), a.name, url]);
+        }
+      }
+    }
+  }
+  return refs;
+}
+function linkedWorkbenchRoutes(documents, pages, workbenchUrl) {
+  const routes = /* @__PURE__ */ new Set();
+  for (const page of pages) {
+    for (const [, , ref] of referencesOf(documents.get(page) ?? "")) {
+      let rest;
+      if (OTHER_HOST.test(workbenchUrl)) {
+        if (ref.startsWith(workbenchUrl)) rest = ref.slice(workbenchUrl.length);
+      } else if (!OTHER_HOST.test(ref)) {
+        const path = new URL(ref, `http://site.invalid${page}`).pathname;
+        if (path.startsWith(workbenchUrl)) rest = path.slice(workbenchUrl.length);
+      }
+      if (rest !== void 0) routes.add(decodeURIComponent(rest.split(/[?#]/)[0].replace(/\/$/, "")));
+    }
+  }
+  return routes;
+}
+function checkLinks(site) {
+  const problems = [];
+  const external = /* @__PURE__ */ new Map();
+  const idCache = /* @__PURE__ */ new Map();
+  const ids = (url) => {
+    const html = site.documents.get(url);
+    if (html === void 0) return void 0;
     let found = idCache.get(url);
     if (!found) idCache.set(url, found = idsOf(html));
     return found;
@@ -3867,6 +4397,8 @@ function checkLinks(site) {
     if (hash && !(wb.variants.get(route) ?? []).includes(decodeURIComponent(hash))) return `${route} has no variant "${hash}" in the workbench`;
     return void 0;
   };
+  const base2 = site.basePath ?? "/";
+  const hint = site.pathHint ?? base2;
   let references = 0;
   for (const page of site.pages) {
     const html = site.documents.get(page);
@@ -3882,7 +4414,7 @@ function checkLinks(site) {
         continue;
       }
       let href = ref;
-      if (site.siteUrl && ref.startsWith(site.siteUrl)) href = `/${ref.slice(site.siteUrl.length)}`;
+      if (site.siteUrl && ref.startsWith(site.siteUrl)) href = `${base2}${ref.slice(site.siteUrl.length)}`;
       else if (OTHER_HOST.test(ref)) {
         if (site.pagesOnly) continue;
         const list = external.get(ref) ?? [];
@@ -3890,18 +4422,24 @@ function checkLinks(site) {
         external.set(ref, list);
         continue;
       }
-      const url = new URL(href, `http://site.invalid${page}`);
-      const path = decodeURIComponent(url.pathname);
+      const url = new URL(href, `http://site.invalid${base2}${page.slice(1)}`);
+      const served = decodeURIComponent(url.pathname);
       const hash = url.hash.slice(1);
-      if (wb && wb.url.startsWith("/") && path.startsWith(wb.url)) {
-        const why = workbenchProblem(path.slice(wb.url.length), hash);
+      if (wb && wb.url.startsWith("/") && served.startsWith(wb.url)) {
+        const why = workbenchProblem(served.slice(wb.url.length), hash);
         if (why) say(why);
         continue;
       }
+      if (!served.startsWith(base2)) {
+        say(`${served} is outside ${base2}, the path the site is published under (storefront.url)`);
+        continue;
+      }
+      const path = `/${served.slice(base2.length)}`;
       if (site.pagesOnly && /^\/(?:_pd|assets|preview)\//.test(path)) continue;
       const target = builtAs(path);
       if (target === void 0) {
-        say(`no page or file is built at ${path}`);
+        const doubled = hint !== "/" && path.startsWith(hint) && builtAs(`/${path.slice(hint.length)}`) !== void 0;
+        say(doubled ? `no page or file is built at ${path}: the link is written with the site's path ${hint} already; write it from the site's root, such as /${path.slice(hint.length)}, and the path is put in front of it` : `no page or file is built at ${path}`);
         continue;
       }
       if (!hash) continue;
@@ -3928,6 +4466,135 @@ function checkPageBasics(html) {
   return problems;
 }
 
+// packages/dev-server/src/storefront/browser-checks.ts
+import { createRequire as createRequire4 } from "node:module";
+import { join as join18 } from "node:path";
+import { pathToFileURL as pathToFileURL2 } from "node:url";
+var BrowserUnavailableError = class extends Error {
+};
+var INSTALL = "npm install --save-dev playwright, then npx playwright install chromium";
+async function loadProjectPlaywright(root) {
+  const require5 = createRequire4(join18(root, "package.json"));
+  for (const name of ["playwright", "@playwright/test"]) {
+    let resolved;
+    try {
+      resolved = require5.resolve(name);
+    } catch {
+      continue;
+    }
+    const mod = await import(pathToFileURL2(resolved).href);
+    const chromium = mod.chromium ?? mod.default?.chromium;
+    if (chromium) return { chromium };
+  }
+  throw new BrowserUnavailableError(`pd build --browser needs Playwright in this project: ${INSTALL}`);
+}
+var VIEWPORTS = [
+  { name: "1000\xD7720", viewport: { width: 1e3, height: 720 }, dpr: 1 },
+  { name: "390\xD7844", viewport: { width: 390, height: 844 }, dpr: 2 }
+];
+async function runBrowserChecks(o) {
+  const base2 = o.basePath ?? "/";
+  let browser;
+  try {
+    browser = await o.playwright.chromium.launch({ headless: true });
+  } catch (e) {
+    throw new BrowserUnavailableError(`pd build --browser couldn't start Chromium (${(e instanceof Error ? e.message : String(e)).split("\n")[0]}): ${INSTALL}`);
+  }
+  const origin = "http://site.invalid";
+  const axe2 = axeScript();
+  const found = /* @__PURE__ */ new Map();
+  const note = (kind, key, text, at) => {
+    const f = found.get(key) ?? { kind, text, at: [] };
+    f.at.push(at);
+    found.set(key, f);
+  };
+  let current = "";
+  try {
+    for (const vp of VIEWPORTS) {
+      const context = await browser.newContext({ viewport: vp.viewport, deviceScaleFactor: vp.dpr });
+      await context.route("**/*", async (route) => {
+        const url = new URL(route.request().url());
+        if (url.origin !== origin) {
+          await route.abort();
+          return;
+        }
+        if (!url.pathname.startsWith(base2)) {
+          if (url.pathname !== "/favicon.ico") {
+            const text = `${current}: a request to ${url.pathname}${url.search} is outside ${base2}, the path the site is published under (storefront.url): a script that builds this URL needs the site's path, which <meta name="pd-base-path"> names`;
+            note("error", `outside ${text}`, text, vp.name);
+          }
+          await route.fulfill({ status: 404, body: Buffer.from("") });
+          return;
+        }
+        const res = await o.get(`/${url.pathname.slice(base2.length)}${url.search}`);
+        const headers = {};
+        const type = res.headers.get("content-type");
+        if (type) headers["content-type"] = type;
+        await route.fulfill({ status: res.status, headers, body: Buffer.from(await res.arrayBuffer()) });
+      });
+      const page = await context.newPage();
+      for (const path of o.pages) {
+        current = path;
+        await page.goto(`${origin}${base2}${path.slice(1)}`, { waitUntil: "load" });
+        await page.addScriptTag({ content: axe2 });
+        const violations = await page.evaluate(async (rules) => {
+          const r = await window.axe.run(document, { runOnly: { type: "rule", values: rules }, resultTypes: ["violations"], iframes: false });
+          return r.violations;
+        }, pageRuleTiers.browser);
+        for (const v of violations) {
+          const where = v.nodes.map((n) => n.target.map(String).join(" ")).join(", ");
+          const text = `${path}: ${v.id} (${v.impact ?? "minor"}): ${v.help}, on ${where} (${v.helpUrl})`;
+          note(severityOf(v.impact, v.tags) === "error" ? "error" : "a11y", `a11y ${text}`, text, vp.name);
+        }
+        const images = await page.evaluate(async () => {
+          const seen = [];
+          for (const img of Array.from(document.querySelectorAll("img[srcset]"))) {
+            img.scrollIntoView({ block: "center", inline: "center" });
+            if (!img.complete || img.naturalWidth === 0) {
+              await new Promise((resolve15) => {
+                const done = () => resolve15();
+                img.addEventListener("load", done, { once: true });
+                img.addEventListener("error", done, { once: true });
+                setTimeout(done, 5e3);
+              });
+            }
+            const candidates = img.srcset.split(",").map((c3) => c3.trim().split(/\s+/)).map(([u, d]) => ({ url: new URL(u, location.href).href, w: parseInt(d ?? "", 10) }));
+            const chosen = candidates.find((c3) => c3.url === img.currentSrc);
+            seen.push({
+              src: img.getAttribute("src") ?? "",
+              sizes: img.sizes,
+              box: img.getBoundingClientRect().width,
+              chosen: chosen && !Number.isNaN(chosen.w) ? chosen.w : null,
+              candidates: candidates.map((c3) => c3.w).filter((w) => !Number.isNaN(w))
+            });
+          }
+          return seen;
+        }, void 0);
+        for (const img of images) {
+          if (img.chosen === null || img.box === 0) continue;
+          const need = Math.round(img.box * vp.dpr);
+          const covering = img.candidates.filter((w) => w >= need).sort((a, b) => a - b)[0];
+          const written = img.src.replace(/\?v=[0-9a-f]+$/, "");
+          const src = base2 !== "/" && written.startsWith(base2) ? `/${written.slice(base2.length)}` : written;
+          const asset = /^\/_pd\/images\/(.+)\.[0-9a-f]{10}\.\d+\.webp$/.exec(src)?.[1];
+          const what = asset ? `the image ${asset}` : `<img src="${src}">`;
+          const box = `is laid out ${Math.round(img.box)} px wide (${need} px at ${vp.dpr}x)`;
+          if (covering !== void 0 && img.chosen > covering) {
+            note("image", `image ${path} ${src} large`, `${path}: ${what} ${box} but takes the ${img.chosen}w variant where ${covering}w would do: its sizes, "${img.sizes}", says it is wider than it is`, vp.name);
+          } else if (img.chosen < need && img.candidates.some((w) => w > img.chosen)) {
+            note("image", `image ${path} ${src} small`, `${path}: ${what} ${box} but takes the ${img.chosen}w variant, which is too small: its sizes, "${img.sizes}", says it is narrower than it is`, vp.name);
+          }
+        }
+      }
+      await context.close();
+    }
+  } finally {
+    await browser.close();
+  }
+  const lines = (kind) => [...found.values()].filter((f) => f.kind === kind).map((f) => `${f.text} (at ${f.at.join(" and ")})`);
+  return { errors: lines("error"), a11yWarnings: lines("a11y"), images: lines("image") };
+}
+
 // packages/dev-server/src/storefront/site-files.ts
 var escapeXml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 function sitemapXml(entries) {
@@ -3954,6 +4621,68 @@ Sitemap: ${p.siteUrl}sitemap.xml
 ` : ""}`;
 }
 
+// packages/dev-server/src/storefront/base-path.ts
+var URL_ATTRIBUTES = /* @__PURE__ */ new Set(["href", "src", "poster", "action", "formaction", "xlink:href"]);
+var SRCSET_ATTRIBUTES = /* @__PURE__ */ new Set(["srcset", "imagesrcset"]);
+function withBase(ref, p) {
+  if (p.base === "/" || !ref.startsWith("/") || ref.startsWith("//") || ref.startsWith("/\\")) return ref;
+  if (p.workbenchPath !== void 0 && p.workbenchPath !== "/" && ref.startsWith(p.workbenchPath)) return ref;
+  return `${p.base}${ref.slice(1)}`;
+}
+function withBaseSrcset(value, p) {
+  return value.split(",").map((entry) => {
+    const m = /^(\s*)(\S+)(.*)$/s.exec(entry);
+    return m ? `${m[1]}${withBase(m[2], p)}${m[3]}` : entry;
+  }).join(",");
+}
+function withBaseCss(css, p) {
+  if (p.base === "/") return css;
+  return css.replace(/url\(\s*(['"]?)([^'")\s]+)\1\s*\)/g, (whole, q, ref) => {
+    const out = withBase(ref, p);
+    return out === ref ? whole : `url(${q}${out}${q})`;
+  }).replace(/(@import\s+)(["'])([^"']+)\2/g, (_whole, at, q, ref) => `${at}${q}${withBase(ref, p)}${q}`);
+}
+function withBaseAttrs(name, attrs, p) {
+  const tag = name.toLowerCase();
+  const refresh = tag === "meta" && /\shttp-equiv\s*=\s*["']?refresh/i.test(attrs);
+  return attrs.replace(ATTRIBUTE, (whole, lead, attr2, eq, quoted) => {
+    if (quoted === void 0 || eq === void 0) return whole;
+    const q = quoted[0] === '"' || quoted[0] === "'" ? quoted[0] : "";
+    const value = q ? quoted.slice(1, -1) : quoted;
+    const key = attr2.toLowerCase();
+    let out = value;
+    if (URL_ATTRIBUTES.has(key) || key === "data" && tag === "object") out = withBase(value, p);
+    else if (SRCSET_ATTRIBUTES.has(key)) out = withBaseSrcset(value, p);
+    else if (key === "style") out = withBaseCss(value, p);
+    else if (key === "content" && refresh) {
+      out = value.replace(/^(\s*[\d.]*\s*[;,]\s*(?:url\s*=\s*)?)(['"]?)(\S[^'"]*)/i, (_m, head, uq, ref) => `${head}${uq}${withBase(ref, p)}`);
+    }
+    return out === value ? whole : `${lead}${attr2}${eq}${q}${out}${q}`;
+  });
+}
+function withBaseHtml(html, p) {
+  if (p.base === "/") return html;
+  const parts = [];
+  let last = 0;
+  for (const tag of startTags(html)) {
+    parts.push(html.slice(last, tag.start));
+    const attrsAt = tag.start + 1 + tag.name.length;
+    parts.push(`<${tag.name}${withBaseAttrs(tag.name, tag.attrs, p)}${html.slice(attrsAt + tag.attrs.length, tag.end)}`);
+    last = tag.end;
+    if (!tag.content) continue;
+    const content = html.slice(tag.content.start, tag.content.end);
+    parts.push(tag.name.toLowerCase() === "style" ? withBaseCss(content, p) : content);
+    last = tag.content.end;
+  }
+  parts.push(html.slice(last));
+  return parts.join("");
+}
+function withNoindex(html) {
+  if (/<meta\s+name=["']?robots["']?/i.test(html)) return html;
+  return html.replace(/<head(\s[^>]*)?>/i, (head) => `${head}
+<meta name="robots" content="noindex">`);
+}
+
 // packages/dev-server/src/static-build.ts
 var notABarrier = (path) => basename4(path) !== ".__testOnly_barrier";
 async function buildStaticSite(config, root, opts) {
@@ -3966,8 +4695,8 @@ async function buildStaticSite(config, root, opts) {
   const outDir = resolve7(opts.outDir);
   const cfg = resolveServerConfig(config, root, {}, loadPatternPackages(config.packages, root));
   const inside2 = (child, parent) => {
-    const rel = relative9(parent, child);
-    return rel === "" || !rel.startsWith("..") && !rel.startsWith(sep6) && !/^[a-zA-Z]:/.test(rel);
+    const rel = relative10(parent, child);
+    return rel === "" || !rel.startsWith("..") && !rel.startsWith(sep7) && !/^[a-zA-Z]:/.test(rel);
   };
   const project = resolve7(root);
   if (inside2(project, outDir)) throw new Error(`pd build: --out ${outDir} would contain the project itself \u2014 choose a folder inside or beside it, like ./dist`);
@@ -3996,6 +4725,7 @@ async function buildStaticSite(config, root, opts) {
       throw new Error(`pd build: storefront.workbenchUrl is ${storefront.workbenchUrl}, so the workbench must be built for ${sameHost} (build.basePath or --base); it is being built for ${basePath}`);
     }
   }
+  const playwright = opts.browser && storefront ? await (opts.loadPlaywright ?? loadProjectPlaywright)(project) : void 0;
   const fixed = opts.now;
   const now = fixed ? () => new Date(fixed.getTime()) : () => /* @__PURE__ */ new Date();
   const storefrontNotes = /* @__PURE__ */ new Set();
@@ -4009,9 +4739,14 @@ async function buildStaticSite(config, root, opts) {
     }
   });
   log("\u2026 server ready");
-  const sfGet = storefront ? hostTransport(server.port, storefront.host) : null;
-  const sfFiles = storefront ? [PD_ROUTES.robots, PD_ROUTES.notFound, ...storefront.url !== void 0 && storefront.index ? [PD_ROUTES.sitemap] : []] : [];
-  const sfCrawl = sfGet ? await crawlStorefront(sfGet, sfFiles) : null;
+  const sfBase = storefront?.basePath ?? "/";
+  const sfGet = storefront ? hostTransport(server.port, storefront.host, sfBase) : null;
+  const sfFiles = storefront ? [
+    ...sfBase === "/" ? [PD_ROUTES.robots] : [],
+    PD_ROUTES.notFound,
+    ...storefront.url !== void 0 && storefront.index ? [PD_ROUTES.sitemap] : []
+  ] : [];
+  const sfCrawl = sfGet ? await crawlStorefront(sfGet, sfFiles, sfBase) : null;
   if (sfCrawl && sfCrawl.problems.length) {
     await server.close();
     throw new Error(`pd build: the storefront has problems, so nothing was written:
@@ -4021,6 +4756,7 @@ ${sfCrawl.problems.map((p) => `  - ${p}`).join("\n")}`);
   const origin = `http://127.0.0.1:${server.port}`;
   let linkSummary;
   let a11ySummary;
+  let imageSummary;
   const externalNotes = [];
   if (storefront && sfGet && sfCrawl) {
     const { pages: list } = await (await sfGet(PD_ROUTES.pages)).json();
@@ -4048,6 +4784,7 @@ ${sfCrawl.problems.map((p) => `  - ${p}`).join("\n")}`);
       documents: sfCrawl.documents,
       pages,
       ...storefront.url !== void 0 ? { siteUrl: storefront.url.endsWith("/") ? storefront.url : `${storefront.url}/` } : {},
+      basePath: sfBase,
       workbench: { url: wbUrl, routes, variants }
     });
     if (links.problems.length) {
@@ -4081,15 +4818,34 @@ ${links.problems.map((p) => `  - ${p}`).join("\n")}`);
       throw new Error(`pd build: the storefront has accessibility problems, so nothing was written:
 ${errors.map((e) => `  - ${e}`).join("\n")}`);
     }
+    let imageWarnings;
+    const browserWarnings = [];
+    if (playwright) {
+      const checked = await runBrowserChecks({ pages, get: sfGet, playwright, basePath: sfBase }).catch(async (e) => {
+        await server.close();
+        throw e;
+      });
+      if (checked.errors.length) {
+        await server.close();
+        throw new Error(`pd build: the storefront has problems in a browser, so nothing was written:
+${checked.errors.map((e) => `  - ${e}`).join("\n")}`);
+      }
+      browserWarnings.push(...checked.a11yWarnings);
+      imageWarnings = checked.images;
+      log(`\u2026 checked in Chromium at ${VIEWPORTS.map((v) => `${v.name} @${v.dpr}x`).join(" and ")}`);
+    }
+    imageSummary = imageWarnings ? { warnings: imageWarnings } : void 0;
     a11ySummary = {
       pages: pages.length,
-      warnings: [...warned.values()].map((w) => `${w.finding.ruleId} (${w.finding.impact}): ${w.finding.help}, ${w.elements} element${w.elements === 1 ? "" : "s"} on ${w.pages.join(", ")} (${w.finding.helpUrl})`)
+      ...playwright ? { browser: true } : {},
+      warnings: [...[...warned.values()].map((w) => `${w.finding.ruleId} (${w.finding.impact}): ${w.finding.help}, ${w.elements} element${w.elements === 1 ? "" : "s"} on ${w.pages.join(", ")} (${w.finding.helpUrl})`), ...browserWarnings]
     };
     log(`\u2026 accessibility checked on ${pages.length} pages`);
   }
   await rm3(outDir, { recursive: true, force: true });
   await mkdir5(outDir, { recursive: true });
   const report = { outDir, basePath, files: 0, bytes: 0, components: 0, warnings: [], notes: [], ms: 0 };
+  if (opts.browser && !storefront) report.notes.push("--browser checks a storefront's pages in Chromium, and this project has no storefront: nothing was checked");
   const { capture, store } = createSnapshotWriter({ outDir, basePath, origin, report });
   const referenced = (html) => [...html.matchAll(/(?:href|src)="(\/_pd\/(?:components|themes|scripts)\/[^"]+)"/g)].map((m) => m[1].replace(/&amp;/g, "&"));
   try {
@@ -4128,9 +4884,9 @@ ${errors.map((e) => `  - ${e}`).join("\n")}`);
       for (const variant of [void 0, ...base2.variants.map((v) => v.name)]) {
         const detailText = variant ? await capture(componentUrl(id, variant)) : baseText;
         if (detailText) {
-          const { document: document2 } = JSON.parse(detailText);
-          await store(previewUrl(id, variant), document2);
-          for (const ref of referenced(document2)) await capture(ref);
+          const { document: document3 } = JSON.parse(detailText);
+          await store(previewUrl(id, variant), basePath === "/" ? document3 : withNoindex(document3));
+          for (const ref of referenced(document3)) await capture(ref);
         }
         await capture(renderedSourceUrl(id, variant), { optional: true });
         await capture(dataSourceUrl(id, variant), { optional: true });
@@ -4152,13 +4908,13 @@ ${errors.map((e) => `  - ${e}`).join("\n")}`);
     for (const [i, rootDir] of cfg.assetRoots.entries()) {
       const by = shadowed.get(rootDir);
       if (by !== void 0) {
-        report.warnings.push(`assets: ${relative9(root, rootDir)} is hidden by ${relative9(root, by) || "."}, which has the same folder name; left out`);
+        report.warnings.push(`assets: ${relative10(root, rootDir)} is hidden by ${relative10(root, by) || "."}, which has the same folder name; left out`);
         continue;
       }
-      const exists = await stat4(rootDir).then((s) => s.isDirectory(), () => false);
+      const exists = await stat5(rootDir).then((s) => s.isDirectory(), () => false);
       if (!exists) continue;
-      await cp(rootDir, join17(outDir, "assets", cfg.assetRootNames[i]), { recursive: true, filter: notABarrier });
-      if (cfg.assetRoots.length === 1) await cp(rootDir, join17(outDir, "assets"), { recursive: true, force: false, filter: notABarrier });
+      await cp(rootDir, join19(outDir, "assets", cfg.assetRootNames[i]), { recursive: true, filter: notABarrier });
+      if (cfg.assetRoots.length === 1) await cp(rootDir, join19(outDir, "assets"), { recursive: true, force: false, filter: notABarrier });
     }
     const runtime = {
       mode: "static",
@@ -4174,12 +4930,12 @@ ${errors.map((e) => `  - ${e}`).join("\n")}`);
         report.warnings.push(`shell page for route ${route} not written: ${staticPathFor(route)} already holds the server's response to ${holder}`);
       }
     }
-    await writeFile5(join17(outDir, ".nojekyll"), "");
+    await writeFile5(join19(outDir, ".nojekyll"), "");
     report.files++;
-    await writeFile5(join17(outDir, "robots.txt"), workbenchRobotsTxt(basePath));
+    await writeFile5(join19(outDir, "robots.txt"), workbenchRobotsTxt(basePath));
     report.files++;
-    if (basePath !== "/" && sameHostWorkbenchPath(storefront ?? void 0) !== basePath) {
-      report.notes.push(`robots.txt is written to the workbench's root, but crawlers read it only at a host's root: with the base path ${basePath}, add its rule (Disallow: ${basePath}preview/) to the robots.txt the host serves at /`);
+    if (basePath !== "/" && (sameHostWorkbenchPath(storefront ?? void 0) !== basePath || sfBase !== "/")) {
+      report.notes.push(`robots.txt is written to the workbench's root, but crawlers read it only at a host's root: with the base path ${basePath}, each preview carries a robots noindex tag instead; where you can, also add its rule (Disallow: ${basePath}preview/) to the robots.txt the host serves at /`);
     }
     if (storefront && sfGet && sfCrawl) {
       const sfOut = storefront.outDir;
@@ -4192,22 +4948,34 @@ ${errors.map((e) => `  - ${e}`).join("\n")}`);
         throw new Error(`pd build: the storefront changed while it was being written:
 ${sf.failures.map((f) => `  - ${f}`).join("\n")}`);
       }
-      await writeFile5(join17(sfOut, ".nojekyll"), "");
+      await writeFile5(join19(sfOut, ".nojekyll"), "");
       counts.files++;
       const stubs = new Set((await (await sfGet(PD_ROUTES.pages)).json()).pages.flatMap((p) => p.redirectFrom ?? []));
       const pages = sfCrawl.urls.filter((u) => !/^\/(?:_pd|assets|preview)\//.test(u) && !sfFiles.includes(u) && !stubs.has(u)).length;
-      report.storefront = { outDir: sfOut, pages, files: counts.files, bytes: counts.bytes };
+      report.storefront = { outDir: sfOut, basePath: sfBase, pages, files: counts.files, bytes: counts.bytes };
+      if (sfBase !== "/") {
+        const wbPath = sameHostWorkbenchPath(storefront);
+        const rules = storefront.index ? [
+          `Disallow: ${sfBase}preview/`,
+          ...wbPath !== void 0 ? [`Disallow: ${wbPath}preview/`] : [],
+          ...storefront.url !== void 0 ? [`Sitemap: ${storefront.url}sitemap.xml`] : []
+        ] : [`Disallow: ${sfBase}`];
+        report.notes.push(`robots.txt is not written: the site is published under ${sfBase}, and crawlers read robots.txt only at a host's root. Where you can, add to the host's own robots.txt: ${rules.join("; ")}`);
+      }
       if (storefront.url === void 0) {
         report.notes.push(`storefront.url is not set, so pages have no canonical URL, og:url, og:image or JSON-LD, and there is no sitemap: set storefront.url to the site's address, such as "https://example.com/"`);
       }
       report.notes.push(...storefrontNotes, ...externalNotes);
       if (linkSummary) report.links = linkSummary;
       if (a11ySummary) report.accessibility = a11ySummary;
+      if (imageSummary) report.images = imageSummary;
+      const drafts = (await readPages(storefront.pagesDir, { drafts: "leave-out" })).drafts;
+      if (drafts.length) report.drafts = drafts;
       log(`\u2026 storefront: ${pages} pages, ${counts.files} files`);
     }
     const used = /* @__PURE__ */ new Set();
     for (const root2 of [outDir, ...storefront ? [storefront.outDir] : []]) {
-      const files = await readdir7(join17(root2, "_pd", "images"), { recursive: true }).catch(() => []);
+      const files = await readdir8(join19(root2, "_pd", "images"), { recursive: true }).catch(() => []);
       for (const f of files) {
         const m = /\.([0-9a-f]{10})\.[1-9][0-9]*\.webp$/.exec(String(f));
         if (m) used.add(m[1]);
@@ -4222,19 +4990,19 @@ ${sf.failures.map((f) => `  - ${f}`).join("\n")}`);
 }
 
 // packages/dev-server/src/requires.ts
-import { readFile as readFile11 } from "node:fs/promises";
+import { readFile as readFile12 } from "node:fs/promises";
 import { existsSync as existsSync4 } from "node:fs";
-import { basename as basename5, join as join18, relative as relative10 } from "node:path";
+import { basename as basename5, join as join20, relative as relative11 } from "node:path";
 function normalizeScriptId(raw) {
   let s = raw.trim().replace(/^\[(.+)\]$/, "$1").trim();
   s = basename5(s);
   s = s.replace(/\.(ts|js)$/, "");
   return s;
 }
-function parseFrontmatterList(md, key) {
+function parseFrontmatterList(md2, key) {
   const values = [];
   const re = new RegExp(`^${key}:\\s*(.+)$`, "mg");
-  for (const [, val] of md.matchAll(re)) {
+  for (const [, val] of md2.matchAll(re)) {
     values.push(val.trim());
   }
   return values;
@@ -4247,9 +5015,9 @@ async function aggregateRequires(componentId, patternsDir, flatNameToPath, disco
   let ownAssets = [];
   if (entry?.mdPath) {
     try {
-      const md = await readFile11(entry.mdPath, "utf-8");
-      ownScripts = parseFrontmatterList(md, "requireScript").map(normalizeScriptId);
-      ownAssets = parseFrontmatterList(md, "requireAssets").map((v) => v.trim().replace(/^\[(.+)\]$/, "$1").trim());
+      const md2 = await readFile12(entry.mdPath, "utf-8");
+      ownScripts = parseFrontmatterList(md2, "requireScript").map(normalizeScriptId);
+      ownAssets = parseFrontmatterList(md2, "requireAssets").map((v) => v.trim().replace(/^\[(.+)\]$/, "$1").trim());
     } catch {
     }
   }
@@ -4258,7 +5026,7 @@ async function aggregateRequires(componentId, patternsDir, flatNameToPath, disco
   const hbsPath = entry?.hbsPath ?? "";
   let hbs = "";
   try {
-    hbs = hbsPath ? await readFile11(hbsPath, "utf-8") : "";
+    hbs = hbsPath ? await readFile12(hbsPath, "utf-8") : "";
   } catch {
   }
   for (const flatName of parsePartialsFromHbs(hbs)) {
@@ -4279,7 +5047,7 @@ async function loadSvgAssets(ids, assetsDir) {
   for (const id of ids) {
     for (const candidate of [`${id}.svg`, `images/${id}.svg`]) {
       try {
-        const raw = await readFile11(join18(assetsDir, candidate), "utf-8");
+        const raw = await readFile12(join20(assetsDir, candidate), "utf-8");
         contents.push(hideSvg(raw));
         break;
       } catch {
@@ -4292,21 +5060,21 @@ function hideSvg(svg) {
   return svg.replace(/<svg(\s|>)/, '<svg$1style="display:none;position:absolute" aria-hidden="true" ');
 }
 async function reportUnresolvableScripts(discoveryMap, scriptsDirs, globalScripts, cwd) {
-  const resolves = (id) => scriptsDirs.some((d) => existsSync4(join18(d, `${id}.ts`)));
-  const where = scriptsDirs.length ? scriptsDirs.map((d) => relative10(cwd, d) || d).join(" or ") : "no scriptsDir configured";
+  const resolves = (id) => scriptsDirs.some((d) => existsSync4(join20(d, `${id}.ts`)));
+  const where = scriptsDirs.length ? scriptsDirs.map((d) => relative11(cwd, d) || d).join(" or ") : "no scriptsDir configured";
   for (const id of globalScripts) {
     if (id.includes("://") || resolves(normalizeScriptId(id))) continue;
     console.warn(`[dev-server] globalScripts "${id}": no ${normalizeScriptId(id)}.ts in ${where}`);
   }
   for (const [componentId, entry] of discoveryMap) {
     if (!entry.mdPath) continue;
-    let md;
+    let md2;
     try {
-      md = await readFile11(entry.mdPath, "utf-8");
+      md2 = await readFile12(entry.mdPath, "utf-8");
     } catch {
       continue;
     }
-    for (const raw of parseFrontmatterList(md, "requireScript")) {
+    for (const raw of parseFrontmatterList(md2, "requireScript")) {
       const id = normalizeScriptId(raw);
       if (resolves(id)) continue;
       console.warn(`[dev-server] requireScript "${raw}" on ${componentId}: no ${id}.ts in ${where}`);
@@ -4423,6 +5191,7 @@ function createServerState() {
     baseProvenance: null,
     perComponentCss: /* @__PURE__ */ new Map(),
     baseCss: "",
+    entryBaseRules: /* @__PURE__ */ new Map(),
     baseCssVersion: 0,
     discovery: createLazy("discovery", { slow: { afterMs: DISCOVERY_SLOW_MS, what: "the component index" } }),
     audit: createLazy("audit"),
@@ -4453,6 +5222,7 @@ function applyStyleData(state, data) {
   state.baseProvenance = data.baseProvenance;
   state.perComponentCss = data.componentCssMap;
   state.baseCss = data.baseCss;
+  state.entryBaseRules = new Map(data.baseRulesByEntry);
   return { changedComponents: changedComponents.sort(), baseChanged };
 }
 function scriptFor(state, scriptId) {
@@ -4498,24 +5268,24 @@ function cachedDiscovery(state) {
 }
 
 // packages/dev-server/src/routes.ts
-import { basename as basename9, extname as extname2, join as join24, relative as relative12 } from "node:path";
+import { basename as basename9, extname as extname2, join as join25, relative as relative12 } from "node:path";
 import { readFile as readFile24 } from "node:fs/promises";
 
 // packages/dev-server/src/component-tree.ts
-import { readFile as readFile14 } from "node:fs/promises";
-import { join as join21 } from "node:path";
+import { readFile as readFile15 } from "node:fs/promises";
+import { join as join23 } from "node:path";
 
 // packages/dev-server/src/layout-mode.ts
-import { readFile as readFile13 } from "node:fs/promises";
-import { join as join20 } from "node:path";
+import { readFile as readFile14 } from "node:fs/promises";
+import { join as join22 } from "node:path";
 
 // packages/dev-server/src/pattern-dirs.ts
-import { readFile as readFile12 } from "node:fs/promises";
-import { join as join19 } from "node:path";
+import { readFile as readFile13 } from "node:fs/promises";
+import { join as join21 } from "node:path";
 async function readFolderFile(dirs, rel) {
   for (const dir of typeof dirs === "string" ? [dirs] : dirs) {
     try {
-      return await readFile12(join19(dir, rel), "utf-8");
+      return await readFile13(join21(dir, rel), "utf-8");
     } catch {
     }
   }
@@ -4528,7 +5298,7 @@ async function resolveLayoutMode(componentId, patternsDir, discoveryMap) {
   const parts = componentId.split("/");
   const category = parts[0];
   let layout = FULL_CATEGORIES.has(stripOrderPrefixes(category)) ? "full" : "centered";
-  const categoryIndex = await readFolderFile(patternsDir, join20(category, "index.md"));
+  const categoryIndex = await readFolderFile(patternsDir, join22(category, "index.md"));
   if (categoryIndex !== null) {
     const m = categoryIndex.match(/^preview:\s*(centered|full)$/m);
     if (m) layout = m[1];
@@ -4536,8 +5306,8 @@ async function resolveLayoutMode(componentId, patternsDir, discoveryMap) {
   const mdPath = discoveryMap?.get(componentId)?.mdPath;
   if (mdPath) {
     try {
-      const md = await readFile13(mdPath, "utf-8");
-      const m = md.match(/^preview:\s*(centered|full)$/m);
+      const md2 = await readFile14(mdPath, "utf-8");
+      const m = md2.match(/^preview:\s*(centered|full)$/m);
       if (m) layout = m[1];
     } catch {
     }
@@ -4545,130 +5315,6 @@ async function resolveLayoutMode(componentId, patternsDir, discoveryMap) {
   return layout;
 }
 
-// packages/dev-server/src/frontmatter.ts
-var BOM = "\uFEFF";
-var unquote = (s) => {
-  const t = s.trim();
-  return t.length >= 2 && (t[0] === '"' || t[0] === "'") && t.at(-1) === t[0] ? t.slice(1, -1) : t;
-};
-var unterminatedQuote = (s) => {
-  const t = s.trim();
-  return (t[0] === '"' || t[0] === "'") && (t.length < 2 || t.at(-1) !== t[0]);
-};
-function block(md) {
-  const text = md.startsWith(BOM) ? md.slice(1) : md;
-  const lines = text.split(/\r?\n/);
-  if (lines[0]?.trim() !== "---") return { text, lines, end: null };
-  return { text, lines, end: lines.findIndex((l, i) => i > 0 && l.trim() === "---") };
-}
-function scan(md) {
-  const errors = [];
-  const err = (line, message) => {
-    errors.push({ line, message });
-  };
-  const { text, lines, end: blockEnd } = block(md);
-  if (blockEnd === null) {
-    if (/^---\r(?!\n)/.test(text)) err(1, "lines end in a bare CR \u2014 use LF or CRLF line endings");
-    return { values: {}, errors, lines: {} };
-  }
-  const end = blockEnd;
-  if (end < 0) {
-    err(1, "the frontmatter block opened here is never closed \u2014 end it with a line holding only ---");
-    return { values: {}, errors, lines: {} };
-  }
-  const out = {};
-  const keyLines = {};
-  let listKey = null;
-  for (let i = 1; i < end; i++) {
-    const line = lines[i];
-    const n = i + 1;
-    const bareCr = line.includes("\r");
-    if (bareCr) err(n, "line ends in a bare CR \u2014 use LF or CRLF line endings");
-    const lineErr = (message) => {
-      if (!bareCr) err(n, message);
-    };
-    const item = line.match(/^\s*-\s+(.*)$/);
-    if (item && listKey) {
-      if (unterminatedQuote(item[1])) lineErr(`list item ${item[1].trim()} has an opening quote with no closing one`);
-      out[listKey].push(unquote(item[1]));
-      continue;
-    }
-    const kv = line.match(/^([A-Za-z_][\w-]*):\s*(.*)$/);
-    if (!kv) {
-      if (line.trim() !== "") {
-        if (item) lineErr("list item with no key above it \u2014 a list follows a line `key:`");
-        else if (/^\s+[A-Za-z_][\w-]*:/.test(line)) lineErr("nested value \u2014 only top-level keys are supported, written at the start of the line");
-        else lineErr(`cannot read this line: ${line.trim()}`);
-      }
-      listKey = null;
-      continue;
-    }
-    const [, key, raw] = kv;
-    if (key in out) lineErr(`duplicate key "${key}"`);
-    keyLines[key] = n;
-    const value = raw.trim();
-    if (value === "") {
-      out[key] = [];
-      listKey = key;
-    } else if (value.startsWith("[") && value.endsWith("]")) {
-      const items = value.slice(1, -1).split(",");
-      for (const it of items) if (unterminatedQuote(it)) lineErr(`list item ${it.trim()} has an opening quote with no closing one`);
-      out[key] = items.map(unquote).filter(Boolean);
-      listKey = null;
-    } else {
-      if (value.startsWith("[")) lineErr(`"${key}": the list opened with [ is never closed with ]`);
-      else if (unterminatedQuote(value)) lineErr(`"${key}": the value has an opening quote with no closing one`);
-      out[key] = unquote(value);
-      listKey = null;
-    }
-  }
-  return { values: out, errors, lines: keyLines };
-}
-function readFrontmatter(md) {
-  return scan(md).values;
-}
-function readFrontmatterStrict(md) {
-  return scan(md);
-}
-function frontmatterBodyOffset(md) {
-  const { end } = block(md);
-  return end === null || end < 0 ? 0 : end + 1;
-}
-function frontmatterBody(md) {
-  const { text, lines, end } = block(md);
-  if (end === null) return text;
-  if (end < 0) return "";
-  return lines.slice(end + 1).join("\n");
-}
-
-// packages/dev-server/src/tree-order.ts
-function parseOrder(value) {
-  if (value === void 0) return void 0;
-  if (Array.isArray(value)) return { list: value };
-  if (/^-?\d+(\.\d+)?$/.test(value)) return { weight: Number(value) };
-  const list = value.split(",").map((s) => s.trim()).filter(Boolean);
-  return list.length ? { list } : void 0;
-}
-var collator = new Intl.Collator("en", { numeric: true });
-var REST = "...";
-function orderSiblings(items, list) {
-  const position = /* @__PURE__ */ new Map();
-  list?.forEach((name, i) => {
-    if (!position.has(name)) position.set(name, i);
-  });
-  const restPosition = position.get(REST) ?? Infinity;
-  const positionOf2 = (item) => list ? position.get(item.segment) ?? restPosition : 0;
-  return [...items].sort((a, b) => {
-    const ra = a.weight ?? 0;
-    const rb = b.weight ?? 0;
-    if (ra !== rb) return ra - rb;
-    const pa = positionOf2(a);
-    const pb = positionOf2(b);
-    if (pa !== pb) return pa - pb;
-    return collator.compare(a.segment, b.segment) || (a.segment < b.segment ? -1 : a.segment > b.segment ? 1 : 0);
-  });
-}
-
 // packages/dev-server/src/component-tree.ts
 function directChildPaths(parentPath, allIds) {
   const prefix = `${parentPath}/`;
@@ -4686,9 +5332,9 @@ function folderTitle(segment) {
   const text = words.join(" ");
   return text.charAt(0).toUpperCase() + text.slice(1);
 }
-var readText = (path) => readFile14(path, "utf-8").catch(() => null);
-function orderOf(md) {
-  return md === null ? void 0 : parseOrder(readFrontmatter(md)["order"]);
+var readText = (path) => readFile15(path, "utf-8").catch(() => null);
+function orderOf(md2) {
+  return md2 === null ? void 0 : parseOrder(readFrontmatter(md2)["order"]);
 }
 function hasPublicComponent(node) {
   if (node.kind === "component" && node.visibility !== "private") return true;
@@ -4722,22 +5368,22 @@ async function buildTreeNodeFromMap(nodePath, idsUnderPath, patternsDir, overvie
   let visibility;
   let weight;
   if (isComponent && entry.mdPath) {
-    const md = await readText(entry.mdPath);
-    if (md !== null) {
-      const t = md.match(/^title:\s*(.+)$/m);
-      const s = md.match(/^status:\s*(.+)$/m);
-      const v = md.match(/^visibility:\s*(public|private)$/m);
+    const md2 = await readText(entry.mdPath);
+    if (md2 !== null) {
+      const t = md2.match(/^title:\s*(.+)$/m);
+      const s = md2.match(/^status:\s*(.+)$/m);
+      const v = md2.match(/^visibility:\s*(public|private)$/m);
       if (t) title = t[1].trim();
       if (s) {
         const sv = s[1].trim();
         if (sv === "stable" || sv === "deprecated" || sv === "draft") status = sv;
       }
       if (v) visibility = v[1];
-      const o = orderOf(md);
+      const o = orderOf(md2);
       if (o && "weight" in o) weight = o.weight;
     }
   }
-  const indexMd = await readFolderFile(patternsDir, join21(nodePath, "index.md"));
+  const indexMd = await readFolderFile(patternsDir, join23(nodePath, "index.md"));
   const folderOrder = orderOf(indexMd);
   const built = [];
   for (const childPath of directChildPaths(nodePath, idsUnderPath)) {
@@ -4787,10 +5433,10 @@ import { readFile as readFile21 } from "node:fs/promises";
 // packages/dev-server/src/markdown.ts
 import { readFile as readFile19 } from "node:fs/promises";
 import { basename as basename8 } from "node:path";
-import MarkdownIt3 from "markdown-it";
+import MarkdownIt4 from "markdown-it";
 
 // packages/dev-server/src/placed-tags.ts
-import MarkdownIt from "markdown-it";
+import MarkdownIt2 from "markdown-it";
 var OPEN = /^<(pd-[a-z0-9-]+(?:~[a-z0-9-]+)?)/;
 var CLOSE = /^<\/(pd-[a-z0-9-~]+)\s*>/;
 var ATTR = /^\s+([a-zA-Z_:][-a-zA-Z0-9_:.]*)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'=<>`]+)))?/;
@@ -4874,9 +5520,9 @@ function placedTagRule(state, startLine, endLine, silent) {
   state.line = Math.min(line + 1, endLine);
   return true;
 }
-function usePlacedTags(md) {
-  md.block.ruler.before("paragraph", "pd_component", placedTagRule, { alt: ["paragraph", "blockquote", "list"] });
-  return md;
+function usePlacedTags(md2) {
+  md2.block.ruler.before("paragraph", "pd_component", placedTagRule, { alt: ["paragraph", "blockquote", "list"] });
+  return md2;
 }
 var camel = (s) => s.replace(/-([a-z0-9])/g, (_, c3) => c3.toUpperCase());
 function dedent(s) {
@@ -4942,10 +5588,10 @@ async function toPlaced(tag, resolver, problems) {
 // packages/dev-server/src/storefront/placed.ts
 import { readFile as readFile18 } from "node:fs/promises";
 import { basename as basename7 } from "node:path";
-import MarkdownIt2 from "markdown-it";
+import MarkdownIt3 from "markdown-it";
 
 // packages/dev-server/src/storefront/declared-values.ts
-import { readFile as readFile15 } from "node:fs/promises";
+import { readFile as readFile16 } from "node:fs/promises";
 var NUMERIC = /^-?\d+(\.\d+)?$/;
 var quote = (v) => Array.isArray(v) ? `[${v.join(", ")}]` : `"${v}"`;
 var describe = (v, mode) => mode === "frontmatter" ? quote(v) : JSON.stringify(v);
@@ -5039,7 +5685,7 @@ function jsonValue(prop, value, path, owner, problems) {
 async function readSchema(schemaPath) {
   if (!schemaPath) return {};
   try {
-    return { schema: JSON.parse(await readFile15(schemaPath, "utf8")) };
+    return { schema: JSON.parse(await readFile16(schemaPath, "utf8")) };
   } catch (e) {
     return { error: e instanceof Error ? e.message : String(e) };
   }
@@ -5130,209 +5776,12 @@ async function placedValue(prop, node, where, ctx, problems) {
 import { readFile as readFile17 } from "node:fs/promises";
 import { basename as basename6 } from "node:path";
 
-// packages/dev-server/src/storefront/pages.ts
-import { readdir as readdir8, readFile as readFile16, stat as stat5 } from "node:fs/promises";
-import { join as join22, relative as relative11, sep as sep7 } from "node:path";
-
-// packages/dev-server/src/storefront/redirects.ts
-function redirectsOf(f) {
-  const v = f.frontmatter.values["redirectFrom"];
-  return Array.isArray(v) ? v : typeof v === "string" ? [v] : [];
-}
-var RESERVED = [PD_ROUTE_PREFIX.preview, "/_pd/", PD_ROUTE_PREFIX.assets, "/api/", PD_ROUTE_PREFIX.source];
-function redirectProblems(files, workbenchPath) {
-  const problems = [];
-  const claimed = /* @__PURE__ */ new Map();
-  for (const f of files.values()) {
-    const at = `${f.path}${f.frontmatter.lines["redirectFrom"] !== void 0 ? `:${f.frontmatter.lines["redirectFrom"]}` : ""}`;
-    for (const old of redirectsOf(f)) {
-      if (typeof old !== "string" || !old.startsWith("/") || !old.endsWith("/")) continue;
-      const page = files.get(old);
-      if (page) {
-        problems.push(`${at}: redirectFrom "${old}" is the page ${page.path}: a route can't both be a page and forward to one`);
-        continue;
-      }
-      const reserved = RESERVED.find((r) => old.startsWith(r));
-      if (reserved) {
-        problems.push(`${at}: redirectFrom "${old}" is under ${reserved}, which Pattern Dump serves itself`);
-        continue;
-      }
-      if (workbenchPath !== void 0 && old.startsWith(workbenchPath)) {
-        problems.push(`${at}: redirectFrom "${old}" is ${workbenchPlace(old, workbenchPath)}`);
-        continue;
-      }
-      const other = claimed.get(old);
-      if (other && other !== f) {
-        problems.push(`${at}: redirectFrom "${old}" is also claimed by ${other.path}: one old route forwards to one page`);
-        continue;
-      }
-      claimed.set(old, f);
-    }
-  }
-  return problems;
-}
-function workbenchPlace(route, workbenchPath) {
-  return `${route === workbenchPath ? "at" : "under"} ${workbenchPath}, where the workbench is published on this host (storefront.workbenchUrl), so the workbench would overwrite it there`;
-}
-function redirectStub(p) {
-  const target = escapeAttr(p.route);
-  const canonical2 = p.siteUrl !== void 0 ? `
-<link rel="canonical" href="${escapeAttr(new URL(p.route.slice(1), p.siteUrl).href)}">` : "";
-  return `<!DOCTYPE html>
-<html lang="${escapeAttr(p.lang)}">
-<head>
-<meta charset="UTF-8">
-<title>Moved to ${escapeHtml(p.title)}</title>${canonical2}
-<meta name="robots" content="noindex">
-<meta http-equiv="refresh" content="0; url=${target}">
-</head>
-<body>
-<p>This page has moved to <a href="${target}">${escapeHtml(p.title)}</a>.</p>
-</body>
-</html>
-`;
-}
-
-// packages/dev-server/src/storefront/pages.ts
-var DEFAULT_LAYOUT = "page";
-var NOT_FOUND_FILE = "404.md";
-function routeFor(path) {
-  const parts = path.replace(/\.md$/, "").split("/");
-  if (parts.at(-1) === "index") parts.pop();
-  return parts.length ? `/${parts.join("/")}/` : "/";
-}
-var NAME = /^[a-z0-9-]+$/;
-async function markdownFiles(dir, root, problems) {
-  const out = [];
-  const entries = (await readdir8(dir, { withFileTypes: true }).catch(() => [])).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
-  for (const e of entries) {
-    if (e.name.startsWith(".")) continue;
-    const p = join22(dir, e.name);
-    const rel = relative11(root, p).split(sep7).join("/");
-    if (e.isDirectory()) {
-      if (!NAME.test(e.name)) {
-        problems.push(`${rel}/: a folder name is part of the URL, so it is lowercase letters, digits and hyphens only`);
-        continue;
-      }
-      out.push(...await markdownFiles(p, root, problems));
-    } else if (!e.name.endsWith(".md")) {
-      problems.push(`${rel} is not a page: only .md files belong in the pages folder (images and other files go in the project's assets)`);
-    } else if (!NAME.test(e.name.slice(0, -".md".length))) {
-      problems.push(`${rel}: a page's file name is part of the URL, so it is lowercase letters, digits and hyphens only, then .md`);
-    } else {
-      out.push(rel);
-    }
-  }
-  return out;
-}
-var scalar = (v) => typeof v === "string" ? v : void 0;
-async function readPages(pagesDir, opts = {}) {
-  const problems = [];
-  const files = /* @__PURE__ */ new Map();
-  let notFound;
-  if (!await stat5(pagesDir).then((s) => s.isDirectory(), () => false)) {
-    return { pages: [], nav: [], files, problems: [`the pages folder ${pagesDir} does not exist`] };
-  }
-  for (const path of (await markdownFiles(pagesDir, pagesDir, problems)).sort()) {
-    const route = routeFor(path);
-    const other = files.get(route);
-    if (other) {
-      problems.push(`${other.path} and ${path} are both the page at ${route}`);
-      continue;
-    }
-    const file = join22(pagesDir, ...path.split("/"));
-    const text = await readFile16(file, "utf8").catch((e) => {
-      if (e.code === "ENOENT") return null;
-      throw e;
-    });
-    if (text === null) continue;
-    if (path === NOT_FOUND_FILE) {
-      notFound = { route: PD_ROUTES.notFound, file, path, frontmatter: readFrontmatterStrict(text) };
-      continue;
-    }
-    files.set(route, { route, file, path, frontmatter: readFrontmatterStrict(text) });
-  }
-  const pageOf = (f) => {
-    const redirectFrom = redirectsOf(f);
-    return {
-      route: f.route,
-      title: scalar(f.frontmatter.values["title"]) ?? f.route,
-      layout: scalar(f.frontmatter.values["layout"]) ?? DEFAULT_LAYOUT,
-      ...redirectFrom.length ? { redirectFrom } : {}
-    };
-  };
-  const entryOf = (f) => {
-    const description = scalar(f.frontmatter.values["description"]);
-    return { route: f.route, title: pageOf(f).title, ...description !== void 0 ? { description } : {} };
-  };
-  const weightOf = (f) => {
-    const o = parseOrder(f?.frontmatter.values["order"]);
-    return o && "weight" in o ? o.weight : void 0;
-  };
-  const listOf = (f) => {
-    const o = parseOrder(f?.frontmatter.values["order"]);
-    return o && "list" in o ? o.list : void 0;
-  };
-  const folders = /* @__PURE__ */ new Set();
-  for (const f of files.values()) {
-    const parts = f.path.split("/").slice(0, -1);
-    for (let i = 1; i <= parts.length; i++) folders.add(`/${parts.slice(0, i).join("/")}/`);
-  }
-  if (!files.has("/")) problems.push("there is no home page: the pages folder needs an index.md at its top, the page at /");
-  for (const folder of [...folders].sort()) {
-    if (!files.has(folder)) problems.push(`the folder ${folder.slice(1)} holds pages but has no index.md \u2014 it needs one, as the folder's own page`);
-  }
-  const childrenOf = (folder) => {
-    const depth = folder === "/" ? 0 : folder.split("/").length - 2;
-    const out = /* @__PURE__ */ new Map();
-    for (const route of [...files.keys(), ...folders]) {
-      if (route === folder || !route.startsWith(folder)) continue;
-      const segs = route.split("/").filter(Boolean);
-      if (segs.length !== depth + 1) continue;
-      out.set(route, segs[depth]);
-    }
-    return [...out].map(([route, segment]) => ({ route, segment }));
-  };
-  const ordered = (folder, extra = []) => {
-    const items = childrenOf(folder).map((c3) => {
-      const w = weightOf(files.get(c3.route));
-      return { route: c3.route, segment: c3.segment, ...w !== void 0 ? { weight: w } : {} };
-    });
-    return orderSiblings([...extra, ...items], listOf(files.get(folder)));
-  };
-  const home = files.get("/");
-  const homeWeight = weightOf(home);
-  const top = ordered("/", home ? [{ route: "/", segment: "index", ...homeWeight !== void 0 ? { weight: homeWeight } : {} }] : []);
-  const nav = [];
-  for (const item of top) {
-    const page = files.get(item.route);
-    if (!page) continue;
-    const children = folders.has(item.route) && item.route !== "/" ? ordered(item.route).flatMap((c3) => {
-      const p = files.get(c3.route);
-      return p ? [entryOf(p)] : [];
-    }) : [];
-    nav.push({ ...entryOf(page), ...children.length ? { children } : {} });
-  }
-  const inNav = nav.flatMap((n) => [n.route, ...(n.children ?? []).map((c3) => c3.route)]);
-  const rest = [...files.keys()].filter((r) => !inNav.includes(r)).sort();
-  const routes = [...inNav, ...rest];
-  const pages = routes.map((r) => pageOf(files.get(r)));
-  const { workbenchPath } = opts;
-  if (workbenchPath !== void 0) {
-    for (const f of files.values()) {
-      if (f.route.startsWith(workbenchPath)) problems.push(`${f.path}: the page ${f.route} is ${workbenchPlace(f.route, workbenchPath)}`);
-    }
-  }
-  problems.push(...redirectProblems(files, workbenchPath));
-  return { pages, nav, files: new Map(routes.map((r) => [r, files.get(r)])), problems, ...notFound ? { notFound } : {} };
-}
-
 // packages/dev-server/src/storefront/frontmatter-contract.ts
-var RESERVED_KEYS = ["layout", "order", "redirectFrom", "index", "image"];
+var RESERVED_KEYS = ["layout", "order", "redirectFrom", "index", "image", "date", "tags", "draft", "sort"];
 var ASSEMBLY_KEYS = ["body", "nav", "site", "page"];
 var OLD_ROUTE = /^\/(?:(?!\.\.?\/)[^/?#\s]+\/)+$/;
 var ASSET_PATH = /^\/assets\/[^?#]+[^/?#]$/;
-function checkBuildKeys(values, at) {
+function checkBuildKeys(values, path, at) {
   const out = {};
   const redirect = values["redirectFrom"];
   if (redirect !== void 0) {
@@ -5352,6 +5801,16 @@ function checkBuildKeys(values, at) {
     if (typeof image === "string" && ASSET_PATH.test(image)) out.image = image;
     else at("image", `image must be a path to a file in the assets, such as "/assets/images/share.png"`);
   }
+  const take = (key, r) => {
+    if (r === void 0) return;
+    if (r.ok) out[key] = r.value;
+    else at(key, r.message);
+  };
+  const v = (key) => values[key];
+  take("date", v("date") === void 0 ? void 0 : readDate(v("date")));
+  take("tags", v("tags") === void 0 ? void 0 : readTags(v("tags")));
+  take("draft", v("draft") === void 0 ? void 0 : readDraft(v("draft")));
+  take("sort", v("sort") === void 0 ? void 0 : readSort(v("sort"), path));
   return out;
 }
 function layoutNames(discoveryMap) {
@@ -5374,12 +5833,12 @@ async function checkPageFrontmatter(page, discoveryMap) {
     if (!Array.isArray(rawLayout)) {
       at("layout", known.length ? `layout "${layout}" is not a layout \u2014 the layouts are ${known.map((n) => `"${n}"`).join(", ")}` : `layout "${layout}" is not a layout \u2014 the project has no layouts (components in a layouts/ folder of its patterns)`);
     }
-    return { layoutId, values: {}, build: checkBuildKeys(values, at), problems };
+    return { layoutId, values: {}, build: checkBuildKeys(values, page.path, at), problems };
   }
   const read = await readSchema(entry.schemaPath);
   if (read.error !== void 0) {
     problems.push({ file: page.path, message: `the schema of layout "${layout}" cannot be read: ${read.error}` });
-    return { layoutId, values: {}, build: checkBuildKeys(values, at), problems };
+    return { layoutId, values: {}, build: checkBuildKeys(values, page.path, at), problems };
   }
   const schema = read.schema ?? {};
   const hasSchema = read.schema !== void 0;
@@ -5389,7 +5848,7 @@ async function checkPageFrontmatter(page, discoveryMap) {
       problems.push({ file: page.path, message: `layout "${layout}" declares "${key}", which a page sets for the build, not for its layout: rename it in the layout's schema` });
     }
   }
-  const build = checkBuildKeys(values, at);
+  const build = checkBuildKeys(values, page.path, at);
   const out = {};
   for (const [key, value] of Object.entries(values)) {
     if (RESERVED_KEYS.includes(key)) continue;
@@ -5420,6 +5879,9 @@ async function checkPageFrontmatter(page, discoveryMap) {
 
 // packages/dev-server/src/storefront/derived.ts
 var LINK = { fields: { route: "value", title: "value" } };
+var ENTRY = {
+  fields: { route: "value", title: "value", description: "value", date: "value", image: "value", tags: "value", draft: "value" }
+};
 var PAGE_SHAPE = {
   fields: {
     headings: { items: { fields: { level: "value", text: "value", anchor: "value" } } },
@@ -5428,10 +5890,13 @@ var PAGE_SHAPE = {
     prev: LINK,
     next: LINK,
     created: "value",
-    modified: "value"
+    modified: "value",
+    children: { items: ENTRY },
+    date: "value",
+    tags: "value"
   }
 };
-var FILLED = ["headings", "section", "breadcrumbs", "prev", "next", "created", "modified"];
+var FILLED = ["headings", "section", "breadcrumbs", "prev", "next", "created", "modified", "children", "date", "tags"];
 function positionOf(route, site) {
   const titles = new Map(site.pages.map((p) => [p.route, p.title]));
   const link = (r) => titles.has(r) ? { route: r, title: titles.get(r) } : null;
@@ -5479,7 +5944,7 @@ var NAVIGATIONS_KEY = "navigations";
 var AT = "storefront.site.navigations";
 var KEYS = ["page", "href", "label", "children"];
 var isObject5 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
-var show = (v) => typeof v === "string" ? `"${v}"` : JSON.stringify(v) ?? String(v);
+var show2 = (v) => typeof v === "string" ? `"${v}"` : JSON.stringify(v) ?? String(v);
 var isAllowedHref = (href) => /^(https?:\/\/|mailto:)/i.test(href) || /^\/(?!\/)/.test(href);
 function listedNavigations(declared, owner) {
   if (!declared) return { listed: [], problems: [] };
@@ -5502,7 +5967,7 @@ function checkNavigations(value, declared, owner, pagePaths) {
   const problems = [...names.problems];
   const navigations = {};
   if (value !== void 0 && !isObject5(value)) {
-    problems.push(`${AT} must be an object of named navigations, such as { footer: [{ page: "about.md" }] } (got ${show(value)})`);
+    problems.push(`${AT} must be an object of named navigations, such as { footer: [{ page: "about.md" }] } (got ${show2(value)})`);
     return { navigations, listed: names.listed, problems };
   }
   const given = value ?? {};
@@ -5513,7 +5978,7 @@ function checkNavigations(value, declared, owner, pagePaths) {
       continue;
     }
     if (!Array.isArray(entries)) {
-      problems.push(`${AT}.${name} must be a list of entries (got ${show(entries)})`);
+      problems.push(`${AT}.${name} must be a list of entries (got ${show2(entries)})`);
       continue;
     }
     problems.push(...checkEntries(entries, `${AT}.${name}`, pagePaths));
@@ -5529,7 +5994,7 @@ function checkEntries(entries, at, pagePaths) {
 }
 function checkEntry(entry, at, pagePaths) {
   const FORMS = `{ page }, { href, label } or { label, children }`;
-  if (!isObject5(entry)) return [`${at} must be an entry, one of ${FORMS} (got ${show(entry)})`];
+  if (!isObject5(entry)) return [`${at} must be an entry, one of ${FORMS} (got ${show2(entry)})`];
   const problems = [];
   for (const key of Object.keys(entry)) {
     if (KEYS.includes(key)) continue;
@@ -5542,11 +6007,11 @@ function checkEntry(entry, at, pagePaths) {
     return problems;
   }
   const label = entry["label"];
-  if (label !== void 0 && typeof label !== "string") problems.push(`${at}.label must be text (got ${show(label)})`);
+  if (label !== void 0 && typeof label !== "string") problems.push(`${at}.label must be text (got ${show2(label)})`);
   const form = forms[0];
   if (form === "page") {
     const page = entry["page"];
-    if (typeof page !== "string") problems.push(`${at}.page must be the path of a page in the pages folder, such as "about.md" (got ${show(page)})`);
+    if (typeof page !== "string") problems.push(`${at}.page must be the path of a page in the pages folder, such as "about.md" (got ${show2(page)})`);
     else if (!pagePaths.has(page)) {
       const near = suggest(page, [...pagePaths]);
       problems.push(`${at}: "${page}" is not a page in the pages folder${near ? ` \u2014 did you mean "${near}"?` : ""}`);
@@ -5555,11 +6020,11 @@ function checkEntry(entry, at, pagePaths) {
     if (label === void 0) problems.push(`${at} needs a "label"`);
     if (form === "href") {
       const href = entry["href"];
-      if (typeof href !== "string") problems.push(`${at}.href must be text (got ${show(href)})`);
-      else if (!isAllowedHref(href)) problems.push(`${at}.href ${show(href)} must start with https:, http: or mailto:, or be a path from the site's root (/\u2026)`);
+      if (typeof href !== "string") problems.push(`${at}.href must be text (got ${show2(href)})`);
+      else if (!isAllowedHref(href)) problems.push(`${at}.href ${show2(href)} must start with https:, http: or mailto:, or be a path from the site's root (/\u2026)`);
     } else {
       const children = entry["children"];
-      if (!Array.isArray(children)) problems.push(`${at}.children must be a list of entries (got ${show(children)})`);
+      if (!Array.isArray(children)) problems.push(`${at}.children must be a list of entries (got ${show2(children)})`);
       else problems.push(...checkEntries(children, `${at}.children`, pagePaths));
     }
   }
@@ -5580,10 +6045,86 @@ function resolveNavigations(navigations, listed, model, route) {
   return Object.fromEntries(listed.map((name) => [name, Object.hasOwn(navigations, name) ? resolve15(navigations[name]) : null]));
 }
 
+// packages/dev-server/src/storefront/collections.ts
+async function dateOf(route, model, dates, mode) {
+  const own = model.entries.get(route)?.date ?? null;
+  const file = model.files.get(route);
+  if (own !== null || !dates || !file) return { date: own, problems: [], notes: [] };
+  const dated = await dates.of(file.path, mode);
+  return { date: dated.shallow && mode === "build" ? null : dated.dates.created?.slice(0, 10) ?? null, problems: dated.problems, notes: dated.notes };
+}
+async function entriesOf(folder, model, o) {
+  const listing = model.folders.get(folder);
+  if (!listing) return { entries: [], problems: [], notes: [] };
+  const titles = new Map(model.pages.map((p) => [p.route, p.title]));
+  const problems = [], notes = [];
+  const entries = [];
+  for (const route of listing.children) {
+    const fields = model.entries.get(route);
+    if (!fields) continue;
+    const dated = await dateOf(route, model, o.dates, o.mode);
+    problems.push(...dated.problems);
+    if (listing.sort === "date") notes.push(...dated.notes);
+    entries.push({ route, title: titles.get(route) ?? route, ...fields, date: dated.date });
+  }
+  if (listing.sort === "date") {
+    const index = model.files.get(folder).path;
+    for (const e of entries.filter((e2) => e2.date === null)) {
+      const text = `${index}: sort: date, but ${model.files.get(e.route).path} has no date: give it one (date: YYYY-MM-DD), or commit it so git dates it`;
+      if (o.mode === "build") problems.push(text);
+      else notes.push(`${text}; it is listed last`);
+    }
+    entries.sort((a, b) => a.date === b.date ? a.route < b.route ? -1 : 1 : a.date === null ? 1 : b.date === null ? -1 : a.date < b.date ? 1 : -1);
+  }
+  return { entries, problems: [...new Set(problems)], notes: [...new Set(notes)] };
+}
+var COLLECTIONS_KEY = "collections";
+var isObject6 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+function checkCollections(declared, owner, folders, leftOut, configured) {
+  const problems = [], notes = [];
+  if (configured && Object.hasOwn(configured, COLLECTIONS_KEY)) {
+    problems.push(`storefront.site.${COLLECTIONS_KEY} is filled by Pattern Dump from the pages folders: list the names in ${owner}'s schema, and don't set it in the config`);
+  }
+  if (!declared) return { listed: [], problems, notes };
+  const names = isObject6(declared["properties"]) ? declared["properties"] : {};
+  const extra = Object.keys(declared).filter((k) => !["type", "description", "title", "properties", "required"].includes(k));
+  if (extra.length || declared["type"] !== void 0 && declared["type"] !== "object") {
+    problems.push(`${owner} declares a shape for site.${COLLECTIONS_KEY}: the shape of an entry is Pattern Dump's, so list the folders' names under properties only`);
+  }
+  const required = Array.isArray(declared["required"]) ? declared["required"].map(String) : [];
+  const listed = [.../* @__PURE__ */ new Set([...Object.keys(names), ...required])];
+  for (const name of listed) {
+    const schema = names[name];
+    const own = Object.keys(isObject6(schema) ? schema : {}).filter((k) => k !== "description" && k !== "title");
+    if (own.length) {
+      problems.push(`${owner} declares ${own.map((k) => `"${k}"`).join(", ")} for site.${COLLECTIONS_KEY}.${name}: the shape of an entry is Pattern Dump's, so list the name only (a description at most)`);
+    }
+    if (!folders.has(name) && !leftOut.includes(`${name}/index.md`)) {
+      const near = suggest(name, [...folders]);
+      const text = `${owner} lists site.${COLLECTIONS_KEY}.${name}, but the pages folder has no folder "${name}" with an index.md`;
+      const hint = near ? ` \u2014 did you mean "${near}"?` : folders.size ? ` (its folders: ${[...folders].map((f) => `"${f}"`).join(", ")})` : "";
+      if (required.includes(name)) problems.push(`${text}, and ${owner} requires it${hint}`);
+      else notes.push(`${text}, so it is an empty list${hint}`);
+    }
+  }
+  return { listed, problems, notes };
+}
+async function resolveCollections(listed, model, o) {
+  const collections = {};
+  const problems = [], notes = [];
+  for (const name of listed) {
+    const r = await entriesOf(`/${name}/`, model, o);
+    collections[name] = r.entries;
+    problems.push(...r.problems);
+    notes.push(...r.notes);
+  }
+  return { collections, problems, notes };
+}
+
 // packages/dev-server/src/storefront/site.ts
 var SITE_SCHEMA_OWNER = "partials/base";
-var none = (problems = []) => ({ values: {}, navigations: {}, listed: [], problems });
-async function checkSite(site, discoveryMap, pagePaths = /* @__PURE__ */ new Set()) {
+var none = (problems = [], collections = []) => ({ values: {}, navigations: {}, listed: [], collections, problems });
+async function checkSite(site, discoveryMap, pagePaths = /* @__PURE__ */ new Set(), pages = { folders: /* @__PURE__ */ new Set(), leftOut: [] }) {
   const problems = [];
   const entry = discoveryMap.get(SITE_SCHEMA_OWNER);
   if (!entry) {
@@ -5600,24 +6141,32 @@ async function checkSite(site, discoveryMap, pagePaths = /* @__PURE__ */ new Set
   }
   const navDeclared = declared.properties?.[NAVIGATIONS_KEY];
   const navs = checkNavigations(site?.[NAVIGATIONS_KEY], navDeclared, SITE_SCHEMA_OWNER, pagePaths);
+  const cols = checkCollections(
+    declared.properties?.[COLLECTIONS_KEY],
+    SITE_SCHEMA_OWNER,
+    pages.folders,
+    pages.leftOut,
+    site
+  );
   if (site === void 0) {
     if (schema.required?.includes("site")) problems.push(`storefront.site is required by ${SITE_SCHEMA_OWNER}`);
-    problems.push(...navs.problems);
-    return { ...none(problems), listed: navs.listed };
+    problems.push(...navs.problems, ...cols.problems);
+    return { ...none(problems, cols.listed), listed: navs.listed, notes: cols.notes };
   }
-  const { [NAVIGATIONS_KEY]: _navigations, ...rest } = site;
+  const own = (k) => k !== NAVIGATIONS_KEY && k !== COLLECTIONS_KEY;
+  const rest = Object.fromEntries(Object.entries(site).filter(([k]) => own(k)));
   const restDeclared = {
     ...declared,
-    properties: Object.fromEntries(Object.entries(declared.properties ?? {}).filter(([k]) => k !== NAVIGATIONS_KEY)),
-    ...declared.required ? { required: declared.required.filter((k) => k !== NAVIGATIONS_KEY) } : {}
+    properties: Object.fromEntries(Object.entries(declared.properties ?? {}).filter(([k]) => own(k))),
+    ...declared.required ? { required: declared.required.filter(own) } : {}
   };
   const checked = checkJsonKeys(restDeclared, rest, "storefront.site", SITE_SCHEMA_OWNER);
-  problems.push(...checked.problems, ...navs.problems);
+  problems.push(...checked.problems, ...navs.problems, ...cols.problems);
   if (declared.required?.includes(NAVIGATIONS_KEY) && !Object.hasOwn(site, NAVIGATIONS_KEY)) {
     problems.push(`storefront.site.${NAVIGATIONS_KEY} is required by ${SITE_SCHEMA_OWNER}`);
   }
-  if (problems.length) return { ...none(problems), listed: navs.listed };
-  return { values: checked.value, navigations: navs.navigations, listed: navs.listed, problems };
+  if (problems.length) return { ...none(problems, cols.listed), listed: navs.listed, notes: cols.notes };
+  return { values: checked.value, navigations: navs.navigations, listed: navs.listed, collections: cols.listed, problems, notes: cols.notes };
 }
 
 // packages/dev-server/src/storefront/sample-data.ts
@@ -5635,7 +6184,7 @@ function includeTree(layoutId, composition) {
   }
   return [layoutId, ...[...seen].filter((id) => id !== layoutId).sort()];
 }
-async function checkSampleData(layoutId, discoveryMap, composition, layoutDeclared, siteDeclared, pageDeclared, navigationNames = []) {
+async function checkSampleData(layoutId, discoveryMap, composition, layoutDeclared, siteDeclared, pageDeclared, navigationNames = [], collectionNames = []) {
   const problems = [];
   const allowed = new Set([...layoutDeclared, ...ASSEMBLY_KEYS].filter((k) => k !== "page" || pageDeclared !== void 0));
   const shapeFields = PAGE_SHAPE.fields;
@@ -5672,10 +6221,11 @@ async function checkSampleData(layoutId, discoveryMap, composition, layoutDeclar
         for (const [sub, v] of Object.entries(value)) {
           if (!siteDeclared.includes(sub)) {
             problems.push(`${where} sets "site.${sub}", which ${SITE_SCHEMA_OWNER} does not declare for site, so it would show on every page using ${layoutId}`);
-          } else if (sub === "navigations" && isPlainObject2(v)) {
+          } else if ((sub === "navigations" || sub === "collections") && isPlainObject2(v)) {
+            const names = sub === "navigations" ? navigationNames : collectionNames;
             for (const name of Object.keys(v)) {
-              if (!navigationNames.includes(name)) {
-                problems.push(`${where} sets "site.navigations.${name}", which ${SITE_SCHEMA_OWNER} does not list, so it would show on every page using ${layoutId}`);
+              if (!names.includes(name)) {
+                problems.push(`${where} sets "site.${sub}.${name}", which ${SITE_SCHEMA_OWNER} does not list, so it would show on every page using ${layoutId}`);
               }
             }
           }
@@ -5687,7 +6237,7 @@ async function checkSampleData(layoutId, discoveryMap, composition, layoutDeclar
 }
 
 // packages/dev-server/src/storefront/placed.ts
-var contentMd = new MarkdownIt2({ html: false, linkify: false });
+var contentMd = new MarkdownIt3({ html: false, linkify: false });
 var kebab = (k) => k.replace(/[A-Z]/g, (c3) => `-${c3.toLowerCase()}`);
 async function placementComponents(id, deps) {
   const seen = /* @__PURE__ */ new Set();
@@ -5736,7 +6286,7 @@ async function unsafeOutputs(id, at, deps) {
   }
   return problems;
 }
-var isObject6 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isObject7 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 function undeclaredSampleKeys(sample, props, prefix) {
   const out = [];
   for (const [key, value] of Object.entries(sample)) {
@@ -5745,7 +6295,7 @@ function undeclaredSampleKeys(sample, props, prefix) {
       out.push(`${prefix}${key}`);
       continue;
     }
-    if (isObject6(value) && prop.properties) out.push(...undeclaredSampleKeys(value, prop.properties, `${prefix}${key}.`));
+    if (isObject7(value) && prop.properties) out.push(...undeclaredSampleKeys(value, prop.properties, `${prefix}${key}.`));
   }
   return out;
 }
@@ -5764,7 +6314,7 @@ async function sampleDataProblems(id, at, deps) {
       } catch {
         continue;
       }
-      if (!isObject6(sample)) continue;
+      if (!isObject7(sample)) continue;
       for (const key of undeclaredSampleKeys(sample, declared, "")) {
         problems.push({ at, message: `the sample data of ${template} (${basename7(jsonPath)}) sets "${key}", which ${owner} does not declare, so it would show wherever ${owner} is placed` });
       }
@@ -5784,6 +6334,11 @@ async function schemaProblems(id, at, deps) {
     })) {
       problems.push({ at, message: `${component} cannot be placed: its schema (${deps.shown(entry.schemaPath)}, ${p.path}): ${p.message}` });
     }
+    const rendered = await deps.render({ component }).catch(() => void 0);
+    for (const d of rendered?.meta?.diagnostics ?? []) {
+      if (d.kind !== "SCHEMA_INVALID" || !isHelperNameProblem(d.message)) continue;
+      problems.push({ at, message: `${component} cannot be placed: its schema (${deps.shown(entry.schemaPath)}, ${d.path ?? "#"}): ${d.message}` });
+    }
   }
   return problems;
 }
@@ -5839,23 +6394,23 @@ var Slugger = class {
 // packages/dev-server/src/markdown.ts
 var INLINE = { embed: "inline" };
 function createDocMarkdown(placing) {
-  const md = new MarkdownIt3({ html: false, linkify: false });
-  md.validateLink = (url) => {
+  const md2 = new MarkdownIt4({ html: false, linkify: false });
+  md2.validateLink = (url) => {
     const t = url.trim();
     return /^(https?|mailto|tel):/i.test(t) || /^[.#/]/.test(t) || t.startsWith("pattern:");
   };
-  md.renderer.rules["fence"] = (tokens, idx, _opts, env) => {
+  md2.renderer.rules["fence"] = (tokens, idx, _opts, env) => {
     const map = env.resolvedFences;
     return map?.get(idx) ?? _mdPlainPre(tokens[idx]?.content ?? "");
   };
-  const image = md.renderer.rules["image"];
-  md.renderer.rules["image"] = (tokens, idx, opts, env, self) => tokens[idx]?.meta?.pdImage ?? image(tokens, idx, opts, env, self);
+  const image = md2.renderer.rules["image"];
+  md2.renderer.rules["image"] = (tokens, idx, opts, env, self) => tokens[idx]?.meta?.pdImage ?? image(tokens, idx, opts, env, self);
   if (placing) {
-    usePlacedTags(md);
-    md.renderer.rules["pd_component"] = (_tokens, idx, _opts, env) => env.resolvedPlaced?.get(idx) ?? `<p class="doc-error">[component not placed: see the page's problems]</p>
+    usePlacedTags(md2);
+    md2.renderer.rules["pd_component"] = (_tokens, idx, _opts, env) => env.resolvedPlaced?.get(idx) ?? `<p class="doc-error">[component not placed: see the page's problems]</p>
 `;
   }
-  return md;
+  return md2;
 }
 var _md = createDocMarkdown(false);
 var _mdPlaced = createDocMarkdown(true);
@@ -5909,10 +6464,10 @@ function _resolvePatternLinks(tokens, discoveryMap, embed) {
 }
 async function renderDoc(body, renderComponent, discoveryMap, embed = INLINE) {
   const placing = embed.embed === "frame" ? embed.placed : void 0;
-  const md = placing ? _mdPlaced : _md;
-  const tokens = md.parse(body, { pdLineOffset: placing?.lineOffset ?? 0 });
+  const md2 = placing ? _mdPlaced : _md;
+  const tokens = md2.parse(body, { pdLineOffset: placing?.lineOffset ?? 0 });
   _resolvePatternLinks(tokens, discoveryMap, embed);
-  if (embed.embed === "frame" && embed.prose) proseImages(md, tokens, embed.prose);
+  if (embed.embed === "frame" && embed.prose) proseImages(md2, tokens, embed.prose);
   if (embed.embed === "frame") {
     const headings = headingAnchors(tokens, embed.takenIds);
     embed.headings?.push(...headings);
@@ -5933,9 +6488,9 @@ async function renderDoc(body, renderComponent, discoveryMap, embed = INLINE) {
 `);
     }
   }
-  return md.renderer.render(tokens, md.options, { resolvedFences, resolvedPlaced });
+  return md2.renderer.render(tokens, md2.options, { resolvedFences, resolvedPlaced });
 }
-function proseImages(md, tokens, prose) {
+function proseImages(md2, tokens, prose) {
   let eager = prose.slot?.eager ?? 0;
   for (const block2 of tokens) {
     if (block2.type !== "inline" || !block2.children) continue;
@@ -5948,7 +6503,7 @@ function proseImages(md, tokens, prose) {
       if (child.type !== "image") continue;
       const src = child.attrGet("src") ?? "";
       const problem = (message) => prose.problems.push({ line, message: `the image ${src}${message}` });
-      const alt = md.renderer.renderInlineAsText(child.children ?? [], md.options, {});
+      const alt = md2.renderer.renderInlineAsText(child.children ?? [], md2.options, {});
       if (alt.trim() === "") {
         problem(` has no alt text: write what it shows between the brackets; a decorative image goes in through a component, with alt=""`);
         continue;
@@ -6135,7 +6690,7 @@ import postcss4 from "postcss";
 import * as sass3 from "sass";
 import { SourceMapConsumer as SourceMapConsumer2 } from "source-map";
 import { parse as parseHtml2 } from "node-html-parser";
-async function recomputeComponentCss(entryFile, compId, stylesDir, componentIds, inBase = () => false) {
+async function recomputeComponentCss(entryFile, compId, stylesDir, componentIds, inBase = () => false, out) {
   try {
     const compiled = sass3.compile(entryFile, { sourceMap: true, ...sassPackageOptions(entryFile) });
     const rawMap = compiled.sourceMap;
@@ -6143,16 +6698,22 @@ async function recomputeComponentCss(entryFile, compId, stylesDir, componentIds,
     const consumer = new SourceMapConsumer2(rawMap);
     const root = postcss4.parse(compiled.css);
     const bucket = /* @__PURE__ */ new Set();
+    const base2 = /* @__PURE__ */ new Set();
     root.each((node) => {
       const pos = node.source?.start;
       if (!pos) return;
       const original = consumer.originalPositionFor({ line: pos.line, column: pos.column - 1 });
       if (!original.source) return;
       const originPath = original.source.startsWith("file://") ? fileURLToPath4(original.source) : resolve8(dirname8(entryFile), original.source);
-      if (inBase(originPath)) return;
+      if (inBase(originPath)) {
+        addLastOccurrence(base2, cssNodeText(node));
+        return;
+      }
       const originComp = resolveScssToComponent(originPath, stylesDir, componentIds);
       if (originComp === compId) addLastOccurrence(bucket, cssNodeText(node));
+      else if (originComp === null) addLastOccurrence(base2, cssNodeText(node));
     });
+    if (out) out.baseRules = joinCssChunks(base2);
     return joinCssChunks(bucket);
   } catch {
     return null;
@@ -6345,13 +6906,13 @@ async function buildComponentDetail(componentId, patternsDir, renderFn, tracker,
 }
 
 // packages/dev-server/src/overview.ts
-import { join as join23 } from "node:path";
+import { join as join24 } from "node:path";
 async function buildFolderOverview(folderPath, patternsDir, renderFn, discoveryMap) {
   const category = folderPath.split("/")[0];
   let folderLayout = FULL_CATEGORIES.has(stripOrderPrefixes(category)) ? "full" : "centered";
   let doc;
   try {
-    const rawIndex = await readFolderFile(patternsDir, join23(folderPath, "index.md"));
+    const rawIndex = await readFolderFile(patternsDir, join24(folderPath, "index.md"));
     if (rawIndex === null) throw new Error("no index.md");
     const m = rawIndex.match(/^preview:\s*(centered|full)$/m);
     if (m) folderLayout = m[1];
@@ -6388,9 +6949,9 @@ async function collectPublicLeaves(folderPath, patternsDir, discoveryMap) {
 }
 
 // packages/dev-server/src/content-hash.ts
-import { createHash as createHash5 } from "node:crypto";
+import { createHash as createHash6 } from "node:crypto";
 function contentHash(bytes) {
-  return createHash5("sha256").update(bytes).digest("hex").slice(0, 10);
+  return createHash6("sha256").update(bytes).digest("hex").slice(0, 10);
 }
 
 // packages/dev-server/src/scripts.ts
@@ -6560,7 +7121,11 @@ async function stampSrcset(value, hashOf) {
   }));
   return entries.join(",");
 }
-async function stampTag(name, attrs, hashOf) {
+async function stampAbsolute(path, hashOf, base2) {
+  if (base2 === "/" || !path.startsWith(base2)) return stamp(path, hashOf);
+  return `${base2}${(await stamp(`/${path.slice(base2.length)}`, hashOf)).slice(1)}`;
+}
+async function stampTag(name, attrs, hashOf, base2) {
   const isPreview = name.toLowerCase() === "meta" && /\s(?:property="og:image"|name="twitter:image")/.test(attrs);
   return replaceAsync(attrs, ATTRIBUTE, async (m) => {
     const [whole, lead, attr2, eq, quoted] = m;
@@ -6573,22 +7138,22 @@ async function stampTag(name, attrs, hashOf) {
     else if (key === "srcset") stamped = await stampSrcset(value, hashOf);
     else if (key === "content" && isPreview) {
       const at = /^(https?:\/\/[^/"']+)(.*)$/.exec(value);
-      if (at) stamped = `${at[1]}${await stamp(at[2], hashOf)}`;
+      if (at) stamped = `${at[1]}${await stampAbsolute(at[2], hashOf, base2)}`;
     }
     return `${lead}${attr2}${eq}${q}${stamped}${q}`;
   });
 }
-async function stampHtml(html, hashOf) {
+async function stampHtml(html, hashOf, base2 = "/") {
   const parts = [];
   let last = 0;
   for (const tag of startTags(html)) {
     parts.push(html.slice(last, tag.start));
     const attrsAt = tag.start + 1 + tag.name.length;
-    parts.push(`<${tag.name}${await stampTag(tag.name, tag.attrs, hashOf)}${html.slice(attrsAt + tag.attrs.length, tag.end)}`);
+    parts.push(`<${tag.name}${await stampTag(tag.name, tag.attrs, hashOf, base2)}${html.slice(attrsAt + tag.attrs.length, tag.end)}`);
     last = tag.end;
     if (!tag.content) continue;
     const content = html.slice(tag.content.start, tag.content.end);
-    parts.push(tag.name.toLowerCase() === "script" && /\stype=["']?application\/ld\+json/i.test(tag.attrs) ? await replaceAsync(content, /("image":"https?:\/\/[^/"]+)([^"]*)"/g, async (j) => `${j[1]}${await stamp(j[2], hashOf)}"`) : content);
+    parts.push(tag.name.toLowerCase() === "script" && /\stype=["']?application\/ld\+json/i.test(tag.attrs) ? await replaceAsync(content, /("image":"https?:\/\/[^/"]+)([^"]*)"/g, async (j) => `${j[1]}${await stampAbsolute(j[2], hashOf, base2)}"`) : content);
     last = tag.content.end;
   }
   parts.push(html.slice(last));
@@ -6605,7 +7170,7 @@ async function stampCss(css, hashOf) {
 
 // packages/dev-server/src/assets.ts
 import { existsSync as existsSync5 } from "node:fs";
-import { createRequire as createRequire4 } from "node:module";
+import { createRequire as createRequire5 } from "node:module";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 function resolveDevUiDist(moduleUrl, exists = existsSync5) {
   const packaged = fileURLToPath5(new URL("./dev-ui/", moduleUrl));
@@ -6613,7 +7178,7 @@ function resolveDevUiDist(moduleUrl, exists = existsSync5) {
   return fileURLToPath5(new URL("../../../apps/dev-ui/dist/", moduleUrl));
 }
 function resolveAxeCore(moduleUrl) {
-  return createRequire4(moduleUrl).resolve("axe-core/axe.min.js");
+  return createRequire5(moduleUrl).resolve("axe-core/axe.min.js");
 }
 
 // packages/dev-server/src/storefront/page-image.ts
@@ -6674,6 +7239,7 @@ function jsonLdScript(p) {
       name: p.title,
       ...p.description ? { description: p.description } : {},
       isPartOf: { "@id": site },
+      ...p.published ? { datePublished: p.published } : {},
       ...p.modified ? { dateModified: p.modified } : {},
       ...p.breadcrumbs.length ? {
         breadcrumb: {
@@ -6705,9 +7271,9 @@ function writtenByPatternDump(tag, attrs) {
   if (tag === "script" && attr(attrs, "type") === "application/ld+json") return `<script type="application/ld+json">`;
   return void 0;
 }
-function checkHeadMarkup(html) {
+function checkHeadMarkup(html, source2 = { label: HEAD_PARTIAL, subject: "a head partial" }) {
   const problems = [];
-  const say = (what) => problems.push(`${HEAD_PARTIAL}: ${what}`);
+  const say = (what) => problems.push(`${source2.label}: ${what.replaceAll("a head partial", source2.subject)}`);
   let rest = html.replace(/<!--[\s\S]*?-->/g, "");
   rest = rest.replace(/<(script|style|noscript|title)\b([^>]*)>[\s\S]*?<\/\1\s*>/gi, (_m, rawTag, attrs) => {
     const tag = rawTag.toLowerCase();
@@ -6781,13 +7347,14 @@ var LIVE_NOTICE = `function(t){var n=document.querySelector("[data-pd-live-notic
 function exampleHeightCheck() {
   return `(function(){var notice=(${LIVE_NOTICE});document.querySelectorAll("figure.doc-example iframe[height]").forEach(function(f){var check=function(){var d=f.contentDocument;if(!d||d.URL==="about:blank")return;d.fonts.ready.then(function(){var declared=Number(f.getAttribute("height")),root=d.documentElement.getBoundingClientRect().height,id=f.title,outcome="fits";if(root===f.clientHeight)outcome="can't tell (the content is as tall as its frame)";else if(root<declared-1){outcome="too tall";var t=id+": its live example is declared "+declared+"px tall (x-pd-example-height), but its content is "+Math.round(root)+"px. A frame is never fitted shorter than it starts, so it stays too tall: declare at most "+Math.floor(root)+".";console.warn(t);notice(t);}console.debug("[pd] example height of "+id+": "+outcome);});};f.addEventListener("load",check);if(f.contentDocument&&f.contentDocument.readyState==="complete")check();});})();`;
 }
-function document(head, body, live, lang = "en") {
+function document2(head, body, live, lang = "en", base2) {
   return `<!DOCTYPE html>
 <html lang="${escapeAttr(lang)}">
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-${head}
+${base2 !== void 0 ? `<meta name="pd-base-path" content="${escapeAttr(base2)}">
+` : ""}${head}
 </head>
 <body>
 ${body}
@@ -6844,7 +7411,7 @@ var BUILT_IN_NOT_FOUND_DOCUMENT = `<main>
 </main>`;
 function errorDocument(route, problems, live, siteWide = []) {
   const items = problems.map((p) => `<li${siteWide.includes(p) ? " data-pd-site" : ""}>${escapeHtml(p)}</li>`).join("\n");
-  return document(
+  return document2(
     `<title>Problems \u2014 ${escapeHtml(route)}</title>`,
     `<main>
 <h1>The page ${escapeHtml(route)} cannot be built</h1>
@@ -6878,7 +7445,7 @@ async function assemblePage(route, model, a) {
     if (!a.discoveryMap.has(layoutId)) {
       return {
         status: 404,
-        html: document(`<title>Page not found</title>`, BUILT_IN_NOT_FOUND_DOCUMENT, a.live, a.lang),
+        html: document2(`<title>Page not found</title>`, BUILT_IN_NOT_FOUND_DOCUMENT, a.live, a.lang, a.basePath ?? "/"),
         problems: [],
         notes: [`there is no ${NOT_FOUND_FILE} and no ${layoutId}, so the 404 page is a plain one of Pattern Dump's`]
       };
@@ -6903,7 +7470,10 @@ async function assemblePage(route, model, a) {
     const line = page.frontmatter.lines["redirectFrom"];
     problems.push(`${page.path}${line !== void 0 ? `:${line}` : ""}: the 404 page can't have redirectFrom: it is served for every address that has no page`);
   }
-  const site = await checkSite(a.site, a.discoveryMap, new Set([...model.files.values()].map((f) => f.path)));
+  const site = await checkSite(a.site, a.discoveryMap, new Set([...model.files.values()].map((f) => f.path)), {
+    folders: new Set([...model.folders.keys()].filter((r) => r !== "/").map((r) => r.slice(1, -1))),
+    leftOut: model.drafts
+  });
   siteWide = site.problems;
   problems.push(...site.problems);
   const imageLine = page.frontmatter.lines["image"];
@@ -6919,6 +7489,7 @@ async function assemblePage(route, model, a) {
   const layoutSchema = (await readSchema(a.discoveryMap.get(checked.layoutId)?.schemaPath)).schema;
   const proseSlot = readProseSlot(layoutSchema);
   const imageLookup = a.images ? await a.images() : void 0;
+  const placedIds = /* @__PURE__ */ new Set();
   const renderBody = async (takenIds = []) => {
     const prose = imageLookup ? {
       layoutId: checked.layoutId,
@@ -6929,6 +7500,7 @@ async function assemblePage(route, model, a) {
       ...proseSlot.problem ? { slotProblem: proseSlot.problem } : {}
     } : void 0;
     const docProblems = [];
+    placedIds.clear();
     const placedProblems = [];
     const headings = [];
     const body = await renderDoc(
@@ -6950,7 +7522,11 @@ async function assemblePage(route, model, a) {
             discoveryMap: a.discoveryMap,
             handleMap: a.handleMap,
             composition: a.composition,
-            render: a.render,
+            // Each component rendered for a placement: the page loads its behaviour scripts (page-head.ts).
+            render: (input) => {
+              placedIds.add(input.component.split("~")[0]);
+              return a.render(input);
+            },
             schemaOf: async (id) => (await readSchema(a.discoveryMap.get(id)?.schemaPath)).schema,
             shown: a.shown
           }
@@ -6971,37 +7547,65 @@ async function assemblePage(route, model, a) {
   const notes = [];
   let dates = {};
   let modified = null;
-  const showsDates = pageDeclaration.declared?.some((k) => k === "created" || k === "modified") ?? false;
+  let published = checked.build.date ?? null;
+  const mode = a.live ? "dev" : "build";
+  const declares = (k) => pageDeclaration.declared?.includes(k) ?? false;
+  const showsDates = declares("created") || declares("modified");
   if (a.dates && !isNotFound && (showsDates || a.siteUrl !== void 0)) {
-    const dated = await a.dates.of(page.path, a.live ? "dev" : "build");
+    const dated = await a.dates.of(page.path, mode);
     if (showsDates) {
       dates = dated.dates;
       notes.push(...dated.notes);
       problems.push(...dated.problems);
     }
     if (dated.shallow) notes.push(SHALLOW_SEO_NOTE);
-    else modified = dated.dates.modified;
-  }
+    else {
+      modified = dated.dates.modified;
+      published ??= dated.dates.created;
+    }
+  }
+  const listing = {};
+  if (declares("children")) {
+    const listed = isNotFound ? { entries: [], problems: [], notes: [] } : await entriesOf(route, model, { dates: a.dates, mode });
+    listing.children = listed.entries;
+    problems.push(...listed.problems);
+    notes.push(...listed.notes);
+  }
+  if (declares("date")) {
+    const dated = isNotFound ? { date: null, problems: [], notes: [] } : await dateOf(route, model, a.dates, mode);
+    listing.date = dated.date;
+    problems.push(...dated.problems);
+    notes.push(...dated.notes);
+  }
+  if (declares("tags")) listing.tags = model.entries.get(route)?.tags ?? [];
+  const collections = site.collections.length ? await resolveCollections(site.collections, model, { dates: a.dates, mode }) : void 0;
+  if (collections) {
+    problems.push(...collections.problems);
+    notes.push(...collections.notes);
+  }
+  notes.push(...site.notes ?? []);
   if (a.discoveryMap.has(checked.layoutId)) {
-    problems.push(...await checkSampleData(checked.layoutId, a.discoveryMap, a.composition, layoutDeclared, siteDeclared, pageDeclaration.declared, site.listed));
+    problems.push(...await checkSampleData(checked.layoutId, a.discoveryMap, a.composition, layoutDeclared, siteDeclared, pageDeclaration.declared, site.listed, site.collections));
   }
   const hasHead = a.discoveryMap.has(HEAD_PARTIAL);
   if (hasHead) {
-    const headSample = await checkSampleData(HEAD_PARTIAL, a.discoveryMap, a.composition, [], siteDeclared, void 0, site.listed);
+    const headSample = await checkSampleData(HEAD_PARTIAL, a.discoveryMap, a.composition, [], siteDeclared, void 0, site.listed, site.collections);
     siteWide = [...siteWide, ...headSample];
     problems.push(...headSample);
   }
   if (problems.length) return fail(problems);
+  if (a.live) notes.push(...model.drafts.map((d) => `${d} is a draft: pd build leaves it out`));
   const siteData = {
     ...withDeclaredAbsentAsNull(site.values, siteDeclared),
-    ...site.listed.length ? { navigations: resolveNavigations(site.navigations, site.listed, model, route) } : {}
+    ...site.listed.length ? { navigations: resolveNavigations(site.navigations, site.listed, model, route) } : {},
+    ...collections ? { collections: collections.collections } : {}
   };
   const dataFor = (body, headings) => ({
     ...withDeclaredAbsentAsNull(checked.values, layoutDeclared, ["body", "nav", "site", "page"]),
     body,
     nav: markCurrent(model.nav, route),
     site: siteData,
-    ...pageDeclaration.declared ? { page: pageValue(pageDeclaration.declared, { headings, ...positionOf(route, model), ...dates }) } : {}
+    ...pageDeclaration.declared ? { page: pageValue(pageDeclaration.declared, { headings, ...positionOf(route, model), ...dates, ...listing }) } : {}
   });
   const renderLayout = async (body, headings) => {
     try {
@@ -7051,6 +7655,30 @@ async function assemblePage(route, model, a) {
       return fail(markup);
     }
   }
+  let siteHead = "";
+  if (a.siteHead) {
+    const label = `storefront.head (${a.siteHead.name})`;
+    let source3;
+    try {
+      source3 = await readFile23(a.siteHead.path, "utf8");
+    } catch {
+      const p = `${label}: there is no such file`;
+      siteWide = [...siteWide, p];
+      return fail([p]);
+    }
+    try {
+      siteHead = renderPlainTemplate(source3, { site: siteData }).trim();
+    } catch (e) {
+      const p = `${label}: ${e instanceof Error ? e.message.split("\n")[0] : String(e)}`;
+      siteWide = [...siteWide, p];
+      return fail([p]);
+    }
+    const markup = checkHeadMarkup(siteHead, { label, subject: "the site's head" });
+    if (markup.length) {
+      siteWide = [...siteWide, ...markup];
+      return fail(markup);
+    }
+  }
   const title = typeof checked.values["title"] === "string" ? checked.values["title"] : isNotFound ? "Page not found" : route;
   const siteTitle = typeof site.values["title"] === "string" ? site.values["title"] : void 0;
   const description = typeof checked.values["description"] === "string" ? checked.values["description"] : void 0;
@@ -7067,9 +7695,10 @@ async function assemblePage(route, model, a) {
       image: imageCheck?.ok ? imageCheck.image : void 0,
       index: !isNotFound && a.siteIndex !== false && checked.build.index !== false
     }),
-    ...a.siteUrl !== void 0 && !isNotFound ? [jsonLdScript({ siteUrl: a.siteUrl, siteTitle, route, title, description, breadcrumbs: positionOf(route, model).breadcrumbs, modified })] : [],
+    ...a.siteUrl !== void 0 && !isNotFound ? [jsonLdScript({ siteUrl: a.siteUrl, siteTitle, route, title, description, breadcrumbs: positionOf(route, model).breadcrumbs, modified, published })] : [],
     ...headExtra ? [headExtra] : [],
-    await a.head(checked.layoutId, html)
+    ...siteHead ? [siteHead] : [],
+    await a.head(checked.layoutId, html, [...placedIds])
   ].join("\n");
   if (isNotFound) {
     const relative19 = relativeUrls(`${head}
@@ -7106,21 +7735,33 @@ ${html}`);
     const self = isNotFound ? PD_ROUTES.notFound : route;
     const routes = /* @__PURE__ */ new Set([...model.files.keys(), ...[...model.files.values()].flatMap(redirectsOf), PD_ROUTES.notFound]);
     routes.add(self);
-    const links = checkLinks({ built: routes, documents: /* @__PURE__ */ new Map([[self, html]]), pages: [self], pagesOnly: true });
+    const links = checkLinks({
+      built: routes,
+      documents: /* @__PURE__ */ new Map([[self, html]]),
+      pages: [self],
+      pagesOnly: true,
+      ...a.basePath !== void 0 ? { pathHint: a.basePath } : {}
+    });
     notes.push(...links.problems.map((p) => `warning: ${page.path}${p.slice(self.length)}`));
     notes.push(...checkPageBasics(html).map((p) => `warning: ${page.path}: ${p}`));
   }
-  return { status: isNotFound ? 404 : 200, html: document(head, `${html}
-${fitterScript()}`, a.live, a.lang), problems: [], notes };
+  return { status: isNotFound ? 404 : 200, html: document2(head, `${html}
+${fitterScript()}`, a.live, a.lang, a.basePath ?? "/"), problems: [], notes };
 }
 
 // packages/dev-server/src/storefront/page-head.ts
-async function pageStylesheets(cfg, state, discovery, layoutId, html) {
-  const { discoveryMap } = discovery;
+async function pageStylesheets(cfg, state, discovery, layoutId, html, placed = []) {
+  const { discoveryMap, handleMap } = discovery;
+  const requireScripts = [];
+  for (const id of [layoutId, ...placed]) {
+    for (const s of (await aggregateRequires(id, cfg.patternDirs, handleMap, discoveryMap)).scripts) {
+      if (!requireScripts.includes(s)) requireScripts.push(s);
+    }
+  }
   const assets = await resolveDocumentAssets(cfg, state, {
     componentId: layoutId,
     html,
-    requireScripts: void 0,
+    requireScripts,
     requireAssets: void 0,
     compositionRegistry: await compositionFor(state, discovery, cfg.patternDirs),
     discoveryMap
@@ -7133,7 +7774,8 @@ async function pageStylesheets(cfg, state, discovery, layoutId, html) {
     themeSwitch: cfg.themeSwitch,
     baseCssVersion: state.baseCssVersion
   });
-  return [layers.base, layers.assets, layers.themes, layers.closure].filter(Boolean).join("\n");
+  const scripts = assets.scripts.map((src) => src.includes("://") ? `<script type="module" src="${escapeAttr(src)}"></script>` : `<script type="module" src="${escapeAttr(scriptUrl(src, assets.scriptVersions?.get(src) ?? void 0))}"></script>`);
+  return [layers.base, layers.assets, layers.themes, layers.closure, ...scripts].filter(Boolean).join("\n");
 }
 
 // packages/dev-server/src/routes.ts
@@ -7147,9 +7789,31 @@ async function handleRequest(req, res, ctx) {
     return;
   }
   const host = (req.headers.host ?? "").replace(/:\d+$/, "").toLowerCase();
-  if (cfg.storefront && host === cfg.storefront.host) return stampedResponse(req, res, ctx);
+  if (cfg.storefront && host === cfg.storefront.host) {
+    if (!underBasePath(req, res, cfg.storefront.basePath)) return;
+    return stampedResponse(req, res, ctx);
+  }
   return routeRequest(req, res, ctx);
 }
+function underBasePath(req, res, base2) {
+  if (base2 === "/") return true;
+  const raw = req.url ?? "/";
+  const at = raw.search(/[?#]/);
+  const path = at < 0 ? raw : raw.slice(0, at);
+  const query = at < 0 ? "" : raw.slice(at);
+  if (path === TEST_SETTLE_ROUTE) return true;
+  if (path.startsWith(base2)) {
+    req.url = `/${raw.slice(base2.length)}`;
+    return true;
+  }
+  if (path === "/" || `${path}/` === base2) {
+    res.writeHead(302, { Location: `${base2}${query}` });
+    res.end();
+    return false;
+  }
+  req.url = PD_ROUTES.notFound;
+  return true;
+}
 function holdResponse() {
   let status = 200;
   const headers = {};
@@ -7184,12 +7848,12 @@ function holdResponse() {
 var stampCaches = /* @__PURE__ */ new WeakMap();
 function hashOfFor(req, ctx) {
   const generation = ctx.generation?.() ?? "";
-  let cache = stampCaches.get(ctx);
-  if (!cache || cache.generation !== generation) {
-    cache = { generation, hashes: /* @__PURE__ */ new Map() };
-    stampCaches.set(ctx, cache);
+  let cache2 = stampCaches.get(ctx);
+  if (!cache2 || cache2.generation !== generation) {
+    cache2 = { generation, hashes: /* @__PURE__ */ new Map() };
+    stampCaches.set(ctx, cache2);
   }
-  const { hashes } = cache;
+  const { hashes } = cache2;
   return (path) => {
     let hash = hashes.get(path);
     if (!hash) {
@@ -7215,8 +7879,13 @@ async function stampedResponse(req, res, ctx) {
   await routeRequest(req, held.res, ctx);
   const type = String(held.headers["content-type"] ?? "");
   let body = held.body();
-  if (/^text\/html\b/.test(type)) body = await stampHtml(body.toString("utf8"), hashOfFor(req, ctx));
-  else if (/^text\/css\b/.test(type)) body = await stampCss(body.toString("utf8"), hashOfFor(req, ctx));
+  const sf = ctx.cfg.storefront;
+  const base2 = { base: sf.basePath, workbenchPath: sameHostWorkbenchPath(sf) };
+  const preview = sf.basePath !== "/" && (req.url ?? "").startsWith(PD_ROUTE_PREFIX.preview);
+  if (/^text\/html\b/.test(type)) {
+    const html = withBaseHtml(await stampHtml(body.toString("utf8"), hashOfFor(req, ctx), sf.basePath), base2);
+    body = preview ? withNoindex(html) : html;
+  } else if (/^text\/css\b/.test(type)) body = withBaseCss(await stampCss(body.toString("utf8"), hashOfFor(req, ctx)), base2);
   res.writeHead(held.status(), held.headers);
   res.end(body);
 }
@@ -7265,10 +7934,10 @@ async function routeRequest(req, res, ctx) {
       return;
     }
     if (pathname === PD_ROUTES.mainJs) {
-      return await serveFile(res, join24(devUiDist2, "main.js"), "application/javascript");
+      return await serveFile(res, join25(devUiDist2, "main.js"), "application/javascript");
     }
     if (pathname === PD_ROUTES.mainCss) {
-      return await serveFile(res, join24(devUiDist2, "main.css"), "text/css");
+      return await serveFile(res, join25(devUiDist2, "main.css"), "text/css");
     }
     if (pathname === PD_ROUTES.axeCore) {
       return await serveFile(res, resolveAxeCore(import.meta.url), "application/javascript");
@@ -7586,7 +8255,7 @@ async function routeRequest(req, res, ctx) {
     if (cfg.storefront && host === cfg.storefront.host) {
       const discovery = await currentDiscovery(state, patternRoots);
       const discoveryMap = discovery.discoveryMap;
-      const model = await readPages(cfg.storefront.pagesDir, { workbenchPath: sameHostWorkbenchPath(cfg.storefront) });
+      const model = await readPages(cfg.storefront.pagesDir, { workbenchPath: sameHostWorkbenchPath(cfg.storefront), drafts: ctx.live ? "show" : "leave-out" });
       if (pathname === PD_ROUTES.pages) {
         if (model.problems.length) {
           json(res, 500, { error: model.problems.join("\n") });
@@ -7595,8 +8264,8 @@ async function routeRequest(req, res, ctx) {
         json(res, 200, { pages: model.pages, nav: model.nav });
         return;
       }
-      const siteUrl = cfg.storefront.url === void 0 ? void 0 : ctx.live ? `http://${req.headers.host ?? cfg.storefront.host}/` : cfg.storefront.url;
-      if (pathname === PD_ROUTES.robots) {
+      const siteUrl = cfg.storefront.url === void 0 ? void 0 : ctx.live ? `http://${req.headers.host ?? cfg.storefront.host}${cfg.storefront.basePath}` : cfg.storefront.url;
+      if (pathname === PD_ROUTES.robots && cfg.storefront.basePath === "/") {
         res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" });
         res.end(storefrontRobotsTxt({ siteUrl, index: cfg.storefront.index, workbenchPath: sameHostWorkbenchPath(cfg.storefront) }));
         return;
@@ -7635,13 +8304,15 @@ async function routeRequest(req, res, ctx) {
         render,
         site: ctx.site.get(),
         workbenchUrl: ctx.storefrontWorkbenchUrl ?? `http://${PD_HOSTS.workbench}${port2 ? `:${port2}` : ""}/`,
-        head: (layoutId, html) => pageStylesheets(cfg, state, discovery, layoutId, html),
+        head: (layoutId, html, placed) => pageStylesheets(cfg, state, discovery, layoutId, html, placed),
         ...ctx.dates ? { dates: ctx.dates } : {},
         ...ctx.live ? { live: { wsPort, generation: generation ?? "" } } : {},
         image: (path) => checkPageImage(path, assetRoots, assetRootNames),
         ...siteUrl !== void 0 ? { siteUrl } : {},
         lang: cfg.storefront.lang,
         siteIndex: cfg.storefront.index,
+        basePath: cfg.storefront.basePath,
+        ...cfg.storefront.head !== void 0 ? { siteHead: { path: cfg.storefront.head, name: cfg.storefront.headName ?? cfg.storefront.head } } : {},
         ...cfg.storefront.image !== void 0 ? { siteImage: cfg.storefront.image } : {},
         ...ctx.images ? { images: ctx.images } : {}
       });
@@ -7734,7 +8405,7 @@ function createRenderingHandle(build, registrars, globalData) {
 
 // packages/dev-server/src/watch-roots.ts
 import { statSync as statSync3 } from "node:fs";
-import { dirname as dirname9, extname as extname3, join as join25, resolve as resolve9, sep as sep8 } from "node:path";
+import { dirname as dirname9, extname as extname3, join as join26, resolve as resolve9, sep as sep8 } from "node:path";
 var MODULE = /\.[mc]?js$/;
 function helperScope(path) {
   let isDir = false;
@@ -7753,23 +8424,23 @@ function watchedRoots(cfg) {
     styles: [...projectStyles, ...packageStyles].map((r) => ({ dir: r.dir, inBase: documentBaseMatcher(r.dir, r.base) })),
     themes: [
       ...cfg.config.themes?.dir && cfg.themesDir ? [cfg.themesDir] : [],
-      ...[...linked.values()].filter((p) => p.manifest.themes).map((p) => join25(p.dir, p.manifest.themes.dir))
+      ...[...linked.values()].filter((p) => p.manifest.themes).map((p) => join26(p.dir, p.manifest.themes.dir))
     ],
     scripts: [
       ...cfg.config.scriptsDir && cfg.scriptsDirs[0] ? [cfg.scriptsDirs[0]] : [],
-      ...[...linked.values()].filter((p) => p.manifest.scripts).map((p) => join25(p.dir, p.manifest.scripts))
+      ...[...linked.values()].filter((p) => p.manifest.scripts).map((p) => join26(p.dir, p.manifest.scripts))
     ],
     data: [
       ...cfg.config.dataDir ? [resolve9(cfg.cwd, cfg.config.dataDir)] : [],
-      ...[...linked.values()].filter((p) => p.manifest.data).map((p) => join25(p.dir, p.manifest.data))
+      ...[...linked.values()].filter((p) => p.manifest.data).map((p) => join26(p.dir, p.manifest.data))
     ],
     assets: [
       ...[cfg.config.assets?.dir ?? []].flat().map((d) => resolve9(cfg.cwd, d)),
-      ...[...linked.values()].flatMap((p) => (p.manifest.assets ?? []).map((a) => join25(p.dir, a)))
+      ...[...linked.values()].flatMap((p) => (p.manifest.assets ?? []).map((a) => join26(p.dir, a)))
     ],
     helpers: [
       ...cfg.config.helpers ? [resolve9(cfg.cwd, cfg.config.helpers)] : [],
-      ...[...linked.values()].filter((p) => p.manifest.helpers).map((p) => join25(p.dir, p.manifest.helpers))
+      ...[...linked.values()].filter((p) => p.manifest.helpers).map((p) => join26(p.dir, p.manifest.helpers))
     ].map(helperScope)
   };
 }
@@ -7800,10 +8471,10 @@ function rootMatchers(watched) {
 }
 
 // packages/dev-server/src/watch.ts
-import { createHash as createHash6 } from "node:crypto";
+import { createHash as createHash7 } from "node:crypto";
 import { existsSync as existsSync6, readFileSync as readFileSync4, statSync as statSync4 } from "node:fs";
 import { appendFile, readdir as readdir9 } from "node:fs/promises";
-import { basename as basename10, extname as extname4, join as join26, relative as relative13, resolve as resolve10, sep as sep9 } from "node:path";
+import { basename as basename10, extname as extname4, join as join27, relative as relative13, resolve as resolve10, sep as sep9 } from "node:path";
 import chokidar from "chokidar";
 
 // packages/dev-server/src/config-change.ts
@@ -7862,7 +8533,7 @@ function seenNow(path) {
     const s = statSync4(path);
     const stamp2 = `${s.ino}:${s.ctimeMs}:${s.mtimeMs}:${s.size}`;
     const forced = globalThis.__testOnly_watchStamp;
-    return { stamp: forced ? forced(path, stamp2) : stamp2, real: stamp2, hash: createHash6("sha1").update(readFileSync4(path)).digest("hex") };
+    return { stamp: forced ? forced(path, stamp2) : stamp2, real: stamp2, hash: createHash7("sha1").update(readFileSync4(path)).digest("hex") };
   } catch {
     return null;
   }
@@ -7893,7 +8564,7 @@ async function startWatching(ctx) {
   const barrierWaiters = /* @__PURE__ */ new Set();
   const SETTLE_MS = 1e4;
   async function settle() {
-    const files = [...new Set(watchDirs)].filter((d) => existsSync6(d)).map((d) => join26(d, BARRIER));
+    const files = [...new Set(watchDirs)].filter((d) => existsSync6(d)).map((d) => join27(d, BARRIER));
     const waiting = new Set(files);
     const handled = new Promise((resolve15, reject) => {
       if (!waiting.size) {
@@ -8151,7 +8822,7 @@ async function startWatching(ctx) {
     }
     for (const entry of entries) {
       if (closed) return true;
-      const path = join26(dir, entry.name);
+      const path = join27(dir, entry.name);
       if (entry.isDirectory()) {
         if (firstReport(path)) dispatchers.addDir?.(path);
         await scanFolder(path);
@@ -8261,7 +8932,11 @@ async function startWatching(ctx) {
       const compId = componentOfScss(resolve10(recompiledFile), allIds);
       const root = styleRootOf(resolve10(recompiledFile));
       if (compId && root) {
-        const newCss = await recomputeComponentCss(recompiledFile, compId, root.dir, allIds, root.inBase);
+        const out = {};
+        const newCss = await recomputeComponentCss(recompiledFile, compId, root.dir, allIds, root.inBase, out);
+        if (newCss !== null && (out.baseRules ?? "") !== (state.entryBaseRules.get(resolve10(recompiledFile)) ?? "")) {
+          return restyleAll(discovery, timestamp, effectiveFiles, compileErrors.length > 0);
+        }
         if (newCss !== null) {
           const wasEmpty = (state.perComponentCss.get(compId) ?? "") === "";
           state.perComponentCss.set(compId, newCss);
@@ -8463,7 +9138,7 @@ async function startWatching(ctx) {
   async function pagesFingerprint() {
     if (!pagesDir) return null;
     const model = await readPages(pagesDir, { workbenchPath });
-    return JSON.stringify({ nav: model.nav, pages: model.pages, problems: model.problems });
+    return JSON.stringify({ nav: model.nav, pages: model.pages, problems: model.problems, entries: [...model.entries], folders: [...model.folders] });
   }
   async function handlePages(filePath, event) {
     if (!inPages(filePath)) return false;
@@ -8768,7 +9443,7 @@ function createGitDates(pagesDir, listPages, git = runGit) {
 
 // packages/dev-server/src/export-io.ts
 import { readFile as readFile25, writeFile as writeFile6, mkdir as mkdir6 } from "node:fs/promises";
-import { dirname as dirname10, join as join27, relative as relative15, resolve as resolve11 } from "node:path";
+import { dirname as dirname10, join as join28, relative as relative15, resolve as resolve11 } from "node:path";
 
 // packages/dev-server/src/export.ts
 var escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -8961,20 +9636,20 @@ async function writeExport(families, sink) {
   const files = [];
   for (const family of families) {
     const baseRel = `${family.baseId}.hbs`;
-    const basePath = join27(sink, baseRel);
+    const basePath = join28(sink, baseRel);
     await mkdir6(dirname10(basePath), { recursive: true });
     await writeFile6(basePath, family.baseHbs, "utf-8");
     files.push(baseRel);
     if (family.baseData) {
       const dataRel = `${family.baseId}.json`;
-      await writeFile6(join27(sink, dataRel), JSON.stringify(family.baseData, null, 2) + "\n", "utf-8");
+      await writeFile6(join28(sink, dataRel), JSON.stringify(family.baseData, null, 2) + "\n", "utf-8");
       files.push(dataRel);
     }
     for (const v of family.variants) {
       if (v.token === "") continue;
       const overlayRel = `${family.baseId}~${v.token}.json`;
       const overlay = { modifier: v.modifier, ...v.data ?? {} };
-      await writeFile6(join27(sink, overlayRel), JSON.stringify(overlay, null, 2) + "\n", "utf-8");
+      await writeFile6(join28(sink, overlayRel), JSON.stringify(overlay, null, 2) + "\n", "utf-8");
       files.push(overlayRel);
     }
   }
@@ -9006,7 +9681,7 @@ async function writeThreadedIncluders(threaded, patternsDir, sink) {
     if (res.rewrites === 0) continue;
     rewrites += res.rewrites;
     const rel = relative15(patternsDir, hbsPath);
-    const outPath = join27(sink, rel);
+    const outPath = join28(sink, rel);
     await mkdir6(dirname10(outPath), { recursive: true });
     await writeFile6(outPath, res.hbs, "utf-8");
     files.push(rel);
@@ -9162,6 +9837,16 @@ async function startDevServer(config, cwd, opts = {}) {
     build: opts.live === false,
     warn: (message) => console.warn(`[dev-server] ${message}`)
   });
+  const helperNamesSaid = /* @__PURE__ */ new Set();
+  const reportHelperNames = (diagnostics) => {
+    for (const d of diagnostics ?? []) {
+      if (d.kind !== "SCHEMA_INVALID" || !isHelperNameProblem(d.message)) continue;
+      const line = `${d.location?.file ?? "a schema"} (${d.path ?? "#"}): ${d.message}`;
+      if (helperNamesSaid.has(line)) continue;
+      helperNamesSaid.add(line);
+      console.error(`[dev-server] error: ${line}`);
+    }
+  };
   const buildRenderer = (registrars, data) => {
     const renderWith = createRenderer({
       patternsDir,
@@ -9175,7 +9860,9 @@ async function startDevServer(config, cwd, opts = {}) {
     });
     return async (input) => {
       await images.ready(generationNow());
-      return renderWith(input);
+      const result = await renderWith(input);
+      reportHelperNames(result.meta?.diagnostics);
+      return result;
     };
   };
   const rendering = createRenderingHandle(buildRenderer, helperRegistrars, globalData);
@@ -9199,7 +9886,7 @@ async function startDevServer(config, cwd, opts = {}) {
   if (cfg.themeDirs.length) {
     for (const { name, dir } of await discoverThemeFiles(cfg.themeDirs)) {
       try {
-        const css = await compileSassFile(join28(dir, `${name}.theme.scss`));
+        const css = await compileSassFile(join29(dir, `${name}.theme.scss`));
         state.themeCss.set(name, css);
         const slots = config.themes?.dir && dir === cfg.themeDirs[0] ? swatchSlots : cfg.packageSwatchSlots;
         state.themeTokens.set(name, await extractThemeTokens(name, css, slots, dir));
@@ -9275,7 +9962,7 @@ async function startDevServer(config, cwd, opts = {}) {
   httpPort = actualPort;
   console.log(`[dev-server] Listening at http://127.0.0.1:${actualPort}`);
   if (live) {
-    if (cfg.storefront) console.log(`[dev-server] Website:   http://${cfg.storefront.host}:${actualPort}/`);
+    if (cfg.storefront) console.log(`[dev-server] Website:   http://${cfg.storefront.host}:${actualPort}${cfg.storefront.basePath}`);
     console.log(`[dev-server] Workbench: http://${cfg.storefront ? PD_HOSTS.workbench : "localhost"}:${actualPort}/`);
   }
   const startupDiscovery = await cachedDiscovery(state);
@@ -9320,10 +10007,10 @@ async function startDevServer(config, cwd, opts = {}) {
 import { build as esbuild } from "esbuild";
 import { existsSync as existsSync7 } from "node:fs";
 import { readFile as readFile26, writeFile as writeFile7, unlink, mkdir as mkdir7 } from "node:fs/promises";
-import { basename as basename11, join as join29, dirname as dirname11, resolve as resolve12, relative as relative16, isAbsolute as isAbsolute4 } from "node:path";
+import { basename as basename11, join as join30, dirname as dirname11, resolve as resolve12, relative as relative16, isAbsolute as isAbsolute4 } from "node:path";
 import { tmpdir as tmpdir2 } from "node:os";
-import { createHash as createHash7, randomUUID as randomUUID3 } from "node:crypto";
-import { pathToFileURL as pathToFileURL2 } from "node:url";
+import { createHash as createHash8, randomUUID as randomUUID3 } from "node:crypto";
+import { pathToFileURL as pathToFileURL3 } from "node:url";
 async function runDev(root, opts, configPath) {
   const config = await loadConfig(root, configPath);
   const file = configFileOf(root, configPath);
@@ -9336,6 +10023,7 @@ async function runBuild(root, configPath, options) {
     outDir,
     ...options.base !== void 0 ? { basePath: options.base } : {},
     ...options.audit !== void 0 ? { audit: options.audit } : {},
+    ...options.browser ? { browser: true } : {},
     pdVersion: options.pdVersion,
     log: (line) => console.log(`[pd build] ${line}`)
   });
@@ -9343,16 +10031,24 @@ async function runBuild(root, configPath, options) {
   console.log(`[pd build] ${report.components} components \u2192 ${report.files} files, ${mb} MB in ${report.ms} ms`);
   console.log(`[pd build] ${report.outDir}  (served from ${report.basePath})`);
   if (report.storefront) {
-    console.log(`[pd build] storefront: ${report.storefront.pages} pages \u2192 ${report.storefront.files} files in ${report.storefront.outDir}  (served from /)`);
+    console.log(`[pd build] storefront: ${report.storefront.pages} pages \u2192 ${report.storefront.files} files in ${report.storefront.outDir}  (served from ${report.storefront.basePath})`);
   }
   if (report.links) {
     console.log(`[pd build] links: ${report.links.references} references on ${report.links.pages} pages, none broken` + (report.links.external ? `; ${report.links.external} external, not checked (notes)` : ""));
   }
   if (report.accessibility) {
     const n = report.accessibility.warnings.length;
-    console.log(`[pd build] accessibility: ${report.accessibility.pages} pages, no errors` + (n ? `; ${n} rule${n === 1 ? "" : "s"} with warnings:` : ""));
+    console.log(`[pd build] accessibility: ${report.accessibility.pages} pages${report.accessibility.browser ? ", in jsdom and Chromium" : ""}, no errors` + (n ? `; ${n} rule${n === 1 ? "" : "s"} with warnings:` : ""));
     for (const w of report.accessibility.warnings) console.log(`[pd build]   warning: ${w}`);
   }
+  if (report.images) {
+    const n = report.images.warnings.length;
+    console.log(`[pd build] images: ${n ? `${n} with a variant that doesn't fit:` : "every variant fits its box"}`);
+    for (const w of report.images.warnings) console.log(`[pd build]   warning: ${w}`);
+  }
+  if (report.drafts) {
+    console.log(`[pd build] drafts: ${report.drafts.length} left out (${report.drafts.join(", ")})`);
+  }
   for (const w of report.warnings) console.log(`[pd build]   not built: ${w}`);
   for (const n of report.notes) console.log(`[pd build]   note: ${n}`);
 }
@@ -9361,7 +10057,7 @@ async function runAudit(root, configPath, format = "md") {
   const { graph, reaudited, reused, artifactPath, imageWarning } = await runDiagnosticsAudit(config, root);
   const report = formatAudit(graph, format);
   const ext = format === "json" ? "json" : format === "text" ? "txt" : "md";
-  const reportPath = join29(dirname11(artifactPath), `diagnostics-report.${ext}`);
+  const reportPath = join30(dirname11(artifactPath), `diagnostics-report.${ext}`);
   await writeFile7(reportPath, report, "utf-8");
   console.log(report);
   const meta = format === "json" ? console.error : console.log;
@@ -9379,8 +10075,8 @@ function auditSummaryLines(r) {
   ];
 }
 function defaultExportDir(root) {
-  const key = createHash7("sha1").update(resolve12(root)).digest("hex").slice(0, 16);
-  return join29(tmpdir2(), "pattern-dump", key, "export");
+  const key = createHash8("sha1").update(resolve12(root)).digest("hex").slice(0, 16);
+  return join30(tmpdir2(), "pattern-dump", key, "export");
 }
 function assertOutsideRoot(outDir, root) {
   const rel = relative16(resolve12(root), resolve12(outDir));
@@ -9457,18 +10153,30 @@ async function loadConfig(root, configPath) {
     if (!existsSync7(configPath)) {
       throw new ConfigError(`--config file not found: ${configPath}`);
     }
-    return validateConfig(await readConfigFile(configPath), configPath);
+    return validateConfig(await withRootManifest(root, await readConfigFile(configPath), configPath), configPath);
   }
   const path = configFileOf(root);
-  if (path) return validateConfig(await readConfigFile(path), basename11(path));
+  if (path) return validateConfig(await withRootManifest(root, await readConfigFile(path), basename11(path)), basename11(path));
   throw new ConfigError(
     `No pattern-dump.config.ts or pattern-dump.config.json found in ${root} (and no --config given)`
   );
 }
+async function withRootManifest(root, raw, configName) {
+  const pkgPath = join30(root, "package.json");
+  if (!existsSync7(pkgPath)) return raw;
+  let pkg;
+  try {
+    pkg = JSON.parse(await readFile26(pkgPath, "utf-8"));
+  } catch {
+    return raw;
+  }
+  const manifest = typeof pkg === "object" && pkg !== null ? pkg.patternDump : void 0;
+  return manifest === void 0 ? raw : withOwnManifest(raw, manifest, { config: configName, manifest: "package.json" });
+}
 function configFileOf(root, configPath) {
   if (configPath) return configPath;
   for (const name of CONFIG_NAMES) {
-    const path = join29(root, name);
+    const path = join30(root, name);
     if (existsSync7(path)) return path;
   }
   return void 0;
@@ -9478,7 +10186,7 @@ async function readConfigFile(path) {
   return path.endsWith(".json") ? JSON.parse(await readFile26(path, "utf-8")) : loadTsConfig(path);
 }
 async function loadTsConfig(tsPath) {
-  const tmp = join29(tmpdir2(), `pd-config-${process.pid}-${randomUUID3()}.mjs`);
+  const tmp = join30(tmpdir2(), `pd-config-${process.pid}-${randomUUID3()}.mjs`);
   try {
     await esbuild({
       entryPoints: [tsPath],
@@ -9488,7 +10196,7 @@ async function loadTsConfig(tsPath) {
       // No packages:"external" — the temp file runs from /tmp so we must inline deps.
       outfile: tmp
     });
-    const { default: cfg } = await import(pathToFileURL2(tmp).href);
+    const { default: cfg } = await import(pathToFileURL3(tmp).href);
     return cfg;
   } finally {
     await unlink(tmp).catch(() => {
@@ -9568,7 +10276,8 @@ function parseCommand(argv, cwd) {
           out: { type: "string" },
           base: { type: "string" },
           audit: { type: "boolean" },
-          "no-audit": { type: "boolean" }
+          "no-audit": { type: "boolean" },
+          browser: { type: "boolean" }
         }
       });
       if (values2.help) return { kind: "help", topic: cmd };
@@ -9579,7 +10288,8 @@ function parseCommand(argv, cwd) {
         ...base(values2, cwd),
         ...values2.out !== void 0 ? { out: values2.out } : {},
         ...values2.base !== void 0 ? { base: values2.base } : {},
-        ...audit !== void 0 ? { audit } : {}
+        ...audit !== void 0 ? { audit } : {},
+        ...values2.browser ? { browser: true } : {}
       };
     }
     const { values } = parseArgs({
@@ -9676,6 +10386,9 @@ var USAGE = `Usage: pd <command> [options]
     --config <path>    Use a config file outside the root
     --out <dir>        Output folder, relative to the root (default: build.outDir, outDir, or dist)
     --base <path>      Where it will be hosted: / (default) or a subpath such as /docs/
+    --browser          Also check the storefront's pages in Chromium: contrast and the accessibility
+                       rules that need a rendered page, and each image's variant against its size.
+                       Uses the project's own Playwright (npm install --save-dev playwright)
     --no-audit         Leave the corpus audit out: it is not run, and the site has no Audit tab
                        (default: build.audit in the config; --audit forces it back in)
 
@@ -9689,12 +10402,12 @@ var USAGE = `Usage: pd <command> [options]
 // packages/cli/src/init/run.ts
 import { existsSync as existsSync8 } from "node:fs";
 import { readFile as readFile28 } from "node:fs/promises";
-import { basename as basename12, dirname as dirname13, join as join31, relative as relative18, resolve as resolve14 } from "node:path";
+import { basename as basename12, dirname as dirname13, join as join32, relative as relative18, resolve as resolve14 } from "node:path";
 
 // packages/cli/package.json
 var package_default = {
   name: "@pattern-dump/cli",
-  version: "0.3.0",
+  version: "0.4.0",
   private: true,
   description: "The pd command and the published pattern-dump package.",
   type: "module",
@@ -9730,12 +10443,12 @@ var PD_VERSION = package_default.version;
 
 // packages/cli/src/init/files.ts
 import { mkdir as mkdir8, readdir as readdir10, readFile as readFile27, writeFile as writeFile8 } from "node:fs/promises";
-import { dirname as dirname12, join as join30, relative as relative17, sep as sep12 } from "node:path";
+import { dirname as dirname12, join as join31, relative as relative17, sep as sep12 } from "node:path";
 async function readTemplateDir(dir) {
   const out = [];
   async function walk(current) {
     for (const entry of await readdir10(current, { withFileTypes: true })) {
-      const full = join30(current, entry.name);
+      const full = join31(current, entry.name);
       if (entry.isDirectory()) await walk(full);
       else out.push({ path: relative17(dir, full).split(sep12).join("/"), content: await readFile27(full, "utf8") });
     }
@@ -9744,11 +10457,11 @@ async function readTemplateDir(dir) {
   return out.sort((a, b) => a.path.localeCompare(b.path));
 }
 async function readTemplates(templatesDir) {
-  const fill = (name) => readFile27(join30(templatesDir, "storefront-fills", name), "utf8");
+  const fill = (name) => readFile27(join31(templatesDir, "storefront-fills", name), "utf8");
   const [base2, examples, storefront, config, readme, gitignore] = await Promise.all([
-    readTemplateDir(join30(templatesDir, "base")),
-    readTemplateDir(join30(templatesDir, "examples")),
-    readTemplateDir(join30(templatesDir, "storefront")),
+    readTemplateDir(join31(templatesDir, "base")),
+    readTemplateDir(join31(templatesDir, "examples")),
+    readTemplateDir(join31(templatesDir, "storefront")),
     fill("config.txt"),
     fill("readme.md"),
     fill("gitignore.txt")
@@ -9758,12 +10471,12 @@ async function readTemplates(templatesDir) {
 async function applyPlan(target, plan) {
   await mkdir8(target, { recursive: true });
   for (const file of plan.writes) {
-    const abs = join30(target, file.path);
+    const abs = join31(target, file.path);
     await mkdir8(dirname12(abs), { recursive: true });
     await writeFile8(abs, file.content, { flag: "wx" });
   }
-  await writeFile8(join30(target, "package.json"), plan.packageJson.content);
-  for (const dir of ["assets", "src/patterns"]) await mkdir8(join30(target, dir), { recursive: true });
+  await writeFile8(join31(target, "package.json"), plan.packageJson.content);
+  for (const dir of ["assets", "src/patterns"]) await mkdir8(join31(target, dir), { recursive: true });
 }
 
 // packages/cli/src/init/plan.ts
@@ -9885,7 +10598,7 @@ async function runInit(cmd, io) {
   } else {
     dependency = dependencySpec(void 0, io.cwd);
   }
-  const pkgPath = join31(target, "package.json");
+  const pkgPath = join32(target, "package.json");
   let packageJson = null;
   if (existsSync8(pkgPath)) {
     try {
@@ -9906,7 +10619,7 @@ async function runInit(cmd, io) {
   const install = cmd.install ?? (prompt ? await io.confirm("Run npm install", true) : true);
   const answers = { name, brand, examples, storefront, dependency };
   const templates = await readTemplates(io.templatesDir);
-  const result = planInit(templates, answers, { packageJson, exists: (p) => existsSync8(join31(target, p)) }, PD_PACKAGE_NAME);
+  const result = planInit(templates, answers, { packageJson, exists: (p) => existsSync8(join32(target, p)) }, PD_PACKAGE_NAME);
   if (!result.ok) {
     io.log(`\u2717 ${result.reason}`);
     return 1;
@@ -9955,7 +10668,7 @@ async function runInit(cmd, io) {
 
 // packages/cli/src/init/local-build.ts
 import { existsSync as existsSync9, statSync as statSync5 } from "node:fs";
-import { join as join32 } from "node:path";
+import { join as join33 } from "node:path";
 import { fileURLToPath as fileURLToPath7 } from "node:url";
 var BUILT = [
   "packages/cli/dist/index.js",
@@ -9973,10 +10686,10 @@ var mtime = (path) => {
 };
 function detectLocalBuild(moduleUrl, packageName, version) {
   const repo = fileURLToPath7(new URL("../../../", moduleUrl)).replace(/[\\/]$/, "");
-  if (!existsSync9(join32(repo, "packages/cli/src/distribution.ts"))) return null;
-  const tarball = join32(repo, ".pd-pack", `${packageName}-${version}.tgz`);
+  if (!existsSync9(join33(repo, "packages/cli/src/distribution.ts"))) return null;
+  const tarball = join33(repo, ".pd-pack", `${packageName}-${version}.tgz`);
   if (!existsSync9(tarball)) return { repo, tarball: null, stale: false };
-  const newestBuild = Math.max(...BUILT.map((p) => mtime(join32(repo, p))));
+  const newestBuild = Math.max(...BUILT.map((p) => mtime(join33(repo, p))));
   return { repo, tarball, stale: newestBuild > mtime(tarball) };
 }
 
@@ -10043,6 +10756,7 @@ switch (command.kind) {
       ...command.out !== void 0 ? { out: command.out } : {},
       ...command.base !== void 0 ? { base: command.base } : {},
       ...command.audit !== void 0 ? { audit: command.audit } : {},
+      ...command.browser ? { browser: true } : {},
       pdVersion: PD_VERSION
     }).then(() => process.stdout.write("", () => process.exit(0))).catch((e) => {
       console.error("[pd] Error:", e instanceof Error ? e.message : e);