@mentra/miniapp 0.3.0-dev.0

package/dist/protocol.js

@@ -0,0 +1,320 @@
+/**
+ * @fileoverview Wire protocol for @mentra/miniapp.
+ *
+ * Fresh miniapp-naming enum values. No legacy tpa_/app_/applet_ prefixes.
+ * These values are the contract between @mentra/miniapp (running in a WebView)
+ * and LocalMiniappRuntime (running on the phone).
+ *
+ * IMPORTANT: This file has NO runtime dependency on @mentra/sdk. The cloud SDK's
+ * wire protocol enums live in @mentra/sdk/types/message-types.ts and are used
+ * for cloud↔app communication, not phone↔miniapp.
+ */
+// ============================================================================
+// Miniapp → phone (request, via bridge envelope)
+// ============================================================================
+export var MiniappRequestType;
+(function (MiniappRequestType) {
+    /** Handshake: miniapp announces itself and asks phone to bind the session. */
+    MiniappRequestType["CONNECT"] = "miniapp_connect";
+    /** Request a fresh miniapp-scoped backend auth token. */
+    MiniappRequestType["AUTH_REFRESH"] = "miniapp_auth_refresh";
+    /** Update the set of streams the miniapp is subscribed to. */
+    MiniappRequestType["SUBSCRIBE"] = "miniapp_subscribe";
+    /**
+     * Push a legacy display layout to the glasses. The SDK no longer emits this
+     * (render()/RENDER replaced it); hosts keep accepting it from bundles packed
+     * with older SDKs and from cloud-shaped layouts.
+     */
+    MiniappRequestType["DISPLAY"] = "miniapp_display";
+    /** Render a whole scene of positioned elements (replace-the-frame). */
+    MiniappRequestType["RENDER"] = "miniapp_render";
+    /** Play an arbitrary audio URL through the phone's audio playback service. */
+    MiniappRequestType["PLAY_AUDIO"] = "miniapp_play_audio";
+    /** Stop any audio playback this miniapp initiated. */
+    MiniappRequestType["STOP_AUDIO"] = "miniapp_stop_audio";
+    /** Speak text via cloud TTS — phone constructs the URL. */
+    MiniappRequestType["SPEAK"] = "miniapp_speak";
+    /**
+     * Live PCM output stream to the phone's audio playback service
+     * (speaker.createStream). OPEN provisions a native chunk player; WRITE
+     * appends base64 PCM (replies with {bufferedMs} for backpressure); CLOSE
+     * drains and finishes; ABORT drops immediately.
+     */
+    MiniappRequestType["SPEAKER_STREAM_OPEN"] = "miniapp_speaker_stream_open";
+    MiniappRequestType["SPEAKER_STREAM_WRITE"] = "miniapp_speaker_stream_write";
+    MiniappRequestType["SPEAKER_STREAM_CLOSE"] = "miniapp_speaker_stream_close";
+    MiniappRequestType["SPEAKER_STREAM_ABORT"] = "miniapp_speaker_stream_abort";
+    /** Control the glasses RGB LED. */
+    MiniappRequestType["RGB_LED"] = "miniapp_rgb_led";
+    /** One-shot location poll. */
+    MiniappRequestType["LOCATION_POLL"] = "miniapp_location_poll";
+    /** Start a turn-by-turn navigation trip. Android only. */
+    MiniappRequestType["NAVIGATION_START"] = "miniapp_navigation_start";
+    /** Stop the active navigation trip (if any). */
+    MiniappRequestType["NAVIGATION_STOP"] = "miniapp_navigation_stop";
+    /** Dev-only: nudge the simulator off-route to test rerouting. Android sim only. */
+    MiniappRequestType["NAVIGATION_DEVIATE"] = "miniapp_navigation_deviate";
+    /** Dev-only: lock simulated locations to the wrong sidewalk for pivot-trigger testing. */
+    MiniappRequestType["NAVIGATION_SET_WRONG_SIDEWALK"] = "miniapp_navigation_set_wrong_sidewalk";
+    /** Dev-only: take over the simulator and walk a polyline with crossings stripped. */
+    MiniappRequestType["NAVIGATION_SET_SKIP_CROSSINGS"] = "miniapp_navigation_set_skip_crossings";
+    /** Snapshot of the active trip (or null). Lets a miniapp opening mid-trip hydrate. */
+    MiniappRequestType["NAVIGATION_GET_STATE"] = "miniapp_navigation_get_state";
+    /** Compute a route without starting a trip. Replaces hand-rolled Directions calls. */
+    MiniappRequestType["NAVIGATION_COMPUTE_ROUTE"] = "miniapp_navigation_compute_route";
+    /** Reverse-geocode a coordinate to a short road name + full formatted
+     *  address. `road` backs the engine's fallback for pivots whose Routes-API
+     *  instruction didn't include a parseable road; `address` backs UI labels for
+     *  dropped pins / POI taps. Resolved in the v2 cloud maps service (Mapbox
+     *  today) via the host bridge — the miniapp never holds a maps token. */
+    MiniappRequestType["NAVIGATION_REVERSE_GEOCODE"] = "miniapp_navigation_reverse_geocode";
+    /** Type-ahead place search (autocomplete). Resolved in the v2 cloud maps
+     *  service (Mapbox Search Box today) via the host bridge — the miniapp never
+     *  holds a maps token. Pairs with NAVIGATION_PLACE_DETAILS via a sessionToken. */
+    MiniappRequestType["NAVIGATION_PLACE_AUTOCOMPLETE"] = "miniapp_navigation_place_autocomplete";
+    /** Resolve an autocomplete suggestion (placeId + sessionToken) to coordinates,
+     *  in the v2 cloud maps service via the host bridge. */
+    MiniappRequestType["NAVIGATION_PLACE_DETAILS"] = "miniapp_navigation_place_details";
+    /** Trigger the Google Nav SDK T&C dialog up-front so start() doesn't have to. */
+    MiniappRequestType["NAVIGATION_REQUEST_PERMISSION"] = "miniapp_navigation_request_permission";
+    /** Phone-local simple storage. */
+    MiniappRequestType["STORAGE_GET"] = "miniapp_storage_get";
+    MiniappRequestType["STORAGE_SET"] = "miniapp_storage_set";
+    MiniappRequestType["STORAGE_DELETE"] = "miniapp_storage_delete";
+    MiniappRequestType["STORAGE_LIST"] = "miniapp_storage_list";
+    MiniappRequestType["STORAGE_CLEAR"] = "miniapp_storage_clear";
+    MiniappRequestType["STORAGE_HAS"] = "miniapp_storage_has";
+    MiniappRequestType["STORAGE_GET_ALL"] = "miniapp_storage_get_all";
+    MiniappRequestType["STORAGE_SET_MULTIPLE"] = "miniapp_storage_set_multiple";
+    MiniappRequestType["STORAGE_FLUSH"] = "miniapp_storage_flush";
+    /** Write camera FOV settings. */
+    MiniappRequestType["CAMERA_FOV"] = "miniapp_camera_fov";
+    /** Pre-warm the glasses camera so the next takePhoto() is near-instant. */
+    MiniappRequestType["CAMERA_WARM_UP"] = "miniapp_camera_warm_up";
+    /**
+     * Enable/disable raw accelerometer (IMU) streaming on the glasses. The
+     * accel stream also auto-enables on subscribe; this is an explicit override
+     * for callers who want to control the sensor directly. G2 only today.
+     */
+    MiniappRequestType["IMU_SET_ENABLED"] = "miniapp_imu_set_enabled";
+    /** Share content via the OS share sheet. */
+    MiniappRequestType["SHARE"] = "miniapp_share";
+    /** Open a URL in the system browser. */
+    MiniappRequestType["OPEN_URL"] = "miniapp_open_url";
+    /** Copy text to the system clipboard. */
+    MiniappRequestType["COPY_CLIPBOARD"] = "miniapp_copy_clipboard";
+    /** Download a file (triggers OS share sheet for save location). */
+    MiniappRequestType["DOWNLOAD"] = "miniapp_download";
+    /**
+     * Phone-local persistent binary blob storage, scoped to (userId, packageName).
+     * Unlike STORAGE_* (small string KV in MMKV), blobs are arbitrary bytes written
+     * to the phone filesystem. Large payloads are moved in chunks (BLOB_WRITE /
+     * BLOB_READ) so a single bridge message never carries a multi-MB string.
+     */
+    MiniappRequestType["BLOB_CREATE"] = "miniapp_blob_create";
+    MiniappRequestType["BLOB_WRITE"] = "miniapp_blob_write";
+    MiniappRequestType["BLOB_COMMIT"] = "miniapp_blob_commit";
+    MiniappRequestType["BLOB_ABORT"] = "miniapp_blob_abort";
+    MiniappRequestType["BLOB_GET"] = "miniapp_blob_get";
+    MiniappRequestType["BLOB_LIST"] = "miniapp_blob_list";
+    MiniappRequestType["BLOB_DELETE"] = "miniapp_blob_delete";
+    MiniappRequestType["BLOB_CLEAR"] = "miniapp_blob_clear";
+    MiniappRequestType["BLOB_USAGE"] = "miniapp_blob_usage";
+    MiniappRequestType["BLOB_OPEN_READ"] = "miniapp_blob_open_read";
+    MiniappRequestType["BLOB_READ"] = "miniapp_blob_read";
+    MiniappRequestType["BLOB_CLOSE_READ"] = "miniapp_blob_close_read";
+    /** Download a URL straight into a blob, host-side (no bytes cross the bridge). */
+    MiniappRequestType["BLOB_SET_FROM_URL"] = "miniapp_blob_set_from_url";
+    /** Open the OS file picker and import the chosen file into a blob, host-side. */
+    MiniappRequestType["BLOB_IMPORT"] = "miniapp_blob_import";
+    /** Share a stored blob from disk via the OS share sheet (no bytes cross the bridge). */
+    MiniappRequestType["BLOB_SHARE"] = "miniapp_blob_share";
+    /** Phone → miniapp liveness probe. Miniapp SDK auto-replies with PONG. */
+    MiniappRequestType["PING"] = "miniapp_ping";
+    /**
+     * Apply transcription configuration (language hints, vocabulary, diarization).
+     * Phone forwards to the cloud STT layer. Fire-and-forget; cached client-side
+     * so future reconnect logic can re-send.
+     */
+    MiniappRequestType["TRANSCRIPTION_CONFIG"] = "miniapp_transcription_config";
+    // ----- Deferred in v1 -----
+    /** Dashboard content update. Noop in v1. */
+    MiniappRequestType["DASHBOARD_CONTENT_UPDATE"] = "miniapp_dashboard_content_update";
+    // ----- Photos, streaming -----
+    MiniappRequestType["PHOTO"] = "miniapp_photo";
+    MiniappRequestType["VIDEO_RECORDING_START"] = "miniapp_video_recording_start";
+    MiniappRequestType["VIDEO_RECORDING_STOP"] = "miniapp_video_recording_stop";
+    MiniappRequestType["STREAM_START"] = "miniapp_stream_start";
+    MiniappRequestType["STREAM_STOP"] = "miniapp_stream_stop";
+    MiniappRequestType["MANAGED_STREAM_START"] = "miniapp_managed_stream_start";
+    MiniappRequestType["MANAGED_STREAM_STOP"] = "miniapp_managed_stream_stop";
+    /** Ask the host to open the glasses Wi-Fi setup flow (mirrors the cloud SDK's requestWifiSetup). */
+    MiniappRequestType["REQUEST_WIFI_SETUP"] = "miniapp_request_wifi_setup";
+    // ----- Inter-miniapp interop (SYSTEM apps only) -----
+    /** List installed miniapps (compatibility-filtered, with declared actions). */
+    MiniappRequestType["MINIAPPS_LIST"] = "miniapp_apps_list";
+    /** Start another miniapp (user-tap semantics). */
+    MiniappRequestType["MINIAPPS_START"] = "miniapp_apps_start";
+    /** Stop another miniapp. */
+    MiniappRequestType["MINIAPPS_STOP"] = "miniapp_apps_stop";
+    /** Invoke a declared action on another miniapp; headless-wakes it if stopped. */
+    MiniappRequestType["ACTION_INVOKE"] = "miniapp_action_invoke";
+    /** Target → host: the result of a delivered ACTION_CALL, correlated by callId. */
+    MiniappRequestType["ACTION_RESULT"] = "miniapp_action_result";
+})(MiniappRequestType || (MiniappRequestType = {}));
+// ============================================================================
+// Phone → miniapp (response or push)
+// ============================================================================
+export var MiniappResponseType;
+(function (MiniappResponseType) {
+    /** Response to CONNECT carrying userId, packageName, capabilities. */
+    MiniappResponseType["CONNECT_ACK"] = "miniapp_connect_ack";
+    /** Push: a streamed event for a subscribed stream. */
+    MiniappResponseType["EVENT"] = "miniapp_event";
+    /** Response to any request that needs a result (matched by requestId). */
+    MiniappResponseType["REQUEST_RESULT"] = "miniapp_request_result";
+    /** Push: glasses capabilities changed. */
+    MiniappResponseType["CAPABILITIES_UPDATE"] = "miniapp_capabilities_update";
+    /** Push: miniapp's foreground/background state changed. */
+    MiniappResponseType["VISIBILITY_CHANGE"] = "miniapp_visibility_change";
+    /** Push: host color scheme (light/dark) changed. */
+    MiniappResponseType["COLOR_SCHEME_CHANGE"] = "miniapp_color_scheme_change";
+    /**
+     * Push: speaker playback state transitioned. Per-miniapp; the runtime sends
+     * to the owning miniapp only. Carries {state, errorCode?, errorMessage?,
+     * durationMs?}. See SpeakerModule.onStateChange().
+     */
+    MiniappResponseType["SPEAKER_STATE"] = "miniapp_speaker_state";
+    /**
+     * Push: manifest-declared permissions changed (e.g. dev miniapp re-scanned
+     * with updated manifest). Carries a full PermissionRecord. SDK caches it
+     * and fires session.permissions.onUpdate handlers.
+     */
+    MiniappResponseType["PERMISSIONS_UPDATE"] = "miniapp_permissions_update";
+    /**
+     * Push: miniapp-scoped backend auth token changed. Carries a token minted for
+     * this packageName only; it is never a Core or runtime access token.
+     */
+    MiniappResponseType["AUTH_UPDATE"] = "miniapp_auth_update";
+    /** Reply to PING. SDK auto-handles this; developers never see it. */
+    MiniappResponseType["PONG"] = "miniapp_pong";
+    /**
+     * Host → target: deliver an action call (from another miniapp's
+     * session.actions.invoke) to this miniapp's session.actions.handle handler.
+     * Carries {callId, actionId, params, callerPackageName}. The SDK runs the
+     * handler and replies with an ACTION_RESULT request keyed by callId.
+     */
+    MiniappResponseType["ACTION_CALL"] = "miniapp_action_call";
+    /**
+     * Push: phone is about to tear down the miniapp's session. Gives the SDK
+     * a brief window (~50ms grace on the phone side) to fire one last
+     * `sendOneShot` before the transport closes — used to flush final
+     * cleanup like `display.render([])`. Synchronous handlers only.
+     */
+    MiniappResponseType["WILL_DISCONNECT"] = "miniapp_will_disconnect";
+    /** Async error not tied to a specific request. */
+    MiniappResponseType["ERROR"] = "miniapp_error";
+})(MiniappResponseType || (MiniappResponseType = {}));
+// ============================================================================
+// Stream types a miniapp can subscribe to
+// ============================================================================
+export var MiniappStreamType;
+(function (MiniappStreamType) {
+    // Hardware / input events
+    MiniappStreamType["BUTTON_PRESS"] = "button_press";
+    MiniappStreamType["TOUCH_EVENT"] = "touch_event";
+    MiniappStreamType["HEAD_POSITION"] = "head_position";
+    /**
+     * Raw accelerometer reading from the glasses IMU — `{x, y, z}` in g, plus a
+     * timestamp. G2 only today. A richer combined IMU stream (accel + gyro +
+     * magnetometer) is future work; this is the single-sensor precursor.
+     */
+    MiniappStreamType["ACCEL_DATA"] = "accel_data";
+    // Status
+    MiniappStreamType["GLASSES_BATTERY"] = "glasses_battery";
+    MiniappStreamType["PHONE_BATTERY"] = "phone_battery";
+    MiniappStreamType["GLASSES_CONNECTION"] = "glasses_connection";
+    /** Glasses Wi-Fi state (connected/ssid). Glasses with Wi-Fi only; needed for streaming. */
+    MiniappStreamType["GLASSES_WIFI"] = "glasses_wifi";
+    // Speech / audio (cloud or local)
+    MiniappStreamType["TRANSCRIPTION"] = "transcription";
+    MiniappStreamType["TRANSLATION"] = "translation";
+    MiniappStreamType["AUDIO_CHUNK"] = "audio_chunk";
+    MiniappStreamType["VAD"] = "vad";
+    // Phone sensors
+    MiniappStreamType["LOCATION_UPDATE"] = "location_update";
+    /** Compass heading in degrees (0=N, 90=E). Android only. */
+    MiniappStreamType["HEADING_UPDATE"] = "heading_update";
+    /** Turn-by-turn navigation event (maneuver / rerouting / arrived / error). */
+    MiniappStreamType["NAVIGATION_UPDATE"] = "navigation_update";
+    /** Active navigation route polyline — full path, fired once per route build. */
+    MiniappStreamType["NAVIGATION_ROUTE"] = "navigation_route";
+    MiniappStreamType["PHONE_NOTIFICATION"] = "phone_notification";
+    /**
+     * A previously-posted notification was dismissed by the user.
+     *
+     * Android-only today. iOS does not expose dismiss callbacks to apps
+     * (Apple privacy restriction); subscribing on iOS succeeds but no events
+     * fire. See agents/miniapp-speaker-state-and-notif-dismissed-plan.md.
+     */
+    MiniappStreamType["PHONE_NOTIFICATION_DISMISSED"] = "phone_notification_dismissed";
+    MiniappStreamType["CALENDAR_EVENT"] = "calendar_event";
+    // Photos, streaming
+    MiniappStreamType["PHOTO_TAKEN"] = "photo_taken";
+    MiniappStreamType["STREAM_STATUS"] = "stream_status";
+})(MiniappStreamType || (MiniappStreamType = {}));
+// ============================================================================
+// Error codes
+// ============================================================================
+export var MiniappErrorCode;
+(function (MiniappErrorCode) {
+    /** Request arguments failed host-side validation. */
+    MiniappErrorCode["INVALID_ARGUMENT"] = "INVALID_ARGUMENT";
+    /** The miniapp subscribed to a stream whose required permission wasn't in its manifest. */
+    MiniappErrorCode["PERMISSION_NOT_DECLARED"] = "PERMISSION_NOT_DECLARED";
+    /** Request routed to a method that isn't supported yet. */
+    MiniappErrorCode["NOT_IMPLEMENTED"] = "NOT_IMPLEMENTED";
+    /** Request timed out or the session was torn down before it could complete. */
+    MiniappErrorCode["REQUEST_ABORTED"] = "REQUEST_ABORTED";
+    /** Phone-side code path threw. Check `message`. */
+    MiniappErrorCode["INTERNAL"] = "INTERNAL";
+    /** Cloud TTS returned a non-2xx for a SPEAK request. */
+    MiniappErrorCode["TTS_TEXT_TOO_LONG"] = "TTS_TEXT_TOO_LONG";
+    MiniappErrorCode["TTS_INVALID_VOICE"] = "TTS_INVALID_VOICE";
+    MiniappErrorCode["TTS_UPSTREAM_ERROR"] = "TTS_UPSTREAM_ERROR";
+    /** Not connected / pre-ACK and transport closed. */
+    MiniappErrorCode["NOT_CONNECTED"] = "NOT_CONNECTED";
+    // ----- Inter-miniapp interop -----
+    /** Caller is not a system app — interop APIs (list/start/stop/invoke) are SYSTEM-only. */
+    MiniappErrorCode["NOT_PERMITTED"] = "NOT_PERMITTED";
+    /** Target miniapp is not installed. */
+    MiniappErrorCode["APP_NOT_FOUND"] = "APP_NOT_FOUND";
+    /** Target miniapp is incompatible with the connected glasses. */
+    MiniappErrorCode["APP_NOT_COMPATIBLE"] = "APP_NOT_COMPATIBLE";
+    /** Target miniapp does not declare the requested action. */
+    MiniappErrorCode["ACTION_NOT_FOUND"] = "ACTION_NOT_FOUND";
+    /** Target connected but never registered a handler for the action (within the buffer window). */
+    MiniappErrorCode["NO_ACTION_HANDLER"] = "NO_ACTION_HANDLER";
+    /** Target failed to wake / complete its CONNECT handshake for an invoke. */
+    MiniappErrorCode["WAKE_FAILED"] = "WAKE_FAILED";
+    /** Action handler did not return within the caller's timeout. */
+    MiniappErrorCode["ACTION_TIMEOUT"] = "ACTION_TIMEOUT";
+    /** Action params or result exceeded the 256 KB size cap. */
+    MiniappErrorCode["PAYLOAD_TOO_LARGE"] = "PAYLOAD_TOO_LARGE";
+    // ----- Blob storage / recorder -----
+    /** No blob with the given id in this miniapp's namespace. */
+    MiniappErrorCode["BLOB_NOT_FOUND"] = "BLOB_NOT_FOUND";
+    /** Writing this blob would exceed the per-app blob quota. */
+    MiniappErrorCode["BLOB_QUOTA_EXCEEDED"] = "BLOB_QUOTA_EXCEEDED";
+    /** Blob is larger than the requested in-memory read can hold. */
+    MiniappErrorCode["BLOB_TOO_LARGE"] = "BLOB_TOO_LARGE";
+    /** Write/read handle is unknown, already settled, or belongs to another app. */
+    MiniappErrorCode["BLOB_HANDLE_INVALID"] = "BLOB_HANDLE_INVALID";
+    /** Filesystem write failed (out of disk, permissions, etc.). */
+    MiniappErrorCode["BLOB_WRITE_FAILED"] = "BLOB_WRITE_FAILED";
+    /** `blob.setFromUrl` could not download the URL (network / non-2xx). */
+    MiniappErrorCode["BLOB_DOWNLOAD_FAILED"] = "BLOB_DOWNLOAD_FAILED";
+    /** `blob.importFile` failed (not the user cancelling — that resolves to null). */
+    MiniappErrorCode["BLOB_IMPORT_FAILED"] = "BLOB_IMPORT_FAILED";
+})(MiniappErrorCode || (MiniappErrorCode = {}));
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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

