@mcp-native/react-native 0.2.0 → 0.4.0

package/README.md

@@ -16,7 +16,7 @@
 
 `@mcp-native/react-native` converts a surface already validated by `@mcp-native/a2ui` into a trusted render plan and mounts it with components supplied by the host application. Servers provide data and declared actions—not JavaScript modules, component implementations, or arbitrary component names.
 
-The renderer is an internal platform layer, not proof of complete A2UI v1.0 conformance. The custom `0.1` surface remains supported, and the separate v1.0 adapter now converts a strict static subset into the same host-owned `NativeElement` boundary.
+The renderer is an internal platform layer, not proof of complete A2UI v1.0 conformance. The custom `0.1` surface remains available only through deprecated migration APIs, while the v1.0 adapter converts the documented component subset, including bounded dynamic lists, into the same host-owned `NativeElement` boundary. See the [feature-scoped conformance profile](https://github.com/pablospaniard/mcp-native/blob/main/docs/a2ui-v1-conformance.md).
 
 ## Install
 
@@ -79,7 +79,7 @@ The renderer uses only the currently allowed component names:
 type NativeComponentName = "Button" | "Text" | "TextInput" | "View";
 ```
 
-The application host decides how each name maps to a locally bundled component and how declared button actions reach `McpNativeRuntime`. `onBindingChange` reports a validated binding name and the next text value; this milestone deliberately leaves local state ownership and server synchronization to the host.
+This example uses deprecated custom `0.1` APIs. The application host decides how each name maps to a locally bundled component and how declared button actions reach `McpNativeRuntime`. `onBindingChange` reports a validated binding name and the next text value for that legacy proof surface. New hosts should use `A2uiV1NativeSurface`.
 
 ## A2UI v1 render-plan adapter
 
@@ -101,36 +101,167 @@ const surface = store.get("profile");
 const plan = surface && createA2uiV1NativeRenderPlan(surface, policy);
 ```
 
-The adapter maps `Row`, `Column`, static `List`, and `Card` to `View`; `Text` to `Text`; `Button` with a `Text` child to `Button`; and `TextField` to `TextInput`. It resolves absolute JSON Pointer values, preserves supported container alignment, event context, and explicit accessibility fields. Event descriptors remain inert plan data; mounting them and constructing renderer-to-agent envelopes is the next boundary.
+The adapter maps `Row`, `Column`, static or dynamic `List`, and `Card` to `View`; `Text` to `Text`; `Button` with a `Text` child to `Button`; and `TextField` to `TextInput`. Dynamic lists expand one validated template component per bound array item and remain inside the 1,024-node plan limit. The adapter resolves absolute and item-relative JSON Pointer values, translates relative `TextField` bindings into absolute renderer-local pointers, evaluates bounded literal `formatString`, host-localized `formatNumber`, `formatCurrency`, `formatDate`, and `pluralize`, pure `and`, `or`, and `not`, `required`, bounded `regex`, `length`, `numeric`, and `email`, and `@index` with optional offsets, maps supported container direction and alignment to owned React Native flex styles, applies component weight through a host-owned `View` wrapper with `flexGrow`, maps `TextField` variants to explicit native input behavior (including `secureTextEntry` for `obscured`), and preserves event context and explicit accessibility fields. At the mounted boundary, text and buttons receive closed native roles, button accessibility state mirrors the derived disabled state, hidden text and controls are not accessibility elements, and text plus text inputs explicitly allow font scaling. Supported `TextField` checks set explicit `invalid` and `validationMessages` props on the host component and append declared failures to its accessibility hint; supported `Button` checks set `disabled`, expose declared messages, and cannot resolve or dispatch the event or local URL action until current renderer-local state passes. Main-axis `stretch` and negative weight, which React Native flex layout cannot represent faithfully, fail closed.
 
-Dynamic list templates, relative bindings, renderer functions, renderer-side checks, local function actions, and every other basic-catalog component fail closed. Expanded plans are capped at 1,024 nodes so repeated references cannot amplify a small component graph into unbounded work.
+These mappings have automated host-boundary coverage plus passing Android 17 TalkBack and iOS 26.5
+XCUITest evidence. The [native accessibility test
+plan](../../docs/native-accessibility-testing.md) defines the verified platform matrix, shared
+fixture, WCAG inspection, and strict evidence gate. The [automated robustness
+gates](../../docs/a2ui-v1-performance.md) define repeatable Node.js render-plan budgets and
+fixed-seed generated-input coverage.
+
+For release/platform testing, `npm run native:host:prepare` generates an official temporary React
+Native `0.87.1` or `0.86.3` host from local package tarballs and the pinned accessibility fixture.
+The [native accessibility test plan](../../docs/native-accessibility-testing.md) documents Metro and
+native build preflight, Android TalkBack and iOS XCUITest rows, verified WCAG outcomes, and the
+strict evidence gate.
+
+### Host component adapters
+
+The catalog may use React Native primitives directly or typed adapters around any locally bundled design system. The adapter helpers receive only the trusted primitive props selected by MCP Native and map them into the host component's API:
+
+```tsx
+import { createNativeButtonAdapter, type NativeComponentCatalog } from "@mcp-native/react-native";
+import { Text, TextInput, View } from "react-native";
+import { DesignButton } from "your-design-system";
+
+const components: NativeComponentCatalog = {
+  View,
+  Text,
+  TextInput,
+  Button: createNativeButtonAdapter(
+    DesignButton,
+    ({
+      title,
+      onPress,
+      disabled,
+      accessibilityLabel,
+      accessibilityRole,
+      accessibilityState,
+      accessible,
+      validationMessages,
+    }) => ({
+      label: title,
+      onActivate: onPress,
+      inactive: disabled === true,
+      assistiveLabel: accessibilityLabel,
+      assistiveElement: accessible,
+      assistiveRole: accessibilityRole,
+      assistiveState: accessibilityState,
+      ...(validationMessages === undefined ? {} : { errors: validationMessages }),
+    }),
+  ),
+};
+```
+
+`createNativeViewAdapter`, `createNativeTextAdapter`, and `createNativeTextInputAdapter` provide the same typed boundary for the other primitives. This supports wrappers around libraries such as Expo UI or Gluestack without coupling MCP Native to them. These helpers do not create new wire-level components: the supported semantic names remain the closed `View`, `Text`, `Button`, and `TextInput` render-plan catalog, and the A2UI adapter continues to reject components outside its explicit host allowlist. Mapper functions and target components are trusted application code; server input never selects an import, mapper, or unchecked target prop.
+
+For richer local presentation, provide optional closed variant slots alongside the base primitives:
+
+```tsx
+const components: NativeComponentCatalog = {
+  View,
+  Text,
+  Button,
+  TextInput,
+  variants: {
+    View: { row: HorizontalStack, column: VerticalStack, card: SurfaceCard, list: ItemList },
+    Text: { body: BodyText, caption: CaptionText },
+    Button: { default: DefaultButton, primary: PrimaryButton, borderless: LinkButton },
+    TextInput: {
+      shortText: ShortInput,
+      longText: MultilineInput,
+      number: NumericInput,
+      obscured: PasswordInput,
+    },
+  },
+};
+```
+
+Each override receives the same explicitly selected primitive props as its base component. Missing
+entries fall back to `View`, `Text`, `Button`, or `TextInput`; omitted A2UI hints select their pinned
+defaults (`body`, `default`, and `shortText`). The renderer consumes structural and style hints while
+choosing a local component and never forwards `variant`, a server-provided style object, or an
+arbitrary native prop. Hosts can combine variant slots with the typed adapter helpers when a design
+system uses a different prop API. Variant slots apply only to `A2uiV1NativeSurface`; the custom `0.1`
+`McpNativeSurface` always uses the four base primitives, even when the same host catalog is reused.
+
+Create adapter components and the catalog at module scope, as above, or memoize them with stable dependencies. Each factory call intentionally creates a new React component type; calling one during every host render would remount that catalog entry and discard its component-local state. Generated adapters include descriptive React DevTools display names.
+
+Use `A2uiV1NativeSurface` to mount that subset with renderer-local string state and official action envelopes:
+
+```tsx
+import { A2uiV1NativeSurface } from "@mcp-native/react-native";
+import { Linking } from "react-native";
+
+<A2uiV1NativeSurface
+  surface={surface}
+  policy={policy}
+  components={{ Button, Text, TextInput, View }}
+  onAction={(envelope, dataModel) => {
+    // dataModel is present only when the surface explicitly enables sendDataModel.
+    if (dataModel === undefined) {
+      sendToAgent(envelope);
+    } else {
+      sendToAgent(envelope, { dataModel });
+    }
+  }}
+  openUrlPolicy={({ url }) => new URL(url).origin === "https://docs.example.com"}
+  onOpenUrl={({ url }) => {
+    void Linking.openURL(url).catch(reportOpenUrlError);
+  }}
+/>;
+```
+
+Bound `TextField` changes update an owned local data model and rerender absolute or dynamic-list-relative bindings and formatted output immediately; they do not call the agent on each keystroke. Equivalent fresh store snapshots preserve those edits, while accepted agent data-model updates reset them. Repeated template buttons retain a renderer-only instance key, so pressing one resolves its user message, supported renderer functions, `@index`, and context again against the correct item in the latest local model while the official wire `sourceComponentId` remains the catalog component ID. The action is timestamped, reconstructed as finite JSON, and validated against the pinned official renderer-to-agent action schema. The callback receives the local data model only when the surface explicitly sets `sendDataModel: true`; otherwise its second argument is omitted. The host callback owns transport delivery and permission or consent boundaries.
+
+`openUrl` is a local Button action, not an agent event. The host must allow the function name in the catalog policy and provide both `openUrlPolicy` and `onOpenUrl`. The adapter re-resolves the URL against current local state during the originating press, canonicalizes it, rejects non-HTTP(S), relative, credential-bearing, whitespace-containing, control-containing, Unicode-format-containing, or oversized values, and invokes the opener only when the synchronous policy returns exactly `true`. Invalid initial server values reject the surface; temporary invalid renderer-local text edits instead disable the affected Button until the value becomes valid, and strict resolution runs again before an enabled press can reach host policy. No URL handler is imported or called by this package. Each URL is capped at 8,192 UTF-16 code units and one expanded pass is capped at 1,048,576 URL code units.
+
+Renderer functions other than `formatString`, `formatNumber`, `formatCurrency`, `formatDate`, `pluralize`, `required`, `regex`, `length`, `numeric`, `email`, `and`, `or`, `not`, template-scoped `@index`, and local Button action `openUrl`, nested inline catalogs, and every other basic-catalog component fail closed. Number and currency formatting uses `Intl.NumberFormat`, date formatting uses `Intl.DateTimeFormat`, and cardinal plural selection uses `Intl.PluralRules` with the required `other` fallback. `required` follows the pinned reference behavior for null, empty strings, and empty arrays. `length` and `numeric` use inclusive, ordered bounds, and `email` uses the pinned basic check with a 320-code-unit input cap. Agent-supplied `regex` is limited to 256 UTF-16 code units, a 4,096-code-unit input, repeats no larger than 4,096, no groups, alternation, backreferences, or Unicode property escapes, and at most one variable repeat; inputs over the cap fail the check, while unsupported or malformed patterns reject the surface. Expanded plans evaluate at most 10,000 renderer checks per pass. Each combined validation accessibility output is capped at 65,536 UTF-16 code units before construction, with at most 1,048,576 such output code units across one expanded pass. `formatDate` accepts finite Unix seconds or milliseconds, their numeric string forms, RFC 3339 timestamps, and strict `yyyy-MM-dd` dates. Absolute numeric magnitudes greater than `10,000,000,000` are milliseconds; all others are seconds. It supports the pinned catalog's `yy`, `yyyy`, `M`, `MM`, `MMM`, `MMMM`, `d`, `dd`, `E`, `EEEE`, `h`, `hh`, `H`, `HH`, `mm`, `ss`, and `a` token subset plus quoted literals; `h` and `hh` require `a`, other pattern letters fail closed, and one pattern may contain at most 128 tokens. The host may supply one validated, runtime-supported BCP 47 `locale` to the mounted surface, render-plan options, event-resolution options, and URL-resolution options, or omit it to use the runtime locale. A date-only `yyyy-MM-dd` value is a calendar date interpreted at midnight in the runtime time zone. An RFC 3339 value is an instant whose declared offset is applied before it is formatted in that runtime time zone. Agent-controlled decimal precision is restricted to an integer from 0 through 100, currency must appear in ISO 4217 List One published 2026-01-01, dynamic values resolve with strict types, formatter construction failures are controlled parse errors, and formatter caches live only for one bounded render, event-resolution, or URL-resolution pass. Expanded plans are capped at 1,024 nodes, 10,000 interpolations, and 1,048,576 formatted UTF-16 code units so repeated references or large bound arrays cannot amplify a small component graph into unbounded work; each formatted result also retains the shared 65,536-code-unit string limit.
 
 ## Public API
 
-| Export                                  | Purpose                                                                                         |
-| --------------------------------------- | ----------------------------------------------------------------------------------------------- |
-| `McpNativeSurface`                      | Mounts a validated surface using the host's component catalog.                                  |
-| `useMcpNativeActionDispatcher`          | Adapts asynchronous runtime dispatch into a stable event callback with required error handling. |
-| `useNativeRenderPlan`                   | Memoizes a trusted render plan for a validated surface identity.                                |
-| `createNativeRenderPlan`                | Converts a validated `A2uiSurface` into a `NativeElement` tree.                                 |
-| `createA2uiV1NativeRenderPlan`          | Revalidates and adapts the supported v1 subset into a trusted `NativeElement` tree.             |
-| `A2UI_V1_NATIVE_COMPONENT_NAMES`        | Exact basic-catalog component names implemented by the current native adapter.                  |
-| `A2UI_V1_NATIVE_MAX_RENDER_NODES`       | Bound on expanded v1 render-plan nodes.                                                         |
-| `A2uiV1NativeEventDescriptor`           | Resolved inert event data retained for later renderer-to-agent dispatch.                        |
-| `NativeComponentCatalog`                | Contract for locally bundled `View`, `Text`, `Button`, and `TextInput` implementations.         |
-| `NativeActionHandler`                   | Synchronous handler for a validated declared action.                                            |
-| `NativeBindingChangeHandler`            | Handler receiving a validated binding name and the next text value.                             |
-| `McpNativeActionDispatcherOptions`      | Required action error callback and optional result callback.                                    |
-| `NativeElement` / `NativeComponentName` | Serializable trusted-plan node and its fixed component-name union.                              |
+| Export                                  | Purpose                                                                                                  |
+| --------------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| `McpNativeSurface`                      | Mounts a validated surface using the host's component catalog.                                           |
+| `A2uiV1NativeSurface`                   | Mounts the supported v1 subset with local bindings and official action-envelope callbacks.               |
+| `useMcpNativeActionDispatcher`          | Adapts asynchronous runtime dispatch into a stable event callback with required error handling.          |
+| `useNativeRenderPlan`                   | Memoizes a trusted render plan for a validated surface identity.                                         |
+| `createNativeRenderPlan`                | Converts a validated `A2uiSurface` into a `NativeElement` tree.                                          |
+| `createA2uiV1NativeRenderPlan`          | Revalidates and adapts the supported v1 subset into a trusted `NativeElement` tree.                      |
+| `resolveA2uiV1NativeEvent`              | Revalidates and resolves one reachable static or template-instance event against the latest local model. |
+| `resolveA2uiV1NativeOpenUrl`            | Revalidates and resolves one reachable HTTP(S) URL action against the latest local model.                |
+| `A2UI_V1_NATIVE_COMPONENT_NAMES`        | Exact basic-catalog component names implemented by the current native adapter.                           |
+| `A2UI_V1_NATIVE_MAX_RENDER_NODES`       | Bound on expanded v1 render-plan nodes.                                                                  |
+| `A2UI_V1_NATIVE_MAX_OPEN_URL_LENGTH`    | Per-action bound on canonical HTTP(S) URL length.                                                        |
+| `A2uiV1NativeEventDescriptor`           | Resolved trusted-plan event data used by mounted dispatch or custom hosts.                               |
+| `A2uiV1NativeOpenUrlDescriptor`         | Canonical URL plus surface, component, and optional template-instance identity.                          |
+| `A2uiV1NativeRenderPlanOptions`         | Optional renderer-local model and host-owned BCP 47 locale.                                              |
+| `A2uiV1NativeEventResolutionOptions`    | Optional template instance key and matching host-owned BCP 47 locale.                                    |
+| `A2uiV1NativeOpenUrlResolutionOptions`  | Optional template instance key and matching host-owned BCP 47 locale for URL resolution.                 |
+| `A2uiV1NativeActionHandler`             | Host callback receiving the validated action envelope and, when opted in, the local data model.          |
+| `A2uiV1NativeOpenUrlPolicy`             | Synchronous host predicate authorizing one canonical URL during its Button press.                        |
+| `A2uiV1NativeOpenUrlHandler`            | Host-owned callback that opens an authorized URL through a platform API.                                 |
+| `NativeComponentCatalog`                | Base primitives plus optional closed host-owned component variants.                                      |
+| `NativeComponentVariants`               | Optional overrides for supported structure and pinned style hints, with primitive fallbacks.             |
+| `Native*Variant` types                  | Closed view, text, button, and text-input variant keys.                                                  |
+| `NativeAccessibilityRole`               | Renderer-derived closed role union for supported text and button primitives.                             |
+| `NativeAccessibilityState`              | Renderer-derived state currently exposing only the supported button disabled flag.                       |
+| `createNative*Adapter` helpers          | Typed mappings from trusted primitive props into locally bundled component-library APIs.                 |
+| `NativeComponentPropMapper`             | Generic mapper type used by the four host component adapter helpers.                                     |
+| `NativeActionHandler`                   | Synchronous handler for a validated declared action.                                                     |
+| `NativeBindingChangeHandler`            | Handler receiving a validated binding name and the next text value.                                      |
+| `McpNativeActionDispatcherOptions`      | Required action error callback and optional result callback.                                             |
+| `NativeElement` / `NativeComponentName` | Serializable trusted-plan node and its fixed component-name union.                                       |
 
 ## Current mappings
 
-| Surface node | Native component | Host props and event behavior                                                              |
-| ------------ | ---------------- | ------------------------------------------------------------------------------------------ |
-| `container`  | `View`           | Nested trusted children                                                                    |
-| `text`       | `Text`           | Validated text as `children`                                                               |
-| `button`     | `Button`         | `title`, matching `accessibilityLabel`, and an `onPress` callback for its validated action |
-| `text-input` | `TextInput`      | Label as placeholder/accessibility label, optional value, and binding-aware `onChangeText` |
+| Surface node | Native component | Host props and event behavior                                                             |
+| ------------ | ---------------- | ----------------------------------------------------------------------------------------- |
+| `container`  | `View`           | Nested trusted children                                                                   |
+| `text`       | `Text`           | Validated `children`, closed `text` role, and enabled font scaling                        |
+| `button`     | `Button`         | `title`, label, closed `button` role/state, and `onPress` for its validated action        |
+| `text-input` | `TextInput`      | Label/placeholder, enabled font scaling, optional value, and binding-aware `onChangeText` |
 
 ## Trust boundary
 
@@ -138,12 +269,14 @@ Dynamic list templates, relative bindings, renderer functions, renderer-side che
 - The server cannot send executable React Native code.
 - Render plans should only be created from a successfully validated surface.
 - The v1 adapter performs policy validation again at its public boundary.
-- Unsupported v1 components, dynamic templates, and executable functions fail closed.
+- The mounted v1 surface owns local binding state and revalidates action context at dispatch time.
+- Unsupported v1 components and arbitrary executable functions fail closed.
 - Declared actions and their complete JSON arguments are validated again immediately before emission.
 - Rendered component props are selected explicitly; unchecked server props are never spread into host components.
-- The host must explicitly map components, own state, enforce permissions, and configure the runtime action policy; dispatch is denied when no policy allows it.
+- Accessibility roles, native state, focus eligibility, and font scaling are renderer-derived; server data cannot replace them.
+- The host must explicitly map components, enforce permissions, and choose the renderer-to-agent transport; emitting an envelope does not grant network or device access.
 - Asynchronous action failures cannot become unhandled rejections because `useMcpNativeActionDispatcher` requires an error callback.
-- Future styling and component expansion must preserve allowlists rather than spreading unchecked server props.
+- Styling variants preserve pinned allowlists and never spread unchecked server props; future component expansion must retain the same boundary.
 
 See [`@mcp-native/a2ui`](https://www.npmjs.com/package/@mcp-native/a2ui) for parsing and [`@mcp-native/core`](https://www.npmjs.com/package/@mcp-native/core) for action dispatch. Install [`mcp-native`](https://www.npmjs.com/package/mcp-native) for the combined runtime and UI APIs.
 

package/dist/component-adapters.d.ts

@@ -0,0 +1,86 @@
+import { type ComponentType, type ReactNode } from "react";
+export type NativeAccessibilityRole = "button" | "text";
+export interface NativeAccessibilityState {
+    readonly disabled: boolean;
+}
+export interface NativeAccessibilityProps {
+    readonly accessible?: boolean;
+    readonly accessibilityElementsHidden?: boolean;
+    readonly accessibilityHint?: string;
+    readonly accessibilityLabel?: string;
+    readonly accessibilityLiveRegion?: "assertive" | "none" | "polite";
+    readonly importantForAccessibility?: "auto" | "no-hide-descendants";
+}
+export interface NativeViewStyle {
+    readonly alignItems?: "center" | "flex-end" | "flex-start" | "stretch";
+    readonly flexDirection?: "column" | "row";
+    readonly flexGrow?: number;
+    readonly justifyContent?: "center" | "flex-end" | "flex-start" | "space-around" | "space-between" | "space-evenly";
+}
+export interface NativeViewComponentProps extends NativeAccessibilityProps {
+    readonly children?: ReactNode;
+    readonly style?: NativeViewStyle;
+}
+export interface NativeTextComponentProps extends NativeAccessibilityProps {
+    readonly accessible: boolean;
+    readonly accessibilityRole: "text";
+    readonly allowFontScaling: true;
+    readonly children: string;
+}
+export interface NativeButtonComponentProps extends NativeAccessibilityProps {
+    readonly accessible: boolean;
+    readonly accessibilityLabel: string;
+    readonly accessibilityRole: "button";
+    readonly accessibilityState: NativeAccessibilityState;
+    readonly disabled?: boolean;
+    readonly onPress: () => void;
+    readonly title: string;
+    readonly validationMessages?: readonly string[];
+}
+export interface NativeTextInputComponentProps extends NativeAccessibilityProps {
+    readonly accessible: boolean;
+    readonly accessibilityLabel: string;
+    readonly allowFontScaling: true;
+    readonly invalid?: boolean;
+    readonly keyboardType?: "numeric";
+    readonly multiline?: boolean;
+    readonly onChangeText?: (value: string) => void;
+    readonly placeholder: string;
+    readonly secureTextEntry?: boolean;
+    readonly validationMessages?: readonly string[];
+    readonly value?: string;
+}
+export type NativeViewVariant = "card" | "column" | "list" | "row";
+export type NativeTextVariant = "body" | "caption";
+export type NativeButtonVariant = "borderless" | "default" | "primary";
+export type NativeTextInputVariant = "longText" | "number" | "obscured" | "shortText";
+/**
+ * Optional locally bundled component overrides for the pinned A2UI style hints.
+ * The renderer selects only these closed keys and still supplies primitive props.
+ */
+export interface NativeComponentVariants {
+    readonly View?: Partial<Record<NativeViewVariant, ComponentType<NativeViewComponentProps>>>;
+    readonly Text?: Partial<Record<NativeTextVariant, ComponentType<NativeTextComponentProps>>>;
+    readonly Button?: Partial<Record<NativeButtonVariant, ComponentType<NativeButtonComponentProps>>>;
+    readonly TextInput?: Partial<Record<NativeTextInputVariant, ComponentType<NativeTextInputComponentProps>>>;
+}
+/** Locally bundled components chosen by the host application. */
+export interface NativeComponentCatalog {
+    readonly View: ComponentType<NativeViewComponentProps>;
+    readonly Text: ComponentType<NativeTextComponentProps>;
+    readonly Button: ComponentType<NativeButtonComponentProps>;
+    readonly TextInput: ComponentType<NativeTextInputComponentProps>;
+    /** Optional semantic/style variants; omitted entries fall back to the base primitive. */
+    readonly variants?: NativeComponentVariants;
+}
+/** Maps renderer-selected primitive props into one locally bundled host component. */
+export type NativeComponentPropMapper<TrustedProps extends object, HostProps extends object> = (props: TrustedProps) => HostProps;
+/** Adapts trusted MCP Native view props to a host design-system component. */
+export declare function createNativeViewAdapter<HostProps extends object>(component: ComponentType<HostProps>, mapProps: NativeComponentPropMapper<NativeViewComponentProps, HostProps>): ComponentType<NativeViewComponentProps>;
+/** Adapts trusted MCP Native text props to a host design-system component. */
+export declare function createNativeTextAdapter<HostProps extends object>(component: ComponentType<HostProps>, mapProps: NativeComponentPropMapper<NativeTextComponentProps, HostProps>): ComponentType<NativeTextComponentProps>;
+/** Adapts trusted MCP Native button props to a host design-system component. */
+export declare function createNativeButtonAdapter<HostProps extends object>(component: ComponentType<HostProps>, mapProps: NativeComponentPropMapper<NativeButtonComponentProps, HostProps>): ComponentType<NativeButtonComponentProps>;
+/** Adapts trusted MCP Native text-input props to a host design-system component. */
+export declare function createNativeTextInputAdapter<HostProps extends object>(component: ComponentType<HostProps>, mapProps: NativeComponentPropMapper<NativeTextInputComponentProps, HostProps>): ComponentType<NativeTextInputComponentProps>;
+//# sourceMappingURL=component-adapters.d.ts.map

package/dist/component-adapters.d.ts.map

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

package/dist/component-adapters.js

@@ -0,0 +1,26 @@
+import { createElement } from "react";
+function createComponentAdapter(primitiveName, component, mapProps) {
+    function NativeComponentAdapter(props) {
+        return createElement(component, mapProps(props));
+    }
+    const componentName = component.displayName ?? component.name ?? "Component";
+    NativeComponentAdapter.displayName = `McpNative${primitiveName}Adapter(${componentName})`;
+    return NativeComponentAdapter;
+}
+/** Adapts trusted MCP Native view props to a host design-system component. */
+export function createNativeViewAdapter(component, mapProps) {
+    return createComponentAdapter("View", component, mapProps);
+}
+/** Adapts trusted MCP Native text props to a host design-system component. */
+export function createNativeTextAdapter(component, mapProps) {
+    return createComponentAdapter("Text", component, mapProps);
+}
+/** Adapts trusted MCP Native button props to a host design-system component. */
+export function createNativeButtonAdapter(component, mapProps) {
+    return createComponentAdapter("Button", component, mapProps);
+}
+/** Adapts trusted MCP Native text-input props to a host design-system component. */
+export function createNativeTextInputAdapter(component, mapProps) {
+    return createComponentAdapter("TextInput", component, mapProps);
+}
+//# sourceMappingURL=component-adapters.js.map

package/dist/component-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-adapters.js","sourceRoot":"","sources":["../src/component-adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAsC,MAAM,OAAO,CAAC;AAuG1E,SAAS,sBAAsB,CAC7B,aAAuD,EACvD,SAAmC,EACnC,QAA4D;IAE5D,SAAS,sBAAsB,CAAC,KAAmB;QACjD,OAAO,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,aAAa,GAAG,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,IAAI,IAAI,WAAW,CAAC;IAC7E,sBAAsB,CAAC,WAAW,GAAG,YAAY,aAAa,WAAW,aAAa,GAAG,CAAC;IAC1F,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,uBAAuB,CACrC,SAAmC,EACnC,QAAwE;IAExE,OAAO,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,uBAAuB,CACrC,SAAmC,EACnC,QAAwE;IAExE,OAAO,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,yBAAyB,CACvC,SAAmC,EACnC,QAA0E;IAE1E,OAAO,sBAAsB,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAC/D,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,4BAA4B,CAC1C,SAAmC,EACnC,QAA6E;IAE7E,OAAO,sBAAsB,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClE,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,11 @@
-import type { A2uiSurface } from "@mcp-native/a2ui";
-import type { McpNativeAction, McpToolCallResult } from "@mcp-native/core";
-import { type ComponentType, type ReactElement, type ReactNode } from "react";
+import type { A2uiSurface, A2uiV1ActionEnvelope, A2uiV1SurfaceState, A2uiV1SurfaceValidationPolicy } from "@mcp-native/a2ui";
+import type { JsonObject, McpNativeAction, McpToolCallResult } from "@mcp-native/core";
+import { type ReactElement } from "react";
+import type { NativeComponentCatalog } from "./component-adapters.js";
+import { type A2uiV1NativeOpenUrlDescriptor } from "./v1.js";
+export { createNativeButtonAdapter, createNativeTextAdapter, createNativeTextInputAdapter, createNativeViewAdapter, } from "./component-adapters.js";
+export type { NativeComponentPropMapper } from "./component-adapters.js";
+export type { NativeAccessibilityProps, NativeAccessibilityRole, NativeAccessibilityState, NativeButtonComponentProps, NativeButtonVariant, NativeComponentCatalog, NativeComponentVariants, NativeTextComponentProps, NativeTextInputComponentProps, NativeTextInputVariant, NativeTextVariant, NativeViewComponentProps, NativeViewStyle, NativeViewVariant, } from "./component-adapters.js";
 export type NativeComponentName = "Button" | "Text" | "TextInput" | "View";
 /**
  * A serializable render plan. A React Native host maps these trusted component
@@ -12,38 +17,40 @@ export interface NativeElement {
     readonly props: Readonly<Record<string, unknown>>;
     readonly children?: readonly NativeElement[];
 }
-export interface NativeViewComponentProps {
-    readonly children?: ReactNode;
-}
-export interface NativeTextComponentProps {
-    readonly children: string;
-}
-export interface NativeButtonComponentProps {
-    readonly accessibilityLabel: string;
-    readonly onPress: () => void;
-    readonly title: string;
-}
-export interface NativeTextInputComponentProps {
-    readonly accessibilityLabel: string;
-    readonly onChangeText?: (value: string) => void;
-    readonly placeholder: string;
-    readonly value?: string;
-}
-/** Locally bundled components chosen by the host application. */
-export interface NativeComponentCatalog {
-    readonly View: ComponentType<NativeViewComponentProps>;
-    readonly Text: ComponentType<NativeTextComponentProps>;
-    readonly Button: ComponentType<NativeButtonComponentProps>;
-    readonly TextInput: ComponentType<NativeTextInputComponentProps>;
-}
+/** @deprecated Use `A2uiV1NativeSurface` and its official action envelope handler. */
 export type NativeActionHandler = (action: McpNativeAction) => void;
+/** @deprecated Use `A2uiV1NativeSurface` renderer-local data-model handling. */
 export type NativeBindingChangeHandler = (binding: string, value: string) => void;
+/** @deprecated Use `A2uiV1NativeSurfaceProps`. */
 export interface McpNativeSurfaceProps {
     readonly surface: A2uiSurface;
     readonly components: NativeComponentCatalog;
     readonly onAction: NativeActionHandler;
     readonly onBindingChange?: NativeBindingChangeHandler;
 }
+export type A2uiV1NativeActionHandler = (envelope: A2uiV1ActionEnvelope, dataModel?: JsonObject) => void;
+/** Synchronous host authorization checked during the originating Button press. */
+export type A2uiV1NativeOpenUrlPolicy = (request: A2uiV1NativeOpenUrlDescriptor) => boolean;
+/** Host-owned platform opener. The library never invokes a browser or URL handler directly. */
+export type A2uiV1NativeOpenUrlHandler = (request: A2uiV1NativeOpenUrlDescriptor) => void;
+export interface A2uiV1NativeSurfaceProps {
+    readonly surface: A2uiV1SurfaceState;
+    readonly policy: A2uiV1SurfaceValidationPolicy;
+    readonly components: NativeComponentCatalog;
+    /** Receives an official envelope and, only after explicit surface opt-in, the local model. */
+    readonly onAction: A2uiV1NativeActionHandler;
+    /** Required with `onOpenUrl` when this surface is allowed to use the local `openUrl` function. */
+    readonly openUrlPolicy?: A2uiV1NativeOpenUrlPolicy;
+    /** Executes an authorized URL while the originating Button press is still active. */
+    readonly onOpenUrl?: A2uiV1NativeOpenUrlHandler;
+    /** Observes renderer-local state changes without turning keystrokes into network calls. */
+    readonly onDataModelChange?: (dataModel: JsonObject) => void;
+    readonly actionMetadata?: JsonObject;
+    /** Host-selected BCP 47 locale for renderer-side number, currency, date, and plural formatting. */
+    readonly locale?: string;
+    /** Injectable RFC 3339 timestamp source for host clocks and deterministic tests. */
+    readonly now?: () => string;
+}
 export interface McpNativeDispatcher {
     dispatch(action: McpNativeAction): Promise<McpToolCallResult>;
 }
@@ -51,8 +58,9 @@ export interface McpNativeActionDispatcherOptions {
     readonly onError: (error: unknown) => void;
     readonly onResult?: (result: McpToolCallResult) => void;
 }
+/** @deprecated Use `createA2uiV1NativeRenderPlan`. */
 export declare function createNativeRenderPlan(surface: A2uiSurface): NativeElement;
-/** Memoizes the trusted render plan for a validated surface identity. */
+/** @deprecated Use `A2uiV1NativeSurface`. */
 export declare function useNativeRenderPlan(surface: A2uiSurface): NativeElement;
 /**
  * Creates a stable, synchronous event handler for a runtime's asynchronous
@@ -60,8 +68,13 @@ export declare function useNativeRenderPlan(surface: A2uiSurface): NativeElement
  * routed to the required error hook.
  */
 export declare function useMcpNativeActionDispatcher(dispatcher: McpNativeDispatcher, options: McpNativeActionDispatcherOptions): NativeActionHandler;
-/** Renders a validated surface with the host's locally bundled components. */
+/** @deprecated Use `A2uiV1NativeSurface`. */
 export declare function McpNativeSurface({ surface, components, onAction, onBindingChange, }: McpNativeSurfaceProps): ReactElement;
-export { A2UI_V1_NATIVE_COMPONENT_NAMES, A2UI_V1_NATIVE_MAX_RENDER_NODES, createA2uiV1NativeRenderPlan, } from "./v1.js";
-export type { A2uiV1NativeEventDescriptor } from "./v1.js";
+/**
+ * Mounts the supported A2UI v1 subset with renderer-local two-way bindings.
+ * Agent events are resolved against the latest local model at press time.
+ */
+export declare function A2uiV1NativeSurface({ surface, policy, components, onAction, openUrlPolicy, onOpenUrl, onDataModelChange, actionMetadata, locale, now, }: A2uiV1NativeSurfaceProps): ReactElement;
+export { A2UI_V1_NATIVE_COMPONENT_NAMES, A2UI_V1_NATIVE_MAX_OPEN_URL_LENGTH, A2UI_V1_NATIVE_MAX_RENDER_NODES, createA2uiV1NativeRenderPlan, resolveA2uiV1NativeEvent, resolveA2uiV1NativeOpenUrl, } from "./v1.js";
+export type { A2uiV1NativeEventDescriptor, A2uiV1NativeEventResolutionOptions, A2uiV1NativeOpenUrlDescriptor, A2uiV1NativeOpenUrlResolutionOptions, A2uiV1NativeRenderPlanOptions, } from "./v1.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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}