@vyaz/core 0.0.5 → 0.0.7

package/dist/compile/DocumentCompiler.d.ts

@@ -0,0 +1,83 @@
+/**
+ * DocumentCompiler.ts — compile Paragraph → PreparedRichInlineItem[].
+ *
+ * Each TextRun becomes a RichInlineItem for pretext.
+ * inline-box: text → \uFFFC, dimensions in metadata.inlineWidget.
+ * super/sub: fontSize *= 0.65, baselineOffset in metadata.
+ *
+ * splitParagraphByHardBreaks() — zero phase: splits a Paragraph into
+ * virtual Paragraph[] on \n boundaries (for pre, pre-line, pre-wrap).
+ *
+ * Simple JSON-serialisable format — does not depend on pretext directly.
+ */
+import type { Paragraph, TextRun } from '../types/Document.js';
+export declare const FONT_WEIGHTS: Record<string, number>;
+/** Normalize fontWeight to a numeric value (400 by default). */
+export declare function normalizeFontWeight(weight: number | string | undefined): number;
+/** Font token for pretext: "${style}_${weight}_${fontSize}_${family}" */
+export declare function makeFontToken(run: TextRun, effectiveFontSize: number): string;
+/** Compilation context (passed to pretext) */
+export interface PreparedRichInlineItem {
+    text: string;
+    font: string;
+    letterSpacing?: number;
+    extraWidth?: number;
+    break?: 'normal' | 'never';
+    /** Original text before text-transform (if transform was applied). Used for copy-paste / round-trip. */
+    originalText?: string;
+    metadata: {
+        originalRunIndex: number;
+        baselineOffset: number;
+        effectiveFontSize: number;
+        style: TextRun;
+        inlineWidget?: TextRun['inlineWidget'];
+    };
+}
+/**
+ * Collapse consecutive collapsible whitespace → single space.
+ * Trim leading/trailing. CSS Text §4.1.1.
+ *
+ * Uses native regex (C++ in V8) instead of a manual JS loop.
+ */
+export declare function collapseSegmentWhitespace(segment: string): string;
+/**
+ * Split text on \n, collapse whitespace per segment (pre-line).
+ * Empty segments preserved (for \n\n → empty line).
+ *
+ * Three native calls: replace → split → map (trim).
+ * CSS Text §4.1.1 (pre-line): collapsing + segment break transformation.
+ */
+export declare function splitAndCollapseByHardBreaks(text: string): string[];
+/**
+ * Compile a paragraph into PreparedRichInlineItem[].
+ */
+export declare function compileParagraph(paragraph: Paragraph): PreparedRichInlineItem[];
+/**
+ * Zero phase: split a Paragraph into virtual Paragraph[] on \n boundaries.
+ *
+ * For `pre-line`: whitespace is collapsed per segment.
+ * For `pre`/`pre-wrap`: whitespace is preserved.
+ * For `normal`/`nowrap`/`undefined`: returns [paragraph] unchanged.
+ *
+ * Each \n produces an empty Paragraph (children: []) which the layout engine
+ * can fast-path as a hard-break line.
+ *
+ * Supports multi-run: when a run contains \n, the text after \n starts
+ * a new virtual paragraph. Runs after the split run belong to the new
+ * paragraph.
+ *
+ * @example
+ *   "Hello\nWorld" (pre-line)
+ *     → [{ children: [{ text: "Hello" }] }, { children: [{ text: "World" }] }]
+ *
+ *   "Hello\n\nWorld" (pre-line)
+ *     → [{ children: [{ text: "Hello" }] }, { children: [] }, { children: [{ text: "World" }] }]
+ *
+ *   ["Hello Bold", "\n", "World"] (pre)
+ *     → [{ children: [{ text: "Hello Bold" }] }, { children: [] }, { children: [{ text: "World" }] }]
+ */
+export declare function splitParagraphByHardBreaks(paragraph: Paragraph): Paragraph[];
+/**
+ * Get the full text of a paragraph (for INDEX_CONSIST checks).
+ */
+export declare function getParagraphText(paragraph: Paragraph): string;

