@tspro/ts-utils-lib 2.2.1 → 3.0.0

package/CHANGELOG.md

@@ -1,4 +1,16 @@
 # Changelog
+## [3.0.0] - 2026-01-08
+### Breaking Change
+- Device module update.
+
+## [2.3.0] - 2025-11-27
+### Changed
+- Replaced .d.mts type declarations with .d.ts.
+- Include .map files in package.
+
+### Added
+- Utils.Dom.injectCss()
+
 ## [2.2.1] - 2025-11-25
 ### Fixed
 - Moved "core-js" and "regenerator-runtime" to "devDependencies" because 

package/README.md

@@ -15,7 +15,7 @@ lib is written by AI.
 Homepage contains TS Docs/API Reference.
 
 ## Install
-`npm i @tspro/ts-utils-lib`
+`npm install @tspro/ts-utils-lib`
 
 ## Usage
 ```js
@@ -36,12 +36,12 @@ const map = new UniMap();
 
 ```html
 <!-- Load non-polyfilled or polyfilled bundles on unpkg cdn -->
-<script src="https://unpkg.com/@tspro/ts-utils-lib@2.2.0/dist/index.es5.iife.js"></script>
-<script src="https://unpkg.com/@tspro/ts-utils-lib@2.2.0/dist/index.es5.polyfilled.iife.js"></script>
+<script src="https://unpkg.com/@tspro/ts-utils-lib@2.3.0/dist/index.es5.iife.js"></script>
+<script src="https://unpkg.com/@tspro/ts-utils-lib@2.3.0/dist/index.es5.polyfilled.iife.js"></script>
 
 <!-- Load non-polyfilled or polyfilled bundles on jsdelivr cdn -->
-<script src="https://cdn.jsdelivr.net/npm/@tspro/ts-utils-lib@2.2.0/dist/index.es5.iife.js"></script>
-<script src="https://cdn.jsdelivr.net/npm/@tspro/ts-utils-lib@2.2.0/dist/index.es5.polyfilled.iife.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/@tspro/ts-utils-lib@2.3.0/dist/index.es5.iife.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/@tspro/ts-utils-lib@2.3.0/dist/index.es5.polyfilled.iife.js"></script>
 
 <!-- JS example: -->
 <script>

package/dist/index.d.ts

@@ -186,10 +186,7 @@ declare namespace cookies {
   export { cookies_accept as accept, cookies_decline as decline, cookies_erase as erase, cookies_eraseAll as eraseAll, cookies_isConsentPending as isConsentPending, cookies_read as read, cookies_readBool as readBool, cookies_readInt as readInt, cookies_save as save, cookies_setExpireDays as setExpireDays };
 }
 
-/** Devices dots per inch. */
-declare const DPI: number;
-/** Devices pixels per millimeter. */
-declare const PxPerMm: number;
+type CssUnit = "px" | "cm" | "mm" | "in" | "pt" | "pc" | "em" | "rem" | "vw" | "vh" | "vmin" | "vmax" | "%";
 /** Browsers scroll bar width. */
 declare const ScrollbarWidth: number;
 /** Browsers system font size. */
@@ -200,39 +197,34 @@ declare const IsTouchDevice: boolean;
 declare const IsMobileDevice: boolean;
 /** Host address. */
 declare const HostAddress: string;
-/**
- * Convert pixels to millimeters on a device.
- * @param px - Pixels.
- * @returns - Millimeters.
- */
-declare function pxToMm(px: number): number;
-/**
- * Convert millimeters to pixels on a device.
- * @param mm - Millimeters.
- * @returns - Pixels.
- */
-declare function mmToPx(mm: number): number;
+/** Device pixel ratio. */
+declare const DevicePixelRatio: number;
+/** Devices dots per inch. */
+declare const DPI: number;
 /**
  * Convert input to pixels on a device. Input value is in html style form containing number
  * followed by unit (e.g. "10px"). Supported units are "mm", "cm", "in", "inch", "em" and "px".
  *
- * @param input - Input value.
+ * @param valueUnit - Input value.
  * @returns - Pixels.
  */
-declare function toPx(input: string | number): number;
+declare function unitToPx(valueUnit: string | number): number;
+declare function pxToUnit(px: number, unit: CssUnit): number;
+declare function pxToUnitStr(px: number, unit: CssUnit): string;
 
+type device_CssUnit = CssUnit;
 declare const device_DPI: typeof DPI;
+declare const device_DevicePixelRatio: typeof DevicePixelRatio;
 declare const device_FontSize: typeof FontSize;
 declare const device_HostAddress: typeof HostAddress;
 declare const device_IsMobileDevice: typeof IsMobileDevice;
 declare const device_IsTouchDevice: typeof IsTouchDevice;
