tone 14.8.27

package/build/esm/core/context/Context.js

@@ -0,0 +1,474 @@
+import { __awaiter } from "tslib";
+import { Ticker } from "../clock/Ticker";
+import { isAudioContext } from "../util/AdvancedTypeCheck";
+import { optionsFromArguments } from "../util/Defaults";
+import { Timeline } from "../util/Timeline";
+import { isDefined, isString } from "../util/TypeCheck";
+import { createAudioContext, createAudioWorkletNode, } from "./AudioContext";
+import { closeContext, initializeContext } from "./ContextInitialization";
+import { BaseContext } from "./BaseContext";
+import { assert } from "../util/Debug";
+/**
+ * Wrapper around the native AudioContext.
+ * @category Core
+ */
+export class Context extends BaseContext {
+    constructor() {
+        super();
+        this.name = "Context";
+        /**
+         * An object containing all of the constants AudioBufferSourceNodes
+         */
+        this._constants = new Map();
+        /**
+         * All of the setTimeout events.
+         */
+        this._timeouts = new Timeline();
+        /**
+         * The timeout id counter
+         */
+        this._timeoutIds = 0;
+        /**
+         * Private indicator if the context has been initialized
+         */
+        this._initialized = false;
+        /**
+         * Indicates if the context is an OfflineAudioContext or an AudioContext
+         */
+        this.isOffline = false;
+        //--------------------------------------------
+        // AUDIO WORKLET
+        //--------------------------------------------
+        /**
+         * Maps a module name to promise of the addModule method
+         */
+        this._workletModules = new Map();
+        const options = optionsFromArguments(Context.getDefaults(), arguments, [
+            "context",
+        ]);
+        if (options.context) {
+            this._context = options.context;
+        }
+        else {
+            this._context = createAudioContext({
+                latencyHint: options.latencyHint,
+            });
+        }
+        this._ticker = new Ticker(this.emit.bind(this, "tick"), options.clockSource, options.updateInterval);
+        this.on("tick", this._timeoutLoop.bind(this));
+        // fwd events from the context
+        this._context.onstatechange = () => {
+            this.emit("statechange", this.state);
+        };
+        this._setLatencyHint(options.latencyHint);
+        this.lookAhead = options.lookAhead;
+    }
+    static getDefaults() {
+        return {
+            clockSource: "worker",
+            latencyHint: "interactive",
+            lookAhead: 0.1,
+            updateInterval: 0.05,
+        };
+    }
+    /**
+     * Finish setting up the context. **You usually do not need to do this manually.**
+     */
+    initialize() {
+        if (!this._initialized) {
+            // add any additional modules
+            initializeContext(this);
+            this._initialized = true;
+        }
+        return this;
+    }
+    //---------------------------
+    // BASE AUDIO CONTEXT METHODS
+    //---------------------------
+    createAnalyser() {
+        return this._context.createAnalyser();
+    }
+    createOscillator() {
+        return this._context.createOscillator();
+    }
+    createBufferSource() {
+        return this._context.createBufferSource();
+    }
+    createBiquadFilter() {
+        return this._context.createBiquadFilter();
+    }
+    createBuffer(numberOfChannels, length, sampleRate) {
+        return this._context.createBuffer(numberOfChannels, length, sampleRate);
+    }
+    createChannelMerger(numberOfInputs) {
+        return this._context.createChannelMerger(numberOfInputs);
+    }
+    createChannelSplitter(numberOfOutputs) {
+        return this._context.createChannelSplitter(numberOfOutputs);
+    }
+    createConstantSource() {
+        return this._context.createConstantSource();
+    }
+    createConvolver() {
+        return this._context.createConvolver();
+    }
+    createDelay(maxDelayTime) {
+        return this._context.createDelay(maxDelayTime);
+    }
+    createDynamicsCompressor() {
+        return this._context.createDynamicsCompressor();
+    }
+    createGain() {
+        return this._context.createGain();
+    }
+    createIIRFilter(feedForward, feedback) {
+        // @ts-ignore
+        return this._context.createIIRFilter(feedForward, feedback);
+    }
+    createPanner() {
+        return this._context.createPanner();
+    }
+    createPeriodicWave(real, imag, constraints) {
+        return this._context.createPeriodicWave(real, imag, constraints);
+    }
+    createStereoPanner() {
+        return this._context.createStereoPanner();
+    }
+    createWaveShaper() {
+        return this._context.createWaveShaper();
+    }
+    createMediaStreamSource(stream) {
+        assert(isAudioContext(this._context), "Not available if OfflineAudioContext");
+        const context = this._context;
+        return context.createMediaStreamSource(stream);
+    }
+    createMediaElementSource(element) {
+        assert(isAudioContext(this._context), "Not available if OfflineAudioContext");
+        const context = this._context;
+        return context.createMediaElementSource(element);
+    }
+    createMediaStreamDestination() {
+        assert(isAudioContext(this._context), "Not available if OfflineAudioContext");
+        const context = this._context;
+        return context.createMediaStreamDestination();
+    }
+    decodeAudioData(audioData) {
+        return this._context.decodeAudioData(audioData);
+    }
+    /**
+     * The current time in seconds of the AudioContext.
+     */
+    get currentTime() {
+        return this._context.currentTime;
+    }
+    /**
+     * The current time in seconds of the AudioContext.
+     */
+    get state() {
+        return this._context.state;
+    }
+    /**
+     * The current time in seconds of the AudioContext.
+     */
+    get sampleRate() {
+        return this._context.sampleRate;
+    }
+    /**
+     * The listener
+     */
+    get listener() {
+        this.initialize();
+        return this._listener;
+    }
+    set listener(l) {
+        assert(!this._initialized, "The listener cannot be set after initialization.");
+        this._listener = l;
+    }
+    /**
+     * There is only one Transport per Context. It is created on initialization.
+     */
+    get transport() {
+        this.initialize();
+        return this._transport;
+    }
+    set transport(t) {
+        assert(!this._initialized, "The transport cannot be set after initialization.");
+        this._transport = t;
+    }
+    /**
+     * This is the Draw object for the context which is useful for synchronizing the draw frame with the Tone.js clock.
+     */
+    get draw() {
+        this.initialize();
+        return this._draw;
+    }
+    set draw(d) {
+        assert(!this._initialized, "Draw cannot be set after initialization.");
+        this._draw = d;
+    }
+    /**
+     * A reference to the Context's destination node.
+     */
+    get destination() {
+        this.initialize();
+        return this._destination;
+    }
+    set destination(d) {
+        assert(!this._initialized, "The destination cannot be set after initialization.");
+        this._destination = d;
+    }
+    /**
+     * Create an audio worklet node from a name and options. The module
+     * must first be loaded using [[addAudioWorkletModule]].
+     */
+    createAudioWorkletNode(name, options) {
+        return createAudioWorkletNode(this.rawContext, name, options);
+    }
+    /**
+     * Add an AudioWorkletProcessor module
+     * @param url The url of the module
+     * @param name The name of the module
+     */
+    addAudioWorkletModule(url, name) {
+        return __awaiter(this, void 0, void 0, function* () {
+            assert(isDefined(this.rawContext.audioWorklet), "AudioWorkletNode is only available in a secure context (https or localhost)");
+            if (!this._workletModules.has(name)) {
+                this._workletModules.set(name, this.rawContext.audioWorklet.addModule(url));
+            }
+            yield this._workletModules.get(name);
+        });
+    }
+    /**
+     * Returns a promise which resolves when all of the worklets have been loaded on this context
+     */
+    workletsAreReady() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const promises = [];
+            this._workletModules.forEach((promise) => promises.push(promise));
+            yield Promise.all(promises);
+        });
+    }
+    //---------------------------
+    // TICKER
+    //---------------------------
+    /**
+     * How often the interval callback is invoked.
+     * This number corresponds to how responsive the scheduling
+     * can be. context.updateInterval + context.lookAhead gives you the
+     * total latency between scheduling an event and hearing it.
+     */
+    get updateInterval() {
+        return this._ticker.updateInterval;
+    }
+    set updateInterval(interval) {
+        this._ticker.updateInterval = interval;
+    }
+    /**
+     * What the source of the clock is, either "worker" (default),
+     * "timeout", or "offline" (none).
+     */
+    get clockSource() {
+        return this._ticker.type;
+    }
+    set clockSource(type) {
+        this._ticker.type = type;
+    }
+    /**
+     * The type of playback, which affects tradeoffs between audio
+     * output latency and responsiveness.
+     * In addition to setting the value in seconds, the latencyHint also
+     * accepts the strings "interactive" (prioritizes low latency),
+     * "playback" (prioritizes sustained playback), "balanced" (balances
+     * latency and performance).
+     * @example
+     * // prioritize sustained playback
+     * const context = new Tone.Context({ latencyHint: "playback" });
+     * // set this context as the global Context
+     * Tone.setContext(context);
+     * // the global context is gettable with Tone.getContext()
+     * console.log(Tone.getContext().latencyHint);
+     */
+    get latencyHint() {
+        return this._latencyHint;
+    }
+    /**
+     * Update the lookAhead and updateInterval based on the latencyHint
+     */
+    _setLatencyHint(hint) {
+        let lookAheadValue = 0;
+        this._latencyHint = hint;
+        if (isString(hint)) {
+            switch (hint) {
+                case "interactive":
+                    lookAheadValue = 0.1;
+                    break;
+                case "playback":
+                    lookAheadValue = 0.5;
+                    break;
+                case "balanced":
+                    lookAheadValue = 0.25;
+                    break;
+            }
+        }
+        this.lookAhead = lookAheadValue;
+        this.updateInterval = lookAheadValue / 2;
+    }
+    /**
+     * The unwrapped AudioContext or OfflineAudioContext
+     */
+    get rawContext() {
+        return this._context;
+    }
+    /**
+     * The current audio context time plus a short [[lookAhead]].
+     */
+    now() {
+        return this._context.currentTime + this.lookAhead;
+    }
+    /**
+     * The current audio context time without the [[lookAhead]].
+     * In most cases it is better to use [[now]] instead of [[immediate]] since
+     * with [[now]] the [[lookAhead]] is applied equally to _all_ components including internal components,
+     * to making sure that everything is scheduled in sync. Mixing [[now]] and [[immediate]]
+     * can cause some timing issues. If no lookAhead is desired, you can set the [[lookAhead]] to `0`.
+     */
+    immediate() {
+        return this._context.currentTime;
+    }
+    /**
+     * Starts the audio context from a suspended state. This is required
+     * to initially start the AudioContext. See [[Tone.start]]
+     */
+    resume() {
+        if (isAudioContext(this._context)) {
+            return this._context.resume();
+        }
+        else {
+            return Promise.resolve();
+        }
+    }
+    /**
+     * Close the context. Once closed, the context can no longer be used and
+     * any AudioNodes created from the context will be silent.
+     */
+    close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (isAudioContext(this._context)) {
+                yield this._context.close();
+            }
+            if (this._initialized) {
+                closeContext(this);
+            }
+        });
+    }
+    /**
+     * **Internal** Generate a looped buffer at some constant value.
+     */
+    getConstant(val) {
+        if (this._constants.has(val)) {
+            return this._constants.get(val);
+        }
+        else {
+            const buffer = this._context.createBuffer(1, 128, this._context.sampleRate);
+            const arr = buffer.getChannelData(0);
+            for (let i = 0; i < arr.length; i++) {
+                arr[i] = val;
+            }
+            const constant = this._context.createBufferSource();
+            constant.channelCount = 1;
+            constant.channelCountMode = "explicit";
+            constant.buffer = buffer;
+            constant.loop = true;
+            constant.start(0);
+            this._constants.set(val, constant);
+            return constant;
+        }
+    }
+    /**
+     * Clean up. Also closes the audio context.
+     */
+    dispose() {
+        super.dispose();
+        this._ticker.dispose();
+        this._timeouts.dispose();
+        Object.keys(this._constants).map((val) => this._constants[val].disconnect());
+        return this;
+    }
+    //---------------------------
+    // TIMEOUTS
+    //---------------------------
+    /**
+     * The private loop which keeps track of the context scheduled timeouts
+     * Is invoked from the clock source
+     */
+    _timeoutLoop() {
+        const now = this.now();
+        let firstEvent = this._timeouts.peek();
+        while (this._timeouts.length && firstEvent && firstEvent.time <= now) {
+            // invoke the callback
+            firstEvent.callback();
+            // shift the first event off
+            this._timeouts.shift();
+            // get the next one
+            firstEvent = this._timeouts.peek();
+        }
+    }
+    /**
+     * A setTimeout which is guaranteed by the clock source.
+     * Also runs in the offline context.
+     * @param  fn       The callback to invoke
+     * @param  timeout  The timeout in seconds
+     * @returns ID to use when invoking Context.clearTimeout
+     */
+    setTimeout(fn, timeout) {
+        this._timeoutIds++;
+        const now = this.now();
+        this._timeouts.add({
+            callback: fn,
+            id: this._timeoutIds,
+            time: now + timeout,
+        });
+        return this._timeoutIds;
+    }
+    /**
+     * Clears a previously scheduled timeout with Tone.context.setTimeout
+     * @param  id  The ID returned from setTimeout
+     */
+    clearTimeout(id) {
+        this._timeouts.forEach((event) => {
+            if (event.id === id) {
+                this._timeouts.remove(event);
+            }
+        });
+        return this;
+    }
+    /**
+     * Clear the function scheduled by [[setInterval]]
+     */
+    clearInterval(id) {
+        return this.clearTimeout(id);
+    }
+    /**
+     * Adds a repeating event to the context's callback clock
+     */
+    setInterval(fn, interval) {
+        const id = ++this._timeoutIds;
+        const intervalFn = () => {
+            const now = this.now();
+            this._timeouts.add({
+                callback: () => {
+                    // invoke the callback
+                    fn();
+                    // invoke the event to repeat it
+                    intervalFn();
+                },
+                id,
+                time: now + interval,
+            });
+        };
+        // kick it off
+        intervalFn();
+        return id;
+    }
+}
+//# sourceMappingURL=Context.js.map

