@nativelayer.dev/restate 0.2.0 → 0.2.1

package/README.md

@@ -6,7 +6,7 @@
 
 # restate
 
-version `0.2.0`
+version `0.2.1`
 
 A minimal, framework-agnostic reactive state management library built on ES6 proxies. `restate` provides:
 
@@ -25,19 +25,19 @@ Import directly in a browser or module bundler:
 
 ```js
 // ESM (recommended)
-import { restate } from './dist/esm/restate.min.js';
+import { restate } from './dist/restate.esm.min.js';
 
 // CommonJS (Node.js)
-const { restate } = require('./dist/cjs/restate.min.js');
+const { restate } = require('./dist/restate.cjs.min.js');
 ```
 
 ### Which format should I use?
 
 | Your setup | Use this |
 |------------|----------|
-| Vite, esbuild, modern bundler | `dist/esm/` (recommended) |
-| Node.js with `require()` | `dist/cjs/` |
-| Node.js with `"type": "module"` | `dist/esm/` |
+| Vite, esbuild, modern bundler | `dist/restate.esm.min.js` (recommended) |
+| Node.js with `require()` | `dist/restate.cjs.min.js` |
+| Node.js with `"type": "module"` | `dist/restate.esm.min.js` |
 
 ## Basic Usage
 
@@ -202,7 +202,7 @@ state.count = 7; // Throws or no-op
 Define reactive computed properties with automatic dependency tracking:
 
 ```js
-import { restate } from './dist/esm/restate.min.js';
+import { restate } from './dist/restate.esm.min.js';
 
 // Initialize state - $computed is built-in, no plugin needed
 const state = restate({ a: 1, b: 2 });
@@ -232,7 +232,7 @@ console.log(state.double); // logs no 'computing sum' but recomputes double: out
 Chaining computed values:
 
 ```js
-import { restate } from './dist/esm/restate.min.js';
+import { restate } from './dist/restate.esm.min.js';
 
 // No plugin needed - $computed is built-in
 const state = restate({ a: 2, b: 3 });
@@ -376,9 +376,9 @@ Plugins hook into `restate`'s lifecycle events (like `beforeSet`, `afterSet`, `b
 Chain optional plugins for additional features:
 
 ```js
-import { restate }           from './dist/esm/restate.min.js';
-import { PersistencePlugin } from './dist/esm/plugins/persistence.min.js';
-import { ImmutablePlugin }   from './dist/esm/plugins/immutable.min.js';
+import { restate }           from './dist/restate.esm.min.js';
+import { PersistencePlugin } from './dist/plugin/persistence.esm.min.js';
+import { ImmutablePlugin }   from './dist/plugin/immutable.esm.min.js';
 
 // Chainable registration:
 const state = restate({ count: 0, items: [] })
@@ -533,7 +533,7 @@ state.use(ImmutablePlugin, {
 By setting `strict: false`, direct property mutations are allowed without throwing:
 
 ```js
-import { ImmutablePlugin } from './dist/esm/plugins/immutable.min.js';
+import { ImmutablePlugin } from './dist/plugin/immutable.esm.min.js';
 const state = restate({ count: 0, user: { name: 'Alice' } })
   .use(ImmutablePlugin, { strict: false });
 
@@ -561,7 +561,7 @@ state.count = 3;            // works without error
 With `strict: true`, direct property mutations throw errors, but you can still apply updates using `$set`:
 
 ```js
-import { ImmutablePlugin } from './dist/esm/plugins/immutable.min.js';
+import { ImmutablePlugin } from './dist/plugin/immutable.esm.min.js';
 const state = restate({ count: 0 })
   .use(ImmutablePlugin, { strict: true });
 
@@ -578,8 +578,8 @@ console.log(state.count); // 1
 You can register custom mutation methods under strict immutability by using `$set` within your methods:
 
 ```js
-import { restate } from './dist/esm/restate.min.js';
-import { ImmutablePlugin } from './dist/esm/plugins/immutable.min.js';
+import { restate } from './dist/restate.esm.min.js';
+import { ImmutablePlugin } from './dist/plugin/immutable.esm.min.js';
 
 const state = restate({ count: 0 })
   .use(ImmutablePlugin, { strict: true });
@@ -635,8 +635,8 @@ Hooks:
 - `onDestroy` → clear history
 
 ```js
-import { restate } from './dist/esm/restate.min.js';
-import { HistoryPlugin } from './dist/esm/plugins/history.min.js';
+import { restate } from './dist/restate.esm.min.js';
+import { HistoryPlugin } from './dist/plugin/history.esm.min.js';
 
 // Initialize state with history tracking
 const state = restate({ count: 0 })
@@ -812,8 +812,8 @@ Validate types or values on state updates using custom validator functions.
 Usage:
 
 ```js
