@lightningjs/renderer 0.0.1

package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.d.ts

@@ -0,0 +1,19 @@
+import type { NodeStruct } from '../NodeStruct.js';
+import { SharedNode } from '../SharedNode.js';
+import type { Stage } from '../../../core/Stage.js';
+import type { Texture } from '../../../core/textures/Texture.js';
+import { CoreNode } from '../../../core/CoreNode.js';
+export declare class ThreadXRendererNode extends SharedNode {
+    private stage;
+    protected coreNode: CoreNode;
+    protected _parent: ThreadXRendererNode | null;
+    protected _children: ThreadXRendererNode[];
+    texture: Texture | null;
+    private animationControllers;
+    constructor(stage: Stage, sharedNodeStruct: NodeStruct, coreNode?: CoreNode, extendedCurProps?: Record<string, unknown>);
+    onPropertyChange<Key extends keyof this['z$__type__Props']>(propName: Key, newValue: this['z$__type__Props'][Key], oldValue: this['z$__type__Props'][Key] | undefined): void;
+    get parent(): ThreadXRendererNode | null;
+    set parent(newParent: ThreadXRendererNode | null);
+    get children(): ThreadXRendererNode[];
+    private createCoreNode;
+}

package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js

@@ -0,0 +1,172 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { SharedNode } from '../SharedNode.js';
+import { ThreadX } from '@lightningjs/threadx';
+import { assertTruthy } from '../../../utils.js';
+import { CoreAnimation } from '../../../core/animations/CoreAnimation.js';
+import { CoreAnimationController } from '../../../core/animations/CoreAnimationController.js';
+import { CoreNode } from '../../../core/CoreNode.js';
+export class ThreadXRendererNode extends SharedNode {
+    stage;
+    coreNode;
+    _parent = null;
+    _children = [];
+    texture = null;
+    animationControllers = new Map();
+    constructor(stage, sharedNodeStruct, coreNode, extendedCurProps) {
+        super(sharedNodeStruct, extendedCurProps);
+        this.stage = stage;
+        // This Proxy makes sure properties on the coreNode that an animation
+        // changes are also updated on the shared node.
+        // TODO: Improve this pattern because its ugly!!!
+        this.coreNode = new Proxy(coreNode || this.createCoreNode(stage, sharedNodeStruct), {
+            set: (target, prop, value) => {
+                // Only set the numeric properties on the shared node.
+                if (prop !== 'parent' && prop !== 'texture' && prop !== 'shader') {
+                    Reflect.set(this, prop, value);
+                }
+                return Reflect.set(target, prop, value);
+            },
+        });
+        // Set up parent
+        const parent = ThreadX.instance.getSharedObjectById(sharedNodeStruct.parentId);
+        assertTruthy(parent instanceof ThreadXRendererNode || parent === null);
+        this.parent = parent;
+        // Create inbound event listeners
+        // TOOD: Make sure event listeners are removed when the node is destroyed.
+        this.on('createAnimation', (target, { id, props, settings }) => {
+            const animation = new CoreAnimation(this.coreNode, props, settings);
+            animation.on('finished', () => {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+                this.emit('animationFinished', {
+                    id: id,
+                    loop: settings.loop,
+                });
+            });
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call
+            const controller = new CoreAnimationController(this.stage.animationManager, animation);
+            this.animationControllers.set(id, controller);
+        });
+        this.on('destroyAnimation', (target, { id }) => {
+            this.animationControllers.delete(id);
+        });
+        this.on('startAnimation', (target, { id }) => {
+            this.animationControllers.get(id)?.start();
+        });
+        this.on('stopAnimation', (target, { id }) => {
+            this.animationControllers.get(id)?.stop();
+        });
+        this.on('pauseAnimation', (target, { id }) => {
+            this.animationControllers.get(id)?.pause();
+        });
+        this.on('loadTexture', (target, textureDesc) => {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any
+            this.coreNode.loadTexture(textureDesc.txType, textureDesc.props, textureDesc.options);
+        });
+        this.on('loadShader', (target, shaderDesc) => {
+            this.coreNode.loadShader(shaderDesc.shType, shaderDesc.props);
+        });
+        this.on('unloadTexture', (target) => {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any
+            this.coreNode.unloadTexture();
+        });
+        // Forward on CoreNode events
+        this.coreNode.on('txLoaded', (target, dimensions) => {
+            this.emit('txLoaded', dimensions);
+        });
+        this.coreNode.on('txFailed', (target, error) => {
+            this.emit('txFailed', error);
+        });
+    }
+    onPropertyChange(propName, newValue, oldValue) {
+        if (propName === 'parentId') {
+            const parent = ThreadX.instance.getSharedObjectById(newValue);
+            assertTruthy(parent instanceof ThreadXRendererNode || parent === null);
+            this.parent = parent;
+            return;
+        }
+        else {
+            // @ts-expect-error Ignore readonly assignment errors
+            this.coreNode[propName] =
+                newValue;
+        }
+    }
+    //#region Parent/Child Props
+    get parent() {
+        return this._parent;
+    }
+    set parent(newParent) {
+        const oldParent = this._parent;
+        this._parent = newParent;
+        this.coreNode.parent = newParent?.coreNode ?? null;
+        this.parentId = newParent?.id ?? 0;
+        if (oldParent) {
+            const index = oldParent.children.indexOf(this);
+            assertTruthy(index !== -1, "ThreadXRendererNode.parent: Node not found in old parent's children!");
+            oldParent.children.splice(index, 1);
+        }
+        if (newParent) {
+            newParent.children.push(this);
+        }
+    }
+    get children() {
+        return this._children;
+    }
+    //#endregion Parent/Child Props
+    createCoreNode(stage, sharedNodeStruct) {
+        const parent = ThreadX.instance.getSharedObjectById(sharedNodeStruct.parentId);
+        assertTruthy(parent instanceof ThreadXRendererNode || parent === null);
+        const node = new CoreNode(stage, {
+            id: sharedNodeStruct.id,
+            x: sharedNodeStruct.x,
+            y: sharedNodeStruct.y,
+            width: sharedNodeStruct.width,
+            height: sharedNodeStruct.height,
+            alpha: sharedNodeStruct.alpha,
+            color: sharedNodeStruct.color,
+            colorTop: sharedNodeStruct.colorTop,
+            colorBottom: sharedNodeStruct.colorBottom,
+            colorLeft: sharedNodeStruct.colorLeft,
+            colorRight: sharedNodeStruct.colorRight,
+            colorTl: sharedNodeStruct.colorTl,
+            colorTr: sharedNodeStruct.colorTr,
+            colorBl: sharedNodeStruct.colorBl,
+            colorBr: sharedNodeStruct.colorBr,
+            zIndex: sharedNodeStruct.zIndex,
+            zIndexLocked: sharedNodeStruct.zIndexLocked,
+            scale: sharedNodeStruct.scale,
+            mount: sharedNodeStruct.mount,
+            mountX: sharedNodeStruct.mountX,
+            mountY: sharedNodeStruct.mountY,
+            pivot: sharedNodeStruct.pivot,
+            pivotX: sharedNodeStruct.pivotX,
+            pivotY: sharedNodeStruct.pivotY,
+            rotation: sharedNodeStruct.rotation,
+            // These are passed in via message handlers
+            shader: null,
+            shaderProps: null,
+            texture: null,
+            textureOptions: null,
+            // Setup the parent after
+            parent: null,
+        });
+        return node;
+    }
+}
+//# sourceMappingURL=ThreadXRendererNode.js.map

