@symbiote-native/react 3.1.0 → 3.2.0

package/build/hooks/create-event-value-hook.d.ts

@@ -0,0 +1,2 @@
+import type { IEventValueSource } from '@symbiote-native/engine';
+export declare function createEventValueHook<TSource extends IEventValueSource<TValue, TEvent>, TValue, TEvent extends string = string>(event: TEvent, getValue: (source: TSource) => TValue): (source: TSource) => TValue;

package/build/hooks/create-event-value-hook.js

@@ -0,0 +1,14 @@
+// Every `useXStatus`-style hook (`useAudioPlayerStatus`, `useAudioPlaylistStatus`, ...) binds
+// this to its own event name + initial-value getter instead of repeating the subscribe wiring
+import { useEffect, useState } from 'react';
+export function createEventValueHook(event, getValue) {
+    return function useEventValue(source) {
+        const [value, setValue] = useState(() => getValue(source));
+        useEffect(() => {
+            setValue(getValue(source));
+            const subscription = source.addListener(event, setValue);
+            return () => subscription.remove();
+        }, [source]);
+        return value;
+    };
+}

package/build/hooks/create-permission-hook.d.ts

@@ -0,0 +1,2 @@
+import { type IPermissionHookBehavior, type IPermissionHookMethods, type IPermissionHookResult } from '@symbiote-native/engine';
+export declare function createPermissionHook<TPermission, TOptions extends object>(methods: IPermissionHookMethods<TPermission, TOptions>): (behavior?: IPermissionHookBehavior, methodOptions?: TOptions) => IPermissionHookResult<TPermission>;

package/build/hooks/create-permission-hook.js

@@ -0,0 +1,34 @@
+// Every Expo-wrapper package's own permission hook (`useCameraPermissions`,
+// `useCalendarPermissions`, `useRemindersPermissions`, ...) binds this factory to its `methods`
+import { useEffect, useRef, useState } from 'react';
+import { createPermissionApi, fetchInitialPermission, } from '@symbiote-native/engine';
+export function createPermissionHook(methods) {
+    return function usePermission(behavior, methodOptions) {
+        const [status, setStatus] = useState(null);
+        const isMountedRef = useRef(true);
+        const get = behavior?.get ?? true;
+        const request = behavior?.request ?? false;
+        const apiRef = useRef(createPermissionApi(methods, value => {
+            if (isMountedRef.current)
+                setStatus(value);
+        }));
+        useEffect(() => {
+            isMountedRef.current = true;
+            return () => {
+                isMountedRef.current = false;
+            };
+        }, []);
+        useEffect(() => {
+            fetchInitialPermission(methods, { get, request }, methodOptions, response => {
+                if (isMountedRef.current)
+                    setStatus(response);
+            });
+            // eslint-disable-next-line react-hooks/exhaustive-deps
+        }, [get, request]);
+        return [
+            status,
+            () => apiRef.current.request(methodOptions),
+            () => apiRef.current.get(methodOptions),
+        ];
+    };
+}

package/build/hooks/create-resource-hook.d.ts

@@ -0,0 +1,6 @@
+export type IResourceHookController<TArgs extends unknown[], TResource> = {
+    resolve: (...args: TArgs) => TResource;
+    flushDispose: () => void;
+    dispose: () => void;
+};
+export declare function createResourceHook<TArgs extends unknown[], TResource>(createController: () => IResourceHookController<TArgs, TResource>): (...args: TArgs) => TResource;

package/build/hooks/create-resource-hook.js

@@ -0,0 +1,18 @@
+// Every `useReleasingSharedObject`-style hook (`useAudioPlayer`, `useImageManipulator`, ...)
+// binds this to its own `createXController()` instead of repeating the ref/effect wiring
+import { useEffect, useRef } from 'react';
+export function createResourceHook(createController) {
+    return function useResource(...args) {
+        const controllerRef = useRef(null);
+        if (!controllerRef.current)
+            controllerRef.current = createController();
+        const resource = controllerRef.current.resolve(...args);
+        useEffect(() => {
+            controllerRef.current?.flushDispose();
+        }, [resource]);
+        useEffect(() => {
+            return () => controllerRef.current?.dispose();
+        }, []);
+        return resource;
+    };
+}