package/dist/index.browser.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @vyaz/core — Browser entry point.
+ *
+ * Re-exports everything from the main index **except** `SystemFontRegistry`
+ * and `systemFontRegistry`, which require Node.js built-in modules
+ * (`node:fs`, `get-system-fonts`).
+ *
+ * All server-only code paths are guarded by runtime checks (`isNodeLike`)
+ * so tree-shakers can safely eliminate dead branches.
+ *
+ * ✅ Safe for Vite / webpack / Rollup / esbuild browser builds.
+ */
+export type { TextFrame, Paragraph, ParagraphStyle, TextRun, InlineWidget, AutofitConfig, TextAlignment, WritingMode, TextOrientation, VerticalAlignment, ScriptType, WhiteSpace, MultiColumnConfig, DominantBaseline, LineFitEdge, TextAlignLast, WordBreak, LineBreak, OverflowWrap, TextDecorationStyle, TextTransform, ListType, NumberFormat, ListStylePosition, ListStyle, } from './types/Document.js';
+export { DEFAULT_PARAGRAPH_STYLE, DEFAULT_TEXT_STYLE, } from './types/Document.js';
+export type { ParagraphLayoutResult, Line, Span, SpanFontMetrics, SemanticParagraph, SemanticLine, SemanticFragment, } from './types/LayoutTypes.js';
+export type { FontMetrics, IFontMetricsProvider, GlyphData, } from './types/FontTypes.js';
+export { ParagraphLayoutEngine, paragraphLayoutEngine } from './layout/ParagraphLayoutEngine.js';
+export { positionLines } from './layout/PositioningEngine.js';
+export { assertLineInvariants, linesToYAML } from './layout/LineBoxValidator.js';
+export type { InvariantError } from './layout/LineBoxValidator.js';
+export { layoutTextFrame } from './layout/TextFrameLayoutEngine.js';
+export type { TextFrameLayoutResult } from './layout/TextFrameLayoutEngine.js';
+export { applyScale, findScale } from './layout/AutoFitEngine.js';
+export type { AutoFitOptions, AutoFitResult } from './layout/AutoFitEngine.js';
+export { compileParagraph, getParagraphText, makeFontToken } from './compile/DocumentCompiler.js';
+export type { PreparedRichInlineItem } from './compile/DocumentCompiler.js';
+export { FontMetricsProvider, fontMetricsProvider } from './measure/FontMetricsProvider.js';
+export { FontNotFoundError } from './measure/FontNotFoundError.js';

package/dist/index.browser.js

@@ -0,0 +1,18 @@
+export {
+  positionLines,
+  paragraphLayoutEngine,
+  makeFontToken,
+  linesToYAML,
+  layoutTextFrame,
+  getParagraphText,
+  fontMetricsProvider,
+  findScale,
+  compileParagraph,
+  assertLineInvariants,
+  applyScale,
+  ParagraphLayoutEngine,
+  FontNotFoundError,
+  FontMetricsProvider,
+  DEFAULT_TEXT_STYLE,
+  DEFAULT_PARAGRAPH_STYLE
+};

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @vyaz/core — Public API.
+ *
+ * Exports input types (Logical level), output types (Physical Box Model),
+ * layout engines, font metric providers, renderers, and utilities.
+ */
+export type { TextFrame, Paragraph, ParagraphStyle, TextRun, InlineWidget, AutofitConfig, TextAlignment, WritingMode, TextOrientation, VerticalAlignment, ScriptType, WhiteSpace, MultiColumnConfig, DominantBaseline, LineFitEdge, TextAlignLast, WordBreak, LineBreak, OverflowWrap, TextDecorationStyle, TextTransform, ListType, NumberFormat, ListStylePosition, ListStyle, } from './types/Document.js';
+export { DEFAULT_PARAGRAPH_STYLE, DEFAULT_TEXT_STYLE, } from './types/Document.js';
+export type { ParagraphLayoutResult, Line, Span, SpanFontMetrics, SemanticParagraph, SemanticLine, SemanticFragment, } from './types/LayoutTypes.js';
+export type { FontMetrics, IFontMetricsProvider, GlyphData, } from './types/FontTypes.js';
+export { ParagraphLayoutEngine, paragraphLayoutEngine } from './layout/ParagraphLayoutEngine.js';
+export { positionLines } from './layout/PositioningEngine.js';
+export { assertLineInvariants, linesToYAML } from './layout/LineBoxValidator.js';
+export type { InvariantError } from './layout/LineBoxValidator.js';
+export { layoutTextFrame } from './layout/TextFrameLayoutEngine.js';
+export type { TextFrameLayoutResult } from './layout/TextFrameLayoutEngine.js';
+export { applyScale, findScale } from './layout/AutoFitEngine.js';
+export type { AutoFitOptions, AutoFitResult } from './layout/AutoFitEngine.js';
+export { groupLinesByParagraph } from './utils/groupLinesByParagraph.js';
+export type { ParagraphGroup } from './utils/groupLinesByParagraph.js';
+export { transformText } from './utils/textTransform.js';
+export { formatListNumber, defaultBulletChar, BULLET_CHARACTERS } from './utils/list.js';
+export { compileParagraph, getParagraphText, makeFontToken, splitParagraphByHardBreaks, collapseSegmentWhitespace } from './compile/DocumentCompiler.js';
+export type { PreparedRichInlineItem } from './compile/DocumentCompiler.js';
+export type { FontFace } from './measure/FontEngine.js';
+export { createFontFace, getGlyphAdvance, computePixelMetrics, isFontEngineAvailable } from './measure/FontEngine.js';
+export { FontMetricsProvider, fontMetricsProvider } from './measure/FontMetricsProvider.js';
+export { SystemFontRegistry, systemFontRegistry } from './measure/SystemFontRegistry.js';
+export { getFontBuffer } from './utils/font.js';
+export { FontNotFoundError } from './measure/FontNotFoundError.js';