reactjs-signal 2.0.1 → 2.0.3

package/dist/index.d.ts

@@ -137,14 +137,36 @@ declare function useSetSignal<T>(alienSignal: TWritableSignal<T>): (val: T | ((o
 declare function useSignalEffect(fn: () => void): void;
 /**
  * React hook to initialize a signal with a value when hydrating from server.
- * @param alienSignal
- * @param value
- * @returns
+ *
+ * @example
+ * ```typescript
+ * const countSignal = createSignal(0);
+ * useHydrateSignal(countSignal, 10);
+ * ```
  *
  * @template T - The type of the signal value.
  * @param {TWritableSignal<T>} alienSignal - The signal to hydrate.
  * @param {T} value - The value to hydrate the signal with.
  */
 declare function useHydrateSignal<T>(alienSignal: TWritableSignal<T>, value: T): void;
+/**
+ * Utility function to get the current value and setter of an Alien Signal.
+ *
+ * @example
+ * ```typescript
+ * const countSignal = createSignal(0);
+ * const { value, setValue } = getSignal(countSignal);
+ * console.log(value()); // current value
+ * setValue(10); // set value to 10
+ * ```
+ *
+ * @template T - The type of the signal value.
+ * @param {TWritableSignal<T>} alienSignal - The signal to read/write.
+ * @returns {{ value: () => T; setValue: (val: T | ((oldVal: T) => T)) => void }} An object with `value` and `setValue`.
+ */
+declare function getSignal<T>(alienSignal: TWritableSignal<T>): {
+    value: () => T;
+    setValue: (val: T | ((oldVal: T) => T)) => void;
+};
 
-export { type TWritableSignal, createComputed, createEffect, createSignal, createSignalStorage, useHydrateSignal, useSetSignal, useSignal, useSignalEffect, useSignalValue };
+export { type TWritableSignal, createComputed, createEffect, createSignal, createSignalStorage, getSignal, useHydrateSignal, useSetSignal, useSignal, useSignalEffect, useSignalValue };

package/dist/index.js

@@ -1 +1 @@
-import {useSyncExternalStore,useEffect}from'react';import {signal,computed,effect}from'alien-signals';var a=new WeakMap;function l(t){let e=a.get(t);return e||(e=new WeakSet,a.set(t,e)),e}function d(t){return signal(t)}function y(t,e){let o=localStorage.getItem(t),r;if(o)try{r=JSON.parse(o);}catch(c){console.error(`Error parsing localStorage for key "${t}", using initial value.`,c),r=e;}else r=e;let n=d(r);return p(()=>{localStorage.setItem(t,JSON.stringify(n()));}),n}function W(t){return computed(t)}function p(t){return effect(t)}function x(t){return [useSyncExternalStore(r=>{let n=effect(()=>{t(),r();});return ()=>n()},()=>t(),()=>t()),r=>{t(typeof r=="function"?r(t()):r);}]}function b(t){return useSyncExternalStore(e=>{let o=effect(()=>{t(),e();});return ()=>o()},()=>t(),()=>t())}function m(t){return e=>{t(typeof e=="function"?e(t()):e);}}function v(t){useEffect(()=>{let e=effect(t);return ()=>e()},[]);}function V(t,e){let o=l(t);o.has(t)||(o.add(t),t(e));}export{W as createComputed,p as createEffect,d as createSignal,y as createSignalStorage,V as useHydrateSignal,m as useSetSignal,x as useSignal,v as useSignalEffect,b as useSignalValue};
+import {useSyncExternalStore,useEffect}from'react';import {signal,computed,effect}from'alien-signals';var a=new WeakMap;function l(t){let e=a.get(t);return e||(e=new WeakSet,a.set(t,e)),e}function d(t){return signal(t)}function y(t,e){let r=localStorage.getItem(t),o;if(r)try{o=JSON.parse(r);}catch(c){console.error(`Error parsing localStorage for key "${t}", using initial value.`,c),o=e;}else o=e;let T=d(o);return p(()=>{localStorage.setItem(t,JSON.stringify(T()));}),T}function W(t){return computed(t)}function p(t){return effect(t)}function x(t){return [useSyncExternalStore(o=>{let T=effect(()=>{t(),o();});return ()=>T()},()=>t(),()=>t()),o=>{t(typeof o=="function"?o(t()):o);}]}function V(t){return useSyncExternalStore(e=>{let r=effect(()=>{t(),e();});return ()=>r()},()=>t(),()=>t())}function b(t){return e=>{t(typeof e=="function"?e(t()):e);}}function m(t){useEffect(()=>{let e=effect(t);return ()=>e()},[]);}function v(t,e){let r=l(t);r.has(t)||(r.add(t),t(e));}function h(t){return {value:()=>t(),setValue:r=>{t(typeof r=="function"?r(t()):r);}}}export{W as createComputed,p as createEffect,d as createSignal,y as createSignalStorage,h as getSignal,v as useHydrateSignal,b as useSetSignal,x as useSignal,m as useSignalEffect,V as useSignalValue};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "reactjs-signal",
   "type": "module",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "",
   "author": "",
   "license": "ISC",
@@ -30,20 +30,20 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
   "dependencies": {
-    "alien-signals": "^2.0.1"
+    "alien-signals": "^3.1.2"
   },
   "peerDependencies": {
-    "alien-signals": ">=2.0.1",
+    "alien-signals": ">=3.1.2",
     "react": ">=18"
   },
   "devDependencies": {
     "@types/react": "^19.0.2",
     "tsup": "^8.0.1",
     "typescript": "^5.3.3"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch"
   }
-}
+}