openai 7.13.0 → 7.14.0

package/lib/live/transcript-grouper.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TranscriptGrouper = void 0;
+const EventEmitter_1 = require("../../core/EventEmitter.js");
+const error_1 = require("../../core/error.js");
+const transcript_grouping_1 = require("./transcript-grouping.js");
+const SETTLE_MS = 50;
+const MAX_TIMEOUT_MS = 2147483647;
+let nextGrouperId = 0;
+function normalizeTranscript(event) {
+    const { event_id: id, delta: text, start_ms: startMs, end_ms: endMs } = event;
+    const speaker = event.type === 'session.input_transcript.delta' ? 'user' : 'assistant';
+    if (typeof id !== 'string' ||
+        !id ||
+        typeof text !== 'string' ||
+        !Number.isSafeInteger(startMs) ||
+        startMs < 0 ||
+        !Number.isSafeInteger(endMs) ||
+        endMs < startMs) {
+        throw new error_1.OpenAIError('Invalid Live transcript delta: expected an event ID, text, and a nonnegative timed interval');
+    }
+    return { id, speaker, text, startMs, endMs, receivedAt: performance.now() };
+}
+function optionsWithDefaults(options) {
+    const resolved = {
+        minTurnSeparationMs: options.minTurnSeparationMs ?? 500,
+        assistantSilenceMs: options.assistantSilenceMs ?? 2000,
+        backchannelMaxDurationMs: options.backchannelMaxDurationMs ?? 1000,
+        backchannelIsolationMs: options.backchannelIsolationMs ?? 2000,
+    };
+    for (const [name, value] of Object.entries(resolved)) {
+        if (!Number.isFinite(value) || value < 0 || value > MAX_TIMEOUT_MS) {
+            throw new error_1.OpenAIError(`${name} must be a finite number between 0 and ${MAX_TIMEOUT_MS}`);
+        }
+    }
+    return { ...resolved, additionalAcknowledgments: options.additionalAcknowledgments ?? [] };
+}
+/**
+ * Groups public Live transcript events using speaker and
+ * backchannel heuristics. Raw events remain available on your transport.
+ *
+ * Only session.input_transcript.delta, session.output_transcript.delta and session.closed are
+ * consumed. No audio, engine frames, server turn events or internal end markers
+ * are required. Ambiguous speaker changes settle for at most 50 ms. When source
+ * time stops arriving, a monotonic local clock supplies a best-effort inactivity
+ * fallback. Delayed delivery can therefore change grouping; this is not VAD,
+ * playback tracking, or a lossless transcript (some backchannels are suppressed).
+ *
+ * Create one instance per session. Call close() on transport loss or teardown;
+ * the grouper never owns or closes your transport and does not reconnect it.
+ */
+// oxlint-disable-next-line unicorn/prefer-event-target -- This is the SDK's browser-compatible typed emitter, not node:events.
+class TranscriptGrouper extends EventEmitter_1.EventEmitter {
+    /** Create a grouper with speaker-based defaults. Invalid timing options throw OpenAIError. */
+    constructor(options = {}) {
+        super();
+        this.seenIds = new Set();
+        this.pending = [];
+        this.closed = false;
+        this.dispatching = false;
+        this.updates = [];
+        this.grouping = new transcript_grouping_1.TranscriptGrouping(optionsWithDefaults(options), `segment_${nextGrouperId}`);
+        nextGrouperId += 1;
+    }
+    /**
+     * Consume one public Live event. Duplicate transcript event IDs and unrelated
+     * event types are ignored. Empty text does not count as speech activity.
+     * Malformed transcript fields or use after close() throw OpenAIError.
+     */
+    push(event) {
+        if (this.closed) {
+            throw new error_1.OpenAIError('Cannot push events after closing the transcript grouper');
+        }
+        if (event.type === 'session.closed') {
+            this.finish('session_closed');
+            return;
+        }
+        if (event.type !== 'session.input_transcript.delta' && event.type !== 'session.output_transcript.delta') {
+            return;
+        }
+        const fragment = normalizeTranscript(event);
+        const { id, startMs, endMs, speaker } = fragment;
+        if (this.seenIds.has(id)) {
+            return;
+        }
+        this.seenIds.add(id);
+        if (!fragment.text) {
+            return;
+        }
+        const updates = [];
+        const [pending] = this.pending;
+        if (pending && pending.startMs === startMs && pending.endMs === endMs) {
+            this.pending.push(fragment);
+            if (this.pending.some((part) => part.speaker !== speaker)) {
+                updates.push(...this.flushPending());
+            }
+        }
+        else {
+            updates.push(...this.flushPending());
+            if (this.grouping.speaker === speaker) {
+                updates.push(...this.commit([fragment]));
+            }
+            else {
+                this.pending.push(fragment);
+            }
+        }
+        this.schedule();
+        this.dispatch(updates);
+    }
+    /**
+     * Flush buffered text according to the grouping policy, finalize all emitted
+     * segments, and cancel timers. Idempotent; further push() calls fail. Does not
+     * close the transport. Invoke before discarding the grouper at session teardown.
+     */
+    close() {
+        this.finish('manual');
+    }
+    finish(reason) {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        this.clearTimer();
+        const updates = this.flushPending();
+        updates.push(...this.grouping.close(this.sourceNow(), reason));
+        this.seenIds.clear();
+        this.dispatch(updates);
+    }
+    commit(fragments) {
+        const [first] = fragments;
+        if (!first) {
+            return [];
+        }
+        const updates = [];
+        if (this.lastStartMs !== undefined && first.startMs < this.lastStartMs) {
+            updates.push(...this.grouping.close(this.sourceNow(), 'timestamp_reset'));
+            this.anchor = undefined;
+        }
+        this.lastStartMs = first.startMs;
+        // Overlapping intervals can end before earlier ones. Preserve the source
+        // high-water mark while restarting local inactivity on newly received text.
+        this.anchor = {
+            sourceMs: Math.max(this.anchor?.sourceMs ?? 0, first.endMs),
+            receivedAt: first.receivedAt,
+        };
+        for (const part of fragments) {
+            this.anchor.sourceMs = Math.max(this.anchor.sourceMs, part.endMs);
+            this.anchor.receivedAt = Math.max(this.anchor.receivedAt, part.receivedAt);
+        }
+        updates.push(...this.grouping.process(fragments));
+        return updates;
+    }
+    flushPending() {
+        const { pending } = this;
+        this.pending = [];
+        return this.commit(pending);
+    }
+    sourceNow() {
+        return this.anchor ? this.anchor.sourceMs + Math.max(0, performance.now() - this.anchor.receivedAt) : 0;
+    }
+    clearTimer() {
+        if (this.timer !== undefined) {
+            clearTimeout(this.timer);
+        }
+        this.timer = undefined;
+    }
+    schedule() {
+        this.clearTimer();
+        if (this.closed) {
+            return;
+        }
+        const [pending] = this.pending;
+        const deadline = this.grouping.deadline();
+        // Settle newly arrived text before applying an older inactivity deadline.
+        let delay;
+        if (pending) {
+            delay = pending.receivedAt + SETTLE_MS - performance.now();
+        }
+        else if (deadline !== undefined) {
+            delay = deadline - this.sourceNow();
+        }
+        if (delay === undefined) {
+            return;
+        }
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            const updates = this.flushPending();
+            updates.push(...this.grouping.advance(this.sourceNow()));
+            this.schedule();
+            this.dispatch(updates);
+        }, Math.min(MAX_TIMEOUT_MS, Math.max(0, Math.ceil(delay))));
+        const timer = this.timer;
+        if (typeof timer === 'object' &&
+            timer !== null &&
+            'unref' in timer &&
+            typeof timer.unref === 'function') {
+            timer.unref();
+        }
+    }
+    dispatch(updates) {
+        this.updates.push(...updates);
+        if (this.dispatching) {
+            return;
+        }
+        this.dispatching = true;
+        try {
+            while (this.updates.length) {
+                const update = this.updates.shift();
+                if (update?.type === 'updated') {
+                    this._emit('segment.updated', update.segment);
+                }
+                else if (update) {
+                    this._emit('segment.closed', { segment: update.segment, reason: update.reason });
+                }
+            }
+        }
+        finally {
+            this.dispatching = false;
+        }
+    }
+}
+exports.TranscriptGrouper = TranscriptGrouper;
+//# sourceMappingURL=transcript-grouper.js.map

