gutterpress 0.11.23-alpha.1 → 0.11.23-alpha.2

package/dist/lib/project-scaffold.d.ts

@@ -43,12 +43,10 @@ export interface CreateProjectOptions {
      */
     templateDir?: string;
     /**
-     * Which vendor preset the new book is designed for (ADR 0008). REQUIRED
-     * when scaffolding a built-in template — creation flows make the author
-     * choose; the resolveConfig dtrpg fallback exists for hand-written
-     * manifests, not for tooling. Written into the generated manifest as an
-     * explicit `preset:` line. Ignored with `templateDir`: a saved template's
-     * manifest carries its preset as part of the captured design.
+     * Which preset the new book is designed for (ADR 0008), written into the
+     * generated manifest as an explicit `preset:` line. Optional: left out, the
+     * template's own `preset:` stands (every starter carries one, and a saved
+     * template's manifest carries its preset as part of the captured design).
      */
     preset?: PresetId;
     /**
@@ -137,7 +135,7 @@ export interface AdoptFolderOptions {
  * Adopt an EXISTING folder as a gutterpress project, in place (no new subfolder).
  * Writes a `manifest.yaml` (using the folder's existing top-level `.md` files as
  * `source.files`, or scaffolding a `chapter-01.md` when there are none), copies
- * a starter `styles/book.css`, ensures `dist/` and `plugins/npm/` are gitignored
+ * a starter `styles/book.css`, ensures `dist/` and `extensions/npm/` are gitignored
  * (see `ensureProjectGitignore`), and optionally initialises local version history.
  *
  * NON-DESTRUCTIVE (global never-overwrite rule): refuses if the folder is

package/dist/lib/project-templates.d.ts

@@ -1,5 +1,4 @@
 import type { ProjectTemplateId } from "./project-scaffold.ts";
-import type { BuiltInStyleSetId } from "./extension-manager.ts";
 /** The built-in templates shipped as embedded assets. */
 export declare const BUILT_IN_TEMPLATE_IDS: readonly ["book", "zine", "technical", "paper"];
 /** Author-friendly metadata for one template (built-in or custom). */
@@ -24,11 +23,9 @@ export interface TemplateInfo {
     /** The `targets:` this template's manifest declares, when it has one. */
     targets?: string[];
 }
-/** `look`: the built-in look a new book from the template starts with. */
 export declare const BUILT_IN_META: Record<ProjectTemplateId, {
     label: string;
     description: string;
-    look?: BuiltInStyleSetId;
 }>;
 /**
  * List the built-in templates. The `preset`/`targets` each one starts a book

package/dist/lib/snippets.d.ts

@@ -74,7 +74,8 @@ export declare function deleteSnippet(projectDir: string, fileName: string): Pro
 /**
  * One plugin-declared marker (a "component", `export const markers`) the
  * project can use, with the example snippet the editor inserts for it.
- * Unrelated to the `gutterpress.components` catalog file, which nothing reads.
+ * Unrelated to the `gutterpress.components` catalog file, which the desktop's
+ * class catalog reads for class completions.
  */
 export interface MarkerComponent {
     /** The marker name, without `@` — e.g. `term-box`. */

package/dist/lib/style-resolver.d.ts

@@ -14,8 +14,7 @@ export declare function relDisplay(projectDir: string, absPath: string): string;
  * BOTH the renderer (to `<link>` them) and the editor (to edit them), so they
  * can never disagree. Returns project-relative paths:
  *   1. the manifest `styles:` list, if it has any entries; else
- *   2. the first conventional stylesheet the project actually has
- *      (`FALLBACK_PRIORITY`); else
+ *   2. `styles/book.css`, when the project has it; else
  *   3. the first discovered `.css` anywhere we scan (deterministic); else
  *   4. `[]` — the project has no stylesheet (an honest empty, never a phantom
  *      link to a missing file).

package/dist/{manifest-8f10dr4f.yaml → manifest-eagfhba6.yaml}

@@ -14,4 +14,6 @@ page:
 extensions:
   - markdown-it-sup
   - gutterpress-math
+  # The built-in academic look. Style over it from styles/book.css.
+  - academic
 preset: book

package/dist/{manifest.schema-9aeaered.json → manifest.schema-t7nx2stg.json}

@@ -44,7 +44,7 @@
     },
     "styles": {
       "type": "array",
-      "description": "Project-relative CSS files to <link> into the rendered book, applied in order. If omitted, Gutterpress discovers one: styles/book.css (what `gutterpress new` scaffolds), else four legacy names kept only for pre-existing projects — css/print.css, css/index.css, css/style.css, css/main.css — else the first discovered .css, else none. New projects should set this explicitly or use styles/book.css.",
+      "description": "Project-relative CSS files to <link> into the rendered book, applied in order. If omitted, Gutterpress discovers one: styles/book.css (what `gutterpress new` scaffolds), else the first .css file found in the project root, styles/ or css/, else none. New projects should set this explicitly or use styles/book.css.",
       "items": {
         "type": "string",
         "minLength": 1,
@@ -58,7 +58,7 @@
     },
     "extensions": {
       "type": "array",
-      "description": "Extensions, in load order: markdown-it plugins, looks (stylesheets), component libraries — anything from npm or a folder. Each entry is a specifier: a bundled feature name (markdown-it-mark, markdown-it-sub, markdown-it-sup, markdown-it-abbr, gutterpress-gfm-alerts, gutterpress-math), a path starting with ./ or ../ (relative to this file), or an npm package name, optionally pinned as name@version. A later entry loads later: its markdown runs after earlier entries' and its CSS wins ties. The project's own `styles` always load after every extension.",
+      "description": "Extensions, in load order: markdown-it plugins, looks (stylesheets), component libraries — anything from npm or a folder. Each entry is a specifier: a bundled name (a markdown feature: markdown-it-mark, markdown-it-sub, markdown-it-sup, markdown-it-abbr, gutterpress-gfm-alerts, gutterpress-math; or a built-in look: clean-book, zine, technical-doc, academic), a path starting with ./ or ../ (relative to this file), or an npm package name, optionally pinned as name@version. A later entry loads later: its markdown runs after earlier entries' and its CSS wins ties. The project's own `styles` always load after every extension.",
       "items": {
         "oneOf": [
           {
@@ -207,17 +207,17 @@
     },
     "page": {
       "type": "object",
-      "description": "Expected page geometry, in POINTS. VALIDATION BOUNDS ONLY — these values do NOT set the trim size. The real PDF page size comes from the CSS `@page` rule in your stylesheet; these numbers are only what the `pdf.print.page-size` check compares the produced PDF against. Set them to the trim size you expect so a CSS mistake gets caught — and note that a bleed-inclusive @page size will legitimately differ from the trim size recorded here.",
+      "description": "Page geometry, in POINTS (1in = 72pt): the trim size the book prints at. The build writes it as the default `@page { size }` unless a stylesheet's own plain `@page` rule sets a size, in which case that rule wins, and the `pdf.print.page-size` check compares the produced PDF against these numbers either way. A bleed-inclusive @page size legitimately differs from the trim recorded here.",
       "properties": {
         "width": {
           "type": "number",
-          "description": "Expected page width in points (1in = 72pt). Validation bound only — the CSS @page rule sets the real width. Preset defaults: dtrpg 621, book 432 (6in).",
+          "description": "Page width in points (1in = 72pt): the trim the book prints at unless a stylesheet's plain @page rule sets its own, and what validation compares against. Preset defaults: dtrpg 621, book 432 (6in).",
           "exclusiveMinimum": 0,
           "examples": [612, 621, 432]
         },
         "height": {
           "type": "number",
-          "description": "Expected page height in points (1in = 72pt). Validation bound only — the CSS @page rule sets the real height. Preset defaults: dtrpg 810, book 648 (9in).",
+          "description": "Page height in points (1in = 72pt): the trim the book prints at unless a stylesheet's plain @page rule sets its own, and what validation compares against. Preset defaults: dtrpg 810, book 648 (9in).",
           "exclusiveMinimum": 0,
           "examples": [792, 810, 648]
         },

package/dist/{new-xhq8wczn.js → new-mhs46pw3.js}

@@ -3,38 +3,38 @@ import {
   EXTENSION_KINDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-5hkmp2wy.js";
+} from "./cli-xq6djqbj.js";
 import {
   resolveGhostscript
-} from "./cli-ccp7sxz3.js";
+} from "./cli-evg8sbht.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-dtckwda1.js";
+import"./cli-pz4bn98t.js";
 import"./cli-2ppw6q9v.js";
 import"./cli-eyyggect.js";
 import {
   isToolAvailable
 } from "./cli-asap4t1z.js";
-import"./cli-habkc5ng.js";
+import"./cli-a35w7wzg.js";
 import"./cli-v5mp7a6q.js";
 import {
-  PRESETS,
   PRESET_IDS,
   TARGETS,
-  TARGET_IDS
-} from "./cli-dd115fa8.js";
-import"./cli-h17e3mtz.js";
-import"./cli-b0vyjvmt.js";
+  TARGET_IDS,
+  loadManifest,
+  resolveConfig
+} from "./cli-sdmv4bba.js";
+import"./cli-pwwfxdgb.js";
+import"./cli-aqh6brew.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-nr6j6300.js";
-import"./cli-fe43evmf.js";
+import"./cli-kh8v4vvw.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-h3phdstf.js";
+import"./cli-y28j019d.js";
 import"./cli-37x76zdn.js";
 
 // src/commands/new.ts
@@ -52,15 +52,15 @@ var newArgs = {
   },
   prefix: {
     type: "string",
-    description: 'Class/custom-property prefix an extension claims (default: its slug, e.g. "field-notes-"); --kind plugin|theme only'
+    description: 'Class/custom-property prefix an extension claims (default: its slug, e.g. "field-notes-"); --kind plugin|look only'
   },
   description: {
     type: "string",
-    description: "One-line description recorded in the extension's metadata; --kind plugin|theme only"
+    description: "One-line description recorded in the extension's metadata; --kind plugin|look only"
   },
   preset: {
     type: "string",
-    description: `Vendor preset the book is designed for: ${PRESET_IDS.join(", ")} (required; custom also needs --page-width/--page-height)`
+    description: `Preset the book is designed for: ${PRESET_IDS.join(", ")} (default: the template's; custom also needs --page-width/--page-height)`
   },
   author: {
     type: "string",
@@ -192,7 +192,7 @@ async function runExtensionScaffold(kind, name, parentDir, args) {
 var new_default = defineCommand({
   meta: {
     name: "new",
-    description: "Create a new Gutterpress book, plugin or theme from a starter template"
+    description: "Create a new Gutterpress book, plugin or look from a starter template"
   },
   args: newArgs,
   async run({ args, rawArgs }) {
@@ -228,8 +228,8 @@ var new_default = defineCommand({
       template = args.template;
     }
     const preset = typeof args.preset === "string" && args.preset ? args.preset : undefined;
-    if (!preset || !PRESET_IDS.includes(preset)) {
-      console.error(preset ? `Unknown preset "${preset}". Choose one of: ${PRESET_IDS.join(", ")}.` : `A preset is required: --preset <${PRESET_IDS.join("|")}>. ` + `Use "dtrpg" for DriveThruRPG print-on-demand, "book" for a neutral 6x9in trade book, ` + `or "custom" with --page-width/--page-height (points; 72pt = 1in).`);
+    if (preset && !PRESET_IDS.includes(preset)) {
+      console.error(`Unknown preset "${preset}". Choose one of: ${PRESET_IDS.join(", ")}. ` + `"dtrpg" is DriveThruRPG print-on-demand, "book" a neutral 6x9in trade book, ` + `"custom" takes --page-width/--page-height (points; 72pt = 1in).`);
       process.exit(EXIT_CODES.USAGE);
     }
     let targets;
@@ -261,10 +261,11 @@ var new_default = defineCommand({
         customPage,
         versionHistory: args.git === false ? "none" : "local-git"
       });
-      const effectiveTargets = targets ?? [...PRESETS[preset].defaultTargets];
+      const written = resolveConfig({}, await loadManifest(result.projectDir));
       console.log(`Created book: ${result.projectDir}`);
       console.log(`  manifest: ${result.manifestPath}`);
-      console.log(`  publish targets: ${effectiveTargets.length > 0 ? effectiveTargets.join(", ") : "none"}`);
+      console.log(`  preset: ${written.preset}`);
+      console.log(`  publish targets: ${written.targets.length > 0 ? written.targets.join(", ") : "none"}`);
       console.log(`  start writing in: ${result.openFile}`);
       if (result.versionHistory === "local-git") {
         console.log("  version history: enabled (local snapshots)");
@@ -272,7 +273,7 @@ var new_default = defineCommand({
         console.log(`  version history: not enabled (${result.versionHistoryError})`);
       }
       const neededTools = [
-        ...new Set(effectiveTargets.flatMap((id) => TARGETS[id]?.requiredTools ?? []))
+        ...new Set(written.targets.flatMap((id) => TARGETS[id]?.requiredTools ?? []))
       ];
       const missingTools = [];
       for (const tool of neededTools) {

package/dist/{plugins-9en8m9y0.js → plugins-1sxe0dkz.js}

@@ -8,10 +8,10 @@ import {
   loadPlugins,
   loadPluginsWithCss,
   loadPublishFunction
-} from "./cli-h17e3mtz.js";
-import"./cli-b0vyjvmt.js";
-import"./cli-nr6j6300.js";
-import"./cli-h3phdstf.js";
+} from "./cli-pwwfxdgb.js";
+import"./cli-aqh6brew.js";
+import"./cli-kh8v4vvw.js";
+import"./cli-y28j019d.js";
 import"./cli-37x76zdn.js";
 export {
   loadPublishFunction,

package/dist/{plugins-gf0gkjmv.js → plugins-2cek4mz1.js}

@@ -8,8 +8,8 @@ import {
   loadPlugins,
   loadPluginsWithCss,
   loadPublishFunction
-} from "./index-2jpk25en.js";
-import"./index-r7jcsk6h.js";
+} from "./index-2bjcghze.js";
+import"./index-5x42amh8.js";
 import"./index-37x76zdn.js";
 export {
   loadPublishFunction,

package/dist/{preflight-negnxg7b.js → preflight-3k2b1x8e.js}

@@ -1,34 +1,33 @@
 import {
   executeValidation,
   reportMissingTools
-} from "./cli-5hkmp2wy.js";
-import"./cli-ccp7sxz3.js";
+} from "./cli-xq6djqbj.js";
+import"./cli-evg8sbht.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-dtckwda1.js";
+import"./cli-pz4bn98t.js";
 import"./cli-2ppw6q9v.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
-import"./cli-habkc5ng.js";
+import"./cli-a35w7wzg.js";
 import"./cli-v5mp7a6q.js";
 import {
   publishTargetFor
-} from "./cli-dd115fa8.js";
-import"./cli-h17e3mtz.js";
+} from "./cli-sdmv4bba.js";
+import"./cli-pwwfxdgb.js";
 import {
   log
-} from "./cli-b0vyjvmt.js";
+} from "./cli-aqh6brew.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-nr6j6300.js";
-import"./cli-fe43evmf.js";
+import"./cli-kh8v4vvw.js";
 import {
   BuildError,
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-h3phdstf.js";
+import"./cli-y28j019d.js";
 import"./cli-37x76zdn.js";
 
 // src/commands/preflight.ts

package/dist/{preview-cep2s9cg.js → preview-6p9v6rht.js}

@@ -3,23 +3,23 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-5hkmp2wy.js";
-import"./cli-ccp7sxz3.js";
+} from "./cli-xq6djqbj.js";
+import"./cli-evg8sbht.js";
 import {
   previewArgs
 } from "./cli-75qkn0k5.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-dtckwda1.js";
+import"./cli-pz4bn98t.js";
 import"./cli-2ppw6q9v.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
-import"./cli-habkc5ng.js";
+import"./cli-a35w7wzg.js";
 import"./cli-v5mp7a6q.js";
-import"./cli-dd115fa8.js";
-import"./cli-h17e3mtz.js";
+import"./cli-sdmv4bba.js";
+import"./cli-pwwfxdgb.js";
 import {
   log
-} from "./cli-b0vyjvmt.js";
+} from "./cli-aqh6brew.js";
 import {
   UsageError,
   parseFormat,
@@ -28,12 +28,11 @@ import {
   rejectUnknownFlags,
   resolvePort
 } from "./cli-d8xjns66.js";
-import"./cli-nr6j6300.js";
-import"./cli-fe43evmf.js";
+import"./cli-kh8v4vvw.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
-import"./cli-h3phdstf.js";
+import"./cli-y28j019d.js";
 import"./cli-37x76zdn.js";
 
 // src/commands/preview.ts

package/dist/{publish-xery6qc6.js → publish-qgsngy8s.js}

@@ -10,36 +10,35 @@ import {
   resolvePublishFormat,
   resolvePublishProvider,
   runPublish
-} from "./cli-5hkmp2wy.js";
+} from "./cli-xq6djqbj.js";
 import {
   FileTokenStore
-} from "./cli-ccp7sxz3.js";
+} from "./cli-evg8sbht.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-dtckwda1.js";
+import"./cli-pz4bn98t.js";
 import"./cli-2ppw6q9v.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
-import"./cli-habkc5ng.js";
+import"./cli-a35w7wzg.js";
 import"./cli-v5mp7a6q.js";
 import {
   loadManifestWithPath
-} from "./cli-dd115fa8.js";
-import"./cli-h17e3mtz.js";
+} from "./cli-sdmv4bba.js";
+import"./cli-pwwfxdgb.js";
 import {
   log
-} from "./cli-b0vyjvmt.js";
+} from "./cli-aqh6brew.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-nr6j6300.js";
-import"./cli-fe43evmf.js";
+import"./cli-kh8v4vvw.js";
 import {
   BuildError,
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-h3phdstf.js";
+import"./cli-y28j019d.js";
 import"./cli-37x76zdn.js";
 
 // src/commands/publish.ts

package/dist/{source-provider-qbfknhyy.js → source-provider-98k5deda.js}

@@ -21,8 +21,8 @@ import {
   switchBranch,
   whenGitIdle,
   withRepoLock
-} from "./index-93pqkvty.js";
-import"./index-r7jcsk6h.js";
+} from "./index-h6yk5tjx.js";
+import"./index-5x42amh8.js";
 import"./index-v5mp7a6q.js";
 import"./index-37x76zdn.js";
 export {

package/dist/{source-provider-2r74a7wp.js → source-provider-knmcam50.js}

@@ -21,9 +21,9 @@ import {
   switchBranch,
   whenGitIdle,
   withRepoLock
-} from "./cli-habkc5ng.js";
+} from "./cli-a35w7wzg.js";
 import"./cli-v5mp7a6q.js";
-import"./cli-h3phdstf.js";
+import"./cli-y28j019d.js";
 import"./cli-37x76zdn.js";
 export {
   withRepoLock,

package/dist/{validate-3d0sgf4g.js → validate-0v7xw6wa.js}

@@ -1,31 +1,30 @@
 import {
   executeAndReport
-} from "./cli-5hkmp2wy.js";
-import"./cli-ccp7sxz3.js";
+} from "./cli-xq6djqbj.js";
+import"./cli-evg8sbht.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-dtckwda1.js";
+import"./cli-pz4bn98t.js";
 import"./cli-2ppw6q9v.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
-import"./cli-habkc5ng.js";
+import"./cli-a35w7wzg.js";
 import"./cli-v5mp7a6q.js";
-import"./cli-dd115fa8.js";
-import"./cli-h17e3mtz.js";
+import"./cli-sdmv4bba.js";
+import"./cli-pwwfxdgb.js";
 import {
   log
-} from "./cli-b0vyjvmt.js";
+} from "./cli-aqh6brew.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-nr6j6300.js";
-import"./cli-fe43evmf.js";
+import"./cli-kh8v4vvw.js";
 import {
   BuildError,
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-h3phdstf.js";
+import"./cli-y28j019d.js";
 import"./cli-37x76zdn.js";
 
 // src/commands/validate.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.11.23-alpha.1",
+  "version": "0.11.23-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",