rn-gamekit 0.1.0

package/lib/module/react/sprites/GameSprite.js

@@ -0,0 +1,116 @@
+"use strict";
+
+/**
+ * `GameSprite` — the common GameKit sprite integration (T7.6).
+ *
+ * Accepts the renderer's commit/alpha shared values, narrows the snapshot
+ * by `scene`, invokes one worklet `select` mapper, and drives the
+ * underlying `Sprite` through coherent derived values. The selector's scene
+ * typing is exact — a `scene="play"` selector receives only the play
+ * snapshot without casts.
+ */
+import { useDerivedValue } from 'react-native-reanimated';
+import { Sprite } from "./Sprite.js";
+
+/** Interpolation context for the select mapper. */
+
+/** The discrete + interpolated presentation selection. */
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Select the frame name for a clip + elapsed time (loop/once semantics).
+ * Reads the descriptor's animation table; the result is resolved against
+ * the frame rectangles by the caller. Reuses the pure sampler's semantics.
+ */
+export function spriteFrameNameForClip(animations, clip, elapsedMs) {
+  'worklet';
+
+  const animation = animations[clip];
+  if (animation === undefined || animation.frames.length === 0) {
+    return clip;
+  }
+  const duration = animation.frameDurationMs;
+  const count = animation.frames.length;
+  const index = animation.mode === 'once' ? Math.min(Math.floor(elapsedMs / duration), count - 1) : Math.floor(elapsedMs / duration) % count;
+  return animation.frames[index] ?? animation.frames[0] ?? clip;
+}
+export function GameSprite({
+  scene,
+  commit,
+  alpha,
+  source,
+  anchor,
+  select
+}) {
+  const selection = useDerivedValue(() => {
+    'worklet';
+
+    const envelope = commit.value;
+    if (envelope.scene !== scene) {
+      return undefined;
+    }
+    const current = envelope.current;
+    if (current === undefined) {
+      // The frame has not been seeded for this session yet (session swap on
+      // the persistent surface): present nothing until the first commit.
+      return undefined;
+    }
+    const context = {
+      // The first commit has no previous snapshot; the current one stands in
+      // so the initial presentation interpolates from itself (alpha 0).
+      previous: envelope.previous ?? envelope.current,
+      current,
+      alpha: alpha.value
+    };
+    return select(context);
+  }, [commit, alpha, scene, select]);
+  const x = useDerivedValue(() => selection.value?.x ?? 0);
+  const y = useDerivedValue(() => selection.value?.y ?? 0);
+  const rotation = useDerivedValue(() => selection.value?.rotation ?? 0);
+  const scale = useDerivedValue(() => selection.value?.scale ?? 1);
+  const opacity = useDerivedValue(() => selection.value?.opacity ?? 1);
+  const flipX = useDerivedValue(() => selection.value?.flipX ?? false);
+  const flipY = useDerivedValue(() => selection.value?.flipY ?? false);
+  const visible = useDerivedValue(() => selection.value?.visible ?? true);
+  const frameName = useDerivedValue(() => {
+    'worklet';
+
+    const selectionValue = selection.value;
+    if (selectionValue === undefined) {
+      return undefined;
+    }
+    if (selectionValue.frame !== undefined) {
+      return selectionValue.frame;
+    }
+    if (selectionValue.clip === undefined) {
+      return undefined;
+    }
+    if (source.descriptor.kind !== 'sprite-sheet') {
+      return undefined;
+    }
+    // R3: the sampler reads the descriptor's animation table (clips), never
+    // the frame-rectangle map; the returned frame name is resolved against
+    // the frame rectangles in the Sprite's rect modifier.
+    const sheet = source;
+    return spriteFrameNameForClip(sheet.descriptor.animations, selectionValue.clip, selectionValue.elapsedMs ?? 0);
+  });
+  const animated = {
+    x: x,
+    y: y,
+    rotation: rotation,
+    scale: scale,
+    opacity: opacity,
+    flipX: flipX,
+    flipY: flipY,
+    visible: visible
+  };
+  const props = {
+    source,
+    frame: source.descriptor.kind === 'sprite-sheet' ? frameName : undefined,
+    anchor,
+    ...animated
+  };
+  return /*#__PURE__*/_jsx(Sprite, {
+    ...props
+  });
+}
+//# sourceMappingURL=GameSprite.js.map

