@moxon/api 6.0.0-pre

package/dist/modules/v5/csv.js

@@ -0,0 +1,143 @@
+import { MAX_CSV_LENGTH, MAX_CSV_ROWS } from '../../constants.js';
+/**
+ * Parses a full CSV text into rows of fields, respecting quoted fields
+ * (including escaped quotes and newlines inside quotes).
+ *
+ * @param text - Raw CSV text; CRLF and CR line endings are normalized to LF
+ * @param delimiter - Field separator, a single character
+ * @returns Array of rows, each row being an array of field values
+ */
+function parseRows(text, delimiter) {
+    const src = text.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    const rows = [];
+    let fields = [];
+    let value = '';
+    let inQuotes = false;
+    let fieldStarted = false;
+    const endField = () => {
+        fields.push(value);
+        value = '';
+        fieldStarted = false;
+    };
+    const endRow = () => {
+        if (fields.length > 0 || value !== '' || fieldStarted) {
+            endField();
+            rows.push(fields);
+        }
+        fields = [];
+    };
+    let i = 0;
+    while (i < src.length) {
+        const ch = src[i];
+        if (inQuotes) {
+            if (ch === '"') {
+                if (src[i + 1] === '"') {
+                    value += '"';
+                    i += 2;
+                    continue;
+                }
+                inQuotes = false;
+                i++;
+                continue;
+            }
+            value += ch;
+            i++;
+            continue;
+        }
+        if (ch === '"' && value === '') {
+            inQuotes = true;
+            fieldStarted = true;
+            i++;
+            continue;
+        }
+        if (ch === delimiter) {
+            endField();
+            fieldStarted = true;
+            i++;
+            continue;
+        }
+        if (ch === '\n') {
+            endRow();
+            i++;
+            continue;
+        }
+        value += ch;
+        i++;
+    }
+    endRow();
+    return rows;
+}
+/**
+ * Escapes a value for CSV output. Wraps in quotes if it contains the delimiter, quotes, or newlines.
+ *
+ * @param value - Field value to escape
+ * @param delimiter - Field separator used in the output
+ * @returns The value, quoted with inner quotes doubled when escaping is needed
+ */
+function escapeField(value, delimiter) {
+    if (value.includes(delimiter) || value.includes('"') || value.includes('\n')) {
+        return '"' + value.replace(/"/g, '""') + '"';
+    }
+    return value;
+}
+/**
+ * Converts between CSV and JSON.
+ * - `parse`: CSV string → array of objects
+ * - `format`: array of objects → CSV string
+ *
+ * @param action - "parse" or "format"
+ * @param data - Input payload: `csv` string for parse, `json` array of objects for format
+ * @param options - `delimiter` (single character, default ",") and `headers` (parse only: use the first row as keys, default true)
+ * @returns Parse result with the rows and their count, or format result with the CSV string and the row count
+ * @throws Error if the action is invalid, the delimiter is not a single character, the input data is missing, or a size limit is exceeded
+ */
+export default function csv(action, data, options = {}) {
+    if (!action || (action !== 'parse' && action !== 'format'))
+        throw new Error('Please provide a valid action (?action=parse|format)');
+    const delimiter = options.delimiter ?? ',';
+    if (delimiter.length !== 1)
+        throw new Error('Delimiter must be a single character');
+    if (action === 'parse') {
+        const text = data.csv;
+        if (!text)
+            throw new Error('Please provide CSV data (?csv={data})');
+        if (text.length > MAX_CSV_LENGTH)
+            throw new Error(`CSV cannot exceed ${MAX_CSV_LENGTH} characters`);
+        const useHeaders = options.headers !== false;
+        const allRows = parseRows(text, delimiter);
+        if (allRows.length === 0)
+            return { action: 'parse', rows: [], count: 0 };
+        let headers;
+        let dataRows;
+        if (useHeaders) {
+            headers = allRows[0];
+            dataRows = allRows.slice(1);
+        }
+        else {
+            headers = allRows[0].map((_, i) => String(i));
+            dataRows = allRows;
+        }
+        if (dataRows.length > MAX_CSV_ROWS)
+            throw new Error(`CSV cannot exceed ${MAX_CSV_ROWS} rows`);
+        const rows = dataRows.map((fields) => {
+            const row = {};
+            for (let i = 0; i < headers.length; i++) {
+                row[headers[i]] = fields[i] ?? '';
+            }
+            return row;
+        });
+        return { action: 'parse', rows, count: rows.length };
+    }
+    // action === 'format'
+    const json = data.json;
+    if (!json || !Array.isArray(json) || json.length === 0)
+        throw new Error('Please provide a JSON array (?json=[...])');
+    if (json.length > MAX_CSV_ROWS)
+        throw new Error(`JSON cannot exceed ${MAX_CSV_ROWS} rows`);
+    const headers = Object.keys(json[0]);
+    const headerLine = headers.map((h) => escapeField(h, delimiter)).join(delimiter);
+    const dataLines = json.map((obj) => headers.map((h) => escapeField(String(obj[h] ?? ''), delimiter)).join(delimiter));
+    const csvOutput = headerLine + '\n' + dataLines.join('\n');
+    return { action: 'format', csv: csvOutput, count: json.length };
+}
+//# sourceMappingURL=csv.js.map

package/dist/modules/v5/csv.js.map

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

package/dist/modules/v5/diff.d.ts

@@ -0,0 +1,20 @@
+export interface DiffChange {
+    type: 'equal' | 'add' | 'del';
+    value: string;
+}
+export interface DiffResult {
+    mode: string;
+    added: number;
+    removed: number;
+    changes: DiffChange[];
+}
+/**
+ * Compares two texts and returns a structured diff using the LCS algorithm.
+ *
+ * @param a - Original text
+ * @param b - Modified text
+ * @param mode - Granularity: line (default) or word
+ * @returns Diff result with the change list and added/removed counts
+ * @throws Error if a text is missing or too long, or if the mode is invalid
+ */
+export default function diff(a: string, b: string, mode?: string): DiffResult;

package/dist/modules/v5/diff.js

@@ -0,0 +1,81 @@
+import { MAX_DIFF_LENGTH, MAX_DIFF_PARTS } from '../../constants.js';
+const VALID_MODES = ['line', 'word'];
+function split(text, mode) {
+    if (mode === 'line')
+        return text.split('\n');
+    return text.split(/\s+/).filter((w) => w.length > 0);
+}
+function lcs(a, b) {
+    const m = a.length;
+    const n = b.length;
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            if (a[i - 1] === b[j - 1]) {
+                dp[i][j] = dp[i - 1][j - 1] + 1;
+            }
+            else {
+                dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);
+            }
+        }
+    }
+    return dp;
+}
+function buildChanges(a, b, dp) {
+    const changes = [];
+    let i = a.length;
+    let j = b.length;
+    while (i > 0 || j > 0) {
+        if (i > 0 && j > 0 && a[i - 1] === b[j - 1]) {
+            changes.push({ type: 'equal', value: a[i - 1] });
+            i--;
+            j--;
+        }
+        else if (j > 0 && (i === 0 || dp[i][j - 1] >= dp[i - 1][j])) {
+            changes.push({ type: 'add', value: b[j - 1] });
+            j--;
+        }
+        else {
+            changes.push({ type: 'del', value: a[i - 1] });
+            i--;
+        }
+    }
+    return changes.reverse();
+}
+/**
+ * Compares two texts and returns a structured diff using the LCS algorithm.
+ *
+ * @param a - Original text
+ * @param b - Modified text
+ * @param mode - Granularity: line (default) or word
+ * @returns Diff result with the change list and added/removed counts
+ * @throws Error if a text is missing or too long, or if the mode is invalid
+ */
+export default function diff(a, b, mode = 'line') {
+    if (typeof a !== 'string')
+        throw new Error('Please provide a first text (a={text})');
+    if (typeof b !== 'string')
+        throw new Error('Please provide a second text (b={text})');
+    if (a.length > MAX_DIFF_LENGTH)
+        throw new Error(`Texts must be ${MAX_DIFF_LENGTH} characters or fewer`);
+    if (b.length > MAX_DIFF_LENGTH)
+        throw new Error(`Texts must be ${MAX_DIFF_LENGTH} characters or fewer`);
+    if (!VALID_MODES.includes(mode))
+        throw new Error(`Mode must be one of: ${VALID_MODES.join(', ')}`);
+    const left = split(a, mode);
+    const right = split(b, mode);
+    if (left.length > MAX_DIFF_PARTS || right.length > MAX_DIFF_PARTS) {
+        throw new Error(`Texts must contain ${MAX_DIFF_PARTS} ${mode}s or fewer`);
+    }
+    const changes = buildChanges(left, right, lcs(left, right));
+    let added = 0;
+    let removed = 0;
+    for (const change of changes) {
+        if (change.type === 'add')
+            added++;
+        else if (change.type === 'del')
+            removed++;
+    }
+    return { mode, added, removed, changes };
+}
+//# sourceMappingURL=diff.js.map

