orchestore 0.1.1 → 0.1.2

package/README.md

@@ -2,7 +2,11 @@
 
 ### 🚧 Coming Soon
 
-> OrcheStore is currently under active development and is not yet ready for production use.
+OrcheStore is currently under active development and is not yet ready for production use.
+
+> 📅 **Planned First Stable Release:** **2026-06-30**
+
+> ⚠️ APIs, behavior, and internal implementation details may change without notice until the first stable release.
 
 ---
 
@@ -28,3 +32,27 @@ The goal is simple:
 - Preserve predictable state transitions
 - Maintain strong TypeScript inference
 - Scale naturally through composition
+
+---
+
+## Release Status
+
+### Pre-release Notice
+
+OrcheStore is currently in a pre-release phase.
+
+- Not recommended for production use
+- APIs may change before the first stable release
+- Internal architecture and runtime behavior are still evolving
+- Documentation and feature coverage are actively being expanded
+
+### Roadmap
+
+| Milestone            | Status         |
+| -------------------- | -------------- |
+| Core Architecture    | 🚧 In Progress |
+| Documentation        | 🚧 In Progress |
+| Public Preview       | 🚧 Planned     |
+| First Stable Release | 📅 2026-06-30  |
+
+Stay tuned for updates.

package/dist/index.cjs

@@ -1,13 +1,22 @@
-"use strict";var E=Object.create;var a=Object.defineProperty;var I=Object.getOwnPropertyDescriptor;var K=Object.getOwnPropertyNames;var N=Object.getPrototypeOf,q=Object.prototype.hasOwnProperty;var F=(e,t)=>{for(var r in t)a(e,r,{get:t[r],enumerable:!0})},O=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of K(t))!q.call(e,o)&&o!==r&&a(e,o,{get:()=>t[o],enumerable:!(n=I(t,o))||n.enumerable});return e};var V=(e,t,r)=>(r=e!=null?E(N(e)):{},O(t||!e||!e.__esModule?a(r,"default",{value:e,enumerable:!0}):r,e)),_=e=>O(a({},"__esModule",{value:!0}),e);var Z={};F(Z,{StoreProvider:()=>m,createSlice:()=>f,createStore:()=>S,default:()=>Y,getGlobalUtils:()=>v,provideGlobalUtils:()=>P});module.exports=_(Z);var R=require("@reduxjs/toolkit");var U=require("@reduxjs/toolkit"),G=[];function C(e){return G.find(t=>t.slice===e)?.redux}function f(e){let t=e,r=(0,U.createSlice)({name:e.name,initialState:e.state,reducers:e.mutations});return G.push({slice:t,redux:r}),t}var g=typeof globalThis<"u"&&typeof globalThis.process<"u"&&globalThis.process?.env?.NODE_ENV!=="production",h=!1,D=globalThis.console?.log?.bind?.(globalThis.console)||globalThis.console?.log,J=globalThis.console?.warn?.bind?.(globalThis.console)||globalThis.console?.warn,W=globalThis.console?.error?.bind?.(globalThis.console)||globalThis.console?.error,X=globalThis.console?.clear?.bind?.(globalThis.console)||globalThis.console?.clear;globalThis.console?.clear&&(globalThis.console.clear=(...e)=>{h=!1,X?.(...e)});var $=`[OrcheStore] Development diagnostics are enabled.
-Warnings and errors from OrcheStore are not shown in production builds.
-Runtime exceptions that stop code execution may still occur.
+"use strict";var ee=Object.create;var R=Object.defineProperty;var te=Object.getOwnPropertyDescriptor;var re=Object.getOwnPropertyNames;var oe=Object.getPrototypeOf,ne=Object.prototype.hasOwnProperty;var ie=(e,t)=>{for(var r in t)R(e,r,{get:t[r],enumerable:!0})},z=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of re(t))!ne.call(e,o)&&o!==r&&R(e,o,{get:()=>t[o],enumerable:!(n=te(t,o))||n.enumerable});return e};var se=(e,t,r)=>(r=e!=null?ee(oe(e)):{},z(t||!e||!e.__esModule?R(r,"default",{value:e,enumerable:!0}):r,e)),ae=e=>z(R({},"__esModule",{value:!0}),e);var ve={};ie(ve,{StoreProvider:()=>G,configureDiagnostics:()=>U,createSlice:()=>L,createStore:()=>k,default:()=>xe,getGlobalUtils:()=>y,provideGlobalUtils:()=>q});module.exports=ae(ve);var Q=require("@reduxjs/toolkit");var E=require("@reduxjs/toolkit"),_=require("react-redux");var g={target:({slice:e})=>e?` Affected slice '${e}':
+`:" ",RequiredName:e=>`[OrcheStore::${e.module}]${g.target(e)}${e.type} keys must be non-empty strings.`,InvalidName:(e,t)=>`[OrcheStore::${e.module}]${g.target(e)}${e.type} names cannot contain '.' or '/'. Received: ${t}.`,ReservedKey:(e,t)=>`[OrcheStore::${e.module}]${g.target(e)}'${t}' is a reserved name and cannot be used as a ${e.type} key.`,DuplicateKey:(e,t)=>`[OrcheStore::${e.module}]${g.target(e)}${e.type} name '${t}' conflicts with another member.`},F=(e,t)=>{if(e)if(t==="warn")console.warn(e);else if(t==="error")console.error(e);else throw new Error(e);else return!1},D=(e,t="",r="",n)=>typeof e!="string"||!e?!!F(t,n?.[0]):e.includes(".")||e.includes("/")?!!F(r,n?.[1]):!0,ce=(e,t,r)=>{let[n,o]=[g.RequiredName(e),g.InvalidName(e,t)];if(D(t,n,o,["error","error"])){if(r[0].includes(t))return console.error(g.ReservedKey(e,t));if(r[1].includes(t))return console.error(g.DuplicateKey(e,t))}else return;return!0},C=(e,t,r,n)=>(Object.entries(t).forEach(([o,c])=>{let s=ce(e,o,r)?n(o,c):void 0;if(s===void 0)return delete t[o];t[o]=s,r[1].push(o)}),t);var x="all",$={diagnostics:!1,prerelease:!1},J=globalThis.console?.log?.bind?.(globalThis.console)||globalThis.console?.log,le=globalThis.console?.warn?.bind?.(globalThis.console)||globalThis.console?.warn,de=globalThis.console?.error?.bind?.(globalThis.console)||globalThis.console?.error,ue=globalThis.console?.clear?.bind?.(globalThis.console)||globalThis.console?.clear;globalThis.console?.clear&&(globalThis.console.clear=(...e)=>{$.diagnostics=!1,ue?.(...e)});var pe=`[OrcheStore] \u{1F6A7} Pre-release Notice
+Thank you for your interest in OrcheStore.
+OrcheStore is currently under active development and is not yet ready for production use.
+APIs, behavior, and internal implementation details may change without notice.
+The first stable release is currently planned for 2026-06-30.
+Stay tuned for updates!
+`,fe=`[OrcheStore] Diagnostics are enabled.
+OrcheStore may emit warnings and errors to help identify incorrect usage, invalid configurations, and potential runtime issues.
+Runtime exceptions that stop code execution may still occur regardless of diagnostics settings.
 Please resolve all OrcheStore warnings and errors before deploying to production.