package/lib/module/react/sprites/GameSprite.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useDerivedValue","Sprite","jsx","_jsx","spriteFrameNameForClip","animations","clip","elapsedMs","animation","undefined","frames","length","duration","frameDurationMs","count","index","mode","Math","min","floor","GameSprite","scene","commit","alpha","source","anchor","select","selection","envelope","value","current","context","previous","x","y","rotation","scale","opacity","flipX","flipY","visible","frameName","selectionValue","frame","descriptor","kind","sheet","animated","props"],"sourceRoot":"../../../../src","sources":["react/sprites/GameSprite.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/react/sprites/GameWorld2D.js

@@ -0,0 +1,44 @@
+"use strict";
+
+/**
+ * `GameWorld2D` — the viewport transform group (T7.6).
+ *
+ * Applies the resolved viewport offset/scale exactly once to all child
+ * sprites. It adds no camera state, subscribes no React per frame, and is
+ * not a camera API. Raw Skia nodes may be nested inside.
+ */
+
+import { Group } from '@shopify/react-native-skia';
+import { useDerivedValue } from 'react-native-reanimated';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The viewport transform as a Skia element list:
+ * `T(offset) · S(scale)` — logical units map to surface points.
+ */
+export function viewportTransform(viewport) {
+  'worklet';
+
+  if (viewport === undefined) {
+    return [];
+  }
+  return [{
+    translateX: viewport.offsetX
+  }, {
+    translateY: viewport.offsetY
+  }, {
+    scaleX: viewport.scale
+  }, {
+    scaleY: viewport.scale
+  }];
+}
+export function GameWorld2D({
+  viewport,
+  children
+}) {
+  const transform = useDerivedValue(() => viewportTransform(viewport.value));
+  return /*#__PURE__*/_jsx(Group, {
+    transform: transform,
+    children: children
+  });
+}
+//# sourceMappingURL=GameWorld2D.js.map

package/lib/module/react/sprites/GameWorld2D.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Group","useDerivedValue","jsx","_jsx","viewportTransform","viewport","undefined","translateX","offsetX","translateY","offsetY","scaleX","scale","scaleY","GameWorld2D","children","transform","value"],"sourceRoot":"../../../../src","sources":["react/sprites/GameWorld2D.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,KAAK,QAAQ,4BAA4B;AAClD,SAASC,eAAe,QAA0B,yBAAyB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAI5E;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAACC,QAAwC,EAKtE;EACF,SAAS;;EACT,IAAIA,QAAQ,KAAKC,SAAS,EAAE;IAC1B,OAAO,EAAE;EACX;EACA,OAAO,CACL;IAAEC,UAAU,EAAEF,QAAQ,CAACG;EAAQ,CAAC,EAChC;IAAEC,UAAU,EAAEJ,QAAQ,CAACK;EAAQ,CAAC,EAChC;IAAEC,MAAM,EAAEN,QAAQ,CAACO;EAAM,CAAC,EAC1B;IAAEC,MAAM,EAAER,QAAQ,CAACO;EAAM,CAAC,CAC3B;AACH;AAEA,OAAO,SAASE,WAAWA,CAAC;EAC1BT,QAAQ;EACRU;AAKF,CAAC,EAAE;EACD,MAAMC,SAAS,GAAGf,eAAe,CAAC,MAAMG,iBAAiB,CAACC,QAAQ,CAACY,KAAK,CAAC,CAAC;EAC1E,oBAAOd,IAAA,CAACH,KAAK;IAACgB,SAAS,EAAEA,SAAmB;IAAAD,QAAA,EAAEA;EAAQ,CAAQ,CAAC;AACjE","ignoreList":[]}

package/lib/module/react/sprites/Sprite.js

