@vyaz/core 0.0.9 → 0.0.11

package/dist/measure/FontMetricsProvider.d.ts

@@ -2,47 +2,69 @@
  * FontMetricsProvider.ts — isomorphic font metrics provider.
  *
  * Strategy (priority):
- *   1. FontEngine (fontkit) — from registered buffer
- *      - 'browser' mode: hhea.ascender / hhea.descender
- *      - 'office'  mode: OS/2.usWinAscent / OS/2.usWinDescent
+ *   1. FontEngine (fontkit) — from registered buffer, with smart weight fallback
  *   2. Canvas TextMetrics (browser fallback when fontkit unavailable)
  *
- * Uses FontEngine as the single entry point for all fontkit operations.
+ * Key features:
+ *   - Nested registry: family → variants (weight + style)
+ *   - Smart weight fallback: if exact weight not found, picks closest
+ *   - Style fallback: if exact style not found, falls back to 'normal'
+ *   - Tracks pending registrations to warn about race conditions
+ *   - Reusable off-screen canvas for Canvas TextMetrics fallback
  */
 import type { FontMetrics, IFontMetricsProvider } from '../types/FontTypes.js';
 import type { FontFace } from './FontEngine.js';
 /**
  * Factor used when a glyph is not found in the font.
  * Multiplied by fontSize to estimate the missing glyph width.
- * Used across all measurement code paths (ParagraphLayoutEngine, canvas-polyfill).
  */
 export declare const MISSING_GLYPH_FACTOR = 0.5;
 export declare class FontMetricsProvider implements IFontMetricsProvider {
-    /** Map<string, FontFace> — font engine font face cache */
-    private cache;
+    /**
+     * Nested registry: family → variantKey → FontFace.
+     * Example:
+     *   "Roboto" → { "400_normal": FontFace, "700_normal": FontFace, "400_italic": FontFace }
+     */
+    private registry;
+    /** Metrics cache keyed by variantKey_fontSize_mode */
     private metricsCache;
     private mode;
+    private pendingRegistrations;
+    private _measureCanvas;
+    private _measureCtx;
+    private _getMeasureContext;
     setMode(mode: 'browser' | 'office'): void;
     getMode(): 'browser' | 'office';
     /**
-     * Register a binary font for use with fontkit.
-     *
-     * In both Node.js and browser the font is loaded via FontEngine.
-     * In the browser the caller must provide font bytes (e.g. fetched via
-     * `getFontBuffer()` from `../utils/font.js`).
-     *
-     * @param source      Font file bytes (ArrayBuffer / Uint8Array), or a URL string
-     * @param sourcePath  Optional filesystem path (used for @napi-rs/canvas in Node.js)
+     * Flatten the nested registry into a single map for office mode.
+     * Office mode needs key → FontFace lookup by family_weight_style.
      */
+    private _flattenCache;
     registerFont(family: string, options: {
         weight?: string;
         style?: string;
     }, source: string | ArrayBuffer | Uint8Array, sourcePath?: string): Promise<void>;
+    private _registerFontInternal;
+    waitForPendingRegistrations(): Promise<void>;
+    /**
+     * List all families registered in the provider.
+     */
+    getRegisteredFamilies(): string[];
     /**
-     * Get font engine FontFace object for per-character calculations.
-     * Returns undefined if font is not registered.
+     * Get all variant keys registered for a given family.
+     * Returns empty array if family not found.
+     */
+    getFamilyVariants(family: string): string[];
+    /**
+     * Get font engine FontFace for per-character calculations.
+     * Uses the same smart fallback logic as getMetrics().
      */
     getFont(family: string, weight?: string, style?: string): FontFace | undefined;
+    /**
+     * Resolve a font request with fallback.
+     * Returns { font, resolvedWeight, resolvedStyle } or null.
+     */
+    private _resolveFont;
     getMetrics(fontFamily: string, fontSize: number, weight?: string, style?: string): FontMetrics;
 }
 /** Singleton */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vyaz/core",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",