gutterpress 0.9.0-alpha.2 → 0.10.0-alpha.3

package/README.md

@@ -69,7 +69,7 @@ uses its bundled browser for standard PDF export.
 # Build a PDF from a project directory
   gutterpress build ./my-book
 
-# Live preview server (Paged.js + websocket-driven full-reload on file change)
+# Live native-engine preview (automatic updates over WebSocket)
   gutterpress preview ./my-book
 
 # Custom output path
@@ -163,7 +163,13 @@ gutterpress new <name> --preset <id> [options]
 
 ### `gutterpress preview`
 
-Live HTML preview server by default (serves `book.html`, triggers full-reload via WebSocket on file change — pure JS rendering, no external tools). Pass `--format pdf` or `--format pdfx` for a one-shot build-and-open instead of the live server. `--manifest` applies only to those one-shot PDF/PDF-X modes; live HTML preview discovers the project manifest from its input directory.
+Live HTML preview server by default. A single Markdown edit is rendered and
+spliced as one chapter over WebSocket; CSS, manifest, multi-file, deletion, and
+other structural changes reload the full document. This path is pure JS and
+needs no external tools. Pass `--format pdf` or `--format pdfx` for a one-shot
+build-and-open instead. `--manifest` applies only to those one-shot PDF/PDF-X
+modes; live HTML preview discovers the project manifest from its input
+directory.
 
 ```sh
 gutterpress preview [input-dir] [options]
@@ -184,6 +190,7 @@ gutterpress preview [input-dir] [options]
   --skip-lint             Skip CSS linting                              (pdf|pdfx only)
   --skip-pre-validate     Skip pre-build validation                     (pdf|pdfx only)
   --skip-post-validate    Skip post-build PDF/X validation              (pdfx only)
+  --engine <name>         native (default) | paged (deprecated)   [overrides the manifest's engine: field; applies to the live preview AND --format pdf|pdfx]
 ```
 
 ### `gutterpress build`
@@ -203,6 +210,7 @@ gutterpress build [input-dir] [options]
   --skip-lint             Skip the CSS print-safety pass (default: lint runs for pdf/pdfx)
   --skip-pre-validate     Skip pre-build validation
   --skip-post-validate    Skip post-build PDF/X validation
