@spearwolf/shadow-objects 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/elements/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAC,yBAAyB,EAAE,2BAA2B,EAAC,MAAM,gBAAgB,CAAC;AAE3F,MAAM,WAAW,qBAAsB,SAAQ,WAAW;IACxD,MAAM,EAAE;QACN,SAAS,EAAE,cAAc,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,MAAM,EAAE;QACN,SAAS,EAAE,cAAc,CAAC;QAC1B,cAAc,EAAE,WAAW,CAAC;KAC7B,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,CAAC,yBAAyB,CAAC,EAAE,qBAAqB,CAAC;IACnD,CAAC,2BAA2B,CAAC,EAAE,uBAAuB,CAAC;CACxD;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,mBAAoB,SAAQ,kBAAkB;QACtD,gBAAgB,CAAC,CAAC,SAAS,MAAM,kBAAkB,EACjD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC5D,IAAI,CAAC;QACR,aAAa,CAAC,CAAC,SAAS,MAAM,kBAAkB,EAAE,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;KACpF;CACF"}

package/src/elements/events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.js.map

package/src/elements/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/elements/events.ts"],"names":[],"mappings":""}

package/src/entities/Entity.d.ts

@@ -0,0 +1,46 @@
+import { SignalObject, type SignalReader, type SignalWriter } from '@spearwolf/signalize';
+import type { IComponentEvent } from '../types.js';
+import { Kernel } from './Kernel.js';
+type ContextNameType = string | symbol;
+/**
+ * An entity has a parent and children, replicating the hierarchy of view-components.
+ *
+ * A signal is created for each view-component property.
+ *
+ * Shadow-objects can use the signal properties via the entity.
+ */
+export declare class Entity {
+    #private;
+    get kernel(): Kernel;
+    get uuid(): string;
+    get order(): number;
+    set order(value: number);
+    get parentUuid(): string | undefined;
+    set parentUuid(parentUuid: string | undefined);
+    get parent(): Entity | undefined;
+    set parent(parent: Entity | undefined);
+    get hasParent(): boolean;
+    get children(): readonly Entity[];
+    constructor(kernel: Kernel, uuid: string);
+    traverse(callback: (entity: Entity) => void): void;
+    onDestroy(): void;
+    addChild(child: Entity): void;
+    resortChildren(): void;
+    removeChild(child: Entity): void;
+    removeFromParent(): void;
+    dispatchMessageToView(type: string, data?: unknown, transferables?: Transferable[], traverseChildren?: boolean): void;
+    dispatchViewEvents(events: IComponentEvent[]): void;
+    dispatchViewEvent(type: string, data: unknown): void;
+    getPropertyReader<T = unknown>(key: string): SignalReader<T>;
+    getPropertyWriter<T = unknown>(key: string): SignalWriter<T>;
+    setProperties(properties: [string, unknown][]): void;
+    setProperty(key: string, value: unknown): void;
+    getProperty<T = unknown>(key: string): T;
+    propKeys(): string[];
+    propEntries(): [string, unknown][];
+    hasContext(name: ContextNameType): boolean;
+    useContext<T = unknown>(name: ContextNameType): SignalReader<T>;
+    provideContext<T = unknown>(name: ContextNameType): SignalObject<T>;
+}
+export {};
+//# sourceMappingURL=Entity.d.ts.map

