@ng-org/alien-deepsignals 0.1.2-alpha.1

package/dist/effect.d.ts

@@ -0,0 +1,5 @@
+type RegisterCleanup = (cleanup: () => void) => void;
+/** Wrap `alien-signals` effect with optional cleanup registration. */
+export declare function effect(run: (registerCleanup?: RegisterCleanup) => void): () => void;
+export {};
+//# sourceMappingURL=effect.d.ts.map

package/dist/effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.d.ts","sourceRoot":"","sources":["../src/effect.ts"],"names":[],"mappings":"AAKA,KAAK,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;AAErD,sEAAsE;AACtE,wBAAgB,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,EAAE,eAAe,KAAK,IAAI,cA2BtE"}

package/dist/effect.js

@@ -0,0 +1,35 @@
+"use strict";
+// Copyright (c) 2025 Laurin Weger, Par le Peuple, NextGraph.org developers
+// SPDX-License-Identifier: Apache-2.0 OR MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.effect = effect;
+const core_1 = require("./core");
+/** Wrap `alien-signals` effect with optional cleanup registration. */
+function effect(run) {
+    let cleanup;
+    const registerCleanup = (fn) => {
+        cleanup = fn;
+    };
+    const stop = (0, core_1._rawEffect)(() => {
+        if (cleanup) {
+            try {
+                cleanup();
+            }
+            finally {
+                cleanup = undefined;
+            }
+        }
+        run(registerCleanup);
+    });
+    return () => {
+        if (cleanup) {
+            try {
+                cleanup();
+            }
+            finally {
+                cleanup = undefined;
+            }
+        }
+        stop();
+    };
+}

package/dist/hooks/react/index.d.ts

@@ -0,0 +1,3 @@
+import useDeepSignal from "./useDeepSignal.js";
+export { useDeepSignal };
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/hooks/react/index.js

@@ -0,0 +1,8 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDeepSignal = void 0;
+const useDeepSignal_js_1 = __importDefault(require("./useDeepSignal.js"));
+exports.useDeepSignal = useDeepSignal_js_1.default;

package/dist/hooks/react/useDeepSignal.d.ts

@@ -0,0 +1,14 @@
+import { DeepSignalOptions } from "../../types.js";
+/**
+ * Create or use an existing deepSignal object in your component.
+ * Modifications to the returned deepSignal object cause an immediate rerender.
+ * If modifications of the object are made from somewhere else, the component
+ * is rerendered as well.
+ *
+ * @param object The object that should become reactive
+ * @param deepSignalObjects When the object is not a deepSignal already, options passed to `deepSignal`.
+ * @returns The deepSignal object of the object param.
+ */
+declare const useSignal: <T extends object>(object: T, deepSignalObjects?: DeepSignalOptions) => import("../../types.js").DeepSignal<T>;
+export default useSignal;
+//# sourceMappingURL=useDeepSignal.d.ts.map

package/dist/hooks/react/useDeepSignal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeepSignal.d.ts","sourceRoot":"","sources":["../../../src/hooks/react/useDeepSignal.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;;;;GASG;AACH,QAAA,MAAM,SAAS,GAAI,CAAC,SAAS,MAAM,EAC/B,QAAQ,CAAC,EACT,oBAAoB,iBAAiB,2CAqBxC,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/hooks/react/useDeepSignal.js

