@firsthandjs/deep 0.2.0 → 0.4.0

package/README.md

@@ -9,7 +9,7 @@ signal — the shape Vue calls `reactive()`.
 npm install @firsthandjs/deep
 ```
 
-0.72 kB gzip. It depends on `@firsthandjs/core` and changes nothing about
+0.74 kB gzip. It depends on `@firsthandjs/core` and changes nothing about
 `signal`.
 
 ```ts

package/dist/dev.d.ts

@@ -0,0 +1,5 @@
+/** Records where a nested object sits, on the way out of the parent's trap. */
+export declare function devRemember(parent: object, key: PropertyKey, child: object): void;
+/** Names a version cell after the property it stands for. */
+export declare function devLabelProperty(cell: object, target: object, key: PropertyKey): void;
+//# sourceMappingURL=dev.d.ts.map

package/dist/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAyBA,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMjF;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAQrF"}

package/dist/dev.prod.d.ts

@@ -0,0 +1,4 @@
+/** Production stub for `dev.ts`. Aliased in by the build; see `dev.ts`. */
+export declare function devRemember(_parent: object, _key: PropertyKey, _child: object): void;
+export declare function devLabelProperty(_cell: object, _target: object, _key: PropertyKey): void;
+//# sourceMappingURL=dev.prod.d.ts.map

package/dist/dev.prod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.prod.d.ts","sourceRoot":"","sources":["../src/dev.prod.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAEpF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAExF"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkCA;;;;;;;;GAQG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;AAgK5D;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAStD;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAMlC;AAED,uDAAuD;AACvD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmCA;;;;;;;;GAQG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;AAuK5D;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAStD;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAMlC;AAED,uDAAuD;AACvD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI9C"}

package/dist/index.dev.js