-`,y=()=>{h||(h=!0,D?.($))},i={log(...e){g&&(y(),D?.(...e))},warn(...e){g&&(y(),J?.(...e))},error(...e){g&&(y(),W?.(...e))}};var d=[];function A(e){return d.find(t=>t.store===e)?.redux}function S({slices:e}){if(d.length===1)return i.warn(`[OrcheStore] createStore(...) was called more than once.
+Diagnostics can be configured with configureDiagnostics("off" | "errors" | "all").
+`,i={inform(e){$[e]||($[e]=!0,x==="all"&&J?.(e==="prerelease"?pe:fe))},log(...e){x==="all"&&(i.inform("diagnostics"),J?.(...e))},warn(...e){x==="all"&&(i.inform("diagnostics"),le?.(...e))},error(...e){x!=="off"&&(i.inform("diagnostics"),de?.(...e))}};function U(e){x=e}var v=se(require("react"),1),P=require("react-redux");var I=[];function V(e){let t=I.find(r=>r.store===e);if(t)return t.dispatch;throw new Error("[OrcheStore] Using OrcheStore requires wrapping your application with <StoreProvider>.")}function me({store:e,children:t}){let r=(0,P.useDispatch)(),n=I.find(o=>o.store===e);return n||I.push(n={store:e,dispatch:r}),n.dispatch=r,v.default.createElement(v.default.Fragment,null,t)}function G(e){let{store:t,stabilityCheck:r,identityFunctionCheck:n}={...e||{}},o=M(t);if(!o)throw new Error("[OrcheStore::context] <StoreProvider> requires a store instance created with createStore(...).");return v.default.createElement(P.Provider,{stabilityCheck:r,identityFunctionCheck:n,store:o},v.default.createElement(me,{...e}))}var he=Object.assign,A=Object.getOwnPropertyDescriptor(Object,"defineProperty")?.value||Object.defineProperty,ge=(e,t,r)=>{A(e,t,{get:r,enumerable:!0,configurable:!1})},Se=(e,t,r)=>{A(e,t,{value:r,writable:!1,enumerable:!0,configurable:!1})},m={assign:he,defineProp:A,defineReadonly:ge,defineMethod:Se},W={isArray:Array.isArray},T={get:Reflect.get,set:Reflect.set,delete:Reflect.deleteProperty};var w={GetMissingProp:e=>["[OrcheStore::global-utils] Attempted to access a global utility before it became available. Missing property",e,`
+If this utility is optional, register it as undefined using provideGlobalUtils(...) to suppress future warnings.
+`],DeleteProp:e=>["[OrcheStore::global-utils] Avoid deleting properties. Trying to delete property",e,`
+Use provideGlobalUtils(...) to set them to undefined instead for type safety.
+`],InvalidArgs:"[OrcheStore::global-utils] Expected provideGlobalUtils(...) to receive a non-null object. Received:"},K=new Proxy({},{get(e,t,r){return t in e||i.error(...w.GetMissingProp(t)),T.get(e,t,r)},set(e,t,r,n){return T.set(e,t,r,n)},deleteProperty(e,t){return i.warn(...w.DeleteProp(t)),T.delete(e,t)}});function y(){return K}function q(e){return e==null?i.error(w.InvalidArgs,e):W.isArray(e)?i.error(w.InvalidArgs,"(type: array)",e):typeof e!="object"?i.error(w.InvalidArgs,`(type: ${typeof e})`,e):m.assign(K,e),K}function b(e,t){let r={};return Object.keys(e).filter(o=>o.startsWith(t)).map(o=>o.split(".")).sort((o,c)=>o.length-c.length).forEach(o=>{let c=r;o.slice(0,o.length-1).forEach(s=>c=c[s]||={}),c[o[o.length-1]]={...e[o.join(".")]}}),r}function X(e,t){return t.split(".").forEach(r=>e=e[r]),e}var B=[];function N(e){return B.find(t=>t.slice===e)}function L(e){i.inform("prerelease");let t={},r=ye(e),n=["name","path","state","computed","root","global","useSelect"],o=[],c=a=>({module:"createSlice",type:a,slice:r.name}),s=a=>({root:u(),rootState:a,global:y()}),u=()=>{let a=H();if(!a)throw new Error(d.RequiredStore(r.name));return a};C(c("mutation"),r.mutations,[n,o],(a,l)=>l?._reducerDefinitionType===E.ReducerType.asyncThunk||"reducer"in{...l||{}}?i.error(d.ReduxReducerConflict()):typeof l!="function"?i.error(d.InvalidMutation(a)):((j,Z)=>l(j,...Z.payload)));let p=(0,E.createSlice)({name:r.name,reducerPath:r.name,initialState:r.state,reducers:r.mutations}),h={path:r.name,slice:t,redux:p,children:{}};return m.defineReadonly(t,"name",()=>r.name),m.defineReadonly(t,"path",()=>h.path),m.defineReadonly(t,"global",()=>y()),m.defineMethod(t,"getState",()=>b(M(u()).getState(),h.path)),m.defineMethod(t,"useSelect",a=>(0,_.useSelector)(l=>{let f=s(b(l,""));return a.call(f,X(f.rootState,t.path),f)})),Object.entries(p.actions).map(([a,l])=>{t[a]=(...f)=>V(u())(l(f))}),C(c("method"),r.methods,[n,o],(a,l)=>typeof l!="function"?i.error(d.InvalidMethod(a)):t[a]=(...f)=>l.apply(t,f)),C(c("children"),r.children,[n,o],(a,l)=>N(l)?h.children[a]=l:i.error(d.InvalidChild(a))),Object.keys(r.computed).length>0&&i.warn("[OrcheStore::createSlice] Computed properties are not yet supported and will be ignored."),B.push(h),t}var ye=e=>{let t={...e||{}};if(D(t.name,d.RequiredName(),d.InvalidName(t.name)),typeof t.state=="function"){let u=t.state;t.state=()=>{let p=u();if(typeof p!="object")throw new Error(d.InvalidState(t.name));if(!p)throw new Error(d.RequiredState(t.name));return p}}else{if(typeof t.state!="object")throw new Error(d.InvalidState(t.name));if(!t.state)throw new Error(d.RequiredState(t.name))}t.mutations=typeof t.mutations=="object"&&t.mutations?{...t.mutations}:{},t.computed=typeof t.computed=="object"&&t.computed?{...t.computed}:{},t.methods=typeof t.methods=="object"&&t.methods?{...t.methods}:{},t.children=typeof t.children=="object"&&t.children?{...t.children}:{};let{reducers:r,extraReducers:n,reducerPath:o,initialState:c,selectors:s}={...t||{}};return c!==void 0&&i.warn(d.ReduxConflict("initialState")),r!==void 0&&i.warn(d.ReduxConflict("reducers")),n!==void 0&&i.warn(d.ReduxConflict("extraReducers")),o!==void 0&&i.warn(d.ReduxConflict("reducerPath")),s!==void 0&&i.warn(d.ReduxConflict("selectors")),t},d={RequiredName:()=>"[OrcheStore::createSlice] Missing required slice name. Expected a non-empty string.",InvalidName:e=>`[OrcheStore::createSlice] Slice names cannot contain '.' or '/'. Received: {${e}}`,RequiredState:e=>`[OrcheStore::createSlice] Missing required slice state for slice: {${e}}`,InvalidState:e=>`[OrcheStore::createSlice] Slice state must be a non-null object or a function that returns a non-null object. Slice: {${e}}`,ReservedKey:(e,t)=>`[OrcheStore::createSlice] '${t}' is reserved by OrcheStore and should not be provided as a ${e}.`,InvalidMutation:e=>`[OrcheStore::createSlice] Mutation '${e}' must be a function.`,InvalidMethod:e=>`[OrcheStore::createSlice] Method '${e}' must be a function.`,InvalidChild:e=>`[OrcheStore::createSlice] Child slice '${e}' must be a slice object created using createSlice(...).`,RequiredStore:e=>`[OrcheStore::slice-runtime] No root store found for slice: {${e}}. Slices must be created within the context of a store.
+Create a store using createStore(...) and ensure that slices are accessed after the store is initialized.`,ReduxConflict:e=>`[OrcheStore::createSlice] '${e}' is a Redux Toolkit createSlice(...) option and is not applicable to OrcheStore slices. This property will be ignored.`,ReduxReducerConflict:()=>"[OrcheStore::createSlice] Redux Toolkit asyncThunk reducers are not supported in mutations. Use methods instead."};var Y=require("react-redux");var O=[];function M(e){return O.find(t=>t.store===e)?.redux}function H(){return O[0]?.store}function k({slices:e}){if(i.inform("prerelease"),O.length===1)return i.warn(`[OrcheStore::createStore] createStore(...) was called more than once.
 OrcheStore currently supports only a single global store instance and will return the existing store.
 If you are creating a store inside a React component, create it only once, for example:
 const [store] = useState(() => createStore(...));
