@chipmobilesdk/rn-ads 0.7.0 → 0.8.0

package/lib/commonjs/testing/index.js

@@ -0,0 +1,389 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.FAKE_BANNER_TEST_ID = void 0;
+Object.defineProperty(exports, "adsEngineChecks", {
+  enumerable: true,
+  get: function () {
+    return _conformance.adsEngineChecks;
+  }
+});
+exports.allTestAdUnits = allTestAdUnits;
+exports.createFakeAdsEngine = createFakeAdsEngine;
+Object.defineProperty(exports, "createTestClock", {
+  enumerable: true,
+  get: function () {
+    return _clock.createTestClock;
+  }
+});
+Object.defineProperty(exports, "runAdsEngineConformance", {
+  enumerable: true,
+  get: function () {
+    return _conformance.runAdsEngineConformance;
+  }
+});
+var _react = _interopRequireDefault(require("react"));
+var _reactNative = require("react-native");
+var _clock = require("./clock.js");
+var _testAdUnits = require("../engine/testAdUnits.js");
+var _conformance = require("./conformance.js");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * Deterministic in-memory ads engine for tests (SC-012).
+ *
+ * This is a real implementation of the same `AdsEngine` port the AdMob adapter
+ * implements, not a parallel mock — so a contract change breaks it at compile
+ * time and it cannot drift. Nothing here touches a native module or a network.
+ *
+ * It exists to make the package's guarantees provable. The recorded call log is
+ * what SC-002 asserts against ("zero production identifiers reached the
+ * adapter") and what SC-003 asserts against ("zero calls before consent").
+ * Callback emission is fully caller-driven, which is what lets a test run the
+ * reward-before-dismiss and dismiss-before-reward orderings and demand the same
+ * outcome from both (SC-007).
+ *
+ * Exported from `@chipmobilesdk/rn-ads/testing`, never from the main entrypoint,
+ * so test doubles cannot reach a production bundle.
+ */
+
+/**
+ * A privacy options form the test is holding open (0.4.0).
+ *
+ * Settle it whenever the test chooses, which is what lets `busy`, a second
+ * call, a consent update, and `dispose()` all be exercised *while* the form is
+ * on screen — in any order, rather than only the one a resolved promise allows.
+ */
+
+const DEFAULT_CONSENT = {
+  status: 'not_required',
+  canRequestAds: true,
+  isFormAvailable: false,
+  privacyOptions: 'not_required'
+};
+/**
+ * Runs `task` on the next microtask, which is when a provider's callbacks would
+ * arrive. Written out because React Native's type declarations omit
+ * `queueMicrotask`, although Hermes has it.
+ */
+function nextMicrotask(task) {
+  Promise.resolve().then(task);
+}
+
+/** The testID the fake banner renders under, for a test to find it by. */
+const FAKE_BANNER_TEST_ID = exports.FAKE_BANNER_TEST_ID = 'ads-fake-banner';
+
+/**
+ * The fake engine's banner component.
+ *
+ * It renders a host view carrying the props the package handed it, so a test
+ * can read them and call the callbacks: `getByTestId(FAKE_BANNER_TEST_ID)`.
+ * It used to render `null`, which left the props reachable only on the
+ * component instance — something `@testing-library/react-native` cannot see,
+ * since a host element is all a consumer's own tests can query.
+ */
+function FakeBanner(props) {
+  return /*#__PURE__*/_react.default.createElement(_reactNative.View, {
+    ...props,
+    testID: FAKE_BANNER_TEST_ID
+  });
+}
+function createFakeAdsEngine(options = {}) {
+  const calls = [];
+  const consentCalls = [];
+  const clock = options.clock ?? (0, _clock.createTestClock)();
+  let consentInfo = {
+    ...DEFAULT_CONSENT,
+    ...options.consentInfo
+  };
+  let consentRequestFailure;
+  let consentFormFailure;
+  let privacyFormFailure;
+  let privacyFormResult = {};
+  let consentReadFailure;
+  /** Set by `holdPrivacyOptionsForm`; consumed by the next form. */
+  let heldForm = null;
+  const consent = {
+    async requestInfoUpdate(consentOptions) {
+      consentCalls.push({
+        kind: 'requestInfoUpdate',
+        options: consentOptions
+      });
+      if (consentRequestFailure !== undefined) {
+        throw consentRequestFailure;
+      }
+      return consentInfo;
+    },
+    async showFormIfRequired() {
+      consentCalls.push({
+        kind: 'showFormIfRequired'
+      });
+      if (consentFormFailure !== undefined) {
+        throw consentFormFailure;
+      }
+      // A presented form that the user completes moves the status on. The
+      // fake only does this when a form was actually required, mirroring the
+      // provider: showing nothing cannot change an answer.
+      // A region that required a form is one that requires a way back into
+      // it, which is what the provider reports once consent is obtained.
+      if (consentInfo.status === 'required' && consentInfo.isFormAvailable) {
+        consentInfo = {
+          status: 'obtained',
+          canRequestAds: true,
+          isFormAvailable: false,
+          privacyOptions: 'required'
+        };
+      }
+      return consentInfo;
+    },
+    async showPrivacyOptionsForm() {
+      consentCalls.push({
+        kind: 'showPrivacyOptionsForm'
+      });
+      const held = heldForm;
+      heldForm = null;
+      if (held) {
+        // Rejects if the test calls `fail`, which is exactly the provider's
+        // failure path; resolves with what the user left behind otherwise.
+        consentInfo = {
+          ...consentInfo,
+          ...(await held)
+        };
+        return consentInfo;
+      }
+      if (privacyFormFailure !== undefined) {
+        throw privacyFormFailure;
+      }
+      consentInfo = {
+        ...consentInfo,
+        ...privacyFormResult
+      };
+      return consentInfo;
+    },
+    async getInfo() {
+      consentCalls.push({
+        kind: 'getInfo'
+      });
+      if (consentReadFailure !== undefined) {
+        throw consentReadFailure;
+      }
+      return consentInfo;
+    },
+    reset() {
+      consentCalls.push({
+        kind: 'reset'
+      });
+      consentInfo = {
+        status: 'unknown',
+        canRequestAds: false,
+        isFormAvailable: true,
+        privacyOptions: 'unknown'
+      };
+    }
+  };
+  const listeners = new Map();
+  /** Callbacks queued before anyone subscribed; see `subscribe`. */
+  const pending = new Map();
+  const live = new Set();
+  let counter = 0;
+  function record(call) {
+    calls.push(call);
+  }
+  return {
+    calls,
+    consentCalls,
+    consent,
+    clock,
+    advance(ms) {
+      clock.advance(ms);
+    },
+    setConsentInfo(info) {
+      consentInfo = {
+        ...consentInfo,
+        ...info
+      };
+    },
+    failConsentRequest(cause = new Error('consent request failed')) {
+      consentRequestFailure = cause;
+    },
+    failConsentForm(cause = new Error('consent form failed')) {
+      consentFormFailure = cause;
+    },
+    setPrivacyOptionsFormResult(info) {
+      privacyFormResult = info;
+    },
+    failPrivacyOptionsForm(cause = new Error('privacy options form failed')) {
+      privacyFormFailure = cause;
+    },
+    holdPrivacyOptionsForm() {
+      let settle;
+      const promise = new Promise((resolve, reject) => {
+        settle = {
+          resolve,
+          reject
+        };
+      });
+      heldForm = promise;
+      return {
+        close(info = {}) {
+          settle.resolve(info);
+        },
+        fail(cause = new Error('privacy options form failed')) {
+          settle.reject(cause);
+        }
+      };
+    },
+    failConsentInfoRead(cause = new Error('consent information read failed')) {
+      consentReadFailure = cause;
+    },
+    isAvailable() {
+      return options.available !== false;
+    },
+    // Renders nothing. A test finds it in the tree by its `adUnitId` prop and
+    // calls `onLoaded`, `onFailed`, `onImpression` or `onClicked` itself, which
+    // is how a banner is driven without mocking a native module (ADS-12).
+    banner: {
+      isAvailable: () => options.available !== false,
+      Component: FakeBanner
+    },
+    async initialize(privacy) {
+      record({
+        kind: 'initialize',
+        privacy
+      });
+      if (options.failInitialize !== undefined) {
+        throw options.failInitialize;
+      }
+    },
+    async createFullScreen(format, adUnitId, request) {
+      counter += 1;
+      const id = `fake-${counter}`;
+      record({
+        kind: 'createFullScreen',
+        format,
+        adUnitId,
+        handleId: id,
+        request
+      });
+      live.add(id);
+      // A real provider delivers `loaded` to a listener attached after the
+      // ad object exists, so the callback is queued here and flushed when
+      // the caller subscribes. Emitting eagerly would race the caller's own
+      // subscribe and the event would be dropped — which is a property of
+      // this fake, not of the package, and would make the load look hung.
+      if (!options.neverCallBack) {
+        pending.set(id, {
+          type: 'loaded'
+        });
+      }
+      return {
+        id
+      };
+    },
+    async show(handle) {
+      record({
+        kind: 'show',
+        handleId: handle.id
+      });
+      if (options.failShow !== undefined) {
+        throw options.failShow;
+      }
+      if (!options.neverCallBack) {
+        // `show` is called with a listener already attached, so this one
+        // can go out directly on the next microtask.
+        nextMicrotask(() => {
+          for (const listener of Array.from(listeners.get(handle.id) ?? [])) {
+            listener({
+              type: 'opened'
+            });
+          }
+        });
+      }
+    },
+    subscribe(handle, listener) {
+      let set = listeners.get(handle.id);
+      if (!set) {
+        set = new Set();
+        listeners.set(handle.id, set);
+      }
+      set.add(listener);
+      // Flush whatever the provider would have delivered between creating
+      // the ad and this subscription.
+      const queued = pending.get(handle.id);
+      if (queued) {
+        pending.delete(handle.id);
+        nextMicrotask(() => {
+          for (const target of Array.from(listeners.get(handle.id) ?? [])) {
+            target(queued);
+          }
+        });
+      }
+      let active = true;
+      return () => {
+        if (!active) {
+          return;
+        }
+        active = false;
+        set?.delete(listener);
+        if (set && set.size === 0) {
+          listeners.delete(handle.id);
+        }
+      };
+    },
+    dispose(handle) {
+      record({
+        kind: 'dispose',
+        handleId: handle.id
+      });
+      live.delete(handle.id);
+      listeners.delete(handle.id);
+      pending.delete(handle.id);
+    },
+    adUnitIds() {
+      return calls.filter(call => call.kind === 'createFullScreen').map(call => call.adUnitId);
+    },
+    liveHandles() {
+      return Array.from(live);
+    },
+    emit(handleId, event) {
+      for (const listener of Array.from(listeners.get(handleId) ?? [])) {
+        listener(event);
+      }
+    },
+    completeLoad(handleId) {
+      this.emit(handleId, {
+        type: 'loaded'
+      });
+    },
+    emitReward(handleId, reward = {
+      type: 'coins',
+      amount: 10
+    }) {
+      this.emit(handleId, {
+        type: 'rewarded',
+        reward
+      });
+    },
+    listenerCount() {
+      let total = 0;
+      for (const set of listeners.values()) {
+        total += set.size;
+      }
+      return total;
+    },
+    reset() {
+      calls.length = 0;
+    }
+  };
+}
+/** Google's official test ad unit for each format, as the package substitutes them (FR-011). */
+function allTestAdUnits() {
+  return {
+    banner: (0, _testAdUnits.testAdUnitFor)('banner'),
+    interstitial: (0, _testAdUnits.testAdUnitFor)('interstitial'),
+    rewarded: (0, _testAdUnits.testAdUnitFor)('rewarded'),
+    app_open: (0, _testAdUnits.testAdUnitFor)('app_open')
+  };
+}
+//# sourceMappingURL=index.js.map

package/lib/commonjs/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireDefault","require","_reactNative","_clock","_testAdUnits","_conformance","e","__esModule","default","DEFAULT_CONSENT","status","canRequestAds","isFormAvailable","privacyOptions","nextMicrotask","task","Promise","resolve","then","FAKE_BANNER_TEST_ID","exports","FakeBanner","props","React","createElement","View","testID","createFakeAdsEngine","options","calls","consentCalls","clock","createTestClock","consentInfo","consentRequestFailure","consentFormFailure","privacyFormFailure","privacyFormResult","consentReadFailure","heldForm","consent","requestInfoUpdate","consentOptions","push","kind","undefined","showFormIfRequired","showPrivacyOptionsForm","held","getInfo","reset","listeners","Map","pending","live","Set","counter","record","call","advance","ms","setConsentInfo","info","failConsentRequest","cause","Error","failConsentForm","setPrivacyOptionsFormResult","failPrivacyOptionsForm","holdPrivacyOptionsForm","settle","promise","reject","close","fail","failConsentInfoRead","isAvailable","available","banner","Component","initialize","privacy","failInitialize","createFullScreen","format","adUnitId","request","id","handleId","add","neverCallBack","set","type","show","handle","failShow","listener","Array","from","get","subscribe","queued","delete","target","active","size","dispose","adUnitIds","filter","map","liveHandles","emit","event","completeLoad","emitReward","reward","amount","listenerCount","total","values","length","allTestAdUnits","testAdUnitFor","interstitial","rewarded","app_open"],"sourceRoot":"../../../src","sources":["testing/index.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/config/resolveAdUnit.js

@@ -0,0 +1,75 @@
+"use strict";
+
+/**
+ * The production-traffic guarantee (FR-011, FR-011a).
+ *
+ * A pure function, deliberately. This is the single point where a production ad
+ * unit can be replaced by an official test one, which is what makes SC-002
+ * provable rather than merely intended: a guarantee enforced in one place can be
+ * asserted; one spread across three call sites is a hope.
+ *
+ * The rule, from the 2026-09-02 clarification session:
+ *
+ *   production            -> use what the app configured, always, no exceptions
+ *   development / test    -> if it is not one of our own official test units,
+ *                            replace it and say so, loudly, naming the key
+ *
+ * Substitution rather than rejection is a deliberate trade. Rejecting would
+ * block a developer whose only mistake was pulling a teammate's environment
+ * file, and turn a configuration smell into a broken integration at every
+ * startup. Substituting keeps the app working — which is what a non-production
+ * build is for — and reports the problem as a first-class signal. The accepted
+ * cost is that a warning can be ignored; it is bounded because production never
+ * substitutes, so the misconfiguration surfaces there as ordinary behavior
+ * rather than as hidden state.
+ */
+
+import { isOfficialTestAdUnit, testAdUnitFor } from "../engine/testAdUnits.js";
+export function resolveAdUnit(placement, environment) {
+  const configured = placement.androidAdUnitId;
+
+  // Production is the one environment where the package must not second-guess
+  // the app. Substituting here would silently rewrite configuration that was
+  // asked for on purpose, and would cost the publisher live revenue.
+  if (environment === 'production') {
+    return {
+      effectiveAdUnitId: configured,
+      substituted: false
+    };
+  }
+
+  // Structural detection: anything that is not a known official test unit is
+  // treated as production-owned. Not a parse of AdMob's publisher-id format —
+  // see the note in engine/testAdUnits.ts on why that rule would be a liability.
+  if (isOfficialTestAdUnit(configured)) {
+    return {
+      effectiveAdUnitId: configured,
+      substituted: false
+    };
+  }
+  return {
+    effectiveAdUnitId: testAdUnitFor(placement.format),
+    substituted: true
+  };
+}
+/**
+ * Resolves a whole catalog at once, so the warning can name every affected
+ * placement in a single event rather than trickling one out per load — an
+ * integrator wants to fix the whole file, not discover it a placement at a time.
+ */
+export function resolvePlacementAdUnits(placements, environment) {
+  const byKey = new Map();
+  const substitutedKeys = [];
+  for (const placement of placements) {
+    const resolved = resolveAdUnit(placement, environment);
+    byKey.set(placement.key, resolved.effectiveAdUnitId);
+    if (resolved.substituted) {
+      substitutedKeys.push(placement.key);
+    }
+  }
+  return {
+    byKey,
+    substitutedKeys
+  };
+}
+//# sourceMappingURL=resolveAdUnit.js.map

package/lib/module/config/resolveAdUnit.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isOfficialTestAdUnit","testAdUnitFor","resolveAdUnit","placement","environment","configured","androidAdUnitId","effectiveAdUnitId","substituted","format","resolvePlacementAdUnits","placements","byKey","Map","substitutedKeys","resolved","set","key","push"],"sourceRoot":"../../../src","sources":["config/resolveAdUnit.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,oBAAoB,EAAEC,aAAa,QAAQ,0BAAuB;AAQ3E,OAAO,SAASC,aAAaA,CAC5BC,SAA8B,EAC9BC,WAAwB,EACP;EACjB,MAAMC,UAAU,GAAGF,SAAS,CAACG,eAAe;;EAE5C;EACA;EACA;EACA,IAAIF,WAAW,KAAK,YAAY,EAAE;IACjC,OAAO;MAAEG,iBAAiB,EAAEF,UAAU;MAAEG,WAAW,EAAE;IAAM,CAAC;EAC7D;;EAEA;EACA;EACA;EACA,IAAIR,oBAAoB,CAACK,UAAU,CAAC,EAAE;IACrC,OAAO;MAAEE,iBAAiB,EAAEF,UAAU;MAAEG,WAAW,EAAE;IAAM,CAAC;EAC7D;EAEA,OAAO;IAAED,iBAAiB,EAAEN,aAAa,CAACE,SAAS,CAACM,MAAM,CAAC;IAAED,WAAW,EAAE;EAAK,CAAC;AACjF;AASA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,uBAAuBA,CACtCC,UAA0C,EAC1CP,WAAwB,EACN;EAClB,MAAMQ,KAAK,GAAG,IAAIC,GAAG,CAAiB,CAAC;EACvC,MAAMC,eAAyB,GAAG,EAAE;EAEpC,KAAK,MAAMX,SAAS,IAAIQ,UAAU,EAAE;IACnC,MAAMI,QAAQ,GAAGb,aAAa,CAACC,SAAS,EAAEC,WAAW,CAAC;IACtDQ,KAAK,CAACI,GAAG,CAACb,SAAS,CAACc,GAAG,EAAEF,QAAQ,CAACR,iBAAiB,CAAC;IACpD,IAAIQ,QAAQ,CAACP,WAAW,EAAE;MACzBM,eAAe,CAACI,IAAI,CAACf,SAAS,CAACc,GAAG,CAAC;IACpC;EACD;EAEA,OAAO;IAAEL,KAAK;IAAEE;EAAgB,CAAC;AAClC","ignoreList":[]}

package/lib/module/config/types.js

@@ -0,0 +1,134 @@
+"use strict";
+
+/**
+ * Public configuration and state types (FR-001, FR-003, FR-004).
+ *
+ * Nothing here names a platform or an ad provider. That is the whole point:
+ * adding an iOS adapter later contributes an optional `iosAdUnitId` and a second
+ * engine implementation, and changes nothing a consumer already wrote (FR-006).
+ *
+ * The package persists none of this. Every value below lives for the lifetime of
+ * one instance and is released by `dispose()`.
+ */
+
+/**
+ * Supported formats. Native and rewarded-interstitial remain deferred.
+ *
+ * `app_open` joined in 0.2.0. It is a member of this union rather than a
+ * separate concept because FR-132 forbids a parallel vocabulary: app-open uses
+ * the same placement states, events, and error codes as everything else. The
+ * cost is that a consumer's exhaustive `switch` over this union stops compiling
+ * — the one required migration step, documented in the 0.2.0 release notes.
+ */
+
+/**
+ * Formats that take over the screen, and so contend for the single-show lock.
+ * App-open is included deliberately: two full-screen ads at once is a broken
+ * app regardless of which formats produced them (FR-129).
+ */
+
+export function isFullScreenFormat(format) {
+  return format === 'interstitial' || format === 'rewarded' || format === 'app_open';
+}
+
+/**
+ * Declared by the app, because the package cannot depend on any particular
+ * configuration mechanism (FR-015). Cross-checked against the runtime dev flag
+ * so a debug build claiming `production` is caught rather than trusted (FR-012).
+ */
+
+/**
+ * One logical ad slot. `key` is the app's own stable name — `home_footer`, not
+ * an AdMob unit. Provider identifiers appear here in configuration and nowhere
+ * else in consumer code (FR-003, FR-007).
+ */
+
+/**
+ * Bounded retry for failed loads. Off unless `AdsConfig.retry` is supplied —
+ * upgrading from 0.1.0 without configuring this issues not one extra request
+ * (FR-134).
+ *
+ * Only errors already flagged `retryable` are retried. Configuration errors,
+ * consent errors, an unsupported platform, and a disabled or undecided instance
+ * never are (FR-135).
+ *
+ * Backoff is exponential with a fixed x2 multiplier and no jitter. Jitter exists
+ * to desynchronize a fleet hitting one server; a single device retrying its own
+ * load has no herd to avoid, and omitting it keeps the attempt count an exact
+ * assertion rather than a statistical one.
+ */
+
+/**
+ * Whether the app wants ads, including the case where it does not know yet.
+ *
+ * The package never resolves `undecided` on the app's behalf and never learns
+ * why the app chose what it chose — no entitlement, no receipt, no reason
+ * (FR-119, FR-120).
+ */
+
+/**
+ * Tools for exercising the consent flow from a device outside a
+ * consent-required region.
+ *
+ * **Stripped entirely when `environment` is `production`.** That is enforced at
+ * configuration validation rather than at each call site, so no path through the
+ * consent module can forget it, and the fact that they were ignored is
+ * observable through a `config_warning` event and `getIgnoredConsentTools()` —
+ * not merely documented (FR-113).
+ */
+
+/**
+ * Consent status, normalized. Carries no provider type and no payload (FR-104).
+ *
+ * Shaped so an iOS adapter can later express both a consent flow and the
+ * platform's tracking-permission mechanism, plus the ordering between them,
+ * without changing shape.
+ */
+
+/**
+ * Whether the user must be offered a way to change their consent choice
+ * (FR-150), added in 0.4.0.
+ *
+ * The provider's verdict, forwarded — never the package's judgement about a
+ * region, exactly as `not_required` in `ConsentState` is not. `required` is the
+ * app's cue to show its own "Privacy options" entry; where that entry lives and
+ * what it says stay the app's.
+ *
+ * `unknown` before the first successful `requestInfoUpdate()`, after `reset()`,
+ * after a failed update, and on a platform with no adapter. It is not `not_required`:
+ * an app that hides the entry on `unknown` is right to, but it must not conclude
+ * the user has no right to one.
+ */
+
+/** Bounds exist because an unbounded timeout is the same defect as no timeout. */
+
+/** Content ratings, normalized. Maps onto the provider's own rating scale. */
+
+/**
+ * Supplied before initialization (FR-016). Never logged, never persisted
+ * (FR-021). Everything except `canRequestAds` must reach the provider before it
+ * initializes, which is why changing one afterwards reports
+ * `requires_reinitialization` rather than pretending it applied (FR-020).
+ */
+
+/**
+ * Why the consent gate is closed.
+ *
+ * The two original members keep their exact v1 meaning — the app's own gate —
+ * so no existing consumer's interpretation changes. The two added in 0.2.0 name
+ * the package's consent flow instead. The split exists because the gate has two
+ * independent inputs that combine as most-restrictive-wins, and a refusal has to
+ * say *which* of them is blocking or the app cannot act on it (FR-105a).
+ */
+
+/** FR-023. One per instance, observable without holding a provider object. */
+
+/**
+ * FR-026. One per placement. Banners never reach `consumed` — they are
+ * continuous, not single-use.
+ */
+
+/** FR-047. The provider's reward descriptor, normalized. */
+
+/** FR-005. Returned by every subscription; safe to call more than once. */
+//# sourceMappingURL=types.js.map

package/lib/module/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isFullScreenFormat","format"],"sourceRoot":"../../../src","sources":["config/types.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;;AAGA,OAAO,SAASA,kBAAkBA,CAACC,MAAgB,EAA8B;EAChF,OAAOA,MAAM,KAAK,cAAc,IAAIA,MAAM,KAAK,UAAU,IAAIA,MAAM,KAAK,UAAU;AACnF;;AAEA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;;AAmCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAUA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;;AAiBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA;;AAkDA;;AAGA;AACA;AACA;AACA;AACA;AACA;;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;;AAqBA;AACA;AACA;AACA;;AAsBA;;AAMA","ignoreList":[]}