package/src/entities/Entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Entity.d.ts","sourceRoot":"","sources":["../../../src/entities/Entity.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,YAAY,EAEZ,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AACjD,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AAKnC,KAAK,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAYvC;;;;;;GAMG;AACH,qBAAa,MAAM;;IAejB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAOtB;IAED,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED,IAAI,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAW5C;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAK/B;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAEpC;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,QAAQ,IAAI,SAAS,MAAM,EAAE,CAEhC;gBAEW,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAMxC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI;IAO3C,SAAS;IAkBT,QAAQ,CAAC,KAAK,EAAE,MAAM;IA0BtB,cAAc;IAId,WAAW,CAAC,KAAK,EAAE,MAAM;IAQzB,gBAAgB;IAoBhB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,YAAY,EAAE,EAAE,gBAAgB,UAAQ;IAI5G,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE;IAM5C,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;IAQ7C,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;IAI5D,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;IAI5D,aAAa,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IAQ7C,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;IAIvC,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAIxC,QAAQ,IAAI,MAAM,EAAE;IAIpB,WAAW,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IAIlC,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO;IAM1C,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,eAAe,GAAG,YAAY,CAAC,CAAC,CAAC;IAM/D,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,eAAe,GAAG,YAAY,CAAC,CAAC,CAAC;CAoCpE"}

package/src/entities/Entity.js

