@uwdata/mosaic-core 0.17.0 → 0.19.0

package/dist/src/util/js-type.js

@@ -0,0 +1,59 @@
+/**
+ * Maps a SQL data type to its corresponding JavaScript type.
+ * @param type The name of a SQL data type
+ * @returns The corresponding JavaScript type name
+ * @throws Throws an error if the given SQL type name is unsupported or unrecognized.
+ */
+export function jsType(type) {
+    switch (type) {
+        case 'BIGINT':
+        case 'HUGEINT':
+        case 'INTEGER':
+        case 'SMALLINT':
+        case 'TINYINT':
+        case 'UBIGINT':
+        case 'UINTEGER':
+        case 'USMALLINT':
+        case 'UTINYINT': // integers
+        case 'DOUBLE':
+        case 'FLOAT':
+        case 'REAL':
+            return 'number';
+        case 'DATE':
+        case 'TIMESTAMP':
+        case 'TIMESTAMPTZ':
+        case 'TIMESTAMP WITH TIME ZONE':
+        case 'TIME':
+        case 'TIMESTAMP_NS':
+            return 'date';
+        case 'BOOLEAN':
+            return 'boolean';
+        case 'VARCHAR':
+        case 'UUID':
+        case 'JSON':
+            return 'string';
+        case 'ARRAY':
+        case 'LIST':
+            return 'array';
+        case 'BLOB':
+        case 'STRUCT':
+        case 'MAP':
+        case 'GEOMETRY':
+            return 'object';
+        default:
+            if (type.startsWith('ENUM')) {
+                return 'string';
+            }
+            else if (type.startsWith('DECIMAL')) {
+                return 'number';
+            }
+            else if (type.startsWith('STRUCT') || type.startsWith('MAP')) {
+                return 'object';
+            }
+            else if (type.endsWith(']')) {
+                return 'array';
+            }
+            throw new Error(`Unsupported type: ${type}`);
+    }
+}
+//# sourceMappingURL=js-type.js.map

package/dist/src/util/js-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-type.js","sourceRoot":"","sources":["../../../src/util/js-type.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,SAAS,CAAC;QACf,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS,CAAC;QACf,KAAK,SAAS,CAAC;QACf,KAAK,UAAU,CAAC;QAChB,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU,CAAC,CAAC,WAAW;QAC5B,KAAK,QAAQ,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC;QAClB,KAAK,MAAM,CAAC;QACZ,KAAK,WAAW,CAAC;QACjB,KAAK,aAAa,CAAC;QACnB,KAAK,0BAA0B,CAAC;QAChC,KAAK,MAAM,CAAC;QACZ,KAAK,cAAc;YACjB,OAAO,MAAM,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,SAAS,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC;QAClB,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,OAAO,CAAC;QACjB,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,KAAK,CAAC;QACX,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC;QAClB;YACE,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,OAAO,QAAQ,CAAC;YAClB,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBACtC,OAAO,QAAQ,CAAC;YAClB,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/D,OAAO,QAAQ,CAAC;YAClB,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/src/util/priority-queue.d.ts

@@ -0,0 +1,35 @@
+export declare class PriorityQueue<T = unknown> {
+    private queue;
+    /**
+     * Create a new priority queue instance.
+     * @param ranks An integer number of rank-order priority levels.
+     */
+    constructor(ranks: number);
+    /**
+     * Indicate if the queue is empty.
+     * @returns true if empty, false otherwise.
+     */
+    isEmpty(): boolean;
+    /**
+     * Insert an item into the queue with a given priority rank.
+     * @param item The item to add.
+     * @param rank The integer priority rank.
+     * Priority ranks are integers starting at zero.
+     * Lower ranks indicate higher priority.
+     */
+    insert(item: T, rank: number): void;
+    /**
+     * Remove a set of items from the queue, regardless of priority rank.
+     * If a provided item is not in the queue it will be ignored.
+     * @param test A predicate function to test
+     * if an item should be removed (true to drop, false to keep).
+     */
+    remove(test: (item: T) => boolean): void;
+    /**
+     * Remove and return the next highest priority item.
+     * @returns The next item in the queue,
+     * or undefined if this queue is empty.
+     */
+    next(): T | undefined;
+}
+//# sourceMappingURL=priority-queue.d.ts.map

