@vyaz/core 0.0.16 → 0.1.0

package/dist/compile/ParagraphCompiler.d.ts

@@ -0,0 +1,84 @@
+/**
+ * ParagraphCompiler.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, ResolvedTextRun } 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: ResolvedTextRun;
+        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;
+//# sourceMappingURL=ParagraphCompiler.d.ts.map

package/dist/compile/ParagraphCompiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParagraphCompiler.d.ts","sourceRoot":"","sources":["../../src/compile/ParagraphCompiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAiB,MAAM,sBAAsB,CAAC;AAM/F,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAe/C,CAAC;AAEF,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAI/E;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAK7E;AAED,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC3B,wGAAwG;IACxG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE;QACR,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,KAAK,EAAE,eAAe,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;KACxC,CAAC;CACH;AAcD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMnE;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,sBAAsB,EAAE,CA2E/E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,CAoD5E;AAOD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAE7D"}

package/dist/debug/lines-to-yaml.d.ts

@@ -0,0 +1,14 @@
+/**
+ * lines-to-yaml.ts — semantic YAML serialization of laid-out lines.
+ *
+ * Debug/snapshot tooling only. Reached through the `@vyaz/core/debug` entry so
+ * that `js-yaml` never lands in the production `@vyaz/core` bundle.
+ */
+import type { Line } from '../types/LayoutTypes.js';
+/**
+ * Convert Line[] to YAML string for snapshots.
+ * Only semantic data: text, x, width, style.
+ * No glyphAdvances, fontMetrics (noise), inlineWidget.
+ */
+export declare function linesToYAML(lines: Line[], paragraphWidth: number, paragraphHeight: number): string;
+//# sourceMappingURL=lines-to-yaml.d.ts.map

package/dist/debug/lines-to-yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines-to-yaml.d.ts","sourceRoot":"","sources":["../../src/debug/lines-to-yaml.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAA2B,MAAM,yBAAyB,CAAC;AAU7E;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,IAAI,EAAE,EACb,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB,MAAM,CAwBR"}

package/dist/debug.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @vyaz/core/debug — debugging & snapshot tooling.
+ *
+ * Kept out of the main entry so production consumers never pull `js-yaml`
+ * or the invariant-checking code into their bundle.
+ */
+export { assertLineInvariants } from './layout/LineBoxValidator.js';
+export type { InvariantError } from './layout/LineBoxValidator.js';
+export { linesToYAML } from './debug/lines-to-yaml.js';
+export type { SemanticParagraph, SemanticLine, SemanticFragment, } from './types/LayoutTypes.js';
+//# sourceMappingURL=debug.d.ts.map

package/dist/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,GACjB,MAAM,wBAAwB,CAAC"}

package/dist/debug.js

@@ -0,0 +1,4 @@
+export {
+  linesToYAML,
+  assertLineInvariants
+};

package/dist/index.browser.d.ts

@@ -15,14 +15,19 @@
 export { ParagraphLayoutEngine, paragraphLayoutEngine } from './layout/ParagraphLayoutEngine.js';
 /** @internal */
 export { positionLines } from './layout/PositioningEngine.js';
-/** @internal */
-export { assertLineInvariants, linesToYAML } from './layout/LineBoxValidator.js';
 export { groupLinesByParagraph } from './utils/groupLinesByParagraph.js';
 export { layoutTextFrame } from './layout/TextFrameLayoutEngine.js';
+export { createLayoutEngine } from './layout/create-engine.js';
+export type { LayoutEngine, LayoutEngineOptions } from './layout/create-engine.js';
+export type { LayoutOptions, TextFrameLayoutResult, AutofitOutcome } from './layout/TextFrameLayoutEngine.js';
+export type { OnMissingFont } from './layout/resolve-font.js';
 export { applyScale, findScale } from './layout/AutoFitEngine.js';
-export { compileParagraph, getParagraphText, makeFontToken, collapseSegmentWhitespace, splitParagraphByHardBreaks } from './compile/DocumentCompiler.js';
+export { compileParagraph, getParagraphText, makeFontToken, collapseSegmentWhitespace, splitParagraphByHardBreaks } from './compile/ParagraphCompiler.js';
 export { FontMetricsProvider, fontMetricsProvider } from './measure/FontMetricsProvider.js';
-export { createFontFace, getGlyphAdvance, computePixelMetrics, isFontEngineAvailable } from './measure/FontEngine.js';
+export { createFontFace, getGlyphAdvance, computePixelMetrics, isFontEngineAvailable, shapeRun } from './measure/FontEngine.js';
+export type { ShapedRun, ShapedGlyph } from './measure/FontEngine.js';
+export { setMeasureProfile, getMeasureProfile, measurePx } from './measure/FontkitMeasureContext.js';
+export type { MeasureProfile } from './measure/FontkitMeasureContext.js';
 export { getFontBuffer } from './utils/font.js';
 export { FontNotFoundError } from './measure/FontNotFoundError.js';
 import type { ParagraphStyle, TextRun } from './types/Document.js';

package/dist/index.browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAEjG,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,gBAAgB;AAChB,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAGjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAGzJ,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACtH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAOnE,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnE,gBAAgB;AAChB,eAAO,MAAM,uBAAuB,EAAE,cAA4B,CAAC;AACnE,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,OAAO,CAAe,CAAC;AAEhE,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAc,CAAC;AACpE,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAEjG,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAI9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACnF,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAC9G,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAG1J,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAChI,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACrG,YAAY,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAOnE,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnE,gBAAgB;AAChB,eAAO,MAAM,uBAAuB,EAAE,cAA4B,CAAC;AACnE,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,OAAO,CAAe,CAAC;AAEhE,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAc,CAAC;AACpE,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}