@just-web/toolkits 3.0.0 → 3.1.0

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"}

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

@@ -0,0 +1,33 @@
+import { convertCssUnit } from "./convert-css-unit.mjs";
+
+//#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 convertCssUnit(value, toUnit, {
+			...context,
+			...options
+		});
+	};
+}
+
+//#endregion
+export { createCssUnitConverter };
+//# sourceMappingURL=create-css-unit-converter.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-css-unit-converter.mjs","names":[],"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,SAAO,eAAe,OAAO,QAAQ;GAAE,GAAG;GAAS,GAAG;GAAS,CAAC"}

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

@@ -0,0 +1,35 @@
+//#region src/units/css-unit-converter.types.d.ts
+/**
+ * Supported CSS length units for conversion.
+ */
+type CssLengthUnit = 'px' | 'pt' | 'pc' | 'in' | 'cm' | 'mm' | 'rem' | 'em' | 'vw' | 'vh' | 'vmin' | 'vmax' | 'lh' | 'rlh' | 'ch' | '%';
+/**
+ * Options for convertCssUnit.
+ */
+interface ConvertCssUnitOptions {
+  /** Override when value is number or unitless string. Default: 'px'. */
+  fromUnit?: CssLengthUnit | undefined;
+  /** Root font size in px for rem. Auto: getRemToPxScale() in browser. Default: 16. */
+  rootFontSize?: number | undefined;
+  /** Element font size in px for em. Default: 16. */
+  elementFontSize?: number | undefined;
+  /** Viewport width in px for vw, vmin, vmax. Auto: window.innerWidth in browser. */
+  viewportWidth?: number | undefined;
+  /** Viewport height in px for vh, vmin, vmax. Auto: window.innerHeight in browser. */
+  viewportHeight?: number | undefined;
+  /** Line height in px for lh, rlh. */
+  lineHeight?: number | undefined;
+  /** Width of "0" character in px for ch. Default: ~0.5em. */
+  chWidth?: number | undefined;
+  /** Value that 100% equals (for % conversions). */
+  percentReference?: number | undefined;
+  /** Decimal places for output. Default: 4. */
+  precision?: number | undefined;
+}
+/**
+ * Context for createCssUnitConverter (pre-configured values).
+ */
+type CssUnitConverterContext = Omit<ConvertCssUnitOptions, 'fromUnit'>;
+//#endregion
+export { ConvertCssUnitOptions, CssLengthUnit, CssUnitConverterContext };
+//# sourceMappingURL=css-unit-converter.types.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"css-unit-converter.types.d.cts","names":[],"sources":["../../src/units/css-unit-converter.types.ts"],"sourcesContent":[],"mappings":";;AAGA;AAqBA;AAwBY,KA7CA,aAAA,GA6CA,IAAuB,GAAA,IAAA,GAAQ,IAAA,GAAA,IAAA,GAAA,IAAA,GAAA,IAAL,GAAI,KAAA,GAAA,IAAA,GAAA,IAAA,GAAA,IAAA,GAAA,MAAA,GAAA,MAAA,GAAA,IAAA,GAAA,KAAA,GAAA,IAAA,GAAA,GAAA;;;;UAxBzB,qBAAA;;aAEL;;;;;;;;;;;;;;;;;;;;;KAsBA,uBAAA,GAA0B,KAAK"}

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