package/dist/src/render-drivers/threadx/worker/ThreadXRendererNode.js.map

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

package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.d.ts

@@ -0,0 +1,22 @@
+import { CoreTextNode } from '../../../core/CoreTextNode.js';
+import type { Stage } from '../../../core/Stage.js';
+import type { TextNodeStruct, TextNodeStructWritableProps } from '../TextNodeStruct.js';
+import { ThreadXRendererNode } from './ThreadXRendererNode.js';
+export declare class ThreadXRendererTextNode extends ThreadXRendererNode {
+    coreNode: CoreTextNode;
+    z$__type__Props: TextNodeStructWritableProps & ThreadXRendererNode['z$__type__Props'];
+    constructor(stage: Stage, sharedNodeStruct: TextNodeStruct);
+    text: TextNodeStructWritableProps['text'];
+    textRendererOverride: TextNodeStructWritableProps['textRendererOverride'];
+    fontSize: TextNodeStructWritableProps['fontSize'];
+    fontFamily: TextNodeStructWritableProps['fontFamily'];
+    fontWeight: TextNodeStructWritableProps['fontWeight'];
+    fontStretch: TextNodeStructWritableProps['fontStretch'];
+    fontStyle: TextNodeStructWritableProps['fontStyle'];
+    contain: TextNodeStructWritableProps['contain'];
+    letterSpacing: TextNodeStructWritableProps['letterSpacing'];
+    offsetY: TextNodeStructWritableProps['offsetY'];
+    textAlign: TextNodeStructWritableProps['textAlign'];
+    scrollable: TextNodeStructWritableProps['scrollable'];
+    scrollY: TextNodeStructWritableProps['scrollY'];
+}

