@kikiutils/shared 18.0.1 → 18.1.0

package/dist/classes/precision-number.js

@@ -1,22 +1,25 @@
 import { Decimal } from "decimal.js";
 //#region src/classes/precision-number.ts
 /**
-* Chainable fixed-decimal wrapper around `decimal.js`.
+* A fixed-decimal number with mutable and immutable arithmetic operations.
 *
+* @remarks
 * `PrecisionNumber` stores values as `Decimal`, rounds every mutating operation to
 * the configured decimal places, and exposes both mutable and immutable arithmetic
 * methods. Mutable methods (`plus`, `minus`, `times`, `dividedBy`, `modulo`,
 * `pow`, `clamp`, `ceil`, `floor`, `negate`, `absoluteValue`) update the current
 * instance and return `this`; immutable methods prefixed with `to` return a new
-* `PrecisionNumber` with the same precision settings.
+* `PrecisionNumber` with the same precision settings, leaving this instance unchanged.
+* Decimal.js exceptions propagate unchanged; non-finite arithmetic results are not converted into exceptions.
 *
 * @example
-* ```typescript
+*
+* ```ts
 * import { PrecisionNumber } from '@kikiutils/shared/classes/precision-number';
 *
 * const value = new PrecisionNumber('1.239', 2).plus('2.111');
-* value.toString(); // '3.35'
-* value.toMinus('1').toString(); // '2.35' (original value remains '3.35')
+* value.toString(); // => '3.35'
+* value.toMinus('1').toString(); // => '2.35' (original value remains '3.35')
 * ```
 */
 var PrecisionNumber = class PrecisionNumber {
@@ -26,30 +29,15 @@ var PrecisionNumber = class PrecisionNumber {
 	/**
 	* Creates a fixed-decimal number.
 	*
-	* @param {PrecisionNumberValue} [value] - Initial value (default: `'0'`)
-	* @param {number} [decimalPlaces] - Decimal places retained after operations (default: `2`)
-	* @param {Decimal.Rounding} [rounding] - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`)
+	* @param value - Initial value (default: `'0'`).
+	* @param decimalPlaces - Decimal places retained after operations (default: `2`).
+	* @param rounding - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`).
 	*/
 	constructor(value = "0", decimalPlaces = 2, rounding = Decimal.ROUND_DOWN) {
 		this.#decimalPlaces = decimalPlaces;
 		this.#rounding = rounding;
 		this.#decimal = this.#decimalToFixedDecimal(new Decimal(value.toString().trim()));
 	}
-	/**
-	* Returns the formatted value when inspected by Node.js utilities.
-	*/
-	[Symbol.for("nodejs.util.inspect.custom")]() {
-		return this.value;
-	}
-	/**
-	* Converts to a number for numeric coercion and to the fixed string otherwise.
-	*
-	* @param {string} hint - JavaScript primitive-conversion hint
-	*/
-	[Symbol.toPrimitive](hint) {
-		if (hint === "number") return this.#decimal.toNumber();
-		return this.value;
-	}
 	#decimalToFixedDecimal(decimal) {
 		return decimal.toDecimalPlaces(this.#decimalPlaces, this.#rounding);
 	}
@@ -77,19 +65,34 @@ var PrecisionNumber = class PrecisionNumber {
 	/**
 	* Formats a value with decimal.js without creating a reusable instance.
 	*
-	* @param {PrecisionNumberValue} value - Value to format
-	* @param {number} [decimalPlaces] - Decimal places to output (default: `2`)
-	* @param {Decimal.Rounding} [rounding] - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`)
+	* @param value - Value to format.
+	* @param decimalPlaces - Decimal places to output (default: `2`).
+	* @param rounding - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`).
 	*
-	* @returns {string} Fixed-decimal string
+	* @returns Fixed-decimal string.
 	*/
 	static toFixed(value, decimalPlaces = 2, rounding = Decimal.ROUND_DOWN) {
 		return new Decimal(value.toString().trim()).toFixed(decimalPlaces, rounding);
 	}
 	/**
+	* Returns the formatted value when inspected by Node.js utilities.
+	*/
+	[Symbol.for("nodejs.util.inspect.custom")]() {
+		return this.value;
+	}
+	/**
+	* Converts to a number for numeric coercion and to the fixed string otherwise.
+	*
+	* @param hint - JavaScript primitive-conversion hint.
+	*/
+	[Symbol.toPrimitive](hint) {
+		if (hint === "number") return this.#decimal.toNumber();
+		return this.value;
+	}
+	/**
 	* Replaces the current value with its absolute value.
 	*
-	* @returns {this} The current instance for chaining
+	* @returns This instance for chaining.
 	*/
 	absoluteValue() {
 		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.absoluteValue());
@@ -98,9 +101,10 @@ var PrecisionNumber = class PrecisionNumber {
 	/**
 	* Rounds the current value up to the nearest integer in place.
 	*
+	* @remarks
 	* The stored value still uses this instance's configured decimal places for output.
 	*
-	* @returns {this} The current instance for chaining
+	* @returns This instance for chaining.
 	*/
 	ceil() {
 		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.ceil());
@@ -109,12 +113,12 @@ var PrecisionNumber = class PrecisionNumber {
 	/**
 	* Restricts the current value to the inclusive range `[min, max]` in place.
 	*
-	* @param {PrecisionNumberValue} min - Lower bound
-	* @param {PrecisionNumberValue} max - Upper bound
+	* @param min - Lower bound.
+	* @param max - Upper bound.
 	*
-	* @returns {this} The current instance for chaining
+	* @returns This instance for chaining.
 	*
-	* @throws {Error} If `min` is greater than `max`
+	* @throws Error if `min` is greater than `max`.
 	*/
 	clamp(min, max) {
 		const minDecimal = new Decimal(this.#valueToString(min));
@@ -132,9 +136,9 @@ var PrecisionNumber = class PrecisionNumber {
 	/**
 	* Divides the current value by another value in place.
 	*
-	* @param {PrecisionNumberValue} value - Divisor
+	* @param value - Divisor.
 	*
-	* @returns {this} The current instance for chaining
+	* @returns This instance for chaining.
 	*/
 	dividedBy(value) {
 		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.dividedBy(this.#valueToString(value)));
@@ -143,9 +147,9 @@ var PrecisionNumber = class PrecisionNumber {
 	/**
 	* Checks whether the current value equals another value.
 	*
-	* @param {PrecisionNumberValue} value - Value to compare
+	* @param value - Value to compare.
 	*
-	* @returns {boolean} `true` when both numeric values are equal
+	* @returns Whether both numeric values are equal.
 	*/
 	equals(value) {
 		return this.#decimal.equals(this.#valueToString(value));
@@ -153,9 +157,10 @@ var PrecisionNumber = class PrecisionNumber {
 	/**
 	* Rounds the current value down to the nearest integer in place.
 	*
+	* @remarks
 	* The stored value still uses this instance's configured decimal places for output.
 	*
-	* @returns {this} The current instance for chaining
+	* @returns This instance for chaining.
 	*/
 	floor() {
 		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.floor());
@@ -231,9 +236,9 @@ var PrecisionNumber = class PrecisionNumber {
 	/**
 	* Replaces the current value with the remainder after division by another value.
 	*
-	* @param {PrecisionNumberValue} value - Divisor used to compute the remainder
+	* @param value - Divisor used to compute the remainder.
 	*
-	* @returns {this} The current instance for chaining
+	* @returns This instance for chaining.
 	*/
 	modulo(value) {
 		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.modulo(this.#valueToString(value)));
@@ -256,9 +261,9 @@ var PrecisionNumber = class PrecisionNumber {
 	/**
 	* Raises the current value to an exponent in place.
 	*
-	* @param {PrecisionNumberValue} value - Exponent
+	* @param value - Exponent.
 	*
-	* @returns {this} The current instance for chaining
+	* @returns This instance for chaining.
 	*/
 	pow(value) {
 		this.#decimal = this.#decimalToFixedDecimal(this.#decimal.pow(this.#valueToString(value)));
@@ -286,10 +291,10 @@ var PrecisionNumber = class PrecisionNumber {
 	/**
 	* Returns a new instance restricted to the inclusive range `[min, max]`.
 	*
-	* @param {PrecisionNumberValue} min - Lower bound
-	* @param {PrecisionNumberValue} max - Upper bound
+	* @param min - Lower bound.
+	* @param max - Upper bound.
 	*
-	* @throws {Error} If `min` is greater than `max`
+	* @throws Error if `min` is greater than `max`.
 	*/
 	toClamped(min, max) {
 		return this.clone().clamp(min, max);
@@ -345,6 +350,7 @@ var PrecisionNumber = class PrecisionNumber {
 	/**
 	* Converts the current value to a JavaScript number.
 	*
+	* @remarks
 	* Use `toString`/`value` when preserving decimal precision is more important than native-number ergonomics.
 	*/
 	toNumber() {

package/dist/classes/precision-number.js.map

@@ -1 +1 @@
-{"version":3,"file":"precision-number.js","names":["#decimalPlaces","#rounding","#decimal","#decimalToFixedDecimal","#valueToString"],"sources":["../../src/classes/precision-number.ts"],"sourcesContent":["import { Decimal } from 'decimal.js';\n\n/**\n * Values accepted by `PrecisionNumber` constructors and arithmetic methods.\n */\nexport type PrecisionNumberValue = Decimal.Value | PrecisionNumber | { toString: () => string };\n\n/**\n * Chainable fixed-decimal wrapper around `decimal.js`.\n *\n * `PrecisionNumber` stores values as `Decimal`, rounds every mutating operation to\n * the configured decimal places, and exposes both mutable and immutable arithmetic\n * methods. Mutable methods (`plus`, `minus`, `times`, `dividedBy`, `modulo`,\n * `pow`, `clamp`, `ceil`, `floor`, `negate`, `absoluteValue`) update the current\n * instance and return `this`; immutable methods prefixed with `to` return a new\n * `PrecisionNumber` with the same precision settings.\n *\n * @example\n * ```typescript\n * import { PrecisionNumber } from '@kikiutils/shared/classes/precision-number';\n *\n * const value = new PrecisionNumber('1.239', 2).plus('2.111');\n * value.toString(); // '3.35'\n * value.toMinus('1').toString(); // '2.35' (original value remains '3.35')\n * ```\n */\nexport class PrecisionNumber {\n    // Private properties\n    readonly #decimalPlaces: number;\n    readonly #rounding: Decimal.Rounding;\n    #decimal: Decimal;\n\n    /**\n     * Creates a fixed-decimal number.\n     *\n     * @param {PrecisionNumberValue} [value] - Initial value (default: `'0'`)\n     * @param {number} [decimalPlaces] - Decimal places retained after operations (default: `2`)\n     * @param {Decimal.Rounding} [rounding] - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`)\n     */\n    constructor(\n        value: PrecisionNumberValue = '0',\n        decimalPlaces: number = 2,\n        rounding: Decimal.Rounding = Decimal.ROUND_DOWN,\n    ) {\n        this.#decimalPlaces = decimalPlaces;\n        this.#rounding = rounding;\n        this.#decimal = this.#decimalToFixedDecimal(new Decimal(value.toString().trim()));\n    }\n\n    // Symbols\n\n    /**\n     * Returns the formatted value when inspected by Node.js utilities.\n     */\n    [Symbol.for('nodejs.util.inspect.custom')]() {\n        return this.value;\n    }\n\n    /**\n     * Converts to a number for numeric coercion and to the fixed string otherwise.\n     *\n     * @param {string} hint - JavaScript primitive-conversion hint\n     */\n    [Symbol.toPrimitive](hint: string) {\n        if (hint === 'number') return this.#decimal.toNumber();\n        return this.value;\n    }\n\n    // Private methods\n    #decimalToFixedDecimal(decimal: Decimal) {\n        return decimal.toDecimalPlaces(this.#decimalPlaces, this.#rounding);\n    }\n\n    #valueToString(value: PrecisionNumberValue) {\n        return value.toString().trim();\n    }\n\n    // Public getters\n\n    /**\n     * Decimal places retained by mutating operations and default formatting.\n     */\n    get decimalPlaces() {\n        return this.#decimalPlaces;\n    }\n\n    /**\n     * Decimal.js rounding mode used by mutating operations and default formatting.\n     */\n    get rounding() {\n        return this.#rounding;\n    }\n\n    /**\n     * Fixed-decimal string using the instance precision and rounding mode.\n     */\n    get value() {\n        return this.#decimal.toFixed(this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Formats a value with decimal.js without creating a reusable instance.\n     *\n     * @param {PrecisionNumberValue} value - Value to format\n     * @param {number} [decimalPlaces] - Decimal places to output (default: `2`)\n     * @param {Decimal.Rounding} [rounding] - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`)\n     *\n     * @returns {string} Fixed-decimal string\n     */\n    static toFixed(\n        value: PrecisionNumberValue,\n        decimalPlaces: number = 2,\n        rounding: Decimal.Rounding = Decimal.ROUND_DOWN,\n    ) {\n        return new Decimal(value.toString().trim()).toFixed(decimalPlaces, rounding);\n    }\n\n    // Public methods\n\n    /**\n     * Replaces the current value with its absolute value.\n     *\n     * @returns {this} The current instance for chaining\n     */\n    absoluteValue() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.absoluteValue());\n        return this;\n    }\n\n    /**\n     * Rounds the current value up to the nearest integer in place.\n     *\n     * The stored value still uses this instance's configured decimal places for output.\n     *\n     * @returns {this} The current instance for chaining\n     */\n    ceil() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.ceil());\n        return this;\n    }\n\n    /**\n     * Restricts the current value to the inclusive range `[min, max]` in place.\n     *\n     * @param {PrecisionNumberValue} min - Lower bound\n     * @param {PrecisionNumberValue} max - Upper bound\n     *\n     * @returns {this} The current instance for chaining\n     *\n     * @throws {Error} If `min` is greater than `max`\n     */\n    clamp(min: PrecisionNumberValue, max: PrecisionNumberValue) {\n        const minDecimal = new Decimal(this.#valueToString(min));\n        const maxDecimal = new Decimal(this.#valueToString(max));\n        if (minDecimal.gt(maxDecimal)) throw new Error('Invalid clamp range: min cannot be greater than max');\n        this.#decimal = this.#decimalToFixedDecimal(Decimal.min(Decimal.max(this.#decimal, minDecimal), maxDecimal));\n        return this;\n    }\n\n    /**\n     * Returns a new instance with the same value, decimal places, and rounding mode.\n     */\n    clone() {\n        return new PrecisionNumber(this.#decimal, this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Divides the current value by another value in place.\n     *\n     * @param {PrecisionNumberValue} value - Divisor\n     *\n     * @returns {this} The current instance for chaining\n     */\n    dividedBy(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.dividedBy(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Checks whether the current value equals another value.\n     *\n     * @param {PrecisionNumberValue} value - Value to compare\n     *\n     * @returns {boolean} `true` when both numeric values are equal\n     */\n    equals(value: PrecisionNumberValue) {\n        return this.#decimal.equals(this.#valueToString(value));\n    }\n\n    /**\n     * Rounds the current value down to the nearest integer in place.\n     *\n     * The stored value still uses this instance's configured decimal places for output.\n     *\n     * @returns {this} The current instance for chaining\n     */\n    floor() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.floor());\n        return this;\n    }\n\n    /**\n     * Checks whether the current value is greater than another value.\n     */\n    gt(value: PrecisionNumberValue) {\n        return this.#decimal.gt(this.#valueToString(value));\n    }\n\n    /**\n     * Checks whether the current value is greater than or equal to another value.\n     */\n    gte(value: PrecisionNumberValue) {\n        return this.#decimal.gte(this.#valueToString(value));\n    }\n\n    /**\n     * Checks whether the current value is finite.\n     */\n    isFinite() {\n        return this.#decimal.isFinite();\n    }\n\n    /**\n     * Checks whether the current value is an integer.\n     */\n    isInteger() {\n        return this.#decimal.isInteger();\n    }\n\n    /**\n     * Checks whether the current value is `NaN`.\n     */\n    isNaN() {\n        return this.#decimal.isNaN();\n    }\n\n    /**\n     * Checks whether the current value is negative.\n     */\n    isNegative() {\n        return this.#decimal.isNegative();\n    }\n\n    /**\n     * Checks whether the current value is positive.\n     */\n    isPositive() {\n        return this.#decimal.isPositive();\n    }\n\n    /**\n     * Checks whether the current value is zero.\n     */\n    isZero() {\n        return this.#decimal.isZero();\n    }\n\n    /**\n     * Checks whether the current value is less than another value.\n     */\n    lt(value: PrecisionNumberValue) {\n        return this.#decimal.lt(this.#valueToString(value));\n    }\n\n    /**\n     * Checks whether the current value is less than or equal to another value.\n     */\n    lte(value: PrecisionNumberValue) {\n        return this.#decimal.lte(this.#valueToString(value));\n    }\n\n    /**\n     * Subtracts another value from the current value in place.\n     */\n    minus(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.minus(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Replaces the current value with the remainder after division by another value.\n     *\n     * @param {PrecisionNumberValue} value - Divisor used to compute the remainder\n     *\n     * @returns {this} The current instance for chaining\n     */\n    modulo(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.modulo(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Negates the current value in place.\n     */\n    negate() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.negated());\n        return this;\n    }\n\n    /**\n     * Adds another value to the current value in place.\n     */\n    plus(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.plus(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Raises the current value to an exponent in place.\n     *\n     * @param {PrecisionNumberValue} value - Exponent\n     *\n     * @returns {this} The current instance for chaining\n     */\n    pow(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.pow(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Multiplies the current value by another value in place.\n     */\n    times(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.times(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Returns a new instance with the absolute value.\n     */\n    toAbsoluteValue() {\n        return new PrecisionNumber(this.#decimal.absoluteValue(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance rounded up to the nearest integer.\n     */\n    toCeil() {\n        return new PrecisionNumber(this.#decimal.ceil(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance restricted to the inclusive range `[min, max]`.\n     *\n     * @param {PrecisionNumberValue} min - Lower bound\n     * @param {PrecisionNumberValue} max - Upper bound\n     *\n     * @throws {Error} If `min` is greater than `max`\n     */\n    toClamped(min: PrecisionNumberValue, max: PrecisionNumberValue) {\n        return this.clone().clamp(min, max);\n    }\n\n    /**\n     * Returns a new instance divided by another value.\n     */\n    toDividedBy(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.dividedBy(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n\n    /**\n     * Returns a new instance rounded down to the nearest integer.\n     */\n    toFloor() {\n        return new PrecisionNumber(this.#decimal.floor(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Serializes to the fixed-decimal string.\n     */\n    toJSON() {\n        return this.value;\n    }\n\n    /**\n     * Returns a new instance with another value subtracted.\n     */\n    toMinus(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.minus(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n\n    /**\n     * Returns a new instance with the remainder after division by another value.\n     */\n    toModulo(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.modulo(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n\n    /**\n     * Returns a new instance with the value negated.\n     */\n    toNegated() {\n        return new PrecisionNumber(this.#decimal.negated(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance with another value added.\n     */\n    toPlus(value: PrecisionNumberValue) {\n        return new PrecisionNumber(this.#decimal.plus(this.#valueToString(value)), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance raised to an exponent.\n     */\n    toPow(value: PrecisionNumberValue) {\n        return new PrecisionNumber(this.#decimal.pow(this.#valueToString(value)), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Converts the current value to a JavaScript number.\n     *\n     * Use `toString`/`value` when preserving decimal precision is more important than native-number ergonomics.\n     */\n    toNumber() {\n        return this.#decimal.toNumber();\n    }\n\n    /**\n     * Converts the current value to its fixed-decimal string.\n     */\n    toString() {\n        return this.value;\n    }\n\n    /**\n     * Formats the current value with custom precision and rounding for this call only.\n     */\n    toFixed(decimalPlaces: number = this.#decimalPlaces, rounding: Decimal.Rounding = this.#rounding) {\n        return this.#decimal.toFixed(decimalPlaces, rounding);\n    }\n\n    /**\n     * Returns a new instance multiplied by another value.\n     */\n    toTimes(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.times(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"precision-number.js","names":[],"sources":["../../src/classes/precision-number.ts"],"sourcesContent":["import { Decimal } from 'decimal.js';\n\n/**\n * Values accepted by `PrecisionNumber` constructors and arithmetic methods.\n */\nexport type PrecisionNumberValue = Decimal.Value | PrecisionNumber | { toString: () => string };\n\n/**\n * A fixed-decimal number with mutable and immutable arithmetic operations.\n *\n * @remarks\n * `PrecisionNumber` stores values as `Decimal`, rounds every mutating operation to\n * the configured decimal places, and exposes both mutable and immutable arithmetic\n * methods. Mutable methods (`plus`, `minus`, `times`, `dividedBy`, `modulo`,\n * `pow`, `clamp`, `ceil`, `floor`, `negate`, `absoluteValue`) update the current\n * instance and return `this`; immutable methods prefixed with `to` return a new\n * `PrecisionNumber` with the same precision settings, leaving this instance unchanged.\n * Decimal.js exceptions propagate unchanged; non-finite arithmetic results are not converted into exceptions.\n *\n * @example\n *\n * ```ts\n * import { PrecisionNumber } from '@kikiutils/shared/classes/precision-number';\n *\n * const value = new PrecisionNumber('1.239', 2).plus('2.111');\n * value.toString(); // => '3.35'\n * value.toMinus('1').toString(); // => '2.35' (original value remains '3.35')\n * ```\n */\nexport class PrecisionNumber {\n    // Private instance properties\n    readonly #decimalPlaces: number;\n    readonly #rounding: Decimal.Rounding;\n    #decimal: Decimal;\n\n    // Constructor\n\n    /**\n     * Creates a fixed-decimal number.\n     *\n     * @param value - Initial value (default: `'0'`).\n     * @param decimalPlaces - Decimal places retained after operations (default: `2`).\n     * @param rounding - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`).\n     */\n    constructor(\n        value: PrecisionNumberValue = '0',\n        decimalPlaces: number = 2,\n        rounding: Decimal.Rounding = Decimal.ROUND_DOWN,\n    ) {\n        this.#decimalPlaces = decimalPlaces;\n        this.#rounding = rounding;\n        this.#decimal = this.#decimalToFixedDecimal(new Decimal(value.toString().trim()));\n    }\n\n    // Private instance methods\n    #decimalToFixedDecimal(decimal: Decimal) {\n        return decimal.toDecimalPlaces(this.#decimalPlaces, this.#rounding);\n    }\n\n    #valueToString(value: PrecisionNumberValue) {\n        return value.toString().trim();\n    }\n\n    // Public instance accessors\n\n    /**\n     * Decimal places retained by mutating operations and default formatting.\n     */\n    get decimalPlaces() {\n        return this.#decimalPlaces;\n    }\n\n    /**\n     * Decimal.js rounding mode used by mutating operations and default formatting.\n     */\n    get rounding() {\n        return this.#rounding;\n    }\n\n    /**\n     * Fixed-decimal string using the instance precision and rounding mode.\n     */\n    get value() {\n        return this.#decimal.toFixed(this.#decimalPlaces, this.#rounding);\n    }\n\n    // Public static methods\n\n    /**\n     * Formats a value with decimal.js without creating a reusable instance.\n     *\n     * @param value - Value to format.\n     * @param decimalPlaces - Decimal places to output (default: `2`).\n     * @param rounding - Decimal.js rounding mode (default: `Decimal.ROUND_DOWN`).\n     *\n     * @returns Fixed-decimal string.\n     */\n    static toFixed(\n        value: PrecisionNumberValue,\n        decimalPlaces: number = 2,\n        rounding: Decimal.Rounding = Decimal.ROUND_DOWN,\n    ) {\n        return new Decimal(value.toString().trim()).toFixed(decimalPlaces, rounding);\n    }\n\n    // Public instance methods\n\n    /**\n     * Returns the formatted value when inspected by Node.js utilities.\n     */\n    [Symbol.for('nodejs.util.inspect.custom')]() {\n        return this.value;\n    }\n\n    /**\n     * Converts to a number for numeric coercion and to the fixed string otherwise.\n     *\n     * @param hint - JavaScript primitive-conversion hint.\n     */\n    [Symbol.toPrimitive](hint: string) {\n        if (hint === 'number') return this.#decimal.toNumber();\n        return this.value;\n    }\n\n    /**\n     * Replaces the current value with its absolute value.\n     *\n     * @returns This instance for chaining.\n     */\n    absoluteValue() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.absoluteValue());\n        return this;\n    }\n\n    /**\n     * Rounds the current value up to the nearest integer in place.\n     *\n     * @remarks\n     * The stored value still uses this instance's configured decimal places for output.\n     *\n     * @returns This instance for chaining.\n     */\n    ceil() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.ceil());\n        return this;\n    }\n\n    /**\n     * Restricts the current value to the inclusive range `[min, max]` in place.\n     *\n     * @param min - Lower bound.\n     * @param max - Upper bound.\n     *\n     * @returns This instance for chaining.\n     *\n     * @throws Error if `min` is greater than `max`.\n     */\n    clamp(min: PrecisionNumberValue, max: PrecisionNumberValue) {\n        const minDecimal = new Decimal(this.#valueToString(min));\n        const maxDecimal = new Decimal(this.#valueToString(max));\n        if (minDecimal.gt(maxDecimal)) throw new Error('Invalid clamp range: min cannot be greater than max');\n        this.#decimal = this.#decimalToFixedDecimal(Decimal.min(Decimal.max(this.#decimal, minDecimal), maxDecimal));\n        return this;\n    }\n\n    /**\n     * Returns a new instance with the same value, decimal places, and rounding mode.\n     */\n    clone() {\n        return new PrecisionNumber(this.#decimal, this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Divides the current value by another value in place.\n     *\n     * @param value - Divisor.\n     *\n     * @returns This instance for chaining.\n     */\n    dividedBy(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.dividedBy(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Checks whether the current value equals another value.\n     *\n     * @param value - Value to compare.\n     *\n     * @returns Whether both numeric values are equal.\n     */\n    equals(value: PrecisionNumberValue) {\n        return this.#decimal.equals(this.#valueToString(value));\n    }\n\n    /**\n     * Rounds the current value down to the nearest integer in place.\n     *\n     * @remarks\n     * The stored value still uses this instance's configured decimal places for output.\n     *\n     * @returns This instance for chaining.\n     */\n    floor() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.floor());\n        return this;\n    }\n\n    /**\n     * Checks whether the current value is greater than another value.\n     */\n    gt(value: PrecisionNumberValue) {\n        return this.#decimal.gt(this.#valueToString(value));\n    }\n\n    /**\n     * Checks whether the current value is greater than or equal to another value.\n     */\n    gte(value: PrecisionNumberValue) {\n        return this.#decimal.gte(this.#valueToString(value));\n    }\n\n    /**\n     * Checks whether the current value is finite.\n     */\n    isFinite() {\n        return this.#decimal.isFinite();\n    }\n\n    /**\n     * Checks whether the current value is an integer.\n     */\n    isInteger() {\n        return this.#decimal.isInteger();\n    }\n\n    /**\n     * Checks whether the current value is `NaN`.\n     */\n    isNaN() {\n        return this.#decimal.isNaN();\n    }\n\n    /**\n     * Checks whether the current value is negative.\n     */\n    isNegative() {\n        return this.#decimal.isNegative();\n    }\n\n    /**\n     * Checks whether the current value is positive.\n     */\n    isPositive() {\n        return this.#decimal.isPositive();\n    }\n\n    /**\n     * Checks whether the current value is zero.\n     */\n    isZero() {\n        return this.#decimal.isZero();\n    }\n\n    /**\n     * Checks whether the current value is less than another value.\n     */\n    lt(value: PrecisionNumberValue) {\n        return this.#decimal.lt(this.#valueToString(value));\n    }\n\n    /**\n     * Checks whether the current value is less than or equal to another value.\n     */\n    lte(value: PrecisionNumberValue) {\n        return this.#decimal.lte(this.#valueToString(value));\n    }\n\n    /**\n     * Subtracts another value from the current value in place.\n     */\n    minus(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.minus(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Replaces the current value with the remainder after division by another value.\n     *\n     * @param value - Divisor used to compute the remainder.\n     *\n     * @returns This instance for chaining.\n     */\n    modulo(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.modulo(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Negates the current value in place.\n     */\n    negate() {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.negated());\n        return this;\n    }\n\n    /**\n     * Adds another value to the current value in place.\n     */\n    plus(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.plus(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Raises the current value to an exponent in place.\n     *\n     * @param value - Exponent.\n     *\n     * @returns This instance for chaining.\n     */\n    pow(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.pow(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Multiplies the current value by another value in place.\n     */\n    times(value: PrecisionNumberValue) {\n        this.#decimal = this.#decimalToFixedDecimal(this.#decimal.times(this.#valueToString(value)));\n        return this;\n    }\n\n    /**\n     * Returns a new instance with the absolute value.\n     */\n    toAbsoluteValue() {\n        return new PrecisionNumber(this.#decimal.absoluteValue(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance rounded up to the nearest integer.\n     */\n    toCeil() {\n        return new PrecisionNumber(this.#decimal.ceil(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance restricted to the inclusive range `[min, max]`.\n     *\n     * @param min - Lower bound.\n     * @param max - Upper bound.\n     *\n     * @throws Error if `min` is greater than `max`.\n     */\n    toClamped(min: PrecisionNumberValue, max: PrecisionNumberValue) {\n        return this.clone().clamp(min, max);\n    }\n\n    /**\n     * Returns a new instance divided by another value.\n     */\n    toDividedBy(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.dividedBy(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n\n    /**\n     * Returns a new instance rounded down to the nearest integer.\n     */\n    toFloor() {\n        return new PrecisionNumber(this.#decimal.floor(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Serializes to the fixed-decimal string.\n     */\n    toJSON() {\n        return this.value;\n    }\n\n    /**\n     * Returns a new instance with another value subtracted.\n     */\n    toMinus(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.minus(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n\n    /**\n     * Returns a new instance with the remainder after division by another value.\n     */\n    toModulo(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.modulo(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n\n    /**\n     * Returns a new instance with the value negated.\n     */\n    toNegated() {\n        return new PrecisionNumber(this.#decimal.negated(), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance with another value added.\n     */\n    toPlus(value: PrecisionNumberValue) {\n        return new PrecisionNumber(this.#decimal.plus(this.#valueToString(value)), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Returns a new instance raised to an exponent.\n     */\n    toPow(value: PrecisionNumberValue) {\n        return new PrecisionNumber(this.#decimal.pow(this.#valueToString(value)), this.#decimalPlaces, this.#rounding);\n    }\n\n    /**\n     * Converts the current value to a JavaScript number.\n     *\n     * @remarks\n     * Use `toString`/`value` when preserving decimal precision is more important than native-number ergonomics.\n     */\n    toNumber() {\n        return this.#decimal.toNumber();\n    }\n\n    /**\n     * Converts the current value to its fixed-decimal string.\n     */\n    toString() {\n        return this.value;\n    }\n\n    /**\n     * Formats the current value with custom precision and rounding for this call only.\n     */\n    toFixed(decimalPlaces: number = this.#decimalPlaces, rounding: Decimal.Rounding = this.#rounding) {\n        return this.#decimal.toFixed(decimalPlaces, rounding);\n    }\n\n    /**\n     * Returns a new instance multiplied by another value.\n     */\n    toTimes(value: PrecisionNumberValue) {\n        return new PrecisionNumber(\n            this.#decimal.times(this.#valueToString(value)),\n            this.#decimalPlaces,\n            this.#rounding,\n        );\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA6BA,IAAa,kBAAb,MAAa,gBAAgB;CAEzB;CACA;CACA;;;;;;;;CAWA,YACI,QAA8B,KAC9B,gBAAwB,GACxB,WAA6B,QAAQ,YACvC;EACE,KAAK,iBAAiB;EACtB,KAAK,YAAY;EACjB,KAAK,WAAW,KAAK,uBAAuB,IAAI,QAAQ,MAAM,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC;CACpF;CAGA,uBAAuB,SAAkB;EACrC,OAAO,QAAQ,gBAAgB,KAAK,gBAAgB,KAAK,SAAS;CACtE;CAEA,eAAe,OAA6B;EACxC,OAAO,MAAM,SAAS,CAAC,CAAC,KAAK;CACjC;;;;CAOA,IAAI,gBAAgB;EAChB,OAAO,KAAK;CAChB;;;;CAKA,IAAI,WAAW;EACX,OAAO,KAAK;CAChB;;;;CAKA,IAAI,QAAQ;EACR,OAAO,KAAK,SAAS,QAAQ,KAAK,gBAAgB,KAAK,SAAS;CACpE;;;;;;;;;;CAaA,OAAO,QACH,OACA,gBAAwB,GACxB,WAA6B,QAAQ,YACvC;EACE,OAAO,IAAI,QAAQ,MAAM,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,eAAe,QAAQ;CAC/E;;;;CAOA,CAAC,OAAO,IAAI,4BAA4B,KAAK;EACzC,OAAO,KAAK;CAChB;;;;;;CAOA,CAAC,OAAO,aAAa,MAAc;EAC/B,IAAI,SAAS,UAAU,OAAO,KAAK,SAAS,SAAS;EACrD,OAAO,KAAK;CAChB;;;;;;CAOA,gBAAgB;EACZ,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,cAAc,CAAC;EACzE,OAAO;CACX;;;;;;;;;CAUA,OAAO;EACH,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,KAAK,CAAC;EAChE,OAAO;CACX;;;;;;;;;;;CAYA,MAAM,KAA2B,KAA2B;EACxD,MAAM,aAAa,IAAI,QAAQ,KAAK,eAAe,GAAG,CAAC;EACvD,MAAM,aAAa,IAAI,QAAQ,KAAK,eAAe,GAAG,CAAC;EACvD,IAAI,WAAW,GAAG,UAAU,GAAG,MAAM,IAAI,MAAM,qDAAqD;EACpG,KAAK,WAAW,KAAK,uBAAuB,QAAQ,IAAI,QAAQ,IAAI,KAAK,UAAU,UAAU,GAAG,UAAU,CAAC;EAC3G,OAAO;CACX;;;;CAKA,QAAQ;EACJ,OAAO,IAAI,gBAAgB,KAAK,UAAU,KAAK,gBAAgB,KAAK,SAAS;CACjF;;;;;;;;CASA,UAAU,OAA6B;EACnC,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,UAAU,KAAK,eAAe,KAAK,CAAC,CAAC;EAC/F,OAAO;CACX;;;;;;;;CASA,OAAO,OAA6B;EAChC,OAAO,KAAK,SAAS,OAAO,KAAK,eAAe,KAAK,CAAC;CAC1D;;;;;;;;;CAUA,QAAQ;EACJ,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,MAAM,CAAC;EACjE,OAAO;CACX;;;;CAKA,GAAG,OAA6B;EAC5B,OAAO,KAAK,SAAS,GAAG,KAAK,eAAe,KAAK,CAAC;CACtD;;;;CAKA,IAAI,OAA6B;EAC7B,OAAO,KAAK,SAAS,IAAI,KAAK,eAAe,KAAK,CAAC;CACvD;;;;CAKA,WAAW;EACP,OAAO,KAAK,SAAS,SAAS;CAClC;;;;CAKA,YAAY;EACR,OAAO,KAAK,SAAS,UAAU;CACnC;;;;CAKA,QAAQ;EACJ,OAAO,KAAK,SAAS,MAAM;CAC/B;;;;CAKA,aAAa;EACT,OAAO,KAAK,SAAS,WAAW;CACpC;;;;CAKA,aAAa;EACT,OAAO,KAAK,SAAS,WAAW;CACpC;;;;CAKA,SAAS;EACL,OAAO,KAAK,SAAS,OAAO;CAChC;;;;CAKA,GAAG,OAA6B;EAC5B,OAAO,KAAK,SAAS,GAAG,KAAK,eAAe,KAAK,CAAC;CACtD;;;;CAKA,IAAI,OAA6B;EAC7B,OAAO,KAAK,SAAS,IAAI,KAAK,eAAe,KAAK,CAAC;CACvD;;;;CAKA,MAAM,OAA6B;EAC/B,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,MAAM,KAAK,eAAe,KAAK,CAAC,CAAC;EAC3F,OAAO;CACX;;;;;;;;CASA,OAAO,OAA6B;EAChC,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,OAAO,KAAK,eAAe,KAAK,CAAC,CAAC;EAC5F,OAAO;CACX;;;;CAKA,SAAS;EACL,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,QAAQ,CAAC;EACnE,OAAO;CACX;;;;CAKA,KAAK,OAA6B;EAC9B,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,KAAK,KAAK,eAAe,KAAK,CAAC,CAAC;EAC1F,OAAO;CACX;;;;;;;;CASA,IAAI,OAA6B;EAC7B,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,IAAI,KAAK,eAAe,KAAK,CAAC,CAAC;EACzF,OAAO;CACX;;;;CAKA,MAAM,OAA6B;EAC/B,KAAK,WAAW,KAAK,uBAAuB,KAAK,SAAS,MAAM,KAAK,eAAe,KAAK,CAAC,CAAC;EAC3F,OAAO;CACX;;;;CAKA,kBAAkB;EACd,OAAO,IAAI,gBAAgB,KAAK,SAAS,cAAc,GAAG,KAAK,gBAAgB,KAAK,SAAS;CACjG;;;;CAKA,SAAS;EACL,OAAO,IAAI,gBAAgB,KAAK,SAAS,KAAK,GAAG,KAAK,gBAAgB,KAAK,SAAS;CACxF;;;;;;;;;CAUA,UAAU,KAA2B,KAA2B;EAC5D,OAAO,KAAK,MAAM,CAAC,CAAC,MAAM,KAAK,GAAG;CACtC;;;;CAKA,YAAY,OAA6B;EACrC,OAAO,IAAI,gBACP,KAAK,SAAS,UAAU,KAAK,eAAe,KAAK,CAAC,GAClD,KAAK,gBACL,KAAK,SACT;CACJ;;;;CAKA,UAAU;EACN,OAAO,IAAI,gBAAgB,KAAK,SAAS,MAAM,GAAG,KAAK,gBAAgB,KAAK,SAAS;CACzF;;;;CAKA,SAAS;EACL,OAAO,KAAK;CAChB;;;;CAKA,QAAQ,OAA6B;EACjC,OAAO,IAAI,gBACP,KAAK,SAAS,MAAM,KAAK,eAAe,KAAK,CAAC,GAC9C,KAAK,gBACL,KAAK,SACT;CACJ;;;;CAKA,SAAS,OAA6B;EAClC,OAAO,IAAI,gBACP,KAAK,SAAS,OAAO,KAAK,eAAe,KAAK,CAAC,GAC/C,KAAK,gBACL,KAAK,SACT;CACJ;;;;CAKA,YAAY;EACR,OAAO,IAAI,gBAAgB,KAAK,SAAS,QAAQ,GAAG,KAAK,gBAAgB,KAAK,SAAS;CAC3F;;;;CAKA,OAAO,OAA6B;EAChC,OAAO,IAAI,gBAAgB,KAAK,SAAS,KAAK,KAAK,eAAe,KAAK,CAAC,GAAG,KAAK,gBAAgB,KAAK,SAAS;CAClH;;;;CAKA,MAAM,OAA6B;EAC/B,OAAO,IAAI,gBAAgB,KAAK,SAAS,IAAI,KAAK,eAAe,KAAK,CAAC,GAAG,KAAK,gBAAgB,KAAK,SAAS;CACjH;;;;;;;CAQA,WAAW;EACP,OAAO,KAAK,SAAS,SAAS;CAClC;;;;CAKA,WAAW;EACP,OAAO,KAAK;CAChB;;;;CAKA,QAAQ,gBAAwB,KAAK,gBAAgB,WAA6B,KAAK,WAAW;EAC9F,OAAO,KAAK,SAAS,QAAQ,eAAe,QAAQ;CACxD;;;;CAKA,QAAQ,OAA6B;EACjC,OAAO,IAAI,gBACP,KAAK,SAAS,MAAM,KAAK,eAAe,KAAK,CAAC,GAC9C,KAAK,gBACL,KAAK,SACT;CACJ;AACJ"}

package/dist/classes/ssh-client.d.ts

@@ -13,20 +13,20 @@ declare const loggerLevelStringToConsolaLogLevelMap: {
   readonly verbose: 999;
   readonly warn: 1;
 };
-declare class SshClient {
+export declare class SshClient {
   #private;
+  getDir: (localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions) => Promise<boolean>;
+  putDir: (localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions) => Promise<boolean>;
   constructor(host: string, username: string, password: string, port?: number, connectConfig?: Config);
   get nodeSsh(): NodeSSH;
   connect(): Promise<boolean>;
   disconnect(): boolean;
   execCommand(command: string, options?: SSHExecCommandOptions): Promise<void | import("node-ssh").SSHExecCommandResponse>;
   execCommandWithIo(command: string, options?: SSHExecCommandOptions): Promise<void | import("node-ssh").SSHExecCommandResponse>;
-  getDir: (localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions) => Promise<boolean>;
   getDirectory(localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions): Promise<boolean>;
   getFile(localFile: PathLike, remoteFile: PathLike, givenSftp?: null | SFTPWrapper, transferOptions?: null | TransferOptions): Promise<boolean>;
   isConnected(): boolean;
   mkdir(path: PathLike): Promise<boolean>;
-  putDir: (localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions) => Promise<boolean>;
   putDirectory(localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions): Promise<boolean>;
   putFile(localFile: PathLike, remoteFile: PathLike, givenSftp?: null | SFTPWrapper, transferOptions?: null | TransferOptions): Promise<boolean>;
   putFiles(files: {
@@ -36,5 +36,4 @@ declare class SshClient {
   setLoggerLevel(level: keyof typeof loggerLevelStringToConsolaLogLevelMap): void;
 }
 //#endregion
-export { SshClient };
 //# sourceMappingURL=ssh-client.d.ts.map

package/dist/classes/ssh-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssh-client.d.ts","names":[],"sources":["../../src/classes/ssh-client.ts"],"mappings":";;;;cAgBM;;;;;;;;;;;cAYO;;EAMG,YAAA,cAAc,kBAAkB,kBAAkB,eAAmB,gBAAgB;MAc7F,WAAO;EAIL,WAAO;EAUb;EAUA,YAAY,iBAAiB,UAAU,wBAAqB,kCAAA;EAI5D,kBAAkB,iBAAiB,UAAU,wBAAqB,kCAAA;EAWlE,SAAM,gBAE6B,UAAQ,iBAAmB,UAAQ,UAAY,8BAAyB;EAArG,aAAa,gBAAgB,UAAU,iBAAiB,UAAU,UAAU,4BAAyB;EASrG,QACF,WAAW,UACX,YAAY,UACZ,mBAAmB,aACnB,yBAAyB,kBAAe;EAW5C;EAIM,MAAM,MAAM,WAAQ;EAU1B,SAAM,gBAE6B,UAAQ,iBAAmB,UAAQ,UAAY,8BAAyB;EAArG,aAAa,gBAAgB,UAAU,iBAAiB,UAAU,UAAU,4BAAyB;EASrG,QACF,WAAW,UACX,YAAY,UACZ,mBAAmB,aACnB,yBAAyB,kBAAe;EAWtC,SAAS;IAAS,OAAO;IAAU,QAAQ;OAAc,UAAU,qBAAkB;EAe3F,eAAe,oBAAoB"}
+{"version":3,"file":"ssh-client.d.ts","names":[],"sources":["../../src/classes/ssh-client.ts"],"mappings":";;;;cAgBM;;;;;;;;;;;qBAYO;;EAOT,SAAM,gBA2D6B,UAAQ,iBAAmB,UAAQ,UAAY,8BAAyB;EA1D3G,SAAM,gBAgG6B,UAAQ,iBAAmB,UAAQ,UAAY,8BAAyB;EA7F/F,YAAA,cAAc,kBAAkB,kBAAkB,eAAmB,gBAAgB;MAe7F,WAAO;EAKL,WAAO;EAUb;EAUA,YAAY,iBAAiB,UAAU,wBAAqB,kCAAA;EAI5D,kBAAkB,iBAAiB,UAAU,wBAAqB,kCAAA;EAW5D,aAAa,gBAAgB,UAAU,iBAAiB,UAAU,UAAU,4BAAyB;EASrG,QACF,WAAW,UACX,YAAY,UACZ,mBAAmB,aACnB,yBAAyB,kBAAe;EAW5C;EAIM,MAAM,MAAM,WAAQ;EAUpB,aAAa,gBAAgB,UAAU,iBAAiB,UAAU,UAAU,4BAAyB;EASrG,QACF,WAAW,UACX,YAAY,UACZ,mBAAmB,aACnB,yBAAyB,kBAAe;EAWtC,SAAS;IAAS,OAAO;IAAU,QAAQ;OAAc,UAAU,qBAAkB;EAe3F,eAAe,oBAAoB"}

package/dist/classes/ssh-client.js

@@ -16,6 +16,8 @@ var SshClient = class {
 	#connectConfig;
 	#logger;
 	#nodeSsh;
+	getDir = this.getDirectory;
+	putDir = this.putDirectory;
 	constructor(host, username, password, port = 22, connectConfig) {
 		this.#connectConfig = {
 			...connectConfig,
@@ -59,7 +61,6 @@ var SshClient = class {
 			onStdout: (data) => process.stdout.write(data.toString())
 		});
 	}
-	getDir = this.getDirectory;
 	async getDirectory(localDirectory, remoteDirectory, options) {
 		try {
 			return await this.#nodeSsh.getDirectory(localDirectory.toString(), remoteDirectory.toString(), options);
@@ -89,7 +90,6 @@ var SshClient = class {
 			return false;
 		}
 	}
-	putDir = this.putDirectory;
 	async putDirectory(localDirectory, remoteDirectory, options) {
 		try {
 			return await this.#nodeSsh.putDirectory(localDirectory.toString(), remoteDirectory.toString(), options);

package/dist/classes/ssh-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"ssh-client.js","names":["#connectConfig","#logger","#nodeSsh"],"sources":["../../src/classes/ssh-client.ts"],"sourcesContent":["import { createConsola } from 'consola';\nimport type { ConsolaInstance } from 'consola';\nimport { NodeSSH } from 'node-ssh';\nimport type {\n    Config,\n    SSHExecCommandOptions,\n    SSHGetPutDirectoryOptions,\n    SSHPutFilesOptions,\n} from 'node-ssh';\nimport type {\n    SFTPWrapper,\n    TransferOptions,\n} from 'ssh2';\n\nimport type { PathLike } from './path';\n\nconst loggerLevelStringToConsolaLogLevelMap = {\n    debug: 4,\n    error: 0,\n    fatal: 0,\n    info: 3,\n    normal: 2,\n    silent: -999,\n    trace: 5,\n    verbose: 999,\n    warn: 1,\n} as const;\n\nexport class SshClient {\n    readonly #connectConfig: Config;\n    readonly #logger: ConsolaInstance;\n\n    #nodeSsh: NodeSSH;\n\n    constructor(host: string, username: string, password: string, port: number = 22, connectConfig?: Config) {\n        this.#connectConfig = {\n            ...connectConfig,\n            host,\n            password,\n            port,\n            username,\n        };\n\n        this.#logger = createConsola();\n        this.#nodeSsh = new NodeSSH();\n        if (process.env.NODE_ENV === 'production') this.setLoggerLevel('error');\n    }\n\n    get nodeSsh() {\n        return this.#nodeSsh;\n    }\n\n    async connect() {\n        try {\n            this.#nodeSsh = await this.#nodeSsh.connect(this.#connectConfig);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    disconnect() {\n        try {\n            this.#nodeSsh.dispose();\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    execCommand(command: string, options?: SSHExecCommandOptions) {\n        return this.#nodeSsh.execCommand(command, options).catch(() => {});\n    }\n\n    execCommandWithIo(command: string, options?: SSHExecCommandOptions) {\n        return this.execCommand(\n            command,\n            {\n                ...options,\n                onStderr: (data) => process.stderr.write(data.toString()),\n                onStdout: (data) => process.stdout.write(data.toString()),\n            },\n        );\n    }\n\n    getDir = this.getDirectory;\n\n    async getDirectory(localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions) {\n        try {\n            return await this.#nodeSsh.getDirectory(localDirectory.toString(), remoteDirectory.toString(), options);\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    async getFile(\n        localFile: PathLike,\n        remoteFile: PathLike,\n        givenSftp?: null | SFTPWrapper,\n        transferOptions?: null | TransferOptions,\n    ) {\n        try {\n            await this.#nodeSsh.getFile(localFile.toString(), remoteFile.toString(), givenSftp, transferOptions);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    isConnected() {\n        return this.#nodeSsh.isConnected();\n    }\n\n    async mkdir(path: PathLike) {\n        try {\n            await this.#nodeSsh.mkdir(path.toString());\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    putDir = this.putDirectory;\n\n    async putDirectory(localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions) {\n        try {\n            return await this.#nodeSsh.putDirectory(localDirectory.toString(), remoteDirectory.toString(), options);\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    async putFile(\n        localFile: PathLike,\n        remoteFile: PathLike,\n        givenSftp?: null | SFTPWrapper,\n        transferOptions?: null | TransferOptions,\n    ) {\n        try {\n            await this.#nodeSsh.putFile(localFile.toString(), remoteFile.toString(), givenSftp, transferOptions);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    async putFiles(files: { local: PathLike; remote: PathLike }[], options?: SSHPutFilesOptions) {\n        try {\n            const convertedFiles = files.map(({ local, remote }) => ({\n                local: local.toString(),\n                remote: remote.toString(),\n            }));\n\n            await this.#nodeSsh.putFiles(convertedFiles, options);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    setLoggerLevel(level: keyof typeof loggerLevelStringToConsolaLogLevelMap) {\n        this.#logger.level = loggerLevelStringToConsolaLogLevelMap[level];\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"ssh-client.js","names":[],"sources":["../../src/classes/ssh-client.ts"],"sourcesContent":["import { createConsola } from 'consola';\nimport type { ConsolaInstance } from 'consola';\nimport { NodeSSH } from 'node-ssh';\nimport type {\n    Config,\n    SSHExecCommandOptions,\n    SSHGetPutDirectoryOptions,\n    SSHPutFilesOptions,\n} from 'node-ssh';\nimport type {\n    SFTPWrapper,\n    TransferOptions,\n} from 'ssh2';\n\nimport type { PathLike } from './path';\n\nconst loggerLevelStringToConsolaLogLevelMap = {\n    debug: 4,\n    error: 0,\n    fatal: 0,\n    info: 3,\n    normal: 2,\n    silent: -999,\n    trace: 5,\n    verbose: 999,\n    warn: 1,\n} as const;\n\nexport class SshClient {\n    // Private instance properties\n    readonly #connectConfig: Config;\n    readonly #logger: ConsolaInstance;\n    #nodeSsh: NodeSSH;\n\n    // Public instance properties\n    getDir = this.getDirectory;\n    putDir = this.putDirectory;\n\n    // Constructor\n    constructor(host: string, username: string, password: string, port: number = 22, connectConfig?: Config) {\n        this.#connectConfig = {\n            ...connectConfig,\n            host,\n            password,\n            port,\n            username,\n        };\n\n        this.#logger = createConsola();\n        this.#nodeSsh = new NodeSSH();\n        if (process.env.NODE_ENV === 'production') this.setLoggerLevel('error');\n    }\n\n    // Public instance accessors\n    get nodeSsh() {\n        return this.#nodeSsh;\n    }\n\n    // Public instance methods\n    async connect() {\n        try {\n            this.#nodeSsh = await this.#nodeSsh.connect(this.#connectConfig);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    disconnect() {\n        try {\n            this.#nodeSsh.dispose();\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    execCommand(command: string, options?: SSHExecCommandOptions) {\n        return this.#nodeSsh.execCommand(command, options).catch(() => {});\n    }\n\n    execCommandWithIo(command: string, options?: SSHExecCommandOptions) {\n        return this.execCommand(\n            command,\n            {\n                ...options,\n                onStderr: (data) => process.stderr.write(data.toString()),\n                onStdout: (data) => process.stdout.write(data.toString()),\n            },\n        );\n    }\n\n    async getDirectory(localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions) {\n        try {\n            return await this.#nodeSsh.getDirectory(localDirectory.toString(), remoteDirectory.toString(), options);\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    async getFile(\n        localFile: PathLike,\n        remoteFile: PathLike,\n        givenSftp?: null | SFTPWrapper,\n        transferOptions?: null | TransferOptions,\n    ) {\n        try {\n            await this.#nodeSsh.getFile(localFile.toString(), remoteFile.toString(), givenSftp, transferOptions);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    isConnected() {\n        return this.#nodeSsh.isConnected();\n    }\n\n    async mkdir(path: PathLike) {\n        try {\n            await this.#nodeSsh.mkdir(path.toString());\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    async putDirectory(localDirectory: PathLike, remoteDirectory: PathLike, options?: SSHGetPutDirectoryOptions) {\n        try {\n            return await this.#nodeSsh.putDirectory(localDirectory.toString(), remoteDirectory.toString(), options);\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    async putFile(\n        localFile: PathLike,\n        remoteFile: PathLike,\n        givenSftp?: null | SFTPWrapper,\n        transferOptions?: null | TransferOptions,\n    ) {\n        try {\n            await this.#nodeSsh.putFile(localFile.toString(), remoteFile.toString(), givenSftp, transferOptions);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    async putFiles(files: { local: PathLike; remote: PathLike }[], options?: SSHPutFilesOptions) {\n        try {\n            const convertedFiles = files.map(({ local, remote }) => ({\n                local: local.toString(),\n                remote: remote.toString(),\n            }));\n\n            await this.#nodeSsh.putFiles(convertedFiles, options);\n            return true;\n        } catch (error) {\n            this.#logger.error(error);\n            return false;\n        }\n    }\n\n    setLoggerLevel(level: keyof typeof loggerLevelStringToConsolaLogLevelMap) {\n        this.#logger.level = loggerLevelStringToConsolaLogLevelMap[level];\n    }\n}\n"],"mappings":"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"}

package/dist/clipboard.d.ts

@@ -6,53 +6,53 @@ type CopyResult = {
   ok: true;
 };
 /**
- * Attempts to copy a Blob (e.g. image, plain text, HTML) to the user's clipboard using the ClipboardItem API.
+ * Attempts to copy a blob to the browser clipboard.
  *
- * ⚠️ Usage Notes:
- * - Must be called in a **secure context** (HTTPS or localhost).
- * - Must be called **in response to a user interaction** (e.g. click, input).
- * - Not supported in Safari and some older browsers.
+ * @remarks
+ * Requires a browser environment with clipboard support, a secure context, and any user activation required
+ * by the browser. Clipboard API failures are returned as results rather than rethrown.
  *
- * @param {Blob} blob - The Blob object to copy (e.g. from a File, image, or text content)
- * @param {ClipboardItemOptions} [options] - Optional options passed to the ClipboardItem constructor
+ * @param blob - The blob whose MIME type identifies the clipboard format.
+ * @param options - Options passed to the `ClipboardItem` constructor.
  *
- * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:
- *   - `{ ok: true }` if the copy succeeded
- *   - `{ ok: false, error }` if the copy failed, with the error included
+ * @returns A promise resolving after the copy attempt to `{ ok: true }` on success, or
+ * `{ ok: false, error }` with the failure reason.
  *
  * @example
- * ```typescript
+ *
+ * ```ts
  * import { copyBlobToClipboard } from '@kikiutils/shared/clipboard';
  *
+ * // Call from a user interaction in a supported browser.
  * const blob = new Blob(['Hello world'], { type: 'text/plain' });
  * const result = await copyBlobToClipboard(blob);
  * if (result.ok) {
- *     console.log('Copied blob!');
+ *     console.log('Copied!');
  * } else {
  *     console.error('Copy failed:', result.error);
  * }
  * ```
  */
-declare function copyBlobToClipboard(blob: Blob, options?: ClipboardItemOptions): Promise<CopyResult>;
+export declare function copyBlobToClipboard(blob: Blob, options?: ClipboardItemOptions): Promise<CopyResult>;
 /**
- * Attempts to copy the given text to the user's clipboard using the modern Clipboard API.
+ * Attempts to copy text to the browser clipboard.
  *
- * ⚠️ Usage Notes:
- * - Must be called in a **secure context** (HTTPS or localhost).
- * - Must be called **in response to a user interaction** (e.g. click, input).
- * - Not supported in some older browsers (especially legacy Safari).
+ * @remarks
+ * Requires a browser environment with clipboard support, a secure context, and any user activation required
+ * by the browser. Clipboard API failures are returned as results rather than rethrown.
  *
- * @param {string} text - The string to be copied to the clipboard
+ * @param text - The text to copy.
  *
- * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:
- *   - `{ ok: true }` if the copy succeeded
- *   - `{ ok: false, error }` if the copy failed, with the error included
+ * @returns A promise resolving after the copy attempt to `{ ok: true }` on success, or
+ * `{ ok: false, error }` with the failure reason.
  *
  * @example
- * ```typescript
+ *
+ * ```ts
  * import { copyTextToClipboard } from '@kikiutils/shared/clipboard';
  *
- * const result = await copyTextToClipboard('Hello!');
+ * // Call from a user interaction in a supported browser.
+ * const result = await copyTextToClipboard('Hello world');
  * if (result.ok) {
  *     console.log('Copied!');
  * } else {
@@ -60,7 +60,6 @@ declare function copyBlobToClipboard(blob: Blob, options?: ClipboardItemOptions)
  * }
  * ```
  */
-declare function copyTextToClipboard(text: string): Promise<CopyResult>;
+export declare function copyTextToClipboard(text: string): Promise<CopyResult>;
 //#endregion
-export { copyBlobToClipboard, copyTextToClipboard };
 //# sourceMappingURL=clipboard.d.ts.map

package/dist/clipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.d.ts","names":[],"sources":["../src/clipboard.ts"],"mappings":";KAAK;EACC;EAAgB;;EAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BgB,oBAAoB,MAAM,MAAM,UAAU,uBAAuB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8CzE,oBAAoB,eAAe,QAAQ"}
+{"version":3,"file":"clipboard.d.ts","names":[],"sources":["../src/clipboard.ts"],"mappings":";KAAK;EACC;EAAgB;;EAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA8BgB,oBAAoB,MAAM,MAAM,UAAU,uBAAuB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA8CzE,oBAAoB,eAAe,QAAQ"}

package/dist/clipboard.js

@@ -1,27 +1,27 @@
 //#region src/clipboard.ts
 /**
-* Attempts to copy a Blob (e.g. image, plain text, HTML) to the user's clipboard using the ClipboardItem API.
+* Attempts to copy a blob to the browser clipboard.
 *
-* ⚠️ Usage Notes:
-* - Must be called in a **secure context** (HTTPS or localhost).
-* - Must be called **in response to a user interaction** (e.g. click, input).
-* - Not supported in Safari and some older browsers.
+* @remarks
+* Requires a browser environment with clipboard support, a secure context, and any user activation required
+* by the browser. Clipboard API failures are returned as results rather than rethrown.
 *
-* @param {Blob} blob - The Blob object to copy (e.g. from a File, image, or text content)
-* @param {ClipboardItemOptions} [options] - Optional options passed to the ClipboardItem constructor
+* @param blob - The blob whose MIME type identifies the clipboard format.
+* @param options - Options passed to the `ClipboardItem` constructor.
 *
-* @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:
-*   - `{ ok: true }` if the copy succeeded
-*   - `{ ok: false, error }` if the copy failed, with the error included
+* @returns A promise resolving after the copy attempt to `{ ok: true }` on success, or
+* `{ ok: false, error }` with the failure reason.
 *
 * @example
-* ```typescript
+*
+* ```ts
 * import { copyBlobToClipboard } from '@kikiutils/shared/clipboard';
 *
+* // Call from a user interaction in a supported browser.
 * const blob = new Blob(['Hello world'], { type: 'text/plain' });
 * const result = await copyBlobToClipboard(blob);
 * if (result.ok) {
-*     console.log('Copied blob!');
+*     console.log('Copied!');
 * } else {
 *     console.error('Copy failed:', result.error);
 * }
@@ -44,24 +44,24 @@ async function copyBlobToClipboard(blob, options) {
 	}
 }
 /**
-* Attempts to copy the given text to the user's clipboard using the modern Clipboard API.
+* Attempts to copy text to the browser clipboard.
 *
-* ⚠️ Usage Notes:
-* - Must be called in a **secure context** (HTTPS or localhost).
-* - Must be called **in response to a user interaction** (e.g. click, input).
-* - Not supported in some older browsers (especially legacy Safari).
+* @remarks
+* Requires a browser environment with clipboard support, a secure context, and any user activation required
+* by the browser. Clipboard API failures are returned as results rather than rethrown.
 *
-* @param {string} text - The string to be copied to the clipboard
+* @param text - The text to copy.
 *
-* @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:
-*   - `{ ok: true }` if the copy succeeded
-*   - `{ ok: false, error }` if the copy failed, with the error included
+* @returns A promise resolving after the copy attempt to `{ ok: true }` on success, or
+* `{ ok: false, error }` with the failure reason.
 *
 * @example
-* ```typescript
+*
+* ```ts
 * import { copyTextToClipboard } from '@kikiutils/shared/clipboard';
 *
-* const result = await copyTextToClipboard('Hello!');
+* // Call from a user interaction in a supported browser.
+* const result = await copyTextToClipboard('Hello world');
 * if (result.ok) {
 *     console.log('Copied!');
 * } else {

package/dist/clipboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.js","names":[],"sources":["../src/clipboard.ts"],"sourcesContent":["type CopyResult =\n  | { error: unknown; ok: false }\n  | { ok: true };\n\n/**\n * Attempts to copy a Blob (e.g. image, plain text, HTML) to the user's clipboard using the ClipboardItem API.\n *\n * ⚠️ Usage Notes:\n * - Must be called in a **secure context** (HTTPS or localhost).\n * - Must be called **in response to a user interaction** (e.g. click, input).\n * - Not supported in Safari and some older browsers.\n *\n * @param {Blob} blob - The Blob object to copy (e.g. from a File, image, or text content)\n * @param {ClipboardItemOptions} [options] - Optional options passed to the ClipboardItem constructor\n *\n * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:\n *   - `{ ok: true }` if the copy succeeded\n *   - `{ ok: false, error }` if the copy failed, with the error included\n *\n * @example\n * ```typescript\n * import { copyBlobToClipboard } from '@kikiutils/shared/clipboard';\n *\n * const blob = new Blob(['Hello world'], { type: 'text/plain' });\n * const result = await copyBlobToClipboard(blob);\n * if (result.ok) {\n *     console.log('Copied blob!');\n * } else {\n *     console.error('Copy failed:', result.error);\n * }\n * ```\n */\nexport async function copyBlobToClipboard(blob: Blob, options?: ClipboardItemOptions): Promise<CopyResult> {\n    if (!navigator.clipboard?.write) {\n        return {\n            error: new Error('Clipboard.write is not supported in this browser'),\n            ok: false,\n        };\n    }\n\n    try {\n        const item = new ClipboardItem({ [blob.type]: blob }, options);\n        await navigator.clipboard.write([item]);\n        return { ok: true };\n    } catch (error) {\n        return {\n            error,\n            ok: false,\n        };\n    }\n}\n\n/**\n * Attempts to copy the given text to the user's clipboard using the modern Clipboard API.\n *\n * ⚠️ Usage Notes:\n * - Must be called in a **secure context** (HTTPS or localhost).\n * - Must be called **in response to a user interaction** (e.g. click, input).\n * - Not supported in some older browsers (especially legacy Safari).\n *\n * @param {string} text - The string to be copied to the clipboard\n *\n * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:\n *   - `{ ok: true }` if the copy succeeded\n *   - `{ ok: false, error }` if the copy failed, with the error included\n *\n * @example\n * ```typescript\n * import { copyTextToClipboard } from '@kikiutils/shared/clipboard';\n *\n * const result = await copyTextToClipboard('Hello!');\n * if (result.ok) {\n *     console.log('Copied!');\n * } else {\n *     console.error('Copy failed:', result.error);\n * }\n * ```\n */\nexport async function copyTextToClipboard(text: string): Promise<CopyResult> {\n    try {\n        await navigator.clipboard.writeText(text);\n        return { ok: true };\n    } catch (error) {\n        return {\n            error,\n            ok: false,\n        };\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,eAAsB,oBAAoB,MAAY,SAAqD;CACvG,IAAI,CAAC,UAAU,WAAW,OACtB,OAAO;EACH,uBAAO,IAAI,MAAM,kDAAkD;EACnE,IAAI;CACR;CAGJ,IAAI;EACA,MAAM,OAAO,IAAI,cAAc,GAAG,KAAK,OAAO,KAAK,GAAG,OAAO;EAC7D,MAAM,UAAU,UAAU,MAAM,CAAC,IAAI,CAAC;EACtC,OAAO,EAAE,IAAI,KAAK;CACtB,SAAS,OAAO;EACZ,OAAO;GACH;GACA,IAAI;EACR;CACJ;AACJ;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,eAAsB,oBAAoB,MAAmC;CACzE,IAAI;EACA,MAAM,UAAU,UAAU,UAAU,IAAI;EACxC,OAAO,EAAE,IAAI,KAAK;CACtB,SAAS,OAAO;EACZ,OAAO;GACH;GACA,IAAI;EACR;CACJ;AACJ"}
+{"version":3,"file":"clipboard.js","names":[],"sources":["../src/clipboard.ts"],"sourcesContent":["type CopyResult =\n  | { error: unknown; ok: false }\n  | { ok: true };\n\n/**\n * Attempts to copy a blob to the browser clipboard.\n *\n * @remarks\n * Requires a browser environment with clipboard support, a secure context, and any user activation required\n * by the browser. Clipboard API failures are returned as results rather than rethrown.\n *\n * @param blob - The blob whose MIME type identifies the clipboard format.\n * @param options - Options passed to the `ClipboardItem` constructor.\n *\n * @returns A promise resolving after the copy attempt to `{ ok: true }` on success, or\n * `{ ok: false, error }` with the failure reason.\n *\n * @example\n *\n * ```ts\n * import { copyBlobToClipboard } from '@kikiutils/shared/clipboard';\n *\n * // Call from a user interaction in a supported browser.\n * const blob = new Blob(['Hello world'], { type: 'text/plain' });\n * const result = await copyBlobToClipboard(blob);\n * if (result.ok) {\n *     console.log('Copied!');\n * } else {\n *     console.error('Copy failed:', result.error);\n * }\n * ```\n */\nexport async function copyBlobToClipboard(blob: Blob, options?: ClipboardItemOptions): Promise<CopyResult> {\n    if (!navigator.clipboard?.write) {\n        return {\n            error: new Error('Clipboard.write is not supported in this browser'),\n            ok: false,\n        };\n    }\n\n    try {\n        const item = new ClipboardItem({ [blob.type]: blob }, options);\n        await navigator.clipboard.write([item]);\n        return { ok: true };\n    } catch (error) {\n        return {\n            error,\n            ok: false,\n        };\n    }\n}\n\n/**\n * Attempts to copy text to the browser clipboard.\n *\n * @remarks\n * Requires a browser environment with clipboard support, a secure context, and any user activation required\n * by the browser. Clipboard API failures are returned as results rather than rethrown.\n *\n * @param text - The text to copy.\n *\n * @returns A promise resolving after the copy attempt to `{ ok: true }` on success, or\n * `{ ok: false, error }` with the failure reason.\n *\n * @example\n *\n * ```ts\n * import { copyTextToClipboard } from '@kikiutils/shared/clipboard';\n *\n * // Call from a user interaction in a supported browser.\n * const result = await copyTextToClipboard('Hello world');\n * if (result.ok) {\n *     console.log('Copied!');\n * } else {\n *     console.error('Copy failed:', result.error);\n * }\n * ```\n */\nexport async function copyTextToClipboard(text: string): Promise<CopyResult> {\n    try {\n        await navigator.clipboard.writeText(text);\n        return { ok: true };\n    } catch (error) {\n        return {\n            error,\n            ok: false,\n        };\n    }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,eAAsB,oBAAoB,MAAY,SAAqD;CACvG,IAAI,CAAC,UAAU,WAAW,OACtB,OAAO;EACH,uBAAO,IAAI,MAAM,kDAAkD;EACnE,IAAI;CACR;CAGJ,IAAI;EACA,MAAM,OAAO,IAAI,cAAc,GAAG,KAAK,OAAO,KAAK,GAAG,OAAO;EAC7D,MAAM,UAAU,UAAU,MAAM,CAAC,IAAI,CAAC;EACtC,OAAO,EAAE,IAAI,KAAK;CACtB,SAAS,OAAO;EACZ,OAAO;GACH;GACA,IAAI;EACR;CACJ;AACJ;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,eAAsB,oBAAoB,MAAmC;CACzE,IAAI;EACA,MAAM,UAAU,UAAU,UAAU,IAAI;EACxC,OAAO,EAAE,IAAI,KAAK;CACtB,SAAS,OAAO;EACZ,OAAO;GACH;GACA,IAAI;EACR;CACJ;AACJ"}