package/dist/react/MentraProvider.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview MentraProvider — optional root provider for miniapp apps.
+ *
+ * Opt-in conveniences that would otherwise require boilerplate in every
+ * miniapp. Currently:
+ *   - Keeps `<html class="dark">` in sync with the host's color scheme so the
+ *     shared theme CSS switches automatically.
+ *
+ * Usage:
+ *   createRoot(root).render(
+ *     <MentraProvider>
+ *       <App />
+ *     </MentraProvider>
+ *   )
+ *
+ * Each convenience is controllable via props so miniapps that manage these
+ * things themselves can opt out without forking the provider.
+ */
+import { type ReactNode } from "react";
+export interface MentraProviderProps {
+    children: ReactNode;
+    /**
+     * Toggle `document.documentElement.classList` "dark" to match the host's
+     * current color scheme. The toggle runs synchronously during render so
+     * children paint with the correct class on first mount — no flash.
+     *
+     * Default: true. Set to false if your app owns the `dark` class itself
+     * (e.g. you integrate a theming library like next-themes).
+     */
+    syncColorScheme?: boolean;
+}
+export declare function MentraProvider({ children, syncColorScheme }: MentraProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=MentraProvider.d.ts.map

package/dist/react/MentraProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MentraProvider.d.ts","sourceRoot":"","sources":["../../src/react/MentraProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAC,KAAK,SAAS,EAAC,MAAM,OAAO,CAAA;AAIpC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,SAAS,CAAA;IACnB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,wBAAgB,cAAc,CAAC,EAAC,QAAQ,EAAE,eAAsB,EAAC,EAAE,mBAAmB,+BAarF"}

package/dist/react/MentraProvider.js

@@ -0,0 +1,15 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useColorScheme } from "./useColorScheme";
+export function MentraProvider({ children, syncColorScheme = true }) {
+    const scheme = useColorScheme();
+    // Runs during render — before children paint, before effects fire.
+    if (syncColorScheme && typeof document !== "undefined") {
+        const el = document.documentElement;
+        const shouldBeDark = scheme === "dark";
+        if (el.classList.contains("dark") !== shouldBeDark) {
+            el.classList.toggle("dark", shouldBeDark);
+        }
+    }
+    return _jsx(_Fragment, { children: children });
+}
+//# sourceMappingURL=MentraProvider.js.map

