@glassly/engine 0.1.0-dev.0

package/build/utils/display/composer/ColumnComposer.d.ts

@@ -0,0 +1,131 @@
+/**
+ * ColumnComposer
+ *
+ * Handles composition of multi-column layouts like double_text_wall.
+ * This is the single source of truth for column layout logic, replacing
+ * the duplicate implementations in native iOS (G1Text.swift) and
+ * Android (G1Text.kt, G1.java).
+ *
+ * The composer:
+ * 1. Wraps each column's text to its allocated width
+ * 2. Merges columns line-by-line with pixel-precise space padding
+ * 3. Returns a single pre-composed string ready for native to chunk & send
+ *
+ * @see cloud/issues/026-mobile-display-processor for design docs
+ */
+import type { DisplayProfile } from "../profiles/types";
+import type { BreakMode } from "../wrapper/types";
+/**
+ * Configuration for column layout
+ */
+export interface ColumnConfig {
+    /** Width of the left column in pixels */
+    leftColumnWidthPx: number;
+    /** X position where the right column starts in pixels */
+    rightColumnStartPx: number;
+    /** Width of the right column in pixels (calculated from start position) */
+    rightColumnWidthPx: number;
+    /** Maximum number of lines to display */
+    maxLines: number;
+    /** Left margin in spaces (for indentation) */
+    leftMarginSpaces?: number;
+}
+/**
+ * Options for composing double text wall
+ */
+export interface ComposeOptions {
+    /** Break mode for text wrapping */
+    breakMode?: BreakMode;
+    /** Custom column configuration (overrides profile defaults) */
+    columnConfig?: Partial<ColumnConfig>;
+}
+/**
+ * Result of column composition
+ */
+export interface ComposeResult {
+    /** The fully composed text with both columns merged */
+    composedText: string;
+    /** Lines from the left column (for debugging/preview) */
+    leftLines: string[];
+    /** Lines from the right column (for debugging/preview) */
+    rightLines: string[];
+    /** The column configuration that was used */
+    config: ColumnConfig;
+}
+/**
+ * Composes multi-column layouts for smart glasses displays.
+ *
+ * Usage:
+ * ```typescript
+ * const composer = new ColumnComposer(G1_PROFILE)
+ * const result = composer.composeDoubleTextWall("Left content", "Right content")
+ * // result.composedText is ready to send to native SGC
+ * ```
+ */
+export declare class ColumnComposer {
+    private profile;
+    private measurer;
+    private wrapper;
+    private spaceWidthPx;
+    constructor(profile: DisplayProfile, breakMode?: BreakMode);
+    /**
+     * Compose a double text wall layout.
+     *
+     * Takes left and right text, wraps each to their column width,
+     * and merges them with pixel-precise space alignment.
+     *
+     * @param leftText - Text for the left column
+     * @param rightText - Text for the right column
+     * @param options - Optional composition settings
+     * @returns Composed result with merged text and metadata
+     */
+    composeDoubleTextWall(leftText: string, rightText: string, options?: ComposeOptions): ComposeResult;
+    /**
+     * Get the default column configuration for the current profile.
+     */
+    getDefaultColumnConfig(): ColumnConfig;
+    /**
+     * Update the break mode for text wrapping.
+     */
+    setBreakMode(breakMode: BreakMode): void;
+    /**
+     * Get column configuration, merging defaults with overrides.
+     */
+    private getColumnConfig;
+    /**
+     * Pad lines array to exactly `count` entries.
+     */
+    private padLines;
+    /**
+     * Merge left and right columns with pixel-precise space alignment.
+     *
+     * For each line:
+     * 1. Take the left column text
+     * 2. Calculate its pixel width
+     * 3. Calculate how many spaces needed to reach rightColumnStartPx
+     * 4. Append spaces and right column text
+     */
+    private mergeColumns;
+    /**
+     * Calculate the number of spaces needed to align to a target position.
+     *
+     * @param currentWidthPx - Current position in pixels
+     * @param targetPositionPx - Target position in pixels
+     * @returns Number of space characters needed
+     */
+    private calculateSpacesForAlignment;
+    /**
+     * Remove en-space characters (U+2002) that may have been added during wrapping.
+     * Native implementations do this cleanup before merging.
+     */
+    private cleanEnspaces;
+}
+/**
+ * Create a ColumnComposer for a given profile.
+ *
+ * @param profile - Display profile to use
+ * @param breakMode - Break mode for text wrapping (default: "word")
+ * @returns Configured ColumnComposer instance
+ */
+export declare function createColumnComposer(profile: DisplayProfile, breakMode?: BreakMode): ColumnComposer;
+//# sourceMappingURL=ColumnComposer.d.ts.map

