gutterpress 0.11.23-alpha.7 → 0.11.23-beta.2

package/dist/index-tayzfr9c.js

@@ -0,0 +1,99 @@
+// src/lib/build-error.ts
+var EXIT_CODES = {
+  OK: 0,
+  FINDINGS: 1,
+  USAGE: 2,
+  PIPELINE: 3
+};
+
+class BuildError extends Error {
+  exitCode;
+  constructor(message, exitCode = EXIT_CODES.PIPELINE, options) {
+    super(message, options);
+    this.name = "BuildError";
+    this.exitCode = exitCode;
+  }
+}
+
+// src/engine/shared/print-area.ts
+function isPositivePoints(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0;
+}
+function isNonNegativePoints(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;
+}
+
+export { isPositivePoints, isNonNegativePoints, round3, cssLength, formatPageSize, printAreaMeta, pageBoxes, judgeRect, EXIT_CODES, BuildError };

package/dist/{index-hphcn7th.js → index-ytjkvwy5.js}

@@ -14,11 +14,12 @@ import {
   readExtensionMeta,
   resolveExtension,
   slugify
-} from "./index-fp7xwvpr.js";
+} from "./index-80vg3ed6.js";
 import {
   BuildError,
-  EXIT_CODES
-} from "./index-46ycxe6r.js";
+  EXIT_CODES,
+  isNonNegativePoints
+} from "./index-tayzfr9c.js";
 import {
   EXTENSIONS_DIR,
   VENDORED_NPM_DIR,
@@ -91,87 +92,6 @@ import { existsSync, statSync } from "node:fs";
 import { resolve, dirname } from "node:path";
 import { parse as parseYaml, YAMLParseError } from "yaml";
 
-// src/engine/shared/print-area.ts
-function isPositivePoints(value) {
-  return typeof value === "number" && Number.isFinite(value) && value > 0;
-}
-function isNonNegativePoints(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/constants.ts
 var NETWORK = {
   DEFAULT_PORT: 3579
@@ -2318,4 +2238,4 @@ async function restoreForCommand(dir, options) {
     log.warn(problem);
 }
 
-export { isPositivePoints, isNonNegativePoints, round3, cssLength, formatPageSize, printAreaMeta, pageBoxes, judgeRect, DEBOUNCE, UsageError, resolvePort, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, resolveTargets, applyDefaultPdfStrictChecks, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, resolveConfigForTarget, MARGIN_EDGES, validatePageMargin, FriendlyHttpError, withFetchTimeout, loadManifestDoc, writeManifestDoc, scalarString, DEFAULT_NPM_REGISTRY, npmRegistryUrl, ensureProjectGitignore, sameExtension, listProjectExtensions, describeExtension, extensionConfigFor, setExtensionEnabled, reorderExtensions, removeExtension, addExtension, listNpmVersions, checkExtensionUpdates, updateExtensions, listBundledExtensions, uniqueExtensionId, validateProjectExtensions, readExtensionCss, readEntryCss, restorePinnedExtensions, restoreFailureMessage, restoreOfflineMessage, restoreForCommand };
+export { DEBOUNCE, UsageError, resolvePort, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, resolveTargets, applyDefaultPdfStrictChecks, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, resolveConfigForTarget, MARGIN_EDGES, validatePageMargin, FriendlyHttpError, withFetchTimeout, loadManifestDoc, writeManifestDoc, scalarString, DEFAULT_NPM_REGISTRY, npmRegistryUrl, ensureProjectGitignore, sameExtension, listProjectExtensions, describeExtension, extensionConfigFor, setExtensionEnabled, reorderExtensions, removeExtension, addExtension, listNpmVersions, checkExtensionUpdates, updateExtensions, listBundledExtensions, uniqueExtensionId, validateProjectExtensions, readExtensionCss, readEntryCss, restorePinnedExtensions, restoreFailureMessage, restoreOfflineMessage, restoreForCommand };

package/dist/index.d.ts

@@ -26,6 +26,8 @@ export type { PlatformAdapter, FileStat, FileWriteResult } from "./platform.ts";
 export { inspectImage } from "./lib/image-inspect.ts";
 export type { ImageInfo, ColorSpace } from "./lib/image-inspect.ts";
 export { checkCss } from "./lib/printsafe.ts";
+export { readBookCss, bookTokenEdits } from "./lib/book-css.ts";
+export type { BookCss, BookCssChunk, CssChunk, CssChunkOrigin, RootToken, StylesheetEdit, TokenUpdate, } from "./lib/book-css.ts";
 export { BUILD_DIAGNOSTIC_CODES } from "./engine/compiler/build.ts";
 export type { BuildDiagnostic, BuildDiagnosticCode } from "./engine/compiler/build.ts";
 export type { PrintSafeWarning } from "./lib/printsafe.ts";

package/dist/index.js

@@ -21,6 +21,7 @@ import {
   SYNC_SNAPSHOT_MESSAGE,
   VERSION_CHANGES_SHOWN,
   adoptFolder,
+  assembleCssChunks,
   autoSnapshotDelayMs,
   autoSyncDelayMs,
   checkCss,
@@ -70,6 +71,7 @@ import {
   listPublishProviders,
   listRepoBooks,
   listSnippets,
+  listVersionChanges,
   openPath,
   parseRemoteOrigin,
   pkceChallengeFromVerifier,
@@ -80,6 +82,7 @@ import {
   readPageSetup,
   readPublishSettings,
   refreshRemoteCopies,
+  relDisplay,
   renameRevision,
   repairOnlineBackup,
   reportMissingTools,
@@ -119,7 +122,7 @@ import {
   substituteVariables,
   syncProject,
   testRemoteAccess
-} from "./index-nfysshcc.js";
+} from "./index-0k43evt0.js";
 import {
   DEFAULT_NPM_REGISTRY,
   MANIFEST_FILENAMES,
@@ -149,7 +152,7 @@ import {
   setExtensionEnabled,
   updateExtensions,
   validateProjectExtensions
-} from "./index-hphcn7th.js";
+} from "./index-ytjkvwy5.js";
 import {
   BUNDLED_EXTENSIONS,
   EXTENSION_MANIFEST_FILENAME,
@@ -160,20 +163,21 @@ import {
   extensionStyleList,
   isBundledExtension,
   isPathSpecifier,
+  loadPluginsWithCss,
   log,
   parseExtensionSpecifier,
   pathEscapesFolder,
   readExtensionMeta,
   resolveExtension
-} from "./index-fp7xwvpr.js";
+} from "./index-80vg3ed6.js";
 import"./index-ht1bcqdd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-wm4x7xbf.js";
-import"./index-2vxzxyyj.js";
+} from "./index-2t1gdma7.js";
+import"./index-swfdgn2n.js";
 import {
   BuildError
-} from "./index-46ycxe6r.js";
+} from "./index-tayzfr9c.js";
 import"./index-5crpmz42.js";
 import {
   DEFAULT_PRINT_OPTS,
@@ -195,7 +199,7 @@ import {
   revisionNameFrom,
   switchBranch,
   whenGitIdle
-} from "./index-cw03e9p4.js";
+} from "./index-7j3hkwya.js";
 import {
   EXTENSIONS_DIR
 } from "./index-5x42amh8.js";
@@ -207,6 +211,226 @@ import {
   repoSubPath
 } from "./index-v5mp7a6q.js";
 import"./index-37x76zdn.js";
+// src/lib/book-css.ts
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+
+// src/lib/root-tokens.ts
+import postcss from "postcss";
+var DIRECTIVE_RE = /@(group|label|internal)\b[ \t]*([^\n\r@]*)/gi;
+function fold(into, comment) {
+  for (const d of comment.matchAll(DIRECTIVE_RE)) {
+    const key = d[1].toLowerCase();
+    if (key === "internal") {
+      into.internal = true;
+      continue;
+    }
+    const value = d[2].trim();
+    if (value)
+      into[key] = value;
+  }
+}
+function rootRules(root) {
+  const out = [];
+  const visit = (container, layer) => {
+    container.each((node) => {
+      if (node.type === "rule") {
+        if (node.selectors.some((s) => s.trim().toLowerCase() === ":root")) {
+          out.push(layer === undefined ? { rule: node } : { rule: node, layer });
+        }
+      } else if (node.type === "atrule" && node.name.toLowerCase() === "layer" && node.nodes) {
+        const name = node.params.trim();
+        visit(node, layer === undefined ? name : name ? `${layer}.${name}` : layer);
+      }
+    });
+  };
+  visit(root, undefined);
+  return out;
+}
+function leadingComments(rule) {
+  const out = [];
+  for (let prev = rule.prev();prev?.type === "comment"; prev = prev.prev())
+    out.unshift(prev.text);
+  return out;
+}
+function writtenValue(decl) {
+  return decl.raws.value?.raw ?? decl.value;
+}
+function rootTokens(css) {
+  const out = [];
+  for (const { rule, layer } of rootRules(postcss.parse(css))) {
+    const defaults = {};
+    for (const comment of leadingComments(rule))
+      fold(defaults, comment);
+    let pending = {};
+    rule.each((node) => {
+      if (node.type === "comment") {
+        fold(pending, node.text);
+        return;
+      }
+      if (node.type !== "decl" || !node.prop.startsWith("--"))
+        return;
+      const own = pending;
+      pending = {};
+      const annotated = own.group !== undefined || own.label !== undefined;
+      if (own.internal || defaults.internal && !annotated)
+        return;
+      const group = own.group ?? defaults.group;
+      out.push({
+        name: node.prop,
+        value: writtenValue(node),
+        ...own.label !== undefined ? { label: own.label } : {},
+        ...group !== undefined ? { group } : {},
+        ...layer !== undefined ? { layer } : {}
+      });
+    });
+  }
+  return out;
+}
+function declarationsOf(root, name) {
+  return rootRules(root).flatMap(({ rule }) => (rule.nodes ?? []).filter((n) => n.type === "decl" && n.prop === name));
+}
+function removeDeclaration(decl) {
+  const rule = decl.parent;
+  decl.remove();
+  if ((rule.nodes ?? []).length > 0)
+    return;
+  const parent = rule.parent;
+  const next = rule.next();
+  const before = rule.raws.before ?? "";
+  rule.remove();
+  const keep = (after) => before + (after ?? "").replace(/^\n/, "");
+  if (next)
+    next.raws.before = keep(next.raws.before);
+  else
+    parent.raws.after = keep(parent.raws.after);
+}
+function insertDeclaration(root, name, value) {
+  const rule = rootRules(root)[0]?.rule;
+  if (rule) {
+    const hadDeclaration = (rule.nodes ?? []).some((n) => n.type === "decl");
+    rule.prepend(postcss.decl({ prop: name, value, raws: { before: rule.first?.raws.before ?? `
+  `, between: ": " } }));
+    if (!hadDeclaration)
+      rule.raws.semicolon = true;
+    return;
+  }
+  const tail = root.raws.after ?? "";
+  const added = postcss.rule({ selector: ":root", raws: { between: " ", after: `
+`, semicolon: true } });
+  added.append(postcss.decl({ prop: name, value, raws: { before: `
+  `, between: ": " } }));
+  root.append(added);
+  added.raws.before = tail + ((root.nodes.length > 1 || tail) && !tail.endsWith(`
+`) ? `
+` : "");
+  root.raws.after = `
+`;
+}
+function applyTokenUpdates(sheets, target, updates) {
+  const roots = sheets.map((css) => postcss.parse(css));
+  const changed = new Set;
+  for (const { name, value } of updates) {
+    const declared = roots.map((root) => declarationsOf(root, name));
+    if (value === null) {
+      declared.forEach((decls, i) => {
+        for (const decl of decls)
+          removeDeclaration(decl);
+        if (decls.length > 0)
+          changed.add(i);
+      });
+      continue;
+    }
+    let at = declared.length - 1;
+    while (at >= 0 && declared[at].length === 0)
+      at--;
+    if (at >= 0) {
+      for (const decl of declared[at])
+        decl.value = value;
+      changed.add(at);
+    } else {
+      insertDeclaration(roots[target], name, value);
+      changed.add(target);
+    }
+  }
+  return sheets.map((css, i) => changed.has(i) ? roots[i].toString() : css);
+}
+
+// src/lib/book-css.ts
+async function readText(file) {
+  try {
+    return await readFile(file, "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT")
+      return "";
+    throw error;
+  }
+}
+async function bookSheets(projectDir, styles) {
+  return (await resolveActiveStyles(projectDir, styles)).map((rel) => path.resolve(projectDir, rel));
+}
+async function readBookCss(projectDir) {
+  const { manifest } = await loadManifestWithPath(projectDir);
+  const config = resolveConfig({}, manifest);
+  const { pluginStyles } = await loadPluginsWithCss(config.extensions, projectDir, () => {});
+  const extensions = [];
+  for (const group of pluginStyles) {
+    const layered = (css, file) => {
+      if (!css.trim())
+        return;
+      extensions.push({
+        origin: { kind: "extension", name: group.name, layer: group.layer, ...file ? { file } : {} },
+        css: `@layer ${group.layer} {
+${css.trim()}
+}`
+      });
+    };
+    for (const file of group.paths)
+      layered(await readText(file), relDisplay(projectDir, file));
+    if (group.css)
+      layered(group.css);
+  }
+  const book = [];
+  for (const file of await bookSheets(projectDir, config.styles)) {
+    const css = await readText(file);
+    if (css.trim())
+      book.push({ origin: { kind: "book", file: relDisplay(projectDir, file) }, css });
+  }
+  const chunks = assembleCssChunks({
+    printArea: { ...config.page, preset: config.preset, spec: config.spec },
+    extensions,
+    book
+  });
+  return {
+    chunks: chunks.map((chunk) => {
+      let tokens = [];
+      try {
+        tokens = rootTokens(chunk.css);
+      } catch {}
+      return { ...chunk, tokens };
+    })
+  };
+}
+async function bookTokenEdits(projectDir, target, updates) {
+  const { manifest } = await loadManifestWithPath(projectDir);
+  const sheets = await bookSheets(projectDir, Array.isArray(manifest.styles) ? manifest.styles : undefined);
+  const at = sheets.indexOf(path.resolve(projectDir, target));
+  if (at < 0) {
+    throw new Error(`${relDisplay(projectDir, path.resolve(projectDir, target))} is not one of the book's stylesheets.`);
+  }
+  const before = await Promise.all(sheets.map(readText));
+  let after;
+  try {
+    after = applyTokenUpdates(before, at, updates);
+  } catch (error) {
+    const e = error;
+    const i = e.source === undefined ? -1 : before.indexOf(e.source);
+    if (i < 0 || !e.reason)
+      throw error;
+    throw new Error(`Couldn't read ${relDisplay(projectDir, sheets[i])}${e.line ? ` (line ${e.line})` : ""}: ${e.reason}.`);
+  }
+  return sheets.flatMap((file, i) => after[i] === before[i] ? [] : [{ path: file, content: after[i] }]);
+}
 export {
   whenGitIdle,
   validateProjectExtensions,
@@ -271,6 +495,7 @@ export {
   readManifestFields,
   readExtensionMeta,
   readExtensionCss,
+  readBookCss,
   publishTargetFor,
   publishProviderFor,
   publishCredentialKey,
@@ -285,6 +510,7 @@ export {
   log,
   loadManifestWithPath,
   loadManifest,
+  listVersionChanges,
   listSnippets,
   listRevisions,
   listRepoBooks,
@@ -352,6 +578,7 @@ export {
   checkCss,
   capabilitiesFor,
   bundledExtension,
+  bookTokenEdits,
   autoSyncDelayMs,
   autoSnapshotDelayMs,
   assertMilestone,

package/dist/lib/book-css.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The book's stylesheet as Book setup's design settings see it, and their one
+ * writer (#454).
+ *
+ * What the settings show is what the build assembles: core's CSS, every
+ * enabled extension's CSS — its stylesheet files and its `css` export,
+ * through the same loader the build uses, each in its cascade layer — then
+ * every one of the book's own `styles:` sheets, in the order
+ * `assembleCssChunks` gives them. A file's chunk is the file as written, so a
+ * value reads back as the author typed it: the build's inlining (fonts and
+ * images embedded, local `@import`s followed) is left out here.
+ *
+ * Writes go to the book's own `styles:` sheets only, never to an extension's
+ * files or a sheet the build does not use, with a postcss edit
+ * (`root-tokens.ts`).
+ */
+import { type CssChunk } from "./markdown/assemble.ts";
+import { type RootToken, type TokenUpdate } from "./root-tokens.ts";
+export type { RootToken, TokenUpdate } from "./root-tokens.ts";
+export type { CssChunk, CssChunkOrigin } from "./markdown/assemble.ts";
+/** One chunk of the book's stylesheet and the root-level custom properties it declares. */
+export interface BookCssChunk extends CssChunk {
+    /**
+     * Its root-level `:root` custom properties, in source order (`@internal`
+     * ones left out). Empty for a chunk postcss cannot parse: the print-safety
+     * check reports that one.
+     */
+    tokens: RootToken[];
+}
+/** The book's stylesheet, in cascade order. */
+export interface BookCss {
+    /** Joined with blank lines, the chunks cascade as the built book's stylesheet does. */
+    chunks: BookCssChunk[];
+}
+/** One stylesheet the token writer changed: its absolute path and new text. */
+export interface StylesheetEdit {
+    path: string;
+    content: string;
+}
+/**
+ * The book's stylesheet as ordered chunks tagged with their origin, each with
+ * its root-level custom properties. An extension that cannot load (not
+ * downloaded yet, a broken folder) is left out, as the live preview leaves it
+ * out; Book setup's Extensions tab reports it. Throws for a manifest the
+ * build would refuse.
+ */
+export declare function readBookCss(projectDir: string): Promise<BookCss>;
+/**
+ * Apply token edits to the book's own stylesheets with postcss
+ * (`applyTokenUpdates`): a token is changed in place in the last of them that
+ * declares it at root level, and a new one is added to the `:root` of
+ * `target`, which must be one of them. A removal takes the token out of all
+ * of them. Returns the sheets that change, with their new text, for the
+ * caller to write; nothing is written here.
+ */
+export declare function bookTokenEdits(projectDir: string, target: string, updates: TokenUpdate[]): Promise<StylesheetEdit[]>;

package/dist/lib/markdown/assemble.d.ts

@@ -167,6 +167,64 @@ export interface AssembleBookHtmlOptions {
      */
     onImageRefs?: (refs: string[]) => void;
 }
+/**
+ * Split a stylesheet into everything but its `@page` rules, and its `@page`
+ * rules, which the caller writes after it, unlayered, in source order. A
+ * rule inside an `@layer` loses that layer; one inside `@media` or
+ * `@supports` keeps the condition. CSS postcss cannot read is left as it was.
+ *
+ * Chromium ranks `@page` declarations by cascade layer before page name, so a
+ * layered `@page full { margin: 0 }` lost to the manifest's unlayered
+ * `@page { margin }` on its own pages, while the engine's reader, which
+ * ignores layers, kept it (#454). So no `@page` rule is written inside a
+ * layer — core's, an extension's or one in a layer the book declares —
+ * except core's 1in default (`defaultPageMarginCss`), which must lose to all
+ * of them.
+ * Unlayered, page rules cascade by page selector, then order: a named page
+ * keeps its margins, and the book's own sheet and the manifest, written
+ * later, still win on the pages they share with it.
+ */
+export declare function liftPageRules(css: string): {
+    layered: string;
+    pages: string;
+};
+/** Where one chunk of a book's stylesheet comes from. */
+export type CssChunkOrigin = {
+    kind: "core";
+}
+/** One extension's CSS: `file` (project-relative) for one of its stylesheets, none for its `css` export. */
+ | {
+    kind: "extension";
+    name?: string;
+    layer?: string;
+    file?: string;
+}
+/** One of the book's own `styles:` sheets (project-relative). */
+ | {
+    kind: "book";
+    file?: string;
+};
+/** One piece of a book's stylesheet, tagged with where it comes from. */
+export interface CssChunk {
+    origin: CssChunkOrigin;
+    css: string;
+}
+/**
+ * A book's stylesheet as ordered chunks, each tagged with its origin, in
+ * cascade order (see the note where {@link assembleBookHtml} calls this).
+ * Joined with blank lines, the chunks are the `<style data-project-css>`
+ * block that function writes; it passes the extensions' CSS and the book's
+ * whole, one chunk each. Book setup's design settings pass them one extension
+ * file and one book sheet at a time, so each setting can say where it comes
+ * from (`book-css.ts`).
+ */
+export declare function assembleCssChunks(opts: {
+    printArea?: PrintAreaSource;
+    /** The extensions' CSS, already in their cascade layers, in `extensions:` order. */
+    extensions?: CssChunk[];
+    /** The book's own stylesheets, in `styles:` order. */
+    book?: CssChunk[];
+}): CssChunk[];
 /**
  * Assemble a single `book.html` string from the given markdown files.
  *