@derivesome/core 1.0.0

package/README.md~

@@ -0,0 +1,355 @@
+# @derivesome/core
+
+A lightweight reactive state management library with automatic dependency tracking.
+
+## Table of Contents
+
+- [Core Concepts](#core-concepts)
+- [ref](#ref)
+- [derived](#derived)
+- [effect](#effect)
+- [Observable / observe](#observable--observe)
+- [PubSub](#pubsub)
+- [ArrayProxy](#arrayproxy)
+- [Utilities](#utilities)
+  - [findRefs](#findrefs)
+  - [match](#match)
+  - [diff / patch](#diff--patch)
+  - [Stack](#stack)
+
+---
+
+## Core Concepts
+
+Reactivity is built on **automatic dependency tracking**. When a `ref.get()` is called inside an `effect` or `derived`, that ref registers the running effect as a subscriber. When the ref's value changes, all subscribed effects re-run automatically. This means you never manually declare dependencies — the system infers them at runtime.
+
+---
+
+## ref
+
+`ref(value)` creates a reactive reference holding a single value.
+
+```ts
+import { ref } from '@derivesome/core';
+
+const count = ref(0);
+
+count.get();     // read and subscribe (inside an effect/derived)
+count.peek();    // read without subscribing
+count.set(1);    // update value — notifies subscribers only if value changed
+count.set(n => n + 1); // functional update
+```
+
+Values are compared with strict equality (`===`). If the new value is the same as the previous one, no notification is sent.
+
+`ref` also supports `dispose()` to remove all subscribers and effects:
+
+```ts
+count.dispose(); // tears down all subscriptions
+```
+
+### isReference
+
+```ts
+import { isReference } from '@derivesome/core';
+
+isReference(count); // true
+isReference(42);    // false
+```
+
+---
+
+## derived
+
+`derived(fn)` creates a computed value that re-evaluates automatically when its reactive dependencies change. It is itself a `Reference`, so it can be used anywhere a ref can.
+
+```ts
+import { ref, derived } from '@derivesome/core';
+
+const count = ref(0);
+const doubled = derived(() => count.get() * 2);
+const label = derived(() => `Count is: ${doubled.get()}`);
+
+doubled.peek(); // 0
+count.set(5);
+doubled.peek(); // 10
+label.peek();   // "Count is: 10"
+```
+
+Dependencies are tracked dynamically per evaluation. If a branch is not taken, its refs are not subscribed:
+
+```ts
+const enabled = ref(false);
+const value = ref(42);
+
+const result = derived(() => {
+  if (!enabled.get()) return -1;
+  return value.get() * 2; // only subscribed when enabled is true
+});
+```
+
+### isDerived
+
+```ts
+import { isDerived } from '@derivesome/core';
+
+isDerived(doubled); // true
+isDerived(count);   // false
+```
+
+---
+
+## effect
+
+`effect(fn)` runs a function immediately and re-runs it whenever any `ref.get()` called inside it changes.
+
+```ts
+import { ref, effect } from '@derivesome/core';
+
+const name = ref('Alice');
+
+effect(() => {
+  console.log('Hello,', name.get());
+});
+// logs: "Hello, Alice"
+
+name.set('Bob');
+// logs: "Hello, Bob"
+```
+
+Effects are the primary way to cause side effects in response to reactive state changes. Unlike `derived`, they don't return a value.
+
+---
+
+## Observable / observe
+
+Every `ref` implements the `Observable` interface, which provides `observe` — a way to subscribe to value changes outside of the effect/derived system.
+
+```ts
+import { ref } from '@derivesome/core';
+
+const count = ref(0);
+
+const unsubscribe = count.observe((value) => {
+  console.log('count changed to', value);
+});
+
+count.set(1); // logs: "count changed to 1"
+
+unsubscribe(); // stop listening
+
+count.set(2); // nothing logged
+```
+
+`observe` accepts an optional options object:
+
+```ts
+count.observe(
+  (value) => console.log(value),
+  {
+    immediate: true,  // call the callback immediately with the current value
+    cleanup: () => {  // called when the subscription is removed
+      console.log('cleaned up');
+    },
+  }
+);
+```
+
+### isObservable
+
+```ts
+import { isObservable } from '@derivesome/core';
+
+isObservable(count); // true
+```
+
+---
+
+## PubSub
+
+`pubsub()` is the low-level primitive underlying `ref`. It provides a typed publish/subscribe channel with no built-in value storage.
+
+```ts
+import { pubsub } from '@derivesome/core';
+
+const ps = pubsub<number>();
+
+const unsub = ps.subscribe((value) => {
+  console.log('received', value);
+});
+
+ps.publish(42); // logs: "received 42"
+
+unsub(); // unsubscribe
+
+ps.publish(99); // nothing logged
+
+ps.dispose(); // remove all subscribers and effects
+```
+
+`addEffect` registers a function that participates in the reactive context system (re-runs through `Context.runEffect`):
+
+```ts
+ps.addEffect(() => {
+  // re-run as a tracked effect when published
+});
+```
+
+---
+
+## ArrayProxy
+
+`ArrayProxy<T>` extends the native `Array` and emits a typed mutation event whenever the array is modified. Useful for building reactive list state.
+
+```ts
+import { ArrayProxy } from '@derivesome/core';
+
+const items = new ArrayProxy('a', 'b', 'c');
+
+const unsub = items.subscribe((mutation) => {
+  console.log(mutation);
+});
+
+items.push('d');
+// { type: 'push', items: ['d'] }
+
+items.pop();
+// { type: 'pop', removed: 'd' }
+
+items.splice(0, 1, 'z');
+// { type: 'splice', start: 0, deleteCount: 1, removed: ['a'], added: ['z'] }
+
+items.set(0, 'x');
+// { type: 'set', index: 0, value: 'x' }
+
+items.sort();
+// { type: 'sort' }
+
+items.reverse();
+// { type: 'reverse' }
+
+items.dispose(); // remove all subscribers
+```
+
+### Mutation types
+
+| Method        | Mutation type  | Extra fields                                    |
+|---------------|----------------|-------------------------------------------------|
+| `push`        | `push`         | `items: T[]`                                    |
+| `pop`         | `pop`          | `removed: T \| undefined`                       |
+| `shift`       | `shift`        | `removed: T \| undefined`                       |
+| `unshift`     | `unshift`      | `items: T[]`                                    |
+| `splice`      | `splice`       | `start`, `deleteCount`, `removed`, `added`      |
+| `sort`        | `sort`         | —                                               |
+| `reverse`     | `reverse`      | —                                               |
+| `fill`        | `fill`         | `value`, `start`, `end`                         |
+| `copyWithin`  | `copyWithin`   | `target`, `start`, `end`                        |
+| `.set(i, v)`  | `set`          | `index`, `value`                                |
+
+---
+
+## Utilities
+
+### findRefs
+
+Recursively walks any value (object, array, or primitive) and returns all `Reference` instances found within it.
+
+```ts
+import { ref, findRefs } from '@derivesome/core';
+
+const a = ref(1);
+const b = ref(2);
+
+findRefs({ a, b, nested: { c: ref(3) } });
+// [Reference<1>, Reference<2>, Reference<3>]
+
+findRefs([a, b]);
+// [Reference<1>, Reference<2>]
+
+findRefs(42); // []
+```
+
+---
+
+### match
+
+`match(input, pattern)` is a structural pattern matching utility. It checks whether `input` structurally matches `pattern`, working as a type guard.
+
+```ts
+import { match } from '@derivesome/core';
+
+// Primitive matching
+match('hello', 'hello'); // true
+match(42, 42);           // true
+match(42, 99);           // false
+
+// Object structural matching (partial — only pattern keys are checked)
+const user = { role: 'admin', name: 'Alice' };
+match(user, { role: 'admin' }); // true — narrows type
+match(user, { role: 'guest' }); // false
+
+// Array matching (positional)
+match([1, 2, 3], [1, 2]); // true (pattern checked index-by-index)
+
+// Type narrowing
+type Shape =
+  | { kind: 'circle'; radius: number }
+  | { kind: 'square'; side: number };
+
+function area(shape: Shape): number {
+  if (match(shape, { kind: 'circle' as const })) {
+    return Math.PI * shape.radius ** 2; // shape is narrowed to circle
+  }
+  return shape.side ** 2;
+}
+```
+
+---
+
+### diff / patch
+
+`diff(a, b)` computes a list of structural differences between two values. `patch(target, diffs)` applies those diffs to produce a new value.
+
+```ts
+import { diff, patch } from '@derivesome/core';
+
+const a = { x: 1, y: 2 };
+const b = { x: 1, y: 3, z: 4 };
+
+const diffs = diff(a, b);
+// [
+//   { type: 'changed', path: ['y'], oldValue: 2, newValue: 3 },
+//   { type: 'added',   path: ['z'], newValue: 4 },
+// ]
+
+const result = patch({ ...a }, diffs);
+// { x: 1, y: 3, z: 4 }
+```
+
+Works recursively on nested objects and arrays:
+
+```ts
+diff([1, 2, 3], [1, 2, 3, 4]);
+// [{ type: 'added', path: [3], newValue: 4 }]
+
+diff({ a: { b: 1 } }, { a: { b: 2 } });
+// [{ type: 'changed', path: ['a', 'b'], oldValue: 1, newValue: 2 }]
+```
+
+---
+
+### Stack
+
+A simple typed stack used internally by the context system. Exported for external use.
+
+```ts
+import { Stack } from '@derivesome/core';
+
+const stack = new Stack([1, 2, 3]);
+
+stack.current; // 3 (top of stack)
+stack.push(4);
+stack.current; // 4
+stack.pop();   // 4
+stack.current; // 3
+```

package/dist/cjs/array-proxy.d.ts

@@ -0,0 +1,56 @@
+import { PubSub } from "./pubsub";
+import { VoidFunction } from "./common/types";
+export type ArrayMutation<T> = {
+    type: "push";
+    items: T[];
+} | {
+    type: "pop";
+    removed: T | undefined;
+} | {
+    type: "shift";
+    removed: T | undefined;
+} | {
+    type: "unshift";
+    items: T[];
+} | {
+    type: "splice";
+    start: number;
+    deleteCount: number;
+    removed: T[];
+    added: T[];
+} | {
+    type: "sort";
+} | {
+    type: "reverse";
+} | {
+    type: "fill";
+    value: T;
+    start: number;
+    end: number;
+} | {
+    type: "copyWithin";
+    target: number;
+    start: number;
+    end: number;
+} | {
+    type: "set";
+    index: number;
+    value: T;
+};
+export declare class ArrayProxy<T> extends Array<T> {
+    readonly ps: PubSub<ArrayMutation<T>>;
+    constructor(...items: T[]);
+    subscribe(fn: (mutation: ArrayMutation<T>) => void, cleanup?: VoidFunction): VoidFunction;
+    push(...items: T[]): number;
+    pop(): T | undefined;
+    shift(): T | undefined;
+    unshift(...items: T[]): number;
+    splice(start: number, deleteCount?: number, ...items: T[]): T[];
+    sort(compareFn?: (a: T, b: T) => number): this;
+    reverse(): this;
+    fill(value: T, start?: number, end?: number): this;
+    copyWithin(target: number, start: number, end?: number): this;
+    set(index: number, value: T): void;
+    dispose(): void;
+}
+//# sourceMappingURL=array-proxy.d.ts.map

package/dist/cjs/array-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-proxy.d.ts","sourceRoot":"","sources":["../../src/array-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,MAAM,aAAa,CAAC,CAAC,IACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,CAAC,GAAG,SAAS,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,CAAC,GAAG,SAAS,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,CAAA;CAAE,GAChF;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAE7C,qBAAa,UAAU,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;gBAE1B,GAAG,KAAK,EAAE,CAAC,EAAE;IAKzB,SAAS,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY;IAIhF,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,MAAM;IAM3B,GAAG,IAAI,CAAC,GAAG,SAAS;IAMpB,KAAK,IAAI,CAAC,GAAG,SAAS;IAMtB,OAAO,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,MAAM;IAM9B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAO/D,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI;IAM9C,OAAO,IAAI,IAAI;IAMf,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQlD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAOtE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAKlC,OAAO,IAAI,IAAI;CAGhB"}

package/dist/cjs/array-proxy.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArrayProxy = void 0;
+const pubsub_1 = require("./pubsub");
+class ArrayProxy extends Array {
+    ps;
+    constructor(...items) {
+        super(...items);
+        this.ps = (0, pubsub_1.pubsub)();
+    }
+    subscribe(fn, cleanup) {
+        return this.ps.subscribe(fn, cleanup);
+    }
+    push(...items) {
+        const result = super.push(...items);
+        this.ps.publish({ type: "push", items });
+        return result;
+    }
+    pop() {
+        const removed = super.pop();
+        this.ps.publish({ type: "pop", removed });
+        return removed;
+    }
+    shift() {
+        const removed = super.shift();
+        this.ps.publish({ type: "shift", removed });
+        return removed;
+    }
+    unshift(...items) {
+        const result = super.unshift(...items);
+        this.ps.publish({ type: "unshift", items });
+        return result;
+    }
+    splice(start, deleteCount, ...items) {
+        const dc = deleteCount ?? this.length - start;
+        const removed = super.splice(start, dc, ...items);
+        this.ps.publish({ type: "splice", start, deleteCount: dc, removed, added: items });
+        return removed;
+    }
+    sort(compareFn) {
+        super.sort(compareFn);
+        this.ps.publish({ type: "sort" });
+        return this;
+    }
+    reverse() {
+        super.reverse();
+        this.ps.publish({ type: "reverse" });
+        return this;
+    }
+    fill(value, start, end) {
+        const s = start ?? 0;
+        const e = end ?? this.length;
+        super.fill(value, s, e);
+        this.ps.publish({ type: "fill", value, start: s, end: e });
+        return this;
+    }
+    copyWithin(target, start, end) {
+        const e = end ?? this.length;
+        super.copyWithin(target, start, e);
+        this.ps.publish({ type: "copyWithin", target, start, end: e });
+        return this;
+    }
+    set(index, value) {
+        this[index] = value;
+        this.ps.publish({ type: "set", index, value });
+    }
+    dispose() {
+        this.ps.dispose();
+    }
+}
+exports.ArrayProxy = ArrayProxy;
+//# sourceMappingURL=array-proxy.js.map

package/dist/cjs/array-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-proxy.js","sourceRoot":"","sources":["../../src/array-proxy.ts"],"names":[],"mappings":"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"}

package/dist/cjs/common/array.d.ts

@@ -0,0 +1,11 @@
+export declare const range: (n: number) => Array<number>;
+export declare const enumerate: <T>(arr: T[]) => Array<[number, T]>;
+export declare const zipMin: <A, B>(a: A[], b: B[]) => Array<[A, B]>;
+export declare const zipMax: <A, B>(a: A[], b: B[]) => Array<[A | undefined, B | undefined]>;
+export declare const zipByKey: <A, B>(a: A[], b: B[], getKey: <T extends A | B>(item: T) => PropertyKey | null) => {
+    pairs: Array<[A, B]>;
+    restA: A[];
+    restB: B[];
+};
+export declare const unique: <T>(arr: T[]) => T[];
+//# sourceMappingURL=array.d.ts.map

package/dist/cjs/common/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../src/common/array.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,KAAG,KAAK,CAAC,MAAM,CACS,CAAC;AAExD,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,KAAK,CAAC,EAAE,KAAG,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAExD,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,KAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAGzD,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,KAAG,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC,CAGjF,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,EAC3B,GAAG,CAAC,EAAE,EACN,GAAG,CAAC,EAAE,EACN,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,WAAW,GAAG,IAAI,KACvD;IAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,CAAA;CA6ChD,CAAC;AAGF,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,KAAK,CAAC,EAAE,KAAG,CAAC,EAErC,CAAA"}

package/dist/cjs/common/array.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unique = exports.zipByKey = exports.zipMax = exports.zipMin = exports.enumerate = exports.range = void 0;
+const range = (n) => n <= 0 ? [] : Array.from(Array(Math.floor(n)).keys());
+exports.range = range;
+const enumerate = (arr) => {
+    return arr.map((v, i) => [i, v]);
+};
+exports.enumerate = enumerate;
+const zipMin = (a, b) => {
+    const length = Math.min(a.length, b.length);
+    return (0, exports.range)(length).map((i) => [a[i], b[i]]);
+};
+exports.zipMin = zipMin;
+const zipMax = (a, b) => {
+    const length = Math.max(a.length, b.length);
+    return (0, exports.range)(length).map((i) => [a[i], b[i]]);
+};
+exports.zipMax = zipMax;
+const zipByKey = (a, b, getKey) => {
+    const keys = Array.from(new Set([...a.map((x) => getKey(x)), ...b.map((x) => getKey(x))].filter((x) => x !== null)));
+    const ma = new Map(a
+        .map((x) => [getKey(x), x])
+        .filter(([k, _]) => k !== null));
+    const mb = new Map(b
+        .map((x) => [getKey(x), x])
+        .filter(([k, _]) => k !== null));
+    const z = [];
+    const restA = [];
+    const restB = [];
+    const seenA = new Set();
+    const seenB = new Set();
+    for (const k of keys) {
+        const va = ma.get(k) ?? null;
+        const vb = mb.get(k) ?? null;
+        if (va !== null && vb === null) {
+            restA.push(va);
+            seenA.add(va);
+        }
+        else if (va === null && vb !== null) {
+            restB.push(vb);
+            seenB.add(vb);
+        }
+        else if (va !== null && vb !== null) {
+            z.push([va, vb]);
+            seenA.add(va);
+            seenB.add(vb);
+        }
+    }
+    return { pairs: z, restA, restB };
+};
+exports.zipByKey = zipByKey;
+const unique = (arr) => {
+    return Array.from(new Set(arr));
+};
+exports.unique = unique;
+//# sourceMappingURL=array.js.map

package/dist/cjs/common/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../../src/common/array.ts"],"names":[],"mappings":"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"}

package/dist/cjs/common/compare.d.ts

@@ -0,0 +1,2 @@
+export declare const compare: (a: unknown, b: unknown) => boolean;
+//# sourceMappingURL=compare.d.ts.map

package/dist/cjs/common/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../../src/common/compare.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,OAEhD,CAAC"}

package/dist/cjs/common/compare.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compare = void 0;
+const compare = (a, b) => {
+    return a === b;
+};
+exports.compare = compare;
+//# sourceMappingURL=compare.js.map

package/dist/cjs/common/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../../src/common/compare.ts"],"names":[],"mappings":";;;AAAO,MAAM,OAAO,GAAG,CAAC,CAAU,EAAE,CAAU,EAAW,EAAE;IACzD,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC,CAAC;AAFW,QAAA,OAAO,WAElB"}

package/dist/cjs/common/diff.d.ts

@@ -0,0 +1,9 @@
+export type DiffType = 'added' | 'removed' | 'changed';
+export type Diff = {
+    type: DiffType;
+    path: PropertyKey[];
+    oldValue?: unknown;
+    newValue?: unknown;
+};
+export declare const diff: <T>(a: T, b: T) => Diff[];
+//# sourceMappingURL=diff.d.ts.map

package/dist/cjs/common/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/common/diff.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvD,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,KAAG,IAAI,EAIxC,CAAC"}

package/dist/cjs/common/diff.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diff = void 0;
+const is_1 = require("./is");
+const diff = (a, b) => {
+    const diffs = [];
+    diffRecursive(a, b, [], diffs);
+    return diffs;
+};
+exports.diff = diff;
+const diffRecursive = (a, b, path, diffs) => {
+    if (a === b)
+        return;
+    const aIsArray = Array.isArray(a);
+    const bIsArray = Array.isArray(b);
+    if (aIsArray && bIsArray) {
+        diffArrays(a, b, path, diffs);
+        return;
+    }
+    const aIsObject = (0, is_1.isPlainObject)(a);
+    const bIsObject = (0, is_1.isPlainObject)(b);
+    if (aIsObject && bIsObject) {
+        diffObjects(a, b, path, diffs);
+        return;
+    }
+    diffs.push({ type: 'changed', path, oldValue: a, newValue: b });
+};
+const diffObjects = (a, b, path, diffs) => {
+    const aKeys = Reflect.ownKeys(a);
+    const bKeys = Reflect.ownKeys(b);
+    const bKeySet = new Set(bKeys);
+    for (const key of aKeys) {
+        const childPath = [...path, key];
+        if (!bKeySet.has(key)) {
+            diffs.push({ type: 'removed', path: childPath, oldValue: a[key] });
+        }
+        else {
+            diffRecursive(a[key], b[key], childPath, diffs);
+        }
+    }
+    const aKeySet = new Set(aKeys);
+    for (const key of bKeys) {
+        if (!aKeySet.has(key)) {
+            diffs.push({ type: 'added', path: [...path, key], newValue: b[key] });
+        }
+    }
+};
+const diffArrays = (a, b, path, diffs) => {
+    const maxLen = Math.max(a.length, b.length);
+    for (let i = 0; i < maxLen; i++) {
+        const childPath = [...path, i];
+        if (i >= a.length) {
+            diffs.push({ type: 'added', path: childPath, newValue: b[i] });
+        }
+        else if (i >= b.length) {
+            diffs.push({ type: 'removed', path: childPath, oldValue: a[i] });
+        }
+        else {
+            diffRecursive(a[i], b[i], childPath, diffs);
+        }
+    }
+};
+//# sourceMappingURL=diff.js.map

package/dist/cjs/common/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/common/diff.ts"],"names":[],"mappings":"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"}