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

package/dist/watch.d.ts

@@ -0,0 +1,27 @@
+import { DeepPatch, DeepSignal } from "./types";
+export type RegisterCleanup = (cleanupFn: () => void) => void;
+export interface WatchOptions {
+    /** True, if the callback should be run immediately after `watch` was called. @default false*/
+    immediate?: boolean;
+    /** True, if the watcher should be unsubscribed after the first event. @default false*/
+    once?: boolean;
+    /**
+     * If true, triggers watch callback instantly after changes to the signal object.
+     * Otherwise, changes are batched and the watch callback is triggered in a microtask.
+     * This is useful for frontends like React where modifications on the changed input in
+     * a separate (microtask) will cause the cursor in input elements to reset.
+     */
+    triggerInstantly?: boolean;
+}
+export interface WatchPatchEvent<T extends object> {
+    patches: DeepPatch[];
+    /** The version if `triggerInstantly` is not true. */
+    version?: number;
+    newValue: DeepSignal<T>;
+}
+export type WatchPatchCallback<T extends object> = (event: WatchPatchEvent<T>) => void;
+export declare function watch<T extends object>(source: DeepSignal<T>, callback: WatchPatchCallback<T>, options?: WatchOptions): {
+    stopListening: () => void;
+    registerCleanup: RegisterCleanup;
+};
+//# sourceMappingURL=watch.d.ts.map

package/dist/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,SAAS,EAAkB,UAAU,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;AAE9D,MAAM,WAAW,YAAY;IACzB,8FAA8F;IAC9F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uFAAuF;IACvF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM;IAC7C,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;CAC3B;AAED,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,IAAI,CAC/C,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KACxB,IAAI,CAAC;AAEV,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAClC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EACrB,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC/B,OAAO,GAAE,YAAiB;;;EAiE7B"}

package/dist/watch.js

@@ -0,0 +1,72 @@
+"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.watch = watch;
+const deepSignal_1 = require("./deepSignal");
+function watch(source, callback, options = {}) {
+    if (!(0, deepSignal_1.isDeepSignal)(source)) {
+        throw new Error("watch() expects a deepSignal root proxy");
+    }
+    const rootId = (0, deepSignal_1.getDeepSignalRootId)(source);
+    if (!rootId)
+        throw new Error("Unable to resolve deepSignal root id");
+    let active = true;
+    let cleanup;
+    const { immediate, once } = options;
+    const registerCleanup = (fn) => {
+        cleanup = fn;
+    };
+    const runCleanup = () => {
+        if (!cleanup)
+            return;
+        try {
+            cleanup();
+        }
+        finally {
+            cleanup = undefined;
+        }
+    };
+    const stopListening = () => {
+        if (!active)
+            return;
+        active = false;
+        runCleanup();
+        unsubscribe();
+    };
+    const deliver = (batch) => {
+        if (!active)
+            return;
+        runCleanup();
+        const next = source;
+        callback({
+            patches: batch.patches,
+            version: batch.version,
+            newValue: next,
+        });
+        if (once)
+            stopListening();
+    };
+    const unsubscribe = (0, deepSignal_1.subscribeDeepMutations)(rootId, (batch) => {
+        if (!batch.patches.length)
+            return;
+        deliver(batch);
+    }, options.triggerInstantly);
+    if (immediate) {
+        deliver({
+            patches: [],
+            version: (0, deepSignal_1.getDeepSignalVersion)(rootId) ?? 0,
+        });
+    }
+    return {
+        stopListening,
+        registerCleanup,
+    };
+}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@ng-org/alien-deepsignals",
+  "version": "0.1.2-alpha.1",
+  "private": false,
+  "authors": [
+    "Laurin Weger",
+    "CCherry07"
+  ],
+  "license": "MIT/Apache-2.0",
+  "files": [
+    "dist"
+  ],
+  "main": "dist/index.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "NextGraph adaptation of AlienDeepSignals - alien signals, but using regular JavaScript objects",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/hooks/react/index.d.ts",
+      "default": "./dist/hooks/react/index.js"
+    },
+    "./svelte": {
+      "types": "./dist/hooks/svelte/index.d.ts",
+      "default": "./dist/hooks/svelte/index.js"
+    },
+    "./vue": {
+      "types": "./dist/hooks/vue/index.d.ts",
+      "default": "./dist/hooks/vue/index.js"
+    }
+  },
+  "dependencies": {
+    "alien-signals": "^2.0.7"
+  },
+  "optionalDependencies": {
+    "react": "^19.0.0 || ^18.0.0",
+    "svelte": "^5.0.0",
+    "vue": "^3.0.0"
+  },
+  "devDependencies": {
+    "@astrojs/react": "^4.4.2",
+    "@astrojs/svelte": "^7.2.2",
+    "@astrojs/vue": "^5.1.3",
+    "@sveltejs/vite-plugin-svelte": "^6.2.1",
+    "@types/node": "^22.10.9",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.2",
+    "@vitest/coverage-v8": "3.2.4",
+    "astro": "^5.16.1",
+    "@playwright/test": "^1.55.0",
+    "react-dom": "^19.0.0",
+    "react": "^19.0.0",
+    "svelte": "^5.1.9",
+    "typescript": "^5.4.3",
+    "vue": "^3.5.11",
+    "vitest": "^3.0.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://git.nextgraph.org/NextGraph/nextgraph-rs"
+  },
+  "keywords": [
+    "signal",
+    "signals",
+    "deepsignals",
+    "alien-signals",
+    "alien-deepsignals"
+  ],
+  "bugs": {
+    "url": "https://git.nextgraph.org/NextGraph/nextgraph-rs/issues"
+  },
+  "homepage": "https://nextgraph.org",
+  "scripts": {
+    "test": "vitest --coverage --dir src/test/lib",
+    "test:frontend": "playwright test src/test/frontend",
+    "build:ts": "tsc"
+  },
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts"
+}