package/dist/src/util/priority-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-queue.d.ts","sourceRoot":"","sources":["../../../src/util/priority-queue.ts"],"names":[],"mappings":"AAUA,qBAAa,aAAa,CAAC,CAAC,GAAG,OAAO;IACpC,OAAO,CAAC,KAAK,CAAY;IAEzB;;;OAGG;gBACS,KAAK,EAAE,MAAM;IAQzB;;;OAGG;IACH,OAAO,IAAI,OAAO;IAIlB;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAcnC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI;IAkBxC;;;;OAIG;IACH,IAAI,IAAI,CAAC,GAAG,SAAS;CAYtB"}

package/dist/src/util/priority-queue.js

@@ -0,0 +1,81 @@
+export class PriorityQueue {
+    queue;
+    /**
+     * Create a new priority queue instance.
+     * @param ranks An integer number of rank-order priority levels.
+     */
+    constructor(ranks) {
+        // one list for each integer priority level
+        this.queue = Array.from({ length: ranks }, () => ({ head: null, tail: null }));
+    }
+    /**
+     * Indicate if the queue is empty.
+     * @returns true if empty, false otherwise.
+     */
+    isEmpty() {
+        return this.queue.every(list => !list.head);
+    }
+    /**
+     * Insert an item into the queue with a given priority rank.
+     * @param item The item to add.
+     * @param rank The integer priority rank.
+     * Priority ranks are integers starting at zero.
+     * Lower ranks indicate higher priority.
+     */
+    insert(item, rank) {
+        const list = this.queue[rank];
+        if (!list) {
+            throw new Error(`Invalid queue priority rank: ${rank}`);
+        }
+        const node = { item, next: null };
+        if (list.head === null) {
+            list.head = list.tail = node;
+        }
+        else {
+            list.tail = list.tail.next = node;
+        }
+    }
+    /**
+     * Remove a set of items from the queue, regardless of priority rank.
+     * If a provided item is not in the queue it will be ignored.
+     * @param test A predicate function to test
+     * if an item should be removed (true to drop, false to keep).
+     */
+    remove(test) {
+        for (const list of this.queue) {
+            let { head, tail } = list;
+            for (let prev = null, curr = head; curr; prev = curr, curr = curr.next) {
+                if (test(curr.item)) {
+                    if (curr === head) {
+                        head = curr.next;
+                    }
+                    else {
+                        prev.next = curr.next;
+                    }
+                    if (curr === tail)
+                        tail = prev || head;
+                }
+            }
+            list.head = head;
+            list.tail = tail;
+        }
+    }
+    /**
+     * Remove and return the next highest priority item.
+     * @returns The next item in the queue,
+     * or undefined if this queue is empty.
+     */
+    next() {
+        for (const list of this.queue) {
+            const { head } = list;
+            if (head !== null) {
+                list.head = head.next;
+                if (list.tail === head) {
+                    list.tail = null;
+                }
+                return head.item;
+            }
+        }
+    }
+}
+//# sourceMappingURL=priority-queue.js.map

package/dist/src/util/priority-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-queue.js","sourceRoot":"","sources":["../../../src/util/priority-queue.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,aAAa;IAChB,KAAK,CAAY;IAEzB;;;OAGG;IACH,YAAY,KAAa;QACvB,2CAA2C;QAC3C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CACrB,EAAE,MAAM,EAAE,KAAK,EAAE,EACjB,GAAY,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAC5C,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,IAAO,EAAE,IAAY;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,IAAI,GAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC/C,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QACrC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAA0B;QAC/B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;YAC1B,KAAK,IAAI,IAAI,GAAuB,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC3F,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;wBAClB,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;oBACnB,CAAC;yBAAM,CAAC;wBACN,IAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;oBACzB,CAAC;oBACD,IAAI,IAAI,KAAK,IAAI;wBAAE,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC;gBACzC,CAAC;YACH,CAAC;YACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;YACtB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;gBACtB,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;oBACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;gBACnB,CAAC;gBACD,OAAO,IAAI,CAAC,IAAI,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/src/util/query-result.d.ts

