@flighthq/render 0.1.0

package/dist/renderQueue.js

@@ -0,0 +1,97 @@
+import { getNodeRuntime } from '@flighthq/node';
+import { getRenderStateRuntime } from './renderState';
+// Fills `out` by walking the prepared subtree rooted at `source` and pushing one entry per visible
+// proxy with a renderer. The sort key is the scene-order index (order of encounter in a pre-order
+// traversal), preserving scene-graph draw order when no reorder is needed. Call sortRenderQueue
+// afterward to reorder by an explicit criterion such as opaque-front-to-back / alpha-back-to-front.
+//
+// Does not advance the frame id — the prepare pass has already done that. Call
+// prepareDisplayObjectRender before buildRenderQueue.
+export function buildRenderQueue(state, source, out) {
+    clearRenderQueue(out);
+    const runtime = getRenderStateRuntime(state);
+    const renderProxyMap = runtime.renderProxyMap;
+    const stack = _buildStack;
+    let stackLength = 1;
+    stack[0] = source;
+    let sceneOrder = 0;
+    while (stackLength > 0) {
+        const current = stack[--stackLength];
+        const proxy = renderProxyMap.get(current);
+        if (proxy === undefined)
+            continue;
+        if (!proxy.visible)
+            continue;
+        if (proxy.renderer !== null) {
+            pushRenderQueueEntry(out, proxy, sceneOrder);
+        }
+        sceneOrder++;
+        // A Renderable is a node or a RenderCache leaf; only nodes carry children, and a cache yields a
+        // null-children runtime, so it is safe to read children through the node runtime view.
+        const children = getNodeRuntime(current).children;
+        if (children !== null) {
+            for (let i = children.length - 1; i >= 0; i--) {
+                stack[stackLength++] = children[i];
+            }
+        }
+    }
+}
+// Clears the queue for reuse. Resets entryCount to 0 without releasing the entries array, so
+// subsequent fills in the same frame reuse capacity without allocation.
+export function clearRenderQueue(queue) {
+    queue.entryCount = 0;
+}
+// Default sort comparator: ascending by sort key (smaller key = drawn first).
+export function compareRenderQueueEntries(a, b) {
+    return a.sortKey - b.sortKey;
+}
+// Creates a new empty RenderQueue. The entries array is pre-allocated empty; entries grow as
+// pushRenderQueueEntry or buildRenderQueue populates it. Cleared between frames by clearRenderQueue.
+export function createRenderQueue() {
+    return { entries: [], entryCount: 0 };
+}
+// Packs a layer index, a normalized depth (0..1), and an opaque flag into a single sort key
+// float. Layer is the most-significant axis; within a layer, opaque geometry sorts before
+// transparent (flag 0 < flag 1), and within that bucket depth is the tiebreaker.
+//
+// Layout (for integer arithmetic; packed into a number):
+//   bits [30..16]: layer  (15-bit, 0..32767)
+//   bit  [15]:     isTransparent flag (0 = opaque, 1 = transparent)
+//   bits [14..0]:  depth bucket (15-bit, 0..32767, derived from depth * 32767)
+export function packRenderSortKey(layer, depth, isTransparent) {
+    const layerBits = (Math.max(0, Math.min(32767, layer | 0)) & 0x7fff) << 16;
+    const transparentBit = isTransparent ? 1 << 15 : 0;
+    const depthBits = Math.max(0, Math.min(32767, Math.round(depth * 32767))) & 0x7fff;
+    return layerBits | transparentBit | depthBits;
+}
+// Appends one proxy entry to the queue at the current entryCount position, expanding the entries
+// array if needed. The sort key is set by the caller; call sortRenderQueue afterward for order.
+export function pushRenderQueueEntry(queue, proxy, sortKey) {
+    const entry = { proxy, sortKey };
+    if (queue.entryCount < queue.entries.length) {
+        queue.entries[queue.entryCount] = entry;
+    }
+    else {
+        queue.entries.push(entry);
+    }
+    queue.entryCount++;
+}
+// Sorts queue entries in-place using a comparator function. The default comparator sorts ascending
+// by sort key, which preserves scene-graph order when keys are the encounter index from
+// buildRenderQueue. Pass a custom comparator to implement opaque-front-to-back /
+// transparent-back-to-front partitioning using packRenderSortKey.
+export function sortRenderQueue(queue, compare) {
+    // Sort only the valid window [0..entryCount) of the entries array.
+    const slice = queue.entries.slice(0, queue.entryCount);
+    slice.sort(compare ?? compareRenderQueueEntriesByKey);
+    for (let i = 0; i < slice.length; i++) {
+        queue.entries[i] = slice[i];
+    }
+}
+function compareRenderQueueEntriesByKey(a, b) {
+    return a.sortKey - b.sortKey;
+}
+// Module-level scratch stack used by buildRenderQueue. Not shared with the per-state tempStack or
+// the drawDriver's _drawStack, so prepare, draw, and queue-build can be interleaved safely.
+const _buildStack = [];
+//# sourceMappingURL=renderQueue.js.map

