@primer/react 38.29.1-rc.0a2dc6645 → 38.29.1-rc.4254fa28f

package/CHANGELOG.md

@@ -4,14 +4,8 @@
 
 ### Patch Changes
 
-- [#8021](https://github.com/primer/react/pull/8021) [`6131a94`](https://github.com/primer/react/commit/6131a9424b5bd5bb98b7ae05771d8187fe2f58cd) Thanks [@mattcosta7](https://github.com/mattcosta7)! - Announce, AriaStatus, AriaAlert: Avoid an extra React render on every content change (e.g. per keystroke when tied to an input)
-
 - [#7935](https://github.com/primer/react/pull/7935) [`5b3c806`](https://github.com/primer/react/commit/5b3c806305cfa09d33d42fc2957d55105725ea3b) Thanks [@copilot-swe-agent](https://github.com/apps/copilot-swe-agent)! - ConfirmationDialog: `useConfirm`/`confirm` now removes its host element from `document.body` after the dialog is closed, and uses a fresh host element per call, so the empty container no longer lingers or leaks into other components and tests
 
-- [#8021](https://github.com/primer/react/pull/8021) [`6131a94`](https://github.com/primer/react/commit/6131a9424b5bd5bb98b7ae05771d8187fe2f58cd) Thanks [@mattcosta7](https://github.com/mattcosta7)! - Textarea: Improve typing performance by deriving the character counter in render instead of in effects, removing extra re-renders on each keystroke.
-
-- [#8021](https://github.com/primer/react/pull/8021) [`6131a94`](https://github.com/primer/react/commit/6131a9424b5bd5bb98b7ae05771d8187fe2f58cd) Thanks [@mattcosta7](https://github.com/mattcosta7)! - TextInput: Improve typing performance by deriving the character counter in render instead of in effects, removing extra re-renders on each keystroke.
-
 ## 38.29.0
 
 ### Minor Changes

package/dist/TextInput/TextInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextInput.d.ts","sourceRoot":"","sources":["../../src/TextInput/TextInput.tsx"],"names":[],"mappings":"AACA,OAAO,KAAqC,MAAM,OAAO,CAAA;AAEzD,OAAO,KAAK,EAAC,mBAAmB,IAAI,8BAA8B,EAAC,MAAM,sBAAsB,CAAA;AAO/F,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,yCAAyC,CAAA;AAU/E,MAAM,MAAM,4BAA4B,GAAG;IACzC,uEAAuE;IACvE,IAAI,CAAC,EAAE,KAAK,CAAC,WAAW,CAAA;IACxB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;QAKI;IACJ,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAA;IAChD,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,CAAA;IACnD;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,CAAA;IACpD;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAA;IACvE;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,GAAG,OAAO,CACT,IAAI,CACF,kBAAkB,EAChB,OAAO,GACP,UAAU,GACV,UAAU,GACV,WAAW,GACX,OAAO,GACP,UAAU,GACV,UAAU,GACV,SAAS,GACT,MAAM,GACN,kBAAkB,CACrB,CACF,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,OAAO,CAAC,EAAE,4BAA4B,CAAC,CAAA;;;;;;;;;;;AAyNzG,wBAGE"}
+{"version":3,"file":"TextInput.d.ts","sourceRoot":"","sources":["../../src/TextInput/TextInput.tsx"],"names":[],"mappings":"AACA,OAAO,KAAwD,MAAM,OAAO,CAAA;AAE5E,OAAO,KAAK,EAAC,mBAAmB,IAAI,8BAA8B,EAAC,MAAM,sBAAsB,CAAA;AAO/F,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,yCAAyC,CAAA;AAQ/E,MAAM,MAAM,4BAA4B,GAAG;IACzC,uEAAuE;IACvE,IAAI,CAAC,EAAE,KAAK,CAAC,WAAW,CAAA;IACxB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;QAKI;IACJ,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAA;IAChD,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,CAAA;IACnD;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,CAAA;IACpD;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAA;IACvE;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,GAAG,OAAO,CACT,IAAI,CACF,kBAAkB,EAChB,OAAO,GACP,UAAU,GACV,UAAU,GACV,WAAW,GACX,OAAO,GACP,UAAU,GACV,UAAU,GACV,SAAS,GACT,MAAM,GACN,kBAAkB,CACrB,CACF,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,OAAO,CAAC,EAAE,4BAA4B,CAAC,CAAA;;;;;;;;;;;AAkQzG,wBAGE"}

package/dist/TextInput/TextInput.js

@@ -1,4 +1,4 @@
-import React, { useState, useId, useCallback } from 'react';
+import React, { useState, useRef, useId, useCallback, useEffect } from 'react';
 import { isValidElementType } from 'react-is';
 import { clsx } from 'clsx';
 import { AlertFillIcon } from '@primer/octicons-react';
@@ -8,11 +8,9 @@ import { TextInputWrapper } from '../internal/components/TextInputWrapper.js';
 import TextInputAction from '../internal/components/TextInputInnerAction.js';
 import UnstyledTextInput from '../internal/components/UnstyledTextInput.js';
 import VisuallyHidden from '../_VisuallyHidden.js';
-import visuallyHiddenClasses from '../_VisuallyHidden.module.css.js';
-import { SCREEN_READER_DELAY, getCharacterCountState } from '../utils/character-counter.js';
+import { CharacterCounter } from '../utils/character-counter.js';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 import { useProvidedRefOrCreate } from '../hooks/useProvidedRefOrCreate.js';
-import { AriaStatus } from '../live-region/AriaStatus.js';
 import Text from '../Text/Text.js';
 
 // using forwardRef is important so that other components can autofocus the input
@@ -48,22 +46,16 @@ const TextInput = /*#__PURE__*/React.forwardRef(({
   'data-component': dataComponent,
   ...inputProps
 }, ref) => {
-  var _counter$isOverLimit;
   const [isInputFocused, setIsInputFocused] = useState(false);
   const inputRef = useProvidedRefOrCreate(ref);
-
-  // For uncontrolled usage we track the length of the input's content so the
-  // character counter can be derived during render rather than synced from an
-  // effect (which would trigger an extra render on every keystroke). For
-  // controlled usage the `value` prop is the source of truth.
-  const isControlled = value !== undefined;
-  const [uncontrolledLength, setUncontrolledLength] = useState(() => defaultValue !== undefined ? String(defaultValue).length : 0);
-  const currentLength = isControlled ? String(value).length : uncontrolledLength;
-
-  // The counter and validation state are derived directly from the current
-  // length, so they stay in sync with the input without an extra render.
-  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;
+  const [characterCount, setCharacterCount] = useState('');
+  const [isOverLimit, setIsOverLimit] = useState(false);
+  const [screenReaderMessage, setScreenReaderMessage] = useState('');
+  const characterCounterRef = useRef(null);
+  const lastCountedLengthRef = useRef(null);
+  const lastCharacterCountRef = useRef('');
+  const lastIsOverLimitRef = useRef(false);
+  const lastScreenReaderMessageRef = useRef('');
 
   // this class is necessary to style FilterSearch, plz no touchy!
   const wrapperClasses = clsx(className, 'TextInput-wrapper');
@@ -92,13 +84,63 @@ const TextInput = /*#__PURE__*/React.forwardRef(({
     onBlur && onBlur(e_1);
   }, [onBlur]);
 
+  // Initialize character counter
+  useEffect(() => {
+    if (characterLimit) {
+      characterCounterRef.current = new CharacterCounter({
+        onCountUpdate: (count, overLimit, message) => {
+          if (message !== lastCharacterCountRef.current) {
+            lastCharacterCountRef.current = message;
+            setCharacterCount(message);
+          }
+          if (overLimit !== lastIsOverLimitRef.current) {
+            lastIsOverLimitRef.current = overLimit;
+            setIsOverLimit(overLimit);
+          }
+        },
+        onScreenReaderAnnounce: message_0 => {
+          if (message_0 !== lastScreenReaderMessageRef.current) {
+            lastScreenReaderMessageRef.current = message_0;
+            setScreenReaderMessage(message_0);
+          }
+        }
+      });
+      lastCountedLengthRef.current = null;
+      return () => {
+        var _characterCounterRef$;
+        (_characterCounterRef$ = characterCounterRef.current) === null || _characterCounterRef$ === void 0 ? void 0 : _characterCounterRef$.cleanup();
+        characterCounterRef.current = null;
+        lastCountedLengthRef.current = null;
+        lastCharacterCountRef.current = '';
+        lastIsOverLimitRef.current = false;
+        lastScreenReaderMessageRef.current = '';
+      };
+    }
+  }, [characterLimit]);
+
+  // Update character count when value changes or on mount
+  useEffect(() => {
+    if (characterLimit && characterCounterRef.current) {
+      const currentValue = value !== undefined ? String(value) : defaultValue !== undefined ? String(defaultValue) : '';
+      const currentLength = currentValue.length;
+      if (currentLength !== lastCountedLengthRef.current) {
+        lastCountedLengthRef.current = currentLength;
+        characterCounterRef.current.updateCharacterCount(currentLength, characterLimit);
+      }
+    }
+  }, [value, defaultValue, characterLimit]);
+
   // Handle input change with character counter
   const handleInputChange = useCallback(e_2 => {
-    if (characterLimit && !isControlled) {
-      setUncontrolledLength(e_2.target.value.length);
+    if (characterLimit && characterCounterRef.current) {
+      const currentLength_0 = e_2.target.value.length;
+      if (currentLength_0 !== lastCountedLengthRef.current) {
+        lastCountedLengthRef.current = currentLength_0;
+        characterCounterRef.current.updateCharacterCount(currentLength_0, characterLimit);
+      }
     }
     onChange === null || onChange === void 0 ? void 0 : onChange(e_2);
-  }, [onChange, characterLimit, isControlled]);
+  }, [onChange, characterLimit]);
   const characterCountId = useId();
   const characterCountStaticMessageId = useId();
   const isValid = isOverLimit ? 'error' : validationStatus;
@@ -160,11 +202,10 @@ const TextInput = /*#__PURE__*/React.forwardRef(({
         children: typeof TrailingVisual !== 'string' && isValidElementType(TrailingVisual) ? /*#__PURE__*/jsx(TrailingVisual, {}) : TrailingVisual
       }), trailingAction]
     }), 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
+      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']
@@ -176,7 +217,7 @@ const TextInput = /*#__PURE__*/React.forwardRef(({
         "data-component": "TextInput.CharacterCounter",
         children: [isOverLimit && /*#__PURE__*/jsx(AlertFillIcon, {
           size: 16
-        }), counter === null || counter === void 0 ? void 0 : counter.message]
+        }), characterCount]
       })]
     })]
   });

