@rafaelaugusto/jolt 0.1.0-beta.9 → 0.1.0-rc.2

package/dist/testing/trace.js

@@ -0,0 +1,263 @@
+const MAX_ENTRIES = 5_000;
+const MAX_TIME = 300_000;
+const MAX_BYTES = 2_000_000;
+function object(value, fields) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new TypeError('Expected a trace object.');
+    const result = value;
+    if (Object.keys(result).length !== fields.length ||
+        Object.keys(result).some((key) => !fields.includes(key)))
+        throw new TypeError('Unknown or missing trace fields. Text and image payloads are not accepted.');
+    return result;
+}
+function number(value, min = -1e9, max = 1e9) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < min || value > max)
+        throw new RangeError('Trace numbers must be finite and within their limits.');
+    return value;
+}
+function integer(value, min = 0, max = 0xffffffff) {
+    const n = number(value, min, max);
+    if (!Number.isInteger(n))
+        throw new TypeError('Expected a trace integer.');
+    return n;
+}
+function choice(value, values) {
+    if (!values.includes(value))
+        throw new TypeError('Unknown trace enum value.');
+    return value;
+}
+function id(value) {
+    if (typeof value !== 'string' || !/^[a-zA-Z][a-zA-Z0-9_.-]{0,63}$/.test(value))
+        throw new TypeError('Use a stable, non-personal ASCII view ID (1–64 characters).');
+    return value;
+}
+function label(value) {
+    if (typeof value !== 'string' || !/^[a-zA-Z0-9 ._(),+-]{1,80}$/.test(value))
+        throw new TypeError('Invalid OS/model metadata.');
+    return value;
+}
+function list(value, max) {
+    if (!Array.isArray(value) || value.length > max)
+        throw new TypeError('Invalid or oversized trace array.');
+    return value;
+}
+function state(value) {
+    const v = object(value, ['position', 'velocity', 'settled']);
+    if (typeof v.settled !== 'boolean')
+        throw new TypeError('Expected a settled boolean.');
+    return {
+        position: number(v.position),
+        velocity: number(v.velocity),
+        settled: v.settled,
+    };
+}
+function tolerance(value) {
+    const v = object(value, ['position', 'velocity']);
+    return { position: number(v.position, 0, 100), velocity: number(v.velocity, 0, 1000) };
+}
+function input(value, ids) {
+    if (!value || typeof value !== 'object')
+        throw new TypeError('Invalid trace input.');
+    const type = value.type;
+    const fields = {
+        target: ['type', 'id', 'value'],
+        gesture: ['type', 'id', 'phase', 'x', 'y', 'velocityX', 'velocityY', 'pointers'],
+        layout: ['type', 'id', 'x', 'y', 'width', 'height'],
+        scroll: ['type', 'id', 'offset'],
+        keyboard: ['type', 'inset'],
+        lifecycle: ['type', 'state'],
+    };
+    if (typeof type !== 'string' || !Object.hasOwn(fields, type))
+        throw new TypeError('Unknown trace input type.');
+    const v = object(value, fields[type]);
+    const target = type === 'keyboard' || type === 'lifecycle' ? '' : id(v.id);
+    if (target && !ids.has(target))
+        throw new TypeError('Trace input references an unknown view ID.');
+    switch (type) {
+        case 'target':
+            return { type, id: target, value: number(v.value) };
+        case 'gesture': {
+            const pointers = list(v.pointers, 10).map((p) => integer(p, 0, 255));
+            if (new Set(pointers).size !== pointers.length)
+                throw new TypeError('Repeated pointer ID.');
+            return {
+                type,
+                id: target,
+                phase: choice(v.phase, ['begin', 'move', 'end', 'cancel']),
+                x: number(v.x),
+                y: number(v.y),
+                velocityX: number(v.velocityX),
+                velocityY: number(v.velocityY),
+                pointers,
+            };
+        }
+        case 'layout':
+            return {
+                type,
+                id: target,
+                x: number(v.x),
+                y: number(v.y),
+                width: number(v.width, 0, 100_000),
+                height: number(v.height, 0, 100_000),
+            };
+        case 'scroll':
+            return { type, id: target, offset: number(v.offset) };
+        case 'keyboard':
+            return { type, inset: number(v.inset, 0, 100_000) };
+        default:
+            return {
+                type: 'lifecycle',
+                state: choice(v.state, ['suspend', 'resume', 'unload', 'load']),
+            };
+    }
+}
+/** Strictly validates and copies a v1 trace. Unknown fields fail instead of leaking content. */
+export function parseTrace(value) {
+    if (typeof value === 'string') {
+        if (value.length > MAX_BYTES)
+            throw new RangeError('Trace exceeds 2 MB.');
+        value = JSON.parse(value);
+    }
+    const v = object(value, [
+        'version',
+        'seed',
+        'settings',
+        'metadata',
+        'motions',
+        'entries',
+    ]);
+    if (v.version !== 1)
+        throw new TypeError('Unsupported interaction trace version.');
+    const settings = object(v.settings, ['timeScale', 'reducedMotion']);
+    if (typeof settings.reducedMotion !== 'boolean')
+        throw new TypeError('Invalid Reduced Motion setting.');
+    const m = object(v.metadata, [
+        'platform',
+        'os',
+        'model',
+        'refreshRate',
+        'density',
+        'width',
+        'height',
+    ]);
+    const metadata = {
+        platform: choice(m.platform, ['ios', 'android', 'test']),
+        os: label(m.os),
+        model: label(m.model),
+        refreshRate: number(m.refreshRate, 1, 1000),
+        density: number(m.density, 0.1, 20),
+        width: number(m.width, 1, 100_000),
+        height: number(m.height, 1, 100_000),
+    };
+    const motions = list(v.motions, 32).map((raw) => {
+        const p = object(raw, [
+            'id',
+            'kind',
+            'axis',
+            'initial',
+            'stiffness',
+            'damping',
+            'mass',
+            'min',
+            'max',
+            'snap',
+        ]);
+        const min = number(p.min), max = number(p.max, min);
+        return {
+            id: id(p.id),
+            kind: choice(p.kind, ['spring', 'drag']),
+            axis: choice(p.axis, ['x', 'y']),
+            initial: number(p.initial, min, max),
+            stiffness: number(p.stiffness, 0.001, 100_000),
+            damping: number(p.damping, 0, 10_000),
+            mass: number(p.mass, 0.001, 1000),
+            min,
+            max,
+            snap: list(p.snap, 64).map((s) => number(s, min, max)),
+        };
+    });
+    const ids = new Set(motions.map((motion) => motion.id));
+    if (!motions.length || ids.size !== motions.length)
+        throw new TypeError('Trace needs unique view identities.');
+    let previous = 0;
+    const entries = list(v.entries, MAX_ENTRIES).map((raw) => {
+        const sample = raw && typeof raw === 'object' && Object.hasOwn(raw, 'expected');
+        const e = object(raw, sample ? ['at', 'id', 'expected', 'tolerance'] : ['at', 'input']);
+        const at = number(e.at, previous, MAX_TIME);
+        previous = at;
+        if (!sample)
+            return { at, input: input(e.input, ids) };
+        const target = id(e.id);
+        if (!ids.has(target))
+            throw new TypeError('Checkpoint references an unknown view ID.');
+        return {
+            at,
+            id: target,
+            expected: state(e.expected),
+            tolerance: tolerance(e.tolerance),
+        };
+    });
+    return {
+        version: 1,
+        seed: integer(v.seed),
+        settings: {
+            timeScale: number(settings.timeScale, 0.001, 100),
+            reducedMotion: settings.reducedMotion,
+        },
+        metadata,
+        motions,
+        entries,
+    };
+}
+/** Caller supplies a monotonic clock and explicitly chooses which semantic inputs to record. */
+export function recordInteraction(options) {
+    const trace = parseTrace({
+        version: 1,
+        seed: options.seed,
+        settings: options.settings,
+        metadata: options.metadata,
+        motions: options.motions,
+        entries: [],
+    });
+    const start = number(options.now(), -Number.MAX_SAFE_INTEGER, Number.MAX_SAFE_INTEGER);
+    let stopped = false;
+    const append = (entry) => {
+        if (stopped)
+            throw new Error('Trace recording has stopped.');
+        // Validate before retaining anything; never retain arbitrary input objects.
+        const candidate = {
+            ...trace,
+            entries: [
+                {
+                    ...entry,
+                    at: number(options.now() - start, trace.entries.at(-1)?.at ?? 0, MAX_TIME),
+                },
+            ],
+        };
+        if (trace.entries.length === MAX_ENTRIES)
+            throw new RangeError('Trace entry limit reached.');
+        trace.entries.push(parseTrace(candidate).entries[0]);
+    };
+    return {
+        input: (event) => append({ input: event }),
+        checkpoint: (id, expected, tolerance = { position: 3, velocity: 30 }) => append({ id, expected, tolerance }),
+        get size() {
+            return trace.entries.length;
+        },
+        stop() {
+            stopped = true;
+            return parseTrace(trace);
+        },
+    };
+}
+/** A local PRNG: replay never changes Math.random or the application's global seed. */
+export function traceRandom(seed) {
+    let value = integer(seed);
+    return () => {
+        value = (value + 0x6d2b79f5) >>> 0;
+        let n = Math.imul(value ^ (value >>> 15), value | 1);
+        n ^= n + Math.imul(n ^ (n >>> 7), n | 61);
+        return ((n ^ (n >>> 14)) >>> 0) / 4294967296;
+    };
+}
+//# sourceMappingURL=trace.js.map

