@flighthq/lighting 0.1.0

package/dist/ambientLight.d.ts

@@ -0,0 +1,8 @@
+import type { AmbientLight } from '@flighthq/types';
+export interface AmbientLightOptions {
+    color?: number;
+    intensity?: number;
+}
+export declare function cloneAmbientLight(source: Readonly<AmbientLight>): AmbientLight;
+export declare function createAmbientLight(options?: Readonly<AmbientLightOptions>): AmbientLight;
+//# sourceMappingURL=ambientLight.d.ts.map

package/dist/ambientLight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambientLight.d.ts","sourceRoot":"","sources":["../src/ambientLight.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,YAAY,CAE9E;AAID,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,YAAY,CAMxF"}

package/dist/ambientLight.js

@@ -0,0 +1,16 @@
+import { createEntity } from '@flighthq/entity';
+import { AmbientLightKind } from '@flighthq/types';
+// Independent copy of an ambient light's data. The `kind` discriminant is carried over.
+export function cloneAmbientLight(source) {
+    return createAmbientLight({ color: source.color, intensity: source.intensity });
+}
+// Uniform omnidirectional fill light. Color is packed sRgb-albedo RGBA (0xrrggbbaa); defaults to
+// opaque white at unit intensity. Ambient lights do not cast shadows.
+export function createAmbientLight(options) {
+    return createEntity({
+        color: options?.color ?? 0xffffffff,
+        intensity: options?.intensity ?? 1,
+        kind: AmbientLightKind,
+    });
+}
+//# sourceMappingURL=ambientLight.js.map

package/dist/ambientLight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambientLight.js","sourceRoot":"","sources":["../src/ambientLight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOnD,wFAAwF;AACxF,MAAM,UAAU,iBAAiB,CAAC,MAA8B;IAC9D,OAAO,kBAAkB,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,iGAAiG;AACjG,sEAAsE;AACtE,MAAM,UAAU,kBAAkB,CAAC,OAAuC;IACxE,OAAO,YAAY,CAAC;QAClB,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,UAAU;QACnC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC;QAClC,IAAI,EAAE,gBAAgB;KACvB,CAAC,CAAC;AACL,CAAC"}

package/dist/areaLight.d.ts

@@ -0,0 +1,18 @@
+import type { AreaLight, Vector3Like } from '@flighthq/types';
+export interface AreaLightOptions {
+    castsShadow?: boolean;
+    color?: number;
+    direction?: Readonly<Vector3Like>;
+    intensity?: number;
+    normalBias?: number;
+    pcfRadius?: number;
+    position?: Readonly<Vector3Like>;
+    range?: number;
+    right?: Readonly<Vector3Like>;
+    shadowBias?: number;
+    up?: Readonly<Vector3Like>;
+}
+export declare function cloneAreaLight(source: Readonly<AreaLight>): AreaLight;
+export declare function createAreaLight(options?: Readonly<AreaLightOptions>): AreaLight;
+export declare function setAreaLightOrientation(out: AreaLight, direction: Readonly<Vector3Like>, right: Readonly<Vector3Like>, up: Readonly<Vector3Like>): void;
+//# sourceMappingURL=areaLight.d.ts.map

package/dist/areaLight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"areaLight.d.ts","sourceRoot":"","sources":["../src/areaLight.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9D,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,KAAK,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,EAAE,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;CAC5B;AAGD,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,SAAS,CAerE;AAMD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAmB/E;AAOD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,SAAS,EACd,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,EAChC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC5B,EAAE,EAAE,QAAQ,CAAC,WAAW,CAAC,GACxB,IAAI,CA6BN"}

package/dist/areaLight.js

