@glassly/miniapp 0.1.0-dev.26

package/dist/modules/camera.js

@@ -0,0 +1,119 @@
+/**
+ * @fileoverview CameraModule — glasses camera control and photo capture.
+ */
+import { MiniappRequestType } from "../protocol";
+export class CameraModule {
+    constructor(session) {
+        this.session = session;
+    }
+    /** True iff `CAMERA` is declared in the miniapp's manifest. */
+    get hasPermission() {
+        return this.session._hasManifestPermission("CAMERA");
+    }
+    /**
+     * Apply a session-owned camera FOV/ROI override on the glasses.
+     *
+     * Resolves after the ASG client reports that the setting was applied to camera
+     * hardware after the restart cooldown. The host restores the prior override or persistent base
+     * when this miniapp closes. Requires CAMERA permission declared in miniapp.json.
+     */
+    async setFov(request) {
+        return this.session.sendRequest({
+            type: MiniappRequestType.CAMERA_FOV,
+            ...request,
+        });
+    }
+    /**
+     * Take a photo via the glasses camera. Returns a URL to the captured image.
+     * Requires CAMERA permission declared in miniapp.json.
+     *
+     * The photo is uploaded to cloud storage; the returned URL is a short-TTL
+     * (~30 minute) signed download URL. If the glasses don't have a camera,
+     * the phone-side handler rejects with an error. Check
+     * `session.capabilities.hasCamera` before calling.
+     */
+    async takePhoto(options = {}) {
+        return this.session.sendRequest({
+            type: MiniappRequestType.PHOTO,
+            size: options.size ?? "medium",
+            mode: options.mode ?? "photo",
+            ...(options.transferMethod !== undefined ? { transferMethod: options.transferMethod } : {}),
+            compress: options.compress ?? "none",
+            sound: options.sound ?? true,
+            saveToGallery: options.saveToGallery ?? false,
+            exposureTimeNs: options.exposureTimeNs,
+            iso: options.iso,
+            aeExposureDivisor: options.aeExposureDivisor,
+            isoCap: options.isoCap,
+            noiseReduction: options.noiseReduction,
+            edgeEnhancement: options.edgeEnhancement,
+            zsl: options.zsl,
+            mfnr: options.mfnr,
+            ispDigitalGain: options.ispDigitalGain,
+            ispAnalogGain: options.ispAnalogGain,
+        }, options.timeoutMs != null ? { timeoutMs: options.timeoutMs } : undefined);
+    }
+    /**
+     * Pre-warm the glasses camera so the next takePhoto() is near-instant.
+     * The camera stays warm for ~durationMs (default 15s, maximum 60s); call warmUp() again to
+     * extend it. Warm with the same `size` you'll capture with — a mismatched size
+     * forces the camera to reconfigure and loses the speedup. Requires CAMERA
+     * permission in miniapp.json. Resolves once the camera reports ready. The host automatically
+     * releases this miniapp's request-owned lease when the miniapp closes.
+     *
+     * Warm-ups are serialized: only one runs at a time and none may start while a
+     * photo is being captured. If the camera is busy (a capture is in flight, or
+     * another warm-up is still opening) this rejects with `camera_busy` — retry
+     * shortly, or just call takePhoto() (it works regardless, only slower). The
+     * normal warmUp() → takePhoto() sequence never hits this.
+     */
+    async warmUp(options = {}) {
+        await this.session.sendRequest({
+            type: MiniappRequestType.CAMERA_WARM_UP,
+            size: options.size ?? "medium",
+            mode: options.mode ?? "photo",
+            exposureTimeNs: options.exposureTimeNs,
+            durationMs: options.durationMs ?? 15000,
+            zsl: options.zsl,
+            mfnr: options.mfnr,
+        });
+    }
+    /**
+     * Start recording video on the glasses camera. Returns a `recordingId` to pass
+     * to {@link stopVideoRecording} after the glasses report that recording
+     * started. Requires CAMERA permission declared in miniapp.json. Check
+     * `session.capabilities.hasCamera` before calling.
+     *
+     * Resolution and frame rate are optional — omit them to use the device's saved
+     * button-video settings. Lowering `fps` (e.g. to 5) keeps the glasses cooler
+     * during long recordings.
+     */
+    async startVideoRecording(options = {}) {
+        return this.session.sendRequest({
+            type: MiniappRequestType.VIDEO_RECORDING_START,
+            width: options.width,
+            height: options.height,
+            fps: options.fps,
+            sound: options.sound ?? true,
+            save: options.save ?? false,
+        });
+    }
+    /**
+     * Stop an in-progress video recording started with {@link startVideoRecording}.
+     *
+     * By default the recording stays on the glasses. Pass `uploadUrl` to have the
+     * glasses upload the finished clip to your own endpoint.
+     *
+     * @param recordingId The id returned from `startVideoRecording`.
+     * @param options     Optional upload destination for the finished recording.
+     */
+    async stopVideoRecording(recordingId, options = {}) {
+        await this.session.sendRequest({
+            type: MiniappRequestType.VIDEO_RECORDING_STOP,
+            recordingId,
+            uploadUrl: options.uploadUrl,
+            uploadAuthToken: options.uploadAuthToken,
+        });
+    }
+}
+//# sourceMappingURL=camera.js.map

