gutterpress 0.11.23-beta.2 → 0.11.23-beta.3

package/README.md

@@ -151,7 +151,7 @@ Scaffold a new book, plugin or look from an embedded starter template — the fa
 ```sh
 gutterpress new <name> [--kind <id>] [options]
 
-  --kind <id>              What to create: book (default), plugin, look
+  --kind <id>              What to create: book (default), plugin, look (theme is look's older name)
   --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)
@@ -162,6 +162,7 @@ gutterpress new <name> [--kind <id>] [options]
   --targets <ids>          Publish targets recorded in the manifest (comma-separated: dtrpg, itch; or "none") — default: the preset's
   --page-width <pt>        Trim width in points, 72pt = 1in (required with --preset custom; optional override otherwise)
   --page-height <pt>       Trim height in points, 72pt = 1in (required with --preset custom; optional override otherwise)
+  --page-tolerance <pt>    Allowed trim deviation when validating a built PDF (default: 0.5); written as checks: { pdf.print.page-size: { tolerance } }
   --git                    Keep version history on this computer (default: true; use --no-git to skip)
   --no-git
 ```
@@ -404,7 +405,14 @@ Add an extension. What `SOURCE` is decides what happens:
   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>`.
+  and landed in `extensions/<id>/`, then listed as `./extensions/<id>`;
+- with `--look`, `SOURCE` is a built-in look (`clean-book`, `zine`,
+  `technical-doc`, `academic`), **copied** into `extensions/<id>/` (its
+  `theme.css` and a `package.json`) as the book's own editable files and
+  listed as `./extensions/<id>` — in the built-in's place when the book
+  already lists it by name, so the look is listed once. A folder already
+  there is kept as it is (your edits survive) and only referenced again. This
+  is what Book setup's **Make an editable copy** does.
 
 Adding something already listed re-pins or updates that entry instead of
 adding a second one.
@@ -438,6 +446,7 @@ 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 (clean-book, zine, technical-doc, academic): copy it into extensions/ as your own files and list the copy
 ```
 
 ```sh
@@ -447,6 +456,7 @@ 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
+gutterpress ext add zine ./my-book --look
 gutterpress ext add ./parchment.zip ./my-book
 gutterpress ext add https://example.com/looks/cool/ ./my-book
 ```

package/dist/api/index.d.ts

@@ -24,8 +24,8 @@ export type { ProjectSource, ProjectCapabilities, } from "../lib/project-source"
 export { scaffoldProject, adoptFolder, slugifyProjectName, escapeYamlScalar, } from "../lib/project-scaffold.ts";
 export { ensureProjectGitignore } from "../lib/project-gitignore.ts";
 export type { ProjectTemplateId, ProjectVersionHistoryMode, CreateProjectOptions, CustomPageOptions, AdoptFolderOptions, CreateProjectResult, CreateProjectErrorCode, CreateProjectError, } from "../lib/project-scaffold.ts";
-export { scaffoldExtension, resolveExtensionPrefix, EXTENSION_KINDS, RESERVED_PREFIX, } from "../lib/extension-scaffold.ts";
-export type { ExtensionKind, ScaffoldExtensionOptions, ScaffoldExtensionResult, } from "../lib/extension-scaffold.ts";
+export { scaffoldExtension, resolveExtensionPrefix, EXTENSION_KINDS, EXTENSION_KIND_ALIASES, extensionKindFor, RESERVED_PREFIX, } from "../lib/extension-scaffold.ts";
+export type { ExtensionKind, ExtensionKindAlias, ScaffoldExtensionOptions, ScaffoldExtensionResult, } from "../lib/extension-scaffold.ts";
 export { PRESET_IDS, PRESETS } from "../lib/presets.ts";
 export type { PresetId, VendorPreset } from "../lib/presets.ts";
 export { TARGETS, TARGET_IDS, publishTargetFor } from "../lib/targets.ts";
