@adobe/data-gpu 0.9.69

package/dist/graphics/rendering/jolt-ragdoll-plugin.js

@@ -0,0 +1,218 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+import { Mat4x4, Quat } from "@adobe/data/math";
+import { joltSolver } from "../../physics/solvers/jolt-solver-plugin.js";
+import { fitBoneCapsules } from "../../physics/ragdoll/fit-bone-capsules.js";
+import { ragdollTrigger } from "./ragdoll-trigger-plugin.js";
+import { pbrSkinning } from "./skinning/skinning-plugin.js";
+import { modelLoader } from "../scene/model/model-loader-plugin.js";
+import { transform } from "../scene/node/transform-plugin.js";
+/** Column-major rigid transform from a position + unit quaternion. */
+const compose = (px, py, pz, q) => Mat4x4.multiply(Mat4x4.translation(px, py, pz), Quat.toMat4([q[0], q[1], q[2], q[3]]));
+/** Orthonormalised rotation of a column-major matrix → quaternion. */
+function rotationOf(m) {
+    let m00 = m[0], m10 = m[1], m20 = m[2], m01 = m[4], m11 = m[5], m21 = m[6], m02 = m[8], m12 = m[9], m22 = m[10];
+    const sx = Math.hypot(m00, m10, m20) || 1, sy = Math.hypot(m01, m11, m21) || 1, sz = Math.hypot(m02, m12, m22) || 1;
+    m00 /= sx;
+    m10 /= sx;
+    m20 /= sx;
+    m01 /= sy;
+    m11 /= sy;
+    m21 /= sy;
+    m02 /= sz;
+    m12 /= sz;
+    m22 /= sz;
+    const tr = m00 + m11 + m22;
+    if (tr > 0) {
+        const s = Math.sqrt(tr + 1) * 2;
+        return [(m21 - m12) / s, (m02 - m20) / s, (m10 - m01) / s, 0.25 * s];
+    }
+    if (m00 > m11 && m00 > m22) {
+        const s = Math.sqrt(1 + m00 - m11 - m22) * 2;
+        return [0.25 * s, (m01 + m10) / s, (m02 + m20) / s, (m21 - m12) / s];
+    }
+    if (m11 > m22) {
+        const s = Math.sqrt(1 + m11 - m00 - m22) * 2;
+        return [(m01 + m10) / s, 0.25 * s, (m12 + m21) / s, (m02 - m20) / s];
+    }
+    const s = Math.sqrt(1 + m22 - m00 - m11) * 2;
+    return [(m02 + m20) / s, (m12 + m21) / s, 0.25 * s, (m10 - m01) / s];
+}
+const SWING = 0.9, TWIST = 0.5; // ~52° swing cone, ~±29° twist
+export const joltRagdoll = Database.Plugin.create({
+    extends: Database.Plugin.combine(joltSolver, ragdollTrigger, pbrSkinning, modelLoader, transform),
+    systems: {
+        joltRagdollSystem: {
+            schedule: { during: ["postUpdate"], after: ["transformSystem"] },
+            create: db => {
+                let built = false, dead = false;
+                // Jolt objects (created at build): the ragdoll, a reusable pose, scratch.
+                let ragdoll = null;
+                let pose = null;
+                let joints = [];
+                let modelEntity = 0; // the skeleton's root parent (the Model); moved to follow the ragdoll root when limp
+                let tv = null, tq = null, troot = null;
+                const jointWorld = (j) => db.store.get(j, "_worldMatrix") ?? Mat4x4.identity;
+                const build = (ctx, jointIds, g) => {
+                    const jolt = ctx.jolt, template = g._skinJointTemplate;
+                    const caps = new Map();
+                    for (const c of fitBoneCapsules({ jointCount: jointIds.length, inverseBindMatrices: g._skinInverseBindMatrices, skin: g._cpuSkin }))
+                        caps.set(c.jointIndex, { radius: c.radius, halfHeight: c.halfHeight, offPos: c.offsetPosition, offRot: c.offsetRotation });
+                    const skel = new jolt.Skeleton();
+                    for (let i = 0; i < jointIds.length; i++) {
+                        const s = new jolt.JPHString(template[i]?.name ?? `j${i}`, (template[i]?.name ?? `j${i}`).length);
+                        skel.AddJoint(s, template[i]?.parentJointIndex ?? -1);
+                        jolt.destroy(s);
+                    }
+                    const settings = new jolt.RagdollSettings();
+                    settings.mSkeleton = skel;
+                    // RagdollPart has no constructor in the IDL — resize the parts vector and
+                    // configure each element in place, then write the vector back.
+                    const parts = settings.mParts;
+                    parts.resize(jointIds.length);
+                    for (let i = 0; i < jointIds.length; i++) {
+                        const jw = jointWorld(jointIds[i]), cap = caps.get(i);
+                        const part = parts.at(i);
+                        // body bind pose: capsule sits at jointWorld · offset; sphere at the joint
+                        const bodyW = cap ? Mat4x4.multiply(jw, compose(cap.offPos[0], cap.offPos[1], cap.offPos[2], cap.offRot)) : jw;
+                        const shp = cap ? new jolt.CapsuleShape(Math.max(cap.halfHeight, 1e-3), cap.radius) : new jolt.SphereShape(0.03);
+                        part.SetShape(shp);
+                        const bp = new jolt.RVec3(bodyW[12], bodyW[13], bodyW[14]);
+                        const br = rotationOf(bodyW);
+                        const bq = new jolt.Quat(br[0], br[1], br[2], br[3]);
+                        part.set_mPosition(bp);
+                        part.set_mRotation(bq);
+                        part.set_mMotionType(jolt.EMotionType_Dynamic);
+                        part.set_mObjectLayer(ctx.ragdollLayer);
+                        const pj = template[i]?.parentJointIndex ?? -1;
+                        if (pj >= 0) {
+                            // swing-twist to the parent, anchored at this joint, bone axis = parent→this
+                            const pw = jointWorld(jointIds[pj]);
+                            let ax = jw[12] - pw[12], ay = jw[13] - pw[13], az = jw[14] - pw[14];
+                            const al = Math.hypot(ax, ay, az) || 1;
+                            ax /= al;
+                            ay /= al;
+                            az /= al;
+                            let nx = 0, ny = 0, nz = 0;
+                            if (Math.abs(ax) <= Math.abs(ay) && Math.abs(ax) <= Math.abs(az)) {
+                                ny = az;
+                                nz = -ay;
+                            }
+                            else {
+                                nx = -az;
+                                nz = ax;
+                            }
+                            const nl = Math.hypot(nx, ny, nz) || 1;
+                            nx /= nl;
+                            ny /= nl;
+                            nz /= nl;
+                            const st = new jolt.SwingTwistConstraintSettings();
+                            st.mSpace = jolt.EConstraintSpace_WorldSpace;
+                            const p1 = new jolt.RVec3(jw[12], jw[13], jw[14]), p2 = new jolt.RVec3(jw[12], jw[13], jw[14]);
+                            const t1 = new jolt.Vec3(ax, ay, az), t2 = new jolt.Vec3(ax, ay, az), n1 = new jolt.Vec3(nx, ny, nz), n2 = new jolt.Vec3(nx, ny, nz);
+                            st.mPosition1 = p1;
+                            st.mPosition2 = p2;
+                            st.mTwistAxis1 = t1;
+                            st.mTwistAxis2 = t2;
+                            st.mPlaneAxis1 = n1;
+                            st.mPlaneAxis2 = n2;
+                            st.mSwingType = jolt.ESwingType_Cone;
+                            st.mNormalHalfConeAngle = SWING;
+                            st.mPlaneHalfConeAngle = SWING;
+                            st.mTwistMinAngle = -TWIST;
+                            st.mTwistMaxAngle = TWIST;
+                            part.set_mToParent(st);
+                            jolt.destroy(p1);
+                            jolt.destroy(p2);
+                            jolt.destroy(t1);
+                            jolt.destroy(t2);
+                            jolt.destroy(n1);
+                            jolt.destroy(n2);
+                        }
+                        jolt.destroy(bp);
+                        jolt.destroy(bq);
+                    }
+                    settings.mParts = parts;
+                    settings.DisableParentChildCollisions();
+                    settings.Stabilize();
+                    ragdoll = settings.CreateRagdoll(0, 0, ctx.physicsSystem);
+                    ragdoll.AddToPhysicsSystem(jolt.EActivation_Activate);
+                    pose = new jolt.SkeletonPose();
+                    pose.SetSkeleton(skel);
+                    tv = new jolt.Vec3(0, 0, 0);
+                    tq = new jolt.Quat(0, 0, 0, 1);
+                    troot = new jolt.RVec3(0, 0, 0);
+                    joints = jointIds;
+                    let rootIdx = template.findIndex(t => (t.parentJointIndex ?? -1) < 0);
+                    if (rootIdx < 0)
+                        rootIdx = 0;
+                    modelEntity = db.store.get(jointIds[rootIdx], "parent") ?? 0;
+                    jolt.destroy(settings);
+                };
+                return () => {
+                    const ctx = db.store.resources._joltContext;
+                    if (!ctx)
+                        return;
+                    if (!built) {
+                        for (const arch of db.store.queryArchetypes(["_skeletonJoints", "_skeletonGeometry"])) {
+                            const jc = arch.columns._skeletonJoints, gc = arch.columns._skeletonGeometry;
+                            for (let i = 0; i < arch.rowCount; i++) {
+                                const g = db.store.read(gc.get(i));
+                                if (!g?._cpuSkin || !g._skinInverseBindMatrices || !g._skinJointTemplate?.length)
+                                    continue;
+                                build(ctx, jc.get(i), g);
+                                built = true;
+                                break;
+                            }
+                            if (built)
+                                break;
+                        }
+                        if (!built)
+                            return;
+                    }
+                    const jolt = ctx.jolt, rd = ragdoll, p = pose;
+                    if (!dead && db.store.resources._ragdollTrigger) {
+                        dead = true;
+                        for (const a of db.store.queryArchetypes(["animationPlaying"]))
+                            for (let i = 0; i < a.rowCount; i++)
+                                db.store.update(a.columns.id.get(i), { animationPlaying: false });
+                    }
+                    if (!dead) {
+                        // alive: drive the ragdoll toward the animated pose. Root offset =
+                        // the model's world translation; joint states = the animated locals.
+                        const rm = jointWorld(modelEntity);
+                        troot.Set(rm[12], rm[13], rm[14]);
+                        p.SetRootOffset(troot);
+                        for (let i = 0; i < joints.length; i++) {
+                            const pos = db.store.get(joints[i], "position");
+                            const rot = db.store.get(joints[i], "rotation");
+                            if (!pos || !rot)
+                                continue;
+                            const st = p.GetJoint(i);
+                            tv.Set(pos[0], pos[1], pos[2]);
+                            tq.Set(rot[0], rot[1], rot[2], rot[3]);
+                            st.set_mTranslation(tv);
+                            st.set_mRotation(tq);
+                        }
+                        p.CalculateJointMatrices();
+                        rd.DriveToPoseUsingKinematics(p, db.store.resources.physicsClock.fixedDt * Math.max(1, db.store.resources.physicsClock.steps));
+                    }
+                    else {
+                        // limp: read the physics pose back. The ragdoll's root has fallen, so move
+                        // the model to the pose's root offset and apply the local joint states —
+                        // the whole skin follows the fall, the limbs flop.
+                        rd.GetPose(p, false);
+                        p.CalculateJointStates();
+                        const ro = p.GetRootOffset();
+                        db.store.update(modelEntity, { position: [ro.GetX(), ro.GetY(), ro.GetZ()] });
+                        for (let i = 0; i < joints.length; i++) {
+                            const st = p.GetJoint(i), t = st.get_mTranslation(), r = st.get_mRotation();
+                            db.store.update(joints[i], { position: [t.GetX(), t.GetY(), t.GetZ()], rotation: [r.GetX(), r.GetY(), r.GetZ(), r.GetW()] });
+                        }
+                    }
+                };
+            },
+        },
+    },
+});
+//# sourceMappingURL=jolt-ragdoll-plugin.js.map

