@math.gl/expressions 4.2.0-alpha.5

package/dist/expression-eval.js

@@ -0,0 +1,298 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Sources:
+ * - Copyright (c) 2013 Stephen Oney, http://jsep.from.so/, MIT License
+ * - Copyright (c) 2023 Don McCurdy, https://github.com/donmccurdy/expression-eval, MIT License
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-return, @typescript-eslint/restrict-plus-operands */
+import jsep from 'jsep';
+import { mergeFunctionLibraries } from "./function-libraries.js";
+const DEFAULT_PRECEDENCE = {
+    '||': 1,
+    '&&': 2,
+    '|': 3,
+    '^': 4,
+    '&': 5,
+    '==': 6,
+    '!=': 6,
+    '===': 6,
+    '!==': 6,
+    '<': 7,
+    '>': 7,
+    '<=': 7,
+    '>=': 7,
+    '<<': 8,
+    '>>': 8,
+    '>>>': 8,
+    '+': 9,
+    '-': 9,
+    '*': 10,
+    '/': 10,
+    '%': 10
+};
+const binops = {
+    '||': (a, b) => a || b,
+    '&&': (a, b) => a && b,
+    '|': (a, b) => a | b,
+    '^': (a, b) => a ^ b,
+    '&': (a, b) => a & b,
+    '==': (a, b) => {
+        // biome-ignore lint/suspicious/noDoubleEquals: this operator implements JavaScript loose equality.
+        return a == b;
+    },
+    '!=': (a, b) => {
+        // biome-ignore lint/suspicious/noDoubleEquals: this operator implements JavaScript loose inequality.
+        return a != b;
+    },
+    '===': (a, b) => a === b,
+    '!==': (a, b) => a !== b,
+    '<': (a, b) => a < b,
+    '>': (a, b) => a > b,
+    '<=': (a, b) => a <= b,
+    '>=': (a, b) => a >= b,
+    '<<': (a, b) => a << b,
+    '>>': (a, b) => a >> b,
+    '>>>': (a, b) => a >>> b,
+    '+': (a, b) => {
+        // @ts-expect-error Addition intentionally supports JS coercion semantics.
+        return a + b;
+    },
+    '-': (a, b) => a - b,
+    '*': (a, b) => a * b,
+    '/': (a, b) => a / b,
+    '%': (a, b) => a % b
+};
+const unops = {
+    '-': (a) => -a,
+    '+': (a) => {
+        // eslint-disable-next-line no-implicit-coercion
+        return +a;
+    },
+    '~': (a) => ~a,
+    '!': (a) => !a
+};
+function evaluateArray(list, context) {
+    return list.map(value => evaluate(value, context));
+}
+/** Evaluates each expression in an array concurrently. */
+async function evaluateArrayAsync(list, context) {
+    return await Promise.all(list.map(value => evalAsync(value, context)));
+}
+/** Resolves a member expression and preserves its receiver for method calls. */
+function evaluateMember(node, context) {
+    const object = evaluate(node.object, context);
+    const key = node.computed
+        ? evaluate(node.property, context)
+        : node.property.name;
+    if (/^__proto__|prototype|constructor$/.test(key)) {
+        throw new Error(`Access to member "${key}" disallowed.`);
+    }
+    return [object, object?.[key]];
+}
+/** Asynchronously resolves a member expression and its receiver. */
+async function evaluateMemberAsync(node, context) {
+    const object = (await evalAsync(node.object, context));
+    const key = node.computed
+        ? (await evalAsync(node.property, context))
+        : node.property.name;
+    if (/^__proto__|prototype|constructor$/.test(key)) {
+        throw new Error(`Access to member "${key}" disallowed.`);
+    }
+    return [object, object?.[key]];
+}
+/** Evaluates one expression node synchronously. */
+// eslint-disable-next-line complexity
+function evaluateExpression(node, context, options) {
+    const expression = node;
+    const mergedContext = mergeFunctionLibraries(context, options);
+    switch (expression.type) {
+        case 'ArrayExpression':
+            return evaluateArray(expression.elements, mergedContext);
+        case 'BinaryExpression':
+            if (expression.operator === '||') {
+                return (evaluate(expression.left, mergedContext) || evaluate(expression.right, mergedContext));
+            }
+            if (expression.operator === '&&') {
+                return (evaluate(expression.left, mergedContext) && evaluate(expression.right, mergedContext));
+            }
+            return binops[expression.operator](evaluate(expression.left, mergedContext), evaluate(expression.right, mergedContext));
+        case 'CallExpression': {
+            let caller;
+            let fn;
+            if (expression.callee.type === 'MemberExpression') {
+                const member = evaluateMember(expression.callee, mergedContext);
+                caller = member[0];
+                fn = member[1];
+            }
+            else {
+                fn = evaluate(expression.callee, mergedContext);
+            }
+            if (typeof fn !== 'function') {
+                return undefined;
+            }
+            return fn.apply(caller, evaluateArray(expression.arguments, mergedContext));
+        }
+        case 'ConditionalExpression':
+            return evaluate(expression.test, mergedContext)
+                ? evaluate(expression.consequent, mergedContext)
+                : evaluate(expression.alternate, mergedContext);
+        case 'Identifier':
+            return mergedContext[expression.name];
+        case 'Literal':
+            return expression.value;
+        case 'MemberExpression':
+            return evaluateMember(expression, mergedContext)[1];
+        case 'ThisExpression':
+            return mergedContext;
+        case 'UnaryExpression':
+            return unops[expression.operator](evaluate(expression.argument, mergedContext));
+        default:
+            return undefined;
+    }
+}
+/** Evaluates a nested expression using an already-merged context. */
+function evaluate(node, context) {
+    return evaluateExpression(node, context);
+}
+/**
+ * Evaluates a parsed expression asynchronously.
+ *
+ * @param node - Expression AST to evaluate.
+ * @param context - Named values and functions available to the expression.
+ * @param options - Function libraries to add to the context.
+ * @returns The resolved expression value.
+ *
+ * @remarks
+ * Function calls are awaited, including calls nested inside arrays, member
+ * expressions, conditionals, unary expressions, and binary expressions.
+ */
+// eslint-disable-next-line complexity
+export async function evalAsync(node, context, options) {
+    const expression = node;
+    const mergedContext = mergeFunctionLibraries(context, options);
+    switch (expression.type) {
+        case 'ArrayExpression':
+            return await evaluateArrayAsync(expression.elements, mergedContext);
+        case 'BinaryExpression':
+            if (expression.operator === '||') {
+                return ((await evalAsync(expression.left, mergedContext)) ||
+                    (await evalAsync(expression.right, mergedContext)));
+            }
+            if (expression.operator === '&&') {
+                return ((await evalAsync(expression.left, mergedContext)) &&
+                    (await evalAsync(expression.right, mergedContext)));
+            }
+            return binops[expression.operator](await evalAsync(expression.left, mergedContext), await evalAsync(expression.right, mergedContext));
+        case 'CallExpression': {
+            let caller;
+            let fn;
+            if (expression.callee.type === 'MemberExpression') {
+                const member = await evaluateMemberAsync(expression.callee, mergedContext);
+                caller = member[0];
+                fn = member[1];
+            }
+            else {
+                fn = (await evalAsync(expression.callee, mergedContext));
+            }
+            if (typeof fn !== 'function') {
+                return undefined;
+            }
+            return await fn.apply(caller, await evaluateArrayAsync(expression.arguments, mergedContext));
+        }
+        case 'ConditionalExpression':
+            return (await evalAsync(expression.test, mergedContext))
+                ? await evalAsync(expression.consequent, mergedContext)
+                : await evalAsync(expression.alternate, mergedContext);
+        case 'Identifier':
+            return mergedContext[expression.name];
+        case 'Literal':
+            return expression.value;
+        case 'MemberExpression':
+            return (await evaluateMemberAsync(expression, mergedContext))[1];
+        case 'ThisExpression':
+            return mergedContext;
+        case 'UnaryExpression':
+            return unops[expression.operator](await evalAsync(expression.argument, mergedContext));
+        default:
+            return undefined;
+    }
+}
+/**
+ * Compiles an expression into a reusable synchronous evaluator.
+ *
+ * @param expression - Expression source or a previously parsed AST.
+ * @param options - Function libraries to add to each evaluation context.
+ * @returns A function that evaluates the expression against a context.
+ */
+export function compile(expression, options) {
+    const ast = parse(expression);
+    return (context) => evaluateExpression(ast, context, options);
+}
+/**
+ * Compiles an expression into a reusable asynchronous evaluator.
+ *
+ * @param expression - Expression source or a previously parsed AST.
+ * @param options - Function libraries to add to each evaluation context.
+ * @returns A function that asynchronously evaluates the expression.
+ */
+export function compileAsync(expression, options) {
+    const ast = parse(expression);
+    return (context) => evalAsync(ast, context, options);
+}
+/**
+ * Registers a custom unary operator with the parser and evaluator.
+ *
+ * @param operator - Operator token to register.
+ * @param fn - Evaluator implementation for the operator.
+ *
+ * @remarks
+ * Registration changes module-global parser state and affects subsequent
+ * calls to {@link parse}.
+ */
+export function addUnaryOp(operator, fn) {
+    jsep.addUnaryOp(operator);
+    unops[operator] = fn;
+}
+/**
+ * Registers a custom binary operator with the parser and evaluator.
+ *
+ * @param operator - Operator token to register.
+ * @param precedenceOrFn - Parser precedence, or the evaluator implementation
+ * when using the default precedence for a built-in operator.
+ * @param fn - Evaluator implementation when an explicit precedence is given.
+ *
+ * @remarks
+ * Registration changes module-global parser state and affects subsequent
+ * calls to {@link parse}. New operators should provide explicit precedence.
+ */
+export function addBinaryOp(operator, precedenceOrFn, fn) {
+    if (fn) {
+        jsep.addBinaryOp(operator, precedenceOrFn);
+        binops[operator] = fn;
+        return;
+    }
+    jsep.addBinaryOp(operator, DEFAULT_PRECEDENCE[operator] || 1);
+    binops[operator] = precedenceOrFn;
+}
+/**
+ * Parses expression source into a JSEP abstract syntax tree.
+ *
+ * @param expression - Expression source or an existing AST.
+ * @returns A parsed AST, or the supplied AST unchanged.
+ * @throws If the expression string is not valid JSEP syntax.
+ */
+export function parse(expression) {
+    return typeof expression === 'string' ? jsep(expression) : expression;
+}
+/**
+ * Evaluates a parsed expression synchronously.
+ *
+ * @param node - Expression AST to evaluate.
+ * @param context - Named values and functions available to the expression.
+ * @param options - Function libraries to add to the context.
+ * @returns The expression value.
+ */
+export { evaluateExpression as eval };
+//# sourceMappingURL=expression-eval.js.map

