@intomind/sdk 0.0.0-stage → 1.4.1

package/dist/session.js

@@ -0,0 +1,523 @@
+/**
+ * One device, as a state machine.
+ *
+ * Bytes go in, events come out, and commands go back. Nothing here performs
+ * input or output, so the same code runs behind a browser's Bluetooth
+ * stack, a desktop one, or a test with no Bluetooth at all.
+ */
+import { CODE_BY_GAIN, CODE_BY_RATE, DeviceInfo, FILL, Invalid, continuity, decodeDeviceInfo, decodeEmbedding, decodePacket, decodePrediction, decodeResponse, decodeStatus, decodeTimeSync, encodeRequest, microvolts, BIAS_MODES, EMBEDDING_FORMS, IDENTIFY_MAX_SECONDS, INDICATOR_LEVELS, checkChain, encodeChain, encodePredictionInput, MODES, NAME_MAX_COMPOSED, PRODUCT_NAME, composeName, encodeModelInterval, encodeNameParts, nameFits, } from "./protocol.js";
+import { Exchange, Timebase } from "./timebase.js";
+/** Something a caller asked of a device that the device has not offered. */
+export class SessionError extends Error {
+    /** Build one with the message explaining what was asked for. */
+    constructor(message) {
+        super(message);
+        this.name = "SessionError";
+    }
+}
+/** The device has not said what it is yet, so nothing can be decoded. */
+export class NoDeviceInfo extends SessionError {
+    constructor() {
+        super("read device info first, so nothing has to be assumed");
+        this.name = "NoDeviceInfo";
+    }
+}
+/** The device does not claim the capability this needs. */
+export class NotCapable extends SessionError {
+    /** Which capability was missing. */
+    capability;
+    /** Build one naming the missing capability. */
+    constructor(capability) {
+        super(`this device does not claim the ${capability} capability`);
+        this.name = "NotCapable";
+        this.capability = capability;
+    }
+}
+/** A run of samples that arrived together. */
+export class Batch {
+    /** The device's own index for the first sample. */
+    index;
+    /** The device time of the first sample, in the device's ticks. */
+    deviceTime;
+    /** Channels per row. */
+    channels;
+    /** Converter counts, one row per sample, laid out row after row. */
+    counts;
+    /** Lead-off status latched with the most recent sample. */
+    leadoff;
+    /** Whether lead-off detection was running when these samples were taken, from the packet's flag. `leadoff` is zero both when every electrode was attached and when nothing was checking, and this tells the two apart. */
+    leadoffActive;
+    /** The gain the samples were taken at. */
+    gain;
+    /** The rate the samples were taken at, or null for a code this contract does not define. */
+    sampleRateHz;
+    /** The mode the samples were taken in: 0 normal, 1 test signal, 2 inputs shorted, 3 synthetic (1.3). */
+    mode;
+    /** 1.3: the samples were generated by the device, not measured (packet type 0x04). Never store one as a measurement. */
+    synthetic;
+    /** Build from decoded fields. `Session` is what calls this. */
+    constructor(f) {
+        this.index = f.index;
+        this.deviceTime = f.deviceTime;
+        this.channels = f.channels;
+        this.counts = f.counts;
+        this.leadoff = f.leadoff;
+        this.leadoffActive = f.leadoffActive ?? false;
+        this.gain = f.gain;
+        this.sampleRateHz = f.sampleRateHz;
+        this.mode = f.mode ?? 0;
+        this.synthetic = f.synthetic ?? false;
+    }
+    /** Samples in this batch. */
+    get rows() {
+        return this.channels === 0 ? 0 : this.counts.length / this.channels;
+    }
+    /** One converter count. */
+    count(row, channel) {
+        return this.counts[row * this.channels + channel];
+    }
+    /**
+     * One sample, in microvolts, with the device's own reference and width.
+     * Nothing is assumed about either.
+     */
+    microvolts(row, channel, info) {
+        return microvolts(this.count(row, channel), info.vrefUv, this.gain, info.adcBits);
+    }
+}
+/** One device. */
+export class Session {
+    #info = null;
+    #timebase = null;
+    #previous = null;
+    /** The first index and device time of the last few packets passed on, what a copy is recognized by. */
+    #recent = [];
+    /** Samples the device's own indexing says never arrived, over this session. */
+    samplesLost = 0;
+    /** Breaks counted as a re-base rather than a loss, over this session. */
+    rebases = 0;
+    /** Notifications that were not a message, over this session: see the "undecodable" event. */
+    undecodable = 0;
+    /** Data packets delivered twice by the host and dropped: see the "duplicate" event. */
+    duplicates = 0;
+    /** What was read from the device info characteristic. */
+    onDeviceInfo(bytes) {
+        const info = decodeDeviceInfo(bytes);
+        this.#timebase = new Timebase(info.tickHz);
+        this.#info = info;
+        return info;
+    }
+    /** What the device said it is, or null before it has been read. */
+    get info() {
+        return this.#info;
+    }
+    /** The same, for a caller that cannot proceed without it. */
+    requireInfo() {
+        if (this.#info === null)
+            throw new NoDeviceInfo();
+        return this.#info;
+    }
+    /**
+     * Whether the device claims a capability. A device that has not said what
+     * it is claims nothing.
+     */
+    can(capability) {
+        return this.#info?.can(capability) ?? false;
+    }
+    /** The timebase fit from time exchanges, or null before `onDeviceInfo`. */
+    get timebase() {
+        return this.#timebase;
+    }
+    /** Host time for a device time, once enough exchanges have been taken. */
+    hostTime(deviceTicks) {
+        return this.#timebase?.hostTime(deviceTicks) ?? null;
+    }
+    // --- commands -------------------------------------------------------------
+    #command(opcode, arg = null) {
+        return { characteristic: FILL.CONTROL, bytes: encodeRequest(opcode, arg), withResponse: true };
+    }
+    #require(capability) {
+        if (!this.can(capability))
+            throw new NotCapable(capability);
+    }
+    /** Whether the device claims a capability from the second word of Device Info (1.3): synthetic, device_name. */
+    canHigh(capability) {
+        return this.#info !== null && this.#info.can(capability);
+    }
+    #requireHigh(capability) {
+        if (!this.canHigh(capability))
+            throw new NotCapable(capability);
+    }
+    /** Ask the device to stream. */
+    startStream() {
+        return this.#command("start_stream");
+    }
+    /** Ask the device to stop streaming. */
+    stopStream() {
+        return this.#command("stop_stream");
+    }
+    /**
+     * Set the rate, in samples per second. The device refuses a change while
+     * it is streaming, so every sample of a recording sits under one
+     * configuration.
+     */
+    setRate(sps) {
+        const code = CODE_BY_RATE.get(sps);
+        if (code === undefined)
+            throw new Invalid(`${sps} samples per second is not a rate this contract defines`);
+        return this.#command("set_rate", code);
+    }
+    /** Set the gain. Refused while streaming. */
+    setGain(gain) {
+        const code = CODE_BY_GAIN.get(gain);
+        if (code === undefined)
+            throw new Invalid(`a gain of ${gain} is not one this contract defines`);
+        return this.#command("set_gain", code);
+    }
+    /**
+     * What the amplifier listens to: 0 the electrodes, 1 the internal test
+     * signal, 2 shorted inputs. The last two are capabilities a device
+     * declares, so a device that does not offer one is not asked for it.
+     */
+    setMode(mode) {
+        const code = typeof mode === "string" ? MODES[mode] : mode;
+        if (code === 1)
+            this.#require("test_signal");
+        else if (code === 2)
+            this.#require("input_short");
+        // 1.3: the device generates the signal, converter off. Only a device
+        // that claims it; the device itself refuses it while streaming and at a
+        // rate other than 500 samples a second.
+        else if (code === 3)
+            this.#requireHigh("synthetic");
+        else if (code !== 0)
+            throw new Invalid(`mode ${mode} is not one this contract defines`);
+        return this.#command("set_mode", code);
+    }
+    /** Turn lead-off detection on or off. */
+    setLeadoff(on) {
+        this.#require("leadoff");
+        return this.#command("set_leadoff", on ? 1 : 0);
+    }
+    /**
+     * Ask the device what time it is. Note the host clock either side and
+     * give both to `onTimeSync`.
+     */
+    timeSync() {
+        return this.#command("time_sync");
+    }
+    /** The answer to a time request, with the host clock either side of it. */
+    onTimeSync(payload, before, after) {
+        const ticks = decodeTimeSync(payload);
+        if (this.#timebase === null)
+            throw new NoDeviceInfo();
+        return this.#timebase.observe(new Exchange(before, after, ticks));
+    }
+    /** Zero the sample index and start a fresh epoch. */
+    resetEpoch() {
+        this.#previous = null;
+        return this.#command("reset_epoch");
+    }
+    /** Ask for the measured battery voltage and charge. */
+    getBattery() {
+        this.#require("battery_voltage");
+        return this.#command("get_battery");
+    }
+    /** Ask why and how many times the device has booted. */
+    getBootInfo() {
+        return this.#command("get_boot_info");
+    }
+    /** Turn predictions on or off. */
+    setPredictions(on) {
+        this.#require("model");
+        return this.#command("set_predictions", on ? 1 : 0);
+    }
+    /** Ask for the model runtime's state. */
+    getModelInfo() {
+        this.#require("model");
+        return this.#command("get_model_info");
+    }
+    /** Select a head slot. 0 is the built-in head. */
+    selectHead(slot) {
+        this.#require("heads");
+        return this.#command("select_head", slot);
+    }
+    /** Ask for the head slots and which one is selected. */
+    listHeads() {
+        this.#require("heads");
+        return this.#command("list_heads");
+    }
+    /**
+     * Ask which encoder each head names (1.4): one record for each LIST_HEADS record, read with `decodeHeadEncoders`.
+     * A device before 1.4 is not asked, and its heads say nothing of their encoder.
+     */
+    listHeadEncoders() {
+        this.#require("heads");
+        const [major, minor] = this.#info?.protocol ?? [0, 0];
+        if (major < 1 || (major === 1 && minor < 4))
+            throw new NotCapable("head_encoders");
+        return this.#command("list_head_encoders");
+    }
+    /** Remove a user head slot's contents. */
+    removeHead(slot) {
+        this.#require("heads");
+        return this.#command("remove_head", slot);
+    }
+    // --- processing, on devices that run a chain ------------------------------
+    //
+    // The device preprocesses its own signal. When a chain is in force only
+    // its output streams, and the chain is readable at any time, so a
+    // recording can say exactly what produced its samples. The rules a chain
+    // must meet are the device's, restated in `protocol.checkChain`, so a
+    // chain that cannot run is refused here in words before anything is
+    // sent. The device refuses a change while streaming: stop, set, start.
+    /** Ask for the stage kinds the device runs. `protocol.decodeCatalog` reads the answer. */
+    pipelineCatalog() {
+        this.#require("pipeline");
+        return this.#command("get_pipeline_catalog");
+    }
+    /** Ask for the chain in force. `protocol.decodePipelineState` reads the answer. */
+    pipeline() {
+        this.#require("pipeline");
+        return this.#command("get_pipeline");
+    }
+    /** Put a chain on the device's signal path, checked here first against the rate the device runs at. */
+    setPipeline(stages, rateSps, catalog) {
+        this.#require("pipeline");
+        checkChain(stages, rateSps, catalog);
+        return this.#command("set_pipeline", encodeChain(stages));
+    }
+    /** The natural signal, as this host's choice. */
+    clearPipeline() {
+        this.#require("pipeline");
+        return this.#command("clear_pipeline");
+    }
+    /** The device's own default chain for its current rate. */
+    restorePipelineDefault() {
+        this.#require("pipeline");
+        return this.#command("restore_pipeline_default");
+    }
+    /** Ask where the model's input comes from. `protocol.decodePredictionInput` reads the answer. */
+    predictionInput() {
+        this.#require("model");
+        return this.#command("get_prediction_input");
+    }
+    /**
+     * Point the model at the stream as it is, at the natural signal, or at a
+     * chain of its own, without touching the stream. Only the model's own
+     * source carries a chain, checked here against the rate.
+     */
+    setPredictionInput(source, stages = [], rateSps = 500, catalog) {
+        this.#require("model");
+        if (source === "own_chain")
+            checkChain(stages, rateSps, catalog);
+        else if (stages.length !== 0)
+            throw new Invalid("only the model's own chain carries stages");
+        return this.#command("set_prediction_input", encodePredictionInput(source, stages));
+    }
+    /** The bias drive, on a device that claims one: off, on, or loop open. */
+    setBias(mode) {
+        this.#require("bias_drive");
+        const code = BIAS_MODES[mode];
+        if (code === undefined)
+            throw new Invalid(`${mode} is not a bias mode this contract defines`);
+        return this.#command("set_bias", code);
+    }
+    /** Ask for the bias output measured. `protocol.decodeBiasDiagnostic` reads the answer. */
+    biasDiagnostic() {
+        this.#require("bias_drive");
+        return this.#command("get_bias_diagnostic");
+    }
+    // --- the lamp, the converter's registers, embeddings (1.2) ----------------
+    /** Ask for the status lamp's level. The answer's one byte is an `INDICATOR_LEVELS` value. */
+    indicator() {
+        this.#require("indicator");
+        return this.#command("get_indicator");
+    }
+    /**
+     * Put the lamp at a level: silent, reserved (the default: low battery and a
+     * converter fault at power on), or verbose. The device keeps it across
+     * power cycles.
+     */
+    setIndicator(level) {
+        this.#require("indicator");
+        const code = INDICATOR_LEVELS[level];
+        if (code === undefined)
+            throw new Invalid(`${level} is not a lamp level this contract defines`);
+        return this.#command("set_indicator", code);
+    }
+    /** Blink the lamp so this device can be told from others, for 1 to 30 seconds at every level; 0 stops one in progress. */
+    identify(seconds = 5) {
+        this.#require("indicator");
+        if (!Number.isInteger(seconds) || seconds < 0 || seconds > IDENTIFY_MAX_SECONDS) {
+            throw new Invalid(`identify runs 1 to ${IDENTIFY_MAX_SECONDS} seconds, or 0 to stop`);
+        }
+        return this.#command("identify", seconds);
+    }
+    /** Ask for the converter's registers, raw, for debugging; read only, and only while not streaming. `protocol.decodeConverterRegisters` reads the answer. */
+    converterRegisters() {
+        this.#require("converter_registers");
+        return this.#command("get_converter_registers");
+    }
+    /**
+     * Ask the device for its encoder's output for each window while it
+     * streams: "window" for the one vector a head consumes, "tokens" for the
+     * per-slice vectors reconstruction consumes, "both", or "off". Whole
+     * windows come from `protocol.EmbeddingAssembler` fed with embedding events.
+     */
+    setEmbeddings(form) {
+        this.#require("embeddings");
+        const code = EMBEDDING_FORMS[form];
+        if (code === undefined)
+            throw new Invalid(`${form} is not an embedding form this contract defines`);
+        return this.#command("set_embeddings", code);
+    }
+    // --- 1.3: the model's cadence and the device's name -----------------------
+    /** Ask how often the model describes a window and the least interval the device keeps; `protocol.decodeModelInterval` reads the answer. */
+    modelInterval() {
+        this.#require("model_cadence");
+        return this.#command("get_model_interval");
+    }
+    /**
+     * One described window every `seconds`, on a grid from the stream's start;
+     * 0 is every window the device can. The device refuses a value below its
+     * minimum and keeps the setting across power cycles.
+     */
+    setModelInterval(seconds) {
+        this.#require("model_cadence");
+        return this.#command("set_model_interval", encodeModelInterval(seconds));
+    }
+    /** Ask for the name and the adjective a host set; `protocol.decodeNameParts` reads the answer. */
+    getName() {
+        this.#requireHigh("device_name");
+        return this.#command("get_name");
+    }
+    /**
+     * Name the device. It advertises `name's adjective IntoMind One` from the
+     * next advertisement and keeps both parts across power cycles. The
+     * composition must fit the 29 bytes a scan response carries, so every scan
+     * list shows the whole of it; refused here when it does not, or when a
+     * part has a leading or trailing space or a control character.
+     */
+    setName(name, adjective, product = PRODUCT_NAME) {
+        this.#requireHigh("device_name");
+        if (!nameFits(name, adjective, product)) {
+            throw new Invalid(`"${composeName(name, adjective, product)}" does not fit the ${NAME_MAX_COMPOSED} bytes the air carries, or a part has a leading or trailing space or a control character`);
+        }
+        return this.#command("set_name", encodeNameParts(name, adjective));
+    }
+    // --- notifications --------------------------------------------------------
+    /**
+     * Hand in one notification, and take whatever it meant.
+     *
+     * A batch that follows a break is preceded by the gap, so a caller that
+     * writes samples down writes the gap down first and can never splice.
+     */
+    onNotification(characteristic, bytes) {
+        switch (characteristic) {
+            case FILL.EEG_DATA:
+                return this.#onSamples(bytes);
+            case FILL.STATUS:
+                return this.#decoded(characteristic, () => ({ type: "status", status: decodeStatus(bytes) }));
+            case FILL.CONTROL_RESPONSE:
+                return this.#decoded(characteristic, () => ({ type: "answer", answer: decodeResponse(bytes) }));
+            case FILL.PREDICTIONS:
+                return this.#decoded(characteristic, () => ({
+                    type: "prediction",
+                    prediction: decodePrediction(bytes),
+                }));
+            case FILL.EMBEDDINGS:
+                return this.#decoded(characteristic, () => ({
+                    type: "embedding",
+                    embedding: decodeEmbedding(bytes),
+                }));
+            default:
+                return this.#undecodable(characteristic);
+        }
+    }
+    #decoded(characteristic, decode) {
+        try {
+            return [decode()];
+        }
+        catch {
+            return this.#undecodable(characteristic);
+        }
+    }
+    #undecodable(characteristic) {
+        this.undecodable += 1;
+        return [{ type: "undecodable", characteristic }];
+    }
+    #onSamples(bytes) {
+        const info = this.#info;
+        // A device that has not said how wide it is cannot have its samples
+        // read, because the payload length only means something against a
+        // channel count.
+        if (info === null)
+            return this.#undecodable(FILL.EEG_DATA);
+        let packet;
+        try {
+            packet = decodePacket(bytes, info.channels);
+        }
+        catch {
+            return this.#undecodable(FILL.EEG_DATA);
+        }
+        const events = [];
+        const previous = this.#previous;
+        // A packet with the first index and the device time of one just passed
+        // on is that packet again, delivered twice by the host. Dropped and
+        // counted, so no sample is passed on twice and no break is announced
+        // that did not happen. A device that restarts its count carries a new
+        // device time, so a restart is never taken for a copy, and anything else
+        // is judged by the contract's continuity rule unchanged.
+        const key = `${packet.index}:${packet.deviceTime}`;
+        if (this.#recent.includes(key)) {
+            this.duplicates += 1;
+            return [{ type: "duplicate", index: packet.index }];
+        }
+        this.#recent.push(key);
+        if (this.#recent.length > 8)
+            this.#recent.shift();
+        if (previous !== null) {
+            const verdict = continuity(previous.index, previous.nSamples, packet.index, packet.discontinuity);
+            if (verdict.broken) {
+                if (verdict.lost === null)
+                    this.rebases += 1;
+                else
+                    this.samplesLost += verdict.lost;
+                events.push({
+                    type: "gap",
+                    gap: {
+                        lastIndexBefore: (previous.index + previous.nSamples - 1) >>> 0,
+                        firstIndexAfter: packet.index,
+                        samplesLost: verdict.lost,
+                        deviceTimeBefore: previous.deviceTime,
+                        deviceTimeAfter: packet.deviceTime,
+                        isRebase: verdict.lost === null,
+                    },
+                });
+            }
+        }
+        this.#previous = { index: packet.index, nSamples: packet.nSamples, deviceTime: packet.deviceTime };
+        const counts = new Int32Array(packet.nSamples * info.channels);
+        for (let row = 0; row < packet.nSamples; row++) {
+            for (let c = 0; c < info.channels; c++)
+                counts[row * info.channels + c] = packet.counts[row][c];
+        }
+        events.push({
+            type: "samples",
+            batch: new Batch({
+                index: packet.index,
+                deviceTime: packet.deviceTime,
+                channels: info.channels,
+                counts,
+                leadoff: packet.loffStatp,
+                leadoffActive: packet.leadoffActive,
+                gain: packet.gain,
+                sampleRateHz: packet.sps,
+                mode: packet.mode,
+                synthetic: packet.synthetic,
+            }),
+        });
+        return events;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/timebase.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Device time onto a host clock.
+ *
+ * A device's clock is monotonic and free running. A host's is a different
+ * crystal. The fit between them is a line, and the point of taking several
+ * exchanges rather than one is that a single exchange cannot tell a clock
+ * difference from a slow answer.
+ *
+ * The fit is refused rather than believed when it is absurd. Two crystals
+ * do not differ by a thousand parts per million, and a measurement that
+ * says they do is measuring something else, usually a link that stalled in
+ * the middle of an exchange.
+ */
+/** Beyond this, a skew is not two crystals disagreeing. */
+export declare const MAX_SKEW_PPM = 1000;
+/** And it has to be measured rather than drawn through noise. */
+export declare const MAX_SKEW_STDERR_PPM = 100;
+/** One time exchange, read on both clocks. */
+export declare class Exchange {
+    /** Host time before the request, in seconds. */
+    readonly before: number;
+    /** Host time after the answer. */
+    readonly after: number;
+    /** The device's own time, in its ticks, captured when it read the request. */
+    readonly deviceTicks: bigint;
+    /** One exchange: the host clock either side of the request, and the device's own answer in its ticks. */
+    constructor(before: number, after: number, deviceTicks: bigint);
+    /** The middle of the window the device's answer must lie in. */
+    get host(): number;
+    /**
+     * How wide that window is. Half the round trip, which is the uncertainty
+     * in this one exchange.
+     */
+    get uncertainty(): number;
+}
+/** The line through the exchanges. */
+export interface Fit {
+    /** host = deviceSeconds * (1 + skew) + offset. */
+    readonly offsetS: number;
+    /** The measured clock skew, in parts per million. 0 when `skewUsed` is false. */
+    readonly skewPpm: number;
+    /** Exchanges this fit was computed from. */
+    readonly exchanges: number;
+    /** How far the exchanges sit from the line, in microseconds. */
+    readonly residualUs: number;
+    /** Whether the skew was measured well enough to be used. */
+    readonly skewUsed: boolean;
+}
+/** Device time onto host time, and the exchanges it was learned from. */
+export declare class Timebase {
+    #private;
+    /** The device's own tick rate, from device info. */
+    readonly tickHz: number;
+    /** `tickHz` is the device's own, from device info. */
+    constructor(tickHz: number);
+    /** Take one exchange. The fit is redone from everything so far. */
+    observe(exchange: Exchange): Fit | null;
+    /** Every exchange taken so far. */
+    get exchanges(): readonly Exchange[];
+    /** The current fit, or null before the first exchange. */
+    get fit(): Fit | null;
+    /** Host time for a device time, in seconds. Null until there is a fit. */
+    hostTime(deviceTicks: bigint): number | null;
+}
+//# sourceMappingURL=timebase.d.ts.map

package/dist/timebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timebase.d.ts","sourceRoot":"","sources":["../src/timebase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,2DAA2D;AAC3D,eAAO,MAAM,YAAY,OAAS,CAAC;AACnC,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,MAAQ,CAAC;AAEzC,8CAA8C;AAC9C,qBAAa,QAAQ;IACnB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,yGAAyG;gBAC7F,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAM9D,gEAAgE;IAChE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;CACF;AAED,sCAAsC;AACtC,MAAM,WAAW,GAAG;IAClB,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,yEAAyE;AACzE,qBAAa,QAAQ;;IACnB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAIxB,sDAAsD;gBAC1C,MAAM,EAAE,MAAM;IAI1B,mEAAmE;IACnE,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,GAAG,GAAG,IAAI;IAMvC,mCAAmC;IACnC,IAAI,SAAS,IAAI,SAAS,QAAQ,EAAE,CAEnC;IAED,0DAA0D;IAC1D,IAAI,GAAG,IAAI,GAAG,GAAG,IAAI,CAEpB;IAED,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CA4C7C"}