@symbiote-native/components 0.2.1 → 0.2.2

package/README.md

@@ -7,9 +7,9 @@ and pure render functions for every visual component (`Switch`, `Modal`, `Scroll
 exists so that "add component X to a new adapter" means writing a thin lifecycle + descriptor
 bridge, not re-implementing X's logic per framework.
 
-> New to SymbioteNative? The [root README](../../README.md) has the architecture. This package is
-> "Workstream B" — the piece that makes cross-adapter feature parity **structural** instead of a
-> promise kept by hand.
+> New to SymbioteNative? The [root README](../../README.md) has the architecture. This package
+> is the piece that makes cross-adapter feature parity **structural** instead of a promise kept
+> by hand.
 
 ---
 

package/build/accessibility-props.js

@@ -7,7 +7,7 @@
 // own View.js transform. Types are kept in sync with RN's ViewAccessibility.js.
 //
 // Framework-agnostic (imports only @symbiote-native/engine), so every adapter (React,
-// Vue, and the next) folds aria/role into accessibility* identically (ADR 0024).
+// Vue, and the next) folds aria/role into accessibility* identically.
 import { dlog } from '@symbiote-native/engine';
 // RN's web `role` → native `accessibilityRole`. Where the web role has no native
 // counterpart it is forwarded unchanged (the AccessibilityRole union stays open),

package/build/component-names/index.android.js

@@ -1,4 +1,4 @@
-// Android Fabric component names. Metro picks this file on an Android host. See ADR 0020.
+// Android Fabric component names. Metro picks this file on an Android host.
 // Each name is the ViewManager's REACT_CLASS in react-native/ReactAndroid/.../views/**.
 // device-verify-pending: source-confirmed from RN's Android ViewManagers, proven on a
 // real host by the absence of a "Can't find ViewManager '<name>'" red box.

package/build/component-names/index.ios.js

@@ -1,5 +1,5 @@
 // iOS Fabric component names. Metro picks this file on an iOS host; it is also the base
-// (component-names.ts re-exports it) for headless tsx / tsc / web fallback. See ADR 0020.
+// (component-names.ts re-exports it) for headless tsx / tsc / web fallback.
 // Fabric names are the codegen spec's registered name (the new-arch name), not the legacy
 // paperComponentName (RCTSwitch, …).
 import { buildDescriptors, makeDescriptorFor } from './shared.js';

package/build/component-names/index.js

@@ -1,5 +1,5 @@
 // Base / default component-name table: re-exports the iOS table. Metro overrides this
 // with component-names.ios.ts / component-names.android.ts on a real host; under tsx /
 // tsc / web (no Metro) the host config resolves here. Filename is the selector, no
-// Platform.OS read. See ADR 0020.
+// Platform.OS read.
 export * from './index.ios.js';

package/build/component-names/shared.js

@@ -1,6 +1,6 @@
 // The intrinsic JSX types symbiote's host config maps to Fabric components, plus the
 // machinery to turn a platform name table into the descriptors the host config reads.
-// Per ADR 0020 the Fabric NAME of a primitive is platform-specific (iOS 'Switch' vs
+// The Fabric NAME of a primitive is platform-specific (iOS 'Switch' vs
 // Android 'AndroidSwitch'), so the name tables live in component-names.ios.ts /
 // .android.ts and the filename selects, no Platform.OS read. The isText flag is
 // platform-invariant, so it lives here once and both tables share it.

package/build/descriptor.js

@@ -3,12 +3,10 @@
 // element (`descriptorToReact` → React.createElement, `descriptorToVue` → h()). The
 // adapter's host element then flows on through its reconciler → engine → Fabric.
 //
-// The wolf-tui twin is `internal/shared/src/wnode/types.ts` (`WNode` + `wbox`/`wtext`).
-// We diverge in one way: `type` is an open host-component string, not a closed two-member
-// union, because symbiote paints one host element PER native component
-// (`symbiote-activity-indicator`, `symbiote-switch`, …), not just box/text.
+// `type` is an open host-component string, not a closed two-member union, because
+// symbiote paints one host element PER native component (`symbiote-activity-indicator`,
+// `symbiote-switch`, …), not just a generic box/text pair.
 // el(): a host element of any type. txt(): shorthand for the `symbiote-text` primitive.
-// Mirror wolf-tui's `wbox` / `wtext`.
 export function el(type, props = {}, children = [], key) {
     return { type, props, children, key };
 }

package/build/index.js

@@ -1,15 +1,15 @@
 // @symbiote-native/components: the framework-agnostic component layer. Pure state machines
 // (`state/`) and render functions (`view/`) that paint `Descriptor` trees; every adapter
 // wires state→render with ITS lifecycle (React hooks / Vue reactivity) and maps the
-// Descriptor onto its own element. See CLAUDE.md <components_split_logic_view_lifecycle>.
+// Descriptor onto its own element.
 export { el, txt } from './descriptor.js';
 // Accessibility folding: the web-alias (aria-*/role) → canonical accessibility* transform
-// and its types. Framework-agnostic (ADR 0024), so React, Vue, and the next adapter all fold
+// and its types. Framework-agnostic, so React, Vue, and the next adapter all fold
 // identically; moved here from @symbiote-native/react. RefreshControl/SafeAreaView/ScrollView consume it.
 export { resolveAccessibilityProps } from './accessibility-props.js';
 // Intrinsic (`symbiote-*`) → Fabric view-name resolution. Shared by every adapter so the
 // names CANNOT drift between them (one engine, one Fabric). The name tables are
-// Metro-split (.ios/.android, filename selects, no Platform.OS read, ADR 0020); the base
+// Metro-split (.ios/.android, filename selects, no Platform.OS read); the base
 // re-exports iOS for headless. descriptorFor is the per-platform-bound resolver.
 export { descriptorFor, COMPONENT_DESCRIPTORS } from './component-names/index.js';
 export { buildDescriptors, makeDescriptorFor } from './component-names/shared.js';
@@ -20,7 +20,7 @@ export { renderSwitch } from './view/render-switch.js';
 export { switchReducer, createInitialSwitchState, shouldSnapBack, valueFromChange, } from './state/switch.js';
 // ScrollView: pure render/command helpers (no state machine, no 3-layer split). The adapter
 // owns the refs/effects/element assembly and the sticky-header component; these supply the
-// platform-invariant math and plumbing every adapter shares (ADR 0024).
+// platform-invariant math and plumbing every adapter shares.
 export { resolveDecelerationRate, selectScrollIntrinsics, readLayoutDimension, didContentSizeChange, SCROLL_VIEW_BASE_HORIZONTAL, SCROLL_VIEW_BASE_VERTICAL, } from './view/render-scroll-view.js';
 export { buildScrollViewHandle, splitLayoutProps, attachStickyScroll, isSymbioteEvent, forwardScrollEvent, } from './scroll-view-commands.js';
 export { computeStickyInterpolation, nextStickyHeaderY, stickyDebounceMs, readLayoutNumber, STICKY_HEADER_Z_INDEX, } from './view/render-scroll-sticky.js';
@@ -57,7 +57,7 @@ export { renderTextInput } from './view/render-text-input.js';
 // VirtualizedList family: the framework-agnostic windowing engine + data shapes. Lists
 // have NO view/render-*.ts (the cell content is the framework's own children, so there is
 // no Descriptor render fn) — the shared layer for lists is this STATE/logic, reused
-// verbatim by React and Vue. See core/components/.docs-note-lists.md.
+// verbatim by React and Vue.
 export { DEFAULT_WINDOW_SIZE, DEFAULT_INITIAL_NUM_TO_RENDER, DEFAULT_END_REACHED_THRESHOLD, DEFAULT_MAX_TO_RENDER_PER_BATCH, DEFAULT_UPDATE_CELLS_BATCHING_PERIOD, DEFAULT_VIEW_AREA_COVERAGE_PERCENT_THRESHOLD, DEFAULT_START_REACHED_THRESHOLD, FIRST_INDEX, EMPTY_OFFSET, NO_INDEX, NO_CONTENT_LENGTH_SENT, INVERTED_Y_STYLE, INVERTED_X_STYLE, readScrollOffset, readLayoutLength, buildOffsets, computeWindow, throttleWindow, visiblePercent, isCellViewable, offsetForIndex, averageMeasuredLength, highestMeasuredIndex, computeEndReached, computeStartReached, buildViewabilityPairs, computeViewableSet, diffViewable, maxMinimumViewTime, buildListPlan, } from './state/virtualized-list.js';
 export { SINGLE_COLUMN, chunkIntoRows, rowKeyExtractor, expandRowToken, expandRowViewability, lastItemOfRow, firstItemOfRow, } from './state/flat-list.js';
 export { flattenSections, unwrapEntryItem, sectionEntryKey, scrollLocationToFlatIndex, } from './state/section-list.js';

package/build/state/virtualized-list.js

@@ -1,9 +1,9 @@
 // VirtualizedList logic: the framework-agnostic windowing engine. Every adapter
 // (React hooks, Vue reactivity) drives the SAME math from here, so a windowing /
-// viewability / edge-reached bug is fixed once for all adapters
-// (<adapters_reach_full_feature_parity>). The adapter supplies only its lifecycle
-// (refs/state/effects), the imperative handle wiring, and the per-cell element
-// creation (createElement / h) — never the geometry.
+// viewability / edge-reached bug is fixed once for all adapters. The adapter
+// supplies only its lifecycle (refs/state/effects), the imperative handle
+// wiring, and the per-cell element creation (createElement / h) — never the
+// geometry.
 //
 // What lives here:
 //   - the RN-matching defaults + sentinels,
@@ -18,7 +18,7 @@
 // What stays in the adapter (genuinely framework-bound): the cell CONTENT is the
 // framework's own children (renderItem -> ReactNode / VNode), so there is no
 // Descriptor render fn for a list — the shared layer for lists is this STATE/logic
-// module, not a view/render-*.ts. See core/components/.docs-note-lists.md.
+// module, not a view/render-*.ts.
 // Defaults match RN. windowSize is measured in viewport-lengths (21 => ten screens
 // of buffer on each side of the visible region). onEndReachedThreshold is a multiple
 // of the visible length (RN's onEndReachedThresholdOrDefault returns `?? 2`).

package/build/view/render-activity-indicator.js

@@ -3,7 +3,7 @@
 // enum AND a fixed box style; a numeric size never reaches native (it sizes the spinner
 // via style only). That translation is platform-invariant and lives here.
 //
-// What IS platform-specific (ADR 0020, prop-level): Android's AndroidProgressBar needs
+// What IS platform-specific: Android's AndroidProgressBar needs
 // `styleAttr` (which triggers its setStyle(), without it the view throws "setStyle() not
 // called") plus `indeterminate: true`, and its default color is the theme (null), whereas
 // iOS's ActivityIndicatorView takes neither and defaults to GRAY. The adapter's per-host

package/build/view/render-image.js

@@ -109,10 +109,9 @@ function readSourceUri(source) {
     return undefined;
 }
 // The iOS native module name RN registers this under (NativeImageLoaderIOS.js
-// resolves `TurboModuleRegistry.getEnforcing<Spec>('ImageLoader')`). Per the
-// symbiote invariant, a module name is only provable on a real host (a headless
-// fake answers to any name); this iOS name is device-verify-pending. See
-// .docs/native-module-platform-routing.md.
+// resolves `TurboModuleRegistry.getEnforcing<Spec>('ImageLoader')`). A module
+// name like this is only provable on a real host — a headless fake answers to
+// any name — so this iOS name is device-verify-pending.
 const IMAGE_LOADER_MODULE = 'ImageLoader';
 let imageLoaderModule;
 function getImageLoader() {

package/build/view/render-scroll-view.js

@@ -3,7 +3,7 @@
 // decelerationRate, picking the per-axis intrinsics/base style, reading layout dimensions, and
 // the content-size dedupe are all platform- and framework-invariant, so they live here. The
 // adapter owns the lifecycle (refs/state/effects) and the element assembly; it calls these pure
-// helpers from prepareScrollView. What diverges per platform (ADR 0020), how a RefreshControl
+// helpers from prepareScrollView. What diverges per platform, and how a RefreshControl
 // integrates, stays in the adapter's .ios/.android files.
 import { Platform } from '@symbiote-native/engine';
 // Pull a numeric field out of an onLayout event's nativeEvent.layout without a cast:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/components",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Framework-agnostic component logic (state machines + render functions) for SymbioteNative — written once, inherited by every adapter (React, Vue, Angular, ...).",
   "repository": {
     "type": "git",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@symbiote-native/engine": "0.1.2"
+    "@symbiote-native/engine": "0.1.3"
   },
   "peerDependencies": {
     "react-native": ">=0.86"