@@ -0,0 +1,39 @@
+"use strict";
+// Copyright (c) 2025 Laurin Weger, Par le Peuple, NextGraph.org developers
+// All rights reserved.
+// Licensed under the Apache License, Version 2.0
+// <LICENSE-APACHE2 or http://www.apache.org/licenses/LICENSE-2.0>
+// or the MIT license <LICENSE-MIT or http://opensource.org/licenses/MIT>,
+// at your option. All files in the project carrying such
+// notice may not be copied, modified, or distributed except
+// according to those terms.
+// SPDX-License-Identifier: Apache-2.0 OR MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+const watch_js_1 = require("../../watch.js");
+const react_1 = require("react");
+const deepSignal_1 = require("../../deepSignal");
+/**
+ * Create or use an existing deepSignal object in your component.
+ * Modifications to the returned deepSignal object cause an immediate rerender.
+ * If modifications of the object are made from somewhere else, the component
+ * is rerendered as well.
+ *
+ * @param object The object that should become reactive
+ * @param deepSignalObjects When the object is not a deepSignal already, options passed to `deepSignal`.
+ * @returns The deepSignal object of the object param.
+ */
+const useSignal = (object, deepSignalObjects) => {
+    const shapeSignalRef = (0, react_1.useRef)((0, deepSignal_1.deepSignal)(object, deepSignalObjects));
+    const [, setTick] = (0, react_1.useState)(0);
+    (0, react_1.useEffect)(() => {
+        const { stopListening } = (0, watch_js_1.watch)(shapeSignalRef.current, () => {
+            // trigger a React re-render when the deep signal updates
+            setTick((t) => t + 1);
+        }, { triggerInstantly: true });
+        return () => {
+            stopListening();
+        };
+    }, []);
+    return shapeSignalRef.current;
+};
+exports.default = useSignal;

package/dist/hooks/svelte/index.d.ts

@@ -0,0 +1,4 @@
+import useDeepSignal from "./useDeepSignal.svelte.js";
+export { useDeepSignal };
+export type { UseDeepSignalResult } from "./useDeepSignal.svelte.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/svelte/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/svelte/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,CAAC;AACzB,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/hooks/svelte/index.js

@@ -0,0 +1,8 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDeepSignal = void 0;
+const useDeepSignal_svelte_js_1 = __importDefault(require("./useDeepSignal.svelte.js"));
+exports.useDeepSignal = useDeepSignal_svelte_js_1.default;

package/dist/hooks/svelte/useDeepSignal.svelte.d.ts

@@ -0,0 +1,31 @@
+import { type Readable } from "svelte/store";
+import { type DeepPatchBatch, DeepSignalOptions, RevertDeepSignal } from "../../index";
+/** Base result contract for a deepSignal-backed Svelte integration. */
+export interface UseDeepSignalResult<T extends object> extends Readable<T> {
+    /** Store of the full deep proxy tree (also accessible via `subscribe` directly on this result). */
+    deep: Readable<T>;
+    /** Last batch of deep mutation patches for this root (empties only on next non-empty batch). */
+    patches: Readable<DeepPatchBatch | null>;
+    /** Derive a nested selection; re-runs when the underlying tree version increments. */
+    select<U>(selector: (tree: T) => U): Readable<U>;
+    /** Stop receiving further updates (invoked automatically on component destroy). */
+    dispose(): void;
+    /** Replace root shape contents (mutative merge) – enables Svelte writable store binding semantics. */
+    set(next: Partial<T> | T): void;
+    /** Functional update helper using current tree snapshot. */
+    update(updater: (current: T) => T | void): void;
+}
+/**
+ * Create a rune from a deepSignal object (creates one if it is just a regular object).
+ *
+ * Modifications to the returned deepSignal object cause an immediate rerender.
+ * If modifications of the object are made from somewhere else, the component
+ * is rerendered as well.
+ *
+ * @param object The object that should become reactive
+ * @param deepSignalObjects When the object is not a deepSignal already, options passed to `deepSignal`.
+ * @returns A rune for using the deepSignal object in svelte.
+ */
+export declare function useDeepSignal<T extends object>(object: T, options?: DeepSignalOptions): UseDeepSignalResult<RevertDeepSignal<T>>;
+export default useDeepSignal;
+//# sourceMappingURL=useDeepSignal.svelte.d.ts.map

package/dist/hooks/svelte/useDeepSignal.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeepSignal.svelte.d.ts","sourceRoot":"","sources":["../../../src/hooks/svelte/useDeepSignal.svelte.ts"],"names":[],"mappings":"AAUA,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAGH,KAAK,cAAc,EACnB,iBAAiB,EAEjB,gBAAgB,EAEnB,MAAM,aAAa,CAAC;AAErB,uEAAuE;AACvE,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IACtE,mGAAmG;IACnG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAClB,gGAAgG;IAChG,OAAO,EAAE,QAAQ,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACzC,sFAAsF;IACtF,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACjD,mFAAmF;IACnF,OAAO,IAAI,IAAI,CAAC;IAChB,sGAAsG;IACtG,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAChC,4DAA4D;IAC5D,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;CACnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC1C,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,iBAAiB,GAC5B,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAiD1C;AAED,eAAe,aAAa,CAAC"}

