@ya-modbus/cli 0.7.1 → 0.9.0

package/dist/cjs/src/utils/merge-specs.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeSpecs = mergeSpecs;
+/**
+ * Merges multiple specification strings (from repeated CLI flags) into a
+ * single deduplicated, sorted array.
+ *
+ * Handles:
+ * - Single string or array of strings
+ * - Deduplication across all specifications
+ * - Custom sorting
+ *
+ * @param specs - Single spec string, array of spec strings, or undefined
+ * @param parser - Function that parses a single spec string
+ * @param sorter - Optional function to sort the final array
+ * @returns Merged and sorted array, or undefined if specs is undefined
+ *
+ * @example
+ * // Merge multiple --id specifications
+ * const ids = mergeSpecs(
+ *   ['1,2', '3-5'],
+ *   parseIdRange,
+ *   (items) => items.sort((a, b) => a - b)
+ * )
+ * // Result: [1, 2, 3, 4, 5]
+ *
+ * @example
+ * // Merge multiple --parity specifications
+ * const parities = mergeSpecs(
+ *   ['none', 'even,odd'],
+ *   parseParity,
+ *   sortParitiesInStandardOrder
+ * )
+ * // Result: ['none', 'even', 'odd']
+ */
+function mergeSpecs(specs, parser, sorter) {
+    if (specs === undefined) {
+        return undefined;
+    }
+    // Normalize to array
+    const specArray = Array.isArray(specs) ? specs : [specs];
+    // Parse and merge into Set for deduplication
+    const allValues = new Set();
+    for (const spec of specArray) {
+        const values = parser(spec);
+        values.forEach((value) => allValues.add(value));
+    }
+    // Convert to array
+    const result = Array.from(allValues);
+    // Apply custom sorter if provided, otherwise return unsorted
+    return sorter ? sorter(result) : result;
+}
+//# sourceMappingURL=merge-specs.js.map

package/dist/cjs/src/utils/merge-specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-specs.js","sourceRoot":"","sources":["../../../../src/utils/merge-specs.ts"],"names":[],"mappings":";;AAgCA,gCAwBC;AAxDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,SAAgB,UAAU,CACxB,KAAoC,EACpC,MAA6B,EAC7B,MAA4B;IAE5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,qBAAqB;IACrB,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IAExD,6CAA6C;IAC7C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAK,CAAA;IAC9B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;QAC3B,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;IACjD,CAAC;IAED,mBAAmB;IACnB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAEpC,6DAA6D;IAC7D,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;AACzC,CAAC"}

package/dist/cjs/src/utils/parse-baud-rate.d.ts

@@ -0,0 +1,14 @@
+import type { BaudRate } from '@ya-modbus/driver-types';
+/**
+ * Parses a comma-separated list of baud rates and ranges into a sorted array of unique baud rates.
+ *
+ * @param spec - Baud rate specification string (e.g., "9600,19200" or "9600-38400")
+ * @returns Sorted array of unique baud rates from STANDARD_BAUD_RATES
+ *
+ * @example
+ * parseBaudRate("9600,19200") // [9600, 19200]
+ * parseBaudRate("9600-19200") // [9600, 14400, 19200]
+ * parseBaudRate("19200,9600") // [9600, 19200]
+ */
+export declare function parseBaudRate(spec: string): BaudRate[];
+//# sourceMappingURL=parse-baud-rate.d.ts.map

package/dist/cjs/src/utils/parse-baud-rate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-baud-rate.d.ts","sourceRoot":"","sources":["../../../../src/utils/parse-baud-rate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAOvD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CA2BtD"}

