@primer/react 38.29.0 → 38.29.1-rc.0a2dc6645

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @primer/react
 
+## 38.29.1
+
+### 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/ConfirmationDialog/useConfirm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useConfirm.d.ts","sourceRoot":"","sources":["../../src/ConfirmationDialog/useConfirm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAA;AAGxC,OAAO,EAAqB,KAAK,uBAAuB,EAAC,MAAM,sBAAsB,CAAA;AAIrF,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,GAAG;IAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAA;CAAC,CAAA;AA0BlG;;;;GAIG;AACH,wBAAgB,UAAU,cACa,cAAc,sBAIpD"}
+{"version":3,"file":"useConfirm.d.ts","sourceRoot":"","sources":["../../src/ConfirmationDialog/useConfirm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAA;AAGxC,OAAO,EAAqB,KAAK,uBAAuB,EAAC,MAAM,sBAAsB,CAAA;AAErF,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,GAAG;IAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAA;CAAC,CAAA;AAuBlG;;;;GAIG;AACH,wBAAgB,UAAU,cACa,cAAc,sBAIpD"}

package/dist/ConfirmationDialog/useConfirm.js

@@ -3,23 +3,19 @@ import { createRoot } from 'react-dom/client';
 import BaseStyles from '../BaseStyles.js';
 import { ConfirmationDialog } from './ConfirmationDialog.js';
 
-let hostElement = null;
 async function confirm(options) {
   const {
     content,
     ...confirmationDialogProps
   } = options;
   return new Promise(resolve => {
-    hostElement ||= document.createElement('div');
-    if (!hostElement.isConnected) document.body.append(hostElement);
+    const hostElement = document.createElement('div');
+    document.body.append(hostElement);
     const root = createRoot(hostElement);
     const onClose = gesture => {
       root.unmount();
-      if (gesture === 'confirm') {
-        resolve(true);
-      } else {
-        resolve(false);
-      }
+      hostElement.remove();
+      resolve(gesture === 'confirm');
     };
     root.render(/*#__PURE__*/React.createElement(BaseStyles, null, /*#__PURE__*/React.createElement(ConfirmationDialog, {
       ...confirmationDialogProps,

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,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"}
+{"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"}

package/dist/TextInput/TextInput.js

@@ -1,4 +1,4 @@
-import React, { useState, useRef, useId, useCallback, useEffect } from 'react';
+import React, { useState, useId, useCallback } from 'react';
 import { isValidElementType } from 'react-is';
 import { clsx } from 'clsx';
 import { AlertFillIcon } from '@primer/octicons-react';
@@ -8,9 +8,11 @@ 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 { CharacterCounter } from '../utils/character-counter.js';
+import visuallyHiddenClasses from '../_VisuallyHidden.module.css.js';
+import { SCREEN_READER_DELAY, getCharacterCountState } 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
@@ -46,16 +48,22 @@ const TextInput = /*#__PURE__*/React.forwardRef(({
   'data-component': dataComponent,
   ...inputProps
 }, ref) => {
+  var _counter$isOverLimit;
   const [isInputFocused, setIsInputFocused] = useState(false);
   const inputRef = useProvidedRefOrCreate(ref);
-  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('');
+
+  // 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;
 
   // this class is necessary to style FilterSearch, plz no touchy!
   const wrapperClasses = clsx(className, 'TextInput-wrapper');
@@ -84,63 +92,13 @@ 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 && 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);
-      }
+    if (characterLimit && !isControlled) {
+      setUncontrolledLength(e_2.target.value.length);
     }
     onChange === null || onChange === void 0 ? void 0 : onChange(e_2);
-  }, [onChange, characterLimit]);
+  }, [onChange, characterLimit, isControlled]);
   const characterCountId = useId();
   const characterCountStaticMessageId = useId();
   const isValid = isOverLimit ? 'error' : validationStatus;
@@ -202,10 +160,11 @@ const TextInput = /*#__PURE__*/React.forwardRef(({
         children: typeof TrailingVisual !== 'string' && isValidElementType(TrailingVisual) ? /*#__PURE__*/jsx(TrailingVisual, {}) : TrailingVisual
       }), trailingAction]
     }), characterLimit && /*#__PURE__*/jsxs(Fragment, {
-      children: [/*#__PURE__*/jsx(VisuallyHidden, {
-        "aria-live": "polite",
-        role: "status",
-        children: screenReaderMessage
+      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']
@@ -217,7 +176,7 @@ const TextInput = /*#__PURE__*/React.forwardRef(({
         "data-component": "TextInput.CharacterCounter",
         children: [isOverLimit && /*#__PURE__*/jsx(AlertFillIcon, {
           size: 16
-        }), characterCount]
+        }), counter === null || counter === void 0 ? void 0 : counter.message]
       })]
     })]
   });

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,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"}
+{"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"}

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"}

package/dist/utils/character-counter.js

@@ -1,66 +1,30 @@
 /**
- * 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.
  */
 
 const SCREEN_READER_DELAY = 500;
-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);
-    }
+/**
+ * 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`
+    };
   }
+  const charactersOver = -charactersRemaining;
+  const characterText = charactersOver === 1 ? 'character' : 'characters';
+  return {
+    count: charactersOver,
+    isOverLimit: true,
+    message: `${charactersOver} ${characterText} over`
+  };
 }
 
-export { CharacterCounter };
+export { SCREEN_READER_DELAY, getCharacterCountState };

package/package.json

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