@symbiote-native/react 0.1.1 → 0.2.1

package/README.md

@@ -20,6 +20,19 @@ adapter, not the core.
 
 ---
 
+## Install
+
+```bash
+npm install @symbiote-native/react react-native react
+```
+
+`react-native` and `react` stay your app's own top-level dependencies — SymbioteNative doesn't hide
+them, it only replaces the JS renderer that drives them. There's no `create-symbiote` scaffolder
+yet, so the Metro config and the `index.js` entry seam below come from
+[`examples/react`](../../examples/react) rather than a generator.
+
+---
+
 ## Use it
 
 The app is ordinary React — it imports primitives from `@symbiote-native/react`, not `react-native`:

package/build/bootstrap.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentType } from 'react';
+import { type IBootstrapHostOptions } from '@symbiote-native/components/bootstrap';
+export type { IBootstrapHostOptions } from '@symbiote-native/components/bootstrap';
+export type IRegisterAppOptions = IBootstrapHostOptions & {
+    appName: string;
+};
+export declare function registerApp(App: ComponentType<object>, options: IRegisterAppOptions): void;

package/build/bootstrap.js

@@ -0,0 +1,17 @@
+// Zero-config app entry: wires the four RN-backed host seams (via @symbiote-native/components'
+// bootstrapHost) plus this adapter's own AppRegistry host-registrar bridge, then registers the
+// root component — collapsing the canary's manual sequence into one call. Lives OUTSIDE the
+// package's main barrel (see package.json's "./bootstrap" export): it imports react-native
+// directly, which Vitest's Flow-unaware transform can't parse (see
+// @symbiote-native/components/bootstrap for the full reason).
+import { AppRegistry as RNAppRegistry } from 'react-native';
+import { bootstrapHost } from '@symbiote-native/components/bootstrap';
+import { AppRegistry, setHostRegistrar } from './modules/app-registry';
+// Mirrors bare RN's own `AppRegistry.registerComponent(appName, () => App)` idiom, minus the
+// manual host wiring in front of it.
+export function registerApp(App, options) {
+    const { appName, ...bootstrapOptions } = options;
+    bootstrapHost(bootstrapOptions);
+    setHostRegistrar(RNAppRegistry);
+    AppRegistry.registerComponent(appName, () => App);
+}

package/metro-css-parser.cjs

@@ -8,4 +8,7 @@
 // the way a flat classic node_modules would). .cjs, not .js: this package is "type": "module",
 // and Metro's babelTransformerPath loading expects a require()-able module. See the
 // symbiote-sfc-style-compiler skill.
-module.exports = require('@symbiote-native/css-parser');
+// createCssMetroTransformer is a factory, not a ready transformer — Metro's
+// babelTransformerPath needs the actual {transform, getCacheKey} object it returns,
+// not the css-parser package barrel.
+module.exports = require('@symbiote-native/css-parser').createCssMetroTransformer();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/react",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "SymbioteNative's React adapter — a react-reconciler host config (mutation mode) driving real native iOS/Android views through stock React Native Fabric.",
   "repository": {
     "type": "git",
@@ -21,6 +21,10 @@
       "types": "./build/index.d.ts",
       "default": "./build/index.js"
     },
+    "./bootstrap": {
+      "types": "./build/bootstrap.d.ts",
+      "default": "./build/bootstrap.js"
+    },
     "./metro-css-parser": "./metro-css-parser.cjs"
   },
   "files": [
@@ -32,8 +36,8 @@
   },
   "dependencies": {
     "react-reconciler": "^0.33.0",
-    "@symbiote-native/components": "0.1.1",
-    "@symbiote-native/css-parser": "0.1.1",
+    "@symbiote-native/components": "0.2.0",
+    "@symbiote-native/css-parser": "0.2.0",
     "@symbiote-native/engine": "0.1.1"
   },
   "peerDependencies": {
@@ -44,7 +48,7 @@
     "@types/react": "^19.2.0",
     "@types/react-reconciler": "^0.32.2",
     "react": "19.2.3",
-    "@symbiote-native/test-utils": "0.0.0"
+    "@symbiote-native/test-utils": "0.1.1"
   },
   "scripts": {
     "typecheck": "tsc --build",