@ng-org/orm 0.1.2-alpha.2 → 0.1.2-alpha.4

package/dist/frontendAdapters/react/useShape.d.ts

@@ -1,6 +1,13 @@
 import type { BaseType } from "@ng-org/shex-orm";
 import type { ShapeType } from "@ng-org/shex-orm";
 import type { Scope } from "../../types.ts";
-declare const useShape: <T extends BaseType>(shape: ShapeType<T>, scope?: Scope) => import("@ng-org/alien-deepsignals").DeepSignalSet<T>;
+/**
+ *
+ * @param shape The shape type
+ * @param scope The document scope (IRI of named graph)
+ * @returns A deep signal set with the orm objects, an empty set if still loading,
+ *          or an empty set which errors on modifications if scope is undefined.
+ */
+declare const useShape: <T extends BaseType>(shape: ShapeType<T>, scope?: Scope | undefined) => import("@ng-org/alien-deepsignals").DeepSignalSet<unknown> | import("@ng-org/alien-deepsignals").DeepSignalSet<T>;
 export default useShape;
 //# sourceMappingURL=useShape.d.ts.map

package/dist/frontendAdapters/react/useShape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useShape.d.ts","sourceRoot":"","sources":["../../../src/frontendAdapters/react/useShape.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,QAAA,MAAM,QAAQ,GAAI,CAAC,SAAS,QAAQ,EAChC,OAAO,SAAS,CAAC,CAAC,CAAC,EACnB,QAAO,KAAU,yDAcpB,CAAC;AAEF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"useShape.d.ts","sourceRoot":"","sources":["../../../src/frontendAdapters/react/useShape.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;;GAMG;AACH,QAAA,MAAM,QAAQ,GAAI,CAAC,SAAS,QAAQ,EAChC,OAAO,SAAS,CAAC,CAAC,CAAC,EACnB,QAAO,KAAK,GAAG,SAAc,sHAqBhC,CAAC;AAiBF,eAAe,QAAQ,CAAC"}

package/dist/frontendAdapters/react/useShape.js

@@ -8,17 +8,41 @@
 // according to those terms.
 // SPDX-License-Identifier: Apache-2.0 OR MIT
 import { useDeepSignal } from "@ng-org/alien-deepsignals/react";
-import { useEffect, useRef } from "react";
+import { useEffect, useMemo } from "react";
 import { createSignalObjectForShape } from "../../connector/createSignalObjectForShape.js";
+/**
+ *
+ * @param shape The shape type
+ * @param scope The document scope (IRI of named graph)
+ * @returns A deep signal set with the orm objects, an empty set if still loading,
+ *          or an empty set which errors on modifications if scope is undefined.
+ */
 const useShape = (shape, scope = "") => {
-    const handleRef = useRef(createSignalObjectForShape(shape, scope));
-    const handle = handleRef.current;
-    const state = useDeepSignal(handle.signalObject);
+    const signalHandler = useMemo(() => scope === undefined
+        ? undefined
+        : createSignalObjectForShape(shape, scope), [shape, scope]);
     useEffect(() => {
+        if (!signalHandler)
+            return;
         return () => {
-            handleRef.current.stop();
+            signalHandler.stop();
         };
-    }, [shape, scope]);
+    }, [signalHandler]);
+    const state = useDeepSignal(signalHandler?.signalObject ?? readOnlySet);
     return state;
 };
+const readOnlySet = new Proxy(new Set(), {
+    get(target, key, receiver) {
+        if (key === "add" || key === "delete" || key === "clear") {
+            return () => {
+                throw new Error("Set is readonly because scope is empty.");
+            };
+        }
+        const value = target[key];
+        if (typeof value === "function") {
+            return value.bind(target);
+        }
+        return value;
+    },
+});
 export default useShape;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ng-org/orm",
-  "version": "0.1.2-alpha.2",
+  "version": "0.1.2-alpha.4",
   "private": false,
   "type": "module",
   "authors": [
@@ -49,8 +49,8 @@
     "react-dom": "19.1.1",
     "svelte": "5.39.12",
     "vue": "3.5.19",
-    "@ng-org/shex-orm": "0.1.2-alpha.1",
-    "@ng-org/alien-deepsignals": "0.1.2-alpha.1"
+    "@ng-org/shex-orm": "0.1.2-alpha.2",
+    "@ng-org/alien-deepsignals": "0.1.2-alpha.3"
   },
   "devDependencies": {
     "@playwright/test": "^1.55.0",
@@ -60,7 +60,7 @@
     "vite": "7.1.3",
     "vitest": "^3.2.4",
     "typescript": "^5.3.0",
-    "@ng-org/lib-wasm": "0.1.2"
+    "@ng-org/lib-wasm": "0.1.2-alpha.1"
   },
   "files": [
     "dist"