art-standard-lib/source/Art.StandardLib/Core/StringCase.coffee

The Standard Library for JavaScript that aught to be.

{compactFlatten} = require './ArrayCompactFlatten'
{isArray, isString} = require './Types'
module.exports = class StringCase

  findWordsRegExp = /[a-zA-Z][a-zA-Z0-9]*|[0-9]+/g
  findCapStartWordsRegExp = /(?:[A-Z]{2,}(?![a-z]))|[A-Z][a-z0-9]*|[a-z0-9]+/g
  ### getCodeWords
    INv1: <String>
    INv2: <Array* <String>>
    OUT: <Array <String>>
  ###
  @getCodeWords: getCodeWords = (str) ->
    compactFlatten(
      if isArray str
        str
      else if isString(str) && findWordsRegExp.test str
        for word in str.match findWordsRegExp
          word.match findCapStartWordsRegExp
      else []
    )

  @codeWords: getCodeWords

  @lowerCase: (str) -> str?.toLocaleLowerCase()
  @upperCase: (str) -> str?.toLocaleUpperCase()

  @capitalize:   (str) => @upperCase(str.charAt 0) + str.slice 1
  @decapitalize: (str) => @lowerCase(str.charAt 0) + str.slice 1

  @getLowerCaseCodeWords:   (str) =>                @lowerCase word for word in @getCodeWords str
  @getUpperCaseCodeWords:   (str) =>                @upperCase word for word in @getCodeWords str
  @getCapitalizedCodeWords: (str) =>                @capitalize @lowerCase word for word in @getCodeWords str

  @upperCamelCase:          (str, joiner = "")  =>  (@capitalize word for word in @getLowerCaseCodeWords str).join joiner
  @lowerCamelCase:          (str, joiner = "")  =>  @decapitalize @upperCamelCase str, joiner

  @snakeCase:               (str, joiner = "_") =>  (@getLowerCaseCodeWords str).join joiner
  @upperSnakeCase:          (str, joiner = "_") =>  (@getUpperCaseCodeWords str).join joiner

  @dashCase:                (str, joiner = "-") =>  (@getLowerCaseCodeWords str).join joiner

  @capitalizedDashCase:     (str, joiner = "-") =>  (@getCapitalizedCodeWords str).join joiner