package/dist/modules/camera.js.map

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

package/dist/modules/cloud.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview CloudModule — local miniapp view of the phone-owned cloud client.
+ *
+ * Miniapps do not own or configure the cloud connection. The phone owns one
+ * cloud-client instance and pushes status snapshots here so miniapps can render
+ * honest UX such as online/offline captions indicators.
+ */
+import { MiniappSession } from "../session";
+import type { UnsubscribeFn } from "./events";
+export type CloudClientConnectionStatus = "connected" | "connecting" | "reconnecting" | "disconnected";
+export type CloudClientAudioTransport = "udp" | "ws" | "offline" | "none";
+export interface CloudClientStatus {
+    status: CloudClientConnectionStatus;
+    audioTransport: CloudClientAudioTransport;
+}
+export declare const CLOUD_STATUS_STREAM = "_cloud_status";
+export declare class CloudModule {
+    private readonly session;
+    private readonly emitter;
+    private current;
+    constructor(session: MiniappSession);
+    /** Latest status snapshot pushed by the phone runtime. */
+    get status(): CloudClientStatus;
+    /** True when the phone's cloud-client runtime handshake is complete. */
+    get connected(): boolean;
+    /** Method alias for callers who prefer function-style state reads. */
+    isConnected(): boolean;
+    /**
+     * Subscribe to cloud-client status updates. The current value is delivered
+     * immediately so UI code can hydrate without waiting for the next transition.
+     */
+    onStatusChanged(handler: (status: CloudClientStatus) => void): UnsubscribeFn;
+}
+//# sourceMappingURL=cloud.d.ts.map

package/dist/modules/cloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud.d.ts","sourceRoot":"","sources":["../../src/modules/cloud.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,UAAU,CAAA;AAE3C,MAAM,MAAM,2BAA2B,GAAG,WAAW,GAAG,YAAY,GAAG,cAAc,GAAG,cAAc,CAAA;AACtG,MAAM,MAAM,yBAAyB,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAA;AAEzE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,2BAA2B,CAAA;IACnC,cAAc,EAAE,yBAAyB,CAAA;CAC1C;AAMD,eAAO,MAAM,mBAAmB,kBAAkB,CAAA;AA4BlD,qBAAa,WAAW;IAIV,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IACjE,OAAO,CAAC,OAAO,CAAyC;gBAE3B,OAAO,EAAE,cAAc;IAUpD,0DAA0D;IAC1D,IAAI,MAAM,IAAI,iBAAiB,CAE9B;IAED,wEAAwE;IACxE,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,sEAAsE;IACtE,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAAG,aAAa;CAO7E"}