@@ -0,0 +1,157 @@
+// packages/deep/src/index.ts
+import { batch, signal } from "@firsthandjs/core";
+
+// packages/deep/src/dev.ts
+var paths = /* @__PURE__ */ new WeakMap();
+function hook() {
+  const installed = globalThis.__FIRSTHAND_DEVTOOLS__;
+  return installed !== void 0 && installed.attached ? installed : void 0;
+}
+function devRemember(parent, key, child) {
+  if (hook() === void 0 || paths.has(child)) {
+    return;
+  }
+  const prefix = paths.get(parent);
+  paths.set(child, prefix === void 0 ? String(key) : `${prefix}.${String(key)}`);
+}
+function devLabelProperty(cell, target, key) {
+  const prefix = paths.get(target);
+  const name = typeof key === "symbol" ? "keys" : String(key);
+  hook()?.label(cell, "signal", prefix === void 0 ? name : `${prefix}.${name}`);
+}
+
+// packages/deep/src/index.ts
+var RAW = /* @__PURE__ */ Symbol.for("firsthand.deep.raw");
+var proxies = /* @__PURE__ */ new WeakMap();
+var versions = /* @__PURE__ */ new WeakMap();
+var KEYS = /* @__PURE__ */ Symbol.for("firsthand.deep.keys");
+function versionOf(target, key) {
+  let table = versions.get(target);
+  if (table === void 0) {
+    table = /* @__PURE__ */ new Map();
+    versions.set(target, table);
+  }
+  let cell = table.get(key);
+  if (cell === void 0) {
+    cell = signal(0);
+    devLabelProperty(cell, target, key);
+    table.set(key, cell);
+  }
+  return cell;
+}
+function track(target, key) {
+  versionOf(target, key).value;
+}
+function trigger(target, key) {
+  const cell = versions.get(target)?.get(key);
+  if (cell !== void 0) {
+    cell.value++;
+  }
+}
+function reactiveKind(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  if (Array.isArray(value)) {
+    return true;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+var MUTATORS = /* @__PURE__ */ new Set([
+  "push",
+  "pop",
+  "shift",
+  "unshift",
+  "splice",
+  "sort",
+  "reverse",
+  "fill",
+  "copyWithin"
+]);
+var handler = {
+  get(target, key, receiver) {
+    if (key === RAW) {
+      return target;
+    }
+    const value = Reflect.get(target, key, receiver);
+    if (typeof key === "symbol") {
+      return value;
+    }
+    if (Array.isArray(target) && typeof value === "function" && MUTATORS.has(key)) {
+      return function mutate(...args) {
+        return batch(() => value.apply(receiver, args));
+      };
+    }
+    track(target, key);
+    if (!reactiveKind(value)) {
+      return value;
+    }
+    devRemember(target, key, value);
+    return deepSignal(value);
+  },
+  set(target, key, next, receiver) {
+    const array = Array.isArray(target);
+    const had = Object.prototype.hasOwnProperty.call(target, key);
+    const previous = Reflect.get(target, key, receiver);
+    const lengthBefore = array ? target.length : 0;
+    const value = raw(next);
+    if (!Reflect.set(target, key, value, receiver)) {
+      return false;
+    }
+    if (!had) {
+      trigger(target, KEYS);
+      trigger(target, key);
+    } else if (!Object.is(previous, value)) {
+      trigger(target, key);
+    }
+    if (array && key !== "length" && target.length !== lengthBefore) {
+      trigger(target, "length");
+    }
+    return true;
+  },
+  deleteProperty(target, key) {
+    const had = Object.prototype.hasOwnProperty.call(target, key);
+    const deleted = Reflect.deleteProperty(target, key);
+    if (deleted && had) {
+      trigger(target, key);
+      trigger(target, KEYS);
+    }
+    return deleted;
+  },
+  has(target, key) {
+    if (typeof key !== "symbol") {
+      track(target, key);
+    }
+    return Reflect.has(target, key);
+  },
+  ownKeys(target) {
+    track(target, Array.isArray(target) ? "length" : KEYS);
+    return Reflect.ownKeys(target);
+  }
+};
+function deepSignal(value) {
+  const target = raw(value);
+  const existing = proxies.get(target);
+  if (existing !== void 0) {
+    return existing;
+  }
+  const created = new Proxy(target, handler);
+  proxies.set(target, created);
+  return created;
+}
+function raw(value) {
+  if (typeof value !== "object" || value === null) {
+    return value;
+  }
+  const inner = value[RAW];
+  return inner === void 0 ? value : inner;
+}
+function isDeep(value) {
+  return typeof value === "object" && value !== null && value[RAW] !== void 0;
+}
+export {
+  deepSignal,
+  isDeep,
+  raw
+};

package/dist/index.js

@@ -1 +1 @@
-import{batch as b,signal as h}from"@firsthandjs/core";var p=Symbol.for("firsthand.deep.raw"),y=new WeakMap,f=new WeakMap,u=Symbol.for("firsthand.deep.keys");function j(n,e){let t=f.get(n);t===void 0&&(t=new Map,f.set(n,t));let o=t.get(e);return o===void 0&&(o=h(0),t.set(e,o)),o}function c(n,e){j(n,e).value}function r(n,e){let t=f.get(n)?.get(e);t!==void 0&&t.value++}function A(n){if(typeof n!="object"||n===null)return!1;if(Array.isArray(n))return!0;let e=Object.getPrototypeOf(n);return e===Object.prototype||e===null}var P=new Set(["push","pop","shift","unshift","splice","sort","reverse","fill","copyWithin"]),m={get(n,e,t){if(e===p)return n;let o=Reflect.get(n,e,t);return typeof e=="symbol"?o:Array.isArray(n)&&typeof o=="function"&&P.has(e)?function(...i){return b(()=>o.apply(t,i))}:(c(n,e),A(o)?R(o):o)},set(n,e,t,o){let s=Array.isArray(n),i=Object.prototype.hasOwnProperty.call(n,e),a=Reflect.get(n,e,o),w=s?n.length:0,l=d(t);return Reflect.set(n,e,l,o)?(i?Object.is(a,l)||r(n,e):(r(n,u),r(n,e)),s&&e!=="length"&&n.length!==w&&r(n,"length"),!0):!1},deleteProperty(n,e){let t=Object.prototype.hasOwnProperty.call(n,e),o=Reflect.deleteProperty(n,e);return o&&t&&(r(n,e),r(n,u)),o},has(n,e){return typeof e!="symbol"&&c(n,e),Reflect.has(n,e)},ownKeys(n){return c(n,Array.isArray(n)?"length":u),Reflect.ownKeys(n)}};function R(n){let e=d(n),t=y.get(e);if(t!==void 0)return t;let o=new Proxy(e,m);return y.set(e,o),o}function d(n){if(typeof n!="object"||n===null)return n;let e=n[p];return e===void 0?n:e}function O(n){return typeof n=="object"&&n!==null&&n[p]!==void 0}export{R as deepSignal,O as isDeep,d as raw};
+import{batch as w,signal as h}from"@firsthandjs/core";var p=Symbol.for("firsthand.deep.raw"),y=new WeakMap,f=new WeakMap,c=Symbol.for("firsthand.deep.keys");function j(e,n){let t=f.get(e);t===void 0&&(t=new Map,f.set(e,t));let o=t.get(n);return o===void 0&&(o=h(0),t.set(n,o)),o}function u(e,n){j(e,n).value}function r(e,n){let t=f.get(e)?.get(n);t!==void 0&&t.value++}function m(e){if(typeof e!="object"||e===null)return!1;if(Array.isArray(e))return!0;let n=Object.getPrototypeOf(e);return n===Object.prototype||n===null}var P=new Set(["push","pop","shift","unshift","splice","sort","reverse","fill","copyWithin"]),R={get(e,n,t){if(n===p)return e;let o=Reflect.get(e,n,t);return typeof n=="symbol"?o:Array.isArray(e)&&typeof o=="function"&&P.has(n)?function(...s){return w(()=>o.apply(t,s))}:(u(e,n),m(o)?A(o):o)},set(e,n,t,o){let i=Array.isArray(e),s=Object.prototype.hasOwnProperty.call(e,n),b=Reflect.get(e,n,o),a=i?e.length:0,l=d(t);return Reflect.set(e,n,l,o)?(s?Object.is(b,l)||r(e,n):(r(e,c),r(e,n)),i&&n!=="length"&&e.length!==a&&r(e,"length"),!0):!1},deleteProperty(e,n){let t=Object.prototype.hasOwnProperty.call(e,n),o=Reflect.deleteProperty(e,n);return o&&t&&(r(e,n),r(e,c)),o},has(e,n){return typeof n!="symbol"&&u(e,n),Reflect.has(e,n)},ownKeys(e){return u(e,Array.isArray(e)?"length":c),Reflect.ownKeys(e)}};function A(e){let n=d(e),t=y.get(n);if(t!==void 0)return t;let o=new Proxy(n,R);return y.set(n,o),o}function d(e){if(typeof e!="object"||e===null)return e;let n=e[p];return n===void 0?e:n}function v(e){return typeof e=="object"&&e!==null&&e[p]!==void 0}export{A as deepSignal,v as isDeep,d as raw};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firsthandjs/deep",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Deep reactivity for Firsthand: a proxy where every property, at any depth, is a signal.",
   "license": "MIT",
   "type": "module",
@@ -8,6 +8,7 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "development": "./dist/index.dev.js",
       "default": "./dist/index.js"
     }
   },
@@ -19,7 +20,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@firsthandjs/core": "0.2.0"
+    "@firsthandjs/core": "0.4.0"
   },
   "engines": {
     "node": ">=20.11.0"