package/dist/expression-eval.js.map

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

package/dist/function-libraries.d.ts

@@ -0,0 +1,75 @@
+import type { ExpressionFunctionRegistry } from "./function-registry.js";
+/**
+ * A function that can be exposed to evaluated expressions.
+ *
+ * @param args - Arguments supplied by a call expression.
+ * @returns The value made available to the expression.
+ */
+export type ExpressionFunction = (...args: any[]) => any;
+/**
+ * A named collection of functions that can be supplied to an expression
+ * evaluator through {@link ExpressionEvaluationOptions}.
+ */
+export type ExpressionFunctionLibrary = Record<string, ExpressionFunction>;
+/**
+ * Options shared by the synchronous and asynchronous expression evaluators.
+ */
+export type ExpressionEvaluationOptions = {
+    /**
+     * Instance-scoped registry of named functions available to the expression.
+     */
+    registry?: ExpressionFunctionRegistry;
+    /**
+     * Function libraries to add to the evaluation context.
+     *
+     * Libraries are merged from left to right. Functions in later libraries
+     * replace functions with the same name in earlier libraries. Values in the
+     * expression context replace functions with the same name in any library.
+     */
+    libraries?: ExpressionFunctionLibrary[];
+};
+/**
+ * General-purpose mathematical functions for expression evaluation.
+ *
+ * Includes JavaScript `Math` functions and math.gl helpers such as `clamp`,
+ * `lerp`, `normalizeAngle`, `safeMod`, `toDegrees`, and `toRadians`.
+ *
+ * @example
+ * ```ts
+ * const evaluate = compile("clamp(sin(angle), 0, 1)", {
+ *   libraries: [BASIC_MATH_FUNCTION_LIBRARY]
+ * });
+ * evaluate({angle: Math.PI / 2});
+ * ```
+ */
+export declare const BASIC_MATH_FUNCTION_LIBRARY: ExpressionFunctionLibrary;
+/**
+ * WGS84 ellipsoid functions for expression evaluation.
+ *
+ * Includes cartographic and Cartesian coordinate conversion, surface
+ * projection, local east-north-up frame generation, and WGS84 inspection.
+ * Angular arguments use radians unless the selected function states otherwise.
+ *
+ * @example
+ * ```ts
+ * const evaluate = compile("cartographicToCartesian(position)", {
+ *   libraries: [GEOSPATIAL_FUNCTION_LIBRARY]
+ * });
+ * evaluate({position: [0, 0, 0]});
+ * ```
+ */
+export declare const GEOSPATIAL_FUNCTION_LIBRARY: ExpressionFunctionLibrary;
+/**
+ * Adds configured function libraries to an expression context.
+ *
+ * @param context - Values available to the expression.
+ * @param options - Function libraries to merge into the context.
+ * @returns The original context when no libraries are supplied, or a new
+ * context containing the libraries and context values.
+ *
+ * @remarks
+ * Libraries are merged from left to right, then overlaid with `context`.
+ * Registry functions have the lowest precedence. The input objects are not modified.
+ */
+export declare function mergeFunctionLibraries(context: Record<string, unknown>, options?: ExpressionEvaluationOptions): Record<string, unknown>;
+//# sourceMappingURL=function-libraries.d.ts.map