-Avoid useState(createStore(...)) because createStore(...) will be executed on every render.`),d[0].store;let t={},r={};for(let o in e){let T=e[o],w=C(T);w&&(t[o]=T,r[o]=w.reducer)}let n=(0,R.configureStore)({reducer:r});return d.push({store:t,redux:n}),t}var l=V(require("react"),1),p=require("react-redux");var M=[];function z({store:e,children:t}){let r=(0,p.useDispatch)(),n=M.find(o=>o.store===e);return n||M.push(n={store:e,dispatch:r}),n.dispatch=r,l.default.createElement(l.default.Fragment,null,t)}function m(e){let{store:t,stabilityCheck:r,identityFunctionCheck:n}=e,o=A(t);if(!o)throw new Error("[OrcheStore] <StoreProvider> requires a store instance created with createStore(...).");return l.default.createElement(p.Provider,{stabilityCheck:r,identityFunctionCheck:n,store:o},l.default.createElement(z,{...e}))}var B=Object.assign,b=Object.getOwnPropertyDescriptor(Object,"defineProperty")?.value||Object.defineProperty,H=(e,t,r)=>{b(e,t,{get:r,enumerable:!0,configurable:!1})},L=(e,t,r)=>{b(e,t,{value:r,writable:!1,enumerable:!0,configurable:!1})},k={assign:B,defineProp:b,defineReadonly:H,defineMethod:L},j={isArray:Array.isArray},u={get:Reflect.get,set:Reflect.set,delete:Reflect.deleteProperty};var c={GetMissingProp:e=>["OrcheStore[global-utils] Attempted to access a global utility before it became available. Missing property",e,`
-If this utility is optional, register it as undefined using provideGlobalUtils(...) to suppress future warnings.
-`],DeleteProp:e=>["OrcheStore[global-utils] Avoid deleting properties. Trying to delete property",e,`
-Use provideGlobalUtils(...) to set them to undefined instead for type safety.
-`],InvalidArgs:"OrcheStore[global-utils] Expected provideGlobalUtils(...) to receive a non-null object. Received:"},x=new Proxy({},{get(e,t,r){return t in e||i.error(...c.GetMissingProp(t)),u.get(e,t,r)},set(e,t,r,n){return u.set(e,t,r,n)},deleteProperty(e,t){return i.warn(...c.DeleteProp(t)),u.delete(e,t)}});function v(){return x}function P(e){return e==null?i.error(c.InvalidArgs,e):j.isArray(e)?i.error(c.InvalidArgs,"(type: array)",e):typeof e!="object"?i.error(c.InvalidArgs,`(type: ${typeof e})`,e):k.assign(x,e),x}var Q={createStore:S,createSlice:f,StoreProvider:m,provideGlobalUtils:P,getGlobalUtils:v},Y=Q;0&&(module.exports={StoreProvider,createSlice,createStore,getGlobalUtils,provideGlobalUtils});
+Avoid useState(createStore(...)) because createStore(...) will be executed on every render.`),O[0].store;let t={},r=s=>({root:t,rootState:s,global:y()});m.defineMethod(t,"getState",()=>b(c.getState(),"")),m.defineMethod(t,"useSelect",s=>(0,Y.useSelector)(u=>{let p=r(b(u,""));return s.call(p,p.rootState,p)}));let n={},o=(s,u,p)=>{let h=N(u)||{};if(!h)return;let{redux:a,children:l}=h;h.path=s,n[s]=a.reducer,p[s]=u,Object.entries(l).forEach(([f,j])=>{o(s+"."+f,j,u)})};for(let s in e){let u=e[s];s in t||o(s,u,t)}let c=(0,Q.configureStore)({reducer:n});return O.push({store:t,redux:c}),t}var be={createStore:k,createSlice:L,StoreProvider:G,provideGlobalUtils:q,getGlobalUtils:y,configureDiagnostics:U},xe=be;0&&(module.exports={StoreProvider,configureDiagnostics,createSlice,createStore,getGlobalUtils,provideGlobalUtils});

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import React from 'react';
 import { ProviderProps } from 'react-redux';
 