@@ -0,0 +1,47 @@
+export declare const QueryState: Readonly<{
+    pending: symbol;
+    ready: symbol;
+    error: symbol;
+    done: symbol;
+}>;
+type QueryStateType = typeof QueryState[keyof typeof QueryState];
+/**
+ * A query result Promise that can allows external callers
+ * to resolve or reject the Promise.
+ */
+export declare class QueryResult<T = unknown> extends Promise<T> {
+    private _resolve;
+    private _reject;
+    private _state;
+    private _value;
+    /**
+     * Create a new query result Promise.
+     */
+    constructor();
+    /**
+     * Resolve the result Promise with a prepared value or the provided value.
+     * This method will only succeed if either a value is provided or the promise is ready.
+     * @param value The result value.
+     * @returns This QueryResult instance.
+     */
+    fulfill(value?: T): this;
+    /**
+     * Prepare to resolve with the provided value.
+     * @param value The result value.
+     * @returns This QueryResult instance.
+     */
+    ready(value: T): this;
+    /**
+     * Rejects the result Promise with the provided error.
+     * @param error The error value.
+     * @returns This QueryResult instance.
+     */
+    reject(error: unknown): this;
+    /**
+     * Returns the state of this query result.
+     * @returns The current state symbol.
+     */
+    get state(): QueryStateType;
+}
+export {};
+//# sourceMappingURL=query-result.d.ts.map

package/dist/src/util/query-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-result.d.ts","sourceRoot":"","sources":["../../../src/util/query-result.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;;;;;EAKrB,CAAC;AAEH,KAAK,cAAc,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEjE;;;GAGG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAgB;IAE9B;;OAEG;;IAcH;;;;;OAKG;IACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAiBxB;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAMrB;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAM5B;;;OAGG;IACH,IAAI,KAAK,IAAI,cAAc,CAE1B;CACF"}

package/dist/src/util/query-result.js

@@ -0,0 +1,83 @@
+export const QueryState = Object.freeze({
+    pending: Symbol('pending'),
+    ready: Symbol('ready'),
+    error: Symbol('error'),
+    done: Symbol('done')
+});
+/**
+ * A query result Promise that can allows external callers
+ * to resolve or reject the Promise.
+ */
+export class QueryResult extends Promise {
+    _resolve;
+    _reject;
+    _state;
+    _value;
+    /**
+     * Create a new query result Promise.
+     */
+    constructor() {
+        let resolve;
+        let reject;
+        super((r, e) => {
+            resolve = r;
+            reject = e;
+        });
+        this._resolve = resolve;
+        this._reject = reject;
+        this._state = QueryState.pending;
+        this._value = undefined;
+    }
+    /**
+     * Resolve the result Promise with a prepared value or the provided value.
+     * This method will only succeed if either a value is provided or the promise is ready.
+     * @param value The result value.
+     * @returns This QueryResult instance.
+     */
+    fulfill(value) {
+        if (this._value !== undefined) {
+            if (value !== undefined) {
+                throw Error('Promise is ready and fulfill has a provided value');
+            }
+            this._resolve(this._value);
+        }
+        else if (value === undefined) {
+            throw Error('Promise is neither ready nor has provided value');
+        }
+        else {
+            this._resolve(value);
+        }
+        this._state = QueryState.done;
+        return this;
+    }
+    /**
+     * Prepare to resolve with the provided value.
+     * @param value The result value.
+     * @returns This QueryResult instance.
+     */
+    ready(value) {
+        this._state = QueryState.ready;
+        this._value = value;
+        return this;
+    }
+    /**
+     * Rejects the result Promise with the provided error.
+     * @param error The error value.
+     * @returns This QueryResult instance.
+     */
+    reject(error) {
+        this._state = QueryState.error;
+        this._reject(error);
+        return this;
+    }
+    /**
+     * Returns the state of this query result.
+     * @returns The current state symbol.
+     */
+    get state() {
+        return this._state;
+    }
+}
+// necessary to make Promise subclass act like a Promise
+QueryResult.prototype.constructor = Promise;
+//# sourceMappingURL=query-result.js.map

