@primer/react 38.29.1-rc.4254fa28f → 38.30.0-rc.4d4be073a

package/dist/Textarea/Textarea.js

@@ -1,12 +1,14 @@
 import { c } from 'react-compiler-runtime';
-import React, { useRef, useId, useEffect } from 'react';
+import React, { useId, useState } from 'react';
 import { TextInputBaseWrapper } from '../internal/components/TextInputWrapper.js';
 import classes from './TextArea.module.css.js';
 import { AlertFillIcon } from '@primer/octicons-react';
-import { CharacterCounter } from '../utils/character-counter.js';
+import { SCREEN_READER_DELAY, getCharacterCountState } from '../utils/character-counter.js';
 import VisuallyHidden from '../_VisuallyHidden.js';
+import visuallyHiddenClasses from '../_VisuallyHidden.module.css.js';
 import { clsx } from 'clsx';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import { AriaStatus } from '../live-region/AriaStatus.js';
 import Text from '../Text/Text.js';
 
 const DEFAULT_TEXTAREA_ROWS = 7;
@@ -17,7 +19,7 @@ const DEFAULT_TEXTAREA_RESIZE = 'both';
  * This component accepts all native HTML <textarea> attributes as props.
  */
 const Textarea = /*#__PURE__*/React.forwardRef((t0, ref) => {
-  const $ = c(68);
+  const $ = c(76);
   let block;
   let characterLimit;
   let className;
@@ -95,200 +97,170 @@ const Textarea = /*#__PURE__*/React.forwardRef((t0, ref) => {
   const rows = t1 === undefined ? DEFAULT_TEXTAREA_ROWS : t1;
   const cols = t2 === undefined ? DEFAULT_TEXTAREA_COLS : t2;
   const resize = t3 === undefined ? DEFAULT_TEXTAREA_RESIZE : t3;
-  const [characterCount, setCharacterCount] = React.useState("");
-  const [isOverLimit, setIsOverLimit] = React.useState(false);
-  const [screenReaderMessage, setScreenReaderMessage] = React.useState("");
-  const characterCounterRef = useRef(null);
   const characterCountId = useId();
   const characterCountStaticMessageId = useId();
+  const isControlled = value !== undefined;
   let t4;
-  let t5;
-  if ($[18] !== characterLimit) {
-    t4 = () => {
-      if (characterLimit) {
-        characterCounterRef.current = new CharacterCounter({
-          onCountUpdate: (count, overLimit, message) => {
-            setCharacterCount(message);
-            setIsOverLimit(overLimit);
-          },
-          onScreenReaderAnnounce: message_0 => {
-            setScreenReaderMessage(message_0);
-          }
-        });
-        return () => {
-          var _characterCounterRef$;
-          (_characterCounterRef$ = characterCounterRef.current) === null || _characterCounterRef$ === void 0 ? void 0 : _characterCounterRef$.cleanup();
-        };
-      }
-    };
-    t5 = [characterLimit];
-    $[18] = characterLimit;
+  if ($[18] !== defaultValue) {
+    t4 = () => defaultValue !== undefined ? String(defaultValue).length : 0;
+    $[18] = defaultValue;
     $[19] = t4;
-    $[20] = t5;
   } else {
     t4 = $[19];
-    t5 = $[20];
-  }
-  useEffect(t4, t5);
-  let t6;
-  let t7;
-  if ($[21] !== characterLimit || $[22] !== defaultValue || $[23] !== value) {
-    t6 = () => {
-      if (characterLimit && characterCounterRef.current) {
-        const currentValue = value !== undefined ? String(value) : defaultValue !== undefined ? String(defaultValue) : "";
-        characterCounterRef.current.updateCharacterCount(currentValue.length, characterLimit);
-      }
-    };
-    t7 = [value, defaultValue, characterLimit];
-    $[21] = characterLimit;
-    $[22] = defaultValue;
-    $[23] = value;
-    $[24] = t6;
-    $[25] = t7;
-  } else {
-    t6 = $[24];
-    t7 = $[25];
-  }
-  useEffect(t6, t7);
-  let t8;
-  if ($[26] !== characterLimit || $[27] !== onChange) {
-    t8 = e => {
-      var _onChange;
-      if (characterLimit && characterCounterRef.current) {
-        characterCounterRef.current.updateCharacterCount(e.target.value.length, characterLimit);
-      }
-      (_onChange = onChange) === null || _onChange === void 0 ? void 0 : _onChange(e);
-    };
-    $[26] = characterLimit;
-    $[27] = onChange;
-    $[28] = t8;
-  } else {
-    t8 = $[28];
-  }
-  const handleTextareaChange = t8;
-  const isValid = isOverLimit ? "error" : validationStatus;
-  const t9 = isValid === "error" ? "true" : "false";
-  let t10;
-  if ($[29] !== maxHeight || $[30] !== minHeight || $[31] !== style) {
-    t10 = {
-      minHeight,
-      maxHeight,
-      ...style
-    };
-    $[29] = maxHeight;
-    $[30] = minHeight;
-    $[31] = style;
-    $[32] = t10;
-  } else {
-    t10 = $[32];
-  }
-  let t11;
-  if ($[33] !== characterCountStaticMessageId || $[34] !== characterLimit || $[35] !== rest) {
-    t11 = characterLimit ? [characterCountStaticMessageId, rest["aria-describedby"]].filter(Boolean).join(" ") || undefined : rest["aria-describedby"];
-    $[33] = characterCountStaticMessageId;
-    $[34] = characterLimit;
-    $[35] = rest;
-    $[36] = t11;
-  } else {
-    t11 = $[36];
   }
-  let t12;
-  if ($[37] !== cols || $[38] !== defaultValue || $[39] !== disabled || $[40] !== handleTextareaChange || $[41] !== ref || $[42] !== required || $[43] !== resize || $[44] !== rest || $[45] !== rows || $[46] !== t10 || $[47] !== t11 || $[48] !== t9 || $[49] !== value) {
-    t12 = /*#__PURE__*/jsx("textarea", {
-      value: value,
-      defaultValue: defaultValue,
-      "data-resize": resize,
-      "aria-required": required,
-      "aria-invalid": t9,
-      ref: ref,
-      disabled: disabled,
-      rows: rows,
-      cols: cols,
-      className: classes.TextArea,
-      onChange: handleTextareaChange,
-      style: t10,
-      ...rest,
-      "aria-describedby": t11
-    });
-    $[37] = cols;
-    $[38] = defaultValue;
-    $[39] = disabled;
-    $[40] = handleTextareaChange;
-    $[41] = ref;
-    $[42] = required;
-    $[43] = resize;
-    $[44] = rest;
-    $[45] = rows;
-    $[46] = t10;
-    $[47] = t11;
-    $[48] = t9;
-    $[49] = value;
-    $[50] = t12;
-  } else {
-    t12 = $[50];
-  }
-  let t13;
-  if ($[51] !== block || $[52] !== className || $[53] !== contrast || $[54] !== disabled || $[55] !== isValid || $[56] !== t12) {
-    t13 = /*#__PURE__*/jsx(TextInputBaseWrapper, {
-      validationStatus: isValid,
-      disabled: disabled,
-      block: block,
-      contrast: contrast,
-      className: className,
-      children: t12
-    });
-    $[51] = block;
-    $[52] = className;
-    $[53] = contrast;
-    $[54] = disabled;
-    $[55] = isValid;
-    $[56] = t12;
-    $[57] = t13;
-  } else {
-    t13 = $[57];
-  }
-  let t14;
-  if ($[58] !== characterCount || $[59] !== characterCountId || $[60] !== characterCountStaticMessageId || $[61] !== characterLimit || $[62] !== isOverLimit || $[63] !== screenReaderMessage) {
-    t14 = characterLimit && /*#__PURE__*/jsxs(Fragment, {
-      children: [/*#__PURE__*/jsx(VisuallyHidden, {
-        "aria-live": "polite",
-        role: "status",
-        children: screenReaderMessage
-      }), /*#__PURE__*/jsxs(VisuallyHidden, {
-        id: characterCountStaticMessageId,
-        children: ["You can enter up to ", characterLimit, " ", characterLimit === 1 ? "character" : "characters"]
-      }), /*#__PURE__*/jsxs(Text, {
-        "aria-hidden": "true",
-        id: characterCountId,
-        size: "small",
-        className: clsx(classes.CharacterCounter, isOverLimit && classes["CharacterCounter--error"]),
-        children: [isOverLimit && /*#__PURE__*/jsx(AlertFillIcon, {
-          size: 16
-        }), characterCount]
+  const [uncontrolledLength, setUncontrolledLength] = useState(t4);
+  const currentLength = isControlled ? String(value).length : uncontrolledLength;
+  let t5;
+  if ($[20] !== block || $[21] !== characterCountId || $[22] !== characterCountStaticMessageId || $[23] !== characterLimit || $[24] !== className || $[25] !== cols || $[26] !== contrast || $[27] !== currentLength || $[28] !== defaultValue || $[29] !== disabled || $[30] !== isControlled || $[31] !== maxHeight || $[32] !== minHeight || $[33] !== onChange || $[34] !== ref || $[35] !== required || $[36] !== resize || $[37] !== rest || $[38] !== rows || $[39] !== style || $[40] !== validationStatus || $[41] !== value) {
+    var _counter$isOverLimit;
+    const counter = characterLimit ? getCharacterCountState(currentLength, characterLimit) : undefined;
+    const isOverLimit = (_counter$isOverLimit = counter === null || counter === void 0 ? void 0 : counter.isOverLimit) !== null && _counter$isOverLimit !== void 0 ? _counter$isOverLimit : false;
+    let t6;
+    if ($[43] !== characterLimit || $[44] !== isControlled || $[45] !== onChange) {
+      t6 = e => {
+        var _onChange;
+        if (characterLimit && !isControlled) {
+          setUncontrolledLength(e.target.value.length);
+        }
+        (_onChange = onChange) === null || _onChange === void 0 ? void 0 : _onChange(e);
+      };
+      $[43] = characterLimit;
+      $[44] = isControlled;
+      $[45] = onChange;
+      $[46] = t6;
+    } else {
+      t6 = $[46];
+    }
+    const handleTextareaChange = t6;
+    const isValid = isOverLimit ? "error" : validationStatus;
+    const t7 = isValid === "error" ? "true" : "false";
+    let t8;
+    if ($[47] !== maxHeight || $[48] !== minHeight || $[49] !== style) {
+      t8 = {
+        minHeight,
+        maxHeight,
+        ...style
+      };
+      $[47] = maxHeight;
+      $[48] = minHeight;
+      $[49] = style;
+      $[50] = t8;
+    } else {
+      t8 = $[50];
+    }
+    let t9;
+    if ($[51] !== characterCountStaticMessageId || $[52] !== characterLimit || $[53] !== rest) {
+      t9 = characterLimit ? [characterCountStaticMessageId, rest["aria-describedby"]].filter(Boolean).join(" ") || undefined : rest["aria-describedby"];
+      $[51] = characterCountStaticMessageId;
+      $[52] = characterLimit;
+      $[53] = rest;
+      $[54] = t9;
+    } else {
+      t9 = $[54];
+    }
+    let t10;
+    if ($[55] !== cols || $[56] !== defaultValue || $[57] !== disabled || $[58] !== handleTextareaChange || $[59] !== ref || $[60] !== required || $[61] !== resize || $[62] !== rest || $[63] !== rows || $[64] !== t7 || $[65] !== t8 || $[66] !== t9 || $[67] !== value) {
+      t10 = /*#__PURE__*/jsx("textarea", {
+        value: value,
+        defaultValue: defaultValue,
+        "data-resize": resize,
+        "aria-required": required,
+        "aria-invalid": t7,
+        ref: ref,
+        disabled: disabled,
+        rows: rows,
+        cols: cols,
+        className: classes.TextArea,
+        onChange: handleTextareaChange,
+        style: t8,
+        ...rest,
+        "aria-describedby": t9
+      });
+      $[55] = cols;
+      $[56] = defaultValue;
+      $[57] = disabled;
+      $[58] = handleTextareaChange;
+      $[59] = ref;
+      $[60] = required;
+      $[61] = resize;
+      $[62] = rest;
+      $[63] = rows;
+      $[64] = t7;
+      $[65] = t8;
+      $[66] = t9;
+      $[67] = value;
+      $[68] = t10;
+    } else {
+      t10 = $[68];
+    }
+    let t11;
+    if ($[69] !== block || $[70] !== className || $[71] !== contrast || $[72] !== disabled || $[73] !== isValid || $[74] !== t10) {
+      t11 = /*#__PURE__*/jsx(TextInputBaseWrapper, {
+        validationStatus: isValid,
+        disabled: disabled,
+        block: block,
+        contrast: contrast,
+        className: className,
+        children: t10
+      });
+      $[69] = block;
+      $[70] = className;
+      $[71] = contrast;
+      $[72] = disabled;
+      $[73] = isValid;
+      $[74] = t10;
+      $[75] = t11;
+    } else {
+      t11 = $[75];
+    }
+    t5 = /*#__PURE__*/jsxs(Fragment, {
+      children: [t11, characterLimit && /*#__PURE__*/jsxs(Fragment, {
+        children: [/*#__PURE__*/jsx(AriaStatus, {
+          announceOnShow: false,
+          delayMs: SCREEN_READER_DELAY,
+          className: visuallyHiddenClasses.InternalVisuallyHidden,
+          children: counter === null || counter === void 0 ? void 0 : counter.message
+        }), /*#__PURE__*/jsxs(VisuallyHidden, {
+          id: characterCountStaticMessageId,
+          children: ["You can enter up to ", characterLimit, " ", characterLimit === 1 ? "character" : "characters"]
+        }), /*#__PURE__*/jsxs(Text, {
+          "aria-hidden": "true",
+          id: characterCountId,
+          size: "small",
+          className: clsx(classes.CharacterCounter, isOverLimit && classes["CharacterCounter--error"]),
+          children: [isOverLimit && /*#__PURE__*/jsx(AlertFillIcon, {
+            size: 16
+          }), counter === null || counter === void 0 ? void 0 : counter.message]
+        })]
       })]
     });
-    $[58] = characterCount;
-    $[59] = characterCountId;
-    $[60] = characterCountStaticMessageId;
-    $[61] = characterLimit;
-    $[62] = isOverLimit;
-    $[63] = screenReaderMessage;
-    $[64] = t14;
-  } else {
-    t14 = $[64];
-  }
-  let t15;
-  if ($[65] !== t13 || $[66] !== t14) {
-    t15 = /*#__PURE__*/jsxs(Fragment, {
-      children: [t13, t14]
-    });
-    $[65] = t13;
-    $[66] = t14;
-    $[67] = t15;
+    $[20] = block;
+    $[21] = characterCountId;
+    $[22] = characterCountStaticMessageId;
+    $[23] = characterLimit;
+    $[24] = className;
+    $[25] = cols;
+    $[26] = contrast;
+    $[27] = currentLength;
+    $[28] = defaultValue;
+    $[29] = disabled;
+    $[30] = isControlled;
+    $[31] = maxHeight;
+    $[32] = minHeight;
+    $[33] = onChange;
+    $[34] = ref;
+    $[35] = required;
+    $[36] = resize;
+    $[37] = rest;
+    $[38] = rows;
+    $[39] = style;
+    $[40] = validationStatus;
+    $[41] = value;
+    $[42] = t5;
   } else {
-    t15 = $[67];
+    t5 = $[42];
   }
-  return t15;
+  return t5;
 });
 Textarea.displayName = 'Textarea';
 Textarea.__SLOT__ = Symbol('Textarea');

package/dist/_VisuallyHidden.js

@@ -1,5 +1,5 @@
 import { c } from 'react-compiler-runtime';
-import classes from './_VisuallyHidden.module.css.js';
+import visuallyHiddenClasses from './_VisuallyHidden.module.css.js';
 import { clsx } from 'clsx';
 import { jsx } from 'react/jsx-runtime';
 
@@ -36,7 +36,7 @@ function VisuallyHidden(t0) {
   let t2;
   if ($[6] !== className || $[7] !== t1) {
     t2 = clsx(className, {
-      [classes.InternalVisuallyHidden]: t1
+      [visuallyHiddenClasses.InternalVisuallyHidden]: t1
     });
     $[6] = className;
     $[7] = t1;

package/dist/_VisuallyHidden.module.css.js

@@ -1,5 +1,5 @@
 import './_VisuallyHidden-1f156b61.css';
 
-var classes = {"InternalVisuallyHidden":"prc-src-InternalVisuallyHidden-2YaI6"};
+var visuallyHiddenClasses = {"InternalVisuallyHidden":"prc-src-InternalVisuallyHidden-2YaI6"};
 
-export { classes as default };
+export { visuallyHiddenClasses as default };

package/dist/live-region/Announce.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Announce.d.ts","sourceRoot":"","sources":["../../src/live-region/Announce.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,6BAA6B,CAAA;AAEjE,MAAM,MAAM,aAAa,CAAC,EAAE,SAAS,KAAK,CAAC,WAAW,IAAI,gBAAgB,CACxE,EAAE,EACF,KAAK,EACL;IACE;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAA;CACpC,CACF,CAAA;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,EAAE,SAAS,KAAK,CAAC,WAAW,GAAG,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC,qBAwGtF"}
+{"version":3,"file":"Announce.d.ts","sourceRoot":"","sources":["../../src/live-region/Announce.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,6BAA6B,CAAA;AAEjE,MAAM,MAAM,aAAa,CAAC,EAAE,SAAS,KAAK,CAAC,WAAW,IAAI,gBAAgB,CACxE,EAAE,EACF,KAAK,EACL;IACE;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAA;CACpC,CACF,CAAA;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,EAAE,SAAS,KAAK,CAAC,WAAW,GAAG,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC,qBAsGtF"}

package/dist/live-region/Announce.js

@@ -1,6 +1,6 @@
 import { c } from 'react-compiler-runtime';
 import { announceFromElement } from '@primer/live-region-element';
-import { useRef, useState, useEffect } from 'react';
+import { useRef, useEffect } from 'react';
 import { useEffectOnce } from '../internal/hooks/useEffectOnce.js';
 import { useEffectCallback } from '../internal/hooks/useEffectCallback.js';
 import { jsx } from 'react/jsx-runtime';
@@ -11,7 +11,7 @@ import { jsx } from 'react/jsx-runtime';
  * will also announce any changes to the text content of `children`
  */
 function Announce(props) {
-  const $ = c(25);
+  const $ = c(24);
   let children;
   let delayMs;
   let rest;
@@ -51,10 +51,10 @@ function Announce(props) {
   const hidden = t2 === undefined ? false : t2;
   const politeness = t3 === undefined ? "polite" : t3;
   const ref = useRef(null);
-  const [previousAnnouncementText, setPreviousAnnouncementText] = useState(null);
+  const previousAnnouncementText = useRef(null);
   const savedAnnouncement = useRef(null);
   let t4;
-  if ($[8] !== delayMs || $[9] !== hidden || $[10] !== politeness || $[11] !== previousAnnouncementText) {
+  if ($[8] !== delayMs || $[9] !== hidden || $[10] !== politeness) {
     t4 = () => {
       var _savedAnnouncement$cu;
       const {
@@ -70,14 +70,10 @@ function Announce(props) {
       if (!textContent) {
         return;
       }
-      if (textContent === previousAnnouncementText) {
+      if (textContent === previousAnnouncementText.current) {
         return;
       }
-      const style = window.getComputedStyle(element);
-      if (style.display === "none") {
-        return;
-      }
-      if (style.visibility === "hidden") {
+      if (!isVisible(element)) {
         return;
       }
       (_savedAnnouncement$cu = savedAnnouncement.current) === null || _savedAnnouncement$cu === void 0 ? void 0 : _savedAnnouncement$cu.cancel();
@@ -87,34 +83,33 @@ function Announce(props) {
         politeness,
         delayMs
       });
-      setPreviousAnnouncementText(textContent);
+      previousAnnouncementText.current = textContent;
     };
     $[8] = delayMs;
     $[9] = hidden;
     $[10] = politeness;
-    $[11] = previousAnnouncementText;
-    $[12] = t4;
+    $[11] = t4;
   } else {
-    t4 = $[12];
+    t4 = $[11];
   }
   const announce = useEffectCallback(t4);
   let t5;
-  if ($[13] !== announce || $[14] !== announceOnShow) {
+  if ($[12] !== announce || $[13] !== announceOnShow) {
     t5 = () => {
       if (announceOnShow) {
         announce();
       }
     };
-    $[13] = announce;
-    $[14] = announceOnShow;
-    $[15] = t5;
+    $[12] = announce;
+    $[13] = announceOnShow;
+    $[14] = t5;
   } else {
-    t5 = $[15];
+    t5 = $[14];
   }
   useEffectOnce(t5);
   let t6;
   let t7;
-  if ($[16] !== announce) {
+  if ($[15] !== announce) {
     t6 = () => {
       const {
         current: container
@@ -135,17 +130,17 @@ function Announce(props) {
       };
     };
     t7 = [announce];
-    $[16] = announce;
-    $[17] = t6;
-    $[18] = t7;
+    $[15] = announce;
+    $[16] = t6;
+    $[17] = t7;
   } else {
-    t6 = $[17];
-    t7 = $[18];
+    t6 = $[16];
+    t7 = $[17];
   }
   useEffect(t6, t7);
   let t8;
   let t9;
-  if ($[19] === Symbol.for("react.memo_cache_sentinel")) {
+  if ($[18] === Symbol.for("react.memo_cache_sentinel")) {
     t8 = () => () => {
       if (savedAnnouncement.current !== null) {
         savedAnnouncement.current.cancel();
@@ -153,26 +148,26 @@ function Announce(props) {
       }
     };
     t9 = [];
-    $[19] = t8;
-    $[20] = t9;
+    $[18] = t8;
+    $[19] = t9;
   } else {
-    t8 = $[19];
-    t9 = $[20];
+    t8 = $[18];
+    t9 = $[19];
   }
   useEffect(t8, t9);
   let t10;
-  if ($[21] !== BaseComponent || $[22] !== children || $[23] !== rest) {
+  if ($[20] !== BaseComponent || $[21] !== children || $[22] !== rest) {
     t10 = /*#__PURE__*/jsx(BaseComponent, {
       ...rest,
       ref: ref,
       children: children
     });
-    $[21] = BaseComponent;
-    $[22] = children;
-    $[23] = rest;
-    $[24] = t10;
+    $[20] = BaseComponent;
+    $[21] = children;
+    $[22] = rest;
+    $[23] = t10;
   } else {
-    t10 = $[24];
+    t10 = $[23];
   }
   return t10;
 }
@@ -186,4 +181,24 @@ function getTextContent(element) {
   return value ? value.trim() : '';
 }
 
+/**
+ * Determine if an element is visible (not hidden via `display: none` or
+ * `visibility: hidden`). Prefers the native `checkVisibility()` API when
+ * available and falls back to `getComputedStyle` for older browsers.
+ */
+function isVisible(element) {
+  if (typeof element.checkVisibility === 'function') {
+    return element.checkVisibility({
+      // `visibilityProperty` is the standard option name (Chrome 116+, Firefox
+      // 125+, Safari 17.4+); `checkVisibilityCSS` is the legacy Chromium name
+      // (Chrome 105+). Unknown options are ignored, so passing both ensures
+      // `visibility: hidden` is treated as not visible across all engines.
+      visibilityProperty: true,
+      checkVisibilityCSS: true
+    });
+  }
+  const style = window.getComputedStyle(element);
+  return style.display !== 'none' && style.visibility !== 'hidden';
+}
+
 export { Announce };

package/dist/utils/character-counter.d.ts

@@ -1,27 +1,22 @@
 /**
- * Shared character counting functionality for text inputs with character limits.
- * Handles real-time character count updates, validation, and aria-live announcements.
+ * Shared character counting helpers for text inputs with character limits.
+ * Provides the pure derivation used to render the counter and validation state.
  */
-export interface CharacterCounterCallbacks {
-    onCountUpdate: (count: number, isOverLimit: boolean, message: string) => void;
-    onScreenReaderAnnounce: (message: string) => void;
-}
-export declare class CharacterCounter {
-    private announceTimeout;
-    private callbacks;
-    private isInitialLoad;
-    constructor(callbacks: CharacterCounterCallbacks);
-    /**
-     * Update the character count based on current input value
-     */
-    updateCharacterCount(currentLength: number, maxLength: number): void;
+export declare const SCREEN_READER_DELAY = 500;
+export interface CharacterCountState {
     /**
-     * Announce character count to screen readers with debouncing
+     * Number of characters remaining before the limit is reached, or the number of
+     * characters over the limit when it has been exceeded.
      */
-    private announceToScreenReader;
-    /**
-     * Clean up any pending timeouts
-     */
-    cleanup(): void;
+    count: number;
+    /** Whether the current length exceeds the limit. */
+    isOverLimit: boolean;
+    /** Human readable description of the remaining or over count. */
+    message: string;
 }
+/**
+ * Compute the character count state for a given length and limit. This is a pure
+ * function so the counter can be derived during render without component state.
+ */
+export declare function getCharacterCountState(currentLength: number, maxLength: number): CharacterCountState;
 //# sourceMappingURL=character-counter.d.ts.map

package/dist/utils/character-counter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"character-counter.d.ts","sourceRoot":"","sources":["../../src/utils/character-counter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7E,sBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAClD;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,aAAa,CAAgB;gBAEzB,SAAS,EAAE,yBAAyB;IAIhD;;OAEG;IACH,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IA0BpE;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAc9B;;OAEG;IACH,OAAO,IAAI,IAAI;CAKhB"}
+{"version":3,"file":"character-counter.d.ts","sourceRoot":"","sources":["../../src/utils/character-counter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,mBAAmB,MAAM,CAAA;AAEtC,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,oDAAoD;IACpD,WAAW,EAAE,OAAO,CAAA;IACpB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAmBpG"}