native-recorder-nodejs 1.0.1

package/dist/index.js

@@ -0,0 +1,110 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nativeBindings = exports.AudioRecorder = exports.SYSTEM_AUDIO_DEVICE_ID = void 0;
+const bindings_1 = __importDefault(require("./bindings"));
+const events_1 = require("events");
+/**
+ * Special device ID for system-wide audio capture (macOS)
+ */
+exports.SYSTEM_AUDIO_DEVICE_ID = "system";
+const native = bindings_1.default;
+class AudioRecorder extends events_1.EventEmitter {
+    constructor() {
+        super();
+        this.isRecording = false;
+        this.controller = new native.AudioController();
+    }
+    /**
+     * Starts the recording session.
+     * @param config Configuration object with deviceType and deviceId (both required)
+     */
+    async start(config) {
+        if (this.isRecording) {
+            throw new Error("Already recording");
+        }
+        // Validate config
+        if (!config.deviceType || !config.deviceId) {
+            throw new Error("Both deviceType and deviceId are required");
+        }
+        if (config.deviceType !== "input" && config.deviceType !== "output") {
+            throw new Error("deviceType must be 'input' or 'output'");
+        }
+        return new Promise((resolve, reject) => {
+            try {
+                this.controller.start(config, (error, data) => {
+                    if (error) {
+                        this.emit("error", error);
+                    }
+                    else if (data) {
+                        this.emit("data", data);
+                    }
+                });
+                this.isRecording = true;
+                resolve();
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    async stop() {
+        if (!this.isRecording) {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            try {
+                this.controller.stop();
+                this.isRecording = false;
+                resolve();
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Lists available audio devices.
+     * @param type Optional filter by device type
+     * @returns Array of AudioDevice objects (all with valid id values)
+     */
+    static getDevices(type) {
+        const devices = native.AudioController.getDevices();
+        if (type) {
+            return devices.filter((d) => d.type === type);
+        }
+        return devices;
+    }
+    /**
+     * Gets the audio format of a specific device.
+     * @param deviceId The device ID to query
+     * @returns AudioFormat object
+     */
+    static getDeviceFormat(deviceId) {
+        return native.AudioController.getDeviceFormat(deviceId);
+    }
+    /**
+     * Checks the current permission status for audio recording.
+     * On Windows, always returns { mic: true, system: true } as no explicit permissions are required.
+     * On macOS, checks actual permission status for microphone and screen recording.
+     * @returns PermissionStatus object with mic and system boolean fields
+     */
+    static checkPermission() {
+        return native.AudioController.checkPermission();
+    }
+    /**
+     * Requests permission for the specified type.
+     * On Windows, always returns true as no explicit permissions are required.
+     * On macOS, prompts the user to grant the requested permission.
+     * @param type The permission type to request: 'mic' for microphone, 'system' for system audio
+     * @returns true if permission was granted, false otherwise
+     */
+    static requestPermission(type) {
+        return native.AudioController.requestPermission(type);
+    }
+}
+exports.AudioRecorder = AudioRecorder;
+// Export raw bindings for testing if needed
+exports.nativeBindings = bindings_1.default;

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/typescript/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,+BAA+B;AAC/B,0CAAwB;AACxB,6CAA2B;AAE3B,iCAAiC;AACjC,uCAAiD;AAAxC,mGAAA,QAAQ,OAAW"}

package/dist/recorder.d.ts

@@ -0,0 +1,56 @@
+import { Result, PermissionStatus, AudioDevice, RecordingOptions, RecordingState, AudioSDKError, AudioDeviceType, RecordingStreamEvent } from "./types";
+/**
+ * Main Audio SDK Recorder class
+ */
+export declare class Recorder {
+    private state;
+    private currentController?;
+    private recorderId?;
+    /**
+     * Private constructor that prevents direct instantiation of the Recorder class.
+     *
+     * Use the static `Recorder.create()` method instead to create instances.
+     *
+     * @deprecated This constructor should not be called directly. Use Recorder.create() instead.
+     * @private
+     */
+    constructor(internal?: boolean);
+    /**
+     * Factory method to create a new Recorder instance
+     */
+    static create(): Promise<Recorder>;
+    private initializeNative;
+    /**
+     * Check current permissions without requesting them
+     */
+    checkPermissions(): Promise<Result<PermissionStatus>>;
+    /**
+     * Get list of available audio devices
+     */
+    getAudioDevices(type?: AudioDeviceType): Promise<Result<AudioDevice[]>>;
+    /**
+     * Start recording with async generator pattern
+     */
+    startRecording(options: RecordingOptions): Promise<Result<AsyncGenerator<RecordingStreamEvent>, AudioSDKError>>;
+    /**
+     * Private method to create the recording generator
+     */
+    private createRecordingGenerator;
+    /**
+     * Stop current recording
+     */
+    stopRecording(): Promise<Result<void>>;
+    /**
+     * Get current recording state
+     */
+    getState(): RecordingState;
+    /**
+     * Clean up resources
+     */
+    private cleanup;
+    /**
+     * Dispose of the recorder and free native resources
+     */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=recorder.d.ts.map

package/dist/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/typescript/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAEhB,cAAc,EACd,aAAa,EAEb,eAAe,EACf,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAejB;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,iBAAiB,CAAC,CAAkB;IAC5C,OAAO,CAAC,UAAU,CAAC,CAAS;IAE5B;;;;;;;OAOG;gBACS,QAAQ,UAAQ;IAQ5B;;OAEG;WACU,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC;YAM1B,gBAAgB;IAY9B;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAqC3D;;OAEG;IACG,eAAe,CACnB,IAAI,CAAC,EAAE,eAAe,GACrB,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAkEjC;;OAEG;IACG,cAAc,CAClB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,oBAAoB,CAAC,EAAE,aAAa,CAAC,CAAC;IA4EvE;;OAEG;YACY,wBAAwB;IAoEvC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAsD5C;;OAEG;IACH,QAAQ,IAAI,cAAc;IAI1B;;OAEG;YACW,OAAO;IAarB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAY/B"}

package/dist/recorder.js

@@ -0,0 +1,343 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Recorder = void 0;
+const types_1 = require("./types");
+const path = __importStar(require("path"));
+// import nativeAddon from "../../build/Release/audio_sdk_native.node";
+// Import the native addon with correct path resolution
+const nativeAddon = require(path.join(__dirname, "../..", "build", "Release", "audio_sdk_native.node"));
+/**
+ * Main Audio SDK Recorder class
+ */
+class Recorder {
+    /**
+     * Private constructor that prevents direct instantiation of the Recorder class.
+     *
+     * Use the static `Recorder.create()` method instead to create instances.
+     *
+     * @deprecated This constructor should not be called directly. Use Recorder.create() instead.
+     * @private
+     */
+    constructor(internal = false) {
+        this.state = types_1.RecordingState.IDLE;
+        if (!internal) {
+            console.error("Do not instantiate Recorder directly, use Recorder.create() instead");
+        }
+    }
+    /**
+     * Factory method to create a new Recorder instance
+     */
+    static async create() {
+        const recorder = new Recorder(true);
+        await recorder.initializeNative();
+        return recorder;
+    }
+    async initializeNative() {
+        const result = nativeAddon.createRecorder();
+        if (!result.success) {
+            throw new types_1.AudioSDKError(types_1.AudioSDKErrorType.INITIALIZATION_FAILED, "Failed to initialize native recorder", result.error);
+        }
+        this.recorderId = result.value;
+    }
+    /**
+     * Check current permissions without requesting them
+     */
+    async checkPermissions() {
+        if (!this.recorderId) {
+            return {
+                success: false,
+                error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.INITIALIZATION_FAILED, "Recorder not initialized"),
+            };
+        }
+        try {
+            const result = nativeAddon.checkPermissions(this.recorderId);
+            if (result.success) {
+                return { success: true, value: result.value };
+            }
+            else {
+                return {
+                    success: false,
+                    error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.PERMISSION_DENIED, result.error.message, result.error),
+                };
+            }
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.PERMISSION_DENIED, "Failed to check permissions", error),
+            };
+        }
+    }
+    /**
+     * Get list of available audio devices
+     */
+    async getAudioDevices(type) {
+        if (!this.recorderId) {
+            return {
+                success: false,
+                error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.INITIALIZATION_FAILED, "Recorder not initialized"),
+            };
+        }
+        try {
+            const devices = [];
+            const deviceTypes = type !== undefined
+                ? [type]
+                : [
+                    types_1.AudioDeviceType.MICROPHONE,
+                    types_1.AudioDeviceType.SYSTEM_AUDIO,
+                    types_1.AudioDeviceType.APPLICATION,
+                ];
+            for (const deviceType of deviceTypes) {
+                const countResult = nativeAddon.getDeviceCount(this.recorderId, deviceType);
+                if (!countResult.success) {
+                    console.warn(`Failed to get device count for type ${deviceType}: ${countResult.error.message}`);
+                    continue;
+                }
+                const count = countResult.value;
+                for (let i = 0; i < count; i++) {
+                    const deviceResult = nativeAddon.getDeviceInfo(this.recorderId, deviceType, i);
+                    if (deviceResult.success) {
+                        devices.push({
+                            id: deviceResult.value.id,
+                            name: deviceResult.value.name,
+                            type: deviceResult.value.type,
+                            isDefault: deviceResult.value.isDefault,
+                        });
+                    }
+                }
+            }
+            return { success: true, value: devices };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.DEVICE_NOT_FOUND, "Failed to enumerate audio devices", error),
+            };
+        }
+    }
+    /**
+     * Start recording with async generator pattern
+     */
+    async startRecording(options) {
+        if (this.state !== types_1.RecordingState.IDLE) {
+            return {
+                success: false,
+                error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.RECORDING_FAILED, `Cannot start recording in ${this.state} state`),
+            };
+        }
+        if (!this.recorderId) {
+            return {
+                success: false,
+                error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.INITIALIZATION_FAILED, "Recorder not initialized"),
+            };
+        }
+        try {
+            // Convert options to native format
+            const nativeOptions = {
+                deviceType: options.deviceType,
+                deviceId: options.deviceId,
+                format: options.format || {
+                    sampleRate: 44100,
+                    channels: 2,
+                    bitDepth: 16,
+                },
+                application: options.application,
+            };
+            // Initialize native recording
+            const initResult = nativeAddon.startRecording(this.recorderId, nativeOptions);
+            if (!initResult.success) {
+                this.state = types_1.RecordingState.ERROR;
+                return {
+                    success: false,
+                    error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.INITIALIZATION_FAILED, initResult.error.message, initResult.error),
+                };
+            }
+            this.state = types_1.RecordingState.RECORDING;
+            // Create abort controller for clean cancellation
+            this.currentController = new AbortController();
+            // Create the async generator
+            const generator = this.createRecordingGenerator();
+            return {
+                success: true,
+                value: generator,
+            };
+        }
+        catch (error) {
+            this.state = types_1.RecordingState.ERROR;
+            return {
+                success: false,
+                error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.INITIALIZATION_FAILED, "Failed to initialize recording", error),
+            };
+        }
+    }
+    /**
+     * Private method to create the recording generator
+     */
+    async *createRecordingGenerator() {
+        try {
+            // Start audio stream
+            while (!this.currentController?.signal.aborted &&
+                this.state === types_1.RecordingState.RECORDING) {
+                try {
+                    // Check if still recording
+                    const statusResult = nativeAddon.isRecording(this.recorderId);
+                    if (!statusResult.success || !statusResult.value) {
+                        break;
+                    }
+                    const chunkResult = nativeAddon.getAudioChunk(this.recorderId);
+                    if (chunkResult.success) {
+                        yield {
+                            type: "chunk",
+                            data: {
+                                data: chunkResult.value.data,
+                                timestamp: chunkResult.value.timestamp,
+                                format: chunkResult.value.format,
+                            },
+                        };
+                    }
+                    else {
+                        this.state = types_1.RecordingState.ERROR;
+                        yield {
+                            type: "error",
+                            error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.RECORDING_FAILED, chunkResult.error.message, chunkResult.error),
+                        };
+                        break;
+                    }
+                    // Small delay to prevent busy waiting
+                    await new Promise((resolve) => setTimeout(resolve, 10));
+                }
+                catch (error) {
+                    this.state = types_1.RecordingState.ERROR;
+                    yield {
+                        type: "error",
+                        error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.RECORDING_FAILED, "Error during recording", error),
+                    };
+                    break;
+                }
+            }
+        }
+        catch (error) {
+            this.state = types_1.RecordingState.ERROR;
+            yield {
+                type: "error",
+                error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.INITIALIZATION_FAILED, "Failed to initialize recording", error),
+            };
+        }
+        finally {
+            await this.cleanup();
+        }
+    }
+    /**
+     * Stop current recording
+     */
+    async stopRecording() {
+        if (this.state !== types_1.RecordingState.RECORDING) {
+            return {
+                success: false,
+                error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.RECORDING_FAILED, `Cannot stop recording in ${this.state} state`),
+            };
+        }
+        if (!this.recorderId) {
+            return {
+                success: false,
+                error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.INITIALIZATION_FAILED, "Recorder not initialized"),
+            };
+        }
+        try {
+            if (this.currentController) {
+                this.currentController.abort();
+            }
+            const result = nativeAddon.stopRecording(this.recorderId);
+            if (result.success) {
+                this.state = types_1.RecordingState.STOPPED;
+                return { success: true, value: undefined };
+            }
+            else {
+                this.state = types_1.RecordingState.ERROR;
+                return {
+                    success: false,
+                    error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.RECORDING_FAILED, result.error.message, result.error),
+                };
+            }
+        }
+        catch (error) {
+            this.state = types_1.RecordingState.ERROR;
+            return {
+                success: false,
+                error: new types_1.AudioSDKError(types_1.AudioSDKErrorType.RECORDING_FAILED, "Failed to stop recording", error),
+            };
+        }
+    }
+    /**
+     * Get current recording state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Clean up resources
+     */
+    async cleanup() {
+        try {
+            if (this.state === types_1.RecordingState.RECORDING && this.recorderId) {
+                nativeAddon.stopRecording(this.recorderId);
+            }
+            this.state = types_1.RecordingState.IDLE;
+            this.currentController = undefined;
+        }
+        catch (error) {
+            // Log error but don't throw in cleanup
+            console.error("Error during cleanup:", error);
+        }
+    }
+    /**
+     * Dispose of the recorder and free native resources
+     */
+    async dispose() {
+        await this.cleanup();
+        if (this.recorderId) {
+            try {
+                nativeAddon.destroyRecorder(this.recorderId);
+            }
+            catch (error) {
+                console.error("Error destroying native recorder:", error);
+            }
+            this.recorderId = undefined;
+        }
+    }
+}
+exports.Recorder = Recorder;
+//# sourceMappingURL=recorder.js.map

