gutterpress 0.10.8 → 0.10.9

package/dist/lib/extension-manifest.d.ts

@@ -8,8 +8,8 @@ export declare const LEGACY_THEME_MANIFEST_FILENAME = "theme.json";
 /**
  * Parsed extension metadata — a superset of the pre-#241 theme metadata
  * shape. Every field is optional, and a folder declaring only the theme-era
- * fields (`name`/`author`/`description`/`preview`/`styles`/`engineStyles`/
- * `tokensFile`) IS a valid extension: "theme ≡ extension with only styles."
+ * fields (`name`/`author`/`description`/`preview`/`styles`/`tokensFile`) IS
+ * a valid extension: "theme ≡ extension with only styles."
  * Symmetrically, a bare `.js` plugin file (no metadata file at all) never
  * constructs one of these — "plugin ≡ extension with only markdown" needs no
  * metadata file until it wants more than a function (see `plugins.ts`'s
@@ -25,16 +25,11 @@ export interface ExtensionMetadata {
     /**
      * Ordered stylesheets, relative to the extension folder. Absent/empty means
      * "no styles declared" here — {@link extensionStyleList} does NOT default
-     * to `["theme.css"]`; that default is theme-manager.ts's OWN, layered on
+     * to `["theme.css"]`; that default is {@link extensionStyleListWithDefault}'s, layered on
      * top for its theme-shaped callers (a plain markdown-only extension folder
      * has no reason to require a `theme.css` it never declared).
      */
     styles?: string[];
-    /** Engine-conditional sheets, relative to the extension folder, appended
-     *  after `styles` (mirrors the manifest's own `engineStyles.native`). */
-    engineStyles?: {
-        native?: string[];
-    };
     /** Which declared sheet (a path from `styles`) carries the author-facing
      *  `:root` token surface for the Design panel's guided editor. Purely
      *  advisory — nothing in this module enforces or existence-checks it,
@@ -80,14 +75,26 @@ export interface ExtensionMetadata {
 export declare function readExtensionMeta(dir: string): Promise<ExtensionMetadata>;
 /**
  * An extension's declared stylesheets, relative to its folder, in cascade
- * order. UNLIKE `theme-manager.ts`'s `themeStyleList` (which layers a
+ * order. UNLIKE {@link extensionStyleListWithDefault} (which layers a
  * `["theme.css"]` default on top of this for its theme-shaped callers), an
  * absent/empty `styles` here means exactly "none declared" — a markdown-only
  * extension folder must not be forced to carry a `theme.css` it never wanted.
  */
 export declare function extensionStyleList(meta: ExtensionMetadata): string[];
-/** An extension's declared engine-conditional sheets, relative to its folder. */
-export declare function extensionEngineStyleList(meta: ExtensionMetadata): string[];
+/**
+ * `styles`, with the theme-era default (#265): a folder that declares none
+ * but holds a `theme.css` IS a one-sheet look — every theme published before
+ * `styles` existed. A folder with neither still declares nothing.
+ */
+export declare function extensionStyleListWithDefault(meta: ExtensionMetadata, dir: string): string[];
+/** What an extension declares, by field — the desktop's one-list filter. */
+export interface ExtensionCarries {
+    markdown: boolean;
+    styles: boolean;
+    snippets: boolean;
+    components: boolean;
+}
+export declare function extensionCarries(meta: ExtensionMetadata, dir: string): ExtensionCarries;
 /**
  * True when a declared relative path escapes its own folder (absolute, or a
  * `..` segment) — the traversal shape every containment check in this
@@ -111,24 +118,27 @@ export declare function pathEscapesFolder(rel: string): boolean;
  * absolute entry would make apply/load read a file from anywhere on disk.
  *
  * Generalizes the pre-#241 theme-only `assertThemeSheetsContained` (still
- * exported under that name from `theme-manager.ts`, now a re-export of this
+ * once exported under that name from the theme manager, now this
  * function) to the three new fields: a `gutterpress.json`-formatted theme
  * folder can declare `markdown`/`components`/`snippets` too, so the SAME
- * write-boundary guard must cover them, not just `styles`/`engineStyles`.
+ * write-boundary guard must cover them, not just `styles`.
  * `tokensFile` is included even though it is advisory/unenforced elsewhere —
  * defense in depth against a future consumer reading it unchecked.
  *
  * A WRITE-BOUNDARY guard, not a read-path check (mirrors the theme-only
  * predecessor): callers invoke this before copying anything or wiring a
  * manifest, never from a plain listing/read path, so one hand-edited
- * metadata file cannot take down listing every extension.
+ * metadata file cannot take down listing every extension. The removed
+ * `engineStyles` field (#266) is rejected here for the same reason: the
+ * error names the replacement, and it fires only where something would be
+ * copied or wired, never while listing.
  */
 export declare function assertExtensionContained(meta: ExtensionMetadata): void;
 /**
  * An extension's declared paths, resolved to absolute, existence-checked
  * filesystem paths — every list/single-path field goes through the SAME
  * {@link resolveDeclaredStyles} a plugin's `styles` export and a theme's
- * `styles`/`engineStyles.native` already resolve through, so a broken
+ * `styles` already resolve through, so a broken
  * declaration (a missing file) throws HERE, at load/apply time, instead of
  * failing silently deep in the render pipeline (or never, for `components`/
  * `snippets`, which nothing yet reads — #240/#242).
@@ -142,8 +152,6 @@ export interface ResolvedExtension {
     markdown?: string;
     /** Absolute paths, in cascade order, when any are declared. */
     styles?: string[];
