@spearwolf/shadow-objects 0.33.0 → 0.35.0

package/src/elements/ShaePropElement.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/elements/ShaePropElement.ts"],
-  "sourcesContent": ["import {batch, createEffect, createSignal, link} from '@spearwolf/signalize';\nimport {readBooleanAttribute} from '../utils/attr-utils.js';\nimport {ConsoleLogger} from '../utils/ConsoleLogger.js';\nimport {TRUTHY_VALUES} from '../utils/constants.js';\nimport type {ViewComponent} from '../view/ViewComponent.js';\nimport {ATTR_NAME, ATTR_NO_TRIM, ATTR_TYPE, ATTR_VALUE} from './constants.js';\nimport type {ShaeEntElement} from './ShaeEntElement.js';\n\nconst findEntNode = (start: HTMLElement): ShaeEntElement | undefined => {\n  let el: HTMLElement | null = start.parentElement;\n  while (el) {\n    if ((el as ShaeEntElement).isShaeEntElement) {\n      return el as ShaeEntElement;\n    }\n    el = el.parentElement;\n  }\n  return undefined;\n};\n\nconst TYPES = new Set([\n  'string',\n  'text',\n  'number',\n  'bigint',\n  'float',\n  'int',\n  'integer',\n  'hex',\n  'hexadecimal',\n  'oct',\n  'octal',\n  'bin',\n  'binary',\n  'bool',\n  'boolean',\n  '[]',\n  'text[]',\n  'string[]',\n  'number[]',\n  'float[]',\n  'int[]',\n  'integer[]',\n  'hex[]',\n  'hexadecimal[]',\n  'oct[]',\n  'octal[]',\n  'bin[]',\n  'binary[]',\n  'bool[]',\n  'boolean[]',\n  'int8array',\n  'uint8array',\n  'uint8clampedarray',\n  'int16array',\n  'uint16array',\n  'int32array',\n  'uint32array',\n  'float32array',\n  'float64array',\n  'bigint64array',\n  'biguint64array',\n  'json',\n]);\n\nexport class ShaePropElement extends HTMLElement {\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  protected readonly logger = new ConsoleLogger('ShaePropElement');\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    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    // this.viewComponent$.onChange((vc) => {\n    //   if (vc) {\n    //     console.log(`[shae-prop:\"${this.name}\"] view-component changed to`, vc?.uuid, {\n    //       viewComponent: vc,\n    //       shaeProp: this,\n    //     });\n    //   } else {\n    //     console.log(`[shae-prop:\"${this.name}\"] lost connection to view-component :/`, {\n    //       shaeProp: this,\n    //     });\n    //   }\n    // });\n\n    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          if (this.logger.isDebug) {\n            this.logger.debug(`[${this.name}] view-component set-property`, name, value, vc.uuid, {\n              viewComponent: vc,\n              shaeProp: this,\n            });\n          }\n\n          vc.setProperty(name, value);\n\n          if (this.isConnected) {\n            this.entNode?.syncShadowObjects();\n          }\n        }\n      }\n    });\n\n    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      value = value || undefined;\n\n      if (value != null && typeof value === 'string' && type) {\n        switch (type) {\n          case 'string':\n          case 'text':\n            break;\n\n          case 'number':\n            value = Number(value);\n            break;\n\n          case 'bigint':\n            value = BigInt(value);\n            break;\n\n          case 'float':\n            value = parseFloat(value);\n            break;\n\n          case 'int':\n          case 'integer':\n            value = parseInt(value, 10);\n            break;\n\n          case 'hex':\n          case 'hexadecimal':\n            value = parseInt(value, 16);\n            break;\n\n          case 'oct':\n          case 'octal':\n            value = parseInt(value, 8);\n            break;\n\n          case 'bin':\n          case 'binary':\n            value = parseInt(value, 2);\n            break;\n\n          case 'bool':\n          case 'boolean':\n            value = TRUTHY_VALUES.has(value.toLowerCase());\n            break;\n\n          case '[]':\n          case 'text[]':\n          case 'string[]':\n            value = value.split(/\\W+/);\n            break;\n\n          case 'number[]':\n            value = value.split(/\\s+/).map((v) => Number(v));\n            break;\n\n          case 'float[]':\n            value = value.split(/\\s+/).map((v) => parseFloat(v));\n            break;\n\n          case 'int[]':\n          case 'integer[]':\n            value = value.split(/\\s+/).map((v) => parseInt(v, 10));\n            break;\n\n          case 'hex[]':\n          case 'hexadecimal[]':\n            value = value.split(/\\W+/).map((v) => parseInt(v, 16));\n            break;\n\n          case 'oct[]':\n          case 'octal[]':\n            value = value.split(/\\W+/).map((v) => parseInt(v, 8));\n            break;\n\n          case 'bin[]':\n          case 'binary[]':\n            value = value.split(/\\W+/).map((v) => parseInt(v, 2));\n            break;\n\n          case 'bool[]':\n          case 'boolean[]':\n            value = value.split(/\\W+/).map((v) => TRUTHY_VALUES.has(v.toLowerCase()));\n            break;\n\n          case 'int8array':\n            value = new Int8Array(value.split(/\\W+/).map((v) => Number(v)));\n            break;\n\n          case 'uint8array':\n            value = new Uint8Array(value.split(/\\W+/).map((v) => Number(v)));\n            break;\n\n          case 'uint8clampedarray':\n            value = new Uint8ClampedArray(value.split(/\\W+/).map((v) => Number(v)));\n            break;\n\n          case 'int16array':\n            value = new Int16Array(value.split(/\\W+/).map((v) => Number(v)));\n            break;\n\n          case 'uint16array':\n            value = new Uint16Array(value.split(/\\W+/).map((v) => Number(v)));\n            break;\n\n          case 'int32array':\n            value = new Int32Array(value.split(/\\W+/).map((v) => Number(v)));\n            break;\n\n          case 'uint32array':\n            value = new Uint32Array(value.split(/\\W+/).map((v) => Number(v)));\n            break;\n\n          case 'float32array':\n            value = new Float32Array(value.split(/\\s+/).map((v) => Number(v)));\n            break;\n\n          case 'float64array':\n            value = new Float64Array(value.split(/\\s+/).map((v) => Number(v)));\n            break;\n\n          case 'bigint64array':\n            value = new BigInt64Array(value.split(/\\W+/).map((v) => BigInt(v)));\n            break;\n\n          case 'biguint64array':\n            value = new BigUint64Array(value.split(/\\W+/).map((v) => BigInt(v)));\n            break;\n\n          case 'json':\n            value = JSON.parse(value);\n            break;\n\n          default:\n            if (this.logger.isWarn) {\n              this.logger.warn(`[${this.name}] unknown type \"${type}\"`, {\n                value,\n                shaeProp: this,\n              });\n            }\n        }\n      }\n\n      this.valueOut$.set(value);\n    });\n\n    batch(() => {\n      this.#readNameAttribute();\n      this.#readValueAttribute();\n      this.#readTypeAttribute();\n      this.#readNoTrimAttribute();\n    });\n\n    this.style.display = 'contents';\n  }\n\n  connectedCallback() {\n    batch(() => {\n      this.#findEntNode();\n      this.#readNameAttribute();\n      this.#readValueAttribute();\n      this.#readTypeAttribute();\n      this.#readNoTrimAttribute();\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  disconnectedCallback() {\n    this.#disconnectFromEntNode();\n  }\n\n  #findEntNode = () => {\n    this.entNode$.set(findEntNode(this));\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    this.valueIn$.set(this.getAttribute(ATTR_VALUE));\n  };\n\n  #readTypeAttribute = () => {\n    let type = this.getAttribute(ATTR_TYPE)?.trim().toLowerCase();\n    if (type && !TYPES.has(type)) {\n      if (this.logger.isWarn) {\n        this.logger.warn(`[${this.name}] unknown type \"${type}\"`, {\n          shaeProp: this,\n        });\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}"],
-  "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": "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",
   "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';
