@wave-av/sdk 2.0.0 → 2.0.1

package/dist/audience.d.ts

@@ -0,0 +1,104 @@
+/**
+ * WAVE SDK - Audience API
+ *
+ * Interactive audience engagement: polls, Q&A, reactions, and engagement metrics.
+ */
+import type { WaveClient } from "./client";
+export type PollStatus = "draft" | "active" | "closed";
+export interface Poll {
+    id: string;
+    stream_id: string;
+    question: string;
+    options: PollOption[];
+    status: PollStatus;
+    total_votes: number;
+    allow_multiple: boolean;
+    show_results: boolean;
+    duration_seconds?: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface PollOption {
+    id: string;
+    text: string;
+    vote_count: number;
+    percentage: number;
+}
+export interface QASession {
+    id: string;
+    stream_id: string;
+    status: "active" | "paused" | "closed";
+    questions: Question[];
+    allow_anonymous: boolean;
+    moderated: boolean;
+    created_at: string;
+}
+export interface Question {
+    id: string;
+    session_id: string;
+    text: string;
+    author: string;
+    upvotes: number;
+    answered: boolean;
+    answer?: string;
+    pinned: boolean;
+    created_at: string;
+}
+export interface ReactionBurst {
+    stream_id: string;
+    type: "like" | "love" | "fire" | "clap" | "laugh" | "wow";
+    count: number;
+    timestamp: string;
+}
+export interface EngagementMetrics {
+    stream_id: string;
+    active_participants: number;
+    chat_rate_per_minute: number;
+    reaction_rate: number;
+    poll_participation_rate: number;
+    qa_questions: number;
+    peak_engagement_at: string;
+}
+export interface CreatePollRequest {
+    stream_id: string;
+    question: string;
+    options: string[];
+    allow_multiple?: boolean;
+    show_results?: boolean;
+    duration_seconds?: number;
+}
+export interface CreateQARequest {
+    stream_id: string;
+    allow_anonymous?: boolean;
+    moderated?: boolean;
+}
+/**
+ * Interactive audience engagement: live polls, Q&A sessions, and reactions.
+ *
+ * @example
+ * ```typescript
+ * const poll = await wave.audience.createPoll({ stream_id: id, question: "Best feature?", options: ["A", "B", "C"] });
+ * const metrics = await wave.audience.getEngagementMetrics(streamId);
+ * ```
+ */
+export declare class AudienceAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    createPoll(request: CreatePollRequest): Promise<Poll>;
+    getPoll(pollId: string): Promise<Poll>;
+    closePoll(pollId: string): Promise<Poll>;
+    getPollResults(pollId: string): Promise<Poll>;
+    vote(pollId: string, optionIds: string[]): Promise<void>;
+    createQA(request: CreateQARequest): Promise<QASession>;
+    getQA(sessionId: string): Promise<QASession>;
+    closeQA(sessionId: string): Promise<QASession>;
+    submitQuestion(sessionId: string, text: string): Promise<Question>;
+    answerQuestion(sessionId: string, questionId: string, answer: string): Promise<Question>;
+    upvoteQuestion(sessionId: string, questionId: string): Promise<Question>;
+    pinQuestion(sessionId: string, questionId: string): Promise<Question>;
+    sendReaction(streamId: string, type: ReactionBurst["type"]): Promise<void>;
+    getReactionMetrics(streamId: string): Promise<ReactionBurst[]>;
+    getEngagementMetrics(streamId: string): Promise<EngagementMetrics>;
+}
+export declare function createAudienceAPI(client: WaveClient): AudienceAPI;

package/dist/audience.d.ts.map

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

package/dist/camera-control.d.ts

@@ -0,0 +1,54 @@
+/**
+ * WAVE Camera Control SDK
+ *
+ * Discover and control cameras from any manufacturer.
+ *
+ * @packageDocumentation
+ */
+import type { WaveClient } from './client';
+export interface ManagedCamera {
+    readonly id: string;
+    readonly name: string;
+    readonly manufacturer: 'blackmagic' | 'sony' | 'canon' | 'ptzoptics' | 'other';
+    readonly model: string | null;
+    readonly ipAddress: string;
+    readonly status: 'online' | 'offline' | 'error';
+    readonly controlProtocol: string;
+}
+export interface CameraPreset {
+    readonly id: string;
+    readonly name: string;
+    readonly slot: number;
+}
+export interface CameraControlParams {
+    readonly iris?: number;
+    readonly focus?: number;
+    readonly zoom?: number;
+    readonly whiteBalance?: {
+        temperature: number;
+        tint: number;
+    };
+    readonly gain?: number;
+    readonly shutter?: number;
+    readonly panTilt?: {
+        pan: number;
+        tilt: number;
+        speed: number;
+    };
+}
+export declare class CameraControlAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    discover(): Promise<ManagedCamera[]>;
+    list(): Promise<ManagedCamera[]>;
+    get(cameraId: string): Promise<ManagedCamera>;
+    control(cameraId: string, params: CameraControlParams): Promise<void>;
+    autofocus(cameraId: string): Promise<void>;
+    savePreset(cameraId: string, name: string, slot: number): Promise<CameraPreset>;
+    recallPreset(cameraId: string, presetId: string): Promise<void>;
+    listPresets(cameraId: string): Promise<CameraPreset[]>;
+    startRecording(cameraId: string): Promise<void>;
+    stopRecording(cameraId: string): Promise<void>;
+}
+export declare function createCameraControlAPI(client: WaveClient): CameraControlAPI;

