@ya-modbus/cli 0.4.1-refactor-scope-driver-packages.0

package/dist/src/formatters/performance.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Performance metrics
+ */
+export interface PerformanceMetrics {
+    /** Total response time in milliseconds */
+    responseTimeMs: number;
+    /** Number of operations performed */
+    operations: number;
+    /** Number of errors encountered */
+    errors: number;
+}
+/**
+ * Format performance metrics for display
+ *
+ * @param metrics - Performance metrics
+ * @returns Formatted string with performance info
+ */
+export declare function formatPerformance(metrics: PerformanceMetrics): string;
+//# sourceMappingURL=performance.d.ts.map

package/dist/src/formatters/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../../src/formatters/performance.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAA;IACtB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAiBrE"}

package/dist/src/formatters/performance.js

@@ -0,0 +1,24 @@
+import chalk from 'chalk';
+/**
+ * Format performance metrics for display
+ *
+ * @param metrics - Performance metrics
+ * @returns Formatted string with performance info
+ */
+export function formatPerformance(metrics) {
+    const { responseTimeMs, operations, errors } = metrics;
+    const lines = [
+        chalk.bold('\nPerformance:'),
+        `  Response time: ${responseTimeMs.toFixed(1)}ms`,
+        `  Operations: ${operations}`,
+    ];
+    // Highlight errors if present
+    if (errors > 0) {
+        lines.push(chalk.red(`  Errors: ${errors}`));
+    }
+    else {
+        lines.push(chalk.green(`  Errors: ${errors}`));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=performance.js.map

package/dist/src/formatters/performance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../../src/formatters/performance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAczB;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAEtD,MAAM,KAAK,GAAG;QACZ,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC;QAC5B,oBAAoB,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QACjD,iBAAiB,UAAU,EAAE;KAC9B,CAAA;IAED,8BAA8B;IAC9B,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC,CAAA;IAC9C,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC,CAAA;IAChD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/src/formatters/table.d.ts

@@ -0,0 +1,10 @@
+import type { DataPoint } from '@ya-modbus/driver-types';
+/**
+ * Format data point results as a table
+ *
+ * @param dataPoints - Data point definitions
+ * @param values - Data point values (keyed by ID)
+ * @returns Formatted table string
+ */
+export declare function formatTable(dataPoints: ReadonlyArray<DataPoint>, values: Record<string, unknown>): string;
+//# sourceMappingURL=table.d.ts.map

package/dist/src/formatters/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../src/formatters/table.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AA0ExD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,EACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAuBR"}

package/dist/src/formatters/table.js

@@ -0,0 +1,91 @@
+import chalk from 'chalk';
+import Table from 'cli-table3';
+/**
+ * Convert unknown value to string representation
+ *
+ * @param value - Value to stringify
+ * @returns String representation
+ */
+function stringifyValue(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    // For objects/arrays, use JSON to avoid '[object Object]'
+    return JSON.stringify(value);
+}
+/**
+ * Format a value based on data point metadata
+ *
+ * @param value - Raw value
+ * @param dataPoint - Data point definition
+ * @returns Formatted string
+ */
+function formatValue(value, dataPoint) {
+    // Handle null/undefined
+    if (value === null || value === undefined) {
+        return chalk.gray('N/A');
+    }
+    // Format based on type
+    switch (dataPoint.type) {
+        case 'float': {
+            const num = value;
+            const decimals = dataPoint.decimals ?? 2;
+            return num.toFixed(decimals);
+        }
+        case 'integer':
+            return stringifyValue(value);
+        case 'boolean':
+            return value ? chalk.green('true') : chalk.red('false');
+        case 'enum': {
+            if (dataPoint.enumValues) {
+                const enumKey = stringifyValue(value);
+                return dataPoint.enumValues[enumKey] ?? stringifyValue(value);
+            }
+            return stringifyValue(value);
+        }
+        case 'timestamp': {
+            if (value instanceof Date) {
+                return value.toISOString();
+            }
+            return stringifyValue(value);
+        }
+        case 'string':
+            return stringifyValue(value);
+        default:
+            return stringifyValue(value);
+    }
+}
+/**
+ * Format data point results as a table
+ *
+ * @param dataPoints - Data point definitions
+ * @param values - Data point values (keyed by ID)
+ * @returns Formatted table string
+ */
+export function formatTable(dataPoints, values) {
+    // Create table with headers
+    const table = new Table({
+        head: [chalk.bold('Data Point'), chalk.bold('Value'), chalk.bold('Unit')],
+        style: {
+            head: ['cyan'],
+        },
+    });
+    // Add rows for each data point that has a value
+    for (const dp of dataPoints) {
+        if (!(dp.id in values)) {
+            continue;
+        }
+        const displayName = dp.name ?? dp.id;
+        const formattedValue = formatValue(values[dp.id], dp);
+        const unit = dp.unit ?? '';
+        table.push([displayName, formattedValue, unit]);
+    }
+    return table.toString();
+}
+//# sourceMappingURL=table.js.map

package/dist/src/formatters/table.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+declare const program: Command;
+export { program };
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAmEnC,QAAA,MAAM,OAAO,SAAgB,CAAA;AAqI7B,OAAO,EAAE,OAAO,EAAE,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { discoverCommand } from './commands/discover.js';
+import { listDevicesCommand } from './commands/list-devices.js';
+import { readCommand } from './commands/read.js';
+import { showDefaultsCommand } from './commands/show-defaults.js';
+import { writeCommand } from './commands/write.js';
+/**
+ * Add common connection and driver options to a command
+ *
+ * @param command - Commander.js command instance
+ * @returns The command with connection options added
+ */
+function addConnectionOptions(command) {
+    return (command
+        // Driver Options
+        .optionsGroup('Driver Options:')
+        .option('-d, --driver <package>', 'Driver package name (e.g., ya-modbus-driver-xymd1). Use "show-defaults" to see driver config')
+        .option('--device <key>', 'Device key for multi-device drivers. Use "list-devices" to see available devices')
+        // Connection Options
+        .optionsGroup('Connection Options:')
+        .requiredOption('-s, --slave-id <id>', 'Modbus slave ID (1-247). May use driver default if available', parseInt)
+        .option('--timeout <ms>', 'Response timeout in milliseconds (default: 1000)', parseInt)
+        // RTU Connection
+        .optionsGroup('RTU Connection (choose this OR TCP):')
+        .option('-p, --port <path>', 'Serial port for RTU (e.g., /dev/ttyUSB0, COM3)')
+        .option('-b, --baud-rate <rate>', 'Baud rate (RTU only). Uses driver default if not specified', parseInt)
+        .option('--parity <type>', 'Parity: none, even, odd (RTU only). Uses driver default if not specified')
+        .option('--data-bits <bits>', 'Data bits: 7 or 8 (RTU only). Uses driver default if not specified', parseInt)
+        .option('--stop-bits <bits>', 'Stop bits: 1 or 2 (RTU only). Uses driver default if not specified', parseInt)
+        // TCP Connection
+        .optionsGroup('TCP Connection (choose this OR RTU):')
+        .option('-h, --host <host>', 'TCP host for Modbus TCP (e.g., 192.168.1.100)')
+        .option('--tcp-port <port>', 'TCP port (default: 502)', parseInt));
+}
+const program = new Command();
+program
+    .name('ya-modbus')
+    .description('CLI tool for testing and developing Modbus device drivers')
+    .version('0.0.0')
+    .addHelpText('after', `
+Examples:
+  $ ya-modbus read --port /dev/ttyUSB0 --slave-id 1 --driver ya-modbus-driver-xymd1 --all
+  $ ya-modbus write --host 192.168.1.100 --slave-id 1 --data-point voltage --value 220
+  $ ya-modbus discover --port /dev/ttyUSB0 --strategy quick
+  $ ya-modbus show-defaults --driver ya-modbus-driver-xymd1
+    `);
+// Device Operations
+program.commandsGroup('Device Operations:');
+// Read command
+addConnectionOptions(program.command('read').description('Read data points from device'))
+    .optionsGroup('Data Selection:')
+    .option('--data-point <id...>', 'Data point ID(s) to read')
+    .option('--all', 'Read all readable data points')
+    .optionsGroup('Output Options:')
+    .option('-f, --format <type>', 'Output format: table or json (default: table)', 'table')
+    .action(async (options) => {
+    try {
+        // tcpPort is parsed by Commander but not used by readCommand (transport layer handles it).
+        // Destructure it out to avoid passing undefined (exactOptionalPropertyTypes requirement).
+        const { tcpPort: _tcpPort, ...commandOptions } = options;
+        await readCommand(commandOptions);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+// Write command
+addConnectionOptions(program.command('write').description('Write data point to device'))
+    .optionsGroup('Data Options:')
+    .requiredOption('--data-point <id>', 'Data point ID to write')
+    .requiredOption('--value <value>', 'Value to write')
+    .optionsGroup('Write Options:')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--verify', 'Read back and verify written value')
+    .action(async (options) => {
+    try {
+        // tcpPort is parsed by Commander but not used by writeCommand (transport layer handles it).
+        // Destructure it out to avoid passing undefined (exactOptionalPropertyTypes requirement).
+        const { tcpPort: _tcpPort, ...commandOptions } = options;
+        await writeCommand(commandOptions);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+// Device Discovery
+program.commandsGroup('Device Discovery:');
+// Discover command
+program
+    .command('discover')
+    .description('Discover Modbus devices on serial port by scanning slave IDs and parameters')
+    .optionsGroup('Connection:')
+    .requiredOption('-p, --port <path>', 'Serial port for RTU (e.g., /dev/ttyUSB0, COM3)')
+    .optionsGroup('Driver Options:')
+    .option('-d, --driver <package>', 'Driver package (auto-detects from cwd if not specified)')
+    .optionsGroup('Discovery Options:')
+    .option('--strategy <type>', 'Discovery strategy: quick (driver params) or thorough (all params)', 'quick')
+    .option('--timeout <ms>', 'Response timeout in milliseconds (default: 1000)', parseInt)
+    .option('--delay <ms>', 'Delay between attempts in milliseconds (default: 100)', parseInt)
+    .option('--max-devices <count>', 'Maximum number of devices to find (default: 1, use 0 for unlimited)', parseInt)
+    .optionsGroup('Output Options:')
+    .option('--verbose', 'Show detailed progress with current parameters being tested')
+    .option('--silent', 'Suppress all output except final result (useful for scripts)')
+    .option('-f, --format <type>', 'Output format: table or json (default: table)', 'table')
+    .action(async (options) => {
+    try {
+        await discoverCommand(options);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+// Driver Utilities
+program.commandsGroup('Driver Utilities:');
+// List devices command
+program
+    .command('list-devices')
+    .description('List supported devices from driver DEVICES registry')
+    .optionsGroup('Driver Options:')
+    .option('-d, --driver <package>', 'Driver package (auto-detects from cwd if not specified)')
+    .optionsGroup('Output Options:')
+    .option('-f, --format <type>', 'Output format: table or json (default: table)', 'table')
+    .action(async (options) => {
+    try {
+        await listDevicesCommand(options);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+// Show defaults command
+program
+    .command('show-defaults')
+    .description('Show driver DEFAULT_CONFIG and SUPPORTED_CONFIG')
+    .optionsGroup('Driver Options:')
+    .option('-d, --driver <package>', 'Driver package (auto-detects from cwd if not specified)')
+    .optionsGroup('Output Options:')
+    .option('-f, --format <type>', 'Output format: table or json (default: table)', 'table')
+    .action(async (options) => {
+    try {
+        await showDefaultsCommand(options);
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+export { program };
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/utils/commands.d.ts

@@ -0,0 +1,191 @@
+import { type LoadedDriver } from '@ya-modbus/driver-loader';
+import type { BaudRate, DataBits, DataPoint, DefaultSerialConfig, DeviceDriver, Parity, StopBits, Transport } from '@ya-modbus/driver-types';
+/**
+ * Default RTU transport configuration values
+ */
+export declare const DEFAULT_RTU_CONFIG: {
+    readonly port: "/dev/ttyUSB0";
+    readonly baudRate: BaudRate;
+    readonly dataBits: DataBits;
+    readonly parity: Parity;
+    readonly stopBits: StopBits;
+};
+/**
+ * Default TCP port for Modbus TCP
+ */
+export declare const DEFAULT_TCP_PORT = 502;
+/**
+ * Check if a data point is readable
+ */
+export declare function isReadable(dataPoint: DataPoint): boolean;
+/**
+ * Check if a data point is writable
+ */
+export declare function isWritable(dataPoint: DataPoint): boolean;
+/**
+ * Find a data point by ID
+ *
+ * @param driver - Device driver instance
+ * @param id - Data point ID
+ * @returns Data point definition
+ * @throws Error if data point not found
+ */
+export declare function findDataPoint(driver: DeviceDriver, id: string): DataPoint;
+/**
+ * Find and validate a readable data point
+ *
+ * @param driver - Device driver instance
+ * @param id - Data point ID
+ * @returns Data point definition
+ * @throws Error if data point not found or not readable
+ */
+export declare function findReadableDataPoint(driver: DeviceDriver, id: string): DataPoint;
+/**
+ * Find and validate a writable data point
+ *
+ * @param driver - Device driver instance
+ * @param id - Data point ID
+ * @returns Data point definition
+ * @throws Error if data point not found or not writable
+ */
+export declare function findWritableDataPoint(driver: DeviceDriver, id: string): DataPoint;
+/**
+ * Compare two floating point numbers for approximate equality
+ *
+ * Uses relative error to handle both very small and very large values correctly.
+ * Also checks absolute error to handle values near zero.
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @param relativeEpsilon - Relative error tolerance (default: 1e-6, or 0.0001%)
+ * @param absoluteEpsilon - Absolute error tolerance for values near zero (default: 1e-9)
+ * @returns True if values are approximately equal
+ */
+export declare function floatsEqual(a: number, b: number, relativeEpsilon?: number, absoluteEpsilon?: number): boolean;
+/**
+ * Parse value string based on data point type
+ */
+export declare function parseValue(valueStr: string, dataPoint: DataPoint): unknown;
+/**
+ * Validate value against data point constraints
+ */
+export declare function validateValue(value: unknown, dataPoint: DataPoint): void;
+/**
+ * Prompt user for confirmation
+ */
+export declare function confirm(message: string): Promise<boolean>;
+/**
+ * Options for creating a transport
+ */
+export interface TransportOptions {
+    host?: string;
+    port?: string | number;
+    baudRate?: number;
+    dataBits?: number;
+    parity?: string;
+    stopBits?: number;
+    slaveId: number;
+    timeout?: number;
+}
+/**
+ * Options for loading a driver
+ */
+export interface DriverOptions {
+    driver?: string;
+    device?: string;
+    slaveId: number;
+}
+/**
+ * Execute a function with a transport, ensuring cleanup
+ *
+ * @param options - Transport configuration options
+ * @param fn - Function to execute with the transport
+ * @returns Result of the function
+ */
+export declare function withTransport<T>(options: TransportOptions, fn: (transport: Transport) => Promise<T>): Promise<T>;
+/**
+ * Load driver metadata without creating an instance
+ *
+ * When no driver name is provided, auto-detects from current working directory.
+ *
+ * @param driverName - Optional driver package name (auto-detects from cwd if not specified)
+ * @returns Loaded driver metadata
+ */
+export declare function loadDriverMetadata(driverName?: string): Promise<LoadedDriver>;
+/**
+ * Get the effective default config for a device
+ *
+ * Returns device-specific config if available, otherwise driver-level config.
+ *
+ * @param driverMetadata - Loaded driver metadata
+ * @param device - Optional device key
+ * @returns Effective default config or undefined
+ */
+export declare function getEffectiveDefaultConfig(driverMetadata: LoadedDriver | undefined, device: string | undefined): DefaultSerialConfig | undefined;
+/**
+ * Get the effective supported config for a device
+ *
+ * Returns device-specific constraints if available, otherwise driver-level constraints.
+ *
+ * @param driverMetadata - Loaded driver metadata
+ * @param device - Optional device key
+ * @returns Effective supported config or undefined
+ */
+export declare function getEffectiveSupportedConfig(driverMetadata: LoadedDriver | undefined, device: string | undefined): LoadedDriver['supportedConfig'] | undefined;
+/**
+ * Create an effective driver metadata with device-specific configs resolved
+ *
+ * This creates a view of the driver metadata where defaultConfig and supportedConfig
+ * are resolved based on the selected device. This allows validation and other
+ * functions to work with device-specific settings transparently.
+ *
+ * @param driverMetadata - Loaded driver metadata
+ * @param device - Optional device key
+ * @returns Driver metadata with effective configs for the selected device
+ */
+export declare function getEffectiveDriverMetadata(driverMetadata: LoadedDriver, device: string | undefined): LoadedDriver;
+/**
+ * Apply driver defaults to transport options
+ *
+ * Uses device-specific defaults if a device is selected, otherwise driver-level defaults.
+ *
+ * @param options - Transport options (may be incomplete)
+ * @param driverMetadata - Loaded driver metadata with defaults
+ * @param device - Optional device key for multi-device drivers
+ * @returns Transport options with defaults applied
+ */
+export declare function applyDriverDefaults(options: TransportOptions, driverMetadata?: LoadedDriver, device?: string): TransportOptions;
+/**
+ * Execute a function with a driver instance, ensuring cleanup
+ *
+ * @param transport - Transport to use for driver communication
+ * @param driverMetadata - Loaded driver metadata
+ * @param slaveId - Modbus slave ID
+ * @param device - Optional device key for multi-device drivers
+ * @param fn - Function to execute with the driver
+ * @returns Result of the function
+ */
+export declare function withDriverInstance<T>(transport: Transport, driverMetadata: LoadedDriver, slaveId: number, device: string | undefined, fn: (driver: DeviceDriver) => Promise<T>): Promise<T>;
+/**
+ * Execute a function with a driver instance, handling the complete workflow
+ *
+ * This is a convenience function that:
+ * 1. Loads driver metadata (DEFAULT_CONFIG, SUPPORTED_CONFIG)
+ * 2. Validates user options against driver constraints (SUPPORTED_CONFIG)
+ * 3. Applies driver defaults to user options
+ * 4. Validates merged options (catches invalid third-party driver defaults)
+ * 5. Creates transport with merged configuration
+ * 6. Creates driver instance
+ * 7. Executes callback with driver and merged options
+ * 8. Ensures cleanup (closes transport)
+ *
+ * @param options - Combined transport and driver options
+ * @param fn - Function to execute with the driver (and optionally merged config)
+ * @returns Result of the function
+ * @throws ValidationError if user options or driver defaults violate constraints
+ */
+export declare function withDriver<T>(options: TransportOptions & {
+    driver?: string;
+    device?: string;
+}, fn: (driver: DeviceDriver, mergedOptions: TransportOptions) => Promise<T>): Promise<T>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/src/utils/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/utils/commands.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACxE,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,SAAS,EACV,MAAM,yBAAyB,CAAA;AAMhC;;GAEG;AACH,eAAO,MAAM,kBAAkB;;uBAEX,QAAQ;uBACX,QAAQ;qBACL,MAAM;uBACT,QAAQ;CACf,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAGxD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAGxD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAQzE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAQjF;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,CAQjF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,eAAe,SAAO,EACtB,eAAe,SAAO,GACrB,OAAO,CAaT;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAuB1E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAyBxE;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAY/D;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAE/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAGtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IAGjB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,OAAO,EAAE,gBAAgB,EACzB,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,CAAC,CAAC,CA8BZ;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAEnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,YAAY,GAAG,SAAS,EACxC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,mBAAmB,GAAG,SAAS,CAoBjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,cAAc,EAAE,YAAY,GAAG,SAAS,EACxC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,YAAY,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAY7C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,YAAY,EAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,YAAY,CAsBd;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,EACzB,cAAc,CAAC,EAAE,YAAY,EAC7B,MAAM,CAAC,EAAE,MAAM,GACd,gBAAgB,CAsBlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,YAAY,EAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,EAAE,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,OAAO,EAAE,gBAAgB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAChE,EAAE,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,GACxE,OAAO,CAAC,CAAC,CAAC,CAmDZ"}