package/dist/graphics/rendering/jolt-ragdoll-plugin.js.map

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

package/dist/graphics/rendering/material-gpu/material-arrays.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The shared GPU material set: five `texture_2d_array`s (one per PBR map) plus
+ * a palette storage buffer of per-layer factors. Every material occupies one
+ * layer across all five arrays; a drawable selects its material with a single
+ * per-instance layer index. Built once and grown by layer — materials are
+ * added rarely and edited never, so nothing here is rebuilt per frame.
+ */
+export interface MaterialArrays {
+    baseColor: GPUTexture;
+    metallicRoughness: GPUTexture;
+    normal: GPUTexture;
+    occlusion: GPUTexture;
+    emissive: GPUTexture;
+}
+/** Fixed layer size every material map is resampled to. */
+export declare const MATERIAL_TEXTURE_SIZE = 512;
+/** Maximum distinct materials (array layers). 16 × 512² × 5 maps ≈ 80 MB. */
+export declare const MAX_MATERIAL_LAYERS = 16;
+/** Bytes per palette entry: baseColor(vec4) + emissive/metallic(vec4) + rough/normal/occlusion(vec4). */
+export declare const PALETTE_STRIDE = 48;
+export declare function createMaterialArrays(device: GPUDevice): MaterialArrays;
+/** Per-material visible factors written into one palette layer. */
+export interface MaterialFactors {
+    baseColorFactor: readonly number[];
+    emissiveFactor: readonly number[];
+    metallicFactor: number;
+    roughnessFactor: number;
+    normalScale: number;
+    occlusionStrength: number;
+}
+export declare function writePaletteLayer(device: GPUDevice, palette: GPUBuffer, layer: number, f: MaterialFactors): void;
+/** The five map source URLs for one material ("" = leave the neutral layer). */
+export interface MaterialMapUrls {
+    baseColorUrl: string;
+    metallicRoughnessUrl: string;
+    normalUrl: string;
+    occlusionUrl: string;
+    emissiveUrl: string;
+}
+/**
+ * Fetches a material's maps and blits them (resampled to the layer size) into
+ * its array layer. Fire-and-forget: each map resolves independently, so a body
+ * renders (neutral) immediately and sharpens as textures arrive. URLs shared
+ * across maps (e.g. an ARM image used for both metallicRoughness and occlusion)
+ * are fetched once and copied to each target.
+ */
+export declare function loadMaterialMaps(device: GPUDevice, arrays: MaterialArrays, layer: number, urls: MaterialMapUrls): void;

