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

package/src/bridge/pureRender/document.test.ts

@@ -0,0 +1,283 @@
+import { describe, expect, it } from 'vitest'
+import { buildPureRenderHtmlDocument } from './document.js'
+import { PURE_RENDER_THEME_PRESETS } from './presets.js'
+import { buildPureRenderStylesheet } from './styles.js'
+
+describe('buildPureRenderHtmlDocument', () => {
+  it('assembles print CSS in the required layer order', () => {
+    const css = buildPureRenderStylesheet({ profile: 'manuscript' })
+    expect(css.indexOf('pure-render: reset')).toBeLessThan(
+      css.indexOf('pure-render: tokens'),
+    )
+    expect(css.indexOf('pure-render: tokens')).toBeLessThan(
+      css.indexOf('pure-render: base'),
+    )
+    expect(css.indexOf('pure-render: base')).toBeLessThan(
+      css.indexOf('pure-render: profile'),
+    )
+    expect(css.indexOf('pure-render: profile')).toBeLessThan(
+      css.indexOf('pure-render: flow'),
+    )
+    expect(css).toContain('--display:')
+    expect(css).toContain(
+      'section:not([data-type="abstract"]):not([data-type="frontmatter"]):not([data-type="backmatter"]):not([data-type="toc"]):not([data-type="references"]):not([data-type="endnotes"]):not([data-type="acknowledgments"]):not([data-type="part"]){ counter-increment:sec;',
+    )
+    expect(css).not.toContain('> h2{ counter-increment:sec;')
+  })
+
+  it('builds manuscript HTML with canonical front matter', () => {
+    const html = buildPureRenderHtmlDocument({
+      rootPath: '/tmp/ws',
+      request: {
+        profile: 'manuscript',
+        html: '<section><h2>Intro</h2><p>Body</p></section>',
+        metadata: {
+          title: 'Shared Render',
+          authorsText: 'A. Author',
+          abstractText: 'Abstract text.',
+        },
+      },
+    })
+
+    expect(html).toContain('<base href="file:///tmp/ws/">')
+    expect(html).toContain('class="pure-render pure-render-manuscript"')
+    expect(html).toContain('<article lang="en">')
+    expect(html).toContain('<h1 class="doc-title">Shared Render</h1>')
+    expect(html).toContain('data-type="abstract"')
+    expect(html).toContain('@page{ size:A4;')
+  })
+
+  it('renders the same tree through writer and book profiles', () => {
+    const request = {
+      html: '<section data-type="chapter"><h2>Opening</h2><p>Body</p></section>',
+      metadata: { title: 'Bookish' },
+    }
+    expect(
+      buildPureRenderHtmlDocument({
+        rootPath: '/tmp/ws',
+        request: { ...request, profile: 'writer' },
+      }),
+    ).toContain('pure-render-writer')
+    expect(
+      buildPureRenderHtmlDocument({
+        rootPath: '/tmp/ws',
+        request: { ...request, profile: 'book' },
+      }),
+    ).toContain('pure-render-book')
+  })
+
+  it('keeps the writer profile quiet and non-academic', () => {
+    const css = buildPureRenderStylesheet({ profile: 'writer' })
+
+    expect(css).toContain(
+      '.pure-render-writer{ --text-align:var(--theme-text-align,left); --hyphenate:var(--theme-hyphenate,manual); }',
+    )
+    expect(css).toContain(
+      '.pure-render-writer p + p{ text-indent:0; margin-top:calc(var(--rhythm)*.55); }',
+    )
+    expect(css).toContain('h2::before,h3::before{ content:none; }')
+    expect(css).toContain(
+      'h4{ font-size:calc(var(--t-h3)*.88); font-weight:600;',
+    )
+    expect(css).toContain(
+      'cite.ps-citation{ font-style:normal; white-space:nowrap;',
+    )
+    expect(css).toContain(
+      '.pure-render-writer section[data-type="references"] ol{ list-style:decimal;',
+    )
+    expect(css).toContain(
+      '.pure-render-writer section[data-type="references"] li::before{ content:none; }',
+    )
+  })
+
+  it('lets theme tune controls drive writer alignment and hyphenation', () => {
+    const html = buildPureRenderHtmlDocument({
+      rootPath: '/tmp/ws',
+      request: {
+        profile: 'writer',
+        html: '<section><h2>Notes</h2><p>Body</p></section>',
+        theme: {
+          ...PURE_RENDER_THEME_PRESETS[0]!.theme,
+          setting: { align: 'justified', hyphenate: true },
+        },
+      },
+    })
+
+    expect(html).toContain('--theme-text-align:justify;')
+    expect(html).toContain('--theme-hyphenate:auto;')
+    expect(html).toContain('--text-align:var(--theme-text-align);')
+    expect(html).toContain('--hyphenate:var(--theme-hyphenate);')
+    expect(html).toContain(
+      '.pure-render-writer{ --text-align:var(--theme-text-align,left); --hyphenate:var(--theme-hyphenate,manual); }',
+    )
+  })
+
+  it('flows two-column manuscripts through the article instead of each section', () => {
+    const css = buildPureRenderStylesheet({ profile: 'manuscript' })
+
+    expect(css).toContain(
+      '[data-variant="two-column"]{ column-count:2; column-gap:7mm; column-fill:auto; }',
+    )
+    expect(css).toContain(
+      '[data-variant="two-column"] > section[data-type="abstract"]{ column-span:all; }',
+    )
+    expect(css).toContain(
+      '[data-variant="two-column"] figure[data-span="page"],[data-variant="two-column"] .table-wrap[data-span="page"]{ column-span:all; }',
+    )
+    expect(css).not.toContain(
+      '[data-variant="two-column"] section{ column-count:2;',
+    )
+  })
+
+  it('styles editor highlights and separators without app-specific CSS', () => {
+    const css = buildPureRenderStylesheet({ profile: 'writer' })
+
+    expect(css).toContain(
+      'mark{ background:color-mix(in srgb, var(--accent) 14%, transparent);',
+    )
+    expect(css).toContain(
+      'hr{ border:0; border-top:1px solid var(--rule-soft);',
+    )
+  })
+
+  it('applies each shared preset as real token CSS in assembled output', () => {
+    const assembled = PURE_RENDER_THEME_PRESETS.map(preset => ({
+      preset,
+      html: buildPureRenderHtmlDocument({
+        rootPath: '/tmp/ws',
+        request: {
+          profile: 'manuscript',
+          html: '<section><h2>Intro</h2><p>Body</p></section>',
+          theme: preset.theme,
+        },
+      }),
+    }))
+
+    expect(assembled).toHaveLength(PURE_RENDER_THEME_PRESETS.length)
+    for (const { preset, html } of assembled) {
+      expect(html).toContain(`--ink:${preset.theme.color.ink};`)
+      expect(html).toContain(`--accent:${preset.theme.color.accent};`)
+      expect(html).toContain(`--body:${preset.theme.type.body};`)
+      expect(html).toContain(`--measure:${preset.theme.type.measure};`)
+      expect(html).toContain(`--display:${preset.theme.type.fonts.display}`)
+    }
+
+    expect(new Set(assembled.map(item => item.preset.theme.name)).size).toBe(
+      PURE_RENDER_THEME_PRESETS.length,
+    )
+    expect(
+      new Set(assembled.map(item => item.preset.theme.color.accent)).size,
+    ).toBeGreaterThan(4)
+    expect(
+      new Set(assembled.map(item => item.preset.theme.type.measure)).size,
+    ).toBeGreaterThan(4)
+    expect(
+      assembled.find(item => item.preset.id === 'journal-article')?.html,
+    ).toContain('--caption-label-transform:uppercase;')
+    expect(
+      assembled.find(item => item.preset.id === 'journal-article')?.html,
+    ).toContain('--table-cell-padding-y:.24rem;')
+    expect(
+      assembled.find(item => item.preset.id === 'modern-report')?.html,
+    ).toContain(
+      '--table-header-bg:color-mix(in srgb, var(--accent) 10%, var(--paper));',
+    )
+    expect(
+      assembled.find(item => item.preset.id === 'quiet-book')?.html,
+    ).toContain('--table-row-rule-color:transparent;')
+    expect(
+      new Set(
+        assembled.map(item =>
+          item.html.match(/--table-header-bg:([^;]+);/)?.[1] ?? '',
+        ),
+      ).size,
+    ).toBeGreaterThan(1)
+  })
+
+  it('keeps book figure captions on materialized labels', () => {
+    const css = buildPureRenderStylesheet({ profile: 'book' })
+
+    expect(css).toContain(
+      'figcaption::before{ content:"Figure " attr(data-label) ".\\00a0"; }',
+    )
+    expect(css).toContain(
+      'a.xref-fig::after,a.xref-tbl::after,a.xref-eq::after{ content:none; }',
+    )
+    expect(css).not.toContain('counter(sec) "." counter(fig)')
+    expect(css).not.toContain('target-counter(attr(href), fig)')
+  })
+
+  it('includes book title-page and TOC profile rules', () => {
+    const css = buildPureRenderStylesheet({ profile: 'book' })
+
+    expect(css).toContain(
+      '.pure-render-book > article > .doc-title{ break-after:page;',
+    )
+    expect(css).toContain(
+      'section[data-type="toc"] a::after{ content:leader(\'.\') target-counter(attr(href), page);',
+    )
+    expect(css).toContain(
+      'section[data-type="chapter"] > h2{ counter-increment:none; }',
+    )
+  })
+
+  it('keeps structural book matter out of generic section numbering', () => {
+    const css = buildPureRenderStylesheet({ profile: 'book' })
+
+    expect(css).toContain(':not([data-type="backmatter"])')
+    expect(css).toContain(':not([data-type="acknowledgments"])')
+    expect(css).toContain(':not([data-type="part"])')
+    expect(css).toContain('section[data-type="backmatter"] > h2::before,')
+    expect(css).toContain('section[data-type="acknowledgments"] > h2::before,')
+    expect(css).toContain(
+      'section[data-type="part"] > h2::before{ content:none; }',
+    )
+  })
+
+  it('consumes profile rule variables in shared print CSS', () => {
+    const css = buildPureRenderStylesheet({
+      profile: 'book',
+      theme: {
+        name: 'Reference Page',
+        version: '1.0.0',
+        color: {
+          ink: '#111111',
+          'ink-soft': '#333333',
+          muted: '#777777',
+          paper: '#ffffff',
+          rule: '#cccccc',
+          'rule-soft': '#eeeeee',
+          accent: '#775500',
+        },
+        type: {
+          body: '10.6pt',
+          lead: 1.5,
+          measure: '34rem',
+          scaleRatio: 1.333,
+          fonts: {
+            serif: 'Georgia, serif',
+            sans: 'Arial, sans-serif',
+            mono: 'monospace',
+          },
+        },
+        rhythm: '15.9pt',
+        profile_rules: {
+          running_heads: { transform: 'none', rule: 'hairline' },
+          opener: { spacing: 'generous', ornament: 'rule' },
+          table: { rule_weight: 'hairline' },
+          caption: { label_style: 'small-caps' },
+        },
+      },
+    })
+
+    expect(css).toContain('--running-head-transform:none;')
+    expect(css).toContain('--chapter-opener-padding:28%;')
+    expect(css).toContain('text-transform:var(--running-head-transform);')
+    expect(css).toContain('border-bottom:var(--running-head-rule)')
+    expect(css).toContain('margin:var(--chapter-opener-padding)')
+    expect(css).toContain('font-weight:var(--caption-label-weight)')
+    expect(css).toContain('border-bottom:var(--table-rule-width)')
+    expect(css).toContain('background:var(--table-header-bg)')
+    expect(css).toContain('padding:var(--table-cell-padding-y)')
+  })
+})

package/src/bridge/pureRender/document.ts

@@ -0,0 +1,35 @@
+import { buildPrintHtmlDocument } from '../printDocument.js'
+import { normalizePureRenderHtml } from './normalize.js'
+import { buildPureRenderStylesheet } from './styles.js'
+import type { PureRenderRequest } from './types.js'
+
+export function buildPureRenderHtmlDocument(options: {
+  rootPath: string
+  request: PureRenderRequest
+  title?: string
+}): string {
+  const normalized = normalizePureRenderHtml({
+    html: options.request.html,
+    profile: options.request.profile,
+    metadata: options.request.metadata,
+    options: options.request.options,
+  })
+  if (normalized.errors.length > 0) {
+    throw new Error(
+      `Pure Render validation failed: ${normalized.errors
+        .map(error => `${error.code}: ${error.message}`)
+        .join('; ')}`,
+    )
+  }
+
+  return buildPrintHtmlDocument({
+    rootPath: options.rootPath,
+    title: options.title ?? normalized.title,
+    stylesheet: buildPureRenderStylesheet({
+      profile: options.request.profile,
+      theme: options.request.theme,
+    }),
+    bodyClass: `pure-render pure-render-${options.request.profile}`,
+    bodyHtml: normalized.html,
+  })
+}