gutterpress 0.11.5 → 0.11.6-alpha.2

package/dist/api/index.js

@@ -124,7 +124,7 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectExtensions
-} from "../index-771dmhpc.js";
+} from "../index-nmykzwb4.js";
 import {
   BuildError,
   DEFAULT_PRINT_OPTS,

package/dist/{audit-wxzty30c.js → audit-fdba6axw.js}

@@ -1,14 +1,14 @@
 import {
   executeAndReport
-} from "./cli-d8my7adx.js";
+} from "./cli-7k2v2sya.js";
 import {
   log
-} from "./cli-pqe8cahv.js";
+} from "./cli-wmvvkwcc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-fxk3whwm.js";
+} from "./cli-ersw5g7j.js";
 import"./cli-sekhwex4.js";
 import"./cli-c41yr7he.js";
 import {

package/dist/{build-m54gr7r3.js → build-2gjr2rj6.js}

@@ -1,17 +1,17 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-d8my7adx.js";
+} from "./cli-7k2v2sya.js";
 import {
   log
-} from "./cli-pqe8cahv.js";
+} from "./cli-wmvvkwcc.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-fxk3whwm.js";
+} from "./cli-ersw5g7j.js";
 import"./cli-sekhwex4.js";
 import"./cli-c41yr7he.js";
 import {

package/dist/{cli-d8my7adx.js → cli-7k2v2sya.js}

@@ -13,12 +13,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-pqe8cahv.js";
+} from "./cli-wmvvkwcc.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-fxk3whwm.js";
+} from "./cli-ersw5g7j.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   RENDER_TIMEOUT_MS,
@@ -5836,7 +5836,7 @@ async function loadNpmPackage(packageName, baseDir, version) {
   } catch {}
   const looksLikeJsFilename = /\.(m?js|cjs)$/i.test(packageName);
   const suggestedPath = looksLikeJsFilename ? `./${packageName}` : `./plugins/${packageName}.js`;
-  throw new Error(`Extension "${packageName}" not found. Install it with \`gutterpress ext add ${packageName}\` (or Project settings > Extensions),
+  throw new Error(`Extension "${packageName}" not found. Install it with \`gutterpress ext add ${packageName}\` (or Book settings > Features > Advanced in the desktop app),
 or reference a local file under \`extensions:\`:
   extensions:
     - ${suggestedPath}`);
@@ -11376,27 +11376,27 @@ var RECOMMENDED_EXTENSIONS = [
   {
     use: "markdown-it-mark",
     label: "Highlight",
-    description: "Highlighted text with `==marked==` -> `<mark>`."
+    description: "Highlight text by wrapping it in `==double equals==`."
   },
   {
     use: "markdown-it-sub",
     label: "Subscript",
-    description: "Subscript text with `H~2~O`."
+    description: "Lower text below the line, like the 2 in `H~2~O`."
   },
   {
     use: "markdown-it-sup",
     label: "Superscript",
-    description: "Superscript text with `29^th^`."
+    description: "Raise text above the line, like the th in `29^th^`."
   },
   {
     use: "markdown-it-abbr",
     label: "Abbreviations",
-    description: "Define `*[HTML]: Hyper Text...` and get `<abbr>` tooltips."
+    description: "Explain an abbreviation when readers hover over it. Define it once, like `*[GPS]: Global Positioning System`."
   },
   {
     use: "gutterpress-gfm-alerts",
     label: "Callouts",
-    description: "GitHub-style `> [!NOTE]` alert boxes (Note/Tip/Important/Warning/Caution)."
+    description: "Turn a quote into a boxed note: start it with `> [!NOTE]` (or `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`)."
   }
 ];
 var BUILT_IN_STYLE_SET_IDS = ["clean-book", "zine", "technical-doc"];

package/dist/{cli-fxk3whwm.js → cli-ersw5g7j.js}