package/dist/cjs/src/utils/parse-baud-rate.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBaudRate = parseBaudRate;
+const constants_js_1 = require("../discovery/constants.js");
+const parse_integer_js_1 = require("./parse-integer.js");
+const parse_spec_js_1 = require("./parse-spec.js");
+/**
+ * Parses a comma-separated list of baud rates and ranges into a sorted array of unique baud rates.
+ *
+ * @param spec - Baud rate specification string (e.g., "9600,19200" or "9600-38400")
+ * @returns Sorted array of unique baud rates from STANDARD_BAUD_RATES
+ *
+ * @example
+ * parseBaudRate("9600,19200") // [9600, 19200]
+ * parseBaudRate("9600-19200") // [9600, 14400, 19200]
+ * parseBaudRate("19200,9600") // [9600, 19200]
+ */
+function parseBaudRate(spec) {
+    return (0, parse_spec_js_1.parseSpec)({
+        spec,
+        label: 'baud rate',
+        formatExamples: ['"9600,19200"', '"9600-19200"'],
+        skipEmptyParts: true,
+        parseSingle: (value, context) => {
+            const rate = (0, parse_integer_js_1.parseInteger)(value, context, 'baud rate');
+            validateBaudRate(rate, context);
+            return rate;
+        },
+        parseRange: (start, end, context) => {
+            const startRate = (0, parse_integer_js_1.parseInteger)(start, context, 'baud rate');
+            const endRate = (0, parse_integer_js_1.parseInteger)(end, context, 'baud rate');
+            if (startRate > endRate) {
+                throw new Error(`Invalid range: "${context}". Start must be less than or equal to end`);
+            }
+            validateBaudRate(startRate, context);
+            validateBaudRate(endRate, context);
+            // Extract baud rates between start and end from STANDARD_BAUD_RATES
+            return constants_js_1.STANDARD_BAUD_RATES.filter((rate) => rate >= startRate && rate <= endRate);
+        },
+        sortItems: (items) => items.sort((a, b) => a - b),
+    });
+}
+/**
+ * Validates that a number is a supported baud rate.
+ */
+function validateBaudRate(rate, context) {
+    if (!constants_js_1.STANDARD_BAUD_RATES.includes(rate)) {
+        throw new Error(`Unsupported baud rate: ${rate} in "${context}". ` +
+            `Supported rates are: ${constants_js_1.STANDARD_BAUD_RATES.join(', ')}`);
+    }
+}
+//# sourceMappingURL=parse-baud-rate.js.map

package/dist/cjs/src/utils/parse-baud-rate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-baud-rate.js","sourceRoot":"","sources":["../../../../src/utils/parse-baud-rate.ts"],"names":[],"mappings":";;AAkBA,sCA2BC;AA3CD,4DAA+D;AAE/D,yDAAiD;AACjD,mDAA2C;AAE3C;;;;;;;;;;GAUG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,IAAA,yBAAS,EAAC;QACf,IAAI;QACJ,KAAK,EAAE,WAAW;QAClB,cAAc,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC;QAChD,cAAc,EAAE,IAAI;QACpB,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,IAAA,+BAAY,EAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;YACtD,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAC/B,OAAO,IAAI,CAAA;QACb,CAAC;QACD,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;YAClC,MAAM,SAAS,GAAG,IAAA,+BAAY,EAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;YAC3D,MAAM,OAAO,GAAG,IAAA,+BAAY,EAAC,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;YAEvD,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,4CAA4C,CAAC,CAAA;YACzF,CAAC;YAED,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YACpC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAElC,oEAAoE;YACpE,OAAO,kCAAmB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,SAAS,IAAI,IAAI,IAAI,OAAO,CAAC,CAAA;QACnF,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,gBAAgB,CAAC,IAAY,EAAE,OAAe;IACrD,IAAI,CAAC,kCAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,QAAQ,OAAO,KAAK;YAChD,wBAAwB,kCAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3D,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/cjs/src/utils/parse-id-range.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Parses a comma-separated list of IDs and ranges into a sorted array of unique IDs.
+ *
+ * @param spec - ID specification string (e.g., "1,2,3-5")
+ * @returns Sorted array of unique Modbus slave IDs (1-247)
+ *
+ * @example
+ * parseIdRange("1,2,3-5") // [1, 2, 3, 4, 5]
+ * parseIdRange("5,1,3") // [1, 3, 5]
+ * parseIdRange("1-3,2-4") // [1, 2, 3, 4]
+ */
+export declare function parseIdRange(spec: string): number[];
+//# sourceMappingURL=parse-id-range.d.ts.map

