@weasel-js/text 1.14.1 → 1.15.0

package/dist/{test-seams-DHGfE_6p.d.ts → test-seams-Ck0mfD3U.d.ts}

@@ -389,6 +389,12 @@ interface TextPaint {
  * mean-of-the-axes factor `resolveStrokeWidth` takes.
  */
 declare function resolveTextStyle(style?: TextStyle, paint?: TextPaint, scale?: number): ResolvedTextStyle;
+/**
+ * {@link resolveTextStyle}, written into `out` and returned. A field `out`
+ * holds that this resolution leaves out — `script`, `lang`, `stroke` — is set
+ * to `undefined`, so one object can take resolution after resolution.
+ */
+declare function resolveTextStyleInto(out: ResolvedTextStyle, style?: TextStyle, paint?: TextPaint, scale?: number): ResolvedTextStyle;
 /** Build a CSS `font` shorthand suitable for `ctx.font`. */
 declare function fontString(s: ResolvedTextStyle): string;
 
@@ -513,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.
@@ -961,6 +975,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;
 
@@ -976,13 +1002,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 { scriptMetricsFor 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, runsToMarkdown as Y, runsToPlainText as Z, scriptMetrics as _, type ResolvedRun as a, smallCapsScale as a0, smallCapsScaleFor as a1, smallCapsText as a2, toRuns as a3, transformRunTexts as a4, _resetBidiWarningForTests as a5, _resetLayoutCacheForTests as a6, 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 { a5 as _resetBidiWarningForTests, a6 as _resetLayoutCacheForTests } from './test-seams-DHGfE_6p.js';
+export { aa as _resetBidiWarningForTests, ab as _resetLayoutCacheForTests } from './test-seams-Ck0mfD3U.js';
 import '@weasel-js/paint';
 import '@weasel-js/font';

package/dist/test-seams.js

@@ -1,3 +1,3 @@
-export { _resetBidiWarningForTests, _resetLayoutCacheForTests } from './chunk-FODNMBHI.js';
+export { _resetBidiWarningForTests, _resetLayoutCacheForTests } from './chunk-ZNSU5C43.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.1",
+  "version": "1.15.0",
   "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.1",
-    "@weasel-js/paint": "1.14.1",
-    "@weasel-js/registry": "1.14.1"
+    "@weasel-js/geom": "1.15.0",
+    "@weasel-js/paint": "1.15.0",
+    "@weasel-js/registry": "1.15.0"
   },
   "scripts": {
     "test": "vitest run",
@@ -51,9 +51,9 @@
     "provenance": true
   },
   "devDependencies": {
-    "@weasel-js/bidi": "1.14.1"
+    "@weasel-js/bidi": "1.15.0"
   },
   "peerDependencies": {
-    "@weasel-js/font": "1.14.1"
+    "@weasel-js/font": "1.15.0"
   }
 }