gutterpress 0.11.23-alpha.1 → 0.11.23-alpha.2

package/README.md

@@ -143,19 +143,19 @@ source.
 
 ### `gutterpress new`
 
-Scaffold a new book, plugin or theme from an embedded starter template — the fastest way to start (see [Quick start](#quick-start)).
+Scaffold a new book, plugin or look from an embedded starter template — the fastest way to start (see [Quick start](#quick-start)).
 
-`--kind book` is the default. Every new book picks the vendor preset it's designed for: `dtrpg` (DriveThruRPG print-on-demand), `book` (neutral 6x9in trade book), or `custom` (you supply the trim size in points).
+`--kind book` is the default. Every new book has the preset it's designed for, the template's unless you choose: `dtrpg` (DriveThruRPG print-on-demand), `book` (neutral 6x9in trade book), or `custom` (you supply the trim size in points).
 
-`--kind plugin` and `--kind theme` scaffold an **extension package** instead — a folder with a `package.json` a book can load. The plugin starter carries a declarative marker table, a hand-written markdown-it rule, component CSS and a `bun test` fixture suite; the theme starter carries the six-file layered CSS architecture (tokens / base / components / page-templates / page-rules / book), each sheet opening with its own OWNS / MUST NOT CONTAIN contract header. Both include a README explaining which conventions are load-bearing. An extension needs no preset, trim size or publish target, so the book-only flags below are rejected rather than ignored when `--kind` names one — and `--prefix`/`--description` are likewise rejected for a book.
+`--kind plugin` and `--kind look` scaffold an **extension package** instead — a folder with a `package.json` a book can load. The plugin starter carries a declarative marker table, a hand-written markdown-it rule, component CSS and a `bun test` fixture suite; the look starter carries the six-file layered CSS architecture (tokens / base / components / page-templates / page-rules / book), each sheet opening with its own OWNS / MUST NOT CONTAIN contract header. Both include a README explaining which conventions are load-bearing. An extension needs no preset, trim size or publish target, so the book-only flags below are rejected rather than ignored when `--kind` names one — and `--prefix`/`--description` are likewise rejected for a book.
 
 ```sh
 gutterpress new <name> [--kind <id>] [options]
 
-  --kind <id>              What to create: book (default), plugin, theme
-  --prefix <str>           Class/custom-property prefix an extension claims (default: its slug, e.g. "field-notes-"); --kind plugin|theme only
-  --description <text>     One-line description recorded in the extension's metadata; --kind plugin|theme only
-  --preset <id>            Vendor preset the book is designed for: dtrpg, book, custom (required for a book)
+  --kind <id>              What to create: book (default), plugin, look
+  --prefix <str>           Class/custom-property prefix an extension claims (default: its slug, e.g. "field-notes-"); --kind plugin|look only
+  --description <text>     One-line description recorded in the extension's metadata; --kind plugin|look only
+  --preset <id>            Preset the book is designed for: dtrpg, book, custom (default: the template's)
   --author <name>          Author name to record in the project
   --dir <path>             Parent directory to create the project in (default: current directory)
   --folder <name>          Folder name to create (default: a slug of the project name)
@@ -392,32 +392,32 @@ Add an extension. What `SOURCE` is decides what happens:
 
 - an **npm package** (`name` or `name@version`) is downloaded straight from
   the registry along with its runtime dependencies, hash-verified, vendored
-  into the project under `plugins/npm/`, load-tested, and written back pinned
+  into the project under `extensions/npm/`, load-tested, and written back pinned
   as `name@<exact version>`. This does not invoke npm, Bun, Node.js tooling,
   or package install scripts;
-- a **bundled feature** (`markdown-it-mark`, `markdown-it-sub`,
-  `markdown-it-sup`, `markdown-it-abbr`, `gutterpress-gfm-alerts`,
-  `gutterpress-math`) is simply listed — nothing to install, works offline;
+- a **bundled name** — a markdown feature (`markdown-it-mark`,
+  `markdown-it-sub`, `markdown-it-sup`, `markdown-it-abbr`,
+  `gutterpress-gfm-alerts`, `gutterpress-math`) or a built-in look
+  (`clean-book`, `zine`, `technical-doc`, `academic`) — is simply listed:
+  nothing to install, works offline;
 - a **folder or plugin-file path** is load-tested and listed as a
   manifest-relative path, referenced in place — never copied;
 - a **`.zip` or `.css` file**, or an **http(s) URL**, is validated (every
   declared sheet must exist and parse; print-safety findings are warnings)
-  and landed in `extensions/<id>/`, then listed as `./extensions/<id>`;
-- with `--look`, `SOURCE` is a built-in look id, copied into
-  `extensions/<id>/` as the author's own editable files and listed.
+  and landed in `extensions/<id>/`, then listed as `./extensions/<id>`.
 
 Adding something already listed re-pins or updates that entry instead of
 adding a second one.
 
-An npm install also makes sure the book's `.gitignore` ignores `plugins/npm/`
-(append-only; an author's own `!plugins/npm/` re-include is respected and the
+An npm install also makes sure the book's `.gitignore` ignores `extensions/npm/`
+(append-only; an author's own `!extensions/npm/` re-include is respected and the
 install warns that downloaded extensions shouldn't be committed). The manifest
 pin is what travels with the book; the downloaded copy does not.
 
 ##### Restoring pinned extensions
 
 A fresh clone has `manifest.yaml`'s `name@version` pins but not the downloaded
-copies under `plugins/npm/`. `build`, `validate`, `preflight` and `preview`
+copies under `extensions/npm/`. `build`, `validate`, `preflight` and `preview`
 download any missing (or incomplete) pinned version before they load plugins —
 exactly the pinned version, through the same registry-resolved, hash-verified,
 load-tested install as `ext add`, without touching the manifest. Builds and
@@ -429,7 +429,7 @@ paths and bundled features are never touched. The plugin loader itself stays
 offline. The desktop app does the same when it opens a book.
 
 Once a package's pinned version is installed (by `ext add` or a restore), its
-other downloaded versions under `plugins/npm/<name>/` are deleted — a cache
+other downloaded versions under `extensions/npm/<name>/` are deleted — a cache
 that a pulled pin or branch switch would otherwise leave to pile up — except a
 version another enabled manifest entry still pins. A failed install removes the
 folders it created and nothing else.
@@ -438,7 +438,6 @@ folders it created and nothing else.
 gutterpress ext add <source> [dir] [options]
 
   --export <name>    Named module export to use as the plugin function (npm and path extensions only)
-  --look             Treat SOURCE as a built-in look id (clean-book, zine, technical-doc, academic): copy it into extensions/ and add it
 ```
 
 ```sh
@@ -447,7 +446,7 @@ gutterpress ext add markdown-it-highlightjs@4.3.0 ./my-book
 gutterpress ext add markdown-it-emoji@3.0.0 ./my-book --export full
 gutterpress ext add markdown-it-mark ./my-book
 gutterpress ext add ./plugins/field-notes ./my-book
-gutterpress ext add zine ./my-book --look
+gutterpress ext add zine ./my-book
 gutterpress ext add ./parchment.zip ./my-book
 gutterpress ext add https://example.com/looks/cool/ ./my-book
 ```
@@ -456,7 +455,7 @@ gutterpress ext add https://example.com/looks/cool/ ./my-book
 
 Remove an extension from the manifest, by the specifier as written there (for
 an npm package the bare name is enough). An npm extension's vendored copy
-under `plugins/npm/` is deleted too; a path extension's folder is yours and is
+under `extensions/npm/` is deleted too; a path extension's folder is yours and is
 never touched.
 
 ```sh
@@ -558,7 +557,7 @@ An extension folder (or npm package) describes itself in its **`package.json`**
 
 Order is load order: a later entry's markdown runs after earlier entries' (and sees their output) and its CSS wins ties — each extension's stylesheets are wrapped in their own cascade layer (`@layer ext.<name>`), declared in list order, so this holds however an extension writes its CSS; the project's own `styles:` stay unlayered and load after every extension, beating all of them at any specificity. There is no `priority` and no `path:`/`name:` wrapper — a manifest still carrying `plugins:` fails with a message that prints the same entries rewritten as `extensions:`. The `engine:` and `engineStyles:` keys are gone too (there is one engine; move any `engineStyles` entries to the end of `styles:`).
 
-Pinned npm packages and their runtime dependencies live under `plugins/npm/`
+Pinned npm packages and their runtime dependencies live under `extensions/npm/`
 as a plain nested `node_modules` tree, which Node's own module resolution loads.
 The pin travels with the project; the downloaded copy is gitignored, and
 `build`, `validate`, `preflight` and `preview` download a missing pinned version first

package/dist/api/index.d.ts

@@ -34,10 +34,10 @@ export { listBuiltInTemplates, listCustomTemplates, saveProjectAsTemplate, impor
 export type { TemplateInfo, SaveProjectAsTemplateOptions, } from "../lib/project-templates.ts";
 export { extractVariables, substituteVariables, listSnippets, saveSnippet, deleteSnippet, listMergedSnippets, listMarkerComponents, listLocationVariants, SNIPPETS_DIR, } from "../lib/snippets.ts";
 export type { LocationVariant, MarkerComponent, SnippetEntry, SnippetSource } from "../lib/snippets.ts";
-export { listProjectExtensions, describeExtension, addExtension, checkExtensionUpdates, listNpmVersions, updateExtensions, removeExtension, setExtensionEnabled, reorderExtensions, validateProjectExtensions, readExtensionCss, listBuiltInStyleSets, addBuiltInStyleSet, sameExtension, RECOMMENDED_EXTENSIONS, BUILT_IN_STYLE_SET_IDS, EXTENSIONS_DIR, PLUGINS_DIR, } from "../lib/extension-manager.ts";
-export type { ProjectExtensionEntry, ExtensionValidationResult, RecommendedExtension, ExtensionSourceKind, BuiltInStyleSet, BuiltInStyleSetId, AddExtensionOptions, ExtensionUpdateCheck, ExtensionUpdateResult, CheckExtensionUpdatesOptions, UpdateExtensionsOptions, } from "../lib/extension-manager.ts";
-export { BUNDLED_EXTENSIONS, isBundledExtension, isPathSpecifier, parseExtensionSpecifier, } from "../lib/extension-specifier.ts";
-export type { ParsedExtensionSpecifier } from "../lib/extension-specifier.ts";
+export { listProjectExtensions, describeExtension, addExtension, checkExtensionUpdates, listNpmVersions, updateExtensions, removeExtension, setExtensionEnabled, reorderExtensions, validateProjectExtensions, readExtensionCss, listBundledExtensions, sameExtension, EXTENSIONS_DIR, } from "../lib/extension-manager.ts";
+export type { ProjectExtensionEntry, ExtensionValidationResult, BundledExtensionInfo, ExtensionSourceKind, AddExtensionOptions, ExtensionUpdateCheck, ExtensionUpdateResult, CheckExtensionUpdatesOptions, UpdateExtensionsOptions, } from "../lib/extension-manager.ts";
+export { BUNDLED_EXTENSIONS, bundledExtension, isBundledExtension, isPathSpecifier, parseExtensionSpecifier, } from "../lib/extension-specifier.ts";
+export type { BundledExtension, ParsedExtensionSpecifier } from "../lib/extension-specifier.ts";
 export { restorePinnedExtensions, restoreFailureMessage } from "../lib/extension-restore.ts";
 export type { RestorePinnedOptions, RestoreResult, RestoreFailure, RestoreProgress } from "../lib/extension-restore.ts";
 export { importExtensionFromFile, importExtensionFromUrl } from "../lib/extension-import.ts";

package/dist/api/index.js

@@ -101,32 +101,24 @@ import {
   substituteVariables,
   syncProject,
   testRemoteAccess
-} from "../index-zrhyb967.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,
   loadManifestWithPath,
   npmRegistryUrl,
-  parseExtensionSpecifier,
   publishTargetFor,
   readExtensionCss,
   removeExtension,
@@ -138,22 +130,27 @@ import {
   setExtensionEnabled,
   updateExtensions,
   validateProjectExtensions
-} from "../index-m4hhzg3c.js";
+} from "../index-x3ema2w3.js";
 import {
+  BUNDLED_EXTENSIONS,
   EXTENSION_MANIFEST_FILENAME,
   assertExtensionContained,
+  bundledExtension,
   extensionCarries,
   extensionEntry,
   extensionStyleList,
+  isBundledExtension,
+  isPathSpecifier,
+  parseExtensionSpecifier,
   pathEscapesFolder,
   readExtensionMeta,
   resolveExtension
-} from "../index-2jpk25en.js";
+} from "../index-2bjcghze.js";
 import"../index-ht1bcqdd.js";
-import"../index-apc8w9w8.js";
+import"../index-0skhjx3e.js";
 import {
   BuildError
-} from "../index-dsvk7q6s.js";
+} from "../index-46ycxe6r.js";
 import"../index-2ppw6q9v.js";
 import {
   DEFAULT_PRINT_OPTS,
@@ -173,10 +170,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,
@@ -266,8 +263,8 @@ export {
   listGitHubRepositories,
   listGitHubBranches,
   listCustomTemplates,
+  listBundledExtensions,
   listBuiltInTemplates,
-  listBuiltInStyleSets,
   listBookPublishProviders,
   knownForgeTokenUrl,
   isValidRepositoryName,
@@ -307,13 +304,13 @@ export {
   checkRemoteUpdates,
   checkExtensionUpdates,
   capabilitiesFor,
+  bundledExtension,
   autoSyncDelayMs,
   autoSnapshotDelayMs,
   assertMilestone,
   assertExtensionContained,
   adoptFolder,
   addExtension,
-  addBuiltInStyleSet,
   VERSION_CHANGES_SHOWN,
   TARGET_IDS,
   TARGETS,
@@ -324,11 +321,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,
@@ -346,7 +341,6 @@ export {
   BuildError,
   BUNDLED_EXTENSIONS,
   BUILT_IN_TEMPLATE_IDS,
-  BUILT_IN_STYLE_SET_IDS,
   AUTO_SYNC_PUSH_INTERVAL_MINUTES,
   AUTO_SYNC_MIN_MINUTES,
   AUTO_SYNC_MAX_MINUTES,

package/dist/{build-09cd1n7s.js → build-encgnv0c.js}

@@ -1,20 +1,20 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-5hkmp2wy.js";
-import"./cli-ccp7sxz3.js";
+} from "./cli-xq6djqbj.js";
+import"./cli-evg8sbht.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-dtckwda1.js";
+import"./cli-pz4bn98t.js";
 import"./cli-2ppw6q9v.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
-import"./cli-habkc5ng.js";
+import"./cli-a35w7wzg.js";
 import"./cli-v5mp7a6q.js";
-import"./cli-dd115fa8.js";
-import"./cli-h17e3mtz.js";
+import"./cli-sdmv4bba.js";
+import"./cli-pwwfxdgb.js";
 import {
   log
-} from "./cli-b0vyjvmt.js";
+} from "./cli-aqh6brew.js";
 import {
   UsageError,
   parseFormat,
@@ -22,12 +22,11 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-nr6j6300.js";
-import"./cli-fe43evmf.js";
+import"./cli-kh8v4vvw.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
-import"./cli-h3phdstf.js";
+import"./cli-y28j019d.js";
 import"./cli-37x76zdn.js";
 
 // src/commands/build.ts

package/dist/{cli-habkc5ng.js → cli-a35w7wzg.js}

@@ -4,9 +4,10 @@ import {
   findEnclosingRepoDir
 } from "./cli-v5mp7a6q.js";
 import {
-  PLUGINS_DIR,
+  EXTENSIONS_DIR,
+  LEGACY_PLUGINS_DIR,
   VENDORED_NPM_DIR
-} from "./cli-h3phdstf.js";
+} from "./cli-y28j019d.js";
 
 // src/lib/git-fs.ts
 import * as nodeFs from "node:fs";
@@ -511,10 +512,10 @@ async function countUnversionedChanges(projectDir) {
     return null;
   const dir = gitScopeFor(source);
   const bookPrefix = source.subPath ? `${source.subPath.replace(/\/+$/, "")}/` : "";
-  const appWritten = `${bookPrefix}${PLUGINS_DIR}/${VENDORED_NPM_DIR}/`;
+  const appWritten = [EXTENSIONS_DIR, LEGACY_PLUGINS_DIR].map((d) => `${bookPrefix}${d}/${VENDORED_NPM_DIR}/`);
   return withRepoLock(dir, async () => {
     const { adds, removes } = await listWorkdirChanges(dir);
-    const mine = new Set([...adds, ...removes].filter((f) => f.startsWith(bookPrefix) && !f.startsWith(appWritten)));
+    const mine = new Set([...adds, ...removes].filter((f) => f.startsWith(bookPrefix) && !appWritten.some((p) => f.startsWith(p))));
     return { changedFiles: mine.size, stale: gitFs.existsSync(snapshotStagingMarkerPath(dir)) };
   });
 }

package/dist/{cli-b0vyjvmt.js → cli-aqh6brew.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-nr6j6300.js";
+} from "./cli-kh8v4vvw.js";
 
 // src/utils/logger.ts
 var currentLevel = "INFO";

package/dist/{cli-ccp7sxz3.js → cli-evg8sbht.js}

@@ -11,7 +11,7 @@ import {
 import {
   PACKAGE_VERSION,
   log
-} from "./cli-b0vyjvmt.js";
+} from "./cli-aqh6brew.js";
 import {
   __require
 } from "./cli-37x76zdn.js";

package/dist/{cli-nr6j6300.js → cli-kh8v4vvw.js}

@@ -1,7 +1,7 @@
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.23-alpha.1",
+  version: "0.11.23-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",