@ya-modbus/cli 0.8.0 → 0.9.1

package/dist/esm/src/utils/parse-id-range.js

@@ -1,3 +1,5 @@
+import { parseInteger } from './parse-integer.js';
+import { parseSpec } from './parse-spec.js';
 /**
  * Parses a comma-separated list of IDs and ranges into a sorted array of unique IDs.
  *
@@ -10,41 +12,28 @@
  * parseIdRange("1-3,2-4") // [1, 2, 3, 4]
  */
 export function parseIdRange(spec) {
-    const trimmed = spec.trim();
-    if (!trimmed) {
-        throw new Error('Invalid ID specification: empty string. Expected format: "1,2,3" or "1-5"');
-    }
-    const ids = new Set();
-    const parts = trimmed.split(',');
-    for (const part of parts) {
-        const normalized = part.trim();
-        if (!normalized)
-            continue;
-        // Check if it's a range (contains hyphen)
-        if (normalized.includes('-')) {
-            const rangeParts = normalized.split('-').map((s) => s.trim());
-            if (rangeParts.length !== 2 || !rangeParts[0] || !rangeParts[1]) {
-                throw new Error(`Invalid range format: "${part}". Expected format: "start-end"`);
-            }
-            const start = parseInteger(rangeParts[0], part);
-            const end = parseInteger(rangeParts[1], part);
-            if (start > end) {
-                throw new Error(`Invalid range: "${part}". Start must be less than or equal to end`);
-            }
-            validateModbusAddress(start, part);
-            validateModbusAddress(end, part);
-            for (let i = start; i <= end; i++) {
-                ids.add(i);
+    return parseSpec({
+        spec,
+        label: 'ID',
+        formatExamples: ['"1,2,3"', '"1-5"'],
+        skipEmptyParts: true,
+        parseSingle: (value, context) => {
+            const id = parseInteger(value, context, 'ID');
+            validateModbusAddress(id, context);
+            return id;
+        },
+        parseRange: (start, end, context) => {
+            const startId = parseInteger(start, context, 'ID');
+            const endId = parseInteger(end, context, 'ID');
+            if (startId > endId) {
+                throw new Error(`Invalid range: "${context}". Start must be less than or equal to end`);
             }
-        }
-        else {
-            // Single ID
-            const id = parseInteger(normalized, part);
-            validateModbusAddress(id, part);
-            ids.add(id);
-        }
-    }
-    return Array.from(ids).sort((a, b) => a - b);
+            validateModbusAddress(startId, context);
+            validateModbusAddress(endId, context);
+            return Array.from({ length: endId - startId + 1 }, (_, i) => startId + i);
+        },
+        sortItems: (items) => items.sort((a, b) => a - b),
+    });
 }
 /**
  * Validates that a number is a valid Modbus slave address (1-247).
@@ -54,18 +43,4 @@ function validateModbusAddress(id, context) {
         throw new Error(`Invalid Modbus slave address: ${id} in "${context}". ` + `Valid addresses are 1-247`);
     }
 }
-/**
- * Parses a string to an integer with validation.
- * Rejects decimal numbers explicitly.
- */
-function parseInteger(str, context) {
-    if (str.includes('.')) {
-        throw new Error(`Invalid ID format: "${context}". Decimal numbers not allowed, expected whole numbers only`);
-    }
-    const num = parseInt(str, 10);
-    if (isNaN(num)) {
-        throw new Error(`Invalid ID format: "${context}". Expected a number`);
-    }
-    return num;
-}
 //# sourceMappingURL=parse-id-range.js.map

package/dist/esm/src/utils/parse-id-range.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse-id-range.js","sourceRoot":"","sources":["../../../../src/utils/parse-id-range.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parse-id-range.js","sourceRoot":"","sources":["../../../../src/utils/parse-id-range.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,SAAS,CAAC;QACf,IAAI;QACJ,KAAK,EAAE,IAAI;QACX,cAAc,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC;QACpC,cAAc,EAAE,IAAI;QACpB,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC9B,MAAM,EAAE,GAAG,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;YAC7C,qBAAqB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;YAClC,OAAO,EAAE,CAAA;QACX,CAAC;QACD,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;YAClC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;YAClD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;YAE9C,IAAI,OAAO,GAAG,KAAK,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,4CAA4C,CAAC,CAAA;YACzF,CAAC;YAED,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YACvC,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YAErC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA;QAC3E,CAAC;QACD,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;KAClD,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,EAAU,EAAE,OAAe;IACxD,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,iCAAiC,EAAE,QAAQ,OAAO,KAAK,GAAG,2BAA2B,CACtF,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/esm/src/utils/parse-integer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Parses a string to an integer with validation.
+ * Rejects decimal numbers explicitly.
+ *
+ * @param str - String to parse
+ * @param context - Context string for error messages
+ * @param label - Label for the value type (e.g., "ID", "baud rate")
+ * @returns Parsed integer
+ *
+ * @example
+ * parseInteger("123", "1-5", "ID") // 123
+ * parseInteger("12.5", "1-5", "ID") // throws Error
+ */
+export declare function parseInteger(str: string, context: string, label: string): number;
+//# sourceMappingURL=parse-integer.d.ts.map

package/dist/esm/src/utils/parse-integer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-integer.d.ts","sourceRoot":"","sources":["../../../../src/utils/parse-integer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAahF"}

package/dist/esm/src/utils/parse-integer.js

@@ -0,0 +1,24 @@
+/**
+ * Parses a string to an integer with validation.
+ * Rejects decimal numbers explicitly.
+ *
+ * @param str - String to parse
+ * @param context - Context string for error messages
+ * @param label - Label for the value type (e.g., "ID", "baud rate")
+ * @returns Parsed integer
+ *
+ * @example
+ * parseInteger("123", "1-5", "ID") // 123
+ * parseInteger("12.5", "1-5", "ID") // throws Error
+ */
+export function parseInteger(str, context, label) {
+    if (str.includes('.')) {
+        throw new Error(`Invalid ${label} format: "${context}". Decimal numbers not allowed, expected whole numbers only`);
+    }
+    const num = parseInt(str, 10);
+    if (isNaN(num)) {
+        throw new Error(`Invalid ${label} format: "${context}". Expected a number`);
+    }
+    return num;
+}
+//# sourceMappingURL=parse-integer.js.map

package/dist/esm/src/utils/parse-integer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-integer.js","sourceRoot":"","sources":["../../../../src/utils/parse-integer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,OAAe,EAAE,KAAa;IACtE,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,WAAW,KAAK,aAAa,OAAO,6DAA6D,CAClG,CAAA;IACH,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IAC7B,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,aAAa,OAAO,sBAAsB,CAAC,CAAA;IAC7E,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/esm/src/utils/parse-parity.d.ts

@@ -0,0 +1,18 @@
+import type { Parity } from '@ya-modbus/driver-types';
+/**
+ * Parses a comma-separated list of parity values into a sorted array of unique parities.
+ *
+ * @param spec - Parity specification string (e.g., "none,even,odd")
+ * @returns Sorted array of unique parity values in standard order (none, even, odd)
+ *
+ * @example
+ * parseParity("none,even") // ["none", "even"]
+ * parseParity("odd,none") // ["none", "odd"]
+ * parseParity("even,even") // ["even"]
+ */
+export declare function parseParity(spec: string): Parity[];
+/**
+ * Sorts parities in standard order (none, even, odd)
+ */
+export declare function sortParitiesInStandardOrder(parities: Parity[]): Parity[];
+//# sourceMappingURL=parse-parity.d.ts.map

package/dist/esm/src/utils/parse-parity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-parity.d.ts","sourceRoot":"","sources":["../../../../src/utils/parse-parity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAMrD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBlD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAExE"}

package/dist/esm/src/utils/parse-parity.js

@@ -0,0 +1,42 @@
+import { STANDARD_PARITY } from '../discovery/constants.js';
+import { parseSpec } from './parse-spec.js';
+/**
+ * Parses a comma-separated list of parity values into a sorted array of unique parities.
+ *
+ * @param spec - Parity specification string (e.g., "none,even,odd")
+ * @returns Sorted array of unique parity values in standard order (none, even, odd)
+ *
+ * @example
+ * parseParity("none,even") // ["none", "even"]
+ * parseParity("odd,none") // ["none", "odd"]
+ * parseParity("even,even") // ["even"]
+ */
+export function parseParity(spec) {
+    return parseSpec({
+        spec,
+        label: 'parity',
+        formatExamples: ['"none,even,odd"'],
+        skipEmptyParts: false, // Throw error on empty parts for explicit validation
+        parseSingle: (value, context) => {
+            const normalized = value.toLowerCase();
+            if (!isValidParity(normalized)) {
+                throw new Error(`Invalid parity value: "${value}" in "${context}". Valid values are: ${STANDARD_PARITY.join(', ')}`);
+            }
+            return normalized;
+        },
+        sortItems: (items) => sortParitiesInStandardOrder(items),
+    });
+}
+/**
+ * Sorts parities in standard order (none, even, odd)
+ */
+export function sortParitiesInStandardOrder(parities) {
+    return STANDARD_PARITY.filter((p) => parities.includes(p));
+}
+/**
+ * Type guard to check if a string is a valid parity value.
+ */
+function isValidParity(value) {
+    return STANDARD_PARITY.includes(value);
+}
+//# sourceMappingURL=parse-parity.js.map

package/dist/esm/src/utils/parse-parity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-parity.js","sourceRoot":"","sources":["../../../../src/utils/parse-parity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,SAAS,CAAC;QACf,IAAI;QACJ,KAAK,EAAE,QAAQ;QACf,cAAc,EAAE,CAAC,iBAAiB,CAAC;QACnC,cAAc,EAAE,KAAK,EAAE,qDAAqD;QAC5E,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAA;YAEtC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACb,0BAA0B,KAAK,SAAS,OAAO,wBAAwB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpG,CAAA;YACH,CAAC;YAED,OAAO,UAAU,CAAA;QACnB,CAAC;QACD,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,2BAA2B,CAAC,KAAK,CAAC;KACzD,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,QAAkB;IAC5D,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5D,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,eAAe,CAAC,QAAQ,CAAC,KAAe,CAAC,CAAA;AAClD,CAAC"}

package/dist/esm/src/utils/parse-spec.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Generic utility for parsing comma-separated specification strings
+ * with optional range support.
+ *
+ * Handles:
+ * - Empty string validation
+ * - Comma-separated list parsing
+ * - Optional range expansion (e.g., "1-5")
+ * - Deduplication via Set
+ * - Custom sorting/ordering
+ *
+ * @example
+ * const parseIds = (spec: string) => parseSpec({
+ *   spec,
+ *   label: 'ID',
+ *   formatExamples: ['"1,2,3"', '"1-5"'],
+ *   parseSingle: (value, context) => {
+ *     const id = parseInteger(value, context, 'ID')
+ *     if (id < 1 || id > 247) throw new Error(...)
+ *     return id
+ *   },
+ *   parseRange: (start, end, context) => {
+ *     const startId = parseInteger(start, context, 'ID')
+ *     const endId = parseInteger(end, context, 'ID')
+ *     return Array.from({length: endId - startId + 1}, (_, i) => startId + i)
+ *   },
+ *   sortItems: (items) => items.sort((a, b) => a - b)
+ * })
+ */
+export interface ParseSpecOptions<T> {
+    /** The specification string to parse (e.g., "1,2,3" or "none,even") */
+    spec: string;
+    /** Label for the value type (e.g., "ID", "parity", "baud rate") */
+    label: string;
+    /** Example formats to show in error messages (e.g., ['"1,2,3"', '"1-5"']) */
+    formatExamples: string[];
+    /**
+     * Parse a single value from the spec
+     * @param value - The trimmed value to parse
+     * @param context - The original part for error context
+     * @returns The parsed value
+     */
+    parseSingle: (value: string, context: string) => T;
+    /**
+     * Optional: Parse a range (e.g., "1-5")
+     * @param start - The start value string
+     * @param end - The end value string
+     * @param context - The original range string for error context
+     * @returns Array of values in the range
+     */
+    parseRange?: (start: string, end: string, context: string) => T[];
+    /**
+     * Sort/order the final array of values
+     * @param items - Deduplicated array of items
+     * @returns Sorted array
+     */
+    sortItems: (items: T[]) => T[];
+    /**
+     * Optional: Skip empty parts in comma-separated list instead of throwing error
+     * Default: false (throw error on empty parts)
+     */
+    skipEmptyParts?: boolean;
+}
+/**
+ * Generic parser for comma-separated specification strings
+ *
+ * @param options - Parsing options
+ * @returns Sorted array of unique values
+ *
+ * @throws Error if spec is empty or contains invalid values
+ */
+export declare function parseSpec<T>(options: ParseSpecOptions<T>): T[];
+//# sourceMappingURL=parse-spec.d.ts.map

package/dist/esm/src/utils/parse-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-spec.d.ts","sourceRoot":"","sources":["../../../../src/utils/parse-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAA;IAEZ,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;IAEb,6EAA6E;IAC7E,cAAc,EAAE,MAAM,EAAE,CAAA;IAExB;;;;;OAKG;IACH,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC,CAAA;IAElD;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC,EAAE,CAAA;IAEjE;;;;OAIG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,CAAA;IAE9B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAoD9D"}

package/dist/esm/src/utils/parse-spec.js

@@ -0,0 +1,44 @@
+/**
+ * Generic parser for comma-separated specification strings
+ *
+ * @param options - Parsing options
+ * @returns Sorted array of unique values
+ *
+ * @throws Error if spec is empty or contains invalid values
+ */
+export function parseSpec(options) {
+    const { spec, label, formatExamples, parseSingle, parseRange, sortItems, skipEmptyParts = false, } = options;
+    const trimmed = spec.trim();
+    if (!trimmed) {
+        throw new Error(`Invalid ${label} specification: empty string. Expected format: ${formatExamples.join(' or ')}`);
+    }
+    const items = new Set();
+    const parts = trimmed.split(',');
+    for (const part of parts) {
+        const normalized = part.trim();
+        if (!normalized) {
+            if (skipEmptyParts) {
+                continue;
+            }
+            else {
+                throw new Error(`Invalid ${label} specification: empty value in "${spec}". Expected format: ${formatExamples.join(' or ')}`);
+            }
+        }
+        // Check if it's a range (contains hyphen)
+        if (normalized.includes('-') && parseRange) {
+            const rangeParts = normalized.split('-').map((s) => s.trim());
+            if (rangeParts.length !== 2 || !rangeParts[0] || !rangeParts[1]) {
+                throw new Error(`Invalid range format: "${part}". Expected format: "start-end"`);
+            }
+            const rangeValues = parseRange(rangeParts[0], rangeParts[1], part);
+            rangeValues.forEach((value) => items.add(value));
+        }
+        else {
+            // Single value
+            const value = parseSingle(normalized, part);
+            items.add(value);
+        }
+    }
+    return sortItems(Array.from(items));
+}
+//# sourceMappingURL=parse-spec.js.map

package/dist/esm/src/utils/parse-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-spec.js","sourceRoot":"","sources":["../../../../src/utils/parse-spec.ts"],"names":[],"mappings":"AAsEA;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAI,OAA4B;IACvD,MAAM,EACJ,IAAI,EACJ,KAAK,EACL,cAAc,EACd,WAAW,EACX,UAAU,EACV,SAAS,EACT,cAAc,GAAG,KAAK,GACvB,GAAG,OAAO,CAAA;IAEX,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,WAAW,KAAK,kDAAkD,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAChG,CAAA;IACH,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,GAAG,EAAK,CAAA;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAE9B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,IAAI,cAAc,EAAE,CAAC;gBACnB,SAAQ;YACV,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CACb,WAAW,KAAK,mCAAmC,IAAI,uBAAuB,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAC5G,CAAA;YACH,CAAC;QACH,CAAC;QAED,0CAA0C;QAC1C,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;YAE7D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,iCAAiC,CAAC,CAAA;YAClF,CAAC;YAED,MAAM,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;YAClE,WAAW,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;QAClD,CAAC;aAAM,CAAC;YACN,eAAe;YACf,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;YAC3C,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAClB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;AACrC,CAAC"}