@geometra/core 1.0.0 → 1.1.0

package/dist/fonts.d.ts

@@ -1,14 +1,47 @@
 import type { UIElement } from './types.js';
 /**
  * Extract custom font family names from a CSS `font` shorthand (e.g. `600 14px Inter`).
- * Drops generic fallbacks like `sans-serif`. Best-effort parsing for common patterns.
+ * Drops generic fallbacks like `sans-serif`, CSS-wide keywords (`inherit`, `initial`, …), and
+ * system font keywords (`caption`, `menu`, …).
+ * Repeated custom names in the same list collapse
+ * to the first spelling (comparison is case-insensitive, e.g. `Inter, inter` → one entry).
+ * Best-effort parsing for common patterns.
+ * Commas inside quoted family names are ignored; `\\` escapes the next character inside quotes (e.g. `\"` for a literal `"`).
+ * Recognizes common font-size units (px, em, rem, cap/ic/lh/rlh, root-relative r* units, pt, %, viewport, viewport inline/block (`vi`/`vb` and `d*`/`s*`/`l*` variants), dynamic-viewport, container query, Q, and math units), including scientific notation on the numeric part (e.g. `1e2px`).
+ * CSS math functions `calc()`, `min()`, `max()`, and `clamp()` are treated as a single font-size token (balanced parentheses; commas inside are allowed).
+ * When a percentage is used as `font-stretch` before the real font size (e.g. `75% 14px Inter`),
+ * skips that leading dimension so the size + family tail is parsed correctly.
+ * Very long chains of leading size tokens are peeled with a bounded primary budget, then a secondary pass on modest remainders.
+ * If an oversized tail still looks like stacked size tokens, returns [] rather than inventing a family name or doing pathological work.
+ * Line-height after `/` may be numeric (with optional unit) or the `normal` keyword; a slash line-height
+ * with no following family list yields no families (e.g. `14px / normal` alone).
+ * Leading relative size keywords `smaller` and `larger` (CSS Fonts) are stripped so
+ * values like `smaller Inter, serif` resolve to concrete families for {@link waitForFonts}.
+ * Leading absolute size keywords (`medium`, `xx-small`, `large`, …) are stripped the same way.
+ * A comma-list segment that is exactly an absolute size keyword is dropped when unquoted; the same word
+ * inside quotes is kept (CSS requires quoting when a family name matches a keyword).
+ * Unquoted `url(...)` and `format(...)` segments (e.g. mistaken `@font-face` `src` paste) are not
+ * concrete family names and are skipped so {@link waitForFonts} does not call `load` with them.
+ * The same spellings inside quotes are kept as literal family names (CSS `font-family` rules).
  */
 export declare function extractFontFamiliesFromCSSFont(font: string): string[];
-/** Collect unique font families referenced by text nodes in a UI tree. */
+/**
+ * Collect unique font families referenced by text nodes in a UI tree.
+ * Order is first-seen in a depth-first preorder walk (later duplicates are skipped).
+ */
 export declare function collectFontFamiliesFromTree(root: UIElement): string[];
+/**
+ * Resolve a font-load timeout in milliseconds. Used by {@link waitForFonts} and `createApp`'s
+ * `fontLoadTimeoutMs` so `NaN`, `±Infinity`, negative values, and non-numbers all fall back to
+ * `defaultMs` (avoids `??` missing `NaN` and odd `setTimeout` coercion).
+ */
+export declare function resolveFontLoadTimeoutMs(timeoutMs: number | undefined, defaultMs?: number): number;
 /**
  * Wait for web fonts used by the app. Browser only; no-op on server.
  * Uses `document.fonts.load` per family; timeouts are swallowed so startup never hard-fails.
+ * Empty and whitespace-only family strings are ignored; names are trimmed before load and deduped.
+ * `timeoutMs` must be a finite non-negative number; otherwise the default `10_000` is used (avoids
+ * relying on `setTimeout` coercion for `NaN`, `±Infinity`, or negative values).
  */
 export declare function waitForFonts(families: string[], timeoutMs?: number): Promise<void>;
 //# sourceMappingURL=fonts.d.ts.map

package/dist/fonts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAe3C;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQrE;AAED,0EAA0E;AAC1E,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAarE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBxF"}
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AA6K3C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAgKrE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAarE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,SAAS,GAAG,MAAM,CAElG;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBxF"}

