orchestore 0.1.0 → 0.1.2

package/dist/index.cjs

@@ -1,32 +1,22 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  test: () => test
-});
-module.exports = __toCommonJS(index_exports);
-function test() {
-  console.log("Working");
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  test
-});
+"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.
+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.`),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,4 +1,170 @@
-/** Test TSDoc */
-declare function test(): void;
+import React from 'react';
+import { ProviderProps } from 'react-redux';
 
-export { test };
+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]>;
+} : T;
+
+declare global {
+    namespace OrcheStore {
+        /** User-defined framework type slots. */
+        interface Slots {
+        }
+    }
+}
+/** Resolves a type slot with validation and fallback support. */
+type Definition<T, Rule, Default> = T extends keyof OrcheStore.Slots ? Exclude<OrcheStore.Slots[T], undefined | null> extends Rule ? Exclude<OrcheStore.Slots[T], undefined | null> : Default : Default;
+/** Validation rule for the `global` type slot. */
+type GlobalUtilsRule = Record<PropertyKey, any>;
+/** Validation rule for the `root` type slot. */
+type RootStoreRule = Record<PropertyKey, any>;
+/** Resolved type for application-wide global utilities. */
+type GlobalUtils = Definition<"global", GlobalUtilsRule, any>;
+/** Resolved type for the application root store. */
+type RootStore = Definition<"root", RootStoreRule, any>;
+
+/** Reserved slice member names that cannot be overridden by user-defined APIs. */
+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, "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. */
+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> = 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. */
+    readonly name: N;
+    /** Fully qualified runtime path of the slice. */
+    readonly path: string;
+    /** Application-wide global utilities. */
+    readonly global: GlobalUtils;
+    /** Collection of derived state functions. */
+    readonly computed: {
+        readonly [K in keyof G]: (...args: Tail<Parameters<G[K]>>) => ReturnType<G[K]>;
+    };
+    /** Returns the latest immutable state snapshot. */
+    readonly getState: () => ExposedState<S, C>;
+    /** 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$1>]: (...args: Tail<Parameters<R[K]>>) => ReturnType<R[K]>;
+} & {
+    /** Exposed method functions. */
+    readonly [K in Exclude<keyof M, ReservedKeys$1<R>>]: M[K];
+} & {
+    /** Exposed child slices. */
+    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> = {
+    /** Unique slice identifier. */
+    name: N;
+    /** Initial state object or lazy state initializer. */
+    state: S | (() => S);
+    /** Collection of synchronous state transition functions. */
+    mutations: R;
+    /** Collection of derived state functions. */
+    computed?: G & ThisType<G>;
+    /** Collection of slice methods and orchestration logic. */
+    methods?: M & ThisType<slice<S, R, M, C, G, N> & {
+        root: RootStore;
+    }>;
+    /** Collection of nested child slices. */
+    children?: C;
+};
+
+/** 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<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. */
+        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> = sliceOptions<S, R, M, C, G, N>;
+    }
+}
+
+/** Creates and initializes an OrcheStore instance. */
+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>(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(...)`. */
+    store: store;
+};
+/** Provides an OrcheStore instance to the React component tree. */
+declare function StoreProvider(props: StoreProviderProps): React.JSX.Element;
+
+/** Returns the current global utilities object. */
+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;
+    /** Creates and initializes an OrcheStore slice. */
+    createSlice: typeof createSlice;
+    /** Provides an OrcheStore instance to the React component tree. */
+    StoreProvider: typeof StoreProvider;
+    /** Registers or updates application-wide global utilities. */
+    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, configureDiagnostics, createSlice, createStore, OrcheStore$1 as default, getGlobalUtils, provideGlobalUtils };

package/dist/index.d.ts

@@ -1,4 +1,170 @@
-/** Test TSDoc */
-declare function test(): void;
+import React from 'react';
+import { ProviderProps } from 'react-redux';
 
