@puredesktop/puredesktop-ui-bridge 1.0.0-beta.1

package/src/bridge/pureRender/presets.ts

@@ -0,0 +1,365 @@
+import { DEFAULT_PURE_RENDER_THEME } from './theme.js'
+import type { PureRenderTheme } from './types.js'
+
+export interface PureRenderThemePreset {
+  id: string
+  label: string
+  theme: PureRenderTheme
+}
+
+function theme(
+  id: string,
+  label: string,
+  patch: Partial<PureRenderTheme>,
+): PureRenderThemePreset {
+  return {
+    id,
+    label,
+    theme: {
+      ...DEFAULT_PURE_RENDER_THEME,
+      ...patch,
+      color: { ...DEFAULT_PURE_RENDER_THEME.color, ...patch.color },
+      type: {
+        ...DEFAULT_PURE_RENDER_THEME.type,
+        ...patch.type,
+        fonts: {
+          ...DEFAULT_PURE_RENDER_THEME.type.fonts,
+          ...patch.type?.fonts,
+        },
+      },
+      setting: { ...DEFAULT_PURE_RENDER_THEME.setting, ...patch.setting },
+      page: { ...DEFAULT_PURE_RENDER_THEME.page, ...patch.page },
+    },
+  }
+}
+
+export const PURE_RENDER_THEME_PRESETS: readonly PureRenderThemePreset[] = [
+  theme('default-manuscript', 'Clean', {
+    name: 'Clean Manuscript',
+    profile_rules: {
+      table: {
+        rule_weight: 'light',
+        header_treatment: 'ruled',
+        density: 'balanced',
+      },
+      caption: {
+        label_style: 'bold',
+        alignment: 'left',
+      },
+    },
+  }),
+  theme('journal-article', 'Journal Article', {
+    name: 'Journal Article',
+    color: {
+      ink: '#14171C',
+      'ink-soft': '#3D424A',
+      muted: '#6D737C',
+      surface: '#FFFFFF',
+      paper: '#FFFFFF',
+      rule: '#BFC4CC',
+      'rule-soft': '#E6E9EE',
+      accent: '#7A2634',
+      'accent-ink': '#651D2A',
+    },
+    type: {
+      body: '10.2pt',
+      lead: 1.45,
+      measure: '30rem',
+      scaleRatio: 1.25,
+      fonts: {
+        display: '"Source Serif 4", Georgia, serif',
+        serif: '"Source Serif 4", Georgia, serif',
+        sans: '"Archivo", system-ui, sans-serif',
+        mono: '"JetBrains Mono", ui-monospace, monospace',
+      },
+    },
+    rhythm: '14.8pt',
+    page: { trim: 'A4', columns: 1, recto_verso: false },
+    setting: { align: 'justified', hyphenate: true },
+    profile_rules: {
+      running_heads: {
+        presence: 'present',
+        transform: 'uppercase',
+        rule: 'hairline',
+      },
+      table: {
+        rule_weight: 'hairline',
+        header_treatment: 'ruled',
+        density: 'compact',
+      },
+      caption: {
+        label_style: 'small-caps',
+        alignment: 'left',
+      },
+    },
+    enforced_rules: [
+      'Keep manuscript paper white unless the user explicitly chooses another surface.',
+      'Use compact tables and small-caps labels for journal-like manuscripts.',
+    ],
+  }),
+  theme('quiet-book', 'Quiet Book', {
+    name: 'Quiet Book',
+    color: {
+      ink: '#171A1F',
+      'ink-soft': '#3B3F45',
+      muted: '#6F756E',
+      surface: '#FFFFFF',
+      paper: '#FFFFFF',
+      rule: '#D7D9D3',
+      'rule-soft': '#ECEDE9',
+      accent: '#5F7F6C',
+      'accent-ink': '#4F6F5D',
+    },
+    type: {
+      body: '10.8pt',
+      lead: 1.6,
+      measure: '31rem',
+      scaleRatio: 1.333,
+      fonts: {
+        display: '"Newsreader", Georgia, serif',
+        serif: '"Source Serif 4", Georgia, serif',
+        sans: '"Archivo", system-ui, sans-serif',
+        mono: '"JetBrains Mono", ui-monospace, monospace',
+      },
+    },
+    rhythm: '17.3pt',
+    page: { trim: '6x9', columns: 1, recto_verso: true },
+    setting: { align: 'justified', hyphenate: true },
+    profile_rules: {
+      table: {
+        rule_weight: 'hairline',
+        header_treatment: 'plain',
+        density: 'airy',
+      },
+      caption: {
+        label_style: 'plain',
+        alignment: 'left',
+      },
+    },
+    enforced_rules: [
+      'Keep the printed page white, not gray.',
+      'Use table rules sparingly and keep them hairline-light.',
+    ],
+  }),
+  theme('classic-essay', 'Classic Essay', {
+    name: 'Classic Essay',
+    color: {
+      ink: '#1B1815',
+      'ink-soft': '#4B4640',
+      muted: '#7A736A',
+      surface: '#FFFFFF',
+      paper: '#FFFFFF',
+      rule: '#D6D0C7',
+      'rule-soft': '#EEEAE4',
+      accent: '#6F4E37',
+      'accent-ink': '#5A3D2B',
+    },
+    type: {
+      body: '11.2pt',
+      lead: 1.62,
+      measure: '32rem',
+      scaleRatio: 1.333,
+      fonts: {
+        display: '"Newsreader", Georgia, serif',
+        serif: '"Source Serif 4", Georgia, serif',
+        sans: '"Source Sans 3", system-ui, sans-serif',
+        mono: '"JetBrains Mono", ui-monospace, monospace',
+      },
+    },
+    rhythm: '18.1pt',
+    page: { trim: '6x9', columns: 1, recto_verso: true },
+    setting: { align: 'justified', hyphenate: true },
+    profile_rules: {
+      table: {
+        rule_weight: 'light',
+        header_treatment: 'plain',
+        density: 'airy',
+      },
+      caption: {
+        label_style: 'plain',
+        alignment: 'left',
+      },
+    },
+    enforced_rules: [
+      'Use a calm literary rhythm with generous leading.',
+      'Keep decoration restrained and tied to headings or running matter.',
+    ],
+  }),
+  theme('modern-report', 'Modern Report', {
+    name: 'Modern Report',
+    color: {
+      ink: '#172026',
+      'ink-soft': '#41505A',
+      muted: '#6F7C83',
+      surface: '#FFFFFF',
+      paper: '#FFFFFF',
+      rule: '#CBD5DB',
+      'rule-soft': '#E8EEF1',
+      accent: '#006D77',
+      'accent-ink': '#005B64',
+    },
+    type: {
+      body: '10.5pt',
+      lead: 1.5,
+      measure: '34rem',
+      scaleRatio: 1.25,
+      fonts: {
+        display: '"Source Sans 3", system-ui, sans-serif',
+        serif: '"Source Serif 4", Georgia, serif',
+        sans: '"Source Sans 3", system-ui, sans-serif',
+        mono: '"JetBrains Mono", ui-monospace, monospace',
+      },
+    },
+    rhythm: '15.8pt',
+    page: { trim: 'A4', columns: 1, recto_verso: false },
+    setting: { align: 'flush-left', hyphenate: false },
+    profile_rules: {
+      table: {
+        rule_weight: 'medium',
+        header_treatment: 'shaded',
+        density: 'balanced',
+      },
+      caption: {
+        label_style: 'plain',
+        alignment: 'left',
+      },
+    },
+    enforced_rules: [
+      'Favor scan-friendly headings and quiet tables.',
+      'Use color as an accent, not a page background.',
+    ],
+  }),
+  theme('scholarly-book', 'Scholarly Book', {
+    name: 'Scholarly Book',
+    color: {
+      ink: '#151515',
+      'ink-soft': '#45413B',
+      muted: '#756F66',
+      surface: '#FFFFFF',
+      paper: '#FFFFFF',
+      rule: '#CEC7BC',
+      'rule-soft': '#EBE7E1',
+      accent: '#596E5A',
+      'accent-ink': '#485C49',
+    },
+    type: {
+      body: '10.6pt',
+      lead: 1.58,
+      measure: '30rem',
+      scaleRatio: 1.414,
+      fonts: {
+        display: '"Source Serif 4", Georgia, serif',
+        serif: '"Source Serif 4", Georgia, serif',
+        sans: '"Archivo", system-ui, sans-serif',
+        mono: '"JetBrains Mono", ui-monospace, monospace',
+      },
+    },
+    rhythm: '16.7pt',
+    page: { trim: '6x9', columns: 1, recto_verso: true },
+    setting: { align: 'justified', hyphenate: true },
+    profile_rules: {
+      running_heads: {
+        presence: 'present',
+        transform: 'title-case',
+        rule: 'none',
+      },
+      caption: {
+        label_style: 'small-caps',
+        alignment: 'left',
+      },
+      table: {
+        rule_weight: 'hairline',
+        header_treatment: 'plain',
+        density: 'airy',
+      },
+    },
+    enforced_rules: [
+      'Prioritize long-form reading rhythm and stable running heads.',
+      'Keep figures and tables attached to their captions where possible.',
+    ],
+  }),
+  theme('conference-paper', 'Conference Paper', {
+    name: 'Conference Paper',
+    color: {
+      ink: '#17191D',
+      'ink-soft': '#3F454F',
+      muted: '#737985',
+      surface: '#FFFFFF',
+      paper: '#FFFFFF',
+      rule: '#C6CBD4',
+      'rule-soft': '#E7EAF0',
+      accent: '#274C77',
+      'accent-ink': '#1F3D61',
+    },
+    type: {
+      body: '9.8pt',
+      lead: 1.38,
+      measure: '25rem',
+      scaleRatio: 1.2,
+      fonts: {
+        display: '"Source Sans 3", system-ui, sans-serif',
+        serif: '"Source Serif 4", Georgia, serif',
+        sans: '"Source Sans 3", system-ui, sans-serif',
+        mono: '"JetBrains Mono", ui-monospace, monospace',
+      },
+    },
+    rhythm: '13.5pt',
+    page: { trim: 'A4', columns: 2, recto_verso: false },
+    setting: { align: 'justified', hyphenate: true },
+    profile_rules: {
+      table: {
+        rule_weight: 'hairline',
+        header_treatment: 'shaded',
+        density: 'compact',
+      },
+      caption: {
+        label_style: 'small-caps',
+        alignment: 'left',
+      },
+    },
+    enforced_rules: [
+      'Use a compact two-column conference rhythm when the profile allows it.',
+      'Avoid heavy table grids in dense manuscripts.',
+    ],
+  }),
+  theme('draft-writer', 'Draft Writer', {
+    name: 'Draft Writer',
+    color: {
+      ink: '#1D1F23',
+      'ink-soft': '#4B5058',
+      muted: '#777D86',
+      surface: '#FFFFFF',
+      paper: '#FFFFFF',
+      rule: '#DADDE3',
+      'rule-soft': '#EEF0F3',
+      accent: '#3E5C9A',
+      'accent-ink': '#304A82',
+    },
+    type: {
+      body: '11pt',
+      lead: 1.55,
+      measure: '33rem',
+      scaleRatio: 1.2,
+      fonts: {
+        display: '"Source Sans 3", system-ui, sans-serif',
+        serif: '"Source Serif 4", Georgia, serif',
+        sans: '"Source Sans 3", system-ui, sans-serif',
+        mono: '"JetBrains Mono", ui-monospace, monospace',
+      },
+    },
+    rhythm: '17.1pt',
+    page: { trim: 'A5', columns: 1, recto_verso: false },
+    setting: { align: 'flush-left', hyphenate: false },
+    profile_rules: {
+      table: {
+        rule_weight: 'light',
+        header_treatment: 'shaded',
+        density: 'balanced',
+      },
+      caption: {
+        label_style: 'plain',
+        alignment: 'left',
+      },
+    },
+  }),
+]