package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js

@@ -0,0 +1,101 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { CoreTextNode } from '../../../core/CoreTextNode.js';
+import { ThreadXRendererNode } from './ThreadXRendererNode.js';
+export class ThreadXRendererTextNode extends ThreadXRendererNode {
+    constructor(stage, sharedNodeStruct) {
+        super(stage, sharedNodeStruct, new CoreTextNode(stage, {
+            id: sharedNodeStruct.id,
+            // It doesn't matter what these are initially. They will be reset
+            // appropriately via the onPropertyChange() calls below and in the
+            // ThreadXRendererNode constructor.
+            x: sharedNodeStruct.x,
+            y: sharedNodeStruct.y,
+            width: sharedNodeStruct.width,
+            height: sharedNodeStruct.height,
+            alpha: sharedNodeStruct.alpha,
+            color: sharedNodeStruct.color,
+            colorTop: sharedNodeStruct.colorTop,
+            colorBottom: sharedNodeStruct.colorBottom,
+            colorLeft: sharedNodeStruct.colorLeft,
+            colorRight: sharedNodeStruct.colorRight,
+            colorTl: sharedNodeStruct.colorTl,
+            colorTr: sharedNodeStruct.colorTr,
+            colorBl: sharedNodeStruct.colorBl,
+            colorBr: sharedNodeStruct.colorBr,
+            zIndex: sharedNodeStruct.zIndex,
+            zIndexLocked: sharedNodeStruct.zIndexLocked,
+            mount: sharedNodeStruct.mount,
+            mountX: sharedNodeStruct.mountX,
+            mountY: sharedNodeStruct.mountY,
+            pivot: sharedNodeStruct.pivot,
+            pivotX: sharedNodeStruct.pivotX,
+            pivotY: sharedNodeStruct.pivotY,
+            scale: sharedNodeStruct.scale,
+            rotation: sharedNodeStruct.rotation,
+            // These are passed in via message handlers
+            shader: null,
+            shaderProps: null,
+            texture: null,
+            textureOptions: null,
+            // Setup the parent after
+            parent: null,
+            // Text properties
+            text: sharedNodeStruct.text,
+            textRendererOverride: sharedNodeStruct.textRendererOverride,
+            fontSize: sharedNodeStruct.fontSize,
+            fontFamily: sharedNodeStruct.fontFamily,
+            fontWeight: sharedNodeStruct.fontWeight,
+            fontStretch: sharedNodeStruct.fontStretch,
+            fontStyle: sharedNodeStruct.fontStyle,
+            contain: sharedNodeStruct.contain,
+            letterSpacing: sharedNodeStruct.letterSpacing,
+            offsetY: sharedNodeStruct.offsetY,
+            textAlign: sharedNodeStruct.textAlign,
+            scrollable: sharedNodeStruct.scrollable,
+            scrollY: sharedNodeStruct.scrollY,
+            debug: {},
+        }), {
+            text: sharedNodeStruct.text,
+            textRendererOverride: sharedNodeStruct.textRendererOverride,
+            fontSize: sharedNodeStruct.fontSize,
+            fontFamily: sharedNodeStruct.fontFamily,
+            fontWeight: sharedNodeStruct.fontWeight,
+            fontStretch: sharedNodeStruct.fontStretch,
+            fontStyle: sharedNodeStruct.fontStyle,
+            contain: sharedNodeStruct.contain,
+            letterSpacing: sharedNodeStruct.letterSpacing,
+            offsetY: sharedNodeStruct.offsetY,
+            textAlign: sharedNodeStruct.textAlign,
+            scrollable: sharedNodeStruct.scrollable,
+            scrollY: sharedNodeStruct.scrollY,
+        });
+        // Forward on CoreNode events
+        this.coreNode.on('textLoaded', (target, dimensions) => {
+            this.emit('textLoaded', dimensions);
+        });
+        this.coreNode.on('textFailed', (target, error) => {
+            this.emit('textFailed', error);
+        });
+        this.on('debug', (target, debug) => {
+            this.coreNode.debug = debug;
+        });
+    }
+}
+//# sourceMappingURL=ThreadXRendererTextNode.js.map

