@benev/math 0.2.0 → 0.3.0-2

package/x/concepts/quat.js

@@ -0,0 +1,110 @@
+export class Quat {
+    x;
+    y;
+    z;
+    w;
+    constructor(x, y, z, w) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+        this.w = w;
+    }
+    static new(x, y, z, w) {
+        return new this(x, y, z, w);
+    }
+    static identity() {
+        return new this(0, 0, 0, 1);
+    }
+    static array(q) {
+        return new this(...q);
+    }
+    static import({ x, y, z, w }) {
+        return new this(x, y, z, w);
+    }
+    static from(q) {
+        return Array.isArray(q)
+            ? this.array(q)
+            : this.import(q);
+    }
+    static rotate_(pitch, yaw, roll) {
+        return this.identity().rotate_(pitch, yaw, roll);
+    }
+    static rotate(vec) {
+        return this.identity().rotate(vec);
+    }
+    array() {
+        const { x, y, z, w } = this;
+        return [x, y, z, w];
+    }
+    toString() {
+        return `(Quat x${this.x.toFixed(2)}, y${this.y.toFixed(2)}, z${this.z.toFixed(2)}, w${this.w.toFixed(2)})`;
+    }
+    clone() {
+        return new Quat(...this.array());
+    }
+    transform_(x, y, z, w, global = false) {
+        if (global) {
+            const original = this.array();
+            return this.set_(x, y, z, w).multiply_(...original);
+        }
+        else {
+            return this.multiply_(x, y, z, w);
+        }
+    }
+    transform({ x, y, z, w }, global = false) {
+        return this.transform_(x, y, z, w, global);
+    }
+    rotate_(pitch, yaw, roll, global = false) {
+        const cx = Math.cos(pitch * 0.5), sx = Math.sin(pitch * 0.5);
+        const cy = Math.cos(yaw * 0.5), sy = Math.sin(yaw * 0.5);
+        const cz = Math.cos(roll * 0.5), sz = Math.sin(roll * 0.5);
+        const x = sx * cy * cz + cx * sy * sz;
+        const y = cx * sy * cz - sx * cy * sz;
+        const z = cx * cy * sz + sx * sy * cz;
+        const w = cx * cy * cz - sx * sy * sz;
+        return this.transform_(x, y, z, w, global);
+    }
+    rotate({ x: pitch, y: yaw, z: roll }, global = false) {
+        return this.rotate_(pitch, yaw, roll, global);
+    }
+    rotateAroundAxis_(angle, axisX, axisY, axisZ, global = false) {
+        const halfAngle = angle * 0.5;
+        const sinHalf = Math.sin(halfAngle);
+        const x = axisX * sinHalf;
+        const y = axisY * sinHalf;
+        const z = axisZ * sinHalf;
+        const w = Math.cos(halfAngle);
+        return this.transform_(x, y, z, w, global);
+    }
+    rotateAroundAxis(angle, axis, global = false) {
+        return this.rotateAroundAxis_(angle, axis.x, axis.y, axis.z, global);
+    }
+    set_(x, y, z, w) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+        this.w = w;
+        return this;
+    }
+    set({ x, y, z, w }) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+        this.w = w;
+        return this;
+    }
+    multiply_(x2, y2, z2, w2) {
+        const { x, y, z, w } = this;
+        this.x = w * x2 + x * w2 + y * z2 - z * y2;
+        this.y = w * y2 - x * z2 + y * w2 + z * x2;
+        this.z = w * z2 + x * y2 - y * x2 + z * w2;
+        this.w = w * w2 - x * x2 - y * y2 - z * z2;
+        return this;
+    }
+    multiply(...quats) {
+        for (const { x, y, z, w } of quats)
+            this.multiply_(x, y, z, w);
+        return this;
+    }
+}
+//# sourceMappingURL=quat.js.map

package/x/concepts/quat.js.map

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

package/x/concepts/randy.d.ts

