@vyaz/core 0.0.5 → 0.0.6

package/src/types/FontTypes.ts

@@ -1,74 +0,0 @@
-/**
- * FontTypes.ts — font metric type definitions.
- *
- * Isomorphic layer: works both in browser (Canvas TextMetrics) and Node.js (fontkit).
- *
- * Two modes:
- *   'browser' — uses hhea.ascender/descender (canvas fallback)
- *   'office'  — uses OS/2.usWinAscent/usWinDescent (MS Office compatible)
- */
-
-/** Physical font metrics (in pixels for a given fontSize) */
-export interface FontMetrics {
-  /** Rise above baseline */
-  ascent: number;
-  /** Descent below baseline (positive number!) */
-  descent: number;
-  /** Cap height */
-  capHeight: number;
-  /** Original font UPM (for reference) */
-  unitsPerEm: number;
-  /**
-   * Which font table was used for ascent/descent:
-   *   'hhea'  — hhea.ascender/descender (browser mode)
-   *   'OS/2'  — OS/2.usWinAscent/usWinDescent (Office mode)
-   *   'canvas' — canvas.measureText (browser fallback)
-   *   'fallback' — empirical formula
-   */
-  sourceTable?: 'hhea' | 'OS/2' | 'canvas' | 'fallback';
-}
-
-/** Metrics provider — isomorphic interface */
-export interface IFontMetricsProvider {
-  /**
-   * Set measurement mode.
-   *   'browser' — hhea.ascender/descender (default)
-   *   'office'  — OS/2.usWinAscent/usWinDescent
-   */
-  setMode(mode: 'browser' | 'office'): void;
-
-  /**
-   * Get current mode.
-   */
-  getMode(): 'browser' | 'office';
-
-  /**
-   * Register a binary font for use with fontkit.
-   * In browser — no-op (fonts are registered via CSS @font-face).
-   *
-   * @param sourcePath — path to .ttf/.otf file for optional @napi-rs/canvas.registerFont()
-   */
-  registerFont(
-    family: string,
-    options: { weight?: string; style?: string },
-    source: string | Buffer,
-    sourcePath?: string,
-  ): void;
-
-  /**
-   * Get metrics for a given family and size.
-   */
-  getMetrics(
-    fontFamily: string,
-    fontSize: number,
-    weight?: string,
-    style?: string,
-  ): FontMetrics;
-}
-
-/** Glyph-level data for a single glyph (per-character tracking/highlighting) */
-export interface GlyphData {
-  char: string;            // character
-  advance: number;         // advance width in px
-  x: number;              // position relative to line start
-}

package/src/types/LayoutTypes.ts

