@weasel-js/text 1.14.2 → 1.15.1

package/dist/{test-seams-D6uEFbAw.d.ts → test-seams-B2R_EedN.d.ts}

@@ -519,6 +519,14 @@ declare function resolveRunFace(run: StyledRun, style: Pick<ResolvedTextStyle, '
  *  `{ px }` size or spacing; the inherited ones arrived already resolved on
  *  `style`. */
 declare function resolveRuns(runs: readonly StyledRun[], style: ResolvedTextStyle, viewScale?: number): ResolvedRun[];
+/**
+ * {@link resolveRuns} into `out`, which is refilled in place and returned: a
+ * run already at an index is rewritten when it has the same optional fields as
+ * its replacement. For a caller that owns `out` and hands nothing it held
+ * to anyone who keeps it; one whose runs the text caches have seen calls
+ * `clearRuns` on them first.
+ */
+declare function resolveRunsInto(out: ResolvedRun[], runs: readonly StyledRun[], style: ResolvedTextStyle, viewScale?: number): ResolvedRun[];
 
 /**
  * The bidi contract, declared here and implemented elsewhere.
@@ -613,11 +621,13 @@ interface ShapedCluster {
     d: string | null;
     /** Names `d` among the glyphs of one face, for caching what is built from it. */
     key: string;
-    /** Each glyph and where it is drawn, in ems from the pen, y down. */
+    /** Each glyph, where it is drawn, and how far the shaper moved the pen past it, in ems
+     *  from the pen, y down. A mark the shaper set over its base has no advance. */
     glyphs: readonly {
         gid: number;
         x: number;
         y: number;
+        advance: number;
     }[];
     /** Whether it was shaped right to left. */
     rtl: boolean;
@@ -967,6 +977,18 @@ declare function cachedLayoutRuns(runs: readonly ResolvedRun[], opts: LayoutRuns
  * Passing `runs` again afterwards is only a cache miss.
  */
 declare function dropRuns(runs: readonly ResolvedRun[]): void;
+/**
+ * Forget what the caches hold for `runs`, which its caller is about to refill
+ * in place, leaving the array filed: unlike {@link dropRuns}, the next call
+ * with it costs no `WeakMap` set. A readout rewriting its text every frame
+ * refills one runs array this way, so the command it hands the renderer
+ * stays the same object.
+ *
+ * Call it before the first write to `runs` or any run in it: the structural
+ * list compares later runs with these, and a painting may still have to build
+ * its key from them.
+ */
+declare function clearRuns(runs: readonly ResolvedRun[]): void;
 /** Test helper. Do not call from product code. */
 declare function _resetLayoutCacheForTests(): void;
 
@@ -982,13 +1004,20 @@ declare function _resetLayoutCacheForTests(): void;
  * none. Pass `null`, or call the function returned, to take it out again.
  */
 declare function registerBidi(engine: BidiResolver | null): () => void;
+/** The engine {@link registerBidi} was last given, or null. */
+declare function registeredBidi(): BidiResolver | null;
 /**
  * The direction `text`'s first paragraph reads in: `direction` when it states
  * one, otherwise its first strong character's. Finding that takes an engine,
  * so with none registered the answer is `'ltr'`.
  */
 declare function paragraphDirection(text: string, direction?: TextDirection | 'auto', engine?: BidiResolver | null): TextDirection;
+/**
+ * Warn, once per process, when `codePoints` hold right-to-left letters and
+ * there is no engine to reorder them. `who` names the caller laying them out.
+ */
+declare function warnRtlWithoutEngine(codePoints: ArrayLike<number>, who?: string): void;
 /** Test helper. Do not call from product code. */
 declare function _resetBidiWarningForTests(): void;
 
-export { scriptMetrics as $, dropRuns as A, type BidiAnalysis as B, type CacheUse as C, DEFAULT_TEXT_FILL as D, fontString as E, type FontVariantCaps as F, halfLeadingFor as G, isBoldWeight as H, isSmallCapsLetter as I, layoutRuns as J, markdownToRuns as K, type LaidOutRuns as L, MARKDOWN_RUN_GRAMMAR as M, numericWeight as N, paragraphDirection as O, type PlacedGlyph as P, registerBidi as Q, type ResolvedTextStyle as R, type StyledRun as S, type TextStyle as T, resolveAlign as U, resolveRunFace as V, resolveRuns as W, resolveTextStyle as X, resolveTextStyleInto as Y, runsToMarkdown as Z, runsToPlainText as _, type ResolvedRun as a, scriptMetricsFor as a0, smallCapsScale as a1, smallCapsScaleFor as a2, smallCapsText as a3, toRuns as a4, transformRunTexts as a5, _resetBidiWarningForTests as a6, _resetLayoutCacheForTests as a7, type LayoutRunsOpts as b, type TextShaper as c, type TextPaint as d, type BidiReordering as e, type BidiResolver as f, DEFAULT_TEXT_STYLE as g, LAYOUT_CACHE_STRUCTURAL_LIMIT as h, LAYOUT_CACHE_VARIANT_LIMIT as i, type LaidOutCell as j, type LaidOutLineBox as k, type RunFlag as l, type RunGrammar as m, type RunMarker as n, type RunSourceMap as o, SCRIPT_METRICS as p, SMALL_CAPS_SCALE as q, type ScriptPreset as r, type ShapedCluster as s, type ShapedGlyph as t, type SmallCapsText as u, type TextAlign as v, type TextDirection as w, type TextTransform as x, type TransformedRunText as y, cachedLayoutRuns as z };
+export { resolveTextStyleInto as $, clearRuns as A, type BidiAnalysis as B, type CacheUse as C, DEFAULT_TEXT_FILL as D, dropRuns as E, type FontVariantCaps as F, fontString as G, halfLeadingFor as H, isBoldWeight as I, isSmallCapsLetter as J, layoutRuns as K, type LaidOutRuns as L, MARKDOWN_RUN_GRAMMAR as M, markdownToRuns as N, numericWeight as O, type PlacedGlyph as P, paragraphDirection as Q, type ResolvedTextStyle as R, type StyledRun as S, type TextStyle as T, registerBidi as U, registeredBidi as V, resolveAlign as W, resolveRunFace as X, resolveRuns as Y, resolveRunsInto as Z, resolveTextStyle as _, type ResolvedRun as a, runsToMarkdown as a0, runsToPlainText as a1, scriptMetrics as a2, scriptMetricsFor as a3, smallCapsScale as a4, smallCapsScaleFor as a5, smallCapsText as a6, toRuns as a7, transformRunTexts as a8, warnRtlWithoutEngine as a9, _resetBidiWarningForTests as aa, _resetLayoutCacheForTests as ab, type LayoutRunsOpts as b, type TextShaper as c, type TextPaint as d, type BidiReordering as e, type BidiResolver as f, DEFAULT_TEXT_STYLE as g, LAYOUT_CACHE_STRUCTURAL_LIMIT as h, LAYOUT_CACHE_VARIANT_LIMIT as i, type LaidOutCell as j, type LaidOutLineBox as k, type RunFlag as l, type RunGrammar as m, type RunMarker as n, type RunSourceMap as o, SCRIPT_METRICS as p, SMALL_CAPS_SCALE as q, type ScriptPreset as r, type ShapedCluster as s, type ShapedGlyph as t, type SmallCapsText as u, type TextAlign as v, type TextDirection as w, type TextTransform as x, type TransformedRunText as y, cachedLayoutRuns as z };

package/dist/test-seams.d.ts

@@ -1,3 +1,3 @@
-export { a6 as _resetBidiWarningForTests, a7 as _resetLayoutCacheForTests } from './test-seams-D6uEFbAw.js';
+export { aa as _resetBidiWarningForTests, ab as _resetLayoutCacheForTests } from './test-seams-B2R_EedN.js';
 import '@weasel-js/paint';
 import '@weasel-js/font';

package/dist/test-seams.js

@@ -1,3 +1,3 @@
-export { _resetBidiWarningForTests, _resetLayoutCacheForTests } from './chunk-5BJN6MC6.js';
+export { _resetBidiWarningForTests, _resetLayoutCacheForTests } from './chunk-WUFANHTE.js';
 //# sourceMappingURL=test-seams.js.map
 //# sourceMappingURL=test-seams.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weasel-js/text",
-  "version": "1.14.2",
+  "version": "1.15.1",
   "description": "Typography for weasel: styled runs, style resolution, kerned glyph layout, wrap and measurement. No scene graph, no React.",
   "license": "MIT",
   "type": "module",
@@ -20,9 +20,9 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@weasel-js/geom": "1.14.2",
-    "@weasel-js/paint": "1.14.2",
-    "@weasel-js/registry": "1.14.2"
+    "@weasel-js/geom": "1.15.1",
+    "@weasel-js/paint": "1.15.1",
+    "@weasel-js/registry": "1.15.1"
   },
   "scripts": {
     "test": "vitest run",
@@ -51,9 +51,9 @@
     "provenance": true
   },
   "devDependencies": {
-    "@weasel-js/bidi": "1.14.2"
+    "@weasel-js/bidi": "1.15.1"
   },
   "peerDependencies": {
-    "@weasel-js/font": "1.14.2"
+    "@weasel-js/font": "1.15.1"
   }
 }