@symbiote-native/components 0.1.1 → 0.2.0

package/README.md

@@ -33,6 +33,14 @@ supplies only the third:
 `Switch` is the canonical reference for a full three-layer component; `ActivityIndicator` is the
 canonical render-only reference (no state machine needed).
 
+### Install
+
+Nearly every consumer gets this transitively, through an adapter. Building a new adapter yourself:
+
+```bash
+npm install @symbiote-native/components
+```
+
 ---
 
 ## Usage

package/build/bootstrap.d.ts

@@ -0,0 +1,9 @@
+import { type IColorValue, type IDeviceEventSource, type INativeViewConfigSource } from '@symbiote-native/engine';
+export type IBootstrapHostOptions = {
+    colorProcessor?: (value: IColorValue) => unknown;
+    imageSourceResolver?: (source: unknown) => unknown;
+    deviceEventSource?: IDeviceEventSource;
+    nativeViewConfigSource?: INativeViewConfigSource;
+    debug?: boolean;
+};
+export declare function bootstrapHost(options?: IBootstrapHostOptions): void;

package/build/bootstrap.js

@@ -0,0 +1,43 @@
+// Zero-config host bootstrap for @symbiote-native/components' four RN-backed seams
+// (colorProcessor, imageSourceResolver, deviceEventSource, nativeViewConfigSource), wired from
+// real react-native in one call — collapses what every canary example currently hand-wires at
+// startup. Lives OUTSIDE the package's main barrel (see package.json's separate "./bootstrap"
+// export): react-native's own source is Flow syntax Vitest's transform can't parse, so anything
+// importing it directly must stay unreachable from the tested main index.ts.
+import { processColor, DeviceEventEmitter, Image } from 'react-native';
+import { setColorProcessor, setDeviceEventSource, setNativeViewConfigSource, } from '@symbiote-native/engine';
+import { setImageSourceResolver } from './view/render-image';
+// @ts-expect-error react-native ships no types for this internal path (plain .js) — the
+// try/catch below is what actually proves the shape, not TS.
+import * as ReactNativeViewConfigRegistry from 'react-native/Libraries/Renderer/shims/ReactNativeViewConfigRegistry';
+// Third-party Fabric views derive their events + prop processors from RN's own ViewConfig
+// registry; `get` throws for an unregistered name, so undefined is the right answer for
+// anything the registry doesn't know (our built-ins never reach here).
+function defaultNativeViewConfigSource(name) {
+    try {
+        return ReactNativeViewConfigRegistry.get(name);
+    }
+    catch {
+        return undefined;
+    }
+}
+// require('./x.png') asset ids and {uri} sources are resolved by RN's own resolver before they
+// reach the shared render fns. `source` is untyped at the setImageSourceResolver seam by design
+// (any component's resolved shape flows through it) — this is the I/O edge where it crosses
+// into RN's own typed Image API.
+function defaultImageSourceResolver(source) {
+    return Image.resolveAssetSource(source);
+}
+// IColorValue is our own structural mirror of the runtime shapes RN's processColor accepts
+// (CSS string / PlatformColor / DynamicColorIOS); RN's own ColorValue type is opaque, not
+// structurally identical, so this is the I/O edge between the two color representations.
+function defaultColorProcessor(value) {
+    return processColor(value);
+}
+export function bootstrapHost(options = {}) {
+    globalThis.__SYMBIOTE_DEBUG__ = options.debug ?? process.env.DEBUG === '1';
+    setColorProcessor(options.colorProcessor ?? defaultColorProcessor);
+    setImageSourceResolver(options.imageSourceResolver ?? defaultImageSourceResolver);
+    setDeviceEventSource(options.deviceEventSource ?? DeviceEventEmitter);
+    setNativeViewConfigSource(options.nativeViewConfigSource ?? defaultNativeViewConfigSource);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/components",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Framework-agnostic component logic (state machines + render functions) for SymbioteNative — written once, inherited by every adapter (React, Vue, Angular, ...).",
   "repository": {
     "type": "git",
@@ -20,6 +20,10 @@
     ".": {
       "types": "./build/index.d.ts",
       "default": "./build/index.js"
+    },
+    "./bootstrap": {
+      "types": "./build/bootstrap.d.ts",
+      "default": "./build/bootstrap.js"
     }
   },
   "files": [
@@ -31,6 +35,12 @@
   "dependencies": {
     "@symbiote-native/engine": "0.1.1"
   },
+  "peerDependencies": {
+    "react-native": ">=0.86"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.0"
+  },
   "scripts": {
     "typecheck": "tsc --build",
     "format": "prettier --write \"src/**/*.{ts,tsx}\""