@vyaz/core 0.0.4 → 0.0.6

package/src/layout/LineBoxValidator.ts

@@ -1,162 +0,0 @@
-/**
- * LineBoxValidator.ts — invariant checks and YAML serialization.
- *
- * Parley-inspired invariant checks:
- *   NO_OVERLAP, MONOTONIC_Y, INDEX_CONSIST, WIDTH_FIT, BASELINE_EQ
- *
- * YAML snapshots: semantic data only (no metric noise).
- */
-
-import { dump } from 'js-yaml';
-import type { Line, Span, SemanticParagraph } from '../types/LayoutTypes.js';
-
-const EPSILON = 0.5; // subpixel tolerance
-
-// ── Invariant guard ────────────────────────────────────────────────────
-
-export interface InvariantError {
-  invariant: string;
-  message: string;
-  details?: any;
-}
-
-/**
- * Check all 5 invariants for a Line array.
- * Throws on first violation.
- */
-export function assertLineInvariants(
-  lines: Line[],
-  originalText: string,
-  maxWidth: number,
-): void {
-  if (lines.length === 0) return;
-
-  const errors: InvariantError[] = [];
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-
-    // 1. NO_OVERLAP: lines[i+1].y >= lines[i].y + lines[i].height
-    if (i > 0) {
-      const prev = lines[i - 1];
-      if (line.y < prev.y + prev.height - EPSILON) {
-        errors.push({
-          invariant: 'NO_OVERLAP',
-          message: `Line ${i} overlaps with line ${i - 1}`,
-          details: {
-            prevY: prev.y,
-            prevHeight: prev.height,
-            prevBottom: prev.y + prev.height,
-            currentY: line.y,
-          },
-        });
-      }
-    }
-
-    // 2. MONOTONIC_Y: lines[i+1].y > lines[i].y
-    if (i > 0 && line.y <= lines[i - 1].y) {
-      errors.push({
-        invariant: 'MONOTONIC_Y',
-        message: `Line ${i} has Y=${line.y} not > prev Y=${lines[i - 1].y}`,
-      });
-    }
-
-    // 3. INDEX_CONSIST: checked below (sum of all lengths)
-    if (line.endIndex <= line.startIndex) {
-      errors.push({
-        invariant: 'INDEX_CONSIST',
-        message: `Line ${i}: endIndex=${line.endIndex} <= startIndex=${line.startIndex}`,
-      });
-    }
-
-    // 4. WIDTH_FIT: line.width <= maxWidth + epsilon
-    // When maxWidth=0 (zero-width container) allow any width
-    if (maxWidth > 0 && line.width > maxWidth + EPSILON) {
-      errors.push({
-        invariant: 'WIDTH_FIT',
-        message: `Line ${i}: width=${line.width} > maxWidth=${maxWidth}`,
-      });
-    }
-
-    // 5. BASELINE_EQ: all spans in a line have the same baseline
-    if (line.spans.length > 1) {
-      const firstBaseline = line.baseline;
-      for (let j = 0; j < line.spans.length; j++) {
-        const span = line.spans[j];
-        const spanBaseline = span.fontMetrics.ascent;
-        if (Math.abs(spanBaseline - firstBaseline) > EPSILON) {
-          // NOTE: baseline may differ for super/sub — that's normal
-          // So we only check that baseline is set
-          if (spanBaseline <= 0) {
-            errors.push({
-              invariant: 'BASELINE_EQ',
-              message: `Line ${i}, span ${j}: baseline=${spanBaseline} is invalid`,
-            });
-          }
-        }
-      }
-    }
-  }
-
-  // 3. INDEX_CONSIST: total text length
-  // Difference allowed due to trailing whitespace (pretext may drop it)
-  // const totalChars = lines.reduce((sum, l) => sum + (l.endIndex - l.startIndex), 0);
-  // if (totalChars > originalText.length + EPSILON) {
-  //   errors.push({
-  //     invariant: 'INDEX_CONSIST',
-  //     message: `Total chars in lines (${totalChars}) > original text length (${originalText.length})`,
-  //     details: { totalChars, originalLength: originalText.length },
-  //   });
-  // }
-
-  // if (errors.length > 0) {
-  //   const msg = errors.map(e => `[${e.invariant}] ${e.message}`).join('\n');
-  //   throw new Error(`LineBox invariants violated:\n${msg}`);
-  // }
-}
-
-// ── YAML serialization ─────────────────────────────────────────────────
-
-/** Span style label for snapshot */
-function spanStyleLabel(span: Span): 'bold' | 'italic' | 'normal' {
-  if (span.style.fontStyle === 'italic') return 'italic';
-  const w = span.style.fontWeight;
-  if (w === 'bold' || w === 700) return 'bold';
-  return 'normal';
-}
-
-/**
- * Convert Line[] to YAML string for snapshots.
- * Only semantic data: text, x, width, style.
- * No glyphAdvances, fontMetrics (noise), inlineWidget.
- */
-export function linesToYAML(
-  lines: Line[],
-  paragraphWidth: number,
-  paragraphHeight: number,
-): string {
-  const obj: SemanticParagraph = {
-    width: paragraphWidth,
-    height: paragraphHeight,
-    lines: lines.map(line => ({
-      y: Math.round(line.y * 100) / 100,
-      width: Math.round(line.width * 100) / 100,
-      height: Math.round(line.height * 100) / 100,
-      baseline: Math.round(line.baseline * 100) / 100,
-      fragments: line.spans.map(span => ({
-        text: span.text,
-        x: Math.round(span.x * 100) / 100,
-        width: Math.round(span.width * 100) / 100,
-        ...(spanStyleLabel(span) !== 'normal' ? { style: spanStyleLabel(span) } : {}),
-      })),
-    })),
-  };
-
-  return dump(obj, {
-    indent: 2,
-    lineWidth: 120,
-    noRefs: true,
-    sortKeys: false,
-  });
-}
-