package/build/index.d.ts

@@ -56,6 +56,9 @@ export { Alert, Share, ActionSheetIOS, Linking, Vibration, ToastAndroid, Setting
 export type { IAlertType, IAlertButtonStyle, IAlertButton, IAlertButtons, IAlertOptions, IShareContent, IShareOptions, IShareAction, IActionSheetIOSOptions, IShareActionSheetIOSOptions, IShareActionSheetError, IUrlEvent, II18nManagerConstants, IDisplayMetrics, IDisplayMetricsAndroid, IDimensionsPayload, IDimensionsSet, IDimensionsKey, IDimensionsChangeListener, IDimensionsStatic, IColorSchemeName, IColorSchemePreference, IAppStateStatus, IAppStateEvent, IKeyboardEventName, IKeyboardEvent, IKeyboardMetrics, IBackPressEventName, IBackPressHandler, IPermission, IPermissionStatus, IRationale, ILayoutAnimationType, ILayoutAnimationProperty, ILayoutAnimationConfig, ILayoutAnimationAnim, IPixelRatioStatic, } from '@symbiote-native/engine';
 export { useWindowDimensions } from './hooks/use-window-dimensions';
 export { useColorScheme } from './hooks/use-color-scheme';
+export { createPermissionHook } from './hooks/create-permission-hook';
+export { createResourceHook } from './hooks/create-resource-hook';
+export { createEventValueHook } from './hooks/create-event-value-hook';
 export { AccessibilityInfo } from './modules/accessibility-info';
 export type { IAccessibilityChangeEvent, IAccessibilityChangeEventName, IAccessibilityChangeEventHandler, IAccessibilityAnnouncementFinishedEvent, IAnnounceForAccessibilityOptions, IAccessibilityEventType, } from './modules/accessibility-info';
 export { PanResponder } from '@symbiote-native/engine';

package/build/index.js

@@ -62,6 +62,9 @@ export { Alert, Share, ActionSheetIOS, Linking, Vibration, ToastAndroid, Setting
 // React lifecycle over those core device-state modules.
 export { useWindowDimensions } from './hooks/use-window-dimensions.js';
 export { useColorScheme } from './hooks/use-color-scheme.js';
+export { createPermissionHook } from './hooks/create-permission-hook.js';
+export { createResourceHook } from './hooks/create-resource-hook.js';
+export { createEventValueHook } from './hooks/create-event-value-hook.js';
 export { AccessibilityInfo } from './modules/accessibility-info';
 // Interaction subsystems: gestures, deferred work, and layout transitions.
 export { PanResponder } from '@symbiote-native/engine';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/react",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "SymbioteNative's React adapter — a react-reconciler host config (mutation mode) driving real native iOS/Android views through stock React Native Fabric.",
   "license": "MIT",
   "repository": {
@@ -57,21 +57,21 @@
   },
   "dependencies": {
     "react-reconciler": "^0.33.0",
-    "@symbiote-native/components": "3.1.3",
-    "@symbiote-native/css-parser": "0.5.2"
+    "@symbiote-native/components": "3.1.4",
+    "@symbiote-native/css-parser": "0.5.3"
   },
   "peerDependencies": {
     "react": ">=19.0.0",
     "react-native": ">=0.86",
-    "@symbiote-native/engine": "^1.4.0"
+    "@symbiote-native/engine": "^1.5.0"
   },
   "devDependencies": {
     "@types/node": "^26.0.0",
     "@types/react": "^19.2.0",
     "@types/react-reconciler": "^0.32.2",
     "react": "19.2.3",
-    "@symbiote-native/engine": "1.4.0",
-    "@symbiote-native/test-utils": "0.4.5"
+    "@symbiote-native/engine": "1.5.0",
+    "@symbiote-native/test-utils": "0.4.6"
   },
   "scripts": {
     "typecheck": "tsc --build",