@just-web/toolkits 2.1.0 → 3.1.0

package/dist/theme/data-attribute/subscribe-data-attribute.cjs

@@ -17,10 +17,9 @@ function subscribeDataAttribute(themes, attributeName, handler, options) {
 	const element = options?.element ?? document?.documentElement;
 	if (!element) return () => {};
 	const parse = options?.parse ?? ((t, v) => require_parse_data_attribute.parseDataAttribute(t, v, { separator: require__constant.SEPARATOR_SPACE }));
-	const observer = require_observe_data_attribute.observeDataAttributes({ [attributeName]: (value) => {
+	return require_observe_data_attribute.observeDataAttributes({ [attributeName]: (value) => {
 		handler(parse(themes, value ?? void 0));
 	} }, element);
-	return () => observer.disconnect();
 }
 
 //#endregion

package/dist/theme/data-attribute/subscribe-data-attribute.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"subscribe-data-attribute.cjs","names":["parseDataAttribute","SEPARATOR_SPACE","observeDataAttributes"],"sources":["../../../src/theme/data-attribute/subscribe-data-attribute.ts"],"sourcesContent":["import { observeDataAttributes } from '../../attributes/observe-data-attribute.ts'\nimport type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\nimport { parseDataAttribute } from './parse-data-attribute.ts'\n\n/**\n * Subscribes to changes on a data attribute and invokes the handler with parsed theme entries.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param attributeName - Data attribute name (e.g. `data-theme`)\n * @param handler - Callback invoked when the attribute changes\n * @param options.element - Element to observe (accepts null e.g. from refs). Defaults to document.documentElement.\n * @param options.parse - Custom parser (default: parseDataAttribute with space separator)\n * @returns Unsubscribe function. Returns a no-op function when element is not available (e.g. SSR).\n */\nexport function subscribeDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\n\thandler: (entry: ThemeEntry<Themes> | undefined) => void,\n\toptions?:\n\t\t| { element?: Element | null | undefined; parse?: ParseStoredTheme<Themes> | undefined }\n\t\t| undefined\n): () => void {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return () => {}\n\tconst parse =\n\t\toptions?.parse ?? ((t, v) => parseDataAttribute(t, v, { separator: SEPARATOR_SPACE }))\n\tconst observer = observeDataAttributes<string, `data-${string}`>(\n\t\t{\n\t\t\t[attributeName]: (value) => {\n\t\t\t\tconst entry = parse(themes, value ?? undefined)\n\t\t\t\thandler(entry)\n\t\t\t}\n\t\t},\n\t\telement\n\t)\n\treturn () => observer.disconnect()\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,uBACf,QACA,eACA,SACA,SAGa;CACb,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS,cAAa;CAC3B,MAAM,QACL,SAAS,WAAW,GAAG,MAAMA,gDAAmB,GAAG,GAAG,EAAE,WAAWC,mCAAiB,CAAC;CACtF,MAAM,WAAWC,qDAChB,GACE,iBAAiB,UAAU;AAE3B,UADc,MAAM,QAAQ,SAAS,OAAU,CACjC;IAEf,EACD,QACA;AACD,cAAa,SAAS,YAAY"}
+{"version":3,"file":"subscribe-data-attribute.cjs","names":["parseDataAttribute","SEPARATOR_SPACE","observeDataAttributes"],"sources":["../../../src/theme/data-attribute/subscribe-data-attribute.ts"],"sourcesContent":["import { observeDataAttributes } from '../../attributes/observe-data-attribute.ts'\nimport type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\nimport { parseDataAttribute } from './parse-data-attribute.ts'\n\n/**\n * Subscribes to changes on a data attribute and invokes the handler with parsed theme entries.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param attributeName - Data attribute name (e.g. `data-theme`)\n * @param handler - Callback invoked when the attribute changes\n * @param options.element - Element to observe (accepts null e.g. from refs). Defaults to document.documentElement.\n * @param options.parse - Custom parser (default: parseDataAttribute with space separator)\n * @returns Unsubscribe function. Returns a no-op function when element is not available (e.g. SSR).\n */\nexport function subscribeDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\n\thandler: (entry: ThemeEntry<Themes> | undefined) => void,\n\toptions?:\n\t\t| { element?: Element | null | undefined; parse?: ParseStoredTheme<Themes> | undefined }\n\t\t| undefined\n): () => void {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return () => {}\n\tconst parse =\n\t\toptions?.parse ?? ((t, v) => parseDataAttribute(t, v, { separator: SEPARATOR_SPACE }))\n\treturn observeDataAttributes<string, `data-${string}`>(\n\t\t{\n\t\t\t[attributeName]: (value) => {\n\t\t\t\tconst entry = parse(themes, value ?? undefined)\n\t\t\t\thandler(entry)\n\t\t\t}\n\t\t},\n\t\telement\n\t)\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,uBACf,QACA,eACA,SACA,SAGa;CACb,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS,cAAa;CAC3B,MAAM,QACL,SAAS,WAAW,GAAG,MAAMA,gDAAmB,GAAG,GAAG,EAAE,WAAWC,mCAAiB,CAAC;AACtF,QAAOC,qDACN,GACE,iBAAiB,UAAU;AAE3B,UADc,MAAM,QAAQ,SAAS,OAAU,CACjC;IAEf,EACD,QACA"}

package/dist/theme/data-attribute/subscribe-data-attribute.mjs

@@ -17,10 +17,9 @@ function subscribeDataAttribute(themes, attributeName, handler, options) {
 	const element = options?.element ?? document?.documentElement;
 	if (!element) return () => {};
 	const parse = options?.parse ?? ((t, v) => parseDataAttribute(t, v, { separator: SEPARATOR_SPACE }));
-	const observer = observeDataAttributes({ [attributeName]: (value) => {
+	return observeDataAttributes({ [attributeName]: (value) => {
 		handler(parse(themes, value ?? void 0));
 	} }, element);
-	return () => observer.disconnect();
 }
 
 //#endregion

package/dist/theme/data-attribute/subscribe-data-attribute.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"subscribe-data-attribute.mjs","names":[],"sources":["../../../src/theme/data-attribute/subscribe-data-attribute.ts"],"sourcesContent":["import { observeDataAttributes } from '../../attributes/observe-data-attribute.ts'\nimport type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\nimport { parseDataAttribute } from './parse-data-attribute.ts'\n\n/**\n * Subscribes to changes on a data attribute and invokes the handler with parsed theme entries.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param attributeName - Data attribute name (e.g. `data-theme`)\n * @param handler - Callback invoked when the attribute changes\n * @param options.element - Element to observe (accepts null e.g. from refs). Defaults to document.documentElement.\n * @param options.parse - Custom parser (default: parseDataAttribute with space separator)\n * @returns Unsubscribe function. Returns a no-op function when element is not available (e.g. SSR).\n */\nexport function subscribeDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\n\thandler: (entry: ThemeEntry<Themes> | undefined) => void,\n\toptions?:\n\t\t| { element?: Element | null | undefined; parse?: ParseStoredTheme<Themes> | undefined }\n\t\t| undefined\n): () => void {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return () => {}\n\tconst parse =\n\t\toptions?.parse ?? ((t, v) => parseDataAttribute(t, v, { separator: SEPARATOR_SPACE }))\n\tconst observer = observeDataAttributes<string, `data-${string}`>(\n\t\t{\n\t\t\t[attributeName]: (value) => {\n\t\t\t\tconst entry = parse(themes, value ?? undefined)\n\t\t\t\thandler(entry)\n\t\t\t}\n\t\t},\n\t\telement\n\t)\n\treturn () => observer.disconnect()\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,uBACf,QACA,eACA,SACA,SAGa;CACb,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS,cAAa;CAC3B,MAAM,QACL,SAAS,WAAW,GAAG,MAAM,mBAAmB,GAAG,GAAG,EAAE,WAAW,iBAAiB,CAAC;CACtF,MAAM,WAAW,sBAChB,GACE,iBAAiB,UAAU;AAE3B,UADc,MAAM,QAAQ,SAAS,OAAU,CACjC;IAEf,EACD,QACA;AACD,cAAa,SAAS,YAAY"}
+{"version":3,"file":"subscribe-data-attribute.mjs","names":[],"sources":["../../../src/theme/data-attribute/subscribe-data-attribute.ts"],"sourcesContent":["import { observeDataAttributes } from '../../attributes/observe-data-attribute.ts'\nimport type { ParseStoredTheme, ThemeEntry } from '../theme-entry.types.ts'\nimport type { ThemeMap } from '../theme-map.types.ts'\nimport { SEPARATOR_SPACE } from './_constant.ts'\nimport { parseDataAttribute } from './parse-data-attribute.ts'\n\n/**\n * Subscribes to changes on a data attribute and invokes the handler with parsed theme entries.\n *\n * @param themes - Record mapping theme keys to attribute values\n * @param attributeName - Data attribute name (e.g. `data-theme`)\n * @param handler - Callback invoked when the attribute changes\n * @param options.element - Element to observe (accepts null e.g. from refs). Defaults to document.documentElement.\n * @param options.parse - Custom parser (default: parseDataAttribute with space separator)\n * @returns Unsubscribe function. Returns a no-op function when element is not available (e.g. SSR).\n */\nexport function subscribeDataAttribute<Themes extends ThemeMap>(\n\tthemes: Themes,\n\tattributeName: `data-${string}`,\n\thandler: (entry: ThemeEntry<Themes> | undefined) => void,\n\toptions?:\n\t\t| { element?: Element | null | undefined; parse?: ParseStoredTheme<Themes> | undefined }\n\t\t| undefined\n): () => void {\n\tconst element = options?.element ?? document?.documentElement\n\tif (!element) return () => {}\n\tconst parse =\n\t\toptions?.parse ?? ((t, v) => parseDataAttribute(t, v, { separator: SEPARATOR_SPACE }))\n\treturn observeDataAttributes<string, `data-${string}`>(\n\t\t{\n\t\t\t[attributeName]: (value) => {\n\t\t\t\tconst entry = parse(themes, value ?? undefined)\n\t\t\t\thandler(entry)\n\t\t\t}\n\t\t},\n\t\telement\n\t)\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,uBACf,QACA,eACA,SACA,SAGa;CACb,MAAM,UAAU,SAAS,WAAW,UAAU;AAC9C,KAAI,CAAC,QAAS,cAAa;CAC3B,MAAM,QACL,SAAS,WAAW,GAAG,MAAM,mBAAmB,GAAG,GAAG,EAAE,WAAW,iBAAiB,CAAC;AACtF,QAAO,sBACN,GACE,iBAAiB,UAAU;AAE3B,UADc,MAAM,QAAQ,SAAS,OAAU,CACjC;IAEf,EACD,QACA"}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-css-unit-converter.cjs","names":["convertCssUnit"],"sources":["../../src/units/create-css-unit-converter.ts"],"sourcesContent":["import { convertCssUnit } from './convert-css-unit.ts'\nimport type { CssLengthUnit, CssUnitConverterContext } from './css-unit-converter.types.ts'\n\n/**\n * Creates a pre-configured CSS unit converter with fixed context.\n *\n * @param context - Root font size, viewport, line height, etc. Omitted values use browser auto-detect when available.\n * @returns A converter function that accepts value and toUnit (and optional fromUnit override).\n *\n * @example\n * ```ts\n * const convert = createCssUnitConverter({\n *   rootFontSize: 16,\n *   viewportWidth: 375,\n *   viewportHeight: 812,\n * })\n * convert('1rem', 'px')   // 16\n * convert('10vw', 'px')   // 37.5\n * convert(16, 'rem', { fromUnit: 'px' })  // 1\n * ```\n */\nexport function createCssUnitConverter(context?: CssUnitConverterContext) {\n\treturn function convert(\n\t\tvalue: number | string,\n\t\ttoUnit: CssLengthUnit,\n\t\toptions?: { fromUnit?: CssLengthUnit | undefined } | undefined\n\t): number | null | undefined {\n\t\treturn convertCssUnit(value, toUnit, { ...context, ...options })\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,uBAAuB,SAAmC;AACzE,QAAO,SAAS,QACf,OACA,QACA,SAC4B;AAC5B,SAAOA,wCAAe,OAAO,QAAQ;GAAE,GAAG;GAAS,GAAG;GAAS,CAAC"}

package/dist/units/create-css-unit-converter.d.cts

@@ -0,0 +1,28 @@
+import { CssLengthUnit, CssUnitConverterContext } from "./css-unit-converter.types.cjs";
+
+//#region src/units/create-css-unit-converter.d.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
+ * ```
+ */
+declare function createCssUnitConverter(context?: CssUnitConverterContext): (value: number | string, toUnit: CssLengthUnit, options?: {
+  fromUnit?: CssLengthUnit | undefined;
+} | undefined) => number | null | undefined;
+//#endregion
+export { createCssUnitConverter };
+//# sourceMappingURL=create-css-unit-converter.d.cts.map

package/dist/units/create-css-unit-converter.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-css-unit-converter.d.cts","names":[],"sources":["../../src/units/create-css-unit-converter.ts"],"sourcesContent":[],"mappings":";;;;;;AAqBA;;;;;;;;;;;;;;;;iBAAgB,sBAAA,WAAiC,2DAGvC;aACe"}

package/dist/units/create-css-unit-converter.d.mts

@@ -0,0 +1,28 @@
+import { CssLengthUnit, CssUnitConverterContext } from "./css-unit-converter.types.mjs";
+
+//#region src/units/create-css-unit-converter.d.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
+ * ```
+ */
+declare function createCssUnitConverter(context?: CssUnitConverterContext): (value: number | string, toUnit: CssLengthUnit, options?: {
+  fromUnit?: CssLengthUnit | undefined;
+} | undefined) => number | null | undefined;
+//#endregion
+export { createCssUnitConverter };
+//# sourceMappingURL=create-css-unit-converter.d.mts.map

package/dist/units/create-css-unit-converter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-css-unit-converter.d.mts","names":[],"sources":["../../src/units/create-css-unit-converter.ts"],"sourcesContent":[],"mappings":";;;;;;AAqBA;;;;;;;;;;;;;;;;iBAAgB,sBAAA,WAAiC,2DAGvC;aACe"}