package/dist/hooks/svelte/useDeepSignal.svelte.js

@@ -0,0 +1,74 @@
+"use strict";
+// Copyright (c) 2025 Laurin Weger, Par le Peuple, NextGraph.org developers
+// All rights reserved.
+// Licensed under the Apache License, Version 2.0
+// <LICENSE-APACHE2 or http://www.apache.org/licenses/LICENSE-2.0>
+// or the MIT license <LICENSE-MIT or http://opensource.org/licenses/MIT>,
+// at your option. All files in the project carrying such
+// notice may not be copied, modified, or distributed except
+// according to those terms.
+// SPDX-License-Identifier: Apache-2.0 OR MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDeepSignal = useDeepSignal;
+const store_1 = require("svelte/store");
+const svelte_1 = require("svelte");
+const index_1 = require("../../index");
+/**
+ * Create a rune from a deepSignal object (creates one if it is just a regular object).
+ *
+ * Modifications to the returned deepSignal object cause an immediate rerender.
+ * If modifications of the object are made from somewhere else, the component
+ * is rerendered as well.
+ *
+ * @param object The object that should become reactive
+ * @param deepSignalObjects When the object is not a deepSignal already, options passed to `deepSignal`.
+ * @returns A rune for using the deepSignal object in svelte.
+ */
+function useDeepSignal(object, options) {
+    const deepProxy = (0, index_1.deepSignal)(object, options);
+    const rootId = (0, index_1.getDeepSignalRootId)(deepProxy);
+    const initialVersion = (0, index_1.getDeepSignalVersion)(deepProxy) ?? 0;
+    const version = (0, store_1.writable)(initialVersion);
+    const patchesStore = (0, store_1.writable)(null);
+    const unsubscribe = (0, index_1.subscribeDeepMutations)(deepProxy, (batch) => {
+        if (!rootId)
+            return;
+        if (batch.patches.length) {
+            patchesStore.set(batch);
+            version.set(batch.version);
+        }
+    });
+    const deep = (0, store_1.derived)(version, () => deepProxy);
+    const select = (selector) => (0, store_1.derived)(deep, (t) => selector(t));
+    const dispose = () => unsubscribe();
+    (0, svelte_1.onDestroy)(dispose);
+    // Expose Svelte store contract by delegating subscribe to deep store.
+    const applyReplacement = (next) => {
+        if (!next || typeof next !== "object")
+            return;
+        // Remove keys absent in next
+        for (const k of Object.keys(deepProxy)) {
+            if (!(k in next))
+                delete deepProxy[k];
+        }
+        // Assign / overwrite provided keys
+        Object.assign(deepProxy, next);
+    };
+    const store = {
+        deep,
+        patches: patchesStore,
+        select,
+        dispose,
+        subscribe: deep.subscribe,
+        set(next) {
+            applyReplacement(next);
+        },
+        update(updater) {
+            const result = updater(deepProxy);
+            if (result && typeof result === "object")
+                applyReplacement(result);
+        },
+    };
+    return store;
+}
+exports.default = useDeepSignal;

package/dist/hooks/vue/index.d.ts

@@ -0,0 +1,3 @@
+import useDeepSignal from "./useDeepSignal";
+export { useDeepSignal };
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/vue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/vue/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/hooks/vue/index.js

@@ -0,0 +1,8 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDeepSignal = void 0;
+const useDeepSignal_1 = __importDefault(require("./useDeepSignal"));
+exports.useDeepSignal = useDeepSignal_1.default;

package/dist/hooks/vue/useDeepSignal.d.ts