package/dist/camera-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-control.d.ts","sourceRoot":"","sources":["../src/camera-control.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,CAAC;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;gBAE9B,MAAM,EAAE,UAAU;IAIxB,QAAQ,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAIpC,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAIhC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI7C,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrE,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI/E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAItD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,CAE3E"}

package/dist/captions.d.ts

@@ -0,0 +1,362 @@
+/**
+ * WAVE SDK - Captions API
+ *
+ * Generate, manage, and translate captions for video content.
+ *
+ * NOTE: This is a client SDK. All authorization checks are performed server-side.
+ * The API will return 403 Forbidden if the user lacks required permissions.
+ */
+import type { WaveClient, PaginationParams, PaginatedResponse, Timestamps, Metadata } from './client';
+/**
+ * Caption status
+ */
+export type CaptionStatus = 'pending' | 'processing' | 'ready' | 'failed';
+/**
+ * Caption format
+ */
+export type CaptionFormat = 'srt' | 'vtt' | 'sbv' | 'ass' | 'ttml' | 'dfxp' | 'json';
+/**
+ * Caption track
+ */
+export interface CaptionTrack extends Timestamps {
+    id: string;
+    organization_id: string;
+    media_id: string;
+    media_type: 'video' | 'audio' | 'stream';
+    language: string;
+    label: string;
+    status: CaptionStatus;
+    is_default: boolean;
+    is_auto_generated: boolean;
+    word_count?: number;
+    duration?: number;
+    accuracy_score?: number;
+    url?: string;
+    error?: string;
+    metadata?: Metadata;
+}
+/**
+ * Caption cue (single caption segment)
+ */
+export interface CaptionCue {
+    id: string;
+    start_time: number;
+    end_time: number;
+    text: string;
+    speaker?: string;
+    confidence?: number;
+    words?: CaptionWord[];
+    style?: CaptionStyle;
+}
+/**
+ * Word-level timing
+ */
+export interface CaptionWord {
+    word: string;
+    start_time: number;
+    end_time: number;
+    confidence?: number;
+}
+/**
+ * Caption styling
+ */
+export interface CaptionStyle {
+    align?: 'left' | 'center' | 'right';
+    vertical?: 'top' | 'middle' | 'bottom';
+    line?: number;
+    position?: number;
+    size?: number;
+    color?: string;
+    background_color?: string;
+    font_family?: string;
+    font_weight?: 'normal' | 'bold';
+    font_style?: 'normal' | 'italic';
+}
+/**
+ * Generate captions request
+ */
+export interface GenerateCaptionsRequest {
+    media_id: string;
+    media_type: 'video' | 'audio' | 'stream';
+    language?: string;
+    label?: string;
+    /** Model to use for transcription */
+    model?: 'standard' | 'enhanced' | 'whisper';
+    /** Enable speaker diarization */
+    speaker_diarization?: boolean;
+    /** Number of expected speakers */
+    speaker_count?: number;
+    /** Filter profanity */
+    profanity_filter?: boolean;
+    /** Custom vocabulary */
+    vocabulary?: string[];
+    /** Enable word-level timing */
+    word_timestamps?: boolean;
+    /** Webhook URL for completion */
+    webhook_url?: string;
+    metadata?: Metadata;
+}
+/**
+ * Upload captions request
+ */
+export interface UploadCaptionsRequest {
+    media_id: string;
+    media_type: 'video' | 'audio' | 'stream';
+    language: string;
+    label: string;
+    format: CaptionFormat;
+    /** Caption file content */
+    content: string;
+    is_default?: boolean;
+    metadata?: Metadata;
+}
+/**
+ * Update captions request
+ */
+export interface UpdateCaptionsRequest {
+    label?: string;
+    is_default?: boolean;
+    metadata?: Metadata;
+}
+/**
+ * Translate captions request
+ */
+export interface TranslateCaptionsRequest {
+    target_language: string;
+    target_label?: string;
+    /** Use professional translation */
+    professional?: boolean;
+    /** Preserve speaker labels */
+    preserve_speakers?: boolean;
+    webhook_url?: string;
+}
+/**
+ * Burn-in captions request
+ */
+export interface BurnInCaptionsRequest {
+    caption_track_id: string;
+    style?: CaptionStyle;
+    /** Output format */
+    format?: 'mp4' | 'webm' | 'mov';
+    /** Output quality */
+    quality?: 'low' | 'medium' | 'high' | 'source';
+    webhook_url?: string;
+}
+/**
+ * Burn-in job
+ */
+export interface BurnInJob extends Timestamps {
+    id: string;
+    media_id: string;
+    caption_track_id: string;
+    status: 'pending' | 'processing' | 'ready' | 'failed';
+    progress: number;
+    output_url?: string;
+    error?: string;
+}
+/**
+ * List captions params
+ */
+export interface ListCaptionsParams extends PaginationParams {
+    media_id?: string;
+    media_type?: 'video' | 'audio' | 'stream';
+    language?: string;
+    status?: CaptionStatus;
+    is_auto_generated?: boolean;
+}
+/**
+ * Captions API client
+ *
+ * All operations require appropriate permissions. Authorization is enforced
+ * server-side - the API returns 403 if the authenticated user lacks access.
+ *
+ * @example
+ * ```typescript
+ * import { WaveClient } from '@wave/sdk';
+ * import { CaptionsAPI } from '@wave/sdk/captions';
+ *
+ * const client = new WaveClient({ apiKey: 'your-api-key' });
+ * const captions = new CaptionsAPI(client);
+ *
+ * // Generate captions for a video
+ * const track = await captions.generate({
+ *   media_id: 'video_123',
+ *   media_type: 'video',
+ *   language: 'en',
+ *   speaker_diarization: true,
+ * });
+ *
+ * // Wait for processing
+ * const ready = await captions.waitForReady(track.id);
+ *
+ * // Translate to Spanish
+ * const spanish = await captions.translate(track.id, {
+ *   target_language: 'es',
+ * });
+ * ```
+ */
+export declare class CaptionsAPI {
+    private readonly client;
+    private readonly basePath;
+    constructor(client: WaveClient);
+    /**
+     * Generate captions using AI
+     *
+     * Requires: captions:generate permission
+     */
+    generate(request: GenerateCaptionsRequest): Promise<CaptionTrack>;
+    /**
+     * Upload existing captions
+     *
+     * Requires: captions:create permission
+     */
+    upload(request: UploadCaptionsRequest): Promise<CaptionTrack>;
+    /**
+     * Get a caption track by ID
+     *
+     * Requires: captions:read permission
+     */
+    get(trackId: string): Promise<CaptionTrack>;
+    /**
+     * Update a caption track
+     *
+     * Requires: captions:update permission
+     */
+    update(trackId: string, request: UpdateCaptionsRequest): Promise<CaptionTrack>;
+    /**
+     * Remove a caption track
+     *
+     * Requires: captions:remove permission (server-side RBAC enforced)
+     */
+    remove(trackId: string): Promise<void>;
+    /**
+     * List caption tracks
+     *
+     * Requires: captions:read permission
+     */
+    list(params?: ListCaptionsParams): Promise<PaginatedResponse<CaptionTrack>>;
+    /**
+     * Get caption tracks for a specific media
+     *
+     * Requires: captions:read permission
+     */
+    getForMedia(mediaId: string, mediaType: 'video' | 'audio' | 'stream'): Promise<CaptionTrack[]>;
+    /**
+     * Get caption cues (segments)
+     *
+     * Requires: captions:read permission
+     */
+    getCues(trackId: string, params?: PaginationParams & {
+        start_time?: number;
+        end_time?: number;
+    }): Promise<PaginatedResponse<CaptionCue>>;
+    /**
+     * Update a caption cue
+     *
+     * Requires: captions:update permission
+     */
+    updateCue(trackId: string, cueId: string, updates: Partial<Pick<CaptionCue, 'text' | 'start_time' | 'end_time' | 'speaker' | 'style'>>): Promise<CaptionCue>;
+    /**
+     * Add a new caption cue
+     *
+     * Requires: captions:update permission
+     */
+    addCue(trackId: string, cue: Omit<CaptionCue, 'id' | 'confidence' | 'words'>): Promise<CaptionCue>;
+    /**
+     * Remove a caption cue
+     *
+     * Requires: captions:update permission (server-side RBAC enforced)
+     */
+    removeCue(trackId: string, cueId: string): Promise<void>;
+    /**
+     * Bulk update cues
+     *
+     * Requires: captions:update permission
+     */
+    bulkUpdateCues(trackId: string, updates: Array<{
+        id: string;
+        text?: string;
+        start_time?: number;
+        end_time?: number;
+    }>): Promise<{
+        updated: number;
+    }>;
+    /**
+     * Translate a caption track to another language
+     *
+     * Requires: captions:translate permission
+     */
+    translate(trackId: string, request: TranslateCaptionsRequest): Promise<CaptionTrack>;
+    /**
+     * Export captions in a specific format
+     *
+     * Requires: captions:read permission
+     */
+    exportFormat(trackId: string, format: CaptionFormat): Promise<{
+        url: string;
+        expires_at: string;
+    }>;
+    /**
+     * Get captions as plain text
+     *
+     * Requires: captions:read permission
+     */
+    getText(trackId: string): Promise<string>;
+    /**
+     * Burn captions into video
+     *
+     * Requires: captions:burnin permission
+     */
+    burnIn(request: BurnInCaptionsRequest): Promise<BurnInJob>;
+    /**
+     * Get burn-in job status
+     *
+     * Requires: captions:read permission
+     */
+    getBurnInJob(jobId: string): Promise<BurnInJob>;
+    /**
+     * Wait for burn-in to complete
+     */
+    waitForBurnIn(jobId: string, options?: {
+        pollInterval?: number;
+        timeout?: number;
+        onProgress?: (job: BurnInJob) => void;
+    }): Promise<BurnInJob>;
+    /**
+     * Wait for caption generation to complete
+     */
+    waitForReady(trackId: string, options?: {
+        pollInterval?: number;
+        timeout?: number;
+        onProgress?: (track: CaptionTrack) => void;
+    }): Promise<CaptionTrack>;
+    /**
+     * Get supported languages
+     *
+     * Requires: captions:read permission
+     */
+    getSupportedLanguages(): Promise<Array<{
+        code: string;
+        name: string;
+        native_name: string;
+        supports_generation: boolean;
+        supports_translation: boolean;
+    }>>;
+    /**
+     * Detect language from audio
+     *
+     * Requires: captions:generate permission
+     */
+    detectLanguage(mediaId: string, mediaType: 'video' | 'audio' | 'stream'): Promise<{
+        detected_language: string;
+        confidence: number;
+        alternatives: Array<{
+            language: string;
+            confidence: number;
+        }>;
+    }>;
+}
+/**
+ * Create a Captions API instance
+ */
+export declare function createCaptionsAPI(client: WaveClient): CaptionsAPI;

