@multiplatform.one/frappe 6.0.0

package/dist/jsx/sync/filters.spec.native.js

@@ -0,0 +1,173 @@
+"use strict";
+
+var import_vitest = require("vitest");
+var import_filters = require("./filters.native.js");
+(0, import_vitest.describe)("matchesFilters", function () {
+  var testDoc = {
+    name: "TEST-001",
+    doctype: "Task",
+    status: "Open",
+    priority: 5,
+    tags: ["urgent", "customer"],
+    assignee: "john@example.com",
+    created: "2024-01-01",
+    amount: 1e3,
+    description: "Test document for filter testing",
+    parent: "PARENT-001"
+  };
+  (0, import_vitest.describe)("array-style filters", function () {
+    (0, import_vitest.it)("should handle equals operator", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", "=", "Open"]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", "=", "Closed"]])).toBe(false);
+    });
+    (0, import_vitest.it)("should handle not equals operator", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", "!=", "Closed"]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", "!=", "Open"]])).toBe(false);
+    });
+    (0, import_vitest.it)("should handle greater than operators", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["priority", ">", 3]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["priority", ">", 5]])).toBe(false);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["priority", ">=", 5]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["priority", ">=", 6]])).toBe(false);
+    });
+    (0, import_vitest.it)("should handle less than operators", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["priority", "<", 10]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["priority", "<", 5]])).toBe(false);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["priority", "<=", 5]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["priority", "<=", 4]])).toBe(false);
+    });
+    (0, import_vitest.it)("should handle 'in' operator", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", "in", ["Open", "Closed"]]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", "in", ["Closed", "Cancelled"]]])).toBe(false);
+    });
+    (0, import_vitest.it)("should handle 'not in' operator", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", "not in", ["Closed", "Cancelled"]]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", "not in", ["Open", "Closed"]]])).toBe(false);
+    });
+    (0, import_vitest.it)("should handle 'like' operator", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["assignee", "like", "%john%"]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["assignee", "like", "%jane%"]])).toBe(false);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["description", "like", "%filter%"]])).toBe(true);
+    });
+    (0, import_vitest.it)("should handle 'not like' operator", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["assignee", "not like", "%jane%"]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["assignee", "not like", "%john%"]])).toBe(false);
+    });
+    (0, import_vitest.it)("should handle 'between' operator", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["priority", "between", [1, 10]]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["priority", "between", [6, 10]]])).toBe(false);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["amount", "between", [500, 1500]]])).toBe(true);
+    });
+    (0, import_vitest.it)("should handle multiple filters (AND logic)", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", "=", "Open"], ["priority", ">", 3]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", "=", "Open"], ["priority", ">", 10]])).toBe(false);
+    });
+    (0, import_vitest.it)("should handle FilterOperator enum values", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", import_filters.FilterOperator.Equals, "Open"]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["priority", import_filters.FilterOperator.GreaterThan, 3]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["assignee", import_filters.FilterOperator.Like, "%john%"]])).toBe(true);
+    });
+    (0, import_vitest.it)("should handle 'is' operator for null/not null", function () {
+      var docWithNull = {
+        ...testDoc,
+        nullField: null,
+        notNullField: "value"
+      };
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(docWithNull, [["nullField", "is", null]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(docWithNull, [["notNullField", "is", null]])).toBe(false);
+    });
+    (0, import_vitest.it)("should handle 'ancestors of' operator", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["parent", "ancestors of", "PARENT-001"]])).toBe(false);
+    });
+    (0, import_vitest.it)("should return false for unsupported operators", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", "unknown-operator", "Open"]])).toBe(false);
+    });
+  });
+  (0, import_vitest.describe)("object-style filters", function () {
+    (0, import_vitest.it)("should handle simple equality filters", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, {
+        status: "Open"
+      })).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, {
+        status: "Closed"
+      })).toBe(false);
+    });
+    (0, import_vitest.it)("should handle multiple fields (AND logic)", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, {
+        status: "Open",
+        priority: 5
+      })).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, {
+        status: "Open",
+        priority: 10
+      })).toBe(false);
+    });
+  });
+  (0, import_vitest.describe)("edge cases", function () {
+    (0, import_vitest.it)("should handle empty filters", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, {})).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, null)).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, void 0)).toBe(true);
+    });
+    (0, import_vitest.it)("should handle missing fields in document", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["nonExistentField", "=", "value"]])).toBe(false);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["nonExistentField", "!=", "value"]])).toBe(true);
+    });
+    (0, import_vitest.it)("should handle array fields in documents", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["tags", "in", ["urgent"]]])).toBe(false);
+      var docWithArrayCheck = {
+        ...testDoc,
+        singleTag: "urgent"
+      };
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(docWithArrayCheck, [["singleTag", "in", ["urgent", "low"]]])).toBe(true);
+    });
+    (0, import_vitest.it)("should handle case sensitivity", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", "LIKE", "%Open%"]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["priority", "BETWEEN", [1, 10]]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", "=", "open"]])).toBe(false);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["status", "=", "Open"]])).toBe(true);
+    });
+    (0, import_vitest.it)("should handle type coercion in comparisons", function () {
+      var docWithStringNumber = {
+        ...testDoc,
+        stringPriority: "5"
+      };
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(docWithStringNumber, [["stringPriority", ">", 3]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(docWithStringNumber, [["stringPriority", "<", 10]])).toBe(true);
+    });
+    (0, import_vitest.it)("should handle date comparisons", function () {
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["created", "=", "2024-01-01"]])).toBe(true);
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(testDoc, [["created", "!=", "2024-01-02"]])).toBe(true);
+    });
+    (0, import_vitest.it)("should handle complex nested documents", function () {
+      var nestedDoc = {
+        name: "NESTED-001",
+        doctype: "NestedDoc",
+        data: {
+          level1: {
+            level2: {
+              value: "deep-value"
+            }
+          }
+        }
+      };
+      (0, import_vitest.expect)((0, import_filters.matchesFilters)(nestedDoc, [["data.level1.level2.value", "=", "deep-value"]])).toBe(false);
+    });
+  });
+  (0, import_vitest.describe)("performance considerations", function () {
+    (0, import_vitest.it)("should handle large filter arrays efficiently", function () {
+      var largeFilterArray = Array.from({
+        length: 100
+      }, function (_, i) {
+        return ["status", "!=", `status-${i}`];
+      });
+      var start = Date.now();
+      var result = (0, import_filters.matchesFilters)(testDoc, largeFilterArray);
+      var duration = Date.now() - start;
+      (0, import_vitest.expect)(result).toBe(true);
+      (0, import_vitest.expect)(duration).toBeLessThan(100);
+    });
+  });
+});
+//# sourceMappingURL=filters.spec.native.js.map

