@ai-matrx/print 0.5.10 → 0.6.0

package/dist/markdown.d.cts

@@ -1,4 +1,5 @@
 import { PrintOutcome } from './core.cjs';
+export { PAGE_BREAK_CLASS, PAGE_BREAK_MARKDOWN, isPageBreakLine, splitAtPageBreaks } from './directives.cjs';
 
 /**
  * Default print stylesheets for `@ai-matrx/print/markdown`.
@@ -35,6 +36,25 @@ declare const MARKDOWN_ARTICLE_TOKENS_CSS = ":root {\n    --matrx-print-accent:
 declare const MARKDOWN_DOCUMENT_CSS = "/* \n * MATRX WordPress CSS - Production Ready\n * Use this CSS in your WordPress theme to style MATRX content\n * All styles are scoped to .matrx-content-container to avoid conflicts\n */\n\n/* Content Container */\n.matrx-content-container {\n    max-width: 800px;\n    margin: 0 auto;\n    padding: 2rem;\n    line-height: 1.6;\n    font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;\n}\n\n/* Typography */\n.matrx-h1 {\n    font-size: 2.5rem;\n    font-weight: 700;\n    margin: 0 0 1.5rem 0;\n    color: var(--matrx-print-fg, #1a1a1a);\n    line-height: 1.2;\n}\n\n.matrx-h2 {\n    font-size: 1.8rem;\n    font-weight: 600;\n    margin: 3rem 0 1rem 0 !important;\n    color: var(--matrx-print-heading, #2a2a2a);\n    line-height: 1.3 !important;\n    border-bottom: 2px solid var(--matrx-print-border-strong, #e5e5e5);\n    padding-bottom: 0.75rem !important;\n    padding-top: 0 !important;\n}\n\n.matrx-h3 {\n    font-size: 1.3rem;\n    font-weight: 600;\n    margin: 2rem 0 1rem 0;\n    color: var(--matrx-print-heading-sub, #3a3a3a);\n    line-height: 1.4;\n}\n\n.matrx-h4 {\n    font-size: 1.1rem;\n    font-weight: 600;\n    margin: 1.5rem 0 0.75rem 0;\n    color: var(--matrx-print-heading-sub, #3a3a3a);\n    line-height: 1.4;\n}\n\n.matrx-h5 {\n    font-size: 1rem;\n    font-weight: 600;\n    margin: 1.25rem 0 0.5rem 0;\n    color: var(--matrx-print-heading-sub, #3a3a3a);\n    line-height: 1.4;\n}\n\n.matrx-h6 {\n    font-size: 0.9rem;\n    font-weight: 600;\n    margin: 1rem 0 0.5rem 0;\n    color: var(--matrx-print-heading-sub, #3a3a3a);\n    line-height: 1.4;\n}\n\n/* Paragraphs */\n.matrx-intro {\n    font-size: 1.1rem;\n    color: var(--matrx-print-fg-muted, #4a4a4a);\n    margin-bottom: 2rem;\n    padding: 1.5rem;\n    background: var(--matrx-print-surface, #f8f9fa);\n    border-left: 4px solid var(--matrx-print-border-muted, #d1d5db);\n    border-radius: 0 8px 8px 0;\n}\n\n.matrx-paragraph {\n    font-size: 1rem;\n    color: var(--matrx-print-fg-muted, #4a4a4a);\n    margin-bottom: 1.5rem;\n    text-align: justify;\n}\n\n/* Text Formatting */\n.matrx-em {\n    font-style: italic;\n    color: var(--matrx-print-heading, #2a2a2a);\n}\n\n.matrx-strong {\n    font-weight: 600;\n    color: var(--matrx-print-heading, #2a2a2a);\n}\n\n/* Links */\n.matrx-link {\n    color: var(--matrx-print-link-fg, #374151);\n    text-decoration: underline;\n    text-decoration-color: var(--matrx-print-border-muted, #d1d5db);\n    text-underline-offset: 3px;\n    transition: all 0.2s ease;\n}\n\n.matrx-link:hover {\n    color: var(--matrx-print-link-hover-fg, #1f2937);\n    text-decoration-color: var(--matrx-print-link-underline, #9ca3af);\n}\n\n/* Images */\n.matrx-image {\n    max-width: 100%;\n    height: auto;\n    display: block;\n    margin: 1.5rem auto;\n    border-radius: 8px;\n    box-shadow: 0 2px 8px var(--matrx-print-shadow, rgba(0, 0, 0, 0.1));\n}\n\n/* Lists */\n.matrx-list {\n    margin: 1.5rem 0;\n    padding-left: 0;\n}\n\n.matrx-bullet-list {\n    list-style: none;\n}\n\n.matrx-list-item {\n    margin-bottom: 1rem;\n    padding-left: 1.5rem;\n    position: relative;\n    color: var(--matrx-print-fg-muted, #4a4a4a);\n}\n\n.matrx-list-item::before {\n    content: \"\u2022\";\n    color: var(--matrx-print-fg-subtle, #6b7280);\n    font-weight: bold;\n    position: absolute;\n    left: 0;\n    top: 0;\n    font-size: 1.2rem;\n}\n\n/* Numbered Lists */\n.matrx-numbered-list {\n    list-style: decimal;\n    padding-left: 2rem;\n}\n\n.matrx-numbered-list > .matrx-list-item {\n    padding-left: 0.5rem;\n}\n\n.matrx-numbered-list > .matrx-list-item::before {\n    content: none;\n    /* Remove the bullet */\n}\n\n/* Nested list indentation */\n.matrx-nested-list {\n    margin-top: 0.5rem;\n    margin-bottom: 0.5rem;\n    padding-left: 1.5rem !important;\n}\n\n/* Ensure nested lists within list items are properly indented */\n.matrx-list-item > .matrx-list {\n    margin-top: 0.5rem;\n    margin-bottom: 0.5rem;\n    padding-left: 1.5rem;\n}\n\n/* For multiple levels of nesting, increase indentation */\n.matrx-nested-list .matrx-nested-list {\n    padding-left: 1.5rem !important;\n}\n\n/* Code */\n.matrx-content-container .matrx-inline-code {\n    background-color: var(--matrx-print-code-bg, #f5f5f5);\n    padding: 0.125rem 0.25rem;\n    border-radius: 0.25rem;\n    font-family: \"Monaco\", \"Menlo\", \"Ubuntu Mono\", monospace;\n    font-size: 0.875rem;\n    color: var(--matrx-print-code-fg, #d73a49);\n}\n\n.matrx-content-container .matrx-code-block {\n    background-color: var(--matrx-print-code-block-bg, #f8f8f8);\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n    border-radius: 0.375rem;\n    padding: 1rem;\n    margin: 1.5rem 0;\n    overflow-x: auto;\n}\n\n.matrx-content-container .matrx-code {\n    font-family: \"Monaco\", \"Menlo\", \"Ubuntu Mono\", monospace;\n    font-size: 0.875rem;\n    line-height: 1.5;\n    color: var(--matrx-print-code-block-fg, #333);\n}\n\n/* Blockquotes */\n.matrx-content-container .matrx-blockquote {\n    border-left: 4px solid var(--matrx-print-border, #e1e1e1);\n    padding-left: 1rem;\n    margin: 1.5rem 0;\n    font-style: italic;\n    color: var(--matrx-print-quote-fg, #666);\n}\n\n/* Tables */\n.matrx-content-container .matrx-table {\n    width: 100%;\n    border-collapse: collapse;\n    margin: 1.5rem 0;\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n}\n\n.matrx-content-container .matrx-table-header {\n    background-color: var(--matrx-print-surface, #f8f9fa);\n    font-weight: 600;\n    padding: 0.75rem;\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n    text-align: left;\n}\n\n.matrx-content-container .matrx-table-cell {\n    padding: 0.75rem;\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n}\n\n.matrx-content-container .matrx-table-row:nth-child(even) {\n    background-color: var(--matrx-print-surface, #f8f9fa);\n}\n\n/* Images */\n.matrx-content-container .matrx-image {\n    max-width: 100%;\n    height: auto;\n    border-radius: 0.375rem;\n    margin: 1rem 0;\n}\n\n/* Horizontal Rules */\n.matrx-content-container .matrx-hr {\n    border: none;\n    border-top: 1px solid var(--matrx-print-border, #e1e1e1);\n    margin: 2rem 0;\n}\n\n/* FAQ Styles - Clean Design */\n.matrx-faq-item {\n    margin-bottom: 2rem;\n    padding: 1.5rem;\n    background: var(--matrx-print-surface, #f8f9fa);\n    border-radius: 8px;\n    border-left: 4px solid var(--matrx-print-border-muted, #d1d5db);\n}\n\n.matrx-faq-question {\n    font-size: 1.2rem;\n    font-weight: 600;\n    margin: 0 0 0.75rem 0;\n    color: var(--matrx-print-heading, #2a2a2a);\n}\n\n.matrx-faq-answer {\n    margin: 0;\n    color: var(--matrx-print-fg-muted, #4a4a4a);\n    line-height: 1.6;\n}\n\n/* Code Blocks */\n.matrx-inline-code {\n    background-color: var(--matrx-print-code-bg, #f5f5f5);\n    padding: 0.125rem 0.25rem;\n    border-radius: 0.25rem;\n    font-family: \"Monaco\", \"Menlo\", \"Ubuntu Mono\", monospace;\n    font-size: 0.875rem;\n    color: var(--matrx-print-code-fg, #d73a49);\n}\n\n.matrx-code-block {\n    background-color: var(--matrx-print-code-block-bg, #f8f8f8);\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n    border-radius: 0.375rem;\n    padding: 1rem;\n    margin: 1.5rem 0;\n    overflow-x: auto;\n}\n\n.matrx-code {\n    font-family: \"Monaco\", \"Menlo\", \"Ubuntu Mono\", monospace;\n    font-size: 0.875rem;\n    line-height: 1.5;\n    color: var(--matrx-print-code-block-fg, #333);\n}\n\n/* Blockquotes */\n.matrx-blockquote {\n    border-left: 4px solid var(--matrx-print-border, #e1e1e1);\n    padding-left: 1rem;\n    margin: 1.5rem 0;\n    font-style: italic;\n    color: var(--matrx-print-quote-fg, #666);\n}\n\n/* Tables */\n.matrx-table {\n    width: 100%;\n    border-collapse: collapse;\n    margin: 1.5rem 0;\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n    color: var(--matrx-print-table-fg, #333333);\n}\n\n.matrx-table-head {\n    background-color: var(--matrx-print-surface, #f8f9fa);\n}\n\n.matrx-table-body {\n    background-color: var(--matrx-print-bg, #ffffff);\n}\n\n.matrx-table-header {\n    background-color: var(--matrx-print-surface, #f8f9fa);\n    font-weight: 600;\n    padding: 0.75rem;\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n    text-align: left;\n    color: var(--matrx-print-table-fg, #333333);\n}\n\n.matrx-table-cell {\n    padding: 0.75rem;\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n    color: var(--matrx-print-table-fg, #333333);\n}\n\n.matrx-table-row {\n    color: var(--matrx-print-table-fg, #333333);\n}\n\n.matrx-table-row:nth-child(even) {\n    background-color: var(--matrx-print-surface, #f8f9fa);\n}\n\n/* Ensure table content doesn't inherit external colors */\n.matrx-table * {\n    color: inherit;\n}\n\n/* Images */\n.matrx-image {\n    max-width: 100%;\n    height: auto;\n    border-radius: 0.375rem;\n    margin: 1rem 0;\n}\n\n/* Horizontal Rules */\n.matrx-hr {\n    border: none;\n    border-top: 1px solid var(--matrx-print-border, #e1e1e1);\n    margin: 2rem 0;\n}\n\n/* Utility Classes */\n.matrx-div {\n    margin: 0.5rem 0;\n}\n\n.matrx-span {\n    /* Inherit parent styling by default */\n}\n\n/* Flashcard Styles */\n.matrx-flashcards-container {\n    margin: 2rem 0;\n    display: flex;\n    flex-direction: column;\n    gap: 0.5rem;\n}\n\n.matrx-flashcard {\n    perspective: 1000px;\n    perspective-origin: center center;\n    height: 200px;\n    cursor: pointer;\n    position: relative;\n    margin-bottom: 0.5rem;\n}\n\n.matrx-flashcard-input {\n    display: none;\n}\n\n.matrx-flashcard-inner {\n    position: absolute;\n    top: 0;\n    left: 0;\n    width: 100%;\n    height: 100%;\n    transition: transform 0.6s;\n    transform-style: preserve-3d;\n    transform-origin: center center;\n}\n\n.matrx-flashcard-input:checked ~ .matrx-flashcard-inner {\n    transform: rotateY(180deg);\n}\n\n.matrx-flashcard-front,\n.matrx-flashcard-back {\n    position: absolute;\n    top: 0;\n    left: 0;\n    width: 100%;\n    height: 100%;\n    backface-visibility: hidden;\n    border-radius: 12px;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    padding: 1.5rem;\n    box-shadow: 0 4px 6px var(--matrx-print-shadow, rgba(0, 0, 0, 0.1));\n    transition: box-shadow 0.3s ease;\n    box-sizing: border-box;\n}\n\n.matrx-flashcard-front {\n    background: linear-gradient(135deg, var(--matrx-print-accent, #667eea) 0%, var(--matrx-print-accent-2, #764ba2) 100%);\n    color: white;\n}\n\n.matrx-flashcard-back {\n    background: linear-gradient(135deg, var(--matrx-print-success, #2d5016) 0%, var(--matrx-print-success-2, #1e3a0f) 100%);\n    color: white;\n    transform: rotateY(180deg);\n}\n\n.matrx-flashcard:hover .matrx-flashcard-front,\n.matrx-flashcard:hover .matrx-flashcard-back {\n    box-shadow: 0 8px 16px var(--matrx-print-shadow-strong, rgba(0, 0, 0, 0.2));\n}\n\n.matrx-flashcard-content {\n    text-align: center;\n    font-size: 1.3rem;\n    line-height: 1.8;\n    max-height: 100%;\n    width: 100%;\n    overflow: hidden;\n}\n\n.matrx-flashcard-label {\n    cursor: pointer;\n    user-select: none;\n    position: absolute;\n    top: 0;\n    left: 0;\n    width: 100%;\n    height: 100%;\n    z-index: 10;\n}\n\n.matrx-flashcard-indicator {\n    position: absolute;\n    bottom: 12px;\n    right: 16px;\n    font-size: 0.75rem;\n    opacity: 0.8;\n    font-weight: 500;\n    letter-spacing: 0.5px;\n}\n\n/* Responsive adjustments */\n@media (max-width: 768px) {\n    .matrx-flashcard {\n        height: 180px;\n    }\n\n    .matrx-flashcard-content {\n        font-size: 1rem;\n    }\n\n    .matrx-flashcard-front,\n    .matrx-flashcard-back {\n        padding: 1.25rem;\n    }\n}\n\n@media (max-width: 480px) {\n    .matrx-flashcard {\n        height: 160px;\n    }\n\n    .matrx-flashcard-content {\n        font-size: 0.95rem;\n    }\n\n    .matrx-flashcard-front,\n    .matrx-flashcard-back {\n        padding: 1rem;\n    }\n}\n\n/* Responsive Design */\n@media (max-width: 768px) {\n    .matrx-content-container {\n        padding: 1rem;\n    }\n\n    .matrx-h1 {\n        font-size: 2rem;\n    }\n\n    .matrx-h2 {\n        font-size: 1.5rem;\n        margin: 2rem 0 1rem 0 !important;\n    }\n\n    .matrx-h3 {\n        font-size: 1.2rem;\n    }\n\n    .matrx-h4 {\n        font-size: 1.05rem;\n    }\n\n    .matrx-h5 {\n        font-size: 0.95rem;\n    }\n\n    .matrx-h6 {\n        font-size: 0.9rem;\n    }\n\n    .matrx-intro {\n        padding: 1rem;\n        font-size: 1rem;\n    }\n\n    .matrx-faq-question {\n        font-size: 1.1rem;\n        margin: 1.5rem 0 0.75rem 0;\n    }\n\n    .matrx-paragraph {\n        text-align: left;\n    }\n\n    .matrx-table {\n        font-size: 0.875rem;\n    }\n\n    .matrx-table-header,\n    .matrx-table-cell {\n        padding: 0.5rem;\n    }\n\n    .matrx-code-block {\n        padding: 0.75rem;\n        margin: 1rem 0;\n    }\n}\n\n@media (max-width: 480px) {\n    .matrx-content-container {\n        padding: 0.75rem;\n    }\n\n    .matrx-h1 {\n        font-size: 1.75rem;\n        margin-bottom: 1rem;\n    }\n\n    .matrx-h2 {\n        font-size: 1.3rem;\n        margin: 1.5rem 0 0.75rem 0 !important;\n    }\n\n    .matrx-h3 {\n        font-size: 1.1rem;\n        margin: 1.5rem 0 0.75rem 0;\n    }\n\n    .matrx-h4 {\n        font-size: 1rem;\n        margin: 1.25rem 0 0.5rem 0;\n    }\n\n    .matrx-h5 {\n        font-size: 0.9rem;\n        margin: 1rem 0 0.5rem 0;\n    }\n\n    .matrx-h6 {\n        font-size: 0.85rem;\n        margin: 1rem 0 0.5rem 0;\n    }\n\n    .matrx-intro {\n        padding: 0.75rem;\n        margin-bottom: 1.5rem;\n    }\n\n    .matrx-paragraph {\n        margin-bottom: 1.25rem;\n    }\n\n    .matrx-list-item {\n        margin-bottom: 0.75rem;\n    }\n\n    .matrx-table-header,\n    .matrx-table-cell {\n        padding: 0.375rem;\n    }\n\n    .matrx-code-block {\n        padding: 0.5rem;\n        font-size: 0.8rem;\n    }\n\n    .matrx-inline-code {\n        font-size: 0.8rem;\n    }\n}\n/* Print / PDF hard parts \u2014 added by @ai-matrx/print 0.3.0. */\n@media print {\n    .matrx-content-container {\n        max-width: 100%;\n        padding: 0;\n    }\n\n    .matrx-h1,\n    .matrx-h2,\n    .matrx-h3,\n    .matrx-h4,\n    .matrx-h5,\n    .matrx-h6 {\n        page-break-after: avoid;\n        break-after: avoid;\n    }\n\n    .matrx-paragraph,\n    .matrx-intro {\n        orphans: 3;\n        widows: 3;\n    }\n\n    .matrx-table,\n    .matrx-code-block,\n    .matrx-blockquote,\n    .matrx-list-item,\n    .matrx-image,\n    .matrx-faq-item,\n    .matrx-flashcard {\n        page-break-inside: avoid;\n        break-inside: avoid;\n    }\n\n    .matrx-table-header,\n    .matrx-code-block,\n    .matrx-blockquote,\n    .matrx-flashcard {\n        -webkit-print-color-adjust: exact;\n        print-color-adjust: exact;\n    }\n\n    .matrx-link {\n        text-decoration: underline;\n    }\n}\n";
 /** Structural CSS for the article skin (bare tags + `.print-*` classes). */
 declare const MARKDOWN_ARTICLE_CSS = "*,*::before,*::after{box-sizing:border-box;margin:0;padding:0}body{font-family:Georgia,'Times New Roman',serif;font-size:11pt;line-height:1.7;color:var(--matrx-print-fg, #1a1a1a);background:var(--matrx-print-bg, #fff);max-width:780px;margin:0 auto;padding:32px 40px}.print-actions{display:flex;gap:10px;margin-bottom:28px;padding-bottom:20px;border-bottom:2px solid var(--matrx-print-border, #e5e7eb)}.print-btn{display:inline-flex;align-items:center;gap:6px;padding:8px 20px;border-radius:8px;font-size:13px;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;cursor:pointer;border:none;font-weight:600;transition:opacity .15s}.print-btn:hover{opacity:.85}.print-btn-primary{background:var(--matrx-print-accent, #2563eb);color:var(--matrx-print-bg, #fff)}.print-btn-secondary{background:var(--matrx-print-surface-sunken, #f3f4f6);color:var(--matrx-print-fg-muted, #374151);border:1px solid var(--matrx-print-border-muted, #d1d5db)}h1,h2,h3,h4,h5,h6{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI','Helvetica Neue',sans-serif;font-weight:700;line-height:1.3;color:var(--matrx-print-heading, #111827);margin-top:1.6em;margin-bottom:.5em;page-break-after:avoid}h1{font-size:24pt;border-bottom:2px solid var(--matrx-print-border, #e5e7eb);padding-bottom:.3em;margin-top:0}h2{font-size:18pt;border-bottom:1px solid var(--matrx-print-border, #e5e7eb);padding-bottom:.2em}h3{font-size:14pt}p{margin-bottom:.9em;orphans:3;widows:3}a{color:var(--matrx-print-accent, #2563eb);text-decoration:underline;word-break:break-word}ul,ol{margin:.6em 0 .9em 0;padding-left:1.8em}li{margin-bottom:.3em;page-break-inside:avoid}blockquote{margin:1em 0;padding:.7em 1em .7em 1.2em;border-left:4px solid var(--matrx-print-quote-border, #6366f1);background:var(--matrx-print-quote-bg, #f5f3ff);border-radius:0 6px 6px 0;color:var(--matrx-print-fg-muted, #374151);font-style:italic;page-break-inside:avoid}.inline-code{font-family:'JetBrains Mono','Fira Code',monospace;font-size:9.5pt;background:var(--matrx-print-code-bg, #f1f5f9);color:var(--matrx-print-ink, #0f172a);padding:1px 5px;border-radius:4px;border:1px solid var(--matrx-print-line, #e2e8f0)}.code-block-wrapper{position:relative;margin:1em 0 1.2em;border-radius:8px;overflow:hidden;border:1px solid var(--matrx-print-line, #e2e8f0);page-break-inside:avoid}.code-lang{display:block;font-family:-apple-system,sans-serif;font-size:9pt;font-weight:600;color:var(--matrx-print-fg-subtle, #64748b);background:var(--matrx-print-surface, #f8fafc);padding:4px 12px;border-bottom:1px solid var(--matrx-print-line, #e2e8f0);text-transform:uppercase;letter-spacing:.05em}.code-block{margin:0;padding:14px 16px;background:var(--matrx-print-ink, #0f172a);color:var(--matrx-print-line, #e2e8f0);font-family:'JetBrains Mono',monospace;font-size:9pt;line-height:1.6;overflow-x:auto;white-space:pre;tab-size:2}.print-table{width:100%;border-collapse:collapse;margin:1em 0 1.2em;font-size:10pt;page-break-inside:avoid}.print-table th{background:var(--matrx-print-table-head-bg, #1e293b);color:var(--matrx-print-surface, #f8fafc);font-family:-apple-system,sans-serif;font-weight:600;font-size:9.5pt;text-align:left;padding:8px 12px;border:1px solid var(--matrx-print-table-head-border, #334155)}.print-table td{padding:7px 12px;border:1px solid var(--matrx-print-line, #e2e8f0);vertical-align:top}.print-table tr:nth-child(even) td{background:var(--matrx-print-surface, #f8fafc)}hr{border:none;border-top:2px solid var(--matrx-print-border, #e5e7eb);margin:1.5em 0}.print-figure{margin:1em 0 1.2em;page-break-inside:avoid}.print-image{display:block;max-width:100%;height:auto;margin:0 auto;border-radius:6px}.print-figure figcaption{margin-top:.4em;text-align:center;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;font-size:9.5pt;color:var(--matrx-print-fg-subtle, #64748b)}@media print{body{max-width:100%;padding:0;font-size:10.5pt}.print-actions{display:none!important}.code-block,.print-table th,blockquote{color-adjust:exact;-webkit-print-color-adjust:exact;print-color-adjust:exact}a[href]::after{content:\" (\"attr(href)\")\";font-size:9pt;color:var(--matrx-print-fg-subtle, #64748b)}a[href^=\"#\"]::after,a[href^=\"javascript:\"]::after{content:\"\"}h1,h2,h3{page-break-after:avoid}pre,blockquote,table{page-break-inside:avoid}}";
+/**
+ * Rules BOTH skins share — appended after the skin sheet by
+ * `getMarkdownStylesheet`. Everything the two converters emit identically
+ * (page breaks, artifact panels, task boxes, accent/heavy rules, strikethrough,
+ * printed flashcard pairs) is styled once here so the skins cannot drift, plus
+ * the print hard parts every printed page needs regardless of skin.
+ *
+ * Page break: on screen a dashed rule labelled "Page break" with generous
+ * padding — the same idea the chat preview draws; on paper a zero-height
+ * element that forces the next content onto a new page.
+ */
+declare const MARKDOWN_SHARED_CSS = "\n.matrx-page-break {\n    position: relative;\n    clear: both;\n    height: 0;\n    margin: 2.75rem 0;\n    border: 0;\n    border-top: 2px dashed var(--matrx-print-border-muted, #d1d5db);\n}\n.matrx-page-break::after {\n    content: attr(data-label);\n    position: absolute;\n    left: 50%;\n    top: 0;\n    transform: translate(-50%, -50%);\n    padding: 0 0.75rem;\n    background: var(--matrx-print-bg, #ffffff);\n    color: var(--matrx-print-fg-subtle, #6b7280);\n    font: 600 10px/1.6 -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif;\n    letter-spacing: 0.08em;\n    text-transform: uppercase;\n    white-space: nowrap;\n}\n\n.matrx-artifact {\n    margin: 1.25em 0;\n    border: 1px solid var(--matrx-print-border, #e5e7eb);\n    border-radius: 8px;\n    overflow: hidden;\n}\n.matrx-artifact-header {\n    display: flex;\n    align-items: baseline;\n    gap: 0.6em;\n    padding: 0.45em 0.9em;\n    background: var(--matrx-print-surface, #f8fafc);\n    border-bottom: 1px solid var(--matrx-print-border, #e5e7eb);\n    font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif;\n}\n.matrx-artifact-kind {\n    font-size: 0.72em;\n    font-weight: 700;\n    letter-spacing: 0.06em;\n    text-transform: uppercase;\n    color: var(--matrx-print-accent, #2563eb);\n}\n.matrx-artifact-title {\n    font-weight: 600;\n    color: var(--matrx-print-fg, #1a1a1a);\n}\n.matrx-artifact-body {\n    padding: 0.8em 0.9em;\n}\n.matrx-artifact-body > :first-child {\n    margin-top: 0;\n}\n.matrx-artifact-body > :last-child {\n    margin-bottom: 0;\n}\n.matrx-artifact-empty {\n    margin: 0;\n    font-style: italic;\n    color: var(--matrx-print-fg-subtle, #6b7280);\n}\n\nli.matrx-task-item {\n    list-style: none;\n}\n.matrx-task-box {\n    position: relative;\n    display: inline-block;\n    width: 0.9em;\n    height: 0.9em;\n    margin: 0 0.5em 0 -1.35em;\n    border: 1.5px solid var(--matrx-print-fg-muted, #4a4a4a);\n    border-radius: 3px;\n    vertical-align: -0.1em;\n}\n.matrx-task-box.is-checked::after {\n    content: \"\\2713\";\n    position: absolute;\n    inset: 0;\n    font-size: 0.8em;\n    font-weight: 700;\n    line-height: 1.1em;\n    text-align: center;\n    color: var(--matrx-print-fg, #1a1a1a);\n}\n\n:is(.matrx-content-container, .content) del {\n    color: var(--matrx-print-fg-muted, #4a4a4a);\n    text-decoration: line-through;\n}\n:is(.matrx-content-container, .content) hr.matrx-hr-accent {\n    height: 2px;\n    margin: 1.75em 0;\n    border: 0;\n    border-radius: 2px;\n    background: var(--matrx-print-accent, #2563eb);\n    opacity: 0.6;\n}\n:is(.matrx-content-container, .content) hr.matrx-hr-heavy {\n    height: 4px;\n    margin: 2.25em 0;\n    border: 0;\n    border-radius: 4px;\n    background: var(--matrx-print-accent, #2563eb);\n}\n\n.matrx-flashcards-print {\n    margin: 1em 0 1.2em;\n}\n.matrx-fc {\n    display: grid;\n    grid-template-columns: 1fr 1fr;\n    margin-bottom: 0.5em;\n    border: 1px solid var(--matrx-print-border, #e5e7eb);\n    border-radius: 6px;\n}\n.matrx-fc-front,\n.matrx-fc-back {\n    padding: 0.6em 0.8em;\n}\n.matrx-fc-front {\n    font-weight: 600;\n    border-right: 1px dashed var(--matrx-print-border-muted, #d1d5db);\n}\n.matrx-fc-num {\n    display: inline-block;\n    min-width: 1.6em;\n    font-size: 0.85em;\n    color: var(--matrx-print-fg-subtle, #6b7280);\n}\n\n@media print {\n    .matrx-page-break {\n        margin: 0;\n        border: 0;\n        break-after: page;\n        page-break-after: always;\n    }\n    .matrx-page-break::after {\n        content: none;\n    }\n    .matrx-page-break + * {\n        margin-top: 0;\n    }\n\n    /* Scoped to the rendered markdown (.matrx-content-container = document\n       skin, .content = print window) so a host page that carries this sheet\n       \u2014 a WordPress theme \u2014 keeps its own print rules everywhere else. */\n\n    /* Long tables flow across pages: the header row repeats, rows never split. */\n    :is(.matrx-content-container, .content) thead {\n        display: table-header-group;\n    }\n    :is(.matrx-content-container, .content) :is(tr, img, figure),\n    .matrx-fc,\n    .matrx-task-item {\n        break-inside: avoid;\n        page-break-inside: avoid;\n    }\n    :is(.matrx-content-container, .content) :is(h1, h2, h3, h4, h5, h6),\n    .matrx-artifact-header {\n        break-after: avoid;\n        page-break-after: avoid;\n        break-inside: avoid;\n    }\n\n    /* Paper cannot scroll: long code lines wrap instead of being cut off. */\n    :is(.matrx-content-container, .content) :is(pre, pre code) {\n        white-space: pre-wrap !important;\n        overflow-wrap: anywhere;\n        overflow: visible !important;\n    }\n    .code-block-wrapper,\n    .matrx-artifact {\n        overflow: visible;\n    }\n    :is(.matrx-content-container, .content) img {\n        max-width: 100% !important;\n    }\n\n    .matrx-artifact-header,\n    .matrx-task-box {\n        -webkit-print-color-adjust: exact;\n        print-color-adjust: exact;\n    }\n\n    a.matrx-link[href^=\"http\"]::after {\n        content: \" (\" attr(href) \")\";\n        font-size: 0.85em;\n        color: var(--matrx-print-fg-subtle, #6b7280);\n        overflow-wrap: anywhere;\n    }\n}\n";
+/**
+ * Page geometry + page numbers ("3 / 12", bottom centre). Part of the default
+ * sheet; `getMarkdownStylesheet({ pageNumbers: false })` leaves it out.
+ * Browsers without `@page` margin boxes ignore the numbering and keep the
+ * margins.
+ */
+declare const MARKDOWN_PAGE_CSS = "\n@page {\n    margin: 0.6in 0.65in 0.7in;\n    @bottom-center {\n        content: counter(page) \" / \" counter(pages);\n        font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif;\n        font-size: 8pt;\n        color: var(--matrx-print-fg-subtle, #6b7280);\n    }\n}\n";
 
 /**
  * @ai-matrx/print/markdown — the SHIPPED DEFAULT markdown→HTML converter and
@@ -103,18 +123,18 @@ declare function hasThinkingContent(content: string): boolean;
  * The class vocabulary is deliberate and non-configurable: it is what
  * `MARKDOWN_DOCUMENT_CSS` styles, what the PDF lane renders, and what a
  * WordPress theme targets. Handles (in this order, because the order is the
- * whole trick): flashcard blocks → horizontal rules → images → links →
- * headings → emphasis → nested lists → blockquotes → code → tables → block
- * elements → paragraphs → FAQ promotion → placeholder restoration.
+ * whole trick): the shared pre-pass (code, artifacts, page breaks, flashcards,
+ * inline code, unsafe page markup) → rules → images → links → headings →
+ * emphasis → nested/task lists → blockquotes → tables → block elements →
+ * paragraphs → FAQ promotion → placeholder restoration.
  */
 declare function markdownToHtml(markdown: string, options?: MarkdownToHtmlOptions): string;
 /**
- * markdown → bare semantic HTML (`h1`…`h6`, `p`, `ul`, `blockquote`,
+ * markdown → bare semantic HTML (`h1`…`h6`, `p`, `ul`/`ol`, `blockquote`,
  * `.code-block-wrapper`, `.print-table`) for the article skin.
  *
- * Code fences are HTML-escaped here — the document skin leaves them raw
- * because it targets a CMS that re-escapes; a print window does not, so
- * unescaped code would render as markup.
+ * Code is HTML-escaped in both skins (the shared pre-pass); a print window
+ * never re-escapes, so unescaped code would render as markup.
  */
 declare function markdownToArticleHtml(markdown: string, options?: MarkdownToHtmlOptions): string;
 /**
@@ -135,10 +155,16 @@ interface MarkdownStylesheetOptions {
     tokens?: string;
     /** Extra rules appended after everything else. */
     extraCss?: string;
+    /**
+     * Number printed pages ("3 / 12", bottom centre) via `@page` margin boxes.
+     * Default: true. Page margins are set either way.
+     */
+    pageNumbers?: boolean;
 }
 /**
- * The complete default stylesheet for a skin: default token values, then the
- * structural sheet, then the host's overrides. Never returns an empty string.
+ * The complete default stylesheet for a skin: default token values, the
+ * structural sheet, the rules both skins share (page breaks, artifacts, task
+ * boxes, print hard parts), page geometry, then the host's overrides. Never returns an empty string.
  */
 declare function getMarkdownStylesheet(options?: MarkdownStylesheetOptions): string;
 /** Convert markdown with the converter that matches a skin. */
@@ -174,4 +200,4 @@ interface PrintMarkdownOptions extends RenderMarkdownDocumentOptions {
  */
 declare function printMarkdown(markdown: string, options?: PrintMarkdownOptions): PrintOutcome;
 
-export { MARKDOWN_ARTICLE_CSS, MARKDOWN_ARTICLE_TOKENS_CSS, MARKDOWN_DOCUMENT_CSS, MARKDOWN_DOCUMENT_TOKENS_CSS, type MarkdownNotice, type MarkdownSkin, type MarkdownStylesheetOptions, type MarkdownToHtmlOptions, PRINT_ACTIONS_CSS, type PrintMarkdownOptions, type RenderMarkdownDocumentOptions, getMarkdownStylesheet, hasThinkingContent, markdownToArticleHtml, markdownToHtml, markdownToHtmlForSkin, printMarkdown, removeThinkingContent, renderMarkdownDocument };
+export { MARKDOWN_ARTICLE_CSS, MARKDOWN_ARTICLE_TOKENS_CSS, MARKDOWN_DOCUMENT_CSS, MARKDOWN_DOCUMENT_TOKENS_CSS, MARKDOWN_PAGE_CSS, MARKDOWN_SHARED_CSS, type MarkdownNotice, type MarkdownSkin, type MarkdownStylesheetOptions, type MarkdownToHtmlOptions, PRINT_ACTIONS_CSS, type PrintMarkdownOptions, type RenderMarkdownDocumentOptions, getMarkdownStylesheet, hasThinkingContent, markdownToArticleHtml, markdownToHtml, markdownToHtmlForSkin, printMarkdown, removeThinkingContent, renderMarkdownDocument };

package/dist/markdown.d.ts

@@ -1,4 +1,5 @@
 import { PrintOutcome } from './core.js';
+export { PAGE_BREAK_CLASS, PAGE_BREAK_MARKDOWN, isPageBreakLine, splitAtPageBreaks } from './directives.js';
 
 /**
  * Default print stylesheets for `@ai-matrx/print/markdown`.
@@ -35,6 +36,25 @@ declare const MARKDOWN_ARTICLE_TOKENS_CSS = ":root {\n    --matrx-print-accent:
 declare const MARKDOWN_DOCUMENT_CSS = "/* \n * MATRX WordPress CSS - Production Ready\n * Use this CSS in your WordPress theme to style MATRX content\n * All styles are scoped to .matrx-content-container to avoid conflicts\n */\n\n/* Content Container */\n.matrx-content-container {\n    max-width: 800px;\n    margin: 0 auto;\n    padding: 2rem;\n    line-height: 1.6;\n    font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;\n}\n\n/* Typography */\n.matrx-h1 {\n    font-size: 2.5rem;\n    font-weight: 700;\n    margin: 0 0 1.5rem 0;\n    color: var(--matrx-print-fg, #1a1a1a);\n    line-height: 1.2;\n}\n\n.matrx-h2 {\n    font-size: 1.8rem;\n    font-weight: 600;\n    margin: 3rem 0 1rem 0 !important;\n    color: var(--matrx-print-heading, #2a2a2a);\n    line-height: 1.3 !important;\n    border-bottom: 2px solid var(--matrx-print-border-strong, #e5e5e5);\n    padding-bottom: 0.75rem !important;\n    padding-top: 0 !important;\n}\n\n.matrx-h3 {\n    font-size: 1.3rem;\n    font-weight: 600;\n    margin: 2rem 0 1rem 0;\n    color: var(--matrx-print-heading-sub, #3a3a3a);\n    line-height: 1.4;\n}\n\n.matrx-h4 {\n    font-size: 1.1rem;\n    font-weight: 600;\n    margin: 1.5rem 0 0.75rem 0;\n    color: var(--matrx-print-heading-sub, #3a3a3a);\n    line-height: 1.4;\n}\n\n.matrx-h5 {\n    font-size: 1rem;\n    font-weight: 600;\n    margin: 1.25rem 0 0.5rem 0;\n    color: var(--matrx-print-heading-sub, #3a3a3a);\n    line-height: 1.4;\n}\n\n.matrx-h6 {\n    font-size: 0.9rem;\n    font-weight: 600;\n    margin: 1rem 0 0.5rem 0;\n    color: var(--matrx-print-heading-sub, #3a3a3a);\n    line-height: 1.4;\n}\n\n/* Paragraphs */\n.matrx-intro {\n    font-size: 1.1rem;\n    color: var(--matrx-print-fg-muted, #4a4a4a);\n    margin-bottom: 2rem;\n    padding: 1.5rem;\n    background: var(--matrx-print-surface, #f8f9fa);\n    border-left: 4px solid var(--matrx-print-border-muted, #d1d5db);\n    border-radius: 0 8px 8px 0;\n}\n\n.matrx-paragraph {\n    font-size: 1rem;\n    color: var(--matrx-print-fg-muted, #4a4a4a);\n    margin-bottom: 1.5rem;\n    text-align: justify;\n}\n\n/* Text Formatting */\n.matrx-em {\n    font-style: italic;\n    color: var(--matrx-print-heading, #2a2a2a);\n}\n\n.matrx-strong {\n    font-weight: 600;\n    color: var(--matrx-print-heading, #2a2a2a);\n}\n\n/* Links */\n.matrx-link {\n    color: var(--matrx-print-link-fg, #374151);\n    text-decoration: underline;\n    text-decoration-color: var(--matrx-print-border-muted, #d1d5db);\n    text-underline-offset: 3px;\n    transition: all 0.2s ease;\n}\n\n.matrx-link:hover {\n    color: var(--matrx-print-link-hover-fg, #1f2937);\n    text-decoration-color: var(--matrx-print-link-underline, #9ca3af);\n}\n\n/* Images */\n.matrx-image {\n    max-width: 100%;\n    height: auto;\n    display: block;\n    margin: 1.5rem auto;\n    border-radius: 8px;\n    box-shadow: 0 2px 8px var(--matrx-print-shadow, rgba(0, 0, 0, 0.1));\n}\n\n/* Lists */\n.matrx-list {\n    margin: 1.5rem 0;\n    padding-left: 0;\n}\n\n.matrx-bullet-list {\n    list-style: none;\n}\n\n.matrx-list-item {\n    margin-bottom: 1rem;\n    padding-left: 1.5rem;\n    position: relative;\n    color: var(--matrx-print-fg-muted, #4a4a4a);\n}\n\n.matrx-list-item::before {\n    content: \"\u2022\";\n    color: var(--matrx-print-fg-subtle, #6b7280);\n    font-weight: bold;\n    position: absolute;\n    left: 0;\n    top: 0;\n    font-size: 1.2rem;\n}\n\n/* Numbered Lists */\n.matrx-numbered-list {\n    list-style: decimal;\n    padding-left: 2rem;\n}\n\n.matrx-numbered-list > .matrx-list-item {\n    padding-left: 0.5rem;\n}\n\n.matrx-numbered-list > .matrx-list-item::before {\n    content: none;\n    /* Remove the bullet */\n}\n\n/* Nested list indentation */\n.matrx-nested-list {\n    margin-top: 0.5rem;\n    margin-bottom: 0.5rem;\n    padding-left: 1.5rem !important;\n}\n\n/* Ensure nested lists within list items are properly indented */\n.matrx-list-item > .matrx-list {\n    margin-top: 0.5rem;\n    margin-bottom: 0.5rem;\n    padding-left: 1.5rem;\n}\n\n/* For multiple levels of nesting, increase indentation */\n.matrx-nested-list .matrx-nested-list {\n    padding-left: 1.5rem !important;\n}\n\n/* Code */\n.matrx-content-container .matrx-inline-code {\n    background-color: var(--matrx-print-code-bg, #f5f5f5);\n    padding: 0.125rem 0.25rem;\n    border-radius: 0.25rem;\n    font-family: \"Monaco\", \"Menlo\", \"Ubuntu Mono\", monospace;\n    font-size: 0.875rem;\n    color: var(--matrx-print-code-fg, #d73a49);\n}\n\n.matrx-content-container .matrx-code-block {\n    background-color: var(--matrx-print-code-block-bg, #f8f8f8);\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n    border-radius: 0.375rem;\n    padding: 1rem;\n    margin: 1.5rem 0;\n    overflow-x: auto;\n}\n\n.matrx-content-container .matrx-code {\n    font-family: \"Monaco\", \"Menlo\", \"Ubuntu Mono\", monospace;\n    font-size: 0.875rem;\n    line-height: 1.5;\n    color: var(--matrx-print-code-block-fg, #333);\n}\n\n/* Blockquotes */\n.matrx-content-container .matrx-blockquote {\n    border-left: 4px solid var(--matrx-print-border, #e1e1e1);\n    padding-left: 1rem;\n    margin: 1.5rem 0;\n    font-style: italic;\n    color: var(--matrx-print-quote-fg, #666);\n}\n\n/* Tables */\n.matrx-content-container .matrx-table {\n    width: 100%;\n    border-collapse: collapse;\n    margin: 1.5rem 0;\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n}\n\n.matrx-content-container .matrx-table-header {\n    background-color: var(--matrx-print-surface, #f8f9fa);\n    font-weight: 600;\n    padding: 0.75rem;\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n    text-align: left;\n}\n\n.matrx-content-container .matrx-table-cell {\n    padding: 0.75rem;\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n}\n\n.matrx-content-container .matrx-table-row:nth-child(even) {\n    background-color: var(--matrx-print-surface, #f8f9fa);\n}\n\n/* Images */\n.matrx-content-container .matrx-image {\n    max-width: 100%;\n    height: auto;\n    border-radius: 0.375rem;\n    margin: 1rem 0;\n}\n\n/* Horizontal Rules */\n.matrx-content-container .matrx-hr {\n    border: none;\n    border-top: 1px solid var(--matrx-print-border, #e1e1e1);\n    margin: 2rem 0;\n}\n\n/* FAQ Styles - Clean Design */\n.matrx-faq-item {\n    margin-bottom: 2rem;\n    padding: 1.5rem;\n    background: var(--matrx-print-surface, #f8f9fa);\n    border-radius: 8px;\n    border-left: 4px solid var(--matrx-print-border-muted, #d1d5db);\n}\n\n.matrx-faq-question {\n    font-size: 1.2rem;\n    font-weight: 600;\n    margin: 0 0 0.75rem 0;\n    color: var(--matrx-print-heading, #2a2a2a);\n}\n\n.matrx-faq-answer {\n    margin: 0;\n    color: var(--matrx-print-fg-muted, #4a4a4a);\n    line-height: 1.6;\n}\n\n/* Code Blocks */\n.matrx-inline-code {\n    background-color: var(--matrx-print-code-bg, #f5f5f5);\n    padding: 0.125rem 0.25rem;\n    border-radius: 0.25rem;\n    font-family: \"Monaco\", \"Menlo\", \"Ubuntu Mono\", monospace;\n    font-size: 0.875rem;\n    color: var(--matrx-print-code-fg, #d73a49);\n}\n\n.matrx-code-block {\n    background-color: var(--matrx-print-code-block-bg, #f8f8f8);\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n    border-radius: 0.375rem;\n    padding: 1rem;\n    margin: 1.5rem 0;\n    overflow-x: auto;\n}\n\n.matrx-code {\n    font-family: \"Monaco\", \"Menlo\", \"Ubuntu Mono\", monospace;\n    font-size: 0.875rem;\n    line-height: 1.5;\n    color: var(--matrx-print-code-block-fg, #333);\n}\n\n/* Blockquotes */\n.matrx-blockquote {\n    border-left: 4px solid var(--matrx-print-border, #e1e1e1);\n    padding-left: 1rem;\n    margin: 1.5rem 0;\n    font-style: italic;\n    color: var(--matrx-print-quote-fg, #666);\n}\n\n/* Tables */\n.matrx-table {\n    width: 100%;\n    border-collapse: collapse;\n    margin: 1.5rem 0;\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n    color: var(--matrx-print-table-fg, #333333);\n}\n\n.matrx-table-head {\n    background-color: var(--matrx-print-surface, #f8f9fa);\n}\n\n.matrx-table-body {\n    background-color: var(--matrx-print-bg, #ffffff);\n}\n\n.matrx-table-header {\n    background-color: var(--matrx-print-surface, #f8f9fa);\n    font-weight: 600;\n    padding: 0.75rem;\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n    text-align: left;\n    color: var(--matrx-print-table-fg, #333333);\n}\n\n.matrx-table-cell {\n    padding: 0.75rem;\n    border: 1px solid var(--matrx-print-border, #e1e1e1);\n    color: var(--matrx-print-table-fg, #333333);\n}\n\n.matrx-table-row {\n    color: var(--matrx-print-table-fg, #333333);\n}\n\n.matrx-table-row:nth-child(even) {\n    background-color: var(--matrx-print-surface, #f8f9fa);\n}\n\n/* Ensure table content doesn't inherit external colors */\n.matrx-table * {\n    color: inherit;\n}\n\n/* Images */\n.matrx-image {\n    max-width: 100%;\n    height: auto;\n    border-radius: 0.375rem;\n    margin: 1rem 0;\n}\n\n/* Horizontal Rules */\n.matrx-hr {\n    border: none;\n    border-top: 1px solid var(--matrx-print-border, #e1e1e1);\n    margin: 2rem 0;\n}\n\n/* Utility Classes */\n.matrx-div {\n    margin: 0.5rem 0;\n}\n\n.matrx-span {\n    /* Inherit parent styling by default */\n}\n\n/* Flashcard Styles */\n.matrx-flashcards-container {\n    margin: 2rem 0;\n    display: flex;\n    flex-direction: column;\n    gap: 0.5rem;\n}\n\n.matrx-flashcard {\n    perspective: 1000px;\n    perspective-origin: center center;\n    height: 200px;\n    cursor: pointer;\n    position: relative;\n    margin-bottom: 0.5rem;\n}\n\n.matrx-flashcard-input {\n    display: none;\n}\n\n.matrx-flashcard-inner {\n    position: absolute;\n    top: 0;\n    left: 0;\n    width: 100%;\n    height: 100%;\n    transition: transform 0.6s;\n    transform-style: preserve-3d;\n    transform-origin: center center;\n}\n\n.matrx-flashcard-input:checked ~ .matrx-flashcard-inner {\n    transform: rotateY(180deg);\n}\n\n.matrx-flashcard-front,\n.matrx-flashcard-back {\n    position: absolute;\n    top: 0;\n    left: 0;\n    width: 100%;\n    height: 100%;\n    backface-visibility: hidden;\n    border-radius: 12px;\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    padding: 1.5rem;\n    box-shadow: 0 4px 6px var(--matrx-print-shadow, rgba(0, 0, 0, 0.1));\n    transition: box-shadow 0.3s ease;\n    box-sizing: border-box;\n}\n\n.matrx-flashcard-front {\n    background: linear-gradient(135deg, var(--matrx-print-accent, #667eea) 0%, var(--matrx-print-accent-2, #764ba2) 100%);\n    color: white;\n}\n\n.matrx-flashcard-back {\n    background: linear-gradient(135deg, var(--matrx-print-success, #2d5016) 0%, var(--matrx-print-success-2, #1e3a0f) 100%);\n    color: white;\n    transform: rotateY(180deg);\n}\n\n.matrx-flashcard:hover .matrx-flashcard-front,\n.matrx-flashcard:hover .matrx-flashcard-back {\n    box-shadow: 0 8px 16px var(--matrx-print-shadow-strong, rgba(0, 0, 0, 0.2));\n}\n\n.matrx-flashcard-content {\n    text-align: center;\n    font-size: 1.3rem;\n    line-height: 1.8;\n    max-height: 100%;\n    width: 100%;\n    overflow: hidden;\n}\n\n.matrx-flashcard-label {\n    cursor: pointer;\n    user-select: none;\n    position: absolute;\n    top: 0;\n    left: 0;\n    width: 100%;\n    height: 100%;\n    z-index: 10;\n}\n\n.matrx-flashcard-indicator {\n    position: absolute;\n    bottom: 12px;\n    right: 16px;\n    font-size: 0.75rem;\n    opacity: 0.8;\n    font-weight: 500;\n    letter-spacing: 0.5px;\n}\n\n/* Responsive adjustments */\n@media (max-width: 768px) {\n    .matrx-flashcard {\n        height: 180px;\n    }\n\n    .matrx-flashcard-content {\n        font-size: 1rem;\n    }\n\n    .matrx-flashcard-front,\n    .matrx-flashcard-back {\n        padding: 1.25rem;\n    }\n}\n\n@media (max-width: 480px) {\n    .matrx-flashcard {\n        height: 160px;\n    }\n\n    .matrx-flashcard-content {\n        font-size: 0.95rem;\n    }\n\n    .matrx-flashcard-front,\n    .matrx-flashcard-back {\n        padding: 1rem;\n    }\n}\n\n/* Responsive Design */\n@media (max-width: 768px) {\n    .matrx-content-container {\n        padding: 1rem;\n    }\n\n    .matrx-h1 {\n        font-size: 2rem;\n    }\n\n    .matrx-h2 {\n        font-size: 1.5rem;\n        margin: 2rem 0 1rem 0 !important;\n    }\n\n    .matrx-h3 {\n        font-size: 1.2rem;\n    }\n\n    .matrx-h4 {\n        font-size: 1.05rem;\n    }\n\n    .matrx-h5 {\n        font-size: 0.95rem;\n    }\n\n    .matrx-h6 {\n        font-size: 0.9rem;\n    }\n\n    .matrx-intro {\n        padding: 1rem;\n        font-size: 1rem;\n    }\n\n    .matrx-faq-question {\n        font-size: 1.1rem;\n        margin: 1.5rem 0 0.75rem 0;\n    }\n\n    .matrx-paragraph {\n        text-align: left;\n    }\n\n    .matrx-table {\n        font-size: 0.875rem;\n    }\n\n    .matrx-table-header,\n    .matrx-table-cell {\n        padding: 0.5rem;\n    }\n\n    .matrx-code-block {\n        padding: 0.75rem;\n        margin: 1rem 0;\n    }\n}\n\n@media (max-width: 480px) {\n    .matrx-content-container {\n        padding: 0.75rem;\n    }\n\n    .matrx-h1 {\n        font-size: 1.75rem;\n        margin-bottom: 1rem;\n    }\n\n    .matrx-h2 {\n        font-size: 1.3rem;\n        margin: 1.5rem 0 0.75rem 0 !important;\n    }\n\n    .matrx-h3 {\n        font-size: 1.1rem;\n        margin: 1.5rem 0 0.75rem 0;\n    }\n\n    .matrx-h4 {\n        font-size: 1rem;\n        margin: 1.25rem 0 0.5rem 0;\n    }\n\n    .matrx-h5 {\n        font-size: 0.9rem;\n        margin: 1rem 0 0.5rem 0;\n    }\n\n    .matrx-h6 {\n        font-size: 0.85rem;\n        margin: 1rem 0 0.5rem 0;\n    }\n\n    .matrx-intro {\n        padding: 0.75rem;\n        margin-bottom: 1.5rem;\n    }\n\n    .matrx-paragraph {\n        margin-bottom: 1.25rem;\n    }\n\n    .matrx-list-item {\n        margin-bottom: 0.75rem;\n    }\n\n    .matrx-table-header,\n    .matrx-table-cell {\n        padding: 0.375rem;\n    }\n\n    .matrx-code-block {\n        padding: 0.5rem;\n        font-size: 0.8rem;\n    }\n\n    .matrx-inline-code {\n        font-size: 0.8rem;\n    }\n}\n/* Print / PDF hard parts \u2014 added by @ai-matrx/print 0.3.0. */\n@media print {\n    .matrx-content-container {\n        max-width: 100%;\n        padding: 0;\n    }\n\n    .matrx-h1,\n    .matrx-h2,\n    .matrx-h3,\n    .matrx-h4,\n    .matrx-h5,\n    .matrx-h6 {\n        page-break-after: avoid;\n        break-after: avoid;\n    }\n\n    .matrx-paragraph,\n    .matrx-intro {\n        orphans: 3;\n        widows: 3;\n    }\n\n    .matrx-table,\n    .matrx-code-block,\n    .matrx-blockquote,\n    .matrx-list-item,\n    .matrx-image,\n    .matrx-faq-item,\n    .matrx-flashcard {\n        page-break-inside: avoid;\n        break-inside: avoid;\n    }\n\n    .matrx-table-header,\n    .matrx-code-block,\n    .matrx-blockquote,\n    .matrx-flashcard {\n        -webkit-print-color-adjust: exact;\n        print-color-adjust: exact;\n    }\n\n    .matrx-link {\n        text-decoration: underline;\n    }\n}\n";
 /** Structural CSS for the article skin (bare tags + `.print-*` classes). */
 declare const MARKDOWN_ARTICLE_CSS = "*,*::before,*::after{box-sizing:border-box;margin:0;padding:0}body{font-family:Georgia,'Times New Roman',serif;font-size:11pt;line-height:1.7;color:var(--matrx-print-fg, #1a1a1a);background:var(--matrx-print-bg, #fff);max-width:780px;margin:0 auto;padding:32px 40px}.print-actions{display:flex;gap:10px;margin-bottom:28px;padding-bottom:20px;border-bottom:2px solid var(--matrx-print-border, #e5e7eb)}.print-btn{display:inline-flex;align-items:center;gap:6px;padding:8px 20px;border-radius:8px;font-size:13px;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;cursor:pointer;border:none;font-weight:600;transition:opacity .15s}.print-btn:hover{opacity:.85}.print-btn-primary{background:var(--matrx-print-accent, #2563eb);color:var(--matrx-print-bg, #fff)}.print-btn-secondary{background:var(--matrx-print-surface-sunken, #f3f4f6);color:var(--matrx-print-fg-muted, #374151);border:1px solid var(--matrx-print-border-muted, #d1d5db)}h1,h2,h3,h4,h5,h6{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI','Helvetica Neue',sans-serif;font-weight:700;line-height:1.3;color:var(--matrx-print-heading, #111827);margin-top:1.6em;margin-bottom:.5em;page-break-after:avoid}h1{font-size:24pt;border-bottom:2px solid var(--matrx-print-border, #e5e7eb);padding-bottom:.3em;margin-top:0}h2{font-size:18pt;border-bottom:1px solid var(--matrx-print-border, #e5e7eb);padding-bottom:.2em}h3{font-size:14pt}p{margin-bottom:.9em;orphans:3;widows:3}a{color:var(--matrx-print-accent, #2563eb);text-decoration:underline;word-break:break-word}ul,ol{margin:.6em 0 .9em 0;padding-left:1.8em}li{margin-bottom:.3em;page-break-inside:avoid}blockquote{margin:1em 0;padding:.7em 1em .7em 1.2em;border-left:4px solid var(--matrx-print-quote-border, #6366f1);background:var(--matrx-print-quote-bg, #f5f3ff);border-radius:0 6px 6px 0;color:var(--matrx-print-fg-muted, #374151);font-style:italic;page-break-inside:avoid}.inline-code{font-family:'JetBrains Mono','Fira Code',monospace;font-size:9.5pt;background:var(--matrx-print-code-bg, #f1f5f9);color:var(--matrx-print-ink, #0f172a);padding:1px 5px;border-radius:4px;border:1px solid var(--matrx-print-line, #e2e8f0)}.code-block-wrapper{position:relative;margin:1em 0 1.2em;border-radius:8px;overflow:hidden;border:1px solid var(--matrx-print-line, #e2e8f0);page-break-inside:avoid}.code-lang{display:block;font-family:-apple-system,sans-serif;font-size:9pt;font-weight:600;color:var(--matrx-print-fg-subtle, #64748b);background:var(--matrx-print-surface, #f8fafc);padding:4px 12px;border-bottom:1px solid var(--matrx-print-line, #e2e8f0);text-transform:uppercase;letter-spacing:.05em}.code-block{margin:0;padding:14px 16px;background:var(--matrx-print-ink, #0f172a);color:var(--matrx-print-line, #e2e8f0);font-family:'JetBrains Mono',monospace;font-size:9pt;line-height:1.6;overflow-x:auto;white-space:pre;tab-size:2}.print-table{width:100%;border-collapse:collapse;margin:1em 0 1.2em;font-size:10pt;page-break-inside:avoid}.print-table th{background:var(--matrx-print-table-head-bg, #1e293b);color:var(--matrx-print-surface, #f8fafc);font-family:-apple-system,sans-serif;font-weight:600;font-size:9.5pt;text-align:left;padding:8px 12px;border:1px solid var(--matrx-print-table-head-border, #334155)}.print-table td{padding:7px 12px;border:1px solid var(--matrx-print-line, #e2e8f0);vertical-align:top}.print-table tr:nth-child(even) td{background:var(--matrx-print-surface, #f8fafc)}hr{border:none;border-top:2px solid var(--matrx-print-border, #e5e7eb);margin:1.5em 0}.print-figure{margin:1em 0 1.2em;page-break-inside:avoid}.print-image{display:block;max-width:100%;height:auto;margin:0 auto;border-radius:6px}.print-figure figcaption{margin-top:.4em;text-align:center;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;font-size:9.5pt;color:var(--matrx-print-fg-subtle, #64748b)}@media print{body{max-width:100%;padding:0;font-size:10.5pt}.print-actions{display:none!important}.code-block,.print-table th,blockquote{color-adjust:exact;-webkit-print-color-adjust:exact;print-color-adjust:exact}a[href]::after{content:\" (\"attr(href)\")\";font-size:9pt;color:var(--matrx-print-fg-subtle, #64748b)}a[href^=\"#\"]::after,a[href^=\"javascript:\"]::after{content:\"\"}h1,h2,h3{page-break-after:avoid}pre,blockquote,table{page-break-inside:avoid}}";
+/**
+ * Rules BOTH skins share — appended after the skin sheet by
+ * `getMarkdownStylesheet`. Everything the two converters emit identically
+ * (page breaks, artifact panels, task boxes, accent/heavy rules, strikethrough,
+ * printed flashcard pairs) is styled once here so the skins cannot drift, plus
+ * the print hard parts every printed page needs regardless of skin.
+ *
+ * Page break: on screen a dashed rule labelled "Page break" with generous
+ * padding — the same idea the chat preview draws; on paper a zero-height
+ * element that forces the next content onto a new page.
+ */
+declare const MARKDOWN_SHARED_CSS = "\n.matrx-page-break {\n    position: relative;\n    clear: both;\n    height: 0;\n    margin: 2.75rem 0;\n    border: 0;\n    border-top: 2px dashed var(--matrx-print-border-muted, #d1d5db);\n}\n.matrx-page-break::after {\n    content: attr(data-label);\n    position: absolute;\n    left: 50%;\n    top: 0;\n    transform: translate(-50%, -50%);\n    padding: 0 0.75rem;\n    background: var(--matrx-print-bg, #ffffff);\n    color: var(--matrx-print-fg-subtle, #6b7280);\n    font: 600 10px/1.6 -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif;\n    letter-spacing: 0.08em;\n    text-transform: uppercase;\n    white-space: nowrap;\n}\n\n.matrx-artifact {\n    margin: 1.25em 0;\n    border: 1px solid var(--matrx-print-border, #e5e7eb);\n    border-radius: 8px;\n    overflow: hidden;\n}\n.matrx-artifact-header {\n    display: flex;\n    align-items: baseline;\n    gap: 0.6em;\n    padding: 0.45em 0.9em;\n    background: var(--matrx-print-surface, #f8fafc);\n    border-bottom: 1px solid var(--matrx-print-border, #e5e7eb);\n    font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif;\n}\n.matrx-artifact-kind {\n    font-size: 0.72em;\n    font-weight: 700;\n    letter-spacing: 0.06em;\n    text-transform: uppercase;\n    color: var(--matrx-print-accent, #2563eb);\n}\n.matrx-artifact-title {\n    font-weight: 600;\n    color: var(--matrx-print-fg, #1a1a1a);\n}\n.matrx-artifact-body {\n    padding: 0.8em 0.9em;\n}\n.matrx-artifact-body > :first-child {\n    margin-top: 0;\n}\n.matrx-artifact-body > :last-child {\n    margin-bottom: 0;\n}\n.matrx-artifact-empty {\n    margin: 0;\n    font-style: italic;\n    color: var(--matrx-print-fg-subtle, #6b7280);\n}\n\nli.matrx-task-item {\n    list-style: none;\n}\n.matrx-task-box {\n    position: relative;\n    display: inline-block;\n    width: 0.9em;\n    height: 0.9em;\n    margin: 0 0.5em 0 -1.35em;\n    border: 1.5px solid var(--matrx-print-fg-muted, #4a4a4a);\n    border-radius: 3px;\n    vertical-align: -0.1em;\n}\n.matrx-task-box.is-checked::after {\n    content: \"\\2713\";\n    position: absolute;\n    inset: 0;\n    font-size: 0.8em;\n    font-weight: 700;\n    line-height: 1.1em;\n    text-align: center;\n    color: var(--matrx-print-fg, #1a1a1a);\n}\n\n:is(.matrx-content-container, .content) del {\n    color: var(--matrx-print-fg-muted, #4a4a4a);\n    text-decoration: line-through;\n}\n:is(.matrx-content-container, .content) hr.matrx-hr-accent {\n    height: 2px;\n    margin: 1.75em 0;\n    border: 0;\n    border-radius: 2px;\n    background: var(--matrx-print-accent, #2563eb);\n    opacity: 0.6;\n}\n:is(.matrx-content-container, .content) hr.matrx-hr-heavy {\n    height: 4px;\n    margin: 2.25em 0;\n    border: 0;\n    border-radius: 4px;\n    background: var(--matrx-print-accent, #2563eb);\n}\n\n.matrx-flashcards-print {\n    margin: 1em 0 1.2em;\n}\n.matrx-fc {\n    display: grid;\n    grid-template-columns: 1fr 1fr;\n    margin-bottom: 0.5em;\n    border: 1px solid var(--matrx-print-border, #e5e7eb);\n    border-radius: 6px;\n}\n.matrx-fc-front,\n.matrx-fc-back {\n    padding: 0.6em 0.8em;\n}\n.matrx-fc-front {\n    font-weight: 600;\n    border-right: 1px dashed var(--matrx-print-border-muted, #d1d5db);\n}\n.matrx-fc-num {\n    display: inline-block;\n    min-width: 1.6em;\n    font-size: 0.85em;\n    color: var(--matrx-print-fg-subtle, #6b7280);\n}\n\n@media print {\n    .matrx-page-break {\n        margin: 0;\n        border: 0;\n        break-after: page;\n        page-break-after: always;\n    }\n    .matrx-page-break::after {\n        content: none;\n    }\n    .matrx-page-break + * {\n        margin-top: 0;\n    }\n\n    /* Scoped to the rendered markdown (.matrx-content-container = document\n       skin, .content = print window) so a host page that carries this sheet\n       \u2014 a WordPress theme \u2014 keeps its own print rules everywhere else. */\n\n    /* Long tables flow across pages: the header row repeats, rows never split. */\n    :is(.matrx-content-container, .content) thead {\n        display: table-header-group;\n    }\n    :is(.matrx-content-container, .content) :is(tr, img, figure),\n    .matrx-fc,\n    .matrx-task-item {\n        break-inside: avoid;\n        page-break-inside: avoid;\n    }\n    :is(.matrx-content-container, .content) :is(h1, h2, h3, h4, h5, h6),\n    .matrx-artifact-header {\n        break-after: avoid;\n        page-break-after: avoid;\n        break-inside: avoid;\n    }\n\n    /* Paper cannot scroll: long code lines wrap instead of being cut off. */\n    :is(.matrx-content-container, .content) :is(pre, pre code) {\n        white-space: pre-wrap !important;\n        overflow-wrap: anywhere;\n        overflow: visible !important;\n    }\n    .code-block-wrapper,\n    .matrx-artifact {\n        overflow: visible;\n    }\n    :is(.matrx-content-container, .content) img {\n        max-width: 100% !important;\n    }\n\n    .matrx-artifact-header,\n    .matrx-task-box {\n        -webkit-print-color-adjust: exact;\n        print-color-adjust: exact;\n    }\n\n    a.matrx-link[href^=\"http\"]::after {\n        content: \" (\" attr(href) \")\";\n        font-size: 0.85em;\n        color: var(--matrx-print-fg-subtle, #6b7280);\n        overflow-wrap: anywhere;\n    }\n}\n";
+/**
+ * Page geometry + page numbers ("3 / 12", bottom centre). Part of the default
+ * sheet; `getMarkdownStylesheet({ pageNumbers: false })` leaves it out.
+ * Browsers without `@page` margin boxes ignore the numbering and keep the
+ * margins.
+ */
+declare const MARKDOWN_PAGE_CSS = "\n@page {\n    margin: 0.6in 0.65in 0.7in;\n    @bottom-center {\n        content: counter(page) \" / \" counter(pages);\n        font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif;\n        font-size: 8pt;\n        color: var(--matrx-print-fg-subtle, #6b7280);\n    }\n}\n";
 
 /**
  * @ai-matrx/print/markdown — the SHIPPED DEFAULT markdown→HTML converter and
@@ -103,18 +123,18 @@ declare function hasThinkingContent(content: string): boolean;
  * The class vocabulary is deliberate and non-configurable: it is what
  * `MARKDOWN_DOCUMENT_CSS` styles, what the PDF lane renders, and what a
  * WordPress theme targets. Handles (in this order, because the order is the
- * whole trick): flashcard blocks → horizontal rules → images → links →
- * headings → emphasis → nested lists → blockquotes → code → tables → block
- * elements → paragraphs → FAQ promotion → placeholder restoration.
+ * whole trick): the shared pre-pass (code, artifacts, page breaks, flashcards,
+ * inline code, unsafe page markup) → rules → images → links → headings →
+ * emphasis → nested/task lists → blockquotes → tables → block elements →
+ * paragraphs → FAQ promotion → placeholder restoration.
  */
 declare function markdownToHtml(markdown: string, options?: MarkdownToHtmlOptions): string;
 /**
- * markdown → bare semantic HTML (`h1`…`h6`, `p`, `ul`, `blockquote`,
+ * markdown → bare semantic HTML (`h1`…`h6`, `p`, `ul`/`ol`, `blockquote`,
  * `.code-block-wrapper`, `.print-table`) for the article skin.
  *
- * Code fences are HTML-escaped here — the document skin leaves them raw
- * because it targets a CMS that re-escapes; a print window does not, so
- * unescaped code would render as markup.
+ * Code is HTML-escaped in both skins (the shared pre-pass); a print window
+ * never re-escapes, so unescaped code would render as markup.
  */
 declare function markdownToArticleHtml(markdown: string, options?: MarkdownToHtmlOptions): string;
 /**
@@ -135,10 +155,16 @@ interface MarkdownStylesheetOptions {
     tokens?: string;
     /** Extra rules appended after everything else. */
     extraCss?: string;
+    /**
+     * Number printed pages ("3 / 12", bottom centre) via `@page` margin boxes.
+     * Default: true. Page margins are set either way.
+     */
+    pageNumbers?: boolean;
 }
 /**
- * The complete default stylesheet for a skin: default token values, then the
- * structural sheet, then the host's overrides. Never returns an empty string.
+ * The complete default stylesheet for a skin: default token values, the
+ * structural sheet, the rules both skins share (page breaks, artifacts, task
+ * boxes, print hard parts), page geometry, then the host's overrides. Never returns an empty string.
  */
 declare function getMarkdownStylesheet(options?: MarkdownStylesheetOptions): string;
 /** Convert markdown with the converter that matches a skin. */
@@ -174,4 +200,4 @@ interface PrintMarkdownOptions extends RenderMarkdownDocumentOptions {
  */
 declare function printMarkdown(markdown: string, options?: PrintMarkdownOptions): PrintOutcome;
 
-export { MARKDOWN_ARTICLE_CSS, MARKDOWN_ARTICLE_TOKENS_CSS, MARKDOWN_DOCUMENT_CSS, MARKDOWN_DOCUMENT_TOKENS_CSS, type MarkdownNotice, type MarkdownSkin, type MarkdownStylesheetOptions, type MarkdownToHtmlOptions, PRINT_ACTIONS_CSS, type PrintMarkdownOptions, type RenderMarkdownDocumentOptions, getMarkdownStylesheet, hasThinkingContent, markdownToArticleHtml, markdownToHtml, markdownToHtmlForSkin, printMarkdown, removeThinkingContent, renderMarkdownDocument };
+export { MARKDOWN_ARTICLE_CSS, MARKDOWN_ARTICLE_TOKENS_CSS, MARKDOWN_DOCUMENT_CSS, MARKDOWN_DOCUMENT_TOKENS_CSS, MARKDOWN_PAGE_CSS, MARKDOWN_SHARED_CSS, type MarkdownNotice, type MarkdownSkin, type MarkdownStylesheetOptions, type MarkdownToHtmlOptions, PRINT_ACTIONS_CSS, type PrintMarkdownOptions, type RenderMarkdownDocumentOptions, getMarkdownStylesheet, hasThinkingContent, markdownToArticleHtml, markdownToHtml, markdownToHtmlForSkin, printMarkdown, removeThinkingContent, renderMarkdownDocument };