package/dist/cjs/src/utils/parse-id-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-id-range.d.ts","sourceRoot":"","sources":["../../../../src/utils/parse-id-range.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BnD"}

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

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseIdRange = parseIdRange;
+const parse_integer_js_1 = require("./parse-integer.js");
+const parse_spec_js_1 = require("./parse-spec.js");
+/**
+ * Parses a comma-separated list of IDs and ranges into a sorted array of unique IDs.
+ *
+ * @param spec - ID specification string (e.g., "1,2,3-5")
+ * @returns Sorted array of unique Modbus slave IDs (1-247)
+ *
+ * @example
+ * parseIdRange("1,2,3-5") // [1, 2, 3, 4, 5]
+ * parseIdRange("5,1,3") // [1, 3, 5]
+ * parseIdRange("1-3,2-4") // [1, 2, 3, 4]
+ */
+function parseIdRange(spec) {
+    return (0, parse_spec_js_1.parseSpec)({
+        spec,
+        label: 'ID',
+        formatExamples: ['"1,2,3"', '"1-5"'],
+        skipEmptyParts: true,
+        parseSingle: (value, context) => {
+            const id = (0, parse_integer_js_1.parseInteger)(value, context, 'ID');
+            validateModbusAddress(id, context);
+            return id;
+        },
+        parseRange: (start, end, context) => {
+            const startId = (0, parse_integer_js_1.parseInteger)(start, context, 'ID');
+            const endId = (0, parse_integer_js_1.parseInteger)(end, context, 'ID');
+            if (startId > endId) {
+                throw new Error(`Invalid range: "${context}". Start must be less than or equal to end`);
+            }
+            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).
+ */
+function validateModbusAddress(id, context) {
+    if (id < 1 || id > 247) {
+        throw new Error(`Invalid Modbus slave address: ${id} in "${context}". ` + `Valid addresses are 1-247`);
+    }
+}
+//# sourceMappingURL=parse-id-range.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse-id-range.js","sourceRoot":"","sources":["../../../../src/utils/parse-id-range.ts"],"names":[],"mappings":";;AAcA,oCA0BC;AAxCD,yDAAiD;AACjD,mDAA2C;AAE3C;;;;;;;;;;GAUG;AACH,SAAgB,YAAY,CAAC,IAAY;IACvC,OAAO,IAAA,yBAAS,EAAC;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,IAAA,+BAAY,EAAC,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,IAAA,+BAAY,EAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;YAClD,MAAM,KAAK,GAAG,IAAA,+BAAY,EAAC,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/cjs/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/cjs/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/cjs/src/utils/parse-integer.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseInteger = parseInteger;
+/**
+ * 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
+ */
+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/cjs/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,oCAaC;AA1BD;;;;;;;;;;;;GAYG;AACH,SAAgB,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/cjs/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/cjs/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/cjs/src/utils/parse-parity.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseParity = parseParity;
+exports.sortParitiesInStandardOrder = sortParitiesInStandardOrder;
+const constants_js_1 = require("../discovery/constants.js");
+const parse_spec_js_1 = require("./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"]
+ */
+function parseParity(spec) {
+    return (0, parse_spec_js_1.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: ${constants_js_1.STANDARD_PARITY.join(', ')}`);
+            }
+            return normalized;
+        },
+        sortItems: (items) => sortParitiesInStandardOrder(items),
+    });
+}
+/**
+ * Sorts parities in standard order (none, even, odd)
+ */
+function sortParitiesInStandardOrder(parities) {
+    return constants_js_1.STANDARD_PARITY.filter((p) => parities.includes(p));
+}
+/**
+ * Type guard to check if a string is a valid parity value.
+ */
+function isValidParity(value) {
+    return constants_js_1.STANDARD_PARITY.includes(value);
+}
+//# sourceMappingURL=parse-parity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse-parity.js","sourceRoot":"","sources":["../../../../src/utils/parse-parity.ts"],"names":[],"mappings":";;AAiBA,kCAmBC;AAKD,kEAEC;AAzCD,4DAA2D;AAE3D,mDAA2C;AAE3C;;;;;;;;;;GAUG;AACH,SAAgB,WAAW,CAAC,IAAY;IACtC,OAAO,IAAA,yBAAS,EAAC;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,8BAAe,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,SAAgB,2BAA2B,CAAC,QAAkB;IAC5D,OAAO,8BAAe,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,8BAAe,CAAC,QAAQ,CAAC,KAAe,CAAC,CAAA;AAClD,CAAC"}

package/dist/cjs/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/cjs/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/cjs/src/utils/parse-spec.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSpec = parseSpec;
+/**
+ * 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
+ */
+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/cjs/src/utils/parse-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-spec.js","sourceRoot":"","sources":["../../../../src/utils/parse-spec.ts"],"names":[],"mappings":";;AA8EA,8BAoDC;AA5DD;;;;;;;GAOG;AACH,SAAgB,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"}