@iadev93/zuno-react 0.0.7 → 0.0.9

package/README.md

@@ -1,8 +1,8 @@
 # @iadev93/zuno-react
 
-React adapter for **Zuno**.
+<p><b>Idiomatic React bindings for Zuno.</b></p>
 
-This package provides idiomatic React bindings using `useSyncExternalStore`.
+This package provides deep integration with React using `useSyncExternalStore` for performance and consistency.
 
 ---
 

package/dist/{bindReact.d.ts → index.d.mts}

@@ -1,4 +1,6 @@
-import { type ZunoSubscribableStore } from "@iadev93/zuno";
+import { ZunoSubscribableStore, CreateZunoOptions } from '@iadev93/zuno';
+export { ZunoReadable } from '@iadev93/zuno';
+
 /**
  * Type definition for an equality function.
  * It takes two values of the same type and returns true if they are considered equal, false otherwise.
@@ -34,8 +36,7 @@ type ZunoCore = {
     stop?: () => void;
 };
 /**
- * An extended interface for a Zuno store that includes methods for setting state
- * and a unique key identifier. This represents a store that has been "bound" or registered.
+ * An extended interface for a Zuno store that includes React-specific features.
  */
 type ReactBoundStore<T> = BoundStore<T> & {
     /**
@@ -47,13 +48,25 @@ type ReactBoundStore<T> = BoundStore<T> & {
 /**
  * Binds Zuno to React.
  * @param zuno The Zuno instance to bind.
- * @returns A React hook for accessing the store.
+ * @returns A React-enhanced Zuno instance.
+ */
+declare const bindReact: (zuno: ZunoCore) => {
+    store: <T>(storeKey: string, init: () => T) => ReactBoundStore<T>;
+    set<T>(storeKey: string, next: T | ((prev: T) => T), init?: () => T): Promise<any>;
+    get<T>(storeKey: string, init?: () => T): T;
+    stop?: () => void;
+};
+/**
+ * Creates a Zuno instance and returns a React-enhanced instance.
+ *
+ * @param opts The options for the Zuno instance.
+ * @returns An object with a `store` method that returns stores with a `use` hook.
  */
-export declare const bindReact: (zuno: ZunoCore) => {
+declare const createZunoReact: (opts: CreateZunoOptions) => {
     store: <T>(storeKey: string, init: () => T) => ReactBoundStore<T>;
     set<T>(storeKey: string, next: T | ((prev: T) => T), init?: () => T): Promise<any>;
     get<T>(storeKey: string, init?: () => T): T;
     stop?: () => void;
 };
-export {};
-//# sourceMappingURL=bindReact.d.ts.map
+
+export { type BoundStore, type EqualityFn, type ReactBoundStore, type Selector, type ZunoCore, bindReact, createZunoReact };

package/dist/index.d.ts

@@ -1,22 +1,24 @@
-import { type ZunoSubscribableStore, type CreateZunoOptions } from "@iadev93/zuno";
+import { ZunoSubscribableStore, CreateZunoOptions } from '@iadev93/zuno';
+export { ZunoReadable } from '@iadev93/zuno';
+
 /**
  * Type definition for an equality function.
  * It takes two values of the same type and returns true if they are considered equal, false otherwise.
  * Used to prevent unnecessary re-renders in React hooks when the selected state hasn't "meaningfully" changed.
  */
-export type EqualityFn<T> = (a: T, b: T) => boolean;
+type EqualityFn<T> = (a: T, b: T) => boolean;
 /**
  * Type definition for a selector function.
  * It takes the full state of a store and returns a selected portion of that state.
  * This allows components to subscribe only to the parts of the state they care about,
  * optimizing performance by avoiding re-renders for unrelated state changes.
  */
-export type Selector<TState, TSelected> = (state: TState) => TSelected;
+type Selector<TState, TSelected> = (state: TState) => TSelected;
 /**
  * An extended interface for a Zuno store that includes methods for setting state
  * and a unique key identifier. This represents a store that has been "bound" or registered.
  */
-export type BoundStore<T> = {
+type BoundStore<T> = {
     key: string;
     get: () => T;
     set: (next: T | ((prev: T) => T)) => Promise<any>;
@@ -27,7 +29,7 @@ export type BoundStore<T> = {
  * The core interface for the Zuno library, providing methods to create,
  * retrieve, and update stores.
  */
-export type ZunoCore = {
+type ZunoCore = {
     store<T>(storeKey: string, init: () => T): BoundStore<T>;
     set<T>(storeKey: string, next: T | ((prev: T) => T), init?: () => T): Promise<any>;
     get<T>(storeKey: string, init?: () => T): T;
@@ -36,7 +38,7 @@ export type ZunoCore = {
 /**
  * An extended interface for a Zuno store that includes React-specific features.
  */
-export type ReactBoundStore<T> = BoundStore<T> & {
+type ReactBoundStore<T> = BoundStore<T> & {
     /**
      * React hook for this store.
      * Optional selector + equality for derived values and avoiding rerenders.
@@ -48,7 +50,7 @@ export type ReactBoundStore<T> = BoundStore<T> & {
  * @param zuno The Zuno instance to bind.
  * @returns A React-enhanced Zuno instance.
  */
-export declare const bindReact: (zuno: ZunoCore) => {
+declare const bindReact: (zuno: ZunoCore) => {
     store: <T>(storeKey: string, init: () => T) => ReactBoundStore<T>;
     set<T>(storeKey: string, next: T | ((prev: T) => T), init?: () => T): Promise<any>;
     get<T>(storeKey: string, init?: () => T): T;
@@ -60,11 +62,11 @@ export declare const bindReact: (zuno: ZunoCore) => {
  * @param opts The options for the Zuno instance.
  * @returns An object with a `store` method that returns stores with a `use` hook.
  */
-export declare const createZunoReact: (opts: CreateZunoOptions) => {
+declare const createZunoReact: (opts: CreateZunoOptions) => {
     store: <T>(storeKey: string, init: () => T) => ReactBoundStore<T>;
     set<T>(storeKey: string, next: T | ((prev: T) => T), init?: () => T): Promise<any>;
     get<T>(storeKey: string, init?: () => T): T;
     stop?: () => void;
 };
-export type { ZunoReadable } from "@iadev93/zuno";
-//# sourceMappingURL=index.d.ts.map
+
+export { type BoundStore, type EqualityFn, type ReactBoundStore, type Selector, type ZunoCore, bindReact, createZunoReact };

package/dist/index.js

@@ -1,75 +1,2 @@
-import * as React from "react";
-import { toReadable, createZuno } from "@iadev93/zuno";
-/**
- * The default equality function, using `Object.is` for strict equality comparison.
- * This is a common and safe default for comparing primitive values and references.
- */
-const defaultEq = Object.is;
-/**
- * Binds Zuno to React.
- * @param zuno The Zuno instance to bind.
- * @returns A React-enhanced Zuno instance.
- */
-export const bindReact = (zuno) => {
-    /**
-     * A custom hook for accessing a Zuno store in a React component.
-     */
-    const useExternalStore = (readable, selector, equalityFn = defaultEq) => {
-        const select = React.useMemo(() => {
-            return (selector ??
-                ((s) => s));
-        }, [selector]);
-        const lastRef = React.useRef(null);
-        const hasLast = React.useRef(false);
-        const getSnapshot = React.useCallback(() => {
-            const next = select(readable.getSnapshot());
-            if (!hasLast.current) {
-                hasLast.current = true;
-                lastRef.current = next;
-                return next;
-            }
-            const prev = lastRef.current;
-            if (equalityFn(prev, next))
-                return prev;
-            lastRef.current = next;
-            return next;
-        }, [readable, select, equalityFn]);
-        const subscribe = React.useCallback((onChange) => readable.subscribe(onChange), [readable]);
-        const getServerSnapshot = React.useCallback(() => {
-            const s = readable.getServerSnapshot ? readable.getServerSnapshot() : readable.getSnapshot();
-            return select(s);
-        }, [readable, select]);
-        React.useEffect(() => {
-            hasLast.current = false;
-            lastRef.current = null;
-        }, [select, equalityFn]);
-        return React.useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
-    };
-    /**
-     * Creates a React-enhanced store.
-     */
-    const store = (storeKey, init) => {
-        const base = zuno.store(storeKey, init);
-        return {
-            ...base,
-            use: (selector, equalityFn = defaultEq) => {
-                const readable = React.useMemo(() => toReadable(base.raw()), [storeKey]);
-                return useExternalStore(readable, selector, equalityFn);
-            },
-        };
-    };
-    return {
-        ...zuno,
-        store,
-    };
-};
-/**
- * Creates a Zuno instance and returns a React-enhanced instance.
- *
- * @param opts The options for the Zuno instance.
- * @returns An object with a `store` method that returns stores with a `use` hook.
- */
-export const createZunoReact = (opts) => {
-    const zuno = createZuno(opts);
-    return bindReact(zuno);
-};
+'use strict';var e=require('react'),zuno=require('@iadev93/zuno');function _interopNamespace(e){if(e&&e.__esModule)return e;var n=Object.create(null);if(e){Object.keys(e).forEach(function(k){if(k!=='default'){var d=Object.getOwnPropertyDescriptor(e,k);Object.defineProperty(n,k,d.get?d:{enumerable:true,get:function(){return e[k]}});}})}n.default=e;return Object.freeze(n)}var e__namespace=/*#__PURE__*/_interopNamespace(e);var l=Object.is,y=a=>{let T=(t,u,n=l)=>{let o=e__namespace.useMemo(()=>u??(r=>r),[u]),s=e__namespace.useRef(null),c=e__namespace.useRef(false),i=e__namespace.useCallback(()=>{let r=o(t.getSnapshot());if(!c.current)return c.current=true,s.current=r,r;let S=s.current;return n(S,r)?S:(s.current=r,r)},[t,o,n]),p=e__namespace.useCallback(r=>t.subscribe(r),[t]),d=e__namespace.useCallback(()=>{let r=t.getServerSnapshot?t.getServerSnapshot():t.getSnapshot();return o(r)},[t,o]);return e__namespace.useEffect(()=>{c.current=false,s.current=null;},[o,n]),e__namespace.useSyncExternalStore(p,i,d)};return {...a,store:(t,u)=>{let n=a.store(t,u);return {...n,use:(o,s=l)=>{let c=e__namespace.useMemo(()=>zuno.toReadable(n.raw()),[t]);return T(c,o,s)}}}}},x=a=>{let T=zuno.createZuno(a);return y(T)};exports.bindReact=y;exports.createZunoReact=x;//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["defaultEq","bindReact","zuno","useExternalStore","readable","selector","equalityFn","select","e","s","lastRef","hasLast","getSnapshot","next","prev","subscribe","onChange","getServerSnapshot","storeKey","init","base","toReadable","createZunoReact","opts","createZuno"],"mappings":"waAsBA,IAAMA,CAAAA,CAA6B,MAAA,CAAO,GA4C7BC,CAAAA,CAAaC,CAAAA,EAAmB,CAI3C,IAAMC,CAAAA,CAAmB,CACvBC,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CAAoCN,CAAAA,GACtB,CACd,IAAMO,EAAeC,YAAA,CAAA,OAAA,CAAQ,IACnBH,IACJI,CAAAA,EAAcA,CAAAA,CAAAA,CACjB,CAACJ,CAAQ,CAAC,CAAA,CAEPK,CAAAA,CAAgBF,YAAA,CAAA,MAAA,CAAyB,IAAI,EAC7CG,CAAAA,CAAgBH,YAAA,CAAA,MAAA,CAAO,KAAK,CAAA,CAE5BI,CAAAA,CAAoBJ,yBAAY,IAAM,CAC1C,IAAMK,CAAAA,CAAON,CAAAA,CAAOH,CAAAA,CAAS,aAAa,CAAA,CAE1C,GAAI,CAACO,CAAAA,CAAQ,QACX,OAAAA,CAAAA,CAAQ,OAAA,CAAU,IAAA,CAClBD,CAAAA,CAAQ,OAAA,CAAUG,EACXA,CAAAA,CAGT,IAAMC,EAAOJ,CAAAA,CAAQ,OAAA,CACrB,OAAIJ,CAAAA,CAAWQ,CAAAA,CAAMD,CAAI,CAAA,CAAUC,CAAAA,EAEnCJ,CAAAA,CAAQ,QAAUG,CAAAA,CACXA,CAAAA,CACT,EAAG,CAACT,CAAAA,CAAUG,EAAQD,CAAU,CAAC,CAAA,CAE3BS,CAAAA,CAAkBP,YAAA,CAAA,WAAA,CACrBQ,CAAAA,EAAyBZ,EAAS,SAAA,CAAUY,CAAQ,EACrD,CAACZ,CAAQ,CACX,CAAA,CAEMa,CAAAA,CAA0BT,YAAA,CAAA,WAAA,CAAY,IAAM,CAChD,IAAMC,EAAIL,CAAAA,CAAS,iBAAA,CAAoBA,EAAS,iBAAA,EAAkB,CAAIA,EAAS,WAAA,EAAY,CAC3F,OAAOG,CAAAA,CAAOE,CAAC,CACjB,EAAG,CAACL,CAAAA,CAAUG,CAAM,CAAC,CAAA,CAErB,OAAMC,YAAA,CAAA,SAAA,CAAU,IAAM,CACpBG,CAAAA,CAAQ,OAAA,CAAU,KAAA,CAClBD,EAAQ,OAAA,CAAU,KACpB,EAAG,CAACH,CAAAA,CAAQD,CAAU,CAAC,CAAA,CAEVE,YAAA,CAAA,oBAAA,CAAqBO,CAAAA,CAAWH,CAAAA,CAAaK,CAAiB,CAC7E,CAAA,CAuBA,OAAO,CACL,GAAGf,CAAAA,CACH,MApBY,CAAKgB,CAAAA,CAAkBC,CAAAA,GAAsC,CACzE,IAAMC,CAAAA,CAAOlB,EAAK,KAAA,CAASgB,CAAAA,CAAUC,CAAI,CAAA,CAEzC,OAAO,CACL,GAAGC,CAAAA,CACH,GAAA,CAAK,CACHf,CAAAA,CACAC,CAAAA,CAAoCN,IACjC,CACH,IAAMI,EAAiBI,YAAA,CAAA,OAAA,CACrB,IAAMa,gBAAWD,CAAAA,CAAK,GAAA,EAAiC,CAAA,CACvD,CAACF,CAAQ,CACX,CAAA,CACA,OAAOf,EAA+BC,CAAAA,CAAUC,CAAAA,CAAUC,CAAU,CACtE,CACF,CACF,CAKA,CACF,CAAA,CAQagB,EAAmBC,CAAAA,EAA4B,CAC1D,IAAMrB,CAAAA,CAAOsB,eAAAA,CAAWD,CAAI,CAAA,CAC5B,OAAOtB,CAAAA,CAAUC,CAAI,CACvB","file":"index.js","sourcesContent":["import * as React from \"react\";\nimport { type ZunoReadable, type ZunoSubscribableStore, toReadable, createZuno, type CreateZunoOptions } from \"@iadev93/zuno\";\n\n/**\n * Type definition for an equality function.\n * It takes two values of the same type and returns true if they are considered equal, false otherwise.\n * Used to prevent unnecessary re-renders in React hooks when the selected state hasn't \"meaningfully\" changed.\n */\nexport type EqualityFn<T> = (a: T, b: T) => boolean;\n\n/**\n * Type definition for a selector function.\n * It takes the full state of a store and returns a selected portion of that state.\n * This allows components to subscribe only to the parts of the state they care about,\n * optimizing performance by avoiding re-renders for unrelated state changes.\n */\nexport type Selector<TState, TSelected> = (state: TState) => TSelected;\n\n/**\n * The default equality function, using `Object.is` for strict equality comparison.\n * This is a common and safe default for comparing primitive values and references.\n */\nconst defaultEq: EqualityFn<any> = Object.is;\n\n/**\n * An extended interface for a Zuno store that includes methods for setting state\n * and a unique key identifier. This represents a store that has been \"bound\" or registered.\n */\nexport type BoundStore<T> = {\n  key: string;\n  get: () => T;\n  set: (next: T | ((prev: T) => T)) => Promise<any>;\n  subscribe: (cb: (state: T) => void) => () => void;\n  raw: () => ZunoSubscribableStore<T>;\n};\n\n/**\n * The core interface for the Zuno library, providing methods to create,\n * retrieve, and update stores.\n */\nexport type ZunoCore = {\n  store<T>(storeKey: string, init: () => T): BoundStore<T>;\n  set<T>(storeKey: string, next: T | ((prev: T) => T), init?: () => T): Promise<any>;\n  get<T>(storeKey: string, init?: () => T): T;\n  stop?: () => void;\n};\n\n/**\n * An extended interface for a Zuno store that includes React-specific features.\n */\nexport type ReactBoundStore<T> = BoundStore<T> & {\n  /**\n   * React hook for this store.\n   * Optional selector + equality for derived values and avoiding rerenders.\n   */\n  use: <TSelected = T>(\n    selector?: Selector<T, TSelected>,\n    equalityFn?: EqualityFn<TSelected>\n  ) => TSelected;\n};\n\n/**\n * Binds Zuno to React.\n * @param zuno The Zuno instance to bind.\n * @returns A React-enhanced Zuno instance.\n */\nexport const bindReact = (zuno: ZunoCore) => {\n  /**\n   * A custom hook for accessing a Zuno store in a React component.\n   */\n  const useExternalStore = <TState, TSelected = TState>(\n    readable: ZunoReadable<TState>,\n    selector?: Selector<TState, TSelected>,\n    equalityFn: EqualityFn<TSelected> = defaultEq\n  ): TSelected => {\n    const select = React.useMemo(() => {\n      return (selector ??\n        ((s: TState) => s as unknown as TSelected)) as Selector<TState, TSelected>;\n    }, [selector]);\n\n    const lastRef = React.useRef<TSelected | null>(null);\n    const hasLast = React.useRef(false);\n\n    const getSnapshot = React.useCallback(() => {\n      const next = select(readable.getSnapshot());\n\n      if (!hasLast.current) {\n        hasLast.current = true;\n        lastRef.current = next;\n        return next;\n      }\n\n      const prev = lastRef.current as TSelected;\n      if (equalityFn(prev, next)) return prev;\n\n      lastRef.current = next;\n      return next;\n    }, [readable, select, equalityFn]);\n\n    const subscribe = React.useCallback(\n      (onChange: () => void) => readable.subscribe(onChange),\n      [readable]\n    );\n\n    const getServerSnapshot = React.useCallback(() => {\n      const s = readable.getServerSnapshot ? readable.getServerSnapshot() : readable.getSnapshot();\n      return select(s);\n    }, [readable, select]);\n\n    React.useEffect(() => {\n      hasLast.current = false;\n      lastRef.current = null;\n    }, [select, equalityFn]);\n\n    return React.useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n  };\n\n  /**\n   * Creates a React-enhanced store.\n   */\n  const store = <T,>(storeKey: string, init: () => T): ReactBoundStore<T> => {\n    const base = zuno.store<T>(storeKey, init);\n\n    return {\n      ...base,\n      use: <TSelected = T>(\n        selector?: Selector<T, TSelected>,\n        equalityFn: EqualityFn<TSelected> = defaultEq\n      ) => {\n        const readable = React.useMemo(\n          () => toReadable(base.raw() as ZunoSubscribableStore<T>),\n          [storeKey]\n        );\n        return useExternalStore<T, TSelected>(readable, selector, equalityFn);\n      },\n    };\n  };\n\n  return {\n    ...zuno,\n    store,\n  };\n};\n\n/**\n * Creates a Zuno instance and returns a React-enhanced instance.\n * \n * @param opts The options for the Zuno instance.\n * @returns An object with a `store` method that returns stores with a `use` hook.\n */\nexport const createZunoReact = (opts: CreateZunoOptions) => {\n  const zuno = createZuno(opts);\n  return bindReact(zuno);\n};\n\n// Convenience re-export\nexport type { ZunoReadable } from \"@iadev93/zuno\";\n"]}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import*as e from'react';import {toReadable,createZuno}from'@iadev93/zuno';var l=Object.is,y=a=>{let T=(t,u,n=l)=>{let o=e.useMemo(()=>u??(r=>r),[u]),s=e.useRef(null),c=e.useRef(false),i=e.useCallback(()=>{let r=o(t.getSnapshot());if(!c.current)return c.current=true,s.current=r,r;let S=s.current;return n(S,r)?S:(s.current=r,r)},[t,o,n]),p=e.useCallback(r=>t.subscribe(r),[t]),d=e.useCallback(()=>{let r=t.getServerSnapshot?t.getServerSnapshot():t.getSnapshot();return o(r)},[t,o]);return e.useEffect(()=>{c.current=false,s.current=null;},[o,n]),e.useSyncExternalStore(p,i,d)};return {...a,store:(t,u)=>{let n=a.store(t,u);return {...n,use:(o,s=l)=>{let c=e.useMemo(()=>toReadable(n.raw()),[t]);return T(c,o,s)}}}}},x=a=>{let T=createZuno(a);return y(T)};export{y as bindReact,x as createZunoReact};//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["defaultEq","bindReact","zuno","useExternalStore","readable","selector","equalityFn","select","s","lastRef","hasLast","getSnapshot","next","prev","subscribe","onChange","getServerSnapshot","storeKey","init","base","toReadable","createZunoReact","opts","createZuno"],"mappings":"0EAsBA,IAAMA,CAAAA,CAA6B,MAAA,CAAO,GA4C7BC,CAAAA,CAAaC,CAAAA,EAAmB,CAI3C,IAAMC,CAAAA,CAAmB,CACvBC,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CAAoCN,CAAAA,GACtB,CACd,IAAMO,EAAe,CAAA,CAAA,OAAA,CAAQ,IACnBF,IACJG,CAAAA,EAAcA,CAAAA,CAAAA,CACjB,CAACH,CAAQ,CAAC,CAAA,CAEPI,CAAAA,CAAgB,CAAA,CAAA,MAAA,CAAyB,IAAI,EAC7CC,CAAAA,CAAgB,CAAA,CAAA,MAAA,CAAO,KAAK,CAAA,CAE5BC,CAAAA,CAAoB,cAAY,IAAM,CAC1C,IAAMC,CAAAA,CAAOL,CAAAA,CAAOH,CAAAA,CAAS,aAAa,CAAA,CAE1C,GAAI,CAACM,CAAAA,CAAQ,QACX,OAAAA,CAAAA,CAAQ,OAAA,CAAU,IAAA,CAClBD,CAAAA,CAAQ,OAAA,CAAUG,EACXA,CAAAA,CAGT,IAAMC,EAAOJ,CAAAA,CAAQ,OAAA,CACrB,OAAIH,CAAAA,CAAWO,CAAAA,CAAMD,CAAI,CAAA,CAAUC,CAAAA,EAEnCJ,CAAAA,CAAQ,QAAUG,CAAAA,CACXA,CAAAA,CACT,EAAG,CAACR,CAAAA,CAAUG,EAAQD,CAAU,CAAC,CAAA,CAE3BQ,CAAAA,CAAkB,CAAA,CAAA,WAAA,CACrBC,CAAAA,EAAyBX,EAAS,SAAA,CAAUW,CAAQ,EACrD,CAACX,CAAQ,CACX,CAAA,CAEMY,CAAAA,CAA0B,CAAA,CAAA,WAAA,CAAY,IAAM,CAChD,IAAMR,EAAIJ,CAAAA,CAAS,iBAAA,CAAoBA,EAAS,iBAAA,EAAkB,CAAIA,EAAS,WAAA,EAAY,CAC3F,OAAOG,CAAAA,CAAOC,CAAC,CACjB,EAAG,CAACJ,CAAAA,CAAUG,CAAM,CAAC,CAAA,CAErB,OAAM,CAAA,CAAA,SAAA,CAAU,IAAM,CACpBG,CAAAA,CAAQ,OAAA,CAAU,KAAA,CAClBD,EAAQ,OAAA,CAAU,KACpB,EAAG,CAACF,CAAAA,CAAQD,CAAU,CAAC,CAAA,CAEV,CAAA,CAAA,oBAAA,CAAqBQ,CAAAA,CAAWH,CAAAA,CAAaK,CAAiB,CAC7E,CAAA,CAuBA,OAAO,CACL,GAAGd,CAAAA,CACH,MApBY,CAAKe,CAAAA,CAAkBC,CAAAA,GAAsC,CACzE,IAAMC,CAAAA,CAAOjB,EAAK,KAAA,CAASe,CAAAA,CAAUC,CAAI,CAAA,CAEzC,OAAO,CACL,GAAGC,CAAAA,CACH,GAAA,CAAK,CACHd,CAAAA,CACAC,CAAAA,CAAoCN,IACjC,CACH,IAAMI,EAAiB,CAAA,CAAA,OAAA,CACrB,IAAMgB,WAAWD,CAAAA,CAAK,GAAA,EAAiC,CAAA,CACvD,CAACF,CAAQ,CACX,CAAA,CACA,OAAOd,EAA+BC,CAAAA,CAAUC,CAAAA,CAAUC,CAAU,CACtE,CACF,CACF,CAKA,CACF,CAAA,CAQae,EAAmBC,CAAAA,EAA4B,CAC1D,IAAMpB,CAAAA,CAAOqB,UAAAA,CAAWD,CAAI,CAAA,CAC5B,OAAOrB,CAAAA,CAAUC,CAAI,CACvB","file":"index.mjs","sourcesContent":["import * as React from \"react\";\nimport { type ZunoReadable, type ZunoSubscribableStore, toReadable, createZuno, type CreateZunoOptions } from \"@iadev93/zuno\";\n\n/**\n * Type definition for an equality function.\n * It takes two values of the same type and returns true if they are considered equal, false otherwise.\n * Used to prevent unnecessary re-renders in React hooks when the selected state hasn't \"meaningfully\" changed.\n */\nexport type EqualityFn<T> = (a: T, b: T) => boolean;\n\n/**\n * Type definition for a selector function.\n * It takes the full state of a store and returns a selected portion of that state.\n * This allows components to subscribe only to the parts of the state they care about,\n * optimizing performance by avoiding re-renders for unrelated state changes.\n */\nexport type Selector<TState, TSelected> = (state: TState) => TSelected;\n\n/**\n * The default equality function, using `Object.is` for strict equality comparison.\n * This is a common and safe default for comparing primitive values and references.\n */\nconst defaultEq: EqualityFn<any> = Object.is;\n\n/**\n * An extended interface for a Zuno store that includes methods for setting state\n * and a unique key identifier. This represents a store that has been \"bound\" or registered.\n */\nexport type BoundStore<T> = {\n  key: string;\n  get: () => T;\n  set: (next: T | ((prev: T) => T)) => Promise<any>;\n  subscribe: (cb: (state: T) => void) => () => void;\n  raw: () => ZunoSubscribableStore<T>;\n};\n\n/**\n * The core interface for the Zuno library, providing methods to create,\n * retrieve, and update stores.\n */\nexport type ZunoCore = {\n  store<T>(storeKey: string, init: () => T): BoundStore<T>;\n  set<T>(storeKey: string, next: T | ((prev: T) => T), init?: () => T): Promise<any>;\n  get<T>(storeKey: string, init?: () => T): T;\n  stop?: () => void;\n};\n\n/**\n * An extended interface for a Zuno store that includes React-specific features.\n */\nexport type ReactBoundStore<T> = BoundStore<T> & {\n  /**\n   * React hook for this store.\n   * Optional selector + equality for derived values and avoiding rerenders.\n   */\n  use: <TSelected = T>(\n    selector?: Selector<T, TSelected>,\n    equalityFn?: EqualityFn<TSelected>\n  ) => TSelected;\n};\n\n/**\n * Binds Zuno to React.\n * @param zuno The Zuno instance to bind.\n * @returns A React-enhanced Zuno instance.\n */\nexport const bindReact = (zuno: ZunoCore) => {\n  /**\n   * A custom hook for accessing a Zuno store in a React component.\n   */\n  const useExternalStore = <TState, TSelected = TState>(\n    readable: ZunoReadable<TState>,\n    selector?: Selector<TState, TSelected>,\n    equalityFn: EqualityFn<TSelected> = defaultEq\n  ): TSelected => {\n    const select = React.useMemo(() => {\n      return (selector ??\n        ((s: TState) => s as unknown as TSelected)) as Selector<TState, TSelected>;\n    }, [selector]);\n\n    const lastRef = React.useRef<TSelected | null>(null);\n    const hasLast = React.useRef(false);\n\n    const getSnapshot = React.useCallback(() => {\n      const next = select(readable.getSnapshot());\n\n      if (!hasLast.current) {\n        hasLast.current = true;\n        lastRef.current = next;\n        return next;\n      }\n\n      const prev = lastRef.current as TSelected;\n      if (equalityFn(prev, next)) return prev;\n\n      lastRef.current = next;\n      return next;\n    }, [readable, select, equalityFn]);\n\n    const subscribe = React.useCallback(\n      (onChange: () => void) => readable.subscribe(onChange),\n      [readable]\n    );\n\n    const getServerSnapshot = React.useCallback(() => {\n      const s = readable.getServerSnapshot ? readable.getServerSnapshot() : readable.getSnapshot();\n      return select(s);\n    }, [readable, select]);\n\n    React.useEffect(() => {\n      hasLast.current = false;\n      lastRef.current = null;\n    }, [select, equalityFn]);\n\n    return React.useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n  };\n\n  /**\n   * Creates a React-enhanced store.\n   */\n  const store = <T,>(storeKey: string, init: () => T): ReactBoundStore<T> => {\n    const base = zuno.store<T>(storeKey, init);\n\n    return {\n      ...base,\n      use: <TSelected = T>(\n        selector?: Selector<T, TSelected>,\n        equalityFn: EqualityFn<TSelected> = defaultEq\n      ) => {\n        const readable = React.useMemo(\n          () => toReadable(base.raw() as ZunoSubscribableStore<T>),\n          [storeKey]\n        );\n        return useExternalStore<T, TSelected>(readable, selector, equalityFn);\n      },\n    };\n  };\n\n  return {\n    ...zuno,\n    store,\n  };\n};\n\n/**\n * Creates a Zuno instance and returns a React-enhanced instance.\n * \n * @param opts The options for the Zuno instance.\n * @returns An object with a `store` method that returns stores with a `use` hook.\n */\nexport const createZunoReact = (opts: CreateZunoOptions) => {\n  const zuno = createZuno(opts);\n  return bindReact(zuno);\n};\n\n// Convenience re-export\nexport type { ZunoReadable } from \"@iadev93/zuno\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iadev93/zuno-react",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -20,6 +20,7 @@
   },
   "devDependencies": {
     "@types/react": "^18.0.0",
+    "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "@iadev93/zuno": "0.0.5"
   },
@@ -45,6 +46,7 @@
   "author": "Ibrahim Aftab",
   "license": "MIT",
   "scripts": {
-    "build": "tsc -p tsconfig.json"
+    "build": "tsup",
+    "dev": "tsup --watch"
   }
 }

package/dist/bindReact.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bindReact.d.ts","sourceRoot":"","sources":["../src/bindReact.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,qBAAqB,EAAc,MAAM,eAAe,CAAC;AAE1F;;;;GAIG;AACH,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;AAE7C;;;;;GAKG;AACH,KAAK,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;AAQhE;;;GAGG;AACH,KAAK,UAAU,CAAC,CAAC,IAAI;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,CAAC;IACb,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAClD,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAClD,GAAG,EAAE,MAAM,qBAAqB,CAAC,CAAC,CAAC,CAAC;CACrC,CAAC;AAEF;;;GAGG;AACH,KAAK,QAAQ,GAAG;IACd,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACzD,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACnF,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,KAAK,eAAe,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG;IACxC;;;OAGG;IACH,GAAG,EAAE,CAAC,SAAS,GAAG,CAAC,EACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,EACjC,UAAU,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,KAC/B,SAAS,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,QAAQ;YAgHvB,CAAC,YAAa,MAAM,QAAQ,MAAM,CAAC,KAAG,eAAe,CAAC,CAAC,CAAC;QAzInE,CAAC,YAAY,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;QAC9E,CAAC,YAAY,MAAM,SAAS,MAAM,CAAC,GAAG,CAAC;WACpC,MAAM,IAAI;CAwKlB,CAAC"}

package/dist/bindReact.js

@@ -1,128 +0,0 @@
-import * as React from "react";
-import { toReadable } from "@iadev93/zuno";
-/**
- * The default equality function, using `Object.is` for strict equality comparison.
- * This is a common and safe default for comparing primitive values and references.
- */
-const defaultEq = Object.is;
-/**
- * Binds Zuno to React.
- * @param zuno The Zuno instance to bind.
- * @returns A React hook for accessing the store.
- */
-export const bindReact = (zuno) => {
-    /**
-     * A custom hook for accessing a Zuno store in a React component.
-     * @param store The Zuno store to access.
-     * @param selector Optional selector function to extract a specific part of the store's state.
-     * @param equalityFn Optional equality function to determine if the selected state has changed.
-     * @returns The selected state from the store.
-     */
-    const useExternalStore = (readable, selector, equalityFn = defaultEq) => {
-        /**
-         * Memoized selector function.
-         * If no selector is provided, the entire state is selected.
-         */
-        const select = React.useMemo(() => {
-            return (selector ??
-                ((s) => s));
-        }, [selector]);
-        /**
-         * Reference to the last selected state.
-         * Used to compare with the new state to determine if a re-render is needed.
-         */
-        const lastRef = React.useRef(null);
-        /**
-         * Flag to indicate if the last state has been set.
-         * Used to determine if the component should re-render.
-         */
-        const hasLast = React.useRef(false);
-        /**
-         * Function to get the current state of the store.
-         * If the state has changed since the last render, the component will re-render.
-         */
-        const getSnapshot = React.useCallback(() => {
-            /**
-             * Get the current state of the store.
-             */
-            const next = select(readable.getSnapshot());
-            /**
-             * If the last state has not been set, set it and return the next state.
-             * This is the initial state of the component.
-             */
-            if (!hasLast.current) {
-                hasLast.current = true;
-                lastRef.current = next;
-                return next;
-            }
-            /**
-             * Previous state.
-             * Used to compare with the new state to determine if a re-render is needed.
-             */
-            const prev = lastRef.current;
-            /**
-             * If the previous state is equal to the next state, return the previous state.
-             * This prevents unnecessary re-renders.
-             */
-            if (equalityFn(prev, next))
-                return prev;
-            /**
-             * Update the last state and return the next state.
-             */
-            lastRef.current = next;
-            return next;
-        }, [readable, select, equalityFn]);
-        /**
-         * Function to subscribe to changes in the store.
-         * When the store changes, the component will re-render.
-         */
-        const subscribe = React.useCallback((onChange) => readable.subscribe(onChange), [readable]);
-        const getServerSnapshot = React.useCallback(() => {
-            const s = readable.getServerSnapshot ? readable.getServerSnapshot() : readable.getSnapshot();
-            return select(s);
-        }, [readable, select]);
-        /**
-         * Reset the last state and lastRef when the selector or equalityFn changes.
-         * This ensures that the component re-renders when the selector or equalityFn changes.
-         */
-        React.useEffect(() => {
-            hasLast.current = false;
-            lastRef.current = null;
-        }, [select, equalityFn]);
-        /**
-         * Returns the current state of the store.
-         * If the state has changed since the last render, the component will re-render.
-         */
-        return React.useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
-    };
-    /**
-     * Creates a store and returns a React hook for accessing the store.
-     * @param storeKey The key of the store.
-     * @param init The initialization function for the store.
-     * @returns A React hook for accessing the store.
-     */
-    const store = (storeKey, init) => {
-        /**
-         * Creates a store and returns a React hook for accessing the store.
-         */
-        const base = zuno.store(storeKey, init);
-        /**
-         * Returns a React hook for accessing the store.
-         */
-        return {
-            ...base,
-            use: (selector, equalityFn = defaultEq) => {
-                // IMPORTANT: call hook only inside components
-                const readable = React.useMemo(() => toReadable(base.raw()), [storeKey]);
-                return useExternalStore(readable, selector, equalityFn);
-            },
-        };
-    };
-    /**
-     * Returns a Zuno instance with React-enhanced bound store.
-     */
-    return {
-        ...zuno,
-        store, // overrides store() with React-enhanced bound store
-    };
-};

package/dist/createZunoReact.d.ts

@@ -1,27 +0,0 @@
-import { CreateZunoOptions } from "@iadev93/zuno";
-/**
- * Creates a Zuno instance and returns a React hook for accessing the store.
- *
- * ⚠️ IMPORTANT:
- *
- * Call this at **module scope**, not inside *React components*.
- * This creates a single Zuno instance.
- *
- * @param opts The options for the Zuno instance.
- * @returns An object with a `useStore` hook for accessing the store.
- */
-export declare const createZunoReact: (opts: CreateZunoOptions) => {
-    store: <T>(storeKey: string, init: () => T) => {
-        key: string;
-        get: () => T;
-        set: (next: T | ((prev: T) => T)) => Promise<any>;
-        subscribe: (cb: (state: T) => void) => () => void;
-        raw: () => import("@iadev93/zuno").ZunoSubscribableStore<T>;
-    } & {
-        use: <TSelected = T>(selector?: ((state: T) => TSelected) | undefined, equalityFn?: ((a: TSelected, b: TSelected) => boolean) | undefined) => TSelected;
-    };
-    set<T>(storeKey: string, next: T | ((prev: T) => T), init?: () => T): Promise<any>;
-    get<T>(storeKey: string, init?: () => T): T;
-    stop?: () => void;
-};
-//# sourceMappingURL=createZunoReact.d.ts.map

package/dist/createZunoReact.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createZunoReact.d.ts","sourceRoot":"","sources":["../src/createZunoReact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAG9D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,iBAAiB;;;;;;;;;;;;;CAOtD,CAAC"}

package/dist/createZunoReact.js

@@ -1,19 +0,0 @@
-import { createZuno } from "@iadev93/zuno";
-import { bindReact } from "./bindReact";
-/**
- * Creates a Zuno instance and returns a React hook for accessing the store.
- *
- * ⚠️ IMPORTANT:
- *
- * Call this at **module scope**, not inside *React components*.
- * This creates a single Zuno instance.
- *
- * @param opts The options for the Zuno instance.
- * @returns An object with a `useStore` hook for accessing the store.
- */
-export const createZunoReact = (opts) => {
-    /** Zuno */
-    const zuno = createZuno(opts);
-    /** Return zuno */
-    return bindReact(zuno);
-};

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,qBAAqB,EAA0B,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE9H;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;AAQvE;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,CAAC;IACb,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAClD,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IAClD,GAAG,EAAE,MAAM,qBAAqB,CAAC,CAAC,CAAC,CAAC;CACrC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACzD,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACnF,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG;IAC/C;;;OAGG;IACH,GAAG,EAAE,CAAC,SAAS,GAAG,CAAC,EACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,EACjC,UAAU,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,KAC/B,SAAS,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,QAAQ;YAsDvB,CAAC,YAAa,MAAM,QAAQ,MAAM,CAAC,KAAG,eAAe,CAAC,CAAC,CAAC;QA9EnE,CAAC,YAAY,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;QAC9E,CAAC,YAAY,MAAM,SAAS,MAAM,CAAC,GAAG,CAAC;WACpC,MAAM,IAAI;CAkGlB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,iBAAiB;YA9BtC,CAAC,YAAa,MAAM,QAAQ,MAAM,CAAC,KAAG,eAAe,CAAC,CAAC,CAAC;QA9EnE,CAAC,YAAY,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;QAC9E,CAAC,YAAY,MAAM,SAAS,MAAM,CAAC,GAAG,CAAC;WACpC,MAAM,IAAI;CA6GlB,CAAC;AAGF,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}