@ai-matrx/print 0.5.10 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,58 @@
 # Changelog
 
+## 0.6.1
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/print/v0.5.10..npm/print/v0.6.1 -- apps/shared/print`).
+No source changes intended and no consumer action required.
+
+## 0.6.0
+
+- **Added: page breaks.** A line that is exactly `<!-- pagebreak -->`
+  (canonical), `<!-- page-break -->`, `<!-- newpage -->`, `\pagebreak`,
+  `\newpage`, or a Typora-style `<div style="page-break-after: always"></div>`
+  starts a new printed page. On screen it draws a dashed rule labelled
+  "Page break"; in print it is a real `break-after: page`. Both skins emit the
+  same `.matrx-page-break` element.
+- **Added: `@ai-matrx/print/directives`** — the zero-dependency page-break
+  grammar (`isPageBreakLine`, `splitAtPageBreaks`, `PAGE_BREAK_MARKDOWN`,
+  `PAGE_BREAK_CLASS`, `PAGE_BREAK_LABEL`) for any surface that renders
+  markdown, so the chat preview and the printers share one definition.
+- **Added:** `markdownToPdfBlob` honours page breaks — every section after a
+  break starts on a new PDF page (the canvas lane ignores CSS breaks, so the
+  content is captured per section).
+- **Fixed:** `<artifact type id version title>…</artifact>` blocks pasted their
+  raw body into the output — a full HTML artifact injected its own `<html>`,
+  `<head>`, `<style>` and `<script>` into the host page, and the emphasis pass
+  rewrote `*` inside the script, so the script threw. Artifacts now render as a
+  titled panel: source-code types (html, react, svg, mermaid, diff, code) and
+  JSON bodies print as escaped source; markdown bodies convert in the same skin.
+- **Fixed:** the document skin ran emphasis, lists and paragraphs inside fenced
+  and inline code (`1*2*3` became `1<em>2</em>3`). Code is now protected and
+  escaped in both skins; `~~~` fences and indented fences are recognised.
+- **Fixed:** page-level markup outside a fence (`<script>`, `<style>`, `<head>`,
+  the `<html>`/`<body>` shell) is removed — paired regions whole, stray tags
+  alone, repeated until stable so a split tag cannot reassemble — and raw HTML
+  loses `on…` handlers, `srcdoc`, and script-scheme URLs (entity-obfuscated
+  forms included). Announced once via the new `html-stripped` notice with the
+  remedy. Inline code is protected first, so prose about tags survives.
+- **Fixed:** emphasis follows the CommonMark intraword rule (`snake_case_name`
+  stays literal); a bullet that opens with bold stays a bullet; bold/code
+  inside link text renders; URLs with one level of parentheses parse.
+- **Parity (both skins now handle the same markdown):** GFM task lists print as
+  real boxes, `~~strikethrough~~`, table column alignment (`:-:`, `--:`) and
+  empty cells (they used to shift columns left), the chat's `***` accent and
+  `#===` heavy dividers, nested lists in the article skin, and `<flashcards>`
+  in the article skin (printed as question/answer pairs).
+- **Print polish:** table header rows repeat on every page and rows never
+  split; long code lines wrap instead of being cut off; headings stay with the
+  content that follows; page margins are set; pages are numbered "3 / 12"
+  (bottom centre) — `getMarkdownStylesheet({ pageNumbers: false })` turns the
+  numbering off. New `MARKDOWN_SHARED_CSS` / `MARKDOWN_PAGE_CSS` exports.
+- Consumer action: none — refresh to latest. `stripDecorativeLineBreaks`-style
+  host regexes should match `class="matrx-hr…"` (accent/heavy rules add a
+  second class).
+
 ## 0.5.10
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/README.md

@@ -137,6 +137,20 @@ it by passing `tokens: ":root{--matrx-print-accent:#0f766e}"` — appended last,
 so the host wins. Both sheets carry the print hard parts (`@media print`,
 page-break avoidance, orphans/widows, `print-color-adjust`).
 
