rowpipe 2.1.0 → 2.2.0

package/dist/transforms/window.js

@@ -0,0 +1,317 @@
+import { encodeCompositeKey } from "../diff/key.js";
+import { InvalidArgumentError } from "../core/errors.js";
+/**
+ * Parses user window function specifications (e.g. "rn=row_number()", "lag(revenue, 1, 0)", "moving_avg(rev, 7)").
+ */
+export function parseWindowSpecs(input) {
+    if (Array.isArray(input)) {
+        const parsed = [];
+        for (const item of input) {
+            if (typeof item === "object") {
+                parsed.push(item);
+                continue;
+            }
+            const eqIdx = item.indexOf("=");
+            if (eqIdx <= 0) {
+                throw new InvalidArgumentError(`Invalid window spec: "${item}". Expected format: output_col=fn(...)`);
+            }
+            const outCol = item.slice(0, eqIdx).trim();
+            const expr = item.slice(eqIdx + 1).trim();
+            parsed.push(parseSingleWindowExpr(outCol, expr));
+        }
+        return parsed;
+    }
+    const parsed = [];
+    for (const [outCol, expr] of Object.entries(input)) {
+        parsed.push(parseSingleWindowExpr(outCol, expr));
+    }
+    return parsed;
+}
+function parseSingleWindowExpr(outputCol, expr) {
+    const match = /^([a-zA-Z0-9_]+)\s*\((.*)\)$/.exec(expr.trim());
+    if (!match) {
+        throw new InvalidArgumentError(`Invalid window function syntax: "${expr}"`);
+    }
+    const fnName = match[1].toLowerCase();
+    const args = match[2]
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    switch (fnName) {
+        case "row_number":
+        case "rank":
+        case "dense_rank":
+        case "running_count":
+            return { outputCol, fn: fnName };
+        case "lag": {
+            const sourceCol = args[0];
+            if (!sourceCol)
+                throw new InvalidArgumentError(`lag() requires source column`);
+            const offset = args[1] ? Number.parseInt(args[1], 10) : 1;
+            const defaultValue = args[2] !== undefined ? JSON.parse(args[2]) : null;
+            return { outputCol, fn: "lag", sourceCol, offset, defaultValue };
+        }
+        case "lead": {
+            const sourceCol = args[0];
+            if (!sourceCol)
+                throw new InvalidArgumentError(`lead() requires source column`);
+            const offset = args[1] ? Number.parseInt(args[1], 10) : 1;
+            const defaultValue = args[2] !== undefined ? JSON.parse(args[2]) : null;
+            return { outputCol, fn: "lead", sourceCol, offset, defaultValue };
+        }
+        case "running_sum":
+        case "running_avg":
+        case "running_min":
+        case "running_max": {
+            const sourceCol = args[0];
+            if (!sourceCol)
+                throw new InvalidArgumentError(`${fnName}() requires source column`);
+            return { outputCol, fn: fnName, sourceCol };
+        }
+        case "moving_sum":
+        case "moving_avg":
+        case "moving_min":
+        case "moving_max": {
+            const sourceCol = args[0];
+            if (!sourceCol)
+                throw new InvalidArgumentError(`${fnName}() requires source column`);
+            const windowSize = args[1] ? Number.parseInt(args[1], 10) : 5;
+            return { outputCol, fn: fnName, sourceCol, windowSize };
+        }
+        default:
+            throw new InvalidArgumentError(`Unknown window function: "${fnName}"`);
+    }
+}
+function createPartitionState() {
+    return {
+        rowCount: 0,
+        lagBuffers: new Map(),
+        movingBuffers: new Map(),
+        runningSums: new Map(),
+        runningCounts: new Map(),
+        runningMins: new Map(),
+        runningMaxs: new Map(),
+    };
+}
+/**
+ * Streaming Window / Rolling Function Transform.
+ * Operates over sliding ring buffers and running accumulators with bounded O(W) / O(1) memory.
+ */
+export function windowRows(options) {
+    const specs = parseWindowSpecs(options.specs);
+    const byCols = options.by
+        ? Array.isArray(options.by)
+            ? options.by
+            : options.by.split(",").map((s) => s.trim()).filter(Boolean)
+        : undefined;
+    const effectiveBatchSize = Math.max(1, options.batchSize || 1000);
+    // Determine maximum lookahead needed for lead()
+    let maxLeadOffset = 0;
+    for (const s of specs) {
+        if (s.fn === "lead" && s.offset && s.offset > maxLeadOffset) {
+            maxLeadOffset = s.offset;
+        }
+    }
+    return (stream) => {
+        return (async function* () {
+            const partitions = new Map();
+            let currentBatch = [];
+            let globalOffset = 0;
+            // Lookahead buffer for lead() calculations: array of { rawRow, partitionKey }
+            const lookaheadQueue = [];
+            function getPartitionKey(row) {
+                if (!byCols || byCols.length === 0)
+                    return "__global__";
+                return encodeCompositeKey(row, byCols).encoded;
+            }
+            function processRow(row, partitionKey, lookaheadItems) {
+                let state = partitions.get(partitionKey);
+                if (!state) {
+                    state = createPartitionState();
+                    partitions.set(partitionKey, state);
+                }
+                state.rowCount++;
+                const enrichedRow = { ...row };
+                for (const spec of specs) {
+                    switch (spec.fn) {
+                        case "row_number":
+                        case "rank":
+                        case "dense_rank":
+                            enrichedRow[spec.outputCol] = state.rowCount;
+                            break;
+                        case "running_count":
+                            enrichedRow[spec.outputCol] = state.rowCount;
+                            break;
+                        case "lag": {
+                            const src = spec.sourceCol;
+                            const offset = spec.offset || 1;
+                            let lagBuf = state.lagBuffers.get(spec.outputCol);
+                            if (!lagBuf) {
+                                lagBuf = [];
+                                state.lagBuffers.set(spec.outputCol, lagBuf);
+                            }
+                            if (lagBuf.length >= offset) {
+                                enrichedRow[spec.outputCol] = lagBuf[lagBuf.length - offset];
+                            }
+                            else {
+                                enrichedRow[spec.outputCol] = spec.defaultValue !== undefined ? spec.defaultValue : null;
+                            }
+                            lagBuf.push(row[src]);
+                            if (lagBuf.length > offset * 2) {
+                                lagBuf.splice(0, lagBuf.length - offset);
+                            }
+                            break;
+                        }
+                        case "lead": {
+                            const src = spec.sourceCol;
+                            const offset = spec.offset || 1;
+                            // Find matching partition lookahead item
+                            let matchIdx = -1;
+                            let matchCount = 0;
+                            for (let i = 0; i < lookaheadItems.length; i++) {
+                                if (lookaheadItems[i].partitionKey === partitionKey) {
+                                    matchCount++;
+                                    if (matchCount === offset) {
+                                        matchIdx = i;
+                                        break;
+                                    }
+                                }
+                            }
+                            if (matchIdx >= 0) {
+                                enrichedRow[spec.outputCol] = lookaheadItems[matchIdx].row[src];
+                            }
+                            else {
+                                enrichedRow[spec.outputCol] = spec.defaultValue !== undefined ? spec.defaultValue : null;
+                            }
+                            break;
+                        }
+                        case "running_sum": {
+                            const src = spec.sourceCol;
+                            const val = Number(row[src]) || 0;
+                            const current = (state.runningSums.get(spec.outputCol) || 0) + val;
+                            state.runningSums.set(spec.outputCol, current);
+                            enrichedRow[spec.outputCol] = current;
+                            break;
+                        }
+                        case "running_avg": {
+                            const src = spec.sourceCol;
+                            const val = Number(row[src]) || 0;
+                            const currentSum = (state.runningSums.get(spec.outputCol) || 0) + val;
+                            const count = (state.runningCounts.get(spec.outputCol) || 0) + 1;
+                            state.runningSums.set(spec.outputCol, currentSum);
+                            state.runningCounts.set(spec.outputCol, count);
+                            enrichedRow[spec.outputCol] = count > 0 ? currentSum / count : 0;
+                            break;
+                        }
+                        case "running_min": {
+                            const src = spec.sourceCol;
+                            const val = Number(row[src]);
+                            if (!Number.isNaN(val)) {
+                                const currentMin = state.runningMins.get(spec.outputCol);
+                                const newMin = currentMin !== undefined ? Math.min(currentMin, val) : val;
+                                state.runningMins.set(spec.outputCol, newMin);
+                                enrichedRow[spec.outputCol] = newMin;
+                            }
+                            else {
+                                enrichedRow[spec.outputCol] = null;
+                            }
+                            break;
+                        }
+                        case "running_max": {
+                            const src = spec.sourceCol;
+                            const val = Number(row[src]);
+                            if (!Number.isNaN(val)) {
+                                const currentMax = state.runningMaxs.get(spec.outputCol);
+                                const newMax = currentMax !== undefined ? Math.max(currentMax, val) : val;
+                                state.runningMaxs.set(spec.outputCol, newMax);
+                                enrichedRow[spec.outputCol] = newMax;
+                            }
+                            else {
+                                enrichedRow[spec.outputCol] = null;
+                            }
+                            break;
+                        }
+                        case "moving_sum":
+                        case "moving_avg":
+                        case "moving_min":
+                        case "moving_max": {
+                            const src = spec.sourceCol;
+                            const wSize = Math.max(1, spec.windowSize || 5);
+                            let buf = state.movingBuffers.get(spec.outputCol);
+                            if (!buf) {
+                                buf = [];
+                                state.movingBuffers.set(spec.outputCol, buf);
+                            }
+                            const val = Number(row[src]) || 0;
+                            buf.push(val);
+                            if (buf.length > wSize) {
+                                buf.shift();
+                            }
+                            if (spec.fn === "moving_sum") {
+                                enrichedRow[spec.outputCol] = buf.reduce((a, b) => a + b, 0);
+                            }
+                            else if (spec.fn === "moving_avg") {
+                                enrichedRow[spec.outputCol] = buf.reduce((a, b) => a + b, 0) / buf.length;
+                            }
+                            else if (spec.fn === "moving_min") {
+                                enrichedRow[spec.outputCol] = Math.min(...buf);
+                            }
+                            else if (spec.fn === "moving_max") {
+                                enrichedRow[spec.outputCol] = Math.max(...buf);
+                            }
+                            break;
+                        }
+                    }
+                }
+                return enrichedRow;
+            }
+            for await (const batch of stream) {
+                for (const row of batch.rows) {
+                    const partitionKey = getPartitionKey(row);
+                    if (maxLeadOffset > 0) {
+                        lookaheadQueue.push({ row, partitionKey });
+                        if (lookaheadQueue.length > maxLeadOffset) {
+                            const target = lookaheadQueue.shift();
+                            const enriched = processRow(target.row, target.partitionKey, lookaheadQueue);
+                            currentBatch.push(enriched);
+                        }
+                    }
+                    else {
+                        const enriched = processRow(row, partitionKey, []);
+                        currentBatch.push(enriched);
+                    }
+                    if (currentBatch.length >= effectiveBatchSize) {
+                        yield {
+                            rows: currentBatch,
+                            offset: globalOffset,
+                        };
+                        globalOffset += currentBatch.length;
+                        currentBatch = [];
+                    }
+                }
+            }
+            // Drain remaining items from lookaheadQueue
+            while (lookaheadQueue.length > 0) {
+                const target = lookaheadQueue.shift();
+                const enriched = processRow(target.row, target.partitionKey, lookaheadQueue);
+                currentBatch.push(enriched);
+                if (currentBatch.length >= effectiveBatchSize) {
+                    yield {
+                        rows: currentBatch,
+                        offset: globalOffset,
+                    };
+                    globalOffset += currentBatch.length;
+                    currentBatch = [];
+                }
+            }
+            if (currentBatch.length > 0) {
+                yield {
+                    rows: currentBatch,
+                    offset: globalOffset,
+                };
+                globalOffset += currentBatch.length;
+            }
+        })();
+    };
+}
+//# sourceMappingURL=window.js.map