-declare const device_PxPerMm: typeof PxPerMm;
 declare const device_ScrollbarWidth: typeof ScrollbarWidth;
-declare const device_mmToPx: typeof mmToPx;
-declare const device_pxToMm: typeof pxToMm;
-declare const device_toPx: typeof toPx;
+declare const device_pxToUnit: typeof pxToUnit;
+declare const device_pxToUnitStr: typeof pxToUnitStr;
+declare const device_unitToPx: typeof unitToPx;
 declare namespace device {
-  export { device_DPI as DPI, device_FontSize as FontSize, device_HostAddress as HostAddress, device_IsMobileDevice as IsMobileDevice, device_IsTouchDevice as IsTouchDevice, device_PxPerMm as PxPerMm, device_ScrollbarWidth as ScrollbarWidth, device_mmToPx as mmToPx, device_pxToMm as pxToMm, device_toPx as toPx };
+  export { type device_CssUnit as CssUnit, device_DPI as DPI, device_DevicePixelRatio as DevicePixelRatio, device_FontSize as FontSize, device_HostAddress as HostAddress, device_IsMobileDevice as IsMobileDevice, device_IsTouchDevice as IsTouchDevice, device_ScrollbarWidth as ScrollbarWidth, device_pxToUnit as pxToUnit, device_pxToUnitStr as pxToUnitStr, device_unitToPx as unitToPx };
 }
 
 type HasProps<T extends object> = T extends Record<string, unknown> ? T : never;
@@ -471,6 +463,12 @@ declare function getDimension(style?: CSSProperties): {
 };
 declare function styleLayoutChanged(style1?: CSSProperties, style2?: CSSProperties): boolean;
 declare function getCanvasTextWidth(text: string, font: string): number;
+/**
+ * Add style element to document head.
+ * @param styleId - Id of style element.
+ * @param styleCss - Style CSS string.
+ */
+declare function injectCss(styleId: string, styleCss: string): void;
 
 type index$4_CSSProperties = CSSProperties;
 declare const index$4_addClass: typeof addClass;
@@ -484,6 +482,7 @@ declare const index$4_getOffset: typeof getOffset;
 declare const index$4_getPadding: typeof getPadding;
 declare const index$4_getWidth: typeof getWidth;
 declare const index$4_hasClass: typeof hasClass;
+declare const index$4_injectCss: typeof injectCss;
 declare const index$4_removeClass: typeof removeClass;
 declare const index$4_removeFromParent: typeof removeFromParent;
 declare const index$4_setHeight: typeof setHeight;
@@ -493,7 +492,7 @@ declare const index$4_setVisibility: typeof setVisibility;
 declare const index$4_setWidth: typeof setWidth;
 declare const index$4_styleLayoutChanged: typeof styleLayoutChanged;
 declare namespace index$4 {
-  export { type index$4_CSSProperties as CSSProperties, index$4_addClass as addClass, index$4_appendTo as appendTo, index$4_getButton as getButton, index$4_getCanvas as getCanvas, index$4_getCanvasTextWidth as getCanvasTextWidth, index$4_getDimension as getDimension, index$4_getHeight as getHeight, index$4_getOffset as getOffset, index$4_getPadding as getPadding, index$4_getWidth as getWidth, index$4_hasClass as hasClass, index$4_removeClass as removeClass, index$4_removeFromParent as removeFromParent, index$4_setHeight as setHeight, index$4_setOffset as setOffset, index$4_setRect as setRect, index$4_setVisibility as setVisibility, index$4_setWidth as setWidth, index$4_styleLayoutChanged as styleLayoutChanged };
+  export { type index$4_CSSProperties as CSSProperties, index$4_addClass as addClass, index$4_appendTo as appendTo, index$4_getButton as getButton, index$4_getCanvas as getCanvas, index$4_getCanvasTextWidth as getCanvasTextWidth, index$4_getDimension as getDimension, index$4_getHeight as getHeight, index$4_getOffset as getOffset, index$4_getPadding as getPadding, index$4_getWidth as getWidth, index$4_hasClass as hasClass, index$4_injectCss as injectCss, index$4_removeClass as removeClass, index$4_removeFromParent as removeFromParent, index$4_setHeight as setHeight, index$4_setOffset as setOffset, index$4_setRect as setRect, index$4_setVisibility as setVisibility, index$4_setWidth as setWidth, index$4_styleLayoutChanged as styleLayoutChanged };
 }
 
 declare function linearToDecibels(linearVolume: number): number;