+### `@ai-matrx/print/directives` — page breaks, one grammar everywhere
+
+```ts
+import { isPageBreakLine, splitAtPageBreaks, PAGE_BREAK_MARKDOWN } from "@ai-matrx/print/directives";
+```
+
+Put `<!-- pagebreak -->` on its own line to start a new printed page
+(`\pagebreak`, `\newpage`, `<!-- newpage -->` and
+`<div style="page-break-after: always"></div>` are accepted too). Both
+converters render it as `<div class="matrx-page-break">` — a dashed "Page
+break" rule on screen, a real page break on paper — and `markdownToPdfBlob`
+starts a new PDF page there. The entry has no dependencies, so a chat or editor
+renderer can recognise the same syntax without loading the stylesheets.
+
 ### `@ai-matrx/print/pdf` — DOM capture & markdown → PDF
 
 ```ts

package/dist/directives.cjs

@@ -0,0 +1,66 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/directives.ts
+var directives_exports = {};
+__export(directives_exports, {
+  PAGE_BREAK_CLASS: () => PAGE_BREAK_CLASS,
+  PAGE_BREAK_LABEL: () => PAGE_BREAK_LABEL,
+  PAGE_BREAK_MARKDOWN: () => PAGE_BREAK_MARKDOWN,
+  isPageBreakLine: () => isPageBreakLine,
+  splitAtPageBreaks: () => splitAtPageBreaks
+});
+module.exports = __toCommonJS(directives_exports);
+var PAGE_BREAK_MARKDOWN = "<!-- pagebreak -->";
+var PAGE_BREAK_CLASS = "matrx-page-break";
+var PAGE_BREAK_LABEL = "Page break";
+var COMMENT_FORM = /^<!--\s*(?:page[\s_-]?break|new[\s_-]?page)\s*-->$/i;
+var LATEX_FORM = /^\\(?:pagebreak|newpage|clearpage)\s*(?:\{\s*\})?$/i;
+var DIV_FORM = /^<div\b([^>]*)>\s*<\/div>$|^<div\b([^>]*)\/>$/i;
+var DIV_BREAK_ATTR = /(?:page-break-(?:after|before)\s*:\s*always|break-(?:after|before)\s*:\s*page|class\s*=\s*["'](?:[^"']*\s)?page-?break(?:\s[^"']*)?["'])/i;
+function isPageBreakLine(line) {
+  const t = line.trim();
+  if (t.length < 8 || t.length > 200) return false;
+  if (COMMENT_FORM.test(t) || LATEX_FORM.test(t)) return true;
+  const div = DIV_FORM.exec(t);
+  if (!div) return false;
+  return DIV_BREAK_ATTR.test(div[1] ?? div[2] ?? "");
+}
+function splitAtPageBreaks(markdown) {
+  const lines = markdown.split(/\r?\n/);
+  const pieces = [];
+  let current = [];
+  let fence = null;
+  for (const line of lines) {
+    const fenceMatch = /^\s*(`{3,}|~{3,})/.exec(line);
+    if (fenceMatch) {
+      const marker = fenceMatch[1];
+      if (fence === null) fence = marker;
+      else if (marker[0] === fence[0] && marker.length >= fence.length) fence = null;
+    } else if (fence === null && isPageBreakLine(line)) {
+      if (current.join("\n").trim()) pieces.push(current.join("\n"));
+      current = [];
+      continue;
+    }
+    current.push(line);
+  }
+  if (current.join("\n").trim() || pieces.length === 0) pieces.push(current.join("\n"));
+  return pieces;
+}
+//# sourceMappingURL=directives.cjs.map

