gutterpress 0.10.8 → 0.10.9

package/dist/api/index.js

@@ -6,8 +6,10 @@ import {
   AUTO_SYNC_MAX_MINUTES,
   AUTO_SYNC_MIN_MINUTES,
   AUTO_SYNC_PUSH_INTERVAL_MINUTES,
+  BUILT_IN_STYLE_SET_IDS,
   BUILT_IN_TEMPLATE_IDS,
-  BUILT_IN_THEME_IDS,
+  BUNDLED_EXTENSIONS,
+  EXTENSIONS_DIR,
   EXTENSION_KINDS,
   EXTENSION_MANIFEST_FILENAME,
   FileTokenStore,
@@ -22,17 +24,15 @@ import {
   PRESETS,
   PRESET_IDS,
   PublishSelectionsStore,
-  RECOMMENDED_PLUGINS,
+  RECOMMENDED_EXTENSIONS,
   RESERVED_PREFIX,
   SNIPPETS_DIR,
   SYNC_SNAPSHOT_MESSAGE,
   TARGETS,
   TARGET_IDS,
-  THEMES_DIR,
-  addLocalPlugin,
-  addNpmPlugin,
+  addBuiltInStyleSet,
+  addExtension,
   adoptFolder,
-  applyTheme,
   assertExtensionContained,
   autoSnapshotDelayMs,
   autoSyncDelayMs,
@@ -42,40 +42,40 @@ import {
   connectPublishProvider,
   defaultConfigDir,
   deleteSnippet,
-  detectLegacyForkedTheme,
+  describeExtension,
   diagnoseProjectRemote,
   disconnectPublishCredential,
   escapeYamlScalar,
-  extensionEngineStyleList,
+  extensionCarries,
   extensionStyleList,
+  extensionStyleListWithDefault,
   extractUrlCredential,
   extractVariables,
   forgeKindForHost,
-  getActiveTheme,
-  getPreviousTheme,
   getSystemDiagnostics,
   hasProjectManifest,
+  importExtensionFromFile,
+  importExtensionFromUrl,
   importTemplateFromFolder,
-  importThemeFromFile,
-  importThemeFromFolder,
-  importThemeFromUrl,
+  isBundledExtension,
   isGitInternalPath,
+  isPathSpecifier,
   isSshRemoteUrl,
   knownForgeTokenUrl,
+  listBuiltInStyleSets,
   listBuiltInTemplates,
-  listBuiltInThemes,
   listCustomTemplates,
   listGitHubBranches,
   listGitHubRepositories,
   listMergedSnippets,
-  listProjectPlugins,
+  listProjectExtensions,
   listProjectStyles,
-  listProjectThemes,
   listPublishAccounts,
   listPublishProviders,
   listRepoBooks,
   listSnippets,
   loadManifestWithPath,
+  parseExtensionSpecifier,
   parseRemoteOrigin,
   pathEscapesFolder,
   pkceChallengeFromVerifier,
@@ -83,16 +83,16 @@ import {
   publishCredentialKey,
   publishProviderFor,
   publishTargetFor,
+  readExtensionCss,
   readExtensionMeta,
   readExtensionSnippet,
   readManifestFields,
   readPublishSettings,
   readSnippet,
-  readThemeCss,
-  removeProjectTheme,
+  removeExtension,
+  reorderExtensions,
   requireGoogleClientCredentials,
   resolveActiveStyles,
-  resolveBuiltInTheme,
   resolveConfig,
   resolveExtension,
   resolveExtensionPrefix,
@@ -101,18 +101,18 @@ import {
   resolveGoogleClientSecret,
   resolvePublishFormat,
   resolvePublishRequest,
-  revertTheme,
   revokeGoogleCredential,
   runBuild,
   runPublish,
+  sameExtension,
   sanitizeCloneFolderName,
   saveProjectAsTemplate,
   saveSnippet,
   scaffoldExtension,
   scaffoldProject,
   setActiveStyles,
+  setExtensionEnabled,
   setManifestFields,
-  setPluginEnabled,
   setPublishProviderConfig,
   slugifyProjectName,
   splitOutPath,
@@ -120,13 +120,13 @@ import {
   substituteVariables,
   syncProject,
   testRemoteAccess,
-  validateProjectPlugins
-} from "../index-dfw8hn8q.js";
+  validateProjectExtensions
+} from "../index-mey5vraz.js";
 import {
   BuildError,
   DEFAULT_PRINT_OPTS,
   readyProbeExpr
-} from "../index-9pbaznww.js";
+} from "../index-zwcv1njy.js";
 import {
   AUTO_SNAPSHOT_MESSAGE,
   HISTORY_PAGE_LIMIT,
@@ -145,7 +145,7 @@ import {
 } from "../index-v5mp7a6q.js";
 import"../index-37x76zdn.js";
 export {
-  validateProjectPlugins,
+  validateProjectExtensions,
   testRemoteAccess,
   syncProject,
   substituteVariables,
@@ -153,18 +153,18 @@ export {
   splitOutPath,
   slugifyProjectName,
   setPublishProviderConfig,
-  setPluginEnabled,
   setManifestFields,
+  setExtensionEnabled,
   setActiveStyles,
   scaffoldProject,
   scaffoldExtension,
   saveSnippet,
   saveProjectAsTemplate,
   sanitizeCloneFolderName,
+  sameExtension,
   runPublish,
   runBuild,
   revokeGoogleCredential,
-  revertTheme,
   restoreVersionWithBackup,
   resolvePublishRequest,
   resolvePublishFormat,
@@ -175,19 +175,19 @@ export {
   resolveExtensionPrefix,
   resolveExtension,
   resolveConfig,
-  resolveBuiltInTheme,
   resolveActiveStyles,
   requireGoogleClientCredentials,
   repoSubPath,
   repoRootForSource,
-  removeProjectTheme,
+  reorderExtensions,
+  removeExtension,
   readyProbeExpr,
-  readThemeCss,
   readSnippet,
   readPublishSettings,
   readManifestFields,
   readExtensionSnippet,
   readExtensionMeta,
+  readExtensionCss,
   publishTargetFor,
   publishProviderFor,
   publishCredentialKey,
@@ -196,43 +196,43 @@ export {
   pkceChallengeFromVerifier,
   pathEscapesFolder,
   parseRemoteOrigin,
+  parseExtensionSpecifier,
   loadManifestWithPath,
   listSnippets,
   listRepoBooks,
   listPublishProviders,
   listPublishAccounts,
-  listProjectThemes,
   listProjectStyles,
-  listProjectPlugins,
+  listProjectExtensions,
   listMergedSnippets,
   listGitHubRepositories,
   listGitHubBranches,
   listCustomTemplates,
-  listBuiltInThemes,
   listBuiltInTemplates,
+  listBuiltInStyleSets,
   knownForgeTokenUrl,
   isSshRemoteUrl,
+  isPathSpecifier,
   isNoChangesError,
   isGitInternalPath,
-  importThemeFromUrl,
-  importThemeFromFolder,
-  importThemeFromFile,
+  isBundledExtension,
   importTemplateFromFolder,
+  importExtensionFromUrl,
+  importExtensionFromFile,
   hasProjectManifest,
   getSystemDiagnostics,
-  getPreviousTheme,
-  getActiveTheme,
   forgeKindForHost,
   findEnclosingRepoDir,
   extractVariables,
   extractUrlCredential,
+  extensionStyleListWithDefault,
   extensionStyleList,
-  extensionEngineStyleList,
+  extensionCarries,
   escapeYamlScalar,
   disconnectPublishCredential,
   diagnoseProjectRemote,
   detectProjectSource,
-  detectLegacyForkedTheme,
+  describeExtension,
   deleteSnippet,
   defaultConfigDir,
   connectPublishProvider,
@@ -243,18 +243,16 @@ export {
   autoSyncDelayMs,
   autoSnapshotDelayMs,
   assertExtensionContained,
-  applyTheme,
   adoptFolder,
-  addNpmPlugin,
-  addLocalPlugin,
-  THEMES_DIR,
+  addExtension,
+  addBuiltInStyleSet,
   TARGET_IDS,
   TARGETS,
   SYNC_SNAPSHOT_MESSAGE,
   SNIPPETS_DIR,
   RESTORE_BACKUP_MESSAGE,
   RESERVED_PREFIX,
-  RECOMMENDED_PLUGINS,
+  RECOMMENDED_EXTENSIONS,
   PublishSelectionsStore,
   PRESET_IDS,
   PRESETS,
@@ -270,10 +268,12 @@ export {
   FileTokenStore,
   EXTENSION_MANIFEST_FILENAME,
   EXTENSION_KINDS,
+  EXTENSIONS_DIR,
   DEFAULT_PRINT_OPTS,
   BuildError,
-  BUILT_IN_THEME_IDS,
+  BUNDLED_EXTENSIONS,
   BUILT_IN_TEMPLATE_IDS,
+  BUILT_IN_STYLE_SET_IDS,
   AUTO_SYNC_PUSH_INTERVAL_MINUTES,
   AUTO_SYNC_MIN_MINUTES,
   AUTO_SYNC_MAX_MINUTES,

package/dist/{audit-m3ce9pvq.js → audit-fq7s1gsz.js}

@@ -1,15 +1,15 @@
 import {
   executeAndReport
-} from "./cli-1hx14cgk.js";
+} from "./cli-8pg731p5.js";
 import {
   log
-} from "./cli-vxf151ea.js";
+} from "./cli-ypfvnhag.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-vcv5ewqj.js";
-import"./cli-4vtgt2ng.js";
+} from "./cli-rh05byck.js";
+import"./cli-bx950tb4.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES

package/dist/{build-qnecb3a1.js → build-dyat3fqd.js}

@@ -1,19 +1,18 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-1hx14cgk.js";
+} from "./cli-8pg731p5.js";
 import {
   log
-} from "./cli-vxf151ea.js";
+} from "./cli-ypfvnhag.js";
 import {
   UsageError,
-  parseEngine,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-vcv5ewqj.js";
-import"./cli-4vtgt2ng.js";
+} from "./cli-rh05byck.js";
+import"./cli-bx950tb4.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError
@@ -37,8 +36,7 @@ var commandArgs = {
   "skip-lint": { type: "boolean", description: "Skip CSS linting (default: lint runs for pdf/pdfx)" },
   "skip-pre-validate": { type: "boolean", description: "Skip pre-build validation" },
   "skip-post-validate": { type: "boolean", description: "Skip post-build PDF/X validation" },
-  "allow-shrink": { type: "boolean", description: "Build anyway when content is wider than the page content box, instead of failing. Chromium then scales the WHOLE book down to fit; each offender is reported as a warning." },
-  engine: { type: "string", description: "Pagination engine. Native is the only engine. This flag is accepted but ignored (a warning fires for --engine paged)." }
+  "allow-shrink": { type: "boolean", description: "Build anyway when content is wider than the page content box, instead of failing. Chromium then scales the WHOLE book down to fit; each offender is reported as a warning." }
 };
 var build_default = defineCommand({
   meta: {
@@ -68,7 +66,6 @@ var build_default = defineCommand({
         skipPreValidate: !!args["skip-pre-validate"],
         skipPostValidate: !!args["skip-post-validate"],
         allowShrink: !!args["allow-shrink"],
-        engine: parseEngine(args.engine),
         rawArgs: args
       });
     } catch (error) {

package/dist/checks/source/dangling-links.d.ts

@@ -0,0 +1,18 @@
+import type { Check } from "../types";
+/**
+ * A relative link — `[text](docs/x.md)`, `[next](./02.md)`, even one to an
+ * image the build copies — cannot be opened from the printed book: a PDF has
+ * no files beside it, and every chapter is concatenated into one document at
+ * the staging root, so the browser resolved the href to the build machine's
+ * temp dir and baked that into the PDF (#263). The build now drops such an
+ * href before print (lib/build-staging.ts `dropRelativeLinkHrefs`); this
+ * check tells the author which links that affects, at the source line, so
+ * they can choose `#anchor`, an absolute URL, or plain text instead.
+ *
+ * `source.links.local-refs` answers a different question — does the target
+ * exist on disk — and a link can pass that while still being unopenable from
+ * a PDF, which is why this is its own check (and can be switched off for an
+ * HTML-only book via `validate.checks`).
+ */
+declare const check: Check;
+export default check;

package/dist/checks/source/index.d.ts

@@ -3,6 +3,7 @@ import "./htmlhint";
 import "./stylelint";
 import "./css-ownership";
 import "./local-refs";
+import "./dangling-links";
 import "./accessibility-alt-text";
 import "./accessibility-heading-order";
 import "./layout-markers";

package/dist/checks/source/local-ref-parser.d.ts

@@ -1,4 +1,5 @@
 import type { LoadedPlugin } from "../../lib/markdown/renderer";
+import type { CheckContext, CheckResult } from "../types";
 export type RenderedRefKind = "image" | "link";
 export interface RenderedLocalRef {
     ref: string;
@@ -26,3 +27,15 @@ export type RenderedLocalRefCollector = (content: string) => RenderedLocalRef[];
  * source files avoids loading/applying a project plugin once per chapter.
  */
 export declare function createRenderedLocalRefCollector(customPlugins?: LoadedPlugin[]): RenderedLocalRefCollector;
+/**
+ * Every rendered link/image of every source file, with the scaffolding the
+ * link checks share: the book's plugins loaded degrade-and-report (a plugin
+ * that will not load is pushed to `results` as an inspection failure and the
+ * rest is still checked — the loader's path-module cache avoids repeating
+ * module-level plugin side effects when another check or the build already
+ * loaded the same unchanged plugin), one parser reused for every chapter, and
+ * a file that cannot be read or parsed reported rather than thrown.
+ */
+export declare function renderedLocalRefs(ctx: CheckContext, checkId: string, results: CheckResult[]): AsyncGenerator<RenderedLocalRef & {
+    file: string;
+}>;