@mentra/engine 0.1.0-beta.0

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

@@ -0,0 +1,183 @@
+import type { DisplayProfile } from "../profiles/types";
+import { TextMeasurer } from "../measurer/TextMeasurer";
+import { TextWrapper } from "../wrapper/TextWrapper";
+import type { WrapOptions } from "../wrapper/types";
+/**
+ * Scroll position information.
+ */
+export interface ScrollPosition {
+    /** Current scroll offset (0 = top) */
+    offset: number;
+    /** Total number of lines in content */
+    totalLines: number;
+    /** Number of visible lines (viewport size) */
+    visibleLines: number;
+    /** Maximum scroll offset */
+    maxOffset: number;
+    /** Whether we're at the top */
+    atTop: boolean;
+    /** Whether we're at the bottom */
+    atBottom: boolean;
+    /** Scroll percentage (0-100) */
+    scrollPercent: number;
+}
+/**
+ * Visible content from the scroll view.
+ */
+export interface ScrollViewport {
+    /** Lines currently visible */
+    lines: string[];
+    /** Scroll position info */
+    position: ScrollPosition;
+    /** Whether content was truncated during wrapping */
+    contentTruncated: boolean;
+}
+/**
+ * ScrollView provides a scrollable viewport into long wrapped text.
+ *
+ * Unlike pagination (discrete pages), scrolling allows continuous
+ * movement through content line by line.
+ *
+ * @example
+ * ```typescript
+ * const scrollView = new ScrollView(measurer, wrapper)
+ * scrollView.setContent("Very long text that wraps to many lines...")
+ *
+ * // Get initial view (top)
+ * let view = scrollView.getViewport()
+ * console.log(view.lines) // First 5 lines
+ *
+ * // Scroll down
+ * scrollView.scrollDown(2) // Move down 2 lines
+ * view = scrollView.getViewport()
+ *
+ * // Scroll to bottom
+ * scrollView.scrollToBottom()
+ *
+ * // Scroll to specific position
+ * scrollView.scrollTo(10) // Line 10 at top of viewport
+ * ```
+ */
+export declare class ScrollView {
+    private readonly measurer;
+    private readonly wrapper;
+    private readonly profile;
+    private readonly viewportSize;
+    private allLines;
+    private wrapResult;
+    private scrollOffset;
+    constructor(measurer: TextMeasurer, wrapper: TextWrapper, viewportSize?: number);
+    /**
+     * Set the content to display in the scroll view.
+     * Wraps the text and resets scroll position to top.
+     *
+     * @param text - Text content to display
+     * @param options - Optional wrap options
+     */
+    setContent(text: string, options?: Omit<WrapOptions, "maxLines">): void;
+    /**
+     * Append content to the existing scroll view.
+     * Useful for streaming/live content like captions.
+     *
+     * @param text - Text to append
+     * @param options - Optional wrap options
+     * @param autoScroll - If true, scroll to show new content (default: true)
+     */
+    appendContent(text: string, options?: Omit<WrapOptions, "maxLines">, autoScroll?: boolean): void;
+    /**
+     * Get the current viewport (visible lines).
+     */
+    getViewport(): ScrollViewport;
+    /**
+     * Get current scroll position information.
+     */
+    getPosition(): ScrollPosition;
+    /**
+     * Scroll to a specific line offset.
+     *
+     * @param offset - Line offset (0 = top)
+     */
+    scrollTo(offset: number): void;
+    /**
+     * Scroll down by a number of lines.
+     *
+     * @param lines - Number of lines to scroll (default: 1)
+     */
+    scrollDown(lines?: number): void;
+    /**
+     * Scroll up by a number of lines.
+     *
+     * @param lines - Number of lines to scroll (default: 1)
+     */
+    scrollUp(lines?: number): void;
+    /**
+     * Scroll down by one viewport (page down).
+     */
+    pageDown(): void;
+    /**
+     * Scroll up by one viewport (page up).
+     */
+    pageUp(): void;
+    /**
+     * Scroll to the top.
+     */
+    scrollToTop(): void;
+    /**
+     * Scroll to the bottom.
+     */
+    scrollToBottom(): void;
+    /**
+     * Scroll to show a specific line in the viewport.
+     *
+     * @param lineIndex - The line index to show
+     * @param position - Where in viewport: 'top', 'center', 'bottom' (default: 'top')
+     */
+    scrollToLine(lineIndex: number, position?: "top" | "center" | "bottom"): void;
+    /**
+     * Scroll by a percentage of total content.
+     *
+     * @param percent - Percentage (0-100)
+     */
+    scrollToPercent(percent: number): void;
+    /**
+     * Check if currently at the top.
+     */
+    isAtTop(): boolean;
+    /**
+     * Check if currently at the bottom.
+     */
+    isAtBottom(): boolean;
+    /**
+     * Check if content is scrollable (more lines than viewport).
+     */
+    isScrollable(): boolean;
+    /**
+     * Get all lines (not just visible).
+     */
+    getAllLines(): string[];
+    /**
+     * Get total line count.
+     */
+    getTotalLines(): number;
+    /**
+     * Get the viewport size.
+     */
+    getViewportSize(): number;
+    /**
+     * Clear all content and reset scroll position.
+     */
+    clear(): void;
+    /**
+     * Get the measurer instance.
+     */
+    getMeasurer(): TextMeasurer;
+    /**
+     * Get the wrapper instance.
+     */
+    getWrapper(): TextWrapper;
+    /**
+     * Get the display profile.
+     */
+    getProfile(): DisplayProfile;
+}
+//# sourceMappingURL=ScrollView.d.ts.map

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

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