+  --engine <name>         native (default) | paged (deprecated)   [overrides the manifest's engine: field; native = the Gutterpress engine, native Chromium pagination]
 ```
 
 ### `gutterpress publish`
@@ -236,7 +244,9 @@ gutterpress publish --provider itch ./my-book
 
 ### `gutterpress lint`
 
-Run Gutterpress's print-safety CSS checks (postcss-based: remote URLs, rasterizing effects, Paged.js crash-prone selectors) against the project's CSS files.
+Run Gutterpress's PostCSS-based print-safety checks, including remote URLs,
+rasterizing effects, and source-level page-containment risks, against the
+project's CSS files.
 
 ```sh
 gutterpress lint [files] [options]
@@ -246,7 +256,11 @@ gutterpress lint [files] [options]
 
 `files` is a positional: either a project directory containing `manifest.yaml` (its configured stylesheets are linted), or a glob pattern for CSS files to lint directly. There is no `--files` flag — pass the directory/glob as the positional.
 
-Common print-unsafe patterns the plugin flags: remote `url(...)` references in CSS, paged.js-crashing `:is()`-with-sibling selectors, properties with no print equivalent.
+Common findings include remote `url(...)` references, effects that rasterize
+print text, and declarations on core page wrappers that could clip or trap
+out-of-flow art. The source-level containment check is an early signal; the
+build-time `engine.layer.trapped` diagnostic inspects the authoritative live
+ancestor chain.
 
 ### `gutterpress validate`
 

package/dist/api/index.d.ts

@@ -10,7 +10,8 @@
  *   const { url, stop } = await startPreviewServer({ input: "./book", installSignalHandlers: false });
  *   await runBuild({ inputDir: "./book", format: "pdf", outDir: "./out", rawArgs: {} });
  */
-export { runBuild, splitOutPath, BuildError, type BuildFormat, type PdfxFlavor, type BuildRunnerOptions, type BuildRunnerResult, type SplitOutPath, type PdfRenderer, type PdfRenderInput, } from "../lib/build-runner";
+export { runBuild, splitOutPath, BuildError, type BuildFormat, type PdfxFlavor, type BuildRunnerOptions, type BuildRunnerResult, type SplitOutPath, type EngineBrowser, type EngineSession, } from "../lib/build-runner";
+export { DEFAULT_PRINT_OPTS, readyProbeExpr } from "../engine/shared/cdp";
 export { startPreviewServer, type PreviewServerHandle, type StartPreviewServerOptions, } from "../server";
 export type { PreviewServerOptions } from "../types";
 export { loadManifestWithPath, resolveConfig, MANIFEST_FILENAMES, hasProjectManifest, } from "../lib/manifest";
@@ -60,8 +61,9 @@ export { GenericTokenAuthProvider, connectGenericHost, knownForgeTokenUrl, norma
 export type { GenericTokenConnectInput, GenericHostCallbacks, GenericAuthOptions, } from "../lib/remote-auth/generic-auth.ts";
 export { diagnoseProjectRemote, parseRemoteOrigin, forgeKindForHost, } from "../lib/remote-auth/diagnose.ts";
 export type { ProjectRemoteDiagnosis, DiagnoseProjectRemoteOptions, RemoteProtocol, RemoteGuidanceId, ForgeKind, } from "../lib/remote-auth/diagnose.ts";
-export { syncProject, pullChanges, pushChanges, resolveConflicts, onlineCopyPath, SYNC_SNAPSHOT_MESSAGE, } from "../lib/remote-auth/sync.ts";
-export type { SyncOutcome, PullOutcome, PushOutcome, SyncProjectOptions, ResolveConflictsOptions, ConflictFile, ConflictKind, ConflictResolution, } from "../lib/remote-auth/sync.ts";
+export { syncProject, pullChanges, pushChanges, SYNC_SNAPSHOT_MESSAGE, } from "../lib/remote-auth/sync.ts";
+export type { SyncOutcome, PullOutcome, PushOutcome, SyncProjectOptions, ImageClash, } from "../lib/remote-auth/sync.ts";
+export { keepImageVersion, readImageVersion } from "../lib/remote-auth/image-clash.ts";
 export type { SnapshotEntry, InitVersionHistoryOptions, SnapshotOptions, RestoreSnapshotOptions, RestoreVersionOptions, RestoreVersionResult, SourceProvider, } from "../lib/source-provider.ts";
 export { runPublish, resolvePublishRequest, } from "../lib/publish/run-publish.ts";
 export type { RunPublishOptions, RunPublishResult, } from "../lib/publish/run-publish.ts";
@@ -74,7 +76,11 @@ 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 { recover, classifyGitError, classifyFromHealth, inspectRepo, buildRecoveryContext, preflightStructuralReason, buildPreflightDiagnostics, verifyRepoReadable, isUnbornRepo, RepoNeedsRecoveryError, isRepoNeedsRecoveryError, } from "../lib/remote-auth/recovery/dispatch.ts";
+export { repairRepo } from "../lib/remote-auth/recovery/repair.ts";
+export type { RepairOptions, RepairResult } from "../lib/remote-auth/recovery/repair.ts";
+export { classifyFromHealth, isLikelyRepoCorruption, RepoNeedsRecoveryError, isRepoNeedsRecoveryError, STALE_LOCK_MIN_AGE_MS, } from "../lib/remote-auth/recovery/classify.ts";
+export type { RepairNeed } from "../lib/remote-auth/recovery/classify.ts";
+export { inspectRepo, preflightStructuralReason, buildPreflightDiagnostics, verifyRepoReadable, isUnbornRepo, } from "../lib/remote-auth/recovery/inspect.ts";
+export type { RepoHealth } from "../lib/remote-auth/recovery/types.ts";
 export { resolveLogger, shortOid } from "../lib/remote-auth/operation-log.ts";
 export type { OperationLogger, LogData } from "../lib/remote-auth/operation-log.ts";
-export type { RecoverFn, RecoveryContext, RecoveryResult, SyncErrorKind, RecoveryRisk, ManualGuidance, RepoHealth, RecoveryBackup, RepairConfirmation, ConfirmationGate, FaultInjector, FaultPoint, } from "../lib/remote-auth/recovery/dispatch.ts";

package/dist/api/index.js

@@ -8,7 +8,6 @@ import {
   AUTO_SYNC_MIN_MINUTES,
   BUILT_IN_TEMPLATE_IDS,
   BUILT_IN_THEME_IDS,
-  BuildError,
   FileTokenStore,
   GITHUB_HOST,
   GenericTokenAuthProvider,
@@ -21,6 +20,7 @@ import {
   RECOMMENDED_PLUGINS,
   RepoNeedsRecoveryError,
   SNIPPETS_DIR,
+  STALE_LOCK_MIN_AGE_MS,
   SYNC_SNAPSHOT_MESSAGE,
   TARGETS,
   TARGET_IDS,
@@ -33,9 +33,7 @@ import {
   autoSnapshotDelayMs,
   autoSyncDelayMs,
   buildPreflightDiagnostics,
-  buildRecoveryContext,
   classifyFromHealth,
-  classifyGitError,
   cloneRepository,
   connectGenericHost,
   connectPublishProvider,
@@ -58,9 +56,11 @@ import {
   inspectRepo,
   isAppHeartbeatFresh,
   isGitInternalPath,
+  isLikelyRepoCorruption,
   isRepoNeedsRecoveryError,
   isSshRemoteUrl,
   isUnbornRepo,
+  keepImageVersion,
   knownForgeTokenUrl,
   listBuiltInTemplates,
   listBuiltInThemes,
@@ -77,7 +77,6 @@ import {
   loadManifestWithPath,
   migrateUrlCredential,
   normalizeForgeHost,
-  onlineCopyPath,
   parseRemoteOrigin,
   preflightStructuralReason,
   provenancePath,
@@ -88,19 +87,19 @@ import {
   pullChanges,
   pushChanges,
   readAppHeartbeat,
+  readImageVersion,
   readManifestFields,
   readProjectProvenance,
   readPublishSettings,
   readSnippet,
   readThemeCss,
-  recover,
   redactCredential,
   removeAppHeartbeat,
   removeProjectTheme,
+  repairRepo,
   resolveActiveStyles,
   resolveBuiltInTheme,
   resolveConfig,
-  resolveConflicts,
   resolveGitHubClientId,
   resolvePublishRequest,
   revertTheme,
@@ -123,7 +122,12 @@ import {
   validateProjectPlugins,
   verifyRepoReadable,
   writeAppHeartbeat
-} from "../index-bynn850m.js";
+} from "../index-s416qpdv.js";
+import {
+  BuildError,
+  DEFAULT_PRINT_OPTS,
+  readyProbeExpr
+} from "../index-mvehxh0e.js";
 import {
   AUTO_SNAPSHOT_MESSAGE,
   HISTORY_PAGE_LIMIT,
@@ -133,15 +137,14 @@ import {
   resolveLogger,
   restoreVersionWithBackup,
   shortOid
-} from "../index-yzrh708h.js";
+} from "../index-mdefp0y5.js";
 import {
   capabilitiesFor,
   detectProjectSource,
   findEnclosingRepoDir,
   repoRootForSource,
   repoSubPath
-} from "../index-wchtvxvw.js";
-import"../index-yja077f6.js";
+} from "../index-v5mp7a6q.js";
 import"../index-37x76zdn.js";
 export {
   writeAppHeartbeat,
@@ -169,21 +172,22 @@ export {
   resolvePublishRequest,
   resolveLogger,
   resolveGitHubClientId,
-  resolveConflicts,
   resolveConfig,
   resolveBuiltInTheme,
   resolveActiveStyles,
   repoSubPath,
   repoRootForSource,
+  repairRepo,
   removeProjectTheme,
   removeAppHeartbeat,
   redactCredential,
-  recover,
+  readyProbeExpr,
   readThemeCss,
   readSnippet,
   readPublishSettings,
   readProjectProvenance,
   readManifestFields,
+  readImageVersion,
   readAppHeartbeat,
   pushChanges,
   pullChanges,
@@ -195,7 +199,6 @@ export {
   provenancePath,
   preflightStructuralReason,
   parseRemoteOrigin,
-  onlineCopyPath,
   normalizeForgeHost,
   migrateUrlCredential,
   loadManifestWithPath,
@@ -212,10 +215,12 @@ export {
   listBuiltInThemes,
   listBuiltInTemplates,
   knownForgeTokenUrl,
+  keepImageVersion,
   isUnbornRepo,
   isSshRemoteUrl,
   isRepoNeedsRecoveryError,
   isNoChangesError,
+  isLikelyRepoCorruption,
   isGitInternalPath,
   isAppHeartbeatFresh,
   inspectRepo,
@@ -240,10 +245,8 @@ export {
   connectPublishProvider,
   connectGenericHost,
   cloneRepository,
-  classifyGitError,
   classifyFromHealth,
   capabilitiesFor,
-  buildRecoveryContext,
   buildPreflightDiagnostics,
   autoSyncDelayMs,
   autoSnapshotDelayMs,
@@ -256,6 +259,7 @@ export {
   TARGET_IDS,
   TARGETS,
   SYNC_SNAPSHOT_MESSAGE,
+  STALE_LOCK_MIN_AGE_MS,
   SNIPPETS_DIR,
   RepoNeedsRecoveryError,
   RESTORE_BACKUP_MESSAGE,
@@ -270,6 +274,7 @@ export {
   GenericTokenAuthProvider,
   GITHUB_HOST,
   FileTokenStore,
+  DEFAULT_PRINT_OPTS,
   BuildError,
   BUILT_IN_THEME_IDS,
   BUILT_IN_TEMPLATE_IDS,

package/dist/assets/preview/scripts/preview-bridge.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/assets/preview/scripts/preview-interface.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/{audit-nhn2pjz3.js → audit-xxegv0t0.js}

@@ -1,18 +1,21 @@
 import {
   executeAndReport
-} from "./cli-k4bd06sd.js";
+} from "./cli-5czby0dd.js";
 import {
   log
-} from "./cli-najycadg.js";
+} from "./cli-gk3wsdpb.js";
 import {
-  EXIT_CODES,
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-e5zhb0xs.js";
-import"./cli-yzrh708h.js";
-import"./cli-wchtvxvw.js";
-import"./cli-yja077f6.js";
+} from "./cli-f4rcbt2t.js";
+import"./cli-yp3p0sf2.js";
+import"./cli-c41yr7he.js";
+import {
+  EXIT_CODES
+} from "./cli-46ycxe6r.js";
+import"./cli-k1065rkg.js";
+import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 
 // src/commands/audit.ts

package/dist/{build-san7fv2z.js → build-w0vb6mgq.js}

@@ -1,21 +1,25 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-k4bd06sd.js";
+} from "./cli-5czby0dd.js";
 import {
   log
-} from "./cli-najycadg.js";
+} from "./cli-gk3wsdpb.js";
 import {
-  BuildError,
   UsageError,
+  parseEngine,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-e5zhb0xs.js";
-import"./cli-yzrh708h.js";
-import"./cli-wchtvxvw.js";
-import"./cli-yja077f6.js";
+} from "./cli-f4rcbt2t.js";
+import"./cli-yp3p0sf2.js";
+import"./cli-c41yr7he.js";
+import {
+  BuildError
+} from "./cli-46ycxe6r.js";
+import"./cli-k1065rkg.js";
+import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 
 // src/commands/build.ts
@@ -32,7 +36,8 @@ var commandArgs = {
   "strip-annotations": { type: "boolean", description: "Strip PDF annotations for PDF/X compliance" },
   "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" }
+  "skip-post-validate": { type: "boolean", description: "Skip post-build PDF/X validation" },
+  engine: { type: "string", description: "Pagination engine. Paged.js has been removed; native is the only engine. This flag is accepted but ignored (a warning fires for --engine paged)." }
 };
 var build_default = defineCommand({
   meta: {
@@ -61,6 +66,7 @@ var build_default = defineCommand({
         skipLint: !!args["skip-lint"],
         skipPreValidate: !!args["skip-pre-validate"],
         skipPostValidate: !!args["skip-post-validate"],
+        engine: parseEngine(args.engine),
         rawArgs: args
       });
     } catch (error) {

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

@@ -4,3 +4,4 @@ import "./stylelint";
 import "./local-refs";
 import "./accessibility-alt-text";
 import "./accessibility-heading-order";
+import "./layout-markers";

package/dist/checks/source/layout-markers.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

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

@@ -0,0 +1,28 @@
+import type { LoadedPlugin } from "../../lib/markdown/renderer";
+export type RenderedRefKind = "image" | "link";
+export interface RenderedLocalRef {
+    ref: string;
+    kind: RenderedRefKind;
+    /** One-based source line of the rendered link/image occurrence. */
+    line: number;
+}
+/**
+ * Extract only links and images the shipped Gutterpress grammar actually
+ * renders, with their original source lines.
+ *
+ * Complexity is O(source + tokens + refs × log(lines-per-inline)). Keeping
+ * correlation local to each parser-defined block is important because it
+ * prevents an unmatched delimiter/comment/tag from pairing across a
+ * blank/block boundary.
+ * Markdown-it normalizes CRLF and lone CR to LF before building token maps, so
+ * line counts remain exact for all three newline spellings.
+ */
+export type RenderedLocalRefCollector = (content: string) => RenderedLocalRef[];
+/**
+ * Build one parser-aligned collector for a validation run.
+ *
+ * Custom plugins are applied exactly as they are for the book renderer before
+ * the inline State is instrumented. Reusing the returned closure across all
+ * source files avoids loading/applying a project plugin once per chapter.
+ */
+export declare function createRenderedLocalRefCollector(customPlugins?: LoadedPlugin[]): RenderedLocalRefCollector;

package/dist/cli-46ycxe6r.js

@@ -0,0 +1,18 @@
+// src/lib/build-error.ts
+var EXIT_CODES = {
+  OK: 0,
+  FINDINGS: 1,
+  USAGE: 2,
+  PIPELINE: 3
+};
+
+class BuildError extends Error {
+  exitCode;
+  constructor(message, exitCode = EXIT_CODES.PIPELINE, options) {
+    super(message, options);
+    this.name = "BuildError";
+    this.exitCode = exitCode;
+  }
+}
+
+export { EXIT_CODES, BuildError };