-type Dict<Value = any> = Record<string | number | symbol, Value>;
+type Dict<Value = any> = Record<string, Value>;
 type Tail<T extends any[]> = T extends [any, ...infer R] ? R : T extends (infer U)[] ? U[] : never;
 type DeepReadonly<T> = T extends (...args: any[]) => any ? T : T extends readonly (infer U)[] ? ReadonlyArray<DeepReadonly<U>> : T extends object ? {
     readonly [K in keyof T]: DeepReadonly<T[K]>;
@@ -26,9 +26,9 @@ type GlobalUtils = Definition<"global", GlobalUtilsRule, any>;
 type RootStore = Definition<"root", RootStoreRule, any>;
 
 /** Reserved slice member names that cannot be overridden by user-defined APIs. */
-type ReservedKeys<R = {}, M = {}> = "name" | "path" | "computed" | "root" | "global" | "getState" | "useSelect" | keyof R | keyof M;
+type ReservedKeys$1<R = {}, M = {}> = "name" | "path" | "computed" | "root" | "global" | "getState" | "useSelect" | keyof R | keyof M;
 /** Defines the mutations available on a slice. */
-type Mutations<S extends Dict> = Dict<(state: Omit<S, "root" | "computed">, ...args: any[]) => void>;
+type Mutations<S extends Dict> = Dict<(state: Omit<S, "computed">, ...args: any[]) => void>;
 /** Defines the computed functions available on a slice. */
 type Computed<S extends Dict, C extends Dict> = Dict<(state: ExposedState<S, C>, ...args: any[]) => any>;
 /** Defines the methods available on a slice with contextual `this` typing. */
@@ -36,7 +36,7 @@ type Methods<Context = any> = Dict<(...args: any[]) => any> & ThisType<Context>;
 /** Defines the child slices nested within a slice. */
 type Children = Dict<slice<any, Mutations<any>, Methods, Dict, Computed<any, any>, any>>;
 /** Exposes immutable slice state with optional runtime helpers. */
-type ExposedState<S extends Dict, C extends Children = Children, Root = {}> = DeepReadonly<Omit<S, "root"> & Root>;
+type ExposedState<S extends Dict, C extends Children = Children> = DeepReadonly<Omit<S, "computed">>;
 /** Runtime slice API exposed by createSlice(...). */
 type slice<S extends Dict = Dict, R extends Mutations<S> = Mutations<S>, M extends Methods = Methods, C extends Children = Children, G extends Computed<S, C> = Computed<S, C>, N extends string = string> = {
     /** Unique slice identifier. */
@@ -51,17 +51,26 @@ type slice<S extends Dict = Dict, R extends Mutations<S> = Mutations<S>, M exten
     };
     /** Returns the latest immutable state snapshot. */
     readonly getState: () => ExposedState<S, C>;
-    /** Subscribes to state changes within React components. */
-    readonly useSelect: <T>(selector: (state: ExposedState<S, C, true>) => T) => T;
+    /** Subscribes to state changes within React components. Runs with a context-bound `this` containing `root` store, `rootState` and `global` utilities. */
+    readonly useSelect: <T>(selector: (this: UseSelectContext<RootStore>, state: ExposedState<S, C>, context: UseSelectContext<any>) => T) => T;
 } & {
     /** Exposed mutation functions. */
-    readonly [K in Exclude<keyof R, ReservedKeys>]: (...args: Tail<Parameters<R[K]>>) => ReturnType<R[K]>;
+    readonly [K in Exclude<keyof R, ReservedKeys$1>]: (...args: Tail<Parameters<R[K]>>) => ReturnType<R[K]>;
 } & {
     /** Exposed method functions. */
-    readonly [K in Exclude<keyof M, ReservedKeys<R>>]: M[K];
+    readonly [K in Exclude<keyof M, ReservedKeys$1<R>>]: M[K];
 } & {
     /** Exposed child slices. */
-    readonly [K in Exclude<keyof C, ReservedKeys<R, M>>]: C[K];
+    readonly [K in Exclude<keyof C, ReservedKeys$1<R, M>>]: C[K];
+};
+/** Context available inside `useSelect`, providing access to the root store, root state snapshot, and global utilities. */
+type UseSelectContext<RootStore extends store> = {
+    /** Root store instance. */
+    root: RootStore;
+    /** Latest root state snapshot. */
+    rootState: ReturnType<RootStore["getState"]>;
+    /** Global utilities shared across slices. */
+    global: GlobalUtils;
 };
 /** Configuration object used to create a slice. */
 type sliceOptions<S extends Dict = Dict, R extends Mutations<S> = Mutations<S>, M extends Methods = Methods, C extends Children = Children, G extends Computed<S, C> = Computed<S, C>, N extends string = string> = {
@@ -81,13 +90,23 @@ type sliceOptions<S extends Dict = Dict, R extends Mutations<S> = Mutations<S>,
     children?: C;
 };
 