package/dist/function-libraries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-libraries.d.ts","sourceRoot":"","sources":["../src/function-libraries.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAC,0BAA0B,EAAC,+BAA4B;AAEpE;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC;;OAEG;IACH,QAAQ,CAAC,EAAE,0BAA0B,CAAC;IAEtC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,yBAAyB,EAAE,CAAC;CACzC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,2BAA2B,EAAE,yBA2BzC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,2BAA2B,EAAE,yBAsBzC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,2BAA2B,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB"}

package/dist/function-libraries.js

@@ -0,0 +1,98 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-return */
+import { acos, asin, atan, clamp, cos, degrees, lerp, normalizeAngle, radians, safeMod, sin, tan, toDegrees, toRadians } from '@math.gl/core';
+import { Ellipsoid, isWGS84 } from '@math.gl/geospatial';
+/**
+ * General-purpose mathematical functions for expression evaluation.
+ *
+ * Includes JavaScript `Math` functions and math.gl helpers such as `clamp`,
+ * `lerp`, `normalizeAngle`, `safeMod`, `toDegrees`, and `toRadians`.
+ *
+ * @example
+ * ```ts
+ * const evaluate = compile("clamp(sin(angle), 0, 1)", {
+ *   libraries: [BASIC_MATH_FUNCTION_LIBRARY]
+ * });
+ * evaluate({angle: Math.PI / 2});
+ * ```
+ */
+export const BASIC_MATH_FUNCTION_LIBRARY = {
+    abs: Math.abs,
+    acos,
+    asin,
+    atan,
+    ceil: Math.ceil,
+    clamp,
+    cos,
+    degrees,
+    exp: Math.exp,
+    floor: Math.floor,
+    lerp,
+    log: Math.log,
+    max: Math.max,
+    min: Math.min,
+    normalizeAngle,
+    pow: Math.pow,
+    radians,
+    round: Math.round,
+    safeMod,
+    sign: Math.sign,
+    sin,
+    sqrt: Math.sqrt,
+    tan,
+    toDegrees,
+    toRadians,
+    trunc: Math.trunc
+};
+/**
+ * WGS84 ellipsoid functions for expression evaluation.
+ *
+ * Includes cartographic and Cartesian coordinate conversion, surface
+ * projection, local east-north-up frame generation, and WGS84 inspection.
+ * Angular arguments use radians unless the selected function states otherwise.
+ *
+ * @example
+ * ```ts
+ * const evaluate = compile("cartographicToCartesian(position)", {
+ *   libraries: [GEOSPATIAL_FUNCTION_LIBRARY]
+ * });
+ * evaluate({position: [0, 0, 0]});
+ * ```
+ */
+export const GEOSPATIAL_FUNCTION_LIBRARY = {
+    cartesianToCartographic: (cartesian, result) => Ellipsoid.WGS84.cartesianToCartographic(cartesian, result),
+    cartographicToCartesian: (cartographic, result) => Ellipsoid.WGS84.cartographicToCartesian(cartographic, result),
+    eastNorthUpToFixedFrame: (origin, result) => Ellipsoid.WGS84.eastNorthUpToFixedFrame(origin, result),
+    geodeticSurfaceNormal: (cartesian, result) => Ellipsoid.WGS84.geodeticSurfaceNormal(cartesian, result),
+    geodeticSurfaceNormalCartographic: (cartographic, result) => Ellipsoid.WGS84.geodeticSurfaceNormalCartographic(cartographic, result),
+    isWGS84,
+    scaleToGeocentricSurface: (cartesian, result) => Ellipsoid.WGS84.scaleToGeocentricSurface(cartesian, result),
+    scaleToGeodeticSurface: (cartesian, result) => Ellipsoid.WGS84.scaleToGeodeticSurface(cartesian, result),
+    toDegrees,
+    toRadians,
+    transformPositionFromScaledSpace: (position, result) => Ellipsoid.WGS84.transformPositionFromScaledSpace(position, result),
+    transformPositionToScaledSpace: (position, result) => Ellipsoid.WGS84.transformPositionToScaledSpace(position, result)
+};
+/**
+ * Adds configured function libraries to an expression context.
+ *
+ * @param context - Values available to the expression.
+ * @param options - Function libraries to merge into the context.
+ * @returns The original context when no libraries are supplied, or a new
+ * context containing the libraries and context values.
+ *
+ * @remarks
+ * Libraries are merged from left to right, then overlaid with `context`.
+ * Registry functions have the lowest precedence. The input objects are not modified.
+ */
+export function mergeFunctionLibraries(context, options) {
+    if (!options?.libraries?.length) {
+        if (!options?.registry) {
+            return context;
+        }
+    }
+    return Object.assign({}, options.registry?.getFunctionTable(), ...(options.libraries || []), context);
+}
+//# sourceMappingURL=function-libraries.js.map