@@ -0,0 +1,147 @@
+"use strict";
+
+/**
+ * `Sprite` — the retained sprite primitive (T7.6).
+ *
+ * Renders one full-image sprite or one sprite-sheet frame through a
+ * source-verified Skia path: full images use `<Image>`; sheet frames use a
+ * single-entry Atlas (the RSXform carries rotation + position, a wrapping
+ * Group applies the scale/flip part around the anchor). All animatable
+ * properties accept plain numbers or Reanimated shared/derived values
+ * without mirroring them through React state. Drawing order is React child
+ * order. The sprite never subscribes React to the game frame.
+ */
+import { useMemo } from 'react';
+import { Atlas, Group } from '@shopify/react-native-skia';
+import { useDerivedValue } from 'react-native-reanimated';
+import { useRectBuffer, useRSXformBuffer } from '@shopify/react-native-skia';
+import { computeSpriteRsxform, resolveSpriteFrameRect, spriteGroupCorrection } from "./spriteTransform.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+export { resolveSpriteFrameRect } from "./spriteTransform.js";
+export function Sprite({
+  source,
+  frame,
+  clip,
+  elapsedMs = 0,
+  x = 0,
+  y = 0,
+  rotation = 0,
+  scale = 1,
+  anchor = {
+    x: 0,
+    y: 0
+  },
+  flipX = false,
+  flipY = false,
+  opacity = 1,
+  tint,
+  sampling,
+  visible = true
+}) {
+  const image = source.image;
+
+  // Worklet-safe frame resolution: an explicit `frame` wins; otherwise the
+  // clip + elapsed time select the frame (the clip/elapsed may be animated
+  // shared values, so the resolution happens inside the rect modifier).
+  const resolveFrameRectWorklet = rect => {
+    'worklet';
+
+    const clipValue = typeof clip === 'string' ? clip : clip?.value;
+    const elapsedValue = typeof elapsedMs === 'number' ? elapsedMs : elapsedMs?.value;
+    let name = typeof frame === 'string' ? frame : frame?.value;
+    if (name === undefined && source.descriptor.kind === 'sprite-sheet' && clipValue !== undefined) {
+      const sheet = source;
+      // R3: resolve the clip through the descriptor's animation table, then
+      // the returned frame name through the frame rectangles below.
+      const animation = sheet.descriptor.animations[clipValue];
+      if (animation !== undefined && animation.frames.length > 0) {
+        const duration = animation.frameDurationMs;
+        const count = animation.frames.length;
+        const index = animation.mode === 'once' ? Math.min(Math.floor((elapsedValue ?? 0) / duration), count - 1) : Math.floor((elapsedValue ?? 0) / duration) % count;
+        name = animation.frames[index] ?? animation.frames[0];
+      }
+    }
+    const frameRect = source.descriptor.kind === 'image' ? {
+      x: 0,
+      y: 0,
+      width: source.width,
+      height: source.height
+    } : name === undefined ? undefined : source.frames[name];
+    if (frameRect === undefined) {
+      if (name === undefined) {
+        // RF4: the selection has not been published yet (scene mismatch or a
+        // shared frame before its first value): present nothing, never throw.
+        rect.setXYWH(0, 0, 0, 0);
+        return;
+      }
+      throw new Error(`frame ${JSON.stringify(name)} does not belong to this sprite sheet (loaded frames: ${Object.keys(source.frames).join(', ')})`);
+    }
+    rect.setXYWH(frameRect.x, frameRect.y, frameRect.width, frameRect.height);
+  };
+  const staticFrame = typeof frame === 'string' ? frame : undefined;
+  const frameSize = useMemo(() => resolveSpriteFrameRect(source, staticFrame), [source, staticFrame]);
+  const input = {
+    x,
+    y,
+    rotation,
+    scale,
+    flipX,
+    flipY,
+    anchorX: anchor.x,
+    anchorY: anchor.y,
+    frameWidth: frameSize.width,
+    frameHeight: frameSize.height
+  };
+  const rects = useRectBuffer(1, resolveFrameRectWorklet);
+  const xforms = useRSXformBuffer(1, xform => {
+    'worklet';
+
+    // RF4: resolve the selected frame's rectangle and dimensions in the same
+    // worklet update so the anchor math always uses the current frame size.
+    const name = typeof frame === 'string' ? frame : frame?.value;
+    let width = frameSize.width;
+    let height = frameSize.height;
+    if (name !== undefined && source.descriptor.kind === 'sprite-sheet') {
+      const rect = source.frames[name];
+      if (rect !== undefined) {
+        width = rect.width;
+        height = rect.height;
+      }
+    }
+    const result = computeSpriteRsxform({
+      ...input,
+      frameWidth: width,
+      frameHeight: height
+    });
+    xform.set(result.scos, result.ssin, result.tx, result.ty);
+  });
+  const groupTransform = useMemo(() => spriteGroupCorrection(input),
+  // The correction reads animated values at draw time; the element list
+  // identity is stable (values are shared-value reads inside the group).
+  [anchor.x, anchor.y, frameSize.width, frameSize.height]);
+  const colors = useMemo(() => tint === undefined ? undefined : [tint], [tint]);
+
+  // The Skia Group has no `visible` prop: hiding is expressed as a combined
+  // opacity so the component stays mounted (topology is never remounted per
+  // frame) while the draw is fully transparent. RF4: derived on the UI
+  // runtime for every static/shared combination of opacity and visible.
+  const effectiveOpacity = useDerivedValue(() => {
+    'worklet';
+
+    const o = typeof opacity === 'number' ? opacity : opacity.value;
+    const v = typeof visible === 'boolean' ? visible : visible.value;
+    return v ? o : 0;
+  }, [opacity, visible]);
+  return /*#__PURE__*/_jsx(Group, {
+    transform: groupTransform,
+    opacity: effectiveOpacity,
+    children: /*#__PURE__*/_jsx(Atlas, {
+      image: image,
+      sprites: rects,
+      transforms: xforms,
+      colors: colors,
+      sampling: sampling ?? 'nearest'
+    })
+  });
+}
+//# sourceMappingURL=Sprite.js.map

