@quereus/quereus 0.1.0

package/dist/src/func/builtins/string.js

@@ -0,0 +1,233 @@
+import { createAggregateFunction, createScalarFunction, createTableValuedFunction } from '../registration.js';
+import { createLogger } from '../../common/logger.js';
+import { simpleLike, simpleGlob } from '../../util/patterns.js';
+const log = createLogger('func:builtins:scalar');
+const warnLog = log.extend('warn');
+// --- length(X) ---
+export const lengthFunc = createScalarFunction({ name: 'length', numArgs: 1, deterministic: true }, (arg) => {
+    if (arg === null)
+        return null;
+    if (typeof arg === 'string')
+        return arg.length;
+    if (arg instanceof Uint8Array)
+        return arg.length;
+    return null; // Other types -> NULL
+});
+// --- substr(X, Y, Z?) --- Also SUBSTRING
+export const substrFunc = createScalarFunction({ name: 'substr', numArgs: -1, deterministic: true }, (str, start, len) => {
+    if (str === null || start === null)
+        return null;
+    const s = String(str); // Coerce main arg to string
+    let y = Number(start);
+    let z = len === undefined ? undefined : Number(len);
+    if (isNaN(y) || (z !== undefined && isNaN(z)))
+        return null;
+    // SQLite uses 1-based indexing, negative start counts from end
+    y = Math.trunc(y);
+    z = z === undefined ? undefined : Math.trunc(z);
+    const strLen = s.length;
+    let begin;
+    if (y > 0) {
+        begin = y - 1;
+    }
+    else if (y < 0) {
+        begin = strLen + y;
+    }
+    else { // y == 0
+        begin = 0;
+    }
+    begin = Math.max(0, begin); // Clamp start index
+    let end;
+    if (z === undefined) {
+        end = strLen; // No length means to end of string
+    }
+    else if (z >= 0) {
+        end = begin + z;
+    }
+    else { // Negative length is not standard SQL, SQLite returns empty string
+        end = begin;
+    }
+    return s.substring(begin, end);
+});
+export const substringFunc = createScalarFunction({ name: 'substring', numArgs: -1, deterministic: true }, (str, start, len) => {
+    if (str === null || start === null)
+        return null;
+    const s = String(str);
+    let y = Number(start);
+    let z = len === undefined ? undefined : Number(len);
+    if (isNaN(y) || (z !== undefined && isNaN(z)))
+        return null;
+    y = Math.trunc(y);
+    z = z === undefined ? undefined : Math.trunc(z);
+    const strLen = s.length;
+    let begin;
+    if (y > 0) {
+        begin = y - 1;
+    }
+    else if (y < 0) {
+        begin = strLen + y;
+    }
+    else {
+        begin = 0;
+    }
+    begin = Math.max(0, begin);
+    let end;
+    if (z === undefined) {
+        end = strLen;
+    }
+    else if (z >= 0) {
+        end = begin + z;
+    }
+    else {
+        end = begin;
+    }
+    return s.substring(begin, end);
+});
+export const likeFunc = createScalarFunction({ name: 'like', numArgs: 2, deterministic: true }, (pattern, text) => {
+    if (text === null || pattern === null)
+        return null;
+    return simpleLike(String(pattern), String(text)) ? 1 : 0;
+});
+export const globFunc = createScalarFunction({ name: 'glob', numArgs: 2, deterministic: true }, (pattern, text) => {
+    if (text === null || pattern === null)
+        return null;
+    return simpleGlob(String(pattern), String(text)) ? 1 : 0;
+});
+// --- trim(X, Y?) ---
+export const trimFunc = createScalarFunction({ name: 'trim', numArgs: -1, deterministic: true }, (strVal, charsVal) => {
+    if (strVal === null)
+        return null;
+    const str = String(strVal);
+    if (charsVal === undefined || charsVal === null) {
+        return str.trim();
+    }
+    const chars = String(charsVal);
+    if (chars.length === 0)
+        return str;
+    try {
+        const escapedChars = chars.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const regex = new RegExp(`^[${escapedChars}]+|[${escapedChars}]+$`, 'g');
+        return str.replace(regex, '');
+    }
+    catch (e) {
+        warnLog('Error creating trim regex for chars: %s, %O', chars, e);
+        return str.trim();
+    }
+});
+// --- ltrim(X, Y?) ---
+export const ltrimFunc = createScalarFunction({ name: 'ltrim', numArgs: -1, deterministic: true }, (strVal, charsVal) => {
+    if (strVal === null)
+        return null;
+    const str = String(strVal);
+    if (charsVal === undefined || charsVal === null) {
+        return str.trimStart();
+    }
+    const chars = String(charsVal);
+    if (chars.length === 0)
+        return str;
+    try {
+        const escapedChars = chars.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const regex = new RegExp(`^[${escapedChars}]+`, 'g');
+        return str.replace(regex, '');
+    }
+    catch (e) {
+        warnLog('Error creating ltrim regex for chars: %s, %O', chars, e);
+        return str.trimStart();
+    }
+});
+// --- rtrim(X, Y?) ---
+export const rtrimFunc = createScalarFunction({ name: 'rtrim', numArgs: -1, deterministic: true }, (strVal, charsVal) => {
+    if (strVal === null)
+        return null;
+    const str = String(strVal);
+    if (charsVal === undefined || charsVal === null) {
+        return str.trimEnd();
+    }
+    const chars = String(charsVal);
+    if (chars.length === 0)
+        return str;
+    try {
+        const escapedChars = chars.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const regex = new RegExp(`[${escapedChars}]+$`, 'g');
+        return str.replace(regex, '');
+    }
+    catch (e) {
+        warnLog('Error creating rtrim regex for chars: %s, %O', chars, e);
+        return str.trimEnd();
+    }
+});
+// --- replace(X, Y, Z) ---
+export const replaceFunc = createScalarFunction({ name: 'replace', numArgs: 3, deterministic: true }, (strVal, patternVal, replacementVal) => {
+    if (strVal === null || patternVal === null || replacementVal === null)
+        return null;
+    const str = String(strVal);
+    const pattern = String(patternVal);
+    const replacement = String(replacementVal);
+    if (pattern === '')
+        return str;
+    return str.split(pattern).join(replacement);
+});
+// --- instr(X, Y) ---
+export const instrFunc = createScalarFunction({ name: 'instr', numArgs: 2, deterministic: true }, (strVal, subVal) => {
+    if (strVal === null || subVal === null)
+        return 0;
+    const str = String(strVal);
+    const sub = String(subVal);
+    if (sub.length === 0)
+        return 0;
+    if (str.length === 0)
+        return 0;
+    const index = str.indexOf(sub);
+    return index === -1 ? 0 : index + 1;
+});
+// String reverse function
+export const reverseFunc = createScalarFunction({ name: 'reverse', numArgs: 1, deterministic: true }, (str) => {
+    if (typeof str !== 'string')
+        return null;
+    return str.split('').reverse().join('');
+});
+// Left padding function
+export const lpadFunc = createScalarFunction({ name: 'lpad', numArgs: 3, deterministic: true }, (str, len, pad) => {
+    if (typeof str !== 'string' || typeof len !== 'number' || typeof pad !== 'string')
+        return null;
+    const strLen = str.length;
+    if (len <= strLen)
+        return str;
+    const padStr = pad.repeat(len - strLen);
+    return padStr + str;
+});
+// Right padding function
+export const rpadFunc = createScalarFunction({ name: 'rpad', numArgs: 3, deterministic: true }, (str, len, pad) => {
+    if (typeof str !== 'string' || typeof len !== 'number' || typeof pad !== 'string')
+        return null;
+    const strLen = str.length;
+    if (len <= strLen)
+        return str;
+    const padStr = pad.repeat(len - strLen);
+    return str + padStr;
+});
+// Split a string into rows (table-valued function)
+export const splitStringFunc = createTableValuedFunction({ name: 'split_string', numArgs: 2, deterministic: true }, async function* (str, delimiter) {
+    if (typeof str !== 'string' || typeof delimiter !== 'string')
+        return;
+    const parts = str.split(delimiter);
+    for (let i = 0; i < parts.length; i++) {
+        yield [parts[i], i]; // value, index
+    }
+});
+// String concatenation aggregate (like GROUP_CONCAT but simpler)
+export const stringConcatFunc = createAggregateFunction({ name: 'string_concat', numArgs: 1, initialValue: [] }, (acc, value) => {
+    if (typeof value === 'string') {
+        acc.push(value);
+    }
+    return acc;
+}, (acc) => acc.join(','));
+// --- lower(X) ---
+export const lowerFunc = createScalarFunction({ name: 'lower', numArgs: 1, deterministic: true }, (arg) => {
+    return typeof arg === 'string' ? arg.toLowerCase() : null;
+});
+// --- upper(X) ---
+export const upperFunc = createScalarFunction({ name: 'upper', numArgs: 1, deterministic: true }, (arg) => {
+    return typeof arg === 'string' ? arg.toUpperCase() : null;
+});
+//# sourceMappingURL=string.js.map

