@mentra/engine 0.1.0-beta.0

package/build/utils/diagnosticContext.js

@@ -0,0 +1,119 @@
+import NetInfo from "@react-native-community/netinfo";
+import Constants from "expo-constants";
+import * as Location from "expo-location";
+import { Platform } from "react-native";
+import { useAppStatusStore } from "../stores/apps";
+import { useConnectionStore } from "../stores/connection";
+import { useCoreStore } from "../stores/core";
+import { useGlassesStore } from "../stores/glasses";
+import { SETTINGS, useSettingsStore } from "../stores/settings";
+const SENSITIVE_SETTINGS_KEYS = ["core_token", "auth_token", "auth_email"];
+const SENSITIVE_GLASSES_KEYS = ["hotspotPassword"];
+/**
+ * The glasses store keeps hotspot credentials NESTED (`hotspot: {state, ssid,
+ * password, localIp}`), not just on the legacy top-level `hotspotPassword` key —
+ * strip the password before the state is attached to a report.
+ */
+function redactNestedCredentials(glasses) {
+    const hotspot = glasses.hotspot;
+    if (hotspot && typeof hotspot === "object" && "password" in hotspot) {
+        const { password: _password, ...rest } = hotspot;
+        return { ...glasses, hotspot: { ...rest, password: "[REDACTED]" } };
+    }
+    return glasses;
+}
+export async function collectDiagnosticContext(extra) {
+    const appletState = useAppStatusStore.getState();
+    const settingsState = useSettingsStore.getState();
+    const { setCoreInfo: _setCoreInfo, reset: _resetBluetooth, ...coreState } = useCoreStore.getState();
+    const { setStatus: _setConnectionStatus, setUrl: _setConnectionUrl, setError: _setConnectionError, incrementReconnectAttempts: _incrementReconnectAttempts, resetReconnectAttempts: _resetReconnectAttempts, reset: _resetConnection, ...connectionState } = useConnectionStore.getState();
+    const { setGlassesInfo: _setGlassesInfo, setBatteryInfo: _setBatteryInfo, setWifiInfo: _setWifiInfo, setHotspotInfo: _setHotspotInfo, setOtaUpdateAvailable: _setOtaUpdateAvailable, setOtaProgress: _setOtaProgress, setOtaInProgress: _setOtaInProgress, setMtkUpdatedThisSession: _setMtkUpdatedThisSession, clearOtaState: _clearOtaState, reset: _resetGlasses, ...glassesState } = useGlassesStore.getState();
+    const filteredGlasses = redactNestedCredentials(Object.fromEntries(Object.entries(glassesState).filter(([key]) => !SENSITIVE_GLASSES_KEYS.includes(key))));
+    const filteredSettings = Object.fromEntries(Object.entries(settingsState.settings || {}).filter(([key]) => !SENSITIVE_SETTINGS_KEYS.includes(key)));
+    let networkInfo = { type: "unknown", isConnected: false, isInternetReachable: false };
+    try {
+        const netState = await NetInfo.fetch();
+        networkInfo = {
+            type: netState.type,
+            isConnected: netState.isConnected ?? false,
+            isInternetReachable: netState.isInternetReachable ?? false,
+        };
+    }
+    catch (error) {
+        console.log("diagnosticContext: failed to get network info:", error);
+    }
+    let locationInfo;
+    try {
+        const { status } = await Location.getForegroundPermissionsAsync();
+        if (status === "granted") {
+            const location = await Location.getLastKnownPositionAsync();
+            if (location) {
+                locationInfo = {
+                    latitude: Number(location.coords.latitude.toFixed(4)),
+                    longitude: Number(location.coords.longitude.toFixed(4)),
+                };
+                try {
+                    const [place] = await Location.reverseGeocodeAsync({
+                        latitude: location.coords.latitude,
+                        longitude: location.coords.longitude,
+                    });
+                    if (place) {
+                        locationInfo.place = [place.city, place.region, place.country].filter(Boolean).join(", ");
+                    }
+                }
+                catch (error) {
+                    console.log("diagnosticContext: failed to reverse geocode:", error);
+                }
+            }
+        }
+    }
+    catch (error) {
+        console.log("diagnosticContext: failed to get location:", error);
+    }
+    const offlineMode = await useSettingsStore.getState().getSetting(SETTINGS.offline_mode.key);
+    const defaultWearable = await useSettingsStore.getState().getSetting(SETTINGS.default_wearable.key);
+    const apps = appletState.apps.map((app) => ({
+        packageName: app.packageName,
+        name: app.name,
+        running: app.running,
+        loading: app.loading,
+        healthy: app.healthy,
+        hidden: app.hidden,
+        type: app.type,
+        offline: app.offline,
+        local: app.local,
+    }));
+    return {
+        app: {
+            appVersion: process.env.EXPO_PUBLIC_MENTRAOS_VERSION || "version",
+            buildCommit: process.env.EXPO_PUBLIC_BUILD_COMMIT || "commit",
+            buildBranch: process.env.EXPO_PUBLIC_BUILD_BRANCH || "branch",
+            buildTime: process.env.EXPO_PUBLIC_BUILD_TIME || "time",
+            buildUser: process.env.EXPO_PUBLIC_BUILD_USER || "user",
+        },
+        phone: {
+            deviceName: Constants.deviceName || "deviceName",
+            osVersion: `${Platform.OS} ${Platform.Version}`,
+            platform: Platform.OS,
+            network: networkInfo,
+            location: locationInfo,
+        },
+        glasses: filteredGlasses,
+        runtime: {
+            core: coreState,
+            connection: connectionState,
+        },
+        apps: {
+            apps,
+            installed: apps.map((app) => app.packageName),
+            running: apps.filter((app) => app.running).map((app) => app.packageName),
+        },
+        settings: {
+            ...filteredSettings,
+            offlineMode: !!offlineMode,
+            defaultWearable,
+        },
+        ...extra,
+    };
+}
+//# sourceMappingURL=diagnosticContext.js.map

