@flighthq/render 0.3.0-next.906.07cea63 → 0.3.1-next.1041.35b950c

package/dist/contract.d.ts

@@ -1,17 +1,22 @@
+export * from './enableSceneRenderGuards';
 export * from './enableColorAdjustmentGuards';
+export * from './enableColorAdjustments';
 export * from './explainScene2DRender';
 export * from './renderAppearance';
 export * from './renderCache';
 export * from './renderColor';
-export * from './renderColorScaleBias';
 export * from './renderer';
 export * from './renderMaterial';
 export * from './renderProxy';
 export * from './renderProxyAdapter';
 export * from './renderQueue';
+export * from './explainScene2DCoverage';
+export * from './renderRegistryGuards';
+export * from './renderRegistrySignals';
 export * from './renderState';
 export * from './renderTarget';
 export * from './renderTransform2d';
 export * from './renderViewport';
 export * from './sceneRender';
+export { SCENE2D_WORKING_COLOR_SPACE } from './scene2dWorkingColorSpace';
 //# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/contract.js

@@ -1,17 +1,22 @@
+export * from './enableSceneRenderGuards';
 export * from './enableColorAdjustmentGuards';
+export * from './enableColorAdjustments';
 export * from './explainScene2DRender';
 export * from './renderAppearance';
 export * from './renderCache';
 export * from './renderColor';
-export * from './renderColorScaleBias';
 export * from './renderer';
 export * from './renderMaterial';
 export * from './renderProxy';
 export * from './renderProxyAdapter';
 export * from './renderQueue';
+export * from './explainScene2DCoverage';
+export * from './renderRegistryGuards';
+export * from './renderRegistrySignals';
 export * from './renderState';
 export * from './renderTarget';
 export * from './renderTransform2d';
 export * from './renderViewport';
 export * from './sceneRender';
+export { SCENE2D_WORKING_COLOR_SPACE } from './scene2dWorkingColorSpace';
 //# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/enableColorAdjustmentGuards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enableColorAdjustmentGuards.d.ts","sourceRoot":"","sources":["../src/enableColorAdjustmentGuards.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAM5D,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAE3E;AAOD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAEpE"}