package/dist/testing/trace.js.map

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

package/dist/timed-animation.d.ts

@@ -0,0 +1,38 @@
+import { type PlaybackAnimation, type PlaybackCommand } from './playback.js';
+/** A sampled resource's control clock. Native sinks play frames; JS runs only at boundaries. */
+export declare class TimedAnimation implements PlaybackAnimation {
+    readonly duration: number;
+    private readonly arrival;
+    private readonly update;
+    private readonly finish;
+    readonly finished: Promise<boolean>;
+    private resolve;
+    private arrive;
+    private readonly clock;
+    private readonly notifyPlayback;
+    private readonly listeners;
+    private cancelEnd?;
+    private cancelArrival?;
+    private _paused;
+    private settled;
+    private completed;
+    private arrived;
+    private active;
+    constructor(duration: number, arrival: number, update: (time: number, paused: boolean, command: PlaybackCommand) => void, finish: (completed: boolean) => void);
+    get time(): number;
+    get paused(): boolean;
+    get done(): boolean;
+    get progress(): number;
+    set progress(value: number);
+    start(): void;
+    pause(): void;
+    play(): void;
+    seekTime(time: number): void;
+    stop(): void;
+    then<A = boolean, B = never>(onfulfilled?: ((value: boolean) => A | PromiseLike<A>) | null, onrejected?: ((reason: unknown) => B | PromiseLike<B>) | null): Promise<A | B>;
+    private notify;
+    private cancelTimers;
+    private schedule;
+    private settle;
+}
+//# sourceMappingURL=timed-animation.d.ts.map

