@spearwolf/shadow-objects 0.33.0 → 0.34.0

package/src/in-the-dark/ShadowObjectCreationScope.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/in-the-dark/ShadowObjectCreationScope.ts"],
+  "sourcesContent": ["import {emit, on, once, Priority} from '@spearwolf/eventize';\nimport {\n  type CompareFunc,\n  createEffect,\n  createMemo,\n  createSignal,\n  destroySignal,\n  isSignal,\n  link,\n  type Signal,\n  type SignalReader,\n} from '@spearwolf/signalize';\nimport type {Maybe, ProvideContextOptions, ShadowObjectCreationAPI, ShadowObjectType, SignalValueOptions} from '../types.js';\nimport type {ConsoleLogger} from '../utils/ConsoleLogger.js';\nimport {runGuarded} from '../utils/runGuarded.js';\nimport {toMaybe} from '../utils/toMaybe.js';\nimport type {Entity} from './Entity.js';\nimport {onDestroy, onViewEvent} from './events.js';\n\n/**\n * What a creation-API call gets once the scope has closed: a real `Signal`, created and destroyed\n * on the spot. Reading it gives `undefined` and writing to it reaches nobody -- a destroyed signal\n * keeps its value but has neither effect nor link left on it. It belongs to whoever asked for it\n * and goes when they do, so a scope that is asked again and again after its end holds nothing.\n */\nconst inertSignal = (): Signal<any> => {\n  const sig = createSignal<any>(undefined);\n  destroySignal(sig);\n  return sig;\n};\n\n/** The same for `createEffect()`: a real `Effect`, never run, already destroyed. */\nconst inertEffect = (): ReturnType<typeof createEffect> => {\n  const effect = createEffect(() => {}, {autorun: false});\n  effect.destroy();\n  return effect;\n};\n\n/** The handle a late `on()` or `once()` gets: there is no subscription behind it. */\nconst noSubscription = (): void => {};\n\n/**\n * Everything a single shadow-object was given at construction time, and the end of all of it.\n *\n * The scope holds the signals, links and subscriptions the creation API hands out, and it hands the API\n * itself to the kernel through `createAPI()`. The instance stays with the kernel: a shadow-object only ever\n * sees the API object, never the scope behind it.\n *\n * One scope belongs to exactly one shadow-object, and it ends with it -- or, where the constructor throws,\n * without it: a scope that never reached `bindTo()` is torn down by the kernel on the spot, and everything the\n * constructor registered before the throw is released, although no shadow-object came out of it.\n *\n * Eight methods share their name with a module-level import: `on`, `once`, `emit`, `onDestroy`,\n * `onViewEvent`, `createSignal`, `createEffect` and `createMemo`. They are named that way deliberately,\n * because those names are part of the `ShadowObjectCreationAPI` contract a shadow-object destructures by\n * name. Seven of them call or reference their namesake inside their own body; `onDestroy` is the exception,\n * as its import is the entity event that `bindTo()` subscribes to. A bare name inside one of these eight\n * bodies is therefore always the import, and a call on the method of the same name always carries `this.`\n * -- `inertSignal`, `inertEffect` and `noSubscription` are bare names of a different kind, module-level\n * functions with no method of the same name to tell them apart from.\n */\nexport class ShadowObjectCreationScope {\n  readonly #entity: Entity;\n  readonly #logger: ConsoleLogger;\n  readonly #displayName: string;\n\n  // The kernel's list of member names whose deprecation report has already been made. Shared by\n  // every scope of one kernel, which is what makes the report fall once per kernel and name.\n  readonly #shownDeprecations: Set<string>;\n\n  // The cleanup callbacks of the shadow-object itself, registered through `onDestroy()`.\n  readonly #unsubscribePrimary = new Set<() => any>();\n\n  // The cleanup callbacks the creation API registered on its own behalf. A `Set` iterating in\n  // insertion order: which cleanup runs before which is observable behaviour.\n  readonly #unsubscribeSecondary = new Set<() => any>();\n\n  // The releases of the provider feeds, one per context name this shadow-object provides. The\n  // entity hands each of them out when the provider is attached to it, and they fall after every\n  // other cleanup callback, so a write the teardown still makes -- the `undefined` of a\n  // `clearOnDestroy`, or one from an `onDestroy` callback -- reaches the entity-side signal instead\n  // of stopping at the provider. Where the entity lives on, that is what makes the write count: the\n  // entity hands it on to its own context signal one microtask later, and from there to its readers\n  // and to the entities below it. The order matters in the other direction as well, because a\n  // release also lets a provider that stays on the entity write its value once more, and that\n  // hand-over may only happen once the write of the leaving provider is through.\n  //\n  // Where the entity is destroyed, the two kinds of target part ways. The signal behind\n  // `provideContext()` takes the write and keeps it: the microtask that would hand it on falls\n  // after the entity has cleared and destroyed its context signals, and the children that outlive\n  // it were re-bound before the teardown even began. The signal behind `provideGlobalContext()`\n  // stays a member of the kernel-wide chain of its name until the entity's own destruction runs at\n  // `Priority.Min`, so the write does travel on to the inherited signals of other entities -- with\n  // no observable difference, because the entity takes its signal out of that chain in the same run,\n  // and what the chain resolves to without it is what those readers were going to see anyway: the\n  // contribution of the next entity that holds the name, or nothing where there is none. The\n  // ordering is kept for the paths on which it is observable.\n  readonly #unsubscribeContextFeeds = new Set<() => any>();\n\n  readonly #contextReaders = new Map<string | symbol, SignalReader<any>>();\n  readonly #contextReaderCompares = new Map<string | symbol, CompareFunc<any> | undefined>();\n  readonly #contextParentReaders = new Map<string | symbol, SignalReader<any>>();\n  readonly #contextParentReaderCompares = new Map<string | symbol, CompareFunc<any> | undefined>();\n  readonly #contextProviders = new Map<string | symbol, Signal<any>>();\n  readonly #contextRootProviders = new Map<string | symbol, Signal<any>>();\n\n  // The provider signals that already have their `clearOnDestroy` write registered in\n  // `#unsubscribeSecondary`. Keyed by the signal itself rather than by name, because a\n  // `provideContext(name)` and a `provideGlobalContext(name)` call can share one name while landing\n  // in two different maps above -- a name-keyed set would conflate the two providers.\n  readonly #clearOnDestroyRegistered = new Set<Signal<any>>();\n\n  readonly #propertyReaders = new Map<string, SignalReader<any>>();\n  readonly #propertyCompares = new Map<string, CompareFunc<any> | undefined>();\n\n  #shadowObject: ShadowObjectType | undefined;\n  #releaseScope: (() => void) | undefined;\n  #forgetShadowObject: (() => void) | undefined;\n  #unsubscribeFromEntityDestroy: (() => void) | undefined;\n\n  #isTornDown = false;\n\n  // Armed at the *end* of `tearDown()`, not at its start, and the difference is the whole point:\n  // the teardown runs the shadow-object's own cleanup callbacks, and those are allowed the creation\n  // API -- a goodbye to the view, a last write. What they register there is still swept up by the\n  // steps behind them. What arrives after the teardown has returned is not, which is what this\n  // closes.\n  #isCreationApiClosed = false;\n\n  // The member names whose late call has already been reported, at most as many as the API has\n  // members. Lazy, because a scope that is used correctly never allocates it.\n  #lateCallsReported: Set<string> | undefined;\n\n  /**\n   * The name the kernel gave this scope, taken from the constructor it belongs to rather than from\n   * the shadow-object that came out of it. The two agree for most forms -- a class and a function\n   * that returns nothing both leave their own name on the instance's `constructor` -- but not for a\n   * function that returns an object literal: `new` hands that literal back, and it reports `Object`.\n   * Reports about the shadow-object are keyed by this name, so the kernel reads it here instead of\n   * asking the instance.\n   */\n  get displayName(): string {\n    return this.#displayName;\n  }\n\n  /**\n   * The four teardown handles, read without waiting on a garbage collector: a test can check that\n   * `tearDown()` let go of them by comparing this before and after, rather than by proving the\n   * absence of a reference through a `WeakRef`.\n   *\n   * @internal\n   */\n  get debugHandles(): {\n    shadowObject: ShadowObjectType | undefined;\n    releaseScope: (() => void) | undefined;\n    forgetShadowObject: (() => void) | undefined;\n    unsubscribeFromEntityDestroy: (() => void) | undefined;\n  } {\n    return {\n      shadowObject: this.#shadowObject,\n      releaseScope: this.#releaseScope,\n      forgetShadowObject: this.#forgetShadowObject,\n      unsubscribeFromEntityDestroy: this.#unsubscribeFromEntityDestroy,\n    };\n  }\n\n  /**\n   * How many cleanup callbacks the scope is holding, one count per set, read without waiting on a\n   * garbage collector: a test can subscribe and unsubscribe n times and see that the scope let go\n   * of each handle as it went, rather than inferring it from what a collector happened to do.\n   *\n   * @internal\n   */\n  get debugCleanupCounts(): {primary: number; secondary: number; contextFeeds: number} {\n    return {\n      primary: this.#unsubscribePrimary.size,\n      secondary: this.#unsubscribeSecondary.size,\n      contextFeeds: this.#unsubscribeContextFeeds.size,\n    };\n  }\n\n  constructor(entity: Entity, logger: ConsoleLogger, displayName: string, shownDeprecations: Set<string>) {\n    this.#entity = entity;\n    this.#logger = logger;\n    this.#displayName = displayName;\n    this.#shownDeprecations = shownDeprecations;\n  }\n\n  /**\n   * The object that goes into `new construct(\u2026)`.\n   *\n   * Every member is a bound function, because a shadow-object constructor is expected to destructure the\n   * API in its parameter list \u2014 a member that took its receiver from the call site would lose it there.\n   */\n  createAPI(): ShadowObjectCreationAPI {\n    return {\n      entity: this.#entity,\n\n      provideContext: this.provideContext.bind(this),\n      provideGlobalContext: this.provideGlobalContext.bind(this),\n      useContext: this.useContext.bind(this),\n      useParentContext: this.useParentContext.bind(this),\n\n      dispatchMessageToView: this.dispatchMessageToView.bind(this),\n\n      useProperty: this.useProperty.bind(this),\n      useProperties: this.useProperties.bind(this),\n\n      createResource: this.createResource.bind(this),\n      createEffect: this.createEffect.bind(this),\n      createSignal: this.createSignal.bind(this),\n      createMemo: this.createMemo.bind(this),\n\n      on: this.on.bind(this),\n      once: this.once.bind(this),\n      emit: this.emit.bind(this),\n      onViewEvent: this.onViewEvent.bind(this),\n      onDestroy: this.onDestroy.bind(this),\n    };\n  }\n\n  /**\n   * Binds the scope to the shadow-object it made the API for and subscribes to the destruction of the entity.\n   *\n   * A shadow-object reaches its end on two independent paths: the entity is destroyed, or the shadow-object\n   * leaves the constructor set of a still living entity (token or route change). Both run the same teardown,\n   * and each path reaches it through a handle of its own.\n   *\n   * The kernel keeps two releases rather than one, because they belong to opposite ends of the teardown:\n   * `releaseScope` runs at its start, `forgetShadowObject` at its end.\n   *\n   * One scope serves one shadow-object, once: the call is part of the contract, and both ways of breaking\n   * it are refused below.\n   */\n  bindTo(shadowObject: ShadowObjectType, releaseScope: () => void, forgetShadowObject: () => void): void {\n    // Refused rather than quietly returned, unlike `tearDown()`, where a second call is two teardown paths\n    // legitimately meeting. A second binding is nothing of the sort -- it would mean one scope serving two\n    // shadow-objects. It would replace the handles of the first: the release of the kernel's map entry and\n    // the unsubscribe from the entity's `onDestroy`, leaving the first shadow-object standing in the kernel\n    // and on the entity with nothing left to take it out.\n    //\n    // The teardown is asked about first, because it is the only one of the two checks that still applies to\n    // a torn-down scope: `tearDown()` lets go of `#shadowObject` at its own end, so a scope that has already\n    // torn down would otherwise sail straight past the second check below and rebind. Once a scope carries a\n    // shadow-object, it is the second check that tells a live scope's first binding from its second -- the\n    // two never overlap on a scope that is still live.\n    if (this.#isTornDown) {\n      throw new Error(`the creation scope of \"${this.#displayName}\" has torn down and cannot be bound`);\n    }\n    if (this.#shadowObject !== undefined) {\n      throw new Error(`the creation scope of \"${this.#displayName}\" is already bound to a shadow-object`);\n    }\n\n    this.#shadowObject = shadowObject;\n    this.#releaseScope = releaseScope;\n    this.#forgetShadowObject = forgetShadowObject;\n\n    this.#logger.info('create shadow-object', this.#displayName, {shadowObject, entity: this.#entity});\n\n    this.#unsubscribeFromEntityDestroy = once(this.#entity, onDestroy, Priority.Low, () => {\n      this.tearDown();\n    });\n  }\n\n  /**\n   * Runs once, whichever path reaches it first.\n   *\n   * Three lead here. Two belong to a shadow-object that lived: its entity is destroyed, or it leaves the\n   * constructor set of an entity that stays. On the third, the kernel calls this directly on a scope that\n   * `bindTo()` never saw, because the constructor threw -- there is no shadow-object then, and three of the\n   * handles below are still unset (`#releaseScope` and `#unsubscribeFromEntityDestroy` at the start,\n   * `#forgetShadowObject` at the end), which is why all three are called optionally.\n   *\n   * The provider feeds are released after everything else, so that a write made on the way out reaches the\n   * entity-side signal rather than stopping at the provider, and so that the entity hands the context over to\n   * a provider that stays only once that write is through.\n   *\n   * The flag makes the teardown a one-time act: a destroy callback reaching back into the kernel finds no\n   * way to start it a second time. Releasing both handles right after ends the retention in both directions\n   * -- the kernel's map points from the shadow-object to this scope, the subscription points from the entity\n   * to the same scope.\n   *\n   * The kernel is told to forget the shadow-object at the very end, so a destroy callback that reaches back\n   * into the kernel still finds its shadow-object listed among the ones the constructor created. Once that\n   * call is through, the four handles above are let go of as well -- the shadow-object, both kernel releases\n   * and the entity subscription -- so a scope past this point holds none of the four through these fields.\n   *\n   * Every step below runs behind its own guard, so a callback or signal teardown that throws does not stop\n   * the ones after it: the remaining callbacks, the remaining signal releases, and the provider feed\n   * hand-over all still happen. A caught error goes to the logger by displayName and the label of the step\n   * that failed, and is not re-thrown -- neither `changeToken()` nor `destroyEntity()` deliver it to their\n   * caller, nor does it stop the destroy notification the entity is still delivering to whatever comes after\n   * this shadow-object in the same run.\n   *\n   * The creation API is closed as the very last step, after everything above has run. Until then it\n   * is open, because the cleanup callbacks of the shadow-object run inside this method and are\n   * entitled to it -- a last message to the view, a last write to a context. What such a callback\n   * registers is still reached by the steps behind it. The two sets of cleanup callbacks are run\n   * in rounds until neither has anything left, so a callback that another one registers is reached\n   * whichever of the two it lands in. The context feed releases follow all of them. What arrives\n   * once this method has returned is not, and is turned away by `#refuseAfterTearDown()`.\n   */\n  tearDown(): void {\n    if (this.#isTornDown) return;\n    this.#isTornDown = true;\n\n    this.#runGuarded('scope release', () => this.#releaseScope?.());\n    this.#runGuarded('entity destroy subscription', () => this.#unsubscribeFromEntityDestroy?.());\n\n    // Without a shadow-object there is nothing to report here: none ever came to be, because the\n    // constructor threw before it could.\n    if (this.#shadowObject !== undefined) {\n      this.#logger.info('destroy shadow-object', this.#displayName, {shadowObject: this.#shadowObject, entity: this.#entity});\n    }\n\n    // The two callback sets are run in rounds, and the rounds are what a cleanup that books into a\n    // set which has already had its turn needs. A `for\u2026of` over a `Set` reaches what is added to it\n    // while it runs, so a callback that registers another one of its own kind is caught by the pass\n    // it stands in. Across the two sets there is no such reach: a creation-api cleanup that calls\n    // `onDestroy()` books into the first set, which is through, and a callback pulled along that way\n    // may take a subscription or create a signal, which books back into the second. Each of them gets\n    // its turn here, and the teardown ends when neither set has anything left to run. A pass skips\n    // what has already run, so a callback that hands itself in again is not called twice; one that\n    // hands in a new callback every time does not terminate.\n    const alreadyRun = new Set<() => any>();\n\n    const runCleanups = (callbacks: Set<() => any>, step: string): boolean => {\n      let ranAny = false;\n      for (const callback of callbacks) {\n        if (alreadyRun.has(callback)) continue;\n        alreadyRun.add(callback);\n        ranAny = true;\n        this.#runGuarded(step, callback);\n      }\n      return ranAny;\n    };\n\n    let ranAnything = true;\n    while (ranAnything) {\n      const ranPrimary = runCleanups(this.#unsubscribePrimary, 'onDestroy callback');\n      const ranSecondary = runCleanups(this.#unsubscribeSecondary, 'creation-api cleanup');\n      ranAnything = ranPrimary || ranSecondary;\n    }\n\n    for (const callback of this.#unsubscribeContextFeeds) {\n      this.#runGuarded('context feed release', callback);\n    }\n\n    for (const sig of this.#contextReaders.values()) {\n      this.#runGuarded('context reader', () => destroySignal(sig));\n    }\n\n    for (const sig of this.#contextParentReaders.values()) {\n      this.#runGuarded('parent context reader', () => destroySignal(sig));\n    }\n\n    for (const sig of this.#propertyReaders.values()) {\n      this.#runGuarded('property reader', () => destroySignal(sig));\n    }\n\n    for (const sig of this.#contextProviders.values()) {\n      this.#runGuarded('context provider', () => destroySignal(sig));\n    }\n\n    for (const sig of this.#contextRootProviders.values()) {\n      this.#runGuarded('global context provider', () => destroySignal(sig));\n    }\n\n    this.#unsubscribePrimary.clear();\n    this.#unsubscribeSecondary.clear();\n    this.#unsubscribeContextFeeds.clear();\n    this.#contextReaders.clear();\n    this.#contextReaderCompares.clear();\n    this.#contextParentReaders.clear();\n    this.#contextParentReaderCompares.clear();\n    this.#propertyReaders.clear();\n    this.#propertyCompares.clear();\n    this.#contextProviders.clear();\n    this.#contextRootProviders.clear();\n    this.#clearOnDestroyRegistered.clear();\n\n    this.#runGuarded('forget shadow-object', () => this.#forgetShadowObject?.());\n\n    // Let go of the shadow-object and both kernel handles: nothing reads them past this point --\n    // the info line above already ran, `#releaseScope` and `#unsubscribeFromEntityDestroy` were\n    // called at the start of this method, and `#forgetShadowObject` was just called above. A scope\n    // past this point holds neither the shadow-object nor either kernel handle through these\n    // fields. `#entity` is a separate, `readonly` field the scope carries for its whole life --\n    // it stays set here, and the entity, with the kernel behind it, stays reachable through it\n    // whether or not the scope has torn down.\n    this.#shadowObject = undefined;\n    this.#releaseScope = undefined;\n    this.#forgetShadowObject = undefined;\n    this.#unsubscribeFromEntityDestroy = undefined;\n\n    this.#isCreationApiClosed = true;\n  }\n\n  /**\n   * Isolates one teardown step from the ones around it: a step that throws is reported through the\n   * logger -- ungated, so the report stays visible outside localhost -- and does not stop `tearDown()`\n   * from reaching the steps that follow. The report goes out through the shared `runGuarded()`;\n   * what this wrapper adds is the label of the step and the display name it belongs to.\n   */\n  #runGuarded(step: string, run: () => void): void {\n    runGuarded(this.#logger, run, `shadow-object teardown failed (${step}):`, this.#displayName);\n  }\n\n  /**\n   * Books an `on()` or `once()` subscription into the cleanup set and hands back a handle that takes\n   * it out again. Unsubscribing releases the callback there and then rather than at the teardown, so\n   * a shadow-object that subscribes and unsubscribes over the whole life of its entity holds one\n   * handle at a time instead of one per call. The target makes no difference to that: a subscription\n   * on the entity ends the same way one on any other object does.\n   */\n  #trackSubscription(unsubscribe: () => void): () => void {\n    this.#unsubscribeSecondary.add(unsubscribe);\n\n    return Object.assign(() => {\n      this.#unsubscribeSecondary.delete(unsubscribe);\n      unsubscribe();\n    }, unsubscribe);\n  }\n\n  /**\n   * The body the three cached readers share: one reader per name, created on the first call and fed\n   * from the entity-side source, plus a warning when a later call brings a different {compare}\n   * function than the one the reader was created with.\n   *\n   * `linkSource` is a thunk because the source may only be read when a reader is actually created.\n   */\n  #cachedReader<K extends string | symbol>(\n    name: K,\n    readers: Map<K, SignalReader<any>>,\n    compares: Map<K, CompareFunc<any> | undefined>,\n    linkSource: () => SignalReader<any>,\n    opts: SignalValueOptions<any> | undefined,\n    apiName: string,\n    subject: string,\n  ): SignalReader<any> {\n    let reader = readers.get(name);\n\n    if (reader === undefined) {\n      reader = createSignal<any>(undefined, opts).get;\n      readers.set(name, reader);\n      compares.set(name, opts?.compare);\n      // Destroying this link is what ends the feed: the entity-side signal must not go on writing\n      // into a reader that the teardown has already destroyed.\n      const ln = link(linkSource(), reader);\n      this.#unsubscribeSecondary.add(ln.destroy.bind(ln));\n    } else if (opts?.compare != null && compares.get(name) !== opts.compare) {\n      // Through `error` for the same reason as the deprecation report below: the options of this\n      // call are being dropped, and the caller has to hear that outside `localhost` too, where the\n      // shared `enable` behind `isWarn` is off.\n      this.#logger.error(\n        `[shadow-objects] ${apiName}(\"${String(name)}\"): the cached signal already exists with a different (or no) {compare} function \u2014 the new options are ignored. Pass options only on the first call per ${subject}.`,\n      );\n    }\n\n    return reader;\n  }\n\n  /**\n   * Reports the deprecated call form in which a bare compare function stands where the options\n   * object belongs, at most once per kernel and member name.\n   *\n   * Through `error` rather than `warn`: this names a mistake in the calling code, and its author\n   * has to see it wherever the application runs. `logger.warn` is asked `isWarn` first, and the\n   * shared `enable` behind that getter is off anywhere but `localhost` -- a deprecation notice\n   * that goes silent everywhere the code actually ships is no notice at all. See the table of\n   * call against getter under \"Console Logger\" in `docs/api-reference.md`.\n   *\n   * One line per kernel and member name: a shadow-object calling a deprecated member inside a\n   * loop would otherwise fill the console.\n   */\n  #reportDeprecatedIsEqualOption(options: unknown, apiName: string): void {\n    if (typeof options !== 'function' || this.#shownDeprecations.has(apiName)) return;\n    this.#logger.error(\n      `[shadow-objects] Deprecation Warning: The \"isEqual\" option of \"${apiName}()\" is now passed as {compare} argument. Please update your code accordingly.`,\n    );\n    this.#shownDeprecations.add(apiName);\n  }\n\n  /**\n   * Answers whether the creation API still has anything to give, and reports it where it has not.\n   *\n   * Past the teardown the scope has released what it held and cleared what it tracked. A call\n   * arriving now would fill those maps again with entries no second teardown ever reaches -- the\n   * teardown runs once, and it has run. Such a call is therefore turned away rather than served.\n   *\n   * Turned away quietly: the callers that arrive late are the ones with nobody to catch a throw --\n   * a timer, a continuation behind an `await`, a callback of some other object that outlived this\n   * one. It is reported instead, through `error` for the same reason the deprecation report above\n   * uses it: this names a mistake in the calling code, and its author has to see it wherever the\n   * application runs. Once per member name and scope, because a stale timer comes back on its next\n   * tick and a line per tick would bury the first one.\n   */\n  #refuseAfterTearDown(apiName: string): boolean {\n    if (!this.#isCreationApiClosed) return false;\n\n    if (!this.#lateCallsReported?.has(apiName)) {\n      (this.#lateCallsReported ??= new Set()).add(apiName);\n      this.#logger.error(\n        `[shadow-objects] ${apiName}(): the creation scope of \"${this.#displayName}\" has torn down \u2014 the call does nothing. Something is still holding the creation API past the end of its shadow-object.`,\n      );\n    }\n\n    return true;\n  }\n\n  useProperty<T = unknown>(name: string, options?: SignalValueOptions<T> | CompareFunc<T | undefined>): SignalReader<Maybe<T>> {\n    if (this.#refuseAfterTearDown('useProperty')) return inertSignal().get;\n\n    this.#reportDeprecatedIsEqualOption(options, 'useProperty');\n\n    const opts = typeof options === 'function' ? {compare: options} : options;\n\n    return this.#cachedReader(\n      name,\n      this.#propertyReaders,\n      this.#propertyCompares,\n      () => this.#entity.getPropertyReader(name),\n      opts,\n      'useProperty',\n      'property',\n    );\n  }\n\n  useProperties<T extends Record<string, unknown> = Record<string, unknown>>(\n    props: {[K in keyof T]: string},\n  ): {\n    [K in keyof T]: SignalReader<Maybe<T[K]>>;\n  } {\n    const result = {} as {[K in keyof T]: SignalReader<Maybe<T[K]>>};\n    for (const key in props) {\n      if (Object.hasOwn(props, key)) {\n        result[key] = this.useProperty<T[typeof key]>(props[key]);\n      }\n    }\n    return result;\n  }\n\n  /**\n   * The body the two context providers share: one provider signal per name, created on the first\n   * call, attached to the entity-side context signal, and cleared on teardown unless the caller\n   * opted out -- a clearing that finds the way to the entity side still open. A source signal handed\n   * in instead of an initial value feeds the provider through a link of its own.\n   *\n   * The entity keeps every provider of a name together and answers the attachment with the release\n   * that detaches this one again. Releasing it does more than cut the feed: the entity then lets a\n   * provider that stays write its value once more, so the name ends up with a value that is actually\n   * still being provided rather than with what this shadow-object left behind on its way out.\n   *\n   * `attachToEntity` is called inside the creation branch only, so the entity-side signal is\n   * requested when a provider is actually created. The `clearOnDestroy` check sits outside that\n   * branch: every call is allowed to ask for the clearing, not only the one that created the signal.\n   * The request is booked once per provider, though -- a repeated ask does not queue a second write,\n   * and once a provider has one on file, an opt-out on a later call does not take it back.\n   */\n  #provideContextSignal(\n    name: string | symbol,\n    providers: Map<string | symbol, Signal<any>>,\n    attachToEntity: (provider: Signal<any>) => () => void,\n    sourceOrInitialValue: unknown,\n    opts: ProvideContextOptions<any> | undefined,\n  ): Signal<any> {\n    let ctxProvider = providers.get(name);\n\n    if (ctxProvider == null) {\n      const isSig = isSignal(sourceOrInitialValue);\n      const initialValue = isSig ? undefined : toMaybe(sourceOrInitialValue);\n\n      ctxProvider = createSignal(initialValue, opts?.compare ? {compare: opts.compare} : undefined);\n\n      if (isSig) {\n        const ln = link(sourceOrInitialValue as SignalReader<any>, ctxProvider);\n        this.#unsubscribeSecondary.add(ln.destroy.bind(ln));\n      }\n\n      // The release runs after every `clearOnDestroy` callback below, so a write to `undefined`\n      // still reaches the context signal on the entity side before the feed is cut.\n      this.#unsubscribeContextFeeds.add(attachToEntity(ctxProvider));\n      providers.set(name, ctxProvider);\n    }\n\n    if ((opts?.clearOnDestroy ?? true) && !this.#clearOnDestroyRegistered.has(ctxProvider)) {\n      this.#clearOnDestroyRegistered.add(ctxProvider);\n      this.#unsubscribeSecondary.add(() => {\n        ctxProvider.set(undefined);\n      });\n    }\n\n    return ctxProvider;\n  }\n\n  provideContext<T = unknown>(\n    name: string | symbol,\n    sourceOrInitialValue?: T | SignalReader<T> | SignalReader<T | undefined>,\n    options?: ProvideContextOptions<T> | CompareFunc<T | undefined>,\n  ) {\n    if (this.#refuseAfterTearDown('provideContext')) return inertSignal();\n\n    this.#reportDeprecatedIsEqualOption(options, 'provideContext');\n\n    const opts = typeof options === 'function' ? {compare: options} : options;\n\n    return this.#provideContextSignal(\n      name,\n      this.#contextProviders,\n      (provider) => this.#entity.attachContextProvider(name, provider),\n      sourceOrInitialValue,\n      opts,\n    );\n  }\n\n  provideGlobalContext<T = unknown>(\n    name: string | symbol,\n    sourceOrInitialValue?: T | SignalReader<T> | SignalReader<T | undefined>,\n    options?: ProvideContextOptions<T> | CompareFunc<T | undefined>,\n  ) {\n    if (this.#refuseAfterTearDown('provideGlobalContext')) return inertSignal();\n\n    this.#reportDeprecatedIsEqualOption(options, 'provideGlobalContext');\n\n    const opts = typeof options === 'function' ? {compare: options} : options;\n\n    return this.#provideContextSignal(\n      name,\n      this.#contextRootProviders,\n      (provider) => this.#entity.attachGlobalContextProvider(name, provider),\n      sourceOrInitialValue,\n      opts,\n    );\n  }\n\n  useContext<T = unknown>(name: string | symbol, options?: SignalValueOptions<T> | CompareFunc<T | undefined>) {\n    if (this.#refuseAfterTearDown('useContext')) return inertSignal().get;\n\n    this.#reportDeprecatedIsEqualOption(options, 'useContext');\n\n    const opts = typeof options === 'function' ? {compare: options} : options;\n\n    return this.#cachedReader(\n      name,\n      this.#contextReaders,\n      this.#contextReaderCompares,\n      () => this.#entity.useContext(name),\n      opts,\n      'useContext',\n      'context',\n    );\n  }\n\n  useParentContext<T = unknown>(name: string | symbol, options?: SignalValueOptions<T> | CompareFunc<T | undefined>) {\n    if (this.#refuseAfterTearDown('useParentContext')) return inertSignal().get;\n\n    this.#reportDeprecatedIsEqualOption(options, 'useParentContext');\n\n    const opts = typeof options === 'function' ? {compare: options} : options;\n\n    return this.#cachedReader(\n      name,\n      this.#contextParentReaders,\n      this.#contextParentReaderCompares,\n      () => this.#entity.useParentContext(name),\n      opts,\n      'useParentContext',\n      'parent context',\n    );\n  }\n\n  createSignal(...args: any[]): any {\n    if (this.#refuseAfterTearDown('createSignal')) return inertSignal();\n\n    // @ts-ignore\n    const sig = createSignal(...args);\n    this.#unsubscribeSecondary.add(() => {\n      destroySignal(sig);\n    });\n    return sig;\n  }\n\n  createEffect(...args: any[]): ReturnType<typeof createEffect> {\n    if (this.#refuseAfterTearDown('createEffect')) return inertEffect();\n\n    // @ts-ignore\n    const effect = createEffect(...args);\n    this.#unsubscribeSecondary.add(effect.destroy);\n    return effect;\n  }\n\n  createMemo<T = unknown>(...args: Parameters<typeof createMemo<T>>): SignalReader<T> {\n    if (this.#refuseAfterTearDown('createMemo')) return inertSignal().get;\n\n    const sig = createMemo<T>(...args);\n    this.#unsubscribeSecondary.add(() => {\n      destroySignal(sig);\n    });\n    return sig;\n  }\n\n  createResource<T = unknown>(factory: () => T | undefined, cleanup?: (resource: NonNullable<T>) => unknown): Signal<Maybe<T>> {\n    if (this.#refuseAfterTearDown('createResource')) return inertSignal();\n\n    const resourceSignal = createSignal<Maybe<T>>();\n\n    const effect = createEffect(() => {\n      const resource = toMaybe(factory());\n      resourceSignal.set(resource);\n\n      if (resource !== undefined && cleanup) {\n        return () => {\n          cleanup(resource);\n          resourceSignal.set(undefined);\n        };\n      }\n\n      return () => {\n        resourceSignal.set(undefined);\n      };\n    });\n\n    this.#unsubscribeSecondary.add(() => {\n      // `effect.destroy()` runs the consumer's `cleanup`, which may throw. The two releases below\n      // still have to run in that case -- a `finally` reaches them without swallowing the throw, so\n      // `#runGuarded()` in `tearDown()` still sees and reports it.\n      try {\n        effect.destroy();\n      } finally {\n        resourceSignal.set(undefined);\n        destroySignal(resourceSignal);\n      }\n    });\n\n    return resourceSignal;\n  }\n\n  on(...args: any[]): ReturnType<typeof on> {\n    if (this.#refuseAfterTearDown('on')) return noSubscription;\n\n    const [firstArg] = args;\n    const unsubscribe =\n      typeof firstArg === 'string' || typeof firstArg === 'symbol' || Array.isArray(firstArg)\n        ? // @ts-ignore\n          on(this.#entity, ...args)\n        : // @ts-ignore\n          on(...args);\n\n    return this.#trackSubscription(unsubscribe);\n  }\n\n  once(...args: any[]): ReturnType<typeof once> {\n    if (this.#refuseAfterTearDown('once')) return noSubscription;\n\n    const [firstArg] = args;\n    const unsubscribe =\n      typeof firstArg === 'string' || typeof firstArg === 'symbol' || Array.isArray(firstArg)\n        ? // @ts-ignore\n          once(this.#entity, ...args)\n        : // @ts-ignore\n          once(...args);\n\n    return this.#trackSubscription(unsubscribe);\n  }\n\n  /**\n   * The plain `emit()`, deliberately, where every notification the framework sends out of its own\n   * accord runs on the guarded dispatch. This one is outbound and belongs to the Shadow Object: it\n   * owns the listeners, a throw from one of them is its own bug, and letting it surface where it\n   * happened is the fastest way to find it. A listener that needs a policy of its own carries a\n   * `try`/`catch` in its own body, which is where that decision belongs.\n   */\n  emit(...args: any[]): void {\n    if (this.#refuseAfterTearDown('emit')) return;\n\n    const [firstArg] = args;\n    if (typeof firstArg === 'string' || typeof firstArg === 'symbol' || Array.isArray(firstArg)) {\n      // @ts-ignore\n      emit(this.#entity, ...args);\n    } else {\n      // @ts-ignore\n      emit(...args);\n    }\n  }\n\n  onViewEvent(callback: (type: string, data: unknown) => any): void {\n    if (this.#refuseAfterTearDown('onViewEvent')) return;\n\n    const unsub = on(this.#entity, onViewEvent, (type: string, data: unknown) => {\n      callback(type, data);\n    });\n    this.#unsubscribeSecondary.add(unsub);\n  }\n\n  onDestroy(callback: () => any): void {\n    if (this.#refuseAfterTearDown('onDestroy')) return;\n\n    this.#unsubscribePrimary.add(callback);\n  }\n\n  dispatchMessageToView(type: string, data?: unknown, transferables?: Transferable[], traverseChildren = false): void {\n    if (this.#refuseAfterTearDown('dispatchMessageToView')) return;\n\n    this.#entity.dispatchMessageToView(type, data, transferables, traverseChildren);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/src/in-the-dark/SignalsPath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SignalsPath.d.ts","sourceRoot":"","sources":["../../../src/in-the-dark/SignalsPath.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,MAAM,EACX,KAAK,UAAU,EAEhB,MAAM,sBAAsB,CAAC;AAK9B,qBAAa,WAAW;;IACtB,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAS;IAKP,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAa;IAEvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;gBAEjB,OAAO,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE;IAavC,GAAG,CAAC,GAAG,OAAO,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE;IAMjD,OAAO,CAAC,GAAG,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE;IAMrC,MAAM,CAAC,GAAG,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE;IAIpC,KAAK;IAKL,OAAO;CA6CR"}
+{"version":3,"file":"SignalsPath.d.ts","sourceRoot":"","sources":["../../../src/in-the-dark/SignalsPath.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,MAAM,EACX,KAAK,UAAU,EAEhB,MAAM,sBAAsB,CAAC;AAK9B,qBAAa,WAAW;;IACtB,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAS;IAKP,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAa;IAEvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAE7B,YAAY,OAAO,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,EAetC;IAED,GAAG,CAAC,GAAG,OAAO,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,cAIhD;IAED,OAAO,CAAC,GAAG,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,cAIpC;IAED,MAAM,CAAC,GAAG,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,QAEnC;IAED,KAAK,SAGJ;IAED,OAAO,SAWN;CAkCF"}

package/src/in-the-dark/SignalsPath.js

@@ -47,7 +47,7 @@ var __privateAdd = (obj, member, value2) => member.has(obj) ? __typeError("Canno
 var __privateSet = (obj, member, value2, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value2) : member.set(obj, value2), value2);
 var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
 var _value_dec, _signals, _effect, _init, _value, _SignalsPath_instances, makeRemoveFunc_fn, updateGetValueFromSignalsEffect_fn;
-import { emit, off, retain, retainClear } from "@spearwolf/eventize";
+import { emitSafe, off, retain, retainClear } from "@spearwolf/eventize";
 import {
   createEffect,
   destroyObjectSignals,
@@ -67,7 +67,7 @@ class SignalsPath {
     this.value$ = void 0;
     retain(this, VALUE);
     this.value$ = findObjectSignalByName(this, VALUE);
-    this.value$.onChange((val) => emit(this, VALUE, val));
+    this.value$.onChange((val) => emitSafe(this, VALUE, val));
     if (signals) {
       this.add(...signals);
     }

package/src/in-the-dark/SignalsPath.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/in-the-dark/SignalsPath.ts"],
-  "sourcesContent": ["import {emit, off, retain, retainClear} from '@spearwolf/eventize';\nimport {\n  createEffect,\n  destroyObjectSignals,\n  Effect,\n  findObjectSignalByName,\n  type Signal,\n  type SignalLike,\n  value,\n} from '@spearwolf/signalize';\nimport {signal} from '@spearwolf/signalize/decorators';\n\nconst VALUE = 'value';\n\nexport class SignalsPath {\n  static readonly Value = VALUE;\n\n  #signals: SignalLike<any>[] = [];\n  #effect?: Effect;\n\n  @signal({name: VALUE}) accessor value: any = undefined;\n\n  readonly value$: Signal<any>;\n\n  constructor(signals?: SignalLike<any>[]) {\n    retain(this as SignalsPath, VALUE);\n\n    // the @signal accessor above creates this signal during field initialization,\n    // so the lookup by that name always resolves once the constructor body runs\n    this.value$ = findObjectSignalByName(this, VALUE)!;\n    this.value$.onChange((val) => emit(this as SignalsPath, VALUE, val));\n\n    if (signals) {\n      this.add(...signals);\n    }\n  }\n\n  add(...signals: (Signal<any> | SignalLike<any>)[]) {\n    this.#signals.push(...signals);\n    this.#updateGetValueFromSignalsEffect();\n    return this.#makeRemoveFunc(signals);\n  }\n\n  unshift(...signals: SignalLike<any>[]) {\n    this.#signals.unshift(...signals);\n    this.#updateGetValueFromSignalsEffect();\n    return this.#makeRemoveFunc(signals);\n  }\n\n  remove(...signals: SignalLike<any>[]) {\n    this.#makeRemoveFunc(signals)();\n  }\n\n  clear() {\n    this.#signals.length = 0;\n    this.#updateGetValueFromSignalsEffect();\n  }\n\n  dispose() {\n    this.clear();\n\n    this.#effect?.destroy();\n    this.#effect = undefined;\n\n    retainClear(this as SignalsPath, VALUE);\n    off(this);\n\n    this.value$.destroy();\n    destroyObjectSignals(this);\n  }\n\n  #makeRemoveFunc(signals: SignalLike<any>[]) {\n    return () => {\n      for (const sig of signals) {\n        const idx = this.#signals.indexOf(sig);\n        if (idx !== -1) {\n          this.#signals.splice(idx, 1);\n        }\n      }\n      this.#updateGetValueFromSignalsEffect();\n    };\n  }\n\n  #updateGetValueFromSignalsEffect() {\n    this.#effect?.destroy();\n    if (this.#signals.length === 0) {\n      this.#effect = undefined;\n      this.value = undefined;\n    } else {\n      this.#effect = createEffect(() => {\n        let valueFromSignals: any;\n        for (const sig of this.#signals) {\n          const val = value(sig);\n          if (val != null) {\n            valueFromSignals = val;\n            break;\n          }\n        }\n        this.value = valueFromSignals;\n      }, this.#signals);\n      this.#effect.run();\n    }\n  }\n}"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA,SAAQ,MAAM,KAAK,QAAQ,mBAAkB;AAC7C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAGA;AAAA,OACK;AACP,SAAQ,cAAa;AAErB,MAAM,QAAQ;AAQZ,cAAC,OAAO,EAAC,MAAM,MAAK,CAAC;AANhB,MAAM,YAAY;AAAA,EAUvB,YAAY,SAA6B;AAVpC;AAGL,iCAA8B,CAAC;AAC/B;AAEuB,uBAAS,QAAa,kBAAtB;AAEvB,SAAS,SAAT;AAGE,WAAO,MAAqB,KAAK;AAIjC,SAAK,SAAS,uBAAuB,MAAM,KAAK;AAChD,SAAK,OAAO,SAAS,CAAC,QAAQ,KAAK,MAAqB,OAAO,GAAG,CAAC;AAEnE,QAAI,SAAS;AACX,WAAK,IAAI,GAAG,OAAO;AAAA,IACrB;AAAA,EACF;AAAA,EAEA,OAAO,SAA4C;AACjD,uBAAK,UAAS,KAAK,GAAG,OAAO;AAC7B,0BAAK,4DAAL;AACA,WAAO,sBAAK,2CAAL,WAAqB;AAAA,EAC9B;AAAA,EAEA,WAAW,SAA4B;AACrC,uBAAK,UAAS,QAAQ,GAAG,OAAO;AAChC,0BAAK,4DAAL;AACA,WAAO,sBAAK,2CAAL,WAAqB;AAAA,EAC9B;AAAA,EAEA,UAAU,SAA4B;AACpC,0BAAK,2CAAL,WAAqB,SAAS;AAAA,EAChC;AAAA,EAEA,QAAQ;AACN,uBAAK,UAAS,SAAS;AACvB,0BAAK,4DAAL;AAAA,EACF;AAAA,EAEA,UAAU;AACR,SAAK,MAAM;AAEX,uBAAK,UAAS,QAAQ;AACtB,uBAAK,SAAU;AAEf,gBAAY,MAAqB,KAAK;AACtC,QAAI,IAAI;AAER,SAAK,OAAO,QAAQ;AACpB,yBAAqB,IAAI;AAAA,EAC3B;AAkCF;AAzFO;AAGL;AACA;AAEgC;AAN3B;AAyDL,oBAAe,SAAC,SAA4B;AAC1C,SAAO,MAAM;AACX,eAAW,OAAO,SAAS;AACzB,YAAM,MAAM,mBAAK,UAAS,QAAQ,GAAG;AACrC,UAAI,QAAQ,IAAI;AACd,2BAAK,UAAS,OAAO,KAAK,CAAC;AAAA,MAC7B;AAAA,IACF;AACA,0BAAK,4DAAL;AAAA,EACF;AACF;AAEA,qCAAgC,WAAG;AACjC,qBAAK,UAAS,QAAQ;AACtB,MAAI,mBAAK,UAAS,WAAW,GAAG;AAC9B,uBAAK,SAAU;AACf,SAAK,QAAQ;AAAA,EACf,OAAO;AACL,uBAAK,SAAU,aAAa,MAAM;AAChC,UAAI;AACJ,iBAAW,OAAO,mBAAK,WAAU;AAC/B,cAAM,MAAM,MAAM,GAAG;AACrB,YAAI,OAAO,MAAM;AACf,6BAAmB;AACnB;AAAA,QACF;AAAA,MACF;AACA,WAAK,QAAQ;AAAA,IACf,GAAG,mBAAK,SAAQ;AAChB,uBAAK,SAAQ,IAAI;AAAA,EACnB;AACF;AAlFuB,4BAAS,SAAhC,YANW,aAMqB;AAN3B,2BAAM;AAAA,YACK,QAAQ;",
+  "sourcesContent": ["import {emitSafe, off, retain, retainClear} from '@spearwolf/eventize';\nimport {\n  createEffect,\n  destroyObjectSignals,\n  Effect,\n  findObjectSignalByName,\n  type Signal,\n  type SignalLike,\n  value,\n} from '@spearwolf/signalize';\nimport {signal} from '@spearwolf/signalize/decorators';\n\nconst VALUE = 'value';\n\nexport class SignalsPath {\n  static readonly Value = VALUE;\n\n  #signals: SignalLike<any>[] = [];\n  #effect?: Effect | undefined;\n\n  @signal({name: VALUE}) accessor value: any = undefined;\n\n  readonly value$: Signal<any>;\n\n  constructor(signals?: SignalLike<any>[]) {\n    retain(this as SignalsPath, VALUE);\n\n    // the @signal accessor above creates this signal during field initialization,\n    // so the lookup by that name always resolves once the constructor body runs\n    this.value$ = findObjectSignalByName(this, VALUE)!;\n    // `emitSafe()`: this runs from a signal change callback, so a listener that throws would leave\n    // through whichever write moved the path and reach code that has nothing to do with this value.\n    // The retained value is written either way, because the event was delivered -- which matters\n    // here, since `Value` is retained and a later subscriber reads exactly that.\n    this.value$.onChange((val) => emitSafe(this as SignalsPath, VALUE, val));\n\n    if (signals) {\n      this.add(...signals);\n    }\n  }\n\n  add(...signals: (Signal<any> | SignalLike<any>)[]) {\n    this.#signals.push(...signals);\n    this.#updateGetValueFromSignalsEffect();\n    return this.#makeRemoveFunc(signals);\n  }\n\n  unshift(...signals: SignalLike<any>[]) {\n    this.#signals.unshift(...signals);\n    this.#updateGetValueFromSignalsEffect();\n    return this.#makeRemoveFunc(signals);\n  }\n\n  remove(...signals: SignalLike<any>[]) {\n    this.#makeRemoveFunc(signals)();\n  }\n\n  clear() {\n    this.#signals.length = 0;\n    this.#updateGetValueFromSignalsEffect();\n  }\n\n  dispose() {\n    this.clear();\n\n    this.#effect?.destroy();\n    this.#effect = undefined;\n\n    retainClear(this as SignalsPath, VALUE);\n    off(this);\n\n    this.value$.destroy();\n    destroyObjectSignals(this);\n  }\n\n  #makeRemoveFunc(signals: SignalLike<any>[]) {\n    return () => {\n      for (const sig of signals) {\n        const idx = this.#signals.indexOf(sig);\n        if (idx !== -1) {\n          this.#signals.splice(idx, 1);\n        }\n      }\n      this.#updateGetValueFromSignalsEffect();\n    };\n  }\n\n  #updateGetValueFromSignalsEffect() {\n    this.#effect?.destroy();\n    if (this.#signals.length === 0) {\n      this.#effect = undefined;\n      this.value = undefined;\n    } else {\n      this.#effect = createEffect(() => {\n        let valueFromSignals: any;\n        for (const sig of this.#signals) {\n          const val = value(sig);\n          if (val != null) {\n            valueFromSignals = val;\n            break;\n          }\n        }\n        this.value = valueFromSignals;\n      }, this.#signals);\n      this.#effect.run();\n    }\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA,SAAQ,UAAU,KAAK,QAAQ,mBAAkB;AACjD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAGA;AAAA,OACK;AACP,SAAQ,cAAa;AAErB,MAAM,QAAQ;AAQZ,cAAC,OAAO,EAAC,MAAM,MAAK,CAAC;AANhB,MAAM,YAAY;AAAA,EAUvB,YAAY,SAA6B;AAVpC;AAGL,iCAA8B,CAAC;AAC/B;AAEuB,uBAAS,QAAa,kBAAtB;AAEvB,SAAS,SAAT;AAGE,WAAO,MAAqB,KAAK;AAIjC,SAAK,SAAS,uBAAuB,MAAM,KAAK;AAKhD,SAAK,OAAO,SAAS,CAAC,QAAQ,SAAS,MAAqB,OAAO,GAAG,CAAC;AAEvE,QAAI,SAAS;AACX,WAAK,IAAI,GAAG,OAAO;AAAA,IACrB;AAAA,EACF;AAAA,EAEA,OAAO,SAA4C;AACjD,uBAAK,UAAS,KAAK,GAAG,OAAO;AAC7B,0BAAK,4DAAL;AACA,WAAO,sBAAK,2CAAL,WAAqB;AAAA,EAC9B;AAAA,EAEA,WAAW,SAA4B;AACrC,uBAAK,UAAS,QAAQ,GAAG,OAAO;AAChC,0BAAK,4DAAL;AACA,WAAO,sBAAK,2CAAL,WAAqB;AAAA,EAC9B;AAAA,EAEA,UAAU,SAA4B;AACpC,0BAAK,2CAAL,WAAqB,SAAS;AAAA,EAChC;AAAA,EAEA,QAAQ;AACN,uBAAK,UAAS,SAAS;AACvB,0BAAK,4DAAL;AAAA,EACF;AAAA,EAEA,UAAU;AACR,SAAK,MAAM;AAEX,uBAAK,UAAS,QAAQ;AACtB,uBAAK,SAAU;AAEf,gBAAY,MAAqB,KAAK;AACtC,QAAI,IAAI;AAER,SAAK,OAAO,QAAQ;AACpB,yBAAqB,IAAI;AAAA,EAC3B;AAkCF;AA7FO;AAGL;AACA;AAEgC;AAN3B;AA6DL,oBAAe,SAAC,SAA4B;AAC1C,SAAO,MAAM;AACX,eAAW,OAAO,SAAS;AACzB,YAAM,MAAM,mBAAK,UAAS,QAAQ,GAAG;AACrC,UAAI,QAAQ,IAAI;AACd,2BAAK,UAAS,OAAO,KAAK,CAAC;AAAA,MAC7B;AAAA,IACF;AACA,0BAAK,4DAAL;AAAA,EACF;AACF;AAEA,qCAAgC,WAAG;AACjC,qBAAK,UAAS,QAAQ;AACtB,MAAI,mBAAK,UAAS,WAAW,GAAG;AAC9B,uBAAK,SAAU;AACf,SAAK,QAAQ;AAAA,EACf,OAAO;AACL,uBAAK,SAAU,aAAa,MAAM;AAChC,UAAI;AACJ,iBAAW,OAAO,mBAAK,WAAU;AAC/B,cAAM,MAAM,MAAM,GAAG;AACrB,YAAI,OAAO,MAAM;AACf,6BAAmB;AACnB;AAAA,QACF;AAAA,MACF;AACA,WAAK,QAAQ;AAAA,IACf,GAAG,mBAAK,SAAQ;AAChB,uBAAK,SAAQ,IAAI;AAAA,EACnB;AACF;AAtFuB,4BAAS,SAAhC,YANW,aAMqB;AAN3B,2BAAM;AAAA,YACK,QAAQ;",
   "names": []
 }

package/src/in-the-dark/events.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/in-the-dark/events.ts"],
-  "sourcesContent": ["import type {Entity} from './Entity.js';\n\n// ----------------------------------------------------------------------------\n\nexport const onCreate = Symbol('onCreate');\n\nexport interface OnCreate {\n  /**\n   * Is called when the shadow-object instance has been created and attached to the entity.\n   *\n   * This can be the case when the entity is being initialized, or when the already initialized entity has received a token change.\n   *\n   * Only the shadow-object gets this event.\n   * The entity does not get this event.\n   */\n  [onCreate](entity: Entity): void;\n}\n\n// ----------------------------------------------------------------------------\n\nexport const onDestroy = Symbol('onDestroy');\n\nexport interface OnDestroy {\n  /**\n   * Is called when the shadow-object is about to be destroyed.\n   * Only the shadow-object gets this event.\n   * The entity does not get this event.\n   */\n  [onDestroy](entity: Entity): void;\n}\n\n// ----------------------------------------------------------------------------\n\nexport const onParentChanged = Symbol('onParentChanged');\n\nexport interface OnParentChangedEvent {\n  [onParentChanged](entity: Entity): void;\n}\n\n// ----------------------------------------------------------------------------\n\nexport const onViewEvent = Symbol('onViewEvent');\n\nexport interface OnViewEvent {\n  [onViewEvent](type: string, data: unknown): void;\n}"],
+  "sourcesContent": ["import type {Entity} from './Entity.js';\n\n// ----------------------------------------------------------------------------\n\nexport const onCreate = Symbol('onCreate');\n\nexport interface OnCreate {\n  /**\n   * Is called when the shadow-object instance has been created and attached to the entity.\n   *\n   * This can be the case when the entity is being initialized, or when the already initialized entity has received a token change.\n   *\n   * Only the shadow-object gets this event.\n   * The entity does not get this event.\n   */\n  [onCreate](entity: Entity): void;\n}\n\n// ----------------------------------------------------------------------------\n\nexport const onDestroy = Symbol('onDestroy');\n\nexport interface OnDestroy {\n  /**\n   * Is called when the shadow-object is about to be destroyed.\n   * Only the shadow-object gets this event.\n   * The entity does not get this event.\n   */\n  [onDestroy](entity: Entity): void;\n}\n\n// ----------------------------------------------------------------------------\n\nexport const onParentChanged = Symbol('onParentChanged');\n\nexport interface OnParentChangedEvent {\n  [onParentChanged](entity: Entity): void;\n}\n\n// ----------------------------------------------------------------------------\n\nexport const onViewEvent = Symbol('onViewEvent');\n\nexport interface OnViewEvent {\n  [onViewEvent](type: string, data: unknown): void;\n}\n"],
   "mappings": "AAIO,MAAM,WAAW,uBAAO,UAAU;AAgBlC,MAAM,YAAY,uBAAO,WAAW;AAapC,MAAM,kBAAkB,uBAAO,iBAAiB;AAQhD,MAAM,cAAc,uBAAO,aAAa;",
   "names": []
 }

package/src/in-the-dark/importModule.d.ts

@@ -1,4 +1,11 @@
 import type { ShadowObjectsModule } from '../types.js';
 import type { Kernel } from './Kernel.js';
+/**
+ * The wording both environments use when a module they import carries no `shadowObjects` export.
+ * `worker/MessageRouter.ts` puts it in the `error` field of the `ImportedModule` message it posts
+ * to the view, where `view/RemoteWorkerEnv.ts` builds an `Error` from it;
+ * `view/LocalShadowObjectEnv.ts` rejects `importScript()` with such an `Error` directly.
+ */
+export declare const missingShadowObjectsExportMessage = "module has no \"shadowObjects\" export";
 export declare function importModule(kernel: Kernel, module: ShadowObjectsModule, importedModules: Set<ShadowObjectsModule>, upgradeEntities?: boolean): Promise<void>;
 //# sourceMappingURL=importModule.d.ts.map

package/src/in-the-dark/importModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"importModule.d.ts","sourceRoot":"","sources":["../../../src/in-the-dark/importModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA0B,mBAAmB,EAAC,MAAM,aAAa,CAAC;AAC9E,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AAExC,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,mBAAmB,EAC3B,eAAe,EAAE,GAAG,CAAC,mBAAmB,CAAC,EACzC,eAAe,UAAO,GACrB,OAAO,CAAC,IAAI,CAAC,CAmCf"}
+{"version":3,"file":"importModule.d.ts","sourceRoot":"","sources":["../../../src/in-the-dark/importModule.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA0B,mBAAmB,EAAC,MAAM,aAAa,CAAC;AAC9E,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,2CAAkD,CAAC;AAEjG,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,mBAAmB,EAC3B,eAAe,EAAE,GAAG,CAAC,mBAAmB,CAAC,EACzC,eAAe,UAAO,GACrB,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/src/in-the-dark/importModule.js

@@ -1,6 +1,8 @@
+import { ShadowObjectsExport } from "../constants.js";
+const missingShadowObjectsExportMessage = `module has no "${ShadowObjectsExport}" export`;
 async function importModule(kernel, module, importedModules, upgradeEntities = true) {
   if (importedModules.has(module)) {
-    console.warn("importModule: skipping already imported module", module);
+    kernel.logger.warn("importModule: skipping already imported module", module);
     return;
   } else {
     importedModules.add(module);
@@ -29,6 +31,7 @@ async function importModule(kernel, module, importedModules, upgradeEntities = t
   }
 }
 export {
-  importModule
+  importModule,
+  missingShadowObjectsExportMessage
 };
 //# sourceMappingURL=importModule.js.map

package/src/in-the-dark/importModule.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/in-the-dark/importModule.ts"],
-  "sourcesContent": ["import type {ShadowObjectConstructor, ShadowObjectsModule} from '../types.js';\nimport type {Kernel} from './Kernel.js';\n\nexport async function importModule(\n  kernel: Kernel,\n  module: ShadowObjectsModule,\n  importedModules: Set<ShadowObjectsModule>,\n  upgradeEntities = true,\n): Promise<void> {\n  if (importedModules.has(module)) {\n    console.warn('importModule: skipping already imported module', module);\n    return;\n  } else {\n    importedModules.add(module);\n  }\n\n  if (module.extends) {\n    await Promise.all(module.extends.map((subModule) => importModule(kernel, subModule, importedModules, false)));\n  }\n\n  const {registry} = kernel;\n\n  if (module.define) {\n    for (const [token, constructa] of Object.entries(module.define)) {\n      registry.define(token, constructa as ShadowObjectConstructor);\n    }\n  }\n\n  if (module.routes) {\n    for (const [token, routes] of Object.entries(module.routes)) {\n      registry.appendRoute(token, routes);\n    }\n  }\n\n  await (module.initialize?.({\n    define: (token, constructa) => registry.define(token, constructa as ShadowObjectConstructor),\n    kernel,\n    registry,\n  }) ?? Promise.resolve());\n\n  if (upgradeEntities) {\n    kernel.upgradeEntities();\n  }\n}"],
-  "mappings": "AAGA,eAAsB,aACpB,QACA,QACA,iBACA,kBAAkB,MACH;AACf,MAAI,gBAAgB,IAAI,MAAM,GAAG;AAC/B,YAAQ,KAAK,kDAAkD,MAAM;AACrE;AAAA,EACF,OAAO;AACL,oBAAgB,IAAI,MAAM;AAAA,EAC5B;AAEA,MAAI,OAAO,SAAS;AAClB,UAAM,QAAQ,IAAI,OAAO,QAAQ,IAAI,CAAC,cAAc,aAAa,QAAQ,WAAW,iBAAiB,KAAK,CAAC,CAAC;AAAA,EAC9G;AAEA,QAAM,EAAC,SAAQ,IAAI;AAEnB,MAAI,OAAO,QAAQ;AACjB,eAAW,CAAC,OAAO,UAAU,KAAK,OAAO,QAAQ,OAAO,MAAM,GAAG;AAC/D,eAAS,OAAO,OAAO,UAAqC;AAAA,IAC9D;AAAA,EACF;AAEA,MAAI,OAAO,QAAQ;AACjB,eAAW,CAAC,OAAO,MAAM,KAAK,OAAO,QAAQ,OAAO,MAAM,GAAG;AAC3D,eAAS,YAAY,OAAO,MAAM;AAAA,IACpC;AAAA,EACF;AAEA,SAAO,OAAO,aAAa;AAAA,IACzB,QAAQ,CAAC,OAAO,eAAe,SAAS,OAAO,OAAO,UAAqC;AAAA,IAC3F;AAAA,IACA;AAAA,EACF,CAAC,KAAK,QAAQ,QAAQ;AAEtB,MAAI,iBAAiB;AACnB,WAAO,gBAAgB;AAAA,EACzB;AACF;",
+  "sourcesContent": ["import {ShadowObjectsExport} from '../constants.js';\nimport type {ShadowObjectConstructor, ShadowObjectsModule} from '../types.js';\nimport type {Kernel} from './Kernel.js';\n\n/**\n * The wording both environments use when a module they import carries no `shadowObjects` export.\n * `worker/MessageRouter.ts` puts it in the `error` field of the `ImportedModule` message it posts\n * to the view, where `view/RemoteWorkerEnv.ts` builds an `Error` from it;\n * `view/LocalShadowObjectEnv.ts` rejects `importScript()` with such an `Error` directly.\n */\nexport const missingShadowObjectsExportMessage = `module has no \"${ShadowObjectsExport}\" export`;\n\nexport async function importModule(\n  kernel: Kernel,\n  module: ShadowObjectsModule,\n  importedModules: Set<ShadowObjectsModule>,\n  upgradeEntities = true,\n): Promise<void> {\n  if (importedModules.has(module)) {\n    // `warn`, not `error`, unlike the reports of the creation API: a module two `extends` chains\n    // have in common is a shape of the module graph and not a mistake, so this line only tells\n    // during development. See the table of call against getter under \"Console Logger\" in\n    // `docs/api-reference.md`.\n    kernel.logger.warn('importModule: skipping already imported module', module);\n    return;\n  } else {\n    importedModules.add(module);\n  }\n\n  if (module.extends) {\n    await Promise.all(module.extends.map((subModule) => importModule(kernel, subModule, importedModules, false)));\n  }\n\n  const {registry} = kernel;\n\n  if (module.define) {\n    for (const [token, constructa] of Object.entries(module.define)) {\n      registry.define(token, constructa as ShadowObjectConstructor);\n    }\n  }\n\n  if (module.routes) {\n    for (const [token, routes] of Object.entries(module.routes)) {\n      registry.appendRoute(token, routes);\n    }\n  }\n\n  await (module.initialize?.({\n    define: (token, constructa) => registry.define(token, constructa as ShadowObjectConstructor),\n    kernel,\n    registry,\n  }) ?? Promise.resolve());\n\n  if (upgradeEntities) {\n    kernel.upgradeEntities();\n  }\n}\n"],
+  "mappings": "AAAA,SAAQ,2BAA0B;AAU3B,MAAM,oCAAoC,kBAAkB,mBAAmB;AAEtF,eAAsB,aACpB,QACA,QACA,iBACA,kBAAkB,MACH;AACf,MAAI,gBAAgB,IAAI,MAAM,GAAG;AAK/B,WAAO,OAAO,KAAK,kDAAkD,MAAM;AAC3E;AAAA,EACF,OAAO;AACL,oBAAgB,IAAI,MAAM;AAAA,EAC5B;AAEA,MAAI,OAAO,SAAS;AAClB,UAAM,QAAQ,IAAI,OAAO,QAAQ,IAAI,CAAC,cAAc,aAAa,QAAQ,WAAW,iBAAiB,KAAK,CAAC,CAAC;AAAA,EAC9G;AAEA,QAAM,EAAC,SAAQ,IAAI;AAEnB,MAAI,OAAO,QAAQ;AACjB,eAAW,CAAC,OAAO,UAAU,KAAK,OAAO,QAAQ,OAAO,MAAM,GAAG;AAC/D,eAAS,OAAO,OAAO,UAAqC;AAAA,IAC9D;AAAA,EACF;AAEA,MAAI,OAAO,QAAQ;AACjB,eAAW,CAAC,OAAO,MAAM,KAAK,OAAO,QAAQ,OAAO,MAAM,GAAG;AAC3D,eAAS,YAAY,OAAO,MAAM;AAAA,IACpC;AAAA,EACF;AAEA,SAAO,OAAO,aAAa;AAAA,IACzB,QAAQ,CAAC,OAAO,eAAe,SAAS,OAAO,OAAO,UAAqC;AAAA,IAC3F;AAAA,IACA;AAAA,EACF,CAAC,KAAK,QAAQ,QAAQ;AAEtB,MAAI,iBAAiB;AACnB,WAAO,gBAAgB;AAAA,EACzB;AACF;",
   "names": []
 }

package/src/index.d.ts

@@ -1,16 +1,22 @@
+export * from './ChangeTrailRefusedError.js';
 export * from './constants.js';
+export * from './EntityUuidInUseError.js';
 export * from './elements/constants.js';
+export type * from './elements/events.js';
+export * from './elements/requestEntAncestor.js';
 export * from './elements/ShaeElement.js';
 export * from './elements/ShaeEntElement.js';
 export * from './elements/ShaePropElement.js';
 export * from './elements/ShaeWorkerElement.js';
 export type * from './types.js';
+export * from './utils/FrameLoop.js';
 export * from './utils/toNamespace.js';
 export * from './view/ComponentContext.js';
-export * from './view/ComponentMemory.js';
+export type * from './view/ComponentMemory.js';
 export type * from './view/IShadowObjectEnvProxy.js';
 export * from './view/LocalShadowObjectEnv.js';
 export * from './view/RemoteWorkerEnv.js';
 export * from './view/ShadowEnv.js';
 export * from './view/ViewComponent.js';
+export * from './WorkerTimeoutError.js';
 //# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,mBAAmB,YAAY,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,mBAAmB,iCAAiC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,mBAAmB,sBAAsB,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,mBAAmB,YAAY,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,mBAAmB,2BAA2B,CAAC;AAC/C,mBAAmB,iCAAiC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}

package/src/index.js

@@ -1,14 +1,18 @@
+export * from "./ChangeTrailRefusedError.js";
 export * from "./constants.js";
+export * from "./EntityUuidInUseError.js";
 export * from "./elements/constants.js";
+export * from "./elements/requestEntAncestor.js";
 export * from "./elements/ShaeElement.js";
 export * from "./elements/ShaeEntElement.js";
 export * from "./elements/ShaePropElement.js";
 export * from "./elements/ShaeWorkerElement.js";
+export * from "./utils/FrameLoop.js";
 export * from "./utils/toNamespace.js";
 export * from "./view/ComponentContext.js";
-export * from "./view/ComponentMemory.js";
 export * from "./view/LocalShadowObjectEnv.js";
 export * from "./view/RemoteWorkerEnv.js";
 export * from "./view/ShadowEnv.js";
 export * from "./view/ViewComponent.js";
+export * from "./WorkerTimeoutError.js";
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.ts"],
-  "sourcesContent": ["export * from './constants.js';\nexport * from './elements/constants.js';\nexport * from './elements/ShaeElement.js';\nexport * from './elements/ShaeEntElement.js';\nexport * from './elements/ShaePropElement.js';\nexport * from './elements/ShaeWorkerElement.js';\nexport type * from './types.js';\nexport * from './utils/toNamespace.js';\nexport * from './view/ComponentContext.js';\nexport * from './view/ComponentMemory.js';\nexport type * from './view/IShadowObjectEnvProxy.js';\nexport * from './view/LocalShadowObjectEnv.js';\nexport * from './view/RemoteWorkerEnv.js';\nexport * from './view/ShadowEnv.js';\nexport * from './view/ViewComponent.js';"],
-  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export * from './ChangeTrailRefusedError.js';\nexport * from './constants.js';\nexport * from './EntityUuidInUseError.js';\nexport * from './elements/constants.js';\nexport type * from './elements/events.js';\nexport * from './elements/requestEntAncestor.js';\nexport * from './elements/ShaeElement.js';\nexport * from './elements/ShaeEntElement.js';\nexport * from './elements/ShaePropElement.js';\nexport * from './elements/ShaeWorkerElement.js';\nexport type * from './types.js';\nexport * from './utils/FrameLoop.js';\nexport * from './utils/toNamespace.js';\nexport * from './view/ComponentContext.js';\nexport type * from './view/ComponentMemory.js';\nexport type * from './view/IShadowObjectEnvProxy.js';\nexport * from './view/LocalShadowObjectEnv.js';\nexport * from './view/RemoteWorkerEnv.js';\nexport * from './view/ShadowEnv.js';\nexport * from './view/ViewComponent.js';\nexport * from './WorkerTimeoutError.js';\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/src/shadow-objects.d.ts

@@ -1,4 +1,6 @@
+export * from './ChangeTrailRefusedError.js';
 export * from './constants.js';
+export * from './EntityUuidInUseError.js';
 export * from './in-the-dark/events.js';
 export * from './in-the-dark/Kernel.js';
 export * from './in-the-dark/Registry.js';

package/src/shadow-objects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shadow-objects.d.ts","sourceRoot":"","sources":["../../src/shadow-objects.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,mBAAmB,YAAY,CAAC"}
+{"version":3,"file":"shadow-objects.d.ts","sourceRoot":"","sources":["../../src/shadow-objects.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,mBAAmB,YAAY,CAAC"}

package/src/shadow-objects.js

@@ -1,4 +1,6 @@
+export * from "./ChangeTrailRefusedError.js";
 export * from "./constants.js";
+export * from "./EntityUuidInUseError.js";
 export * from "./in-the-dark/events.js";
 export * from "./in-the-dark/Kernel.js";
 export * from "./in-the-dark/Registry.js";

package/src/shadow-objects.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/shadow-objects.ts"],
-  "sourcesContent": ["export * from './constants.js';\nexport * from './in-the-dark/events.js';\nexport * from './in-the-dark/Kernel.js';\nexport * from './in-the-dark/Registry.js';\nexport * from './in-the-dark/ShadowObject.js';\nexport type * from './types.js';"],
-  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export * from './ChangeTrailRefusedError.js';\nexport * from './constants.js';\nexport * from './EntityUuidInUseError.js';\nexport * from './in-the-dark/events.js';\nexport * from './in-the-dark/Kernel.js';\nexport * from './in-the-dark/Registry.js';\nexport * from './in-the-dark/ShadowObject.js';\nexport type * from './types.js';\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/src/shadow-objects.worker.js

@@ -1,5 +1,4 @@
 import { WorkerRuntime } from "./worker/WorkerRuntime.js";
-console.debug("@spearwolf/shadow-objects/WorkerRuntime: hello!");
 const shadowRuntime = new WorkerRuntime();
 shadowRuntime.start();
 //# sourceMappingURL=shadow-objects.worker.js.map

package/src/shadow-objects.worker.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/shadow-objects.worker.js"],
-  "sourcesContent": ["import {WorkerRuntime} from './worker/WorkerRuntime.js';\n\nconsole.debug('@spearwolf/shadow-objects/WorkerRuntime: hello!');\n\nconst shadowRuntime = new WorkerRuntime();\nshadowRuntime.start();"],
-  "mappings": "AAAA,SAAQ,qBAAoB;AAE5B,QAAQ,MAAM,iDAAiD;AAE/D,MAAM,gBAAgB,IAAI,cAAc;AACxC,cAAc,MAAM;",
+  "sourcesContent": ["import {WorkerRuntime} from './worker/WorkerRuntime.js';\n\nconst shadowRuntime = new WorkerRuntime();\nshadowRuntime.start();\n"],
+  "mappings": "AAAA,SAAQ,qBAAoB;AAE5B,MAAM,gBAAgB,IAAI,cAAc;AACxC,cAAc,MAAM;",
   "names": []
 }

package/src/shae-ent.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/shae-ent.ts"],
-  "sourcesContent": ["import {SHAE_ENT} from './elements/constants.js';\nimport {ShaeEntElement} from './elements/ShaeEntElement.js';\n\ncustomElements.define(SHAE_ENT, ShaeEntElement);"],
+  "sourcesContent": ["import {SHAE_ENT} from './elements/constants.js';\nimport {ShaeEntElement} from './elements/ShaeEntElement.js';\n\ncustomElements.define(SHAE_ENT, ShaeEntElement);\n"],
   "mappings": "AAAA,SAAQ,gBAAe;AACvB,SAAQ,sBAAqB;AAE7B,eAAe,OAAO,UAAU,cAAc;",
   "names": []
 }

package/src/shae-prop.js

@@ -1,4 +1,4 @@
-import { SHAE_ENT, SHAE_PROP } from "./elements/constants.js";
+import { SHAE_PROP } from "./elements/constants.js";
 import { ShaePropElement } from "./elements/ShaePropElement.js";
-customElements.whenDefined(SHAE_ENT).then(() => customElements.define(SHAE_PROP, ShaePropElement));
+customElements.define(SHAE_PROP, ShaePropElement);
 //# sourceMappingURL=shae-prop.js.map

package/src/shae-prop.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/shae-prop.ts"],
-  "sourcesContent": ["import {SHAE_ENT, SHAE_PROP} from './elements/constants.js';\nimport {ShaePropElement} from './elements/ShaePropElement.js';\n\ncustomElements.whenDefined(SHAE_ENT).then(() => customElements.define(SHAE_PROP, ShaePropElement));"],
-  "mappings": "AAAA,SAAQ,UAAU,iBAAgB;AAClC,SAAQ,uBAAsB;AAE9B,eAAe,YAAY,QAAQ,EAAE,KAAK,MAAM,eAAe,OAAO,WAAW,eAAe,CAAC;",
+  "sourcesContent": ["import {SHAE_PROP} from './elements/constants.js';\nimport {ShaePropElement} from './elements/ShaePropElement.js';\n\ncustomElements.define(SHAE_PROP, ShaePropElement);\n"],
+  "mappings": "AAAA,SAAQ,iBAAgB;AACxB,SAAQ,uBAAsB;AAE9B,eAAe,OAAO,WAAW,eAAe;",
   "names": []
 }

package/src/shae-worker.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/shae-worker.ts"],
-  "sourcesContent": ["import {SHAE_WORKER} from './elements/constants.js';\nimport {ShaeWorkerElement} from './elements/ShaeWorkerElement.js';\n\ncustomElements.define(SHAE_WORKER, ShaeWorkerElement);"],
+  "sourcesContent": ["import {SHAE_WORKER} from './elements/constants.js';\nimport {ShaeWorkerElement} from './elements/ShaeWorkerElement.js';\n\ncustomElements.define(SHAE_WORKER, ShaeWorkerElement);\n"],
   "mappings": "AAAA,SAAQ,mBAAkB;AAC1B,SAAQ,yBAAwB;AAEhC,eAAe,OAAO,aAAa,iBAAiB;",
   "names": []
 }

package/src/types.d.ts

@@ -14,7 +14,18 @@ export interface IComponentEvent {
     type: string;
     data: unknown;
 }
-export type ComponentPropertiesType = [string, unknown][];
+/**
+ * A list of property entries in a Change Trail. An entry carries a key together with its
+ * value; an entry that names only the key counts as set, without carrying a value — the
+ * Entity behind it reads the property as `undefined`.
+ *
+ * The one-element form is written by `ViewComponent.setPropertyWithoutValue()`, which goes through
+ * `ComponentContext` into the bookkeeping of `ComponentChanges`; `setProperty(name, undefined)`
+ * stands beside it and is a removal. It also arrives from outside, in a Change Trail a caller
+ * assembles itself — `Kernel.createEntity()` and `Kernel.changeProperties()` are the two entrances
+ * that read it.
+ */
+export type ComponentPropertiesType = ([string] | [string, unknown])[];
 export interface ICreateEntitiesChange extends IComponentChange {
     type: ComponentChangeType.CreateEntities;
     token: string;
@@ -56,14 +67,28 @@ export interface ImportedModuleEvent {
     type: typeof ImportedModule;
     url?: string;
     error?: string;
+    /**
+     * The name the error called itself in the worker. Structured cloning does not carry an
+     * error class, so this and `error` are what the view side rebuilds one from. Absent means
+     * the sender named no class, and the view reads it as `Error`.
+     */
+    errorName?: string;
 }
 export interface AppliedChangeTrailEvent {
     type: typeof AppliedChangeTrail;
     serial?: number;
     error?: string;
+    /** The name the error called itself in the worker; see {@link ImportedModuleEvent.errorName}. */
+    errorName?: string;
+    /**
+     * How many entries of the change trail the Kernel applied before it stopped. Stands only
+     * next to an `error`, and only where the Kernel itself could say so; an absent field means
+     * nothing is known about how far the trail got.
+     */
+    appliedCount?: number;
 }
 export type EntityApi = Readonly<Pick<Entity, 'uuid' | 'order' | 'hasParent' | 'propKeys' | 'propEntries' | 'kernel'> & {
-    parent?: EntityApi;
+    parent?: EntityApi | undefined;
     children: readonly EntityApi[];
     traverse(callback: (entity: EntityApi) => unknown): void;
 }>;
@@ -89,7 +114,7 @@ export interface ShadowObjectCreationAPI {
     };
     createResource<T = unknown>(factory: () => T | undefined, cleanup?: (resource: NonNullable<T>) => unknown): Signal<Maybe<T>>;
     createEffect: typeof createEffect;
-    createSignal<T = unknown>(...args: Parameters<typeof createSignal<T>>): ReturnType<typeof createSignal<T>>;
+    createSignal: typeof createSignal;
     createMemo<T = unknown>(...args: Parameters<typeof createMemo<T>>): SignalReader<T>;
     on(...args: SubscribeArgs): ReturnType<typeof on>;
     on(...args: [object, ...SubscribeArgs]): ReturnType<typeof on>;
@@ -99,6 +124,10 @@ export interface ShadowObjectCreationAPI {
     /**
      * Emit an event on the *entity* associated with this shadow object.
      *
+     * A listener that throws ends the delivery where it stands and the error reaches this call. That
+     * is deliberate, and it is the one dispatch in the library that works this way: the listeners
+     * belong to whoever emits here, so a failure is its own bug and belongs where it happened.
+     *
      * @param eventNames - The name(s) of the event(s) to emit.
      * @param eventArgs - Arguments to pass to the event listeners.
      */
@@ -114,11 +143,13 @@ export interface ShadowObjectCreationAPI {
     onDestroy(callback: () => any): void;
 }
 export interface ShadowObjectConstructor {
-    new (params: ShadowObjectCreationAPI): {};
+    new (params: ShadowObjectCreationAPI): object;
+    /** The name the Kernel reports a Shadow Object built from this constructor under; without it, the constructor's `name`. */
     displayName?: string;
 }
 export interface ShadowObjectConstructorFunc {
     (params: ShadowObjectCreationAPI): object | undefined | void;
+    /** The name the Kernel reports a Shadow Object built from this constructor under; without it, the constructor's `name`. */
     displayName?: string;
 }
 export type ShadowObjectType = EventizedObject;

package/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/src/utils/ConsoleLogger.d.ts

@@ -1,19 +1,53 @@
 export declare const CONSOLE_LOGGER = "ConsoleLogger";
 export declare const CONSOLE_LOGGER_STORAGE = "ConsoleLoggerStorage";
+declare const ConsoleLogger$: unique symbol;
+export interface ConsoleLoggerConfig {
+    [ConsoleLogger$]?: boolean;
+    enable: boolean;
+    debug: boolean;
+    info: boolean;
+    warn: boolean;
+    'styles.debug': string;
+    'styles.info': string;
+    'styles.warn': string;
+    'styles.error': string;
+    [key: string]: string | boolean | undefined;
+}
+export interface ConsoleLoggerControl {
+    [ConsoleLogger$]?: boolean;
+    enable: boolean;
+    debug: boolean;
+    info: boolean;
+    warn: boolean;
+}
+/**
+ * The key a config value is stored under. Prefixed with {@link CONSOLE_LOGGER} when it goes
+ * into a real Storage, where it shares the namespace with everything else on this origin.
+ */
+export declare const consoleLoggerConfigKey: (key: string | string[]) => string;
+/**
+ * Reads a raw config value through whatever storage the capability probe accepted, or from the
+ * fallback object store when none did. The way to reach the config from outside this module:
+ * `globalThis.localStorage` may be missing, inert or hostile, and asking it directly throws.
+ */
+export declare const loadConsoleLoggerConfig: (key: string | string[], defaultValue: string) => string;
+/**
+ * Installs a config object as the fallback store, bypassing the storage probe. `WorkerRuntime`
+ * calls this with the config a `RemoteWorkerEnv` forwards from the main thread, where there is no
+ * `localStorage` to probe in the first place.
+ *
+ * Once a logger exists in such a thread, `ConsoleLogger.sharedConfig` *is* that store, and the
+ * values are written into it rather than a fresh object taking its place in the slot: the shared
+ * switches reach every logger of the thread, the ones already built included. One flag stays
+ * behind -- a logger reads its own `<namespace>.enable` key when it is built, and a config that
+ * arrives afterwards no longer moves it.
+ */
+export declare function setConsoleLoggerStorage(config: ConsoleLoggerConfig): void;
 export declare class ConsoleLogger {
     #private;
     namespace?: string;
     enable: boolean;
-    static sharedConfig: {
-        enable: boolean;
-        debug: boolean;
-        info: boolean;
-        warn: boolean;
-        'styles.debug': string;
-        'styles.info': string;
-        'styles.warn': string;
-        'styles.error': string;
-    };
+    static sharedConfig: ConsoleLoggerConfig;
     static get isEnabled(): boolean;
     static get isDebug(): boolean;
     static sharedStyles: {
@@ -33,4 +67,5 @@ export declare class ConsoleLogger {
     warn(...args: any[]): void;
     error(...args: any[]): void;
 }
+export {};
 //# sourceMappingURL=ConsoleLogger.d.ts.map