@@ -0,0 +1,35 @@
+//#region src/units/css-unit-converter.types.d.ts
+/**
+ * Supported CSS length units for conversion.
+ */
+type CssLengthUnit = 'px' | 'pt' | 'pc' | 'in' | 'cm' | 'mm' | 'rem' | 'em' | 'vw' | 'vh' | 'vmin' | 'vmax' | 'lh' | 'rlh' | 'ch' | '%';
+/**
+ * Options for convertCssUnit.
+ */
+interface ConvertCssUnitOptions {
+  /** Override when value is number or unitless string. Default: 'px'. */
+  fromUnit?: CssLengthUnit | undefined;
+  /** Root font size in px for rem. Auto: getRemToPxScale() in browser. Default: 16. */
+  rootFontSize?: number | undefined;
+  /** Element font size in px for em. Default: 16. */
+  elementFontSize?: number | undefined;
+  /** Viewport width in px for vw, vmin, vmax. Auto: window.innerWidth in browser. */
+  viewportWidth?: number | undefined;
+  /** Viewport height in px for vh, vmin, vmax. Auto: window.innerHeight in browser. */
+  viewportHeight?: number | undefined;
+  /** Line height in px for lh, rlh. */
+  lineHeight?: number | undefined;
+  /** Width of "0" character in px for ch. Default: ~0.5em. */
+  chWidth?: number | undefined;
+  /** Value that 100% equals (for % conversions). */
+  percentReference?: number | undefined;
+  /** Decimal places for output. Default: 4. */
+  precision?: number | undefined;
+}
+/**
+ * Context for createCssUnitConverter (pre-configured values).
+ */
+type CssUnitConverterContext = Omit<ConvertCssUnitOptions, 'fromUnit'>;
+//#endregion
+export { ConvertCssUnitOptions, CssLengthUnit, CssUnitConverterContext };
+//# sourceMappingURL=css-unit-converter.types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"css-unit-converter.types.d.mts","names":[],"sources":["../../src/units/css-unit-converter.types.ts"],"sourcesContent":[],"mappings":";;AAGA;AAqBA;AAwBY,KA7CA,aAAA,GA6CA,IAAuB,GAAA,IAAA,GAAQ,IAAA,GAAA,IAAA,GAAA,IAAA,GAAA,IAAL,GAAI,KAAA,GAAA,IAAA,GAAA,IAAA,GAAA,IAAA,GAAA,MAAA,GAAA,MAAA,GAAA,IAAA,GAAA,KAAA,GAAA,IAAA,GAAA,GAAA;;;;UAxBzB,qBAAA;;aAEL;;;;;;;;;;;;;;;;;;;;;KAsBA,uBAAA,GAA0B,KAAK"}

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

@@ -0,0 +1,29 @@
+const require_parse_css_value = require('./parse-css-value.cjs');
+
+//#region src/units/get-css-unit.ts
+/**
+* Extracts the unit from a CSS value string.
+* Thin wrapper around parseCssValue.
+*
+* @param value - The CSS value to parse (e.g. '16px', '1.5rem', '100%'). Pass-through for null/undefined.
+* @returns The unit string, undefined for numbers or unitless strings, or null/undefined when input is null/undefined
+*
+* @example
+* ```ts
+* getCssUnit('16px')   // 'px'
+* getCssUnit('1rem')   // 'rem'
+* getCssUnit('100%')   // '%'
+* getCssUnit('0')      // undefined
+* getCssUnit('16')     // undefined
+* getCssUnit(null)     // null
+* getCssUnit(undefined) // undefined
+* ```
+*/
+function getCssUnit(value) {
+	if (value === null || value === void 0) return value;
+	return require_parse_css_value.parseCssValue(value)[1];
+}
+
+//#endregion
+exports.getCssUnit = getCssUnit;
+//# sourceMappingURL=get-css-unit.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-css-unit.cjs","names":["parseCssValue"],"sources":["../../src/units/get-css-unit.ts"],"sourcesContent":["import { parseCssValue } from './parse-css-value.ts'\n\n/**\n * Extracts the unit from a CSS value string.\n * Thin wrapper around parseCssValue.\n *\n * @param value - The CSS value to parse (e.g. '16px', '1.5rem', '100%'). Pass-through for null/undefined.\n * @returns The unit string, undefined for numbers or unitless strings, or null/undefined when input is null/undefined\n *\n * @example\n * ```ts\n * getCssUnit('16px')   // 'px'\n * getCssUnit('1rem')   // 'rem'\n * getCssUnit('100%')   // '%'\n * getCssUnit('0')      // undefined\n * getCssUnit('16')     // undefined\n * getCssUnit(null)     // null\n * getCssUnit(undefined) // undefined\n * ```\n */\nexport function getCssUnit(value: number | string | null | undefined): string | null | undefined {\n\tif (value === null || value === undefined) return value\n\treturn parseCssValue(value)[1]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,WAAW,OAAsE;AAChG,KAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,QAAOA,sCAAc,MAAM,CAAC"}

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