@@ -0,0 +1,39 @@
+export type Random = () => number;
+/** utility for generating and using random numbers. */
+export declare class Randy {
+    readonly seed: number;
+    random: Random;
+    constructor(seed?: number);
+    /** obtain a random positive 32 bit integer. */
+    static randomSeed(): number;
+    /** seed a pseudo-random number generator function that produces numbers between 0 and 1. */
+    static makeRandom(seed: number): Random;
+    /** obtain a random positive integer. */
+    integer(): number;
+    /** return true or false, given a 0 to 1 probability fraction. */
+    roll(chance?: number): boolean;
+    /** generate a random number between two numbers. */
+    range(a: number, b: number): number;
+    /** generate a random integer between two numbers (inclusive). */
+    integerRange(a: number, b: number): number;
+    /** randomly choose an index given an array length. */
+    index(length: number): number;
+    /** return a random item from the given array. */
+    choose<T>(array: T[]): T;
+    /** remove and return a random item from the given array. */
+    yoink<T>(array: T[]): T;
+    /** randomly select a number of array items. */
+    select<T>(count: number, array: T[]): T[];
+    /** remove and return a number of items from the given array. */
+    take<T>(count: number, array: T[]): T[];
+    /** shuffle an array in-place using (fisher-yates) */
+    shuffle<T>(array: T[]): T[];
+    /** @deprecated create an instance with the given seed number. */
+    static seed(seed: number): Randy;
+    /** @deprecated renamed to `take` */
+    extract<T>(count: number, array: T[]): T[];
+    /** @deprecated renamed to `range` */
+    between(a: number, b: number): number;
+    /** @deprecated renamed to `integerRange` */
+    integerBetween(a: number, b: number): number;
+}

package/x/concepts/randy.js

@@ -0,0 +1,95 @@
+/** utility for generating and using random numbers. */
+export class Randy {
+    seed;
+    random;
+    constructor(seed = Randy.randomSeed()) {
+        this.seed = seed;
+        this.random = Randy.makeRandom(seed);
+    }
+    /** obtain a random positive 32 bit integer. */
+    static randomSeed() {
+        return Math.floor(Math.random() * 2147483647);
+    }
+    /** seed a pseudo-random number generator function that produces numbers between 0 and 1. */
+    static makeRandom(seed) {
+        seed = (seed ^ 0x6D2B79F5) + 0x1E35A7BD;
+        seed = (Math.abs(seed | 0) % 2147483647) || 1;
+        function random() {
+            seed = (Math.imul(48271, seed) | 0) % 2147483647;
+            return (seed & 2147483647) / 2147483648;
+        }
+        random(); // discard first value
+        return random;
+    }
+    /** obtain a random positive integer. */
+    integer() {
+        return Math.floor(this.random() * 2147483647);
+    }
+    /** return true or false, given a 0 to 1 probability fraction. */
+    roll(chance = 0.5) {
+        return this.random() <= chance;
+    }
+    /** generate a random number between two numbers. */
+    range(a, b) {
+        const difference = b - a;
+        const value = difference * this.random();
+        return a + value;
+    }
+    /** generate a random integer between two numbers (inclusive). */
+    integerRange(a, b) {
+        return Math.round(this.range(a, b));
+    }
+    /** randomly choose an index given an array length. */
+    index(length) {
+        return Math.floor(this.random() * length);
+    }
+    /** return a random item from the given array. */
+    choose(array) {
+        return array[this.index(array.length)];
+    }
+    /** remove and return a random item from the given array. */
+    yoink(array) {
+        const index = this.index(array.length);
+        const [item] = array.splice(index, 1);
+        return item;
+    }
+    /** randomly select a number of array items. */
+    select(count, array) {
+        const copy = [...array];
+        if (count >= array.length)
+            return copy;
+        const selection = [];
+        for (let i = 0; i < count; i++)
+            selection.push(this.yoink(copy));
+        return selection;
+    }
+    /** remove and return a number of items from the given array. */
+    take(count, array) {
+        const selection = [];
+        for (let i = 0; i < count; i++) {
+            if (array.length === 0)
+                return selection;
+            selection.push(this.yoink(array));
+        }
+        return selection;
+    }
+    /** shuffle an array in-place using (fisher-yates) */
+    shuffle(array) {
+        for (let i = array.length - 1; i > 0; i--) {
+            const j = Math.floor(this.random() * (i + 1));
+            [array[i], array[j]] = [array[j], array[i]];
+        }
+        return array;
+    }
+    /** @deprecated create an instance with the given seed number. */
+    static seed(seed) {
+        return new this(seed);
+    }
+    /** @deprecated renamed to `take` */
+    extract(count, array) { return this.take(count, array); }
+    /** @deprecated renamed to `range` */
+    between(a, b) { return this.range(a, b); }
+    /** @deprecated renamed to `integerRange` */
+    integerBetween(a, b) { return this.integerRange(a, b); }
+}
+//# sourceMappingURL=randy.js.map

