@spearwolf/shadow-objects 0.33.0 → 0.35.0

package/src/elements/ShaeWorkerElement.js

@@ -1,25 +1,51 @@
 import { on } from "@spearwolf/eventize";
-import { batch, createEffect, createSignal, destroySignal, Effect } from "@spearwolf/signalize";
-import { readBooleanAttribute } from "../utils/attr-utils.js";
+import { batch, createEffect, createSignal, destroySignal, Effect, hibernate } from "@spearwolf/signalize";
+import { readBooleanAttribute, readListAttribute, readNumberAttribute } from "../utils/attr-utils.js";
 import { ConsoleLogger } from "../utils/ConsoleLogger.js";
 import { FrameLoop } from "../utils/FrameLoop.js";
 import { ComponentContext } from "../view/ComponentContext.js";
 import { LocalShadowObjectEnv } from "../view/LocalShadowObjectEnv.js";
 import { RemoteWorkerEnv } from "../view/RemoteWorkerEnv.js";
 import { ShadowEnv, ShadowEnvDestroyedError } from "../view/ShadowEnv.js";
-import { ATTR_AUTO_SYNC, ATTR_LOCAL, ATTR_NO_AUTOSTART, ATTR_NO_STRUCTURED_CLONE, ATTR_SRC } from "./constants.js";
+import {
+  ATTR_AUTO_SYNC,
+  ATTR_CHANGE_TRAIL_TIMEOUT,
+  ATTR_CONFIGURE_TIMEOUT,
+  ATTR_DESTROY_TIMEOUT,
+  ATTR_EXPOSE_TO_MODEL_CONTEXT,
+  ATTR_INSPECT_TIMEOUT,
+  ATTR_LOAD_TIMEOUT,
+  ATTR_LOCAL,
+  ATTR_NO_AUTOSTART,
+  ATTR_NO_STRUCTURED_CLONE,
+  ATTR_REDACT_PROPS,
+  ATTR_SRC
+} from "./constants.js";
+import { ensureDisplayContentsRule } from "./displayContentsRule.js";
 import { ShaeElement } from "./ShaeElement.js";
+const WorkerTimeoutAttributes = [
+  ["loadTimeout", ATTR_LOAD_TIMEOUT],
+  ["configureTimeout", ATTR_CONFIGURE_TIMEOUT],
+  ["changeTrailTimeout", ATTR_CHANGE_TRAIL_TIMEOUT],
+  ["inspectTimeout", ATTR_INSPECT_TIMEOUT],
+  ["destroyTimeout", ATTR_DESTROY_TIMEOUT]
+];
+function normaliseAutoSync(value) {
+  if (typeof value !== "string") {
+    return value ? ShaeWorkerElement.DefaultAutoSync : "no";
+  }
+  return value.trim().toLowerCase();
+}
 class ShaeWorkerElement extends ShaeElement {
   constructor() {
-    super();
+    super(...arguments);
     this.isShaeWorkerElement = true;
     this.shadowEnv = new ShadowEnv();
-    this.logger = new ConsoleLogger("ShaeWorkerElement");
+    this.#logger = new ConsoleLogger("ShaeWorkerElement");
     this.autostart = true;
     this.isConnected$ = createSignal(false);
     this.autoSync$ = createSignal(ShaeWorkerElement.DefaultAutoSync);
     this.src$ = createSignal("");
-    this.#shouldDestroy = false;
     this.#started = false;
     /**
      * Both {@link ShaeWorkerElement.start} and {@link ShaeWorkerElement.importScript} await
@@ -32,7 +58,80 @@ class ShaeWorkerElement extends ShaeElement {
       if (error instanceof ShadowEnvDestroyedError) return;
       this.logger.error("shadowEnv failed", error);
     };
-    this.ns$.onChange((ns) => {
+  }
+  static {
+    this.observedAttributes = [
+      ...ShaeElement.observedAttributes,
+      ATTR_LOCAL,
+      ATTR_SRC,
+      ATTR_NO_STRUCTURED_CLONE,
+      ATTR_AUTO_SYNC,
+      ATTR_EXPOSE_TO_MODEL_CONTEXT
+    ];
+  }
+  static {
+    this.DefaultAutoSync = "frame";
+  }
+  #logger;
+  /** The logger this element reports through. */
+  get logger() {
+    return this.#logger;
+  }
+  #started;
+  #autoSync;
+  #importScript;
+  #modelContextExposure;
+  /** The `redact-props` attribute as a list of property names, read as it stands right now. */
+  get redactProps() {
+    return readListAttribute(this, ATTR_REDACT_PROPS);
+  }
+  /**
+   * This element's share of the page's model-context registration, while it has one: a promise
+   * of the `ExposeHandle`, resolving once the tools are on the platform (`available: false` where
+   * there is none) and rejecting with what `registerTool()` rejected with. `undefined` without
+   * the `expose-to-model-context` attribute, before the first connect, and after a teardown.
+   */
+  get modelContextExposure() {
+    return this.#modelContextExposure?.handle;
+  }
+  /**
+   * Points the environment at the namespace this element names.
+   *
+   * It hangs on `ns$`, which belongs to the base class and outlives this element's teardown, so
+   * the handle is kept and released by hand — a listener left on a living signal is a listener the
+   * global signal queue goes on holding, and with it this element.
+   */
+  #envViewBinding;
+  /**
+   * Take the subscriptions up. Runs exactly once for this element, on the first connect.
+   *
+   * The return that `restore()` stands for on `<shae-ent>` and `<shae-prop>` does not exist here:
+   * `connectedCallback` turns a torn-down `<shae-worker>` away, so nothing ever calls this a second
+   * time.
+   *
+   * One path runs ahead of it, and it is the only one: `start()` is public, and an element started
+   * by hand while it is out of the document builds its environment before anything below is
+   * listening. Two things are lost there and stay lost, because both are moments rather than
+   * values, and there is no honest way to replay a moment that has passed:
+   *
+   * - the `contextcreated` — and, should the environment lose its connection first, the
+   *   `contextlost` — DOM event for that environment. `ShadowEnv.ContextCreated` fires once, with
+   *   nobody on the element listening for it; re-dispatching it from here would announce as new an
+   *   environment that has been up for a while.
+   * - the namespace the environment points at, where `ns` changed between that `start()` and the
+   *   first connect. `start()` resolves the view once with `??=`, the binding below only reacts to
+   *   *changes*, and the change already happened. `shadowEnv.view` then names the context of the
+   *   namespace the element carried when it was started. A write of `ns` after the first connect
+   *   moves it, as it always does.
+   *
+   * A `<shae-worker>` that connects before it starts — the ordinary way, and the only way the
+   * declarative form has — meets neither. The import of `src` is the one case of this shape that
+   * *is* caught up, at the end of this method, because a pending import is a value and not a
+   * moment.
+   */
+  restore() {
+    super.restore();
+    this.#envViewBinding = this.ns$.onChange((ns) => {
       this.shadowEnv.view = ComponentContext.get(ns);
     });
     on(this.shadowEnv, ShadowEnv.ContextCreated, () => {
@@ -60,7 +159,24 @@ class ShaeWorkerElement extends ShaeElement {
         })
       );
     });
