si-funciona 2.3.3 → 2.4.0

package/dist/helpers/strings/makeRelativePath.d.ts

@@ -1,10 +1,10 @@
-/**
- * Compare two file paths and simplify them to a relative path.
- * @memberOf module:stringHelpers
- * @param {string} fromFile
- * @param {string} toFile
- * @return {string}
- */
-export declare const makeRelativePath: (fromFile: string, toFile: string) => string;
-export default makeRelativePath;
+/**
+ * Compare two file paths and simplify them to a relative path.
+ * @memberOf module:stringHelpers
+ * @param {string} fromFile - The path of the file the resulting relative path will be used from.
+ * @param {string} toFile - The path of the file being referenced.
+ * @return {string} `toFile` expressed relative to `fromFile`.
+ */
+export declare const makeRelativePath: (fromFile: string, toFile: string) => string;
+export default makeRelativePath;
 //# sourceMappingURL=makeRelativePath.d.ts.map

package/dist/helpers/strings/makeRelativePath.js

@@ -1,43 +1,43 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.makeRelativePath = exports.default = void 0
-var _strBefore = _interopRequireDefault(require('./strBefore'))
-var _strAfter = _interopRequireDefault(require('./strAfter'))
-function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
-/**
- * Compare two file paths and simplify them to a relative path.
- * @memberOf module:stringHelpers
- * @param {string} fromFile
- * @param {string} toFile
- * @return {string}
- */
-const makeRelativePath = (fromFile, toFile) => {
-  let relativePath = toFile
-  let nextPart = fromFile
-  let firstPart = (0, _strBefore.default)(nextPart, '/')
-  let hasMatches = false
-  while (firstPart && relativePath.startsWith(firstPart)) {
-    relativePath = (0, _strAfter.default)(relativePath, `${firstPart}/`)
-    nextPart = (0, _strAfter.default)(nextPart, `${firstPart}/`)
-    firstPart = (0, _strBefore.default)(nextPart, '/')
-    hasMatches = true
-  }
-  if (!hasMatches) {
-    // No similar base paths, use the path as-is
-    return relativePath
-  }
-  let relativePrefix = ''
-  const nextParts = nextPart.split('/')
-  if (nextParts.length < 2) {
-    relativePrefix = './'
-  }
-  for (let i = 1; i < nextParts.length; ++i) {
-    relativePrefix += '../'
-  }
-  return relativePrefix + relativePath
-}
-exports.makeRelativePath = makeRelativePath
-var _default = exports.default = makeRelativePath
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.makeRelativePath = exports.default = void 0
+var _strBefore = _interopRequireDefault(require('./strBefore'))
+var _strAfter = _interopRequireDefault(require('./strAfter'))
+function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
+/**
+ * Compare two file paths and simplify them to a relative path.
+ * @memberOf module:stringHelpers
+ * @param {string} fromFile - The path of the file the resulting relative path will be used from.
+ * @param {string} toFile - The path of the file being referenced.
+ * @return {string} `toFile` expressed relative to `fromFile`.
+ */
+const makeRelativePath = (fromFile, toFile) => {
+  let relativePath = toFile
+  let nextPart = fromFile
+  let firstPart = (0, _strBefore.default)(nextPart, '/')
+  let hasMatches = false
+  while (firstPart && relativePath.startsWith(firstPart)) {
+    relativePath = (0, _strAfter.default)(relativePath, `${firstPart}/`)
+    nextPart = (0, _strAfter.default)(nextPart, `${firstPart}/`)
+    firstPart = (0, _strBefore.default)(nextPart, '/')
+    hasMatches = true
+  }
+  if (!hasMatches) {
+    // No similar base paths, use the path as-is
+    return relativePath
+  }
+  let relativePrefix = ''
+  const nextParts = nextPart.split('/')
+  if (nextParts.length < 2) {
+    relativePrefix = './'
+  }
+  for (let i = 1; i < nextParts.length; ++i) {
+    relativePrefix += '../'
+  }
+  return relativePrefix + relativePath
+}
+exports.makeRelativePath = makeRelativePath
+var _default = exports.default = makeRelativePath

package/dist/helpers/strings/regexEscape.d.ts

@@ -1,9 +1,9 @@
-/**
- * Take a string and escape the regex characters.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @returns {string}
- */
-export declare const regexEscape: (str: string) => string;
-export default regexEscape;
+/**
+ * Take a string and escape the regex characters.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to escape, so it can be used literally inside a `RegExp`.
+ * @returns {string}
+ */
+export declare const regexEscape: (str: string) => string;
+export default regexEscape;
 //# sourceMappingURL=regexEscape.d.ts.map