package/src/bridge/pureRender/profiles/book.css

@@ -0,0 +1,19 @@
+@page{ size:152mm 229mm; margin:18mm 16mm 22mm 20mm; @bottom-center{ content:counter(page); font:500 8pt var(--mono); color:var(--muted); } }
+@page:right{ margin-left:20mm; margin-right:16mm; @top-right{ content:string(chaptitle); font:600 7.5pt var(--sans); letter-spacing:.1em; text-transform:uppercase; color:var(--muted); } @bottom-right{ content:counter(page); } @bottom-center{ content:none } }
+@page:left{ margin-left:16mm; margin-right:20mm; @top-left{ content:string(doctitle); font:600 7.5pt var(--sans); letter-spacing:.1em; text-transform:uppercase; color:var(--muted); } @bottom-left{ content:counter(page); } @bottom-center{ content:none } }
+.pure-render-book > article > .doc-title{ break-after:page; max-width:none; padding-top:35%; text-align:center; font-size:30pt; line-height:1.05; margin:0; }
+.pure-render-book > article > .authors{ max-width:none; text-align:center; margin-top:1rem; }
+section[data-type="toc"]{ break-before:right; break-after:page; max-width:none; }
+section[data-type="toc"] > h2{ font-size:20pt; margin:0 0 calc(var(--rhythm)*1.2); }
+section[data-type="toc"] > h2::before{ content:none; }
+section[data-type="toc"] ol{ list-style:none; padding:0; margin:0; max-width:none; }
+section[data-type="toc"] li{ margin:.35rem 0; }
+section[data-type="toc"] a{ display:flex; gap:.35rem; color:var(--ink); }
+section[data-type="toc"] a::after{ content:leader('.') target-counter(attr(href), page); flex:1; text-align:right; color:var(--muted); }
+section[data-type="part"]{ break-before:right; text-align:center; padding-top:40%; }
+section[data-type="chapter"]{ break-before:right; counter-increment:sec; counter-reset:sub; }
+section[data-type="chapter"] > h2{ string-set:chaptitle content(text); font-size:26pt; margin:0 0 calc(var(--rhythm)*2); }
+section[data-type="chapter"]::before{ content:"Chapter " counter(sec); display:block; font:600 10pt var(--sans); letter-spacing:.1em; text-transform:uppercase; color:var(--accent); margin-bottom:.6rem; }
+section[data-type="chapter"] > h2{ counter-increment:none; }
+section[data-type="chapter"] > h2::before{ content:none; }
+figcaption::before{ content:"Figure " attr(data-label) ".\00a0"; }

