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

package/src/bridge/pureRender/types.ts

@@ -1,264 +1,264 @@
-export type PureRenderProfile = 'writer' | 'manuscript' | 'book'
-
-export interface PureRenderMetadata {
-  title?: string
-  authorsHtml?: string
-  authorsText?: string
-  affiliationsHtml?: string
-  affiliationsText?: string
-  abstractHtml?: string
-  abstractText?: string
-  keywords?: readonly string[]
-  profileLabel?: string
-}
-
-export interface PureRenderOptions {
-  variant?: 'two-column' | string
-  pageSize?: string
-  outline?: boolean
-}
-
-export interface PureRenderRequest {
-  html: string
-  profile: PureRenderProfile
-  theme?: PureRenderTheme
-  metadata?: PureRenderMetadata
-  options?: PureRenderOptions
-}
-
-export interface PureRenderTheme {
-  $schema?: string
-  name: string
-  version: string
-  color: {
-    ink: string
-    'ink-soft': string
-    muted: string
-    surface?: string
-    paper?: string
-    rule: string
-    'rule-soft': string
-    accent: string
-    'accent-ink'?: string
-  }
-  type: {
-    body: string
-    lead: number | string
-    measure: string
-    scaleRatio: number
-    fonts: {
-      display?: string
-      serif: string
-      sans: string
-      mono: string
-    }
-  }
-  rhythm: string
-  page?: {
-    trim?: string
-    margin?: string
-    columns?: number
-    recto_verso?: boolean
-  }
-  setting?: {
-    align?: 'justified' | 'flush-left' | string
-    hyphenate?: boolean
-  }
-  enforced_rules?: readonly string[]
-  profile_rules?: PureRenderProfileRules
-}
-
-export interface PureRenderProfileRules {
-  running_heads?: {
-    presence?: 'present' | 'absent' | string
-    position?: string
-    transform?: 'uppercase' | 'small-caps' | 'title-case' | 'none' | string
-    rule?: 'none' | 'hairline' | 'solid' | string
-    font_role?: 'display' | 'body' | 'caption' | 'sans' | string
-  }
-  folio?: {
-    position?: string
-    style?: 'plain' | 'small-caps' | 'bracketed' | string
-    suppress_on?: readonly string[]
-  }
-  opener?: {
-    spacing?: 'compact' | 'balanced' | 'generous' | string
-    recto_start?: boolean
-    ornament?: 'none' | 'rule' | 'divider' | 'fleuron' | 'chapter-mark' | string
-    drop_cap?: boolean
-  }
-  ornaments?: {
-    kind?: 'none' | 'rule' | 'divider' | 'fleuron' | 'chapter-mark' | string
-    weight?: 'hairline' | 'light' | 'medium' | string
-    placement?: string
-  }
-  table?: {
-    rule_weight?: 'hairline' | 'light' | 'medium' | string
-    header_treatment?: string
-    density?: 'airy' | 'balanced' | 'dense' | string
-  }
-  caption?: {
-    position?: 'above' | 'below' | string
-    label_style?: 'bold' | 'small-caps' | 'plain' | string
-    alignment?: 'left' | 'center' | 'justified' | string
-  }
-}
-
-export interface PureRenderValidationError {
-  code: string
-  message: string
-}
-
-export interface PureRenderNormalizeResult {
-  html: string
-  title: string
-  errors: PureRenderValidationError[]
-}
-
-export interface PrintStyleProfile {
-  schema_version: '1.0' | string
-  sources?: readonly { id: string; note?: string }[]
-  exemplar_quality: {
-    usable: boolean
-    reason: string
-    confidence: number
-  }
-  observations: {
-    palette?: readonly PrintStylePaletteObservation[]
-    type?: readonly PrintStyleTypeObservation[]
-    type_pairing?: PrintStyleTypePairingObservation
-    type_scale?: PrintStyleTypeScaleObservation
-    text_setting?: PrintStyleTextSettingObservation
-    page_model?: PrintStylePageModelObservation
-    running_heads?: PrintStyleRunningHeadsObservation
-    folio?: PrintStyleFolioObservation
-    opener?: PrintStyleOpenerObservation
-    ornaments?: PrintStyleOrnamentObservation
-    table_treatment?: PrintStyleTableTreatmentObservation
-    caption_treatment?: PrintStyleCaptionTreatmentObservation
-    finish?: { register?: string; confidence?: number }
-  }
-  rules?: readonly PrintStyleRule[]
-  derived?: unknown
-}
-
-export interface PrintStylePaletteObservation {
-  role: 'surface' | 'ink' | 'accent' | 'secondary' | string
-  approx_hex?: string
-  coverage?: 'dominant' | 'frequent' | 'sparse' | string
-  where_seen?: string
-  confidence: number
-}
-
-export interface PrintStyleTypeObservation {
-  role: 'display' | 'body' | 'caption' | 'mono' | string
-  class: 'serif' | 'sans' | 'slab' | 'script' | string
-  mood?:
-    | 'old-style'
-    | 'transitional'
-    | 'slab'
-    | 'humanist-sans'
-    | 'grotesque-sans'
-    | 'geometric-sans'
-    | 'mono'
-    | string
-  serif_detail?: 'bracketed' | 'slab' | 'hairline' | 'wedge' | 'none' | string
-  confidence: number
-}
-
-export interface PrintStyleTypePairingObservation {
-  size_contrast?: 'dramatic' | 'moderate' | 'subtle' | string
-  confidence?: number
-}
-
-export interface PrintStyleTypeScaleObservation {
-  body_pt?: number
-  title_scale?: number
-  chapter_title_scale?: number
-  section_scale?: number
-  caption_scale?: number
-  footnote_scale?: number
-  confidence?: number
-}
-
-export interface PrintStyleTextSettingObservation {
-  alignment?: 'justified' | 'flush-left' | string
-  hyphenation?: 'present' | 'absent' | string
-  measure_cpl?: number
-  leading_feel?: 'tight' | 'normal' | 'airy' | string
-  confidence?: number
-}
-
-export interface PrintStylePageModelObservation {
-  columns?: number
-  margin_generosity?: 'tight' | 'moderate' | 'generous' | string
-  margin_asymmetry?: string
-  running_heads?: 'present' | 'absent' | string
-  folio_position?: string
-  caption_position?: 'above' | 'below' | string
-  confidence?: number
-}
-
-export interface PrintStyleRunningHeadsObservation {
-  presence?: 'present' | 'absent' | string
-  position?: string
-  transform?: 'uppercase' | 'small-caps' | 'title-case' | 'none' | string
-  rule?: 'none' | 'hairline' | 'solid' | string
-  font_role?: 'display' | 'body' | 'caption' | 'sans' | string
-  evidence?: string
-  confidence?: number
-}
-
-export interface PrintStyleFolioObservation {
-  position?: string
-  style?: 'plain' | 'small-caps' | 'bracketed' | string
-  suppress_on?: readonly string[]
-  evidence?: string
-  confidence?: number
-}
-
-export interface PrintStyleOpenerObservation {
-  spacing?: 'compact' | 'balanced' | 'generous' | string
-  recto_start?: boolean
-  ornament?: 'none' | 'rule' | 'divider' | 'fleuron' | 'chapter-mark' | string
-  drop_cap?: boolean
-  evidence?: string
-  confidence?: number
-}
-
-export interface PrintStyleOrnamentObservation {
-  kind?: 'none' | 'rule' | 'divider' | 'fleuron' | 'chapter-mark' | string
-  weight?: 'hairline' | 'light' | 'medium' | string
-  placement?: string
-  evidence?: string
-  confidence?: number
-}
-
-export interface PrintStyleTableTreatmentObservation {
-  rule_weight?: 'hairline' | 'light' | 'medium' | string
-  header_treatment?: string
-  row_rules?: 'none' | 'hairline' | 'light' | string
-  density?: 'airy' | 'balanced' | 'dense' | string
-  evidence?: string
-  confidence?: number
-}
-
-export interface PrintStyleCaptionTreatmentObservation {
-  position?: 'above' | 'below' | string
-  label_style?: 'bold' | 'small-caps' | 'plain' | string
-  alignment?: 'left' | 'center' | 'justified' | string
-  evidence?: string
-  confidence?: number
-}
-
-export interface PrintStyleRule {
-  rule: string
-  evidence?: string
-  confidence: number
-}
-
-export interface CompilePrintThemeResult {
-  theme: PureRenderTheme | null
-  decisions: readonly [type: string, message: string][]
-  rules: readonly string[]
-}
+export type PureRenderProfile = 'writer' | 'manuscript' | 'book'
+
+export interface PureRenderMetadata {
+  title?: string
+  authorsHtml?: string
+  authorsText?: string
+  affiliationsHtml?: string
+  affiliationsText?: string
+  abstractHtml?: string
+  abstractText?: string
+  keywords?: readonly string[]
+  profileLabel?: string
+}
+
+export interface PureRenderOptions {
+  variant?: 'two-column' | string
+  pageSize?: string
+  outline?: boolean
+}
+
+export interface PureRenderRequest {
+  html: string
+  profile: PureRenderProfile
+  theme?: PureRenderTheme
+  metadata?: PureRenderMetadata
+  options?: PureRenderOptions
+}
+
+export interface PureRenderTheme {
+  $schema?: string
+  name: string
+  version: string
+  color: {
+    ink: string
+    'ink-soft': string
+    muted: string
+    surface?: string
+    paper?: string
+    rule: string
+    'rule-soft': string
+    accent: string
+    'accent-ink'?: string
+  }
+  type: {
+    body: string
+    lead: number | string
+    measure: string
+    scaleRatio: number
+    fonts: {
+      display?: string
+      serif: string
+      sans: string
+      mono: string
+    }
+  }
+  rhythm: string
+  page?: {
+    trim?: string
+    margin?: string
+    columns?: number
+    recto_verso?: boolean
+  }
+  setting?: {
+    align?: 'justified' | 'flush-left' | string
+    hyphenate?: boolean
+  }
+  enforced_rules?: readonly string[]
+  profile_rules?: PureRenderProfileRules
+}
+
+export interface PureRenderProfileRules {
+  running_heads?: {
+    presence?: 'present' | 'absent' | string
+    position?: string
+    transform?: 'uppercase' | 'small-caps' | 'title-case' | 'none' | string
+    rule?: 'none' | 'hairline' | 'solid' | string
+    font_role?: 'display' | 'body' | 'caption' | 'sans' | string
+  }
+  folio?: {
+    position?: string
+    style?: 'plain' | 'small-caps' | 'bracketed' | string
+    suppress_on?: readonly string[]
+  }
+  opener?: {
+    spacing?: 'compact' | 'balanced' | 'generous' | string
+    recto_start?: boolean
+    ornament?: 'none' | 'rule' | 'divider' | 'fleuron' | 'chapter-mark' | string
+    drop_cap?: boolean
+  }
+  ornaments?: {
+    kind?: 'none' | 'rule' | 'divider' | 'fleuron' | 'chapter-mark' | string
+    weight?: 'hairline' | 'light' | 'medium' | string
+    placement?: string
+  }
+  table?: {
+    rule_weight?: 'hairline' | 'light' | 'medium' | string
+    header_treatment?: string
+    density?: 'airy' | 'balanced' | 'dense' | string
+  }
+  caption?: {
+    position?: 'above' | 'below' | string
+    label_style?: 'bold' | 'small-caps' | 'plain' | string
+    alignment?: 'left' | 'center' | 'justified' | string
+  }
+}
+
+export interface PureRenderValidationError {
+  code: string
+  message: string
+}
+
+export interface PureRenderNormalizeResult {
+  html: string
+  title: string
+  errors: PureRenderValidationError[]
+}
+
+export interface PrintStyleProfile {
+  schema_version: '1.0' | string
+  sources?: readonly { id: string; note?: string }[]
+  exemplar_quality: {
+    usable: boolean
+    reason: string
+    confidence: number
+  }
+  observations: {
+    palette?: readonly PrintStylePaletteObservation[]
+    type?: readonly PrintStyleTypeObservation[]
+    type_pairing?: PrintStyleTypePairingObservation
+    type_scale?: PrintStyleTypeScaleObservation
+    text_setting?: PrintStyleTextSettingObservation
+    page_model?: PrintStylePageModelObservation
+    running_heads?: PrintStyleRunningHeadsObservation
+    folio?: PrintStyleFolioObservation
+    opener?: PrintStyleOpenerObservation
+    ornaments?: PrintStyleOrnamentObservation
+    table_treatment?: PrintStyleTableTreatmentObservation
+    caption_treatment?: PrintStyleCaptionTreatmentObservation
+    finish?: { register?: string; confidence?: number }
+  }
+  rules?: readonly PrintStyleRule[]
+  derived?: unknown
+}
+
+export interface PrintStylePaletteObservation {
+  role: 'surface' | 'ink' | 'accent' | 'secondary' | string
+  approx_hex?: string
+  coverage?: 'dominant' | 'frequent' | 'sparse' | string
+  where_seen?: string
+  confidence: number
+}
+
+export interface PrintStyleTypeObservation {
+  role: 'display' | 'body' | 'caption' | 'mono' | string
+  class: 'serif' | 'sans' | 'slab' | 'script' | string
+  mood?:
+    | 'old-style'
+    | 'transitional'
+    | 'slab'
+    | 'humanist-sans'
+    | 'grotesque-sans'
+    | 'geometric-sans'
+    | 'mono'
+    | string
+  serif_detail?: 'bracketed' | 'slab' | 'hairline' | 'wedge' | 'none' | string
+  confidence: number
+}
+
+export interface PrintStyleTypePairingObservation {
+  size_contrast?: 'dramatic' | 'moderate' | 'subtle' | string
+  confidence?: number
+}
+
+export interface PrintStyleTypeScaleObservation {
+  body_pt?: number
+  title_scale?: number
+  chapter_title_scale?: number
+  section_scale?: number
+  caption_scale?: number
+  footnote_scale?: number
+  confidence?: number
+}
+
+export interface PrintStyleTextSettingObservation {
+  alignment?: 'justified' | 'flush-left' | string
+  hyphenation?: 'present' | 'absent' | string
+  measure_cpl?: number
+  leading_feel?: 'tight' | 'normal' | 'airy' | string
+  confidence?: number
+}
+
+export interface PrintStylePageModelObservation {
+  columns?: number
+  margin_generosity?: 'tight' | 'moderate' | 'generous' | string
+  margin_asymmetry?: string
+  running_heads?: 'present' | 'absent' | string
+  folio_position?: string
+  caption_position?: 'above' | 'below' | string
+  confidence?: number
+}
+
+export interface PrintStyleRunningHeadsObservation {
+  presence?: 'present' | 'absent' | string
+  position?: string
+  transform?: 'uppercase' | 'small-caps' | 'title-case' | 'none' | string
+  rule?: 'none' | 'hairline' | 'solid' | string
+  font_role?: 'display' | 'body' | 'caption' | 'sans' | string
+  evidence?: string
+  confidence?: number
+}
+
+export interface PrintStyleFolioObservation {
+  position?: string
+  style?: 'plain' | 'small-caps' | 'bracketed' | string
+  suppress_on?: readonly string[]
+  evidence?: string
+  confidence?: number
+}
+
+export interface PrintStyleOpenerObservation {
+  spacing?: 'compact' | 'balanced' | 'generous' | string
+  recto_start?: boolean
+  ornament?: 'none' | 'rule' | 'divider' | 'fleuron' | 'chapter-mark' | string
+  drop_cap?: boolean
+  evidence?: string
+  confidence?: number
+}
+
+export interface PrintStyleOrnamentObservation {
+  kind?: 'none' | 'rule' | 'divider' | 'fleuron' | 'chapter-mark' | string
+  weight?: 'hairline' | 'light' | 'medium' | string
+  placement?: string
+  evidence?: string
+  confidence?: number
+}
+
+export interface PrintStyleTableTreatmentObservation {
+  rule_weight?: 'hairline' | 'light' | 'medium' | string
+  header_treatment?: string
+  row_rules?: 'none' | 'hairline' | 'light' | string
+  density?: 'airy' | 'balanced' | 'dense' | string
+  evidence?: string
+  confidence?: number
+}
+
+export interface PrintStyleCaptionTreatmentObservation {
+  position?: 'above' | 'below' | string
+  label_style?: 'bold' | 'small-caps' | 'plain' | string
+  alignment?: 'left' | 'center' | 'justified' | string
+  evidence?: string
+  confidence?: number
+}
+
+export interface PrintStyleRule {
+  rule: string
+  evidence?: string
+  confidence: number
+}
+
+export interface CompilePrintThemeResult {
+  theme: PureRenderTheme | null
+  decisions: readonly [type: string, message: string][]
+  rules: readonly string[]
+}

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