package/dist/helpers/strings/regexEscape.js

@@ -1,15 +1,15 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.regexEscape = exports.default = void 0
-/**
- * Take a string and escape the regex characters.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @returns {string}
- */
-const regexEscape = str => str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
-exports.regexEscape = regexEscape
-var _default = exports.default = regexEscape
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.regexEscape = exports.default = void 0
+/**
+ * Take a string and escape the regex characters.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to escape, so it can be used literally inside a `RegExp`.
+ * @returns {string}
+ */
+const regexEscape = str => str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+exports.regexEscape = regexEscape
+var _default = exports.default = regexEscape

package/dist/helpers/strings/snakeCase.d.ts

@@ -1,10 +1,10 @@
-import 'core-js/stable';
-/**
- * Given a string in kebab-case, camelCase or 'Sentence case', convert to snake_case.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @returns {string}
- */
-declare const snakeCase: (str: string) => string;
-export default snakeCase;
+import 'core-js/stable';
+/**
+ * Given a string in kebab-case, camelCase or 'Sentence case', convert to snake_case.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to convert.
+ * @returns {string}
+ */
+declare const snakeCase: (str: string) => string;
+export default snakeCase;
 //# sourceMappingURL=snakeCase.d.ts.map

package/dist/helpers/strings/snakeCase.js

@@ -1,19 +1,19 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/modules/esnext.iterator.constructor.js')
-require('core-js/modules/esnext.iterator.reduce.js')
-require('core-js/stable')
-var _words = _interopRequireDefault(require('./words'))
-function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
-/**
- * Given a string in kebab-case, camelCase or 'Sentence case', convert to snake_case.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @returns {string}
- */
-const snakeCase = str => (0, _words.default)(str).reduce((snake, part) => snake ? snake.concat('_' + part.toLowerCase()) : part.toLowerCase(), '')
-var _default = exports.default = snakeCase
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/modules/esnext.iterator.constructor.js')
+require('core-js/modules/esnext.iterator.reduce.js')
+require('core-js/stable')
+var _words = _interopRequireDefault(require('./words'))
+function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
+/**
+ * Given a string in kebab-case, camelCase or 'Sentence case', convert to snake_case.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to convert.
+ * @returns {string}
+ */
+const snakeCase = str => (0, _words.default)(str).reduce((snake, part) => snake ? snake.concat('_' + part.toLowerCase()) : part.toLowerCase(), '')
+var _default = exports.default = snakeCase

package/dist/helpers/strings/strAfter.d.ts

@@ -1,11 +1,11 @@
-import 'core-js/stable';
-/**
- * Retrieve the string part after the search match.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @param {string} search
- * @returns {string}
- */
-declare const strAfter: (str: string, search: string) => string;
-export default strAfter;
+import 'core-js/stable';
+/**
+ * Retrieve the string part after the search match.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to search within.
+ * @param {string} search - The substring to search for.
+ * @returns {string} The portion of `str` after the first occurrence of `search`, or `''` if not found.
+ */
+declare const strAfter: (str: string, search: string) => string;
+export default strAfter;
 //# sourceMappingURL=strAfter.d.ts.map

package/dist/helpers/strings/strAfter.js

@@ -1,19 +1,19 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/stable')
-/**
- * Retrieve the string part after the search match.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @param {string} search
- * @returns {string}
- */
-const strAfter = (str, search) => {
-  const index = str.indexOf(search)
-  return index === -1 ? '' : str.substring(index + search.length)
-}
-var _default = exports.default = strAfter
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/stable')
+/**
+ * Retrieve the string part after the search match.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to search within.
+ * @param {string} search - The substring to search for.
+ * @returns {string} The portion of `str` after the first occurrence of `search`, or `''` if not found.
+ */
+const strAfter = (str, search) => {
+  const index = str.indexOf(search)
+  return index === -1 ? '' : str.substring(index + search.length)
+}
+var _default = exports.default = strAfter

package/dist/helpers/strings/strAfterLast.d.ts

@@ -1,11 +1,11 @@
-import 'core-js/stable';
-/**
- * Retrieve the string part after the last search match.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @param {string} search
- * @returns {string}
- */
-declare const strAfterLast: (str: string, search: string) => string;
-export default strAfterLast;
+import 'core-js/stable';
+/**
+ * Retrieve the string part after the last search match.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to search within.
+ * @param {string} search - The substring to search for.
+ * @returns {string} The portion of `str` after the last occurrence of `search`, or `''` if not found.
+ */
+declare const strAfterLast: (str: string, search: string) => string;
+export default strAfterLast;
 //# sourceMappingURL=strAfterLast.d.ts.map

