gutterpress 0.11.23-alpha.1 → 0.11.23-alpha.3

package/dist/{cli-h17e3mtz.js → cli-t8be9yeb.js}

@@ -1,16 +1,17 @@
 import {
   PACKAGE_VERSION,
   debug
-} from "./cli-b0vyjvmt.js";
+} from "./cli-s6djx4ma.js";
 import {
   isExactNpmVersion,
   isValidNpmPackageName,
   packageResolutionTargets,
+  parseNpmPluginSpec,
   resolvePackageEntry,
   resolveVendoredPluginInstallRoot,
   safePackageTarget,
   vendoredNpmPluginPackageDir
-} from "./cli-h3phdstf.js";
+} from "./cli-y28j019d.js";
 
 // src/lib/markdown/plugins.ts
 import { existsSync as existsSync2, readFileSync, statSync, unlinkSync } from "node:fs";
@@ -19,6 +20,366 @@ import { isBuiltin } from "node:module";
 import { resolve as resolve2, join, dirname, basename, extname, isAbsolute, relative, sep } from "node:path";
 import { pathToFileURL } from "node:url";
 
+// src/assets/themes/clean-book/theme.css
+var theme_default = `/* =============================================================================
+   Clean Book — gutterpress built-in theme (theme.css)
+   A calm, classic long-form book look. Change the :root tokens from the book's own stylesheet.
+   The page SIZE comes from the manifest (Setup > Details), so it is deliberately not set here.
+   ============================================================================= */
+
+:root {
+  --color-ink:        #1a1a1a;   /* body text                 */
+  --color-ink-muted:  #555555;   /* captions, secondary text  */
+  --color-accent:     #2b4c7e;   /* headings, links           */
+  --color-paper:      #ffffff;   /* page background           */
+  --color-rule:       #d9d9d9;   /* borders, rules            */
+
+  --font-body:    "Georgia", "Times New Roman", serif;
+  --font-display: "Georgia", "Times New Roman", serif;
+  --font-mono:    "Menlo", "Consolas", monospace;
+
+  --fs-body: 11pt;
+  --fs-h1: 2.1rem;
+  --fs-h2: 1.5rem;
+  --fs-h3: 1.2rem;
+  --leading:  1.55;
+
+}
+
+body {
+  color: var(--color-ink);
+  background: var(--color-paper);
+  font-family: var(--font-body);
+  line-height: var(--leading);
+  font-size: var(--fs-body);
+}
+
+h1, h2, h3 {
+  font-family: var(--font-display);
+  color: var(--color-accent);
+  line-height: 1.2;
+  font-weight: 600;
+}
+h1 { font-size: var(--fs-h1); margin: 0 0 0.6em; }
+h2 { font-size: var(--fs-h2); margin: 1.4em 0 0.4em; }
+h3 { font-size: var(--fs-h3); margin: 1.2em 0 0.3em; }
+
+p { margin: 0 0 0.8em; text-align: justify; hyphens: auto; }
+
+a { color: var(--color-accent); text-decoration: none; }
+
+blockquote {
+  margin: 1em 0; padding: 0.2em 0 0.2em 1em;
+  border-left: 3px solid var(--color-rule);
+  color: var(--color-ink-muted); font-style: italic;
+}
+
+code, pre { font-family: var(--font-mono); font-size: 0.9em; }
+
+hr { border: 0; border-top: 1px solid var(--color-rule); margin: 1.5em 0; }
+`;
+
+// src/assets/themes/zine/theme.css
+var theme_default2 = `/* =============================================================================
+   Zine — gutterpress built-in theme (theme.css)
+   High-contrast, punchy, photocopier-friendly. Change the :root tokens from the book's own stylesheet.
+   The page SIZE comes from the manifest (Setup > Details), so it is deliberately not set here.
+   ============================================================================= */
+
+:root {
+  --color-ink:        #000000;   /* body text                 */
+  --color-ink-muted:  #333333;   /* secondary text            */
+  --color-accent:     #000000;   /* headings (mono, high ink) */
+  --color-paper:      #ffffff;   /* page background           */
+  --color-rule:       #000000;   /* heavy borders, rules      */
+
+  --font-body:    "Helvetica Neue", "Arial", sans-serif;
+  --font-display: "Impact", "Haettenschweiler", "Arial Black", sans-serif;
+  --font-mono:    "Courier New", monospace;
+
+  --fs-body: 10pt;
+  --fs-h1: 2.8rem;
+  --fs-h2: 1.8rem;
+  --fs-h3: 1.3rem;
+  --leading:  1.4;
+
+}
+
+body {
+  color: var(--color-ink);
+  background: var(--color-paper);
+  font-family: var(--font-body);
+  line-height: var(--leading);
+  font-size: var(--fs-body);
+}
+
+h1, h2, h3 {
+  font-family: var(--font-display);
+  color: var(--color-accent);
+  text-transform: uppercase;
+  letter-spacing: -0.01em;
+  line-height: 0.95;
+  font-weight: 900;
+}
+h1 { font-size: var(--fs-h1); margin: 0 0 0.4em; }
+h2 { font-size: var(--fs-h2); margin: 1.1em 0 0.3em; }
+h3 { font-size: var(--fs-h3); margin: 1em 0 0.25em; }
+
+p { margin: 0 0 0.6em; }
+
+a { color: var(--color-accent); text-decoration: underline; font-weight: 700; }
+
+blockquote {
+  margin: 1em 0; padding: 0.5em 0.8em;
+  border: 2px solid var(--color-rule);
+  font-weight: 700;
+}
+
+hr { border: 0; border-top: 3px solid var(--color-rule); margin: 1em 0; }
+
+code, pre { font-family: var(--font-mono); font-size: 0.95em; }
+`;
+
+// src/assets/themes/technical-doc/theme.css
+var theme_default3 = `/* =============================================================================
+   Technical Document — gutterpress built-in theme (theme.css)
+   Clean sans-serif manual look with clear hierarchy. Change the :root tokens from the book's own stylesheet.
+   The page SIZE comes from the manifest (Setup > Details), so it is deliberately not set here.
+   ============================================================================= */
+
+:root {
+  --color-ink:        #1c1e21;   /* body text                 */
+  --color-ink-muted:  #5a5f66;   /* captions, secondary text  */
+  --color-accent:     #0b5fff;   /* headings, links           */
+  --color-paper:      #ffffff;   /* page background           */
+  /* @label Note and code background */
+  --color-tint:       #f3f5f9;   /* code / note fill          */
+  --color-rule:       #d6dae0;   /* borders, rules            */
+
+  --font-body:    "Helvetica Neue", "Segoe UI", Arial, sans-serif;
+  --font-display: "Helvetica Neue", "Segoe UI", Arial, sans-serif;
+  --font-mono:    "SFMono-Regular", "Consolas", "Menlo", monospace;
+
+  --fs-body: 10.5pt;
+  --fs-h1: 2.0rem;
+  --fs-h2: 1.45rem;
+  --fs-h3: 1.15rem;
+  --leading:  1.5;
+
+}
+
+body {
+  color: var(--color-ink);
+  background: var(--color-paper);
+  font-family: var(--font-body);
+  line-height: var(--leading);
+  font-size: var(--fs-body);
+}
+
+h1, h2, h3 {
+  font-family: var(--font-display);
+  color: var(--color-ink);
+  font-weight: 600;
+  line-height: 1.25;
+}
+h1 { font-size: var(--fs-h1); margin: 0 0 0.5em; color: var(--color-accent); }
+h2 { font-size: var(--fs-h2); margin: 1.4em 0 0.4em; border-bottom: 1px solid var(--color-rule); padding-bottom: 0.15em; }
+h3 { font-size: var(--fs-h3); margin: 1.2em 0 0.3em; }
+
+p { margin: 0 0 0.7em; }
+
+a { color: var(--color-accent); text-decoration: none; }
+
+code {
+  font-family: var(--font-mono); font-size: 0.88em;
+  background: var(--color-tint); padding: 0.1em 0.35em; border-radius: 3px;
+}
+pre {
+  font-family: var(--font-mono); font-size: 0.85em;
+  background: var(--color-tint); border: 1px solid var(--color-rule);
+  border-radius: 4px; padding: 0.7em 0.9em; overflow: auto;
+}
+pre code { background: none; padding: 0; }
+
+table { width: 100%; border-collapse: collapse; margin: 1em 0; font-size: 0.95em; }
+th, td { border: 1px solid var(--color-rule); padding: 0.4em 0.6em; text-align: left; }
+th { background: var(--color-tint); font-weight: 600; }
+
+blockquote {
+  margin: 1em 0; padding: 0.5em 0.9em;
+  background: var(--color-tint); border-left: 3px solid var(--color-accent);
+  color: var(--color-ink-muted);
+}
+`;
+
+// src/assets/themes/academic/theme.css
+var theme_default4 = `/* =============================================================================
+   Academic — gutterpress built-in theme (theme.css)
+   A journal-article look in the spirit of LaTeX's \`article\` class: a serif
+   text face, justified and hyphenated text, 1in margins, a centred page
+   number, and the parts of a paper styled by the @section they sit in.
+   Change the :root tokens from the book's own stylesheet. The page SIZE comes from the manifest
+   (\`page:\` — US Letter or A4), so it is deliberately not set here.
+   ============================================================================= */
+
+:root {
+  --color-ink:        #111111;   /* body text                 */
+  --color-ink-muted:  #555555;   /* captions, secondary text  */
+  --color-accent:     #111111;   /* headings, links           */
+  --color-paper:      #ffffff;   /* page background           */
+  --color-rule:       #111111;   /* table rules               */
+
+  --font-body:    "Latin Modern Roman", "CMU Serif", "STIX Two Text", "Times New Roman", "Liberation Serif", serif;
+  --font-display: "Latin Modern Roman", "CMU Serif", "STIX Two Text", "Times New Roman", "Liberation Serif", serif;
+  --font-mono:    "Latin Modern Mono", "Menlo", "Consolas", monospace;
+
+  --fs-body: 10.5pt;
+  --fs-h1: 1.65em;
+  --fs-h2: 1.2em;
+  --fs-h3: 1em;
+  --leading:  1.38;
+
+}
+
+@page {
+  @bottom-center { content: counter(page); font-family: var(--font-body); font-size: 9pt; }
+}
+
+body {
+  color: var(--color-ink);
+  background: var(--color-paper);
+  font-family: var(--font-body);
+  line-height: var(--leading);
+  font-size: var(--fs-body);
+  text-align: justify;
+  hyphens: auto;
+}
+
+h1, h2, h3 {
+  font-family: var(--font-display);
+  color: var(--color-accent);
+  line-height: 1.2;
+  font-weight: bold;
+}
+h1 { font-size: var(--fs-h1); margin: 0 0 0.7em; }
+h2 { font-size: var(--fs-h2); margin: 1.4em 0 0.5em; }
+h3 { font-size: var(--fs-h3); margin: 1.2em 0 0.4em; }
+
+a { color: var(--color-accent); text-decoration: none; }
+
+code, pre { font-family: var(--font-mono); }
+pre { font-size: 0.8em; line-height: 1.3; }
+
+/* @section .title — the title, authors, affiliations and date */
+.title { text-align: center; hyphens: manual; margin-bottom: 2em; }
+
+/* @section .abstract — the abstract, keywords and subject classes */
+.abstract { font-size: 0.9em; margin: 0 2.5em 2em; }
+
+/* @section .figure — a figure, table or listing kept on one page with its caption */
+.figure { break-inside: avoid; margin: 1.4em 0; }
+.caption { font-size: 0.9em; color: var(--color-ink-muted); }
+
+/* Tables ruled above, below and under the header row, as journals set them */
+table { border-collapse: collapse; margin: 0.6em auto; border-top: 1pt solid var(--color-rule); border-bottom: 1pt solid var(--color-rule); }
+thead th { border-bottom: 0.5pt solid var(--color-rule); }
+th, td { padding: 0.2em 0.8em; }
+
+/* Notes (from [^1] footnotes) and @section .references, a size smaller than the text */
+.footnotes, .references { font-size: 0.85em; }
+.footnotes-sep { border: 0; border-top: 0.5pt solid var(--color-rule); width: 30%; margin: 1.5em 0 0.5em; }
+.footnote-backref { display: none; }
+`;
+
+// src/lib/extension-specifier.ts
+var BUNDLED_EXTENSIONS = [
+  {
+    name: "markdown-it-mark",
+    label: "Highlight",
+    description: "Highlight text by wrapping it in `==double equals==`."
+  },
+  {
+    name: "markdown-it-sub",
+    label: "Subscript",
+    description: "Lower text below the line, like the 2 in `H~2~O`."
+  },
+  {
+    name: "markdown-it-sup",
+    label: "Superscript",
+    description: "Raise text above the line, like the th in `29^th^`."
+  },
+  {
+    name: "markdown-it-abbr",
+    label: "Abbreviations",
+    description: "Explain an abbreviation when readers hover over it. Define it once, like `*[GPS]: Global Positioning System`."
+  },
+  {
+    name: "gutterpress-gfm-alerts",
+    label: "Callouts",
+    description: "Turn a quote into a boxed note: start it with `> [!NOTE]` (or `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`)."
+  },
+  {
+    name: "gutterpress-math",
+    label: "Math",
+    description: "Write LaTeX math between dollar signs: `$E = mc^2$` in a line, or `$$` … `$$` on lines of their own."
+  },
+  {
+    name: "clean-book",
+    label: "Clean book",
+    description: "A calm, classic book look: serif body, generous margins, restrained accents.",
+    css: theme_default
+  },
+  {
+    name: "zine",
+    label: "Zine",
+    description: "High-contrast, punchy sans-serif look for short photocopier-friendly zines.",
+    css: theme_default2
+  },
+  {
+    name: "technical-doc",
+    label: "Technical doc",
+    description: "Clean sans-serif manual look with clear hierarchy, code styling, and tidy tables.",
+    css: theme_default3
+  },
+  {
+    name: "academic",
+    label: "Academic",
+    description: "A journal-article look: serif text, justified and hyphenated, ruled tables, notes and references set smaller.",
+    css: theme_default4
+  }
+];
+function bundledExtension(name) {
+  return BUNDLED_EXTENSIONS.find((e) => e.name === name);
+}
+function isBundledExtension(name) {
+  return bundledExtension(name) !== undefined;
+}
+function isPathSpecifier(use) {
+  return use.startsWith("./") || use.startsWith("../") || use.startsWith("/") || /^[a-zA-Z]:[\\/]/.test(use);
+}
+function parseExtensionSpecifier(use) {
+  const spec = use.trim();
+  if (!spec) {
+    throw new Error("An extension specifier is required — an npm package name, or a ./ path.");
+  }
+  if (isPathSpecifier(spec))
+    return { kind: "path", path: spec };
+  if (/\.(m?js|cjs)$/i.test(spec) || !spec.startsWith("@") && spec.includes("/")) {
+    throw new Error(`"${spec}" looks like a path; write it as "./${spec}". A specifier that does not ` + "start with ./, ../ or / is an npm package name.");
+  }
+  const parsed = parseNpmPluginSpec(spec);
+  if (isBundledExtension(parsed.name)) {
+    if (parsed.selector !== undefined) {
+      throw new Error(`"${parsed.name}" is bundled with Gutterpress and always resolves to the bundled copy — ` + `drop "@${parsed.selector}".`);
+    }
+    return { kind: "bundled", name: parsed.name };
+  }
+  return parsed.selector === undefined ? { kind: "npm", name: parsed.name } : { kind: "npm", name: parsed.name, version: parsed.selector };
+}
+function pinnedNpmSpecifier(name, version) {
+  return `${name}@${version}`;
+}
+
 // src/lib/style-declarations.ts
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
@@ -64,7 +425,6 @@ function metaFromPackageJson(raw) {
     ...str(object(pkg.engines)?.gutterpress) ? { gutterpressRange: str(object(pkg.engines)?.gutterpress) } : {},
     ..."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) } : {},
@@ -130,8 +490,7 @@ function assertExtensionContained(meta) {
     ...entry ? [entry] : [],
     ...meta.publish && meta.main?.trim() ? [meta.main.trim()] : [],
     ...meta.components ? [meta.components] : [],
-    ...meta.snippets ? [meta.snippets] : [],
-    ...meta.tokensFile ? [meta.tokensFile] : []
+    ...meta.snippets ? [meta.snippets] : []
   ];
   for (const rel of declared) {
     if (pathEscapesFolder(rel)) {
@@ -148,7 +507,6 @@ function resolveExtension(dir, meta, subject) {
   return {
     ...markdown ? { markdown } : {},
     ...styles ? { styles } : {},
-    ...meta.tokensFile?.trim() ? { tokensFile: meta.tokensFile.trim() } : {},
     ...components ? { components } : {},
     ...snippets ? { snippets } : {}
   };
@@ -3182,7 +3540,7 @@ async function importVendoredEntry(installRoot, packageDir, spec) {
   try {
     entry = await resolvePackageEntry(packageDir);
   } catch (cause) {
-    throw new Error(`the downloaded copy of ${spec} under plugins/npm/ is incomplete ` + `(${cause instanceof Error ? cause.message : String(cause)}). ` + `Reinstall it with \`gutterpress ext add ${spec}\`.`, { cause });
+    throw new Error(`the downloaded copy of ${spec} under extensions/npm/ is incomplete ` + `(${cause instanceof Error ? cause.message : String(cause)}). ` + `Reinstall it with \`gutterpress ext add ${spec}\`.`, { cause });
   }
   const entryPath = join(packageDir, ...entry.split("/"));
   vendoredRootsOpened.add(installRoot);
@@ -3212,9 +3570,9 @@ async function loadNpmPackage(packageName, baseDir, version) {
   const looksLikeJsFilename = /\.(m?js|cjs)$/i.test(packageName);
   const suggestedPath = looksLikeJsFilename ? `./${packageName}` : `./plugins/${packageName}.js`;
   if (!looksLikeJsFilename && (!version || !isExactNpmVersion(version))) {
-    throw new Error(`Extension "${packageName}${version ? `@${version}` : ""}" is not pinned to an exact version, so it can't be downloaded automatically. Run \`gutterpress ext add ${packageName}\` (or use Book settings > Features in the desktop app) to download it and pin its version in your manifest.`);
+    throw new Error(`Extension "${packageName}${version ? `@${version}` : ""}" is not pinned to an exact version, so it can't be downloaded automatically. Run \`gutterpress ext add ${packageName}\` (or use Book setup > Looks & features > Advanced in the desktop app) to download it and pin its version in your manifest.`);
   }
-  throw new Error(`Extension "${packageName}" not found. Install it with \`gutterpress ext add ${version ? `${packageName}@${version}` : packageName}\` (or Book settings > Features > Advanced in the desktop app),
+  throw new Error(`Extension "${packageName}" not found. Install it with \`gutterpress ext add ${version ? `${packageName}@${version}` : packageName}\` (or Book setup > Looks & features > Advanced in the desktop app),
 or reference a local file under \`extensions:\`:
   extensions:
     - ${suggestedPath}`);
@@ -3402,12 +3760,18 @@ async function loadPlugin(config, baseDir) {
   if (!config.path && !config.name) {
     throw new Error("Plugin manifest entry must specify either `path` or `name`. Got an empty plugin config.");
   }
-  if (!config.path && !config.version && config.name && BUILTIN_OPTIONAL_PLUGINS[config.name]) {
-    return {
-      name: config.name,
-      plugin: BUILTIN_OPTIONAL_PLUGINS[config.name],
-      options: config.options
-    };
+  if (!config.path && !config.version && config.name) {
+    const bundled = bundledExtension(config.name);
+    if (bundled?.css !== undefined) {
+      return { name: config.name, plugin: noopPlugin, css: bundled.css, options: config.options };
+    }
+    if (BUILTIN_OPTIONAL_PLUGINS[config.name]) {
+      return {
+        name: config.name,
+        plugin: BUILTIN_OPTIONAL_PLUGINS[config.name],
+        options: config.options
+      };
+    }
   }
   if (config.path) {
     const candidatePath = resolve2(baseDir, config.path);
@@ -3528,4 +3892,4 @@ async function loadPluginsWithCss(configs, baseDir, onError) {
   };
 }
 
-export { TWO_VERSIONS_OPEN, TWO_VERSIONS_CLOSE, MARKER_CSS, GUTTERPRESS_CSS, TWO_VERSIONS_CSS, TABLE_ALIGN_CSS, slugify, prettify, parseSrcsetUrlCandidates, collectHtmlImageRefs, createMarkdownRenderer, applyPlugins, collectPluginCss, collectPluginStylePaths, collectPluginStyleGroups, resolveDeclaredStyles, EXTENSION_MANIFEST_FILENAME, readExtensionMeta, extensionStyleList, extensionEntry, extensionCarries, assertExtensionContained, __resetPathPluginCacheForTests, loadPlugin, loadPublishFunction, loadPlugins, loadPluginsWithCss };
+export { bundledExtension, isPathSpecifier, parseExtensionSpecifier, pinnedNpmSpecifier, TWO_VERSIONS_OPEN, TWO_VERSIONS_CLOSE, MARKER_CSS, GUTTERPRESS_CSS, TWO_VERSIONS_CSS, TABLE_ALIGN_CSS, slugify, prettify, parseSrcsetUrlCandidates, collectHtmlImageRefs, createMarkdownRenderer, applyPlugins, collectPluginCss, collectPluginStylePaths, collectPluginStyleGroups, resolveDeclaredStyles, EXTENSION_MANIFEST_FILENAME, readExtensionMeta, extensionStyleList, extensionEntry, extensionCarries, assertExtensionContained, __resetPathPluginCacheForTests, loadPlugin, loadPublishFunction, loadPlugins, loadPluginsWithCss };