-    /** Absolute paths, in cascade order, when any are declared. */
-    engineStyles?: string[];
     /** Declared-relative path of the `:root` token surface — advisory. */
     tokensFile?: string;
     /** Absolute path to the component catalog file, when declared (#242). */

package/dist/lib/extension-specifier.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The markdown features compiled into Gutterpress (`BUILTIN_OPTIONAL_PLUGINS`,
+ * `markdown/renderer.ts` — a test pins the two lists together). Writing one
+ * of these names installs nothing: the loader resolves it from the bundle.
+ */
+export declare const BUNDLED_EXTENSIONS: readonly ["markdown-it-mark", "markdown-it-sub", "markdown-it-sup", "markdown-it-abbr", "gutterpress-gfm-alerts"];
+export type BundledExtensionName = (typeof BUNDLED_EXTENSIONS)[number];
+export declare function isBundledExtension(name: string): name is BundledExtensionName;
+/** `./x`, `../x`, `/x`, or a Windows drive path (`C:\x`). Nothing else is a path. */
+export declare function isPathSpecifier(use: string): boolean;
+export type ParsedExtensionSpecifier = {
+    kind: "path";
+    path: string;
+} | {
+    kind: "bundled";
+    name: string;
+} | {
+    kind: "npm";
+    name: string;
+    version?: string;
+};
+/**
+ * Parse one specifier. Throws a plain `Error` whose message says what to
+ * write instead — callers wrap it with the entry's position.
+ */
+export declare function parseExtensionSpecifier(use: string): ParsedExtensionSpecifier;
+/**
+ * The specifier an `ext add` writes back for an npm install: the exact
+ * version is part of the specifier, so the manifest reads `name@1.2.3`.
+ */
+export declare function pinnedNpmSpecifier(name: string, version: string): string;

package/dist/lib/manifest-doc.d.ts

@@ -9,14 +9,8 @@ export declare function loadManifestDoc(projectDir: string): Promise<{
 }>;
 /** Atomically write the doc back, creating the project dir if needed. */
 export declare function writeManifestDoc(file: string, doc: Document.Parsed): Promise<void>;
-/**
- * The named sequence node, creating (and attaching) an empty one if missing.
- * `key` is a single top-level key (the original, still-exact behavior) OR a
- * path for a nested key (e.g. `["engineStyles", "native"]`, #239) — the
- * `getIn`/`setIn` branch auto-vivifies any missing intermediate map, exactly
- * like a hand-written `engineStyles: { native: [...] }` would parse.
- */
-export declare function ensureSeq(doc: Document.Parsed, key: string | readonly string[]): YAMLSeq;
+/** The named top-level sequence node, creating (and attaching) an empty one if missing. */
+export declare function ensureSeq(doc: Document.Parsed, key: string): YAMLSeq;
 /**
  * Unwrap a yaml seq item (or `getIn`-style Pair) to its string value: `null`
  * when the item isn't a string. Handles both a bare Scalar/Pair-shaped node
@@ -25,7 +19,7 @@ export declare function ensureSeq(doc: Document.Parsed, key: string | readonly s
  * array entry would be).
  *
  * ARCH finding #25: this was two near-duplicate helpers — `unwrapScalar`
- * (manifest-config.ts) and `styleHrefOf` (theme-manager.ts) — with the same
+ * (manifest-config.ts) and `styleHrefOf` (the theme manager, since retired) — with the same
  * shape-sniffing logic. One implementation here, consumed by both.
  */
 export declare function scalarString(item: unknown): string | null;

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

