@ifc-lite/renderer 6.4.0 → 6.5.0

package/dist/section-cap-geometry.js.map

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

package/dist/section-cap-set.d.ts

@@ -0,0 +1,60 @@
+import type { ExtraClipPlane } from './clip-types.js';
+import { type CapHighlight, type CutPolygon2D, type DrawingLine2D, type SectionAxis, type SectionCustomPlane } from './section-2d-lift.js';
+import type { Section2DOverlayOptions } from './section-2d-types.js';
+/** What a cap draw borrows from `Section2DOverlayRenderer` for the duration of one frame. */
+export interface CapDrawResources {
+    device: GPUDevice;
+    fillPipeline: GPURenderPipeline;
+    fillDepthPipeline: GPURenderPipeline;
+    /** The outline pipeline that clips like the fill (not the shared world-line pipeline). */
+    outlinePipeline: GPURenderPipeline;
+    bindGroup: GPUBindGroup;
+    uniformBuffer: GPUBuffer;
+    uniformStride: number;
+    /** Group 1: one extra-clip block per cap, addressed by dynamic offset. */
+    clipBindGroup: GPUBindGroup;
+    clipBuffer: GPUBuffer;
+    clipStride: number;
+    lineColor: readonly [number, number, number, number];
+}
+/** One extra plane's cap to draw: its key and the planes that clip it. */
+export interface ExtraCapDraw {
+    key: string;
+    /** Every OTHER cutting plane (the primary one included), resolved in world space. */
+    clippedBy: readonly ExtraClipPlane[];
+}
+export declare class SectionCapSet {
+    private readonly primary;
+    private readonly extras;
+    private readonly uniforms;
+    private readonly clipScratch;
+    /** The elements whose cap is painted in a highlight colour; carried over every re-upload. */
+    private highlight;
+    /** Paint these elements' cap polygons in their colour on every cap; `null` clears. */
+    setHighlight(device: GPUDevice, highlight: CapHighlight | null): void;
+    /** Whether the primary cap has cached source, including geometry currently excluded. */
+    has(): boolean;
+    /** Whether an extra cap has cached source, including geometry currently excluded. */
+    hasExtras(): boolean;
+    /** The keys of the extra caps currently held. */
+    extraKeys(): string[];
+    upload(device: GPUDevice, key: string | null, ...args: [
+        CutPolygon2D[],
+        DrawingLine2D[],
+        SectionAxis,
+        number,
+        boolean,
+        SectionCustomPlane | undefined
+    ]): void;
+    /** Release the primary cap (`key` null) or one extra cap. */
+    clear(key: string | null): void;
+    /** Release every extra cap whose key is not in `keep`. */
+    clearExtrasExcept(keep: ReadonlySet<string>): void;
+    dispose(): void;
+    /** Draw the primary plane's cap, clipped by `clippedBy` (every extra cutting plane). */
+    draw(pass: GPURenderPassEncoder, res: CapDrawResources, options: Section2DOverlayOptions, clippedBy: readonly ExtraClipPlane[]): void;
+    /** Draw each listed extra plane's cap in its own uniform slot, with the cap style of the primary. */
+    drawExtras(pass: GPURenderPassEncoder, res: CapDrawResources, options: Section2DOverlayOptions, caps: readonly ExtraCapDraw[]): void;
+    private drawOne;
+}
+//# sourceMappingURL=section-cap-set.d.ts.map

package/dist/section-cap-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-cap-set.d.ts","sourceRoot":"","sources":["../src/section-cap-set.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAQtD,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,SAAS,CAAC;IAClB,YAAY,EAAE,iBAAiB,CAAC;IAChC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,0FAA0F;IAC1F,eAAe,EAAE,iBAAiB,CAAC;IACnC,SAAS,EAAE,YAAY,CAAC;IACxB,aAAa,EAAE,SAAS,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,aAAa,EAAE,YAAY,CAAC;IAC5B,UAAU,EAAE,SAAS,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACtD;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,qFAAqF;IACrF,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;CACtC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;IACxE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IACnE,6FAA6F;IAC7F,OAAO,CAAC,SAAS,CAA6B;IAE9C,sFAAsF;IACtF,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI;IAMrE,wFAAwF;IACxF,GAAG,IAAI,OAAO;IAEd,qFAAqF;IACrF,SAAS,IAAI,OAAO;IAKpB,iDAAiD;IACjD,SAAS,IAAI,MAAM,EAAE;IAErB,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,IAAI,EAAE;QACrD,YAAY,EAAE;QAAE,aAAa,EAAE;QAAE,WAAW;QAAE,MAAM;QAAE,OAAO;QAAE,kBAAkB,GAAG,SAAS;KAC9F,GAAG,IAAI;IAYR,6DAA6D;IAC7D,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAM/B,0DAA0D;IAC1D,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAIlD,OAAO,IAAI,IAAI;IAMf,wFAAwF;IACxF,IAAI,CACF,IAAI,EAAE,oBAAoB,EAC1B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,SAAS,cAAc,EAAE,GACnC,IAAI;IAIP,qGAAqG;IACrG,UAAU,CACR,IAAI,EAAE,oBAAoB,EAC1B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,uBAAuB,EAChC,IAAI,EAAE,SAAS,YAAY,EAAE,GAC5B,IAAI;IAUP,OAAO,CAAC,OAAO;CA4HhB"}

