gutterpress 0.10.6 → 0.10.7-beta.1

package/dist/{new-sawc7zh4.js → new-78j4mx60.js}

@@ -5,16 +5,16 @@ import {
   TARGETS,
   TARGET_IDS,
   scaffoldProject
-} from "./cli-kwt5ftvc.js";
+} from "./cli-w6h5zegm.js";
 import {
   resolveGhostscript
-} 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 {
   isToolAvailable
 } from "./cli-c41yr7he.js";

package/dist/{plugin-p8yghztz.js → plugin-rahnkax3.js}

@@ -1,14 +1,15 @@
 import {
   addNpmPlugin,
   parseNpmPluginSpec
-} from "./cli-kwt5ftvc.js";
-import"./cli-m99hj80k.js";
+} from "./cli-w6h5zegm.js";
+import"./cli-mk1s46mx.js";
 import {
   UsageError,
+  exitForUsage,
   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
@@ -39,13 +40,6 @@ var pluginAddArgs = {
   }
 };
 var parentArgs = {};
-function exitForUsage(error) {
-  if (error instanceof UsageError) {
-    console.error(error.message);
-    process.exit(error.exitCode);
-  }
-  throw error;
-}
 function rejectParentFlags(rawArgs) {
   if (rawArgs[0] === "add" || rawArgs[0] === undefined || !rawArgs[0].startsWith("-")) {
     return;

package/dist/{preflight-48kwf2pm.js → preflight-qdmqf3j6.js}

@@ -2,16 +2,16 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} 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/{preview-10r4dk3d.js → preview-yekma94n.js}

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

package/dist/{publish-cd05sbdx.js → publish-tm2rqyme.js}

@@ -11,17 +11,17 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-kwt5ftvc.js";
+} from "./cli-w6h5zegm.js";
 import {
   FileTokenStore,
   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/render.js

@@ -280,7 +280,6 @@ function plugin(md, pluginOptions = {}) {
       return;
     scanForMistypedMarkers(state);
     const out = [];
-    setDepth(state.env, 0);
     const stack = {
       frames: [],
       get(kind) {
@@ -375,7 +374,7 @@ function plugin(md, pluginOptions = {}) {
       const t = new state.Token("layout_section_open", "div", 1);
       addClasses(t, "section", meta.attrs && meta.attrs.class ? meta.attrs.class : "");
       attachDataAttrs(t, "section", meta.name, meta.attrs || {});
-      t.meta = { hasColumnBreak: false, line: meta.__line };
+      t.meta = { line: meta.__line };
       stack.open({
         kind: "section",
         classes: meta.attrs && meta.attrs.class || "",
@@ -487,13 +486,6 @@ function plugin(md, pluginOptions = {}) {
       }
       if (kind === "column-break") {
         warnBreakInsideGrid("column-break", line, meta);
-        const openSectionFrame = stack.get("section");
-        if (openSectionFrame && openSectionFrame.openToken && !openSectionFrame.openToken.meta.hasColumnBreak) {
-          const sectionCls = openSectionFrame.openToken.attrGet("class") || "";
-          if (sectionCls.includes("col-split")) {
-            openSectionFrame.openToken.meta.hasColumnBreak = true;
-          }
-        }
         const t = new state.Token("layout_column_break", "div", 0);
         t.meta = { line };
         t.attrSet("class", "gp-column-break");
@@ -514,43 +506,6 @@ function plugin(md, pluginOptions = {}) {
     stack.closeAll();
     state.tokens = out;
   });
-  function getDepth(env) {
-    return env && env.__colSplitDepth || 0;
-  }
-  function setDepth(env, n) {
-    if (env)
-      env.__colSplitDepth = n;
-  }
-  md.renderer.rules.layout_chapter_open = (tokens, idx, opts, env, self) => {
-    setDepth(env, 0);
-    return self.renderToken(tokens, idx, opts);
-  };
-  md.renderer.rules.layout_page_open = (tokens, idx, opts, env, self) => {
-    setDepth(env, 0);
-    return self.renderToken(tokens, idx, opts);
-  };
-  md.renderer.rules.layout_section_open = (tokens, idx, opts, env, self) => {
-    const token = tokens[idx];
-    const cls = token.attrGet("class") || "";
-    if (cls.includes("col-split") && token.meta && token.meta.hasColumnBreak) {
-      setDepth(env, getDepth(env) + 1);
-      const rangeAttr = token.attrGet("data-source-range");
-      const rangeHtml = rangeAttr ? ` data-source-range="${escapeAttr(rangeAttr)}"` : "";
-      const chapterAttr = token.attrGet("data-chapter-src");
-      const chapterHtml = chapterAttr ? ` data-chapter-src="${escapeAttr(chapterAttr)}"` : "";
-      return `<div class="${escapeAttr(cls)}"${rangeHtml}${chapterHtml}><div class="col">
-`;
-    }
-    return self.renderToken(tokens, idx, opts);
-  };
-  md.renderer.rules.layout_section_close = (tokens, idx, opts, env, self) => {
-    if (getDepth(env) > 0) {
-      setDepth(env, getDepth(env) - 1);
-      return `</div></div>
-`;
-    }
-    return self.renderToken(tokens, idx, opts);
-  };
   md.renderer.rules.layout_page_break = (tokens, idx) => {
     const cls = tokens[idx].attrGet("class") || "gp-page-break";
     const rangeAttr = tokens[idx].attrGet("data-source-range");
@@ -560,11 +515,7 @@ function plugin(md, pluginOptions = {}) {
     return `<div class="${escapeAttr(cls)}" aria-hidden="true"${rangeHtml}${chapterHtml}></div>
 `;
   };
-  md.renderer.rules.layout_column_break = (tokens, idx, opts, env) => {
-    if (getDepth(env) > 0) {
-      return `</div><div class="col">
-`;
-    }
+  md.renderer.rules.layout_column_break = (tokens, idx) => {
     const cls = tokens[idx].attrGet("class") || "gp-column-break";
     const rangeAttr = tokens[idx].attrGet("data-source-range");
     const rangeHtml = rangeAttr ? ` data-source-range="${escapeAttr(rangeAttr)}"` : "";
@@ -814,6 +765,55 @@ img.gp-shape {
 .gp-base   { z-index: var(--gp-z-base); }
 .gp-raised { z-index: var(--gp-z-raised); }
 .gp-front  { z-index: var(--gp-z-front); }
+
+/* GFM-style alert/callout boxes (#237) — the DOM gfm-alerts.ts emits from
+   "> [!TYPE]" blockquote syntax when a project opts into the bundled
+   gutterpress-gfm-alerts feature (BUILTIN_OPTIONAL_PLUGINS, renderer.ts).
+   The plugin is optional and inert by default; these rules are equally
+   inert wherever the classes never appear, exactly like every other
+   utility above, so shipping them costs nothing to a book that has not
+   turned the feature on.
+
+   This is authored-COMPONENT vocabulary, not the @marker structural family
+   (markers.js/MARKER_CSS) — CLAUDE.md §6 splits the two core CSS blocks by
+   ROLE, and an author-facing box an author invokes via inline syntax is the
+   same role as every other gp-* utility here, not page/chapter/section DOM.
+
+   Deliberately minimal (CLAUDE.md "thin over capable" / the issue's own
+   "a rule and a label"): a left border plus a bold label, :where()'d to
+   zero specificity so a theme's own (unlayered) rule for any of these
+   classes wins outright regardless of selector weight — see the
+   cascade-layers note atop this file. Five semantic accent colors (the same
+   NOTE/TIP/IMPORTANT/WARNING/CAUTION hues GitHub's own alerts use — a
+   long-established, non-proprietary convention, not DC branding) are
+   exposed as :root custom properties, the same author-settable-surface
+   pattern as the --gp-z-* ladder above: a book retints every alert of one
+   type by overriding a single property, no specificity fight required.
+   --gp-alert-color cascades from the type modifier down to .gp-alert-title
+   through ordinary CSS inheritance (the title is always a DOM descendant of
+   the box), so it is set in exactly five places, not ten. */
+:root {
+  --gp-alert-note-color: #0969da;
+  --gp-alert-tip-color: #1a7f37;
+  --gp-alert-important-color: #8250df;
+  --gp-alert-warning-color: #9a6700;
+  --gp-alert-caution-color: #cf222e;
+}
+:where(.gp-alert) {
+  margin: 1em 0;
+  padding: 0.5em 1em;
+  border-left: 0.25em solid var(--gp-alert-color, currentColor);
+}
+:where(.gp-alert-title) {
+  margin: 0 0 0.5em;
+  font-weight: bold;
+  color: var(--gp-alert-color, inherit);
+}
+:where(.gp-alert-note)      { --gp-alert-color: var(--gp-alert-note-color); }
+:where(.gp-alert-tip)       { --gp-alert-color: var(--gp-alert-tip-color); }
+:where(.gp-alert-important) { --gp-alert-color: var(--gp-alert-important-color); }
+:where(.gp-alert-warning)   { --gp-alert-color: var(--gp-alert-warning-color); }
+:where(.gp-alert-caution)   { --gp-alert-color: var(--gp-alert-caution-color); }
 `;
 var GP_CLASSES = new Set([
   "gp-left",
@@ -843,6 +843,13 @@ var GP_CLASSES = new Set([
   "gp-base",
   "gp-raised",
   "gp-front",
+  "gp-alert",
+  "gp-alert-title",
+  "gp-alert-note",
+  "gp-alert-tip",
+  "gp-alert-important",
+  "gp-alert-warning",
+  "gp-alert-caution",
   "gp-page-break",
   "gp-column-break",
   "gp-continued",
@@ -1002,6 +1009,101 @@ import markdownItSub from "markdown-it-sub";
 import markdownItSup from "markdown-it-sup";
 import markdownItAbbr from "markdown-it-abbr";
 
+// src/lib/markdown/gfm-alerts.ts
+var ALERT_LABELS = {
+  note: "Note",
+  tip: "Tip",
+  important: "Important",
+  warning: "Warning",
+  caution: "Caution"
+};
+var ALERT_MARKER = /^\[!(note|tip|important|warning|caution)\]\s*$/i;
+function isFiniteMap(map) {
+  return Array.isArray(map) && map.length === 2 && Number.isFinite(map[0]) && Number.isFinite(map[1]);
+}
+function blockToken(state, type, tag, nesting) {
+  const token = new state.Token(type, tag, nesting);
+  token.block = true;
+  return token;
+}
+var gfmAlertsRule = (state) => {
+  const tokens = state.tokens;
+  const newTokens = [];
+  for (let i = 0;i < tokens.length; i++) {
+    const tok = tokens[i];
+    if (tok.type !== "blockquote_open") {
+      newTokens.push(tok);
+      continue;
+    }
+    let depth = 0;
+    let closeIdx = -1;
+    for (let j = i;j < tokens.length; j++) {
+      const jt = tokens[j];
+      if (jt.type === "blockquote_open")
+        depth++;
+      else if (jt.type === "blockquote_close") {
+        depth--;
+        if (depth === 0) {
+          closeIdx = j;
+          break;
+        }
+      }
+    }
+    const markerParaOpen = tokens[i + 1];
+    const markerInline = tokens[i + 2];
+    const markerParaClose = tokens[i + 3];
+    const hasMarkerParagraph = closeIdx !== -1 && markerParaOpen?.type === "paragraph_open" && markerInline?.type === "inline" && markerParaClose?.type === "paragraph_close";
+    if (!hasMarkerParagraph) {
+      newTokens.push(tok);
+      continue;
+    }
+    const content = markerInline.content;
+    const newlineIdx = content.indexOf(`
+`);
+    const firstLine = newlineIdx === -1 ? content : content.slice(0, newlineIdx);
+    const match = ALERT_MARKER.exec(firstLine);
+    if (!match) {
+      newTokens.push(tok);
+      continue;
+    }
+    const type = match[1].toLowerCase();
+    const label = ALERT_LABELS[type];
+    const markerLine = isFiniteMap(tok.map) ? tok.map[0] + 1 : undefined;
+    const alertOpen = blockToken(state, "gp_alert_open", "div", 1);
+    alertOpen.attrSet("class", `gp-alert gp-alert-${type}`);
+    if (markerLine !== undefined)
+      alertOpen.meta = { line: markerLine };
+    newTokens.push(alertOpen);
+    const titleOpen = blockToken(state, "gp_alert_title_open", "p", 1);
+    titleOpen.attrSet("class", "gp-alert-title");
+    if (markerLine !== undefined)
+      titleOpen.meta = { line: markerLine };
+    newTokens.push(titleOpen);
+    const titleInline = new state.Token("inline", "", 0);
+    titleInline.content = label;
+    titleInline.children = [];
+    newTokens.push(titleInline);
+    newTokens.push(blockToken(state, "gp_alert_title_close", "p", -1));
+    const rest = newlineIdx === -1 ? "" : content.slice(newlineIdx + 1);
+    if (rest.trim() !== "") {
+      markerInline.content = rest;
+      if (isFiniteMap(markerParaOpen.map)) {
+        markerParaOpen.map = [markerParaOpen.map[0] + 1, markerParaOpen.map[1]];
+      }
+      newTokens.push(markerParaOpen, markerInline, markerParaClose);
+    }
+    for (let j = i + 4;j < closeIdx; j++) {
+      newTokens.push(tokens[j]);
+    }
+    newTokens.push(blockToken(state, "gp_alert_close", "div", -1));
+    i = closeIdx;
+  }
+  state.tokens = newTokens;
+};
+function gfmAlerts(md) {
+  md.core.ruler.after("block", "gp_gfm_alerts", gfmAlertsRule);
+}
+
 // src/lib/markdown/images.ts
 var isSrcsetSpace = (char) => char === "\t" || char === `
 ` || char === "\f" || char === "\r" || char === " ";
@@ -1423,7 +1525,8 @@ var BUILTIN_OPTIONAL_PLUGINS = {
   "markdown-it-mark": unwrapPlugin(markdownItMark),
   "markdown-it-sub": unwrapPlugin(markdownItSub),
   "markdown-it-sup": unwrapPlugin(markdownItSup),
-  "markdown-it-abbr": unwrapPlugin(markdownItAbbr)
+  "markdown-it-abbr": unwrapPlugin(markdownItAbbr),
+  "gutterpress-gfm-alerts": gfmAlerts
 };
 function createMarkdownRenderer(customPlugins) {
   const md = new MarkdownIt({

package/dist/schema/manifest.types.d.ts

@@ -6,6 +6,13 @@ export interface PluginConfig {
     version?: string;
     /** Named module export to use when the package has no default plugin export. */
     export?: string;
+    /**
+     * Load order (default 100). Higher loads first; built-in plugins always
+     * load before any user plugin regardless of this value. Advanced/rarely
+     * needed: a plugin needs the LOWER of two priorities to see tokens the
+     * other one produces, since it must load (and run) after it — see
+     * examples/gutterpress-user-guide/05-plugins.md#plugin-load-order.
+     */
     priority?: number;
     options?: Record<string, unknown>;
     /**
@@ -95,15 +102,13 @@ export interface GutterpressManifest {
     engine?: "paged" | "native";
     /**
      * Engine-conditional stylesheets, appended AFTER `styles`. `.native` is the
-     * only list that still applies; `.paged` is accepted-but-ignored (a warning
-     * fires if it has entries).
+     * only list this type declares; a manifest that still carries `.paged`
+     * (dual-engine era, pre-0.10.7) keeps parsing — `resolveConfig` reads it
+     * through a widened cast and warns once — but it is no longer part of the
+     * authored/autocompleted shape (see `manifest.schema.json`, which drops it
+     * too), since the native engine is the only engine.
      */
     engineStyles?: {
-        /**
-         * Accepted for backward-compatible manifest parsing only; entries here are
-         * ignored with a warning.
-         */
-        paged?: string[];
         native?: string[];
     };
     /**
@@ -156,6 +161,13 @@ export interface GutterpressManifest {
             markdownlint?: string | false;
             htmlhint?: string | false;
             stylelint?: string | false;
+            /**
+             * Path to a CSS ownership contract (#232), or `false` to disable
+             * `source.css-ownership`. Optional — absent means no contract, so the
+             * check reports nothing. Default discovery: `.gutterpress/css-contract.yaml`
+             * (or `.yml`) in the project root. See docs/css-ownership-contract.md.
+             */
+            cssOwnership?: string | false;
             /**
              * @deprecated `:::name` container syntax was removed 2026-05-17 and the
              * callout-validation check it gated was removed at the same time. This
@@ -259,6 +271,7 @@ export interface ResolvedConfig {
             markdownlint: string | false | null;
             htmlhint: string | false | null;
             stylelint: string | false | null;
+            cssOwnership: string | false | null;
         };
         assets: {
             maxImageSize: number;