package/dist/renderQueue.js.map

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

package/dist/renderState.d.ts

@@ -0,0 +1,5 @@
+import type { RenderState, RenderStateRuntime } from '@flighthq/types';
+export declare function createRenderState(obj?: Partial<RenderState>): RenderState;
+export declare function createRenderStateRuntime(): RenderStateRuntime;
+export declare function getRenderStateRuntime(state: RenderState): RenderStateRuntime;
+//# sourceMappingURL=renderState.d.ts.map

package/dist/renderState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderState.d.ts","sourceRoot":"","sources":["../src/renderState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGvE,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAiBzE;AAOD,wBAAgB,wBAAwB,IAAI,kBAAkB,CAU7D;AAID,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,kBAAkB,CAE5E"}

package/dist/renderState.js

@@ -0,0 +1,42 @@
+import { createEntity, createEntityRuntime } from '@flighthq/entity';
+import { BlendMode, EntityRuntimeKey } from '@flighthq/types';
+export function createRenderState(obj) {
+    const state = createEntity({
+        allowSmoothing: obj?.allowSmoothing ?? true,
+        backgroundColor: obj?.backgroundColor ?? 0,
+        backgroundColorRgba: obj?.backgroundColorRgba ?? [],
+        backgroundColorString: obj?.backgroundColorString ?? '',
+        currentClipDepth: obj?.currentClipDepth ?? 0,
+        displayObjectClipHooks: obj?.displayObjectClipHooks ?? null,
+        pixelRatio: obj?.pixelRatio ?? 1,
+        renderAlpha: obj?.renderAlpha ?? 1,
+        renderBlendMode: obj?.renderBlendMode ?? BlendMode.Normal,
+        renderTransform2D: obj?.renderTransform2D ?? null,
+        roundPixels: obj?.roundPixels ?? false,
+        sceneGraphSyncPolicy: obj?.sceneGraphSyncPolicy ?? 'refreshDerivedState',
+    });
+    state[EntityRuntimeKey] = createRenderStateRuntime();
+    return state;
+}
+// Allocates the package-private machinery runtime for a RenderState: the frame counter, proxy maps,
+// and renderer registry shared across every backend. createRenderState attaches one under
+// EntityRuntimeKey; getRenderStateRuntime reads it back. Backend factories build their fuller runtime
+// on top of this. The render path writes the returned object every frame, so the return is
+// intentionally mutable (not Readonly).
+export function createRenderStateRuntime() {
+    const runtime = createEntityRuntime();
+    runtime.currentFrameId = 0;
+    runtime.renderAdaptHook = null;
+    runtime.renderProxyAdapterMap = new WeakMap();
+    runtime.renderProxyMap = new WeakMap();
+    runtime.rendererMap = new Map();
+    runtime.rendererMapId = 0;
+    runtime.tempStack = [];
+    return runtime;
+}
+// Resolves the package-private machinery runtime attached to a RenderState. Mutable by design: the
+// render path writes its fields every frame.
+export function getRenderStateRuntime(state) {
+    return state[EntityRuntimeKey];
+}
+//# sourceMappingURL=renderState.js.map

package/dist/renderState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderState.js","sourceRoot":"","sources":["../src/renderState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,UAAU,iBAAiB,CAAC,GAA0B;IAC1D,MAAM,KAAK,GAAG,YAAY,CAAC;QACzB,cAAc,EAAE,GAAG,EAAE,cAAc,IAAI,IAAI;QAC3C,eAAe,EAAE,GAAG,EAAE,eAAe,IAAI,CAAC;QAC1C,mBAAmB,EAAE,GAAG,EAAE,mBAAmB,IAAI,EAAE;QACnD,qBAAqB,EAAE,GAAG,EAAE,qBAAqB,IAAI,EAAE;QACvD,gBAAgB,EAAE,GAAG,EAAE,gBAAgB,IAAI,CAAC;QAC5C,sBAAsB,EAAE,GAAG,EAAE,sBAAsB,IAAI,IAAI;QAC3D,UAAU,EAAE,GAAG,EAAE,UAAU,IAAI,CAAC;QAChC,WAAW,EAAE,GAAG,EAAE,WAAW,IAAI,CAAC;QAClC,eAAe,EAAE,GAAG,EAAE,eAAe,IAAI,SAAS,CAAC,MAAM;QACzD,iBAAiB,EAAE,GAAG,EAAE,iBAAiB,IAAI,IAAI;QACjD,WAAW,EAAE,GAAG,EAAE,WAAW,IAAI,KAAK;QACtC,oBAAoB,EAAE,GAAG,EAAE,oBAAoB,IAAI,qBAAqB;KACzE,CAAgB,CAAC;IAClB,KAAK,CAAC,gBAAgB,CAAC,GAAG,wBAAwB,EAAE,CAAC;IACrD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,oGAAoG;AACpG,0FAA0F;AAC1F,sGAAsG;AACtG,2FAA2F;AAC3F,wCAAwC;AACxC,MAAM,UAAU,wBAAwB;IACtC,MAAM,OAAO,GAAG,mBAAmB,EAAwB,CAAC;IAC5D,OAAO,CAAC,cAAc,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,qBAAqB,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9C,OAAO,CAAC,cAAc,GAAG,IAAI,OAAO,EAAE,CAAC;IACvC,OAAO,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;IAChC,OAAO,CAAC,aAAa,GAAG,CAAC,CAAC;IAC1B,OAAO,CAAC,SAAS,GAAG,EAAE,CAAC;IACvB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,mGAAmG;AACnG,6CAA6C;AAC7C,MAAM,UAAU,qBAAqB,CAAC,KAAkB;IACtD,OAAO,KAAK,CAAC,gBAAgB,CAAuB,CAAC;AACvD,CAAC"}

