@glassly/miniapp 0.3.0-dev.2 → 0.3.0-dev.462

package/dist/background/register.js

@@ -1,7 +1,7 @@
 /**
  * registerMiniapp — entry hook for the background JSContext.
  *
- * The GlasslyJS host loads the polyfill (which installs __dispatch /
+ * The JSRuntime host loads the polyfill (which installs __dispatch /
  * __deliver / timers / fetch / etc.), then evaluates the miniapp's
  * background bundle. After both scripts have evaluated successfully,
  * the host delivers a single `{kind: "init", sessionId}` envelope.

package/dist/display/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @glassly/miniapp/display — the phone-side text and scene primitives a
+ * miniapp needs to lay out a frame the way the host measures it: the glasses'
+ * display profiles (glyph widths, line heights), pixel-accurate measurement
+ * and wrapping, pixel-art icons as scene images, and the scene element types
+ * the host's render pipeline consumes. Pure TypeScript with no host imports;
+ * the engine's scene pipeline (`processScene`) uses these same modules, so a
+ * miniapp that wraps text with them gets the rows the glasses will draw.
+ */
+export type { DisplayProfile, FontMetrics, UniformScriptWidths, FallbackConfig, DisplayConstraints, ScriptType, } from "./profiles";
+export { G1_PROFILE, G1_PROFILE_LEGACY, G1_HYPHEN_WIDTH_PX, G1_SPACE_WIDTH_PX, G2_PROFILE, G2_HYPHEN_WIDTH_PX, G2_SPACE_WIDTH_PX, Z100_PROFILE, Z100_HYPHEN_WIDTH_PX, Z100_SPACE_WIDTH_PX, NEX_PROFILE, NEX_HYPHEN_WIDTH_PX, NEX_SPACE_WIDTH_PX, } from "./profiles";
+export { TextMeasurer } from "./measurer";
+export type { CharMeasurement, TextMeasurement } from "./measurer";
+export { detectScript, isCJKCharacter, isKoreanCharacter, isUniformWidthScript, isUnsupportedScript, needsHyphenForBreak, SCRIPT_RANGES, } from "./measurer";
+export { TextWrapper, DEFAULT_WRAP_OPTIONS } from "./wrapper";
+export type { WrapOptions, WrapResult, LineMetrics, BreakMode } from "./wrapper";
+export { pixelArtElement, pixelArtPng, pixelArtSize, pixelLevel } from "./pixelArt";
+export type { PixelArt } from "./pixelArt";
+export type { FrameElement, SceneAnchor, SceneBox, SceneBoxInput, SceneBreakMode, SceneChange, SceneDisplayCapabilities, SceneElementInput, SceneElementType, SceneFrame, SceneImageStyle, ScenePoint, SceneProcessResult, SceneRectStyle, SceneShapeStyle, SceneStrokeStyle, SceneTextStyle, SceneTransition, } from "./scene/types";
+export { boxesEqual, contentHash, elementContentHash, MAX_SCENE_DEPTH, POINT_SHAPE_ARITY, POINT_SHAPE_TYPES, } from "./scene/types";
+export { SHAPE_TYPES, sceneGeometry, geometryEqual, tweenAt, levelOpacity } from "../mirror/geometry";
+export type { MirrorSceneElement, SceneGeometry } from "../mirror/geometry";
+//# sourceMappingURL=index.d.ts.map

package/dist/display/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/display/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,UAAU,GACX,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAC,YAAY,EAAC,MAAM,YAAY,CAAA;AACvC,YAAY,EAAC,eAAe,EAAE,eAAe,EAAC,MAAM,YAAY,CAAA;AAChE,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAC,WAAW,EAAE,oBAAoB,EAAC,MAAM,WAAW,CAAA;AAC3D,YAAY,EAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAC,MAAM,WAAW,CAAA;AAE9E,OAAO,EAAC,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAC,MAAM,YAAY,CAAA;AACjF,YAAY,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAA;AAExC,YAAY,EACV,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,aAAa,EACb,cAAc,EACd,WAAW,EACX,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAC,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAA;AACnG,YAAY,EAAC,kBAAkB,EAAE,aAAa,EAAC,MAAM,oBAAoB,CAAA"}

package/dist/display/index.js