-    this.autoSync$.onChange((sVal) => {
+    on(this.shadowEnv, ShadowEnv.SyncFailed, (reason, changeTrail) => {
+      this.dispatchEvent(
+        new CustomEvent(ShadowEnv.SyncFailed.toLowerCase(), {
+          bubbles: false,
+          detail: { shadowEnv: this.shadowEnv, reason, changeTrail }
+        })
+      );
+    });
+    this.autoSync$.onChange((sVal) => this.#reflectAutoSync(sVal));
+    this.#reflectAutoSync(this.autoSync$.value);
+    this.#createAutoSyncEffect();
+    this.#createImportScriptEffect();
+    if (this.shadowEnv.isReady) {
+      this.#importScript?.run();
+    }
+  }
+  #reflectAutoSync(sVal) {
+    this.reflectAttribute(ATTR_AUTO_SYNC, () => {
       const hasAttr = this.hasAttribute(ATTR_AUTO_SYNC);
       const attrVal = hasAttr ? this.getAttribute(ATTR_AUTO_SYNC) : void 0;
       if (sVal === ShaeWorkerElement.DefaultAutoSync) {
@@ -71,27 +187,7 @@ class ShaeWorkerElement extends ShaeElement {
         this.setAttribute(ATTR_AUTO_SYNC, sVal);
       }
     });
-    this.#createAutoSyncEffect();
-    this.#createImportScriptEffect();
-    this.style.display = "contents";
-  }
-  static {
-    this.observedAttributes = [
-      ...ShaeElement.observedAttributes,
-      ATTR_LOCAL,
-      ATTR_SRC,
-      ATTR_NO_STRUCTURED_CLONE,
-      ATTR_AUTO_SYNC
-    ];
-  }
-  static {
-    this.DefaultAutoSync = "frame";
   }
-  #shouldDestroy;
-  #started;
-  #frameLoop;
-  #autoSync;
-  #importScript;
   #createImportScriptEffect() {
     this.#importScript = createEffect(
       () => {
@@ -111,14 +207,10 @@ class ShaeWorkerElement extends ShaeElement {
     return this.autoSync$.value;
   }
   set autoSync(val) {
-    if (typeof val !== "string") {
-      val = val ? ShaeWorkerElement.DefaultAutoSync : "no";
-    }
-    this.autoSync$.set(`${val}`.trim().toLowerCase());
+    this.autoSync$.set(normaliseAutoSync(val));
   }
   get frameLoop() {
-    this.#frameLoop ??= new FrameLoop();
-    return this.#frameLoop;
+    return FrameLoop.get();
   }
   /**
    * The frameLoop (if activated) calls this method on every frame
@@ -131,9 +223,7 @@ class ShaeWorkerElement extends ShaeElement {
       throw new Error("src is blank");
     }
     const shadowEnv = await this.shadowEnv.ready();
-    if (this.logger.isInfo) {
-      this.logger.info("shadowEnv importScript:", src, { shadowEnv });
-    }
+    this.logger.info("shadowEnv importScript:", src, { shadowEnv });
     const envProxy = shadowEnv.envProxy;
     if (envProxy == null) {
       throw new ShadowEnvDestroyedError();
@@ -142,33 +232,40 @@ class ShaeWorkerElement extends ShaeElement {
     return this;
   }
   connectedCallback() {
-    batch(() => {
-      const autoSync = this.getAttribute(ATTR_AUTO_SYNC);
-      if (autoSync != null) {
-        this.autoSync$.set(autoSync);
+    hibernate(() => {
+      if (this.isDestroyed) {
+        ensureDisplayContentsRule(this.getRootNode(), this.localName);
+        return;
+      }
+      super.connectedCallback();
+      batch(() => {
+        const autoSync = this.getAttribute(ATTR_AUTO_SYNC);
+        if (autoSync != null) {
+          this.autoSync = autoSync;
+        }
+        this.isConnected$.set(true);
+      });
+      if (this.shouldAutostart) {
+        this.start().catch(this.#onUnobservedRejection);
       }
-      this.isConnected$.set(true);
+      this.#syncModelContextExposure();
     });
-    if (this.shouldAutostart) {
-      this.start().catch(this.#onUnobservedRejection);
-    }
   }
   disconnectedCallback() {
     this.isConnected$.set(false);
-    this.#deferDestroy();
+    super.disconnectedCallback();
   }
   attributeChangedCallback(name) {
+    if (this.isDestroyed) return;
     super.attributeChangedCallback(name);
     if (name === ATTR_LOCAL) {
-      if (this.shadowEnv.envProxy != null) {
-        throw new Error('Changing the "local" attribute after the shadowEnv has been created is not supported.');
-      }
+      this.#refuseLocalChange();
     }
     if (name === ATTR_NO_STRUCTURED_CLONE) {
       this.#disableStructuredClone();
     }
     if (name === ATTR_AUTO_SYNC) {
-      this.autoSync = this.hasAttribute(ATTR_AUTO_SYNC) ? this.getAttribute(ATTR_AUTO_SYNC) : true;
+      this.autoSync = this.getAttribute(ATTR_AUTO_SYNC) ?? true;
     }
     if (name === ATTR_SRC) {
       const src = (this.getAttribute(ATTR_SRC) || "").trim();
@@ -177,13 +274,30 @@ class ShaeWorkerElement extends ShaeElement {
         this.#importScript?.run();
       }
     }
+    if (name === ATTR_EXPOSE_TO_MODEL_CONTEXT) {
+      this.#syncModelContextExposure();
+    }
+  }
+  /**
+   * The timeout attributes, read at the one moment they are needed: when the worker environment
+   * is built. An attribute that is not there is left out, so the environment keeps its default,
+   * and a value the environment does not accept is reported there. They are not observed —
+   * setting one afterwards changes nothing about an environment that already exists, and a
+   * `local` element builds no worker environment at all, so they do nothing there.
+   */
+  #readWorkerTimeouts() {
+    const options = {};
+    for (const [key, attr] of WorkerTimeoutAttributes) {
+      const value = readNumberAttribute(this, attr);
+      if (value !== void 0) options[key] = value;
+    }
+    return options;
   }
   start() {
     if (!this.#started) {
-      this.#shouldDestroy = false;
       this.shadowEnv.view ??= ComponentContext.get(this.ns);
       if (this.shadowEnv.envProxy == null) {
-        const envProxy = readBooleanAttribute(this, ATTR_LOCAL) ? new LocalShadowObjectEnv() : new RemoteWorkerEnv();
+        const envProxy = readBooleanAttribute(this, ATTR_LOCAL) ? new LocalShadowObjectEnv() : new RemoteWorkerEnv(this.#readWorkerTimeouts());
         this.shadowEnv.envProxy = envProxy;
         this.#disableStructuredClone();
       }
@@ -191,41 +305,49 @@ class ShaeWorkerElement extends ShaeElement {
     }
     return this.shadowEnv.ready();
   }
-  destroy() {
+  /**
+   * Tear this element down — for good.
+   *
+   * The effects and signals below belong to the element alone, so the element is what decides
+   * whether they have already been released; the guard for that sits in
+   * `ShaeLifecycleElement.destroy()`, which has already set the flag by the time this runs. Here
+   * that matters more than anywhere else: `shadowEnv.destroy()` dispatches a `contextlost`
+   * `CustomEvent` on this element on its way out, and a listener on it that reaches back into
+   * `destroy()` finds the flag down and turns around instead of tearing the same environment down
+   * a second time.
+   *
+   * Unlike `<shae-ent>` and `<shae-prop>`, this teardown is final: it destroys the signals and
+   * takes the environment down with them, and neither comes back. `connectedCallback` turns a
+   * returning element away rather than handing it a half of what it had, which is what makes
+   * {@link ShaeWorkerElement.restore} a method that runs once and never again.
+   */
+  teardown() {
+    this.#leaveModelContextExposure();
+    this.#envViewBinding?.();
+    this.#envViewBinding = void 0;
     this.#autoSync?.destroy();
     this.#importScript?.destroy();
     destroySignal(this.isConnected$, this.autoSync$, this.src$);
     this.shadowEnv.envProxy = void 0;
     this.shadowEnv.destroy();
-  }
-  #deferDestroy() {
-    if (!this.#shouldDestroy) {
-      this.#shouldDestroy = true;
-      queueMicrotask(() => {
-        if (this.#shouldDestroy) {
-          this.destroy();
-        }
-      });
-    }
+    super.teardown();
   }
   #createAutoSyncEffect() {
     this.#autoSync = createEffect(() => {
       if (this.isConnected$.get()) {
-        const autoSync = (this.autoSync$.get() || ShaeWorkerElement.DefaultAutoSync).trim().toLowerCase();
+        const autoSync = normaliseAutoSync(this.autoSync$.get() || ShaeWorkerElement.DefaultAutoSync);
         let delay;
         if (["true", "yes", "on", "frame", "auto-sync"].includes(autoSync)) {
-          if (this.logger.isDebug) {
-            this.logger.debug("auto-sync", autoSync, this);
-          }
+          this.logger.debug("auto-sync", autoSync, this);
           this.frameLoop.start(this);
           return () => {
             this.frameLoop.stop(this);
           };
-        } else if (autoSync.toLowerCase().endsWith("fps")) {
+        } else if (autoSync.endsWith("fps")) {
           const fps = parseInt(autoSync, 10);
           if (fps > 0) {
             delay = Math.floor(1e3 / fps);
-          } else if (this.logger.isWarn) {
+          } else {
             this.logger.warn(`invalid auto-sync value: ${autoSync}`);
           }
         } else {
@@ -238,16 +360,14 @@ class ShaeWorkerElement extends ShaeElement {
           }
         }
         if (delay !== void 0 && delay > 0) {
-          if (this.logger.isDebug) {
-            this.logger.debug("auto-sync interval (ms)", delay, this);
-          }
+          this.logger.debug("auto-sync interval (ms)", delay, this);
           const id = setInterval(() => {
             this.syncShadowObjects();
           }, delay);
           return () => {
             clearInterval(id);
           };
-        } else if (this.logger.isDebug) {
+        } else {
           this.logger.debug("auto-sync off", this);
         }
       }
@@ -259,6 +379,84 @@ class ShaeWorkerElement extends ShaeElement {
       env.disableStructuredClone = this.hasAttribute(ATTR_NO_STRUCTURED_CLONE);
     }
   }
+  /**
+   * `local` picks the environment kind once, at `start()`. The proxy, its kernel and its
+   * entities all belong to the side they were built on, and there is no way to move them onto
+   * the other one afterwards — a later write to this attribute is refused, not carried out.
+   *
+   * A throw from this reaction would not reach the caller of `setAttribute` either way: per spec,
+   * a Custom Element reaction reports its own exceptions to the global `error` event instead of
+   * propagating them synchronously, so a `try`/`catch` around the write would catch nothing. The
+   * refusal writes the attribute back through `reflectAttribute`, the one path this element uses
+   * to write its own attributes from inside, and reports the refusal separately through the
+   * `ConsoleLogger`. `logger.error` and not `logger.warn`: `logger.error` always prints, where
+   * `logger.warn` is gated behind `isWarn`, which is off outside `localhost`, and a refusal that
+   * goes silent there is exactly what this call needs to avoid.
+   *
+   * The write back re-enters `attributeChangedCallback` once, where the attribute now matches
+   * the effective state and the check below returns before logging again. On an element built
+   * and started by hand while it was never in the document, that write is parked until the first
+   * connect (see `reflectAttribute`), while the log line above runs immediately.
+   */
+  #refuseLocalChange() {
+    const envProxy = this.shadowEnv.envProxy;
+    if (envProxy == null) return;
+    const isLocalEnv = Boolean(envProxy.isLocalEnv);
+    if (readBooleanAttribute(this, ATTR_LOCAL) === isLocalEnv) return;
+    this.logger.error(
+      `the "local" attribute cannot change once the shadowEnv is built; it is reset to ${isLocalEnv ? 'the bare "local" form' : "its absence"} \u2014 build a new <shae-worker> element to switch environments`
+    );
+    this.reflectAttribute(ATTR_LOCAL, () => {
+      if (isLocalEnv) {
+        this.setAttribute(ATTR_LOCAL, "");
+      } else {
+        this.removeAttribute(ATTR_LOCAL);
+      }
+    });
+  }
+  /**
+   * Joins or leaves the page's model-context registration, whichever the attribute and the
+   * element's state ask for. The attribute is a truthy attribute like `local`; the join waits
+   * for a connect, because an element that is never connected has no environment to expose, and
+   * it ends with the teardown. `redact-props` is not watched: the share reads it at every call.
+   */
+  #syncModelContextExposure() {
+    const wanted = !this.isDestroyed && this.isConnected && readBooleanAttribute(this, ATTR_EXPOSE_TO_MODEL_CONTEXT);
+    if (wanted) {
+      this.#joinModelContextExposure();
+    } else {
+      this.#leaveModelContextExposure();
+    }
+  }
+  /**
+   * The share is an ordinary call of `exposeShadowEnvsToModelContext()` with two live rules:
+   * this element's namespace, and the names its `redact-props` attribute carries at the moment
+   * a tool asks. The function comes in through a dynamic import, and that is the whole reason
+   * this element can carry the attribute at all -- a static import would pull the model-context
+   * layer into every consumer of `<shae-worker>`, and the layer is meant to stay out of
+   * `index.ts` and the worker bundle. The single-file bundle inlines the import; the lib layout
+   * keeps the modules apart. A leave before the import is back aborts the signal the call is
+   * made with, and the function registers nothing for an aborted signal.
+   */
+  #joinModelContextExposure() {
+    if (this.#modelContextExposure !== void 0) return;
+    const controller = new AbortController();
+    const handle = import("../model-context/exposeShadowEnvsToModelContext.js").then(
+      ({ exposeShadowEnvsToModelContext }) => exposeShadowEnvsToModelContext({
+        signal: controller.signal,
+        namespaces: (ns) => ns === this.ns,
+        redactProps: (name) => this.redactProps.includes(name)
+      })
+    );
+    this.#modelContextExposure = { controller, handle };
+    handle.catch((error) => this.logger.error("expose-to-model-context: registering the tools failed", error));
+  }
+  #leaveModelContextExposure() {
+    const exposure = this.#modelContextExposure;
+    if (exposure === void 0) return;
+    this.#modelContextExposure = void 0;
+    exposure.controller.abort();
+  }
 }
 export {
   ShaeWorkerElement

package/src/elements/ShaeWorkerElement.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/elements/ShaeWorkerElement.ts"],
-  "sourcesContent": ["import {on} from '@spearwolf/eventize';\nimport {batch, createEffect, createSignal, destroySignal, Effect} from '@spearwolf/signalize';\nimport {readBooleanAttribute} from '../utils/attr-utils.js';\nimport {ConsoleLogger} from '../utils/ConsoleLogger.js';\nimport {FrameLoop} from '../utils/FrameLoop.js';\nimport {ComponentContext} from '../view/ComponentContext.js';\nimport {LocalShadowObjectEnv} from '../view/LocalShadowObjectEnv.js';\nimport {RemoteWorkerEnv} from '../view/RemoteWorkerEnv.js';\nimport {ShadowEnv, ShadowEnvDestroyedError} from '../view/ShadowEnv.js';\nimport {ATTR_AUTO_SYNC, ATTR_LOCAL, ATTR_NO_AUTOSTART, ATTR_NO_STRUCTURED_CLONE, ATTR_SRC} from './constants.js';\nimport {ShaeElement} from './ShaeElement.js';\n\nexport class ShaeWorkerElement extends ShaeElement {\n  static override observedAttributes = [\n    ...ShaeElement.observedAttributes,\n    ATTR_LOCAL,\n    ATTR_SRC,\n    ATTR_NO_STRUCTURED_CLONE,\n    ATTR_AUTO_SYNC,\n  ];\n\n  static DefaultAutoSync = 'frame';\n\n  readonly isShaeWorkerElement = true;\n\n  readonly shadowEnv = new ShadowEnv();\n\n  readonly logger = new ConsoleLogger('ShaeWorkerElement');\n\n  autostart = true;\n\n  isConnected$ = createSignal(false);\n  autoSync$ = createSignal(ShaeWorkerElement.DefaultAutoSync);\n  src$ = createSignal('');\n\n  #shouldDestroy = false;\n  #started = false;\n\n  #frameLoop?: FrameLoop;\n  #autoSync?: Effect;\n  #importScript?: Effect;\n\n  constructor() {\n    super();\n\n    this.ns$.onChange((ns) => {\n      this.shadowEnv.view = ComponentContext.get(ns);\n    });\n\n    on(this.shadowEnv, ShadowEnv.ContextCreated, () => {\n      this.#importScript?.run();\n      this.dispatchEvent(\n        new CustomEvent(ShadowEnv.ContextCreated.toLowerCase(), {\n          bubbles: false,\n          detail: {shadowEnv: this.shadowEnv},\n        }),\n      );\n    });\n\n    on(this.shadowEnv, ShadowEnv.ContextLost, () => {\n      this.dispatchEvent(\n        new CustomEvent(ShadowEnv.ContextLost.toLowerCase(), {\n          bubbles: false,\n          detail: {shadowEnv: this.shadowEnv},\n        }),\n      );\n    });\n\n    on(this.shadowEnv, ShadowEnv.ProxyFailed, (reason: unknown) => {\n      this.dispatchEvent(\n        new CustomEvent(ShadowEnv.ProxyFailed.toLowerCase(), {\n          bubbles: false,\n          detail: {shadowEnv: this.shadowEnv, reason},\n        }),\n      );\n    });\n\n    this.autoSync$.onChange((sVal) => {\n      const hasAttr = this.hasAttribute(ATTR_AUTO_SYNC);\n      const attrVal = hasAttr ? this.getAttribute(ATTR_AUTO_SYNC) : undefined;\n\n      if (sVal === ShaeWorkerElement.DefaultAutoSync) {\n        if (hasAttr && attrVal !== sVal) {\n          this.setAttribute(ATTR_AUTO_SYNC, sVal);\n        }\n      } else if (attrVal !== sVal) {\n        this.setAttribute(ATTR_AUTO_SYNC, sVal);\n      }\n    });\n\n    this.#createAutoSyncEffect();\n    this.#createImportScriptEffect();\n\n    this.style.display = 'contents';\n  }\n\n  #createImportScriptEffect() {\n    this.#importScript = createEffect(\n      () => {\n        const src = this.src$.get();\n        if (src) {\n          this.importScript(src).catch(this.#onUnobservedRejection);\n        }\n      },\n      {autorun: false},\n    );\n  }\n\n  /**\n   * Both {@link ShaeWorkerElement.start} and {@link ShaeWorkerElement.importScript} await\n   * {@link ShadowEnv.ready}, which rejects once the environment is destroyed \u2014 the normal\n   * outcome for an element that connects and disconnects within the same task. Nothing in the\n   * element waits on those promises, so the rejection has to end here instead of surfacing as\n   * an unhandled rejection in the browser or as a hard failure in a test runner.\n   */\n  #onUnobservedRejection = (error: unknown) => {\n    if (error instanceof ShadowEnvDestroyedError) return;\n    this.logger.error('shadowEnv failed', error);\n  };\n\n  get shouldAutostart(): boolean {\n    return this.autostart && !readBooleanAttribute(this, ATTR_NO_AUTOSTART);\n  }\n\n  get autoSync() {\n    return this.autoSync$.value;\n  }\n\n  set autoSync(val: any) {\n    if (typeof val !== 'string') {\n      val = val ? ShaeWorkerElement.DefaultAutoSync : 'no';\n    }\n    this.autoSync$.set(`${val}`.trim().toLowerCase());\n  }\n\n  get frameLoop(): FrameLoop {\n    this.#frameLoop ??= new FrameLoop();\n    return this.#frameLoop;\n  }\n\n  /**\n   * The frameLoop (if activated) calls this method on every frame\n   */\n  [FrameLoop.OnFrame]() {\n    this.syncShadowObjects();\n  }\n\n  async importScript(src: URL | string): Promise<ShaeWorkerElement> {\n    if (!src) {\n      throw new Error('src is blank');\n    }\n    const shadowEnv = await this.shadowEnv.ready();\n    if (this.logger.isInfo) {\n      this.logger.info('shadowEnv importScript:', src, {shadowEnv});\n    }\n    // ready() only vouches for the proxy at the moment it resolves; a teardown can slip in\n    // between that microtask and this line\n    const envProxy = shadowEnv.envProxy;\n    if (envProxy == null) {\n      throw new ShadowEnvDestroyedError();\n    }\n\n    await envProxy.importScript(src);\n    return this;\n  }\n\n  connectedCallback() {\n    batch(() => {\n      const autoSync = this.getAttribute(ATTR_AUTO_SYNC);\n      if (autoSync != null) {\n        this.autoSync$.set(autoSync);\n      }\n      this.isConnected$.set(true);\n    });\n    if (this.shouldAutostart) {\n      this.start().catch(this.#onUnobservedRejection);\n    }\n  }\n\n  disconnectedCallback() {\n    this.isConnected$.set(false);\n    this.#deferDestroy();\n  }\n\n  override attributeChangedCallback(name: string) {\n    super.attributeChangedCallback(name);\n\n    if (name === ATTR_LOCAL) {\n      if (this.shadowEnv.envProxy != null) {\n        throw new Error('Changing the \"local\" attribute after the shadowEnv has been created is not supported.');\n      }\n    }\n\n    if (name === ATTR_NO_STRUCTURED_CLONE) {\n      this.#disableStructuredClone();\n    }\n\n    if (name === ATTR_AUTO_SYNC) {\n      this.autoSync = this.hasAttribute(ATTR_AUTO_SYNC) ? this.getAttribute(ATTR_AUTO_SYNC) : true;\n    }\n\n    if (name === ATTR_SRC) {\n      const src = (this.getAttribute(ATTR_SRC) || '').trim();\n      this.src$.set(src);\n      if (this.shadowEnv.isReady) {\n        this.#importScript?.run();\n      }\n    }\n  }\n\n  start(): Promise<ShadowEnv> {\n    if (!this.#started) {\n      this.#shouldDestroy = false;\n\n      this.shadowEnv.view ??= ComponentContext.get(this.ns);\n\n      if (this.shadowEnv.envProxy == null) {\n        const envProxy = readBooleanAttribute(this, ATTR_LOCAL) ? new LocalShadowObjectEnv() : new RemoteWorkerEnv();\n        this.shadowEnv.envProxy = envProxy;\n        this.#disableStructuredClone();\n      }\n\n      this.#started = true;\n    }\n\n    return this.shadowEnv.ready();\n  }\n\n  destroy() {\n    this.#autoSync?.destroy();\n    this.#importScript?.destroy();\n    destroySignal(this.isConnected$, this.autoSync$, this.src$);\n    this.shadowEnv.envProxy = undefined;\n    this.shadowEnv.destroy();\n  }\n\n  #deferDestroy() {\n    // NOTE The destruction is halted until the next microtask\u2014but a reconnect (adding the element back to the DOM before the next microtask)\n    //  cannot stop this process, and that's okay. Once destroyed, it's destroyed forever.\n    if (!this.#shouldDestroy) {\n      this.#shouldDestroy = true;\n      queueMicrotask(() => {\n        if (this.#shouldDestroy) {\n          this.destroy();\n        }\n      });\n    }\n  }\n\n  #createAutoSyncEffect() {\n    this.#autoSync = createEffect(() => {\n      if (this.isConnected$.get()) {\n        const autoSync = (this.autoSync$.get() || ShaeWorkerElement.DefaultAutoSync).trim().toLowerCase();\n        let delay;\n\n        if (['true', 'yes', 'on', 'frame', 'auto-sync'].includes(autoSync)) {\n          if (this.logger.isDebug) {\n            this.logger.debug('auto-sync', autoSync, this);\n          }\n          this.frameLoop.start(this);\n          return () => {\n            this.frameLoop.stop(this);\n          };\n        } else if (autoSync.toLowerCase().endsWith('fps')) {\n          const fps = parseInt(autoSync, 10);\n          if (fps > 0) {\n            delay = Math.floor(1000 / fps);\n          } else if (this.logger.isWarn) {\n            this.logger.warn(`invalid auto-sync value: ${autoSync}`);\n          }\n        } else {\n          delay = parseInt(autoSync, 10);\n          if (isNaN(delay)) {\n            delay = undefined;\n            if (!['false', 'no', 'off'].includes(autoSync)) {\n              this.logger.error(`invalid auto-sync value: ${autoSync}`);\n            }\n          }\n        }\n\n        if (delay !== undefined && delay > 0) {\n          if (this.logger.isDebug) {\n            this.logger.debug('auto-sync interval (ms)', delay, this);\n          }\n          const id = setInterval(() => {\n            this.syncShadowObjects();\n          }, delay);\n          return () => {\n            clearInterval(id);\n          };\n        } else if (this.logger.isDebug) {\n          this.logger.debug('auto-sync off', this);\n        }\n      }\n    }, [this.autoSync$, this.isConnected$]);\n  }\n\n  #disableStructuredClone() {\n    const env = this.shadowEnv.envProxy as LocalShadowObjectEnv;\n    if (env?.isLocalEnv) {\n      env.disableStructuredClone = this.hasAttribute(ATTR_NO_STRUCTURED_CLONE);\n    }\n  }\n}"],
-  "mappings": "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",
+  "sourcesContent": ["import {on} from '@spearwolf/eventize';\nimport {batch, createEffect, createSignal, destroySignal, Effect, hibernate} from '@spearwolf/signalize';\nimport type {ExposeHandle} from '../model-context/exposeShadowEnvsToModelContext.js';\nimport {readBooleanAttribute, readListAttribute, readNumberAttribute} from '../utils/attr-utils.js';\nimport {ConsoleLogger} from '../utils/ConsoleLogger.js';\nimport {FrameLoop} from '../utils/FrameLoop.js';\nimport {ComponentContext} from '../view/ComponentContext.js';\nimport {LocalShadowObjectEnv} from '../view/LocalShadowObjectEnv.js';\nimport {RemoteWorkerEnv, type RemoteWorkerEnvOptions} from '../view/RemoteWorkerEnv.js';\nimport {ShadowEnv, ShadowEnvDestroyedError} from '../view/ShadowEnv.js';\nimport {\n  ATTR_AUTO_SYNC,\n  ATTR_CHANGE_TRAIL_TIMEOUT,\n  ATTR_CONFIGURE_TIMEOUT,\n  ATTR_DESTROY_TIMEOUT,\n  ATTR_EXPOSE_TO_MODEL_CONTEXT,\n  ATTR_INSPECT_TIMEOUT,\n  ATTR_LOAD_TIMEOUT,\n  ATTR_LOCAL,\n  ATTR_NO_AUTOSTART,\n  ATTR_NO_STRUCTURED_CLONE,\n  ATTR_REDACT_PROPS,\n  ATTR_SRC,\n} from './constants.js';\nimport {ensureDisplayContentsRule} from './displayContentsRule.js';\nimport {ShaeElement} from './ShaeElement.js';\n\nconst WorkerTimeoutAttributes: [keyof RemoteWorkerEnvOptions, string][] = [\n  ['loadTimeout', ATTR_LOAD_TIMEOUT],\n  ['configureTimeout', ATTR_CONFIGURE_TIMEOUT],\n  ['changeTrailTimeout', ATTR_CHANGE_TRAIL_TIMEOUT],\n  ['inspectTimeout', ATTR_INSPECT_TIMEOUT],\n  ['destroyTimeout', ATTR_DESTROY_TIMEOUT],\n];\n\n/**\n * The one place the `auto-sync` spelling rule lives: a string is trimmed and lower-cased,\n * and anything else is read as a flag \u2014 a truthy value asks for the frame default, a falsy\n * one for no syncing at all. Every write into `autoSync$` this element makes goes through\n * here, so the canonical spelling does not depend on which write ran first.\n */\nfunction normaliseAutoSync(value: unknown): string {\n  if (typeof value !== 'string') {\n    return value ? ShaeWorkerElement.DefaultAutoSync : 'no';\n  }\n  return value.trim().toLowerCase();\n}\n\n/** One element's share of the page's model-context registration: the signal that ends it, the handle it resolves to. */\ninterface ModelContextExposure {\n  controller: AbortController;\n  handle: Promise<ExposeHandle>;\n}\n\nexport class ShaeWorkerElement extends ShaeElement {\n  static override observedAttributes = [\n    ...ShaeElement.observedAttributes,\n    ATTR_LOCAL,\n    ATTR_SRC,\n    ATTR_NO_STRUCTURED_CLONE,\n    ATTR_AUTO_SYNC,\n    ATTR_EXPOSE_TO_MODEL_CONTEXT,\n  ];\n\n  static DefaultAutoSync = 'frame';\n\n  readonly isShaeWorkerElement = true;\n\n  readonly shadowEnv = new ShadowEnv();\n\n  readonly #logger = new ConsoleLogger('ShaeWorkerElement');\n\n  /** The logger this element reports through. */\n  get logger(): ConsoleLogger {\n    return this.#logger;\n  }\n\n  autostart = true;\n\n  isConnected$ = createSignal(false);\n  autoSync$ = createSignal(ShaeWorkerElement.DefaultAutoSync);\n  src$ = createSignal('');\n\n  #started = false;\n\n  #autoSync?: Effect;\n  #importScript?: Effect;\n\n  #modelContextExposure?: ModelContextExposure | undefined;\n\n  /** The `redact-props` attribute as a list of property names, read as it stands right now. */\n  get redactProps(): string[] {\n    return readListAttribute(this, ATTR_REDACT_PROPS);\n  }\n\n  /**\n   * This element's share of the page's model-context registration, while it has one: a promise\n   * of the `ExposeHandle`, resolving once the tools are on the platform (`available: false` where\n   * there is none) and rejecting with what `registerTool()` rejected with. `undefined` without\n   * the `expose-to-model-context` attribute, before the first connect, and after a teardown.\n   */\n  get modelContextExposure(): Promise<ExposeHandle> | undefined {\n    return this.#modelContextExposure?.handle;\n  }\n\n  /**\n   * Points the environment at the namespace this element names.\n   *\n   * It hangs on `ns$`, which belongs to the base class and outlives this element's teardown, so\n   * the handle is kept and released by hand \u2014 a listener left on a living signal is a listener the\n   * global signal queue goes on holding, and with it this element.\n   */\n  #envViewBinding?: (() => void) | undefined;\n\n  /**\n   * Take the subscriptions up. Runs exactly once for this element, on the first connect.\n   *\n   * The return that `restore()` stands for on `<shae-ent>` and `<shae-prop>` does not exist here:\n   * `connectedCallback` turns a torn-down `<shae-worker>` away, so nothing ever calls this a second\n   * time.\n   *\n   * One path runs ahead of it, and it is the only one: `start()` is public, and an element started\n   * by hand while it is out of the document builds its environment before anything below is\n   * listening. Two things are lost there and stay lost, because both are moments rather than\n   * values, and there is no honest way to replay a moment that has passed:\n   *\n   * - the `contextcreated` \u2014 and, should the environment lose its connection first, the\n   *   `contextlost` \u2014 DOM event for that environment. `ShadowEnv.ContextCreated` fires once, with\n   *   nobody on the element listening for it; re-dispatching it from here would announce as new an\n   *   environment that has been up for a while.\n   * - the namespace the environment points at, where `ns` changed between that `start()` and the\n   *   first connect. `start()` resolves the view once with `??=`, the binding below only reacts to\n   *   *changes*, and the change already happened. `shadowEnv.view` then names the context of the\n   *   namespace the element carried when it was started. A write of `ns` after the first connect\n   *   moves it, as it always does.\n   *\n   * A `<shae-worker>` that connects before it starts \u2014 the ordinary way, and the only way the\n   * declarative form has \u2014 meets neither. The import of `src` is the one case of this shape that\n   * *is* caught up, at the end of this method, because a pending import is a value and not a\n   * moment.\n   */\n  protected override restore(): void {\n    super.restore();\n\n    this.#envViewBinding = this.ns$.onChange((ns) => {\n      this.shadowEnv.view = ComponentContext.get(ns);\n    });\n\n    on(this.shadowEnv, ShadowEnv.ContextCreated, () => {\n      this.#importScript?.run();\n      this.dispatchEvent(\n        new CustomEvent(ShadowEnv.ContextCreated.toLowerCase(), {\n          bubbles: false,\n          detail: {shadowEnv: this.shadowEnv},\n        }),\n      );\n    });\n\n    on(this.shadowEnv, ShadowEnv.ContextLost, () => {\n      this.dispatchEvent(\n        new CustomEvent(ShadowEnv.ContextLost.toLowerCase(), {\n          bubbles: false,\n          detail: {shadowEnv: this.shadowEnv},\n        }),\n      );\n    });\n\n    on(this.shadowEnv, ShadowEnv.ProxyFailed, (reason: unknown) => {\n      this.dispatchEvent(\n        new CustomEvent(ShadowEnv.ProxyFailed.toLowerCase(), {\n          bubbles: false,\n          detail: {shadowEnv: this.shadowEnv, reason},\n        }),\n      );\n    });\n\n    on(this.shadowEnv, ShadowEnv.SyncFailed, (reason: unknown, changeTrail: unknown) => {\n      this.dispatchEvent(\n        new CustomEvent(ShadowEnv.SyncFailed.toLowerCase(), {\n          bubbles: false,\n          detail: {shadowEnv: this.shadowEnv, reason, changeTrail},\n        }),\n      );\n    });\n\n    this.autoSync$.onChange((sVal) => this.#reflectAutoSync(sVal));\n\n    // the catch-up half of `restore()`: the signal carries the canonical spelling, and this is\n    // what puts it on the attribute \u2014 `auto-sync=\"YES\"` is what an author writes, `auto-sync=\"yes\"`\n    // is what the element syncs on, and a reader of the DOM sees the second\n    this.#reflectAutoSync(this.autoSync$.value);\n\n    // no catch-up for the namespace binding, and that is deliberate: the environment gets its view\n    // from `start()`, which resolves the namespace at the one moment it needs it. Resolving it here\n    // would build a `ComponentContext` for every `<shae-worker>` that has merely been connected,\n    // and a context that exists is a context entities join\n    this.#createAutoSyncEffect();\n    this.#createImportScriptEffect();\n\n    // a `src` that arrived while the environment was already up \u2014 only reachable through a\n    // `start()` made by hand on an element outside the document \u2014 has nothing that would import it:\n    // the effect is built without an autorun, and both callers that run it were registered a few\n    // lines above. The same test `attributeChangedCallback` makes for `src`\n    if (this.shadowEnv.isReady) {\n      this.#importScript?.run();\n    }\n  }\n\n  #reflectAutoSync(sVal: string): void {\n    this.reflectAttribute(ATTR_AUTO_SYNC, () => {\n      const hasAttr = this.hasAttribute(ATTR_AUTO_SYNC);\n      const attrVal = hasAttr ? this.getAttribute(ATTR_AUTO_SYNC) : undefined;\n\n      if (sVal === ShaeWorkerElement.DefaultAutoSync) {\n        if (hasAttr && attrVal !== sVal) {\n          this.setAttribute(ATTR_AUTO_SYNC, sVal);\n        }\n      } else if (attrVal !== sVal) {\n        this.setAttribute(ATTR_AUTO_SYNC, sVal);\n      }\n    });\n  }\n\n  #createImportScriptEffect() {\n    this.#importScript = createEffect(\n      () => {\n        const src = this.src$.get();\n        if (src) {\n          this.importScript(src).catch(this.#onUnobservedRejection);\n        }\n      },\n      {autorun: false},\n    );\n  }\n\n  /**\n   * Both {@link ShaeWorkerElement.start} and {@link ShaeWorkerElement.importScript} await\n   * {@link ShadowEnv.ready}, which rejects once the environment is destroyed \u2014 the normal\n   * outcome for an element that connects and disconnects within the same task. Nothing in the\n   * element waits on those promises, so the rejection has to end here instead of surfacing as\n   * an unhandled rejection in the browser or as a hard failure in a test runner.\n   */\n  #onUnobservedRejection = (error: unknown) => {\n    if (error instanceof ShadowEnvDestroyedError) return;\n    this.logger.error('shadowEnv failed', error);\n  };\n\n  get shouldAutostart(): boolean {\n    return this.autostart && !readBooleanAttribute(this, ATTR_NO_AUTOSTART);\n  }\n\n  get autoSync() {\n    return this.autoSync$.value;\n  }\n\n  set autoSync(val: string | boolean | number) {\n    this.autoSync$.set(normaliseAutoSync(val));\n  }\n\n  get frameLoop(): FrameLoop {\n    return FrameLoop.get();\n  }\n\n  /**\n   * The frameLoop (if activated) calls this method on every frame\n   */\n  [FrameLoop.OnFrame]() {\n    this.syncShadowObjects();\n  }\n\n  async importScript(src: URL | string): Promise<ShaeWorkerElement> {\n    if (!src) {\n      throw new Error('src is blank');\n    }\n    const shadowEnv = await this.shadowEnv.ready();\n    this.logger.info('shadowEnv importScript:', src, {shadowEnv});\n    // ready() only vouches for the proxy at the moment it resolves; a teardown can slip in\n    // between that microtask and this line\n    const envProxy = shadowEnv.envProxy;\n    if (envProxy == null) {\n      throw new ShadowEnvDestroyedError();\n    }\n\n    await envProxy.importScript(src);\n    return this;\n  }\n\n  override connectedCallback() {\n    // the whole body outside any reactive context of the caller \u2014 same reason as in\n    // `ShaeLifecycleElement.connectedCallback`, and the frames nest without trouble\n    hibernate(() => {\n      // this element does not come back, and the refusal has to stand in front of `super`: the base\n      // takes an element's subscriptions up there, and for a torn-down one there is nothing to take\n      // up \u2014 the teardown took the environment with it, and an environment cannot be rebuilt around\n      // a proxy that is gone. A `<shae-worker>` that is needed again is a new one.\n      //\n      // How the element renders is a separate question from whether it still listens, so the rule\n      // is installed before the refusal returns\n      if (this.isDestroyed) {\n        ensureDisplayContentsRule(this.getRootNode(), this.localName);\n        return;\n      }\n\n      super.connectedCallback();\n\n      batch(() => {\n        const autoSync = this.getAttribute(ATTR_AUTO_SYNC);\n        if (autoSync != null) {\n          this.autoSync = autoSync;\n        }\n        this.isConnected$.set(true);\n      });\n      if (this.shouldAutostart) {\n        this.start().catch(this.#onUnobservedRejection);\n      }\n      this.#syncModelContextExposure();\n    });\n  }\n\n  override disconnectedCallback() {\n    this.isConnected$.set(false);\n    super.disconnectedCallback();\n  }\n\n  override attributeChangedCallback(name: string) {\n    // the signals of this class are destroyed, so an attribute write would land in a value that\n    // notifies nobody \u2014 and there is no return that would ever read it back\n    if (this.isDestroyed) return;\n\n    super.attributeChangedCallback(name);\n\n    if (name === ATTR_LOCAL) {\n      this.#refuseLocalChange();\n    }\n\n    if (name === ATTR_NO_STRUCTURED_CLONE) {\n      this.#disableStructuredClone();\n    }\n\n    if (name === ATTR_AUTO_SYNC) {\n      this.autoSync = this.getAttribute(ATTR_AUTO_SYNC) ?? true;\n    }\n\n    if (name === ATTR_SRC) {\n      const src = (this.getAttribute(ATTR_SRC) || '').trim();\n      this.src$.set(src);\n      if (this.shadowEnv.isReady) {\n        this.#importScript?.run();\n      }\n    }\n\n    if (name === ATTR_EXPOSE_TO_MODEL_CONTEXT) {\n      this.#syncModelContextExposure();\n    }\n  }\n\n  /**\n   * The timeout attributes, read at the one moment they are needed: when the worker environment\n   * is built. An attribute that is not there is left out, so the environment keeps its default,\n   * and a value the environment does not accept is reported there. They are not observed \u2014\n   * setting one afterwards changes nothing about an environment that already exists, and a\n   * `local` element builds no worker environment at all, so they do nothing there.\n   */\n  #readWorkerTimeouts(): RemoteWorkerEnvOptions {\n    const options: RemoteWorkerEnvOptions = {};\n\n    for (const [key, attr] of WorkerTimeoutAttributes) {\n      const value = readNumberAttribute(this, attr);\n      if (value !== undefined) options[key] = value;\n    }\n\n    return options;\n  }\n\n  start(): Promise<ShadowEnv> {\n    if (!this.#started) {\n      this.shadowEnv.view ??= ComponentContext.get(this.ns);\n\n      if (this.shadowEnv.envProxy == null) {\n        const envProxy = readBooleanAttribute(this, ATTR_LOCAL)\n          ? new LocalShadowObjectEnv()\n          : new RemoteWorkerEnv(this.#readWorkerTimeouts());\n        this.shadowEnv.envProxy = envProxy;\n        this.#disableStructuredClone();\n      }\n\n      this.#started = true;\n    }\n\n    return this.shadowEnv.ready();\n  }\n\n  /**\n   * Tear this element down \u2014 for good.\n   *\n   * The effects and signals below belong to the element alone, so the element is what decides\n   * whether they have already been released; the guard for that sits in\n   * `ShaeLifecycleElement.destroy()`, which has already set the flag by the time this runs. Here\n   * that matters more than anywhere else: `shadowEnv.destroy()` dispatches a `contextlost`\n   * `CustomEvent` on this element on its way out, and a listener on it that reaches back into\n   * `destroy()` finds the flag down and turns around instead of tearing the same environment down\n   * a second time.\n   *\n   * Unlike `<shae-ent>` and `<shae-prop>`, this teardown is final: it destroys the signals and\n   * takes the environment down with them, and neither comes back. `connectedCallback` turns a\n   * returning element away rather than handing it a half of what it had, which is what makes\n   * {@link ShaeWorkerElement.restore} a method that runs once and never again.\n   */\n  protected override teardown() {\n    this.#leaveModelContextExposure();\n\n    this.#envViewBinding?.();\n    this.#envViewBinding = undefined;\n\n    this.#autoSync?.destroy();\n    this.#importScript?.destroy();\n    destroySignal(this.isConnected$, this.autoSync$, this.src$);\n    this.shadowEnv.envProxy = undefined;\n    this.shadowEnv.destroy();\n\n    super.teardown();\n  }\n\n  #createAutoSyncEffect() {\n    this.#autoSync = createEffect(() => {\n      if (this.isConnected$.get()) {\n        const autoSync = normaliseAutoSync(this.autoSync$.get() || ShaeWorkerElement.DefaultAutoSync);\n        let delay;\n\n        if (['true', 'yes', 'on', 'frame', 'auto-sync'].includes(autoSync)) {\n          this.logger.debug('auto-sync', autoSync, this);\n          this.frameLoop.start(this);\n          return () => {\n            this.frameLoop.stop(this);\n          };\n        } else if (autoSync.endsWith('fps')) {\n          const fps = parseInt(autoSync, 10);\n          if (fps > 0) {\n            delay = Math.floor(1000 / fps);\n          } else {\n            this.logger.warn(`invalid auto-sync value: ${autoSync}`);\n          }\n        } else {\n          delay = parseInt(autoSync, 10);\n          if (isNaN(delay)) {\n            delay = undefined;\n            if (!['false', 'no', 'off'].includes(autoSync)) {\n              this.logger.error(`invalid auto-sync value: ${autoSync}`);\n            }\n          }\n        }\n\n        if (delay !== undefined && delay > 0) {\n          this.logger.debug('auto-sync interval (ms)', delay, this);\n          const id = setInterval(() => {\n            this.syncShadowObjects();\n          }, delay);\n          return () => {\n            clearInterval(id);\n          };\n        } else {\n          this.logger.debug('auto-sync off', this);\n        }\n      }\n    }, [this.autoSync$, this.isConnected$]);\n  }\n\n  #disableStructuredClone() {\n    const env = this.shadowEnv.envProxy as LocalShadowObjectEnv;\n    if (env?.isLocalEnv) {\n      env.disableStructuredClone = this.hasAttribute(ATTR_NO_STRUCTURED_CLONE);\n    }\n  }\n\n  /**\n   * `local` picks the environment kind once, at `start()`. The proxy, its kernel and its\n   * entities all belong to the side they were built on, and there is no way to move them onto\n   * the other one afterwards \u2014 a later write to this attribute is refused, not carried out.\n   *\n   * A throw from this reaction would not reach the caller of `setAttribute` either way: per spec,\n   * a Custom Element reaction reports its own exceptions to the global `error` event instead of\n   * propagating them synchronously, so a `try`/`catch` around the write would catch nothing. The\n   * refusal writes the attribute back through `reflectAttribute`, the one path this element uses\n   * to write its own attributes from inside, and reports the refusal separately through the\n   * `ConsoleLogger`. `logger.error` and not `logger.warn`: `logger.error` always prints, where\n   * `logger.warn` is gated behind `isWarn`, which is off outside `localhost`, and a refusal that\n   * goes silent there is exactly what this call needs to avoid.\n   *\n   * The write back re-enters `attributeChangedCallback` once, where the attribute now matches\n   * the effective state and the check below returns before logging again. On an element built\n   * and started by hand while it was never in the document, that write is parked until the first\n   * connect (see `reflectAttribute`), while the log line above runs immediately.\n   */\n  #refuseLocalChange(): void {\n    const envProxy = this.shadowEnv.envProxy;\n    if (envProxy == null) return;\n\n    const isLocalEnv = Boolean((envProxy as LocalShadowObjectEnv).isLocalEnv);\n    if (readBooleanAttribute(this, ATTR_LOCAL) === isLocalEnv) return;\n\n    this.logger.error(\n      `the \"local\" attribute cannot change once the shadowEnv is built; it is reset to ${\n        isLocalEnv ? 'the bare \"local\" form' : 'its absence'\n      } \u2014 build a new <shae-worker> element to switch environments`,\n    );\n\n    this.reflectAttribute(ATTR_LOCAL, () => {\n      if (isLocalEnv) {\n        this.setAttribute(ATTR_LOCAL, '');\n      } else {\n        this.removeAttribute(ATTR_LOCAL);\n      }\n    });\n  }\n  /**\n   * Joins or leaves the page's model-context registration, whichever the attribute and the\n   * element's state ask for. The attribute is a truthy attribute like `local`; the join waits\n   * for a connect, because an element that is never connected has no environment to expose, and\n   * it ends with the teardown. `redact-props` is not watched: the share reads it at every call.\n   */\n  #syncModelContextExposure(): void {\n    const wanted = !this.isDestroyed && this.isConnected && readBooleanAttribute(this, ATTR_EXPOSE_TO_MODEL_CONTEXT);\n    if (wanted) {\n      this.#joinModelContextExposure();\n    } else {\n      this.#leaveModelContextExposure();\n    }\n  }\n\n  /**\n   * The share is an ordinary call of `exposeShadowEnvsToModelContext()` with two live rules:\n   * this element's namespace, and the names its `redact-props` attribute carries at the moment\n   * a tool asks. The function comes in through a dynamic import, and that is the whole reason\n   * this element can carry the attribute at all -- a static import would pull the model-context\n   * layer into every consumer of `<shae-worker>`, and the layer is meant to stay out of\n   * `index.ts` and the worker bundle. The single-file bundle inlines the import; the lib layout\n   * keeps the modules apart. A leave before the import is back aborts the signal the call is\n   * made with, and the function registers nothing for an aborted signal.\n   */\n  #joinModelContextExposure(): void {\n    if (this.#modelContextExposure !== undefined) return;\n\n    const controller = new AbortController();\n    const handle = import('../model-context/exposeShadowEnvsToModelContext.js').then(({exposeShadowEnvsToModelContext}) =>\n      exposeShadowEnvsToModelContext({\n        signal: controller.signal,\n        namespaces: (ns) => ns === this.ns,\n        redactProps: (name) => this.redactProps.includes(name),\n      }),\n    );\n    this.#modelContextExposure = {controller, handle};\n\n    // the rejection reaches whoever awaits `modelContextExposure` as well; this makes sure it is heard when nobody does\n    handle.catch((error) => this.logger.error('expose-to-model-context: registering the tools failed', error));\n  }\n\n  #leaveModelContextExposure(): void {\n    const exposure = this.#modelContextExposure;\n    if (exposure === undefined) return;\n    this.#modelContextExposure = undefined;\n    exposure.controller.abort();\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/src/elements/constants.d.ts

@@ -1,16 +1,25 @@
 export declare const RequestEntParentEventName = "shaeRequestEntParent";
 export declare const ReRequestEntParentEventName = "shaeReRequestEntParent";
+export declare const ReRequestEntHostEventName = "shaeReRequestEntHost";
 export declare const SHAE_WORKER = "shae-worker";
 export declare const SHAE_ENT = "shae-ent";
 export declare const SHAE_PROP = "shae-prop";
 export declare const ATTR_TOKEN = "token";
 export declare const ATTR_FORWARD_CUSTOM_EVENTS = "forward-custom-events";
+export declare const ATTR_AUTO_DESTRUCT = "auto-destruct";
 export declare const ATTR_NS = "ns";
 export declare const ATTR_LOCAL = "local";
 export declare const ATTR_NO_AUTOSTART = "no-autostart";
 export declare const ATTR_NO_STRUCTURED_CLONE = "no-structured-clone";
 export declare const ATTR_AUTO_SYNC = "auto-sync";
 export declare const ATTR_SRC = "src";
+export declare const ATTR_LOAD_TIMEOUT = "load-timeout";
+export declare const ATTR_CONFIGURE_TIMEOUT = "configure-timeout";
+export declare const ATTR_CHANGE_TRAIL_TIMEOUT = "change-trail-timeout";
+export declare const ATTR_INSPECT_TIMEOUT = "inspect-timeout";
+export declare const ATTR_DESTROY_TIMEOUT = "destroy-timeout";
+export declare const ATTR_EXPOSE_TO_MODEL_CONTEXT = "expose-to-model-context";
+export declare const ATTR_REDACT_PROPS = "redact-props";
 export declare const ATTR_NAME = "name";
 export declare const ATTR_VALUE = "value";
 export declare const ATTR_TYPE = "type";

package/src/elements/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/elements/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAChE,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AAEpE,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,SAAS,cAAc,CAAC;AAGrC,eAAO,MAAM,UAAU,UAAU,CAAC;AAClC,eAAO,MAAM,0BAA0B,0BAA0B,CAAC;AAGlE,eAAO,MAAM,OAAO,OAAO,CAAC;AAG5B,eAAO,MAAM,UAAU,UAAU,CAAC;AAClC,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAC9D,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAG9B,eAAO,MAAM,SAAS,SAAS,CAAC;AAChC,eAAO,MAAM,UAAU,UAAU,CAAC;AAClC,eAAO,MAAM,SAAS,SAAS,CAAC;AAChC,eAAO,MAAM,YAAY,YAAY,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/elements/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAChE,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AACpE,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAEhE,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,SAAS,cAAc,CAAC;AAGrC,eAAO,MAAM,UAAU,UAAU,CAAC;AAClC,eAAO,MAAM,0BAA0B,0BAA0B,CAAC;AAClE,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAGlD,eAAO,MAAM,OAAO,OAAO,CAAC;AAG5B,eAAO,MAAM,UAAU,UAAU,CAAC;AAClC,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAC9D,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAC1D,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAChE,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AACtE,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAGhD,eAAO,MAAM,SAAS,SAAS,CAAC;AAChC,eAAO,MAAM,UAAU,UAAU,CAAC;AAClC,eAAO,MAAM,SAAS,SAAS,CAAC;AAChC,eAAO,MAAM,YAAY,YAAY,CAAC"}