-export { test };
+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]>;
+} : T;
+
+declare global {
+    namespace OrcheStore {
+        /** User-defined framework type slots. */
+        interface Slots {
+        }
+    }
+}
+/** Resolves a type slot with validation and fallback support. */
+type Definition<T, Rule, Default> = T extends keyof OrcheStore.Slots ? Exclude<OrcheStore.Slots[T], undefined | null> extends Rule ? Exclude<OrcheStore.Slots[T], undefined | null> : Default : Default;
+/** Validation rule for the `global` type slot. */
+type GlobalUtilsRule = Record<PropertyKey, any>;
+/** Validation rule for the `root` type slot. */
+type RootStoreRule = Record<PropertyKey, any>;
+/** Resolved type for application-wide global utilities. */
+type GlobalUtils = Definition<"global", GlobalUtilsRule, any>;
+/** Resolved type for the application root store. */
+type RootStore = Definition<"root", RootStoreRule, any>;
+
+/** Reserved slice member names that cannot be overridden by user-defined APIs. */
+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, "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. */
+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> = 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. */
+    readonly name: N;
+    /** Fully qualified runtime path of the slice. */
+    readonly path: string;
+    /** Application-wide global utilities. */
+    readonly global: GlobalUtils;
+    /** Collection of derived state functions. */
+    readonly computed: {
+        readonly [K in keyof G]: (...args: Tail<Parameters<G[K]>>) => ReturnType<G[K]>;
+    };
+    /** Returns the latest immutable state snapshot. */
+    readonly getState: () => ExposedState<S, C>;
+    /** 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$1>]: (...args: Tail<Parameters<R[K]>>) => ReturnType<R[K]>;
+} & {
+    /** Exposed method functions. */
+    readonly [K in Exclude<keyof M, ReservedKeys$1<R>>]: M[K];
+} & {
+    /** Exposed child slices. */
+    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> = {
+    /** Unique slice identifier. */
+    name: N;
+    /** Initial state object or lazy state initializer. */
+    state: S | (() => S);
+    /** Collection of synchronous state transition functions. */
+    mutations: R;
+    /** Collection of derived state functions. */
+    computed?: G & ThisType<G>;
+    /** Collection of slice methods and orchestration logic. */
+    methods?: M & ThisType<slice<S, R, M, C, G, N> & {
+        root: RootStore;
+    }>;
+    /** Collection of nested child slices. */
+    children?: C;
+};
+
+/** 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<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. */
+        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> = sliceOptions<S, R, M, C, G, N>;
+    }
+}
+
+/** Creates and initializes an OrcheStore instance. */
+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>(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(...)`. */
+    store: store;
+};
+/** Provides an OrcheStore instance to the React component tree. */
+declare function StoreProvider(props: StoreProviderProps): React.JSX.Element;
+
+/** Returns the current global utilities object. */
+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;
+    /** Creates and initializes an OrcheStore slice. */
+    createSlice: typeof createSlice;
+    /** Provides an OrcheStore instance to the React component tree. */
+    StoreProvider: typeof StoreProvider;
+    /** Registers or updates application-wide global utilities. */
+    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, configureDiagnostics, createSlice, createStore, OrcheStore$1 as default, getGlobalUtils, provideGlobalUtils };

package/dist/index.js

@@ -1,7 +1,22 @@
-// src/index.ts
-function test() {
-  console.log("Working");
-}
-export {
-  test
-};
+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.
+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.`),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,55 +1,72 @@
-{
-  "name": "orchestore",
-  "version": "0.1.0",
-  "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": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "scripts": {
-    "build": "tsup"
-  },
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "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"
-  },
-  "keywords": [
-    "orchestore",
-    "store",
-    "slice",
-    "state",
-    "global-store",
-    "global-state",
-    "typed-store",
-    "typed-state",
-    "react",
-    "react-store",
-    "react-state",
-    "react-redux",
-    "redux",
-    "redux-toolkit",
-    "frontend",
-    "typescript",
-    "orchestration",
-    "state-management",
-    "state-orchestration"
-  ],
-  "devDependencies": {
-    "tsup": "^8.5.1",
-    "typescript": "^6.0.3"
-  }
-}
+{
+  "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"
+  ]
+}