@mcp-native/react-native 0.1.0 → 0.3.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 A2UI v1.0 conformance. Its current input is MCP Native's custom `0.1` surface; the planned v1.0 adapter will preserve this host-owned rendering boundary.
+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 converts a strict component subset, including bounded dynamic lists, into the same host-owned `NativeElement` boundary.
 
 ## Install
 
@@ -79,21 +79,76 @@ 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.
+The application host decides how each name maps to a locally bundled component and how declared custom `0.1` button actions reach `McpNativeRuntime`. `onBindingChange` reports a validated binding name and the next text value for that legacy proof surface.
+
+## A2UI v1 render-plan adapter
+
+Use the v1 adapter only with an explicit host policy. It revalidates the snapshot before resolving data-model bindings or creating a trusted plan.
+
+```ts
+import { createA2uiV1BasicCatalogPolicy } from "@mcp-native/a2ui";
+import {
+  A2UI_V1_NATIVE_COMPONENT_NAMES,
+  createA2uiV1NativeRenderPlan,
+} from "@mcp-native/react-native";
+
+const policy = createA2uiV1BasicCatalogPolicy({
+  allowedComponentNames: A2UI_V1_NATIVE_COMPONENT_NAMES,
+  allowedEventNames: ["save_profile"],
+});
+
+const surface = store.get("profile");
+const plan = surface && createA2uiV1NativeRenderPlan(surface, policy);
+```
+
+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`, and `pluralize`, pure `and`, `or`, and `not`, 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. Main-axis `stretch` and negative weight, which React Native flex layout cannot represent faithfully, fail closed.
+
+Use `A2uiV1NativeSurface` to mount that subset with renderer-local string state and official action envelopes:
+
+```tsx
+import { A2uiV1NativeSurface } from "@mcp-native/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 });
+    }
+  }}
+/>;
+```
+
+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.
+
+Renderer functions other than `formatString`, `formatNumber`, `formatCurrency`, `pluralize`, `and`, `or`, `not`, and template-scoped `@index`, renderer-side checks, local function actions, nested inline catalogs, and every other basic-catalog component fail closed. Number and currency formatting uses `Intl.NumberFormat`, while cardinal plural selection uses `Intl.PluralRules` and falls back to the required `other` form when the selected CLDR category is absent. The host may supply one validated, runtime-supported BCP 47 `locale` to the mounted surface, render-plan options, and event-resolution options, or omit it to use the runtime locale. 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, boolean operands are all resolved with strict types before evaluation, formatter construction failures are controlled parse errors, and formatter caches live only for one bounded render or event-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.                                 |
-| `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. |
+| `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 trusted-plan event data used by mounted dispatch or custom hosts.                               |
+| `A2uiV1NativeRenderPlanOptions`         | Optional renderer-local model and host-owned BCP 47 locale.                                              |
+| `A2uiV1NativeEventResolutionOptions`    | Optional template instance key and matching host-owned BCP 47 locale.                                    |
+| `A2uiV1NativeActionHandler`             | Host callback receiving the validated action envelope and, when opted in, the local data model.          |
+| `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.                                       |
 
 ## Current mappings
 
@@ -109,9 +164,12 @@ The application host decides how each name maps to a locally bundled component a
 - The server cannot select components outside the catalog.
 - 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.