package/build/esm/core/context/Context.js.map

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

package/build/esm/core/context/ContextInitialization.d.ts

@@ -0,0 +1,15 @@
+declare type Context = import("./Context").Context;
+/**
+ * Used internally to setup a new Context
+ */
+export declare function onContextInit(cb: (ctx: Context) => void): void;
+/**
+ * Invoke any classes which need to also be initialized when a new context is created.
+ */
+export declare function initializeContext(ctx: Context): void;
+/**
+ * Used internally to tear down a Context
+ */
+export declare function onContextClose(cb: (ctx: Context) => void): void;
+export declare function closeContext(ctx: Context): void;
+export {};

package/build/esm/core/context/ContextInitialization.js

@@ -0,0 +1,35 @@
+//-------------------------------------
+// INITIALIZING NEW CONTEXT
+//-------------------------------------
+/**
+ * Array of callbacks to invoke when a new context is created
+ */
+const notifyNewContext = [];
+/**
+ * Used internally to setup a new Context
+ */
+export function onContextInit(cb) {
+    notifyNewContext.push(cb);
+}
+/**
+ * Invoke any classes which need to also be initialized when a new context is created.
+ */
+export function initializeContext(ctx) {
+    // add any additional modules
+    notifyNewContext.forEach(cb => cb(ctx));
+}
+/**
+ * Array of callbacks to invoke when a new context is closed
+ */
+const notifyCloseContext = [];
+/**
+ * Used internally to tear down a Context
+ */
+export function onContextClose(cb) {
+    notifyCloseContext.push(cb);
+}
+export function closeContext(ctx) {
+    // remove any additional modules
+    notifyCloseContext.forEach(cb => cb(ctx));
+}
+//# sourceMappingURL=ContextInitialization.js.map