package/dist/modules/v5/diff.js.map

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

package/dist/modules/v5/evaluate.d.ts

@@ -0,0 +1,14 @@
+export interface EvaluateResult {
+    expression: string;
+    result: number;
+    precision: number;
+}
+/**
+ * Evaluates a mathematical expression string and returns the result.
+ *
+ * @param expr - Math expression; supports +, -, *, /, %, ^, unary -, parentheses, constants (pi, e) and functions (sin, cos, tan, sqrt, abs, ceil, floor, round, log, log2, log10, exp, min, max)
+ * @param precision - Number of decimal places in the result (0–15, default 10)
+ * @returns Object with the original expression, numeric result, and applied precision
+ * @throws Error if the expression is empty, exceeds the maximum length, contains unknown identifiers, or produces a non-finite result
+ */
+export default function evaluate(expr: string, precision?: number): EvaluateResult;

package/dist/modules/v5/evaluate.js

@@ -0,0 +1,284 @@
+import { MAX_EXPR_DEPTH, MAX_EXPR_LENGTH } from '../../constants.js';
+function tokenize(expr) {
+    const tokens = [];
+    let i = 0;
+    while (i < expr.length) {
+        const ch = expr[i];
+        if (' \t\r\n'.includes(ch)) {
+            i++;
+            continue;
+        }
+        if ((ch >= '0' && ch <= '9') || ch === '.') {
+            let num = '';
+            let dots = 0;
+            while (i < expr.length && ((expr[i] >= '0' && expr[i] <= '9') || expr[i] === '.')) {
+                if (expr[i] === '.')
+                    dots++;
+                num += expr[i++];
+            }
+            if (dots > 1)
+                throw new Error(`Invalid number: ${num}`);
+            tokens.push({ type: 'NUMBER', value: num });
+            continue;
+        }
+        if ((ch >= 'a' && ch <= 'z') || (ch >= 'A' && ch <= 'Z') || ch === '_') {
+            let ident = '';
+            while (i < expr.length &&
+                ((expr[i] >= 'a' && expr[i] <= 'z') ||
+                    (expr[i] >= 'A' && expr[i] <= 'Z') ||
+                    expr[i] === '_' ||
+                    (expr[i] >= '0' && expr[i] <= '9'))) {
+                ident += expr[i++];
+            }
+            tokens.push({ type: 'IDENT', value: ident });
+            continue;
+        }
+        if ('+-*/%^'.includes(ch)) {
+            tokens.push({ type: 'OP', value: ch });
+            i++;
+            continue;
+        }
+        if (ch === '(') {
+            tokens.push({ type: 'LPAREN', value: '(' });
+            i++;
+            continue;
+        }
+        if (ch === ')') {
+            tokens.push({ type: 'RPAREN', value: ')' });
+            i++;
+            continue;
+        }
+        if (ch === ',') {
+            tokens.push({ type: 'COMMA', value: ',' });
+            i++;
+            continue;
+        }
+        throw new Error(`Unexpected character: '${ch}'`);
+    }
+    return tokens;
+}
+const LEFT_BP = { '+': 10, '-': 10, '*': 20, '/': 20, '%': 20, '^': 31 };
+const RIGHT_BP = { '+': 10, '-': 10, '*': 20, '/': 20, '%': 20, '^': 30 };
+const UNARY_BP = 30;
+const CONSTANTS = { pi: Math.PI, e: Math.E };
+const FUNCTIONS = new Set([
+    'sqrt',
+    'abs',
+    'ceil',
+    'floor',
+    'round',
+    'sin',
+    'cos',
+    'tan',
+    'log',
+    'log2',
+    'log10',
+    'exp',
+    'min',
+    'max',
+]);
+class Parser {
+    tokens;
+    pos = 0;
+    depth = 0;
+    constructor(tokens) {
+        this.tokens = tokens;
+    }
+    peek() {
+        return this.tokens[this.pos];
+    }
+    consume() {
+        const t = this.tokens[this.pos];
+        if (!t)
+            throw new Error('Unexpected end of expression');
+        this.pos++;
+        return t;
+    }
+    expect(type) {
+        const t = this.consume();
+        if (t.type !== type)
+            throw new Error(`Expected ${type}, got ${t.type} ('${t.value}')`);
+        return t;
+    }
+    parse(minBp = 0) {
+        if (++this.depth > MAX_EXPR_DEPTH)
+            throw new Error('Expression is too deeply nested');
+        let left = this.parsePrefix();
+        while (true) {
+            const t = this.peek();
+            if (!t || t.type !== 'OP')
+                break;
+            const lbp = LEFT_BP[t.value];
+            if (lbp === undefined || lbp <= minBp)
+                break;
+            this.consume();
+            const rbp = RIGHT_BP[t.value];
+            const right = this.parse(rbp);
+            left = { kind: 'binary', op: t.value, left, right };
+        }
+        this.depth--;
+        return left;
+    }
+    parsePrefix() {
+        const t = this.peek();
+        if (!t)
+            throw new Error('Unexpected end of expression');
+        // Unary +/-
+        if (t.type === 'OP' && (t.value === '+' || t.value === '-')) {
+            this.consume();
+            const operand = this.parse(UNARY_BP);
+            if (t.value === '+')
+                return operand;
+            return { kind: 'unary', op: '-', operand };
+        }
+        // Number
+        if (t.type === 'NUMBER') {
+            this.consume();
+            const v = parseFloat(t.value);
+            if (isNaN(v))
+                throw new Error(`Invalid number: ${t.value}`);
+            return { kind: 'number', value: v };
+        }
+        // Parenthesized expression
+        if (t.type === 'LPAREN') {
+            this.consume();
+            const node = this.parse(0);
+            this.expect('RPAREN');
+            return node;
+        }
+        // Identifier: constant or function call
+        if (t.type === 'IDENT') {
+            this.consume();
+            const name = t.value;
+            // Function call
+            if (this.peek()?.type === 'LPAREN') {
+                if (!FUNCTIONS.has(name))
+                    throw new Error(`Unknown function: '${name}'`);
+                this.consume(); // (
+                const args = [];
+                if (this.peek()?.type !== 'RPAREN') {
+                    args.push(this.parse(0));
+                    while (this.peek()?.type === 'COMMA') {
+                        this.consume();
+                        args.push(this.parse(0));
+                    }
+                }
+                this.expect('RPAREN');
+                return { kind: 'call', name, args };
+            }
+            // Constant
+            if (Object.hasOwn(CONSTANTS, name))
+                return { kind: 'const', name };
+            throw new Error(`Unknown identifier: '${name}'`);
+        }
+        throw new Error(`Unexpected token: '${t.value}'`);
+    }
+    run() {
+        const ast = this.parse(0);
+        if (this.pos < this.tokens.length) {
+            throw new Error(`Unexpected token after expression: '${this.tokens[this.pos].value}'`);
+        }
+        return ast;
+    }
+}
+function evalNode(node) {
+    switch (node.kind) {
+        case 'number':
+            return node.value;
+        case 'const':
+            return CONSTANTS[node.name];
+        case 'unary':
+            return -evalNode(node.operand);
+        case 'binary': {
+            const l = evalNode(node.left);
+            const r = evalNode(node.right);
+            switch (node.op) {
+                case '+':
+                    return l + r;
+                case '-':
+                    return l - r;
+                case '*':
+                    return l * r;
+                case '/':
+                    if (r === 0)
+                        throw new Error('Division by zero');
+                    return l / r;
+                case '%':
+                    if (r === 0)
+                        throw new Error('Division by zero');
+                    return l % r;
+                case '^':
+                    return Math.pow(l, r);
+                default:
+                    throw new Error(`Unknown operator: '${node.op}'`);
+            }
+        }
+        case 'call': {
+            const args = node.args.map(evalNode);
+            switch (node.name) {
+                case 'sqrt':
+                    return Math.sqrt(args[0]);
+                case 'abs':
+                    return Math.abs(args[0]);
+                case 'ceil':
+                    return Math.ceil(args[0]);
+                case 'floor':
+                    return Math.floor(args[0]);
+                case 'round':
+                    return Math.round(args[0]);
+                case 'sin':
+                    return Math.sin(args[0]);
+                case 'cos':
+                    return Math.cos(args[0]);
+                case 'tan':
+                    return Math.tan(args[0]);
+                case 'log':
+                    return Math.log(args[0]);
+                case 'log2':
+                    return Math.log2(args[0]);
+                case 'log10':
+                    return Math.log10(args[0]);
+                case 'exp':
+                    return Math.exp(args[0]);
+                case 'min':
+                    if (args.length !== 2)
+                        throw new Error('Function min() requires exactly 2 arguments');
+                    return Math.min(args[0], args[1]);
+                case 'max':
+                    if (args.length !== 2)
+                        throw new Error('Function max() requires exactly 2 arguments');
+                    return Math.max(args[0], args[1]);
+                default:
+                    throw new Error(`Unknown function: '${node.name}'`);
+            }
+        }
+    }
+}
+/**
+ * Evaluates a mathematical expression string and returns the result.
+ *
+ * @param expr - Math expression; supports +, -, *, /, %, ^, unary -, parentheses, constants (pi, e) and functions (sin, cos, tan, sqrt, abs, ceil, floor, round, log, log2, log10, exp, min, max)
+ * @param precision - Number of decimal places in the result (0–15, default 10)
+ * @returns Object with the original expression, numeric result, and applied precision
+ * @throws Error if the expression is empty, exceeds the maximum length, contains unknown identifiers, or produces a non-finite result
+ */
+export default function evaluate(expr, precision) {
+    if (!expr || typeof expr !== 'string' || expr.trim() === '') {
+        throw new Error('Please provide a math expression');
+    }
+    if (expr.length > MAX_EXPR_LENGTH) {
+        throw new Error(`Expression cannot exceed ${MAX_EXPR_LENGTH} characters`);
+    }
+    const prec = Math.min(15, Math.max(0, precision !== undefined && Number.isFinite(precision) ? Math.floor(precision) : 10));
+    const tokens = tokenize(expr.trim());
+    if (tokens.length === 0)
+        throw new Error('Please provide a math expression');
+    const parser = new Parser(tokens);
+    const ast = parser.run();
+    const raw = evalNode(ast);
+    if (!isFinite(raw))
+        throw new Error('Result is not finite (overflow or undefined operation)');
+    const result = Number(raw.toFixed(prec));
+    return { expression: expr, result, precision: prec };
+}
+//# sourceMappingURL=evaluate.js.map

