@terascope/core-utils 2.0.0-dev.7

package/dist/src/numbers.js

@@ -0,0 +1,354 @@
+import { FieldType } from '@terascope/types';
+import { isArrayLike } from './arrays.js';
+import { getTypeOf } from './deps.js';
+import { isKey } from './objects.js';
+let supportsBigInt = true;
+try {
+    if (typeof globalThis.BigInt === 'undefined') {
+        supportsBigInt = false;
+    }
+}
+catch (err) {
+    supportsBigInt = false;
+}
+/** A native implementation of lodash random */
+export function random(min, max) {
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+/** Check if an input is a number */
+export function isNumber(input) {
+    return typeof input === 'number' && !Number.isNaN(input);
+}
+/** Convert any input to a number, return Number.NaN if unable to convert input  */
+export function toNumber(input) {
+    if (typeof input === 'number')
+        return input;
+    return Number(input);
+}
+/** Will throw if converted number is NaN */
+export function toNumberOrThrow(input) {
+    const num = toNumber(input);
+    if (!isNumber(num)) {
+        throw new Error(`Could not convert ${input} to a number`);
+    }
+    return num;
+}
+/** Check if value is a bigint */
+export function isBigInt(input) {
+    return typeof input === 'bigint';
+}
+/** Convert any input to a bigint */
+export function toBigInt(input) {
+    if (!supportsBigInt) {
+        throw new Error('BigInt isn\'t supported in this environment');
+    }
+    try {
+        return toBigIntOrThrow(input);
+    }
+    catch {
+        return false;
+    }
+}
+const _maxBigInt = supportsBigInt
+    ? BigInt(Number.MAX_SAFE_INTEGER)
+    : Number.MAX_SAFE_INTEGER;
+/** Convert any input to a bigint */
+export function toBigIntOrThrow(input) {
+    if (typeof input === 'object') {
+        throw new TypeError(`Expected ${input} (${getTypeOf(input)}) to be parsable to a float`);
+    }
+    if (isBigInt(input))
+        return input;
+    if (!supportsBigInt) {
+        throw new Error('BigInt isn\'t supported in this environment');
+    }
+    if (typeof input === 'number' && input < Number.MAX_SAFE_INTEGER) {
+        return BigInt(Math.trunc(input));
+    }
+    if (!isNumberLike(input)) {
+        throw new TypeError(`Expected ${input} (${getTypeOf(input)}) to be parsable to a BigInt`);
+    }
+    let big;
+    if (typeof input === 'string' && input.includes('.')) {
+        big = BigInt(Number.parseInt(input, 10));
+    }
+    else {
+        big = BigInt(input);
+    }
+    // for some reason the number
+    // is incorrect when given a number
+    // greater than the max safe integer
+    if (big > _maxBigInt) {
+        return big + BigInt(1);
+    }
+    return big;
+}
+/**
+ * Convert a BigInt to either a number or a string
+*/
+export function bigIntToJSON(int) {
+    if (typeof int === 'number')
+        return int;
+    if (int <= _maxBigInt) {
+        return Number.parseInt(int.toString(10), 10);
+    }
+    // for some reason bigints ending being +1
+    return (int - BigInt(1)).toString(10);
+}
+/**
+ * A stricter check for verifying a number string
+ * @todo this needs to be smarter
+*/
+export function isNumberLike(input) {
+    if (typeof input === 'number')
+        return true;
+    if (typeof input === 'object')
+        return false;
+    if (typeof input === 'boolean')
+        return false;
+    // https://regexr.com/5cljt
+    return /^\s*[+-]{0,1}[\d,]+(\.[\d]+){0,1}\s*$/.test(String(input));
+}
+/** A simplified implementation of lodash isInteger */
+export function isInteger(val) {
+    if (typeof val !== 'number')
+        return false;
+    return Number.isSafeInteger(val);
+}
+/** Convert an input to a integer, return false if unable to convert input  */
+export function toInteger(input) {
+    try {
+        return toIntegerOrThrow(input);
+    }
+    catch (err) {
+        return false;
+    }
+}
+/** Convert an input to a integer or throw */
+export function toIntegerOrThrow(input) {
+    if (typeof input === 'object') {
+        throw new TypeError(`Expected ${input} (${getTypeOf(input)}) to be parsable to a integer`);
+    }
+    if (isBigInt(input)) {
+        const val = bigIntToJSON(input);
+        if (typeof val === 'string') {
+            throw new TypeError(`Expected ${val} (${getTypeOf(input)}) to be parsable to a integer`);
+        }
+        return val;
+    }
+    if (isInteger(input) || isFloat(input))
+        return Math.trunc(input);
+    if (!isNumberLike(input)) {
+        throw new TypeError(`Expected ${input} (${getTypeOf(input)}) to be parsable to a integer`);
+    }
+    const val = Number.parseInt(input, 10);
+    if (isInteger(val))
+        return val;
+    throw new TypeError(`Expected ${val} (${getTypeOf(input)}) to be parsable to a integer`);
+}
+/** Verify the input is float  */
+export function isFloat(val) {
+    if (!isNumber(val))
+        return false;
+    if (val === Number.POSITIVE_INFINITY)
+        return true;
+    if (val === Number.NEGATIVE_INFINITY)
+        return true;
+    return true;
+}
+/** Convert an input to a float, return false if unable to convert input  */
+export function toFloat(input) {
+    try {
+        return toFloatOrThrow(input);
+    }
+    catch (err) {
+        return false;
+    }
+}
+/** Convert an input to a float or throw */
+export function toFloatOrThrow(input) {
+    if (typeof input === 'object') {
+        throw new TypeError(`Expected ${input} (${getTypeOf(input)}) to be parsable to a float`);
+    }
+    if (isFloat(input))
+        return input;
+    if (isBigInt(input)) {
+        const val = bigIntToJSON(input);
+        if (typeof val === 'string') {
+            throw new TypeError(`Expected ${val} (${getTypeOf(input)}) to be parsable to a float`);
+        }
+        return val;
+    }
+    if (!isNumberLike(input)) {
+        throw new TypeError(`Expected ${input} (${getTypeOf(input)}) to be parsable to a float`);
+    }
+    const val = Number.parseFloat(input);
+    if (isFloat(val))
+        return val;
+    throw new TypeError(`Expected ${val} (${getTypeOf(input)}) to be parsable to a float`);
+}
+/**
+ * Like parseList, except it returns numbers
+ */
+export function parseNumberList(input) {
+    let items;
+    if (typeof input === 'string') {
+        items = input.split(',');
+    }
+    else if (Array.isArray(input)) {
+        items = input;
+    }
+    else if (isArrayLike(input)) {
+        items = Array.from(input);
+    }
+    else if (isNumber(input)) {
+        return [input];
+    }
+    else {
+        return [];
+    }
+    return items
+        // filter out any empty string
+        .filter(isConvertibleToNumber)
+        .map(toNumber)
+        .filter(isNumber);
+}
+function isConvertibleToNumber(item) {
+    if (item == null)
+        return false;
+    if (typeof item === 'string' && !item.trim().length)
+        return false;
+    return true;
+}
+/**
+ * Returns true if number is between min or max value provided
+ *
+ *  @example
+ *      inNumberRange(42, { min: 0, max: 100}); // true
+ *      inNumberRange(-42, { min:0 , max: 100 }); // false
+ *      inNumberRange(42, { min: 0, max: 42 }); // false
+ *      inNumberRange(42, { min: 0, max: 42, inclusive: true }) // true
+*/
+export function inNumberRange(input, args) {
+    if (!isNumber(input) && !isBigInt(input))
+        return false;
+    const min = args.min == null ? Number.NEGATIVE_INFINITY : args.min;
+    const max = args.max == null ? Number.POSITIVE_INFINITY : args.max;
+    if (args.inclusive) {
+        return (input >= min && input <= max);
+    }
+    return (input > min && input < max);
+}
+export function inNumberRangeFP(args) {
+    return function _inNumberRangeFP(input) {
+        return inNumberRange(input, args);
+    };
+}
+/**
+ * Returns a truncated number to nth decimal places.
+ *
+ * @param fractionDigits The number of decimal points to round to.
+ * @param truncate If this is true the number will not be rounded
+*/
+export function setPrecision(input, fractionDigits, truncate = false) {
+    if (Number.isNaN(input)
+        || input === Number.POSITIVE_INFINITY
+        || input === Number.NEGATIVE_INFINITY) {
+        return input;
+    }
+    const num = toFloatOrThrow(input);
+    if (!truncate) {
+        return parseFloat(num.toFixed(fractionDigits));
+    }
+    return parseFloat(setPrecisionFromString(num.toString(), fractionDigits));
+}
+/**
+ * A functional programming version of setPrecision
+ *
+ * @param fractionDigits The number of decimal points to round to.
+ * @param truncate If this is true the number will not be rounded
+*/
+export function setPrecisionFP(fractionDigits, truncate = false) {
+    return function _setPrecision(input) {
+        return setPrecision(input, fractionDigits, truncate);
+    };
+}
+/**
+ * this will always truncate (not round)
+*/
+function setPrecisionFromString(input, fractionDigits) {
+    const [int, points] = input.toString().split('.');
+    if (!points)
+        return int || '0';
+    const remainingPoints = points.slice(0, fractionDigits);
+    if (!remainingPoints)
+        return int || '0';
+    return `${int || '0'}.${remainingPoints}`;
+}
+/**
+ * Convert a fahrenheit value to celsius, this will return a precision of
+ * 2 decimal points
+*/
+export function toCelsius(input) {
+    const num = toFloatOrThrow(input);
+    const cNum = (num - 32) * (5 / 9);
+    return parseFloat(cNum.toFixed(2));
+}
+/**
+ * Convert a celsius value to fahrenheit, this will return a precision of
+ * 2 decimal points
+*/
+export function toFahrenheit(input) {
+    const num = toFloatOrThrow(input);
+    const fNum = ((9 / 5) * num) + 32;
+    return parseFloat(fNum.toFixed(2));
+}
+/**
+ * A number in javascript is a double-precision 64-bit
+ * binary format IEEE 754 value, much bigger than a regular
+ * classical int value, any higher than that should be a bigint
+ */
+const INT_SIZES = {
+    [FieldType.Byte]: { min: -128, max: 127 },
+    [FieldType.Short]: { min: -32_768, max: 32_767 },
+    [FieldType.Integer]: { min: Number.MIN_SAFE_INTEGER, max: Number.MAX_SAFE_INTEGER },
+};
+function _validateNumberFieldType(input, type) {
+    const int = toIntegerOrThrow(input);
+    if (isKey(INT_SIZES, type)) {
+        const { max, min } = INT_SIZES[type];
+        if (int >= max) {
+            throw new TypeError(`Invalid byte, value of ${int} is greater than maximum size of ${max}`);
+        }
+        if (int <= min) {
+            throw new TypeError(`Invalid byte, value of ${int} is less than minimum size of ${min}`);
+        }
+    }
+    return int;
+}
+export function validateByteNumber(input) {
+    return _validateNumberFieldType(input, FieldType.Byte);
+}
+export function validateShortNumber(input) {
+    return _validateNumberFieldType(input, FieldType.Short);
+}
+export function validateIntegerNumber(input) {
+    return _validateNumberFieldType(input, FieldType.Integer);
+}
+export function validateNumberType(type) {
+    return function _validateNumberType(input) {
+        return _validateNumberFieldType(input, type);
+    };
+}
+export function isValidateNumberType(type) {
+    const fn = validateNumberType(type);
+    return function _isValidateNumberType(input) {
+        try {
+            return fn(input) != null;
+        }
+        catch (_err) {
+            return false;
+        }
+    };
+}
+//# sourceMappingURL=numbers.js.map

package/dist/src/numbers.js.map

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

package/dist/src/objects.d.ts

@@ -0,0 +1,66 @@
+import { WithoutNil, FilteredResult } from '@terascope/types';
+/**
+ * Similar to is-plain-object but works better when you cloneDeep a DataEntity
+*/
+export declare function isSimpleObject(input: unknown): input is Record<string, unknown>;
+/**
+ * Get the first value in an object
+*/
+export declare function getFirstValue<T>(input: {
+    [key: string]: T;
+}): T | undefined;
+/**
+ * Get the first key in an object
+*/
+export declare function getFirstKey<T extends object>(input: T): (keyof T) | undefined;
+/**
+ * Verify that k is a key of object O
+*/
+export declare function isKey<T extends object>(O: T, k: PropertyKey): k is keyof T;
+/**
+ * Verify if the input is a object like type
+*/
+export declare function isObjectEntity(input: unknown): boolean;
+/**
+ * A clone deep using `JSON.parse(JSON.stringify(input))`
+*/
+export declare function fastCloneDeep<T>(input: T): T;
+/** Perform a shallow clone of an object to another, in the fastest way possible */
+export declare function fastAssign<T extends object, U extends object>(target: T, source: U): T & U;
+/** Sort keys on an object */
+export declare function sortKeys<T extends Record<string, unknown>>(input: T, options?: {
+    deep?: boolean;
+}): T;
+/** Map the values of an object */
+export declare function mapValues<T extends object, R = T>(input: T, fn: (value: T[keyof T], key: (keyof T)) => any): R;
+/** Map the keys of an object */
+export declare function mapKeys<T extends object, R = T>(input: T, fn: (value: T[keyof T], key: (keyof T)) => any): R;
+/** Build a new object without null or undefined values (shallow) */
+export declare function withoutNil<T>(input: T): WithoutNil<T>;
+/**
+ * Filters the keys of an object, by list of included key and excluded
+*/
+export declare function filterObject<T extends object, I extends (keyof T), E extends (keyof T)>(data: T, by?: {
+    includes?: I[];
+    excludes?: E[];
+}): FilteredResult<T, I, E>;
+/**
+ * A type safe get function (will always return the correct type)
+ *
+ * **IMPORTANT** This does not behave like lodash.get,
+ * it does not deal with dot notation (nested fields)
+ * and it will use the default when dealing with OR statements
+ */
+export declare function getField<V>(input: undefined, field: string, defaultVal?: V): V;
+export declare function getField<T, P extends keyof T>(input: T, field: P): T[P];
+export declare function getField<T, P extends keyof T>(input: T | undefined, field: P): T[P];
+export declare function getField<T, P extends keyof T>(input: T | undefined, field: P, defaultVal: never[]): T[P];
+export declare function getField<T, P extends keyof T, V>(input: T | undefined, field: P, defaultVal: V): T[P] | V;
+export declare function getField<T, P extends keyof T, V extends T[P]>(input: T | undefined, field: P, defaultVal: V): T[P];
+/**
+ * Check if a object has property (and not included in the prototype)
+ * Different from has since it doesn't deal with dot notation values.
+*/
+export declare function hasOwn(obj: any, prop: string | symbol | number): boolean;
+export declare function lookup(input: unknown): (key: unknown) => any;
+//# sourceMappingURL=objects.d.ts.map

package/dist/src/objects.d.ts.map

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

package/dist/src/objects.js

@@ -0,0 +1,170 @@
+import { isDataEntity } from './entities/utils.js';
+import { isBooleanLike } from './booleans.js';
+import { get, isPlainObject, getTypeOf } from './deps.js';
+import { isArrayLike, isArray } from './arrays.js';
+import { isBuffer } from './buffers.js';
+import { isString, trim, isPrimitiveValue } from './strings.js';
+import { toNumber } from './numbers.js';
+/**
+ * Similar to is-plain-object but works better when you cloneDeep a DataEntity
+*/
+export function isSimpleObject(input) {
+    if (input == null)
+        return false;
+    if (isBuffer(input))
+        return false;
+    if (isArrayLike(input))
+        return false;
+    if (input instanceof Set)
+        return false;
+    if (input instanceof Map)
+        return false;
+    return typeof input === 'object';
+}
+/**
+ * Get the first value in an object
+*/
+export function getFirstValue(input) {
+    return Object.values(input)[0];
+}
+/**
+ * Get the first key in an object
+*/
+export function getFirstKey(input) {
+    return Object.keys(input)[0];
+}
+/**
+ * Verify that k is a key of object O
+*/
+export function isKey(O, k) {
+    return k in O;
+}
+/**
+ * Verify if the input is a object like type
+*/
+export function isObjectEntity(input) {
+    return isDataEntity(input) || isSimpleObject(input);
+}
+/**
+ * A clone deep using `JSON.parse(JSON.stringify(input))`
+*/
+export function fastCloneDeep(input) {
+    return JSON.parse(JSON.stringify(input));
+}
+/** Perform a shallow clone of an object to another, in the fastest way possible */
+export function fastAssign(target, source) {
+    if (!isObjectEntity(source)) {
+        return target;
+    }
+    for (const [key, val] of Object.entries(source)) {
+        target[key] = val;
+    }
+    return target;
+}
+/** Sort keys on an object */
+export function sortKeys(input, options = {}) {
+    const result = {};
+    for (const _key of Object.keys(input).sort()) {
+        const key = _key;
+        const val = input[key];
+        if (options.deep && isPlainObject(val)) {
+            result[key] = sortKeys(val, options);
+        }
+        else {
+            result[key] = val;
+        }
+    }
+    return result;
+}
+/** Map the values of an object */
+export function mapValues(input, fn) {
+    const result = {};
+    for (const [key, val] of Object.entries(input)) {
+        result[key] = fn(val, key);
+    }
+    return result;
+}
+/** Map the keys of an object */
+export function mapKeys(input, fn) {
+    const result = {};
+    for (const [key, val] of Object.entries(input)) {
+        result[fn(val, key)] = val;
+    }
+    return result;
+}
+/** Build a new object without null or undefined values (shallow) */
+export function withoutNil(input) {
+    const result = {};
+    for (const _key of Object.keys(input).sort()) {
+        const key = _key;
+        if (input[key] != null) {
+            result[key] = input[key];
+        }
+    }
+    return result;
+}
+/**
+ * Filters the keys of an object, by list of included key and excluded
+*/
+export function filterObject(data, by) {
+    const { includes = [], excludes = [] } = by || {};
+    const result = {};
+    Object.keys(data)
+        .filter((key) => {
+        const included = includes.length ? includes.includes(key) : true;
+        const excluded = excludes.length ? excludes.includes(key) : false;
+        return included && !excluded;
+    })
+        .sort()
+        .forEach((key) => {
+        if (isKey(data, key)) {
+            result[key] = data[key];
+        }
+    });
+    return result;
+}
+export function getField(input, field, defaultVal) {
+    const result = get(input, field);
+    if (isBooleanLike(defaultVal)) {
+        if (result == null)
+            return defaultVal;
+        return result;
+    }
+    return result || defaultVal;
+}
+/**
+ * Check if a object has property (and not included in the prototype)
+ * Different from has since it doesn't deal with dot notation values.
+*/
+export function hasOwn(obj, prop) {
+    return Object.prototype.hasOwnProperty.call(obj, prop);
+}
+export function lookup(input) {
+    // lookup entity can be a string, object or array
+    if (!isObjectEntity(input) && !isString(input) && !isArray(input)) {
+        throw Error(`input must be an Object Entity, String, received ${getTypeOf(input)}`);
+    }
+    return function _lookup(key) {
+        if (key == null)
+            return null;
+        // This may be too restrictive at some point
+        if (!isPrimitiveValue(key)) {
+            throw Error(`lookup key must be not be an object, received ${getTypeOf(key)}`);
+        }
+        if (isString(input)) {
+            return _lookupStringToObject(input)[key];
+        }
+        if (isArray(input))
+            return input[toNumber(key)];
+        const lookupObj = input;
+        return lookupObj[key];
+    };
+}
+function _lookupStringToObject(stringInput) {
+    return stringInput.split('\n').reduce((asObj, line) => {
+        const [k, v] = trim(line).split(':', 2);
+        asObj[trim(k)] = trim(v);
+        return asObj;
+    }, {});
+}
+//# sourceMappingURL=objects.js.map

package/dist/src/objects.js.map

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

package/dist/src/phone-number.d.ts

@@ -0,0 +1,4 @@
+export declare function parsePhoneNumber(input: string | number): string;
+export declare function isISDN(input: unknown, country?: string): boolean;
+export declare function isPhoneNumberLike(input: unknown): boolean;
+//# sourceMappingURL=phone-number.d.ts.map

package/dist/src/phone-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-number.d.ts","sourceRoot":"","sources":["../../src/phone-number.ts"],"names":[],"mappings":"AAIA,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAO/D;AAYD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAQhE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKzD"}

package/dist/src/phone-number.js

@@ -0,0 +1,31 @@
+import { parsePhoneNumber as _parsePhoneNumber } from 'awesome-phonenumber';
+import { toString, isString } from './strings.js';
+import { isNumber, inNumberRange } from './numbers.js';
+export function parsePhoneNumber(input) {
+    const preppedInput = _prepPhoneNumber(toString(input).trim());
+    const fullNumber = _parsePhoneNumber(preppedInput).number?.e164;
+    if (fullNumber)
+        return String(fullNumber).slice(1);
+    throw Error('Could not determine the incoming phone number');
+}
+function _prepPhoneNumber(input) {
+    let testNumber = input;
+    if (testNumber.charAt(0) === '0')
+        testNumber = testNumber.slice(1);
+    if (testNumber.charAt(0) !== '+')
+        testNumber = `+${testNumber}`;
+    return testNumber;
+}
+export function isISDN(input, country) {
+    if (isString(input) || isNumber(input)) {
+        const isdn = country ? _parsePhoneNumber(toString(input), { regionCode: country }) : _parsePhoneNumber(`+${input}`);
+        return isdn.valid;
+    }
+    return false;
+}
+export function isPhoneNumberLike(input) {
+    const testValue = toString(input).trim()
+        .replace(/\D/g, '');
+    return inNumberRange(testValue.length, { min: 7, max: 20, inclusive: true });
+}
+//# sourceMappingURL=phone-number.js.map

package/dist/src/phone-number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone-number.js","sourceRoot":"","sources":["../../src/phone-number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACnD,MAAM,YAAY,GAAG,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAE9D,MAAM,UAAU,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC;IAChE,IAAI,UAAU;QAAE,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnD,MAAM,KAAK,CAAC,+CAA+C,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACnC,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnE,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IAEhE,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAc,EAAE,OAAgB;IACnD,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;QAEpH,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC5C,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE;SACnC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAExB,OAAO,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACjF,CAAC"}