immu-js 0.1.0

package/README.md

@@ -0,0 +1,90 @@
+# immu-js
+
+A tiny, framework-independent immutable state library for JavaScript/TypeScript.
+
+## Install
+
+```bash
+npm install immu-js
+```
+
+## API
+
+### `create(Class)`
+
+Creates a reactive store from a class definition. Properties become reactive (tracked via getters/setters). Methods are bound to the store.
+
+```typescript
+import { create } from "immu-js";
+
+class Counter {
+  count = 0;
+  incr() { this.count++; }
+}
+
+const store = create(Counter);
+store.count;  // 0
+store.incr(); // count = 1
+```
+
+**Store extras:**
+
+- `store._version` — increments on every state change
+- `store._subscribe(cb, prop?)` — subscribe to changes. Pass a prop name to only listen to that prop. Returns an unsubscribe function.
+- `store._reset()` — resets the store to initial class values
+- `store._saveVersion(label?)` — snapshots current state (default label: `"default"`)
+- `store._loadVersion(label?)` — restores a saved snapshot
+
+### `memo(fn)`
+
+Creates a memoized computed function. Tracks which stores are accessed and caches the result. Recomputes only when store state or arguments change.
+
+```typescript
+import { memo } from "immu-js";
+
+const doubled = memo((multiplier: number) => store.count * multiplier);
+doubled(2); // computes
+doubled(2); // cached
+store.incr();
+doubled(2); // recomputes
+```
+
+### `run(cb, deps?)`
+
+Runs a callback reactively whenever tracked stores change. Returns a dispose function.
+
+```typescript
+import { run } from "immu-js";
+
+const dispose = run(() => {
+  console.log("count is", store.count);
+});
+
+store.incr(); // logs "count is 1"
+dispose();    // stops reacting
+```
+
+With optional deps for fine-grained control:
+
+```typescript
+run(
+  () => console.log(store.count),
+  () => [store.count] // only re-run when these deps change
+);
+```
+
+## Build
+
+```bash
+npm run build
+```
+
+## Test
+
+```bash
+npm test
+```
+
+## License
+
+MIT

package/dist/__tests__/fixtures.d.ts

@@ -0,0 +1,40 @@
+export declare class Counter {
+    count: number;
+    incr(): void;
+    decr(): void;
+}
+export declare class UserStore {
+    users: string[];
+    addUser(user: string): void;
+}
+export declare class AddressStore {
+    address: {
+        city: string;
+        zip: string;
+    };
+    changeCity(city: string): void;
+}
+export declare class ArrowStore {
+    count: number;
+    incr: () => void;
+    getCount: () => number;
+}
+export declare class Multi {
+    a: number;
+    b: number;
+}
+export declare class Empty {
+}
+export declare class Base {
+    baseCount: number;
+    baseName: string;
+    incrBase(): void;
+}
+export declare class Child extends Base {
+    childCount: number;
+    incrChild(): void;
+}
+export declare class GrandChild extends Child {
+    grandValue: string;
+    setGrand(val: string): void;
+}

package/dist/computed.d.ts

@@ -0,0 +1,4 @@
+export interface Computed<T> {
+    readonly value: T;
+}
+export declare function computed<T>(fn: () => T): Computed<T>;

package/dist/create.d.ts

@@ -0,0 +1,2 @@
+import type { Constructor, Store } from "./types";
+export declare function create<T extends object>(Cls: Constructor<T>): Store<T>;