package/dist/timed-animation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timed-animation.d.ts","sourceRoot":"","sources":["../src/timed-animation.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,eAAe,CAAA;AAEtB,gGAAgG;AAChG,qBAAa,cAAe,YAAW,iBAAiB;IAgBpD,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAKvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAtBzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IACnC,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAA;IACtB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,aAAa,CAAC,CAAY;IAClC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAQ;IAEtB,YACW,QAAQ,EAAE,MAAM,EACR,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CACvB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,eAAe,KACrB,IAAI,EACQ,MAAM,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,EAkCtD;IAED,IAAI,IAAI,WAEP;IACD,IAAI,MAAM,YAET;IACD,IAAI,IAAI,YAEP;IACD,IAAI,QAAQ,IAKQ,MAAM,CADzB;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAGzB;IAED,KAAK,SAKJ;IAED,KAAK,SAOJ;IAED,IAAI,SAOH;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,QAQpB;IAED,IAAI,SAEH;IAED,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,KAAK,EACzB,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAC7D,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAC5D,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAEhB;IAED,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,QAAQ;IAuBhB,OAAO,CAAC,MAAM;CAuBf"}

package/dist/timed-animation.js

@@ -0,0 +1,177 @@
+import { getDriver } from './driver/index.js';
+import { Trace } from '@nativescript/core';
+import { setArrival, setArrivalTiming } from './engine.js';
+import { createClock, registerPlayback, validateProgress, } from './playback.js';
+/** A sampled resource's control clock. Native sinks play frames; JS runs only at boundaries. */
+export class TimedAnimation {
+    duration;
+    arrival;
+    update;
+    finish;
+    finished;
+    resolve;
+    arrive;
+    clock;
+    notifyPlayback;
+    listeners = new Set();
+    cancelEnd;
+    cancelArrival;
+    _paused = false;
+    settled = false;
+    completed = false;
+    arrived = false;
+    active = false;
+    constructor(duration, arrival, update, finish) {
+        this.duration = duration;
+        this.arrival = arrival;
+        this.update = update;
+        this.finish = finish;
+        const driver = getDriver();
+        this.clock = driver.clock?.(duration) ?? createClock(() => driver.now());
+        this.finished = new Promise((resolve) => {
+            this.resolve = resolve;
+        });
+        setArrival(this, new Promise((resolve) => {
+            this.arrive = resolve;
+        }));
+        this.notifyPlayback = registerPlayback(this, () => ({
+            time: this.time,
+            duration,
+            paused: this._paused,
+            ready: this.active,
+            settled: this.settled,
+            completed: this.completed,
+        }));
+        setArrivalTiming(this, {
+            read: () => ({
+                remaining: Math.max(0, arrival - this.time),
+                paused: this.paused,
+                arrived: this.arrived,
+            }),
+            subscribe: (callback) => {
+                this.listeners.add(callback);
+                return () => {
+                    this.listeners.delete(callback);
+                };
+            },
+        });
+    }
+    get time() {
+        return Math.max(0, Math.min(this.duration, this.clock.time()));
+    }
+    get paused() {
+        return this._paused;
+    }
+    get done() {
+        return this.settled;
+    }
+    get progress() {
+        if (!Number.isFinite(this.duration))
+            throw new RangeError('Progress requires a finite animation.');
+        return this.completed ? 1 : this.duration ? this.time / this.duration : 0;
+    }
+    set progress(value) {
+        validateProgress(value, this.duration);
+        this.seekTime(value * this.duration);
+    }
+    start() {
+        if (this.active || this.settled)
+            return;
+        this.active = true;
+        this.schedule();
+        this.notify();
+    }
+    pause() {
+        if (this._paused || this.settled)
+            return;
+        this.clock.pause();
+        this._paused = true;
+        this.cancelTimers();
+        this.update(this.time, true, 'pause');
+        this.notify();
+    }
+    play() {
+        if (!this._paused || this.settled)
+            return;
+        this._paused = false;
+        this.clock.play();
+        this.update(this.time, false, 'play');
+        this.schedule();
+        this.notify();
+    }
+    seekTime(time) {
+        if (!Number.isFinite(time) || time < 0)
+            throw new RangeError('Seek time must be finite and nonnegative.');
+        if (this.settled)
+            return;
+        this.clock.seek(Math.min(this.duration, time));
+        this.update(this.time, this._paused, 'seek');
+        this.schedule();
+        this.notify();
+    }
+    stop() {
+        this.settle(false);
+    }
+    then(onfulfilled, onrejected) {
+        return this.finished.then(onfulfilled, onrejected);
+    }
+    notify() {
+        this.notifyPlayback();
+        for (const callback of [...this.listeners])
+            callback();
+    }
+    cancelTimers() {
+        this.cancelEnd?.();
+        this.cancelArrival?.();
+        this.cancelEnd = this.cancelArrival = undefined;
+    }
+    schedule() {
+        this.cancelTimers();
+        if (!this.active || this._paused || this.settled)
+            return;
+        const driver = getDriver();
+        if (Number.isFinite(this.duration)) {
+            const remaining = this.duration - this.time;
+            if (remaining <= 0) {
+                this.settle(true);
+                return;
+            }
+            this.cancelEnd = driver.after(remaining, () => this.settle(true));
+        }
+        if (!this.arrived && Number.isFinite(this.arrival)) {
+            const remaining = this.arrival - this.time;
+            const arrive = () => {
+                this.arrived = true;
+                this.arrive();
+                this.notify();
+            };
+            if (remaining <= 0)
+                arrive();
+            else
+                this.cancelArrival = driver.after(remaining, arrive);
+        }
+    }
+    settle(completed) {
+        if (this.settled)
+            return;
+        this.settled = true;
+        this.completed = completed;
+        this.cancelTimers();
+        if (completed)
+            this.clock.seek(this.duration);
+        this.clock.cancel();
+        try {
+            this.finish(completed);
+        }
+        catch (error) {
+            this.completed = false;
+            Trace.write(`Jolt sampled playback failed: ${String(error)}`, Trace.categories.Error, Trace.messageType.error);
+        }
+        this.arrived = true;
+        this.arrive();
+        this.notify();
+        this.resolve(this.completed);
+        this.listeners.clear();
+    }
+}
+//# sourceMappingURL=timed-animation.js.map

package/dist/timed-animation.js.map

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

package/dist/track.d.ts

@@ -1,3 +1,4 @@
+import { type SampledCurve } from './sampling.js';
 import { type Property } from './properties.js';
 import type { ResolvedTransition } from './transition.js';
 /**
@@ -20,6 +21,8 @@ export interface Track {
     readonly end: number;
     /** When it looks done: a spring is close to its target and stays there, long before it settles. */
     readonly arrival: number;
+    /** Setup diagnostics; absent on exact linear tracks and compound representations. */
+    readonly sampling?: SampledCurve['sampling'];
     valueAt(elapsed: number): number;
     /** Units per second. */
     velocityAt(elapsed: number): number;

package/dist/track.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../src/track.ts"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1D,OAAO,KAAK,EAAS,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAIhE;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,mGAAmG;IACnG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,wBAAwB;IACxB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;CACpC;AAcD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,MAAM,GACf,KAAK,CAmEP;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAgBrE"}
+{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../src/track.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AAI9D,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1D,OAAO,KAAK,EAA2B,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAIlF;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,mGAAmG;IACnG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAA;IAC5C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,wBAAwB;IACxB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;CACpC;AAeD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,MAAM,GACf,KAAK,CAoFP;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAgBrE"}