@@ -0,0 +1,23 @@
+//#region src/units/get-css-unit.d.ts
+/**
+ * Extracts the unit from a CSS value string.
+ * Thin wrapper around parseCssValue.
+ *
+ * @param value - The CSS value to parse (e.g. '16px', '1.5rem', '100%'). Pass-through for null/undefined.
+ * @returns The unit string, undefined for numbers or unitless strings, or null/undefined when input is null/undefined
+ *
+ * @example
+ * ```ts
+ * getCssUnit('16px')   // 'px'
+ * getCssUnit('1rem')   // 'rem'
+ * getCssUnit('100%')   // '%'
+ * getCssUnit('0')      // undefined
+ * getCssUnit('16')     // undefined
+ * getCssUnit(null)     // null
+ * getCssUnit(undefined) // undefined
+ * ```
+ */
+declare function getCssUnit(value: number | string | null | undefined): string | null | undefined;
+//#endregion
+export { getCssUnit };
+//# sourceMappingURL=get-css-unit.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-css-unit.d.cts","names":[],"sources":["../../src/units/get-css-unit.ts"],"sourcesContent":[],"mappings":";;AAoBA;;;;;;;;;;;;;;;;;iBAAgB,UAAA"}

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

@@ -0,0 +1,23 @@
+//#region src/units/get-css-unit.d.ts
+/**
+ * Extracts the unit from a CSS value string.
+ * Thin wrapper around parseCssValue.
+ *
+ * @param value - The CSS value to parse (e.g. '16px', '1.5rem', '100%'). Pass-through for null/undefined.
+ * @returns The unit string, undefined for numbers or unitless strings, or null/undefined when input is null/undefined
+ *
+ * @example
+ * ```ts
+ * getCssUnit('16px')   // 'px'
+ * getCssUnit('1rem')   // 'rem'
+ * getCssUnit('100%')   // '%'
+ * getCssUnit('0')      // undefined
+ * getCssUnit('16')     // undefined
+ * getCssUnit(null)     // null
+ * getCssUnit(undefined) // undefined
+ * ```
+ */
+declare function getCssUnit(value: number | string | null | undefined): string | null | undefined;
+//#endregion
+export { getCssUnit };
+//# sourceMappingURL=get-css-unit.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-css-unit.d.mts","names":[],"sources":["../../src/units/get-css-unit.ts"],"sourcesContent":[],"mappings":";;AAoBA;;;;;;;;;;;;;;;;;iBAAgB,UAAA"}

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

@@ -0,0 +1,29 @@
+import { parseCssValue } from "./parse-css-value.mjs";
+
+//#region src/units/get-css-unit.ts
+/**
+* Extracts the unit from a CSS value string.
+* Thin wrapper around parseCssValue.
+*
+* @param value - The CSS value to parse (e.g. '16px', '1.5rem', '100%'). Pass-through for null/undefined.
+* @returns The unit string, undefined for numbers or unitless strings, or null/undefined when input is null/undefined
+*
+* @example
+* ```ts
+* getCssUnit('16px')   // 'px'
+* getCssUnit('1rem')   // 'rem'
+* getCssUnit('100%')   // '%'
+* getCssUnit('0')      // undefined
+* getCssUnit('16')     // undefined
+* getCssUnit(null)     // null
+* getCssUnit(undefined) // undefined
+* ```
+*/
+function getCssUnit(value) {
+	if (value === null || value === void 0) return value;
+	return parseCssValue(value)[1];
+}
+
+//#endregion
+export { getCssUnit };
+//# sourceMappingURL=get-css-unit.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-css-unit.mjs","names":[],"sources":["../../src/units/get-css-unit.ts"],"sourcesContent":["import { parseCssValue } from './parse-css-value.ts'\n\n/**\n * Extracts the unit from a CSS value string.\n * Thin wrapper around parseCssValue.\n *\n * @param value - The CSS value to parse (e.g. '16px', '1.5rem', '100%'). Pass-through for null/undefined.\n * @returns The unit string, undefined for numbers or unitless strings, or null/undefined when input is null/undefined\n *\n * @example\n * ```ts\n * getCssUnit('16px')   // 'px'\n * getCssUnit('1rem')   // 'rem'\n * getCssUnit('100%')   // '%'\n * getCssUnit('0')      // undefined\n * getCssUnit('16')     // undefined\n * getCssUnit(null)     // null\n * getCssUnit(undefined) // undefined\n * ```\n */\nexport function getCssUnit(value: number | string | null | undefined): string | null | undefined {\n\tif (value === null || value === undefined) return value\n\treturn parseCssValue(value)[1]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,WAAW,OAAsE;AAChG,KAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,QAAO,cAAc,MAAM,CAAC"}

