gutterpress 0.0.0 → 0.9.0-alpha.2

package/dist/{cli-1tyj4bk3.js → index-wchtvxvw.js}

@@ -86,6 +86,9 @@ async function detectProjectSource(folderPath) {
   }
   return { type: "local-folder", path: folderPath };
 }
+function repoRootForSource(source, fallbackDir) {
+  return source.type === "local-git-folder" ? source.repoRoot || fallbackDir : fallbackDir;
+}
 function capabilitiesFor(source) {
   switch (source.type) {
     case "local-folder":
@@ -121,4 +124,4 @@ function capabilitiesFor(source) {
   }
 }
 
-export { pickSyncRemote, syncRemoteFor, findEnclosingRepoDir, repoSubPath, detectProjectSource, capabilitiesFor };
+export { syncRemoteFor, findEnclosingRepoDir, repoSubPath, detectProjectSource, repoRootForSource, capabilitiesFor };

package/dist/{index-5bxx0c4y.js → index-yzrh708h.js}

@@ -2,7 +2,7 @@ import {
   capabilitiesFor,
   detectProjectSource,
   findEnclosingRepoDir
-} from "./index-1tyj4bk3.js";
+} from "./index-wchtvxvw.js";
 
 // src/lib/source-provider.ts
 import * as fs from "node:fs";
@@ -461,4 +461,4 @@ async function restoreVersionWithBackup(options) {
   });
 }
 
-export { resolveLogger, shortOid, gitScopeFor, HISTORY_PAGE_LIMIT, SNAPSHOT_STAGING_MARKER, withRepoLock, __repoLockQueueSizeForTests, gitAuthor, readGitAuthor, resolveGitAuthor, listWorkdirChanges, stageChanges, hasPendingChanges, hasUncommittedChanges, snapshotWorkingTreeUnlocked, isNoChangesError, providerFor, gitDirFor, snapshotStagingMarkerPath, RESTORE_BACKUP_MESSAGE, AUTO_SNAPSHOT_MESSAGE, restoreVersionWithBackup };
+export { resolveLogger, shortOid, gitScopeFor, HISTORY_PAGE_LIMIT, withRepoLock, __repoLockQueueSizeForTests, resolveGitAuthor, listWorkdirChanges, stageChanges, hasPendingChanges, hasUncommittedChanges, snapshotWorkingTreeUnlocked, isNoChangesError, providerFor, gitDirFor, snapshotStagingMarkerPath, RESTORE_BACKUP_MESSAGE, AUTO_SNAPSHOT_MESSAGE, restoreVersionWithBackup };

package/dist/index.js

