gutterpress 0.11.22 → 0.11.23-alpha.2

package/dist/{index-6cmn2wpd.js → index-x3ema2w3.js}

@@ -1,22 +1,26 @@
 import {
+  BUNDLED_EXTENSIONS,
   EXTENSION_MANIFEST_FILENAME,
   TWO_VERSIONS_OPEN,
+  bundledExtension,
   extensionCarries,
   extensionStyleList,
+  isPathSpecifier,
   loadPlugin,
   log,
+  parseExtensionSpecifier,
+  pinnedNpmSpecifier,
   prettify,
   readExtensionMeta,
   resolveExtension,
   slugify
-} from "./index-4v7e621e.js";
+} from "./index-2bjcghze.js";
 import {
   BuildError,
-  EXIT_CODES,
-  getAssetsDir
-} from "./index-vay3ff1f.js";
+  EXIT_CODES
+} from "./index-46ycxe6r.js";
 import {
-  PLUGINS_DIR,
+  EXTENSIONS_DIR,
   VENDORED_NPM_DIR,
   assertWindowsSafeRelativePath,
   isExactNpmVersion,
@@ -25,8 +29,9 @@ import {
   resolveVendoredPluginInstallRoot,
   vendoredNpmPluginPackageDir,
   vendoredNpmPluginRoot,
+  vendoredNpmPluginRoots,
   windowsPathKey
-} from "./index-r7jcsk6h.js";
+} from "./index-5x42amh8.js";
 import {
   __require
 } from "./index-37x76zdn.js";
@@ -68,7 +73,7 @@ async function withFetchTimeout(options, run) {
 }
 
 // src/lib/extension-manager.ts
-import { cp, mkdir as mkdir3, readdir, readFile as readFile5, rm as rm3, stat } from "node:fs/promises";
+import { readdir, readFile as readFile5, rm as rm3, stat } from "node:fs/promises";
 import { existsSync as existsSync3 } from "node:fs";
 import path4 from "node:path";
 import { isSeq as isSeq2, isMap, isScalar, YAMLMap, Scalar } from "yaml";
@@ -86,43 +91,6 @@ import { existsSync, statSync } from "node:fs";
 import { resolve, dirname } from "node:path";
 import { parse as parseYaml, YAMLParseError } from "yaml";
 
-// src/lib/extension-specifier.ts
-var BUNDLED_EXTENSIONS = [
-  "markdown-it-mark",
-  "markdown-it-sub",
-  "markdown-it-sup",
-  "markdown-it-abbr",
-  "gutterpress-gfm-alerts"
-];
-function isBundledExtension(name) {
-  return BUNDLED_EXTENSIONS.includes(name);
-}
-function isPathSpecifier(use) {
-  return use.startsWith("./") || use.startsWith("../") || use.startsWith("/") || /^[a-zA-Z]:[\\/]/.test(use);
-}
-function parseExtensionSpecifier(use) {
-  const spec = use.trim();
-  if (!spec) {
-    throw new Error("An extension specifier is required — an npm package name, or a ./ path.");
-  }
-  if (isPathSpecifier(spec))
-    return { kind: "path", path: spec };
-  if (/\.(m?js|cjs)$/i.test(spec) || !spec.startsWith("@") && spec.includes("/")) {
-    throw new Error(`"${spec}" looks like a path — write it as "./${spec}". A specifier that does not ` + "start with ./, ../ or / is an npm package name.");
-  }
-  const parsed = parseNpmPluginSpec(spec);
-  if (isBundledExtension(parsed.name)) {
-    if (parsed.selector !== undefined) {
-      throw new Error(`"${parsed.name}" is bundled with Gutterpress and always resolves to the bundled copy — ` + `drop "@${parsed.selector}".`);
-    }
-    return { kind: "bundled", name: parsed.name };
-  }
-  return parsed.selector === undefined ? { kind: "npm", name: parsed.name } : { kind: "npm", name: parsed.name, version: parsed.selector };
-}
-function pinnedNpmSpecifier(name, version) {
-  return `${name}@${version}`;
-}
-
 // src/constants.ts
 var NETWORK = {
   DEFAULT_PORT: 3579
@@ -603,6 +571,15 @@ function mergeShape(cli, manifest, preset) {
   }
   return out;
 }
