| 1 | /**
|
| 2 | * Convert string into sentence case.
|
| 3 | * First letter capped and each punctuations are joined with space.
|
| 4 | * @memberof module:stringcase/lib
|
| 5 | * @function sentencecase
|
| 6 | * @param {string} str - String to convert.
|
| 7 | * @returns {string} Sentence cased string.
|
| 8 | */
|
| 9 |
|
| 10 |
|
| 11 |
|
| 12 | const lowercase = require('./lowercase')
|
| 13 | const trimcase = require('./trimcase')
|
| 14 | const snakecase = require('./snakecase')
|
| 15 | const capitalcase = require('./capitalcase')
|
| 16 |
|
| 17 | const JOINER = ' '
|
| 18 |
|
| 19 | /** @lends sentencecase*/
|
| 20 | function sentencecase (str) {
|
| 21 | str = String(str).replace(/^[\-_\.\s]/g, JOINER)
|
| 22 | if (!str) {
|
| 23 | return str
|
| 24 | }
|
| 25 | return capitalcase(snakecase(trimcase(str)).replace(/_/g, JOINER))
|
| 26 | }
|
| 27 |
|
| 28 | module.exports = sentencecase
|