@symbiote-native/solid 3.1.0 → 3.2.0

package/build/components/checkbox-props.d.ts

@@ -0,0 +1,6 @@
+import type { IClassNameValue } from '@symbiote-native/engine';
+import type { ICheckboxProps as ICheckboxBaseProps } from '@symbiote-native/components';
+import type { IViewProps } from './view-props';
+export type ICheckboxProps = ICheckboxBaseProps & Omit<IViewProps, keyof ICheckboxBaseProps | 'children' | 'ref'> & {
+    class?: IClassNameValue;
+};

package/build/components/checkbox-props.js

@@ -0,0 +1 @@
+export {};

package/build/components.d.ts

@@ -29,5 +29,6 @@ export { TouchableNativeFeedback } from '@symbiote-native/components';
 export type { INativeFeedbackBackground, IThemeAttrBackground, IRippleBackground, } from '@symbiote-native/components';
 export type { ITouchableNativeFeedbackProps } from './components/touchable-native-feedback/touchable-native-feedback-props';
 export type { IButtonProps } from './components/button-props';
+export type { ICheckboxProps } from './components/checkbox-props';
 export type { IImageBackgroundProps } from './components/image-background-props';
 export type { IInputAccessoryViewProps } from './components/input-accessory-view-props';

package/build/define-descriptor-component.d.ts

@@ -0,0 +1,6 @@
+import type { JSX } from 'solid-js';
+import type { IDescriptor } from '@symbiote-native/components';
+import type { ISymbioteNode } from '@symbiote-native/engine';
+export declare function defineDescriptorComponent<P extends {
+    children?: JSX.Element;
+}>(render: (props: object) => IDescriptor): (props: P) => ISymbioteNode;

package/build/define-descriptor-component.js

@@ -0,0 +1,10 @@
+import { splitProps } from 'solid-js';
+import { descriptorToSolid } from './descriptor-to-solid.js';
+// A component whose host is one shared render function: children are the caller's own and go
+// inside the host, every other prop reaches the render function
+export function defineDescriptorComponent(render) {
+    return props => {
+        const [, rest] = splitProps(props, ['children']);
+        return descriptorToSolid(() => render({ ...rest }), () => props.children);
+    };
+}

package/build/define-optional-descriptor-component.d.ts

@@ -0,0 +1,3 @@
+import type { IDescriptor } from '@symbiote-native/components';
+import type { ISymbioteNode } from '@symbiote-native/engine';
+export declare function defineOptionalDescriptorComponent<P extends object>(render: (props: object) => IDescriptor | null): (props: P) => ISymbioteNode | null;

package/build/define-optional-descriptor-component.js

@@ -0,0 +1,12 @@
+import { descriptorToSolid } from './descriptor-to-solid.js';
+// A childless component whose render function may answer `null`, for a native view that exists
+// on one platform only. The answer is decided once at mount: the bridge builds the node once
+// and then only diffs prop values, so the descriptor's shape must not change afterwards
+export function defineOptionalDescriptorComponent(render) {
+    return props => {
+        const initial = render({ ...props });
+        if (!initial)
+            return null;
+        return descriptorToSolid(() => render({ ...props }) ?? initial);
+    };
+}

package/build/descriptor-to-solid.d.ts

@@ -1,3 +1,4 @@
+import { type JSX } from 'solid-js';
 import { type ISymbioteNode } from '@symbiote-native/engine';
 import type { IDescriptor } from '@symbiote-native/components';
-export declare function descriptorToSolid(descriptor: () => IDescriptor): ISymbioteNode;
+export declare function descriptorToSolid(descriptor: () => IDescriptor, children?: () => JSX.Element): ISymbioteNode;

package/build/descriptor-to-solid.js

@@ -23,7 +23,7 @@
 import { createMemo, createRenderEffect } from 'solid-js';
 import { isSymbioteNode } from '@symbiote-native/engine';
 import { createDescriptorShapeGuard } from '@symbiote-native/components';
-import { createElement, createTextNode, insertNode, replaceText, spread, } from './renderer.js';
+import { createElement, createTextNode, insert, insertNode, replaceText, spread, } from './renderer.js';
 // The vanished-key widening the render effect below stands on. Shared with the host primitives
 // (components/view, components/text), which fold their props through the same two-branch
 // resolveAccessibilityProps — see that module's header.
@@ -86,6 +86,10 @@ function mountChildren(parent, children) {
 }
 // The memo is what keeps the render fn running ONCE per change no matter how many accessors read
 // it — the root's props, every child's props, every text child all derive from the same call.