@@ -0,0 +1,75 @@
+import { createEntity } from '@flighthq/entity';
+import { cloneVector3, createVector3, normalizeVector3, setVector3 } from '@flighthq/geometry';
+import { AreaLightKind } from '@flighthq/types';
+// Independent copy of an area light's data, including fresh position/direction/right/up vectors.
+export function cloneAreaLight(source) {
+    return createEntity({
+        castsShadow: source.castsShadow,
+        color: source.color,
+        direction: cloneVector3(source.direction),
+        intensity: source.intensity,
+        kind: AreaLightKind,
+        normalBias: source.normalBias,
+        pcfRadius: source.pcfRadius,
+        position: cloneVector3(source.position),
+        range: source.range,
+        right: cloneVector3(source.right),
+        shadowBias: source.shadowBias,
+        up: cloneVector3(source.up),
+    });
+}
+// Rectangular area light (LTC-shaded). `position` is the rectangle center, `direction` its facing
+// normal, `right`/`up` its half-extent axes (length encodes half-width/half-height). Color is
+// packed sRgb-albedo RGBA (0xrrggbbaa); defaults to opaque white at unit intensity, at the origin
+// facing down (0, -1, 0), unit-half-extent (1,0,0)/(0,0,1) rectangle, infinite range, shadows off.
+export function createAreaLight(options) {
+    const position = options?.position;
+    const direction = options?.direction;
+    const right = options?.right;
+    const up = options?.up;
+    return createEntity({
+        castsShadow: options?.castsShadow ?? false,
+        color: options?.color ?? 0xffffffff,
+        direction: direction ? cloneVector3(direction) : createVector3(0, -1, 0),
+        intensity: options?.intensity ?? 1,
+        kind: AreaLightKind,
+        normalBias: options?.normalBias ?? 0,
+        pcfRadius: options?.pcfRadius ?? 0,
+        position: position ? cloneVector3(position) : createVector3(0, 0, 0),
+        range: options?.range ?? -1,
+        right: right ? cloneVector3(right) : createVector3(1, 0, 0),
+        shadowBias: options?.shadowBias ?? 0,
+        up: up ? cloneVector3(up) : createVector3(0, 0, 1),
+    });
+}
+// Sets the orientation of a rectangular area light by writing normalized `direction`, `right`,
+// and `up` vectors. `direction` is the facing normal; `right`/`up` carry their existing lengths
+// as half-extents (they are not renormalized here — only the directions are updated). The input
+// direction, right, and up vectors are normalized before storing; zero-length inputs are ignored.
+// Alias-safe: all inputs are read into locals before writing.
+export function setAreaLightOrientation(out, direction, right, up) {
+    // Read all extents and direction components into locals before writing.
+    const rightLen = Math.sqrt(right.x * right.x + right.y * right.y + right.z * right.z);
+    const upLen = Math.sqrt(up.x * up.x + up.y * up.y + up.z * up.z);
+    const dirLen = Math.sqrt(direction.x * direction.x + direction.y * direction.y + direction.z * direction.z);
+    // Preserve existing half-extent lengths; only update the directions.
+    const existingRightLen = Math.sqrt(out.right.x * out.right.x + out.right.y * out.right.y + out.right.z * out.right.z);
+    const existingUpLen = Math.sqrt(out.up.x * out.up.x + out.up.y * out.up.y + out.up.z * out.up.z);
+    if (dirLen > 0) {
+        normalizeVector3(out.direction, direction);
+    }
+    if (rightLen > 0) {
+        // Normalize direction, then scale back to original half-extent.
+        setVector3(out.right, right.x / rightLen, right.y / rightLen, right.z / rightLen);
+        if (existingRightLen > 0) {
+            setVector3(out.right, out.right.x * existingRightLen, out.right.y * existingRightLen, out.right.z * existingRightLen);
+        }
+    }
+    if (upLen > 0) {
+        setVector3(out.up, up.x / upLen, up.y / upLen, up.z / upLen);
+        if (existingUpLen > 0) {
+            setVector3(out.up, out.up.x * existingUpLen, out.up.y * existingUpLen, out.up.z * existingUpLen);
+        }
+    }
+}
+//# sourceMappingURL=areaLight.js.map

package/dist/areaLight.js.map

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

package/dist/colorFromKelvin.d.ts

@@ -0,0 +1,2 @@
+export declare function createColorFromKelvin(kelvin: number): number;
+//# sourceMappingURL=colorFromKelvin.d.ts.map

package/dist/colorFromKelvin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorFromKelvin.d.ts","sourceRoot":"","sources":["../src/colorFromKelvin.ts"],"names":[],"mappings":"AAOA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAqC5D"}

package/dist/colorFromKelvin.js