@@ -15,11 +15,15 @@ import {
   GitHubAuthProvider,
   MANIFEST_FILENAMES,
   PLUGINS_DIR,
+  PRESETS,
+  PRESET_IDS,
   PublishSelectionsStore,
   RECOMMENDED_PLUGINS,
   RepoNeedsRecoveryError,
   SNIPPETS_DIR,
   SYNC_SNAPSHOT_MESSAGE,
+  TARGETS,
+  TARGET_IDS,
   THEMES_DIR,
   addLocalPlugin,
   addNpmPlugin,
@@ -91,6 +95,7 @@ import {
   publishConnectionStatus,
   publishCredentialKey,
   publishProviderFor,
+  publishTargetFor,
   pullChanges,
   pushChanges,
   readAppHeartbeat,
@@ -137,7 +142,7 @@ import {
   validateProjectPlugins,
   verifyRepoReadable,
   writeAppHeartbeat
-} from "./index-3h3fef7r.js";
+} from "./index-bynn850m.js";
 import {
   AUTO_SNAPSHOT_MESSAGE,
   HISTORY_PAGE_LIMIT,
@@ -147,13 +152,14 @@ import {
   resolveLogger,
   restoreVersionWithBackup,
   shortOid
-} from "./index-5bxx0c4y.js";
+} from "./index-yzrh708h.js";
 import {
   capabilitiesFor,
   detectProjectSource,
   findEnclosingRepoDir,
+  repoRootForSource,
   repoSubPath
-} from "./index-1tyj4bk3.js";
+} from "./index-wchtvxvw.js";
 import"./index-yja077f6.js";
 import"./index-37x76zdn.js";
 export {
@@ -195,6 +201,7 @@ export {
   resolveActiveStyles,
   reportMissingTools,
   repoSubPath,
+  repoRootForSource,
   removeProjectTheme,
   removeAppHeartbeat,
   redactCredential,
@@ -207,6 +214,7 @@ export {
   readAppHeartbeat,
   pushChanges,
   pullChanges,
+  publishTargetFor,
   publishProviderFor,
   publishCredentialKey,
   publishConnectionStatus,
@@ -283,12 +291,16 @@ export {
   addNpmPlugin,
   addLocalPlugin,
   THEMES_DIR,
+  TARGET_IDS,
+  TARGETS,
   SYNC_SNAPSHOT_MESSAGE,
   SNIPPETS_DIR,
   RepoNeedsRecoveryError,
   RESTORE_BACKUP_MESSAGE,
   RECOMMENDED_PLUGINS,
   PublishSelectionsStore,
+  PRESET_IDS,
+  PRESETS,
   PLUGINS_DIR,
   MANIFEST_FILENAMES,
   HISTORY_PAGE_LIMIT,

package/dist/lib/asset-inline.d.ts

@@ -36,6 +36,25 @@ export interface InlineStylesResult {
  * Falls back to the raw string for a literal `%` in a filename.
  */
 export declare function decodeRef(ref: string): string;
+/**
+ * True when `absPath` resolves OUTSIDE `projectDir`. Separator-aware, so a
+ * project-root file whose NAME begins with two dots (`..cover.png`) is NOT
+ * treated as an escape, and the `isAbsolute` arm catches a cross-drive Windows
+ * path that `path.relative` returns absolute. THE one containment predicate for
+ * this module's "is this asset in the project" decisions.
+ */
+export declare function escapesProjectRoot(projectDir: string, absPath: string): boolean;
+/**
+ * The build-failing reason a prose IMAGE ref cannot be used, or `null` when it
+ * is a usable in-project reference. THE single source of truth both
+ * `planImageCopies` (which rejects at build time) and the pre-build
+ * `source.links.local-refs` check consume, so validation and the build agree
+ * on the rule — an image referenced from Markdown prose must live inside the
+ * book folder — AND on the exact decode (`stripUrlSuffix(decodeRef(...))`) and
+ * wording. They previously hand-rolled this apart and had already drifted (the
+ * check decoded without stripping the `?query`/`#frag` suffix).
+ */
+export declare function proseImageRefError(ref: string, projectDir: string): string | null;
 /**
  * Inline the active stylesheets into one CSS string, IN ORDER — the manifest's
  * `styles:` list is the cascade order (theme first, override second).

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

@@ -31,7 +31,6 @@ export declare const EXIT_CODES: {
     readonly USAGE: 2;
     readonly PIPELINE: 3;
 };
-export type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];
 /**
  * BuildError — the canonical error type for build/pipeline failures.
  *

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

@@ -6,7 +6,21 @@ type PdfxFingerprintConfig = {
 };
 export type BuildFingerprintInput = {
     command: "build";
+    /** Where the fingerprint FILE is written — the build's ephemeral work dir. */
     outputDir: string;
+    /**
+     * The output dir to RECORD in `keyConfig.outputDir`. Defaults to
+     * {@link BuildFingerprintInput.outputDir}.
+     *
+     * These are the same for a caller that writes straight to its destination, but
+     * a build always assembles into a scratch work dir and only then publishes it
+     * atomically — so the file must be created in the work dir while the value
+     * anyone later reads has to be the delivered destination. One field served both
+     * roles, so shipped fingerprints recorded a scratch path
+     * (`.dist-build-a1b2c3…`, or an OS temp dir) that no longer existed
+     * (2026-07-29 audit).
+     */
+    recordedOutputDir?: string;
     sourceDir?: string;
     args: Record<string, unknown>;
     pdfx: PdfxFingerprintConfig;

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

@@ -75,7 +75,7 @@ export declare function splitOutPath(outArg: string | undefined, format: BuildFo
  * variant that reaches different code, so no `--out` value can be deleted —
  * there is no code path that would do it.
  */
-export type PublishTarget = 
+type PublishTarget = 
 /** gutterpress's own `dist/<slug>/`. Replaced wholesale, so stale files vanish. */
 {
     kind: "project";
@@ -94,7 +94,27 @@ export type PublishTarget =
 export interface BuildContext {
     opts: BuildRunnerOptions;
     format: BuildFormat;
+    /**
+     * The directory the author pointed at (`gutterpress build <dir>`). Recorded in
+     * the build fingerprint as the source dir; NOT an anchor for resolving
+     * manifest-relative paths — see {@link BuildContext.renderDir}.
+     */
     inputDir: string;
+    /**
+     * THE anchor every manifest-relative path resolves against: `styles:`,
+     * `source.files`, authored plugin `path:` entries, and the lint gate's own
+     * stylesheet resolution. Equal to {@link BuildContext.manifestDir}.
+     *
+     * These used to resolve against two different roots in one build (2026-07-29
+     * audit): plugins, the lint gate, and the output dir anchored on
+     * `manifestDir`, while `styles:`/`source.files` anchored on `inputDir`. They
+     * are identical in the normative layout (the manifest lives in the book
+     * folder) and diverge only under an explicit `--manifest` pointing outside
+     * `--input` — where the docs are unambiguous that both are manifest-relative,
+     * so the lint gate was checking a different set of stylesheets than the ones
+     * that shipped.
+     */
+    renderDir: string;
     outDir: string;
     manifestDir: string;
     config: ReturnType<typeof resolveConfig>;

package/dist/lib/ghostscript.d.ts

@@ -17,15 +17,6 @@ export declare function resolveGhostscript(targetPlatform?: NodeJS.Platform, env
  */
 export declare function stripAnnotations(pdfPath: string, stagingDir: string): Promise<void>;
 type PdfxFlavor = "x1a" | "x3";
-/**
- * Generate the PostScript definition file for PDF/X output intent + GCR.
- */
-export declare function makePdfxDefPs(params: {
-    iccPath: string;
-    pdfx: PdfxFlavor;
-    title: string;
-    maxTac?: number;
-}): string;
 /**
  * Stamp the Creator metadata field on an existing PDF.
  *

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

@@ -4,6 +4,13 @@ export interface ProjectConfigFields {
     authors?: string[];
     /** `source.files` — the markdown inputs (null means "all chapter files"). */
     sourceFiles?: string[] | null;
+    /**
+     * `targets:` — the publish destinations this book is validated against
+     * (ADR 0008). An empty array is written as an explicit `targets: []`, the
+     * visible "no destination policies" opt-out; `undefined` in an update
+     * leaves the key untouched.
+     */
+    targets?: string[];
 }
 /**
  * Apply the author-facing manifest field updates in a single yaml round-trip.

package/dist/lib/manifest.d.ts

@@ -39,3 +39,11 @@ export declare function loadManifestWithPath(pathOrDir?: string, opts?: {
  * Any field explicitly set in `cliOverrides` wins, then manifest, then preset.
  */
 export declare function resolveConfig(cliOverrides: Partial<GutterpressManifest>, manifest: GutterpressManifest): ResolvedConfig;
+/**
+ * Resolve the config AS ONE PUBLISH TARGET SEES IT (ADR 0008): the target's
+ * policy overlay is merged onto the preset before the manifest merges over
+ * both, giving the single precedence chain cli > manifest > target > preset.
+ * The author's explicit manifest values always beat the target's policy —
+ * the same sovereignty rule presets follow.
+ */
+export declare function resolveConfigForTarget(cliOverrides: Partial<GutterpressManifest>, manifest: GutterpressManifest, targetId: string): ResolvedConfig;

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

@@ -37,12 +37,10 @@ export interface AssembleBookHtmlOptions {
     plugins?: LoadedPlugin[];
     pluginCss?: string;
     /**
-     * Add `data-chapter-src="<file>"` to the same source-mapped block elements
-     * that receive `data-source-line`. The historical option name is retained as
-     * public API, but no wrapper is emitted: even `display: contents` changes CSS
-     * selector relationships such as `body > *`, `:first-child`, and cross-file
-     * siblings, which can change pagination. Off by default; build output is
-     * unaffected.
+     * Wrap each source file in `<div class="gutterpress-chapter"
+     * data-chapter-src="<file>">`. Used only by incremental preview so one
+     * source can be paginated and replaced independently. Off by default; build
+     * output is unaffected.
      */
     wrapChapters?: boolean;
     /**

package/dist/lib/markdown/chapter-id.d.ts

@@ -5,7 +5,7 @@
  * boundary: project-root-relative, forward slashes, no `./` prefix, no
  * duplicate slashes. This single form is used by:
  *
- *   - preview source blocks' `data-chapter-src` tagging
+ *   - preview source wrappers' `data-chapter-src` tagging
  *     (lib/markdown/assemble.ts assembleBookHtml — index.ts's renderChapters
  *     is now just the thin node:fs wrapper around it)
  *   - preview source inspection and chapter-scoped scroll restoration

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

@@ -2,7 +2,6 @@ import { type LayoutWarning } from "./assemble";
 import { type AssetCopy } from "../asset-inline";
 import type { LoadedPlugin } from "./renderer";
 export type { LayoutWarning } from "./assemble";
-export { createMarkdownRenderer } from "./renderer";
 /**
  * THE canonical "which markdown files make up this book, and in what order?"
  * resolver — markdown's counterpart to `resolveActiveStyles` (style-resolver.ts).
@@ -38,7 +37,7 @@ export declare function renderChapters(inputDir: string, opts?: {
     files?: string[] | null;
     plugins?: LoadedPlugin[];
     pluginCss?: string;
-    /** Add chapter identity to source-mapped blocks for preview inspection. */
+    /** Wrap each source file for incremental preview pagination. */
     wrapChapters?: boolean;
     /**
      * ARCH finding #4: per-chapter author-mistake warnings computed by

package/dist/lib/npm-plugin-installer.d.ts

@@ -1,4 +1,4 @@
-export interface NpmPluginInstallLimits {
+interface NpmPluginInstallLimits {
     metadataBytes: number;
     packageTarballBytes: number;
     totalNetworkBytes: number;

package/dist/lib/output-paths.d.ts

@@ -10,7 +10,6 @@
  *
  * `--out` remains for per-invocation placement (CI, one-offs).
  */
-export declare const DIST_DIRNAME = "dist";
 /** The rendered book document. Fixed: the desktop and index.html load it by name. */
 export declare const BOOK_HTML = "book.html";
 /** Slug identifying one book. Falls back to `book` for an unsluggable title. */

package/dist/lib/pagination.d.ts

@@ -15,26 +15,6 @@ export interface ServerOverlay {
     body: string | Buffer;
     contentType: string;
 }
-/**
- * Start a localhost static file server rooted at `dir`, with optional in-memory
- * `overlays` keyed by URL path (e.g. `/book.html`).
- *
- * Overlays are what let the build paginate WITHOUT staging a second copy of the
- * project. `outDir` is served directly; the Paged.js-patched `book.html` and the
- * vendored polyfill are supplied from memory, so the engine never has to be
- * written into the shipped artifact and no asset is copied twice. This mirrors
- * the preview server, which has always served `/vendor/*` as a virtual overlay
- * rather than copying it per project.
- *
- * Path-traversal protection, the MIME map, and the actual file response are
- * the shared `./static-serve` primitives (`resolveStaticPath` + `serveFile`)
- * also used by preview/http-server.ts — a request that resolves outside `dir`
- * gets 403; a missing file gets 404 from `serveFile` itself.
- */
-export declare function createStaticFileServer(dir: string, defaultFile: string, overlays?: Record<string, ServerOverlay>): Promise<{
-    port: number;
-    close: () => Promise<void>;
-}>;
 /** Input handed to a PDF renderer: a URL serving the staged HTML + assets. */
 export interface PdfRenderInput {
     /** URL of the staged HTML on a local HTTP server (assets resolve relative). */

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

@@ -87,7 +87,7 @@ interface TextPass {
     }>;
 }
 export declare function getTextPass(doc: PDFDocumentProxy): Promise<TextPass>;
-export interface ImageRef {
+interface ImageRef {
     /** XObject resource name (or "(inline)" for inline images). */
     name: string;
     /** Rendered width/height on the page, in points (from the CTM). */
@@ -96,7 +96,7 @@ export interface ImageRef {
     /** 1-based page number. */
     page: number;
 }
-export interface FontRef {
+interface FontRef {
     name: string;
     embedded: boolean;
 }

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

@@ -25,7 +25,7 @@ export declare function parseInkCov(out: string): {
     k: number;
     sum: number;
 }[];
-export interface InkCoveragePage {
+interface InkCoveragePage {
     page: number;
     c: number;
     m: number;
@@ -55,3 +55,4 @@ export type InkCoverageResult = {
  * callers must surface the failure, not treat it as "0 pages measured".
  */
 export declare function getPerPageInkCoverage(pdfPath: string): Promise<InkCoverageResult>;
+export {};

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

@@ -22,8 +22,6 @@ interface PluginManagerInstallOptions extends NpmPluginInstallOptions {
     exportName?: string;
     __testFailBeforeManifestCommit?: () => void | Promise<void>;
 }
-/** Serialize all plugin filesystem + manifest mutations for one project. */
-export declare function withPluginMutationLock<T>(projectDir: string, mutation: () => Promise<T>): Promise<T>;
 /** Result of attempting to load one configured plugin. */
 export interface PluginValidationResult {
     ref: string;

package/dist/lib/presets.d.ts

@@ -1,5 +1,26 @@
 import type { ResolvedConfig } from "../schema/manifest.types";
-export type VendorPreset = Omit<ResolvedConfig, "title" | "authors">;
+/**
+ * A preset is HOW THE BOOK IS DESIGNED (ADR 0008): the base defaults for the
+ * resolved config, chiefly page/trim geometry, plus the publish targets a
+ * book of this kind validates against when the manifest lists none. Where
+ * the book is PUBLISHED is a separate concern — see ./targets.ts.
+ *
+ * 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"> {
+    /**
+     * Base page geometry in points, or `null` for `custom` — the one preset
+     * with no built-in trim, which therefore REQUIRES the manifest to supply
+     * `page.width` and `page.height` (resolveConfig enforces it).
+     */
+    page: ResolvedConfig["page"] | null;
+    /** Publish-target ids validated by default when the manifest has no `targets:`. */
+    defaultTargets: readonly string[];
+}
+/** The built-in preset ids, in the order pickers should offer them. */
+export declare const PRESET_IDS: readonly ["dtrpg", "book", "custom"];
+export type PresetId = (typeof PRESET_IDS)[number];
 export declare const DTRPG_PRESET: VendorPreset;
 /**
  * A neutral, vendor-agnostic default for authors who aren't targeting a
@@ -24,7 +45,14 @@ export declare const DTRPG_PRESET: VendorPreset;
  *   distribution.
  */
 export declare const BOOK_PRESET: VendorPreset;
-export declare const PRESETS: Record<string, VendorPreset>;
+/**
+ * `custom` — the author supplies the trim. Policy defaults are the neutral
+ * `book` ones (no vendor TAC cap, no PDF/X forcing); geometry is `null`, so
+ * resolveConfig demands explicit `page.width`/`page.height` (points) and
+ * errors, naming the missing fields, when they are absent.
+ */
+export declare const CUSTOM_PRESET: VendorPreset;
+export declare const PRESETS: Record<PresetId, VendorPreset>;
 export declare function warnOnce(id: string, message: string, sink?: (msg: string) => void): void;
 /** Test-only reset hook — clears all warn-once dedup state. */
 export declare function resetWarnOnce(): void;
@@ -32,11 +60,12 @@ export declare function resetWarnOnce(): void;
  * Resolve a manifest/CLI `preset` value to the {@link VendorPreset} it names
  * (UX finding M48).
  *
- * - Unset (`undefined`): defaults to `dtrpg` for backward compatibility —
- *   flipping the silent default to the new neutral `book` preset would change
- *   output geometry (trim size, TAC cap, PDF/X forcing) for every existing
- *   preset-less project. Emits a one-line warning instead so authors notice
- *   and choose explicitly; a future major version may change the default.
+ * - Unset (`undefined`): defaults to `dtrpg`. That is the PRODUCT default,
+ *   not a compatibility accident (ADR 0008): Gutterpress's primary audience
+ *   is TTRPG authors producing print-on-demand content, and a preset-less
+ *   manifest should come out print-ready for DriveThruRPG. Creation flows
+ *   always write an explicit `preset:`, so this only applies to
+ *   hand-written manifests — a one-line notice says which default applied.
  * - Unknown (typo'd) value: throws a {@link UsageError} naming the known
  *   presets, instead of silently falling back to `dtrpg` — the previous
  *   behavior turned a typo'd `preset: a4` into 621x810pt DriveThruRPG

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

@@ -1,10 +1,11 @@
+import { type PresetId } from "./presets.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
  * into the binary via `embedded-assets.ts`. `"book"` is the default; the others
  * give non-technical authors a head start for common formats (#29).
  */
-export type ProjectTemplateId = "book" | "ttrpg" | "zine" | "technical";
+export type ProjectTemplateId = "book" | "zine" | "technical";
 /**
  * How (or whether) to put the new project under local version history.
  *
@@ -40,9 +41,45 @@ export interface CreateProjectOptions {
      * author picks a saved/imported template.
      */
     templateDir?: string;
+    /**
+     * Which vendor preset the new book is designed for (ADR 0008). REQUIRED
+     * when scaffolding a built-in template — creation flows make the author
+     * choose; the resolveConfig dtrpg fallback exists for hand-written
+     * manifests, not for tooling. Written into the generated manifest as an
+     * explicit `preset:` line. Ignored with `templateDir`: a saved template's
+     * manifest carries its preset as part of the captured design.
+     */
+    preset?: PresetId;
+    /**
+     * Publish-target ids written into the generated manifest as an explicit
+     * `targets:` list (ADR 0008). Defaults to the chosen preset's
+     * `defaultTargets`; pass `[]` to opt out of every destination policy
+     * (e.g. when the tools a destination's checks need aren't installed).
+     * Like `preset`, the creation flow always records the choice explicitly —
+     * the preset-derived fallback exists for hand-written manifests only.
+     * Ignored with `templateDir` (the saved template's manifest is kept).
+     */
+    targets?: string[];
+    /**
+     * Page geometry written into the generated manifest (points; 72pt = 1in).
+     * REQUIRED when `preset` is `"custom"` (it has no built-in trim); allowed
+     * with any preset to override its trim. These are the validation bounds
+     * the built PDF is checked against — the actual trim comes from the
+     * stylesheet's `@page` rule, and the two should match.
+     */
+    customPage?: CustomPageOptions;
     /** 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;
+}
 /** The result of a successful scaffold. */
 export interface CreateProjectResult {
     /** Absolute path of the created project directory. */
@@ -68,7 +105,7 @@ export interface CreateProjectResult {
  * message and the CLI can choose an exit code. Scaffolding is fail-fast and
  * NEVER deletes or overwrites anything that already exists.
  */
-export type CreateProjectErrorCode = "parent-not-writable" | "target-exists" | "invalid-name" | "scaffold-io";
+export type CreateProjectErrorCode = "parent-not-writable" | "target-exists" | "invalid-name" | "preset-required" | "custom-page-required" | "invalid-targets" | "scaffold-io";
 export interface CreateProjectError extends Error {
     code: CreateProjectErrorCode;
 }

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

@@ -65,15 +65,6 @@ export interface ProjectCapabilities {
     canRestoreSnapshot: boolean;
     authManagedByApp: boolean;
 }
-/**
- * The remote a project syncs against: `origin` when one exists, else the first
- * remote. Pure pick over a `listRemotes` result — see {@link syncRemoteFor}
- * for the I/O helper detection and the sync transport share.
- */
-export declare function pickSyncRemote<T extends {
-    remote: string;
-    url?: string;
-}>(remotes: T[]): T | undefined;
 /**
  * THE one answer to "which remote does this repo sync against, and what's its
  * URL" — shared by detection (`detectProjectSource`) and the sync transport
@@ -123,6 +114,17 @@ export declare function repoSubPath(repoRoot: string, folderPath: string): strin
  * `hasRemote: false`). Never returns `managed-github`.
  */
 export declare function detectProjectSource(folderPath: string): Promise<ProjectSource>;
+/**
+ * The repository root a project's git operations act on, or `fallbackDir` when
+ * the project has no repo. THE one answer to "given a classified source, what
+ * repo does its snapshot/sync/log belong to" (R9: a project is its git repo) —
+ * so callers stop re-deriving `source.type === "local-git-folder" ?
+ * source.repoRoot : dir` inline (it was hand-rolled, and double-cast to an
+ * ad-hoc `{ type?; repoRoot? }` in two SvelteKit routes that lacked the type).
+ * A `managed-github` source (never produced by {@link detectProjectSource})
+ * has no local repo root either, so it also falls back. Pure; no I/O.
+ */
+export declare function repoRootForSource(source: ProjectSource, fallbackDir: string): string;
 /**
  * Map a {@link ProjectSource} to the actions the UI may offer. Pure; no I/O.
  *

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

@@ -1,5 +1,5 @@
 /** The built-in templates shipped as embedded assets. */
-export declare const BUILT_IN_TEMPLATE_IDS: readonly ["book", "ttrpg", "zine", "technical"];
+export declare const BUILT_IN_TEMPLATE_IDS: readonly ["book", "zine", "technical"];
 /** Author-friendly metadata for one template (built-in or custom). */
 export interface TemplateInfo {
     /** Stable id. For built-ins, the {@link ProjectTemplateId}; for custom, a slug. */
@@ -12,9 +12,36 @@ export interface TemplateInfo {
     kind: "builtin" | "custom";
     /** For custom templates: absolute directory the files live in. */
     dir?: string;
+    /**
+     * The `preset:` this template's manifest declares (ADR 0008), when it has
+     * one. Creation flows use it as the starting point for the preset choice —
+     * the template says what kind of book it is, so choosing one seeds
+     * everything under it.
+     */
+    preset?: string;
+    /** The `targets:` this template's manifest declares, when it has one. */
+    targets?: string[];
 }
-/** List the built-in templates (metadata only — no fs access). */
+/**
+ * List the built-in templates. The `preset`/`targets` each one starts a book
+ * from are read from that template's own embedded manifest — one source of
+ * truth, so changing a template's manifest changes what the wizard offers.
+ */
 export declare function listBuiltInTemplates(): Promise<TemplateInfo[]>;
+/**
+ * What to do with manifest references that point OUTSIDE the captured book — a
+ * repo-nested book's `../../shared/...` styles and authored plugins, which
+ * would dangle once the template is scaffolded somewhere else.
+ *
+ *  - `"vendor"` (default): copy the referenced files — for a stylesheet, its
+ *    whole `@import`/`url()` closure — INTO the template book-local, preserving
+ *    the layout so the CSS's own relative refs still resolve, and rewrite the
+ *    manifest entries to the book-local paths. Keeps the look; the template is
+ *    a self-contained fork of the shared design at save time.
+ *  - `"exclude"`: drop the escaping entries (copy nothing), leaving a
+ *    book-local-only template.
+ */
+export type SharedRefMode = "vendor" | "exclude";
 export interface SaveProjectAsTemplateOptions {
     /** Absolute path of the project to capture. */
     projectDir: string;
@@ -22,15 +49,26 @@ export interface SaveProjectAsTemplateOptions {
     name: string;
     /** Absolute directory custom templates are stored under. */
     templatesRoot: string;
+    /** How to handle out-of-book (`../../shared/...`) refs. Defaults to `"vendor"`. */
+    sharedRefs?: SharedRefMode;
+}
+/** The outcome of reconciling a captured book's out-of-book manifest refs. */
+export interface SharedRefOutcome {
+    /** Book-local paths the escaping refs were vendored to (`"vendor"` mode). */
+    vendoredRefs: string[];
+    /** Manifest entries dropped because they pointed outside the book (`"exclude"` mode). */
+    excludedRefs: string[];
 }
 /**
  * Capture an existing project as a reusable custom template. Copies the whole
- * project tree (minus build/VCS dirs) into `<templatesRoot>/<slug(name)>/`, then
- * re-tokenises the project's title back to `{{TITLE}}` in the manifest so the
- * saved template scaffolds cleanly for the next book. Refuses to overwrite an
- * existing template directory (never deletes user data).
+ * project tree (minus build/VCS dirs) into `<templatesRoot>/<slug(name)>/`,
+ * reconciles any out-of-book (`../../shared/...`) refs so the template is
+ * portable ({@link SharedRefMode} — vendor by default), then re-tokenises the
+ * project's title back to `{{TITLE}}` in the manifest so the saved template
+ * scaffolds cleanly for the next book. Refuses to overwrite an existing
+ * template directory (never deletes user data).
  */
-export declare function saveProjectAsTemplate(options: SaveProjectAsTemplateOptions): Promise<TemplateInfo>;
+export declare function saveProjectAsTemplate(options: SaveProjectAsTemplateOptions): Promise<TemplateInfo & SharedRefOutcome>;
 /**
  * List custom templates saved under `templatesRoot`. Returns `[]` when the root
  * doesn't exist. Each subdirectory is a template; its label comes from the

package/dist/lib/publish/providers/azure-swa.d.ts

@@ -1,3 +1,2 @@
 import { type PublishProvider } from "../types.ts";
-export declare const AZURE_SWA_HOST = "azure-swa";
 export declare const azureSwaProvider: PublishProvider;

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

@@ -1,5 +1,4 @@
 import { type PublishProvider } from "../types.ts";
-export declare const ITCH_HOST = "itch.io";
 /** `user/game` → the public project page URL. */
 export declare function itchProjectUrl(target: string): string;
 export declare const itchProvider: PublishProvider;

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

@@ -1,5 +1,4 @@
 import { type PublishProvider } from "../types.ts";
-export declare const SHOPIFY_HOST = "shopify";
 /** `gid://shopify/Product/123` → `123` (for admin deep links). */
 export declare function shopifyLegacyId(gid: string): string;
 export declare const shopifyProvider: PublishProvider;