package/lib/module/react/sprites/Sprite.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useMemo","Atlas","Group","useDerivedValue","useRectBuffer","useRSXformBuffer","computeSpriteRsxform","resolveSpriteFrameRect","spriteGroupCorrection","jsx","_jsx","Sprite","source","frame","clip","elapsedMs","x","y","rotation","scale","anchor","flipX","flipY","opacity","tint","sampling","visible","image","resolveFrameRectWorklet","rect","clipValue","value","elapsedValue","name","undefined","descriptor","kind","sheet","animation","animations","frames","length","duration","frameDurationMs","count","index","mode","Math","min","floor","frameRect","width","height","setXYWH","Error","JSON","stringify","Object","keys","join","staticFrame","frameSize","input","anchorX","anchorY","frameWidth","frameHeight","rects","xforms","xform","result","set","scos","ssin","tx","ty","groupTransform","colors","effectiveOpacity","o","v","transform","children","sprites","transforms"],"sourceRoot":"../../../../src","sources":["react/sprites/Sprite.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/react/sprites/SpriteBatch.js

@@ -0,0 +1,173 @@
+"use strict";
+
+/**
+ * `SpriteBatch` — the Atlas-backed shared-texture batch (T7.7).
+ *
+ * Draws many instances of one decoded sprite-sheet image through Skia's
+ * `Atlas` with fixed-capacity, UI-owned buffers. The normal path owns all
+ * derived-value plumbing: `select` maps the committed snapshot to the item
+ * array and `write` is a UI-runtime setter that writes transforms in place —
+ * no per-frame allocation, no per-frame React, no author-written
+ * `useDerivedValue` side effects.
+ *
+ * Contract:
+ * - `capacity` is fixed for the mounted batch; active count is explicit.
+ * - Writes past capacity are rejected in development; inactive slots are
+ *   hidden (zero-size) and never remount topology.
+ * - Item order is the drawing order; the anchor is uniform per batch.
+ * - The batch never disposes the image (the asset lease owns it).
+ */
+import { useMemo } from 'react';
+import { Atlas } from '@shopify/react-native-skia';
+import { useDerivedValue } from 'react-native-reanimated';
+import { useRectBuffer, useRSXformBuffer } from '@shopify/react-native-skia';
+import { computeSpriteRsxform } from "./spriteTransform.js";
+import { batchUpdatePolicy } from "./spriteBatchPolicy.js";
+
+/** The per-item write surface handed to the author's `write` mapper. */
+import { jsx as _jsx } from "react/jsx-runtime";
+function frameRectOf(source, frame) {
+  'worklet';
+
+  if (source.descriptor.kind === 'image') {
+    const image = source;
+    return {
+      x: 0,
+      y: 0,
+      width: image.width,
+      height: image.height
+    };
+  }
+  return source.frames[frame];
+}
+export function SpriteBatch({
+  scene,
+  commit,
+  alpha,
+  source,
+  capacity,
+  select,
+  write,
+  anchor = {
+    x: 0,
+    y: 0
+  }
+}) {
+  const image = source.image;
+  if (!Number.isInteger(capacity) || capacity <= 0) {
+    throw new Error(`SpriteBatch capacity must be a positive integer, got ${String(capacity)}`);
+  }
+  const rects = useRectBuffer(capacity, rect => {
+    'worklet';
+
+    rect.setXYWH(0, 0, 0, 0);
+  });
+  const xforms = useRSXformBuffer(capacity, xform => {
+    'worklet';
+
+    xform.set(1, 0, 0, 0);
+  });
+
+  // R7: one stable write coordinator for the batch lifetime; the per-update
+  // worklet only calls it (no per-frame coordinator allocation).
+  const writeApi = useMemo(() => ({
+    set: (index, frame, x, y, rotation, scale, visible = true) => {
+      'worklet';
+
+      if (index < 0 || index >= capacity) {
+        throw new Error(`SpriteBatch write index ${index} is outside the capacity ${capacity}`);
+      }
+      const rectSlot = rects.value[index];
+      const xformSlot = xforms.value[index];
+      if (rectSlot === undefined || xformSlot === undefined) {
+        return;
+      }
+      if (!visible) {
+        rectSlot.setXYWH(0, 0, 0, 0);
+        return;
+      }
+      const rect = frameRectOf(source, frame);
+      if (rect === undefined) {
+        throw new Error(`frame ${JSON.stringify(frame)} does not belong to this sprite sheet`);
+      }
+      rectSlot.setXYWH(rect.x, rect.y, rect.width, rect.height);
+      const rsxform = computeSpriteRsxform({
+        x,
+        y,
+        rotation,
+        scale,
+        flipX: false,
+        flipY: false,
+        anchorX: anchor.x,
+        anchorY: anchor.y,
+        frameWidth: rect.width,
+        frameHeight: rect.height
+      });
+      xformSlot.set(rsxform.scos, rsxform.ssin, rsxform.tx, rsxform.ty);
+    }
+  }),
+  // The buffers, source, and anchor are stable for the mounted batch.
+  [capacity, rects, xforms, source, anchor.x, anchor.y]);
+
+  // The batch's own UI mapper: one derived value reads the committed
+  // snapshot, runs the author's select + write per item, and reports the
+  // active count. Buffers are mutated in place; no objects are allocated
+  // per item per frame beyond the item array the select returns.
+  const activeCount = useDerivedValue(() => {
+    'worklet';
+
+    const envelope = commit.value;
+    if (envelope.scene !== scene) {
+      // RF8: leaving the scene clears every previously active slot so no
+      // stale sprite from the old scene stays visible.
+      for (let index = 0; index < capacity; index += 1) {
+        const slot = rects.value[index];
+        if (slot !== undefined) {
+          slot.setXYWH(0, 0, 0, 0);
+        }
+      }
+      return 0;
+    }
+    const items = select({
+      current: envelope.current,
+      alpha: alpha.value
+    });
+    const policy = batchUpdatePolicy(items.length, capacity, __DEV__);
+    if (policy.overflow) {
+      // RF8: production never crashes the UI runtime for ordinary data
+      // growth: hide the overflowing items.
+      for (let index = capacity; index < items.length; index += 1) {
+        const slot = rects.value[index];
+        if (slot !== undefined) {
+          slot.setXYWH(0, 0, 0, 0);
+        }
+      }
+    }
+    const count = policy.activeCount;
+    for (let index = 0; index < items.length; index += 1) {
+      const item = items[index];
+      if (item !== undefined) {
+        write(writeApi, item, index);
+      }
+    }
+    // Hide every inactive slot.
+    for (let index = count; index < capacity; index += 1) {
+      const slot = rects.value[index];
+      if (slot !== undefined) {
+        slot.setXYWH(0, 0, 0, 0);
+      }
+    }
+    return count;
+  }, [commit, alpha, scene, select, write, writeApi]);
+  void activeCount;
+
+  // The atlas renders the full buffer; the UI mapper keeps slots aligned.
+  const sampling = useMemo(() => 'nearest', []);
+  return /*#__PURE__*/_jsx(Atlas, {
+    image: image,
+    sprites: rects,
+    transforms: xforms,
+    sampling: sampling
+  });
+}
+//# sourceMappingURL=SpriteBatch.js.map