package/dist/jsx/sync/filters.spec.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["import_vitest","require","import_filters","describe","testDoc","name","doctype","status","priority","tags","assignee","created","amount","description","parent","it","expect","matchesFilters","toBe"],"sources":["../../../src/sync/filters.spec.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/jsx/sync/index.mjs

@@ -0,0 +1,278 @@
+import { onAppFocus, onOnline } from "@multiplatform.one/platform";
+import { MutationEngine } from "./mutationEngine.mjs";
+import { MutationJournal } from "./mutationJournal.mjs";
+import { NormalizedCache } from "./normalizedCache.mjs";
+import { PersistenceManager } from "./persistence.mjs";
+import { RealtimeHandler } from "./realtime.mjs";
+import { RehydrationManager } from "./rehydration.mjs";
+import { SubscriptionManager } from "./subscriptionManager.mjs";
+import { BackfillScope, Status } from "./types.mjs";
+class SyncModule {
+  constructor(db, realtime, options = {}) {
+    this.db = db;
+    this.realtime = realtime;
+    this.options = options;
+    this.normalizedCache = new NormalizedCache({
+      maxSize: this.options.maxCacheSize
+    });
+    this.mutationJournal = new MutationJournal({
+      ttl: this.options.mutationTTL,
+      enableAutoCleanup: true,
+      storage: typeof localStorage !== "undefined" ? localStorage : void 0
+    });
+    this.subscriptionManager = new SubscriptionManager(this.db, this.normalizedCache, this.options);
+    this.rehydrationManager = new RehydrationManager(this.db, this.normalizedCache, this.subscriptionManager, this.mutationJournal);
+    this.mutationEngine = new MutationEngine(this.db, this.realtime, this.normalizedCache, this.mutationJournal, this.subscriptionManager, this.rehydrationManager, this.options);
+    const realtimeOptions = {
+      ...this.options,
+      onResetCache: () => this.resetCache(),
+      onBackfillAll: () => this.backfill({
+        scope: BackfillScope.All
+      })
+    };
+    this.realtimeHandler = new RealtimeHandler(this.db, this.realtime, this.normalizedCache, this.subscriptionManager, this.rehydrationManager, realtimeOptions);
+    this.persistenceManager = new PersistenceManager(this.normalizedCache, this.mutationJournal, this.subscriptionManager, this.mutationEngine, realtimeOptions);
+    this.setupWindowEvents();
+  }
+  db;
+  realtime;
+  options;
+  normalizedCache;
+  mutationJournal;
+  storeListeners = /* @__PURE__ */new Set();
+  subscriptionManager;
+  /** Mutation engine for optimistic updates and conflict resolution. */
+  mutationEngine;
+  /** Realtime event handler for Socket.IO integration. */
+  realtimeHandler;
+  /** Persistence manager for state snapshots. */
+  persistenceManager;
+  /** Rehydration manager for intelligent subscription updates. */
+  rehydrationManager;
+  /** Cleanup functions returned by lifecycle subscriptions. */
+  cleanupFocus;
+  cleanupOnlineBackfill;
+  cleanupOnlineReplay;
+  /** Timer handle for periodic CDC polling. */
+  cdcIntervalHandle;
+  /**
+   * Sets up lifecycle event listeners for sync triggers.
+   * Stores cleanup functions returned by each subscription.
+   */
+  setupWindowEvents() {
+    this.cleanupFocus = onAppFocus(() => this.backfill({
+      scope: BackfillScope.All
+    }));
+    this.cleanupOnlineBackfill = onOnline(() => this.backfill({
+      scope: BackfillScope.All
+    }));
+    this.cleanupOnlineReplay = onOnline(() => this.replayPending());
+    if (this.options.cdcInterval && this.options.cdcInterval > 0) {
+      this.cdcIntervalHandle = setInterval(() => this.backfill({
+        scope: BackfillScope.All
+      }), this.options.cdcInterval);
+    }
+  }
+  /**
+   * Creates a subscription, seeds cache with initial rows, and stores a backfill checkpoint.
+   */
+  async subscribe(query) {
+    const result = await this.subscriptionManager.subscribe(query);
+    this.emit();
+    return result;
+  }
+  /**
+   * Removes a subscription by id.
+   */
+  unsubscribe(subscriptionId) {
+    this.subscriptionManager.unsubscribe(subscriptionId);
+    this.emit();
+  }
+  async mutate(mutation) {
+    await this.mutationEngine.mutate(mutation);
+    this.persistenceManager.broadcastMutation(mutation);
+    this.emit();
+  }
+  /**
+   * Reconciles local state by fetching changes since stored cursors.
+   */
+  async backfill(args) {
+    await this.subscriptionManager.backfill(args);
+    this.emit();
+  }
+  /**
+   * Replays pending mutations with error handling.
+   */
+  async replayPending() {
+    await this.mutationEngine.replayPending();
+    this.emit();
+  }
+  /** Reads a single document from the local cache. */
+  getDocFromCache(doctype, name) {
+    return this.normalizedCache.get({
+      doctype,
+      name
+    });
+  }
+  /** Returns subscription metadata by id. */
+  getSubscription(id) {
+    return this.subscriptionManager.getSubscription(id);
+  }
+  /**
+   * Returns current rows for a subscription from the cache.
+   */
+  getDocsForSubscription(id) {
+    return this.subscriptionManager.getDocsForSubscription(id);
+  }
+  /**
+   * Get a specific page of documents using virtual pagination.
+   * Requires the subscription to have been created with `progressive: true`.
+   */
+  async getPage(subscriptionId, page) {
+    const result = await this.subscriptionManager.getPage(subscriptionId, page);
+    this.emit();
+    return result;
+  }
+  /**
+   * Get the next batch of documents after a cursor for infinite scroll.
+   * Requires the subscription to have been created with `progressive: true`.
+   */
+  async getNextBatch(subscriptionId, cursorDocId, limit) {
+    const result = await this.subscriptionManager.getNextBatch(subscriptionId, cursorDocId, limit);
+    this.emit();
+    return result;
+  }
+  /**
+   * Get page information for a subscription.
+   */
+  getPageInfo(subscriptionId) {
+    return this.subscriptionManager.getPageInfo(subscriptionId);
+  }
+  /** Refetches authoritative copies for specific documents and updates cache. */
+  async refetchDocs(docs) {
+    await this.subscriptionManager.backfill({
+      scope: BackfillScope.Docs,
+      docs
+    });
+    this.emit();
+  }
+  /** Adds a store listener; returns an unsubscribe function. */
+  subscribeStore(listener) {
+    this.storeListeners.add(listener);
+    return () => {
+      this.storeListeners.delete(listener);
+    };
+  }
+  /** Notifies listeners, schedules persistence, and broadcasts cross-tab changes. */
+  emit() {
+    for (const listener of this.storeListeners) listener();
+    this.persistenceManager.scheduleSave();
+    this.persistenceManager.broadcastChange();
+  }
+  /** Clears subscriptions, cache, journal, and temp id mappings. */
+  resetCache() {
+    this.subscriptionManager.clear();
+    this.normalizedCache.clear();
+    this.mutationJournal.clear();
+    this.mutationEngine.clearTemporaryMappings();
+    this.emit();
+  }
+  /** Cleanup and dispose of resources */
+  async dispose() {
+    this.storeListeners.clear();
+    this.resetCache();
+    this.mutationJournal.dispose();
+    this.mutationEngine.dispose();
+    this.realtimeHandler.dispose();
+    this.persistenceManager.destroy();
+    this.rehydrationManager.clear();
+    this.cleanupFocus?.();
+    this.cleanupOnlineBackfill?.();
+    this.cleanupOnlineReplay?.();
+    this.cleanupFocus = void 0;
+    this.cleanupOnlineBackfill = void 0;
+    this.cleanupOnlineReplay = void 0;
+    if (this.cdcIntervalHandle) {
+      clearInterval(this.cdcIntervalHandle);
+      this.cdcIntervalHandle = void 0;
+    }
+  }
+  /**
+   * Returns a snapshot of internal state for devtools inspection.
+   * Prefixed with __ to signal internal/debug use only.
+   */
+  __debug() {
+    const allSubs = this.subscriptionManager.getAllSubscriptions();
+    const vpm = this.subscriptionManager.getVirtualPageManager();
+    const subscriptions = [];
+    for (const [, sub] of allSubs) {
+      const virtualSub = vpm.getSubscription(sub.id);
+      const pageInfo = vpm.getPageInfo(sub.id);
+      const islands = vpm.getPageIslands(sub.id);
+      const debugSub = {
+        id: sub.id,
+        query: sub.query,
+        docCount: sub.docIds.length,
+        tombstoneCount: sub.tombstones?.size ?? 0,
+        checkpoint: sub.checkpoint,
+        cursor: sub.cursor,
+        pageInfo
+      };
+      if (virtualSub) {
+        const pc = virtualSub.getProgressiveCache();
+        debugSub.progressiveCache = {
+          docIds: pc.docIds,
+          nextCursor: pc.nextCursor,
+          hasMore: pc.hasMore,
+          totalCount: pc.totalCount,
+          lastFetchedAt: pc.lastFetchedAt?.toISOString(),
+          islands
+        };
+      }
+      subscriptions.push(debugSub);
+    }
+    const cacheStats = this.normalizedCache.getStats();
+    const allEntries = this.mutationJournal.getAllEntries();
+    const pending = [];
+    const confirmed = [];
+    const failed = [];
+    for (const {
+      id,
+      entry
+    } of allEntries) {
+      const debugEntry = {
+        id,
+        operation: entry.operation,
+        doctype: entry.doctype,
+        docname: entry.docname,
+        status: entry.status,
+        createdAt: entry.createdAt ?? 0,
+        retryCount: entry.retryCount ?? 0,
+        error: entry.error ? entry.error.message ?? String(entry.error) : void 0
+      };
+      if (entry.status === Status.Pending) pending.push(debugEntry);else if (entry.status === Status.Confirmed) confirmed.push(debugEntry);else if (entry.status === Status.Failed) failed.push(debugEntry);
+    }
+    return {
+      subscriptions,
+      normalizedCache: cacheStats,
+      mutationJournal: {
+        pending,
+        confirmed,
+        failed
+      },
+      connection: {
+        socketConnected: this.realtimeHandler.getIsConnected(),
+        isLeader: this.persistenceManager.getIsLeader(),
+        isOnline: typeof navigator !== "undefined" ? navigator.onLine : true
+      }
+    };
+  }
+  /**
+   * Checks if this tab is the leader for multi-tab coordination.
+   */
+  isLeader() {
+    return this.persistenceManager.getIsLeader();
+  }
+}
+export { SyncModule };
+//# sourceMappingURL=index.mjs.map

package/dist/jsx/sync/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["onAppFocus","onOnline","MutationEngine","MutationJournal","NormalizedCache","PersistenceManager","RealtimeHandler","RehydrationManager","SubscriptionManager","BackfillScope","Status","SyncModule","constructor","db","realtime","options","normalizedCache","maxSize","maxCacheSize","mutationJournal","ttl","mutationTTL","enableAutoCleanup","storage","localStorage","subscriptionManager","rehydrationManager","mutationEngine","realtimeOptions","onResetCache","resetCache","onBackfillAll","backfill","scope","All","realtimeHandler","persistenceManager","setupWindowEvents","storeListeners","Set","cleanupFocus","cleanupOnlineBackfill","cleanupOnlineReplay","cdcIntervalHandle","replayPending","cdcInterval","setInterval","subscribe","query","result","emit","unsubscribe","subscriptionId","mutate","mutation","broadcastMutation","args","getDocFromCache","doctype","name","get","getSubscription","id","getDocsForSubscription","getPage","page","getNextBatch","cursorDocId","limit","getPageInfo","refetchDocs","docs","Docs","subscribeStore","listener","add","delete","scheduleSave","broadcastChange","clear","clearTemporaryMappings","dispose","destroy","clearInterval","__debug","allSubs","getAllSubscriptions","vpm","getVirtualPageManager","subscriptions","sub","virtualSub","pageInfo","islands","getPageIslands","debugSub","docCount","docIds","length","tombstoneCount","tombstones","size","checkpoint","cursor","pc","getProgressiveCache","progressiveCache","nextCursor","hasMore","totalCount","lastFetchedAt","toISOString","push","cacheStats","getStats","allEntries","getAllEntries","pending","confirmed","failed","entry","debugEntry","operation","docname","status","createdAt","retryCount","error","message","String","Pending","Confirmed","Failed","connection","socketConnected","getIsConnected","isLeader","getIsLeader","isOnline","navigator","onLine"],"sources":["../../../src/sync/index.ts"],"sourcesContent":[null],"mappings":"AAGA,SAASA,UAAA,EAAYC,QAAA,QAAgB;AACrC,SAASC,cAAA,QAAsB;AAC/B,SAASC,eAAA,QAAuB;AAChC,SAASC,eAAA,QAAuB;AAChC,SAASC,kBAAA,QAA0B;AACnC,SAASC,eAAA,QAAuB;AAChC,SAASC,kBAAA,QAA0B;AACnC,SAASC,mBAAA,QAA2B;AACpC,SAASC,aAAA,EAAeC,MAAA,QAAc;AAyD/B,MAAMC,UAAA,CAAW;EAoBtBC,YACmBC,EAAA,EACAC,QAAA,EACAC,OAAA,GAAuB,CAAC,GACzC;IAHiB,KAAAF,EAAA,GAAAA,EAAA;IACA,KAAAC,QAAA,GAAAA,QAAA;IACA,KAAAC,OAAA,GAAAA,OAAA;IAGjB,KAAKC,eAAA,GAAkB,IAAIZ,eAAA,CAAgB;MACzCa,OAAA,EAAS,KAAKF,OAAA,CAAQG;IACxB,CAAC;IACD,KAAKC,eAAA,GAAkB,IAAIhB,eAAA,CAAgB;MACzCiB,GAAA,EAAK,KAAKL,OAAA,CAAQM,WAAA;MAClBC,iBAAA,EAAmB;MACnBC,OAAA,EAAS,OAAOC,YAAA,KAAiB,cAAcA,YAAA,GAAe;IAChE,CAAC;IACD,KAAKC,mBAAA,GAAsB,IAAIjB,mBAAA,CAAoB,KAAKK,EAAA,EAAI,KAAKG,eAAA,EAAiB,KAAKD,OAAO;IAG9F,KAAKW,kBAAA,GAAqB,IAAInB,kBAAA,CAC5B,KAAKM,EAAA,EACL,KAAKG,eAAA,EACL,KAAKS,mBAAA,EACL,KAAKN,eACP;IAEA,KAAKQ,cAAA,GAAiB,IAAIzB,cAAA,CACxB,KAAKW,EAAA,EACL,KAAKC,QAAA,EACL,KAAKE,eAAA,EACL,KAAKG,eAAA,EACL,KAAKM,mBAAA,EACL,KAAKC,kBAAA,EACL,KAAKX,OACP;IAGA,MAAMa,eAAA,GAA+B;MACnC,GAAG,KAAKb,OAAA;MACRc,YAAA,EAAcA,CAAA,KAAM,KAAKC,UAAA,CAAW;MACpCC,aAAA,EAAeA,CAAA,KAAM,KAAKC,QAAA,CAAS;QAAEC,KAAA,EAAOxB,aAAA,CAAcyB;MAAI,CAAC;IACjE;IAEA,KAAKC,eAAA,GAAkB,IAAI7B,eAAA,CACzB,KAAKO,EAAA,EACL,KAAKC,QAAA,EACL,KAAKE,eAAA,EACL,KAAKS,mBAAA,EACL,KAAKC,kBAAA,EACLE,eACF;IAEA,KAAKQ,kBAAA,GAAqB,IAAI/B,kBAAA,CAC5B,KAAKW,eAAA,EACL,KAAKG,eAAA,EACL,KAAKM,mBAAA,EACL,KAAKE,cAAA,EACLC,eACF;IAEA,KAAKS,iBAAA,CAAkB;EACzB;EA1DmBxB,EAAA;EACAC,QAAA;EACAC,OAAA;EAtBXC,eAAA;EACAG,eAAA;EACAmB,cAAA,GAAiB,mBAAIC,GAAA,CAAgB;EACrCd,mBAAA;EAAA;EAEAE,cAAA;EAAA;EAEAQ,eAAA;EAAA;EAEAC,kBAAA;EAAA;EAEAV,kBAAA;EAAA;EAEAc,YAAA;EACAC,qBAAA;EACAC,mBAAA;EAAA;EAEAC,iBAAA;EAAA;AAAA;AAAA;AAAA;EAmEAN,kBAAA,EAAoB;IAC1B,KAAKG,YAAA,GAAexC,UAAA,CAAW,MAAM,KAAKgC,QAAA,CAAS;MAAEC,KAAA,EAAOxB,aAAA,CAAcyB;IAAI,CAAC,CAAC;IAChF,KAAKO,qBAAA,GAAwBxC,QAAA,CAAS,MAAM,KAAK+B,QAAA,CAAS;MAAEC,KAAA,EAAOxB,aAAA,CAAcyB;IAAI,CAAC,CAAC;IACvF,KAAKQ,mBAAA,GAAsBzC,QAAA,CAAS,MAAM,KAAK2C,aAAA,CAAc,CAAC;IAE9D,IAAI,KAAK7B,OAAA,CAAQ8B,WAAA,IAAe,KAAK9B,OAAA,CAAQ8B,WAAA,GAAc,GAAG;MAC5D,KAAKF,iBAAA,GAAoBG,WAAA,CACvB,MAAM,KAAKd,QAAA,CAAS;QAAEC,KAAA,EAAOxB,aAAA,CAAcyB;MAAI,CAAC,GAChD,KAAKnB,OAAA,CAAQ8B,WACf;IACF;EACF;EAAA;AAAA;AAAA;EAKA,MAAME,UAAsCC,KAAA,EAA0B;IACpE,MAAMC,MAAA,GAAS,MAAM,KAAKxB,mBAAA,CAAoBsB,SAAA,CAAgBC,KAAK;IACnE,KAAKE,IAAA,CAAK;IACV,OAAOD,MAAA;EACT;EAAA;AAAA;AAAA;EAKAE,YAAYC,cAAA,EAAwB;IAClC,KAAK3B,mBAAA,CAAoB0B,WAAA,CAAYC,cAAc;IACnD,KAAKF,IAAA,CAAK;EACZ;EAEA,MAAMG,OAAOC,QAAA,EAAmC;IAC9C,MAAM,KAAK3B,cAAA,CAAe0B,MAAA,CAAOC,QAAQ;IAEzC,KAAKlB,kBAAA,CAAmBmB,iBAAA,CAAkBD,QAAQ;IAClD,KAAKJ,IAAA,CAAK;EACZ;EAAA;AAAA;AAAA;EAKA,MAAMlB,SAASwB,IAAA,EAAoB;IACjC,MAAM,KAAK/B,mBAAA,CAAoBO,QAAA,CAASwB,IAAI;IAC5C,KAAKN,IAAA,CAAK;EACZ;EAAA;AAAA;AAAA;EAKA,MAAMN,cAAA,EAAgB;IACpB,MAAM,KAAKjB,cAAA,CAAeiB,aAAA,CAAc;IACxC,KAAKM,IAAA,CAAK;EACZ;EAAA;EAGAO,gBACEC,OAAA,EACAC,IAAA,EACe;IACf,OAAO,KAAK3C,eAAA,CAAgB4C,GAAA,CAAI;MAAEF,OAAA;MAASC;IAAK,CAAC;EACnD;EAAA;EAGAE,gBAAgBC,EAAA,EAAY;IAC1B,OAAO,KAAKrC,mBAAA,CAAoBoC,eAAA,CAAgBC,EAAE;EACpD;EAAA;AAAA;AAAA;EAKAC,uBAAmDD,EAAA,EAA+B;IAChF,OAAO,KAAKrC,mBAAA,CAAoBsC,sBAAA,CAAwCD,EAAE;EAC5E;EAAA;AAAA;AAAA;AAAA;EAMA,MAAME,QACJZ,cAAA,EACAa,IAAA,EAC4B;IAC5B,MAAMhB,MAAA,GAAS,MAAM,KAAKxB,mBAAA,CAAoBuC,OAAA,CAAyBZ,cAAA,EAAgBa,IAAI;IAC3F,KAAKf,IAAA,CAAK;IACV,OAAOD,MAAA;EACT;EAAA;AAAA;AAAA;AAAA;EAMA,MAAMiB,aACJd,cAAA,EACAe,WAAA,EACAC,KAAA,EAC4B;IAC5B,MAAMnB,MAAA,GAAS,MAAM,KAAKxB,mBAAA,CAAoByC,YAAA,CAC5Cd,cAAA,EACAe,WAAA,EACAC,KACF;IACA,KAAKlB,IAAA,CAAK;IACV,OAAOD,MAAA;EACT;EAAA;AAAA;AAAA;EAKAoB,YAAYjB,cAAA,EAAwB;IAClC,OAAO,KAAK3B,mBAAA,CAAoB4C,WAAA,CAAYjB,cAAc;EAC5D;EAAA;EAGA,MAAMkB,YAAYC,IAAA,EAA2C;IAC3D,MAAM,KAAK9C,mBAAA,CAAoBO,QAAA,CAAS;MACtCC,KAAA,EAAOxB,aAAA,CAAc+D,IAAA;MACrBD;IACF,CAAC;IACD,KAAKrB,IAAA,CAAK;EACZ;EAAA;EAGAuB,eAAeC,QAAA,EAAkC;IAC/C,KAAKpC,cAAA,CAAeqC,GAAA,CAAID,QAAQ;IAChC,OAAO,MAAM;MACX,KAAKpC,cAAA,CAAesC,MAAA,CAAOF,QAAQ;IACrC;EACF;EAAA;EAGQxB,KAAA,EAAO;IAEb,WAAWwB,QAAA,IAAY,KAAKpC,cAAA,EAAgBoC,QAAA,CAAS;IAErD,KAAKtC,kBAAA,CAAmByC,YAAA,CAAa;IAErC,KAAKzC,kBAAA,CAAmB0C,eAAA,CAAgB;EAC1C;EAAA;EAGAhD,WAAA,EAAa;IAEX,KAAKL,mBAAA,CAAoBsD,KAAA,CAAM;IAC/B,KAAK/D,eAAA,CAAgB+D,KAAA,CAAM;IAC3B,KAAK5D,eAAA,CAAgB4D,KAAA,CAAM;IAC3B,KAAKpD,cAAA,CAAeqD,sBAAA,CAAuB;IAE3C,KAAK9B,IAAA,CAAK;EACZ;EAAA;EAGA,MAAM+B,QAAA,EAAU;IAEd,KAAK3C,cAAA,CAAeyC,KAAA,CAAM;IAG1B,KAAKjD,UAAA,CAAW;IAGhB,KAAKX,eAAA,CAAgB8D,OAAA,CAAQ;IAC7B,KAAKtD,cAAA,CAAesD,OAAA,CAAQ;IAC5B,KAAK9C,eAAA,CAAgB8C,OAAA,CAAQ;IAC7B,KAAK7C,kBAAA,CAAmB8C,OAAA,CAAQ;IAChC,KAAKxD,kBAAA,CAAmBqD,KAAA,CAAM;IAG9B,KAAKvC,YAAA,GAAe;IACpB,KAAKC,qBAAA,GAAwB;IAC7B,KAAKC,mBAAA,GAAsB;IAC3B,KAAKF,YAAA,GAAe;IACpB,KAAKC,qBAAA,GAAwB;IAC7B,KAAKC,mBAAA,GAAsB;IAE3B,IAAI,KAAKC,iBAAA,EAAmB;MAC1BwC,aAAA,CAAc,KAAKxC,iBAAiB;MACpC,KAAKA,iBAAA,GAAoB;IAC3B;EACF;EAAA;AAAA;AAAA;AAAA;EAMAyC,QAAA,EAA4B;IAC1B,MAAMC,OAAA,GAAU,KAAK5D,mBAAA,CAAoB6D,mBAAA,CAAoB;IAC7D,MAAMC,GAAA,GAAM,KAAK9D,mBAAA,CAAoB+D,qBAAA,CAAsB;IAE3D,MAAMC,aAAA,GAAqC,EAAC;IAC5C,WAAW,GAAGC,GAAG,KAAKL,OAAA,EAAS;MAC7B,MAAMM,UAAA,GAAaJ,GAAA,CAAI1B,eAAA,CAAgB6B,GAAA,CAAI5B,EAAE;MAC7C,MAAM8B,QAAA,GAAWL,GAAA,CAAIlB,WAAA,CAAYqB,GAAA,CAAI5B,EAAE;MACvC,MAAM+B,OAAA,GAAUN,GAAA,CAAIO,cAAA,CAAeJ,GAAA,CAAI5B,EAAE;MAEzC,MAAMiC,QAAA,GAA8B;QAClCjC,EAAA,EAAI4B,GAAA,CAAI5B,EAAA;QACRd,KAAA,EAAO0C,GAAA,CAAI1C,KAAA;QACXgD,QAAA,EAAUN,GAAA,CAAIO,MAAA,CAAOC,MAAA;QACrBC,cAAA,EAAgBT,GAAA,CAAIU,UAAA,EAAYC,IAAA,IAAQ;QACxCC,UAAA,EAAYZ,GAAA,CAAIY,UAAA;QAChBC,MAAA,EAAQb,GAAA,CAAIa,MAAA;QACZX;MACF;MAEA,IAAID,UAAA,EAAY;QACd,MAAMa,EAAA,GAAKb,UAAA,CAAWc,mBAAA,CAAoB;QAC1CV,QAAA,CAASW,gBAAA,GAAmB;UAC1BT,MAAA,EAAQO,EAAA,CAAGP,MAAA;UACXU,UAAA,EAAYH,EAAA,CAAGG,UAAA;UACfC,OAAA,EAASJ,EAAA,CAAGI,OAAA;UACZC,UAAA,EAAYL,EAAA,CAAGK,UAAA;UACfC,aAAA,EAAeN,EAAA,CAAGM,aAAA,EAAeC,WAAA,CAAY;UAC7ClB;QACF;MACF;MAEAJ,aAAA,CAAcuB,IAAA,CAAKjB,QAAQ;IAC7B;IAEA,MAAMkB,UAAA,GAAa,KAAKjG,eAAA,CAAgBkG,QAAA,CAAS;IAEjD,MAAMC,UAAA,GAAa,KAAKhG,eAAA,CAAgBiG,aAAA,CAAc;IACtD,MAAMC,OAAA,GAAgC,EAAC;IACvC,MAAMC,SAAA,GAAkC,EAAC;IACzC,MAAMC,MAAA,GAA+B,EAAC;IAEtC,WAAW;MAAEzD,EAAA;MAAI0D;IAAM,KAAKL,UAAA,EAAY;MACtC,MAAMM,UAAA,GAAiC;QACrC3D,EAAA;QACA4D,SAAA,EAAWF,KAAA,CAAME,SAAA;QACjBhE,OAAA,EAAS8D,KAAA,CAAM9D,OAAA;QACfiE,OAAA,EAASH,KAAA,CAAMG,OAAA;QACfC,MAAA,EAAQJ,KAAA,CAAMI,MAAA;QACdC,SAAA,EAAWL,KAAA,CAAMK,SAAA,IAAa;QAC9BC,UAAA,EAAYN,KAAA,CAAMM,UAAA,IAAc;QAChCC,KAAA,EAAOP,KAAA,CAAMO,KAAA,GAAUP,KAAA,CAAMO,KAAA,CAAgBC,OAAA,IAAWC,MAAA,CAAOT,KAAA,CAAMO,KAAK,IAAK;MACjF;MACA,IAAIP,KAAA,CAAMI,MAAA,KAAWlH,MAAA,CAAOwH,OAAA,EAASb,OAAA,CAAQL,IAAA,CAAKS,UAAU,WACnDD,KAAA,CAAMI,MAAA,KAAWlH,MAAA,CAAOyH,SAAA,EAAWb,SAAA,CAAUN,IAAA,CAAKS,UAAU,WAC5DD,KAAA,CAAMI,MAAA,KAAWlH,MAAA,CAAO0H,MAAA,EAAQb,MAAA,CAAOP,IAAA,CAAKS,UAAU;IACjE;IAEA,OAAO;MACLhC,aAAA;MACAzE,eAAA,EAAiBiG,UAAA;MACjB9F,eAAA,EAAiB;QAAEkG,OAAA;QAASC,SAAA;QAAWC;MAAO;MAC9Cc,UAAA,EAAY;QACVC,eAAA,EAAiB,KAAKnG,eAAA,CAAgBoG,cAAA,CAAe;QACrDC,QAAA,EAAU,KAAKpG,kBAAA,CAAmBqG,WAAA,CAAY;QAC9CC,QAAA,EAAU,OAAOC,SAAA,KAAc,cAAcA,SAAA,CAAUC,MAAA,GAAS;MAClE;IACF;EACF;EAAA;AAAA;AAAA;EAKAJ,SAAA,EAAoB;IAClB,OAAO,KAAKpG,kBAAA,CAAmBqG,WAAA,CAAY;EAC7C;AACF","ignoreList":[]}