package/dist/immu-js.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=new WeakMap;function h(n){let r=m.get(n);return r||(r={subscribers:[],version:0,dirtyProps:new Set},m.set(n,r)),r}let d=new Set,g=!1;function M(n,r){const t=h(n);t.version++,t.dirtyProps.add(r),d.add(n),g||(g=!0,queueMicrotask(k))}function k(){const n=d;d=new Set,g=!1;for(const r of n){const t=h(r),s=t.dirtyProps;t.dirtyProps=new Set;const f=s.has("*"),l=t.subscribers.filter(c=>f||c.prop===void 0||s.has(c.prop));for(const c of l)c.callback()}}const p=[];function b(){p.push(new Set)}function y(){return p.pop()??new Set}function v(n){p.length>0&&p[p.length-1].add(n)}function S(n){const r=new Set,t=[Object.prototype,Array.prototype,Function.prototype,String.prototype,Number.prototype,Boolean.prototype,Symbol.prototype,Date.prototype,RegExp.prototype,Map.prototype,Set.prototype,WeakMap.prototype,WeakSet.prototype,Promise.prototype,Error.prototype];let s=n;for(;s&&!t.includes(s);){for(const f of Reflect.ownKeys(s))f!=="constructor"&&r.add(f);s=Object.getPrototypeOf(s)}return Array.from(r)}function P(n){const r=new n,t=r,s=new Map,f=[],l=new Map,c=h(t),u=S(r);for(const e of u){if(typeof e=="symbol")continue;const o=e,i=r[o];typeof i!="function"&&(s.set(o,i),f.push(o))}for(const e of f)delete r[e],Object.defineProperty(t,e,{get(){return v(t),s.get(e)},set(o){s.set(e,o),M(t,e)},enumerable:!0,configurable:!0});return Object.defineProperty(t,"_version",{get(){return c.version},enumerable:!1,configurable:!1}),Object.defineProperty(t,"_subscribe",{value:(e,o)=>{const i={callback:e,prop:o};return c.subscribers.push(i),()=>{c.subscribers=c.subscribers.filter(a=>a!==i)}},enumerable:!1,configurable:!1,writable:!1}),Object.defineProperty(t,"_reset",{value:()=>{const e=new n,o=S(e);for(const i of o){if(typeof i=="symbol")continue;const a=i,w=e[a];typeof w!="function"&&(t[a]=w)}},enumerable:!1,configurable:!1,writable:!1}),Object.defineProperty(t,"_saveVersion",{value:(e="default")=>{const o=[];for(const[i,a]of s)o.push([i,structuredClone(a)]);l.set(e,o)},enumerable:!1,configurable:!1,writable:!1}),Object.defineProperty(t,"_loadVersion",{value:(e="default")=>{const o=l.get(e);if(!o)throw new Error(`No saved version found for label "${e}"`);for(const[i,a]of o)t[i]=structuredClone(a)},enumerable:!1,configurable:!1,writable:!1}),t}function _(n){let r,t=new Map,s,f=!1;function l(u){for(const[e,o]of u)if(e._version!==o)return!1;return!0}function c(u){for(const[e]of u)v(e)}return(...u)=>{const e=JSON.stringify(u);if(f&&e===r&&l(t))return c(t),s;b();const o=n(...u),i=y();t=new Map;for(const a of i)t.set(a,a._version);return r=e,s=o,f=!0,c(t),o}}function O(n){let r=new Map,t,s=!1;function f(c){for(const[u,e]of c)if(u._version!==e)return!1;return!0}function l(c){for(const[u]of c)v(u)}return{get value(){if(s&&f(r))return l(r),t;b();const c=n(),u=y();r=new Map;for(const e of u)r.set(e,e._version);return t=c,s=!0,l(r),c}}}function j(n,r){let t=!0,s=[],f=[],l;function c(){if(!t)return;if(r){const e=r();if(l&&A(l,e))return;l=e}for(const e of f)e();f=[],b(),n();const u=y();s=Array.from(u);for(const e of s){const o=e._subscribe(()=>{c()});f.push(o)}if(r){b(),r();const e=y();for(const o of Array.from(e))if(!s.includes(o)){const i=o._subscribe(()=>{c()});f.push(i)}}}return c(),()=>{t=!1;for(const u of f)u();f=[]}}function A(n,r){if(n.length!==r.length)return!1;for(let t=0;t<n.length;t++)if(n[t]!==r[t])return!1;return!0}exports._flush=k;exports.computed=O;exports.create=P;exports.memo=_;exports.run=j;

package/dist/immu-js.js

