orchestore 0.1.6 → 0.1.8

package/README.md

@@ -51,8 +51,9 @@ The goal is simple:
 	- [Mutations](#mutations)
 	- [Methods](#methods)
 	- [Computed State (Planned)](#computed-state-planned)
-	- [Nested Slices (Planned)](#nested-slices-planned)
-		- [Runtime Paths](#runtime-paths-planned)
+	- [Nested Slices](#nested-slices)
+		- [Reusing Slices](#reusing-slices)
+		- [Runtime Paths](#runtime-paths)
 
 - [State Access & Subscriptions](#state-access--subscriptions)
 	- [State Snapshots](#state-snapshots)
@@ -66,6 +67,12 @@ The goal is simple:
 	- [Accessing Store from Slices](#accessing-store-from-slices)
 	- [Root Store Type Extension (Planned)](#root-store-type-extension-planned)
 
+- [Lineage & Clones](#lineage--clones)
+	- [Automatic Cloning](#automatic-cloning)
+	- [Manual Cloning](#manual-cloning)
+	- [Inspecting a Lineage](#inspecting-a-lineage)
+	- [Definition Type Checking](#definition-type-checking)
+
 - [Global Utilities](#global-utilities)
 	- [Accessing Global Utilities](#accessing-global-utilities)
 	- [Utilities Type Extension](#utilities-type-extension)
@@ -119,16 +126,17 @@ This allows state and application logic to evolve together within the same domai
 
 Many common Redux patterns are automated by default:
 
-| Traditional Redux Pattern     | OrcheStore                |
-| ----------------------------- | ------------------------- |
-| Action creators               | Direct callable mutations |
-| Thunks                        | Built-in methods          |
-| Dispatch calls                | Direct function calls     |
-| `PayloadAction` wrappers      | Native function arguments |
-| Cross-slice imports           | Root store access         |
-| Shared service wiring         | Global utilities          |
-| Manual state tree composition | Nested slices             |
-| Complex type declarations     | Automatic inference       |
+| Traditional Redux Pattern     | OrcheStore                                      |
+| ----------------------------- | ----------------------------------------------- |
+| Action creators               | Direct callable mutations                       |
+| Thunks                        | Built-in methods                                |
+| Dispatch calls                | Direct function calls                           |
+| `PayloadAction` wrappers      | Native function arguments                       |
+| Cross-slice imports           | Root store access                               |
+| Shared service wiring         | Global utilities                                |
+| Manual state tree composition | Nested slices with automatic cloning & isolation |
+| Complex type declarations     | Automatic inference                             |
+| Instance identity management  | Lineage-based slice model (shared definition, isolated mounts) |
 
 The result is a simpler architecture with fewer moving parts, less boilerplate, and a more direct development experience.
 
@@ -140,33 +148,35 @@ OrcheStore builds on top of Redux Toolkit while providing a higher-level API for
 
 | Feature                        | OrcheStore | Redux Toolkit |
 | ------------------------------ | ---------- | ------------- |
-| Direct callable mutations      | ✅          | ❌             |
 | Multiple mutation arguments    | ✅          | ❌             |
-| Dispatch required              | ❌          | ✅             |
+| Direct callable mutations      | ✅          | ❌             |
 | `PayloadAction` wrappers       | ❌          | ✅             |
+| Dispatch required              | ❌          | ✅             |
 | Built-in orchestration methods | ✅          | ❌             |
-| Nested slice composition       | ⌛ Planned  | ⚠️ Manual     |
-| Automatic path generation      | ⌛ Planned  | ⚠️ Manual     |
+| Nested slice composition       | ✅ (isolated context) | ⚠️ Manual (shared state) |
+| Automatic path generation      | ✅          | ⚠️ Manual     |
 | Global utilities               | ✅          | ❌             |
 | Unified slice API              | ✅          | ❌             |
 | Per-slice React hooks          | ✅          | ❌             |
 | Deep TypeScript inference      | ✅          | ⚠️ Partial    |
+| Lineage & cloning model        | ✅          | ❌             |
 
 OrcheStore does not replace Redux Toolkit. Instead, it builds on top of it by automating common patterns and providing a more cohesive developer experience.
 
 ## Architecture Overview
 
-| Layer       | Responsibility                 |
-| ----------- | ------------------------------ |
-| `name`      | Unique slice identifier        |
-| `state`     | Slice data storage definition  |
-| `mutations` | Synchronous state transitions  |
-| `methods`   | Orchestration and side effects |
-| `computed`  | Derived and computed state     |
-| `children`  | Nested slice composition       |
-| `getState`  | Imperative state access        |
-| `useSelect` | Reactive state subscriptions   |
-| `getPath`   | Hierarchical slice path        |
+| Layer       | Responsibility                           |
+| ----------- | ---------------------------------------- |
+| `name`      | Unique slice identifier                  |
+| `path`      | Hierarchical slice path                  |
+| `state`     | Slice data storage definition            |
+| `mutations` | Synchronous state transitions            |
+| `methods`   | Orchestration and side effects           |
+| `computed`  | Derived and computed state               |
+| `children`  | Nested slice composition                 |
+| `getState`  | Imperative state access                  |
+| `useSelect` | Reactive state subscriptions             |
+| `prototype` | Lineage, cloning, and instance utilities |
 
 ---
 
@@ -345,7 +355,6 @@ export default function App() {
 OrcheStore exposes direct usable child slices through a unified store instance.
 
 ```tsx
-// store.counter is equivalent to counter, import only one and use it
 import { store } from "./store/index";
 import { counter } from "./store/counterSlice";
 
@@ -365,6 +374,10 @@ export function CounterComponent() {
 }
 ```
 
+> 📌 If the slice is mounted only once, `store.counter` and `counter` refer to the same runtime instance and can be used interchangeably.
+>
+> 🔄 When a slice is mounted multiple times, each mount receives its own isolated instance. See [Reusing Slices](#reusing-slices) and [Lineage & Clones](#lineage--clones) for details.
+
 ---
 
 # Slice Layers
@@ -385,7 +398,7 @@ const counter = createSlice({
 
 	methods: {},
 
-	children: {}, // Planned
+	children: {},
 
 	subscribe: {}, // Planned
 });
@@ -421,9 +434,8 @@ methods: {
 
 **Rules:**
 
-- Slice names should not contain `"."` or `"/"`, because dots are reserved for nested slice paths
+- Names should not contain `"."` or `"/"`, because they are reserved for nested slice paths
 - Two slices cannot share the same name
-- Registering the same slice instance multiple times with the same name is not allowed
 
 ---
 
@@ -605,80 +617,127 @@ This currently not supported
 
 ---
 
-## Nested Slices (Planned)
-
-This currently not supported
+## Nested Slices
 
-~~Slices can be composed by registering other slices through the `children` property.~~
+Slices can be composed by registering other slice instances through the `children` property.
 
-~~This allows related state and behavior to be organized into a hierarchical structure while preserving full type inference.~~
+This allows related state and behavior to be organized into a hierarchical structure while preserving full type inference and ownership isolation.
 
 ```ts
-// import { counter } from "./counterSlice";
-// import { users } from "./usersSlice";
+import { products } from "./productsSlice";
+import { categories } from "./categoriesSlice";
 
-// export const app = createSlice({
-//   name: "app",
+export const shop = createSlice({
+  name: "shop",
 
-//   state: {},
+  state: {},
 
-//   children: {
-//     counter,
-//     users,
-//   },
-// });
+  children: {
+    products,
+    categories,
+  },
+});
+```
+
+**Accessing Child Slices:**
+
+Child slices are exposed directly on their parent slice.
+
+```ts
+shop.products.add(...)
+shop.categories.create(...)
+
+console.log(shop.products.getState());
 ```
 
-**~~Rules:~~**
+Deeply nested slice hierarchies are fully supported.
+
+```ts
+admin.users.permissions.grant(...);
+
+console.log(admin.users.permissions.getState());
+```
 
-- ~~A slice instance can only be registered once within the same state tree~~
-- ~~Existing slice instances cannot be wrapped again with `createSlice`~~
-- ~~Child slices must be registered through the `children` property~~
+### Reusing Slices
 
-**~~Accessing Child Slices:~~**
+A slice can be mounted multiple times within the same tree.
 
-~~Child slices are exposed directly on their parent slice.~~
+When the same slice definition is reused, OrcheStore automatically creates a separate mounted instance for each location.
 
 ```ts
-// app.counter.increment(1);
+const paginationSlice = createSlice({ ... });
 
-// console.log(app.counter.getState());
+const shopSlice = createSlice({
+  name: "shop",
+
+  state: {},
+
+  children: {
+    categories: paginationSlice,
+    products: paginationSlice,
+  },
+});
+
+const adminSlice = createSlice({
+  name: "admin",
+
+  state: {},
+
+  children: {
+    products: paginationSlice,
+  },
+});
 ```
 
-~~Deeply nested slice hierarchies are fully supported.~~
+Each mounted instance has:
+
+- its own path
+- its own ownership context
+- its own runtime state
+
+**Runtime identity:**
+
+Although all mounted slices originate from `paginationSlice`, they are not necessarily the same runtime instance.
 
 ```ts
-// admin.users.permissions.grant(...);
+paginationSlice === shopSlice.categories; // First mount uses the original instance
+
+paginationSlice !== shopSlice.products;   // Different mount location creates a clone
+paginationSlice !== adminSlice.products;  // Different mount location creates a clone
 
-// console.log(admin.users.permissions.getState());
+shopSlice.products !== adminSlice.products; // Independent mounted clones
 ```
 
-### Runtime Paths (Planned)
+Every mount location receives its own isolated instance.
 
-~~Every slice exposes a runtime path through `getPath`.~~
+For a deeper explanation of how slice reuse works, see [Lineage & Clones](#lineage--clones).
+
+### Runtime Paths
+
+Every slice exposes a runtime path through `slice.path`.
 
 ```ts
-// store.counter.name;      // "counter"
-// store.counter.getPath(); // "counter"
+store.counter.name; // "counter"
+store.counter.path; // "counter"
 ```
 
-~~Nested slices automatically inherit their parent path.~~
+Nested slices automatically inherit their parent path.
 
 ```ts
-// store.admin.users.name;      // "users"
-// store.admin.users.getPath(); // "admin.users"
+store.admin.users.name; // "users"
+store.admin.users.path; // "admin.users"
 
-// store.admin.users.permissions.name;      // "permissions"
-// store.admin.users.permissions.getPath(); // "admin.users.permissions"
+store.admin.users.permissions.name; // "permissions"
+store.admin.users.permissions.path; // "admin.users.permissions"
 ```
 
-**~~Notes:~~**
+**Notes:**
 
-~~Paths are generated automatically from the slice hierarchy.~~
+Paths are generated automatically from the slice hierarchy.
 
-~~OrcheStore builds on the same concepts as Redux Toolkit's `reducerPath` and `combinedReducers`, but automates path generation, reducer registration, and nested slice composition.~~
+OrcheStore builds on the same concepts as Redux Toolkit's `reducerPath` and `combineReducers`, but automates path generation, reducer registration, and nested slice composition.
 
-~~No manual path configuration or reducer injection is required.~~
+No manual path configuration or reducer injection is required.
 
 ---
 
@@ -906,6 +965,158 @@ this.root; // After: fully typed store
 
 ---
 
+# Lineage & Clones
+
+OrcheStore uses a lineage-based model for slice identity.
+
+**Why?**
+
+Slices can be used in multiple places in the store tree.
+
+When this happens, OrcheStore creates a separate runtime instance for each usage. These instances are called **clones**.
+
+A clone is an independent instance copy of a slice at runtime. It has its own state and runs separately from other clones, while still remaining part of a shared lineage.
+
+A lineage (or family) is the set of all instances that come from the same slice definition.
+
+**This means:**
+
+- slices are not singletons
+- a slice can appear multiple times in a tree
+- each clone is fully isolated
+- all instances cloned from the same slice are linked through lineage
+
+## Automatic Cloning
+
+When a slice is reused through `children` or `slices`, OrcheStore automatically creates a new mounted instance for each usage.
+
+```ts
+const paginationSlice = createSlice({ ... });
+
+const shopSlice = createSlice({
+	name: "shop",
+
+	state: {},
+
+	children: {
+		a: paginationSlice,
+		b: paginationSlice,
+	},
+});
+
+const adminSlice = createSlice({
+	name: "admin",
+
+	state: {},
+
+	children: {
+		a: paginationSlice,
+	},
+});
+```
+
+Each mount becomes a separate runtime node:
+
+```ts
+shopSlice.a !== shopSlice.b;
+shopSlice.a !== adminSlice.a;
+shopSlice.b !== adminSlice.a;
+```
+
+Each instance also receives its own path and its own ownership context:
+
+```ts
+shopSlice.a.path;   // "shop.a"
+shopSlice.b.path;   // "shop.b"
+adminSlice.a.path;  // "admin.a"
+```
+
+Although these instances are independent at runtime, they still belong to the same lineage.
+
+## Manual Cloning
+
+A new detached clone can be created manually from any slice instance:
+
+```ts
+const clone = slice.prototype.clone();
+```
+
+The new instance:
+
+- belongs to the same lineage
+- starts detached from the tree
+- has no mounted path initially
+- has its own ownership context
+
+## Inspecting a Lineage
+
+**Get All Related Instances:**
+
+Returns every instance in the lineage, **including** the current one.
+
+```ts
+const lineage = slice.prototype.getLineage();
+```
+
+Useful for:
+
+- debugging slice reuse
+- inspecting mounted instances
+- understanding tree distribution
+
+**Get Clones:**
+
+Returns all lineage members **except** the current instance.
+
+```ts
+const siblings = slice.prototype.getClones();
+```
+
+Useful for:
+
+- communicating between clones
+- broadcast or synchronization scenarios
+- comparing mounted instances
+
+## Definition Type Checking
+
+You can determine whether two slices belong to the same lineage:
+
+You can check whether two slices belong to the same lineage:
+
+```ts
+const isSameLineage = slice.prototype.isTypeOf(otherSlice);
+```
+
+Returns `true` when both slices originate from the same slice definition, even if they are different runtime instances.
+
+```ts
+const slice1 = createSlice(...);
+const slice2 = createSlice(...);
+
+const clone1 = slice1.prototype.clone();
+const clone2 = clone1.prototype.clone();
+
+slice1.prototype.isTypeOf(clone1); // true
+clone1.prototype.isTypeOf(clone2); // true
+clone2.prototype.isTypeOf(slice1); // true
+
+slice1.prototype.isTypeOf(slice2); // false
+slice2.prototype.isTypeOf(clone1); // false
+```
+
+## Summary
+
+- Reusing a slice automatically creates mounted clones.
+- `clone()` creates a new detached lineage member.
+- Every clone is isolated at runtime.
+- All clones from the same definition belong to a shared lineage.
+- `getLineage()` returns all instances in a lineage.
+- `getClones()` returns all related instances except the current one.
+- `isTypeOf()` checks whether two instances belong to the same lineage.
+
+---
+
 # Global Utilities
 
 Global utilities allow slices and the root store to access shared runtime services through `global`.
@@ -1055,15 +1266,15 @@ const counter = createSlice({
 		},
 	},
 
-	// children: {
-	//   subCounter: createSlice({
-	//     name: "subCounter",
+	children: {
+	  subCounter: createSlice({
+	    name: "subCounter",
 
-	//     state: {
-	//       value: 0,
-	//     },
-	//   }),
-	// },
+	    state: {
+	      value: 0,
+	    },
+	  }),
+	},
 });
 ```
 
@@ -1071,11 +1282,10 @@ Automatically produces:
 
 ```ts
 counter.getState();
-// { value: number }
-// { value: number, subCounter: { value: number } } // Planned
+// { value: number, subCounter: { value: number } }
 
-// counter.subCounter.getState();
-// { value: number } // Planned
+counter.subCounter.getState();
+// { value: number }
 
 counter.increment(amount: number): void;
 

package/dist/index.cjs

@@ -1,30 +1,30 @@
-"use strict";var ee=Object.create;var b=Object.defineProperty;var re=Object.getOwnPropertyDescriptor;var te=Object.getOwnPropertyNames;var oe=Object.getPrototypeOf,ne=Object.prototype.hasOwnProperty;var ie=(e,r)=>{for(var t in r)b(e,t,{get:r[t],enumerable:!0})},K=(e,r,t,o)=>{if(r&&typeof r=="object"||typeof r=="function")for(let n of te(r))!ne.call(e,n)&&n!==t&&b(e,n,{get:()=>r[n],enumerable:!(o=re(r,n))||o.enumerable});return e};var ae=(e,r,t)=>(t=e!=null?ee(oe(e)):{},K(r||!e||!e.__esModule?b(t,"default",{value:e,enumerable:!0}):t,e)),se=e=>K(b({},"__esModule",{value:!0}),e);var xe={};ie(xe,{StoreProvider:()=>G,configureDiagnostics:()=>P,createSlice:()=>Y,createStore:()=>Z,default:()=>be,getGlobalUtils:()=>m,provideGlobalUtils:()=>D});module.exports=se(xe);var X=require("@reduxjs/toolkit"),_=require("react-redux");var y="all",$={diagnostics:!1,prerelease:!1},q=globalThis.console?.log?.bind?.(globalThis.console)||globalThis.console?.log,le=globalThis.console?.warn?.bind?.(globalThis.console)||globalThis.console?.warn,ce=globalThis.console?.error?.bind?.(globalThis.console)||globalThis.console?.error,de=globalThis.console?.clear?.bind?.(globalThis.console)||globalThis.console?.clear;globalThis.console?.clear&&(globalThis.console.clear=(...e)=>{$.diagnostics=!1,de?.(...e)});var ue=`[OrcheStore] \u{1F6A7} Pre-release Notice
+"use strict";var ue=Object.create;var C=Object.defineProperty;var pe=Object.getOwnPropertyDescriptor;var fe=Object.getOwnPropertyNames;var ye=Object.getPrototypeOf,me=Object.prototype.hasOwnProperty;var he=(e,t)=>{for(var r in t)C(e,r,{get:t[r],enumerable:!0})},_=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of fe(t))!me.call(e,i)&&i!==r&&C(e,i,{get:()=>t[i],enumerable:!(o=pe(t,i))||o.enumerable});return e};var ge=(e,t,r)=>(r=e!=null?ue(ye(e)):{},_(t||!e||!e.__esModule?C(r,"default",{value:e,enumerable:!0}):r,e)),Se=e=>_(C({},"__esModule",{value:!0}),e);var Ne={};he(Ne,{StoreProvider:()=>J,configureDiagnostics:()=>K,createSlice:()=>le,createStore:()=>ce,default:()=>Ue,getGlobalUtils:()=>v,provideGlobalUtils:()=>L});module.exports=Se(Ne);var oe=require("@reduxjs/toolkit"),ne=require("react-redux");var R="all",k={diagnostics:!1,prerelease:!1},B=globalThis.console?.log?.bind?.(globalThis.console)||globalThis.console?.log,be=globalThis.console?.warn?.bind?.(globalThis.console)||globalThis.console?.warn,ve=globalThis.console?.error?.bind?.(globalThis.console)||globalThis.console?.error,xe=globalThis.console?.clear?.bind?.(globalThis.console)||globalThis.console?.clear;globalThis.console?.clear&&(globalThis.console.clear=(...e)=>{k.diagnostics=!1,xe?.(...e)});var Te=`[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!
-`,pe=`[OrcheStore] Diagnostics are enabled.
+`,we=`[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").
-`,s={inform(e){$[e]||($[e]=!0,y==="all"&&q?.(e==="prerelease"?ue:pe))},log(...e){y==="all"&&(s.inform("diagnostics"),q?.(...e))},warn(...e){y==="all"&&(s.inform("diagnostics"),le?.(...e))},error(...e){y!=="off"&&(s.inform("diagnostics"),ce?.(...e))}};function P(e){y=e}var z=(...e)=>{let[r,t]=[e[2],e[3]],o=`${e[0]||"Received"}: `,n=e[1]!==!1?"(type: "+typeof r+")":"";if(!t?.(r))return r==null?[`${o}(type: ${r})`]:typeof r=="number"||typeof r=="bigint"||typeof r=="boolean"?[`${o}${n} ${r}`]:typeof r=="object"?[o,r]:r===""?[`${o}Empty String`]:[`${o}${n}`,r]},g=((e,r)=>z("Received",!0,e,r));g.prefixed=(e,r,t,o)=>z(e,r,t,o);var fe=Object.assign,M=Object.getOwnPropertyDescriptor(Object,"defineProperty")?.value||Object.defineProperty,me=(e,r,t)=>{M(e,r,{get:t,enumerable:!0,configurable:!1})},Se=(e,r,t)=>{M(e,r,{value:t,writable:!1,enumerable:!0,configurable:!1})},d={assign:fe,defineProp:M,defineReadonly:me,defineMethod:Se},L={isArray:Array.isArray},x={get:Reflect.get,set:Reflect.set,delete:Reflect.deleteProperty};var k={InvalidStore:e=>({StoreType:[`[OrcheStore::StoreProvider] Expected a store instance created with createStore(...).
-`,...g(e)]})},v={GetMissingProp:e=>["[OrcheStore::global-utils] Attempted to access a global utility before it became available. Missing property",e,`
+`,l={inform(e){k[e]||(k[e]=!0,R==="all"&&B?.(e==="prerelease"?Te:we))},log(...e){R==="all"&&(l.inform("diagnostics"),B?.(...e))},warn(...e){R==="all"&&(l.inform("diagnostics"),be?.(...e))},error(...e){R!=="off"&&(l.inform("diagnostics"),ve?.(...e))}};function K(e){R=e}var H=(...e)=>{let[t,r]=[e[2],e[3]],o=`${e[0]||"Received"}: `,i=e[1]!==!1?"(type: "+typeof t+")":"";if(!r?.(t))return t==null?[`${o}(type: ${t})`]:typeof t=="number"||typeof t=="bigint"||typeof t=="boolean"?[`${o}${i} ${t}`]:typeof t=="object"?[o,t]:t===""?[`${o}Empty String`]:[`${o}${i}`,t]},E=((e,t)=>H("Received",!0,e,t));E.prefixed=(e,t,r,o)=>H(e,t,r,o);var Oe=Object.assign,D=Object.getOwnPropertyDescriptor(Object,"defineProperty")?.value||Object.defineProperty,Ee=(e,t,r)=>{D(e,t,{get:r,enumerable:!0,configurable:!1})},Me=(e,t,r)=>{D(e,t,{value:r,writable:!1,enumerable:!0,configurable:!1})},u={assign:Oe,defineProp:D,defineReadonly:Ee,defineMethod:Me},Q={isArray:Array.isArray},I={get:Reflect.get,set:Reflect.set,delete:Reflect.deleteProperty};var V={InvalidStore:{InvalidType:e=>[`[OrcheStore::StoreProvider] Expected a store instance created with createStore(...).
+`,...E(e)]}},U={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.
-`},T={InvalidChild:e=>`[OrcheStore::createStore] Child slice '${e}' must be a slice created with createSlice(...).`,singletonLimitation:()=>`[OrcheStore::createStore] createStore(...) was called more than once.
+`},N={InvalidChild:e=>`[OrcheStore::createStore] Child slice '${e}' must be a slice created with createSlice(...).`,singletonLimitation:()=>`[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 execute on every render.`},u={InvalidStore:(e,r,t)=>({StoreType:[`[OrcheStore::${r}] Unable to resolve a valid store instance.
-This operation requires a store created with createStore(...).
-`,...g(e)],NeverExposed:[`[OrcheStore::${r}] Slice {${t}} has not been exposed in any store.
-Ensure the slice is reachable from a store instance.
-This can be done by exposing the slice directly through createStore({ slices: ... }) or indirectly through a parent slice using createSlice({ children: ... }).`],NotInTree:[`[OrcheStore::${r}] Slice {${t}} is not exposed within the target store.
-A slice can only be accessed through stores that expose it.
-`,...g.prefixed("Current store",!1,e)]}),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 state for slice {${e}}.`,InvalidState:(e,r)=>[`[OrcheStore::createSlice]${f.target({slice:e})}Slice state must be a non-null object or a function that returns a non-null object.
-`,...g(r)],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 created with createSlice(...).`,ReduxReducerConflict:()=>"[OrcheStore::createSlice] Redux Toolkit asyncThunk reducers are not supported inside mutations. Use methods instead."},f={target:({slice:e})=>e?` Affected slice '${e}':
-`:" ",RequiredName:(e,r)=>`[OrcheStore::${e.module}]${f.target(e)}${r} keys must be non-empty strings.`,InvalidName:(e,r,t)=>`[OrcheStore::${e.module}]${f.target(e)}${r} names cannot contain '.' or '/'. Received: ${t}.`,ReservedKey:(e,r,t)=>`[OrcheStore::${e.module}]${f.target(e)}'${t}' is a reserved name and cannot be used as a ${r} key.`,DuplicateKey:(e,r,t)=>`[OrcheStore::${e.module}]${f.target(e)}${r} name '${t}' conflicts with another member.`};var C=new Proxy({},{get(e,r,t){return r in e||s.error(...v.GetMissingProp(r)),x.get(e,r,t)},set(e,r,t,o){return x.set(e,r,t,o)},deleteProperty(e,r){return s.warn(...v.DeleteProp(r)),x.delete(e,r)}});function m(){return C}function D(e){let r=g(e,t=>t&&typeof t=="object"&&!L.isArray(t));return r?s.error(v.InvalidArgs(),...r):d.assign(C,e),C}function h(e,r){let t={children:{}};return Object.keys(e).filter(n=>n.startsWith(r)).map(n=>n.split(".")).sort((n,a)=>n.length-a.length).forEach(n=>{let a=t;n.slice(0,n.length-1).forEach(i=>a=a[i]||={}),a.children||={},a.children[n[n.length-1]]={...e[n.join(".")]}}),t.children}var W=(e,r)=>{if(e)if(r==="warn")s.warn(e);else if(r==="error")s.error(e);else throw new Error(e);else return!1},j=(e,r="",t="",o)=>typeof e!="string"||!e?!!W(r,o?.[0]):e.includes(".")||e.includes("/")?!!W(t,o?.[1]):!0,ge=(e,r,t,o)=>{let n=f.RequiredName(e,r),a=f.InvalidName(e,r,t);if(j(t,n,a,["error","error"])){if(o[0].includes(t))return s.error(f.ReservedKey(e,r,t));if(o[1].includes(t))return s.error(f.DuplicateKey(e,r,t))}else return;return!0},E=e=>{let r=[],t=[e.reserved,r];return(o,n,a)=>(Object.entries(n).forEach(([i,c])=>{let l=ge(e,o,i,t)?a(i,c):void 0;if(l===void 0)return delete n[i];n[i]=l,r.push(i)}),n)},O=(e,r)=>{let t={...e||{}};return r.objects?.forEach(o=>{t[o]=typeof t[o]=="object"&&t[o]?{...t[o]}:{}}),r.validate?.(t),r.redux?.forEach(o=>{t[o]!==void 0&&s.warn(`[OrcheStore::${r.method}] '${o}' property is a Redux Toolkit option and is ignored by OrcheStore.`)}),r.unsupported?.forEach(o=>{Object.keys(t[o]).length<1||s.warn(`[OrcheStore::${r.method}] '${o}' property is not yet supported and will be ignored.`)}),t};var w=require("@reduxjs/toolkit");var F=require("react-redux"),J=[],V=e=>{let r={children:{},roots:[]},t=r.slice={},o=O(e,{method:"createSlice",objects:["mutations","computed","methods","children"],unsupported:["computed","children"],redux:["reducers","extraReducers","reducerPath","initialState","selectors"],validate:ye}),n=E({module:"createSlice",slice:o.name,reserved:["name","computed","root","global","getState","useSelect","getPath"]});return n("mutation",o.mutations,(a,i)=>i?._reducerDefinitionType===w.ReducerType.asyncThunk||"reducer"in{...i||{}}?s.error(u.ReduxReducerConflict()):typeof i!="function"?s.error(u.InvalidMutation(a)):((l,A)=>i(l,...A.payload))),r.redux=(0,w.createSlice)({name:o.name,initialState:o.state,reducers:o.mutations}),d.defineReadonly(t,"name",()=>o.name),d.defineReadonly(t,"global",()=>m()),d.defineMethod(t,"getPath",()=>I(t)),d.defineMethod(t,"getState",()=>{let a=u.InvalidStore(void 0,"slice.getState",o.name),i=S(r,void 0,a).redux.getState();return h(i,I(t))}),d.defineMethod(t,"useSelect",a=>{let i=u.InvalidStore(void 0,"slice.useSelect",o.name);return S(r,void 0,i),(0,F.useSelector)(c=>{let l={global:m()};return a.call(l,h(c,I(t)),l)})}),Object.entries(r.redux.actions).map(([a,i])=>{t[a]=(...c)=>{let l=u.InvalidStore(void 0,"slice mutation",o.name);return S(r,void 0,l).redux.dispatch(i(c))}}),n("method",o.methods,(a,i)=>typeof i!="function"?s.error(u.InvalidMethod(a)):t[a]=(...c)=>i.apply(t,c)),J.push(r),t};function U(e){return J.find(r=>r.slice===e)}var N=(e,r,t,o,n)=>{let{redux:a,children:i}=r;return r.path=e,r.roots.push(o),n[e]=a.reducer,Object.entries(i).forEach(([c,l])=>{N(e+"."+c,U(l),r.slice,o,n)}),t[e]=r.slice},ye=e=>{let r=t=>{if(typeof t!="object"){let o=u.InvalidState(e.name,t);throw o.every(n=>typeof n=="string")?new Error(o.join(" ")):(s.error(...o),new Error)}if(!t)throw new Error(u.RequiredState(e.name));return t};if(j(e.name,u.RequiredName(),u.InvalidName(e.name)),typeof e.state=="function"){let t=e.state;e.state=()=>r(t())}else r(e.state)},I=e=>e.name;var R=[],B=e=>{let r={},t=r.store={},o=O(e,{method:"createStore",objects:["slices"],redux:["reducer","devTools","duplicateMiddlewareCheck","enhancers","middleware","preloadedState"]}),n=E({module:"createStore",reserved:["name","computed","global","getState","useSelect"]});d.defineReadonly(t,"name",()=>"default"),d.defineReadonly(t,"global",()=>m()),d.defineMethod(t,"getState",()=>h(r.redux.getState(),"")),d.defineMethod(t,"useSelect",i=>(0,_.useSelector)(c=>{let l={global:m()};return i.call(l,h(c,""),l)}));let a={};return n("slice",o.slices,(i,c)=>{let l=U(c);return l?N(i,l,t,t,a):s.error(T.InvalidChild(i))}),r.redux=(0,X.configureStore)({reducer:a}),R.push(r),t},S=(e,r,t={})=>{if(t===!1)return R[0];let o;if((!e||r!==void 0)&&!R.find(n=>n.store===r)?o=t.StoreType:e&&!e.roots.length?o=t.NeverExposed:e&&r&&!e.roots.includes(r)&&(o=t.NotInTree),r=e&&r===void 0?e.roots[0]:r,o)throw o.every(n=>typeof n=="string")?new Error(o.join(" ")):(s.error(...o),new Error);return R.find(n=>n.store===r)};var H=ae(require("react"),1),Q=require("react-redux");function G(e){let{store:r,...t}={...e||{}},o=S(void 0,r,k.InvalidStore(r));return H.default.createElement(Q.Provider,{...t,store:o.redux})}var Y=e=>(s.inform("prerelease"),V(e)),Z=e=>(s.inform("prerelease"),S(void 0,void 0,!1)?(s.warn(T.singletonLimitation()),S(void 0,void 0,!1).store):B(e)),be={createStore:Z,createSlice:Y,StoreProvider:G,provideGlobalUtils:D,getGlobalUtils:m,configureDiagnostics:P};0&&(module.exports={StoreProvider,configureDiagnostics,createSlice,createStore,getGlobalUtils,provideGlobalUtils});
+Avoid useState(createStore(...)) because createStore(...) will execute on every render.`},b={InvalidStore:(e,t)=>({NeverExposed:[`[OrcheStore::${e}] Slice {${t}} is not reachable from any store instance.
+A slice must be connected to a store via one of the following:
+\u2022 createStore({ slices: ... }) \u2014 expose it directly in the root store
+\u2022 createSlice({ children: ... }) \u2014 attach it under another slice that is already reachable`],InvalidType:r=>[`[OrcheStore::${e}] Slice {${t}} depends on parent slice {${r.name}}, but that parent is not reachable from any store instance.
+Fix the parent first using one of the following:
+\u2022 createStore({ slices: ... }) \u2014 expose the parent directly in the root store
+\u2022 createSlice({ children: ... }) \u2014 attach the parent under another parent slice that is already reachable`]}),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 state for slice {${e}}.`,InvalidState:(e,t)=>[`[OrcheStore::createSlice]${S.target({slice:e})}Slice state must be a non-null object or a function that returns a non-null object.
+`,...E(t)],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 created with createSlice(...).`,ReduxReducerConflict:()=>"[OrcheStore::createSlice] Redux Toolkit asyncThunk reducers are not supported inside mutations. Use methods instead."},S={target:({slice:e})=>e?` Affected slice '${e}':
+`:" ",RequiredName:(e,t)=>`[OrcheStore::${e.module}]${S.target(e)}${t} keys must be non-empty strings.`,InvalidName:(e,t,r)=>`[OrcheStore::${e.module}]${S.target(e)}${t} names cannot contain '.' or '/'. Received: ${r}.`,ReservedKey:(e,t,r)=>`[OrcheStore::${e.module}]${S.target(e)}'${r}' is a reserved name and cannot be used as a ${t} key.`,DuplicateKey:(e,t,r)=>`[OrcheStore::${e.module}]${S.target(e)}${t} name '${r}' conflicts with another member.`};var q=new Proxy({},{get(e,t,r){return t in e||l.error(...U.GetMissingProp(t)),I.get(e,t,r)},set(e,t,r,o){return I.set(e,t,r,o)},deleteProperty(e,t){return l.warn(...U.DeleteProp(t)),I.delete(e,t)}});function v(){return q}function L(e){let t=E(e,r=>r&&typeof r=="object"&&!Q.isArray(r));return t?l.error(U.InvalidArgs(),...t):u.assign(q,e),q}var{createNodeFactory:j}={createNodeFactory({factoryName:e,instantiate:t,options:r={}}){let o=new Map,i=new Map,p=d=>{d=r.adapt?r.adapt(d):d,d=r.register?r.register(d):d;let n={familyId:Symbol("family"),path:"",children:new Map,parents:[]},a={props:d,siblings:new Set};return n.node=t(d,n,a),a.siblings.add(n.node),o.set(n.node,n),i.set(n.familyId,a),n.node},x=(d,n)=>{let a=o.get(d),s=a?i.get(a.familyId):void 0;if(!a||!s){if(n?.UnknownNode)return void n?.UnknownNode?.("",d);throw new Error(`[OrcheStore] ${e} factory: Unknown node`)}return m("",[],a,s,!0,()=>{})},y=(d,n,a,s,c)=>{let f=o.get(n),w=f?i.get(f.familyId):void 0;if(!f||!w){if(c?.UnknownNode)return void c?.UnknownNode?.(d,n);throw new Error(`[OrcheStore] ${e} factory: Unknown node`)}let h=s||o.get(a);if(!h){if(c?.UnknownParent)return void c?.UnknownParent?.(d,n,a);throw new Error(`[OrcheStore] ${e} factory: Unknown parent node`)}for(let $ of[a,...h.parents])if($===n){if(c?.InfiniteOwnership)return void c?.InfiniteOwnership?.(d,n,a);throw new Error(`[OrcheStore] ${e} factory: Infinite ownership recursion`)}let O=(h.path?`${h.path}.`:"")+d,M=[a,...h.parents];return m(O,M,f,w,!1,$=>h.children.set(d,$))};function m(...d){let[n,a,s,c,f,w]=d;if(f=f||s.parents.length>0&&(s.parents[0]!==a[0]||s.path.split(".").at(-1)!==n.split(".").at(-1)),f){let h={familyId:s.familyId,path:n,children:new Map(s.children),parents:a},O=r.clone?r.clone(c.props,s,c):c.props;s=h,s.node=t(O,h,c),o.set(s.node,h),c.siblings.add(s.node)}s.path=n,s.parents=a,w?.(s.node);for(let[h,O]of[...s.children.entries()]){let M=o.get(O),$=M?i.get(M.familyId):void 0,de=`${n}${n?".":""}${h}`;m(de,[s.node,...a],M,$,!1,X=>{X!==O&&s.children.set(h,X)})}return s.node}return{families:i,instances:o,create:p,attach:y,clone:x}}};var G=require("@reduxjs/toolkit"),ee=require("react-redux");var Y=(e,t)=>{if(e)if(t==="warn")l.warn(e);else if(t==="error")l.error(e);else throw new Error(e);else return!1},z=(e,t="",r="",o)=>typeof e!="string"||!e?!!Y(t,o?.[0]):e.includes(".")||e.includes("/")?!!Y(r,o?.[1]):!0,$e=(e,t,r,o)=>{let i=S.RequiredName(e,t),p=S.InvalidName(e,t,r);if(z(r,i,p,["error","error"])){if(o[0].includes(r))return l.error(S.ReservedKey(e,t,r));if(o[1].includes(r))return l.error(S.DuplicateKey(e,t,r))}else return;return!0},A=e=>{let t=[],r=[e.reserved,t];return(o,i,p,x)=>{let y=i?[]:{};return Object.entries(p).forEach(([m,d])=>{let n=$e(e,o,m,r)?x(m,d):void 0;n!==void 0&&(i?y.push([m,n]):y[m]=n,t.push(m))}),y}},F=(e,t)=>{let r={...e||{}};return t.objects?.forEach(o=>{r[o]=typeof r[o]=="object"&&r[o]?{...r[o]}:{}}),t.validate?.(r),t.redux?.forEach(o=>{r[o]!==void 0&&l.warn(`[OrcheStore::${t.method}] '${o}' property is a Redux Toolkit option and is ignored by OrcheStore.`)}),t.unsupported?.forEach(o=>{Object.keys(r[o]).length<1||l.warn(`[OrcheStore::${t.method}] '${o}' property is not yet supported and will be ignored.`)}),r};var{families:Re,instances:P,create:Pe,attach:W,clone:Ce}=j({factoryName:"slice",instantiate(e,t,r){let o={},i=n=>T(void 0,t,n?b.InvalidStore(n,e.name):!1),p=A({module:"createSlice",slice:e.name,reserved:["name","path","computed","root","parent","prototype","global","getState","useSelect"]}),x=p("mutation",!1,e.mutations,(n,a)=>a?._reducerDefinitionType===G.ReducerType.asyncThunk||"reducer"in{...a||{}}?l.error(b.ReduxReducerConflict()):typeof a!="function"?l.error(b.InvalidMutation(n)):(c,f)=>f?.meta?.path===t.path?a(c,...f.payload):c);t.redux=(0,G.createSlice)({name:e.name,initialState:e.state,reducers:x}),u.defineReadonly(o,"name",()=>e.name),u.defineReadonly(o,"path",()=>t.path),u.defineReadonly(o,"global",()=>v()),u.defineReadonly(o,"root",()=>i().node),u.defineReadonly(o,"parent",()=>{let n=t.parents[0];return(n?P.get(n):void 0)?.node}),u.defineMethod(o,"getState",()=>{let n=i("slice.getState").redux.getState();return t.path.split(".").forEach(a=>n=(n||{})[a]),n}),u.defineMethod(o,"useSelect",n=>{let a={global:v(),root:i("slice.useSelect").node};return(0,ee.useSelector)(s=>(t.path.split(".").forEach(c=>s=(s||{})[c]),n.apply(a,[s,a])))}),u.defineReadonly(o,"computed",()=>{});let y={},m=()=>[...r.siblings.values()||[]];u.defineReadonly(o,"prototype",()=>y),u.defineMethod(y,"clone",()=>Ce(o)),u.defineMethod(y,"getLineage",()=>m()),u.defineMethod(y,"getClones",()=>m().filter(n=>n!==o)),u.defineMethod(y,"isTypeOf",n=>r===Re.get(P.get(n)?.familyId)),Object.entries(t.redux.actions).map(([n,a])=>{o[n]=(...s)=>{i("slice mutation").redux.dispatch({...a(s),meta:{path:t.path}})}}),p("method",!1,e.methods,(n,a)=>typeof a!="function"?l.error(b.InvalidMethod(n)):o[n]=(...s)=>a.apply(o,s));let d=p("child",!0,e.children,(n,a)=>{let c=W(n,a,o,t,{UnknownNode:f=>l.error(b.InvalidChild(f))});if(c)return o[n]=c,P.get(c).reducers});return t.reducers=(n,a)=>{let s=a?.meta?.path;if(typeof s=="string"&&!s.startsWith(t.path))return n;let c={...t.redux.reducer(n,a)};for(let[f,w]of d)c[f]=w(c?.[f],a);return c},o},options:{adapt(e){return F(e,{method:"createSlice",objects:["mutations","computed","methods","children"],unsupported:["computed"],redux:["reducers","extraReducers","reducerPath","initialState","selectors"],validate(t){z(t.name,b.RequiredName(),b.InvalidName(t.name));let r=t.state;if(typeof r!="function")return void Z(t.name,r);t.state=()=>Z(t.name,r())}})},clone(e,t){let r=t.redux.getInitialState();return{...e,state:r}}}}),Z=(e,t)=>{if(typeof t!="object"){let r=b.InvalidState(e,t);throw r.every(o=>typeof o=="string")?new Error(r.join(" ")):(l.error(...r),new Error)}if(!t)throw new Error(b.RequiredState(e));return t},te=e=>Pe(e);var{instances:re,create:Ie}=j({factoryName:"slice",instantiate(e,t){let r={},o=A({module:"createStore",reserved:["name","computed","global","getState","useSelect"]});return u.defineReadonly(r,"name",()=>"default"),u.defineReadonly(r,"global",()=>v()),u.defineMethod(r,"getState",()=>t.redux.getState()),u.defineMethod(r,"useSelect",i=>{let p={global:v(),root:r};return(0,ne.useSelector)(x=>i.apply(p,[x,p]))}),t.reducers=o("slice",!1,e.slices,(i,p)=>{let y=W(i,p,r,t,{UnknownNode:m=>l.error(N.InvalidChild(m))});if(y)return r[i]=y,P.get(y).reducers}),t.redux=(0,oe.configureStore)({reducer:t.reducers}),r},options:{adapt(e){return F(e,{method:"createStore",objects:["slices"],redux:["reducer","devTools","duplicateMiddlewareCheck","enhancers","middleware","preloadedState"]})}}}),T=(e,t,r=!1)=>{if(r===!0)return[...re.values()][0];e||=t?.parents?.at?.(-1);let o=e?re.get(e):void 0,i=[];if(t&&!e?i=r===!1?[]:r.NeverExposed:o||(i=r===!1?[]:r.InvalidType(e)),i&&i.length)throw i.every(p=>typeof p=="string")?new Error(i.join(" ")):(l.error(...i),new Error);return o},ae=e=>Ie(e);var ie=ge(require("react"),1),se=require("react-redux");function J(e){let{store:t,...r}={...e||{}},o=T(t,void 0,V.InvalidStore);return ie.default.createElement(se.Provider,{...r,store:o.redux})}var le=e=>(l.inform("prerelease"),te(e)),ce=e=>(l.inform("prerelease"),T(void 0,void 0,!0)?(l.warn(N.singletonLimitation()),T(void 0,void 0,!0).node):ae(e)),Ue={createStore:ce,createSlice:le,StoreProvider:J,provideGlobalUtils:L,getGlobalUtils:v,configureDiagnostics:K};0&&(module.exports={StoreProvider,configureDiagnostics,createSlice,createStore,getGlobalUtils,provideGlobalUtils});

package/dist/index.d.cts

@@ -1,8 +1,10 @@
 import React from 'react';
 import { ProviderProps } from 'react-redux';
 
-/** String-keyed object map. */
+/** `Record` with string keys, requiring only the value type. */
 type Dict<Value = any> = Record<string, Value>;
+/** `Record` with default property keys, requiring only the value type. */
+type Obj<Value = any> = Record<PropertyKey, Value>;
 /** Returns all tuple elements except the first. */
 type Tail<T extends any[]> = T extends [any, ...infer R] ? R : T extends (infer U)[] ? U[] : never;
 /** Removes properties whose value type is `never`. */
@@ -15,24 +17,44 @@ type ReadOnly<T> = T extends (...args: any[]) => any ? T : T extends readonly (i
 } : T;
 
 /** Runtime slice API exposed by createSlice(...). */
-type slice<S, R extends Mutations<S>, M> = GlobalUtils & {
+type slice<S extends Obj, R extends Mutations<S, C>, M, C> = GlobalUtils & {
     /** Unique slice identifier. */
     readonly name: string;
+    /** Fully qualified runtime path of the slice. */
+    readonly path: string;
     /** Returns the latest immutable state snapshot. */
-    readonly getState: () => SliceState<S, true>;
+    readonly getState: () => SliceState.State<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: GlobalUtils, state: SliceState<S, true>, context: GlobalUtils) => T) => T;
-    /** Returns fully qualified runtime path of the slice. */
-    readonly getPath: () => string;
-} & {
+    readonly useSelect: <T>(selector: (this: GlobalUtils, state: SliceState.State<S, C>, context: GlobalUtils) => T) => T;
+    /** Root store that owns this slice instance. */
+    root: store<any>;
+    /** Parent slice in the hierarchy, if mounted under another slice. */
+    parent: slice<any, Mutations<any, any>, any, any> | undefined;
+    /** Runtime lineage and cloning utilities for this slice instance. */
+    readonly prototype: {
+        /** Creates a new detached clone within the same lineage. */
+        readonly clone: () => slice<S, R, M, C>;
+        /** Returns all slice instances in the same lineage, including this one. */
+        readonly getLineage: () => slice<S, R, M, C>[];
+        /** Returns all sibling instances in the same lineage, excluding this one. */
+        readonly getClones: () => slice<S, R, M, C>[];
+        /** Returns true if both slices belong to the same lineage. */
+        readonly isTypeOf: (other: any) => boolean;
+    };
+    /** Collection of derived state functions. */
+    readonly computed: undefined;
+} & OmitNever<{
     /** Exposed mutation functions. */
-    readonly [K in Exclude<keyof R, ReservedSliceKeys>]: (...args: Tail<Parameters<R[K]>>) => ReturnType<R[K]>;
-} & {
+    readonly [K in Exclude<keyof R, ReservedSliceKeys>]: R[K] extends (...args: any[]) => void ? (...args: Tail<Parameters<R[K]>>) => void : never;
+}> & OmitNever<{
     /** Exposed method functions. */
-    readonly [K in Exclude<keyof M, ReservedSliceKeys<R>>]: M[K];
-} & {};
+    readonly [K in Exclude<keyof M, ReservedSliceKeys<R>>]: M[K] extends (...args: any[]) => void ? M[K] : never;
+}> & OmitNever<{
+    /** Exposed children. */
+    readonly [K in Exclude<keyof C, ReservedSliceKeys<R, M>>]: C[K] extends slice<infer S, infer R, infer M, infer C> ? slice<S, R, M, C> : never;
+}>;
 /** Configuration object used to create a slice. */
-type sliceOptions<S, R extends Mutations<S>, M> = {
+type sliceOptions<S extends Obj, R extends Mutations<S, C>, M, C> = {
     /** Unique slice identifier. */
     name: string;
     /** Initial state object or lazy state initializer. */
@@ -40,26 +62,44 @@ type sliceOptions<S, R extends Mutations<S>, M> = {
     /** Collection of synchronous state transition functions. */
     mutations?: R & ThisType<GlobalUtils>;
     /** Collection of slice methods and orchestration logic. */
-    methods?: M & ThisType<slice<S, R, M> & {
+    methods?: M & ThisType<slice<S, R, M, C> & {
         root: RootStore;
     }>;
+    /** Collection of derived state functions. */ /** Collection of nested child slices. */
+    children?: C;
 };
 /** Defines the mutations available on a slice. */
-type Mutations<S> = Dict<(state: SliceState<S, false>, ...args: any[]) => void>;
+type Mutations<S extends Obj, C> = Dict<(state: SliceState.Draft<S, C>, ...args: any[]) => void | SliceState.Draft<S, C>>;
 /** Derived state shape exposed by a slice, excluding internal framework fields. */
-type SliceState<S, isReadOnly> = isReadOnly extends true ? ReadOnly<S extends Dict ? Omit<S, "computed" | "children"> : S> : S extends Dict ? Omit<S, "computed" | "children"> : S;
+declare namespace SliceState {
+    type InferState<C> = C extends Obj ? (C["getState"] extends () => infer S ? S extends Obj ? S : never : never) : never;
+    export type State<S extends Obj, C> = ReadOnly<Omit<S, "computed" | keyof OmitNever<{
+        [K in keyof C]: InferState<C[K]>;
+    }>> & OmitNever<{
+        [K in keyof C]: InferState<C[K]>;
+    }>>;
+    export type Draft<S extends Obj, C> = Omit<S, "computed" | keyof OmitNever<{
+        [K in keyof C]: C[K] extends AnySlice ? true : never;
+    }>> & OmitNever<{
+        [K in keyof C]: C[K] extends slice<infer S, infer _, infer __, infer C> ? Draft<S, C> : never;
+    }>;
+    export {  };
+}
 /** Reserved slice member names that cannot be overridden by user-defined APIs. */
-type ReservedSliceKeys<R = {}, M = {}> = ("name" | "computed" | "root" | "global" | "children" | "getState" | "useSelect" | "getPath") | (keyof R | keyof M);
+type ReservedSliceKeys<R = {}, M = {}> = ("name" | "path" | "computed" | "root" | "parent" | "prototype" | "global" | "getState" | "useSelect") | (keyof R | keyof M);
+type AnySlice = slice<any, Mutations<any, any>, any, any>;
 
 /** Runtime store API exposed by createStore(...). */
 type store<C> = OmitNever<GlobalUtils & {
+    /** Unique store identifier. Currently this is set to "default" and is nt configurable */
+    readonly name: "default";
     /** Returns the latest immutable state snapshot. */
     readonly getState: () => StoreState<C>;
     /** Subscribes to state changes within React components. Runs with a context-bound `this` containing `global` utilities. */
     readonly useSelect: <T>(selector: (this: GlobalUtils, state: StoreState<C>, context: GlobalUtils) => T) => T;
 } & {
     /** Exposed slices. */
-    readonly [K in Exclude<keyof C, ReservedStoreKeys>]: C[K] extends slice<infer S, infer R, infer M> ? slice<S, R, M> : never;
+    readonly [K in Exclude<keyof C, ReservedStoreKeys>]: C[K] extends slice<infer S, infer R, infer M, infer C> ? slice<S, R, M, C> : never;
 }>;
 /** Configuration object used to create a store. */
 type storeOptions<C> = {
@@ -68,7 +108,7 @@ type storeOptions<C> = {
 };
 /** Derived immutable state shape of the store. */
 type StoreState<C> = ReadOnly<OmitNever<{
-    readonly [K in Exclude<keyof C, ReservedStoreKeys>]: C[K] extends slice<infer S, infer _, infer __> ? SliceState<S, true> : never;
+    readonly [K in Exclude<keyof C, ReservedStoreKeys>]: C[K] extends slice<infer S, infer _, infer __, infer C> ? SliceState.State<S, C> : never;
 }>>;
 /** Props accepted by the store provider component. */
 type StoreProviderProps<T = any> = Omit<ProviderProps, "store" | "serverState" | "context"> & {
@@ -105,9 +145,9 @@ declare global {
         /** Configuration object used to create a store. */
         type StoreOptions<C> = storeOptions<C>;
         /** Runtime slice API exposed by createSlice(...). */
-        type Slice<S, R extends Mutations<S>, M> = slice<S, R, M>;
+        type Slice<S extends Obj, R extends Mutations<S, C>, M, C> = slice<S, R, M, C>;
         /** Configuration object used to create a slice. */
-        type SliceOptions<S, R extends Mutations<S>, M> = sliceOptions<S, R, M>;
+        type SliceOptions<S extends Obj, R extends Mutations<S, C>, M, C> = sliceOptions<S, R, M, C>;
     }
 }
 
@@ -120,14 +160,14 @@ declare function provideGlobalUtils(value: Partial<GlobalUtils["global"]>): Glob
 declare function configureDiagnostics(level: "off" | "errors" | "all"): void;
 
 /** Creates and initializes an OrcheStore slice. */
-declare const createSliceWrapper: <S, R extends Mutations<S>, M>(props: sliceOptions<S, R, M>) => slice<S, R, M>;
+declare const createSliceWrapper: <S extends Obj, R extends Mutations<S, C>, M, C>(props: sliceOptions<S, R, M, C>) => slice<S, R, M, C>;
 /** Creates and initializes an OrcheStore instance. */
 declare const createStoreWrapper: <T>(props: storeOptions<T>) => store<T>;
 declare const defaultExport: {
     /** Creates and initializes an OrcheStore instance. */
     createStore: <T>(props: storeOptions<T>) => store<T>;
     /** Creates and initializes an OrcheStore slice. */
-    createSlice: <S, R extends Mutations<S>, M>(props: sliceOptions<S, R, M>) => slice<S, R, M>;
+    createSlice: <S extends Obj, R extends Mutations<S, C>, M, C>(props: sliceOptions<S, R, M, C>) => slice<S, R, M, C>;
     /** Provides an OrcheStore instance to the React component tree. */
     StoreProvider: typeof StoreProvider;
     /** Registers or updates application-wide global utilities. */

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 import React from 'react';
 import { ProviderProps } from 'react-redux';
 
-/** String-keyed object map. */
+/** `Record` with string keys, requiring only the value type. */
 type Dict<Value = any> = Record<string, Value>;
+/** `Record` with default property keys, requiring only the value type. */
+type Obj<Value = any> = Record<PropertyKey, Value>;
 /** Returns all tuple elements except the first. */
 type Tail<T extends any[]> = T extends [any, ...infer R] ? R : T extends (infer U)[] ? U[] : never;
 /** Removes properties whose value type is `never`. */
@@ -15,24 +17,44 @@ type ReadOnly<T> = T extends (...args: any[]) => any ? T : T extends readonly (i
 } : T;
 
 /** Runtime slice API exposed by createSlice(...). */
-type slice<S, R extends Mutations<S>, M> = GlobalUtils & {
+type slice<S extends Obj, R extends Mutations<S, C>, M, C> = GlobalUtils & {
     /** Unique slice identifier. */
     readonly name: string;
+    /** Fully qualified runtime path of the slice. */
+    readonly path: string;
     /** Returns the latest immutable state snapshot. */
-    readonly getState: () => SliceState<S, true>;
+    readonly getState: () => SliceState.State<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: GlobalUtils, state: SliceState<S, true>, context: GlobalUtils) => T) => T;
-    /** Returns fully qualified runtime path of the slice. */
-    readonly getPath: () => string;
-} & {
+    readonly useSelect: <T>(selector: (this: GlobalUtils, state: SliceState.State<S, C>, context: GlobalUtils) => T) => T;
+    /** Root store that owns this slice instance. */
+    root: store<any>;
+    /** Parent slice in the hierarchy, if mounted under another slice. */
+    parent: slice<any, Mutations<any, any>, any, any> | undefined;
+    /** Runtime lineage and cloning utilities for this slice instance. */
+    readonly prototype: {
+        /** Creates a new detached clone within the same lineage. */
+        readonly clone: () => slice<S, R, M, C>;
+        /** Returns all slice instances in the same lineage, including this one. */
+        readonly getLineage: () => slice<S, R, M, C>[];
+        /** Returns all sibling instances in the same lineage, excluding this one. */
+        readonly getClones: () => slice<S, R, M, C>[];
+        /** Returns true if both slices belong to the same lineage. */
+        readonly isTypeOf: (other: any) => boolean;
+    };
+    /** Collection of derived state functions. */
+    readonly computed: undefined;
+} & OmitNever<{
     /** Exposed mutation functions. */
-    readonly [K in Exclude<keyof R, ReservedSliceKeys>]: (...args: Tail<Parameters<R[K]>>) => ReturnType<R[K]>;
-} & {
+    readonly [K in Exclude<keyof R, ReservedSliceKeys>]: R[K] extends (...args: any[]) => void ? (...args: Tail<Parameters<R[K]>>) => void : never;
+}> & OmitNever<{
     /** Exposed method functions. */
-    readonly [K in Exclude<keyof M, ReservedSliceKeys<R>>]: M[K];
-} & {};
+    readonly [K in Exclude<keyof M, ReservedSliceKeys<R>>]: M[K] extends (...args: any[]) => void ? M[K] : never;
+}> & OmitNever<{
+    /** Exposed children. */
+    readonly [K in Exclude<keyof C, ReservedSliceKeys<R, M>>]: C[K] extends slice<infer S, infer R, infer M, infer C> ? slice<S, R, M, C> : never;
+}>;
 /** Configuration object used to create a slice. */
-type sliceOptions<S, R extends Mutations<S>, M> = {
+type sliceOptions<S extends Obj, R extends Mutations<S, C>, M, C> = {
     /** Unique slice identifier. */
     name: string;
     /** Initial state object or lazy state initializer. */
@@ -40,26 +62,44 @@ type sliceOptions<S, R extends Mutations<S>, M> = {
     /** Collection of synchronous state transition functions. */
     mutations?: R & ThisType<GlobalUtils>;
     /** Collection of slice methods and orchestration logic. */
-    methods?: M & ThisType<slice<S, R, M> & {
+    methods?: M & ThisType<slice<S, R, M, C> & {
         root: RootStore;
     }>;
+    /** Collection of derived state functions. */ /** Collection of nested child slices. */
+    children?: C;
 };
 /** Defines the mutations available on a slice. */
-type Mutations<S> = Dict<(state: SliceState<S, false>, ...args: any[]) => void>;
+type Mutations<S extends Obj, C> = Dict<(state: SliceState.Draft<S, C>, ...args: any[]) => void | SliceState.Draft<S, C>>;
 /** Derived state shape exposed by a slice, excluding internal framework fields. */
-type SliceState<S, isReadOnly> = isReadOnly extends true ? ReadOnly<S extends Dict ? Omit<S, "computed" | "children"> : S> : S extends Dict ? Omit<S, "computed" | "children"> : S;
+declare namespace SliceState {
+    type InferState<C> = C extends Obj ? (C["getState"] extends () => infer S ? S extends Obj ? S : never : never) : never;
+    export type State<S extends Obj, C> = ReadOnly<Omit<S, "computed" | keyof OmitNever<{
+        [K in keyof C]: InferState<C[K]>;
+    }>> & OmitNever<{
+        [K in keyof C]: InferState<C[K]>;
+    }>>;
+    export type Draft<S extends Obj, C> = Omit<S, "computed" | keyof OmitNever<{
+        [K in keyof C]: C[K] extends AnySlice ? true : never;
+    }>> & OmitNever<{
+        [K in keyof C]: C[K] extends slice<infer S, infer _, infer __, infer C> ? Draft<S, C> : never;
+    }>;
+    export {  };
+}
 /** Reserved slice member names that cannot be overridden by user-defined APIs. */
-type ReservedSliceKeys<R = {}, M = {}> = ("name" | "computed" | "root" | "global" | "children" | "getState" | "useSelect" | "getPath") | (keyof R | keyof M);
+type ReservedSliceKeys<R = {}, M = {}> = ("name" | "path" | "computed" | "root" | "parent" | "prototype" | "global" | "getState" | "useSelect") | (keyof R | keyof M);
+type AnySlice = slice<any, Mutations<any, any>, any, any>;
 
 /** Runtime store API exposed by createStore(...). */
 type store<C> = OmitNever<GlobalUtils & {
+    /** Unique store identifier. Currently this is set to "default" and is nt configurable */
+    readonly name: "default";
     /** Returns the latest immutable state snapshot. */
     readonly getState: () => StoreState<C>;
     /** Subscribes to state changes within React components. Runs with a context-bound `this` containing `global` utilities. */
     readonly useSelect: <T>(selector: (this: GlobalUtils, state: StoreState<C>, context: GlobalUtils) => T) => T;
 } & {
     /** Exposed slices. */
-    readonly [K in Exclude<keyof C, ReservedStoreKeys>]: C[K] extends slice<infer S, infer R, infer M> ? slice<S, R, M> : never;
+    readonly [K in Exclude<keyof C, ReservedStoreKeys>]: C[K] extends slice<infer S, infer R, infer M, infer C> ? slice<S, R, M, C> : never;
 }>;
 /** Configuration object used to create a store. */
 type storeOptions<C> = {
@@ -68,7 +108,7 @@ type storeOptions<C> = {
 };
 /** Derived immutable state shape of the store. */
 type StoreState<C> = ReadOnly<OmitNever<{
-    readonly [K in Exclude<keyof C, ReservedStoreKeys>]: C[K] extends slice<infer S, infer _, infer __> ? SliceState<S, true> : never;
+    readonly [K in Exclude<keyof C, ReservedStoreKeys>]: C[K] extends slice<infer S, infer _, infer __, infer C> ? SliceState.State<S, C> : never;
 }>>;
 /** Props accepted by the store provider component. */
 type StoreProviderProps<T = any> = Omit<ProviderProps, "store" | "serverState" | "context"> & {
@@ -105,9 +145,9 @@ declare global {
         /** Configuration object used to create a store. */
         type StoreOptions<C> = storeOptions<C>;
         /** Runtime slice API exposed by createSlice(...). */
-        type Slice<S, R extends Mutations<S>, M> = slice<S, R, M>;
+        type Slice<S extends Obj, R extends Mutations<S, C>, M, C> = slice<S, R, M, C>;
         /** Configuration object used to create a slice. */
-        type SliceOptions<S, R extends Mutations<S>, M> = sliceOptions<S, R, M>;
+        type SliceOptions<S extends Obj, R extends Mutations<S, C>, M, C> = sliceOptions<S, R, M, C>;
     }
 }
 
@@ -120,14 +160,14 @@ declare function provideGlobalUtils(value: Partial<GlobalUtils["global"]>): Glob
 declare function configureDiagnostics(level: "off" | "errors" | "all"): void;
 
 /** Creates and initializes an OrcheStore slice. */
-declare const createSliceWrapper: <S, R extends Mutations<S>, M>(props: sliceOptions<S, R, M>) => slice<S, R, M>;
+declare const createSliceWrapper: <S extends Obj, R extends Mutations<S, C>, M, C>(props: sliceOptions<S, R, M, C>) => slice<S, R, M, C>;
 /** Creates and initializes an OrcheStore instance. */
 declare const createStoreWrapper: <T>(props: storeOptions<T>) => store<T>;
 declare const defaultExport: {
     /** Creates and initializes an OrcheStore instance. */
     createStore: <T>(props: storeOptions<T>) => store<T>;
     /** Creates and initializes an OrcheStore slice. */
-    createSlice: <S, R extends Mutations<S>, M>(props: sliceOptions<S, R, M>) => slice<S, R, M>;
+    createSlice: <S extends Obj, R extends Mutations<S, C>, M, C>(props: sliceOptions<S, R, M, C>) => slice<S, R, M, C>;
     /** Provides an OrcheStore instance to the React component tree. */
     StoreProvider: typeof StoreProvider;
     /** Registers or updates application-wide global utilities. */

package/dist/index.js

@@ -1,30 +1,30 @@
-import{configureStore as ie}from"@reduxjs/toolkit";import{useSelector as ae}from"react-redux";var b="all",R={diagnostics:!1,prerelease:!1},U=globalThis.console?.log?.bind?.(globalThis.console)||globalThis.console?.log,J=globalThis.console?.warn?.bind?.(globalThis.console)||globalThis.console?.warn,V=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)=>{R.diagnostics=!1,X?.(...e)});var _=`[OrcheStore] \u{1F6A7} Pre-release Notice
+import{configureStore as ge}from"@reduxjs/toolkit";import{useSelector as Se}from"react-redux";var P="all",G={diagnostics:!1,prerelease:!1},z=globalThis.console?.log?.bind?.(globalThis.console)||globalThis.console?.log,re=globalThis.console?.warn?.bind?.(globalThis.console)||globalThis.console?.warn,oe=globalThis.console?.error?.bind?.(globalThis.console)||globalThis.console?.error,ne=globalThis.console?.clear?.bind?.(globalThis.console)||globalThis.console?.clear;globalThis.console?.clear&&(globalThis.console.clear=(...e)=>{G.diagnostics=!1,ne?.(...e)});var ae=`[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!
-`,B=`[OrcheStore] Diagnostics are enabled.
+`,ie=`[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").
-`,s={inform(e){R[e]||(R[e]=!0,b==="all"&&U?.(e==="prerelease"?_:B))},log(...e){b==="all"&&(s.inform("diagnostics"),U?.(...e))},warn(...e){b==="all"&&(s.inform("diagnostics"),J?.(...e))},error(...e){b!=="off"&&(s.inform("diagnostics"),V?.(...e))}};function N(e){b=e}var G=(...e)=>{let[r,t]=[e[2],e[3]],o=`${e[0]||"Received"}: `,n=e[1]!==!1?"(type: "+typeof r+")":"";if(!t?.(r))return r==null?[`${o}(type: ${r})`]:typeof r=="number"||typeof r=="bigint"||typeof r=="boolean"?[`${o}${n} ${r}`]:typeof r=="object"?[o,r]:r===""?[`${o}Empty String`]:[`${o}${n}`,r]},g=((e,r)=>G("Received",!0,e,r));g.prefixed=(e,r,t,o)=>G(e,r,t,o);var H=Object.assign,$=Object.getOwnPropertyDescriptor(Object,"defineProperty")?.value||Object.defineProperty,Q=(e,r,t)=>{$(e,r,{get:t,enumerable:!0,configurable:!1})},Y=(e,r,t)=>{$(e,r,{value:t,writable:!1,enumerable:!0,configurable:!1})},d={assign:H,defineProp:$,defineReadonly:Q,defineMethod:Y},A={isArray:Array.isArray},x={get:Reflect.get,set:Reflect.set,delete:Reflect.deleteProperty};var K={InvalidStore:e=>({StoreType:[`[OrcheStore::StoreProvider] Expected a store instance created with createStore(...).
-`,...g(e)]})},v={GetMissingProp:e=>["[OrcheStore::global-utils] Attempted to access a global utility before it became available. Missing property",e,`
+`,l={inform(e){G[e]||(G[e]=!0,P==="all"&&z?.(e==="prerelease"?ae:ie))},log(...e){P==="all"&&(l.inform("diagnostics"),z?.(...e))},warn(...e){P==="all"&&(l.inform("diagnostics"),re?.(...e))},error(...e){P!=="off"&&(l.inform("diagnostics"),oe?.(...e))}};function W(e){P=e}var J=(...e)=>{let[t,r]=[e[2],e[3]],o=`${e[0]||"Received"}: `,s=e[1]!==!1?"(type: "+typeof t+")":"";if(!r?.(t))return t==null?[`${o}(type: ${t})`]:typeof t=="number"||typeof t=="bigint"||typeof t=="boolean"?[`${o}${s} ${t}`]:typeof t=="object"?[o,t]:t===""?[`${o}Empty String`]:[`${o}${s}`,t]},M=((e,t)=>J("Received",!0,e,t));M.prefixed=(e,t,r,o)=>J(e,t,r,o);var se=Object.assign,k=Object.getOwnPropertyDescriptor(Object,"defineProperty")?.value||Object.defineProperty,le=(e,t,r)=>{k(e,t,{get:r,enumerable:!0,configurable:!1})},ce=(e,t,r)=>{k(e,t,{value:r,writable:!1,enumerable:!0,configurable:!1})},u={assign:se,defineProp:k,defineReadonly:le,defineMethod:ce},X={isArray:Array.isArray},I={get:Reflect.get,set:Reflect.set,delete:Reflect.deleteProperty};var _={InvalidStore:{InvalidType:e=>[`[OrcheStore::StoreProvider] Expected a store instance created with createStore(...).
+`,...M(e)]}},U={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.
-`},T={InvalidChild:e=>`[OrcheStore::createStore] Child slice '${e}' must be a slice created with createSlice(...).`,singletonLimitation:()=>`[OrcheStore::createStore] createStore(...) was called more than once.
+`},N={InvalidChild:e=>`[OrcheStore::createStore] Child slice '${e}' must be a slice created with createSlice(...).`,singletonLimitation:()=>`[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 execute on every render.`},u={InvalidStore:(e,r,t)=>({StoreType:[`[OrcheStore::${r}] Unable to resolve a valid store instance.
-This operation requires a store created with createStore(...).
-`,...g(e)],NeverExposed:[`[OrcheStore::${r}] Slice {${t}} has not been exposed in any store.
-Ensure the slice is reachable from a store instance.
-This can be done by exposing the slice directly through createStore({ slices: ... }) or indirectly through a parent slice using createSlice({ children: ... }).`],NotInTree:[`[OrcheStore::${r}] Slice {${t}} is not exposed within the target store.
-A slice can only be accessed through stores that expose it.
-`,...g.prefixed("Current store",!1,e)]}),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 state for slice {${e}}.`,InvalidState:(e,r)=>[`[OrcheStore::createSlice]${m.target({slice:e})}Slice state must be a non-null object or a function that returns a non-null object.
-`,...g(r)],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 created with createSlice(...).`,ReduxReducerConflict:()=>"[OrcheStore::createSlice] Redux Toolkit asyncThunk reducers are not supported inside mutations. Use methods instead."},m={target:({slice:e})=>e?` Affected slice '${e}':
-`:" ",RequiredName:(e,r)=>`[OrcheStore::${e.module}]${m.target(e)}${r} keys must be non-empty strings.`,InvalidName:(e,r,t)=>`[OrcheStore::${e.module}]${m.target(e)}${r} names cannot contain '.' or '/'. Received: ${t}.`,ReservedKey:(e,r,t)=>`[OrcheStore::${e.module}]${m.target(e)}'${t}' is a reserved name and cannot be used as a ${r} key.`,DuplicateKey:(e,r,t)=>`[OrcheStore::${e.module}]${m.target(e)}${r} name '${t}' conflicts with another member.`};var P=new Proxy({},{get(e,r,t){return r in e||s.error(...v.GetMissingProp(r)),x.get(e,r,t)},set(e,r,t,o){return x.set(e,r,t,o)},deleteProperty(e,r){return s.warn(...v.DeleteProp(r)),x.delete(e,r)}});function h(){return P}function q(e){let r=g(e,t=>t&&typeof t=="object"&&!A.isArray(t));return r?s.error(v.InvalidArgs(),...r):d.assign(P,e),P}function y(e,r){let t={children:{}};return Object.keys(e).filter(n=>n.startsWith(r)).map(n=>n.split(".")).sort((n,a)=>n.length-a.length).forEach(n=>{let a=t;n.slice(0,n.length-1).forEach(i=>a=a[i]||={}),a.children||={},a.children[n[n.length-1]]={...e[n.join(".")]}}),t.children}var z=(e,r)=>{if(e)if(r==="warn")s.warn(e);else if(r==="error")s.error(e);else throw new Error(e);else return!1},M=(e,r="",t="",o)=>typeof e!="string"||!e?!!z(r,o?.[0]):e.includes(".")||e.includes("/")?!!z(t,o?.[1]):!0,Z=(e,r,t,o)=>{let n=m.RequiredName(e,r),a=m.InvalidName(e,r,t);if(M(t,n,a,["error","error"])){if(o[0].includes(t))return s.error(m.ReservedKey(e,r,t));if(o[1].includes(t))return s.error(m.DuplicateKey(e,r,t))}else return;return!0},E=e=>{let r=[],t=[e.reserved,r];return(o,n,a)=>(Object.entries(n).forEach(([i,c])=>{let l=Z(e,o,i,t)?a(i,c):void 0;if(l===void 0)return delete n[i];n[i]=l,r.push(i)}),n)},O=(e,r)=>{let t={...e||{}};return r.objects?.forEach(o=>{t[o]=typeof t[o]=="object"&&t[o]?{...t[o]}:{}}),r.validate?.(t),r.redux?.forEach(o=>{t[o]!==void 0&&s.warn(`[OrcheStore::${r.method}] '${o}' property is a Redux Toolkit option and is ignored by OrcheStore.`)}),r.unsupported?.forEach(o=>{Object.keys(t[o]).length<1||s.warn(`[OrcheStore::${r.method}] '${o}' property is not yet supported and will be ignored.`)}),t};import{createSlice as re,ReducerType as te}from"@reduxjs/toolkit";import{useSelector as oe}from"react-redux";var L=[],k=e=>{let r={children:{},roots:[]},t=r.slice={},o=O(e,{method:"createSlice",objects:["mutations","computed","methods","children"],unsupported:["computed","children"],redux:["reducers","extraReducers","reducerPath","initialState","selectors"],validate:ne}),n=E({module:"createSlice",slice:o.name,reserved:["name","computed","root","global","getState","useSelect","getPath"]});return n("mutation",o.mutations,(a,i)=>i?._reducerDefinitionType===te.asyncThunk||"reducer"in{...i||{}}?s.error(u.ReduxReducerConflict()):typeof i!="function"?s.error(u.InvalidMutation(a)):((l,I)=>i(l,...I.payload))),r.redux=re({name:o.name,initialState:o.state,reducers:o.mutations}),d.defineReadonly(t,"name",()=>o.name),d.defineReadonly(t,"global",()=>h()),d.defineMethod(t,"getPath",()=>C(t)),d.defineMethod(t,"getState",()=>{let a=u.InvalidStore(void 0,"slice.getState",o.name),i=S(r,void 0,a).redux.getState();return y(i,C(t))}),d.defineMethod(t,"useSelect",a=>{let i=u.InvalidStore(void 0,"slice.useSelect",o.name);return S(r,void 0,i),oe(c=>{let l={global:h()};return a.call(l,y(c,C(t)),l)})}),Object.entries(r.redux.actions).map(([a,i])=>{t[a]=(...c)=>{let l=u.InvalidStore(void 0,"slice mutation",o.name);return S(r,void 0,l).redux.dispatch(i(c))}}),n("method",o.methods,(a,i)=>typeof i!="function"?s.error(u.InvalidMethod(a)):t[a]=(...c)=>i.apply(t,c)),L.push(r),t};function D(e){return L.find(r=>r.slice===e)}var j=(e,r,t,o,n)=>{let{redux:a,children:i}=r;return r.path=e,r.roots.push(o),n[e]=a.reducer,Object.entries(i).forEach(([c,l])=>{j(e+"."+c,D(l),r.slice,o,n)}),t[e]=r.slice},ne=e=>{let r=t=>{if(typeof t!="object"){let o=u.InvalidState(e.name,t);throw o.every(n=>typeof n=="string")?new Error(o.join(" ")):(s.error(...o),new Error)}if(!t)throw new Error(u.RequiredState(e.name));return t};if(M(e.name,u.RequiredName(),u.InvalidName(e.name)),typeof e.state=="function"){let t=e.state;e.state=()=>r(t())}else r(e.state)},C=e=>e.name;var w=[],W=e=>{let r={},t=r.store={},o=O(e,{method:"createStore",objects:["slices"],redux:["reducer","devTools","duplicateMiddlewareCheck","enhancers","middleware","preloadedState"]}),n=E({module:"createStore",reserved:["name","computed","global","getState","useSelect"]});d.defineReadonly(t,"name",()=>"default"),d.defineReadonly(t,"global",()=>h()),d.defineMethod(t,"getState",()=>y(r.redux.getState(),"")),d.defineMethod(t,"useSelect",i=>ae(c=>{let l={global:h()};return i.call(l,y(c,""),l)}));let a={};return n("slice",o.slices,(i,c)=>{let l=D(c);return l?j(i,l,t,t,a):s.error(T.InvalidChild(i))}),r.redux=ie({reducer:a}),w.push(r),t},S=(e,r,t={})=>{if(t===!1)return w[0];let o;if((!e||r!==void 0)&&!w.find(n=>n.store===r)?o=t.StoreType:e&&!e.roots.length?o=t.NeverExposed:e&&r&&!e.roots.includes(r)&&(o=t.NotInTree),r=e&&r===void 0?e.roots[0]:r,o)throw o.every(n=>typeof n=="string")?new Error(o.join(" ")):(s.error(...o),new Error);return w.find(n=>n.store===r)};import se from"react";import{Provider as le}from"react-redux";function F(e){let{store:r,...t}={...e||{}},o=S(void 0,r,K.InvalidStore(r));return se.createElement(le,{...t,store:o.redux})}var ce=e=>(s.inform("prerelease"),k(e)),de=e=>(s.inform("prerelease"),S(void 0,void 0,!1)?(s.warn(T.singletonLimitation()),S(void 0,void 0,!1).store):W(e)),pr={createStore:de,createSlice:ce,StoreProvider:F,provideGlobalUtils:q,getGlobalUtils:h,configureDiagnostics:N};export{F as StoreProvider,N as configureDiagnostics,ce as createSlice,de as createStore,pr as default,h as getGlobalUtils,q as provideGlobalUtils};
+Avoid useState(createStore(...)) because createStore(...) will execute on every render.`},v={InvalidStore:(e,t)=>({NeverExposed:[`[OrcheStore::${e}] Slice {${t}} is not reachable from any store instance.
+A slice must be connected to a store via one of the following:
+\u2022 createStore({ slices: ... }) \u2014 expose it directly in the root store
+\u2022 createSlice({ children: ... }) \u2014 attach it under another slice that is already reachable`],InvalidType:r=>[`[OrcheStore::${e}] Slice {${t}} depends on parent slice {${r.name}}, but that parent is not reachable from any store instance.
+Fix the parent first using one of the following:
+\u2022 createStore({ slices: ... }) \u2014 expose the parent directly in the root store
+\u2022 createSlice({ children: ... }) \u2014 attach the parent under another parent slice that is already reachable`]}),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 state for slice {${e}}.`,InvalidState:(e,t)=>[`[OrcheStore::createSlice]${b.target({slice:e})}Slice state must be a non-null object or a function that returns a non-null object.
+`,...M(t)],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 created with createSlice(...).`,ReduxReducerConflict:()=>"[OrcheStore::createSlice] Redux Toolkit asyncThunk reducers are not supported inside mutations. Use methods instead."},b={target:({slice:e})=>e?` Affected slice '${e}':
+`:" ",RequiredName:(e,t)=>`[OrcheStore::${e.module}]${b.target(e)}${t} keys must be non-empty strings.`,InvalidName:(e,t,r)=>`[OrcheStore::${e.module}]${b.target(e)}${t} names cannot contain '.' or '/'. Received: ${r}.`,ReservedKey:(e,t,r)=>`[OrcheStore::${e.module}]${b.target(e)}'${r}' is a reserved name and cannot be used as a ${t} key.`,DuplicateKey:(e,t,r)=>`[OrcheStore::${e.module}]${b.target(e)}${t} name '${r}' conflicts with another member.`};var K=new Proxy({},{get(e,t,r){return t in e||l.error(...U.GetMissingProp(t)),I.get(e,t,r)},set(e,t,r,o){return I.set(e,t,r,o)},deleteProperty(e,t){return l.warn(...U.DeleteProp(t)),I.delete(e,t)}});function T(){return K}function B(e){let t=M(e,r=>r&&typeof r=="object"&&!X.isArray(r));return t?l.error(U.InvalidArgs(),...t):u.assign(K,e),K}var{createNodeFactory:j}={createNodeFactory({factoryName:e,instantiate:t,options:r={}}){let o=new Map,s=new Map,p=d=>{d=r.adapt?r.adapt(d):d,d=r.register?r.register(d):d;let n={familyId:Symbol("family"),path:"",children:new Map,parents:[]},a={props:d,siblings:new Set};return n.node=t(d,n,a),a.siblings.add(n.node),o.set(n.node,n),s.set(n.familyId,a),n.node},x=(d,n)=>{let a=o.get(d),i=a?s.get(a.familyId):void 0;if(!a||!i){if(n?.UnknownNode)return void n?.UnknownNode?.("",d);throw new Error(`[OrcheStore] ${e} factory: Unknown node`)}return m("",[],a,i,!0,()=>{})},y=(d,n,a,i,c)=>{let f=o.get(n),O=f?s.get(f.familyId):void 0;if(!f||!O){if(c?.UnknownNode)return void c?.UnknownNode?.(d,n);throw new Error(`[OrcheStore] ${e} factory: Unknown node`)}let h=i||o.get(a);if(!h){if(c?.UnknownParent)return void c?.UnknownParent?.(d,n,a);throw new Error(`[OrcheStore] ${e} factory: Unknown parent node`)}for(let R of[a,...h.parents])if(R===n){if(c?.InfiniteOwnership)return void c?.InfiniteOwnership?.(d,n,a);throw new Error(`[OrcheStore] ${e} factory: Infinite ownership recursion`)}let E=(h.path?`${h.path}.`:"")+d,$=[a,...h.parents];return m(E,$,f,O,!1,R=>h.children.set(d,R))};function m(...d){let[n,a,i,c,f,O]=d;if(f=f||i.parents.length>0&&(i.parents[0]!==a[0]||i.path.split(".").at(-1)!==n.split(".").at(-1)),f){let h={familyId:i.familyId,path:n,children:new Map(i.children),parents:a},E=r.clone?r.clone(c.props,i,c):c.props;i=h,i.node=t(E,h,c),o.set(i.node,h),c.siblings.add(i.node)}i.path=n,i.parents=a,O?.(i.node);for(let[h,E]of[...i.children.entries()]){let $=o.get(E),R=$?s.get($.familyId):void 0,te=`${n}${n?".":""}${h}`;m(te,[i.node,...a],$,R,!1,L=>{L!==E&&i.children.set(h,L)})}return i.node}return{families:s,instances:o,create:p,attach:y,clone:x}}};import{ReducerType as ue,createSlice as pe}from"@reduxjs/toolkit";import{useSelector as fe}from"react-redux";var H=(e,t)=>{if(e)if(t==="warn")l.warn(e);else if(t==="error")l.error(e);else throw new Error(e);else return!1},D=(e,t="",r="",o)=>typeof e!="string"||!e?!!H(t,o?.[0]):e.includes(".")||e.includes("/")?!!H(r,o?.[1]):!0,de=(e,t,r,o)=>{let s=b.RequiredName(e,t),p=b.InvalidName(e,t,r);if(D(r,s,p,["error","error"])){if(o[0].includes(r))return l.error(b.ReservedKey(e,t,r));if(o[1].includes(r))return l.error(b.DuplicateKey(e,t,r))}else return;return!0},A=e=>{let t=[],r=[e.reserved,t];return(o,s,p,x)=>{let y=s?[]:{};return Object.entries(p).forEach(([m,d])=>{let n=de(e,o,m,r)?x(m,d):void 0;n!==void 0&&(s?y.push([m,n]):y[m]=n,t.push(m))}),y}},F=(e,t)=>{let r={...e||{}};return t.objects?.forEach(o=>{r[o]=typeof r[o]=="object"&&r[o]?{...r[o]}:{}}),t.validate?.(r),t.redux?.forEach(o=>{r[o]!==void 0&&l.warn(`[OrcheStore::${t.method}] '${o}' property is a Redux Toolkit option and is ignored by OrcheStore.`)}),t.unsupported?.forEach(o=>{Object.keys(r[o]).length<1||l.warn(`[OrcheStore::${t.method}] '${o}' property is not yet supported and will be ignored.`)}),r};var{families:ye,instances:C,create:me,attach:q,clone:he}=j({factoryName:"slice",instantiate(e,t,r){let o={},s=n=>w(void 0,t,n?v.InvalidStore(n,e.name):!1),p=A({module:"createSlice",slice:e.name,reserved:["name","path","computed","root","parent","prototype","global","getState","useSelect"]}),x=p("mutation",!1,e.mutations,(n,a)=>a?._reducerDefinitionType===ue.asyncThunk||"reducer"in{...a||{}}?l.error(v.ReduxReducerConflict()):typeof a!="function"?l.error(v.InvalidMutation(n)):(c,f)=>f?.meta?.path===t.path?a(c,...f.payload):c);t.redux=pe({name:e.name,initialState:e.state,reducers:x}),u.defineReadonly(o,"name",()=>e.name),u.defineReadonly(o,"path",()=>t.path),u.defineReadonly(o,"global",()=>T()),u.defineReadonly(o,"root",()=>s().node),u.defineReadonly(o,"parent",()=>{let n=t.parents[0];return(n?C.get(n):void 0)?.node}),u.defineMethod(o,"getState",()=>{let n=s("slice.getState").redux.getState();return t.path.split(".").forEach(a=>n=(n||{})[a]),n}),u.defineMethod(o,"useSelect",n=>{let a={global:T(),root:s("slice.useSelect").node};return fe(i=>(t.path.split(".").forEach(c=>i=(i||{})[c]),n.apply(a,[i,a])))}),u.defineReadonly(o,"computed",()=>{});let y={},m=()=>[...r.siblings.values()||[]];u.defineReadonly(o,"prototype",()=>y),u.defineMethod(y,"clone",()=>he(o)),u.defineMethod(y,"getLineage",()=>m()),u.defineMethod(y,"getClones",()=>m().filter(n=>n!==o)),u.defineMethod(y,"isTypeOf",n=>r===ye.get(C.get(n)?.familyId)),Object.entries(t.redux.actions).map(([n,a])=>{o[n]=(...i)=>{s("slice mutation").redux.dispatch({...a(i),meta:{path:t.path}})}}),p("method",!1,e.methods,(n,a)=>typeof a!="function"?l.error(v.InvalidMethod(n)):o[n]=(...i)=>a.apply(o,i));let d=p("child",!0,e.children,(n,a)=>{let c=q(n,a,o,t,{UnknownNode:f=>l.error(v.InvalidChild(f))});if(c)return o[n]=c,C.get(c).reducers});return t.reducers=(n,a)=>{let i=a?.meta?.path;if(typeof i=="string"&&!i.startsWith(t.path))return n;let c={...t.redux.reducer(n,a)};for(let[f,O]of d)c[f]=O(c?.[f],a);return c},o},options:{adapt(e){return F(e,{method:"createSlice",objects:["mutations","computed","methods","children"],unsupported:["computed"],redux:["reducers","extraReducers","reducerPath","initialState","selectors"],validate(t){D(t.name,v.RequiredName(),v.InvalidName(t.name));let r=t.state;if(typeof r!="function")return void Q(t.name,r);t.state=()=>Q(t.name,r())}})},clone(e,t){let r=t.redux.getInitialState();return{...e,state:r}}}}),Q=(e,t)=>{if(typeof t!="object"){let r=v.InvalidState(e,t);throw r.every(o=>typeof o=="string")?new Error(r.join(" ")):(l.error(...r),new Error)}if(!t)throw new Error(v.RequiredState(e));return t},V=e=>me(e);var{instances:Y,create:be}=j({factoryName:"slice",instantiate(e,t){let r={},o=A({module:"createStore",reserved:["name","computed","global","getState","useSelect"]});return u.defineReadonly(r,"name",()=>"default"),u.defineReadonly(r,"global",()=>T()),u.defineMethod(r,"getState",()=>t.redux.getState()),u.defineMethod(r,"useSelect",s=>{let p={global:T(),root:r};return Se(x=>s.apply(p,[x,p]))}),t.reducers=o("slice",!1,e.slices,(s,p)=>{let y=q(s,p,r,t,{UnknownNode:m=>l.error(N.InvalidChild(m))});if(y)return r[s]=y,C.get(y).reducers}),t.redux=ge({reducer:t.reducers}),r},options:{adapt(e){return F(e,{method:"createStore",objects:["slices"],redux:["reducer","devTools","duplicateMiddlewareCheck","enhancers","middleware","preloadedState"]})}}}),w=(e,t,r=!1)=>{if(r===!0)return[...Y.values()][0];e||=t?.parents?.at?.(-1);let o=e?Y.get(e):void 0,s=[];if(t&&!e?s=r===!1?[]:r.NeverExposed:o||(s=r===!1?[]:r.InvalidType(e)),s&&s.length)throw s.every(p=>typeof p=="string")?new Error(s.join(" ")):(l.error(...s),new Error);return o},Z=e=>be(e);import ve from"react";import{Provider as xe}from"react-redux";function ee(e){let{store:t,...r}={...e||{}},o=w(t,void 0,_.InvalidStore);return ve.createElement(xe,{...r,store:o.redux})}var Te=e=>(l.inform("prerelease"),V(e)),we=e=>(l.inform("prerelease"),w(void 0,void 0,!0)?(l.warn(N.singletonLimitation()),w(void 0,void 0,!0).node):Z(e)),Et={createStore:we,createSlice:Te,StoreProvider:ee,provideGlobalUtils:B,getGlobalUtils:T,configureDiagnostics:W};export{ee as StoreProvider,W as configureDiagnostics,Te as createSlice,we as createStore,Et as default,T as getGlobalUtils,B as provideGlobalUtils};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orchestore",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "A function-oriented architecture built on top of Redux Toolkit for simplifying and automating application development.",
   "author": "Oussama Saadaoui",
   "license": "MIT",
@@ -12,6 +12,7 @@
     "init": "node scripts/install.mjs",
     "start": "tsup && node scripts/build.mjs",
     "build": "tsup && node scripts/build.mjs",
+    "test": "node scripts/test.mjs",
     "deploy": "tsup && node scripts/publish.mjs",
     "check": "tsc --noEmit",
     "lint": "eslint ."
@@ -69,6 +70,14 @@
     "typescript",
     "orchestration",
     "state-management",
-    "state-orchestration"
+    "state-orchestration",
+    "pinia",
+    "vuex",
+    "react-pinia",
+    "react-vuex",
+    "redux-pinia",
+    "redux-vuex",
+    "store-pinia",
+    "store-vuex"
   ]
 }