package/dist/captions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captions.d.ts","sourceRoot":"","sources":["../src/captions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACT,MAAM,UAAU,CAAC;AAMlB;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,YAAY,GACZ,OAAO,GACP,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,MAAM,GACN,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,KAAK,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC5C,iCAAiC;IACjC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8BAA8B;IAC9B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,oBAAoB;IACpB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IAChC,qBAAqB;IACrB,OAAO,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;gBAE/B,MAAM,EAAE,UAAU;IAQ9B;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIvE;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IAInE;;;;OAIG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIjD;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIpF;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C;;;;OAIG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAMjF;;;;OAIG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,GACtC,OAAO,CAAC,YAAY,EAAE,CAAC;IAS1B;;;;OAIG;IACG,OAAO,CACX,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,gBAAgB,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GACrE,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAOzC;;;;OAIG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,GAC3F,OAAO,CAAC,UAAU,CAAC;IAOtB;;;;OAIG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,YAAY,GAAG,OAAO,CAAC,GACnD,OAAO,CAAC,UAAU,CAAC;IAOtB;;;;OAIG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9D;;;;OAIG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GACpF,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ/B;;;;OAIG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC;IAWxB;;;;OAIG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAM/C;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW/C;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC;IAIhE;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAIrD;;OAEG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC;KACvC,GACA,OAAO,CAAC,SAAS,CAAC;IA8BrB;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;KAC5C,GACA,OAAO,CAAC,YAAY,CAAC;IA0BxB;;;;OAIG;IACG,qBAAqB,IAAI,OAAO,CACpC,KAAK,CAAC;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB,EAAE,OAAO,CAAC;QAC7B,oBAAoB,EAAE,OAAO,CAAC;KAC/B,CAAC,CACH;IAID;;;;OAIG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,GACtC,OAAO,CAAC;QACT,iBAAiB,EAAE,MAAM,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC/D,CAAC;CAMH;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAEjE"}