package/x/concepts/randy.js.map

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

package/x/concepts/scalar.d.ts

@@ -0,0 +1,51 @@
+export declare class Scalar {
+    x: number;
+    constructor(x: number);
+    static new(x: number): Scalar;
+    clone(): Scalar;
+    set(x: number): this;
+    static isBetween(x: number, a?: number, b?: number): boolean;
+    isBetween(a?: number, b?: number): boolean;
+    static isNear(x: number, y: number, epsilon?: number): boolean;
+    isNear(y: number, epsilon?: number): boolean;
+    static add(...nums: number[]): number;
+    add(...nums: number[]): this;
+    subtract(...nums: number[]): this;
+    static min(x: number, minimum?: number): number;
+    min(minimum?: number): this;
+    static max(x: number, maximum?: number): number;
+    max(maximum?: number): this;
+    static clamp(x: number, a?: number, b?: number): number;
+    clamp(a?: number, b?: number): this;
+    static lerp(x: number, y: number, fraction: number, max?: number): number;
+    lerp(y: number, fraction: number, max?: number): this;
+    static step(x: number, y: number, delta: number): number;
+    step(y: number, delta: number): this;
+    static creep(difference: number, speed: number, deltaTime: number, speedLimit?: number): number;
+    static approach(x: number, y: number, speed: number, deltaTime: number, speedLimit?: number): number;
+    approach(y: number, speed: number, deltaTime: number, speedLimit?: number): this;
+    static wrap(x: number, a?: number, b?: number): number;
+    wrap(a?: number, b?: number): this;
+    static constrainProximity(x: number, y: number, range: number): number;
+    constrainProximity(y: number, range: number): this;
+    static inverse(x: number): number;
+    inverse(): this;
+    static center(x: number): number;
+    center(): this;
+    static uncenter(x: number): number;
+    uncenter(): this;
+    static map(x: number, a: number, b: number): number;
+    map(a: number, b: number): this;
+    static remap(x: number, a1: number, a2: number, b1?: number, b2?: number, clamp?: boolean): number;
+    remap(a1: number, a2: number, b1?: number, b2?: number, clamp?: boolean): this;
+    static magnify(x: number): number;
+    magnify(): this;
+    static floor(x: number): number;
+    floor(): this;
+    static ceil(x: number): number;
+    ceil(): this;
+    static round(x: number): number;
+    round(): this;
+    static smooth(x: number, y: number, smoothing: number): number;
+    smooth(y: number, smoothing: number): this;
+}

package/x/concepts/scalar.js