package/lib/live/transcript-grouper.js.map

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

package/lib/live/transcript-grouper.mjs

@@ -0,0 +1,219 @@
+import { EventEmitter } from "../../core/EventEmitter.mjs";
+import { OpenAIError } from "../../core/error.mjs";
+import { TranscriptGrouping } from "./transcript-grouping.mjs";
+const SETTLE_MS = 50;
+const MAX_TIMEOUT_MS = 2147483647;
+let nextGrouperId = 0;
+function normalizeTranscript(event) {
+    const { event_id: id, delta: text, start_ms: startMs, end_ms: endMs } = event;
+    const speaker = event.type === 'session.input_transcript.delta' ? 'user' : 'assistant';
+    if (typeof id !== 'string' ||
+        !id ||
+        typeof text !== 'string' ||
+        !Number.isSafeInteger(startMs) ||
+        startMs < 0 ||
+        !Number.isSafeInteger(endMs) ||
+        endMs < startMs) {
+        throw new OpenAIError('Invalid Live transcript delta: expected an event ID, text, and a nonnegative timed interval');
+    }
+    return { id, speaker, text, startMs, endMs, receivedAt: performance.now() };
+}
+function optionsWithDefaults(options) {
+    const resolved = {
+        minTurnSeparationMs: options.minTurnSeparationMs ?? 500,
+        assistantSilenceMs: options.assistantSilenceMs ?? 2000,
+        backchannelMaxDurationMs: options.backchannelMaxDurationMs ?? 1000,
+        backchannelIsolationMs: options.backchannelIsolationMs ?? 2000,
+    };
+    for (const [name, value] of Object.entries(resolved)) {
+        if (!Number.isFinite(value) || value < 0 || value > MAX_TIMEOUT_MS) {
+            throw new OpenAIError(`${name} must be a finite number between 0 and ${MAX_TIMEOUT_MS}`);
+        }
+    }
+    return { ...resolved, additionalAcknowledgments: options.additionalAcknowledgments ?? [] };
+}
+/**
+ * Groups public Live transcript events using speaker and
+ * backchannel heuristics. Raw events remain available on your transport.
+ *
+ * Only session.input_transcript.delta, session.output_transcript.delta and session.closed are
+ * consumed. No audio, engine frames, server turn events or internal end markers
+ * are required. Ambiguous speaker changes settle for at most 50 ms. When source
+ * time stops arriving, a monotonic local clock supplies a best-effort inactivity
+ * fallback. Delayed delivery can therefore change grouping; this is not VAD,
+ * playback tracking, or a lossless transcript (some backchannels are suppressed).
+ *
+ * Create one instance per session. Call close() on transport loss or teardown;
+ * the grouper never owns or closes your transport and does not reconnect it.
+ */
+// oxlint-disable-next-line unicorn/prefer-event-target -- This is the SDK's browser-compatible typed emitter, not node:events.
+export class TranscriptGrouper extends EventEmitter {
+    /** Create a grouper with speaker-based defaults. Invalid timing options throw OpenAIError. */
+    constructor(options = {}) {
+        super();
+        this.seenIds = new Set();
+        this.pending = [];
+        this.closed = false;
+        this.dispatching = false;
+        this.updates = [];
+        this.grouping = new TranscriptGrouping(optionsWithDefaults(options), `segment_${nextGrouperId}`);
+        nextGrouperId += 1;
+    }
+    /**
+     * Consume one public Live event. Duplicate transcript event IDs and unrelated
+     * event types are ignored. Empty text does not count as speech activity.
+     * Malformed transcript fields or use after close() throw OpenAIError.
+     */
+    push(event) {
+        if (this.closed) {
+            throw new OpenAIError('Cannot push events after closing the transcript grouper');
+        }
+        if (event.type === 'session.closed') {
+            this.finish('session_closed');
+            return;
+        }
+        if (event.type !== 'session.input_transcript.delta' && event.type !== 'session.output_transcript.delta') {
+            return;
+        }
+        const fragment = normalizeTranscript(event);
+        const { id, startMs, endMs, speaker } = fragment;
+        if (this.seenIds.has(id)) {
+            return;
+        }
+        this.seenIds.add(id);
+        if (!fragment.text) {
+            return;
+        }
+        const updates = [];
+        const [pending] = this.pending;
+        if (pending && pending.startMs === startMs && pending.endMs === endMs) {
+            this.pending.push(fragment);
+            if (this.pending.some((part) => part.speaker !== speaker)) {
+                updates.push(...this.flushPending());
+            }
+        }
+        else {
+            updates.push(...this.flushPending());
+            if (this.grouping.speaker === speaker) {
+                updates.push(...this.commit([fragment]));
+            }
+            else {
+                this.pending.push(fragment);
+            }
+        }
+        this.schedule();
+        this.dispatch(updates);
+    }
+    /**
+     * Flush buffered text according to the grouping policy, finalize all emitted
+     * segments, and cancel timers. Idempotent; further push() calls fail. Does not
+     * close the transport. Invoke before discarding the grouper at session teardown.
+     */
+    close() {
+        this.finish('manual');
+    }
+    finish(reason) {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        this.clearTimer();
+        const updates = this.flushPending();
+        updates.push(...this.grouping.close(this.sourceNow(), reason));
+        this.seenIds.clear();
+        this.dispatch(updates);
+    }
+    commit(fragments) {
+        const [first] = fragments;
+        if (!first) {
+            return [];
+        }
+        const updates = [];
+        if (this.lastStartMs !== undefined && first.startMs < this.lastStartMs) {
+            updates.push(...this.grouping.close(this.sourceNow(), 'timestamp_reset'));
+            this.anchor = undefined;
+        }
+        this.lastStartMs = first.startMs;
+        // Overlapping intervals can end before earlier ones. Preserve the source
+        // high-water mark while restarting local inactivity on newly received text.
+        this.anchor = {
+            sourceMs: Math.max(this.anchor?.sourceMs ?? 0, first.endMs),
+            receivedAt: first.receivedAt,
+        };
+        for (const part of fragments) {
+            this.anchor.sourceMs = Math.max(this.anchor.sourceMs, part.endMs);
+            this.anchor.receivedAt = Math.max(this.anchor.receivedAt, part.receivedAt);
+        }
+        updates.push(...this.grouping.process(fragments));
+        return updates;
+    }
+    flushPending() {
+        const { pending } = this;
+        this.pending = [];
+        return this.commit(pending);
+    }
+    sourceNow() {
+        return this.anchor ? this.anchor.sourceMs + Math.max(0, performance.now() - this.anchor.receivedAt) : 0;
+    }
+    clearTimer() {
+        if (this.timer !== undefined) {
+            clearTimeout(this.timer);
+        }
+        this.timer = undefined;
+    }
+    schedule() {
+        this.clearTimer();
+        if (this.closed) {
+            return;
+        }
+        const [pending] = this.pending;
+        const deadline = this.grouping.deadline();
+        // Settle newly arrived text before applying an older inactivity deadline.
+        let delay;
+        if (pending) {
+            delay = pending.receivedAt + SETTLE_MS - performance.now();
+        }
+        else if (deadline !== undefined) {
+            delay = deadline - this.sourceNow();
+        }
+        if (delay === undefined) {
+            return;
+        }
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            const updates = this.flushPending();
+            updates.push(...this.grouping.advance(this.sourceNow()));
+            this.schedule();
+            this.dispatch(updates);
+        }, Math.min(MAX_TIMEOUT_MS, Math.max(0, Math.ceil(delay))));
+        const timer = this.timer;
+        if (typeof timer === 'object' &&
+            timer !== null &&
+            'unref' in timer &&
+            typeof timer.unref === 'function') {
+            timer.unref();
+        }
+    }
+    dispatch(updates) {
+        this.updates.push(...updates);
+        if (this.dispatching) {
+            return;
+        }
+        this.dispatching = true;
+        try {
+            while (this.updates.length) {
+                const update = this.updates.shift();
+                if (update?.type === 'updated') {
+                    this._emit('segment.updated', update.segment);
+                }
+                else if (update) {
+                    this._emit('segment.closed', { segment: update.segment, reason: update.reason });
+                }
+            }
+        }
+        finally {
+            this.dispatching = false;
+        }
+    }
+}
+//# sourceMappingURL=transcript-grouper.mjs.map