package/dist/transforms/window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.js","sourceRoot":"","sources":["../../src/transforms/window.ts"],"names":[],"mappings":"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"}

package/dist/ui/colors.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Lightweight ANSI color and styling utilities for terminal UI rendering.
+ */
+export declare const ANSI: {
+    reset: string;
+    bold: string;
+    dim: string;
+    italic: string;
+    underline: string;
+    inverse: string;
+    hidden: string;
+    black: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    gray: string;
+    bgBlack: string;
+    bgRed: string;
+    bgGreen: string;
+    bgYellow: string;
+    bgBlue: string;
+    bgMagenta: string;
+    bgCyan: string;
+    bgWhite: string;
+    bgGray: string;
+    enterAltScreen: string;
+    exitAltScreen: string;
+    hideCursor: string;
+    showCursor: string;
+    clearScreen: string;
+    cursorHome: string;
+    clearLine: string;
+};
+export declare function bold(text: string): string;
+export declare function dim(text: string): string;
+export declare function cyan(text: string): string;
+export declare function yellow(text: string): string;
+export declare function green(text: string): string;
+export declare function magenta(text: string): string;
+export declare function red(text: string): string;
+export declare function gray(text: string): string;
+export declare function inverse(text: string): string;
+export declare function bgBlue(text: string): string;
+export declare function bgGray(text: string): string;
+/**
+ * Strips ANSI escape sequences from a string to measure its visible character length.
+ */
+export declare function stripAnsi(str: string): string;
+/**
+ * Truncates string to a max visible width, adding an ellipsis if needed.
+ */
+export declare function truncateVisible(str: string, maxWidth: number): string;
+//# sourceMappingURL=colors.d.ts.map

