@glassly/miniapp 0.3.0-dev.1

package/dist/protocol.js

@@ -0,0 +1,413 @@
+/**
+ * @fileoverview Wire protocol for @glassly/miniapp.
+ *
+ * Fresh miniapp-naming enum values. No legacy tpa_/app_/applet_ prefixes.
+ * These values are the contract between @glassly/miniapp (running in a WebView)
+ * and LocalMiniappRuntime (running on the phone).
+ *
+ * IMPORTANT: This file has NO runtime dependency on @glassly/sdk. The cloud SDK's
+ * wire protocol enums live in @glassly/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";
+    /**
+     * Feed the device's firmware-rendered navigation UI (capability
+     * `hasNativeNavigation`): structured turn-by-turn card fields and
+     * pre-rendered map bitmaps. Only accepted while a trip is active.
+     */
+    MiniappRequestType["NATIVE_NAV"] = "miniapp_native_nav";
+    /** 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";
+    /** Read a bounded snapshot of phone calendar events. */
+    MiniappRequestType["CALENDAR_LIST_EVENTS"] = "miniapp_calendar_list_events";
+    /** 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";
+    /** Request nav permission up-front so start() doesn't have to (no dialog under Mapbox). */
+    MiniappRequestType["NAVIGATION_REQUEST_PERMISSION"] = "miniapp_navigation_request_permission";
+    /**
+     * Read a user-supplied provider API key (Settings > API Keys) by provider
+     * name. Requires the API_KEYS manifest permission; the host only serves an
+     * allowlisted provider set (see KeysModule) — notably the Soniox key is
+     * excluded. Keys are device-local; the value never transits any server.
+     */
+    MiniappRequestType["KEYS_GET"] = "miniapp_keys_get";
+    /**
+     * Run one LLM completion turn through the platform. Requires the AI manifest
+     * permission. The host routes to the cloud LLM service, which picks the
+     * provider and pays with the platform key — or with the user's own key when
+     * they've saved one for that provider (Settings > API Keys), in which case
+     * the call isn't metered against their plan.
+     *
+     * Single-shot or a client-side tool loop: when the model wants a tool run,
+     * the result comes back with stopReason "tool_use" and the calls to execute;
+     * append the answers and call again. The `webSearch` flag grants the
+     * provider's own server-side search tool; other provider server-side tools
+     * (Anthropic code_execution / Files API) and streaming are deliberately not
+     * exposed — see cloud-v2/packages/protocol/src/llm.ts.
+     */
+    MiniappRequestType["AI_COMPLETE"] = "miniapp_ai_complete";
+    MiniappRequestType["AI_GENERATE"] = "miniapp_ai_generate";
+    /** 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";
+    /**
+     * Shared user-level memory timeline (transcript lines + notes + hourly
+     * summaries), stored host-side and scoped to the USER — not to this
+     * miniapp's storage namespace. Requires the MEMORY manifest permission.
+     * The user manages the same timeline in Settings > Memory.
+     */
+    MiniappRequestType["MEMORY_APPEND_LINE"] = "miniapp_memory_append_line";
+    MiniappRequestType["MEMORY_ADD_NOTE"] = "miniapp_memory_add_note";
+    MiniappRequestType["MEMORY_REMOVE_ENTRY"] = "miniapp_memory_remove_entry";
+    MiniappRequestType["MEMORY_REMOVE_SCOPE"] = "miniapp_memory_remove_scope";
+    MiniappRequestType["MEMORY_SESSION_LIST"] = "miniapp_memory_session_list";
+    MiniappRequestType["MEMORY_QUERY"] = "miniapp_memory_query";
+    MiniappRequestType["MEMORY_WINDOW"] = "miniapp_memory_window";
+    MiniappRequestType["MEMORY_EXPORT_TEXT"] = "miniapp_memory_export_text";
+    MiniappRequestType["MEMORY_SUMMARY_ADD"] = "miniapp_memory_summary_add";
+    MiniappRequestType["MEMORY_SUMMARY_LIST"] = "miniapp_memory_summary_list";
+    MiniappRequestType["MEMORY_PENDING_SUMMARY_HOUR"] = "miniapp_memory_pending_summary_hour";
+    MiniappRequestType["MEMORY_CLEAR"] = "miniapp_memory_clear";
+    /**
+     * Resolve an enrolled-speaker id (`spk_…` from TranscriptionData.speakerId)
+     * to the user's display name for that speaker. Requires the SPEAKERS
+     * manifest permission — names are on-device PII and only cross into a
+     * miniapp through this explicit, user-visible gate.
+     */
+    MiniappRequestType["SPEAKERS_RESOLVE_NAME"] = "miniapp_speakers_resolve_name";
+    /** 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";
+    /** Explicitly enable/disable glasses-side VAD (GX8002). Mirrors the app's mic settings toggle. */
+    MiniappRequestType["MIC_SET_VAD_ENABLED"] = "miniapp_mic_set_vad_enabled";
+    /** Explicitly enable/disable the center-mic loudness gate ("Barrier"). */
+    MiniappRequestType["MIC_SET_LOUDNESS_GATE_ENABLED"] = "miniapp_mic_set_loudness_gate_enabled";
+    /**
+     * Enable or disable Wi-Fi ADB (wireless debugging) on Mentra Live.
+     * SYSTEM-only — host rejects with NOT_PERMITTED for non-system callers.
+     */
+    MiniappRequestType["SET_WIFI_ADB_STATE"] = "miniapp_set_wifi_adb_state";
+    /** 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";
+    /**
+     * Open a phone-camera QR scanner overlay. Host must not unmount the miniapp
+     * (clearing foreground fires UI_CLOSE and can hang up live sessions).
+     */
+    MiniappRequestType["SCAN_QR"] = "miniapp_scan_qr";
+    /**
+     * 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";
+    /** Bring the glasses' native dashboard (OS idle screen) to the foreground. */
+    MiniappRequestType["SHOW_NATIVE_DASHBOARD"] = "miniapp_show_native_dashboard";
+    // ----- 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 -----
+    // Lifecycle control (MINIAPPS_*) stays SYSTEM-only; the action layer
+    // (ACTIONS_LIST / ACTION_INVOKE) is open to every miniapp, gated per-action
+    // by the target's manifest `visibility`.
+    /** List installed miniapps (compatibility-filtered, with declared actions). SYSTEM-only. */
+    MiniappRequestType["MINIAPPS_LIST"] = "miniapp_apps_list";
+    /** Start another miniapp (user-tap semantics). SYSTEM-only. */
+    MiniappRequestType["MINIAPPS_START"] = "miniapp_apps_start";
+    /** Stop another miniapp. SYSTEM-only. */
+    MiniappRequestType["MINIAPPS_STOP"] = "miniapp_apps_stop";
+    /** Stop the CALLING miniapp itself. One-shot (no reply) and NOT system-gated. */
+    MiniappRequestType["MINIAPPS_STOP_SELF"] = "miniapp_apps_stop_self";
+    /** List every action the caller may invoke across installed miniapps (MCP tools/list analog). */
+    MiniappRequestType["ACTIONS_LIST"] = "miniapp_actions_list";
+    /** 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";
+    /** Ask the host to stop THIS miniapp (self-close; e.g. after finishing a one-shot action). */
+    MiniappRequestType["SYSTEM_EXIT"] = "miniapp_system_exit";
+})(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). */
+    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";
+    // 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";
+    /** The required phone OS permission is not currently granted. */
+    MiniappErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    /** 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";
+    /**
+     * The account's free-tier allowance for this feature (e.g. monthly AI
+     * credit) is used up. Not retryable this period; the user can upgrade or
+     * the miniapp can fall back to a non-cloud path.
+     */
+    MiniappErrorCode["QUOTA_EXCEEDED"] = "QUOTA_EXCEEDED";
+    /** 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";
+    /** `speak({forceLocal: true})` but the on-device offline TTS model isn't downloaded/ready. */
+    MiniappErrorCode["TTS_LOCAL_UNAVAILABLE"] = "TTS_LOCAL_UNAVAILABLE";
+    /** Not connected / pre-ACK and transport closed. */
+    MiniappErrorCode["NOT_CONNECTED"] = "NOT_CONNECTED";
+    // ----- Inter-miniapp interop -----
+    /**
+     * Caller is not a system app — SYSTEM-only APIs (interop list/start/stop/invoke,
+     * setWifiAdbState) reject with this code.
+     */
+    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":"AAAA;;;;;;;;;;GAUG;AAEH,+EAA+E;AAC/E,iDAAiD;AACjD,+EAA+E;AAE/E,MAAM,CAAN,IAAY,kBAsQX;AAtQD,WAAY,kBAAkB;IAC5B,8EAA8E;IAC9E,iDAA2B,CAAA;IAE3B,yDAAyD;IACzD,2DAAqC,CAAA;IAErC,8DAA8D;IAC9D,qDAA+B,CAAA;IAE/B;;;;OAIG;IACH,iDAA2B,CAAA;IAE3B,uEAAuE;IACvE,+CAAyB,CAAA;IAEzB;;;;OAIG;IACH,uDAAiC,CAAA;IAEjC,8EAA8E;IAC9E,uDAAiC,CAAA;IAEjC,sDAAsD;IACtD,uDAAiC,CAAA;IAEjC,2DAA2D;IAC3D,6CAAuB,CAAA;IAEvB;;;;;OAKG;IACH,yEAAmD,CAAA;IACnD,2EAAqD,CAAA;IACrD,2EAAqD,CAAA;IACrD,2EAAqD,CAAA;IAErD,mCAAmC;IACnC,iDAA2B,CAAA;IAE3B,8BAA8B;IAC9B,6DAAuC,CAAA;IAEvC,wDAAwD;IACxD,2EAAqD,CAAA;IAErD,0DAA0D;IAC1D,mEAA6C,CAAA;IAC7C,gDAAgD;IAChD,iEAA2C,CAAA;IAC3C,mFAAmF;IACnF,uEAAiD,CAAA;IACjD,0FAA0F;IAC1F,6FAAuE,CAAA;IACvE,qFAAqF;IACrF,6FAAuE,CAAA;IACvE,sFAAsF;IACtF,2EAAqD,CAAA;IACrD,sFAAsF;IACtF,mFAA6D,CAAA;IAC7D;;;;6EAIyE;IACzE,uFAAiE,CAAA;IACjE;;sFAEkF;IAClF,6FAAuE,CAAA;IACvE;4DACwD;IACxD,mFAA6D,CAAA;IAC7D,2FAA2F;IAC3F,6FAAuE,CAAA;IAEvE;;;;;OAKG;IACH,mDAA6B,CAAA;IAE7B;;;;;;;;;;;;;OAaG;IACH,yDAAmC,CAAA;IACnC,yDAAmC,CAAA;IAEnC,kCAAkC;IAClC,yDAAmC,CAAA;IACnC,yDAAmC,CAAA;IACnC,+DAAyC,CAAA;IACzC,2DAAqC,CAAA;IACrC,6DAAuC,CAAA;IACvC,yDAAmC,CAAA;IACnC,iEAA2C,CAAA;IAC3C,2EAAqD,CAAA;IACrD,6DAAuC,CAAA;IAEvC;;;;;OAKG;IACH,uEAAiD,CAAA;IACjD,iEAA2C,CAAA;IAC3C,yEAAmD,CAAA;IACnD,yEAAmD,CAAA;IACnD,yEAAmD,CAAA;IACnD,2DAAqC,CAAA;IACrC,6DAAuC,CAAA;IACvC,uEAAiD,CAAA;IACjD,uEAAiD,CAAA;IACjD,yEAAmD,CAAA;IACnD,yFAAmE,CAAA;IACnE,2DAAqC,CAAA;IAErC;;;;;OAKG;IACH,6EAAuD,CAAA;IAEvD,iCAAiC;IACjC,uDAAiC,CAAA;IAEjC,2EAA2E;IAC3E,+DAAyC,CAAA;IAEzC;;;;OAIG;IACH,iEAA2C,CAAA;IAE3C,kGAAkG;IAClG,yEAAmD,CAAA;IACnD,0EAA0E;IAC1E,6FAAuE,CAAA;IAEvE;;;OAGG;IACH,uEAAiD,CAAA;IAEjD,4CAA4C;IAC5C,6CAAuB,CAAA;IACvB,wCAAwC;IACxC,mDAA6B,CAAA;IAC7B,yCAAyC;IACzC,+DAAyC,CAAA;IACzC,mEAAmE;IACnE,mDAA6B,CAAA;IAC7B;;;OAGG;IACH,iDAA2B,CAAA;IAE3B;;;;;OAKG;IACH,yDAAmC,CAAA;IACnC,uDAAiC,CAAA;IACjC,yDAAmC,CAAA;IACnC,uDAAiC,CAAA;IACjC,mDAA6B,CAAA;IAC7B,qDAA+B,CAAA;IAC/B,yDAAmC,CAAA;IACnC,uDAAiC,CAAA;IACjC,uDAAiC,CAAA;IACjC,+DAAyC,CAAA;IACzC,qDAA+B,CAAA;IAC/B,iEAA2C,CAAA;IAC3C,kFAAkF;IAClF,qEAA+C,CAAA;IAC/C,iFAAiF;IACjF,yDAAmC,CAAA;IACnC,wFAAwF;IACxF,uDAAiC,CAAA;IAEjC,0EAA0E;IAC1E,2CAAqB,CAAA;IAErB;;;;OAIG;IACH,2EAAqD,CAAA;IAErD,6BAA6B;IAE7B,4CAA4C;IAC5C,mFAA6D,CAAA;IAE7D,8EAA8E;IAC9E,6EAAuD,CAAA;IAEvD,gCAAgC;IAChC,6CAAuB,CAAA;IACvB,6EAAuD,CAAA;IACvD,2EAAqD,CAAA;IACrD,2DAAqC,CAAA;IACrC,yDAAmC,CAAA;IACnC,2EAAqD,CAAA;IACrD,yEAAmD,CAAA;IAEnD,oGAAoG;IACpG,uEAAiD,CAAA;IAEjD,oCAAoC;IACpC,qEAAqE;IACrE,4EAA4E;IAC5E,yCAAyC;IACzC,4FAA4F;IAC5F,yDAAmC,CAAA;IACnC,+DAA+D;IAC/D,2DAAqC,CAAA;IACrC,yCAAyC;IACzC,yDAAmC,CAAA;IACnC,iFAAiF;IACjF,mEAA6C,CAAA;IAC7C,iGAAiG;IACjG,2DAAqC,CAAA;IACrC,iFAAiF;IACjF,6DAAuC,CAAA;IACvC,kFAAkF;IAClF,6DAAuC,CAAA;IACvC,8FAA8F;IAC9F,yDAAmC,CAAA;AACrC,CAAC,EAtQW,kBAAkB,KAAlB,kBAAkB,QAsQ7B;AAED,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E,MAAM,CAAN,IAAY,mBA4DX;AA5DD,WAAY,mBAAmB;IAC7B,sEAAsE;IACtE,0DAAmC,CAAA;IAEnC,sDAAsD;IACtD,8CAAuB,CAAA;IAEvB,0EAA0E;IAC1E,gEAAyC,CAAA;IAEzC,0CAA0C;IAC1C,0EAAmD,CAAA;IAEnD,2DAA2D;IAC3D,sEAA+C,CAAA;IAE/C,oDAAoD;IACpD,0EAAmD,CAAA;IAEnD;;;;OAIG;IACH,8DAAuC,CAAA;IAEvC;;;;OAIG;IACH,wEAAiD,CAAA;IAEjD;;;OAGG;IACH,0DAAmC,CAAA;IAEnC,qEAAqE;IACrE,4CAAqB,CAAA;IAErB;;;;;OAKG;IACH,0DAAmC,CAAA;IAEnC;;;;;OAKG;IACH,kEAA2C,CAAA;IAE3C,kDAAkD;IAClD,8CAAuB,CAAA;AACzB,CAAC,EA5DW,mBAAmB,KAAnB,mBAAmB,QA4D9B;AAED,+EAA+E;AAC/E,0CAA0C;AAC1C,+EAA+E;AAE/E,MAAM,CAAN,IAAY,iBA6CX;AA7CD,WAAY,iBAAiB;IAC3B,0BAA0B;IAC1B,kDAA6B,CAAA;IAC7B,gDAA2B,CAAA;IAC3B,oDAA+B,CAAA;IAC/B;;;;OAIG;IACH,8CAAyB,CAAA;IAEzB,SAAS;IACT,wDAAmC,CAAA;IACnC,oDAA+B,CAAA;IAC/B,8DAAyC,CAAA;IACzC,2FAA2F;IAC3F,kDAA6B,CAAA;IAE7B,kCAAkC;IAClC,oDAA+B,CAAA;IAC/B,gDAA2B,CAAA;IAC3B,gDAA2B,CAAA;IAC3B,gCAAW,CAAA;IAEX,gBAAgB;IAChB,wDAAmC,CAAA;IACnC,8CAA8C;IAC9C,sDAAiC,CAAA;IACjC,8EAA8E;IAC9E,4DAAuC,CAAA;IACvC,gFAAgF;IAChF,0DAAqC,CAAA;IACrC,8DAAyC,CAAA;IACzC;;;;;;OAMG;IACH,kFAA6D,CAAA;IAC7D,oBAAoB;IACpB,gDAA2B,CAAA;IAC3B,oDAA+B,CAAA;AACjC,CAAC,EA7CW,iBAAiB,KAAjB,iBAAiB,QA6C5B;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,CAAN,IAAY,gBAyEX;AAzED,WAAY,gBAAgB;IAC1B,qDAAqD;IACrD,yDAAqC,CAAA;IAErC,2FAA2F;IAC3F,uEAAmD,CAAA;IAEnD,iEAAiE;IACjE,2DAAuC,CAAA;IAEvC,2DAA2D;IAC3D,uDAAmC,CAAA;IAEnC,+EAA+E;IAC/E,uDAAmC,CAAA;IAEnC,mDAAmD;IACnD,yCAAqB,CAAA;IAErB;;;;OAIG;IACH,qDAAiC,CAAA;IAEjC,wDAAwD;IACxD,2DAAuC,CAAA;IACvC,2DAAuC,CAAA;IACvC,6DAAyC,CAAA;IAEzC,8FAA8F;IAC9F,mEAA+C,CAAA;IAE/C,oDAAoD;IACpD,mDAA+B,CAAA;IAE/B,oCAAoC;IACpC;;;OAGG;IACH,mDAA+B,CAAA;IAC/B,uCAAuC;IACvC,mDAA+B,CAAA;IAC/B,iEAAiE;IACjE,6DAAyC,CAAA;IACzC,4DAA4D;IAC5D,yDAAqC,CAAA;IACrC,iGAAiG;IACjG,2DAAuC,CAAA;IACvC,4EAA4E;IAC5E,+CAA2B,CAAA;IAC3B,iEAAiE;IACjE,qDAAiC,CAAA;IACjC,4DAA4D;IAC5D,2DAAuC,CAAA;IAEvC,sCAAsC;IACtC,6DAA6D;IAC7D,qDAAiC,CAAA;IACjC,6DAA6D;IAC7D,+DAA2C,CAAA;IAC3C,iEAAiE;IACjE,qDAAiC,CAAA;IACjC,gFAAgF;IAChF,+DAA2C,CAAA;IAC3C,gEAAgE;IAChE,2DAAuC,CAAA;IACvC,wEAAwE;IACxE,iEAA6C,CAAA;IAC7C,kFAAkF;IAClF,6DAAyC,CAAA;AAC3C,CAAC,EAzEW,gBAAgB,KAAhB,gBAAgB,QAyE3B"}

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;AA6BD,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,CA+BhC"}

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,eAAM,CAAC,EAAC,iBAAiB,EAAC,MAAM,EAAC,cAAc,EAAC,WAAW,EAAC,GAAG,EAAC,aAAa,EAAC,OAAO,EAAC,cAAc,EAAC,OAAO,GAAG,GAC3G,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,cAAK,KAAK,EAAE,EAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAC,YAAG,KAAK,GAAO,CAAC,CAAC,CAAC,IAAI,IAClG,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/MiniappProvider.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview MiniappProvider — 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(
+ *     <MiniappProvider>
+ *       <App />
+ *     </MiniappProvider>
+ *   )
+ *
+ * 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 MiniappProviderProps {
+    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 MiniappProvider({ children, syncColorScheme }: MiniappProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=MiniappProvider.d.ts.map

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

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

package/dist/react/MiniappProvider.js

@@ -0,0 +1,15 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useColorScheme } from "./useColorScheme";
+export function MiniappProvider({ 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=MiniappProvider.js.map

package/dist/react/MiniappProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MiniappProvider.js","sourceRoot":"","sources":["../../src/react/MiniappProvider.tsx"],"names":[],"mappings":";AAqBA,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAe/C,MAAM,UAAU,eAAe,CAAC,EAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,EAAuB;IACtF,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/capsuleHeaderLayout.d.ts

@@ -0,0 +1,3 @@
+import type { MiniappCapsuleMenuRect } from "../globals";
+export declare function getCapsuleHeaderPaddingRight(capsuleMenu: MiniappCapsuleMenuRect, viewportWidth: number, safeAreaRight: number, rightGap: number): number;
+//# sourceMappingURL=capsuleHeaderLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capsuleHeaderLayout.d.ts","sourceRoot":"","sources":["../../src/react/capsuleHeaderLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,YAAY,CAAA;AAEtD,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,sBAAsB,EACnC,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM,CAGR"}

package/dist/react/capsuleHeaderLayout.js

@@ -0,0 +1,5 @@
+export function getCapsuleHeaderPaddingRight(capsuleMenu, viewportWidth, safeAreaRight, rightGap) {
+    const capsuleOffsetFromContentRight = viewportWidth - capsuleMenu.left - safeAreaRight;
+    return Math.max(rightGap, capsuleOffsetFromContentRight + rightGap);
+}
+//# sourceMappingURL=capsuleHeaderLayout.js.map

package/dist/react/capsuleHeaderLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capsuleHeaderLayout.js","sourceRoot":"","sources":["../../src/react/capsuleHeaderLayout.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,4BAA4B,CAC1C,WAAmC,EACnC,aAAqB,EACrB,aAAqB,EACrB,QAAgB;IAEhB,MAAM,6BAA6B,GAAG,aAAa,GAAG,WAAW,CAAC,IAAI,GAAG,aAAa,CAAA;IACtF,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,6BAA6B,GAAG,QAAQ,CAAC,CAAA;AACrE,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 { MiniappProvider } from "./MiniappProvider";
+export type { MiniappProviderProps } from "./MiniappProvider";
+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,eAAe,EAAC,MAAM,mBAAmB,CAAA;AACjD,YAAY,EAAC,oBAAoB,EAAC,MAAM,mBAAmB,CAAA;AAC3D,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 { MiniappProvider } from "./MiniappProvider";
+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,eAAe,EAAC,MAAM,mBAAmB,CAAA;AAEjD,OAAO,EAAC,MAAM,EAAmB,MAAM,UAAU,CAAA"}