@@ -0,0 +1,15 @@
+import { DeepSignal, DeepSignalOptions } from "../../";
+/**
+ * Create or use an existing deepSignal object in your component.
+ * Modifications to the returned deepSignal object cause an immediate rerender.
+ * If modifications of the object are made from somewhere else, the component
+ * is rerendered as well.
+ *
+ * @param object The object that should become reactive
+ * @param deepSignalObjects When the object is not a deepSignal already, options passed to `deepSignal`.
+ * @returns The deepSignal object of the object param.
+ *
+ */
+export declare function useDeepSignal<T extends object>(object: T, options?: DeepSignalOptions): DeepSignal<T>;
+export default useDeepSignal;
+//# sourceMappingURL=useDeepSignal.d.ts.map

package/dist/hooks/vue/useDeepSignal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeepSignal.d.ts","sourceRoot":"","sources":["../../../src/hooks/vue/useDeepSignal.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,UAAU,EAAc,iBAAiB,EAAS,MAAM,QAAQ,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC1C,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,iBAAiB,GAC5B,UAAU,CAAC,CAAC,CAAC,CAgDf;AAED,eAAe,aAAa,CAAC"}

package/dist/hooks/vue/useDeepSignal.js

@@ -0,0 +1,73 @@
+"use strict";
+// Copyright (c) 2025 Laurin Weger, Par le Peuple, NextGraph.org developers
+// All rights reserved.
+// Licensed under the Apache License, Version 2.0
+// <LICENSE-APACHE2 or http://www.apache.org/licenses/LICENSE-2.0>
+// or the MIT license <LICENSE-MIT or http://opensource.org/licenses/MIT>,
+// at your option. All files in the project carrying such
+// notice may not be copied, modified, or distributed except
+// according to those terms.
+// SPDX-License-Identifier: Apache-2.0 OR MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDeepSignal = useDeepSignal;
+const vue_1 = require("vue");
+const __1 = require("../../");
+/**
+ * Create or use an existing deepSignal object in your component.
+ * Modifications to the returned deepSignal object cause an immediate rerender.
+ * If modifications of the object are made from somewhere else, the component
+ * is rerendered as well.
+ *
+ * @param object The object that should become reactive
+ * @param deepSignalObjects When the object is not a deepSignal already, options passed to `deepSignal`.
+ * @returns The deepSignal object of the object param.
+ *
+ */
+function useDeepSignal(object, options) {
+    const version = (0, vue_1.ref)(0);
+    const signalObject = (0, __1.deepSignal)(object, options);
+    const stopHandle = (0, __1.watch)(signalObject, ({ patches }) => {
+        if (patches.length > 0) {
+            version.value++;
+        }
+    });
+    // Proxy that creates Vue dependency on version for any access
+    const proxy = new Proxy(signalObject, {
+        get(target, key) {
+            if (key === "__raw")
+                return target;
+            // Track version to create reactive dependency
+            version.value;
+            const value = target[key];
+            // Bind methods to maintain correct `this` context
+            return typeof value === "function" ? value.bind(target) : value;
+        },
+        set(target, key, value) {
+            // Directly forward writes to the deep signal root so other frameworks observe the change.
+            return Reflect.set(target, key, value);
+        },
+        has(target, key) {
+            version.value;
+            return key in target;
+        },
+        ownKeys(target) {
+            version.value;
+            return Reflect.ownKeys(target);
+        },
+        getOwnPropertyDescriptor(target, key) {
+            version.value;
+            const desc = Object.getOwnPropertyDescriptor(target, key);
+            return desc ? { ...desc, configurable: true } : undefined;
+        },
+    });
+    (0, vue_1.onBeforeUnmount)(() => {
+        try {
+            stopHandle.stopListening();
+        }
+        catch {
+            // ignore
+        }
+    });
+    return proxy;
+}
+exports.default = useDeepSignal;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./deepSignal";
+export * from "./core";
+export * from "./watch";
+export * from "./effect";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./deepSignal"), exports);
+__exportStar(require("./core"), exports);
+__exportStar(require("./watch"), exports);
+__exportStar(require("./effect"), exports);
+__exportStar(require("./types"), exports);

package/dist/iteratorHelpers.d.ts