package/lib/live/transcript-grouper.mjs.map

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

package/lib/live/transcript-grouping.d.mts

@@ -0,0 +1,49 @@
+import type { TranscriptGrouperOptions, TranscriptSegment, TranscriptSegmentCloseReason } from "./transcript-grouper.mjs";
+export interface TranscriptFragment {
+    speaker: 'user' | 'assistant';
+    text: string;
+    startMs: number;
+    endMs: number;
+}
+export type GroupingUpdate = {
+    type: 'updated';
+    segment: TranscriptSegment;
+} | {
+    type: 'closed';
+    segment: TranscriptSegment;
+    reason: TranscriptSegmentCloseReason;
+};
+/** The v2 grouping policy, driven by timed public text rather than engine frames. */
+export declare class TranscriptGrouping {
+    private current;
+    private buffered;
+    private lastId;
+    private nextId;
+    private lastAssistantEnd;
+    private readonly options;
+    private readonly idPrefix;
+    private readonly acknowledgments;
+    constructor(options: Required<TranscriptGrouperOptions>, idPrefix: string);
+    get speaker(): TranscriptFragment['speaker'] | undefined;
+    process(fragments: readonly TranscriptFragment[]): GroupingUpdate[];
+    advance(timeMs: number, hasIncomingUser?: boolean): GroupingUpdate[];
+    deadline(): number | undefined;
+    close(timeMs: number, reason: TranscriptSegmentCloseReason): GroupingUpdate[];
+    private ingest;
+    private newTurn;
+    private static append;
+    private buffer;
+    private promote;
+    private finishCurrent;
+    private finish;
+    private emit;
+    private static snapshot;
+    private mightBeBackchannel;
+    private userContinued;
+    private recentAssistant;
+    private keepBackchannel;
+    private maybeDropBackchannel;
+    private standaloneAcknowledgment;
+    private possibleAcknowledgment;
+}
+//# sourceMappingURL=transcript-grouping.d.mts.map

