gutterpress 0.10.9 → 0.10.10-alpha.2

package/dist/{index-mey5vraz.js → index-1he93sjd.js}

@@ -18,7 +18,7 @@ import {
   resolveChromiumExecutable,
   run,
   spawnCapture
-} from "./index-zwcv1njy.js";
+} from "./index-5dgxeevv.js";
 import {
   gitFs,
   gitScopeFor,
@@ -29,7 +29,7 @@ import {
   snapshotStagingMarkerPath,
   snapshotWorkingTreeUnlocked,
   withRepoLock
-} from "./index-dtrftayr.js";
+} from "./index-y01v2fe0.js";
 import {
   detectProjectSource,
   syncRemoteFor
@@ -58,6 +58,27 @@ import { lstat, readFile, readdir, realpath } from "node:fs/promises";
 import path from "node:path";
 import { exports as resolveExports } from "resolve.exports";
 import { satisfies, validRange } from "semver";
+
+// src/lib/npm-registry.ts
+var DEFAULT_NPM_REGISTRY = "https://registry.npmjs.org";
+var ENV_OVERRIDE = "GUTTERPRESS_NPM_REGISTRY";
+function npmRegistryUrl() {
+  const configured = process.env[ENV_OVERRIDE]?.trim();
+  if (!configured)
+    return DEFAULT_NPM_REGISTRY;
+  let scheme;
+  try {
+    scheme = new URL(configured).protocol;
+  } catch {
+    throw new Error(`Invalid ${ENV_OVERRIDE} URL "${configured}".`);
+  }
+  if (scheme !== "http:" && scheme !== "https:") {
+    throw new Error(`${ENV_OVERRIDE} must be an http(s) URL — got "${scheme}".`);
+  }
+  return configured.replace(/\/+$/, "");
+}
+
+// src/lib/plugin-vendor.ts
 var PLUGINS_DIR = "plugins";
 var VENDORED_NPM_DIR = "npm";
 var VENDOR_RECEIPT_FILE = ".gutterpress-install.json";
@@ -529,7 +550,7 @@ async function verifyVendoredPlugin(projectDir, expectedName, expectedVersion) {
         throw new Error(`Package receipt is missing provenance: ${pkg.name}@${pkg.version}`);
       }
       const tarball = new URL(pkg.tarball);
-      if (tarball.origin !== "https://registry.npmjs.org" || tarball.username || tarball.password) {
+      if (tarball.origin !== new URL(npmRegistryUrl()).origin || tarball.username || tarball.password) {
         throw new Error(`Package receipt has an invalid tarball URL: ${pkg.name}@${pkg.version}`);
       }
       const packageDir = path.resolve(installRoot, ...relative.split("/"));
@@ -3637,7 +3658,7 @@ async function renderChaptersToFile(inputDir, outDir, opts = {}) {
 
 // src/lib/markdown/plugins.ts
 import { createHash as createHash3 } from "node:crypto";
-import { existsSync as existsSync5, lstatSync, realpathSync, rmSync, statSync as statSync2, unlinkSync } from "node:fs";
+import { existsSync as existsSync4, lstatSync, realpathSync, rmSync, statSync as statSync2, unlinkSync } from "node:fs";
 import { cp, link, mkdir as mkdir2, mkdtemp, readFile as readFile6, rm, unlink, writeFile as writeFile2 } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { resolve as resolve3, join as join2, dirname as dirname2, basename, extname, relative, isAbsolute } from "node:path";
@@ -3663,25 +3684,46 @@ function resolveDeclaredStyles(rawStyles, baseDir, subject) {
 }
 
 // src/lib/extension-manifest.ts
-import { existsSync as existsSync4 } from "node:fs";
 import { readFile as readFile5 } from "node:fs/promises";
 import path4 from "node:path";
-var EXTENSION_MANIFEST_FILENAME = "gutterpress.json";
-var LEGACY_THEME_MANIFEST_FILENAME = "theme.json";
-async function readJsonMetaFile(jsonPath) {
-  try {
-    const parsed = JSON.parse(await readFile5(jsonPath, "utf8"));
-    return parsed && typeof parsed === "object" ? parsed : {};
-  } catch {
+var EXTENSION_MANIFEST_FILENAME = "package.json";
+var GUTTERPRESS_KEY = "gutterpress";
+function object2(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+function str(value) {
+  return typeof value === "string" ? value : undefined;
+}
+function authorName(value) {
+  return str(value) ?? str(object2(value)?.name);
+}
+function metaFromPackageJson(raw) {
+  const pkg = object2(raw);
+  if (!pkg)
     return {};
-  }
+  const gp = object2(pkg[GUTTERPRESS_KEY]) ?? {};
+  const keywords = Array.isArray(pkg.keywords) ? pkg.keywords.filter((k) => typeof k === "string") : undefined;
+  return {
+    ...str(pkg.name) ? { name: str(pkg.name) } : {},
+    ...authorName(pkg.author) ? { author: authorName(pkg.author) } : {},
+    ...str(pkg.description) ? { description: str(pkg.description) } : {},
+    ...keywords ? { keywords } : {},
+    ...str(pkg.main) ? { main: str(pkg.main) } : {},
+    ..."preview" in gp ? { preview: str(gp.preview) ?? null } : {},
+    ...Array.isArray(gp.styles) ? { styles: declaredList(gp.styles) } : {},
+    ...str(gp.tokensFile) ? { tokensFile: str(gp.tokensFile) } : {},
+    ...str(gp.markdown) ? { markdown: str(gp.markdown) } : {},
+    ...str(gp.components) ? { components: str(gp.components) } : {},
+    ...str(gp.snippets) ? { snippets: str(gp.snippets) } : {},
+    ...gp.engineStyles !== undefined ? { engineStyles: gp.engineStyles } : {}
+  };
 }
 async function readExtensionMeta(dir) {
-  const extensionPath = path4.join(dir, EXTENSION_MANIFEST_FILENAME);
-  if (existsSync4(extensionPath)) {
-    return readJsonMetaFile(extensionPath);
+  try {
+    return metaFromPackageJson(JSON.parse(await readFile5(path4.join(dir, EXTENSION_MANIFEST_FILENAME), "utf8")));
+  } catch {
+    return {};
   }
-  return readJsonMetaFile(path4.join(dir, LEGACY_THEME_MANIFEST_FILENAME));
 }
 function declaredList(value) {
   return Array.isArray(value) ? value.filter((s) => typeof s === "string" && s.trim().length > 0) : [];
@@ -3689,16 +3731,13 @@ function declaredList(value) {
 function extensionStyleList(meta) {
   return declaredList(meta.styles);
 }
-function extensionStyleListWithDefault(meta, dir) {
-  const declared = extensionStyleList(meta);
-  if (declared.length > 0)
-    return declared;
-  return existsSync4(path4.join(dir, "theme.css")) ? ["theme.css"] : [];
+function extensionEntry(meta) {
+  return meta.markdown?.trim() || meta.main?.trim() || undefined;
 }
-function extensionCarries(meta, dir) {
+function extensionCarries(meta) {
   return {
-    markdown: !!meta.markdown?.trim(),
-    styles: extensionStyleListWithDefault(meta, dir).length > 0,
+    markdown: !!extensionEntry(meta),
+    styles: extensionStyleList(meta).length > 0,
     snippets: !!meta.snippets?.trim(),
     components: !!meta.components?.trim()
   };
@@ -3710,9 +3749,10 @@ function assertExtensionContained(meta) {
   if (meta.engineStyles !== undefined) {
     throw new Error("The extension's metadata declares `engineStyles`, which was removed — " + "move its entries to the end of `styles`.");
   }
+  const entry = extensionEntry(meta);
   const declared = [
     ...extensionStyleList(meta),
-    ...meta.markdown ? [meta.markdown] : [],
+    ...entry ? [entry] : [],
     ...meta.components ? [meta.components] : [],
     ...meta.snippets ? [meta.snippets] : [],
     ...meta.tokensFile ? [meta.tokensFile] : []
@@ -3724,8 +3764,9 @@ function assertExtensionContained(meta) {
   }
 }
 function resolveExtension(dir, meta, subject) {
-  const styles = resolveDeclaredStyles(extensionStyleListWithDefault(meta, dir), dir, subject);
-  const [markdown] = resolveDeclaredStyles(meta.markdown ? [meta.markdown] : undefined, dir, subject) ?? [];
+  const entry = extensionEntry(meta);
+  const styles = resolveDeclaredStyles(extensionStyleList(meta), dir, subject);
+  const [markdown] = resolveDeclaredStyles(entry ? [entry] : undefined, dir, subject) ?? [];
   const [components] = resolveDeclaredStyles(meta.components ? [meta.components] : undefined, dir, subject) ?? [];
   const [snippets] = resolveDeclaredStyles(meta.snippets ? [meta.snippets] : undefined, dir, subject) ?? [];
   return {
@@ -3973,9 +4014,9 @@ function isReceiptBoundRequireCall(node) {
     return true;
   if (callee.type !== "MemberExpression")
     return false;
-  const object2 = callee.object;
+  const object3 = callee.object;
   const property = memberName(callee);
-  return Boolean(object2 && (object2.type === "Identifier" && object2.name === "module" && property === "require" || object2.type === "Identifier" && object2.name === "require" && property === "resolve"));
+  return Boolean(object3 && (object3.type === "Identifier" && object3.name === "module" && property === "require" || object3.type === "Identifier" && object3.name === "require" && property === "resolve"));
 }
 function rewriteCommonJsRequires(source, absolute, pkg, tree) {
   const ast = parseJavaScript(source, {
@@ -4391,6 +4432,22 @@ function extensionMetadata(meta) {
     ...meta.author ? { author: meta.author } : {}
   };
 }
+function staleManifestHint(dir) {
+  const stale = ["gutterpress.json", "theme.json"].find((name) => existsSync4(join2(dir, name)));
+  if (!stale)
+    return "";
+  return `
+
+This folder still has a ${stale}. Gutterpress no longer reads it — ` + `describe the extension in package.json instead:
+  {
+    "name": "my-extension",
+    "description": "What it does",
+    "author": "You",
+    "main": "plugin.js",
+    "gutterpress": { "styles": ["theme.css"] }
+  }
+(\`main\` only if the package carries a markdown-it plugin; \`gutterpress.styles\` only if it carries stylesheets.)`;
+}
 async function loadExtensionFromDir(extensionDir, config, pluginRef) {
   const meta = await readExtensionMeta(extensionDir);
   assertExtensionContained(meta);
@@ -4398,7 +4455,7 @@ async function loadExtensionFromDir(extensionDir, config, pluginRef) {
   const extensionStyles = resolved.styles ?? [];
   const name = config.name ?? meta.name ?? pluginRef;
   if (!resolved.markdown && extensionStyles.length === 0) {
-    throw new Error(`Extension folder "${pluginRef}" declares neither \`markdown\` nor \`styles\` ` + "(in its gutterpress.json or theme.json) — there is nothing to load. Point " + "`path` at a JS file directly for a plain plugin, or add a metadata file declaring at least one.");
+    throw new Error(`Extension folder "${pluginRef}" declares no markdown-it plugin (\`main\`) and no ` + "`gutterpress.styles` in its package.json — there is nothing to load. Point " + "`path` at a JS file directly for a plain plugin, or describe the package in package.json." + staleManifestHint(extensionDir));
   }
   if (!resolved.markdown) {
     return {
@@ -4442,7 +4499,7 @@ async function loadPlugin(config, baseDir) {
   }
   if (config.path) {
     const candidatePath = resolve3(baseDir, config.path);
-    if (existsSync5(candidatePath) && statSync2(candidatePath).isDirectory()) {
+    if (existsSync4(candidatePath) && statSync2(candidatePath).isDirectory()) {
       try {
         return await loadExtensionFromDir(candidatePath, config, pluginRef);
       } catch (error2) {
@@ -4454,7 +4511,7 @@ async function loadPlugin(config, baseDir) {
   try {
     if (config.path) {
       const pluginPath = resolve3(baseDir, config.path);
-      if (!existsSync5(pluginPath)) {
+      if (!existsSync4(pluginPath)) {
         throw new Error(`Plugin file not found: ${pluginPath} (resolved from manifest entry path="${config.path}")`);
       }
       pluginModule = await loadCachedPathPluginModule(pluginPath);
@@ -4465,12 +4522,12 @@ async function loadPlugin(config, baseDir) {
       pluginModule = loaded.module;
       moduleDir = loaded.moduleDir;
       pluginName = config.name;
-      if (loaded.packageDir && (existsSync5(join2(loaded.packageDir, EXTENSION_MANIFEST_FILENAME)) || existsSync5(join2(loaded.packageDir, LEGACY_THEME_MANIFEST_FILENAME)))) {
+      if (loaded.packageDir) {
         const meta = await readExtensionMeta(loaded.packageDir);
         assertExtensionContained(meta);
-        const resolved = resolveExtension(loaded.packageDir, meta, `Plugin "${pluginRef}"`);
+        const resolved = resolveExtension(loaded.packageDir, { ...meta, main: undefined }, `Plugin "${pluginRef}"`);
         if (resolved.markdown && loaded.entryPath && resolve3(resolved.markdown) !== resolve3(loaded.entryPath)) {
-          throw new Error(`its gutterpress.json declares markdown "${meta.markdown}" but the package entry is "${relative(loaded.packageDir, loaded.entryPath)}" — an npm extension's markdown-it ` + "plugin is its package entry, so declare that file or drop the field.");
+          throw new Error(`its package.json declares gutterpress.markdown "${meta.markdown}" but the package entry is "${relative(loaded.packageDir, loaded.entryPath)}" — an npm extension's ` + "markdown-it plugin is its package entry, so declare that file or drop the field.");
         }
         packageMeta = meta;
         packageStyles = resolved.styles ?? [];
@@ -4546,7 +4603,7 @@ function artifactName(title, format) {
 }
 
 // src/lib/ghostscript.ts
-import { existsSync as existsSync6 } from "node:fs";
+import { existsSync as existsSync5 } from "node:fs";
 import { readFile as readFile7, writeFile as writeFile3, unlink as unlink2, rename, readdir as readdir4 } from "node:fs/promises";
 import { join as join3, basename as basename2, resolve as resolve4 } from "node:path";
 var WINDOWS_GHOSTSCRIPT_NAMES = ["gswin64c", "gswin32c", "gs"];
@@ -4581,7 +4638,7 @@ async function findWindowsGhostscriptInstall(env) {
     for (const version of versions) {
       for (const executable of ["gswin64c.exe", "gswin32c.exe"]) {
         const candidate = join3(installRoot, version.name, "bin", executable);
-        if (existsSync6(candidate))
+        if (existsSync5(candidate))
           return candidate;
       }
     }
@@ -4590,7 +4647,7 @@ async function findWindowsGhostscriptInstall(env) {
 }
 async function resolveGhostscript(targetPlatform = process.platform, env = process.env) {
   const override = envValue(env, "GHOSTSCRIPT_PATH");
-  if (override && existsSync6(override))
+  if (override && existsSync5(override))
     return override;
   const names = targetPlatform === "win32" ? WINDOWS_GHOSTSCRIPT_NAMES : POSIX_GHOSTSCRIPT_NAMES;
   for (const name of names) {
@@ -4782,7 +4839,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.10.9",
+  version: "0.10.10-alpha.2",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -5051,491 +5108,163 @@ async function writeBuildFingerprint(input) {
   return outPath;
 }
 
-// src/lib/lint-runner.ts
-import { resolve as resolve5 } from "node:path";
-import { readFile as readFile9 } from "node:fs/promises";
+// src/lib/validation-exec.ts
+import { existsSync as existsSync10 } from "node:fs";
+import { dirname as dirname4, join as join4, resolve as resolve8 } from "node:path";
 
-// src/lib/printsafe.ts
-import postcss2 from "postcss";
-var ruleRemoteUrls = "printsafe/no-remote-urls";
-var ruleRiskyProps = "printsafe/no-risky-print-effects";
-var ruleSyntax = "printsafe/syntax-error";
-var rulePageContainment = "printsafe/page-containment";
-function extractUrls(value) {
-  const urls = [];
-  const re = /url\(\s*(['"]?)(.*?)\1\s*\)/gi;
-  let m;
-  while (m = re.exec(value))
-    urls.push(m[2] ?? "");
-  return urls;
+// src/checks/formatter.ts
+function formatReport(report, format = "text") {
+  if (format === "json") {
+    formatJson(report);
+  } else {
+    formatText(report);
+  }
 }
-function isRemoteUrl(url) {
-  const lower = url.trim().toLowerCase();
-  return lower.startsWith("http://") || lower.startsWith("https://") || lower.startsWith("//");
+function formatText(report) {
+  for (const r of report.infos) {
+    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
+    log.info(`${loc}${r.message}`);
+    if (r.detail)
+      log.info(`  ${r.detail}`);
+  }
+  for (const r of report.warnings) {
+    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
+    log.warn(`${loc}${r.message}`);
+    if (r.detail)
+      log.warn(`  ${r.detail}`);
+  }
+  for (const r of report.errors) {
+    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
+    log.error(`${loc}${r.message}`);
+    if (r.detail)
+      log.error(`  ${r.detail}`);
+  }
+  const { summary } = report;
+  if (summary.errors > 0) {
+    log.error(`VALIDATION FAILED (${summary.errors} error${summary.errors > 1 ? "s" : ""})`);
+  } else if (summary.warnings > 0) {
+    log.warn("VALIDATION PASSED (with warnings)");
+  } else {
+    log.success("VALIDATION PASSED");
+  }
 }
-var riskyProperties = new Set([
-  "filter",
-  "backdrop-filter",
-  "mix-blend-mode",
-  "background-blend-mode",
-  "animation",
-  "animation-name",
-  "transition",
-  "will-change",
-  "clip-path"
-]);
-var marginBoxAtRuleNames = new Set([
-  "top-left-corner",
-  "top-left",
-  "top-center",
-  "top-right",
-  "top-right-corner",
-  "bottom-left-corner",
-  "bottom-left",
-  "bottom-center",
-  "bottom-right",
-  "bottom-right-corner",
-  "left-top",
-  "left-middle",
-  "left-bottom",
-  "right-top",
-  "right-middle",
-  "right-bottom"
-]);
-var marginBoxIgnoredProperties = MARGIN_BOX_IGNORED_PROPERTIES;
-function isInPageBox(decl) {
-  const page = decl.parent;
-  return !!page && page.type === "atrule" && page.name.toLowerCase() === "page";
+function targetPrefix(target) {
+  return target ? `[${target}] ` : "";
 }
-function isDroppedPageGradient(decl) {
-  const prop = decl.prop.toLowerCase();
-  if (prop !== "background" && prop !== "background-image")
-    return false;
-  if (!/(^|[\s,(])[\w-]*gradient\(/i.test(decl.value))
-    return false;
-  return isInPageBox(decl);
+function formatJson(report) {
+  console.log(JSON.stringify({
+    results: report.results,
+    summary: report.summary,
+    passed: report.passed
+  }, null, 2));
 }
-function isInPageMarginBox(decl) {
-  const box = decl.parent;
-  if (!box || box.type !== "atrule")
-    return false;
-  if (!marginBoxAtRuleNames.has(box.name.toLowerCase()))
-    return false;
-  const page = box.parent;
-  return !!page && page.type === "atrule" && page.name.toLowerCase() === "page";
+function formatLocation(file, line, column) {
+  if (!file)
+    return "";
+  let loc = `${file}`;
+  if (line != null) {
+    loc += `:${line}`;
+    if (column != null)
+      loc += `:${column}`;
+  }
+  return `${loc}: `;
 }
-function isUnpairedFitContentWidth(decl) {
-  const prop = decl.prop.toLowerCase();
-  if (prop !== "width" && prop !== "inline-size")
-    return false;
-  if (!/\bfit-content\b/i.test(decl.value))
-    return false;
-  if (!isInPageMarginBox(decl))
+
+// src/checks/registry.ts
+var checks = new Map;
+function registerCheck(check) {
+  checks.set(check.id, check);
+  return () => {
+    if (checks.get(check.id) === check)
+      checks.delete(check.id);
+  };
+}
+function getChecks(filter) {
+  let result = Array.from(checks.values());
+  if (filter?.category) {
+    const cats = Array.isArray(filter.category) ? filter.category : [filter.category];
+    result = result.filter((c) => cats.includes(c.category));
+  }
+  if (filter?.phase) {
+    result = result.filter((c) => c.phase === filter.phase);
+  }
+  if (filter?.ids) {
+    const idSet = new Set(filter.ids);
+    result = result.filter((c) => idSet.has(c.id));
+  }
+  return result;
+}
+function getCheckById(id) {
+  return checks.get(id);
+}
+function getKnownCategories() {
+  const categories = new Set;
+  for (const check of checks.values()) {
+    categories.add(check.category);
+  }
+  return Array.from(categories);
+}
+function resolveCheckSelectors(selectors) {
+  const allChecks = Array.from(checks.values());
+  const resolved = [];
+  const unmatched = [];
+  const seen = new Set;
+  for (const rawSelector of selectors) {
+    const selector = rawSelector.trim();
+    if (!selector)
+      continue;
+    const matcher = selector.includes("*") ? selectorToRegex(selector) : undefined;
+    let matchedAny = false;
+    for (const check of allChecks) {
+      const matched = matcher ? matcher.test(check.id) : check.id === selector;
+      if (!matched)
+        continue;
+      matchedAny = true;
+      if (seen.has(check.id))
+        continue;
+      seen.add(check.id);
+      resolved.push(check.id);
+    }
+    if (!matchedAny)
+      unmatched.push(selector);
+  }
+  return { resolved, unmatched };
+}
+function selectorToRegex(selector) {
+  const escaped = selector.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/\\\*/g, ".*");
+  return new RegExp(`^${escaped}$`);
+}
+
+// src/checks/policy.ts
+var INSPECT_FAILED_CODE = "inspect-failed";
+function isCheckEnabled(check, config) {
+  const entry = config.validate.checks[check.id];
+  if (entry === false)
     return false;
-  const siblings = decl.parent.nodes ?? [];
-  const decls = siblings.filter((n) => n.type === "decl");
-  if (decls.some((d) => ["height", "block-size"].includes(d.prop.toLowerCase())))
+  if (typeof entry === "object" && entry.enabled === false)
     return false;
-  if (decls.some((d) => /gradient\(/i.test(d.value)))
+  if (check.enabledWhen && !check.enabledWhen(config))
     return false;
   return true;
 }
-function targetsPageWrapper(selector) {
-  if (!/\.(page|spread)(?![\w-])/.test(selector))
-    return false;
-  return !/\bgp-(bleed|pin)\b/.test(selector);
-}
-var cssWideResetKeywords = new Set(["initial", "unset", "revert", "revert-layer"]);
-var inertValues = {
-  "z-index": new Set(["auto"]),
-  opacity: new Set(["1", "100%"]),
-  "mix-blend-mode": new Set(["normal"]),
-  "background-blend-mode": new Set(["normal"]),
-  filter: new Set(["none"]),
-  "backdrop-filter": new Set(["none"]),
-  transform: new Set(["none"]),
-  rotate: new Set(["none"]),
-  translate: new Set(["none"]),
-  scale: new Set(["none"]),
-  perspective: new Set(["none"]),
-  "box-shadow": new Set(["none"]),
-  outline: new Set(["none"]),
-  "outline-style": new Set(["none"]),
-  "will-change": new Set(["auto", "none"]),
-  "clip-path": new Set(["none"]),
-  transition: new Set(["none"]),
-  animation: new Set(["none"]),
-  "animation-name": new Set(["none"]),
-  overflow: new Set(["visible"]),
-  "overflow-x": new Set(["visible"]),
-  "overflow-y": new Set(["visible"])
-};
-function isInertValue(prop, value) {
-  const v = value.trim().toLowerCase();
-  return cssWideResetKeywords.has(v) || (inertValues[prop]?.has(v) ?? false);
-}
-function createsStackingContext(decl) {
-  const p = decl.prop.toLowerCase();
-  const v = decl.value.trim().toLowerCase();
-  if (isInertValue(p, v))
-    return false;
-  switch (p) {
-    case "isolation":
-      return v === "isolate";
-    case "contain":
-      return /\b(paint|layout|strict|content)\b/.test(v);
-    case "z-index":
-    case "opacity":
-    case "mix-blend-mode":
-    case "filter":
-    case "backdrop-filter":
-    case "transform":
-    case "perspective":
-    case "will-change":
-      return true;
-    default:
-      return false;
-  }
-}
-function clipsDescendants(decl) {
-  const p = decl.prop.toLowerCase();
-  if (p !== "overflow" && p !== "overflow-x" && p !== "overflow-y")
-    return false;
-  const v = decl.value.trim().toLowerCase();
-  return v !== "" && !isInertValue(p, v);
-}
-function nodeLoc(node) {
-  return {
-    line: node.source?.start?.line ?? 1,
-    column: node.source?.start?.column ?? 1
-  };
-}
-function checkCss(css, from) {
-  let root;
-  try {
-    root = postcss2.parse(css, from ? { from } : undefined);
-  } catch (err) {
-    const e = err;
-    return [
-      {
-        rule: ruleSyntax,
-        severity: "error",
-        message: `CSS syntax error: ${e.reason ?? e.message ?? "unparseable"}`,
-        line: e.line ?? 1,
-        column: e.column ?? 1
-      }
-    ];
-  }
-  const warnings = [];
-  const reportRemoteUrls = (value, node) => {
-    for (const url of extractUrls(value)) {
-      if (isRemoteUrl(url)) {
-        warnings.push({
-          rule: ruleRemoteUrls,
-          severity: "error",
-          message: `Remote URL is not allowed in print CSS: ${url}`,
-          ...nodeLoc(node)
-        });
-      }
-    }
-  };
-  root.walkDecls((decl) => reportRemoteUrls(decl.value || "", decl));
-  root.walkAtRules((at) => reportRemoteUrls(at.params || "", at));
-  root.walkDecls((decl) => {
-    const prop = decl.prop.toLowerCase();
-    if (isInertValue(prop, decl.value))
-      return;
-    if (marginBoxIgnoredProperties.has(prop) && isInPageMarginBox(decl)) {
-      warnings.push({
-        rule: ruleRiskyProps,
-        severity: "warning",
-        message: `Property "${decl.prop}" is not supported in Chromium @page margin boxes and is silently ignored — the chrome renders square/unshadowed. Anything that would paint outside the box (box-shadow, outline, filter) or make it a stacking context (transform, opacity, mix-blend-mode) is dropped; text-shadow, border, border-radius, padding and background gradients all work inside the box.`,
-        ...nodeLoc(decl)
-      });
-    } else if (prop === "filter") {
-      warnings.push({
-        rule: ruleRiskyProps,
-        severity: "warning",
-        message: `Property is high-risk for print/PDF: 'filter' rasterizes its subtree to a 300 DPI bitmap in the printed PDF (text becomes unselectable, unsearchable, and inaccessible), and it dominates build time (~90% measured; 57.0s -> 6.2s over 60pp when scoped — see ENGINE.md §10). Scope it to the smallest possible selector. It also means the render-parity gate cannot see a text-only change inside it (docs/render-parity-gate.md, "Known blind spot").`,
-        ...nodeLoc(decl)
-      });
-    } else if (riskyProperties.has(prop)) {
-      warnings.push({
-        rule: ruleRiskyProps,
-        severity: "warning",
-        message: `Property is high-risk for print/PDF (can force rasterization): ${decl.prop}`,
-        ...nodeLoc(decl)
-      });
-    } else if (isDroppedPageGradient(decl)) {
-      warnings.push({
-        rule: ruleRiskyProps,
-        severity: "warning",
-        message: `"${decl.prop}: ${decl.value}" on @page paints nothing in print — Chromium drops a gradient in the @page box's own background, with no error and a valid-looking PDF. A solid colour there paints the whole sheet; the same gradient also works on "html" (it covers the content area, not the sheet) or in a margin box.`,
-        ...nodeLoc(decl)
-      });
-    } else if (isUnpairedFitContentWidth(decl)) {
-      warnings.push({
-        rule: ruleRiskyProps,
-        severity: "warning",
-        message: `"${decl.prop}: fit-content" in a @page margin box collapses only the inline axis — the box stays stretched to the full margin band, so a chip/pill renders as a tall rectangle around its text. Add "height: fit-content" (align-self / vertical-align do nothing here).`,
-        ...nodeLoc(decl)
-      });
-    }
-  });
-  root.walkRules((rule) => {
-    if (rule.parent?.type === "atrule") {
-      const at = rule.parent.name.toLowerCase();
-      if (at === "page" || marginBoxAtRuleNames.has(at))
-        return;
-    }
-    if (!targetsPageWrapper(rule.selector))
-      return;
-    rule.walkDecls((decl) => {
-      if (clipsDescendants(decl)) {
-        warnings.push({
-          rule: rulePageContainment,
-          severity: "warning",
-          message: `"${decl.prop}: ${decl.value}" on "${rule.selector}" clips out-of-flow descendants: a .gp-bleed plate is cut back to this box's width instead of reaching the sheet edge, and a .gp-behind image is cut the same way. Scope it with :has() (e.g. "${rule.selector}:not(:has(.gp-bleed, .gp-pin))") or drop it. This is an early source-only check; the build-time engine.layer.trapped audit is authoritative for the live ancestor chain.`,
-          ...nodeLoc(decl)
-        });
-      } else if (createsStackingContext(decl)) {
-        warnings.push({
-          rule: rulePageContainment,
-          severity: "warning",
-          message: `"${decl.prop}: ${decl.value}" on "${rule.selector}" makes the page box a stacking context, so a .gp-behind image is trapped inside it and paints ABOVE the page's text instead of under it. Core keeps .page/.spread at "position: relative; z-index: auto" for this reason. This is an early source-only check; the build-time engine.layer.trapped audit is authoritative for the live ancestor chain.`,
-          ...nodeLoc(decl)
-        });
-      }
-    });
-  });
-  return warnings;
-}
-
-// src/lib/lint-runner.ts
-async function runLint(opts = {}) {
-  const { glob } = await import("glob");
-  const { manifest, manifestDir } = await loadManifestWithPath(opts.manifest, {
-    explicit: opts.manifest !== undefined
-  });
-  const resolved = resolveConfig({}, manifest);
-  let files;
-  if (opts.files) {
-    files = await glob([opts.files], { nodir: true, ignore: ["**/*.min.css"] });
-  } else {
-    const relStyles = await resolveActiveStyles(manifestDir, resolved.styles);
-    const projectFiles = relStyles.map((rel) => resolve5(manifestDir, rel));
-    let pluginStylePaths = opts.pluginStylePaths;
-    if (pluginStylePaths === undefined) {
-      ({ pluginStylePaths } = await loadPluginsWithCss(resolved.extensions, manifestDir, (ref, err) => log.warn(`Skipping plugin "${ref}" for lint — ${err.message}`)));
-    }
-    files = [...projectFiles, ...pluginStylePaths].filter((f) => !f.endsWith(".min.css"));
-  }
-  if (files.length === 0) {
-    log.warn("No CSS files found to lint");
-    return { ok: true, riskyCount: 0, filesLinted: 0 };
-  }
-  log.info(`Linting ${files.length} CSS file(s)`);
-  let errorCount = 0;
-  let riskyCount = 0;
-  let linted = 0;
-  for (const file of files) {
-    let css;
-    try {
-      css = await readFile9(file, "utf8");
-    } catch (err) {
-      log.error(`  ${file}`);
-      log.error(`    cannot read stylesheet: ${err instanceof Error ? err.message : String(err)}`);
-      errorCount++;
-      continue;
-    }
-    linted++;
-    const warnings = checkCss(css, file);
-    const errors = warnings.filter((w) => w.severity === "error");
-    const risky = warnings.filter((w) => w.rule === ruleRiskyProps);
-    riskyCount += risky.length;
-    if (errors.length > 0) {
-      log.error(`  ${file}`);
-      for (const w of errors) {
-        log.error(`    ${w.line}:${w.column}  ${w.message}  (${w.rule})`);
-      }
-      errorCount += errors.length;
-    }
-    if (risky.length > 0) {
-      log.warn(`  ${file}`);
-      for (const w of risky) {
-        log.warn(`    ${w.line}:${w.column}  ${w.message}  (${w.rule})`);
-      }
-    }
-  }
-  if (errorCount > 0) {
-    log.error("CSS lint errors found");
-    return { ok: false, riskyCount, filesLinted: linted };
-  }
-  if (riskyCount > 0) {
-    log.warn(`${riskyCount} risky print properties found (may cause rasterization)`);
-  } else {
-    log.success("CSS lint passed");
-  }
-  return { ok: true, riskyCount, filesLinted: linted };
-}
-
-// src/lib/validation-exec.ts
-import { existsSync as existsSync11 } from "node:fs";
-import { dirname as dirname4, join as join4, resolve as resolve9 } from "node:path";
-
-// src/checks/formatter.ts
-function formatReport(report, format = "text") {
-  if (format === "json") {
-    formatJson(report);
-  } else {
-    formatText(report);
-  }
-}
-function formatText(report) {
-  for (const r of report.infos) {
-    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
-    log.info(`${loc}${r.message}`);
-    if (r.detail)
-      log.info(`  ${r.detail}`);
-  }
-  for (const r of report.warnings) {
-    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
-    log.warn(`${loc}${r.message}`);
-    if (r.detail)
-      log.warn(`  ${r.detail}`);
-  }
-  for (const r of report.errors) {
-    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
-    log.error(`${loc}${r.message}`);
-    if (r.detail)
-      log.error(`  ${r.detail}`);
-  }
-  const { summary } = report;
-  if (summary.errors > 0) {
-    log.error(`VALIDATION FAILED (${summary.errors} error${summary.errors > 1 ? "s" : ""})`);
-  } else if (summary.warnings > 0) {
-    log.warn("VALIDATION PASSED (with warnings)");
-  } else {
-    log.success("VALIDATION PASSED");
-  }
-}
-function targetPrefix(target) {
-  return target ? `[${target}] ` : "";
-}
-function formatJson(report) {
-  console.log(JSON.stringify({
-    results: report.results,
-    summary: report.summary,
-    passed: report.passed
-  }, null, 2));
-}
-function formatLocation(file, line, column) {
-  if (!file)
-    return "";
-  let loc = `${file}`;
-  if (line != null) {
-    loc += `:${line}`;
-    if (column != null)
-      loc += `:${column}`;
-  }
-  return `${loc}: `;
-}
-
-// src/checks/registry.ts
-var checks = new Map;
-function registerCheck(check) {
-  checks.set(check.id, check);
-  return () => {
-    if (checks.get(check.id) === check)
-      checks.delete(check.id);
-  };
-}
-function getChecks(filter) {
-  let result = Array.from(checks.values());
-  if (filter?.category) {
-    const cats = Array.isArray(filter.category) ? filter.category : [filter.category];
-    result = result.filter((c) => cats.includes(c.category));
-  }
-  if (filter?.phase) {
-    result = result.filter((c) => c.phase === filter.phase);
-  }
-  if (filter?.ids) {
-    const idSet = new Set(filter.ids);
-    result = result.filter((c) => idSet.has(c.id));
-  }
-  return result;
-}
-function getCheckById(id) {
-  return checks.get(id);
-}
-function getKnownCategories() {
-  const categories = new Set;
-  for (const check of checks.values()) {
-    categories.add(check.category);
-  }
-  return Array.from(categories);
-}
-function resolveCheckSelectors(selectors) {
-  const allChecks = Array.from(checks.values());
-  const resolved = [];
-  const unmatched = [];
-  const seen = new Set;
-  for (const rawSelector of selectors) {
-    const selector = rawSelector.trim();
-    if (!selector)
-      continue;
-    const matcher = selector.includes("*") ? selectorToRegex(selector) : undefined;
-    let matchedAny = false;
-    for (const check of allChecks) {
-      const matched = matcher ? matcher.test(check.id) : check.id === selector;
-      if (!matched)
-        continue;
-      matchedAny = true;
-      if (seen.has(check.id))
-        continue;
-      seen.add(check.id);
-      resolved.push(check.id);
-    }
-    if (!matchedAny)
-      unmatched.push(selector);
-  }
-  return { resolved, unmatched };
-}
-function selectorToRegex(selector) {
-  const escaped = selector.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/\\\*/g, ".*");
-  return new RegExp(`^${escaped}$`);
-}
-
-// src/checks/policy.ts
-var INSPECT_FAILED_CODE = "inspect-failed";
-function isCheckEnabled(check, config) {
-  const entry = config.validate.checks[check.id];
-  if (entry === false)
-    return false;
-  if (typeof entry === "object" && entry.enabled === false)
-    return false;
-  if (check.enabledWhen && !check.enabledWhen(config))
-    return false;
-  return true;
-}
-function selectChecks(opts, config) {
-  const unmatched = [];
-  let checks2;
-  if (opts.only && opts.only.length > 0) {
-    const resolved = resolveCheckSelectors(opts.only);
-    checks2 = getChecks({ ids: resolved.resolved });
-    unmatched.push(...resolved.unmatched);
-  } else {
-    checks2 = getChecks({ category: opts.category, phase: opts.phase });
-  }
-  if (opts.skip && opts.skip.length > 0) {
-    const resolved = resolveCheckSelectors(opts.skip);
-    const skipSet = new Set(resolved.resolved);
-    checks2 = checks2.filter((c) => !skipSet.has(c.id));
-    unmatched.push(...resolved.unmatched);
-  }
-  checks2 = checks2.filter((c) => isCheckEnabled(c, config));
-  return { checks: checks2, unmatched };
+function selectChecks(opts, config) {
+  const unmatched = [];
+  let checks2;
+  if (opts.only && opts.only.length > 0) {
+    const resolved = resolveCheckSelectors(opts.only);
+    checks2 = getChecks({ ids: resolved.resolved });
+    unmatched.push(...resolved.unmatched);
+  } else {
+    checks2 = getChecks({ category: opts.category, phase: opts.phase });
+  }
+  if (opts.skip && opts.skip.length > 0) {
+    const resolved = resolveCheckSelectors(opts.skip);
+    const skipSet = new Set(resolved.resolved);
+    checks2 = checks2.filter((c) => !skipSet.has(c.id));
+    unmatched.push(...resolved.unmatched);
+  }
+  checks2 = checks2.filter((c) => isCheckEnabled(c, config));
+  return { checks: checks2, unmatched };
 }
 function finding(checkId, init) {
   return { checkId, ...init };
@@ -5551,7 +5280,7 @@ function inspectionFailed(checkId, message, extra = {}) {
 }
 
 // src/lib/pdf-inspect.ts
-import { stat, readFile as readFile10 } from "node:fs/promises";
+import { stat, readFile as readFile9 } from "node:fs/promises";
 import { getDocumentProxy } from "unpdf";
 import * as pdfjs from "unpdf/pdfjs";
 function getOps(mod) {
@@ -5606,7 +5335,7 @@ async function loadPdf(path7) {
   }
   if (hit)
     destroyEntry(hit);
-  const docPromise = readFile10(path7).then((buf) => getDocumentProxy(new Uint8Array(buf)));
+  const docPromise = readFile9(path7).then((buf) => getDocumentProxy(new Uint8Array(buf)));
   docCache.delete(path7);
   docCache.set(path7, { mtimeMs: st.mtimeMs, size: st.size, doc: docPromise });
   evictLru();
@@ -5804,12 +5533,12 @@ function getOpPass(doc) {
   return p;
 }
 function getImagePixelSize(page, name, timeoutMs = 2000) {
-  return new Promise((resolve6) => {
+  return new Promise((resolve5) => {
     let done = false;
     const finish = (v) => {
       if (!done) {
         done = true;
-        resolve6(v);
+        resolve5(v);
       }
     };
     const t = setTimeout(() => finish(null), timeoutMs);
@@ -6065,9 +5794,9 @@ var check3 = {
 registerCheck(check3);
 
 // src/lib/pdf-parse.ts
-import { readFile as readFile11 } from "node:fs/promises";
+import { readFile as readFile10 } from "node:fs/promises";
 async function readPdfBytes(pdfPath) {
-  return readFile11(pdfPath, "latin1");
+  return readFile10(pdfPath, "latin1");
 }
 function parseInkCov(out) {
   const lines = out.split(/\r?\n/).filter((l) => l.includes("CMYK"));
@@ -6638,21 +6367,21 @@ var check15 = {
 registerCheck(check15);
 
 // src/checks/source/markdownlint.ts
-import { readFile as readFile12 } from "node:fs/promises";
+import { readFile as readFile11 } from "node:fs/promises";
 import { lint } from "markdownlint/sync";
 import { parse as parseYaml2 } from "yaml";
 
 // src/checks/source/config-file.ts
-import { existsSync as existsSync7 } from "node:fs";
-import { resolve as resolve6 } from "node:path";
+import { existsSync as existsSync6 } from "node:fs";
+import { resolve as resolve5 } from "node:path";
 function findConfigFile(inputDir, names, explicit) {
   if (explicit) {
-    const p = resolve6(inputDir, explicit);
-    return existsSync7(p) ? p : null;
+    const p = resolve5(inputDir, explicit);
+    return existsSync6(p) ? p : null;
   }
   for (const name of names) {
-    const p = resolve6(inputDir, name);
-    if (existsSync7(p))
+    const p = resolve5(inputDir, name);
+    if (existsSync6(p))
       return p;
   }
   return null;
@@ -6671,7 +6400,7 @@ function stripJsonComments(s) {
   return s.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1");
 }
 async function loadConfig(configPath) {
-  const raw = await readFile12(configPath, "utf8");
+  const raw = await readFile11(configPath, "utf8");
   let parsed;
   if (configPath.endsWith(".json")) {
     parsed = JSON.parse(raw);
@@ -6680,94 +6409,352 @@ async function loadConfig(configPath) {
   } else {
     parsed = parseYaml2(raw);
   }
-  if (parsed && typeof parsed === "object") {
-    const obj = parsed;
-    if (obj.config && typeof obj.config === "object") {
-      return obj.config;
+  if (parsed && typeof parsed === "object") {
+    const obj = parsed;
+    if (obj.config && typeof obj.config === "object") {
+      return obj.config;
+    }
+    return obj;
+  }
+  return {};
+}
+var check16 = {
+  id: "source.markdownlint",
+  name: "Markdownlint",
+  description: "Runs markdownlint with project config to validate Markdown files",
+  category: "source",
+  phase: "pre-build",
+  async run(ctx) {
+    const sourceConfig = ctx.config.validate.source;
+    if (sourceConfig.markdownlint === false)
+      return [];
+    const files = ctx.markdownFiles;
+    if (!files || files.length === 0)
+      return [];
+    const configPath = typeof sourceConfig.markdownlint === "string" ? sourceConfig.markdownlint : null;
+    const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES, configPath);
+    if (!resolvedConfig && !configPath)
+      return [];
+    const config = resolvedConfig ? await loadConfig(resolvedConfig) : { default: true };
+    const results = lint({ files, config });
+    const out = [];
+    for (const [file, violations] of Object.entries(results)) {
+      if (!Array.isArray(violations))
+        continue;
+      for (const v of violations) {
+        out.push({
+          checkId: check16.id,
+          severity: "warning",
+          message: `${v.ruleDescription} (${v.ruleNames.join("/")})`,
+          file,
+          line: v.lineNumber,
+          column: v.errorRange?.[0],
+          code: v.ruleNames[0]
+        });
+      }
+    }
+    return out;
+  }
+};
+registerCheck(check16);
+
+// src/checks/source/htmlhint.ts
+import { existsSync as existsSync7 } from "node:fs";
+import { readFile as readFile12 } from "node:fs/promises";
+import htmlhint from "htmlhint";
+var { HTMLHint } = htmlhint;
+var CONFIG_NAMES2 = [".htmlhintrc"];
+var check17 = {
+  id: "source.htmlhint",
+  name: "HTMLHint",
+  description: "Runs htmlhint with project config to validate generated HTML",
+  category: "source",
+  phase: "pre-build",
+  async run(ctx) {
+    const sourceConfig = ctx.config.validate.source;
+    if (sourceConfig.htmlhint === false)
+      return [];
+    if (!ctx.htmlPath || !existsSync7(ctx.htmlPath))
+      return [];
+    const configPath = typeof sourceConfig.htmlhint === "string" ? sourceConfig.htmlhint : null;
+    const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES2, configPath);
+    if (!resolvedConfig && !configPath)
+      return [];
+    const ruleset = resolvedConfig ? JSON.parse(await readFile12(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
+    const html = await readFile12(ctx.htmlPath, "utf8");
+    const messages = HTMLHint.verify(html, ruleset);
+    return messages.map((m) => ({
+      checkId: check17.id,
+      severity: m.type === "error" ? "error" : "warning",
+      message: `${m.rule.id}: ${m.message}`,
+      file: ctx.htmlPath,
+      line: m.line,
+      column: m.col
+    }));
+  }
+};
+registerCheck(check17);
+
+// src/checks/source/stylelint.ts
+import { readFile as readFile13 } from "node:fs/promises";
+
+// src/lib/printsafe.ts
+import postcss2 from "postcss";
+var ruleRemoteUrls = "printsafe/no-remote-urls";
+var ruleRiskyProps = "printsafe/no-risky-print-effects";
+var ruleSyntax = "printsafe/syntax-error";
+var rulePageContainment = "printsafe/page-containment";
+function extractUrls(value) {
+  const urls = [];
+  const re = /url\(\s*(['"]?)(.*?)\1\s*\)/gi;
+  let m;
+  while (m = re.exec(value))
+    urls.push(m[2] ?? "");
+  return urls;
+}
+function isRemoteUrl(url) {
+  const lower = url.trim().toLowerCase();
+  return lower.startsWith("http://") || lower.startsWith("https://") || lower.startsWith("//");
+}
+var riskyProperties = new Set([
+  "filter",
+  "backdrop-filter",
+  "mix-blend-mode",
+  "background-blend-mode",
+  "animation",
+  "animation-name",
+  "transition",
+  "will-change",
+  "clip-path"
+]);
+var marginBoxAtRuleNames = new Set([
+  "top-left-corner",
+  "top-left",
+  "top-center",
+  "top-right",
+  "top-right-corner",
+  "bottom-left-corner",
+  "bottom-left",
+  "bottom-center",
+  "bottom-right",
+  "bottom-right-corner",
+  "left-top",
+  "left-middle",
+  "left-bottom",
+  "right-top",
+  "right-middle",
+  "right-bottom"
+]);
+var marginBoxIgnoredProperties = MARGIN_BOX_IGNORED_PROPERTIES;
+function isInPageBox(decl) {
+  const page = decl.parent;
+  return !!page && page.type === "atrule" && page.name.toLowerCase() === "page";
+}
+function isDroppedPageGradient(decl) {
+  const prop = decl.prop.toLowerCase();
+  if (prop !== "background" && prop !== "background-image")
+    return false;
+  if (!/(^|[\s,(])[\w-]*gradient\(/i.test(decl.value))
+    return false;
+  return isInPageBox(decl);
+}
+function isInPageMarginBox(decl) {
+  const box = decl.parent;
+  if (!box || box.type !== "atrule")
+    return false;
+  if (!marginBoxAtRuleNames.has(box.name.toLowerCase()))
+    return false;
+  const page = box.parent;
+  return !!page && page.type === "atrule" && page.name.toLowerCase() === "page";
+}
+function isUnpairedFitContentWidth(decl) {
+  const prop = decl.prop.toLowerCase();
+  if (prop !== "width" && prop !== "inline-size")
+    return false;
+  if (!/\bfit-content\b/i.test(decl.value))
+    return false;
+  if (!isInPageMarginBox(decl))
+    return false;
+  const siblings = decl.parent.nodes ?? [];
+  const decls = siblings.filter((n) => n.type === "decl");
+  if (decls.some((d) => ["height", "block-size"].includes(d.prop.toLowerCase())))
+    return false;
+  if (decls.some((d) => /gradient\(/i.test(d.value)))
+    return false;
+  return true;
+}
+function targetsPageWrapper(selector) {
+  if (!/\.(page|spread)(?![\w-])/.test(selector))
+    return false;
+  return !/\bgp-(bleed|pin)\b/.test(selector);
+}
+var cssWideResetKeywords = new Set(["initial", "unset", "revert", "revert-layer"]);
+var inertValues = {
+  "z-index": new Set(["auto"]),
+  opacity: new Set(["1", "100%"]),
+  "mix-blend-mode": new Set(["normal"]),
+  "background-blend-mode": new Set(["normal"]),
+  filter: new Set(["none"]),
+  "backdrop-filter": new Set(["none"]),
+  transform: new Set(["none"]),
+  rotate: new Set(["none"]),
+  translate: new Set(["none"]),
+  scale: new Set(["none"]),
+  perspective: new Set(["none"]),
+  "box-shadow": new Set(["none"]),
+  outline: new Set(["none"]),
+  "outline-style": new Set(["none"]),
+  "will-change": new Set(["auto", "none"]),
+  "clip-path": new Set(["none"]),
+  transition: new Set(["none"]),
+  animation: new Set(["none"]),
+  "animation-name": new Set(["none"]),
+  overflow: new Set(["visible"]),
+  "overflow-x": new Set(["visible"]),
+  "overflow-y": new Set(["visible"])
+};
+function isInertValue(prop, value) {
+  const v = value.trim().toLowerCase();
+  return cssWideResetKeywords.has(v) || (inertValues[prop]?.has(v) ?? false);
+}
+function createsStackingContext(decl) {
+  const p = decl.prop.toLowerCase();
+  const v = decl.value.trim().toLowerCase();
+  if (isInertValue(p, v))
+    return false;
+  switch (p) {
+    case "isolation":
+      return v === "isolate";
+    case "contain":
+      return /\b(paint|layout|strict|content)\b/.test(v);
+    case "z-index":
+    case "opacity":
+    case "mix-blend-mode":
+    case "filter":
+    case "backdrop-filter":
+    case "transform":
+    case "perspective":
+    case "will-change":
+      return true;
+    default:
+      return false;
+  }
+}
+function clipsDescendants(decl) {
+  const p = decl.prop.toLowerCase();
+  if (p !== "overflow" && p !== "overflow-x" && p !== "overflow-y")
+    return false;
+  const v = decl.value.trim().toLowerCase();
+  return v !== "" && !isInertValue(p, v);
+}
+function nodeLoc(node) {
+  return {
+    line: node.source?.start?.line ?? 1,
+    column: node.source?.start?.column ?? 1
+  };
+}
+function checkCss(css, from) {
+  let root;
+  try {
+    root = postcss2.parse(css, from ? { from } : undefined);
+  } catch (err) {
+    const e = err;
+    return [
+      {
+        rule: ruleSyntax,
+        severity: "error",
+        message: `CSS syntax error: ${e.reason ?? e.message ?? "unparseable"}`,
+        line: e.line ?? 1,
+        column: e.column ?? 1
+      }
+    ];
+  }
+  const warnings = [];
+  const reportRemoteUrls = (value, node) => {
+    for (const url of extractUrls(value)) {
+      if (isRemoteUrl(url)) {
+        warnings.push({
+          rule: ruleRemoteUrls,
+          severity: "error",
+          message: `Remote URL is not allowed in print CSS: ${url}`,
+          ...nodeLoc(node)
+        });
+      }
     }
-    return obj;
-  }
-  return {};
-}
-var check16 = {
-  id: "source.markdownlint",
-  name: "Markdownlint",
-  description: "Runs markdownlint with project config to validate Markdown files",
-  category: "source",
-  phase: "pre-build",
-  async run(ctx) {
-    const sourceConfig = ctx.config.validate.source;
-    if (sourceConfig.markdownlint === false)
-      return [];
-    const files = ctx.markdownFiles;
-    if (!files || files.length === 0)
-      return [];
-    const configPath = typeof sourceConfig.markdownlint === "string" ? sourceConfig.markdownlint : null;
-    const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES, configPath);
-    if (!resolvedConfig && !configPath)
-      return [];
-    const config = resolvedConfig ? await loadConfig(resolvedConfig) : { default: true };
-    const results = lint({ files, config });
-    const out = [];
-    for (const [file, violations] of Object.entries(results)) {
-      if (!Array.isArray(violations))
-        continue;
-      for (const v of violations) {
-        out.push({
-          checkId: check16.id,
+  };
+  root.walkDecls((decl) => reportRemoteUrls(decl.value || "", decl));
+  root.walkAtRules((at) => reportRemoteUrls(at.params || "", at));
+  root.walkDecls((decl) => {
+    const prop = decl.prop.toLowerCase();
+    if (isInertValue(prop, decl.value))
+      return;
+    if (marginBoxIgnoredProperties.has(prop) && isInPageMarginBox(decl)) {
+      warnings.push({
+        rule: ruleRiskyProps,
+        severity: "warning",
+        message: `Property "${decl.prop}" is not supported in Chromium @page margin boxes and is silently ignored — the chrome renders square/unshadowed. Anything that would paint outside the box (box-shadow, outline, filter) or make it a stacking context (transform, opacity, mix-blend-mode) is dropped; text-shadow, border, border-radius, padding and background gradients all work inside the box.`,
+        ...nodeLoc(decl)
+      });
+    } else if (prop === "filter") {
+      warnings.push({
+        rule: ruleRiskyProps,
+        severity: "warning",
+        message: `Property is high-risk for print/PDF: 'filter' rasterizes its subtree to a 300 DPI bitmap in the printed PDF (text becomes unselectable, unsearchable, and inaccessible), and it dominates build time (~90% measured; 57.0s -> 6.2s over 60pp when scoped — see ENGINE.md §10). Scope it to the smallest possible selector. It also means the render-parity gate cannot see a text-only change inside it (docs/render-parity-gate.md, "Known blind spot").`,
+        ...nodeLoc(decl)
+      });
+    } else if (riskyProperties.has(prop)) {
+      warnings.push({
+        rule: ruleRiskyProps,
+        severity: "warning",
+        message: `Property is high-risk for print/PDF (can force rasterization): ${decl.prop}`,
+        ...nodeLoc(decl)
+      });
+    } else if (isDroppedPageGradient(decl)) {
+      warnings.push({
+        rule: ruleRiskyProps,
+        severity: "warning",
+        message: `"${decl.prop}: ${decl.value}" on @page paints nothing in print — Chromium drops a gradient in the @page box's own background, with no error and a valid-looking PDF. A solid colour there paints the whole sheet; the same gradient also works on "html" (it covers the content area, not the sheet) or in a margin box.`,
+        ...nodeLoc(decl)
+      });
+    } else if (isUnpairedFitContentWidth(decl)) {
+      warnings.push({
+        rule: ruleRiskyProps,
+        severity: "warning",
+        message: `"${decl.prop}: fit-content" in a @page margin box collapses only the inline axis — the box stays stretched to the full margin band, so a chip/pill renders as a tall rectangle around its text. Add "height: fit-content" (align-self / vertical-align do nothing here).`,
+        ...nodeLoc(decl)
+      });
+    }
+  });
+  root.walkRules((rule) => {
+    if (rule.parent?.type === "atrule") {
+      const at = rule.parent.name.toLowerCase();
+      if (at === "page" || marginBoxAtRuleNames.has(at))
+        return;
+    }
+    if (!targetsPageWrapper(rule.selector))
+      return;
+    rule.walkDecls((decl) => {
+      if (clipsDescendants(decl)) {
+        warnings.push({
+          rule: rulePageContainment,
           severity: "warning",
-          message: `${v.ruleDescription} (${v.ruleNames.join("/")})`,
-          file,
-          line: v.lineNumber,
-          column: v.errorRange?.[0],
-          code: v.ruleNames[0]
+          message: `"${decl.prop}: ${decl.value}" on "${rule.selector}" clips out-of-flow descendants: a .gp-bleed plate is cut back to this box's width instead of reaching the sheet edge, and a .gp-behind image is cut the same way. Scope it with :has() (e.g. "${rule.selector}:not(:has(.gp-bleed, .gp-pin))") or drop it. This is an early source-only check; the build-time engine.layer.trapped audit is authoritative for the live ancestor chain.`,
+          ...nodeLoc(decl)
+        });
+      } else if (createsStackingContext(decl)) {
+        warnings.push({
+          rule: rulePageContainment,
+          severity: "warning",
+          message: `"${decl.prop}: ${decl.value}" on "${rule.selector}" makes the page box a stacking context, so a .gp-behind image is trapped inside it and paints ABOVE the page's text instead of under it. Core keeps .page/.spread at "position: relative; z-index: auto" for this reason. This is an early source-only check; the build-time engine.layer.trapped audit is authoritative for the live ancestor chain.`,
+          ...nodeLoc(decl)
         });
       }
-    }
-    return out;
-  }
-};
-registerCheck(check16);
-
-// src/checks/source/htmlhint.ts
-import { existsSync as existsSync8 } from "node:fs";
-import { readFile as readFile13 } from "node:fs/promises";
-import htmlhint from "htmlhint";
-var { HTMLHint } = htmlhint;
-var CONFIG_NAMES2 = [".htmlhintrc"];
-var check17 = {
-  id: "source.htmlhint",
-  name: "HTMLHint",
-  description: "Runs htmlhint with project config to validate generated HTML",
-  category: "source",
-  phase: "pre-build",
-  async run(ctx) {
-    const sourceConfig = ctx.config.validate.source;
-    if (sourceConfig.htmlhint === false)
-      return [];
-    if (!ctx.htmlPath || !existsSync8(ctx.htmlPath))
-      return [];
-    const configPath = typeof sourceConfig.htmlhint === "string" ? sourceConfig.htmlhint : null;
-    const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES2, configPath);
-    if (!resolvedConfig && !configPath)
-      return [];
-    const ruleset = resolvedConfig ? JSON.parse(await readFile13(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
-    const html = await readFile13(ctx.htmlPath, "utf8");
-    const messages = HTMLHint.verify(html, ruleset);
-    return messages.map((m) => ({
-      checkId: check17.id,
-      severity: m.type === "error" ? "error" : "warning",
-      message: `${m.rule.id}: ${m.message}`,
-      file: ctx.htmlPath,
-      line: m.line,
-      column: m.col
-    }));
-  }
-};
-registerCheck(check17);
+    });
+  });
+  return warnings;
+}
 
 // src/checks/source/stylelint.ts
-import { readFile as readFile14 } from "node:fs/promises";
 var check18 = {
   id: "source.stylelint",
   name: "Print-safety CSS",
@@ -6785,8 +6772,14 @@ var check18 = {
     for (const file of files) {
       let css;
       try {
-        css = await readFile14(file, "utf8");
-      } catch {
+        css = await readFile13(file, "utf8");
+      } catch (err) {
+        results.push({
+          checkId: check18.id,
+          severity: "error",
+          message: `Cannot read stylesheet: ${err instanceof Error ? err.message : String(err)}`,
+          file
+        });
         continue;
       }
       for (const w of checkCss(css, file)) {
@@ -6806,12 +6799,12 @@ var check18 = {
 registerCheck(check18);
 
 // src/checks/source/css-ownership.ts
-import { readFile as readFile15 } from "node:fs/promises";
+import { readFile as readFile14 } from "node:fs/promises";
 import postcss3 from "postcss";
 import { parse as parseYaml3 } from "yaml";
 var CONFIG_NAMES3 = [".gutterpress/css-contract.yaml", ".gutterpress/css-contract.yml"];
 async function loadContract(configPath) {
-  const raw = await readFile15(configPath, "utf8");
+  const raw = await readFile14(configPath, "utf8");
   const parsed = parseYaml3(raw);
   if (parsed && typeof parsed === "object")
     return parsed;
@@ -6962,7 +6955,7 @@ var check19 = {
         continue;
       let css;
       try {
-        css = await readFile15(absFile, "utf8");
+        css = await readFile14(absFile, "utf8");
       } catch {
         continue;
       }
@@ -7004,11 +6997,11 @@ var check19 = {
 registerCheck(check19);
 
 // src/checks/source/local-refs.ts
-import { existsSync as existsSync9 } from "node:fs";
-import { dirname as dirname3, resolve as resolve7 } from "node:path";
+import { existsSync as existsSync8 } from "node:fs";
+import { dirname as dirname3, resolve as resolve6 } from "node:path";
 
 // src/checks/source/local-ref-parser.ts
-import { readFile as readFile16 } from "node:fs/promises";
+import { readFile as readFile15 } from "node:fs/promises";
 function newlineOffsets(content) {
   const offsets = [];
   for (let i = 0;i < content.length; i++)
@@ -7077,7 +7070,7 @@ async function* renderedLocalRefs(ctx, checkId, results) {
   for (const file of files) {
     let refs;
     try {
-      refs = collectRenderedLocalRefs(await readFile16(file, "utf8"));
+      refs = collectRenderedLocalRefs(await readFile15(file, "utf8"));
     } catch {
       results.push(inspectionFailed(checkId, `Could not read source file: ${file}`, { file }));
       continue;
@@ -7127,13 +7120,13 @@ function filesystemRef(ref) {
 }
 function localRefExists(ref, kind, sourceFile, projectRoot) {
   const cleaned = filesystemRef(ref);
-  const fileRelative = resolve7(dirname3(sourceFile), cleaned);
-  const rootRelative = resolve7(projectRoot, cleaned);
+  const fileRelative = resolve6(dirname3(sourceFile), cleaned);
+  const rootRelative = resolve6(projectRoot, cleaned);
   switch (kind) {
     case "image":
-      return existsSync9(rootRelative);
+      return existsSync8(rootRelative);
     case "link":
-      return existsSync9(fileRelative);
+      return existsSync8(fileRelative);
   }
 }
 registerCheck(check20);
@@ -7428,7 +7421,7 @@ var check21 = {
 registerCheck(check21);
 
 // src/checks/source/accessibility-alt-text.ts
-import { readFile as readFile17 } from "node:fs/promises";
+import { readFile as readFile16 } from "node:fs/promises";
 var check22 = {
   id: "source.accessibility.alt-text",
   name: "Image Alt Text",
@@ -7442,7 +7435,7 @@ var check22 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile17(file, "utf8");
+        const content = await readFile16(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -7486,7 +7479,7 @@ function extractImageAlts(line) {
 registerCheck(check22);
 
 // src/checks/source/accessibility-heading-order.ts
-import { readFile as readFile18 } from "node:fs/promises";
+import { readFile as readFile17 } from "node:fs/promises";
 var check23 = {
   id: "source.accessibility.heading-order",
   name: "Heading Order",
@@ -7500,7 +7493,7 @@ var check23 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile18(file, "utf8");
+        const content = await readFile17(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -7536,7 +7529,7 @@ var check23 = {
 registerCheck(check23);
 
 // src/checks/source/layout-markers.ts
-import { readFile as readFile19 } from "node:fs/promises";
+import { readFile as readFile18 } from "node:fs/promises";
 var check24 = {
   id: "source.markdown.layout-markers",
   name: "Layout Markers",
@@ -7554,7 +7547,7 @@ var check24 = {
     const md = createMarkdownRenderer(plugins);
     for (const file of files) {
       try {
-        const content = await readFile19(file, "utf8");
+        const content = await readFile18(file, "utf8");
         const env = {};
         md.render(content, env);
         for (const w of env.layoutWarnings ?? []) {
@@ -7576,7 +7569,7 @@ var check24 = {
 registerCheck(check24);
 
 // src/checks/source/merge-markers.ts
-import { readFile as readFile20 } from "node:fs/promises";
+import { readFile as readFile19 } from "node:fs/promises";
 import path8 from "node:path";
 
 // src/checks/asset/extensions.ts
@@ -7618,7 +7611,7 @@ var check25 = {
     for (const file of textFiles) {
       let content;
       try {
-        content = await readFile20(file, "utf8");
+        content = await readFile19(file, "utf8");
       } catch {
         results.push(inspectionFailed(check25.id, `Could not read source file: ${file}`, { file }));
         continue;
@@ -7681,7 +7674,7 @@ registerCheck(check25);
 import { stat as stat3 } from "node:fs/promises";
 
 // src/lib/image-inspect.ts
-import { stat as stat2, readFile as readFile21 } from "node:fs/promises";
+import { stat as stat2, readFile as readFile20 } from "node:fs/promises";
 var DEFAULT_DPI = 72;
 var cache = new Map;
 async function inspectImage(path9) {
@@ -7696,7 +7689,7 @@ async function inspectImage(path9) {
     return hit.info;
   let info2 = null;
   try {
-    const buf = await readFile21(path9);
+    const buf = await readFile20(path9);
     info2 = parseImage(buf);
   } catch {
     info2 = null;
@@ -8155,8 +8148,8 @@ var check31 = {
 registerCheck(check31);
 
 // src/checks/asset/font-license.ts
-import { existsSync as existsSync10 } from "node:fs";
-import { resolve as resolve8 } from "node:path";
+import { existsSync as existsSync9 } from "node:fs";
+import { resolve as resolve7 } from "node:path";
 var LICENSE_NAMES = [
   "LICENSE",
   "LICENSE.txt",
@@ -8186,12 +8179,12 @@ var check32 = {
         ignore: [...ASSET_SCAN_IGNORE_GLOBS]
       });
       for (const m of matches) {
-        fontDirs.add(resolve8(m, ".."));
+        fontDirs.add(resolve7(m, ".."));
       }
     }
     const results = [];
     for (const fontDir of fontDirs) {
-      const hasLicense = LICENSE_NAMES.some((name) => existsSync10(resolve8(fontDir, name)));
+      const hasLicense = LICENSE_NAMES.some((name) => existsSync9(resolve7(fontDir, name)));
       if (!hasLicense) {
         results.push({
           checkId: check32.id,
@@ -8256,7 +8249,7 @@ var check33 = {
 registerCheck(check33);
 
 // src/checks/heuristic/section-density.ts
-import { readFile as readFile22 } from "node:fs/promises";
+import { readFile as readFile21 } from "node:fs/promises";
 var check34 = {
   id: "heuristic.chunking.section-density",
   name: "Section Density",
@@ -8273,7 +8266,7 @@ var check34 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile22(file, "utf8");
+        const content = await readFile21(file, "utf8");
         const lines = content.split(`
 `);
         let currentSectionStart = 0;
@@ -8542,13 +8535,13 @@ async function sharedAssetDirs(manifestDir, relStyles, inputDir) {
   } catch {
     return [];
   }
-  const projectRoot = resolve9(inputDir);
+  const projectRoot = resolve8(inputDir);
   const dirs = new Set;
   for (const file of closure) {
     const ext = file.slice(file.lastIndexOf(".")).toLowerCase();
     if (!SHIPPED_ASSET_EXTS.has(ext))
       continue;
-    const dir = dirname4(resolve9(file));
+    const dir = dirname4(resolve8(file));
     if (escapesProjectRoot(projectRoot, dir))
       dirs.add(dir);
   }
@@ -8709,11 +8702,11 @@ function planRuns(opts) {
 async function executeValidation(args) {
   const manifestPath = typeof args.manifest === "string" ? args.manifest : undefined;
   const { manifest, manifestDir } = await loadManifestWithPath(manifestPath ?? args.input ?? undefined, { explicit: manifestPath !== undefined });
-  const config = resolveConfig({}, manifest);
+  const config = resolveConfig(args.skipStylelint ? { validate: { source: { stylelint: false } } } : {}, manifest);
   const targetIds = resolveTargets(parseCsv(typeof args.target === "string" ? args.target : undefined), config.targets);
-  const pdfPath = typeof args.pdf === "string" ? resolve9(args.pdf) : undefined;
-  const inputDir = typeof args.input === "string" ? resolve9(args.input) : undefined;
-  if (pdfPath && !existsSync11(pdfPath)) {
+  const pdfPath = typeof args.pdf === "string" ? resolve8(args.pdf) : undefined;
+  const inputDir = typeof args.input === "string" ? resolve8(args.input) : undefined;
+  if (pdfPath && !existsSync10(pdfPath)) {
     throw new Error(`File not found: ${pdfPath}`);
   }
   const categories = resolveCategoryArg(typeof args.category === "string" ? args.category : undefined);
@@ -8744,7 +8737,7 @@ async function executeValidation(args) {
     const relMarkdown = await resolveActiveMarkdownFiles(manifestDir, config.source.files);
     markdownFiles = relMarkdown.map((f) => join4(manifestDir, canonicalChapterId(f)));
     const relStyles = await resolveActiveStyles(manifestDir, config.styles);
-    const projectCssFiles = relStyles.map((rel) => resolve9(manifestDir, rel));
+    const projectCssFiles = relStyles.map((rel) => resolve8(manifestDir, rel));
     let pluginStylePaths = args.pluginStylePaths;
     if (pluginStylePaths === undefined) {
       ({ pluginStylePaths } = await loadPluginsWithCss(config.extensions, manifestDir, (ref, err) => log.warn(`Skipping plugin "${ref}" for validation — ${err.message}`)));
@@ -8752,7 +8745,7 @@ async function executeValidation(args) {
     cssFiles = [...projectCssFiles, ...pluginStylePaths].filter((f) => !f.endsWith(".min.css"));
     assetDirs = [inputDir, ...await sharedAssetDirs(manifestDir, relStyles, inputDir)];
     const possibleHtml = join4(outDir, BOOK_HTML_FILENAME);
-    if (existsSync11(possibleHtml)) {
+    if (existsSync10(possibleHtml)) {
       htmlPath = possibleHtml;
     }
   }
@@ -8901,12 +8894,12 @@ function computeGates(format, opts, config) {
     if (opts.skipLint || opts.skipPreValidate || opts.skipPostValidate) {
       log.info("Validation/lint flags ignored for --format html (no validation phases apply)");
     }
-    return { lint: false, preValidate: false, postValidate: false };
+    return { skipStylelint: false, preValidate: false, postValidate: false };
   }
-  const lint2 = !opts.skipLint && config.lint.enabled !== false;
+  const skipStylelint = !!opts.skipLint || config.lint.enabled === false;
   const preValidate = !opts.skipPreValidate && config.validate.enabled !== false;
   const postValidate = format === "pdfx" && !opts.skipPostValidate && config.validate.enabled !== false;
-  return { lint: lint2, preValidate, postValidate };
+  return { skipStylelint, preValidate, postValidate };
 }
 
 // src/lib/build-runner.ts
@@ -8974,24 +8967,15 @@ async function loadBuildPlugins(ctx) {
 }
 async function runQualityGates(ctx) {
   const { gates, opts, renderDir } = ctx;
-  const pluginStylePaths = gates.lint || gates.preValidate ? (await loadBuildPlugins(ctx)).pluginStylePaths : undefined;
-  if (gates.lint) {
-    log.info("Lint: CSS print-safety");
-    const lintResult = await runLint({
-      manifest: opts.manifestPath ?? renderDir,
-      pluginStylePaths
-    });
-    if (!lintResult.ok) {
-      throw new BuildError("CSS lint failed", 2);
-    }
-  }
+  const pluginStylePaths = gates.preValidate ? (await loadBuildPlugins(ctx)).pluginStylePaths : undefined;
   if (gates.preValidate) {
     log.info("Pre-build validation");
     const result = await executeAndReport({
       input: renderDir,
       phase: "pre-build",
       manifest: opts.manifestPath,
-      pluginStylePaths
+      pluginStylePaths,
+      skipStylelint: gates.skipStylelint
     }, "text");
     for (const finding2 of result.execution.report.results) {
       if (finding2.checkId === "source.markdown.layout-markers" && finding2.file && finding2.code !== "inspect-failed") {
@@ -9078,7 +9062,7 @@ async function finalizeBuild(ctx, fingerprint, wroteMessage, paths, artifactName
     recordedOutputDir: fingerprint.outputDir
   });
   await publishBuild(ctx, artifactName2);
-  const delivered = ctx.target.kind !== "file";
+  const delivered = ctx.target.kind === "project" || ctx.target.kind === "directory" && ctx.format === "html";
   const fingerprintPath = delivered ? path9.join(ctx.outDir, path9.basename(workFingerprint)) : null;
   log.success(wroteMessage);
   if (fingerprintPath)
@@ -9091,6 +9075,16 @@ async function finalizeBuild(ctx, fingerprint, wroteMessage, paths, artifactName
     diagnostics
   };
 }
+async function publishToDirectory(workDir, targetDir, format, artifactName2) {
+  await fsp2.mkdir(targetDir, { recursive: true });
+  if (format !== "html") {
+    if (!artifactName2)
+      throw new BuildError("No artifact to write for this format", 1);
+    await fsp2.copyFile(path9.join(workDir, artifactName2), path9.join(targetDir, artifactName2));
+    return;
+  }
+  await fsp2.cp(workDir, targetDir, { recursive: true, force: true });
+}
 async function publishBuild(ctx, artifactName2) {
   const { workDir, target } = ctx;
   if (target.kind === "file") {
@@ -9101,8 +9095,7 @@ async function publishBuild(ctx, artifactName2) {
     return;
   }
   if (target.kind === "directory") {
-    await fsp2.mkdir(target.dir, { recursive: true });
-    await fsp2.cp(workDir, target.dir, { recursive: true, force: true });
+    await publishToDirectory(workDir, target.dir, ctx.format, artifactName2);
     return;
   }
   for (const name of await listPdfs(target.dir)) {
@@ -9156,7 +9149,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path9.join(stage, "raw.pdf") : path9.resolve(pdfFile);
       await fsp2.mkdir(path9.dirname(path9.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-d46wgg99.js");
+      const { buildNativePdf } = await import("./engine-pt2acjb5.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -9250,7 +9243,7 @@ async function runBuild(opts) {
 import path11 from "path";
 import { tmpdir as tmpdir2 } from "os";
 import { randomBytes as randomBytes2 } from "crypto";
-import { readdir as readdir5, readFile as readFile23, writeFile as writeFile5 } from "node:fs/promises";
+import { readdir as readdir5, readFile as readFile22, writeFile as writeFile5 } from "node:fs/promises";
 
 // src/utils/file-utils.ts
 import { promises as fs3 } from "fs";
@@ -9655,8 +9648,8 @@ function createFileWatcher(state) {
     immediatePending = false;
     state.isRebuilding = true;
     let resolveInFlight;
-    const inFlight = new Promise((resolve10) => {
-      resolveInFlight = resolve10;
+    const inFlight = new Promise((resolve9) => {
+      resolveInFlight = resolve9;
     });
     state.rebuildPromise = inFlight;
     try {
@@ -9760,7 +9753,7 @@ async function cleanupOrphanTempDirs() {
     const dir = path11.join(TEMP_DIR_BASE, entry);
     const pidFile = path11.join(dir, PID_FILE_NAME);
     try {
-      const raw = await readFile23(pidFile, "utf8");
+      const raw = await readFile22(pidFile, "utf8");
       const pid = parseInt(raw.trim(), 10);
       if (!isProcessAlive(pid)) {
         debug(`Removing orphan temp dir ${dir} (pid ${pid} not alive)`);
@@ -9805,10 +9798,10 @@ async function restartPreview(newInputPath, state) {
 }
 async function withTimeout(p, ms, label) {
   let timer;
-  const timeout = new Promise((resolve10) => {
+  const timeout = new Promise((resolve9) => {
     timer = setTimeout(() => {
       debug(`shutdownServer: ${label} exceeded ${ms}ms — continuing`);
-      resolve10(undefined);
+      resolve9(undefined);
     }, ms);
   });
   try {
@@ -9866,7 +9859,7 @@ function createServerState(inputPath, tempDir, config, options) {
 import http from "node:http";
 import net from "node:net";
 import { createHash as createHash6, randomUUID } from "node:crypto";
-import { readFile as readFile24, stat as stat4 } from "node:fs/promises";
+import { readFile as readFile23, stat as stat4 } from "node:fs/promises";
 import path13 from "path";
 import { WebSocket, WebSocketServer } from "ws";
 
@@ -9887,13 +9880,13 @@ function buildOpenPathSpawnSpec(filePath, platform = process.platform) {
   }
 }
 function openPath(filePath) {
-  return new Promise((resolve10, reject) => {
+  return new Promise((resolve9, reject) => {
     const { cmd, args, options } = buildOpenPathSpawnSpec(filePath);
     const child = spawn(cmd, args, options);
     child.once("error", reject);
     child.once("spawn", () => {
       child.unref();
-      resolve10();
+      resolve9();
     });
   });
 }
@@ -10124,7 +10117,7 @@ iframe{position:absolute;inset:0;width:100%;height:100%;border:0;display:block}<
 </body></html>`;
 }
 function probePort(port, host) {
-  return new Promise((resolve10) => {
+  return new Promise((resolve9) => {
     const srv = net.createServer();
     srv.unref();
     let settled = false;
@@ -10132,7 +10125,7 @@ function probePort(port, host) {
       if (settled)
         return;
       settled = true;
-      resolve10(result);
+      resolve9(result);
     };
     srv.once("error", (error2) => finish({ available: false, error: error2 }));
     try {
@@ -10184,7 +10177,7 @@ async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders
   }
   let data;
   try {
-    data = await readFile24(filePath);
+    data = await readFile23(filePath);
   } catch {
     res.writeHead(404);
     res.end("Not Found");
@@ -10234,7 +10227,7 @@ async function serveRevalidatedStatic(req, absPath, res, validators) {
   let data;
   if (!validator || validator.stamp !== stamp) {
     try {
-      data = await readFile24(absPath);
+      data = await readFile23(absPath);
     } catch {
       await serveStatic(absPath, res);
       return;
@@ -10457,7 +10450,7 @@ async function createPreviewServer(state, port) {
       socket.destroy();
     }
   });
-  await new Promise((resolve10) => server.listen(port, state.options.host, resolve10));
+  await new Promise((resolve9) => server.listen(port, state.options.host, resolve9));
   const boundPort = server.address().port;
   const serverUrl = `http://localhost:${boundPort}`;
   info(`Preview server running at ${serverUrl}`);
@@ -10498,11 +10491,11 @@ async function createPreviewServer(state, port) {
       }
       clients.clear();
       wss.close();
-      await new Promise((resolve10) => {
+      await new Promise((resolve9) => {
         if (typeof server.closeAllConnections === "function") {
           server.closeAllConnections();
         }
-        server.close(() => resolve10());
+        server.close(() => resolve9());
       });
     },
     broadcastReload() {
@@ -10575,7 +10568,7 @@ async function startPreviewServer(options) {
 import { platform, arch, release } from "node:os";
 
 // src/lib/remote-auth/token-store.ts
-import { chmod, mkdir as mkdir5, readFile as readFile25, rename as rename2, writeFile as writeFile6 } from "node:fs/promises";
+import { chmod, mkdir as mkdir5, readFile as readFile24, rename as rename2, writeFile as writeFile6 } from "node:fs/promises";
 import os3 from "node:os";
 import path14 from "node:path";
 function credentialHostKey(hostOrUrl) {
@@ -10619,7 +10612,7 @@ class FileTokenStore {
   async read() {
     let raw;
     try {
-      raw = await readFile25(this.filePath, "utf8");
+      raw = await readFile24(this.filePath, "utf8");
     } catch (e) {
       if (e?.code === "ENOENT") {
         return { version: 1, credentials: {} };
@@ -10819,25 +10812,25 @@ async function getSystemDiagnostics() {
   };
 }
 // src/lib/project-scaffold.ts
-import { access, copyFile, cp as cp3, mkdir as mkdir9, readdir as readdir6, readFile as readFile29, stat as stat6, writeFile as writeFile7 } from "node:fs/promises";
-import { constants as FS, existsSync as existsSync14 } from "node:fs";
+import { access, copyFile, cp as cp3, mkdir as mkdir9, readdir as readdir6, readFile as readFile28, stat as stat6, writeFile as writeFile7 } from "node:fs/promises";
+import { constants as FS, existsSync as existsSync13 } from "node:fs";
 import path18 from "node:path";
 
 // src/lib/manifest-doc.ts
-import { existsSync as existsSync12 } from "node:fs";
+import { existsSync as existsSync11 } from "node:fs";
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { mkdir as mkdir6, open, readFile as readFile26, rename as rename3, rm as rm2 } from "node:fs/promises";
+import { mkdir as mkdir6, open, readFile as readFile25, rename as rename3, rm as rm2 } from "node:fs/promises";
 import path15 from "node:path";
 import { parseDocument, isSeq, YAMLSeq } from "yaml";
 function resolveManifestPath(projectDir) {
-  const existing = MANIFEST_FILENAMES.find((name) => existsSync12(path15.join(projectDir, name)));
+  const existing = MANIFEST_FILENAMES.find((name) => existsSync11(path15.join(projectDir, name)));
   return path15.join(projectDir, existing ?? MANIFEST_FILENAMES[0]);
 }
 async function loadManifestDoc(projectDir) {
   const file = resolveManifestPath(projectDir);
   let text = "";
   try {
-    text = await readFile26(file, "utf8");
+    text = await readFile25(file, "utf8");
   } catch (error2) {
     if (error2.code !== "ENOENT")
       throw error2;
@@ -10884,8 +10877,8 @@ function scalarString(item) {
 }
 
 // src/lib/extension-manager.ts
-import { cp as cp2, mkdir as mkdir8, readFile as readFile28, rm as rm4, stat as stat5 } from "node:fs/promises";
-import { existsSync as existsSync13 } from "node:fs";
+import { cp as cp2, mkdir as mkdir8, readFile as readFile27, rm as rm4, stat as stat5 } from "node:fs/promises";
+import { existsSync as existsSync12 } from "node:fs";
 import path17 from "node:path";
 import { isSeq as isSeq2, isMap, isScalar, YAMLMap, Scalar } from "yaml";
 
@@ -10897,7 +10890,7 @@ import {
   mkdir as mkdir7,
   mkdtemp as mkdtemp2,
   open as open2,
-  readFile as readFile27,
+  readFile as readFile26,
   realpath as realpath2,
   rename as rename4,
   rm as rm3
@@ -10942,7 +10935,6 @@ async function withFetchTimeout(options, run2) {
 }
 
 // src/lib/npm-plugin-installer.ts
-var NPM_REGISTRY = "https://registry.npmjs.org";
 var DEFAULT_LIMITS = {
   metadataBytes: 15 * 1024 * 1024,
   packageTarballBytes: 50 * 1024 * 1024,
@@ -10964,11 +10956,11 @@ class PackageUnavailableError extends Error {
 function isOptionalAvailabilityError(error2) {
   return error2 instanceof PackageUnavailableError || error2 instanceof FriendlyHttpError || error2 instanceof FetchUnavailableError;
 }
-function object2(value) {
+function object3(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
 function stringMap2(value) {
-  const map = object2(value);
+  const map = object3(value);
   if (!map)
     return {};
   const result = {};
@@ -11038,7 +11030,7 @@ async function fetchPackument(ctx, name) {
     timeoutMessage: `Looking up ${name} on npm timed out. Check your connection and try again.`,
     offlineMessage: (cause) => `Looking up ${name} on npm failed (${cause instanceof Error ? cause.message : String(cause)}).`
   }, async (signal) => {
-    const response = await ctx.fetch(`${NPM_REGISTRY}/${encodeURIComponent(name)}`, {
+    const response = await ctx.fetch(`${npmRegistryUrl()}/${encodeURIComponent(name)}`, {
       signal,
       redirect: "error",
       headers: { accept: "application/vnd.npm.install-v1+json" }
@@ -11061,7 +11053,7 @@ async function fetchPackument(ctx, name) {
     }
     let metadata = null;
     try {
-      metadata = object2(JSON.parse(new TextDecoder().decode(bytes)));
+      metadata = object3(JSON.parse(new TextDecoder().decode(bytes)));
     } catch {}
     if (!metadata || metadata.name !== name) {
       throw new FriendlyHttpError(`npm returned invalid metadata for "${name}".`);
@@ -11117,15 +11109,15 @@ async function selectPackage(ctx, name, selector) {
     throw new PackageUnavailableError(`Dependency selector "${selector}" for ${name} is not a registry semver range or dist-tag.`);
   }
   const metadata = await fetchPackument(ctx, name);
-  const versions = object2(metadata.versions);
-  const tags = object2(metadata["dist-tags"]);
+  const versions = object3(metadata.versions);
+  const tags = object3(metadata["dist-tags"]);
   if (!versions || !tags)
     throw new PackageUnavailableError(`npm metadata for "${name}" has no versions.`);
   let version;
   if (!selector) {
     if (typeof tags.latest === "string")
       version = tags.latest;
-  } else if (object2(versions[selector])) {
+  } else if (object3(versions[selector])) {
     version = selector;
   } else if (typeof tags[selector] === "string") {
     version = tags[selector];
@@ -11135,11 +11127,11 @@ async function selectPackage(ctx, name, selector) {
   if (!version || !isExactNpmVersion(version)) {
     throw new PackageUnavailableError(`No exact npm version of "${name}" satisfies "${selector ?? "latest"}".`);
   }
-  const selected = object2(versions[version]);
+  const selected = object3(versions[version]);
   if (!selected || selected.name !== name || selected.version !== version) {
     throw new SecurityInstallError(`npm metadata identity failed for "${name}@${version}".`);
   }
-  const dist = object2(selected.dist);
+  const dist = object3(selected.dist);
   if (!dist || typeof dist.tarball !== "string") {
     throw new PackageUnavailableError(`npm metadata for "${name}@${version}" has no tarball.`);
   }
@@ -11149,7 +11141,7 @@ async function selectPackage(ctx, name, selector) {
   } catch {
     throw new SecurityInstallError(`npm returned an invalid tarball URL for "${name}@${version}".`);
   }
-  if (tarball.origin !== NPM_REGISTRY || tarball.protocol !== "https:" || tarball.username || tarball.password) {
+  if (tarball.origin !== new URL(npmRegistryUrl()).origin || tarball.username || tarball.password) {
     throw new SecurityInstallError(`npm returned an unexpected tarball host for "${name}@${version}".`);
   }
   return { name, version, tarball: tarball.href, integrity: parseIntegrity(dist) };
@@ -11296,7 +11288,7 @@ async function readInstalledManifest(packageDir, selected) {
     const info2 = await lstat2(packageJsonPath);
     if (!info2.isFile() || info2.isSymbolicLink())
       throw new Error("not a regular file");
-    manifest = object2(JSON.parse(await readFile27(packageJsonPath, "utf8")));
+    manifest = object3(JSON.parse(await readFile26(packageJsonPath, "utf8")));
   } catch (error2) {
     throw new SecurityInstallError(`Downloaded ${selected.name}@${selected.version} has no valid package.json (${error2 instanceof Error ? error2.message : String(error2)}).`);
   }
@@ -11408,14 +11400,14 @@ async function installPackage(ctx, name, selector, parentPackagePath, ancestors,
     for (const optionalName of Object.keys(optionalDependencies))
       delete dependencies[optionalName];
     const peerDependencies = stringMap2(manifest.peerDependencies);
-    const peerMeta = object2(manifest.peerDependenciesMeta) ?? {};
+    const peerMeta = object3(manifest.peerDependenciesMeta) ?? {};
     for (const existing of [...Object.keys(dependencies), ...Object.keys(optionalDependencies)]) {
       delete peerDependencies[existing];
     }
     const nextAncestors = [...ancestors, record];
     const requiredEntries = [
       ...Object.entries(dependencies).map(([dependency, range]) => ({ dependency, range, kind: "required" })),
-      ...Object.entries(peerDependencies).filter(([dependency]) => object2(peerMeta[dependency])?.optional !== true).map(([dependency, range]) => ({ dependency, range, kind: "peer" }))
+      ...Object.entries(peerDependencies).filter(([dependency]) => object3(peerMeta[dependency])?.optional !== true).map(([dependency, range]) => ({ dependency, range, kind: "peer" }))
     ].sort((a, b) => a.dependency.localeCompare(b.dependency));
     for (const { dependency, range } of requiredEntries) {
       const child = await installPackage(ctx, dependency, range, relativePath, nextAncestors, depth + 1, false);
@@ -11433,7 +11425,7 @@ async function installPackage(ctx, name, selector, parentPackagePath, ancestors,
       }
     }
     for (const [dependency, range] of Object.entries(peerDependencies)) {
-      if (object2(peerMeta[dependency])?.optional === true) {
+      if (object3(peerMeta[dependency])?.optional === true) {
         ctx.skipped.push({
           from: relativePath,
           name: dependency,
@@ -11714,21 +11706,18 @@ var NO_CARRIES = {
   snippets: false,
   components: false
 };
-function hasMetadataFile(dir) {
-  return existsSync13(path17.join(dir, EXTENSION_MANIFEST_FILENAME)) || existsSync13(path17.join(dir, LEGACY_THEME_MANIFEST_FILENAME));
-}
-async function describeFolder(dir, base, fallbackLabel) {
+async function describeFolder(dir, base, fallbackLabel, labelFrom = prettify) {
   const meta = await readExtensionMeta(dir);
-  const styles = extensionStyleListWithDefault(meta, dir);
+  const styles = extensionStyleList(meta);
   return {
     ...base,
-    label: meta.name?.trim() || fallbackLabel,
+    label: meta.name?.trim() ? labelFrom(meta.name.trim()) : fallbackLabel,
     ...meta.description?.trim() ? { description: meta.description.trim() } : {},
     ...meta.author?.trim() ? { author: meta.author.trim() } : {},
     ...meta.preview !== undefined ? { preview: meta.preview } : {},
     ...meta.tokensFile?.trim() ? { tokensFile: meta.tokensFile.trim() } : {},
     ...styles.length > 0 ? { styles } : {},
-    carries: extensionCarries(meta, dir),
+    carries: extensionCarries(meta),
     dir
   };
 }
@@ -11801,10 +11790,14 @@ async function describeEntry(projectDir, raw) {
     return withWarnings({ ...base, label: parsed.name, carries: { ...NO_CARRIES, markdown: true } });
   }
   const pkgDir = vendoredNpmPluginPackageDir(installRoot, parsed.name);
-  if (!hasMetadataFile(pkgDir)) {
+  if (!existsSync12(path17.join(pkgDir, EXTENSION_MANIFEST_FILENAME))) {
     return withWarnings({ ...base, label: parsed.name, carries: { ...NO_CARRIES, markdown: true } });
   }
-  return withWarnings(await describeFolder(pkgDir, base, parsed.name));
+  const described = await describeFolder(pkgDir, base, parsed.name, (name) => name);
+  return withWarnings({
+    ...described,
+    carries: { ...described.carries, markdown: true }
+  });
 }
 async function listProjectExtensions(projectDir) {
   const { doc } = await loadManifestDoc(projectDir);
@@ -12005,7 +11998,7 @@ async function listBuiltInStyleSets() {
     const meta = await readExtensionMeta(path17.join(assets, "themes", id));
     out.push({
       id,
-      name: meta.name?.trim() || prettify(id),
+      name: prettify(meta.name?.trim() || id),
       description: meta.description?.trim() || ""
     });
   }
@@ -12014,7 +12007,7 @@ async function listBuiltInStyleSets() {
 async function uniqueExtensionId(projectDir, base) {
   const slug = slugify(base) || "extension";
   let candidate = slug;
-  for (let n = 2;existsSync13(path17.join(projectDir, EXTENSIONS_DIR, candidate)); n++) {
+  for (let n = 2;existsSync12(path17.join(projectDir, EXTENSIONS_DIR, candidate)); n++) {
     candidate = `${slug}-${n}`;
   }
   return candidate;
@@ -12025,7 +12018,7 @@ async function addBuiltInStyleSet(projectDir, id) {
   }
   return withMutationLock(projectDir, async () => {
     const dest = path17.join(projectDir, EXTENSIONS_DIR, id);
-    if (!existsSync13(dest)) {
+    if (!existsSync12(dest)) {
       const src = path17.join(await getAssetsDir(), "themes", id);
       await mkdir8(path17.dirname(dest), { recursive: true });
       await cp2(src, dest, { recursive: true });
@@ -12067,7 +12060,7 @@ async function readExtensionCss(projectDir, use) {
     throw new Error(`Extension "${use}" declares no stylesheets.`);
   const parts = [];
   for (const sheet of sheets)
-    parts.push(await readFile28(sheet, "utf8"));
+    parts.push(await readFile27(sheet, "utf8"));
   return parts.join(`
 
 `);
@@ -12204,7 +12197,7 @@ async function scaffoldProject(options) {
   } catch (e) {
     throw new CreateProjectErrorImpl("scaffold-io", `Could not write .gitignore: ${e instanceof Error ? e.message : String(e)}`);
   }
-  const manifestPath = MANIFEST_FILENAMES.map((name2) => path18.join(projectDir, name2)).find(existsSync14) ?? path18.join(projectDir, MANIFEST_FILENAMES[0]);
+  const manifestPath = MANIFEST_FILENAMES.map((name2) => path18.join(projectDir, name2)).find(existsSync13) ?? path18.join(projectDir, MANIFEST_FILENAMES[0]);
   const author = (options.author ?? "").trim() || DEFAULT_AUTHOR;
   const substitutions = {
     "{{TITLE}}": escapeYamlScalar(name),
@@ -12244,7 +12237,7 @@ async function scaffoldProject(options) {
   let versionHistoryError;
   if (requested === "local-git") {
     try {
-      const { providerFor } = await import("./source-provider-kn41jmbs.js");
+      const { providerFor } = await import("./source-provider-jkppq9fc.js");
       const provider = providerFor({ type: "local-folder", path: projectDir });
       await provider.initVersionHistory({
         projectDir,
@@ -12288,7 +12281,7 @@ async function adoptFolder(options) {
   if (!st.isDirectory()) {
     throw new CreateProjectErrorImpl("scaffold-io", `Not a folder: ${dir}`);
   }
-  if (MANIFEST_FILENAMES.some((name) => existsSync14(path18.join(dir, name)))) {
+  if (MANIFEST_FILENAMES.some((name) => existsSync13(path18.join(dir, name)))) {
     throw new CreateProjectErrorImpl("target-exists", "This folder is already a Gutterpress project.");
   }
   const template = options.template ?? "book";
@@ -12307,7 +12300,7 @@ async function adoptFolder(options) {
     const themeId = STARTER_THEME_FOR_TEMPLATE[template] ?? "clean-book";
     await mkdir9(path18.join(dir, "styles"), { recursive: true });
     const bookCssPath = path18.join(dir, "styles", "book.css");
-    const hadOwnStylesheet = existsSync14(bookCssPath);
+    const hadOwnStylesheet = existsSync13(bookCssPath);
     if (!hadOwnStylesheet) {
       await writeFile7(bookCssPath, starterOverridesCss(themeId), "utf8");
     }
@@ -12341,7 +12334,7 @@ styles:
   let versionHistoryError;
   if (requested === "local-git") {
     try {
-      const { providerFor } = await import("./source-provider-kn41jmbs.js");
+      const { providerFor } = await import("./source-provider-jkppq9fc.js");
       const provider = providerFor({ type: "local-folder", path: dir });
       await provider.initVersionHistory({
         projectDir: dir,
@@ -12368,7 +12361,7 @@ async function ensureGitignoreHasDist(projectDir) {
   const gitignorePath = path18.join(projectDir, ".gitignore");
   let existing = null;
   try {
-    existing = await readFile29(gitignorePath, "utf8");
+    existing = await readFile28(gitignorePath, "utf8");
   } catch {}
   if (existing === null) {
     await writeFile7(gitignorePath, `dist/
@@ -12388,7 +12381,7 @@ async function ensureGitignoreHasDist(projectDir) {
 async function firstSourceFile(manifestPath) {
   let text;
   try {
-    text = await readFile29(manifestPath, "utf8");
+    text = await readFile28(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -12400,21 +12393,20 @@ async function firstSourceFile(manifestPath) {
   return m ? m[1].trim() : undefined;
 }
 async function fillTemplateFile(filePath, substitutions) {
-  let text = await readFile29(filePath, "utf8");
+  let text = await readFile28(filePath, "utf8");
   for (const [token, value] of Object.entries(substitutions)) {
     text = text.split(token).join(value);
   }
   await writeFile7(filePath, text, "utf8");
 }
 // src/lib/extension-scaffold.ts
-import { access as access2, mkdir as mkdir10, readFile as readFile30, writeFile as writeFile8 } from "node:fs/promises";
+import { access as access2, mkdir as mkdir10, readFile as readFile29, writeFile as writeFile8 } from "node:fs/promises";
 import { constants as FS2 } from "node:fs";
 import path19 from "node:path";
 var EXTENSION_KINDS = ["plugin", "theme"];
 var RESERVED_PREFIX = "gp-";
 var TEMPLATE_FILES = {
   plugin: [
-    ["gutterpress.json", "gutterpress.json"],
     ["package.json", "package.json"],
     ["README.md", "README.md"],
     ["plugin.js.tpl", "plugin.js"],
@@ -12425,7 +12417,7 @@ var TEMPLATE_FILES = {
     ["test/plugin.test.js.tpl", "test/plugin.test.js"]
   ],
   theme: [
-    ["gutterpress.json", "gutterpress.json"],
+    ["package.json", "package.json"],
     ["README.md", "README.md"],
     ["components.yaml", "components.yaml"],
     ["snippets/callout.md", "snippets/callout.md"],
@@ -12525,7 +12517,7 @@ async function scaffoldExtension(options) {
       const src = await getAssetPath(`extension-templates/${kind}/${assetName}`);
       const dest = path19.join(extensionDir, relDest);
       await mkdir10(path19.dirname(dest), { recursive: true });
-      const text = await readFile30(src, "utf8");
+      const text = await readFile29(src, "utf8");
       const table = relDest.endsWith(".json") ? jsonSafe : plain;
       await writeFile8(dest, substitute(text, table), "utf8");
       written.push(relDest);
@@ -12535,7 +12527,7 @@ async function scaffoldExtension(options) {
   }
   return {
     extensionDir,
-    manifestPath: path19.join(extensionDir, "gutterpress.json"),
+    manifestPath: path19.join(extensionDir, "package.json"),
     kind,
     slug,
     prefix,
@@ -12551,8 +12543,8 @@ function substitute(text, table) {
   return out;
 }
 // src/lib/project-templates.ts
-import { cp as cp4, mkdir as mkdir11, readFile as readFile31, readdir as readdir7, stat as stat7, writeFile as writeFile9 } from "node:fs/promises";
-import { constants as FS3, existsSync as existsSync15 } from "node:fs";
+import { cp as cp4, mkdir as mkdir11, readFile as readFile30, readdir as readdir7, stat as stat7, writeFile as writeFile9 } from "node:fs/promises";
+import { constants as FS3, existsSync as existsSync14 } from "node:fs";
 import { access as access3 } from "node:fs/promises";
 import path20 from "node:path";
 import { isMap as isMap2, isScalar as isScalar2, isSeq as isSeq3, parseDocument as parseDocument2 } from "yaml";
@@ -12563,7 +12555,7 @@ var BUILT_IN_TEMPLATE_IDS = [
 ];
 async function readTemplateChoices(manifestPath) {
   try {
-    const text = await readFile31(manifestPath, "utf8");
+    const text = await readFile30(manifestPath, "utf8");
     const doc = parseDocument2(text);
     const out = {};
     const preset = doc.get("preset");
@@ -12653,11 +12645,11 @@ function commonAncestorDir(absFiles) {
 }
 function pickVendorDir(templateDir, base) {
   const preferred = path20.basename(base) || VENDOR_DIR;
-  if (!existsSync15(path20.join(templateDir, preferred)))
+  if (!existsSync14(path20.join(templateDir, preferred)))
     return preferred;
   for (let n = 1;; n++) {
     const candidate = `${preferred}-${n}`;
-    if (!existsSync15(path20.join(templateDir, candidate)))
+    if (!existsSync14(path20.join(templateDir, candidate)))
       return candidate;
   }
 }
@@ -12684,7 +12676,7 @@ async function reconcileSharedRefs(templateDir, sourceProjectDir, mode) {
   const externalFiles = [...new Set([...styleClosure, ...extensionFiles])].filter((f) => escapesProjectRoot(sourceProjectDir, f));
   const base = commonAncestorDir(externalFiles);
   const vendorDir = pickVendorDir(templateDir, base);
-  await Promise.all(externalFiles.filter((abs) => existsSync15(abs)).map(async (abs) => {
+  await Promise.all(externalFiles.filter((abs) => existsSync14(abs)).map(async (abs) => {
     const dest = path20.join(templateDir, vendorDir, path20.relative(base, abs));
     await mkdir11(path20.dirname(dest), { recursive: true });
     await cp4(abs, dest, { recursive: true });
@@ -12745,7 +12737,7 @@ async function saveProjectAsTemplate(options) {
 async function retokeniseManifest(manifestPath) {
   let text;
   try {
-    text = await readFile31(manifestPath, "utf8");
+    text = await readFile30(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -12766,7 +12758,7 @@ async function listCustomTemplates(templatesRoot) {
     const dir = path20.join(templatesRoot, entry.name);
     let label = prettify(entry.name);
     try {
-      const meta = JSON.parse(await readFile31(path20.join(dir, TEMPLATE_META_FILE), "utf8"));
+      const meta = JSON.parse(await readFile30(path20.join(dir, TEMPLATE_META_FILE), "utf8"));
       if (typeof meta.label === "string" && meta.label)
         label = meta.label;
     } catch {}
@@ -12792,7 +12784,7 @@ async function importTemplateFromFolder(options) {
   return saveProjectAsTemplate({ projectDir: sourceDir, name, templatesRoot });
 }
 // src/lib/snippets.ts
-import { readdir as readdir8, readFile as readFile32, writeFile as writeFile10, mkdir as mkdir12, rm as rm5 } from "node:fs/promises";
+import { readdir as readdir8, readFile as readFile31, writeFile as writeFile10, mkdir as mkdir12, rm as rm5 } from "node:fs/promises";
 import path21 from "node:path";
 var SNIPPETS_DIR = "snippets";
 var PLACEHOLDER_RE = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
@@ -12834,7 +12826,7 @@ async function scanSnippetFiles(dir) {
       continue;
     let body = "";
     try {
-      body = await readFile32(path21.join(dir, fileName), "utf8");
+      body = await readFile31(path21.join(dir, fileName), "utf8");
     } catch {
       continue;
     }
@@ -12852,7 +12844,7 @@ async function listSnippets(projectDir) {
   return files.map((file) => ({ ...file, source: { kind: "project" } }));
 }
 async function readSnippet(projectDir, fileName) {
-  return readFile32(resolveSnippetPath(projectDir, fileName), "utf8");
+  return readFile31(resolveSnippetPath(projectDir, fileName), "utf8");
 }
 async function saveSnippet(projectDir, name, body) {
   const stem = slugify(name);
@@ -12911,11 +12903,11 @@ async function readExtensionSnippet(projectDir, source, fileName) {
   if (!dir) {
     throw new Error(`Extension "${source.ref}" does not declare a usable snippets folder.`);
   }
-  return readFile32(resolveSafeChildFile(dir, fileName), "utf8");
+  return readFile31(resolveSafeChildFile(dir, fileName), "utf8");
 }
 // src/lib/extension-import.ts
-import { existsSync as existsSync16 } from "node:fs";
-import { cp as cp5, mkdir as mkdir13, mkdtemp as mkdtemp3, readFile as readFile33, rm as rm6, writeFile as writeFile11 } from "node:fs/promises";
+import { existsSync as existsSync15 } from "node:fs";
+import { cp as cp5, mkdir as mkdir13, mkdtemp as mkdtemp3, readFile as readFile32, rm as rm6, writeFile as writeFile11 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
 import path22 from "node:path";
 import { unzipSync } from "fflate";
@@ -12950,7 +12942,7 @@ function classifyThemeCssFindings(findings) {
   const warnings = reject ? [] : findings.filter((f) => f.rule !== ruleSyntax);
   return { reject, warnings };
 }
-var KNOWN_THEME_FILES = new Set(["theme.css", "theme.json", EXTENSION_MANIFEST_FILENAME]);
+var KNOWN_THEME_FILES = new Set(["theme.css", EXTENSION_MANIFEST_FILENAME]);
 var ALLOWED_ASSET_EXTS = new Set([
   ".woff",
   ".woff2",
@@ -12985,10 +12977,10 @@ function mb2(n) {
 }
 async function finalizeExtensionImport(projectDir, sourceDir, relPaths, fallbackName) {
   const cssPath = path22.join(sourceDir, "theme.css");
-  if (!existsSync16(cssPath)) {
+  if (!existsSync15(cssPath)) {
     throw new Error("A theme must contain a theme.css file.");
   }
-  const css = await readFile33(cssPath, "utf8");
+  const css = await readFile32(cssPath, "utf8");
   const { reject, warnings: printFindings } = classifyThemeCssFindings(checkCss(css, "theme.css"));
   if (reject) {
     throw new Error(`theme.css could not be parsed — ${reject.message}`);
@@ -12997,29 +12989,26 @@ async function finalizeExtensionImport(projectDir, sourceDir, relPaths, fallback
   for (const w of printFindings) {
     warnings.push({ code: "print-safety", message: w.message });
   }
-  const metaExists = existsSync16(path22.join(sourceDir, EXTENSION_MANIFEST_FILENAME)) || existsSync16(path22.join(sourceDir, "theme.json"));
+  const metaExists = existsSync15(path22.join(sourceDir, EXTENSION_MANIFEST_FILENAME));
   const meta = metaExists ? await readExtensionMeta(sourceDir) : {};
   if (!metaExists) {
     warnings.push({
       code: "no-theme-json",
-      message: "No gutterpress.json or theme.json found — the theme's name was taken from the file/folder name."
+      message: "No package.json found — one was written for you, and the theme's name was taken from the file/folder name."
     });
   } else if (!meta.name || !meta.name.trim()) {
     warnings.push({
       code: "unnamed-theme",
-      message: `The metadata file has no "name" — the theme's name was taken from the file/folder name.`
+      message: `The package.json has no "name" — the theme's name was taken from the file/folder name.`
     });
   }
   assertExtensionContained(meta);
-  const metaFilename = existsSync16(path22.join(sourceDir, EXTENSION_MANIFEST_FILENAME)) ? EXTENSION_MANIFEST_FILENAME : "theme.json";
-  const extraSheets = [
-    ...new Set(extensionStyleListWithDefault(meta, sourceDir))
-  ].filter((rel) => rel !== "theme.css");
-  const extraSheetPaths = resolveDeclaredStyles(extraSheets, sourceDir, metaFilename) ?? [];
+  const extraSheets = [...new Set(extensionStyleList(meta))].filter((rel) => rel !== "theme.css");
+  const extraSheetPaths = resolveDeclaredStyles(extraSheets, sourceDir, EXTENSION_MANIFEST_FILENAME) ?? [];
   for (let i = 0;i < extraSheets.length; i++) {
     const rel = extraSheets[i];
     const sheetPath = extraSheetPaths[i];
-    const sheetCss = await readFile33(sheetPath, "utf8");
+    const sheetCss = await readFile32(sheetPath, "utf8");
     const { reject: sheetReject, warnings: sheetFindings } = classifyThemeCssFindings(checkCss(sheetCss, rel));
     if (sheetReject) {
       throw new Error(`${rel} could not be parsed — ${sheetReject.message}`);
@@ -13041,9 +13030,30 @@ async function finalizeExtensionImport(projectDir, sourceDir, relPaths, fallback
   const dest = path22.join(projectDir, EXTENSIONS_DIR, id);
   await mkdir13(path22.dirname(dest), { recursive: true });
   await cp5(sourceDir, dest, { recursive: true });
+  await completeLandedManifest(dest, id, meta, metaExists);
   const entry = await addExtension(projectDir, `./${EXTENSIONS_DIR}/${id}`);
   return { entry, warnings };
 }
+async function completeLandedManifest(dest, id, meta, metaExists) {
+  if (metaExists && extensionStyleList(meta).length > 0)
+    return;
+  const file = path22.join(dest, EXTENSION_MANIFEST_FILENAME);
+  let pkg = {};
+  if (metaExists) {
+    try {
+      const parsed = JSON.parse(await readFile32(file, "utf8"));
+      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        pkg = parsed;
+      }
+    } catch {}
+  }
+  const gutterpress = pkg.gutterpress && typeof pkg.gutterpress === "object" && !Array.isArray(pkg.gutterpress) ? pkg.gutterpress : {};
+  await writeFile11(file, JSON.stringify({
+    ...pkg,
+    name: typeof pkg.name === "string" && pkg.name.trim() ? pkg.name : id,
+    gutterpress: { ...gutterpress, styles: ["theme.css"] }
+  }, null, 2), "utf8");
+}
 async function importExtensionFromZip(projectDir, archive) {
   if (archive.length > MAX_THEME_ARCHIVE_BYTES) {
     throw new Error(`Extension package is too large (max ${mb2(MAX_THEME_ARCHIVE_BYTES)}).`);
@@ -13119,8 +13129,8 @@ async function importExtensionFromCssText(projectDir, css, name) {
   const tmp = await mkdtemp3(path22.join(tmpdir3(), "gutterpress-theme-"));
   try {
     await writeFile11(path22.join(tmp, "theme.css"), css, "utf8");
-    await writeFile11(path22.join(tmp, "theme.json"), JSON.stringify({ name: displayName }, null, 2), "utf8");
-    const result = await finalizeExtensionImport(projectDir, tmp, ["theme.css", "theme.json"], displayName);
+    await writeFile11(path22.join(tmp, EXTENSION_MANIFEST_FILENAME), JSON.stringify({ name: slugify(displayName, "look"), gutterpress: { styles: ["theme.css"] } }, null, 2), "utf8");
+    const result = await finalizeExtensionImport(projectDir, tmp, ["theme.css", EXTENSION_MANIFEST_FILENAME], displayName);
     result.warnings.unshift({
       code: "no-theme-json",
       message: "A single CSS file was imported — its name came from the file name."
@@ -13133,11 +13143,11 @@ async function importExtensionFromCssText(projectDir, css, name) {
 async function importExtensionFromFile(projectDir, filePath) {
   const ext = path22.extname(filePath).toLowerCase();
   if (ext === ".zip") {
-    const buf = await readFile33(filePath);
+    const buf = await readFile32(filePath);
     return importExtensionFromZip(projectDir, new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength));
   }
   if (ext === ".css") {
-    const css = await readFile33(filePath, "utf8");
+    const css = await readFile32(filePath, "utf8");
     return importExtensionFromCssText(projectDir, css, prettify(path22.basename(filePath, ".css")));
   }
   throw new Error("Choose a .zip extension package or a .css stylesheet.");
@@ -13191,7 +13201,7 @@ async function importExtensionFromUrl(projectDir, url) {
     const base = trimmed.endsWith("/") ? trimmed : `${trimmed}/`;
     css = await fetchText(`${base}theme.css`);
     try {
-      const parsed = JSON.parse(await fetchText(`${base}theme.json`));
+      const parsed = JSON.parse(await fetchText(`${base}${EXTENSION_MANIFEST_FILENAME}`));
       if (parsed && typeof parsed === "object")
         meta = parsed;
     } catch {}
@@ -13203,18 +13213,137 @@ async function importExtensionFromUrl(projectDir, url) {
   const tmp = await mkdtemp3(path22.join(tmpdir3(), "gutterpress-ext-"));
   try {
     await writeFile11(path22.join(tmp, "theme.css"), css, "utf8");
+    const gp = meta.gutterpress && typeof meta.gutterpress === "object" && !Array.isArray(meta.gutterpress) ? meta.gutterpress : {};
     const finalMeta = {
-      name: typeof meta.name === "string" && meta.name || prettify(baseName),
+      name: typeof meta.name === "string" && meta.name || slugify(baseName, "look"),
       ...typeof meta.author === "string" ? { author: meta.author } : {},
       ...typeof meta.description === "string" ? { description: meta.description } : {},
-      preview: typeof meta.preview === "string" ? meta.preview : null
+      gutterpress: {
+        ...gp,
+        styles: ["theme.css"],
+        preview: typeof gp.preview === "string" ? gp.preview : null
+      }
     };
-    await writeFile11(path22.join(tmp, "theme.json"), JSON.stringify(finalMeta, null, 2), "utf8");
-    return await finalizeExtensionImport(projectDir, tmp, ["theme.css", "theme.json"], baseName);
+    await writeFile11(path22.join(tmp, EXTENSION_MANIFEST_FILENAME), JSON.stringify(finalMeta, null, 2), "utf8");
+    return await finalizeExtensionImport(projectDir, tmp, ["theme.css", EXTENSION_MANIFEST_FILENAME], baseName);
   } finally {
     await rm6(tmp, { recursive: true, force: true });
   }
 }
+// src/lib/extension-search.ts
+var FETCH_TIMEOUT_MS2 = 15000;
+var MAX_SEARCH_BYTES = 2 * 1024 * 1024;
+var SEARCH_KEYWORDS = ["gutterpress", "markdown-it-plugin"];
+var KIND_FOR_KEYWORD = {
+  gutterpress: "gutterpress",
+  "markdown-it-plugin": "markdown-it"
+};
+function invalid(reason) {
+  throw new Error(`Malformed npm search response: ${reason}.`);
+}
+function object4(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+function str2(value) {
+  return typeof value === "string" && value.trim() ? value : undefined;
+}
+function parseSearchPage(text, keyword) {
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    invalid("not valid JSON");
+  }
+  const root = object4(parsed);
+  if (!root)
+    invalid("root is not an object");
+  if (!Array.isArray(root.objects))
+    invalid('"objects" must be an array');
+  if (typeof root.total !== "number")
+    invalid('"total" must be a number');
+  const packages = [];
+  const scores = [];
+  root.objects.forEach((raw, i) => {
+    const entry = object4(raw);
+    if (!entry)
+      invalid(`objects[${i}] is not an object`);
+    const pkg = object4(entry.package);
+    if (!pkg)
+      invalid(`objects[${i}].package is not an object`);
+    const name = str2(pkg.name);
+    const version = str2(pkg.version);
+    if (!name)
+      invalid(`objects[${i}].package.name must be a non-empty string`);
+    if (!version)
+      invalid(`objects[${i}].package.version must be a non-empty string`);
+    const keywords = Array.isArray(pkg.keywords) ? pkg.keywords.filter((k) => typeof k === "string") : [];
+    if (!keywords.includes(keyword))
+      return;
+    if (name === "markdown-it" || name.startsWith("@types/"))
+      return;
+    const links = object4(pkg.links) ?? {};
+    packages.push({
+      name,
+      version,
+      ...str2(pkg.description) ? { description: str2(pkg.description) } : {},
+      kind: KIND_FOR_KEYWORD[keyword],
+      keywords,
+      ...str2(links.homepage) ? { homepage: str2(links.homepage) } : {},
+      ...str2(links.npm) ? { npmUrl: str2(links.npm) } : {},
+      ...str2(pkg.date) ? { date: str2(pkg.date) } : {}
+    });
+    scores.push(typeof entry.searchScore === "number" ? entry.searchScore : 0);
+  });
+  return { packages, scores, total: root.total };
+}
+async function searchNpmExtensions(query, options = {}) {
+  const limit = options.limit ?? 20;
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const registry = npmRegistryUrl();
+  const trimmed = query.trim();
+  const bodies = await withFetchTimeout({
+    timeoutMs: FETCH_TIMEOUT_MS2,
+    signal: options.signal,
+    timeoutMessage: "Searching npm timed out. Check your connection and try again.",
+    offlineMessage: "Couldn't reach the npm registry. Check your connection and try again."
+  }, async (signal) => {
+    const out = [];
+    for (const keyword of SEARCH_KEYWORDS) {
+      const text = [trimmed, `keywords:${keyword}`].filter(Boolean).join(" ");
+      const url = `${registry}/-/v1/search?text=${encodeURIComponent(text)}&size=${limit}`;
+      const res = await fetchImpl(url, { signal });
+      if (!res.ok) {
+        throw new FriendlyHttpError(`Failed to search npm (HTTP ${res.status}).`);
+      }
+      const body = await res.text();
+      if (Buffer.byteLength(body, "utf8") > MAX_SEARCH_BYTES) {
+        throw new FriendlyHttpError(`The npm search response is too large (limit ${MAX_SEARCH_BYTES} bytes).`);
+      }
+      out.push(body);
+    }
+    return out;
+  });
+  const pages = bodies.map((body, i) => parseSearchPage(body, SEARCH_KEYWORDS[i]));
+  const byName = new Map;
+  for (const page of pages) {
+    page.packages.forEach((match, i) => {
+      const existing = byName.get(match.name);
+      if (!existing) {
+        byName.set(match.name, { match, score: page.scores[i] ?? 0 });
+        return;
+      }
+      if (match.kind === "gutterpress")
+        existing.match = match;
+      existing.score = Math.max(existing.score, page.scores[i] ?? 0);
+    });
+  }
+  const matches = [...byName.values()].sort((a, b) => {
+    if (a.match.kind !== b.match.kind)
+      return a.match.kind === "gutterpress" ? -1 : 1;
+    return b.score - a.score;
+  }).slice(0, limit).map((entry) => entry.match);
+  return { matches, total: pages.reduce((sum, page) => sum + page.total, 0) };
+}
 // src/lib/manifest-config.ts
 import { isSeq as isSeq4, isMap as isMap3, YAMLSeq as YAMLSeq3, Scalar as Scalar2 } from "yaml";
 function hasKey(obj, key) {
@@ -13306,8 +13435,6 @@ async function setActiveStyles(projectDir, paths) {
   return paths;
 }
 // src/lib/host-policy.ts
-var AUTO_SNAPSHOT_MIN_MINUTES = 5;
-var AUTO_SNAPSHOT_MAX_MINUTES = 24 * 60;
 var AUTO_SNAPSHOT_DEFAULT_MINUTES = 10;
 var AUTO_SYNC_MIN_MINUTES = 1;
 var AUTO_SYNC_MAX_MINUTES = 24 * 60;
@@ -13321,12 +13448,6 @@ function clampedDelayMs(enabled, minutes, bounds) {
   const clamped = Math.min(bounds.max, Math.max(bounds.min, resolved));
   return clamped * 60000;
 }
-var AUTO_SNAPSHOT_BOUNDS = {
-  min: AUTO_SNAPSHOT_MIN_MINUTES,
-  max: AUTO_SNAPSHOT_MAX_MINUTES,
-  default: AUTO_SNAPSHOT_DEFAULT_MINUTES,
-  enabledDefault: true
-};
 var AUTO_SYNC_BOUNDS = {
   min: AUTO_SYNC_MIN_MINUTES,
   max: AUTO_SYNC_MAX_MINUTES,
@@ -13334,7 +13455,8 @@ var AUTO_SYNC_BOUNDS = {
   enabledDefault: true
 };
 function autoSnapshotDelayMs(policy) {
-  return clampedDelayMs(policy?.autoSnapshot, policy?.autoSnapshotMinutes, AUTO_SNAPSHOT_BOUNDS);
+  const isEnabled = policy?.autoSnapshot ?? true;
+  return isEnabled ? AUTO_SNAPSHOT_DEFAULT_MINUTES * 60000 : null;
 }
 function autoSyncDelayMs(policy) {
   return clampedDelayMs(policy?.autoSync, policy?.autoSyncMinutes, AUTO_SYNC_BOUNDS);
@@ -13355,7 +13477,7 @@ var API_BASE = "https://api.github.com";
 var REQUEST_TIMEOUT_MS = 15000;
 var OFFLINE_MESSAGE = "Couldn't reach GitHub. Check your connection and try again.";
 function defaultSleep(ms) {
-  return new Promise((resolve10) => setTimeout(resolve10, ms));
+  return new Promise((resolve9) => setTimeout(resolve9, ms));
 }
 async function safeFetch(fetchImpl, url, init) {
   return withFetchTimeout({
@@ -13582,7 +13704,7 @@ function friendlyTokenError(status, body) {
 var SUCCESS_HTML = `<html><body style="font:16px system-ui;padding:3rem"><h2>You're connected</h2><p>Return to Gutterpress — you can close this tab.</p></body></html>`;
 var FAILURE_HTML = `<html><body style="font:16px system-ui;padding:3rem"><h2>Sign-in didn't complete</h2><p>Return to Gutterpress and try again.</p></body></html>`;
 function waitForCallback(server, expectedState, redirectUri, timeoutMs, signal) {
-  return new Promise((resolve10, reject) => {
+  return new Promise((resolve9, reject) => {
     let settled = false;
     const cleanup = () => {
       clearTimeout(timer);
@@ -13596,7 +13718,7 @@ function waitForCallback(server, expectedState, redirectUri, timeoutMs, signal)
         return;
       settled = true;
       cleanup();
-      resolve10(value);
+      resolve9(value);
     };
     const finishReject = (err) => {
       if (settled)
@@ -13668,14 +13790,14 @@ class GoogleAuthProvider {
     const state = b64url(crypto.randomBytes(16));
     const challenge = pkceChallengeFromVerifier(verifier);
     const server = http2.createServer();
-    await new Promise((resolve10, reject) => {
+    await new Promise((resolve9, reject) => {
       const onListenError = (err) => {
         reject(new Error(`Couldn't start the local sign-in listener: ${err.message}`));
       };
       server.once("error", onListenError);
       server.listen(this.bindPort, "127.0.0.1", () => {
         server.removeListener("error", onListenError);
-        resolve10();
+        resolve9();
       });
     });
     const address = server.address();
@@ -14357,8 +14479,8 @@ async function testRemoteAccess(options) {
   const credential = options.credential ?? urlCredential;
   const timeoutMs = options.timeoutMs ?? 15000;
   let timer;
-  const timeout = new Promise((resolve10) => {
-    timer = setTimeout(() => resolve10(failure("unreachable")), timeoutMs);
+  const timeout = new Promise((resolve9) => {
+    timer = setTimeout(() => resolve9(failure("unreachable")), timeoutMs);
   });
   const probe = (async () => {
     try {
@@ -14793,7 +14915,7 @@ var DEFAULT_SYNC_RETRY = {
   backoffMs: 150
 };
 function defaultSleep2(ms) {
-  return new Promise((resolve10) => setTimeout(resolve10, ms));
+  return new Promise((resolve9) => setTimeout(resolve9, ms));
 }
 async function syncProject(options) {
   const http3 = options.httpClient ?? defaultGitHttp;
@@ -15176,7 +15298,7 @@ var drivethrurpgProvider = {
 };
 
 // src/lib/publish/providers/gdrive.ts
-import { mkdtemp as mkdtemp4, readFile as readFile34, readdir as readdir10, rm as rm8, stat as stat9, writeFile as writeFile14 } from "node:fs/promises";
+import { mkdtemp as mkdtemp4, readFile as readFile33, readdir as readdir10, rm as rm8, stat as stat9, writeFile as writeFile14 } from "node:fs/promises";
 import { tmpdir as tmpdir4 } from "node:os";
 import path26 from "node:path";
 import { Zip, ZipDeflate } from "fflate";
@@ -15325,7 +15447,7 @@ var RESUMABLE_CHUNK_SIZE = 8 * 1024 * 1024;
 var MAX_CHUNK_RETRIES = 3;
 var RETRY_BASE_DELAY_MS = 500;
 function defaultSleep3(ms) {
-  return new Promise((resolve10) => setTimeout(resolve10, ms));
+  return new Promise((resolve9) => setTimeout(resolve9, ms));
 }
 async function startResumableSession(fetchImpl, accessToken, opts) {
   const mimeType = opts.mimeType ?? "application/pdf";
@@ -15507,10 +15629,10 @@ function toDestination(folder) {
 }
 var ZIP_CHUNK_BYTES = 64 * 1024;
 function yieldToEventLoop() {
-  return new Promise((resolve10) => setImmediate(resolve10));
+  return new Promise((resolve9) => setImmediate(resolve9));
 }
 function zipEntriesNonBlocking(entries, opts) {
-  return new Promise((resolve10, reject) => {
+  return new Promise((resolve9, reject) => {
     const chunks = [];
     let total = 0;
     let settled = false;
@@ -15534,7 +15656,7 @@ function zipEntriesNonBlocking(entries, opts) {
           out.set(c, offset);
           offset += c.length;
         }
-        resolve10(out);
+        resolve9(out);
       }
     });
     (async () => {
@@ -15568,12 +15690,12 @@ async function collectZipEntries(root, dir, out, onWarn) {
       await collectZipEntries(root, full, out, onWarn);
     } else if (entry.isFile()) {
       const rel = path26.relative(root, full).split(path26.sep).join("/");
-      out[rel] = await readFile34(full);
+      out[rel] = await readFile33(full);
     } else if (entry.isSymbolicLink()) {
       const resolved = await stat9(full).catch(() => null);
       if (resolved?.isFile()) {
         const rel = path26.relative(root, full).split(path26.sep).join("/");
-        out[rel] = await readFile34(full);
+        out[rel] = await readFile33(full);
       } else if (resolved?.isDirectory()) {
         await collectZipEntries(root, full, out, onWarn);
       } else {
@@ -16390,7 +16512,7 @@ async function disconnectPublishCredential(key, deps, options = {}) {
   }
 }
 // src/lib/publish/selections.ts
-import { chmod as chmod3, mkdir as mkdir18, readFile as readFile35, writeFile as writeFile16 } from "node:fs/promises";
+import { chmod as chmod3, mkdir as mkdir18, readFile as readFile34, writeFile as writeFile16 } from "node:fs/promises";
 import path29 from "node:path";
 class PublishSelectionsStore {
   filePath;
@@ -16400,7 +16522,7 @@ class PublishSelectionsStore {
   }
   async read() {
     try {
-      const raw = await readFile35(this.filePath, "utf8");
+      const raw = await readFile34(this.filePath, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed && typeof parsed === "object") {
         return {
@@ -16516,4 +16638,4 @@ async function setPublishProviderConfig(projectDir, providerId, values) {
   await writeManifestDoc(file, doc);
   return settingsFromDoc(doc);
 }
-export { PLUGINS_DIR, BUNDLED_EXTENSIONS, isBundledExtension, isPathSpecifier, parseExtensionSpecifier, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, SYNC_SNAPSHOT_MESSAGE, log, resolveActiveStyles, listProjectStyles, EXTENSION_MANIFEST_FILENAME, LEGACY_THEME_MANIFEST_FILENAME, readExtensionMeta, extensionStyleList, extensionStyleListWithDefault, extensionCarries, pathEscapesFolder, assertExtensionContained, resolveExtension, ruleRemoteUrls, ruleRiskyProps, ruleSyntax, checkCss, runLint, formatReport, getChecks, getCheckById, resolveCheckSelectors, inspectImage, runChecks, checkToolAvailability, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, defaultConfigDir, FileTokenStore, extractUrlCredential, getSystemDiagnostics, EXTENSIONS_DIR, RECOMMENDED_EXTENSIONS, BUILT_IN_STYLE_SET_IDS, sameExtension, listProjectExtensions, describeExtension, setExtensionEnabled, reorderExtensions, removeExtension, addExtension, listBuiltInStyleSets, addBuiltInStyleSet, validateProjectExtensions, readExtensionCss, slugifyProjectName, escapeYamlScalar, scaffoldProject, adoptFolder, EXTENSION_KINDS, RESERVED_PREFIX, resolveExtensionPrefix, scaffoldExtension, BUILT_IN_TEMPLATE_IDS, listBuiltInTemplates, saveProjectAsTemplate, listCustomTemplates, importTemplateFromFolder, SNIPPETS_DIR, extractVariables, substituteVariables, listSnippets, readSnippet, saveSnippet, deleteSnippet, listMergedSnippets, readExtensionSnippet, importExtensionFromFile, importExtensionFromUrl, setManifestFields, readManifestFields, setActiveStyles, AUTO_SNAPSHOT_MIN_MINUTES, AUTO_SNAPSHOT_MAX_MINUTES, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, AUTO_SYNC_PUSH_INTERVAL_MINUTES, autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, resolveGitHubClientId, GITHUB_HOST, GitHubAuthProvider, GDRIVE_HOST, resolveGoogleClientId, resolveGoogleClientSecret, GOOGLE_NOT_CONFIGURED_MESSAGE, requireGoogleClientCredentials, pkceChallengeFromVerifier, GoogleAuthProvider, revokeGoogleCredential, publishCredentialKey, publishConnectionStatus, listPublishAccounts, connectGoogleDrive, listGitHubRepositories, listRepoBooks, listGitHubBranches, sanitizeCloneFolderName, cloneRepository, isSshRemoteUrl, testRemoteAccess, knownForgeTokenUrl, connectGenericHost, parseRemoteOrigin, forgeKindForHost, diagnoseProjectRemote, syncProject, listPublishProviders, publishProviderFor, resolvePublishFormat, resolvePublishRequest, runPublish, connectPublishProvider, disconnectPublishCredential, PublishSelectionsStore, readPublishSettings, setPublishProviderConfig };
+export { DEFAULT_NPM_REGISTRY, npmRegistryUrl, PLUGINS_DIR, BUNDLED_EXTENSIONS, isBundledExtension, isPathSpecifier, parseExtensionSpecifier, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, SYNC_SNAPSHOT_MESSAGE, log, resolveActiveStyles, listProjectStyles, EXTENSION_MANIFEST_FILENAME, readExtensionMeta, extensionStyleList, extensionEntry, extensionCarries, pathEscapesFolder, assertExtensionContained, resolveExtension, loadPluginsWithCss, formatReport, getChecks, getCheckById, resolveCheckSelectors, ruleRemoteUrls, ruleRiskyProps, ruleSyntax, rulePageContainment, checkCss, inspectImage, runChecks, checkToolAvailability, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, defaultConfigDir, FileTokenStore, extractUrlCredential, getSystemDiagnostics, EXTENSIONS_DIR, RECOMMENDED_EXTENSIONS, BUILT_IN_STYLE_SET_IDS, sameExtension, listProjectExtensions, describeExtension, setExtensionEnabled, reorderExtensions, removeExtension, addExtension, listBuiltInStyleSets, addBuiltInStyleSet, validateProjectExtensions, readExtensionCss, slugifyProjectName, escapeYamlScalar, scaffoldProject, adoptFolder, EXTENSION_KINDS, RESERVED_PREFIX, resolveExtensionPrefix, scaffoldExtension, BUILT_IN_TEMPLATE_IDS, listBuiltInTemplates, saveProjectAsTemplate, listCustomTemplates, importTemplateFromFolder, SNIPPETS_DIR, extractVariables, substituteVariables, listSnippets, readSnippet, saveSnippet, deleteSnippet, listMergedSnippets, readExtensionSnippet, importExtensionFromFile, importExtensionFromUrl, MAX_SEARCH_BYTES, SEARCH_KEYWORDS, searchNpmExtensions, setManifestFields, readManifestFields, setActiveStyles, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, AUTO_SYNC_PUSH_INTERVAL_MINUTES, autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, resolveGitHubClientId, GITHUB_HOST, GitHubAuthProvider, GDRIVE_HOST, resolveGoogleClientId, resolveGoogleClientSecret, GOOGLE_NOT_CONFIGURED_MESSAGE, requireGoogleClientCredentials, pkceChallengeFromVerifier, GoogleAuthProvider, revokeGoogleCredential, publishCredentialKey, publishConnectionStatus, listPublishAccounts, connectGoogleDrive, listGitHubRepositories, listRepoBooks, listGitHubBranches, sanitizeCloneFolderName, cloneRepository, isSshRemoteUrl, testRemoteAccess, knownForgeTokenUrl, connectGenericHost, parseRemoteOrigin, forgeKindForHost, diagnoseProjectRemote, syncProject, listPublishProviders, publishProviderFor, resolvePublishFormat, resolvePublishRequest, runPublish, connectPublishProvider, disconnectPublishCredential, PublishSelectionsStore, readPublishSettings, setPublishProviderConfig };