@flighthq/effects-wgpu 0.1.0 → 0.2.1-next.410.a23f189

package/dist/wgpuEffectBlitShader.js

@@ -0,0 +1,97 @@
+import { createWgpuEffectPipeline, drawWgpuEffectPass } from './wgpuEffectPass';
+// Blits a texture at a UV offset. Out-of-bounds samples produce transparent output.
+const BLIT_OFFSET_WGSL = /* wgsl */ `
+struct Uniforms {
+  offset : vec2f,
+  _pad : vec2f,
+}
+@group(0) @binding(0) var<uniform> uni : Uniforms;
+@group(1) @binding(0) var tex : texture_2d<f32>;
+@group(1) @binding(1) var smp : sampler;
+
+@fragment
+fn fs_main(@location(0) uv : vec2f) -> @location(0) vec4f {
+  let shifted = uv + uni.offset;
+  if (shifted.x < 0.0 || shifted.x > 1.0 || shifted.y < 0.0 || shifted.y > 1.0) {
+    return vec4f(0.0);
+  }
+  return textureSampleLevel(tex, smp, shifted, 0.0);
+}`;
+// Pass-through blit. Minimal uniform struct required by the pipeline layout.
+const BLIT_WGSL = /* wgsl */ `
+struct Uniforms { _u : f32, _pad0 : f32, _pad1 : f32, _pad2 : f32, }
+@group(0) @binding(0) var<uniform> uni : Uniforms;
+@group(1) @binding(0) var tex : texture_2d<f32>;
+@group(1) @binding(1) var smp : sampler;
+
+@fragment
+fn fs_main(@location(0) uv : vec2f) -> @location(0) vec4f {
+  return textureSampleLevel(tex, smp, uv, 0.0);
+}`;
+// Emits source alpha for a destination-out erase pass; blend state supplies the coverage operator.
+const ERASE_WGSL = /* wgsl */ `
+struct Uniforms { _u : f32, _pad0 : f32, _pad1 : f32, _pad2 : f32, }
+@group(0) @binding(0) var<uniform> uni : Uniforms;
+@group(1) @binding(0) var tex : texture_2d<f32>;
+@group(1) @binding(1) var smp : sampler;
+
+@fragment
+fn fs_main(@location(0) uv : vec2f) -> @location(0) vec4f {
+  let a = textureSampleLevel(tex, smp, uv, 0.0).a;
+  return vec4f(0.0, 0.0, 0.0, a);
+}`;
+/**
+ * Blits source into dest at a pixel offset (dx, dy in screen-space Y-down).
+ * Pixels sampling outside the source bounds produce transparent output.
+ *
+ * The offset matches the Gl path exactly — (-dx/w, +dy/h). The shader samples `uv + offset`, so a
+ * screen-space shift of (+dx,+dy) needs offset (-dx, +dy): the +dy is NOT negated for Wgpu. Wgpu's UV
+ * y=0 is top (opposite Gl's bottom-origin) but Wgpu render-target textures are also stored top-down, so
+ * the two inversions cancel. A previous extra Y negation put the shadow on the wrong side of the source
+ * (it landed up-left instead of down-right) — caught by filter-drop-shadow-parity.
+ */
+export function applyWgpuEffectBlitOffsetPass(state, source, dest, dx, dy) {
+    const pipeline = getWgpuBlitOffsetShader(state);
+    drawWgpuEffectPass(state, source, dest, pipeline, (f32) => {
+        f32[0] = -dx / source.width;
+        f32[1] = dy / source.height;
+    });
+}
+/** Blits source directly into dest without modification. */
+export function applyWgpuEffectBlitPass(state, source, dest) {
+    const pipeline = getWgpuBlitShader(state);
+    drawWgpuEffectPass(state, source, dest, pipeline, () => { });
+}
+/** Erases dest by the source alpha mask, equivalent to destination-out compositing. */
+export function applyWgpuEffectErasePass(state, source, dest) {
+    const pipeline = getWgpuEraseShader(state);
+    drawWgpuEffectPass(state, source, dest, pipeline, () => { });
+}
+function getWgpuBlitOffsetShader(state) {
+    let p = blitOffsetPipelines.get(state);
+    if (p === undefined) {
+        p = createWgpuEffectPipeline(state, BLIT_OFFSET_WGSL);
+        blitOffsetPipelines.set(state, p);
+    }
+    return p;
+}
+function getWgpuBlitShader(state) {
+    let p = blitPipelines.get(state);
+    if (p === undefined) {
+        p = createWgpuEffectPipeline(state, BLIT_WGSL);
+        blitPipelines.set(state, p);
+    }
+    return p;
+}
+function getWgpuEraseShader(state) {
+    let p = erasePipelines.get(state);
+    if (p === undefined) {
+        p = createWgpuEffectPipeline(state, ERASE_WGSL, 'erase');
+        erasePipelines.set(state, p);
+    }
+    return p;
+}
+const blitOffsetPipelines = new WeakMap();
+const blitPipelines = new WeakMap();
+const erasePipelines = new WeakMap();
+//# sourceMappingURL=wgpuEffectBlitShader.js.map