package/build/utils/display/helpers/ScrollView.js

@@ -0,0 +1,257 @@
+/**
+ * ScrollView provides a scrollable viewport into long wrapped text.
+ *
+ * Unlike pagination (discrete pages), scrolling allows continuous
+ * movement through content line by line.
+ *
+ * @example
+ * ```typescript
+ * const scrollView = new ScrollView(measurer, wrapper)
+ * scrollView.setContent("Very long text that wraps to many lines...")
+ *
+ * // Get initial view (top)
+ * let view = scrollView.getViewport()
+ * console.log(view.lines) // First 5 lines
+ *
+ * // Scroll down
+ * scrollView.scrollDown(2) // Move down 2 lines
+ * view = scrollView.getViewport()
+ *
+ * // Scroll to bottom
+ * scrollView.scrollToBottom()
+ *
+ * // Scroll to specific position
+ * scrollView.scrollTo(10) // Line 10 at top of viewport
+ * ```
+ */
+export class ScrollView {
+    measurer;
+    wrapper;
+    profile;
+    viewportSize;
+    allLines = [];
+    wrapResult = null;
+    scrollOffset = 0;
+    constructor(measurer, wrapper, viewportSize) {
+        this.measurer = measurer;
+        this.wrapper = wrapper;
+        this.profile = measurer.getProfile();
+        this.viewportSize = viewportSize ?? this.profile.maxLines;
+    }
+    /**
+     * Set the content to display in the scroll view.
+     * Wraps the text and resets scroll position to top.
+     *
+     * @param text - Text content to display
+     * @param options - Optional wrap options
+     */
+    setContent(text, options) {
+        // Wrap without line limit to get all lines
+        this.wrapResult = this.wrapper.wrap(text, {
+            ...options,
+            maxLines: Infinity,
+            maxBytes: Infinity,
+        });
+        this.allLines = this.wrapResult.lines;
+        this.scrollOffset = 0;
+    }
+    /**
+     * Append content to the existing scroll view.
+     * Useful for streaming/live content like captions.
+     *
+     * @param text - Text to append
+     * @param options - Optional wrap options
+     * @param autoScroll - If true, scroll to show new content (default: true)
+     */
+    appendContent(text, options, autoScroll = true) {
+        const wasAtBottom = this.isAtBottom();
+        // Wrap the new text
+        const newResult = this.wrapper.wrap(text, {
+            ...options,
+            maxLines: Infinity,
+            maxBytes: Infinity,
+        });
+        // Append new lines
+        this.allLines = [...this.allLines, ...newResult.lines];
+        // Auto-scroll to bottom if we were already there
+        if (autoScroll && wasAtBottom) {
+            this.scrollToBottom();
+        }
+    }
+    /**
+     * Get the current viewport (visible lines).
+     */
+    getViewport() {
+        const visibleLines = this.allLines.slice(this.scrollOffset, this.scrollOffset + this.viewportSize);
+        // Pad to viewport size if needed
+        while (visibleLines.length < this.viewportSize) {
+            visibleLines.push("");
+        }
+        return {
+            lines: visibleLines,
+            position: this.getPosition(),
+            contentTruncated: this.wrapResult?.truncated ?? false,
+        };
+    }
+    /**
+     * Get current scroll position information.
+     */
+    getPosition() {
+        const totalLines = this.allLines.length;
+        const maxOffset = Math.max(0, totalLines - this.viewportSize);
+        return {
+            offset: this.scrollOffset,
+            totalLines,
+            visibleLines: this.viewportSize,
+            maxOffset,
+            atTop: this.scrollOffset === 0,
+            atBottom: this.scrollOffset >= maxOffset,
+            scrollPercent: maxOffset > 0 ? Math.round((this.scrollOffset / maxOffset) * 100) : 100,
+        };
+    }
+    /**
+     * Scroll to a specific line offset.
+     *
+     * @param offset - Line offset (0 = top)
+     */
+    scrollTo(offset) {
+        const maxOffset = Math.max(0, this.allLines.length - this.viewportSize);
+        this.scrollOffset = Math.max(0, Math.min(offset, maxOffset));
+    }
+    /**
+     * Scroll down by a number of lines.
+     *
+     * @param lines - Number of lines to scroll (default: 1)
+     */
+    scrollDown(lines = 1) {
+        this.scrollTo(this.scrollOffset + lines);
+    }
+    /**
+     * Scroll up by a number of lines.
+     *
+     * @param lines - Number of lines to scroll (default: 1)
+     */
+    scrollUp(lines = 1) {
+        this.scrollTo(this.scrollOffset - lines);
+    }
+    /**
+     * Scroll down by one viewport (page down).
+     */
+    pageDown() {
+        this.scrollDown(this.viewportSize);
+    }
+    /**
+     * Scroll up by one viewport (page up).
+     */
+    pageUp() {
+        this.scrollUp(this.viewportSize);
+    }
+    /**
+     * Scroll to the top.
+     */
+    scrollToTop() {
+        this.scrollOffset = 0;
+    }
+    /**
+     * Scroll to the bottom.
+     */
+    scrollToBottom() {
+        const maxOffset = Math.max(0, this.allLines.length - this.viewportSize);
+        this.scrollOffset = maxOffset;
+    }
+    /**
+     * Scroll to show a specific line in the viewport.
+     *
+     * @param lineIndex - The line index to show
+     * @param position - Where in viewport: 'top', 'center', 'bottom' (default: 'top')
+     */
+    scrollToLine(lineIndex, position = "top") {
+        let targetOffset;
+        switch (position) {
+            case "top":
+                targetOffset = lineIndex;
+                break;
+            case "center":
+                targetOffset = lineIndex - Math.floor(this.viewportSize / 2);
+                break;
+            case "bottom":
+                targetOffset = lineIndex - this.viewportSize + 1;
+                break;
+        }
+        this.scrollTo(targetOffset);
+    }
+    /**
+     * Scroll by a percentage of total content.
+     *
+     * @param percent - Percentage (0-100)
+     */
+    scrollToPercent(percent) {
+        const maxOffset = Math.max(0, this.allLines.length - this.viewportSize);
+        const targetOffset = Math.round((percent / 100) * maxOffset);
+        this.scrollTo(targetOffset);
+    }
+    /**
+     * Check if currently at the top.
+     */
+    isAtTop() {
+        return this.scrollOffset === 0;
+    }
+    /**
+     * Check if currently at the bottom.
+     */
+    isAtBottom() {
+        const maxOffset = Math.max(0, this.allLines.length - this.viewportSize);
+        return this.scrollOffset >= maxOffset;
+    }
+    /**
+     * Check if content is scrollable (more lines than viewport).
+     */
+    isScrollable() {
+        return this.allLines.length > this.viewportSize;
+    }
+    /**
+     * Get all lines (not just visible).
+     */
+    getAllLines() {
+        return [...this.allLines];
+    }
+    /**
+     * Get total line count.
+     */
+    getTotalLines() {
+        return this.allLines.length;
+    }
+    /**
+     * Get the viewport size.
+     */
+    getViewportSize() {
+        return this.viewportSize;
+    }
+    /**
+     * Clear all content and reset scroll position.
+     */
+    clear() {
+        this.allLines = [];
+        this.wrapResult = null;
+        this.scrollOffset = 0;
+    }
+    /**
+     * Get the measurer instance.
+     */
+    getMeasurer() {
+        return this.measurer;
+    }
+    /**
+     * Get the wrapper instance.
+     */
+    getWrapper() {
+        return this.wrapper;
+    }
+    /**
+     * Get the display profile.
+     */
+    getProfile() {
+        return this.profile;
+    }
+}
+//# sourceMappingURL=ScrollView.js.map