package/src/bridge/pureRender/profiles/manuscript.css

@@ -0,0 +1,11 @@
+@page{ size:A4; margin:28mm 24mm 26mm 24mm; @bottom-center{ content:counter(page); font:500 8.4pt var(--mono); color:var(--muted); letter-spacing:.04em; } }
+@page:right{ margin-left:26mm; margin-right:22mm; @top-right{ content:string(sectitle); font:600 8pt var(--sans); letter-spacing:.08em; text-transform:uppercase; color:var(--muted); } }
+@page:left{ margin-left:22mm; margin-right:26mm; @top-left{ content:string(doctitle); font:600 8pt var(--sans); letter-spacing:.08em; text-transform:uppercase; color:var(--muted); } }
+@page:first{ margin-top:24mm; @top-left{ content:none } @top-right{ content:none } }
+[data-variant="two-column"]{ column-count:2; column-gap:7mm; column-fill:auto; }
+[data-variant="two-column"] > .doc-title,
+[data-variant="two-column"] > .authors,
+[data-variant="two-column"] > .affil,
+[data-variant="two-column"] > .keywords,
+[data-variant="two-column"] > section[data-type="abstract"]{ column-span:all; }
+[data-variant="two-column"] figure[data-span="page"],[data-variant="two-column"] .table-wrap[data-span="page"]{ column-span:all; }

