@symbiote-native/svelte 3.0.5 → 3.1.0

package/build/host-props.d.ts

@@ -0,0 +1 @@
+export declare function hostProps(props: Record<string, unknown>): (node: unknown) => void;

package/build/host-props.js

@@ -0,0 +1,9 @@
+import { ShimElement } from './dom-shim/index.js';
+// A dynamic tag (`<svelte:element this={...}>`) sets `p` as a plain attribute, which never reaches
+// the engine, so the bag goes through an attachment that assigns the property on the raw element
+export function hostProps(props) {
+    return node => {
+        if (node instanceof ShimElement)
+            node.p = props;
+    };
+}

package/build/native-view-bridge.d.ts

@@ -2,3 +2,4 @@ export { mount, unmount } from './render';
 export { mountDescriptorChildren, createDescriptorChildrenSync, } from './descriptor-to-svelte';
 export type { IDescriptorChildrenMount } from './descriptor-to-svelte';
 export type { ShimElement } from './dom-shim';
+export { hostProps } from './host-props';

package/build/native-view-bridge.js

@@ -25,3 +25,4 @@
 // packages/slider/src/svelte/slider/index.svelte's header for the full reasoning.
 export { mount, unmount } from './render.js';
 export { mountDescriptorChildren, createDescriptorChildrenSync, } from './descriptor-to-svelte.js';
+export { hostProps } from './host-props.js';

package/build/runes/create-event-value-hook.svelte.d.ts

@@ -0,0 +1,8 @@
+export type IEventValueSource<TValue, TEvent extends string = string> = {
+    addListener: (event: TEvent, listener: (value: TValue) => void) => {
+        remove: () => void;
+    };
+};
+export declare function createEventValueHook<TSource extends IEventValueSource<TValue, TEvent>, TValue, TEvent extends string = string>(event: TEvent, getValue: (source: TSource) => TValue): (getSource: () => TSource) => {
+    readonly current: TValue;
+};

package/build/runes/create-event-value-hook.svelte.js

@@ -0,0 +1,20 @@
+// Svelte lifecycle for a value that follows a native event, boxed getter like
+// `use-color-scheme.svelte.ts`
+export function createEventValueHook(event, getValue) {
+    return function useEventValue(getSource) {
+        let value = $state(getValue(getSource()));
+        $effect(() => {
+            const source = getSource();
+            value = getValue(source);
+            const subscription = source.addListener(event, next => {
+                value = next;
+            });
+            return () => subscription.remove();
+        });
+        return {
+            get current() {
+                return value;
+            },
+        };
+    };
+}

package/build/runes/create-permission-hook.svelte.d.ts

@@ -0,0 +1,6 @@
+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) => {
+    readonly status: TPermission | null;
+    requestPermission: () => Promise<TPermission>;
+    getPermission: () => Promise<TPermission>;
+};

package/build/runes/create-permission-hook.svelte.js

@@ -0,0 +1,23 @@
+// Svelte lifecycle for the shared permission API, boxed getter because a bare `$state` can't cross
+// a module boundary. Packages reach it through the `@symbiote-native/svelte/runes/*` subpath
+import { createPermissionApi, fetchInitialPermission, } from '@symbiote-native/engine';
+export function createPermissionHook(methods) {
+    return function usePermission(behavior, methodOptions) {
+        let status = $state(null);
+        const api = createPermissionApi(methods, value => {
+            status = value;
+        });
+        $effect(() => {
+            fetchInitialPermission(methods, behavior, methodOptions, response => {
+                status = response;
+            });
+        });
+        return {
+            get status() {
+                return status;
+            },
+            requestPermission: () => api.request(methodOptions),
+            getPermission: () => api.get(methodOptions),
+        };
+    };
+}

package/build/runes/create-resource-hook.svelte.d.ts

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

package/build/runes/create-resource-hook.svelte.js

@@ -0,0 +1,19 @@
+// Svelte lifecycle for a disposable resource derived from reactive args, boxed getter as in
+// `use-color-scheme.svelte.ts`
+export function createResourceHook(createController) {
+    return function useResource(getArgs) {
+        const controller = createController();
+        const resource = $derived(controller.resolve(...getArgs()));
+        $effect(() => {
+            controller.flushDispose(resource);
+        });
+        $effect(() => {
+            return () => controller.dispose();
+        });
+        return {
+            get current() {
+                return resource;
+            },
+        };
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/svelte",
-  "version": "3.0.5",
+  "version": "3.1.0",
   "description": "SymbioteNative's Svelte adapter — a DOM shim over stock compiled Svelte output driving real native iOS/Android views through the same engine as every other adapter.",
   "keywords": [
     "react-native",
@@ -60,6 +60,18 @@
       "types": "./build/scope-token.d.ts",
       "default": "./build/scope-token.js"
     },
+    "./runes/create-permission-hook": {
+      "types": "./build/runes/create-permission-hook.svelte.d.ts",
+      "default": "./build/runes/create-permission-hook.svelte.js"
+    },
+    "./runes/create-resource-hook": {
+      "types": "./build/runes/create-resource-hook.svelte.d.ts",
+      "default": "./build/runes/create-resource-hook.svelte.js"
+    },
+    "./runes/create-event-value-hook": {
+      "types": "./build/runes/create-event-value-hook.svelte.d.ts",
+      "default": "./build/runes/create-event-value-hook.svelte.js"
+    },
     "./metro-svelte-transformer": "./metro-svelte-transformer.cjs",
     "./metro-css-parser": "./metro-css-parser.cjs"
   },
@@ -73,22 +85,22 @@
   },
   "dependencies": {
     "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": {
     "svelte": ">=5.56.0",
     "react-native": ">=0.86",
-    "@symbiote-native/engine": "^1.4.0"
+    "@symbiote-native/engine": "^1.5.0"
   },
   "devDependencies": {
     "@vue/runtime-core": "^3.5.13",
     "react": "19.2.3",
     "svelte": "^5.56.0",
-    "@symbiote-native/engine": "1.4.0",
-    "@symbiote-native/test-utils": "0.4.5",
-    "@symbiote-native/react": "3.1.0",
-    "@symbiote-native/vue": "3.1.0"
+    "@symbiote-native/engine": "1.5.0",
+    "@symbiote-native/react": "3.2.0",
+    "@symbiote-native/test-utils": "0.4.6",
+    "@symbiote-native/vue": "3.2.0"
   },
   "scripts": {
     "typecheck": "tsc --build",