UNPKG

@wordpress/components

Version:
1 lines • 2.12 kB
{"version":3,"file":"values.cjs","names":[],"sources":["../../src/utils/values.ts"],"sourcesContent":["/**\n * Determines if a value is null or undefined.\n *\n * @param value The value to check.\n * @return Whether value is not null or undefined.\n */\nexport function isValueDefined< T >(\n\tvalue: T\n): value is Exclude< T, null | undefined > {\n\treturn value !== undefined && value !== null;\n}\n\n/**\n * Determines if a value is empty, null, or undefined.\n *\n * @param value The value to check.\n * @return Whether value is empty.\n */\nexport function isValueEmpty(\n\tvalue: string | number | null | undefined\n): value is '' | null | undefined {\n\tconst isEmptyString = value === '';\n\n\treturn ! isValueDefined( value ) || isEmptyString;\n}\n\n/**\n * Get the first defined/non-null value from an array.\n *\n * @param values Values to derive from.\n * @param fallbackValue Fallback value if there are no defined values.\n * @return A defined value or the fallback value.\n */\nexport function getDefinedValue< T >(\n\tvalues: Array< T | null | undefined > = [],\n\tfallbackValue: T\n) {\n\treturn values.find( isValueDefined ) ?? fallbackValue;\n}\n\n/**\n * Converts a string to a number.\n *\n * @param value\n * @return String as a number.\n */\nexport const stringToNumber = ( value: string ) => {\n\treturn parseFloat( value );\n};\n\n/**\n * Regardless of the input being a string or a number, returns a number.\n *\n * Returns `undefined` in case the string is `undefined` or not a valid numeric value.\n *\n * @param value\n * @return The parsed number.\n */\nexport const ensureNumber = ( value: string | number ) => {\n\treturn typeof value === 'string' ? stringToNumber( value ) : value;\n};\n"],"mappings":";;;;;;;;;;;;AAMA,SAAgB,eACf,OAC0C;CAC1C,OAAO,UAAU,KAAA,KAAa,UAAU;AACzC;;;;;;;AAQA,SAAgB,aACf,OACiC;CACjC,MAAM,gBAAgB,UAAU;CAEhC,OAAO,CAAE,eAAgB,KAAM,KAAK;AACrC;;;;;;;;AASA,SAAgB,gBACf,SAAwC,CAAC,GACzC,eACC;CACD,OAAO,OAAO,KAAM,cAAe,KAAK;AACzC;;;;;;;AAQA,MAAa,kBAAmB,UAAmB;CAClD,OAAO,WAAY,KAAM;AAC1B;;;;;;;;;AAUA,MAAa,gBAAiB,UAA4B;CACzD,OAAO,OAAO,UAAU,WAAW,eAAgB,KAAM,IAAI;AAC9D"}