package/build/utils/display/composer/ColumnComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColumnComposer.d.ts","sourceRoot":"","sources":["../../../../src/utils/display/composer/ColumnComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,mBAAmB,CAAA;AAGrD,OAAO,KAAK,EAAc,SAAS,EAAC,MAAM,kBAAkB,CAAA;AAM5D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAA;IACzB,yDAAyD;IACzD,kBAAkB,EAAE,MAAM,CAAA;IAC1B,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAA;IAC1B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAA;IACpB,yDAAyD;IACzD,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,6CAA6C;IAC7C,MAAM,EAAE,YAAY,CAAA;CACrB;AAMD;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,YAAY,CAAQ;gBAEhB,OAAO,EAAE,cAAc,EAAE,SAAS,GAAE,SAAiC;IAejF;;;;;;;;;;OAUG;IACI,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa;IAgC9G;;OAEG;IACI,sBAAsB,IAAI,YAAY;IAI7C;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAU/C;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IA+BpB;;;;;;OAMG;IACH,OAAO,CAAC,2BAA2B;IAmBnC;;;OAGG;IACH,OAAO,CAAC,aAAa;CAGtB;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,GAAE,SAAkB,GAAG,cAAc,CAE3G"}

package/build/utils/display/composer/ColumnComposer.js

