@ifc-lite/renderer 2.0.1 → 2.2.0

package/dist/reference-image-pipeline.d.ts

@@ -0,0 +1,15 @@
+import type { ReferenceImageInput } from './reference-image-types.js';
+export interface ReferenceGpuImage {
+    input: ReferenceImageInput;
+    draw(pass: GPURenderPassEncoder, viewProj: Float32Array): void;
+    destroy(): void;
+}
+/** Owns only uploaded pixels and quad buffers; source bitmaps belong to the inventory. */
+export declare class ReferenceImagePipeline {
+    private device;
+    private pipeline;
+    private sampler;
+    constructor(device: GPUDevice, format: GPUTextureFormat, sampleCount: number);
+    upload(input: ReferenceImageInput): ReferenceGpuImage;
+}
+//# sourceMappingURL=reference-image-pipeline.d.ts.map

package/dist/reference-image-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-image-pipeline.d.ts","sourceRoot":"","sources":["../src/reference-image-pipeline.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAoBtE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,0FAA0F;AAC1F,qBAAa,sBAAsB;IAGrB,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,OAAO,CAAa;gBACR,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM;IAiBpF,MAAM,CAAC,KAAK,EAAE,mBAAmB,GAAG,iBAAiB;CA+CtD"}

package/dist/reference-image-pipeline.js