+{"version":3,"file":"enableColorAdjustmentGuards.d.ts","sourceRoot":"","sources":["../src/enableColorAdjustmentGuards.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAM5D,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAE3E;AAOD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAWpE"}

package/dist/enableColorAdjustmentGuards.js

@@ -1,21 +1,30 @@
 import { logOnce } from '@flighthq/log/contract';
-import { LogLevel } from '@flighthq/types/contract';
-import { getRenderStateRuntime } from './renderState';
+import { createSlotTable } from '@flighthq/registry/contract';
+import { LogLevel, RegistryEntryState } from '@flighthq/types/contract';
+import { getColorAdjustmentUnsupportedGuard, getRenderStateRuntime } from './renderState';
 // Returns whether the color-adjustment deferral guard is installed on `state`.
 export function areColorAdjustmentGuardsEnabled(state) {
-    return getRenderStateRuntime(state).colorAdjustmentUnsupportedGuard != null;
+    return getColorAdjustmentUnsupportedGuard(state) != null;
 }
-// Installs the shakeable color-adjustment guard on `state`: when a node's stack contains a non-matrix
-// operation that neither the compact affine path nor the full 4×5 path can represent, the render walk
-// reaches this guard through its nullable runtime slot and warns once. Not calling this — the production
-// default — costs the render walk nothing, since the message and @flighthq/log dependency live only in
-// this separately-imported module. Idempotent.
+// Installs only the shakeable color-adjustment diagnostic on `state`: when enableColorAdjustments is
+// also installed and a node's stack contains a non-matrix operation that neither the compact affine
+// path nor the full 4×5 path can represent, the resolver reaches this guard through its independent
+// optional persistent registry slot and warns once. This does not enable accumulation or backend realization.
+// Idempotent.
 export function enableColorAdjustmentGuards(state) {
-    getRenderStateRuntime(state).colorAdjustmentUnsupportedGuard = warnUnsupportedColorAdjustment;
+    const runtime = getRenderStateRuntime(state);
+    const table = runtime.registries.colorAdjustmentUnsupportedGuard ??
+        createSlotTable('ColorAdjustmentUnsupportedGuard', 'Disabled');
+    if (table.entry?.state !== RegistryEntryState.Bound || table.entry.value !== warnUnsupportedColorAdjustment) {
+        runtime.registries.colorAdjustmentUnsupportedGuard = {
+            ...table,
+            entry: { state: RegistryEntryState.Bound, value: warnUnsupportedColorAdjustment },
+        };
+    }
 }
 function warnUnsupportedColorAdjustment() {
     logOnce('render:unsupported-color-adjustment', LogLevel.Warn, {
-        message: 'updateRenderProxyColorScaleBias: a per-object color adjustment is not inline-able because it has no 4×5 matrix representation. Use an Effect pass for the unsupported operation.',
+        message: 'enableColorAdjustments: a per-object color adjustment is not inline-able because it has no 4×5 matrix representation. Use an Effect pass for the unsupported operation.',
     }, 'render');
 }
 //# sourceMappingURL=enableColorAdjustmentGuards.js.map

package/dist/enableColorAdjustmentGuards.js.map

@@ -1 +1 @@
-{"version":3,"file":"enableColorAdjustmentGuards.js","sourceRoot":"","sources":["../src/enableColorAdjustmentGuards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,+EAA+E;AAC/E,MAAM,UAAU,+BAA+B,CAAC,KAAkB;IAChE,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC,+BAA+B,IAAI,IAAI,CAAC;AAC9E,CAAC;AAED,sGAAsG;AACtG,sGAAsG;AACtG,yGAAyG;AACzG,uGAAuG;AACvG,+CAA+C;AAC/C,MAAM,UAAU,2BAA2B,CAAC,KAAkB;IAC5D,qBAAqB,CAAC,KAAK,CAAC,CAAC,+BAA+B,GAAG,8BAA8B,CAAC;AAChG,CAAC;AAED,SAAS,8BAA8B;IACrC,OAAO,CACL,qCAAqC,EACrC,QAAQ,CAAC,IAAI,EACb;QACE,OAAO,EACL,kLAAkL;KACrL,EACD,QAAQ,CACT,CAAC;AACJ,CAAC"}
+{"version":3,"file":"enableColorAdjustmentGuards.js","sourceRoot":"","sources":["../src/enableColorAdjustmentGuards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAExE,OAAO,EAAE,kCAAkC,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE1F,+EAA+E;AAC/E,MAAM,UAAU,+BAA+B,CAAC,KAAkB;IAChE,OAAO,kCAAkC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;AAC3D,CAAC;AAED,qGAAqG;AACrG,oGAAoG;AACpG,oGAAoG;AACpG,8GAA8G;AAC9G,cAAc;AACd,MAAM,UAAU,2BAA2B,CAAC,KAAkB;IAC5D,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,KAAK,GACT,OAAO,CAAC,UAAU,CAAC,+BAA+B;QAClD,eAAe,CAAC,iCAAiC,EAAE,UAAU,CAAC,CAAC;IACjE,IAAI,KAAK,CAAC,KAAK,EAAE,KAAK,KAAK,kBAAkB,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,8BAA8B,EAAE,CAAC;QAC5G,OAAO,CAAC,UAAU,CAAC,+BAA+B,GAAG;YACnD,GAAG,KAAK;YACR,KAAK,EAAE,EAAE,KAAK,EAAE,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,8BAA8B,EAAE;SAClF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,8BAA8B;IACrC,OAAO,CACL,qCAAqC,EACrC,QAAQ,CAAC,IAAI,EACb;QACE,OAAO,EACL,yKAAyK;KAC5K,EACD,QAAQ,CACT,CAAC;AACJ,CAAC"}

package/dist/enableColorAdjustments.d.ts

@@ -0,0 +1,4 @@
+import type { RenderState } from '@flighthq/types/contract';
+export declare function areColorAdjustmentsEnabled(state: RenderState): boolean;
+export declare function enableColorAdjustments(state: RenderState): void;
+//# sourceMappingURL=enableColorAdjustments.d.ts.map

package/dist/enableColorAdjustments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enableColorAdjustments.d.ts","sourceRoot":"","sources":["../src/enableColorAdjustments.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAMV,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAMlC,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAEtE;AAMD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAQ/D"}

package/dist/enableColorAdjustments.js

@@ -0,0 +1,119 @@
+import { multiplyColorMatrix } from '@flighthq/adjustments/contract';
+import { concatColorScaleBias, createColorScaleBias } from '@flighthq/materials/contract';
+import { getNodeRuntime } from '@flighthq/node/contract';
+import { createSlotTable } from '@flighthq/registry/contract';
+import { RegistryEntryState } from '@flighthq/types/contract';
+import { getColorAdjustmentUnsupportedGuard, getRenderStateRuntime } from './renderState';
+// Returns whether color-adjustment accumulation is installed on `state`.
+export function areColorAdjustmentsEnabled(state) {
+    return getRenderStateRuntime(state).registries.colorAdjustments?.entry?.state === RegistryEntryState.Bound;
+}
+// Installs color-adjustment accumulation on `state`. The base render walk reaches this module only
+// through the persistent resolver slot, so states that do not opt in retain one empty-slot check and do
+// not pull @flighthq/adjustments or @flighthq/materials into their bundle. Backend feature registrars
+// that can realize these values call this as part of their own opt-in. Idempotent.
+export function enableColorAdjustments(state) {
+    const runtime = getRenderStateRuntime(state);
+    const table = runtime.registries.colorAdjustments ?? createSlotTable('ColorAdjustments', 'Disabled');
+    if (table.entry?.state === RegistryEntryState.Bound && table.entry.value === updateRenderProxyColorScaleBias)
+        return;
+    runtime.registries.colorAdjustments = {
+        ...table,
+        entry: { state: RegistryEntryState.Bound, value: updateRenderProxyColorScaleBias },
+    };
+}
+// Hands the node's resolved color adjustment to the render node. A node's color-adjustment stack
+// (NodeRuntime.colorAdjustments) is fused once into the affine `resolvedColorScaleBias` cache by the
+// set-accessors on change — never per frame. The render walk then applies the local value first and its
+// parent's inherited value second, matching the appearance and alpha axes: a transform on a container
+// must reach every renderer-bearing descendant. Null and single-adjustment paths remain reference-only;
+// only a node with both local and inherited adjustments performs composition. The result is the
+// Adjustment-tier fold input; it is not a material and does not key the batch.
+//
+// Matrix-tier channel mixing travels through `resolvedColorMatrix`. A non-matrix operation that cannot
+// be represented by either path leaves `colorAdjustmentsUnsupported` set, invoking the shakeable guard
+// so unsupported adjustment data is reported rather than silently discarded.
+function updateRenderProxyColorScaleBias(state, data, parentData) {
+    const runtime = getNodeRuntime(data.source);
+    const localColorScaleBias = runtime.resolvedColorScaleBias ?? null;
+    const localColorMatrix = runtime.resolvedColorMatrix ?? null;
+    const parentColorScaleBias = parentData?.colorScaleBias ?? null;
+    const parentColorMatrix = parentData?.colorMatrix ?? null;
+    if (localColorMatrix !== null || parentColorMatrix !== null) {
+        data.colorMatrix = resolveInheritedColorMatrix(data.colorMatrix, parentColorMatrix, parentColorScaleBias, localColorMatrix, localColorScaleBias);
+        data.colorScaleBias = null;
+    }
+    else {
+        data.colorMatrix = null;
+        data.colorScaleBias = resolveInheritedColorScaleBias(data.colorScaleBias, parentColorScaleBias, localColorScaleBias);
+    }
+    if (runtime.colorAdjustmentsUnsupported) {
+        getColorAdjustmentUnsupportedGuard(state)?.(state, data.source);
+    }
+}
+function resolveInheritedColorScaleBias(previous, parent, local) {
+    if (parent === null)
+        return local;
+    if (local === null)
+        return parent;
+    const out = previous !== parent && previous !== local && previous !== null && inheritedColorScaleBiases.has(previous)
+        ? previous
+        : createInheritedColorScaleBias();
+    // SWF and scene-graph semantics apply the local adjustment first, then the parent's adjustment.
+    concatColorScaleBias(out, parent, local);
+    return out;
+}
+function resolveInheritedColorMatrix(previous, parentMatrix, parentColorScaleBias, localMatrix, localColorScaleBias) {
+    if (parentMatrix === null && parentColorScaleBias === null)
+        return localMatrix;
+    if (localMatrix === null && localColorScaleBias === null)
+        return parentMatrix;
+    const parent = parentMatrix ?? writeColorScaleBiasMatrix(parentColorMatrixScratch, parentColorScaleBias);
+    const local = localMatrix ?? writeColorScaleBiasMatrix(localColorMatrixScratch, localColorScaleBias);
+    const out = previous !== parentMatrix &&
+        previous !== localMatrix &&
+        previous !== null &&
+        previous !== undefined &&
+        inheritedColorMatrices.has(previous)
+        ? previous
+        : createInheritedColorMatrix();
+    return multiplyColorMatrix(parent, local, out);
+}
+function writeColorScaleBiasMatrix(out, value) {
+    out[0] = value.redScale;
+    out[1] = 0;
+    out[2] = 0;
+    out[3] = 0;
+    out[4] = value.redBias;
+    out[5] = 0;
+    out[6] = value.greenScale;
+    out[7] = 0;
+    out[8] = 0;
+    out[9] = value.greenBias;
+    out[10] = 0;
+    out[11] = 0;
+    out[12] = value.blueScale;
+    out[13] = 0;
+    out[14] = value.blueBias;
+    out[15] = 0;
+    out[16] = 0;
+    out[17] = 0;
+    out[18] = value.alphaScale;
+    out[19] = value.alphaBias;
+    return out;
+}
+function createInheritedColorScaleBias() {
+    const value = createColorScaleBias();
+    inheritedColorScaleBiases.add(value);
+    return value;
+}
+function createInheritedColorMatrix() {
+    const value = new Array(20);
+    inheritedColorMatrices.add(value);
+    return value;
+}
+const inheritedColorScaleBiases = new WeakSet();
+const inheritedColorMatrices = new WeakSet();
+const parentColorMatrixScratch = new Array(20);
+const localColorMatrixScratch = new Array(20);
+//# sourceMappingURL=enableColorAdjustments.js.map

package/dist/enableColorAdjustments.js.map

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

package/dist/enableSceneRenderGuards.d.ts

@@ -0,0 +1,22 @@
+/** Uninstalls the guards installed by `enableSceneRenderGuards`. */
+export declare function disableSceneRenderGuards(): void;
+/**
+ * Installs the caller-facing scene-render guards (opt-in, dev-only). It warns once — through
+ * `@flighthq/log` — when a skinned mesh reaches frustum culling with no posed bounds, meaning the
+ * deform pass `prepareScene3DRender` documents as a precondition never ran.
+ *
+ * That is worth a message because the failure is invisible at the point of the mistake. A GPU-skinned
+ * mesh deforms in the shader, so its geometry bounds stay bind pose; without the deform pass, culling
+ * tests a swung limb against the box the character occupied in bind pose and removes it from the frame.
+ * The symptom is a limb or a whole character flickering out at certain angles, which reads as a
+ * culling bug or a camera bug — anything except a missing call in the frame loop.
+ *
+ * `prepareScene3DRender` cannot simply run the deform pass itself: that would make `@flighthq/render`
+ * depend on `@flighthq/skeleton3d` and bundle skinning into every rigid and 2D consumer. So the
+ * precondition is real and the guard is how it becomes discoverable.
+ *
+ * Not importing this module costs production nothing: the message and the `@flighthq/log` dependency
+ * live only here.
+ */
+export declare function enableSceneRenderGuards(): void;
+//# sourceMappingURL=enableSceneRenderGuards.d.ts.map

package/dist/enableSceneRenderGuards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enableSceneRenderGuards.d.ts","sourceRoot":"","sources":["../src/enableSceneRenderGuards.ts"],"names":[],"mappings":"AAMA,oEAAoE;AACpE,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/enableSceneRenderGuards.js

@@ -0,0 +1,36 @@
+import { logOnce } from '@flighthq/log/contract';
+import { LogLevel } from '@flighthq/types/contract';
+import { setSkinnedMeshBoundsGuard } from './sceneRender';
+/** Uninstalls the guards installed by `enableSceneRenderGuards`. */
+export function disableSceneRenderGuards() {
+    setSkinnedMeshBoundsGuard(null);
+}
+/**
+ * Installs the caller-facing scene-render guards (opt-in, dev-only). It warns once — through
+ * `@flighthq/log` — when a skinned mesh reaches frustum culling with no posed bounds, meaning the
+ * deform pass `prepareScene3DRender` documents as a precondition never ran.
+ *
+ * That is worth a message because the failure is invisible at the point of the mistake. A GPU-skinned
+ * mesh deforms in the shader, so its geometry bounds stay bind pose; without the deform pass, culling
+ * tests a swung limb against the box the character occupied in bind pose and removes it from the frame.
+ * The symptom is a limb or a whole character flickering out at certain angles, which reads as a
+ * culling bug or a camera bug — anything except a missing call in the frame loop.
+ *
+ * `prepareScene3DRender` cannot simply run the deform pass itself: that would make `@flighthq/render`
+ * depend on `@flighthq/skeleton3d` and bundle skinning into every rigid and 2D consumer. So the
+ * precondition is real and the guard is how it becomes discoverable.
+ *
+ * Not importing this module costs production nothing: the message and the `@flighthq/log` dependency
+ * live only here.
+ */
+export function enableSceneRenderGuards() {
+    setSkinnedMeshBoundsGuard(warnOnUnposedSkinnedMesh);
+}
+function warnOnUnposedSkinnedMesh(_mesh) {
+    logOnce('render:skinned-mesh-without-deformed-bounds', LogLevel.Warn, {
+        message: 'prepareScene3DRender: a skinned mesh has no posed bounds, so culling is testing it against its ' +
+            'BIND POSE box and a deformed limb can be wrongly culled. Call prepareScene3DSkinning ' +
+            '(@flighthq/skeleton3d) before prepareScene3DRender each frame.',
+    }, 'render');
+}
+//# sourceMappingURL=enableSceneRenderGuards.js.map

package/dist/enableSceneRenderGuards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enableSceneRenderGuards.js","sourceRoot":"","sources":["../src/enableSceneRenderGuards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE1D,oEAAoE;AACpE,MAAM,UAAU,wBAAwB;IACtC,yBAAyB,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,uBAAuB;IACrC,yBAAyB,CAAC,wBAAwB,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAqB;IACrD,OAAO,CACL,6CAA6C,EAC7C,QAAQ,CAAC,IAAI,EACb;QACE,OAAO,EACL,iGAAiG;YACjG,uFAAuF;YACvF,gEAAgE;KACnE,EACD,QAAQ,CACT,CAAC;AACJ,CAAC"}

package/dist/explainScene2DCoverage.d.ts

@@ -0,0 +1,4 @@
+import type { RenderState, Scene2DKindUsage, SceneCoverageCatalog, SceneCoverageEntry } from '@flighthq/types/contract';
+export declare function explainScene2DCoverage(out: SceneCoverageEntry[], state: RenderState, usage: Readonly<Scene2DKindUsage>, catalog: SceneCoverageCatalog): void;
+export declare function hasScene2DCoverage(state: RenderState, usage: Readonly<Scene2DKindUsage>): boolean;
+//# sourceMappingURL=explainScene2DCoverage.d.ts.map

package/dist/explainScene2DCoverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainScene2DCoverage.d.ts","sourceRoot":"","sources":["../src/explainScene2DCoverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAiBlC,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,kBAAkB,EAAE,EACzB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EACjC,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAGN;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAEjG"}

package/dist/explainScene2DCoverage.js

@@ -0,0 +1,95 @@
+import { RegistryEntryState, RenderRegistry, RequirementFacet, SceneCoverage } from '@flighthq/types/contract';
+import { getRenderStateRuntime } from './renderState';
+// Clears `out`, then reports every requirement in `usage` that any 2D backend answers the same way,
+// with how well this state is wired for it — satisfied entries included, so one call is a manifest.
+//
+// This covers the two registries that live on the BASE render-state runtime and so mean the same thing
+// on Canvas, DOM, GL and WebGPU: the node-renderer table every backend dispatches through, and the shape
+// command set every backend replays through when it rasterizes. A backend adds its own specifics — GL
+// blend realizations, per-backend material renderers — on top of this, rather than restating it.
+//
+// Unlike the 3D seam, node kinds ARE a requirement here: the 2D pipeline resolves every node through
+// `registerRenderer(state, kind, renderer)`, where the 3D pipeline collects meshes structurally.
+// `catalog` is the caller's complete backend inventory; an unserved requirement uses its first ordered
+// registration as the primary remedy, while a satisfied requirement needs no catalog lookup.
+export function explainScene2DCoverage(out, state, usage, catalog) {
+    out.length = 0;
+    collectScene2DCoverageGaps(out, state, usage, false, catalog);
+}
+// Whether this state can serve every node kind and shape command `usage` names. Stops at the first
+// shortfall and never allocates. Use the explain form to find out WHICH requirement and how badly.
+export function hasScene2DCoverage(state, usage) {
+    return !collectScene2DCoverageGaps(null, state, usage, true, null);
+}
+// The single implementation both tiers read, so the boolean can never disagree with the explanation.
+// `found` counts only real shortfalls, so appending satisfied entries to `out` never flips the predicate.
+function collectScene2DCoverageGaps(out, state, usage, stopAtFirst, catalog) {
+    let found = false;
+    const runtime = getRenderStateRuntime(state);
+    // A node kind with no renderer produces no render proxy, so the node and its whole subtree are
+    // absent from the frame — the loudest failure in this seam and the one worth asking about first.
+    for (let i = 0; i < usage.nodeKinds.length; i++) {
+        const kind = usage.nodeKinds[i];
+        if (runtime.registries.renderers.entries.get(kind)?.state === RegistryEntryState.Bound) {
+            out?.push({
+                coverage: SceneCoverage.Satisfied,
+                facet: RequirementFacet.SceneNodeKind,
+                kind,
+                registry: RenderRegistry.NodeRenderer,
+            });
+            continue;
+        }
+        found = true;
+        if (stopAtFirst)
+            return true;
+        out?.push(createShortfallEntry(catalog, false, RequirementFacet.SceneNodeKind, kind, RenderRegistry.NodeRenderer));
+    }
+    // Only meaningful for a state that rasterizes shapes. A GL or WebGPU state drawing every shape
+    // through the mesh path never replays a command, so these entries are reported and simply not acted
+    // on — the same shape as reporting 3D node kinds a backend collects structurally.
+    const commands = runtime.registries.canvasShapeCommands?.entries;
+    for (let i = 0; i < usage.shapeCommandKeys.length; i++) {
+        const kind = usage.shapeCommandKeys[i];
+        if (commands?.get(kind)?.state === 'bound') {
+            out?.push({
+                coverage: SceneCoverage.Satisfied,
+                facet: RequirementFacet.SceneShapeCommand,
+                kind,
+                registry: RenderRegistry.ShapeCommandHandler,
+            });
+            continue;
+        }
+        found = true;
+        if (stopAtFirst)
+            return true;
+        out?.push(createShortfallEntry(catalog, false, RequirementFacet.SceneShapeCommand, kind, RenderRegistry.ShapeCommandHandler));
+    }
+    return found;
+}
+function createShortfallEntry(catalog, fallback, facet, kind, registry) {
+    const registration = findCatalogRegistration(catalog, kind, registry);
+    const base = { facet, kind, registry };
+    if (registration === null) {
+        return {
+            ...base,
+            coverage: fallback ? SceneCoverage.FallbackUnavailable : SceneCoverage.Unavailable,
+        };
+    }
+    return {
+        ...base,
+        coverage: fallback ? SceneCoverage.FallbackRemediable : SceneCoverage.Unregistered,
+        module: registration.module,
+        registrar: registration.registrar,
+    };
+}
+// Package-private and row-agnostic: generated, probed, and fixture catalogs all feed the same seam.
+function findCatalogRegistration(catalog, kind, registry) {
+    if (catalog === null)
+        return null;
+    for (const entry of catalog) {
+        if (entry.kind === kind && entry.registry === registry)
+            return entry.registrations[0] ?? null;
+    }
+    return null;
+}
+//# sourceMappingURL=explainScene2DCoverage.js.map

package/dist/explainScene2DCoverage.js.map

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

package/dist/explainScene2DRender.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explainScene2DRender.d.ts","sourceRoot":"","sources":["../src/explainScene2DRender.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EAExB,UAAU,EACV,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAqBlC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,wBAAwB,CAmBrG"}
+{"version":3,"file":"explainScene2DRender.d.ts","sourceRoot":"","sources":["../src/explainScene2DRender.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EAExB,UAAU,EACV,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAsBlC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,wBAAwB,CAoBrG"}

package/dist/explainScene2DRender.js

@@ -1,3 +1,4 @@
+import { RegistryEntryState } from '@flighthq/types/contract';
 import { getRenderProxy2D } from './renderProxy';
 import { getRenderStateRuntime } from './renderState';
 // Recomputes why `source` would or would not draw against `state`, and returns it as plain data. Pure:
@@ -18,7 +19,7 @@ import { getRenderStateRuntime } from './renderState';
 // a new blank-reason gate, this function must gain the matching check or it silently goes stale.
 export function explainScene2DRender(state, source) {
     const kind = source.kind;
-    const hasRenderer = getRenderStateRuntime(state).rendererMap.get(kind) !== undefined;
+    const hasRenderer = getRenderStateRuntime(state).registries.renderers.entries.get(kind)?.state === RegistryEntryState.Bound;
     const proxy = getRenderProxy2D(state, source);
     const prepared = proxy !== undefined;
     const appearance = source;

package/dist/explainScene2DRender.js.map

@@ -1 +1 @@
-{"version":3,"file":"explainScene2DRender.js","sourceRoot":"","sources":["../src/explainScene2DRender.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,uGAAuG;AACvG,qGAAqG;AACrG,oGAAoG;AACpG,uFAAuF;AACvF,EAAE;AACF,oGAAoG;AACpG,gGAAgG;AAChG,kGAAkG;AAClG,uGAAuG;AACvG,6FAA6F;AAC7F,yFAAyF;AACzF,EAAE;AACF,sGAAsG;AACtG,4FAA4F;AAC5F,uGAAuG;AACvG,iGAAiG;AACjG,MAAM,UAAU,oBAAoB,CAAC,KAAkB,EAAE,MAAkB;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,WAAW,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;IAErF,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,KAAK,KAAK,SAAS,CAAC;IAErC,MAAM,UAAU,GAAG,MAAkC,CAAC;IACtD,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;IACzE,MAAM,cAAc,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC;IAE5E,IAAI,MAAgC,CAAC;IACrC,IAAI,CAAC,WAAW;QAAE,MAAM,GAAG,aAAa,CAAC;SACpC,IAAI,CAAC,QAAQ;QAAE,MAAM,GAAG,cAAc,CAAC;SACvC,IAAI,CAAC,OAAO;QAAE,MAAM,GAAG,aAAa,CAAC;SACrC,IAAI,cAAc,IAAI,CAAC;QAAE,MAAM,GAAG,YAAY,CAAC;;QAC/C,MAAM,GAAG,IAAI,CAAC;IAEnB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"explainScene2DRender.js","sourceRoot":"","sources":["../src/explainScene2DRender.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,uGAAuG;AACvG,qGAAqG;AACrG,oGAAoG;AACpG,uFAAuF;AACvF,EAAE;AACF,oGAAoG;AACpG,gGAAgG;AAChG,kGAAkG;AAClG,uGAAuG;AACvG,6FAA6F;AAC7F,yFAAyF;AACzF,EAAE;AACF,sGAAsG;AACtG,4FAA4F;AAC5F,uGAAuG;AACvG,iGAAiG;AACjG,MAAM,UAAU,oBAAoB,CAAC,KAAkB,EAAE,MAAkB;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,WAAW,GACf,qBAAqB,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,kBAAkB,CAAC,KAAK,CAAC;IAE1G,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,KAAK,KAAK,SAAS,CAAC;IAErC,MAAM,UAAU,GAAG,MAAkC,CAAC;IACtD,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;IACzE,MAAM,cAAc,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC;IAE5E,IAAI,MAAgC,CAAC;IACrC,IAAI,CAAC,WAAW;QAAE,MAAM,GAAG,aAAa,CAAC;SACpC,IAAI,CAAC,QAAQ;QAAE,MAAM,GAAG,cAAc,CAAC;SACvC,IAAI,CAAC,OAAO;QAAE,MAAM,GAAG,aAAa,CAAC;SACrC,IAAI,cAAc,IAAI,CAAC;QAAE,MAAM,GAAG,YAAY,CAAC;;QAC/C,MAAM,GAAG,IAAI,CAAC;IAEnB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;AAC1E,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,3 @@
-export { createRenderCache, packScene3DLightBlock, prepareScene2DRender, prepareScene3DRender, registerRenderer, useRenderCache, } from './contract';
+export { areColorAdjustmentsEnabled, disableSceneRenderGuards, enableColorAdjustments, enableSceneRenderGuards, createRenderCache, destroyRenderState, disposeScene2DRender, enableRenderRegistryGuards, enableRenderRegistrySignals, explainRenderRegistryMisses, packScene3DLightBlock, prepareScene2DRender, prepareScene3DRender, registerRenderer, useRenderCache, } from './contract';
+export { SCENE2D_WORKING_COLOR_SPACE } from './scene2dWorkingColorSpace';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
-export { createRenderCache, packScene3DLightBlock, prepareScene2DRender, prepareScene3DRender, registerRenderer, useRenderCache, } from './contract';
+export { areColorAdjustmentsEnabled, disableSceneRenderGuards, enableColorAdjustments, enableSceneRenderGuards, createRenderCache, destroyRenderState, disposeScene2DRender, enableRenderRegistryGuards, enableRenderRegistrySignals, explainRenderRegistryMisses, packScene3DLightBlock, prepareScene2DRender, prepareScene3DRender, registerRenderer, useRenderCache, } from './contract';
+export { SCENE2D_WORKING_COLOR_SPACE } from './scene2dWorkingColorSpace';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/renderProxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderProxy.d.ts","sourceRoot":"","sources":["../src/renderProxy.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAEV,kBAAkB,EAClB,cAAc,EAEd,UAAU,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,WAAW,EACZ,MAAM,0BAA0B,CAAC;AASlC,KAAK,SAAS,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;AAEvF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW,CAyBrF;AAKD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,UAAU,GAAG,cAAc,GAAG,kBAAkB,GACvD,aAAa,CAMf;AAMD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAM/E;AASD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAE/E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,aAAa,CAY9F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,CAElG;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,GAAG,IAAI,CAE9E;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,WAAW,EACjB,UAAU,CAAC,EAAE,WAAW,GACvB,OAAO,CAWT;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAEjE;AAOD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAEpF;AAMD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,aAAa,GAAG,SAAS,GACpC,IAAI,CAGN;AAID,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,aAAa,GAAG,SAAS,GACpC,IAAI,CASN;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAWrF;AAMD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CA+CjG"}
+{"version":3,"file":"renderProxy.d.ts","sourceRoot":"","sources":["../src/renderProxy.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAEV,kBAAkB,EAClB,cAAc,EAEd,UAAU,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAQlC,KAAK,SAAS,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;AAEvF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW,CA2BrF;AAKD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,UAAU,GAAG,cAAc,GAAG,kBAAkB,GACvD,aAAa,CAMf;AAMD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAQ/E;AASD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAE/E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,aAAa,CAa9F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,CAElG;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,SAAS,GAAG,IAAI,CAE9E;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,WAAW,EACjB,UAAU,CAAC,EAAE,WAAW,GACvB,OAAO,CAeT;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAEjE;AAOD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAEpF;AAMD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,aAAa,GAAG,SAAS,GACpC,IAAI,CAGN;AAID,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,aAAa,GAAG,SAAS,GACpC,IAAI,CAsBN;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAWrF;AAgBD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAiDjG"}