gutterpress 0.11.23-alpha.2 → 0.11.23-alpha.3

package/dist/{index-j5z86r4a.js → index-prqvz3xm.js}

@@ -2,6 +2,7 @@ import {
   DEBOUNCE,
   FriendlyHttpError,
   MANIFEST_FILENAMES,
+  MARGIN_EDGES,
   PRESETS,
   PRESET_IDS,
   TARGETS,
@@ -9,25 +10,34 @@ import {
   UsageError,
   addExtension,
   applyDefaultPdfStrictChecks,
+  cssLength,
   ensureProjectGitignore,
-  ensureSeq,
   extensionConfigFor,
+  formatPageSize,
+  isNonNegativePoints,
+  isPositivePoints,
+  judgeRect,
   listProjectExtensions,
   loadManifest,
   loadManifestDoc,
   loadManifestWithPath,
   npmRegistryUrl,
+  pageBoxes,
+  printAreaMeta,
   publishTargetFor,
+  readEntryCss,
   resolveConfig,
   resolveConfigForTarget,
   resolvePort,
   resolveTargets,
   restoreForCommand,
+  round3,
   scalarString,
   uniqueExtensionId,
+  validatePageMargin,
   withFetchTimeout,
   writeManifestDoc
-} from "./index-x3ema2w3.js";
+} from "./index-7pck1q9c.js";
 import {
   EXTENSION_MANIFEST_FILENAME,
   GUTTERPRESS_CSS,
@@ -63,18 +73,18 @@ import {
   setLogLevel,
   slugify,
   warn
-} from "./index-2bjcghze.js";
+} from "./index-0wee4408.js";
 import {
   blackTextToGray
 } from "./index-ht1bcqdd.js";
 import {
+  DEFAULT_PAGE_MARGIN_PT,
   MARGIN_BOX_IGNORED_PROPERTIES,
   extract,
   getAssetPath,
   lastPageMode,
-  parseSize,
   resolvePage
-} from "./index-0skhjx3e.js";
+} from "./index-nedd07bk.js";
 import {
   BuildError
 } from "./index-46ycxe6r.js";
@@ -185,95 +195,26 @@ function canonicalChapterId(p) {
   return s;
 }
 
-// src/engine/shared/print-area.ts
-function isPositivePoints(value) {
-  return typeof value === "number" && Number.isFinite(value) && value > 0;
-}
-var round3 = (n) => Math.round(n * 1000) / 1000;
-function cssLength(pt) {
-  const inches = round3(pt / 72);
-  return Math.abs(inches * 72 - pt) < 0.000001 ? `${inches}in` : `${round3(pt)}pt`;
-}
-function formatPageSize(page) {
-  return `${cssLength(page.width)} ${cssLength(page.height)}`;
-}
-function printAreaMeta(page) {
-  const area = JSON.stringify({
-    width: page.width,
-    height: page.height,
-    bleed: page.bleed ?? 0,
-    safe: page.safe ?? 0,
-    artSafe: page.artSafe,
-    gutter: page.gutter,
-    preset: page.preset,
-    spec: page.spec
-  });
-  return `<meta name="gp-print-area" content='${area.replace(/&/g, "&amp;").replace(/'/g, "&#39;")}'>`;
-}
-function pageBoxes(area, side, scale = 1) {
-  const w = area.width * scale;
-  const h = area.height * scale;
-  const b = Math.max(0, area.bleed) * scale;
-  const s = Math.max(0, area.safe) * scale;
-  const a = Math.max(0, area.artSafe) * scale;
-  const g = Math.max(0, area.gutter) * scale;
-  const [textLeft, textRight] = side === "verso" ? [s, g] : [g, s];
-  const [artLeft, artRight] = side === "verso" ? [a, g] : [g, a];
-  const trim = { x: side === "verso" ? b : 0, y: b, w: Math.max(0, w - b), h: Math.max(0, h - 2 * b) };
-  return {
-    sheet: { x: 0, y: 0, w, h },
-    trim,
-    safe: {
-      x: trim.x + textLeft,
-      y: trim.y + s,
-      w: Math.max(0, trim.w - textLeft - textRight),
-      h: Math.max(0, trim.h - 2 * s)
-    },
-    safeArt: {
-      x: trim.x + artLeft,
-      y: trim.y + a,
-      w: Math.max(0, trim.w - artLeft - artRight),
-      h: Math.max(0, trim.h - 2 * a)
-    },
-    bleed: b
-  };
-}
-var SEVERITY = { inside: 0, unsafe: 1, bleed: 2, "off-page": 3 };
-function judgeRect(r, boxes, rule, tol = 0) {
-  const { sheet, trim } = boxes;
-  const safe = rule === "art" ? boxes.safeArt : boxes.safe;
-  const sides = [
-    ["left", -r.x, -safe.x, -trim.x, -sheet.x],
-    ["right", r.x + r.w, safe.x + safe.w, trim.x + trim.w, sheet.x + sheet.w],
-    ["top", -r.y, -safe.y, -trim.y, -sheet.y],
-    ["bottom", r.y + r.h, safe.y + safe.h, trim.y + trim.h, sheet.y + sheet.h]
-  ];
-  let worst = { kind: "inside", gap: 0, need: 0, edge: null };
-  let beyond = 0;
-  for (const [edge, ink, limit, trimEdge, sheetEdge] of sides) {
-    const past = ink - limit;
-    if (past <= tol || rule === "art" && ink >= sheetEdge - tol)
-      continue;
-    const kind = ink > sheetEdge + tol ? "off-page" : ink > trimEdge + tol ? "bleed" : "unsafe";
-    if (SEVERITY[kind] > SEVERITY[worst.kind] || kind === worst.kind && past > beyond) {
-      worst = { kind, gap: trimEdge - ink, need: trimEdge - limit, edge };
-      beyond = past;
-    }
-  }
-  return worst;
-}
-
 // src/lib/markdown/assemble.ts