@@ -0,0 +1,228 @@
+const k = /* @__PURE__ */ new WeakMap();
+function g(n) {
+  let r = k.get(n);
+  return r || (r = { subscribers: [], version: 0, dirtyProps: /* @__PURE__ */ new Set() }, k.set(n, r)), r;
+}
+let d = /* @__PURE__ */ new Set(), h = !1;
+function m(n, r) {
+  const t = g(n);
+  t.version++, t.dirtyProps.add(r), d.add(n), h || (h = !0, queueMicrotask(M));
+}
+function M() {
+  const n = d;
+  d = /* @__PURE__ */ new Set(), h = !1;
+  for (const r of n) {
+    const t = g(r), s = t.dirtyProps;
+    t.dirtyProps = /* @__PURE__ */ new Set();
+    const f = s.has("*"), l = t.subscribers.filter(
+      (c) => f || c.prop === void 0 || s.has(c.prop)
+    );
+    for (const c of l)
+      c.callback();
+  }
+}
+const p = [];
+function b() {
+  p.push(/* @__PURE__ */ new Set());
+}
+function y() {
+  return p.pop() ?? /* @__PURE__ */ new Set();
+}
+function v(n) {
+  p.length > 0 && p[p.length - 1].add(n);
+}
+function S(n) {
+  const r = /* @__PURE__ */ new Set(), t = [
+    Object.prototype,
+    Array.prototype,
+    Function.prototype,
+    String.prototype,
+    Number.prototype,
+    Boolean.prototype,
+    Symbol.prototype,
+    Date.prototype,
+    RegExp.prototype,
+    Map.prototype,
+    Set.prototype,
+    WeakMap.prototype,
+    WeakSet.prototype,
+    Promise.prototype,
+    Error.prototype
+  ];
+  let s = n;
+  for (; s && !t.includes(s); ) {
+    for (const f of Reflect.ownKeys(s))
+      f !== "constructor" && r.add(f);
+    s = Object.getPrototypeOf(s);
+  }
+  return Array.from(r);
+}
+function _(n) {
+  const r = new n(), t = r, s = /* @__PURE__ */ new Map(), f = [], l = /* @__PURE__ */ new Map(), c = g(t), u = S(r);
+  for (const e of u) {
+    if (typeof e == "symbol") continue;
+    const o = e, i = r[o];
+    typeof i != "function" && (s.set(o, i), f.push(o));
+  }
+  for (const e of f)
+    delete r[e], Object.defineProperty(t, e, {
+      get() {
+        return v(t), s.get(e);
+      },
+      set(o) {
+        s.set(e, o), m(t, e);
+      },
+      enumerable: !0,
+      configurable: !0
+    });
+  return Object.defineProperty(t, "_version", {
+    get() {
+      return c.version;
+    },
+    enumerable: !1,
+    configurable: !1
+  }), Object.defineProperty(t, "_subscribe", {
+    value: (e, o) => {
+      const i = { callback: e, prop: o };
+      return c.subscribers.push(i), () => {
+        c.subscribers = c.subscribers.filter((a) => a !== i);
+      };
+    },
+    enumerable: !1,
+    configurable: !1,
+    writable: !1
+  }), Object.defineProperty(t, "_reset", {
+    value: () => {
+      const e = new n(), o = S(e);
+      for (const i of o) {
+        if (typeof i == "symbol") continue;
+        const a = i, w = e[a];
+        typeof w != "function" && (t[a] = w);
+      }
+    },
+    enumerable: !1,
+    configurable: !1,
+    writable: !1
+  }), Object.defineProperty(t, "_saveVersion", {
+    value: (e = "default") => {
+      const o = [];
+      for (const [i, a] of s)
+        o.push([i, structuredClone(a)]);
+      l.set(e, o);
+    },
+    enumerable: !1,
+    configurable: !1,
+    writable: !1
+  }), Object.defineProperty(t, "_loadVersion", {
+    value: (e = "default") => {
+      const o = l.get(e);
+      if (!o)
+        throw new Error(`No saved version found for label "${e}"`);
+      for (const [i, a] of o)
+        t[i] = structuredClone(a);
+    },
+    enumerable: !1,
+    configurable: !1,
+    writable: !1
+  }), t;
+}
+function O(n) {
+  let r, t = /* @__PURE__ */ new Map(), s, f = !1;
+  function l(u) {
+    for (const [e, o] of u)
+      if (e._version !== o) return !1;
+    return !0;
+  }
+  function c(u) {
+    for (const [e] of u)
+      v(e);
+  }
+  return (...u) => {
+    const e = JSON.stringify(u);
+    if (f && e === r && l(t))
+      return c(t), s;
+    b();
+    const o = n(...u), i = y();
+    t = /* @__PURE__ */ new Map();
+    for (const a of i)
+      t.set(a, a._version);
+    return r = e, s = o, f = !0, c(t), o;
+  };
+}
+function j(n) {
+  let r = /* @__PURE__ */ new Map(), t, s = !1;
+  function f(c) {
+    for (const [u, e] of c)
+      if (u._version !== e) return !1;
+    return !0;
+  }
+  function l(c) {
+    for (const [u] of c)
+      v(u);
+  }
+  return {
+    get value() {
+      if (s && f(r))
+        return l(r), t;
+      b();
+      const c = n(), u = y();
+      r = /* @__PURE__ */ new Map();
+      for (const e of u)
+        r.set(e, e._version);
+      return t = c, s = !0, l(r), c;
+    }
+  };
+}
+function A(n, r) {
+  let t = !0, s = [], f = [], l;
+  function c() {
+    if (!t) return;
+    if (r) {
+      const e = r();
+      if (l && P(l, e))
+        return;
+      l = e;
+    }
+    for (const e of f)
+      e();
+    f = [], b(), n();
+    const u = y();
+    s = Array.from(u);
+    for (const e of s) {
+      const o = e._subscribe(() => {
+        c();
+      });
+      f.push(o);
+    }
+    if (r) {
+      b(), r();
+      const e = y();
+      for (const o of Array.from(e))
+        if (!s.includes(o)) {
+          const i = o._subscribe(() => {
+            c();
+          });
+          f.push(i);
+        }
+    }
+  }
+  return c(), () => {
+    t = !1;
+    for (const u of f)
+      u();
+    f = [];
+  };
+}
+function P(n, r) {
+  if (n.length !== r.length) return !1;
+  for (let t = 0; t < n.length; t++)
+    if (n[t] !== r[t]) return !1;
+  return !0;
+}
+export {
+  M as _flush,
+  j as computed,
+  _ as create,
+  O as memo,
+  A as run
+};

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { Store } from "./types";
+export type { Computed } from "./computed";
+export { create } from "./create";
+export { memo } from "./memo";
+export { computed } from "./computed";
+export { run } from "./run";
+export { flush as _flush } from "./scheduler";

