@iabbb/bds-react 0.49.0 → 0.49.1

package/FieldCharacterCountdown/index.cjs

@@ -253,4 +253,5 @@ function FieldCharacterCountdown(_ref) {
 }
 
 exports.default = FieldCharacterCountdown;
+exports.useCharacterCountdown = useCharacterCountdown;
 //# sourceMappingURL=index.cjs.map

package/FieldCharacterCountdown/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../src/ErrorMessage/ErrorMessage.tsx","../../src/FieldCharacterCountdown/useCharacterCountdown.ts","../../src/FieldCharacterCountdown/FieldCharacterCountdown.tsx"],"sourcesContent":["// biome-ignore lint/style/useImportType: following this rule does not work for some reason\nimport * as React from 'react';\n\nexport default function ErrorMessage({ className, children, ...props }: React.ComponentPropsWithoutRef<'span'>) {\n  return (\n    <span className={['bds-error', className].filter((x) => x).join(' ')} {...props}>\n      <svg\n        xmlns=\"http://www.w3.org/2000/svg\"\n        viewBox=\"0 0 512 512\"\n        aria-hidden=\"true\"\n        height=\"1em\"\n        width=\"1em\"\n        fill=\"currentColor\"\n      >\n        <path d=\"M256 32c14.2 0 27.3 7.5 34.5 19.8l216 368c7.3 12.4 7.3 27.7.2 40.1S486.3 480 472 480H40c-14.3 0-27.6-7.7-34.7-20.1s-7-27.8.2-40.1l216-368C228.7 39.5 241.8 32 256 32zm0 128c-13.3 0-24 10.7-24 24v112c0 13.3 10.7 24 24 24s24-10.7 24-24V184c0-13.3-10.7-24-24-24zm32 224c0-17.7-14.3-32-32-32s-32 14.3-32 32 14.3 32 32 32 32-14.3 32-32z\" />\n      </svg>\n      {children}\n    </span>\n  );\n}\n","import * as React from 'react';\n\nconst visuallyHiddenAnnouncementUpdateTimeInSeconds = 1;\n\nexport default function useCharacterCountdown(maxCharacters: number, currentCharacters = 0) {\n  const [remainingCharacters, setRemainingCharacters] = React.useState(maxCharacters - currentCharacters);\n\n  // When JS fails to load, the default label 👇 will still let the user know about the limit.\n  const [label, setLabel] = React.useState(`You can use up to ${maxCharacters} characters`);\n  const [visuallyHiddenAnnouncement, setVisuallyHiddenAnnouncement] = React.useState(label);\n\n  // This should lag behind the visual update -- otherwise, screen reader users will be interrupted with a lot of chatter while typing\n  const updateVisuallyHiddenAnnouncement = useDebounce((charactersToAnnounce: number) => {\n    if (charactersToAnnounce >= 0) {\n      setVisuallyHiddenAnnouncement(`You have ${charactersToAnnounce} characters remaining`);\n    } else {\n      setVisuallyHiddenAnnouncement(`You have ${charactersToAnnounce * -1} characters too many`);\n    }\n  }, visuallyHiddenAnnouncementUpdateTimeInSeconds * 1000);\n\n  React.useEffect(() => {\n    if (remainingCharacters >= 0) {\n      setLabel(`<strong>${remainingCharacters}</strong> characters remaining`);\n    } else {\n      setLabel(`You have <strong>${remainingCharacters * -1}</strong> characters too many`);\n    }\n\n    updateVisuallyHiddenAnnouncement(remainingCharacters);\n  }, [remainingCharacters, updateVisuallyHiddenAnnouncement]);\n\n  return {\n    hasExceededLimit: remainingCharacters < 0,\n    handleTextareaChange: (e: React.ChangeEvent<HTMLTextAreaElement>) => {\n      setRemainingCharacters(maxCharacters - e.target.value.length);\n    },\n    label,\n    visuallyHiddenAnnouncement,\n  };\n}\n\n/**\n * Simple debounce implementation. Will call the given\n * function once after the time given has passed since\n * it was last called.\n * Lifted from downshift/utils (not exposed in lib).\n * @param {Function} fn the function to call after the time\n * @param {Number} time the time to wait\n * @return {Function} the debounced function\n */\n// biome-ignore lint/suspicious/noExplicitAny: We don't know or care what parameters the function accepts\nfunction debounce(fn: (...rest: any[]) => any, time: number) {\n  let timeoutId: number | null = 0;\n\n  function cancel() {\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  function wrapper(...args) {\n    cancel();\n    timeoutId = setTimeout(() => {\n      timeoutId = null;\n      fn(...args);\n    }, time);\n  }\n\n  wrapper.cancel = cancel;\n\n  return wrapper;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: We don't know or care what parameters the function accepts\nfunction useDebounce<T extends (...rest: any[]) => any>(callback: T, delay: number) {\n  return React.useRef(debounce((...params) => callback(...params), delay)).current;\n}\n","import * as React from 'react';\n\nimport ErrorMessage from '../ErrorMessage';\nimport useCharacterCountdown from './useCharacterCountdown';\n\nexport type FieldCharacterCountdownProps = {\n  error?: string;\n  hint?: string;\n  id?: string;\n  isOptional?: boolean;\n  label: string;\n  maxCharacters: number;\n};\n\nexport default function FieldCharacterCountdown({\n  error,\n  hint,\n  id,\n  isOptional = false,\n  label,\n  maxCharacters,\n  onChange,\n  ...props\n}: FieldCharacterCountdownProps & React.ComponentPropsWithoutRef<'textarea'>) {\n  const characterCountdown = useCharacterCountdown(maxCharacters, ((props.value as string) || '').length);\n\n  id = id ?? props.name;\n\n  const errorId = React.useId();\n  const hintId = React.useId();\n\n  return (\n    <div className=\"bds-form-group\">\n      <label htmlFor={id}>\n        {label}\n        {isOptional && ' (optional)'}\n      </label>\n      {hint && (\n        <span className=\"bds-hint\" id={hintId}>\n          {hint}\n        </span>\n      )}\n      {error && <ErrorMessage id={errorId}>{error}</ErrorMessage>}\n      <textarea\n        aria-invalid={error ? true : undefined}\n        aria-describedby={error && hint ? `${hintId} ${errorId}` : error ? errorId : hint ? hintId : undefined}\n        className=\"bds-textarea\"\n        id={id}\n        onChange={(e) => {\n          if (onChange) {\n            onChange(e);\n          }\n\n          characterCountdown.handleTextareaChange(e);\n        }}\n        {...props}\n      />\n      <div\n        aria-hidden=\"true\"\n        className=\"bds-character-count\"\n        data-exceeds-limit={characterCountdown.hasExceededLimit ? true : undefined}\n        // biome-ignore lint/security/noDangerouslySetInnerHtml: HTML is expected and used for highlighting the number itself\n        dangerouslySetInnerHTML={{\n          __html: characterCountdown.label,\n        }}\n      />\n      <div aria-live=\"polite\" className=\"visually-hidden\">\n        {characterCountdown.visuallyHiddenAnnouncement}\n      </div>\n    </div>\n  );\n}\n"],"names":["ErrorMessage","_ref","className","children","props","_objectWithoutProperties","_excluded","React","createElement","_extends","filter","x","join","xmlns","viewBox","height","width","fill","d","visuallyHiddenAnnouncementUpdateTimeInSeconds","useCharacterCountdown","maxCharacters","currentCharacters","arguments","length","undefined","_React$useState","useState","_React$useState2","_slicedToArray","remainingCharacters","setRemainingCharacters","_React$useState3","concat","_React$useState4","label","setLabel","_React$useState5","_React$useState6","visuallyHiddenAnnouncement","setVisuallyHiddenAnnouncement","updateVisuallyHiddenAnnouncement","useDebounce","charactersToAnnounce","useEffect","hasExceededLimit","handleTextareaChange","e","target","value","debounce","fn","time","timeoutId","cancel","clearTimeout","wrapper","_len","args","Array","_key","setTimeout","apply","callback","delay","useRef","current","FieldCharacterCountdown","_id","error","hint","id","_ref$isOptional","isOptional","onChange","characterCountdown","name","errorId","useId","hintId","htmlFor","dangerouslySetInnerHTML","__html"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../../src/ErrorMessage/ErrorMessage.tsx","../../src/FieldCharacterCountdown/useCharacterCountdown.ts","../../src/FieldCharacterCountdown/FieldCharacterCountdown.tsx"],"sourcesContent":["// biome-ignore lint/style/useImportType: following this rule does not work for some reason\nimport * as React from 'react';\n\nexport default function ErrorMessage({ className, children, ...props }: React.ComponentPropsWithoutRef<'span'>) {\n  return (\n    <span className={['bds-error', className].filter((x) => x).join(' ')} {...props}>\n      <svg\n        xmlns=\"http://www.w3.org/2000/svg\"\n        viewBox=\"0 0 512 512\"\n        aria-hidden=\"true\"\n        height=\"1em\"\n        width=\"1em\"\n        fill=\"currentColor\"\n      >\n        <path d=\"M256 32c14.2 0 27.3 7.5 34.5 19.8l216 368c7.3 12.4 7.3 27.7.2 40.1S486.3 480 472 480H40c-14.3 0-27.6-7.7-34.7-20.1s-7-27.8.2-40.1l216-368C228.7 39.5 241.8 32 256 32zm0 128c-13.3 0-24 10.7-24 24v112c0 13.3 10.7 24 24 24s24-10.7 24-24V184c0-13.3-10.7-24-24-24zm32 224c0-17.7-14.3-32-32-32s-32 14.3-32 32 14.3 32 32 32 32-14.3 32-32z\" />\n      </svg>\n      {children}\n    </span>\n  );\n}\n","import * as React from 'react';\n\nconst visuallyHiddenAnnouncementUpdateTimeInSeconds = 1;\n\nexport default function useCharacterCountdown(maxCharacters: number, currentCharacters = 0) {\n  const [remainingCharacters, setRemainingCharacters] = React.useState(maxCharacters - currentCharacters);\n\n  // When JS fails to load, the default label 👇 will still let the user know about the limit.\n  const [label, setLabel] = React.useState(`You can use up to ${maxCharacters} characters`);\n  const [visuallyHiddenAnnouncement, setVisuallyHiddenAnnouncement] = React.useState(label);\n\n  // This should lag behind the visual update -- otherwise, screen reader users will be interrupted with a lot of chatter while typing\n  const updateVisuallyHiddenAnnouncement = useDebounce((charactersToAnnounce: number) => {\n    if (charactersToAnnounce >= 0) {\n      setVisuallyHiddenAnnouncement(`You have ${charactersToAnnounce} characters remaining`);\n    } else {\n      setVisuallyHiddenAnnouncement(`You have ${charactersToAnnounce * -1} characters too many`);\n    }\n  }, visuallyHiddenAnnouncementUpdateTimeInSeconds * 1000);\n\n  React.useEffect(() => {\n    if (remainingCharacters >= 0) {\n      setLabel(`<strong>${remainingCharacters}</strong> characters remaining`);\n    } else {\n      setLabel(`You have <strong>${remainingCharacters * -1}</strong> characters too many`);\n    }\n\n    updateVisuallyHiddenAnnouncement(remainingCharacters);\n  }, [remainingCharacters, updateVisuallyHiddenAnnouncement]);\n\n  return {\n    hasExceededLimit: remainingCharacters < 0,\n    handleTextareaChange: (e: React.ChangeEvent<HTMLTextAreaElement>) => {\n      setRemainingCharacters(maxCharacters - e.target.value.length);\n    },\n    label,\n    visuallyHiddenAnnouncement,\n  };\n}\n\n/**\n * Simple debounce implementation. Will call the given\n * function once after the time given has passed since\n * it was last called.\n * Lifted from downshift/utils (not exposed in lib).\n * @param {Function} fn the function to call after the time\n * @param {Number} time the time to wait\n * @return {Function} the debounced function\n */\n// biome-ignore lint/suspicious/noExplicitAny: We don't know or care what parameters the function accepts\nfunction debounce(fn: (...rest: any[]) => any, time: number) {\n  let timeoutId: number | null = 0;\n\n  function cancel() {\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  function wrapper(...args) {\n    cancel();\n    timeoutId = setTimeout(() => {\n      timeoutId = null;\n      fn(...args);\n    }, time);\n  }\n\n  wrapper.cancel = cancel;\n\n  return wrapper;\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: We don't know or care what parameters the function accepts\nfunction useDebounce<T extends (...rest: any[]) => any>(callback: T, delay: number) {\n  return React.useRef(debounce((...params) => callback(...params), delay)).current;\n}\n","import * as React from 'react';\n\nimport ErrorMessage from '../ErrorMessage';\nimport useCharacterCountdown from './useCharacterCountdown';\n\nexport type FieldCharacterCountdownProps = {\n  error?: string;\n  hint?: string;\n  id?: string;\n  isOptional?: boolean;\n  label: string;\n  maxCharacters: number;\n};\n\nexport default function FieldCharacterCountdown({\n  error,\n  hint,\n  id,\n  isOptional = false,\n  label,\n  maxCharacters,\n  onChange,\n  ...props\n}: FieldCharacterCountdownProps & React.ComponentPropsWithoutRef<'textarea'>) {\n  const characterCountdown = useCharacterCountdown(maxCharacters, ((props.value as string) || '').length);\n\n  id = id ?? props.name;\n\n  const errorId = React.useId();\n  const hintId = React.useId();\n\n  return (\n    <div className=\"bds-form-group\">\n      <label htmlFor={id}>\n        {label}\n        {isOptional && ' (optional)'}\n      </label>\n      {hint && (\n        <span className=\"bds-hint\" id={hintId}>\n          {hint}\n        </span>\n      )}\n      {error && <ErrorMessage id={errorId}>{error}</ErrorMessage>}\n      <textarea\n        aria-invalid={error ? true : undefined}\n        aria-describedby={error && hint ? `${hintId} ${errorId}` : error ? errorId : hint ? hintId : undefined}\n        className=\"bds-textarea\"\n        id={id}\n        onChange={(e) => {\n          if (onChange) {\n            onChange(e);\n          }\n\n          characterCountdown.handleTextareaChange(e);\n        }}\n        {...props}\n      />\n      <div\n        aria-hidden=\"true\"\n        className=\"bds-character-count\"\n        data-exceeds-limit={characterCountdown.hasExceededLimit ? true : undefined}\n        // biome-ignore lint/security/noDangerouslySetInnerHtml: HTML is expected and used for highlighting the number itself\n        dangerouslySetInnerHTML={{\n          __html: characterCountdown.label,\n        }}\n      />\n      <div aria-live=\"polite\" className=\"visually-hidden\">\n        {characterCountdown.visuallyHiddenAnnouncement}\n      </div>\n    </div>\n  );\n}\n"],"names":["ErrorMessage","_ref","className","children","props","_objectWithoutProperties","_excluded","React","createElement","_extends","filter","x","join","xmlns","viewBox","height","width","fill","d","visuallyHiddenAnnouncementUpdateTimeInSeconds","useCharacterCountdown","maxCharacters","currentCharacters","arguments","length","undefined","_React$useState","useState","_React$useState2","_slicedToArray","remainingCharacters","setRemainingCharacters","_React$useState3","concat","_React$useState4","label","setLabel","_React$useState5","_React$useState6","visuallyHiddenAnnouncement","setVisuallyHiddenAnnouncement","updateVisuallyHiddenAnnouncement","useDebounce","charactersToAnnounce","useEffect","hasExceededLimit","handleTextareaChange","e","target","value","debounce","fn","time","timeoutId","cancel","clearTimeout","wrapper","_len","args","Array","_key","setTimeout","apply","callback","delay","useRef","current","FieldCharacterCountdown","_id","error","hint","id","_ref$isOptional","isOptional","onChange","characterCountdown","name","errorId","useId","hintId","htmlFor","dangerouslySetInnerHTML","__html"],"mappings":"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"}

package/FieldCharacterCountdown/index.d.ts

@@ -1 +1,2 @@
 export { default } from './FieldCharacterCountdown';
+export { default as useCharacterCountdown } from './useCharacterCountdown';

package/FieldCharacterCountdown/index.mjs

@@ -229,5 +229,5 @@ function FieldCharacterCountdown(_ref) {
   }, characterCountdown.visuallyHiddenAnnouncement));
 }
 
-export { FieldCharacterCountdown as default };
+export { FieldCharacterCountdown as default, useCharacterCountdown };
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iabbb/bds-react",
-  "version": "0.49.0",
+  "version": "0.49.1",
   "main": "index.js",
   "scripts": {
     "build": "cross-env NODE_ENV=production rollup -c",
@@ -28,7 +28,7 @@
     "typescript": "5.4.5"
   },
   "peerDependencies": {
-    "@iabbb/bds": "0.49.0",
+    "@iabbb/bds": "0.49.1",
     "react": "^18.0.0"
   }
 }