rn-persistent-timer 1.1.0

package/lib/module/PersistentTimerManager.js

@@ -0,0 +1,329 @@
+// rn-persistent-timer — PersistentTimerManager
+// Handles foreground, background, and killed-state timer logic
+// ─────────────────────────────────────────────────────────────────────────────
+
+import { AppState as RNAppState } from 'react-native';
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { NativeTimerModule } from './NativeTimerModule';
+import { formatTime } from './utils';
+const STORAGE_KEY_PREFIX = '@rn_persistent_timer_';
+// ─────────────────────────────────────────────────────────────────────────────
+
+export class PersistentTimerManager {
+  _state = 'idle';
+  _elapsed = 0;
+  _startedAt = null;
+  _pausedAt = null;
+  _tickInterval = null;
+  _handlers = {};
+  _appState = 'foreground';
+  _appStateSubscription = null;
+  constructor(config) {
+    this._config = {
+      timerId: config.timerId,
+      mode: config.mode ?? 'stopwatch',
+      duration: config.duration ?? 0,
+      runInBackground: config.runInBackground !== false,
+      // default true
+      runInKilledState: config.runInKilledState === true,
+      // default false
+      pauseOnBackground: config.pauseOnBackground === true,
+      resetOnForeground: config.resetOnForeground === true,
+      interval: config.interval ?? 1000,
+      showNotification: config.showNotification !== false,
+      notification: config.notification ?? {}
+    };
+  }
+
+  // ─── Public API ─────────────────────────────────────────────────────────────
+
+  start() {
+    if (this._state === 'running') {
+      return;
+    }
+    if (this._state === 'completed') {
+      console.warn('[rn-persistent-timer] Timer already completed. Call reset() first.');
+      return;
+    }
+    this._startedAt = Date.now() - this._elapsed * 1000;
+    this._state = 'running';
+    this._startJSTick();
+    this._listenAppState();
+    if (this._config.runInBackground) {
+      this._startNativeBackground();
+    }
+    if (this._config.runInKilledState) {
+      void this._persistState();
+    }
+    this._emit('onStart', this.getSnapshot());
+  }
+  pause() {
+    if (this._state !== 'running') {
+      return;
+    }
+    this._pausedAt = Date.now();
+    this._elapsed = Math.floor((Date.now() - (this._startedAt ?? Date.now())) / 1000);
+    this._state = 'paused';
+    this._stopJSTick();
+    this._stopNativeBackground();
+    if (this._config.runInKilledState) {
+      void this._persistState();
+    }
+    this._emit('onPause', this.getSnapshot());
+  }
+  resume() {
+    if (this._state !== 'paused') {
+      return;
+    }
+    this._startedAt = Date.now() - this._elapsed * 1000;
+    this._pausedAt = null;
+    this._state = 'running';
+    this._startJSTick();
+    if (this._config.runInBackground) {
+      this._startNativeBackground();
+    }
+    if (this._config.runInKilledState) {
+      void this._persistState();
+    }
+    this._emit('onResume', this.getSnapshot());
+  }
+  stop() {
+    if (this._state === 'idle') {
+      return;
+    }
+    this._stopJSTick();
+    this._stopNativeBackground();
+    this._state = 'idle';
+    void this._clearPersistedState();
+    this._emit('stop', this.getSnapshot());
+  }
+  reset() {
+    this._stopJSTick();
+    this._stopNativeBackground();
+    this._elapsed = 0;
+    this._startedAt = null;
+    this._pausedAt = null;
+    this._state = 'idle';
+    void this._clearPersistedState();
+    this._emit('onReset', this.getSnapshot());
+  }
+  getSnapshot() {
+    const elapsed = this._getElapsed();
+    const remaining = this._config.mode === 'countdown' ? Math.max(0, this._config.duration - elapsed) : null;
+    const progress = this._config.mode === 'countdown' && this._config.duration > 0 ? 1 - (remaining ?? 0) / this._config.duration : null;
+    return {
+      timerId: this._config.timerId,
+      elapsed,
+      remaining,
+      state: this._state,
+      appState: this._appState,
+      startedAt: this._startedAt,
+      pausedAt: this._pausedAt,
+      formattedElapsed: formatTime(elapsed),
+      formattedRemaining: remaining !== null ? formatTime(remaining) : null,
+      progress
+    };
+  }
+  destroy() {
+    this.stop();
+    if (this._appStateSubscription) {
+      this._appStateSubscription.remove();
+      this._appStateSubscription = null;
+    }
+    this._handlers = {};
+  }
+  on(event, handler) {
+    if (!this._handlers[event]) {
+      this._handlers[event] = [];
+    }
+    this._handlers[event].push(handler);
+  }
+  off(event, handler) {
+    if (!this._handlers[event]) {
+      return;
+    }
+    this._handlers[event] = this._handlers[event].filter(h => h !== handler);
+  }
+
+  // ─── Internal Tick ───────────────────────────────────────────────────────────
+
+  _startJSTick() {
+    this._stopJSTick();
+    this._tickInterval = setInterval(() => {
+      this._onTick();
+    }, this._config.interval);
+  }
+  _stopJSTick() {
+    if (this._tickInterval !== null) {
+      clearInterval(this._tickInterval);
+      this._tickInterval = null;
+    }
+  }
+  _onTick() {
+    const snap = this.getSnapshot();
+    if (this._config.mode === 'countdown' && snap.remaining === 0) {
+      this._state = 'completed';
+      this._stopJSTick();
+      this._stopNativeBackground();
+      void this._clearPersistedState();
+      this._emit('onComplete', snap);
+      return;
+    }
+    this._emit('onTick', snap);
+  }
+  _getElapsed() {
+    if (this._state === 'running' && this._startedAt !== null) {
+      return Math.floor((Date.now() - this._startedAt) / 1000);
+    }
+    return this._elapsed;
+  }
+
+  // ─── App State ───────────────────────────────────────────────────────────────
+
+  _listenAppState() {
+    if (this._appStateSubscription) {
+      return;
+    }
+    this._appStateSubscription = RNAppState.addEventListener('change', nextAppState => {
+      const prev = this._appState;
+      if (nextAppState === 'active') {
+        this._appState = 'foreground';
+        if (prev === 'background' && this._config.runInBackground) {
+          this._syncFromNative();
+        }
+        if (this._config.resetOnForeground) {
+          this.reset();
+          return;
+        }
+        if (this._state === 'running') {
+          this._startJSTick();
+        }
+        this._emit('onForeground', this.getSnapshot());
+      } else if (nextAppState === 'background' || nextAppState === 'inactive') {
+        this._appState = 'background';
+        if (this._config.pauseOnBackground) {
+          this.pause();
+        } else {
+          this._stopJSTick();
+        }
+        this._emit('onBackground', this.getSnapshot());
+      }
+    });
+  }
+
+  // ─── Native Background ───────────────────────────────────────────────────────
+
+  _startNativeBackground() {
+    if (!NativeTimerModule) {
+      return;
+    }
+    try {
+      NativeTimerModule.startTimer({
+        timerId: this._config.timerId,
+        mode: this._config.mode,
+        duration: this._config.duration,
+        elapsed: this._getElapsed(),
+        startedAt: this._startedAt ?? Date.now(),
+        showNotification: this._config.showNotification,
+        notification: this._config.notification
+      });
+    } catch (e) {
+      this._emit('error', e);
+    }
+  }
+  _stopNativeBackground() {
+    if (!NativeTimerModule) {
+      return;
+    }
+    try {
+      NativeTimerModule.stopTimer(this._config.timerId);
+    } catch (e) {
+      this._emit('error', e);
+    }
+  }
+  _syncFromNative() {
+    if (!NativeTimerModule) {
+      return;
+    }
+    NativeTimerModule.getElapsed(this._config.timerId).then(nativeElapsed => {
+      if (nativeElapsed != null) {
+        this._elapsed = nativeElapsed;
+        this._startedAt = Date.now() - nativeElapsed * 1000;
+      }
+    }).catch(() => {
+      // Fallback: wall-clock diff handles it via _startedAt
+    });
+  }
+
+  // ─── Killed-State Persistence ────────────────────────────────────────────────
+
+  async _persistState() {
+    try {
+      const record = {
+        timerId: this._config.timerId,
+        config: this._config,
+        state: this._state,
+        elapsed: this._getElapsed(),
+        startedAt: this._startedAt,
+        pausedAt: this._pausedAt,
+        savedAt: Date.now()
+      };
+      await AsyncStorage.setItem(`${STORAGE_KEY_PREFIX}${this._config.timerId}`, JSON.stringify(record));
+    } catch (e) {
+      console.warn('[rn-persistent-timer] Failed to persist state:', e);
+    }
+  }
+  async _clearPersistedState() {
+    try {
+      await AsyncStorage.removeItem(`${STORAGE_KEY_PREFIX}${this._config.timerId}`);
+    } catch {
+      // Swallow
+    }
+  }
+
+  // ─── Static Restore ──────────────────────────────────────────────────────────
+
+  static async restore(timerId) {
+    try {
+      const raw = await AsyncStorage.getItem(`${STORAGE_KEY_PREFIX}${timerId}`);
+      if (!raw) {
+        return null;
+      }
+      const saved = JSON.parse(raw);
+      const now = Date.now();
+      const secondsSinceSave = Math.floor((now - saved.savedAt) / 1000);
+      let elapsed = saved.elapsed;
+      if (saved.state === 'running') {
+        elapsed = saved.elapsed + secondsSinceSave;
+      }
+
+      // Cap countdown timers at their duration
+      if (saved.config.mode === 'countdown' && elapsed >= saved.config.duration) {
+        elapsed = saved.config.duration;
+        saved.state = 'completed';
+      }
+      return {
+        config: saved.config,
+        state: saved.state,
+        elapsed,
+        secondsLost: secondsSinceSave
+      };
+    } catch {
+      return null;
+    }
+  }
+
+  // ─── Event Emitter ───────────────────────────────────────────────────────────
+
+  _emit(event, data) {
+    const handlers = this._handlers[event] ?? [];
+    for (const h of handlers) {
+      try {
+        h(data);
+      } catch (e) {
+        console.error(`[rn-persistent-timer] Handler error for "${event}":`, e);
+      }
+    }
+  }
+}
+//# sourceMappingURL=PersistentTimerManager.js.map