package/dist/recorder.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Result type for error handling - Either success with value or failure with error
+ */
+export type Result<T, E = Error> = {
+    success: true;
+    value: T;
+} | {
+    success: false;
+    error: E;
+};
+/**
+ * Audio device types
+ */
+export declare enum AudioDeviceType {
+    MICROPHONE = 0,
+    SYSTEM_AUDIO = 1,
+    APPLICATION = 2
+}
+/**
+ * Audio format configuration
+ */
+export interface AudioFormat {
+    sampleRate: number;
+    channels: number;
+    bitDepth: 16 | 24 | 32;
+}
+/**
+ * Audio device information
+ */
+export interface AudioDevice {
+    id: string;
+    name: string;
+    type: AudioDeviceType;
+    isDefault: boolean;
+}
+/**
+ * Application information for application-specific recording
+ */
+export interface ApplicationInfo {
+    pid: number;
+    name: string;
+    bundleId?: string;
+}
+/**
+ * Recording options
+ */
+export interface RecordingOptions {
+    deviceType: AudioDeviceType;
+    deviceId: string;
+    format?: AudioFormat;
+    application?: ApplicationInfo;
+}
+/**
+ * Audio chunk data
+ */
+export interface AudioChunk {
+    data: Buffer;
+    timestamp: number;
+    format: AudioFormat;
+}
+/**
+ * Permission types
+ */
+export interface PermissionStatus {
+    microphone: boolean;
+    systemAudio: boolean;
+}
+/**
+ * Error types
+ */
+export declare enum AudioSDKErrorType {
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    DEVICE_NOT_FOUND = "DEVICE_NOT_FOUND",
+    DEVICE_BUSY = "DEVICE_BUSY",
+    INITIALIZATION_FAILED = "INITIALIZATION_FAILED",
+    RECORDING_FAILED = "RECORDING_FAILED",
+    INVALID_FORMAT = "INVALID_FORMAT",
+    PLATFORM_NOT_SUPPORTED = "PLATFORM_NOT_SUPPORTED"
+}
+/**
+ * Custom error class for Audio SDK
+ */
+export declare class AudioSDKError extends Error {
+    type: AudioSDKErrorType;
+    details?: any | undefined;
+    constructor(type: AudioSDKErrorType, message: string, details?: any | undefined);
+}
+/**
+ * Recording state
+ */
+export declare enum RecordingState {
+    IDLE = "idle",
+    RECORDING = "recording",
+    PAUSED = "paused",
+    STOPPED = "stopped",
+    ERROR = "error"
+}
+/**
+ * Recording stream event types
+ */
+export type RecordingStreamEvent = {
+    type: "chunk";
+    data: AudioChunk;
+} | {
+    type: "error";
+    error: AudioSDKError;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/typescript/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAC3B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC3B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAEjC;;GAEG;AACH,oBAAY,eAAe;IACzB,UAAU,IAAI;IACd,YAAY,IAAI;IAChB,WAAW,IAAI;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,WAAW,gBAAgB;IAC3B,qBAAqB,0BAA0B;IAC/C,gBAAgB,qBAAqB;IACrC,cAAc,mBAAmB;IACjC,sBAAsB,2BAA2B;CAClD;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAE7B,IAAI,EAAE,iBAAiB;IAEvB,OAAO,CAAC,EAAE,GAAG;gBAFb,IAAI,EAAE,iBAAiB,EAC9B,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,GAAG,YAAA;CAKvB;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC"}