@mcp-native/react-native 0.9.1 → 0.9.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MCP Native contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -12,23 +12,30 @@
 
 </div>
 
-> **Pre-1.0 release candidate:** this package mounts the complete pinned A2UI basic catalog,
-> policy-gated media, and exactly negotiated local host extensions. Its `0.9.x` API is frozen for
-> `1.0.0` review; the stable compatibility guarantee begins at `1.0.0`.
+`@mcp-native/react-native` turns a surface validated by `@mcp-native/a2ui` into native UI using
+components supplied by your application. It supports the complete pinned A2UI basic catalog,
+policy-gated media, and locally compiled host extensions. Your app keeps control of the component
+implementations, visual design, and action delivery.
 
-`@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 available only through deprecated migration APIs, while the v1.0 adapter converts the complete pinned basic catalog, including bounded dynamic lists and policy-gated media, into the same host-owned `NativeElement` boundary. Exactly negotiated local host extensions use a separate closed registration boundary. See the [feature-scoped conformance profile](https://github.com/pablospaniard/mcp-native/blob/main/docs/a2ui-v1-conformance.md).
+The renderer implements the native portion of the documented A2UI v1 Candidate profile. The v1 adapter converts the complete pinned basic catalog, including bounded dynamic lists and policy-gated media, into the host-owned `NativeElement` boundary. Exactly negotiated local host extensions use a separate closed registration boundary. The custom `0.1` surface remains available through migration APIs. See the [feature-scoped A2UI profile](https://github.com/pablospaniard/mcp-native/blob/main/docs/a2ui-v1-conformance.md) for exact coverage.
 
 ## Install
 
 ```bash
-npm install @mcp-native/react-native react react-native
+npm install @mcp-native/react-native react
 ```
 
-`@mcp-native/a2ui` and `@mcp-native/core` are installed as dependencies. React is a peer dependency. React Native `>=0.87.0 <1` is an optional peer because the renderer does not import it or choose a platform implementation; a native host supplies its locally bundled components.
+`@mcp-native/a2ui` and `@mcp-native/core` are installed as dependencies. React `>=18.1.0` is the
+only peer dependency. The renderer does not depend on Expo or import React Native; a native host
+supplies its locally bundled components and platform integrations.
+
+## Start with the A2UI v1 renderer
+
+New integrations mount `A2uiV1NativeSurface` with an explicit catalog policy and locally bundled
+components. Continue with the [v1 render-plan adapter](#a2ui-v1-render-plan-adapter) for the complete
+host flow, catalog mapping, local state, validation, actions, media, and extension support.
 
-## Deprecated custom `0.1` quick start
+## Legacy custom `0.1` migration
 
 Use the explicit legacy subpaths during `0.9.x`. These APIs leave package roots at `1.0.0`; the
 subpaths remain frozen for migration and security fixes.
@@ -84,7 +91,7 @@ The renderer uses only the currently allowed component names:
 type NativeComponentName = "Button" | "Text" | "TextInput" | "View";
 ```
 
-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`.
+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 surface. New hosts should use `A2uiV1NativeSurface`.
 
 ## A2UI v1 render-plan adapter
 
@@ -121,18 +128,19 @@ registry and an exact `hostExtensionPolicy` grant. Advertise their catalog IDs w
 `getA2uiV1NativeSupportedHostExtensionCatalogIds` only after the local registration and policy are
 installed. See the [media and extension guide](../../docs/media-and-host-extensions.md).
 
-These mappings have automated host-boundary coverage. The [Expo Go integration PoC
-policy](../../docs/native-accessibility-testing.md) defines the shared surface and the independent
-app-per-library approach for platform and component-library validation. 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 host at the package's exact tested boundaries: current latest `0.87.1` and declared minimum
-`0.87.0`. Each host installs local package tarballs and the pinned accessibility,
-complete-catalog, media, and Codegen/Fabric extension fixtures.
-The [Expo Go integration PoC policy](../../docs/native-accessibility-testing.md) documents the
-non-blocking app-level compatibility work. Generated hosts remain automated package fixtures and do
-not establish support for a component library.
+These mappings have automated host-boundary coverage. The runnable [Expo Go todo
+app](../../examples/expo-go-todolist/README.md) demonstrates the lifecycle, catalog, bindings,
+actions, persistence, and accessibility boundary in a complete native workflow. 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 a pinned temporary native
+host. It installs local package tarballs and the accessibility, complete-catalog, media, and
+Codegen/Fabric extension fixtures. This is reproducible integration evidence, not a package peer or
+native-framework version boundary.
+The [Expo Go integration proof](../../docs/native-accessibility-testing.md) documents the runnable
+app-level evidence. Generated hosts remain the automated package fixtures; the Expo app complements
+them with a workflow users can launch and inspect directly.
 
 The Milestone 9 fixture also places this native surface beside an isolated MCP Apps WebView through
 the convenience package's host-owned coordinator. It exercises fixed accessibility order,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-native/react-native",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "React Native renderer primitives for MCP Native.",
   "keywords": [
     "a2ui",
@@ -21,6 +21,7 @@
   },
   "files": [
     "dist",
+    "LICENSE",
     "README.md"
   ],
   "type": "module",
@@ -30,19 +31,21 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
     "./legacy": {
       "types": "./dist/legacy.d.ts",
-      "import": "./dist/legacy.js"
+      "import": "./dist/legacy.js",
+      "default": "./dist/legacy.js"
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@mcp-native/a2ui": "^0.9.1",
-    "@mcp-native/core": "^0.9.1"
+    "@mcp-native/a2ui": "^0.9.3",
+    "@mcp-native/core": "^0.9.3"
   },
   "devDependencies": {
     "@types/react": "19.1.17",
@@ -50,12 +53,6 @@
     "test-renderer": "1.2.0"
   },
   "peerDependencies": {
-    "react": ">=18.3.1 <20",
-    "react-native": ">=0.87.0 <1"
-  },
-  "peerDependenciesMeta": {
-    "react-native": {
-      "optional": true
-    }
+    "react": ">=18.1.0"
   }
 }