@@ -27,8 +27,8 @@ export default function plugin(md: any, pluginOptions?: {}): void;
  * opposite and was stale — 2026-09-01 CSS architecture review, C4):
  * consumers inject this FIRST, wrapped in `@layer gp.marker` (assemble.ts
  * declares `@layer gp.marker, gp.vocab;` before both core blocks). Author
- * CSS — plugin CSS, every project stylesheet, anything loaded via
- * `engineStyles.native` — stays UNLAYERED, and per the CSS Cascade Layers
+ * CSS — plugin CSS, every project stylesheet — stays UNLAYERED, and per
+ * the CSS Cascade Layers
  * spec unlayered CSS always wins over layered CSS regardless of selector
  * specificity. That is what makes "author wins" true now, not injection
  * order. The `:where()` wrapping on the break/orphan/sizing rules below is

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

@@ -1,4 +1,4 @@
-import type { ResolvedPluginConfig } from "../../schema/manifest.types";
+import type { ResolvedExtensionConfig } from "../../schema/manifest.types";
 import type { LoadedPlugin } from "./renderer";
 export type { GutterpressMarkerDeclaration, GutterpressMarkerLabel, GutterpressMarkerTable, GutterpressPlugin, GutterpressPluginMetadata, GutterpressPluginExport, LoadedPlugin, } from "./renderer";
 export { applyPlugins, collectPluginCss, collectPluginStylePaths } from "./renderer";