package/lib/live/transcript-grouping.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-grouping.d.mts","sourceRoot":"","sources":["../../src/lib/live/transcript-grouping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,4BAA4B,EAC7B,iCAA6B;AAE9B,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,4BAA4B,CAAA;CAAE,CAAC;AAuCzF,qFAAqF;AACrF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,gBAAgB,CAAqB;IAE7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoB;gBAExC,OAAO,EAAE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,QAAQ,EAAE,MAAM;IASzE,IAAI,OAAO,IAAI,kBAAkB,CAAC,SAAS,CAAC,GAAG,SAAS,CAEvD;IAED,OAAO,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,cAAc,EAAE;IAgCnE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,UAAQ,GAAG,cAAc,EAAE;IAsBlE,QAAQ,IAAI,MAAM,GAAG,SAAS;IAqB9B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,4BAA4B,GAAG,cAAc,EAAE;IAa7E,OAAO,CAAC,MAAM;IA2Cd,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,MAAM,CAAC,MAAM;IAOrB,OAAO,CAAC,MAAM;IAWd,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,IAAI;IAYZ,OAAO,CAAC,MAAM,CAAC,QAAQ;IAWvB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,wBAAwB;IAOhC,OAAO,CAAC,sBAAsB;CAQ/B"}

package/lib/live/transcript-grouping.d.ts