package/dist/modules/cloud.js

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview CloudModule — local miniapp view of the phone-owned cloud client.
+ *
+ * Miniapps do not own or configure the cloud connection. The phone owns one
+ * cloud-client instance and pushes status snapshots here so miniapps can render
+ * honest UX such as online/offline captions indicators.
+ */
+import { EventEmitter } from "eventemitter3";
+export const CLOUD_STATUS_STREAM = "_cloud_status";
+const DEFAULT_STATUS = {
+    status: "disconnected",
+    audioTransport: "none",
+};
+function normalizeCloudStatus(data) {
+    if (!data || typeof data !== "object")
+        return null;
+    const raw = data;
+    const status = raw.status;
+    const audioTransport = raw.audioTransport;
+    if (status !== "connected" && status !== "connecting" && status !== "reconnecting" && status !== "disconnected") {
+        return null;
+    }
+    if (audioTransport !== "udp" &&
+        audioTransport !== "ws" &&
+        audioTransport !== "offline" &&
+        audioTransport !== "none") {
+        return null;
+    }
+    return { status, audioTransport };
+}
+export class CloudModule {
+    constructor(session) {
+        this.session = session;
+        this.emitter = new EventEmitter();
+        this.current = { ...DEFAULT_STATUS };
+        this.session._subscribe(CLOUD_STATUS_STREAM, (data) => {
+            const next = normalizeCloudStatus(data);
+            if (!next)
+                return;
+            if (next.status === this.current.status && next.audioTransport === this.current.audioTransport)
+                return;
+            this.current = next;
+            this.emitter.emit("status", { ...this.current });
+        });
+    }
+    /** Latest status snapshot pushed by the phone runtime. */
+    get status() {
+        return { ...this.current };
+    }
+    /** True when the phone's cloud-client runtime handshake is complete. */
+    get connected() {
+        return this.current.status === "connected";
+    }
+    /** Method alias for callers who prefer function-style state reads. */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Subscribe to cloud-client status updates. The current value is delivered
+     * immediately so UI code can hydrate without waiting for the next transition.
+     */
+    onStatusChanged(handler) {
+        handler({ ...this.current });
+        this.emitter.on("status", handler);
+        return () => {
+            this.emitter.off("status", handler);
+        };
+    }
+}
+//# sourceMappingURL=cloud.js.map

package/dist/modules/cloud.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud.js","sourceRoot":"","sources":["../../src/modules/cloud.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAC,YAAY,EAAC,MAAM,eAAe,CAAA;AAiB1C,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAA;AAElD,MAAM,cAAc,GAAsB;IACxC,MAAM,EAAE,cAAc;IACtB,cAAc,EAAE,MAAM;CACvB,CAAA;AAED,SAAS,oBAAoB,CAAC,IAAa;IACzC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAClD,MAAM,GAAG,GAAG,IAA+B,CAAA;IAC3C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAA;IACzB,MAAM,cAAc,GAAG,GAAG,CAAC,cAAc,CAAA;IAEzC,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,YAAY,IAAI,MAAM,KAAK,cAAc,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;QAChH,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IACE,cAAc,KAAK,KAAK;QACxB,cAAc,KAAK,IAAI;QACvB,cAAc,KAAK,SAAS;QAC5B,cAAc,KAAK,MAAM,EACzB,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,EAAC,MAAM,EAAE,cAAc,EAAC,CAAA;AACjC,CAAC;AAED,MAAM,OAAO,WAAW;IAItB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;QAHnC,YAAO,GAAG,IAAI,YAAY,EAAsB,CAAA;QACzD,YAAO,GAAsB,EAAC,GAAG,cAAc,EAAC,CAAA;QAGtD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,IAAI,EAAE,EAAE;YACpD,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAA;YACvC,IAAI,CAAC,IAAI;gBAAE,OAAM;YACjB,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,CAAC,OAAO,CAAC,cAAc;gBAAE,OAAM;YACtG,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;YACnB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAC,GAAG,IAAI,CAAC,OAAO,EAAC,CAAC,CAAA;QAChD,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,0DAA0D;IAC1D,IAAI,MAAM;QACR,OAAO,EAAC,GAAG,IAAI,CAAC,OAAO,EAAC,CAAA;IAC1B,CAAC;IAED,wEAAwE;IACxE,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,WAAW,CAAA;IAC5C,CAAC;IAED,sEAAsE;IACtE,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,OAA4C;QAC1D,OAAO,CAAC,EAAC,GAAG,IAAI,CAAC,OAAO,EAAC,CAAC,CAAA;QAC1B,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAClC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACrC,CAAC,CAAA;IACH,CAAC;CACF"}