@@ -0,0 +1,217 @@
+import { emit, off, on, once, Priority } from '@spearwolf/eventize';
+import { batch, createSignal, destroySignals, SignalObject, value, } from '@spearwolf/signalize';
+import { Kernel } from './Kernel.js';
+import { SignalsMap } from './SignalsMap.js';
+import { SignalsPath } from './SignalsPath.js';
+import { onDestroy, onViewEvent } from './events.js';
+/**
+ * An entity has a parent and children, replicating the hierarchy of view-components.
+ *
+ * A signal is created for each view-component property.
+ *
+ * Shadow-objects can use the signal properties via the entity.
+ */
+export class Entity {
+    #kernel;
+    #uuid;
+    #props = new SignalsMap();
+    #context = new Map();
+    #parentUuid;
+    #parent;
+    #childrenUuids = new Set();
+    #children = [];
+    #order = 0;
+    get kernel() {
+        return this.#kernel;
+    }
+    get uuid() {
+        return this.#uuid;
+    }
+    get order() {
+        return this.#order;
+    }
+    set order(value) {
+        if (this.#order !== value) {
+            this.#order = value;
+            if (this.#parentUuid) {
+                this.parent.resortChildren();
+            }
+        }
+    }
+    get parentUuid() {
+        return this.#parentUuid || undefined;
+    }
+    set parentUuid(parentUuid) {
+        if (this.#parentUuid !== parentUuid) {
+            this.removeFromParent();
+            this.#parentUuid = parentUuid || undefined;
+            this.#parent = parentUuid ? this.#kernel.getEntity(parentUuid) : undefined;
+            if (this.#parent) {
+                this.#parent.addChild(this);
+            }
+        }
+    }
+    get parent() {
+        if (!this.#parent && this.#parentUuid) {
+            this.#parent = this.#kernel.getEntity(this.#parentUuid);
+        }
+        return this.#parent;
+    }
+    set parent(parent) {
+        this.parentUuid = parent?.uuid;
+    }
+    get hasParent() {
+        return !!this.#parentUuid;
+    }
+    get children() {
+        return this.#children;
+    }
+    constructor(kernel, uuid) {
+        this.#kernel = kernel;
+        this.#uuid = uuid;
+        once(this, onDestroy, Priority.Min, this);
+    }
+    traverse(callback) {
+        callback(this);
+        for (const child of this.#children) {
+            child.traverse(callback);
+        }
+    }
+    onDestroy() {
+        this.#props.clear();
+        off(this);
+        for (const ctx of this.#context.values()) {
+            ctx.unsubscribeFromPath();
+            ctx.unsubscribeFromParent?.();
+            ctx.ctxPath.dispose();
+            destroySignals(ctx.inherited, ctx.provide, ctx.context);
+        }
+        this.#parentUuid = undefined;
+        this.#parent = undefined;
+        this.#childrenUuids.clear();
+        this.#children.length = 0;
+    }
+    addChild(child) {
+        if (this.#children.length === 0) {
+            this.#childrenUuids.add(child.uuid);
+            this.#children.push(child);
+            // this.emit(onAddChild, this, child);
+            // child.emit(onAddToParent, child, this);
+            return;
+        }
+        if (this.#childrenUuids.has(child.uuid)) {
+            throw new Error(`child with uuid: ${child.uuid} already exists! parentUuid: ${this.uuid}`);
+        }
+        this.#childrenUuids.add(child.uuid);
+        this.#children.push(child);
+        this.resortChildren();
+        for (const [, ctx] of child.#context) {
+            child.#subscribeToParentContext(ctx);
+        }
+        // this.emit(onAddChild, this, child);
+        // child.emit(onAddToParent, child, this);
+    }
+    resortChildren() {
+        this.#children.sort((a, b) => a.order - b.order);
+    }
+    removeChild(child) {
+        if (this.#childrenUuids.has(child.uuid)) {
+            this.#childrenUuids.delete(child.uuid);
+            this.#children.splice(this.#children.indexOf(child), 1);
+            // this.emit(onRemoveChild, this, child);
+        }
+    }
+    removeFromParent() {
+        if (this.#parent) {
+            // const prevParent = this.#parent;
+            this.#parent.removeChild(this);
+            this.#parent = undefined;
+            this.#parentUuid = undefined;
+            for (const [, ctx] of this.#context) {
+                if (ctx.unsubscribeFromParent) {
+                    ctx.unsubscribeFromParent();
+                    ctx.unsubscribeFromParent = undefined;
+                }
+            }
+            // this.emit(onRemoveFromParent, this, prevParent);
+        }
+    }
+    dispatchMessageToView(type, data, transferables, traverseChildren = false) {
+        this.#kernel.dispatchMessageToView({ uuid: this.#uuid, type, data, transferables, traverseChildren });
+    }
+    dispatchViewEvents(events) {
+        for (const { type, data } of events) {
+            emit(this, onViewEvent, type, data);
+        }
+    }
+    dispatchViewEvent(type, data) {
+        this.dispatchViewEvents([{ type, data }]);
+    }
+    #getPropSignal(key) {
+        return this.#props.getSignal(key);
+    }
+    getPropertyReader(key) {
+        return this.#getPropSignal(key).get;
+    }
+    getPropertyWriter(key) {
+        return this.#getPropSignal(key).set;
+    }
+    setProperties(properties) {
+        batch(() => {
+            for (const [key, val] of properties) {
+                this.setProperty(key, val);
+            }
+        });
+    }
+    setProperty(key, value) {
+        this.getPropertyWriter(key)(value);
+    }
+    getProperty(key) {
+        return value(this.getPropertyReader(key));
+    }
+    propKeys() {
+        return Array.from(this.#props.keys());
+    }
+    propEntries() {
+        return Array.from(this.#props.entries()).map(([key, sig]) => [key, sig.value]);
+    }
+    hasContext(name) {
+        return this.#context.has(name);
+    }
+    // TODO(test) write tests for useContext()
+    useContext(name) {
+        return this.#getContext(name).context.get;
+    }
+    // TODO(test) write tests for provideContext()
+    provideContext(name) {
+        return this.#getContext(name).provide;
+    }
+    #getContext(name) {
+        let ctx = this.#context.get(name);
+        if (ctx == null) {
+            const inherited = createSignal();
+            const provide = createSignal();
+            const context = createSignal();
+            const ctxPath = new SignalsPath();
+            ctxPath.add(provide.get, inherited.get);
+            const unsubscribeFromPath = on(ctxPath, SignalsPath.Value, (val) => {
+                queueMicrotask(() => {
+                    context.set(val);
+                });
+            });
+            ctx = { name, inherited, provide, context, ctxPath, unsubscribeFromPath };
+            this.#context.set(name, ctx);
+            this.#subscribeToParentContext(ctx);
+        }
+        return ctx;
+    }
+    #subscribeToParentContext(ctx) {
+        if (this.parent) {
+            ctx.unsubscribeFromParent?.();
+            ctx.unsubscribeFromParent = on(this.parent.#getContext(ctx.name).ctxPath, SignalsPath.Value, (val) => {
+                ctx.inherited.set(val);
+            });
+        }
+    }
+}
+//# sourceMappingURL=Entity.js.map