package/dist/react/MentraProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MentraProvider.js","sourceRoot":"","sources":["../../src/react/MentraProvider.tsx"],"names":[],"mappings":";AAqBA,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAe/C,MAAM,UAAU,cAAc,CAAC,EAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,EAAsB;IACpF,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAE/B,mEAAmE;IACnE,IAAI,eAAe,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACvD,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAA;QACnC,MAAM,YAAY,GAAG,MAAM,KAAK,MAAM,CAAA;QACtC,IAAI,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,YAAY,EAAE,CAAC;YACnD,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,4BAAG,QAAQ,GAAI,CAAA;AACxB,CAAC"}

package/dist/react/MiniappHeader.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview MiniappHeader — drop-in header component that aligns with
+ * the host's floating capsule menu.
+ *
+ * The header has three slots: `left`, `title`, and `right`. Content auto-
+ * respects the safe area and leaves room for the capsule menu on the far
+ * top-right. Typical usage:
+ *
+ *   <MiniappHeader
+ *     title="My Miniapp"
+ *     left={<BackButton onClick={goBack} />}
+ *     right={<Badge>Connected</Badge>}
+ *   />
+ *
+ * If `title` is a string it renders as a semantic <h1>. Pass a ReactNode if
+ * you need custom styling. The component itself is unstyled beyond the
+ * layout — use `className` or `style` for theming.
+ */
+import type { CSSProperties, ReactNode } from "react";
+import { type UseCapsuleHeaderStyleOptions } from "./useCapsuleHeaderStyle";
+export interface MiniappHeaderProps extends UseCapsuleHeaderStyleOptions {
+    /** Title — string renders as <h1>; pass a node for custom markup. */
+    title?: ReactNode;
+    /** Left slot, typically a back button or logo. Overrides onBack if both set. */
+    left?: ReactNode;
+    /**
+     * Shortcut: when provided, renders a back chevron in the left slot that
+     * calls this handler. Ignored if `left` is explicitly set.
+     */
+    onBack?: () => void;
+    /** Right slot, typically a badge or action buttons. Sits to the left of the capsule. */
+    right?: ReactNode;
+    /** Custom className applied to the header element. */
+    className?: string;
+    /** Inline style overrides merged over the computed layout style. */
+    style?: CSSProperties;
+    /**
+     * When true, adds a 8px spacer <div> below the header so your next
+     * content doesn't sit flush against it. Default true.
+     */
+    bottomSpacer?: boolean;
+}
+export declare function MiniappHeader({ title, left, onBack, right, className, style, bottomSpacer, ...styleOptions }: MiniappHeaderProps): ReactNode;
+//# sourceMappingURL=MiniappHeader.d.ts.map