package/build/utils/display/helpers/ScrollView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollView.js","sourceRoot":"","sources":["../../../../src/utils/display/helpers/ScrollView.ts"],"names":[],"mappings":"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","sourcesContent":["import type {DisplayProfile} from \"../profiles/types\"\nimport {TextMeasurer} from \"../measurer/TextMeasurer\"\nimport {TextWrapper} from \"../wrapper/TextWrapper\"\nimport type {WrapOptions, WrapResult} from \"../wrapper/types\"\n\n/**\n * Scroll position information.\n */\nexport interface ScrollPosition {\n  /** Current scroll offset (0 = top) */\n  offset: number\n  /** Total number of lines in content */\n  totalLines: number\n  /** Number of visible lines (viewport size) */\n  visibleLines: number\n  /** Maximum scroll offset */\n  maxOffset: number\n  /** Whether we're at the top */\n  atTop: boolean\n  /** Whether we're at the bottom */\n  atBottom: boolean\n  /** Scroll percentage (0-100) */\n  scrollPercent: number\n}\n\n/**\n * Visible content from the scroll view.\n */\nexport interface ScrollViewport {\n  /** Lines currently visible */\n  lines: string[]\n  /** Scroll position info */\n  position: ScrollPosition\n  /** Whether content was truncated during wrapping */\n  contentTruncated: boolean\n}\n\n/**\n * ScrollView provides a scrollable viewport into long wrapped text.\n *\n * Unlike pagination (discrete pages), scrolling allows continuous\n * movement through content line by line.\n *\n * @example\n * ```typescript\n * const scrollView = new ScrollView(measurer, wrapper)\n * scrollView.setContent(\"Very long text that wraps to many lines...\")\n *\n * // Get initial view (top)\n * let view = scrollView.getViewport()\n * console.log(view.lines) // First 5 lines\n *\n * // Scroll down\n * scrollView.scrollDown(2) // Move down 2 lines\n * view = scrollView.getViewport()\n *\n * // Scroll to bottom\n * scrollView.scrollToBottom()\n *\n * // Scroll to specific position\n * scrollView.scrollTo(10) // Line 10 at top of viewport\n * ```\n */\nexport class ScrollView {\n  private readonly measurer: TextMeasurer\n  private readonly wrapper: TextWrapper\n  private readonly profile: DisplayProfile\n  private readonly viewportSize: number\n\n  private allLines: string[] = []\n  private wrapResult: WrapResult | null = null\n  private scrollOffset: number = 0\n\n  constructor(\n    measurer: TextMeasurer,\n    wrapper: TextWrapper,\n    viewportSize?: number\n  ) {\n    this.measurer = measurer\n    this.wrapper = wrapper\n    this.profile = measurer.getProfile()\n    this.viewportSize = viewportSize ?? this.profile.maxLines\n  }\n\n  /**\n   * Set the content to display in the scroll view.\n   * Wraps the text and resets scroll position to top.\n   *\n   * @param text - Text content to display\n   * @param options - Optional wrap options\n   */\n  setContent(text: string, options?: Omit<WrapOptions, \"maxLines\">): void {\n    // Wrap without line limit to get all lines\n    this.wrapResult = this.wrapper.wrap(text, {\n      ...options,\n      maxLines: Infinity,\n      maxBytes: Infinity,\n    })\n    this.allLines = this.wrapResult.lines\n    this.scrollOffset = 0\n  }\n\n  /**\n   * Append content to the existing scroll view.\n   * Useful for streaming/live content like captions.\n   *\n   * @param text - Text to append\n   * @param options - Optional wrap options\n   * @param autoScroll - If true, scroll to show new content (default: true)\n   */\n  appendContent(\n    text: string,\n    options?: Omit<WrapOptions, \"maxLines\">,\n    autoScroll: boolean = true\n  ): void {\n    const wasAtBottom = this.isAtBottom()\n\n    // Wrap the new text\n    const newResult = this.wrapper.wrap(text, {\n      ...options,\n      maxLines: Infinity,\n      maxBytes: Infinity,\n    })\n\n    // Append new lines\n    this.allLines = [...this.allLines, ...newResult.lines]\n\n    // Auto-scroll to bottom if we were already there\n    if (autoScroll && wasAtBottom) {\n      this.scrollToBottom()\n    }\n  }\n\n  /**\n   * Get the current viewport (visible lines).\n   */\n  getViewport(): ScrollViewport {\n    const visibleLines = this.allLines.slice(\n      this.scrollOffset,\n      this.scrollOffset + this.viewportSize\n    )\n\n    // Pad to viewport size if needed\n    while (visibleLines.length < this.viewportSize) {\n      visibleLines.push(\"\")\n    }\n\n    return {\n      lines: visibleLines,\n      position: this.getPosition(),\n      contentTruncated: this.wrapResult?.truncated ?? false,\n    }\n  }\n\n  /**\n   * Get current scroll position information.\n   */\n  getPosition(): ScrollPosition {\n    const totalLines = this.allLines.length\n    const maxOffset = Math.max(0, totalLines - this.viewportSize)\n\n    return {\n      offset: this.scrollOffset,\n      totalLines,\n      visibleLines: this.viewportSize,\n      maxOffset,\n      atTop: this.scrollOffset === 0,\n      atBottom: this.scrollOffset >= maxOffset,\n      scrollPercent: maxOffset > 0 ? Math.round((this.scrollOffset / maxOffset) * 100) : 100,\n    }\n  }\n\n  /**\n   * Scroll to a specific line offset.\n   *\n   * @param offset - Line offset (0 = top)\n   */\n  scrollTo(offset: number): void {\n    const maxOffset = Math.max(0, this.allLines.length - this.viewportSize)\n    this.scrollOffset = Math.max(0, Math.min(offset, maxOffset))\n  }\n\n  /**\n   * Scroll down by a number of lines.\n   *\n   * @param lines - Number of lines to scroll (default: 1)\n   */\n  scrollDown(lines: number = 1): void {\n    this.scrollTo(this.scrollOffset + lines)\n  }\n\n  /**\n   * Scroll up by a number of lines.\n   *\n   * @param lines - Number of lines to scroll (default: 1)\n   */\n  scrollUp(lines: number = 1): void {\n    this.scrollTo(this.scrollOffset - lines)\n  }\n\n  /**\n   * Scroll down by one viewport (page down).\n   */\n  pageDown(): void {\n    this.scrollDown(this.viewportSize)\n  }\n\n  /**\n   * Scroll up by one viewport (page up).\n   */\n  pageUp(): void {\n    this.scrollUp(this.viewportSize)\n  }\n\n  /**\n   * Scroll to the top.\n   */\n  scrollToTop(): void {\n    this.scrollOffset = 0\n  }\n\n  /**\n   * Scroll to the bottom.\n   */\n  scrollToBottom(): void {\n    const maxOffset = Math.max(0, this.allLines.length - this.viewportSize)\n    this.scrollOffset = maxOffset\n  }\n\n  /**\n   * Scroll to show a specific line in the viewport.\n   *\n   * @param lineIndex - The line index to show\n   * @param position - Where in viewport: 'top', 'center', 'bottom' (default: 'top')\n   */\n  scrollToLine(lineIndex: number, position: \"top\" | \"center\" | \"bottom\" = \"top\"): void {\n    let targetOffset: number\n\n    switch (position) {\n      case \"top\":\n        targetOffset = lineIndex\n        break\n      case \"center\":\n        targetOffset = lineIndex - Math.floor(this.viewportSize / 2)\n        break\n      case \"bottom\":\n        targetOffset = lineIndex - this.viewportSize + 1\n        break\n    }\n\n    this.scrollTo(targetOffset)\n  }\n\n  /**\n   * Scroll by a percentage of total content.\n   *\n   * @param percent - Percentage (0-100)\n   */\n  scrollToPercent(percent: number): void {\n    const maxOffset = Math.max(0, this.allLines.length - this.viewportSize)\n    const targetOffset = Math.round((percent / 100) * maxOffset)\n    this.scrollTo(targetOffset)\n  }\n\n  /**\n   * Check if currently at the top.\n   */\n  isAtTop(): boolean {\n    return this.scrollOffset === 0\n  }\n\n  /**\n   * Check if currently at the bottom.\n   */\n  isAtBottom(): boolean {\n    const maxOffset = Math.max(0, this.allLines.length - this.viewportSize)\n    return this.scrollOffset >= maxOffset\n  }\n\n  /**\n   * Check if content is scrollable (more lines than viewport).\n   */\n  isScrollable(): boolean {\n    return this.allLines.length > this.viewportSize\n  }\n\n  /**\n   * Get all lines (not just visible).\n   */\n  getAllLines(): string[] {\n    return [...this.allLines]\n  }\n\n  /**\n   * Get total line count.\n   */\n  getTotalLines(): number {\n    return this.allLines.length\n  }\n\n  /**\n   * Get the viewport size.\n   */\n  getViewportSize(): number {\n    return this.viewportSize\n  }\n\n  /**\n   * Clear all content and reset scroll position.\n   */\n  clear(): void {\n    this.allLines = []\n    this.wrapResult = null\n    this.scrollOffset = 0\n  }\n\n  /**\n   * Get the measurer instance.\n   */\n  getMeasurer(): TextMeasurer {\n    return this.measurer\n  }\n\n  /**\n   * Get the wrapper instance.\n   */\n  getWrapper(): TextWrapper {\n    return this.wrapper\n  }\n\n  /**\n   * Get the display profile.\n   */\n  getProfile(): DisplayProfile {\n    return this.profile\n  }\n}\n"]}

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

