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