package/dist/fonts.js

@@ -8,22 +8,331 @@ const GENERIC_FAMILIES = new Set([
     'ui-sans-serif',
     'ui-serif',
     'ui-monospace',
+    'ui-rounded',
     'emoji',
 ]);
+/** CSS-wide keywords that may appear in `font` / family lists but are not concrete family names. */
+const CSS_WIDE_FONT_KEYWORDS = new Set([
+    'inherit',
+    'initial',
+    'unset',
+    'revert',
+    'revert-layer',
+]);
+/**
+ * Single-keyword `font` values that select the UA system font (CSS Fonts); not concrete families
+ * and must not be passed to `document.fonts.load`.
+ */
+const SYSTEM_FONT_KEYWORDS = new Set([
+    'caption',
+    'icon',
+    'menu',
+    'message-box',
+    'small-caption',
+    'status-bar',
+]);
+/**
+ * Font-size units we treat as the numeric token before the family list in `font` shorthand.
+ * Longer tokens precede shorter prefixes (e.g. `dvmin` before `vmin`, `rlh` before `lh`, `rch` before `ch`).
+ */
+const FONT_SIZE_UNIT = '(?:dvmin|dvmax|svmin|svmax|lvmin|lvmax|dvh|dvw|dvi|dvb|svh|svw|svi|svb|lvh|lvw|lvi|lvb|' +
+    'vmin|vmax|vh|vw|vi|vb|' +
+    'cqmin|cqmax|cqi|cqb|cqw|cqh|' +
+    'rlh|rcap|rch|rex|ric|' +
+    'rem|cap|px|em|pt|pc|in|cm|math|mm|Q|%|ch|ex|ic|lh)';
+/** Magnitude in a `font-size` dimension token (allows scientific notation, e.g. `1e2px`). */
+const FONT_SIZE_NUMBER = String.raw `\d+(?:\.\d+)?(?:[eE][+-]?\d+)?`;
+/** Optional `/ line-height` after font-size in shorthand (numeric length or keyword `normal`). */
+const FONT_SHORTHAND_LINE_HEIGHT = String.raw `(?:\/\s*(?:` + FONT_SIZE_NUMBER + FONT_SIZE_UNIT + String.raw `?|normal))?`;
+/**
+ * Size + required `/ line-height` before the family list. Family tail may be empty (invalid shorthand
+ * with no family); tried before {@link FONT_SHORTHAND_FAMILY_TAIL} so `/ normal` is not misparsed as a family.
+ */
+const FONT_SHORTHAND_SLASH_LINE_TAIL = new RegExp(String.raw `\b(` +
+    FONT_SIZE_NUMBER +
+    FONT_SIZE_UNIT +
+    String.raw `)\s*\/\s*(?:` +
+    FONT_SIZE_NUMBER +
+    FONT_SIZE_UNIT +
+    String.raw `?|normal)\s*(.*)$`, 'i');
+const FONT_SHORTHAND_FAMILY_TAIL = new RegExp(String.raw `\b(` + FONT_SIZE_NUMBER + FONT_SIZE_UNIT + String.raw `)\s*` + FONT_SHORTHAND_LINE_HEIGHT + String.raw `\s+(.+)$`, 'i');
+const FONT_SIZE_ONLY = new RegExp(String.raw `^` + FONT_SIZE_NUMBER + FONT_SIZE_UNIT + String.raw `$`, 'i');
+/** True when the family tail begins with a dimension token + space (another size before the real family). */
+const TAIL_LEADS_WITH_SIZE_TOKEN = new RegExp(String.raw `^` + FONT_SIZE_NUMBER + FONT_SIZE_UNIT + String.raw `\s+`, 'i');
+/**
+ * Upper bound on leading token strips for `font` shorthand parsing (pathological inputs stay finite).
+ * Long font-stretch / leading-percent stacks before the real size + family can consume one strip each.
+ */
+const MAX_SHORTHAND_STRIP_ITERATIONS = 4096;
+/**
+ * After the primary strip budget, if this many characters remain and another peel is still required,
+ * return [] instead of continuing (avoids O(n²) regex work and bogus synthesized family names).
+ */
+const MAX_REMAINDER_AFTER_PRIMARY_STRIP = 16_384;
+/** Extra peels allowed on modest remainders once the primary budget is exhausted. */
+const EXTRA_SHORTHAND_STRIP_ITERATIONS = 8192;
+/** Max leading `smaller` / `larger` peels (relative font-size keywords before family or explicit size). */
+const MAX_RELATIVE_SIZE_PREFIX_STRIPS = 8;
+/**
+ * CSS absolute font-size keywords (CSS Fonts). When they lead the shorthand they must be peeled before
+ * size+family parsing; when a comma-separated segment is exactly one of these (unquoted), it is not a
+ * family name (quoted names still pass through).
+ */
+const ABSOLUTE_FONT_SIZE_KEYWORDS = new Set([
+    'xx-small',
+    'x-small',
+    'small',
+    'medium',
+    'large',
+    'x-large',
+    'xx-large',
+    'xxx-large',
+]);
+/** Longest-match alternation so `xx-large` does not match as `x-large` + `large`. */
+const ABSOLUTE_FONT_SIZE_PREFIX = /^(xxx-large|xx-large|xx-small|x-large|x-small|small|medium|large)\s+/i;
+/** Max leading absolute keyword strips (pathological stacks stay bounded). */
+const MAX_ABSOLUTE_SIZE_PREFIX_STRIPS = 16;
+/** Index after the closing `)` that matches `s[openParenIndex]` (which must be `(`). */
+function indexAfterMatchingParen(s, openParenIndex) {
+    let depth = 0;
+    for (let i = openParenIndex; i < s.length; i++) {
+        const c = s[i];
+        if (c === '(')
+            depth++;
+        else if (c === ')') {
+            depth--;
+            if (depth === 0)
+                return i + 1;
+        }
+    }
+    return null;
+}
+/** Split a CSS font-family list on commas not inside single or double quotes. */
+function splitFontFamilyList(tail) {
+    const parts = [];
+    let cur = '';
+    let quote = null;
+    for (let i = 0; i < tail.length; i++) {
+        const c = tail[i];
+        if (quote) {
+            if (c === '\\' && i + 1 < tail.length) {
+                cur += tail[i + 1];
+                i++;
+                continue;
+            }
+            cur += c;
+            if (c === quote)
+                quote = null;
+            continue;
+        }
+        if (c === '"' || c === "'") {
+            quote = c;
+            cur += c;
+            continue;
+        }
+        if (c === ',') {
+            const t = cur.trim();
+            if (t.length > 0)
+                parts.push(t);
+            cur = '';
+            continue;
+        }
+        cur += c;
+    }
+    const last = cur.trim();
+    if (last.length > 0)
+        parts.push(last);
+    return parts;
+}
 /**
  * Extract custom font family names from a CSS `font` shorthand (e.g. `600 14px Inter`).
- * Drops generic fallbacks like `sans-serif`. Best-effort parsing for common patterns.
+ * Drops generic fallbacks like `sans-serif`, CSS-wide keywords (`inherit`, `initial`, …), and
+ * system font keywords (`caption`, `menu`, …).
+ * Repeated custom names in the same list collapse
+ * to the first spelling (comparison is case-insensitive, e.g. `Inter, inter` → one entry).
+ * Best-effort parsing for common patterns.
+ * Commas inside quoted family names are ignored; `\\` escapes the next character inside quotes (e.g. `\"` for a literal `"`).
+ * Recognizes common font-size units (px, em, rem, cap/ic/lh/rlh, root-relative r* units, pt, %, viewport, viewport inline/block (`vi`/`vb` and `d*`/`s*`/`l*` variants), dynamic-viewport, container query, Q, and math units), including scientific notation on the numeric part (e.g. `1e2px`).
+ * CSS math functions `calc()`, `min()`, `max()`, and `clamp()` are treated as a single font-size token (balanced parentheses; commas inside are allowed).
+ * When a percentage is used as `font-stretch` before the real font size (e.g. `75% 14px Inter`),
+ * skips that leading dimension so the size + family tail is parsed correctly.
+ * Very long chains of leading size tokens are peeled with a bounded primary budget, then a secondary pass on modest remainders.
+ * If an oversized tail still looks like stacked size tokens, returns [] rather than inventing a family name or doing pathological work.
+ * Line-height after `/` may be numeric (with optional unit) or the `normal` keyword; a slash line-height
+ * with no following family list yields no families (e.g. `14px / normal` alone).
+ * Leading relative size keywords `smaller` and `larger` (CSS Fonts) are stripped so
+ * values like `smaller Inter, serif` resolve to concrete families for {@link waitForFonts}.
+ * Leading absolute size keywords (`medium`, `xx-small`, `large`, …) are stripped the same way.
+ * A comma-list segment that is exactly an absolute size keyword is dropped when unquoted; the same word
+ * inside quotes is kept (CSS requires quoting when a family name matches a keyword).
+ * Unquoted `url(...)` and `format(...)` segments (e.g. mistaken `@font-face` `src` paste) are not
+ * concrete family names and are skipped so {@link waitForFonts} does not call `load` with them.
+ * The same spellings inside quotes are kept as literal family names (CSS `font-family` rules).
  */
 export function extractFontFamiliesFromCSSFont(font) {
-    const trimmed = font.trim();
-    const m = trimmed.match(/\b(\d+(?:\.\d+)?(?:px|em|rem))(?:\/\s*[\d.]+(?:px|em|rem)?)?\s+(.+)$/i);
-    const tail = m ? m[2] : trimmed;
-    return tail
-        .split(',')
-        .map(s => s.trim().replace(/^["']|["']$/g, ''))
-        .filter(f => f.length > 0 && !GENERIC_FAMILIES.has(f.toLowerCase()));
+    function filterFamilies(tail) {
+        const out = [];
+        const seen = new Set();
+        for (const seg of splitFontFamilyList(tail)) {
+            const t = seg.trim();
+            if (t.length === 0)
+                continue;
+            const doubleQuoted = t.length >= 2 && t.startsWith('"') && t.endsWith('"');
+            const singleQuoted = t.length >= 2 && t.startsWith("'") && t.endsWith("'");
+            const quoted = doubleQuoted || singleQuoted;
+            const inner = t.replace(/^["']|["']$/g, '');
+            if (inner.length === 0)
+                continue;
+            const lead = inner.trimStart();
+            if (!quoted && /^url\s*\(/i.test(lead))
+                continue;
+            if (!quoted && /^format\s*\(/i.test(lead))
+                continue;
+            if (!quoted && ABSOLUTE_FONT_SIZE_KEYWORDS.has(inner.toLowerCase()))
+                continue;
+            if (GENERIC_FAMILIES.has(inner.toLowerCase()) ||
+                CSS_WIDE_FONT_KEYWORDS.has(inner.toLowerCase()) ||
+                SYSTEM_FONT_KEYWORDS.has(inner.toLowerCase()) ||
+                FONT_SIZE_ONLY.test(inner)) {
+                continue;
+            }
+            const key = inner.toLowerCase();
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push(inner);
+        }
+        return out;
+    }
+    function firstFamilyListSegment(tail) {
+        return splitFontFamilyList(tail)[0]?.trim() ?? '';
+    }
+    /** True when the family tail still begins with another size token (dimension, stacked shorthand, or CSS math size). */
+    function tailLeadsWithStackedSize(tail) {
+        const first = firstFamilyListSegment(tail);
+        return (FONT_SIZE_ONLY.test(first) ||
+            TAIL_LEADS_WITH_SIZE_TOKEN.test(tail) ||
+            /^(calc|min|max|clamp)\s*\(/i.test(first));
+    }
+    const MATH_SIZE_OPEN = /\b(calc|min|max|clamp)\s*\(/gi;
+    function tryPeelMathSlashLine(s) {
+        const re = new RegExp(MATH_SIZE_OPEN.source, 'gi');
+        let ma;
+        while ((ma = re.exec(s)) !== null) {
+            const openIdx = ma.index + ma[0].length - 1;
+            const afterClose = indexAfterMatchingParen(s, openIdx);
+            if (afterClose === null)
+                continue;
+            const restRaw = s.slice(afterClose);
+            if (!/^\s*\//.test(restRaw))
+                continue;
+            const slashRestMatch = restRaw.match(new RegExp(String.raw `^\s*\/\s*(?:` + FONT_SIZE_NUMBER + FONT_SIZE_UNIT + String.raw `?|normal)\s*(.*)$`, 'i'));
+            if (!slashRestMatch)
+                continue;
+            const tail = slashRestMatch[1] ?? '';
+            if (tailLeadsWithStackedSize(tail)) {
+                return { kind: 'peeled', next: s.slice(afterClose).trimStart() };
+            }
+            if (tail.trim().length === 0)
+                continue;
+            return { kind: 'family', tail: tail.trimStart() };
+        }
+        return null;
+    }
+    function tryPeelMathFamily(s) {
+        const re = new RegExp(MATH_SIZE_OPEN.source, 'gi');
+        let ma;
+        while ((ma = re.exec(s)) !== null) {
+            const openIdx = ma.index + ma[0].length - 1;
+            const afterClose = indexAfterMatchingParen(s, openIdx);
+            if (afterClose === null)
+                continue;
+            const restRaw = s.slice(afterClose);
+            if (/^\s*\//.test(restRaw))
+                continue;
+            const famM = restRaw.match(/^\s+(.+)$/);
+            if (!famM)
+                continue;
+            const tail = famM[1];
+            if (tailLeadsWithStackedSize(tail)) {
+                return { kind: 'peeled', next: s.slice(afterClose).trimStart() };
+            }
+            return { kind: 'family', tail };
+        }
+        return null;
+    }
+    function peelFontShorthand(s) {
+        const slashM = s.match(FONT_SHORTHAND_SLASH_LINE_TAIL);
+        if (slashM) {
+            const tail = slashM[2] ?? '';
+            if (!tailLeadsWithStackedSize(tail))
+                return { kind: 'family', tail };
+            const matchIndex = slashM.index ?? 0;
+            return { kind: 'peeled', next: s.slice(matchIndex + slashM[1].length).trimStart() };
+        }
+        const mathSlash = tryPeelMathSlashLine(s);
+        if (mathSlash)
+            return mathSlash;
+        // Before numeric size + family: math sizes can contain dimension tokens (e.g. `14px` inside
+        // `calc(14px + 1vmin)`) that would otherwise match {@link FONT_SHORTHAND_FAMILY_TAIL} early.
+        const mathFam = tryPeelMathFamily(s);
+        if (mathFam)
+            return mathFam;
+        const m = s.match(FONT_SHORTHAND_FAMILY_TAIL);
+        if (m) {
+            const tail = m[2];
+            if (!tailLeadsWithStackedSize(tail))
+                return { kind: 'family', tail };
+            const matchIndex = m.index ?? 0;
+            return { kind: 'peeled', next: s.slice(matchIndex + m[1].length).trimStart() };
+        }
+        return { kind: 'none' };
+    }
+    let trimmed = font.trim();
+    for (let p = 0; p < MAX_RELATIVE_SIZE_PREFIX_STRIPS; p++) {
+        const withoutRel = trimmed.replace(/^(smaller|larger)\s+/i, '');
+        if (withoutRel === trimmed)
+            break;
+        trimmed = withoutRel;
+    }
+    for (let p = 0; p < MAX_ABSOLUTE_SIZE_PREFIX_STRIPS; p++) {
+        const m = trimmed.match(ABSOLUTE_FONT_SIZE_PREFIX);
+        if (!m)
+            break;
+        trimmed = trimmed.slice(m[0].length).trimStart();
+    }
+    for (let i = 0; i < MAX_SHORTHAND_STRIP_ITERATIONS; i++) {
+        const r = peelFontShorthand(trimmed);
+        if (r.kind === 'none')
+            break;
+        if (r.kind === 'family')
+            return filterFamilies(r.tail);
+        trimmed = r.next;
+    }
+    if (trimmed.length > MAX_REMAINDER_AFTER_PRIMARY_STRIP) {
+        const r = peelFontShorthand(trimmed);
+        if (r.kind === 'peeled')
+            return [];
+    }
+    for (let i = 0; i < EXTRA_SHORTHAND_STRIP_ITERATIONS; i++) {
+        const r = peelFontShorthand(trimmed);
+        if (r.kind === 'none')
+            break;
+        if (r.kind === 'family')
+            return filterFamilies(r.tail);
+        trimmed = r.next;
+    }
+    const last = peelFontShorthand(trimmed);
+    if (last.kind === 'family')
+        return filterFamilies(last.tail);
+    if (last.kind === 'peeled')
+        return [];
+    return filterFamilies(trimmed);
 }
-/** Collect unique font families referenced by text nodes in a UI tree. */
+/**
+ * Collect unique font families referenced by text nodes in a UI tree.
+ * Order is first-seen in a depth-first preorder walk (later duplicates are skipped).
+ */
 export function collectFontFamiliesFromTree(root) {
     const out = new Set();
     function walk(el) {
@@ -40,9 +349,20 @@ export function collectFontFamiliesFromTree(root) {
     walk(root);
     return [...out];
 }
+/**
+ * Resolve a font-load timeout in milliseconds. Used by {@link waitForFonts} and `createApp`'s
+ * `fontLoadTimeoutMs` so `NaN`, `±Infinity`, negative values, and non-numbers all fall back to
+ * `defaultMs` (avoids `??` missing `NaN` and odd `setTimeout` coercion).
+ */
+export function resolveFontLoadTimeoutMs(timeoutMs, defaultMs = 10_000) {
+    return typeof timeoutMs === 'number' && Number.isFinite(timeoutMs) && timeoutMs >= 0 ? timeoutMs : defaultMs;
+}
 /**
  * Wait for web fonts used by the app. Browser only; no-op on server.
  * Uses `document.fonts.load` per family; timeouts are swallowed so startup never hard-fails.
+ * Empty and whitespace-only family strings are ignored; names are trimmed before load and deduped.
+ * `timeoutMs` must be a finite non-negative number; otherwise the default `10_000` is used (avoids
+ * relying on `setTimeout` coercion for `NaN`, `±Infinity`, or negative values).
  */
 export async function waitForFonts(families, timeoutMs = 10_000) {
     if (typeof document === 'undefined' || families.length === 0)
@@ -50,13 +370,16 @@ export async function waitForFonts(families, timeoutMs = 10_000) {
     const api = document.fonts;
     if (!api?.load)
         return;
-    const unique = [...new Set(families)];
-    const work = Promise.all(unique.map(f => api.load(`16px ${f}`).catch(() => undefined))).then(() => api.ready);
+    const unique = [...new Set(families.map(f => f.trim()).filter(f => f.length > 0))];
+    if (unique.length === 0)
+        return;
+    const safeTimeoutMs = resolveFontLoadTimeoutMs(timeoutMs, 10_000);
+    const work = Promise.all(unique.map(f => api.load(`16px ${f}`).catch(() => undefined))).then(() => Promise.resolve(api.ready).catch(() => undefined));
     try {
         await Promise.race([
             work,
             new Promise((_, reject) => {
-                setTimeout(() => reject(new Error('Font load timeout')), timeoutMs);
+                setTimeout(() => reject(new Error('Font load timeout')), safeTimeoutMs);
             }),
         ]);
     }

package/dist/fonts.js.map

@@ -1 +1 @@
-{"version":3,"file":"fonts.js","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,OAAO;IACP,YAAY;IACZ,WAAW;IACX,SAAS;IACT,SAAS;IACT,WAAW;IACX,eAAe;IACf,UAAU;IACV,cAAc;IACd,OAAO;CACR,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,IAAY;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,uEAAuE,CAAC,CAAA;IAChG,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,OAAO,CAAA;IAChC,OAAO,IAAI;SACR,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;SAC9C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;AACxE,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,2BAA2B,CAAC,IAAe;IACzD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAA;IAC7B,SAAS,IAAI,CAAC,EAAa;QACzB,IAAI,EAAE,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,IAAI,8BAA8B,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9D,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YACZ,CAAC;QACH,CAAC;aAAM,IAAI,EAAE,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ;gBAAE,IAAI,CAAC,CAAC,CAAC,CAAA;QACtC,CAAC;IACH,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,CAAA;IACV,OAAO,CAAC,GAAG,GAAG,CAAC,CAAA;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAkB,EAAE,SAAS,GAAG,MAAM;IACvE,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IACpE,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAA;IAC1B,IAAI,CAAC,GAAG,EAAE,IAAI;QAAE,OAAM;IAEtB,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAChG,GAAG,CAAC,KAAK,CACV,CAAA;IAED,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,IAAI;YACJ,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBAC9B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;YACrE,CAAC,CAAC;SACH,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"fonts.js","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"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"}

package/dist/hit-test.d.ts

@@ -1,18 +1,49 @@
 import type { ComputedLayout } from 'textura';
 import type { UIElement, BoxElement, EventHandlers } from './types.js';
-/** Result of routing a pointer/keyboard-style hit to handlers. */
+/**
+ * Result of routing a hit to {@link EventHandlers} on the deepest matching target.
+ * `focusTarget` is only populated for `onClick` (see {@link dispatchHit}).
+ */
 export interface HitDispatchResult {
     handled: boolean;
-    /** Set when a focusable box handled `onClick` (for keyboard focus). */
+    /**
+     * Present only when `dispatchHit` was called with `'onClick'`: the deepest focusable box under the point
+     * (`onClick`, `onKeyDown` / `onKeyUp`, or composition handlers). Set after a successful
+     * `onClick` handler **or** via click-to-focus when the box has no `onClick` but should
+     * still receive keyboard/composition input (`handled` may be `false`). Omitted for all
+     * other event types.
+     */
     focusTarget?: {
         element: BoxElement;
         layout: ComputedLayout;
     };
 }
-/** Dispatch an event at (x, y) against the element tree. Returns true if any handler fired. */
+/**
+ * Dispatch a hit at `(x, y)` against the element tree for the given handler key
+ * (e.g. `onClick`, `onPointerDown`, `onKeyDown`, composition events).
+ * The deepest hit with a matching handler runs first; only one handler runs per call.
+ * Optional `extra` is shallow-merged onto the `HitEvent` after base fields so callers
+ * can pass modifier keys, `button`, wheel deltas, and other renderer-specific metadata.
+ * For `onClick` only, the return value may include `focusTarget` for focus routing
+ * (including click-to-focus when there is no `onClick` handler).
+ * Layout bounds must be finite and non-negative on `width` and `height`; otherwise the node is
+ * skipped for hit-testing (corrupt geometry from Yoga or a bad snapshot).
+ */
 export declare function dispatchHit(element: UIElement, layout: ComputedLayout, eventType: keyof EventHandlers, x: number, y: number, extra?: Record<string, unknown>): HitDispatchResult;
-/** True when point is over an interactive element (click/key/composition handlers). */
+/**
+ * True when the point is over an element that participates in pointer hit-testing
+ * (`onClick`, `onPointerDown` / `Up` / `Move`, `onWheel`). Keyboard and composition
+ * handlers alone do not count — use this for hover / pointer-capture style checks.
+ */
 export declare function hasInteractiveHitAtPoint(element: UIElement, layout: ComputedLayout, x: number, y: number): boolean;
+/**
+ * Child indices from root to the deepest box under (x, y). Among overlapping siblings, prefers higher z-index (topmost);
+ * non-finite or non-number `zIndex` values match `dispatchHit` / paint order (treated as `0`).
+ * Boxes with `pointerEvents: 'none'` do not terminate the path when they have no deeper hit (same idea as `getCursorAtPoint` and `collectHits`).
+ * Returns `null` when the point misses the tree. Returns `[]` when the point hits the
+ * root (or a leaf box) with no deeper box hit.
+ */
+export declare function hitPathAtPoint(element: UIElement, layout: ComputedLayout, x: number, y: number, offsetX?: number, offsetY?: number): number[] | null;
 /** Get the cursor style at a given point by walking the tree. Returns the deepest element's cursor prop. */
 export declare function getCursorAtPoint(element: UIElement, layout: ComputedLayout, x: number, y: number, offsetX?: number, offsetY?: number): string | null;
 //# sourceMappingURL=hit-test.d.ts.map

package/dist/hit-test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hit-test.d.ts","sourceRoot":"","sources":["../src/hit-test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAY,MAAM,YAAY,CAAA;AAgChF,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,uEAAuE;IACvE,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,CAAA;CAC9D;AAqDD,+FAA+F;AAC/F,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,aAAa,EAC9B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,iBAAiB,CAoDnB;AAED,uFAAuF;AACvF,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,OAAO,CAiBT;AAED,4GAA4G;AAC5G,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,SAAI,EACX,OAAO,SAAI,GACV,MAAM,GAAG,IAAI,CA+Bf"}
+{"version":3,"file":"hit-test.d.ts","sourceRoot":"","sources":["../src/hit-test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAY,MAAM,YAAY,CAAA;AA2EhF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,CAAA;CAC9D;AAmJD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,aAAa,EAC9B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,iBAAiB,CAEnB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,OAAO,CAgBT;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,SAAI,EACX,OAAO,SAAI,GACV,MAAM,EAAE,GAAG,IAAI,CA0CjB;AAED,4GAA4G;AAC5G,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,cAAc,EACtB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,SAAI,EACX,OAAO,SAAI,GACV,MAAM,GAAG,IAAI,CAoCf"}