package/lib/module/react/sprites/SpriteBatch.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useMemo","Atlas","useDerivedValue","useRectBuffer","useRSXformBuffer","computeSpriteRsxform","batchUpdatePolicy","jsx","_jsx","frameRectOf","source","frame","descriptor","kind","image","x","y","width","height","frames","SpriteBatch","scene","commit","alpha","capacity","select","write","anchor","Number","isInteger","Error","String","rects","rect","setXYWH","xforms","xform","set","writeApi","index","rotation","scale","visible","rectSlot","value","xformSlot","undefined","JSON","stringify","rsxform","flipX","flipY","anchorX","anchorY","frameWidth","frameHeight","scos","ssin","tx","ty","activeCount","envelope","slot","items","current","policy","length","__DEV__","overflow","count","item","sampling","sprites","transforms"],"sourceRoot":"../../../../src","sources":["react/sprites/SpriteBatch.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/react/sprites/spriteBatchPolicy.js

@@ -0,0 +1,25 @@
+"use strict";
+
+/** Pure SpriteBatch update policy (RF8): the overflow decision and the
+ * active count. Development reports a structured error; production clamps
+ * and hides the overflow so the UI runtime never crashes for ordinary data
+ * growth. Runs inside the batch's update worklet, so it carries the worklet
+ * directive. */
+export function batchUpdatePolicy(itemsCount, capacity, dev) {
+  'worklet';
+
+  if (itemsCount <= capacity) {
+    return {
+      overflow: false,
+      activeCount: itemsCount
+    };
+  }
+  if (dev) {
+    throw new Error(`SpriteBatch overflow: ${itemsCount} items selected with capacity ${capacity}`);
+  }
+  return {
+    overflow: true,
+    activeCount: capacity
+  };
+}
+//# sourceMappingURL=spriteBatchPolicy.js.map

package/lib/module/react/sprites/spriteBatchPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["batchUpdatePolicy","itemsCount","capacity","dev","overflow","activeCount","Error"],"sourceRoot":"../../../../src","sources":["react/sprites/spriteBatchPolicy.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,iBAAiBA,CAC/BC,UAAkB,EAClBC,QAAgB,EAChBC,GAAY,EACkD;EAC9D,SAAS;;EACT,IAAIF,UAAU,IAAIC,QAAQ,EAAE;IAC1B,OAAO;MAAEE,QAAQ,EAAE,KAAK;MAAEC,WAAW,EAAEJ;IAAW,CAAC;EACrD;EACA,IAAIE,GAAG,EAAE;IACP,MAAM,IAAIG,KAAK,CACb,yBAAyBL,UAAU,iCAAiCC,QAAQ,EAC9E,CAAC;EACH;EACA,OAAO;IAAEE,QAAQ,EAAE,IAAI;IAAEC,WAAW,EAAEH;EAAS,CAAC;AAClD","ignoreList":[]}