@@ -0,0 +1,44 @@
+// Creates a packed sRgb-albedo RGBA color (0xrrggbbaa) from a color temperature in Kelvin.
+// Uses the Tanner Helland piecewise approximation (accurate to within ±1% for 1000 K–40000 K),
+// the same algorithm used in Blender, three.js, and Filament's color-temperature helper.
+// Returns opaque white (0xffffffff) for temperatures outside the 1000–40000 K range.
+//
+// Common temperatures: 1800 K = candlelight, 3000 K = warm bulb, 5500 K = noon sunlight,
+// 6500 K = D65 white, 10000 K = overcast sky.
+export function createColorFromKelvin(kelvin) {
+    // Clamp to the valid range.
+    const temp = Math.max(1000, Math.min(40000, kelvin)) / 100;
+    let r;
+    let g;
+    let b;
+    // Red channel.
+    if (temp <= 66) {
+        r = 255;
+    }
+    else {
+        r = 329.698727446 * Math.pow(temp - 60, -0.1332047592);
+    }
+    // Green channel.
+    if (temp <= 66) {
+        g = 99.4708025861 * Math.log(temp) - 161.1195681661;
+    }
+    else {
+        g = 288.1221695283 * Math.pow(temp - 60, -0.0755148492);
+    }
+    // Blue channel.
+    if (temp >= 66) {
+        b = 255;
+    }
+    else if (temp <= 19) {
+        b = 0;
+    }
+    else {
+        b = 138.5177312231 * Math.log(temp - 10) - 305.0447927307;
+    }
+    const ri = Math.max(0, Math.min(255, Math.round(r)));
+    const gi = Math.max(0, Math.min(255, Math.round(g)));
+    const bi = Math.max(0, Math.min(255, Math.round(b)));
+    // Pack as 0xrrggbbaa with fully opaque alpha.
+    return ((ri << 24) | (gi << 16) | (bi << 8) | 0xff) >>> 0;
+}
+//# sourceMappingURL=colorFromKelvin.js.map

package/dist/colorFromKelvin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorFromKelvin.js","sourceRoot":"","sources":["../src/colorFromKelvin.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,+FAA+F;AAC/F,yFAAyF;AACzF,qFAAqF;AACrF,EAAE;AACF,yFAAyF;AACzF,8CAA8C;AAC9C,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,4BAA4B;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC;IAE3D,IAAI,CAAS,CAAC;IACd,IAAI,CAAS,CAAC;IACd,IAAI,CAAS,CAAC;IAEd,eAAe;IACf,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QACf,CAAC,GAAG,GAAG,CAAC;IACV,CAAC;SAAM,CAAC;QACN,CAAC,GAAG,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC;IACzD,CAAC;IAED,iBAAiB;IACjB,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QACf,CAAC,GAAG,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,CAAC,GAAG,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC;IAC1D,CAAC;IAED,gBAAgB;IAChB,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QACf,CAAC,GAAG,GAAG,CAAC;IACV,CAAC;SAAM,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QACtB,CAAC,GAAG,CAAC,CAAC;IACR,CAAC;SAAM,CAAC;QACN,CAAC,GAAG,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,cAAc,CAAC;IAC5D,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAErD,8CAA8C;IAC9C,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC"}

package/dist/directionalLight.d.ts

@@ -0,0 +1,15 @@
+import type { DirectionalLight, Vector3Like } from '@flighthq/types';
+export interface DirectionalLightOptions {
+    castsShadow?: boolean;
+    color?: number;
+    direction?: Readonly<Vector3Like>;
+    intensity?: number;
+    normalBias?: number;
+    pcfRadius?: number;
+    shadowBias?: number;
+}
+export declare function cloneDirectionalLight(source: Readonly<DirectionalLight>): DirectionalLight;
+export declare function createDirectionalLight(options?: Readonly<DirectionalLightOptions>): DirectionalLight;
+export declare function setDirectionalLightDirection(out: DirectionalLight, x: number, y: number, z: number): void;
+export declare function setDirectionalLightTarget(out: DirectionalLight, fromX: number, fromY: number, fromZ: number, toX: number, toY: number, toZ: number): void;
+//# sourceMappingURL=directionalLight.d.ts.map

package/dist/directionalLight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directionalLight.d.ts","sourceRoot":"","sources":["../src/directionalLight.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGrE,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAW1F;AAKD,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,gBAAgB,CAYpG;AAID,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,gBAAgB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CASzG;AAID,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,IAAI,CAQN"}

package/dist/directionalLight.js