package/dist/graphics/rendering/material-gpu/material-arrays.js

@@ -0,0 +1,83 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/** Fixed layer size every material map is resampled to. */
+export const MATERIAL_TEXTURE_SIZE = 512;
+/** Maximum distinct materials (array layers). 16 × 512² × 5 maps ≈ 80 MB. */
+export const MAX_MATERIAL_LAYERS = 16;
+/** Bytes per palette entry: baseColor(vec4) + emissive/metallic(vec4) + rough/normal/occlusion(vec4). */
+export const PALETTE_STRIDE = 48;
+export function createMaterialArrays(device) {
+    const make = (format) => device.createTexture({
+        size: [MATERIAL_TEXTURE_SIZE, MATERIAL_TEXTURE_SIZE, MAX_MATERIAL_LAYERS],
+        dimension: "2d",
+        format,
+        // RENDER_ATTACHMENT is required by copyExternalImageToTexture.
+        usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST | GPUTextureUsage.RENDER_ATTACHMENT,
+    });
+    return {
+        baseColor: make("rgba8unorm-srgb"),
+        metallicRoughness: make("rgba8unorm"),
+        normal: make("rgba8unorm"),
+        occlusion: make("rgba8unorm"),
+        emissive: make("rgba8unorm-srgb"),
+    };
+}
+const _palette = new Float32Array(PALETTE_STRIDE / 4);
+export function writePaletteLayer(device, palette, layer, f) {
+    _palette[0] = f.baseColorFactor[0];
+    _palette[1] = f.baseColorFactor[1];
+    _palette[2] = f.baseColorFactor[2];
+    _palette[3] = f.baseColorFactor[3];
+    _palette[4] = f.emissiveFactor[0];
+    _palette[5] = f.emissiveFactor[1];
+    _palette[6] = f.emissiveFactor[2];
+    _palette[7] = f.metallicFactor;
+    _palette[8] = f.roughnessFactor;
+    _palette[9] = f.normalScale;
+    _palette[10] = f.occlusionStrength;
+    _palette[11] = 0;
+    device.queue.writeBuffer(palette, layer * PALETTE_STRIDE, _palette);
+}
+/**
+ * Fetches a material's maps and blits them (resampled to the layer size) into
+ * its array layer. Fire-and-forget: each map resolves independently, so a body
+ * renders (neutral) immediately and sharpens as textures arrive. URLs shared
+ * across maps (e.g. an ARM image used for both metallicRoughness and occlusion)
+ * are fetched once and copied to each target.
+ */
+export function loadMaterialMaps(device, arrays, layer, urls) {
+    const targets = [
+        { url: urls.baseColorUrl, tex: arrays.baseColor },
+        { url: urls.metallicRoughnessUrl, tex: arrays.metallicRoughness },
+        { url: urls.normalUrl, tex: arrays.normal },
+        { url: urls.occlusionUrl, tex: arrays.occlusion },
+        { url: urls.emissiveUrl, tex: arrays.emissive },
+    ];
+    const byUrl = new Map();
+    for (const t of targets) {
+        if (!t.url)
+            continue;
+        const list = byUrl.get(t.url);
+        if (list)
+            list.push(t.tex);
+        else
+            byUrl.set(t.url, [t.tex]);
+    }
+    for (const [url, texes] of byUrl) {
+        fetch(url)
+            .then(r => { if (!r.ok)
+            throw new Error(`material map ${r.status}: ${url}`); return r.blob(); })
+            .then(blob => createImageBitmap(blob, {
+            resizeWidth: MATERIAL_TEXTURE_SIZE,
+            resizeHeight: MATERIAL_TEXTURE_SIZE,
+            colorSpaceConversion: "none",
+        }))
+            .then(bitmap => {
+            for (const tex of texes) {
+                device.queue.copyExternalImageToTexture({ source: bitmap }, { texture: tex, origin: [0, 0, layer] }, [MATERIAL_TEXTURE_SIZE, MATERIAL_TEXTURE_SIZE, 1]);
+            }
+            bitmap.close();
+        })
+            .catch(err => console.warn("[materialGpu] map load failed", err));
+    }
+}
+//# sourceMappingURL=material-arrays.js.map