package/dist/directives.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/directives.ts"],"sourcesContent":["/**\n * @ai-matrx/print/directives — the ONE definition of the print directives\n * markdown can carry, shared by every surface that reads markdown.\n *\n * Why a separate, zero-dependency entry: the directive syntax has three\n * readers — this package's two converters (print window / PDF / HTML page),\n * the chat renderer's remark plugin (the on-screen preview), and any editor\n * that inserts one. If each re-derived the regex they would drift the first\n * time someone added an alias. `/markdown` carries ~20KB of stylesheet, so the\n * chat bundle imports the syntax from here instead and pays nothing.\n *\n * ── Page break ────────────────────────────────────────────────────────────\n * A line that is exactly one of these (case-insensitive, surrounding\n * whitespace ignored) forces the next content onto a new printed page:\n *\n *   <!-- pagebreak -->          ← canonical; invisible in any other renderer\n *   <!-- page-break -->   <!-- page break -->   <!-- newpage -->\n *   \\pagebreak   \\newpage       ← LaTeX / pandoc habit\n *   <div style=\"page-break-after: always\"></div>   ← Typora / VS Code habit\n *   (also `page-break-before`, `break-after: page`, `break-before: page`,\n *    and `<div class=\"page-break\"></div>` / `class=\"pagebreak\"`)\n *\n * On screen every surface draws the same idea: a dashed rule labelled\n * \"Page break\" with generous padding. In print it is a zero-height element\n * with `break-after: page`.\n */\n\n/** The form editors insert and docs recommend. */\nexport const PAGE_BREAK_MARKDOWN = \"<!-- pagebreak -->\";\n\n/** The class every surface puts on a rendered page break. */\nexport const PAGE_BREAK_CLASS = \"matrx-page-break\";\n\n/** Screen label for a rendered page break. */\nexport const PAGE_BREAK_LABEL = \"Page break\";\n\nconst COMMENT_FORM = /^<!--\\s*(?:page[\\s_-]?break|new[\\s_-]?page)\\s*-->$/i;\nconst LATEX_FORM = /^\\\\(?:pagebreak|newpage|clearpage)\\s*(?:\\{\\s*\\})?$/i;\nconst DIV_FORM = /^<div\\b([^>]*)>\\s*<\\/div>$|^<div\\b([^>]*)\\/>$/i;\nconst DIV_BREAK_ATTR =\n  /(?:page-break-(?:after|before)\\s*:\\s*always|break-(?:after|before)\\s*:\\s*page|class\\s*=\\s*[\"'](?:[^\"']*\\s)?page-?break(?:\\s[^\"']*)?[\"'])/i;\n\n/** Is this single line a page-break directive? */\nexport function isPageBreakLine(line: string): boolean {\n  const t = line.trim();\n  if (t.length < 8 || t.length > 200) return false;\n  if (COMMENT_FORM.test(t) || LATEX_FORM.test(t)) return true;\n  const div = DIV_FORM.exec(t);\n  if (!div) return false;\n  return DIV_BREAK_ATTR.test(div[1] ?? div[2] ?? \"\");\n}\n\n/**\n * Split markdown into the pieces that belong on separate pages. Fence-aware:\n * a directive inside a ``` / ~~~ code block is code, not a break. Always\n * returns at least one piece; empty pieces (two breaks in a row, a break at\n * the very start or end) are kept out so no blank page is produced.\n */\nexport function splitAtPageBreaks(markdown: string): string[] {\n  const lines = markdown.split(/\\r?\\n/);\n  const pieces: string[] = [];\n  let current: string[] = [];\n  let fence: string | null = null;\n\n  for (const line of lines) {\n    // Any indent — the converters accept list-nested fences, so must this.\n    const fenceMatch = /^\\s*(`{3,}|~{3,})/.exec(line);\n    if (fenceMatch) {\n      const marker = fenceMatch[1] as string;\n      if (fence === null) fence = marker;\n      else if (marker[0] === fence[0] && marker.length >= fence.length) fence = null;\n    } else if (fence === null && isPageBreakLine(line)) {\n      if (current.join(\"\\n\").trim()) pieces.push(current.join(\"\\n\"));\n      current = [];\n      continue;\n    }\n    current.push(line);\n  }\n  if (current.join(\"\\n\").trim() || pieces.length === 0) pieces.push(current.join(\"\\n\"));\n  return pieces;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4BO,IAAM,sBAAsB;AAG5B,IAAM,mBAAmB;AAGzB,IAAM,mBAAmB;AAEhC,IAAM,eAAe;AACrB,IAAM,aAAa;AACnB,IAAM,WAAW;AACjB,IAAM,iBACJ;AAGK,SAAS,gBAAgB,MAAuB;AACrD,QAAM,IAAI,KAAK,KAAK;AACpB,MAAI,EAAE,SAAS,KAAK,EAAE,SAAS,IAAK,QAAO;AAC3C,MAAI,aAAa,KAAK,CAAC,KAAK,WAAW,KAAK,CAAC,EAAG,QAAO;AACvD,QAAM,MAAM,SAAS,KAAK,CAAC;AAC3B,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,eAAe,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE;AACnD;AAQO,SAAS,kBAAkB,UAA4B;AAC5D,QAAM,QAAQ,SAAS,MAAM,OAAO;AACpC,QAAM,SAAmB,CAAC;AAC1B,MAAI,UAAoB,CAAC;AACzB,MAAI,QAAuB;AAE3B,aAAW,QAAQ,OAAO;AAExB,UAAM,aAAa,oBAAoB,KAAK,IAAI;AAChD,QAAI,YAAY;AACd,YAAM,SAAS,WAAW,CAAC;AAC3B,UAAI,UAAU,KAAM,SAAQ;AAAA,eACnB,OAAO,CAAC,MAAM,MAAM,CAAC,KAAK,OAAO,UAAU,MAAM,OAAQ,SAAQ;AAAA,IAC5E,WAAW,UAAU,QAAQ,gBAAgB,IAAI,GAAG;AAClD,UAAI,QAAQ,KAAK,IAAI,EAAE,KAAK,EAAG,QAAO,KAAK,QAAQ,KAAK,IAAI,CAAC;AAC7D,gBAAU,CAAC;AACX;AAAA,IACF;AACA,YAAQ,KAAK,IAAI;AAAA,EACnB;AACA,MAAI,QAAQ,KAAK,IAAI,EAAE,KAAK,KAAK,OAAO,WAAW,EAAG,QAAO,KAAK,QAAQ,KAAK,IAAI,CAAC;AACpF,SAAO;AACT;","names":[]}