package/build/utils/diagnosticContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosticContext.js","sourceRoot":"","sources":["../../src/utils/diagnosticContext.ts"],"names":[],"mappings":"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","sourcesContent":["import NetInfo from \"@react-native-community/netinfo\"\nimport Constants from \"expo-constants\"\nimport * as Location from \"expo-location\"\nimport {Platform} from \"react-native\"\nimport type {ReportContext} from \"@mentra/cloud-client\"\n\nimport {useAppStatusStore} from \"../stores/apps\"\nimport {useConnectionStore} from \"../stores/connection\"\nimport {useCoreStore} from \"../stores/core\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {SETTINGS, useSettingsStore} from \"../stores/settings\"\n\nconst SENSITIVE_SETTINGS_KEYS = [\"core_token\", \"auth_token\", \"auth_email\"] as const\nconst SENSITIVE_GLASSES_KEYS = [\"hotspotPassword\"] as const\n\n/**\n * The glasses store keeps hotspot credentials NESTED (`hotspot: {state, ssid,\n * password, localIp}`), not just on the legacy top-level `hotspotPassword` key —\n * strip the password before the state is attached to a report.\n */\nfunction redactNestedCredentials(glasses: Record<string, unknown>): Record<string, unknown> {\n  const hotspot = glasses.hotspot\n  if (hotspot && typeof hotspot === \"object\" && \"password\" in hotspot) {\n    const {password: _password, ...rest} = hotspot as Record<string, unknown>\n    return {...glasses, hotspot: {...rest, password: \"[REDACTED]\"}}\n  }\n  return glasses\n}\n\nexport async function collectDiagnosticContext(extra?: Partial<ReportContext>): Promise<ReportContext> {\n  const appletState = useAppStatusStore.getState()\n  const settingsState = useSettingsStore.getState()\n  const {setCoreInfo: _setCoreInfo, reset: _resetBluetooth, ...coreState} = useCoreStore.getState()\n  const {\n    setStatus: _setConnectionStatus,\n    setUrl: _setConnectionUrl,\n    setError: _setConnectionError,\n    incrementReconnectAttempts: _incrementReconnectAttempts,\n    resetReconnectAttempts: _resetReconnectAttempts,\n    reset: _resetConnection,\n    ...connectionState\n  } = useConnectionStore.getState()\n  const {\n    setGlassesInfo: _setGlassesInfo,\n    setBatteryInfo: _setBatteryInfo,\n    setWifiInfo: _setWifiInfo,\n    setHotspotInfo: _setHotspotInfo,\n    setOtaUpdateAvailable: _setOtaUpdateAvailable,\n    setOtaProgress: _setOtaProgress,\n    setOtaInProgress: _setOtaInProgress,\n    setMtkUpdatedThisSession: _setMtkUpdatedThisSession,\n    clearOtaState: _clearOtaState,\n    reset: _resetGlasses,\n    ...glassesState\n  } = useGlassesStore.getState()\n\n  const filteredGlasses = redactNestedCredentials(\n    Object.fromEntries(\n      Object.entries(glassesState).filter(\n        ([key]) => !SENSITIVE_GLASSES_KEYS.includes(key as (typeof SENSITIVE_GLASSES_KEYS)[number]),\n      ),\n    ),\n  )\n  const filteredSettings = Object.fromEntries(\n    Object.entries(settingsState.settings || {}).filter(\n      ([key]) => !SENSITIVE_SETTINGS_KEYS.includes(key as (typeof SENSITIVE_SETTINGS_KEYS)[number]),\n    ),\n  )\n\n  let networkInfo: Record<string, unknown> = {type: \"unknown\", isConnected: false, isInternetReachable: false}\n  try {\n    const netState = await NetInfo.fetch()\n    networkInfo = {\n      type: netState.type,\n      isConnected: netState.isConnected ?? false,\n      isInternetReachable: netState.isInternetReachable ?? false,\n    }\n  } catch (error) {\n    console.log(\"diagnosticContext: failed to get network info:\", error)\n  }\n\n  let locationInfo: Record<string, unknown> | undefined\n  try {\n    const {status} = await Location.getForegroundPermissionsAsync()\n    if (status === \"granted\") {\n      const location = await Location.getLastKnownPositionAsync()\n      if (location) {\n        locationInfo = {\n          latitude: Number(location.coords.latitude.toFixed(4)),\n          longitude: Number(location.coords.longitude.toFixed(4)),\n        }\n        try {\n          const [place] = await Location.reverseGeocodeAsync({\n            latitude: location.coords.latitude,\n            longitude: location.coords.longitude,\n          })\n          if (place) {\n            locationInfo.place = [place.city, place.region, place.country].filter(Boolean).join(\", \")\n          }\n        } catch (error) {\n          console.log(\"diagnosticContext: failed to reverse geocode:\", error)\n        }\n      }\n    }\n  } catch (error) {\n    console.log(\"diagnosticContext: failed to get location:\", error)\n  }\n\n  const offlineMode = await useSettingsStore.getState().getSetting(SETTINGS.offline_mode.key)\n  const defaultWearable = await useSettingsStore.getState().getSetting(SETTINGS.default_wearable.key)\n  const apps = appletState.apps.map((app) => ({\n    packageName: app.packageName,\n    name: app.name,\n    running: app.running,\n    loading: app.loading,\n    healthy: app.healthy,\n    hidden: app.hidden,\n    type: app.type,\n    offline: app.offline,\n    local: app.local,\n  }))\n\n  return {\n    app: {\n      appVersion: process.env.EXPO_PUBLIC_MENTRAOS_VERSION || \"version\",\n      buildCommit: process.env.EXPO_PUBLIC_BUILD_COMMIT || \"commit\",\n      buildBranch: process.env.EXPO_PUBLIC_BUILD_BRANCH || \"branch\",\n      buildTime: process.env.EXPO_PUBLIC_BUILD_TIME || \"time\",\n      buildUser: process.env.EXPO_PUBLIC_BUILD_USER || \"user\",\n    },\n    phone: {\n      deviceName: Constants.deviceName || \"deviceName\",\n      osVersion: `${Platform.OS} ${Platform.Version}`,\n      platform: Platform.OS,\n      network: networkInfo,\n      location: locationInfo,\n    },\n    glasses: filteredGlasses,\n    runtime: {\n      core: coreState,\n      connection: connectionState,\n    },\n    apps: {\n      apps,\n      installed: apps.map((app) => app.packageName),\n      running: apps.filter((app) => app.running).map((app) => app.packageName),\n    },\n    settings: {\n      ...filteredSettings,\n      offlineMode: !!offlineMode,\n      defaultWearable,\n    },\n    ...extra,\n  }\n}\n"]}

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,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAM/D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,6CAA6C;IAC7C,MAAM,EAAE,YAAY,CAAC;CACtB;AAMD;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,YAAY,CAAS;gBAEjB,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,CAAC"}

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,CAAC","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"]}