package/dist/graphics/rendering/material-gpu/material-arrays.js.map

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

package/dist/graphics/rendering/material-gpu/material-bind-group.d.ts

@@ -0,0 +1,9 @@
+import type { MaterialArrays } from "./material-arrays.js";
+/**
+ * Bind-group layout for the shared material set: palette storage buffer +
+ * five `texture_2d_array`s + a filtering sampler. The renderer's primitive
+ * pipeline builds its pipeline layout from this; `createMaterialBindGroup`
+ * builds the matching bind group. Cached per device.
+ */
+export declare function createMaterialBindGroupLayout(device: GPUDevice): GPUBindGroupLayout;
+export declare function createMaterialBindGroup(device: GPUDevice, arrays: MaterialArrays, palette: GPUBuffer): GPUBindGroup;

package/dist/graphics/rendering/material-gpu/material-bind-group.js

@@ -0,0 +1,52 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+const cacheByDevice = new WeakMap();
+function deviceCache(device) {
+    let c = cacheByDevice.get(device);
+    if (!c) {
+        const tex = (binding) => ({
+            binding, visibility: GPUShaderStage.FRAGMENT,
+            texture: { sampleType: "float", viewDimension: "2d-array" },
+        });
+        c = {
+            layout: device.createBindGroupLayout({
+                entries: [
+                    { binding: 0, visibility: GPUShaderStage.FRAGMENT, buffer: { type: "read-only-storage" } },
+                    tex(1), tex(2), tex(3), tex(4), tex(5),
+                    { binding: 6, visibility: GPUShaderStage.FRAGMENT, sampler: { type: "filtering" } },
+                ],
+            }),
+            sampler: device.createSampler({
+                magFilter: "linear", minFilter: "linear", mipmapFilter: "linear",
+                addressModeU: "repeat", addressModeV: "repeat",
+            }),
+        };
+        cacheByDevice.set(device, c);
+    }
+    return c;
+}
+/**
+ * Bind-group layout for the shared material set: palette storage buffer +
+ * five `texture_2d_array`s + a filtering sampler. The renderer's primitive
+ * pipeline builds its pipeline layout from this; `createMaterialBindGroup`
+ * builds the matching bind group. Cached per device.
+ */
+export function createMaterialBindGroupLayout(device) {
+    return deviceCache(device).layout;
+}
+export function createMaterialBindGroup(device, arrays, palette) {
+    const { layout, sampler } = deviceCache(device);
+    const view = (t) => t.createView({ dimension: "2d-array" });
+    return device.createBindGroup({
+        layout,
+        entries: [
+            { binding: 0, resource: { buffer: palette } },
+            { binding: 1, resource: view(arrays.baseColor) },
+            { binding: 2, resource: view(arrays.metallicRoughness) },
+            { binding: 3, resource: view(arrays.normal) },
+            { binding: 4, resource: view(arrays.occlusion) },
+            { binding: 5, resource: view(arrays.emissive) },
+            { binding: 6, resource: sampler },
+        ],
+    });
+}
+//# sourceMappingURL=material-bind-group.js.map