package/lib/module/PersistentTimerManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["AppState","RNAppState","AsyncStorage","NativeTimerModule","formatTime","STORAGE_KEY_PREFIX","PersistentTimerManager","_state","_elapsed","_startedAt","_pausedAt","_tickInterval","_handlers","_appState","_appStateSubscription","constructor","config","_config","timerId","mode","duration","runInBackground","runInKilledState","pauseOnBackground","resetOnForeground","interval","showNotification","notification","start","console","warn","Date","now","_startJSTick","_listenAppState","_startNativeBackground","_persistState","_emit","getSnapshot","pause","Math","floor","_stopJSTick","_stopNativeBackground","resume","stop","_clearPersistedState","reset","elapsed","_getElapsed","remaining","max","progress","state","appState","startedAt","pausedAt","formattedElapsed","formattedRemaining","destroy","remove","on","event","handler","push","off","filter","h","setInterval","_onTick","clearInterval","snap","addEventListener","nextAppState","prev","_syncFromNative","startTimer","e","stopTimer","getElapsed","then","nativeElapsed","catch","record","savedAt","setItem","JSON","stringify","removeItem","restore","raw","getItem","saved","parse","secondsSinceSave","secondsLost","data","handlers","error"],"sourceRoot":"../../src","sources":["PersistentTimerManager.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,17 @@
+// rn-persistent-timer — Public API Barrel
+// ─────────────────────────────────────────────────────────────────────────────
+
+// Hook
+export { usePersistentTimer } from './usePersistentTimer';
+
+// Class
+export { PersistentTimerManager } from './PersistentTimerManager';
+
+// Utilities
+export { formatTime, parseTime, isBackgroundTimerSupported, isKilledStateTimerSupported, getActiveTimers, cancelAllTimers } from './utils';
+
+// Types — re-export everything so consumers only need one import path
+
+// Native internals (advanced use only)
+export { NativeTimerModule, NativeTimerEmitter, NATIVE_EVENTS } from './NativeTimerModule';
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["usePersistentTimer","PersistentTimerManager","formatTime","parseTime","isBackgroundTimerSupported","isKilledStateTimerSupported","getActiveTimers","cancelAllTimers","NativeTimerModule","NativeTimerEmitter","NATIVE_EVENTS"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"AAAA;AACA;;AAEA;AACA,SAASA,kBAAkB,QAAQ,sBAAsB;;AAEzD;AACA,SAASC,sBAAsB,QAAQ,0BAA0B;;AAEjE;AACA,SACEC,UAAU,EACVC,SAAS,EACTC,0BAA0B,EAC1BC,2BAA2B,EAC3BC,eAAe,EACfC,eAAe,QACV,SAAS;;AAEhB;;AAeA;AACA,SACEC,iBAAiB,EACjBC,kBAAkB,EAClBC,aAAa,QACR,qBAAqB","ignoreList":[]}

package/lib/module/types.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/usePersistentTimer.js

@@ -0,0 +1,153 @@
+// rn-persistent-timer — usePersistentTimer Hook
+// ─────────────────────────────────────────────────────────────────────────────
+
+import { useState, useEffect, useRef, useCallback } from 'react';
+import { PersistentTimerManager } from './PersistentTimerManager';
+import { formatTime } from './utils';
+// ─────────────────────────────────────────────────────────────────────────────
+
+function makeInitialSnapshot(config) {
+  const mode = config.mode ?? 'stopwatch';
+  const duration = config.duration ?? 0;
+  return {
+    timerId: config.timerId,
+    elapsed: 0,
+    remaining: mode === 'countdown' ? duration : null,
+    state: 'idle',
+    appState: 'foreground',
+    startedAt: null,
+    pausedAt: null,
+    formattedElapsed: '00:00:00',
+    formattedRemaining: mode === 'countdown' ? formatTime(duration) : null,
+    progress: mode === 'countdown' ? 0 : null
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * React hook for persistent timers.
+ *
+ * @example
+ * ```tsx
+ * const { snapshot, start, pause, reset, isRunning } = usePersistentTimer({
+ *   timerId: 'workout-timer',
+ *   mode: 'stopwatch',
+ *   runInBackground: true,
+ *   onTick: (snap) => console.log(snap.formattedElapsed),
+ * });
+ * ```
+ */
+export function usePersistentTimer(config) {
+  const managerRef = useRef(null);
+  const [snapshot, setSnapshot] = useState(() => makeInitialSnapshot(config));
+
+  // Stable callback refs — avoids re-creating the manager when callbacks change
+  const callbacksRef = useRef({});
+  callbacksRef.current = {
+    onTick: config.onTick,
+    onStart: config.onStart,
+    onPause: config.onPause,
+    onResume: config.onResume,
+    onReset: config.onReset,
+    onComplete: config.onComplete,
+    onBackground: config.onBackground,
+    onForeground: config.onForeground,
+    onRestore: config.onRestore,
+    onError: config.onError
+  };
+  useEffect(() => {
+    const manager = new PersistentTimerManager({
+      timerId: config.timerId,
+      mode: config.mode,
+      duration: config.duration,
+      runInBackground: config.runInBackground,
+      runInKilledState: config.runInKilledState,
+      pauseOnBackground: config.pauseOnBackground,
+      resetOnForeground: config.resetOnForeground,
+      interval: config.interval,
+      showNotification: config.showNotification,
+      notification: config.notification
+    });
+
+    // Snapshot callbacks — update React state then call user callback
+
+    const wire = (managerEvent, cbKey) => {
+      manager.on(managerEvent, snap => {
+        setSnapshot({
+          ...snap
+        });
+        callbacksRef.current[cbKey]?.(snap);
+      });
+    };
+    wire('onTick', 'onTick');
+    wire('onStart', 'onStart');
+    wire('onPause', 'onPause');
+    wire('onResume', 'onResume');
+    wire('onReset', 'onReset');
+    wire('onComplete', 'onComplete');
+    wire('onBackground', 'onBackground');
+    wire('onForeground', 'onForeground');
+    wire('onRestore', 'onRestore');
+
+    // Error callback — receives Error, not TimerSnapshot
+    manager.on('error', err => {
+      callbacksRef.current.onError?.(err);
+    });
+
+    // Restore from killed state if applicable
+    if (config.runInKilledState) {
+      PersistentTimerManager.restore(config.timerId).then(restored => {
+        if (!restored) {
+          return;
+        }
+
+        // Replay internal state onto the manager
+        manager._elapsed = restored.elapsed;
+        manager._state = restored.state;
+        const snap = manager.getSnapshot();
+        setSnapshot({
+          ...snap
+        });
+        callbacksRef.current.onRestore?.(snap);
+
+        // Auto-resume if the timer was running when the app was killed
+        if (restored.state === 'running') {
+          manager.start();
+        }
+      });
+    }
+    managerRef.current = manager;
+    return () => {
+      manager.destroy();
+      managerRef.current = null;
+    };
+    // Re-create the manager only if timerId changes
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [config.timerId]);
+
+  // ─── Stable controls ──────────────────────────────────────────────────────
+
+  const start = useCallback(() => managerRef.current?.start(), []);
+  const pause = useCallback(() => managerRef.current?.pause(), []);
+  const resume = useCallback(() => managerRef.current?.resume(), []);
+  const reset = useCallback(() => managerRef.current?.reset(), []);
+  const stop = useCallback(() => managerRef.current?.stop(), []);
+  const destroy = useCallback(() => managerRef.current?.destroy(), []);
+  const getSnapshot = useCallback(() => managerRef.current?.getSnapshot() ?? snapshot, [snapshot]);
+  return {
+    snapshot,
+    isRunning: snapshot.state === 'running',
+    isPaused: snapshot.state === 'paused',
+    isCompleted: snapshot.state === 'completed',
+    appState: snapshot.appState,
+    start,
+    pause,
+    resume,
+    reset,
+    stop,
+    destroy,
+    getSnapshot
+  };
+}
+//# sourceMappingURL=usePersistentTimer.js.map

package/lib/module/usePersistentTimer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useState","useEffect","useRef","useCallback","PersistentTimerManager","formatTime","makeInitialSnapshot","config","mode","duration","timerId","elapsed","remaining","state","appState","startedAt","pausedAt","formattedElapsed","formattedRemaining","progress","usePersistentTimer","managerRef","snapshot","setSnapshot","callbacksRef","current","onTick","onStart","onPause","onResume","onReset","onComplete","onBackground","onForeground","onRestore","onError","manager","runInBackground","runInKilledState","pauseOnBackground","resetOnForeground","interval","showNotification","notification","wire","managerEvent","cbKey","on","snap","err","restore","then","restored","_elapsed","_state","getSnapshot","start","destroy","pause","resume","reset","stop","isRunning","isPaused","isCompleted"],"sourceRoot":"../../src","sources":["usePersistentTimer.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/utils.js

@@ -0,0 +1,100 @@
+// rn-persistent-timer — Utility Functions
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Format a number of seconds into an `HH:MM:SS` string.
+ *
+ * @example
+ * formatTime(3661); // '01:01:01'
+ * formatTime(59);   // '00:00:59'
+ */
+export function formatTime(seconds) {
+  const s = Math.max(0, Math.floor(seconds));
+  const h = Math.floor(s / 3600);
+  const m = Math.floor(s % 3600 / 60);
+  const sec = s % 60;
+  return [h, m, sec].map(v => String(v).padStart(2, '0')).join(':');
+}
+
+/**
+ * Parse an `HH:MM:SS` or `MM:SS` string into total seconds.
+ *
+ * @example
+ * parseTime('01:30:00'); // 5400
+ * parseTime('05:30');    // 330
+ */
+export function parseTime(formatted) {
+  const parts = formatted.split(':').map(Number);
+  if (parts.length === 3) {
+    return parts[0] * 3600 + parts[1] * 60 + parts[2];
+  }
+  if (parts.length === 2) {
+    return parts[0] * 60 + parts[1];
+  }
+  return parts[0] ?? 0;
+}
+
+/**
+ * Returns `true` if the native background-timer module is available on this
+ * device / build. Always returns `false` in Expo Go.
+ */
+export async function isBackgroundTimerSupported() {
+  const {
+    NativeTimerModule
+  } = await import('./NativeTimerModule');
+  return Boolean(NativeTimerModule);
+}
+
+/**
+ * Returns `true` if the killed-state persistence feature is supported.
+ * Requires the native module **and** platform capabilities
+ * (WorkManager on Android, BGTaskScheduler on iOS 13+).
+ */
+export async function isKilledStateTimerSupported() {
+  const {
+    NativeTimerModule
+  } = await import('./NativeTimerModule');
+  if (!NativeTimerModule) {
+    return false;
+  }
+  try {
+    return (await NativeTimerModule.isKilledStateSupported?.()) ?? false;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Return the IDs of all timers currently active in the native layer.
+ */
+export async function getActiveTimers() {
+  const {
+    NativeTimerModule
+  } = await import('./NativeTimerModule');
+  if (!NativeTimerModule) {
+    return [];
+  }
+  try {
+    return await NativeTimerModule.getActiveTimers();
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Cancel every active timer in both the native layer and JS.
+ */
+export async function cancelAllTimers() {
+  const {
+    NativeTimerModule
+  } = await import('./NativeTimerModule');
+  if (!NativeTimerModule) {
+    return;
+  }
+  try {
+    await NativeTimerModule.cancelAll();
+  } catch {
+    // Swallow — best-effort cleanup
+  }
+}
+//# sourceMappingURL=utils.js.map

package/lib/module/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["formatTime","seconds","s","Math","max","floor","h","m","sec","map","v","String","padStart","join","parseTime","formatted","parts","split","Number","length","isBackgroundTimerSupported","NativeTimerModule","Boolean","isKilledStateTimerSupported","isKilledStateSupported","getActiveTimers","cancelAllTimers","cancelAll"],"sourceRoot":"../../src","sources":["utils.ts"],"mappings":"AAAA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,UAAUA,CAACC,OAAe,EAAU;EAClD,MAAMC,CAAC,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAED,IAAI,CAACE,KAAK,CAACJ,OAAO,CAAC,CAAC;EAC1C,MAAMK,CAAC,GAAGH,IAAI,CAACE,KAAK,CAACH,CAAC,GAAG,IAAI,CAAC;EAC9B,MAAMK,CAAC,GAAGJ,IAAI,CAACE,KAAK,CAAEH,CAAC,GAAG,IAAI,GAAI,EAAE,CAAC;EACrC,MAAMM,GAAG,GAAGN,CAAC,GAAG,EAAE;EAClB,OAAO,CAACI,CAAC,EAAEC,CAAC,EAAEC,GAAG,CAAC,CAACC,GAAG,CAAEC,CAAC,IAAKC,MAAM,CAACD,CAAC,CAAC,CAACE,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAACC,IAAI,CAAC,GAAG,CAAC;AACrE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CAACC,SAAiB,EAAU;EACnD,MAAMC,KAAK,GAAGD,SAAS,CAACE,KAAK,CAAC,GAAG,CAAC,CAACR,GAAG,CAACS,MAAM,CAAC;EAC9C,IAAIF,KAAK,CAACG,MAAM,KAAK,CAAC,EAAE;IACtB,OAAOH,KAAK,CAAC,CAAC,CAAC,GAAI,IAAI,GAAGA,KAAK,CAAC,CAAC,CAAC,GAAI,EAAE,GAAGA,KAAK,CAAC,CAAC,CAAE;EACtD;EACA,IAAIA,KAAK,CAACG,MAAM,KAAK,CAAC,EAAE;IACtB,OAAOH,KAAK,CAAC,CAAC,CAAC,GAAI,EAAE,GAAGA,KAAK,CAAC,CAAC,CAAE;EACnC;EACA,OAAOA,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACtB;;AAEA;AACA;AACA;AACA;AACA,OAAO,eAAeI,0BAA0BA,CAAA,EAAqB;EACnE,MAAM;IAAEC;EAAkB,CAAC,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC;EACjE,OAAOC,OAAO,CAACD,iBAAiB,CAAC;AACnC;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeE,2BAA2BA,CAAA,EAAqB;EACpE,MAAM;IAAEF;EAAkB,CAAC,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC;EACjE,IAAI,CAACA,iBAAiB,EAAE;IACtB,OAAO,KAAK;EACd;EACA,IAAI;IACF,OAAO,OAAMA,iBAAiB,CAACG,sBAAsB,GAAG,CAAC,KAAI,KAAK;EACpE,CAAC,CAAC,MAAM;IACN,OAAO,KAAK;EACd;AACF;;AAEA;AACA;AACA;AACA,OAAO,eAAeC,eAAeA,CAAA,EAAsB;EACzD,MAAM;IAAEJ;EAAkB,CAAC,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC;EACjE,IAAI,CAACA,iBAAiB,EAAE;IACtB,OAAO,EAAE;EACX;EACA,IAAI;IACF,OAAO,MAAMA,iBAAiB,CAACI,eAAe,CAAC,CAAC;EAClD,CAAC,CAAC,MAAM;IACN,OAAO,EAAE;EACX;AACF;;AAEA;AACA;AACA;AACA,OAAO,eAAeC,eAAeA,CAAA,EAAkB;EACrD,MAAM;IAAEL;EAAkB,CAAC,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC;EACjE,IAAI,CAACA,iBAAiB,EAAE;IACtB;EACF;EACA,IAAI;IACF,MAAMA,iBAAiB,CAACM,SAAS,CAAC,CAAC;EACrC,CAAC,CAAC,MAAM;IACN;EAAA;AAEJ","ignoreList":[]}