package/dist/memo.d.ts

@@ -0,0 +1 @@
+export declare function memo<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;

package/dist/registry.d.ts

@@ -0,0 +1,2 @@
+import type { StoreInternal } from "./types";
+export declare function getInternal(store: object): StoreInternal;

package/dist/run.d.ts

@@ -0,0 +1 @@
+export declare function run(cb: () => void, deps?: () => unknown[]): () => void;

package/dist/scheduler.d.ts

@@ -0,0 +1,3 @@
+export declare function scheduleNotify(store: object, prop: string): void;
+export declare function scheduleNotifyAll(store: object): void;
+export declare function flush(): void;

package/dist/tracking.d.ts

@@ -0,0 +1,4 @@
+import type { Store } from "./types";
+export declare function startTracking(): void;
+export declare function stopTracking(): Set<Store<unknown>>;
+export declare function trackStore(store: Store<unknown>): void;

package/dist/types.d.ts

@@ -0,0 +1,18 @@
+export type Constructor<T> = new () => T;
+export type Subscriber = {
+    callback: () => void;
+    prop?: string;
+};
+export type VersionEntry = [string, unknown][];
+export type StoreInternal = {
+    subscribers: Subscriber[];
+    version: number;
+    dirtyProps: Set<string>;
+};
+export type Store<T> = T & {
+    readonly _version: number;
+    _subscribe: (callback: () => void, prop?: string) => () => void;
+    _reset: () => void;
+    _saveVersion: (label?: string) => void;
+    _loadVersion: (label?: string) => void;
+};

package/dist/utils.d.ts

@@ -0,0 +1 @@
+export declare function getAllProps(obj: object): PropertyKey[];

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "immu-js",
+  "version": "0.1.0",
+  "description": "Independent immutable state library for JavaScript/TypeScript",
+  "type": "module",
+  "main": "./dist/immu-js.cjs",
+  "module": "./dist/immu-js.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/immu-js.js",
+      "require": "./dist/immu-js.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build && tsc --emitDeclarationOnly",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "state",
+    "immutable",
+    "store",
+    "reactive",
+    "memo",
+    "typescript"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@vitest/coverage-v8": "^1.6.1",
+    "typescript": "^5.3.3",
+    "vite": "^5.0.12",
+    "vitest": "^1.2.2"
+  }
+}