@@ -0,0 +1,219 @@
+export class Scalar {
+    x;
+    constructor(x) {
+        this.x = x;
+    }
+    static new(x) {
+        return new this(x);
+    }
+    clone() {
+        return new Scalar(this.x);
+    }
+    set(x) {
+        this.x = x;
+        return this;
+    }
+    //
+    // queries
+    //
+    static isBetween(x, a = 0, b = 1) {
+        const min = Math.min(a, b);
+        const max = Math.max(a, b);
+        return (x >= min) && (x <= max);
+    }
+    isBetween(a = 0, b = 1) {
+        return Scalar.isBetween(this.x, a, b);
+    }
+    static isNear(x, y, epsilon = 0.01) {
+        return Math.abs(x - y) <= epsilon;
+    }
+    isNear(y, epsilon = 0.01) {
+        return Scalar.isNear(this.x, y, epsilon);
+    }
+    //
+    // chainable transforms
+    //
+    static add(...nums) {
+        let x = 0;
+        for (const n of nums)
+            x += n;
+        return x;
+    }
+    add(...nums) {
+        this.x = Scalar.add(...nums);
+        return this;
+    }
+    subtract(...nums) {
+        for (const n of nums)
+            this.x -= n;
+        return this;
+    }
+    static min(x, minimum = 0) {
+        return Math.max(x, minimum);
+    }
+    min(minimum = 0) {
+        this.x = Scalar.min(this.x, minimum);
+        return this;
+    }
+    static max(x, maximum = 1) {
+        return Math.min(x, maximum);
+    }
+    max(maximum = 1) {
+        this.x = Scalar.max(this.x, maximum);
+        return this;
+    }
+    static clamp(x, a = 0, b = 1) {
+        x = Scalar.min(x, Math.min(a, b));
+        x = Scalar.max(x, Math.max(a, b));
+        return x;
+    }
+    clamp(a = 0, b = 1) {
+        this.x = Scalar.clamp(this.x, a, b);
+        return this;
+    }
+    static lerp(x, y, fraction, max) {
+        const difference = y - x;
+        let delta = difference * fraction;
+        if (max !== undefined && Math.abs(delta) > max)
+            delta = Math.sign(delta) * max;
+        return x + delta;
+    }
+    lerp(y, fraction, max) {
+        this.x = Scalar.lerp(this.x, y, fraction, max);
+        return this;
+    }
+    static step(x, y, delta) {
+        const difference = y - x;
+        return (Math.abs(difference) <= delta)
+            ? y
+            : x + (Math.sign(difference) * delta);
+    }
+    step(y, delta) {
+        this.x = Scalar.step(this.x, y, delta);
+        return this;
+    }
+    static creep(difference, speed, deltaTime, speedLimit) {
+        let change = (difference * (1 - Math.exp(-speed * deltaTime)));
+        if (speedLimit !== undefined) {
+            const changeLimit = speedLimit * deltaTime;
+            if (Math.abs(change) > changeLimit)
+                change = Math.sign(change) * changeLimit;
+        }
+        return change;
+    }
+    static approach(x, y, speed, deltaTime, speedLimit) {
+        const difference = y - x;
+        const change = this.creep(difference, speed, deltaTime, speedLimit);
+        return x + change;
+    }
+    approach(y, speed, deltaTime, speedLimit) {
+        this.x = Scalar.approach(this.x, y, speed, deltaTime, speedLimit);
+        return this;
+    }
+    static wrap(x, a = 0, b = 1) {
+        const min = Math.min(a, b);
+        const max = Math.max(a, b);
+        const span = max - min;
+        const adjusted = x - min;
+        const wrapped = (adjusted < 0)
+            ? span - (-adjusted % span)
+            : adjusted % span;
+        return min + wrapped;
+    }
+    wrap(a = 0, b = 1) {
+        this.x = Scalar.wrap(this.x, a, b);
+        return this;
+    }
+    static constrainProximity(x, y, range) {
+        const trueDiff = y - x;
+        const positiveDiff = Math.abs(trueDiff);
+        const cappedDiff = (positiveDiff > range)
+            ? range
+            : positiveDiff;
+        const newDiff = (trueDiff < 0) ? -cappedDiff : cappedDiff;
+        return x + newDiff;
+    }
+    constrainProximity(y, range) {
+        this.x = Scalar.constrainProximity(this.x, y, range);
+        return this;
+    }
+    static inverse(x) {
+        return 1 - x;
+    }
+    inverse() {
+        this.x = Scalar.inverse(this.x);
+        return this;
+    }
+    static center(x) {
+        return (x * 2) - 1;
+    }
+    center() {
+        this.x = Scalar.center(this.x);
+        return this;
+    }
+    static uncenter(x) {
+        return (x + 1) / 2;
+    }
+    uncenter() {
+        this.x = Scalar.uncenter(this.x);
+        return this;
+    }
+    static map(x, a, b) {
+        const difference = b - a;
+        const value = difference * x;
+        return a + value;
+    }
+    map(a, b) {
+        this.x = Scalar.map(this.x, a, b);
+        return this;
+    }
+    static remap(x, a1, a2, b1 = 0, b2 = 1, clamp = false) {
+        const fraction = (x - a1) / (a2 - a1);
+        const result = (fraction * (b2 - b1)) + b1;
+        return clamp
+            ? Scalar.clamp(result, b1, b2)
+            : result;
+    }
+    remap(a1, a2, b1 = 0, b2 = 1, clamp = false) {
+        this.x = Scalar.remap(this.x, a1, a2, b1, b2, clamp);
+        return this;
+    }
+    static magnify(x) {
+        return 4 * Math.pow(x - 0.5, 3) + 0.5;
+    }
+    magnify() {
+        this.x = Scalar.magnify(this.x);
+        return this;
+    }
+    static floor(x) {
+        return Math.floor(x);
+    }
+    floor() {
+        this.x = Scalar.floor(this.x);
+        return this;
+    }
+    static ceil(x) {
+        return Math.ceil(x);
+    }
+    ceil() {
+        this.x = Scalar.ceil(this.x);
+        return this;
+    }
+    static round(x) {
+        return Math.round(x);
+    }
+    round() {
+        this.x = Scalar.round(this.x);
+        return this;
+    }
+    static smooth(x, y, smoothing) {
+        return smoothing <= 1
+            ? y
+            : x + ((y - x) / smoothing);
+    }
+    smooth(y, smoothing) {
+        this.x = Scalar.smooth(this.x, y, smoothing);
+        return this;
+    }
+}
+//# sourceMappingURL=scalar.js.map