package/src/bridge/pureRender/profiles/writer.css

@@ -0,0 +1,10 @@
+@page{ size:A4; margin:25mm; @bottom-center{ content:counter(page); font:500 8.4pt var(--mono); color:var(--muted); } }
+@page:first{ @top-left{content:none} @top-right{content:none} }
+.pure-render-writer{ --text-align:var(--theme-text-align,left); --hyphenate:var(--theme-hyphenate,manual); }
+.pure-render-writer p + p{ text-indent:0; margin-top:calc(var(--rhythm)*.55); }
+section > h2{ counter-increment:none; }
+h2::before,h3::before{ content:none; }
+section[data-type="abstract"]{ border:0; padding:0; }
+.pure-render-writer section[data-type="references"] ol{ list-style:decimal; padding-left:1.4rem; }
+.pure-render-writer section[data-type="references"] li{ counter-increment:none; padding-left:0; text-indent:0; }
+.pure-render-writer section[data-type="references"] li::before{ content:none; }

package/src/bridge/pureRender/reset.css

@@ -0,0 +1,5 @@
+*{ box-sizing:border-box }
+html,body{ margin:0; padding:0 }
+img,svg{ max-width:100%; height:auto; display:block }
+table{ border-collapse:collapse }
+html[data-pagedjs-rendered="true"] body > :not(.pagedjs_pages){ display:none !important }

package/src/bridge/pureRender/samples.ts