package/dist/src/render-drivers/threadx/worker/ThreadXRendererTextNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadXRendererTextNode.js","sourceRoot":"","sources":["../../../../../src/render-drivers/threadx/worker/ThreadXRendererTextNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAQ7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,OAAO,uBAAwB,SAAQ,mBAAmB;IAK9D,YAAY,KAAY,EAAE,gBAAgC;QACxD,KAAK,CACH,KAAK,EACL,gBAAgB,EAChB,IAAI,YAAY,CAAC,KAAK,EAAE;YACtB,EAAE,EAAE,gBAAgB,CAAC,EAAE;YACvB,iEAAiE;YACjE,kEAAkE;YAClE,mCAAmC;YACnC,CAAC,EAAE,gBAAgB,CAAC,CAAC;YACrB,CAAC,EAAE,gBAAgB,CAAC,CAAC;YACrB,KAAK,EAAE,gBAAgB,CAAC,KAAK;YAC7B,MAAM,EAAE,gBAAgB,CAAC,MAAM;YAC/B,KAAK,EAAE,gBAAgB,CAAC,KAAK;YAC7B,KAAK,EAAE,gBAAgB,CAAC,KAAK;YAC7B,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;YACnC,WAAW,EAAE,gBAAgB,CAAC,WAAW;YACzC,SAAS,EAAE,gBAAgB,CAAC,SAAS;YACrC,UAAU,EAAE,gBAAgB,CAAC,UAAU;YACvC,OAAO,EAAE,gBAAgB,CAAC,OAAO;YACjC,OAAO,EAAE,gBAAgB,CAAC,OAAO;YACjC,OAAO,EAAE,gBAAgB,CAAC,OAAO;YACjC,OAAO,EAAE,gBAAgB,CAAC,OAAO;YACjC,MAAM,EAAE,gBAAgB,CAAC,MAAM;YAC/B,YAAY,EAAE,gBAAgB,CAAC,YAAY;YAC3C,KAAK,EAAE,gBAAgB,CAAC,KAAK;YAC7B,MAAM,EAAE,gBAAgB,CAAC,MAAM;YAC/B,MAAM,EAAE,gBAAgB,CAAC,MAAM;YAC/B,KAAK,EAAE,gBAAgB,CAAC,KAAK;YAC7B,MAAM,EAAE,gBAAgB,CAAC,MAAM;YAC/B,MAAM,EAAE,gBAAgB,CAAC,MAAM;YAC/B,KAAK,EAAE,gBAAgB,CAAC,KAAK;YAC7B,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;YAEnC,2CAA2C;YAC3C,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE,IAAI;YACb,cAAc,EAAE,IAAI;YAEpB,yBAAyB;YACzB,MAAM,EAAE,IAAI;YAEZ,kBAAkB;YAClB,IAAI,EAAE,gBAAgB,CAAC,IAAI;YAC3B,oBAAoB,EAAE,gBAAgB,CAAC,oBAAoB;YAC3D,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;YACnC,UAAU,EAAE,gBAAgB,CAAC,UAAU;YACvC,UAAU,EAAE,gBAAgB,CAAC,UAAU;YACvC,WAAW,EAAE,gBAAgB,CAAC,WAAW;YACzC,SAAS,EAAE,gBAAgB,CAAC,SAAS;YACrC,OAAO,EAAE,gBAAgB,CAAC,OAAO;YACjC,aAAa,EAAE,gBAAgB,CAAC,aAAa;YAC7C,OAAO,EAAE,gBAAgB,CAAC,OAAO;YACjC,SAAS,EAAE,gBAAgB,CAAC,SAAS;YACrC,UAAU,EAAE,gBAAgB,CAAC,UAAU;YACvC,OAAO,EAAE,gBAAgB,CAAC,OAAO;YACjC,KAAK,EAAE,EAAE;SACV,CAAC,EACF;YACE,IAAI,EAAE,gBAAgB,CAAC,IAAI;YAC3B,oBAAoB,EAAE,gBAAgB,CAAC,oBAAoB;YAC3D,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;YACnC,UAAU,EAAE,gBAAgB,CAAC,UAAU;YACvC,UAAU,EAAE,gBAAgB,CAAC,UAAU;YACvC,WAAW,EAAE,gBAAgB,CAAC,WAAW;YACzC,SAAS,EAAE,gBAAgB,CAAC,SAAS;YACrC,OAAO,EAAE,gBAAgB,CAAC,OAAO;YACjC,aAAa,EAAE,gBAAgB,CAAC,aAAa;YAC7C,OAAO,EAAE,gBAAgB,CAAC,OAAO;YACjC,SAAS,EAAE,gBAAgB,CAAC,SAAS;YACrC,UAAU,EAAE,gBAAgB,CAAC,UAAU;YACvC,OAAO,EAAE,gBAAgB,CAAC,OAAO;SAIlC,CACF,CAAC;QACF,6BAA6B;QAC7B,IAAI,CAAC,QAAQ,CAAC,EAAE,CACd,YAAY,EACZ,CAAC,MAAoB,EAAE,UAAsB,EAAE,EAAE;YAC/C,IAAI,CAAC,IAAI,CACP,YAAY,EACZ,UAAgD,CACjD,CAAC;QACJ,CAAC,CACF,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAoB,EAAE,KAAY,EAAE,EAAE;YACpE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,KAA2C,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,MAA2B,EAAE,KAAuB,EAAE,EAAE;YACxE,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;CAeF"}

