gutterpress 0.11.11-alpha.1 → 0.11.11-alpha.2

package/dist/preview/lifecycle.d.ts

@@ -9,9 +9,8 @@ import type { ServerState } from './server-context';
 /**
  * Initialize the preview's temp directory.
  *
- * SERVE-IN-PLACE (this replaces the old whole-tree `copyDirectory(inputPath,
- * tempDir)` + manifest-asset `copyAssets` call): the temp dir is no longer a
- * mirror of the project. It holds ONLY files gutterpress itself generates — right
+ * SERVE-IN-PLACE: the temp dir is not a mirror of the project. It holds ONLY
+ * files gutterpress itself generates — right
  * now that's `book.html` (written later by {@link generateAndWriteHtml}) and
  * the PID marker file below. Every other path the served HTML asks for
  * (images, anything else under the project) is read straight from the
@@ -23,12 +22,8 @@ import type { ServerState } from './server-context';
  * so there is no separate copy step that can drift from what a build actually
  * ships (the "works in preview, broken in the PDF" bug class). It also means
  * a project's `.env`, `.git`, or any other dotfile is never duplicated into a
- * world-readable temp dir the way the old whole-tree copy did — see
- * http-server.ts's dotfile guard, which is what stands between a request and
- * the project's real dotfiles now that the project is served directly.
- *
- * No longer takes `inputPath`/`config` — both were needed only for the copy
- * steps removed above, and there is nothing left to configure here.
+ * world-readable temp dir — see http-server.ts's dotfile guard, which is what
+ * stands between a request and the project's real dotfiles.
  */
 export declare function initializePreviewDirectories(): Promise<string>;
 /**
@@ -46,14 +41,11 @@ export declare function initializeConfiguration(inputPath: string): Promise<Reso
 /**
  * Restart the preview server with a new input directory.
  *
- * SERVE-IN-PLACE makes this trivially correct where the old copy-based
- * version was not: the HTTP server (http-server.ts) reads `state.
- * currentInputPath` fresh on every request instead of serving a stale mirror,
- * so repointing that one field IS the switch — there is no per-project copy
- * to redo, and therefore no old project's files left behind in the (now
- * shared-nothing, generated-files-only) temp dir the way the previous
- * `copyDirectory(newInputPath, state.tempDir)` could leave a stale mix of two
- * projects' content if it partially failed.
+ * SERVE-IN-PLACE makes this trivially correct: the HTTP server
+ * (http-server.ts) reads `state.currentInputPath` fresh on every request
+ * instead of serving a mirror, so repointing that one field IS the switch —
+ * there is no per-project copy to redo, and no old project's files left
+ * behind in the generated-files-only temp dir.
  */
 export declare function restartPreview(newInputPath: string, state: ServerState): Promise<void>;
 /**

package/dist/{preview-bridge-b4jbtb79.js → preview-bridge-8jhd1wpb.js}

@@ -67,7 +67,7 @@
   window.addEventListener('renderingComplete', function (e) {
     post({ type: 'gutterpress:event', name: 'renderingComplete', detail: e.detail });
   });
-  // ADR 0005: source-position sync + click-to-source.
+  // source-position sync + click-to-source.
   window.addEventListener('sourceLineChanged', function (e) {
     post({ type: 'gutterpress:event', name: 'sourceLineChanged', detail: e.detail });
   });

package/dist/{preview-interface-x22vcqyw.js → preview-interface-twd6nsf5.js}

@@ -104,7 +104,7 @@
     return (mode || currentViewMode) === 'single' ? 1 : 2;
   }
 
-  // ── Source-mapping helpers (ADR 0005) ──────────────────────────────────────
+  // ── Source-mapping helpers ──────────────────────────────────────
   // Every block element carries data-source-line (markdown-it-source-map). These
   // map rendered DOM <-> markdown source line and rendered DOM <-> page. The
   // native fragmenter MOVES elements into strips, it does not clone them, so
@@ -362,7 +362,7 @@
   // plate UNDER the page's own text (gutterpress-css.ts's depth ladder) —
   // hit-tests beneath the covering paragraph boxes and the annotated
   // `.page`/`.section` containers too, so document.elementFromPoint() can
-  // NEVER return it. Every right-click used to resolve the covering element
+  // NEVER return it: a right-click would resolve the covering element
   // instead, leaving the image's context menu unreachable at EVERY point.
   // Probe the full hit stack for the first (= top-most in paint order, so
   // the upper of two overlapping plates wins) image layered at negative z.
@@ -634,13 +634,11 @@
   // swapped for that block's markdown source under
   // `contenteditable="plaintext-only"`, so the caret sits in the real page, in
   // the book's own typography, and Chromium's fragmenter re-flows the pages
-  // around it as the author types. This replaced a floating CodeMirror panel
-  // positioned in host-SPA coordinates; `getRectsFor()`/`setEditMask()` existed
-  // ONLY to serve that panel and went with it (protocol v8).
+  // around it as the author types.
   //
   // Three properties of the native viewer are what make this work, each
-  // spike-verified rather than assumed (plan §2) — the floating panel existed
-  // because none of them can be assumed of a paginator that pre-cuts the DOM:
+  // verified rather than assumed (plan §2) — none of them can be assumed of
+  // a paginator that pre-cuts the DOM:
   //   1. A block spanning a page break is ONE element with several client
   //      rects, so it takes ONE contenteditable and the caret crosses the
   //      break natively (ArrowDown walks into the next page).
@@ -1066,7 +1064,7 @@
       return api.notifyPageChange();
     },
 
-    // ── ADR 0005 generic primitives ─────────────────────────────────────────
+    // ── Generic primitives ─────────────────────────────────────────
     // Bumped whenever a command/event is added so a hot-updated SPA can
     // feature-detect against an older bundled lib.
     // v6 (WORK PACKAGE B item 2): getRectsFor()/setEditMask() dropped the
@@ -1362,7 +1360,7 @@
 
   // Click-to-source: emit elementActivated when the user clicks a source-mapped
   // block. Never preventDefault (links/selection keep working); the host decides
-  // whether to act. (ADR 0005)
+  // whether to act.
   if (typeof document.addEventListener === 'function') {
     document.addEventListener('click', function (e) {
       var el = e.target && e.target.closest ? e.target.closest('[data-source-line]') : null;
@@ -1474,7 +1472,7 @@
       currentPage = page;
       if (!silent) api.notifyPageChange();
     }
-    // Emit finer-grained source position for editor sync (ADR 0005).
+    // Emit finer-grained source position for editor sync.
     var pos = visibleSourcePosition();
     var sl = pos ? pos.line : null;
     var chapter = pos ? chapterOf(pos.el) : null;

package/dist/{preview-shell-tqndvhbx.js → preview-shell-y8yrm3f0.js}

@@ -288,27 +288,16 @@
     armPendingSwap();
   }
 
-  // Incremental chapter splice used to live here (spliceChapter): it grafted
-  // a freshly-paginated replacement into a chapter's live page range. It was
-  // tried and removed (2026-08-08 review), and the standing reason is
-  // PERFORMANCE, not soundness: measured end-to-end (file write -> change
-  // visible, 5 samples, 34pp field guide) the plain full reload (`swap`,
-  // below) is 509ms avg vs the incremental splice's 998ms avg. The server
-  // now sends ONE update kind, `full-reload`, and every one goes straight to
-  // `swap()`; the `/__chapter` route and `content-update` message that fed
-  // the splice were deleted with it.
+  // The server sends ONE update kind, `full-reload`, and every one goes
+  // straight to `swap()` (below). An incremental chapter splice was measured
+  // SLOWER, not unsound: end-to-end (file write -> change visible, 5 samples,
+  // 34pp field guide) the full reload is 509ms avg vs the splice's 998ms avg.
   //
-  // CORRECTED 2026-08-24: the 2026-08-08 review ALSO recorded a soundness
-  // objection — that `refresh()` -> `relayout()` "only re-measures the
-  // EXISTING strips", silently dropping any page context the edit
-  // introduces. That is false against the current `fragment.ts`, whose
-  // `relayout()` unwraps the strips and re-runs `buildStrips()` from
-  // scratch before re-measuring, precisely so a mutation that adds or
-  // removes a page-context run is seen. Do not cite the old objection as a
-  // reason a DOM mutation cannot be re-paginated — it can, and the inline
+  // A DOM mutation CAN be re-paginated: `refresh()` -> `relayout()` unwraps
+  // the strips and re-runs `buildStrips()` from scratch before re-measuring,
+  // so a mutation that adds or removes a page-context run is seen. The inline
   // editing work depends on it (docs/inline-editing-plan.md, ADR 0009
-  // decision 4 as revised). The perf comparison above still stands on its
-  // own for the full-document reload path.
+  // decision 4).
 
   function markActiveReady() {
     onReady(active, function () {

package/dist/{preview-6n5ava6c.js → preview-y39jrpbs.js}

@@ -6,10 +6,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-g3xd0x9z.js";
+} from "./cli-d2he8zph.js";
 import {
   log
-} from "./cli-kgd355eh.js";
+} from "./cli-1kdtzgxm.js";
 import {
   UsageError,
   parseFormat,
@@ -17,8 +17,8 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-wtw5nfsx.js";
-import"./cli-p40641zw.js";
+} from "./cli-ny50k8md.js";
+import"./cli-tjhn2mdn.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{publish-9an2a1ma.js → publish-tvj3xh8m.js}

@@ -11,17 +11,17 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-g3xd0x9z.js";
+} from "./cli-d2he8zph.js";
 import {
   FileTokenStore,
   log
-} from "./cli-kgd355eh.js";
+} from "./cli-1kdtzgxm.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-wtw5nfsx.js";
-import"./cli-p40641zw.js";
+} from "./cli-ny50k8md.js";
+import"./cli-tjhn2mdn.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/render.d.ts

@@ -1,13 +1,13 @@
 /**
  * gutterpress/render — the PURE, node-free render core.
  *
- * §1/§8 / ADR 0004: this entry deliberately exposes ONLY the browser-safe
+ * §1/§8: this entry deliberately exposes ONLY the browser-safe
  * markdown→HTML→book.html pieces. It transitively imports markdown-it + its
  * plugins, Gutterpress's inlined marker parser (`markers.js`), and pure helpers
- * — and NOTHING from `node:*`/`fs`/`path`/`url`. This is what the desktop's WebAdapter imports
- * (a *value* import that stays PWA-clean), so the in-browser live preview (#33)
- * can render the opened project entirely client-side with no localhost server
- * and no headless Chromium.
+ * — and NOTHING from `node:*`/`fs`/`path`/`url`. It has no browser consumer
+ * today; it is kept node-free (scripts/check-render-pure.mjs) because any
+ * future browser build of the app needs to render a book client-side, and that
+ * discipline is far harder to restore than to keep.
  *
  * The CLI build path keeps using `renderChapters` / `renderChaptersToFile` from
  * `./lib/markdown/index.ts` (the node wrapper around this same core).

package/dist/render.js

@@ -894,8 +894,8 @@ var GUTTERPRESS_CSS = `
 
 /* the per-shape decisions the paragraph above deliberately leaves to the
    author, named instead of left as raw CSS every book was reinventing
-   (2026-09-01 CSS architecture review, findings C1/C7 — CLAUDE.md §0:
-   "behavior broadly useful to non-technical authors belongs in core").
+   (CLAUDE.md §0: "behavior broadly useful to non-technical authors belongs
+   in core").
    Permanent vocabulary, standard properties verbatim — same rationale as
    the column/grid runs above. One name each, no aliases:
      .gp-columns-all       column-span: all      a heading or block that

package/dist/schema/manifest.types.d.ts

@@ -206,11 +206,11 @@ export interface ResolvedExtensionConfig {
 }
 /**
  * Fully-resolved config. Every field is a concrete default with one
- * deliberate exception: `styles` (ARCH finding #2). There is no preset
+ * deliberate exception: `styles`. There is no preset
  * default for it — `undefined` means "the manifest didn't set one", and
  * `resolveActiveStyles` (style-resolver.ts) is the single source of truth for
  * what that resolves to (styles/book.css, else the first discovered `.css`,
- * else `[]`). Baking a preset default in here defeated that fallback chain.
+ * else `[]`). Baking a preset default in here would defeat that fallback chain.
  */
 export interface ResolvedConfig {
     title: string;

package/dist/utils/logger.d.ts

@@ -10,8 +10,7 @@
  *   - The `log` facade object (`log.info`/`log.warn`/`log.error`/`log.success`)
  *     — clean, prefix-styled command output used by the CLI commands and
  *     re-exported from `index.ts` for the desktop. Always emitted (it carries
- *     user-facing command results, not diagnostic chatter), preserving the
- *     historical `lib/logger` behavior verbatim.
+ *     user-facing command results, not diagnostic chatter).
  */
 export type LogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
 /**

package/dist/{validate-0rrjva48.js → validate-9enr4ecc.js}

@@ -1,15 +1,15 @@
 import {
   executeAndReport
-} from "./cli-g3xd0x9z.js";
+} from "./cli-d2he8zph.js";
 import {
   log
-} from "./cli-kgd355eh.js";
+} from "./cli-1kdtzgxm.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-wtw5nfsx.js";
-import"./cli-p40641zw.js";
+} from "./cli-ny50k8md.js";
+import"./cli-tjhn2mdn.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.11.11-alpha.1",
+  "version": "0.11.11-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",