package/dist/units/is-effectively-zero.cjs

@@ -0,0 +1,35 @@
+const require_parse_css_number = require('./parse-css-number.cjs');
+
+//#region src/units/is-effectively-zero.ts
+/**
+* Determines if a CSS value is effectively 0 regardless of unit.
+*
+* @param value - The CSS value to check. Can be a number or string (e.g. '0px', '0rem', '0%'). Pass-through for null/undefined.
+* @param options - Optional configuration
+* @param options.epsilon - Floating-point tolerance. Default 1e-10. Use 0 for strict equality.
+* @returns true if the value is effectively zero, false otherwise, or null/undefined when input is null/undefined
+*
+* @example
+* ```ts
+* isEffectivelyZero(0)           // true
+* isEffectivelyZero('0px')       // true
+* isEffectivelyZero('0rem')      // true
+* isEffectivelyZero('0%')        // true
+* isEffectivelyZero('1px')       // false
+* isEffectivelyZero(0.00000000001)  // true (within default epsilon)
+* isEffectivelyZero(0.0001, { epsilon: 0.001 })  // true
+* isEffectivelyZero(null)        // null
+* isEffectivelyZero(undefined)   // undefined
+* ```
+*/
+function isEffectivelyZero(value, options) {
+	const parsed = require_parse_css_number.parseCssNumber(value);
+	if (parsed === null || parsed === void 0) return parsed;
+	if (!Number.isFinite(parsed)) return false;
+	const epsilon = options?.epsilon ?? 1e-10;
+	return Math.abs(parsed) <= epsilon;
+}
+
+//#endregion
+exports.isEffectivelyZero = isEffectivelyZero;
+//# sourceMappingURL=is-effectively-zero.cjs.map