package/dist/Textarea/Textarea.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Textarea.d.ts","sourceRoot":"","sources":["../../src/Textarea/Textarea.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAe,MAAM,OAAO,CAAA;AAC/D,OAAO,KAAqC,MAAM,OAAO,CAAA;AAEzD,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,qCAAqC,CAAA;AAE7E,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,gBAAgB,CAAA;AASlD,eAAO,MAAM,qBAAqB,IAAI,CAAA;AACtC,eAAO,MAAM,qBAAqB,KAAK,CAAA;AACvC,eAAO,MAAM,uBAAuB,SAAS,CAAA;AAE7C,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,gBAAgB,CAAC,EAAE,oBAAoB,CAAA;IACvC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,CAAA;IACpD;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;IAC3B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,GAAG,sBAAsB,CAAC,mBAAmB,CAAC,CAAA;AAE/C;;;GAGG;AACH,QAAA,MAAM,QAAQ;IA/CZ;;OAEG;eACQ,OAAO;IAClB;;OAEG;uBACgB,oBAAoB;IACvC;;OAEG;YACK,OAAO;IACf;;OAEG;aACM,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU;IACpD;;OAEG;eACQ,OAAO;IAClB;;OAEG;gBACS,MAAM;IAClB;;OAEG;gBACS,MAAM;IAClB;;OAEG;gBACS,MAAM;IAClB;;OAEG;YACK,KAAK,CAAC,aAAa;IAC3B;;;OAGG;qBACc,MAAM;2FA6HxB,CAAA;wBAK0B,cAAc,CAAC,OAAO,QAAQ,CAAC;AAA1D,wBAA0D"}
+{"version":3,"file":"Textarea.d.ts","sourceRoot":"","sources":["../../src/Textarea/Textarea.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,sBAAsB,EAAe,MAAM,OAAO,CAAA;AAC/D,OAAO,KAA8C,MAAM,OAAO,CAAA;AAElE,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,qCAAqC,CAAA;AAE7E,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,gBAAgB,CAAA;AAOlD,eAAO,MAAM,qBAAqB,IAAI,CAAA;AACtC,eAAO,MAAM,qBAAqB,KAAK,CAAA;AACvC,eAAO,MAAM,uBAAuB,SAAS,CAAA;AAE7C,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,gBAAgB,CAAC,EAAE,oBAAoB,CAAA;IACvC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,CAAA;IACpD;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;IAC3B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,GAAG,sBAAsB,CAAC,mBAAmB,CAAC,CAAA;AAE/C;;;GAGG;AACH,QAAA,MAAM,QAAQ;IA/CZ;;OAEG;eACQ,OAAO;IAClB;;OAEG;uBACgB,oBAAoB;IACvC;;OAEG;YACK,OAAO;IACf;;OAEG;aACM,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU;IACpD;;OAEG;eACQ,OAAO;IAClB;;OAEG;gBACS,MAAM;IAClB;;OAEG;gBACS,MAAM;IAClB;;OAEG;gBACS,MAAM;IAClB;;OAEG;YACK,KAAK,CAAC,aAAa;IAC3B;;;OAGG;qBACc,MAAM;2FA2IxB,CAAA;wBAK0B,cAAc,CAAC,OAAO,QAAQ,CAAC;AAA1D,wBAA0D"}

package/dist/Textarea/Textarea.js

@@ -1,14 +1,12 @@
 import { c } from 'react-compiler-runtime';
-import React, { useId, useState } from 'react';
+import React, { useRef, useId, useEffect } from 'react';
 import { TextInputBaseWrapper } from '../internal/components/TextInputWrapper.js';
 import classes from './TextArea.module.css.js';
 import { AlertFillIcon } from '@primer/octicons-react';
-import { SCREEN_READER_DELAY, getCharacterCountState } from '../utils/character-counter.js';
+import { CharacterCounter } 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;
@@ -19,7 +17,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(76);
+  const $ = c(68);
   let block;
   let characterLimit;
   let className;
@@ -97,170 +95,200 @@ 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;
-  if ($[18] !== defaultValue) {
-    t4 = () => defaultValue !== undefined ? String(defaultValue).length : 0;
-    $[18] = defaultValue;
+  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;
     $[19] = t4;
+    $[20] = t5;
   } else {
     t4 = $[19];
+    t5 = $[20];
   }
-  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]
-        })]
+  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]
       })]
     });
