informa 1.0.0

package/dist/quirks/set.js

@@ -0,0 +1,37 @@
+import { exitProxySymbol, setMetadataOf, statifySealKey } from "../internals.js";
+import { StateMetadata } from "../low.js";
+export class StatifiedSet extends Set {
+    [statifySealKey] = true;
+    #metadata;
+    constructor(args) {
+        super(args);
+        this.#metadata = setMetadataOf(this, new StateMetadata());
+    }
+    add(value) {
+        if (!super.has(value)) {
+            super.add(value);
+            this.#metadata.emit("addItem", value);
+            this.#metadata.emit("sizeChanged");
+        }
+        return this;
+    }
+    clear() {
+        const oldValues = [...this.values()];
+        super.clear();
+        for (const value of oldValues) {
+            this.#metadata.emit("deleteItem", value);
+        }
+        if (oldValues.length > 0) {
+            this.#metadata.emit("sizeChanged");
+        }
+    }
+    delete(value) {
+        if (super.delete(value)) {
+            this.#metadata.emit("deleteItem", value);
+            this.#metadata.emit("sizeChanged");
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=set.js.map

package/dist/quirks/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../src/quirks/set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAgB,MAAM,iBAAiB,CAAC;AAC/F,OAAO,EAAE,aAAa,EAA6C,MAAM,WAAW,CAAC;AAErF,MAAM,OAAO,YAAwC,SAAQ,GAAM;IACjE,CAAC,cAAc,CAAC,GAAS,IAAI,CAAC;IAG9B,SAAS,CAAgB;IAEzB,YAAY,IAAyB;QACnC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEZ,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,aAAa,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,GAAG,CAAC,KAAQ;QACV,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACjB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACtC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAErC,KAAK,CAAC,KAAK,EAAE,CAAC;QAEd,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,MAAM,CAAC,KAAQ;QACb,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YACzC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test.d.ts.map

package/dist/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":""}

package/dist/test.js

@@ -0,0 +1,37 @@
+import $ from "./high.js";
+import { BaseStatified } from "./quirks/basestatified.js";
+import { StatifiedSet } from "./quirks/set.js";
+const stateful = $.state({ a: [] });
+$.onSpliceInElement(() => stateful.a, (v) => {
+    console.log("pushed", v);
+    $.onSet(() => v.d, (newValue) => {
+        console.log("New value is", newValue);
+    });
+});
+$.onSet(() => stateful.b?.c?.d, (newValue) => {
+    console.log("New value of .b.c.d is", newValue);
+});
+const b = $.state({ d: 3 });
+stateful.a.push(b);
+b.d = 10;
+const asdf = $.state({ d: new Set() });
+const asdf2 = $.state({ c: asdf });
+// const aassddff = $.state(new Set());
+stateful.b = asdf2;
+class Wayland extends BaseStatified {
+    displays = new StatifiedSet();
+    #state = 0;
+    get state() { return this.#state; }
+    set state(v) {
+        console.log("set", v);
+        this.#state = v;
+        super.state = v;
+    }
+    constructor() {
+        super();
+    }
+}
+const w = new Wayland();
+$.onSet(() => w.state, (v) => console.log("asdf awawa!!", v));
+w.state = 5;
+//# sourceMappingURL=test.js.map

package/dist/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,WAAW,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAA4D,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AAE/F,CAAC,CAAC,iBAAiB,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;IAC1C,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAEzB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE;QAC9B,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE;IAC3C,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC5B,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEnB,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AAET,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,IAAI,GAAG,EAAU,EAAE,CAAC,CAAC;AAC/C,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AAEnC,uCAAuC;AACvC,QAAQ,CAAC,CAAC,GAAG,KAAK,CAAC;AAEnB,MAAM,OAAQ,SAAQ,aAAa;IACjC,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IAE9B,MAAM,GAAG,CAAC,CAAC;IACX,IAAI,KAAK,KAAK,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,CAAS;QACjB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QACrB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;IAClB,CAAC;IAED;QACE,KAAK,EAAE,CAAC;IACV,CAAC;CACF;AAED,MAAM,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC;AACxB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;AAE9D,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,5 @@
+export declare function ofWhichIsProto<T extends object, U extends symbol>(target: object, expect: Map<T, U>): U | undefined;
+export declare const isSetProto: unique symbol;
+export declare const supportedQuirks: Map<Set<any>, typeof isSetProto>;
+export declare function isListInGrid<T>(grid: T[][], list: T[]): boolean;
+//# 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":"AAAA,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAanH;AAED,eAAO,MAAM,UAAU,eAAW,CAAC;AACnC,eAAO,MAAM,eAAe,kCAEjB,CAAC;AAGZ,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,CAAC,EAAE,EAAE,EACX,IAAI,EAAE,CAAC,EAAE,WAOV"}

package/dist/utils.js

@@ -0,0 +1,23 @@
+export function ofWhichIsProto(target, expect) {
+    let current = Reflect.getPrototypeOf(target);
+    while (current) {
+        const correspondingSymbol = expect.get(current);
+        if (correspondingSymbol) {
+            return correspondingSymbol;
+        }
+        current = Reflect.getPrototypeOf(current);
+    }
+    return undefined;
+}
+export const isSetProto = Symbol();
+export const supportedQuirks = new Map([
+    [Set.prototype, isSetProto]
+]);
+export function isListInGrid(grid, list) {
+    return grid.some((row) => {
+        if (row.length !== list.length)
+            return false;
+        return row.every((v, i) => v === list[i]);
+    });
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAqC,MAAc,EAAE,MAAiB;IAClG,IAAI,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAE7C,OAAO,OAAO,EAAE,CAAC;QACf,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,OAAY,CAAC,CAAC;QACrD,IAAI,mBAAmB,EAAE,CAAC;YACxB,OAAO,mBAAmB,CAAC;QAC7B,CAAC;QAED,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IACrC,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC;CACnB,CAAC,CAAC;AAGZ,MAAM,UAAU,YAAY,CAC1B,IAAW,EACX,IAAS;IAET,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QACvB,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAE7C,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "informa",
+  "version": "1.0.0",
+  "description": "Informa's State Management",
+  "keywords": [
+    "state management",
+    "proxy"
+  ],
+  "homepage": "https://github.com/immjs/informa#readme",
+  "bugs": {
+    "url": "https://github.com/immjs/informa/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/immjs/informa.git"
+  },
+  "license": "ISC",
+  "author": "Juliette Wang <immjs>",
+  "type": "module",
+  "main": "dist/high.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.1",
+    "typescript": "^7.0.2"
+  }
+}

package/src/EnumerableWeakMap.ts

@@ -0,0 +1,63 @@
+export class EnumerableWeakMap<K extends WeakKey, V> implements WeakMap<K, V>, Iterable<[K, V]> {
+  #map = new WeakMap<K, V>();
+
+  #refs: WeakRef<K>[] = [];
+
+  constructor(iterable: Iterable<[K, V]> | null = null) {
+    if (iterable) for (const [key, value] of iterable) this.set(key, value);
+  }
+
+  get [Symbol.toStringTag]() {
+    return "WeakerableMapByWebReflection";
+  }
+
+  get(key: K) {
+    return this.#map.get(key);
+  }
+
+  getOrInsert(key: K, defaultValue: V): V {
+    if (this.#map.has(key)) {
+      return this.#map.get(key)!;
+    }
+    this.#map.set(key, defaultValue);
+    this.#refs.push(new WeakRef(key));
+    return defaultValue;
+  }
+
+  getOrInsertComputed(key: K, callback: (k: K) => V): V {
+    if (this.#map.has(key)) {
+      return this.#map.get(key)!;
+    }
+    const value = callback(key);
+    this.#map.set(key, value);
+    this.#refs.push(new WeakRef(key));
+    return value;
+  }
+
+  set(key: K, value: V): this {
+    if (!this.#map.has(key)) this.#refs.push(new WeakRef(key));
+    this.#map.set(key, value);
+
+    return this;
+  }
+
+  delete(value: K) {
+    return this.#map.delete(value);
+  }
+
+  has(value: K) {
+    return this.#map.has(value);
+  }
+
+  *[Symbol.iterator]() {
+    const map = this.#map, refs = [];
+    for (const wr of this.#refs) {
+      const key = wr.deref();
+      if (key && map.has(key)) {
+        refs.push(wr);
+        yield [key, map.get(key)!] satisfies [K, V];
+      }
+    }
+    this.#refs = refs;
+  }
+}

package/src/high.ts

@@ -0,0 +1,163 @@
+import { getMetadataOf, isStatified, proxyMemoized, type Statify } from "./internals.js";
+import { hook, selectorToRootAndPath, statifyObject, type StatifiableObj, type StatifiableProp, type Statified } from "./low.js";
+import { StatifiedArray } from "./quirks/array.js";
+import { StatifiedSet } from "./quirks/set.js";
+
+export function stateInner<T extends StatifiableProp>(original: T): Statified<T> {
+  if (typeof original !== 'object' || original === null) {
+    return original as Statified<T>;
+  }
+
+  if (proxyMemoized.has(original)) return proxyMemoized.get(original) as Statified<T>;
+
+  const unmemoed = (() => {
+    switch (Reflect.getPrototypeOf(original)) {
+      case Set.prototype:
+        const set = original as unknown as Set<any>;
+        return new StatifiedSet(set[Symbol.iterator]().map(stateInner));
+
+      case Array.prototype:
+        const array = original as unknown as any[];
+        return new StatifiedArray(...array.map(stateInner));
+
+      case StatifiedArray.prototype:
+      case StatifiedSet.prototype:
+        return original as StatifiedArray<StatifiableProp> | StatifiedSet<StatifiableProp>;
+
+      case Object.prototype:
+        const newObj = original as unknown as Record<string | symbol, any>;
+        const entries = Object.entries(newObj)
+          .map(([k, v]) => [k, stateInner(v)]);
+        const result = statifyObject(Object.fromEntries(entries));
+
+        entries.forEach(([k, v]) => isStatified(v) && hook(getMetadataOf(result), k, getMetadataOf(v)))
+
+        return result;
+    }
+
+    if (Array.isArray(original)) {
+      return new StatifiedArray(...original.map(stateInner));
+    }
+
+    throw new Error(`Cannot clone object with prototype`);
+  })();
+
+  proxyMemoized.set(original, unmemoed);
+
+  return unmemoed as Statified<T>;
+}
+
+export function state<T extends StatifiableObj>(original: T): Statified<T> {
+  return stateInner<T>(original);
+}
+
+interface Options {
+}
+
+interface Listeners<T> {
+  set?(v: T): void;
+  replace?(v: T): void;
+}
+
+interface ObjectListeners<K extends string | number | symbol, V> extends Listeners<Record<K, V>> {
+  setProp?(v: V, i: string | symbol): void;
+  replaceProp?(v: V, i: string | symbol): void;
+  deleteProp?(v: V, i: string | symbol): void;
+}
+
+interface ArrayListeners<T> extends ObjectListeners<number, T> {
+  spliceInElement?(v: T, i: number): void;
+  spliceOutElement?(v: T, i: number): void;
+  replaceElement?(v: T, i: number): void;
+  lengthChanged?(): void;
+}
+
+interface SetListeners<T> extends ObjectListeners<keyof Set<T>, Set<T>[keyof Set<T>]> {
+  addItem?(v: T): void;
+  deleteItem?(v: T): void;
+  sizeChanged?(): void;
+}
+
+export function on<T, K extends string | number | symbol, V, U>(
+  ...[selector, listeners, options]:
+    [() => T, Listeners<T>]
+    | [() => T, Listeners<T>, Options | undefined]
+    | [() => Statify<Record<K, V>>, ObjectListeners<K, V>]
+    | [() => Statify<Record<K, V>>, ObjectListeners<K, V>, Options | undefined]
+    | [() => Statify<U[]>, ArrayListeners<U>]
+    | [() => Statify<U[]>, ArrayListeners<U>, Options | undefined]
+    | [() => Statify<Set<U>>, SetListeners<U>]
+    | [() => Statify<Set<U>>, SetListeners<U>, Options | undefined]
+): () => void {
+  const { path, stateRoot } = selectorToRootAndPath(selector as () => Statify<StatifiableObj>);
+
+  const metadata = getMetadataOf(stateRoot);
+
+  const eventEmitter = metadata.eventEmitterAtPath(path);
+
+  for (const [key, value] of Object.entries(listeners)) {
+    eventEmitter.on(key, value);
+  }
+
+  return () => {
+    for (const [key, value] of Object.entries(listeners)) {
+      eventEmitter.off(key, value);
+    }
+  }
+}
+
+function onSet<T>(s: () => T, l: (v: T) => void, o?: Options) {
+  // TODO Handle `once` option
+  return on(s, { set: l }, o);
+}
+function onReplace<T>(s: () => T, l: (v: T) => void, o?: Options) {
+  return on(s, { replace: l }, o);
+}
+
+function onReplaceProp<T extends Record<string | number | symbol, StatifiableProp>>(s: () => Statify<T>, l: (v: T[keyof T], k: keyof T) => void, o?: Options) {
+  return on(s, { replaceProp: l }, o);
+}
+function onDeleteProp<T extends Record<string | number | symbol, StatifiableProp>>(s: () => Statify<T>, l: (v: T[keyof T], k: keyof T) => void, o?: Options) {
+  return on(s, { deleteProp: l }, o);
+}
+function onSetProp<T extends Record<string | number | symbol, StatifiableProp>>(s: () => Statify<T>, l: (v: T[keyof T], k: keyof T) => void, o?: Options) {
+  return on(s, { setProp: l }, o);
+}
+function onLengthChanged(s: () => Statify<StatifiableObj[]>, l: () => void, o?: Options) {
+  return on(s, { lengthChanged: l }, o);
+}
+function onSpliceInElement<T extends StatifiableObj>(s: () => Statify<T[]>, l: (v: T, k: number) => void, o?: Options) {
+  return on(s, { spliceInElement: l }, o);
+}
+function onSpliceOutElement<T extends StatifiableObj>(s: () => Statify<T[]>, l: (v: T, k: number) => void, o?: Options) {
+  return on(s, { spliceOutElement: l }, o);
+}
+function onReplaceElement<T extends StatifiableObj>(s: () => Statify<T[]>, l: (v: T, k: number) => void, o?: Options) {
+  return on(s, { replaceElement: l }, o);
+}
+function onSizeChanged<T extends StatifiableObj>(s: () => Statify<Set<T>>, l: () => void, o?: Options) {
+  return on(s, { sizeChanged: l }, o);
+}
+function onAddItem<T extends StatifiableObj>(s: () => Statify<Set<T>>, l: (v: T) => void, o?: Options) {
+  return on(s, { addItem: l }, o);
+}
+function onDeleteItem<T extends StatifiableObj>(s: () => Statify<Set<T>>, l: (v: T) => void, o?: Options) {
+  return on(s, { deleteItem: l }, o);
+}
+
+export default {
+  on,
+  onSet,
+  onReplace,
+  onReplaceProp,
+  onDeleteProp,
+  onSetProp,
+  onLengthChanged,
+  onSpliceInElement,
+  onSpliceOutElement,
+  onReplaceElement,
+  onSizeChanged,
+  onAddItem,
+  onDeleteItem,
+  state,
+};

package/src/internals.ts

@@ -0,0 +1,32 @@
+import type { StateMetadata, Exitable, StatifiableObj } from "./low.js";
+
+export const exitProxySymbol = Symbol();
+
+// The mode is used by the functions exposed by informa,
+// no concurrency issues arise because of the unique call stack.
+export let globalStateMode: "normal" | "extract-proxy-path" = "normal";
+export function setGlobalStateMode(mode: "normal" | "extract-proxy-path") {
+  globalStateMode = mode;
+}
+
+export const metadataMap = new WeakMap<Statify<StatifiableObj>, StateMetadata>();
+export function getMetadataOf(v: Statify<StatifiableObj>) {
+  const result = metadataMap.get(v);
+
+  if (!result) throw new Error("Assertion failed: Metadata should have been created alongside statified object");
+
+  return result;
+}
+export function setMetadataOf(v: Statify<StatifiableObj>, s: StateMetadata) {
+  metadataMap.set(v, s);
+
+  return s;
+}
+
+export const proxyMemoized = new WeakMap<object, Statify<StatifiableObj>>();
+
+export const statifySealKey = Symbol();
+export function isStatified<T extends StatifiableObj>(v: T): v is Statify<T> {
+  return (v as Statify<T>)[statifySealKey];
+}
+export type Statify<T extends StatifiableObj> = T & { [statifySealKey]: true } & Exitable;