@@ -1,158 +0,0 @@
-/**
- * LayoutTypes.ts — output types (Physical Box Model).
- *
- * ParagraphLayoutResult → Line[] → Span[]
- * This is the contract between layout engine and renderers.
- *
- * Based on plan.md §2.5 (Output — Physical Box Model / Layout Tree)
- */
-
-import type { TextRun, InlineWidget, TextAlignment } from './Document.js';
-
-// ── Span (render atom, formerly FragmentBox) ─────────────────────────────
-
-export interface Span {
-  /** Offset from Line.x */
-  x: number;
-  /** Physical span width */
-  width: number;
-  /** Span text (or " " for justify spaces) */
-  text: string;
-  /** Index of the source run in the paragraph's `children` array. */
-  itemIndex: number;
-  /** Paragraph index in TextFrame.paragraphs[]. Stable key for grouping & diff. */
-  pIdx: number;
-  /** Optional paragraph tag (set by user via Paragraph.id). */
-  tag?: string;
-
-  /** Physical font metrics for this span */
-  fontMetrics: SpanFontMetrics;
-
-  /**
-   * A snapshot of the source run's style at layout time.
-   * Copied from the corresponding `TextRun` in the paragraph's `children` array.
-   */
-  style: TextRun;
-
-  /** InlineWidget data (if span is an inline-box) */
-  inlineWidget?: InlineWidget;
-
-  /** Per-character advance widths (for selection/tracking) */
-  glyphAdvances?: number[] | Float32Array;
-
-  /**
-   * Span type:
-   * - `'text'` — regular text
-   * - `'space'` — whitespace span
-   * - `'marker'` — list marker (bullet / number), rendered like text
-   */
-  type: 'text' | 'space' | 'marker';
-
-  /**
-   * Trailing whitespace flag.
-   * - true: span is at end of line, does not participate in line advance
-   *         and is not stretched during justify (zero width for calculations).
-   * - undefined/false: regular span.
-   *
-   * See CSS Text Module Level 3 §4.1.3 (Tracking and Dropping Spaces)
-   * and Parley LineItemData::has_trailing_whitespace.
-   */
-  trailing?: boolean;
-
-  /**
-   * Line break mode after this span.
-   * 'soft' — soft line break (insufficient space)
-   * 'hard' — forced break (\n, explicit separator)
-   * undefined — not end of line
-   */
-  breakType?: 'soft' | 'hard';
-}
-
-export interface SpanFontMetrics {
-  ascent: number;
-  descent: number;
-  fontSize: number;
-  /** Vertical offset from baseline (px). Used for sub/superscript positioning.
-   *  Negative = above baseline (superscript). Positive = below baseline (subscript).
-   *  Undefined or 0 = normal baseline position. */
-  baselineOffset?: number;
-}
-
-// ── Line (single line, formerly LineBox) ─────────────────────────────────
-
-export interface Line {
-  /**
-   * Absolute X of the line box left edge within the container.
-   * Includes outside list markers when present (marker may sit left of text).
-   */
-  x: number;
-  /** Absolute Y of line top edge */
-  y: number;
-  /**
-   * Line box width covering all spans (text + outside markers).
-   * Equals max(span.x + span.width) − min(span.x).
-   */
-  width: number;
-
-  /** Full line height (max spans × lineHeight) */
-  height: number;
-
-  /** Baseline offset from y */
-  baseline: number;
-  /** Maximum ascent in line */
-  ascent: number;
-  /** Maximum descent in line */
-  descent: number;
-
-  /** Index of first character in the original paragraph text */
-  startIndex: number;
-  /** Index of last character + 1 (for convenient length calculation) */
-  endIndex: number;
-
-  /** Paragraph alignment (optional, for PowerPoint render) */
-  alignment?: TextAlignment;
-
-  /** Column index (0-based) when frame has multi-column layout. */
-  columnIndex?: number;
-
-  spans: Span[];
-}
-
-// ── ParagraphLayoutResult (single paragraph) ─────────────────────────────
-
-export interface ParagraphLayoutResult {
-  width: number;             // paragraph width (maxWidth)
-  height: number;            // full paragraph height including spacing
-  lines: Line[];
-  /** Actual content width (text bbox, without voids) */
-  contentWidth: number;
-  /** Actual content height (text bbox) */
-  contentHeight: number;
-}
-
-// ── Text region for YAML snapshots ───────────────────────────────────────
-
-/** Semantic span for snapshots (without physical metrics) */
-export interface SemanticFragment {
-  text: string;
-  x: number;
-  width: number;
-  style?: 'bold' | 'italic' | 'normal';
-}
-
-/** Semantic line for snapshots */
-export interface SemanticLine {
-  y: number;
-  width: number;
-  height: number;
-  baseline: number;
-  fragments: SemanticFragment[];
-}
-
-/** Semantic paragraph for YAML snapshots */
-export interface SemanticParagraph {
-  width: number;
-  height: number;
-  lines: SemanticLine[];
-}
-

package/src/utils/list.ts

@@ -1,107 +0,0 @@
-/**
- * list.ts — helper utilities for list marker generation.
- *
- * Provides:
- * - `formatListNumber()` — format a number according to `NumberFormat`
- * - `defaultBulletChar()` — pick a bullet character based on nesting level
- * - `BULLET_CHARACTERS` — the Unicode characters for disc/circle/square
- */
-
-import type { NumberFormat } from '../types/Document.js';
-
-/**
- * Unicode characters used for CSS `disc`, `circle`, `square` list-style-type
- * values at different nesting levels.
- *
- * @see {@link https://www.w3.org/TR/css-lists-3/#ua-stylesheet | CSS Lists UA defaults}
- */
-export const BULLET_CHARACTERS: Record<number, string> = {
-  0: '\u2022', // • BULLET  (disc)
-  1: '\u25CB', // ○ WHITE CIRCLE (circle)
-  2: '\u25AA', // ▪ BLACK SMALL SQUARE (square)
-};
-
-/** Fallback for deeper levels — same as level 2 */
-const FALLBACK_BULLET = '\u25AA';
-
-/**
- * Get the default bullet character for a given nesting level.
- *
- * CSS UA stylesheet uses:
- * - Level 0 (ul): disc (•)
- * - Level 1 (ul ul): circle (○)
- * - Level 2+ (ul ul ul): square (▪)
- */
-export function defaultBulletChar(level: number): string {
-  return BULLET_CHARACTERS[level] ?? FALLBACK_BULLET;
-}
-
-/**
- * Format a number according to the given numbering format.
- *
- * Supports the same formats as CSS `list-style-type`:
- * - `decimal`: 1, 2, 3, …
- * - `upper-roman`: I, II, III, …
- * - `lower-roman`: i, ii, iii, …
- * - `upper-alpha`: A, B, C, …
- * - `lower-alpha`: a, b, c, …
- *
- * Follows CSS Counter Styles Level 3 algorithms.
- * Roman numerals support the range 1–3999.
- *
- * @see {@link https://www.w3.org/TR/css-counter-styles-3/ | CSS Counter Styles Level 3}
- */
-export function formatListNumber(n: number, format: NumberFormat): string {
-  switch (format) {
-    case 'decimal':
-      return String(n);
-    case 'upper-roman':
-      return toRoman(n).toUpperCase();
-    case 'lower-roman':
-      return toRoman(n).toLowerCase();
-    case 'upper-alpha':
-      return toAlpha(n).toUpperCase();
-    case 'lower-alpha':
-      return toAlpha(n).toLowerCase();
-    default:
-      return String(n);
-  }
-}
-
-/**
- * Convert 1-based integer to lowercase roman numeral.
- * Supports 1–3999.
- */
-function toRoman(n: number): string {
-  if (n < 1 || n > 3999) return String(n);
-  const romanMap: [number, string][] = [
-    [1000, 'm'], [900, 'cm'], [500, 'd'], [400, 'cd'],
-    [100, 'c'], [90, 'xc'], [50, 'l'], [40, 'xl'],
-    [10, 'x'], [9, 'ix'], [5, 'v'], [4, 'iv'], [1, 'i'],
-  ];
-  let result = '';
-  for (const [value, symbol] of romanMap) {
-    while (n >= value) {
-      result += symbol;
-      n -= value;
-    }
-  }
-  return result;
-}
-
-/**
- * Convert 1-based integer to alpha format (a, b, c, …, z, aa, ab, …).
- * Uses the same algorithm as CSS `lower-alpha` (CSS Counter Styles §3.1.2).
- */
-function toAlpha(n: number): string {
-  if (n < 1) return String(n);
-  const base = 26;
-  const offset = 'a'.charCodeAt(0);
-  let result = '';
-  while (n > 0) {
-    n--;
-    result = String.fromCharCode(offset + (n % base)) + result;
-    n = Math.floor(n / base);
-  }
-  return result;
-}

