var lowerCase = require('lower-case') var NON_WORD_REGEXP = require('./vendor/non-word-regexp') var CAMEL_CASE_REGEXP = require('./vendor/camel-case-regexp') var CAMEL_CASE_UPPER_REGEXP = require('./vendor/camel-case-upper-regexp') /** * Sentence case a string. * * @param {string} str * @param {string} locale * @param {string} replacement * @return {string} */ module.exports = function (str, locale, replacement) { if (str == null) { return '' } replacement = typeof replacement !== 'string' ? ' ' : replacement function replace (match, index, value) { if (index === 0 || index === (value.length - match.length)) { return '' } return replacement } str = String(str) // Support camel case ("camelCase" -> "camel Case"). .replace(CAMEL_CASE_REGEXP, '$1 $2') // Support odd camel case ("CAMELCase" -> "CAMEL Case"). .replace(CAMEL_CASE_UPPER_REGEXP, '$1 $2') // Remove all non-word characters and replace with a single space. .replace(NON_WORD_REGEXP, replace) // Lower case the entire string. return lowerCase(str, locale) }