@@ -34,9 +34,9 @@ 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, listBundledExtensions, sameExtension, EXTENSIONS_DIR, } from "../lib/extension-manager.ts";
+export { listProjectExtensions, describeExtension, addExtension, checkExtensionUpdates, listNpmVersions, updateExtensions, removeExtension, setExtensionEnabled, reorderExtensions, validateProjectExtensions, readExtensionCss, listBundledExtensions, addBuiltInStyleSet, BUILT_IN_LOOKS, sameExtension, EXTENSIONS_DIR, PLUGINS_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 { BUNDLED_EXTENSIONS, BUNDLED_EXTENSION_DETAILS, 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";
@@ -56,7 +56,7 @@ export type { PageMargin, PageSetup, PageSetupChange, PageSizeChoice, PageSizePo
 export { providerFor, restoreVersionWithBackup, isNoChangesError, countUnversionedChanges, whenGitIdle, AUTO_SNAPSHOT_MESSAGE, RESTORE_BACKUP_MESSAGE, HISTORY_PAGE_LIMIT, listRevisions, createRevision, revisionNameFrom, switchBranch, SWITCH_BRANCH_SNAPSHOT_MESSAGE, } from "../lib/source-provider.ts";
 export type { ListHistoryOptions, HistoryPage, UnversionedChanges, Revision, RevisionList, CreateRevisionOptions, SwitchBranchOptions, SwitchBranchResult, } from "../lib/source-provider.ts";
 export { describeVersions, listVersionChanges, listOnlineVersions, compareVersionFile, exportVersionTree, VERSION_CHANGES_SHOWN, } from "../lib/version-changes.ts";
-export type { VersionEntry, VersionChanges, VersionFileChange, CompareRow } from "../lib/version-changes.ts";
+export type { VersionEntry, OnlineVersionEntry, VersionChanges, VersionFileChange, CompareRow } from "../lib/version-changes.ts";
 export { autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, AUTO_SYNC_PUSH_INTERVAL_MINUTES, } from "../lib/host-policy.ts";
 export type { AutoSnapshotPolicy, AutoSyncPolicy, } from "../lib/host-policy.ts";
 export { FileTokenStore, defaultConfigDir, extractUrlCredential, } from "../lib/remote-auth/token-store.ts";

package/dist/api/index.js

@@ -6,6 +6,7 @@ import {
   AUTO_SYNC_PUSH_INTERVAL_MINUTES,
   BUILT_IN_TEMPLATE_IDS,
   EXTENSION_KINDS,
+  EXTENSION_KIND_ALIASES,
   FileTokenStore,
   GDRIVE_HOST,
   GITHUB_HOST,
@@ -37,6 +38,7 @@ import {
   disconnectPublishCredential,
   escapeYamlScalar,
   exportVersionTree,
+  extensionKindFor,
   extractUrlCredential,
   extractVariables,
   forgeKindForHost,
@@ -105,14 +107,16 @@ import {
   substituteVariables,
   syncProject,
   testRemoteAccess
-} from "../index-0k43evt0.js";
+} from "../index-z6vzj3s5.js";
 import {
+  BUILT_IN_LOOKS,
   DEFAULT_NPM_REGISTRY,
   MANIFEST_FILENAMES,
   PRESETS,
   PRESET_IDS,
   TARGETS,
   TARGET_IDS,
+  addBuiltInStyleSet,
   addExtension,
   checkExtensionUpdates,
   describeExtension,
@@ -134,9 +138,10 @@ import {
   setExtensionEnabled,
   updateExtensions,
   validateProjectExtensions
-} from "../index-ytjkvwy5.js";
+} from "../index-fntpr44x.js";
 import {
   BUNDLED_EXTENSIONS,
+  BUNDLED_EXTENSION_DETAILS,
   EXTENSION_MANIFEST_FILENAME,
   assertExtensionContained,
   bundledExtension,
@@ -149,9 +154,9 @@ import {
   pathEscapesFolder,
   readExtensionMeta,
   resolveExtension
-} from "../index-80vg3ed6.js";
+} from "../index-67g8f7r4.js";
 import"../index-ht1bcqdd.js";
-import"../index-swfdgn2n.js";
+import"../index-d9w3r89w.js";
 import {
   BuildError
 } from "../index-tayzfr9c.js";
@@ -176,10 +181,11 @@ import {
   revisionNameFrom,
   switchBranch,
   whenGitIdle
-} from "../index-7j3hkwya.js";
+} from "../index-kw4tbthz.js";
 import {
-  EXTENSIONS_DIR
-} from "../index-5x42amh8.js";
+  EXTENSIONS_DIR,
+  PLUGINS_DIR
+} from "../index-g3te5ey1.js";
 import {
   capabilitiesFor,
   detectProjectSource,
@@ -293,6 +299,7 @@ export {
   extractVariables,
   extractUrlCredential,
   extensionStyleList,
+  extensionKindFor,
   extensionEntry,
   extensionCarries,
   exportVersionTree,
@@ -323,6 +330,7 @@ export {
   assertExtensionContained,
   adoptFolder,
   addExtension,
+  addBuiltInStyleSet,
   VERSION_CHANGES_SHOWN,
   TARGET_IDS,
   TARGETS,
@@ -336,6 +344,7 @@ export {
   PublishSelectionsStore,
   PRESET_IDS,
   PRESETS,
+  PLUGINS_DIR,
   MAX_SEARCH_BYTES,
   MANIFEST_FILENAMES,
   HISTORY_PAGE_LIMIT,
@@ -346,13 +355,16 @@ export {
   GDRIVE_HOST,
   FileTokenStore,
   EXTENSION_MANIFEST_FILENAME,
+  EXTENSION_KIND_ALIASES,
   EXTENSION_KINDS,
   EXTENSIONS_DIR,
   DEFAULT_PRINT_OPTS,
   DEFAULT_NPM_REGISTRY,
   BuildError,
+  BUNDLED_EXTENSION_DETAILS,
   BUNDLED_EXTENSIONS,
   BUILT_IN_TEMPLATE_IDS,
+  BUILT_IN_LOOKS,
   AUTO_SYNC_PUSH_INTERVAL_MINUTES,
   AUTO_SYNC_MIN_MINUTES,
   AUTO_SYNC_MAX_MINUTES,

package/dist/{build-3e18wnqj.js → build-fq3mexhy.js}

@@ -1,20 +1,20 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-pnrararp.js";
-import"./cli-0ep11b0q.js";
+} from "./cli-ah93yyzb.js";
+import"./cli-rybz2dfs.js";
 import"./cli-ht1bcqdd.js";
-import"./cli-pd2cje5b.js";
+import"./cli-fsjre61x.js";
 import"./cli-5crpmz42.js";
 import"./cli-eyyggect.js";
 import"./cli-asap4t1z.js";
-import"./cli-v0evdpdf.js";
+import"./cli-eymdsefg.js";
 import"./cli-v5mp7a6q.js";
-import"./cli-88arpdke.js";
-import"./cli-tgnyvra3.js";
+import"./cli-5zbdb6mt.js";
+import"./cli-7mt0dftw.js";
 import {
   log
-} from "./cli-9n9kg58f.js";
+} from "./cli-fh685nqs.js";
 import {
   UsageError,
   parseFormat,
@@ -22,12 +22,12 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags
 } from "./cli-d8xjns66.js";
-import"./cli-x7gcdg6w.js";
+import"./cli-q7t04gjt.js";
 import"./cli-65gy8ask.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
-import"./cli-y28j019d.js";
+import"./cli-1dha1nxk.js";
 import"./cli-37x76zdn.js";
 
 // src/commands/build.ts

package/dist/checks/asset/approved-fonts.d.ts

@@ -0,0 +1,8 @@
+import type { Check } from "../types";
+/**
+ * The font files a book ships, against the list its manifest approves:
+ * `checks: { asset.font.approved-files: { approvedFontFiles: [<glob>, …] } }`
+ * (0.11.22's `validate.assets.approvedFontFiles`). No list, no findings.
+ */
+declare const check: Check;
+export default check;

package/dist/checks/asset/extensions.d.ts

@@ -28,7 +28,7 @@ export declare const ALL_IMAGE_EXTS: readonly ["png", "jpg", "jpeg", "tiff", "ti
  * the run has no book to resolve them from (a `--pdf`-only run).
  */
 export declare function shippedImages(ctx: CheckContext, exts: readonly string[]): string[];
-/** Font file extensions the font-license check looks for. */
+/** Font file extensions shared by the approved-fonts and font-license checks. */
 export declare const FONT_EXTS: readonly ["woff", "woff2", "otf", "ttf", "eot"];
 /**
  * Directories no asset scan should ever descend into, as glob patterns.

package/dist/checks/asset/index.d.ts

@@ -1,3 +1,4 @@
 import "./image-file-size";
 import "./image-alpha";
+import "./approved-fonts";
 import "./font-license";