@aura3d/rendering 1.4.0 → 1.4.2

package/src/Geometry.ts

@@ -1,461 +0,0 @@
-import { IndexBuffer } from "./IndexBuffer";
-import { type PrimitiveTopology } from "./RenderDevice";
-import { VertexBuffer } from "./VertexBuffer";
-import { VertexFormat } from "./VertexFormat";
-
-export interface Bounds3 {
-  readonly min: readonly [number, number, number];
-  readonly max: readonly [number, number, number];
-}
-
-export interface CylinderGeometryOptions {
-  readonly radius?: number;
-  readonly height?: number;
-  readonly segments?: number;
-  readonly capped?: boolean;
-  readonly textured?: boolean;
-}
-
-export interface CapsuleGeometryOptions {
-  readonly radius?: number;
-  readonly height?: number;
-  readonly segments?: number;
-  readonly rings?: number;
-  readonly textured?: boolean;
-}
-
-export interface WideLineSegment {
-  readonly start: readonly [number, number, number];
-  readonly end: readonly [number, number, number];
-  readonly width: number;
-}
-
-export interface UVSphereGeometryOptions {
-  readonly textured?: boolean;
-}
-
-export class Geometry {
-  constructor(
-    public readonly vertexBuffer: VertexBuffer,
-    public readonly indexBuffer: IndexBuffer | null = null,
-    public readonly topology: PrimitiveTopology = "triangles",
-    public readonly bounds: Bounds3 = computeBounds(vertexBuffer)
-  ) {}
-
-  static triangle(): Geometry {
-    const vertices = new VertexBuffer(VertexFormat.P3, 3);
-    vertices.setAttribute(0, "position", [-0.5, -0.5, 0]);
-    vertices.setAttribute(1, "position", [0.5, -0.5, 0]);
-    vertices.setAttribute(2, "position", [0, 0.5, 0]);
-    return new Geometry(vertices, new IndexBuffer([0, 1, 2], 3));
-  }
-
-  static lineSegments(positions: readonly (readonly [number, number, number])[]): Geometry {
-    if (positions.length === 0 || positions.length % 2 !== 0) {
-      throw new Error("Line segment geometry requires one or more pairs of positions");
-    }
-    const vertices = new VertexBuffer(VertexFormat.P3, positions.length);
-    positions.forEach((position, index) => {
-      if (position.length !== 3 || !Number.isFinite(position[0]) || !Number.isFinite(position[1]) || !Number.isFinite(position[2])) {
-        throw new Error(`Line segment position ${index} must be a finite vec3`);
-      }
-      vertices.setAttribute(index, "position", position);
-    });
-    return new Geometry(vertices, null, "lines");
-  }
-
-  static wideLineSegments(segments: readonly WideLineSegment[]): Geometry {
-    if (segments.length === 0) {
-      throw new Error("Wide line geometry requires at least one segment");
-    }
-    const vertices = new VertexBuffer(VertexFormat.P3, segments.length * 4);
-    const indices: number[] = [];
-    segments.forEach((segment, segmentIndex) => {
-      validateWideLineSegment(segment, segmentIndex);
-      const [sx, sy, sz] = segment.start;
-      const [ex, ey, ez] = segment.end;
-      const dx = ex - sx;
-      const dy = ey - sy;
-      const dz = ez - sz;
-      const length = Math.hypot(dx, dy, dz);
-      const up = Math.abs(dz / length) > 0.92 ? [0, 1, 0] as const : [0, 0, 1] as const;
-      const nx = dy * up[2] - dz * up[1];
-      const ny = dz * up[0] - dx * up[2];
-      const nz = dx * up[1] - dy * up[0];
-      const normalLength = Math.hypot(nx, ny, nz);
-      const halfWidth = segment.width * 0.5;
-      const ox = nx / normalLength * halfWidth;
-      const oy = ny / normalLength * halfWidth;
-      const oz = nz / normalLength * halfWidth;
-      const base = segmentIndex * 4;
-      vertices.setAttribute(base, "position", [sx - ox, sy - oy, sz - oz]);
-      vertices.setAttribute(base + 1, "position", [sx + ox, sy + oy, sz + oz]);
-      vertices.setAttribute(base + 2, "position", [ex + ox, ey + oy, ez + oz]);
-      vertices.setAttribute(base + 3, "position", [ex - ox, ey - oy, ez - oz]);
-      indices.push(base, base + 1, base + 2, base, base + 2, base + 3);
-    });
-    return new Geometry(vertices, new IndexBuffer(indices, segments.length * 4), "triangles");
-  }
-
-  static points(positions: readonly (readonly [number, number, number])[]): Geometry {
-    if (positions.length === 0) {
-      throw new Error("Point geometry requires at least one position");
-    }
-    const vertices = new VertexBuffer(VertexFormat.P3, positions.length);
-    positions.forEach((position, index) => {
-      if (position.length !== 3 || !Number.isFinite(position[0]) || !Number.isFinite(position[1]) || !Number.isFinite(position[2])) {
-        throw new Error(`Point position ${index} must be a finite vec3`);
-      }
-      vertices.setAttribute(index, "position", position);
-    });
-    return new Geometry(vertices, null, "points");
-  }
-
-  static litTriangle(): Geometry {
-    const vertices = new VertexBuffer(VertexFormat.P3N3, 3);
-    vertices.setAttribute(0, "position", [-0.5, -0.5, 0]);
-    vertices.setAttribute(0, "normal", [0, 0, 1]);
-    vertices.setAttribute(1, "position", [0.5, -0.5, 0]);
-    vertices.setAttribute(1, "normal", [0, 0, 1]);
-    vertices.setAttribute(2, "position", [0, 0.5, 0]);
-    vertices.setAttribute(2, "normal", [0, 0, 1]);
-    return new Geometry(vertices, new IndexBuffer([0, 1, 2], 3));
-  }
-
-  static litCube(size = 1): Geometry {
-    if (size <= 0) {
-      throw new Error("Lit cube size must be positive");
-    }
-    const half = size / 2;
-    const faces: readonly {
-      readonly normal: readonly [number, number, number];
-      readonly corners: readonly (readonly [number, number, number])[];
-    }[] = [
-      { normal: [0, 0, 1], corners: [[-half, -half, half], [half, -half, half], [half, half, half], [-half, half, half]] },
-      { normal: [0, 0, -1], corners: [[half, -half, -half], [-half, -half, -half], [-half, half, -half], [half, half, -half]] },
-      { normal: [1, 0, 0], corners: [[half, -half, half], [half, -half, -half], [half, half, -half], [half, half, half]] },
-      { normal: [-1, 0, 0], corners: [[-half, -half, -half], [-half, -half, half], [-half, half, half], [-half, half, -half]] },
-      { normal: [0, 1, 0], corners: [[-half, half, half], [half, half, half], [half, half, -half], [-half, half, -half]] },
-      { normal: [0, -1, 0], corners: [[-half, -half, -half], [half, -half, -half], [half, -half, half], [-half, -half, half]] }
-    ];
-    const vertices = new VertexBuffer(VertexFormat.P3N3, faces.length * 4);
-    const indices: number[] = [];
-    faces.forEach((face, faceIndex) => {
-      const offset = faceIndex * 4;
-      face.corners.forEach((position, cornerIndex) => {
-        vertices.setAttribute(offset + cornerIndex, "position", position);
-        vertices.setAttribute(offset + cornerIndex, "normal", face.normal);
-      });
-      indices.push(offset, offset + 1, offset + 2, offset, offset + 2, offset + 3);
-    });
-    return new Geometry(vertices, new IndexBuffer(indices, faces.length * 4));
-  }
-
-  static texturedCube(size = 1): Geometry {
-    if (size <= 0) {
-      throw new Error("Textured cube size must be positive");
-    }
-    const half = size / 2;
-    const uv: readonly (readonly [number, number])[] = [[0, 0], [1, 0], [1, 1], [0, 1]];
-    const faces: readonly {
-      readonly normal: readonly [number, number, number];
-      readonly tangent: readonly [number, number, number, number];
-      readonly corners: readonly (readonly [number, number, number])[];
-    }[] = [
-      { normal: [0, 0, 1], tangent: [1, 0, 0, 1], corners: [[-half, -half, half], [half, -half, half], [half, half, half], [-half, half, half]] },
-      { normal: [0, 0, -1], tangent: [-1, 0, 0, 1], corners: [[half, -half, -half], [-half, -half, -half], [-half, half, -half], [half, half, -half]] },
-      { normal: [1, 0, 0], tangent: [0, 0, -1, 1], corners: [[half, -half, half], [half, -half, -half], [half, half, -half], [half, half, half]] },
-      { normal: [-1, 0, 0], tangent: [0, 0, 1, 1], corners: [[-half, -half, -half], [-half, -half, half], [-half, half, half], [-half, half, -half]] },
-      { normal: [0, 1, 0], tangent: [1, 0, 0, 1], corners: [[-half, half, half], [half, half, half], [half, half, -half], [-half, half, -half]] },
-      { normal: [0, -1, 0], tangent: [1, 0, 0, 1], corners: [[-half, -half, -half], [half, -half, -half], [half, -half, half], [-half, -half, half]] }
-    ];
-    const vertices = new VertexBuffer(VertexFormat.P3N3T4T2, faces.length * 4);
-    const indices: number[] = [];
-    faces.forEach((face, faceIndex) => {
-      const offset = faceIndex * 4;
-      face.corners.forEach((position, cornerIndex) => {
-        vertices.setAttribute(offset + cornerIndex, "position", position);
-        vertices.setAttribute(offset + cornerIndex, "normal", face.normal);
-        vertices.setAttribute(offset + cornerIndex, "tangent", face.tangent);
-        vertices.setAttribute(offset + cornerIndex, "uv", uv[cornerIndex]!);
-      });
-      indices.push(offset, offset + 1, offset + 2, offset, offset + 2, offset + 3);
-    });
-    return new Geometry(vertices, new IndexBuffer(indices, faces.length * 4));
-  }
-
-  static uvSphere(radius = 0.5, segments = 48, rings = 24, options: UVSphereGeometryOptions = {}): Geometry {
-    if (radius <= 0) {
-      throw new Error("Sphere radius must be positive");
-    }
-    if (!Number.isInteger(segments) || !Number.isInteger(rings) || segments < 3 || rings < 2) {
-      throw new Error("Sphere segments and rings must be integers with segments >= 3 and rings >= 2");
-    }
-    const textured = options.textured === true;
-    const vertexCount = (rings + 1) * (segments + 1);
-    const vertices = new VertexBuffer(textured ? VertexFormat.P3N3T4T2 : VertexFormat.P3N3, vertexCount);
-    let vertex = 0;
-    for (let ring = 0; ring <= rings; ring += 1) {
-      const v = ring / rings;
-      const theta = v * Math.PI;
-      const sinTheta = Math.sin(theta);
-      const cosTheta = Math.cos(theta);
-      for (let segment = 0; segment <= segments; segment += 1) {
-        const u = segment / segments;
-        const phi = u * Math.PI * 2;
-        const nx = Math.cos(phi) * sinTheta;
-        const ny = cosTheta;
-        const nz = Math.sin(phi) * sinTheta;
-        vertices.setAttribute(vertex, "position", [nx * radius, ny * radius, nz * radius]);
-        vertices.setAttribute(vertex, "normal", [nx, ny, nz]);
-        if (textured) {
-          vertices.setAttribute(vertex, "tangent", [-Math.sin(phi), 0, Math.cos(phi), 1]);
-          vertices.setAttribute(vertex, "uv", [u, v]);
-        }
-        vertex += 1;
-      }
-    }
-    const indices: number[] = [];
-    const stride = segments + 1;
-    for (let ring = 0; ring < rings; ring += 1) {
-      for (let segment = 0; segment < segments; segment += 1) {
-        const a = ring * stride + segment;
-        const b = a + stride;
-        indices.push(a, a + 1, b, a + 1, b + 1, b);
-      }
-    }
-    return new Geometry(vertices, new IndexBuffer(indices, vertexCount));
-  }
-
-  static cylinder(options: CylinderGeometryOptions = {}): Geometry {
-    const radius = options.radius ?? 0.5;
-    const height = options.height ?? 1;
-    const segments = options.segments ?? 48;
-    const capped = options.capped ?? true;
-    validatePositiveFinite(radius, "Cylinder radius");
-    validatePositiveFinite(height, "Cylinder height");
-    validateSegments(segments, "Cylinder segments", 3);
-    const half = height / 2;
-    const textured = options.textured === true;
-    const vertices: GeneratedVertex[] = [];
-    const indices: number[] = [];
-
-    for (let segment = 0; segment <= segments; segment += 1) {
-      const u = segment / segments;
-      const angle = u * Math.PI * 2;
-      const cos = Math.cos(angle);
-      const sin = Math.sin(angle);
-      const normal: Vec3 = [cos, 0, sin];
-      const tangent: Vec4 = [-sin, 0, cos, 1];
-      vertices.push(makeGeneratedVertex([cos * radius, -half, sin * radius], normal, [u, 0], tangent, textured));
-      vertices.push(makeGeneratedVertex([cos * radius, half, sin * radius], normal, [u, 1], tangent, textured));
-    }
-
-    for (let segment = 0; segment < segments; segment += 1) {
-      const base = segment * 2;
-      indices.push(base, base + 3, base + 2, base, base + 1, base + 3);
-    }
-
-    if (capped) {
-      const bottomCenter = vertices.length;
-      vertices.push(makeGeneratedVertex([0, -half, 0], [0, -1, 0], [0.5, 0.5], [1, 0, 0, 1], textured));
-      const bottomStart = vertices.length;
-      for (let segment = 0; segment <= segments; segment += 1) {
-        const u = segment / segments;
-        const angle = u * Math.PI * 2;
-        const cos = Math.cos(angle);
-        const sin = Math.sin(angle);
-        vertices.push(makeGeneratedVertex([cos * radius, -half, sin * radius], [0, -1, 0], [0.5 + cos * 0.5, 0.5 + sin * 0.5], [1, 0, 0, 1], textured));
-      }
-      for (let segment = 0; segment < segments; segment += 1) {
-        indices.push(bottomCenter, bottomStart + segment, bottomStart + segment + 1);
-      }
-
-      const topCenter = vertices.length;
-      vertices.push(makeGeneratedVertex([0, half, 0], [0, 1, 0], [0.5, 0.5], [1, 0, 0, 1], textured));
-      const topStart = vertices.length;
-      for (let segment = 0; segment <= segments; segment += 1) {
-        const u = segment / segments;
-        const angle = u * Math.PI * 2;
-        const cos = Math.cos(angle);
-        const sin = Math.sin(angle);
-        vertices.push(makeGeneratedVertex([cos * radius, half, sin * radius], [0, 1, 0], [0.5 + cos * 0.5, 0.5 + sin * 0.5], [1, 0, 0, 1], textured));
-      }
-      for (let segment = 0; segment < segments; segment += 1) {
-        indices.push(topCenter, topStart + segment + 1, topStart + segment);
-      }
-    }
-
-    return generatedGeometry(vertices, indices, textured);
-  }
-
-  static capsule(options: CapsuleGeometryOptions = {}): Geometry {
-    const radius = options.radius ?? 0.5;
-    const height = options.height ?? 1.8;
-    const segments = options.segments ?? 48;
-    const rings = options.rings ?? 12;
-    validatePositiveFinite(radius, "Capsule radius");
-    validatePositiveFinite(height, "Capsule height");
-    if (height < radius * 2) {
-      throw new Error("Capsule height must be at least diameter");
-    }
-    validateSegments(segments, "Capsule segments", 3);
-    validateSegments(rings, "Capsule rings", 2);
-    const cylinderHalf = height / 2 - radius;
-    const textured = options.textured === true;
-    const vertices: GeneratedVertex[] = [];
-    const indices: number[] = [];
-    const ringDescriptors: { readonly theta: number; readonly centerOffset: number }[] = [];
-
-    for (let ring = 0; ring <= rings; ring += 1) {
-      ringDescriptors.push({ theta: (ring / rings) * (Math.PI / 2), centerOffset: cylinderHalf });
-    }
-    for (let ring = 0; ring <= rings; ring += 1) {
-      ringDescriptors.push({ theta: Math.PI / 2 + (ring / rings) * (Math.PI / 2), centerOffset: -cylinderHalf });
-    }
-
-    ringDescriptors.forEach((descriptor, ringIndex) => {
-      const radial = Math.sin(descriptor.theta);
-      const yNormal = Math.cos(descriptor.theta);
-      const y = descriptor.centerOffset + yNormal * radius;
-      const v = ringIndex / Math.max(1, ringDescriptors.length - 1);
-      for (let segment = 0; segment <= segments; segment += 1) {
-        const u = segment / segments;
-        const angle = u * Math.PI * 2;
-        const cos = Math.cos(angle);
-        const sin = Math.sin(angle);
-        const normal: Vec3 = normalize3([cos * radial, yNormal, sin * radial]);
-        const tangent: Vec4 = [-sin, 0, cos, 1];
-        vertices.push(makeGeneratedVertex([cos * radial * radius, y, sin * radial * radius], normal, [u, v], tangent, textured));
-      }
-    });
-
-    const stride = segments + 1;
-    for (let ring = 0; ring < ringDescriptors.length - 1; ring += 1) {
-      for (let segment = 0; segment < segments; segment += 1) {
-        const a = ring * stride + segment;
-        const b = a + stride;
-        indices.push(a, a + 1, b, a + 1, b + 1, b);
-      }
-    }
-
-    return generatedGeometry(vertices, indices, textured);
-  }
-
-  static cube(size = 1): Geometry {
-    if (size <= 0) {
-      throw new Error("Cube size must be positive");
-    }
-    const half = size / 2;
-    const positions: readonly (readonly [number, number, number])[] = [
-      [-half, -half, -half],
-      [half, -half, -half],
-      [half, half, -half],
-      [-half, half, -half],
-      [-half, -half, half],
-      [half, -half, half],
-      [half, half, half],
-      [-half, half, half]
-    ];
-    const vertices = new VertexBuffer(VertexFormat.P3, positions.length);
-    positions.forEach((position, index) => vertices.setAttribute(index, "position", position));
-    const indices = [
-      0, 1, 2, 0, 2, 3,
-      4, 6, 5, 4, 7, 6,
-      0, 4, 5, 0, 5, 1,
-      1, 5, 6, 1, 6, 2,
-      2, 6, 7, 2, 7, 3,
-      3, 7, 4, 3, 4, 0
-    ];
-    return new Geometry(vertices, new IndexBuffer(indices, positions.length));
-  }
-
-  dispose(): void {
-    this.vertexBuffer.dispose();
-    this.indexBuffer?.dispose();
-  }
-}
-
-function validateWideLineSegment(segment: WideLineSegment, index: number): void {
-  if (segment.start.length !== 3 || segment.end.length !== 3) {
-    throw new Error(`Wide line segment ${index} endpoints must be vec3 values`);
-  }
-  if ([...segment.start, ...segment.end].some((value) => !Number.isFinite(value))) {
-    throw new Error(`Wide line segment ${index} endpoints must be finite`);
-  }
-  if (!Number.isFinite(segment.width) || segment.width <= 0) {
-    throw new Error(`Wide line segment ${index} width must be finite and positive`);
-  }
-  if (Math.hypot(
-    segment.end[0] - segment.start[0],
-    segment.end[1] - segment.start[1],
-    segment.end[2] - segment.start[2]
-  ) <= 1e-8) {
-    throw new Error(`Wide line segment ${index} must have non-zero length`);
-  }
-}
-
-export function computeBounds(vertexBuffer: VertexBuffer): Bounds3 {
-  if (!vertexBuffer.format.hasAttribute("position")) {
-    throw new Error("Cannot compute geometry bounds without position attribute");
-  }
-  const min: [number, number, number] = [Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY];
-  const max: [number, number, number] = [Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY];
-  for (let i = 0; i < vertexBuffer.vertexCount; i += 1) {
-    const [x = 0, y = 0, z = 0] = vertexBuffer.getAttribute(i, "position");
-    min[0] = Math.min(min[0], x);
-    min[1] = Math.min(min[1], y);
-    min[2] = Math.min(min[2], z);
-    max[0] = Math.max(max[0], x);
-    max[1] = Math.max(max[1], y);
-    max[2] = Math.max(max[2], z);
-  }
-  return { min, max };
-}
-
-type Vec2 = readonly [number, number];
-type Vec3 = readonly [number, number, number];
-type Vec4 = readonly [number, number, number, number];
-
-interface GeneratedVertex {
-  readonly position: Vec3;
-  readonly normal: Vec3;
-  readonly uv?: Vec2;
-  readonly tangent?: Vec4;
-}
-
-function generatedGeometry(vertices: readonly GeneratedVertex[], indices: readonly number[], textured: boolean): Geometry {
-  const format = textured ? VertexFormat.P3N3T4T2 : VertexFormat.P3N3;
-  const buffer = new VertexBuffer(format, vertices.length);
-  vertices.forEach((vertex, index) => {
-    buffer.setAttribute(index, "position", vertex.position);
-    buffer.setAttribute(index, "normal", vertex.normal);
-    if (textured) {
-      buffer.setAttribute(index, "tangent", vertex.tangent ?? [1, 0, 0, 1]);
-      buffer.setAttribute(index, "uv", vertex.uv ?? [0, 0]);
-    }
-  });
-  return new Geometry(buffer, new IndexBuffer([...indices], vertices.length));
-}
-
-function makeGeneratedVertex(position: Vec3, normal: Vec3, uv: Vec2, tangent: Vec4, textured: boolean): GeneratedVertex {
-  return textured ? { position, normal, uv, tangent } : { position, normal };
-}
-
-function validatePositiveFinite(value: number, label: string): void {
-  if (!Number.isFinite(value) || value <= 0) {
-    throw new Error(`${label} must be finite and positive`);
-  }
-}
-
-function validateSegments(value: number, label: string, minimum: number): void {
-  if (!Number.isInteger(value) || value < minimum) {
-    throw new Error(`${label} must be an integer >= ${minimum}`);
-  }
-}
-
-function normalize3(value: Vec3): Vec3 {
-  const length = Math.hypot(value[0], value[1], value[2]);
-  if (length <= 1e-8) return [0, 1, 0];
-  return [value[0] / length, value[1] / length, value[2] / length];
-}