@@ -0,0 +1,11 @@
+/**
+ * Display Helpers Module
+ *
+ * Optional convenience utilities for common display operations.
+ * Built on top of TextMeasurer and TextWrapper.
+ */
+export { DisplayHelpers } from "./DisplayHelpers";
+export { ScrollView } from "./ScrollView";
+export type { TruncateResult, Page, Chunk } from "./DisplayHelpers";
+export type { ScrollPosition, ScrollViewport } from "./ScrollView";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/display/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAA;AAGvC,YAAY,EAAC,cAAc,EAAE,IAAI,EAAE,KAAK,EAAC,MAAM,kBAAkB,CAAA;AACjE,YAAY,EAAC,cAAc,EAAE,cAAc,EAAC,MAAM,cAAc,CAAA"}

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

@@ -0,0 +1,10 @@
+/**
+ * Display Helpers Module
+ *
+ * Optional convenience utilities for common display operations.
+ * Built on top of TextMeasurer and TextWrapper.
+ */
+// Main classes
+export { DisplayHelpers } from "./DisplayHelpers";
+export { ScrollView } from "./ScrollView";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/display/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAe;AACf,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAA","sourcesContent":["/**\n * Display Helpers Module\n *\n * Optional convenience utilities for common display operations.\n * Built on top of TextMeasurer and TextWrapper.\n */\n\n// Main classes\nexport {DisplayHelpers} from \"./DisplayHelpers\"\nexport {ScrollView} from \"./ScrollView\"\n\n// Types\nexport type {TruncateResult, Page, Chunk} from \"./DisplayHelpers\"\nexport type {ScrollPosition, ScrollViewport} from \"./ScrollView\"\n"]}

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

