@tspro/ts-utils-lib 3.1.1 → 3.3.0

package/CHANGELOG.md

@@ -1,4 +1,15 @@
 # Changelog
+## [3.3.0] - 2026-01-12
+## Changed
+- Loosen some Utils.Dom function arguments from HTMLElement to Element.
+- Utils.Dom.addClass() and removeClass() accept multiple class names using variadic arg. 
+
+## [3.2.0] - 2026-01-??
+## Added
+- Utils.Str.trimStart()
+- Utils.Str.trimEnd()
+- Utils.Str.trim()
+
 ## [3.1.1] - 2026-01-08
 ## Fixed
 - CallTracker.

package/README.md

@@ -14,6 +14,12 @@ lib is written by AI.
 
 Homepage contains TS Docs/API Reference.
 
+## Version 3.x Info
+Version `3.0.0` changed `Device`.
+
+Version `3.1.0` added invalid `CallTracker`.
+Use version `3.1.1` with correct `CallTracker` instead.
+
 ## Install
 `npm install @tspro/ts-utils-lib`
 
@@ -50,29 +56,3 @@ const map = new UniMap();
     console.log(Utils.Str.stringify(map));
 </script>
 ```
-
-## Version 2 Update
-
-Made major update because
-- Wanted to remove deprecated renamed or obsoloted stuff.
-- Wanted to upgrade Assert and Guard namespaces.
-- Version 1 had already grown a bit.
-
-Deprecations and replacements
-- `Vec2` -> `Vec`
-- `Map1` -> `UniMap`
-- `Map2` -> `BiMap`
-- `Map3` -> `TriMap`
-- `Set1` -> `ValueSet`
-- `DeepSet` -> `ValueSet.createDeep()`
-- `DivRect` -> `AnchoredRect`
-- `Utils.Is.isX...` -> `Guard.isX...`
-
-Additions
-- `Rect`
-- `Guard.is*`  - intriduced more guards.
-- `Assert.is*` - introduced more assertions.
-- `Utils.Str.stringify(val)` - generic format-anything.
-
-There are some other changes (e.g. `Guard.isOddNumber()` -> `Guard.isOdd()`
-and so on), but most the stuff is compatible with 1.x.

package/dist/index.d.ts

@@ -22,7 +22,7 @@ declare namespace index$8 {
 type ErrorConstructor = new (msg: string) => Error;
 declare function setErrorClass(errorClass?: ErrorConstructor): void;
 declare function assert<T>(condition: T, msg?: string): void;
-declare function require<T>(val: T | null | undefined, msg?: string): T;
+declare function require$1<T>(val: T | null | undefined, msg?: string): T;
 declare function requireDefined<T>(val: T | undefined, msg?: string): T;
 declare function requireElement<E>(index: unknown, array: ReadonlyArray<E>, msg?: string): E;
 declare function fail(msg?: string): never;
@@ -108,12 +108,11 @@ declare function doesNotThrow$1(throwTestFn: () => void, msg?: string): true;
 type index$7_ErrorConstructor = ErrorConstructor;
 declare const index$7_assert: typeof assert;
 declare const index$7_fail: typeof fail;
-declare const index$7_require: typeof require;
 declare const index$7_requireDefined: typeof requireDefined;
 declare const index$7_requireElement: typeof requireElement;
 declare const index$7_setErrorClass: typeof setErrorClass;
 declare namespace index$7 {
-  export { type index$7_ErrorConstructor as ErrorConstructor, index$7_assert as assert, doesNotThrow$1 as doesNotThrow, doesThrow$1 as doesThrow, index$7_fail as fail, isArray$1 as isArray, isArrayOrUndefined$1 as isArrayOrUndefined, isBigInt$1 as isBigInt, isBoolean$1 as isBoolean, isBooleanOrUndefined$1 as isBooleanOrUndefined, isDeepEqual$1 as isDeepEqual, isDefined$1 as isDefined, isEmptyArray$1 as isEmptyArray, isEmptyArrayOrUndefined$1 as isEmptyArrayOrUndefined, isEmptyObject$1 as isEmptyObject, isEmptyString$1 as isEmptyString, isEmptyStringOrUndefined$1 as isEmptyStringOrUndefined, isEnumValue$1 as isEnumValue, isEnumValueOrUndefined$1 as isEnumValueOrUndefined, isEven$1 as isEven, isFalse$1 as isFalse, isFalseOrUndefined$1 as isFalseOrUndefined, isFinite$1 as isFinite, isFloat$1 as isFloat, isFunction$1 as isFunction, isFunctionOrUndefined$1 as isFunctionOrUndefined, isIncluded$1 as isIncluded, isIndex$1 as isIndex, isInfinity$1 as isInfinity, isInteger$1 as isInteger, isIntegerBetween$1 as isIntegerBetween, isIntegerBetweenExclusive$1 as isIntegerBetweenExclusive, isIntegerEq$1 as isIntegerEq, isIntegerGt$1 as isIntegerGt, isIntegerGte$1 as isIntegerGte, isIntegerLt$1 as isIntegerLt, isIntegerLte$1 as isIntegerLte, isIntegerOrUndefined$1 as isIntegerOrUndefined, isMultipleOf$1 as isMultipleOf, isNaNValue$1 as isNaNValue, isNeg$1 as isNeg, isNegInfinity$1 as isNegInfinity, isNegZero$1 as isNegZero, isNonEmptyArray$1 as isNonEmptyArray, isNonEmptyArrayOrUndefined$1 as isNonEmptyArrayOrUndefined, isNonEmptyString$1 as isNonEmptyString, isNonEmptyStringOrUndefined$1 as isNonEmptyStringOrUndefined, isNonNeg$1 as isNonNeg, isNonNull$1 as isNonNull, isNonPos$1 as isNonPos, isNull$1 as isNull, isNullish$1 as isNullish, isNumber$1 as isNumber, isNumberBetween$1 as isNumberBetween, isNumberBetweenExclusive$1 as isNumberBetweenExclusive, isNumberEq$1 as isNumberEq, isNumberGt$1 as isNumberGt, isNumberGte$1 as isNumberGte, isNumberLt$1 as isNumberLt, isNumberLte$1 as isNumberLte, isNumberOrUndefined$1 as isNumberOrUndefined, isNumericString$1 as isNumericString, isObject$1 as isObject, isObjectOrUndefined$1 as isObjectOrUndefined, isOdd$1 as isOdd, isPlainObject$1 as isPlainObject, isPos$1 as isPos, isPosInfinity$1 as isPosInfinity, isPosZero$1 as isPosZero, isPowerOfTwo$1 as isPowerOfTwo, isSafeInteger$1 as isSafeInteger, isSafeNumber$1 as isSafeNumber, isStrictEqual$1 as isStrictEqual, isString$1 as isString, isStringOrUndefined$1 as isStringOrUndefined, isTrue$1 as isTrue, isTrueOrUndefined$1 as isTrueOrUndefined, isTypedObject$1 as isTypedObject, isUndefined$1 as isUndefined, isZero$1 as isZero, index$7_require as require, index$7_requireDefined as requireDefined, index$7_requireElement as requireElement, index$7_setErrorClass as setErrorClass };
+  export { type index$7_ErrorConstructor as ErrorConstructor, index$7_assert as assert, doesNotThrow$1 as doesNotThrow, doesThrow$1 as doesThrow, index$7_fail as fail, isArray$1 as isArray, isArrayOrUndefined$1 as isArrayOrUndefined, isBigInt$1 as isBigInt, isBoolean$1 as isBoolean, isBooleanOrUndefined$1 as isBooleanOrUndefined, isDeepEqual$1 as isDeepEqual, isDefined$1 as isDefined, isEmptyArray$1 as isEmptyArray, isEmptyArrayOrUndefined$1 as isEmptyArrayOrUndefined, isEmptyObject$1 as isEmptyObject, isEmptyString$1 as isEmptyString, isEmptyStringOrUndefined$1 as isEmptyStringOrUndefined, isEnumValue$1 as isEnumValue, isEnumValueOrUndefined$1 as isEnumValueOrUndefined, isEven$1 as isEven, isFalse$1 as isFalse, isFalseOrUndefined$1 as isFalseOrUndefined, isFinite$1 as isFinite, isFloat$1 as isFloat, isFunction$1 as isFunction, isFunctionOrUndefined$1 as isFunctionOrUndefined, isIncluded$1 as isIncluded, isIndex$1 as isIndex, isInfinity$1 as isInfinity, isInteger$1 as isInteger, isIntegerBetween$1 as isIntegerBetween, isIntegerBetweenExclusive$1 as isIntegerBetweenExclusive, isIntegerEq$1 as isIntegerEq, isIntegerGt$1 as isIntegerGt, isIntegerGte$1 as isIntegerGte, isIntegerLt$1 as isIntegerLt, isIntegerLte$1 as isIntegerLte, isIntegerOrUndefined$1 as isIntegerOrUndefined, isMultipleOf$1 as isMultipleOf, isNaNValue$1 as isNaNValue, isNeg$1 as isNeg, isNegInfinity$1 as isNegInfinity, isNegZero$1 as isNegZero, isNonEmptyArray$1 as isNonEmptyArray, isNonEmptyArrayOrUndefined$1 as isNonEmptyArrayOrUndefined, isNonEmptyString$1 as isNonEmptyString, isNonEmptyStringOrUndefined$1 as isNonEmptyStringOrUndefined, isNonNeg$1 as isNonNeg, isNonNull$1 as isNonNull, isNonPos$1 as isNonPos, isNull$1 as isNull, isNullish$1 as isNullish, isNumber$1 as isNumber, isNumberBetween$1 as isNumberBetween, isNumberBetweenExclusive$1 as isNumberBetweenExclusive, isNumberEq$1 as isNumberEq, isNumberGt$1 as isNumberGt, isNumberGte$1 as isNumberGte, isNumberLt$1 as isNumberLt, isNumberLte$1 as isNumberLte, isNumberOrUndefined$1 as isNumberOrUndefined, isNumericString$1 as isNumericString, isObject$1 as isObject, isObjectOrUndefined$1 as isObjectOrUndefined, isOdd$1 as isOdd, isPlainObject$1 as isPlainObject, isPos$1 as isPos, isPosInfinity$1 as isPosInfinity, isPosZero$1 as isPosZero, isPowerOfTwo$1 as isPowerOfTwo, isSafeInteger$1 as isSafeInteger, isSafeNumber$1 as isSafeNumber, isStrictEqual$1 as isStrictEqual, isString$1 as isString, isStringOrUndefined$1 as isStringOrUndefined, isTrue$1 as isTrue, isTrueOrUndefined$1 as isTrueOrUndefined, isTypedObject$1 as isTypedObject, isUndefined$1 as isUndefined, isZero$1 as isZero, require$1 as require, index$7_requireDefined as requireDefined, index$7_requireElement as requireElement, index$7_setErrorClass as setErrorClass };
 }
 
 /**
@@ -431,9 +430,9 @@ interface CSSProperties {
     width?: string | number;
     height?: string | number;
 }
-declare function hasClass(el: HTMLElement, className: string): boolean;
-declare function addClass(el: HTMLElement, className: string): void;
-declare function removeClass(el: HTMLElement, className: string): void;
+declare function hasClass(el: Element, className: string): boolean;
+declare function addClass(el: Element, ...className: string[]): void;
+declare function removeClass(el: Element, ...className: string[]): void;
 declare function setOffset(el: HTMLElement, left: number, top: number, unit?: string): void;
 declare function getOffset(el: HTMLElement): {
     left: number;
@@ -443,12 +442,12 @@ declare function getWidth(el: HTMLElement | Window): number;
 declare function setWidth(el: HTMLElement, val: number): void;
 declare function getHeight(el: HTMLElement | Window): number;
 declare function setHeight(el: HTMLElement, val: number): void;
-declare function appendTo(el: HTMLElement | SVGElement, to: HTMLElement | SVGElement): void;
-declare function removeFromParent(el: HTMLElement | SVGElement): void;
+declare function appendTo(el: Element | SVGElement, to: Element | SVGElement): void;
+declare function removeFromParent(el: Element | SVGElement): void;
 declare function setVisibility(el: HTMLElement | SVGElement, visible: boolean): void;
 declare function setRect(el: HTMLElement, left: number, top: number, width: number, height: number, unit?: string): void;
-declare function getButton(btn: HTMLElement | string): HTMLButtonElement | undefined;
-declare function getCanvas(canvas: HTMLElement | string): HTMLCanvasElement | undefined;
+declare function getButton(btn: Element | string): HTMLButtonElement | undefined;
+declare function getCanvas(canvas: Element | string): HTMLCanvasElement | undefined;
 declare function getPadding(style?: CSSProperties): {
     top: number;
     right: number;
@@ -650,6 +649,9 @@ declare function splitByStrings(str: string, ...splitters: string[]): string[];
  * @returns An array of string segments split at any of the given characters.
  */
 declare function splitByChars(str: string, splitters: string): string[];
+declare function trimStart(str: string, ...chars: string[]): string;
+declare function trimEnd(str: string, ...chars: string[]): string;
+declare function trim(str: string, ...chars: string[]): string;
 
 declare const index$1_charCount: typeof charCount;
 declare const index$1_chunkString: typeof chunkString;
@@ -664,8 +666,11 @@ declare const index$1_splitByChars: typeof splitByChars;
 declare const index$1_splitByStrings: typeof splitByStrings;
 declare const index$1_stringify: typeof stringify;
 declare const index$1_toCharArray: typeof toCharArray;
+declare const index$1_trim: typeof trim;
+declare const index$1_trimEnd: typeof trimEnd;
+declare const index$1_trimStart: typeof trimStart;
 declare namespace index$1 {
-  export { index$1_charCount as charCount, index$1_chunkString as chunkString, index$1_insertAt as insertAt, index$1_isString as isString, index$1_makeSentenceFromPascal as makeSentenceFromPascal, index$1_removeAt as removeAt, index$1_repeatString as repeatString, index$1_replaceAt as replaceAt, index$1_splitByCaps as splitByCaps, index$1_splitByChars as splitByChars, index$1_splitByStrings as splitByStrings, index$1_stringify as stringify, index$1_toCharArray as toCharArray };
+  export { index$1_charCount as charCount, index$1_chunkString as chunkString, index$1_insertAt as insertAt, index$1_isString as isString, index$1_makeSentenceFromPascal as makeSentenceFromPascal, index$1_removeAt as removeAt, index$1_repeatString as repeatString, index$1_replaceAt as replaceAt, index$1_splitByCaps as splitByCaps, index$1_splitByChars as splitByChars, index$1_splitByStrings as splitByStrings, index$1_stringify as stringify, index$1_toCharArray as toCharArray, index$1_trim as trim, index$1_trimEnd as trimEnd, index$1_trimStart as trimStart };
 }
 
 declare namespace index {