@glassly/miniapp 0.3.0-dev.1 → 0.3.0-dev.460

package/dist/display/scene/types.d.ts

@@ -0,0 +1,292 @@
+/**
+ * Scene pipeline types — the host half of the miniapp `render()` display API.
+ *
+ * A miniapp describes a full frame ("scene") of positioned elements; the host
+ * clamps/budgets/wraps it, diffs it against the last frame sent to the device,
+ * and ships ONE annotated SceneFrame over the bridge. SGCs either walk the
+ * per-element annotations (G2, Mentra Display) or serialize the whole frame
+ * (full-frame devices). Spec: notes/miniapp-display-render-implementation-spec.md
+ */
+export interface SceneBox {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** Canvas corner a box's x/y are measured from (insets grow inward). */
+export type SceneAnchor = "top-left" | "top-right" | "bottom-left" | "bottom-right";
+/**
+ * A box as it arrives from the miniapp SDK: optionally corner-anchored.
+ * `resolveAnchors` turns these into plain top-left SceneBoxes against the
+ * device's real canvas before any processing/degrading — anchors never reach
+ * FrameElement, the differ, or the wire.
+ */
+export interface SceneBoxInput extends SceneBox {
+    anchor?: SceneAnchor;
+}
+export type SceneBreakMode = "character" | "character-no-hyphen" | "word" | "strict-word";
+export interface SceneTextStyle {
+    /** Border width in px (0/absent = none). */
+    border?: number;
+    /** Border corner radius in px. */
+    radius?: number;
+    /** What happens to text that doesn't fit the box after wrapping. Default "clip". */
+    overflow?: "clip" | "ellipsis";
+    /** Line-break policy for wrapping. */
+    breakMode?: SceneBreakMode;
+    /**
+     * "mono": fixed-pitch at `fontSize` px, lines taken as given (no host wrap).
+     * "builtin": drawn by the glasses' own 20 px font engine (Glassly CFW G2);
+     * lines taken as given, other devices fall back to the default face.
+     */
+    font?: "default" | "mono" | "builtin";
+    fontSize?: number;
+    /** Gray level 0..15 for device-drawn text. */
+    color?: number;
+}
+export interface SceneRectStyle {
+    border?: number;
+    radius?: number;
+    /** Solid fill instead of an outline. */
+    fill?: boolean;
+    /** Gray level 0..15 (15 = brightest). Default 15. */
+    color?: number;
+}
+/** Closed shapes (circle, triangle, quad): outline of `border` px, or filled. */
+export interface SceneShapeStyle {
+    border?: number;
+    fill?: boolean;
+    color?: number;
+}
+/** Images: gray level 0..15 the pixels scale to (15 = as drawn); tweens on devices that fade textures. */
+export interface SceneImageStyle {
+    color?: number;
+}
+/** Open strokes (line, bezier, arc). */
+export interface SceneStrokeStyle {
+    width?: number;
+    color?: number;
+}
+export interface ScenePoint {
+    x: number;
+    y: number;
+}
+export type SceneEasing = "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out";
+/** Animate geometry changes of an element with a stable id (devices with `animation`). */
+export interface SceneTransition {
+    durationMs: number;
+    easing?: SceneEasing;
+}
+export type SceneShape = "rect" | "circle" | "arc" | "pie" | "line" | "triangle" | "quad" | "bezier" | "svg";
+/** A scene element as it arrives from the miniapp SDK (pre-processing). */
+export type SceneElementInput = ({
+    type: "text";
+    id?: string;
+    box: SceneBoxInput;
+    text: string;
+    style?: SceneTextStyle;
+    transition?: SceneTransition;
+} | {
+    type: "image";
+    id?: string;
+    box: SceneBoxInput;
+    data: string;
+    style?: SceneImageStyle;
+    transition?: SceneTransition;
+} | {
+    type: "rect";
+    id?: string;
+    box: SceneBoxInput;
+    style?: SceneRectStyle;
+    transition?: SceneTransition;
+} | {
+    type: "circle";
+    id?: string;
+    box: SceneBoxInput;
+    style?: SceneShapeStyle;
+    transition?: SceneTransition;
+} | {
+    type: "arc";
+    id?: string;
+    box: SceneBoxInput;
+    startDeg: number;
+    endDeg: number;
+    style?: SceneStrokeStyle;
+    transition?: SceneTransition;
+} | {
+    type: "pie";
+    id?: string;
+    box: SceneBoxInput;
+    startDeg: number;
+    endDeg: number;
+    style?: {
+        color?: number;
+    };
+    transition?: SceneTransition;
+} | {
+    type: "line";
+    id?: string;
+    points: ScenePoint[];
+    box?: SceneBoxInput;
+    style?: SceneStrokeStyle;
+    transition?: SceneTransition;
+} | {
+    type: "triangle";
+    id?: string;
+    points: ScenePoint[];
+    box?: SceneBoxInput;
+    style?: SceneShapeStyle;
+    transition?: SceneTransition;
+} | {
+    type: "quad";
+    id?: string;
+    points: ScenePoint[];
+    box?: SceneBoxInput;
+    style?: SceneShapeStyle;
+    transition?: SceneTransition;
+} | {
+    type: "bezier";
+    id?: string;
+    points: ScenePoint[];
+    box?: SceneBoxInput;
+    style?: SceneStrokeStyle;
+    transition?: SceneTransition;
+} | {
+    type: "svg";
+    id?: string;
+    box: SceneBoxInput;
+    d: string;
+    scale?: number;
+    fillRule?: "nonzero" | "evenodd";
+    style?: {
+        color?: number;
+    };
+    transition?: SceneTransition;
+}) & {
+    /** Clockwise degrees, unwrapped (0 to 360 makes a full turn). Geometric shapes and SVG only. */
+    rotation?: number;
+    /** Fixed pivot in canvas pixels; defaults to the target box center. */
+    pivot?: ScenePoint;
+    /** Stereo depth in canvas pixels (±MAX_SCENE_DEPTH): positive is nearer the viewer. */
+    depth?: number;
+};
+export type SceneElementType = SceneElementInput["type"];
+/** Largest per-lens disparity an element may ask for, in canvas pixels. */
+export declare const MAX_SCENE_DEPTH = 16;
+export type SceneElementStyle = SceneTextStyle | SceneRectStyle | SceneShapeStyle | SceneStrokeStyle | SceneImageStyle | {
+    color?: number;
+};
+/** Elements positioned by a point list; the host derives `box` (their bounding box) before processing. */
+export declare const POINT_SHAPE_TYPES: readonly SceneElementType[];
+/** Point counts each point shape accepts. */
+export declare const POINT_SHAPE_ARITY: Record<string, readonly number[]>;
+export type SceneChange = "created" | "updated" | "moved" | "unchanged";
+/**
+ * A processed element inside a SceneFrame: id definitely assigned, box clamped,
+ * text pre-wrapped (newlines inserted), annotated with what changed vs the last
+ * frame sent to this device.
+ */
+export interface FrameElement {
+    /** SVG path and its checked firmware command stream (Q4 coordinates). */
+    d?: string;
+    path?: number[];
+    pathScale?: number;
+    fillRule?: "nonzero" | "evenodd";
+    rotation?: number;
+    pivot?: ScenePoint;
+    /** Stereo disparity in px (left lens +depth, right lens -depth); absent = the frame's plane. */
+    depth?: number;
+    id: string;
+    type: SceneElementType;
+    box: SceneBox;
+    text?: string;
+    /** Image pixels, base64 (PNG documented; SGCs decode → re-encode to wire format and scale to box). */
+    data?: string;
+    style?: SceneElementStyle;
+    /** Point shapes: the points, in canvas pixels; `box` is their bounding box. */
+    points?: ScenePoint[];
+    startDeg?: number;
+    endDeg?: number;
+    transition?: SceneTransition;
+    change: SceneChange;
+    /** Hash of the element's content (text/data + style) — lets SGCs skip BLE re-upload without retaining pixels. */
+    contentHash: string;
+}
+/** The unit that crosses the JS→native bridge: one whole frame per render(). */
+export interface SceneFrame {
+    appId: string;
+    view: "main" | "dashboard";
+    /** Bumps on replay / app switch / reconnect; a bumped epoch bypasses native dedup. */
+    sceneEpoch: number;
+    /**
+     * Host-wide monotonic frame number. Native reports it back in
+     * `scene_frame_presented` once the device has the frame; a report for N
+     * also covers every earlier frame (the native pacer folds unsent frames
+     * into the next one, so their content is on the glasses by then).
+     */
+    seq: number;
+    /** True when the device is expected to rebuild from scratch (all elements arrive "created"). */
+    replay?: boolean;
+    elements: FrameElement[];
+    /** Element ids present in the previous frame but absent now — host-computed; apps never send removes. */
+    removed: string[];
+    /** Canvas the boxes were clamped against — lets a full-frame SGC place a legacy-sized frame correctly. */
+    canvas?: {
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Typed display capabilities block (host-side mirror of the SDK's
+ * DisplayCapabilities). All limits are DATA — the pipeline acts on them
+ * generically; no device names appear in pipeline code.
+ */
+export interface SceneDisplayCapabilities {
+    /** Public drawable canvas in px (the device's safe area, not the physical panel). */
+    width: number;
+    height: number;
+    /** False ⇒ scenes degrade to legacy text layouts host-side; only sugar-shaped content renders. */
+    canPosition: boolean;
+    /** Text-element budget. Rects share this pool on container-based devices. */
+    maxTextElements: number;
+    maxImageElements: number;
+    /** Max per-image dimensions the device accepts (box-level check), if limited. */
+    maxImagePx?: {
+        width: number;
+        height: number;
+    };
+    shapes: SceneShape[];
+    /** True ⇒ element transitions animate on the device. */
+    animation: boolean;
+    rotation?: boolean;
+    /** True ⇒ per-element `depth` is drawn as a lens disparity (otherwise stripped). */
+    depth?: boolean;
+    intensityLevels: number;
+    partialUpdate: boolean;
+}
+/** Result of processing a scene — feeds the awaitable render() result. */
+export interface SceneProcessResult {
+    frame: SceneFrame;
+    degraded: boolean;
+    /** Ids (or synthesized ids) of elements dropped by budget/bounds/image limits. */
+    dropped: string[];
+}
+/** Cheap stable string hash (FNV-1a, 32-bit) — content identity for diff + native dedup. */
+export declare function contentHash(...parts: (string | number | undefined)[]): string;
+export declare function boxesEqual(a: SceneBox, b: SceneBox): boolean;
+/**
+ * Content identity of an element (text/data/points/angles + style + depth),
+ * excluding its box. A nonzero depth joins the hash so a depth change is a
+ * change (the box alone does not move); zero/absent leaves the hash as before.
+ */
+export declare function elementContentHash(el: {
+    type: SceneElementType;
+    text?: string;
+    data?: string;
+    style?: SceneElementStyle;
+    points?: ScenePoint[];
+    startDeg?: number;
+    endDeg?: number;
+    depth?: number;
+}): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/display/scene/types.d.ts.map

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

package/dist/display/scene/types.js.map

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

package/dist/display/wrapper/TextWrapper.d.ts

@@ -0,0 +1,102 @@
+import { TextMeasurer } from "../measurer/TextMeasurer";
+import type { WrapOptions, WrapResult } from "./types";
+/**
+ * Wraps text to fit display constraints.
+ *
+ * Supports multiple break modes:
+ * - 'character': Break mid-word with hyphen for 100% line utilization
+ * - 'word': Break at word boundaries, hyphenate only if word > line width
+ * - 'strict-word': Break at word boundaries only, no hyphenation
+ *
+ * Key features:
+ * - Pixel-accurate wrapping (no abstract units)
+ * - Hyphen-aware breaking (accounts for hyphen width)
+ * - CJK support (breaks anywhere without hyphen)
+ * - Preserves explicit newlines
+ * - Respects byte limits for BLE transmission
+ */
+export declare class TextWrapper {
+    private readonly measurer;
+    private readonly defaultOptions;
+    constructor(measurer: TextMeasurer, defaultOptions?: WrapOptions);
+    /**
+     * Wrap text to fit within constraints.
+     *
+     * @param text - Text to wrap (may contain \n for explicit breaks)
+     * @param options - Override default options
+     * @returns Wrap result with lines and metadata
+     */
+    wrap(text: string, options?: WrapOptions): WrapResult;
+    /**
+     * Simple wrap returning just lines (convenience method).
+     *
+     * @param text - Text to wrap
+     * @param options - Override default options
+     * @returns Array of wrapped lines
+     */
+    wrapToLines(text: string, options?: WrapOptions): string[];
+    /**
+     * Check if text needs wrapping.
+     *
+     * @param text - Text to check
+     * @param maxWidthPx - Optional width override
+     * @returns true if text exceeds single line
+     */
+    needsWrap(text: string, maxWidthPx?: number): boolean;
+    /**
+     * Get current default options.
+     */
+    getOptions(): Required<WrapOptions>;
+    /**
+     * Get the measurer instance.
+     */
+    getMeasurer(): TextMeasurer;
+    /**
+     * Wrap a single paragraph (no newlines) according to break mode.
+     */
+    private wrapParagraph;
+    /**
+     * Character break mode: Break mid-word with hyphen for 100% line utilization.
+     */
+    private wrapCharacterMode;
+    /**
+     * Character break mode without hyphen: Break mid-word cleanly without adding hyphen.
+     */
+    private wrapCharacterNoHyphenMode;
+    /**
+     * Internal character break implementation with configurable hyphenation.
+     */
+    private wrapCharacterModeInternal;
+    /**
+     * Word break mode: Break at word boundaries, hyphenate only if word > line width.
+     */
+    private wrapWordMode;
+    /**
+     * Strict word break mode: Break at word boundaries only, no hyphenation.
+     * Long words will overflow the line.
+     */
+    private wrapStrictWordMode;
+    /**
+     * Split text into words, handling CJK characters specially.
+     * CJK characters are treated as individual "words" since they can break anywhere.
+     */
+    private splitIntoWords;
+    /**
+     * Hyphenate a word that's too long to fit on a single line.
+     */
+    private hyphenateLongWord;
+    /**
+     * Back off characters from line end until hyphen fits.
+     * Returns null if we back off to a space (natural break point - no hyphen needed).
+     */
+    private backoffForHyphen;
+    /**
+     * Merge user options with defaults.
+     */
+    private mergeOptions;
+    /**
+     * Create an empty result for empty input.
+     */
+    private createEmptyResult;
+}
+//# sourceMappingURL=TextWrapper.d.ts.map

package/dist/display/wrapper/TextWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextWrapper.d.ts","sourceRoot":"","sources":["../../../src/display/wrapper/TextWrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,0BAA0B,CAAA;AAErD,OAAO,KAAK,EAAC,WAAW,EAAE,UAAU,EAAyB,MAAM,SAAS,CAAA;AAG5E;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;gBAE1C,QAAQ,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,WAAW;IAahE;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,UAAU;IA2ErD;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE;IAI1D;;;;;;OAMG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO;IAKrD;;OAEG;IACH,UAAU,IAAI,QAAQ,CAAC,WAAW,CAAC;IAInC;;OAEG;IACH,WAAW,IAAI,YAAY;IAI3B;;OAEG;IACH,OAAO,CAAC,aAAa;IA+BrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAIjC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA2EjC;;OAEG;IACH,OAAO,CAAC,YAAY;IA2DpB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA4C1B;;;OAGG;IACH,OAAO,CAAC,cAAc;IA6BtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgDzB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAgCxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAoB1B"}