@spearwolf/shadow-objects 0.32.0 → 0.33.0

package/src/view/ShadowEnv.js

@@ -46,12 +46,18 @@ var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read fr
 var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
 var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
-var _proxyReady_dec, _viewReady_dec, _comCtx, _shaObjEnvProxy, _syncScheduled, _syncAfterContextCreated, _syncWaitForConfirmation, _afterNextSync, _init, _viewReady, _proxyReady, _isDestroyed, _syncIfScheduled, _ShadowEnv_instances, syncNow_fn, onMessageToView_fn;
+var _proxyReady_dec, _viewReady_dec, _comCtx, _shaObjEnvProxy, _syncScheduled, _syncAfterContextCreated, _syncWaitForConfirmation, _afterNextSync, _init, _viewReady, _proxyReady, _isDestroyed, _whenDestroyed, _rejectWhenDestroyed, _ShadowEnv_instances, destroyedSignal_fn, _syncIfScheduled, syncNow_fn, onMessageToView_fn, onProxyFailed_fn;
 import { emit, off, on, onceAsync, Priority, retain, retainClear } from "@spearwolf/eventize";
 import { createEffect, createSignal, destroyObjectSignals, findObjectSignalByName } from "@spearwolf/signalize";
 import { signal } from "@spearwolf/signalize/decorators";
 import { ConsoleLogger } from "../utils/ConsoleLogger.js";
 import { ComponentContext } from "./ComponentContext.js";
