rn-gamekit 0.1.0 → 0.2.1

package/lib/module/react/particles/ParticleView.js

@@ -0,0 +1,308 @@
+"use strict";
+
+import { useContext, useMemo } from 'react';
+import { Atlas, Picture, Skia } from '@shopify/react-native-skia';
+import { useColorBuffer, useRectBuffer, useRSXformBuffer } from '@shopify/react-native-skia';
+import { useDerivedValue } from 'react-native-reanimated';
+import { GameWorldContext } from "../sprites/GameWorld2D.js";
+import { PARTICLE_CULL_PADDING, cameraVisibleWorldBounds, maxParticleExtent, screenVisibleBounds, viewportWorldBounds, visibleInBounds } from "./culling.js";
+import { assertUniformParticleSpriteRatio, particleSpriteXform } from "./spriteXForm.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Presentation-only particle renderer.
+ *
+ * Topology is CONSTANT per effect regardless of capacity (T15-RF5): exactly
+ * one React node (`Picture` for shapes, `Atlas` for sprites) plus a single
+ * UI-runtime derived worklet that walks the effect's emission records and
+ * computes analytic transforms from the scalar active-time clock. No per-slot
+ * data crosses the runtime boundary per frame (T15-SF1).
+ *
+ * Coordinate ownership (GS-PARTICLE-02): `space: 'world'` effects sample in
+ * world units and must mount inside world space (no parent transform);
+ * `space: 'screen'` effects sample in surface pixels and must mount inside
+ * screen space. World culling uses the presented camera when one exists
+ * and the resolved viewport bounds otherwise; zoom applies through the
+ * camera, and there is no parallax factor on particles by design.
+ */
+export function ParticleView({
+  system,
+  effect,
+  width,
+  height,
+  presentation,
+  spriteSource
+}) {
+  const definition = useMemo(() => system.bindPresentation().definition(effect), [system, effect]);
+  // GS-PARTICLE-02: conservative cull extent from authored geometry and
+  // scale endpoints (bounding radius, rotation-proof); overscan stays in
+  // the bounds padding, never in this extent.
+  const cullExtent = useMemo(() => maxParticleExtent(definition), [definition]);
+  const world = useContext(GameWorldContext);
+  const camera = world?.camera ?? null;
+  const viewport = world?.viewport ?? null;
+  if (definition.particle.kind === 'sprite') {
+    if (spriteSource === undefined) {
+      throw new Error(`[rn-gamekit/particles] effect "${effect}" declares kind "sprite" but no spriteSource was provided — resolve the sheet via the asset store before rendering`);
+    }
+    assertUniformParticleSpriteRatio(definition.particle.size.width, definition.particle.size.height, spriteSource.frame.width, spriteSource.frame.height);
+    return /*#__PURE__*/_jsx(SpriteSlots, {
+      clock: presentation.clock,
+      registry: presentation.registry,
+      effect: effect,
+      capacity: definition.capacity,
+      image: spriteSource.image,
+      frameRect: spriteSource.frame,
+      drawWidth: definition.particle.size.width,
+      drawHeight: definition.particle.size.height,
+      cullExtent: cullExtent,
+      fadeOut: definition.fadeOut,
+      gravityX: definition.gravity.x,
+      gravityY: definition.gravity.y,
+      width: width,
+      height: height,
+      space: definition.space,
+      camera: camera,
+      viewport: viewport
+    });
+  }
+  return /*#__PURE__*/_jsx(ShapeBatch, {
+    clock: presentation.clock,
+    registry: presentation.registry,
+    effect: effect,
+    capacity: definition.capacity,
+    shape: definition.particle.shape === 'rectangle' ? 'rect' : 'circle',
+    radius: definition.particle.radius ?? 3,
+    rectWidth: definition.particle.width ?? 6,
+    rectHeight: definition.particle.height ?? 6,
+    cullExtent: cullExtent,
+    color: definition.particle.color ?? '#ffffff',
+    fadeOut: definition.fadeOut,
+    gravityX: definition.gravity.x,
+    gravityY: definition.gravity.y,
+    width: width,
+    height: height,
+    space: definition.space,
+    camera: camera,
+    viewport: viewport
+  });
+}
+
+/**
+ * Analytic transform for one emission at the given ACTIVE time.
+ *
+ * T15-TF3: opacity honors the definition's fade policy — `fadeOut: true`
+ * ramps `1 -> t`, `fadeOut: false` stays fully opaque for the whole life.
+ */
+export function sampleEmission(e, now, gravityX, gravityY, fadeOut) {
+  'worklet';
+
+  const age = now - e.bornAt;
+  if (age < 0 || age >= e.lifetime) {
+    return {
+      x: 0,
+      y: 0,
+      rotation: 0,
+      scale: 0,
+      opacity: 0,
+      alive: false
+    };
+  }
+  const t = age / e.lifetime;
+  const x = e.originX + e.vx * age + 0.5 * gravityX * age * age;
+  const y = e.originY + e.vy * age + 0.5 * gravityY * age * age;
+  const rotation = e.rotation + e.rotationSpeed * age;
+  // T20A-R1: definitions guarantee non-negative scale. The clamp keeps any
+  // legacy negative `scaleOverLife` value DEFINED (collapse to a point)
+  // instead of handing Skia a signed radius or rectangle extent.
+  const scale = Math.max(0, e.scaleStart + (e.scaleEnd - e.scaleStart) * t);
+  const opacity = fadeOut ? 1 - t : 1;
+  return {
+    x,
+    y,
+    rotation,
+    scale,
+    opacity,
+    alive: true
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Shapes: ONE immediate Picture built in ONE worklet per effect (T15-RF5).
+// ---------------------------------------------------------------------------
+
+function ShapeBatch(props) {
+  const {
+    clock,
+    registry,
+    effect,
+    capacity,
+    shape,
+    radius,
+    rectWidth,
+    rectHeight,
+    color,
+    fadeOut,
+    gravityX,
+    gravityY,
+    width,
+    height,
+    space,
+    cullExtent,
+    camera,
+    viewport
+  } = props;
+  const picture = useDerivedValue(() => {
+    'worklet';
+
+    const reg = registry.value;
+    const entry = reg.effects[effect];
+    const now = clock.value;
+    // Culling bounds computed ONCE per revision. World space without a
+    // presented camera falls back to the resolved viewport bounds (never
+    // fail-closed hide); the particle extent keeps crossings visible.
+    const bounds = space === 'world' ? camera?.value?.camera === undefined ? viewportWorldBounds(viewport, PARTICLE_CULL_PADDING) : cameraVisibleWorldBounds(camera, viewport, PARTICLE_CULL_PADDING) : screenVisibleBounds(width, height, PARTICLE_CULL_PADDING);
+    const recorder = Skia.PictureRecorder();
+    const canvas = recorder.beginRecording();
+    if (entry === undefined) return recorder.finishRecordingAsPicture();
+    const paint = Skia.Paint();
+    paint.setColor(Skia.Color(color));
+    const particles = entry.particles;
+    for (let i = 0; i < particles.length && i < capacity; i++) {
+      const e = particles[i];
+      const s = sampleEmission(e, now, gravityX, gravityY, fadeOut);
+      if (!s.alive || s.opacity <= 0) continue;
+      if (!visibleInBounds(s.x, s.y, cullExtent, bounds)) continue;
+      paint.setAlphaf(Math.max(0, Math.min(1, s.opacity)));
+      if (shape === 'circle') {
+        canvas.drawCircle(s.x, s.y, radius * s.scale, paint);
+      } else {
+        const w = rectWidth * s.scale;
+        const h = rectHeight * s.scale;
+        const matrix = Skia.Matrix().translate(s.x, s.y).rotate(s.rotation);
+        canvas.save();
+        canvas.concat(matrix);
+        canvas.drawRect({
+          x: -w / 2,
+          y: -h / 2,
+          width: w,
+          height: h
+        }, paint);
+        canvas.restore();
+      }
+    }
+    return recorder.finishRecordingAsPicture();
+  });
+  return /*#__PURE__*/_jsx(Picture, {
+    picture: picture
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Sprites: fixed-capacity Atlas buffers filled by ONE worklet (T15-F3/R4/SF2).
+// ---------------------------------------------------------------------------
+
+function SpriteSlots(props) {
+  const {
+    clock,
+    registry,
+    effect,
+    capacity,
+    image,
+    frameRect,
+    drawWidth,
+    drawHeight,
+    fadeOut,
+    gravityX,
+    gravityY,
+    width,
+    height,
+    space,
+    cullExtent,
+    camera,
+    viewport
+  } = props;
+
+  // UI-owned buffers created once per mount (T15-SF1). Colors use the
+  // supported Skia color buffer (T15-TF3): each entry is an SkColor
+  // Float32Array [r,g,b,a] mutated on the UI runtime.
+  const rects = useRectBuffer(capacity, rect => {
+    'worklet';
+
+    rect.setXYWH(0, 0, 0, 0);
+  });
+  const xforms = useRSXformBuffer(capacity, xform => {
+    'worklet';
+
+    xform.set(1, 0, 0, 0);
+  });
+  const colors = useColorBuffer(capacity, color => {
+    'worklet';
+
+    color[0] = 1;
+    color[1] = 1;
+    color[2] = 1;
+    color[3] = 0;
+  });
+  useDerivedValue(() => {
+    'worklet';
+
+    const reg = registry.value;
+    const entry = reg.effects[effect];
+    const now = clock.value;
+    const bounds = space === 'world' ? camera?.value?.camera === undefined ? viewportWorldBounds(viewport, PARTICLE_CULL_PADDING) : cameraVisibleWorldBounds(camera, viewport, PARTICLE_CULL_PADDING) : screenVisibleBounds(width, height, PARTICLE_CULL_PADDING);
+    for (let i = 0; i < capacity; i++) {
+      const rectSlot = rects.value[i];
+      const xformSlot = xforms.value[i];
+      const colorSlot = colors.value[i];
+      if (rectSlot === undefined || xformSlot === undefined || colorSlot === undefined) continue;
+      let placed = false;
+      if (entry !== undefined && i < entry.particles.length) {
+        const e = entry.particles[i];
+        const age = now - e.bornAt;
+        if (age >= 0 && age < e.lifetime) {
+          const t = age / e.lifetime;
+          const x = e.originX + e.vx * age + 0.5 * gravityX * age * age;
+          const y = e.originY + e.vy * age + 0.5 * gravityY * age * age;
+          if (visibleInBounds(x, y, cullExtent, bounds)) {
+            const op = fadeOut ? 1 - t : 1;
+            const xf = particleSpriteXform({
+              x,
+              y,
+              rotation: e.rotation + e.rotationSpeed * age,
+              // T20A-R1: non-negative clamp — see the shape sampler note.
+              scale: Math.max(0, e.scaleStart + (e.scaleEnd - e.scaleStart) * t),
+              drawWidth,
+              drawHeight,
+              frameWidth: frameRect.width,
+              frameHeight: frameRect.height
+            });
+            rectSlot.setXYWH(frameRect.x, frameRect.y, frameRect.width, frameRect.height);
+            xformSlot.set(xf.scos, xf.ssin, xf.tx, xf.ty);
+            // White modulates the texture; alpha carries sampled fade.
+            colorSlot[0] = 1;
+            colorSlot[1] = 1;
+            colorSlot[2] = 1;
+            colorSlot[3] = Math.max(0, Math.min(1, op));
+            placed = true;
+          }
+        }
+      }
+      if (!placed) {
+        // Hide inactive/culled slots AND clear stale alpha (T15-SF2).
+        rectSlot.setXYWH(0, 0, 0, 0);
+        colorSlot[0] = 1;
+        colorSlot[1] = 1;
+        colorSlot[2] = 1;
+        colorSlot[3] = 0;
+      }
+    }
+    return colors;
+  });
+  return /*#__PURE__*/_jsx(Atlas, {
+    image: image,
+    sprites: rects,
+    transforms: xforms,
+    colors: colors
+  });
+}
+//# sourceMappingURL=ParticleView.js.map

package/lib/module/react/particles/ParticleView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useContext","useMemo","Atlas","Picture","Skia","useColorBuffer","useRectBuffer","useRSXformBuffer","useDerivedValue","GameWorldContext","PARTICLE_CULL_PADDING","cameraVisibleWorldBounds","maxParticleExtent","screenVisibleBounds","viewportWorldBounds","visibleInBounds","assertUniformParticleSpriteRatio","particleSpriteXform","jsx","_jsx","ParticleView","system","effect","width","height","presentation","spriteSource","definition","bindPresentation","cullExtent","world","camera","viewport","particle","kind","undefined","Error","size","frame","SpriteSlots","clock","registry","capacity","image","frameRect","drawWidth","drawHeight","fadeOut","gravityX","gravity","x","gravityY","y","space","ShapeBatch","shape","radius","rectWidth","rectHeight","color","sampleEmission","e","now","age","bornAt","lifetime","rotation","scale","opacity","alive","t","originX","vx","originY","vy","rotationSpeed","Math","max","scaleStart","scaleEnd","props","picture","reg","value","entry","effects","bounds","recorder","PictureRecorder","canvas","beginRecording","finishRecordingAsPicture","paint","Paint","setColor","Color","particles","i","length","s","setAlphaf","min","drawCircle","w","h","matrix","Matrix","translate","rotate","save","concat","drawRect","restore","rects","rect","setXYWH","xforms","xform","set","colors","rectSlot","xformSlot","colorSlot","placed","op","xf","frameWidth","frameHeight","scos","ssin","tx","ty","sprites","transforms"],"sourceRoot":"../../../../src","sources":["react/particles/ParticleView.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/react/particles/culling.js

@@ -0,0 +1,115 @@
+"use strict";
+
+/** Conservative world-space AABB used for presentation-only culling. */
+import { rotatedHalfExtents2D } from "../../camera2d/extents.js";
+export const PARTICLE_CULL_PADDING = 16;
+
+/**
+ * The world region visible through the PRESENTED camera (T15-RF2).
+ *
+ * The logical viewport rectangle is rotated/zoomed by the camera, so its
+ * axis-aligned world bounds are the center plus the rotated half-extents:
+ *
+ *   ex = |hx·cosθ| + |hy·sinθ|, ey = |hx·sinθ| + |hy·cosθ|
+ *
+ * which is the exact AABB of the rotated view rect. Padding is applied in
+ * world units. Worklet-safe; shared by the shape Picture and Atlas paths so
+ * their culling results cannot diverge.
+ */
+export function cameraVisibleWorldBounds(camera, viewport, pad) {
+  'worklet';
+
+  if (camera === null || viewport === null) return undefined;
+  const view = viewport.value?.visibleLogicalBounds;
+  const cam = camera.value?.camera;
+  if (view === undefined || cam === undefined) return undefined;
+  const hx = view.width / (2 * cam.zoom);
+  const hy = view.height / (2 * cam.zoom);
+  const extent = rotatedHalfExtents2D(hx, hy, cam.rotationRadians);
+  const ex = extent.x + pad;
+  const ey = extent.y + pad;
+  return {
+    minX: cam.center.x - ex,
+    minY: cam.center.y - ey,
+    maxX: cam.center.x + ex,
+    maxY: cam.center.y + ey
+  };
+}
+export function screenVisibleBounds(width, height, pad) {
+  'worklet';
+
+  return {
+    minX: -pad,
+    minY: -pad,
+    maxX: width + pad,
+    maxY: height + pad
+  };
+}
+
+/**
+ * Viewport-only world bounds for presentation without a presented camera
+ * (GS-PARTICLE-02): the tile layer's viewport-only path — the resolved
+ * logical bounds expanded by world-unit padding. World particles inside an
+ * ordinary viewport-only GameWorld2D render instead of failing closed.
+ */
+export function viewportWorldBounds(viewport, pad) {
+  'worklet';
+
+  const view = viewport?.value?.visibleLogicalBounds;
+  if (view === undefined) return undefined;
+  return {
+    minX: view.x - pad,
+    minY: view.y - pad,
+    maxX: view.x + view.width + pad,
+    maxY: view.y + view.height + pad
+  };
+}
+
+/**
+ * Circle-vs-bounds visibility (GS-PARTICLE-02): the particle's
+ * conservative extent (bounding radius from geometry and scale endpoints)
+ * expands the bounds, so partially crossing shapes stay visible while
+ * fully outside shapes cull. Extra overscan stays in the bounds padding —
+ * never folded into the shape extent. A missing bounds still hides.
+ */
+export function visibleInBounds(x, y, extent, b) {
+  'worklet';
+
+  if (b === undefined) return false;
+  return x >= b.minX - extent && x <= b.maxX + extent && y >= b.minY - extent && y <= b.maxY + extent;
+}
+
+/**
+ * Conservative per-effect cull extent (GS-PARTICLE-02): the bounding
+ * radius of the authored geometry times the largest scale endpoint, so
+ * rotation can never push drawn pixels past the culled region. Circles
+ * use radius; rectangles and sprites use half the diagonal; absent
+ * dimensions fall back to the render defaults. The legacy scale range
+ * contributes its maximum; definitions without scale use 1.
+ */
+export function maxParticleExtent(definition) {
+  'worklet';
+
+  let maxScale = 1;
+  const scale = definition.scale;
+  if (scale !== undefined) {
+    if (scale.start.max > maxScale) maxScale = scale.start.max;
+    if (scale.end.max > maxScale) maxScale = scale.end.max;
+  }
+  const legacy = definition.scaleOverLife;
+  if (legacy !== undefined && legacy.max > maxScale) maxScale = legacy.max;
+  const particle = definition.particle;
+  if (particle.kind === 'sprite') {
+    return Math.hypot(particle.size.width, particle.size.height) / 2 * maxScale;
+  }
+  if (particle.shape === 'circle') {
+    return (particle.radius ?? 3) * maxScale;
+  }
+  return Math.hypot(particle.width ?? 6, particle.height ?? 6) / 2 * maxScale;
+}
+// keeping this pure module free of Reanimated/RN imports while accepting
+// real SharedValue<CameraCut2D|ResolvedViewport2D> instances.
+// Minimal structural mirrors of the shared refs the view layer passes in,
+// keeping this pure module free of Reanimated/RN imports while accepting
+// real SharedValue<CameraCut2D|ResolvedViewport2D> instances.
+//# sourceMappingURL=culling.js.map

package/lib/module/react/particles/culling.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["rotatedHalfExtents2D","PARTICLE_CULL_PADDING","cameraVisibleWorldBounds","camera","viewport","pad","undefined","view","value","visibleLogicalBounds","cam","hx","width","zoom","hy","height","extent","rotationRadians","ex","x","ey","y","minX","center","minY","maxX","maxY","screenVisibleBounds","viewportWorldBounds","visibleInBounds","b","maxParticleExtent","definition","maxScale","scale","start","max","end","legacy","scaleOverLife","particle","kind","Math","hypot","size","shape","radius"],"sourceRoot":"../../../../src","sources":["react/particles/culling.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/react/particles/index.js

@@ -0,0 +1,7 @@
+"use strict";
+
+export { ParticleView } from "./ParticleView.js";
+export { useParticlePresentation } from "./useParticlePresentation.js";
+export { particleSpriteXform, assertUniformParticleSpriteRatio } from "./spriteXForm.js";
+export { cameraVisibleWorldBounds, screenVisibleBounds, visibleInBounds, PARTICLE_CULL_PADDING } from "./culling.js";
+//# sourceMappingURL=index.js.map

package/lib/module/react/particles/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ParticleView","useParticlePresentation","particleSpriteXform","assertUniformParticleSpriteRatio","cameraVisibleWorldBounds","screenVisibleBounds","visibleInBounds","PARTICLE_CULL_PADDING"],"sourceRoot":"../../../../src","sources":["react/particles/index.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,mBAAgB;AAE7C,SAASC,uBAAuB,QAAQ,8BAA2B;AAEnE,SAASC,mBAAmB,EAAEC,gCAAgC,QAAQ,kBAAe;AACrF,SAASC,wBAAwB,EAAEC,mBAAmB,EAAEC,eAAe,EAAEC,qBAAqB,QAAQ,cAAW","ignoreList":[]}

package/lib/module/react/particles/spriteXForm.js

@@ -0,0 +1,45 @@
+"use strict";
+
+/**
+ * Particle sprite transform (T15-RF4).
+ *
+ * Atlas RSXform carries rotation AND uniform scale in its 2×2 part:
+ * \`scos = s·cosθ\`, \`ssin = s·sinθ\`. The pivot compensation uses the
+ * AUTHORED draw size (the definition's \`size\`), and the source rect stays
+ * the sheet frame — so the authored-to-source ratio scales the drawn sprite.
+ *
+ * v1 requires the authored size ratio to match the source frame ratio; a
+ * mismatch is a structured error (RSXform cannot express nonuniform scale).
+ */
+import { ParticleError } from "../../particles/errors.js";
+export function particleSpriteXform(input) {
+  'worklet';
+
+  // T15-SF2: Atlas draws the SOURCE rect, so the authored-to-source ratio
+  // must ride in scos/ssin or the drawn size ignores particle.size entirely.
+  const effScale = input.scale * (input.drawWidth / input.frameWidth);
+  const cos = Math.cos(input.rotation);
+  const sin = Math.sin(input.rotation);
+  // Center anchor pivot against the DRAWN (scaled source) extent.
+  const px = input.frameWidth / 2 * effScale;
+  const py = input.frameHeight / 2 * effScale;
+  return {
+    scos: effScale * cos,
+    ssin: effScale * sin,
+    tx: input.x - px * cos + py * sin,
+    ty: input.y - px * sin - py * cos
+  };
+}
+
+/**
+ * Validate that the authored size ratio matches the source frame ratio so
+ * uniform-scale Atlas drawing preserves the intended aspect.
+ */
+export function assertUniformParticleSpriteRatio(drawWidth, drawHeight, frameWidth, frameHeight) {
+  const drawRatio = drawWidth / drawHeight;
+  const frameRatio = frameWidth / frameHeight;
+  if (!Number.isFinite(drawRatio) || !Number.isFinite(frameRatio) || Math.abs(drawRatio - frameRatio) > 1e-3) {
+    throw new ParticleError(`[rn-gamekit/particles] sprite effect size ${drawWidth}x${drawHeight} does not match source frame ${frameWidth}x${frameHeight} aspect — nonuniform sprite scaling is not supported in v1`);
+  }
+}
+//# sourceMappingURL=spriteXForm.js.map

package/lib/module/react/particles/spriteXForm.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ParticleError","particleSpriteXform","input","effScale","scale","drawWidth","frameWidth","cos","Math","rotation","sin","px","py","frameHeight","scos","ssin","tx","x","ty","y","assertUniformParticleSpriteRatio","drawHeight","drawRatio","frameRatio","Number","isFinite","abs"],"sourceRoot":"../../../../src","sources":["react/particles/spriteXForm.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,aAAa,QAAQ,2BAAwB;AAyBtD,OAAO,SAASC,mBAAmBA,CAACC,KAA+B,EAAuB;EACxF,SAAS;;EACT;EACA;EACA,MAAMC,QAAQ,GAAGD,KAAK,CAACE,KAAK,IAAIF,KAAK,CAACG,SAAS,GAAGH,KAAK,CAACI,UAAU,CAAC;EACnE,MAAMC,GAAG,GAAGC,IAAI,CAACD,GAAG,CAACL,KAAK,CAACO,QAAQ,CAAC;EACpC,MAAMC,GAAG,GAAGF,IAAI,CAACE,GAAG,CAACR,KAAK,CAACO,QAAQ,CAAC;EACpC;EACA,MAAME,EAAE,GAAIT,KAAK,CAACI,UAAU,GAAG,CAAC,GAAIH,QAAQ;EAC5C,MAAMS,EAAE,GAAIV,KAAK,CAACW,WAAW,GAAG,CAAC,GAAIV,QAAQ;EAC7C,OAAO;IACLW,IAAI,EAAEX,QAAQ,GAAGI,GAAG;IACpBQ,IAAI,EAAEZ,QAAQ,GAAGO,GAAG;IACpBM,EAAE,EAAEd,KAAK,CAACe,CAAC,GAAGN,EAAE,GAAGJ,GAAG,GAAGK,EAAE,GAAGF,GAAG;IACjCQ,EAAE,EAAEhB,KAAK,CAACiB,CAAC,GAAGR,EAAE,GAAGD,GAAG,GAAGE,EAAE,GAAGL;EAChC,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASa,gCAAgCA,CAC9Cf,SAAiB,EACjBgB,UAAkB,EAClBf,UAAkB,EAClBO,WAAmB,EACb;EACN,MAAMS,SAAS,GAAGjB,SAAS,GAAGgB,UAAU;EACxC,MAAME,UAAU,GAAGjB,UAAU,GAAGO,WAAW;EAC3C,IAAI,CAACW,MAAM,CAACC,QAAQ,CAACH,SAAS,CAAC,IAAI,CAACE,MAAM,CAACC,QAAQ,CAACF,UAAU,CAAC,IAAIf,IAAI,CAACkB,GAAG,CAACJ,SAAS,GAAGC,UAAU,CAAC,GAAG,IAAI,EAAE;IAC1G,MAAM,IAAIvB,aAAa,CACrB,6CAA6CK,SAAS,IAAIgB,UAAU,gCAAgCf,UAAU,IAAIO,WAAW,4DAC/H,CAAC;EACH;AACF","ignoreList":[]}