@@ -0,0 +1,3 @@
+export declare const iteratorHelperKeys: Set<string>;
+export declare function createIteratorWithHelpers<T>(nextImpl: () => IteratorResult<T, undefined>, sourceIterator?: Iterator<unknown, unknown, undefined>): IteratorObject<T, undefined, unknown>;
+//# sourceMappingURL=iteratorHelpers.d.ts.map

package/dist/iteratorHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iteratorHelpers.d.ts","sourceRoot":"","sources":["../src/iteratorHelpers.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,kBAAkB,aAY7B,CAAC;AAEH,wBAAgB,yBAAyB,CAAC,CAAC,EACvC,QAAQ,EAAE,MAAM,cAAc,CAAC,CAAC,EAAE,SAAS,CAAC,EAC5C,cAAc,CAAC,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,GACvD,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAmBvC"}

package/dist/iteratorHelpers.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.iteratorHelperKeys = void 0;
+exports.createIteratorWithHelpers = createIteratorWithHelpers;
+function hasNativeIteratorHelpers() {
+    return (typeof Iterator !== "undefined" && typeof Iterator.from === "function");
+}
+exports.iteratorHelperKeys = new Set([
+    "map",
+    "filter",
+    "take",
+    "drop",
+    "flatMap",
+    "reduce",
+    "toArray",
+    "forEach",
+    "some",
+    "every",
+    "find",
+]);
+function createIteratorWithHelpers(nextImpl, sourceIterator) {
+    const base = {
+        next: nextImpl,
+        [Symbol.iterator]() {
+            return this;
+        },
+        return() {
+            if (sourceIterator && typeof sourceIterator.return === "function") {
+                sourceIterator.return();
+            }
+            return { value: undefined, done: true };
+        },
+    };
+    if (hasNativeIteratorHelpers()) {
+        return Iterator.from(base);
+    }
+    return base;
+}

package/dist/types.d.ts