package/dist/wgpuEffectBlitShader.js.map

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

package/dist/wgpuEffectBoxBlur.d.ts

@@ -0,0 +1,15 @@
+import type { WgpuRenderState, WgpuRenderTarget } from '@flighthq/types';
+/**
+ * Applies a separable box blur to `source`, writing to `dest`. `blurX`/`blurY` are
+ * the target Gaussian standard deviations; `passes` is the number of box passes per
+ * axis (more passes converge on a Gaussian — see `computeBoxBlurPassRadius`). A box
+ * blur is cheap and right for soft spreads. `temp` is a caller-provided ping-pong
+ * scratch target distinct from both `source` and `dest`.
+ */
+export declare function applyWgpuEffectBoxBlur(state: WgpuRenderState, source: WgpuRenderTarget, dest: WgpuRenderTarget, temp: WgpuRenderTarget, options: Readonly<{
+    blurX?: number;
+    blurY?: number;
+    passes?: number;
+    edgeColor?: readonly [number, number, number, number];
+}>): void;
+//# sourceMappingURL=wgpuEffectBoxBlur.d.ts.map

package/dist/wgpuEffectBoxBlur.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuEffectBoxBlur.d.ts","sourceRoot":"","sources":["../src/wgpuEffectBoxBlur.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AA8CzE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACvD,CAAC,GACD,IAAI,CA2BN"}

package/dist/wgpuEffectBoxBlur.js

@@ -0,0 +1,106 @@
+import { computeBoxBlurPassRadius } from '@flighthq/effects';
+import { createWgpuEffectPipeline, drawWgpuEffectPass } from './wgpuEffectPass';
+// Uniforms layout:
+//   offset  0: texelSize (vec2f)
+//   offset  8: direction (vec2f)
+//   offset 16: edgeColor (vec4f)
+//   offset 32: radius (f32)
+//   offset 36: useEdgeColor (f32)
+//   offset 40-47: padding
+const BOX_BLUR_WGSL = /* wgsl */ `
+struct Uniforms {
+  texelSize : vec2f,
+  direction : vec2f,
+  edgeColor : vec4f,
+  radius : f32,
+  useEdgeColor : f32,
+  _pad0 : f32, _pad1 : f32,
+}
+@group(0) @binding(0) var<uniform> uni : Uniforms;
+@group(1) @binding(0) var tex : texture_2d<f32>;
+@group(1) @binding(1) var smp : sampler;
+
+fn sampleBlur(uv : vec2f) -> vec4f {
+  if (uni.useEdgeColor > 0.5 && (uv.x < 0.0 || uv.x > 1.0 || uv.y < 0.0 || uv.y > 1.0)) {
+    return uni.edgeColor;
+  }
+  return textureSampleLevel(tex, smp, uv, 0.0);
+}
+
+@fragment
+fn fs_main(@location(0) uv : vec2f) -> @location(0) vec4f {
+  let r = i32(uni.radius);
+  if (r == 0) { return sampleBlur(uv); }
+  var sum = vec4f(0.0);
+  let count = f32(2 * r + 1);
+  for (var i = -r; i <= r; i++) {
+    sum += sampleBlur(uv + f32(i) * uni.texelSize * uni.direction);
+  }
+  return sum / count;
+}`;
+/**
+ * Applies a separable box blur to `source`, writing to `dest`. `blurX`/`blurY` are
+ * the target Gaussian standard deviations; `passes` is the number of box passes per
+ * axis (more passes converge on a Gaussian — see `computeBoxBlurPassRadius`). A box
+ * blur is cheap and right for soft spreads. `temp` is a caller-provided ping-pong
+ * scratch target distinct from both `source` and `dest`.
+ */
+export function applyWgpuEffectBoxBlur(state, source, dest, temp, options) {
+    const passes = Math.max(1, Math.round(options.passes ?? 1));
+    const blurX = options.blurX ?? 4;
+    const blurY = options.blurY ?? 4;
+    const edgeColor = options.edgeColor;
+    let read = source;
+    let write = temp;
+    for (let pass = 0; pass < passes; pass++) {
+        const radiusX = computeBoxBlurPassRadius(blurX, passes, pass);
+        if (radiusX > 0) {
+            applyBoxBlurPass(state, read, write, radiusX, 1, 0, edgeColor);
+            read = write;
+            write = write === temp ? dest : temp;
+        }
+        const radiusY = computeBoxBlurPassRadius(blurY, passes, pass);
+        if (radiusY > 0) {
+            applyBoxBlurPass(state, read, write, radiusY, 0, 1, edgeColor);
+            read = write;
+            write = write === temp ? dest : temp;
+        }
+    }
+    if (read !== dest) {
+        applyBoxBlurPass(state, read, dest, 0, 0, 0, undefined);
+    }
+}
+function applyBoxBlurPass(state, source, dest, radius, dirX, dirY, edgeColor) {
+    const pipeline = getBoxBlurPipeline(state);
+    drawWgpuEffectPass(state, source, dest, pipeline, (f32) => {
+        f32[0] = 1 / source.width;
+        f32[1] = 1 / source.height;
+        f32[2] = dirX;
+        f32[3] = dirY;
+        if (edgeColor === undefined) {
+            f32[4] = 0;
+            f32[5] = 0;
+            f32[6] = 0;
+            f32[7] = 0;
+            f32[9] = 0;
+        }
+        else {
+            f32[4] = edgeColor[0];
+            f32[5] = edgeColor[1];
+            f32[6] = edgeColor[2];
+            f32[7] = edgeColor[3];
+            f32[9] = 1;
+        }
+        f32[8] = radius;
+    });
+}
+function getBoxBlurPipeline(state) {
+    let p = boxBlurPipelines.get(state);
+    if (p === undefined) {
+        p = createWgpuEffectPipeline(state, BOX_BLUR_WGSL, 'replace');
+        boxBlurPipelines.set(state, p);
+    }
+    return p;
+}
+const boxBlurPipelines = new WeakMap();
+//# sourceMappingURL=wgpuEffectBoxBlur.js.map