+- 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.
+- 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.
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import type { A2uiSurface } from "@mcp-native/a2ui";
-import type { McpNativeAction, McpToolCallResult } from "@mcp-native/core";
+import type { A2uiSurface, A2uiV1ActionEnvelope, A2uiV1SurfaceState, A2uiV1SurfaceValidationPolicy } from "@mcp-native/a2ui";
+import type { JsonObject, McpNativeAction, McpToolCallResult } from "@mcp-native/core";
 import { type ComponentType, type ReactElement, type ReactNode } from "react";
 export type NativeComponentName = "Button" | "Text" | "TextInput" | "View";
 /**
@@ -12,21 +12,38 @@ export interface NativeElement {
     readonly props: Readonly<Record<string, unknown>>;
     readonly children?: readonly NativeElement[];
 }
-export interface NativeViewComponentProps {
+export interface NativeAccessibilityProps {
+    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 {
+export interface NativeTextComponentProps extends NativeAccessibilityProps {
     readonly children: string;
 }
-export interface NativeButtonComponentProps {
+export interface NativeButtonComponentProps extends NativeAccessibilityProps {
     readonly accessibilityLabel: string;
     readonly onPress: () => void;
     readonly title: string;
 }
-export interface NativeTextInputComponentProps {
+export interface NativeTextInputComponentProps extends NativeAccessibilityProps {
     readonly accessibilityLabel: string;
+    readonly keyboardType?: "numeric";
+    readonly multiline?: boolean;
     readonly onChangeText?: (value: string) => void;
     readonly placeholder: string;
+    readonly secureTextEntry?: boolean;
     readonly value?: string;
 }
 /** Locally bundled components chosen by the host application. */
@@ -44,6 +61,21 @@ export interface McpNativeSurfaceProps {
     readonly onAction: NativeActionHandler;
     readonly onBindingChange?: NativeBindingChangeHandler;
 }
+export type A2uiV1NativeActionHandler = (envelope: A2uiV1ActionEnvelope, dataModel?: JsonObject) => 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;
+    /** 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 and currency 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>;
 }
@@ -62,4 +94,11 @@ export declare function useNativeRenderPlan(surface: A2uiSurface): NativeElement
 export declare function useMcpNativeActionDispatcher(dispatcher: McpNativeDispatcher, options: McpNativeActionDispatcherOptions): NativeActionHandler;
 /** Renders a validated surface with the host's locally bundled components. */
 export declare function McpNativeSurface({ surface, components, onAction, onBindingChange, }: McpNativeSurfaceProps): ReactElement;