@@ -0,0 +1,174 @@
+/**
+ * @mentra/display-utils
+ *
+ * Glasses-agnostic, pixel-accurate text measurement and wrapping library
+ * for smart glasses displays.
+ *
+ * Key features:
+ * - Pixel-perfect measurement (no abstract units or averages)
+ * - Multiple break modes (character, word, strict-word)
+ * - Full script support (Latin, CJK, Korean, Cyrillic)
+ * - Configurable display profiles for different glasses hardware
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   TextMeasurer,
+ *   TextWrapper,
+ *   DisplayHelpers,
+ *   G1_PROFILE
+ * } from '@mentra/display-utils'
+ *
+ * // Create measurer and wrapper for G1 glasses
+ * const measurer = new TextMeasurer(G1_PROFILE)
+ * const wrapper = new TextWrapper(measurer, { breakMode: 'character' })
+ * const helpers = new DisplayHelpers(measurer, wrapper)
+ *
+ * // Wrap text for display
+ * const result = wrapper.wrap("Hello, world! This is a long text.")
+ * console.log(result.lines)
+ * // ["Hello, world! This is a long text th-", "at needs wrapping."]
+ * ```
+ */
+export type { DisplayProfile, FontMetrics, UniformScriptWidths, FallbackConfig, DisplayConstraints, ScriptType, } from "./profiles";
+export { G1_PROFILE, G1_PROFILE_LEGACY, G1_HYPHEN_WIDTH_PX, G1_SPACE_WIDTH_PX } from "./profiles";
+export { G2_PROFILE, G2_HYPHEN_WIDTH_PX, G2_SPACE_WIDTH_PX } from "./profiles";
+export { Z100_PROFILE, Z100_HYPHEN_WIDTH_PX, Z100_SPACE_WIDTH_PX } from "./profiles";
+export { 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 } from "./wrapper";
+export type { WrapOptions, WrapResult, LineMetrics, BreakMode } from "./wrapper";
+export { DEFAULT_WRAP_OPTIONS } from "./wrapper";
+export { DisplayHelpers, ScrollView } from "./helpers";
+export type { TruncateResult, Page, Chunk, ScrollPosition, ScrollViewport } from "./helpers";
+export { ColumnComposer, createColumnComposer } from "./composer";
+export type { ColumnConfig, ComposeOptions, ComposeResult } from "./composer";
+import { TextMeasurer } from "./measurer";
+import { TextWrapper } from "./wrapper";
+import { DisplayHelpers } from "./helpers";
+import { ColumnComposer } from "./composer";
+import type { DisplayProfile } from "./profiles";
+import type { WrapOptions } from "./wrapper";
+/**
+ * Create a complete display toolkit for a given profile.
+ *
+ * @param profile - Display profile (defaults to G1)
+ * @param wrapOptions - Default wrap options
+ * @returns Object with measurer, wrapper, and helpers
+ *
+ * @example
+ * ```typescript
+ * const { measurer, wrapper, helpers } = createDisplayToolkit()
+ * const lines = wrapper.wrapToLines("Hello, world!")
+ * ```
+ */
+export declare function createDisplayToolkit(profile?: DisplayProfile, wrapOptions?: WrapOptions): {
+    measurer: TextMeasurer;
+    wrapper: TextWrapper;
+    helpers: DisplayHelpers;
+    composer: ColumnComposer;
+    profile: DisplayProfile;
+};
+/**
+ * Create a G1-configured display toolkit with character breaking.
+ * This is the recommended setup for captions and similar high-utilization use cases.
+ *
+ * @returns Object with measurer, wrapper, and helpers configured for G1
+ *
+ * @example
+ * ```typescript
+ * const { wrapper, composer } = createG1Toolkit()
+ * const result = wrapper.wrap("Your text here")
+ * const columns = composer.composeDoubleTextWall("Left", "Right")
+ * ```
+ */
+export declare function createG1Toolkit(): {
+    measurer: TextMeasurer;
+    wrapper: TextWrapper;
+    helpers: DisplayHelpers;
+    composer: ColumnComposer;
+    profile: DisplayProfile;
+};
+/**
+ * Create a G1-configured display toolkit for LEGACY mobile clients.
+ *
+ * Use this when the mobile client has old wrapping logic that re-wraps
+ * text received from the cloud. This profile uses a reduced display width
+ * (~522px instead of 576px) to prevent double-wrapping overflow.
+ *
+ * @returns Object with measurer, wrapper, and helpers configured for legacy G1 clients
+ *
+ * @example
+ * ```typescript
+ * // For old mobile clients that double-wrap
+ * const { wrapper } = createG1LegacyToolkit()
+ * const result = wrapper.wrap("Your text here")
+ * // Lines will be shorter to account for mobile re-wrapping
+ * ```
+ */
+export declare function createG1LegacyToolkit(): {
+    measurer: TextMeasurer;
+    wrapper: TextWrapper;
+    helpers: DisplayHelpers;
+    composer: ColumnComposer;
+    profile: DisplayProfile;
+};
+/**
+ * Create a G2-configured display toolkit with character breaking.
+ * G2 uses EvenHub protocol with the same display hardware as G1.
+ *
+ * @returns Object with measurer, wrapper, and helpers configured for Even G2
+ *
+ * @example
+ * ```typescript
+ * const { wrapper } = createG2Toolkit()
+ * const result = wrapper.wrap("Your text here")
+ * ```
+ */
+export declare function createG2Toolkit(): {
+    measurer: TextMeasurer;
+    wrapper: TextWrapper;
+    helpers: DisplayHelpers;
+    composer: ColumnComposer;
+    profile: DisplayProfile;
+};
+/**
+ * Create a Z100-configured display toolkit with character breaking.
+ *
+ * @returns Object with measurer, wrapper, and helpers configured for Vuzix Z100
+ *
+ * @example
+ * ```typescript
+ * const { wrapper } = createZ100Toolkit()
+ * const result = wrapper.wrap("Your text here")
+ * ```
+ */
+export declare function createZ100Toolkit(): {
+    measurer: TextMeasurer;
+    wrapper: TextWrapper;
+    helpers: DisplayHelpers;
+    composer: ColumnComposer;
+    profile: DisplayProfile;
+};
+/**
+ * Create a Mentra Nex-configured display toolkit with character breaking.
+ * Also known as "Mentra Display".
+ *
+ * @returns Object with measurer, wrapper, and helpers configured for Mentra Nex
+ *
+ * @example
+ * ```typescript
+ * const { wrapper } = createNexToolkit()
+ * const result = wrapper.wrap("Your text here")
+ * ```
+ */
+export declare function createNexToolkit(): {
+    measurer: TextMeasurer;
+    wrapper: TextWrapper;
+    helpers: DisplayHelpers;
+    composer: ColumnComposer;
+    profile: DisplayProfile;
+};
+//# sourceMappingURL=index.d.ts.map