+var LANGUAGE_TAG = /^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$/;
+function resolveLanguage(value) {
+  if (value === undefined)
+    return "en";
+  if (typeof value !== "string" || !LANGUAGE_TAG.test(value)) {
+    throw new UsageError(`Manifest field \`language\` must be a language tag such as "en", "de" or "pt-BR", got ${JSON.stringify(value)}.`);
+  }
+  return value;
+}
 function resolveConfig(cliOverrides, manifest) {
   const presetName = cliOverrides.preset ?? manifest.preset;
   return resolveWithPreset(cliOverrides, manifest, resolvePreset(presetName));
@@ -690,6 +667,7 @@ function resolveWithPreset(cliOverrides, manifest, preset) {
   return {
     title: c.title ?? m.title ?? "Document",
     authors: c.authors ?? m.authors ?? [],
+    language: resolveLanguage(c.language ?? m.language),
     preset: preset.id,
     spec: preset.spec,
     styles: c.styles ?? m.styles,
@@ -1313,13 +1291,13 @@ async function removeEmptyDirs(dirs) {
   }
 }
 async function prepareVendorParent(projectDir, name) {
-  const plugins = path2.join(projectDir, PLUGINS_DIR);
-  const npm = path2.join(plugins, VENDORED_NPM_DIR);
+  const extensions = path2.join(projectDir, EXTENSIONS_DIR);
+  const npm = path2.join(extensions, VENDORED_NPM_DIR);
   const packageParent = path2.dirname(vendoredNpmPluginRoot(projectDir, name, "0.0.0"));
   await mkdir2(projectDir, { recursive: true });
   const createdDirs = [];
   try {
-    for (const dir of [plugins, npm, packageParent]) {
+    for (const dir of [extensions, npm, packageParent]) {
       if (await ensureDirectory(dir))
         createdDirs.push(dir);
     }
@@ -1438,7 +1416,7 @@ function ignoreStatus(gitignore, entry) {
     return "ignored";
   return dir.unignored || file.unignored ? "negated" : "open";
 }
-var PROJECT_GITIGNORE_ENTRIES = ["dist/", "plugins/npm/"];
+var PROJECT_GITIGNORE_ENTRIES = ["dist/", "extensions/npm/"];
 async function ensureProjectGitignore(projectDir) {
   const gitignorePath = path3.join(projectDir, ".gitignore");
   let existing = null;
@@ -1466,35 +1444,6 @@ async function ensureProjectGitignore(projectDir) {
 }
 
 // src/lib/extension-manager.ts
-var EXTENSIONS_DIR = "extensions";
-var RECOMMENDED_EXTENSIONS = [
-  {
-    use: "markdown-it-mark",
-    label: "Highlight",
-    description: "Highlight text by wrapping it in `==double equals==`."
-  },
-  {
-    use: "markdown-it-sub",
-    label: "Subscript",
-    description: "Lower text below the line, like the 2 in `H~2~O`."
-  },
-  {
-    use: "markdown-it-sup",
-    label: "Superscript",
-    description: "Raise text above the line, like the th in `29^th^`."
-  },
-  {
-    use: "markdown-it-abbr",
-    label: "Abbreviations",
-    description: "Explain an abbreviation when readers hover over it. Define it once, like `*[GPS]: Global Positioning System`."
-  },
-  {
-    use: "gutterpress-gfm-alerts",
-    label: "Callouts",
-    description: "Turn a quote into a boxed note: start it with `> [!NOTE]` (or `TIP`, `IMPORTANT`, `WARNING`, `CAUTION`)."
-  }
-];
-var BUILT_IN_STYLE_SET_IDS = ["clean-book", "zine", "technical-doc"];
 var mutationQueues = new Map;
 function projectKey(projectDir) {
   const resolved = path4.resolve(projectDir);
@@ -1610,15 +1559,14 @@ async function describeEntry(projectDir, raw) {
     return withWarnings({ ...common, kind: "npm", name: raw.use, label: raw.use, carries: NO_CARRIES });
   }
   if (parsed.kind === "bundled") {
-    const bundledName = parsed.name;
-    const rec = RECOMMENDED_EXTENSIONS.find((r) => r.use === bundledName);
+    const bundled = bundledExtension(parsed.name);
     return withWarnings({
       ...common,
       kind: "bundled",
-      name: bundledName,
-      label: rec?.label ?? bundledName,
-      ...rec ? { description: rec.description } : {},
-      carries: { ...NO_CARRIES, markdown: true }
+      name: parsed.name,
+      label: bundled.label,
+      description: bundled.description,
+      carries: { ...NO_CARRIES, ...bundled.css !== undefined ? { styles: true } : { markdown: true } }
     });
   }
   if (parsed.kind === "path") {
@@ -1763,9 +1711,10 @@ async function removeExtension(projectDir, use) {
       return;
     }
     if (parsed.kind === "npm" && parsed.version) {
-      const root = vendoredNpmPluginRoot(projectDir, parsed.name, parsed.version);
-      await rm3(root, { recursive: true, force: true });
-      await removeEmptyDirs([path4.dirname(root)]);
+      for (const root of vendoredNpmPluginRoots(projectDir, parsed.name, parsed.version)) {
+        await rm3(root, { recursive: true, force: true });
+        await removeEmptyDirs([path4.dirname(root)]);
+      }
     }
   });
 }
@@ -1883,8 +1832,8 @@ async function vendorNpmExtension(projectDir, input, exportName, options, commit
   });
   try {
     const { negated } = await ensureProjectGitignore(projectDir);
-    if (negated.includes("plugins/npm/")) {
-      warnings.push("Your .gitignore re-includes plugins/npm/, so downloaded extensions will be committed with " + "your book. They shouldn't be: the manifest pins each version and a build downloads a " + "missing copy again.");
+    if (negated.includes("extensions/npm/")) {
+      warnings.push("Your .gitignore re-includes extensions/npm/, so downloaded extensions will be committed with " + "your book. They shouldn't be: the manifest pins each version and a build downloads a " + "missing copy again.");
     }
   } catch (error) {
     warnings.push(`The extension was installed, but .gitignore could not be updated to keep it out of version history: ` + `${error instanceof Error ? error.message : String(error)}`);
@@ -1910,24 +1859,32 @@ async function pinnedVersionsOf(projectDir, name) {
   return versions;
 }
 async function pruneStaleVersions(projectDir, name, keep) {
-  const parent = path4.dirname(vendoredNpmPluginRoot(projectDir, name, "0.0.0"));
+  const parents = vendoredNpmPluginRoots(projectDir, name, "0.0.0").map((root) => path4.dirname(root));
   try {
-    for (const entry of await readdir(parent, { withFileTypes: true })) {
-      if (!entry.isDirectory())
-        continue;
-      let version;
+    for (const parent of parents) {
+      let entries;
       try {
-        version = decodeURIComponent(entry.name);
-      } catch {
-        continue;
+        entries = await readdir(parent, { withFileTypes: true });
+      } catch (error) {
+        if (error.code === "ENOENT")
+          continue;
+        throw error;
+      }
+      for (const entry of entries) {
+        if (!entry.isDirectory())
+          continue;
+        let version;
+        try {
+          version = decodeURIComponent(entry.name);
+        } catch {
+          continue;
+        }
+        if (!isExactNpmVersion(version) || keep.includes(version))
+          continue;
+        await rm3(path4.join(parent, entry.name), { recursive: true, force: true });
       }
-      if (!isExactNpmVersion(version) || keep.includes(version))
-        continue;
-      await rm3(path4.join(parent, entry.name), { recursive: true, force: true });
     }
   } catch (error) {
-    if (error.code === "ENOENT")
-      return [];
     return [
       `The extension was installed, but a previous version's downloaded copy could not be removed: ` + `${error instanceof Error ? error.message : String(error)}`
     ];
@@ -2013,18 +1970,13 @@ async function updateExtensions(projectDir, options = {}) {
   }
   return updated;
 }
-async function listBuiltInStyleSets() {
-  const assets = await getAssetsDir();
-  const out = [];
-  for (const id of BUILT_IN_STYLE_SET_IDS) {
-    const meta = await readExtensionMeta(path4.join(assets, "themes", id));
-    out.push({
-      id,
-      name: prettify(meta.name?.trim() || id),
-      description: meta.description?.trim() || ""
-    });
-  }
-  return out;
+function listBundledExtensions() {
+  return BUNDLED_EXTENSIONS.map((b) => ({
+    use: b.name,
+    label: b.label,
+    description: b.description,
+    look: b.css !== undefined
+  }));
 }
 async function uniqueExtensionId(projectDir, base) {
   const slug = slugify(base) || "extension";
@@ -2034,20 +1986,6 @@ async function uniqueExtensionId(projectDir, base) {
   }
   return candidate;
 }
-async function addBuiltInStyleSet(projectDir, id) {
-  if (!BUILT_IN_STYLE_SET_IDS.includes(id)) {
-    throw new Error(`Unknown built-in look "${id}" (one of: ${BUILT_IN_STYLE_SET_IDS.join(", ")}).`);
-  }
-  return withMutationLock(projectDir, async () => {
-    const dest = path4.join(projectDir, EXTENSIONS_DIR, id);
-    if (!existsSync3(dest)) {
-      const src = path4.join(await getAssetsDir(), "themes", id);
-      await mkdir3(path4.dirname(dest), { recursive: true });
-      await cp(src, dest, { recursive: true });
-    }
-    return addExtensionUnlocked(projectDir, `./${EXTENSIONS_DIR}/${id}`, {});
-  });
-}
 async function validateProjectExtensions(projectDir) {
   const out = [];
   for (const entry of await listProjectExtensions(projectDir)) {
@@ -2074,6 +2012,9 @@ async function readExtensionCss(projectDir, use) {
   const entry = await describeExtension(projectDir, use);
   if (!entry)
     throw new Error(`Extension "${use}" is not in the manifest.`);
+  const bundledCss = entry.kind === "bundled" ? bundledExtension(entry.name)?.css : undefined;
+  if (bundledCss !== undefined)
+    return bundledCss;
   if (!entry.dir)
     throw new Error(`Extension "${use}" has no stylesheets to preview.`);
   const meta = await readExtensionMeta(entry.dir);
@@ -2205,4 +2146,4 @@ async function restoreForCommand(dir, options) {
     log.warn(problem);
 }
 
-export { BUNDLED_EXTENSIONS, isBundledExtension, isPathSpecifier, parseExtensionSpecifier, DEBOUNCE, UsageError, resolvePort, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, resolveTargets, applyDefaultPdfStrictChecks, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, resolveConfigForTarget, FriendlyHttpError, withFetchTimeout, loadManifestDoc, writeManifestDoc, ensureSeq, scalarString, DEFAULT_NPM_REGISTRY, npmRegistryUrl, ensureProjectGitignore, EXTENSIONS_DIR, RECOMMENDED_EXTENSIONS, BUILT_IN_STYLE_SET_IDS, sameExtension, listProjectExtensions, describeExtension, extensionConfigFor, setExtensionEnabled, reorderExtensions, removeExtension, addExtension, listNpmVersions, checkExtensionUpdates, updateExtensions, listBuiltInStyleSets, uniqueExtensionId, addBuiltInStyleSet, validateProjectExtensions, readExtensionCss, restorePinnedExtensions, restoreFailureMessage, restoreOfflineMessage, restoreForCommand };
+export { DEBOUNCE, UsageError, resolvePort, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, resolveTargets, applyDefaultPdfStrictChecks, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, resolveConfigForTarget, FriendlyHttpError, withFetchTimeout, loadManifestDoc, writeManifestDoc, ensureSeq, scalarString, DEFAULT_NPM_REGISTRY, npmRegistryUrl, ensureProjectGitignore, sameExtension, listProjectExtensions, describeExtension, extensionConfigFor, setExtensionEnabled, reorderExtensions, removeExtension, addExtension, listNpmVersions, checkExtensionUpdates, updateExtensions, listBundledExtensions, uniqueExtensionId, validateProjectExtensions, readExtensionCss, restorePinnedExtensions, restoreFailureMessage, restoreOfflineMessage, restoreForCommand };

package/dist/index.js

@@ -116,33 +116,25 @@ import {
   substituteVariables,
   syncProject,
   testRemoteAccess
-} from "./index-kh7fayjv.js";
+} from "./index-j5z86r4a.js";
 import {
-  BUILT_IN_STYLE_SET_IDS,
-  BUNDLED_EXTENSIONS,
   DEFAULT_NPM_REGISTRY,
-  EXTENSIONS_DIR,
   MANIFEST_FILENAMES,
   PRESETS,
   PRESET_IDS,
-  RECOMMENDED_EXTENSIONS,
   TARGETS,
   TARGET_IDS,
-  addBuiltInStyleSet,
   addExtension,
   checkExtensionUpdates,
   describeExtension,
   ensureProjectGitignore,
   hasProjectManifest,
-  isBundledExtension,
-  isPathSpecifier,
-  listBuiltInStyleSets,
+  listBundledExtensions,
   listNpmVersions,
   listProjectExtensions,
   loadManifest,
   loadManifestWithPath,
   npmRegistryUrl,
-  parseExtensionSpecifier,
   publishTargetFor,
   readExtensionCss,
   removeExtension,
@@ -154,26 +146,31 @@ import {
   setExtensionEnabled,
   updateExtensions,
   validateProjectExtensions
-} from "./index-6cmn2wpd.js";
+} from "./index-x3ema2w3.js";
 import {
+  BUNDLED_EXTENSIONS,
   EXTENSION_MANIFEST_FILENAME,
   assertExtensionContained,
+  bundledExtension,
   extensionCarries,
   extensionEntry,
   extensionStyleList,
+  isBundledExtension,
+  isPathSpecifier,
   log,
+  parseExtensionSpecifier,
   pathEscapesFolder,
   readExtensionMeta,
   resolveExtension
-} from "./index-4v7e621e.js";
+} from "./index-2bjcghze.js";
 import"./index-ht1bcqdd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-53nrm5j1.js";
-import"./index-apc8w9w8.js";
+} from "./index-4x6y8krm.js";
+import"./index-0skhjx3e.js";
 import {
   BuildError
-} from "./index-vay3ff1f.js";
+} from "./index-46ycxe6r.js";
 import"./index-2ppw6q9v.js";
 import {
   DEFAULT_PRINT_OPTS,
@@ -193,10 +190,10 @@ import {
   restoreVersionWithBackup,
   switchBranch,
   whenGitIdle
-} from "./index-93pqkvty.js";
+} from "./index-h6yk5tjx.js";
 import {
-  PLUGINS_DIR
-} from "./index-r7jcsk6h.js";
+  EXTENSIONS_DIR
+} from "./index-5x42amh8.js";
 import {
   capabilitiesFor,
   detectProjectSource,
@@ -295,8 +292,8 @@ export {
   listGitHubRepositories,
   listGitHubBranches,
   listCustomTemplates,
+  listBundledExtensions,
   listBuiltInTemplates,
-  listBuiltInStyleSets,
   listBookPublishProviders,
   knownForgeTokenUrl,
   isValidRepositoryName,
@@ -344,13 +341,13 @@ export {
   checkExtensionUpdates,
   checkCss,
   capabilitiesFor,
+  bundledExtension,
   autoSyncDelayMs,
   autoSnapshotDelayMs,
   assertMilestone,
   assertExtensionContained,
   adoptFolder,
   addExtension,
-  addBuiltInStyleSet,
   VERSION_CHANGES_SHOWN,
   TARGET_IDS,
   TARGETS,
@@ -361,11 +358,9 @@ export {
   RESTORE_BACKUP_MESSAGE,
   RESERVED_PREFIX,
   REPAIR_SNAPSHOT_MESSAGE,
-  RECOMMENDED_EXTENSIONS,
   PublishSelectionsStore,
   PRESET_IDS,
   PRESETS,
-  PLUGINS_DIR,
   MAX_SEARCH_BYTES,
   MANIFEST_FILENAMES,
   HISTORY_PAGE_LIMIT,
@@ -383,7 +378,6 @@ export {
   BuildError,
   BUNDLED_EXTENSIONS,
   BUILT_IN_TEMPLATE_IDS,
-  BUILT_IN_STYLE_SET_IDS,
   BUILD_DIAGNOSTIC_CODES,
   AUTO_SYNC_PUSH_INTERVAL_MINUTES,
   AUTO_SYNC_MIN_MINUTES,

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

@@ -169,7 +169,7 @@ export interface BuildContext {
      * The build's ONE plugin load (#262). `null` until {@link loadBuildPlugins}
      * runs; every stage that needs plugins (the preValidate gate in
      * {@link runQualityGates}, and {@link renderBook}) calls that function and
-     * gets the SAME resolved `{ plugins, pluginCss, pluginStylePaths }` back,
+     * gets the SAME resolved `{ plugins, pluginStyles, pluginStylePaths }` back,
      * whichever of them runs first.
      *
      * One load means one answer: the validation gate checks exactly the plugin

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

@@ -1,11 +1,10 @@
 import { type NpmPluginInstallOptions } from "./npm-plugin-installer.ts";
 import { type ExtensionCarries } from "./extension-manifest.ts";
 import type { ResolvedExtensionConfig } from "../schema/manifest.types.ts";
-/** Folder (relative to the project root) extensions this module COPIES land in
- *  (built-in looks, zip/URL imports). Path entries elsewhere are never moved. */
-export declare const EXTENSIONS_DIR = "extensions";
-/** The vendored npm tree stays where 0.10.8 put it. */
-export { PLUGINS_DIR } from "./plugin-vendor.ts";
+/** The folder (relative to the project root) a book's extensions live under:
+ *  vendored npm copies in `extensions/npm/`, zip and URL imports beside them
+ *  (extension-import.ts). Path entries elsewhere are never moved. */
+export { EXTENSIONS_DIR } from "./plugin-vendor.ts";
 /** How an `extensions:` entry resolves — the form of its specifier decides. */
 export type ExtensionSourceKind = "bundled" | "path" | "npm";
 /** One configured extension, as surfaced to the CLI and the desktop. */
@@ -54,34 +53,6 @@ export interface ExtensionValidationResult {
     /** The loader's fail-fast error message when `ok` is `false`. */
     error?: string;
 }
-/** A curated, bundled markdown feature an author can turn on. */
-export interface RecommendedExtension {
-    /** The bundled name — also the manifest entry "Add" writes. */
-    use: string;
-    /** Short, plain-language feature name shown as the row title. */
-    label: string;
-    /** One-line author-friendly description in plain words. Backtick spans mark
-     *  "what to type" (the desktop sets them in code type), so keep them paired
-     *  and keep HTML tag names out of the prose. */
-    description: string;
-}
-/**
- * The bundled markdown features (`BUNDLED_EXTENSIONS`): adding one writes the
- * manifest entry AND the feature works immediately — no terminal, no install,
- * offline. The always-on defaults (attrs/footnote/deflist, applied
- * unconditionally in renderer.ts) are deliberately NOT listed: recommending
- * the author "add" something already active is pure confusion.
- */
-export declare const RECOMMENDED_EXTENSIONS: RecommendedExtension[];
-/** The built-in looks shipped as embedded assets (ids are folder names). */
-export declare const BUILT_IN_STYLE_SET_IDS: readonly ["clean-book", "zine", "technical-doc"];
-export type BuiltInStyleSetId = (typeof BUILT_IN_STYLE_SET_IDS)[number];
-/** A built-in look, as listed for the desktop's Look view. */
-export interface BuiltInStyleSet {
-    id: BuiltInStyleSetId;
-    name: string;
-    description: string;
-}
 /** One key per book folder, however the path is spelled (Windows paths are case-insensitive). */
 export declare function projectKey(projectDir: string): string;
 /**
@@ -157,7 +128,7 @@ export declare function restoreNpmExtension(projectDir: string, name: string, ve
     /** Every version of `name` an enabled manifest entry pins — never pruned. */
     keepVersions?: readonly string[];
 }): Promise<string[]>;
-/** True when `plugins/npm/<name>/<version>/` is absent or has no loadable entry — what the loader calls "not installed" or "incomplete". */
+/** True when `extensions/npm/<name>/<version>/` is absent or has no loadable entry — what the loader calls "not installed" or "incomplete". */
 export declare function vendoredCopyNeedsInstall(projectDir: string, name: string, version: string): Promise<boolean>;
 /** One pinned npm extension against npm's `latest` tag. */
 export interface ExtensionUpdateCheck {
@@ -215,17 +186,19 @@ export interface UpdateExtensionsOptions extends CheckExtensionUpdatesOptions {
  * Returns what moved; an up-to-date book returns `[]`.
  */
 export declare function updateExtensions(projectDir: string, options?: UpdateExtensionsOptions): Promise<ExtensionUpdateResult[]>;
-/** List the built-in looks (metadata read from the embedded assets). */
-export declare function listBuiltInStyleSets(): Promise<BuiltInStyleSet[]>;
+/** A bundled extension as the desktop lists it: "Add" writes `use`. */
+export interface BundledExtensionInfo {
+    use: string;
+    /** Short, plain-language name shown as the row title. */
+    label: string;
+    description: string;
+    /** A look (styles only), as opposed to a markdown feature. */
+    look: boolean;
+}
+/** The bundled extensions, in table order. */
+export declare function listBundledExtensions(): BundledExtensionInfo[];
 /** A folder name under `extensions/` not yet taken: `<slug>`, `<slug>-2`, … */
 export declare function uniqueExtensionId(projectDir: string, base: string): Promise<string>;
-/**
- * Copy a built-in look into `extensions/<id>/` and add it to the manifest as
- * `./extensions/<id>`. The copy is deliberate (see the module doc): the look
- * becomes the author's own editable files. Idempotent — a folder already
- * there is kept as it is and only (re-)referenced.
- */
-export declare function addBuiltInStyleSet(projectDir: string, id: string): Promise<ProjectExtensionEntry>;
 /**
  * Validate every configured extension by attempting to LOAD it through the
  * one loader. Disabled entries are reported as disabled and NOT load-tested.

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

@@ -1,7 +1,7 @@
 /** Which starter package to create. */
-export type ExtensionKind = "plugin" | "theme";
+export type ExtensionKind = "plugin" | "look";
 /** The kinds `--kind` accepts, for CLI help text and pickers. */
-export declare const EXTENSION_KINDS: readonly ["plugin", "theme"];
+export declare const EXTENSION_KINDS: readonly ["plugin", "look"];
 /**
  * The class/property prefix a scaffolded extension is FORBIDDEN to take.
  * `gp-` is Gutterpress core's own vocabulary (CLAUDE.md §6); an extension
@@ -56,7 +56,7 @@ export interface ScaffoldExtensionResult {
  */
 export declare function resolveExtensionPrefix(slug: string, requested?: string): string;
 /**
- * Create a plugin or theme starter package.
+ * Create a plugin or look starter package.
  *
  * Resolves with a {@link ScaffoldExtensionResult}; throws a
  * {@link CreateProjectError} (the SAME error type `scaffoldProject` throws, so

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

@@ -1,11 +1,28 @@
 /**
- * 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.
+ * The extensions compiled into Gutterpress. Writing one of these names in
+ * `extensions:` installs nothing: the loader resolves it from the bundle, so
+ * it works offline and in the compiled binary.
+ *
+ * A markdown feature loads from `BUILTIN_OPTIONAL_PLUGINS`
+ * (`markdown/renderer.ts`, keyed by the same name; a test pins the two
+ * together). A look is its stylesheet, inlined here as text, so the loader
+ * hands it straight to the cascade and nothing is read from disk or copied
+ * into a book. Both carry their author-facing words here.
  */
-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;
+export interface BundledExtension {
+    /** The specifier an author writes. */
+    name: string;
+    /** Short, plain-language name shown as the row title. */
+    label: string;
+    /** One line in plain words. Backtick spans mark "what to type" (the desktop
+     *  sets them in code type), so keep them paired and keep HTML tags out. */
+    description: string;
+    /** A look's stylesheet. Absent for a markdown feature. */
+    css?: string;
+}
+export declare const BUNDLED_EXTENSIONS: readonly BundledExtension[];
+export declare function bundledExtension(name: string): BundledExtension | undefined;
+export declare function isBundledExtension(name: string): boolean;
 /** `./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 = {

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

@@ -4,7 +4,7 @@ import { type PrintAreaSource } from "../../engine/shared/print-area.ts";
 /** Reader injected by the host: resolve a project-root-relative file → its text. */
 export type ReadText = (relPath: string) => Promise<string>;
 /**
- * One author-mistake warning emitted by Gutterpress's marker parser.
+ * One author-mistake warning, most emitted by Gutterpress's marker parser.
  * Mirrors the shape `markers.js`'s `warn()` pushes onto
  * `env.layoutWarnings` — see that file's header comment for the warning
  * `type`s (`ambiguous_marker_token`, `unrecognized_marker_token`,
@@ -36,6 +36,10 @@ export type ReadText = (relPath: string) => Promise<string>;
  * for an `@page` / `@section` word that is a near-miss of a declared page /
  * section variant (any other word there is a free name and stays silent).
  *
+ * Two come from outside the marker parser: `table_extra_cells` (a table
+ * row with more cells than the header, `table.ts`) and `math_error` (a
+ * formula MathJax could not typeset, `math.ts`).
+ *
  * There is deliberately no `section_without_page`: a @section with no open
  * @page is valid authoring (17/17 false positives across two real books).
  */
@@ -60,6 +64,8 @@ export declare const PAGE_BACKGROUND_FIXED_MILESTONE = 152;
 export interface AssembleBookHtmlOptions {
     /** Ordered list of project-root-relative `.md` files to concatenate. */
     files: string[];
+    /** The book's BCP 47 language tag (manifest `language`); `en` when absent. */
+    language?: string;
     /** Async reader the assembler uses to fetch each file's contents. */
     readText: ReadText;
     /**