@papillonarts/library 0.38.0 → 0.40.0

package/build/number/__tests__/Number.doc.mdx

@@ -0,0 +1,9 @@
+import { Canvas, Meta } from '@storybook/addon-docs/blocks'
+
+import * as NumberStories from './Number.story'
+
+<Meta of={NumberStories} />
+
+# Number
+
+<Canvas of={NumberStories.Features} />

package/build/object/__tests__/Object.doc.mdx

@@ -0,0 +1,9 @@
+import { Canvas, Meta } from '@storybook/addon-docs/blocks'
+
+import * as ObjectStories from './Object.story'
+
+<Meta of={ObjectStories} />
+
+# Object
+
+<Canvas of={ObjectStories.Features} />

package/build/pagination/__tests__/Pagination.library.doc.mdx

@@ -0,0 +1,9 @@
+import { Canvas, Meta } from '@storybook/addon-docs/blocks'
+
+import * as PaginationStories from './Pagination.library.story'
+
+<Meta of={PaginationStories} />
+
+# Pagination
+
+<Canvas of={PaginationStories.Features} />

package/build/sort/__tests__/Sort.doc.mdx

@@ -0,0 +1,9 @@
+import { Canvas, Meta } from '@storybook/addon-docs/blocks'
+
+import * as SortStories from './Sort.story'
+
+<Meta of={SortStories} />
+
+# Sort
+
+<Canvas of={SortStories.Features} />

package/build/store/__tests__/Store.doc.mdx

@@ -0,0 +1,9 @@
+import { Canvas, Meta } from '@storybook/addon-docs/blocks'
+
+import * as StoreStories from './Store.story'
+
+<Meta of={StoreStories} />
+
+# Store
+
+<Canvas of={StoreStories.Features} />

package/build/store/index.d.ts

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

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

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

package/build/store/index.js

@@ -1,12 +1,14 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-Object.defineProperty(exports, "getAppMockStore", {
-  enumerable: true,
-  get: function get() {
-    return _mock.getAppMockStore;
-  }
-});
-var _mock = require("./mock");
+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);
+}

package/build/string/__tests__/String.doc.mdx

@@ -0,0 +1,9 @@
+import { Canvas, Meta } from '@storybook/addon-docs/blocks'
+
+import * as StringStories from './String.story'
+
+<Meta of={StringStories} />
+
+# String
+
+<Canvas of={StringStories.Features} />

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.38.0",
+  "version": "0.40.0",
   "description": "Papillon Arts Library",
   "homepage": "https://github.com/papillonarts/papillonarts/tree/master/packages/library",
   "repository": {
@@ -23,7 +23,6 @@
     "./browser": "./build/browser/index.js",
     "./date": "./build/date/index.js",
     "./event": "./build/event/index.js",
-    "./hooks": "./build/hooks/index.js",
     "./number": "./build/number/index.js",
     "./object": "./build/object/index.js",
     "./pagination": "./build/pagination/index.js",
@@ -44,5 +43,5 @@
     "build-acceptance": "npm run build",
     "build-release": "npm run build"
   },
-  "gitHead": "af44ef015fbdee8b28e2dfbe647d8587e4307ce6"
+  "gitHead": "7a19d357d33591ad460a6cb42f18963082beffd8"
 }

package/build/a11y/__tests__/__snapshots__/A11y.test.ts.snap

@@ -1,129 +0,0 @@
-// Jest Snapshot v1, https://jestjs.io/docs/snapshot-testing
-
-exports[`<Array /> Render must match checkAccessibilityIssues() 1`] = `
-<div>
-  <pre
-    style="display: block; overflow-x: auto; background: rgb(43, 48, 59); color: rgb(192, 197, 206); padding: 0.5em;"
-  >
-    <code
-      class="language-typescript"
-      style="white-space: pre;"
-    >
-      <span>
-        
-
-      </span>
-      <span>
-          
-      </span>
-      <span
-        style="color: rgb(180, 142, 173);"
-      >
-        export
-      </span>
-      <span>
-         
-      </span>
-      <span
-        class="hljs-function"
-        style="color: rgb(180, 142, 173);"
-      >
-        function
-      </span>
-      <span
-        class="hljs-function"
-      >
-         
-      </span>
-      <span
-        class="hljs-function"
-        style="color: rgb(143, 161, 179);"
-      >
-        checkAccessibilityIssues
-      </span>
-      <span
-        class="hljs-function"
-      >
-        (
-      </span>
-      <span
-        class="hljs-function"
-        style="color: rgb(208, 135, 112);"
-      >
-        react, reactDOM, delay
-      </span>
-      <span
-        class="hljs-function"
-      >
-        ) 
-      </span>
-      <span>
-        {
-
-      </span>
-      <span>
-            
-      </span>
-      <span
-        style="color: rgb(180, 142, 173);"
-      >
-        if
-      </span>
-      <span>
-         (process.env.NODE_ENV !== 
-      </span>
-      <span
-        style="color: rgb(163, 190, 140);"
-      >
-        'production'
-      </span>
-      <span>
-        ) {
-
-      </span>
-      <span>
-              
-      </span>
-      <span
-        style="color: rgb(180, 142, 173);"
-      >
-        const
-      </span>
-      <span>
-         axe = 
-      </span>
-      <span
-        style="color: rgb(208, 135, 112);"
-      >
-        require
-      </span>
-      <span>
-        (
-      </span>
-      <span
-        style="color: rgb(163, 190, 140);"
-      >
-        '@axe-core/react'
-      </span>
-      <span>
-        )
-
-      </span>
-            axe(react, reactDOM, delay)
-
-          }
-
-        }
-
-    </code>
-  </pre>
-</div>
-`;
-
-exports[`<Array /> Render must match features() 1`] = `
-<div>
-  <p>
-    mock-file
-  </p>
-</div>
-`;