package/dist/directives.d.cts

@@ -0,0 +1,43 @@
+/**
+ * @ai-matrx/print/directives — the ONE definition of the print directives
+ * markdown can carry, shared by every surface that reads markdown.
+ *
+ * Why a separate, zero-dependency entry: the directive syntax has three
+ * readers — this package's two converters (print window / PDF / HTML page),
+ * the chat renderer's remark plugin (the on-screen preview), and any editor
+ * that inserts one. If each re-derived the regex they would drift the first
+ * time someone added an alias. `/markdown` carries ~20KB of stylesheet, so the
+ * chat bundle imports the syntax from here instead and pays nothing.
+ *
+ * ── Page break ────────────────────────────────────────────────────────────
+ * A line that is exactly one of these (case-insensitive, surrounding
+ * whitespace ignored) forces the next content onto a new printed page:
+ *
+ *   <!-- pagebreak -->          ← canonical; invisible in any other renderer
+ *   <!-- page-break -->   <!-- page break -->   <!-- newpage -->
+ *   \pagebreak   \newpage       ← LaTeX / pandoc habit
+ *   <div style="page-break-after: always"></div>   ← Typora / VS Code habit
+ *   (also `page-break-before`, `break-after: page`, `break-before: page`,
+ *    and `<div class="page-break"></div>` / `class="pagebreak"`)
+ *
+ * On screen every surface draws the same idea: a dashed rule labelled
+ * "Page break" with generous padding. In print it is a zero-height element
+ * with `break-after: page`.
+ */
+/** The form editors insert and docs recommend. */
+declare const PAGE_BREAK_MARKDOWN = "<!-- pagebreak -->";
+/** The class every surface puts on a rendered page break. */
+declare const PAGE_BREAK_CLASS = "matrx-page-break";
+/** Screen label for a rendered page break. */
+declare const PAGE_BREAK_LABEL = "Page break";
+/** Is this single line a page-break directive? */
+declare function isPageBreakLine(line: string): boolean;
+/**
+ * Split markdown into the pieces that belong on separate pages. Fence-aware:
+ * a directive inside a ``` / ~~~ code block is code, not a break. Always
+ * returns at least one piece; empty pieces (two breaks in a row, a break at
+ * the very start or end) are kept out so no blank page is produced.
+ */
+declare function splitAtPageBreaks(markdown: string): string[];
+
+export { PAGE_BREAK_CLASS, PAGE_BREAK_LABEL, PAGE_BREAK_MARKDOWN, isPageBreakLine, splitAtPageBreaks };