package/dist/wgpuEffectBoxBlur.js.map

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

package/dist/wgpuEffectGradientRamp.d.ts

@@ -0,0 +1,17 @@
+import type { WgpuRenderState } from '@flighthq/types';
+/**
+ * Returns a cached 256-entry RGBA gradient ramp texture for the given stops,
+ * building it on first use and reusing it on later calls with the same stops.
+ * The texture is owned by the render state and lives for its lifetime — callers
+ * must NOT destroy it. This is the form recipes should use: a recipe runs inside
+ * the frame's command encoder and does not control submit timing, so it cannot
+ * safely `destroy()` a per-call texture (the encoder still references it at
+ * submit, which discards the whole frame). Caching also avoids a per-frame
+ * allocation. Distinct stop sets get distinct textures, so multiple gradient
+ * recipes in one frame never alias each other's ramp.
+ *
+ * `ratios` are in byte scale [0,255]. Colors are packed RGB integers.
+ * `alphas` are in [0,1].
+ */
+export declare function getWgpuEffectGradientRampTexture(state: WgpuRenderState, colors: ReadonlyArray<number>, alphas: ReadonlyArray<number>, ratios: ReadonlyArray<number>): GPUTexture;
+//# sourceMappingURL=wgpuEffectGradientRamp.d.ts.map

package/dist/wgpuEffectGradientRamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuEffectGradientRamp.d.ts","sourceRoot":"","sources":["../src/wgpuEffectGradientRamp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAC7B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAC7B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC5B,UAAU,CAaZ"}

package/dist/wgpuEffectGradientRamp.js