@@ -0,0 +1,49 @@
+import type { TranscriptGrouperOptions, TranscriptSegment, TranscriptSegmentCloseReason } from "./transcript-grouper.js";
+export interface TranscriptFragment {
+    speaker: 'user' | 'assistant';
+    text: string;
+    startMs: number;
+    endMs: number;
+}
+export type GroupingUpdate = {
+    type: 'updated';
+    segment: TranscriptSegment;
+} | {
+    type: 'closed';
+    segment: TranscriptSegment;
+    reason: TranscriptSegmentCloseReason;
+};
+/** The v2 grouping policy, driven by timed public text rather than engine frames. */
+export declare class TranscriptGrouping {
+    private current;
+    private buffered;
+    private lastId;
+    private nextId;
+    private lastAssistantEnd;
+    private readonly options;
+    private readonly idPrefix;
+    private readonly acknowledgments;
+    constructor(options: Required<TranscriptGrouperOptions>, idPrefix: string);
+    get speaker(): TranscriptFragment['speaker'] | undefined;
+    process(fragments: readonly TranscriptFragment[]): GroupingUpdate[];
+    advance(timeMs: number, hasIncomingUser?: boolean): GroupingUpdate[];
+    deadline(): number | undefined;
+    close(timeMs: number, reason: TranscriptSegmentCloseReason): GroupingUpdate[];
+    private ingest;
+    private newTurn;
+    private static append;
+    private buffer;
+    private promote;
+    private finishCurrent;
+    private finish;
+    private emit;
+    private static snapshot;
+    private mightBeBackchannel;
+    private userContinued;
+    private recentAssistant;
+    private keepBackchannel;
+    private maybeDropBackchannel;
+    private standaloneAcknowledgment;
+    private possibleAcknowledgment;
+}
+//# sourceMappingURL=transcript-grouping.d.ts.map

package/lib/live/transcript-grouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-grouping.d.ts","sourceRoot":"","sources":["../../src/lib/live/transcript-grouping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,4BAA4B,EAC7B,gCAA6B;AAE9B,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,4BAA4B,CAAA;CAAE,CAAC;AAuCzF,qFAAqF;AACrF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,gBAAgB,CAAqB;IAE7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoB;gBAExC,OAAO,EAAE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,QAAQ,EAAE,MAAM;IASzE,IAAI,OAAO,IAAI,kBAAkB,CAAC,SAAS,CAAC,GAAG,SAAS,CAEvD;IAED,OAAO,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,cAAc,EAAE;IAgCnE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,UAAQ,GAAG,cAAc,EAAE;IAsBlE,QAAQ,IAAI,MAAM,GAAG,SAAS;IAqB9B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,4BAA4B,GAAG,cAAc,EAAE;IAa7E,OAAO,CAAC,MAAM;IA2Cd,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,MAAM,CAAC,MAAM;IAOrB,OAAO,CAAC,MAAM;IAWd,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,IAAI;IAYZ,OAAO,CAAC,MAAM,CAAC,QAAQ;IAWvB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,wBAAwB;IAOhC,OAAO,CAAC,sBAAsB;CAQ/B"}