gutterpress 0.10.6 → 0.10.7-beta.1

package/README.md

@@ -133,9 +133,10 @@ The full configuration cascade is `CLI flags > manifest.yaml > preset defaults`.
 
 ## Commands
 
-Gutterpress has 10 subcommands. `new`, `preview`, `build`, and `publish` are the
+Gutterpress has 11 subcommands. `new`, `preview`, `build`, and `publish` are the
 primary author commands; `lint`, `validate`, `audit`, and `preflight` are
-CI / advanced checks; and `doctor` reports system readiness. `plugin` manages project plugins. Every
+CI / advanced checks; and `doctor` reports system readiness. `plugin` manages
+project plugins and `theme` manages project themes. Every
 command also accepts `--help` for the authoritative, always-current flag list
 (`gutterpress <command> --help`) — this section is regenerated from the same
 source.
@@ -349,6 +350,73 @@ gutterpress plugin add markdown-it-highlightjs@4.3.0 ./my-book
 gutterpress plugin add markdown-it-emoji@3.0.0 ./my-book --export full
 ```
 
+### `gutterpress theme`
+
+List, apply, import, revert, or remove project themes — the same
+`applyTheme`/`importThemeFrom*`/`revertTheme`/`removeProjectTheme` functions
+the desktop app's Theme panel calls, so a theme applied from the terminal is
+just as switchable/revertible as one applied from the GUI.
+
+```sh
+gutterpress theme
+
+  --help    Show theme subcommands
+```
+
+#### `gutterpress theme list`
+
+List the built-in themes, the themes already vendored into this project
+(`themes/<id>/`), and which one (if any) is active.
+
+```sh
+gutterpress theme list ./my-book
+```
+
+#### `gutterpress theme apply`
+
+Apply a theme: a built-in id (`clean-book`, `zine`, `technical-doc`) is copied
+into `themes/<id>/` the first time, and the manifest's `styles:` entry is
+wired so its `theme.css` is the active stylesheet, keeping its cascade
+position. Re-running `apply` with an id that is already a project theme makes
+it active again without forking a second copy — the same non-destructive
+re-apply guarantee the desktop's Theme panel relies on.
+
+```sh
+gutterpress theme apply clean-book ./my-book
+gutterpress theme apply zine ./my-book
+```
+
+#### `gutterpress theme import`
+
+Import a theme from a local folder, a `.zip` package, a `.css` file, or an
+`http(s)` URL. Importing vendors the theme under `themes/<id>/` but does not
+apply it — follow up with `gutterpress theme apply <id>`.
+
+```sh
+gutterpress theme import ./my-theme-folder ./my-book
+gutterpress theme import ./my-theme.zip ./my-book
+gutterpress theme import ./my-theme.css ./my-book
+gutterpress theme import https://example.com/themes/cool/ ./my-book
+```
+
+#### `gutterpress theme revert`
+
+Re-apply the theme that was active immediately before the current one.
+Reverting twice toggles back — it is a swap, not a history stack.
+
+```sh
+gutterpress theme revert ./my-book
+```
+
+#### `gutterpress theme remove`
+
+Remove a project theme (never a built-in). If it was the active theme, its
+manifest `styles:` entry is dropped too, leaving no theme active.
+
+```sh
+gutterpress theme remove zine ./my-book
+```
+
 ## Exit codes
 
 Every command follows the same exit-code contract, so CI can branch on the result without parsing output:
@@ -360,7 +428,7 @@ Every command follows the same exit-code contract, so CI can branch on the resul
 | `2` | Usage — the invocation itself was wrong: a bad flag, positional argument, preset, or value. |
 | `3` | Pipeline — the build/render/export pipeline itself failed for a reason unrelated to usage or findings (I/O error, missing tool, renderer crash). |
 
-This applies uniformly across `build`, `preview`, `lint`, `validate`, `preflight`, `audit`, `publish`, `plugin`, `new`, and `doctor`.
+This applies uniformly across `build`, `preview`, `lint`, `validate`, `preflight`, `audit`, `publish`, `plugin`, `theme`, `new`, and `doctor`.
 
 ## Plugins
 

package/dist/api/index.d.ts

@@ -33,7 +33,7 @@ export { extractVariables, substituteVariables, listSnippets, readSnippet, saveS
 export type { SnippetEntry } from "../lib/snippets.ts";
 export { listProjectPlugins, setPluginEnabled, addLocalPlugin, addNpmPlugin, validateProjectPlugins, RECOMMENDED_PLUGINS, PLUGINS_DIR, } from "../lib/plugin-manager.ts";
 export type { ProjectPluginEntry, PluginValidationResult, RecommendedPlugin, PluginKind, } from "../lib/plugin-manager.ts";
-export { listBuiltInThemes, resolveBuiltInTheme, listProjectThemes, getActiveTheme, applyTheme, importThemeFromFolder, importThemeFromUrl, readThemeCss, removeProjectTheme, getPreviousTheme, revertTheme, BUILT_IN_THEME_IDS, THEMES_DIR, } from "../lib/theme-manager.ts";
+export { listBuiltInThemes, resolveBuiltInTheme, listProjectThemes, getActiveTheme, applyTheme, importThemeFromFolder, importThemeFromUrl, readThemeCss, removeProjectTheme, getPreviousTheme, revertTheme, detectLegacyForkedTheme, BUILT_IN_THEME_IDS, THEMES_DIR, } from "../lib/theme-manager.ts";
 export type { ThemeInfo, ThemeMetadata, ResolvedTheme, ApplyThemeTarget, BuiltInThemeId, } from "../lib/theme-manager.ts";
 export { importThemeFromFile } from "../lib/theme-import.ts";
 export type { ThemeImportResult, ThemeImportWarning } from "../lib/theme-import.ts";

package/dist/api/index.js

@@ -37,6 +37,7 @@ import {
   connectPublishProvider,
   defaultConfigDir,
   deleteSnippet,
+  detectLegacyForkedTheme,
   diagnoseProjectRemote,
   disconnectPublishCredential,
   escapeYamlScalar,
@@ -106,12 +107,12 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectPlugins
-} from "../index-1rcfsx67.js";
+} from "../index-9zf8mtk7.js";
 import {
   BuildError,
   DEFAULT_PRINT_OPTS,
   readyProbeExpr
-} from "../index-k5hcp8wj.js";
+} from "../index-837htyjy.js";
 import {
   AUTO_SNAPSHOT_MESSAGE,
   HISTORY_PAGE_LIMIT,
@@ -208,6 +209,7 @@ export {
   disconnectPublishCredential,
   diagnoseProjectRemote,
   detectProjectSource,
+  detectLegacyForkedTheme,
   deleteSnippet,
   defaultConfigDir,
   connectPublishProvider,

package/dist/{audit-0a4sp2w5.js → audit-82jr4qhw.js}

@@ -1,15 +1,15 @@
 import {
   executeAndReport
-} from "./cli-kwt5ftvc.js";
+} from "./cli-w6h5zegm.js";
 import {
   log
-} from "./cli-m99hj80k.js";
+} from "./cli-mk1s46mx.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-he23vgjj.js";
-import"./cli-bwbs3qm4.js";
+} from "./cli-08psmhr5.js";
+import"./cli-s8q42x3r.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES

package/dist/{build-z53bbxtx.js → build-e53pjtez.js}

@@ -1,10 +1,10 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-kwt5ftvc.js";
+} from "./cli-w6h5zegm.js";
 import {
   log
-} from "./cli-m99hj80k.js";
+} from "./cli-mk1s46mx.js";
 import {
   UsageError,
   parseEngine,
@@ -12,8 +12,8 @@ import {
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-he23vgjj.js";
-import"./cli-bwbs3qm4.js";
+} from "./cli-08psmhr5.js";
+import"./cli-s8q42x3r.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError

package/dist/checks/source/css-ownership.d.ts

@@ -0,0 +1,43 @@
+import type { Check } from "../types";
+/** One file's rules in the contract. Every key is optional — a file entry
+ * with none of these is legal (and pointless) but never an error. */
+export interface CssContractFileRules {
+    /**
+     * Closed allow-list for this file's TOP-LEVEL content only (direct children
+     * of the stylesheet root — deliberately not recursive into `@media`/
+     * `@supports`, keeping this a check on the file's own flat structure, not a
+     * search through every possible nesting). A plain entry (e.g. ":root")
+     * matches a top-level rule's selector, trimmed, exactly. An `@`-prefixed
+     * entry (e.g. "@font-face") matches a top-level at-rule's name. Anything
+     * else at the top level is a violation.
+     */
+    allow?: string[];
+    /** Property names (case-insensitive) that must never be declared anywhere
+     * in this file, independent of any ownership claim below. */
+    "forbid-properties"?: string[];
+    /**
+     * Property names this file exclusively owns. Checked project-wide: ANY
+     * OTHER css file passed to this check (whether or not that file has its
+     * own contract entry) that declares one of these properties is flagged —
+     * the whole point being that a collision can appear in a file nobody
+     * thought to annotate.
+     */
+    "owns-properties"?: string[];
+    /** Same mechanism as `owns-properties`, keyed by at-rule name (without the
+     * leading `@`, e.g. "page" for `@page`). */
+    "owns-at-rules"?: string[];
+    /**
+     * Regex source strings (case-insensitive). A rule is flagged when one of
+     * its comma-separated selector branches matches a pattern AND nothing
+     * precedes the match in that branch — i.e. the matched class/pattern is the
+     * outermost compound selector, with no page/chapter/section ancestor
+     * qualifying it. `.page .dc-callout` is scoped and passes; a bare
+     * `.dc-callout` does not.
+     */
+    "forbid-unscoped-selectors"?: string[];
+}
+export interface CssContract {
+    files?: Record<string, CssContractFileRules>;
+}
+declare const check: Check;
+export default check;

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

@@ -1,6 +1,7 @@
 import "./markdownlint";
 import "./htmlhint";
 import "./stylelint";
+import "./css-ownership";
 import "./local-refs";
 import "./accessibility-alt-text";
 import "./accessibility-heading-order";

package/dist/{cli-he23vgjj.js → cli-08psmhr5.js}

@@ -4,7 +4,7 @@ import {
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.10.6",
+  version: "0.10.7-beta.1",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -105,6 +105,9 @@ var package_default = {
   }
 };
 
+// src/lib/cli-args.ts
+import { resolve } from "node:path";
+
 // src/constants.ts
 var NETWORK = {
   DEFAULT_PORT: 3579
@@ -273,5 +276,15 @@ function resolvePort(raw) {
   }
   return n;
 }
+function exitForUsage(error) {
+  if (error instanceof UsageError) {
+    console.error(error.message);
+    process.exit(error.exitCode);
+  }
+  throw error;
+}
+function resolveProjectDir(dir) {
+  return resolve(typeof dir === "string" && dir ? dir : process.cwd());
+}
 
-export { package_default, DEBOUNCE, UsageError, rejectUnknownFlags, rejectExtraPositionals, parseFormat, parsePdfxFlavor, parseEngine, resolvePort };
+export { package_default, DEBOUNCE, UsageError, rejectUnknownFlags, rejectExtraPositionals, parseFormat, parsePdfxFlavor, parseEngine, resolvePort, exitForUsage, resolveProjectDir };

package/dist/{cli-m99hj80k.js → cli-mk1s46mx.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-he23vgjj.js";
+} from "./cli-08psmhr5.js";
 import {
   execCapture,
   findTool,

package/dist/{cli-bwbs3qm4.js → cli-s8q42x3r.js}

@@ -1430,7 +1430,7 @@ import { fileURLToPath } from "node:url";
 var favicon_default = "./favicon-wkbm9cjn.ico";
 
 // src/assets/manifest.schema.json
-var manifest_schema_default = "./manifest.schema-hn6ac0ae.json";
+var manifest_schema_default = "./manifest.schema-kwnrwv8b.json";
 
 // src/assets/preview/scripts/preview-interface.js
 var preview_interface_default = "./preview-interface-9rwz21yw.js";