+class ShadowEnvDestroyedError extends Error {
+  constructor(message = "the shadow environment has been destroyed") {
+    super(message);
+    this.name = "ShadowEnvDestroyedError";
+  }
+}
 _viewReady_dec = [signal()], _proxyReady_dec = [signal()];
 const _ShadowEnv = class _ShadowEnv {
   constructor() {
@@ -67,8 +73,17 @@ const _ShadowEnv = class _ShadowEnv {
     __privateAdd(this, _viewReady, __runInitializers(_init, 8, this, false)), __runInitializers(_init, 11, this);
     __privateAdd(this, _proxyReady, __runInitializers(_init, 12, this, false)), __runInitializers(_init, 15, this);
     __privateAdd(this, _isDestroyed, false);
+    __privateAdd(this, _whenDestroyed);
+    __privateAdd(this, _rejectWhenDestroyed);
+    /**
+     * Resolves once the environment is ready.
+     *
+     * @throws {ShadowEnvDestroyedError} if the environment is destroyed before that happens
+     */
     this.ready = async () => {
-      return this.isReady ? this : onceAsync(this, _ShadowEnv.ContextCreated);
+      if (__privateGet(this, _isDestroyed)) throw new ShadowEnvDestroyedError();
+      if (this.isReady) return this;
+      return Promise.race([onceAsync(this, _ShadowEnv.ContextCreated), __privateMethod(this, _ShadowEnv_instances, destroyedSignal_fn).call(this)]);
     };
     __privateAdd(this, _syncIfScheduled, () => {
       if (__privateGet(this, _syncScheduled)) {
@@ -106,11 +121,11 @@ const _ShadowEnv = class _ShadowEnv {
   }
   set view(ctx) {
     if (ctx !== __privateGet(this, _comCtx)) {
-      if (__privateGet(this, _comCtx) && __privateGet(this, _comCtx).ns && globalThis.__shadowEnvs) {
+      if (__privateGet(this, _comCtx)?.ns && globalThis.__shadowEnvs) {
         globalThis.__shadowEnvs.delete(__privateGet(this, _comCtx).ns);
       }
       __privateSet(this, _comCtx, ctx ?? void 0);
-      if (__privateGet(this, _comCtx) && __privateGet(this, _comCtx).ns) {
+      if (__privateGet(this, _comCtx)?.ns) {
         globalThis.__shadowEnvs ??= /* @__PURE__ */ new Map();
         if (globalThis.__shadowEnvs.has(__privateGet(this, _comCtx).ns) && globalThis.__shadowEnvs.get(__privateGet(this, _comCtx).ns) !== this) {
           if (this.logger.isWarn) {
@@ -135,6 +150,7 @@ const _ShadowEnv = class _ShadowEnv {
       __privateSet(this, _shaObjEnvProxy, proxy ?? void 0);
       if (__privateGet(this, _shaObjEnvProxy)) {
         __privateGet(this, _shaObjEnvProxy).onMessageToView = __privateMethod(this, _ShadowEnv_instances, onMessageToView_fn).bind(this);
+        __privateGet(this, _shaObjEnvProxy).onProxyFailed = __privateMethod(this, _ShadowEnv_instances, onProxyFailed_fn).bind(this);
       }
       if (prevProxy) {
         prevProxy.destroy();
@@ -152,6 +168,7 @@ const _ShadowEnv = class _ShadowEnv {
     return Boolean(__privateGet(this, _comCtx) && __privateGet(this, _shaObjEnvProxy) && this.proxyReady && !this.isDestroyed);
   }
   sync() {
+    if (__privateGet(this, _isDestroyed)) return;
     if (!this.isReady) {
       __privateSet(this, _syncAfterContextCreated, true);
       return;
@@ -160,31 +177,55 @@ const _ShadowEnv = class _ShadowEnv {
     __privateSet(this, _syncScheduled, true);
     queueMicrotask(__privateGet(this, _syncIfScheduled));
   }
+  /**
+   * Like {@link ShadowEnv.sync}, but resolves with the change trail once the cycle completed.
+   *
+   * @throws {ShadowEnvDestroyedError} if the environment is destroyed before that happens
+   */
   syncWait() {
+    if (__privateGet(this, _isDestroyed)) return Promise.reject(new ShadowEnvDestroyedError());
     __privateSet(this, _syncWaitForConfirmation, true);
     this.sync();
     if (__privateGet(this, _afterNextSync)) return __privateGet(this, _afterNextSync);
-    __privateSet(this, _afterNextSync, onceAsync(this, _ShadowEnv.AfterSync).then((changeTrail) => {
-      __privateSet(this, _afterNextSync, void 0);
-      return changeTrail;
-    }));
+    __privateSet(this, _afterNextSync, Promise.race([
+      onceAsync(this, _ShadowEnv.AfterSync),
+      __privateMethod(this, _ShadowEnv_instances, destroyedSignal_fn).call(this)
+    ]).then(
+      (changeTrail) => {
+        __privateSet(this, _afterNextSync, void 0);
+        return changeTrail;
+      },
+      (error) => {
+        __privateSet(this, _afterNextSync, void 0);
+        throw error;
+      }
+    ));
     return __privateGet(this, _afterNextSync);
   }
+  /**
+   * Tear the environment down: the proxy is destroyed, the namespace is released, all signals
+   * and listeners are removed, and every caller still waiting on {@link ShadowEnv.ready} or
+   * {@link ShadowEnv.syncWait} is rejected with a {@link ShadowEnvDestroyedError} instead of
+   * being left pending forever. Calling it more than once is a no-op.
+   */
   destroy() {
+    var _a;
+    if (__privateGet(this, _isDestroyed)) return;
+    __privateSet(this, _isDestroyed, true);
+    __privateSet(this, _syncScheduled, false);
+    __privateSet(this, _syncAfterContextCreated, false);
+    __privateSet(this, _syncWaitForConfirmation, false);
     const ns = __privateGet(this, _comCtx)?.ns;
-    this.envProxy?.destroy();
     this.envProxy = void 0;
     this.view = void 0;
-    if (ns) {
-      if (globalThis.__shadowEnvs.has(ns)) {
-        if (globalThis.__shadowEnvs.get(ns) === this) {
-          globalThis.__shadowEnvs.delete(ns);
-        }
-      }
+    const shadowEnvs = globalThis.__shadowEnvs;
+    if (ns && shadowEnvs?.get(ns) === this) {
+      shadowEnvs.delete(ns);
     }
+    (_a = __privateGet(this, _rejectWhenDestroyed)) == null ? void 0 : _a.call(this, new ShadowEnvDestroyedError());
+    __privateSet(this, _afterNextSync, void 0);
     destroyObjectSignals(this);
     off(this);
-    __privateSet(this, _isDestroyed, true);
     Object.freeze(this);
   }
 };
@@ -198,23 +239,45 @@ _afterNextSync = new WeakMap();
 _viewReady = new WeakMap();
 _proxyReady = new WeakMap();
 _isDestroyed = new WeakMap();
-_syncIfScheduled = new WeakMap();
+_whenDestroyed = new WeakMap();
+_rejectWhenDestroyed = new WeakMap();
 _ShadowEnv_instances = new WeakSet();
+/**
+ * A promise that rejects the moment this environment is destroyed.
+ *
+ * Every promise the public API hands out races against it. Without that race a caller
+ * would wait forever, because {@link ShadowEnv.destroy} tears down the very listeners
+ * those promises are built on.
+ */
+destroyedSignal_fn = function() {
+  if (__privateGet(this, _whenDestroyed) == null) {
+    __privateSet(this, _whenDestroyed, new Promise((_, reject) => {
+      __privateSet(this, _rejectWhenDestroyed, reject);
+    }));
+    __privateGet(this, _whenDestroyed).catch(() => {
+    });
+  }
+  return __privateGet(this, _whenDestroyed);
+};
+_syncIfScheduled = new WeakMap();
 syncNow_fn = async function() {
   __privateSet(this, _syncScheduled, false);
-  if (this.isReady) {
-    const data = this.view.buildChangeTrails();
+  if (__privateGet(this, _isDestroyed)) return;
+  if (!this.isReady) {
+    __privateSet(this, _syncAfterContextCreated, true);
+    return;
+  }
+  const data = this.view.buildChangeTrails();
+  const waitForConfirmation = __privateGet(this, _syncWaitForConfirmation);
+  __privateSet(this, _syncWaitForConfirmation, false);
+  try {
     if (data.length > 0) {
-      try {
-        const waitForConfirmation = __privateGet(this, _syncWaitForConfirmation);
-        __privateSet(this, _syncWaitForConfirmation, false);
-        await this.envProxy.applyChangeTrail(data, waitForConfirmation);
-      } catch (error) {
-        this.logger.error("failed to apply change trail", error);
-      } finally {
-        emit(this, _ShadowEnv.AfterSync, data);
-      }
+      await this.envProxy.applyChangeTrail(data, waitForConfirmation);
     }
+  } catch (error) {
+    this.logger.error("failed to apply change trail", error);
+  } finally {
+    emit(this, _ShadowEnv.AfterSync, data);
   }
 };
 onMessageToView_fn = function(event) {
@@ -223,14 +286,25 @@ onMessageToView_fn = function(event) {
   }
   this.view?.dispatchMessage(event.uuid, event.type, event.data, event.traverseChildren);
 };
+onProxyFailed_fn = function(reason) {
+  if (__privateGet(this, _isDestroyed)) return;
+  this.logger.error("the environment proxy failed", reason);
+  try {
+    emit(this, _ShadowEnv.ProxyFailed, reason, this);
+  } finally {
+    this.proxyReady = false;
+  }
+};
 __decorateElement(_init, 4, "viewReady", _viewReady_dec, _ShadowEnv, _viewReady);
 __decorateElement(_init, 4, "proxyReady", _proxyReady_dec, _ShadowEnv, _proxyReady);
 __decoratorMetadata(_init, _ShadowEnv);
 _ShadowEnv.AfterSync = "afterSync";
 _ShadowEnv.ContextLost = "contextLost";
 _ShadowEnv.ContextCreated = "contextCreated";
+_ShadowEnv.ProxyFailed = "proxyFailed";
 let ShadowEnv = _ShadowEnv;
 export {
-  ShadowEnv
+  ShadowEnv,
+  ShadowEnvDestroyedError
 };
 //# sourceMappingURL=ShadowEnv.js.map

package/src/view/ShadowEnv.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/view/ShadowEnv.ts"],
-  "sourcesContent": ["import {emit, off, on, onceAsync, Priority, retain, retainClear} from '@spearwolf/eventize';\nimport {createEffect, createSignal, destroyObjectSignals, findObjectSignalByName} from '@spearwolf/signalize';\nimport {signal} from '@spearwolf/signalize/decorators';\nimport type {MessageToViewEvent} from '../shadow-objects.js';\nimport type {ChangeTrailType, NamespaceType} from '../types.js';\nimport {ConsoleLogger} from '../utils/ConsoleLogger.js';\nimport {ComponentContext} from './ComponentContext.js';\nimport type {IShadowObjectEnvProxy} from './IShadowObjectEnvProxy.js';\n\ndeclare global {\n  // eslint-disable-next-line no-var\n  var __shadowEnvs: Map<NamespaceType, ShadowEnv> | undefined;\n}\n\nexport class ShadowEnv {\n  static AfterSync = 'afterSync';\n  static ContextLost = 'contextLost';\n  static ContextCreated = 'contextCreated';\n\n  static get(ns: NamespaceType): ShadowEnv | undefined {\n    if (ns == null) return undefined;\n    return globalThis.__shadowEnvs?.get(ns);\n  }\n\n  #comCtx?: ComponentContext;\n  #shaObjEnvProxy?: IShadowObjectEnvProxy;\n  #syncScheduled = false;\n  #syncAfterContextCreated = false;\n  #syncWaitForConfirmation = false;\n  #afterNextSync?: Promise<ChangeTrailType>;\n\n  readonly logger = new ConsoleLogger('ShadowEnv');\n\n  readonly ns$ = createSignal<NamespaceType | undefined>();\n\n  @signal() accessor viewReady = false;\n  @signal() accessor proxyReady = false;\n\n  #isDestroyed = false;\n\n  get isDestroyed() {\n    return this.#isDestroyed;\n  }\n\n  constructor() {\n    const self = this as ShadowEnv;\n    retain(self, ShadowEnv.ContextCreated);\n\n    on(self, ShadowEnv.ContextLost, Priority.AAA, () => {\n      retainClear(self, ShadowEnv.ContextCreated);\n    });\n\n    createEffect(() => {\n      if (this.viewReady && this.proxyReady) {\n        this.view!.reCreateChanges();\n        emit(self, ShadowEnv.ContextCreated, self);\n        if (this.#syncAfterContextCreated) {\n          this.#syncAfterContextCreated = false;\n          this.#syncNow();\n        }\n        return () => {\n          emit(self, ShadowEnv.ContextLost, self);\n        };\n      }\n    }, [findObjectSignalByName(this, 'viewReady'), findObjectSignalByName(this, 'proxyReady')]);\n  }\n\n  get view(): ComponentContext | undefined {\n    return this.#comCtx;\n  }\n\n  set view(ctx: ComponentContext | null | undefined) {\n    if (ctx !== this.#comCtx) {\n      if (this.#comCtx && this.#comCtx.ns && globalThis.__shadowEnvs) {\n        globalThis.__shadowEnvs.delete(this.#comCtx.ns);\n      }\n\n      this.#comCtx = ctx ?? undefined;\n\n      if (this.#comCtx && this.#comCtx.ns) {\n        globalThis.__shadowEnvs ??= new Map();\n        if (globalThis.__shadowEnvs.has(this.#comCtx.ns) && globalThis.__shadowEnvs.get(this.#comCtx.ns) !== this) {\n          if (this.logger.isWarn) {\n            this.logger.warn(\n              'overwrite a namespace already in use',\n              this.#comCtx.ns,\n              globalThis.__shadowEnvs.get(this.#comCtx.ns),\n            );\n          }\n        }\n        globalThis.__shadowEnvs.set(this.#comCtx.ns, this);\n      }\n\n      this.viewReady = Boolean(ctx);\n    }\n  }\n\n  get envProxy(): IShadowObjectEnvProxy | undefined {\n    return this.#shaObjEnvProxy;\n  }\n\n  set envProxy(proxy: IShadowObjectEnvProxy | null | undefined) {\n    if (proxy !== this.#shaObjEnvProxy) {\n      const prevProxy = this.#shaObjEnvProxy;\n      this.#shaObjEnvProxy = proxy ?? undefined;\n\n      if (this.#shaObjEnvProxy) {\n        this.#shaObjEnvProxy.onMessageToView = this.#onMessageToView.bind(this);\n      }\n\n      if (prevProxy) {\n        prevProxy.destroy();\n      }\n\n      this.proxyReady = false;\n\n      proxy\n        ?.start()\n        .then(() => {\n          this.proxyReady = true;\n        })\n        .catch((error) => {\n          this.logger.error('failed to start envProxy', error);\n          this.proxyReady = false;\n        });\n    }\n  }\n\n  get isReady(): boolean {\n    return Boolean(this.#comCtx && this.#shaObjEnvProxy && this.proxyReady && !this.isDestroyed);\n  }\n\n  readonly ready = async (): Promise<ShadowEnv> => {\n    return this.isReady ? this : onceAsync(this as ShadowEnv, ShadowEnv.ContextCreated);\n  };\n\n  sync(): void {\n    if (!this.isReady) {\n      this.#syncAfterContextCreated = true;\n      return;\n    }\n    if (this.#syncScheduled) return;\n    this.#syncScheduled = true;\n    queueMicrotask(this.#syncIfScheduled);\n  }\n\n  syncWait(): Promise<ChangeTrailType> {\n    this.#syncWaitForConfirmation = true;\n    this.sync();\n    if (this.#afterNextSync) return this.#afterNextSync;\n    this.#afterNextSync = onceAsync<ChangeTrailType>(this as ShadowEnv, ShadowEnv.AfterSync).then((changeTrail) => {\n      this.#afterNextSync = undefined;\n      return changeTrail;\n    });\n    return this.#afterNextSync;\n  }\n\n  destroy() {\n    const ns = this.#comCtx?.ns;\n\n    this.envProxy?.destroy();\n    this.envProxy = undefined;\n    this.view = undefined;\n\n    if (ns) {\n      if (globalThis.__shadowEnvs.has(ns)) {\n        if (globalThis.__shadowEnvs.get(ns) === this) {\n          globalThis.__shadowEnvs.delete(ns);\n        }\n      }\n    }\n\n    destroyObjectSignals(this);\n    off(this);\n\n    this.#isDestroyed = true;\n    Object.freeze(this);\n  }\n\n  #syncIfScheduled = () => {\n    if (this.#syncScheduled) {\n      this.#syncNow();\n    }\n  };\n\n  async #syncNow() {\n    this.#syncScheduled = false;\n    if (this.isReady) {\n      const data = this.view!.buildChangeTrails();\n      if (data.length > 0) {\n        try {\n          const waitForConfirmation = this.#syncWaitForConfirmation;\n          this.#syncWaitForConfirmation = false;\n          await this.envProxy!.applyChangeTrail(data, waitForConfirmation);\n        } catch (error) {\n          this.logger.error('failed to apply change trail', error);\n        } finally {\n          emit(this as ShadowEnv, ShadowEnv.AfterSync, data);\n        }\n      }\n    }\n  }\n\n  #onMessageToView(event: Omit<MessageToViewEvent, 'transferables'>) {\n    if (this.logger.isDebug) {\n      this.logger.debug('onMessageToView', event.type, event.data);\n    }\n    this.view?.dispatchMessage(event.uuid, event.type, event.data, event.traverseChildren);\n  }\n}"],
-  "mappings": "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",
+  "sourcesContent": ["import {emit, off, on, onceAsync, Priority, retain, retainClear} from '@spearwolf/eventize';\nimport {createEffect, createSignal, destroyObjectSignals, findObjectSignalByName} from '@spearwolf/signalize';\nimport {signal} from '@spearwolf/signalize/decorators';\nimport type {MessageToViewEvent} from '../shadow-objects.js';\nimport type {ChangeTrailType, NamespaceType} from '../types.js';\nimport {ConsoleLogger} from '../utils/ConsoleLogger.js';\nimport {ComponentContext} from './ComponentContext.js';\nimport type {IShadowObjectEnvProxy} from './IShadowObjectEnvProxy.js';\n\ndeclare global {\n  // eslint-disable-next-line no-var\n  var __shadowEnvs: Map<NamespaceType, ShadowEnv> | undefined;\n}\n\n/**\n * The reason every pending {@link ShadowEnv.ready} and {@link ShadowEnv.syncWait} promise\n * is rejected with when the environment is destroyed.\n */\nexport class ShadowEnvDestroyedError extends Error {\n  constructor(message = 'the shadow environment has been destroyed') {\n    super(message);\n    this.name = 'ShadowEnvDestroyedError';\n  }\n}\n\nexport class ShadowEnv {\n  static AfterSync = 'afterSync';\n  static ContextLost = 'contextLost';\n  static ContextCreated = 'contextCreated';\n  static ProxyFailed = 'proxyFailed';\n\n  static get(ns: NamespaceType): ShadowEnv | undefined {\n    if (ns == null) return undefined;\n    return globalThis.__shadowEnvs?.get(ns);\n  }\n\n  #comCtx?: ComponentContext;\n  #shaObjEnvProxy?: IShadowObjectEnvProxy;\n  #syncScheduled = false;\n  #syncAfterContextCreated = false;\n  #syncWaitForConfirmation = false;\n  #afterNextSync?: Promise<ChangeTrailType>;\n\n  readonly logger = new ConsoleLogger('ShadowEnv');\n\n  readonly ns$ = createSignal<NamespaceType | undefined>();\n\n  @signal() accessor viewReady = false;\n  @signal() accessor proxyReady = false;\n\n  #isDestroyed = false;\n\n  get isDestroyed() {\n    return this.#isDestroyed;\n  }\n\n  constructor() {\n    const self = this as ShadowEnv;\n    retain(self, ShadowEnv.ContextCreated);\n\n    on(self, ShadowEnv.ContextLost, Priority.AAA, () => {\n      retainClear(self, ShadowEnv.ContextCreated);\n    });\n\n    createEffect(() => {\n      if (this.viewReady && this.proxyReady) {\n        this.view!.reCreateChanges();\n        emit(self, ShadowEnv.ContextCreated, self);\n        if (this.#syncAfterContextCreated) {\n          this.#syncAfterContextCreated = false;\n          this.#syncNow();\n        }\n        return () => {\n          emit(self, ShadowEnv.ContextLost, self);\n        };\n      }\n      // the two @signal accessors above create their signals during field initialization,\n      // so both lookups resolve by the time the constructor body runs\n    }, [findObjectSignalByName(this, 'viewReady')!, findObjectSignalByName(this, 'proxyReady')!]);\n  }\n\n  get view(): ComponentContext | undefined {\n    return this.#comCtx;\n  }\n\n  set view(ctx: ComponentContext | null | undefined) {\n    if (ctx !== this.#comCtx) {\n      if (this.#comCtx?.ns && globalThis.__shadowEnvs) {\n        globalThis.__shadowEnvs.delete(this.#comCtx.ns);\n      }\n\n      this.#comCtx = ctx ?? undefined;\n\n      if (this.#comCtx?.ns) {\n        globalThis.__shadowEnvs ??= new Map();\n        if (globalThis.__shadowEnvs.has(this.#comCtx.ns) && globalThis.__shadowEnvs.get(this.#comCtx.ns) !== this) {\n          if (this.logger.isWarn) {\n            this.logger.warn(\n              'overwrite a namespace already in use',\n              this.#comCtx.ns,\n              globalThis.__shadowEnvs.get(this.#comCtx.ns),\n            );\n          }\n        }\n        globalThis.__shadowEnvs.set(this.#comCtx.ns, this);\n      }\n\n      this.viewReady = Boolean(ctx);\n    }\n  }\n\n  get envProxy(): IShadowObjectEnvProxy | undefined {\n    return this.#shaObjEnvProxy;\n  }\n\n  set envProxy(proxy: IShadowObjectEnvProxy | null | undefined) {\n    if (proxy !== this.#shaObjEnvProxy) {\n      const prevProxy = this.#shaObjEnvProxy;\n      this.#shaObjEnvProxy = proxy ?? undefined;\n\n      if (this.#shaObjEnvProxy) {\n        this.#shaObjEnvProxy.onMessageToView = this.#onMessageToView.bind(this);\n        this.#shaObjEnvProxy.onProxyFailed = this.#onProxyFailed.bind(this);\n      }\n\n      if (prevProxy) {\n        prevProxy.destroy();\n      }\n\n      this.proxyReady = false;\n\n      proxy\n        ?.start()\n        .then(() => {\n          this.proxyReady = true;\n        })\n        .catch((error) => {\n          this.logger.error('failed to start envProxy', error);\n          this.proxyReady = false;\n        });\n    }\n  }\n\n  get isReady(): boolean {\n    return Boolean(this.#comCtx && this.#shaObjEnvProxy && this.proxyReady && !this.isDestroyed);\n  }\n\n  #whenDestroyed?: Promise<never>;\n  #rejectWhenDestroyed?: (error: Error) => void;\n\n  /**\n   * A promise that rejects the moment this environment is destroyed.\n   *\n   * Every promise the public API hands out races against it. Without that race a caller\n   * would wait forever, because {@link ShadowEnv.destroy} tears down the very listeners\n   * those promises are built on.\n   */\n  #destroyedSignal(): Promise<never> {\n    if (this.#whenDestroyed == null) {\n      this.#whenDestroyed = new Promise<never>((_, reject) => {\n        this.#rejectWhenDestroyed = reject;\n      });\n      // the signal is rejected unconditionally, also when nobody happens to be racing against it\n      this.#whenDestroyed.catch(() => {});\n    }\n    return this.#whenDestroyed;\n  }\n\n  /**\n   * Resolves once the environment is ready.\n   *\n   * @throws {ShadowEnvDestroyedError} if the environment is destroyed before that happens\n   */\n  readonly ready = async (): Promise<ShadowEnv> => {\n    if (this.#isDestroyed) throw new ShadowEnvDestroyedError();\n    if (this.isReady) return this;\n    return Promise.race([onceAsync<ShadowEnv>(this as ShadowEnv, ShadowEnv.ContextCreated), this.#destroyedSignal()]);\n  };\n\n  sync(): void {\n    if (this.#isDestroyed) return;\n    if (!this.isReady) {\n      this.#syncAfterContextCreated = true;\n      return;\n    }\n    if (this.#syncScheduled) return;\n    this.#syncScheduled = true;\n    queueMicrotask(this.#syncIfScheduled);\n  }\n\n  /**\n   * Like {@link ShadowEnv.sync}, but resolves with the change trail once the cycle completed.\n   *\n   * @throws {ShadowEnvDestroyedError} if the environment is destroyed before that happens\n   */\n  syncWait(): Promise<ChangeTrailType> {\n    if (this.#isDestroyed) return Promise.reject(new ShadowEnvDestroyedError());\n\n    this.#syncWaitForConfirmation = true;\n    this.sync();\n\n    if (this.#afterNextSync) return this.#afterNextSync;\n\n    this.#afterNextSync = Promise.race([\n      onceAsync<ChangeTrailType>(this as ShadowEnv, ShadowEnv.AfterSync),\n      this.#destroyedSignal(),\n    ]).then(\n      (changeTrail) => {\n        this.#afterNextSync = undefined;\n        return changeTrail;\n      },\n      (error) => {\n        this.#afterNextSync = undefined;\n        throw error;\n      },\n    );\n\n    return this.#afterNextSync;\n  }\n\n  /**\n   * Tear the environment down: the proxy is destroyed, the namespace is released, all signals\n   * and listeners are removed, and every caller still waiting on {@link ShadowEnv.ready} or\n   * {@link ShadowEnv.syncWait} is rejected with a {@link ShadowEnvDestroyedError} instead of\n   * being left pending forever. Calling it more than once is a no-op.\n   */\n  destroy() {\n    if (this.#isDestroyed) return;\n\n    // set first: isReady must report false for everything that runs below\n    this.#isDestroyed = true;\n\n    this.#syncScheduled = false;\n    this.#syncAfterContextCreated = false;\n    this.#syncWaitForConfirmation = false;\n\n    const ns = this.#comCtx?.ns;\n\n    // the `envProxy` setter destroys the previous proxy, so it must not be destroyed here as well\n    this.envProxy = undefined;\n    this.view = undefined;\n\n    const shadowEnvs = globalThis.__shadowEnvs;\n    if (ns && shadowEnvs?.get(ns) === this) {\n      shadowEnvs.delete(ns);\n    }\n\n    // settle everyone still waiting before the listeners they depend on are removed\n    this.#rejectWhenDestroyed?.(new ShadowEnvDestroyedError());\n    this.#afterNextSync = undefined;\n\n    destroyObjectSignals(this);\n    off(this);\n\n    Object.freeze(this);\n  }\n\n  #syncIfScheduled = () => {\n    if (this.#syncScheduled) {\n      this.#syncNow();\n    }\n  };\n\n  async #syncNow() {\n    this.#syncScheduled = false;\n\n    if (this.#isDestroyed) return;\n\n    if (!this.isReady) {\n      // the environment went away between scheduling and running this sync:\n      // re-arm instead of dropping it, otherwise a pending syncWait() would never settle\n      this.#syncAfterContextCreated = true;\n      return;\n    }\n\n    const data = this.view!.buildChangeTrails();\n\n    const waitForConfirmation = this.#syncWaitForConfirmation;\n    this.#syncWaitForConfirmation = false;\n\n    try {\n      if (data.length > 0) {\n        await this.envProxy!.applyChangeTrail(data, waitForConfirmation);\n      }\n    } catch (error) {\n      this.logger.error('failed to apply change trail', error);\n    } finally {\n      // always emitted, even for an empty change trail, so that syncWait() settles on every cycle\n      emit(this as ShadowEnv, ShadowEnv.AfterSync, data);\n    }\n  }\n\n  #onMessageToView(event: Omit<MessageToViewEvent, 'transferables'>) {\n    if (this.logger.isDebug) {\n      this.logger.debug('onMessageToView', event.type, event.data);\n    }\n    this.view?.dispatchMessage(event.uuid, event.type, event.data, event.traverseChildren);\n  }\n\n  #onProxyFailed(reason: unknown) {\n    // destroy() freezes this instance and destroys its signals; a proxy may report its failure afterwards\n    if (this.#isDestroyed) return;\n\n    this.logger.error('the environment proxy failed', reason);\n\n    try {\n      // the reason before the consequence: ContextLost follows from dropping proxyReady\n      emit(this as ShadowEnv, ShadowEnv.ProxyFailed, reason, this as ShadowEnv);\n    } finally {\n      // in the `finally`, because losing the environment is not up for debate:\n      // a listener that throws must not leave `isReady` claiming otherwise\n      this.proxyReady = false;\n    }\n  }\n}"],
+  "mappings": "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",
   "names": []
 }

package/src/view/ViewComponent.d.ts

@@ -7,7 +7,24 @@ export declare class ViewComponent {
     get parent(): ViewComponent | undefined;
     set parent(parent: ViewComponent | null | undefined);
     get context(): ComponentContext | undefined;
+    /**
+     * @throws {ComponentContextDisposedError} if the new context has been disposed. The component
+     *   keeps its current context in that case: leaving the old one is only worth it if the new
+     *   one can actually be joined.
+     */
     set context(context: ComponentContext | null | undefined);
+    /**
+     * A destroyed component is detached from its {@link ComponentContext}: it no longer appears
+     * in any change trail and no longer has a corresponding entity.
+     *
+     * Every mutation that only concerns the component itself (`token`, `order`, properties, events,
+     * `removeFromParent`, `destroy`) is silently ignored while destroyed. Operations that would tie
+     * a second, live component to it (`addChild`, the `parent` setter) throw instead, because
+     * ignoring them would leave the caller with a wrong picture of the entity tree.
+     *
+     * Assigning a {@link ViewComponent#context} revives the component under the same uuid.
+     */
+    get isDestroyed(): boolean;
     /**
      * The order property sets the order to lay out a component in a children array of the parent component.
      *
@@ -33,7 +50,11 @@ export declare class ViewComponent {
     isChildOf(parent: ViewComponent): boolean;
     removeFromParent(): void;
     addChild(child: ViewComponent): void;
-    setProperty<T = unknown>(name: string, value: T, isEqual?: (a: T, b: T) => boolean): void;
+    /**
+     * @returns `true` if the value differs from the last one written to the change trail.
+     *   A destroyed component always returns `false`.
+     */
+    setProperty<T = unknown>(name: string, value: T, isEqual?: (a: T, b: T) => boolean): boolean;
     removeProperty(name: string): void;
     dispatchShadowObjectsEvent(type: string, data: unknown, transferables?: Transferable[]): void;
     dispatchEvent(type: string, data: unknown, traverseChildren: boolean): void;

package/src/view/ViewComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ViewComponent.d.ts","sourceRoot":"","sources":["../../../src/view/ViewComponent.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AASvD,qBAAa,aAAa;;IAWxB,IAAI,IAAI,WAEP;IAED,IAAI,KAAK,IAIQ,MAAM,GAAG,SAAS,CAFlC;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAKlC;IAED,IAAI,MAAM,IAAI,aAAa,GAAG,SAAS,CAEtC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EASlD;IAED,IAAI,OAAO,IAAI,gBAAgB,GAAG,SAAS,CAE1C;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,EAUvD;IAED;;;;OAIG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAMzC;IAED;;;;;;OAMG;IACH,IAAI,8BAA8B,IAAI,OAAO,CAE5C;gBAGC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,8BAA8B,CAAC,EAAE,OAAO,CAAC;KAC1C;IAwBH,SAAS,CAAC,MAAM,EAAE,aAAa;IAI/B,gBAAgB;IAShB,QAAQ,CAAC,KAAK,EAAE,aAAa;IAW7B,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO;IAIlF,cAAc,CAAC,IAAI,EAAE,MAAM;IAI3B,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,YAAY,EAAE;IAItF,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO;IAUpE,OAAO;CAKR"}
+{"version":3,"file":"ViewComponent.d.ts","sourceRoot":"","sources":["../../../src/view/ViewComponent.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,gBAAgB,EAAgC,MAAM,uBAAuB,CAAC;AAsBtF,qBAAa,aAAa;;IAWxB,IAAI,IAAI,WAEP;IAED,IAAI,KAAK,IAIQ,MAAM,GAAG,SAAS,CAFlC;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAKlC;IAED,IAAI,MAAM,IAAI,aAAa,GAAG,SAAS,CAEtC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EAMlD;IAED,IAAI,OAAO,IAAI,gBAAgB,GAAG,SAAS,CAE1C;IAED;;;;OAIG;IACH,IAAI,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,EAyBvD;IAED;;;;;;;;;;OAUG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;OAIG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAMzC;IAED;;;;;;OAMG;IACH,IAAI,8BAA8B,IAAI,OAAO,CAE5C;gBAGC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,aAAa,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,8BAA8B,CAAC,EAAE,OAAO,CAAC;KAC1C;IAwBH,SAAS,CAAC,MAAM,EAAE,aAAa;IAI/B,gBAAgB;IAShB,QAAQ,CAAC,KAAK,EAAE,aAAa;IAuB7B;;;OAGG;IACH,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,GAAG,OAAO;IAI5F,cAAc,CAAC,IAAI,EAAE,MAAM;IAI3B,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,YAAY,EAAE;IAItF,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO;IAUpE,OAAO;CAKR"}

package/src/view/ViewComponent.js

@@ -1,13 +1,21 @@
 import { emit, eventize } from "@spearwolf/eventize";
 import { VoidToken } from "../constants.js";
 import { generateUUID } from "../utils/generateUUID.js";
-import { ComponentContext } from "./ComponentContext.js";
+import { ComponentContext, ComponentContextDisposedError } from "./ComponentContext.js";
 class ViewComponentError extends Error {
   constructor(message) {
     super(message);
     this.name = "ViewComponentError";
   }
 }
+function assertUsableAsParent(parent, childContext) {
+  if (parent.context == null) {
+    throw new ViewComponentError("cannot add a child to a destroyed view component");
+  }
+  if (parent.context !== childContext) {
+    throw new ViewComponentError("cannot add a child from another context");
+  }
+}
 class ViewComponent {
   #uuid;
   #token;
@@ -32,9 +40,6 @@ class ViewComponent {
   }
   set parent(parent) {
     if (parent) {
-      if (parent.#context !== this.#context) {
-        throw new ViewComponentError("cannot set parent from different context");
-      }
       parent.addChild(this);
     } else {
       this.removeFromParent();
@@ -43,17 +48,44 @@ class ViewComponent {
   get context() {
     return this.#context;
   }
+  /**
+   * @throws {ComponentContextDisposedError} if the new context has been disposed. The component
+   *   keeps its current context in that case: leaving the old one is only worth it if the new
+   *   one can actually be joined.
+   */
   set context(context) {
-    if (this.#context != context) {
-      if (this.#context) {
-        this.destroy();
-      }
-      this.#context = context;
-      if (context) {
-        context.addComponent(this);
-      }
+    const next = context ?? void 0;
+    if (this.#context === next) return;
+    if (next?.isDisposed) {
+      throw new ComponentContextDisposedError(
+        `the view component ${this.#uuid} cannot join the component context because it has been disposed`
+      );
+    }
+    if (this.#context) {
+      this.destroy();
+    }
+    this.#context = next;
+    try {
+      next?.addComponent(this);
+    } catch (error) {
+      this.#context = void 0;
+      throw error;
     }
   }
+  /**
+   * A destroyed component is detached from its {@link ComponentContext}: it no longer appears
+   * in any change trail and no longer has a corresponding entity.
+   *
+   * Every mutation that only concerns the component itself (`token`, `order`, properties, events,
+   * `removeFromParent`, `destroy`) is silently ignored while destroyed. Operations that would tie
+   * a second, live component to it (`addChild`, the `parent` setter) throw instead, because
+   * ignoring them would leave the caller with a wrong picture of the entity tree.
+   *
+   * Assigning a {@link ViewComponent#context} revives the component under the same uuid.
+   */
+  get isDestroyed() {
+    return this.#context == null;
+  }
   /**
    * The order property sets the order to lay out a component in a children array of the parent component.
    *
@@ -66,7 +98,7 @@ class ViewComponent {
     const prevOrder = this.#order;
     this.#order = order ?? 0;
     if (prevOrder !== this.#order) {
-      this.#context.changeOrder(this);
+      this.#context?.changeOrder(this);
     }
   }
   /**
@@ -85,13 +117,13 @@ class ViewComponent {
       options = { parent: options };
     }
     this.#uuid = options?.uuid ?? generateUUID();
-    this.#token = token;
+    this.#token = token ?? VoidToken;
     this.#order = options?.order ?? 0;
     this.#parent = options?.parent;
     this.#autoDestructionOnParentRemoval = options?.autoDestructionOnParentRemoval ?? false;
     const ctx = options?.context ?? ComponentContext.get();
-    if (this.#parent && this.#parent.#context !== ctx) {
-      throw new ViewComponentError("cannot set parent from different context");
+    if (this.#parent) {
+      assertUsableAsParent(this.#parent, ctx);
     }
     this.context = ctx;
   }
@@ -107,8 +139,16 @@ class ViewComponent {
     }
   }
   addChild(child) {
-    if (child.#context !== this.#context) {
-      throw new ViewComponentError("cannot add a child from another context");
+    if (child.#context == null) {
+      throw new ViewComponentError("cannot add a destroyed view component as a child");
+    }
+    assertUsableAsParent(this, child.#context);
+    for (let ancestor = this; ancestor != null; ancestor = ancestor.#parent) {
+      if (ancestor === child) {
+        throw new ViewComponentError(
+          "cannot add the component itself or one of its ancestors as a child: this would create a cycle"
+        );
+      }
     }
     if (!child.isChildOf(this)) {
       child.removeFromParent();
@@ -116,19 +156,23 @@ class ViewComponent {
       this.#context.addToChildren(this, child);
     }
   }
+  /**
+   * @returns `true` if the value differs from the last one written to the change trail.
+   *   A destroyed component always returns `false`.
+   */
   setProperty(name, value, isEqual) {
-    this.#context.setProperty(this, name, value, isEqual);
+    return this.#context?.setProperty(this, name, value, isEqual) ?? false;
   }
   removeProperty(name) {
-    this.#context.removeProperty(this, name);
+    this.#context?.removeProperty(this, name);
   }
   dispatchShadowObjectsEvent(type, data, transferables) {
-    this.#context.dispatchShadowObjectsEvent(this, type, data, transferables);
+    this.#context?.dispatchShadowObjectsEvent(this, type, data, transferables);
   }
   dispatchEvent(type, data, traverseChildren) {
     emit(this, type, data);
     if (traverseChildren) {
-      for (const child of this.#context.getChildren(this)) {
+      for (const child of this.#context?.getChildren(this) ?? []) {
         child.dispatchEvent(type, data, traverseChildren);
       }
     }

package/src/view/ViewComponent.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/view/ViewComponent.ts"],
-  "sourcesContent": ["import {emit, eventize} from '@spearwolf/eventize';\nimport {VoidToken} from '../constants.js';\nimport {generateUUID} from '../utils/generateUUID.js';\nimport {ComponentContext} from './ComponentContext.js';\n\nclass ViewComponentError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'ViewComponentError';\n  }\n}\n\nexport class ViewComponent {\n  readonly #uuid: string;\n\n  #token: string;\n\n  #context?: ComponentContext;\n\n  #parent?: ViewComponent;\n  #order = 0;\n  readonly #autoDestructionOnParentRemoval: boolean;\n\n  get uuid() {\n    return this.#uuid;\n  }\n\n  get token() {\n    return this.#token;\n  }\n\n  set token(token: string | undefined) {\n    token ??= VoidToken;\n    if (token === this.#token) return;\n    this.#token = token;\n    this.#context?.changeToken(this, token);\n  }\n\n  get parent(): ViewComponent | undefined {\n    return this.#parent;\n  }\n\n  set parent(parent: ViewComponent | null | undefined) {\n    if (parent) {\n      if (parent.#context !== this.#context) {\n        throw new ViewComponentError('cannot set parent from different context');\n      }\n      parent.addChild(this);\n    } else {\n      this.removeFromParent();\n    }\n  }\n\n  get context(): ComponentContext | undefined {\n    return this.#context;\n  }\n\n  set context(context: ComponentContext | null | undefined) {\n    if (this.#context != context) {\n      if (this.#context) {\n        this.destroy();\n      }\n      this.#context = context;\n      if (context) {\n        context.addComponent(this);\n      }\n    }\n  }\n\n  /**\n   * The order property sets the order to lay out a component in a children array of the parent component.\n   *\n   * Items in a children array are sorted by ascending order value and then by their insertion order.\n   */\n  get order(): number {\n    return this.#order;\n  }\n\n  set order(order: number | null | undefined) {\n    const prevOrder = this.#order;\n    this.#order = order ?? 0;\n    if (prevOrder !== this.#order) {\n      this.#context.changeOrder(this);\n    }\n  }\n\n  /**\n   * Whether the corresponding entity should be destroyed when its parent entity is destroyed.\n   *\n   * Set via the constructor option of the same name; immutable after creation.\n   * Children that opt out (the default) are promoted to root entities when their\n   * parent is destroyed, so they remain reachable.\n   */\n  get autoDestructionOnParentRemoval(): boolean {\n    return this.#autoDestructionOnParentRemoval;\n  }\n\n  constructor(\n    token: string,\n    options?: {\n      parent?: ViewComponent;\n      order?: number;\n      context?: ComponentContext;\n      uuid?: string;\n      autoDestructionOnParentRemoval?: boolean;\n    },\n  ) {\n    eventize(this);\n\n    if (options instanceof ViewComponent) {\n      options = {parent: options};\n    }\n\n    this.#uuid = options?.uuid ?? generateUUID();\n\n    this.#token = token;\n    this.#order = options?.order ?? 0;\n    this.#parent = options?.parent;\n    this.#autoDestructionOnParentRemoval = options?.autoDestructionOnParentRemoval ?? false;\n\n    const ctx = options?.context ?? ComponentContext.get();\n\n    if (this.#parent && this.#parent.#context !== ctx) {\n      throw new ViewComponentError('cannot set parent from different context');\n    }\n\n    this.context = ctx;\n  }\n\n  isChildOf(parent: ViewComponent) {\n    return this.#parent === parent;\n  }\n\n  removeFromParent() {\n    if (this.#parent) {\n      this.#context?.removeFromParent(this.uuid, this.#parent);\n      this.#parent = undefined;\n    } else {\n      this.#context?.moveToRoot(this.uuid);\n    }\n  }\n\n  addChild(child: ViewComponent) {\n    if (child.#context !== this.#context) {\n      throw new ViewComponentError('cannot add a child from another context');\n    }\n    if (!child.isChildOf(this)) {\n      child.removeFromParent();\n      child.#parent = this;\n      this.#context.addToChildren(this, child);\n    }\n  }\n\n  setProperty<T = unknown>(name: string, value: T, isEqual?: (a: T, b: T) => boolean) {\n    this.#context.setProperty(this, name, value, isEqual);\n  }\n\n  removeProperty(name: string) {\n    this.#context.removeProperty(this, name);\n  }\n\n  dispatchShadowObjectsEvent(type: string, data: unknown, transferables?: Transferable[]) {\n    this.#context.dispatchShadowObjectsEvent(this, type, data, transferables);\n  }\n\n  dispatchEvent(type: string, data: unknown, traverseChildren: boolean) {\n    emit(this as ViewComponent, type, data);\n\n    if (traverseChildren) {\n      for (const child of this.#context!.getChildren(this)) {\n        child.dispatchEvent(type, data, traverseChildren);\n      }\n    }\n  }\n\n  destroy() {\n    this.removeFromParent();\n    this.#context?.destroyComponent(this);\n    this.#context = undefined;\n  }\n}"],
-  "mappings": "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",
+  "sourcesContent": ["import {emit, eventize} from '@spearwolf/eventize';\nimport {VoidToken} from '../constants.js';\nimport {generateUUID} from '../utils/generateUUID.js';\nimport {ComponentContext, ComponentContextDisposedError} from './ComponentContext.js';\n\nclass ViewComponentError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'ViewComponentError';\n  }\n}\n\n/**\n * Guards every path that attaches a child to a parent: the constructor, {@link ViewComponent#addChild}\n * and the `parent` setter all funnel through here so that they fail with the same message.\n */\nfunction assertUsableAsParent(parent: ViewComponent, childContext: ComponentContext | undefined) {\n  if (parent.context == null) {\n    throw new ViewComponentError('cannot add a child to a destroyed view component');\n  }\n  if (parent.context !== childContext) {\n    throw new ViewComponentError('cannot add a child from another context');\n  }\n}\n\nexport class ViewComponent {\n  readonly #uuid: string;\n\n  #token: string;\n\n  #context?: ComponentContext;\n\n  #parent?: ViewComponent;\n  #order = 0;\n  readonly #autoDestructionOnParentRemoval: boolean;\n\n  get uuid() {\n    return this.#uuid;\n  }\n\n  get token() {\n    return this.#token;\n  }\n\n  set token(token: string | undefined) {\n    token ??= VoidToken;\n    if (token === this.#token) return;\n    this.#token = token;\n    this.#context?.changeToken(this, token);\n  }\n\n  get parent(): ViewComponent | undefined {\n    return this.#parent;\n  }\n\n  set parent(parent: ViewComponent | null | undefined) {\n    if (parent) {\n      parent.addChild(this);\n    } else {\n      this.removeFromParent();\n    }\n  }\n\n  get context(): ComponentContext | undefined {\n    return this.#context;\n  }\n\n  /**\n   * @throws {ComponentContextDisposedError} if the new context has been disposed. The component\n   *   keeps its current context in that case: leaving the old one is only worth it if the new\n   *   one can actually be joined.\n   */\n  set context(context: ComponentContext | null | undefined) {\n    const next = context ?? undefined;\n    if (this.#context === next) return;\n\n    // checked before the teardown below, so a rejected join costs the component nothing\n    if (next?.isDisposed) {\n      throw new ComponentContextDisposedError(\n        `the view component ${this.#uuid} cannot join the component context because it has been disposed`,\n      );\n    }\n\n    if (this.#context) {\n      this.destroy();\n    }\n\n    this.#context = next;\n\n    try {\n      next?.addComponent(this);\n    } catch (error) {\n      // a failed join must not leave a destroyed component pointing at a context that never\n      // took it in \u2014 every later mutation would silently go nowhere while `isDestroyed` lies\n      this.#context = undefined;\n      throw error;\n    }\n  }\n\n  /**\n   * A destroyed component is detached from its {@link ComponentContext}: it no longer appears\n   * in any change trail and no longer has a corresponding entity.\n   *\n   * Every mutation that only concerns the component itself (`token`, `order`, properties, events,\n   * `removeFromParent`, `destroy`) is silently ignored while destroyed. Operations that would tie\n   * a second, live component to it (`addChild`, the `parent` setter) throw instead, because\n   * ignoring them would leave the caller with a wrong picture of the entity tree.\n   *\n   * Assigning a {@link ViewComponent#context} revives the component under the same uuid.\n   */\n  get isDestroyed(): boolean {\n    return this.#context == null;\n  }\n\n  /**\n   * The order property sets the order to lay out a component in a children array of the parent component.\n   *\n   * Items in a children array are sorted by ascending order value and then by their insertion order.\n   */\n  get order(): number {\n    return this.#order;\n  }\n\n  set order(order: number | null | undefined) {\n    const prevOrder = this.#order;\n    this.#order = order ?? 0;\n    if (prevOrder !== this.#order) {\n      this.#context?.changeOrder(this);\n    }\n  }\n\n  /**\n   * Whether the corresponding entity should be destroyed when its parent entity is destroyed.\n   *\n   * Set via the constructor option of the same name; immutable after creation.\n   * Children that opt out (the default) are promoted to root entities when their\n   * parent is destroyed, so they remain reachable.\n   */\n  get autoDestructionOnParentRemoval(): boolean {\n    return this.#autoDestructionOnParentRemoval;\n  }\n\n  constructor(\n    token: string,\n    options?: {\n      parent?: ViewComponent;\n      order?: number;\n      context?: ComponentContext;\n      uuid?: string;\n      autoDestructionOnParentRemoval?: boolean;\n    },\n  ) {\n    eventize(this);\n\n    if (options instanceof ViewComponent) {\n      options = {parent: options};\n    }\n\n    this.#uuid = options?.uuid ?? generateUUID();\n\n    this.#token = token ?? VoidToken;\n    this.#order = options?.order ?? 0;\n    this.#parent = options?.parent;\n    this.#autoDestructionOnParentRemoval = options?.autoDestructionOnParentRemoval ?? false;\n\n    const ctx = options?.context ?? ComponentContext.get();\n\n    if (this.#parent) {\n      assertUsableAsParent(this.#parent, ctx);\n    }\n\n    this.context = ctx;\n  }\n\n  isChildOf(parent: ViewComponent) {\n    return this.#parent === parent;\n  }\n\n  removeFromParent() {\n    if (this.#parent) {\n      this.#context?.removeFromParent(this.uuid, this.#parent);\n      this.#parent = undefined;\n    } else {\n      this.#context?.moveToRoot(this.uuid);\n    }\n  }\n\n  addChild(child: ViewComponent) {\n    if (child.#context == null) {\n      throw new ViewComponentError('cannot add a destroyed view component as a child');\n    }\n\n    assertUsableAsParent(this, child.#context);\n\n    // walking up via #parent is safe: the entity tree is kept acyclic by exactly this guard\n    for (let ancestor: ViewComponent | undefined = this; ancestor != null; ancestor = ancestor.#parent) {\n      if (ancestor === child) {\n        throw new ViewComponentError(\n          'cannot add the component itself or one of its ancestors as a child: this would create a cycle',\n        );\n      }\n    }\n\n    if (!child.isChildOf(this)) {\n      child.removeFromParent();\n      child.#parent = this;\n      this.#context!.addToChildren(this, child);\n    }\n  }\n\n  /**\n   * @returns `true` if the value differs from the last one written to the change trail.\n   *   A destroyed component always returns `false`.\n   */\n  setProperty<T = unknown>(name: string, value: T, isEqual?: (a: T, b: T) => boolean): boolean {\n    return this.#context?.setProperty(this, name, value, isEqual) ?? false;\n  }\n\n  removeProperty(name: string) {\n    this.#context?.removeProperty(this, name);\n  }\n\n  dispatchShadowObjectsEvent(type: string, data: unknown, transferables?: Transferable[]) {\n    this.#context?.dispatchShadowObjectsEvent(this, type, data, transferables);\n  }\n\n  dispatchEvent(type: string, data: unknown, traverseChildren: boolean) {\n    emit(this as ViewComponent, type, data);\n\n    if (traverseChildren) {\n      for (const child of this.#context?.getChildren(this) ?? []) {\n        child.dispatchEvent(type, data, traverseChildren);\n      }\n    }\n  }\n\n  destroy() {\n    this.removeFromParent();\n    this.#context?.destroyComponent(this);\n    this.#context = undefined;\n  }\n}"],
+  "mappings": "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",
   "names": []
 }

package/src/worker/MessageRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageRouter.d.ts","sourceRoot":"","sources":["../../../src/worker/MessageRouter.ts"],"names":[],"mappings":"AAYA,OAAO,EAAC,MAAM,EAAE,KAAK,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAQzE,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,IAAI,CAAC,WAAW,CAAC;CACvC;AAED,qBAAa,aAAa;;IAGxB,MAAM,EAAE,MAAM,CAAC;IAEf,WAAW,EAAE,OAAO,IAAI,CAAC,WAAW,CAAC;gBAEzB,OAAO,CAAC,EAAE,oBAAoB;IAQ1C,KAAK,CAAC,KAAK,EAAE,YAAY;IAmBzB,eAAe,CAAC,KAAK,EAAE,kBAAkB;CA6C1C"}
+{"version":3,"file":"MessageRouter.d.ts","sourceRoot":"","sources":["../../../src/worker/MessageRouter.ts"],"names":[],"mappings":"AAYA,OAAO,EAAC,MAAM,EAAE,KAAK,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAQzE,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,IAAI,CAAC,WAAW,CAAC;CACvC;AAED,qBAAa,aAAa;;IAGxB,MAAM,EAAE,MAAM,CAAC;IAEf,WAAW,EAAE,OAAO,IAAI,CAAC,WAAW,CAAC;gBAEzB,OAAO,CAAC,EAAE,oBAAoB;IAQ1C,KAAK,CAAC,KAAK,EAAE,YAAY;IAmBzB,eAAe,CAAC,KAAK,EAAE,kBAAkB;CA+C1C"}

package/src/worker/MessageRouter.js

@@ -39,24 +39,26 @@ class MessageRouter {
     this.postMessage({ type: MessageToView, data }, { transfer });
   }
   async #configure(data) {
+    const url = data.importModule;
     try {
+      if (!url) throw new Error('missing "importModule" url');
       const module = await import(
         /* @vite-ignore */
-        toUrlString(data.importModule)
+        toUrlString(url)
       );
       if (module[ShadowObjectsExport]) {
         await importModule(this.kernel, module[ShadowObjectsExport], this.#importedModules);
-        this.postMessage({ type: ImportedModule, url: data.importModule });
+        this.postMessage({ type: ImportedModule, url });
       } else {
         this.postMessage({
           type: ImportedModule,
-          url: data.importModule,
+          url,
           error: `module has no "${ShadowObjectsExport}" export`
         });
       }
     } catch (error) {
       console.error("[MessageRouter] failed to import module", error);
-      this.postMessage({ type: ImportedModule, url: data.importModule, error: `${error}` });
+      this.postMessage({ type: ImportedModule, url, error: `${error}` });
     }
   }
   #onChangeTrail(data) {
@@ -64,7 +66,7 @@ class MessageRouter {
       this.kernel.run(data);
     } catch (error) {
       console.error("[MessageRouter] failed to apply change trail", error);
-      this.postMessage({ type: AppliedChangeTrail, serial: data.serial, error: error.toString() });
+      this.postMessage({ type: AppliedChangeTrail, serial: data.serial, error: `${error}` });
     }
     if (data.serial) {
       this.postMessage({ type: AppliedChangeTrail, serial: data.serial });

package/src/worker/MessageRouter.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/worker/MessageRouter.ts"],
-  "sourcesContent": ["import {off, on} from '@spearwolf/eventize';\nimport {\n  AppliedChangeTrail,\n  ChangeTrail,\n  Configure,\n  Destroy,\n  Destroyed,\n  ImportedModule,\n  MessageToView,\n  ShadowObjectsExport,\n} from '../constants.js';\nimport {importModule} from '../in-the-dark/importModule.js';\nimport {Kernel, type MessageToViewEvent} from '../in-the-dark/Kernel.js';\nimport type {AppliedChangeTrailEvent, ImportedModuleEvent, ShadowObjectsModule, SyncEvent} from '../types.js';\nimport {toUrlString} from '../utils/toUrlString.js';\n\ninterface ConfigurePayloadData {\n  importModule?: string;\n}\n\nexport interface MessageRouterOptions {\n  kernel?: Kernel;\n  postMessage?: typeof self.postMessage;\n}\n\nexport class MessageRouter {\n  #importedModules: Set<ShadowObjectsModule> = new Set();\n\n  kernel: Kernel;\n\n  postMessage: typeof self.postMessage;\n\n  constructor(options?: MessageRouterOptions) {\n    this.kernel = options?.kernel ?? new Kernel();\n\n    this.postMessage = options?.postMessage ?? self.postMessage.bind(self);\n\n    on(this.kernel, MessageToView, 'onMessageToView', this);\n  }\n\n  route(event: MessageEvent) {\n    switch (event.data.type) {\n      case Configure:\n        this.#configure(event.data);\n        break;\n\n      case ChangeTrail:\n        this.#onChangeTrail(event.data);\n        break;\n\n      case Destroy:\n        this.#onDestroy(event.data);\n        break;\n\n      default:\n        console.warn('[MessageRouter] unknown message', event.data.type ?? event.data);\n    }\n  }\n\n  onMessageToView(event: MessageToViewEvent) {\n    const {transferables: transfer, ...data} = event;\n    this.postMessage({type: MessageToView, data}, {transfer});\n  }\n\n  async #configure(data: ConfigurePayloadData) {\n    try {\n      const module = await import(/* @vite-ignore */ toUrlString(data.importModule));\n      if (module[ShadowObjectsExport]) {\n        await importModule(this.kernel, module[ShadowObjectsExport], this.#importedModules);\n        this.postMessage({type: ImportedModule, url: data.importModule});\n      } else {\n        this.postMessage({\n          type: ImportedModule,\n          url: data.importModule,\n          error: `module has no \"${ShadowObjectsExport}\" export`,\n        } as ImportedModuleEvent);\n      }\n    } catch (error) {\n      console.error('[MessageRouter] failed to import module', error);\n      this.postMessage({type: ImportedModule, url: data.importModule, error: `${error}`} as ImportedModuleEvent);\n    }\n  }\n\n  #onChangeTrail(data: SyncEvent) {\n    // console.debug('[MessageRouter] parseChangeTrail', {data, kernel: this.kernel});\n\n    try {\n      this.kernel.run(data);\n    } catch (error) {\n      console.error('[MessageRouter] failed to apply change trail', error);\n      this.postMessage({type: AppliedChangeTrail, serial: data.serial, error: error.toString()} as AppliedChangeTrailEvent);\n    }\n\n    if (data.serial) {\n      this.postMessage({type: AppliedChangeTrail, serial: data.serial} as AppliedChangeTrailEvent);\n    }\n  }\n\n  #onDestroy(data: any) {\n    console.debug('[MessageRouter] on destroy', data);\n    off(this.kernel, this);\n    this.#importedModules.clear();\n    this.postMessage({type: Destroyed});\n  }\n}"],
-  "mappings": "AAAA,SAAQ,KAAK,UAAS;AACtB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAQ,oBAAmB;AAC3B,SAAQ,cAAsC;AAE9C,SAAQ,mBAAkB;AAWnB,MAAM,cAAc;AAAA,EACzB,mBAA6C,oBAAI,IAAI;AAAA,EAMrD,YAAY,SAAgC;AAC1C,SAAK,SAAS,SAAS,UAAU,IAAI,OAAO;AAE5C,SAAK,cAAc,SAAS,eAAe,KAAK,YAAY,KAAK,IAAI;AAErE,OAAG,KAAK,QAAQ,eAAe,mBAAmB,IAAI;AAAA,EACxD;AAAA,EAEA,MAAM,OAAqB;AACzB,YAAQ,MAAM,KAAK,MAAM;AAAA,MACvB,KAAK;AACH,aAAK,WAAW,MAAM,IAAI;AAC1B;AAAA,MAEF,KAAK;AACH,aAAK,eAAe,MAAM,IAAI;AAC9B;AAAA,MAEF,KAAK;AACH,aAAK,WAAW,MAAM,IAAI;AAC1B;AAAA,MAEF;AACE,gBAAQ,KAAK,mCAAmC,MAAM,KAAK,QAAQ,MAAM,IAAI;AAAA,IACjF;AAAA,EACF;AAAA,EAEA,gBAAgB,OAA2B;AACzC,UAAM,EAAC,eAAe,UAAU,GAAG,KAAI,IAAI;AAC3C,SAAK,YAAY,EAAC,MAAM,eAAe,KAAI,GAAG,EAAC,SAAQ,CAAC;AAAA,EAC1D;AAAA,EAEA,MAAM,WAAW,MAA4B;AAC3C,QAAI;AACF,YAAM,SAAS,MAAM;AAAA;AAAA,QAA0B,YAAY,KAAK,YAAY;AAAA;AAC5E,UAAI,OAAO,mBAAmB,GAAG;AAC/B,cAAM,aAAa,KAAK,QAAQ,OAAO,mBAAmB,GAAG,KAAK,gBAAgB;AAClF,aAAK,YAAY,EAAC,MAAM,gBAAgB,KAAK,KAAK,aAAY,CAAC;AAAA,MACjE,OAAO;AACL,aAAK,YAAY;AAAA,UACf,MAAM;AAAA,UACN,KAAK,KAAK;AAAA,UACV,OAAO,kBAAkB,mBAAmB;AAAA,QAC9C,CAAwB;AAAA,MAC1B;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,MAAM,2CAA2C,KAAK;AAC9D,WAAK,YAAY,EAAC,MAAM,gBAAgB,KAAK,KAAK,cAAc,OAAO,GAAG,KAAK,GAAE,CAAwB;AAAA,IAC3G;AAAA,EACF;AAAA,EAEA,eAAe,MAAiB;AAG9B,QAAI;AACF,WAAK,OAAO,IAAI,IAAI;AAAA,IACtB,SAAS,OAAO;AACd,cAAQ,MAAM,gDAAgD,KAAK;AACnE,WAAK,YAAY,EAAC,MAAM,oBAAoB,QAAQ,KAAK,QAAQ,OAAO,MAAM,SAAS,EAAC,CAA4B;AAAA,IACtH;AAEA,QAAI,KAAK,QAAQ;AACf,WAAK,YAAY,EAAC,MAAM,oBAAoB,QAAQ,KAAK,OAAM,CAA4B;AAAA,IAC7F;AAAA,EACF;AAAA,EAEA,WAAW,MAAW;AACpB,YAAQ,MAAM,8BAA8B,IAAI;AAChD,QAAI,KAAK,QAAQ,IAAI;AACrB,SAAK,iBAAiB,MAAM;AAC5B,SAAK,YAAY,EAAC,MAAM,UAAS,CAAC;AAAA,EACpC;AACF;",
+  "sourcesContent": ["import {off, on} from '@spearwolf/eventize';\nimport {\n  AppliedChangeTrail,\n  ChangeTrail,\n  Configure,\n  Destroy,\n  Destroyed,\n  ImportedModule,\n  MessageToView,\n  ShadowObjectsExport,\n} from '../constants.js';\nimport {importModule} from '../in-the-dark/importModule.js';\nimport {Kernel, type MessageToViewEvent} from '../in-the-dark/Kernel.js';\nimport type {AppliedChangeTrailEvent, ImportedModuleEvent, ShadowObjectsModule, SyncEvent} from '../types.js';\nimport {toUrlString} from '../utils/toUrlString.js';\n\ninterface ConfigurePayloadData {\n  importModule?: string;\n}\n\nexport interface MessageRouterOptions {\n  kernel?: Kernel;\n  postMessage?: typeof self.postMessage;\n}\n\nexport class MessageRouter {\n  #importedModules: Set<ShadowObjectsModule> = new Set();\n\n  kernel: Kernel;\n\n  postMessage: typeof self.postMessage;\n\n  constructor(options?: MessageRouterOptions) {\n    this.kernel = options?.kernel ?? new Kernel();\n\n    this.postMessage = options?.postMessage ?? self.postMessage.bind(self);\n\n    on(this.kernel, MessageToView, 'onMessageToView', this);\n  }\n\n  route(event: MessageEvent) {\n    switch (event.data.type) {\n      case Configure:\n        this.#configure(event.data);\n        break;\n\n      case ChangeTrail:\n        this.#onChangeTrail(event.data);\n        break;\n\n      case Destroy:\n        this.#onDestroy(event.data);\n        break;\n\n      default:\n        console.warn('[MessageRouter] unknown message', event.data.type ?? event.data);\n    }\n  }\n\n  onMessageToView(event: MessageToViewEvent) {\n    const {transferables: transfer, ...data} = event;\n    this.postMessage({type: MessageToView, data}, {transfer});\n  }\n\n  async #configure(data: ConfigurePayloadData) {\n    const url = data.importModule;\n    try {\n      if (!url) throw new Error('missing \"importModule\" url');\n      const module = await import(/* @vite-ignore */ toUrlString(url));\n      if (module[ShadowObjectsExport]) {\n        await importModule(this.kernel, module[ShadowObjectsExport], this.#importedModules);\n        this.postMessage({type: ImportedModule, url});\n      } else {\n        this.postMessage({\n          type: ImportedModule,\n          url,\n          error: `module has no \"${ShadowObjectsExport}\" export`,\n        } as ImportedModuleEvent);\n      }\n    } catch (error) {\n      console.error('[MessageRouter] failed to import module', error);\n      this.postMessage({type: ImportedModule, url, error: `${error}`} as ImportedModuleEvent);\n    }\n  }\n\n  #onChangeTrail(data: SyncEvent) {\n    // console.debug('[MessageRouter] parseChangeTrail', {data, kernel: this.kernel});\n\n    try {\n      this.kernel.run(data);\n    } catch (error) {\n      console.error('[MessageRouter] failed to apply change trail', error);\n      this.postMessage({type: AppliedChangeTrail, serial: data.serial, error: `${error}`} as AppliedChangeTrailEvent);\n    }\n\n    if (data.serial) {\n      this.postMessage({type: AppliedChangeTrail, serial: data.serial} as AppliedChangeTrailEvent);\n    }\n  }\n\n  #onDestroy(data: any) {\n    console.debug('[MessageRouter] on destroy', data);\n    off(this.kernel, this);\n    this.#importedModules.clear();\n    this.postMessage({type: Destroyed});\n  }\n}"],
+  "mappings": "AAAA,SAAQ,KAAK,UAAS;AACtB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAQ,oBAAmB;AAC3B,SAAQ,cAAsC;AAE9C,SAAQ,mBAAkB;AAWnB,MAAM,cAAc;AAAA,EACzB,mBAA6C,oBAAI,IAAI;AAAA,EAMrD,YAAY,SAAgC;AAC1C,SAAK,SAAS,SAAS,UAAU,IAAI,OAAO;AAE5C,SAAK,cAAc,SAAS,eAAe,KAAK,YAAY,KAAK,IAAI;AAErE,OAAG,KAAK,QAAQ,eAAe,mBAAmB,IAAI;AAAA,EACxD;AAAA,EAEA,MAAM,OAAqB;AACzB,YAAQ,MAAM,KAAK,MAAM;AAAA,MACvB,KAAK;AACH,aAAK,WAAW,MAAM,IAAI;AAC1B;AAAA,MAEF,KAAK;AACH,aAAK,eAAe,MAAM,IAAI;AAC9B;AAAA,MAEF,KAAK;AACH,aAAK,WAAW,MAAM,IAAI;AAC1B;AAAA,MAEF;AACE,gBAAQ,KAAK,mCAAmC,MAAM,KAAK,QAAQ,MAAM,IAAI;AAAA,IACjF;AAAA,EACF;AAAA,EAEA,gBAAgB,OAA2B;AACzC,UAAM,EAAC,eAAe,UAAU,GAAG,KAAI,IAAI;AAC3C,SAAK,YAAY,EAAC,MAAM,eAAe,KAAI,GAAG,EAAC,SAAQ,CAAC;AAAA,EAC1D;AAAA,EAEA,MAAM,WAAW,MAA4B;AAC3C,UAAM,MAAM,KAAK;AACjB,QAAI;AACF,UAAI,CAAC,IAAK,OAAM,IAAI,MAAM,4BAA4B;AACtD,YAAM,SAAS,MAAM;AAAA;AAAA,QAA0B,YAAY,GAAG;AAAA;AAC9D,UAAI,OAAO,mBAAmB,GAAG;AAC/B,cAAM,aAAa,KAAK,QAAQ,OAAO,mBAAmB,GAAG,KAAK,gBAAgB;AAClF,aAAK,YAAY,EAAC,MAAM,gBAAgB,IAAG,CAAC;AAAA,MAC9C,OAAO;AACL,aAAK,YAAY;AAAA,UACf,MAAM;AAAA,UACN;AAAA,UACA,OAAO,kBAAkB,mBAAmB;AAAA,QAC9C,CAAwB;AAAA,MAC1B;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,MAAM,2CAA2C,KAAK;AAC9D,WAAK,YAAY,EAAC,MAAM,gBAAgB,KAAK,OAAO,GAAG,KAAK,GAAE,CAAwB;AAAA,IACxF;AAAA,EACF;AAAA,EAEA,eAAe,MAAiB;AAG9B,QAAI;AACF,WAAK,OAAO,IAAI,IAAI;AAAA,IACtB,SAAS,OAAO;AACd,cAAQ,MAAM,gDAAgD,KAAK;AACnE,WAAK,YAAY,EAAC,MAAM,oBAAoB,QAAQ,KAAK,QAAQ,OAAO,GAAG,KAAK,GAAE,CAA4B;AAAA,IAChH;AAEA,QAAI,KAAK,QAAQ;AACf,WAAK,YAAY,EAAC,MAAM,oBAAoB,QAAQ,KAAK,OAAM,CAA4B;AAAA,IAC7F;AAAA,EACF;AAAA,EAEA,WAAW,MAAW;AACpB,YAAQ,MAAM,8BAA8B,IAAI;AAChD,QAAI,KAAK,QAAQ,IAAI;AACrB,SAAK,iBAAiB,MAAM;AAC5B,SAAK,YAAY,EAAC,MAAM,UAAS,CAAC;AAAA,EACpC;AACF;",
   "names": []
 }