package/dist/src/render-drivers/threadx/worker/renderer.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/render-drivers/threadx/worker/renderer.js

@@ -0,0 +1,130 @@
+/*
+ * If not stated otherwise in this file or this component's LICENSE file the
+ * following copyright and licenses apply:
+ *
+ * Copyright 2023 Comcast
+ *
+ * Licensed under the Apache License, Version 2.0 (the License);
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { ThreadX, BufferStruct } from '@lightningjs/threadx';
+import { NodeStruct } from '../NodeStruct.js';
+import { ThreadXRendererNode } from './ThreadXRendererNode.js';
+import { Stage } from '../../../core/Stage.js';
+import { assertTruthy } from '../../../utils.js';
+import { isThreadXRendererMessage, } from '../ThreadXRendererMessage.js';
+import { TextNodeStruct } from '../TextNodeStruct.js';
+import { ThreadXRendererTextNode } from './ThreadXRendererTextNode.js';
+import { loadCoreExtension } from '../../utils.js';
+let canvas = null;
+let stage = null;
+let rootNode = null;
+const threadx = ThreadX.init({
+    workerId: 2,
+    workerName: 'renderer',
+    sharedObjectFactory(buffer) {
+        const typeId = BufferStruct.extractTypeId(buffer);
+        if (typeId === NodeStruct.typeId) {
+            const nodeStruct = new NodeStruct(buffer);
+            nodeStruct.parentId = nodeStruct.parentId || 0;
+            const node = nodeStruct.lock(() => {
+                assertTruthy(stage);
+                return new ThreadXRendererNode(stage, nodeStruct);
+            });
+            return node;
+        }
+        else if (typeId === TextNodeStruct.typeId) {
+            const nodeStruct = new TextNodeStruct(buffer);
+            nodeStruct.parentId = nodeStruct.parentId || 0;
+            const node = nodeStruct.lock(() => {
+                assertTruthy(stage);
+                return new ThreadXRendererTextNode(stage, nodeStruct);
+            });
+            return node;
+        }
+        return null;
+    },
+    async onMessage(message) {
+        if (isThreadXRendererMessage('init', message)) {
+            canvas = message.canvas;
+            const nodeStruct = new NodeStruct();
+            stage = new Stage({
+                rootId: nodeStruct.id,
+                appWidth: message.appWidth,
+                appHeight: message.appHeight,
+                deviceLogicalPixelRatio: message.deviceLogicalPixelRatio,
+                devicePhysicalPixelRatio: message.devicePhysicalPixelRatio,
+                clearColor: message.clearColor,
+                canvas,
+                debug: {
+                    monitorTextureCache: false,
+                },
+            });
+            const coreRootNode = stage.root;
+            // We must initialize the root NodeStruct with the same properties from
+            // the CoreNode that the Stage created.
+            Object.assign(nodeStruct, {
+                x: coreRootNode.x,
+                y: coreRootNode.y,
+                width: coreRootNode.width,
+                height: coreRootNode.height,
+                alpha: coreRootNode.alpha,
+                color: coreRootNode.color,
+                colorTop: coreRootNode.colorTop,
+                colorRight: coreRootNode.colorRight,
+                colorBottom: coreRootNode.colorBottom,
+                colorLeft: coreRootNode.colorLeft,
+                colorTl: coreRootNode.colorTl,
+                colorTr: coreRootNode.colorTr,
+                colorBr: coreRootNode.colorBr,
+                colorBl: coreRootNode.colorBl,
+                parentId: coreRootNode.parent?.id ?? 0,
+                zIndex: coreRootNode.zIndex,
+                zIndexLocked: coreRootNode.zIndexLocked,
+                scale: coreRootNode.scale,
+                mount: coreRootNode.mount,
+                mountX: coreRootNode.mountX,
+                mountY: coreRootNode.mountY,
+                pivot: coreRootNode.pivot,
+                pivotX: coreRootNode.pivotX,
+                pivotY: coreRootNode.pivotY,
+                rotation: coreRootNode.rotation,
+            });
+            // Share the root node that was created by the Stage with the main worker.
+            rootNode = new ThreadXRendererNode(stage, nodeStruct, coreRootNode);
+            await threadx.shareObjects('parent', [rootNode]);
+            // Load the Core Extension Module if one was specified.
+            if (message.coreExtensionModule) {
+                await loadCoreExtension(message.coreExtensionModule, stage);
+            }
+            // Return its ID so the main worker can retrieve it from the shared object
+            // store.
+            return rootNode.id;
+        }
+        else if (isThreadXRendererMessage('releaseTexture', message)) {
+            assertTruthy(stage);
+            const txManager = stage.txManager;
+            assertTruthy(txManager);
+            txManager.removeTextureIdFromCache(message.textureDescId);
+        }
+    },
+    onObjectShared(object) {
+        // TBD
+    },
+    onBeforeObjectForgotten(object) {
+        if (object instanceof ThreadXRendererNode) {
+            object.parent = null;
+            object.destroy();
+        }
+    },
+});
+//# sourceMappingURL=renderer.js.map

package/dist/src/render-drivers/threadx/worker/renderer.js.map

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

package/dist/src/render-drivers/utils.d.ts

@@ -0,0 +1,10 @@
+import { CoreExtension } from '../../exports/core-api.js';
+import type { Stage } from '../core/Stage.js';
+/**
+ * Type guard that checks if a Class extends CoreExtension.
+ *
+ * @param Class
+ * @returns
+ */
+export declare function classExtendsCoreExtension(Class: unknown): Class is new () => CoreExtension;
+export declare function loadCoreExtension(coreExtensionModule: string, stage: Stage): Promise<void>;