package/build/esm/core/context/ContextInitialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextInitialization.js","sourceRoot":"","sources":["../../../../Tone/core/context/ContextInitialization.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,2BAA2B;AAC3B,uCAAuC;AAIvC;;GAEG;AACH,MAAM,gBAAgB,GAAkC,EAAE,CAAC;AAE3D;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,EAA0B;IACvD,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC7C,6BAA6B;IAC7B,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,kBAAkB,GAAkC,EAAE,CAAC;AAE7D;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,EAA0B;IACxD,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAY;IACxC,gCAAgC;IAChC,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/build/esm/core/context/Delay.d.ts

@@ -0,0 +1,58 @@
+import { Param } from "../context/Param";
+import { Seconds, Time } from "../type/Units";
+import { ToneAudioNode, ToneAudioNodeOptions } from "./ToneAudioNode";
+export interface DelayOptions extends ToneAudioNodeOptions {
+    delayTime: Time;
+    maxDelay: Time;
+}
+/**
+ * Wrapper around Web Audio's native [DelayNode](http://webaudio.github.io/web-audio-api/#the-delaynode-interface).
+ * @category Core
+ * @example
+ * return Tone.Offline(() => {
+ * 	const delay = new Tone.Delay(0.1).toDestination();
+ * 	// connect the signal to both the delay and the destination
+ * 	const pulse = new Tone.PulseOscillator().connect(delay).toDestination();
+ * 	// start and stop the pulse
+ * 	pulse.start(0).stop(0.01);
+ * }, 0.5, 1);
+ */
+export declare class Delay extends ToneAudioNode<DelayOptions> {
+    readonly name: string;
+    /**
+     * Private holder of the max delay time
+     */
+    private _maxDelay;
+    /**
+     * The amount of time the incoming signal is delayed.
+     * @example
+     * const delay = new Tone.Delay().toDestination();
+     * // modulate the delayTime between 0.1 and 1 seconds
+     * const delayLFO = new Tone.LFO(0.5, 0.1, 1).start().connect(delay.delayTime);
+     * const pulse = new Tone.PulseOscillator().connect(delay).start();
+     * // the change in delayTime causes the pitch to go up and down
+     */
+    readonly delayTime: Param<"time">;
+    /**
+     * Private reference to the internal DelayNode
+     */
+    private _delayNode;
+    readonly input: DelayNode;
+    readonly output: DelayNode;
+    /**
+     * @param delayTime The delay applied to the incoming signal.
+     * @param maxDelay The maximum delay time.
+     */
+    constructor(delayTime?: Time, maxDelay?: Time);
+    constructor(options?: Partial<DelayOptions>);
+    static getDefaults(): DelayOptions;
+    /**
+     * The maximum delay time. This cannot be changed after
+     * the value is passed into the constructor.
+     */
+    get maxDelay(): Seconds;
+    /**
+     * Clean up.
+     */
+    dispose(): this;
+}