package/dist/ui/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/ui/colors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuChB,CAAC;AAEF,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMrE"}

package/dist/ui/colors.js

@@ -0,0 +1,94 @@
+/**
+ * Lightweight ANSI color and styling utilities for terminal UI rendering.
+ */
+export const ANSI = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    italic: "\x1b[3m",
+    underline: "\x1b[4m",
+    inverse: "\x1b[7m",
+    hidden: "\x1b[8m",
+    // Foreground colors
+    black: "\x1b[30m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    magenta: "\x1b[35m",
+    cyan: "\x1b[36m",
+    white: "\x1b[37m",
+    gray: "\x1b[90m",
+    // Background colors
+    bgBlack: "\x1b[40m",
+    bgRed: "\x1b[41m",
+    bgGreen: "\x1b[42m",
+    bgYellow: "\x1b[43m",
+    bgBlue: "\x1b[44m",
+    bgMagenta: "\x1b[45m",
+    bgCyan: "\x1b[46m",
+    bgWhite: "\x1b[47m",
+    bgGray: "\x1b[100m",
+    // Screen / cursor controls
+    enterAltScreen: "\x1b[?1049h",
+    exitAltScreen: "\x1b[?1049l",
+    hideCursor: "\x1b[?25l",
+    showCursor: "\x1b[?25h",
+    clearScreen: "\x1b[2J",
+    cursorHome: "\x1b[H",
+    clearLine: "\x1b[2K",
+};
+export function bold(text) {
+    return `${ANSI.bold}${text}${ANSI.reset}`;
+}
+export function dim(text) {
+    return `${ANSI.dim}${text}${ANSI.reset}`;
+}
+export function cyan(text) {
+    return `${ANSI.cyan}${text}${ANSI.reset}`;
+}
+export function yellow(text) {
+    return `${ANSI.yellow}${text}${ANSI.reset}`;
+}
+export function green(text) {
+    return `${ANSI.green}${text}${ANSI.reset}`;
+}
+export function magenta(text) {
+    return `${ANSI.magenta}${text}${ANSI.reset}`;
+}
+export function red(text) {
+    return `${ANSI.red}${text}${ANSI.reset}`;
+}
+export function gray(text) {
+    return `${ANSI.gray}${text}${ANSI.reset}`;
+}
+export function inverse(text) {
+    return `${ANSI.inverse}${text}${ANSI.reset}`;
+}
+export function bgBlue(text) {
+    return `${ANSI.bgBlue}${ANSI.white}${text}${ANSI.reset}`;
+}
+export function bgGray(text) {
+    return `${ANSI.bgGray}${ANSI.white}${text}${ANSI.reset}`;
+}
+/**
+ * Strips ANSI escape sequences from a string to measure its visible character length.
+ */
+export function stripAnsi(str) {
+    // eslint-disable-next-line no-control-regex
+    return str.replace(/\x1b\[[0-9;]*m/g, "").replace(/\x1b\[\?[0-9]+[hl]/g, "");
+}
+/**
+ * Truncates string to a max visible width, adding an ellipsis if needed.
+ */
+export function truncateVisible(str, maxWidth) {
+    if (maxWidth <= 0)
+        return "";
+    const plain = stripAnsi(str);
+    if (plain.length <= maxWidth)
+        return str;
+    if (maxWidth <= 3)
+        return plain.slice(0, maxWidth);
+    return `${plain.slice(0, maxWidth - 1)}…`;
+}
+//# sourceMappingURL=colors.js.map

package/dist/ui/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/ui/colors.ts"],"names":[],"mappings":"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"}

package/dist/ui/viewer.d.ts

@@ -0,0 +1,67 @@
+import type { DataStream, TabularReader } from "../core/types.js";
+export interface TerminalViewerOptions {
+    title?: string;
+    filePath?: string;
+    maxBufferRows?: number;
+    initialRows?: number;
+    interactive?: boolean;
+}
+/**
+ * Interactive Terminal Data Viewer for streaming tabular datasets.
+ * Features bounded memory sliding windows, keyboard navigation, column browsing,
+ * live in-memory searching, sorting, and seamless terminal restoration.
+ */
+export declare class TerminalViewer {
+    private streamIterator;
+    private isStreamExhausted;
+    private loadedRows;
+    private columns;
+    private options;
+    private cursorRow;
+    private scrollRow;
+    private cursorCol;
+    private scrollCol;
+    private mode;
+    private searchQuery;
+    private searchInput;
+    private jumpInput;
+    private matchingRowIndices;
+    private activeMatchIndex;
+    private sortColumn;
+    private sortAsc;
+    private sortedRowIndices;
+    private autoFitCols;
+    private termRows;
+    private termCols;
+    private isRunning;
+    private stdinRawSet;
+    constructor(source: DataStream | TabularReader, options?: TerminalViewerOptions);
+    /**
+     * Loads at least `targetCount` rows into memory buffer from stream.
+     */
+    loadRows(targetCount: number): Promise<void>;
+    /**
+     * Starts the interactive terminal viewer loop.
+     */
+    run(): Promise<void>;
+    private exitCleanup?;
+    private exit;
+    private updateDimensions;
+    private getEffectiveRowIndices;
+    private applySearch;
+    private applySort;
+    private handleInput;
+    private adjustScroll;
+    private getVisibleDataRowCount;
+    private calculateColumnWidths;
+    /**
+     * Main rendering routine that constructs and prints a single terminal frame.
+     */
+    render(): void;
+    private drawHelpModal;
+    /**
+     * Non-interactive fallback printer for scripts, CI, and non-TTY pipes.
+     */
+    renderNonInteractive(maxRows?: number): void;
+}
+//# sourceMappingURL=viewer.d.ts.map

package/dist/ui/viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../src/ui/viewer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,UAAU,EAAO,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAmBlF,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAwB;IAGvC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAK;IAGtB,OAAO,CAAC,IAAI,CAAmD;IAC/D,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,kBAAkB,CAAyB;IACnD,OAAO,CAAC,gBAAgB,CAAM;IAG9B,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,gBAAgB,CAAyB;IAGjD,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;gBAG1B,MAAM,EAAE,UAAU,GAAG,aAAa,EAClC,OAAO,GAAE,qBAA0B;IAgBrC;;OAEG;IACU,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBzD;;OAEG;IACU,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA6DjC,OAAO,CAAC,WAAW,CAAC,CAAa;IAEjC,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,WAAW;IA2BnB,OAAO,CAAC,SAAS;YA4CH,WAAW;IAkNzB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,qBAAqB;IA8B7B;;OAEG;IACI,MAAM,IAAI,IAAI;IAiKrB,OAAO,CAAC,aAAa;IAyCrB;;OAEG;IACI,oBAAoB,CAAC,OAAO,SAAK,GAAG,IAAI;CAqChD"}