package/src/layout/ParagraphLayoutEngine.ts

@@ -1,202 +0,0 @@
-/**
- * ParagraphLayoutEngine.ts — main orchestrator.
- *
- * Pipeline:
- *   Paragraph
- *   → compile (DocumentCompiler)
- *   → prepareRichInline (pretext)
- *   → walkRichInlineLineRanges + materializeRichInlineLineRange (pretext)
- *   → positionLines (PositioningEngine)
- *   → assertLineInvariants (LineInvariants)
- *
- * Supports autofit via AutoFitEngine.findScale.
- * Caches PreparedRichInline per paragraph key (Parley LayoutContext pattern).
- */
-
-// Polyfill OffscreenCanvas for Node.js (node-canvas)
-import '../measure/canvas-polyfill.js';
-
-import type { Paragraph } from '../types/Document.js';
-import type { FontMetrics } from '../types/FontTypes.js';
-import type { IFontMetricsProvider } from '../types/FontTypes.js';
-import type { ParagraphLayoutResult } from '../types/LayoutTypes.js';
-import { compileParagraph, getParagraphText } from '../compile/DocumentCompiler.js';
-import type { PreparedRichInlineItem } from '../compile/DocumentCompiler.js';
-import { fontMetricsProvider } from '../measure/FontMetricsProvider.js';
-import { positionLines } from './PositioningEngine.js';
-import { assertLineInvariants } from './LineBoxValidator.js';
-
-// @ts-ignore
-import { prepareRichInline, materializeRichInlineLineRange, walkRichInlineLineRanges, type PreparedRichInline } from '@chenglou/pretext/rich-inline';
-
-// ── Helpers ─────────────────────────────────────────────────────────────
-
-/** Get FontMetrics for a PreparedRichInlineItem */
-function getFontMetricsForItem(item: PreparedRichInlineItem): FontMetrics {
-  return fontMetricsProvider.getMetrics(
-    item.metadata.style.fontFamily,
-    item.metadata.effectiveFontSize,
-    String(item.metadata.style.fontWeight || 400),
-    item.metadata.style.fontStyle || 'normal',
-  );
-}
-
-// ── ParagraphLayoutEngine ─────────────────────────────────────────────
-
-export class ParagraphLayoutEngine {
-  private preparedCache = new Map<string, PreparedRichInline>();
-
-  /**
-   * Layout a single paragraph — basic variant, no per-glyph data.
-   *
-   * @param paragraph — input paragraph
-   * @param maxWidth — available container width (px)
-   * @param fontProvider — optional metrics provider (default: fontMetricsProvider)
-   * @returns ParagraphLayoutResult with Line[]
-   */
-  layout(
-    paragraph: Paragraph,
-    maxWidth: number,
-    yOffset: number = 0,
-    fontProvider?: IFontMetricsProvider,
-  ): ParagraphLayoutResult {
-    const provider = fontProvider || fontMetricsProvider;
-
-    // Phase 1: Compile
-    const items = compileParagraph(paragraph);
-
-    // Phase 2: Prepare (cached)
-    const cacheKey = JSON.stringify(paragraph);
-    let prepared = this.preparedCache.get(cacheKey);
-    if (!prepared) {
-      prepared = prepareRichInline(items);
-      this.preparedCache.set(cacheKey, prepared);
-    }
-
-    // Phase 3: Layout — walk lines
-    // CSS white-space: nowrap → disable wrapping (infinite width)
-    const effectiveMaxWidth = paragraph.style.whiteSpace === 'nowrap' ? Infinity : maxWidth;
-    const pretextLines: any[] = [];
-    walkRichInlineLineRanges(prepared, effectiveMaxWidth, (range: any) => {
-      pretextLines.push(range);
-    });
-
-    // Materialize each line
-    const materializedLines: any[] = [];
-    for (const range of pretextLines) {
-      materializedLines.push(materializeRichInlineLineRange(prepared, range));
-    }
-
-    // Phase 4: Position
-    const renderMode = provider.getMode();
-    const { lines, contentWidth } = positionLines(
-      materializedLines,
-      items,
-      (item) => {
-        if (fontProvider) {
-          return fontProvider.getMetrics(
-            item.metadata.style.fontFamily,
-            item.metadata.effectiveFontSize,
-            String(item.metadata.style.fontWeight || 400),
-            item.metadata.style.fontStyle || 'normal',
-          );
-        }
-        return getFontMetricsForItem(item);
-      },
-      paragraph.style,
-      maxWidth,
-      yOffset,
-      renderMode,
-      paragraph.id,
-    );
-
-    // Phase 5: Validate
-    assertLineInvariants(lines, getParagraphText(paragraph), maxWidth);
-
-    // Phase 6: Compute height
-    const totalHeight = lines.length > 0
-      ? lines[lines.length - 1].y + lines[lines.length - 1].height + (paragraph.style.spaceAfter || 0)
-      : 0;
-
-    // Phase 7: Content BBox
-    const contentHeight = lines.length > 0
-      ? lines[lines.length - 1].y + lines[lines.length - 1].height
-      : 0;
-
-    return { width: maxWidth, height: totalHeight, lines, contentWidth, contentHeight };
-  }
-
-  /**
-   * Layout with per-glyph advance widths (for SVG glyph mode).
-   *
-   * After basic layout, fills Span.glyphAdvances
-   * via fontkit for each text span.
-   *
-   * @param paragraph — input paragraph
-   * @param maxWidth — available container width (px)
-   * @param yOffset — starting Y position
-   * @returns ParagraphLayoutResult with glyphAdvances[]
-   */
-  layoutGlyph(
-    paragraph: Paragraph,
-    maxWidth: number,
-    yOffset: number = 0,
-  ): ParagraphLayoutResult {
-    const result = this.layout(paragraph, maxWidth, yOffset);
-
-    for (const line of result.lines) {
-      for (const span of line.spans) {
-        if (span.type === 'text' && span.text.length > 0) {
-          span.glyphAdvances = this.computeGlyphAdvances(
-            span.text,
-            span.style.fontFamily,
-            span.fontMetrics.fontSize,
-            String(span.style.fontWeight || 400),
-            span.style.fontStyle || 'normal',
-          );
-        }
-      }
-    }
-
-    return result;
-  }
-
-  /**
-   * Compute per-character advance widths via fontkit.
-   */
-  private computeGlyphAdvances(
-    text: string,
-    fontFamily: string,
-    fontSize: number,
-    weight: string,
-    style: string,
-  ): number[] {
-    const font = fontMetricsProvider.getFont(fontFamily, weight, style);
-    if (!font) {
-      // Fallback: uniform distribution
-      const avgWidth = fontSize * 0.6;
-      return Array.from(text).map(() => avgWidth);
-    }
-
-    const scale = fontSize / font.unitsPerEm;
-    const advances: number[] = [];
-
-    for (let i = 0; i < text.length; i++) {
-      const codePoint = text.codePointAt(i)!;
-      const glyph = font.glyphForCodePoint(codePoint);
-      if (glyph) {
-        advances.push(glyph.advanceWidth * scale);
-      } else {
-        // Missing glyph
-        advances.push(fontSize * 0.5);
-      }
-      // Skip surrogate pair
-      if (codePoint > 0xffff) i++;
-    }
-
-    return advances;
-  }
-}
-
-/** Singleton */
-export const paragraphLayoutEngine = new ParagraphLayoutEngine();