-    $[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;
+    $[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;
   } else {
-    t5 = $[42];
+    t15 = $[67];
   }
-  return t5;
+  return t15;
 });
 Textarea.displayName = 'Textarea';
 Textarea.__SLOT__ = Symbol('Textarea');

package/dist/_VisuallyHidden.js

@@ -1,5 +1,5 @@
 import { c } from 'react-compiler-runtime';
-import visuallyHiddenClasses from './_VisuallyHidden.module.css.js';
+import classes 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, {
-      [visuallyHiddenClasses.InternalVisuallyHidden]: t1
+      [classes.InternalVisuallyHidden]: t1
     });
     $[6] = className;
     $[7] = t1;

package/dist/_VisuallyHidden.module.css.js

@@ -1,5 +1,5 @@
 import './_VisuallyHidden-1f156b61.css';
 
-var visuallyHiddenClasses = {"InternalVisuallyHidden":"prc-src-InternalVisuallyHidden-2YaI6"};
+var classes = {"InternalVisuallyHidden":"prc-src-InternalVisuallyHidden-2YaI6"};
 
-export { visuallyHiddenClasses as default };
+export { classes 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,qBAsGtF"}
+{"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"}

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, useEffect } from 'react';
+import { useRef, useState, 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(24);
+  const $ = c(25);
   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 = useRef(null);
+  const [previousAnnouncementText, setPreviousAnnouncementText] = useState(null);
   const savedAnnouncement = useRef(null);
   let t4;
-  if ($[8] !== delayMs || $[9] !== hidden || $[10] !== politeness) {
+  if ($[8] !== delayMs || $[9] !== hidden || $[10] !== politeness || $[11] !== previousAnnouncementText) {
     t4 = () => {
       var _savedAnnouncement$cu;
       const {
@@ -70,10 +70,14 @@ function Announce(props) {
       if (!textContent) {
         return;
       }
-      if (textContent === previousAnnouncementText.current) {
+      if (textContent === previousAnnouncementText) {
         return;
       }
-      if (!isVisible(element)) {
+      const style = window.getComputedStyle(element);
+      if (style.display === "none") {
+        return;
+      }
+      if (style.visibility === "hidden") {
         return;
       }
       (_savedAnnouncement$cu = savedAnnouncement.current) === null || _savedAnnouncement$cu === void 0 ? void 0 : _savedAnnouncement$cu.cancel();
@@ -83,33 +87,34 @@ function Announce(props) {
         politeness,
         delayMs
       });
-      previousAnnouncementText.current = textContent;
+      setPreviousAnnouncementText(textContent);
     };
     $[8] = delayMs;
     $[9] = hidden;
     $[10] = politeness;
-    $[11] = t4;
+    $[11] = previousAnnouncementText;
+    $[12] = t4;
   } else {
-    t4 = $[11];
+    t4 = $[12];
   }
   const announce = useEffectCallback(t4);
   let t5;
-  if ($[12] !== announce || $[13] !== announceOnShow) {
+  if ($[13] !== announce || $[14] !== announceOnShow) {
     t5 = () => {
       if (announceOnShow) {
         announce();
       }
     };
-    $[12] = announce;
-    $[13] = announceOnShow;
-    $[14] = t5;
+    $[13] = announce;
+    $[14] = announceOnShow;
+    $[15] = t5;
   } else {
-    t5 = $[14];
+    t5 = $[15];
   }
   useEffectOnce(t5);
   let t6;
   let t7;
-  if ($[15] !== announce) {
+  if ($[16] !== announce) {
     t6 = () => {
       const {
         current: container
@@ -130,17 +135,17 @@ function Announce(props) {
       };
     };
     t7 = [announce];
-    $[15] = announce;
-    $[16] = t6;
-    $[17] = t7;
+    $[16] = announce;
+    $[17] = t6;
+    $[18] = t7;
   } else {
-    t6 = $[16];
-    t7 = $[17];
+    t6 = $[17];
+    t7 = $[18];
   }
   useEffect(t6, t7);
   let t8;
   let t9;
-  if ($[18] === Symbol.for("react.memo_cache_sentinel")) {
+  if ($[19] === Symbol.for("react.memo_cache_sentinel")) {
     t8 = () => () => {
       if (savedAnnouncement.current !== null) {
         savedAnnouncement.current.cancel();
@@ -148,26 +153,26 @@ function Announce(props) {
       }
     };
     t9 = [];
-    $[18] = t8;
-    $[19] = t9;
+    $[19] = t8;
+    $[20] = t9;
   } else {
-    t8 = $[18];
-    t9 = $[19];
+    t8 = $[19];
+    t9 = $[20];
   }
   useEffect(t8, t9);
   let t10;
-  if ($[20] !== BaseComponent || $[21] !== children || $[22] !== rest) {
+  if ($[21] !== BaseComponent || $[22] !== children || $[23] !== rest) {
     t10 = /*#__PURE__*/jsx(BaseComponent, {
       ...rest,
       ref: ref,
       children: children
     });
-    $[20] = BaseComponent;
-    $[21] = children;
-    $[22] = rest;
-    $[23] = t10;
+    $[21] = BaseComponent;
+    $[22] = children;
+    $[23] = rest;
+    $[24] = t10;
   } else {
-    t10 = $[23];
+    t10 = $[24];
   }
   return t10;
 }
@@ -181,24 +186,4 @@ 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,22 +1,27 @@
 /**
- * Shared character counting helpers for text inputs with character limits.
- * Provides the pure derivation used to render the counter and validation state.
+ * Shared character counting functionality for text inputs with character limits.
+ * Handles real-time character count updates, validation, and aria-live announcements.
  */
-export declare const SCREEN_READER_DELAY = 500;
-export interface CharacterCountState {
+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;
     /**
-     * Number of characters remaining before the limit is reached, or the number of
-     * characters over the limit when it has been exceeded.
+     * Announce character count to screen readers with debouncing
      */
-    count: number;
-    /** Whether the current length exceeds the limit. */
-    isOverLimit: boolean;
-    /** Human readable description of the remaining or over count. */
-    message: string;
+    private announceToScreenReader;
+    /**
+     * Clean up any pending timeouts
+     */
+    cleanup(): void;
 }
-/**
- * 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;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"}
+{"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"}

package/dist/utils/character-counter.js

@@ -1,30 +1,66 @@
 /**
- * Shared character counting helpers for text inputs with character limits.
- * Provides the pure derivation used to render the counter and validation state.
+ * Shared character counting functionality for text inputs with character limits.
+ * Handles real-time character count updates, validation, and aria-live announcements.
  */
 
 const SCREEN_READER_DELAY = 500;
-/**
- * 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.
- */
-function getCharacterCountState(currentLength, maxLength) {
-  const charactersRemaining = maxLength - currentLength;
-  if (charactersRemaining >= 0) {
-    const characterText = charactersRemaining === 1 ? 'character' : 'characters';
-    return {
-      count: charactersRemaining,
-      isOverLimit: false,
-      message: `${charactersRemaining} ${characterText} remaining`
-    };
+class CharacterCounter {
+  announceTimeout = null;
+  isInitialLoad = true;
+  constructor(callbacks) {
+    this.callbacks = callbacks;
+  }
+
+  /**
+   * Update the character count based on current input value
+   */
+  updateCharacterCount(currentLength, maxLength) {
+    const charactersRemaining = maxLength - currentLength;
+    // eslint-disable-next-line no-useless-assignment
+    let message = '';
+    if (charactersRemaining >= 0) {
+      const characterText = charactersRemaining === 1 ? 'character' : 'characters';
+      message = `${charactersRemaining} ${characterText} remaining`;
+      this.callbacks.onCountUpdate(charactersRemaining, false, message);
+    } else {
+      const charactersOver = -charactersRemaining;
+      const characterText = charactersOver === 1 ? 'character' : 'characters';
+      message = `${charactersOver} ${characterText} over`;
+      this.callbacks.onCountUpdate(charactersOver, true, message);
+    }
+    if (!this.isInitialLoad) {
+      this.announceToScreenReader(message);
+    }
+
+    // After first update, set isInitialLoad to false
+    if (this.isInitialLoad) {
+      this.isInitialLoad = false;
+    }
+  }
+
+  /**
+   * Announce character count to screen readers with debouncing
+   */
+  announceToScreenReader(message) {
+    if (this.announceTimeout) {
+      clearTimeout(this.announceTimeout);
+    }
+    if (typeof window === 'undefined' || typeof window.setTimeout !== 'function') {
+      return;
+    }
+    this.announceTimeout = window.setTimeout(() => {
+      this.callbacks.onScreenReaderAnnounce(message);
+    }, SCREEN_READER_DELAY);
+  }
+
+  /**
+   * Clean up any pending timeouts
+   */
+  cleanup() {
+    if (this.announceTimeout) {
+      clearTimeout(this.announceTimeout);
+    }
   }
-  const charactersOver = -charactersRemaining;
-  const characterText = charactersOver === 1 ? 'character' : 'characters';
-  return {
-    count: charactersOver,
-    isOverLimit: true,
-    message: `${charactersOver} ${characterText} over`
-  };
 }
 
-export { SCREEN_READER_DELAY, getCharacterCountState };
+export { CharacterCounter };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@primer/react",
   "type": "module",
-  "version": "38.29.1-rc.0a2dc6645",
+  "version": "38.29.1-rc.4254fa28f",
   "description": "An implementation of GitHub's Primer Design System using React",
   "main": "./dist/index.js",
   "module": "./dist/index.js",