@just-web/toolkits 3.0.0 → 3.1.0

package/dist/index.cjs

@@ -13,7 +13,12 @@ const require_get_css_variable_value = require('./style/get-css-variable-value.c
 const require_resolve_style = require('./style/resolve-style.cjs');
 const require_to_dom_style = require('./style/to-dom-style.cjs');
 const require_get_rem_to_px_scale = require('./units/get-rem-to-px-scale.cjs');
-const require_px_2_num = require('./units/px-2-num.cjs');
+const require_parse_css_value = require('./units/parse-css-value.cjs');
+const require_convert_css_unit = require('./units/convert-css-unit.cjs');
+const require_create_css_unit_converter = require('./units/create-css-unit-converter.cjs');
+const require_get_css_unit = require('./units/get-css-unit.cjs');
+const require_parse_css_number = require('./units/parse-css-number.cjs');
+const require_is_effectively_zero = require('./units/is-effectively-zero.cjs');
 const require_px_2_rem = require('./units/px-2-rem.cjs');
 const require_rem_2_px = require('./units/rem-2-px.cjs');
 const require_append_id = require('./utils/append-id.cjs');
@@ -21,16 +26,22 @@ let clsx = require("clsx");
 
 exports.appendId = require_append_id.appendId;
 exports.clsx = clsx.default;
+exports.convertCssUnit = require_convert_css_unit.convertCssUnit;
+exports.createCssUnitConverter = require_create_css_unit_converter.createCssUnitConverter;
 exports.defineCSSProperties = require_define_css_properties.defineCSSProperties;
 exports.getAttribute = require_get_attribute.getAttribute;
 exports.getCSSVariableValue = require_get_css_variable_value.getCSSVariableValue;
+exports.getCssUnit = require_get_css_unit.getCssUnit;
 exports.getDataAttribute = require_get_data_attribute.getDataAttribute;
 exports.getPrefersColorScheme = require_get_prefers_color_scheme.getPrefersColorScheme;
 exports.getRemToPxScale = require_get_rem_to_px_scale.getRemToPxScale;
+exports.isEffectivelyZero = require_is_effectively_zero.isEffectivelyZero;
 exports.observeAttributes = require_observe_attribute.observeAttributes;
 exports.observeDataAttributes = require_observe_data_attribute.observeDataAttributes;
 exports.observePrefersColorScheme = require_observe_prefers_color_scheme.observePrefersColorScheme;
-exports.px2num = require_px_2_num.px2num;
+exports.parseCssNumber = require_parse_css_number.parseCssNumber;
+exports.parseCssValue = require_parse_css_value.parseCssValue;
+exports.px2num = require_parse_css_number.parseCssNumber;
 exports.px2rem = require_px_2_rem.px2rem;
 exports.rem2px = require_rem_2_px.rem2px;
 exports.resolveChildren = require_resolve_children.resolveChildren;

package/dist/index.d.cts

@@ -19,9 +19,15 @@ import { JustStyle, JustStyleFnProps, JustStyleProps } from "./style/just-style.
 import { resolveStyle } from "./style/resolve-style.cjs";
 import { StyleProps } from "./style/style-props.cjs";
 import { toDomStyle } from "./style/to-dom-style.cjs";
+import { ConvertCssUnitOptions, CssLengthUnit, CssUnitConverterContext } from "./units/css-unit-converter.types.cjs";
+import { convertCssUnit } from "./units/convert-css-unit.cjs";
+import { createCssUnitConverter } from "./units/create-css-unit-converter.cjs";
+import { getCssUnit } from "./units/get-css-unit.cjs";
 import { getRemToPxScale } from "./units/get-rem-to-px-scale.cjs";
-import { px2num } from "./units/px-2-num.cjs";
+import { isEffectivelyZero } from "./units/is-effectively-zero.cjs";
+import { parseCssNumber } from "./units/parse-css-number.cjs";
+import { parseCssValue } from "./units/parse-css-value.cjs";
 import { px2rem } from "./units/px-2-rem.cjs";
 import { rem2px } from "./units/rem-2-px.cjs";
 import { appendId } from "./utils/append-id.cjs";
-export { CSSProperties, ClassNameProps, ColorScheme, DataAttribute, JustChildren, JustChildrenFnProps, JustChildrenProps, JustClassName, JustClassNameFnProps, JustClassNameProps, JustStyle, JustStyleFnProps, JustStyleProps, StyleProps, appendId, clsx, defineCSSProperties, getAttribute, getCSSVariableValue, getDataAttribute, getPrefersColorScheme, getRemToPxScale, observeAttributes, observeDataAttributes, observePrefersColorScheme, px2num, px2rem, rem2px, resolveChildren, resolveClassName, resolveStyle, toDomStyle };
+export { CSSProperties, ClassNameProps, ColorScheme, ConvertCssUnitOptions, CssLengthUnit, CssUnitConverterContext, DataAttribute, JustChildren, JustChildrenFnProps, JustChildrenProps, JustClassName, JustClassNameFnProps, JustClassNameProps, JustStyle, JustStyleFnProps, JustStyleProps, StyleProps, appendId, clsx, convertCssUnit, createCssUnitConverter, defineCSSProperties, getAttribute, getCSSVariableValue, getCssUnit, getDataAttribute, getPrefersColorScheme, getRemToPxScale, isEffectivelyZero, observeAttributes, observeDataAttributes, observePrefersColorScheme, parseCssNumber, parseCssValue, parseCssNumber as px2num, px2rem, rem2px, resolveChildren, resolveClassName, resolveStyle, toDomStyle };

package/dist/index.d.mts

@@ -19,9 +19,15 @@ import { JustStyle, JustStyleFnProps, JustStyleProps } from "./style/just-style.
 import { resolveStyle } from "./style/resolve-style.mjs";
 import { StyleProps } from "./style/style-props.mjs";
 import { toDomStyle } from "./style/to-dom-style.mjs";
+import { ConvertCssUnitOptions, CssLengthUnit, CssUnitConverterContext } from "./units/css-unit-converter.types.mjs";
+import { convertCssUnit } from "./units/convert-css-unit.mjs";
+import { createCssUnitConverter } from "./units/create-css-unit-converter.mjs";
+import { getCssUnit } from "./units/get-css-unit.mjs";
 import { getRemToPxScale } from "./units/get-rem-to-px-scale.mjs";
-import { px2num } from "./units/px-2-num.mjs";
+import { isEffectivelyZero } from "./units/is-effectively-zero.mjs";
+import { parseCssNumber } from "./units/parse-css-number.mjs";
+import { parseCssValue } from "./units/parse-css-value.mjs";
 import { px2rem } from "./units/px-2-rem.mjs";
 import { rem2px } from "./units/rem-2-px.mjs";
 import { appendId } from "./utils/append-id.mjs";
-export { CSSProperties, ClassNameProps, ColorScheme, DataAttribute, JustChildren, JustChildrenFnProps, JustChildrenProps, JustClassName, JustClassNameFnProps, JustClassNameProps, JustStyle, JustStyleFnProps, JustStyleProps, StyleProps, appendId, clsx, defineCSSProperties, getAttribute, getCSSVariableValue, getDataAttribute, getPrefersColorScheme, getRemToPxScale, observeAttributes, observeDataAttributes, observePrefersColorScheme, px2num, px2rem, rem2px, resolveChildren, resolveClassName, resolveStyle, toDomStyle };
+export { CSSProperties, ClassNameProps, ColorScheme, ConvertCssUnitOptions, CssLengthUnit, CssUnitConverterContext, DataAttribute, JustChildren, JustChildrenFnProps, JustChildrenProps, JustClassName, JustClassNameFnProps, JustClassNameProps, JustStyle, JustStyleFnProps, JustStyleProps, StyleProps, appendId, clsx, convertCssUnit, createCssUnitConverter, defineCSSProperties, getAttribute, getCSSVariableValue, getCssUnit, getDataAttribute, getPrefersColorScheme, getRemToPxScale, isEffectivelyZero, observeAttributes, observeDataAttributes, observePrefersColorScheme, parseCssNumber, parseCssValue, parseCssNumber as px2num, px2rem, rem2px, resolveChildren, resolveClassName, resolveStyle, toDomStyle };

package/dist/index.mjs

@@ -12,9 +12,14 @@ import { getCSSVariableValue } from "./style/get-css-variable-value.mjs";
 import { resolveStyle } from "./style/resolve-style.mjs";
 import { toDomStyle } from "./style/to-dom-style.mjs";
 import { getRemToPxScale } from "./units/get-rem-to-px-scale.mjs";
-import { px2num } from "./units/px-2-num.mjs";
+import { parseCssValue } from "./units/parse-css-value.mjs";
+import { convertCssUnit } from "./units/convert-css-unit.mjs";
+import { createCssUnitConverter } from "./units/create-css-unit-converter.mjs";
+import { getCssUnit } from "./units/get-css-unit.mjs";
+import { parseCssNumber } from "./units/parse-css-number.mjs";
+import { isEffectivelyZero } from "./units/is-effectively-zero.mjs";
 import { px2rem } from "./units/px-2-rem.mjs";
 import { rem2px } from "./units/rem-2-px.mjs";
 import { appendId } from "./utils/append-id.mjs";
 
-export { appendId, clsx, defineCSSProperties, getAttribute, getCSSVariableValue, getDataAttribute, getPrefersColorScheme, getRemToPxScale, observeAttributes, observeDataAttributes, observePrefersColorScheme, px2num, px2rem, rem2px, resolveChildren, resolveClassName, resolveStyle, toDomStyle };
+export { appendId, clsx, convertCssUnit, createCssUnitConverter, defineCSSProperties, getAttribute, getCSSVariableValue, getCssUnit, getDataAttribute, getPrefersColorScheme, getRemToPxScale, isEffectivelyZero, observeAttributes, observeDataAttributes, observePrefersColorScheme, parseCssNumber, parseCssValue, parseCssNumber as px2num, px2rem, rem2px, resolveChildren, resolveClassName, resolveStyle, toDomStyle };

package/dist/style/css-properties.d.cts

@@ -12,7 +12,8 @@ interface CustomProperties {
  * Widens CSS properties to support custom properties.
  * Allows for string or number values for standard properties,
  * and string values for custom properties with '--' prefix.
- * Defined as a union so plain Properties (e.g. from React) are assignable.
+ *
+ * Note that `React.CSSProperties` (using `csstype`) is augmented so you can use it directly without this type.
  */
 interface CSSProperties<TLength = string | number, TTime = string & {}> extends Properties<TLength, TTime>, CustomProperties {}
 //#endregion

package/dist/style/css-properties.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"css-properties.d.cts","names":[],"sources":["../../src/style/css-properties.ts"],"sourcesContent":[],"mappings":";;;;iFAGgF,kBAHvC;;;UAO/B,gBAAA,CAJsF;EAAA,CAAA,CAAA,EAAA,KAAA,MAAA,EAAA,CAAA,EAAA,MAAA;AAAA;AAchG;;;;;;UAAiB,sEACR,WAAW,SAAS,QAC3B"}
+{"version":3,"file":"css-properties.d.cts","names":[],"sources":["../../src/style/css-properties.ts"],"sourcesContent":[],"mappings":";;;;iFAIgF,kBAJvC;;;UAQ/B,gBAAA,CAJsF;EAAA,CAAA,CAAA,EAAA,KAAA,MAAA,EAAA,CAAA,EAAA,MAAA;AAAA;AAehG;;;;;;;UAAiB,sEACR,WAAW,SAAS,QAC3B"}

package/dist/style/css-properties.d.mts

@@ -12,7 +12,8 @@ interface CustomProperties {
  * Widens CSS properties to support custom properties.
  * Allows for string or number values for standard properties,
  * and string values for custom properties with '--' prefix.
- * Defined as a union so plain Properties (e.g. from React) are assignable.
+ *
+ * Note that `React.CSSProperties` (using `csstype`) is augmented so you can use it directly without this type.
  */
 interface CSSProperties<TLength = string | number, TTime = string & {}> extends Properties<TLength, TTime>, CustomProperties {}
 //#endregion

package/dist/style/css-properties.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"css-properties.d.mts","names":[],"sources":["../../src/style/css-properties.ts"],"sourcesContent":[],"mappings":";;;;iFAGgF,kBAHvC;;;UAO/B,gBAAA,CAJsF;EAAA,CAAA,CAAA,EAAA,KAAA,MAAA,EAAA,CAAA,EAAA,MAAA;AAAA;AAchG;;;;;;UAAiB,sEACR,WAAW,SAAS,QAC3B"}
+{"version":3,"file":"css-properties.d.mts","names":[],"sources":["../../src/style/css-properties.ts"],"sourcesContent":[],"mappings":";;;;iFAIgF,kBAJvC;;;UAQ/B,gBAAA,CAJsF;EAAA,CAAA,CAAA,EAAA,KAAA,MAAA,EAAA,CAAA,EAAA,MAAA;AAAA;AAehG;;;;;;;UAAiB,sEACR,WAAW,SAAS,QAC3B"}

package/dist/units/convert-css-unit.cjs

@@ -0,0 +1,173 @@
+const require_get_rem_to_px_scale = require('./get-rem-to-px-scale.cjs');
+const require_parse_css_value = require('./parse-css-value.cjs');
+
+//#region src/units/convert-css-unit.ts
+const PX_PER_IN = 96;
+const PT_PER_IN = 72;
+const PC_PER_IN = 6;
+const CM_PER_IN = 2.54;
+const MM_PER_IN = 25.4;
+const DEFAULT_ELEMENT_FONT_SIZE = 16;
+const DEFAULT_PRECISION = 4;
+const ABSOLUTE_UNITS = [
+	"px",
+	"pt",
+	"pc",
+	"in",
+	"cm",
+	"mm"
+];
+const LINE_UNITS = ["lh", "rlh"];
+/**
+* Converts a CSS length value from one unit to another.
+*
+* @param value - The value to convert. Can be a number or string (e.g. '16px', '1.5rem'). Pass-through for null/undefined.
+* @param toUnit - The target unit.
+* @param options - Conversion context. When omitted, uses browser auto-detect for rootFontSize and viewport when available.
+* @returns The converted numeric value, or null/undefined when input is null/undefined.
+* @throws When required context is missing (viewport, lineHeight, percentReference) or percentReference is 0 for % conversion.
+*
+* @example
+* ```ts
+* convertCssUnit('16px', 'rem')                    // 1
+* convertCssUnit('1rem', 'px')                      // 16
+* convertCssUnit('50%', 'px', { percentReference: 200 })  // 100
+* convertCssUnit('10vw', 'px', { viewportWidth: 375 })    // 37.5
+* ```
+*/
+function convertCssUnit(value, toUnit, options) {
+	const [num, parsedUnit] = require_parse_css_value.parseCssValue(value);
+	if (num === null || num === void 0) return num;
+	if (Number.isNaN(num)) throw new Error(`Invalid CSS value: ${value}`);
+	const fromUnit = options?.fromUnit ?? normalizeUnit(parsedUnit) ?? "px";
+	const resolved = resolveOptions(options);
+	if (fromUnit === toUnit) return Number(num.toFixed(resolved.precision));
+	let result;
+	if (fromUnit === "rem" && toUnit === "em") result = remToEmDirect(num, resolved);
+	else if (fromUnit === "em" && toUnit === "rem") result = emToRemDirect(num, resolved);
+	else result = pxToValue(valueToPx(num, fromUnit, resolved), toUnit, resolved);
+	return Number(result.toFixed(resolved.precision));
+}
+function normalizeUnit(unit) {
+	if (!unit) return void 0;
+	const u = unit.toLowerCase();
+	if (u === "px" || u === "pt" || u === "pc" || u === "in" || u === "cm" || u === "mm" || u === "rem" || u === "em" || u === "vw" || u === "vh" || u === "vmin" || u === "vmax" || u === "lh" || u === "rlh" || u === "ch" || u === "%") return u;
+}
+function resolveOptions(options) {
+	const rootFontSize = options?.rootFontSize ?? require_get_rem_to_px_scale.getRemToPxScale();
+	const elementFontSize = options?.elementFontSize ?? DEFAULT_ELEMENT_FONT_SIZE;
+	const precision = options?.precision ?? DEFAULT_PRECISION;
+	let viewportWidth = options?.viewportWidth;
+	let viewportHeight = options?.viewportHeight;
+	if (typeof window !== "undefined") {
+		viewportWidth ??= window.innerWidth;
+		viewportHeight ??= window.innerHeight;
+	}
+	const lineHeight = options?.lineHeight;
+	const chWidth = options?.chWidth ?? elementFontSize * .5;
+	const percentReference = options?.percentReference ?? 0;
+	return {
+		rootFontSize,
+		elementFontSize,
+		viewportWidth: viewportWidth ?? 0,
+		viewportHeight: viewportHeight ?? 0,
+		lineHeight: lineHeight ?? 0,
+		chWidth,
+		percentReference,
+		precision
+	};
+}
+function remToEmDirect(value, resolved) {
+	return value * (resolved.rootFontSize / resolved.elementFontSize);
+}
+function emToRemDirect(value, resolved) {
+	return value * (resolved.elementFontSize / resolved.rootFontSize);
+}
+function valueToPx(value, fromUnit, resolved) {
+	if (ABSOLUTE_UNITS.includes(fromUnit)) return toPxFromAbsolute(value, fromUnit);
+	if (fromUnit === "rem") return value * (resolved.rootFontSize ?? 0);
+	if (fromUnit === "em") return value * (resolved.elementFontSize ?? 0);
+	if (fromUnit === "vw") {
+		if (resolved.viewportWidth === 0) throw new Error("viewportWidth is required for vw conversion");
+		return value / 100 * resolved.viewportWidth;
+	}
+	if (fromUnit === "vh") {
+		if (resolved.viewportHeight === 0) throw new Error("viewportHeight is required for vh conversion");
+		return value / 100 * resolved.viewportHeight;
+	}
+	if (fromUnit === "vmin") {
+		if (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) throw new Error("viewportWidth and viewportHeight are required for vmin conversion");
+		return value / 100 * Math.min(resolved.viewportWidth, resolved.viewportHeight);
+	}
+	if (fromUnit === "vmax") {
+		if (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) throw new Error("viewportWidth and viewportHeight are required for vmax conversion");
+		return value / 100 * Math.max(resolved.viewportWidth, resolved.viewportHeight);
+	}
+	if (LINE_UNITS.includes(fromUnit)) {
+		if (resolved.lineHeight === 0) throw new Error("lineHeight is required for lh/rlh conversion");
+		return value * resolved.lineHeight;
+	}
+	if (fromUnit === "ch") return value * resolved.chWidth;
+	if (fromUnit === "%") {
+		if (resolved.percentReference === 0) throw new Error("percentReference is required for % conversion");
+		return value / 100 * resolved.percentReference;
+	}
+	throw new Error(`Unsupported unit: ${fromUnit}`);
+}
+function pxToValue(px, toUnit, resolved) {
+	if (ABSOLUTE_UNITS.includes(toUnit)) return fromPxToAbsolute(px, toUnit);
+	if (toUnit === "rem") return px / resolved.rootFontSize;
+	if (toUnit === "em") return px / resolved.elementFontSize;
+	if (toUnit === "vw") {
+		if (resolved.viewportWidth === 0) throw new Error("viewportWidth is required for vw conversion");
+		return px / resolved.viewportWidth * 100;
+	}
+	if (toUnit === "vh") {
+		if (resolved.viewportHeight === 0) throw new Error("viewportHeight is required for vh conversion");
+		return px / resolved.viewportHeight * 100;
+	}
+	if (toUnit === "vmin") {
+		if (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) throw new Error("viewportWidth and viewportHeight are required for vmin conversion");
+		return px / Math.min(resolved.viewportWidth, resolved.viewportHeight) * 100;
+	}
+	if (toUnit === "vmax") {
+		if (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) throw new Error("viewportWidth and viewportHeight are required for vmax conversion");
+		return px / Math.max(resolved.viewportWidth, resolved.viewportHeight) * 100;
+	}
+	if (LINE_UNITS.includes(toUnit)) {
+		if (resolved.lineHeight === 0) throw new Error("lineHeight is required for lh/rlh conversion");
+		return px / resolved.lineHeight;
+	}
+	if (toUnit === "ch") return px / resolved.chWidth;
+	if (toUnit === "%") {
+		if (resolved.percentReference === 0) throw new Error("percentReference is required and must be non-zero for conversion to %");
+		return px / resolved.percentReference * 100;
+	}
+	throw new Error(`Unsupported unit: ${toUnit}`);
+}
+function toPxFromAbsolute(value, unit) {
+	switch (unit) {
+		case "px": return value;
+		case "pt": return value * PX_PER_IN / PT_PER_IN;
+		case "pc": return value * PX_PER_IN / PC_PER_IN;
+		case "in": return value * PX_PER_IN;
+		case "cm": return value * PX_PER_IN / CM_PER_IN;
+		case "mm": return value * PX_PER_IN / MM_PER_IN;
+		default: return value;
+	}
+}
+function fromPxToAbsolute(px, unit) {
+	switch (unit) {
+		case "px": return px;
+		case "pt": return px * PT_PER_IN / PX_PER_IN;
+		case "pc": return px * PC_PER_IN / PX_PER_IN;
+		case "in": return px / PX_PER_IN;
+		case "cm": return px * CM_PER_IN / PX_PER_IN;
+		case "mm": return px * MM_PER_IN / PX_PER_IN;
+		default: return px;
+	}
+}
+
+//#endregion
+exports.convertCssUnit = convertCssUnit;
+//# sourceMappingURL=convert-css-unit.cjs.map

package/dist/units/convert-css-unit.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-css-unit.cjs","names":["ABSOLUTE_UNITS: CssLengthUnit[]","LINE_UNITS: CssLengthUnit[]","parseCssValue","fromUnit: CssLengthUnit","result: number","getRemToPxScale"],"sources":["../../src/units/convert-css-unit.ts"],"sourcesContent":["import type { Required } from 'type-plus'\nimport type { ConvertCssUnitOptions, CssLengthUnit } from './css-unit-converter.types.ts'\nimport { getRemToPxScale } from './get-rem-to-px-scale.ts'\nimport { parseCssValue } from './parse-css-value.ts'\n\nconst PX_PER_IN = 96\nconst PT_PER_IN = 72\nconst PC_PER_IN = 6\nconst CM_PER_IN = 2.54\nconst MM_PER_IN = 25.4\n\nconst DEFAULT_ELEMENT_FONT_SIZE = 16\nconst DEFAULT_PRECISION = 4\n\nconst ABSOLUTE_UNITS: CssLengthUnit[] = ['px', 'pt', 'pc', 'in', 'cm', 'mm']\nconst LINE_UNITS: CssLengthUnit[] = ['lh', 'rlh']\n\n/**\n * Converts a CSS length value from one unit to another.\n *\n * @param value - The value to convert. Can be a number or string (e.g. '16px', '1.5rem'). Pass-through for null/undefined.\n * @param toUnit - The target unit.\n * @param options - Conversion context. When omitted, uses browser auto-detect for rootFontSize and viewport when available.\n * @returns The converted numeric value, or null/undefined when input is null/undefined.\n * @throws When required context is missing (viewport, lineHeight, percentReference) or percentReference is 0 for % conversion.\n *\n * @example\n * ```ts\n * convertCssUnit('16px', 'rem')                    // 1\n * convertCssUnit('1rem', 'px')                      // 16\n * convertCssUnit('50%', 'px', { percentReference: 200 })  // 100\n * convertCssUnit('10vw', 'px', { viewportWidth: 375 })    // 37.5\n * ```\n */\nexport function convertCssUnit(\n\tvalue: number | string | null | undefined,\n\ttoUnit: CssLengthUnit,\n\toptions?: ConvertCssUnitOptions | undefined\n): number | null | undefined {\n\tconst [num, parsedUnit] = parseCssValue(value)\n\tif (num === null || num === undefined) return num\n\tif (Number.isNaN(num)) {\n\t\tthrow new Error(`Invalid CSS value: ${value}`)\n\t}\n\n\tconst fromUnit: CssLengthUnit = options?.fromUnit ?? normalizeUnit(parsedUnit) ?? 'px'\n\n\tconst resolved = resolveOptions(options)\n\n\tif (fromUnit === toUnit) {\n\t\treturn Number(num.toFixed(resolved.precision))\n\t}\n\n\tlet result: number\n\n\tif (fromUnit === 'rem' && toUnit === 'em') {\n\t\tresult = remToEmDirect(num, resolved)\n\t} else if (fromUnit === 'em' && toUnit === 'rem') {\n\t\tresult = emToRemDirect(num, resolved)\n\t} else {\n\t\tconst px = valueToPx(num, fromUnit, resolved)\n\t\tresult = pxToValue(px, toUnit, resolved)\n\t}\n\n\treturn Number(result.toFixed(resolved.precision))\n}\n\nfunction normalizeUnit(unit: string | undefined): CssLengthUnit | undefined {\n\tif (!unit) return undefined\n\tconst u = unit.toLowerCase()\n\tif (\n\t\tu === 'px' ||\n\t\tu === 'pt' ||\n\t\tu === 'pc' ||\n\t\tu === 'in' ||\n\t\tu === 'cm' ||\n\t\tu === 'mm' ||\n\t\tu === 'rem' ||\n\t\tu === 'em' ||\n\t\tu === 'vw' ||\n\t\tu === 'vh' ||\n\t\tu === 'vmin' ||\n\t\tu === 'vmax' ||\n\t\tu === 'lh' ||\n\t\tu === 'rlh' ||\n\t\tu === 'ch' ||\n\t\tu === '%'\n\t) {\n\t\treturn u as CssLengthUnit\n\t}\n\treturn undefined\n}\n\nfunction resolveOptions(\n\toptions?: ConvertCssUnitOptions | undefined\n): Required<\n\tPick<\n\t\tConvertCssUnitOptions,\n\t\t| 'rootFontSize'\n\t\t| 'elementFontSize'\n\t\t| 'viewportWidth'\n\t\t| 'viewportHeight'\n\t\t| 'lineHeight'\n\t\t| 'chWidth'\n\t\t| 'percentReference'\n\t\t| 'precision'\n\t>\n> {\n\tconst rootFontSize = options?.rootFontSize ?? getRemToPxScale()\n\tconst elementFontSize = options?.elementFontSize ?? DEFAULT_ELEMENT_FONT_SIZE\n\tconst precision = options?.precision ?? DEFAULT_PRECISION\n\n\tlet viewportWidth = options?.viewportWidth\n\tlet viewportHeight = options?.viewportHeight\n\tif (typeof window !== 'undefined') {\n\t\tviewportWidth ??= window.innerWidth\n\t\tviewportHeight ??= window.innerHeight\n\t}\n\n\tconst lineHeight = options?.lineHeight\n\tconst chWidth = options?.chWidth ?? elementFontSize * 0.5\n\tconst percentReference = options?.percentReference ?? 0\n\n\treturn {\n\t\trootFontSize,\n\t\telementFontSize,\n\t\tviewportWidth: viewportWidth ?? 0,\n\t\tviewportHeight: viewportHeight ?? 0,\n\t\tlineHeight: lineHeight ?? 0,\n\t\tchWidth,\n\t\tpercentReference,\n\t\tprecision\n\t}\n}\n\nfunction remToEmDirect(value: number, resolved: ReturnType<typeof resolveOptions>): number {\n\treturn value * (resolved.rootFontSize / resolved.elementFontSize)\n}\n\nfunction emToRemDirect(value: number, resolved: ReturnType<typeof resolveOptions>): number {\n\treturn value * (resolved.elementFontSize / resolved.rootFontSize)\n}\n\nfunction valueToPx(\n\tvalue: number,\n\tfromUnit: CssLengthUnit,\n\tresolved: ReturnType<typeof resolveOptions>\n): number {\n\tif (ABSOLUTE_UNITS.includes(fromUnit)) {\n\t\treturn toPxFromAbsolute(value, fromUnit)\n\t}\n\tif (fromUnit === 'rem') {\n\t\treturn value * (resolved.rootFontSize ?? 0)\n\t}\n\tif (fromUnit === 'em') {\n\t\treturn value * (resolved.elementFontSize ?? 0)\n\t}\n\tif (fromUnit === 'vw') {\n\t\tif (resolved.viewportWidth === 0) {\n\t\t\tthrow new Error('viewportWidth is required for vw conversion')\n\t\t}\n\t\treturn (value / 100) * resolved.viewportWidth\n\t}\n\tif (fromUnit === 'vh') {\n\t\tif (resolved.viewportHeight === 0) {\n\t\t\tthrow new Error('viewportHeight is required for vh conversion')\n\t\t}\n\t\treturn (value / 100) * resolved.viewportHeight\n\t}\n\tif (fromUnit === 'vmin') {\n\t\tif (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) {\n\t\t\tthrow new Error('viewportWidth and viewportHeight are required for vmin conversion')\n\t\t}\n\t\treturn (value / 100) * Math.min(resolved.viewportWidth, resolved.viewportHeight)\n\t}\n\tif (fromUnit === 'vmax') {\n\t\tif (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) {\n\t\t\tthrow new Error('viewportWidth and viewportHeight are required for vmax conversion')\n\t\t}\n\t\treturn (value / 100) * Math.max(resolved.viewportWidth, resolved.viewportHeight)\n\t}\n\tif (LINE_UNITS.includes(fromUnit)) {\n\t\tif (resolved.lineHeight === 0) {\n\t\t\tthrow new Error('lineHeight is required for lh/rlh conversion')\n\t\t}\n\t\treturn value * resolved.lineHeight\n\t}\n\tif (fromUnit === 'ch') {\n\t\treturn value * resolved.chWidth\n\t}\n\tif (fromUnit === '%') {\n\t\tif (resolved.percentReference === 0) {\n\t\t\tthrow new Error('percentReference is required for % conversion')\n\t\t}\n\t\treturn (value / 100) * resolved.percentReference\n\t}\n\tthrow new Error(`Unsupported unit: ${fromUnit}`)\n}\n\nfunction pxToValue(\n\tpx: number,\n\ttoUnit: CssLengthUnit,\n\tresolved: ReturnType<typeof resolveOptions>\n): number {\n\tif (ABSOLUTE_UNITS.includes(toUnit)) {\n\t\treturn fromPxToAbsolute(px, toUnit)\n\t}\n\tif (toUnit === 'rem') {\n\t\treturn px / resolved.rootFontSize\n\t}\n\tif (toUnit === 'em') {\n\t\treturn px / resolved.elementFontSize\n\t}\n\tif (toUnit === 'vw') {\n\t\tif (resolved.viewportWidth === 0) {\n\t\t\tthrow new Error('viewportWidth is required for vw conversion')\n\t\t}\n\t\treturn (px / resolved.viewportWidth) * 100\n\t}\n\tif (toUnit === 'vh') {\n\t\tif (resolved.viewportHeight === 0) {\n\t\t\tthrow new Error('viewportHeight is required for vh conversion')\n\t\t}\n\t\treturn (px / resolved.viewportHeight) * 100\n\t}\n\tif (toUnit === 'vmin') {\n\t\tif (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) {\n\t\t\tthrow new Error('viewportWidth and viewportHeight are required for vmin conversion')\n\t\t}\n\t\treturn (px / Math.min(resolved.viewportWidth, resolved.viewportHeight)) * 100\n\t}\n\tif (toUnit === 'vmax') {\n\t\tif (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) {\n\t\t\tthrow new Error('viewportWidth and viewportHeight are required for vmax conversion')\n\t\t}\n\t\treturn (px / Math.max(resolved.viewportWidth, resolved.viewportHeight)) * 100\n\t}\n\tif (LINE_UNITS.includes(toUnit)) {\n\t\tif (resolved.lineHeight === 0) {\n\t\t\tthrow new Error('lineHeight is required for lh/rlh conversion')\n\t\t}\n\t\treturn px / resolved.lineHeight\n\t}\n\tif (toUnit === 'ch') {\n\t\treturn px / resolved.chWidth\n\t}\n\tif (toUnit === '%') {\n\t\tif (resolved.percentReference === 0) {\n\t\t\tthrow new Error('percentReference is required and must be non-zero for conversion to %')\n\t\t}\n\t\treturn (px / resolved.percentReference) * 100\n\t}\n\tthrow new Error(`Unsupported unit: ${toUnit}`)\n}\n\nfunction toPxFromAbsolute(value: number, unit: CssLengthUnit): number {\n\tswitch (unit) {\n\t\tcase 'px':\n\t\t\treturn value\n\t\tcase 'pt':\n\t\t\treturn (value * PX_PER_IN) / PT_PER_IN\n\t\tcase 'pc':\n\t\t\treturn (value * PX_PER_IN) / PC_PER_IN\n\t\tcase 'in':\n\t\t\treturn value * PX_PER_IN\n\t\tcase 'cm':\n\t\t\treturn (value * PX_PER_IN) / CM_PER_IN\n\t\tcase 'mm':\n\t\t\treturn (value * PX_PER_IN) / MM_PER_IN\n\t\tdefault:\n\t\t\treturn value\n\t}\n}\n\nfunction fromPxToAbsolute(px: number, unit: CssLengthUnit): number {\n\tswitch (unit) {\n\t\tcase 'px':\n\t\t\treturn px\n\t\tcase 'pt':\n\t\t\treturn (px * PT_PER_IN) / PX_PER_IN\n\t\tcase 'pc':\n\t\t\treturn (px * PC_PER_IN) / PX_PER_IN\n\t\tcase 'in':\n\t\t\treturn px / PX_PER_IN\n\t\tcase 'cm':\n\t\t\treturn (px * CM_PER_IN) / PX_PER_IN\n\t\tcase 'mm':\n\t\t\treturn (px * MM_PER_IN) / PX_PER_IN\n\t\tdefault:\n\t\t\treturn px\n\t}\n}\n"],"mappings":"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"}

package/dist/units/convert-css-unit.d.cts

@@ -0,0 +1,25 @@
+import { ConvertCssUnitOptions, CssLengthUnit } from "./css-unit-converter.types.cjs";
+
+//#region src/units/convert-css-unit.d.ts
+
+/**
+ * Converts a CSS length value from one unit to another.
+ *
+ * @param value - The value to convert. Can be a number or string (e.g. '16px', '1.5rem'). Pass-through for null/undefined.
+ * @param toUnit - The target unit.
+ * @param options - Conversion context. When omitted, uses browser auto-detect for rootFontSize and viewport when available.
+ * @returns The converted numeric value, or null/undefined when input is null/undefined.
+ * @throws When required context is missing (viewport, lineHeight, percentReference) or percentReference is 0 for % conversion.
+ *
+ * @example
+ * ```ts
+ * convertCssUnit('16px', 'rem')                    // 1
+ * convertCssUnit('1rem', 'px')                      // 16
+ * convertCssUnit('50%', 'px', { percentReference: 200 })  // 100
+ * convertCssUnit('10vw', 'px', { viewportWidth: 375 })    // 37.5
+ * ```
+ */
+declare function convertCssUnit(value: number | string | null | undefined, toUnit: CssLengthUnit, options?: ConvertCssUnitOptions | undefined): number | null | undefined;
+//#endregion
+export { convertCssUnit };
+//# sourceMappingURL=convert-css-unit.d.cts.map

package/dist/units/convert-css-unit.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-css-unit.d.cts","names":[],"sources":["../../src/units/convert-css-unit.ts"],"sourcesContent":[],"mappings":";;;;;;AAkCA;;;;;;;;;;;;;;;iBAAgB,cAAA,oDAEP,yBACE"}

package/dist/units/convert-css-unit.d.mts

@@ -0,0 +1,25 @@
+import { ConvertCssUnitOptions, CssLengthUnit } from "./css-unit-converter.types.mjs";
+
+//#region src/units/convert-css-unit.d.ts
+
+/**
+ * Converts a CSS length value from one unit to another.
+ *
+ * @param value - The value to convert. Can be a number or string (e.g. '16px', '1.5rem'). Pass-through for null/undefined.
+ * @param toUnit - The target unit.
+ * @param options - Conversion context. When omitted, uses browser auto-detect for rootFontSize and viewport when available.
+ * @returns The converted numeric value, or null/undefined when input is null/undefined.
+ * @throws When required context is missing (viewport, lineHeight, percentReference) or percentReference is 0 for % conversion.
+ *
+ * @example
+ * ```ts
+ * convertCssUnit('16px', 'rem')                    // 1
+ * convertCssUnit('1rem', 'px')                      // 16
+ * convertCssUnit('50%', 'px', { percentReference: 200 })  // 100
+ * convertCssUnit('10vw', 'px', { viewportWidth: 375 })    // 37.5
+ * ```
+ */
+declare function convertCssUnit(value: number | string | null | undefined, toUnit: CssLengthUnit, options?: ConvertCssUnitOptions | undefined): number | null | undefined;
+//#endregion
+export { convertCssUnit };
+//# sourceMappingURL=convert-css-unit.d.mts.map

package/dist/units/convert-css-unit.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-css-unit.d.mts","names":[],"sources":["../../src/units/convert-css-unit.ts"],"sourcesContent":[],"mappings":";;;;;;AAkCA;;;;;;;;;;;;;;;iBAAgB,cAAA,oDAEP,yBACE"}

package/dist/units/convert-css-unit.mjs

@@ -0,0 +1,173 @@
+import { getRemToPxScale } from "./get-rem-to-px-scale.mjs";
+import { parseCssValue } from "./parse-css-value.mjs";
+
+//#region src/units/convert-css-unit.ts
+const PX_PER_IN = 96;
+const PT_PER_IN = 72;
+const PC_PER_IN = 6;
+const CM_PER_IN = 2.54;
+const MM_PER_IN = 25.4;
+const DEFAULT_ELEMENT_FONT_SIZE = 16;
+const DEFAULT_PRECISION = 4;
+const ABSOLUTE_UNITS = [
+	"px",
+	"pt",
+	"pc",
+	"in",
+	"cm",
+	"mm"
+];
+const LINE_UNITS = ["lh", "rlh"];
+/**
+* Converts a CSS length value from one unit to another.
+*
+* @param value - The value to convert. Can be a number or string (e.g. '16px', '1.5rem'). Pass-through for null/undefined.
+* @param toUnit - The target unit.
+* @param options - Conversion context. When omitted, uses browser auto-detect for rootFontSize and viewport when available.
+* @returns The converted numeric value, or null/undefined when input is null/undefined.
+* @throws When required context is missing (viewport, lineHeight, percentReference) or percentReference is 0 for % conversion.
+*
+* @example
+* ```ts
+* convertCssUnit('16px', 'rem')                    // 1
+* convertCssUnit('1rem', 'px')                      // 16
+* convertCssUnit('50%', 'px', { percentReference: 200 })  // 100
+* convertCssUnit('10vw', 'px', { viewportWidth: 375 })    // 37.5
+* ```
+*/
+function convertCssUnit(value, toUnit, options) {
+	const [num, parsedUnit] = parseCssValue(value);
+	if (num === null || num === void 0) return num;
+	if (Number.isNaN(num)) throw new Error(`Invalid CSS value: ${value}`);
+	const fromUnit = options?.fromUnit ?? normalizeUnit(parsedUnit) ?? "px";
+	const resolved = resolveOptions(options);
+	if (fromUnit === toUnit) return Number(num.toFixed(resolved.precision));
+	let result;
+	if (fromUnit === "rem" && toUnit === "em") result = remToEmDirect(num, resolved);
+	else if (fromUnit === "em" && toUnit === "rem") result = emToRemDirect(num, resolved);
+	else result = pxToValue(valueToPx(num, fromUnit, resolved), toUnit, resolved);
+	return Number(result.toFixed(resolved.precision));
+}
+function normalizeUnit(unit) {
+	if (!unit) return void 0;
+	const u = unit.toLowerCase();
+	if (u === "px" || u === "pt" || u === "pc" || u === "in" || u === "cm" || u === "mm" || u === "rem" || u === "em" || u === "vw" || u === "vh" || u === "vmin" || u === "vmax" || u === "lh" || u === "rlh" || u === "ch" || u === "%") return u;
+}
+function resolveOptions(options) {
+	const rootFontSize = options?.rootFontSize ?? getRemToPxScale();
+	const elementFontSize = options?.elementFontSize ?? DEFAULT_ELEMENT_FONT_SIZE;
+	const precision = options?.precision ?? DEFAULT_PRECISION;
+	let viewportWidth = options?.viewportWidth;
+	let viewportHeight = options?.viewportHeight;
+	if (typeof window !== "undefined") {
+		viewportWidth ??= window.innerWidth;
+		viewportHeight ??= window.innerHeight;
+	}
+	const lineHeight = options?.lineHeight;
+	const chWidth = options?.chWidth ?? elementFontSize * .5;
+	const percentReference = options?.percentReference ?? 0;
+	return {
+		rootFontSize,
+		elementFontSize,
+		viewportWidth: viewportWidth ?? 0,
+		viewportHeight: viewportHeight ?? 0,
+		lineHeight: lineHeight ?? 0,
+		chWidth,
+		percentReference,
+		precision
+	};
+}
+function remToEmDirect(value, resolved) {
+	return value * (resolved.rootFontSize / resolved.elementFontSize);
+}
+function emToRemDirect(value, resolved) {
+	return value * (resolved.elementFontSize / resolved.rootFontSize);
+}
+function valueToPx(value, fromUnit, resolved) {
+	if (ABSOLUTE_UNITS.includes(fromUnit)) return toPxFromAbsolute(value, fromUnit);
+	if (fromUnit === "rem") return value * (resolved.rootFontSize ?? 0);
+	if (fromUnit === "em") return value * (resolved.elementFontSize ?? 0);
+	if (fromUnit === "vw") {
+		if (resolved.viewportWidth === 0) throw new Error("viewportWidth is required for vw conversion");
+		return value / 100 * resolved.viewportWidth;
+	}
+	if (fromUnit === "vh") {
+		if (resolved.viewportHeight === 0) throw new Error("viewportHeight is required for vh conversion");
+		return value / 100 * resolved.viewportHeight;
+	}
+	if (fromUnit === "vmin") {
+		if (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) throw new Error("viewportWidth and viewportHeight are required for vmin conversion");
+		return value / 100 * Math.min(resolved.viewportWidth, resolved.viewportHeight);
+	}
+	if (fromUnit === "vmax") {
+		if (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) throw new Error("viewportWidth and viewportHeight are required for vmax conversion");
+		return value / 100 * Math.max(resolved.viewportWidth, resolved.viewportHeight);
+	}
+	if (LINE_UNITS.includes(fromUnit)) {
+		if (resolved.lineHeight === 0) throw new Error("lineHeight is required for lh/rlh conversion");
+		return value * resolved.lineHeight;
+	}
+	if (fromUnit === "ch") return value * resolved.chWidth;
+	if (fromUnit === "%") {
+		if (resolved.percentReference === 0) throw new Error("percentReference is required for % conversion");
+		return value / 100 * resolved.percentReference;
+	}
+	throw new Error(`Unsupported unit: ${fromUnit}`);
+}
+function pxToValue(px, toUnit, resolved) {
+	if (ABSOLUTE_UNITS.includes(toUnit)) return fromPxToAbsolute(px, toUnit);
+	if (toUnit === "rem") return px / resolved.rootFontSize;
+	if (toUnit === "em") return px / resolved.elementFontSize;
+	if (toUnit === "vw") {
+		if (resolved.viewportWidth === 0) throw new Error("viewportWidth is required for vw conversion");
+		return px / resolved.viewportWidth * 100;
+	}
+	if (toUnit === "vh") {
+		if (resolved.viewportHeight === 0) throw new Error("viewportHeight is required for vh conversion");
+		return px / resolved.viewportHeight * 100;
+	}
+	if (toUnit === "vmin") {
+		if (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) throw new Error("viewportWidth and viewportHeight are required for vmin conversion");
+		return px / Math.min(resolved.viewportWidth, resolved.viewportHeight) * 100;
+	}
+	if (toUnit === "vmax") {
+		if (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) throw new Error("viewportWidth and viewportHeight are required for vmax conversion");
+		return px / Math.max(resolved.viewportWidth, resolved.viewportHeight) * 100;
+	}
+	if (LINE_UNITS.includes(toUnit)) {
+		if (resolved.lineHeight === 0) throw new Error("lineHeight is required for lh/rlh conversion");
+		return px / resolved.lineHeight;
+	}
+	if (toUnit === "ch") return px / resolved.chWidth;
+	if (toUnit === "%") {
+		if (resolved.percentReference === 0) throw new Error("percentReference is required and must be non-zero for conversion to %");
+		return px / resolved.percentReference * 100;
+	}
+	throw new Error(`Unsupported unit: ${toUnit}`);
+}
+function toPxFromAbsolute(value, unit) {
+	switch (unit) {
+		case "px": return value;
+		case "pt": return value * PX_PER_IN / PT_PER_IN;
+		case "pc": return value * PX_PER_IN / PC_PER_IN;
+		case "in": return value * PX_PER_IN;
+		case "cm": return value * PX_PER_IN / CM_PER_IN;
+		case "mm": return value * PX_PER_IN / MM_PER_IN;
+		default: return value;
+	}
+}
+function fromPxToAbsolute(px, unit) {
+	switch (unit) {
+		case "px": return px;
+		case "pt": return px * PT_PER_IN / PX_PER_IN;
+		case "pc": return px * PC_PER_IN / PX_PER_IN;
+		case "in": return px / PX_PER_IN;
+		case "cm": return px * CM_PER_IN / PX_PER_IN;
+		case "mm": return px * MM_PER_IN / PX_PER_IN;
+		default: return px;
+	}
+}
+
+//#endregion
+export { convertCssUnit };
+//# sourceMappingURL=convert-css-unit.mjs.map

package/dist/units/convert-css-unit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-css-unit.mjs","names":["ABSOLUTE_UNITS: CssLengthUnit[]","LINE_UNITS: CssLengthUnit[]","fromUnit: CssLengthUnit","result: number"],"sources":["../../src/units/convert-css-unit.ts"],"sourcesContent":["import type { Required } from 'type-plus'\nimport type { ConvertCssUnitOptions, CssLengthUnit } from './css-unit-converter.types.ts'\nimport { getRemToPxScale } from './get-rem-to-px-scale.ts'\nimport { parseCssValue } from './parse-css-value.ts'\n\nconst PX_PER_IN = 96\nconst PT_PER_IN = 72\nconst PC_PER_IN = 6\nconst CM_PER_IN = 2.54\nconst MM_PER_IN = 25.4\n\nconst DEFAULT_ELEMENT_FONT_SIZE = 16\nconst DEFAULT_PRECISION = 4\n\nconst ABSOLUTE_UNITS: CssLengthUnit[] = ['px', 'pt', 'pc', 'in', 'cm', 'mm']\nconst LINE_UNITS: CssLengthUnit[] = ['lh', 'rlh']\n\n/**\n * Converts a CSS length value from one unit to another.\n *\n * @param value - The value to convert. Can be a number or string (e.g. '16px', '1.5rem'). Pass-through for null/undefined.\n * @param toUnit - The target unit.\n * @param options - Conversion context. When omitted, uses browser auto-detect for rootFontSize and viewport when available.\n * @returns The converted numeric value, or null/undefined when input is null/undefined.\n * @throws When required context is missing (viewport, lineHeight, percentReference) or percentReference is 0 for % conversion.\n *\n * @example\n * ```ts\n * convertCssUnit('16px', 'rem')                    // 1\n * convertCssUnit('1rem', 'px')                      // 16\n * convertCssUnit('50%', 'px', { percentReference: 200 })  // 100\n * convertCssUnit('10vw', 'px', { viewportWidth: 375 })    // 37.5\n * ```\n */\nexport function convertCssUnit(\n\tvalue: number | string | null | undefined,\n\ttoUnit: CssLengthUnit,\n\toptions?: ConvertCssUnitOptions | undefined\n): number | null | undefined {\n\tconst [num, parsedUnit] = parseCssValue(value)\n\tif (num === null || num === undefined) return num\n\tif (Number.isNaN(num)) {\n\t\tthrow new Error(`Invalid CSS value: ${value}`)\n\t}\n\n\tconst fromUnit: CssLengthUnit = options?.fromUnit ?? normalizeUnit(parsedUnit) ?? 'px'\n\n\tconst resolved = resolveOptions(options)\n\n\tif (fromUnit === toUnit) {\n\t\treturn Number(num.toFixed(resolved.precision))\n\t}\n\n\tlet result: number\n\n\tif (fromUnit === 'rem' && toUnit === 'em') {\n\t\tresult = remToEmDirect(num, resolved)\n\t} else if (fromUnit === 'em' && toUnit === 'rem') {\n\t\tresult = emToRemDirect(num, resolved)\n\t} else {\n\t\tconst px = valueToPx(num, fromUnit, resolved)\n\t\tresult = pxToValue(px, toUnit, resolved)\n\t}\n\n\treturn Number(result.toFixed(resolved.precision))\n}\n\nfunction normalizeUnit(unit: string | undefined): CssLengthUnit | undefined {\n\tif (!unit) return undefined\n\tconst u = unit.toLowerCase()\n\tif (\n\t\tu === 'px' ||\n\t\tu === 'pt' ||\n\t\tu === 'pc' ||\n\t\tu === 'in' ||\n\t\tu === 'cm' ||\n\t\tu === 'mm' ||\n\t\tu === 'rem' ||\n\t\tu === 'em' ||\n\t\tu === 'vw' ||\n\t\tu === 'vh' ||\n\t\tu === 'vmin' ||\n\t\tu === 'vmax' ||\n\t\tu === 'lh' ||\n\t\tu === 'rlh' ||\n\t\tu === 'ch' ||\n\t\tu === '%'\n\t) {\n\t\treturn u as CssLengthUnit\n\t}\n\treturn undefined\n}\n\nfunction resolveOptions(\n\toptions?: ConvertCssUnitOptions | undefined\n): Required<\n\tPick<\n\t\tConvertCssUnitOptions,\n\t\t| 'rootFontSize'\n\t\t| 'elementFontSize'\n\t\t| 'viewportWidth'\n\t\t| 'viewportHeight'\n\t\t| 'lineHeight'\n\t\t| 'chWidth'\n\t\t| 'percentReference'\n\t\t| 'precision'\n\t>\n> {\n\tconst rootFontSize = options?.rootFontSize ?? getRemToPxScale()\n\tconst elementFontSize = options?.elementFontSize ?? DEFAULT_ELEMENT_FONT_SIZE\n\tconst precision = options?.precision ?? DEFAULT_PRECISION\n\n\tlet viewportWidth = options?.viewportWidth\n\tlet viewportHeight = options?.viewportHeight\n\tif (typeof window !== 'undefined') {\n\t\tviewportWidth ??= window.innerWidth\n\t\tviewportHeight ??= window.innerHeight\n\t}\n\n\tconst lineHeight = options?.lineHeight\n\tconst chWidth = options?.chWidth ?? elementFontSize * 0.5\n\tconst percentReference = options?.percentReference ?? 0\n\n\treturn {\n\t\trootFontSize,\n\t\telementFontSize,\n\t\tviewportWidth: viewportWidth ?? 0,\n\t\tviewportHeight: viewportHeight ?? 0,\n\t\tlineHeight: lineHeight ?? 0,\n\t\tchWidth,\n\t\tpercentReference,\n\t\tprecision\n\t}\n}\n\nfunction remToEmDirect(value: number, resolved: ReturnType<typeof resolveOptions>): number {\n\treturn value * (resolved.rootFontSize / resolved.elementFontSize)\n}\n\nfunction emToRemDirect(value: number, resolved: ReturnType<typeof resolveOptions>): number {\n\treturn value * (resolved.elementFontSize / resolved.rootFontSize)\n}\n\nfunction valueToPx(\n\tvalue: number,\n\tfromUnit: CssLengthUnit,\n\tresolved: ReturnType<typeof resolveOptions>\n): number {\n\tif (ABSOLUTE_UNITS.includes(fromUnit)) {\n\t\treturn toPxFromAbsolute(value, fromUnit)\n\t}\n\tif (fromUnit === 'rem') {\n\t\treturn value * (resolved.rootFontSize ?? 0)\n\t}\n\tif (fromUnit === 'em') {\n\t\treturn value * (resolved.elementFontSize ?? 0)\n\t}\n\tif (fromUnit === 'vw') {\n\t\tif (resolved.viewportWidth === 0) {\n\t\t\tthrow new Error('viewportWidth is required for vw conversion')\n\t\t}\n\t\treturn (value / 100) * resolved.viewportWidth\n\t}\n\tif (fromUnit === 'vh') {\n\t\tif (resolved.viewportHeight === 0) {\n\t\t\tthrow new Error('viewportHeight is required for vh conversion')\n\t\t}\n\t\treturn (value / 100) * resolved.viewportHeight\n\t}\n\tif (fromUnit === 'vmin') {\n\t\tif (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) {\n\t\t\tthrow new Error('viewportWidth and viewportHeight are required for vmin conversion')\n\t\t}\n\t\treturn (value / 100) * Math.min(resolved.viewportWidth, resolved.viewportHeight)\n\t}\n\tif (fromUnit === 'vmax') {\n\t\tif (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) {\n\t\t\tthrow new Error('viewportWidth and viewportHeight are required for vmax conversion')\n\t\t}\n\t\treturn (value / 100) * Math.max(resolved.viewportWidth, resolved.viewportHeight)\n\t}\n\tif (LINE_UNITS.includes(fromUnit)) {\n\t\tif (resolved.lineHeight === 0) {\n\t\t\tthrow new Error('lineHeight is required for lh/rlh conversion')\n\t\t}\n\t\treturn value * resolved.lineHeight\n\t}\n\tif (fromUnit === 'ch') {\n\t\treturn value * resolved.chWidth\n\t}\n\tif (fromUnit === '%') {\n\t\tif (resolved.percentReference === 0) {\n\t\t\tthrow new Error('percentReference is required for % conversion')\n\t\t}\n\t\treturn (value / 100) * resolved.percentReference\n\t}\n\tthrow new Error(`Unsupported unit: ${fromUnit}`)\n}\n\nfunction pxToValue(\n\tpx: number,\n\ttoUnit: CssLengthUnit,\n\tresolved: ReturnType<typeof resolveOptions>\n): number {\n\tif (ABSOLUTE_UNITS.includes(toUnit)) {\n\t\treturn fromPxToAbsolute(px, toUnit)\n\t}\n\tif (toUnit === 'rem') {\n\t\treturn px / resolved.rootFontSize\n\t}\n\tif (toUnit === 'em') {\n\t\treturn px / resolved.elementFontSize\n\t}\n\tif (toUnit === 'vw') {\n\t\tif (resolved.viewportWidth === 0) {\n\t\t\tthrow new Error('viewportWidth is required for vw conversion')\n\t\t}\n\t\treturn (px / resolved.viewportWidth) * 100\n\t}\n\tif (toUnit === 'vh') {\n\t\tif (resolved.viewportHeight === 0) {\n\t\t\tthrow new Error('viewportHeight is required for vh conversion')\n\t\t}\n\t\treturn (px / resolved.viewportHeight) * 100\n\t}\n\tif (toUnit === 'vmin') {\n\t\tif (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) {\n\t\t\tthrow new Error('viewportWidth and viewportHeight are required for vmin conversion')\n\t\t}\n\t\treturn (px / Math.min(resolved.viewportWidth, resolved.viewportHeight)) * 100\n\t}\n\tif (toUnit === 'vmax') {\n\t\tif (resolved.viewportWidth === 0 || resolved.viewportHeight === 0) {\n\t\t\tthrow new Error('viewportWidth and viewportHeight are required for vmax conversion')\n\t\t}\n\t\treturn (px / Math.max(resolved.viewportWidth, resolved.viewportHeight)) * 100\n\t}\n\tif (LINE_UNITS.includes(toUnit)) {\n\t\tif (resolved.lineHeight === 0) {\n\t\t\tthrow new Error('lineHeight is required for lh/rlh conversion')\n\t\t}\n\t\treturn px / resolved.lineHeight\n\t}\n\tif (toUnit === 'ch') {\n\t\treturn px / resolved.chWidth\n\t}\n\tif (toUnit === '%') {\n\t\tif (resolved.percentReference === 0) {\n\t\t\tthrow new Error('percentReference is required and must be non-zero for conversion to %')\n\t\t}\n\t\treturn (px / resolved.percentReference) * 100\n\t}\n\tthrow new Error(`Unsupported unit: ${toUnit}`)\n}\n\nfunction toPxFromAbsolute(value: number, unit: CssLengthUnit): number {\n\tswitch (unit) {\n\t\tcase 'px':\n\t\t\treturn value\n\t\tcase 'pt':\n\t\t\treturn (value * PX_PER_IN) / PT_PER_IN\n\t\tcase 'pc':\n\t\t\treturn (value * PX_PER_IN) / PC_PER_IN\n\t\tcase 'in':\n\t\t\treturn value * PX_PER_IN\n\t\tcase 'cm':\n\t\t\treturn (value * PX_PER_IN) / CM_PER_IN\n\t\tcase 'mm':\n\t\t\treturn (value * PX_PER_IN) / MM_PER_IN\n\t\tdefault:\n\t\t\treturn value\n\t}\n}\n\nfunction fromPxToAbsolute(px: number, unit: CssLengthUnit): number {\n\tswitch (unit) {\n\t\tcase 'px':\n\t\t\treturn px\n\t\tcase 'pt':\n\t\t\treturn (px * PT_PER_IN) / PX_PER_IN\n\t\tcase 'pc':\n\t\t\treturn (px * PC_PER_IN) / PX_PER_IN\n\t\tcase 'in':\n\t\t\treturn px / PX_PER_IN\n\t\tcase 'cm':\n\t\t\treturn (px * CM_PER_IN) / PX_PER_IN\n\t\tcase 'mm':\n\t\t\treturn (px * MM_PER_IN) / PX_PER_IN\n\t\tdefault:\n\t\t\treturn px\n\t}\n}\n"],"mappings":"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"}

package/dist/units/create-css-unit-converter.cjs

@@ -0,0 +1,33 @@
+const require_convert_css_unit = require('./convert-css-unit.cjs');
+
+//#region src/units/create-css-unit-converter.ts
+/**
+* Creates a pre-configured CSS unit converter with fixed context.
+*
+* @param context - Root font size, viewport, line height, etc. Omitted values use browser auto-detect when available.
+* @returns A converter function that accepts value and toUnit (and optional fromUnit override).
+*
+* @example
+* ```ts
+* const convert = createCssUnitConverter({
+*   rootFontSize: 16,
+*   viewportWidth: 375,
+*   viewportHeight: 812,
+* })
+* convert('1rem', 'px')   // 16
+* convert('10vw', 'px')   // 37.5
+* convert(16, 'rem', { fromUnit: 'px' })  // 1
+* ```
+*/
+function createCssUnitConverter(context) {
+	return function convert(value, toUnit, options) {
+		return require_convert_css_unit.convertCssUnit(value, toUnit, {
+			...context,
+			...options
+		});
+	};
+}
+
+//#endregion
+exports.createCssUnitConverter = createCssUnitConverter;
+//# sourceMappingURL=create-css-unit-converter.cjs.map