@@ -0,0 +1,94 @@
+const WRITER_FIGURE_SVG = `<svg viewBox="0 0 720 260" role="img" aria-label="Layered editorial planning diagram"><rect width="720" height="260" fill="#fbfbf8"/><path d="M62 188 C126 82 211 200 282 116 S433 64 492 134 610 185 660 80" fill="none" stroke="#2f5d7c" stroke-width="10"/><circle cx="282" cy="116" r="18" fill="#6f8f72"/><circle cx="492" cy="134" r="18" fill="#b47a5a"/><path d="M80 210 H650" stroke="#d7d5cf" stroke-width="3"/><path d="M110 58 H270 M110 84 H332 M110 110 H236" stroke="#242424" stroke-width="7" stroke-linecap="round"/></svg>`
+
+const MANUSCRIPT_PLOT_SVG = `<svg viewBox="0 0 760 360" role="img" aria-label="Multiseries manuscript plot"><rect width="760" height="360" fill="#ffffff"/><path d="M86 290 H700 M86 48 V290" stroke="#9a9a9a" stroke-width="3"/><path d="M110 250 L220 198 L330 214 L440 132 L550 118 L660 74" fill="none" stroke="#1639c5" stroke-width="9"/><path d="M110 270 L220 236 L330 224 L440 188 L550 170 L660 148" fill="none" stroke="#6f7f73" stroke-width="7"/><g fill="#1639c5"><circle cx="110" cy="250" r="8"/><circle cx="220" cy="198" r="8"/><circle cx="330" cy="214" r="8"/><circle cx="440" cy="132" r="8"/><circle cx="550" cy="118" r="8"/><circle cx="660" cy="74" r="8"/></g><g fill="#6f7f73"><circle cx="110" cy="270" r="7"/><circle cx="220" cy="236" r="7"/><circle cx="330" cy="224" r="7"/><circle cx="440" cy="188" r="7"/><circle cx="550" cy="170" r="7"/><circle cx="660" cy="148" r="7"/></g></svg>`
+
+const BOOK_ILLUSTRATION_SVG = `<svg viewBox="0 0 740 360" role="img" aria-label="Quiet atlas landscape illustration"><rect width="740" height="360" fill="#fbfaf7"/><path d="M80 260 C172 154 248 292 342 188 S514 112 650 236" fill="none" stroke="#202020" stroke-width="8"/><path d="M96 218 C150 132 240 124 312 202 C236 244 162 248 96 218Z" fill="#c7d0bf"/><path d="M420 92 C520 62 610 88 676 150 C570 156 494 148 420 92Z" fill="#d6c4a9"/><line x1="508" y1="72" x2="508" y2="292" stroke="#2a2a2a" stroke-width="4"/><path d="M96 302 H650" stroke="#d7d0c4" stroke-width="4"/></svg>`
+
+export const PURE_RENDER_WRITER_SAMPLE_HTML = `<h1 class="doc-title">Field Notes for a Quiet Export</h1>
+<p>This Writer sample is deliberately larger than a smoke test. It reads like a real working document: a title, short and long paragraphs, lists, a callout, figures, tables, equations, footnotes, and enough prose to make page flow visible under different Pure Render themes.</p>
+<p>The first page should feel like a clean draft rather than a journal article. The typography should stay calm, the page should remain white, and object labels should be readable without turning the document into a production manuscript.</p>
+<h2>Planning Context</h2>
+<p>Teams often begin in Writer with material that is not ready for a formal profile. A useful proof keeps the author's intent visible: emphasized phrases, inline code such as <code>renderProfile</code>, review marks like <mark>confirm this claim</mark>, and compact notes that remain anchored to the surrounding sentence.</p>
+<p>A longer paragraph follows so pagination can be reviewed with realistic line breaks. The design system should preserve a comfortable measure even when the source editor contains mixed elements, cross references, and repeated objects. The goal is not to make Writer look like Manuscript or Book, but to prove that the same semantic HTML can move through the same token system without losing its working-document character.</p>
+<p>Draft prose can include a note<sup id="fnref-writer-sample-1"><a href="#fn-writer-sample-1">1</a></sup>, another longer note<sup id="fnref-writer-sample-2"><a href="#fn-writer-sample-2">2</a></sup>, and still export cleanly without duplicate markers.</p>
+<ul><li>Keep the document-first rhythm.</li><li>Preserve object labels and xrefs.</li><li>Make image placement problems visible.</li><li>Keep tables quiet enough for working review.</li></ul>
+<blockquote><p>A good Writer PDF feels like a clean working proof: direct, quiet, and still obviously editable.</p></blockquote>
+<figure data-asset-id="asset_fig_writer_sample">${WRITER_FIGURE_SVG}<figcaption>Editorial planning diagram used as a reference object in the Writer proof.</figcaption></figure>
+<p>See <a data-xref-target="asset_fig_writer_sample">Figure 1</a>, <a data-xref-target="asset_table_writer_sample">Table 1</a>, and <a data-xref-target="asset_blockMath_writer_sample">Equation 1</a>. The paragraph after the figure is intentionally long enough to test whether the figure creates an awkward blank page or whether ordinary prose continues in a balanced way after the object.</p>
+<table data-asset-id="asset_table_writer_sample"><caption>Writer sample review matrix.</caption><thead><tr><th>Area</th><th>Expected behavior</th><th>Risk caught</th></tr></thead><tbody><tr><td>Flow</td><td>Quiet working pages</td><td>Oversized spacing</td></tr><tr><td>Objects</td><td>Labels and xrefs visible</td><td>Detached captions</td></tr><tr><td>Tables</td><td>Subtle rules</td><td>Bulky grids</td></tr><tr><td>Notes</td><td>Footnotes normalize</td><td>Repeated markers</td></tr></tbody></table>
+<div data-type="block-math" data-asset-id="asset_blockMath_writer_sample">draft + review + tokens = export</div>
+<h2>Later Notes</h2>
+<p>This section exists to force a more realistic page break. It includes a short paragraph.</p>
+<p>It also includes a longer paragraph that should wrap several times and expose whether the renderer maintains a steady baseline rhythm after mixed content. A working document often alternates between compact bullets, explanatory prose, diagrams, and a table that was pasted from elsewhere. The sample should make those transitions visible without requiring the user to risk their own document.</p>
+<section class="footnotes"><ol><li id="fn-writer-sample-1">A compact Writer footnote proves notes normalize before pagination.</li><li id="fn-writer-sample-2">This longer Writer footnote is intentionally wordier so the proof can show how multiline notes behave at the bottom of a page without crowding the main text or repeating the footnote marker in the sentence.</li></ol></section>`
+
+export const PURE_RENDER_MANUSCRIPT_SAMPLE_HTML = `<section>
+<h2>Introduction</h2>
+<p>This complete article sample exercises manuscript structure: sections, citations, footnotes, figures, tables, equations, declarations, references, and enough body text to make two-column and single-column pagination issues visible. It is deliberately larger than a smoke test so visual typesetting can inspect real page turns, object clusters, and footnote pressure.</p>
+<p>The sample cites shared renderer work <cite class="ps-citation" data-ref-ids="ref-render">[1]</cite>, a layout study <cite class="ps-citation" data-ref-ids="ref-layout">[2]</cite>, a dataset report <cite class="ps-citation" data-ref-ids="ref-dataset">[3]</cite>, and a software reference <cite class="ps-citation" data-ref-ids="ref-software">[4]</cite>. It includes a short page footnote<sup id="fnref-ms-sample-1"><a href="#fn-ms-sample-1">1</a></sup>, a longer explanatory note<sup id="fnref-ms-sample-2"><a href="#fn-ms-sample-2">2</a></sup>, and repeated citations so numbering and note markers can be checked after pagination.</p>
+<p>Manuscripts are a high-value target because small layout failures are easy to spot. A figure can strand a section heading, a table can leave a half-page hole, a footnote can collide with running text, and a two-column page can accidentally become a set of full-width section bands. This sample intentionally includes those pressure points in a realistic article.</p>
+<p>We also include mixed inline content: <strong>important claims</strong>, <em>emphasized terms</em>, <code>renderProfile</code>, and linked cross references. These should remain quiet in the PDF and should not disturb line height or column balance.</p>
+</section>
+<section>
+<h2>Methods</h2>
+<p>Methods prose is intentionally longer than a smoke test. It should show section numbering, scholarly spacing, table density, citation labels, and footnote handling across page turns. The source remains semantic: the editor supplies sections, objects, citations, and references; the print system owns presentation.</p>
+<ol><li>Normalize shared editor HTML into a canonical article.</li><li>Compile design tokens from a preset, description, or reference image.</li><li>Materialize figure, table, equation, and reference labels before pagination.</li><li>Render with Paged.js and inspect page images for layout hazards.</li></ol>
+<p>We add another paragraph here so a two-column profile has to flow down the first column before continuing in the next column. Section headings should not create artificial full-width bands unless a profile explicitly asks for a full-span break.</p>
+<p>The manuscript includes a procedure table near prose rather than isolated at the end. That placement helps reveal whether a table is pushed too aggressively or whether the renderer can preserve nearby explanatory text.</p>
+<table data-asset-id="asset_table_ms_methods"><caption>Methods checklist with dense but readable cells.</caption><thead><tr><th>Step</th><th>Input</th><th>Expected output</th><th>Risk caught</th></tr></thead><tbody><tr><td>Normalize</td><td>Shared editor HTML</td><td>Canonical article</td><td>Forbidden attributes</td></tr><tr><td>Compile</td><td>Preset or reference</td><td>Safe tokens</td><td>Poor contrast</td></tr><tr><td>Paginate</td><td>Print HTML</td><td>Page boxes</td><td>Blank regions</td></tr><tr><td>Inspect</td><td>Page snapshot</td><td>Report entries</td><td>Object drift</td></tr></tbody></table>
+<p>Equation <a data-xref-target="asset_blockMath_ms_method">1</a> describes a simple inspection score. It is not meant as a statistical model; it is a compact object used to test equation labels, xrefs, and inline spacing.</p>
+<div data-type="block-math" data-asset-id="asset_blockMath_ms_method">inspection = flow + objects + notes + contrast</div>
+</section>
+<section>
+<h2>Results</h2>
+<p>The first result object is a wide figure placed after enough prose to make its page-break behavior visible. It should avoid stranding the heading above it and should keep its caption attached.</p>
+<figure data-asset-id="asset_fig_ms_sample">${MANUSCRIPT_PLOT_SVG}<figcaption>Reference-driven manuscript plot with two series and enough width to expose figure placement decisions.</figcaption></figure>
+<p>Figure placement should avoid stranding headings or detaching captions. See <a data-xref-target="asset_fig_ms_sample">Figure 1</a>, <a data-xref-target="asset_table_ms_sample">Table 2</a>, and <a data-xref-target="asset_blockMath_ms_sample">Equation 2</a>. The surrounding prose should continue naturally after the object cluster rather than leaving a large blank page before the next section.</p>
+<table data-asset-id="asset_table_ms_sample"><caption>Sample manuscript table with several rows.</caption><thead><tr><th>Condition</th><th>Observed behavior</th><th>Interpretation</th></tr></thead><tbody><tr><td>Baseline</td><td>Labels render</td><td>Contract intact</td></tr><tr><td>Candidate</td><td>Rules quiet down</td><td>Theme applied</td></tr><tr><td>Long object</td><td>Caption stays attached</td><td>Placement acceptable</td></tr><tr><td>Two-column</td><td>Text flows downward</td><td>No section banding</td></tr><tr><td>Footnotes</td><td>Markers remain singular</td><td>No repeated numbers</td></tr><tr><td>References</td><td>Citations resolve</td><td>Back matter stable</td></tr></tbody></table>
+<div data-type="block-math" data-asset-id="asset_blockMath_ms_sample">signal = evidence + semantic layout + review</div>
+<p>The result paragraphs continue after the equation to reveal how much vertical space remains on the page. This is where a vision-assisted correction loop can become useful: the renderer can identify suspicious blank regions, capture page snapshots, and ask a layout agent to decide whether an object should move, resize, span, or stay anchored.</p>
+<p>A second figure follows after additional prose so the PDF includes more than one object placement decision. The two figures should not collapse into a decorative block, and the captions should remain close to their objects.</p>
+<figure data-asset-id="asset_fig_ms_secondary">${WRITER_FIGURE_SVG}<figcaption>Secondary manuscript figure used to test repeated object numbering and downstream page balance.</figcaption></figure>
+<p>The secondary figure is referenced later as <a data-xref-target="asset_fig_ms_secondary">Figure 2</a>. Repeated xrefs should use stable materialized labels in the final PDF rather than relying on live CSS counters.</p>
+</section>
+<section>
+<h2>Extended analysis</h2>
+<p>This section exists mostly to force realistic page breaks. It begins with a short paragraph.</p>
+<p>Then it continues with longer prose. In a real manuscript, the analysis section often contains several paragraphs between objects, references to previous tables, and footnotes that explain limitations without interrupting the main argument. This paragraph intentionally wraps many times so a visual snapshot can reveal whether the line length, justification, and leading remain comfortable in both one-column and two-column layouts.</p>
+<p>Another long paragraph follows, citing the layout study again <cite class="ps-citation" data-ref-ids="ref-layout">[2]</cite>. The renderer should keep citation numbering stable, avoid duplicated footnote markers, and maintain a white page background unless a reference image very strongly indicates otherwise. This paragraph also gives the vision tab something useful to inspect if the rendered page has a large blank region before or after an object.</p>
+<blockquote><p>Semantic content should remain stable while profiles change the print shape.</p></blockquote>
+<p>A final analysis paragraph adds more flow after the block quote. The quote should not create an oversized boxed treatment, and the text following it should resume with normal scholarly rhythm.</p>
+</section>
+<section>
+<h2>Discussion</h2>
+<p>The discussion includes both short and long paragraphs. Short paragraphs reveal heading spacing. Longer paragraphs reveal column rhythm, footnote pressure, and the interaction between table placement and subsequent text.</p>
+<p>The manuscript profile should remain conservative: white background unless the reference image strongly proves otherwise, clear scholarly hierarchy, quiet table rules, and no decorative color fields unless they belong to marks or object labels. If the beta vision typesetter inspects a PDF page with no detected issues, the event stream should say so and keep a snapshot available for review.</p>
+<p>A final discussion paragraph forces more page flow and gives the proof a realistic back matter transition. It cites the layout study again <cite class="ps-citation" data-ref-ids="ref-layout">[2]</cite> and makes sure repeated citations do not reset numbering. It also includes a final long footnote<sup id="fnref-ms-sample-3"><a href="#fn-ms-sample-3">3</a></sup> to stress bottom-of-page note layout.</p>
+</section>
+<section data-type="acknowledgments"><h2>Acknowledgments</h2><p>The authors thank the shared editor and renderer maintainers for turning print export into a system rather than a one-off stylesheet. This paragraph is intentionally normal prose so the acknowledgments section can be checked as unnumbered back matter.</p></section>
+<section data-type="data-availability"><h2>Data availability</h2><p>All generated sample data are embedded in this fixture. The sample cites a dataset record <cite class="ps-citation" data-ref-ids="ref-dataset">[3]</cite> so data availability and references can be reviewed together.</p></section>
+<section data-type="funding"><h2>Funding</h2><p>This sample received no external funding. The funding statement is included to check declaration spacing near the end of a manuscript.</p></section>
+<section data-type="competing-interests"><h2>Competing interests</h2><p>The authors declare no competing interests.</p></section>
+<section data-type="author-contributions"><h2>Author contributions</h2><p>A.H. designed the shared render contract. M.S. reviewed manuscript profile requirements. J.E. reviewed export structure and acceptance tests.</p></section>
+<section data-type="references"><h2>References</h2><ol><li id="ref-render">Pure Render working group. Shared semantic print contracts. 2026.</li><li id="ref-layout">Atlas Layout Lab. Page object placement and pagination review. 2026.</li><li id="ref-dataset">Open Fixture Archive. Complex manuscript pagination dataset. 2026.</li><li id="ref-software">PureScience contributors. Pure Render beta typesetter. 2026.</li></ol></section>
+<section class="footnotes"><ol><li id="fn-ms-sample-1">A manuscript sample footnote proves inline notes normalize into page footnotes.</li><li id="fn-ms-sample-2">This longer manuscript footnote is intentionally expansive. It should wrap cleanly, remain visually subordinate to the main text, and avoid repeated inline footnote numbers when the marker is transformed for paged output. It also gives the vision inspection pass a realistic bottom-of-page region to evaluate.</li><li id="fn-ms-sample-3">This final note is deliberately long enough to occupy several lines. It should remain attached to the page where the note is called, avoid crowding the running text, and preserve a readable separation from the body copy even when a two-column manuscript profile is selected.</li></ol></section>`
+
+export const PURE_RENDER_BOOK_CHAPTER_SAMPLE_HTML = `<h2>Opening Movement</h2>
+<p>This book chapter sample is meant for trying the Book profile with content that looks like an actual chapter. It has an opener, long-form prose, a full illustration, a table, an equation, cross references, short paragraphs, long paragraphs, and enough continuation text to make running heads and folios worth checking.</p>
+<p>The chapter should keep a literary rhythm: calm paragraphs, generous but not wasteful margins, running heads, folios, and chapter-scoped object labels. Unlike a manuscript, the chapter should not feel like a journal article with numbered sections stacked on top of each other.</p>
+<p>Books often need images to land gracefully. A picture that is forced to a new page can leave unsightly white space before it; a caption that follows too late can feel detached. This sample keeps the figure near real prose so placement choices are obvious.</p>
+<figure data-asset-id="asset_fig_book_sample">${BOOK_ILLUSTRATION_SVG}<figcaption>Quiet atlas illustration used to test chapter object placement and caption treatment.</figcaption></figure>
+<p>See <a data-xref-target="asset_fig_book_sample">Figure 1.1</a>, <a data-xref-target="asset_table_book_sample">Table 1.1</a>, and <a data-xref-target="asset_blockMath_book_sample">Equation 1.1</a>. These labels should be materialized by the renderer rather than relying on counters that disappear in the final PDF.</p>
+<table data-asset-id="asset_table_book_sample"><caption>Book sample table.</caption><thead><tr><th>Element</th><th>Treatment</th><th>Reason</th></tr></thead><tbody><tr><td>Opening</td><td>Quiet</td><td>Chapter rhythm</td></tr><tr><td>Figures</td><td>Caption attached</td><td>Reader continuity</td></tr><tr><td>Tables</td><td>Subtle rules</td><td>No grid noise</td></tr><tr><td>Running heads</td><td>Later pages only</td><td>Clean openers</td></tr></tbody></table>
+<div data-type="block-math" data-asset-id="asset_blockMath_book_sample">chapter = prose + image + sequence</div>
+<h2>After the Object Cluster</h2>
+<p>This section continues after the figure, table, and equation so pagination can be reviewed across a real page turn. The paragraph is intentionally long, with a measured cadence that resembles narrative nonfiction or a research monograph. It should not be squeezed into a cramped column, and it should not inherit manuscript-style blue numbering unless the selected theme explicitly asks for that accent behavior.</p>
+<p>A shorter paragraph follows to show local spacing.</p>
+<p>Another long paragraph keeps the proof moving. The sample should make it easy to compare Clean, Journal Article, Quiet Book, and Draft Writer themes without the content itself changing. If a reference image suggests ornaments, running heads, or display typography, those decisions should compile into tokens and profile rules, not arbitrary CSS pasted into the chapter.</p>`
+
+export const PURE_RENDER_BOOK_SECOND_CHAPTER_SAMPLE_HTML = `<h2>A Second Chapter for Flow</h2>
+<p>This second sample chapter proves that the sample opens as a complete book, not a single overwritten chapter. It gives the Book profile another opener, another running head context, and more body text for testing chapter starts.</p>
+<p>The second chapter is quieter and mostly prose. It exists to test continuity: chapter-scoped numbering should reset, running heads should update, and page breaks should avoid carrying awkward leftover space from the previous chapter.</p>
+<figure data-asset-id="asset_fig_book_second_sample">${WRITER_FIGURE_SVG}<figcaption>Second chapter reference figure with a different visual rhythm.</figcaption></figure>
+<p>See <a data-xref-target="asset_fig_book_second_sample">Figure 2.1</a>. The proof should show whether object labels remain chapter-scoped once the book has more than one chapter.</p>
+<p>A final long paragraph closes the sample with enough text to force normal continuation pages. The reader should see a usable book proof with realistic transitions, not a decorative demo. That makes it much easier to judge whether a reference image has been emulated well enough in fonts, hierarchy, ornaments, running heads, and object treatment.</p>`