package/dist/react/MiniappHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MiniappHeader.d.ts","sourceRoot":"","sources":["../../src/react/MiniappHeader.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAE,SAAS,EAAC,MAAM,OAAO,CAAA;AAEnD,OAAO,EAAwB,KAAK,4BAA4B,EAAC,MAAM,yBAAyB,CAAA;AAEhG,MAAM,WAAW,kBAAmB,SAAQ,4BAA4B;IACtE,qEAAqE;IACrE,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,gFAAgF;IAChF,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,wFAAwF;IACxF,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oEAAoE;IACpE,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAmCD,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,MAAM,EACN,KAAK,EACL,SAAS,EACT,KAAK,EACL,YAAmB,EACnB,GAAG,YAAY,EAChB,EAAE,kBAAkB,GAAG,SAAS,CAiChC"}

package/dist/react/MiniappHeader.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCapsuleHeaderStyle } from "./useCapsuleHeaderStyle";
+function BackChevron({ onBack }) {
+    return (_jsx("button", { type: "button", onClick: onBack, "aria-label": "Back", style: {
+            display: "inline-flex",
+            alignItems: "center",
+            justifyContent: "center",
+            width: 32,
+            height: 32,
+            marginLeft: -8,
+            padding: 0,
+            border: "none",
+            background: "transparent",
+            color: "inherit",
+            cursor: "pointer",
+            borderRadius: 8,
+        }, children: _jsx("svg", { width: "22", height: "22", viewBox: "0 0 24 24", fill: "none", "aria-hidden": "true", children: _jsx("path", { d: "M15 18l-6-6 6-6", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round" }) }) }));
+}
+export function MiniappHeader({ title, left, onBack, right, className, style, bottomSpacer = true, ...styleOptions }) {
+    const computedStyle = useCapsuleHeaderStyle(styleOptions);
+    const resolvedLeft = left ?? (onBack ? _jsx(BackChevron, { onBack: onBack }) : null);
+    return (_jsxs(_Fragment, { children: [_jsxs("header", { className: className, style: { ...computedStyle, ...style }, children: [_jsxs("div", { style: { display: "flex", alignItems: "center", gap: 10, minWidth: 0, flex: 1 }, children: [resolvedLeft, typeof title === "string" ? (_jsx("h1", { style: {
+                                    fontSize: 18,
+                                    fontWeight: 600,
+                                    lineHeight: 1,
+                                    margin: 0,
+                                    whiteSpace: "nowrap",
+                                    overflow: "hidden",
+                                    textOverflow: "ellipsis",
+                                }, children: title })) : (title)] }), right ? (_jsx("div", { style: { display: "flex", alignItems: "center", gap: 8, flexShrink: 0 }, children: right })) : null] }), bottomSpacer ? _jsx("div", { style: { height: 8, flexShrink: 0 } }) : null] }));
+}
+//# sourceMappingURL=MiniappHeader.js.map

package/dist/react/MiniappHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MiniappHeader.js","sourceRoot":"","sources":["../../src/react/MiniappHeader.tsx"],"names":[],"mappings":";AAqBA,OAAO,EAAC,qBAAqB,EAAoC,MAAM,yBAAyB,CAAA;AAyBhG,SAAS,WAAW,CAAC,EAAC,MAAM,EAAuB;IACjD,OAAO,CACL,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,MAAM,gBACJ,MAAM,EACjB,KAAK,EAAE;YACL,OAAO,EAAE,aAAa;YACtB,UAAU,EAAE,QAAQ;YACpB,cAAc,EAAE,QAAQ;YACxB,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,CAAC,CAAC;YACd,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,MAAM;YACd,UAAU,EAAE,aAAa;YACzB,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,SAAS;YACjB,YAAY,EAAE,CAAC;SAChB,YACD,cAAK,KAAK,EAAC,IAAI,EAAC,MAAM,EAAC,IAAI,EAAC,OAAO,EAAC,WAAW,EAAC,IAAI,EAAC,MAAM,iBAAa,MAAM,YAC5E,eACE,CAAC,EAAC,iBAAiB,EACnB,MAAM,EAAC,cAAc,EACrB,WAAW,EAAC,GAAG,EACf,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,GACtB,GACE,GACC,CACV,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,MAAM,EACN,KAAK,EACL,SAAS,EACT,KAAK,EACL,YAAY,GAAG,IAAI,EACnB,GAAG,YAAY,EACI;IACnB,MAAM,aAAa,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAA;IACzD,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAC,WAAW,IAAC,MAAM,EAAE,MAAM,GAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAE9E,OAAO,CACL,8BACE,kBAAQ,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,EAAC,GAAG,aAAa,EAAE,GAAG,KAAK,EAAC,aAC/D,eAAK,KAAK,EAAE,EAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAC,aAC/E,YAAY,EACZ,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAC3B,aACE,KAAK,EAAE;oCACL,QAAQ,EAAE,EAAE;oCACZ,UAAU,EAAE,GAAG;oCACf,UAAU,EAAE,CAAC;oCACb,MAAM,EAAE,CAAC;oCACT,UAAU,EAAE,QAAQ;oCACpB,QAAQ,EAAE,QAAQ;oCAClB,YAAY,EAAE,UAAU;iCACzB,YACA,KAAK,GACH,CACN,CAAC,CAAC,CAAC,CACF,KAAK,CACN,IACG,EACL,KAAK,CAAC,CAAC,CAAC,CACP,cAAK,KAAK,EAAE,EAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAC,YAAG,KAAK,GAAO,CAC1F,CAAC,CAAC,CAAC,IAAI,IACD,EACR,YAAY,CAAC,CAAC,CAAC,cAAK,KAAK,EAAE,EAAC,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAC,GAAI,CAAC,CAAC,CAAC,IAAI,IAChE,CACJ,CAAA;AACH,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,13 @@
+export { useSafeArea } from "./useSafeArea";
+export type { UseSafeAreaResult } from "./useSafeArea";
+export { useColorScheme } from "./useColorScheme";
+export { useCapabilities } from "./useCapabilities";
+export { useConnected } from "./useConnected";
+export { useCapsuleHeaderStyle } from "./useCapsuleHeaderStyle";
+export type { UseCapsuleHeaderStyleOptions } from "./useCapsuleHeaderStyle";
+export { MiniappHeader } from "./MiniappHeader";
+export type { MiniappHeaderProps } from "./MiniappHeader";
+export { MentraProvider } from "./MentraProvider";
+export type { MentraProviderProps } from "./MentraProvider";
+export { useRpc, type RpcCallable } from "./useRpc";
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAA;AACzC,YAAY,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAA;AACpD,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAA;AAC7D,YAAY,EAAC,4BAA4B,EAAC,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAC7C,YAAY,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAC/C,YAAY,EAAC,mBAAmB,EAAC,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAC,MAAM,EAAE,KAAK,WAAW,EAAC,MAAM,UAAU,CAAA"}

package/dist/react/index.js

@@ -0,0 +1,9 @@
+export { useSafeArea } from "./useSafeArea";
+export { useColorScheme } from "./useColorScheme";
+export { useCapabilities } from "./useCapabilities";
+export { useConnected } from "./useConnected";
+export { useCapsuleHeaderStyle } from "./useCapsuleHeaderStyle";
+export { MiniappHeader } from "./MiniappHeader";
+export { MentraProvider } from "./MentraProvider";
+export { useRpc } from "./useRpc";
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAA;AAEzC,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAA;AAE7D,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAE7C,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAE/C,OAAO,EAAC,MAAM,EAAmB,MAAM,UAAU,CAAA"}

package/dist/react/useCapabilities.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview useCapabilities — React hook for the connected glasses'
+ * capability profile.
+ *
+ * The glasses `GlassesCapabilities` profile is *background-only* state: it
+ * arrives on the background `MiniappSession` (CONNECT_ACK / CAPABILITIES_UPDATE)
+ * and is never injected into the UI WebView, so there is no WebView-side source
+ * for it — this hook always returns `null`.
+ *
+ * If a UI page needs glasses capabilities, relay them from the background half
+ * over an app channel: read `session.capabilities` in a `session.ui.onOpen`
+ * handler, `session.ui.send("caps", ...)`, then read it in the UI with
+ * `mentra.on("caps", ...)`. See the example miniapp's `captions:snapshot`
+ * channel for the pattern.
+ *
+ * IMPORTANT: this hook must NOT construct a `MiniappSession`. That is the
+ * *background* (JSContext) API; inside a UI WebView its `CONNECT` never gets an
+ * ACK from the host's UI router and `session.connect()` times out
+ * ("CONNECT_ACK timeout") — the original reason this hook was rewritten.
+ *
+ * (Note: `window.MentraOS.capabilities` is a different thing — host *feature*
+ * flags like "share" / "open_url", not the glasses hardware profile.)
+ */
+import { type GlassesCapabilities } from "../session";
+export declare function useCapabilities(): GlassesCapabilities | null;
+//# sourceMappingURL=useCapabilities.d.ts.map

package/dist/react/useCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCapabilities.d.ts","sourceRoot":"","sources":["../../src/react/useCapabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAC,KAAK,mBAAmB,EAAC,MAAM,YAAY,CAAA;AAEnD,wBAAgB,eAAe,IAAI,mBAAmB,GAAG,IAAI,CAE5D"}

package/dist/react/useCapabilities.js

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview useCapabilities — React hook for the connected glasses'
+ * capability profile.
+ *
+ * The glasses `GlassesCapabilities` profile is *background-only* state: it
+ * arrives on the background `MiniappSession` (CONNECT_ACK / CAPABILITIES_UPDATE)
+ * and is never injected into the UI WebView, so there is no WebView-side source
+ * for it — this hook always returns `null`.
+ *
+ * If a UI page needs glasses capabilities, relay them from the background half
+ * over an app channel: read `session.capabilities` in a `session.ui.onOpen`
+ * handler, `session.ui.send("caps", ...)`, then read it in the UI with
+ * `mentra.on("caps", ...)`. See the example miniapp's `captions:snapshot`
+ * channel for the pattern.
+ *
+ * IMPORTANT: this hook must NOT construct a `MiniappSession`. That is the
+ * *background* (JSContext) API; inside a UI WebView its `CONNECT` never gets an
+ * ACK from the host's UI router and `session.connect()` times out
+ * ("CONNECT_ACK timeout") — the original reason this hook was rewritten.
+ *
+ * (Note: `window.MentraOS.capabilities` is a different thing — host *feature*
+ * flags like "share" / "open_url", not the glasses hardware profile.)
+ */
+export function useCapabilities() {
+    return null;
+}
+//# sourceMappingURL=useCapabilities.js.map

package/dist/react/useCapabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCapabilities.js","sourceRoot":"","sources":["../../src/react/useCapabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/react/useCapsuleHeaderStyle.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview useCapsuleHeaderStyle — ready-to-spread React CSS props that
+ * vertically align a header row with the host's floating capsule menu.
+ *
+ * Use this when you want full control over header markup but want the
+ * alignment math done for you. If you just want a stock header, use
+ * <MiniappHeader> instead.
+ *
+ * Example:
+ *   const style = useCapsuleHeaderStyle()
+ *   <header style={style}>
+ *     <h1>Hello</h1>
+ *   </header>
+ */
+import type { CSSProperties } from "react";
+export interface UseCapsuleHeaderStyleOptions {
+    /** Extra left padding beyond the safe area. Default 20px. */
+    leftPadding?: number;
+    /** Extra space between the header content and the capsule menu. Default 16px. */
+    rightGap?: number;
+    /** Fallback header height when no capsule menu is present. Default 32px. */
+    fallbackHeight?: number;
+    /** Fallback top margin when no capsule menu is present. Default 16px. */
+    fallbackMarginTop?: number;
+}
+export declare function useCapsuleHeaderStyle(options?: UseCapsuleHeaderStyleOptions): CSSProperties;
+//# sourceMappingURL=useCapsuleHeaderStyle.d.ts.map

package/dist/react/useCapsuleHeaderStyle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCapsuleHeaderStyle.d.ts","sourceRoot":"","sources":["../../src/react/useCapsuleHeaderStyle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,OAAO,CAAA;AAIxC,MAAM,WAAW,4BAA4B;IAC3C,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,aAAa,CAqBf"}