@@ -0,0 +1,89 @@
+/**
+ * Returns a cached 256-entry RGBA gradient ramp texture for the given stops,
+ * building it on first use and reusing it on later calls with the same stops.
+ * The texture is owned by the render state and lives for its lifetime — callers
+ * must NOT destroy it. This is the form recipes should use: a recipe runs inside
+ * the frame's command encoder and does not control submit timing, so it cannot
+ * safely `destroy()` a per-call texture (the encoder still references it at
+ * submit, which discards the whole frame). Caching also avoids a per-frame
+ * allocation. Distinct stop sets get distinct textures, so multiple gradient
+ * recipes in one frame never alias each other's ramp.
+ *
+ * `ratios` are in byte scale [0,255]. Colors are packed RGB integers.
+ * `alphas` are in [0,1].
+ */
+export function getWgpuEffectGradientRampTexture(state, colors, alphas, ratios) {
+    let cache = rampCaches.get(state);
+    if (cache === undefined) {
+        cache = new Map();
+        rampCaches.set(state, cache);
+    }
+    const key = `${colors.join(',')}|${alphas.join(',')}|${ratios.join(',')}`;
+    let texture = cache.get(key);
+    if (texture === undefined) {
+        texture = createWgpuEffectGradientRampTexture(state, colors, alphas, ratios);
+        cache.set(key, texture);
+    }
+    return texture;
+}
+function buildRampData(colors, alphas, ratios) {
+    const out = new Uint8ClampedArray(256 * 4);
+    if (colors.length === 0)
+        return out;
+    for (let i = 0; i < 256; i++) {
+        const t = i;
+        let r = 0, g = 0, b = 0, a = 0;
+        if (t <= ratios[0]) {
+            const c = colors[0];
+            r = (c >> 16) & 0xff;
+            g = (c >> 8) & 0xff;
+            b = c & 0xff;
+            a = Math.round(alphas[0] * 255);
+        }
+        else if (t >= ratios[ratios.length - 1]) {
+            const c = colors[colors.length - 1];
+            r = (c >> 16) & 0xff;
+            g = (c >> 8) & 0xff;
+            b = c & 0xff;
+            a = Math.round(alphas[alphas.length - 1] * 255);
+        }
+        else {
+            for (let j = 0; j < ratios.length - 1; j++) {
+                const r0 = ratios[j];
+                const r1 = ratios[j + 1];
+                if (t >= r0 && t <= r1) {
+                    const blend = r1 > r0 ? (t - r0) / (r1 - r0) : 0;
+                    const c0 = colors[j];
+                    const c1 = colors[j + 1];
+                    r = Math.round(((c0 >> 16) & 0xff) * (1 - blend) + ((c1 >> 16) & 0xff) * blend);
+                    g = Math.round(((c0 >> 8) & 0xff) * (1 - blend) + ((c1 >> 8) & 0xff) * blend);
+                    b = Math.round((c0 & 0xff) * (1 - blend) + (c1 & 0xff) * blend);
+                    a = Math.round(alphas[j] * 255 * (1 - blend) + alphas[j + 1] * 255 * blend);
+                    break;
+                }
+            }
+        }
+        out[i * 4] = r;
+        out[i * 4 + 1] = g;
+        out[i * 4 + 2] = b;
+        out[i * 4 + 3] = a;
+    }
+    return out;
+}
+// Builds a 256-entry RGBA gradient ramp texture on the GPU. The returned texture is cached and owned by
+// the render state (see getWgpuEffectGradientRampTexture), so it is never destroyed mid-encoder.
+function createWgpuEffectGradientRampTexture(state, colors, alphas, ratios) {
+    const data = buildRampData(colors, alphas, ratios);
+    const { device } = state;
+    const texture = device.createTexture({
+        size: [256, 1, 1],
+        format: 'rgba8unorm',
+        usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST,
+    });
+    device.queue.writeTexture({ texture, origin: [0, 0, 0] }, data.buffer, { offset: 0, bytesPerRow: 256 * 4 }, [256, 1, 1]);
+    return texture;
+}
+// Per-render-state cache of ramp textures keyed by their stops. Textures live for the render state's
+// lifetime; they are tiny (256×1) and the distinct-gradient set is bounded in practice.
+const rampCaches = new WeakMap();
+//# sourceMappingURL=wgpuEffectGradientRamp.js.map

package/dist/wgpuEffectGradientRamp.js.map

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

package/dist/wgpuEffectPass.d.ts

