@spearwolf/shadow-objects 0.34.0 → 0.35.0

package/package.json

@@ -2,7 +2,7 @@
   "name": "@spearwolf/shadow-objects",
   "description": "a reactive entity-component framework that feels at home in the shadows",
   "homepage": "https://github.com/spearwolf/shadow-objects/",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "author": {
     "name": "Wolfger Schramm",
     "email": "wolfger@spearwolf.de",
@@ -58,6 +58,14 @@
     "./FrameLoop.js": {
       "import": "./src/utils/FrameLoop.js",
       "types": "./src/utils/FrameLoop.d.ts"
+    },
+    "./model-context.js": {
+      "import": "./src/model-context.js",
+      "types": "./src/model-context.d.ts"
+    },
+    "./testing.js": {
+      "import": "./src/testing.js",
+      "types": "./src/testing.d.ts"
     }
   },
   "sideEffects": [

package/src/WorkerTimeoutError.d.ts

@@ -2,13 +2,14 @@ import type { WorkerReplyType } from './constants.js';
 /**
  * The reason a reply from the worker did not arrive in time.
  *
- * Four replies of a `RemoteWorkerEnv` have a deadline, and `messageType` names the one that stayed
+ * Five replies of a `RemoteWorkerEnv` have a deadline, and `messageType` names the one that stayed
  * out: the `Loaded` greeting of the load handshake, the `ImportedModule` answer to an
  * `importScript()`, the `AppliedChangeTrail` confirmation of a change trail sent with
- * `waitForConfirmation`, and the `Destroyed` receipt of a teardown.
+ * `waitForConfirmation`, the `Inspected` answer to an `inspect()`, and the `Destroyed` receipt of
+ * a teardown.
  *
  * `timeout` carries the number of milliseconds that were waited, so a diagnosis knows which of the
- * four values was in force without reaching for the `timeouts` of the `RemoteWorkerEnv`.
+ * five values was in force without reaching for the `timeouts` of the `RemoteWorkerEnv`.
  *
  * The error says nothing about what the worker did with the request. A confirmation window that
  * ran out leaves a Shadow Environment that may well have applied the whole change trail, which is

package/src/WorkerTimeoutError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerTimeoutError.d.ts","sourceRoot":"","sources":["../../src/WorkerTimeoutError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,gBAAgB,CAAC;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAEtC,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,YAAY,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAKxD;CACF"}
+{"version":3,"file":"WorkerTimeoutError.d.ts","sourceRoot":"","sources":["../../src/WorkerTimeoutError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,gBAAgB,CAAC;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAEtC,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,YAAY,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAKxD;CACF"}

package/src/WorkerTimeoutError.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/WorkerTimeoutError.ts"],
-  "sourcesContent": ["import type {WorkerReplyType} from './constants.js';\n\n/**\n * The reason a reply from the worker did not arrive in time.\n *\n * Four replies of a `RemoteWorkerEnv` have a deadline, and `messageType` names the one that stayed\n * out: the `Loaded` greeting of the load handshake, the `ImportedModule` answer to an\n * `importScript()`, the `AppliedChangeTrail` confirmation of a change trail sent with\n * `waitForConfirmation`, and the `Destroyed` receipt of a teardown.\n *\n * `timeout` carries the number of milliseconds that were waited, so a diagnosis knows which of the\n * four values was in force without reaching for the `timeouts` of the `RemoteWorkerEnv`.\n *\n * The error says nothing about what the worker did with the request. A confirmation window that\n * ran out leaves a Shadow Environment that may well have applied the whole change trail, which is\n * why `ShadowEnv` books it as applied; `ChangeTrailRefusedError` is the only refusal that names a\n * number.\n */\nexport class WorkerTimeoutError extends Error {\n  /** the type of the message that did not arrive */\n  readonly messageType: WorkerReplyType;\n\n  /** how many milliseconds were waited for it */\n  readonly timeout: number;\n\n  constructor(messageType: WorkerReplyType, timeout: number) {\n    super(`no ${messageType} message arrived from the worker within ${timeout}ms`);\n    this.name = 'WorkerTimeoutError';\n    this.messageType = messageType;\n    this.timeout = timeout;\n  }\n}\n"],
-  "mappings": "AAkBO,MAAM,2BAA2B,MAAM;AAAA,EAO5C,YAAY,aAA8B,SAAiB;AACzD,UAAM,MAAM,WAAW,2CAA2C,OAAO,IAAI;AAC7E,SAAK,OAAO;AACZ,SAAK,cAAc;AACnB,SAAK,UAAU;AAAA,EACjB;AACF;",
+  "sourcesContent": ["import type {WorkerReplyType} from './constants.js';\n\n/**\n * The reason a reply from the worker did not arrive in time.\n *\n * Five replies of a `RemoteWorkerEnv` have a deadline, and `messageType` names the one that stayed\n * out: the `Loaded` greeting of the load handshake, the `ImportedModule` answer to an\n * `importScript()`, the `AppliedChangeTrail` confirmation of a change trail sent with\n * `waitForConfirmation`, the `Inspected` answer to an `inspect()`, and the `Destroyed` receipt of\n * a teardown.\n *\n * `timeout` carries the number of milliseconds that were waited, so a diagnosis knows which of the\n * five values was in force without reaching for the `timeouts` of the `RemoteWorkerEnv`.\n *\n * The error says nothing about what the worker did with the request. A confirmation window that\n * ran out leaves a Shadow Environment that may well have applied the whole change trail, which is\n * why `ShadowEnv` books it as applied; `ChangeTrailRefusedError` is the only refusal that names a\n * number.\n */\nexport class WorkerTimeoutError extends Error {\n  /** the type of the message that did not arrive */\n  readonly messageType: WorkerReplyType;\n\n  /** how many milliseconds were waited for it */\n  readonly timeout: number;\n\n  constructor(messageType: WorkerReplyType, timeout: number) {\n    super(`no ${messageType} message arrived from the worker within ${timeout}ms`);\n    this.name = 'WorkerTimeoutError';\n    this.messageType = messageType;\n    this.timeout = timeout;\n  }\n}\n"],
+  "mappings": "AAmBO,MAAM,2BAA2B,MAAM;AAAA,EAO5C,YAAY,aAA8B,SAAiB;AACzD,UAAM,MAAM,WAAW,2CAA2C,OAAO,IAAI;AAC7E,SAAK,OAAO;AACZ,SAAK,cAAc;AACnB,SAAK,UAAU;AAAA,EACjB;AACF;",
   "names": []
 }

package/src/constants.d.ts

@@ -22,18 +22,21 @@ export declare const VoidToken = "#void";
 export declare const ContextLost = "contextLost";
 export declare const Configure = "configure";
 export declare const ChangeTrail = "changeTrail";
+export declare const Inspect = "inspect";
 export declare const Destroy = "destroy";
 export declare const Loaded = "loaded";
 export declare const AppliedChangeTrail = "appliedChangeTrail";
 export declare const ImportedModule = "importedModule";
 export declare const Destroyed = "destroyed";
+export declare const Inspected = "inspected";
 /**
- * The four replies a `RemoteWorkerEnv` waits for, each behind a deadline of its own: the `Loaded`
+ * The five replies a `RemoteWorkerEnv` waits for, each behind a deadline of its own: the `Loaded`
  * greeting of the load handshake, the `ImportedModule` answer to an `importScript()`, the
- * `AppliedChangeTrail` confirmation of a change trail sent with `waitForConfirmation`, and the
- * `Destroyed` receipt of a teardown. A `switch` over the four is exhaustive.
+ * `AppliedChangeTrail` confirmation of a change trail sent with `waitForConfirmation`, the
+ * `Inspected` answer to an `inspect()`, and the `Destroyed` receipt of a teardown. A `switch` over
+ * the five is exhaustive.
  */
-export type WorkerReplyType = typeof Loaded | typeof AppliedChangeTrail | typeof ImportedModule | typeof Destroyed;
+export type WorkerReplyType = typeof Loaded | typeof AppliedChangeTrail | typeof ImportedModule | typeof Inspected | typeof Destroyed;
 /**
  * The `messageToView` event is fired when the kernel receives a message from an entity (to its view component counterpart)
  */
@@ -41,6 +44,7 @@ export declare const MessageToView = "messageToView";
 export declare const WorkerLoadTimeout = 60000;
 export declare const WorkerConfigureTimeout = 60000;
 export declare const WorkerChangeTrailTimeout = 5000;
+export declare const WorkerInspectTimeout = 5000;
 export declare const WorkerDestroyTimeout = 5000;
 export declare const ShadowObjectsExport = "shadowObjects";
 //# sourceMappingURL=constants.d.ts.map

package/src/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,YAAY,CAAC;AAE9C,oBAAY,gBAAgB;IAC1B,iBAAiB,IAAI;IACrB,cAAc,IAAA;IACd,OAAO,IAAA;CACR;AAED,oBAAY,mBAAmB;IAC7B,cAAc,IAAI;IAClB,eAAe,IAAA;IACf,SAAS,IAAA;IACT,WAAW,IAAA;IACX,gBAAgB,IAAA;IAChB,WAAW,IAAA;IACX,UAAU,IAAA;CACX;AAED,eAAO,MAAM,QAAQ,EAAE,aAAmD,CAAC;AAE3E,eAAO,MAAM,SAAS,UAAU,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,OAAO,YAAY,CAAC;AAEjC,eAAO,MAAM,MAAM,WAAW,CAAC;AAC/B,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,SAAS,cAAc,CAAC;AAErC;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,MAAM,GAAG,OAAO,kBAAkB,GAAG,OAAO,cAAc,GAAG,OAAO,SAAS,CAAC;AAEnH;;GAEG;AACH,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AACvC,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAC5C,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,eAAO,MAAM,mBAAmB,kBAAkB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,YAAY,CAAC;AAE9C,oBAAY,gBAAgB;IAC1B,iBAAiB,IAAI;IACrB,cAAc,IAAA;IACd,OAAO,IAAA;CACR;AAED,oBAAY,mBAAmB;IAC7B,cAAc,IAAI;IAClB,eAAe,IAAA;IACf,SAAS,IAAA;IACT,WAAW,IAAA;IACX,gBAAgB,IAAA;IAChB,WAAW,IAAA;IACX,UAAU,IAAA;CACX;AAED,eAAO,MAAM,QAAQ,EAAE,aAAmD,CAAC;AAE3E,eAAO,MAAM,SAAS,UAAU,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,OAAO,YAAY,CAAC;AACjC,eAAO,MAAM,OAAO,YAAY,CAAC;AAEjC,eAAO,MAAM,MAAM,WAAW,CAAC;AAC/B,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,SAAS,cAAc,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,MAAM,GACb,OAAO,kBAAkB,GACzB,OAAO,cAAc,GACrB,OAAO,SAAS,GAChB,OAAO,SAAS,CAAC;AAErB;;GAEG;AACH,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AACvC,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAC5C,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,eAAO,MAAM,mBAAmB,kBAAkB,CAAC"}

package/src/constants.js

@@ -19,15 +19,18 @@ const VoidToken = "#void";
 const ContextLost = "contextLost";
 const Configure = "configure";
 const ChangeTrail = "changeTrail";
+const Inspect = "inspect";
 const Destroy = "destroy";
 const Loaded = "loaded";
 const AppliedChangeTrail = "appliedChangeTrail";
 const ImportedModule = "importedModule";
 const Destroyed = "destroyed";