package/dist/src/func/builtins/string.js.map

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

package/dist/src/func/context.d.ts

@@ -0,0 +1,102 @@
+import { type SqlValue, StatusCode } from '../common/types.js';
+import type { Database } from '../core/database.js';
+/**
+ * Represents the execution context passed to user-defined SQL functions
+ * (scalar, aggregate, window) and to virtual table methods.
+ * Provides methods for setting results and accessing auxiliary data.
+ *
+ * Methods that set a result should be the last action in a function
+ * implementation. Setting multiple results or setting a result then
+ * throwing an error leads to undefined behavior.
+ */
+export interface QuereusContext {
+    /**
+     * Sets the result of the function to a BLOB value.
+     * @param value The BLOB data
+     * @param destructor Optional hint that influences whether the engine copies the buffer
+     */
+    resultBlob(value: Uint8Array, destructor?: unknown): void;
+    /**
+     * Sets the result of the function to a floating-point value.
+     * @param value The double value
+     */
+    resultDouble(value: number): void;
+    /**
+     * Causes the function to return an error state.
+     * @param message The error message
+     * @param code Optional error code (defaults to ERROR)
+     */
+    resultError(message: string, code?: StatusCode): void;
+    /**
+     * Sets the result of the function to a 32-bit integer value.
+     * For larger integers, use resultInt64.
+     * @param value The integer value
+     */
+    resultInt(value: number): void;
+    /**
+     * Sets the result of the function to a 64-bit integer value.
+     * @param value The bigint value
+     */
+    resultInt64(value: bigint): void;
+    /**
+     * Sets the result of the function to SQL NULL.
+     */
+    resultNull(): void;
+    /**
+     * Sets the result of the function to a TEXT value.
+     * @param value The string value
+     * @param destructor Optional hint that influences whether the engine copies the string
+     */
+    resultText(value: string, destructor?: unknown): void;
+    /**
+     * Sets the result of the function to the provided SqlValue.
+     * @param value The SqlValue to set as the result
+     */
+    resultValue(value: SqlValue): void;
+    /**
+     * Sets the result to a zero-filled BLOB of a specified size.
+     * @param n The desired size of the zeroblob in bytes
+     */
+    resultZeroblob(n: number): void;
+    /**
+     * Sets the application-defined subtype for the result value.
+     * @param subtype An unsigned integer representing the subtype
+     */
+    resultSubtype(subtype: number): void;
+    /**
+     * Returns the user data associated with the function registration.
+     * @returns The user data specified during registration
+     */
+    getUserData(): unknown;
+    /**
+     * Returns the Database connection associated with this context.
+     * @returns The database connection
+     */
+    getDbConnection(): Database;
+    /**
+     * Gets auxiliary data previously associated with a function argument.
+     * Used for caching computations across multiple calls with the same arguments.
+     * @param N The argument index (0-based)
+     * @returns The stored auxiliary data, or undefined if none exists
+     */
+    getAuxData(N: number): unknown;
+    /**
+     * Sets auxiliary data associated with a specific function argument.
+     * @param N The argument index (0-based)
+     * @param data The data to store
+     * @param destructor Optional cleanup function called when the data is discarded
+     */
+    setAuxData(N: number, data: unknown, destructor?: (data: unknown) => void): void;
+    /**
+     * Retrieves the context (accumulator) for an aggregate function.
+     * @param createIfNotFound If true and no context exists, creates a new empty object
+     * @returns The aggregate context for the current group, or undefined
+     */
+    getAggregateContext<T = any>(createIfNotFound?: boolean): T | undefined;
+    /**
+     * Sets the context (accumulator) for an aggregate function.
+     * @param context The new state for the aggregate context
+     */
+    setAggregateContext<T = any>(context: T): void;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/src/func/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/func/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC9B;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE1D;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAEtD;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;IAEnB;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEtD;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAEnC;;;OAGG;IACH,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;;OAGG;IACH,eAAe,IAAI,QAAQ,CAAC;IAE5B;;;;;OAKG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAE/B;;;;;OAKG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAEjF;;;;OAIG;IACH,mBAAmB,CAAC,CAAC,GAAG,GAAG,EAAE,gBAAgB,CAAC,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS,CAAC;IAExE;;;OAGG;IACH,mBAAmB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;CAC/C"}

package/dist/src/func/context.js

@@ -0,0 +1,130 @@
+import { createLogger } from '../common/logger.js';
+import { StatusCode } from '../common/types.js';
+import { QuereusError } from '../common/errors.js';
+const log = createLogger('func:context');
+const errorLog = log.extend('error');
+/**
+ * Concrete implementation of QuereusContext used by the engine.
+ * @internal
+ */
+export class FunctionContext {
+    _result = undefined;
+    _result_set = false;
+    _error = null;
+    _subtype = 0;
+    userData;
+    db;
+    auxData = new Map();
+    _aggregateContext = undefined;
+    constructor(db, userData) {
+        this.db = db;
+        this.userData = userData;
+    }
+    /**
+     * @internal Gets the function result or throws if in error state
+     */
+    _getResult() {
+        if (this._error)
+            throw this._error;
+        return this._result_set ? this._result : null;
+    }
+    /**
+     * @internal Gets the error if one occurred
+     */
+    _getError() { return this._error; }
+    /**
+     * @internal Gets the result subtype
+     */
+    _getSubtype() { return this._subtype; }
+    /**
+     * @internal Resets the context for reuse
+     */
+    _clear() {
+        this._result = undefined;
+        this._result_set = false;
+        this._error = null;
+        this._subtype = 0;
+    }
+    /**
+     * @internal Sets the aggregate context reference from VDBE
+     */
+    _setAggregateContextRef(contextRef) {
+        this._aggregateContext = contextRef;
+    }
+    /**
+     * @internal Gets the potentially modified aggregate context
+     */
+    _getAggregateContextRef() {
+        return this._aggregateContext;
+    }
+    setResult(value) {
+        if (this._result_set || this._error)
+            return;
+        this._result = value;
+        this._result_set = true;
+    }
+    resultBlob(value) { this.setResult(value); }
+    resultDouble(value) { this.setResult(value); }
+    resultError(message, code = StatusCode.ERROR) {
+        if (this._result_set || this._error)
+            return;
+        this._error = new QuereusError(message, code);
+    }
+    resultInt(value) { this.setResult(Math.trunc(value)); }
+    resultInt64(value) { this.setResult(value); }
+    resultNull() { this.setResult(null); }
+    resultText(value) { this.setResult(value); }
+    resultValue(value) { this.setResult(value); }
+    resultZeroblob(n) { this.setResult(new Uint8Array(n)); }
+    resultSubtype(subtype) { this._subtype = subtype >>> 0; }
+    getUserData() { return this.userData; }
+    getDbConnection() { return this.db; }
+    getAuxData(N) {
+        return this.auxData.get(N)?.data;
+    }
+    setAuxData(N, data, destructor) {
+        if (this._error)
+            return;
+        const existing = this.auxData.get(N);
+        if (existing?.destructor && existing.data !== data) {
+            try {
+                existing.destructor(existing.data);
+            }
+            catch (e) {
+                errorLog("Internal: AuxData destructor failed: %O", e);
+            }
+        }
+        if (data === undefined && destructor === undefined) {
+            this.auxData.delete(N);
+        }
+        else {
+            this.auxData.set(N, { data, destructor });
+        }
+    }
+    getAggregateContext(createIfNotFound = false) {
+        if (this._aggregateContext === undefined && createIfNotFound) {
+            return {};
+        }
+        return this._aggregateContext;
+    }
+    setAggregateContext(context) {
+        this._aggregateContext = context;
+    }
+    /**
+     * @internal Cleans up auxiliary data during statement reset/finalize
+     */
+    _cleanupAuxData() {
+        this.auxData.forEach(entry => {
+            if (entry.destructor) {
+                try {
+                    entry.destructor(entry.data);
+                }
+                catch (e) {
+                    errorLog("Internal: AuxData destructor failed: %O", e);
+                }
+            }
+        });
+        this.auxData.clear();
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/src/func/context.js.map

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

package/dist/src/func/registration.d.ts

@@ -0,0 +1,89 @@
+import type { AggregateFinalizer, AggregateReducer, IntegratedTableValuedFunc, ScalarFunc, TableValuedFunc, ScalarFunctionSchema, TableValuedFunctionSchema, AggregateFunctionSchema } from '../schema/function.js';
+import { FunctionFlags } from '../common/constants.js';
+import type { ScalarType, RelationType } from '../common/datatype.js';
+/**
+ * Configuration options for scalar functions
+ */
+interface ScalarFuncOptions {
+    /** Function name as it will be called in SQL */
+    name: string;
+    /** Number of arguments, or -1 for variable number */
+    numArgs: number;
+    /** Function behavior flags */
+    flags?: FunctionFlags;
+    /** Whether the function is deterministic (affects caching) */
+    deterministic?: boolean;
+    /** Return type information */
+    returnType?: ScalarType;
+}
+/**
+ * Configuration options for table-valued functions
+ */
+interface TableValuedFuncOptions {
+    /** Function name as it will be called in SQL */
+    name: string;
+    /** Number of arguments, or -1 for variable number */
+    numArgs: number;
+    /** Function behavior flags */
+    flags?: FunctionFlags;
+    /** Whether the function is deterministic (affects caching) */
+    deterministic?: boolean;
+    /** Return type (relation) information */
+    returnType?: RelationType;
+}
+/**
+ * Configuration options for aggregate functions
+ */
+interface AggregateFuncOptions {
+    /** Function name as it will be called in SQL */
+    name: string;
+    /** Number of arguments, or -1 for variable number */
+    numArgs: number;
+    /** Function behavior flags */
+    flags?: FunctionFlags;
+    /** Whether the function is deterministic (affects caching) */
+    deterministic?: boolean;
+    /** Initial accumulator value */
+    initialValue?: any;
+    /** Return type information */
+    returnType?: ScalarType;
+}
+/**
+ * Creates a function schema for a scalar SQL function.
+ * This is the primary way to register scalar functions in Quereus.
+ *
+ * @param options Configuration options for the function
+ * @param jsFunc The JavaScript implementation function
+ * @returns A FunctionSchema ready for registration
+ */
+export declare function createScalarFunction(options: ScalarFuncOptions, jsFunc: ScalarFunc): ScalarFunctionSchema;
+/**
+ * Creates a function schema for a table-valued function.
+ * Table-valued functions return AsyncIterable<Row> and can be used in FROM clauses.
+ *
+ * @param options Configuration options for the function
+ * @param jsFunc The JavaScript implementation function
+ * @returns A FunctionSchema ready for registration
+ */
+export declare function createTableValuedFunction(options: TableValuedFuncOptions, jsFunc: TableValuedFunc): TableValuedFunctionSchema;
+/**
+ * Creates a function schema for an integrated table-valued function.
+ * Integrated functions receive the database instance as their first parameter.
+ *
+ * @param options Configuration options for the function
+ * @param jsFunc The JavaScript implementation function
+ * @returns A FunctionSchema ready for registration
+ */
+export declare function createIntegratedTableValuedFunction(options: TableValuedFuncOptions, jsFunc: IntegratedTableValuedFunc): TableValuedFunctionSchema;
+/**
+ * Creates a function schema for an aggregate function.
+ * Aggregate functions use a step/finalize pattern to accumulate values.
+ *
+ * @param options Configuration options for the function
+ * @param stepFunc Function called for each row
+ * @param finalizeFunc Function called to get final result
+ * @returns A FunctionSchema ready for registration
+ */
+export declare function createAggregateFunction(options: AggregateFuncOptions, stepFunc: AggregateReducer, finalizeFunc: AggregateFinalizer): AggregateFunctionSchema;
+export {};
+//# sourceMappingURL=registration.d.ts.map

package/dist/src/func/registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../../src/func/registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,UAAU,EAAE,eAAe,EAAE,oBAAoB,EAC/H,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEtE;;GAEG;AACH,UAAU,iBAAiB;IAC1B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,UAAU,sBAAsB;IAC/B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yCAAyC;IACzC,UAAU,CAAC,EAAE,YAAY,CAAC;CAC1B;AAED;;GAEG;AACH,UAAU,oBAAoB;IAC7B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gCAAgC;IAChC,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,UAAU,GAAG,oBAAoB,CAezG;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,sBAAsB,EAAE,MAAM,EAAE,eAAe,GAAG,yBAAyB,CAiB7H;AAED;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,sBAAsB,EAAE,MAAM,EAAE,yBAAyB,GAAG,yBAAyB,CAkBjJ;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,gBAAgB,EAC1B,YAAY,EAAE,kBAAkB,GAC9B,uBAAuB,CAiBzB"}