@@ -0,0 +1,42 @@
+import type { WgpuRenderState, WgpuRenderTarget } from '@flighthq/types';
+export declare const EFFECT_VERTEX_WGSL = "\nstruct VertexOut {\n  @builtin(position) position : vec4f,\n  @location(0) uv : vec2f,\n}\n\n@vertex\nfn vs_main(@builtin(vertex_index) vi : u32) -> VertexOut {\n  let xi = vi == 1u || vi == 2u || vi == 4u;\n  let yi = vi == 2u || vi == 4u || vi == 5u;\n  var out : VertexOut;\n  out.position = vec4f(select(-1.0, 1.0, xi), select(-1.0, 1.0, yi), 0.0, 1.0);\n  out.uv = vec2f(select(0.0, 1.0, xi), select(1.0, 0.0, yi));\n  return out;\n}\n";
+export type WgpuEffectBlendMode = 'premul' | 'replace' | 'erase';
+export type WgpuEffectPipeline = {
+    pipeline: GPURenderPipeline;
+    blendMode: WgpuEffectBlendMode;
+    compileForFormat?: (format: GPUTextureFormat) => GPURenderPipeline;
+    variants?: Map<GPUTextureFormat, GPURenderPipeline>;
+};
+export type WgpuDualSourceEffectPipeline = WgpuEffectPipeline;
+/** Clears a render target to fully transparent. Ends any active render pass. */
+export declare function clearWgpuEffectTarget(state: WgpuRenderState, target: WgpuRenderTarget): void;
+/** Compiles a dual-source WGSL effect pipeline (source0 = group 1, source1 = group 2). */
+export declare function createWgpuDualSourceEffectPipeline(state: WgpuRenderState, fragmentWGSL: string, blend?: WgpuEffectBlendMode): WgpuDualSourceEffectPipeline;
+/** Compiles a WGSL effect pipeline, creating the combined vertex+fragment shader module. */
+export declare function createWgpuEffectPipeline(state: WgpuRenderState, fragmentWGSL: string, blend?: WgpuEffectBlendMode): WgpuEffectPipeline;
+/**
+ * Draws a full-screen pass reading from two source textures.
+ * source0 binds to group 1, source1 to group 2.
+ */
+export declare function drawWgpuDualSourceEffectPass(state: WgpuRenderState, source0: WgpuRenderTarget, source1: WgpuRenderTarget, dest: WgpuRenderTarget | null, pipeline: WgpuDualSourceEffectPipeline, setUniforms: (f32: Float32Array, i32: Int32Array) => void): void;
+/**
+ * Draws a full-screen effect pass: reads from source (group 1), writes to dest.
+ * `setUniforms` is called with Float32Array and Int32Array views into the current
+ * ring-buffer slot for per-pass uniform uploads. Blend is premultiplied-alpha compositing.
+ * Ends any active render pass; does not restore it.
+ */
+export declare function drawWgpuEffectPass(state: WgpuRenderState, source: WgpuRenderTarget, dest: WgpuRenderTarget | null, pipeline: WgpuEffectPipeline, setUniforms: (f32: Float32Array, i32: Int32Array) => void): void;
+/**
+ * Returns the effect-pass state for the given render state, for use in shaders
+ * that need to bind a custom texture (e.g., a gradient ramp) as group 2 or 3.
+ */
+export declare function getWgpuEffectPassState(state: WgpuRenderState): {
+    uniformBG: GPUBindGroup;
+    textureBGLayout: GPUBindGroupLayout;
+    uniformBGLayout: GPUBindGroupLayout;
+    sampler: GPUSampler;
+    acquireSlot: () => number;
+    writeSlot: (offset: number, fn: (f32: Float32Array, i32: Int32Array) => void) => void;
+    beginPass: (dest: WgpuRenderTarget | null, loadOp: GPULoadOp) => GPURenderPassEncoder;
+};
+//# sourceMappingURL=wgpuEffectPass.d.ts.map

package/dist/wgpuEffectPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wgpuEffectPass.d.ts","sourceRoot":"","sources":["../src/wgpuEffectPass.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKzE,eAAO,MAAM,kBAAkB,+bAe9B,CAAC;AAoBF,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjE,MAAM,MAAM,kBAAkB,GAAG;IAE/B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,mBAAmB,CAAC;IAK/B,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,iBAAiB,CAAC;IACnE,QAAQ,CAAC,EAAE,GAAG,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,kBAAkB,CAAC;AA8K9D,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAG5F;AAED,0FAA0F;AAC1F,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,MAAM,EACpB,KAAK,GAAE,mBAA8B,GACpC,4BAA4B,CAsB9B;AAED,4FAA4F;AAC5F,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,MAAM,EACpB,KAAK,GAAE,mBAA8B,GACpC,kBAAkB,CAsBpB;AAQD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,gBAAgB,GAAG,IAAI,EAC7B,QAAQ,EAAE,4BAA4B,EACtC,WAAW,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,KAAK,IAAI,GACxD,IAAI,CAiBN;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,gBAAgB,GAAG,IAAI,EAC7B,QAAQ,EAAE,kBAAkB,EAC5B,WAAW,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,KAAK,IAAI,GACxD,IAAI,CAeN;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG;IAC9D,SAAS,EAAE,YAAY,CAAC;IACxB,eAAe,EAAE,kBAAkB,CAAC;IACpC,eAAe,EAAE,kBAAkB,CAAC;IACpC,OAAO,EAAE,UAAU,CAAC;IACpB,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,KAAK,IAAI,KAAK,IAAI,CAAC;IACtF,SAAS,EAAE,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,KAAK,oBAAoB,CAAC;CACvF,CAWA"}