@headless-three/renderer 0.1.7 → 0.1.8

package/dist/attributes.js

@@ -1,63 +1,89 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAttribute = getAttribute;
+exports.geometryAttributes = geometryAttributes;
 exports.readVec3Attribute = readVec3Attribute;
 exports.readVec2Attribute = readVec2Attribute;
 exports.readColorAttribute = readColorAttribute;
 exports.readIndexAttribute = readIndexAttribute;
+exports.attributeCount = attributeCount;
 exports.attributeComponent = attributeComponent;
 const math_1 = require("./math");
+const COMPONENT_LABELS = ['x', 'y', 'z', 'w'];
 function getAttribute(geometry, name) {
+    const attributes = geometryAttributes(geometry);
     if (typeof geometry.getAttribute === 'function') {
         return geometry.getAttribute(name);
     }
-    return geometry.attributes?.[name];
+    return attributes[name];
 }
-function readVec3Attribute(attribute) {
-    if (attribute.count == null) {
-        throw new TypeError('THREE.BufferGeometry position attribute must have count');
+function geometryAttributes(geometry) {
+    const attributes = geometry.attributes;
+    if (attributes == null)
+        return {};
+    if (typeof attributes !== 'object' || Array.isArray(attributes)) {
+        throw new TypeError('geometry.attributes must be an object.');
     }
-    const values = new Array(attribute.count * 3);
-    for (let i = 0; i < attribute.count; i += 1) {
-        values[i * 3] = attributeComponent(attribute, i, 0);
-        values[i * 3 + 1] = attributeComponent(attribute, i, 1);
-        values[i * 3 + 2] = attributeComponent(attribute, i, 2);
+    return attributes;
+}
+function readVec3Attribute(attribute, label = 'THREE.BufferAttribute') {
+    const count = attributeCount(attribute, label);
+    const values = new Array(count * 3);
+    for (let i = 0; i < count; i += 1) {
+        values[i * 3] = attributeComponent(attribute, i, 0, label);
+        values[i * 3 + 1] = attributeComponent(attribute, i, 1, label);
+        values[i * 3 + 2] = attributeComponent(attribute, i, 2, label);
     }
     return values;
 }
-function readVec2Attribute(attribute) {
-    if (attribute.count == null) {
-        throw new TypeError('THREE.BufferGeometry UV attribute must have count');
-    }
-    const values = new Array(attribute.count * 2);
-    for (let i = 0; i < attribute.count; i += 1) {
-        values[i * 2] = attributeComponent(attribute, i, 0);
-        values[i * 2 + 1] = attributeComponent(attribute, i, 1);
+function readVec2Attribute(attribute, label = 'THREE.BufferAttribute') {
+    const count = attributeCount(attribute, label);
+    const values = new Array(count * 2);
+    for (let i = 0; i < count; i += 1) {
+        values[i * 2] = attributeComponent(attribute, i, 0, label);
+        values[i * 2 + 1] = attributeComponent(attribute, i, 1, label);
     }
     return values;
 }
-function readColorAttribute(attribute, materialColor) {
-    const itemSize = attribute.itemSize ?? 3;
-    const values = new Array(attribute.count * 4);
-    for (let i = 0; i < attribute.count; i += 1) {
-        values[i * 4] = (0, math_1.clamp01)(attributeComponent(attribute, i, 0) * materialColor[0]);
-        values[i * 4 + 1] = (0, math_1.clamp01)(attributeComponent(attribute, i, 1) * materialColor[1]);
-        values[i * 4 + 2] = (0, math_1.clamp01)(attributeComponent(attribute, i, 2) * materialColor[2]);
-        values[i * 4 + 3] = (0, math_1.clamp01)((itemSize >= 4 ? attributeComponent(attribute, i, 3) : 1) * materialColor[3]);
+function readColorAttribute(attribute, _materialColor, label = 'THREE.BufferAttribute') {
+    const count = attributeCount(attribute, label);
+    const itemSize = attributeItemSize(attribute, label) ?? 3;
+    const values = new Array(count * 4);
+    for (let i = 0; i < count; i += 1) {
+        values[i * 4] = (0, math_1.clamp01)(attributeComponent(attribute, i, 0, label));
+        values[i * 4 + 1] = (0, math_1.clamp01)(attributeComponent(attribute, i, 1, label));
+        values[i * 4 + 2] = (0, math_1.clamp01)(attributeComponent(attribute, i, 2, label));
+        values[i * 4 + 3] = (0, math_1.clamp01)(itemSize >= 4 ? attributeComponent(attribute, i, 3, label) : 1);
     }
     return values;
 }
-function readIndexAttribute(attribute) {
-    const values = new Array(attribute.count);
-    for (let i = 0; i < attribute.count; i += 1) {
-        values[i] = attributeComponent(attribute, i, 0);
+function readIndexAttribute(attribute, label = 'THREE.BufferAttribute', vertexCount) {
+    const count = attributeCount(attribute, label);
+    const values = new Array(count);
+    for (let i = 0; i < count; i += 1) {
+        const value = attributeComponent(attribute, i, 0, label);
+        if (!Number.isInteger(value) || value < 0) {
+            throw new TypeError(`${label}[${i}].x must be a non-negative integer.`);
+        }
+        if (vertexCount !== undefined && value >= vertexCount) {
+            throw new RangeError(`${label}[${i}].x must reference a vertex below geometry.attributes.position.count (${vertexCount}).`);
+        }
+        values[i] = value;
     }
     return values;
 }
-function attributeComponent(attribute, index, component) {
-    if (component >= (attribute.itemSize ?? 1))
+function attributeCount(attribute, label) {
+    if (Number.isInteger(attribute.count) && attribute.count >= 0)
+        return attribute.count;
+    throw new TypeError(`${label}.count must be a non-negative integer.`);
+}
+function attributeComponent(attribute, index, component, label = 'THREE.BufferAttribute') {
+    rejectPackedAttribute(attribute, label);
+    const itemSize = attributeItemSize(attribute, label) ?? 1;
+    if (component >= itemSize)
         return 0;
     let value;
+    let readFromRawArray = false;
     if (component === 0 && typeof attribute.getX === 'function')
         value = attribute.getX(index);
     else if (component === 1 && typeof attribute.getY === 'function')
@@ -67,15 +93,57 @@ function attributeComponent(attribute, index, component) {
     else if (component === 3 && typeof attribute.getW === 'function')
         value = attribute.getW(index);
     else {
-        const array = attribute.array ?? attribute.data?.array;
-        const stride = attribute.data?.stride ?? attribute.itemSize ?? 1;
-        const offset = attribute.offset ?? 0;
+        const data = attributeData(attribute, label);
+        const array = attribute.array ?? data?.array;
+        const stride = attributeStride(attribute, label) ?? itemSize;
+        const offset = attributeOffset(attribute, label);
         value = array?.[index * stride + offset + component];
+        readFromRawArray = true;
     }
     if (!Number.isFinite(value)) {
-        throw new TypeError('THREE.BufferAttribute contains a non-finite value');
+        throw new TypeError(`${label}[${index}].${COMPONENT_LABELS[component] ?? component} must be a finite number.`);
     }
-    return attribute.normalized ? normalizeAttributeValue(value, attribute.array ?? attribute.data?.array) : value;
+    return attributeNormalized(attribute, label) && readFromRawArray
+        ? normalizeAttributeValue(value, attribute.array ?? attributeData(attribute, label)?.array)
+        : value;
+}
+function attributeItemSize(attribute, label) {
+    if (attribute.itemSize == null)
+        return undefined;
+    if (Number.isInteger(attribute.itemSize) && attribute.itemSize > 0)
+        return attribute.itemSize;
+    throw new TypeError(`${label}.itemSize must be a positive integer.`);
+}
+function attributeStride(attribute, label) {
+    const stride = attributeData(attribute, label)?.stride;
+    if (stride == null)
+        return undefined;
+    if (Number.isInteger(stride) && stride > 0)
+        return stride;
+    throw new TypeError(`${label}.data.stride must be a positive integer.`);
+}
+function attributeData(attribute, label) {
+    const data = attribute.data;
+    if (data == null)
+        return undefined;
+    if (typeof data !== 'object' || Array.isArray(data)) {
+        throw new TypeError(`${label}.data must be an object.`);
+    }
+    return data;
+}
+function attributeOffset(attribute, label) {
+    if (attribute.offset == null)
+        return 0;
+    if (Number.isInteger(attribute.offset) && attribute.offset >= 0)
+        return attribute.offset;
+    throw new TypeError(`${label}.offset must be a non-negative integer.`);
+}
+function attributeNormalized(attribute, label) {
+    if (attribute.normalized == null)
+        return false;
+    if (typeof attribute.normalized === 'boolean')
+        return attribute.normalized;
+    throw new TypeError(`${label}.normalized must be a boolean.`);
 }
 function normalizeAttributeValue(value, array) {
     if (array instanceof Uint8Array || array instanceof Uint8ClampedArray)
@@ -88,4 +156,12 @@ function normalizeAttributeValue(value, array) {
         return Math.max(value / 32767, -1);
     return value;
 }
+function rejectPackedAttribute(attribute, label) {
+    if (attribute.isPacked !== true)
+        return;
+    const method = typeof attribute.packingMethod === 'string' && attribute.packingMethod.length > 0
+        ? ` (${attribute.packingMethod})`
+        : '';
+    throw new Error(`${label} uses packed GeometryCompressionUtils data${method}, which is not supported by @headless-three/renderer. Decode packed position, normal, or UV attributes before rendering, or provide an explicit custom WGSL material path that performs the required attribute decode.`);
+}
 //# sourceMappingURL=attributes.js.map

package/dist/attributes.js.map

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

package/dist/camera.d.ts

@@ -4,5 +4,6 @@ export declare function resolveSize(camera: ThreeCameraLike, options: RenderOpti
     height: number;
 };
 export declare function cameraViewProjection(camera: ThreeCameraLike): Mat4;
+export declare function cameraViewMatrix(camera: ThreeCameraLike): Mat4;
 export declare function cameraWorldPosition(camera: ThreeCameraLike): number[];
 //# sourceMappingURL=camera.d.ts.map

package/dist/camera.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../api/camera.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAMnE,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA0B9G;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAIlE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAerE"}
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../api/camera.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAMnE,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAmC9G;AA6BD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAIlE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAE9D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAerE"}

package/dist/camera.js

@@ -2,45 +2,84 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveSize = resolveSize;
 exports.cameraViewProjection = cameraViewProjection;
+exports.cameraViewMatrix = cameraViewMatrix;
 exports.cameraWorldPosition = cameraWorldPosition;
 const math_1 = require("./math");
 const DEFAULT_WIDTH = 512;
 const DEFAULT_HEIGHT = 512;
 function resolveSize(camera, options) {
-    let width = (0, math_1.numberOrUndefined)(options.width);
-    let height = (0, math_1.numberOrUndefined)(options.height);
+    let width = optionalDimension(options.width, 'options.width') ?? optionalDimension(options.target?.width, 'target.width');
+    let height = optionalDimension(options.height, 'options.height') ?? optionalDimension(options.target?.height, 'target.height');
+    let widthLabel = options.width != null ? 'options.width' : options.target?.width != null ? 'target.width' : 'output width';
+    let heightLabel = options.height != null ? 'options.height' : options.target?.height != null ? 'target.height' : 'output height';
     if (width == null && height == null) {
-        width = (0, math_1.numberOrUndefined)(camera.userData?.width) ?? DEFAULT_WIDTH;
-        height = (0, math_1.numberOrUndefined)(camera.userData?.height);
+        const userData = cameraUserData(camera);
+        width = optionalDimension(userData?.width, 'camera.userData.width') ?? DEFAULT_WIDTH;
+        height = optionalDimension(userData?.height, 'camera.userData.height');
+        widthLabel = userData?.width != null ? 'camera.userData.width' : 'output width';
+        heightLabel = userData?.height != null ? 'camera.userData.height' : 'output height';
     }
-    if (height == null && width != null && (0, math_1.isFinitePositive)(camera.aspect)) {
-        height = Math.round(width / camera.aspect);
+    if (height == null && width != null && camera.aspect != null) {
+        const aspect = requiredPositiveFiniteNumber(camera.aspect, 'camera.aspect');
+        height = Math.round(width / aspect);
+        heightLabel = 'camera.aspect-derived height';
     }
-    if (width == null && height != null && (0, math_1.isFinitePositive)(camera.aspect)) {
-        width = Math.round(height * camera.aspect);
+    if (width == null && height != null && camera.aspect != null) {
+        const aspect = requiredPositiveFiniteNumber(camera.aspect, 'camera.aspect');
+        width = Math.round(height * aspect);
+        widthLabel = 'camera.aspect-derived width';
     }
     width ?? (width = DEFAULT_WIDTH);
     height ?? (height = DEFAULT_HEIGHT);
     if (!Number.isInteger(width) || width <= 0) {
-        throw new TypeError('render options width must be a positive integer');
+        throw new TypeError(`${widthLabel} must be a positive integer.`);
     }
     if (!Number.isInteger(height) || height <= 0) {
-        throw new TypeError('render options height must be a positive integer');
+        throw new TypeError(`${heightLabel} must be a positive integer.`);
     }
     return { width, height };
 }
+function cameraUserData(camera) {
+    const userData = camera.userData;
+    if (userData == null)
+        return undefined;
+    if (typeof userData !== 'object' || Array.isArray(userData)) {
+        throw new TypeError('camera.userData must be an object.');
+    }
+    return userData;
+}
+function optionalDimension(value, label) {
+    if (value == null)
+        return undefined;
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new TypeError(`${label} must be a finite number.`);
+    }
+    return value;
+}
+function requiredPositiveFiniteNumber(value, label) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new TypeError(`${label} must be a finite number.`);
+    }
+    if (value <= 0) {
+        throw new TypeError(`${label} must be positive.`);
+    }
+    return value;
+}
 function cameraViewProjection(camera) {
     const projection = (0, math_1.matrixElements)(camera.projectionMatrix, 'camera.projectionMatrix');
     const view = (0, math_1.matrixElements)(camera.matrixWorldInverse, 'camera.matrixWorldInverse');
     return (0, math_1.multiplyMatrices)(math_1.OPENGL_TO_WGPU_CLIP, (0, math_1.multiplyMatrices)(projection, view));
 }
+function cameraViewMatrix(camera) {
+    return (0, math_1.matrixElements)(camera.matrixWorldInverse, 'camera.matrixWorldInverse');
+}
 function cameraWorldPosition(camera) {
-    if (camera.matrixWorld?.elements) {
-        const e = camera.matrixWorld.elements;
+    if (camera.matrixWorld != null) {
+        const e = (0, math_1.matrixElements)(camera.matrixWorld, 'camera.matrixWorld');
         return [e[12], e[13], e[14]];
     }
     if (camera.matrixWorldInverse?.elements) {
-        const e = camera.matrixWorldInverse.elements;
+        const e = (0, math_1.matrixElements)(camera.matrixWorldInverse, 'camera.matrixWorldInverse');
         const tx = e[12], ty = e[13], tz = e[14];
         return [
             -(e[0] * tx + e[1] * ty + e[2] * tz),

package/dist/camera.js.map

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

package/dist/clipping.d.ts

@@ -0,0 +1,6 @@
+import type { ThreePlaneLike } from './types';
+export declare const MAX_CLIPPING_PLANES = 8;
+export type NativeClippingPlane = [number, number, number, number];
+export declare function extractClippingPlanes(input: readonly ThreePlaneLike[] | null | undefined, label?: string, maxPlanes?: number): NativeClippingPlane[];
+export declare function flattenClippingPlanes(planes: readonly NativeClippingPlane[]): number[] | undefined;
+//# sourceMappingURL=clipping.d.ts.map

package/dist/clipping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipping.d.ts","sourceRoot":"","sources":["../api/clipping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAEpC,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAElE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,GAAG,SAAS,EACnD,KAAK,SAAmB,EACxB,SAAS,SAAsB,GAC9B,mBAAmB,EAAE,CAmBvB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,CAGlG"}

package/dist/clipping.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_CLIPPING_PLANES = void 0;
+exports.extractClippingPlanes = extractClippingPlanes;
+exports.flattenClippingPlanes = flattenClippingPlanes;
+exports.MAX_CLIPPING_PLANES = 8;
+function extractClippingPlanes(input, label = 'clippingPlanes', maxPlanes = exports.MAX_CLIPPING_PLANES) {
+    if (input == null)
+        return [];
+    if (!Array.isArray(input)) {
+        throw new TypeError(`${label} must be an array of clipping planes.`);
+    }
+    if (input.length === 0)
+        return [];
+    const planes = [];
+    for (let i = 0; i < input.length; i += 1) {
+        const parsed = parseClippingPlane(input[i], `${label}[${i}]`);
+        if (!parsed)
+            continue;
+        if (planes.length >= maxPlanes) {
+            throw new Error(`${label} exceeds the remaining native clipping plane budget (${maxPlanes} of ${exports.MAX_CLIPPING_PLANES} remaining). @headless-three/renderer supports at most ${exports.MAX_CLIPPING_PLANES} active global, group, and material clipping planes; reduce the active planes or render separate passes.`);
+        }
+        planes.push(parsed);
+    }
+    return planes;
+}
+function flattenClippingPlanes(planes) {
+    if (planes.length === 0)
+        return undefined;
+    return planes.flatMap((plane) => plane);
+}
+function parseClippingPlane(plane, label) {
+    if (!plane)
+        return null;
+    if (isArrayLike(plane)) {
+        if (plane.length < 4) {
+            throw new TypeError(`${label} must contain four finite numbers.`);
+        }
+        return normalizedPlane([
+            requiredFiniteNumber(plane[0], `${label}[0]`),
+            requiredFiniteNumber(plane[1], `${label}[1]`),
+            requiredFiniteNumber(plane[2], `${label}[2]`),
+            requiredFiniteNumber(plane[3], `${label}[3]`),
+        ], label);
+    }
+    const normal = plane.normal;
+    const constant = plane.constant;
+    const finiteConstant = requiredFiniteNumber(constant, `${label}.constant`);
+    if (isArrayLike(normal)) {
+        if (normal.length < 3) {
+            throw new TypeError(`${label}.normal must contain three finite numbers.`);
+        }
+        return normalizedPlane([
+            requiredFiniteNumber(normal[0], `${label}.normal[0]`),
+            requiredFiniteNumber(normal[1], `${label}.normal[1]`),
+            requiredFiniteNumber(normal[2], `${label}.normal[2]`),
+            finiteConstant,
+        ], label);
+    }
+    const vector = normal;
+    return normalizedPlane([
+        requiredFiniteNumber(vector?.x, `${label}.normal.x`),
+        requiredFiniteNumber(vector?.y, `${label}.normal.y`),
+        requiredFiniteNumber(vector?.z, `${label}.normal.z`),
+        finiteConstant,
+    ], label);
+}
+function normalizedPlane(values, label) {
+    const [x, y, z, constant] = values;
+    const length = Math.hypot(x, y, z);
+    if (length <= 1e-8) {
+        throw new TypeError(`${label}.normal must have non-zero finite length.`);
+    }
+    return [x / length, y / length, z / length, constant / length];
+}
+function isArrayLike(value) {
+    return !!value && typeof value.length === 'number';
+}
+function requiredFiniteNumber(value, label) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    throw new TypeError(`${label} must be a finite number.`);
+}
+//# sourceMappingURL=clipping.js.map

package/dist/clipping.js.map

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

package/dist/color.d.ts

@@ -1,5 +1,10 @@
-import type { Color4, ThreeSceneLike, RenderOptions } from './types';
+import type { Color4, RenderOutputColorSpace, ThreeSceneRootLike, RenderOptions } from './types';
+export declare const DEFAULT_BACKGROUND_COLOR: Color4;
 export declare function colorLikeToArray(value: unknown): Color4 | null;
-export declare function normalizeColorArray(values: number[]): Color4;
-export declare function resolveBackground(scene: ThreeSceneLike, options: RenderOptions): Color4;
+export declare function strictColorLikeToArray(value: unknown, label: string): Color4 | null;
+export declare function validatedColorLikeToArray(value: unknown, label: string): Color4 | null;
+export declare function cssColorStringToArray(value: string, label: string): Color4;
+export declare function cssColorStringToLinearArray(value: string, label: string): Color4;
+export declare function normalizeColorArray(values: number[], label?: string): Color4;
+export declare function resolveBackground(scene: ThreeSceneRootLike, options: RenderOptions, hasBackgroundTexture?: boolean, fallbackBackground?: Color4, outputColorSpace?: RenderOutputColorSpace | undefined): Color4;
 //# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../api/color.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAkB,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAGpF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ9D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAU5D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAOvF"}
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../api/color.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAkB,kBAAkB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAqBhH,eAAO,MAAM,wBAAwB,EAAE,MAA+B,CAAA;AAEtE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ9D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAenF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBtF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI1E;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhF;AAyBD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAU5E;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,aAAa,EACtB,oBAAoB,UAAQ,EAC5B,kBAAkB,GAAE,MAAiC,EACrD,gBAAgB,GAAE,sBAAsB,GAAG,SAAoC,GAC9E,MAAM,CAYR"}