package/dist/src/render-drivers/utils.js

@@ -0,0 +1,41 @@
+import { CoreExtension } from '../../exports/core-api.js';
+/**
+ * Type guard that checks if a Class extends CoreExtension.
+ *
+ * @param Class
+ * @returns
+ */
+export function classExtendsCoreExtension(Class) {
+    return Class.prototype instanceof CoreExtension;
+}
+export async function loadCoreExtension(coreExtensionModule, stage) {
+    let module;
+    try {
+        console.log('Loading core extension', coreExtensionModule);
+        module = (await import(coreExtensionModule /* @vite-ignore */));
+    }
+    catch (e) {
+        console.error(`The core extension module at '${coreExtensionModule}' could not be loaded.`);
+        console.error(e);
+        return;
+    }
+    if (!module.default) {
+        console.error(`The core extension module at '${coreExtensionModule}' does not have a default export.`);
+        return;
+    }
+    const ExtensionClass = module.default;
+    if (classExtendsCoreExtension(ExtensionClass)) {
+        const coreExtension = new ExtensionClass();
+        try {
+            await coreExtension.run(stage);
+        }
+        catch (e) {
+            console.error(`The core extension at '${coreExtensionModule}' threw an error.`);
+            console.error(e);
+        }
+    }
+    else {
+        console.error(`The core extension at '${coreExtensionModule}' does not extend CoreExtension.`);
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/render-drivers/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/render-drivers/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG1D;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAc;IAEd,OAAQ,KAA8B,CAAC,SAAS,YAAY,aAAa,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,mBAA2B,EAC3B,KAAY;IAEZ,IAAI,MAEH,CAAC;IACF,IAAI;QACF,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,mBAAmB,CAAC,CAAC;QAC3D,MAAM,GAAG,CAAC,MAAM,MAAM,CACpB,mBAAmB,CAAC,kBAAkB,CACvC,CAAkB,CAAC;KACrB;IAAC,OAAO,CAAU,EAAE;QACnB,OAAO,CAAC,KAAK,CACX,iCAAiC,mBAAmB,wBAAwB,CAC7E,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjB,OAAO;KACR;IACD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;QACnB,OAAO,CAAC,KAAK,CACX,iCAAiC,mBAAmB,mCAAmC,CACxF,CAAC;QACF,OAAO;KACR;IACD,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC;IACtC,IAAI,yBAAyB,CAAC,cAAc,CAAC,EAAE;QAC7C,MAAM,aAAa,GAAG,IAAI,cAAc,EAAE,CAAC;QAC3C,IAAI;YACF,MAAM,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;SAChC;QAAC,OAAO,CAAU,EAAE;YACnB,OAAO,CAAC,KAAK,CACX,0BAA0B,mBAAmB,mBAAmB,CACjE,CAAC;YACF,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClB;KACF;SAAM;QACL,OAAO,CAAC,KAAK,CACX,0BAA0B,mBAAmB,kCAAkC,CAChF,CAAC;KACH;AACH,CAAC"}

package/dist/src/utils.d.ts

@@ -0,0 +1,79 @@
+export declare const boltProperties: string[];
+export declare const pipelineEvents: {
+    created: number;
+    updated: number;
+    deleted: number;
+    attached: number;
+    detached: number;
+    onscreen: number;
+    offscreen: number;
+    progress: number;
+    finished: number;
+};
+export declare function createWebGLContext(canvas: HTMLCanvasElement | OffscreenCanvas): WebGLRenderingContext | null;
+/**
+ * Asserts a condition is truthy, otherwise throws an error
+ *
+ * @remarks
+ * Useful at the top of functions to ensure certain conditions, arguments and
+ * properties are set/met before continuing. When using this function,
+ * TypeScript will narrow away falsy types from the condition.
+ *
+ * @param condition
+ * @param message
+ * @returns
+ */
+export declare function assertTruthy(condition: unknown, message?: string): asserts condition;
+/**
+ * Merges two colors based on a given progress value.
+ *
+ * This function takes two colors (c1 and c2) represented as 32-bit integers
+ * in RGBA format and blends them based on the provided progress value (p).
+ * The result is a new color that is a weighted combination of the input colors,
+ * where the weight is determined by the progress value.
+ *
+ * @param {number} c1 - The first color in RGBA format (32-bit integer).
+ * @param {number} c2 - The second color in RGBA format (32-bit integer).
+ * @param {number} p - The progress value between 0 and 1.
+ * @returns {number} The merged color as a 32-bit integer in RGBA format.
+ */
+export declare function mergeColorProgress(rgba1: number, rgba2: number, p: number): number;
+/**
+ * Given an RGBA encoded number, returns back the RGBA number with it's alpha
+ * component multiplied by the passed `alpha` parameter.
+ *
+ * @internalRemarks
+ * This method does NOT premultiply the alpha into the color channels. If that
+ * is required (for internal use only) use {@link mergeColorAlphaPremultiplied}
+ * instead.
+ *
+ * @param rgba RGBA encoded number
+ * @param alpha Normalized alpha value (Range: 0.0 - 1.0)
+ * @returns
+ */
+export declare function mergeColorAlpha(rgba: number, alpha: number): number;
+/**
+ * Given an RGBA encoded number, returns back the RGBA number with it's alpha
+ * component multiplied by the passed `alpha` parameter. Before returning, the
+ * final alpha value is multiplied into the color channels.
+ *
+ * @remarks
+ * If `flipEndianess` is set to true, the function will returned an ABGR encoded number
+ * which is useful when the color value needs to be passed into a shader attribute.
+ *
+ * NOTE: This method returns a PREMULTIPLIED alpha color which is generally only useful
+ * in the context of the internal rendering process. Use {@link mergeColorAlpha} if you
+ * need to blend an alpha value into a color in the context of the Renderer's
+ * public API.
+ *
+ * @internalRemarks
+ * Do not expose this method in the public API because Renderer users should instead use
+ * {@link mergeColorAlpha} to manipulate the alpha value of a color.
+ *
+ * @internal
+ * @param rgba RGBA encoded number
+ * @param alpha Normalized alpha value (Range: 0.0 - 1.0)
+ * @param flipEndianess Flip the endianess. RGBA becomes encoded as ABGR (for inserting colors into shader attributes)
+ * @returns
+ */
+export declare function mergeColorAlphaPremultiplied(rgba: number, alpha: number, flipEndianess?: boolean): number;