package/x/concepts/scalar.js.map

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

package/x/concepts/spline.d.ts

@@ -0,0 +1,9 @@
+import { Vec2Array } from "./vec2.js";
+/** resolve a number within a linear spline. */
+export declare function linear(x: number, points: Vec2Array[]): number;
+/** resolve a number within a catmull-rom spline, that's all smooth-like. */
+export declare function catmullRom(x: number, points: Vec2Array[]): number;
+export declare const ez: {
+    /** simple linear spline where the control points are equally-spaced based on their array indices (x is expected to be between 0 and 1). */
+    linear(x: number, points: number[]): number;
+};

package/x/concepts/spline.js

@@ -0,0 +1,59 @@
+import { Scalar } from "./scalar.js";
+/** resolve a number within a linear spline. */
+export function linear(x, points) {
+    if (points.length < 2)
+        throw new Error("need at least two points, come on");
+    const [first] = points.at(0);
+    const [last] = points.at(-1);
+    x = Scalar.clamp(x, first, last);
+    for (let i = 0; i < points.length - 1; i++) {
+        const [x0, y0] = points[i];
+        const [x1, y1] = points[i + 1];
+        if (x >= x0 && x <= x1) {
+            const t = (x - x0) / (x1 - x0);
+            return y0 + t * (y1 - y0);
+        }
+    }
+    throw new Error("x is out of bounds, what are you even doing");
+}
+/** resolve a number within a catmull-rom spline, that's all smooth-like. */
+export function catmullRom(x, points) {
+    if (points.length < 4)
+        throw new Error("need at least four points for this magic");
+    x = Scalar.clamp(x);
+    // find the segment where 'x' fits
+    for (let i = 1; i < points.length - 2; i++) {
+        const [x1,] = points[i];
+        const [x2,] = points[i + 1];
+        if (x >= x1 && x <= x2) {
+            const t = (x - x1) / (x2 - x1);
+            return helpers.catmullRom(t, points[i - 1], points[i], points[i + 1], points[i + 2]);
+        }
+    }
+    throw new Error("x is out of bounds, try again");
+}
+export const ez = {
+    /** simple linear spline where the control points are equally-spaced based on their array indices (x is expected to be between 0 and 1). */
+    linear(x, points) {
+        if (points.length < 2)
+            throw new Error("need at least two points, come on");
+        const points2 = points.map((p, index) => [Scalar.clamp(index / (points.length - 1)), p]);
+        return linear(Scalar.clamp(x), points2);
+    }
+};
+var helpers;
+(function (helpers) {
+    /** internal big-brain maths for the catmull-rom implementation */
+    function catmullRom(t, [, p0], [, p1], [, p2], [, p3]) {
+        const t2 = t * t;
+        const t3 = t2 * t;
+        // coefficients for the cubic polynomial (Catmull-Rom)
+        const a = -0.5 * p0 + 1.5 * p1 - 1.5 * p2 + 0.5 * p3;
+        const b = p0 - 2.5 * p1 + 2 * p2 - 0.5 * p3;
+        const c = -0.5 * p0 + 0.5 * p2;
+        const d = p1;
+        return a * t3 + b * t2 + c * t + d;
+    }
+    helpers.catmullRom = catmullRom;
+})(helpers || (helpers = {}));
+//# sourceMappingURL=spline.js.map