package/dist/section-cap-set.js

@@ -0,0 +1,212 @@
+/* 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/. */
+/**
+ * The section cut caps (#7545): one per cutting plane.
+ *
+ * `Section2DOverlayRenderer` used to hold exactly one cap's vertex and index
+ * buffers and draw it; with several cutting planes there is one cap per plane,
+ * each lying on its own plane and each removed where ANOTHER plane cuts it away.
+ * This holds the cap geometry and the draw, and borrows every shared GPU
+ * resource (pipelines, the uniform buffer, the bind groups) per draw, exactly as
+ * `WorldLineBuffer` does, so `Section2DOverlayRenderer` stays the single owner
+ * of what it creates in `init()` and destroys in `dispose()` (issue #2456).
+ *
+ * The primary plane's cap keeps the section-cut uniform slot it always had; each
+ * extra plane's cap has a slot of its own (`SECTION_2D_UNIFORM_SLOT_INDEX.extraCap`
+ * and up). Alongside each cap's uniform goes the block of planes that clip it
+ * (`extra-clip-planes.ts`): every other cutting plane, never its own.
+ */
+import { CapGeometry } from './section-cap-geometry.js';
+import { packExtraClip, EXTRA_CLIP_FLOATS } from './extra-clip-planes.js';
+import { tryPackRteDrawableDelta } from './relative-to-eye.js';
+import { SECTION_2D_MAX_EXTRA_CAPS, SECTION_2D_UNIFORM_FLOATS, SECTION_2D_UNIFORM_SLOTS, SECTION_2D_UNIFORM_SLOT_INDEX, } from './shaders/section-2d-overlay.wgsl.js';
+export class SectionCapSet {
+    primary = new CapGeometry();
+    extras = new Map();
+    uniforms = new Float32Array(SECTION_2D_UNIFORM_FLOATS);
+    clipScratch = new Float32Array(EXTRA_CLIP_FLOATS);
+    /** The elements whose cap is painted in a highlight colour; carried over every re-upload. */
+    highlight = null;
+    /** Paint these elements' cap polygons in their colour on every cap; `null` clears. */
+    setHighlight(device, highlight) {
+        this.highlight = highlight && highlight.size > 0 ? highlight : null;
+        this.primary.setHighlight(device, this.highlight);
+        for (const geometry of this.extras.values())
+            geometry.setHighlight(device, this.highlight);
+    }
+    /** Whether the primary cap has cached source, including geometry currently excluded. */
+    has() { return this.primary.has(); }
+    /** Whether an extra cap has cached source, including geometry currently excluded. */
+    hasExtras() {
+        for (const geometry of this.extras.values())
+            if (geometry.has())
+                return true;
+        return false;
+    }
+    /** The keys of the extra caps currently held. */
+    extraKeys() { return [...this.extras.keys()]; }
+    upload(device, key, ...args) {
+        if (key === null) {
+            this.primary.upload(device, this.highlight, ...args);
+            return;
+        }
+        // A plane past the capacity has no uniform slot to draw with.
+        if (!this.extras.has(key) && this.extras.size >= SECTION_2D_MAX_EXTRA_CAPS)
+            return;
+        let geometry = this.extras.get(key);
+        if (!geometry) {
+            geometry = new CapGeometry();
+            this.extras.set(key, geometry);
+        }
+        geometry.upload(device, this.highlight, ...args);
+    }
+    /** Release the primary cap (`key` null) or one extra cap. */
+    clear(key) {
+        if (key === null) {
+            this.primary.clear();
+            return;
+        }
+        this.extras.get(key)?.clear();
+        this.extras.delete(key);
+    }
+    /** Release every extra cap whose key is not in `keep`. */
+    clearExtrasExcept(keep) {
+        for (const key of [...this.extras.keys()])
+            if (!keep.has(key))
+                this.clear(key);
+    }
+    dispose() {
+        this.primary.clear();
+        for (const geometry of this.extras.values())
+            geometry.clear();
+        this.extras.clear();
+    }
+    /** Draw the primary plane's cap, clipped by `clippedBy` (every extra cutting plane). */
+    draw(pass, res, options, clippedBy) {
+        this.drawOne(pass, res, options, this.primary, SECTION_2D_UNIFORM_SLOT_INDEX.sectionCut, 0, clippedBy);
+    }
+    /** Draw each listed extra plane's cap in its own uniform slot, with the cap style of the primary. */
+    drawExtras(pass, res, options, caps) {
+        const keys = this.extraKeys();
+        for (const cap of caps) {
+            const geometry = this.extras.get(cap.key);
+            if (!geometry?.has())
+                continue;
+            const index = keys.indexOf(cap.key);
+            this.drawOne(pass, res, options, geometry, SECTION_2D_UNIFORM_SLOT_INDEX.extraCap + index, 1 + index, cap.clippedBy);
+        }
+    }
+    drawOne(pass, res, options, geometry, uniformSlot, clipSlot, clippedBy) {
+        geometry.setExclusions(res.device, this.highlight, options.sectionExcludedIds);
+        if (!geometry.hasDrawable())
+            return;
+        const { viewProj } = options;
+        // No offset — cap renders exactly on the section plane. The previous
+        // 0.3m bias was there to keep the outline lines clear of below-plane
+        // geometry, but it made the cap visually drift off the slider plane
+        // (users could see a 0.3m gap between the plane preview and the cap).
+        // The fill pipeline uses depthCompare 'greater-equal' (reverse-Z) so the
+        // cap ties cleanly with coincident below-plane top faces and is occluded
+        // by nearer model geometry — see the depthStencil comment in
+        // `section-cap-pipelines.ts`. There is no stencil test; the fill is restricted
+        // to the actual cap polygons by the triangle-plane intersection geometry
+        // `SectionCutter` produces, not by a stencil gate.
+        // Cap vertices are stored relative to the anchor so that the RTE path can
+        // retain their small in-plane residuals. The legacy view-projection path
+        // still transforms world coordinates, however, so it must add that anchor
+        // back through planeOffset. Leaving it zero placed every rebased legacy
+        // cap around the world origin. Do not combine the two: RTE adds this same
+        // anchor as an f64 split drawable delta below.
+        const anchor = geometry.anchor;
+        const rteViewProj = options.rteViewProj;
+        const rteCamera = options.rteCamera;
+        const rte = anchor !== null && rteViewProj !== undefined && rteCamera !== undefined;
+        const offset = anchor === null || rte ? [0, 0, 0] : anchor;
+        // Field offsets come from SECTION_2D_UNIFORM_SLOTS, which sits next to the
+        // WGSL struct it describes.
+        const S = SECTION_2D_UNIFORM_SLOTS;
+        const uniforms = this.uniforms;
+        uniforms.fill(0);
+        uniforms.set(viewProj, S.viewProj);
+        if (rte) {
+            uniforms.set(rteViewProj, S.rteViewProj);
+            // Outside this camera's RTE envelope: the cap and its outline, the only
+            // draws below, are not rasterisable this frame (#6128).
+            if (!tryPackRteDrawableDelta(anchor, rteCamera, uniforms, S.originDeltaHigh))
+                return;
+            uniforms[S.originDeltaHigh + 3] = 1;
+        }
+        uniforms.set(res.lineColor, S.lineColor); // section-cut outline colour
+        uniforms[S.planeOffset + 0] = offset[0];
+        uniforms[S.planeOffset + 1] = offset[1];
+        uniforms[S.planeOffset + 2] = offset[2];
+        const cs = options.capStyle;
+        if (cs) {
+            uniforms.set(cs.fillColor, S.capFillColor);
+            uniforms.set(cs.strokeColor, S.capStrokeColor);
+            uniforms[S.params + 0] = cs.patternId;
+            uniforms[S.params + 1] = cs.spacingPx;
+            uniforms[S.params + 2] = cs.angleRad;
+            uniforms[S.params + 3] = cs.widthPx;
+            uniforms[S.params2 + 0] = cs.secondaryAngleRad;
+        }
+        else {
+            // Sensible defaults when caller omits style (e.g. legacy lines-only
+            // use): solid fill using a warm-paper colour, no hatch.
+            uniforms.set([0.92, 0.88, 0.78, 1], S.capFillColor);
+            uniforms.set([0.10, 0.10, 0.10, 1], S.capStrokeColor);
+            uniforms[S.params + 0] = 0; // solid pattern
+            uniforms[S.params + 1] = 8;
+            uniforms[S.params + 2] = Math.PI / 4;
+            uniforms[S.params + 3] = 1;
+            uniforms[S.params2 + 0] = -Math.PI / 4;
+        }
+        // Each cap owns its slot. Both draws below read it, which is correct: the
+        // fill and the outline are one drawing with one plane offset and one style.
+        // What they must NOT share is the record the world-space line families
+        // write, whose zeroed cap-style tail would otherwise arrive here.
+        // The planes that remove this cap's fragments, in the frame the shader works in
+        // (eye-relative on the RTE path, world otherwise). Written first: the cap's own
+        // uniform record stays the last write of the draw.
+        packExtraClip(clippedBy, rte ? rteCamera : null, this.clipScratch, 0);
+        const clipOffset = clipSlot * res.clipStride;
+        res.device.queue.writeBuffer(res.clipBuffer, clipOffset, this.clipScratch);
+        const uniformOffset = uniformSlot * res.uniformStride;
+        res.device.queue.writeBuffer(res.uniformBuffer, uniformOffset, uniforms);
+        // Filled polygons = the 3D section cap. Render them ONLY when the
+        // caller opts in (`showFills: true` + a capStyle). This replaces the
+        // old stencil-parity cap, which leaked hatch into empty sky on non-
+        // manifold IFC geometry. The polygons here come from exact triangle-
+        // plane intersection in `SectionCutter`, so the silhouette is
+        // mathematically correct.
+        if (options.showFills === true &&
+            options.capStyle &&
+            geometry.fillVertexBuffer &&
+            geometry.fillIndexBuffer &&
+            geometry.fillIndexCount > 0) {
+            pass.setPipeline(res.fillPipeline);
+            pass.setBindGroup(0, res.bindGroup, [uniformOffset]);
+            pass.setBindGroup(1, res.clipBindGroup, [clipOffset]);
+            pass.setVertexBuffer(0, geometry.fillVertexBuffer);
+            pass.setIndexBuffer(geometry.fillIndexBuffer, 'uint32');
+            pass.drawIndexed(geometry.fillIndexCount);
+            // Then its depth, colour-masked, for the post passes (section-cap-pipelines.ts).
+            pass.setPipeline(res.fillDepthPipeline);
+            pass.drawIndexed(geometry.fillIndexCount);
+        }
+        // Outline lines on top of the fill. Gated by `showOutlines` so the
+        // user can toggle surfaces and outlines independently from the UI.
+        // Defaults to true when the caller omits the flag.
+        if (options.showOutlines !== false &&
+            geometry.lineVertexBuffer &&
+            geometry.lineVertexCount > 0) {
+            pass.setPipeline(res.outlinePipeline);
+            pass.setBindGroup(0, res.bindGroup, [uniformOffset]);
+            pass.setBindGroup(1, res.clipBindGroup, [clipOffset]);
+            pass.setVertexBuffer(0, geometry.lineVertexBuffer);
+            pass.draw(geometry.lineVertexCount);
+        }
+    }
+}
+//# sourceMappingURL=section-cap-set.js.map