@@ -0,0 +1,56 @@
+import { createEntity } from '@flighthq/entity';
+import { cloneVector3, createVector3, setVector3 } from '@flighthq/geometry';
+import { DirectionalLightKind } from '@flighthq/types';
+// Independent copy of a directional light's data, including a fresh `direction` vector.
+export function cloneDirectionalLight(source) {
+    return createEntity({
+        castsShadow: source.castsShadow,
+        color: source.color,
+        direction: cloneVector3(source.direction),
+        intensity: source.intensity,
+        kind: DirectionalLightKind,
+        normalBias: source.normalBias,
+        pcfRadius: source.pcfRadius,
+        shadowBias: source.shadowBias,
+    });
+}
+// Infinitely distant directional light (sun). `direction` is the world-space travel direction
+// of the light; surfaces are lit from -direction. Color is packed sRgb-albedo RGBA (0xrrggbbaa);
+// defaults to opaque white at unit intensity, pointing straight down (0, -1, 0) with shadows off.
+export function createDirectionalLight(options) {
+    const direction = options?.direction;
+    return createEntity({
+        castsShadow: options?.castsShadow ?? false,
+        color: options?.color ?? 0xffffffff,
+        direction: direction ? cloneVector3(direction) : createVector3(0, -1, 0),
+        intensity: options?.intensity ?? 1,
+        kind: DirectionalLightKind,
+        normalBias: options?.normalBias ?? 0,
+        pcfRadius: options?.pcfRadius ?? 0,
+        shadowBias: options?.shadowBias ?? 0,
+    });
+}
+// Writes a normalized direction into `out.direction`. Normalizes the supplied x/y/z components
+// before storing so the renderer can rely on a unit-length direction. Alias-safe.
+export function setDirectionalLightDirection(out, x, y, z) {
+    // Read into locals for alias safety (out.direction may alias inputs through pooling).
+    const lx = x;
+    const ly = y;
+    const lz = z;
+    const len = Math.sqrt(lx * lx + ly * ly + lz * lz);
+    if (len > 0) {
+        setVector3(out.direction, lx / len, ly / len, lz / len);
+    }
+}
+// Writes the normalized direction from `fromX,fromY,fromZ` toward `toX,toY,toZ` into the
+// light's `direction`. The direction vector is normalized before storing. Alias-safe.
+export function setDirectionalLightTarget(out, fromX, fromY, fromZ, toX, toY, toZ) {
+    const dx = toX - fromX;
+    const dy = toY - fromY;
+    const dz = toZ - fromZ;
+    const len = Math.sqrt(dx * dx + dy * dy + dz * dz);
+    if (len > 0) {
+        setVector3(out.direction, dx / len, dy / len, dz / len);
+    }
+}
+//# sourceMappingURL=directionalLight.js.map

package/dist/directionalLight.js.map

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

package/dist/environment.d.ts

@@ -0,0 +1,8 @@
+import type { CubeTexture, Environment } from '@flighthq/types';
+export interface EnvironmentOptions {
+    environment?: CubeTexture | null;
+    intensity?: number;
+}
+export declare function cloneEnvironment(source: Readonly<Environment>): Environment;
+export declare function createEnvironment(options?: Readonly<EnvironmentOptions>): Environment;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGhE,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,WAAW,CAE3E;AAKD,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,WAAW,CAMrF"}

package/dist/environment.js