@@ -0,0 +1,17 @@
+/**
+ * @glassly/miniapp/display — the phone-side text and scene primitives a
+ * miniapp needs to lay out a frame the way the host measures it: the glasses'
+ * display profiles (glyph widths, line heights), pixel-accurate measurement
+ * and wrapping, pixel-art icons as scene images, and the scene element types
+ * the host's render pipeline consumes. Pure TypeScript with no host imports;
+ * the engine's scene pipeline (`processScene`) uses these same modules, so a
+ * miniapp that wraps text with them gets the rows the glasses will draw.
+ */
+export { G1_PROFILE, G1_PROFILE_LEGACY, G1_HYPHEN_WIDTH_PX, G1_SPACE_WIDTH_PX, G2_PROFILE, G2_HYPHEN_WIDTH_PX, G2_SPACE_WIDTH_PX, Z100_PROFILE, Z100_HYPHEN_WIDTH_PX, Z100_SPACE_WIDTH_PX, NEX_PROFILE, NEX_HYPHEN_WIDTH_PX, NEX_SPACE_WIDTH_PX, } from "./profiles";
+export { TextMeasurer } from "./measurer";
+export { detectScript, isCJKCharacter, isKoreanCharacter, isUniformWidthScript, isUnsupportedScript, needsHyphenForBreak, SCRIPT_RANGES, } from "./measurer";
+export { TextWrapper, DEFAULT_WRAP_OPTIONS } from "./wrapper";
+export { pixelArtElement, pixelArtPng, pixelArtSize, pixelLevel } from "./pixelArt";
+export { boxesEqual, contentHash, elementContentHash, MAX_SCENE_DEPTH, POINT_SHAPE_ARITY, POINT_SHAPE_TYPES, } from "./scene/types";
+export { SHAPE_TYPES, sceneGeometry, geometryEqual, tweenAt, levelOpacity } from "../mirror/geometry";
+//# sourceMappingURL=index.js.map

package/dist/display/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/display/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAC,YAAY,EAAC,MAAM,YAAY,CAAA;AAEvC,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,GACd,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAC,WAAW,EAAE,oBAAoB,EAAC,MAAM,WAAW,CAAA;AAG3D,OAAO,EAAC,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAC,MAAM,YAAY,CAAA;AAuBjF,OAAO,EACL,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAC,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAA"}

package/dist/display/measurer/TextMeasurer.d.ts