package/dist/section-cap-set.js.map

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

package/dist/section-cap-style.d.ts

@@ -25,6 +25,9 @@ export declare const HATCH_PATTERN_IDS: {
 };
 export type HatchPatternId = keyof typeof HATCH_PATTERN_IDS;
 export interface SectionCapStyle {
+    /** Cap fill source preference, persisted with the style. The renderer does not read it: the app's cap conversion (`capOverlayInput`)
+     *  uses it to give each polygon its element colour (`'element'`) or leave it to the uniform fill (`'uniform'`, default). */
+    fillMode?: 'uniform' | 'element';
     fillColor: [number, number, number, number];
     strokeColor: [number, number, number, number];
     pattern: HatchPatternId;

package/dist/section-cap-style.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"section-cap-style.d.ts","sourceRoot":"","sources":["../src/section-cap-style.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;CASpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,WAAW,EAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,OAAO,EAAY,cAAc,CAAC;IAClC,SAAS,EAAU,MAAM,CAAC;IAC1B,QAAQ,EAAW,MAAM,CAAC;IAC1B,OAAO,EAAY,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,iBAAiB,EAAE,eAQ/B,CAAC"}
+{"version":3,"file":"section-cap-style.d.ts","sourceRoot":"","sources":["../src/section-cap-style.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;CASpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B;gIAC4H;IAC5H,QAAQ,CAAC,EAAU,SAAS,GAAG,SAAS,CAAC;IACzC,SAAS,EAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,WAAW,EAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,OAAO,EAAY,cAAc,CAAC;IAClC,SAAS,EAAU,MAAM,CAAC;IAC1B,QAAQ,EAAW,MAAM,CAAC;IAC1B,OAAO,EAAY,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,iBAAiB,EAAE,eAQ/B,CAAC"}

package/dist/section-cap-style.js.map

@@ -1 +1 @@
-{"version":3,"file":"section-cap-style.js","sourceRoot":"","sources":["../src/section-cap-style.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;GAcG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAQ,CAAC;IACd,QAAQ,EAAK,CAAC;IACd,UAAU,EAAG,CAAC;IACd,UAAU,EAAG,CAAC;IACd,QAAQ,EAAK,CAAC;IACd,QAAQ,EAAK,CAAC;IACd,KAAK,EAAQ,CAAC;IACd,UAAU,EAAG,CAAC;CACN,CAAC;AAcX,MAAM,CAAC,MAAM,iBAAiB,GAAoB;IAChD,SAAS,EAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAG,aAAa;IAC1D,WAAW,EAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAG,MAAM;IACnD,OAAO,EAAY,UAAU;IAC7B,SAAS,EAAU,CAAC;IACpB,QAAQ,EAAW,IAAI,CAAC,EAAE,GAAG,CAAC,EAAe,MAAM;IACnD,OAAO,EAAY,GAAG;IACtB,iBAAiB,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC;CAChC,CAAC"}
+{"version":3,"file":"section-cap-style.js","sourceRoot":"","sources":["../src/section-cap-style.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;GAcG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAQ,CAAC;IACd,QAAQ,EAAK,CAAC;IACd,UAAU,EAAG,CAAC;IACd,UAAU,EAAG,CAAC;IACd,QAAQ,EAAK,CAAC;IACd,QAAQ,EAAK,CAAC;IACd,KAAK,EAAQ,CAAC;IACd,UAAU,EAAG,CAAC;CACN,CAAC;AAiBX,MAAM,CAAC,MAAM,iBAAiB,GAAoB;IAChD,SAAS,EAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAG,aAAa;IAC1D,WAAW,EAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,EAAG,MAAM;IACnD,OAAO,EAAY,UAAU;IAC7B,SAAS,EAAU,CAAC;IACpB,QAAQ,EAAW,IAAI,CAAC,EAAE,GAAG,CAAC,EAAe,MAAM;IACnD,OAAO,EAAY,GAAG;IACtB,iBAAiB,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC;CAChC,CAAC"}

package/dist/section-cap-upload.d.ts

@@ -0,0 +1,16 @@
+import type { Section2DOverlayRenderer, CutPolygon2D, DrawingLine2D } from './section-2d-overlay.js';
+import type { ModelBounds } from './render-section-draw.js';
+type CustomPlane = {
+    origin: [number, number, number];
+    tangent: [number, number, number];
+    bitangent: [number, number, number];
+};
+/** True when overlay geometry changed (the caller then asks for a frame); false for the early returns that leave it untouched. */
+export declare function uploadSectionCap(overlay: Section2DOverlayRenderer, modelBounds: ModelBounds | null, planeId: string | undefined, polygons: CutPolygon2D[], lines: DrawingLine2D[], axis: 'down' | 'front' | 'side', position: number, // 0-100 percentage
+sectionRange: {
+    min?: number;
+    max?: number;
+} | undefined, // Same storey-based range as section plane
+flipped: boolean, customPlane?: CustomPlane): boolean;
+export {};
+//# sourceMappingURL=section-cap-upload.d.ts.map

package/dist/section-cap-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-cap-upload.d.ts","sourceRoot":"","sources":["../src/section-cap-upload.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACrG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,KAAK,WAAW,GAAG;IAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAEhI,kIAAkI;AAClI,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,wBAAwB,EACjC,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,YAAY,EAAE,EACxB,KAAK,EAAE,aAAa,EAAE,EACtB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAC/B,QAAQ,EAAE,MAAM,EAAE,mBAAmB;AACrC,YAAY,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAAE,2CAA2C;AACrG,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAuCT"}

package/dist/section-cap-upload.js

@@ -0,0 +1,52 @@
+/* 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/. */
+/**
+ * Where a section cap's 2D drawing lands in 3D (`Renderer.uploadSection2DOverlay`),
+ * lifted out of `RendererOverlays`: the cardinal drawing is lifted onto an
+ * axis-aligned plane at a world coordinate derived from the slider percentage and
+ * the SAME range formula the clip plane uses, and a face-picked plane carries its
+ * own basis. `planeId` keys the cap of a cutting plane beyond the first (#7545);
+ * without it the primary plane's cap is replaced, as it always was.
+ */
+import { projectedBoundsRange } from './section-plane-resolve.js';
+/** True when overlay geometry changed (the caller then asks for a frame); false for the early returns that leave it untouched. */
+export function uploadSectionCap(overlay, modelBounds, planeId, polygons, lines, axis, position, // 0-100 percentage
+sectionRange, // Same storey-based range as section plane
+flipped, customPlane) {
+    const upload = (planePosition, custom) => (planeId === undefined
+        ? overlay.uploadDrawing(polygons, lines, axis, planePosition, flipped, custom)
+        : overlay.uploadExtraDrawing(planeId, polygons, lines, axis, planePosition, flipped, custom));
+    if (customPlane) {
+        // Custom-plane path: planePosition / axis are unused — the
+        // basis the cap shader needs travels in `customPlane`. We pass
+        // 0 for `planePosition` and the existing `axis` so the cardinal
+        // shader code path that callers depend on (e.g. legacy SVG
+        // export) keeps working when customPlane is omitted.
+        upload(0, customPlane);
+        return true;
+    }
+    // Same range formula as the clip plane (`resolveSectionPlaneFrame`),
+    // shared rather than copied — but deliberately evaluated against the
+    // UN-ROTATED axis normal, which is what makes the two agree instead of
+    // merely look alike (#2447).
+    //
+    // `planePosition` is not a plane distance here: `transform2Dto3D` lifts
+    // the cardinal drawing onto an AXIS-ALIGNED plane at that world
+    // coordinate (`side` -> `[planePosition, y, x]`), and the polygons it
+    // lifts were cut on that same axis-aligned plane upstream. Feeding it
+    // the rotated plane's distance would move the cap off the geometry it
+    // was cut from. A rotated or face-picked plane reaches the cap through
+    // `customPlane` above, which carries its own basis.
+    const axisNormal = axis === 'side' ? [1, 0, 0] : axis === 'down' ? [0, 1, 0] : [0, 0, 1];
+    // Allow upload if either sectionRange has both values, or modelBounds exists as fallback
+    const hasFullRange = sectionRange?.min !== undefined && sectionRange?.max !== undefined;
+    if (!hasFullRange && !modelBounds)
+        return false;
+    const axisRange = modelBounds ? projectedBoundsRange(modelBounds.min, modelBounds.max, axisNormal) : null;
+    const minVal = sectionRange?.min ?? axisRange.min;
+    const maxVal = sectionRange?.max ?? axisRange.max;
+    upload(minVal + (position / 100) * (maxVal - minVal));
+    return true;
+}
+//# sourceMappingURL=section-cap-upload.js.map

package/dist/section-cap-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-cap-upload.js","sourceRoot":"","sources":["../src/section-cap-upload.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAMlE,kIAAkI;AAClI,MAAM,UAAU,gBAAgB,CAC9B,OAAiC,EACjC,WAA+B,EAC/B,OAA2B,EAC3B,QAAwB,EACxB,KAAsB,EACtB,IAA+B,EAC/B,QAAgB,EAAE,mBAAmB;AACrC,YAAwD,EAAE,2CAA2C;AACrG,OAAgB,EAChB,WAAyB;IAEzB,MAAM,MAAM,GAAG,CAAC,aAAqB,EAAE,MAAoB,EAAQ,EAAE,CAAC,CAAC,OAAO,KAAK,SAAS;QAC1F,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC;QAC9E,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAEhG,IAAI,WAAW,EAAE,CAAC;QAChB,2DAA2D;QAC3D,+DAA+D;QAC/D,gEAAgE;QAChE,2DAA2D;QAC3D,qDAAqD;QACrD,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qEAAqE;IACrE,qEAAqE;IACrE,uEAAuE;IACvE,6BAA6B;IAC7B,EAAE;IACF,wEAAwE;IACxE,gEAAgE;IAChE,sEAAsE;IACtE,sEAAsE;IACtE,sEAAsE;IACtE,uEAAuE;IACvE,oDAAoD;IACpD,MAAM,UAAU,GACd,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAExE,yFAAyF;IACzF,MAAM,YAAY,GAAG,YAAY,EAAE,GAAG,KAAK,SAAS,IAAI,YAAY,EAAE,GAAG,KAAK,SAAS,CAAC;IACxF,IAAI,CAAC,YAAY,IAAI,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAEhD,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,oBAAoB,CAAC,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1G,MAAM,MAAM,GAAG,YAAY,EAAE,GAAG,IAAI,SAAU,CAAC,GAAG,CAAC;IACnD,MAAM,MAAM,GAAG,YAAY,EAAE,GAAG,IAAI,SAAU,CAAC,GAAG,CAAC;IACnD,MAAM,CAAC,MAAM,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/section-exclusions.d.ts

@@ -0,0 +1,26 @@
+import type { PickClipState } from './pick-types.js';
+/** All section planes are exempted together; the crop box remains independent (#8015). */
+export declare function entityClip(clip: PickClipState | null | undefined, id: number): PickClipState | null | undefined;
+/** Sorted full scene ids: count followed by keys. No 24-bit aliasing across models. */
+export declare function sectionExclusionImage(ids?: ReadonlySet<number> | null): Uint32Array;
+export declare function sectionExclusions(device: GPUDevice): SectionExclusions;
+export declare function withSectionExclusions(device: GPUDevice, layouts: GPUBindGroupLayout[]): GPUBindGroupLayout[];
+declare class SectionExclusions {
+    private device;
+    readonly layout: GPUBindGroupLayout;
+    buffer: GPUBuffer;
+    bindGroup: GPUBindGroup;
+    private snapshot;
+    private owners;
+    private bytes;
+    constructor(device: GPUDevice);
+    retain(): void;
+    release(): void;
+    private allocate;
+    private bind;
+    update(ids?: ReadonlySet<number> | null): void;
+}
+/** Binary search is bounded by log2(count); the empty default reads just the count. */
+export declare const sectionExclusionsWgsl = "\n@group(3) @binding(0) var<storage, read> sectionExcludedIds: array<u32>;\n// Scene colour buckets are partitioned by 2^24 ID page. Reject an invalid anchor.\nfn sectionEntityFromLane(anchor: u32, lane: u32) -> u32 {\n  return select(anchor + ((lane - anchor) & 0x00FFFFFFu), 0xFFFFFFFFu, anchor == 0xFFFFFFFFu);\n}\nfn sectionExcluded(id: u32) -> bool {\n  var lo = 0u;\n  var hi = sectionExcludedIds[0];\n  while (lo < hi) {\n    let mid = lo + (hi - lo) / 2u;\n    let key = sectionExcludedIds[mid + 1u];\n    if (key == id) { return true; }\n    if (key < id) { lo = mid + 1u; } else { hi = mid; }\n  }\n  return false;\n}\n";
+export {};
+//# sourceMappingURL=section-exclusions.d.ts.map

package/dist/section-exclusions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-exclusions.d.ts","sourceRoot":"","sources":["../src/section-exclusions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,GAAG,SAAS,CAE/G;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,WAAW,CAKnF;AAKD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,iBAAiB,CAItE;AACD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAG5G;AACD,cAAM,iBAAiB;IAOT,OAAO,CAAC,MAAM;IAN1B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,KAAK,CAAK;gBACE,MAAM,EAAE,SAAS;IAKrC,MAAM,IAAI,IAAI;IACd,OAAO,IAAI,IAAI;IAGf,OAAO,CAAC,QAAQ;IAGhB,OAAO,CAAC,IAAI;IAGZ,MAAM,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI;CAY/C;AAED,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,0nBAiBjC,CAAC"}

package/dist/section-exclusions.js

@@ -0,0 +1,95 @@
+/* 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/. */
+/** All section planes are exempted together; the crop box remains independent (#8015). */
+export function entityClip(clip, id) {
+    return clip?.sectionExcludedIds?.has(id) ? { clipBox: clip.clipBox } : clip;
+}
+/** Sorted full scene ids: count followed by keys. No 24-bit aliasing across models. */
+export function sectionExclusionImage(ids) {
+    const keys = [...(ids ?? [])].filter(id => Number.isInteger(id) && id >= 0 && id < 0xFFFFFFFF).sort((a, b) => a - b);
+    const image = new Uint32Array(keys.length + 1);
+    image[0] = keys.length;
+    image.set(keys, 1);
+    return image;
+}
+// One table per device submission, shared by colour, masks, shadow and picking.
+// Owners retain/release it; mask passes borrow it while the renderer is alive.
+const tables = new WeakMap();
+export function sectionExclusions(device) {
+    let table = tables.get(device);
+    if (!table) {
+        table = new SectionExclusions(device);
+        tables.set(device, table);
+    }
+    return table;
+}
+export function withSectionExclusions(device, layouts) {
+    while (layouts.length < 3)
+        layouts.push(device.createBindGroupLayout({ entries: [] }));
+    return [...layouts, sectionExclusions(device).layout];
+}
+class SectionExclusions {
+    device;
+    layout;
+    buffer;
+    bindGroup;
+    snapshot = new Set();
+    owners = 0;
+    bytes = 4;
+    constructor(device) {
+        this.device = device;
+        this.layout = device.createBindGroupLayout({ entries: [{ binding: 0, visibility: GPUShaderStage.FRAGMENT, buffer: { type: 'read-only-storage' } }] });
+        this.buffer = this.allocate(4);
+        this.bindGroup = this.bind();
+    }
+    retain() { this.owners++; }
+    release() {
+        if (--this.owners === 0) {
+            this.buffer.destroy();
+            tables.delete(this.device);
+        }
+    }
+    allocate(size) {
+        return this.device.createBuffer({ label: 'section-excluded-ids', size, usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST });
+    }
+    bind() {
+        return this.device.createBindGroup({ layout: this.layout, entries: [{ binding: 0, resource: { buffer: this.buffer } }] });
+    }
+    update(ids) {
+        if (this.snapshot.size === (ids?.size ?? 0) && [...this.snapshot].every(id => ids?.has(id)))
+            return;
+        const image = sectionExclusionImage(ids);
+        const limit = Math.min(this.device.limits.maxStorageBufferBindingSize ?? 134217728, this.device.limits.maxBufferSize ?? 268435456);
+        if (image.byteLength > limit)
+            throw new RangeError('Section exclusions exceed the GPU storage buffer limit');
+        if (image.byteLength > this.bytes) {
+            this.buffer.destroy();
+            this.bytes = image.byteLength;
+            this.buffer = this.allocate(this.bytes);
+            this.bindGroup = this.bind();
+        }
+        this.device.queue.writeBuffer(this.buffer, 0, image);
+        this.snapshot = new Set(ids);
+    }
+}
+/** Binary search is bounded by log2(count); the empty default reads just the count. */
+export const sectionExclusionsWgsl = `
+@group(3) @binding(0) var<storage, read> sectionExcludedIds: array<u32>;
+// Scene colour buckets are partitioned by 2^24 ID page. Reject an invalid anchor.
+fn sectionEntityFromLane(anchor: u32, lane: u32) -> u32 {
+  return select(anchor + ((lane - anchor) & 0x00FFFFFFu), 0xFFFFFFFFu, anchor == 0xFFFFFFFFu);
+}
+fn sectionExcluded(id: u32) -> bool {
+  var lo = 0u;
+  var hi = sectionExcludedIds[0];
+  while (lo < hi) {
+    let mid = lo + (hi - lo) / 2u;
+    let key = sectionExcludedIds[mid + 1u];
+    if (key == id) { return true; }
+    if (key < id) { lo = mid + 1u; } else { hi = mid; }
+  }
+  return false;
+}
+`;
+//# sourceMappingURL=section-exclusions.js.map

package/dist/section-exclusions.js.map

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

package/dist/section-plane-frames.d.ts

@@ -0,0 +1,48 @@
+import type { SectionPlane } from './types.js';
+type Xyz = {
+    x: number;
+    y: number;
+    z: number;
+};
+/** One section plane in world space. */
+export interface SectionPlaneFrame {
+    /** The plane's `id`, when it has one (the primary plane's too). */
+    id: string | null;
+    /** True for `RenderOptions.sectionPlane`; false for an entry of `extraSectionPlanes`. */
+    primary: boolean;
+    enabled: boolean;
+    flipped: boolean;
+    /** Unit normal, and `dot(p, normal) = distance` on the plane. */
+    normal: [number, number, number];
+    distance: number;
+    /** The model's centre projected onto the plane: where a handle sits. */
+    anchor: [number, number, number];
+    /**
+     * A square on the plane the clip uses (centred on `anchor`, sized from the model bounds), in winding
+     * order. It lies in the clipping plane exactly; the drawn preview quad of a rotated cardinal plane
+     * is axis-aligned instead, so place marks from `anchor` and the plane, not by matching that quad.
+     */
+    corners: [[number, number, number], [number, number, number], [number, number, number], [number, number, number]];
+}
+/** The inputs a frame was resolved from, kept by the renderer for the next query. */
+export interface SectionFrameInput {
+    primary: SectionPlane | null;
+    extras: readonly SectionPlane[];
+    bounds: {
+        min: Xyz;
+        max: Xyz;
+    };
+    buildingRotation: number | undefined;
+}
+/** The anchor and quad of `dot(p, normal) = distance` across `bounds`, matching the preview quad's size. */
+export declare function planeFrameGeometry(normal: readonly [number, number, number], distance: number, bounds: {
+    min: Xyz;
+    max: Xyz;
+}): {
+    anchor: [number, number, number];
+    corners: SectionPlaneFrame['corners'];
+};
+/** Every plane of `input`, enabled or not, primary first. Seven extras at most, as the renderer clips. */
+export declare function resolveSectionPlaneFrames(input: SectionFrameInput): SectionPlaneFrame[];
+export {};
+//# sourceMappingURL=section-plane-frames.d.ts.map

package/dist/section-plane-frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-plane-frames.d.ts","sourceRoot":"","sources":["../src/section-plane-frames.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,KAAK,GAAG,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,yFAAyF;IACzF,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnH;AAED,qFAAqF;AACrF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,MAAM,EAAE;QAAE,GAAG,EAAE,GAAG,CAAC;QAAC,GAAG,EAAE,GAAG,CAAA;KAAE,CAAC;IAC/B,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,4GAA4G;AAC5G,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,GAC7B;IAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAA;CAAE,CAgB7E;AAED,0GAA0G;AAC1G,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,CAYvF"}