@@ -0,0 +1,18 @@
+import { createEntity } from '@flighthq/entity';
+import { EnvironmentKind } from '@flighthq/types';
+// Independent copy of the environment's data. The `environment` cubemap reference is shared, not
+// deep-copied: a CubeTexture is a GPU-backed resource, so the copy aliases the same source.
+export function cloneEnvironment(source) {
+    return createEnvironment({ environment: source.environment, intensity: source.intensity });
+}
+// Image-based environment lighting + skybox source. `environment` is the radiance cubemap used
+// for the skybox and as the IBL specular/irradiance source; `intensity` scales its contribution.
+// Defaults to no cubemap (null) at unit intensity.
+export function createEnvironment(options) {
+    return createEntity({
+        environment: options?.environment ?? null,
+        intensity: options?.intensity ?? 1,
+        kind: EnvironmentKind,
+    });
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAOlD,iGAAiG;AACjG,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAAC,MAA6B;IAC5D,OAAO,iBAAiB,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;AAC7F,CAAC;AAED,+FAA+F;AAC/F,iGAAiG;AACjG,mDAAmD;AACnD,MAAM,UAAU,iBAAiB,CAAC,OAAsC;IACtE,OAAO,YAAY,CAAC;QAClB,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,IAAI;QACzC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC;QAClC,IAAI,EAAE,eAAe;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/hemisphereLight.d.ts

@@ -0,0 +1,9 @@
+import type { HemisphereLight } from '@flighthq/types';
+export interface HemisphereLightOptions {
+    groundColor?: number;
+    intensity?: number;
+    skyColor?: number;
+}
+export declare function cloneHemisphereLight(source: Readonly<HemisphereLight>): HemisphereLight;
+export declare function createHemisphereLight(options?: Readonly<HemisphereLightOptions>): HemisphereLight;
+//# sourceMappingURL=hemisphereLight.d.ts.map

package/dist/hemisphereLight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hemisphereLight.d.ts","sourceRoot":"","sources":["../src/hemisphereLight.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,eAAe,CAMvF;AAKD,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GAAG,eAAe,CAOjG"}

package/dist/hemisphereLight.js

@@ -0,0 +1,22 @@
+import { createEntity } from '@flighthq/entity';
+import { HemisphereLightKind } from '@flighthq/types';
+// Independent copy of a hemisphere light's data. The `kind` discriminant is carried over.
+export function cloneHemisphereLight(source) {
+    return createHemisphereLight({
+        groundColor: source.groundColor,
+        intensity: source.intensity,
+        skyColor: source.skyColor,
+    });
+}
+// Gradient ambient: `skyColor` from above, `groundColor` from below, blended by the surface
+// normal's vertical component. Colors are packed sRgb-albedo RGBA (0xrrggbbaa); both default to
+// opaque white at unit intensity. Hemisphere lights do not cast shadows.
+export function createHemisphereLight(options) {
+    return createEntity({
+        groundColor: options?.groundColor ?? 0xffffffff,
+        intensity: options?.intensity ?? 1,
+        kind: HemisphereLightKind,
+        skyColor: options?.skyColor ?? 0xffffffff,
+    });
+}
+//# sourceMappingURL=hemisphereLight.js.map

package/dist/hemisphereLight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hemisphereLight.js","sourceRoot":"","sources":["../src/hemisphereLight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAQtD,0FAA0F;AAC1F,MAAM,UAAU,oBAAoB,CAAC,MAAiC;IACpE,OAAO,qBAAqB,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,4FAA4F;AAC5F,gGAAgG;AAChG,yEAAyE;AACzE,MAAM,UAAU,qBAAqB,CAAC,OAA0C;IAC9E,OAAO,YAAY,CAAC;QAClB,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,UAAU;QAC/C,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC;QAClC,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,UAAU;KAC1C,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './ambientLight';
+export * from './areaLight';
+export * from './colorFromKelvin';
+export * from './directionalLight';
+export * from './environment';
+export * from './hemisphereLight';
+export * from './lightAnalysis';
+export * from './pointLight';
+export * from './spotLight';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from './ambientLight';
+export * from './areaLight';
+export * from './colorFromKelvin';
+export * from './directionalLight';
+export * from './environment';
+export * from './hemisphereLight';
+export * from './lightAnalysis';
+export * from './pointLight';
+export * from './spotLight';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/lightAnalysis.d.ts

@@ -0,0 +1,6 @@
+import type { BoundingSphereLike, Light } from '@flighthq/types';
+export declare function getLightInfluenceBounds(out: BoundingSphereLike, light: Readonly<Light>): void;
+export declare function getLightLuminance(light: Readonly<Light>): number;
+export declare function hasLightInfluenceOnBounds(light: Readonly<Light>, bounds: Readonly<BoundingSphereLike>): boolean;
+export declare function isLightShadowCasting(light: Readonly<Light>): boolean;
+//# sourceMappingURL=lightAnalysis.d.ts.map

package/dist/lightAnalysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightAnalysis.d.ts","sourceRoot":"","sources":["../src/lightAnalysis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAc,MAAM,iBAAiB,CAAC;AAe7E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,IAAI,CAqC7F;AAMD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,MAAM,CAUhE;AAMD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAc/G;AAID,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAMpE"}

package/dist/lightAnalysis.js

@@ -0,0 +1,91 @@
+import { createBoundingSphere } from '@flighthq/geometry';
+import { AmbientLightKind, AreaLightKind, DirectionalLightKind, EnvironmentKind, HemisphereLightKind, PointLightKind, SpotLightKind, } from '@flighthq/types';
+// Writes the world-space influence bounding sphere of a light into `out`. The sphere bounds the
+// region the light can illuminate. Lights with a finite `range` produce a sphere centered at
+// `position` with `radius = range`. Non-spatial lights (ambient, hemisphere, environment) and
+// infinite-range spatial lights produce a sentinel sphere with `radius = -1` (unlimited reach).
+export function getLightInfluenceBounds(out, light) {
+    const kind = light.kind;
+    if (kind === AmbientLightKind ||
+        kind === HemisphereLightKind ||
+        kind === EnvironmentKind ||
+        kind === DirectionalLightKind) {
+        // Non-spatial or infinite-reach lights — sentinel radius.
+        out.center.x = 0;
+        out.center.y = 0;
+        out.center.z = 0;
+        out.radius = -1;
+        return;
+    }
+    if (kind === PointLightKind || kind === SpotLightKind || kind === AreaLightKind) {
+        const spatial = light;
+        const range = spatial.range;
+        if (range < 0) {
+            // Infinite range — sentinel.
+            out.center.x = 0;
+            out.center.y = 0;
+            out.center.z = 0;
+            out.radius = -1;
+            return;
+        }
+        out.center.x = spatial.position.x;
+        out.center.y = spatial.position.y;
+        out.center.z = spatial.position.z;
+        out.radius = range;
+        return;
+    }
+    // Unknown light kind — sentinel.
+    out.center.x = 0;
+    out.center.y = 0;
+    out.center.z = 0;
+    out.radius = -1;
+}
+// Returns the perceptual luminance of a light's color × intensity. The luminance is computed
+// from the packed sRgb-albedo RGBA color using the standard ITU-R BT.709 coefficients, then
+// scaled by `intensity`. Useful for ranking lights by visual importance when prioritizing a
+// forward-light budget.
+export function getLightLuminance(light) {
+    const colored = light;
+    const color = colored.color;
+    if (color === undefined)
+        return 0;
+    const r = ((color >>> 24) & 0xff) / 255;
+    const g = ((color >>> 16) & 0xff) / 255;
+    const b = ((color >>> 8) & 0xff) / 255;
+    const luma = 0.2126 * r + 0.7152 * g + 0.0722 * b;
+    const intensity = colored.intensity ?? 1;
+    return luma * intensity;
+}
+// Returns true when `light` could influence a point within `bounds`. Non-spatial lights (ambient,
+// hemisphere, directional, environment) and infinite-range lights always return true. For spatial
+// lights with a finite range, tests whether the influence sphere intersects `bounds` using a
+// sphere-sphere overlap test. An empty `bounds` (radius < 0) is treated as no overlap.
+export function hasLightInfluenceOnBounds(light, bounds) {
+    // Use module-level scratch to avoid per-call allocation.
+    getLightInfluenceBounds(scratchSphere, light);
+    // Sentinel radius (-1) = unlimited reach.
+    if (scratchSphere.radius < 0)
+        return true;
+    // Empty bounds — treat as no overlap.
+    if (bounds.radius < 0)
+        return false;
+    // Sphere-sphere overlap: distance between centers <= sum of radii.
+    const dx = scratchSphere.center.x - bounds.center.x;
+    const dy = scratchSphere.center.y - bounds.center.y;
+    const dz = scratchSphere.center.z - bounds.center.z;
+    const distSq = dx * dx + dy * dy + dz * dz;
+    const radSum = scratchSphere.radius + bounds.radius;
+    return distSq <= radSum * radSum;
+}
+// Returns true when the light is configured to cast shadows. Non-shadow-capable light types
+// (AmbientLight, HemisphereLight, Environment) always return false.
+export function isLightShadowCasting(light) {
+    const kind = light.kind;
+    if (kind === AmbientLightKind || kind === HemisphereLightKind || kind === EnvironmentKind) {
+        return false;
+    }
+    return light.castsShadow;
+}
+// Scratch sphere used by hasLightInfluenceOnBounds to avoid per-call allocation.
+const scratchSphere = createBoundingSphere(0, 0, 0, -1);
+//# sourceMappingURL=lightAnalysis.js.map

package/dist/lightAnalysis.js.map

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

package/dist/pointLight.d.ts

@@ -0,0 +1,14 @@
+import type { PointLight, Vector3Like } from '@flighthq/types';
+export interface PointLightOptions {
+    castsShadow?: boolean;
+    color?: number;
+    intensity?: number;
+    normalBias?: number;
+    pcfRadius?: number;
+    position?: Readonly<Vector3Like>;
+    range?: number;
+    shadowBias?: number;
+}
+export declare function clonePointLight(source: Readonly<PointLight>): PointLight;
+export declare function createPointLight(options?: Readonly<PointLightOptions>): PointLight;
+//# sourceMappingURL=pointLight.d.ts.map

package/dist/pointLight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointLight.d.ts","sourceRoot":"","sources":["../src/pointLight.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG/D,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,UAAU,CAYxE;AAKD,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,UAAU,CAalF"}

package/dist/pointLight.js

@@ -0,0 +1,35 @@
+import { createEntity } from '@flighthq/entity';
+import { cloneVector3, createVector3 } from '@flighthq/geometry';
+import { PointLightKind } from '@flighthq/types';
+// Independent copy of a point light's data, including a fresh `position` vector.
+export function clonePointLight(source) {
+    return createEntity({
+        castsShadow: source.castsShadow,
+        color: source.color,
+        intensity: source.intensity,
+        kind: PointLightKind,
+        normalBias: source.normalBias,
+        pcfRadius: source.pcfRadius,
+        position: cloneVector3(source.position),
+        range: source.range,
+        shadowBias: source.shadowBias,
+    });
+}
+// Omnidirectional point light. `position` is world-space; intensity falls off with distance up
+// to `range` (-1 = infinite). Color is packed sRgb-albedo RGBA (0xrrggbbaa); defaults to opaque
+// white at unit intensity, at the origin, infinite range, shadows off.
+export function createPointLight(options) {
+    const position = options?.position;
+    return createEntity({
+        castsShadow: options?.castsShadow ?? false,
+        color: options?.color ?? 0xffffffff,
+        intensity: options?.intensity ?? 1,
+        kind: PointLightKind,
+        normalBias: options?.normalBias ?? 0,
+        pcfRadius: options?.pcfRadius ?? 0,
+        position: position ? cloneVector3(position) : createVector3(0, 0, 0),
+        range: options?.range ?? -1,
+        shadowBias: options?.shadowBias ?? 0,
+    });
+}
+//# sourceMappingURL=pointLight.js.map

package/dist/pointLight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointLight.js","sourceRoot":"","sources":["../src/pointLight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAajD,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,MAA4B;IAC1D,OAAO,YAAY,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,IAAI,EAAE,cAAc;QACpB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC;QACvC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,+FAA+F;AAC/F,gGAAgG;AAChG,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,OAAqC;IACpE,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;IACnC,OAAO,YAAY,CAAC;QAClB,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,KAAK;QAC1C,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,UAAU;QACnC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC;QAClC,IAAI,EAAE,cAAc;QACpB,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,CAAC;QACpC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC;QAClC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACpE,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;QAC3B,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,CAAC;KACrC,CAAC,CAAC;AACL,CAAC"}

package/dist/spotLight.d.ts

@@ -0,0 +1,25 @@
+import type { SpotLight, Vector3Like } from '@flighthq/types';
+export interface SpotLightConeAngles {
+    innerDegrees: number;
+    outerDegrees: number;
+}
+export interface SpotLightOptions {
+    castsShadow?: boolean;
+    color?: number;
+    direction?: Readonly<Vector3Like>;
+    innerConeDegrees?: number;
+    intensity?: number;
+    normalBias?: number;
+    outerConeDegrees?: number;
+    pcfRadius?: number;
+    position?: Readonly<Vector3Like>;
+    range?: number;
+    shadowBias?: number;
+}
+export declare function cloneSpotLight(source: Readonly<SpotLight>): SpotLight;
+export declare function createSpotLight(options?: Readonly<SpotLightOptions>): SpotLight;
+export declare function getSpotLightConeDegrees(out: SpotLightConeAngles, source: Readonly<SpotLight>): void;
+export declare function setSpotLightCone(out: SpotLight, innerDegrees: number, outerDegrees: number): void;
+export declare function setSpotLightDirection(out: SpotLight, x: number, y: number, z: number): void;
+export declare function setSpotLightTarget(out: SpotLight, targetX: number, targetY: number, targetZ: number): void;
+//# sourceMappingURL=spotLight.d.ts.map

package/dist/spotLight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotLight.d.ts","sourceRoot":"","sources":["../src/spotLight.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9D,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAElC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,SAAS,CAerE;AAMD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAmB/E;AAKD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,IAAI,CAGnG;AAKD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAGjG;AAID,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ3F;AAKD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAY1G"}