package/dist/src/util/query-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-result.js","sourceRoot":"","sources":["../../../src/util/query-result.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;CACrB,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,OAAO,WAAyB,SAAQ,OAAU;IAC9C,QAAQ,CAAuC;IAC/C,OAAO,CAA8B;IACrC,MAAM,CAAiB;IACvB,MAAM,CAAgB;IAE9B;;OAEG;IACH;QACE,IAAI,OAA4C,CAAC;QACjD,IAAI,MAAkC,CAAC;QACvC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACb,OAAO,GAAG,CAAC,CAAC;YACZ,MAAM,GAAG,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,OAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,MAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAS;QACf,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC;QAE9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAQ;QACZ,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAc;QACnB,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC;QAC/B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAED,wDAAwD;AACxD,WAAW,CAAC,SAAS,CAAC,WAAW,GAAG,OAAO,CAAC"}

package/dist/src/util/synchronizer.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Synchronizer class to aid synchronization of updates on multiple pending operations.
+ */
+export declare class Synchronizer<T = unknown> {
+    private _set;
+    private _done;
+    private _promise;
+    /**
+     * Create a new synchronizer instance.
+     */
+    constructor();
+    /**
+     * Mark an item as pending.
+     * @param item An item to synchronize on.
+     */
+    pending(item: T): void;
+    /**
+     * Mark a pending item as ready, indicating it is
+     * ready for a synchronized update.
+     * @param item An item to synchronize on.
+     * @returns True if the synchronizer is ready to
+     *  resolve, false otherwise.
+     */
+    ready(item: T): boolean;
+    /**
+     * Resolve the current synchronization cycle, causing the synchronize
+     * promise to resolve and thereby trigger downstream updates.
+     */
+    resolve(): void;
+    /**
+     * The promise for the current synchronization cycle.
+     * @returns The synchronization promise.
+     */
+    get promise(): Promise<void>;
+}
+//# sourceMappingURL=synchronizer.d.ts.map

package/dist/src/util/synchronizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synchronizer.d.ts","sourceRoot":"","sources":["../../../src/util/synchronizer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO;IACnC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,QAAQ,CAAgB;IAEhC;;OAEG;;IAOH;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAItB;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO;IAKvB;;;OAGG;IACH,OAAO,IAAI,IAAI;IAOf;;;OAGG;IACH,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACF"}

package/dist/src/util/synchronizer.js

@@ -0,0 +1,52 @@
+/**
+ * Synchronizer class to aid synchronization of updates on multiple pending operations.
+ */
+export class Synchronizer {
+    _set;
+    _done;
+    _promise;
+    /**
+     * Create a new synchronizer instance.
+     */
+    constructor() {
+        this._set = new Set();
+        this._done = () => { };
+        this._promise = new Promise(resolve => this._done = resolve);
+    }
+    /**
+     * Mark an item as pending.
+     * @param item An item to synchronize on.
+     */
+    pending(item) {
+        this._set.add(item);
+    }
+    /**
+     * Mark a pending item as ready, indicating it is
+     * ready for a synchronized update.
+     * @param item An item to synchronize on.
+     * @returns True if the synchronizer is ready to
+     *  resolve, false otherwise.
+     */
+    ready(item) {
+        this._set.delete(item);
+        return this._set.size === 0;
+    }
+    /**
+     * Resolve the current synchronization cycle, causing the synchronize
+     * promise to resolve and thereby trigger downstream updates.
+     */
+    resolve() {
+        this._promise = new Promise(resolve => {
+            this._done();
+            this._done = resolve;
+        });
+    }
+    /**
+     * The promise for the current synchronization cycle.
+     * @returns The synchronization promise.
+     */
+    get promise() {
+        return this._promise;
+    }
+}
+//# sourceMappingURL=synchronizer.js.map

package/dist/src/util/synchronizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synchronizer.js","sourceRoot":"","sources":["../../../src/util/synchronizer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,IAAI,CAAS;IACb,KAAK,CAAa;IAClB,QAAQ,CAAgB;IAEhC;;OAEG;IACH;QACE,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,EAAK,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC;IACrE,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,IAAO;QACb,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAO;QACX,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,CAAC,QAAQ,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;YAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}

