@spearwolf/shadow-objects 0.33.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[];
@@ -14,7 +15,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 +68,51 @@ 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;
+}
+/**
+ * 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;
+    parent?: EntityApi | undefined;
     children: readonly EntityApi[];
     traverse(callback: (entity: EntityApi) => unknown): void;
 }>;
@@ -74,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>>;
@@ -89,38 +172,125 @@ 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>;
-    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.
      *
+     * 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.
      */
-    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 {
-    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;
 }
+/** 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: {
@@ -134,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/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

package/src/utils/ConsoleLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConsoleLogger.d.ts","sourceRoot":"","sources":["../../../src/utils/ConsoleLogger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAC9C,eAAO,MAAM,sBAAsB,yBAA6B,CAAC;AAkDjE,qBAAa,aAAa;;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,MAAM,UAAQ;IAEd,MAAM,CAAC,YAAY;;;;;;;;;MAWjB;IAEF,MAAM,KAAK,SAAS,YAEnB;IAED,MAAM,KAAK,OAAO,YAEjB;IAED,MAAM,CAAC,YAAY;eAIF,MAAM;cAMP,MAAM;cAMN,MAAM;eAML,MAAM;MAGrB;IAEF,MAAM,CAAC,UAAU;gBA4EL,SAAS,EAAE,MAAM;IAa7B,IAAI,SAAS,YAEZ;IAED,IAAI,OAAO,YAEV;IAED,IAAI,MAAM,YAET;IAED,IAAI,MAAM,YAET;IAED,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAIpB,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAInB,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAInB,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;CAOrB"}
+{"version":3,"file":"ConsoleLogger.d.ts","sourceRoot":"","sources":["../../../src/utils/ConsoleLogger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAC9C,eAAO,MAAM,sBAAsB,yBAA6B,CAAC;AAmDjE,QAAA,MAAM,cAAc,EAAE,OAAO,MAAmC,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,oBAAoB;IACnC,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAgDD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAS,MAAM,GAAG,MAAM,EAAE,KAAG,MAAyB,CAAC;AAE1F;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAS,MAAM,GAAG,MAAM,EAAE,gBAAgB,MAAM,KAAG,MACxC,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CASzE;AAED,qBAAa,aAAa;;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,MAAM,UAAQ;IAEd,MAAM,CAAC,YAAY,EAAE,mBAAmB,CAWtC;IAEF,MAAM,KAAK,SAAS,YAEnB;IAED,MAAM,KAAK,OAAO,YAEjB;IAED,MAAM,CAAC,YAAY;eAIF,MAAM;cAMP,MAAM;cAMN,MAAM;eAML,MAAM;MAGrB;IAEF,MAAM,CAAC,UAAU,SA8DhB;IAED,YAAY,SAAS,EAAE,MAAM,EAY5B;IAED,IAAI,SAAS,YAEZ;IAED,IAAI,OAAO,YAEV;IAED,IAAI,MAAM,YAET;IAED,IAAI,MAAM,YAET;IAED,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,QAGnB;IAED,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,QAGlB;IAED,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,QAGlB;IAID,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,QAEnB;CAKF"}