package/dist/function-libraries.js.map

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

package/dist/function-registry.d.ts

@@ -0,0 +1,93 @@
+import type { ExpressionFunction, ExpressionFunctionLibrary } from "./function-libraries.js";
+/**
+ * Options for registering functions with an {@link ExpressionFunctionRegistry}.
+ */
+export type FunctionRegistrationOptions = {
+    /**
+     * Replace an existing function with the same name.
+     *
+     * @defaultValue false
+     */
+    replace?: boolean;
+};
+/**
+ * An isolated collection of named functions available to expression evaluators.
+ *
+ * @remarks
+ * Registries are instance scoped. Registering a function does not affect other
+ * registries or evaluators that do not receive the registry.
+ *
+ * Function names must be valid JavaScript-style identifiers so they can be
+ * called directly from JSEP expressions.
+ *
+ * @example
+ * ```ts
+ * const registry = new ExpressionFunctionRegistry()
+ *   .registerFunction('double', (value) => value * 2)
+ *   .registerFunctions(BASIC_MATH_FUNCTION_LIBRARY);
+ *
+ * const evaluate = compile('double(round(value))', {registry});
+ * evaluate({value: 2.4});
+ * ```
+ */
+export declare class ExpressionFunctionRegistry {
+    private readonly functions;
+    /**
+     * Creates a function registry.
+     *
+     * @param functionTables - Function tables to register in order.
+     * @throws If a table contains an invalid or duplicate function name.
+     */
+    constructor(functionTables?: readonly ExpressionFunctionLibrary[]);
+    /**
+     * Registers one named function.
+     *
+     * @param name - Identifier used to call the function from an expression.
+     * @param fn - JavaScript function invoked with evaluated expression arguments.
+     * @param options - Duplicate registration behavior.
+     * @returns This registry.
+     * @throws If the name is invalid, the value is not a function, or the name is
+     * already registered and replacement was not requested.
+     */
+    registerFunction(name: string, fn: ExpressionFunction, options?: FunctionRegistrationOptions): this;
+    /**
+     * Registers all entries in a function table.
+     *
+     * @param functionTable - Map from expression identifiers to JavaScript functions.
+     * @param options - Duplicate registration behavior.
+     * @returns This registry.
+     * @throws If any entry is invalid or conflicts with an existing registration.
+     *
+     * @remarks
+     * Validation is atomic: no entries are registered when any entry is invalid.
+     */
+    registerFunctions(functionTable: ExpressionFunctionLibrary, options?: FunctionRegistrationOptions): this;
+    /**
+     * Removes a registered function.
+     *
+     * @param name - Function name to remove.
+     * @returns `true` when a function was removed.
+     */
+    unregisterFunction(name: string): boolean;
+    /**
+     * Tests whether a function is registered.
+     *
+     * @param name - Function name to inspect.
+     * @returns `true` when the registry contains the name.
+     */
+    hasFunction(name: string): boolean;
+    /**
+     * Returns a registered function.
+     *
+     * @param name - Function name to retrieve.
+     * @returns The registered function, or `undefined`.
+     */
+    getFunction(name: string): ExpressionFunction | undefined;
+    /**
+     * Returns an immutable snapshot of all registered functions.
+     *
+     * @returns A frozen function table.
+     */
+    getFunctionTable(): Readonly<ExpressionFunctionLibrary>;
+}
+//# sourceMappingURL=function-registry.d.ts.map

package/dist/function-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-registry.d.ts","sourceRoot":"","sources":["../src/function-registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,kBAAkB,EAAE,yBAAyB,EAAC,gCAA6B;AAKxF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoD;IAE9E;;;;;OAKG;gBACS,cAAc,GAAE,SAAS,yBAAyB,EAAO;IAMrE;;;;;;;;;OASG;IACH,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,kBAAkB,EACtB,OAAO,GAAE,2BAAgC,GACxC,IAAI;IASP;;;;;;;;;;OAUG;IACH,iBAAiB,CACf,aAAa,EAAE,yBAAyB,EACxC,OAAO,GAAE,2BAAgC,GACxC,IAAI;IAkBP;;;;;OAKG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOzC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIzD;;;;OAIG;IACH,gBAAgB,IAAI,QAAQ,CAAC,yBAAyB,CAAC;CAGxD"}