@quantajs/react 2.0.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 QuantaJS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+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.

package/dist/index.cjs

@@ -0,0 +1,52 @@
+/*! MIT License
+
+Copyright (c) 2025 QuantaJS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+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 j=require("react"),W=require("@quantajs/core");function Z(c,l){return j.useSyncExternalStore(c.subscribe,()=>l?l(c):c,()=>l?l(c):c)}const ee=j.createContext(null);function je(){const c=j.useContext(ee);if(!c)throw new Error("useQuantaContext must be used within a QuantaProvider");return c}function pr(c){const{store:l}=je();return c?Z(l,c):Z(l)}function br(c,l,k,E){const R=j.useRef();return R.current||(R.current=W.createStore(c,{state:l,getters:k,actions:E})),R.current}var q={exports:{}},I={};/**
+ * @license React
+ * react-jsx-runtime.production.min.js
+ *
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */var Ce;function gr(){if(Ce)return I;Ce=1;var c=j,l=Symbol.for("react.element"),k=Symbol.for("react.fragment"),E=Object.prototype.hasOwnProperty,R=c.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentOwner,Y={key:!0,ref:!0,__self:!0,__source:!0};function D(m,d,P){var g,h={},S=null,L=null;P!==void 0&&(S=""+P),d.key!==void 0&&(S=""+d.key),d.ref!==void 0&&(L=d.ref);for(g in d)E.call(d,g)&&!Y.hasOwnProperty(g)&&(h[g]=d[g]);if(m&&m.defaultProps)for(g in d=m.defaultProps,d)h[g]===void 0&&(h[g]=d[g]);return{$$typeof:l,type:m,key:S,ref:L,props:h,_owner:R.current}}return I.Fragment=k,I.jsx=D,I.jsxs=D,I}var $={};/**
+ * @license React
+ * react-jsx-runtime.development.js
+ *
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */var we;function yr(){return we||(we=1,process.env.NODE_ENV!=="production"&&function(){var c=j,l=Symbol.for("react.element"),k=Symbol.for("react.portal"),E=Symbol.for("react.fragment"),R=Symbol.for("react.strict_mode"),Y=Symbol.for("react.profiler"),D=Symbol.for("react.provider"),m=Symbol.for("react.context"),d=Symbol.for("react.forward_ref"),P=Symbol.for("react.suspense"),g=Symbol.for("react.suspense_list"),h=Symbol.for("react.memo"),S=Symbol.for("react.lazy"),L=Symbol.for("react.offscreen"),re=Symbol.iterator,ke="@@iterator";function De(e){if(e===null||typeof e!="object")return null;var r=re&&e[re]||e[ke];return typeof r=="function"?r:null}var C=c.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;function v(e){{for(var r=arguments.length,t=new Array(r>1?r-1:0),n=1;n<r;n++)t[n-1]=arguments[n];Fe("error",e,t)}}function Fe(e,r,t){{var n=C.ReactDebugCurrentFrame,i=n.getStackAddendum();i!==""&&(r+="%s",t=t.concat([i]));var u=t.map(function(o){return String(o)});u.unshift("Warning: "+r),Function.prototype.apply.call(console[e],console,u)}}var Ae=!1,Ie=!1,$e=!1,We=!1,Ye=!1,te;te=Symbol.for("react.module.reference");function Le(e){return!!(typeof e=="string"||typeof e=="function"||e===E||e===Y||Ye||e===R||e===P||e===g||We||e===L||Ae||Ie||$e||typeof e=="object"&&e!==null&&(e.$$typeof===S||e.$$typeof===h||e.$$typeof===D||e.$$typeof===m||e.$$typeof===d||e.$$typeof===te||e.getModuleId!==void 0))}function Me(e,r,t){var n=e.displayName;if(n)return n;var i=r.displayName||r.name||"";return i!==""?t+"("+i+")":t}function ne(e){return e.displayName||"Context"}function _(e){if(e==null)return null;if(typeof e.tag=="number"&&v("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),typeof e=="function")return e.displayName||e.name||null;if(typeof e=="string")return e;switch(e){case E:return"Fragment";case k:return"Portal";case Y:return"Profiler";case R:return"StrictMode";case P:return"Suspense";case g:return"SuspenseList"}if(typeof e=="object")switch(e.$$typeof){case m:var r=e;return ne(r)+".Consumer";case D:var t=e;return ne(t._context)+".Provider";case d:return Me(e,e.render,"ForwardRef");case h:var n=e.displayName||null;return n!==null?n:_(e.type)||"Memo";case S:{var i=e,u=i._payload,o=i._init;try{return _(o(u))}catch{return null}}}return null}var T=Object.assign,F=0,ae,oe,ie,ue,se,fe,ce;function le(){}le.__reactDisabledLog=!0;function Ve(){{if(F===0){ae=console.log,oe=console.info,ie=console.warn,ue=console.error,se=console.group,fe=console.groupCollapsed,ce=console.groupEnd;var e={configurable:!0,enumerable:!0,value:le,writable:!0};Object.defineProperties(console,{info:e,log:e,warn:e,error:e,group:e,groupCollapsed:e,groupEnd:e})}F++}}function Ue(){{if(F--,F===0){var e={configurable:!0,enumerable:!0,writable:!0};Object.defineProperties(console,{log:T({},e,{value:ae}),info:T({},e,{value:oe}),warn:T({},e,{value:ie}),error:T({},e,{value:ue}),group:T({},e,{value:se}),groupCollapsed:T({},e,{value:fe}),groupEnd:T({},e,{value:ce})})}F<0&&v("disabledDepth fell below zero. This is a bug in React. Please file an issue.")}}var J=C.ReactCurrentDispatcher,Q;function M(e,r,t){{if(Q===void 0)try{throw Error()}catch(i){var n=i.stack.trim().match(/\n( *(at )?)/);Q=n&&n[1]||""}return`
+`+Q+e}}var B=!1,V;{var Ne=typeof WeakMap=="function"?WeakMap:Map;V=new Ne}function de(e,r){if(!e||B)return"";{var t=V.get(e);if(t!==void 0)return t}var n;B=!0;var i=Error.prepareStackTrace;Error.prepareStackTrace=void 0;var u;u=J.current,J.current=null,Ve();try{if(r){var o=function(){throw Error()};if(Object.defineProperty(o.prototype,"props",{set:function(){throw Error()}}),typeof Reflect=="object"&&Reflect.construct){try{Reflect.construct(o,[])}catch(b){n=b}Reflect.construct(e,[],o)}else{try{o.call()}catch(b){n=b}e.call(o.prototype)}}else{try{throw Error()}catch(b){n=b}e()}}catch(b){if(b&&n&&typeof b.stack=="string"){for(var a=b.stack.split(`
+`),p=n.stack.split(`
+`),s=a.length-1,f=p.length-1;s>=1&&f>=0&&a[s]!==p[f];)f--;for(;s>=1&&f>=0;s--,f--)if(a[s]!==p[f]){if(s!==1||f!==1)do if(s--,f--,f<0||a[s]!==p[f]){var y=`
+`+a[s].replace(" at new "," at ");return e.displayName&&y.includes("<anonymous>")&&(y=y.replace("<anonymous>",e.displayName)),typeof e=="function"&&V.set(e,y),y}while(s>=1&&f>=0);break}}}finally{B=!1,J.current=u,Ue(),Error.prepareStackTrace=i}var x=e?e.displayName||e.name:"",O=x?M(x):"";return typeof e=="function"&&V.set(e,O),O}function qe(e,r,t){return de(e,!1)}function Je(e){var r=e.prototype;return!!(r&&r.isReactComponent)}function U(e,r,t){if(e==null)return"";if(typeof e=="function")return de(e,Je(e));if(typeof e=="string")return M(e);switch(e){case P:return M("Suspense");case g:return M("SuspenseList")}if(typeof e=="object")switch(e.$$typeof){case d:return qe(e.render);case h:return U(e.type,r,t);case S:{var n=e,i=n._payload,u=n._init;try{return U(u(i),r,t)}catch{}}}return""}var A=Object.prototype.hasOwnProperty,ve={},pe=C.ReactDebugCurrentFrame;function N(e){if(e){var r=e._owner,t=U(e.type,e._source,r?r.type:null);pe.setExtraStackFrame(t)}else pe.setExtraStackFrame(null)}function Qe(e,r,t,n,i){{var u=Function.call.bind(A);for(var o in e)if(u(e,o)){var a=void 0;try{if(typeof e[o]!="function"){var p=Error((n||"React class")+": "+t+" type `"+o+"` is invalid; it must be a function, usually from the `prop-types` package, but received `"+typeof e[o]+"`.This often happens because of typos such as `PropTypes.function` instead of `PropTypes.func`.");throw p.name="Invariant Violation",p}a=e[o](r,o,n,t,null,"SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED")}catch(s){a=s}a&&!(a instanceof Error)&&(N(i),v("%s: type specification of %s `%s` is invalid; the type checker function must return `null` or an `Error` but returned a %s. You may have forgotten to pass an argument to the type checker creator (arrayOf, instanceOf, objectOf, oneOf, oneOfType, and shape all require an argument).",n||"React class",t,o,typeof a),N(null)),a instanceof Error&&!(a.message in ve)&&(ve[a.message]=!0,N(i),v("Failed %s type: %s",t,a.message),N(null))}}}var Be=Array.isArray;function K(e){return Be(e)}function Ke(e){{var r=typeof Symbol=="function"&&Symbol.toStringTag,t=r&&e[Symbol.toStringTag]||e.constructor.name||"Object";return t}}function Ge(e){try{return be(e),!1}catch{return!0}}function be(e){return""+e}function ge(e){if(Ge(e))return v("The provided key is an unsupported type %s. This value must be coerced to a string before before using it here.",Ke(e)),be(e)}var ye=C.ReactCurrentOwner,ze={key:!0,ref:!0,__self:!0,__source:!0},he,Ee;function Xe(e){if(A.call(e,"ref")){var r=Object.getOwnPropertyDescriptor(e,"ref").get;if(r&&r.isReactWarning)return!1}return e.ref!==void 0}function He(e){if(A.call(e,"key")){var r=Object.getOwnPropertyDescriptor(e,"key").get;if(r&&r.isReactWarning)return!1}return e.key!==void 0}function Ze(e,r){typeof e.ref=="string"&&ye.current}function er(e,r){{var t=function(){he||(he=!0,v("%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://reactjs.org/link/special-props)",r))};t.isReactWarning=!0,Object.defineProperty(e,"key",{get:t,configurable:!0})}}function rr(e,r){{var t=function(){Ee||(Ee=!0,v("%s: `ref` 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://reactjs.org/link/special-props)",r))};t.isReactWarning=!0,Object.defineProperty(e,"ref",{get:t,configurable:!0})}}var tr=function(e,r,t,n,i,u,o){var a={$$typeof:l,type:e,key:r,ref:t,props:o,_owner:u};return a._store={},Object.defineProperty(a._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:!1}),Object.defineProperty(a,"_self",{configurable:!1,enumerable:!1,writable:!1,value:n}),Object.defineProperty(a,"_source",{configurable:!1,enumerable:!1,writable:!1,value:i}),Object.freeze&&(Object.freeze(a.props),Object.freeze(a)),a};function nr(e,r,t,n,i){{var u,o={},a=null,p=null;t!==void 0&&(ge(t),a=""+t),He(r)&&(ge(r.key),a=""+r.key),Xe(r)&&(p=r.ref,Ze(r,i));for(u in r)A.call(r,u)&&!ze.hasOwnProperty(u)&&(o[u]=r[u]);if(e&&e.defaultProps){var s=e.defaultProps;for(u in s)o[u]===void 0&&(o[u]=s[u])}if(a||p){var f=typeof e=="function"?e.displayName||e.name||"Unknown":e;a&&er(o,f),p&&rr(o,f)}return tr(e,a,p,i,n,ye.current,o)}}var G=C.ReactCurrentOwner,Re=C.ReactDebugCurrentFrame;function w(e){if(e){var r=e._owner,t=U(e.type,e._source,r?r.type:null);Re.setExtraStackFrame(t)}else Re.setExtraStackFrame(null)}var z;z=!1;function X(e){return typeof e=="object"&&e!==null&&e.$$typeof===l}function _e(){{if(G.current){var e=_(G.current.type);if(e)return`
+
+Check the render method of \``+e+"`."}return""}}function ar(e){return""}var me={};function or(e){{var r=_e();if(!r){var t=typeof e=="string"?e:e.displayName||e.name;t&&(r=`
+
+Check the top-level render call using <`+t+">.")}return r}}function Se(e,r){{if(!e._store||e._store.validated||e.key!=null)return;e._store.validated=!0;var t=or(r);if(me[t])return;me[t]=!0;var n="";e&&e._owner&&e._owner!==G.current&&(n=" It was passed a child from "+_(e._owner.type)+"."),w(e),v('Each child in a list should have a unique "key" prop.%s%s See https://reactjs.org/link/warning-keys for more information.',t,n),w(null)}}function Te(e,r){{if(typeof e!="object")return;if(K(e))for(var t=0;t<e.length;t++){var n=e[t];X(n)&&Se(n,r)}else if(X(e))e._store&&(e._store.validated=!0);else if(e){var i=De(e);if(typeof i=="function"&&i!==e.entries)for(var u=i.call(e),o;!(o=u.next()).done;)X(o.value)&&Se(o.value,r)}}}function ir(e){{var r=e.type;if(r==null||typeof r=="string")return;var t;if(typeof r=="function")t=r.propTypes;else if(typeof r=="object"&&(r.$$typeof===d||r.$$typeof===h))t=r.propTypes;else return;if(t){var n=_(r);Qe(t,e.props,"prop",n,e)}else if(r.PropTypes!==void 0&&!z){z=!0;var i=_(r);v("Component %s declared `PropTypes` instead of `propTypes`. Did you misspell the property assignment?",i||"Unknown")}typeof r.getDefaultProps=="function"&&!r.getDefaultProps.isReactClassApproved&&v("getDefaultProps is only used on classic React.createClass definitions. Use a static property named `defaultProps` instead.")}}function ur(e){{for(var r=Object.keys(e.props),t=0;t<r.length;t++){var n=r[t];if(n!=="children"&&n!=="key"){w(e),v("Invalid prop `%s` supplied to `React.Fragment`. React.Fragment can only have `key` and `children` props.",n),w(null);break}}e.ref!==null&&(w(e),v("Invalid attribute `ref` supplied to `React.Fragment`."),w(null))}}var Oe={};function Pe(e,r,t,n,i,u){{var o=Le(e);if(!o){var a="";(e===void 0||typeof e=="object"&&e!==null&&Object.keys(e).length===0)&&(a+=" You likely forgot to export your component from the file it's defined in, or you might have mixed up default and named imports.");var p=ar();p?a+=p:a+=_e();var s;e===null?s="null":K(e)?s="array":e!==void 0&&e.$$typeof===l?(s="<"+(_(e.type)||"Unknown")+" />",a=" Did you accidentally export a JSX literal instead of a component?"):s=typeof e,v("React.jsx: type is invalid -- expected a string (for built-in components) or a class/function (for composite components) but got: %s.%s",s,a)}var f=nr(e,r,t,i,u);if(f==null)return f;if(o){var y=r.children;if(y!==void 0)if(n)if(K(y)){for(var x=0;x<y.length;x++)Te(y[x],e);Object.freeze&&Object.freeze(y)}else v("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 Te(y,e)}if(A.call(r,"key")){var O=_(e),b=Object.keys(r).filter(function(vr){return vr!=="key"}),H=b.length>0?"{key: someKey, "+b.join(": ..., ")+": ...}":"{key: someKey}";if(!Oe[O+H]){var dr=b.length>0?"{"+b.join(": ..., ")+": ...}":"{}";v(`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} />`,H,O,dr,O),Oe[O+H]=!0}}return e===E?ur(f):ir(f),f}}function sr(e,r,t){return Pe(e,r,t,!0)}function fr(e,r,t){return Pe(e,r,t,!1)}var cr=fr,lr=sr;$.Fragment=E,$.jsx=cr,$.jsxs=lr}()),$}var xe;function hr(){return xe||(xe=1,process.env.NODE_ENV==="production"?q.exports=gr():q.exports=yr()),q.exports}var Er=hr();function Rr({store:c,children:l}){return Er.jsx(ee.Provider,{value:{store:c},children:l})}Object.defineProperty(exports,"computed",{enumerable:!0,get:()=>W.computed});Object.defineProperty(exports,"createStore",{enumerable:!0,get:()=>W.createStore});Object.defineProperty(exports,"reactive",{enumerable:!0,get:()=>W.reactive});Object.defineProperty(exports,"watch",{enumerable:!0,get:()=>W.watch});exports.QuantaContext=ee;exports.QuantaProvider=Rr;exports.useCreateStore=br;exports.useQuantaContext=je;exports.useQuantaStore=Z;exports.useStore=pr;

package/dist/index.d.ts

@@ -0,0 +1,81 @@
+import { ActionDefinition } from '@quantajs/core';
+import { computed } from '@quantajs/core';
+import { Context } from 'react';
+import { createStore } from '@quantajs/core';
+import { GetterDefinition } from '@quantajs/core';
+import { JSX as JSX_2 } from 'react/jsx-runtime';
+import { reactive } from '@quantajs/core';
+import { ReactNode } from 'react';
+import { StateDefinition } from '@quantajs/core';
+import { Store } from '@quantajs/core';
+import { StoreInstance } from '@quantajs/core';
+import { StoreSubscriber } from '@quantajs/core';
+import { watch } from '@quantajs/core';
+
+export { ActionDefinition }
+
+export { computed }
+
+export { createStore }
+
+export { GetterDefinition }
+
+export declare const QuantaContext: Context<QuantaContextValue | null>;
+
+declare interface QuantaContextValue {
+    store: StoreInstance<any, any, any>;
+}
+
+/**
+ * Provider component that makes a QuantaJS store available to all child components
+ * @param store - The QuantaJS store instance to provide
+ * @param children - Child components that can access the store
+ */
+export declare function QuantaProvider({ store, children }: QuantaProviderProps): JSX_2.Element;
+
+declare interface QuantaProviderProps {
+    store: StoreInstance<any, any, any>;
+    children: ReactNode;
+}
+
+export { reactive }
+
+export { StateDefinition }
+
+export { Store }
+
+export { StoreInstance }
+
+export { StoreSubscriber }
+
+/**
+ * Hook to create a QuantaJS store instance within a React component
+ * Creates store only once and reuses it across re-renders
+ */
+export declare function useCreateStore<S extends object, G extends object = {}, A extends Record<string, (...args: any[]) => any> = {}>(name: string, state: StateDefinition<S>, getters?: GetterDefinition<S, G>, actions?: ActionDefinition<S, G, A>): StoreInstance<S, G, A>;
+
+/**
+ * Hook to access the QuantaJS store from the context
+ * @returns The store instance from the nearest QuantaProvider
+ * @throws Error if used outside of QuantaProvider
+ */
+export declare function useQuantaContext(): QuantaContextValue;
+
+/**
+ * Hook to subscribe to a QuantaJS store and get reactive updates
+ * Simple implementation that relies on QuantaJS core's reactivity system
+ */
+export declare function useQuantaStore<S extends object, G extends object, A extends object>(store: StoreInstance<S, G, A>): StoreInstance<S, G, A>;
+
+export declare function useQuantaStore<S extends object, G extends object, A extends object, T = any>(store: StoreInstance<S, G, A>, selector: (store: StoreInstance<S, G, A>) => T): T;
+
+/**
+ * Hook to access and subscribe to the QuantaJS store from context
+ * @param selector - Optional selector function to pick specific parts of the store
+ * @returns The store instance or selected value that updates reactively
+ */
+export declare function useStore<T = any>(selector?: (store: StoreInstance<any, any, any>) => T): T extends undefined ? StoreInstance<any, any, any> : T;
+
+export { watch }
+
+export { }

package/dist/index.js

@@ -0,0 +1,693 @@
+/*! MIT License
+
+Copyright (c) 2025 QuantaJS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+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 Pe, { useSyncExternalStore as vr, createContext as dr, useContext as pr, useRef as gr } from "react";
+import { createStore as Er } from "@quantajs/core";
+import { computed as xr, createStore as jr, reactive as kr, watch as Dr } from "@quantajs/core";
+function Te(l, c) {
+  return vr(
+    l.subscribe,
+    () => c ? c(l) : l,
+    () => c ? c(l) : l
+  );
+}
+const we = dr(null);
+function br() {
+  const l = pr(we);
+  if (!l)
+    throw new Error(
+      "useQuantaContext must be used within a QuantaProvider"
+    );
+  return l;
+}
+function Sr(l) {
+  const { store: c } = br();
+  return l ? Te(c, l) : Te(c);
+}
+function Cr(l, c, j, R) {
+  const y = gr();
+  return y.current || (y.current = Er(l, { state: c, getters: j, actions: R })), y.current;
+}
+var U = { exports: {} }, A = {};
+/**
+ * @license React
+ * react-jsx-runtime.production.min.js
+ *
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+var Se;
+function hr() {
+  if (Se) return A;
+  Se = 1;
+  var l = Pe, c = Symbol.for("react.element"), j = Symbol.for("react.fragment"), R = Object.prototype.hasOwnProperty, y = l.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentOwner, $ = { key: !0, ref: !0, __self: !0, __source: !0 };
+  function k(m, v, O) {
+    var E, h = {}, T = null, W = null;
+    O !== void 0 && (T = "" + O), v.key !== void 0 && (T = "" + v.key), v.ref !== void 0 && (W = v.ref);
+    for (E in v) R.call(v, E) && !$.hasOwnProperty(E) && (h[E] = v[E]);
+    if (m && m.defaultProps) for (E in v = m.defaultProps, v) h[E] === void 0 && (h[E] = v[E]);
+    return { $$typeof: c, type: m, key: T, ref: W, props: h, _owner: y.current };
+  }
+  return A.Fragment = j, A.jsx = k, A.jsxs = k, A;
+}
+var I = {};
+/**
+ * @license React
+ * react-jsx-runtime.development.js
+ *
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+var Ce;
+function Rr() {
+  return Ce || (Ce = 1, process.env.NODE_ENV !== "production" && function() {
+    var l = Pe, c = Symbol.for("react.element"), j = Symbol.for("react.portal"), R = Symbol.for("react.fragment"), y = Symbol.for("react.strict_mode"), $ = Symbol.for("react.profiler"), k = Symbol.for("react.provider"), m = Symbol.for("react.context"), v = Symbol.for("react.forward_ref"), O = Symbol.for("react.suspense"), E = Symbol.for("react.suspense_list"), h = Symbol.for("react.memo"), T = Symbol.for("react.lazy"), W = Symbol.for("react.offscreen"), X = Symbol.iterator, xe = "@@iterator";
+    function je(e) {
+      if (e === null || typeof e != "object")
+        return null;
+      var r = X && e[X] || e[xe];
+      return typeof r == "function" ? r : null;
+    }
+    var P = l.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;
+    function d(e) {
+      {
+        for (var r = arguments.length, t = new Array(r > 1 ? r - 1 : 0), n = 1; n < r; n++)
+          t[n - 1] = arguments[n];
+        ke("error", e, t);
+      }
+    }
+    function ke(e, r, t) {
+      {
+        var n = P.ReactDebugCurrentFrame, i = n.getStackAddendum();
+        i !== "" && (r += "%s", t = t.concat([i]));
+        var u = t.map(function(o) {
+          return String(o);
+        });
+        u.unshift("Warning: " + r), Function.prototype.apply.call(console[e], console, u);
+      }
+    }
+    var De = !1, Fe = !1, Ae = !1, Ie = !1, $e = !1, H;
+    H = Symbol.for("react.module.reference");
+    function We(e) {
+      return !!(typeof e == "string" || typeof e == "function" || e === R || e === $ || $e || e === y || e === O || e === E || Ie || e === W || De || Fe || Ae || typeof e == "object" && e !== null && (e.$$typeof === T || e.$$typeof === h || e.$$typeof === k || e.$$typeof === m || e.$$typeof === v || // This needs to include all possible module reference object
+      // types supported by any Flight configuration anywhere since
+      // we don't know which Flight build this will end up being used
+      // with.
+      e.$$typeof === H || e.getModuleId !== void 0));
+    }
+    function Ye(e, r, t) {
+      var n = e.displayName;
+      if (n)
+        return n;
+      var i = r.displayName || r.name || "";
+      return i !== "" ? t + "(" + i + ")" : t;
+    }
+    function Z(e) {
+      return e.displayName || "Context";
+    }
+    function _(e) {
+      if (e == null)
+        return null;
+      if (typeof e.tag == "number" && d("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."), typeof e == "function")
+        return e.displayName || e.name || null;
+      if (typeof e == "string")
+        return e;
+      switch (e) {
+        case R:
+          return "Fragment";
+        case j:
+          return "Portal";
+        case $:
+          return "Profiler";
+        case y:
+          return "StrictMode";
+        case O:
+          return "Suspense";
+        case E:
+          return "SuspenseList";
+      }
+      if (typeof e == "object")
+        switch (e.$$typeof) {
+          case m:
+            var r = e;
+            return Z(r) + ".Consumer";
+          case k:
+            var t = e;
+            return Z(t._context) + ".Provider";
+          case v:
+            return Ye(e, e.render, "ForwardRef");
+          case h:
+            var n = e.displayName || null;
+            return n !== null ? n : _(e.type) || "Memo";
+          case T: {
+            var i = e, u = i._payload, o = i._init;
+            try {
+              return _(o(u));
+            } catch {
+              return null;
+            }
+          }
+        }
+      return null;
+    }
+    var S = Object.assign, D = 0, ee, re, te, ne, ae, oe, ie;
+    function ue() {
+    }
+    ue.__reactDisabledLog = !0;
+    function Le() {
+      {
+        if (D === 0) {
+          ee = console.log, re = console.info, te = console.warn, ne = console.error, ae = console.group, oe = console.groupCollapsed, ie = console.groupEnd;
+          var e = {
+            configurable: !0,
+            enumerable: !0,
+            value: ue,
+            writable: !0
+          };
+          Object.defineProperties(console, {
+            info: e,
+            log: e,
+            warn: e,
+            error: e,
+            group: e,
+            groupCollapsed: e,
+            groupEnd: e
+          });
+        }
+        D++;
+      }
+    }
+    function Ve() {
+      {
+        if (D--, D === 0) {
+          var e = {
+            configurable: !0,
+            enumerable: !0,
+            writable: !0
+          };
+          Object.defineProperties(console, {
+            log: S({}, e, {
+              value: ee
+            }),
+            info: S({}, e, {
+              value: re
+            }),
+            warn: S({}, e, {
+              value: te
+            }),
+            error: S({}, e, {
+              value: ne
+            }),
+            group: S({}, e, {
+              value: ae
+            }),
+            groupCollapsed: S({}, e, {
+              value: oe
+            }),
+            groupEnd: S({}, e, {
+              value: ie
+            })
+          });
+        }
+        D < 0 && d("disabledDepth fell below zero. This is a bug in React. Please file an issue.");
+      }
+    }
+    var N = P.ReactCurrentDispatcher, J;
+    function Y(e, r, t) {
+      {
+        if (J === void 0)
+          try {
+            throw Error();
+          } catch (i) {
+            var n = i.stack.trim().match(/\n( *(at )?)/);
+            J = n && n[1] || "";
+          }
+        return `
+` + J + e;
+      }
+    }
+    var q = !1, L;
+    {
+      var Me = typeof WeakMap == "function" ? WeakMap : Map;
+      L = new Me();
+    }
+    function se(e, r) {
+      if (!e || q)
+        return "";
+      {
+        var t = L.get(e);
+        if (t !== void 0)
+          return t;
+      }
+      var n;
+      q = !0;
+      var i = Error.prepareStackTrace;
+      Error.prepareStackTrace = void 0;
+      var u;
+      u = N.current, N.current = null, Le();
+      try {
+        if (r) {
+          var o = function() {
+            throw Error();
+          };
+          if (Object.defineProperty(o.prototype, "props", {
+            set: function() {
+              throw Error();
+            }
+          }), typeof Reflect == "object" && Reflect.construct) {
+            try {
+              Reflect.construct(o, []);
+            } catch (g) {
+              n = g;
+            }
+            Reflect.construct(e, [], o);
+          } else {
+            try {
+              o.call();
+            } catch (g) {
+              n = g;
+            }
+            e.call(o.prototype);
+          }
+        } else {
+          try {
+            throw Error();
+          } catch (g) {
+            n = g;
+          }
+          e();
+        }
+      } catch (g) {
+        if (g && n && typeof g.stack == "string") {
+          for (var a = g.stack.split(`
+`), p = n.stack.split(`
+`), s = a.length - 1, f = p.length - 1; s >= 1 && f >= 0 && a[s] !== p[f]; )
+            f--;
+          for (; s >= 1 && f >= 0; s--, f--)
+            if (a[s] !== p[f]) {
+              if (s !== 1 || f !== 1)
+                do
+                  if (s--, f--, f < 0 || a[s] !== p[f]) {
+                    var b = `
+` + a[s].replace(" at new ", " at ");
+                    return e.displayName && b.includes("<anonymous>") && (b = b.replace("<anonymous>", e.displayName)), typeof e == "function" && L.set(e, b), b;
+                  }
+                while (s >= 1 && f >= 0);
+              break;
+            }
+        }
+      } finally {
+        q = !1, N.current = u, Ve(), Error.prepareStackTrace = i;
+      }
+      var x = e ? e.displayName || e.name : "", C = x ? Y(x) : "";
+      return typeof e == "function" && L.set(e, C), C;
+    }
+    function Ue(e, r, t) {
+      return se(e, !1);
+    }
+    function Ne(e) {
+      var r = e.prototype;
+      return !!(r && r.isReactComponent);
+    }
+    function V(e, r, t) {
+      if (e == null)
+        return "";
+      if (typeof e == "function")
+        return se(e, Ne(e));
+      if (typeof e == "string")
+        return Y(e);
+      switch (e) {
+        case O:
+          return Y("Suspense");
+        case E:
+          return Y("SuspenseList");
+      }
+      if (typeof e == "object")
+        switch (e.$$typeof) {
+          case v:
+            return Ue(e.render);
+          case h:
+            return V(e.type, r, t);
+          case T: {
+            var n = e, i = n._payload, u = n._init;
+            try {
+              return V(u(i), r, t);
+            } catch {
+            }
+          }
+        }
+      return "";
+    }
+    var F = Object.prototype.hasOwnProperty, fe = {}, le = P.ReactDebugCurrentFrame;
+    function M(e) {
+      if (e) {
+        var r = e._owner, t = V(e.type, e._source, r ? r.type : null);
+        le.setExtraStackFrame(t);
+      } else
+        le.setExtraStackFrame(null);
+    }
+    function Je(e, r, t, n, i) {
+      {
+        var u = Function.call.bind(F);
+        for (var o in e)
+          if (u(e, o)) {
+            var a = void 0;
+            try {
+              if (typeof e[o] != "function") {
+                var p = Error((n || "React class") + ": " + t + " type `" + o + "` is invalid; it must be a function, usually from the `prop-types` package, but received `" + typeof e[o] + "`.This often happens because of typos such as `PropTypes.function` instead of `PropTypes.func`.");
+                throw p.name = "Invariant Violation", p;
+              }
+              a = e[o](r, o, n, t, null, "SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED");
+            } catch (s) {
+              a = s;
+            }
+            a && !(a instanceof Error) && (M(i), d("%s: type specification of %s `%s` is invalid; the type checker function must return `null` or an `Error` but returned a %s. You may have forgotten to pass an argument to the type checker creator (arrayOf, instanceOf, objectOf, oneOf, oneOfType, and shape all require an argument).", n || "React class", t, o, typeof a), M(null)), a instanceof Error && !(a.message in fe) && (fe[a.message] = !0, M(i), d("Failed %s type: %s", t, a.message), M(null));
+          }
+      }
+    }
+    var qe = Array.isArray;
+    function B(e) {
+      return qe(e);
+    }
+    function Be(e) {
+      {
+        var r = typeof Symbol == "function" && Symbol.toStringTag, t = r && e[Symbol.toStringTag] || e.constructor.name || "Object";
+        return t;
+      }
+    }
+    function Ke(e) {
+      try {
+        return ce(e), !1;
+      } catch {
+        return !0;
+      }
+    }
+    function ce(e) {
+      return "" + e;
+    }
+    function ve(e) {
+      if (Ke(e))
+        return d("The provided key is an unsupported type %s. This value must be coerced to a string before before using it here.", Be(e)), ce(e);
+    }
+    var de = P.ReactCurrentOwner, Ge = {
+      key: !0,
+      ref: !0,
+      __self: !0,
+      __source: !0
+    }, pe, ge;
+    function Qe(e) {
+      if (F.call(e, "ref")) {
+        var r = Object.getOwnPropertyDescriptor(e, "ref").get;
+        if (r && r.isReactWarning)
+          return !1;
+      }
+      return e.ref !== void 0;
+    }
+    function ze(e) {
+      if (F.call(e, "key")) {
+        var r = Object.getOwnPropertyDescriptor(e, "key").get;
+        if (r && r.isReactWarning)
+          return !1;
+      }
+      return e.key !== void 0;
+    }
+    function Xe(e, r) {
+      typeof e.ref == "string" && de.current;
+    }
+    function He(e, r) {
+      {
+        var t = function() {
+          pe || (pe = !0, d("%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://reactjs.org/link/special-props)", r));
+        };
+        t.isReactWarning = !0, Object.defineProperty(e, "key", {
+          get: t,
+          configurable: !0
+        });
+      }
+    }
+    function Ze(e, r) {
+      {
+        var t = function() {
+          ge || (ge = !0, d("%s: `ref` 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://reactjs.org/link/special-props)", r));
+        };
+        t.isReactWarning = !0, Object.defineProperty(e, "ref", {
+          get: t,
+          configurable: !0
+        });
+      }
+    }
+    var er = function(e, r, t, n, i, u, o) {
+      var a = {
+        // This tag allows us to uniquely identify this as a React Element
+        $$typeof: c,
+        // Built-in properties that belong on the element
+        type: e,
+        key: r,
+        ref: t,
+        props: o,
+        // Record the component responsible for creating this element.
+        _owner: u
+      };
+      return a._store = {}, Object.defineProperty(a._store, "validated", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !0,
+        value: !1
+      }), Object.defineProperty(a, "_self", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !1,
+        value: n
+      }), Object.defineProperty(a, "_source", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !1,
+        value: i
+      }), Object.freeze && (Object.freeze(a.props), Object.freeze(a)), a;
+    };
+    function rr(e, r, t, n, i) {
+      {
+        var u, o = {}, a = null, p = null;
+        t !== void 0 && (ve(t), a = "" + t), ze(r) && (ve(r.key), a = "" + r.key), Qe(r) && (p = r.ref, Xe(r, i));
+        for (u in r)
+          F.call(r, u) && !Ge.hasOwnProperty(u) && (o[u] = r[u]);
+        if (e && e.defaultProps) {
+          var s = e.defaultProps;
+          for (u in s)
+            o[u] === void 0 && (o[u] = s[u]);
+        }
+        if (a || p) {
+          var f = typeof e == "function" ? e.displayName || e.name || "Unknown" : e;
+          a && He(o, f), p && Ze(o, f);
+        }
+        return er(e, a, p, i, n, de.current, o);
+      }
+    }
+    var K = P.ReactCurrentOwner, Ee = P.ReactDebugCurrentFrame;
+    function w(e) {
+      if (e) {
+        var r = e._owner, t = V(e.type, e._source, r ? r.type : null);
+        Ee.setExtraStackFrame(t);
+      } else
+        Ee.setExtraStackFrame(null);
+    }
+    var G;
+    G = !1;
+    function Q(e) {
+      return typeof e == "object" && e !== null && e.$$typeof === c;
+    }
+    function be() {
+      {
+        if (K.current) {
+          var e = _(K.current.type);
+          if (e)
+            return `
+
+Check the render method of \`` + e + "`.";
+        }
+        return "";
+      }
+    }
+    function tr(e) {
+      return "";
+    }
+    var he = {};
+    function nr(e) {
+      {
+        var r = be();
+        if (!r) {
+          var t = typeof e == "string" ? e : e.displayName || e.name;
+          t && (r = `
+
+Check the top-level render call using <` + t + ">.");
+        }
+        return r;
+      }
+    }
+    function Re(e, r) {
+      {
+        if (!e._store || e._store.validated || e.key != null)
+          return;
+        e._store.validated = !0;
+        var t = nr(r);
+        if (he[t])
+          return;
+        he[t] = !0;
+        var n = "";
+        e && e._owner && e._owner !== K.current && (n = " It was passed a child from " + _(e._owner.type) + "."), w(e), d('Each child in a list should have a unique "key" prop.%s%s See https://reactjs.org/link/warning-keys for more information.', t, n), w(null);
+      }
+    }
+    function ye(e, r) {
+      {
+        if (typeof e != "object")
+          return;
+        if (B(e))
+          for (var t = 0; t < e.length; t++) {
+            var n = e[t];
+            Q(n) && Re(n, r);
+          }
+        else if (Q(e))
+          e._store && (e._store.validated = !0);
+        else if (e) {
+          var i = je(e);
+          if (typeof i == "function" && i !== e.entries)
+            for (var u = i.call(e), o; !(o = u.next()).done; )
+              Q(o.value) && Re(o.value, r);
+        }
+      }
+    }
+    function ar(e) {
+      {
+        var r = e.type;
+        if (r == null || typeof r == "string")
+          return;
+        var t;
+        if (typeof r == "function")
+          t = r.propTypes;
+        else if (typeof r == "object" && (r.$$typeof === v || // Note: Memo only checks outer props here.
+        // Inner props are checked in the reconciler.
+        r.$$typeof === h))
+          t = r.propTypes;
+        else
+          return;
+        if (t) {
+          var n = _(r);
+          Je(t, e.props, "prop", n, e);
+        } else if (r.PropTypes !== void 0 && !G) {
+          G = !0;
+          var i = _(r);
+          d("Component %s declared `PropTypes` instead of `propTypes`. Did you misspell the property assignment?", i || "Unknown");
+        }
+        typeof r.getDefaultProps == "function" && !r.getDefaultProps.isReactClassApproved && d("getDefaultProps is only used on classic React.createClass definitions. Use a static property named `defaultProps` instead.");
+      }
+    }
+    function or(e) {
+      {
+        for (var r = Object.keys(e.props), t = 0; t < r.length; t++) {
+          var n = r[t];
+          if (n !== "children" && n !== "key") {
+            w(e), d("Invalid prop `%s` supplied to `React.Fragment`. React.Fragment can only have `key` and `children` props.", n), w(null);
+            break;
+          }
+        }
+        e.ref !== null && (w(e), d("Invalid attribute `ref` supplied to `React.Fragment`."), w(null));
+      }
+    }
+    var _e = {};
+    function me(e, r, t, n, i, u) {
+      {
+        var o = We(e);
+        if (!o) {
+          var a = "";
+          (e === void 0 || typeof e == "object" && e !== null && Object.keys(e).length === 0) && (a += " You likely forgot to export your component from the file it's defined in, or you might have mixed up default and named imports.");
+          var p = tr();
+          p ? a += p : a += be();
+          var s;
+          e === null ? s = "null" : B(e) ? s = "array" : e !== void 0 && e.$$typeof === c ? (s = "<" + (_(e.type) || "Unknown") + " />", a = " Did you accidentally export a JSX literal instead of a component?") : s = typeof e, d("React.jsx: type is invalid -- expected a string (for built-in components) or a class/function (for composite components) but got: %s.%s", s, a);
+        }
+        var f = rr(e, r, t, i, u);
+        if (f == null)
+          return f;
+        if (o) {
+          var b = r.children;
+          if (b !== void 0)
+            if (n)
+              if (B(b)) {
+                for (var x = 0; x < b.length; x++)
+                  ye(b[x], e);
+                Object.freeze && Object.freeze(b);
+              } else
+                d("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
+              ye(b, e);
+        }
+        if (F.call(r, "key")) {
+          var C = _(e), g = Object.keys(r).filter(function(cr) {
+            return cr !== "key";
+          }), z = g.length > 0 ? "{key: someKey, " + g.join(": ..., ") + ": ...}" : "{key: someKey}";
+          if (!_e[C + z]) {
+            var lr = g.length > 0 ? "{" + g.join(": ..., ") + ": ...}" : "{}";
+            d(`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} />`, z, C, lr, C), _e[C + z] = !0;
+          }
+        }
+        return e === R ? or(f) : ar(f), f;
+      }
+    }
+    function ir(e, r, t) {
+      return me(e, r, t, !0);
+    }
+    function ur(e, r, t) {
+      return me(e, r, t, !1);
+    }
+    var sr = ur, fr = ir;
+    I.Fragment = R, I.jsx = sr, I.jsxs = fr;
+  }()), I;
+}
+var Oe;
+function yr() {
+  return Oe || (Oe = 1, process.env.NODE_ENV === "production" ? U.exports = hr() : U.exports = Rr()), U.exports;
+}
+var _r = yr();
+function Or({ store: l, children: c }) {
+  return /* @__PURE__ */ _r.jsx(we.Provider, { value: { store: l }, children: c });
+}
+export {
+  we as QuantaContext,
+  Or as QuantaProvider,
+  xr as computed,
+  jr as createStore,
+  kr as reactive,
+  Cr as useCreateStore,
+  br as useQuantaContext,
+  Te as useQuantaStore,
+  Sr as useStore,
+  Dr as watch
+};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@quantajs/react",
+  "private": false,
+  "author": {
+    "name": "Jeel Gajera",
+    "url": "https://github.com/JeelGajera"
+  },
+  "description": "React integration for QuantaJS - A compact, scalable, and developer-friendly state management library for React applications.",
+  "keywords": [
+    "quantajs",
+    "quanta",
+    "state-management",
+    "reactivity",
+    "react",
+    "hooks"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/quanta-js/quanta.git"
+  },
+  "bugs": {
+    "url": "https://github.com/quanta-js/quanta/issues"
+  },
+  "homepage": "https://quantajs.com",
+  "version": "2.0.0-beta.1",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "dependencies": {
+    "@quantajs/core": "2.0.0-beta.1"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.12",
+    "react": "^18.3.1"
+  },
+  "scripts": {
+    "dev": "npm run format && npm run lint:fix && npm run build",
+    "build": "npm run clean && vite build",
+    "preview": "vite preview",
+    "clean": "rimraf dist",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "lint:fix": "eslint \"src/**/*.{ts,tsx}\" --fix",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  }
+}

package/readme.md

@@ -0,0 +1,133 @@
+# @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)!