gutterpress 0.11.17-alpha.2 → 0.11.17-alpha.3

package/dist/index.js

@@ -71,6 +71,7 @@ import {
   isGitInternalPath,
   isPathSpecifier,
   isSshRemoteUrl,
+  isValidRepositoryName,
   knownForgeTokenUrl,
   listBuiltInStyleSets,
   listBuiltInTemplates,
@@ -102,6 +103,7 @@ import {
   readExtensionCss,
   readExtensionMeta,
   readManifestFields,
+  readPageSetup,
   readPublishSettings,
   refreshRemoteCopies,
   removeExtension,
@@ -139,7 +141,9 @@ import {
   setActiveStyles,
   setExtensionEnabled,
   setManifestFields,
+  setPageSetup,
   setPublishProviderConfig,
+  setUpOnlineBackup,
   slugifyProjectName,
   splitOutPath,
   startPreviewServer,
@@ -148,13 +152,13 @@ import {
   testRemoteAccess,
   updateExtensions,
   validateProjectExtensions
-} from "./index-c275p061.js";
+} from "./index-bscfmg5r.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-5dcj1vts.js";
+} from "./index-hrx0gfkj.js";
 import {
   BuildError
-} from "./index-eyaj6nkc.js";
+} from "./index-q1xqxrh9.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,
@@ -194,7 +198,9 @@ export {
   startPreviewServer,
   splitOutPath,
   slugifyProjectName,
+  setUpOnlineBackup,
   setPublishProviderConfig,
+  setPageSetup,
   setManifestFields,
   setExtensionEnabled,
   setActiveStyles,
@@ -237,6 +243,7 @@ export {
   refreshRemoteCopies,
   readyProbeExpr,
   readPublishSettings,
+  readPageSetup,
   readManifestFields,
   readExtensionMeta,
   readExtensionCss,
@@ -270,6 +277,7 @@ export {
   listBuiltInTemplates,
   listBuiltInStyleSets,
   knownForgeTokenUrl,
+  isValidRepositoryName,
   isSshRemoteUrl,
   isPathSpecifier,
   isNoChangesError,

package/dist/lib/black-text-gray.d.ts

@@ -1,5 +1,5 @@
 /**
- * K-only black text for PDF/X (#331).
+ * K-only black text for PDF/X (#331, #336).
  *
  * PRINT-SPEC GAP: print vendors (DriveThruRPG) require body text to print on
  * the black plate alone (100% K). Chromium writes every text fill as
@@ -21,18 +21,48 @@
  * scoped to `BT`…`ET`: on entering a text object whose inherited fill/stroke
  * is near-black RGB we emit `0 g`/`0 G`, and at `ET` we put the original RGB
  * back. A near-black `rg`/`RG` set inside the block is rewritten the same way.
- * Page content streams and Form XObjects are both processed; a Form's
- * inherited (pre-`Do`) colour is unknowable from its own stream, so only
- * colours set inside the form are considered.
+ * Page content streams and Form XObjects are both processed.
  *
- * Known limit: text-decoration rectangles (underline/strike) are `re f` after
- * `ET`, i.e. non-text painting, and stay rich black.
+ * Size threshold (#336): DriveThruRPG recommends rich black for text LARGER
+ * than 24pt, so only text at or below {@link LARGE_TEXT_PT} is rewritten. The
+ * effective size is `Tf` size × the text matrix's scale (`Tm`) × the CTM's
+ * scale (`cm`, restored by `q`/`Q`) — each reduced to √|det| of its 2×2, so
+ * rotation and flips do not matter and anisotropic scaling is averaged.
+ * `Tz`/`Ts` are ignored. A Form XObject's stream cannot know the CTM it is
+ * drawn under, so the page pass records the CTM at each `Do` and the form is
+ * sized from that (the smallest, if drawn more than once — K-only large text
+ * is harmless, rich small text is not). A form reached any other way (nested
+ * in another form, unreferenced) has unknown scale and is treated as small.
+ * A `Tf` inside a text object re-evaluates, so one `BT` can switch between
+ * K-only and rich as the size crosses the threshold.
+ *
+ * Underline / strike-through (#336): Chromium (tagged PDF, which the engine
+ * always requests) wraps each text run and its decoration in one marked-content
+ * span (`/NonStruct <</MCID n>> BDC … EMC`) and paints the decoration as a thin
+ * `x y w h re f` outside `BT…ET`. A near-black such rect, thinner than a fifth
+ * of the span's small text, is wrapped `q 0 g … Q` so it prints K-only like the
+ * text it decorates. A rect outside any span, or in a span with no small text
+ * (rules, borders, large headings), is left alone — nothing is guessed.
+ */
+/**
+ * DriveThruRPG: black text LARGER than this (in points) may be rich black;
+ * at or below it, it must be K-only.
  */
+export declare const LARGE_TEXT_PT = 24;
+/** What a stream's caller knows that the stream itself cannot. */
+export interface ContentContext {
+    /** Scale in effect where the stream starts: 1 for a page, the invoking CTM for a form. 0 = unknown (treated as small). */
+    baseScale?: number;
+    /** Called for each `Do` with the XObject's resource name and the CTM scale there. */
+    onDo?: (name: string, scale: number) => void;
+}
 /**
  * Rewrite near-black RGB fill/stroke to DeviceGray black inside BT…ET of one
- * content stream. Pure string → string; returns the input when nothing changed.
+ * content stream, for text at or below {@link LARGE_TEXT_PT}, plus the thin
+ * decoration rects in that text's marked-content span. Pure string → string;
+ * returns the input when nothing changed.
  */
-export declare function rewriteBlackText(src: string): string;
+export declare function rewriteBlackText(src: string, ctx?: ContentContext): string;
 /**
  * Apply {@link rewriteBlackText} to every page content stream and Form XObject
  * of a PDF. Returns the input bytes untouched when nothing needed rewriting.

package/dist/lib/build-fingerprint.d.ts

@@ -3,6 +3,8 @@ type PdfxFingerprintConfig = {
     resolvedFlavor: "x1a" | "x3";
     iccPath: string | null;
     stripAnnotations: boolean | null;
+    /** How near-black text was separated (#331); null when no PDF/X pass ran. Provenance only. */
+    blackText?: "icc" | "k-only" | null;
 };
 export type BuildFingerprintInput = {
     command: "build";

package/dist/lib/engine.d.ts

@@ -1,12 +1,13 @@
 import { type BuildDiagnostic } from "../engine/compiler/build.ts";
 import type { Browser as EngineBrowser } from "../engine/shared/cdp.ts";
+import type { LastPageMode } from "../engine/shared/synthesis.ts";
 export type { EngineBrowser };
 /** The subset of `BuildOptions` that has a manifest/CLI source today (B.12). */
 export interface NativePdfOptions {
     title?: string;
     author?: string;
     signature?: number;
-    reserveLastPage?: boolean;
+    lastPage?: LastPageMode;
     /**
      * Downgrade the engine's over-wide-content hard error to a warning +
      * diagnostic. The engine's message tells the author to "pass allowShrink to

package/dist/lib/lint-rules.d.ts

@@ -0,0 +1,9 @@
+export type LintLevel = "off" | "warn" | "error";
+/** Read one rule's configured level; unrecognised values are ignored. */
+export declare function ruleLevel(rules: Readonly<Record<string, unknown>> | undefined, id: string): LintLevel | undefined;
+/**
+ * The rule ids named by a `gutterpress-disable-next-line <id>[, <id>...]
+ * [-- reason]` comment body (the text between the comment delimiters), or
+ * null when the comment is not such a directive.
+ */
+export declare function parseDisableDirective(commentText: string): string[] | null;

package/dist/lib/markdown/assemble.d.ts

@@ -1,4 +1,5 @@
 import { type LoadedPlugin } from "./renderer";
+import { type PrintPadding } from "../../engine/shared/synthesis.ts";
 /** Reader injected by the host: resolve a project-root-relative file → its text. */
 export type ReadText = (relPath: string) => Promise<string>;
 /**
@@ -118,14 +119,11 @@ export interface AssembleBookHtmlOptions {
     title?: string;
     /**
      * The manifest's `print` padding, written on `<html>` as
-     * `data-gp-signature` / `data-gp-reserve-last-page` so the viewer shows the
+     * `data-gp-signature` / `data-gp-last-page` so the viewer shows the
      * blank pages the PDF build appends (`signaturePadding` in
      * engine/shared/synthesis.ts) and the two page counts agree.
      */
-    print?: {
-        signature?: number;
-        reserveLastPage?: boolean;
-    };
+    print?: PrintPadding;
     plugins?: LoadedPlugin[];
     pluginCss?: string;
     /** Add a layout-neutral source-file id to source-mapped preview blocks. */

package/dist/lib/markdown/index.d.ts

@@ -1,6 +1,7 @@
 import { type LayoutWarning } from "./assemble";
 import { type AssetCopy } from "../asset-inline";
 import type { LoadedPlugin, PluginStyleGroup } from "./renderer";
+import type { PrintPadding } from "../../engine/shared/synthesis.ts";
 export type { LayoutWarning } from "./assemble";
 /**
  * THE canonical "which markdown files make up this book, and in what order?"
@@ -31,10 +32,7 @@ export declare function resolveActiveMarkdownFiles(inputDir: string, configuredF
 export declare function renderChapters(inputDir: string, opts?: {
     title?: string;
     /** See {@link AssembleBookHtmlOptions.print}. */
-    print?: {
-        signature?: number;
-        reserveLastPage?: boolean;
-    };
+    print?: PrintPadding;
     styles?: string[];
     files?: string[] | null;
     plugins?: LoadedPlugin[];
@@ -73,10 +71,7 @@ export declare function renderChapters(inputDir: string, opts?: {
 export declare function renderChaptersToFile(inputDir: string, outDir: string, opts?: {
     title?: string;
     /** See {@link AssembleBookHtmlOptions.print}. */
-    print?: {
-        signature?: number;
-        reserveLastPage?: boolean;
-    };
+    print?: PrintPadding;
     styles?: string[];
     files?: string[] | null;
     plugins?: LoadedPlugin[];

package/dist/lib/markdown/renderer.d.ts

@@ -62,7 +62,7 @@ export interface GutterpressMarkerLabel {
  * One entry in a plugin's declared `markers` table (#240 — "declarative
  * container components in core"). Exactly one of three shapes:
  *
- *   - a CONTAINER: `section`/`tag`/`class`/`variants`/`label`/`autoCloseAt`, any/all
+ *   - a CONTAINER: `section`/`tag`/`class`/`variants`/`label`/`autoCloseAt`/`selfClosing`, any/all
  *     optional (a bare `{}` is a valid, if pointless, `<div>` wrapper);
  *   - an ALIAS: `alias` (another declared name) + optional `preset`;
  *   - a DEPRECATION: `deprecated` (a human-readable retirement message) —
@@ -132,6 +132,14 @@ export interface GutterpressMarkerDeclaration {
      * warns (the default — most likely a forgotten `@end-<name>`).
      */
     autoCloseAt?: Array<"eof">;
+    /**
+     * The marker is one element with no body and no `@end-<name>`: `@tape
+     * label="..."` emits the element (and its label) and closes it at once, so
+     * nothing that follows is nested inside and `@end-<name>` warns. Cannot be
+     * combined with `section` or `autoCloseAt`. A `validate` on a self-closing
+     * marker always sees empty `blocks` and `text`. Aliases inherit it.
+     */
+    selfClosing?: boolean;
     /** This marker is sugar for another declared marker (must name a non-alias, non-deprecated entry). */
     alias?: string;
     /** With `alias`: defaults applied when the invocation line supplies none. */

package/dist/lib/page-size.d.ts

@@ -0,0 +1,66 @@
+import type { Document } from "yaml";
+import { type PresetId } from "./presets.ts";
+/** Page bounds written to the manifest's `page:` block (points; 72pt = 1in). */
+export interface CustomPageOptions {
+    /** Trim width in points (72pt = 1in). */
+    width: number;
+    /** Trim height in points (72pt = 1in). */
+    height: number;
+    /** Allowed deviation in points when validating a built PDF. Default 0.5. */
+    tolerance?: number;
+}
+/** A page size in points. */
+export interface PageSizePoints {
+    width: number;
+    height: number;
+}
+/** What an author picks: a preset, plus the trim when the preset is `custom`. */
+export interface PageSizeChoice {
+    preset: PresetId;
+    /** Required for `custom`; ignored for `dtrpg` / `book` (the preset owns it). */
+    page?: PageSizePoints;
+}
+/** A book's page size as currently recorded, read back for the settings UI. */
+export interface PageSetup {
+    /** The manifest's preset (`dtrpg` when undeclared — the product default); null when unrecognised. */
+    preset: PresetId | null;
+    /** The validation bounds the manifest resolves to, or null (custom with no `page:`). */
+    bounds: (PageSizePoints & {
+        tolerance: number;
+    }) | null;
+    /** What the book's stylesheets print at, or null when no plain `@page` sets a size. */
+    css: (PageSizePoints & {
+        file: string;
+    }) | null;
+}
+export declare function isPositivePoints(value: unknown): value is number;
+/**
+ * Write the manifest's `page:` bounds. `tolerance` defaults to whatever the
+ * block already carries, so re-sizing a book never silently resets a
+ * hand-tuned tolerance.
+ */
+export declare function writePageBounds(doc: Document, page: CustomPageOptions): void;
+/** The size (points) a choice means: `custom` brings its own, the others are the preset's. */
+export declare function pageSizeForChoice(choice: PageSizeChoice): PageSizePoints;
+/** The `size` value written for a page: `8.5in 11in`, `595pt 842pt`. */
+export declare function formatPageSize(page: PageSizePoints): string;
+/** The size the LAST plain `@page { size }` in the stylesheet sets (cascade: last wins), or null. */
+export declare function readPageSizeFromCss(css: string): PageSizePoints | null;
+/**
+ * Point a stylesheet's plain `@page` rule at `page`. Rewrites the existing
+ * `size` declaration's value in place — comments, whitespace, other rules and
+ * `!important` untouched — or, when no plain `@page` sets a size, appends a
+ * minimal rule. An already-matching size leaves the text exactly as it was.
+ * Throws when the CSS does not parse (it must never be half-rewritten).
+ */
+export declare function setPageSizeInCss(css: string, page: PageSizePoints): string;
+/** Read a book's page size back from its manifest and stylesheets. */
+export declare function readPageSetup(projectDir: string): Promise<PageSetup>;
+/**
+ * Change a book's page size: the manifest's `preset:` + `page:` bounds and the
+ * stylesheet's `@page` size, together. Mirrors what the wizard records —
+ * `dtrpg` / `book` carry their own bounds (any `page:` block is removed so it
+ * cannot shadow them), `custom` records the typed trim. Nothing is written
+ * unless the whole choice validates and the stylesheet parses.
+ */
+export declare function setPageSetup(projectDir: string, choice: PageSizeChoice): Promise<PageSetup>;

package/dist/lib/pdf-inspect.d.ts

@@ -134,6 +134,12 @@ export interface OpPass {
     fonts: FontRef[];
 }
 export declare function getOpPass(doc: PDFDocumentProxy): Promise<OpPass>;
+/**
+ * Does page `pageNum` (1-based) paint anything at all? False for a page with
+ * no content and for one whose operators only set state or clip. A path op
+ * carries its painting operator as its first argument (`constructPath`).
+ */
+export declare function pageHasMarks(doc: PDFDocumentProxy, pageNum: number): Promise<boolean>;
 /**
  * Per-image effective DPI = pixel dimension ÷ placed size in inches. Decodes
  * each image (best-effort). Used only by the opt-in image-resolution check.

package/dist/lib/printsafe.d.ts

@@ -9,8 +9,15 @@ export interface PrintSafeWarning {
     line: number;
     column: number;
 }
+export interface CheckCssOptions {
+    /** The manifest's `lint.rules`: `off` drops a rule, `warn`/`error` set its severity. */
+    rules?: Readonly<Record<string, unknown>>;
+}
 /**
  * Run print-safety checks against a CSS string. Returns one warning per finding
  * (errors for remote URLs / syntax errors; warnings for risky print effects).
+ * A `/* gutterpress-disable-next-line <rule-id> *\/` comment silences that
+ * rule on the line directly below it; `options.rules` applies the project's
+ * per-rule levels (see lint-rules.ts).
  */
-export declare function checkCss(css: string, from?: string): PrintSafeWarning[];
+export declare function checkCss(css: string, from?: string, options?: CheckCssOptions): PrintSafeWarning[];

package/dist/lib/project-scaffold.d.ts

@@ -1,4 +1,5 @@
 import { type PresetId } from "./presets.ts";
+import { type CustomPageOptions } from "./page-size.ts";
 /**
  * Which embedded starter template to scaffold from. Each id maps to a directory
  * under `assets/templates/<id>/` (a `manifest.yaml` + a `chapter-01.md`), baked
@@ -71,15 +72,8 @@ export interface CreateProjectOptions {
     /** Version-history mode for the new project. Defaults to `"local-git"`. */
     versionHistory?: ProjectVersionHistoryMode;
 }
-/** Page bounds for {@link CreateProjectOptions.customPage}. */
-export interface CustomPageOptions {
-    /** Trim width in points (72pt = 1in). */
-    width: number;
-    /** Trim height in points (72pt = 1in). */
-    height: number;
-    /** Allowed deviation in points when validating a built PDF. Default 0.5. */
-    tolerance?: number;
-}
+/** Page bounds for {@link CreateProjectOptions.customPage} (defined in page-size.ts). */
+export type { CustomPageOptions };
 /** The result of a successful scaffold. */
 export interface CreateProjectResult {
     /** Absolute path of the created project directory. */

package/dist/lib/remote-auth/github-repos.d.ts

@@ -19,6 +19,13 @@ export interface RemoteRepository {
     private: boolean;
     defaultBranch: string;
     htmlUrl: string;
+    /**
+     * Could be an empty repository the author can back a book up to: GitHub
+     * reports size 0, and the repository is writable and not archived. A hint
+     * for pickers only — a tiny non-empty repository also reports size 0, so
+     * the real emptiness check happens when a book is connected (online-backup.ts).
+     */
+    maybeEmpty?: boolean;
 }
 /** One branch of a remote repository. */
 export interface RemoteBranch {

package/dist/lib/remote-auth/online-backup.d.ts

@@ -0,0 +1,51 @@
+import { type RemoteRepository } from "./github-repos.ts";
+import type { SyncOutcome, SyncProjectOptions } from "./sync-types.ts";
+import type { HostCredential, TokenStore } from "./token-store.ts";
+/** What to connect the book to. */
+export type BackupTarget = {
+    kind: "create";
+    /** Repository name (letters, numbers, `-`, `_`, `.`). */
+    name: string;
+    /** Defaults to private — a book is not published by backing it up. */
+    private?: boolean;
+} | {
+    kind: "existing";
+    owner: string;
+    name: string;
+};
+export interface SetUpOnlineBackupOptions {
+    projectDir: string;
+    target: BackupTarget;
+    /** Explicit credential; wins over the token store. */
+    credential?: HostCredential;
+    /** Source of the saved GitHub connection when no credential is passed. */
+    tokenStore?: TokenStore;
+    authorName?: string;
+    authorEmail?: string;
+    /** Injectable fetch for tests. Defaults to global fetch. */
+    fetchImpl?: typeof fetch;
+    /** Injectable git transport for tests (passed to `syncProject`). */
+    httpClient?: SyncProjectOptions["httpClient"];
+    /** Operation log (passed to `syncProject`). */
+    logFile?: SyncProjectOptions["logFile"];
+}
+export type BackupSetupFailureReason = "not-connected" | "auth" | "offline" | "no-history" | "already-has-remote" | "invalid-name" | "name-taken" | "not-found" | "no-permission" | "not-empty" | "push-failed";
+export type BackupSetupResult = {
+    status: "connected";
+    repository: RemoteRepository;
+    sync: SyncOutcome;
+} | {
+    status: "failed";
+    reason: BackupSetupFailureReason;
+    /** Plain-language, safe to show verbatim. */
+    message: string;
+    /** The repository that exists online after a late failure (created or chosen). */
+    repository?: RemoteRepository;
+};
+/** True for a name GitHub accepts for a repository. */
+export declare function isValidRepositoryName(name: string): boolean;
+/**
+ * Connect a locally-versioned book to a GitHub repository and push its
+ * history. Never throws for expected outcomes; see the header.
+ */
+export declare function setUpOnlineBackup(options: SetUpOnlineBackupOptions): Promise<BackupSetupResult>;

package/dist/lib/snippets.d.ts

@@ -87,6 +87,9 @@ export interface MarkerComponent {
      *  as the renderer resolves them — an alias lists its target's. A variant
      *  only adds a class, so one snippet serves them all. */
     variants: string[];
+    /** True for a `selfClosing` marker: one element, no body, no `@end-<name>` —
+     *  the editor inserts the bare marker without a closing pair. */
+    selfClosing?: true;
     /** The winning example snippet's body (book, then extension, then core). */
     snippet?: string;
 }

package/dist/{manifest.schema-40sfq49z.json → manifest.schema-gh0jjve9.json}

@@ -169,7 +169,13 @@
         },
         "reserveLastPage": {
           "type": "boolean",
-          "description": "Guarantee the final page is a blank page added by the build (no background, no page number). When the content already fills a signature exactly, a full signature of blank pages is added. DriveThruRPG reserves the last page for printer information. Preset defaults: dtrpg true, book false."
+          "description": "Guarantee the final page is a blank page added by the build (no background, no page number). When the content already fills a signature exactly, a full signature of blank pages is added. DriveThruRPG reserves the last page for printer information. Preset defaults: dtrpg true, book false. Same as `lastPage: blank`; `lastPage` wins when both are set."
+        },
+        "lastPage": {
+          "type": "string",
+          "description": "How the interior's last page is reserved for a printer that uses it (DriveThruRPG puts its printer information there). `blank` ends the interior on a blank page the build adds. `short-by-one` pads to one page short of a multiple of `signature` (k x signature - 1), and the printer supplies the last page. Wins over `reserveLastPage`. Not set by any preset.",
+          "enum": ["blank", "short-by-one"],
+          "examples": ["blank", "short-by-one"]
         }
       }
     },
@@ -217,7 +223,7 @@
     },
     "lint": {
       "type": "object",
-      "description": "Markdown linting run before the build.",
+      "description": "Lint settings: whether the pre-build lint runs, the markdownlint config, and per-rule level overrides.",
       "properties": {
         "enabled": {
           "type": "boolean",
@@ -228,6 +234,12 @@
           "type": ["string", "null"],
           "description": "Path to a markdownlint config file, relative to the manifest directory. null uses the built-in defaults.",
           "default": null
+        },
+        "rules": {
+          "type": "object",
+          "description": "Per-rule level overrides, keyed by rule id: a printsafe rule (printsafe/no-risky-print-effects, printsafe/page-containment, printsafe/no-remote-urls) or a check id such as source.accessibility.heading-order. \"off\" silences the rule; \"warn\" / \"error\" set its severity. An id that matches no rule is ignored. To silence one site instead, put a `gutterpress-disable-next-line <rule-id> -- reason` comment (CSS `/* */` or markdown `<!-- -->`) on the line above it.",
+          "additionalProperties": { "enum": ["off", "warn", "error"] },
+          "examples": [{ "printsafe/no-risky-print-effects": "off" }]
         }
       }
     },

package/dist/{new-m5y2wepr.js → new-kky3z7kv.js}

@@ -7,16 +7,16 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-6z5zthzt.js";
+} from "./cli-9nba5ve6.js";
 import {
   resolveGhostscript
-} from "./cli-70xgehq2.js";
+} from "./cli-3p1e95zc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ppc0vz4b.js";
-import"./cli-gymfg04q.js";
+} from "./cli-d57bsfpb.js";
+import"./cli-jyy9pqf3.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{plugin.js-m4a7m3t4.tpl → plugin.js-cswq7wvd.tpl}

@@ -62,12 +62,15 @@ const PREFIX = "{{PREFIX}}";
  *   @end-term-box
  *
  * Fields, all optional:
- *   section     true makes the marker a core @section (no tag/label/autoCloseAt)
+ *   section     true makes the marker a core @section (no tag/label/autoCloseAt/selfClosing)
  *   tag         wrapper element            (default "div")
  *   class       base class on the wrapper
  *   variants    extra classes keyed by the marker's bare word
  *   label       a label element built from one of the marker's attributes
  *   autoCloseAt ["eof"] closes an unclosed container at end of file
+ *   selfClosing true for a marker with no body and no @end-<name>: it emits its
+ *               element (and label) and closes it at once. Not with autoCloseAt;
+ *               a `validate` on it sees empty `blocks` and `text`.
  *   snippet     example content the editor inserts for this component, as a
  *               path inside this folder (default: snippets/<name>.md — so
  *               `snippets/term-box.md` is term-box's example already)

package/dist/{plugin.test.js-6n8ct5e3.tpl → plugin.test.js-xgxrd8hf.tpl}

@@ -210,6 +210,9 @@ describe("conventions", () => {
       for (const at of decl.autoCloseAt ?? []) {
         expect(at).toBe("eof");
       }
+      expect(typeof decl.selfClosing === "undefined" || typeof decl.selfClosing === "boolean").toBe(true);
+      // A self-closing marker has no frame for autoCloseAt to close.
+      if (decl.selfClosing) expect(decl.autoCloseAt).toBeUndefined();
       expect(name).toBeTruthy();
     }
   });
@@ -218,7 +221,7 @@ describe("conventions", () => {
     // The editor inserts this file when an author picks the component, so it
     // is the example of the structure the component expects.
     for (const [name, decl] of Object.entries(markers)) {
-      if (decl.deprecated !== undefined || decl.alias !== undefined) continue;
+      if (decl.deprecated !== undefined || decl.alias !== undefined || decl.selfClosing) continue;
       const rel = decl.snippet ?? `${pkg.gutterpress?.snippets ?? "snippets"}/${name}.md`;
       if (!existsSync(path.join(root, rel))) continue;
       const snippet = read(rel);

package/dist/{preflight-bwpqwwny.js → preflight-t8v6szq6.js}

@@ -2,16 +2,16 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} from "./cli-6z5zthzt.js";
+} from "./cli-9nba5ve6.js";
 import {
   log
-} from "./cli-70xgehq2.js";
+} from "./cli-3p1e95zc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ppc0vz4b.js";
-import"./cli-gymfg04q.js";
+} from "./cli-d57bsfpb.js";
+import"./cli-jyy9pqf3.js";
 import {
   BuildError,
   EXIT_CODES

package/dist/preview/file-watcher.d.ts

@@ -7,6 +7,7 @@
 import { type FSWatcher } from 'chokidar';
 import type { ServerState } from './server-context';
 import type { ResolvedExtensionConfig } from '../schema/manifest.types';
+import type { PrintPadding } from '../engine/shared/synthesis.ts';
 /**
  * Rewrite rendered book HTML for the live preview: inject the Gutterpress
  * engine's viewer bundle (`/engine/gutterpress-viewer.js`, embedded the same
@@ -43,10 +44,7 @@ export declare function generateAndWriteHtml(inputPath: string, tempDir: string,
         files?: string[] | null;
     };
     extensions?: ResolvedExtensionConfig[];
-    print?: {
-        signature?: number;
-        reserveLastPage?: boolean;
-    };
+    print?: PrintPadding;
 }, cssAssets: Map<string, string>, imageRefs?: Set<string>): Promise<void>;
 /**
  * Chokidar 5's `ignored` matcher (regex or function) is tested against the

package/dist/{preview-62y7qhkp.js → preview-cxab4y5x.js}

@@ -7,10 +7,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-6z5zthzt.js";
+} from "./cli-9nba5ve6.js";
 import {
   log
-} from "./cli-70xgehq2.js";
+} from "./cli-3p1e95zc.js";
 import {
   UsageError,
   parseFormat,
@@ -18,8 +18,8 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-ppc0vz4b.js";
-import"./cli-gymfg04q.js";
+} from "./cli-d57bsfpb.js";
+import"./cli-jyy9pqf3.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{publish-k2zyt3x6.js → publish-s2mtenb5.js}

@@ -11,17 +11,17 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-6z5zthzt.js";
+} from "./cli-9nba5ve6.js";
 import {
   FileTokenStore,
   log
-} from "./cli-70xgehq2.js";
+} from "./cli-3p1e95zc.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-ppc0vz4b.js";
-import"./cli-gymfg04q.js";
+} from "./cli-d57bsfpb.js";
+import"./cli-jyy9pqf3.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";