package/x/concepts/spline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spline.js","sourceRoot":"","sources":["../../s/concepts/spline.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAA;AAGlC,+CAA+C;AAC/C,MAAM,UAAU,MAAM,CAAC,CAAS,EAAE,MAAmB;IACpD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;IAErD,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAE,CAAA;IAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAA;IAE7B,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;IAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QAC1B,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QAE9B,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;YAC9B,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;QAC1B,CAAC;IACF,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;AAC/D,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,MAAmB;IACxD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;IAE5D,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAEnB,kCAAkC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,CAAC,EAAE,EAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;QACxB,MAAM,CAAC,EAAE,EAAG,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QAE5B,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;YAC9B,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACrF,CAAC;IACF,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,CAAC,MAAM,EAAE,GAAG;IAEjB,2IAA2I;IAC3I,MAAM,CAAC,CAAS,EAAE,MAAgB;QACjC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;QAErD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CACzB,CAAC,CAAC,EAAE,KAAK,EAAa,EAAE,CACvB,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAC/C,CAAA;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;IACxC,CAAC;CACD,CAAA;AAED,IAAU,OAAO,CAsBhB;AAtBD,WAAU,OAAO;IAEhB,kEAAkE;IAClE,SAAgB,UAAU,CACxB,CAAS,EACT,CAAC,EAAC,EAAE,CAAY,EAChB,CAAC,EAAC,EAAE,CAAY,EAChB,CAAC,EAAC,EAAE,CAAY,EAChB,CAAC,EAAC,EAAE,CAAY;QAGjB,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAA;QAChB,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;QAEjB,sDAAsD;QACtD,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,CAAA;QACpD,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,CAAA;QAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,CAAA;QAC9B,MAAM,CAAC,GAAG,EAAE,CAAA;QAEZ,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACnC,CAAC;IAlBe,kBAAU,aAkBzB,CAAA;AACF,CAAC,EAtBS,OAAO,KAAP,OAAO,QAsBhB"}