@quantajs/react 2.0.0-beta.2 → 2.0.0-beta.4

package/dist/index.cjs

@@ -20,25 +20,9 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
  */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const v=require("react"),T=require("@quantajs/core");function A(t,o){return v.useSyncExternalStore(t.subscribe,()=>o?o(t):t,()=>o?o(t):t)}const g=v.createContext({stores:{}});function q(){const t=v.useContext(g);if(!t)throw new Error("useQuantaContext must be used within a QuantaProvider");return t}function ae(t,o){const{stores:f}=q(),c=f[t];if(!c)throw new Error(`Store with name "${t}" does not exist in the context.`);return o?A(c,o):A(c)}function ue(t,o,f,c){const s=v.useRef();return s.current||(s.current=T.createStore(t,{state:o,getters:f,actions:c})),s.current}var S={exports:{}},R={};/**
- * @license React
- * react-jsx-runtime.production.js
- *
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */var L;function se(){if(L)return R;L=1;var t=Symbol.for("react.transitional.element"),o=Symbol.for("react.fragment");function f(c,s,i){var b=null;if(i!==void 0&&(b=""+i),s.key!==void 0&&(b=""+s.key),"key"in s){i={};for(var E in s)E!=="key"&&(i[E]=s[E])}else i=s;return s=i.ref,{$$typeof:t,type:c,key:b,ref:s!==void 0?s:null,props:i}}return R.Fragment=o,R.jsx=f,R.jsxs=f,R}var _={};/**
- * @license React
- * react-jsx-runtime.development.js
- *
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */var Q;function ce(){return Q||(Q=1,process.env.NODE_ENV!=="production"&&function(){function t(e){if(e==null)return null;if(typeof e=="function")return e.$$typeof===te?null:e.displayName||e.name||null;if(typeof e=="string")return e;switch(e){case O:return"Fragment";case G:return"Profiler";case V:return"StrictMode";case Z:return"Suspense";case K:return"SuspenseList";case re:return"Activity"}if(typeof e=="object")switch(typeof e.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),e.$$typeof){case z:return"Portal";case B:return(e.displayName||"Context")+".Provider";case X:return(e._context.displayName||"Context")+".Consumer";case H:var r=e.render;return e=e.displayName,e||(e=r.displayName||r.name||"",e=e!==""?"ForwardRef("+e+")":"ForwardRef"),e;case ee:return r=e.displayName||null,r!==null?r:t(e.type)||"Memo";case N:r=e._payload,e=e._init;try{return t(e(r))}catch{}}return null}function o(e){return""+e}function f(e){try{o(e);var r=!1}catch{r=!0}if(r){r=console;var n=r.error,a=typeof Symbol=="function"&&Symbol.toStringTag&&e[Symbol.toStringTag]||e.constructor.name||"Object";return n.call(r,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",a),o(e)}}function c(e){if(e===O)return"<>";if(typeof e=="object"&&e!==null&&e.$$typeof===N)return"<...>";try{var r=t(e);return r?"<"+r+">":"<...>"}catch{return"<...>"}}function s(){var e=P.A;return e===null?null:e.getOwner()}function i(){return Error("react-stack-top-frame")}function b(e){if(Y.call(e,"key")){var r=Object.getOwnPropertyDescriptor(e,"key").get;if(r&&r.isReactWarning)return!1}return e.key!==void 0}function E(e,r){function n(){$||($=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",r))}n.isReactWarning=!0,Object.defineProperty(e,"key",{get:n,configurable:!0})}function U(){var e=t(this.type);return I[e]||(I[e]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),e=this.props.ref,e!==void 0?e:null}function J(e,r,n,a,d,l,x,w){return n=l.ref,e={$$typeof:C,type:e,key:r,props:l,_owner:d},(n!==void 0?n:null)!==null?Object.defineProperty(e,"ref",{enumerable:!1,get:U}):Object.defineProperty(e,"ref",{enumerable:!1,value:null}),e._store={},Object.defineProperty(e._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(e,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(e,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:x}),Object.defineProperty(e,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:w}),Object.freeze&&(Object.freeze(e.props),Object.freeze(e)),e}function h(e,r,n,a,d,l,x,w){var u=r.children;if(u!==void 0)if(a)if(ne(u)){for(a=0;a<u.length;a++)y(u[a]);Object.freeze&&Object.freeze(u)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else y(u);if(Y.call(r,"key")){u=t(e);var m=Object.keys(r).filter(function(oe){return oe!=="key"});a=0<m.length?"{key: someKey, "+m.join(": ..., ")+": ...}":"{key: someKey}",M[u+a]||(m=0<m.length?"{"+m.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const E=require("react"),i=require("@quantajs/core");function $(r,c){if(!r.subscribe){const a=new Error("QuantaJS store missing `subscribe`—ensure core v0.1.0-beta.2+.");throw i.logger.error(`useQuantaStore: ${a.message}`),a}const n=E.useRef(null),u=E.useCallback(()=>{const R={...r.state??{}};return Object.keys(r.actions??{}).forEach(S=>{R[S]=r.actions[S].bind(r)}),r.getters&&Object.keys(r.getters).forEach(S=>{const g=r.getters[S];R[S]=typeof g=="function"?g.bind(r):g}),R},[r]);n.current===null&&(n.current=u());const o=E.useCallback(a=>{const R=S=>{try{const h={...S??r.state??{}};Object.keys(r.actions??{}).forEach(b=>{h[b]=r.actions[b]}),r.getters&&Object.keys(r.getters).forEach(b=>{const _=r.getters[b];h[b]=typeof _=="function"?_.bind(r):_}),n.current=h,a()}catch(g){i.logger.warn(`useQuantaStore: Failed to update snapshot: ${g instanceof Error?g.message:String(g)}`)}};return r.subscribe(R)},[r]),l=E.useCallback(()=>{try{return n.current||(n.current=u()),c?c(n.current):n.current}catch(a){throw i.logger.error(`useQuantaStore: getSnapshot failed: ${a instanceof Error?a.message:String(a)}`),a}},[c,u]),v=E.useCallback(()=>{try{const a=u();return c?c(a):a}catch(a){throw i.logger.error(`useQuantaStore: getServerSnapshot failed: ${a instanceof Error?a.message:String(a)}`),a}},[c,u]);return E.useSyncExternalStore(o,l,v)}const N=E.createContext({stores:{}});function J(){try{const r=E.useContext(N);if(!r){const c="useQuantaContext must be used within a QuantaProvider";throw i.logger.error(`QuantaContext: ${c}`),new Error(c)}return r}catch(r){throw i.logger.error(`QuantaContext: Failed to access context: ${r instanceof Error?r.message:String(r)}`),r}}function ae(r,c){try{const{stores:n}=J(),u=n[r];if(!u){const o=`Store with name "${r}" does not exist in the context.`;throw i.logger.error(`useStore: ${o}`),new Error(o)}return c?$(u,c):$(u)}catch(n){throw i.logger.error(`useStore: Failed to access store "${r}": ${n instanceof Error?n.message:String(n)}`),n}}function se(r,c,n,u){try{const o=E.useRef(void 0);if(!o.current)try{o.current=i.createStore(r,{state:c,getters:n,actions:u})}catch(l){throw i.logger.error(`useCreateStore: Failed to create store "${r}": ${l instanceof Error?l.message:String(l)}`),l}return o.current}catch(o){throw i.logger.error(`useCreateStore: Hook execution failed: ${o instanceof Error?o.message:String(o)}`),o}}var k={exports:{}},T={};var W;function ce(){if(W)return T;W=1;var r=Symbol.for("react.transitional.element"),c=Symbol.for("react.fragment");function n(u,o,l){var v=null;if(l!==void 0&&(v=""+l),o.key!==void 0&&(v=""+o.key),"key"in o){l={};for(var a in o)a!=="key"&&(l[a]=o[a])}else l=o;return o=l.ref,{$$typeof:r,type:u,key:v,ref:o!==void 0?o:null,props:l}}return T.Fragment=c,T.jsx=n,T.jsxs=n,T}var O={};var q;function ue(){return q||(q=1,process.env.NODE_ENV!=="production"&&(function(){function r(e){if(e==null)return null;if(typeof e=="function")return e.$$typeof===te?null:e.displayName||e.name||null;if(typeof e=="string")return e;switch(e){case P:return"Fragment";case G:return"Profiler";case V:return"StrictMode";case Z:return"Suspense";case K:return"SuspenseList";case re:return"Activity"}if(typeof e=="object")switch(typeof e.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),e.$$typeof){case z:return"Portal";case H:return(e.displayName||"Context")+".Provider";case X:return(e._context.displayName||"Context")+".Consumer";case B:var t=e.render;return e=e.displayName,e||(e=t.displayName||t.name||"",e=e!==""?"ForwardRef("+e+")":"ForwardRef"),e;case ee:return t=e.displayName||null,t!==null?t:r(e.type)||"Memo";case Q:t=e._payload,e=e._init;try{return r(e(t))}catch{}}return null}function c(e){return""+e}function n(e){try{c(e);var t=!1}catch{t=!0}if(t){t=console;var s=t.error,f=typeof Symbol=="function"&&Symbol.toStringTag&&e[Symbol.toStringTag]||e.constructor.name||"Object";return s.call(t,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",f),c(e)}}function u(e){if(e===P)return"<>";if(typeof e=="object"&&e!==null&&e.$$typeof===Q)return"<...>";try{var t=r(e);return t?"<"+t+">":"<...>"}catch{return"<...>"}}function o(){var e=x.A;return e===null?null:e.getOwner()}function l(){return Error("react-stack-top-frame")}function v(e){if(Y.call(e,"key")){var t=Object.getOwnPropertyDescriptor(e,"key").get;if(t&&t.isReactWarning)return!1}return e.key!==void 0}function a(e,t){function s(){F||(F=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",t))}s.isReactWarning=!0,Object.defineProperty(e,"key",{get:s,configurable:!0})}function R(){var e=r(this.type);return I[e]||(I[e]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),e=this.props.ref,e!==void 0?e:null}function S(e,t,s,f,p,m,j,C){return s=m.ref,e={$$typeof:_,type:e,key:t,props:m,_owner:p},(s!==void 0?s:null)!==null?Object.defineProperty(e,"ref",{enumerable:!1,get:R}):Object.defineProperty(e,"ref",{enumerable:!1,value:null}),e._store={},Object.defineProperty(e._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(e,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(e,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:j}),Object.defineProperty(e,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:C}),Object.freeze&&(Object.freeze(e.props),Object.freeze(e)),e}function g(e,t,s,f,p,m,j,C){var d=t.children;if(d!==void 0)if(f)if(ne(d)){for(f=0;f<d.length;f++)h(d[f]);Object.freeze&&Object.freeze(d)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else h(d);if(Y.call(t,"key")){d=r(e);var w=Object.keys(t).filter(function(oe){return oe!=="key"});f=0<w.length?"{key: someKey, "+w.join(": ..., ")+": ...}":"{key: someKey}",L[d+f]||(w=0<w.length?"{"+w.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
   let props = %s;
   <%s {...props} />
 React keys must be passed directly to JSX without using spread:
   let props = %s;
-  <%s key={someKey} {...props} />`,a,u,m,u),M[u+a]=!0)}if(u=null,n!==void 0&&(f(n),u=""+n),b(r)&&(f(r.key),u=""+r.key),"key"in r){n={};for(var j in r)j!=="key"&&(n[j]=r[j])}else n=r;return u&&E(n,typeof e=="function"?e.displayName||e.name||"Unknown":e),J(e,u,l,d,s(),n,x,w)}function y(e){typeof e=="object"&&e!==null&&e.$$typeof===C&&e._store&&(e._store.validated=1)}var p=v,C=Symbol.for("react.transitional.element"),z=Symbol.for("react.portal"),O=Symbol.for("react.fragment"),V=Symbol.for("react.strict_mode"),G=Symbol.for("react.profiler"),X=Symbol.for("react.consumer"),B=Symbol.for("react.context"),H=Symbol.for("react.forward_ref"),Z=Symbol.for("react.suspense"),K=Symbol.for("react.suspense_list"),ee=Symbol.for("react.memo"),N=Symbol.for("react.lazy"),re=Symbol.for("react.activity"),te=Symbol.for("react.client.reference"),P=p.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,Y=Object.prototype.hasOwnProperty,ne=Array.isArray,k=console.createTask?console.createTask:function(){return null};p={react_stack_bottom_frame:function(e){return e()}};var $,I={},F=p.react_stack_bottom_frame.bind(p,i)(),D=k(c(i)),M={};_.Fragment=O,_.jsx=function(e,r,n,a,d){var l=1e4>P.recentlyCreatedOwnerStacks++;return h(e,r,n,!1,a,d,l?Error("react-stack-top-frame"):F,l?k(c(e)):D)},_.jsxs=function(e,r,n,a,d){var l=1e4>P.recentlyCreatedOwnerStacks++;return h(e,r,n,!0,a,d,l?Error("react-stack-top-frame"):F,l?k(c(e)):D)}}()),_}var W;function ie(){return W||(W=1,process.env.NODE_ENV==="production"?S.exports=se():S.exports=ce()),S.exports}var le=ie();function fe({stores:t,children:o}){return le.jsx(g.Provider,{value:{stores:t},children:o})}Object.defineProperty(exports,"computed",{enumerable:!0,get:()=>T.computed});Object.defineProperty(exports,"createStore",{enumerable:!0,get:()=>T.createStore});Object.defineProperty(exports,"reactive",{enumerable:!0,get:()=>T.reactive});Object.defineProperty(exports,"watch",{enumerable:!0,get:()=>T.watch});exports.QuantaContext=g;exports.QuantaProvider=fe;exports.useCreateStore=ue;exports.useQuantaContext=q;exports.useQuantaStore=A;exports.useStore=ae;
+  <%s key={someKey} {...props} />`,f,d,w,d),L[d+f]=!0)}if(d=null,s!==void 0&&(n(s),d=""+s),v(t)&&(n(t.key),d=""+t.key),"key"in t){s={};for(var A in t)A!=="key"&&(s[A]=t[A])}else s=t;return d&&a(s,typeof e=="function"?e.displayName||e.name||"Unknown":e),S(e,d,m,p,o(),s,j,C)}function h(e){typeof e=="object"&&e!==null&&e.$$typeof===_&&e._store&&(e._store.validated=1)}var b=E,_=Symbol.for("react.transitional.element"),z=Symbol.for("react.portal"),P=Symbol.for("react.fragment"),V=Symbol.for("react.strict_mode"),G=Symbol.for("react.profiler"),X=Symbol.for("react.consumer"),H=Symbol.for("react.context"),B=Symbol.for("react.forward_ref"),Z=Symbol.for("react.suspense"),K=Symbol.for("react.suspense_list"),ee=Symbol.for("react.memo"),Q=Symbol.for("react.lazy"),re=Symbol.for("react.activity"),te=Symbol.for("react.client.reference"),x=b.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,Y=Object.prototype.hasOwnProperty,ne=Array.isArray,y=console.createTask?console.createTask:function(){return null};b={react_stack_bottom_frame:function(e){return e()}};var F,I={},M=b.react_stack_bottom_frame.bind(b,l)(),D=y(u(l)),L={};O.Fragment=P,O.jsx=function(e,t,s,f,p){var m=1e4>x.recentlyCreatedOwnerStacks++;return g(e,t,s,!1,f,p,m?Error("react-stack-top-frame"):M,m?y(u(e)):D)},O.jsxs=function(e,t,s,f,p){var m=1e4>x.recentlyCreatedOwnerStacks++;return g(e,t,s,!0,f,p,m?Error("react-stack-top-frame"):M,m?y(u(e)):D)}})()),O}var U;function ie(){return U||(U=1,process.env.NODE_ENV==="production"?k.exports=ce():k.exports=ue()),k.exports}var le=ie();function fe({stores:r,children:c}){try{if(!r||typeof r!="object"){const n="QuantaProvider: Invalid stores prop provided";throw i.logger.error(n),new Error(n)}for(const[n,u]of Object.entries(r))if(!u||typeof u!="object"){const o=`QuantaProvider: Invalid store "${n}" provided`;throw i.logger.error(o),new Error(o)}return le.jsx(N.Provider,{value:{stores:r},children:c})}catch(n){throw i.logger.error(`QuantaProvider: Failed to render provider: ${n instanceof Error?n.message:String(n)}`),n}}Object.defineProperty(exports,"computed",{enumerable:!0,get:()=>i.computed});Object.defineProperty(exports,"createStore",{enumerable:!0,get:()=>i.createStore});Object.defineProperty(exports,"logger",{enumerable:!0,get:()=>i.logger});Object.defineProperty(exports,"reactive",{enumerable:!0,get:()=>i.reactive});Object.defineProperty(exports,"watch",{enumerable:!0,get:()=>i.watch});exports.QuantaContext=N;exports.QuantaProvider=fe;exports.useCreateStore=se;exports.useQuantaContext=J;exports.useQuantaStore=$;exports.useStore=ae;

package/dist/index.d.ts

@@ -4,6 +4,7 @@ import { Context } from 'react';
 import { createStore } from '@quantajs/core';
 import { GetterDefinition } from '@quantajs/core';
 import { JSX } from 'react/jsx-runtime';
+import { logger } from '@quantajs/core';
 import { reactive } from '@quantajs/core';
 import { ReactNode } from 'react';
 import { StateDefinition } from '@quantajs/core';
@@ -20,6 +21,8 @@ export { createStore }
 
 export { GetterDefinition }
 
+export { logger }
+
 export declare const QuantaContext: Context<QuantaContextValue>;
 
 declare interface QuantaContextValue {

package/dist/index.js

@@ -20,198 +20,260 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
  */
-import te, { useSyncExternalStore as ne, createContext as oe, useContext as ae, useRef as ue } from "react";
-import { createStore as se } from "@quantajs/core";
-import { computed as pe, createStore as Se, reactive as ke, watch as xe } from "@quantajs/core";
-function I(t, o) {
-  return ne(
-    t.subscribe,
-    () => o ? o(t) : t,
-    () => o ? o(t) : t
-  );
-}
-const M = oe({ stores: {} });
-function ce() {
-  const t = ae(M);
-  if (!t)
-    throw new Error(
-      "useQuantaContext must be used within a QuantaProvider"
+import ae, { useRef as J, useCallback as x, useSyncExternalStore as se, createContext as ce, useContext as ue } from "react";
+import { logger as d, createStore as ie } from "@quantajs/core";
+import { computed as _e, createStore as we, logger as Te, reactive as xe, watch as ke } from "@quantajs/core";
+function D(r, c) {
+  if (!r.subscribe) {
+    const a = new Error(
+      "QuantaJS store missing `subscribe`—ensure core v0.1.0-beta.2+."
     );
-  return t;
+    throw d.error(`useQuantaStore: ${a.message}`), a;
+  }
+  const n = J(null), u = x(() => {
+    const g = { ...r.state ?? {} };
+    return Object.keys(r.actions ?? {}).forEach((p) => {
+      g[p] = r.actions[p].bind(r);
+    }), r.getters && Object.keys(r.getters).forEach((p) => {
+      const m = r.getters[p];
+      g[p] = typeof m == "function" ? m.bind(r) : m;
+    }), g;
+  }, [r]);
+  n.current === null && (n.current = u());
+  const o = x(
+    (a) => {
+      const g = (p) => {
+        try {
+          const R = { ...p ?? r.state ?? {} };
+          Object.keys(r.actions ?? {}).forEach((E) => {
+            R[E] = r.actions[E];
+          }), r.getters && Object.keys(r.getters).forEach((E) => {
+            const h = r.getters[E];
+            R[E] = typeof h == "function" ? h.bind(r) : h;
+          }), n.current = R, a();
+        } catch (m) {
+          d.warn(
+            `useQuantaStore: Failed to update snapshot: ${m instanceof Error ? m.message : String(m)}`
+          );
+        }
+      };
+      return r.subscribe(g);
+    },
+    [r]
+  ), i = x(() => {
+    try {
+      return n.current || (n.current = u()), c ? c(n.current) : n.current;
+    } catch (a) {
+      throw d.error(
+        `useQuantaStore: getSnapshot failed: ${a instanceof Error ? a.message : String(a)}`
+      ), a;
+    }
+  }, [c, u]), S = x(() => {
+    try {
+      const a = u();
+      return c ? c(a) : a;
+    } catch (a) {
+      throw d.error(
+        `useQuantaStore: getServerSnapshot failed: ${a instanceof Error ? a.message : String(a)}`
+      ), a;
+    }
+  }, [c, u]);
+  return se(o, i, S);
 }
-function Re(t, o) {
-  const { stores: f } = ce(), c = f[t];
-  if (!c)
-    throw new Error(
-      `Store with name "${t}" does not exist in the context.`
-    );
-  return o ? I(c, o) : I(c);
+const q = ce({ stores: {} });
+function le() {
+  try {
+    const r = ue(q);
+    if (!r) {
+      const c = "useQuantaContext must be used within a QuantaProvider";
+      throw d.error(`QuantaContext: ${c}`), new Error(c);
+    }
+    return r;
+  } catch (r) {
+    throw d.error(
+      `QuantaContext: Failed to access context: ${r instanceof Error ? r.message : String(r)}`
+    ), r;
+  }
 }
-function _e(t, o, f, c) {
-  const s = ue();
-  return s.current || (s.current = se(t, { state: o, getters: f, actions: c })), s.current;
+function ve(r, c) {
+  try {
+    const { stores: n } = le(), u = n[r];
+    if (!u) {
+      const o = `Store with name "${r}" does not exist in the context.`;
+      throw d.error(`useStore: ${o}`), new Error(o);
+    }
+    return c ? D(u, c) : D(u);
+  } catch (n) {
+    throw d.error(
+      `useStore: Failed to access store "${r}": ${n instanceof Error ? n.message : String(n)}`
+    ), n;
+  }
 }
-var T = { exports: {} }, _ = {};
-/**
- * @license React
- * react-jsx-runtime.production.js
- *
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-var F;
-function ie() {
-  if (F) return _;
-  F = 1;
-  var t = Symbol.for("react.transitional.element"), o = Symbol.for("react.fragment");
-  function f(c, s, i) {
-    var E = null;
-    if (i !== void 0 && (E = "" + i), s.key !== void 0 && (E = "" + s.key), "key" in s) {
+function Se(r, c, n, u) {
+  try {
+    const o = J(void 0);
+    if (!o.current)
+      try {
+        o.current = ie(r, {
+          state: c,
+          getters: n,
+          actions: u
+        });
+      } catch (i) {
+        throw d.error(
+          `useCreateStore: Failed to create store "${r}": ${i instanceof Error ? i.message : String(i)}`
+        ), i;
+      }
+    return o.current;
+  } catch (o) {
+    throw d.error(
+      `useCreateStore: Hook execution failed: ${o instanceof Error ? o.message : String(o)}`
+    ), o;
+  }
+}
+var k = { exports: {} }, w = {};
+var L;
+function fe() {
+  if (L) return w;
+  L = 1;
+  var r = Symbol.for("react.transitional.element"), c = Symbol.for("react.fragment");
+  function n(u, o, i) {
+    var S = null;
+    if (i !== void 0 && (S = "" + i), o.key !== void 0 && (S = "" + o.key), "key" in o) {
       i = {};
-      for (var R in s)
-        R !== "key" && (i[R] = s[R]);
-    } else i = s;
-    return s = i.ref, {
-      $$typeof: t,
-      type: c,
-      key: E,
-      ref: s !== void 0 ? s : null,
+      for (var a in o)
+        a !== "key" && (i[a] = o[a]);
+    } else i = o;
+    return o = i.ref, {
+      $$typeof: r,
+      type: u,
+      key: S,
+      ref: o !== void 0 ? o : null,
       props: i
     };
   }
-  return _.Fragment = o, _.jsx = f, _.jsxs = f, _;
+  return w.Fragment = c, w.jsx = n, w.jsxs = n, w;
 }
-var b = {};
-/**
- * @license React
- * react-jsx-runtime.development.js
- *
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-var D;
-function le() {
-  return D || (D = 1, process.env.NODE_ENV !== "production" && function() {
-    function t(e) {
+var T = {};
+var W;
+function de() {
+  return W || (W = 1, process.env.NODE_ENV !== "production" && (function() {
+    function r(e) {
       if (e == null) return null;
       if (typeof e == "function")
-        return e.$$typeof === K ? null : e.displayName || e.name || null;
+        return e.$$typeof === te ? null : e.displayName || e.name || null;
       if (typeof e == "string") return e;
       switch (e) {
-        case p:
+        case O:
           return "Fragment";
-        case z:
+        case G:
           return "Profiler";
-        case J:
+        case V:
           return "StrictMode";
-        case X:
+        case Z:
           return "Suspense";
-        case B:
+        case K:
           return "SuspenseList";
-        case Z:
+        case re:
           return "Activity";
       }
       if (typeof e == "object")
         switch (typeof e.tag == "number" && console.error(
           "Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."
         ), e.$$typeof) {
-          case q:
+          case z:
             return "Portal";
-          case V:
+          case H:
             return (e.displayName || "Context") + ".Provider";
-          case Q:
+          case X:
             return (e._context.displayName || "Context") + ".Consumer";
-          case G:
-            var r = e.render;
-            return e = e.displayName, e || (e = r.displayName || r.name || "", e = e !== "" ? "ForwardRef(" + e + ")" : "ForwardRef"), e;
-          case H:
-            return r = e.displayName || null, r !== null ? r : t(e.type) || "Memo";
-          case j:
-            r = e._payload, e = e._init;
+          case B:
+            var t = e.render;
+            return e = e.displayName, e || (e = t.displayName || t.name || "", e = e !== "" ? "ForwardRef(" + e + ")" : "ForwardRef"), e;
+          case ee:
+            return t = e.displayName || null, t !== null ? t : r(e.type) || "Memo";
+          case $:
+            t = e._payload, e = e._init;
             try {
-              return t(e(r));
+              return r(e(t));
             } catch {
             }
         }
       return null;
     }
-    function o(e) {
+    function c(e) {
       return "" + e;
     }
-    function f(e) {
+    function n(e) {
       try {
-        o(e);
-        var r = !1;
+        c(e);
+        var t = !1;
       } catch {
-        r = !0;
+        t = !0;
       }
-      if (r) {
-        r = console;
-        var n = r.error, a = typeof Symbol == "function" && Symbol.toStringTag && e[Symbol.toStringTag] || e.constructor.name || "Object";
-        return n.call(
-          r,
+      if (t) {
+        t = console;
+        var s = t.error, l = typeof Symbol == "function" && Symbol.toStringTag && e[Symbol.toStringTag] || e.constructor.name || "Object";
+        return s.call(
+          t,
           "The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",
-          a
-        ), o(e);
+          l
+        ), c(e);
       }
     }
-    function c(e) {
-      if (e === p) return "<>";
-      if (typeof e == "object" && e !== null && e.$$typeof === j)
+    function u(e) {
+      if (e === O) return "<>";
+      if (typeof e == "object" && e !== null && e.$$typeof === $)
         return "<...>";
       try {
-        var r = t(e);
-        return r ? "<" + r + ">" : "<...>";
+        var t = r(e);
+        return t ? "<" + t + ">" : "<...>";
       } catch {
         return "<...>";
       }
     }
-    function s() {
-      var e = S.A;
+    function o() {
+      var e = P.A;
       return e === null ? null : e.getOwner();
     }
     function i() {
       return Error("react-stack-top-frame");
     }
-    function E(e) {
-      if (g.call(e, "key")) {
-        var r = Object.getOwnPropertyDescriptor(e, "key").get;
-        if (r && r.isReactWarning) return !1;
+    function S(e) {
+      if (N.call(e, "key")) {
+        var t = Object.getOwnPropertyDescriptor(e, "key").get;
+        if (t && t.isReactWarning) return !1;
       }
       return e.key !== void 0;
     }
-    function R(e, r) {
-      function n() {
-        y || (y = !0, console.error(
+    function a(e, t) {
+      function s() {
+        Y || (Y = !0, console.error(
           "%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",
-          r
+          t
         ));
       }
-      n.isReactWarning = !0, Object.defineProperty(e, "key", {
-        get: n,
+      s.isReactWarning = !0, Object.defineProperty(e, "key", {
+        get: s,
         configurable: !0
       });
     }
-    function W() {
-      var e = t(this.type);
-      return C[e] || (C[e] = !0, console.error(
+    function g() {
+      var e = r(this.type);
+      return F[e] || (F[e] = !0, console.error(
         "Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release."
       )), e = this.props.ref, e !== void 0 ? e : null;
     }
-    function U(e, r, n, a, d, l, x, w) {
-      return n = l.ref, e = {
+    function p(e, t, s, l, v, b, y, A) {
+      return s = b.ref, e = {
         $$typeof: h,
         type: e,
-        key: r,
-        props: l,
-        _owner: d
-      }, (n !== void 0 ? n : null) !== null ? Object.defineProperty(e, "ref", {
+        key: t,
+        props: b,
+        _owner: v
+      }, (s !== void 0 ? s : null) !== null ? Object.defineProperty(e, "ref", {
         enumerable: !1,
-        get: W
+        get: g
       }) : Object.defineProperty(e, "ref", { enumerable: !1, value: null }), e._store = {}, Object.defineProperty(e._store, "validated", {
         configurable: !1,
         enumerable: !1,
@@ -226,123 +288,139 @@ function le() {
         configurable: !1,
         enumerable: !1,
         writable: !0,
-        value: x
+        value: y
       }), Object.defineProperty(e, "_debugTask", {
         configurable: !1,
         enumerable: !1,
         writable: !0,
-        value: w
+        value: A
       }), Object.freeze && (Object.freeze(e.props), Object.freeze(e)), e;
     }
-    function P(e, r, n, a, d, l, x, w) {
-      var u = r.children;
-      if (u !== void 0)
-        if (a)
-          if (ee(u)) {
-            for (a = 0; a < u.length; a++)
-              A(u[a]);
-            Object.freeze && Object.freeze(u);
+    function m(e, t, s, l, v, b, y, A) {
+      var f = t.children;
+      if (f !== void 0)
+        if (l)
+          if (ne(f)) {
+            for (l = 0; l < f.length; l++)
+              R(f[l]);
+            Object.freeze && Object.freeze(f);
           } else
             console.error(
               "React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead."
             );
-        else A(u);
-      if (g.call(r, "key")) {
-        u = t(e);
-        var m = Object.keys(r).filter(function(re) {
-          return re !== "key";
+        else R(f);
+      if (N.call(t, "key")) {
+        f = r(e);
+        var _ = Object.keys(t).filter(function(oe) {
+          return oe !== "key";
         });
-        a = 0 < m.length ? "{key: someKey, " + m.join(": ..., ") + ": ...}" : "{key: someKey}", $[u + a] || (m = 0 < m.length ? "{" + m.join(": ..., ") + ": ...}" : "{}", console.error(
+        l = 0 < _.length ? "{key: someKey, " + _.join(": ..., ") + ": ...}" : "{key: someKey}", M[f + l] || (_ = 0 < _.length ? "{" + _.join(": ..., ") + ": ...}" : "{}", console.error(
           `A props object containing a "key" prop is being spread into JSX:
   let props = %s;
   <%s {...props} />
 React keys must be passed directly to JSX without using spread:
   let props = %s;
   <%s key={someKey} {...props} />`,
-          a,
-          u,
-          m,
-          u
-        ), $[u + a] = !0);
+          l,
+          f,
+          _,
+          f
+        ), M[f + l] = !0);
       }
-      if (u = null, n !== void 0 && (f(n), u = "" + n), E(r) && (f(r.key), u = "" + r.key), "key" in r) {
-        n = {};
-        for (var O in r)
-          O !== "key" && (n[O] = r[O]);
-      } else n = r;
-      return u && R(
-        n,
+      if (f = null, s !== void 0 && (n(s), f = "" + s), S(t) && (n(t.key), f = "" + t.key), "key" in t) {
+        s = {};
+        for (var C in t)
+          C !== "key" && (s[C] = t[C]);
+      } else s = t;
+      return f && a(
+        s,
         typeof e == "function" ? e.displayName || e.name || "Unknown" : e
-      ), U(
+      ), p(
         e,
-        u,
-        l,
-        d,
-        s(),
-        n,
-        x,
-        w
+        f,
+        b,
+        v,
+        o(),
+        s,
+        y,
+        A
       );
     }
-    function A(e) {
+    function R(e) {
       typeof e == "object" && e !== null && e.$$typeof === h && e._store && (e._store.validated = 1);
     }
-    var v = te, h = Symbol.for("react.transitional.element"), q = Symbol.for("react.portal"), p = Symbol.for("react.fragment"), J = Symbol.for("react.strict_mode"), z = Symbol.for("react.profiler"), Q = Symbol.for("react.consumer"), V = Symbol.for("react.context"), G = Symbol.for("react.forward_ref"), X = Symbol.for("react.suspense"), B = Symbol.for("react.suspense_list"), H = Symbol.for("react.memo"), j = Symbol.for("react.lazy"), Z = Symbol.for("react.activity"), K = Symbol.for("react.client.reference"), S = v.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, g = Object.prototype.hasOwnProperty, ee = Array.isArray, k = console.createTask ? console.createTask : function() {
+    var E = ae, h = Symbol.for("react.transitional.element"), z = Symbol.for("react.portal"), O = Symbol.for("react.fragment"), V = Symbol.for("react.strict_mode"), G = Symbol.for("react.profiler"), X = Symbol.for("react.consumer"), H = Symbol.for("react.context"), B = Symbol.for("react.forward_ref"), Z = Symbol.for("react.suspense"), K = Symbol.for("react.suspense_list"), ee = Symbol.for("react.memo"), $ = Symbol.for("react.lazy"), re = Symbol.for("react.activity"), te = Symbol.for("react.client.reference"), P = E.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, N = Object.prototype.hasOwnProperty, ne = Array.isArray, j = console.createTask ? console.createTask : function() {
       return null;
     };
-    v = {
+    E = {
       react_stack_bottom_frame: function(e) {
         return e();
       }
     };
-    var y, C = {}, N = v.react_stack_bottom_frame.bind(
-      v,
+    var Y, F = {}, I = E.react_stack_bottom_frame.bind(
+      E,
       i
-    )(), Y = k(c(i)), $ = {};
-    b.Fragment = p, b.jsx = function(e, r, n, a, d) {
-      var l = 1e4 > S.recentlyCreatedOwnerStacks++;
-      return P(
+    )(), Q = j(u(i)), M = {};
+    T.Fragment = O, T.jsx = function(e, t, s, l, v) {
+      var b = 1e4 > P.recentlyCreatedOwnerStacks++;
+      return m(
         e,
-        r,
-        n,
+        t,
+        s,
         !1,
-        a,
-        d,
-        l ? Error("react-stack-top-frame") : N,
-        l ? k(c(e)) : Y
+        l,
+        v,
+        b ? Error("react-stack-top-frame") : I,
+        b ? j(u(e)) : Q
       );
-    }, b.jsxs = function(e, r, n, a, d) {
-      var l = 1e4 > S.recentlyCreatedOwnerStacks++;
-      return P(
+    }, T.jsxs = function(e, t, s, l, v) {
+      var b = 1e4 > P.recentlyCreatedOwnerStacks++;
+      return m(
         e,
-        r,
-        n,
+        t,
+        s,
         !0,
-        a,
-        d,
-        l ? Error("react-stack-top-frame") : N,
-        l ? k(c(e)) : Y
+        l,
+        v,
+        b ? Error("react-stack-top-frame") : I,
+        b ? j(u(e)) : Q
       );
     };
-  }()), b;
+  })()), T;
 }
-var L;
-function fe() {
-  return L || (L = 1, process.env.NODE_ENV === "production" ? T.exports = ie() : T.exports = le()), T.exports;
+var U;
+function me() {
+  return U || (U = 1, process.env.NODE_ENV === "production" ? k.exports = fe() : k.exports = de()), k.exports;
 }
-var de = fe();
-function be({ stores: t, children: o }) {
-  return /* @__PURE__ */ de.jsx(M.Provider, { value: { stores: t }, children: o });
+var Ee = me();
+function ge({ stores: r, children: c }) {
+  try {
+    if (!r || typeof r != "object") {
+      const n = "QuantaProvider: Invalid stores prop provided";
+      throw d.error(n), new Error(n);
+    }
+    for (const [n, u] of Object.entries(r))
+      if (!u || typeof u != "object") {
+        const o = `QuantaProvider: Invalid store "${n}" provided`;
+        throw d.error(o), new Error(o);
+      }
+    return /* @__PURE__ */ Ee.jsx(q.Provider, { value: { stores: r }, children: c });
+  } catch (n) {
+    throw d.error(
+      `QuantaProvider: Failed to render provider: ${n instanceof Error ? n.message : String(n)}`
+    ), n;
+  }
 }
 export {
-  M as QuantaContext,
-  be as QuantaProvider,
-  pe as computed,
-  Se as createStore,
-  ke as reactive,
-  _e as useCreateStore,
-  ce as useQuantaContext,
-  I as useQuantaStore,
-  Re as useStore,
-  xe as watch
+  q as QuantaContext,
+  ge as QuantaProvider,
+  _e as computed,
+  we as createStore,
+  Te as logger,
+  xe as reactive,
+  Se as useCreateStore,
+  le as useQuantaContext,
+  D as useQuantaStore,
+  ve as useStore,
+  ke as watch
 };

package/package.json

@@ -22,7 +22,7 @@
     "url": "https://github.com/quanta-js/quanta/issues"
   },
   "homepage": "https://quantajs.com",
-  "version": "2.0.0-beta.2",
+  "version": "2.0.0-beta.4",
   "type": "module",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -43,10 +43,10 @@
     "react": ">=16.8.0"
   },
   "dependencies": {
-    "@quantajs/core": "2.0.0-beta.2"
+    "@quantajs/core": "2.0.0-beta.4"
   },
   "devDependencies": {
-    "@types/react": "^19.1.9",
+    "@types/react": "^19.1.13",
     "react": "^19.1.1"
   },
   "publishConfig": {

package/readme.md

@@ -1,140 +1,140 @@
-# @quantajs/react
-
-![Logo](https://raw.githubusercontent.com/quanta-js/quanta/master/assets/quantajs_banner.png)
-
-React integration for QuantaJS - A compact, scalable, and developer-friendly state management library for React applications.
-
-## 🚀 Features
-
-✅ **React Optimized** – Built specifically for React applications  
-✅ **Performance First** – Uses `useSyncExternalStore` for efficient updates  
-✅ **Type-Safe** – Full TypeScript support with proper inference  
-✅ **Flexible** – Multiple usage patterns (Provider, Direct, Selectors)  
-✅ **QuantaJS Core** – Direct access to reactive, computed, and watch
-
-## 📦 Installation
-
-```sh
-npm install @quantajs/react @quantajs/core
-# or
-yarn add @quantajs/react @quantajs/core
-# or
-pnpm add @quantajs/react @quantajs/core
-```
-
-## ⚡ Quick Start
-
-### Basic Counter Example
-
-```tsx
-import React from 'react';
-import { createStore, QuantaProvider, useStore } from '@quantajs/react';
-
-// Create store
-const counterStore = createStore('counter', {
-    state: () => ({ count: 0 }),
-    getters: {
-        doubleCount: (state) => state.count * 2,
-    },
-    actions: {
-        increment() {
-            this.count++;
-        },
-        decrement() {
-            this.count--;
-        },
-    },
-});
-
-// Component
-function Counter() {
-    const store = useStore();
-
-    return (
-        <div>
-            <p>Count: {store.count}</p>
-            <p>Double: {store.doubleCount}</p>
-            <button onClick={() => store.increment()}>+</button>
-            <button onClick={() => store.decrement()}>-</button>
-        </div>
-    );
-}
-
-// App
-function App() {
-    return (
-        <QuantaProvider store={counterStore}>
-            <Counter />
-        </QuantaProvider>
-    );
-}
-```
-
-### With Selectors (Performance)
-
-```tsx
-import { useQuantaStore } from '@quantajs/react';
-
-function CounterDisplay() {
-    // Only re-render when count changes
-    const count = useQuantaStore(counterStore, (store) => store.count);
-
-    return <p>Count: {count}</p>;
-}
-```
-
-### Component-Scoped Store
-
-```tsx
-import { useCreateStore } from '@quantajs/react';
-
-function TodoComponent() {
-    const todoStore = useCreateStore(
-        'todos',
-        () => ({ todos: [] }),
-        undefined,
-        {
-            addTodo(text: string) {
-                this.todos.push({ id: Date.now(), text, done: false });
-            },
-        },
-    );
-
-    return (
-        <div>
-            <button onClick={() => todoStore.addTodo('New task')}>
-                Add Todo
-            </button>
-            <p>Todos: {todoStore.todos.length}</p>
-        </div>
-    );
-}
-```
-
-## 🔧 API
-
-### Hooks
-
-- `useQuantaStore(store, selector?)` - Subscribe to store with optional selector
-- `useStore(selector?)` - Access store from QuantaProvider context
-- `useCreateStore(name, state, getters?, actions?)` - Create component-scoped store
-
-### Components
-
-- `<QuantaProvider store={store}>` - Provide store to child components
-
-### Core Features
-
-- `createStore`, `reactive`, `computed`, `watch` - Re-exported from @quantajs/core
-
-## 📜 License
-
-This project is licensed under the MIT [License](https://github.com/quanta-js/quanta/blob/main/LICENSE) - see the LICENSE file for details.
-
-## 💬 Contributing
-
-We welcome contributions! Feel free to open issues, submit PRs, or suggest improvements.
-
-## ⭐ Support
-
-If you find this library useful, consider giving it a ⭐ star on [GitHub](https://github.com/quanta-js/quanta)!
+# @quantajs/react
+
+![Logo](https://raw.githubusercontent.com/quanta-js/quanta/master/assets/quantajs_banner.png)
+
+React integration for QuantaJS - A compact, scalable, and developer-friendly state management library for React applications.
+
+## 🚀 Features
+
+✅ **React Optimized** – Built specifically for React applications  
+✅ **Performance First** – Uses `useSyncExternalStore` for efficient updates  
+✅ **Type-Safe** – Full TypeScript support with proper inference  
+✅ **Flexible** – Multiple usage patterns (Provider, Direct, Selectors)  
+✅ **QuantaJS Core** – Direct access to reactive, computed, and watch
+
+## 📦 Installation
+
+```sh
+npm install @quantajs/react @quantajs/core
+# or
+yarn add @quantajs/react @quantajs/core
+# or
+pnpm add @quantajs/react @quantajs/core
+```
+
+## ⚡ Quick Start
+
+### Basic Counter Example
+
+```tsx
+import React from 'react';
+import { createStore, QuantaProvider, useStore } from '@quantajs/react';
+
+// Create store
+const counterStore = createStore('counter', {
+    state: () => ({ count: 0 }),
+    getters: {
+        doubleCount: (state) => state.count * 2,
+    },
+    actions: {
+        increment() {
+            this.count++;
+        },
+        decrement() {
+            this.count--;
+        },
+    },
+});
+
+// Component
+function Counter() {
+    const store = useStore();
+
+    return (
+        <div>
+            <p>Count: {store.count}</p>
+            <p>Double: {store.doubleCount}</p>
+            <button onClick={() => store.increment()}>+</button>
+            <button onClick={() => store.decrement()}>-</button>
+        </div>
+    );
+}
+
+// App
+function App() {
+    return (
+        <QuantaProvider store={counterStore}>
+            <Counter />
+        </QuantaProvider>
+    );
+}
+```
+
+### With Selectors (Performance)
+
+```tsx
+import { useQuantaStore } from '@quantajs/react';
+
+function CounterDisplay() {
+    // Only re-render when count changes
+    const count = useQuantaStore(counterStore, (store) => store.count);
+
+    return <p>Count: {count}</p>;
+}
+```
+
+### Component-Scoped Store
+
+```tsx
+import { useCreateStore } from '@quantajs/react';
+
+function TodoComponent() {
+    const todoStore = useCreateStore(
+        'todos',
+        () => ({ todos: [] }),
+        undefined,
+        {
+            addTodo(text: string) {
+                this.todos.push({ id: Date.now(), text, done: false });
+            },
+        },
+    );
+
+    return (
+        <div>
+            <button onClick={() => todoStore.addTodo('New task')}>
+                Add Todo
+            </button>
+            <p>Todos: {todoStore.todos.length}</p>
+        </div>
+    );
+}
+```
+
+## 🔧 API
+
+### Hooks
+
+- `useQuantaStore(store, selector?)` - Subscribe to store with optional selector
+- `useStore(selector?)` - Access store from QuantaProvider context
+- `useCreateStore(name, state, getters?, actions?)` - Create component-scoped store
+
+### Components
+
+- `<QuantaProvider store={store}>` - Provide store to child components
+
+### Core Features
+
+- `createStore`, `reactive`, `computed`, `watch` - Re-exported from @quantajs/core
+
+## 📜 License
+
+This project is licensed under the MIT [License](https://github.com/quanta-js/quanta/blob/main/LICENSE) - see the LICENSE file for details.
+
+## 💬 Contributing
+
+We welcome contributions! Feel free to open issues, submit PRs, or suggest improvements.
+
+## ⭐ Support
+
+If you find this library useful, consider giving it a ⭐ star on [GitHub](https://github.com/quanta-js/quanta)!