@symbiote-native/engine 0.1.0

package/build/view-config.js

@@ -0,0 +1,114 @@
+// Per-native-component event declarations: symbiote's slimmed ViewConfigRegistry.
+// Mirrors React Native's ViewConfig: each Fabric component declares which event
+// names it can emit. This is native-component knowledge (a Switch fires `change`,
+// a ScrollView fires `scroll`), shared by every adapter, so it lives here, not in
+// any one framework adapter.
+//
+// Flat-bag adapters (React / Vue / Solid) hand props and handlers mixed together
+// and must split them. They consult this registry to tell an event handler
+// (`onChange` -> `change`, a declared event) from a native prop that merely looks
+// like one (`onTintColor` -> `tintColor`, NOT a declared event -> stays a prop and
+// reaches Fabric). Structural adapters (Svelte `addEventListener`, Angular
+// `Renderer2.listen`) deliver events pre-separated and call `setEventListener`
+// directly, bypassing this entirely.
+import { isRegisteredEvent } from './registry';
+// Accessibility events from RN's base ViewConfig: every view can emit them.
+// accessibilityAction fires on iOS + Android; the other three are iOS-only and inert
+// on Android (no native producer), exactly like `scrollToTop` below.
+const A11Y_EVENTS = [
+    'accessibilityAction',
+    'accessibilityTap',
+    'magicTap',
+    'accessibilityEscape',
+];
+// Events every view can emit, from RN's base ViewConfig. `press`/`pressIn`/`pressOut`/
+// `longPress` are synthesized from the touch stream (see events.ts); `layout` is
+// universal; `focus`/`blur` are RN's bubbling focus events declared on the base View
+// (ViewPropTypes.js FocusEventProps), so any view can emit them; the accessibility
+// events are base too, so they reach every component.
+const BASE_EVENTS = [
+    'press',
+    'pressIn',
+    'pressOut',
+    'longPress',
+    'layout',
+    'focus',
+    'blur',
+    ...A11Y_EVENTS,
+];
+// An event set is platform-invariant: a text input emits `change` on iOS and Android
+// alike; only the native component NAME differs (iOS RCTSinglelineTextInputView vs
+// Android AndroidTextInput, iOS Switch vs Android AndroidSwitch). So each primitive's
+// events are declared ONCE and keyed under BOTH platform names below. The table is
+// consulted by the resolved native name (SymbioteNode.component), and only one
+// platform's names ever exist at runtime, so the other platform's keys are inert (no
+// Platform.OS branch), the names simply coexist. Missing the Android keys is what made
+// onValueChange (and Switch/Modal/RefreshControl events) silently dead on Android: the
+// onX prop failed isEventFor, fell to setProp, and no listener was ever registered.
+const TEXT_INPUT_EVENTS = [
+    'change',
+    'focus',
+    'blur',
+    'endEditing',
+    'submitEditing',
+    'keyPress',
+    'selectionChange',
+    'contentSizeChange',
+];
+const MODAL_EVENTS = ['show', 'dismiss', 'requestClose', 'orientationChange'];
+// A scroll view's events are the same on both axes and both platforms; only the native
+// NAME differs (iOS RCTScrollView for both; Android RCTScrollView vertical vs
+// AndroidHorizontalScrollView horizontal). Declared once, keyed under each name below. The
+// Android horizontal name was missing, so a horizontal FlatList's onScroll never fired and
+// its windowing stalled: same failure mode as the text-input keys.
+const SCROLL_EVENTS = [
+    'scroll',
+    'scrollBeginDrag',
+    'scrollEndDrag',
+    'momentumScrollBegin',
+    'momentumScrollEnd',
+    'contentSizeChange',
+    // iOS-only: emitted when the user taps the status bar to scroll to top. Inert on
+    // Android (no native producer), so keying it here is harmless cross-platform.
+    'scrollToTop',
+];
+// Text emits a glyph-layout event (onTextLayout) beyond the base press/layout set.
+const TEXT_EVENTS = ['textLayout'];
+// Fabric component name -> the events it emits beyond the base set. The keys match
+// SymbioteNode.component (what createNode is called with). A component absent here
+// still gets BASE_EVENTS, so a new primitive has working press/layout for free.
+const COMPONENT_EVENTS = {
+    RCTImageView: ['loadStart', 'load', 'loadEnd', 'error', 'progress', 'partialLoad'],
+    RCTScrollView: SCROLL_EVENTS,
+    AndroidHorizontalScrollView: SCROLL_EVENTS,
+    RCTSinglelineTextInputView: TEXT_INPUT_EVENTS,
+    RCTMultilineTextInputView: TEXT_INPUT_EVENTS,
+    AndroidTextInput: TEXT_INPUT_EVENTS,
+    RCTText: TEXT_EVENTS,
+    Switch: ['change'],
+    AndroidSwitch: ['change'],
+    ModalHostView: MODAL_EVENTS,
+    RCTModalHostView: MODAL_EVENTS,
+    PullToRefreshView: ['refresh'],
+    AndroidSwipeRefreshLayout: ['refresh'],
+};
+const configCache = new Map();
+// The built-in event names `component` can emit (its own + the base set). Cached;
+// the registry layer is consulted live in isEventFor so a later registration is
+// never masked by a stale cache entry.
+function eventNamesFor(component) {
+    let set = configCache.get(component);
+    if (set === undefined) {
+        set = new Set([...BASE_EVENTS, ...(COMPONENT_EVENTS[component] ?? [])]);
+        configCache.set(component, set);
+    }
+    return set;
+}
+// True when `listenerName` is an event `component` emits, false when it is an
+// ordinary native prop. This is the single authority for the event-vs-prop split:
+// the name alone never decides. Built-ins first, then any third-party registration.
+export function isEventFor(component, listenerName) {
+    if (eventNamesFor(component).has(listenerName))
+        return true;
+    return isRegisteredEvent(component, listenerName);
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@symbiote-native/engine",
+  "version": "0.1.0",
+  "description": "SymbioteJS's retained shadow-tree engine — clone-on-write commit path + event normalization over React Native Fabric, shared by every framework adapter.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "core/engine"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/core/engine#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "type": "module",
+  "main": "./build/index.js",
+  "module": "./build/index.js",
+  "types": "./build/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "default": "./build/index.js"
+    }
+  },
+  "files": [
+    "build"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react-native": ">=0.86"
+  },
+  "devDependencies": {
+    "@symbiote-native/test-utils": "0.0.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --build",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  }
+}