@@ -0,0 +1,104 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { PIPELINE_CONSTANTS } from './constants.js';
+const SHADER = `
+struct Uniforms { viewProj: mat4x4<f32>, clipOrigin: vec4<f32>, settings: vec4<f32> }
+@group(0) @binding(0) var<uniform> u: Uniforms;
+@group(0) @binding(1) var raster: texture_2d<f32>;
+@group(0) @binding(2) var rasterSampler: sampler;
+struct Vertex { @builtin(position) position: vec4<f32>, @location(0) uv: vec2<f32> }
+@vertex fn vs(@location(0) position: vec3<f32>, @location(1) uv: vec2<f32>) -> Vertex {
+  var out: Vertex;
+  out.position = u.viewProj * vec4<f32>(position, 0.0) + u.clipOrigin;
+  out.uv = uv; return out;
+}
+@fragment fn fs(v: Vertex) -> @location(0) vec4<f32> {
+  let pixel = textureSample(raster, rasterSampler, v.uv);
+  let alpha = pixel.a * u.settings.x;
+  if (alpha < 0.001) { discard; }
+  return vec4<f32>(pixel.rgb * alpha, alpha);
+}`;
+/** Owns only uploaded pixels and quad buffers; source bitmaps belong to the inventory. */
+export class ReferenceImagePipeline {
+    device;
+    pipeline;
+    sampler;
+    constructor(device, format, sampleCount) {
+        this.device = device;
+        const module = device.createShaderModule({ label: 'reference-image', code: SHADER });
+        this.pipeline = device.createRenderPipeline({ label: 'reference-image', layout: 'auto',
+            vertex: { module, entryPoint: 'vs', buffers: [{ arrayStride: 20, attributes: [
+                            { shaderLocation: 0, offset: 0, format: 'float32x3' }, { shaderLocation: 1, offset: 12, format: 'float32x2' },
+                        ] }] },
+            fragment: { module, entryPoint: 'fs', targets: [{ format, blend: {
+                            color: { srcFactor: 'one', dstFactor: 'one-minus-src-alpha', operation: 'add' },
+                            alpha: { srcFactor: 'one', dstFactor: 'one-minus-src-alpha', operation: 'add' },
+                        } }, { format: 'rgba8unorm', writeMask: 0 }] },
+            primitive: { topology: 'triangle-list', cullMode: 'none' },
+            depthStencil: { format: PIPELINE_CONSTANTS.DEPTH_FORMAT, depthWriteEnabled: false, depthCompare: 'greater-equal' },
+            multisample: { count: sampleCount },
+        });
+        this.sampler = device.createSampler({ minFilter: 'linear', magFilter: 'linear', addressModeU: 'clamp-to-edge', addressModeV: 'clamp-to-edge' });
+    }
+    upload(input) {
+        const { device } = this;
+        if (!input.id || !Number.isFinite(input.opacity) || input.opacity < 0 || input.opacity > 1 ||
+            input.corners.length !== 4 || input.corners.some(p => p.length !== 3 || p.some(n => !Number.isFinite(n)))) {
+            throw new Error('Reference image requires a stable ID, four finite corners and opacity between zero and one.');
+        }
+        if (input.bitmap.width < 1 || input.bitmap.height < 1 || Math.max(input.bitmap.width, input.bitmap.height) > device.limits.maxTextureDimension2D) {
+            throw new Error('Reference image exceeds this GPU’s image dimensions. Choose a lower raster resolution.');
+        }
+        const origin = input.corners[0];
+        const uv = [[0, 0], [1, 0], [1, 1], [0, 1]];
+        const vertices = new Float32Array([0, 1, 2, 0, 2, 3].flatMap(i => [
+            input.corners[i][0] - origin[0], input.corners[i][1] - origin[1], input.corners[i][2] - origin[2], ...uv[i],
+        ]));
+        if (vertices.some(n => !Number.isFinite(n)))
+            throw new Error('Reference dimensions exceed the renderable coordinate range.');
+        const resources = [];
+        try {
+            const texture = device.createTexture({ label: 'reference-image', size: [input.bitmap.width, input.bitmap.height], format: 'rgba8unorm',
+                usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST | GPUTextureUsage.RENDER_ATTACHMENT });
+            resources.push(texture);
+            device.queue.copyExternalImageToTexture({ source: input.bitmap }, { texture }, [input.bitmap.width, input.bitmap.height]);
+            const buffer = device.createBuffer({ size: vertices.byteLength, usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST });
+            resources.push(buffer);
+            device.queue.writeBuffer(buffer, 0, vertices);
+            const uniform = device.createBuffer({ size: 96, usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST });
+            resources.push(uniform);
+            const bind = device.createBindGroup({ layout: this.pipeline.getBindGroupLayout(0), entries: [
+                    { binding: 0, resource: { buffer: uniform } }, { binding: 1, resource: texture.createView() }, { binding: 2, resource: this.sampler },
+                ] });
+            const data = new Float32Array(24);
+            let destroyed = false;
+            return { input,
+                draw: (pass, viewProj) => {
+                    if (destroyed || !input.visible || input.opacity === 0)
+                        return;
+                    data.set(viewProj, 0);
+                    for (let row = 0; row < 4; row++)
+                        data[16 + row] = viewProj[row] * origin[0] + viewProj[4 + row] * origin[1] + viewProj[8 + row] * origin[2] + viewProj[12 + row];
+                    data[20] = input.opacity;
+                    device.queue.writeBuffer(uniform, 0, data);
+                    pass.setPipeline(this.pipeline);
+                    pass.setBindGroup(0, bind);
+                    pass.setVertexBuffer(0, buffer);
+                    pass.draw(6);
+                },
+                destroy: () => { if (!destroyed) {
+                    destroyed = true;
+                    for (const resource of resources)
+                        resource.destroy();
+                } },
+            };
+        }
+        catch (error) {
+            for (const resource of resources)
+                resource.destroy();
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=reference-image-pipeline.js.map

package/dist/reference-image-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-image-pipeline.js","sourceRoot":"","sources":["../src/reference-image-pipeline.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpD,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;EAgBb,CAAC;AAQH,0FAA0F;AAC1F,MAAM,OAAO,sBAAsB;IAGb;IAFZ,QAAQ,CAAoB;IAC5B,OAAO,CAAa;IAC5B,YAAoB,MAAiB,EAAE,MAAwB,EAAE,WAAmB;QAAhE,WAAM,GAAN,MAAM,CAAW;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACrF,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM;YACpF,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,UAAU,EAAE;4BAC3E,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;yBAC9G,EAAE,CAAC,EAAE;YACN,QAAQ,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;4BAC/D,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,SAAS,EAAE,KAAK,EAAE;4BAC/E,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,SAAS,EAAE,KAAK,EAAE;yBAChF,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE;YAC9C,SAAS,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE;YAC1D,YAAY,EAAE,EAAE,MAAM,EAAE,kBAAkB,CAAC,YAAY,EAAE,iBAAiB,EAAE,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE;YAClH,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;SACpC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,CAAC;IAClJ,CAAC;IAED,MAAM,CAAC,KAA0B;QAC/B,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC;YACxF,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5G,MAAM,IAAI,KAAK,CAAC,6FAA6F,CAAC,CAAC;QACjH,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACjJ,MAAM,IAAI,KAAK,CAAC,wFAAwF,CAAC,CAAC;QAC5G,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;SACtG,CAAC,CAAC,CAAC;QACJ,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC7H,MAAM,SAAS,GAA0B,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY;gBACpI,KAAK,EAAE,eAAe,CAAC,eAAe,GAAG,eAAe,CAAC,QAAQ,GAAG,eAAe,CAAC,iBAAiB,EAAE,CAAC,CAAC;YAC3G,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1H,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,cAAc,CAAC,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC1H,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC3G,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxB,MAAM,IAAI,GAAG,MAAM,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE;oBAC1F,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE;iBACtI,EAAE,CAAC,CAAC;YACL,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,OAAO,EAAE,KAAK;gBACZ,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE;oBACvB,IAAI,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC;wBAAE,OAAO;oBAC/D,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;oBACtB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE;wBAAE,IAAI,CAAC,EAAE,GAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAC,MAAM,CAAC,CAAC,CAAC,GAAC,QAAQ,CAAC,CAAC,GAAC,GAAG,CAAC,GAAC,MAAM,CAAC,CAAC,CAAC,GAAC,QAAQ,CAAC,CAAC,GAAC,GAAG,CAAC,GAAC,MAAM,CAAC,CAAC,CAAC,GAAC,QAAQ,CAAC,EAAE,GAAC,GAAG,CAAC,CAAC;oBAC9I,IAAI,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;oBACzB,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;oBAC3C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAAC,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;oBAAC,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;oBAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC7G,CAAC;gBACD,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;oBAAC,SAAS,GAAG,IAAI,CAAC;oBAAC,KAAK,MAAM,QAAQ,IAAI,SAAS;wBAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAAC,CAAC,CAAC,CAAC;aAC/G,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,MAAM,QAAQ,IAAI,SAAS;gBAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/reference-image-types.d.ts

@@ -0,0 +1,27 @@
+import type { PickOptions } from './types.js';
+export type ReferencePoint = readonly [number, number, number];
+/** Renderer Y-up coordinates, ordered top-left, top-right, bottom-right, bottom-left. */
+export type ReferenceCorners = readonly [ReferencePoint, ReferencePoint, ReferencePoint, ReferencePoint];
+export interface ReferenceImageInput {
+    /** Separate namespace: never an IFC Express ID or federation global ID. */
+    id: string;
+    bitmap: ImageBitmap;
+    corners: ReferenceCorners;
+    visible: boolean;
+    locked: boolean;
+    opacity: number;
+}
+export interface ReferenceImageHit {
+    referenceId: string;
+    point: ReferencePoint;
+    distance: number;
+}
+export interface ReferenceImages {
+    /** Borrows the bitmap for upload; the caller retains ownership of the source. */
+    set(input: ReferenceImageInput, signal?: AbortSignal): Promise<void>;
+    remove(id: string): void;
+    clear(): void;
+    /** CSS canvas coordinates; hidden, locked and scene-occluded references do not hit. */
+    pick(x: number, y: number, options?: PickOptions): Promise<ReferenceImageHit | null>;
+}
+//# sourceMappingURL=reference-image-types.d.ts.map

package/dist/reference-image-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-image-types.d.ts","sourceRoot":"","sources":["../src/reference-image-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/D,yFAAyF;AACzF,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;AACzG,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,GAAG,CAAC,KAAK,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;IACd,uFAAuF;IACvF,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACtF"}

package/dist/reference-image-types.js

@@ -0,0 +1,5 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+export {};
+//# sourceMappingURL=reference-image-types.js.map

package/dist/reference-image-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-image-types.js","sourceRoot":"","sources":["../src/reference-image-types.ts"],"names":[],"mappings":"AAAA;;+DAE+D"}

package/dist/reference-images.d.ts

@@ -0,0 +1,27 @@
+import type { Ray } from './raycaster.js';
+import type { PickOptions } from './types.js';
+import type { ReferenceImages, ReferenceImageInput, ReferenceImageHit } from './reference-image-types.js';
+export interface ReferenceImageHost {
+    requestRender(): void;
+    ray(x: number, y: number): Ray | null;
+    sceneDistance(x: number, y: number, ray: Ray, options?: PickOptions): Promise<number>;
+}
+/** String-identity resources separate from all IFC geometry and selection buckets. */
+export declare class ReferenceImageManager implements ReferenceImages {
+    private host;
+    private images;
+    private jobs;
+    private pipeline;
+    private device;
+    private format;
+    private sampleCount;
+    constructor(host: ReferenceImageHost);
+    init(device: GPUDevice, format: GPUTextureFormat, sampleCount: number): void;
+    set(input: ReferenceImageInput, signal?: AbortSignal): Promise<void>;
+    remove(id: string): void;
+    clear(): void;
+    destroy(): void;
+    draw(pass: GPURenderPassEncoder, viewProj: Float32Array): void;
+    pick(x: number, y: number, options?: PickOptions): Promise<ReferenceImageHit | null>;
+}
+//# sourceMappingURL=reference-images.d.ts.map

package/dist/reference-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-images.d.ts","sourceRoot":"","sources":["../src/reference-images.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAI1G,MAAM,WAAW,kBAAkB;IACjC,aAAa,IAAI,IAAI,CAAC;IACtB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC;IACtC,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvF;AAED,sFAAsF;AACtF,qBAAa,qBAAsB,YAAW,eAAe;IAO/C,OAAO,CAAC,IAAI;IANxB,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,WAAW,CAAK;gBACJ,IAAI,EAAE,kBAAkB;IAE5C,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAMtE,GAAG,CAAC,KAAK,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C1E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMxB,KAAK,IAAI,IAAI;IAMb,OAAO,IAAI,IAAI;IACf,IAAI,CAAC,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAYxD,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CAiB3F"}

package/dist/reference-images.js

@@ -0,0 +1,134 @@
+import { ReferenceImagePipeline } from './reference-image-pipeline.js';
+import { referenceImageHit } from './reference-image-hit.js';
+/** String-identity resources separate from all IFC geometry and selection buckets. */
+export class ReferenceImageManager {
+    host;
+    images = new Map();
+    jobs = new Map();
+    pipeline = null;
+    device = null;
+    format = 'bgra8unorm';
+    sampleCount = 1;
+    constructor(host) {
+        this.host = host;
+    }
+    init(device, format, sampleCount) {
+        this.destroy();
+        this.device = device;
+        this.format = format;
+        this.sampleCount = sampleCount;
+    }
+    async set(input, signal) {
+        const device = this.device;
+        if (!device)
+            throw new Error('The renderer is not ready for reference images.');
+        if (signal?.aborted)
+            return;
+        const current = this.images.get(input.id)?.input;
+        if (current?.bitmap === input.bitmap && current.visible === input.visible && current.locked === input.locked && current.opacity === input.opacity &&
+            current.corners.every((point, i) => point.every((n, axis) => n === input.corners[i][axis]))) {
+            // Also invalidate an older in-flight replacement of this unchanged image.
+            this.jobs.delete(input.id);
+            return;
+        }
+        // Snapshot caller geometry: changing a draft must never mutate an in-flight upload.
+        const captured = { ...input, corners: [
+                [...input.corners[0]], [...input.corners[1]], [...input.corners[2]], [...input.corners[3]],
+            ] };
+        const job = Symbol(input.id);
+        this.jobs.set(input.id, job);
+        device.pushErrorScope('out-of-memory');
+        device.pushErrorScope('validation');
+        let candidate;
+        let failure;
+        try {
+            // Ordinary IFC viewing creates no reference shader/pipeline or texture.
+            this.pipeline ??= new ReferenceImagePipeline(device, this.format, this.sampleCount);
+            candidate = this.pipeline.upload(captured);
+        }
+        catch (error) {
+            failure = error;
+        }
+        // Pop both scopes before awaiting: concurrent set calls must never consume
+        // one another's device-global scope stack.
+        const validationResult = device.popErrorScope(), memoryResult = device.popErrorScope();
+        try {
+            const [validation, memory] = await Promise.all([validationResult, memoryResult]);
+            if (validation || memory)
+                failure ??= new Error(`Reference image upload failed: ${(validation ?? memory).message}`);
+        }
+        catch (error) {
+            failure ??= error;
+        }
+        if (failure || signal?.aborted || this.jobs.get(input.id) !== job || this.device !== device) {
+            candidate?.destroy();
+            if (failure && this.device === device)
+                this.pipeline = null;
+            if (this.jobs.get(input.id) === job)
+                this.jobs.delete(input.id);
+            if (failure)
+                throw failure;
+            return;
+        }
+        this.jobs.delete(input.id);
+        if (!candidate)
+            throw new Error('Reference image upload produced no resource.');
+        this.images.get(input.id)?.destroy();
+        this.images.set(input.id, candidate);
+        this.host.requestRender();
+    }
+    remove(id) {
+        this.jobs.delete(id);
+        this.images.get(id)?.destroy();
+        this.images.delete(id);
+        this.host.requestRender();
+    }
+    clear() {
+        this.jobs.clear();
+        for (const image of this.images.values())
+            image.destroy();
+        this.images.clear();
+        this.host.requestRender();
+    }
+    destroy() { this.clear(); this.pipeline = null; this.device = null; }
+    draw(pass, viewProj) {
+        if (!this.images.size)
+            return;
+        const depth = (image) => {
+            const c = image.input.corners;
+            const x = (c[0][0] + c[2][0]) / 2, y = (c[0][1] + c[2][1]) / 2, z = (c[0][2] + c[2][2]) / 2;
+            return (viewProj[2] * x + viewProj[6] * y + viewProj[10] * z + viewProj[14]) /
+                (viewProj[3] * x + viewProj[7] * y + viewProj[11] * z + viewProj[15]);
+        };
+        // Reverse-Z, far to near for translucent references; BIM depth still tests
+        // each fragment. Intersecting transparent planes have ordinary alpha-sort limits.
+        for (const image of [...this.images.values()].sort((a, b) => depth(a) - depth(b)))
+            image.draw(pass, viewProj);
+    }
+    async pick(x, y, options) {
+        if (!this.images.size)
+            return null;
+        const ray = this.host.ray(x, y);
+        if (!ray)
+            return null;
+        const snapshot = new Map([...this.images].filter(([, image]) => image.input.visible && !image.input.locked && image.input.opacity > 0 &&
+            referenceImageHit(image.input.id, image.input.corners, ray, Infinity) !== null));
+        if (!snapshot.size)
+            return null;
+        let distance = await this.host.sceneDistance(x, y, ray, options), nearest = null;
+        for (const image of snapshot.values()) {
+            const { input } = image;
+            if (this.images.get(input.id) !== image)
+                continue;
+            if (!input.visible || input.locked || input.opacity === 0)
+                continue;
+            const hit = referenceImageHit(input.id, input.corners, ray, distance);
+            if (hit) {
+                nearest = hit;
+                distance = hit.distance;
+            }
+        }
+        return nearest;
+    }
+}
+//# sourceMappingURL=reference-images.js.map

package/dist/reference-images.js.map

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

package/dist/renderer-viewport.d.ts

@@ -0,0 +1,3 @@
+import type { Camera } from './camera.js';
+export declare function resizeRendererViewport(canvas: HTMLCanvasElement, camera: Camera, width: number, height: number): void;
+//# sourceMappingURL=renderer-viewport.d.ts.map

package/dist/renderer-viewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-viewport.d.ts","sourceRoot":"","sources":["../src/renderer-viewport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,CAoBN"}

package/dist/renderer-viewport.js

@@ -0,0 +1,20 @@
+export function resizeRendererViewport(canvas, camera, width, height) {
+    // `canvas.width` is an IDL `unsigned long`, so it silently coerces a
+    // non-finite or negative argument to **0** — a zero drawing buffer
+    // that every pick guard in this package misses, because they all
+    // check the bounding rect rather than the buffer. `unprojectToRay`
+    // then divides by it. This is documented public API of a published
+    // package (`docs/api/typescript.md`), so an external caller wiring a
+    // ResizeObserver to it is the reachable route; both in-repo callers
+    // already floor their own values. Keep the last usable size, the same
+    // policy `setAspect` uses for the ratio it derives (#2473).
+    if (!Number.isFinite(width) ||
+        !Number.isFinite(height) ||
+        width <= 0 ||
+        height <= 0)
+        return;
+    canvas.width = width;
+    canvas.height = height;
+    camera.setAspect(width / height);
+}
+//# sourceMappingURL=renderer-viewport.js.map

package/dist/renderer-viewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-viewport.js","sourceRoot":"","sources":["../src/renderer-viewport.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,sBAAsB,CACpC,MAAyB,EACzB,MAAc,EACd,KAAa,EACb,MAAc;IAEd,qEAAqE;IACrE,mEAAmE;IACnE,iEAAiE;IACjE,mEAAmE;IACnE,mEAAmE;IACnE,qEAAqE;IACrE,oEAAoE;IACpE,sEAAsE;IACtE,4DAA4D;IAC5D,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QACxB,KAAK,IAAI,CAAC;QACV,MAAM,IAAI,CAAC;QAEX,OAAO;IACT,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,SAAS,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;AACnC,CAAC"}

package/dist/rgba-texture-pool.d.ts

@@ -0,0 +1,12 @@
+import type { MeshTexture } from '@ifc-lite/geometry';
+/** Room recipients share decoded pixel arrays across surfaces (#4228, #4232).
+ * Keep that sharing on the GPU too; sampler settings belong to each draw. */
+export declare class RgbaTexturePool {
+    private entries;
+    private owners;
+    acquire(source: MeshTexture, device: GPUDevice): GPUTexture;
+    /** Return false only for textures owned by another allocation path. */
+    release(texture: GPUTexture): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=rgba-texture-pool.d.ts.map

package/dist/rgba-texture-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgba-texture-pool.d.ts","sourceRoot":"","sources":["../src/rgba-texture-pool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD;6EAC6E;AAC7E,qBAAa,eAAe;IAE1B,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,MAAM,CAA8D;IAE5E,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,GAAG,UAAU;IAyB3D,uEAAuE;IACvE,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO;IAYrC,KAAK,IAAI,IAAI;CAKd"}

package/dist/rgba-texture-pool.js

@@ -0,0 +1,51 @@
+/** Room recipients share decoded pixel arrays across surfaces (#4228, #4232).
+ * Keep that sharing on the GPU too; sampler settings belong to each draw. */
+export class RgbaTexturePool {
+    // GPU ownership must not keep released CPU pixel arrays alive.
+    entries = new WeakMap();
+    owners = new Map();
+    acquire(source, device) {
+        const { rgba, width, height } = source;
+        const entries = this.entries.get(rgba) ?? [];
+        let entry = entries.find(value => value.width === width && value.height === height);
+        if (!entry) {
+            const texture = device.createTexture({
+                size: { width, height }, format: 'rgba8unorm',
+                usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST,
+            });
+            try {
+                device.queue.writeTexture({ texture }, rgba, { bytesPerRow: width * 4, rowsPerImage: height }, { width, height });
+            }
+            catch (error) {
+                texture.destroy();
+                throw error;
+            }
+            entry = { texture, width, height, refs: 0 };
+            entries.push(entry);
+            this.entries.set(rgba, entries);
+            this.owners.set(texture, { siblings: entries, entry });
+        }
+        entry.refs++;
+        return entry.texture;
+    }
+    /** Return false only for textures owned by another allocation path. */
+    release(texture) {
+        const owner = this.owners.get(texture);
+        if (!owner)
+            return false;
+        if (--owner.entry.refs === 0) {
+            const siblings = owner.siblings;
+            siblings.splice(siblings.indexOf(owner.entry), 1);
+            this.owners.delete(texture);
+            texture.destroy();
+        }
+        return true;
+    }
+    clear() {
+        for (const texture of this.owners.keys())
+            texture.destroy();
+        this.owners.clear();
+        this.entries = new WeakMap();
+    }
+}
+//# sourceMappingURL=rgba-texture-pool.js.map

package/dist/rgba-texture-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgba-texture-pool.js","sourceRoot":"","sources":["../src/rgba-texture-pool.ts"],"names":[],"mappings":"AAOA;6EAC6E;AAC7E,MAAM,OAAO,eAAe;IAC1B,+DAA+D;IACvD,OAAO,GAAG,IAAI,OAAO,EAAuB,CAAC;IAC7C,MAAM,GAAG,IAAI,GAAG,EAAmD,CAAC;IAE5E,OAAO,CAAC,MAAmB,EAAE,MAAiB;QAC5C,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QACpF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC;gBACnC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY;gBAC7C,KAAK,EAAE,eAAe,CAAC,eAAe,GAAG,eAAe,CAAC,QAAQ;aAClE,CAAC,CAAC;YACH,IAAI,CAAC;gBACH,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EACzC,EAAE,WAAW,EAAE,KAAK,GAAG,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACzE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,KAAK,CAAC;YACd,CAAC;YACD,KAAK,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,uEAAuE;IACvE,OAAO,CAAC,OAAmB;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;YAChC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/dist/scene-appearance-buckets.d.ts

@@ -0,0 +1,41 @@
+import type { AppearanceOwner } from './appearance-preview.js';
+import type { MeshData } from '@ifc-lite/geometry';
+import type { BatchedMesh } from './types.js';
+export interface AppearanceBucket {
+    key: string;
+    meshData: MeshData[];
+    batchedMesh: BatchedMesh | null;
+    vertexBytes: number;
+}
+export interface AppearanceBucketAccess {
+    buckets: Map<string, AppearanceBucket>;
+    reverse(): Map<MeshData, AppearanceBucket>;
+    create(parts: MeshData[], key: string): BatchedMesh;
+    release(batch: BatchedMesh): void;
+    changed(key: string): void;
+    refresh(): void;
+}
+export interface FlatAppearanceResource {
+    bucket: AppearanceBucket;
+    partIndices: number[];
+}
+/** Partition shared batches before a draft owns GPU resources. Detached originals
+ * then contain exactly one owner, so another draft can cancel in any order. */
+export declare class AppearanceBuckets {
+    private readonly access;
+    private sequence;
+    private readonly cohorts;
+    constructor(access: AppearanceBucketAccess, parts: (id: number) => readonly MeshData[] | undefined);
+    private create;
+    capture(parts: readonly MeshData[]): FlatAppearanceResource[];
+    stage(parts: readonly MeshData[], indices: number[]): FlatAppearanceResource[];
+    detach(owner: number): void;
+    attach(resource: FlatAppearanceResource, parts: MeshData[]): void;
+    refresh(): void;
+    begin(owner: AppearanceOwner): void;
+    finish(owner: AppearanceOwner): void;
+    forget(expressId?: number): void;
+    private dispose;
+    release(resource: FlatAppearanceResource): void;
+}
+//# sourceMappingURL=scene-appearance-buckets.d.ts.map

package/dist/scene-appearance-buckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-appearance-buckets.d.ts","sourceRoot":"","sources":["../src/scene-appearance-buckets.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvC,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAC3C,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC;IACpD,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAClC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,IAAI,IAAI,CAAC;CACjB;AACD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;+EAC+E;AAC/E,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAE9B,MAAM,EAAE,sBAAsB,EAC/C,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,QAAQ,EAAE,GAAG,SAAS;IAIxD,OAAO,CAAC,MAAM;IAqBd,OAAO,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,sBAAsB,EAAE;IAqD7D,KAAK,CACH,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,OAAO,EAAE,MAAM,EAAE,GAChB,sBAAsB,EAAE;IA4B3B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAW3B,MAAM,CAAC,QAAQ,EAAE,sBAAsB,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAOjE,OAAO,IAAI,IAAI;IAGf,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAGnC,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAepC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAGhC,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;CAGhD"}