package/dist/units/is-effectively-zero.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-effectively-zero.cjs","names":["parseCssNumber"],"sources":["../../src/units/is-effectively-zero.ts"],"sourcesContent":["import { parseCssNumber } from './parse-css-number.ts'\n\n/**\n * Determines if a CSS value is effectively 0 regardless of unit.\n *\n * @param value - The CSS value to check. Can be a number or string (e.g. '0px', '0rem', '0%'). Pass-through for null/undefined.\n * @param options - Optional configuration\n * @param options.epsilon - Floating-point tolerance. Default 1e-10. Use 0 for strict equality.\n * @returns true if the value is effectively zero, false otherwise, or null/undefined when input is null/undefined\n *\n * @example\n * ```ts\n * isEffectivelyZero(0)           // true\n * isEffectivelyZero('0px')       // true\n * isEffectivelyZero('0rem')      // true\n * isEffectivelyZero('0%')        // true\n * isEffectivelyZero('1px')       // false\n * isEffectivelyZero(0.00000000001)  // true (within default epsilon)\n * isEffectivelyZero(0.0001, { epsilon: 0.001 })  // true\n * isEffectivelyZero(null)        // null\n * isEffectivelyZero(undefined)   // undefined\n * ```\n */\nexport function isEffectivelyZero(\n\tvalue: number | string | null | undefined,\n\toptions?: { epsilon?: number | undefined } | undefined\n): boolean | null | undefined {\n\tconst parsed = parseCssNumber(value)\n\tif (parsed === null || parsed === undefined) return parsed\n\tif (!Number.isFinite(parsed)) {\n\t\treturn false\n\t}\n\tconst epsilon = options?.epsilon ?? 1e-10\n\treturn Math.abs(parsed) <= epsilon\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,kBACf,OACA,SAC6B;CAC7B,MAAM,SAASA,wCAAe,MAAM;AACpC,KAAI,WAAW,QAAQ,WAAW,OAAW,QAAO;AACpD,KAAI,CAAC,OAAO,SAAS,OAAO,CAC3B,QAAO;CAER,MAAM,UAAU,SAAS,WAAW;AACpC,QAAO,KAAK,IAAI,OAAO,IAAI"}

package/dist/units/is-effectively-zero.d.cts

@@ -0,0 +1,28 @@
+//#region src/units/is-effectively-zero.d.ts
+/**
+ * Determines if a CSS value is effectively 0 regardless of unit.
+ *
+ * @param value - The CSS value to check. Can be a number or string (e.g. '0px', '0rem', '0%'). Pass-through for null/undefined.
+ * @param options - Optional configuration
+ * @param options.epsilon - Floating-point tolerance. Default 1e-10. Use 0 for strict equality.
+ * @returns true if the value is effectively zero, false otherwise, or null/undefined when input is null/undefined
+ *
+ * @example
+ * ```ts
+ * isEffectivelyZero(0)           // true
+ * isEffectivelyZero('0px')       // true
+ * isEffectivelyZero('0rem')      // true
+ * isEffectivelyZero('0%')        // true
+ * isEffectivelyZero('1px')       // false
+ * isEffectivelyZero(0.00000000001)  // true (within default epsilon)
+ * isEffectivelyZero(0.0001, { epsilon: 0.001 })  // true
+ * isEffectivelyZero(null)        // null
+ * isEffectivelyZero(undefined)   // undefined
+ * ```
+ */
+declare function isEffectivelyZero(value: number | string | null | undefined, options?: {
+  epsilon?: number | undefined;
+} | undefined): boolean | null | undefined;
+//#endregion
+export { isEffectivelyZero };
+//# sourceMappingURL=is-effectively-zero.d.cts.map

package/dist/units/is-effectively-zero.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-effectively-zero.d.cts","names":[],"sources":["../../src/units/is-effectively-zero.ts"],"sourcesContent":[],"mappings":";;AAuBA;;;;;;;;;;;;;;;;;;;;iBAAgB,iBAAA"}

package/dist/units/is-effectively-zero.d.mts

@@ -0,0 +1,28 @@
+//#region src/units/is-effectively-zero.d.ts
+/**
+ * Determines if a CSS value is effectively 0 regardless of unit.
+ *
+ * @param value - The CSS value to check. Can be a number or string (e.g. '0px', '0rem', '0%'). Pass-through for null/undefined.
+ * @param options - Optional configuration
+ * @param options.epsilon - Floating-point tolerance. Default 1e-10. Use 0 for strict equality.
+ * @returns true if the value is effectively zero, false otherwise, or null/undefined when input is null/undefined
+ *
+ * @example
+ * ```ts
+ * isEffectivelyZero(0)           // true
+ * isEffectivelyZero('0px')       // true
+ * isEffectivelyZero('0rem')      // true
+ * isEffectivelyZero('0%')        // true
+ * isEffectivelyZero('1px')       // false
+ * isEffectivelyZero(0.00000000001)  // true (within default epsilon)
+ * isEffectivelyZero(0.0001, { epsilon: 0.001 })  // true
+ * isEffectivelyZero(null)        // null
+ * isEffectivelyZero(undefined)   // undefined
+ * ```
+ */
+declare function isEffectivelyZero(value: number | string | null | undefined, options?: {
+  epsilon?: number | undefined;
+} | undefined): boolean | null | undefined;
+//#endregion
+export { isEffectivelyZero };
+//# sourceMappingURL=is-effectively-zero.d.mts.map

package/dist/units/is-effectively-zero.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-effectively-zero.d.mts","names":[],"sources":["../../src/units/is-effectively-zero.ts"],"sourcesContent":[],"mappings":";;AAuBA;;;;;;;;;;;;;;;;;;;;iBAAgB,iBAAA"}

package/dist/units/is-effectively-zero.mjs

@@ -0,0 +1,35 @@
+import { parseCssNumber } from "./parse-css-number.mjs";
+
+//#region src/units/is-effectively-zero.ts
+/**
+* Determines if a CSS value is effectively 0 regardless of unit.
+*
+* @param value - The CSS value to check. Can be a number or string (e.g. '0px', '0rem', '0%'). Pass-through for null/undefined.
+* @param options - Optional configuration
+* @param options.epsilon - Floating-point tolerance. Default 1e-10. Use 0 for strict equality.
+* @returns true if the value is effectively zero, false otherwise, or null/undefined when input is null/undefined
+*
+* @example
+* ```ts
+* isEffectivelyZero(0)           // true
+* isEffectivelyZero('0px')       // true
+* isEffectivelyZero('0rem')      // true
+* isEffectivelyZero('0%')        // true
+* isEffectivelyZero('1px')       // false
+* isEffectivelyZero(0.00000000001)  // true (within default epsilon)
+* isEffectivelyZero(0.0001, { epsilon: 0.001 })  // true
+* isEffectivelyZero(null)        // null
+* isEffectivelyZero(undefined)   // undefined
+* ```
+*/
+function isEffectivelyZero(value, options) {
+	const parsed = parseCssNumber(value);
+	if (parsed === null || parsed === void 0) return parsed;
+	if (!Number.isFinite(parsed)) return false;
+	const epsilon = options?.epsilon ?? 1e-10;
+	return Math.abs(parsed) <= epsilon;
+}
+
+//#endregion
+export { isEffectivelyZero };
+//# sourceMappingURL=is-effectively-zero.mjs.map

package/dist/units/is-effectively-zero.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-effectively-zero.mjs","names":[],"sources":["../../src/units/is-effectively-zero.ts"],"sourcesContent":["import { parseCssNumber } from './parse-css-number.ts'\n\n/**\n * Determines if a CSS value is effectively 0 regardless of unit.\n *\n * @param value - The CSS value to check. Can be a number or string (e.g. '0px', '0rem', '0%'). Pass-through for null/undefined.\n * @param options - Optional configuration\n * @param options.epsilon - Floating-point tolerance. Default 1e-10. Use 0 for strict equality.\n * @returns true if the value is effectively zero, false otherwise, or null/undefined when input is null/undefined\n *\n * @example\n * ```ts\n * isEffectivelyZero(0)           // true\n * isEffectivelyZero('0px')       // true\n * isEffectivelyZero('0rem')      // true\n * isEffectivelyZero('0%')        // true\n * isEffectivelyZero('1px')       // false\n * isEffectivelyZero(0.00000000001)  // true (within default epsilon)\n * isEffectivelyZero(0.0001, { epsilon: 0.001 })  // true\n * isEffectivelyZero(null)        // null\n * isEffectivelyZero(undefined)   // undefined\n * ```\n */\nexport function isEffectivelyZero(\n\tvalue: number | string | null | undefined,\n\toptions?: { epsilon?: number | undefined } | undefined\n): boolean | null | undefined {\n\tconst parsed = parseCssNumber(value)\n\tif (parsed === null || parsed === undefined) return parsed\n\tif (!Number.isFinite(parsed)) {\n\t\treturn false\n\t}\n\tconst epsilon = options?.epsilon ?? 1e-10\n\treturn Math.abs(parsed) <= epsilon\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,kBACf,OACA,SAC6B;CAC7B,MAAM,SAAS,eAAe,MAAM;AACpC,KAAI,WAAW,QAAQ,WAAW,OAAW,QAAO;AACpD,KAAI,CAAC,OAAO,SAAS,OAAO,CAC3B,QAAO;CAER,MAAM,UAAU,SAAS,WAAW;AACpC,QAAO,KAAK,IAAI,OAAO,IAAI"}

package/dist/units/parse-css-number.cjs

@@ -0,0 +1,29 @@
+const require_parse_css_value = require('./parse-css-value.cjs');
+
+//#region src/units/parse-css-number.ts
+/**
+* Extracts the numeric part from any CSS length/percentage value.
+* Thin wrapper around parseCssValue.
+*
+* @param value - The CSS value to parse. Can be a number or string (e.g. '16px', '1.5rem', '100%')
+* @returns The numeric value, or NaN for invalid input. Passes through null and undefined.
+*
+* @example
+* ```ts
+* parseCssNumber('16px')   // 16
+* parseCssNumber('1.5rem') // 1.5
+* parseCssNumber('100%')   // 100
+* parseCssNumber('0lh')    // 0
+* parseCssNumber(16)       // 16
+* parseCssNumber('abc')    // NaN
+* parseCssNumber(null)     // null
+* parseCssNumber(undefined) // undefined
+* ```
+*/
+function parseCssNumber(value) {
+	return require_parse_css_value.parseCssValue(value)[0];
+}
+
+//#endregion
+exports.parseCssNumber = parseCssNumber;
+//# sourceMappingURL=parse-css-number.cjs.map

package/dist/units/parse-css-number.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-css-number.cjs","names":["parseCssValue"],"sources":["../../src/units/parse-css-number.ts"],"sourcesContent":["import { parseCssValue } from './parse-css-value.ts'\n\n/**\n * Extracts the numeric part from any CSS length/percentage value.\n * Thin wrapper around parseCssValue.\n *\n * @param value - The CSS value to parse. Can be a number or string (e.g. '16px', '1.5rem', '100%')\n * @returns The numeric value, or NaN for invalid input. Passes through null and undefined.\n *\n * @example\n * ```ts\n * parseCssNumber('16px')   // 16\n * parseCssNumber('1.5rem') // 1.5\n * parseCssNumber('100%')   // 100\n * parseCssNumber('0lh')    // 0\n * parseCssNumber(16)       // 16\n * parseCssNumber('abc')    // NaN\n * parseCssNumber(null)     // null\n * parseCssNumber(undefined) // undefined\n * ```\n */\nexport function parseCssNumber(\n\tvalue: number | string | null | undefined\n): number | null | undefined {\n\treturn parseCssValue(value)[0]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,eACf,OAC4B;AAC5B,QAAOA,sCAAc,MAAM,CAAC"}

package/dist/units/parse-css-number.d.cts

@@ -0,0 +1,24 @@
+//#region src/units/parse-css-number.d.ts
+/**
+ * Extracts the numeric part from any CSS length/percentage value.
+ * Thin wrapper around parseCssValue.
+ *
+ * @param value - The CSS value to parse. Can be a number or string (e.g. '16px', '1.5rem', '100%')
+ * @returns The numeric value, or NaN for invalid input. Passes through null and undefined.
+ *
+ * @example
+ * ```ts
+ * parseCssNumber('16px')   // 16
+ * parseCssNumber('1.5rem') // 1.5
+ * parseCssNumber('100%')   // 100
+ * parseCssNumber('0lh')    // 0
+ * parseCssNumber(16)       // 16
+ * parseCssNumber('abc')    // NaN
+ * parseCssNumber(null)     // null
+ * parseCssNumber(undefined) // undefined
+ * ```
+ */
+declare function parseCssNumber(value: number | string | null | undefined): number | null | undefined;
+//#endregion
+export { parseCssNumber };
+//# sourceMappingURL=parse-css-number.d.cts.map

package/dist/units/parse-css-number.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-css-number.d.cts","names":[],"sources":["../../src/units/parse-css-number.ts"],"sourcesContent":[],"mappings":";;AAqBA;;;;;;;;;;;;;;;;;;iBAAgB,cAAA"}

package/dist/units/parse-css-number.d.mts

@@ -0,0 +1,24 @@
+//#region src/units/parse-css-number.d.ts
+/**
+ * Extracts the numeric part from any CSS length/percentage value.
+ * Thin wrapper around parseCssValue.
+ *
+ * @param value - The CSS value to parse. Can be a number or string (e.g. '16px', '1.5rem', '100%')
+ * @returns The numeric value, or NaN for invalid input. Passes through null and undefined.
+ *
+ * @example
+ * ```ts
+ * parseCssNumber('16px')   // 16
+ * parseCssNumber('1.5rem') // 1.5
+ * parseCssNumber('100%')   // 100
+ * parseCssNumber('0lh')    // 0
+ * parseCssNumber(16)       // 16
+ * parseCssNumber('abc')    // NaN
+ * parseCssNumber(null)     // null
+ * parseCssNumber(undefined) // undefined
+ * ```
+ */
+declare function parseCssNumber(value: number | string | null | undefined): number | null | undefined;
+//#endregion
+export { parseCssNumber };
+//# sourceMappingURL=parse-css-number.d.mts.map

package/dist/units/parse-css-number.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-css-number.d.mts","names":[],"sources":["../../src/units/parse-css-number.ts"],"sourcesContent":[],"mappings":";;AAqBA;;;;;;;;;;;;;;;;;;iBAAgB,cAAA"}

package/dist/units/parse-css-number.mjs

@@ -0,0 +1,29 @@
+import { parseCssValue } from "./parse-css-value.mjs";
+
+//#region src/units/parse-css-number.ts
+/**
+* Extracts the numeric part from any CSS length/percentage value.
+* Thin wrapper around parseCssValue.
+*
+* @param value - The CSS value to parse. Can be a number or string (e.g. '16px', '1.5rem', '100%')
+* @returns The numeric value, or NaN for invalid input. Passes through null and undefined.
+*
+* @example
+* ```ts
+* parseCssNumber('16px')   // 16
+* parseCssNumber('1.5rem') // 1.5
+* parseCssNumber('100%')   // 100
+* parseCssNumber('0lh')    // 0
+* parseCssNumber(16)       // 16
+* parseCssNumber('abc')    // NaN
+* parseCssNumber(null)     // null
+* parseCssNumber(undefined) // undefined
+* ```
+*/
+function parseCssNumber(value) {
+	return parseCssValue(value)[0];
+}
+
+//#endregion
+export { parseCssNumber };
+//# sourceMappingURL=parse-css-number.mjs.map

package/dist/units/parse-css-number.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-css-number.mjs","names":[],"sources":["../../src/units/parse-css-number.ts"],"sourcesContent":["import { parseCssValue } from './parse-css-value.ts'\n\n/**\n * Extracts the numeric part from any CSS length/percentage value.\n * Thin wrapper around parseCssValue.\n *\n * @param value - The CSS value to parse. Can be a number or string (e.g. '16px', '1.5rem', '100%')\n * @returns The numeric value, or NaN for invalid input. Passes through null and undefined.\n *\n * @example\n * ```ts\n * parseCssNumber('16px')   // 16\n * parseCssNumber('1.5rem') // 1.5\n * parseCssNumber('100%')   // 100\n * parseCssNumber('0lh')    // 0\n * parseCssNumber(16)       // 16\n * parseCssNumber('abc')    // NaN\n * parseCssNumber(null)     // null\n * parseCssNumber(undefined) // undefined\n * ```\n */\nexport function parseCssNumber(\n\tvalue: number | string | null | undefined\n): number | null | undefined {\n\treturn parseCssValue(value)[0]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,eACf,OAC4B;AAC5B,QAAO,cAAc,MAAM,CAAC"}

package/dist/units/parse-css-value.cjs

@@ -0,0 +1,32 @@
+
+//#region src/units/parse-css-value.ts
+/**
+* Parses a CSS value in one pass and returns both the numeric part and the unit.
+* Powers parseCssNumber, getCssUnit, and isEffectivelyZero.
+*
+* @param value - The CSS value to parse. Can be a number or string (e.g. '16px', '1.5rem', '100%')
+* @returns A tuple of [number, unit | undefined]. Unit is undefined for numbers or unitless strings.
+*
+* @example
+* ```ts
+* parseCssValue('16px')    // [16, 'px']
+* parseCssValue('1.5rem')  // [1.5, 'rem']
+* parseCssValue('100%')    // [100, '%']
+* parseCssValue('0')       // [0, undefined]
+* parseCssValue(16)        // [16, undefined]
+* parseCssValue('abc')     // [NaN, undefined]
+* ```
+*/
+function parseCssValue(value) {
+	if (value === void 0 || value === null) return [value, void 0];
+	if (typeof value === "number") return [value, void 0];
+	const match = String(value).trim().match(/^(-?\d*\.?\d+)\s*(.*)$/);
+	if (!match) return [NaN, void 0];
+	const num = Number.parseFloat(match[1] ?? "");
+	const unit = (match[2] ?? "").trim();
+	return [num, unit === "" ? void 0 : unit];
+}
+
+//#endregion
+exports.parseCssValue = parseCssValue;
+//# sourceMappingURL=parse-css-value.cjs.map