package/dist/src/util/throttle.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Throttle invocations of a callback function. The callback must return
+ * a Promise. Upon repeated invocation, the callback will not be invoked
+ * until a prior Promise resolves. If multiple invocations occurs while
+ * waiting, only the most recent invocation will be pending.
+ * @param callback The callback function.
+ * @param debounce Flag indicating if invocations
+ *  should also be debounced within the current animation frame.
+ * @returns A new function that throttles access to the callback.
+ */
+export declare function throttle<E, T>(callback: (event?: E) => Promise<T> | null, debounce?: boolean): (event?: E) => void;
+//# sourceMappingURL=throttle.d.ts.map

package/dist/src/util/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../../src/util/throttle.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC3B,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAC1C,QAAQ,GAAE,OAAe,GACxB,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAuCrB"}

package/dist/src/util/throttle.js

@@ -0,0 +1,51 @@
+const NIL = {};
+/**
+ * Throttle invocations of a callback function. The callback must return
+ * a Promise. Upon repeated invocation, the callback will not be invoked
+ * until a prior Promise resolves. If multiple invocations occurs while
+ * waiting, only the most recent invocation will be pending.
+ * @param callback The callback function.
+ * @param debounce Flag indicating if invocations
+ *  should also be debounced within the current animation frame.
+ * @returns A new function that throttles access to the callback.
+ */
+export function throttle(callback, debounce = false) {
+    let curr;
+    let next;
+    let pending = NIL;
+    function invoke(event) {
+        curr = callback(event)
+            ?.catch(() => { })
+            .finally(() => {
+            if (next) {
+                const { event: value } = next;
+                next = null;
+                invoke(value);
+            }
+            else {
+                curr = null;
+            }
+        }) || null;
+    }
+    function enqueue(event) {
+        next = { event };
+    }
+    function process(event) {
+        if (curr)
+            enqueue(event);
+        else
+            invoke(event);
+    }
+    function delay(event) {
+        if (pending !== event) {
+            requestAnimationFrame(() => {
+                const e = pending;
+                pending = NIL;
+                process(e);
+            });
+        }
+        pending = event;
+    }
+    return debounce ? delay : process;
+}
+//# sourceMappingURL=throttle.js.map

package/dist/src/util/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../../src/util/throttle.ts"],"names":[],"mappings":"AAAA,MAAM,GAAG,GAAG,EAAE,CAAC;AAMf;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CACtB,QAA0C,EAC1C,WAAoB,KAAK;IAEzB,IAAI,IAA6B,CAAC;IAClC,IAAI,IAAqC,CAAC;IAC1C,IAAI,OAAO,GAA+B,GAAG,CAAC;IAE9C,SAAS,MAAM,CAAC,KAAS;QACvB,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC;YACpB,EAAE,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;aAChB,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;gBAC9B,IAAI,GAAG,IAAI,CAAC;gBACZ,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,IAAI,CAAC;YACd,CAAC;QACH,CAAC,CAAC,IAAI,IAAI,CAAC;IACf,CAAC;IAED,SAAS,OAAO,CAAC,KAAQ;QACvB,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,SAAS,OAAO,CAAC,KAAS;QACxB,IAAI,IAAI;YAAE,OAAO,CAAC,KAAM,CAAC,CAAC;;YAAM,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,SAAS,KAAK,CAAC,KAAS;QACtB,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;YACtB,qBAAqB,CAAC,GAAG,EAAE;gBACzB,MAAM,CAAC,GAAG,OAAY,CAAC;gBACvB,OAAO,GAAG,GAAG,CAAC;gBACd,OAAO,CAAC,CAAC,CAAC,CAAC;YACb,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,GAAG,KAAK,CAAC;IAClB,CAAC;IAED,OAAO,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;AACpC,CAAC"}

package/dist/src/util/to-data-columns.d.ts

@@ -0,0 +1,22 @@
+/**
+ * An Array or TypedArray
+ */
+type Arrayish = Array<unknown> | Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array;
+/**
+ * Data columns structure with either named columns or values array
+ */
+type DataColumns = {
+    numRows: number;
+    columns: Record<string, Arrayish>;
+} | {
+    numRows: number;
+    values: Arrayish;
+};
+/**
+ * Convert input data to a set of column arrays.
+ * @param data The input data.
+ * @returns An object with named column arrays.
+ */
+export declare function toDataColumns(data: unknown): DataColumns;
+export {};
+//# sourceMappingURL=to-data-columns.d.ts.map