package/dist/renderTarget.d.ts

@@ -0,0 +1,21 @@
+import type { DisplayObject, MatrixLike, RectangleLike } from '@flighthq/types';
+export type RenderTargetSizeOptions = {
+    minWidth?: number;
+    minHeight?: number;
+};
+/**
+ * Writes into outRenderTransform the transform to set as state.renderTransform2D when
+ * capturing source into a render target. Maps source content into target pixel space so
+ * that the bounds origin lands at (contentX, contentY).
+ */
+export declare function computeDisplayObjectRenderTargetTransform(outRenderTransform: MatrixLike, source: DisplayObject, bounds: Readonly<RectangleLike>, contentX?: number, contentY?: number): void;
+/**
+ * Writes into outCacheTransform the transform to pass to the cache resolver so the
+ * cached image is placed back at the original scene position.
+ */
+export declare function computeRenderCacheTransform(outCacheTransform: MatrixLike, bounds: Readonly<RectangleLike>, contentX?: number, contentY?: number): void;
+export declare function computeRenderTargetSize(bounds: Readonly<RectangleLike>, padding?: number, minWidth?: number, minHeight?: number): {
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=renderTarget.d.ts.map

package/dist/renderTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderTarget.d.ts","sourceRoot":"","sources":["../src/renderTarget.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,yCAAyC,CACvD,kBAAkB,EAAE,UAAU,EAC9B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,QAAQ,GAAE,MAAU,EACpB,QAAQ,GAAE,MAAU,GACnB,IAAI,CAUN;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,iBAAiB,EAAE,UAAU,EAC7B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,QAAQ,GAAE,MAAU,EACpB,QAAQ,GAAE,MAAU,GACnB,IAAI,CAON;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,OAAO,GAAE,MAAU,EACnB,QAAQ,GAAE,MAAU,EACpB,SAAS,GAAE,MAAU,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAKnC"}

package/dist/renderTarget.js

@@ -0,0 +1,39 @@
+import { createMatrix, inverseMatrix, multiplyMatrix } from '@flighthq/geometry';
+import { getNodeLocalTransformMatrix } from '@flighthq/node';
+/**
+ * Writes into outRenderTransform the transform to set as state.renderTransform2D when
+ * capturing source into a render target. Maps source content into target pixel space so
+ * that the bounds origin lands at (contentX, contentY).
+ */
+export function computeDisplayObjectRenderTargetTransform(outRenderTransform, source, bounds, contentX = 0, contentY = 0) {
+    const localTransform = getNodeLocalTransformMatrix(source);
+    inverseMatrix(_tempInvLocal, localTransform);
+    _tempTranslation.a = 1;
+    _tempTranslation.b = 0;
+    _tempTranslation.c = 0;
+    _tempTranslation.d = 1;
+    _tempTranslation.tx = contentX - bounds.x;
+    _tempTranslation.ty = contentY - bounds.y;
+    multiplyMatrix(outRenderTransform, _tempTranslation, _tempInvLocal);
+}
+/**
+ * Writes into outCacheTransform the transform to pass to the cache resolver so the
+ * cached image is placed back at the original scene position.
+ */
+export function computeRenderCacheTransform(outCacheTransform, bounds, contentX = 0, contentY = 0) {
+    outCacheTransform.a = 1;
+    outCacheTransform.b = 0;
+    outCacheTransform.c = 0;
+    outCacheTransform.d = 1;
+    outCacheTransform.tx = bounds.x - contentX;
+    outCacheTransform.ty = bounds.y - contentY;
+}
+export function computeRenderTargetSize(bounds, padding = 0, minWidth = 1, minHeight = 1) {
+    return {
+        width: Math.max(minWidth, Math.ceil(bounds.width) + padding * 2),
+        height: Math.max(minHeight, Math.ceil(bounds.height) + padding * 2),
+    };
+}
+const _tempInvLocal = createMatrix();
+const _tempTranslation = createMatrix();
+//# sourceMappingURL=renderTarget.js.map

package/dist/renderTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderTarget.js","sourceRoot":"","sources":["../src/renderTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAQ7D;;;;GAIG;AACH,MAAM,UAAU,yCAAyC,CACvD,kBAA8B,EAC9B,MAAqB,EACrB,MAA+B,EAC/B,WAAmB,CAAC,EACpB,WAAmB,CAAC;IAEpB,MAAM,cAAc,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC3D,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAC7C,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC;IACvB,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC;IACvB,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC;IACvB,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC;IACvB,gBAAgB,CAAC,EAAE,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC;IAC1C,gBAAgB,CAAC,EAAE,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC;IAC1C,cAAc,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,iBAA6B,EAC7B,MAA+B,EAC/B,WAAmB,CAAC,EACpB,WAAmB,CAAC;IAEpB,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC;IACxB,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC;IACxB,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC;IACxB,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC;IACxB,iBAAiB,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC;IAC3C,iBAAiB,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,MAA+B,EAC/B,UAAkB,CAAC,EACnB,WAAmB,CAAC,EACpB,YAAoB,CAAC;IAErB,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;QAChE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,MAAM,aAAa,GAAG,YAAY,EAAE,CAAC;AACrC,MAAM,gBAAgB,GAAG,YAAY,EAAE,CAAC"}

package/dist/renderTransform2d.d.ts

@@ -0,0 +1,3 @@
+import type { RenderProxy2D, RenderState } from '@flighthq/types';
+export declare function updateRenderProxy2DTransform(state: RenderState, data: RenderProxy2D, parentData?: RenderProxy2D): boolean;
+//# sourceMappingURL=renderTransform2d.d.ts.map

package/dist/renderTransform2d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderTransform2d.d.ts","sourceRoot":"","sources":["../src/renderTransform2d.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAwB,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAIxF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,aAAa,EACnB,UAAU,CAAC,EAAE,aAAa,GACzB,OAAO,CAYT"}

package/dist/renderTransform2d.js

@@ -0,0 +1,26 @@
+import { copyMatrix, multiplyMatrix } from '@flighthq/geometry';
+import { getNodeLocalTransformMatrix, getNodeLocalTransformRevision } from '@flighthq/node';
+import { getRenderStateRuntime } from './renderState';
+export function updateRenderProxy2DTransform(state, data, parentData) {
+    const localTransformId = getNodeLocalTransformRevision(data.source);
+    const parentDirty = parentData !== undefined && parentData.transformFrameId === getRenderStateRuntime(state).currentFrameId;
+    const localDirty = data.lastLocalTransformId !== localTransformId;
+    if (parentDirty || localDirty) {
+        recalculateRenderTransform2D(state, data, parentData);
+        data.lastLocalTransformId = localTransformId;
+        return true;
+    }
+    return false;
+}
+function recalculateRenderTransform2D(state, data, parentData) {
+    const transform2D = getNodeLocalTransformMatrix(data.source);
+    const parentTransform2D = parentData !== undefined ? parentData.transform2D : state.renderTransform2D;
+    if (parentTransform2D !== null) {
+        multiplyMatrix(data.transform2D, parentTransform2D, transform2D);
+    }
+    else {
+        copyMatrix(data.transform2D, transform2D);
+    }
+    data.transformFrameId = getRenderStateRuntime(state).currentFrameId;
+}
+//# sourceMappingURL=renderTransform2d.js.map

package/dist/renderTransform2d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderTransform2d.js","sourceRoot":"","sources":["../src/renderTransform2d.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAG5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,UAAU,4BAA4B,CAC1C,KAAkB,EAClB,IAAmB,EACnB,UAA0B;IAE1B,MAAM,gBAAgB,GAAG,6BAA6B,CAAC,IAAI,CAAC,MAAc,CAAC,CAAC;IAC5E,MAAM,WAAW,GACf,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,gBAAgB,KAAK,qBAAqB,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC;IAC1G,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,KAAK,gBAAgB,CAAC;IAElE,IAAI,WAAW,IAAI,UAAU,EAAE,CAAC;QAC9B,4BAA4B,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,oBAAoB,GAAG,gBAAgB,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,4BAA4B,CAAC,KAAkB,EAAE,IAAmB,EAAE,UAA0B;IACvG,MAAM,WAAW,GAAG,2BAA2B,CAAC,IAAI,CAAC,MAA+B,CAAC,CAAC;IACtF,MAAM,iBAAiB,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACtG,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;QAC/B,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,EAAE,WAAW,CAAC,CAAC;IACnE,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,CAAC,gBAAgB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC;AACtE,CAAC"}

package/dist/renderViewport.d.ts

@@ -0,0 +1,6 @@
+import type { Matrix, Rectangle, RenderProxy2D, RenderViewport2D } from '@flighthq/types';
+export declare function computeRenderProxyWorldBounds(out: Pick<Rectangle, 'x' | 'y' | 'width' | 'height'>, source: unknown): boolean;
+export declare function createRenderViewport2D(x: number, y: number, width: number, height: number): RenderViewport2D;
+export declare function isRenderableInViewport(source: unknown, viewport: Readonly<RenderViewport2D>, renderTransform2D?: Readonly<Matrix> | null): boolean;
+export declare function isRenderProxyInViewport(proxy: Readonly<RenderProxy2D>, viewport: Readonly<RenderViewport2D>, renderTransform2D?: Readonly<Matrix> | null): boolean;
+//# sourceMappingURL=renderViewport.d.ts.map

package/dist/renderViewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderViewport.d.ts","sourceRoot":"","sources":["../src/renderViewport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAiB,MAAM,iBAAiB,CAAC;AAKzG,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,GAAG,GAAG,GAAG,OAAO,GAAG,QAAQ,CAAC,EACpD,MAAM,EAAE,OAAO,GACd,OAAO,CAQT;AAGD,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAE5G;AAOD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EACpC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,GAC1C,OAAO,CAoBT;AAID,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC9B,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EACpC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,GAC1C,OAAO,CAET"}

package/dist/renderViewport.js

@@ -0,0 +1,57 @@
+import { createRectangle, matrixTransformRectangle } from '@flighthq/geometry';
+import { getNodeWorldBoundsRectangle } from '@flighthq/node';
+// Writes the world-space axis-aligned bounding box of `source` into `out`. Returns true when
+// `source` is a Spatial2DNode and the bounds were written; returns false and leaves `out`
+// unchanged when the source has no spatial traits.
+export function computeRenderProxyWorldBounds(out, source) {
+    if (!isSpatial2DNode(source))
+        return false;
+    const worldBounds = getNodeWorldBoundsRectangle(source);
+    out.x = worldBounds.x;
+    out.y = worldBounds.y;
+    out.width = worldBounds.width;
+    out.height = worldBounds.height;
+    return true;
+}
+// Allocates and returns a new RenderViewport2D with the given screen-space region.
+export function createRenderViewport2D(x, y, width, height) {
+    return { height, width, x, y };
+}
+// Returns true when `source` may be visible within `viewport`. Conservative: returns true when
+// the source carries no spatial traits (bounds unknown). When spatial bounds are available, uses
+// an inclusive overlap test on all four edges so that a zero-size object touching any viewport
+// edge is considered in-viewport. When `renderTransform2D` is provided, the world bounds are
+// transformed into screen space before the overlap test.
+export function isRenderableInViewport(source, viewport, renderTransform2D) {
+    if (!computeRenderProxyWorldBounds(_scratchBounds, source))
+        return true;
+    let bounds = _scratchBounds;
+    if (renderTransform2D != null) {
+        matrixTransformRectangle(_scratchTransformed, renderTransform2D, _scratchBounds);
+        bounds = _scratchTransformed;
+    }
+    const objMinX = bounds.x;
+    const objMinY = bounds.y;
+    const objMaxX = bounds.x + bounds.width;
+    const objMaxY = bounds.y + bounds.height;
+    const vpMinX = viewport.x;
+    const vpMinY = viewport.y;
+    const vpMaxX = viewport.x + viewport.width;
+    const vpMaxY = viewport.y + viewport.height;
+    return !(objMaxX < vpMinX || objMinX > vpMaxX || objMaxY < vpMinY || objMinY > vpMaxY);
+}
+// Returns true when the render proxy's source may be visible within `viewport`. Delegates to
+// isRenderableInViewport using the proxy's source.
+export function isRenderProxyInViewport(proxy, viewport, renderTransform2D) {
+    return isRenderableInViewport(proxy.source, viewport, renderTransform2D);
+}
+// Detects whether `source` carries the HasTransform2D trait (and thus is at least a Transform2DNode).
+// Nodes that pass through createRenderProxy2D carry both HasTransform2D and HasBoundsRectangle,
+// making them Spatial2DNode — the bounds runtime is guaranteed present.
+function isSpatial2DNode(source) {
+    return source !== null && typeof source === 'object' && 'pivotX' in source;
+}
+// Module-level scratch rectangles used by isRenderableInViewport to avoid allocation on every call.
+const _scratchBounds = createRectangle();
+const _scratchTransformed = createRectangle();
+//# sourceMappingURL=renderViewport.js.map

package/dist/renderViewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderViewport.js","sourceRoot":"","sources":["../src/renderViewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAG7D,6FAA6F;AAC7F,0FAA0F;AAC1F,mDAAmD;AACnD,MAAM,UAAU,6BAA6B,CAC3C,GAAoD,EACpD,MAAe;IAEf,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,WAAW,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACxD,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;IACtB,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;IACtB,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;IAC9B,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,sBAAsB,CAAC,CAAS,EAAE,CAAS,EAAE,KAAa,EAAE,MAAc;IACxF,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AACjC,CAAC;AAED,+FAA+F;AAC/F,iGAAiG;AACjG,+FAA+F;AAC/F,6FAA6F;AAC7F,yDAAyD;AACzD,MAAM,UAAU,sBAAsB,CACpC,MAAe,EACf,QAAoC,EACpC,iBAA2C;IAE3C,IAAI,CAAC,6BAA6B,CAAC,cAAc,EAAE,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAExE,IAAI,MAAM,GAAG,cAAc,CAAC;IAC5B,IAAI,iBAAiB,IAAI,IAAI,EAAE,CAAC;QAC9B,wBAAwB,CAAC,mBAAmB,EAAE,iBAAiB,EAAE,cAAc,CAAC,CAAC;QACjF,MAAM,GAAG,mBAAmB,CAAC;IAC/B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;IACzB,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;IACzB,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IAEzC,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC;IAE5C,OAAO,CAAC,CAAC,OAAO,GAAG,MAAM,IAAI,OAAO,GAAG,MAAM,IAAI,OAAO,GAAG,MAAM,IAAI,OAAO,GAAG,MAAM,CAAC,CAAC;AACzF,CAAC;AAED,6FAA6F;AAC7F,mDAAmD;AACnD,MAAM,UAAU,uBAAuB,CACrC,KAA8B,EAC9B,QAAoC,EACpC,iBAA2C;IAE3C,OAAO,sBAAsB,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAC3E,CAAC;AAED,sGAAsG;AACtG,gGAAgG;AAChG,wEAAwE;AACxE,SAAS,eAAe,CAAC,MAAe;IACtC,OAAO,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,QAAQ,IAAK,MAAiB,CAAC;AACzF,CAAC;AAED,oGAAoG;AACpG,MAAM,cAAc,GAAG,eAAe,EAAE,CAAC;AACzC,MAAM,mBAAmB,GAAG,eAAe,EAAE,CAAC"}

package/dist/renderer.d.ts

@@ -0,0 +1,6 @@
+import type { Kind, Renderable, Renderer, RendererData, RenderState } from '@flighthq/types';
+export declare function copyAllRenderersFromRenderState(target: RenderState, source: RenderState): void;
+export declare function copyRenderersFromRenderState(target: RenderState, source: RenderState): void;
+export declare function noopRendererData(_state: RenderState, _source: Renderable): RendererData | null;
+export declare function registerRenderer(state: RenderState, kind: Kind, renderer: Renderer): void;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAM7F,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAG9F;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAI3F;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,GAAG,YAAY,GAAG,IAAI,CAE9F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAKzF"}

package/dist/renderer.js

@@ -0,0 +1,24 @@
+import { getRenderStateRuntime } from './renderState';
+// Mask renderers were retired (a mask is now a path ClipRegion realized by the backend clip hooks), so
+// there is no mask-renderer registry to copy — only the kind→renderer map and the clip hooks.
+export function copyAllRenderersFromRenderState(target, source) {
+    copyRenderersFromRenderState(target, source);
+    if (source.displayObjectClipHooks !== null)
+        target.displayObjectClipHooks = source.displayObjectClipHooks;
+}
+export function copyRenderersFromRenderState(target, source) {
+    getRenderStateRuntime(source).rendererMap.forEach((renderer, kind) => {
+        registerRenderer(target, kind, renderer);
+    });
+}
+export function noopRendererData(_state, _source) {
+    return null;
+}
+export function registerRenderer(state, kind, renderer) {
+    const runtime = getRenderStateRuntime(state);
+    if (runtime.rendererMap.get(kind) === renderer)
+        return;
+    runtime.rendererMapId = (runtime.rendererMapId + 1) >>> 0;
+    runtime.rendererMap.set(kind, renderer);
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,uGAAuG;AACvG,8FAA8F;AAC9F,MAAM,UAAU,+BAA+B,CAAC,MAAmB,EAAE,MAAmB;IACtF,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,sBAAsB,KAAK,IAAI;QAAE,MAAM,CAAC,sBAAsB,GAAG,MAAM,CAAC,sBAAsB,CAAC;AAC5G,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAmB,EAAE,MAAmB;IACnF,qBAAqB,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE;QACnE,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAmB,EAAE,OAAmB;IACvE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAkB,EAAE,IAAU,EAAE,QAAkB;IACjF,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO;IACvD,OAAO,CAAC,aAAa,GAAG,CAAC,OAAO,CAAC,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1D,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC"}

package/dist/sceneRender.d.ts

@@ -0,0 +1,4 @@
+import type { Camera, RenderState, SceneLightBlock, SceneLights, SceneNode, SceneRenderList } from '@flighthq/types';
+export declare function packSceneLightBlock(out: SceneLightBlock, lights: Readonly<SceneLights>): void;
+export declare function prepareSceneRender(state: RenderState, scene: Readonly<SceneNode>, camera: Readonly<Camera>, lights: Readonly<SceneLights>): SceneRenderList;
+//# sourceMappingURL=sceneRender.d.ts.map

package/dist/sceneRender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneRender.d.ts","sourceRoot":"","sources":["../src/sceneRender.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAGV,MAAM,EAMN,WAAW,EACX,eAAe,EACf,WAAW,EACX,SAAS,EACT,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAazB,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CA6B7F;AAcD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC1B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,eAAe,CAiBjB"}

package/dist/sceneRender.js

@@ -0,0 +1,175 @@
+import { createAabb, createFrustum, createMatrix4, isFrustumIntersectingAabb, multiplyMatrix4, setFrustumFromMatrix4, setOrthographicMatrix4, setPerspectiveMatrix4, transformAabbByMatrix4, } from '@flighthq/geometry';
+import { unpackColorToLinear } from '@flighthq/materials';
+import { getNodeRuntime, getNodeWorldTransformMatrix4 } from '@flighthq/node';
+// Packs the directional + ambient draw-arg lights into `out` (the GPU-ready light block), converting
+// each packed sRgb color to linear, premultiplied radiance (unpackColorToLinear(color) * intensity)
+// so the shader never sees sRgb. Sets the presence counts (0 or 1 each). The float layout matches the
+// shader's std140 light block: directional { direction.xyz, _pad, radiance.rgb, _pad } then ambient
+// { radiance.rgb, _pad }. An absent term leaves its slots zeroed.
+//
+// `version` bumps only when the packed data or counts actually change from the previous pack — a
+// no-op re-pack of identical lights leaves it untouched. This is the SceneLightBlock contract a
+// backend keyed off `version` relies on to skip re-uploading an unchanged block across frames; a
+// blind per-frame bump would defeat that skip. Packs into a scratch, compares, then commits only on
+// change so an unchanged block is never dirtied.
+export function packSceneLightBlock(out, lights) {
+    scratchLightData.fill(0);
+    let directionalCount = 0;
+    const directional = lights.directional;
+    if (directional !== null) {
+        packDirectionalLight(scratchLightData, directional);
+        directionalCount = 1;
+    }
+    let ambientCount = 0;
+    const ambient = lights.ambient;
+    if (ambient !== null) {
+        packAmbientLight(scratchLightData, ambient);
+        ambientCount = 1;
+    }
+    if (out.directionalCount === directionalCount &&
+        out.ambientCount === ambientCount &&
+        isFloat32ArrayEqual(out.data, scratchLightData)) {
+        return;
+    }
+    out.data.set(scratchLightData);
+    out.directionalCount = directionalCount;
+    out.ambientCount = ambientCount;
+    out.version++;
+}
+// The per-frame preparation pass for a 3D scene, the 3D analog of prepareDisplayObjectRender. It is
+// backend-agnostic (no GPU context): it walks the SceneNode hierarchy rooted at `scene`, propagating
+// each node's worldMatrix (parentWorld x localMatrix, resolved lazily on the node runtime and
+// alias-safe), computes the draw camera's view-projection, frustum-culls every Mesh against its
+// world-space bounds, and packs `lights` into the shared SceneLightBlock (sRgb->linear at pack time).
+// The returned SceneRenderList is the render-ready frame the backend drawScene consumes — it only
+// has to upload buffers, bind, and draw the visible meshes.
+//
+// `aspect` for a perspective camera is taken from the render state's pixel-space target (width /
+// height); a degenerate target falls back to 1. The returned list is reused scratch owned per render
+// state (so a gl state and a wgpu state prepare independently); a caller must not retain it past the
+// drawScene it feeds.
+export function prepareSceneRender(state, scene, camera, lights) {
+    const prepared = ensurePreparedScene(state);
+    const list = prepared.list;
+    // RenderState carries no canonical viewport size, so a perspective camera supplies its own aspect
+    // through its projection; this neutral fallback keeps an orthographic frame and a pre-aspected
+    // perspective frame correct. A backend that owns a sized target sets the projection aspect first.
+    setSceneViewProjectionMatrix4(prepared.viewProjection, camera, DEFAULT_VIEWPORT_ASPECT);
+    setFrustumFromMatrix4(prepared.frustum, prepared.viewProjection);
+    packSceneLightBlock(list.lights, lights);
+    prepared.meshes.length = 0;
+    collectVisibleMeshes(scene, prepared.frustum, prepared.worldBounds, prepared.meshes);
+    list.meshCount = prepared.meshes.length;
+    return list;
+}
+function collectVisibleMeshes(node, frustum, worldBounds, out) {
+    if (!node.enabled) {
+        return;
+    }
+    // A node is a drawable Mesh (not a transform-only group) when it carries geometry. Structural,
+    // so it holds for Meshes created with a custom kind, not just MeshKind.
+    const mesh = node;
+    if (mesh.geometry != null && isMeshVisible(mesh, frustum, worldBounds)) {
+        out.push(mesh);
+    }
+    const children = getNodeRuntime(node).children;
+    if (children !== null) {
+        for (let i = 0; i < children.length; i++) {
+            collectVisibleMeshes(children[i], frustum, worldBounds, out);
+        }
+    }
+}
+function ensurePreparedScene(state) {
+    let prepared = preparedScenes.get(state);
+    if (prepared === undefined) {
+        const viewProjection = createMatrix4();
+        const meshes = [];
+        const list = {
+            lights: {
+                ambientCount: 0,
+                data: new Float32Array(LIGHT_BLOCK_FLOATS),
+                directionalCount: 0,
+                hemisphereCount: 0,
+                pointCount: 0,
+                spotCount: 0,
+                version: 0,
+            },
+            meshCount: 0,
+            viewProjection: viewProjection,
+            visibleMeshes: meshes,
+        };
+        prepared = {
+            frustum: createFrustum(),
+            list: list,
+            meshes: meshes,
+            viewProjection: viewProjection,
+            worldBounds: createAabb(),
+        };
+        preparedScenes.set(state, prepared);
+    }
+    return prepared;
+}
+function isFloat32ArrayEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+function isMeshVisible(mesh, frustum, worldBounds) {
+    const bounds = mesh.geometry.bounds;
+    if (bounds === null) {
+        // No cached local bounds: cannot cull, so conservatively keep the mesh.
+        return true;
+    }
+    transformAabbByMatrix4(worldBounds, bounds, getNodeWorldTransformMatrix4(mesh));
+    return isFrustumIntersectingAabb(frustum, worldBounds);
+}
+function packAmbientLight(data, ambient) {
+    unpackColorToLinear(scratchColor, ambient.color);
+    const intensity = ambient.intensity;
+    data[8] = scratchColor[0] * intensity;
+    data[9] = scratchColor[1] * intensity;
+    data[10] = scratchColor[2] * intensity;
+}
+function packDirectionalLight(data, directional) {
+    data[0] = directional.direction.x;
+    data[1] = directional.direction.y;
+    data[2] = directional.direction.z;
+    unpackColorToLinear(scratchColor, directional.color);
+    const intensity = directional.intensity;
+    data[4] = scratchColor[0] * intensity;
+    data[5] = scratchColor[1] * intensity;
+    data[6] = scratchColor[2] * intensity;
+}
+// Composes the camera's view-projection (projection x view) into `out`. For a perspective camera the
+// projection's own aspect is used when set (non-zero), else the render state's `aspect` fallback;
+// near/far come from the camera. Reads camera fields through a scratch projection before the multiply,
+// so it is safe even if `out` aliases the camera's view.
+function setSceneViewProjectionMatrix4(out, camera, aspect) {
+    const projection = camera.projection;
+    if (projection.kind === 'perspective') {
+        // Geometry's setPerspectiveMatrix4 takes the tangent of the half-FOV, not the full angle.
+        setPerspectiveMatrix4(scratchProjection, Math.tan(projection.fovY * 0.5), projection.aspect !== 0 ? projection.aspect : aspect, camera.near, camera.far);
+    }
+    else {
+        setOrthographicMatrix4(scratchProjection, -projection.halfWidth, projection.halfWidth, -projection.halfHeight, projection.halfHeight, camera.near, camera.far);
+    }
+    multiplyMatrix4(out, scratchProjection, camera.view);
+}
+// Neutral viewport aspect used when a perspective camera does not carry its own.
+const DEFAULT_VIEWPORT_ASPECT = 1;
+// One directional ({ direction.xyz, _pad, radiance.rgb, _pad }) + one ambient ({ radiance.rgb,
+// _pad }) = 12 floats, std140-aligned (vec4 boundaries).
+const LIGHT_BLOCK_FLOATS = 12;
+// Per-render-state prepared frames. Keyed by state so independent backends prepare without sharing
+// scratch; a state's entry is freed when the state is GC'd.
+const preparedScenes = new WeakMap();
+const scratchColor = [0, 0, 0, 0];
+const scratchProjection = createMatrix4();
+// Reused staging buffer for packSceneLightBlock's pack-then-compare: the new block is packed here and
+// committed to `out.data` only when it differs, so an unchanged block never bumps `version`.
+const scratchLightData = new Float32Array(LIGHT_BLOCK_FLOATS);
+//# sourceMappingURL=sceneRender.js.map

package/dist/sceneRender.js.map

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