@@ -12,21 +13,74 @@ export declare class ShaeWorkerElement extends ShaeElement {
     static DefaultAutoSync: string;
     readonly isShaeWorkerElement = true;
     readonly shadowEnv: ShadowEnv;
-    readonly logger: ConsoleLogger;
+    /** The logger this element reports through. */
+    get logger(): ConsoleLogger;
     autostart: boolean;
     isConnected$: import("@spearwolf/signalize").Signal<boolean>;
     autoSync$: import("@spearwolf/signalize").Signal<string>;
     src$: import("@spearwolf/signalize").Signal<string>;
-    constructor();
+    /** 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.
+     *
+     * 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.
+     */
+    protected restore(): void;
     get shouldAutostart(): boolean;
-    get autoSync(): any;
-    set autoSync(val: any);
+    get autoSync(): string | boolean | number;
+    set autoSync(val: string | boolean | number);
     get frameLoop(): FrameLoop;
     importScript(src: URL | string): Promise<ShaeWorkerElement>;
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string): void;
     start(): Promise<ShadowEnv>;
-    destroy(): void;
+    /**
+     * 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.
+     */
+    protected teardown(): void;
 }
 //# sourceMappingURL=ShaeWorkerElement.d.ts.map

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;AAExE,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAE7C,qBAAa,iBAAkB,SAAQ,WAAW;;IAgIhD;;OAEG;IACH,CAAC,SAAS,CAAC,OAAO,CAAC;IAlInB,OAAgB,kBAAkB,WAMhC;IAEF,MAAM,CAAC,eAAe,SAAW;IAEjC,QAAQ,CAAC,mBAAmB,QAAQ;IAEpC,QAAQ,CAAC,SAAS,YAAmB;IAErC,QAAQ,CAAC,MAAM,gBAA0C;IAEzD,SAAS,UAAQ;IAEjB,YAAY,iDAAuB;IACnC,SAAS,gDAAmD;IAC5D,IAAI,gDAAoB;;IAuFxB,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,IAAI,QAAQ,IAIM,GAAG,CAFpB;IAED,IAAI,QAAQ,CAAC,GAAG,EAAE,GAAG,EAKpB;IAED,IAAI,SAAS,IAAI,SAAS,CAGzB;IASK,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmBjE,iBAAiB;IAajB,oBAAoB;IAKX,wBAAwB,CAAC,IAAI,EAAE,MAAM;IA0B9C,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC;IAkB3B,OAAO;CA2ER"}
+{"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"}