mcp-native 0.8.0 → 0.9.1

package/README.md

@@ -2,7 +2,7 @@
 
 # mcp-native
 
-### One entry point for the MCP Native experimental runtime
+### One entry point for the MCP Native React Native host runtime
 
 [![npm](https://img.shields.io/npm/v/mcp-native)](https://www.npmjs.com/package/mcp-native)
 [![downloads](https://img.shields.io/npm/dm/mcp-native)](https://www.npmjs.com/package/mcp-native)
@@ -13,11 +13,23 @@
 
 </div>
 
-> **Experimental:** MCP Native is a proof of concept, not a production-ready MCP or React Native runtime. APIs may change before `1.0.0`.
+> **Pre-1.0 release candidate:** MCP Native `0.9.x` is feature-complete for the documented React
+> Native host scope, and the proposed `1.0.0` API is frozen. The stable compatibility guarantee
+> begins after the remaining independent review and release gates are complete. Shipping hosts must
+> still audit their policies, component mappings, permissions, WebView integration, and platform
+> behavior.
 
-> **Compatibility:** the initial tool/resource boundary preserves MCP `2026-07-28` fields, but complete MCP conformance is still in progress. The package exposes the feature-scoped A2UI v1.0 Candidate profile and retains custom `0.1` APIs only as deprecated migration support; this is not an unqualified A2UI renderer claim. It also re-exports the documented stable MCP Apps `2026-01-26` native host-adapter profile. See the [A2UI profile](https://github.com/pablospaniard/mcp-native/blob/main/docs/a2ui-v1-conformance.md), [MCP Apps profile](https://github.com/pablospaniard/mcp-native/blob/main/docs/mcp-apps-compatibility.md), and [standards matrix](https://github.com/pablospaniard/mcp-native/blob/main/docs/standards-compatibility.md).
+> **Compatibility:** the documented tool/resource and authorization boundary preserves MCP
+> `2026-07-28` fields and passes its pinned conformance coverage. The package exposes the
+> feature-scoped A2UI v1.0 Candidate profile and retains custom `0.1` APIs only as deprecated
+> migration support; this is not an unqualified A2UI renderer claim. It also re-exports the
+> documented stable MCP Apps `2026-01-26` native host-adapter profile. See the [A2UI profile](https://github.com/pablospaniard/mcp-native/blob/main/docs/a2ui-v1-conformance.md), [MCP Apps profile](https://github.com/pablospaniard/mcp-native/blob/main/docs/mcp-apps-compatibility.md), and [standards matrix](https://github.com/pablospaniard/mcp-native/blob/main/docs/standards-compatibility.md).
 
-`mcp-native` is the convenience package for the runtime and UI APIs. It re-exports the runtime contracts, A2UI v1 lifecycle/capability/renderer-message APIs, trusted native renderer and hooks, deprecated custom surface migration APIs, and policy-gated WebView compatibility primitives from focused `@mcp-native/*` packages. Transport adapters are installed separately.
+`mcp-native` is the convenience package for the runtime and UI APIs. It re-exports the runtime contracts, A2UI v1 lifecycle/capability/renderer-message APIs, trusted native renderer and hooks, host-owned mixed-surface coordinator, deprecated custom surface migration APIs, and policy-gated WebView compatibility primitives from focused `@mcp-native/*` packages. Transport adapters are installed separately.
+
+Read the human-oriented [product guide](https://github.com/pablospaniard/mcp-native/blob/main/docs/product-guide.md)
+and [mixed-surface guide](https://github.com/pablospaniard/mcp-native/blob/main/docs/mixed-surfaces.md)
+before the API examples.
 
 ## Install
 
@@ -39,6 +51,9 @@ and the [`@mcp-native/react-native` adapter documentation](https://github.com/pa
 
 ## Deprecated `0.1` proof-model preview
 
+For `0.9.x`, migrate these imports to `mcp-native/legacy`. Root aliases are removed at `1.0.0`;
+the explicit legacy subpath stays frozen for migration and security fixes.
+
 ```tsx
 import {
   McpNativeSurface,
@@ -112,10 +127,10 @@ Install an individual package instead when you only need one layer.
 
 Use the separately installable [`@mcp-native/mcp`](https://github.com/pablospaniard/mcp-native/tree/main/packages/mcp) package to connect these APIs to the official MCP TypeScript SDK without forcing that SDK dependency on every `mcp-native` consumer.
 
-## What works today
+## Implemented in `0.9.0`
 
 - transport-independent MCP runtime contracts;
-- strict validation for container, text, button, and text-input nodes;
+- isolated migration support for the deprecated custom `0.1` surface;
 - declared tool-action dispatch;
 - strict A2UI resource-link resolution from tool results;
 - schema-validated A2UI v1 JSONL lifecycle state and explicit host policies;
@@ -133,21 +148,24 @@ Use the separately installable [`@mcp-native/mcp`](https://github.com/pablospani
 - typed adapters from trusted semantics into locally bundled design-system components;
 - exact namespaced host-extension manifests, negotiation, opaque registries, local Fabric
   registration, policy grants, and schema-valid events with inline catalogs disabled;
+- host-owned native A2UI and isolated MCP Apps sibling lifecycle coordination;
 - memoized render-plan and safely observed asynchronous action-dispatch hooks;
 - policy-gated inline and remote HTML document descriptions;
 - MCP `2026-07-28` tool/resource field preservation through the official SDK adapter;
 - pinned current-protocol integration coverage through the SDK HTTP handler/fetch path;
 - ESM exports, TypeScript declarations, automated tests, and signed npm provenance.
 
-Release `0.8.0` adds policy-gated `Video` and `AudioPlayer`, completes the pinned A2UI basic catalog,
-and adds exact namespaced manifests and local registration for compiled host extensions. Release
-`0.7.0` added the
+Release `0.9.0` adds host-owned mixed native/MCP Apps composition, a production-shaped reference
+host, and the frozen `1.0.0` release-candidate API. Release `0.8.0` added policy-gated `Video` and
+`AudioPlayer`, completed the pinned A2UI basic catalog, and added exact namespaced manifests and
+local registration for compiled host extensions. Release `0.7.0` added the
 non-media catalog, typed renderer-local bindings, bounded formatting and validation, host-callback
 actions, required image grants, policy-gated HTTP(S) `openUrl`, and exact installed-subset
 discovery. Release `0.6.0` added bounded consent, expiring/revocable host-owned grants, interactive
-OAuth, scope history, lifecycle coordination, actionable states, and redacted operations. Complete
-MCP and A2UI conformance, full streaming host integration, transport placement for A2UI capability
-objects, and separate non-blocking Expo Go integration PoCs remain future work. Follow the
+OAuth, scope history, lifecycle coordination, actionable states, and redacted operations. The
+packages intentionally do not claim MCP operations or A2UI features outside their documented
+profiles. Full streaming host integration, transport placement for A2UI capability objects, and
+separate non-blocking Expo Go integration PoCs remain deferred or excluded work. Follow the
 [roadmap](https://github.com/pablospaniard/mcp-native/blob/main/docs/roadmap.md) for exact claim
 boundaries.
 
@@ -155,7 +173,7 @@ boundaries.
 
 Remote servers may provide declarative UI and actions, but the host owns component resolution, tool execution, permissions, and every sensitive capability. Unknown data fails closed at validation and policy boundaries.
 
-Read the full [architecture](https://github.com/pablospaniard/mcp-native/blob/main/docs/RFC-0001-architecture.md) and [security policy](https://github.com/pablospaniard/mcp-native/blob/main/SECURITY.md) before using or extending the proof of concept.
+Read the full [architecture](https://github.com/pablospaniard/mcp-native/blob/main/docs/RFC-0001-architecture.md) and [security policy](https://github.com/pablospaniard/mcp-native/blob/main/SECURITY.md) before integrating or extending the runtime.
 
 ## License
 

package/dist/index.d.ts

@@ -2,4 +2,5 @@ export * from "@mcp-native/core";
 export * from "@mcp-native/a2ui";
 export * from "@mcp-native/react-native";
 export * from "@mcp-native/webview";
+export * from "./mixed-surfaces.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -2,4 +2,5 @@ export * from "@mcp-native/core";
 export * from "@mcp-native/a2ui";
 export * from "@mcp-native/react-native";
 export * from "@mcp-native/webview";
+export * from "./mixed-surfaces.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/legacy.d.ts

@@ -0,0 +1,4 @@
+/** Explicit compatibility entry point for the frozen custom A2UI `0.1` proof surface. */
+export * from "@mcp-native/a2ui/legacy";
+export * from "@mcp-native/react-native/legacy";
+//# sourceMappingURL=legacy.d.ts.map

package/dist/legacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.d.ts","sourceRoot":"","sources":["../src/legacy.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC"}

package/dist/legacy.js

@@ -0,0 +1,4 @@
+/** Explicit compatibility entry point for the frozen custom A2UI `0.1` proof surface. */
+export * from "@mcp-native/a2ui/legacy";
+export * from "@mcp-native/react-native/legacy";
+//# sourceMappingURL=legacy.js.map

package/dist/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.js","sourceRoot":"","sources":["../src/legacy.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC"}

package/dist/mixed-surfaces.d.ts

@@ -0,0 +1,129 @@
+import { type A2uiV1SurfaceState, type A2uiV1SurfaceValidationPolicy } from "@mcp-native/a2ui";
+import { McpAppsBridge, type McpAppsNativeSandboxConfiguration, type McpAppsResource } from "@mcp-native/webview";
+export declare const MCP_NATIVE_MIXED_MAX_REGIONS = 32;
+export declare const MCP_NATIVE_MIXED_MAX_LISTENERS = 64;
+export type McpNativeMixedSurfaceKind = "a2ui" | "mcp-app";
+export type McpNativeMixedSurfaceActivity = "background" | "foreground";
+export type McpNativeMixedSurfaceVisibility = "hidden" | "visible";
+export type McpNativeMixedSurfaceStatus = "cancelled" | "crashed" | "ready" | "starting";
+export type McpNativeMixedSurfaceMemoryPressure = "critical" | "moderate";
+export type McpNativeMixedSurfaceOrientation = "landscape-left" | "landscape-right" | "portrait" | "portrait-upside-down" | "unknown";
+export interface McpNativeMixedSurfaceEnvironment {
+    readonly dynamicTypeScale: number;
+    readonly keyboardVisible: boolean;
+    readonly orientation: McpNativeMixedSurfaceOrientation;
+    readonly reducedMotion: boolean;
+}
+export interface McpNativeMixedSurfaceLifecycle {
+    readonly onCreate?: () => void | Promise<void>;
+    readonly onVisibilityChange?: (visibility: McpNativeMixedSurfaceVisibility) => void | Promise<void>;
+    readonly onActivityChange?: (activity: McpNativeMixedSurfaceActivity) => void | Promise<void>;
+    readonly onFocusChange?: (focused: boolean) => void | Promise<void>;
+    readonly onEnvironmentChange?: (environment: McpNativeMixedSurfaceEnvironment) => void | Promise<void>;
+    readonly onBack?: () => boolean | Promise<boolean>;
+    readonly onCancel?: (reason?: string) => void | Promise<void>;
+    readonly onCrash?: (error: unknown) => void | Promise<void>;
+    readonly onRecover?: () => void | Promise<void>;
+    readonly onMemoryPressure?: (pressure: McpNativeMixedSurfaceMemoryPressure) => void | Promise<void>;
+    readonly onDispose?: () => void | Promise<void>;
+}
+interface McpNativeMixedSurfaceRegionBase {
+    /** Host-authored stable identifier. Server surface IDs and resource URIs are not used here. */
+    readonly id: string;
+    readonly accessibilityLabel: string;
+    readonly kind: McpNativeMixedSurfaceKind;
+}
+export interface McpNativeMixedA2uiRegion extends McpNativeMixedSurfaceRegionBase {
+    readonly kind: "a2ui";
+    /** Reconstructed and revalidated snapshot owned by this host registration. */
+    readonly surface: A2uiV1SurfaceState;
+}
+export interface McpNativeMixedMcpAppsRegion extends McpNativeMixedSurfaceRegionBase {
+    readonly kind: "mcp-app";
+    readonly bridge: McpAppsBridge;
+    /** Opaque sandbox created by `createMcpAppsNativeSandbox`. */
+    readonly sandbox: McpAppsNativeSandboxConfiguration;
+}
+export type McpNativeMixedSurfaceRegion = McpNativeMixedA2uiRegion | McpNativeMixedMcpAppsRegion;
+export interface CreateMcpNativeMixedA2uiRegionOptions {
+    readonly id: string;
+    readonly accessibilityLabel: string;
+    readonly surface: A2uiV1SurfaceState;
+    readonly policy: A2uiV1SurfaceValidationPolicy;
+    readonly lifecycle?: McpNativeMixedSurfaceLifecycle;
+}
+export interface CreateMcpNativeMixedMcpAppsRegionOptions {
+    readonly id: string;
+    readonly accessibilityLabel: string;
+    readonly resource: McpAppsResource;
+    readonly sandbox: McpAppsNativeSandboxConfiguration;
+    readonly bridge: McpAppsBridge;
+    readonly lifecycle?: McpNativeMixedSurfaceLifecycle;
+}
+export interface McpNativeMixedSurfaceRegionSnapshot {
+    readonly accessibilityLabel: string;
+    /** Sibling order authored by the host; isolated WebViews retain their own accessibility tree. */
+    readonly accessibilityOrder: number;
+    readonly accessibilityTree: "isolated-webview" | "native";
+    readonly focused: boolean;
+    readonly id: string;
+    readonly kind: McpNativeMixedSurfaceKind;
+    readonly status: McpNativeMixedSurfaceStatus;
+    readonly visibility: McpNativeMixedSurfaceVisibility;
+}
+export interface McpNativeMixedSurfaceSnapshot {
+    readonly activity: McpNativeMixedSurfaceActivity;
+    readonly disposed: boolean;
+    readonly environment: McpNativeMixedSurfaceEnvironment;
+    readonly focusedRegionId?: string;
+    readonly regions: readonly McpNativeMixedSurfaceRegionSnapshot[];
+    readonly started: boolean;
+}
+export interface McpNativeMixedSurfaceCoordinatorOptions {
+    /** Factory-created, host-authored sibling regions in accessibility order. */
+    readonly regions: readonly McpNativeMixedSurfaceRegion[];
+    readonly initialActivity?: McpNativeMixedSurfaceActivity;
+    readonly initialEnvironment?: Partial<McpNativeMixedSurfaceEnvironment>;
+    readonly initialFocusedRegionId?: string;
+    readonly initialVisibleRegionIds?: readonly string[];
+}
+export declare class McpNativeMixedSurfaceError extends Error {
+    readonly regionId: string | undefined;
+    constructor(message: string, options?: ErrorOptions & {
+        readonly regionId?: string;
+    });
+}
+/**
+ * Creates one native sibling registration from a validated, host-policy-approved A2UI snapshot.
+ * This factory has no WebView fields, so declarative A2UI data cannot create or configure a View.
+ */
+export declare function createMcpNativeMixedA2uiRegion(options: CreateMcpNativeMixedA2uiRegionOptions): McpNativeMixedA2uiRegion;
+/**
+ * Creates one isolated MCP Apps sibling from an opaque sandbox, its exact resource, and bridge.
+ * The server cannot select native WebView props or lifecycle callbacks through this boundary.
+ */
+export declare function createMcpNativeMixedMcpAppsRegion(options: CreateMcpNativeMixedMcpAppsRegionOptions): McpNativeMixedMcpAppsRegion;
+/**
+ * Serializes host lifecycle changes across fixed sibling regions. It does not parse a layout,
+ * render a component, navigate a WebView, or forward messages between native and Apps regions.
+ */
+export declare class McpNativeMixedSurfaceCoordinator {
+    #private;
+    constructor(options: McpNativeMixedSurfaceCoordinatorOptions);
+    getSnapshot: () => McpNativeMixedSurfaceSnapshot;
+    getRegion(id: string): McpNativeMixedSurfaceRegion | undefined;
+    subscribe(listener: () => void): () => void;
+    start(): Promise<void>;
+    setActivity(activity: McpNativeMixedSurfaceActivity): Promise<void>;
+    setEnvironment(environment: McpNativeMixedSurfaceEnvironment): Promise<void>;
+    setVisibleRegions(ids: readonly string[]): Promise<void>;
+    transferFocus(id?: string): Promise<void>;
+    handleBack(): Promise<boolean>;
+    cancel(id: string, reason?: string): Promise<void>;
+    reportCrash(id: string, error: unknown): Promise<void>;
+    recover(id: string): Promise<void>;
+    handleMemoryPressure(pressure: McpNativeMixedSurfaceMemoryPressure): Promise<void>;
+    dispose(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=mixed-surfaces.d.ts.map

package/dist/mixed-surfaces.d.ts.map

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

package/dist/mixed-surfaces.js

@@ -0,0 +1,598 @@
+import { validateA2uiV1SurfaceState, } from "@mcp-native/a2ui";
+import { McpAppsBridge, isMcpAppsBridgeBinding, isMcpAppsNativeSandboxConfiguration, } from "@mcp-native/webview";
+export const MCP_NATIVE_MIXED_MAX_REGIONS = 32;
+export const MCP_NATIVE_MIXED_MAX_LISTENERS = 64;
+const registeredRegions = new WeakSet();
+const coordinatedRegions = new WeakSet();
+const regionLifecycles = new WeakMap();
+export class McpNativeMixedSurfaceError extends Error {
+    regionId;
+    constructor(message, options) {
+        super(message, options);
+        this.name = "McpNativeMixedSurfaceError";
+        this.regionId = options?.regionId;
+    }
+}
+/**
+ * Creates one native sibling registration from a validated, host-policy-approved A2UI snapshot.
+ * This factory has no WebView fields, so declarative A2UI data cannot create or configure a View.
+ */
+export function createMcpNativeMixedA2uiRegion(options) {
+    expectFactoryOptions(options);
+    const region = Object.freeze({
+        id: expectRegionId(options.id),
+        accessibilityLabel: expectAccessibilityLabel(options.accessibilityLabel),
+        kind: "a2ui",
+        surface: validateA2uiV1SurfaceState(options.surface, options.policy),
+    });
+    registerRegion(region, options.lifecycle);
+    return region;
+}
+/**
+ * Creates one isolated MCP Apps sibling from an opaque sandbox, its exact resource, and bridge.
+ * The server cannot select native WebView props or lifecycle callbacks through this boundary.
+ */
+export function createMcpNativeMixedMcpAppsRegion(options) {
+    expectFactoryOptions(options);
+    if (!isMcpAppsNativeSandboxConfiguration(options.sandbox)) {
+        throw new McpNativeMixedSurfaceError("Mixed MCP Apps regions require an opaque createMcpAppsNativeSandbox result");
+    }
+    if (!(options.bridge instanceof McpAppsBridge)) {
+        throw new McpNativeMixedSurfaceError("Mixed MCP Apps regions require an McpAppsBridge");
+    }
+    if (options.resource === null ||
+        typeof options.resource !== "object" ||
+        Array.isArray(options.resource) ||
+        options.resource.uri !== options.sandbox.source.baseUrl) {
+        throw new McpNativeMixedSurfaceError("Mixed MCP Apps resource URI must match the sandbox base URL");
+    }
+    if (!isMcpAppsBridgeBinding(options.bridge, options.resource, options.sandbox)) {
+        throw new McpNativeMixedSurfaceError("Mixed MCP Apps regions require the exact resource, sandbox, and bridge binding");
+    }
+    const region = Object.freeze({
+        id: expectRegionId(options.id),
+        accessibilityLabel: expectAccessibilityLabel(options.accessibilityLabel),
+        kind: "mcp-app",
+        sandbox: options.sandbox,
+        bridge: options.bridge,
+    });
+    registerRegion(region, options.lifecycle);
+    return region;
+}
+/**
+ * Serializes host lifecycle changes across fixed sibling regions. It does not parse a layout,
+ * render a component, navigate a WebView, or forward messages between native and Apps regions.
+ */
+export class McpNativeMixedSurfaceCoordinator {
+    #regions;
+    #regionsById;
+    #states = new Map();
+    #listeners = new Set();
+    #activity;
+    #environment;
+    #focusedRegionId;
+    #started = false;
+    #disposed = false;
+    #operationTail = Promise.resolve();
+    #snapshot;
+    constructor(options) {
+        if (options === null || typeof options !== "object" || Array.isArray(options)) {
+            throw new McpNativeMixedSurfaceError("Mixed surface coordinator options must be an object");
+        }
+        if (!Array.isArray(options.regions)) {
+            throw new McpNativeMixedSurfaceError("Mixed surface regions must be an array");
+        }
+        if (options.regions.length === 0 || options.regions.length > MCP_NATIVE_MIXED_MAX_REGIONS) {
+            throw new McpNativeMixedSurfaceError(`Mixed surface layouts require 1-${MCP_NATIVE_MIXED_MAX_REGIONS} regions`);
+        }
+        const regions = [];
+        const byId = new Map();
+        for (const [index, region] of options.regions.entries()) {
+            if (region === null ||
+                typeof region !== "object" ||
+                !registeredRegions.has(region)) {
+                throw new McpNativeMixedSurfaceError(`Mixed surface region ${index} must come from a host registration factory`);
+            }
+            if (byId.has(region.id)) {
+                throw new McpNativeMixedSurfaceError(`Duplicate mixed surface region id: ${region.id}`);
+            }
+            if (coordinatedRegions.has(region)) {
+                throw new McpNativeMixedSurfaceError(`Mixed surface region ${region.id} already belongs to a coordinator`);
+            }
+            regions.push(region);
+            byId.set(region.id, region);
+            this.#states.set(region.id, { status: "starting", visibility: "hidden" });
+        }
+        this.#regions = Object.freeze(regions);
+        this.#regionsById = byId;
+        this.#activity = parseActivity(options.initialActivity ?? "foreground");
+        this.#environment = createEnvironment(options.initialEnvironment);
+        const visibleIds = parseRegionIds(options.initialVisibleRegionIds ?? this.#regions.map((region) => region.id), byId, "initialVisibleRegionIds");
+        for (const id of visibleIds)
+            this.#states.get(id).visibility = "visible";
+        if (options.initialFocusedRegionId !== undefined) {
+            const focusId = expectKnownRegionId(options.initialFocusedRegionId, byId, "initial focus");
+            if (this.#states.get(focusId).visibility !== "visible") {
+                throw new McpNativeMixedSurfaceError("The initially focused region must be visible", {
+                    regionId: focusId,
+                });
+            }
+            this.#focusedRegionId = focusId;
+        }
+        for (const region of regions)
+            coordinatedRegions.add(region);
+        this.#snapshot = this.#createSnapshot();
+    }
+    getSnapshot = () => this.#snapshot;
+    getRegion(id) {
+        return this.#regionsById.get(id);
+    }
+    subscribe(listener) {
+        if (this.#disposed) {
+            throw new McpNativeMixedSurfaceError("Cannot subscribe after mixed surface disposal");
+        }
+        if (typeof listener !== "function") {
+            throw new McpNativeMixedSurfaceError("Mixed surface listener must be a function");
+        }
+        if (this.#listeners.size >= MCP_NATIVE_MIXED_MAX_LISTENERS) {
+            throw new McpNativeMixedSurfaceError(`Mixed surface coordinator exceeds ${MCP_NATIVE_MIXED_MAX_LISTENERS} listeners`);
+        }
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+    start() {
+        return this.#enqueue("start", async () => {
+            if (this.#started) {
+                throw new McpNativeMixedSurfaceError("Mixed surface coordinator has already started");
+            }
+            this.#started = true;
+            let firstError;
+            await forEachSerial(this.#regions, async (region) => {
+                try {
+                    await this.#invoke(region, "onCreate");
+                    await this.#invoke(region, "onActivityChange", this.#activity);
+                    await this.#invoke(region, "onEnvironmentChange", this.#environment);
+                    await this.#invoke(region, "onVisibilityChange", this.#states.get(region.id).visibility);
+                    await this.#invoke(region, "onFocusChange", this.#focusedRegionId === region.id);
+                    this.#states.get(region.id).status = "ready";
+                }
+                catch (error) {
+                    this.#states.get(region.id).status = "crashed";
+                    if (this.#focusedRegionId === region.id)
+                        this.#focusedRegionId = undefined;
+                    firstError ??= error;
+                }
+            });
+            this.#publish();
+            if (firstError !== undefined)
+                throw firstError;
+        });
+    }
+    setActivity(activity) {
+        return this.#enqueue("set activity", async () => {
+            this.#assertStarted();
+            const parsed = parseActivity(activity);
+            if (parsed === this.#activity)
+                return;
+            await forEachSerial(this.#regions, async (region) => {
+                if (this.#states.get(region.id).status === "ready") {
+                    await this.#invoke(region, "onActivityChange", parsed);
+                }
+            });
+            this.#activity = parsed;
+            this.#publish();
+        });
+    }
+    setEnvironment(environment) {
+        return this.#enqueue("set environment", async () => {
+            this.#assertStarted();
+            const parsed = createEnvironment(environment);
+            if (environmentsEqual(parsed, this.#environment))
+                return;
+            await forEachSerial(this.#regions, async (region) => {
+                if (this.#states.get(region.id).status === "ready") {
+                    await this.#invoke(region, "onEnvironmentChange", parsed);
+                }
+            });
+            this.#environment = parsed;
+            this.#publish();
+        });
+    }
+    setVisibleRegions(ids) {
+        return this.#enqueue("set visibility", async () => {
+            this.#assertStarted();
+            const visible = new Set(parseRegionIds(ids, this.#regionsById, "visible region ids"));
+            const previousFocusId = this.#focusedRegionId;
+            if (previousFocusId !== undefined && !visible.has(previousFocusId)) {
+                const previous = this.#regionsById.get(previousFocusId);
+                await this.#invoke(previous, "onFocusChange", false);
+            }
+            await forEachSerial(this.#regions, async (region) => {
+                const state = this.#states.get(region.id);
+                const next = visible.has(region.id) ? "visible" : "hidden";
+                if (state.visibility === next)
+                    return;
+                if (state.status === "ready")
+                    await this.#invoke(region, "onVisibilityChange", next);
+            });
+            if (previousFocusId !== undefined && !visible.has(previousFocusId)) {
+                this.#focusedRegionId = undefined;
+            }
+            for (const region of this.#regions) {
+                this.#states.get(region.id).visibility = visible.has(region.id) ? "visible" : "hidden";
+            }
+            this.#publish();
+        });
+    }
+    transferFocus(id) {
+        return this.#enqueue("transfer focus", async () => {
+            this.#assertStarted();
+            const nextId = id === undefined ? undefined : expectKnownRegionId(id, this.#regionsById, "focus target");
+            if (nextId === this.#focusedRegionId)
+                return;
+            if (nextId !== undefined) {
+                const nextState = this.#states.get(nextId);
+                if (nextState.visibility !== "visible" || nextState.status !== "ready") {
+                    throw new McpNativeMixedSurfaceError("Focus target must be visible and ready", {
+                        regionId: nextId,
+                    });
+                }
+            }
+            const previousId = this.#focusedRegionId;
+            if (previousId !== undefined) {
+                await this.#invoke(this.#regionsById.get(previousId), "onFocusChange", false);
+            }
+            if (nextId !== undefined) {
+                await this.#invoke(this.#regionsById.get(nextId), "onFocusChange", true);
+            }
+            this.#focusedRegionId = nextId;
+            this.#publish();
+        });
+    }
+    handleBack() {
+        let handled = false;
+        return this.#enqueue("handle back", async () => {
+            this.#assertStarted();
+            const candidates = this.#backCandidates();
+            for (const region of candidates) {
+                const callback = regionLifecycles.get(region)?.onBack;
+                if (callback === undefined)
+                    continue;
+                // eslint-disable-next-line no-await-in-loop -- back handlers are ordered and short-circuit
+                const result = await this.#invokeResult(region, "onBack", callback);
+                if (typeof result !== "boolean") {
+                    throw new McpNativeMixedSurfaceError("Mixed surface onBack must return a boolean", {
+                        regionId: region.id,
+                    });
+                }
+                if (result) {
+                    handled = true;
+                    break;
+                }
+            }
+        }).then(() => handled);
+    }
+    cancel(id, reason) {
+        return this.#enqueue("cancel", async () => {
+            this.#assertStarted();
+            const region = this.#requireRegion(id);
+            const parsedReason = optionalReason(reason);
+            const state = this.#states.get(region.id);
+            if (state.status === "cancelled")
+                return;
+            if (this.#focusedRegionId === region.id) {
+                await this.#invoke(region, "onFocusChange", false);
+            }
+            await this.#invoke(region, "onCancel", parsedReason);
+            if (this.#focusedRegionId === region.id)
+                this.#focusedRegionId = undefined;
+            state.status = "cancelled";
+            state.visibility = "hidden";
+            this.#publish();
+        });
+    }
+    reportCrash(id, error) {
+        return this.#enqueue("report crash", async () => {
+            this.#assertStarted();
+            const region = this.#requireRegion(id);
+            const state = this.#states.get(region.id);
+            if (state.status === "cancelled") {
+                throw new McpNativeMixedSurfaceError("A cancelled mixed surface cannot crash", {
+                    regionId: id,
+                });
+            }
+            if (state.status === "crashed")
+                return;
+            if (this.#focusedRegionId === region.id) {
+                await this.#invoke(region, "onFocusChange", false);
+            }
+            await this.#invoke(region, "onCrash", error);
+            if (this.#focusedRegionId === region.id)
+                this.#focusedRegionId = undefined;
+            state.status = "crashed";
+            this.#publish();
+        });
+    }
+    recover(id) {
+        return this.#enqueue("recover", async () => {
+            this.#assertStarted();
+            const region = this.#requireRegion(id);
+            const state = this.#states.get(region.id);
+            if (state.status !== "crashed") {
+                throw new McpNativeMixedSurfaceError("Only a crashed mixed surface can recover", {
+                    regionId: id,
+                });
+            }
+            await this.#invoke(region, "onRecover");
+            await this.#invoke(region, "onActivityChange", this.#activity);
+            await this.#invoke(region, "onEnvironmentChange", this.#environment);
+            await this.#invoke(region, "onVisibilityChange", state.visibility);
+            state.status = "ready";
+            this.#publish();
+        });
+    }
+    handleMemoryPressure(pressure) {
+        return this.#enqueue("handle memory pressure", async () => {
+            this.#assertStarted();
+            if (pressure !== "moderate" && pressure !== "critical") {
+                throw new McpNativeMixedSurfaceError("Unsupported mixed surface memory-pressure level");
+            }
+            await forEachSerial(this.#regions, async (region) => {
+                if (this.#states.get(region.id).status === "ready") {
+                    await this.#invoke(region, "onMemoryPressure", pressure);
+                }
+            });
+        });
+    }
+    dispose() {
+        return this.#enqueue("dispose", async () => {
+            if (this.#disposed)
+                return;
+            this.#disposed = true;
+            this.#focusedRegionId = undefined;
+            let firstError;
+            await forEachSerial([...this.#regions].reverse(), async (region) => {
+                if (region.kind === "mcp-app") {
+                    try {
+                        if (region.bridge.state === "ready") {
+                            await region.bridge.requestResourceTeardown();
+                        }
+                    }
+                    catch (error) {
+                        firstError ??= error;
+                    }
+                    finally {
+                        region.bridge.close();
+                    }
+                }
+                try {
+                    await this.#invoke(region, "onDispose");
+                }
+                catch (error) {
+                    firstError ??= error;
+                }
+            });
+            this.#publish();
+            this.#listeners.clear();
+            if (firstError !== undefined)
+                throw firstError;
+        }, true);
+    }
+    #requireRegion(id) {
+        return (this.#regionsById.get(expectRegionId(id)) ??
+            (() => {
+                throw new McpNativeMixedSurfaceError(`Unknown mixed surface region: ${String(id)}`);
+            })());
+    }
+    #assertStarted() {
+        if (!this.#started)
+            throw new McpNativeMixedSurfaceError("Mixed surface coordinator is not started");
+    }
+    #backCandidates() {
+        const result = [];
+        if (this.#focusedRegionId !== undefined) {
+            const focused = this.#regionsById.get(this.#focusedRegionId);
+            const focusedState = this.#states.get(focused.id);
+            if (focusedState.visibility === "visible" && focusedState.status === "ready") {
+                result.push(focused);
+            }
+        }
+        for (const region of [...this.#regions].reverse()) {
+            if (region.id !== this.#focusedRegionId &&
+                this.#states.get(region.id).visibility === "visible" &&
+                this.#states.get(region.id).status === "ready") {
+                result.push(region);
+            }
+        }
+        return result;
+    }
+    #enqueue(label, operation, allowDisposed = false) {
+        const result = this.#operationTail.then(async () => {
+            if (this.#disposed && !allowDisposed) {
+                throw new McpNativeMixedSurfaceError(`Cannot ${label} after mixed surface disposal`);
+            }
+            try {
+                await operation();
+            }
+            catch (error) {
+                this.#publish();
+                throw error;
+            }
+        });
+        this.#operationTail = result.catch(() => {
+            // Keep serialization usable while returning the original rejection to the caller.
+        });
+        return result;
+    }
+    async #invoke(region, key, ...arguments_) {
+        const callback = regionLifecycles.get(region)?.[key];
+        if (callback === undefined)
+            return;
+        await this.#invokeResult(region, key, callback, ...arguments_);
+    }
+    async #invokeResult(region, key, callback, ...arguments_) {
+        try {
+            return await callback(...arguments_);
+        }
+        catch (error) {
+            throw new McpNativeMixedSurfaceError(`Mixed surface ${String(key)} callback failed`, {
+                cause: error,
+                regionId: region.id,
+            });
+        }
+    }
+    #publish() {
+        this.#snapshot = this.#createSnapshot();
+        for (const listener of this.#listeners) {
+            try {
+                listener();
+            }
+            catch {
+                // A consumer notification must not corrupt serialized host lifecycle work.
+            }
+        }
+    }
+    #createSnapshot() {
+        return Object.freeze({
+            activity: this.#activity,
+            disposed: this.#disposed,
+            environment: this.#environment,
+            ...(this.#focusedRegionId === undefined ? {} : { focusedRegionId: this.#focusedRegionId }),
+            regions: Object.freeze(this.#regions.map((region, index) => {
+                const state = this.#states.get(region.id);
+                return Object.freeze({
+                    accessibilityLabel: region.accessibilityLabel,
+                    accessibilityOrder: index,
+                    accessibilityTree: region.kind === "a2ui" ? "native" : "isolated-webview",
+                    focused: this.#focusedRegionId === region.id,
+                    id: region.id,
+                    kind: region.kind,
+                    status: state.status,
+                    visibility: state.visibility,
+                });
+            })),
+            started: this.#started,
+        });
+    }
+}
+function registerRegion(region, lifecycle) {
+    const parsedLifecycle = validateLifecycle(lifecycle ?? {});
+    registeredRegions.add(region);
+    regionLifecycles.set(region, parsedLifecycle);
+}
+function expectFactoryOptions(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new McpNativeMixedSurfaceError("Mixed surface factory options must be an object");
+    }
+}
+async function forEachSerial(values, operation) {
+    for (const value of values) {
+        // eslint-disable-next-line no-await-in-loop -- host lifecycle callbacks must never race
+        await operation(value);
+    }
+}
+function validateLifecycle(lifecycle) {
+    if (lifecycle === null || typeof lifecycle !== "object" || Array.isArray(lifecycle)) {
+        throw new McpNativeMixedSurfaceError("Mixed surface lifecycle must be an object");
+    }
+    const allowed = new Set([
+        "onCreate",
+        "onVisibilityChange",
+        "onActivityChange",
+        "onFocusChange",
+        "onEnvironmentChange",
+        "onBack",
+        "onCancel",
+        "onCrash",
+        "onRecover",
+        "onMemoryPressure",
+        "onDispose",
+    ]);
+    for (const key of Object.keys(lifecycle)) {
+        if (!allowed.has(key)) {
+            throw new McpNativeMixedSurfaceError(`Unsupported mixed surface lifecycle callback: ${key}`);
+        }
+        if (typeof lifecycle[key] !== "function") {
+            throw new McpNativeMixedSurfaceError(`Mixed surface lifecycle ${key} must be a function`);
+        }
+    }
+    return Object.freeze({ ...lifecycle });
+}
+function expectRegionId(value) {
+    if (typeof value !== "string" || !/^[A-Za-z][A-Za-z0-9._:-]{0,127}$/u.test(value)) {
+        throw new McpNativeMixedSurfaceError("Mixed surface region IDs must be 1-128 host-authored identifier characters");
+    }
+    return value;
+}
+function expectAccessibilityLabel(value) {
+    if (typeof value !== "string" || value.length === 0 || value.length > 512) {
+        throw new McpNativeMixedSurfaceError("Mixed surface accessibility labels must contain 1-512 characters");
+    }
+    return value;
+}
+function expectKnownRegionId(value, regions, path) {
+    const id = expectRegionId(value);
+    if (!regions.has(id)) {
+        throw new McpNativeMixedSurfaceError(`Unknown mixed surface region at ${path}: ${id}`);
+    }
+    return id;
+}
+function parseRegionIds(values, regions, path) {
+    if (!Array.isArray(values) || values.length > MCP_NATIVE_MIXED_MAX_REGIONS) {
+        throw new McpNativeMixedSurfaceError(`${path} must be a bounded array`);
+    }
+    const result = [];
+    for (const [index, value] of values.entries()) {
+        const id = expectKnownRegionId(value, regions, `${path}[${index}]`);
+        if (result.includes(id)) {
+            throw new McpNativeMixedSurfaceError(`Duplicate mixed surface region at ${path}[${index}]`);
+        }
+        result.push(id);
+    }
+    return result;
+}
+function parseActivity(value) {
+    if (value !== "background" && value !== "foreground") {
+        throw new McpNativeMixedSurfaceError("Mixed surface activity must be background or foreground");
+    }
+    return value;
+}
+function createEnvironment(input = {}) {
+    if (input === null || typeof input !== "object" || Array.isArray(input)) {
+        throw new McpNativeMixedSurfaceError("Mixed surface environment must be an object");
+    }
+    for (const key of Object.keys(input)) {
+        if (!["dynamicTypeScale", "keyboardVisible", "orientation", "reducedMotion"].includes(key)) {
+            throw new McpNativeMixedSurfaceError(`Unsupported mixed surface environment field: ${key}`);
+        }
+    }
+    const dynamicTypeScale = input.dynamicTypeScale ?? 1;
+    if (!Number.isFinite(dynamicTypeScale) || dynamicTypeScale < 0.5 || dynamicTypeScale > 4) {
+        throw new McpNativeMixedSurfaceError("Mixed surface dynamic type scale must be between 0.5 and 4");
+    }
+    const keyboardVisible = input.keyboardVisible ?? false;
+    const reducedMotion = input.reducedMotion ?? false;
+    if (typeof keyboardVisible !== "boolean" || typeof reducedMotion !== "boolean") {
+        throw new McpNativeMixedSurfaceError("Mixed surface environment flags must be booleans");
+    }
+    const orientation = input.orientation ?? "unknown";
+    if (!["landscape-left", "landscape-right", "portrait", "portrait-upside-down", "unknown"].includes(orientation)) {
+        throw new McpNativeMixedSurfaceError("Unsupported mixed surface orientation");
+    }
+    return Object.freeze({ dynamicTypeScale, keyboardVisible, orientation, reducedMotion });
+}
+function environmentsEqual(left, right) {
+    return (left.dynamicTypeScale === right.dynamicTypeScale &&
+        left.keyboardVisible === right.keyboardVisible &&
+        left.orientation === right.orientation &&
+        left.reducedMotion === right.reducedMotion);
+}
+function optionalReason(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" || value.length === 0 || value.length > 1_024) {
+        throw new McpNativeMixedSurfaceError("Mixed surface cancellation reasons must be bounded strings");
+    }
+    return value;
+}
+//# sourceMappingURL=mixed-surfaces.js.map

package/dist/mixed-surfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixed-surfaces.js","sourceRoot":"","sources":["../src/mixed-surfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,GAG3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,mCAAmC,GAGpC,MAAM,qBAAqB,CAAC;AAE7B,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAC/C,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAmHjD,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAAU,CAAC;AAChD,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAAU,CAAC;AACjD,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAA0C,CAAC;AAE/E,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,QAAQ,CAAqB;IAEtC,YAAY,OAAe,EAAE,OAAuD;QAClF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;IACpC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAA8C;IAE9C,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC3B,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,kBAAkB,EAAE,wBAAwB,CAAC,OAAO,CAAC,kBAAkB,CAAC;QACxE,IAAI,EAAE,MAAe;QACrB,OAAO,EAAE,0BAA0B,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;KACrE,CAAC,CAAC;IACH,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iCAAiC,CAC/C,OAAiD;IAEjD,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,mCAAmC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,0BAA0B,CAClC,4EAA4E,CAC7E,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,YAAY,aAAa,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,0BAA0B,CAAC,iDAAiD,CAAC,CAAC;IAC1F,CAAC;IACD,IACE,OAAO,CAAC,QAAQ,KAAK,IAAI;QACzB,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;QACpC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EACvD,CAAC;QACD,MAAM,IAAI,0BAA0B,CAClC,6DAA6D,CAC9D,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,0BAA0B,CAClC,gFAAgF,CACjF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC3B,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,kBAAkB,EAAE,wBAAwB,CAAC,OAAO,CAAC,kBAAkB,CAAC;QACxE,IAAI,EAAE,SAAkB;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IACH,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,gCAAgC;IAClC,QAAQ,CAAyC;IACjD,YAAY,CAAmD;IAC/D,OAAO,GAAG,IAAI,GAAG,EAA8B,CAAC;IAChD,UAAU,GAAG,IAAI,GAAG,EAAc,CAAC;IAC5C,SAAS,CAAgC;IACzC,YAAY,CAAmC;IAC/C,gBAAgB,CAAqB;IACrC,QAAQ,GAAG,KAAK,CAAC;IACjB,SAAS,GAAG,KAAK,CAAC;IAClB,cAAc,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAClD,SAAS,CAAgC;IAEzC,YAAY,OAAgD;QAC1D,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,0BAA0B,CAAC,qDAAqD,CAAC,CAAC;QAC9F,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,0BAA0B,CAAC,wCAAwC,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,4BAA4B,EAAE,CAAC;YAC1F,MAAM,IAAI,0BAA0B,CAClC,mCAAmC,4BAA4B,UAAU,CAC1E,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAkC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAuC,CAAC;QAC5D,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACxD,IACE,MAAM,KAAK,IAAI;gBACf,OAAO,MAAM,KAAK,QAAQ;gBAC1B,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAgB,CAAC,EACxC,CAAC;gBACD,MAAM,IAAI,0BAA0B,CAClC,wBAAwB,KAAK,6CAA6C,CAC3E,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,0BAA0B,CAAC,sCAAsC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1F,CAAC;YACD,IAAI,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,0BAA0B,CAClC,wBAAwB,MAAM,CAAC,EAAE,mCAAmC,CACrE,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,eAAe,IAAI,YAAY,CAAC,CAAC;QACxE,IAAI,CAAC,YAAY,GAAG,iBAAiB,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAElE,MAAM,UAAU,GAAG,cAAc,CAC/B,OAAO,CAAC,uBAAuB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAC3E,IAAI,EACJ,yBAAyB,CAC1B,CAAC;QACF,KAAK,MAAM,EAAE,IAAI,UAAU;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,UAAU,GAAG,SAAS,CAAC;QAE1E,IAAI,OAAO,CAAC,sBAAsB,KAAK,SAAS,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,sBAAsB,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;YAC3F,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACxD,MAAM,IAAI,0BAA0B,CAAC,8CAA8C,EAAE;oBACnF,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;QAClC,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;IAC1C,CAAC;IAED,WAAW,GAAG,GAAkC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;IAElE,SAAS,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,SAAS,CAAC,QAAoB;QAC5B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,0BAA0B,CAAC,+CAA+C,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,0BAA0B,CAAC,2CAA2C,CAAC,CAAC;QACpF,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,8BAA8B,EAAE,CAAC;YAC3D,MAAM,IAAI,0BAA0B,CAClC,qCAAqC,8BAA8B,YAAY,CAChF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;YACvC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,MAAM,IAAI,0BAA0B,CAAC,+CAA+C,CAAC,CAAC;YACxF,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,IAAI,UAAmB,CAAC;YACxB,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBAClD,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;oBACvC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;oBAC/D,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;oBACrE,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC,UAAU,CAAC,CAAC;oBAC1F,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,gBAAgB,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC;oBACjF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC,MAAM,GAAG,OAAO,CAAC;gBAChD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC,MAAM,GAAG,SAAS,CAAC;oBAChD,IAAI,IAAI,CAAC,gBAAgB,KAAK,MAAM,CAAC,EAAE;wBAAE,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;oBAC3E,UAAU,KAAK,KAAK,CAAC;gBACvB,CAAC;YACH,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,IAAI,UAAU,KAAK,SAAS;gBAAE,MAAM,UAAU,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,WAAW,CAAC,QAAuC;QACjD,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;YAC9C,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,IAAI,CAAC,SAAS;gBAAE,OAAO;YACtC,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBAClD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;oBACpD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;YACxB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,WAA6C;QAC1D,OAAO,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,KAAK,IAAI,EAAE;YACjD,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;YAC9C,IAAI,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC;gBAAE,OAAO;YACzD,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBAClD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;oBACpD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;YAC3B,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB,CAAC,GAAsB;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE;YAChD,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC,CAAC;YACtF,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC;YAC9C,IAAI,eAAe,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;gBACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAE,CAAC;gBACzD,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;YACvD,CAAC;YACD,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBAClD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC;gBAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAC3D,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI;oBAAE,OAAO;gBACtC,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO;oBAAE,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,IAAI,CAAC,CAAC;YACvF,CAAC,CAAC,CAAC;YACH,IAAI,eAAe,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;gBACnE,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;YACpC,CAAC;YACD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC1F,CAAC;YACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CAAC,EAAW;QACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,KAAK,IAAI,EAAE;YAChD,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,MAAM,GACV,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,EAAE,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;YAC5F,IAAI,MAAM,KAAK,IAAI,CAAC,gBAAgB;gBAAE,OAAO;YAC7C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC;gBAC5C,IAAI,SAAS,CAAC,UAAU,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;oBACvE,MAAM,IAAI,0BAA0B,CAAC,wCAAwC,EAAE;wBAC7E,QAAQ,EAAE,MAAM;qBACjB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC;YACzC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAE,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;YACjF,CAAC;YACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAE,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;YAC5E,CAAC;YACD,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC;YAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,UAAU;QACR,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,IAAI,EAAE;YAC7C,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1C,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;gBAChC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBACtD,IAAI,QAAQ,KAAK,SAAS;oBAAE,SAAS;gBACrC,2FAA2F;gBAC3F,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACpE,IAAI,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;oBAChC,MAAM,IAAI,0BAA0B,CAAC,4CAA4C,EAAE;wBACjF,QAAQ,EAAE,MAAM,CAAC,EAAE;qBACpB,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO,GAAG,IAAI,CAAC;oBACf,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,MAAe;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YACxC,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YACvC,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC;YAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;gBAAE,OAAO;YACzC,IAAI,IAAI,CAAC,gBAAgB,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC;gBACxC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;YACrD,CAAC;YACD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;YACrD,IAAI,IAAI,CAAC,gBAAgB,KAAK,MAAM,CAAC,EAAE;gBAAE,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;YAC3E,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;YAC3B,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC;YAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,WAAW,CAAC,EAAU,EAAE,KAAc;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;YAC9C,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC;YAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACjC,MAAM,IAAI,0BAA0B,CAAC,wCAAwC,EAAE;oBAC7E,QAAQ,EAAE,EAAE;iBACb,CAAC,CAAC;YACL,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO;YACvC,IAAI,IAAI,CAAC,gBAAgB,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC;gBACxC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;YACrD,CAAC;YACD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YAC7C,IAAI,IAAI,CAAC,gBAAgB,KAAK,MAAM,CAAC,EAAE;gBAAE,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;YAC3E,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;YACzC,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC;YAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,IAAI,0BAA0B,CAAC,0CAA0C,EAAE;oBAC/E,QAAQ,EAAE,EAAE;iBACb,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YACxC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/D,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YACrE,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YACnE,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC;YACvB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oBAAoB,CAAC,QAA6C;QAChE,OAAO,IAAI,CAAC,QAAQ,CAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;YACxD,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,IAAI,QAAQ,KAAK,UAAU,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACvD,MAAM,IAAI,0BAA0B,CAAC,iDAAiD,CAAC,CAAC;YAC1F,CAAC;YACD,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBAClD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;oBACpD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,CAClB,SAAS,EACT,KAAK,IAAI,EAAE;YACT,IAAI,IAAI,CAAC,SAAS;gBAAE,OAAO;YAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;YAClC,IAAI,UAAmB,CAAC;YACxB,MAAM,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACjE,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC9B,IAAI,CAAC;wBACH,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;4BACpC,MAAM,MAAM,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC;wBAChD,CAAC;oBACH,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,UAAU,KAAK,KAAK,CAAC;oBACvB,CAAC;4BAAS,CAAC;wBACT,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;oBACxB,CAAC;gBACH,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;gBAC1C,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,UAAU,KAAK,KAAK,CAAC;gBACvB,CAAC;YACH,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACxB,IAAI,UAAU,KAAK,SAAS;gBAAE,MAAM,UAAU,CAAC;QACjD,CAAC,EACD,IAAI,CACL,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,EAAU;QACvB,OAAO,CACL,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YACzC,CAAC,GAAG,EAAE;gBACJ,MAAM,IAAI,0BAA0B,CAAC,iCAAiC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACtF,CAAC,CAAC,EAAE,CACL,CAAC;IACJ,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,IAAI,CAAC,QAAQ;YAChB,MAAM,IAAI,0BAA0B,CAAC,0CAA0C,CAAC,CAAC;IACrF,CAAC;IAED,eAAe;QACb,MAAM,MAAM,GAAkC,EAAE,CAAC;QACjD,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAE,CAAC;YAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAE,CAAC;YACnD,IAAI,YAAY,CAAC,UAAU,KAAK,SAAS,IAAI,YAAY,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC7E,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAClD,IACE,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC,gBAAgB;gBACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC,UAAU,KAAK,SAAS;gBACrD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC,MAAM,KAAK,OAAO,EAC/C,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,QAAQ,CAAC,KAAa,EAAE,SAA8B,EAAE,aAAa,GAAG,KAAK;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YACjD,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,aAAa,EAAE,CAAC;gBACrC,MAAM,IAAI,0BAA0B,CAAC,UAAU,KAAK,+BAA+B,CAAC,CAAC;YACvF,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,SAAS,EAAE,CAAC;YACpB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;YACtC,kFAAkF;QACpF,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,OAAO,CACX,MAAmC,EACnC,GAAM,EACN,GAAG,UAAsE;QAEzE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACrD,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO;QACnC,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,MAAmC,EACnC,GAAM,EACN,QAAwD,EACxD,GAAG,UAAsE;QAEzE,IAAI,CAAC;YACH,OAAO,MAAO,QAAuD,CAAC,GAAG,UAAU,CAAC,CAAC;QACvF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,0BAA0B,CAAC,iBAAiB,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE;gBACnF,KAAK,EAAE,KAAK;gBACZ,QAAQ,EAAE,MAAM,CAAC,EAAE;aACpB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACxC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,QAAQ,EAAE,CAAC;YACb,CAAC;YAAC,MAAM,CAAC;gBACP,2EAA2E;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;IAED,eAAe;QACb,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,GAAG,CAAC,IAAI,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1F,OAAO,EAAE,MAAM,CAAC,MAAM,CACpB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;gBAClC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAE,CAAC;gBAC3C,OAAO,MAAM,CAAC,MAAM,CAAC;oBACnB,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;oBAC7C,kBAAkB,EAAE,KAAK;oBACzB,iBAAiB,EAAE,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB;oBACzE,OAAO,EAAE,IAAI,CAAC,gBAAgB,KAAK,MAAM,CAAC,EAAE;oBAC5C,EAAE,EAAE,MAAM,CAAC,EAAE;oBACb,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,UAAU,EAAE,KAAK,CAAC,UAAU;iBAC7B,CAAC,CAAC;YACL,CAAC,CAAC,CACH;YACD,OAAO,EAAE,IAAI,CAAC,QAAQ;SACvB,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,cAAc,CACrB,MAAmC,EACnC,SAAqD;IAErD,MAAM,eAAe,GAAG,iBAAiB,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC3D,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,0BAA0B,CAAC,iDAAiD,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,MAAoB,EACpB,SAA6C;IAE7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,wFAAwF;QACxF,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,SAAyC;IAEzC,IAAI,SAAS,KAAK,IAAI,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,0BAA0B,CAAC,2CAA2C,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC;QACtB,UAAU;QACV,oBAAoB;QACpB,kBAAkB;QAClB,eAAe;QACf,qBAAqB;QACrB,QAAQ;QACR,UAAU;QACV,SAAS;QACT,WAAW;QACX,kBAAkB;QAClB,WAAW;KACZ,CAAC,CAAC;IACH,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,0BAA0B,CAAC,iDAAiD,GAAG,EAAE,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,OAAQ,SAAqC,CAAC,GAAG,CAAC,KAAK,UAAU,EAAE,CAAC;YACtE,MAAM,IAAI,0BAA0B,CAAC,2BAA2B,GAAG,qBAAqB,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,mCAAmC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,0BAA0B,CAClC,4EAA4E,CAC7E,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAC1E,MAAM,IAAI,0BAA0B,CAClC,kEAAkE,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAc,EACd,OAAyD,EACzD,IAAY;IAEZ,MAAM,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,0BAA0B,CAAC,mCAAmC,IAAI,KAAK,EAAE,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,cAAc,CACrB,MAAyB,EACzB,OAAyD,EACzD,IAAY;IAEZ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,4BAA4B,EAAE,CAAC;QAC3E,MAAM,IAAI,0BAA0B,CAAC,GAAG,IAAI,0BAA0B,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC;QACpE,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,0BAA0B,CAAC,qCAAqC,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,YAAY,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;QACrD,MAAM,IAAI,0BAA0B,CAAC,yDAAyD,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAK,GAA8C,EAAE;IAErD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,0BAA0B,CAAC,6CAA6C,CAAC,CAAC;IACtF,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3F,MAAM,IAAI,0BAA0B,CAAC,gDAAgD,GAAG,EAAE,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IACD,MAAM,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,gBAAgB,GAAG,GAAG,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACzF,MAAM,IAAI,0BAA0B,CAClC,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC;IACvD,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC;IACnD,IAAI,OAAO,eAAe,KAAK,SAAS,IAAI,OAAO,aAAa,KAAK,SAAS,EAAE,CAAC;QAC/E,MAAM,IAAI,0BAA0B,CAAC,kDAAkD,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,SAAS,CAAC;IACnD,IACE,CAAC,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,UAAU,EAAE,sBAAsB,EAAE,SAAS,CAAC,CAAC,QAAQ,CAC5F,WAAW,CACZ,EACD,CAAC;QACD,MAAM,IAAI,0BAA0B,CAAC,uCAAuC,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAsC,EACtC,KAAuC;IAEvC,OAAO,CACL,IAAI,CAAC,gBAAgB,KAAK,KAAK,CAAC,gBAAgB;QAChD,IAAI,CAAC,eAAe,KAAK,KAAK,CAAC,eAAe;QAC9C,IAAI,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW;QACtC,IAAI,CAAC,aAAa,KAAK,KAAK,CAAC,aAAa,CAC3C,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QAC5E,MAAM,IAAI,0BAA0B,CAClC,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-native",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "Convenience package for the MCP Native runtime.",
   "keywords": [
     "a2ui",
@@ -31,20 +31,24 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./legacy": {
+      "types": "./dist/legacy.d.ts",
+      "import": "./dist/legacy.js"
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@mcp-native/a2ui": "^0.8.0",
-    "@mcp-native/core": "^0.8.0",
-    "@mcp-native/react-native": "^0.8.0",
-    "@mcp-native/webview": "^0.8.0"
+    "@mcp-native/a2ui": "^0.9.1",
+    "@mcp-native/core": "^0.9.1",
+    "@mcp-native/react-native": "^0.9.1",
+    "@mcp-native/webview": "^0.9.1"
   },
   "peerDependencies": {
     "react": ">=18.3.1 <20",
-    "react-native": ">=0.86.0 <1"
+    "react-native": ">=0.87.0 <1"
   },
   "peerDependenciesMeta": {
     "react-native": {