-type store = Record<string, slice>;
+/** Reserved store member names that cannot be overridden by user-defined APIs. */
+type ReservedKeys<R = {}, M = {}> = "name" | "path" | "computed" | "root" | "global" | "getState" | "useSelect";
+type store<C extends Children = Children> = {
+    /** Returns the latest immutable state snapshot. */
+    readonly getState: () => ExposedState<{}, C>;
+    /** Subscribes to state changes within React components. Runs with a context-bound `this` containing `global` utilities. */
+    readonly useSelect: <T>(selector: (this: UseSelectContext<RootStore>, state: ExposedState<{}, C>, context: UseSelectContext<any>) => T) => T;
+} & {
+    /** Exposed slices. */
+    readonly [K in Exclude<keyof C, ReservedKeys>]: C[K];
+};
 
 type orchestore = {};
 declare global {
     type OrcheStore = orchestore;
     namespace OrcheStore {
-        type Store = store;
+        type Store<C extends Children = Children> = store<C>;
         /** Runtime slice API exposed by createSlice(...). */
         type Slice<S extends Dict = Dict, R extends Mutations<S> = Mutations<S>, M extends Methods = Methods, C extends Children = Children, G extends Computed<S, C> = Computed<S, C>, N extends string = string> = slice<S, R, M, C, G, N>;
         /** Configuration object used to create a slice. */
@@ -96,15 +115,15 @@ declare global {
 }
 
 /** Creates and initializes an OrcheStore instance. */
-declare function createStore({ slices }: {
-    slices: Record<string, slice>;
-}): store;
+declare function createStore<C extends Children = Children>({ slices }: {
+    slices: C;
+}): store<C>;
 
 /** Creates and initializes an OrcheStore slice. */
-declare function createSlice<S extends Dict = Dict, R extends Mutations<S> = Mutations<S>, M extends Methods = Methods, C extends Children = Children, G extends Computed<S, C> = Computed<S, C>, N extends string = string>(options: sliceOptions<S, R, M, C, G, N>): slice<S, R, M, C, G, N>;
+declare function createSlice<S extends Dict = Dict, R extends Mutations<S> = Mutations<S>, M extends Methods = Methods, C extends Children = Children, G extends Computed<S, C> = Computed<S, C>, N extends string = string>(props: sliceOptions<S, R, M, C, G, N>): slice<S, R, M, C, G, N>;
 
 type StoreProviderProps = Omit<ProviderProps, "store" | "serverState" | "context"> & {
-    /** The root OrcheStore instance created with createStore(...). */
+    /** The root OrcheStore instance created with `createStore(...)`. */
     store: store;
 };
 /** Provides an OrcheStore instance to the React component tree. */
@@ -115,6 +134,17 @@ declare function getGlobalUtils(): GlobalUtils;
 /** Registers or updates application-wide global utilities. */
 declare function provideGlobalUtils(value: Partial<GlobalUtils>): GlobalUtils;
 
+type DiagnosticsLevel = "off" | "errors" | "all";
+/**
+ * Configures OrcheStore diagnostics output.
+ *
+ * Levels:
+ * - "off" - disables all output
+ * - "errors" - shows errors only
+ * - "all" - shows logs, warnings, and errors
+ */
+declare function configureDiagnostics(level: DiagnosticsLevel): void;
+
 declare const OrcheStore$1: {
     /** Creates and initializes an OrcheStore instance. */
     createStore: typeof createStore;
@@ -126,6 +156,15 @@ declare const OrcheStore$1: {
     provideGlobalUtils: typeof provideGlobalUtils;
     /** Returns the current global utilities object. */
     getGlobalUtils: typeof getGlobalUtils;
+    /**
+     * Configures OrcheStore diagnostics output.
+     *
+     * Levels:
+     * - "off" - disables all output
+     * - "errors" - shows errors only
+     * - "all" - shows logs, warnings, and errors
+     */
+    configureDiagnostics: typeof configureDiagnostics;
 };
 
-export { type GlobalUtils, type orchestore as OrcheStore, type RootStore, type slice as Slice, type sliceOptions as SliceOptions, type store as Store, StoreProvider, createSlice, createStore, OrcheStore$1 as default, getGlobalUtils, provideGlobalUtils };
+export { type GlobalUtils, type orchestore as OrcheStore, type RootStore, type slice as Slice, type sliceOptions as SliceOptions, type store as Store, StoreProvider, configureDiagnostics, createSlice, createStore, OrcheStore$1 as default, getGlobalUtils, provideGlobalUtils };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import { ProviderProps } from 'react-redux';
 
-type Dict<Value = any> = Record<string | number | symbol, Value>;
+type Dict<Value = any> = Record<string, Value>;
 type Tail<T extends any[]> = T extends [any, ...infer R] ? R : T extends (infer U)[] ? U[] : never;
 type DeepReadonly<T> = T extends (...args: any[]) => any ? T : T extends readonly (infer U)[] ? ReadonlyArray<DeepReadonly<U>> : T extends object ? {
     readonly [K in keyof T]: DeepReadonly<T[K]>;
@@ -26,9 +26,9 @@ type GlobalUtils = Definition<"global", GlobalUtilsRule, any>;
 type RootStore = Definition<"root", RootStoreRule, any>;
 
 /** Reserved slice member names that cannot be overridden by user-defined APIs. */
-type ReservedKeys<R = {}, M = {}> = "name" | "path" | "computed" | "root" | "global" | "getState" | "useSelect" | keyof R | keyof M;
+type ReservedKeys$1<R = {}, M = {}> = "name" | "path" | "computed" | "root" | "global" | "getState" | "useSelect" | keyof R | keyof M;
 /** Defines the mutations available on a slice. */
-type Mutations<S extends Dict> = Dict<(state: Omit<S, "root" | "computed">, ...args: any[]) => void>;
+type Mutations<S extends Dict> = Dict<(state: Omit<S, "computed">, ...args: any[]) => void>;
 /** Defines the computed functions available on a slice. */
 type Computed<S extends Dict, C extends Dict> = Dict<(state: ExposedState<S, C>, ...args: any[]) => any>;
 /** Defines the methods available on a slice with contextual `this` typing. */
@@ -36,7 +36,7 @@ type Methods<Context = any> = Dict<(...args: any[]) => any> & ThisType<Context>;
 /** Defines the child slices nested within a slice. */
 type Children = Dict<slice<any, Mutations<any>, Methods, Dict, Computed<any, any>, any>>;
 /** Exposes immutable slice state with optional runtime helpers. */
-type ExposedState<S extends Dict, C extends Children = Children, Root = {}> = DeepReadonly<Omit<S, "root"> & Root>;
+type ExposedState<S extends Dict, C extends Children = Children> = DeepReadonly<Omit<S, "computed">>;
 /** Runtime slice API exposed by createSlice(...). */
 type slice<S extends Dict = Dict, R extends Mutations<S> = Mutations<S>, M extends Methods = Methods, C extends Children = Children, G extends Computed<S, C> = Computed<S, C>, N extends string = string> = {
     /** Unique slice identifier. */
@@ -51,17 +51,26 @@ type slice<S extends Dict = Dict, R extends Mutations<S> = Mutations<S>, M exten
     };
     /** Returns the latest immutable state snapshot. */
     readonly getState: () => ExposedState<S, C>;
-    /** Subscribes to state changes within React components. */
-    readonly useSelect: <T>(selector: (state: ExposedState<S, C, true>) => T) => T;
+    /** Subscribes to state changes within React components. Runs with a context-bound `this` containing `root` store, `rootState` and `global` utilities. */
+    readonly useSelect: <T>(selector: (this: UseSelectContext<RootStore>, state: ExposedState<S, C>, context: UseSelectContext<any>) => T) => T;
 } & {
     /** Exposed mutation functions. */
-    readonly [K in Exclude<keyof R, ReservedKeys>]: (...args: Tail<Parameters<R[K]>>) => ReturnType<R[K]>;
+    readonly [K in Exclude<keyof R, ReservedKeys$1>]: (...args: Tail<Parameters<R[K]>>) => ReturnType<R[K]>;
 } & {
     /** Exposed method functions. */
-    readonly [K in Exclude<keyof M, ReservedKeys<R>>]: M[K];
+    readonly [K in Exclude<keyof M, ReservedKeys$1<R>>]: M[K];
 } & {
     /** Exposed child slices. */
-    readonly [K in Exclude<keyof C, ReservedKeys<R, M>>]: C[K];
+    readonly [K in Exclude<keyof C, ReservedKeys$1<R, M>>]: C[K];
+};
+/** Context available inside `useSelect`, providing access to the root store, root state snapshot, and global utilities. */
+type UseSelectContext<RootStore extends store> = {
+    /** Root store instance. */
+    root: RootStore;
+    /** Latest root state snapshot. */
+    rootState: ReturnType<RootStore["getState"]>;
+    /** Global utilities shared across slices. */
+    global: GlobalUtils;
 };
 /** Configuration object used to create a slice. */
 type sliceOptions<S extends Dict = Dict, R extends Mutations<S> = Mutations<S>, M extends Methods = Methods, C extends Children = Children, G extends Computed<S, C> = Computed<S, C>, N extends string = string> = {
@@ -81,13 +90,23 @@ type sliceOptions<S extends Dict = Dict, R extends Mutations<S> = Mutations<S>,
     children?: C;
 };
 
-type store = Record<string, slice>;
+/** Reserved store member names that cannot be overridden by user-defined APIs. */
+type ReservedKeys<R = {}, M = {}> = "name" | "path" | "computed" | "root" | "global" | "getState" | "useSelect";
+type store<C extends Children = Children> = {
+    /** Returns the latest immutable state snapshot. */
+    readonly getState: () => ExposedState<{}, C>;
+    /** Subscribes to state changes within React components. Runs with a context-bound `this` containing `global` utilities. */
+    readonly useSelect: <T>(selector: (this: UseSelectContext<RootStore>, state: ExposedState<{}, C>, context: UseSelectContext<any>) => T) => T;
+} & {
+    /** Exposed slices. */
+    readonly [K in Exclude<keyof C, ReservedKeys>]: C[K];
+};
 
 type orchestore = {};
 declare global {
     type OrcheStore = orchestore;
     namespace OrcheStore {
-        type Store = store;
+        type Store<C extends Children = Children> = store<C>;
         /** Runtime slice API exposed by createSlice(...). */
         type Slice<S extends Dict = Dict, R extends Mutations<S> = Mutations<S>, M extends Methods = Methods, C extends Children = Children, G extends Computed<S, C> = Computed<S, C>, N extends string = string> = slice<S, R, M, C, G, N>;
         /** Configuration object used to create a slice. */
@@ -96,15 +115,15 @@ declare global {
 }
 
 /** Creates and initializes an OrcheStore instance. */
-declare function createStore({ slices }: {
-    slices: Record<string, slice>;
-}): store;
+declare function createStore<C extends Children = Children>({ slices }: {
+    slices: C;
+}): store<C>;
 
 /** Creates and initializes an OrcheStore slice. */
-declare function createSlice<S extends Dict = Dict, R extends Mutations<S> = Mutations<S>, M extends Methods = Methods, C extends Children = Children, G extends Computed<S, C> = Computed<S, C>, N extends string = string>(options: sliceOptions<S, R, M, C, G, N>): slice<S, R, M, C, G, N>;
+declare function createSlice<S extends Dict = Dict, R extends Mutations<S> = Mutations<S>, M extends Methods = Methods, C extends Children = Children, G extends Computed<S, C> = Computed<S, C>, N extends string = string>(props: sliceOptions<S, R, M, C, G, N>): slice<S, R, M, C, G, N>;
 
 type StoreProviderProps = Omit<ProviderProps, "store" | "serverState" | "context"> & {
-    /** The root OrcheStore instance created with createStore(...). */
+    /** The root OrcheStore instance created with `createStore(...)`. */
     store: store;
 };
 /** Provides an OrcheStore instance to the React component tree. */
@@ -115,6 +134,17 @@ declare function getGlobalUtils(): GlobalUtils;
 /** Registers or updates application-wide global utilities. */
 declare function provideGlobalUtils(value: Partial<GlobalUtils>): GlobalUtils;
 
+type DiagnosticsLevel = "off" | "errors" | "all";
+/**
+ * Configures OrcheStore diagnostics output.
+ *
+ * Levels:
+ * - "off" - disables all output
+ * - "errors" - shows errors only
+ * - "all" - shows logs, warnings, and errors
+ */
+declare function configureDiagnostics(level: DiagnosticsLevel): void;
+
 declare const OrcheStore$1: {
     /** Creates and initializes an OrcheStore instance. */
     createStore: typeof createStore;
@@ -126,6 +156,15 @@ declare const OrcheStore$1: {
     provideGlobalUtils: typeof provideGlobalUtils;
     /** Returns the current global utilities object. */
     getGlobalUtils: typeof getGlobalUtils;
+    /**
+     * Configures OrcheStore diagnostics output.
+     *
+     * Levels:
+     * - "off" - disables all output
+     * - "errors" - shows errors only
+     * - "all" - shows logs, warnings, and errors
+     */
+    configureDiagnostics: typeof configureDiagnostics;
 };
 
-export { type GlobalUtils, type orchestore as OrcheStore, type RootStore, type slice as Slice, type sliceOptions as SliceOptions, type store as Store, StoreProvider, createSlice, createStore, OrcheStore$1 as default, getGlobalUtils, provideGlobalUtils };
+export { type GlobalUtils, type orchestore as OrcheStore, type RootStore, type slice as Slice, type sliceOptions as SliceOptions, type store as Store, StoreProvider, configureDiagnostics, createSlice, createStore, OrcheStore$1 as default, getGlobalUtils, provideGlobalUtils };

package/dist/index.js

@@ -1,13 +1,22 @@
-import{configureStore as I}from"@reduxjs/toolkit";import{createSlice as A}from"@reduxjs/toolkit";var b=[];function x(e){return b.find(t=>t.slice===e)?.redux}function v(e){let t=e,r=A({name:e.name,initialState:e.state,reducers:e.mutations});return b.push({slice:t,redux:r}),t}var u=typeof globalThis<"u"&&typeof globalThis.process<"u"&&globalThis.process?.env?.NODE_ENV!=="production",g=!1,P=globalThis.console?.log?.bind?.(globalThis.console)||globalThis.console?.log,M=globalThis.console?.warn?.bind?.(globalThis.console)||globalThis.console?.warn,k=globalThis.console?.error?.bind?.(globalThis.console)||globalThis.console?.error,j=globalThis.console?.clear?.bind?.(globalThis.console)||globalThis.console?.clear;globalThis.console?.clear&&(globalThis.console.clear=(...e)=>{g=!1,j?.(...e)});var E=`[OrcheStore] Development diagnostics are enabled.
-Warnings and errors from OrcheStore are not shown in production builds.
-Runtime exceptions that stop code execution may still occur.
+import{configureStore as de}from"@reduxjs/toolkit";import{createSlice as se,ReducerType as ae}from"@reduxjs/toolkit";import{useSelector as ce}from"react-redux";var g={target:({slice:e})=>e?` Affected slice '${e}':
+`:" ",RequiredName:e=>`[OrcheStore::${e.module}]${g.target(e)}${e.type} keys must be non-empty strings.`,InvalidName:(e,t)=>`[OrcheStore::${e.module}]${g.target(e)}${e.type} names cannot contain '.' or '/'. Received: ${t}.`,ReservedKey:(e,t)=>`[OrcheStore::${e.module}]${g.target(e)}'${t}' is a reserved name and cannot be used as a ${e.type} key.`,DuplicateKey:(e,t)=>`[OrcheStore::${e.module}]${g.target(e)}${e.type} name '${t}' conflicts with another member.`},G=(e,t)=>{if(e)if(t==="warn")console.warn(e);else if(t==="error")console.error(e);else throw new Error(e);else return!1},E=(e,t="",r="",n)=>typeof e!="string"||!e?!!G(t,n?.[0]):e.includes(".")||e.includes("/")?!!G(r,n?.[1]):!0,_=(e,t,r)=>{let[n,o]=[g.RequiredName(e),g.InvalidName(e,t)];if(E(t,n,o,["error","error"])){if(r[0].includes(t))return console.error(g.ReservedKey(e,t));if(r[1].includes(t))return console.error(g.DuplicateKey(e,t))}else return;return!0},R=(e,t,r,n)=>(Object.entries(t).forEach(([o,c])=>{let s=_(e,o,r)?n(o,c):void 0;if(s===void 0)return delete t[o];t[o]=s,r[1].push(o)}),t);var v="all",j={diagnostics:!1,prerelease:!1},A=globalThis.console?.log?.bind?.(globalThis.console)||globalThis.console?.log,B=globalThis.console?.warn?.bind?.(globalThis.console)||globalThis.console?.warn,H=globalThis.console?.error?.bind?.(globalThis.console)||globalThis.console?.error,Q=globalThis.console?.clear?.bind?.(globalThis.console)||globalThis.console?.clear;globalThis.console?.clear&&(globalThis.console.clear=(...e)=>{j.diagnostics=!1,Q?.(...e)});var Y=`[OrcheStore] \u{1F6A7} Pre-release Notice
+Thank you for your interest in OrcheStore.
+OrcheStore is currently under active development and is not yet ready for production use.
+APIs, behavior, and internal implementation details may change without notice.
+The first stable release is currently planned for 2026-06-30.
+Stay tuned for updates!
+`,Z=`[OrcheStore] Diagnostics are enabled.
+OrcheStore may emit warnings and errors to help identify incorrect usage, invalid configurations, and potential runtime issues.
+Runtime exceptions that stop code execution may still occur regardless of diagnostics settings.
 Please resolve all OrcheStore warnings and errors before deploying to production.
-`,f=()=>{g||(g=!0,P?.(E))},i={log(...e){u&&(f(),P?.(...e))},warn(...e){u&&(f(),M?.(...e))},error(...e){u&&(f(),k?.(...e))}};var a=[];function T(e){return a.find(t=>t.store===e)?.redux}function w({slices:e}){if(a.length===1)return i.warn(`[OrcheStore] createStore(...) was called more than once.
+Diagnostics can be configured with configureDiagnostics("off" | "errors" | "all").
+`,i={inform(e){j[e]||(j[e]=!0,v==="all"&&A?.(e==="prerelease"?Y:Z))},log(...e){v==="all"&&(i.inform("diagnostics"),A?.(...e))},warn(...e){v==="all"&&(i.inform("diagnostics"),B?.(...e))},error(...e){v!=="off"&&(i.inform("diagnostics"),H?.(...e))}};function K(e){v=e}import C from"react";import{Provider as ee,useDispatch as te}from"react-redux";var D=[];function q(e){let t=D.find(r=>r.store===e);if(t)return t.dispatch;throw new Error("[OrcheStore] Using OrcheStore requires wrapping your application with <StoreProvider>.")}function re({store:e,children:t}){let r=te(),n=D.find(o=>o.store===e);return n||D.push(n={store:e,dispatch:r}),n.dispatch=r,C.createElement(C.Fragment,null,t)}function N(e){let{store:t,stabilityCheck:r,identityFunctionCheck:n}={...e||{}},o=P(t);if(!o)throw new Error("[OrcheStore::context] <StoreProvider> requires a store instance created with createStore(...).");return C.createElement(ee,{stabilityCheck:r,identityFunctionCheck:n,store:o},C.createElement(re,{...e}))}var oe=Object.assign,$=Object.getOwnPropertyDescriptor(Object,"defineProperty")?.value||Object.defineProperty,ne=(e,t,r)=>{$(e,t,{get:r,enumerable:!0,configurable:!1})},ie=(e,t,r)=>{$(e,t,{value:r,writable:!1,enumerable:!0,configurable:!1})},m={assign:oe,defineProp:$,defineReadonly:ne,defineMethod:ie},L={isArray:Array.isArray},M={get:Reflect.get,set:Reflect.set,delete:Reflect.deleteProperty};var w={GetMissingProp:e=>["[OrcheStore::global-utils] Attempted to access a global utility before it became available. Missing property",e,`
+If this utility is optional, register it as undefined using provideGlobalUtils(...) to suppress future warnings.
+`],DeleteProp:e=>["[OrcheStore::global-utils] Avoid deleting properties. Trying to delete property",e,`
+Use provideGlobalUtils(...) to set them to undefined instead for type safety.
+`],InvalidArgs:"[OrcheStore::global-utils] Expected provideGlobalUtils(...) to receive a non-null object. Received:"},U=new Proxy({},{get(e,t,r){return t in e||i.error(...w.GetMissingProp(t)),M.get(e,t,r)},set(e,t,r,n){return M.set(e,t,r,n)},deleteProperty(e,t){return i.warn(...w.DeleteProp(t)),M.delete(e,t)}});function b(){return U}function k(e){return e==null?i.error(w.InvalidArgs,e):L.isArray(e)?i.error(w.InvalidArgs,"(type: array)",e):typeof e!="object"?i.error(w.InvalidArgs,`(type: ${typeof e})`,e):m.assign(U,e),U}function x(e,t){let r={};return Object.keys(e).filter(o=>o.startsWith(t)).map(o=>o.split(".")).sort((o,c)=>o.length-c.length).forEach(o=>{let c=r;o.slice(0,o.length-1).forEach(s=>c=c[s]||={}),c[o[o.length-1]]={...e[o.join(".")]}}),r}function z(e,t){return t.split(".").forEach(r=>e=e[r]),e}var F=[];function I(e){return F.find(t=>t.slice===e)}function J(e){i.inform("prerelease");let t={},r=le(e),n=["name","path","state","computed","root","global","useSelect"],o=[],c=a=>({module:"createSlice",type:a,slice:r.name}),s=a=>({root:u(),rootState:a,global:b()}),u=()=>{let a=V();if(!a)throw new Error(d.RequiredStore(r.name));return a};R(c("mutation"),r.mutations,[n,o],(a,l)=>l?._reducerDefinitionType===ae.asyncThunk||"reducer"in{...l||{}}?i.error(d.ReduxReducerConflict()):typeof l!="function"?i.error(d.InvalidMutation(a)):((T,X)=>l(T,...X.payload)));let p=se({name:r.name,reducerPath:r.name,initialState:r.state,reducers:r.mutations}),h={path:r.name,slice:t,redux:p,children:{}};return m.defineReadonly(t,"name",()=>r.name),m.defineReadonly(t,"path",()=>h.path),m.defineReadonly(t,"global",()=>b()),m.defineMethod(t,"getState",()=>x(P(u()).getState(),h.path)),m.defineMethod(t,"useSelect",a=>ce(l=>{let f=s(x(l,""));return a.call(f,z(f.rootState,t.path),f)})),Object.entries(p.actions).map(([a,l])=>{t[a]=(...f)=>q(u())(l(f))}),R(c("method"),r.methods,[n,o],(a,l)=>typeof l!="function"?i.error(d.InvalidMethod(a)):t[a]=(...f)=>l.apply(t,f)),R(c("children"),r.children,[n,o],(a,l)=>I(l)?h.children[a]=l:i.error(d.InvalidChild(a))),Object.keys(r.computed).length>0&&i.warn("[OrcheStore::createSlice] Computed properties are not yet supported and will be ignored."),F.push(h),t}var le=e=>{let t={...e||{}};if(E(t.name,d.RequiredName(),d.InvalidName(t.name)),typeof t.state=="function"){let u=t.state;t.state=()=>{let p=u();if(typeof p!="object")throw new Error(d.InvalidState(t.name));if(!p)throw new Error(d.RequiredState(t.name));return p}}else{if(typeof t.state!="object")throw new Error(d.InvalidState(t.name));if(!t.state)throw new Error(d.RequiredState(t.name))}t.mutations=typeof t.mutations=="object"&&t.mutations?{...t.mutations}:{},t.computed=typeof t.computed=="object"&&t.computed?{...t.computed}:{},t.methods=typeof t.methods=="object"&&t.methods?{...t.methods}:{},t.children=typeof t.children=="object"&&t.children?{...t.children}:{};let{reducers:r,extraReducers:n,reducerPath:o,initialState:c,selectors:s}={...t||{}};return c!==void 0&&i.warn(d.ReduxConflict("initialState")),r!==void 0&&i.warn(d.ReduxConflict("reducers")),n!==void 0&&i.warn(d.ReduxConflict("extraReducers")),o!==void 0&&i.warn(d.ReduxConflict("reducerPath")),s!==void 0&&i.warn(d.ReduxConflict("selectors")),t},d={RequiredName:()=>"[OrcheStore::createSlice] Missing required slice name. Expected a non-empty string.",InvalidName:e=>`[OrcheStore::createSlice] Slice names cannot contain '.' or '/'. Received: {${e}}`,RequiredState:e=>`[OrcheStore::createSlice] Missing required slice state for slice: {${e}}`,InvalidState:e=>`[OrcheStore::createSlice] Slice state must be a non-null object or a function that returns a non-null object. Slice: {${e}}`,ReservedKey:(e,t)=>`[OrcheStore::createSlice] '${t}' is reserved by OrcheStore and should not be provided as a ${e}.`,InvalidMutation:e=>`[OrcheStore::createSlice] Mutation '${e}' must be a function.`,InvalidMethod:e=>`[OrcheStore::createSlice] Method '${e}' must be a function.`,InvalidChild:e=>`[OrcheStore::createSlice] Child slice '${e}' must be a slice object created using createSlice(...).`,RequiredStore:e=>`[OrcheStore::slice-runtime] No root store found for slice: {${e}}. Slices must be created within the context of a store.
+Create a store using createStore(...) and ensure that slices are accessed after the store is initialized.`,ReduxConflict:e=>`[OrcheStore::createSlice] '${e}' is a Redux Toolkit createSlice(...) option and is not applicable to OrcheStore slices. This property will be ignored.`,ReduxReducerConflict:()=>"[OrcheStore::createSlice] Redux Toolkit asyncThunk reducers are not supported in mutations. Use methods instead."};import{useSelector as ue}from"react-redux";var O=[];function P(e){return O.find(t=>t.store===e)?.redux}function V(){return O[0]?.store}function W({slices:e}){if(i.inform("prerelease"),O.length===1)return i.warn(`[OrcheStore::createStore] createStore(...) was called more than once.
 OrcheStore currently supports only a single global store instance and will return the existing store.
 If you are creating a store inside a React component, create it only once, for example:
 const [store] = useState(() => createStore(...));
-Avoid useState(createStore(...)) because createStore(...) will be executed on every render.`),a[0].store;let t={},r={};for(let n in e){let S=e[n],m=x(S);m&&(t[n]=S,r[n]=m.reducer)}let o=I({reducer:r});return a.push({store:t,redux:o}),t}import d from"react";import{Provider as K,useDispatch as N}from"react-redux";var O=[];function q({store:e,children:t}){let r=N(),o=O.find(n=>n.store===e);return o||O.push(o={store:e,dispatch:r}),o.dispatch=r,d.createElement(d.Fragment,null,t)}function U(e){let{store:t,stabilityCheck:r,identityFunctionCheck:o}=e,n=T(t);if(!n)throw new Error("[OrcheStore] <StoreProvider> requires a store instance created with createStore(...).");return d.createElement(K,{stabilityCheck:r,identityFunctionCheck:o,store:n},d.createElement(q,{...e}))}var F=Object.assign,y=Object.getOwnPropertyDescriptor(Object,"defineProperty")?.value||Object.defineProperty,V=(e,t,r)=>{y(e,t,{get:r,enumerable:!0,configurable:!1})},_=(e,t,r)=>{y(e,t,{value:r,writable:!1,enumerable:!0,configurable:!1})},G={assign:F,defineProp:y,defineReadonly:V,defineMethod:_},C={isArray:Array.isArray},p={get:Reflect.get,set:Reflect.set,delete:Reflect.deleteProperty};var c={GetMissingProp:e=>["OrcheStore[global-utils] Attempted to access a global utility before it became available. Missing property",e,`
-If this utility is optional, register it as undefined using provideGlobalUtils(...) to suppress future warnings.
-`],DeleteProp:e=>["OrcheStore[global-utils] Avoid deleting properties. Trying to delete property",e,`
-Use provideGlobalUtils(...) to set them to undefined instead for type safety.
-`],InvalidArgs:"OrcheStore[global-utils] Expected provideGlobalUtils(...) to receive a non-null object. Received:"},h=new Proxy({},{get(e,t,r){return t in e||i.error(...c.GetMissingProp(t)),p.get(e,t,r)},set(e,t,r,o){return p.set(e,t,r,o)},deleteProperty(e,t){return i.warn(...c.DeleteProp(t)),p.delete(e,t)}});function D(){return h}function R(e){return e==null?i.error(c.InvalidArgs,e):C.isArray(e)?i.error(c.InvalidArgs,"(type: array)",e):typeof e!="object"?i.error(c.InvalidArgs,`(type: ${typeof e})`,e):G.assign(h,e),h}var J={createStore:w,createSlice:v,StoreProvider:U,provideGlobalUtils:R,getGlobalUtils:D},ye=J;export{U as StoreProvider,v as createSlice,w as createStore,ye as default,D as getGlobalUtils,R as provideGlobalUtils};
+Avoid useState(createStore(...)) because createStore(...) will be executed on every render.`),O[0].store;let t={},r=s=>({root:t,rootState:s,global:b()});m.defineMethod(t,"getState",()=>x(c.getState(),"")),m.defineMethod(t,"useSelect",s=>ue(u=>{let p=r(x(u,""));return s.call(p,p.rootState,p)}));let n={},o=(s,u,p)=>{let h=I(u)||{};if(!h)return;let{redux:a,children:l}=h;h.path=s,n[s]=a.reducer,p[s]=u,Object.entries(l).forEach(([f,T])=>{o(s+"."+f,T,u)})};for(let s in e){let u=e[s];s in t||o(s,u,t)}let c=de({reducer:n});return O.push({store:t,redux:c}),t}var pe={createStore:W,createSlice:J,StoreProvider:N,provideGlobalUtils:k,getGlobalUtils:b,configureDiagnostics:K},tt=pe;export{N as StoreProvider,K as configureDiagnostics,J as createSlice,W as createStore,tt as default,b as getGlobalUtils,k as provideGlobalUtils};

package/package.json

@@ -1,73 +1,72 @@
-{
-  "name": "orchestore",
-  "version": "0.1.1",
-  "description": "A function-oriented architecture built on top of Redux Toolkit for simplifying and automating application development.",
-  "author": "Oussama Saadaoui",
-  "license": "MIT",
-  "type": "module",
-  "main": "./src/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "scripts": {
-    "start": "tsup",
-    "build": "tsup",
-    "check": "tsc --noEmit",
-    "lint": "eslint .",
-    "prepublishOnly": "npm run build"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "homepage": "https://github.com/saadaoui-oussama-dev/OrcheStore#readme",
-  "bugs": {
-    "url": "https://github.com/saadaoui-oussama-dev/OrcheStore/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/saadaoui-oussama-dev/OrcheStore.git"
-  },
-  "dependencies": {
-    "@reduxjs/toolkit": "^2.12.0",
-    "react-redux": "^9.3.0"
-  },
-  "devDependencies": {
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "eslint": "^9.0.0",
-    "tsup": "^8.5.1",
-    "typescript": "^6.0.3"
-  },
-  "peerDependencies": {
-    "react": "^16.9.0 || ^17 || ^18 || ^19",
-    "react-dom": "^16.9.0 || ^17 || ^18 || ^19"
-  },
-  "keywords": [
-    "orchestore",
-    "store",
-    "slice",
-    "state",
-    "global-store",
-    "global-state",
-    "typed-store",
-    "typed-state",
-    "react",
-    "react-store",
-    "react-state",
-    "react-redux",
-    "redux",
-    "redux-toolkit",
-    "redux-automation",
-    "frontend",
-    "typescript",
-    "orchestration",
-    "state-management",
-    "state-orchestration"
-  ]
-}
+{
+  "name": "orchestore",
+  "version": "0.1.2",
+  "description": "A function-oriented architecture built on top of Redux Toolkit for simplifying and automating application development.",
+  "author": "Oussama Saadaoui",
+  "license": "MIT",
+  "type": "module",
+  "main": "./src/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "start": "tsup && node scripts/pack.mjs",
+    "build": "tsup && node scripts/pack.mjs",
+    "check": "tsc --noEmit",
+    "lint": "eslint ."
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "homepage": "https://github.com/saadaoui-oussama-dev/OrcheStore#readme",
+  "bugs": {
+    "url": "https://github.com/saadaoui-oussama-dev/OrcheStore/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/saadaoui-oussama-dev/OrcheStore.git"
+  },
+  "dependencies": {
+    "@reduxjs/toolkit": "^2.12.0",
+    "react-redux": "^9.3.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "eslint": "^9.0.0",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "react": "^16.9.0 || ^17 || ^18 || ^19",
+    "react-dom": "^16.9.0 || ^17 || ^18 || ^19"
+  },
+  "keywords": [
+    "orchestore",
+    "store",
+    "slice",
+    "state",
+    "global-store",
+    "global-state",
+    "typed-store",
+    "typed-state",
+    "react",
+    "react-store",
+    "react-state",
+    "react-redux",
+    "redux",
+    "redux-toolkit",
+    "redux-automation",
+    "frontend",
+    "typescript",
+    "orchestration",
+    "state-management",
+    "state-orchestration"
+  ]
+}