@tspro/ts-utils-lib 2.3.0 → 3.0.0

package/CHANGELOG.md

@@ -1,4 +1,8 @@
 # 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.

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;