@@ -1,57 +1,57 @@
-import { describe, expect, it } from 'vitest'
-import { inspectPureRenderVisualLayout } from './visualLayoutInspection.js'
-
-describe('inspectPureRenderVisualLayout', () => {
-  it('observes clean pages without requesting vision review', () => {
-    const result = inspectPureRenderVisualLayout({
-      pageCount: 3,
-      topGapRatio: 0.08,
-      bottomGapRatio: 0.12,
-      usedHeightRatio: 0.8,
-      blankBeforeFigureRatio: 0.1,
-      imageVisible: true,
-      captionOrphaned: false,
-      strandedHeading: false,
-    })
-
-    expect(result.decision).toBe('observe')
-    expect(result.requiresVisionReview).toBe(false)
-    expect(result.issues).toEqual([])
-  })
-
-  it('reuses image break candidate logic for stranded figure pages', () => {
-    const result = inspectPureRenderVisualLayout({
-      pageCount: 5,
-      problemPage: 2,
-      figurePage: 3,
-      imagePage: 3,
-      captionPage: 3,
-      headingPage: 2,
-      blankBeforeFigureRatio: 0.62,
-      imageVisible: true,
-      captionOrphaned: false,
-      strandedHeading: true,
-    })
-
-    expect(result.decision).toBe('rerender-compact-figure-candidate')
-    expect(result.requiresVisionReview).toBe(false)
-    expect(result.issues).toEqual([
-      'large-pre-figure-blank',
-      'stranded-heading',
-    ])
-    expect(result.candidate?.id).toBe('compact-figure')
-  })
-
-  it('rejects caption orphan candidates deterministically', () => {
-    const result = inspectPureRenderVisualLayout({
-      imagePage: 2,
-      captionPage: 3,
-      imageVisible: true,
-      captionOrphaned: true,
-    })
-
-    expect(result.decision).toBe('reject-candidate')
-    expect(result.requiresVisionReview).toBe(false)
-    expect(result.issues).toContain('caption-orphan')
-  })
-})
+import { describe, expect, it } from 'vitest'
+import { inspectPureRenderVisualLayout } from './visualLayoutInspection.js'
+
+describe('inspectPureRenderVisualLayout', () => {
+  it('observes clean pages without requesting vision review', () => {
+    const result = inspectPureRenderVisualLayout({
+      pageCount: 3,
+      topGapRatio: 0.08,
+      bottomGapRatio: 0.12,
+      usedHeightRatio: 0.8,
+      blankBeforeFigureRatio: 0.1,
+      imageVisible: true,
+      captionOrphaned: false,
+      strandedHeading: false,
+    })
+
+    expect(result.decision).toBe('observe')
+    expect(result.requiresVisionReview).toBe(false)
+    expect(result.issues).toEqual([])
+  })
+
+  it('reuses image break candidate logic for stranded figure pages', () => {
+    const result = inspectPureRenderVisualLayout({
+      pageCount: 5,
+      problemPage: 2,
+      figurePage: 3,
+      imagePage: 3,
+      captionPage: 3,
+      headingPage: 2,
+      blankBeforeFigureRatio: 0.62,
+      imageVisible: true,
+      captionOrphaned: false,
+      strandedHeading: true,
+    })
+
+    expect(result.decision).toBe('rerender-compact-figure-candidate')
+    expect(result.requiresVisionReview).toBe(false)
+    expect(result.issues).toEqual([
+      'large-pre-figure-blank',
+      'stranded-heading',
+    ])
+    expect(result.candidate?.id).toBe('compact-figure')
+  })
+
+  it('rejects caption orphan candidates deterministically', () => {
+    const result = inspectPureRenderVisualLayout({
+      imagePage: 2,
+      captionPage: 3,
+      imageVisible: true,
+      captionOrphaned: true,
+    })
+
+    expect(result.decision).toBe('reject-candidate')
+    expect(result.requiresVisionReview).toBe(false)
+    expect(result.issues).toContain('caption-orphan')
+  })
+})