package/dist/directives.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @ai-matrx/print/directives — the ONE definition of the print directives
+ * markdown can carry, shared by every surface that reads markdown.
+ *
+ * Why a separate, zero-dependency entry: the directive syntax has three
+ * readers — this package's two converters (print window / PDF / HTML page),
+ * the chat renderer's remark plugin (the on-screen preview), and any editor
+ * that inserts one. If each re-derived the regex they would drift the first
+ * time someone added an alias. `/markdown` carries ~20KB of stylesheet, so the
+ * chat bundle imports the syntax from here instead and pays nothing.
+ *
+ * ── Page break ────────────────────────────────────────────────────────────
+ * A line that is exactly one of these (case-insensitive, surrounding
+ * whitespace ignored) forces the next content onto a new printed page:
+ *
+ *   <!-- pagebreak -->          ← canonical; invisible in any other renderer
+ *   <!-- page-break -->   <!-- page break -->   <!-- newpage -->
+ *   \pagebreak   \newpage       ← LaTeX / pandoc habit
+ *   <div style="page-break-after: always"></div>   ← Typora / VS Code habit
+ *   (also `page-break-before`, `break-after: page`, `break-before: page`,
+ *    and `<div class="page-break"></div>` / `class="pagebreak"`)
+ *
+ * On screen every surface draws the same idea: a dashed rule labelled
+ * "Page break" with generous padding. In print it is a zero-height element
+ * with `break-after: page`.
+ */
+/** The form editors insert and docs recommend. */
+declare const PAGE_BREAK_MARKDOWN = "<!-- pagebreak -->";
+/** The class every surface puts on a rendered page break. */
+declare const PAGE_BREAK_CLASS = "matrx-page-break";
+/** Screen label for a rendered page break. */
+declare const PAGE_BREAK_LABEL = "Page break";
+/** Is this single line a page-break directive? */
+declare function isPageBreakLine(line: string): boolean;
+/**
+ * Split markdown into the pieces that belong on separate pages. Fence-aware:
+ * a directive inside a ``` / ~~~ code block is code, not a break. Always
+ * returns at least one piece; empty pieces (two breaks in a row, a break at
+ * the very start or end) are kept out so no blank page is produced.
+ */
+declare function splitAtPageBreaks(markdown: string): string[];
+
+export { PAGE_BREAK_CLASS, PAGE_BREAK_LABEL, PAGE_BREAK_MARKDOWN, isPageBreakLine, splitAtPageBreaks };

package/dist/directives.js