package/src/GeometryPrimitives.ts

@@ -1,2 +0,0 @@
-export { Geometry } from "./Geometry";
-export type { CapsuleGeometryOptions, CylinderGeometryOptions, UVSphereGeometryOptions, WideLineSegment } from "./Geometry";

package/src/HDRRenderPipeline.ts

@@ -1,94 +0,0 @@
-import { RenderDeviceError, type RenderDevice, type RenderTarget } from "./RenderDevice";
-import { ToneMappingPass, type BloomOptions } from "./PostProcessPass";
-import { createExternalParityColorManagementPolicy, type A3DColorManagementPolicy } from "./ColorManagement";
-import { createExternalParityToneMappingPolicy, type ExternalParityToneMappingIntent, type ExternalParityToneMappingPolicy } from "./ToneMapping";
-
-export type ExternalParityHdrRenderTargetFormat = "rgba16f" | "rgba32f" | "rgba8";
-export type ExternalParityHdrPipelineMode = "hdr" | "ldr-fallback";
-
-export interface ExternalParityHdrPipelineDescriptor {
-  readonly width: number;
-  readonly height: number;
-  readonly intent?: ExternalParityToneMappingIntent;
-  readonly preferredFormat?: Extract<ExternalParityHdrRenderTargetFormat, "rgba16f" | "rgba32f">;
-  readonly allowLdrFallback?: boolean;
-  readonly bloom?: BloomOptions | false;
-}
-
-export interface ExternalParityHdrPipeline {
-  readonly mode: ExternalParityHdrPipelineMode;
-  readonly format: ExternalParityHdrRenderTargetFormat;
-  readonly colorTarget: RenderTarget;
-  readonly displayTarget: RenderTarget;
-  readonly colorManagement: A3DColorManagementPolicy;
-  readonly toneMapping: ExternalParityToneMappingPolicy;
-  readonly bloom: BloomOptions | false;
-  readonly warnings: readonly string[];
-}
-
-export function createExternalParityHdrPipeline(device: RenderDevice, descriptor: ExternalParityHdrPipelineDescriptor): ExternalParityHdrPipeline {
-  validateDimensions(descriptor.width, descriptor.height);
-  const colorManagement = createExternalParityColorManagementPolicy({
-    outputColorSpace: "srgb",
-    allowLdrFallback: descriptor.allowLdrFallback ?? true
-  });
-  const toneMapping = createExternalParityToneMappingPolicy(descriptor.intent ?? "product-catalog");
-  const capabilities = new Set(device.info.capabilities ?? []);
-  const supportsHdr = capabilities.has("hdr-render-targets") || device.kind === "mock";
-  const preferredFormat = descriptor.preferredFormat ?? "rgba16f";
-  const allowLdrFallback = descriptor.allowLdrFallback ?? true;
-  const format: ExternalParityHdrRenderTargetFormat = supportsHdr ? preferredFormat : "rgba8";
-  if (!supportsHdr && !allowLdrFallback) {
-    throw new RenderDeviceError("ExternalParity HDR pipeline requires HDR render targets or an explicit LDR fallback.", "EXTERNAL_PARITY_HDR_UNSUPPORTED", {
-      backend: device.kind
-    });
-  }
-
-  const colorTarget = device.createRenderTarget({
-    width: descriptor.width,
-    height: descriptor.height,
-    label: "external-parity-hdr-color",
-    format,
-    depth: "texture"
-  });
-  const displayTarget = device.createRenderTarget({
-    width: descriptor.width,
-    height: descriptor.height,
-    label: "external-parity-display-color",
-    format: "rgba8"
-  });
-
-  return {
-    mode: supportsHdr ? "hdr" : "ldr-fallback",
-    format,
-    colorTarget,
-    displayTarget,
-    colorManagement,
-    toneMapping,
-    bloom: descriptor.bloom ?? false,
-    warnings: supportsHdr
-      ? []
-      : ["Backend does not expose HDR render targets; using LDR fallback with linear lighting policy and explicit tone mapping."]
-  };
-}
-
-export function executeExternalParityToneMapPass(device: RenderDevice, pipeline: ExternalParityHdrPipeline): ToneMappingPass {
-  const pass = new ToneMappingPass({
-    source: pipeline.colorTarget,
-    target: pipeline.displayTarget,
-    exposure: pipeline.toneMapping.exposure,
-    whitePoint: pipeline.toneMapping.whitePoint,
-    gamma: pipeline.toneMapping.gamma,
-    operator: pipeline.toneMapping.operator,
-    inputColorSpace: pipeline.toneMapping.inputColorSpace,
-    outputColorSpace: pipeline.toneMapping.outputColorSpace
-  });
-  pass.execute({ device, width: pipeline.colorTarget.width, height: pipeline.colorTarget.height });
-  return pass;
-}
-
-function validateDimensions(width: number, height: number): void {
-  if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0) {
-    throw new Error("ExternalParity HDR pipeline dimensions must be positive integers.");
-  }
-}