@@ -0,0 +1,204 @@
+/**
+ * ColumnComposer
+ *
+ * Handles composition of multi-column layouts like double_text_wall.
+ * This is the single source of truth for column layout logic, replacing
+ * the duplicate implementations in native iOS (G1Text.swift) and
+ * Android (G1Text.kt, G1.java).
+ *
+ * The composer:
+ * 1. Wraps each column's text to its allocated width
+ * 2. Merges columns line-by-line with pixel-precise space padding
+ * 3. Returns a single pre-composed string ready for native to chunk & send
+ *
+ * @see cloud/issues/026-mobile-display-processor for design docs
+ */
+import { TextMeasurer } from "../measurer/TextMeasurer";
+import { TextWrapper } from "../wrapper/TextWrapper";
+// =============================================================================
+// ColumnComposer Class
+// =============================================================================
+/**
+ * Composes multi-column layouts for smart glasses displays.
+ *
+ * Usage:
+ * ```typescript
+ * const composer = new ColumnComposer(G1_PROFILE)
+ * const result = composer.composeDoubleTextWall("Left content", "Right content")
+ * // result.composedText is ready to send to native SGC
+ * ```
+ */
+export class ColumnComposer {
+    profile;
+    measurer;
+    wrapper;
+    spaceWidthPx;
+    constructor(profile, breakMode = "character-no-hyphen") {
+        this.profile = profile;
+        this.measurer = new TextMeasurer(profile);
+        this.wrapper = new TextWrapper(this.measurer, {
+            breakMode,
+        });
+        // Cache space width for alignment calculations
+        this.spaceWidthPx = this.measurer.measureText(" ");
+    }
+    // ===========================================================================
+    // Public API
+    // ===========================================================================
+    /**
+     * Compose a double text wall layout.
+     *
+     * Takes left and right text, wraps each to their column width,
+     * and merges them with pixel-precise space alignment.
+     *
+     * @param leftText - Text for the left column
+     * @param rightText - Text for the right column
+     * @param options - Optional composition settings
+     * @returns Composed result with merged text and metadata
+     */
+    composeDoubleTextWall(leftText, rightText, options = {}) {
+        const config = this.getColumnConfig(options.columnConfig);
+        // Wrap each column independently
+        const leftWrapOptions = {
+            maxWidthPx: config.leftColumnWidthPx,
+            maxLines: config.maxLines,
+        };
+        const rightWrapOptions = {
+            maxWidthPx: config.rightColumnWidthPx,
+            maxLines: config.maxLines,
+        };
+        const leftResult = this.wrapper.wrap(leftText || "", leftWrapOptions);
+        const rightResult = this.wrapper.wrap(rightText || "", rightWrapOptions);
+        // Pad arrays to have exactly maxLines entries
+        const leftLines = this.padLines(leftResult.lines, config.maxLines);
+        const rightLines = this.padLines(rightResult.lines, config.maxLines);
+        // Merge columns with space alignment
+        const composedText = this.mergeColumns(leftLines, rightLines, config);
+        return {
+            composedText,
+            leftLines,
+            rightLines,
+            config,
+        };
+    }
+    /**
+     * Get the default column configuration for the current profile.
+     */
+    getDefaultColumnConfig() {
+        return this.getColumnConfig();
+    }
+    /**
+     * Update the break mode for text wrapping.
+     */
+    setBreakMode(breakMode) {
+        this.wrapper = new TextWrapper(this.measurer, {
+            breakMode,
+        });
+    }
+    // ===========================================================================
+    // Private Methods
+    // ===========================================================================
+    /**
+     * Get column configuration, merging defaults with overrides.
+     */
+    getColumnConfig(overrides) {
+        const displayWidth = this.profile.displayWidthPx;
+        // Default layout: 50% for left column, right starts at 55%
+        // This matches the native G1Text implementations
+        const defaults = {
+            leftColumnWidthPx: Math.floor(displayWidth * 0.5),
+            rightColumnStartPx: Math.floor(displayWidth * 0.55),
+            rightColumnWidthPx: displayWidth - Math.floor(displayWidth * 0.55),
+            maxLines: this.profile.maxLines,
+            leftMarginSpaces: 0,
+        };
+        return {
+            ...defaults,
+            ...overrides,
+        };
+    }
+    /**
+     * Pad lines array to exactly `count` entries.
+     */
+    padLines(lines, count) {
+        const result = [...lines];
+        while (result.length < count) {
+            result.push("");
+        }
+        return result.slice(0, count);
+    }
+    /**
+     * Merge left and right columns with pixel-precise space alignment.
+     *
+     * For each line:
+     * 1. Take the left column text
+     * 2. Calculate its pixel width
+     * 3. Calculate how many spaces needed to reach rightColumnStartPx
+     * 4. Append spaces and right column text
+     */
+    mergeColumns(leftLines, rightLines, config) {
+        const lines = [];
+        for (let i = 0; i < config.maxLines; i++) {
+            const leftText = this.cleanEnspaces(leftLines[i] || "");
+            const rightText = this.cleanEnspaces(rightLines[i] || "");
+            // Calculate pixel width of left text
+            const leftWidthPx = this.measurer.measureText(leftText);
+            // Calculate spaces needed to reach the right column start
+            const spacesNeeded = this.calculateSpacesForAlignment(leftWidthPx, config.rightColumnStartPx);
+            // Build the merged line
+            let line = "";
+            // Add left margin if configured
+            if (config.leftMarginSpaces && config.leftMarginSpaces > 0) {
+                line += " ".repeat(config.leftMarginSpaces);
+            }
+            line += leftText;
+            line += " ".repeat(spacesNeeded);
+            line += rightText;
+            lines.push(line);
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Calculate the number of spaces needed to align to a target position.
+     *
+     * @param currentWidthPx - Current position in pixels
+     * @param targetPositionPx - Target position in pixels
+     * @returns Number of space characters needed
+     */
+    calculateSpacesForAlignment(currentWidthPx, targetPositionPx) {
+        const pixelsNeeded = targetPositionPx - currentWidthPx;
+        // Ensure at least one space for separation
+        if (pixelsNeeded <= 0) {
+            return 1;
+        }
+        // Calculate spaces needed. Use Math.floor (not Math.ceil) to ensure the
+        // right column never starts past rightColumnStartPx. Rounding up caused
+        // the right column to start 1–5px further right than planned, shrinking
+        // its usable width and causing the last character to wrap onto the next
+        // line's left position.
+        const spaces = Math.max(1, Math.floor(pixelsNeeded / this.spaceWidthPx));
+        // Cap at a reasonable maximum to prevent runaway spacing
+        return Math.min(spaces, 100);
+    }
+    /**
+     * Remove en-space characters (U+2002) that may have been added during wrapping.
+     * Native implementations do this cleanup before merging.
+     */
+    cleanEnspaces(text) {
+        return text.replace(/\u2002/g, "");
+    }
+}
+// =============================================================================
+// Factory Function
+// =============================================================================
+/**
+ * Create a ColumnComposer for a given profile.
+ *
+ * @param profile - Display profile to use
+ * @param breakMode - Break mode for text wrapping (default: "word")
+ * @returns Configured ColumnComposer instance
+ */
+export function createColumnComposer(profile, breakMode = "word") {
+    return new ColumnComposer(profile, breakMode);
+}
+//# sourceMappingURL=ColumnComposer.js.map

package/build/utils/display/composer/ColumnComposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColumnComposer.js","sourceRoot":"","sources":["../../../../src/utils/display/composer/ColumnComposer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ColumnComposer\n *\n * Handles composition of multi-column layouts like double_text_wall.\n * This is the single source of truth for column layout logic, replacing\n * the duplicate implementations in native iOS (G1Text.swift) and\n * Android (G1Text.kt, G1.java).\n *\n * The composer:\n * 1. Wraps each column's text to its allocated width\n * 2. Merges columns line-by-line with pixel-precise space padding\n * 3. Returns a single pre-composed string ready for native to chunk & send\n *\n * @see cloud/issues/026-mobile-display-processor for design docs\n */\n\nimport type {DisplayProfile} from \"../profiles/types\"\nimport {TextMeasurer} from \"../measurer/TextMeasurer\"\nimport {TextWrapper} from \"../wrapper/TextWrapper\"\nimport type {WrapOptions, BreakMode} from \"../wrapper/types\"\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Configuration for column layout\n */\nexport interface ColumnConfig {\n  /** Width of the left column in pixels */\n  leftColumnWidthPx: number\n  /** X position where the right column starts in pixels */\n  rightColumnStartPx: number\n  /** Width of the right column in pixels (calculated from start position) */\n  rightColumnWidthPx: number\n  /** Maximum number of lines to display */\n  maxLines: number\n  /** Left margin in spaces (for indentation) */\n  leftMarginSpaces?: number\n}\n\n/**\n * Options for composing double text wall\n */\nexport interface ComposeOptions {\n  /** Break mode for text wrapping */\n  breakMode?: BreakMode\n  /** Custom column configuration (overrides profile defaults) */\n  columnConfig?: Partial<ColumnConfig>\n}\n\n/**\n * Result of column composition\n */\nexport interface ComposeResult {\n  /** The fully composed text with both columns merged */\n  composedText: string\n  /** Lines from the left column (for debugging/preview) */\n  leftLines: string[]\n  /** Lines from the right column (for debugging/preview) */\n  rightLines: string[]\n  /** The column configuration that was used */\n  config: ColumnConfig\n}\n\n// =============================================================================\n// ColumnComposer Class\n// =============================================================================\n\n/**\n * Composes multi-column layouts for smart glasses displays.\n *\n * Usage:\n * ```typescript\n * const composer = new ColumnComposer(G1_PROFILE)\n * const result = composer.composeDoubleTextWall(\"Left content\", \"Right content\")\n * // result.composedText is ready to send to native SGC\n * ```\n */\nexport class ColumnComposer {\n  private profile: DisplayProfile\n  private measurer: TextMeasurer\n  private wrapper: TextWrapper\n  private spaceWidthPx: number\n\n  constructor(profile: DisplayProfile, breakMode: BreakMode = \"character-no-hyphen\") {\n    this.profile = profile\n    this.measurer = new TextMeasurer(profile)\n    this.wrapper = new TextWrapper(this.measurer, {\n      breakMode,\n    })\n\n    // Cache space width for alignment calculations\n    this.spaceWidthPx = this.measurer.measureText(\" \")\n  }\n\n  // ===========================================================================\n  // Public API\n  // ===========================================================================\n\n  /**\n   * Compose a double text wall layout.\n   *\n   * Takes left and right text, wraps each to their column width,\n   * and merges them with pixel-precise space alignment.\n   *\n   * @param leftText - Text for the left column\n   * @param rightText - Text for the right column\n   * @param options - Optional composition settings\n   * @returns Composed result with merged text and metadata\n   */\n  public composeDoubleTextWall(leftText: string, rightText: string, options: ComposeOptions = {}): ComposeResult {\n    const config = this.getColumnConfig(options.columnConfig)\n\n    // Wrap each column independently\n    const leftWrapOptions: WrapOptions = {\n      maxWidthPx: config.leftColumnWidthPx,\n      maxLines: config.maxLines,\n    }\n\n    const rightWrapOptions: WrapOptions = {\n      maxWidthPx: config.rightColumnWidthPx,\n      maxLines: config.maxLines,\n    }\n\n    const leftResult = this.wrapper.wrap(leftText || \"\", leftWrapOptions)\n    const rightResult = this.wrapper.wrap(rightText || \"\", rightWrapOptions)\n\n    // Pad arrays to have exactly maxLines entries\n    const leftLines = this.padLines(leftResult.lines, config.maxLines)\n    const rightLines = this.padLines(rightResult.lines, config.maxLines)\n\n    // Merge columns with space alignment\n    const composedText = this.mergeColumns(leftLines, rightLines, config)\n\n    return {\n      composedText,\n      leftLines,\n      rightLines,\n      config,\n    }\n  }\n\n  /**\n   * Get the default column configuration for the current profile.\n   */\n  public getDefaultColumnConfig(): ColumnConfig {\n    return this.getColumnConfig()\n  }\n\n  /**\n   * Update the break mode for text wrapping.\n   */\n  public setBreakMode(breakMode: BreakMode): void {\n    this.wrapper = new TextWrapper(this.measurer, {\n      breakMode,\n    })\n  }\n\n  // ===========================================================================\n  // Private Methods\n  // ===========================================================================\n\n  /**\n   * Get column configuration, merging defaults with overrides.\n   */\n  private getColumnConfig(overrides?: Partial<ColumnConfig>): ColumnConfig {\n    const displayWidth = this.profile.displayWidthPx\n\n    // Default layout: 50% for left column, right starts at 55%\n    // This matches the native G1Text implementations\n    const defaults: ColumnConfig = {\n      leftColumnWidthPx: Math.floor(displayWidth * 0.5),\n      rightColumnStartPx: Math.floor(displayWidth * 0.55),\n      rightColumnWidthPx: displayWidth - Math.floor(displayWidth * 0.55),\n      maxLines: this.profile.maxLines,\n      leftMarginSpaces: 0,\n    }\n\n    return {\n      ...defaults,\n      ...overrides,\n    }\n  }\n\n  /**\n   * Pad lines array to exactly `count` entries.\n   */\n  private padLines(lines: string[], count: number): string[] {\n    const result = [...lines]\n    while (result.length < count) {\n      result.push(\"\")\n    }\n    return result.slice(0, count)\n  }\n\n  /**\n   * Merge left and right columns with pixel-precise space alignment.\n   *\n   * For each line:\n   * 1. Take the left column text\n   * 2. Calculate its pixel width\n   * 3. Calculate how many spaces needed to reach rightColumnStartPx\n   * 4. Append spaces and right column text\n   */\n  private mergeColumns(leftLines: string[], rightLines: string[], config: ColumnConfig): string {\n    const lines: string[] = []\n\n    for (let i = 0; i < config.maxLines; i++) {\n      const leftText = this.cleanEnspaces(leftLines[i] || \"\")\n      const rightText = this.cleanEnspaces(rightLines[i] || \"\")\n\n      // Calculate pixel width of left text\n      const leftWidthPx = this.measurer.measureText(leftText)\n\n      // Calculate spaces needed to reach the right column start\n      const spacesNeeded = this.calculateSpacesForAlignment(leftWidthPx, config.rightColumnStartPx)\n\n      // Build the merged line\n      let line = \"\"\n\n      // Add left margin if configured\n      if (config.leftMarginSpaces && config.leftMarginSpaces > 0) {\n        line += \" \".repeat(config.leftMarginSpaces)\n      }\n\n      line += leftText\n      line += \" \".repeat(spacesNeeded)\n      line += rightText\n\n      lines.push(line)\n    }\n\n    return lines.join(\"\\n\")\n  }\n\n  /**\n   * Calculate the number of spaces needed to align to a target position.\n   *\n   * @param currentWidthPx - Current position in pixels\n   * @param targetPositionPx - Target position in pixels\n   * @returns Number of space characters needed\n   */\n  private calculateSpacesForAlignment(currentWidthPx: number, targetPositionPx: number): number {\n    const pixelsNeeded = targetPositionPx - currentWidthPx\n\n    // Ensure at least one space for separation\n    if (pixelsNeeded <= 0) {\n      return 1\n    }\n\n    // Calculate spaces needed. Use Math.floor (not Math.ceil) to ensure the\n    // right column never starts past rightColumnStartPx. Rounding up caused\n    // the right column to start 1–5px further right than planned, shrinking\n    // its usable width and causing the last character to wrap onto the next\n    // line's left position.\n    const spaces = Math.max(1, Math.floor(pixelsNeeded / this.spaceWidthPx))\n\n    // Cap at a reasonable maximum to prevent runaway spacing\n    return Math.min(spaces, 100)\n  }\n\n  /**\n   * Remove en-space characters (U+2002) that may have been added during wrapping.\n   * Native implementations do this cleanup before merging.\n   */\n  private cleanEnspaces(text: string): string {\n    return text.replace(/\\u2002/g, \"\")\n  }\n}\n\n// =============================================================================\n// Factory Function\n// =============================================================================\n\n/**\n * Create a ColumnComposer for a given profile.\n *\n * @param profile - Display profile to use\n * @param breakMode - Break mode for text wrapping (default: \"word\")\n * @returns Configured ColumnComposer instance\n */\nexport function createColumnComposer(profile: DisplayProfile, breakMode: BreakMode = \"word\"): ColumnComposer {\n  return new ColumnComposer(profile, breakMode)\n}\n"]}

package/build/utils/display/composer/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Composer Module
+ *
+ * Handles composition of multi-column and complex layouts for smart glasses displays.
+ * This module provides the single source of truth for layout composition logic,
+ * replacing duplicate implementations in native iOS and Android code.
+ */
+export { ColumnComposer, createColumnComposer, type ColumnConfig, type ComposeOptions, type ComposeResult, } from "./ColumnComposer";
+//# sourceMappingURL=index.d.ts.map

package/build/utils/display/composer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/display/composer/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAA"}

package/build/utils/display/composer/index.js

@@ -0,0 +1,9 @@
+/**
+ * Composer Module
+ *
+ * Handles composition of multi-column and complex layouts for smart glasses displays.
+ * This module provides the single source of truth for layout composition logic,
+ * replacing duplicate implementations in native iOS and Android code.
+ */
+export { ColumnComposer, createColumnComposer, } from "./ColumnComposer";
+//# sourceMappingURL=index.js.map

package/build/utils/display/composer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/display/composer/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EACd,oBAAoB,GAIrB,MAAM,kBAAkB,CAAA","sourcesContent":["/**\n * Composer Module\n *\n * Handles composition of multi-column and complex layouts for smart glasses displays.\n * This module provides the single source of truth for layout composition logic,\n * replacing duplicate implementations in native iOS and Android code.\n */\n\nexport {\n  ColumnComposer,\n  createColumnComposer,\n  type ColumnConfig,\n  type ComposeOptions,\n  type ComposeResult,\n} from \"./ColumnComposer\"\n"]}