package/src/entities/Entity.js.map

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

package/src/entities/Kernel.d.ts

@@ -0,0 +1,60 @@
+import type { IComponentEvent, ShadowObjectType, SyncEvent } from '../types.js';
+import { Entity } from './Entity.js';
+import { Registry } from './Registry.js';
+export interface MessageToViewEvent {
+    uuid: string;
+    type: string;
+    data?: unknown;
+    transferables?: Transferable[];
+    traverseChildren?: boolean;
+}
+interface EntityGraphNode {
+    token: string;
+    entity: Entity;
+    props: Record<string, unknown>;
+    children: EntityGraphNode[];
+}
+/**
+ * The entity kernel manages the lifecycle of all entities and shadow-objects.
+ *
+ * An entity is created for each view-component. The entities act as containers for the shadow-objects.
+ *
+ * Which shadow-objects are created is determined by the token.
+ */
+export declare class Kernel {
+    #private;
+    registry: Registry;
+    constructor(registry?: Registry);
+    getEntity(uuid: string): Entity;
+    hasEntity(uuid: string): boolean;
+    /**
+     * @returns all entities in breadth-first order
+     */
+    traverseLevelOrderBFS(reverse?: boolean): Entity[];
+    getEntityGraph(): EntityGraphNode[];
+    private getEntityGraphNode;
+    upgradeEntities(): void;
+    run(event: SyncEvent): void;
+    private parse;
+    createEntity(uuid: string, token: string, parentUuid?: string, order?: number, properties?: [string, unknown][]): void;
+    destroyEntity(uuid: string): void;
+    setParent(uuid: string, parentUuid?: string, order?: number): void;
+    updateOrder(uuid: string, order: number): void;
+    dispatchEventsToEntity(uuid: string, events: IComponentEvent[]): void;
+    changeProperties(uuid: string, properties: [string, unknown][]): void;
+    changeToken(uuid: string, token: string): void;
+    dispatchMessageToView(message: MessageToViewEvent): void;
+    /**
+     * Create or destroy the shadow-objects of an entity using the registered constructors.
+     * After a token change or registry changes, an entity may be given different shadow-objects.
+     */
+    private updateShadowObjects;
+    private constructShadowObject;
+    private createShadowObjects;
+    findShadowObjects(uuid: string): ShadowObjectType[];
+    private attachShadowObject;
+    private destroyShadowObject;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=Kernel.d.ts.map

package/src/entities/Kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Kernel.d.ts","sourceRoot":"","sources":["../../../src/entities/Kernel.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAEV,eAAe,EAGf,gBAAgB,EAChB,SAAS,EACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AACnC,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AAGvC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAE5B;AAQD,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAUD;;;;;;GAMG;AACH,qBAAa,MAAM;;IACjB,QAAQ,EAAE,QAAQ,CAAC;gBASP,QAAQ,CAAC,EAAE,QAAQ;IAK/B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQ/B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,qBAAqB,CAAC,OAAO,UAAQ,GAAG,MAAM,EAAE;IAgChD,cAAc,IAAI,eAAe,EAAE;IAInC,OAAO,CAAC,kBAAkB;IAY1B,eAAe,IAAI,IAAI;IAUvB,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAQ3B,OAAO,CAAC,KAAK;IAoCb,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,SAAI,EAAE,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI;IAwBjH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAcjC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,IAAI;IAiB7D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9C,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI;IAIrE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI;IAIrE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAY9C,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAMxD;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA+B3B,OAAO,CAAC,qBAAqB;IA8H7B,OAAO,CAAC,mBAAmB;IAQ3B,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAcnD,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,mBAAmB;IAU3B,OAAO,IAAI,IAAI;CAKhB"}