package/src/IBL.ts

@@ -1,86 +0,0 @@
-import {
-  createEnvironmentMapResourceSet,
-  type EnvironmentMapResourceSet,
-  type LinearHdrEnvironmentMapSource
-} from "./EnvironmentMapResources";
-import { createExternalParityGeneratedHdrEnvironmentMapSource, type ExternalParityEnvironmentPreset } from "./ExternalParityRenderPreset";
-import { createExternalParityBrdfLut, type ExternalParityBrdfLut } from "./BRDFLut";
-import { createExternalParityPmrem, type ExternalParityPmrem } from "./PMREM";
-
-export interface ExternalParityIblOptions {
-  readonly preset: ExternalParityEnvironmentPreset;
-  readonly width?: number;
-  readonly height?: number;
-  readonly rotation?: number;
-  readonly intensity?: number;
-  readonly backgroundIntensity?: number;
-  readonly sourceQuality?: "bootstrap-generated" | "licensed-hdr";
-}
-
-export interface ExternalParityIblResourceSet {
-  readonly preset: ExternalParityEnvironmentPreset;
-  readonly source: LinearHdrEnvironmentMapSource;
-  readonly resources: EnvironmentMapResourceSet;
-  readonly pmrem: ExternalParityPmrem;
-  readonly brdfLut: ExternalParityBrdfLut;
-  readonly rotation: number;
-  readonly intensity: number;
-  readonly backgroundIntensity: number;
-  readonly diagnostics: {
-    readonly sourceQuality: "bootstrap-generated" | "licensed-hdr";
-    readonly notFlagshipProof: boolean;
-    readonly hdrSource: boolean;
-    readonly maxLinearValue: number;
-    readonly diffuseIrradiance: boolean;
-    readonly specularPrefilter: boolean;
-    readonly brdfLut: boolean;
-    readonly environmentRotation: boolean;
-    readonly environmentIntensity: boolean;
-    readonly backgroundSeparation: boolean;
-  };
-}
-
-export function createExternalParityIblResources(options: ExternalParityIblOptions): ExternalParityIblResourceSet {
-  const source = createExternalParityGeneratedHdrEnvironmentMapSource(options.preset, options.width ?? 128, options.height ?? 64);
-  const resources = createEnvironmentMapResourceSet({ ...source, encoding: "linear-hdr" }, {
-    outputColorSpace: "srgb",
-    exposure: 1,
-    toneMapping: "reinhard",
-    specularLevels: 6,
-    specularBlurRadius: 3,
-    irradianceWidth: 16,
-    irradianceHeight: 8,
-    irradianceBlurRadius: 8,
-    brdfLutSize: 64
-  });
-  const pmrem = createExternalParityPmrem(resources.base, {
-    levels: 6,
-    blurRadius: 3,
-    textureLabel: `external-parity-${options.preset}-pmrem`
-  });
-  const brdfLut = createExternalParityBrdfLut(64);
-  const sourceQuality = options.sourceQuality ?? "bootstrap-generated";
-
-  return {
-    preset: options.preset,
-    source,
-    resources,
-    pmrem,
-    brdfLut,
-    rotation: options.rotation ?? 0,
-    intensity: options.intensity ?? 1,
-    backgroundIntensity: options.backgroundIntensity ?? 0.35,
-    diagnostics: {
-      sourceQuality,
-      notFlagshipProof: sourceQuality !== "licensed-hdr",
-      hdrSource: resources.diagnostics.hdrSource,
-      maxLinearValue: resources.diagnostics.maxLinearValue,
-      diffuseIrradiance: resources.diffuseIrradiance.width > 0 && resources.diffuseIrradiance.height > 0,
-      specularPrefilter: resources.specularMipLevels.length >= 4 && pmrem.diagnostics.directionalReflectionReady,
-      brdfLut: brdfLut.diagnostics.nonZeroPixels > 0 && brdfLut.diagnostics.monotonicRoughnessTrend,
-      environmentRotation: Number.isFinite(options.rotation ?? 0),
-      environmentIntensity: Number.isFinite(options.intensity ?? 1) && (options.intensity ?? 1) > 0,
-      backgroundSeparation: Number.isFinite(options.backgroundIntensity ?? 0.35) && (options.backgroundIntensity ?? 0.35) !== (options.intensity ?? 1)
-    }
-  };
-}