package/dist/modules/dashboard.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview DashboardAPI. setContent() is a noop in v1 (the cloud
+ * DashboardManager owns widget rendering); showNativeDashboard() is live.
+ */
+import { MiniappSession } from "../session";
+export type DashboardMode = "main" | "expanded" | "always_on";
+/** "shown" = forwarded to the glasses; "unsupported" = the host refused (e.g. native nav mode owns the screen). */
+export interface ShowNativeDashboardResult {
+    status: "shown" | "unsupported";
+    reason?: string;
+}
+export declare class DashboardAPI {
+    private readonly session;
+    private warned;
+    constructor(session: MiniappSession);
+    setContent(mode: DashboardMode, content: string): void;
+    /**
+     * Bring the glasses' native dashboard (the OS-level idle screen) to the
+     * foreground. On the G2 this tears down the current page; the display
+     * returns when the wearer dismisses the dashboard or content is re-rendered.
+     */
+    showNativeDashboard(): Promise<ShowNativeDashboardResult>;
+}
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/modules/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/modules/dashboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAC,cAAc,EAAC,MAAM,YAAY,CAAA;AAEzC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAA;AAE7D,mHAAmH;AACnH,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,OAAO,GAAG,aAAa,CAAA;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,MAAM,CAAQ;gBAEO,OAAO,EAAE,cAAc;IAEpD,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAatD;;;;OAIG;IACH,mBAAmB,IAAI,OAAO,CAAC,yBAAyB,CAAC;CAW1D"}