@@ -0,0 +1,107 @@
+import { computed, signal } from "./core";
+/** Deep mutation emitted from a deepSignal root. */
+export type DeepPatch = {
+    path: (string | number)[];
+} & ({
+    op: "add";
+    type?: "object" | "set";
+    value?: any;
+} | {
+    op: "remove";
+    type?: "set";
+    value?: any;
+});
+/** Batched patch payload tagged with a monotonically increasing version. */
+export interface DeepPatchBatch {
+    version: number;
+    patches: DeepPatch[];
+}
+/** Batched patch payload for justInTime listeners. */
+export interface DeepPatchJITBatch {
+    patches: DeepPatch[];
+}
+export type DeepPatchSubscriber = (batch: DeepPatchBatch) => void;
+export type DeepPatchJITSubscriber = (batch: DeepPatchJITBatch) => void;
+export interface DeepSignalOptions {
+    propGenerator?: DeepSignalPropGenFn;
+    syntheticIdPropertyName?: string;
+    readOnlyProps?: string[];
+}
+export type DeepSignalPropGenFn = (props: {
+    path: (string | number)[];
+    inSet: boolean;
+    object: any;
+}) => {
+    syntheticId?: string | number;
+    extraProps?: Record<string, unknown>;
+};
+export interface ProxyMeta {
+    raw: object;
+    parent?: object;
+    key?: string | number | symbol;
+    isSyntheticId?: boolean;
+    root: symbol;
+    options: DeepSignalOptions;
+    setInfo?: SetMeta;
+}
+export interface SetMeta {
+    idForObject: WeakMap<object, string>;
+    objectForId: Map<string, object>;
+}
+export interface RootState {
+    options?: DeepSignalOptions;
+    version: number;
+    justInTimeListeners: Set<DeepPatchJITSubscriber>;
+    listeners: Set<DeepPatchSubscriber>;
+    pendingPatches: DeepPatch[];
+}
+type WritableSignalFunction<T> = typeof signal<T>;
+type ComputedSignalFunction<T> = typeof computed<T>;
+export type WritableSignal<T = any> = ReturnType<WritableSignalFunction<T>>;
+export type ComputedSignal<T = any> = ReturnType<ComputedSignalFunction<T>>;
+export type SignalLike<T = any> = WritableSignal<T> | ComputedSignal<T>;
+/** Raw and meta key. */
+export type DeepSignalObjectProps<T> = {
+    __raw__: T;
+    __meta__: ProxyMeta;
+};
+/** Utility functions for sets. */
+export type DeepSignalSetProps<T> = {
+    /** Get the element that was first inserted into the set. */
+    first(): undefined | (T extends object ? DeepSignal<T> : T);
+    /**
+     * Retrieve an entry from the Set by its synthetic ID.
+     * @param id - The synthetic ID (string or number) assigned to the entry.
+     * @returns The proxied entry if found, undefined otherwise.
+     */
+    getById(id: string | number): DeepSignal<T> | undefined;
+    /**
+     * Retrieve an entry from the Set by constructing an ID from graphIri and subjectIri.
+     * This is a convenience method that constructs the ID as "graphIri|subjectIri".
+     * @param graphIri - The graph IRI part of the identifier.
+     * @param subjectIri - The subject IRI part of the identifier.
+     * @returns The proxied entry if found, undefined otherwise.
+     */
+    getBy(graphIri: string, subjectIri: string): DeepSignal<T> | undefined;
+};
+/** Reactive Set wrapper that accepts raw or proxied entries. */
+export interface DeepSignalSet<T> extends Set<DeepSignal<T>>, DeepSignalObjectProps<Set<T>>, SetIterator<DeepSignal<T>>, DeepSignalSetProps<T> {
+    add(value: T | DeepSignal<T>): this;
+    delete(value: T | DeepSignal<T>): boolean;
+    has(value: T | DeepSignal<T>): boolean;
+    forEach(callbackfn: (value: DeepSignal<T>, value2: DeepSignal<T>, set: DeepSignalSet<T>) => void, thisArg?: any): void;
+    forEach(callbackfn: (value: DeepSignal<T>, index: number) => void, thisArg?: any): void;
+}
+/**
+ * The object returned by the @see deepSignal function.
+ * It is decorated with utility functions for sets and a
+ * `__raw__` prop to get the underlying non-reactive object
+ * and `__meta__` prop, to get the internal metadata.
+ */
+export type DeepSignal<T> = T extends Function ? T : T extends string | number | boolean ? T : T extends DeepSignalObjectProps<any> | DeepSignalObjectProps<any>[] ? T : T extends Array<infer I> ? DeepSignal<I>[] : T extends Set<infer S> ? DeepSignalSet<S> : T extends object ? DeepSignalObject<T> : T;
+export type DeepSignalObject<T extends object> = {
+    [K in keyof T]: DeepSignal<T[K]>;
+};
+export type RevertDeepSignal<T> = T extends DeepSignal<infer S> ? S : T;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils.d.ts

@@ -0,0 +1,17 @@
+export declare const objectToString: typeof Object.prototype.toString;
+export declare const toTypeString: (value: unknown) => string;
+export declare const hasOwn: (val: object, key: string | symbol) => key is keyof typeof val;
+export declare const isArray: typeof Array.isArray;
+export declare const isMap: (val: unknown) => val is Map<any, any>;
+export declare const isSet: (val: unknown) => val is Set<any>;
+export declare const isDate: (val: unknown) => val is Date;
+export declare const isRegExp: (val: unknown) => val is RegExp;
+export declare const isFunction: (val: unknown) => val is Function;
+export declare const isString: (val: unknown) => val is string;
+export declare const isSymbol: (val: unknown) => val is symbol;
+export declare const isObject: (val: unknown) => val is Record<any, any>;
+export declare const isPromise: <T = any>(val: unknown) => val is Promise<T>;
+export declare const isPlainObject: (val: unknown) => val is object;
+export declare const hasChanged: (value: any, oldValue: any) => boolean;
+export declare function NOOP(): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,cAAc,EAAE,OAAO,MAAM,CAAC,SAAS,CAAC,QAC1B,CAAA;AAC3B,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAClB,CAAA;AAE5B,eAAO,MAAM,MAAM,GACjB,KAAK,MAAM,EACX,KAAK,MAAM,GAAG,MAAM,KACnB,GAAG,IAAI,MAAM,OAAO,GAAoC,CAAA;AAE3D,eAAO,MAAM,OAAO,EAAE,OAAO,KAAK,CAAC,OAAuB,CAAA;AAC1D,eAAO,MAAM,KAAK,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,CAClB,CAAA;AACtC,eAAO,MAAM,KAAK,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CACb,CAAA;AAEtC,eAAO,MAAM,MAAM,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,IACN,CAAA;AACvC,eAAO,MAAM,QAAQ,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,MACN,CAAA;AACzC,eAAO,MAAM,UAAU,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,QACtB,CAAA;AAC3B,eAAO,MAAM,QAAQ,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,MAAiC,CAAA;AAChF,eAAO,MAAM,QAAQ,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,MAAiC,CAAA;AAChF,eAAO,MAAM,QAAQ,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,MAAM,CAAC,GAAG,EAAE,GAAG,CACrB,CAAA;AAEzC,eAAO,MAAM,SAAS,GAAI,CAAC,GAAG,GAAG,EAAE,KAAK,OAAO,KAAG,GAAG,IAAI,OAAO,CAAC,CAAC,CAMjE,CAAA;AACD,eAAO,MAAM,aAAa,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,MACX,CAAA;AAEzC,eAAO,MAAM,UAAU,GAAI,OAAO,GAAG,EAAE,UAAU,GAAG,KAAG,OAC1B,CAAA;AAE7B,wBAAgB,IAAI,SAAK"}