@@ -0,0 +1,160 @@
+import type { DisplayProfile, ScriptType } from "../profiles/types";
+/**
+ * Character measurement result with detailed breakdown.
+ */
+export interface CharMeasurement {
+    /** The character measured */
+    char: string;
+    /** Width in rendered pixels */
+    widthPx: number;
+    /** The script type of the character */
+    script: ScriptType;
+    /** Whether width came from glyph map (true) or fallback (false) */
+    fromGlyphMap: boolean;
+}
+/**
+ * Text measurement result with detailed breakdown.
+ */
+export interface TextMeasurement {
+    /** The text measured */
+    text: string;
+    /** Total width in rendered pixels */
+    totalWidthPx: number;
+    /** Number of characters */
+    charCount: number;
+    /** Per-character measurements (optional, for debugging) */
+    chars?: CharMeasurement[];
+}
+/**
+ * Measures text width in pixels based on a DisplayProfile.
+ * All measurements are in actual rendered pixels, not abstract units.
+ *
+ * Key features:
+ * - Pixel-perfect measurement for mapped characters
+ * - Uniform-width handling for CJK, Korean, Cyrillic
+ * - Safe fallback for unmapped Latin characters
+ * - Caching for performance
+ */
+export declare class TextMeasurer {
+    private readonly profile;
+    private readonly charCache;
+    constructor(profile: DisplayProfile);
+    /**
+     * Pre-compute rendered widths for all known glyphs.
+     */
+    private buildCharCache;
+    /**
+     * Measure the total pixel width of a text string.
+     *
+     * @param text - The text to measure
+     * @returns Width in rendered pixels
+     */
+    measureText(text: string): number;
+    /**
+     * Measure text with detailed breakdown of each character.
+     *
+     * @param text - The text to measure
+     * @returns Detailed measurement result
+     */
+    measureTextDetailed(text: string): TextMeasurement;
+    /**
+     * Measure a single character's pixel width.
+     *
+     * IMPORTANT: This is PIXEL-PERFECT measurement, not averaging!
+     * - Mapped characters: exact width from glyph map
+     * - Uniform scripts (CJK, Korean, Cyrillic): verified uniform width
+     * - Unmapped Latin: MAX width fallback (safe, never overflow)
+     *
+     * @param char - Single character to measure
+     * @returns Width in rendered pixels
+     */
+    measureChar(char: string): number;
+    /**
+     * Calculate character width (called when not in cache).
+     */
+    private calculateCharWidth;
+    /**
+     * Get the raw glyph width (before render formula).
+     * Returns undefined for unmapped characters.
+     *
+     * @param char - Single character
+     * @returns Glyph width in pixels, or undefined if not in glyph map
+     */
+    getGlyphWidth(char: string): number | undefined;
+    /**
+     * Check if text fits within a pixel width.
+     *
+     * @param text - Text to check
+     * @param maxWidthPx - Maximum width in pixels
+     * @returns true if text fits
+     */
+    fitsInWidth(text: string, maxWidthPx: number): boolean;
+    /**
+     * Find how many characters fit within a pixel width.
+     *
+     * @param text - Text to measure
+     * @param maxWidthPx - Maximum width in pixels
+     * @param startIndex - Starting index (default: 0)
+     * @returns Number of characters that fit
+     */
+    charsThatFit(text: string, maxWidthPx: number, startIndex?: number): number;
+    /**
+     * Find the pixel position of a character index in text.
+     *
+     * @param text - Text to measure
+     * @param index - Character index
+     * @returns Pixel offset from start of text
+     */
+    getPixelOffset(text: string, index: number): number;
+    /**
+     * Detect the script type of a character.
+     *
+     * @param char - Single character
+     * @returns Script type
+     */
+    detectScript(char: string): ScriptType;
+    /**
+     * Check if a character is from a uniform-width script.
+     *
+     * @param char - Single character
+     * @returns true if character is from CJK, Korean, or Cyrillic
+     */
+    isUniformWidth(char: string): boolean;
+    /**
+     * Get the display profile.
+     */
+    getProfile(): DisplayProfile;
+    /**
+     * Get the display width in pixels.
+     */
+    getDisplayWidthPx(): number;
+    /**
+     * Get the maximum number of lines.
+     */
+    getMaxLines(): number;
+    /**
+     * Get the maximum payload size in bytes.
+     */
+    getMaxPayloadBytes(): number;
+    /**
+     * Calculate the UTF-8 byte size of text.
+     *
+     * @param text - Text to measure
+     * @returns Byte size
+     */
+    getByteSize(text: string): number;
+    /**
+     * Get the width of a hyphen character in rendered pixels.
+     */
+    getHyphenWidth(): number;
+    /**
+     * Get the width of a space character in rendered pixels.
+     */
+    getSpaceWidth(): number;
+    /**
+     * Clear the character cache.
+     * Useful if profile metrics change at runtime.
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=TextMeasurer.d.ts.map

package/dist/display/measurer/TextMeasurer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextMeasurer.d.ts","sourceRoot":"","sources":["../../../src/display/measurer/TextMeasurer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAE,UAAU,EAAC,MAAM,mBAAmB,CAAA;AAGjE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,uCAAuC;IACvC,MAAM,EAAE,UAAU,CAAA;IAClB,mEAAmE;IACnE,YAAY,EAAE,OAAO,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;CAC1B;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;gBAE/C,OAAO,EAAE,cAAc;IAMnC;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAYjC;;;;;OAKG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAoClD;;;;;;;;;;OAUG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAoBjC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+B1B;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAItD;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAE,MAAU,GAAG,MAAM;IAyB9E;;;;;;OAMG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAenD;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAItC;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;OAEG;IACH,UAAU,IAAI,cAAc;IAI5B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIjC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,UAAU,IAAI,IAAI;CAInB"}

package/dist/display/measurer/TextMeasurer.js

@@ -0,0 +1,272 @@
+import { detectScript, isUniformWidthScript } from "./script-detection";
+/**
+ * Measures text width in pixels based on a DisplayProfile.
+ * All measurements are in actual rendered pixels, not abstract units.
+ *
+ * Key features:
+ * - Pixel-perfect measurement for mapped characters
+ * - Uniform-width handling for CJK, Korean, Cyrillic
+ * - Safe fallback for unmapped Latin characters
+ * - Caching for performance
+ */
+export class TextMeasurer {
+    constructor(profile) {
+        this.charCache = new Map();
+        this.profile = profile;
+        // Pre-populate cache with known glyphs
+        this.buildCharCache();
+    }
+    /**
+     * Pre-compute rendered widths for all known glyphs.
+     */
+    buildCharCache() {
+        const { glyphWidths, renderFormula } = this.profile.fontMetrics;
+        for (const [char, glyphWidth] of glyphWidths.entries()) {
+            const renderedWidth = renderFormula(glyphWidth);
+            this.charCache.set(char, renderedWidth);
+        }
+    }
+    /**
+     * Measure the total pixel width of a text string.
+     *
+     * @param text - The text to measure
+     * @returns Width in rendered pixels
+     */
+    measureText(text) {
+        if (!text || text.length === 0) {
+            return 0;
+        }
+        let totalWidth = 0;
+        for (const char of text) {
+            totalWidth += this.measureChar(char);
+        }
+        return totalWidth;
+    }
+    /**
+     * Measure text with detailed breakdown of each character.
+     *
+     * @param text - The text to measure
+     * @returns Detailed measurement result
+     */
+    measureTextDetailed(text) {
+        if (!text || text.length === 0) {
+            return {
+                text: "",
+                totalWidthPx: 0,
+                charCount: 0,
+                chars: [],
+            };
+        }
+        const chars = [];
+        let totalWidth = 0;
+        for (const char of text) {
+            const script = detectScript(char);
+            const widthPx = this.measureChar(char);
+            const fromGlyphMap = this.profile.fontMetrics.glyphWidths.has(char);
+            chars.push({
+                char,
+                widthPx,
+                script,
+                fromGlyphMap,
+            });
+            totalWidth += widthPx;
+        }
+        return {
+            text,
+            totalWidthPx: totalWidth,
+            charCount: chars.length,
+            chars,
+        };
+    }
+    /**
+     * Measure a single character's pixel width.
+     *
+     * IMPORTANT: This is PIXEL-PERFECT measurement, not averaging!
+     * - Mapped characters: exact width from glyph map
+     * - Uniform scripts (CJK, Korean, Cyrillic): verified uniform width
+     * - Unmapped Latin: MAX width fallback (safe, never overflow)
+     *
+     * @param char - Single character to measure
+     * @returns Width in rendered pixels
+     */
+    measureChar(char) {
+        if (!char || char.length === 0) {
+            return 0;
+        }
+        // Check cache first (includes pre-computed glyph map entries)
+        const cached = this.charCache.get(char);
+        if (cached !== undefined) {
+            return cached;
+        }
+        // Calculate width based on script type
+        const width = this.calculateCharWidth(char);
+        // Cache for future lookups
+        this.charCache.set(char, width);
+        return width;
+    }
+    /**
+     * Calculate character width (called when not in cache).
+     */
+    calculateCharWidth(char) {
+        const { fontMetrics } = this.profile;
+        const { uniformScripts, fallback, renderFormula, glyphWidths } = fontMetrics;
+        // 1. Check explicit glyph map (pixel-perfect for Latin)
+        const glyphWidth = glyphWidths.get(char);
+        if (glyphWidth !== undefined) {
+            return renderFormula(glyphWidth);
+        }
+        // 2. Uniform-width scripts (verified monospace - NOT averages!)
+        const script = detectScript(char);
+        switch (script) {
+            case "cjk":
+                return uniformScripts.cjk; // ALL CJK chars are exactly this width
+            case "hiragana":
+                return uniformScripts.hiragana; // ALL Hiragana chars are exactly this width
+            case "katakana":
+                return uniformScripts.katakana; // ALL Katakana chars are exactly this width
+            case "korean":
+                return uniformScripts.korean; // ALL Korean chars are exactly this width
+            case "cyrillic":
+                return uniformScripts.cyrillic; // ALL Cyrillic chars are exactly this width
+        }
+        // 3. Unmapped Latin or unknown: use MAX width (safe fallback)
+        // This guarantees we NEVER overflow - worst case is slight under-utilization
+        return fallback.latinMaxWidth;
+    }
+    /**
+     * Get the raw glyph width (before render formula).
+     * Returns undefined for unmapped characters.
+     *
+     * @param char - Single character
+     * @returns Glyph width in pixels, or undefined if not in glyph map
+     */
+    getGlyphWidth(char) {
+        return this.profile.fontMetrics.glyphWidths.get(char);
+    }
+    /**
+     * Check if text fits within a pixel width.
+     *
+     * @param text - Text to check
+     * @param maxWidthPx - Maximum width in pixels
+     * @returns true if text fits
+     */
+    fitsInWidth(text, maxWidthPx) {
+        return this.measureText(text) <= maxWidthPx;
+    }
+    /**
+     * Find how many characters fit within a pixel width.
+     *
+     * @param text - Text to measure
+     * @param maxWidthPx - Maximum width in pixels
+     * @param startIndex - Starting index (default: 0)
+     * @returns Number of characters that fit
+     */
+    charsThatFit(text, maxWidthPx, startIndex = 0) {
+        if (!text || startIndex >= text.length) {
+            return 0;
+        }
+        let currentWidth = 0;
+        let count = 0;
+        // Use Array.from to handle surrogate pairs correctly
+        const chars = Array.from(text).slice(startIndex);
+        for (const char of chars) {
+            const charWidth = this.measureChar(char);
+            if (currentWidth + charWidth > maxWidthPx) {
+                break;
+            }
+            currentWidth += charWidth;
+            count++;
+        }
+        return count;
+    }
+    /**
+     * Find the pixel position of a character index in text.
+     *
+     * @param text - Text to measure
+     * @param index - Character index
+     * @returns Pixel offset from start of text
+     */
+    getPixelOffset(text, index) {
+        if (!text || index <= 0) {
+            return 0;
+        }
+        const chars = Array.from(text).slice(0, index);
+        let offset = 0;
+        for (const char of chars) {
+            offset += this.measureChar(char);
+        }
+        return offset;
+    }
+    /**
+     * Detect the script type of a character.
+     *
+     * @param char - Single character
+     * @returns Script type
+     */
+    detectScript(char) {
+        return detectScript(char);
+    }
+    /**
+     * Check if a character is from a uniform-width script.
+     *
+     * @param char - Single character
+     * @returns true if character is from CJK, Korean, or Cyrillic
+     */
+    isUniformWidth(char) {
+        return isUniformWidthScript(char);
+    }
+    /**
+     * Get the display profile.
+     */
+    getProfile() {
+        return this.profile;
+    }
+    /**
+     * Get the display width in pixels.
+     */
+    getDisplayWidthPx() {
+        return this.profile.displayWidthPx;
+    }
+    /**
+     * Get the maximum number of lines.
+     */
+    getMaxLines() {
+        return this.profile.maxLines;
+    }
+    /**
+     * Get the maximum payload size in bytes.
+     */
+    getMaxPayloadBytes() {
+        return this.profile.maxPayloadBytes;
+    }
+    /**
+     * Calculate the UTF-8 byte size of text.
+     *
+     * @param text - Text to measure
+     * @returns Byte size
+     */
+    getByteSize(text) {
+        return new TextEncoder().encode(text).length;
+    }
+    /**
+     * Get the width of a hyphen character in rendered pixels.
+     */
+    getHyphenWidth() {
+        return this.measureChar("-");
+    }
+    /**
+     * Get the width of a space character in rendered pixels.
+     */
+    getSpaceWidth() {
+        return this.measureChar(" ");
+    }
+    /**
+     * Clear the character cache.
+     * Useful if profile metrics change at runtime.
+     */
+    clearCache() {
+        this.charCache.clear();
+        this.buildCharCache();
+    }
+}
+//# sourceMappingURL=TextMeasurer.js.map

package/dist/display/measurer/TextMeasurer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextMeasurer.js","sourceRoot":"","sources":["../../../src/display/measurer/TextMeasurer.ts"],"names":[],"mappings":"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"}

package/dist/display/measurer/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Text Measurer Module
+ *
+ * Provides pixel-accurate text measurement based on display profiles.
+ * All measurements are in actual rendered pixels, not abstract units.
+ */
+export { TextMeasurer } from "./TextMeasurer";
+export type { CharMeasurement, TextMeasurement } from "./TextMeasurer";
+export { detectScript, isCJKCharacter, isKoreanCharacter, isUniformWidthScript, isUnsupportedScript, needsHyphenForBreak, SCRIPT_RANGES, } from "./script-detection";
+//# sourceMappingURL=index.d.ts.map

package/dist/display/measurer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/display/measurer/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAC3C,YAAY,EAAC,eAAe,EAAE,eAAe,EAAC,MAAM,gBAAgB,CAAA;AAGpE,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,GACd,MAAM,oBAAoB,CAAA"}

package/dist/display/measurer/index.js

@@ -0,0 +1,11 @@
+/**
+ * Text Measurer Module
+ *
+ * Provides pixel-accurate text measurement based on display profiles.
+ * All measurements are in actual rendered pixels, not abstract units.
+ */
+// Main class
+export { TextMeasurer } from "./TextMeasurer";
+// Script detection utilities
+export { detectScript, isCJKCharacter, isKoreanCharacter, isUniformWidthScript, isUnsupportedScript, needsHyphenForBreak, SCRIPT_RANGES, } from "./script-detection";
+//# sourceMappingURL=index.js.map

package/dist/display/measurer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/display/measurer/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,aAAa;AACb,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAG3C,6BAA6B;AAC7B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,GACd,MAAM,oBAAoB,CAAA"}

package/dist/display/measurer/script-detection.d.ts

@@ -0,0 +1,53 @@
+import type { ScriptType } from "../profiles/types";
+/**
+ * Unicode ranges for script detection.
+ * Used to classify characters for proper width measurement.
+ */
+export declare const SCRIPT_RANGES: {
+    readonly cjk: readonly [readonly [19968, 40959], readonly [13312, 19903], readonly [131072, 173791], readonly [173824, 177983], readonly [177984, 178207], readonly [63744, 64255]];
+    readonly hiragana: readonly [readonly [12352, 12447]];
+    readonly katakana: readonly [readonly [12448, 12543], readonly [12784, 12799]];
+    readonly korean: readonly [readonly [44032, 55215], readonly [4352, 4607], readonly [12592, 12687], readonly [43360, 43391], readonly [55216, 55295]];
+    readonly cyrillic: readonly [readonly [1024, 1279], readonly [1280, 1327]];
+    readonly numbers: readonly [readonly [48, 57]];
+    readonly punctuation: readonly [readonly [32, 47], readonly [58, 64], readonly [91, 96], readonly [123, 126]];
+    readonly arabic: readonly [readonly [1536, 1791]];
+    readonly hebrew: readonly [readonly [1424, 1535]];
+    readonly thai: readonly [readonly [3584, 3711]];
+    readonly emoji: readonly [readonly [128512, 128591], readonly [127744, 128511], readonly [128640, 128767], readonly [127456, 127487], readonly [9728, 9983], readonly [9984, 10175], readonly [65024, 65039], readonly [129280, 129535]];
+};
+/**
+ * Detect the script type of a single character.
+ *
+ * @param char - Single character to classify
+ * @returns The script type of the character
+ */
+export declare function detectScript(char: string): ScriptType;
+/**
+ * Check if a character is a CJK character (Chinese, Japanese Kanji).
+ * CJK characters can break anywhere without needing a hyphen.
+ */
+export declare function isCJKCharacter(char: string): boolean;
+/**
+ * Check if a character is Korean Hangul.
+ */
+export declare function isKoreanCharacter(char: string): boolean;
+/**
+ * Check if a character is from a uniform-width script.
+ * These scripts render all characters at the same width.
+ */
+export declare function isUniformWidthScript(char: string): boolean;
+/**
+ * Check if a character is from an unsupported script.
+ * These characters may not render correctly on the glasses.
+ */
+export declare function isUnsupportedScript(char: string): boolean;
+/**
+ * Check if breaking between two characters requires a hyphen.
+ * Returns false for:
+ * - Breaking after CJK characters (can break anywhere)
+ * - Breaking before or after spaces
+ * - Breaking after punctuation
+ */
+export declare function needsHyphenForBreak(charBefore: string, charAfter: string): boolean;
+//# sourceMappingURL=script-detection.d.ts.map

package/dist/display/measurer/script-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-detection.d.ts","sourceRoot":"","sources":["../../../src/display/measurer/script-detection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAA;AAEjD;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;CA4DhB,CAAA;AAcV;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CA0DrD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK1D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CA6BlF"}