@@ -4,7 +4,7 @@ import {
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.5",
+  version: "0.11.6-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",

package/dist/{cli-pqe8cahv.js → cli-wmvvkwcc.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-fxk3whwm.js";
+} from "./cli-ersw5g7j.js";
 import {
   execCapture,
   findTool,

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-fxk3whwm.js";
+} from "./cli-ersw5g7j.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
@@ -18,16 +18,16 @@ import {
 import { defineCommand, parseArgs, runMain } from "citty";
 import { statSync } from "node:fs";
 var SUBCOMMANDS = {
-  new: () => import("./new-t3mcy3st.js").then((m) => m.default),
-  preview: () => import("./preview-aasty7am.js").then((m) => m.default),
-  build: () => import("./build-m54gr7r3.js").then((m) => m.default),
-  publish: () => import("./publish-9g4dph7e.js").then((m) => m.default),
-  lint: () => import("./lint-s4ydm5zs.js").then((m) => m.default),
-  validate: () => import("./validate-mrp8dve2.js").then((m) => m.default),
-  audit: () => import("./audit-wxzty30c.js").then((m) => m.default),
-  preflight: () => import("./preflight-phf1d3e0.js").then((m) => m.default),
-  doctor: () => import("./doctor-3aj8rkjs.js").then((m) => m.default),
-  ext: () => import("./ext-cwpwca5v.js").then((m) => m.default)
+  new: () => import("./new-nxxx2mv2.js").then((m) => m.default),
+  preview: () => import("./preview-j59b5hg3.js").then((m) => m.default),
+  build: () => import("./build-2gjr2rj6.js").then((m) => m.default),
+  publish: () => import("./publish-mzct8ggw.js").then((m) => m.default),
+  lint: () => import("./lint-0pfqbs5r.js").then((m) => m.default),
+  validate: () => import("./validate-z2drbha6.js").then((m) => m.default),
+  audit: () => import("./audit-fdba6axw.js").then((m) => m.default),
+  preflight: () => import("./preflight-g7xjme17.js").then((m) => m.default),
+  doctor: () => import("./doctor-vgarhrsg.js").then((m) => m.default),
+  ext: () => import("./ext-hb5k5gga.js").then((m) => m.default)
 };
 var VERSION = package_default.version;
 var main = defineCommand({
@@ -52,7 +52,7 @@ async function preflightRequiredInvocations(rawArgs) {
   const [command, ...commandArgs] = rawArgs;
   try {
     if (command === "new") {
-      const { newArgs } = await import("./new-t3mcy3st.js");
+      const { newArgs } = await import("./new-nxxx2mv2.js");
       rejectUnknownFlags(commandArgs, newArgs, "new");
       const parsed = parseArgs(commandArgs, {
         ...newArgs,
@@ -64,7 +64,7 @@ async function preflightRequiredInvocations(rawArgs) {
       return;
     }
     if (command === "preflight") {
-      const { preflightArgs } = await import("./preflight-phf1d3e0.js");
+      const { preflightArgs } = await import("./preflight-g7xjme17.js");
       rejectUnknownFlags(commandArgs, preflightArgs, "preflight");
       const parsed = parseArgs(commandArgs, {
         ...preflightArgs,
@@ -84,7 +84,7 @@ async function preflightRequiredInvocations(rawArgs) {
       }
       if (subcommand.startsWith("-"))
         return;
-      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-cwpwca5v.js");
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-hb5k5gga.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

package/dist/{doctor-3aj8rkjs.js → doctor-vgarhrsg.js}

@@ -1,12 +1,12 @@
 import {
   getSystemDiagnostics,
   log
-} from "./cli-pqe8cahv.js";
+} from "./cli-wmvvkwcc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-fxk3whwm.js";
+} from "./cli-ersw5g7j.js";
 import"./cli-c41yr7he.js";
 import"./cli-46ycxe6r.js";
 import"./cli-37x76zdn.js";

package/dist/{ext-cwpwca5v.js → ext-hb5k5gga.js}

@@ -10,15 +10,15 @@ import {
   removeExtension,
   searchNpmExtensions,
   setExtensionEnabled
-} from "./cli-d8my7adx.js";
-import"./cli-pqe8cahv.js";
+} from "./cli-7k2v2sya.js";
+import"./cli-wmvvkwcc.js";
 import {
   UsageError,
   exitForUsage,
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolveProjectDir
-} from "./cli-fxk3whwm.js";
+} from "./cli-ersw5g7j.js";
 import"./cli-sekhwex4.js";
 import"./cli-c41yr7he.js";
 import {

package/dist/{index-771dmhpc.js → index-nmykzwb4.js}

@@ -4338,7 +4338,7 @@ async function loadNpmPackage(packageName, baseDir, version) {
   } catch {}
   const looksLikeJsFilename = /\.(m?js|cjs)$/i.test(packageName);
   const suggestedPath = looksLikeJsFilename ? `./${packageName}` : `./plugins/${packageName}.js`;
-  throw new Error(`Extension "${packageName}" not found. Install it with \`gutterpress ext add ${packageName}\` (or Project settings > Extensions),
+  throw new Error(`Extension "${packageName}" not found. Install it with \`gutterpress ext add ${packageName}\` (or Book settings > Features > Advanced in the desktop app),
 or reference a local file under \`extensions:\`:
   extensions:
     - ${suggestedPath}`);
@@ -4875,7 +4875,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.5",
+  version: "0.11.6-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",
@@ -12433,27 +12433,27 @@ var RECOMMENDED_EXTENSIONS = [
   {
     use: "markdown-it-mark",
     label: "Highlight",
-    description: "Highlighted text with `==marked==` -> `<mark>`."
+    description: "Highlight text by wrapping it in `==double equals==`."
   },
   {
     use: "markdown-it-sub",
     label: "Subscript",
-    description: "Subscript text with `H~2~O`."
+    description: "Lower text below the line, like the 2 in `H~2~O`."
   },
   {
     use: "markdown-it-sup",
     label: "Superscript",
-    description: "Superscript text with `29^th^`."
+    description: "Raise text above the line, like the th in `29^th^`."
   },
   {
     use: "markdown-it-abbr",
     label: "Abbreviations",
-    description: "Define `*[HTML]: Hyper Text...` and get `<abbr>` tooltips."
+    description: "Explain an abbreviation when readers hover over it. Define it once, like `*[GPS]: Global Positioning System`."
   },
   {
     use: "gutterpress-gfm-alerts",
     label: "Callouts",
-    description: "GitHub-style `> [!NOTE]` alert boxes (Note/Tip/Important/Warning/Caution)."
+    description: "Turn a quote into a boxed note: start it with `> [!NOTE]` (or `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`)."
   }
 ];
 var BUILT_IN_STYLE_SET_IDS = ["clean-book", "zine", "technical-doc"];

package/dist/index.js

@@ -143,7 +143,7 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectExtensions
-} from "./index-771dmhpc.js";
+} from "./index-nmykzwb4.js";
 import {
   BUILD_DIAGNOSTIC_CODES
 } from "./index-12pvhbyz.js";

package/dist/lib/extension-manager.d.ts

@@ -60,7 +60,9 @@ export interface RecommendedExtension {
     use: string;
     /** Short, plain-language feature name shown as the row title. */
     label: string;
-    /** One-line author-friendly description. */
+    /** One-line author-friendly description in plain words. Backtick spans mark
+     *  "what to type" (the desktop sets them in code type), so keep them paired
+     *  and keep HTML tag names out of the prose. */
     description: string;
 }
 /**

package/dist/{lint-s4ydm5zs.js → lint-0pfqbs5r.js}

@@ -1,15 +1,15 @@
 import {
   MANIFEST_FILENAMES,
   runLint
-} from "./cli-d8my7adx.js";
+} from "./cli-7k2v2sya.js";
 import {
   log
-} from "./cli-pqe8cahv.js";
+} from "./cli-wmvvkwcc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-fxk3whwm.js";
+} from "./cli-ersw5g7j.js";
 import"./cli-sekhwex4.js";
 import"./cli-c41yr7he.js";
 import {

package/dist/{new-t3mcy3st.js → new-nxxx2mv2.js}

@@ -7,15 +7,15 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-d8my7adx.js";
+} from "./cli-7k2v2sya.js";
 import {
   resolveGhostscript
-} from "./cli-pqe8cahv.js";
+} from "./cli-wmvvkwcc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-fxk3whwm.js";
+} from "./cli-ersw5g7j.js";
 import"./cli-sekhwex4.js";
 import {
   isToolAvailable

package/dist/{preflight-phf1d3e0.js → preflight-g7xjme17.js}

@@ -2,15 +2,15 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} from "./cli-d8my7adx.js";
+} from "./cli-7k2v2sya.js";
 import {
   log
-} from "./cli-pqe8cahv.js";
+} from "./cli-wmvvkwcc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-fxk3whwm.js";
+} from "./cli-ersw5g7j.js";
 import"./cli-sekhwex4.js";
 import"./cli-c41yr7he.js";
 import {

package/dist/{preview-aasty7am.js → preview-j59b5hg3.js}

@@ -6,10 +6,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-d8my7adx.js";
+} from "./cli-7k2v2sya.js";
 import {
   log
-} from "./cli-pqe8cahv.js";
+} from "./cli-wmvvkwcc.js";
 import {
   UsageError,
   parseFormat,
@@ -17,7 +17,7 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-fxk3whwm.js";
+} from "./cli-ersw5g7j.js";
 import"./cli-sekhwex4.js";
 import"./cli-c41yr7he.js";
 import {

package/dist/{publish-9g4dph7e.js → publish-mzct8ggw.js}

@@ -11,16 +11,16 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-d8my7adx.js";
+} from "./cli-7k2v2sya.js";
 import {
   FileTokenStore,
   log
-} from "./cli-pqe8cahv.js";
+} from "./cli-wmvvkwcc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-fxk3whwm.js";
+} from "./cli-ersw5g7j.js";
 import"./cli-sekhwex4.js";
 import"./cli-c41yr7he.js";
 import {

package/dist/{validate-mrp8dve2.js → validate-z2drbha6.js}

@@ -1,14 +1,14 @@
 import {
   executeAndReport
-} from "./cli-d8my7adx.js";
+} from "./cli-7k2v2sya.js";
 import {
   log
-} from "./cli-pqe8cahv.js";
+} from "./cli-wmvvkwcc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-fxk3whwm.js";
+} from "./cli-ersw5g7j.js";
 import"./cli-sekhwex4.js";
 import"./cli-c41yr7he.js";
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.11.5",
+  "version": "0.11.6-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",