package/build/esm/core/context/Delay.js

@@ -0,0 +1,58 @@
+import { Param } from "../context/Param";
+import { optionsFromArguments } from "../util/Defaults";
+import { readOnly } from "../util/Interface";
+import { ToneAudioNode } from "./ToneAudioNode";
+/**
+ * Wrapper around Web Audio's native [DelayNode](http://webaudio.github.io/web-audio-api/#the-delaynode-interface).
+ * @category Core
+ * @example
+ * return Tone.Offline(() => {
+ * 	const delay = new Tone.Delay(0.1).toDestination();
+ * 	// connect the signal to both the delay and the destination
+ * 	const pulse = new Tone.PulseOscillator().connect(delay).toDestination();
+ * 	// start and stop the pulse
+ * 	pulse.start(0).stop(0.01);
+ * }, 0.5, 1);
+ */
+export class Delay extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(Delay.getDefaults(), arguments, ["delayTime", "maxDelay"]));
+        this.name = "Delay";
+        const options = optionsFromArguments(Delay.getDefaults(), arguments, ["delayTime", "maxDelay"]);
+        const maxDelayInSeconds = this.toSeconds(options.maxDelay);
+        this._maxDelay = Math.max(maxDelayInSeconds, this.toSeconds(options.delayTime));
+        this._delayNode = this.input = this.output = this.context.createDelay(maxDelayInSeconds);
+        this.delayTime = new Param({
+            context: this.context,
+            param: this._delayNode.delayTime,
+            units: "time",
+            value: options.delayTime,
+            minValue: 0,
+            maxValue: this.maxDelay,
+        });
+        readOnly(this, "delayTime");
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            delayTime: 0,
+            maxDelay: 1,
+        });
+    }
+    /**
+     * The maximum delay time. This cannot be changed after
+     * the value is passed into the constructor.
+     */
+    get maxDelay() {
+        return this._maxDelay;
+    }
+    /**
+     * Clean up.
+     */
+    dispose() {
+        super.dispose();
+        this._delayNode.disconnect();
+        this.delayTime.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Delay.js.map

package/build/esm/core/context/Delay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Delay.js","sourceRoot":"","sources":["../../../../Tone/core/context/Delay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAwB,MAAM,iBAAiB,CAAC;AAOtE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,KAAM,SAAQ,aAA2B;IAiCrD;QACC,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QAhC/E,SAAI,GAAW,OAAO,CAAC;QAkC/B,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;QAEhG,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QAEhF,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QAEzF,IAAI,CAAC,SAAS,GAAG,IAAI,KAAK,CAAC;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,SAAS;YAChC,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,OAAO,CAAC,SAAS;YACxB,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACvB,CAAC,CAAC;QAEH,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE;YACjD,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,CAAC;SACX,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}