-import { restate } from './dist/esm/restate.min.js';
-import { ValidatePlugin } from './dist/esm/plugins/validate.min.js';
+import { restate } from './dist/restate.esm.min.js';
+import { ValidatePlugin } from './dist/plugin/validate.esm.min.js';
 
 const state = restate({ age: 0, name: '' })
   .use(ValidatePlugin({
@@ -905,8 +905,8 @@ listState.items = ['a','b','c']; // throws TypeError
 ### Simple Persistence + Methods
 
 ```js
-import { restate } from './dist/esm/restate.min.js';
-import { PersistencePlugin } from './dist/esm/plugins/persistence.min.js';
+import { restate } from './dist/restate.esm.min.js';
+import { PersistencePlugin } from './dist/plugin/persistence.esm.min.js';
 
 // Initialize with persistence ($methods is built-in, no plugin needed)
 const state = restate({ count: 0, items: [] })
@@ -1303,47 +1303,12 @@ All libraries have different trade-offs: `restate` provides fine-grained change
 
 ## License
 
-`restate` is **dual-licensed** to support both open-source and commercial use.
+`restate` is licensed under the **[PolyForm Noncommercial License 1.0.0](./LICENSE)**.
 
-### Open-Source / Non-Commercial Use
+- ✅ Free for personal, educational, research, and non-commercial use
+- ✅ Non-profit organizations and public institutions
+- ❌ Commercial use requires a separate license
 
-`restate` is available under the **MIT License** for:
+See [LICENSE](./LICENSE) for full terms: https://polyformproject.org/licenses/noncommercial/1.0.0
 
-- ✅ Open-source projects (OSI-approved licenses)
-- ✅ Personal projects and non-revenue generating applications
-- ✅ Educational purposes and academic research
-- ✅ Non-profit organizations
-- ✅ Internal company tools (non-revenue generating)
-- ✅ Prototypes and MVPs
-
-See [LICENSE](./LICENSE) and [LICENSE-NONCOMMERCIAL.md](./LICENSE-NONCOMMERCIAL.md) for full details.
-
----
-
-### Commercial Use
-
-A **commercial license** is required for:
-
-- ❌ Proprietary software and closed-source commercial applications
-- ❌ SaaS products and revenue-generating applications
-- ❌ Enterprise deployments and large-scale corporate use
-- ❌ White-label products sold or licensed to third parties
-
-**Commercial licenses include:**
-
-- Legal protection and indemnification
-- Priority support and SLA
-- Updates and bug fixes during license term
-- Custom licensing terms for enterprise needs
-
-See [EULA-COMMERCIAL.md](./EULA-COMMERCIAL.md) for commercial licensing terms.
-
----
-
-### Licensing Inquiries
-
-**For commercial licensing, pricing, or questions:**
-
-> ynck.chrl@protonmail.com
-
-I'll be happy to discuss licensing options that fit your needs.
+**For commercial licensing:** info@nativelayer.dev

package/dist/plugin/async.cjs.min.js

@@ -1,4 +1,4 @@
-/*! plugin/async v0.2.0 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
+/*! plugin/async v0.2.1 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
 "use strict";
 /*!
  * restate AsyncPlugin v1.0.0

package/dist/plugin/async.esm.min.js

@@ -1,4 +1,4 @@
-/*! plugin/async v0.2.0 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
+/*! plugin/async v0.2.1 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
 /*!
  * restate AsyncPlugin v1.0.0
  * restate Async Plugin

package/dist/plugin/history.cjs.min.js

@@ -1,4 +1,4 @@
-/*! plugin/history v0.2.0 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
+/*! plugin/history v0.2.1 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
 "use strict";
 /*!
  * restate HistoryPlugin v1.0.0

package/dist/plugin/history.esm.min.js

@@ -1,4 +1,4 @@
-/*! plugin/history v0.2.0 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
+/*! plugin/history v0.2.1 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
 /*!
  * restate HistoryPlugin v1.0.0
  * History Plugin for restate (closure-based)

package/dist/plugin/immutable.cjs.min.js

@@ -1,4 +1,4 @@
-/*! plugin/immutable v0.2.0 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
+/*! plugin/immutable v0.2.1 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
 "use strict";
 /*!
  * restate ImmutablePlugin v1.0.0

package/dist/plugin/immutable.esm.min.js

@@ -1,4 +1,4 @@
-/*! plugin/immutable v0.2.0 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
+/*! plugin/immutable v0.2.1 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
 /*!
  * restate ImmutablePlugin v1.0.0
  * Immutable Plugin for restate (hook-based, no double proxy)

package/dist/plugin/persistence.cjs.min.js

@@ -1,4 +1,4 @@
-/*! plugin/persistence v0.2.0 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
+/*! plugin/persistence v0.2.1 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
 "use strict";
 /*!
  * restate PersistencePlugin v1.0.0

package/dist/plugin/persistence.esm.min.js

@@ -1,4 +1,4 @@
-/*! plugin/persistence v0.2.0 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
+/*! plugin/persistence v0.2.1 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
 /*!
  * restate PersistencePlugin v1.0.0
  * Persistence Plugin for restate (closure-based)

package/dist/plugin/validate.cjs.min.js

@@ -1,4 +1,4 @@
-/*! plugin/validate v0.2.0 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
+/*! plugin/validate v0.2.1 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
 "use strict";
 /*!
  * restate ValidatePlugin v1.0.0

package/dist/plugin/validate.esm.min.js

@@ -1,4 +1,4 @@
-/*! plugin/validate v0.2.0 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
+/*! plugin/validate v0.2.1 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
 /*!
  * restate ValidatePlugin v1.0.0
  * Plugin to validate types or values on set operations

package/dist/restate.cjs.min.js

@@ -1,2 +1,2 @@
-/*! restate v0.2.0 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
+/*! restate v0.2.1 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
 "use strict";const e=["$onChange","$watch","$unwatch","$set","$computed","$dependencies","$methods","$destroy","$registry","use"],t=["_"];class s{constructor(e={},t={}){this._state=e,this._exactWatchers=new Map,this._shallowWildcards=new Map,this._deepWildcards=new Map,this._proxyCache=new WeakMap,this._computed={},this._computedDependencies=new Map,this._computedCache=new Map,this._tracking=!1,this._currentComputedKey=null,this._accessedPaths=new Set,this._maxDepth=t.maxDepth||100,this._onChange=null,this._isDestroyed=!1,this._bulkMode=!1,this._bulkChanges=new Map,this._plugins=new Map,this._pluginLoadOrder=[],this._pluginHooks={beforeNotify:[],afterNotify:[],beforeSet:[],afterSet:[],beforeBulk:[],afterBulk:[],onDestroy:[]},this._methodRegistry=new Map,this._proxy=this._wrap(e,[],!0),this._setupProxyMethods(),t.plugins&&t.plugins.forEach(e=>this.use(e))}_registerMethod(e,t,s=!1,r=null){this._methodRegistry.set(e,{source:t,configurable:s,originalFn:r})}_isReservedPrefix(e){return t.some(t=>e.startsWith(t))}_checkMethodCollision(t,s,r=!1){if(this._isReservedPrefix(t))return{error:`Plugin '${s}' cannot define method '${t}': names starting with '_' are reserved for internal use`};const i=this._methodRegistry.get(t);if(!i)return null;if(e.includes(t))return{error:`Plugin '${s}' cannot override core method '${t}'`};if(!r){const e=this._pluginLoadOrder,r=i.source.startsWith("plugin:")?e.indexOf(i.source.replace("plugin:",""))+1:0,o=e.indexOf(s)+1;return{error:`Method collision: '${t}'\n  - First defined by: ${i.source}${r?` (loaded #${r})`:""}\n  - Attempted by: plugin '${s}'${o?` (loaded #${o})`:""}\n  Consider renaming the method or using 'overrides: ["${t}"]' in the plugin definition.`}}return i.configurable?null:{error:`Plugin '${s}' cannot override '${t}': method is not configurable (defined by ${i.source})`}}use(e){if("function"==typeof e&&(e=e(this)),!e.name)throw new Error("Plugin must have a name");if(this._plugins.has(e.name))throw new Error(`Plugin '${e.name}' is already registered`);if(this._pluginLoadOrder.push(e.name),this._plugins.set(e.name,e),e.hooks&&Object.keys(e.hooks).forEach(t=>{this._pluginHooks[t]&&this._pluginHooks[t].push(e.hooks[t])}),e.wrap&&Object.keys(e.wrap).forEach(t=>{const s=e.wrap[t],r=this._methodRegistry.get(t);if(!r)throw new Error(`Plugin '${e.name}' attempted to wrap '${t}', but it doesn't exist.\n  Available methods: ${Array.from(this._methodRegistry.keys()).join(", ")}`);if("function"!=typeof s)throw new Error(`Plugin '${e.name}': wrap['${t}'] must be a function`);const i=this._proxy[t];if("function"!=typeof i)throw new Error(`Plugin '${e.name}': cannot wrap '${t}' - it's not a function`);const o=s(i.bind(this._proxy));Object.defineProperty(this._proxy,t,{value:o.bind(this),enumerable:!1,configurable:!0,writable:!0}),this._methodRegistry.set(t,{...r,wrappedBy:e.name,originalFn:i})}),e.methods){const t=e.overrides||[];Object.keys(e.methods).forEach(s=>{const r=t.includes(s),i=this._checkMethodCollision(s,e.name,r);if(i)throw new Error(i.error);if(r&&this._methodRegistry.has(s)){const t=this._methodRegistry.get(s);console.warn(`restate: Plugin '${e.name}' is overriding method '${s}' (previously defined by ${t.source})`)}Object.defineProperty(this._proxy,s,{value:e.methods[s].bind(this),enumerable:!1,configurable:!0,writable:!0}),this._registerMethod(s,`plugin:${e.name}`,!0)})}return e.install&&e.install.call(this),this}_notify(e,t,s){this._isDestroyed||(this._runHooks("beforeNotify",e,t,s),this._bulkMode?this._bulkChanges.set(e,t):this._notifyImmediate(e,t,s))}_notifyImmediate(e,t,s){if(this._isDestroyed)return;if("function"==typeof this._onChange)try{this._onChange(e,t,s)}catch(e){console.error("restate: Error in onChange handler:",e)}const r=this._exactWatchers.get(e);if(r)try{r(e,t,s)}catch(t){console.error(`restate: Error in watcher for '${e}':`,t)}const i=e.split(".");if(i.length>=2){const r=i.slice(0,-1).join("."),o=this._shallowWildcards.get(r);if(o)for(const i of o)try{i(e,t,s)}catch(e){console.error(`restate: Error in watcher for '${r}.*':`,e)}}let o="";for(let r=0;r<i.length-1;r++){o=0===r?i[0]:o+"."+i[r];const n=this._deepWildcards.get(o);if(n)for(const r of n)try{r(e,t,s)}catch(e){console.error(`restate: Error in watcher for '${o}.**':`,e)}}this._runHooks("afterNotify",e,t,s)}_runHooks(e,...t){const s="beforeSet"===e;this._pluginHooks[e].forEach(r=>{if(s)r.call(this,...t);else try{r.call(this,...t)}catch(t){console.error(`restate: Error in ${e} hook:`,t)}})}_bulk(e){if(!this._isDestroyed){if(this._bulkMode)return e(this._proxy);this._runHooks("beforeBulk"),this._bulkMode=!0;try{const t=e(this._proxy);return this._flushBulkChanges(),t}finally{this._bulkMode=!1,this._runHooks("afterBulk")}}}_flushBulkChanges(){if(0!==this._bulkChanges.size){if("function"==typeof this._onChange)try{this._onChange("bulk",Array.from(this._bulkChanges.entries()))}catch(e){console.error("restate: Error in onChange during bulk:",e)}for(const[e,t]of this._bulkChanges){const s=this._exactWatchers.get(e);if(s)try{s(e,t)}catch(t){console.error(`restate: Error in watcher for '${e}':`,t)}const r=e.split(".");if(r.length>=2){const s=r.slice(0,-1).join("."),i=this._shallowWildcards.get(s);if(i)for(const r of i)try{r(e,t)}catch(e){console.error(`restate: Error in watcher for '${s}.*':`,e)}}let i="";for(let s=0;s<r.length-1;s++){i=0===s?r[0]:i+"."+r[s];const o=this._deepWildcards.get(i);if(o)for(const s of o)try{s(e,t)}catch(e){console.error(`restate: Error in watcher for '${i}.**':`,e)}}}this._bulkChanges.clear()}}_getComputedValue(e,t){if(this._computedCache.has(e))return this._computedCache.get(e);if(this._computedCallStack||(this._computedCallStack=new Set),this._computedCallStack.has(e))return void console.error(`restate: Circular dependency detected in computed property '${e}'`);this._computedCallStack.add(e);const s=this._tracking,r=this._currentComputedKey,i=s?[...this._accessedPaths]:null;let o;this._tracking=!0,this._currentComputedKey=e,this._accessedPaths.clear();try{o=t(this._proxy)}catch(t){console.error(`restate: Error computing '${e}':`,t),o=void 0}if(this._computedDependencies.set(e,new Set(this._accessedPaths)),this._computedCache.set(e,o),this._computedCallStack.delete(e),this._tracking=s,this._currentComputedKey=r,i){this._accessedPaths.clear();for(const e of i)this._accessedPaths.add(e)}return o}_invalidateComputed(e){const t=new Set,s=[e];for(;s.length>0;){const e=s.shift(),r=[];for(const[s,i]of this._computedDependencies)i.has(e)&&!t.has(s)&&r.push(s);for(const e of r)this._computedCache.delete(e),this._computedDependencies.delete(e),t.add(e),s.push(e)}}_wrap(e,t=[],s=!1){if(this._isDestroyed)return e;if("object"!=typeof e||null===e)return e;if(t.length>this._maxDepth)return e;if(!s&&this._proxyCache.has(e))return this._proxyCache.get(e);if(Array.isArray(e))return this._wrapArray(e,t);const r=new Proxy(e,{get:(e,r)=>{if(this._isDestroyed)return e[r];const i=String(r);if(s&&i in this._computed)return this._tracking&&this._currentComputedKey&&this._currentComputedKey!==i&&this._accessedPaths.add(i),this._getComputedValue(i,this._computed[i]);if(this._tracking&&this._currentComputedKey){const e=t.length>0?t.concat(r).join("."):i;this._accessedPaths.add(e)}const o=e[r];return"object"==typeof o&&null!==o?this._wrap(o,t.concat(r)):o},set:(e,s,r)=>{if(this._isDestroyed)return!1;this._runHooks("beforeSet",e,s,r,t);const i=e[s];if(i!==r){"object"==typeof i&&null!==i&&this._proxyCache.delete(i),e[s]=r;const o=t.concat(s).join(".");this._invalidateComputed(String(s)),t.length>0&&this._invalidateComputed(o),this._notify(o,r,i)}return this._runHooks("afterSet",e,s,r,t),!0},has:(e,t)=>{const r=String(t);return!(!s||!(r in this._computed))||t in e},ownKeys:e=>{const t=Reflect.ownKeys(e);if(s){const e=Object.keys(this._computed);for(const s of e)t.includes(s)||t.push(s)}return t},getOwnPropertyDescriptor:(e,t)=>{const r=String(t);return s&&r in this._computed?{configurable:!0,enumerable:!0,value:this._getComputedValue(r,this._computed[r])}:Object.getOwnPropertyDescriptor(e,t)}});return s||this._proxyCache.set(e,r),r}_wrapArray(e,t){if(t.length>this._maxDepth)return e;if(this._proxyCache.has(e))return this._proxyCache.get(e);const s=new Proxy(e,{get:(e,s)=>{if(this._isDestroyed)return e[s];if(this._tracking&&this._currentComputedKey){const e=t.concat(s).join(".");this._accessedPaths.add(e)}if("function"==typeof e[s])return this._wrapArrayMethod(e,s,t);const r=e[s];return"object"==typeof r&&null!==r?this._wrap(r,t.concat(s)):r},set:(e,s,r)=>{if(this._isDestroyed)return!1;const i=e[s];if(i!==r&&("object"==typeof i&&null!==i&&this._proxyCache.delete(i),e[s]=r,!isNaN(s))){const i=t.concat(s).join(".");this._invalidateComputed(i),this._notify(i,r),this._notify(t.concat("length").join("."),e.length)}return!0}});return this._proxyCache.set(e,s),s}_wrapArrayMethod(e,t,s){const r=e[t],i=["push","pop","shift","unshift","splice","sort","reverse","fill","copyWithin"];return function(...o){if(this._isDestroyed)return r.apply(e,o);const n=e.length,h=r.apply(e,o);if(i.includes(t)){const t=s.join(".");this._invalidateComputed(t),this._notify(t,e),e.length!==n&&this._notify(s.concat("length").join("."),e.length)}return h}.bind(this)}_addWatcher(e,t){if(e.endsWith(".**")){const s=e.slice(0,-3);this._deepWildcards.has(s)||this._deepWildcards.set(s,new Set),this._deepWildcards.get(s).add(t)}else if(e.endsWith(".*")){const s=e.slice(0,-2);this._shallowWildcards.has(s)||this._shallowWildcards.set(s,new Set),this._shallowWildcards.get(s).add(t)}else this._exactWatchers.set(e,t)}_removeWatcher(e){if(e.endsWith(".**")){const t=e.slice(0,-3);this._deepWildcards.delete(t)}else if(e.endsWith(".*")){const t=e.slice(0,-2);this._shallowWildcards.delete(t)}else this._exactWatchers.delete(e)}_clearAllWatchers(){this._exactWatchers.clear(),this._shallowWildcards.clear(),this._deepWildcards.clear()}_setupProxyMethods(){const t=(e,t)=>{Object.defineProperty(this._proxy,e,{value:t,enumerable:!1,configurable:!1,writable:!1}),this._registerMethod(e,"core",!1)};t("$onChange",e=>(this._onChange=e,this._proxy)),t("$watch",(e,t)=>"function"==typeof t?(this._addWatcher(e,t),()=>this._proxy.$unwatch(e)):this._proxy),t("$unwatch",e=>(this._removeWatcher(e),this._proxy)),t("$set",e=>"function"==typeof e?this._bulk(e):this._bulk(t=>{this._applyUpdates(t,e)})),t("$computed",e=>{const t=["__proto__","constructor","prototype"];for(const[s,r]of Object.entries(e))t.includes(s)?console.warn(`restate: Skipping reserved computed key '${s}'`):"function"==typeof r?this._computed[s]=r:console.warn(`restate: Computed property '${s}' must be a function`);return this._proxy}),t("$dependencies",()=>{const e={};for(const[t,s]of this._computedDependencies)e[t]=Array.from(s);return e}),t("$methods",t=>(Object.entries(t).forEach(([t,s])=>{if("function"!=typeof s)throw new Error(`restate: Method '${t}' must be a function`);if(e.includes(t))throw new Error(`restate: Cannot define method '${t}' - it's a reserved core method`);if(this._isReservedPrefix(t))throw new Error(`restate: Cannot define method '${t}' - names starting with '_' are reserved`);const r=this._methodRegistry.get(t);r&&r.source.startsWith("plugin:")&&console.warn(`restate: $methods() is overriding '${t}' (previously defined by ${r.source})`),Object.defineProperty(this._proxy,t,{value:s.bind(this._proxy),enumerable:!1,writable:!0,configurable:!0}),this._registerMethod(t,"user",!0)}),this._proxy)),t("$registry",()=>{const e={};for(const[t,s]of this._methodRegistry)e[t]={...s},delete e[t].originalFn;return e}),t("$destroy",()=>(this._runHooks("onDestroy"),this._isDestroyed=!0,this._clearAllWatchers(),this._onChange=null,this._plugins.clear(),this._pluginLoadOrder=[],this._methodRegistry.clear(),this._proxyCache=new WeakMap,this._computed={},this._computedDependencies.clear(),this._computedCache.clear(),this._computedCallStack&&this._computedCallStack.clear(),this._proxy))}_applyUpdates(e,t,s=[]){if(this._isDestroyed)return;const r=["__proto__","constructor","prototype"];for(const[i,o]of Object.entries(t))r.includes(i)||("object"!=typeof o||null===o||Array.isArray(o)?e[i]=o:(e[i]&&"object"==typeof e[i]||(e[i]={}),this._applyUpdates(e[i],o,s.concat(i))))}}exports.restate=function(e={}){const t=new s(e,{plugins:[]}),r=t._proxy;return r.use=function(e,s){const r="function"==typeof e?e(t):e;return t.use(r),t._proxy},r};

package/dist/restate.esm.min.js

@@ -1,2 +1,2 @@
-/*! restate v0.2.0 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
+/*! restate v0.2.1 | Copyright (c) 2025 Yannick J.A. Charlery (https://github.com/ynck-chrl/restate) | PolyForm Noncommercial 1.0.0 | https://polyformproject.org/licenses/noncommercial/1.0.0 | Commercial: info@nativelayer.dev */
 const e=["$onChange","$watch","$unwatch","$set","$computed","$dependencies","$methods","$destroy","$registry","use"],t=["_"];class s{constructor(e={},t={}){this._state=e,this._exactWatchers=new Map,this._shallowWildcards=new Map,this._deepWildcards=new Map,this._proxyCache=new WeakMap,this._computed={},this._computedDependencies=new Map,this._computedCache=new Map,this._tracking=!1,this._currentComputedKey=null,this._accessedPaths=new Set,this._maxDepth=t.maxDepth||100,this._onChange=null,this._isDestroyed=!1,this._bulkMode=!1,this._bulkChanges=new Map,this._plugins=new Map,this._pluginLoadOrder=[],this._pluginHooks={beforeNotify:[],afterNotify:[],beforeSet:[],afterSet:[],beforeBulk:[],afterBulk:[],onDestroy:[]},this._methodRegistry=new Map,this._proxy=this._wrap(e,[],!0),this._setupProxyMethods(),t.plugins&&t.plugins.forEach(e=>this.use(e))}_registerMethod(e,t,s=!1,r=null){this._methodRegistry.set(e,{source:t,configurable:s,originalFn:r})}_isReservedPrefix(e){return t.some(t=>e.startsWith(t))}_checkMethodCollision(t,s,r=!1){if(this._isReservedPrefix(t))return{error:`Plugin '${s}' cannot define method '${t}': names starting with '_' are reserved for internal use`};const i=this._methodRegistry.get(t);if(!i)return null;if(e.includes(t))return{error:`Plugin '${s}' cannot override core method '${t}'`};if(!r){const e=this._pluginLoadOrder,r=i.source.startsWith("plugin:")?e.indexOf(i.source.replace("plugin:",""))+1:0,o=e.indexOf(s)+1;return{error:`Method collision: '${t}'\n  - First defined by: ${i.source}${r?` (loaded #${r})`:""}\n  - Attempted by: plugin '${s}'${o?` (loaded #${o})`:""}\n  Consider renaming the method or using 'overrides: ["${t}"]' in the plugin definition.`}}return i.configurable?null:{error:`Plugin '${s}' cannot override '${t}': method is not configurable (defined by ${i.source})`}}use(e){if("function"==typeof e&&(e=e(this)),!e.name)throw new Error("Plugin must have a name");if(this._plugins.has(e.name))throw new Error(`Plugin '${e.name}' is already registered`);if(this._pluginLoadOrder.push(e.name),this._plugins.set(e.name,e),e.hooks&&Object.keys(e.hooks).forEach(t=>{this._pluginHooks[t]&&this._pluginHooks[t].push(e.hooks[t])}),e.wrap&&Object.keys(e.wrap).forEach(t=>{const s=e.wrap[t],r=this._methodRegistry.get(t);if(!r)throw new Error(`Plugin '${e.name}' attempted to wrap '${t}', but it doesn't exist.\n  Available methods: ${Array.from(this._methodRegistry.keys()).join(", ")}`);if("function"!=typeof s)throw new Error(`Plugin '${e.name}': wrap['${t}'] must be a function`);const i=this._proxy[t];if("function"!=typeof i)throw new Error(`Plugin '${e.name}': cannot wrap '${t}' - it's not a function`);const o=s(i.bind(this._proxy));Object.defineProperty(this._proxy,t,{value:o.bind(this),enumerable:!1,configurable:!0,writable:!0}),this._methodRegistry.set(t,{...r,wrappedBy:e.name,originalFn:i})}),e.methods){const t=e.overrides||[];Object.keys(e.methods).forEach(s=>{const r=t.includes(s),i=this._checkMethodCollision(s,e.name,r);if(i)throw new Error(i.error);if(r&&this._methodRegistry.has(s)){const t=this._methodRegistry.get(s);console.warn(`restate: Plugin '${e.name}' is overriding method '${s}' (previously defined by ${t.source})`)}Object.defineProperty(this._proxy,s,{value:e.methods[s].bind(this),enumerable:!1,configurable:!0,writable:!0}),this._registerMethod(s,`plugin:${e.name}`,!0)})}return e.install&&e.install.call(this),this}_notify(e,t,s){this._isDestroyed||(this._runHooks("beforeNotify",e,t,s),this._bulkMode?this._bulkChanges.set(e,t):this._notifyImmediate(e,t,s))}_notifyImmediate(e,t,s){if(this._isDestroyed)return;if("function"==typeof this._onChange)try{this._onChange(e,t,s)}catch(e){console.error("restate: Error in onChange handler:",e)}const r=this._exactWatchers.get(e);if(r)try{r(e,t,s)}catch(t){console.error(`restate: Error in watcher for '${e}':`,t)}const i=e.split(".");if(i.length>=2){const r=i.slice(0,-1).join("."),o=this._shallowWildcards.get(r);if(o)for(const i of o)try{i(e,t,s)}catch(e){console.error(`restate: Error in watcher for '${r}.*':`,e)}}let o="";for(let r=0;r<i.length-1;r++){o=0===r?i[0]:o+"."+i[r];const n=this._deepWildcards.get(o);if(n)for(const r of n)try{r(e,t,s)}catch(e){console.error(`restate: Error in watcher for '${o}.**':`,e)}}this._runHooks("afterNotify",e,t,s)}_runHooks(e,...t){const s="beforeSet"===e;this._pluginHooks[e].forEach(r=>{if(s)r.call(this,...t);else try{r.call(this,...t)}catch(t){console.error(`restate: Error in ${e} hook:`,t)}})}_bulk(e){if(!this._isDestroyed){if(this._bulkMode)return e(this._proxy);this._runHooks("beforeBulk"),this._bulkMode=!0;try{const t=e(this._proxy);return this._flushBulkChanges(),t}finally{this._bulkMode=!1,this._runHooks("afterBulk")}}}_flushBulkChanges(){if(0!==this._bulkChanges.size){if("function"==typeof this._onChange)try{this._onChange("bulk",Array.from(this._bulkChanges.entries()))}catch(e){console.error("restate: Error in onChange during bulk:",e)}for(const[e,t]of this._bulkChanges){const s=this._exactWatchers.get(e);if(s)try{s(e,t)}catch(t){console.error(`restate: Error in watcher for '${e}':`,t)}const r=e.split(".");if(r.length>=2){const s=r.slice(0,-1).join("."),i=this._shallowWildcards.get(s);if(i)for(const r of i)try{r(e,t)}catch(e){console.error(`restate: Error in watcher for '${s}.*':`,e)}}let i="";for(let s=0;s<r.length-1;s++){i=0===s?r[0]:i+"."+r[s];const o=this._deepWildcards.get(i);if(o)for(const s of o)try{s(e,t)}catch(e){console.error(`restate: Error in watcher for '${i}.**':`,e)}}}this._bulkChanges.clear()}}_getComputedValue(e,t){if(this._computedCache.has(e))return this._computedCache.get(e);if(this._computedCallStack||(this._computedCallStack=new Set),this._computedCallStack.has(e))return void console.error(`restate: Circular dependency detected in computed property '${e}'`);this._computedCallStack.add(e);const s=this._tracking,r=this._currentComputedKey,i=s?[...this._accessedPaths]:null;let o;this._tracking=!0,this._currentComputedKey=e,this._accessedPaths.clear();try{o=t(this._proxy)}catch(t){console.error(`restate: Error computing '${e}':`,t),o=void 0}if(this._computedDependencies.set(e,new Set(this._accessedPaths)),this._computedCache.set(e,o),this._computedCallStack.delete(e),this._tracking=s,this._currentComputedKey=r,i){this._accessedPaths.clear();for(const e of i)this._accessedPaths.add(e)}return o}_invalidateComputed(e){const t=new Set,s=[e];for(;s.length>0;){const e=s.shift(),r=[];for(const[s,i]of this._computedDependencies)i.has(e)&&!t.has(s)&&r.push(s);for(const e of r)this._computedCache.delete(e),this._computedDependencies.delete(e),t.add(e),s.push(e)}}_wrap(e,t=[],s=!1){if(this._isDestroyed)return e;if("object"!=typeof e||null===e)return e;if(t.length>this._maxDepth)return e;if(!s&&this._proxyCache.has(e))return this._proxyCache.get(e);if(Array.isArray(e))return this._wrapArray(e,t);const r=new Proxy(e,{get:(e,r)=>{if(this._isDestroyed)return e[r];const i=String(r);if(s&&i in this._computed)return this._tracking&&this._currentComputedKey&&this._currentComputedKey!==i&&this._accessedPaths.add(i),this._getComputedValue(i,this._computed[i]);if(this._tracking&&this._currentComputedKey){const e=t.length>0?t.concat(r).join("."):i;this._accessedPaths.add(e)}const o=e[r];return"object"==typeof o&&null!==o?this._wrap(o,t.concat(r)):o},set:(e,s,r)=>{if(this._isDestroyed)return!1;this._runHooks("beforeSet",e,s,r,t);const i=e[s];if(i!==r){"object"==typeof i&&null!==i&&this._proxyCache.delete(i),e[s]=r;const o=t.concat(s).join(".");this._invalidateComputed(String(s)),t.length>0&&this._invalidateComputed(o),this._notify(o,r,i)}return this._runHooks("afterSet",e,s,r,t),!0},has:(e,t)=>{const r=String(t);return!(!s||!(r in this._computed))||t in e},ownKeys:e=>{const t=Reflect.ownKeys(e);if(s){const e=Object.keys(this._computed);for(const s of e)t.includes(s)||t.push(s)}return t},getOwnPropertyDescriptor:(e,t)=>{const r=String(t);return s&&r in this._computed?{configurable:!0,enumerable:!0,value:this._getComputedValue(r,this._computed[r])}:Object.getOwnPropertyDescriptor(e,t)}});return s||this._proxyCache.set(e,r),r}_wrapArray(e,t){if(t.length>this._maxDepth)return e;if(this._proxyCache.has(e))return this._proxyCache.get(e);const s=new Proxy(e,{get:(e,s)=>{if(this._isDestroyed)return e[s];if(this._tracking&&this._currentComputedKey){const e=t.concat(s).join(".");this._accessedPaths.add(e)}if("function"==typeof e[s])return this._wrapArrayMethod(e,s,t);const r=e[s];return"object"==typeof r&&null!==r?this._wrap(r,t.concat(s)):r},set:(e,s,r)=>{if(this._isDestroyed)return!1;const i=e[s];if(i!==r&&("object"==typeof i&&null!==i&&this._proxyCache.delete(i),e[s]=r,!isNaN(s))){const i=t.concat(s).join(".");this._invalidateComputed(i),this._notify(i,r),this._notify(t.concat("length").join("."),e.length)}return!0}});return this._proxyCache.set(e,s),s}_wrapArrayMethod(e,t,s){const r=e[t],i=["push","pop","shift","unshift","splice","sort","reverse","fill","copyWithin"];return function(...o){if(this._isDestroyed)return r.apply(e,o);const n=e.length,h=r.apply(e,o);if(i.includes(t)){const t=s.join(".");this._invalidateComputed(t),this._notify(t,e),e.length!==n&&this._notify(s.concat("length").join("."),e.length)}return h}.bind(this)}_addWatcher(e,t){if(e.endsWith(".**")){const s=e.slice(0,-3);this._deepWildcards.has(s)||this._deepWildcards.set(s,new Set),this._deepWildcards.get(s).add(t)}else if(e.endsWith(".*")){const s=e.slice(0,-2);this._shallowWildcards.has(s)||this._shallowWildcards.set(s,new Set),this._shallowWildcards.get(s).add(t)}else this._exactWatchers.set(e,t)}_removeWatcher(e){if(e.endsWith(".**")){const t=e.slice(0,-3);this._deepWildcards.delete(t)}else if(e.endsWith(".*")){const t=e.slice(0,-2);this._shallowWildcards.delete(t)}else this._exactWatchers.delete(e)}_clearAllWatchers(){this._exactWatchers.clear(),this._shallowWildcards.clear(),this._deepWildcards.clear()}_setupProxyMethods(){const t=(e,t)=>{Object.defineProperty(this._proxy,e,{value:t,enumerable:!1,configurable:!1,writable:!1}),this._registerMethod(e,"core",!1)};t("$onChange",e=>(this._onChange=e,this._proxy)),t("$watch",(e,t)=>"function"==typeof t?(this._addWatcher(e,t),()=>this._proxy.$unwatch(e)):this._proxy),t("$unwatch",e=>(this._removeWatcher(e),this._proxy)),t("$set",e=>"function"==typeof e?this._bulk(e):this._bulk(t=>{this._applyUpdates(t,e)})),t("$computed",e=>{const t=["__proto__","constructor","prototype"];for(const[s,r]of Object.entries(e))t.includes(s)?console.warn(`restate: Skipping reserved computed key '${s}'`):"function"==typeof r?this._computed[s]=r:console.warn(`restate: Computed property '${s}' must be a function`);return this._proxy}),t("$dependencies",()=>{const e={};for(const[t,s]of this._computedDependencies)e[t]=Array.from(s);return e}),t("$methods",t=>(Object.entries(t).forEach(([t,s])=>{if("function"!=typeof s)throw new Error(`restate: Method '${t}' must be a function`);if(e.includes(t))throw new Error(`restate: Cannot define method '${t}' - it's a reserved core method`);if(this._isReservedPrefix(t))throw new Error(`restate: Cannot define method '${t}' - names starting with '_' are reserved`);const r=this._methodRegistry.get(t);r&&r.source.startsWith("plugin:")&&console.warn(`restate: $methods() is overriding '${t}' (previously defined by ${r.source})`),Object.defineProperty(this._proxy,t,{value:s.bind(this._proxy),enumerable:!1,writable:!0,configurable:!0}),this._registerMethod(t,"user",!0)}),this._proxy)),t("$registry",()=>{const e={};for(const[t,s]of this._methodRegistry)e[t]={...s},delete e[t].originalFn;return e}),t("$destroy",()=>(this._runHooks("onDestroy"),this._isDestroyed=!0,this._clearAllWatchers(),this._onChange=null,this._plugins.clear(),this._pluginLoadOrder=[],this._methodRegistry.clear(),this._proxyCache=new WeakMap,this._computed={},this._computedDependencies.clear(),this._computedCache.clear(),this._computedCallStack&&this._computedCallStack.clear(),this._proxy))}_applyUpdates(e,t,s=[]){if(this._isDestroyed)return;const r=["__proto__","constructor","prototype"];for(const[i,o]of Object.entries(t))r.includes(i)||("object"!=typeof o||null===o||Array.isArray(o)?e[i]=o:(e[i]&&"object"==typeof e[i]||(e[i]={}),this._applyUpdates(e[i],o,s.concat(i))))}}function restate(e={}){const t=new s(e,{plugins:[]}),r=t._proxy;return r.use=function(e,s){const r="function"==typeof e?e(t):e;return t.use(r),t._proxy},r}export{restate};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nativelayer.dev/restate",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "description": "A minimal, framework-agnostic reactive state management library built on ES6 proxies.",
   "main": "./dist/restate.cjs.min.js",