package/dist/utils.js

@@ -0,0 +1,47 @@
+"use strict";
+// Copyright (c) 2025 Laurin Weger, Par le Peuple, NextGraph.org developers
+// All rights reserved.
+// Licensed under the Apache License, Version 2.0
+// <LICENSE-APACHE2 or http://www.apache.org/licenses/LICENSE-2.0>
+// or the MIT license <LICENSE-MIT or http://opensource.org/licenses/MIT>,
+// at your option. All files in the project carrying such
+// notice may not be copied, modified, or distributed except
+// according to those terms.
+// SPDX-License-Identifier: Apache-2.0 OR MIT
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasChanged = exports.isPlainObject = exports.isPromise = exports.isObject = exports.isSymbol = exports.isString = exports.isFunction = exports.isRegExp = exports.isDate = exports.isSet = exports.isMap = exports.isArray = exports.hasOwn = exports.toTypeString = exports.objectToString = void 0;
+exports.NOOP = NOOP;
+exports.objectToString = Object.prototype.toString;
+const toTypeString = (value) => exports.objectToString.call(value);
+exports.toTypeString = toTypeString;
+const hasOwnProperty = Object.prototype.hasOwnProperty;
+const hasOwn = (val, key) => hasOwnProperty.call(val, key);
+exports.hasOwn = hasOwn;
+exports.isArray = Array.isArray;
+const isMap = (val) => (0, exports.toTypeString)(val) === '[object Map]';
+exports.isMap = isMap;
+const isSet = (val) => (0, exports.toTypeString)(val) === '[object Set]';
+exports.isSet = isSet;
+const isDate = (val) => (0, exports.toTypeString)(val) === '[object Date]';
+exports.isDate = isDate;
+const isRegExp = (val) => (0, exports.toTypeString)(val) === '[object RegExp]';
+exports.isRegExp = isRegExp;
+const isFunction = (val) => typeof val === 'function';
+exports.isFunction = isFunction;
+const isString = (val) => typeof val === 'string';
+exports.isString = isString;
+const isSymbol = (val) => typeof val === 'symbol';
+exports.isSymbol = isSymbol;
+const isObject = (val) => val !== null && typeof val === 'object';
+exports.isObject = isObject;
+const isPromise = (val) => {
+    return (((0, exports.isObject)(val) || (0, exports.isFunction)(val)) &&
+        (0, exports.isFunction)(val.then) &&
+        (0, exports.isFunction)(val.catch));
+};
+exports.isPromise = isPromise;
+const isPlainObject = (val) => (0, exports.toTypeString)(val) === '[object Object]';
+exports.isPlainObject = isPlainObject;
+const hasChanged = (value, oldValue) => !Object.is(value, oldValue);
+exports.hasChanged = hasChanged;
+function NOOP() { }