-function defaultPageSizeCss(css, page) {
+function pageGeometryCss(page) {
   if (!page || !isPositivePoints(page.width) || !isPositivePoints(page.height))
     return null;
-  try {
-    if (resolvePage(extract(css)).decls.size !== undefined)
-      return null;
-  } catch {
+  const size = `size: ${formatPageSize(page)};`;
+  const m = page.margin;
+  if (!m)
+    return `@page { ${size} }`;
+  const [top, bottom, inside, outside] = [m.top, m.bottom, m.inside, m.outside].map(cssLength);
+  const recto = `margin: ${top} ${outside} ${bottom} ${inside};`;
+  const verso = `margin: ${top} ${inside} ${bottom} ${outside};`;
+  return [`@page { ${size} ${recto} }`, `@page :left { ${verso} }`, `@page :right { ${recto} }`].join(`
+`);
+}
+function defaultPageMarginCss(page) {
+  if (!page || page.margin)
     return null;
-  }
-  return `@page { size: ${formatPageSize(page)}; }`;
+  return `@layer gp.vocab {
+@page { margin: ${cssLength(DEFAULT_PAGE_MARGIN_PT)}; }
+}`;
 }
 async function assembleBookHtml(opts) {
   const title = opts.title ?? "Document";
@@ -313,8 +254,8 @@ async function assembleBookHtml(opts) {
       imageRefs.add(ref);
     opts.onImageRefs([...imageRefs]);
   }
-  const pageSize = defaultPageSizeCss(`${pluginCss}
-${projectCss}`, opts.printArea);
+  const pageGeometry = pageGeometryCss(opts.printArea);
+  const defaultMargin = defaultPageMarginCss(opts.printArea);
   const inlineCss = [
     "@layer gp.marker, gp.vocab;",
     `/* gutterpress markers */
@@ -326,14 +267,16 @@ ${TWO_VERSIONS_CSS.trim()}
 @layer gp.vocab {
 ${GUTTERPRESS_CSS.trim()}
 }`,
-    pageSize ? `/* page size (manifest) */
-${pageSize}` : null,
+    defaultMargin ? `/* page margins (default) */
+${defaultMargin}` : null,
     pluginCss ? `/* extension css */
 ${pluginCss.trim()}` : null,
     `/* column alignment */
 ${TABLE_ALIGN_CSS.trim()}`,
     projectCss ? `/* project css */
-${projectCss.trim()}` : null
+${projectCss.trim()}` : null,
+    pageGeometry ? `/* page geometry (manifest) */
+${pageGeometry}` : null
   ].filter(Boolean).join(`
 
 `);
@@ -2833,6 +2776,7 @@ var ruleRiskyProps = "printsafe/no-risky-print-effects";
 var ruleSyntax = "printsafe/syntax-error";
 var rulePageContainment = "printsafe/page-containment";
 var rulePreviewCannotFollow = "printsafe/preview-cannot-follow";
+var rulePageSizeInStylesheet = "printsafe/page-size-in-stylesheet";
 function extractUrls(value) {
   const urls = [];
   const re = /url\(\s*(['"]?)(.*?)\1\s*\)/gi;
@@ -2881,6 +2825,12 @@ function isInPageBox(decl) {
   const page = decl.parent;
   return !!page && page.type === "atrule" && page.name.toLowerCase() === "page";
 }
+function isInBookPageRule(decl) {
+  if (!isInPageBox(decl))
+    return false;
+  const params = decl.parent.params.trim();
+  return params === "" || /^(:[a-z-]+\s*)+$/i.test(params);
+}
 function isDroppedPageGradient(decl) {
   const prop = decl.prop.toLowerCase();
   if (prop !== "background" && prop !== "background-image")
@@ -3120,6 +3070,15 @@ function checkCssRaw(css, from) {
   root.walkAtRules((at) => reportRemoteUrls(at.params || "", at));
   root.walkDecls((decl) => {
     const prop = decl.prop.toLowerCase();
+    if (prop === "size" && isInBookPageRule(decl)) {
+      warnings.push({
+        rule: rulePageSizeInStylesheet,
+        severity: "warning",
+        message: `"size" in a stylesheet's @page rule is ignored: the page size comes from the manifest (preset:, or page: width and height — Setup > Details in the app), which is written after every stylesheet. Remove this declaration; to print at another size, change the manifest.`,
+        ...nodeLoc(decl)
+      });
+      return;
+    }
     if (isInertValue(prop, decl.value))
       return;
     if (marginBoxIgnoredProperties.has(prop) && isInPageMarginBox(decl)) {
@@ -5669,7 +5628,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path7.join(stage, "raw.pdf") : path7.resolve(pdfFile);
       await fsp2.mkdir(path7.dirname(path7.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-tn13gk0b.js");
+      const { buildNativePdf } = await import("./engine-1r6q80tq.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,
@@ -7206,20 +7165,18 @@ async function getSystemDiagnostics() {
   };
 }
 // src/lib/project-scaffold.ts
-import { access, copyFile, cp, mkdir as mkdir6, readdir as readdir6, readFile as readFile25, stat as stat4, writeFile as writeFile8 } from "node:fs/promises";
+import { access, copyFile, cp, mkdir as mkdir5, readdir as readdir6, readFile as readFile25, stat as stat4, writeFile as writeFile7 } from "node:fs/promises";
 import { constants as FS, existsSync as existsSync9 } from "node:fs";
 import path14 from "node:path";
 
 // src/lib/page-size.ts
 import { existsSync as existsSync8 } from "node:fs";
-import { mkdir as mkdir5, readFile as readFile24, writeFile as writeFile7 } from "node:fs/promises";
+import { readFile as readFile24 } from "node:fs/promises";
 import path13 from "node:path";
-import postcss5 from "postcss";
-import { isMap, Scalar } from "yaml";
+import { isMap } from "yaml";
 function writePageBounds(doc, page) {
   const tolerance = page.tolerance ?? numberAt(doc, ["page", "tolerance"]);
-  if (!isMap(doc.get("page", true)))
-    doc.set("page", doc.createNode({}));
+  ensurePageMap(doc);
   doc.setIn(["page", "width"], page.width);
   doc.setIn(["page", "height"], page.height);
   if (tolerance !== undefined)
@@ -7236,6 +7193,17 @@ function deletePageBounds(doc) {
   if (block.items.length === 0)
     doc.delete("page");
 }
+function writePageMargin(doc, margin) {
+  ensurePageMap(doc);
+  if (!isMap(doc.getIn(["page", "margin"], true)))
+    doc.setIn(["page", "margin"], doc.createNode({}));
+  for (const edge of MARGIN_EDGES)
+    doc.setIn(["page", "margin", edge], margin[edge]);
+}
+function ensurePageMap(doc) {
+  if (!isMap(doc.get("page", true)))
+    doc.set("page", doc.createNode({}));
+}
 function numberAt(doc, keyPath) {
   const v = doc.getIn(keyPath);
   return isPositivePoints(v) ? v : undefined;
@@ -7254,132 +7222,95 @@ function pageSizeForChoice(choice) {
   const base = PRESETS[choice.preset].page;
   return { width: base.width, height: base.height };
 }
-var SAME_SIZE_PT = 0.5;
-function sameSize(a, b) {
-  return Math.abs(a.width - b.width) < SAME_SIZE_PT && Math.abs(a.height - b.height) < SAME_SIZE_PT;
-}
-function plainPageRules(root) {
-  const rules = [];
-  root.walkAtRules("page", (rule) => {
-    if (rule.params.trim() === "")
-      rules.push(rule);
-  });
-  return rules;
-}
-function sizeDeclsOf(rule) {
-  const decls = [];
-  rule.each((node) => {
-    if (node.type === "decl" && node.prop.toLowerCase() === "size")
-      decls.push(node);
-  });
-  return decls;
-}
-function readPageSizeFromCss(css) {
-  let root;
-  try {
-    root = postcss5.parse(css);
-  } catch {
-    return null;
-  }
-  const decls = plainPageRules(root).flatMap(sizeDeclsOf);
-  const last = decls[decls.length - 1];
-  return last ? parseSize(last.value) ?? null : null;
-}
-function setPageSizeInCss(css, page) {
-  const root = postcss5.parse(css);
-  const decls = plainPageRules(root).flatMap(sizeDeclsOf);
-  const last = decls[decls.length - 1];
-  const value = formatPageSize(page);
-  if (last) {
-    const current = parseSize(last.value);
-    if (current && sameSize(current, page))
-      return css;
-    last.value = value;
-    return root.toString();
-  }
-  const rule = `@page {
-  size: ${value};
-}
-`;
-  if (css.trim() === "")
-    return css + rule;
-  return `${css}${css.endsWith(`
-`) ? "" : `
-`}
-${rule}`;
-}
-async function ownStylesheets(projectDir) {
-  const rels = await resolveActiveStyles(projectDir).catch(() => []);
-  return rels.map((rel) => path13.resolve(projectDir, rel)).filter((abs) => {
-    const inside = path13.relative(projectDir, abs);
-    return !inside.startsWith("..") && !path13.isAbsolute(inside) && existsSync8(abs);
-  });
-}
-var relDisplay2 = (projectDir, abs) => path13.relative(projectDir, abs).split(path13.sep).join("/");
-async function findCssSize(projectDir, sheets) {
-  let found = null;
-  for (const file of sheets) {
-    const size2 = readPageSizeFromCss(await readFile24(file, "utf8"));
-    if (size2)
-      found = { file, size: size2 };
-  }
-  return found;
-}
-async function readPageSetup(projectDir) {
-  const { doc } = await loadManifestDoc(projectDir);
+function manifestGeometry(doc) {
   const declared = doc.get("preset");
   const preset = declared === undefined || declared === null ? "dtrpg" : PRESET_IDS.includes(String(declared)) ? declared : null;
   const base = preset ? PRESETS[preset].page : null;
   const width = numberAt(doc, ["page", "width"]) ?? base?.width;
   const height = numberAt(doc, ["page", "height"]) ?? base?.height;
   const tolerance = numberAt(doc, ["page", "tolerance"]) ?? base?.tolerance ?? 0.5;
-  const found = await findCssSize(projectDir, await ownStylesheets(projectDir));
-  return {
-    preset,
-    bounds: width !== undefined && height !== undefined ? { width, height, tolerance } : null,
-    css: found ? { ...found.size, file: relDisplay2(projectDir, found.file) } : null
+  const bounds = width !== undefined && height !== undefined ? { width, height, tolerance } : null;
+  const at = (edge) => doc.getIn(["page", "margin", edge]);
+  const margins = MARGIN_EDGES.every((edge) => isNonNegativePoints(at(edge))) ? { top: at("top"), bottom: at("bottom"), inside: at("inside"), outside: at("outside") } : undefined;
+  return { preset, bounds, ...margins ? { margins } : {} };
+}
+async function stylesheetMargins(projectDir, manifestStyles) {
+  const d = DEFAULT_PAGE_MARGIN_PT;
+  const fallback = {
+    margins: { top: d, bottom: d, inside: d, outside: d },
+    marginsFrom: "default"
   };
-}
-async function setPageSetup(projectDir, choice) {
-  const size2 = pageSizeForChoice(choice);
-  const sheets = await ownStylesheets(projectDir);
-  const found = await findCssSize(projectDir, sheets);
-  const newSheet = path13.join(projectDir, "styles", "book.css");
-  const target = found?.file ?? sheets[sheets.length - 1] ?? newSheet;
-  const before = existsSync8(target) ? await readFile24(target, "utf8") : "";
-  let after;
+  const [entries, rels] = await Promise.all([
+    listProjectExtensions(projectDir).catch(() => []),
+    resolveActiveStyles(projectDir, manifestStyles).catch(() => [])
+  ]);
+  const sheets = rels.map((rel) => path13.resolve(projectDir, rel)).filter((abs) => existsSync8(abs));
+  const parts = await Promise.all([
+    ...entries.filter((e) => e.enabled && e.carries.styles).map((e) => readEntryCss(e).catch(() => "")),
+    ...sheets.map((file) => readFile24(file, "utf8").catch(() => ""))
+  ]);
   try {
-    after = setPageSizeInCss(before, size2);
-  } catch (e) {
-    throw new UsageError(`Could not update the page size: ${relDisplay2(projectDir, target)} has a CSS error ` + `(${e instanceof Error ? e.message : String(e)}). Fix it, then try again.`);
+    const page = resolvePage(extract(parts.join(`
+
+`)), { pseudos: ["right"] });
+    const declared = Object.keys(page.decls).some((prop) => prop === "margin" || prop.startsWith("margin-"));
+    if (!declared)
+      return fallback;
+    const m = page.geometry.margin;
+    return {
+      margins: { top: round3(m.top), bottom: round3(m.bottom), inside: round3(m.left), outside: round3(m.right) },
+      marginsFrom: "stylesheet"
+    };
+  } catch {
+    return fallback;
   }
+}
+async function setupOf(projectDir, doc) {
+  const { margins, ...geometry } = manifestGeometry(doc);
+  if (margins)
+    return { ...geometry, margins, marginsFrom: "manifest" };
+  const styles = doc.toJS()?.styles;
+  return { ...geometry, ...await stylesheetMargins(projectDir, Array.isArray(styles) ? styles : undefined) };
+}
+async function readPageSetup(projectDir) {
+  const { doc } = await loadManifestDoc(projectDir);
+  return setupOf(projectDir, doc);
+}
+async function setPageSetup(projectDir, change) {
   const { doc, file } = await loadManifestDoc(projectDir);
-  doc.set("preset", choice.preset);
-  if (choice.preset === "custom")
-    writePageBounds(doc, size2);
-  else
-    deletePageBounds(doc);
-  if (target === newSheet && !sheets.includes(newSheet)) {
-    ensureSeq(doc, "styles").add(new Scalar("styles/book.css"));
+  const size2 = change.size ? pageSizeForChoice(change.size) : null;
+  let margins;
+  if (change.margins !== undefined) {
+    const against = size2 ?? manifestGeometry(doc).bounds;
+    if (!against)
+      throw new UsageError("Choose a page size before setting margins: the manifest records none.");
+    margins = validatePageMargin(change.margins, against);
+  }
+  if (change.size && size2) {
+    doc.set("preset", change.size.preset);
+    if (change.size.preset === "custom")
+      writePageBounds(doc, size2);
+    else
+      deletePageBounds(doc);
   }
+  if (margins)
+    writePageMargin(doc, margins);
   await writeManifestDoc(file, doc);
-  if (after !== before || !existsSync8(target)) {
-    await mkdir5(path13.dirname(target), { recursive: true });
-    await writeFile7(target, after, "utf8");
-  }
-  return readPageSetup(projectDir);
+  return setupOf(projectDir, doc);
 }
 
 // src/lib/project-scaffold.ts
 function starterOverridesCss() {
   return `/**
- * Your book's own styles.
+ * Your book's own styles. Rules here win over your look's.
  *
- * This file loads AFTER every extension, so any rule you add here overrides
- * a look's defaults. A new book has no look until its template or you add
- * one:
- *   gutterpress ext add academic <book>    (a built-in look)
- *   gutterpress ext add <package> <book>   (a look from npm)
+ * In the app you rarely need this file: Setup > Looks & features adds a
+ * look, Setup > Design changes its fonts, colors and sizes (those changes
+ * are saved here as :root custom properties), and Setup > Details sets the
+ * page size and margins (in the manifest).
+ *
+ * To change the look from the command line: gutterpress ext remove <old>
+ * <book>, then gutterpress ext add <look> <book>.
  */
 `;
 }
@@ -7462,7 +7393,7 @@ async function scaffoldProject(options) {
   const preset = options.preset === undefined ? undefined : requirePreset(options.preset, options.customPage);
   const targets = preset ? resolveScaffoldTargets(options.targets, preset) : undefined;
   try {
-    await mkdir6(projectDir, { recursive: true });
+    await mkdir5(projectDir, { recursive: true });
     if (customTemplateDir) {
       const entries = await readdir6(customTemplateDir, { withFileTypes: true });
       for (const entry of entries) {
@@ -7470,15 +7401,15 @@ async function scaffoldProject(options) {
           continue;
         await cp(path14.join(customTemplateDir, entry.name), path14.join(projectDir, entry.name), { recursive: true });
       }
-      await mkdir6(path14.join(projectDir, "assets"), { recursive: true });
+      await mkdir5(path14.join(projectDir, "assets"), { recursive: true });
     } else {
       const tplManifest = await getAssetPath(`templates/${template}/manifest.yaml`);
       const tplChapter = await getAssetPath(`templates/${template}/chapter-01.md`);
-      await mkdir6(path14.join(projectDir, "assets"), { recursive: true });
+      await mkdir5(path14.join(projectDir, "assets"), { recursive: true });
       await copyFile(tplManifest, path14.join(projectDir, MANIFEST_FILENAMES[0]));
       await copyFile(tplChapter, path14.join(projectDir, "chapter-01.md"));
-      await mkdir6(path14.join(projectDir, "styles"), { recursive: true });
-      await writeFile8(path14.join(projectDir, "styles", "book.css"), starterOverridesCss(), "utf8");
+      await mkdir5(path14.join(projectDir, "styles"), { recursive: true });
+      await writeFile7(path14.join(projectDir, "styles", "book.css"), starterOverridesCss(), "utf8");
     }
   } catch (e) {
     throw new CreateProjectErrorImpl("scaffold-io", `Could not create the book files: ${e instanceof Error ? e.message : String(e)}`);
@@ -7502,6 +7433,8 @@ async function scaffoldProject(options) {
       if (preset) {
         doc.set("preset", preset);
         doc.set("targets", doc.createNode(targets ?? []));
+        if (preset !== "custom")
+          deletePageBounds(doc);
       }
       if (options.customPage)
         writePageBounds(doc, options.customPage);
@@ -7579,10 +7512,10 @@ async function adoptFolder(options) {
       await fillTemplateFile(path14.join(dir, "chapter-01.md"), { "{{TITLE}}": title }).catch(() => {});
       mdFiles = ["chapter-01.md"];
     }
-    await mkdir6(path14.join(dir, "styles"), { recursive: true });
+    await mkdir5(path14.join(dir, "styles"), { recursive: true });
     const bookCssPath = path14.join(dir, "styles", "book.css");
     if (!existsSync9(bookCssPath)) {
-      await writeFile8(bookCssPath, starterOverridesCss(), "utf8");
+      await writeFile7(bookCssPath, starterOverridesCss(), "utf8");
     }
     const filesYaml = mdFiles.map((f) => `    - "${escapeYamlScalar(f)}"`).join(`
 `);
@@ -7598,8 +7531,8 @@ ${filesYaml}
 styles:
   - styles/book.css
 `;
-    await writeFile8(path14.join(dir, MANIFEST_FILENAMES[0]), manifest, "utf8");
-    await mkdir6(path14.join(dir, "assets"), { recursive: true });
+    await writeFile7(path14.join(dir, MANIFEST_FILENAMES[0]), manifest, "utf8");
+    await mkdir5(path14.join(dir, "assets"), { recursive: true });
     await ensureProjectGitignore(dir);
   } catch (e) {
     if (e instanceof CreateProjectErrorImpl)
@@ -7653,10 +7586,10 @@ async function fillTemplateFile(filePath, substitutions) {
   for (const [token, value] of Object.entries(substitutions)) {
     text = text.split(token).join(value);
   }
-  await writeFile8(filePath, text, "utf8");
+  await writeFile7(filePath, text, "utf8");
 }
 // src/lib/extension-scaffold.ts
-import { access as access2, mkdir as mkdir7, readFile as readFile26, writeFile as writeFile9 } from "node:fs/promises";
+import { access as access2, mkdir as mkdir6, readFile as readFile26, writeFile as writeFile8 } from "node:fs/promises";
 import { constants as FS2 } from "node:fs";
 import path15 from "node:path";
 var EXTENSION_KINDS = ["plugin", "look"];
@@ -7768,14 +7701,14 @@ async function scaffoldExtension(options) {
   const entries = TEMPLATE_FILES[kind];
   const written = [];
   try {
-    await mkdir7(extensionDir, { recursive: true });
+    await mkdir6(extensionDir, { recursive: true });
     for (const [assetName, relDest] of entries) {
       const src = await getAssetPath(`extension-templates/${kind}/${assetName}`);
       const dest = path15.join(extensionDir, relDest);
-      await mkdir7(path15.dirname(dest), { recursive: true });
+      await mkdir6(path15.dirname(dest), { recursive: true });
       const text = await readFile26(src, "utf8");
       const table = relDest.endsWith(".json") ? jsonSafe : plain;
-      await writeFile9(dest, substitute(text, table), "utf8");
+      await writeFile8(dest, substitute(text, table), "utf8");
       written.push(relDest);
     }
   } catch (e) {
@@ -7799,7 +7732,7 @@ function substitute(text, table) {
   return out;
 }
 // src/lib/project-templates.ts
-import { cp as cp2, mkdir as mkdir8, readFile as readFile27, readdir as readdir7, stat as stat5, writeFile as writeFile10 } from "node:fs/promises";
+import { cp as cp2, mkdir as mkdir7, readFile as readFile27, readdir as readdir7, stat as stat5, writeFile as writeFile9 } from "node:fs/promises";
 import { constants as FS3, existsSync as existsSync10 } from "node:fs";
 import { access as access3 } from "node:fs/promises";
 import path16 from "node:path";
@@ -7822,6 +7755,10 @@ async function readTemplateChoices(manifestPath) {
     if (isSeq(targets)) {
       out.targets = targets.items.map((i) => scalarString(i)).filter((s) => s !== null);
     }
+    const width = numberAt(doc, ["page", "width"]);
+    const height = numberAt(doc, ["page", "height"]);
+    if (width !== undefined && height !== undefined)
+      out.page = { width, height };
     return out;
   } catch {
     return {};
@@ -7830,19 +7767,19 @@ async function readTemplateChoices(manifestPath) {
 var BUILT_IN_META = {
   book: {
     label: "Book",
-    description: "A clean starting point for a novel, memoir, or any long-form book."
+    description: "A clean starting point for a novel, memoir, or any long-form book. Uses the Clean book look."
   },
   zine: {
     label: "Zine",
-    description: "A short, personal zine made to be printed, folded, and shared."
+    description: "A short, personal zine made to be printed, folded, and shared. Uses the Zine look."
   },
   technical: {
     label: "Technical document",
-    description: "A manual or guide with steps, reference tables, and code examples."
+    description: "A manual or guide with steps, reference tables, and code examples. Uses the Technical doc look."
   },
   paper: {
     label: "Academic paper",
-    description: "A journal-style article with LaTeX math, numbered equations, figures, tables, notes and references."
+    description: "A journal-style article with LaTeX math, numbered equations, figures, tables, notes and references. Uses the Academic look."
   }
 };
 async function listBuiltInTemplates() {
@@ -7939,7 +7876,7 @@ async function reconcileSharedRefs(templateDir, sourceProjectDir, mode) {
   const vendorDir = pickVendorDir(templateDir, base);
   await Promise.all(externalFiles.filter((abs) => existsSync10(abs)).map(async (abs) => {
     const dest = path16.join(templateDir, vendorDir, path16.relative(base, abs));
-    await mkdir8(path16.dirname(dest), { recursive: true });
+    await mkdir7(path16.dirname(dest), { recursive: true });
     await cp2(abs, dest, { recursive: true });
   }));
   const bookLocal = (value) => toPosixPath(path16.join(vendorDir, path16.relative(base, path16.resolve(sourceProjectDir, value))));
@@ -7972,7 +7909,7 @@ async function saveProjectAsTemplate(options) {
   if (exists) {
     throw new Error(`A template named "${name}" already exists. Choose a different name.`);
   }
-  await mkdir8(dir, { recursive: true });
+  await mkdir7(dir, { recursive: true });
   const entries = await readdir7(projectDir, { withFileTypes: true });
   for (const entry of entries) {
     if (SKIP_ENTRIES.has(entry.name))
@@ -7985,7 +7922,7 @@ async function saveProjectAsTemplate(options) {
   const shared = manifestName ? await reconcileSharedRefs(dir, projectDir, options.sharedRefs ?? "vendor") : { vendoredRefs: [], excludedRefs: [] };
   if (manifestName)
     await retokeniseManifest(path16.join(dir, manifestName));
-  await writeFile10(path16.join(dir, TEMPLATE_META_FILE), JSON.stringify({ label: name }, null, 2), "utf8");
+  await writeFile9(path16.join(dir, TEMPLATE_META_FILE), JSON.stringify({ label: name }, null, 2), "utf8");
   return {
     id,
     label: name,
@@ -8003,7 +7940,7 @@ async function retokeniseManifest(manifestPath) {
     return;
   }
   text = text.replace(/^title:\s*.*$/m, 'title: "{{TITLE}}"').replace(/^(authors:[^\n]*\n[ \t]*-[ \t]*).*$/m, '$1"{{AUTHOR}}"');
-  await writeFile10(manifestPath, text, "utf8");
+  await writeFile9(manifestPath, text, "utf8");
 }
 async function listCustomTemplates(templatesRoot) {
   let entries;
@@ -8045,7 +7982,7 @@ async function importTemplateFromFolder(options) {
   return saveProjectAsTemplate({ projectDir: sourceDir, name, templatesRoot });
 }
 // src/lib/snippets.ts
-import { readdir as readdir8, readFile as readFile28, writeFile as writeFile11, mkdir as mkdir9, rm } from "node:fs/promises";
+import { readdir as readdir8, readFile as readFile28, writeFile as writeFile10, mkdir as mkdir8, rm } from "node:fs/promises";
 import path17 from "node:path";
 var SNIPPETS_DIR = "snippets";
 var LEVEL_RANK = { project: 0, extension: 1, core: 2 };
@@ -8110,8 +8047,8 @@ async function saveSnippet(projectDir, name, body) {
     throw new Error(`Could not derive a filename from "${name}".`);
   const fileName = `${stem}.md`;
   const dir = path17.join(projectDir, SNIPPETS_DIR);
-  await mkdir9(dir, { recursive: true });
-  await writeFile11(resolveSnippetPath(projectDir, fileName), body, "utf8");
+  await mkdir8(dir, { recursive: true });
+  await writeFile10(resolveSnippetPath(projectDir, fileName), body, "utf8");
   return { name, fileName, variables: extractVariables(body), body, source: { kind: "project" } };
 }
 async function deleteSnippet(projectDir, fileName) {
@@ -8244,7 +8181,7 @@ async function listLocationVariants(projectDir) {
 }
 // src/lib/extension-import.ts
 import { existsSync as existsSync11 } from "node:fs";
-import { cp as cp3, mkdir as mkdir10, mkdtemp, readFile as readFile29, rm as rm2, writeFile as writeFile12 } from "node:fs/promises";
+import { cp as cp3, mkdir as mkdir9, mkdtemp, readFile as readFile29, rm as rm2, writeFile as writeFile11 } from "node:fs/promises";
 import { tmpdir as tmpdir2 } from "node:os";
 import path18 from "node:path";
 import { unzipSync } from "fflate";
@@ -8365,7 +8302,7 @@ async function finalizeExtensionImport(projectDir, sourceDir, relPaths, fallback
   }
   const id = await uniqueExtensionId(projectDir, meta.name?.trim() || fallbackName);
   const dest = path18.join(projectDir, EXTENSIONS_DIR, id);
-  await mkdir10(path18.dirname(dest), { recursive: true });
+  await mkdir9(path18.dirname(dest), { recursive: true });
   await cp3(sourceDir, dest, { recursive: true });
   await completeLandedManifest(dest, id, meta, metaExists);
   const entry = await addExtension(projectDir, `./${EXTENSIONS_DIR}/${id}`);
@@ -8385,7 +8322,7 @@ async function completeLandedManifest(dest, id, meta, metaExists) {
     } catch {}
   }
   const gutterpress = pkg.gutterpress && typeof pkg.gutterpress === "object" && !Array.isArray(pkg.gutterpress) ? pkg.gutterpress : {};
-  await writeFile12(file, JSON.stringify({
+  await writeFile11(file, JSON.stringify({
     ...pkg,
     name: typeof pkg.name === "string" && pkg.name.trim() ? pkg.name : id,
     gutterpress: { ...gutterpress, styles: ["theme.css"] }
@@ -8449,8 +8386,8 @@ async function importExtensionFromZip(projectDir, archive) {
         throw new Error(`The package contains an unsafe path and was rejected: ${name}`);
       }
       relPaths.push(rel);
-      await mkdir10(path18.dirname(dest), { recursive: true });
-      await writeFile12(dest, data);
+      await mkdir9(path18.dirname(dest), { recursive: true });
+      await writeFile11(dest, data);
     }
     return await finalizeExtensionImport(projectDir, tmp, relPaths, root || "imported-look");
   } finally {
@@ -8465,8 +8402,8 @@ async function importExtensionFromCssText(projectDir, css, name) {
   const displayName = name.trim() || "Imported theme";
   const tmp = await mkdtemp(path18.join(tmpdir2(), "gutterpress-theme-"));
   try {
-    await writeFile12(path18.join(tmp, "theme.css"), css, "utf8");
-    await writeFile12(path18.join(tmp, EXTENSION_MANIFEST_FILENAME), JSON.stringify({ name: slugify(displayName, "look"), gutterpress: { styles: ["theme.css"] } }, null, 2), "utf8");
+    await writeFile11(path18.join(tmp, "theme.css"), css, "utf8");
+    await writeFile11(path18.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",
@@ -8549,7 +8486,7 @@ async function importExtensionFromUrl(projectDir, url) {
   assertLooksLikeCss(css, trimmed);
   const tmp = await mkdtemp(path18.join(tmpdir2(), "gutterpress-ext-"));
   try {
-    await writeFile12(path18.join(tmp, "theme.css"), css, "utf8");
+    await writeFile11(path18.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 || slugify(baseName, "look"),
@@ -8561,7 +8498,7 @@ async function importExtensionFromUrl(projectDir, url) {
         preview: typeof gp.preview === "string" ? gp.preview : null
       }
     };
-    await writeFile12(path18.join(tmp, EXTENSION_MANIFEST_FILENAME), JSON.stringify(finalMeta, null, 2), "utf8");
+    await writeFile11(path18.join(tmp, EXTENSION_MANIFEST_FILENAME), JSON.stringify(finalMeta, null, 2), "utf8");
     return await finalizeExtensionImport(projectDir, tmp, ["theme.css", EXTENSION_MANIFEST_FILENAME], baseName);
   } finally {
     await rm2(tmp, { recursive: true, force: true });
@@ -8682,7 +8619,7 @@ async function searchNpmExtensions(query, options = {}) {
   return { matches, total: pages.reduce((sum, page) => sum + page.total, 0) };
 }
 // src/lib/manifest-config.ts
-import { isSeq as isSeq2, isMap as isMap3, YAMLSeq, Scalar as Scalar2 } from "yaml";
+import { isSeq as isSeq2, isMap as isMap3, YAMLSeq, Scalar } from "yaml";
 function hasKey(obj, key) {
   return Object.prototype.hasOwnProperty.call(obj, key);
 }
@@ -8765,7 +8702,7 @@ async function setActiveStyles(projectDir, paths) {
   } else {
     const seq = new YAMLSeq(doc.schema);
     for (const p of paths)
-      seq.add(new Scalar2(p));
+      seq.add(new Scalar(p));
     doc.set("styles", seq);
   }
   await writeManifestDoc(file, doc);
@@ -8773,9 +8710,9 @@ async function setActiveStyles(projectDir, paths) {
 }
 // src/lib/version-changes.ts
 import path19 from "node:path";
-import { mkdir as mkdir11, readFile as readFile30, writeFile as writeFile13 } from "node:fs/promises";
+import { mkdir as mkdir10, readFile as readFile30, writeFile as writeFile12 } from "node:fs/promises";
 import git3 from "isomorphic-git";
-import postcss6 from "postcss";
+import postcss5 from "postcss";
 
 // src/lib/remote-auth/transport.ts
 import git2 from "isomorphic-git";
@@ -9228,7 +9165,7 @@ function paragraphs(text) {
 }
 function cssRules(text) {
   try {
-    return postcss6.parse(text).nodes.map((node) => node.toString().trim()).filter((rule) => rule.length > 0);
+    return postcss5.parse(text).nodes.map((node) => node.toString().trim()).filter((rule) => rule.length > 0);
   } catch {
     return textLines(text);
   }
@@ -9467,8 +9404,8 @@ async function exportVersionTree(projectDir, id, destDir) {
       if (!content)
         return null;
       const abs = path19.join(destDir, filepath);
-      await mkdir11(path19.dirname(abs), { recursive: true });
-      await writeFile13(abs, content);
+      await mkdir10(path19.dirname(abs), { recursive: true });
+      await writeFile12(abs, content);
       return null;
     }
   });
@@ -10084,7 +10021,7 @@ import git5 from "isomorphic-git";
 import { randomUUID as randomUUID2 } from "node:crypto";
 
 // src/lib/remote-auth/converge-merge.ts
-import { mkdir as mkdir12, unlink as unlink2, writeFile as writeFile14 } from "node:fs/promises";
+import { mkdir as mkdir11, unlink as unlink2, writeFile as writeFile13 } from "node:fs/promises";
 import path20 from "node:path";
 import git4 from "isomorphic-git";
 import diff3Merge from "diff3";
@@ -10134,8 +10071,8 @@ async function readBlob(dir, cache2, oid, filepath) {
 }
 async function writeTreeFile(dir, filepath, content) {
   const abs = path20.join(dir, filepath);
-  await mkdir12(path20.dirname(abs), { recursive: true });
-  await writeFile14(abs, content);
+  await mkdir11(path20.dirname(abs), { recursive: true });
+  await writeFile13(abs, content);
 }
 async function bothAddedPaths(dir, cache2, ourTip, theirTip, allowUnrelated) {
   const bases = await git4.findMergeBase({ fs: gitFs, dir, cache: cache2, oids: [ourTip, theirTip] });
@@ -10791,7 +10728,7 @@ async function setUpOnlineBackup(options) {
   }
 }
 // src/lib/remote-auth/clone.ts
-import { mkdir as mkdir13, readdir as readdir9, rm as rm3 } from "node:fs/promises";
+import { mkdir as mkdir12, readdir as readdir9, rm as rm3 } from "node:fs/promises";
 import path21 from "node:path";
 import git7 from "isomorphic-git";
 function sanitizeCloneFolderName(name) {
@@ -10850,7 +10787,7 @@ async function cloneRepository(options) {
   return withRepoLock(dir, async () => {
     await assertCloneTarget(dir);
     const dirExistedBefore = gitFs.existsSync(dir);
-    await mkdir13(dir, { recursive: true });
+    await mkdir12(dir, { recursive: true });
     try {
       await git7.clone({
         fs: gitFs,
@@ -11140,11 +11077,11 @@ async function diagnoseProjectRemote(projectDir, options = {}) {
 }
 // src/lib/remote-auth/repair.ts
 import git9 from "isomorphic-git";
-import { cp as cp4, mkdir as mkdir14, rename as rename3, rm as rm4 } from "node:fs/promises";
+import { cp as cp4, mkdir as mkdir13, rename as rename3, rm as rm4 } from "node:fs/promises";
 import path22 from "node:path";
 var REPAIR_SNAPSHOT_MESSAGE = "Repaired online backup";
 async function moveDir(from, to) {
-  await mkdir14(path22.dirname(to), { recursive: true });
+  await mkdir13(path22.dirname(to), { recursive: true });
   try {
     await rename3(from, to);
   } catch (e) {
@@ -11221,7 +11158,7 @@ async function repairOnlineBackup(options) {
 }
 // src/lib/remote-auth/scorched-earth.ts
 import git10 from "isomorphic-git";
-import { cp as cp5, mkdir as mkdir15, readdir as readdir10, rm as rm5 } from "node:fs/promises";
+import { cp as cp5, mkdir as mkdir14, readdir as readdir10, rm as rm5 } from "node:fs/promises";
 import path23 from "node:path";
 async function emptyDir(dir) {
   for (const entry of await readdir10(dir)) {
@@ -11251,7 +11188,7 @@ async function scorchedEarth(options) {
         branch2 = undefined;
       }
       logger.info("backup", "copying folder", { to: backupDir });
-      await mkdir15(backupDir, { recursive: true });
+      await mkdir14(backupDir, { recursive: true });
       await cp5(dir, backupDir, { recursive: true });
       logger.info("delete", "emptying folder", { dir });
       await emptyDir(dir);
@@ -11437,11 +11374,11 @@ ${tail}` : ""}`);
 };
 
 // src/lib/publish/providers/guided.ts
-import { copyFile as copyFile2, mkdir as mkdir16, writeFile as writeFile15 } from "node:fs/promises";
+import { copyFile as copyFile2, mkdir as mkdir15, writeFile as writeFile14 } from "node:fs/promises";
 import path24 from "node:path";
 async function stageGuidedPackage(req, providerId, listingLines) {
   const packageDir = path24.join(path24.dirname(req.artifact.path), "publish", providerId);
-  await mkdir16(packageDir, { recursive: true });
+  await mkdir15(packageDir, { recursive: true });
   await copyFile2(req.artifact.path, path24.join(packageDir, path24.basename(req.artifact.path)));
   const { title, authors } = req.project;
   const sheet = [
@@ -11455,7 +11392,7 @@ async function stageGuidedPackage(req, providerId, listingLines) {
     ""
   ].join(`
 `);
-  await writeFile15(path24.join(packageDir, "LISTING.md"), sheet, "utf8");
+  await writeFile14(path24.join(packageDir, "LISTING.md"), sheet, "utf8");
   return packageDir;
 }
 
@@ -11518,7 +11455,7 @@ var drivethrurpgProvider = {
 };
 
 // src/lib/publish/providers/gdrive.ts
-import { mkdtemp as mkdtemp2, readFile as readFile31, readdir as readdir11, rm as rm6, stat as stat7, writeFile as writeFile16 } from "node:fs/promises";
+import { mkdtemp as mkdtemp2, readFile as readFile31, readdir as readdir11, rm as rm6, stat as stat7, writeFile as writeFile15 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
 import path25 from "node:path";
 import { Zip, ZipDeflate } from "fflate";
@@ -11926,7 +11863,7 @@ async function collectZipEntries(root, dir, out, onWarn) {
     }
   }
 }
-async function zipHtmlExport(exportDir, title, onWarn, writeArchiveImpl = writeFile16) {
+async function zipHtmlExport(exportDir, title, onWarn, writeArchiveImpl = writeFile15) {
   const entries = {};
   await collectZipEntries(exportDir, exportDir, entries, onWarn);
   const fileName = `${bookSlug(title)}-website.zip`;
@@ -12030,7 +11967,7 @@ var gdriveProvider = {
 };
 
 // src/lib/publish/butler.ts
-import { chmod as chmod2, mkdir as mkdir17, stat as stat8, writeFile as writeFile17 } from "node:fs/promises";
+import { chmod as chmod2, mkdir as mkdir16, stat as stat8, writeFile as writeFile16 } from "node:fs/promises";
 import path26 from "node:path";
 import { unzipSync as unzipSync2 } from "fflate";
 var BUTLER_DOWNLOAD_TIMEOUT_MS = 300000;
@@ -12091,13 +12028,13 @@ async function ensureButler(deps) {
     return new Uint8Array(await response.arrayBuffer());
   });
   const files = unzipSync2(archive);
-  await mkdir17(cacheDir, { recursive: true });
+  await mkdir16(cacheDir, { recursive: true });
   let foundBinary = false;
   for (const [name, data] of Object.entries(files)) {
     if (name.endsWith("/"))
       continue;
     const target = path26.join(cacheDir, path26.basename(name));
-    await writeFile17(target, data);
+    await writeFile16(target, data);
     if (path26.basename(name) === butlerBinaryName()) {
       await chmod2(target, 493).catch(() => {});
       foundBinary = true;
@@ -12294,7 +12231,7 @@ var kdpProvider = {
 };
 
 // src/lib/publish/providers/local-folder.ts
-import { cp as cp6, mkdir as mkdir18, stat as stat9 } from "node:fs/promises";
+import { cp as cp6, mkdir as mkdir17, stat as stat9 } from "node:fs/promises";
 import path27 from "node:path";
 var LOCAL_PUBLISH_DEFAULT_DIR = "dist";
 var info8 = {
@@ -12332,7 +12269,7 @@ var localFolderProvider = {
   },
   async upload(req) {
     const dir = localPublishDir(req);
-    await mkdir18(dir, { recursive: true });
+    await mkdir17(dir, { recursive: true });
     const dest = req.artifact.format === "html" ? dir : path27.join(dir, path27.basename(req.artifact.path));
     if (path27.resolve(dest) !== path27.resolve(req.artifact.path)) {
       await cp6(req.artifact.path, dest, { recursive: true });
@@ -12632,7 +12569,7 @@ async function resolvePublishProvider(id, book) {
   const ext = await bookExtensions(book);
   const npmEntry = ext.extensions.some((c) => !c.path && c.name === id);
   if (npmEntry) {
-    const { restoreForCommand: restoreForCommand2 } = await import("./extension-restore-s3x1618g.js");
+    const { restoreForCommand: restoreForCommand2 } = await import("./extension-restore-9dh7c4tp.js");
     await restoreForCommand2(book.projectDir, { manifestPath: book.manifestPath, failFast: true });
   }
   const publishers = await discover(ext);
@@ -12670,7 +12607,7 @@ function infoFor(p) {
 }
 function pluginProvider(p) {
   let loading;
-  const load = () => loading ??= import("./plugins-2cek4mz1.js").then((m) => m.loadPublishFunction(p));
+  const load = () => loading ??= import("./plugins-80emnf31.js").then((m) => m.loadPublishFunction(p));
   return {
     info: infoFor(p),
     async authenticate() {
@@ -12941,7 +12878,7 @@ async function disconnectPublishCredential(key, deps, options = {}) {
   }
 }
 // src/lib/publish/selections.ts
-import { chmod as chmod3, mkdir as mkdir19, readFile as readFile32, writeFile as writeFile18 } from "node:fs/promises";
+import { chmod as chmod3, mkdir as mkdir18, readFile as readFile32, writeFile as writeFile17 } from "node:fs/promises";
 import path30 from "node:path";
 class PublishSelectionsStore {
   filePath;
@@ -12964,8 +12901,8 @@ class PublishSelectionsStore {
     return { version: 1, global: {}, projects: {} };
   }
   async write(data) {
-    await mkdir19(path30.dirname(this.filePath), { recursive: true });
-    await writeFile18(this.filePath, JSON.stringify(data, null, 2), {
+    await mkdir18(path30.dirname(this.filePath), { recursive: true });
+    await writeFile17(this.filePath, JSON.stringify(data, null, 2), {
       encoding: "utf8",
       mode: 384
     });