+/**
+ * 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, onDataModelChange, actionMetadata, locale, now, }: A2uiV1NativeSurfaceProps): ReactElement;
+export { A2UI_V1_NATIVE_COMPONENT_NAMES, A2UI_V1_NATIVE_MAX_RENDER_NODES, createA2uiV1NativeRenderPlan, resolveA2uiV1NativeEvent, } from "./v1.js";
+export type { A2uiV1NativeEventDescriptor, A2uiV1NativeEventResolutionOptions, 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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"}

package/dist/index.js

@@ -1,5 +1,7 @@
-import { parseMcpNativeAction } from "@mcp-native/core";
-import { createElement, useCallback, useMemo, } from "react";
+import { createA2uiV1ActionEnvelope, validateA2uiV1SurfaceState } from "@mcp-native/a2ui";
+import { parseJsonObject, parseMcpNativeAction } from "@mcp-native/core";
+import { createElement, useCallback, useEffect, useMemo, useRef, useState, } from "react";
+import { createA2uiV1NativeRenderPlan, resolveA2uiV1NativeEvent, } from "./v1.js";
 export function createNativeRenderPlan(surface) {
     return renderNode(surface.root);
 }
@@ -23,7 +25,96 @@ export function useMcpNativeActionDispatcher(dispatcher, options) {
 /** Renders a validated surface with the host's locally bundled components. */
 export function McpNativeSurface({ surface, components, onAction, onBindingChange, }) {
     const plan = useNativeRenderPlan(surface);
-    return renderElement(plan, components, onAction, onBindingChange);
+    return renderElement(plan, components, {
+        onAction,
+        ...(onBindingChange === undefined ? {} : { onBindingChange }),
+    });
+}
+/**
+ * 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 function A2uiV1NativeSurface({ surface, policy, components, onAction, onDataModelChange, actionMetadata, locale, now = currentTimestamp, }) {
+    const validatedSurface = useMemo(() => validateA2uiV1SurfaceState(surface, policy), [policy, surface]);
+    const sourceDataModel = validatedSurface.dataModel;
+    const sourceDataModelKey = createDataModelSourceKey(validatedSurface);
+    const [localState, setLocalState] = useState(() => ({
+        sourceDataModelKey,
+        dataModel: sourceDataModel,
+    }));
+    const dataModel = localState.sourceDataModelKey === sourceDataModelKey ? localState.dataModel : sourceDataModel;
+    const dataModelRef = useRef(dataModel);
+    dataModelRef.current = dataModel;
+    useEffect(() => {
+        setLocalState((current) => {
+            if (current.sourceDataModelKey === sourceDataModelKey) {
+                return current;
+            }
+            return { sourceDataModelKey, dataModel: sourceDataModel };
+        });
+    }, [sourceDataModel, sourceDataModelKey]);
+    const plan = useMemo(() => createA2uiV1NativeRenderPlan(validatedSurface, policy, {
+        dataModel,
+        ...(locale === undefined ? {} : { locale }),
+    }), [dataModel, locale, policy, validatedSurface]);
+    const handleBindingChange = useCallback((binding, value) => {
+        const next = updateDataModelBinding(dataModelRef.current, binding, value);
+        dataModelRef.current = next;
+        setLocalState({ sourceDataModelKey, dataModel: next });
+        onDataModelChange?.(parseJsonObject(next, "renderer data model"));
+    }, [onDataModelChange, sourceDataModelKey]);
+    const handleEvent = useCallback((event) => {
+        const currentDataModel = dataModelRef.current;
+        const resolved = resolveA2uiV1NativeEvent(validatedSurface, policy, event.sourceComponentId, currentDataModel, {
+            ...(event.instanceKey === undefined ? {} : { instanceKey: event.instanceKey }),
+            ...(locale === undefined ? {} : { locale }),
+        });
+        const envelope = createA2uiV1ActionEnvelope({
+            name: resolved.name,
+            surfaceId: resolved.surfaceId,
+            sourceComponentId: resolved.sourceComponentId,
+            context: resolved.context,
+            ...(resolved.userMessage === undefined ? {} : { userMessage: resolved.userMessage }),
+            ...(actionMetadata === undefined ? {} : { metadata: actionMetadata }),
+            timestamp: now(),
+        });
+        if (validatedSurface.sendDataModel) {
+            onAction(envelope, parseJsonObject(currentDataModel, "renderer data model"));
+        }
+        else {
+            onAction(envelope);
+        }
+    }, [actionMetadata, locale, now, onAction, policy, validatedSurface]);
+    return renderElement(plan, components, {
+        onBindingChange: handleBindingChange,
+        onV1Event: handleEvent,
+    });
+}
+function createDataModelSourceKey(surface) {
+    return canonicalizeJson([
+        surface.surfaceId,
+        surface.dataModelRevision ?? null,
+        surface.dataModel,
+    ]);
+}
+function canonicalizeJson(value) {
+    if (value === null) {
+        return "null";
+    }
+    if (typeof value === "string" || typeof value === "boolean" || typeof value === "number") {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(canonicalizeJson).join(",")}]`;
+    }
+    const object = value;
+    return `{${Object.keys(object)
+        .sort()
+        .map((key) => `${JSON.stringify(key)}:${canonicalizeJson(object[key])}`)
+        .join(",")}}`;
+}
+function currentTimestamp() {
+    return new Date().toISOString();
 }
 function renderNode(node) {
     switch (node.type) {
@@ -58,41 +149,171 @@ function renderNode(node) {
             };
     }
 }
-function renderElement(element, components, onAction, onBindingChange) {
+function renderElement(element, components, handlers) {
+    const accessibilityProps = selectAccessibilityProps(element);
     switch (element.component) {
-        case "View":
-            return createElement(components.View, { key: element.key }, element.children?.map((child) => renderElement(child, components, onAction, onBindingChange)));
+        case "View": {
+            const style = selectViewStyle(element);
+            return createElement(components.View, {
+                key: element.key,
+                ...accessibilityProps,
+                ...(style === undefined ? {} : { style }),
+            }, element.children?.map((child) => renderChildElement(child, components, handlers)));
+        }
         case "Text":
             return createElement(components.Text, {
                 key: element.key,
                 children: expectStringProp(element, "children"),
+                ...accessibilityProps,
             });
         case "Button": {
             const title = expectStringProp(element, "title");
-            const action = expectActionProp(element);
+            const onPress = createButtonPressHandler(element, handlers);
             return createElement(components.Button, {
                 key: element.key,
                 title,
-                accessibilityLabel: title,
-                onPress: () => onAction(action),
+                accessibilityLabel: accessibilityProps.accessibilityLabel ?? title,
+                ...accessibilityProps,
+                onPress,
             });
         }
         case "TextInput": {
-            const label = expectStringProp(element, "label");
+            const label = optionalStringProp(element, "label") ?? expectStringProp(element, "placeholder");
+            const placeholder = optionalStringProp(element, "placeholder") ?? label;
             const value = optionalStringProp(element, "value");
             const binding = optionalStringProp(element, "binding");
+            const behaviorProps = selectTextInputBehaviorProps(element);
             return createElement(components.TextInput, {
                 key: element.key,
-                accessibilityLabel: label,
-                placeholder: label,
+                accessibilityLabel: accessibilityProps.accessibilityLabel ?? label,
+                ...accessibilityProps,
+                ...behaviorProps,
+                placeholder,
                 ...(value === undefined ? {} : { value }),
-                ...(binding === undefined || onBindingChange === undefined
+                ...(binding === undefined || handlers.onBindingChange === undefined
                     ? {}
-                    : { onChangeText: (nextValue) => onBindingChange(binding, nextValue) }),
+                    : {
+                        onChangeText: (nextValue) => handlers.onBindingChange?.(binding, nextValue),
+                    }),
             });
         }
     }
 }
+function renderChildElement(element, components, handlers) {
+    const rendered = renderElement(element, components, handlers);
+    const weight = optionalFiniteNumberProp(element, "weight");
+    if (weight === undefined) {
+        return rendered;
+    }
+    if (weight < 0) {
+        throw new TypeError(`Expected a non-negative weight at native element ${element.key}`);
+    }
+    return createElement(components.View, { key: element.key, style: { flexGrow: weight } }, rendered);
+}
+function selectViewStyle(element) {
+    const layout = optionalStringProp(element, "layout");
+    const justify = optionalStringProp(element, "justify");
+    const align = optionalStringProp(element, "align");
+    if (layout === undefined) {
+        if (justify !== undefined || align !== undefined) {
+            throw new TypeError(`Missing layout at native element ${element.key}`);
+        }
+        return undefined;
+    }
+    if (layout !== "column" && layout !== "row") {
+        throw new TypeError(`Unsupported layout ${JSON.stringify(layout)} at native element ${element.key}`);
+    }
+    return {
+        flexDirection: layout,
+        ...(justify === undefined ? {} : { justifyContent: mapJustifyContent(justify, element.key) }),
+        ...(align === undefined ? {} : { alignItems: mapAlignItems(align, element.key) }),
+    };
+}
+function mapJustifyContent(value, elementKey) {
+    switch (value) {
+        case "start":
+            return "flex-start";
+        case "end":
+            return "flex-end";
+        case "center":
+            return "center";
+        case "spaceAround":
+            return "space-around";
+        case "spaceBetween":
+            return "space-between";
+        case "spaceEvenly":
+            return "space-evenly";
+        default:
+            throw new TypeError(`Unsupported justify value ${JSON.stringify(value)} at native element ${elementKey}`);
+    }
+}
+function mapAlignItems(value, elementKey) {
+    switch (value) {
+        case "start":
+            return "flex-start";
+        case "end":
+            return "flex-end";
+        case "center":
+        case "stretch":
+            return value;
+        default:
+            throw new TypeError(`Unsupported align value ${JSON.stringify(value)} at native element ${elementKey}`);
+    }
+}
+function selectTextInputBehaviorProps(element) {
+    const variant = optionalStringProp(element, "variant");
+    switch (variant) {
+        case undefined:
+        case "shortText":
+            return {};
+        case "longText":
+            return { multiline: true };
+        case "number":
+            return { keyboardType: "numeric" };
+        case "obscured":
+            return { secureTextEntry: true };
+        default:
+            throw new TypeError(`Unsupported text input variant ${JSON.stringify(variant)} at native element ${element.key}`);
+    }
+}
+function createButtonPressHandler(element, handlers) {
+    const hasAction = Object.hasOwn(element.props, "action");
+    const hasEvent = Object.hasOwn(element.props, "event");
+    if (hasAction === hasEvent) {
+        throw new TypeError(`Expected exactly one action or event at native element ${element.key}`);
+    }
+    if (hasAction) {
+        const action = expectActionProp(element);
+        if (handlers.onAction === undefined) {
+            throw new TypeError(`Missing native action handler for element ${element.key}`);
+        }
+        return () => handlers.onAction?.(action);
+    }
+    const event = expectV1EventProp(element);
+    if (handlers.onV1Event === undefined) {
+        throw new TypeError(`Missing A2UI v1 event handler for element ${element.key}`);
+    }
+    return () => handlers.onV1Event?.(event);
+}
+function selectAccessibilityProps(element) {
+    const accessibilityLabel = optionalStringProp(element, "accessibilityLabel");
+    const accessibilityHint = optionalStringProp(element, "accessibilityHint");
+    const live = optionalAccessibilityLiveProp(element);
+    const hidden = optionalBooleanProp(element, "accessibilityHidden");
+    return {
+        ...(accessibilityLabel === undefined ? {} : { accessibilityLabel }),
+        ...(accessibilityHint === undefined ? {} : { accessibilityHint }),
+        ...(live === undefined
+            ? {}
+            : { accessibilityLiveRegion: live === "off" ? "none" : live }),
+        ...(hidden === undefined
+            ? {}
+            : {
+                accessibilityElementsHidden: hidden,
+                importantForAccessibility: hidden ? "no-hide-descendants" : "auto",
+            }),
+    };
+}
 function expectStringProp(element, name) {
     const value = element.props[name];
     if (typeof value !== "string") {
@@ -104,6 +325,27 @@ function optionalStringProp(element, name) {
     const value = element.props[name];
     return value === undefined ? undefined : expectStringProp(element, name);
 }
+function optionalBooleanProp(element, name) {
+    const value = element.props[name];
+    if (value !== undefined && typeof value !== "boolean") {
+        throw new TypeError(`Expected a boolean at native element ${element.key}.${name}`);
+    }
+    return value;
+}
+function optionalFiniteNumberProp(element, name) {
+    const value = element.props[name];
+    if (value !== undefined && (typeof value !== "number" || !Number.isFinite(value))) {
+        throw new TypeError(`Expected a finite number at native element ${element.key}.${name}`);
+    }
+    return value;
+}
+function optionalAccessibilityLiveProp(element) {
+    const value = element.props.accessibilityLive;
+    if (value === undefined || value === "assertive" || value === "off" || value === "polite") {
+        return value;
+    }
+    throw new TypeError(`Expected an accessibility live value at native element ${element.key}.accessibilityLive`);
+}
 function expectActionProp(element) {
     const value = element.props.action;
     const path = `native element ${element.key}.action`;
@@ -115,4 +357,113 @@ function expectActionProp(element) {
         throw new TypeError(message, { cause: error });
     }
 }
+function expectV1EventProp(element) {
+    const path = `native element ${element.key}.event`;
+    const event = parseJsonObject(element.props.event, path);
+    rejectObjectKeys(event, ["context", "instanceKey", "name", "sourceComponentId", "surfaceId", "userMessage"], path);
+    const name = expectObjectString(event, "name", path);
+    const surfaceId = expectObjectString(event, "surfaceId", path);
+    const sourceComponentId = expectObjectString(event, "sourceComponentId", path);
+    const context = parseJsonObject(event.context, `${path}.context`);
+    const instanceKey = event.instanceKey;
+    if (instanceKey !== undefined && (typeof instanceKey !== "string" || instanceKey.length === 0)) {
+        throw new TypeError(`Expected a non-empty string at ${path}.instanceKey`);
+    }
+    const userMessage = event.userMessage;
+    if (userMessage !== undefined && typeof userMessage !== "string") {
+        throw new TypeError(`Expected a string at ${path}.userMessage`);
+    }
+    return {
+        name,
+        surfaceId,
+        sourceComponentId,
+        ...(instanceKey === undefined ? {} : { instanceKey }),
+        context,
+        ...(userMessage === undefined ? {} : { userMessage }),
+    };
+}
+function expectObjectString(value, name, path) {
+    const field = value[name];
+    if (typeof field !== "string" || field.length === 0) {
+        throw new TypeError(`Expected a non-empty string at ${path}.${name}`);
+    }
+    return field;
+}
+function rejectObjectKeys(value, allowed, path) {
+    const allowedKeys = new Set(allowed);
+    for (const key of Object.keys(value)) {
+        if (!allowedKeys.has(key)) {
+            throw new TypeError(`Unexpected field ${JSON.stringify(key)} at ${path}`);
+        }
+    }
+}
+function updateDataModelBinding(dataModel, binding, value) {
+    if (typeof binding !== "string" || !binding.startsWith("/") || binding.length === 1) {
+        throw new TypeError(`Expected a non-root absolute JSON Pointer binding, received ${JSON.stringify(binding)}`);
+    }
+    if (typeof value !== "string") {
+        throw new TypeError("Expected a string renderer binding value");
+    }
+    const next = parseJsonObject(dataModel, "renderer data model");
+    const tokens = binding
+        .slice(1)
+        .split("/")
+        .map((token) => decodePointerToken(token, binding));
+    let cursor = next;
+    for (const [index, token] of tokens.entries()) {
+        const last = index === tokens.length - 1;
+        if (Array.isArray(cursor)) {
+            if (!/^(0|[1-9][0-9]*)$/.test(token)) {
+                throw new TypeError(`Invalid array binding index in ${JSON.stringify(binding)}`);
+            }
+            const arrayIndex = Number(token);
+            if (!Number.isSafeInteger(arrayIndex) || arrayIndex >= cursor.length) {
+                throw new TypeError(`Renderer binding ${JSON.stringify(binding)} is missing`);
+            }
+            if (last) {
+                if (typeof cursor[arrayIndex] !== "string") {
+                    throw new TypeError(`Renderer binding ${JSON.stringify(binding)} must reference an existing string value`);
+                }
+                cursor[arrayIndex] = value;
+                break;
+            }
+            cursor = cursor[arrayIndex];
+            continue;
+        }
+        if (cursor === null || typeof cursor !== "object" || !Object.hasOwn(cursor, token)) {
+            throw new TypeError(`Renderer binding ${JSON.stringify(binding)} is missing`);
+        }
+        if (last) {
+            if (typeof cursor[token] !== "string") {
+                throw new TypeError(`Renderer binding ${JSON.stringify(binding)} must reference an existing string value`);
+            }
+            defineJsonProperty(cursor, token, value);
+            break;
+        }
+        cursor = cursor[token];
+    }
+    return parseJsonObject(next, "renderer data model");
+}
+function decodePointerToken(token, pointer) {
+    for (let index = 0; index < token.length; index += 1) {
+        if (token[index] !== "~") {
+            continue;
+        }
+        const escaped = token[index + 1];
+        if (escaped !== "0" && escaped !== "1") {
+            throw new TypeError(`Invalid JSON Pointer escape in ${JSON.stringify(pointer)}`);
+        }
+        index += 1;
+    }
+    return token.replaceAll("~1", "/").replaceAll("~0", "~");
+}
+function defineJsonProperty(object, key, value) {
+    Object.defineProperty(object, key, {
+        configurable: true,
+        enumerable: true,
+        value,
+        writable: true,
+    });
+}
+export { A2UI_V1_NATIVE_COMPONENT_NAMES, A2UI_V1_NATIVE_MAX_RENDER_NODES, createA2uiV1NativeRenderPlan, resolveA2uiV1NativeEvent, } from "./v1.js";
 //# sourceMappingURL=index.js.map