@@ -0,0 +1,45 @@
+// src/directives.ts
+var PAGE_BREAK_MARKDOWN = "<!-- pagebreak -->";
+var PAGE_BREAK_CLASS = "matrx-page-break";
+var PAGE_BREAK_LABEL = "Page break";
+var COMMENT_FORM = /^<!--\s*(?:page[\s_-]?break|new[\s_-]?page)\s*-->$/i;
+var LATEX_FORM = /^\\(?:pagebreak|newpage|clearpage)\s*(?:\{\s*\})?$/i;
+var DIV_FORM = /^<div\b([^>]*)>\s*<\/div>$|^<div\b([^>]*)\/>$/i;
+var DIV_BREAK_ATTR = /(?:page-break-(?:after|before)\s*:\s*always|break-(?:after|before)\s*:\s*page|class\s*=\s*["'](?:[^"']*\s)?page-?break(?:\s[^"']*)?["'])/i;
+function isPageBreakLine(line) {
+  const t = line.trim();
+  if (t.length < 8 || t.length > 200) return false;
+  if (COMMENT_FORM.test(t) || LATEX_FORM.test(t)) return true;
+  const div = DIV_FORM.exec(t);
+  if (!div) return false;
+  return DIV_BREAK_ATTR.test(div[1] ?? div[2] ?? "");
+}
+function splitAtPageBreaks(markdown) {
+  const lines = markdown.split(/\r?\n/);
+  const pieces = [];
+  let current = [];
+  let fence = null;
+  for (const line of lines) {
+    const fenceMatch = /^\s*(`{3,}|~{3,})/.exec(line);
+    if (fenceMatch) {
+      const marker = fenceMatch[1];
+      if (fence === null) fence = marker;
+      else if (marker[0] === fence[0] && marker.length >= fence.length) fence = null;
+    } else if (fence === null && isPageBreakLine(line)) {
+      if (current.join("\n").trim()) pieces.push(current.join("\n"));
+      current = [];
+      continue;
+    }
+    current.push(line);
+  }
+  if (current.join("\n").trim() || pieces.length === 0) pieces.push(current.join("\n"));
+  return pieces;
+}
+export {
+  PAGE_BREAK_CLASS,
+  PAGE_BREAK_LABEL,
+  PAGE_BREAK_MARKDOWN,
+  isPageBreakLine,
+  splitAtPageBreaks
+};
+//# sourceMappingURL=directives.js.map

package/dist/directives.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/directives.ts"],"sourcesContent":["/**\n * @ai-matrx/print/directives — the ONE definition of the print directives\n * markdown can carry, shared by every surface that reads markdown.\n *\n * Why a separate, zero-dependency entry: the directive syntax has three\n * readers — this package's two converters (print window / PDF / HTML page),\n * the chat renderer's remark plugin (the on-screen preview), and any editor\n * that inserts one. If each re-derived the regex they would drift the first\n * time someone added an alias. `/markdown` carries ~20KB of stylesheet, so the\n * chat bundle imports the syntax from here instead and pays nothing.\n *\n * ── Page break ────────────────────────────────────────────────────────────\n * A line that is exactly one of these (case-insensitive, surrounding\n * whitespace ignored) forces the next content onto a new printed page:\n *\n *   <!-- pagebreak -->          ← canonical; invisible in any other renderer\n *   <!-- page-break -->   <!-- page break -->   <!-- newpage -->\n *   \\pagebreak   \\newpage       ← LaTeX / pandoc habit\n *   <div style=\"page-break-after: always\"></div>   ← Typora / VS Code habit\n *   (also `page-break-before`, `break-after: page`, `break-before: page`,\n *    and `<div class=\"page-break\"></div>` / `class=\"pagebreak\"`)\n *\n * On screen every surface draws the same idea: a dashed rule labelled\n * \"Page break\" with generous padding. In print it is a zero-height element\n * with `break-after: page`.\n */\n\n/** The form editors insert and docs recommend. */\nexport const PAGE_BREAK_MARKDOWN = \"<!-- pagebreak -->\";\n\n/** The class every surface puts on a rendered page break. */\nexport const PAGE_BREAK_CLASS = \"matrx-page-break\";\n\n/** Screen label for a rendered page break. */\nexport const PAGE_BREAK_LABEL = \"Page break\";\n\nconst COMMENT_FORM = /^<!--\\s*(?:page[\\s_-]?break|new[\\s_-]?page)\\s*-->$/i;\nconst LATEX_FORM = /^\\\\(?:pagebreak|newpage|clearpage)\\s*(?:\\{\\s*\\})?$/i;\nconst DIV_FORM = /^<div\\b([^>]*)>\\s*<\\/div>$|^<div\\b([^>]*)\\/>$/i;\nconst DIV_BREAK_ATTR =\n  /(?:page-break-(?:after|before)\\s*:\\s*always|break-(?:after|before)\\s*:\\s*page|class\\s*=\\s*[\"'](?:[^\"']*\\s)?page-?break(?:\\s[^\"']*)?[\"'])/i;\n\n/** Is this single line a page-break directive? */\nexport function isPageBreakLine(line: string): boolean {\n  const t = line.trim();\n  if (t.length < 8 || t.length > 200) return false;\n  if (COMMENT_FORM.test(t) || LATEX_FORM.test(t)) return true;\n  const div = DIV_FORM.exec(t);\n  if (!div) return false;\n  return DIV_BREAK_ATTR.test(div[1] ?? div[2] ?? \"\");\n}\n\n/**\n * Split markdown into the pieces that belong on separate pages. Fence-aware:\n * a directive inside a ``` / ~~~ code block is code, not a break. Always\n * returns at least one piece; empty pieces (two breaks in a row, a break at\n * the very start or end) are kept out so no blank page is produced.\n */\nexport function splitAtPageBreaks(markdown: string): string[] {\n  const lines = markdown.split(/\\r?\\n/);\n  const pieces: string[] = [];\n  let current: string[] = [];\n  let fence: string | null = null;\n\n  for (const line of lines) {\n    // Any indent — the converters accept list-nested fences, so must this.\n    const fenceMatch = /^\\s*(`{3,}|~{3,})/.exec(line);\n    if (fenceMatch) {\n      const marker = fenceMatch[1] as string;\n      if (fence === null) fence = marker;\n      else if (marker[0] === fence[0] && marker.length >= fence.length) fence = null;\n    } else if (fence === null && isPageBreakLine(line)) {\n      if (current.join(\"\\n\").trim()) pieces.push(current.join(\"\\n\"));\n      current = [];\n      continue;\n    }\n    current.push(line);\n  }\n  if (current.join(\"\\n\").trim() || pieces.length === 0) pieces.push(current.join(\"\\n\"));\n  return pieces;\n}\n"],"mappings":";AA4BO,IAAM,sBAAsB;AAG5B,IAAM,mBAAmB;AAGzB,IAAM,mBAAmB;AAEhC,IAAM,eAAe;AACrB,IAAM,aAAa;AACnB,IAAM,WAAW;AACjB,IAAM,iBACJ;AAGK,SAAS,gBAAgB,MAAuB;AACrD,QAAM,IAAI,KAAK,KAAK;AACpB,MAAI,EAAE,SAAS,KAAK,EAAE,SAAS,IAAK,QAAO;AAC3C,MAAI,aAAa,KAAK,CAAC,KAAK,WAAW,KAAK,CAAC,EAAG,QAAO;AACvD,QAAM,MAAM,SAAS,KAAK,CAAC;AAC3B,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,eAAe,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE;AACnD;AAQO,SAAS,kBAAkB,UAA4B;AAC5D,QAAM,QAAQ,SAAS,MAAM,OAAO;AACpC,QAAM,SAAmB,CAAC;AAC1B,MAAI,UAAoB,CAAC;AACzB,MAAI,QAAuB;AAE3B,aAAW,QAAQ,OAAO;AAExB,UAAM,aAAa,oBAAoB,KAAK,IAAI;AAChD,QAAI,YAAY;AACd,YAAM,SAAS,WAAW,CAAC;AAC3B,UAAI,UAAU,KAAM,SAAQ;AAAA,eACnB,OAAO,CAAC,MAAM,MAAM,CAAC,KAAK,OAAO,UAAU,MAAM,OAAQ,SAAQ;AAAA,IAC5E,WAAW,UAAU,QAAQ,gBAAgB,IAAI,GAAG;AAClD,UAAI,QAAQ,KAAK,IAAI,EAAE,KAAK,EAAG,QAAO,KAAK,QAAQ,KAAK,IAAI,CAAC;AAC7D,gBAAU,CAAC;AACX;AAAA,IACF;AACA,YAAQ,KAAK,IAAI;AAAA,EACnB;AACA,MAAI,QAAQ,KAAK,IAAI,EAAE,KAAK,KAAK,OAAO,WAAW,EAAG,QAAO,KAAK,QAAQ,KAAK,IAAI,CAAC;AACpF,SAAO;AACT;","names":[]}

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @ai-matrx/print — root entry: TYPES ONLY.\n *\n * The runtime lives in the subpaths (each import-inert, RSC-safe except\n * /react which is a client entry):\n *   @ai-matrx/print/core        BlockPrinter contract + print-window composition\n *   @ai-matrx/print/qr          QR generation + e-commerce payload builders\n *   @ai-matrx/print/labels      label-sheet engine (templates, formats, print/PDF)\n *   @ai-matrx/print/flashcards  the deck printer (10 variants)\n *   @ai-matrx/print/pdf         DOM-capture / markdown → PDF\n *   @ai-matrx/print/markdown    the shipped markdown converter + print stylesheets\n *   @ai-matrx/print/barcode     1-D barcodes (Code128 / EAN-13 / UPC-A)\n *   @ai-matrx/print/booklet     saddle-stitch imposition + 2-up print lane\n *   @ai-matrx/print/qr-styled   branded/logo QR (browser-only at call time)\n *   @ai-matrx/print/react       PrintOptionsDialog + LabelSheetPreview\n */\n\nexport type {\n  BlockPrinter,\n  PrintVariant,\n  PrintSetting,\n  PrintSettings,\n  PrintOutcome,\n} from \"./core\";\n\nexport type { QrEcLevel, QrOptions } from \"./qr\";\n\nexport type {\n  LabelTemplate,\n  QrLabel,\n  QrLabelPrintData,\n  QrLabelSettings,\n  ScannabilityReport,\n  LabelField,\n  LabelElement,\n  LabelFormat,\n} from \"./labels\";\n\nexport type { Flashcard, FlashcardsVariant } from \"./flashcards\";\n\nexport type {\n  DomCaptureOptions,\n  MarkdownPdfDeps,\n  MarkdownPdfNotice,\n} from \"./pdf\";\n\nexport type {\n  MarkdownSkin,\n  MarkdownNotice,\n  MarkdownToHtmlOptions,\n  MarkdownStylesheetOptions,\n  RenderMarkdownDocumentOptions,\n  PrintMarkdownOptions,\n} from \"./markdown\";\n\nexport type { BarcodeSymbology, BarcodeOptions } from \"./barcode\";\n\nexport type {\n  BookletSheet,\n  BookletImposition,\n  BookletPrintOptions,\n} from \"./booklet\";\n\nexport type {\n  StyledQrOptions,\n  StyledQrEcLevel,\n  StyledQrDotStyle,\n  StyledQrCornerStyle,\n} from \"./qr-styled\";\n\nexport type {\n  CheatSheetData,\n  CheatSheetSection,\n  CheatSheetItem,\n  GlossaryData,\n  GlossaryEntry,\n  StudyCalendarData,\n  StudyWeek,\n  StudyDay,\n} from \"./education\";\n\nexport type {\n  PracticeTestData,\n  ExamQuestion,\n  ExamChoice,\n  PracticeTestVariant,\n} from \"./exam\";\n\nexport type {\n  CertificateData,\n  SignatureLine,\n  CertificateVariant,\n  WorkbookSpec,\n  WorkbookSection,\n} from \"./certificate\";\n\nexport type { ZplDpi, ZplOptions } from \"./zpl\";\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @ai-matrx/print — root entry: TYPES ONLY.\n *\n * The runtime lives in the subpaths (each import-inert, RSC-safe except\n * /react which is a client entry):\n *   @ai-matrx/print/core        BlockPrinter contract + print-window composition\n *   @ai-matrx/print/qr          QR generation + e-commerce payload builders\n *   @ai-matrx/print/labels      label-sheet engine (templates, formats, print/PDF)\n *   @ai-matrx/print/flashcards  the deck printer (10 variants)\n *   @ai-matrx/print/pdf         DOM-capture / markdown → PDF\n *   @ai-matrx/print/markdown    the shipped markdown converter + print stylesheets\n *   @ai-matrx/print/directives  the page-break grammar every markdown surface shares\n *   @ai-matrx/print/barcode     1-D barcodes (Code128 / EAN-13 / UPC-A)\n *   @ai-matrx/print/booklet     saddle-stitch imposition + 2-up print lane\n *   @ai-matrx/print/qr-styled   branded/logo QR (browser-only at call time)\n *   @ai-matrx/print/react       PrintOptionsDialog + LabelSheetPreview\n */\n\nexport type {\n  BlockPrinter,\n  PrintVariant,\n  PrintSetting,\n  PrintSettings,\n  PrintOutcome,\n} from \"./core\";\n\nexport type { QrEcLevel, QrOptions } from \"./qr\";\n\nexport type {\n  LabelTemplate,\n  QrLabel,\n  QrLabelPrintData,\n  QrLabelSettings,\n  ScannabilityReport,\n  LabelField,\n  LabelElement,\n  LabelFormat,\n} from \"./labels\";\n\nexport type { Flashcard, FlashcardsVariant } from \"./flashcards\";\n\nexport type {\n  DomCaptureOptions,\n  MarkdownPdfDeps,\n  MarkdownPdfNotice,\n} from \"./pdf\";\n\nexport type {\n  MarkdownSkin,\n  MarkdownNotice,\n  MarkdownToHtmlOptions,\n  MarkdownStylesheetOptions,\n  RenderMarkdownDocumentOptions,\n  PrintMarkdownOptions,\n} from \"./markdown\";\n\nexport type { BarcodeSymbology, BarcodeOptions } from \"./barcode\";\n\nexport type {\n  BookletSheet,\n  BookletImposition,\n  BookletPrintOptions,\n} from \"./booklet\";\n\nexport type {\n  StyledQrOptions,\n  StyledQrEcLevel,\n  StyledQrDotStyle,\n  StyledQrCornerStyle,\n} from \"./qr-styled\";\n\nexport type {\n  CheatSheetData,\n  CheatSheetSection,\n  CheatSheetItem,\n  GlossaryData,\n  GlossaryEntry,\n  StudyCalendarData,\n  StudyWeek,\n  StudyDay,\n} from \"./education\";\n\nexport type {\n  PracticeTestData,\n  ExamQuestion,\n  ExamChoice,\n  PracticeTestVariant,\n} from \"./exam\";\n\nexport type {\n  CertificateData,\n  SignatureLine,\n  CertificateVariant,\n  WorkbookSpec,\n  WorkbookSection,\n} from \"./certificate\";\n\nexport type { ZplDpi, ZplOptions } from \"./zpl\";\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/index.d.cts

@@ -11,3 +11,4 @@ export { CheatSheetData, CheatSheetItem, CheatSheetSection, GlossaryData, Glossa
 export { ExamChoice, ExamQuestion, PracticeTestData, PracticeTestVariant } from './exam.cjs';
 export { CertificateData, CertificateVariant, SignatureLine, WorkbookSection, WorkbookSpec } from './certificate.cjs';
 export { ZplDpi, ZplOptions } from './zpl.cjs';
+import './directives.cjs';

package/dist/index.d.ts

@@ -11,3 +11,4 @@ export { CheatSheetData, CheatSheetItem, CheatSheetSection, GlossaryData, Glossa
 export { ExamChoice, ExamQuestion, PracticeTestData, PracticeTestVariant } from './exam.js';
 export { CertificateData, CertificateVariant, SignatureLine, WorkbookSection, WorkbookSpec } from './certificate.js';
 export { ZplDpi, ZplOptions } from './zpl.js';
+import './directives.js';