package/dist/graphics/rendering/material-gpu/material-bind-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-bind-group.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/material-gpu/material-bind-group.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAQvD,MAAM,aAAa,GAAG,IAAI,OAAO,EAA0B,CAAC;AAE5D,SAAS,WAAW,CAAC,MAAiB;IAClC,IAAI,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC,EAAE,CAAC;QACL,MAAM,GAAG,GAAG,CAAC,OAAe,EAA2B,EAAE,CAAC,CAAC;YACvD,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,QAAQ;YAC5C,OAAO,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE;SAC9D,CAAC,CAAC;QACH,CAAC,GAAG;YACA,MAAM,EAAE,MAAM,CAAC,qBAAqB,CAAC;gBACjC,OAAO,EAAE;oBACL,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE;oBAC1F,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;oBACtC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;iBACtF;aACJ,CAAC;YACF,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC;gBAC1B,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ;gBAChE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ;aACjD,CAAC;SACL,CAAC;QACF,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC3D,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,MAAsB,EAAE,OAAkB;IACjG,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,CAAC,CAAa,EAAkB,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;IACxF,OAAO,MAAM,CAAC,eAAe,CAAC;QAC1B,MAAM;QACN,OAAO,EAAE;YACL,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YAC7C,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;YAChD,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE;YACxD,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YAC7C,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;YAChD,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;YAC/C,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE;SACpC;KACJ,CAAC,CAAC;AACP,CAAC"}