@x15ventures/x15-ui-library 3.15.0 → 3.15.1

package/dist/esm/helpers/stringHelpers.js

@@ -32,6 +32,50 @@ export const capitalizeFirstLetter = pString => `${pString.substring(0, 1).toUpp
  */
 export const lowerCaseFirstLetter = pString => `${pString.substring(0, 1).toLowerCase()}${pString.substring(1)}`;
 
+/**
+ * Splits a string into grapheme clusters so text metrics and clamping can share
+ * the same segmentation logic without forcing callers to pass pre-segmented data.
+ *
+ * @param {string} pString - The string to segment.
+ * @returns {string[]} The grapheme units in order, falling back to code points when Intl.Segmenter is unavailable.
+ */
+const getGraphemeSegments = pString => {
+  if (typeof Intl !== 'undefined' && 'Segmenter' in Intl) {
+    const segmenter = new Intl.Segmenter(undefined, {
+      granularity: 'grapheme'
+    });
+    return Array.from(segmenter.segment(pString), ({
+      segment
+    }) => segment);
+  }
+  return Array.from(pString);
+};
+
+/**
+ * Counts user-perceived characters (grapheme clusters) so emojis and composed
+ * characters such as accented letters count as one.
+ *
+ * @param {string} pString - A string of text.
+ * @returns {number} The number of grapheme clusters, falling back to code points where Intl.Segmenter is unavailable.
+ */
+export const getCharacterCount = pString => getGraphemeSegments(pString).length;
+
+/**
+ * Truncates a string to a maximum number of grapheme clusters without splitting
+ * an emoji or composed character in half.
+ *
+ * @param {string} pString - A string of text.
+ * @param {number} maxAllowed - The maximum number of user-perceived characters to keep.
+ * @returns {string} The truncated string, or the unchanged pString if it is already within the limit.
+ */
+export const clampToGraphemeMax = (pString, maxAllowed) => {
+  const graphemeSegments = getGraphemeSegments(pString);
+  if (graphemeSegments.length <= maxAllowed) {
+    return pString;
+  }
+  return graphemeSegments.slice(0, maxAllowed).join('');
+};
+
 /**
  * Determines if "an" should be used instead of "a" before the given word.
  *

package/dist/esm/helpers/stringHelpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"stringHelpers.js","names":["parse","richTextParser","richText","supportEscapedCharacters","adjustedText","split","join","capitalize","pString","substring","toUpperCase","toLowerCase","capitalizeFirstLetter","lowerCaseFirstLetter","useAnInsteadOfA","word","lettersRequiringAn","firstLetter","includes","splitCamelCase","replace","pluralize","endsWith","slice","pluralizeIfNeeded","count","getInitialsOrAcronym","map","piece"],"sources":["../../../src/helpers/stringHelpers.ts"],"sourcesContent":["import React from 'react';\nimport parse from 'html-react-parser';\n\nexport const richTextParser = (richText: string, supportEscapedCharacters: boolean): string | React.JSX.Element | React.JSX.Element[] => {\n  // Adjusts text to replace line breaks with <br/> tags\n  const adjustedText = richText.split('\\r\\n').join('<br/>');\n  if (supportEscapedCharacters) {\n    return parse(adjustedText);\n  }\n  return parse(richText);\n};\n\n/**\n * Takes a string and returns it with the first character capitalized and the remaining characters as lowercase.\n *\n * @param {string} pString - A string of text.\n * @returns {string} The capitalized string or the unchanged pString if anything other than a string is sent to it.\n */\nexport const capitalize = (pString: string): string => `${ pString.substring(0, 1).toUpperCase() }${ pString.substring(1).toLowerCase() }`;\n\n/**\n * Capitalizes the first letter of the given string.\n *\n * @param {string} pString - A string of text.\n * @returns {string} The string with the first letter capitalized, or the unchanged pString if it's not a string.\n */\nexport const capitalizeFirstLetter = (pString: string): string => `${ pString.substring(0, 1).toUpperCase() }${ pString.substring(1) }`;\n\n/**\n * Converts the first letter of the given string to lowercase.\n *\n * @param {string} pString - A string of text.\n * @returns {string} The string with the first letter converted to lowercase, or the unchanged pString if it's not a string.\n */\nexport const lowerCaseFirstLetter = (pString: string): string => `${ pString.substring(0, 1).toLowerCase() }${ pString.substring(1) }`;\n\n/**\n * Determines if \"an\" should be used instead of \"a\" before the given word.\n *\n * @param {string} word - The word to check.\n * @returns {boolean} True if \"an\" should be used, false otherwise.\n */\nexport const useAnInsteadOfA = (word: string): boolean => {\n  const lettersRequiringAn = ['a', 'e', 'i', 'o', 'u', 'h'];\n  const firstLetter = word.substring(0, 1).toLowerCase();\n  return lettersRequiringAn.includes(firstLetter);\n};\n\nexport const splitCamelCase = (pString: string): string => pString\n// Single regex to handle all cases: lowercase followed by uppercase/number, or number followed by letter\n  .replace(/([a-z])([A-Z0-9])|([0-9])([a-zA-Z])/g, '$1$3 $2$4')\n// Insert a space between capital letters and lowercase letters where missing\n  .replace(/([A-Z])([A-Z][a-z])/g, '$1 $2')\n// Convert the entire string to lowercase for consistency\n  .toLowerCase();\n\nexport const pluralize = (pString: string): string => {\n  if (pString.endsWith('y')) {\n    // If the word ends with 'y', replace 'y' with 'ies'\n    return `${ pString.slice(0, -1) }ies`;\n  } if (pString.endsWith('s') || pString.endsWith('x') || pString.endsWith('z') || pString.endsWith('ch') || pString.endsWith('sh')) {\n    // If the word ends with s, x, z, ch, or sh, add 'es'\n    return `${ pString }es`;\n  }\n  // For other cases, just add 's'\n  return `${ pString }s`;\n};\n\nexport const pluralizeIfNeeded = (pString: string, count: number): string => {\n  if (count && count > 1) {\n    return pluralize(pString);\n  }\n  return pString;\n};\n\nexport const getInitialsOrAcronym = (pString: string): string => {\n  return pString.split(' ').map((piece) => capitalize(piece.substring(0, 1))).join('');\n};\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"stringHelpers.js","names":["parse","richTextParser","richText","supportEscapedCharacters","adjustedText","split","join","capitalize","pString","substring","toUpperCase","toLowerCase","capitalizeFirstLetter","lowerCaseFirstLetter","getGraphemeSegments","Intl","segmenter","Segmenter","undefined","granularity","Array","from","segment","getCharacterCount","length","clampToGraphemeMax","maxAllowed","graphemeSegments","slice","useAnInsteadOfA","word","lettersRequiringAn","firstLetter","includes","splitCamelCase","replace","pluralize","endsWith","pluralizeIfNeeded","count","getInitialsOrAcronym","map","piece"],"sources":["../../../src/helpers/stringHelpers.ts"],"sourcesContent":["import React from 'react';\nimport parse from 'html-react-parser';\n\nexport const richTextParser = (richText: string, supportEscapedCharacters: boolean): string | React.JSX.Element | React.JSX.Element[] => {\n  // Adjusts text to replace line breaks with <br/> tags\n  const adjustedText = richText.split('\\r\\n').join('<br/>');\n  if (supportEscapedCharacters) {\n    return parse(adjustedText);\n  }\n  return parse(richText);\n};\n\n/**\n * Takes a string and returns it with the first character capitalized and the remaining characters as lowercase.\n *\n * @param {string} pString - A string of text.\n * @returns {string} The capitalized string or the unchanged pString if anything other than a string is sent to it.\n */\nexport const capitalize = (pString: string): string => `${ pString.substring(0, 1).toUpperCase() }${ pString.substring(1).toLowerCase() }`;\n\n/**\n * Capitalizes the first letter of the given string.\n *\n * @param {string} pString - A string of text.\n * @returns {string} The string with the first letter capitalized, or the unchanged pString if it's not a string.\n */\nexport const capitalizeFirstLetter = (pString: string): string => `${ pString.substring(0, 1).toUpperCase() }${ pString.substring(1) }`;\n\n/**\n * Converts the first letter of the given string to lowercase.\n *\n * @param {string} pString - A string of text.\n * @returns {string} The string with the first letter converted to lowercase, or the unchanged pString if it's not a string.\n */\nexport const lowerCaseFirstLetter = (pString: string): string => `${ pString.substring(0, 1).toLowerCase() }${ pString.substring(1) }`;\n\n/**\n * Splits a string into grapheme clusters so text metrics and clamping can share\n * the same segmentation logic without forcing callers to pass pre-segmented data.\n *\n * @param {string} pString - The string to segment.\n * @returns {string[]} The grapheme units in order, falling back to code points when Intl.Segmenter is unavailable.\n */\nconst getGraphemeSegments = (pString: string): string[] => {\n  if (typeof Intl !== 'undefined' && 'Segmenter' in Intl) {\n    const segmenter = new Intl.Segmenter(undefined, { granularity: 'grapheme' });\n\n    return Array.from(segmenter.segment(pString), ({ segment }) => segment);\n  }\n\n  return Array.from(pString);\n};\n\n/**\n * Counts user-perceived characters (grapheme clusters) so emojis and composed\n * characters such as accented letters count as one.\n *\n * @param {string} pString - A string of text.\n * @returns {number} The number of grapheme clusters, falling back to code points where Intl.Segmenter is unavailable.\n */\nexport const getCharacterCount = (pString: string): number => getGraphemeSegments(pString).length;\n\n/**\n * Truncates a string to a maximum number of grapheme clusters without splitting\n * an emoji or composed character in half.\n *\n * @param {string} pString - A string of text.\n * @param {number} maxAllowed - The maximum number of user-perceived characters to keep.\n * @returns {string} The truncated string, or the unchanged pString if it is already within the limit.\n */\nexport const clampToGraphemeMax = (pString: string, maxAllowed: number): string => {\n  const graphemeSegments = getGraphemeSegments(pString);\n\n  if (graphemeSegments.length <= maxAllowed) {\n    return pString;\n  }\n\n  return graphemeSegments.slice(0, maxAllowed).join('');\n};\n\n/**\n * Determines if \"an\" should be used instead of \"a\" before the given word.\n *\n * @param {string} word - The word to check.\n * @returns {boolean} True if \"an\" should be used, false otherwise.\n */\nexport const useAnInsteadOfA = (word: string): boolean => {\n  const lettersRequiringAn = ['a', 'e', 'i', 'o', 'u', 'h'];\n  const firstLetter = word.substring(0, 1).toLowerCase();\n  return lettersRequiringAn.includes(firstLetter);\n};\n\nexport const splitCamelCase = (pString: string): string => pString\n// Single regex to handle all cases: lowercase followed by uppercase/number, or number followed by letter\n  .replace(/([a-z])([A-Z0-9])|([0-9])([a-zA-Z])/g, '$1$3 $2$4')\n// Insert a space between capital letters and lowercase letters where missing\n  .replace(/([A-Z])([A-Z][a-z])/g, '$1 $2')\n// Convert the entire string to lowercase for consistency\n  .toLowerCase();\n\nexport const pluralize = (pString: string): string => {\n  if (pString.endsWith('y')) {\n    // If the word ends with 'y', replace 'y' with 'ies'\n    return `${ pString.slice(0, -1) }ies`;\n  } if (pString.endsWith('s') || pString.endsWith('x') || pString.endsWith('z') || pString.endsWith('ch') || pString.endsWith('sh')) {\n    // If the word ends with s, x, z, ch, or sh, add 'es'\n    return `${ pString }es`;\n  }\n  // For other cases, just add 's'\n  return `${ pString }s`;\n};\n\nexport const pluralizeIfNeeded = (pString: string, count: number): string => {\n  if (count && count > 1) {\n    return pluralize(pString);\n  }\n  return pString;\n};\n\nexport const getInitialsOrAcronym = (pString: string): string => {\n  return pString.split(' ').map((piece) => capitalize(piece.substring(0, 1))).join('');\n};\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/interfaces/headerText.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"headerText.interface.js","names":[],"sources":["../../../src/interfaces/headerText.interface.ts"],"sourcesContent":["import React from 'react';\nimport { NotificationIconProps } from '../components/design/icons/notificationIcon/NotificationIcon';\nimport { ButtonProps } from '../components/form/buttons/button.interface';\nimport { IconProps } from '../components/design/icons/basicIcon/Icon';\nimport { NotificationsButtonProps } from '../components/form/buttons/notificationsButton/NotificationsButton';\n\nexport type SimpleHeaderButton = ButtonProps & {\n  kind?: 'simple'\n};\n\nexport type NotificationsHeaderButton = Omit<NotificationsButtonProps, 'label'> & {\n  kind?: 'notifications'\n};\n\nexport type HeaderButtonTypes = SimpleHeaderButton | NotificationsHeaderButton;\n\nexport interface HeaderTextInterface {\n  leftIcon?: IconProps;\n  rightIcon?: IconProps;\n  text?: string;\n  notificationIcon?: NotificationIconProps;\n  buttons?: HeaderButtonTypes[];\n  children?: React.ReactNode;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"headerText.interface.js","names":[],"sources":["../../../src/interfaces/headerText.interface.ts"],"sourcesContent":["import React from 'react';\nimport { NotificationIconProps } from '../components/design/icons/notificationIcon/NotificationIcon';\nimport { ButtonProps } from '../components/form/buttons/button.interface';\nimport { IconProps } from '../components/design/icons/basicIcon/Icon';\nimport { NotificationsButtonProps } from '../components/form/buttons/notificationsButton/NotificationsButton';\n\nexport type SimpleHeaderButton = ButtonProps & {\n  kind?: 'simple'\n};\n\nexport type NotificationsHeaderButton = Omit<NotificationsButtonProps, 'label'> & {\n  kind?: 'notifications'\n};\n\nexport type HeaderButtonTypes = SimpleHeaderButton | NotificationsHeaderButton;\n\nexport interface HeaderTextInterface {\n  leftIcon?: IconProps;\n  rightIcon?: IconProps;\n  text?: string;\n  headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;\n  notificationIcon?: NotificationIconProps;\n  buttons?: HeaderButtonTypes[];\n  children?: React.ReactNode;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/esm/package.json

@@ -137,8 +137,23 @@
   "files": [
     "dist"
   ],
-  "version": "3.14.0",
-  "packageManager": "pnpm@10.11.0",
+  "version": "3.15.0",
+  "devEngines": {
+    "runtime": {
+      "name": "node",
+      "version": "24.15.0",
+      "onFail": "warn"
+    },
+    "packageManager": {
+      "name": "pnpm",
+      "version": "12.4.1",
+      "onFail": "warn"
+    }
+  },
+  "engines": {
+    "node": "24.15.0"
+  },
+  "packageManager": "pnpm@12.4.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/x15ventures/x15-ui-library.git"
@@ -173,162 +188,133 @@
     "storybook:build": "pnpm install --frozen-lockfile && pnpm build:cicd && storybook build --config-dir config/storybook/web --output-dir ./storybook-static"
   },
   "dependencies": {
-    "@hookform/error-message": "^2.0.1",
-    "@x15stack/aws": "^1.7.2",
-    "@x15ventures/x15-ui-library-icons": "^1.1.3",
-    "babel-plugin-transform-imports": "^2.0.0",
-    "html-react-parser": "^5.2.17",
-    "jsdom": "^26.1.0",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "react-helmet": "^6.1.0",
-    "react-hook-form": "^7.74.0",
-    "run-func": "^3.0.0",
-    "storybook": "^10.3.5",
-    "use-debounce": "^10.1.1"
+    "@x15ventures/x15-ui-library-icons": "1.1.3",
+    "babel-plugin-transform-imports": "2.0.0",
+    "html-react-parser": "5.2.17",
+    "jsdom": "26.1.0",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "react-helmet": "6.1.0",
+    "run-func": "3.0.0",
+    "storybook": "10.3.5",
+    "use-debounce": "10.1.1"
   },
   "peerDependencies": {
-    "core-js": "^3.44.0",
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0",
-    "storybook": "^10.1.10"
+    "core-js": "3.49.0",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "react-hook-form": "7.74.0",
+    "storybook": "10.3.5"
   },
   "devDependencies": {
-    "@babel/cli": "^7.28.6",
+    "@babel/cli": "7.28.6",
     "@babel/core": "7.29.6",
-    "@babel/eslint-parser": "^7.28.6",
-    "@babel/eslint-plugin": "^7.27.1",
-    "@babel/plugin-syntax-jsx": "^7.28.6",
-    "@babel/plugin-transform-class-properties": "^7.28.6",
-    "@babel/plugin-transform-modules-commonjs": "^7.28.6",
-    "@babel/plugin-transform-runtime": "^7.29.0",
-    "@babel/preset-env": "^7.29.2",
-    "@babel/preset-react": "^7.28.5",
-    "@babel/preset-typescript": "^7.28.5",
-    "@babel/runtime": "^7.29.2",
-    "@commitlint/cli": "^20.5.2",
-    "@commitlint/config-conventional": "^20.5.0",
-    "@eslint/js": "^9.39.4",
-    "@jest/globals": "^29.7.0",
-    "@jest/types": "^29.6.3",
-    "@mdx-js/mdx": "^3.1.1",
-    "@mdx-js/react": "^3.1.1",
-    "@rollup/plugin-commonjs": "^28.0.9",
-    "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-typescript": "^12.3.0",
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/commit-analyzer": "^13.0.1",
-    "@semantic-release/exec": "^7.1.0",
-    "@semantic-release/git": "^10.0.1",
-    "@semantic-release/npm": "^12.0.2",
-    "@semantic-release/release-notes-generator": "^14.1.0",
-    "@storybook/addon-a11y": "^10.3.5",
-    "@storybook/addon-docs": "^10.3.5",
-    "@storybook/addon-knobs": "^8.0.1",
-    "@storybook/addon-links": "^10.3.5",
-    "@storybook/addon-styling-webpack": "^1.0.1",
-    "@storybook/cli": "^10.3.5",
-    "@storybook/core-events": "^8.6.14",
-    "@storybook/manager-api": "^8.6.14",
-    "@storybook/mdx2-csf": "^1.1.0",
-    "@storybook/preset-scss": "^1.0.3",
-    "@storybook/preview-api": "^8.6.14",
-    "@storybook/react": "^10.3.5",
-    "@storybook/react-webpack5": "^10.3.5",
-    "@storybook/types": "^8.6.14",
-    "@testing-library/jest-dom": "^6.9.1",
-    "@testing-library/react": "^16.3.2",
-    "@testing-library/user-event": "^14.6.1",
-    "@types/enzyme": "^3.10.19",
-    "@types/enzyme-adapter-react-16": "^1.0.9",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^20.19.39",
-    "@types/react": "^18.3.28",
-    "@types/react-dom": "^18.3.7",
-    "@types/react-helmet": "^6.1.11",
-    "@types/webpack": "^5.28.5",
-    "@types/webpack-env": "^1.18.8",
-    "@typescript-eslint/eslint-plugin": "^8.59.1",
-    "@typescript-eslint/parser": "^8.59.1",
-    "@x15stack/aws": "^1.6.5",
-    "autoprefixer": "^10.5.0",
-    "babel-jest": "^30.3.0",
-    "babel-loader": "^9.2.1",
-    "babel-plugin-macros": "^3.1.0",
-    "chromatic": "^11.29.0",
-    "commitlint": "^20.5.3",
-    "copy-webpack-plugin": "^12.0.2",
-    "cors": "^2.8.6",
-    "cross-env": "^7.0.3",
-    "css-loader": "^7.1.4",
-    "enzyme": "^3.11.0",
-    "enzyme-adapter-react-16": "^1.15.8",
-    "esbuild": "^0.25.12",
-    "esbuild-sass-plugin": "^3.7.0",
-    "eslint": "^9.39.4",
-    "eslint-import-resolver-typescript": "^3.10.1",
-    "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jest": "^28.14.0",
-    "eslint-plugin-jsx-a11y": "^6.10.2",
-    "eslint-plugin-react": "^7.37.5",
+    "@babel/eslint-parser": "7.28.6",
+    "@babel/eslint-plugin": "7.27.1",
+    "@babel/plugin-syntax-jsx": "7.28.6",
+    "@babel/plugin-transform-class-properties": "7.28.6",
+    "@babel/plugin-transform-modules-commonjs": "7.28.6",
+    "@babel/plugin-transform-runtime": "7.29.0",
+    "@babel/preset-env": "7.29.2",
+    "@babel/preset-react": "7.28.5",
+    "@babel/preset-typescript": "7.28.5",
+    "@babel/runtime": "7.29.2",
+    "@commitlint/cli": "20.5.2",
+    "@commitlint/config-conventional": "20.5.0",
+    "@eslint/js": "9.39.4",
+    "@jest/globals": "29.7.0",
+    "@jest/types": "29.6.3",
+    "@mdx-js/mdx": "3.1.1",
+    "@mdx-js/react": "3.1.1",
+    "@rollup/plugin-commonjs": "28.0.9",
+    "@rollup/plugin-node-resolve": "16.0.3",
+    "@rollup/plugin-typescript": "12.3.0",
+    "@semantic-release/changelog": "6.0.3",
+    "@semantic-release/commit-analyzer": "13.0.1",
+    "@semantic-release/exec": "7.1.0",
+    "@semantic-release/git": "10.0.1",
+    "@semantic-release/npm": "12.0.2",
+    "@semantic-release/release-notes-generator": "14.1.0",
+    "@storybook/addon-a11y": "10.3.5",
+    "@storybook/addon-docs": "10.3.5",
+    "@storybook/addon-knobs": "8.0.1",
+    "@storybook/addon-links": "10.3.5",
+    "@storybook/addon-styling-webpack": "1.0.1",
+    "@storybook/cli": "10.3.5",
+    "@storybook/core-events": "8.6.14",
+    "@storybook/manager-api": "8.6.14",
+    "@storybook/mdx2-csf": "1.1.0",
+    "@storybook/preset-scss": "1.0.3",
+    "@storybook/preview-api": "8.6.14",
+    "@storybook/react": "10.3.5",
+    "@storybook/react-webpack5": "10.3.5",
+    "@storybook/types": "8.6.14",
+    "@testing-library/jest-dom": "6.9.1",
+    "@testing-library/react": "16.3.2",
+    "@testing-library/user-event": "14.6.1",
+    "@types/enzyme": "3.10.19",
+    "@types/enzyme-adapter-react-16": "1.0.9",
+    "@types/jest": "29.5.14",
+    "@types/node": "20.19.39",
+    "@types/react": "18.3.28",
+    "@types/react-dom": "18.3.7",
+    "@types/react-helmet": "6.1.11",
+    "@types/webpack": "5.28.5",
+    "@types/webpack-env": "1.18.8",
+    "@typescript-eslint/eslint-plugin": "8.59.1",
+    "@typescript-eslint/parser": "8.59.1",
+    "@x15stack/aws": "1.7.2",
+    "autoprefixer": "10.5.0",
+    "babel-jest": "30.3.0",
+    "babel-loader": "9.2.1",
+    "babel-plugin-macros": "3.1.0",
+    "chromatic": "11.29.0",
+    "commitlint": "20.5.3",
+    "copy-webpack-plugin": "12.0.2",
+    "cors": "2.8.6",
+    "cross-env": "7.0.3",
+    "css-loader": "7.1.4",
+    "enzyme": "3.11.0",
+    "enzyme-adapter-react-16": "1.15.8",
+    "esbuild": "0.25.12",
+    "esbuild-sass-plugin": "3.7.0",
+    "eslint": "9.39.4",
+    "eslint-import-resolver-typescript": "4.4.5",
+    "eslint-plugin-import": "2.32.0",
+    "eslint-plugin-jest": "28.14.0",
+    "eslint-plugin-jsx-a11y": "6.10.2",
+    "eslint-plugin-react": "7.37.5",
     "eslint-plugin-storybook": "10.1.10",
-    "express": "^5.2.1",
-    "file-loader": "^6.2.0",
+    "express": "5.2.1",
+    "file-loader": "6.2.0",
     "fs": "0.0.1-security",
-    "fs-extra": "^11.3.4",
-    "glob": "^13.0.6",
-    "globals": "^15.15.0",
-    "jest": "^30.3.0",
-    "jest-environment-jsdom": "^29.7.0",
-    "lefthook": "^1.13.6",
-    "minimatch": "^10.2.5",
-    "nodemon": "^3.1.14",
-    "npm-run-all": "^4.1.5",
-    "null-loader": "^4.0.1",
-    "postcss": "^8.5.12",
-    "postcss-loader": "^8.2.1",
-    "raw-loader": "^4.0.2",
-    "react-docgen-typescript": "^2.4.0",
-    "react-docgen-typescript-loader": "^3.7.2",
-    "react-dropzone": "^14.4.1",
-    "sass": "^1.99.0",
-    "sass-loader": "^16.0.7",
-    "semantic-release": "^24.2.9",
-    "style-loader": "^4.0.0",
-    "ts-jest": "^29.4.9",
-    "ts-morph": "^25.0.1",
-    "tsconfig-paths-webpack-plugin": "^4.2.0",
-    "ttab": "^0.9.0",
+    "fs-extra": "11.3.4",
+    "glob": "13.0.6",
+    "globals": "15.15.0",
+    "jest": "30.3.0",
+    "jest-environment-jsdom": "29.7.0",
+    "lefthook": "1.13.6",
+    "minimatch": "9.0.7",
+    "nodemon": "3.1.14",
+    "npm-run-all": "4.1.5",
+    "null-loader": "4.0.1",
+    "postcss": "8.5.23",
+    "postcss-loader": "8.2.1",
+    "raw-loader": "4.0.2",
+    "react-docgen-typescript": "2.4.0",
+    "react-docgen-typescript-loader": "3.7.2",
+    "react-dropzone": "14.4.1",
+    "react-hook-form": "7.74.0",
+    "sass": "1.99.0",
+    "sass-loader": "16.0.7",
+    "semantic-release": "24.2.9",
+    "style-loader": "4.0.0",
+    "ts-jest": "29.4.9",
+    "ts-morph": "25.0.1",
+    "tsconfig-paths-webpack-plugin": "4.2.0",
+    "ttab": "0.9.0",
     "typescript": "5.5.4",
-    "url-loader": "^4.1.1",
-    "vitest": "3.2.6"
-  },
-  "pnpm": {
-    "overrides": {
-      "@babel/plugin-transform-modules-systemjs": "7.29.4",
-      "@tootallnate/once@<3.0.1": ">=3.0.1",
-      "brace-expansion": "5.0.6",
-      "fast-uri": "3.1.2",
-      "form-data": "4.0.6",
-      "flatted": ">=3.4.2",
-      "flatted@<3.4.0": ">=3.4.0",
-      "handlebars": ">=4.7.9",
-      "immutable@>=5.0.0 <5.1.5": ">=5.1.5",
-      "js-yaml": "4.2.0",
-      "minimatch": "9.0.7",
-      "path-to-regexp": ">=8.4.0",
-      "picomatch": ">=4.0.4",
-      "qs": "6.15.2",
-      "rollup": ">=4.59.0",
-      "serialize-javascript": ">=7.0.3",
-      "shell-quote": "1.8.4",
-      "storybook": ">=10.2.10",
-      "undici": "8.5.0",
-      "uuid": "11.1.1",
-      "vite": "6.4.3",
-      "webpack": ">=5.104.1",
-      "ws": "8.21.0",
-      "yaml": ">=1.10.3"
-    }
+    "url-loader": "4.1.1",
+    "vitest": "4.1.11"
   }
 }

package/dist/esm/styles/index.css

@@ -1928,31 +1928,6 @@ form select:placeholder-shown {
   font-weight: 200;
   font-family: var(--bodyFont);
 }
-form .textareaFieldContainer {
-  display: flex;
-  flex-direction: column;
-  row-gap: 5px;
-  align-items: stretch;
-  justify-content: flex-start;
-  width: 100%;
-}
-form .textareaFooter {
-  min-height: 1.5em;
-}
-form .textarea_Field.stacked label .textareaFooter .validation {
-  position: static;
-  height: auto;
-}
-form .textarea_Field.withValidation label {
-  padding-bottom: 0;
-}
-form .textareaCharacterCount {
-  line-height: 1.5;
-  color: var(--inputLabelColor);
-}
-form .textareaCharacterCountExceeded {
-  color: var(--inputErrorColor);
-}
 form input[type=number] {
   padding-right: 0;
 }
@@ -2064,6 +2039,28 @@ fieldset[disabled] input, fieldset[disabled] textarea, fieldset[disabled] select
   opacity: 0.75;
 }
 
+/* Autofill detection: browsers trigger onAnimationStart when autofill occurs */
+/* This animation is used to detect autofill events in browsers */
+@keyframes onAutoFill {
+  from {
+    opacity: 0.99;
+  }
+  to {
+    opacity: 1;
+  }
+}
+input:-webkit-autofill {
+  animation-name: onAutoFill;
+  animation-duration: 0.001s;
+  animation-fill-mode: both;
+}
+
+textarea:-webkit-autofill {
+  animation-name: onAutoFill;
+  animation-duration: 0.001s;
+  animation-fill-mode: both;
+}
+
 @font-face {
   font-family: "icomoon";
   src: url("../icons/fonts/icomoon.ttf?wbxtd8") format("truetype"), url("../icons/fonts/icomoon.woff?wbxtd8") format("woff"), url("../icons/fonts/icomoon.svg?wbxtd8#icomoon") format("svg");

package/dist/esm/styles/shared/_allPartials.css

@@ -1262,31 +1262,6 @@ form select:placeholder-shown {
   font-weight: 200;
   font-family: var(--bodyFont);
 }
-form .textareaFieldContainer {
-  display: flex;
-  flex-direction: column;
-  row-gap: 5px;
-  align-items: stretch;
-  justify-content: flex-start;
-  width: 100%;
-}
-form .textareaFooter {
-  min-height: 1.5em;
-}
-form .textarea_Field.stacked label .textareaFooter .validation {
-  position: static;
-  height: auto;
-}
-form .textarea_Field.withValidation label {
-  padding-bottom: 0;
-}
-form .textareaCharacterCount {
-  line-height: 1.5;
-  color: var(--inputLabelColor);
-}
-form .textareaCharacterCountExceeded {
-  color: var(--inputErrorColor);
-}
 form input[type=number] {
   padding-right: 0;
 }
@@ -1396,4 +1371,26 @@ label.keyValuePair .value {
 fieldset[disabled] input, fieldset[disabled] textarea, fieldset[disabled] select, fieldset[disabled] button, fieldset[disabled] .radioLabel {
   cursor: not-allowed;
   opacity: 0.75;
+}
+
+/* Autofill detection: browsers trigger onAnimationStart when autofill occurs */
+/* This animation is used to detect autofill events in browsers */
+@keyframes onAutoFill {
+  from {
+    opacity: 0.99;
+  }
+  to {
+    opacity: 1;
+  }
+}
+input:-webkit-autofill {
+  animation-name: onAutoFill;
+  animation-duration: 0.001s;
+  animation-fill-mode: both;
+}
+
+textarea:-webkit-autofill {
+  animation-name: onAutoFill;
+  animation-duration: 0.001s;
+  animation-fill-mode: both;
 }

package/dist/esm/styles/shared/forms/_forms.css

@@ -261,31 +261,6 @@ form select:placeholder-shown {
   font-weight: 200;
   font-family: var(--bodyFont);
 }
-form .textareaFieldContainer {
-  display: flex;
-  flex-direction: column;
-  row-gap: 5px;
-  align-items: stretch;
-  justify-content: flex-start;
-  width: 100%;
-}
-form .textareaFooter {
-  min-height: 1.5em;
-}
-form .textarea_Field.stacked label .textareaFooter .validation {
-  position: static;
-  height: auto;
-}
-form .textarea_Field.withValidation label {
-  padding-bottom: 0;
-}
-form .textareaCharacterCount {
-  line-height: 1.5;
-  color: var(--inputLabelColor);
-}
-form .textareaCharacterCountExceeded {
-  color: var(--inputErrorColor);
-}
 form input[type=number] {
   padding-right: 0;
 }
@@ -395,4 +370,26 @@ label.keyValuePair .value {
 fieldset[disabled] input, fieldset[disabled] textarea, fieldset[disabled] select, fieldset[disabled] button, fieldset[disabled] .radioLabel {
   cursor: not-allowed;
   opacity: 0.75;
+}
+
+/* Autofill detection: browsers trigger onAnimationStart when autofill occurs */
+/* This animation is used to detect autofill events in browsers */
+@keyframes onAutoFill {
+  from {
+    opacity: 0.99;
+  }
+  to {
+    opacity: 1;
+  }
+}
+input:-webkit-autofill {
+  animation-name: onAutoFill;
+  animation-duration: 0.001s;
+  animation-fill-mode: both;
+}
+
+textarea:-webkit-autofill {
+  animation-name: onAutoFill;
+  animation-duration: 0.001s;
+  animation-fill-mode: both;
 }

package/dist/exampleUIs/exampleComponents/DemoContactForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DemoContactForm.d.ts","sourceRoot":"","sources":["../../../src/exampleUIs/exampleComponents/DemoContactForm.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,EAAE,EAAa,MAAM,OAAO,CAAC;AAW7C,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC;IAC/B,cAAc,EAAE,eAAe,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;CACzB,CAoHA,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"DemoContactForm.d.ts","sourceRoot":"","sources":["../../../src/exampleUIs/exampleComponents/DemoContactForm.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,EAAE,EAAa,MAAM,OAAO,CAAC;AAW7C,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC;IAC/B,cAAc,EAAE,eAAe,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;CACzB,CAmHA,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/helpers/index.d.ts

@@ -5,6 +5,6 @@ export type { NamePieces } from './dataHelpers';
 export { dateToShortIsoString, isValidDate, dateToShortReadableDate, dateToShortReadableMonth, timeStampToShortReadableDate, dateToReadableTime, dateToShortReadableDateTime, getLastDateOfMonth, daysSince } from './dateHelpers';
 export { USER_CURRENCY, intlCurrencyFormatter, intlNumberFormatter, formatNumberForLocale, formatAsCurrencyForLocale, getNumberAbbreviation, formatRoundedNumberWithAbbreviation, formatNumberWithAbbreviation, formatNumberForChartAxis, formatAsSimpleCurrencyForChartAxis, formatAsInternationalCurrencyForChartAxis, formatAsCurrencyWithAbbreviation, formatFileSize } from './formatters';
 export { getRandomNumberBelow, getRandomBetweenInclusive, getRandomBetweenExclusive, hashCode, roundToDecimal, formatNumberToMinDigits, formatDigitalTime } from './numberHelpers';
-export { richTextParser, capitalize, capitalizeFirstLetter, lowerCaseFirstLetter, useAnInsteadOfA, splitCamelCase, pluralize, pluralizeIfNeeded, getInitialsOrAcronym } from './stringHelpers';
+export { richTextParser, capitalize, capitalizeFirstLetter, lowerCaseFirstLetter, getCharacterCount, clampToGraphemeMax, useAnInsteadOfA, splitCamelCase, pluralize, pluralizeIfNeeded, getInitialsOrAcronym } from './stringHelpers';
 export { objectsAreTheSame, isAnObject, createCompareValueOverride, deepMergeObjects, overrideMergeObjects, makeInheritanceObject, updateNestedProperty, filterObject, getArrayOfObjectKeys, getArrayOfReadableObjectKeys, getBranchFromPath, deepRemoveProps } from './objectHelpers';
 //# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,2BAA2B,EAC3B,kBAAkB,EAClB,SAAS,EACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,mCAAmC,EACnC,4BAA4B,EAC5B,wBAAwB,EACxB,kCAAkC,EAClC,yCAAyC,EACzC,gCAAgC,EAChC,cAAc,EACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,QAAQ,EACR,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,cAAc,EACd,UAAU,EACV,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,4BAA4B,EAC5B,iBAAiB,EACjB,eAAe,EAChB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,2BAA2B,EAC3B,kBAAkB,EAClB,SAAS,EACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,mCAAmC,EACnC,4BAA4B,EAC5B,wBAAwB,EACxB,kCAAkC,EAClC,yCAAyC,EACzC,gCAAgC,EAChC,cAAc,EACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,QAAQ,EACR,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,cAAc,EACd,UAAU,EACV,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,0BAA0B,EAC1B,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,4BAA4B,EAC5B,iBAAiB,EACjB,eAAe,EAChB,MAAM,iBAAiB,CAAC"}

package/dist/helpers/stringHelpers.d.ts

@@ -21,6 +21,23 @@ export declare const capitalizeFirstLetter: (pString: string) => string;
  * @returns {string} The string with the first letter converted to lowercase, or the unchanged pString if it's not a string.
  */
 export declare const lowerCaseFirstLetter: (pString: string) => string;
+/**
+ * Counts user-perceived characters (grapheme clusters) so emojis and composed
+ * characters such as accented letters count as one.
+ *
+ * @param {string} pString - A string of text.
+ * @returns {number} The number of grapheme clusters, falling back to code points where Intl.Segmenter is unavailable.
+ */
+export declare const getCharacterCount: (pString: string) => number;
+/**
+ * Truncates a string to a maximum number of grapheme clusters without splitting
+ * an emoji or composed character in half.
+ *
+ * @param {string} pString - A string of text.
+ * @param {number} maxAllowed - The maximum number of user-perceived characters to keep.
+ * @returns {string} The truncated string, or the unchanged pString if it is already within the limit.
+ */
+export declare const clampToGraphemeMax: (pString: string, maxAllowed: number) => string;
 /**
  * Determines if "an" should be used instead of "a" before the given word.
  *