-export function descriptorToSolid(descriptor) {
-    return buildNode(createMemo(descriptor));
+// `children` is a component's own slot, inserted after the descriptor's children
+export function descriptorToSolid(descriptor, children) {
+    const root = buildNode(createMemo(descriptor));
+    if (children)
+        insert(root, children);
+    return root;
 }

package/build/index.d.ts

@@ -6,6 +6,8 @@ export * from './components';
 export type { IAccessibilityProps, IAriaProps, IAccessibilityRole, IRole, IAccessibilityStateValue, IAccessibilityValue, IAccessibilityActionInfo, IResponderProps, IImageSource, IImageSourceProp, IResizeMode, IImageSize, IImageCacheStatus, IEnterKeyHint, IInputMode, ISubmitBehavior, } from '@symbiote-native/components';
 export { setImageSourceResolver } from '@symbiote-native/components';
 export { descriptorToSolid } from './descriptor-to-solid';
+export { defineDescriptorComponent } from './define-descriptor-component';
+export { defineOptionalDescriptorComponent } from './define-optional-descriptor-component';
 export { AppRegistry, setHostRegistrar } from './modules/app-registry';
 export type { IComponentProvider, IWrapperComponentProvider, IAppParameters, IRunnable, IHostRegistrar, IRegistry, IHeadlessTask, ITaskProvider, ITaskCanceller, ITaskCancelProvider, } from './modules/app-registry';
 export { StatusBar } from './modules/status-bar';
@@ -19,7 +21,9 @@ export { createColorScheme } from './primitives/create-color-scheme';
 export { createWindowDimensions } from './primitives/create-window-dimensions';
 export { createPermissionHook } from './primitives/create-permission-hook';
 export { createResourceHook } from './primitives/create-resource-hook';
+export { defineNativeViewComponent } from './primitives/define-native-view-component';
 export { createEventValueHook } from './primitives/create-event-value-hook';
+export { useEvent, useEventListener } from './primitives/use-event';
 export { Animated, createAnimatedComponent } from './modules/animated';
 export type { IAnimatedComponentProps } from './modules/animated';
 export { Platform, StyleSheet, PixelRatio, PlatformColor, DynamicColorIOS, processColor, } from '@symbiote-native/engine';

package/build/index.js

@@ -33,6 +33,8 @@ export { setImageSourceResolver } from '@symbiote-native/components';
 // the same reason React exports descriptorToReact — an external wrapper package over a third-party
 // native view maps its shared render fn's Descriptor through the SAME bridge the adapter uses.
 export { descriptorToSolid } from './descriptor-to-solid.js';
+export { defineDescriptorComponent } from './define-descriptor-component.js';
+export { defineOptionalDescriptorComponent } from './define-optional-descriptor-component.js';
 // Safe in the barrel (unlike ./bootstrap, which imports react-native): the registry seam itself
 // only reaches the engine and solid-js.
 export { AppRegistry, setHostRegistrar } from './modules/app-registry/index.js';
@@ -64,7 +66,9 @@ export { createColorScheme } from './primitives/create-color-scheme.js';
 export { createWindowDimensions } from './primitives/create-window-dimensions.js';
 export { createPermissionHook } from './primitives/create-permission-hook.js';
 export { createResourceHook } from './primitives/create-resource-hook.js';
+export { defineNativeViewComponent } from './primitives/define-native-view-component.js';
 export { createEventValueHook } from './primitives/create-event-value-hook.js';
+export { useEvent, useEventListener } from './primitives/use-event.js';
 export { Animated, createAnimatedComponent } from './modules/animated/index.js';
 // Everything below is re-exported VERBATIM from the shared packages — no Solid half exists or is
 // wanted, so a passthrough stub file would only add a hop (.claude/rules/barrel-passthrough.md).

package/build/jsx-runtime.d.ts

@@ -4,6 +4,7 @@ import type { IViewProps } from './components/view-props';
 import type { ITextProps } from './components/text-props';
 import type { IPressableProps } from './components/pressable-props';
 import type { IButtonProps } from './components/button-props';
+import type { ICheckboxProps } from './components/checkbox-props';
 import type { IImageProps } from './components/image-props';
 import type { IImageBackgroundProps } from './components/image-background-props';
 import type { IInputAccessoryViewProps } from './components/input-accessory-view-props';
@@ -26,6 +27,7 @@ interface ICrossedPrimitiveProps {
     text: ITextProps;
     pressable: IPressableProps;
     button: IButtonProps;
+    checkbox: ICheckboxProps;
     image: IImageProps;
     'image-background': IImageBackgroundProps;
     'input-accessory-view': IInputAccessoryViewProps;

package/build/primitives/define-native-view-component.d.ts

@@ -0,0 +1,5 @@
+import type { ICreateNativeViewController } from '@symbiote-native/components';
+import type { ISymbioteNode } from '@symbiote-native/engine';
+export declare function defineNativeViewComponent<THandle, TProps extends object>(createController: ICreateNativeViewController<THandle>): (props: TProps & {
+    ref?: (handle: THandle) => void;
+}) => ISymbioteNode | null;

package/build/primitives/define-native-view-component.js

@@ -0,0 +1,22 @@
+import { onCleanup, splitProps } from 'solid-js';
+import { createHostNodeHolder } from '@symbiote-native/components';
+import { descriptorToSolid } from '../descriptor-to-solid.js';
+// A Solid component over a package's native view: the props go to the controller, its handle goes
+// to `ref`. The shape of the descriptor is decided once at mount, only values change afterwards
+export function defineNativeViewComponent(createController) {
+    return (props) => {
+        const [own, viewProps] = splitProps(props, ['ref']);
+        const host = createHostNodeHolder();
+        const controller = createController(host.getNode);
+        onCleanup(() => controller.dispose?.());
+        const render = () => {
+            const descriptor = controller.render({ ...viewProps });
+            return descriptor && host.capture(descriptor);
+        };
+        const initial = render();
+        if (!initial)
+            return null;
+        own.ref?.(controller.handle);
+        return descriptorToSolid(() => render() ?? initial);
+    };
+}

package/build/primitives/use-event.d.ts

@@ -0,0 +1,6 @@
+import type { Accessor } from 'solid-js';
+import type { IEventEmitterOf, IEventName, IEventPayload, IEventsMap } from '@symbiote-native/engine';
+/** Calls the listener for each event, the latest one, and stops when the owner is disposed */
+export declare function useEventListener<TEventsMap extends IEventsMap, TName extends IEventName<TEventsMap>>(emitter: Accessor<IEventEmitterOf<TEventsMap>>, eventName: Accessor<TName>, listener: Accessor<TEventsMap[TName]>): void;
+/** The payload of the last event, `initialValue` (or `null`) until the first one */
+export declare function useEvent<TEventsMap extends IEventsMap, TName extends IEventName<TEventsMap>>(emitter: Accessor<IEventEmitterOf<TEventsMap>>, eventName: Accessor<TName>, initialValue?: IEventPayload<TEventsMap, TName> | null): Accessor<IEventPayload<TEventsMap, TName> | null>;

package/build/primitives/use-event.js

@@ -0,0 +1,18 @@
+// Solid twins of `useEvent` and `useEventListener` of the `expo` package, for any emitter
+import { createEffect, createSignal, on, onCleanup } from 'solid-js';
+import { bindEventListener } from '@symbiote-native/engine';
+/** Calls the listener for each event, the latest one, and stops when the owner is disposed */
+export function useEventListener(emitter, eventName, listener) {
+    createEffect(on([emitter, eventName], ([source, name]) => {
+        // The listener is read at each event, a new one is not a new subscription
+        onCleanup(bindEventListener(source, name, listener));
+    }));
+}
+/** The payload of the last event, `initialValue` (or `null`) until the first one */
+export function useEvent(emitter, eventName, initialValue = null) {
+    const [event, setEvent] = createSignal(initialValue);
+    createEffect(on([emitter, eventName], ([source, name]) => {
+        onCleanup(bindEventListener(source, name, () => (next) => setEvent(() => next)));
+    }));
+    return event;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/solid",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "SymbioteNative's Solid adapter — a solid-js/universal createRenderer driving real native iOS/Android views through the same engine as every other adapter.",
   "keywords": [
     "react-native",
@@ -62,19 +62,19 @@
   "dependencies": {
     "babel-preset-solid": "^1.9.12",
     "typescript": "~6.0.0",
-    "@symbiote-native/components": "3.1.4",
-    "@symbiote-native/css-parser": "0.5.3"
+    "@symbiote-native/components": "3.2.0",
+    "@symbiote-native/css-parser": "0.5.4"
   },
   "peerDependencies": {
     "solid-js": ">=1.9.0",
     "react-native": ">=0.86",
-    "@symbiote-native/engine": "^1.5.0"
+    "@symbiote-native/engine": "^1.6.0"
   },
   "devDependencies": {
     "@babel/core": "^7.25.2",
     "solid-js": "^1.9.14",
-    "@symbiote-native/engine": "1.5.0",
-    "@symbiote-native/test-utils": "0.4.6"
+    "@symbiote-native/engine": "1.6.0",
+    "@symbiote-native/test-utils": "0.4.7"
   },
   "scripts": {
     "typecheck": "tsc --build",