gutterpress 0.11.21 → 0.11.22-alpha.2

package/README.md

@@ -274,6 +274,17 @@ gutterpress publish --provider gdrive --connect
 gutterpress publish --provider gdrive ./my-book
 ```
 
+**Publishing plugins (experimental — may change or be removed).** `--provider`
+also takes the package name of a publishing plugin listed in the book's
+`extensions:`. `--list` shows those plugins after the built-ins with the status
+`experimental` (`experimental: true` in `--json`). A plugin whose downloaded
+copy is missing is downloaded first, as for `build` (a failed download exits 3
+with the reason); publishing to a built-in never loads plugins. See
+[User Guide: Chapter 8 — Publishing](https://github.com/dimm-city/gutterpress/blob/main/examples/gutterpress-user-guide/08-publishing.md)
+for authors and
+[Chapter 5 — Plugins](https://github.com/dimm-city/gutterpress/blob/main/examples/gutterpress-user-guide/05-plugins.md)
+for the plugin contract.
+
 ### `gutterpress validate`
 
 Run the validation pipeline (pre-build source checks and/or post-build PDF checks). Tools that aren't installed are skipped with a warning — they don't fail the run. See [User Guide: Chapter 6 — Validation](https://github.com/dimm-city/gutterpress/blob/main/examples/gutterpress-user-guide/06-validation.md) for the full check list and [User Guide: Chapter 7 — System Setup](https://github.com/dimm-city/gutterpress/blob/main/examples/gutterpress-user-guide/07-system-setup.md) for which external tools each check needs.

package/dist/api/index.d.ts

@@ -55,6 +55,8 @@ export { readPageSetup, setPageSetup } from "../lib/page-size.ts";
 export type { PageSetup, PageSizeChoice, PageSizePoints } from "../lib/page-size.ts";
 export { providerFor, restoreVersionWithBackup, isNoChangesError, countUnversionedChanges, whenGitIdle, AUTO_SNAPSHOT_MESSAGE, RESTORE_BACKUP_MESSAGE, HISTORY_PAGE_LIMIT, listLocalBranches, switchBranch, SWITCH_BRANCH_SNAPSHOT_MESSAGE, } from "../lib/source-provider.ts";
 export type { ListHistoryOptions, HistoryPage, UnversionedChanges, LocalBranches, SwitchBranchOptions, SwitchBranchResult, } from "../lib/source-provider.ts";
+export { describeVersions, listOnlineVersions, compareVersionFile, exportVersionTree, VERSION_CHANGES_SHOWN, } from "../lib/version-changes.ts";
+export type { VersionEntry, VersionFileChange, CompareRow } from "../lib/version-changes.ts";
 export { autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, AUTO_SYNC_PUSH_INTERVAL_MINUTES, } from "../lib/host-policy.ts";
 export type { AutoSnapshotPolicy, AutoSyncPolicy, } from "../lib/host-policy.ts";
 export { FileTokenStore, defaultConfigDir, extractUrlCredential, } from "../lib/remote-auth/token-store.ts";
@@ -85,6 +87,8 @@ export type { SnapshotEntry, InitVersionHistoryOptions, SnapshotOptions, Restore
 export { runPublish, resolvePublishRequest, resolvePublishFormat, } from "../lib/publish/run-publish.ts";
 export type { RunPublishOptions, RunPublishResult, } from "../lib/publish/run-publish.ts";
 export { listPublishProviders, publishProviderFor, } from "../lib/publish/registry.ts";
+export { listBookPublishProviders, resolvePublishProvider, } from "../lib/publish/plugin-provider.ts";
+export type { PublishBook } from "../lib/publish/plugin-provider.ts";
 export { connectPublishProvider, disconnectPublishCredential } from "../lib/publish/connect.ts";
 export type { ConnectPublishProviderOptions, DisconnectPublishCredentialOptions, } from "../lib/publish/connect.ts";
 export { publishConnectionStatus, publishCredentialKey, listPublishAccounts, } from "../lib/publish/types.ts";
@@ -92,6 +96,6 @@ export type { PublishSavedAccount } from "../lib/publish/types.ts";
 export { PublishSelectionsStore } from "../lib/publish/selections.ts";
 export type { PublishAccountSelection } from "../lib/publish/selections.ts";
 export { readPublishSettings, setPublishProviderConfig, } from "../lib/publish/manifest-publish.ts";
-export type { PublishProvider, PublishProviderId, PublishProviderInfo, PublishProviderKind, PublishConfigField, PublishArtifact, PublishArtifactFormat, PublishAuthStatus, PublishDeps, PublishListingMetadata, PublishOutcome, PublishProduct, PublishProject, PublishRequest, PreflightIssue, CommandRunner, CommandResult, } from "../lib/publish/types.ts";
+export type { PublishProvider, PublishProviderId, PublishProviderInfo, PublishProviderKind, PublishConfigField, PublishArtifact, PublishArtifactFormat, PublishAuthStatus, PublishDeps, PublishListingMetadata, PublishOutcome, PublishProduct, PublishProject, PublishRequest, PreflightIssue, CommandRunner, CommandResult, PublishPluginContext, PublishPluginFunction, PublishPluginResult, } from "../lib/publish/types.ts";
 export { resolveLogger } from "../lib/remote-auth/operation-log.ts";
 export type { OperationLogger, LogData } from "../lib/remote-auth/operation-log.ts";

package/dist/api/index.js

@@ -4,69 +4,50 @@ import {
   AUTO_SYNC_MAX_MINUTES,
   AUTO_SYNC_MIN_MINUTES,
   AUTO_SYNC_PUSH_INTERVAL_MINUTES,
-  BUILT_IN_STYLE_SET_IDS,
   BUILT_IN_TEMPLATE_IDS,
-  BUNDLED_EXTENSIONS,
-  DEFAULT_NPM_REGISTRY,
-  EXTENSIONS_DIR,
   EXTENSION_KINDS,
-  EXTENSION_MANIFEST_FILENAME,
   FileTokenStore,
   GDRIVE_HOST,
   GITHUB_HOST,
   GOOGLE_NOT_CONFIGURED_MESSAGE,
   GitHubAuthProvider,
   GoogleAuthProvider,
-  MANIFEST_FILENAMES,
   MAX_SEARCH_BYTES,
-  PRESETS,
-  PRESET_IDS,
   PublishSelectionsStore,
-  RECOMMENDED_EXTENSIONS,
   REPAIR_SNAPSHOT_MESSAGE,
   RESERVED_PREFIX,
   SEARCH_KEYWORDS,
   SNIPPETS_DIR,
   SYNC_SNAPSHOT_MESSAGE,
-  TARGETS,
-  TARGET_IDS,
-  addBuiltInStyleSet,
-  addExtension,
+  VERSION_CHANGES_SHOWN,
   adoptFolder,
-  assertExtensionContained,
   autoSnapshotDelayMs,
   autoSyncDelayMs,
-  checkExtensionUpdates,
   checkRemoteUpdates,
   cloneRepository,
+  compareVersionFile,
   connectGenericHost,
   connectGoogleDrive,
   connectPublishProvider,
   defaultConfigDir,
   deleteSnippet,
-  describeExtension,
+  describeVersions,
   diagnoseProjectRemote,
   disconnectPublishCredential,
-  ensureProjectGitignore,
   escapeYamlScalar,
-  extensionCarries,
-  extensionEntry,
-  extensionStyleList,
+  exportVersionTree,
   extractUrlCredential,
   extractVariables,
   forgeKindForHost,
   getSystemDiagnostics,
-  hasProjectManifest,
   importExtensionFromFile,
   importExtensionFromUrl,
   importTemplateFromFolder,
-  isBundledExtension,
   isGitInternalPath,
-  isPathSpecifier,
   isSshRemoteUrl,
   isValidRepositoryName,
   knownForgeTokenUrl,
-  listBuiltInStyleSets,
+  listBookPublishProviders,
   listBuiltInTemplates,
   listCustomTemplates,
   listGitHubBranches,
@@ -74,48 +55,34 @@ import {
   listLocationVariants,
   listMarkerComponents,
   listMergedSnippets,
-  listNpmVersions,
-  listProjectExtensions,
+  listOnlineVersions,
   listProjectStyles,
   listPublishAccounts,
   listPublishProviders,
   listRepoBooks,
   listSnippets,
-  loadManifestWithPath,
-  npmRegistryUrl,
-  parseExtensionSpecifier,
   parseRemoteOrigin,
-  pathEscapesFolder,
   pkceChallengeFromVerifier,
   publishConnectionStatus,
   publishCredentialKey,
   publishProviderFor,
-  publishTargetFor,
-  readExtensionCss,
-  readExtensionMeta,
   readManifestFields,
   readPageSetup,
   readPublishSettings,
   refreshRemoteCopies,
-  removeExtension,
-  reorderExtensions,
   repairOnlineBackup,
   requireGoogleClientCredentials,
   resolveActiveStyles,
-  resolveConfig,
-  resolveExtension,
   resolveExtensionPrefix,
   resolveGitHubClientId,
   resolveGoogleClientId,
   resolveGoogleClientSecret,
   resolvePublishFormat,
+  resolvePublishProvider,
   resolvePublishRequest,
-  restoreFailureMessage,
-  restorePinnedExtensions,
   revokeGoogleCredential,
   runBuild,
   runPublish,
-  sameExtension,
   sanitizeCloneFolderName,
   saveProjectAsTemplate,
   saveSnippet,
@@ -124,7 +91,6 @@ import {
   scorchedEarth,
   searchNpmExtensions,
   setActiveStyles,
-  setExtensionEnabled,
   setManifestFields,
   setPageSetup,
   setPublishProviderConfig,
@@ -134,15 +100,61 @@ import {
   startPreviewServer,
   substituteVariables,
   syncProject,
-  testRemoteAccess,
+  testRemoteAccess
+} from "../index-3wcr69ba.js";
+import {
+  BUILT_IN_STYLE_SET_IDS,
+  BUNDLED_EXTENSIONS,
+  DEFAULT_NPM_REGISTRY,
+  EXTENSIONS_DIR,
+  MANIFEST_FILENAMES,
+  PRESETS,
+  PRESET_IDS,
+  RECOMMENDED_EXTENSIONS,
+  TARGETS,
+  TARGET_IDS,
+  addBuiltInStyleSet,
+  addExtension,
+  checkExtensionUpdates,
+  describeExtension,
+  ensureProjectGitignore,
+  hasProjectManifest,
+  isBundledExtension,
+  isPathSpecifier,
+  listBuiltInStyleSets,
+  listNpmVersions,
+  listProjectExtensions,
+  loadManifestWithPath,
+  npmRegistryUrl,
+  parseExtensionSpecifier,
+  publishTargetFor,
+  readExtensionCss,
+  removeExtension,
+  reorderExtensions,
+  resolveConfig,
+  restoreFailureMessage,
+  restorePinnedExtensions,
+  sameExtension,
+  setExtensionEnabled,
   updateExtensions,
   validateProjectExtensions
-} from "../index-mr7zs8mv.js";
+} from "../index-ew7cyk7c.js";
+import {
+  EXTENSION_MANIFEST_FILENAME,
+  assertExtensionContained,
+  extensionCarries,
+  extensionEntry,
+  extensionStyleList,
+  pathEscapesFolder,
+  readExtensionMeta,
+  resolveExtension
+} from "../index-kx03e4m4.js";
 import"../index-ht1bcqdd.js";
+import"../index-apc8w9w8.js";
 import {
   BuildError
-} from "../index-mr72vt8n.js";
-import"../index-sth219v1.js";
+} from "../index-jsz0s3dy.js";
+import"../index-2ppw6q9v.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,
@@ -151,7 +163,6 @@ import {
 import {
   AUTO_SNAPSHOT_MESSAGE,
   HISTORY_PAGE_LIMIT,
-  PLUGINS_DIR,
   RESTORE_BACKUP_MESSAGE,
   SWITCH_BRANCH_SNAPSHOT_MESSAGE,
   countUnversionedChanges,
@@ -162,7 +173,10 @@ import {
   restoreVersionWithBackup,
   switchBranch,
   whenGitIdle
-} from "../index-qf7y4d85.js";
+} from "../index-93pqkvty.js";
+import {
+  PLUGINS_DIR
+} from "../index-r7jcsk6h.js";
 import {
   capabilitiesFor,
   detectProjectSource,
@@ -203,6 +217,7 @@ export {
   restorePinnedExtensions,
   restoreFailureMessage,
   resolvePublishRequest,
+  resolvePublishProvider,
   resolvePublishFormat,
   resolveLogger,
   resolveGoogleClientSecret,
@@ -242,6 +257,7 @@ export {
   listPublishAccounts,
   listProjectStyles,
   listProjectExtensions,
+  listOnlineVersions,
   listNpmVersions,
   listMergedSnippets,
   listMarkerComponents,
@@ -252,6 +268,7 @@ export {
   listCustomTemplates,
   listBuiltInTemplates,
   listBuiltInStyleSets,
+  listBookPublishProviders,
   knownForgeTokenUrl,
   isValidRepositoryName,
   isSshRemoteUrl,
@@ -271,11 +288,13 @@ export {
   extensionStyleList,
   extensionEntry,
   extensionCarries,
+  exportVersionTree,
   escapeYamlScalar,
   ensureProjectGitignore,
   disconnectPublishCredential,
   diagnoseProjectRemote,
   detectProjectSource,
+  describeVersions,
   describeExtension,
   deleteSnippet,
   defaultConfigDir,
@@ -283,6 +302,7 @@ export {
   connectPublishProvider,
   connectGoogleDrive,
   connectGenericHost,
+  compareVersionFile,
   cloneRepository,
   checkRemoteUpdates,
   checkExtensionUpdates,
@@ -294,6 +314,7 @@ export {
   adoptFolder,
   addExtension,
   addBuiltInStyleSet,
+  VERSION_CHANGES_SHOWN,
   TARGET_IDS,
   TARGETS,
   SYNC_SNAPSHOT_MESSAGE,

package/dist/{build-0neyk5h6.js → build-84retk4k.js}

@@ -1,27 +1,33 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-j0drzb6f.js";
+} from "./cli-885pcze8.js";
+import"./cli-5qhjwne5.js";
+import"./cli-ht1bcqdd.js";
+import"./cli-9pk65fqf.js";
+import"./cli-2ppw6q9v.js";
+import"./cli-eyyggect.js";
+import"./cli-asap4t1z.js";
+import"./cli-habkc5ng.js";
+import"./cli-v5mp7a6q.js";
+import"./cli-5et23z83.js";
+import"./cli-pn3z0y9p.js";
 import {
   log
-} from "./cli-j79451n6.js";
+} from "./cli-80t93x2r.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-sqkccnm7.js";
-import"./cli-ht1bcqdd.js";
-import"./cli-b57adna7.js";
+} from "./cli-d8xjns66.js";
+import"./cli-3twpesca.js";
+import"./cli-hndkg7bn.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
-import"./cli-sth219v1.js";
-import"./cli-eyyggect.js";
-import"./cli-asap4t1z.js";
-import"./cli-5qr3z0qa.js";
-import"./cli-v5mp7a6q.js";
+import"./cli-h3phdstf.js";
 import"./cli-37x76zdn.js";
 
 // src/commands/build.ts

package/dist/{index-sth219v1.js → cli-2ppw6q9v.js}

@@ -168,6 +168,14 @@ function getTextPass(doc) {
   return p;
 }
 var opCache = new WeakMap;
+var opSet = (names) => new Set(names.map((name) => OPS[name]).filter((op) => op !== undefined));
+var IMAGE_OPS = opSet([
+  "paintImageXObject",
+  "paintImageXObjectRepeat",
+  "paintInlineImageXObject",
+  "paintImageMaskXObject",
+  "paintJpegXObject"
+]);
 function multiply(m1, m2) {
   return [
     m1[0] * m2[0] + m1[2] * m2[1],
@@ -219,14 +227,27 @@ function getOpPass(doc) {
             ctm = stack.pop() ?? ctm;
           } else if (fn === OPS.transform) {
             ctm = multiply(ctm, args);
-          } else if (fn === OPS.paintImageXObject || fn === OPS.paintImageXObjectRepeat || fn === OPS.paintInlineImageXObject) {
+          } else if (fn === OPS.paintFormXObjectBegin) {
+            stack.push(ctm.slice());
+            const matrix = args[0];
+            if (Array.isArray(matrix))
+              ctm = multiply(ctm, matrix);
+          } else if (fn === OPS.paintFormXObjectEnd) {
+            ctm = stack.pop() ?? ctm;
+          } else if (IMAGE_OPS.has(fn)) {
             const name = typeof args[0] === "string" ? args[0] : "(inline)";
+            const [a, b, c, d, e, f] = ctm;
+            const xs = [e, a + e, c + e, a + c + e];
+            const ys = [f, b + f, d + f, b + d + f];
+            const x0 = Math.min(...xs);
+            const y0 = Math.min(...ys);
             pageImages.push({
               name,
-              placedW: Math.hypot(ctm[0], ctm[1]),
-              placedH: Math.hypot(ctm[2], ctm[3]),
-              x: ctm[4],
-              y: ctm[5],
+              placedW: Math.hypot(a, b),
+              placedH: Math.hypot(c, d),
+              x: e,
+              y: f,
+              bounds: { x: x0, y: y0, w: Math.max(...xs) - x0, h: Math.max(...ys) - y0 },
               page: i
             });
           } else if (fn === OPS.setFont) {
@@ -254,7 +275,6 @@ function getOpPass(doc) {
   }
   return p;
 }
-var opSet = (names) => new Set(names.map((name) => OPS[name]).filter((op) => op !== undefined));
 var FILL_COLOR_OPS = opSet(["setFillGray", "setFillRGBColor", "setFillCMYKColor", "setFillColor"]);
 var STROKE_COLOR_OPS = opSet(["setStrokeGray", "setStrokeRGBColor", "setStrokeCMYKColor", "setStrokeColor"]);
 var SHOW_TEXT_OPS = opSet(["showText", "showSpacedText", "nextLineShowText", "nextLineSetSpacingShowText"]);

package/dist/cli-3twpesca.js

@@ -0,0 +1,103 @@
+// package.json
+var package_default = {
+  name: "gutterpress",
+  version: "0.11.22-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",
+  keywords: [
+    "markdown",
+    "pdf",
+    "print",
+    "ghostscript",
+    "book",
+    "publishing",
+    "zine"
+  ],
+  repository: {
+    type: "git",
+    url: "https://github.com/dimm-city/gutterpress.git"
+  },
+  homepage: "https://github.com/dimm-city/gutterpress#readme",
+  bugs: {
+    url: "https://github.com/dimm-city/gutterpress/issues"
+  },
+  type: "module",
+  main: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  bin: {
+    gutterpress: "./dist/cli.js"
+  },
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      default: "./dist/index.js"
+    },
+    "./api": {
+      types: "./dist/api/index.d.ts",
+      default: "./dist/api/index.js"
+    },
+    "./render": {
+      types: "./dist/render.d.ts",
+      default: "./dist/render.js"
+    }
+  },
+  files: [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  scripts: {
+    "build:library": "bun scripts/build-engine-bundles.mjs && rimraf dist && bun build src/index.ts src/api/index.ts --target=node --packages=external --splitting --outdir=dist && bun build src/render.ts --target=node --packages=external --outdir=dist && node scripts/check-render-pure.mjs && tsc -p tsconfig.build.json",
+    build: "bun run build:library && bun build src/cli.ts --target=node --packages=external --splitting --outdir=dist",
+    prepublishOnly: "bun run build",
+    test: "bun test",
+    typecheck: "tsc --noEmit",
+    "typecheck:engine-browser": "tsc --noEmit -p src/engine/browser.tsconfig.json",
+    "parity:gate": "bun scripts/native-parity-gate.ts"
+  },
+  engines: {
+    bun: ">=1.0.0",
+    node: ">=22.0.0"
+  },
+  dependencies: {
+    chokidar: "^5.0.0",
+    citty: "^0.2.0",
+    diff3: "0.0.3",
+    fflate: "0.8.3",
+    glob: "^13.0.0",
+    htmlhint: "^1.9.2",
+    ignore: "^5.3.2",
+    "isomorphic-git": "^1.38.4",
+    "markdown-it": "^14.3.2",
+    "markdown-it-abbr": "^2.0.0",
+    "markdown-it-attrs": "^4.3.0",
+    "markdown-it-deflist": "^3.0.1",
+    "markdown-it-footnote": "^4.0.0",
+    "markdown-it-mark": "^4.0.0",
+    "markdown-it-source-map": "^0.1.1",
+    "markdown-it-sub": "^2.0.0",
+    "markdown-it-sup": "^2.0.0",
+    markdownlint: "^0.40.0",
+    "pdf-lib": "^1.17.1",
+    postcss: "^8.5.18",
+    "resolve.exports": "2.0.3",
+    semver: "7.8.0",
+    tar: "7.5.22",
+    unpdf: "^1.6.2",
+    ws: "^8.21.0",
+    yaml: "^2.8.2"
+  },
+  devDependencies: {
+    "@types/bun": "1.3.14",
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^22.0.0",
+    "@types/semver": "^7.7.1",
+    "@types/ws": "^8.5.13",
+    playwright: "^1.60.0",
+    rimraf: "^6.0.0",
+    typescript: "^5"
+  }
+};
+
+export { package_default };