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

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

@@ -1,279 +1,279 @@
-import { describe, expect, it } from 'vitest'
-import { compilePrintTheme } from './compiler.js'
-import type { PrintStyleProfile } from './types.js'
-
-function profile(
-  overrides: Partial<PrintStyleProfile> = {},
-): PrintStyleProfile {
-  return {
-    schema_version: '1.0',
-    exemplar_quality: {
-      usable: true,
-      reason: 'clean page',
-      confidence: 0.9,
-    },
-    observations: {
-      palette: [
-        {
-          role: 'surface',
-          approx_hex: '#FFFFFF',
-          confidence: 0.9,
-        },
-        {
-          role: 'ink',
-          approx_hex: '#DDDDDD',
-          confidence: 0.9,
-        },
-        {
-          role: 'accent',
-          approx_hex: '#7A1F2B',
-          confidence: 0.9,
-        },
-      ],
-      type: [
-        {
-          role: 'display',
-          class: 'serif',
-          serif_detail: 'hairline',
-          confidence: 0.9,
-        },
-        {
-          role: 'body',
-          class: 'serif',
-          serif_detail: 'bracketed',
-          confidence: 0.9,
-        },
-        { role: 'caption', class: 'sans', confidence: 0.9 },
-      ],
-      type_pairing: { size_contrast: 'dramatic', confidence: 0.9 },
-      text_setting: {
-        alignment: 'flush-left',
-        hyphenation: 'absent',
-        measure_cpl: 58,
-        leading_feel: 'airy',
-        confidence: 0.9,
-      },
-      page_model: {
-        columns: 2,
-        margin_asymmetry: 'inner<outer',
-        confidence: 0.4,
-      },
-    },
-    rules: [
-      { rule: 'keep accent sparse', confidence: 0.9 },
-      { rule: 'ignore weak rule', confidence: 0.3 },
-    ],
-    derived: null,
-    ...overrides,
-  }
-}
-
-describe('compilePrintTheme', () => {
-  it('repairs weak ink contrast and maps display/body fonts separately', () => {
-    const result = compilePrintTheme(profile())
-
-    expect(result.theme?.color.ink).not.toBe('#DDDDDD')
-    expect(result.decisions.map(([type]) => type)).toContain('repair')
-    expect(result.theme?.type.fonts.display).toContain('Newsreader')
-    expect(result.theme?.type.fonts.serif).toContain('Source Serif 4')
-    expect(result.theme?.type.fonts.sans).toContain('Archivo')
-  })
-
-  it('derives measure, leading, ratio, and rules with confidence gates', () => {
-    const result = compilePrintTheme(profile())
-
-    expect(result.theme?.type.measure).toBe('29.0rem')
-    expect(result.theme?.type.lead).toBe(1.65)
-    expect(result.theme?.type.scaleRatio).toBe(1.414)
-    expect(result.theme?.setting).toEqual({
-      align: 'flush-left',
-      hyphenate: false,
-    })
-    expect(result.theme?.page?.columns).toBe(1)
-    expect(result.rules).toEqual(['keep accent sparse'])
-  })
-
-  it('keeps manuscript-like paper white unless surface evidence is strong', () => {
-    const result = compilePrintTheme(
-      profile({
-        observations: {
-          ...profile().observations,
-          palette: [
-            { role: 'surface', approx_hex: '#F5F5F0', confidence: 0.82 },
-            { role: 'ink', approx_hex: '#222222', confidence: 0.9 },
-          ],
-          finish: { register: 'scholarly', confidence: 0.8 },
-        },
-      }),
-    )
-
-    expect(result.theme?.color.paper).toBe('#FFFFFF')
-    expect(result.decisions).toContainEqual([
-      'fallback',
-      'manuscript surface #F5F5F0 confidence 0.82 < 0.95 -> white paper',
-    ])
-  })
-
-  it('allows manuscript-like paper tint when surface evidence is strong', () => {
-    const result = compilePrintTheme(
-      profile({
-        observations: {
-          ...profile().observations,
-          palette: [
-            { role: 'surface', approx_hex: '#F5F5F0', confidence: 0.98 },
-            { role: 'ink', approx_hex: '#222222', confidence: 0.9 },
-          ],
-          finish: { register: 'scholarly', confidence: 0.8 },
-        },
-      }),
-    )
-
-    expect(result.theme?.color.paper).toBe('#F5F5F0')
-  })
-
-  it('rejects unusable exemplars', () => {
-    const result = compilePrintTheme(
-      profile({
-        exemplar_quality: {
-          usable: false,
-          reason: 'mixed unrelated styles',
-          confidence: 0.9,
-        },
-      }),
-    )
-
-    expect(result.theme).toBeNull()
-    expect(result.decisions[0]).toEqual([
-      'reject',
-      'exemplar flagged unusable: mixed unrelated styles',
-    ])
-  })
-
-  it('compiles reference-page furniture into structured profile rules', () => {
-    const base = profile()
-    const result = compilePrintTheme({
-      ...base,
-      observations: {
-        ...base.observations,
-        type_scale: {
-          body_pt: 11.2,
-          title_scale: 2.4,
-          section_scale: 1.35,
-          confidence: 0.82,
-        },
-        running_heads: {
-          presence: 'present',
-          position: 'top outside',
-          transform: 'uppercase',
-          rule: 'none',
-          font_role: 'caption',
-          confidence: 0.84,
-        },
-        folio: {
-          position: 'bottom center',
-          style: 'plain',
-          suppress_on: ['opener'],
-          confidence: 0.78,
-        },
-        opener: {
-          spacing: 'generous',
-          recto_start: true,
-          ornament: 'rule',
-          drop_cap: false,
-          confidence: 0.8,
-        },
-        ornaments: {
-          kind: 'rule',
-          weight: 'hairline',
-          placement: 'above chapter title',
-          confidence: 0.76,
-        },
-        table_treatment: {
-          rule_weight: 'hairline',
-          header_treatment: 'small caps',
-          density: 'balanced',
-          confidence: 0.88,
-        },
-        caption_treatment: {
-          position: 'below',
-          label_style: 'bold',
-          alignment: 'left',
-          confidence: 0.9,
-        },
-      },
-    })
-
-    expect(result.theme?.type.body).toBe('11.2pt')
-    expect(result.theme?.profile_rules).toMatchObject({
-      running_heads: {
-        presence: 'present',
-        position: 'top outside',
-        transform: 'uppercase',
-      },
-      folio: { position: 'bottom center' },
-      opener: { spacing: 'generous', recto_start: true, ornament: 'rule' },
-      ornaments: { kind: 'rule', weight: 'hairline' },
-      table: { rule_weight: 'hairline', density: 'balanced' },
-      caption: { position: 'below', label_style: 'bold' },
-    })
-    expect(result.theme?.enforced_rules).toContain(
-      'Reference page furniture: running heads present at top outside.',
-    )
-    expect(result.theme?.enforced_rules).toContain(
-      'Reference tables: hairline rules, balanced density.',
-    )
-    expect(result.decisions).toContainEqual([
-      'apply',
-      'running heads present top outside',
-    ])
-    expect(result.decisions).toContainEqual([
-      'warn',
-      'font matching uses licensed substitutes; exact font identity is not guaranteed.',
-    ])
-    expect(result.decisions).toContainEqual([
-      'warn',
-      'point sizes are approximate; reference pages provide scale and contrast, not exact measurements.',
-    ])
-    expect(result.decisions).toContainEqual([
-      'warn',
-      'page geometry is approximate; margins and trim are applied only when confidence clears the compiler threshold.',
-    ])
-    expect(result.decisions).toContainEqual([
-      'warn',
-      'ornaments are mapped to supported rules/dividers; arbitrary custom ornament replication is unsupported.',
-    ])
-    expect(
-      result.theme?.enforced_rules?.some(rule => rule.includes('exact')),
-    ).toBe(false)
-  })
-
-  it('drops low-confidence page furniture to profile defaults', () => {
-    const base = profile()
-    const result = compilePrintTheme({
-      ...base,
-      observations: {
-        ...base.observations,
-        running_heads: {
-          presence: 'present',
-          position: 'top outside',
-          confidence: 0.4,
-        },
-        ornaments: {
-          kind: 'fleuron',
-          confidence: 0.2,
-        },
-      },
-    })
-
-    expect(result.theme?.profile_rules).toBeUndefined()
-    expect(result.theme?.enforced_rules).toEqual(['keep accent sparse'])
-    expect(result.decisions).toContainEqual([
-      'fallback',
-      'running_heads confidence 0.4 < 0.6 -> profile default',
-    ])
-    expect(result.decisions).toContainEqual([
-      'fallback',
-      'ornaments confidence 0.2 < 0.6 -> none/default',
-    ])
-  })
-})
+import { describe, expect, it } from 'vitest'
+import { compilePrintTheme } from './compiler.js'
+import type { PrintStyleProfile } from './types.js'
+
+function profile(
+  overrides: Partial<PrintStyleProfile> = {},
+): PrintStyleProfile {
+  return {
+    schema_version: '1.0',
+    exemplar_quality: {
+      usable: true,
+      reason: 'clean page',
+      confidence: 0.9,
+    },
+    observations: {
+      palette: [
+        {
+          role: 'surface',
+          approx_hex: '#FFFFFF',
+          confidence: 0.9,
+        },
+        {
+          role: 'ink',
+          approx_hex: '#DDDDDD',
+          confidence: 0.9,
+        },
+        {
+          role: 'accent',
+          approx_hex: '#7A1F2B',
+          confidence: 0.9,
+        },
+      ],
+      type: [
+        {
+          role: 'display',
+          class: 'serif',
+          serif_detail: 'hairline',
+          confidence: 0.9,
+        },
+        {
+          role: 'body',
+          class: 'serif',
+          serif_detail: 'bracketed',
+          confidence: 0.9,
+        },
+        { role: 'caption', class: 'sans', confidence: 0.9 },
+      ],
+      type_pairing: { size_contrast: 'dramatic', confidence: 0.9 },
+      text_setting: {
+        alignment: 'flush-left',
+        hyphenation: 'absent',
+        measure_cpl: 58,
+        leading_feel: 'airy',
+        confidence: 0.9,
+      },
+      page_model: {
+        columns: 2,
+        margin_asymmetry: 'inner<outer',
+        confidence: 0.4,
+      },
+    },
+    rules: [
+      { rule: 'keep accent sparse', confidence: 0.9 },
+      { rule: 'ignore weak rule', confidence: 0.3 },
+    ],
+    derived: null,
+    ...overrides,
+  }
+}
+
+describe('compilePrintTheme', () => {
+  it('repairs weak ink contrast and maps display/body fonts separately', () => {
+    const result = compilePrintTheme(profile())
+
+    expect(result.theme?.color.ink).not.toBe('#DDDDDD')
+    expect(result.decisions.map(([type]) => type)).toContain('repair')
+    expect(result.theme?.type.fonts.display).toContain('Newsreader')
+    expect(result.theme?.type.fonts.serif).toContain('Source Serif 4')
+    expect(result.theme?.type.fonts.sans).toContain('Archivo')
+  })
+
+  it('derives measure, leading, ratio, and rules with confidence gates', () => {
+    const result = compilePrintTheme(profile())
+
+    expect(result.theme?.type.measure).toBe('29.0rem')
+    expect(result.theme?.type.lead).toBe(1.65)
+    expect(result.theme?.type.scaleRatio).toBe(1.414)
+    expect(result.theme?.setting).toEqual({
+      align: 'flush-left',
+      hyphenate: false,
+    })
+    expect(result.theme?.page?.columns).toBe(1)
+    expect(result.rules).toEqual(['keep accent sparse'])
+  })
+
+  it('keeps manuscript-like paper white unless surface evidence is strong', () => {
+    const result = compilePrintTheme(
+      profile({
+        observations: {
+          ...profile().observations,
+          palette: [
+            { role: 'surface', approx_hex: '#F5F5F0', confidence: 0.82 },
+            { role: 'ink', approx_hex: '#222222', confidence: 0.9 },
+          ],
+          finish: { register: 'scholarly', confidence: 0.8 },
+        },
+      }),
+    )
+
+    expect(result.theme?.color.paper).toBe('#FFFFFF')
+    expect(result.decisions).toContainEqual([
+      'fallback',
+      'manuscript surface #F5F5F0 confidence 0.82 < 0.95 -> white paper',
+    ])
+  })
+
+  it('allows manuscript-like paper tint when surface evidence is strong', () => {
+    const result = compilePrintTheme(
+      profile({
+        observations: {
+          ...profile().observations,
+          palette: [
+            { role: 'surface', approx_hex: '#F5F5F0', confidence: 0.98 },
+            { role: 'ink', approx_hex: '#222222', confidence: 0.9 },
+          ],
+          finish: { register: 'scholarly', confidence: 0.8 },
+        },
+      }),
+    )
+
+    expect(result.theme?.color.paper).toBe('#F5F5F0')
+  })
+
+  it('rejects unusable exemplars', () => {
+    const result = compilePrintTheme(
+      profile({
+        exemplar_quality: {
+          usable: false,
+          reason: 'mixed unrelated styles',
+          confidence: 0.9,
+        },
+      }),
+    )
+
+    expect(result.theme).toBeNull()
+    expect(result.decisions[0]).toEqual([
+      'reject',
+      'exemplar flagged unusable: mixed unrelated styles',
+    ])
+  })
+
+  it('compiles reference-page furniture into structured profile rules', () => {
+    const base = profile()
+    const result = compilePrintTheme({
+      ...base,
+      observations: {
+        ...base.observations,
+        type_scale: {
+          body_pt: 11.2,
+          title_scale: 2.4,
+          section_scale: 1.35,
+          confidence: 0.82,
+        },
+        running_heads: {
+          presence: 'present',
+          position: 'top outside',
+          transform: 'uppercase',
+          rule: 'none',
+          font_role: 'caption',
+          confidence: 0.84,
+        },
+        folio: {
+          position: 'bottom center',
+          style: 'plain',
+          suppress_on: ['opener'],
+          confidence: 0.78,
+        },
+        opener: {
+          spacing: 'generous',
+          recto_start: true,
+          ornament: 'rule',
+          drop_cap: false,
+          confidence: 0.8,
+        },
+        ornaments: {
+          kind: 'rule',
+          weight: 'hairline',
+          placement: 'above chapter title',
+          confidence: 0.76,
+        },
+        table_treatment: {
+          rule_weight: 'hairline',
+          header_treatment: 'small caps',
+          density: 'balanced',
+          confidence: 0.88,
+        },
+        caption_treatment: {
+          position: 'below',
+          label_style: 'bold',
+          alignment: 'left',
+          confidence: 0.9,
+        },
+      },
+    })
+
+    expect(result.theme?.type.body).toBe('11.2pt')
+    expect(result.theme?.profile_rules).toMatchObject({
+      running_heads: {
+        presence: 'present',
+        position: 'top outside',
+        transform: 'uppercase',
+      },
+      folio: { position: 'bottom center' },
+      opener: { spacing: 'generous', recto_start: true, ornament: 'rule' },
+      ornaments: { kind: 'rule', weight: 'hairline' },
+      table: { rule_weight: 'hairline', density: 'balanced' },
+      caption: { position: 'below', label_style: 'bold' },
+    })
+    expect(result.theme?.enforced_rules).toContain(
+      'Reference page furniture: running heads present at top outside.',
+    )
+    expect(result.theme?.enforced_rules).toContain(
+      'Reference tables: hairline rules, balanced density.',
+    )
+    expect(result.decisions).toContainEqual([
+      'apply',
+      'running heads present top outside',
+    ])
+    expect(result.decisions).toContainEqual([
+      'warn',
+      'font matching uses licensed substitutes; exact font identity is not guaranteed.',
+    ])
+    expect(result.decisions).toContainEqual([
+      'warn',
+      'point sizes are approximate; reference pages provide scale and contrast, not exact measurements.',
+    ])
+    expect(result.decisions).toContainEqual([
+      'warn',
+      'page geometry is approximate; margins and trim are applied only when confidence clears the compiler threshold.',
+    ])
+    expect(result.decisions).toContainEqual([
+      'warn',
+      'ornaments are mapped to supported rules/dividers; arbitrary custom ornament replication is unsupported.',
+    ])
+    expect(
+      result.theme?.enforced_rules?.some(rule => rule.includes('exact')),
+    ).toBe(false)
+  })
+
+  it('drops low-confidence page furniture to profile defaults', () => {
+    const base = profile()
+    const result = compilePrintTheme({
+      ...base,
+      observations: {
+        ...base.observations,
+        running_heads: {
+          presence: 'present',
+          position: 'top outside',
+          confidence: 0.4,
+        },
+        ornaments: {
+          kind: 'fleuron',
+          confidence: 0.2,
+        },
+      },
+    })
+
+    expect(result.theme?.profile_rules).toBeUndefined()
+    expect(result.theme?.enforced_rules).toEqual(['keep accent sparse'])
+    expect(result.decisions).toContainEqual([
+      'fallback',
+      'running_heads confidence 0.4 < 0.6 -> profile default',
+    ])
+    expect(result.decisions).toContainEqual([
+      'fallback',
+      'ornaments confidence 0.2 < 0.6 -> none/default',
+    ])
+  })
+})