@spearwolf/shadow-objects 0.34.0 → 0.35.0

package/src/testing/types.d.ts

@@ -0,0 +1,119 @@
+import type { Entity } from '../in-the-dark/Entity.js';
+import type { Kernel } from '../in-the-dark/Kernel.js';
+import type { Registry } from '../in-the-dark/Registry.js';
+import type { ShadowObjectConstructor, ShadowObjectConstructorFunc, ShadowObjectDescription, ShadowObjectsModule, ShadowObjectType } from '../types.js';
+/** Either shape a Shadow Object can be defined in. */
+export type AnyShadowObjectConstructor = ShadowObjectConstructor | ShadowObjectConstructorFunc;
+/**
+ * The instance a constructor produces. A function constructor that returns nothing yields
+ * `object`, which is honest: there is an eventized instance, and it carries nothing a test can name.
+ */
+export type ShadowObjectInstance<C> = C extends new (...args: any[]) => infer R ? R : C extends (...args: any[]) => infer R ? R extends object ? R : object : object;
+/** One report the Kernel made through its logger while a test kernel was recording. */
+export interface KernelErrorRecord {
+    level: 'error' | 'warn';
+    /** The arguments as they were logged. `runGuarded()` puts its message first and the error last. */
+    args: readonly unknown[];
+    /** The last argument, where that argument is an `Error`. */
+    error?: Error;
+}
+/** One message an Entity sent towards the View. */
+export interface ViewMessageRecord {
+    type: string;
+    data: unknown;
+    traverseChildren?: boolean;
+}
+export interface CreateEntityOptions {
+    uuid?: string;
+    order?: number;
+    parent?: TestEntity;
+    autoDestructionOnParentRemoval?: boolean;
+}
+/** One handle per Entity. The same uuid always answers with the same handle. */
+export interface TestEntity {
+    readonly uuid: string;
+    /** The token the Kernel currently holds for this Entity. */
+    readonly token: string;
+    /** The Entity itself -- the way out for everything this handle does not cover. */
+    readonly entity: Entity;
+    /**
+     * What this Entity sent towards the View since the last `clearViewMessages()`.
+     *
+     * The list belongs to the test kernel and this is a view onto it, so it holds every message that
+     * was dispatched for this uuid -- the ones from before anything asked for a handle included.
+     *
+     * A message is recorded one settle after it was dispatched, so a test settles before it reads.
+     * One message never arrives, and it is the end of the road anyway: `TestKernel.dispose()`
+     * unsubscribes and releases the log in the same synchronous call, while a message its teardown
+     * dispatched is still queued. A test that wants a Shadow Object's farewell message destroys the
+     * Entity and settles first.
+     */
+    readonly viewMessages: readonly ViewMessageRecord[];
+    createChild(token: string, props?: Record<string, unknown>, options?: Omit<CreateEntityOptions, 'parent'>): TestEntity;
+    setProps(props: Record<string, unknown>): void;
+    removeProps(...names: string[]): void;
+    readProp<T = unknown>(name: string): T | undefined;
+    readContext<T = unknown>(name: string | symbol): T | undefined;
+    setToken(token: string): void;
+    setParent(parent: TestEntity | undefined, order?: number): void;
+    /** Deliver a View event. Synchronous, as the Kernel's own delivery is. */
+    sendViewEvent(type: string, data?: unknown): void;
+    /** Emit on the Entity's event bus -- the channel Shadow Objects on one Entity talk to each other on. */
+    emit(eventName: string | symbol, ...args: unknown[]): void;
+    shadowObjects(): ShadowObjectType[];
+    /** The one Shadow Object on this Entity built from `constructa`. Throws for none and for more than one. */
+    shadowObjectOf<C extends AnyShadowObjectConstructor>(constructa: C): ShadowObjectInstance<C>;
+    describe(): ShadowObjectDescription[];
+    clearViewMessages(): void;
+    destroy(): void;
+}
+export interface TestKernelOptions {
+    /**
+     * The Registry to build on. Default: a fresh `new Registry()`, isolated from the default Registry
+     * and from every other test kernel. Pass `Registry.get()` for Shadow Objects that registered
+     * themselves through `@ShadowObject` without a registry of their own.
+     */
+    registry?: Registry;
+    /** Fail `dispose()` when unacknowledged reports of level `error` were recorded. Default: `true`. */
+    failOnKernelErrors?: boolean;
+    /** Keep the Kernel's logger output on the console as well as recording it. Default: `false`. */
+    echoKernelErrors?: boolean;
+}
+export interface TestKernel {
+    /** The Kernel itself -- the way out for everything this facade does not cover. */
+    readonly kernel: Kernel;
+    readonly registry: Registry;
+    /** What the Kernel reported through its logger since the last `clearErrors()`. */
+    readonly errors: readonly KernelErrorRecord[];
+    define(token: string, constructa: AnyShadowObjectConstructor): void;
+    route(token: string, targets: string[]): void;
+    importModule(module: ShadowObjectsModule): Promise<void>;
+    createEntity(token: string, props?: Record<string, unknown>, options?: CreateEntityOptions): TestEntity;
+    /**
+     * The handle for a uuid. `undefined` for a uuid this test kernel has never handed out a handle
+     * for and the Kernel does not hold; a handle it has already handed out keeps answering after its
+     * Entity is destroyed. A uuid a Shadow Object created through `testKernel.kernel.createEntity()`
+     * gets a handle here on first ask, and the same uuid always answers with the same handle.
+     */
+    entity(uuid: string): TestEntity | undefined;
+    settle(): Promise<void>;
+    clearErrors(): void;
+    dispose(): void;
+}
+export interface MountOptions {
+    props?: Record<string, unknown>;
+    /** Entity Contexts a synthetic parent Entity provides to the object under test. */
+    contexts?: Record<string | symbol, unknown>;
+    /** The token to register the constructor under. Default: a generated one. */
+    token?: string;
+    registry?: Registry;
+    failOnKernelErrors?: boolean;
+    echoKernelErrors?: boolean;
+}
+export interface MountedShadowObject<C> extends Omit<TestEntity, 'createChild' | 'destroy'> {
+    readonly instance: ShadowObjectInstance<C>;
+    readonly testKernel: TestKernel;
+    settle(): Promise<void>;
+    dispose(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/src/testing/types.d.ts.map

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

package/src/testing/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/src/testing/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/src/testing.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The testing utility: a real Kernel for a unit test, with the ceremony taken off.
+ *
+ * A subpath rather than an `index.ts` export, for the same reason `model-context.js` is one -- it
+ * has no place in an application bundle, and none at all in the worker bundle. Nothing here imports
+ * a test runner: what a test asserts on are plain arrays, so vitest, jest, `node:test` and the
+ * browser mode are served alike. Importing this module registers nothing and touches no global.
+ */
+export { createTestKernel } from './testing/createTestKernel.js';
+export { mountShadowObject } from './testing/mountShadowObject.js';
+export { type KernelErrorRecorder, recordKernelErrors } from './testing/recordKernelErrors.js';
+export { settle } from './testing/settle.js';
+export type { AnyShadowObjectConstructor, CreateEntityOptions, KernelErrorRecord, MountedShadowObject, MountOptions, ShadowObjectInstance, TestEntity, TestKernel, TestKernelOptions, ViewMessageRecord, } from './testing/types.js';
+//# sourceMappingURL=testing.d.ts.map

package/src/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAC,gBAAgB,EAAC,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAC,iBAAiB,EAAC,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAC,KAAK,mBAAmB,EAAE,kBAAkB,EAAC,MAAM,iCAAiC,CAAC;AAC7F,OAAO,EAAC,MAAM,EAAC,MAAM,qBAAqB,CAAC;AAC3C,YAAY,EACV,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/src/testing.js

@@ -0,0 +1,11 @@
+import { createTestKernel } from "./testing/createTestKernel.js";
+import { mountShadowObject } from "./testing/mountShadowObject.js";
+import { recordKernelErrors } from "./testing/recordKernelErrors.js";
+import { settle } from "./testing/settle.js";
+export {
+  createTestKernel,
+  mountShadowObject,
+  recordKernelErrors,
+  settle
+};
+//# sourceMappingURL=testing.js.map

package/src/testing.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/testing.ts"],
+  "sourcesContent": ["/**\n * The testing utility: a real Kernel for a unit test, with the ceremony taken off.\n *\n * A subpath rather than an `index.ts` export, for the same reason `model-context.js` is one -- it\n * has no place in an application bundle, and none at all in the worker bundle. Nothing here imports\n * a test runner: what a test asserts on are plain arrays, so vitest, jest, `node:test` and the\n * browser mode are served alike. Importing this module registers nothing and touches no global.\n */\nexport {createTestKernel} from './testing/createTestKernel.js';\nexport {mountShadowObject} from './testing/mountShadowObject.js';\nexport {type KernelErrorRecorder, recordKernelErrors} from './testing/recordKernelErrors.js';\nexport {settle} from './testing/settle.js';\nexport type {\n  AnyShadowObjectConstructor,\n  CreateEntityOptions,\n  KernelErrorRecord,\n  MountedShadowObject,\n  MountOptions,\n  ShadowObjectInstance,\n  TestEntity,\n  TestKernel,\n  TestKernelOptions,\n  ViewMessageRecord,\n} from './testing/types.js';\n"],
+  "mappings": "AAQA,SAAQ,wBAAuB;AAC/B,SAAQ,yBAAwB;AAChC,SAAkC,0BAAyB;AAC3D,SAAQ,cAAa;",
+  "names": []
+}

package/src/types.d.ts

@@ -1,7 +1,8 @@
-import type { AnyEventNames, EventArgs, EventizedObject, on, once, SubscribeArgs } from '@spearwolf/eventize';
+import type { AnyEventNames, ArgsFor, DefaultEventMap, EventArgs, EventizedObject, EventKeysOf, EventListenerMethods, EventMap, EventName, ListenerFor, ListenerFuncType, MultiArgsFor, NonTypedEmitter, SubscribeArgs, UnsubscribeFunc } from '@spearwolf/eventize';
 import type { CompareFunc, createEffect, createMemo, createSignal, Signal, SignalReader } from '@spearwolf/signalize';
-import type { AppliedChangeTrail, ComponentChangeType, ImportedModule } from './constants.js';
+import type { AppliedChangeTrail, ComponentChangeType, ImportedModule, Inspect, Inspected } from './constants.js';
 import type { Entity } from './in-the-dark/Entity.js';
+import type { InspectRequest, KernelSnapshot } from './inspect/types.js';
 import type { Kernel, Registry } from './shadow-objects.js';
 export type ChangeTrailType = IComponentChangeType[];
 export type TransferablesType = Transferable[];
@@ -87,6 +88,29 @@ export interface AppliedChangeTrailEvent {
      */
     appliedCount?: number;
 }
+/**
+ * What goes on the wire for an `inspect()` over a worker: the request as the caller gave it, and
+ * the serial the answer is matched by. The request is plain data and survives structured cloning.
+ */
+export interface InspectEvent {
+    type: typeof Inspect;
+    serial: number;
+    request: InspectRequest;
+}
+/**
+ * The worker's answer to an {@link InspectEvent}: the snapshot, or the two fields of a throw that
+ * survive structured cloning -- see {@link ImportedModuleEvent.errorName}. Exactly one of
+ * `snapshot` and `error` is set by the router; a reply carrying neither is rejected by the view
+ * side rather than read through. `serial` is what the request carried; `RemoteWorkerEnv` always
+ * sends one, and matches the answer by it.
+ */
+export interface InspectedEvent {
+    type: typeof Inspected;
+    serial: number;
+    snapshot?: KernelSnapshot;
+    error?: string;
+    errorName?: string;
+}
 export type EntityApi = Readonly<Pick<Entity, 'uuid' | 'order' | 'hasParent' | 'propKeys' | 'propEntries' | 'kernel'> & {
     parent?: EntityApi | undefined;
     children: readonly EntityApi[];
@@ -99,7 +123,41 @@ export interface ProvideContextOptions<T> extends SignalValueOptions<T> {
     clearOnDestroy?: boolean;
 }
 export type Maybe<T = unknown> = NonNullable<T> | undefined;
-export interface ShadowObjectCreationAPI {
+/**
+ * The event map of a Shadow Object read off its own shape: every method is an event of that name,
+ * carrying the method's parameters as its argument tuple. The map an `emit()` on the entity is
+ * checked against when it names a Shadow Object that listens there -- see `ShadowObjectCreationAPI`.
+ *
+ * It is the runtime read back into a type. The Kernel attaches every Shadow Object to its Entity as
+ * an eventize listener object, so an `emit('onPowerUp', 100)` on the entity calls `onPowerUp(100)`
+ * on each Shadow Object that has such a method. Every method takes part, the ones nobody meant as
+ * an event included -- and that is what the dispatch does, too. A `symbol`-keyed method, the
+ * lifecycle hooks among them, stays out: the eventize maps treat a symbol as the escape hatch. Two
+ * Shadow Objects on one entity make `EventsOf<A> & EventsOf<B>`.
+ */
+export type EventsOf<L> = {
+    [K in keyof L as L[K] extends (...args: any[]) => any ? (K extends EventName ? K : never) : never]: L[K] extends (...args: infer A) => any ? A : never;
+};
+/** `true` for a map that declares dynamic names -- eventize's `DefaultEventMap`, or one with an index signature. */
+type IsLooseMap<T> = string extends EventKeysOf<T> ? true : false;
+/**
+ * Where a subscription on the entity is checked against the map, this closes the loose forms for a
+ * typed map: a rest parameter of `never` is an overload no call matches. The same way eventize closes
+ * its loose overloads for a typed emitter.
+ */
+type LooseSubscribeArgs<TEvents> = IsLooseMap<TEvents> extends true ? SubscribeArgs : never;
+type LooseEmitNames<TEvents> = IsLooseMap<TEvents> extends true ? AnyEventNames : never;
+/**
+ * What a Shadow Object constructor is handed.
+ *
+ * `TEvents` is the event map of the entity bus as this Shadow Object sees it, in the shape eventize
+ * takes -- `{[eventName]: argumentTuple}` -- and it types the entity-implicit forms of `on()`,
+ * `once()` and `emit()`. `EventsOf<OtherShadowObject>` derives it from the Shadow Object that is meant
+ * to receive the event. Without it every form is as loose as eventize's default map, and the target
+ * forms are typed by the target's own map either way. The map is a compile-time contract: nothing
+ * at runtime holds two Shadow Objects on one entity to the same one.
+ */
+export interface ShadowObjectCreationAPI<TEvents extends EventMap = DefaultEventMap> {
     entity: EntityApi;
     dispatchMessageToView(type: string, data?: unknown, transferables?: TransferablesType, traverseChildren?: boolean): void;
     provideContext<T = unknown>(name: string | symbol, sourceOrInitialValue?: T | SignalReader<T> | SignalReader<T | undefined>, options?: ProvideContextOptions<T> | CompareFunc<T | undefined>): Signal<Maybe<T>>;
@@ -116,10 +174,54 @@ export interface ShadowObjectCreationAPI {
     createEffect: typeof createEffect;
     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>;
-    once(...args: SubscribeArgs): ReturnType<typeof once>;
-    once(...args: [object, ...SubscribeArgs]): ReturnType<typeof once>;
+    /**
+     * Subscribe on the *entity* of this shadow object, or on a *target* given in front. Every form
+     * eventize's standalone `on()` takes; the subscription ends with the shadow object, or earlier
+     * through the handle. On the entity the event names and the listener are checked against `TEvents`;
+     * on a target, against the target's own map. An object followed by anything is the target, an
+     * object standing alone is a listener object on the entity.
+     */
+    on<K extends EventKeysOf<TEvents> | symbol>(eventName: K, listener: ListenerFor<TEvents, K>): UnsubscribeFunc;
+    on<K extends EventKeysOf<TEvents> | symbol>(eventName: K, priority: number, listener: ListenerFor<TEvents, K>): UnsubscribeFunc;
+    on<K extends EventKeysOf<TEvents>>(eventNames: Array<K | [K, number]>, listener: (...args: MultiArgsFor<TEvents, K>) => void): UnsubscribeFunc;
+    on<K extends EventKeysOf<TEvents>>(eventNames: Array<K | [K, number]>, priority: number, listener: (...args: MultiArgsFor<TEvents, K>) => void): UnsubscribeFunc;
+    on<K extends EventKeysOf<TEvents>>(eventNames: K | K[], methodName: EventName, listenerObject: object): UnsubscribeFunc;
+    on<K extends EventKeysOf<TEvents>>(eventNames: K | K[], priority: number, methodName: EventName, listenerObject: object): UnsubscribeFunc;
+    on(listenerObject: EventListenerMethods<TEvents>): UnsubscribeFunc;
+    on(priority: number, listenerObject: EventListenerMethods<TEvents>): UnsubscribeFunc;
+    on(listener: ListenerFuncType): UnsubscribeFunc;
+    on(priority: number, listener: ListenerFuncType): UnsubscribeFunc;
+    on(priority: number, methodName: EventName, listenerObject: object): UnsubscribeFunc;
+    on(...args: LooseSubscribeArgs<TEvents>): UnsubscribeFunc;
+    on<M extends EventMap, K extends EventKeysOf<M> | symbol>(target: EventizedObject<M>, eventName: K, listener: ListenerFor<M, K>): UnsubscribeFunc;
+    on<M extends EventMap, K extends EventKeysOf<M> | symbol>(target: EventizedObject<M>, eventName: K, priority: number, listener: ListenerFor<M, K>): UnsubscribeFunc;
+    on<M extends EventMap, K extends EventKeysOf<M>>(target: EventizedObject<M>, eventNames: Array<K | [K, number]>, listener: (...args: MultiArgsFor<M, K>) => void): UnsubscribeFunc;
+    on<M extends EventMap>(target: EventizedObject<M>, listenerObject: EventListenerMethods<M>): UnsubscribeFunc;
+    on<T extends object>(target: NonTypedEmitter<T>, ...args: SubscribeArgs): UnsubscribeFunc;
+    /**
+     * Subscribe on the *entity* of this shadow object, or on a *target* given in front. Every form
+     * eventize's standalone `once()` takes; the subscription ends with the shadow object, or earlier
+     * through the handle. On the entity the event names and the listener are checked against `TEvents`;
+     * on a target, against the target's own map. An object followed by anything is the target, an
+     * object standing alone is a listener object on the entity.
+     */
+    once<K extends EventKeysOf<TEvents> | symbol>(eventName: K, listener: ListenerFor<TEvents, K>): UnsubscribeFunc;
+    once<K extends EventKeysOf<TEvents> | symbol>(eventName: K, priority: number, listener: ListenerFor<TEvents, K>): UnsubscribeFunc;
+    once<K extends EventKeysOf<TEvents>>(eventNames: Array<K | [K, number]>, listener: (...args: MultiArgsFor<TEvents, K>) => void): UnsubscribeFunc;
+    once<K extends EventKeysOf<TEvents>>(eventNames: Array<K | [K, number]>, priority: number, listener: (...args: MultiArgsFor<TEvents, K>) => void): UnsubscribeFunc;
+    once<K extends EventKeysOf<TEvents>>(eventNames: K | K[], methodName: EventName, listenerObject: object): UnsubscribeFunc;
+    once<K extends EventKeysOf<TEvents>>(eventNames: K | K[], priority: number, methodName: EventName, listenerObject: object): UnsubscribeFunc;
+    once(listenerObject: EventListenerMethods<TEvents>): UnsubscribeFunc;
+    once(priority: number, listenerObject: EventListenerMethods<TEvents>): UnsubscribeFunc;
+    once(listener: ListenerFuncType): UnsubscribeFunc;
+    once(priority: number, listener: ListenerFuncType): UnsubscribeFunc;
+    once(priority: number, methodName: EventName, listenerObject: object): UnsubscribeFunc;
+    once(...args: LooseSubscribeArgs<TEvents>): UnsubscribeFunc;
+    once<M extends EventMap, K extends EventKeysOf<M> | symbol>(target: EventizedObject<M>, eventName: K, listener: ListenerFor<M, K>): UnsubscribeFunc;
+    once<M extends EventMap, K extends EventKeysOf<M> | symbol>(target: EventizedObject<M>, eventName: K, priority: number, listener: ListenerFor<M, K>): UnsubscribeFunc;
+    once<M extends EventMap, K extends EventKeysOf<M>>(target: EventizedObject<M>, eventNames: Array<K | [K, number]>, listener: (...args: MultiArgsFor<M, K>) => void): UnsubscribeFunc;
+    once<M extends EventMap>(target: EventizedObject<M>, listenerObject: EventListenerMethods<M>): UnsubscribeFunc;
+    once<T extends object>(target: NonTypedEmitter<T>, ...args: SubscribeArgs): UnsubscribeFunc;
     onViewEvent(callback: (type: string, data: unknown) => any): void;
     /**
      * Emit an event on the *entity* associated with this shadow object.
@@ -131,15 +233,21 @@ export interface ShadowObjectCreationAPI {
      * @param eventNames - The name(s) of the event(s) to emit.
      * @param eventArgs - Arguments to pass to the event listeners.
      */
-    emit(eventNames: AnyEventNames, ...eventArgs: EventArgs): void;
+    emit<K extends EventKeysOf<TEvents> | symbol>(eventName: K, ...eventArgs: ArgsFor<TEvents, K>): void;
+    emit<K extends EventKeysOf<TEvents> | symbol>(eventNames: K[], ...eventArgs: ArgsFor<TEvents, K>): void;
+    emit(eventNames: LooseEmitNames<TEvents>, ...eventArgs: EventArgs): void;
     /**
-     * Emit an event on a specific *target* object.
+     * Emit an event on a specific *target* object -- another Entity, a Shadow Object, any eventized
+     * object, or a plain one: eventize duck-types a target, so an object without listeners is a no-op.
+     * The event names and arguments are checked against the target's own map where it has one.
      *
      * @param target - The object to emit the event on.
      * @param eventNames - The name(s) of the event(s) to emit.
      * @param eventArgs - Arguments to pass to the event listeners.
      */
-    emit(target: EventizedObject, eventNames: AnyEventNames, ...eventArgs: EventArgs): void;
+    emit<M extends EventMap, K extends EventKeysOf<M> | symbol>(target: EventizedObject<M>, eventName: K, ...eventArgs: ArgsFor<M, K>): void;
+    emit<M extends EventMap, K extends EventKeysOf<M> | symbol>(target: EventizedObject<M>, eventNames: K[], ...eventArgs: ArgsFor<M, K>): void;
+    emit<T extends object>(target: NonTypedEmitter<T>, eventNames: AnyEventNames, ...eventArgs: EventArgs): void;
     onDestroy(callback: () => any): void;
 }
 export interface ShadowObjectConstructor {
@@ -152,6 +260,37 @@ export interface ShadowObjectConstructorFunc {
     /** The name the Kernel reports a Shadow Object built from this constructor under; without it, the constructor's `name`. */
     displayName?: string;
 }
+/** The four lifecycle hooks a Shadow Object can implement, by the name of their symbol. */
+export type LifecycleHookName = 'onCreate' | 'onDestroy' | 'onParentChanged' | 'onViewEvent';
+/**
+ * What a creation scope knows about its Shadow Object: the display name and the five name lists
+ * the creation API filled while the constructor ran. Read-only; a torn-down scope answers empty
+ * lists.
+ */
+export interface ShadowObjectScopeDescription {
+    displayName: string;
+    usesProperties: string[];
+    usesContexts: (string | symbol)[];
+    usesParentContexts: (string | symbol)[];
+    providesContexts: (string | symbol)[];
+    providesGlobalContexts: (string | symbol)[];
+}
+/** {@link ShadowObjectScopeDescription} plus what only the Kernel can add: the tokens and the hooks. */
+export interface ShadowObjectDescription extends ShadowObjectScopeDescription {
+    /** The tokens the constructor is defined under in the Kernel's Registry, in definition order. */
+    definedUnder: string[];
+    /** Which of the four lifecycle hooks the instance implements. */
+    hooks: LifecycleHookName[];
+}
+/** The three maps of a Registry, with constructors reduced to display names. */
+export interface RegistryDescription {
+    /** token -> display names of the constructors defined under it, in definition order. */
+    tokens: Record<string, string[]>;
+    /** token -> tokens it routes to. */
+    routes: Record<string, string[]>;
+    /** `@prop` and `token@prop` keys -> tokens (property routes). */
+    propRoutes: Record<string, string[]>;
+}
 export type ShadowObjectType = EventizedObject;
 export type NamespaceType = string | symbol;
 export type ShadowObjectsModuleInitializer = (shadowObjects: {
@@ -165,4 +304,5 @@ export interface ShadowObjectsModule {
     routes?: Record<string, string[]>;
     initialize?: ShadowObjectsModuleInitializer;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

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/attr-utils.d.ts

@@ -6,4 +6,9 @@ export declare const readBooleanAttribute: (el: HTMLElement, name: string) => bo
  * or blank one reads as `0` — whoever asks decides what either of those means.
  */
 export declare const readNumberAttribute: (el: HTMLElement, name: string) => number | undefined;
+/**
+ * The attribute read as a list of words: split on commas and whitespace, blanks dropped. A
+ * missing attribute is an empty list, and so is an empty or a blank one.
+ */
+export declare const readListAttribute: (el: HTMLElement, name: string) => string[];
 //# sourceMappingURL=attr-utils.d.ts.map

package/src/utils/attr-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attr-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/attr-utils.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,sBAAsB,OAAQ,WAAW,wCAAuD,CAAC;AAE9G,eAAO,MAAM,oBAAoB,OAAQ,WAAW,QAAQ,MAAM,YAMjE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,OAAQ,WAAW,QAAQ,MAAM,KAAG,MAAM,GAAG,SACV,CAAC"}
+{"version":3,"file":"attr-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/attr-utils.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,sBAAsB,OAAQ,WAAW,wCAAuD,CAAC;AAE9G,eAAO,MAAM,oBAAoB,OAAQ,WAAW,QAAQ,MAAM,YAMjE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,OAAQ,WAAW,QAAQ,MAAM,KAAG,MAAM,GAAG,SACV,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,OAAQ,WAAW,QAAQ,MAAM,KAAG,MAAM,EACW,CAAC"}

package/src/utils/attr-utils.js

@@ -10,8 +10,10 @@ const readBooleanAttribute = (el, name) => {
   return false;
 };
 const readNumberAttribute = (el, name) => el.hasAttribute(name) ? Number(el.getAttribute(name)) : void 0;
+const readListAttribute = (el, name) => (el.getAttribute(name) ?? "").split(/[\s,]+/).filter((entry) => entry.length > 0);
 export {
   readBooleanAttribute,
+  readListAttribute,
   readNamespaceAttribute,
   readNumberAttribute
 };

package/src/utils/attr-utils.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/utils/attr-utils.ts"],
-  "sourcesContent": ["import {ATTR_NS} from '../elements/constants.js';\nimport {TRUTHY_VALUES} from './constants.js';\nimport {toNamespace} from './toNamespace.js';\n\nexport const readNamespaceAttribute = (el: HTMLElement) => toNamespace(el.getAttribute(ATTR_NS) ?? undefined);\n\nexport const readBooleanAttribute = (el: HTMLElement, name: string) => {\n  if (el.hasAttribute(name)) {\n    const val = el.getAttribute(name)?.trim()?.toLowerCase() || '1';\n    return TRUTHY_VALUES.has(val);\n  }\n  return false;\n};\n\n/**\n * The attribute read as a number, or `undefined` where the element does not carry it.\n * `Number()` does the reading, so a value that is not a number reads as `NaN` while an empty\n * or blank one reads as `0` \u2014 whoever asks decides what either of those means.\n */\nexport const readNumberAttribute = (el: HTMLElement, name: string): number | undefined =>\n  el.hasAttribute(name) ? Number(el.getAttribute(name)) : undefined;\n"],
-  "mappings": "AAAA,SAAQ,eAAc;AACtB,SAAQ,qBAAoB;AAC5B,SAAQ,mBAAkB;AAEnB,MAAM,yBAAyB,CAAC,OAAoB,YAAY,GAAG,aAAa,OAAO,KAAK,MAAS;AAErG,MAAM,uBAAuB,CAAC,IAAiB,SAAiB;AACrE,MAAI,GAAG,aAAa,IAAI,GAAG;AACzB,UAAM,MAAM,GAAG,aAAa,IAAI,GAAG,KAAK,GAAG,YAAY,KAAK;AAC5D,WAAO,cAAc,IAAI,GAAG;AAAA,EAC9B;AACA,SAAO;AACT;AAOO,MAAM,sBAAsB,CAAC,IAAiB,SACnD,GAAG,aAAa,IAAI,IAAI,OAAO,GAAG,aAAa,IAAI,CAAC,IAAI;",
+  "sourcesContent": ["import {ATTR_NS} from '../elements/constants.js';\nimport {TRUTHY_VALUES} from './constants.js';\nimport {toNamespace} from './toNamespace.js';\n\nexport const readNamespaceAttribute = (el: HTMLElement) => toNamespace(el.getAttribute(ATTR_NS) ?? undefined);\n\nexport const readBooleanAttribute = (el: HTMLElement, name: string) => {\n  if (el.hasAttribute(name)) {\n    const val = el.getAttribute(name)?.trim()?.toLowerCase() || '1';\n    return TRUTHY_VALUES.has(val);\n  }\n  return false;\n};\n\n/**\n * The attribute read as a number, or `undefined` where the element does not carry it.\n * `Number()` does the reading, so a value that is not a number reads as `NaN` while an empty\n * or blank one reads as `0` \u2014 whoever asks decides what either of those means.\n */\nexport const readNumberAttribute = (el: HTMLElement, name: string): number | undefined =>\n  el.hasAttribute(name) ? Number(el.getAttribute(name)) : undefined;\n\n/**\n * The attribute read as a list of words: split on commas and whitespace, blanks dropped. A\n * missing attribute is an empty list, and so is an empty or a blank one.\n */\nexport const readListAttribute = (el: HTMLElement, name: string): string[] =>\n  (el.getAttribute(name) ?? '').split(/[\\s,]+/).filter((entry) => entry.length > 0);\n"],
+  "mappings": "AAAA,SAAQ,eAAc;AACtB,SAAQ,qBAAoB;AAC5B,SAAQ,mBAAkB;AAEnB,MAAM,yBAAyB,CAAC,OAAoB,YAAY,GAAG,aAAa,OAAO,KAAK,MAAS;AAErG,MAAM,uBAAuB,CAAC,IAAiB,SAAiB;AACrE,MAAI,GAAG,aAAa,IAAI,GAAG;AACzB,UAAM,MAAM,GAAG,aAAa,IAAI,GAAG,KAAK,GAAG,YAAY,KAAK;AAC5D,WAAO,cAAc,IAAI,GAAG;AAAA,EAC9B;AACA,SAAO;AACT;AAOO,MAAM,sBAAsB,CAAC,IAAiB,SACnD,GAAG,aAAa,IAAI,IAAI,OAAO,GAAG,aAAa,IAAI,CAAC,IAAI;AAMnD,MAAM,oBAAoB,CAAC,IAAiB,UAChD,GAAG,aAAa,IAAI,KAAK,IAAI,MAAM,QAAQ,EAAE,OAAO,CAAC,UAAU,MAAM,SAAS,CAAC;",
   "names": []
 }

package/src/view/IShadowObjectEnvProxy.d.ts

@@ -1,3 +1,4 @@
+import type { InspectRequest, KernelSnapshot } from '../inspect/types.js';
 import type { MessageToViewEvent } from '../shadow-objects.js';
 import type { ChangeTrailType } from '../types.js';
 export interface IShadowObjectEnvProxy {
@@ -23,6 +24,14 @@ export interface IShadowObjectEnvProxy {
      *   sent without it -- `RemoteWorkerEnv` is one of those.
      */
     applyChangeTrail(data: ChangeTrailType, waitForConfirmation: boolean): Promise<void>;
+    /**
+     * Describe the Kernel behind this proxy: a plain-data snapshot of its Entity Tree, cut by the
+     * limits of the request. Optional: a proxy that does not implement it makes `ShadowEnv.inspect()`
+     * report `kernel` as absent with an error naming the proxy as not inspectable, and everything
+     * else keeps working. Reject with the signal's reason when `signal` is aborted before or while
+     * the snapshot is built.
+     */
+    inspect?(request: InspectRequest, signal?: AbortSignal): Promise<KernelSnapshot>;
     destroy(): void;
     /**
      * Called with a message on its way out of the Shadow Environment.

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

@@ -1 +1 @@
-{"version":3,"file":"IShadowObjectEnvProxy.d.ts","sourceRoot":"","sources":["../../../src/view/IShadowObjectEnvProxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CAAC,IAAI,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErF,OAAO,IAAI,IAAI,CAAC;IAEhB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,eAAe,CAAC,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC;IAE1F;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC;CACxD"}
+{"version":3,"file":"IShadowObjectEnvProxy.d.ts","sourceRoot":"","sources":["../../../src/view/IShadowObjectEnvProxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAE,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;;;;;;;;;;;;;;;;OAkBG;IACH,gBAAgB,CAAC,IAAI,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErF;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEjF,OAAO,IAAI,IAAI,CAAC;IAEhB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,eAAe,CAAC,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC;IAE1F;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC;CACxD"}

package/src/view/LocalShadowObjectEnv.d.ts

@@ -1,5 +1,6 @@
 import { Kernel } from '../in-the-dark/Kernel.js';
 import { Registry } from '../in-the-dark/Registry.js';
+import type { InspectRequest, KernelSnapshot } from '../inspect/types.js';
 import type { ChangeTrailType, ShadowObjectsModule } from '../types.js';
 import type { IShadowObjectEnvProxy } from './IShadowObjectEnvProxy.js';
 export declare class LocalShadowObjectEnv implements IShadowObjectEnvProxy {
@@ -11,6 +12,12 @@ export declare class LocalShadowObjectEnv implements IShadowObjectEnvProxy {
     constructor(registry?: Registry);
     start(): Promise<void>;
     applyChangeTrail(data: ChangeTrailType, waitForConfirmation: boolean): Promise<void>;
+    /**
+     * The snapshot of this environment's Kernel, built synchronously inside the call. Nothing is
+     * cloned: the builder emits plain data and the caller owns it. A signal that is already aborted
+     * rejects before anything is built; there is no later point to abort at.
+     */
+    inspect(request?: InspectRequest, signal?: AbortSignal): Promise<KernelSnapshot>;
     importScript(url: URL | string): Promise<void>;
     importModule(module: ShadowObjectsModule): Promise<void>;
     destroy(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"LocalShadowObjectEnv.d.ts","sourceRoot":"","sources":["../../../src/view/LocalShadowObjectEnv.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,MAAM,EAA0B,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAC,QAAQ,EAAC,MAAM,4BAA4B,CAAC;AACpD,OAAO,KAAK,EAAC,eAAe,EAAE,mBAAmB,EAAY,MAAM,aAAa,CAAC;AAGjF,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,4BAA4B,CAAC;AAEtE,qBAAa,oBAAqB,YAAW,qBAAqB;;IAIhE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,QAAQ,CAAC,UAAU,QAAQ;IAE3B,sBAAsB,UAAS;IAE/B,YAAY,QAAQ,CAAC,EAAE,QAAQ,EAqB9B;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAErB;IAED,gBAAgB,CAAC,IAAI,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBnF;IAEK,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQnD;IAEK,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D;IAED,OAAO,IAAI,IAAI,CAMd;CACF"}
+{"version":3,"file":"LocalShadowObjectEnv.d.ts","sourceRoot":"","sources":["../../../src/view/LocalShadowObjectEnv.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,MAAM,EAA0B,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAC,QAAQ,EAAC,MAAM,4BAA4B,CAAC;AAEpD,OAAO,KAAK,EAAC,cAAc,EAAE,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAC,eAAe,EAAE,mBAAmB,EAAY,MAAM,aAAa,CAAC;AAGjF,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,4BAA4B,CAAC;AAEtE,qBAAa,oBAAqB,YAAW,qBAAqB;;IAIhE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,QAAQ,CAAC,UAAU,QAAQ;IAE3B,sBAAsB,UAAS;IAE/B,YAAY,QAAQ,CAAC,EAAE,QAAQ,EAqB9B;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAErB;IAED,gBAAgB,CAAC,IAAI,EAAE,eAAe,EAAE,mBAAmB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBnF;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAO,GAAE,cAAmB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAOnF;IAEK,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQnD;IAEK,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D;IAED,OAAO,IAAI,IAAI,CAMd;CACF"}

package/src/view/LocalShadowObjectEnv.js

@@ -3,6 +3,7 @@ import { MessageToView, ShadowObjectsExport } from "../constants.js";
 import { importModule, missingShadowObjectsExportMessage } from "../in-the-dark/importModule.js";
 import { Kernel } from "../in-the-dark/Kernel.js";
 import { Registry } from "../in-the-dark/Registry.js";
+import { createKernelSnapshot } from "../inspect/createKernelSnapshot.js";
 import { toUrlString } from "../utils/toUrlString.js";
 import { cloneChangeTrail } from "./cloneChangeTrail.js";
 class LocalShadowObjectEnv {
@@ -11,7 +12,7 @@ class LocalShadowObjectEnv {
     this.isLocalEnv = true;
     this.disableStructuredClone = false;
     this.kernel = new Kernel(registry);
-    this.#usesDefaultRegistry = this.kernel.registry === Registry.get();
+    this.#usesDefaultRegistry = Registry.isDefault(this.kernel.registry);
     on(this.kernel, MessageToView, (message) => {
       const onMessageToView = this.onMessageToView;
       if (onMessageToView == null) return;
@@ -40,6 +41,19 @@ class LocalShadowObjectEnv {
     if (!waitForConfirmation) return result;
     return result.then(() => void 0);
   }
+  /**
+   * The snapshot of this environment's Kernel, built synchronously inside the call. Nothing is
+   * cloned: the builder emits plain data and the caller owns it. A signal that is already aborted
+   * rejects before anything is built; there is no later point to abort at.
+   */
+  inspect(request = {}, signal) {
+    if (signal?.aborted) return Promise.reject(signal.reason);
+    try {
+      return Promise.resolve(createKernelSnapshot(this.kernel, request));
+    } catch (error) {
+      return Promise.reject(error);
+    }
+  }
   async importScript(url) {
     const module = await import(
       /* @vite-ignore */

package/src/view/LocalShadowObjectEnv.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/view/LocalShadowObjectEnv.ts"],
-  "sourcesContent": ["import {on} from '@spearwolf/eventize';\nimport {MessageToView, ShadowObjectsExport} from '../constants.js';\nimport {importModule, missingShadowObjectsExportMessage} from '../in-the-dark/importModule.js';\nimport {Kernel, type MessageToViewEvent} from '../in-the-dark/Kernel.js';\nimport {Registry} from '../in-the-dark/Registry.js';\nimport type {ChangeTrailType, ShadowObjectsModule, SyncEvent} from '../types.js';\nimport {toUrlString} from '../utils/toUrlString.js';\nimport {cloneChangeTrail} from './cloneChangeTrail.js';\nimport type {IShadowObjectEnvProxy} from './IShadowObjectEnvProxy.js';\n\nexport class LocalShadowObjectEnv implements IShadowObjectEnvProxy {\n  #importedModules: Set<ShadowObjectsModule> = new Set();\n  readonly #usesDefaultRegistry: boolean;\n\n  readonly kernel: Kernel;\n\n  get registry(): Registry {\n    return this.kernel.registry;\n  }\n\n  readonly isLocalEnv = true;\n\n  disableStructuredClone = false;\n\n  constructor(registry?: Registry) {\n    this.kernel = new Kernel(registry);\n    // The default registry is shared with every other environment in this thread and holds\n    // everything `@ShadowObject` and `shadowObjects.define()` register without a registry of\n    // their own, so `destroy()` must not clear it. This check only tells the default registry\n    // apart from any other instance \u2014 a custom registry handed to more than one environment is\n    // cleared by the first one of them to be destroyed, same as the default registry would be\n    // without this guard.\n    this.#usesDefaultRegistry = this.kernel.registry === Registry.get();\n\n    on(this.kernel, MessageToView, (message: MessageToViewEvent) => {\n      const onMessageToView = (this as IShadowObjectEnvProxy).onMessageToView;\n      if (onMessageToView == null) return;\n\n      const {type, uuid, traverseChildren} = message;\n      // WebIDL defaults `transfer` to `[]`, so a missing key and an empty list are the same call.\n      const data = structuredClone(message.data, {transfer: message.transferables ?? []});\n      // call() keeps the binding a plain method call would have given it: an outside\n      // implementation of the proxy interface need not hand over a bound callback\n      onMessageToView.call(this, {type, uuid, data, traverseChildren});\n    });\n  }\n\n  start(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  applyChangeTrail(data: ChangeTrailType, waitForConfirmation: boolean): Promise<void> {\n    const syncData: SyncEvent = {changeTrail: this.disableStructuredClone ? data : cloneChangeTrail(data)};\n    let result: Promise<void>;\n    try {\n      this.kernel.run(syncData);\n      result = Promise.resolve();\n    } catch (error) {\n      result = Promise.reject(error);\n    }\n    if (!waitForConfirmation) return result;\n    // The kernel above still runs synchronously, in the same tick this method is called in; only\n    // the settling of the returned promise is deferred here, by one microtask, so it never\n    // settles in the same microtask as the call that made it. That is the guarantee this gives \u2014\n    // not the same relative ordering RemoteWorkerEnv has against its own promises, which settles\n    // only after its worker round-trip and can land later still.\n    return result.then(() => undefined);\n  }\n\n  async importScript(url: URL | string): Promise<void> {\n    const module = await import(/* @vite-ignore */ toUrlString(url));\n    // A module without this export is wrong in both environments, and a local run rejects it\n    // right here instead of staying quiet -- so a developer sees it before switching to a worker.\n    if (!module[ShadowObjectsExport]) {\n      throw new Error(missingShadowObjectsExportMessage);\n    }\n    await this.importModule(module[ShadowObjectsExport]);\n  }\n\n  async importModule(module: ShadowObjectsModule): Promise<void> {\n    return importModule(this.kernel, module, this.#importedModules);\n  }\n\n  destroy(): void {\n    this.kernel.destroy();\n    if (!this.#usesDefaultRegistry) {\n      this.registry.clear();\n    }\n    this.#importedModules.clear();\n  }\n}\n"],
-  "mappings": "AAAA,SAAQ,UAAS;AACjB,SAAQ,eAAe,2BAA0B;AACjD,SAAQ,cAAc,yCAAwC;AAC9D,SAAQ,cAAsC;AAC9C,SAAQ,gBAAe;AAEvB,SAAQ,mBAAkB;AAC1B,SAAQ,wBAAuB;AAGxB,MAAM,qBAAsD;AAAA,EAcjE,YAAY,UAAqB;AAbjC,4BAA6C,oBAAI,IAAI;AASrD,SAAS,aAAa;AAEtB,kCAAyB;AAGvB,SAAK,SAAS,IAAI,OAAO,QAAQ;AAOjC,SAAK,uBAAuB,KAAK,OAAO,aAAa,SAAS,IAAI;AAElE,OAAG,KAAK,QAAQ,eAAe,CAAC,YAAgC;AAC9D,YAAM,kBAAmB,KAA+B;AACxD,UAAI,mBAAmB,KAAM;AAE7B,YAAM,EAAC,MAAM,MAAM,iBAAgB,IAAI;AAEvC,YAAM,OAAO,gBAAgB,QAAQ,MAAM,EAAC,UAAU,QAAQ,iBAAiB,CAAC,EAAC,CAAC;AAGlF,sBAAgB,KAAK,MAAM,EAAC,MAAM,MAAM,MAAM,iBAAgB,CAAC;AAAA,IACjE,CAAC;AAAA,EACH;AAAA,EAlCA;AAAA,EACS;AAAA,EAIT,IAAI,WAAqB;AACvB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EA6BA,QAAuB;AACrB,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,iBAAiB,MAAuB,qBAA6C;AACnF,UAAM,WAAsB,EAAC,aAAa,KAAK,yBAAyB,OAAO,iBAAiB,IAAI,EAAC;AACrG,QAAI;AACJ,QAAI;AACF,WAAK,OAAO,IAAI,QAAQ;AACxB,eAAS,QAAQ,QAAQ;AAAA,IAC3B,SAAS,OAAO;AACd,eAAS,QAAQ,OAAO,KAAK;AAAA,IAC/B;AACA,QAAI,CAAC,oBAAqB,QAAO;AAMjC,WAAO,OAAO,KAAK,MAAM,MAAS;AAAA,EACpC;AAAA,EAEA,MAAM,aAAa,KAAkC;AACnD,UAAM,SAAS,MAAM;AAAA;AAAA,MAA0B,YAAY,GAAG;AAAA;AAG9D,QAAI,CAAC,OAAO,mBAAmB,GAAG;AAChC,YAAM,IAAI,MAAM,iCAAiC;AAAA,IACnD;AACA,UAAM,KAAK,aAAa,OAAO,mBAAmB,CAAC;AAAA,EACrD;AAAA,EAEA,MAAM,aAAa,QAA4C;AAC7D,WAAO,aAAa,KAAK,QAAQ,QAAQ,KAAK,gBAAgB;AAAA,EAChE;AAAA,EAEA,UAAgB;AACd,SAAK,OAAO,QAAQ;AACpB,QAAI,CAAC,KAAK,sBAAsB;AAC9B,WAAK,SAAS,MAAM;AAAA,IACtB;AACA,SAAK,iBAAiB,MAAM;AAAA,EAC9B;AACF;",
+  "sourcesContent": ["import {on} from '@spearwolf/eventize';\nimport {MessageToView, ShadowObjectsExport} from '../constants.js';\nimport {importModule, missingShadowObjectsExportMessage} from '../in-the-dark/importModule.js';\nimport {Kernel, type MessageToViewEvent} from '../in-the-dark/Kernel.js';\nimport {Registry} from '../in-the-dark/Registry.js';\nimport {createKernelSnapshot} from '../inspect/createKernelSnapshot.js';\nimport type {InspectRequest, KernelSnapshot} from '../inspect/types.js';\nimport type {ChangeTrailType, ShadowObjectsModule, SyncEvent} from '../types.js';\nimport {toUrlString} from '../utils/toUrlString.js';\nimport {cloneChangeTrail} from './cloneChangeTrail.js';\nimport type {IShadowObjectEnvProxy} from './IShadowObjectEnvProxy.js';\n\nexport class LocalShadowObjectEnv implements IShadowObjectEnvProxy {\n  #importedModules: Set<ShadowObjectsModule> = new Set();\n  readonly #usesDefaultRegistry: boolean;\n\n  readonly kernel: Kernel;\n\n  get registry(): Registry {\n    return this.kernel.registry;\n  }\n\n  readonly isLocalEnv = true;\n\n  disableStructuredClone = false;\n\n  constructor(registry?: Registry) {\n    this.kernel = new Kernel(registry);\n    // The default registry is shared with every other environment in this thread and holds\n    // everything `@ShadowObject` and `shadowObjects.define()` register without a registry of\n    // their own, so `destroy()` must not clear it. This check only tells the default registry\n    // apart from any other instance \u2014 a custom registry handed to more than one environment is\n    // cleared by the first one of them to be destroyed, same as the default registry would be\n    // without this guard.\n    this.#usesDefaultRegistry = Registry.isDefault(this.kernel.registry);\n\n    on(this.kernel, MessageToView, (message: MessageToViewEvent) => {\n      const onMessageToView = (this as IShadowObjectEnvProxy).onMessageToView;\n      if (onMessageToView == null) return;\n\n      const {type, uuid, traverseChildren} = message;\n      // WebIDL defaults `transfer` to `[]`, so a missing key and an empty list are the same call.\n      const data = structuredClone(message.data, {transfer: message.transferables ?? []});\n      // call() keeps the binding a plain method call would have given it: an outside\n      // implementation of the proxy interface need not hand over a bound callback\n      onMessageToView.call(this, {type, uuid, data, traverseChildren});\n    });\n  }\n\n  start(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  applyChangeTrail(data: ChangeTrailType, waitForConfirmation: boolean): Promise<void> {\n    const syncData: SyncEvent = {changeTrail: this.disableStructuredClone ? data : cloneChangeTrail(data)};\n    let result: Promise<void>;\n    try {\n      this.kernel.run(syncData);\n      result = Promise.resolve();\n    } catch (error) {\n      result = Promise.reject(error);\n    }\n    if (!waitForConfirmation) return result;\n    // The kernel above still runs synchronously, in the same tick this method is called in; only\n    // the settling of the returned promise is deferred here, by one microtask, so it never\n    // settles in the same microtask as the call that made it. That is the guarantee this gives \u2014\n    // not the same relative ordering RemoteWorkerEnv has against its own promises, which settles\n    // only after its worker round-trip and can land later still.\n    return result.then(() => undefined);\n  }\n\n  /**\n   * The snapshot of this environment's Kernel, built synchronously inside the call. Nothing is\n   * cloned: the builder emits plain data and the caller owns it. A signal that is already aborted\n   * rejects before anything is built; there is no later point to abort at.\n   */\n  inspect(request: InspectRequest = {}, signal?: AbortSignal): Promise<KernelSnapshot> {\n    if (signal?.aborted) return Promise.reject(signal.reason);\n    try {\n      return Promise.resolve(createKernelSnapshot(this.kernel, request));\n    } catch (error) {\n      return Promise.reject(error);\n    }\n  }\n\n  async importScript(url: URL | string): Promise<void> {\n    const module = await import(/* @vite-ignore */ toUrlString(url));\n    // A module without this export is wrong in both environments, and a local run rejects it\n    // right here instead of staying quiet -- so a developer sees it before switching to a worker.\n    if (!module[ShadowObjectsExport]) {\n      throw new Error(missingShadowObjectsExportMessage);\n    }\n    await this.importModule(module[ShadowObjectsExport]);\n  }\n\n  async importModule(module: ShadowObjectsModule): Promise<void> {\n    return importModule(this.kernel, module, this.#importedModules);\n  }\n\n  destroy(): void {\n    this.kernel.destroy();\n    if (!this.#usesDefaultRegistry) {\n      this.registry.clear();\n    }\n    this.#importedModules.clear();\n  }\n}\n"],
+  "mappings": "AAAA,SAAQ,UAAS;AACjB,SAAQ,eAAe,2BAA0B;AACjD,SAAQ,cAAc,yCAAwC;AAC9D,SAAQ,cAAsC;AAC9C,SAAQ,gBAAe;AACvB,SAAQ,4BAA2B;AAGnC,SAAQ,mBAAkB;AAC1B,SAAQ,wBAAuB;AAGxB,MAAM,qBAAsD;AAAA,EAcjE,YAAY,UAAqB;AAbjC,4BAA6C,oBAAI,IAAI;AASrD,SAAS,aAAa;AAEtB,kCAAyB;AAGvB,SAAK,SAAS,IAAI,OAAO,QAAQ;AAOjC,SAAK,uBAAuB,SAAS,UAAU,KAAK,OAAO,QAAQ;AAEnE,OAAG,KAAK,QAAQ,eAAe,CAAC,YAAgC;AAC9D,YAAM,kBAAmB,KAA+B;AACxD,UAAI,mBAAmB,KAAM;AAE7B,YAAM,EAAC,MAAM,MAAM,iBAAgB,IAAI;AAEvC,YAAM,OAAO,gBAAgB,QAAQ,MAAM,EAAC,UAAU,QAAQ,iBAAiB,CAAC,EAAC,CAAC;AAGlF,sBAAgB,KAAK,MAAM,EAAC,MAAM,MAAM,MAAM,iBAAgB,CAAC;AAAA,IACjE,CAAC;AAAA,EACH;AAAA,EAlCA;AAAA,EACS;AAAA,EAIT,IAAI,WAAqB;AACvB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EA6BA,QAAuB;AACrB,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,iBAAiB,MAAuB,qBAA6C;AACnF,UAAM,WAAsB,EAAC,aAAa,KAAK,yBAAyB,OAAO,iBAAiB,IAAI,EAAC;AACrG,QAAI;AACJ,QAAI;AACF,WAAK,OAAO,IAAI,QAAQ;AACxB,eAAS,QAAQ,QAAQ;AAAA,IAC3B,SAAS,OAAO;AACd,eAAS,QAAQ,OAAO,KAAK;AAAA,IAC/B;AACA,QAAI,CAAC,oBAAqB,QAAO;AAMjC,WAAO,OAAO,KAAK,MAAM,MAAS;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAQ,UAA0B,CAAC,GAAG,QAA+C;AACnF,QAAI,QAAQ,QAAS,QAAO,QAAQ,OAAO,OAAO,MAAM;AACxD,QAAI;AACF,aAAO,QAAQ,QAAQ,qBAAqB,KAAK,QAAQ,OAAO,CAAC;AAAA,IACnE,SAAS,OAAO;AACd,aAAO,QAAQ,OAAO,KAAK;AAAA,IAC7B;AAAA,EACF;AAAA,EAEA,MAAM,aAAa,KAAkC;AACnD,UAAM,SAAS,MAAM;AAAA;AAAA,MAA0B,YAAY,GAAG;AAAA;AAG9D,QAAI,CAAC,OAAO,mBAAmB,GAAG;AAChC,YAAM,IAAI,MAAM,iCAAiC;AAAA,IACnD;AACA,UAAM,KAAK,aAAa,OAAO,mBAAmB,CAAC;AAAA,EACrD;AAAA,EAEA,MAAM,aAAa,QAA4C;AAC7D,WAAO,aAAa,KAAK,QAAQ,QAAQ,KAAK,gBAAgB;AAAA,EAChE;AAAA,EAEA,UAAgB;AACd,SAAK,OAAO,QAAQ;AACpB,QAAI,CAAC,KAAK,sBAAsB;AAC9B,WAAK,SAAS,MAAM;AAAA,IACtB;AACA,SAAK,iBAAiB,MAAM;AAAA,EAC9B;AACF;",
   "names": []
 }