@wordpress/components
Version:
UI components for WordPress.
1 lines • 5.83 kB
Source Map (JSON)
{"version":3,"file":"math.cjs","names":[],"sources":["../../src/utils/math.ts"],"sourcesContent":["/**\n * Parses and retrieves a number value.\n *\n * @param value The incoming value.\n *\n * @return The parsed number value.\n */\nexport function getNumber( value: unknown ) {\n\tconst number = Number( value );\n\n\treturn isNaN( number ) ? 0 : number;\n}\n\n/**\n * Safely adds values together, handling floating-point precision issues.\n *\n * @param args Values to add together.\n *\n * @return The sum of values.\n */\nexport function add( ...args: Array< number | string > ) {\n\tconst precision = args.length\n\t\t? Math.max( ...args.map( ( arg ) => getPrecision( getNumber( arg ) ) ) )\n\t\t: 0;\n\tconst sum = args.reduce< number >(\n\t\t( total, arg ) => total + getNumber( arg ),\n\t\t0\n\t);\n\treturn precision\n\t\t? getNumber( sum.toFixed( Math.min( precision, 20 ) ) )\n\t\t: sum;\n}\n\n/**\n * Safely subtracts values, handling floating-point precision issues.\n *\n * @param args Values to subtract together.\n *\n * @return The difference of the values.\n */\nexport function subtract( ...args: Array< number | string > ) {\n\tconst precision = args.length\n\t\t? Math.max( ...args.map( ( arg ) => getPrecision( getNumber( arg ) ) ) )\n\t\t: 0;\n\tconst diff = args.reduce< number >( ( total, arg, index ) => {\n\t\tconst value = getNumber( arg );\n\t\treturn index === 0 ? value : total - value;\n\t}, 0 );\n\treturn precision\n\t\t? getNumber( diff.toFixed( Math.min( precision, 20 ) ) )\n\t\t: diff;\n}\n\n/**\n * Safely multiplies values together, handling floating-point precision issues.\n *\n * @param args Values to multiply together.\n *\n * @return The product of values.\n */\nexport function multiply( ...args: Array< number | string > ) {\n\tif ( ! args.length ) {\n\t\treturn 0;\n\t}\n\n\tconst precision = args.reduce< number >(\n\t\t( total, arg ) => total + getPrecision( getNumber( arg ) ),\n\t\t0\n\t);\n\tconst product = args.reduce< number >( ( total, arg, index ) => {\n\t\tconst value = getNumber( arg );\n\t\treturn index === 0 ? value : total * value;\n\t}, 1 );\n\n\treturn precision\n\t\t? getNumber( product.toFixed( Math.min( precision, 20 ) ) )\n\t\t: product;\n}\n\n/**\n * Determines the decimal position of a number value.\n *\n * @param value The number to evaluate.\n *\n * @return The number of decimal places.\n */\nfunction getPrecision( value: number ) {\n\tconst [ base, exponent ] = ( value + '' ).split( /[eE]/ );\n\n\tif ( exponent !== undefined ) {\n\t\tconst baseDecimals = base.includes( '.' )\n\t\t\t? base.split( '.' )[ 1 ].length\n\t\t\t: 0;\n\t\tconst precision = baseDecimals - parseInt( exponent, 10 );\n\t\treturn precision > 0 ? precision : 0;\n\t}\n\n\tconst split = base.split( '.' );\n\treturn split[ 1 ] !== undefined ? split[ 1 ].length : 0;\n}\n\n/**\n * Clamps a value based on a min/max range.\n *\n * @param value The value.\n * @param min The minimum range.\n * @param max The maximum range.\n *\n * @return The clamped value.\n */\nexport function clamp( value: number | string, min: number, max: number ) {\n\tconst baseValue = getNumber( value );\n\treturn Math.max( min, Math.min( baseValue, max ) );\n}\n\n/**\n * Rounds a value to the nearest step offset by a minimum.\n *\n * @param value The value.\n * @param min The minimum range.\n * @param step The increment for the value.\n *\n * @return The value as a valid step.\n */\nexport function ensureValidStep(\n\tvalue: number | string,\n\tmin: number,\n\tstep: number\n) {\n\tconst baseValue = getNumber( value );\n\tconst minValue = getNumber( min );\n\tconst stepValue = getNumber( step );\n\tconst precision = Math.max( getPrecision( step ), getPrecision( min ) );\n\t// If the step is not a factor of the minimum then the step must be\n\t// offset by the minimum.\n\tconst tare = minValue % stepValue ? minValue : 0;\n\tconst rounded = Math.round( ( baseValue - tare ) / stepValue ) * stepValue;\n\tconst fromMin = rounded + tare;\n\treturn precision ? getNumber( fromMin.toFixed( precision ) ) : fromMin;\n}\n"],"mappings":";;;;;;;;;;;;;AAOA,SAAgB,UAAW,OAAiB;CAC3C,MAAM,SAAS,OAAQ,KAAM;CAE7B,OAAO,MAAO,MAAO,IAAI,IAAI;AAC9B;;;;;;;;AASA,SAAgB,IAAK,GAAG,MAAiC;CACxD,MAAM,YAAY,KAAK,SACpB,KAAK,IAAK,GAAG,KAAK,KAAO,QAAS,aAAc,UAAW,GAAI,CAAE,CAAE,CAAE,IACrE;CACH,MAAM,MAAM,KAAK,QACd,OAAO,QAAS,QAAQ,UAAW,GAAI,GACzC,CACD;CACA,OAAO,YACJ,UAAW,IAAI,QAAS,KAAK,IAAK,WAAW,EAAG,CAAE,CAAE,IACpD;AACJ;;;;;;;;AASA,SAAgB,SAAU,GAAG,MAAiC;CAC7D,MAAM,YAAY,KAAK,SACpB,KAAK,IAAK,GAAG,KAAK,KAAO,QAAS,aAAc,UAAW,GAAI,CAAE,CAAE,CAAE,IACrE;CACH,MAAM,OAAO,KAAK,QAAoB,OAAO,KAAK,UAAW;EAC5D,MAAM,QAAQ,UAAW,GAAI;EAC7B,OAAO,UAAU,IAAI,QAAQ,QAAQ;CACtC,GAAG,CAAE;CACL,OAAO,YACJ,UAAW,KAAK,QAAS,KAAK,IAAK,WAAW,EAAG,CAAE,CAAE,IACrD;AACJ;;;;;;;;AASA,SAAgB,SAAU,GAAG,MAAiC;CAC7D,IAAK,CAAE,KAAK,QACX,OAAO;CAGR,MAAM,YAAY,KAAK,QACpB,OAAO,QAAS,QAAQ,aAAc,UAAW,GAAI,CAAE,GACzD,CACD;CACA,MAAM,UAAU,KAAK,QAAoB,OAAO,KAAK,UAAW;EAC/D,MAAM,QAAQ,UAAW,GAAI;EAC7B,OAAO,UAAU,IAAI,QAAQ,QAAQ;CACtC,GAAG,CAAE;CAEL,OAAO,YACJ,UAAW,QAAQ,QAAS,KAAK,IAAK,WAAW,EAAG,CAAE,CAAE,IACxD;AACJ;;;;;;;;AASA,SAAS,aAAc,OAAgB;CACtC,MAAM,CAAE,MAAM,aAAe,QAAQ,GAAA,CAAK,MAAO,MAAO;CAExD,IAAK,aAAa,KAAA,GAAY;EAI7B,MAAM,aAHe,KAAK,SAAU,GAAI,IACrC,KAAK,MAAO,GAAI,CAAC,CAAE,EAAG,CAAC,SACvB,KAC8B,SAAU,UAAU,EAAG;EACxD,OAAO,YAAY,IAAI,YAAY;CACpC;CAEA,MAAM,QAAQ,KAAK,MAAO,GAAI;CAC9B,OAAO,MAAO,OAAQ,KAAA,IAAY,MAAO,EAAG,CAAC,SAAS;AACvD;;;;;;;;;;AAWA,SAAgB,MAAO,OAAwB,KAAa,KAAc;CACzE,MAAM,YAAY,UAAW,KAAM;CACnC,OAAO,KAAK,IAAK,KAAK,KAAK,IAAK,WAAW,GAAI,CAAE;AAClD;;;;;;;;;;AAWA,SAAgB,gBACf,OACA,KACA,MACC;CACD,MAAM,YAAY,UAAW,KAAM;CACnC,MAAM,WAAW,UAAW,GAAI;CAChC,MAAM,YAAY,UAAW,IAAK;CAClC,MAAM,YAAY,KAAK,IAAK,aAAc,IAAK,GAAG,aAAc,GAAI,CAAE;CAGtE,MAAM,OAAO,WAAW,YAAY,WAAW;CAE/C,MAAM,UADU,KAAK,OAAS,YAAY,QAAS,SAAU,IAAI,YACvC;CAC1B,OAAO,YAAY,UAAW,QAAQ,QAAS,SAAU,CAAE,IAAI;AAChE"}