@symbiote-native/vue 3.1.0 → 3.2.0

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

@@ -0,0 +1,3 @@
+import { type ShallowRef } from '@vue/runtime-core';
+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): (getSource: () => TSource) => ShallowRef<TValue>;

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

@@ -0,0 +1,16 @@
+// Every `useXStatus`-style composable (`useAudioPlayerStatus`, `useAudioPlaylistStatus`, ...)
+// binds this to its own event name + initial-value getter instead of repeating the watch wiring
+import { shallowRef, watch } from '@vue/runtime-core';
+export function createEventValueHook(event, getValue) {
+    return function useEventValue(getSource) {
+        const value = shallowRef(getValue(getSource()));
+        watch(getSource, (source, _previous, onCleanup) => {
+            value.value = getValue(source);
+            const subscription = source.addListener(event, next => {
+                value.value = next;
+            });
+            onCleanup(() => subscription.remove());
+        }, { immediate: true });
+        return value;
+    };
+}

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

@@ -0,0 +1,3 @@
+import { type Ref } from '@vue/runtime-core';
+import { type IPermissionHookBehavior, type IPermissionHookMethods } from '@symbiote-native/engine';
+export declare function createPermissionHook<TPermission, TOptions extends object>(methods: IPermissionHookMethods<TPermission, TOptions>): (behavior?: IPermissionHookBehavior, methodOptions?: TOptions) => [Ref<TPermission | null>, () => Promise<TPermission>, () => Promise<TPermission>];

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

@@ -0,0 +1,22 @@
+// Every Expo-wrapper package's own permission composable (`useCameraPermissions`,
+// `useCalendarPermissions`, `useRemindersPermissions`, ...) binds this factory to its `methods`
+import { onMounted, shallowRef } from '@vue/runtime-core';
+import { createPermissionApi, fetchInitialPermission, } from '@symbiote-native/engine';
+export function createPermissionHook(methods) {
+    return function usePermission(behavior, methodOptions) {
+        const status = shallowRef(null);
+        const api = createPermissionApi(methods, value => {
+            status.value = value;
+        });
+        onMounted(() => {
+            fetchInitialPermission(methods, behavior, methodOptions, response => {
+                status.value = response;
+            });
+        });
+        return [
+            status,
+            () => api.request(methodOptions),
+            () => api.get(methodOptions),
+        ];
+    };
+}

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

@@ -0,0 +1,7 @@
+import { type ComputedRef } from '@vue/runtime-core';
+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>): (getArgs: () => TArgs) => ComputedRef<TResource>;

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

@@ -0,0 +1,14 @@
+// Every `useReleasingSharedObject`-style composable (`useAudioPlayer`, `useImageManipulator`, ...)
+// binds this to its own `createXController()` instead of repeating the computed/watch wiring
+import { computed, onUnmounted, watch, } from '@vue/runtime-core';
+export function createResourceHook(createController) {
+    return function useResource(getArgs) {
+        const controller = createController();
+        const resource = computed(() => controller.resolve(...getArgs()));
+        watch(resource, () => {
+            controller.flushDispose();
+        });
+        onUnmounted(() => controller.dispose());
+        return resource;
+    };
+}

package/build/index.d.ts

@@ -54,6 +54,9 @@ export { AppRegistry, setHostRegistrar } from './modules/app-registry';
 export type { IComponentProvider, IAppParameters, IRunnable, IHostRegistrar, IWrapperComponentProvider, IRegistry, IHeadlessTask, ITaskProvider, ITaskCanceller, ITaskCancelProvider, } from './modules/app-registry';
 export { useColorScheme } from './composables/use-color-scheme';
 export { useWindowDimensions } from './composables/use-window-dimensions';
+export { createPermissionHook } from './composables/create-permission-hook';
+export { createResourceHook } from './composables/create-resource-hook';
+export { createEventValueHook } from './composables/create-event-value-hook';
 export { Alert, Share, ActionSheetIOS, Linking, Vibration, ToastAndroid, Settings, I18nManager, Dimensions, Appearance, AppState, Keyboard, KEYBOARD_EVENT, BackHandler, PermissionsAndroid, PERMISSIONS, RESULTS, AccessibilityInfo, LayoutAnimation, } from '@symbiote-native/engine';
 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, IAccessibilityChangeEvent, IAccessibilityChangeEventName, IAccessibilityChangeEventHandler, IAccessibilityAnnouncementFinishedEvent, IAnnounceForAccessibilityOptions, IAccessibilityEventType, ILayoutAnimationType, ILayoutAnimationProperty, ILayoutAnimationConfig, ILayoutAnimationAnim, } from '@symbiote-native/engine';
 export { Platform, StyleSheet, processColor, setColorProcessor, dlog, isDebug, } from '@symbiote-native/engine';

package/build/index.js

@@ -73,6 +73,9 @@ export { AppRegistry, setHostRegistrar } from './modules/app-registry/index.js';
 // Vue composables over the core device-state modules.
 export { useColorScheme } from './composables/use-color-scheme.js';
 export { useWindowDimensions } from './composables/use-window-dimensions.js';
+export { createPermissionHook } from './composables/create-permission-hook.js';
+export { createResourceHook } from './composables/create-resource-hook.js';
+export { createEventValueHook } from './composables/create-event-value-hook.js';
 // Imperative runtime modules: the SAME module both adapters share, re-exported from @symbiote-native/engine.
 export { Alert, Share, ActionSheetIOS, Linking, Vibration, ToastAndroid, Settings, I18nManager, Dimensions, Appearance, AppState, Keyboard, KEYBOARD_EVENT, BackHandler, PermissionsAndroid, PERMISSIONS, RESULTS, AccessibilityInfo, LayoutAnimation, } from '@symbiote-native/engine';
 // Re-export the framework-agnostic engine surface (pure utilities + diagnostics).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/vue",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "SymbioteNative's Vue adapter — a @vue/runtime-core createRenderer driving real native iOS/Android views through the same engine as the React adapter.",
   "license": "MIT",
   "repository": {
@@ -70,18 +70,18 @@
     "@vue/compiler-sfc": "^3.5.13",
     "@vue/runtime-core": "^3.5.13",
     "typescript": "~6.0.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": {
     "vue": ">=3.5.0",
     "react-native": ">=0.86",
-    "@symbiote-native/engine": "^1.4.0"
+    "@symbiote-native/engine": "^1.5.0"
   },
   "devDependencies": {
     "@babel/core": "^7.25.2",
-    "@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",