package/dist/helpers/strings/strAfterLast.js

@@ -1,19 +1,19 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/stable')
-/**
- * Retrieve the string part after the last search match.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @param {string} search
- * @returns {string}
- */
-const strAfterLast = (str, search) => {
-  const index = str.lastIndexOf(search)
-  return index === -1 ? '' : str.substring(index + search.length)
-}
-var _default = exports.default = strAfterLast
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/stable')
+/**
+ * Retrieve the string part after the last search match.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to search within.
+ * @param {string} search - The substring to search for.
+ * @returns {string} The portion of `str` after the last occurrence of `search`, or `''` if not found.
+ */
+const strAfterLast = (str, search) => {
+  const index = str.lastIndexOf(search)
+  return index === -1 ? '' : str.substring(index + search.length)
+}
+var _default = exports.default = strAfterLast

package/dist/helpers/strings/strBefore.d.ts

@@ -1,11 +1,11 @@
-import 'core-js/stable';
-/**
- * Retrieve the string part before the search match.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @param {string} search
- * @returns {string}
- */
-declare const strBefore: (str: string, search: string) => string;
-export default strBefore;
+import 'core-js/stable';
+/**
+ * Retrieve the string part before the search match.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to search within.
+ * @param {string} search - The substring to search for.
+ * @returns {string} The portion of `str` before the first occurrence of `search`, or `''` if not found.
+ */
+declare const strBefore: (str: string, search: string) => string;
+export default strBefore;
 //# sourceMappingURL=strBefore.d.ts.map

package/dist/helpers/strings/strBefore.js

@@ -1,19 +1,19 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/stable')
-/**
- * Retrieve the string part before the search match.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @param {string} search
- * @returns {string}
- */
-const strBefore = (str, search) => {
-  const index = str.indexOf(search)
-  return index === -1 ? '' : str.slice(0, index)
-}
-var _default = exports.default = strBefore
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/stable')
+/**
+ * Retrieve the string part before the search match.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to search within.
+ * @param {string} search - The substring to search for.
+ * @returns {string} The portion of `str` before the first occurrence of `search`, or `''` if not found.
+ */
+const strBefore = (str, search) => {
+  const index = str.indexOf(search)
+  return index === -1 ? '' : str.slice(0, index)
+}
+var _default = exports.default = strBefore

package/dist/helpers/strings/strBeforeLast.d.ts

@@ -1,11 +1,11 @@
-import 'core-js/stable';
-/**
- * Retrieve the string part after the last search match.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @param {string} search
- * @returns {string}
- */
-declare const strBeforeLast: (str: string, search: string) => string;
-export default strBeforeLast;
+import 'core-js/stable';
+/**
+ * Retrieve the string part before the last search match.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to search within.
+ * @param {string} search - The substring to search for.
+ * @returns {string} The portion of `str` before the last occurrence of `search`, or `''` if not found.
+ */
+declare const strBeforeLast: (str: string, search: string) => string;
+export default strBeforeLast;
 //# sourceMappingURL=strBeforeLast.d.ts.map

package/dist/helpers/strings/strBeforeLast.js

@@ -1,19 +1,19 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/stable')
-/**
- * Retrieve the string part after the last search match.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @param {string} search
- * @returns {string}
- */
-const strBeforeLast = (str, search) => {
-  const index = str.lastIndexOf(search)
-  return index === -1 ? '' : str.substring(0, index)
-}
-var _default = exports.default = strBeforeLast
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/stable')
+/**
+ * Retrieve the string part before the last search match.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to search within.
+ * @param {string} search - The substring to search for.
+ * @returns {string} The portion of `str` before the last occurrence of `search`, or `''` if not found.
+ */
+const strBeforeLast = (str, search) => {
+  const index = str.lastIndexOf(search)
+  return index === -1 ? '' : str.substring(0, index)
+}
+var _default = exports.default = strBeforeLast

package/dist/helpers/strings/titleCase.d.ts

@@ -1,10 +1,10 @@
-import 'core-js/stable';
-/**
- * Given a string in kebab-case, snake_case, camelCase or 'Sentence case', convert to 'Title Case'.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @returns {string}
- */
-declare const titleCase: (str: string) => string;
-export default titleCase;
+import 'core-js/stable';
+/**
+ * Given a string in kebab-case, snake_case, camelCase or 'Sentence case', convert to 'Title Case'.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to convert.
+ * @returns {string}
+ */
+declare const titleCase: (str: string) => string;
+export default titleCase;
 //# sourceMappingURL=titleCase.d.ts.map