+const Inspected = "inspected";
 const MessageToView = "messageToView";
 const WorkerLoadTimeout = 6e4;
 const WorkerConfigureTimeout = 6e4;
 const WorkerChangeTrailTimeout = 5e3;
+const WorkerInspectTimeout = 5e3;
 const WorkerDestroyTimeout = 5e3;
 const ShadowObjectsExport = "shadowObjects";
 export {
@@ -41,6 +44,8 @@ export {
   Destroyed,
   GlobalNS,
   ImportedModule,
+  Inspect,
+  Inspected,
   Loaded,
   MessageToView,
   ShadowObjectsExport,
@@ -48,6 +53,7 @@ export {
   WorkerChangeTrailTimeout,
   WorkerConfigureTimeout,
   WorkerDestroyTimeout,
+  WorkerInspectTimeout,
   WorkerLoadTimeout
 };
 //# sourceMappingURL=constants.js.map

package/src/constants.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/constants.ts"],
-  "sourcesContent": ["import type {NamespaceType} from './types.js';\n\nexport enum ChangeTrailPhase {\n  StructuralChanges = 1,\n  ContentUpdates,\n  Removal,\n}\n\nexport enum ComponentChangeType {\n  CreateEntities = 1,\n  DestroyEntities,\n  SetParent,\n  UpdateOrder,\n  ChangeProperties,\n  ChangeToken,\n  SendEvents,\n}\n\nexport const GlobalNS: NamespaceType = Symbol.for('ShadowObjectsGlobalNS');\n\nexport const VoidToken = '#void';\n\n/**\n * The event is dispatched by `ComponentContext.reCreateChanges` and forwarded to all `ViewComponent`.\n * The event itself has no other data.\n */\nexport const ContextLost = 'contextLost';\n\nexport const Configure = 'configure';\nexport const ChangeTrail = 'changeTrail';\nexport const Destroy = 'destroy';\n\nexport const Loaded = 'loaded';\nexport const AppliedChangeTrail = 'appliedChangeTrail';\nexport const ImportedModule = 'importedModule';\nexport const Destroyed = 'destroyed';\n\n/**\n * The four replies a `RemoteWorkerEnv` waits for, each behind a deadline of its own: the `Loaded`\n * greeting of the load handshake, the `ImportedModule` answer to an `importScript()`, the\n * `AppliedChangeTrail` confirmation of a change trail sent with `waitForConfirmation`, and the\n * `Destroyed` receipt of a teardown. A `switch` over the four is exhaustive.\n */\nexport type WorkerReplyType = typeof Loaded | typeof AppliedChangeTrail | typeof ImportedModule | typeof Destroyed;\n\n/**\n * The `messageToView` event is fired when the kernel receives a message from an entity (to its view component counterpart)\n */\nexport const MessageToView = 'messageToView';\n\nexport const WorkerLoadTimeout = 60000;\nexport const WorkerConfigureTimeout = 60000;\nexport const WorkerChangeTrailTimeout = 5000;\nexport const WorkerDestroyTimeout = 5000;\n\nexport const ShadowObjectsExport = 'shadowObjects';\n"],
-  "mappings": "AAEO,IAAK,mBAAL,kBAAKA,sBAAL;AACL,EAAAA,oCAAA,uBAAoB,KAApB;AACA,EAAAA,oCAAA;AACA,EAAAA,oCAAA;AAHU,SAAAA;AAAA,GAAA;AAML,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,0CAAA,oBAAiB,KAAjB;AACA,EAAAA,0CAAA;AACA,EAAAA,0CAAA;AACA,EAAAA,0CAAA;AACA,EAAAA,0CAAA;AACA,EAAAA,0CAAA;AACA,EAAAA,0CAAA;AAPU,SAAAA;AAAA,GAAA;AAUL,MAAM,WAA0B,uBAAO,IAAI,uBAAuB;AAElE,MAAM,YAAY;AAMlB,MAAM,cAAc;AAEpB,MAAM,YAAY;AAClB,MAAM,cAAc;AACpB,MAAM,UAAU;AAEhB,MAAM,SAAS;AACf,MAAM,qBAAqB;AAC3B,MAAM,iBAAiB;AACvB,MAAM,YAAY;AAalB,MAAM,gBAAgB;AAEtB,MAAM,oBAAoB;AAC1B,MAAM,yBAAyB;AAC/B,MAAM,2BAA2B;AACjC,MAAM,uBAAuB;AAE7B,MAAM,sBAAsB;",
+  "sourcesContent": ["import type {NamespaceType} from './types.js';\n\nexport enum ChangeTrailPhase {\n  StructuralChanges = 1,\n  ContentUpdates,\n  Removal,\n}\n\nexport enum ComponentChangeType {\n  CreateEntities = 1,\n  DestroyEntities,\n  SetParent,\n  UpdateOrder,\n  ChangeProperties,\n  ChangeToken,\n  SendEvents,\n}\n\nexport const GlobalNS: NamespaceType = Symbol.for('ShadowObjectsGlobalNS');\n\nexport const VoidToken = '#void';\n\n/**\n * The event is dispatched by `ComponentContext.reCreateChanges` and forwarded to all `ViewComponent`.\n * The event itself has no other data.\n */\nexport const ContextLost = 'contextLost';\n\nexport const Configure = 'configure';\nexport const ChangeTrail = 'changeTrail';\nexport const Inspect = 'inspect';\nexport const Destroy = 'destroy';\n\nexport const Loaded = 'loaded';\nexport const AppliedChangeTrail = 'appliedChangeTrail';\nexport const ImportedModule = 'importedModule';\nexport const Destroyed = 'destroyed';\nexport const Inspected = 'inspected';\n\n/**\n * The five replies a `RemoteWorkerEnv` waits for, each behind a deadline of its own: the `Loaded`\n * greeting of the load handshake, the `ImportedModule` answer to an `importScript()`, the\n * `AppliedChangeTrail` confirmation of a change trail sent with `waitForConfirmation`, the\n * `Inspected` answer to an `inspect()`, and the `Destroyed` receipt of a teardown. A `switch` over\n * the five is exhaustive.\n */\nexport type WorkerReplyType =\n  | typeof Loaded\n  | typeof AppliedChangeTrail\n  | typeof ImportedModule\n  | typeof Inspected\n  | typeof Destroyed;\n\n/**\n * The `messageToView` event is fired when the kernel receives a message from an entity (to its view component counterpart)\n */\nexport const MessageToView = 'messageToView';\n\nexport const WorkerLoadTimeout = 60000;\nexport const WorkerConfigureTimeout = 60000;\nexport const WorkerChangeTrailTimeout = 5000;\nexport const WorkerInspectTimeout = 5000;\nexport const WorkerDestroyTimeout = 5000;\n\nexport const ShadowObjectsExport = 'shadowObjects';\n"],
+  "mappings": "AAEO,IAAK,mBAAL,kBAAKA,sBAAL;AACL,EAAAA,oCAAA,uBAAoB,KAApB;AACA,EAAAA,oCAAA;AACA,EAAAA,oCAAA;AAHU,SAAAA;AAAA,GAAA;AAML,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,0CAAA,oBAAiB,KAAjB;AACA,EAAAA,0CAAA;AACA,EAAAA,0CAAA;AACA,EAAAA,0CAAA;AACA,EAAAA,0CAAA;AACA,EAAAA,0CAAA;AACA,EAAAA,0CAAA;AAPU,SAAAA;AAAA,GAAA;AAUL,MAAM,WAA0B,uBAAO,IAAI,uBAAuB;AAElE,MAAM,YAAY;AAMlB,MAAM,cAAc;AAEpB,MAAM,YAAY;AAClB,MAAM,cAAc;AACpB,MAAM,UAAU;AAChB,MAAM,UAAU;AAEhB,MAAM,SAAS;AACf,MAAM,qBAAqB;AAC3B,MAAM,iBAAiB;AACvB,MAAM,YAAY;AAClB,MAAM,YAAY;AAmBlB,MAAM,gBAAgB;AAEtB,MAAM,oBAAoB;AAC1B,MAAM,yBAAyB;AAC/B,MAAM,2BAA2B;AACjC,MAAM,uBAAuB;AAC7B,MAAM,uBAAuB;AAE7B,MAAM,sBAAsB;",
   "names": ["ChangeTrailPhase", "ComponentChangeType"]
 }

package/src/elements/ShaePropElement.d.ts

@@ -45,6 +45,14 @@ export declare class ShaePropElement extends ShaeLifecycleElement {
     /** The logger this element reports through: a subclass reads it and does not replace it. */
     protected get logger(): ConsoleLogger;
     get name(): string | undefined;
+    /**
+     * Writes the `name` attribute, and `attributeChangedCallback` takes it from there: the attribute
+     * is the one source the name is read from, so a write through the property and a write through
+     * `setAttribute` end up in the same place and are trimmed by the same rule. A framework renderer
+     * assigns every prop it finds `in` the element as a property — React 19 and Vue 3 both do — and
+     * a name it cannot assign is a property that never binds.
+     */
+    set name(name: string | undefined);
     get value(): unknown;
     set value(val: unknown);
     get shouldTrim(): boolean;
@@ -55,12 +63,13 @@ export declare class ShaePropElement extends ShaeLifecycleElement {
     /**
      * Take this element's own subscriptions up. Its half of {@link ShaeLifecycleElement.restore}.
      *
-     * There is nothing to catch up on here, unlike `<shae-ent>`: `connectedCallback` reads `value`,
-     * `name`, `type` and `no-trim` off the attributes and looks the host up again straight after
-     * this, so the attributes decide, and whatever was written to a released element through
-     * `prop.value` or `prop.entNode` is replaced by what the tree and the markup say. That is this
-     * element's rule in and out of a teardown alike — a `<shae-prop>` reads its position on every
-     * connect — and the documentation states it as the difference it is.
+     * There is nothing to catch up on here, unlike `<shae-ent>`: `connectedCallback` reads `name`,
+     * `type` and `no-trim` off the attributes, `value` where the attribute carries one, and looks the
+     * host up again straight after this. So the attributes decide, and whatever was written to a
+     * released element through `prop.entNode` — or through `prop.value` against a `value` attribute
+     * that says something — is replaced by what the tree and the markup say. That is this element's
+     * rule in and out of a teardown alike — a `<shae-prop>` reads its position on every connect — and
+     * the documentation states it as the difference it is.
      */
     protected restore(): void;
     connectedCallback(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"ShaePropElement.d.ts","sourceRoot":"","sources":["../../../src/elements/ShaePropElement.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,aAAa,EAAC,MAAM,2BAA2B,CAAC;AAExD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAI5D,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAC,oBAAoB,EAAC,MAAM,2BAA2B,CAAC;AAuC/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,eAAgB,SAAQ,oBAAoB;;IACvD,MAAM,CAAC,kBAAkB,WAAoD;IAE7E,QAAQ,CAAC,iBAAiB,QAAQ;IAElC,SAAS,CAAC,QAAQ,CAAC,QAAQ,oEAA8C;IACzE,SAAS,CAAC,QAAQ,CAAC,cAAc,mEAA6C;IAE9E,SAAS,CAAC,QAAQ,CAAC,KAAK,4DAAsC;IAC9D,SAAS,CAAC,QAAQ,CAAC,QAAQ,iDAAkB;IAC7C,SAAS,CAAC,QAAQ,CAAC,SAAS,iDAAkB;IAC9C,SAAS,CAAC,QAAQ,CAAC,KAAK,4DAAsC;IAC9D,SAAS,CAAC,QAAQ,CAAC,WAAW,iDAAsB;IAIpD,4FAA4F;IAC5F,SAAS,KAAK,MAAM,IAAI,aAAa,CAEpC;IAqCD,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,KAAK,CAAC,GAAG,EAAE,OAAO,EAErB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,OAAO,IAAI,cAAc,GAAG,SAAS,CAExC;IAED,IAAI,OAAO,CAAC,EAAE,EAAE,cAAc,GAAG,SAAS,EAEzC;IAED,IAAI,aAAa,IAAI,aAAa,GAAG,SAAS,CAE7C;IAED,cAWC;IAyHD;;;;;;;;;OASG;IACH,UAAmB,OAAO,IAAI,IAAI,CAIjC;IAEQ,iBAAiB,SAezB;IAED,wBAAwB,CAAC,IAAI,EAAE,MAAM,QAkBpC;IAEQ,oBAAoB,SAU5B;IAED;;;;;;OAMG;IACH,UAAmB,QAAQ,IAAI,IAAI,CAgBlC;CAiHF"}
+{"version":3,"file":"ShaePropElement.d.ts","sourceRoot":"","sources":["../../../src/elements/ShaePropElement.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,aAAa,EAAC,MAAM,2BAA2B,CAAC;AAExD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAI5D,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAC,oBAAoB,EAAC,MAAM,2BAA2B,CAAC;AAuC/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,eAAgB,SAAQ,oBAAoB;;IACvD,MAAM,CAAC,kBAAkB,WAAoD;IAE7E,QAAQ,CAAC,iBAAiB,QAAQ;IAElC,SAAS,CAAC,QAAQ,CAAC,QAAQ,oEAA8C;IACzE,SAAS,CAAC,QAAQ,CAAC,cAAc,mEAA6C;IAE9E,SAAS,CAAC,QAAQ,CAAC,KAAK,4DAAsC;IAC9D,SAAS,CAAC,QAAQ,CAAC,QAAQ,iDAAkB;IAC7C,SAAS,CAAC,QAAQ,CAAC,SAAS,iDAAkB;IAC9C,SAAS,CAAC,QAAQ,CAAC,KAAK,4DAAsC;IAC9D,SAAS,CAAC,QAAQ,CAAC,WAAW,iDAAsB;IAIpD,4FAA4F;IAC5F,SAAS,KAAK,MAAM,IAAI,aAAa,CAEpC;IAqCD,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED;;;;;;OAMG;IACH,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAOhC;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,KAAK,CAAC,GAAG,EAAE,OAAO,EAErB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,OAAO,IAAI,cAAc,GAAG,SAAS,CAExC;IAED,IAAI,OAAO,CAAC,EAAE,EAAE,cAAc,GAAG,SAAS,EAEzC;IAED,IAAI,aAAa,IAAI,aAAa,GAAG,SAAS,CAE7C;IAED,cAWC;IAyHD;;;;;;;;;;OAUG;IACH,UAAmB,OAAO,IAAI,IAAI,CAIjC;IAEQ,iBAAiB,SAsBzB;IAED,wBAAwB,CAAC,IAAI,EAAE,MAAM,QAkBpC;IAEQ,oBAAoB,SAU5B;IAED;;;;;;OAMG;IACH,UAAmB,QAAQ,IAAI,IAAI,CAgBlC;CAuHF"}

package/src/elements/ShaePropElement.js

@@ -127,6 +127,11 @@ class ShaePropElement extends ShaeLifecycleElement {
       const value = this.getAttribute(ATTR_VALUE);
       this.valueIn$.set(value === null || value === "" ? void 0 : value);
     };
+    /** Whether the `value` attribute says something — absent and empty are the same "nothing" here. */
+    this.#valueAttributeCarriesValue = () => {
+      const value = this.getAttribute(ATTR_VALUE);
+      return value !== null && value !== "";
+    };
     this.#readTypeAttribute = () => {
       let type = this.getAttribute(ATTR_TYPE)?.trim().toLowerCase();
       if (type && !propValueConverters.has(type)) {
@@ -170,6 +175,21 @@ class ShaePropElement extends ShaeLifecycleElement {
   get name() {
     return this.name$.value;
   }
+  /**
+   * Writes the `name` attribute, and `attributeChangedCallback` takes it from there: the attribute
+   * is the one source the name is read from, so a write through the property and a write through
+   * `setAttribute` end up in the same place and are trimmed by the same rule. A framework renderer
+   * assigns every prop it finds `in` the element as a property — React 19 and Vue 3 both do — and
+   * a name it cannot assign is a property that never binds.
+   */
+  set name(name) {
+    const trimmed = name?.trim();
+    if (!trimmed) {
+      this.removeAttribute(ATTR_NAME);
+    } else if (this.getAttribute(ATTR_NAME) !== trimmed) {
+      this.setAttribute(ATTR_NAME, trimmed);
+    }
+  }
   get value() {
     return this.valueOut$.value;
   }
@@ -264,12 +284,13 @@ class ShaePropElement extends ShaeLifecycleElement {
   /**
    * Take this element's own subscriptions up. Its half of {@link ShaeLifecycleElement.restore}.
    *
-   * There is nothing to catch up on here, unlike `<shae-ent>`: `connectedCallback` reads `value`,
-   * `name`, `type` and `no-trim` off the attributes and looks the host up again straight after
-   * this, so the attributes decide, and whatever was written to a released element through
-   * `prop.value` or `prop.entNode` is replaced by what the tree and the markup say. That is this
-   * element's rule in and out of a teardown alike — a `<shae-prop>` reads its position on every
-   * connect — and the documentation states it as the difference it is.
+   * There is nothing to catch up on here, unlike `<shae-ent>`: `connectedCallback` reads `name`,
+   * `type` and `no-trim` off the attributes, `value` where the attribute carries one, and looks the
+   * host up again straight after this. So the attributes decide, and whatever was written to a
+   * released element through `prop.entNode` — or through `prop.value` against a `value` attribute
+   * that says something — is replaced by what the tree and the markup say. That is this element's
+   * rule in and out of a teardown alike — a `<shae-prop>` reads its position on every connect — and
+   * the documentation states it as the difference it is.
    */
   restore() {
     super.restore();
@@ -281,7 +302,9 @@ class ShaePropElement extends ShaeLifecycleElement {
       batch(() => {
         this.#findEntNode();
         this.#readNameAttribute();
-        this.#readValueAttribute();
+        if (this.#valueAttributeCarriesValue()) {
+          this.#readValueAttribute();
+        }
         this.#readTypeAttribute();
         this.#readNoTrimAttribute();
       });
@@ -334,6 +357,7 @@ class ShaePropElement extends ShaeLifecycleElement {
   #disconnectFromEntNode;
   #readNameAttribute;
   #readValueAttribute;
+  #valueAttributeCarriesValue;
   #readTypeAttribute;
   #readNoTrimAttribute;
 }

package/src/elements/ShaePropElement.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/elements/ShaePropElement.ts"],
-  "sourcesContent": ["import {batch, createEffect, createSignal, Effect, hibernate, link} from '@spearwolf/signalize';\nimport {readBooleanAttribute} from '../utils/attr-utils.js';\nimport {ConsoleLogger} from '../utils/ConsoleLogger.js';\nimport {MicrotaskGate} from '../utils/MicrotaskGate.js';\nimport type {ViewComponent} from '../view/ViewComponent.js';\nimport {ATTR_NAME, ATTR_NO_TRIM, ATTR_TYPE, ATTR_VALUE, ReRequestEntHostEventName} from './constants.js';\nimport {propValueConverters} from './propValueConverters.js';\nimport {requestEntAncestor} from './requestEntAncestor.js';\nimport type {ShaeEntElement} from './ShaeEntElement.js';\nimport {ShaeLifecycleElement} from './ShaeLifecycleElement.js';\n\n/**\n * How many `<shae-prop>` elements declare a given name on a given view component right now.\n *\n * A property belongs to the entity, not to the element that wrote it last: two elements may\n * declare the same name, and the entity keeps the property until the last of them lets go. The\n * count is keyed the way the binding is \u2014 (view component, name) \u2014 and lives beside the elements\n * because no single one of them can answer the question.\n */\nconst declarantsPerComponent = new WeakMap<ViewComponent, Map<string, number>>();\n\nconst addDeclarant = (vc: ViewComponent, name: string) => {\n  let names = declarantsPerComponent.get(vc);\n  if (names == null) {\n    names = new Map();\n    declarantsPerComponent.set(vc, names);\n  }\n  names.set(name, (names.get(name) ?? 0) + 1);\n};\n\n/** @returns `true` if this was the last element declaring `name` on `vc`. */\nconst removeDeclarant = (vc: ViewComponent, name: string): boolean => {\n  const names = declarantsPerComponent.get(vc);\n  if (names == null) return true;\n\n  const remaining = (names.get(name) ?? 1) - 1;\n  if (remaining > 0) {\n    names.set(name, remaining);\n    return false;\n  }\n\n  names.delete(name);\n  if (names.size === 0) {\n    declarantsPerComponent.delete(vc);\n  }\n  return true;\n};\n\n/**\n * Sets a property on the entity above it.\n *\n * Unlike `<shae-ent>` and `<shae-worker>`, this element does not extend `ShaeElement` and has no\n * namespace of its own. It shares their lifecycle: `ShaeLifecycleElement` is the base of all three,\n * and `destroy()`, `isDestroyed`, `restore()` and `teardown()` mean the same thing on every one of\n * them. What it does not share is the layer above it. `ShaeElement` exists for elements that pick\n * an environment: their `ns` attribute names the one they live in, and what they do goes there by\n * default \u2014 `ShaeElement.syncShadowObjectsOf()` is the explicit way to reach a different one, as\n * `<shae-ent>` does on a namespace change. A property picks nothing. It belongs to the closest\n * entity above it in the flattened tree, whatever namespace that entity happens to be in \u2014\n * proximity decides, not membership. An `ns` on a `<shae-prop>` would therefore be an attribute\n * that changes no answer, and the convention both siblings follow \u2014 spreading\n * `ShaeElement.observedAttributes` into their own \u2014 would put it into `observedAttributes` for\n * every reader to trip over.\n *\n * That is also why the sync runs through the host: the environment that has to hear about a\n * property is the one the host entity lives in, and this element is the wrong place to ask.\n * `entNode.syncShadowObjects()` reaches it; a sync of this element's own would target the\n * global namespace instead \u2014 nothing happens if no environment answers to that, and if one\n * does, it still leaves the namespaced host waiting.\n *\n * The marker for this element is `isShaePropElement`, beside `isShaeEntElement` and\n * `isShaeWorkerElement`. Each names one tag for consumers and tests to check \u2014 this file's own\n * spec included \u2014 not for the host lookup itself: that is decided by `ShaeEntElement`'s\n * `#onRequestParent`, the only listener registered for the request, and it checks `requester`,\n * `answer` and `ns`, never a flag. A `<shae-prop>` never answers a host request because it never\n * listens for one, not because its marker reads differently.\n */\nexport class ShaePropElement extends ShaeLifecycleElement {\n  static observedAttributes = [ATTR_NAME, ATTR_VALUE, ATTR_TYPE, ATTR_NO_TRIM];\n\n  readonly isShaePropElement = true;\n\n  protected readonly entNode$ = createSignal<ShaeEntElement | undefined>();\n  protected readonly viewComponent$ = createSignal<ViewComponent | undefined>();\n\n  protected readonly name$ = createSignal<string | undefined>();\n  protected readonly valueIn$ = createSignal();\n  protected readonly valueOut$ = createSignal();\n  protected readonly type$ = createSignal<string | undefined>();\n  protected readonly shouldTrim$ = createSignal(true);\n\n  readonly #logger = new ConsoleLogger('ShaePropElement');\n\n  /** The logger this element reports through: a subclass reads it and does not replace it. */\n  protected get logger(): ConsoleLogger {\n    return this.#logger;\n  }\n\n  /** Binds this element to the entity above it, and carries that entity's component through. */\n  #hostBinding?: (() => void) | undefined;\n\n  /** Holds the property on the entity for as long as this element declares it. */\n  #declareProperty?: Effect | undefined;\n\n  /** Writes the value through to the entity. */\n  #writePropertyValue?: Effect | undefined;\n\n  /** Turns what the attribute spells into the value the property carries. */\n  #convertValue?: Effect | undefined;\n\n  /** Whether the missing-host warning has already gone out for this element. */\n  #reportedMissingHost = false;\n\n  /** The node this element listens on for a re-request of the host, so the listener can come off the same one. */\n  #reRequestHostTarget?: EventTarget | undefined;\n\n  // Two terms, and they answer two different questions. `isConnected` separates an element in\n  // the tree from one on its way out: a round booked before the departure has nothing left to\n  // say about a position the element no longer holds. `isDestroyed` separates one that is\n  // listening from one that was ended by hand and is still standing where it was \u2014 a lookup\n  // running there would write `entNode$` and register the re-request listener again that the\n  // teardown just took off, and the element would be listening after it let go of everything.\n  // The flag is up before `teardown()` runs, so a round that comes due afterwards reads the\n  // state the element is actually in.\n  //\n  // The test stands here and not in the gate: a `MicrotaskGate` has no way to call a booking\n  // off, and that is the whole of what tells it apart from `DeferredTeardown`.\n  readonly #hostLookup = new MicrotaskGate(() => {\n    if (this.isConnected && !this.isDestroyed) {\n      this.#findEntNode();\n    }\n  });\n\n  get name(): string | undefined {\n    return this.name$.value;\n  }\n\n  get value(): unknown {\n    return this.valueOut$.value;\n  }\n\n  set value(val: unknown) {\n    this.valueIn$.set(val);\n  }\n\n  get shouldTrim(): boolean {\n    return this.shouldTrim$.value;\n  }\n\n  get entNode(): ShaeEntElement | undefined {\n    return this.entNode$.value;\n  }\n\n  set entNode(el: ShaeEntElement | undefined) {\n    this.entNode$.set(el);\n  }\n\n  get viewComponent(): ViewComponent | undefined {\n    return this.viewComponent$.value;\n  }\n\n  constructor() {\n    super();\n\n    // read with nothing listening yet: what this puts into the signals is the state the attributes\n    // already spell out, and the effects read it on their first run at the first connect\n    batch(() => {\n      this.#readNameAttribute();\n      this.#readValueAttribute();\n      this.#readTypeAttribute();\n      this.#readNoTrimAttribute();\n    });\n  }\n\n  /**\n   * Take up everything this element listens to.\n   *\n   * Called from {@link ShaePropElement.restore} and from nowhere else \u2014 that is the one place where\n   * this element's subscriptions begin, at the first connect as well as after a teardown.\n   */\n  #subscribe(): void {\n    this.#hostBinding = this.entNode$.onChange((entNode) => {\n      if (entNode) {\n        const con = link(entNode.viewComponent$, this.viewComponent$);\n        return () => {\n          con.destroy();\n        };\n      } else {\n        this.viewComponent$.set(undefined);\n      }\n    });\n\n    // The binding this element holds is the pair (view component, name). It ends in three ways \u2014\n    // the element leaves the tree, its name changes, or it moves to another entity \u2014 and each of\n    // them moves one of these two signals. The cleanup takes the property back for exactly the\n    // binding that ended, which is why the three need no code of their own.\n    //\n    // `valueOut$` is deliberately not read here: a value change would otherwise run a removal\n    // against a set of the same key on every keystroke.\n    //\n    // Standing before the value effect is a matter of reading order, not of behaviour: the order a\n    // rename ends up with in the trail is decided in `ComponentChanges.#propsChangeOrder`, where\n    // `appendToEnd` moves a key that is already queued to the back. Measured both ways, the trail\n    // reads `[['x', undefined], ['y', 7]]` either way.\n    this.#declareProperty = createEffect(() => {\n      const vc = this.viewComponent$.get();\n      const name = this.name$.get();\n\n      if (vc == null || !name) return;\n\n      // untracked on purpose: the host is where the sync has to go, not something this binding\n      // depends on. And it is the host and not this element, because the host carries the\n      // namespace \u2014 the environment holding this property is its, and nothing else knows which.\n      const entNode = this.entNode$.value;\n\n      addDeclarant(vc, name);\n\n      return () => {\n        // only the last declarant clears the property \u2014 another element may be holding the same\n        // name on the same entity, and the entity is what the property belongs to\n        if (removeDeclarant(vc, name)) {\n          vc.removeProperty(name);\n          // no `isConnected` guard, unlike the value effect below: an element that is no longer\n          // connected is precisely the case this has to reach\n          entNode?.syncShadowObjects();\n        }\n      };\n    });\n\n    this.#writePropertyValue = createEffect(() => {\n      const vc = this.viewComponent$.get();\n      if (vc) {\n        const name = this.name$.get();\n        if (name) {\n          const value = this.valueOut$.get();\n\n          this.logger.debug(`[${this.name}] view-component set-property`, name, value, vc.uuid, {\n            viewComponent: vc,\n            shaeProp: this,\n          });\n\n          vc.setProperty(name, value);\n\n          if (this.isConnected) {\n            this.entNode?.syncShadowObjects();\n          }\n        }\n      }\n    });\n\n    this.#convertValue = createEffect(() => {\n      const type = this.type$.get();\n      const shouldTrim = this.shouldTrim$.get();\n      let value = this.valueIn$.get();\n\n      if (shouldTrim && typeof value === 'string') {\n        value = value.trim();\n      }\n\n      // only null and undefined mean \"no value\" \u2014 0, false and the empty string are values\n      value = value ?? undefined;\n\n      if (typeof value === 'string' && type) {\n        const convert = propValueConverters.get(type);\n        if (convert != null) {\n          // invalid input is an operating case for this element, not an exceptional state: it is\n          // reported and clears the value instead of throwing out of a reactive effect. A numeric\n          // type throws when its conversion does not come out as a number, and takes the same way\n          // out of here as malformed JSON does.\n          try {\n            value = convert(value);\n          } catch (error) {\n            // reported through `error`, not `warn`: `warn` is gated behind\n            // `ConsoleLogger.sharedConfig.enable`, which defaults to \"the page is served from a\n            // loopback host\". A dropped property value has to stay visible in production too.\n            this.logger.error(`[${this.name}] could not convert the value into the type \"${type}\"`, {\n              value,\n              error,\n              shaeProp: this,\n            });\n            value = undefined;\n          }\n        }\n        // an unrecognized type name \u2014 `convert == null` \u2014 passes the string through untouched and\n        // unreported here. `type$` is `protected`; the only writer in this repository is\n        // `#readTypeAttribute`, which already warns for every unknown name it sees, so this branch\n        // stays silent on purpose rather than warning a second time for the same name.\n      }\n\n      this.valueOut$.set(value);\n    });\n  }\n\n  /**\n   * Take this element's own subscriptions up. Its half of {@link ShaeLifecycleElement.restore}.\n   *\n   * There is nothing to catch up on here, unlike `<shae-ent>`: `connectedCallback` reads `value`,\n   * `name`, `type` and `no-trim` off the attributes and looks the host up again straight after\n   * this, so the attributes decide, and whatever was written to a released element through\n   * `prop.value` or `prop.entNode` is replaced by what the tree and the markup say. That is this\n   * element's rule in and out of a teardown alike \u2014 a `<shae-prop>` reads its position on every\n   * connect \u2014 and the documentation states it as the difference it is.\n   */\n  protected override restore(): void {\n    super.restore();\n\n    this.#subscribe();\n  }\n\n  override connectedCallback() {\n    // the whole body outside any reactive context of the caller, for the reason spelled out in\n    // `ShaeLifecycleElement.connectedCallback`: an `append()` inside a foreign effect would\n    // otherwise own the effects taken up here, and that effect's next run would release them\n    hibernate(() => {\n      super.connectedCallback();\n\n      batch(() => {\n        this.#findEntNode();\n        this.#readNameAttribute();\n        this.#readValueAttribute();\n        this.#readTypeAttribute();\n        this.#readNoTrimAttribute();\n      });\n    });\n  }\n\n  attributeChangedCallback(name: string) {\n    switch (name) {\n      case ATTR_NAME:\n        this.#readNameAttribute();\n        break;\n\n      case ATTR_VALUE:\n        this.#readValueAttribute();\n        break;\n\n      case ATTR_TYPE:\n        this.#readTypeAttribute();\n        break;\n\n      case ATTR_NO_TRIM:\n        this.#readNoTrimAttribute();\n        break;\n    }\n  }\n\n  override disconnectedCallback() {\n    this.#stopListeningForHostChanges();\n    this.#disconnectFromEntNode();\n\n    // last, and the order is not a matter of taste. `#disconnectFromEntNode` queues a microtask of\n    // its own that writes `entNode$`, and microtasks run in the order they were queued: booked\n    // second, the teardown runs second, so the unbinding still reaches a subscription that is on\n    // and the property is taken off the entity it left. The other way round the write would arrive\n    // after the release and reach nobody\n    super.disconnectedCallback();\n  }\n\n  /**\n   * Release this element's own subscriptions. Its half of {@link ShaeLifecycleElement.teardown}.\n   *\n   * The `link()` between the host's `viewComponent$` and this element's own needs no line of its\n   * own: it is built in the cleanup path of the `entNode$` subscription, and taking that\n   * subscription off runs the cleanup that destroys it.\n   */\n  protected override teardown(): void {\n    this.#stopListeningForHostChanges();\n\n    this.#hostBinding?.();\n    this.#hostBinding = undefined;\n\n    this.#declareProperty?.destroy();\n    this.#declareProperty = undefined;\n\n    this.#writePropertyValue?.destroy();\n    this.#writePropertyValue = undefined;\n\n    this.#convertValue?.destroy();\n    this.#convertValue = undefined;\n\n    super.teardown();\n  }\n\n  // Determines the host from where the element stands right now. The request runs *without* a\n  // namespace: a property belongs to the closest entity above it, whatever namespace that entity\n  // is in.\n  //\n  // Nobody answering means there is no entity above this position, and the element says so. A\n  // binding without an answer belongs to a place that is no longer there \u2014 whether the element\n  // moved or the entity above it did. The cleanup on `entNode$` then takes the property off the\n  // entity that no longer holds it, instead of leaving the element writing into an entity it does\n  // not sit under any more.\n  #findEntNode = () => {\n    let found: ShaeEntElement | undefined;\n    requestEntAncestor(this, {answer: (entNode) => (found = entNode)});\n\n    this.entNode$.set(found);\n\n    // Reported once per element, not once per request: the re-request channel repeats this very\n    // lookup, so a property that never gets a host would otherwise report again on every upgrade\n    // happening anywhere above it.\n    //\n    // The `isConnected` term is what separates \"no host\" from \"no position\": an element on its way\n    // out of the tree is not missing a host.\n    //\n    // The limit of this report belongs next to it: `logger.warn` hangs on\n    // `ConsoleLogger.sharedConfig.enable`, which means \"the page is served from a loopback host\" \u2014\n    // elsewhere the case stays silent. `warn` and not `error`, because in the upgrade path this\n    // framework supports by design, \"no entity above me yet\" is a state to pass through: a\n    // <shae-prop> under an element whose tag is registered later reports once and finds its host\n    // right afterwards.\n    if (found == null && this.isConnected && !this.#reportedMissingHost) {\n      this.#reportedMissingHost = true;\n      this.logger.warn(`[${this.name}] no entity above this element, the property is set nowhere`, {\n        shaeProp: this,\n      });\n    }\n\n    this.#listenForHostChanges();\n  };\n\n  // Someone above started or stopped answering. Two things separate this from a lookup the\n  // element makes on arrival, and both belong here, to the trigger \u2014 what an unanswered\n  // request means is the same on either path.\n  //\n  // It waits a microtask: the message arrives while the tree is still moving. An entity that\n  // announces its departure has left, but everything below it can be back in place before the\n  // tick ends, and an ancestor answering *right now* can be one this element is about to\n  // leave behind. Asking after the dust settles is asking once, about the tree that is\n  // actually there.\n  //\n  // And it drops the question if this element has left in the meantime, for the same reason\n  // `#reRequestParent` does in `ShaeEntElement`: an element that is out of the tree answers\n  // nothing about its position any more. Whether its departure is a move or an end is\n  // `#disconnectFromEntNode`'s to answer, one microtask later, and it is answered in one place.\n  // Nothing observable turns on the test \u2014 a departing entity takes its properties with it\n  // either way \u2014 so it stands as a rule, not as a measurement.\n  //\n  // `#hostLookup` bounds the cost: a page filling up with entities sends many messages through the\n  // same ancestor chain, and the gate turns them into one lookup per microtask and per element.\n  #onReRequestHost = () => {\n    this.#hostLookup.schedule();\n  };\n\n  #listenForHostChanges = () => {\n    // bound: the entity itself is on the ascent of every element that could take the property\n    // away from it. Unbound: the document is the one node every such event reaches, out of any\n    // tree, closed roots included\n    const target: EventTarget = this.entNode$.value ?? this.ownerDocument;\n    if (target === this.#reRequestHostTarget) return;\n    this.#stopListeningForHostChanges();\n    target.addEventListener(ReRequestEntHostEventName, this.#onReRequestHost);\n    this.#reRequestHostTarget = target;\n  };\n\n  #stopListeningForHostChanges = () => {\n    this.#reRequestHostTarget?.removeEventListener(ReRequestEntHostEventName, this.#onReRequestHost);\n    this.#reRequestHostTarget = undefined;\n  };\n\n  #disconnectFromEntNode = () => {\n    queueMicrotask(() => {\n      if (!this.isConnected) {\n        this.entNode$.set(undefined);\n      }\n    });\n  };\n\n  #readNameAttribute = () => {\n    this.name$.set(this.getAttribute(ATTR_NAME)?.trim() ?? undefined);\n  };\n\n  #readValueAttribute = () => {\n    // an empty value attribute means \"no value\", exactly like a missing one. Everything else\n    // goes in raw: valueIn$ is the source a no-trim switch recalculates from, so whitespace\n    // has to survive until the trim decides what is left of it.\n    const value = this.getAttribute(ATTR_VALUE);\n    this.valueIn$.set(value === null || value === '' ? undefined : value);\n  };\n\n  #readTypeAttribute = () => {\n    let type = this.getAttribute(ATTR_TYPE)?.trim().toLowerCase();\n    if (type && !propValueConverters.has(type)) {\n      this.logger.warn(`[${this.name}] unknown type \"${type}\"`, {\n        shaeProp: this,\n      });\n      type = undefined;\n    }\n    this.type$.set(type);\n  };\n\n  #readNoTrimAttribute = () => {\n    this.shouldTrim$.set(!readBooleanAttribute(this, ATTR_NO_TRIM));\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {batch, createEffect, createSignal, Effect, hibernate, link} from '@spearwolf/signalize';\nimport {readBooleanAttribute} from '../utils/attr-utils.js';\nimport {ConsoleLogger} from '../utils/ConsoleLogger.js';\nimport {MicrotaskGate} from '../utils/MicrotaskGate.js';\nimport type {ViewComponent} from '../view/ViewComponent.js';\nimport {ATTR_NAME, ATTR_NO_TRIM, ATTR_TYPE, ATTR_VALUE, ReRequestEntHostEventName} from './constants.js';\nimport {propValueConverters} from './propValueConverters.js';\nimport {requestEntAncestor} from './requestEntAncestor.js';\nimport type {ShaeEntElement} from './ShaeEntElement.js';\nimport {ShaeLifecycleElement} from './ShaeLifecycleElement.js';\n\n/**\n * How many `<shae-prop>` elements declare a given name on a given view component right now.\n *\n * A property belongs to the entity, not to the element that wrote it last: two elements may\n * declare the same name, and the entity keeps the property until the last of them lets go. The\n * count is keyed the way the binding is \u2014 (view component, name) \u2014 and lives beside the elements\n * because no single one of them can answer the question.\n */\nconst declarantsPerComponent = new WeakMap<ViewComponent, Map<string, number>>();\n\nconst addDeclarant = (vc: ViewComponent, name: string) => {\n  let names = declarantsPerComponent.get(vc);\n  if (names == null) {\n    names = new Map();\n    declarantsPerComponent.set(vc, names);\n  }\n  names.set(name, (names.get(name) ?? 0) + 1);\n};\n\n/** @returns `true` if this was the last element declaring `name` on `vc`. */\nconst removeDeclarant = (vc: ViewComponent, name: string): boolean => {\n  const names = declarantsPerComponent.get(vc);\n  if (names == null) return true;\n\n  const remaining = (names.get(name) ?? 1) - 1;\n  if (remaining > 0) {\n    names.set(name, remaining);\n    return false;\n  }\n\n  names.delete(name);\n  if (names.size === 0) {\n    declarantsPerComponent.delete(vc);\n  }\n  return true;\n};\n\n/**\n * Sets a property on the entity above it.\n *\n * Unlike `<shae-ent>` and `<shae-worker>`, this element does not extend `ShaeElement` and has no\n * namespace of its own. It shares their lifecycle: `ShaeLifecycleElement` is the base of all three,\n * and `destroy()`, `isDestroyed`, `restore()` and `teardown()` mean the same thing on every one of\n * them. What it does not share is the layer above it. `ShaeElement` exists for elements that pick\n * an environment: their `ns` attribute names the one they live in, and what they do goes there by\n * default \u2014 `ShaeElement.syncShadowObjectsOf()` is the explicit way to reach a different one, as\n * `<shae-ent>` does on a namespace change. A property picks nothing. It belongs to the closest\n * entity above it in the flattened tree, whatever namespace that entity happens to be in \u2014\n * proximity decides, not membership. An `ns` on a `<shae-prop>` would therefore be an attribute\n * that changes no answer, and the convention both siblings follow \u2014 spreading\n * `ShaeElement.observedAttributes` into their own \u2014 would put it into `observedAttributes` for\n * every reader to trip over.\n *\n * That is also why the sync runs through the host: the environment that has to hear about a\n * property is the one the host entity lives in, and this element is the wrong place to ask.\n * `entNode.syncShadowObjects()` reaches it; a sync of this element's own would target the\n * global namespace instead \u2014 nothing happens if no environment answers to that, and if one\n * does, it still leaves the namespaced host waiting.\n *\n * The marker for this element is `isShaePropElement`, beside `isShaeEntElement` and\n * `isShaeWorkerElement`. Each names one tag for consumers and tests to check \u2014 this file's own\n * spec included \u2014 not for the host lookup itself: that is decided by `ShaeEntElement`'s\n * `#onRequestParent`, the only listener registered for the request, and it checks `requester`,\n * `answer` and `ns`, never a flag. A `<shae-prop>` never answers a host request because it never\n * listens for one, not because its marker reads differently.\n */\nexport class ShaePropElement extends ShaeLifecycleElement {\n  static observedAttributes = [ATTR_NAME, ATTR_VALUE, ATTR_TYPE, ATTR_NO_TRIM];\n\n  readonly isShaePropElement = true;\n\n  protected readonly entNode$ = createSignal<ShaeEntElement | undefined>();\n  protected readonly viewComponent$ = createSignal<ViewComponent | undefined>();\n\n  protected readonly name$ = createSignal<string | undefined>();\n  protected readonly valueIn$ = createSignal();\n  protected readonly valueOut$ = createSignal();\n  protected readonly type$ = createSignal<string | undefined>();\n  protected readonly shouldTrim$ = createSignal(true);\n\n  readonly #logger = new ConsoleLogger('ShaePropElement');\n\n  /** The logger this element reports through: a subclass reads it and does not replace it. */\n  protected get logger(): ConsoleLogger {\n    return this.#logger;\n  }\n\n  /** Binds this element to the entity above it, and carries that entity's component through. */\n  #hostBinding?: (() => void) | undefined;\n\n  /** Holds the property on the entity for as long as this element declares it. */\n  #declareProperty?: Effect | undefined;\n\n  /** Writes the value through to the entity. */\n  #writePropertyValue?: Effect | undefined;\n\n  /** Turns what the attribute spells into the value the property carries. */\n  #convertValue?: Effect | undefined;\n\n  /** Whether the missing-host warning has already gone out for this element. */\n  #reportedMissingHost = false;\n\n  /** The node this element listens on for a re-request of the host, so the listener can come off the same one. */\n  #reRequestHostTarget?: EventTarget | undefined;\n\n  // Two terms, and they answer two different questions. `isConnected` separates an element in\n  // the tree from one on its way out: a round booked before the departure has nothing left to\n  // say about a position the element no longer holds. `isDestroyed` separates one that is\n  // listening from one that was ended by hand and is still standing where it was \u2014 a lookup\n  // running there would write `entNode$` and register the re-request listener again that the\n  // teardown just took off, and the element would be listening after it let go of everything.\n  // The flag is up before `teardown()` runs, so a round that comes due afterwards reads the\n  // state the element is actually in.\n  //\n  // The test stands here and not in the gate: a `MicrotaskGate` has no way to call a booking\n  // off, and that is the whole of what tells it apart from `DeferredTeardown`.\n  readonly #hostLookup = new MicrotaskGate(() => {\n    if (this.isConnected && !this.isDestroyed) {\n      this.#findEntNode();\n    }\n  });\n\n  get name(): string | undefined {\n    return this.name$.value;\n  }\n\n  /**\n   * Writes the `name` attribute, and `attributeChangedCallback` takes it from there: the attribute\n   * is the one source the name is read from, so a write through the property and a write through\n   * `setAttribute` end up in the same place and are trimmed by the same rule. A framework renderer\n   * assigns every prop it finds `in` the element as a property \u2014 React 19 and Vue 3 both do \u2014 and\n   * a name it cannot assign is a property that never binds.\n   */\n  set name(name: string | undefined) {\n    const trimmed = name?.trim();\n    if (!trimmed) {\n      this.removeAttribute(ATTR_NAME);\n    } else if (this.getAttribute(ATTR_NAME) !== trimmed) {\n      this.setAttribute(ATTR_NAME, trimmed);\n    }\n  }\n\n  get value(): unknown {\n    return this.valueOut$.value;\n  }\n\n  set value(val: unknown) {\n    this.valueIn$.set(val);\n  }\n\n  get shouldTrim(): boolean {\n    return this.shouldTrim$.value;\n  }\n\n  get entNode(): ShaeEntElement | undefined {\n    return this.entNode$.value;\n  }\n\n  set entNode(el: ShaeEntElement | undefined) {\n    this.entNode$.set(el);\n  }\n\n  get viewComponent(): ViewComponent | undefined {\n    return this.viewComponent$.value;\n  }\n\n  constructor() {\n    super();\n\n    // read with nothing listening yet: what this puts into the signals is the state the attributes\n    // already spell out, and the effects read it on their first run at the first connect\n    batch(() => {\n      this.#readNameAttribute();\n      this.#readValueAttribute();\n      this.#readTypeAttribute();\n      this.#readNoTrimAttribute();\n    });\n  }\n\n  /**\n   * Take up everything this element listens to.\n   *\n   * Called from {@link ShaePropElement.restore} and from nowhere else \u2014 that is the one place where\n   * this element's subscriptions begin, at the first connect as well as after a teardown.\n   */\n  #subscribe(): void {\n    this.#hostBinding = this.entNode$.onChange((entNode) => {\n      if (entNode) {\n        const con = link(entNode.viewComponent$, this.viewComponent$);\n        return () => {\n          con.destroy();\n        };\n      } else {\n        this.viewComponent$.set(undefined);\n      }\n    });\n\n    // The binding this element holds is the pair (view component, name). It ends in three ways \u2014\n    // the element leaves the tree, its name changes, or it moves to another entity \u2014 and each of\n    // them moves one of these two signals. The cleanup takes the property back for exactly the\n    // binding that ended, which is why the three need no code of their own.\n    //\n    // `valueOut$` is deliberately not read here: a value change would otherwise run a removal\n    // against a set of the same key on every keystroke.\n    //\n    // Standing before the value effect is a matter of reading order, not of behaviour: the order a\n    // rename ends up with in the trail is decided in `ComponentChanges.#propsChangeOrder`, where\n    // `appendToEnd` moves a key that is already queued to the back. Measured both ways, the trail\n    // reads `[['x', undefined], ['y', 7]]` either way.\n    this.#declareProperty = createEffect(() => {\n      const vc = this.viewComponent$.get();\n      const name = this.name$.get();\n\n      if (vc == null || !name) return;\n\n      // untracked on purpose: the host is where the sync has to go, not something this binding\n      // depends on. And it is the host and not this element, because the host carries the\n      // namespace \u2014 the environment holding this property is its, and nothing else knows which.\n      const entNode = this.entNode$.value;\n\n      addDeclarant(vc, name);\n\n      return () => {\n        // only the last declarant clears the property \u2014 another element may be holding the same\n        // name on the same entity, and the entity is what the property belongs to\n        if (removeDeclarant(vc, name)) {\n          vc.removeProperty(name);\n          // no `isConnected` guard, unlike the value effect below: an element that is no longer\n          // connected is precisely the case this has to reach\n          entNode?.syncShadowObjects();\n        }\n      };\n    });\n\n    this.#writePropertyValue = createEffect(() => {\n      const vc = this.viewComponent$.get();\n      if (vc) {\n        const name = this.name$.get();\n        if (name) {\n          const value = this.valueOut$.get();\n\n          this.logger.debug(`[${this.name}] view-component set-property`, name, value, vc.uuid, {\n            viewComponent: vc,\n            shaeProp: this,\n          });\n\n          vc.setProperty(name, value);\n\n          if (this.isConnected) {\n            this.entNode?.syncShadowObjects();\n          }\n        }\n      }\n    });\n\n    this.#convertValue = createEffect(() => {\n      const type = this.type$.get();\n      const shouldTrim = this.shouldTrim$.get();\n      let value = this.valueIn$.get();\n\n      if (shouldTrim && typeof value === 'string') {\n        value = value.trim();\n      }\n\n      // only null and undefined mean \"no value\" \u2014 0, false and the empty string are values\n      value = value ?? undefined;\n\n      if (typeof value === 'string' && type) {\n        const convert = propValueConverters.get(type);\n        if (convert != null) {\n          // invalid input is an operating case for this element, not an exceptional state: it is\n          // reported and clears the value instead of throwing out of a reactive effect. A numeric\n          // type throws when its conversion does not come out as a number, and takes the same way\n          // out of here as malformed JSON does.\n          try {\n            value = convert(value);\n          } catch (error) {\n            // reported through `error`, not `warn`: `warn` is gated behind\n            // `ConsoleLogger.sharedConfig.enable`, which defaults to \"the page is served from a\n            // loopback host\". A dropped property value has to stay visible in production too.\n            this.logger.error(`[${this.name}] could not convert the value into the type \"${type}\"`, {\n              value,\n              error,\n              shaeProp: this,\n            });\n            value = undefined;\n          }\n        }\n        // an unrecognized type name \u2014 `convert == null` \u2014 passes the string through untouched and\n        // unreported here. `type$` is `protected`; the only writer in this repository is\n        // `#readTypeAttribute`, which already warns for every unknown name it sees, so this branch\n        // stays silent on purpose rather than warning a second time for the same name.\n      }\n\n      this.valueOut$.set(value);\n    });\n  }\n\n  /**\n   * Take this element's own subscriptions up. Its half of {@link ShaeLifecycleElement.restore}.\n   *\n   * There is nothing to catch up on here, unlike `<shae-ent>`: `connectedCallback` reads `name`,\n   * `type` and `no-trim` off the attributes, `value` where the attribute carries one, and looks the\n   * host up again straight after this. So the attributes decide, and whatever was written to a\n   * released element through `prop.entNode` \u2014 or through `prop.value` against a `value` attribute\n   * that says something \u2014 is replaced by what the tree and the markup say. That is this element's\n   * rule in and out of a teardown alike \u2014 a `<shae-prop>` reads its position on every connect \u2014 and\n   * the documentation states it as the difference it is.\n   */\n  protected override restore(): void {\n    super.restore();\n\n    this.#subscribe();\n  }\n\n  override connectedCallback() {\n    // the whole body outside any reactive context of the caller, for the reason spelled out in\n    // `ShaeLifecycleElement.connectedCallback`: an `append()` inside a foreign effect would\n    // otherwise own the effects taken up here, and that effect's next run would release them\n    hibernate(() => {\n      super.connectedCallback();\n\n      batch(() => {\n        this.#findEntNode();\n        this.#readNameAttribute();\n        // `value` is the one attribute that is read only where it carries something: a value\n        // written through `prop.value` never reaches the attribute, and a renderer that assigns\n        // properties before it inserts the element \u2014 every framework renderer does \u2014 would\n        // otherwise see its write replaced by \"no attribute, no value\" on the way in. An attribute\n        // that carries a value decides, as it does for the three others.\n        if (this.#valueAttributeCarriesValue()) {\n          this.#readValueAttribute();\n        }\n        this.#readTypeAttribute();\n        this.#readNoTrimAttribute();\n      });\n    });\n  }\n\n  attributeChangedCallback(name: string) {\n    switch (name) {\n      case ATTR_NAME:\n        this.#readNameAttribute();\n        break;\n\n      case ATTR_VALUE:\n        this.#readValueAttribute();\n        break;\n\n      case ATTR_TYPE:\n        this.#readTypeAttribute();\n        break;\n\n      case ATTR_NO_TRIM:\n        this.#readNoTrimAttribute();\n        break;\n    }\n  }\n\n  override disconnectedCallback() {\n    this.#stopListeningForHostChanges();\n    this.#disconnectFromEntNode();\n\n    // last, and the order is not a matter of taste. `#disconnectFromEntNode` queues a microtask of\n    // its own that writes `entNode$`, and microtasks run in the order they were queued: booked\n    // second, the teardown runs second, so the unbinding still reaches a subscription that is on\n    // and the property is taken off the entity it left. The other way round the write would arrive\n    // after the release and reach nobody\n    super.disconnectedCallback();\n  }\n\n  /**\n   * Release this element's own subscriptions. Its half of {@link ShaeLifecycleElement.teardown}.\n   *\n   * The `link()` between the host's `viewComponent$` and this element's own needs no line of its\n   * own: it is built in the cleanup path of the `entNode$` subscription, and taking that\n   * subscription off runs the cleanup that destroys it.\n   */\n  protected override teardown(): void {\n    this.#stopListeningForHostChanges();\n\n    this.#hostBinding?.();\n    this.#hostBinding = undefined;\n\n    this.#declareProperty?.destroy();\n    this.#declareProperty = undefined;\n\n    this.#writePropertyValue?.destroy();\n    this.#writePropertyValue = undefined;\n\n    this.#convertValue?.destroy();\n    this.#convertValue = undefined;\n\n    super.teardown();\n  }\n\n  // Determines the host from where the element stands right now. The request runs *without* a\n  // namespace: a property belongs to the closest entity above it, whatever namespace that entity\n  // is in.\n  //\n  // Nobody answering means there is no entity above this position, and the element says so. A\n  // binding without an answer belongs to a place that is no longer there \u2014 whether the element\n  // moved or the entity above it did. The cleanup on `entNode$` then takes the property off the\n  // entity that no longer holds it, instead of leaving the element writing into an entity it does\n  // not sit under any more.\n  #findEntNode = () => {\n    let found: ShaeEntElement | undefined;\n    requestEntAncestor(this, {answer: (entNode) => (found = entNode)});\n\n    this.entNode$.set(found);\n\n    // Reported once per element, not once per request: the re-request channel repeats this very\n    // lookup, so a property that never gets a host would otherwise report again on every upgrade\n    // happening anywhere above it.\n    //\n    // The `isConnected` term is what separates \"no host\" from \"no position\": an element on its way\n    // out of the tree is not missing a host.\n    //\n    // The limit of this report belongs next to it: `logger.warn` hangs on\n    // `ConsoleLogger.sharedConfig.enable`, which means \"the page is served from a loopback host\" \u2014\n    // elsewhere the case stays silent. `warn` and not `error`, because in the upgrade path this\n    // framework supports by design, \"no entity above me yet\" is a state to pass through: a\n    // <shae-prop> under an element whose tag is registered later reports once and finds its host\n    // right afterwards.\n    if (found == null && this.isConnected && !this.#reportedMissingHost) {\n      this.#reportedMissingHost = true;\n      this.logger.warn(`[${this.name}] no entity above this element, the property is set nowhere`, {\n        shaeProp: this,\n      });\n    }\n\n    this.#listenForHostChanges();\n  };\n\n  // Someone above started or stopped answering. Two things separate this from a lookup the\n  // element makes on arrival, and both belong here, to the trigger \u2014 what an unanswered\n  // request means is the same on either path.\n  //\n  // It waits a microtask: the message arrives while the tree is still moving. An entity that\n  // announces its departure has left, but everything below it can be back in place before the\n  // tick ends, and an ancestor answering *right now* can be one this element is about to\n  // leave behind. Asking after the dust settles is asking once, about the tree that is\n  // actually there.\n  //\n  // And it drops the question if this element has left in the meantime, for the same reason\n  // `#reRequestParent` does in `ShaeEntElement`: an element that is out of the tree answers\n  // nothing about its position any more. Whether its departure is a move or an end is\n  // `#disconnectFromEntNode`'s to answer, one microtask later, and it is answered in one place.\n  // Nothing observable turns on the test \u2014 a departing entity takes its properties with it\n  // either way \u2014 so it stands as a rule, not as a measurement.\n  //\n  // `#hostLookup` bounds the cost: a page filling up with entities sends many messages through the\n  // same ancestor chain, and the gate turns them into one lookup per microtask and per element.\n  #onReRequestHost = () => {\n    this.#hostLookup.schedule();\n  };\n\n  #listenForHostChanges = () => {\n    // bound: the entity itself is on the ascent of every element that could take the property\n    // away from it. Unbound: the document is the one node every such event reaches, out of any\n    // tree, closed roots included\n    const target: EventTarget = this.entNode$.value ?? this.ownerDocument;\n    if (target === this.#reRequestHostTarget) return;\n    this.#stopListeningForHostChanges();\n    target.addEventListener(ReRequestEntHostEventName, this.#onReRequestHost);\n    this.#reRequestHostTarget = target;\n  };\n\n  #stopListeningForHostChanges = () => {\n    this.#reRequestHostTarget?.removeEventListener(ReRequestEntHostEventName, this.#onReRequestHost);\n    this.#reRequestHostTarget = undefined;\n  };\n\n  #disconnectFromEntNode = () => {\n    queueMicrotask(() => {\n      if (!this.isConnected) {\n        this.entNode$.set(undefined);\n      }\n    });\n  };\n\n  #readNameAttribute = () => {\n    this.name$.set(this.getAttribute(ATTR_NAME)?.trim() ?? undefined);\n  };\n\n  #readValueAttribute = () => {\n    // an empty value attribute means \"no value\", exactly like a missing one. Everything else\n    // goes in raw: valueIn$ is the source a no-trim switch recalculates from, so whitespace\n    // has to survive until the trim decides what is left of it.\n    const value = this.getAttribute(ATTR_VALUE);\n    this.valueIn$.set(value === null || value === '' ? undefined : value);\n  };\n\n  /** Whether the `value` attribute says something \u2014 absent and empty are the same \"nothing\" here. */\n  #valueAttributeCarriesValue = (): boolean => {\n    const value = this.getAttribute(ATTR_VALUE);\n    return value !== null && value !== '';\n  };\n\n  #readTypeAttribute = () => {\n    let type = this.getAttribute(ATTR_TYPE)?.trim().toLowerCase();\n    if (type && !propValueConverters.has(type)) {\n      this.logger.warn(`[${this.name}] unknown type \"${type}\"`, {\n        shaeProp: this,\n      });\n      type = undefined;\n    }\n    this.type$.set(type);\n  };\n\n  #readNoTrimAttribute = () => {\n    this.shouldTrim$.set(!readBooleanAttribute(this, ATTR_NO_TRIM));\n  };\n}\n"],
+  "mappings": "AAAA,SAAQ,OAAO,cAAc,cAAc,QAAQ,WAAW,YAAW;AACzE,SAAQ,4BAA2B;AACnC,SAAQ,qBAAoB;AAC5B,SAAQ,qBAAoB;AAE5B,SAAQ,WAAW,cAAc,WAAW,YAAY,iCAAgC;AACxF,SAAQ,2BAA0B;AAClC,SAAQ,0BAAyB;AAEjC,SAAQ,4BAA2B;AAUnC,MAAM,yBAAyB,oBAAI,QAA4C;AAE/E,MAAM,eAAe,CAAC,IAAmB,SAAiB;AACxD,MAAI,QAAQ,uBAAuB,IAAI,EAAE;AACzC,MAAI,SAAS,MAAM;AACjB,YAAQ,oBAAI,IAAI;AAChB,2BAAuB,IAAI,IAAI,KAAK;AAAA,EACtC;AACA,QAAM,IAAI,OAAO,MAAM,IAAI,IAAI,KAAK,KAAK,CAAC;AAC5C;AAGA,MAAM,kBAAkB,CAAC,IAAmB,SAA0B;AACpE,QAAM,QAAQ,uBAAuB,IAAI,EAAE;AAC3C,MAAI,SAAS,KAAM,QAAO;AAE1B,QAAM,aAAa,MAAM,IAAI,IAAI,KAAK,KAAK;AAC3C,MAAI,YAAY,GAAG;AACjB,UAAM,IAAI,MAAM,SAAS;AACzB,WAAO;AAAA,EACT;AAEA,QAAM,OAAO,IAAI;AACjB,MAAI,MAAM,SAAS,GAAG;AACpB,2BAAuB,OAAO,EAAE;AAAA,EAClC;AACA,SAAO;AACT;AA+BO,MAAM,wBAAwB,qBAAqB;AAAA,EAoGxD,cAAc;AACZ,UAAM;AAlGR,SAAS,oBAAoB;AAE7B,SAAmB,WAAW,aAAyC;AACvE,SAAmB,iBAAiB,aAAwC;AAE5E,SAAmB,QAAQ,aAAiC;AAC5D,SAAmB,WAAW,aAAa;AAC3C,SAAmB,YAAY,aAAa;AAC5C,SAAmB,QAAQ,aAAiC;AAC5D,SAAmB,cAAc,aAAa,IAAI;AAElD,SAAS,UAAU,IAAI,cAAc,iBAAiB;AAoBtD;AAAA,gCAAuB;AAgBvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAAS,cAAc,IAAI,cAAc,MAAM;AAC7C,UAAI,KAAK,eAAe,CAAC,KAAK,aAAa;AACzC,aAAK,aAAa;AAAA,MACpB;AAAA,IACF,CAAC;AA6RD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAAe,MAAM;AACnB,UAAI;AACJ,yBAAmB,MAAM,EAAC,QAAQ,CAAC,YAAa,QAAQ,QAAQ,CAAC;AAEjE,WAAK,SAAS,IAAI,KAAK;AAevB,UAAI,SAAS,QAAQ,KAAK,eAAe,CAAC,KAAK,sBAAsB;AACnE,aAAK,uBAAuB;AAC5B,aAAK,OAAO,KAAK,IAAI,KAAK,IAAI,+DAA+D;AAAA,UAC3F,UAAU;AAAA,QACZ,CAAC;AAAA,MACH;AAEA,WAAK,sBAAsB;AAAA,IAC7B;AAqBA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAAmB,MAAM;AACvB,WAAK,YAAY,SAAS;AAAA,IAC5B;AAEA,iCAAwB,MAAM;AAI5B,YAAM,SAAsB,KAAK,SAAS,SAAS,KAAK;AACxD,UAAI,WAAW,KAAK,qBAAsB;AAC1C,WAAK,6BAA6B;AAClC,aAAO,iBAAiB,2BAA2B,KAAK,gBAAgB;AACxE,WAAK,uBAAuB;AAAA,IAC9B;AAEA,wCAA+B,MAAM;AACnC,WAAK,sBAAsB,oBAAoB,2BAA2B,KAAK,gBAAgB;AAC/F,WAAK,uBAAuB;AAAA,IAC9B;AAEA,kCAAyB,MAAM;AAC7B,qBAAe,MAAM;AACnB,YAAI,CAAC,KAAK,aAAa;AACrB,eAAK,SAAS,IAAI,MAAS;AAAA,QAC7B;AAAA,MACF,CAAC;AAAA,IACH;AAEA,8BAAqB,MAAM;AACzB,WAAK,MAAM,IAAI,KAAK,aAAa,SAAS,GAAG,KAAK,KAAK,MAAS;AAAA,IAClE;AAEA,+BAAsB,MAAM;AAI1B,YAAM,QAAQ,KAAK,aAAa,UAAU;AAC1C,WAAK,SAAS,IAAI,UAAU,QAAQ,UAAU,KAAK,SAAY,KAAK;AAAA,IACtE;AAGA;AAAA,uCAA8B,MAAe;AAC3C,YAAM,QAAQ,KAAK,aAAa,UAAU;AAC1C,aAAO,UAAU,QAAQ,UAAU;AAAA,IACrC;AAEA,8BAAqB,MAAM;AACzB,UAAI,OAAO,KAAK,aAAa,SAAS,GAAG,KAAK,EAAE,YAAY;AAC5D,UAAI,QAAQ,CAAC,oBAAoB,IAAI,IAAI,GAAG;AAC1C,aAAK,OAAO,KAAK,IAAI,KAAK,IAAI,mBAAmB,IAAI,KAAK;AAAA,UACxD,UAAU;AAAA,QACZ,CAAC;AACD,eAAO;AAAA,MACT;AACA,WAAK,MAAM,IAAI,IAAI;AAAA,IACrB;AAEA,gCAAuB,MAAM;AAC3B,WAAK,YAAY,IAAI,CAAC,qBAAqB,MAAM,YAAY,CAAC;AAAA,IAChE;AArVE,UAAM,MAAM;AACV,WAAK,mBAAmB;AACxB,WAAK,oBAAoB;AACzB,WAAK,mBAAmB;AACxB,WAAK,qBAAqB;AAAA,IAC5B,CAAC;AAAA,EACH;AAAA,EA9GA;AAAA,SAAO,qBAAqB,CAAC,WAAW,YAAY,WAAW,YAAY;AAAA;AAAA,EAalE;AAAA;AAAA,EAGT,IAAc,SAAwB;AACpC,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA,EAaS;AAAA,EAMT,IAAI,OAA2B;AAC7B,WAAO,KAAK,MAAM;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,IAAI,KAAK,MAA0B;AACjC,UAAM,UAAU,MAAM,KAAK;AAC3B,QAAI,CAAC,SAAS;AACZ,WAAK,gBAAgB,SAAS;AAAA,IAChC,WAAW,KAAK,aAAa,SAAS,MAAM,SAAS;AACnD,WAAK,aAAa,WAAW,OAAO;AAAA,IACtC;AAAA,EACF;AAAA,EAEA,IAAI,QAAiB;AACnB,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA,EAEA,IAAI,MAAM,KAAc;AACtB,SAAK,SAAS,IAAI,GAAG;AAAA,EACvB;AAAA,EAEA,IAAI,aAAsB;AACxB,WAAO,KAAK,YAAY;AAAA,EAC1B;AAAA,EAEA,IAAI,UAAsC;AACxC,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,IAAI,QAAQ,IAAgC;AAC1C,SAAK,SAAS,IAAI,EAAE;AAAA,EACtB;AAAA,EAEA,IAAI,gBAA2C;AAC7C,WAAO,KAAK,eAAe;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,aAAmB;AACjB,SAAK,eAAe,KAAK,SAAS,SAAS,CAAC,YAAY;AACtD,UAAI,SAAS;AACX,cAAM,MAAM,KAAK,QAAQ,gBAAgB,KAAK,cAAc;AAC5D,eAAO,MAAM;AACX,cAAI,QAAQ;AAAA,QACd;AAAA,MACF,OAAO;AACL,aAAK,eAAe,IAAI,MAAS;AAAA,MACnC;AAAA,IACF,CAAC;AAcD,SAAK,mBAAmB,aAAa,MAAM;AACzC,YAAM,KAAK,KAAK,eAAe,IAAI;AACnC,YAAM,OAAO,KAAK,MAAM,IAAI;AAE5B,UAAI,MAAM,QAAQ,CAAC,KAAM;AAKzB,YAAM,UAAU,KAAK,SAAS;AAE9B,mBAAa,IAAI,IAAI;AAErB,aAAO,MAAM;AAGX,YAAI,gBAAgB,IAAI,IAAI,GAAG;AAC7B,aAAG,eAAe,IAAI;AAGtB,mBAAS,kBAAkB;AAAA,QAC7B;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,sBAAsB,aAAa,MAAM;AAC5C,YAAM,KAAK,KAAK,eAAe,IAAI;AACnC,UAAI,IAAI;AACN,cAAM,OAAO,KAAK,MAAM,IAAI;AAC5B,YAAI,MAAM;AACR,gBAAM,QAAQ,KAAK,UAAU,IAAI;AAEjC,eAAK,OAAO,MAAM,IAAI,KAAK,IAAI,iCAAiC,MAAM,OAAO,GAAG,MAAM;AAAA,YACpF,eAAe;AAAA,YACf,UAAU;AAAA,UACZ,CAAC;AAED,aAAG,YAAY,MAAM,KAAK;AAE1B,cAAI,KAAK,aAAa;AACpB,iBAAK,SAAS,kBAAkB;AAAA,UAClC;AAAA,QACF;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,gBAAgB,aAAa,MAAM;AACtC,YAAM,OAAO,KAAK,MAAM,IAAI;AAC5B,YAAM,aAAa,KAAK,YAAY,IAAI;AACxC,UAAI,QAAQ,KAAK,SAAS,IAAI;AAE9B,UAAI,cAAc,OAAO,UAAU,UAAU;AAC3C,gBAAQ,MAAM,KAAK;AAAA,MACrB;AAGA,cAAQ,SAAS;AAEjB,UAAI,OAAO,UAAU,YAAY,MAAM;AACrC,cAAM,UAAU,oBAAoB,IAAI,IAAI;AAC5C,YAAI,WAAW,MAAM;AAKnB,cAAI;AACF,oBAAQ,QAAQ,KAAK;AAAA,UACvB,SAAS,OAAO;AAId,iBAAK,OAAO,MAAM,IAAI,KAAK,IAAI,gDAAgD,IAAI,KAAK;AAAA,cACtF;AAAA,cACA;AAAA,cACA,UAAU;AAAA,YACZ,CAAC;AACD,oBAAQ;AAAA,UACV;AAAA,QACF;AAAA,MAKF;AAEA,WAAK,UAAU,IAAI,KAAK;AAAA,IAC1B,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAamB,UAAgB;AACjC,UAAM,QAAQ;AAEd,SAAK,WAAW;AAAA,EAClB;AAAA,EAES,oBAAoB;AAI3B,cAAU,MAAM;AACd,YAAM,kBAAkB;AAExB,YAAM,MAAM;AACV,aAAK,aAAa;AAClB,aAAK,mBAAmB;AAMxB,YAAI,KAAK,4BAA4B,GAAG;AACtC,eAAK,oBAAoB;AAAA,QAC3B;AACA,aAAK,mBAAmB;AACxB,aAAK,qBAAqB;AAAA,MAC5B,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,yBAAyB,MAAc;AACrC,YAAQ,MAAM;AAAA,MACZ,KAAK;AACH,aAAK,mBAAmB;AACxB;AAAA,MAEF,KAAK;AACH,aAAK,oBAAoB;AACzB;AAAA,MAEF,KAAK;AACH,aAAK,mBAAmB;AACxB;AAAA,MAEF,KAAK;AACH,aAAK,qBAAqB;AAC1B;AAAA,IACJ;AAAA,EACF;AAAA,EAES,uBAAuB;AAC9B,SAAK,6BAA6B;AAClC,SAAK,uBAAuB;AAO5B,UAAM,qBAAqB;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASmB,WAAiB;AAClC,SAAK,6BAA6B;AAElC,SAAK,eAAe;AACpB,SAAK,eAAe;AAEpB,SAAK,kBAAkB,QAAQ;AAC/B,SAAK,mBAAmB;AAExB,SAAK,qBAAqB,QAAQ;AAClC,SAAK,sBAAsB;AAE3B,SAAK,eAAe,QAAQ;AAC5B,SAAK,gBAAgB;AAErB,UAAM,SAAS;AAAA,EACjB;AAAA,EAWA;AAAA,EAgDA;AAAA,EAIA;AAAA,EAWA;AAAA,EAKA;AAAA,EAQA;AAAA,EAIA;AAAA,EASA;AAAA,EAKA;AAAA,EAWA;AAGF;",
   "names": []
 }

package/src/elements/ShaeWorkerElement.d.ts

@@ -1,3 +1,4 @@
+import type { ExposeHandle } from '../model-context/exposeShadowEnvsToModelContext.js';
 import { ConsoleLogger } from '../utils/ConsoleLogger.js';
 import { FrameLoop } from '../utils/FrameLoop.js';
 import { ShadowEnv } from '../view/ShadowEnv.js';
@@ -18,6 +19,15 @@ export declare class ShaeWorkerElement extends ShaeElement {
     isConnected$: import("@spearwolf/signalize").Signal<boolean>;
     autoSync$: import("@spearwolf/signalize").Signal<string>;
     src$: import("@spearwolf/signalize").Signal<string>;
+    /** The `redact-props` attribute as a list of property names, read as it stands right now. */
+    get redactProps(): string[];
+    /**
+     * 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(): Promise<ExposeHandle> | undefined;
     /**
      * Take the subscriptions up. Runs exactly once for this element, on the first connect.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"ShaeWorkerElement.d.ts","sourceRoot":"","sources":["../../../src/elements/ShaeWorkerElement.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,aAAa,EAAC,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAC,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAIhD,OAAO,EAAC,SAAS,EAA0B,MAAM,sBAAsB,CAAC;AAaxE,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAsB7C,qBAAa,iBAAkB,SAAQ,WAAW;;IA+LhD;;OAEG;IACH,CAAC,SAAS,CAAC,OAAO,CAAC;IAjMnB,OAAgB,kBAAkB,WAMhC;IAEF,MAAM,CAAC,eAAe,SAAW;IAEjC,QAAQ,CAAC,mBAAmB,QAAQ;IAEpC,QAAQ,CAAC,SAAS,YAAmB;IAIrC,+CAA+C;IAC/C,IAAI,MAAM,IAAI,aAAa,CAE1B;IAED,SAAS,UAAQ;IAEjB,YAAY,iDAAuB;IACnC,SAAS,gDAAmD;IAC5D,IAAI,gDAAoB;IAgBxB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,UAAmB,OAAO,IAAI,IAAI,CAiEjC;IAyCD,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,IAAI,QAAQ,IAIM,MAAM,GAAG,OAAO,GAAG,MAAM,CAF1C;IAED,IAAI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAE1C;IAED,IAAI,SAAS,IAAI,SAAS,CAEzB;IASK,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAehE;IAEQ,iBAAiB,SA6BzB;IAEQ,oBAAoB,SAG5B;IAEQ,wBAAwB,CAAC,IAAI,EAAE,MAAM,QA0B7C;IAoBD,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC,CAgB1B;IAED;;;;;;;;;;;;;;;OAeG;IACH,UAAmB,QAAQ,SAW1B;CA6FF"}
+{"version":3,"file":"ShaeWorkerElement.d.ts","sourceRoot":"","sources":["../../../src/elements/ShaeWorkerElement.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oDAAoD,CAAC;AAErF,OAAO,EAAC,aAAa,EAAC,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAC,SAAS,EAAC,MAAM,uBAAuB,CAAC;AAIhD,OAAO,EAAC,SAAS,EAA0B,MAAM,sBAAsB,CAAC;AAgBxE,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AA6B7C,qBAAa,iBAAkB,SAAQ,WAAW;;IAiNhD;;OAEG;IACH,CAAC,SAAS,CAAC,OAAO,CAAC;IAnNnB,OAAgB,kBAAkB,WAOhC;IAEF,MAAM,CAAC,eAAe,SAAW;IAEjC,QAAQ,CAAC,mBAAmB,QAAQ;IAEpC,QAAQ,CAAC,SAAS,YAAmB;IAIrC,+CAA+C;IAC/C,IAAI,MAAM,IAAI,aAAa,CAE1B;IAED,SAAS,UAAQ;IAEjB,YAAY,iDAAuB;IACnC,SAAS,gDAAmD;IAC5D,IAAI,gDAAoB;IASxB,6FAA6F;IAC7F,IAAI,WAAW,IAAI,MAAM,EAAE,CAE1B;IAED;;;;;OAKG;IACH,IAAI,oBAAoB,IAAI,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,CAE5D;IAWD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,UAAmB,OAAO,IAAI,IAAI,CAiEjC;IAyCD,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,IAAI,QAAQ,IAIM,MAAM,GAAG,OAAO,GAAG,MAAM,CAF1C;IAED,IAAI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAE1C;IAED,IAAI,SAAS,IAAI,SAAS,CAEzB;IASK,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAehE;IAEQ,iBAAiB,SA8BzB;IAEQ,oBAAoB,SAG5B;IAEQ,wBAAwB,CAAC,IAAI,EAAE,MAAM,QA8B7C;IAoBD,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC,CAgB1B;IAED;;;;;;;;;;;;;;;OAeG;IACH,UAAmB,QAAQ,SAa1B;CA6IF"}

package/src/elements/ShaeWorkerElement.js

@@ -1,6 +1,6 @@
 import { on } from "@spearwolf/eventize";
 import { batch, createEffect, createSignal, destroySignal, Effect, hibernate } from "@spearwolf/signalize";
-import { readBooleanAttribute, readNumberAttribute } from "../utils/attr-utils.js";
+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";
@@ -12,10 +12,13 @@ import {
   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";
@@ -24,6 +27,7 @@ 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) {
@@ -61,7 +65,8 @@ class ShaeWorkerElement extends ShaeElement {
       ATTR_LOCAL,
       ATTR_SRC,
       ATTR_NO_STRUCTURED_CLONE,
-      ATTR_AUTO_SYNC
+      ATTR_AUTO_SYNC,
+      ATTR_EXPOSE_TO_MODEL_CONTEXT
     ];
   }
   static {
@@ -75,6 +80,20 @@ class ShaeWorkerElement extends ShaeElement {
   #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.
    *
@@ -229,6 +248,7 @@ class ShaeWorkerElement extends ShaeElement {
       if (this.shouldAutostart) {
         this.start().catch(this.#onUnobservedRejection);
       }
+      this.#syncModelContextExposure();
     });
   }
   disconnectedCallback() {
@@ -254,6 +274,9 @@ 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
@@ -299,6 +322,7 @@ class ShaeWorkerElement extends ShaeElement {
    * {@link ShaeWorkerElement.restore} a method that runs once and never again.
    */
   teardown() {
+    this.#leaveModelContextExposure();
     this.#envViewBinding?.();
     this.#envViewBinding = void 0;
     this.#autoSync?.destroy();
@@ -390,6 +414,49 @@ class ShaeWorkerElement extends ShaeElement {
       }
     });
   }
+  /**
+   * 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