@@ -7,7 +7,7 @@ export declare function __setVendorSnapshotHookForTests(hook?: (sourceRoot: stri
 export declare function clearVendoredPluginResolver(baseDir: string, packageName: string, version: string): void;
 /** Test-only: reset the path-plugin cache between test cases. */
 export declare function __resetPathPluginCacheForTests(): void;
-export declare function loadPlugin(config: ResolvedPluginConfig, baseDir: string): Promise<LoadedPlugin>;
+export declare function loadPlugin(config: ResolvedExtensionConfig, baseDir: string): Promise<LoadedPlugin>;
 /**
  * Load all plugins from the resolved configuration.
  *
@@ -30,7 +30,7 @@ export declare function loadPlugin(config: ResolvedPluginConfig, baseDir: string
  * unedited one is never re-imported, correct in both a one-shot CLI build and
  * the long-lived Electron host.
  */
-export declare function loadPlugins(configs: ResolvedPluginConfig[], baseDir: string, onError?: (pluginRef: string, error: Error) => void): Promise<LoadedPlugin[]>;
+export declare function loadPlugins(configs: ResolvedExtensionConfig[], baseDir: string, onError?: (pluginRef: string, error: Error) => void): Promise<LoadedPlugin[]>;
 /** Result of {@link loadPluginsWithCss}: loaded plugins ready for `applyPlugins`
  * plus their concatenated CSS ready for injection into the rendered document. */
 export interface LoadedPluginsWithCss {
@@ -62,4 +62,4 @@ export interface LoadedPluginsWithCss {
  * both call sites' prior behavior of never plugin-loading when the manifest
  * declares no plugins.
  */
-export declare function loadPluginsWithCss(configs: ResolvedPluginConfig[] | undefined | null, baseDir: string, onError?: (pluginRef: string, error: Error) => void): Promise<LoadedPluginsWithCss>;
+export declare function loadPluginsWithCss(configs: ResolvedExtensionConfig[] | undefined | null, baseDir: string, onError?: (pluginRef: string, error: Error) => void): Promise<LoadedPluginsWithCss>;

package/dist/lib/missing-asset-placeholder.d.ts

@@ -32,6 +32,8 @@
  * while hashing the original output path keeps repeat references deterministic.
  */
 export declare function placeholderOutputPath(missingOutputPath: string): string;
+/** Decode the small entity set that can occur inside an HTML URL attribute. */
+export declare function decodeHtmlAttribute(value: string): string;
 /**
  * Rewrite missing local image URLs in rendered HTML to their real PNG paths.
  *
@@ -43,6 +45,15 @@ export declare function placeholderOutputPath(missingOutputPath: string): string
  * at the same staged PNG before `inlineShapeUrls()` reads and embeds it.
  */
 export declare function rewriteMissingImageReferences(html: string, replacements: ReadonlyMap<string, string>): string;
+/**
+ * Apply `rewriteTag` to every tag in the ACTIVE parts of rendered HTML.
+ * Comments and raw-text / literal-content elements (`<script>`, `<style>`,
+ * `<pre>`, `<code>`, `<textarea>`) are opaque to the tag pass — a prose
+ * example showing HTML must stay byte-for-byte authored. Each such region is
+ * handed whole to `rewriteProtected` with its element name (undefined for a
+ * comment), which keeps it unchanged unless the caller says otherwise.
+ */
+export declare function rewriteActiveHtml(html: string, rewriteTag: (tag: string) => string, rewriteProtected?: (region: string, element: string | undefined) => string): string;
 /**
  * Encode a checkerboard PNG of `width`×`height` at `cell` pixels per square.
  * Truecolor (8-bit RGB, no alpha) with filter byte 0 per scanline — the

package/dist/lib/presets.d.ts

@@ -8,7 +8,7 @@ import type { ResolvedConfig } from "../schema/manifest.types";
  * Every preset value is overridable from the manifest, leaf by leaf
  * (resolveConfig's mergeShape; precedence cli > manifest > target > preset).
  */
-export interface VendorPreset extends Omit<ResolvedConfig, "title" | "authors" | "targets" | "page" | "engine"> {
+export interface VendorPreset extends Omit<ResolvedConfig, "title" | "authors" | "targets" | "page"> {
     /**
      * Base page geometry in points, or `null` for `custom` — the one preset
      * with no built-in trim, which therefore REQUIRES the manifest to supply

package/dist/lib/publish/providers/gdrive.d.ts

@@ -13,7 +13,7 @@ interface UploadSource {
  * Package the HTML export directory into a single ZIP (D8: Drive is file
  * delivery, not web hosting — no N-file folder mirroring). Built via
  * `zipEntriesNonBlocking` (fflate is already a dependency, see
- * theme-import.ts for the sibling unzip-side usage) so building the archive
+ * extension-import.ts for the sibling unzip-side usage) so building the archive
  * doesn't block the event loop, then written to a temp file so the existing
  * file-based `resumableUpload` (google-drive.ts) can read it incrementally
  * like any other artifact. Note this is true only of the UPLOAD step — the

package/dist/lib/snippets.d.ts

@@ -10,22 +10,19 @@ export declare const SNIPPETS_DIR = "snippets";
  * gate those actions, so "can this be deleted" never drifts out of sync with
  * "where did this come from" (one field, not two that could disagree).
  *
- * `{ kind: "plugin" | "theme", ref, name }` — a READ-ONLY snippet merged in
- * from an installed, currently-ACTIVE extension (see
- * {@link listInstalledExtensions} for exactly which extensions qualify).
- * `name` is the extension's display name — the picker's group label, so an
- * author always sees WHICH extension a snippet came from, never just "not
- * mine". `ref` is the same stable identifier {@link listProjectPlugins} (a
- * plugin's manifest `path`) or {@link getActiveTheme} (a theme's project id)
- * already hand out; it is round-tripped back into {@link readExtensionSnippet}
- * so that function can re-derive the extension's folder itself from a small,
- * validated identifier instead of trusting a filesystem path a caller could
- * construct.
+ * `{ kind: "extension", ref, name }` — a READ-ONLY snippet merged in from an
+ * installed, ENABLED extension (see {@link listInstalledExtensions}). `name`
+ * is the extension's display name — the picker's group label, so an author
+ * always sees WHICH extension a snippet came from, never just "not mine".
+ * `ref` is the extension's manifest specifier (`ProjectExtensionEntry.use`);
+ * it is round-tripped back into {@link readExtensionSnippet} so that function
+ * can re-derive the extension's folder itself from a small, validated
+ * identifier instead of trusting a filesystem path a caller could construct.
  */
 export type SnippetSource = {
     kind: "project";
 } | {
-    kind: "plugin" | "theme";
+    kind: "extension";
     ref: string;
     name: string;
 };
@@ -144,12 +141,11 @@ export declare function listMergedSnippets(projectDir: string): Promise<SnippetE
  * extended to a second, per-extension root instead of a single project one.
  *
  * Throws when `source` no longer resolves to an installed, active extension
- * (it was disabled, uninstalled, or the theme was switched since the list
- * was fetched — the picker's existing `error` display already handles a
+ * (it was disabled or removed since the list was fetched — the picker's existing `error` display already handles a
  * thrown read the same way a vanished project snippet would) or when
  * `fileName` escapes that extension's snippets folder.
  */
 export declare function readExtensionSnippet(projectDir: string, source: {
-    kind: "plugin" | "theme";
+    kind: "extension";
     ref: string;
 }, fileName: string): Promise<string>;

package/dist/lib/style-resolver.d.ts

@@ -2,7 +2,7 @@
 export interface ProjectStyle {
     /** Absolute path to the `.css` file. */
     path: string;
-    /** Project-relative, "/"-separated display name (e.g. `themes/dark/theme.css`). */
+    /** Project-relative, "/"-separated display name (e.g. `styles/print.css`). */
     displayName: string;
     /** True when this stylesheet is in the manifest `styles:` list (the active set). */
     active: boolean;

package/dist/{lint-3p1s8agk.js → lint-enasqbqx.js}

@@ -1,16 +1,16 @@
 import {
   MANIFEST_FILENAMES,
   runLint
-} 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/{manifest.schema-1q35yxs9.json → manifest.schema-hsn8rsgr.json}

@@ -29,22 +29,6 @@
       "enum": ["dtrpg", "book", "custom"],
       "examples": ["dtrpg", "book", "custom"]
     },
-    "engine": {
-      "type": "string",
-      "description": "Pagination engine. The Gutterpress engine (native Chromium pagination) is the only engine, and \"native\" is the only meaningful value. \"paged\" is accepted for backward-compatible manifest parsing only: it produces a one-line warning and the build proceeds natively regardless. `--engine` on the CLI is likewise an accepted-but-ignored no-op.",
-      "enum": ["paged", "native"],
-      "default": "native",
-      "examples": ["native"]
-    },
-    "engineStyles": {
-      "type": "object",
-      "description": "Engine-conditional stylesheets, appended AFTER `styles`. `.native` is the only list — the native engine is the only engine, so there is nothing else to condition on. A manifest from the dual-engine era may still carry `.paged`; it keeps loading (with a one-line warning) but is no longer part of this schema.",
-      "properties": {
-        "native": { "type": "array", "items": { "type": "string" } }
-      },
-      "additionalProperties": false,
-      "examples": [{ "native": ["css/native-furniture.css"] }]
-    },
     "targets": {
       "type": "array",
       "description": "Where the book is published (ADR 0008): publish targets whose requirements `gutterpress validate` checks the built PDF against — each target is validated separately, so one book can target several destinations. Omitting it uses the preset's default (dtrpg -> [\"dtrpg\"]; book/custom -> []).",
@@ -65,42 +49,34 @@
         ["themes/parchment.css", "styles/override.css"]
       ]
     },
-    "plugins": {
+    "extensions": {
       "type": "array",
-      "description": "markdown-it plugins to load. Each entry is either a shorthand string or a configuration object. Entries are loaded highest-priority first.",
-      "default": [],
+      "description": "Extensions, in load order: markdown-it plugins, looks (stylesheets), component libraries — anything from npm or a folder. Each entry is a specifier: a bundled feature name (markdown-it-mark, markdown-it-sub, markdown-it-sup, markdown-it-abbr, gutterpress-gfm-alerts), a path starting with ./ or ../ (relative to this file), or an npm package name, optionally pinned as name@version. A later entry loads later: its markdown runs after earlier entries' and its CSS wins ties. The project's own `styles` always load after every extension.",
       "items": {
         "oneOf": [
           {
             "type": "string",
             "minLength": 1,
-            "description": "Shorthand. Treated as a local file path when it starts with ./, ../, / or a Windows drive letter, or when it contains a path separator and ends in .js/.mjs/.cjs. Otherwise treated as an npm package name.",
+            "description": "The specifier. Bundled names resolve to the copy compiled into Gutterpress; ./ and ../ are paths relative to this file; anything else is an npm package, name@version pins it.",
             "examples": [
-              "./plugins/my-plugin.js",
-              "plugins/my-plugin.js",
-              "gutterpress-plugin-callouts"
+              "markdown-it-footnote",
+              "@dimm-city/components@2.1.0",
+              "./extensions/house-style",
+              "../shared/dc-design-guide",
+              "markdown-it-mark"
             ]
           },
           {
             "type": "object",
-            "description": "Plugin configuration object. Supply either `path` (local file) or `name` (npm package).",
+            "description": "The object form, for an entry that needs more than its specifier. `use` carries the same specifier the bare form would.",
+            "required": ["use"],
+            "additionalProperties": false,
             "properties": {
-              "path": {
+              "use": {
                 "type": "string",
                 "minLength": 1,
-                "description": "Path to a local plugin module OR an extension folder (a gutterpress.json package, optionally carrying styles/engineStyles alongside its markdown entry), relative to the manifest directory.",
-                "examples": ["plugins/dimm-city-plugin.js", "../shared/plugins/callouts.js", "./extensions/dc-components"]
-              },
-              "name": {
-                "type": "string",
-                "minLength": 1,
-                "description": "npm package name of the plugin.",
-                "examples": ["gutterpress-plugin-callouts"]
-              },
-              "version": {
-                "type": "string",
-                "description": "Exact npm version installed under plugins/npm by Gutterpress. Legacy non-exact values remain informational and use legacy node_modules resolution.",
-                "examples": ["1.2.3", "2.1.0-beta.1"]
+                "description": "The specifier — exactly what the bare string form would be.",
+                "examples": ["markdown-it-attrs", "./extensions/house-style"]
               },
               "export": {
                 "type": "string",
@@ -108,15 +84,9 @@
                 "description": "Named module export to use as the markdown-it plugin function when the package has no default export.",
                 "examples": ["full"]
               },
-              "priority": {
-                "type": "integer",
-                "description": "Advanced, rarely needed. Load order: higher loads first. If one of your plugins needs to see tokens another one of your plugins produces, give it the LOWER number of the two, so it loads (and runs) after.",
-                "default": 100,
-                "examples": [100, 200]
-              },
               "options": {
                 "type": "object",
-                "description": "Plugin-specific options, passed straight through to the plugin.",
+                "description": "Options passed straight through to the markdown-it plugin.",
                 "default": {},
                 "additionalProperties": true
               },
@@ -130,11 +100,11 @@
         ]
       },
       "examples": [
-        ["gutterpress-plugin-callouts", "./plugins/my-plugin.js"],
+        ["./extensions/house-style", "markdown-it-footnote"],
         [
           {
-            "path": "plugins/dimm-city-plugin.js",
-            "priority": 100
+            "use": "markdown-it-attrs",
+            "options": { "leftDelimiter": "[" }
           }
         ]
       ]
@@ -554,11 +524,6 @@
           }
         }
       }
-    },
-    "themePrevious": {
-      "type": "string",
-      "description": "Id of the theme active before the current one (the 'Revert to previous theme' target, #106). Managed automatically by Gutterpress; not authored by hand.",
-      "examples": ["clean-book", "zine"]
     }
   },
   "examples": [

package/dist/{new-xffarp40.js → new-r9c99wsn.js}

@@ -7,16 +7,16 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-1hx14cgk.js";
+} from "./cli-8pg731p5.js";
 import {
   resolveGhostscript
-} 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 {
   isToolAvailable
 } from "./cli-c41yr7he.js";
@@ -159,16 +159,15 @@ async function runExtensionScaffold(kind, name, parentDir, args) {
       console.log("Next: check it still works —");
       console.log(`  cd ${result.slug} && bun install && bun test`);
       console.log("");
-      console.log("      then load it from a book's manifest.yaml:");
-      console.log("        plugins:");
-      console.log(`          - path: plugins/${result.slug}`);
+      console.log("      then add it to a book:");
+      console.log(`        gutterpress ext add ./${result.slug} <book>`);
       console.log("");
-      console.log("      (point `path` at the FOLDER, not plugin.js — that is what makes");
-      console.log("       Gutterpress read gutterpress.json and pick up the stylesheet too.)");
+      console.log("      (that lists the FOLDER under `extensions:` in the book's manifest —");
+      console.log("       not plugin.js — which is what makes Gutterpress read gutterpress.json");
+      console.log("       and pick up the stylesheet too.)");
     } else {
-      console.log("Next: install it into a book —");
-      console.log(`  gutterpress theme import ${result.extensionDir} <book>`);
-      console.log(`  gutterpress theme apply ${result.slug} <book>`);
+      console.log("Next: add it to a book —");
+      console.log(`  gutterpress ext add ${result.extensionDir} <book>`);
       console.log("");
       console.log("      Each stylesheet opens with the OWNS / MUST NOT CONTAIN header that");
       console.log("      says which rules belong in it. Start with styles/tokens.css.");

package/dist/{plugin.test.js-mv0ghv5n.tpl → plugin.test.js-npnfhyca.tpl}

@@ -121,7 +121,6 @@ describe("loader contract", () => {
     const declared = [
       pkg.markdown,
       ...(pkg.styles ?? []),
-      ...(pkg.engineStyles?.native ?? []),
       pkg.components,
       pkg.snippets,
       pkg.tokensFile,

package/dist/{preflight-z6xpty9w.js → preflight-shk7vqbs.js}

@@ -2,16 +2,16 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} 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/preview/file-watcher.d.ts

@@ -6,7 +6,7 @@
  */
 import { type FSWatcher } from 'chokidar';
 import type { ServerState } from './server-context';
-import type { ResolvedPluginConfig } from '../schema/manifest.types';
+import type { ResolvedExtensionConfig } from '../schema/manifest.types';
 /**
  * Whether the incremental preview shell is active. The historical env name is
  * retained because users may already set it. A single Markdown edit paginates
@@ -50,7 +50,7 @@ export declare function generateAndWriteHtml(inputPath: string, tempDir: string,
     source?: {
         files?: string[] | null;
     };
-    plugins?: ResolvedPluginConfig[];
+    extensions?: ResolvedExtensionConfig[];
 }, cssAssets: Map<string, string>): Promise<void>;
 /**
  * Render one source file with the same CSS, plugins, source metadata, and
@@ -60,7 +60,7 @@ export declare function generateAndWriteHtml(inputPath: string, tempDir: string,
 export declare function renderChapterPreviewHtml(inputPath: string, file: string, config: {
     title?: string;
     styles?: string[];
-    plugins?: ResolvedPluginConfig[];
+    extensions?: ResolvedExtensionConfig[];
 }): Promise<string>;
 /** One changed project file, named for the preview broadcast decision. */
 export interface ChangedFile {
@@ -154,7 +154,7 @@ export declare function externalWatchRoots(targets: Iterable<string>): Promise<s
  */
 export declare function externalWatchTargets(projectDir: string, config: {
     styles?: string[];
-    plugins?: ResolvedPluginConfig[];
+    extensions?: ResolvedExtensionConfig[];
 }): Promise<string[]>;
 /**
  * Create and configure a file watcher for the project's input directory plus

package/dist/preview/lifecycle.d.ts

@@ -42,7 +42,7 @@ export declare function validateInputPath(inputPath: string): Promise<void>;
  * For empty input (no-input mode), skip manifest loading entirely and
  * return a default resolved config.
  */
-export declare function initializeConfiguration(inputPath: string, engine?: "paged" | "native"): Promise<ResolvedConfig>;
+export declare function initializeConfiguration(inputPath: string): Promise<ResolvedConfig>;
 /**
  * Restart the preview server with a new input directory.
  *

package/dist/{preview-xa1n7why.js → preview-52918mxk.js}

@@ -1,25 +1,24 @@
 import {
   previewArgs
-} from "./cli-pfpb1t3h.js";
+} from "./cli-bzxqtvrk.js";
 import {
   openPath,
   runBuild,
   splitOutPath,
   startPreviewServer
-} 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,
   resolvePort
-} from "./cli-vcv5ewqj.js";
-import"./cli-4vtgt2ng.js";
+} from "./cli-rh05byck.js";
+import"./cli-bx950tb4.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError
@@ -48,7 +47,6 @@ var preview_default = defineCommand({
         }
       }
       const openFlag = args.open;
-      const engine = parseEngine(args.engine);
       if (format === "html") {
         if (typeof args.manifest === "string") {
           throw new UsageError("--manifest is only supported by preview --format pdf or pdfx; live HTML preview discovers the project manifest from its input directory.");
@@ -60,8 +58,7 @@ var preview_default = defineCommand({
           noWatch: args.watch === false,
           verbose: !!args.verbose,
           openBrowser: openFlag,
-          debug: !!args.debug,
-          engine
+          debug: !!args.debug
         });
         return;
       }
@@ -83,7 +80,6 @@ var preview_default = defineCommand({
         skipPreValidate: !!args["skip-pre-validate"],
         skipPostValidate: !!args["skip-post-validate"],
         allowShrink: !!args["allow-shrink"],
-        engine,
         rawArgs: args
       });
       if (openFlag && result.pdfPath) {