package/dist/modules/dashboard.js

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview DashboardAPI. setContent() is a noop in v1 (the cloud
+ * DashboardManager owns widget rendering); showNativeDashboard() is live.
+ */
+import { MiniappRequestType } from "../protocol";
+export class DashboardAPI {
+    constructor(session) {
+        this.session = session;
+        this.warned = false;
+    }
+    setContent(mode, content) {
+        if (!this.warned) {
+            console.warn("[@glassly/miniapp] dashboard.setContent() is deferred in v1.");
+            this.warned = true;
+        }
+        // Still forward so the phone can log/ignore consistently.
+        this.session.sendOneShot({
+            type: MiniappRequestType.DASHBOARD_CONTENT_UPDATE,
+            mode,
+            content,
+        });
+    }
+    /**
+     * Bring the glasses' native dashboard (the OS-level idle screen) to the
+     * foreground. On the G2 this tears down the current page; the display
+     * returns when the wearer dismisses the dashboard or content is re-rendered.
+     */
+    showNativeDashboard() {
+        return this.session
+            .sendRequest({ type: MiniappRequestType.SHOW_NATIVE_DASHBOARD })
+            .catch((err) => ({
+            status: "unsupported",
+            reason: typeof err === "object" && err !== null && "message" in err
+                ? String(err.message)
+                : String(err),
+        }));
+    }
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/modules/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/modules/dashboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,kBAAkB,EAAC,MAAM,aAAa,CAAA;AAW9C,MAAM,OAAO,YAAY;IAGvB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;QAF5C,WAAM,GAAG,KAAK,CAAA;IAEiC,CAAC;IAExD,UAAU,CAAC,IAAmB,EAAE,OAAe;QAC7C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAA;YAC5E,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QACpB,CAAC;QACD,0DAA0D;QAC1D,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;YACvB,IAAI,EAAE,kBAAkB,CAAC,wBAAwB;YACjD,IAAI;YACJ,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;;;OAIG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,OAAO;aAChB,WAAW,CAA4B,EAAC,IAAI,EAAE,kBAAkB,CAAC,qBAAqB,EAAC,CAAC;aACxF,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACf,MAAM,EAAE,aAAsB;YAC9B,MAAM,EACJ,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,SAAS,IAAI,GAAG;gBACzD,CAAC,CAAC,MAAM,CAAE,GAA0B,CAAC,OAAO,CAAC;gBAC7C,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SAClB,CAAC,CAAC,CAAA;IACP,CAAC;CACF"}

package/dist/modules/display.d.ts

@@ -0,0 +1,174 @@
+/**
+ * @fileoverview DisplayManager — the glasses display, via `render()`.
+ *
+ * render(elements) is replace-the-frame scene rendering: each call describes
+ * everything that should be on screen, the host diffs it against the previous
+ * frame per device, and `render([])` clears. The legacy one-shot `show*`
+ * layout methods were removed once nothing first-party or known-external
+ * called them; hosts still accept the historical `miniapp_display` wire shape
+ * from bundles packed with older SDKs.
+ */
+import { MiniappSession } from "../session";
+export type ViewType = "main" | "dashboard";
+export type DisplayBreakMode = "character" | "character-no-hyphen" | "word" | "strict-word";
+/** Canvas corner a box's `x`/`y` are measured from (insets grow inward). */
+export type RenderAnchor = "top-left" | "top-right" | "bottom-left" | "bottom-right";
+/**
+ * Pixel-space bounding box on the device's drawable canvas (see
+ * `capabilities.display`).
+ *
+ * With an `anchor`, `x`/`y` become insets from that corner, growing inward,
+ * and the host resolves the box against the connected device's real canvas —
+ * e.g. `{x: 0, y: 0, w: 120, h: 120, anchor: "bottom-right"}` sits flush in
+ * the bottom-right corner on every device, whatever its resolution. Corners
+ * only; there is no center/edge anchoring or scaling. Hosts older than the
+ * anchor feature ignore the field and place the box from the top-left.
+ */
+export interface RenderBox {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    /** Which canvas corner x/y are measured from. Default "top-left". */
+    anchor?: RenderAnchor;
+}
+export interface RenderTextStyle {
+    /** 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 (host wraps; the box carries pre-wrapped text). */
+    breakMode?: DisplayBreakMode;
+    /**
+     * "mono": fixed-pitch text drawn at `fontSize` px with a fixed line height
+     * of 1.2 × size, and NOT re-wrapped by the host — lines are taken as given.
+     * For grids (terminals, tables). Devices without a phone-side rasterizer
+     * (stock G2 firmware) fall back to their own proportional font.
+     *
+     * "builtin": the glasses draw the text themselves with their built-in 20 px
+     * proportional font (Glassly CFW G2 only — tiny updates instead of bitmap
+     * re-sends). Lines are taken as given (split on \n, never re-wrapped) and
+     * clipped at the display edge, and the render window is pinned to the
+     * middle depth level while such text is on screen. Other devices and stock
+     * firmware fall back to the default proportional face.
+     */
+    font?: "default" | "mono" | "builtin";
+    /** Font size in px for `font: "mono"`. Default 20. */
+    fontSize?: number;
+}
+export interface RenderRectStyle {
+    border?: number;
+    radius?: number;
+}
+/**
+ * One element of a rendered scene. `id` is optional but recommended for
+ * anything that updates over time: elements with a stable id update in place on
+ * the glasses (no flicker); the host matches unnamed elements by geometry.
+ */
+export type RenderElement = {
+    type: "text";
+    id?: string;
+    box: RenderBox;
+    text: string;
+    style?: RenderTextStyle;
+} | {
+    type: "image";
+    id?: string;
+    box: RenderBox;
+    data: string;
+} | {
+    type: "rect";
+    id?: string;
+    box: RenderBox;
+    style?: RenderRectStyle;
+};
+export interface RenderOptions {
+    view?: ViewType;
+    /** Auto-clear after this many ms (same semantics as legacy display options). */
+    durationMs?: number;
+}
+/** Turn-by-turn card fields — pre-formatted display strings, rendered verbatim by the device. */
+export interface NativeNavInfo {
+    /** Firmware direction-icon index, 0…35. */
+    directionIcon: number;
+    /** Distance to the next maneuver, e.g. "500 m". */
+    distance: string;
+    roadName: string;
+    /** Remaining trip duration, e.g. "11 min". */
+    spendTime: string;
+    /** Distance to the destination, e.g. "0.9 km". */
+    remainDistance: string;
+    /** Arrival time, e.g. "18:18". */
+    etaTime: string;
+    /** Current speed, e.g. "5 km/h". */
+    speed: string;
+}
+/**
+ * "sent" = forwarded to the device. "unsupported" = no native nav UI on this
+ * device / no active trip — callers should fall back to render().
+ */
+export interface NativeNavResult {
+    status: "sent" | "unsupported" | "blocked";
+    reason?: string;
+}
+/**
+ * Outcome of a render request, resolved when the host's display arbitration
+ * settles it. "displayed" = accepted and sent to the device — NOT a
+ * render confirmation. "blocked" = another app owns the display (or the
+ * request failed); `reason` says why.
+ */
+export interface RenderResult {
+    status: "displayed" | "blocked";
+    /** True when the host adjusted the scene (clamped boxes, dropped elements, degraded for the device). */
+    degraded?: boolean;
+    /** Ids of elements the host dropped (budget/bounds/device limits) — dropped is never silent. */
+    dropped?: string[];
+    reason?: string;
+}
+export declare class DisplayManager {
+    private readonly session;
+    constructor(session: MiniappSession);
+    /**
+     * Render a whole scene of positioned elements — replace-the-frame.
+     *
+     * Each call describes everything that should be on screen; the host diffs it
+     * against the previous frame per device (elements with a stable `id` update
+     * in place; elements you stop sending are removed). There is no lifecycle to
+     * manage and no remove calls — `render([])` clears.
+     *
+     * Coordinates are raw pixels on the device's drawable canvas — read
+     * `session.capabilities.display` (populated on the "ready" event) for the
+     * real width/height and element budgets. Out-of-bounds boxes are clamped and
+     * over-budget elements are dropped tail-first; both are reported via the
+     * result, never silently.
+     *
+     * Awaiting is OPT-IN — a plain fire-and-forget call is fine. The returned
+     * promise never rejects.
+     *
+     * @example
+     * const result = await session.display.render([
+     *   {type: "text",  id: "stats", box: {x: 12, y: 9, w: 200, h: 28}, text: "863 m  11 min"},
+     *   {type: "image", id: "map",   box: {x: 335, y: 14, w: 150, h: 150}, data: mapPng},
+     *   {type: "rect",  box: {x: 0, y: 0, w: 500, h: 220}, style: {radius: 4}},
+     * ])
+     * if (result.degraded) console.warn("dropped:", result.dropped)
+     */
+    render(elements: RenderElement[], options?: RenderOptions): Promise<RenderResult>;
+    /** Update the native nav UI's turn-by-turn card. */
+    sendNativeNavInfo(info: NativeNavInfo): Promise<NativeNavResult>;
+    /**
+     * Push the native nav UI's live mini map (base64 BMP/PNG; the host re-encodes
+     * and scales to the device's slot — 176×176 on G2). Draw north-up with the
+     * cursor centred; the device rotates the bitmap by `rotationDeg`.
+     */
+    sendNativeNavMiniMap(data: string, options?: {
+        rotationDeg?: number;
+        border?: boolean;
+    }): Promise<NativeNavResult>;
+    /** Push the native nav UI's overview (full-route) map — 576×188 on G2. */
+    sendNativeNavOverviewMap(data: string): Promise<NativeNavResult>;
+    private sendNativeNav;
+}
+//# sourceMappingURL=display.d.ts.map

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

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

package/dist/modules/display.js

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview DisplayManager — the glasses display, via `render()`.
+ *
+ * render(elements) is replace-the-frame scene rendering: each call describes
+ * everything that should be on screen, the host diffs it against the previous
+ * frame per device, and `render([])` clears. The legacy one-shot `show*`
+ * layout methods were removed once nothing first-party or known-external
+ * called them; hosts still accept the historical `miniapp_display` wire shape
+ * from bundles packed with older SDKs.
+ */
+import { MiniappRequestType } from "../protocol";
+export class DisplayManager {
+    constructor(session) {
+        this.session = session;
+    }
+    /**
+     * Render a whole scene of positioned elements — replace-the-frame.
+     *
+     * Each call describes everything that should be on screen; the host diffs it
+     * against the previous frame per device (elements with a stable `id` update
+     * in place; elements you stop sending are removed). There is no lifecycle to
+     * manage and no remove calls — `render([])` clears.
+     *
+     * Coordinates are raw pixels on the device's drawable canvas — read
+     * `session.capabilities.display` (populated on the "ready" event) for the
+     * real width/height and element budgets. Out-of-bounds boxes are clamped and
+     * over-budget elements are dropped tail-first; both are reported via the
+     * result, never silently.
+     *
+     * Awaiting is OPT-IN — a plain fire-and-forget call is fine. The returned
+     * promise never rejects.
+     *
+     * @example
+     * const result = await session.display.render([
+     *   {type: "text",  id: "stats", box: {x: 12, y: 9, w: 200, h: 28}, text: "863 m  11 min"},
+     *   {type: "image", id: "map",   box: {x: 335, y: 14, w: 150, h: 150}, data: mapPng},
+     *   {type: "rect",  box: {x: 0, y: 0, w: 500, h: 220}, style: {radius: 4}},
+     * ])
+     * if (result.degraded) console.warn("dropped:", result.dropped)
+     */
+    render(elements, options = {}) {
+        return this.session
+            .sendRequest({
+            type: MiniappRequestType.RENDER,
+            view: options.view ?? "main",
+            elements,
+            durationMs: options.durationMs,
+        })
+            .catch((err) => ({
+            status: "blocked",
+            reason: typeof err === "object" && err !== null && "message" in err
+                ? String(err.message)
+                : String(err),
+        }));
+    }
+    /** Update the native nav UI's turn-by-turn card. */
+    sendNativeNavInfo(info) {
+        return this.sendNativeNav({ action: "info", info });
+    }
+    /**
+     * Push the native nav UI's live mini map (base64 BMP/PNG; the host re-encodes
+     * and scales to the device's slot — 176×176 on G2). Draw north-up with the
+     * cursor centred; the device rotates the bitmap by `rotationDeg`.
+     */
+    sendNativeNavMiniMap(data, options = {}) {
+        return this.sendNativeNav({ action: "mini_map", map: { data, ...options } });
+    }
+    /** Push the native nav UI's overview (full-route) map — 576×188 on G2. */
+    sendNativeNavOverviewMap(data) {
+        return this.sendNativeNav({ action: "overview_map", map: { data } });
+    }
+    sendNativeNav(payload) {
+        return this.session
+            .sendRequest({ type: MiniappRequestType.NATIVE_NAV, ...payload })
+            .catch((err) => ({
+            status: "unsupported",
+            reason: typeof err === "object" && err !== null && "message" in err
+                ? String(err.message)
+                : String(err),
+        }));
+    }
+}
+//# sourceMappingURL=display.js.map

package/dist/modules/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../src/modules/display.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAC,kBAAkB,EAAC,MAAM,aAAa,CAAA;AA+H9C,MAAM,OAAO,cAAc;IACzB,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,QAAyB,EAAE,UAAyB,EAAE;QAC3D,OAAO,IAAI,CAAC,OAAO;aAChB,WAAW,CAAe;YACzB,IAAI,EAAE,kBAAkB,CAAC,MAAM;YAC/B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;YAC5B,QAAQ;YACR,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACf,MAAM,EAAE,SAAkB;YAC1B,MAAM,EACJ,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,SAAS,IAAI,GAAG;gBACzD,CAAC,CAAC,MAAM,CAAE,GAA0B,CAAC,OAAO,CAAC;gBAC7C,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SAClB,CAAC,CAAC,CAAA;IACP,CAAC;IAED,oDAAoD;IACpD,iBAAiB,CAAC,IAAmB;QACnC,OAAO,IAAI,CAAC,aAAa,CAAC,EAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAC,CAAC,CAAA;IACnD,CAAC;IAED;;;;OAIG;IACH,oBAAoB,CAAC,IAAY,EAAE,UAAoD,EAAE;QACvF,OAAO,IAAI,CAAC,aAAa,CAAC,EAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,EAAC,IAAI,EAAE,GAAG,OAAO,EAAC,EAAC,CAAC,CAAA;IAC1E,CAAC;IAED,0EAA0E;IAC1E,wBAAwB,CAAC,IAAY;QACnC,OAAO,IAAI,CAAC,aAAa,CAAC,EAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,EAAC,IAAI,EAAC,EAAC,CAAC,CAAA;IAClE,CAAC;IAEO,aAAa,CAAC,OAAgC;QACpD,OAAO,IAAI,CAAC,OAAO;aAChB,WAAW,CAAkB,EAAC,IAAI,EAAE,kBAAkB,CAAC,UAAU,EAAE,GAAG,OAAO,EAAC,CAAC;aAC/E,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACf,MAAM,EAAE,aAAsB;YAC9B,MAAM,EACJ,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,SAAS,IAAI,GAAG;gBACzD,CAAC,CAAC,MAAM,CAAE,GAA0B,CAAC,OAAO,CAAC;gBAC7C,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SAClB,CAAC,CAAC,CAAA;IACP,CAAC;CACF"}