package/dist/modules/v5/evaluate.js.map

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

package/dist/modules/v5/jwt.d.ts

@@ -0,0 +1,11 @@
+export interface JwtResult {
+    header: Record<string, unknown>;
+    payload: Record<string, unknown>;
+    signature: string;
+    expired?: boolean;
+}
+/**
+ * Decodes a JSON Web Token (header + payload) without verifying the signature.
+ * WARNING: The signature is NOT verified. Use this for inspection only, not for security decisions.
+ */
+export default function jwt(token: string): JwtResult;

package/dist/modules/v5/jwt.js

@@ -0,0 +1,42 @@
+import { MAX_JWT_LENGTH } from '../../constants.js';
+/**
+ * Decodes a JSON Web Token (header + payload) without verifying the signature.
+ * WARNING: The signature is NOT verified. Use this for inspection only, not for security decisions.
+ */
+export default function jwt(token) {
+    if (!token)
+        throw new Error('Please provide a token (?token={token})');
+    if (token.length > MAX_JWT_LENGTH)
+        throw new Error(`Token cannot exceed ${MAX_JWT_LENGTH} characters`);
+    const parts = token.split('.');
+    if (parts.length !== 3)
+        throw new Error('Invalid JWT format. Expected 3 parts separated by "."');
+    const [headerB64, payloadB64, signature] = parts;
+    const isObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+    let header;
+    let payload;
+    try {
+        const parsed = JSON.parse(Buffer.from(headerB64, 'base64url').toString('utf-8'));
+        if (!isObject(parsed))
+            throw new Error();
+        header = parsed;
+    }
+    catch {
+        throw new Error('Invalid JWT header: not a valid base64url-encoded JSON object');
+    }
+    try {
+        const parsed = JSON.parse(Buffer.from(payloadB64, 'base64url').toString('utf-8'));
+        if (!isObject(parsed))
+            throw new Error();
+        payload = parsed;
+    }
+    catch {
+        throw new Error('Invalid JWT payload: not a valid base64url-encoded JSON object');
+    }
+    const result = { header, payload, signature };
+    if (typeof payload.exp === 'number') {
+        result.expired = Date.now() / 1000 > payload.exp;
+    }
+    return result;
+}
+//# sourceMappingURL=jwt.js.map

package/dist/modules/v5/jwt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../../../src/modules/v5/jwt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AASpD;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,KAAa;IACrC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACvE,IAAI,KAAK,CAAC,MAAM,GAAG,cAAc;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,cAAc,aAAa,CAAC,CAAC;IAEvG,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAEjG,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,GAAG,KAAiC,CAAC;IAE7E,MAAM,QAAQ,GAAG,CAAC,CAAU,EAAgC,EAAE,CAC1D,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7D,IAAI,MAA+B,CAAC;IACpC,IAAI,OAAgC,CAAC;IAErC,IAAI,CAAC;QACD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1F,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,EAAE,CAAC;QACzC,MAAM,GAAG,MAAM,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACL,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,CAAC;QACD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3F,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,EAAE,CAAC;QACzC,OAAO,GAAG,MAAM,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACL,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,MAAM,GAAc,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAEzD,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC;IACrD,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}