gutterpress 0.10.8 → 0.10.9-beta.1

package/dist/cli.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   previewArgs
-} from "./cli-pfpb1t3h.js";
+} from "./cli-bzxqtvrk.js";
 import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-vcv5ewqj.js";
+} from "./cli-0tgbgwnj.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
@@ -18,17 +18,16 @@ import {
 import { defineCommand, parseArgs, runMain } from "citty";
 import { statSync } from "node:fs";
 var SUBCOMMANDS = {
-  new: () => import("./new-xffarp40.js").then((m) => m.default),
-  preview: () => import("./preview-xa1n7why.js").then((m) => m.default),
-  build: () => import("./build-qnecb3a1.js").then((m) => m.default),
-  publish: () => import("./publish-zgmr99kd.js").then((m) => m.default),
-  lint: () => import("./lint-3p1s8agk.js").then((m) => m.default),
-  validate: () => import("./validate-43hqgzz5.js").then((m) => m.default),
-  audit: () => import("./audit-m3ce9pvq.js").then((m) => m.default),
-  preflight: () => import("./preflight-z6xpty9w.js").then((m) => m.default),
-  doctor: () => import("./doctor-qvqye1wd.js").then((m) => m.default),
-  plugin: () => import("./plugin-b05ck7zd.js").then((m) => m.default),
-  theme: () => import("./theme-m9dtxkhj.js").then((m) => m.default)
+  new: () => import("./new-pw3eez61.js").then((m) => m.default),
+  preview: () => import("./preview-x7qqhmxf.js").then((m) => m.default),
+  build: () => import("./build-dqv3505a.js").then((m) => m.default),
+  publish: () => import("./publish-ms6abf6g.js").then((m) => m.default),
+  lint: () => import("./lint-c7a4j3ww.js").then((m) => m.default),
+  validate: () => import("./validate-vw59jcq7.js").then((m) => m.default),
+  audit: () => import("./audit-2x958vnj.js").then((m) => m.default),
+  preflight: () => import("./preflight-77zyws1q.js").then((m) => m.default),
+  doctor: () => import("./doctor-55r0ghtc.js").then((m) => m.default),
+  ext: () => import("./ext-04n7hydk.js").then((m) => m.default)
 };
 var VERSION = package_default.version;
 var main = defineCommand({
@@ -53,7 +52,7 @@ async function preflightRequiredInvocations(rawArgs) {
   const [command, ...commandArgs] = rawArgs;
   try {
     if (command === "new") {
-      const { newArgs } = await import("./new-xffarp40.js");
+      const { newArgs } = await import("./new-pw3eez61.js");
       rejectUnknownFlags(commandArgs, newArgs, "new");
       const parsed = parseArgs(commandArgs, {
         ...newArgs,
@@ -65,7 +64,7 @@ async function preflightRequiredInvocations(rawArgs) {
       return;
     }
     if (command === "preflight") {
-      const { preflightArgs } = await import("./preflight-z6xpty9w.js");
+      const { preflightArgs } = await import("./preflight-77zyws1q.js");
       rejectUnknownFlags(commandArgs, preflightArgs, "preflight");
       const parsed = parseArgs(commandArgs, {
         ...preflightArgs,
@@ -76,57 +75,29 @@ async function preflightRequiredInvocations(rawArgs) {
       }
       return;
     }
-    if (command === "plugin") {
+    if (command === "ext") {
       const [subcommand, ...subcommandArgs] = commandArgs;
       if (subcommand === undefined)
         return;
       if (subcommand === "--" || subcommand === "-") {
-        throw new UsageError(`gutterpress plugin: expected a subcommand before ${subcommand}`);
+        throw new UsageError(`gutterpress ext: expected a subcommand before ${subcommand}`);
       }
       if (subcommand.startsWith("-"))
         return;
-      if (subcommand !== "add") {
-        throw new UsageError(`gutterpress plugin: unknown command "${subcommand}"`);
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-04n7hydk.js");
+      if (!EXT_SUBCOMMANDS.includes(subcommand)) {
+        throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }
-      const { pluginAddArgs } = await import("./plugin-b05ck7zd.js");
-      rejectUnknownFlags(subcommandArgs, pluginAddArgs, "plugin add");
-      const parsed = parseArgs(subcommandArgs, {
-        ...pluginAddArgs,
-        package: { ...pluginAddArgs.package, required: false }
-      });
-      if (parsed.package === undefined) {
-        throw new UsageError("gutterpress plugin add: missing required positional argument PACKAGE");
-      }
-      return;
-    }
-    if (command === "theme") {
-      const [subcommand, ...subcommandArgs] = commandArgs;
-      if (subcommand === undefined)
-        return;
-      if (subcommand === "--" || subcommand === "-") {
-        throw new UsageError(`gutterpress theme: expected a subcommand before ${subcommand}`);
-      }
-      if (subcommand.startsWith("-"))
-        return;
-      const THEME_SUBCOMMANDS = ["list", "apply", "import", "revert", "remove"];
-      if (!THEME_SUBCOMMANDS.includes(subcommand)) {
-        throw new UsageError(`gutterpress theme: unknown command "${subcommand}"`);
-      }
-      if (subcommand === "list" || subcommand === "revert")
+      if (subcommand === "list")
         return;
-      const {
-        themeApplyArgs,
-        themeImportArgs,
-        themeRemoveArgs
-      } = await import("./theme-m9dtxkhj.js");
-      const [positionalKey, positionalLabel, commandArgsDef] = subcommand === "apply" ? ["id", "ID", themeApplyArgs] : subcommand === "import" ? ["source", "SOURCE", themeImportArgs] : ["id", "ID", themeRemoveArgs];
-      rejectUnknownFlags(subcommandArgs, commandArgsDef, `theme ${subcommand}`);
+      const [positionalKey, positionalLabel, commandArgsDef] = subcommand === "add" ? ["source", "SOURCE", extAddArgs] : subcommand === "remove" ? ["specifier", "SPECIFIER", extRemoveArgs] : subcommand === "enable" ? ["specifier", "SPECIFIER", extEnableArgs] : ["specifier", "SPECIFIER", extDisableArgs];
+      rejectUnknownFlags(subcommandArgs, commandArgsDef, `ext ${subcommand}`);
       const parsed = parseArgs(subcommandArgs, {
         ...commandArgsDef,
         [positionalKey]: { ...commandArgsDef[positionalKey], required: false }
       });
       if (parsed[positionalKey] === undefined) {
-        throw new UsageError(`gutterpress theme ${subcommand}: missing required positional argument ${positionalLabel}`);
+        throw new UsageError(`gutterpress ext ${subcommand}: missing required positional argument ${positionalLabel}`);
       }
     }
   } catch (error) {
@@ -168,7 +139,7 @@ function resolveImplicitPreview(rawArgs) {
   return positional === undefined || isDirectory(positional) ? { usePreview: true } : { usePreview: false, unknownCommand: positional };
 }
 var rawArgs = process.argv.slice(2);
-if (rawArgs.length === 1 && (rawArgs[0] === "plugin" || rawArgs[0] === "theme")) {
+if (rawArgs.length === 1 && rawArgs[0] === "ext") {
   rawArgs.push("--help");
 }
 var wantsHelp = rawArgs.includes("--help") || rawArgs.includes("-h");

package/dist/{doctor-qvqye1wd.js → doctor-55r0ghtc.js}

@@ -1,12 +1,12 @@
 import {
   getSystemDiagnostics,
   log
-} from "./cli-vxf151ea.js";
+} from "./cli-fwh6rkev.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-vcv5ewqj.js";
+} from "./cli-0tgbgwnj.js";
 import"./cli-c41yr7he.js";
 import"./cli-46ycxe6r.js";
 import"./cli-37x76zdn.js";

package/dist/{engine-daad33qn.js → engine-19mshh07.js}

@@ -4,7 +4,7 @@ import {
   build,
   connectChromium,
   getBrowser
-} from "./cli-4vtgt2ng.js";
+} from "./cli-bx950tb4.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError
@@ -31,7 +31,7 @@ async function buildNativePdf(htmlFile, outPdf, options = {}, getEngineBrowser)
       await engineBrowser.close();
     }
   } catch (err) {
-    throw new BuildError(`--engine native failed: ${err instanceof Error ? err.message : String(err)}`);
+    throw new BuildError(`PDF build failed: ${err instanceof Error ? err.message : String(err)}`);
   }
   await writeFile(outPdf, result.bytes);
   return result.diagnostics;

package/dist/{engine-db8632w6.js → engine-d46wgg99.js}

@@ -1,13 +1,13 @@
 import {
   build
-} from "./index-rpt4vtby.js";
+} from "./index-dhgzkhs7.js";
 import {
   BuildError,
   RENDER_TIMEOUT_MS,
   assertMilestone,
   connectChromium,
   getBrowser
-} from "./index-9pbaznww.js";
+} from "./index-zwcv1njy.js";
 import"./index-37x76zdn.js";
 
 // src/lib/engine.ts
@@ -30,7 +30,7 @@ async function buildNativePdf(htmlFile, outPdf, options = {}, getEngineBrowser)
       await engineBrowser.close();
     }
   } catch (err) {
-    throw new BuildError(`--engine native failed: ${err instanceof Error ? err.message : String(err)}`);
+    throw new BuildError(`PDF build failed: ${err instanceof Error ? err.message : String(err)}`);
   }
   await writeFile(outPdf, result.bytes);
   return result.diagnostics;

package/dist/ext-04n7hydk.js

@@ -0,0 +1,268 @@
+import {
+  BUILT_IN_STYLE_SET_IDS,
+  addBuiltInStyleSet,
+  addExtension,
+  importExtensionFromFile,
+  importExtensionFromUrl,
+  isPathSpecifier,
+  listProjectExtensions,
+  parseExtensionSpecifier,
+  removeExtension,
+  setExtensionEnabled
+} from "./cli-vhdvkqdd.js";
+import"./cli-fwh6rkev.js";
+import {
+  UsageError,
+  exitForUsage,
+  rejectExtraPositionals,
+  rejectUnknownFlags,
+  resolveProjectDir
+} from "./cli-0tgbgwnj.js";
+import"./cli-bx950tb4.js";
+import"./cli-c41yr7he.js";
+import {
+  EXIT_CODES
+} from "./cli-46ycxe6r.js";
+import"./cli-w692g6dx.js";
+import"./cli-v5mp7a6q.js";
+import"./cli-37x76zdn.js";
+
+// src/commands/ext.ts
+import { defineCommand } from "citty";
+import { stat } from "node:fs/promises";
+import path from "node:path";
+var dirArg = {
+  type: "positional",
+  description: "Project directory (defaults to the current directory)",
+  required: false
+};
+var specifierArg = {
+  type: "positional",
+  description: "The extension's specifier as written in the manifest (an npm name, a bundled name, or a ./ path)",
+  required: true
+};
+var extListArgs = { dir: dirArg };
+var extAddArgs = {
+  source: {
+    type: "positional",
+    description: "What to add: an npm package (name or name@version), a bundled feature (markdown-it-mark, …), a folder or plugin file path, a .zip or .css file, or an http(s) URL",
+    required: true
+  },
+  dir: dirArg,
+  export: {
+    type: "string",
+    description: "Named module export to use as the plugin function (npm and path extensions only)",
+    required: false
+  },
+  look: {
+    type: "boolean",
+    description: "Treat SOURCE as a built-in look id (clean-book, zine, technical-doc): copy it into extensions/ and add it",
+    required: false
+  }
+};
+var extRemoveArgs = { specifier: specifierArg, dir: dirArg };
+var extEnableArgs = { specifier: specifierArg, dir: dirArg };
+var extDisableArgs = { specifier: specifierArg, dir: dirArg };
+var EXT_SUBCOMMANDS = ["list", "add", "remove", "enable", "disable"];
+var parentArgs = {};
+function rejectParentFlags(rawArgs) {
+  const first = rawArgs[0];
+  if (first === undefined || EXT_SUBCOMMANDS.includes(first))
+    return;
+  if (!first.startsWith("-"))
+    return;
+  try {
+    rejectUnknownFlags(rawArgs, parentArgs, "ext");
+  } catch (error) {
+    exitForUsage(error);
+  }
+}
+async function requireProjectDir(dir, verb) {
+  const projectDir = resolveProjectDir(dir);
+  let info;
+  try {
+    info = await stat(projectDir);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      throw new UsageError(`Project directory does not exist: ${projectDir}`);
+    }
+    throw error;
+  }
+  if (!info.isDirectory()) {
+    throw new UsageError(`Project path is not a directory: ${projectDir}`);
+  }
+  return projectDir;
+}
+function carriesLabel(entry) {
+  const parts = ["markdown", "styles", "snippets", "components"].filter((k) => entry.carries[k]);
+  return parts.length > 0 ? parts.join(", ") : "nothing declared";
+}
+function describeLine(entry) {
+  const state = entry.enabled ? "" : "  (disabled)";
+  const label = entry.label !== entry.name ? `  ${entry.label}` : "";
+  return `  ${entry.use}${state}  [${entry.kind}; ${carriesLabel(entry)}]${label}`;
+}
+function printAdded(entry, projectDir, warnings = []) {
+  if (entry.kind === "npm") {
+    console.log(`Installed ${entry.use}`);
+    console.log(`  project: ${projectDir}`);
+    console.log("  vendored under: plugins/npm");
+    console.log("  manifest: exact version pinned");
+  } else if (entry.kind === "bundled") {
+    console.log(`Enabled bundled feature ${entry.use}`);
+    console.log(`  project: ${projectDir}`);
+  } else {
+    console.log(`Added ${entry.use}  (${carriesLabel(entry)})`);
+    console.log(`  project: ${projectDir}`);
+    console.log("  referenced in place — edit the folder and the book follows");
+  }
+  for (const warning of [...entry.warnings ?? [], ...warnings])
+    console.warn(`Warning: ${warning}`);
+}
+function failPipeline(prefix, error) {
+  console.error(`${prefix}: ${error instanceof Error ? error.message : String(error)}`);
+  process.exit(EXIT_CODES.PIPELINE);
+}
+var list = defineCommand({
+  meta: { name: "list", description: "List the project's extensions in load (= cascade) order" },
+  args: extListArgs,
+  async run({ args, rawArgs }) {
+    let projectDir = "";
+    try {
+      rejectUnknownFlags(rawArgs, extListArgs, "ext list");
+      rejectExtraPositionals(args._, 1, "ext list");
+      projectDir = await requireProjectDir(args.dir, "list");
+    } catch (error) {
+      exitForUsage(error);
+    }
+    try {
+      const entries = await listProjectExtensions(projectDir);
+      if (entries.length === 0) {
+        console.log("No extensions configured. Add one with: gutterpress ext add <source>");
+        return;
+      }
+      console.log("Extensions (top loads first; a later entry's CSS wins ties):");
+      for (const entry of entries) {
+        console.log(describeLine(entry));
+        for (const warning of entry.warnings ?? [])
+          console.log(`      ! ${warning}`);
+      }
+    } catch (error) {
+      failPipeline("Could not list extensions", error);
+    }
+  }
+});
+var add = defineCommand({
+  meta: {
+    name: "add",
+    description: "Add an extension: an npm package, a bundled feature, a folder or plugin file, a .zip/.css file, or a URL"
+  },
+  args: extAddArgs,
+  async run({ args, rawArgs }) {
+    const source = String(args.source).trim();
+    const isUrl = /^https?:\/\//i.test(source);
+    const candidate = path.resolve(process.cwd(), source);
+    const existing = isUrl ? null : await stat(candidate).catch(() => null);
+    const isArchive = !!existing?.isFile() && /\.(zip|css)$/i.test(candidate);
+    let projectDir = "";
+    let exportName;
+    try {
+      rejectUnknownFlags(rawArgs, extAddArgs, "ext add");
+      rejectExtraPositionals(args._, 2, "ext add");
+      projectDir = await requireProjectDir(args.dir, "add");
+      exportName = typeof args.export === "string" ? args.export.trim() : undefined;
+      if (typeof args.export === "string" && !exportName) {
+        throw new UsageError("gutterpress ext add: --export requires a non-empty name");
+      }
+      if (args.look && !BUILT_IN_STYLE_SET_IDS.includes(source)) {
+        throw new UsageError(`gutterpress ext add --look: unknown built-in look "${source}" (one of: ${BUILT_IN_STYLE_SET_IDS.join(", ")})`);
+      }
+      if (!args.look && !isUrl && !existing) {
+        try {
+          if (path.isAbsolute(source) || isPathSpecifier(source)) {
+            throw new Error(`source not found: ${candidate}`);
+          }
+          parseExtensionSpecifier(source);
+        } catch (error) {
+          throw new UsageError(`gutterpress ext add: ${error instanceof Error ? error.message : String(error)}`);
+        }
+      }
+    } catch (error) {
+      exitForUsage(error);
+    }
+    try {
+      if (args.look) {
+        const entry2 = await addBuiltInStyleSet(projectDir, source);
+        printAdded(entry2, projectDir);
+        return;
+      }
+      if (isUrl) {
+        const { entry: entry2, warnings } = await importExtensionFromUrl(projectDir, source);
+        printAdded(entry2, projectDir, warnings.map((w) => w.message));
+        return;
+      }
+      if (isArchive) {
+        const { entry: entry2, warnings } = await importExtensionFromFile(projectDir, candidate);
+        printAdded(entry2, projectDir, warnings.map((w) => w.message));
+        return;
+      }
+      const entry = await addExtension(projectDir, existing ? candidate : source, { exportName });
+      printAdded(entry, projectDir);
+    } catch (error) {
+      failPipeline("Could not add extension", error);
+    }
+  }
+});
+function specifierCommand(name, description, argsDef, act) {
+  return defineCommand({
+    meta: { name, description },
+    args: argsDef,
+    async run({ args, rawArgs }) {
+      let projectDir = "";
+      try {
+        rejectUnknownFlags(rawArgs, argsDef, `ext ${name}`);
+        rejectExtraPositionals(args._, 2, `ext ${name}`);
+        projectDir = await requireProjectDir(args.dir, name);
+      } catch (error) {
+        exitForUsage(error);
+      }
+      try {
+        console.log(await act(projectDir, String(args.specifier).trim()));
+      } catch (error) {
+        exitForUsage(new UsageError(`gutterpress ext ${name}: ${error instanceof Error ? error.message : String(error)}`));
+      }
+    }
+  });
+}
+var remove = specifierCommand("remove", "Remove an extension from the manifest (an npm extension's vendored copy is deleted too)", extRemoveArgs, async (projectDir, specifier) => {
+  await removeExtension(projectDir, specifier);
+  return `Removed ${specifier}`;
+});
+var enable = specifierCommand("enable", "Turn a configured extension on", extEnableArgs, async (projectDir, specifier) => {
+  await setExtensionEnabled(projectDir, specifier, true);
+  return `Enabled ${specifier}`;
+});
+var disable = specifierCommand("disable", "Turn a configured extension off without removing it", extDisableArgs, async (projectDir, specifier) => {
+  await setExtensionEnabled(projectDir, specifier, false);
+  return `Disabled ${specifier}`;
+});
+var ext_default = defineCommand({
+  meta: {
+    name: "ext",
+    description: "List, add, remove, enable, or disable the project's extensions"
+  },
+  args: parentArgs,
+  setup({ rawArgs }) {
+    rejectParentFlags(rawArgs);
+  },
+  subCommands: { list, add, remove, enable, disable }
+});
+export {
+  extRemoveArgs,
+  extListArgs,
+  extEnableArgs,
+  extDisableArgs,
+  extAddArgs,
+  ext_default as default,
+  EXT_SUBCOMMANDS
+};

package/dist/{index-rpt4vtby.js → index-dhgzkhs7.js}

@@ -4,7 +4,7 @@ import {
   launchChromium,
   marginBoxAlign,
   marginBoxRectPt
-} from "./index-9pbaznww.js";
+} from "./index-zwcv1njy.js";
 
 // src/engine/compiler/build.ts
 import { readFile } from "node:fs/promises";