package/dist/helpers/strings/titleCase.js

@@ -1,20 +1,20 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/modules/esnext.iterator.constructor.js')
-require('core-js/modules/esnext.iterator.reduce.js')
-require('core-js/stable')
-var _ucFirst = _interopRequireDefault(require('./ucFirst'))
-var _words = _interopRequireDefault(require('./words'))
-function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
-/**
- * Given a string in kebab-case, snake_case, camelCase or 'Sentence case', convert to 'Title Case'.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @returns {string}
- */
-const titleCase = str => (0, _words.default)(str).reduce((title, part) => title ? title.concat(' ' + (0, _ucFirst.default)(part)) : (0, _ucFirst.default)(part), '')
-var _default = exports.default = titleCase
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/modules/esnext.iterator.constructor.js')
+require('core-js/modules/esnext.iterator.reduce.js')
+require('core-js/stable')
+var _ucFirst = _interopRequireDefault(require('./ucFirst'))
+var _words = _interopRequireDefault(require('./words'))
+function _interopRequireDefault (e) { return e && e.__esModule ? e : { default: e } }
+/**
+ * Given a string in kebab-case, snake_case, camelCase or 'Sentence case', convert to 'Title Case'.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to convert.
+ * @returns {string}
+ */
+const titleCase = str => (0, _words.default)(str).reduce((title, part) => title ? title.concat(' ' + (0, _ucFirst.default)(part)) : (0, _ucFirst.default)(part), '')
+var _default = exports.default = titleCase

package/dist/helpers/strings/ucFirst.d.ts

@@ -1,10 +1,10 @@
-import 'core-js/stable';
-/**
- * Given a string, make the first character uppercase and the rest lowercase.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @returns {string}
- */
-declare const ucFirst: (str: string) => string;
-export default ucFirst;
+import 'core-js/stable';
+/**
+ * Given a string, make the first character uppercase and the rest lowercase.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to convert.
+ * @returns {string}
+ */
+declare const ucFirst: (str: string) => string;
+export default ucFirst;
 //# sourceMappingURL=ucFirst.d.ts.map

package/dist/helpers/strings/ucFirst.js

@@ -1,15 +1,15 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/stable')
-/**
- * Given a string, make the first character uppercase and the rest lowercase.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @returns {string}
- */
-const ucFirst = str => str.charAt(0).toUpperCase() + str.slice(1).toLowerCase()
-var _default = exports.default = ucFirst
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/stable')
+/**
+ * Given a string, make the first character uppercase and the rest lowercase.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to convert.
+ * @returns {string}
+ */
+const ucFirst = str => str.charAt(0).toUpperCase() + str.slice(1).toLowerCase()
+var _default = exports.default = ucFirst

package/dist/helpers/strings/words.d.ts

@@ -1,10 +1,11 @@
-import 'core-js/stable';
-/**
- * Split a string into sets of numbers or letters.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @returns {array}
- */
-declare const words: (str: string) => Array<string>;
-export default words;
+import 'core-js/stable';
+/**
+ * Split a string into sets of numbers or letters - the shared tokenizer behind camelCase/kabobCase/snakeCase/
+ * titleCase, so each can rebuild the string in its own casing style.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to split.
+ * @returns {Array.<string>}
+ */
+declare const words: (str: string) => Array<string>;
+export default words;
 //# sourceMappingURL=words.d.ts.map

package/dist/helpers/strings/words.js

@@ -1,15 +1,16 @@
-'use strict'
-
-Object.defineProperty(exports, '__esModule', {
-  value: true
-})
-exports.default = void 0
-require('core-js/stable')
-/**
- * Split a string into sets of numbers or letters.
- * @memberOf module:stringHelpers
- * @param {string} str
- * @returns {array}
- */
-const words = str => str.match(/\d+|[A-Z]?[a-z]+|[A-Za-z]+/g)
-var _default = exports.default = words
+'use strict'
+
+Object.defineProperty(exports, '__esModule', {
+  value: true
+})
+exports.default = void 0
+require('core-js/stable')
+/**
+ * Split a string into sets of numbers or letters - the shared tokenizer behind camelCase/kabobCase/snakeCase/
+ * titleCase, so each can rebuild the string in its own casing style.
+ * @memberOf module:stringHelpers
+ * @param {string} str - The string to split.
+ * @returns {Array.<string>}
+ */
+const words = str => str.match(/\d+|[A-Z]?[a-z]+|[A-Za-z]+/g)
+var _default = exports.default = words