epos-unit 1.15.0 → 1.17.0

package/dist/epos-unit.d.ts

@@ -7,7 +7,7 @@ declare const _parent_: unique symbol;
 declare const _attached_: unique symbol;
 declare const _disposers_: unique symbol;
 declare const _ancestors_: unique symbol;
-declare const _pendingAttachFns_: unique symbol;
+declare const _pendingAttachHooks_: unique symbol;
 type Node<T> = Unit<T> | Obj | Arr;
 declare class Unit<TRoot = unknown> {
     /**
@@ -19,6 +19,7 @@ declare class Unit<TRoot = unknown> {
      */
     [epos.state.DETACH]: () => void;
     '@': string;
+    id: string;
     log: ReturnType<typeof createLog>;
     [':version']?: number;
     [_root_]?: TRoot;
@@ -26,18 +27,13 @@ declare class Unit<TRoot = unknown> {
     [_attached_]?: boolean;
     [_disposers_]?: Set<() => void>;
     [_ancestors_]?: Map<Cls, unknown>;
-    [_pendingAttachFns_]?: (() => void)[];
+    [_pendingAttachHooks_]?: (() => void)[];
     constructor(parent: Unit<TRoot> | null);
     /**
      * Gets the root unit of the current unit's tree.
      * The result is cached for subsequent calls.
      */
     get $(): TRoot | (undefined & TRoot);
-    /**
-     * Finds the closest ancestor unit of a given type.
-     * The result is cached for subsequent calls.
-     */
-    closest<T extends Unit>(Ancestor: Cls<T>): T | null;
     /**
      * A wrapper around MobX's `autorun` that automatically disposes
      * the reaction when the unit is detached.
@@ -62,6 +58,11 @@ declare class Unit<TRoot = unknown> {
      * Creates an error for an unreachable code path.
      */
     never(message?: string): Error;
+    /**
+     * Finds the closest ancestor unit of a given type.
+     * The result is cached for subsequent calls.
+     */
+    closest<T extends Unit>(Ancestor: Cls<T>): T | null;
 }
 
-export { type Node, Unit, _ancestors_, _attached_, _disposers_, _parent_, _pendingAttachFns_, _root_ };
+export { type Node, Unit, _ancestors_, _attached_, _disposers_, _parent_, _pendingAttachHooks_, _root_ };

package/dist/epos-unit.js

@@ -1,26 +1,32 @@
 // src/epos-unit.ts
 import { createLog, is } from "dropcap/utils";
 import "epos";
+import { customAlphabet } from "nanoid";
 var _root_ = /* @__PURE__ */ Symbol("root");
 var _parent_ = /* @__PURE__ */ Symbol("parent");
 var _attached_ = /* @__PURE__ */ Symbol("attached");
 var _disposers_ = /* @__PURE__ */ Symbol("disposers");
 var _ancestors_ = /* @__PURE__ */ Symbol("ancestors");
-var _pendingAttachFns_ = /* @__PURE__ */ Symbol("pendingAttachFns");
+var _pendingAttachHooks_ = /* @__PURE__ */ Symbol("pendingAttachHooks");
+var nanoid = customAlphabet("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", 8);
 var Unit = class {
   constructor(parent) {
+    this.id = nanoid();
     this[_parent_] = parent;
-    const versions = getVersions(this);
+    const versioner = getVersioner(this);
+    const versions = getVersions(versioner);
     if (versions.length > 0) this[":version"] = versions.at(-1);
   }
+  // ---------------------------------------------------------------------------
+  // ATTACH / DETACH
+  // ---------------------------------------------------------------------------
   /**
    * Lifecycle method called when the unit is attached to the state tree.
    */
   [epos.state.ATTACH]() {
-    setProperty(this, "log", createLog(this["@"]));
     epos.state.transaction(() => {
       const versioner = getVersioner(this);
-      const versions = getVersions(this);
+      const versions = getVersions(versioner);
       for (const version of versions) {
         if (is.number(this[":version"]) && this[":version"] >= version) continue;
         const versionFn = versioner[version];
@@ -29,40 +35,61 @@ var Unit = class {
         this[":version"] = version;
       }
     });
+    let log = createLog(this["@"]);
+    Reflect.defineProperty(this, "log", {
+      configurable: true,
+      get: () => log,
+      set: (v) => log = v
+    });
+    const stateDescriptor = Reflect.getOwnPropertyDescriptor(this.constructor.prototype, "state");
+    if (stateDescriptor && stateDescriptor.get) {
+      const value = stateDescriptor.get.call(this);
+      const state = epos.state.local(value, { deep: false });
+      Reflect.defineProperty(this, "state", { get: () => state });
+    }
     for (const prototype of getPrototypes(this)) {
       const descriptors = Object.getOwnPropertyDescriptors(prototype);
       for (const [key, descriptor] of Object.entries(descriptors)) {
         if (key === "constructor") continue;
         if (this.hasOwnProperty(key)) continue;
-        if (descriptor.get || descriptor.set) continue;
-        if (!is.function(descriptor.value)) continue;
-        const fn = descriptor.value.bind(this);
-        if (key.endsWith("View")) {
-          let Component = epos.component(fn);
+        if (is.function(descriptor.value) && key.endsWith("View")) {
+          let Component = epos.component(descriptor.value.bind(this));
           Component.displayName = `${this.constructor.name}.${key}`;
-          setProperty(this, key, Component);
-        } else {
-          setProperty(this, key, fn);
+          Reflect.defineProperty(this, key, {
+            configurable: true,
+            get: () => Component,
+            set: (v) => Component = v
+          });
+        } else if (is.function(descriptor.value)) {
+          let method = descriptor.value.bind(this);
+          Reflect.defineProperty(this, key, {
+            configurable: true,
+            get: () => method,
+            set: (v) => method = v
+          });
+        } else if (descriptor.get) {
+          const getter = descriptor.get;
+          const computed = epos.libs.mobx.computed(() => getter.call(this));
+          Reflect.defineProperty(this, key, {
+            configurable: true,
+            get: () => computed.get(),
+            set: descriptor.set
+          });
         }
       }
     }
-    const stateDescriptor = Reflect.getOwnPropertyDescriptor(this.constructor.prototype, "state");
-    if (stateDescriptor && stateDescriptor.get) {
-      const state = stateDescriptor.get.call(this);
-      setProperty(this, "state", epos.libs.mobx.observable.object(state, {}, { deep: false }));
-    }
     const attach = Reflect.get(this, "attach");
     if (is.function(attach)) {
       const unattachedRoot = findUnattachedRoot(this);
       if (!unattachedRoot) throw this.never();
-      ensureProperty(unattachedRoot, _pendingAttachFns_, () => []);
-      unattachedRoot[_pendingAttachFns_].push(() => attach());
-      if (this[_pendingAttachFns_]) {
-        this[_pendingAttachFns_].forEach((attach2) => attach2());
-        delete this[_pendingAttachFns_];
-      }
+      ensure(unattachedRoot, _pendingAttachHooks_, () => []);
+      unattachedRoot[_pendingAttachHooks_].push(() => attach());
+    }
+    if (this[_pendingAttachHooks_]) {
+      this[_pendingAttachHooks_].forEach((attach2) => attach2());
+      delete this[_pendingAttachHooks_];
     }
-    setProperty(this, _attached_, true);
+    Reflect.defineProperty(this, _attached_, { configurable: true, get: () => true });
   }
   /**
    * Lifecycle method called when the unit is detached from the state tree.
@@ -72,45 +99,33 @@ var Unit = class {
       this[_disposers_].forEach((disposer) => disposer());
       this[_disposers_].clear();
     }
+    if (this[_ancestors_]) {
+      this[_ancestors_].clear();
+    }
     const detach = Reflect.get(this, "detach");
     if (is.function(detach)) detach();
-    delete this[_root_];
-    delete this[_attached_];
-    delete this[_ancestors_];
-    delete this[_disposers_];
   }
+  // ---------------------------------------------------------------------------
+  // ROOT GETTER
+  // ---------------------------------------------------------------------------
   /**
    * Gets the root unit of the current unit's tree.
    * The result is cached for subsequent calls.
    */
   get $() {
-    ensureProperty(this, _root_, () => findRoot(this));
+    ensure(this, _root_, () => findRoot(this));
     return this[_root_];
   }
-  /**
-   * Finds the closest ancestor unit of a given type.
-   * The result is cached for subsequent calls.
-   */
-  closest(Ancestor) {
-    ensureProperty(this, _ancestors_, () => /* @__PURE__ */ new Map());
-    if (this[_ancestors_].has(Ancestor)) return this[_ancestors_].get(Ancestor);
-    let cursor = this;
-    while (cursor) {
-      if (cursor instanceof Ancestor) {
-        this[_ancestors_].set(Ancestor, cursor);
-        return cursor;
-      }
-      cursor = getParent(cursor);
-    }
-    return null;
-  }
+  // ---------------------------------------------------------------------------
+  // METHODS
+  // ---------------------------------------------------------------------------
   /**
    * A wrapper around MobX's `autorun` that automatically disposes
    * the reaction when the unit is detached.
    */
   autorun(...args) {
     const disposer = epos.libs.mobx.autorun(...args);
-    ensureProperty(this, _disposers_, () => /* @__PURE__ */ new Set());
+    ensure(this, _disposers_, () => /* @__PURE__ */ new Set());
     this[_disposers_].add(disposer);
     return disposer;
   }
@@ -120,7 +135,7 @@ var Unit = class {
    */
   reaction(...args) {
     const disposer = epos.libs.mobx.reaction(...args);
-    ensureProperty(this, _disposers_, () => /* @__PURE__ */ new Set());
+    ensure(this, _disposers_, () => /* @__PURE__ */ new Set());
     this[_disposers_].add(disposer);
     return disposer;
   }
@@ -130,7 +145,7 @@ var Unit = class {
    */
   setTimeout(...args) {
     const id = self.setTimeout(...args);
-    ensureProperty(this, _disposers_, () => /* @__PURE__ */ new Set());
+    ensure(this, _disposers_, () => /* @__PURE__ */ new Set());
     this[_disposers_].add(() => self.clearTimeout(id));
     return id;
   }
@@ -140,7 +155,7 @@ var Unit = class {
    */
   setInterval(...args) {
     const id = self.setInterval(...args);
-    ensureProperty(this, _disposers_, () => /* @__PURE__ */ new Set());
+    ensure(this, _disposers_, () => /* @__PURE__ */ new Set());
     this[_disposers_].add(() => self.clearInterval(id));
     return id;
   }
@@ -153,15 +168,25 @@ var Unit = class {
     Error.captureStackTrace(error, this.never);
     return error;
   }
+  /**
+   * Finds the closest ancestor unit of a given type.
+   * The result is cached for subsequent calls.
+   */
+  closest(Ancestor) {
+    ensure(this, _ancestors_, () => /* @__PURE__ */ new Map());
+    if (this[_ancestors_].has(Ancestor)) return this[_ancestors_].get(Ancestor);
+    let cursor = this;
+    while (cursor) {
+      if (cursor instanceof Ancestor) {
+        this[_ancestors_].set(Ancestor, cursor);
+        return cursor;
+      }
+      cursor = getParent(cursor);
+    }
+    return null;
+  }
 };
-function setProperty(object, key, value) {
-  Reflect.defineProperty(object, key, {
-    configurable: true,
-    get: () => value,
-    set: (v) => value = v
-  });
-}
-function ensureProperty(object, key, getInitialValue) {
+function ensure(object, key, getInitialValue) {
   if (key in object) return;
   const value = getInitialValue();
   Reflect.defineProperty(object, key, { configurable: true, get: () => value });
@@ -198,8 +223,7 @@ function getVersioner(unit) {
   if (!is.object(versioner)) return {};
   return versioner;
 }
-function getVersions(unit) {
-  const versioner = getVersioner(unit);
+function getVersions(versioner) {
   const numericKeys = Object.keys(versioner).filter((key) => is.numeric(key));
   return numericKeys.map(Number).sort((v1, v2) => v1 - v2);
 }
@@ -209,7 +233,7 @@ export {
   _attached_,
   _disposers_,
   _parent_,
-  _pendingAttachFns_,
+  _pendingAttachHooks_,
   _root_
 };
 //# sourceMappingURL=epos-unit.js.map

package/dist/epos-unit.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/epos-unit.ts"],"sourcesContent":["import type { Arr, Cls, Obj } from 'dropcap/types'\nimport { createLog, is } from 'dropcap/utils'\nimport 'epos'\n\nexport const _root_ = Symbol('root')\nexport const _parent_ = Symbol('parent')\nexport const _attached_ = Symbol('attached')\nexport const _disposers_ = Symbol('disposers')\nexport const _ancestors_ = Symbol('ancestors')\nexport const _pendingAttachFns_ = Symbol('pendingAttachFns')\n\nexport type Node<T> = Unit<T> | Obj | Arr\n\nexport class Unit<TRoot = unknown> {\n  declare '@': string\n  declare log: ReturnType<typeof createLog>;\n  declare [':version']?: number;\n  declare [_root_]?: TRoot;\n  declare [_parent_]?: Unit<TRoot> | null; // Parent reference for a not-yet-attached units\n  declare [_attached_]?: boolean;\n  declare [_disposers_]?: Set<() => void>;\n  declare [_ancestors_]?: Map<Cls, unknown>;\n  declare [_pendingAttachFns_]?: (() => void)[]\n\n  constructor(parent: Unit<TRoot> | null) {\n    this[_parent_] = parent\n    const versions = getVersions(this)\n    if (versions.length > 0) this[':version'] = versions.at(-1)!\n  }\n\n  /**\n   * Lifecycle method called when the unit is attached to the state tree.\n   */\n  [epos.state.ATTACH]() {\n    // Setup logger\n    setProperty(this, 'log', createLog(this['@']))\n\n    // Apply versioner\n    epos.state.transaction(() => {\n      const versioner = getVersioner(this)\n      const versions = getVersions(this)\n      for (const version of versions) {\n        if (is.number(this[':version']) && this[':version'] >= version) continue\n        const versionFn = versioner[version]\n        if (!is.function(versionFn)) continue\n        versionFn.call(this, this)\n        this[':version'] = version\n      }\n    })\n\n    // Prepare methods:\n    // - Create components for methods ending with `View`\n    // - Bind all other methods to the unit instance\n    for (const prototype of getPrototypes(this)) {\n      const descriptors = Object.getOwnPropertyDescriptors(prototype)\n\n      for (const [key, descriptor] of Object.entries(descriptors)) {\n        if (key === 'constructor') continue\n        if (this.hasOwnProperty(key)) continue\n\n        if (descriptor.get || descriptor.set) continue\n        if (!is.function(descriptor.value)) continue\n        const fn = descriptor.value.bind(this)\n\n        if (key.endsWith('View')) {\n          let Component = epos.component(fn)\n          Component.displayName = `${this.constructor.name}.${key}`\n          setProperty(this, key, Component)\n        } else {\n          setProperty(this, key, fn)\n        }\n      }\n    }\n\n    // Setup state\n    const stateDescriptor = Reflect.getOwnPropertyDescriptor(this.constructor.prototype, 'state')\n    if (stateDescriptor && stateDescriptor.get) {\n      const state = stateDescriptor.get.call(this)\n      setProperty(this, 'state', epos.libs.mobx.observable.object(state, {}, { deep: false }))\n    }\n\n    // Process attach queue.\n    // We do not execute `attach` methods immediately, but rather queue them\n    // on the highest unattached ancestor. This way we ensure that `attach`\n    // methods are called after all versioners have been applied in the entire subtree.\n    const attach = Reflect.get(this, 'attach')\n    if (is.function(attach)) {\n      const unattachedRoot = findUnattachedRoot(this)\n      if (!unattachedRoot) throw this.never()\n\n      ensureProperty(unattachedRoot, _pendingAttachFns_, () => [])\n      unattachedRoot[_pendingAttachFns_].push(() => attach())\n\n      if (this[_pendingAttachFns_]) {\n        this[_pendingAttachFns_].forEach(attach => attach())\n        delete this[_pendingAttachFns_]\n      }\n    }\n\n    // Mark as attached\n    setProperty(this, _attached_, true)\n  }\n\n  /**\n   * Lifecycle method called when the unit is detached from the state tree.\n   */\n  [epos.state.DETACH]() {\n    // 1. Run disposers\n    if (this[_disposers_]) {\n      this[_disposers_].forEach(disposer => disposer())\n      this[_disposers_].clear()\n    }\n\n    // 2. Call detach method\n    const detach = Reflect.get(this, 'detach')\n    if (is.function(detach)) detach()\n\n    // 3. Clean up internal properties\n    delete this[_root_]\n    delete this[_attached_]\n    delete this[_ancestors_]\n    delete this[_disposers_]\n  }\n\n  /**\n   * Gets the root unit of the current unit's tree.\n   * The result is cached for subsequent calls.\n   */\n  get $() {\n    ensureProperty(this, _root_, () => findRoot(this))\n    return this[_root_]\n  }\n\n  /**\n   * Finds the closest ancestor unit of a given type.\n   * The result is cached for subsequent calls.\n   */\n  closest<T extends Unit>(Ancestor: Cls<T>) {\n    // Has cached value? -> Return it\n    ensureProperty(this, _ancestors_, () => new Map())\n    if (this[_ancestors_].has(Ancestor)) return this[_ancestors_].get(Ancestor) as T\n\n    // Find the closest ancestor and cache it\n    let cursor: Node<TRoot> | null = this\n    while (cursor) {\n      if (cursor instanceof Ancestor) {\n        this[_ancestors_].set(Ancestor, cursor)\n        return cursor\n      }\n      cursor = getParent(cursor)\n    }\n\n    return null\n  }\n\n  /**\n   * A wrapper around MobX's `autorun` that automatically disposes\n   * the reaction when the unit is detached.\n   */\n  autorun(...args: Parameters<typeof epos.libs.mobx.autorun>) {\n    const disposer = epos.libs.mobx.autorun(...args)\n    ensureProperty(this, _disposers_, () => new Set())\n    this[_disposers_].add(disposer)\n    return disposer\n  }\n\n  /**\n   * A wrapper around MobX's `reaction` that automatically disposes\n   * the reaction when the unit is detached.\n   */\n  reaction(...args: Parameters<typeof epos.libs.mobx.reaction>) {\n    const disposer = epos.libs.mobx.reaction(...args)\n    ensureProperty(this, _disposers_, () => new Set())\n    this[_disposers_].add(disposer)\n    return disposer\n  }\n\n  /**\n   * A wrapper around `setTimeout` that automatically clears the timeout\n   * when the unit is detached.\n   */\n  setTimeout(...args: Parameters<typeof self.setTimeout>) {\n    const id = self.setTimeout(...args)\n    ensureProperty(this, _disposers_, () => new Set())\n    this[_disposers_].add(() => self.clearTimeout(id))\n    return id\n  }\n\n  /**\n   * A wrapper around `setInterval` that automatically clears the interval\n   * when the unit is detached.\n   */\n  setInterval(...args: Parameters<typeof self.setInterval>) {\n    const id = self.setInterval(...args)\n    ensureProperty(this, _disposers_, () => new Set())\n    this[_disposers_].add(() => self.clearInterval(id))\n    return id\n  }\n\n  /**\n   * Creates an error for an unreachable code path.\n   */\n  never(message = 'This should never happen') {\n    const details = message ? `: ${message}` : ''\n    const error = new Error(`[${this.constructor.name}] This should never happen${details}`)\n    Error.captureStackTrace(error, this.never)\n    return error\n  }\n}\n\n// ---------------------------------------------------------------------------\n// HELPERS\n// ---------------------------------------------------------------------------\n\n/**\n * Defines a configurable property on an object.\n */\nfunction setProperty(object: object, key: PropertyKey, value: unknown) {\n  Reflect.defineProperty(object, key, {\n    configurable: true,\n    get: () => value,\n    set: v => (value = v),\n  })\n}\n\n/**\n * Ensures a property exists on an object, initializing it if it doesn't.\n */\nfunction ensureProperty<T extends object, K extends PropertyKey, V>(\n  object: T,\n  key: K,\n  getInitialValue: () => V,\n): asserts object is T & { [key in K]: V } {\n  if (key in object) return\n  const value = getInitialValue()\n  Reflect.defineProperty(object, key, { configurable: true, get: () => value })\n}\n\n/**\n * Gets all prototypes of an object up to `Object.prototype`.\n */\nfunction getPrototypes(object: object): object[] {\n  const prototype = Reflect.getPrototypeOf(object)\n  if (!prototype || prototype === Object.prototype) return []\n  return [prototype, ...getPrototypes(prototype)]\n}\n\n/**\n * Finds the root `Unit` in the hierarchy for a given unit.\n */\nfunction findRoot<T>(unit: Unit<T>) {\n  let root: Unit<T> | null = null\n  let cursor: Node<T> | null = unit\n\n  while (cursor) {\n    if (cursor instanceof Unit) root = cursor\n    cursor = getParent(cursor)\n  }\n\n  return root as T\n}\n\n/**\n * Finds the highest unattached `Unit` in the hierarchy for a given unit.\n */\nfunction findUnattachedRoot<T>(unit: Unit<T>) {\n  let unattachedRoot: Unit<T> | null = null\n  let cursor: Node<T> | null = unit\n\n  while (cursor) {\n    if (cursor instanceof Unit && !cursor[_attached_]) unattachedRoot = cursor\n    cursor = getParent(cursor)\n  }\n\n  return unattachedRoot\n}\n\n/**\n * Gets the parent of a node, which can be a `Unit`, an object, or an array.\n */\nfunction getParent<T>(node: Node<T>) {\n  const parent: Node<T> | null = Reflect.get(node, _parent_) ?? Reflect.get(node, epos.state.PARENT) ?? null\n  return parent\n}\n\n/**\n * Gets the versioner object from a unit's constructor.\n */\nfunction getVersioner<T>(unit: Unit<T>) {\n  const versioner: unknown = Reflect.get(unit.constructor, 'versioner')\n  if (!is.object(versioner)) return {}\n  return versioner\n}\n\n/**\n * Gets a sorted list of numeric version keys from a unit's versioner.\n */\nfunction getVersions<T>(unit: Unit<T>) {\n  const versioner = getVersioner(unit)\n  const numericKeys = Object.keys(versioner).filter(key => is.numeric(key))\n  return numericKeys.map(Number).sort((v1, v2) => v1 - v2)\n}\n"],"mappings":"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","names":["attach"]}
+{"version":3,"sources":["../src/epos-unit.ts"],"sourcesContent":["import type { Arr, Cls, Obj } from 'dropcap/types'\nimport { createLog, is } from 'dropcap/utils'\nimport 'epos'\nimport { customAlphabet } from 'nanoid'\n\nexport const _root_ = Symbol('root')\nexport const _parent_ = Symbol('parent')\nexport const _attached_ = Symbol('attached')\nexport const _disposers_ = Symbol('disposers')\nexport const _ancestors_ = Symbol('ancestors')\nexport const _pendingAttachHooks_ = Symbol('pendingAttachHooks')\nconst nanoid = customAlphabet('abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789', 8)\n\nexport type Node<T> = Unit<T> | Obj | Arr\n\nexport class Unit<TRoot = unknown> {\n  declare '@': string\n  declare id: string\n  declare log: ReturnType<typeof createLog>;\n  declare [':version']?: number;\n  declare [_root_]?: TRoot;\n  declare [_parent_]?: Unit<TRoot> | null; // Parent reference for a not-yet-attached units\n  declare [_attached_]?: boolean;\n  declare [_disposers_]?: Set<() => void>;\n  declare [_ancestors_]?: Map<Cls, unknown>;\n  declare [_pendingAttachHooks_]?: (() => void)[]\n\n  constructor(parent: Unit<TRoot> | null) {\n    this.id = nanoid()\n    this[_parent_] = parent\n    const versioner = getVersioner(this)\n    const versions = getVersions(versioner)\n    if (versions.length > 0) this[':version'] = versions.at(-1)!\n  }\n\n  // ---------------------------------------------------------------------------\n  // ATTACH / DETACH\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Lifecycle method called when the unit is attached to the state tree.\n   */\n  [epos.state.ATTACH]() {\n    // Apply versioner\n    epos.state.transaction(() => {\n      const versioner = getVersioner(this)\n      const versions = getVersions(versioner)\n      for (const version of versions) {\n        if (is.number(this[':version']) && this[':version'] >= version) continue\n        const versionFn = versioner[version]\n        if (!is.function(versionFn)) continue\n        versionFn.call(this, this)\n        this[':version'] = version\n      }\n    })\n\n    // Setup logger\n    let log = createLog(this['@'])\n    Reflect.defineProperty(this, 'log', {\n      configurable: true,\n      get: () => log,\n      set: v => (log = v),\n    })\n\n    // Setup state\n    const stateDescriptor = Reflect.getOwnPropertyDescriptor(this.constructor.prototype, 'state')\n    if (stateDescriptor && stateDescriptor.get) {\n      const value = stateDescriptor.get.call(this)\n      const state = epos.state.local(value, { deep: false })\n      Reflect.defineProperty(this, 'state', { get: () => state })\n    }\n\n    // Prepare properties for the whole prototype chain:\n    // - Create components for methods ending with `View`\n    // - Bind all other methods to the unit instance\n    // - Turn getters into MobX computed properties\n    for (const prototype of getPrototypes(this)) {\n      const descriptors = Object.getOwnPropertyDescriptors(prototype)\n      for (const [key, descriptor] of Object.entries(descriptors)) {\n        // Skip constructor and already defined properties\n        if (key === 'constructor') continue\n        if (this.hasOwnProperty(key)) continue\n\n        // Create components for methods ending with `View`\n        if (is.function(descriptor.value) && key.endsWith('View')) {\n          let Component = epos.component(descriptor.value.bind(this))\n          Component.displayName = `${this.constructor.name}.${key}`\n          Reflect.defineProperty(this, key, {\n            configurable: true,\n            get: () => Component,\n            set: v => (Component = v),\n          })\n        }\n\n        // Bind all other methods to the unit instance\n        else if (is.function(descriptor.value)) {\n          let method = descriptor.value.bind(this)\n          Reflect.defineProperty(this, key, {\n            configurable: true,\n            get: () => method,\n            set: v => (method = v),\n          })\n        }\n\n        // Turn getters into MobX computed properties\n        else if (descriptor.get) {\n          const getter = descriptor.get\n          const computed = epos.libs.mobx.computed(() => getter.call(this))\n          Reflect.defineProperty(this, key, {\n            configurable: true,\n            get: () => computed.get(),\n            set: descriptor.set,\n          })\n        }\n      }\n    }\n\n    // Queue attach hook.\n    // Do not execute `attach` hooks immediately, but rather queue them on the highest unattached ancestor.\n    // This way `attach` hooks are called after all versioners have been applied in the entire subtree.\n    const attach = Reflect.get(this, 'attach')\n    if (is.function(attach)) {\n      const unattachedRoot = findUnattachedRoot(this)\n      if (!unattachedRoot) throw this.never()\n      ensure(unattachedRoot, _pendingAttachHooks_, () => [])\n      unattachedRoot[_pendingAttachHooks_].push(() => attach())\n    }\n\n    // Release attach hooks\n    if (this[_pendingAttachHooks_]) {\n      this[_pendingAttachHooks_].forEach(attach => attach())\n      delete this[_pendingAttachHooks_]\n    }\n\n    // Mark as attached\n    Reflect.defineProperty(this, _attached_, { configurable: true, get: () => true })\n  }\n\n  /**\n   * Lifecycle method called when the unit is detached from the state tree.\n   */\n  [epos.state.DETACH]() {\n    // Run and clear disposers\n    if (this[_disposers_]) {\n      this[_disposers_].forEach(disposer => disposer())\n      this[_disposers_].clear()\n    }\n\n    // Clear ancestors cache\n    if (this[_ancestors_]) {\n      this[_ancestors_].clear()\n    }\n\n    // Call detach method\n    const detach = Reflect.get(this, 'detach')\n    if (is.function(detach)) detach()\n  }\n\n  // ---------------------------------------------------------------------------\n  // ROOT GETTER\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Gets the root unit of the current unit's tree.\n   * The result is cached for subsequent calls.\n   */\n  get $() {\n    ensure(this, _root_, () => findRoot(this))\n    return this[_root_]\n  }\n\n  // ---------------------------------------------------------------------------\n  // METHODS\n  // ---------------------------------------------------------------------------\n\n  /**\n   * A wrapper around MobX's `autorun` that automatically disposes\n   * the reaction when the unit is detached.\n   */\n  autorun(...args: Parameters<typeof epos.libs.mobx.autorun>) {\n    const disposer = epos.libs.mobx.autorun(...args)\n    ensure(this, _disposers_, () => new Set())\n    this[_disposers_].add(disposer)\n    return disposer\n  }\n\n  /**\n   * A wrapper around MobX's `reaction` that automatically disposes\n   * the reaction when the unit is detached.\n   */\n  reaction(...args: Parameters<typeof epos.libs.mobx.reaction>) {\n    const disposer = epos.libs.mobx.reaction(...args)\n    ensure(this, _disposers_, () => new Set())\n    this[_disposers_].add(disposer)\n    return disposer\n  }\n\n  /**\n   * A wrapper around `setTimeout` that automatically clears the timeout\n   * when the unit is detached.\n   */\n  setTimeout(...args: Parameters<typeof self.setTimeout>) {\n    const id = self.setTimeout(...args)\n    ensure(this, _disposers_, () => new Set())\n    this[_disposers_].add(() => self.clearTimeout(id))\n    return id\n  }\n\n  /**\n   * A wrapper around `setInterval` that automatically clears the interval\n   * when the unit is detached.\n   */\n  setInterval(...args: Parameters<typeof self.setInterval>) {\n    const id = self.setInterval(...args)\n    ensure(this, _disposers_, () => new Set())\n    this[_disposers_].add(() => self.clearInterval(id))\n    return id\n  }\n\n  /**\n   * Creates an error for an unreachable code path.\n   */\n  never(message = 'This should never happen') {\n    const details = message ? `: ${message}` : ''\n    const error = new Error(`[${this.constructor.name}] This should never happen${details}`)\n    Error.captureStackTrace(error, this.never)\n    return error\n  }\n\n  /**\n   * Finds the closest ancestor unit of a given type.\n   * The result is cached for subsequent calls.\n   */\n  closest<T extends Unit>(Ancestor: Cls<T>) {\n    // Has cached value? -> Return it\n    ensure(this, _ancestors_, () => new Map())\n    if (this[_ancestors_].has(Ancestor)) return this[_ancestors_].get(Ancestor) as T\n\n    // Find the closest ancestor and cache it\n    let cursor: Node<TRoot> | null = this\n    while (cursor) {\n      if (cursor instanceof Ancestor) {\n        this[_ancestors_].set(Ancestor, cursor)\n        return cursor\n      }\n      cursor = getParent(cursor)\n    }\n\n    return null\n  }\n}\n\n// ---------------------------------------------------------------------------\n// HELPERS\n// ---------------------------------------------------------------------------\n\n/**\n * Ensures a property exists on an object, initializing it if it doesn't.\n */\nfunction ensure<T extends object, K extends PropertyKey, V>(\n  object: T,\n  key: K,\n  getInitialValue: () => V,\n): asserts object is T & { [key in K]: V } {\n  if (key in object) return\n  const value = getInitialValue()\n  Reflect.defineProperty(object, key, { configurable: true, get: () => value })\n}\n\n/**\n * Gets all prototypes of an object up to `Object.prototype`.\n */\nfunction getPrototypes(object: object): object[] {\n  const prototype = Reflect.getPrototypeOf(object)\n  if (!prototype || prototype === Object.prototype) return []\n  return [prototype, ...getPrototypes(prototype)]\n}\n\n/**\n * Finds the root `Unit` in the hierarchy for a given unit.\n */\nfunction findRoot<T>(unit: Unit<T>) {\n  let root: Unit<T> | null = null\n  let cursor: Node<T> | null = unit\n\n  while (cursor) {\n    if (cursor instanceof Unit) root = cursor\n    cursor = getParent(cursor)\n  }\n\n  return root as T\n}\n\n/**\n * Finds the highest unattached `Unit` in the hierarchy for a given unit.\n */\nfunction findUnattachedRoot<T>(unit: Unit<T>) {\n  let unattachedRoot: Unit<T> | null = null\n  let cursor: Node<T> | null = unit\n\n  while (cursor) {\n    if (cursor instanceof Unit && !cursor[_attached_]) unattachedRoot = cursor\n    cursor = getParent(cursor)\n  }\n\n  return unattachedRoot\n}\n\n/**\n * Gets the parent of a node, which can be a `Unit`, an object, or an array.\n */\nfunction getParent<T>(node: Node<T>) {\n  const parent: Node<T> | null = Reflect.get(node, _parent_) ?? Reflect.get(node, epos.state.PARENT) ?? null\n  return parent\n}\n\n/**\n * Gets the versioner object from a unit's constructor.\n */\nfunction getVersioner<T>(unit: Unit<T>) {\n  const versioner: unknown = Reflect.get(unit.constructor, 'versioner')\n  if (!is.object(versioner)) return {}\n  return versioner\n}\n\n/**\n * Gets a sorted list of numeric version keys from a unit's versioner.\n */\nfunction getVersions(versioner: Obj) {\n  const numericKeys = Object.keys(versioner).filter(key => is.numeric(key))\n  return numericKeys.map(Number).sort((v1, v2) => v1 - v2)\n}\n"],"mappings":"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","names":["attach"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "epos-unit",
-  "version": "1.15.0",
+  "version": "1.17.0",
   "type": "module",
   "license": "MIT",
   "author": "imkost",
@@ -21,6 +21,7 @@
   ],
   "dependencies": {
     "dropcap": "^1.4.0",
-    "epos": "^1.32.0"
+    "epos": "^1.32.0",
+    "nanoid": "^3.3.11"
   }
 }

package/src/epos-unit.ts

@@ -1,18 +1,21 @@
 import type { Arr, Cls, Obj } from 'dropcap/types'
 import { createLog, is } from 'dropcap/utils'
 import 'epos'
+import { customAlphabet } from 'nanoid'
 
 export const _root_ = Symbol('root')
 export const _parent_ = Symbol('parent')
 export const _attached_ = Symbol('attached')
 export const _disposers_ = Symbol('disposers')
 export const _ancestors_ = Symbol('ancestors')
-export const _pendingAttachFns_ = Symbol('pendingAttachFns')
+export const _pendingAttachHooks_ = Symbol('pendingAttachHooks')
+const nanoid = customAlphabet('abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789', 8)
 
 export type Node<T> = Unit<T> | Obj | Arr
 
 export class Unit<TRoot = unknown> {
   declare '@': string
+  declare id: string
   declare log: ReturnType<typeof createLog>;
   declare [':version']?: number;
   declare [_root_]?: TRoot;
@@ -20,25 +23,28 @@ export class Unit<TRoot = unknown> {
   declare [_attached_]?: boolean;
   declare [_disposers_]?: Set<() => void>;
   declare [_ancestors_]?: Map<Cls, unknown>;
-  declare [_pendingAttachFns_]?: (() => void)[]
+  declare [_pendingAttachHooks_]?: (() => void)[]
 
   constructor(parent: Unit<TRoot> | null) {
+    this.id = nanoid()
     this[_parent_] = parent
-    const versions = getVersions(this)
+    const versioner = getVersioner(this)
+    const versions = getVersions(versioner)
     if (versions.length > 0) this[':version'] = versions.at(-1)!
   }
 
+  // ---------------------------------------------------------------------------
+  // ATTACH / DETACH
+  // ---------------------------------------------------------------------------
+
   /**
    * Lifecycle method called when the unit is attached to the state tree.
    */
   [epos.state.ATTACH]() {
-    // Setup logger
-    setProperty(this, 'log', createLog(this['@']))
-
     // Apply versioner
     epos.state.transaction(() => {
       const versioner = getVersioner(this)
-      const versions = getVersions(this)
+      const versions = getVersions(versioner)
       for (const version of versions) {
         if (is.number(this[':version']) && this[':version'] >= version) continue
         const versionFn = versioner[version]
@@ -48,110 +54,124 @@ export class Unit<TRoot = unknown> {
       }
     })
 
-    // Prepare methods:
+    // Setup logger
+    let log = createLog(this['@'])
+    Reflect.defineProperty(this, 'log', {
+      configurable: true,
+      get: () => log,
+      set: v => (log = v),
+    })
+
+    // Setup state
+    const stateDescriptor = Reflect.getOwnPropertyDescriptor(this.constructor.prototype, 'state')
+    if (stateDescriptor && stateDescriptor.get) {
+      const value = stateDescriptor.get.call(this)
+      const state = epos.state.local(value, { deep: false })
+      Reflect.defineProperty(this, 'state', { get: () => state })
+    }
+
+    // Prepare properties for the whole prototype chain:
     // - Create components for methods ending with `View`
     // - Bind all other methods to the unit instance
+    // - Turn getters into MobX computed properties
     for (const prototype of getPrototypes(this)) {
       const descriptors = Object.getOwnPropertyDescriptors(prototype)
-
       for (const [key, descriptor] of Object.entries(descriptors)) {
+        // Skip constructor and already defined properties
         if (key === 'constructor') continue
         if (this.hasOwnProperty(key)) continue
 
-        if (descriptor.get || descriptor.set) continue
-        if (!is.function(descriptor.value)) continue
-        const fn = descriptor.value.bind(this)
-
-        if (key.endsWith('View')) {
-          let Component = epos.component(fn)
+        // Create components for methods ending with `View`
+        if (is.function(descriptor.value) && key.endsWith('View')) {
+          let Component = epos.component(descriptor.value.bind(this))
           Component.displayName = `${this.constructor.name}.${key}`
-          setProperty(this, key, Component)
-        } else {
-          setProperty(this, key, fn)
+          Reflect.defineProperty(this, key, {
+            configurable: true,
+            get: () => Component,
+            set: v => (Component = v),
+          })
         }
-      }
-    }
 
-    // Setup state
-    const stateDescriptor = Reflect.getOwnPropertyDescriptor(this.constructor.prototype, 'state')
-    if (stateDescriptor && stateDescriptor.get) {
-      const state = stateDescriptor.get.call(this)
-      setProperty(this, 'state', epos.libs.mobx.observable.object(state, {}, { deep: false }))
+        // Bind all other methods to the unit instance
+        else if (is.function(descriptor.value)) {
+          let method = descriptor.value.bind(this)
+          Reflect.defineProperty(this, key, {
+            configurable: true,
+            get: () => method,
+            set: v => (method = v),
+          })
+        }
+
+        // Turn getters into MobX computed properties
+        else if (descriptor.get) {
+          const getter = descriptor.get
+          const computed = epos.libs.mobx.computed(() => getter.call(this))
+          Reflect.defineProperty(this, key, {
+            configurable: true,
+            get: () => computed.get(),
+            set: descriptor.set,
+          })
+        }
+      }
     }
 
-    // Process attach queue.
-    // We do not execute `attach` methods immediately, but rather queue them
-    // on the highest unattached ancestor. This way we ensure that `attach`
-    // methods are called after all versioners have been applied in the entire subtree.
+    // Queue attach hook.
+    // Do not execute `attach` hooks immediately, but rather queue them on the highest unattached ancestor.
+    // This way `attach` hooks are called after all versioners have been applied in the entire subtree.
     const attach = Reflect.get(this, 'attach')
     if (is.function(attach)) {
       const unattachedRoot = findUnattachedRoot(this)
       if (!unattachedRoot) throw this.never()
+      ensure(unattachedRoot, _pendingAttachHooks_, () => [])
+      unattachedRoot[_pendingAttachHooks_].push(() => attach())
+    }
 
-      ensureProperty(unattachedRoot, _pendingAttachFns_, () => [])
-      unattachedRoot[_pendingAttachFns_].push(() => attach())
-
-      if (this[_pendingAttachFns_]) {
-        this[_pendingAttachFns_].forEach(attach => attach())
-        delete this[_pendingAttachFns_]
-      }
+    // Release attach hooks
+    if (this[_pendingAttachHooks_]) {
+      this[_pendingAttachHooks_].forEach(attach => attach())
+      delete this[_pendingAttachHooks_]
     }
 
     // Mark as attached
-    setProperty(this, _attached_, true)
+    Reflect.defineProperty(this, _attached_, { configurable: true, get: () => true })
   }
 
   /**
    * Lifecycle method called when the unit is detached from the state tree.
    */
   [epos.state.DETACH]() {
-    // 1. Run disposers
+    // Run and clear disposers
     if (this[_disposers_]) {
       this[_disposers_].forEach(disposer => disposer())
       this[_disposers_].clear()
     }
 
-    // 2. Call detach method
+    // Clear ancestors cache
+    if (this[_ancestors_]) {
+      this[_ancestors_].clear()
+    }
+
+    // Call detach method
     const detach = Reflect.get(this, 'detach')
     if (is.function(detach)) detach()
-
-    // 3. Clean up internal properties
-    delete this[_root_]
-    delete this[_attached_]
-    delete this[_ancestors_]
-    delete this[_disposers_]
   }
 
+  // ---------------------------------------------------------------------------
+  // ROOT GETTER
+  // ---------------------------------------------------------------------------
+
   /**
    * Gets the root unit of the current unit's tree.
    * The result is cached for subsequent calls.
    */
   get $() {
-    ensureProperty(this, _root_, () => findRoot(this))
+    ensure(this, _root_, () => findRoot(this))
     return this[_root_]
   }
 
-  /**
-   * Finds the closest ancestor unit of a given type.
-   * The result is cached for subsequent calls.
-   */
-  closest<T extends Unit>(Ancestor: Cls<T>) {
-    // Has cached value? -> Return it
-    ensureProperty(this, _ancestors_, () => new Map())
-    if (this[_ancestors_].has(Ancestor)) return this[_ancestors_].get(Ancestor) as T
-
-    // Find the closest ancestor and cache it
-    let cursor: Node<TRoot> | null = this
-    while (cursor) {
-      if (cursor instanceof Ancestor) {
-        this[_ancestors_].set(Ancestor, cursor)
-        return cursor
-      }
-      cursor = getParent(cursor)
-    }
-
-    return null
-  }
+  // ---------------------------------------------------------------------------
+  // METHODS
+  // ---------------------------------------------------------------------------
 
   /**
    * A wrapper around MobX's `autorun` that automatically disposes
@@ -159,7 +179,7 @@ export class Unit<TRoot = unknown> {
    */
   autorun(...args: Parameters<typeof epos.libs.mobx.autorun>) {
     const disposer = epos.libs.mobx.autorun(...args)
-    ensureProperty(this, _disposers_, () => new Set())
+    ensure(this, _disposers_, () => new Set())
     this[_disposers_].add(disposer)
     return disposer
   }
@@ -170,7 +190,7 @@ export class Unit<TRoot = unknown> {
    */
   reaction(...args: Parameters<typeof epos.libs.mobx.reaction>) {
     const disposer = epos.libs.mobx.reaction(...args)
-    ensureProperty(this, _disposers_, () => new Set())
+    ensure(this, _disposers_, () => new Set())
     this[_disposers_].add(disposer)
     return disposer
   }
@@ -181,7 +201,7 @@ export class Unit<TRoot = unknown> {
    */
   setTimeout(...args: Parameters<typeof self.setTimeout>) {
     const id = self.setTimeout(...args)
-    ensureProperty(this, _disposers_, () => new Set())
+    ensure(this, _disposers_, () => new Set())
     this[_disposers_].add(() => self.clearTimeout(id))
     return id
   }
@@ -192,7 +212,7 @@ export class Unit<TRoot = unknown> {
    */
   setInterval(...args: Parameters<typeof self.setInterval>) {
     const id = self.setInterval(...args)
-    ensureProperty(this, _disposers_, () => new Set())
+    ensure(this, _disposers_, () => new Set())
     this[_disposers_].add(() => self.clearInterval(id))
     return id
   }
@@ -206,27 +226,38 @@ export class Unit<TRoot = unknown> {
     Error.captureStackTrace(error, this.never)
     return error
   }
+
+  /**
+   * Finds the closest ancestor unit of a given type.
+   * The result is cached for subsequent calls.
+   */
+  closest<T extends Unit>(Ancestor: Cls<T>) {
+    // Has cached value? -> Return it
+    ensure(this, _ancestors_, () => new Map())
+    if (this[_ancestors_].has(Ancestor)) return this[_ancestors_].get(Ancestor) as T
+
+    // Find the closest ancestor and cache it
+    let cursor: Node<TRoot> | null = this
+    while (cursor) {
+      if (cursor instanceof Ancestor) {
+        this[_ancestors_].set(Ancestor, cursor)
+        return cursor
+      }
+      cursor = getParent(cursor)
+    }
+
+    return null
+  }
 }
 
 // ---------------------------------------------------------------------------
 // HELPERS
 // ---------------------------------------------------------------------------
 
-/**
- * Defines a configurable property on an object.
- */
-function setProperty(object: object, key: PropertyKey, value: unknown) {
-  Reflect.defineProperty(object, key, {
-    configurable: true,
-    get: () => value,
-    set: v => (value = v),
-  })
-}
-
 /**
  * Ensures a property exists on an object, initializing it if it doesn't.
  */
-function ensureProperty<T extends object, K extends PropertyKey, V>(
+function ensure<T extends object, K extends PropertyKey, V>(
   object: T,
   key: K,
   getInitialValue: () => V,
@@ -295,8 +326,7 @@ function getVersioner<T>(unit: Unit<T>) {
 /**
  * Gets a sorted list of numeric version keys from a unit's versioner.
  */
-function getVersions<T>(unit: Unit<T>) {
-  const versioner = getVersioner(unit)
+function getVersions(versioner: Obj) {
   const numericKeys = Object.keys(versioner).filter(key => is.numeric(key))
   return numericKeys.map(Number).sort((v1, v2) => v1 - v2)
 }