package/dist/src/util/to-data-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-data-columns.d.ts","sourceRoot":"","sources":["../../../src/util/to-data-columns.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,KAAK,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,SAAS,GAAG,UAAU,GAAG,iBAAiB,GACvE,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GACnD,YAAY,GAAG,YAAY,CAAC;AAEhC;;GAEG;AACH,KAAK,WAAW,GACZ;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;CAAE,GACtD;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE1C;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAQxD"}

package/dist/src/util/to-data-columns.js

@@ -0,0 +1,51 @@
+import { isArrowTable } from './is-arrow-table.js';
+/**
+ * Convert input data to a set of column arrays.
+ * @param data The input data.
+ * @returns An object with named column arrays.
+ */
+export function toDataColumns(data) {
+    if (isArrowTable(data)) {
+        return arrowToColumns(data);
+    }
+    else if (Array.isArray(data)) {
+        return arrayToColumns(data);
+    }
+    else {
+        throw new Error('Unrecognized data format.');
+    }
+}
+/**
+ * Convert an Arrow table to a set of column arrays.
+ * @param data An Arrow Table.
+ * @returns An object with named column arrays.
+ */
+function arrowToColumns(data) {
+    const { numRows } = data;
+    return { numRows, columns: data.toColumns() };
+}
+/**
+ * Convert an array of values to a set of column arrays.
+ * If the array values are objects, build out named columns.
+ * We use the keys of the first object as the column names.
+ * Otherwise, use a special "values" array.
+ * @param data An array of data objects.
+ * @returns An object with named column arrays.
+ */
+function arrayToColumns(data) {
+    const numRows = data.length;
+    if (typeof data[0] === 'object') {
+        const names = numRows ? Object.keys(data[0]) : [];
+        const columns = {};
+        if (names.length > 0) {
+            names.forEach(name => {
+                columns[name] = data.map(d => d[name]);
+            });
+        }
+        return { numRows, columns };
+    }
+    else {
+        return { numRows, values: data };
+    }
+}
+//# sourceMappingURL=to-data-columns.js.map

package/dist/src/util/to-data-columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-data-columns.js","sourceRoot":"","sources":["../../../src/util/to-data-columns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAiBnD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,IAAW;IACjC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAA8B,EAAE,CAAC;AAC5E,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,cAAc,CAAC,IAA8B;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5B,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,MAAM,OAAO,GAA8B,EAAE,CAAC;QAC9C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;gBACnB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/src/util/void-logger.d.ts

@@ -0,0 +1,13 @@
+interface Logger {
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    log(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    group(label?: string): void;
+    groupCollapsed(label?: string): void;
+    groupEnd(): void;
+}
+export declare function voidLogger(): Logger;
+export {};
+//# sourceMappingURL=void-logger.d.ts.map

package/dist/src/util/void-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"void-logger.d.ts","sourceRoot":"","sources":["../../../src/util/void-logger.ts"],"names":[],"mappings":"AAAA,UAAU,MAAM;IACd,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,wBAAgB,UAAU,IAAI,MAAM,CAWnC"}

package/dist/src/util/void-logger.js

@@ -0,0 +1,13 @@
+export function voidLogger() {
+    return {
+        debug() { },
+        info() { },
+        log() { },
+        warn() { },
+        error() { },
+        group() { },
+        groupCollapsed() { },
+        groupEnd() { }
+    };
+}
+//# sourceMappingURL=void-logger.js.map

package/dist/src/util/void-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"void-logger.js","sourceRoot":"","sources":["../../../src/util/void-logger.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,KAAK,KAAU,CAAC;QAChB,IAAI,KAAU,CAAC;QACf,GAAG,KAAU,CAAC;QACd,IAAI,KAAU,CAAC;QACf,KAAK,KAAU,CAAC;QAChB,KAAK,KAAU,CAAC;QAChB,cAAc,KAAU,CAAC;QACzB,QAAQ,KAAU,CAAC;KACpB,CAAC;AACJ,CAAC"}