package/src/utils/textTransform.ts

@@ -1,96 +0,0 @@
-/**
- * textTransform.ts — pure text transformation functions.
- *
- * Implements CSS `text-transform` for: none, uppercase, lowercase, capitalize.
- *
- * Explicit capitalization contract (edge cases):
- * - Apostrophe (') is NOT a word boundary: "don't stop" → "Don't Stop"
- * - Hyphen (-) IS a word boundary: "hello-world" → "Hello-World"
- * - Leading whitespace is preserved: "  hello" → "  Hello"
- * - Numbers are not capitalized: "3d model" → "3d Model"
- * - Unicode full-range: first `\p{L}` in each word segment gets .toUpperCase()
- * - Empty string → ""
- * - No letters → unchanged: "123" → "123"
- *
- * @see {@link https://www.w3.org/TR/css-text-3/#text-transform-property | CSS Text: text-transform}
- */
-
-import type { TextTransform } from '../types/Document.js';
-
-/**
- * Apply text-transform to a string.
- *
- * @param text — input text
- * @param transform — transform type ('none' | 'uppercase' | 'lowercase' | 'capitalize')
- * @returns transformed text
- *
- * @example
- * ```ts
- * transformText("hello world", 'uppercase')  // → "HELLO WORLD"
- * transformText("HELLO", 'lowercase')         // → "hello"
- * transformText("don't stop", 'capitalize')   // → "Don't Stop"
- * ```
- */
-export function transformText(text: string, transform?: TextTransform): string {
-  if (!transform || transform === 'none' || !text) {
-    return text;
-  }
-
-  switch (transform) {
-    case 'uppercase':
-      return text.toUpperCase();
-
-    case 'lowercase':
-      return text.toLowerCase();
-
-    case 'capitalize': {
-      // Capitalize first letter of each word.
-      // Word = sequence of Unicode letters (\p{L}).
-      // Non-letter characters (including hyphen, but NOT apostrophe) are delimiters.
-      //
-      // Strategy: split on non-letter sequences (\P{L}+), but preserve delimiters
-      // by using a capturing group. Then for each letter-segment, capitalize its first \p{L}.
-      // Non-letter segments pass through unchanged.
-      //
-      // The regex splits on non-letters (excluding apostrophe) but keeps delimiters.
-      // Apostrophe (') is NOT a word boundary: "don't stop" → ["don't", " ", "stop", ""]
-      // Hyphen IS: "hello-world" → ["hello", "-", "world", ""]
-      const segments = text.split(/([^\p{L}']+)/u);
-
-      // Pre-allocate with same length
-      const result: string[] = new Array(segments.length);
-
-      for (let i = 0; i < segments.length; i++) {
-        const seg = segments[i];
-        if (!seg) {
-          result[i] = seg;
-          continue;
-        }
-
-        // If this segment is a non-letter (excluding apostrophe) delimiter — pass through unchanged
-        if (/^[^\p{L}']+$/u.test(seg)) {
-          result[i] = seg;
-          continue;
-        }
-
-        // This is a letter-segment. Capitalize its first letter.
-        const firstLetter = seg.match(/\p{L}/u);
-        if (!firstLetter) {
-          result[i] = seg;
-          continue;
-        }
-
-        const idx = firstLetter.index!;
-        const before = seg.slice(0, idx);
-        const letter = seg[idx].toUpperCase();
-        const after = seg.slice(idx + 1);
-        result[i] = `${before}${letter}${after}`;
-      }
-
-      return result.join('');
-    }
-
-    default:
-      return text;
-  }
-}