modern-text 1.12.0 → 2.0.0

package/dist/shared/{modern-text.C8g4NZgY.d.ts → modern-text.D4WopQCu.d.ts}

@@ -57,6 +57,16 @@ declare class Character {
     constructor(content: string, index: number, parent: Fragment);
     protected _getFontSFNT(fonts?: Fonts): SFNT | undefined;
     updateGlyph(sfnt?: SFNT | undefined): this;
+    /**
+     * Populate glyph metrics only (advance width/height, ascender/descender,
+     * baseline, …) without building the glyph `path` or touching boxes.
+     *
+     * The DOM {@link DomMeasurer} never needs this — it reads positions back from the
+     * browser. A pure-JS measurer (e.g. `FontMeasurer`) must know advances *before*
+     * it can place characters, so it calls this ahead of layout. `update()` later
+     * recomputes the same metrics while building the path, so this is idempotent.
+     */
+    measureGlyph(fonts?: Fonts): this;
     update(fonts?: Fonts): this;
     protected _italic(path: Path2D, startPoint?: Vector2Like): void;
     getGlyphMinMax(min?: Vector2, max?: Vector2, withStyle?: boolean): {
@@ -66,24 +76,6 @@ declare class Character {
     getGlyphBoundingBox(withStyle?: boolean): BoundingBox | undefined;
 }
 
-interface Plugin {
-    name: string;
-    pathSet?: Path2DSet;
-    getBoundingBox?: (text: Text$1) => BoundingBox | undefined;
-    update?: (text: Text$1) => void;
-    updateOrder?: number;
-    render?: (renderer: Canvas2DRenderer) => void;
-    renderOrder?: number;
-    load?: (text: Text$1) => Promise<void>;
-    context?: Record<string, any>;
-}
-interface Options extends TextObject {
-    debug?: boolean;
-    measureDom?: HTMLElement;
-    fonts?: Fonts;
-    plugins?: Plugin[];
-}
-
 interface MeasuredParagraph {
     paragraphIndex: number;
     left: number;
@@ -127,7 +119,7 @@ interface RootDomStyles {
     section: Record<string, any>;
     ul: Record<string, any>;
 }
-declare class Measurer {
+declare class DomMeasurer {
     static notZeroStyles: Set<string>;
     static pxStyles: Set<string>;
     protected _styleCache: WeakMap<object, Record<string, any>>;
@@ -166,6 +158,47 @@ declare class Measurer {
     dispose(): void;
 }
 
+interface Plugin {
+    name: string;
+    pathSet?: Path2DSet;
+    getBoundingBox?: (text: Text$1) => BoundingBox | undefined;
+    update?: (text: Text$1) => void;
+    updateOrder?: number;
+    render?: (renderer: Canvas2DRenderer) => void;
+    renderOrder?: number;
+    load?: (text: Text$1) => Promise<void>;
+    context?: Record<string, any>;
+}
+/**
+ * Pluggable layout backend. Implementations fill the four-level boxes
+ * (`character.inlineBox`/`lineBox`, `fragment.inlineBox`, `paragraph.lineBox`)
+ * in place and return the overall bounding box.
+ *
+ * - `DomMeasurer` — DOM-based, uses the browser as ground truth (default).
+ * - `FontMeasurer` — pure-JS, DOM-free; needs `fonts` to resolve glyph advances.
+ *
+ * `fonts` is passed positionally by `Text.measure()`; DOM-based measurers ignore
+ * it (a method may safely declare fewer parameters than the interface).
+ */
+interface TextMeasurer {
+    measure: (paragraphs: Paragraph[], rootStyle: FullStyle, dom?: HTMLElement, fonts?: Fonts) => MeasureDomResult;
+    createDom?: (paragraphs: Paragraph[], rootStyle: FullStyle) => HTMLElement;
+    dispose?: () => void;
+}
+/** Built-in layout backends. `'font'` → `FontMeasurer`, `'dom'` → `DomMeasurer`. */
+type MeasurerKind = 'dom' | 'font';
+interface Options extends TextObject {
+    debug?: boolean;
+    measureDom?: HTMLElement;
+    fonts?: Fonts;
+    plugins?: Plugin[];
+    /**
+     * Layout backend: `'font'` (pure-JS) or `'dom'` (browser), or a custom
+     * `TextMeasurer`. Defaults to `'font'` when `fonts` are provided, else `'dom'`.
+     */
+    measurer?: MeasurerKind | TextMeasurer;
+}
+
 interface RenderOptions {
     view: HTMLCanvasElement;
     pixelRatio?: number;
@@ -221,7 +254,7 @@ declare class Text$1 extends Reactivable {
     glyphBox: BoundingBox;
     pathBox: BoundingBox;
     boundingBox: BoundingBox;
-    measurer: Measurer;
+    measurer: TextMeasurer;
     plugins: Map<string, Plugin>;
     pathSets: Path2DSet[];
     protected _paragraphs: Paragraph[];
@@ -304,5 +337,5 @@ declare class Canvas2DRenderer {
     drawCharacter: (character: Character, effect?: NormalizedEffect) => void;
 }
 
-export { Canvas2DRenderer as C, Fragment as F, Paragraph as P, Text$1 as T, Character as a, Measurer as g, textDefaultStyle as t };
-export type { DrawShapePathsOptions as D, MeasureDomResult as M, Options as O, RenderOptions as R, MeasureResult as b, MeasuredCharacter as c, MeasuredCharacterRect as d, MeasuredFragment as e, MeasuredParagraph as f, Plugin as h, TextEvents as i };
+export { Canvas2DRenderer as C, DomMeasurer as D, Fragment as F, Paragraph as P, Text$1 as T, Character as a, textDefaultStyle as t };
+export type { MeasureDomResult as M, Options as O, RenderOptions as R, DrawShapePathsOptions as b, MeasureResult as c, MeasuredCharacter as d, MeasuredCharacterRect as e, MeasuredFragment as f, MeasuredParagraph as g, MeasurerKind as h, Plugin as i, TextEvents as j, TextMeasurer as k };

package/dist/web-components/index.cjs

@@ -2,10 +2,10 @@
 
 const diff = require('diff');
 const modernIdoc = require('modern-idoc');
-const Text = require('../shared/modern-text.DR1hbjgA.cjs');
+const Text = require('../shared/modern-text.CBgc-cQ1.cjs');
 require('modern-path2d');
-require('../shared/modern-text.B2xfrqDc.cjs');
 require('modern-font');
+require('../shared/modern-text.B2xfrqDc.cjs');
 
 var __defProp = Object.defineProperty;
 var __decorateClass = (decorators, target, key, kind) => {

package/dist/web-components/index.d.cts

@@ -1,5 +1,5 @@
 import { PropertyAccessor, NormalizedTextContent } from 'modern-idoc';
-import { T as Text } from '../shared/modern-text.C8g4NZgY.cjs';
+import { T as Text } from '../shared/modern-text.D4WopQCu.cjs';
 import 'modern-path2d';
 import 'modern-font';
 

package/dist/web-components/index.d.mts

@@ -1,5 +1,5 @@
 import { PropertyAccessor, NormalizedTextContent } from 'modern-idoc';
-import { T as Text } from '../shared/modern-text.C8g4NZgY.mjs';
+import { T as Text } from '../shared/modern-text.D4WopQCu.mjs';
 import 'modern-path2d';
 import 'modern-font';
 

package/dist/web-components/index.d.ts

@@ -1,5 +1,5 @@
 import { PropertyAccessor, NormalizedTextContent } from 'modern-idoc';
-import { T as Text } from '../shared/modern-text.C8g4NZgY.js';
+import { T as Text } from '../shared/modern-text.D4WopQCu.js';
 import 'modern-path2d';
 import 'modern-font';
 

package/dist/web-components/index.mjs

@@ -1,9 +1,9 @@
 import { diffChars } from 'diff';
 import { isCRLF, textContentToString, normalizeCRLF, normalizeTextContent, property } from 'modern-idoc';
-import { T as Text } from '../shared/modern-text.CrFHIJtB.mjs';
+import { T as Text } from '../shared/modern-text.ChzjFjsk.mjs';
 import 'modern-path2d';
-import '../shared/modern-text.JF1ny7A-.mjs';
 import 'modern-font';
+import '../shared/modern-text.JF1ny7A-.mjs';
 
 var __defProp = Object.defineProperty;
 var __decorateClass = (decorators, target, key, kind) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "modern-text",
   "type": "module",
-  "version": "1.12.0",
+  "version": "2.0.0",
   "packageManager": "pnpm@10.18.1",
   "description": "Measure and render text in a way that describes the DOM.",
   "author": "wxm",
@@ -60,19 +60,19 @@
   },
   "dependencies": {
     "diff": "^9.0.0",
-    "modern-font": "^0.5.0",
+    "modern-font": "^0.6.0",
     "modern-idoc": "^0.11.5",
     "modern-path2d": "^1.6.0"
   },
   "devDependencies": {
     "@antfu/eslint-config": "^9.0.0",
-    "@types/node": "^25.8.0",
+    "@types/node": "^25.9.1",
     "bumpp": "^11.1.0",
     "conventional-changelog-cli": "^5.0.0",
-    "eslint": "^10.3.0",
+    "eslint": "^10.4.0",
     "typescript": "^6.0.3",
     "unbuild": "^3.6.1",
-    "vite": "^8.0.13",
-    "vitest": "^4.1.6"
+    "vite": "^8.0.14",
+    "vitest": "^4.1.7"
   }
 }