package/build/utils/display/helpers/DisplayHelpers.d.ts

@@ -0,0 +1,165 @@
+import type { DisplayProfile } from "../profiles/types";
+import { TextMeasurer } from "../measurer/TextMeasurer";
+import { TextWrapper } from "../wrapper/TextWrapper";
+import type { WrapOptions, WrapResult } from "../wrapper/types";
+/**
+ * Truncation result with metadata.
+ */
+export interface TruncateResult {
+    /** The truncated text */
+    text: string;
+    /** Whether text was truncated */
+    wasTruncated: boolean;
+    /** Width in pixels of truncated text */
+    widthPx: number;
+    /** Original text length */
+    originalLength: number;
+    /** Truncated text length */
+    truncatedLength: number;
+}
+/**
+ * Page result for pagination.
+ */
+export interface Page {
+    /** Lines on this page */
+    lines: string[];
+    /** Page number (1-indexed) */
+    pageNumber: number;
+    /** Total number of pages */
+    totalPages: number;
+    /** Whether this is the first page */
+    isFirst: boolean;
+    /** Whether this is the last page */
+    isLast: boolean;
+}
+/**
+ * Chunk result for BLE transmission.
+ */
+export interface Chunk {
+    /** The chunk text */
+    text: string;
+    /** Chunk index (0-indexed) */
+    index: number;
+    /** Total number of chunks */
+    totalChunks: number;
+    /** Byte size of this chunk */
+    bytes: number;
+}
+/**
+ * Optional helper utilities for common display operations.
+ * Built on top of TextMeasurer and TextWrapper for convenience.
+ */
+export declare class DisplayHelpers {
+    private readonly measurer;
+    private readonly wrapper;
+    private readonly profile;
+    constructor(measurer: TextMeasurer, wrapper: TextWrapper);
+    /**
+     * Truncate lines array to max count.
+     *
+     * @param lines - Array of lines
+     * @param maxLines - Maximum lines to keep
+     * @param fromEnd - If true, keep last N lines; if false, keep first N (default: false)
+     * @returns Truncated lines array
+     */
+    truncateToLines(lines: string[], maxLines: number, fromEnd?: boolean): string[];
+    /**
+     * Truncate text to fit within pixel width, adding ellipsis if needed.
+     *
+     * @param text - Text to truncate
+     * @param maxWidthPx - Maximum width in pixels
+     * @param ellipsis - Ellipsis string (default: '...')
+     * @returns Truncation result
+     */
+    truncateWithEllipsis(text: string, maxWidthPx?: number, ellipsis?: string): TruncateResult;
+    /**
+     * Estimate how many lines text will need without fully wrapping.
+     * This is a quick estimate based on average character width.
+     *
+     * @param text - Text to estimate
+     * @param maxWidthPx - Optional width override
+     * @returns Estimated line count
+     */
+    estimateLineCount(text: string, maxWidthPx?: number): number;
+    /**
+     * Wrap and truncate text to fit screen in one call.
+     *
+     * @param text - Text to fit
+     * @param options - Wrap options
+     * @returns Lines that fit on screen
+     */
+    fitToScreen(text: string, options?: WrapOptions): string[];
+    /**
+     * Wrap text and paginate into screen-sized pages.
+     *
+     * @param text - Text to paginate
+     * @param options - Wrap options (maxLines will be used as page size)
+     * @returns Array of pages
+     */
+    paginate(text: string, options?: WrapOptions): Page[];
+    /**
+     * Calculate UTF-8 byte size of text.
+     *
+     * @param text - Text to measure
+     * @returns Byte size
+     */
+    calculateByteSize(text: string): number;
+    /**
+     * Check if text exceeds byte limit.
+     *
+     * @param text - Text to check
+     * @param maxBytes - Optional override (defaults to profile)
+     * @returns true if exceeds limit
+     */
+    exceedsByteLimit(text: string, maxBytes?: number): boolean;
+    /**
+     * Split text into BLE-safe chunks.
+     * Tries to split at word/line boundaries when possible.
+     *
+     * @param text - Text to chunk
+     * @param chunkSize - Optional override (defaults to profile)
+     * @returns Array of chunks
+     */
+    splitIntoChunks(text: string, chunkSize?: number): Chunk[];
+    /**
+     * Calculate line utilization statistics.
+     *
+     * @param result - Wrap result to analyze
+     * @returns Utilization statistics
+     */
+    calculateUtilization(result: WrapResult): {
+        averageUtilization: number;
+        minUtilization: number;
+        maxUtilization: number;
+        totalWastedPx: number;
+    };
+    /**
+     * Pad lines array to exact count with empty strings.
+     *
+     * @param lines - Lines to pad
+     * @param targetCount - Target number of lines
+     * @param padAtEnd - If true, pad at end; if false, pad at start (default: true)
+     * @returns Padded lines array
+     */
+    padToLineCount(lines: string[], targetCount: number, padAtEnd?: boolean): string[];
+    /**
+     * Join lines with newlines for display.
+     *
+     * @param lines - Lines to join
+     * @returns Joined string
+     */
+    joinLines(lines: string[]): string;
+    /**
+     * Get the measurer instance.
+     */
+    getMeasurer(): TextMeasurer;
+    /**
+     * Get the wrapper instance.
+     */
+    getWrapper(): TextWrapper;
+    /**
+     * Get the display profile.
+     */
+    getProfile(): DisplayProfile;
+}
+//# sourceMappingURL=DisplayHelpers.d.ts.map

package/build/utils/display/helpers/DisplayHelpers.d.ts.map

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