@papillonarts/library 0.39.0 → 0.41.0

package/build/string/index.d.ts

@@ -1,8 +1,67 @@
-export declare function getCapizalizedString({ string, separator }: {
-    string: string;
-    separator: string;
+/**
+ * Capitalize the first character of each segment in a string split by a separator.
+ *
+ * Splits the input string by the specified separator, trims whitespace from each segment,
+ * filters out empty segments, capitalizes the first character of each remaining segment,
+ * and joins them with spaces.
+ *
+ * @param {Object} params - Function parameters
+ * @param {string} [params.input] - The string to capitalize. Accepts undefined or empty strings, which return an empty string.
+ * @param {string} [params.separator='-'] - The delimiter to split segments. Defaults to hyphen.
+ * @returns {string} Capitalized string with segments joined by spaces, or empty string if input is falsy/empty.
+ *
+ * @example
+ * getCapitalizedString({ input: 'hello-world', separator: '-' })
+ * // => 'Hello World'
+ *
+ * @example
+ * getCapitalizedString({ input: '  foo - bar  ', separator: '-' })
+ * // => 'Foo Bar'
+ *
+ * @example
+ * getCapitalizedString({ input: undefined })
+ * // => ''
+ */
+export declare function getCapitalizedString({ input, separator }: {
+    input?: string;
+    separator?: string;
 }): string;
+/**
+ * Generate a random alphanumeric string using base-36 encoding.
+ *
+ * Uses `Math.random()` (non-cryptographic) to produce a lowercase alphanumeric string.
+ * String length is variable (~11 characters typical, but not guaranteed).
+ *
+ * @returns {string} A random alphanumeric string with letters (a-z) and digits (0-9).
+ *
+ * @example
+ * getRandomAlphanumericString()
+ * // => '4feornbt361' (example output, varies each call)
+ *
+ * @note For cryptographic purposes, use `crypto.getRandomValues()` or `crypto.randomUUID()` instead.
+ */
 export declare function getRandomAlphanumericString(): string;
+/**
+ * Generate a random alphanumeric string of a specific length.
+ *
+ * Creates a string of the requested length using characters from the alphanumeric set
+ * (A-Z, a-z, 0-9). Uses `Math.random()` for character selection (non-cryptographic).
+ *
+ * @param {Object} params - Function parameters
+ * @param {number} params.length - Desired string length. Must be a non-negative integer.
+ * @returns {string} A random alphanumeric string of exactly the specified length, or empty string if length is 0.
+ * @throws {TypeError} If length is not a non-negative integer.
+ *
+ * @example
+ * getRandomAlphanumericStringByLength({ length: 8 })
+ * // => 'aB3xYz9W' (example output, varies each call)
+ *
+ * @example
+ * getRandomAlphanumericStringByLength({ length: 0 })
+ * // => ''
+ *
+ * @note For cryptographic purposes, use `crypto.getRandomValues()` instead.
+ */
 export declare function getRandomAlphanumericStringByLength({ length }: {
     length: number;
 }): string;

package/build/string/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAAC,EAAE,MAAM,EAAE,SAAe,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAK/G;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED,wBAAgB,mCAAmC,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAO1F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,SAAe,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAS/G;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mCAAmC,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAY1F"}

package/build/string/index.js

@@ -3,26 +3,96 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.getCapizalizedString = getCapizalizedString;
+exports.getCapitalizedString = getCapitalizedString;
 exports.getRandomAlphanumericString = getRandomAlphanumericString;
 exports.getRandomAlphanumericStringByLength = getRandomAlphanumericStringByLength;
-function getCapizalizedString(_ref) {
-  var string = _ref.string,
+/**
+ * Capitalize the first character of each segment in a string split by a separator.
+ *
+ * Splits the input string by the specified separator, trims whitespace from each segment,
+ * filters out empty segments, capitalizes the first character of each remaining segment,
+ * and joins them with spaces.
+ *
+ * @param {Object} params - Function parameters
+ * @param {string} [params.input] - The string to capitalize. Accepts undefined or empty strings, which return an empty string.
+ * @param {string} [params.separator='-'] - The delimiter to split segments. Defaults to hyphen.
+ * @returns {string} Capitalized string with segments joined by spaces, or empty string if input is falsy/empty.
+ *
+ * @example
+ * getCapitalizedString({ input: 'hello-world', separator: '-' })
+ * // => 'Hello World'
+ *
+ * @example
+ * getCapitalizedString({ input: '  foo - bar  ', separator: '-' })
+ * // => 'Foo Bar'
+ *
+ * @example
+ * getCapitalizedString({ input: undefined })
+ * // => ''
+ */
+function getCapitalizedString(_ref) {
+  var input = _ref.input,
     _ref$separator = _ref.separator,
     separator = _ref$separator === void 0 ? '-' : _ref$separator;
-  var splitted = string.split(separator);
-  var capitalized = splitted.map(function (splittedItem) {
-    return "".concat(splittedItem.charAt(0).toUpperCase()).concat(splittedItem.slice(1));
-  });
-  return capitalized.join(' ');
+  if (typeof input !== 'string' || input.length === 0) return '';
+  var parts = input.split(separator).map(function (p) {
+    return p.trim();
+  }).filter(Boolean);
+  if (parts.length === 0) return '';
+  return parts.map(function (part) {
+    return "".concat(part.charAt(0).toUpperCase()).concat(part.slice(1));
+  }).join(' ');
 }
+
+/**
+ * Generate a random alphanumeric string using base-36 encoding.
+ *
+ * Uses `Math.random()` (non-cryptographic) to produce a lowercase alphanumeric string.
+ * String length is variable (~11 characters typical, but not guaranteed).
+ *
+ * @returns {string} A random alphanumeric string with letters (a-z) and digits (0-9).
+ *
+ * @example
+ * getRandomAlphanumericString()
+ * // => '4feornbt361' (example output, varies each call)
+ *
+ * @note For cryptographic purposes, use `crypto.getRandomValues()` or `crypto.randomUUID()` instead.
+ */
 function getRandomAlphanumericString() {
   return Math.random().toString(36).slice(2);
 }
+var ALPHANUMERIC_CHARACTERS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+
+/**
+ * Generate a random alphanumeric string of a specific length.
+ *
+ * Creates a string of the requested length using characters from the alphanumeric set
+ * (A-Z, a-z, 0-9). Uses `Math.random()` for character selection (non-cryptographic).
+ *
+ * @param {Object} params - Function parameters
+ * @param {number} params.length - Desired string length. Must be a non-negative integer.
+ * @returns {string} A random alphanumeric string of exactly the specified length, or empty string if length is 0.
+ * @throws {TypeError} If length is not a non-negative integer.
+ *
+ * @example
+ * getRandomAlphanumericStringByLength({ length: 8 })
+ * // => 'aB3xYz9W' (example output, varies each call)
+ *
+ * @example
+ * getRandomAlphanumericStringByLength({ length: 0 })
+ * // => ''
+ *
+ * @note For cryptographic purposes, use `crypto.getRandomValues()` instead.
+ */
 function getRandomAlphanumericStringByLength(_ref2) {
   var length = _ref2.length;
-  var randomAlphanumericString = '';
-  var characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
-  for (var i = 0; i < length; i += 1) randomAlphanumericString += characters.charAt(Math.floor(Math.random() * characters.length));
-  return randomAlphanumericString !== '' ? randomAlphanumericString : getRandomAlphanumericString();
+  var n = Number(length);
+  if (!Number.isInteger(n) || n < 0) throw new TypeError('length must be a non-negative integer');
+  if (n === 0) return '';
+  var result = '';
+  var charsLen = ALPHANUMERIC_CHARACTERS.length;
+  for (var i = 0; i < n; i += 1) {
+    result += ALPHANUMERIC_CHARACTERS.charAt(Math.floor(Math.random() * charsLen));
+  }
+  return result;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@papillonarts/library",
-  "version": "0.39.0",
+  "version": "0.41.0",
   "description": "Papillon Arts Library",
   "homepage": "https://github.com/papillonarts/papillonarts/tree/master/packages/library",
   "repository": {
@@ -43,5 +43,5 @@
     "build-acceptance": "npm run build",
     "build-release": "npm run build"
   },
-  "gitHead": "b8f07f71414d7133bc1cfa967ecf30ebca383ef7"
+  "gitHead": "38632df415e9a45e174ea18880ce31b17f8ae2e5"
 }

package/build/store/mock/index.d.ts

@@ -1,2 +0,0 @@
-export declare function getAppMockStore(customAppState: any): any;
-//# sourceMappingURL=index.d.ts.map

package/build/store/mock/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/store/mock/index.ts"],"names":[],"mappings":"AAIA,wBAAgB,eAAe,CAAC,cAAc,KAAA,OAE7C"}

package/build/store/mock/index.js

@@ -1,14 +0,0 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getAppMockStore = getAppMockStore;
-var _reduxMockStore = _interopRequireDefault(require("redux-mock-store"));
-var _reduxThunk = require("redux-thunk");
-/* eslint-disable import-x/no-named-as-default */
-
-function getAppMockStore(customAppState) {
-  return (0, _reduxMockStore["default"])([_reduxThunk.thunk])(customAppState);
-}