stream-chat-react 14.7.0 → 14.8.0

package/dist/types/components/Accessibility/scheduling/useDebouncedAnnounce.d.ts

@@ -0,0 +1,54 @@
+import type { AriaLiveAnnounce, AriaLivePriority } from '../useAriaLiveAnnouncer';
+export type DebouncedAnnounceResult = {
+    /**
+     * Schedule an announcement on the channel identified by `key`. Each call on the same key
+     * resets that key's timer, so only the last call within its `delayMs` fires. Different keys
+     * debounce independently — scheduling key `a` never cancels a pending key `b`, and each may
+     * use its own `delayMs`.
+     */
+    announce: (key: string, message: string, delayMs: number, priority?: AriaLivePriority) => void;
+    /** Cancel pending announcement(s): a single `key`, or all when omitted (also runs on unmount). */
+    cancel: (key?: string) => void;
+};
+/**
+ * L2 scheduling policy: a per-key debounce over the provided `announce` (from
+ * `useAriaLiveAnnouncer`). Keeps an independent timer per `key` and takes the delay per call, so
+ * distinct rapidly-updating streams can coexist with different debounce windows without clobbering
+ * one another (e.g. the autocomplete count, which is a consequence of typing and wants a longer
+ * window to clear the screen reader's typing echo, vs. some other future debounced stream). For a
+ * single stream, use a constant key.
+ *
+ * React 17/18/19 compatible — `useCallback`/`useRef`/`useEffect` only. All pending timers are
+ * cleared on unmount.
+ *
+ * ## When to use this vs. {@link useSettledAnnouncement}
+ *
+ * Both wait out screen-reader noise (the typing echo / field re-read) before speaking, but they
+ * model different problems:
+ *
+ * - **`useDebouncedAnnounce` — an imperative throttle for a value you announce REPEATEDLY.** You
+ *   call `announce(key, message, ...)` yourself whenever you have a fresh value (from an event
+ *   handler or effect); rapid calls on a key collapse to the last one. The message typically
+ *   *changes* each time, it can fire *again and again* (once per pause), and you drive it. Canonical
+ *   case: the autocomplete result count re-announced as the user keeps typing. It has no notion of
+ *   "active", "once", or re-arming — it just throttles whatever you push through it.
+ *
+ * - **{@link useSettledAnnouncement} — a declarative ONE-SHOT cue for a state change.** You pass
+ *   `{ active, message, settleKey }`; it announces *once* when `active`, deferred until `settleKey`
+ *   stops changing, then stays silent until `active` flips back and forth. The message is fixed and
+ *   the point is "say this single fact once the UI settles", not "announce the latest value".
+ *
+ * | | `useDebouncedAnnounce` | `useSettledAnnouncement` |
+ * | --- | --- | --- |
+ * | Style | Imperative — you call `announce(key, …)` | Declarative — reacts to `{ active, message, settleKey }` |
+ * | Repetition | Fires repeatedly, once per pause | Once per `active` epoch (re-arms on reset) |
+ * | Message | Typically changes each time | Fixed fact |
+ * | Timer reset | Each explicit call | Each `settleKey` change |
+ * | Streams | Many, independent per `key` | One logical cue |
+ * | Canonical case | Autocomplete count while typing | "Controls just became available" |
+ *
+ * Rule of thumb: announcing the **latest value of a changing thing** → this hook. Announcing a
+ * **fixed fact once, after things settle** → `useSettledAnnouncement`.
+ */
+export declare const useDebouncedAnnounce: (announce: AriaLiveAnnounce) => DebouncedAnnounceResult;
+//# sourceMappingURL=useDebouncedAnnounce.d.ts.map

package/dist/types/components/Accessibility/scheduling/useDebouncedAnnounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedAnnounce.d.ts","sourceRoot":"","sources":["../../../../../src/components/Accessibility/scheduling/useDebouncedAnnounce.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAElF,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;;OAKG;IACH,QAAQ,EAAE,CACR,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,gBAAgB,KACxB,IAAI,CAAC;IACV,kGAAkG;IAClG,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,gBAAgB,KACzB,uBAsCF,CAAC"}

package/dist/types/components/Accessibility/scheduling/useSettledAnnouncement.d.ts

@@ -0,0 +1,74 @@
+import type { AriaLiveAnnounce, AriaLivePriority } from '../useAriaLiveAnnouncer';
+export type UseSettledAnnouncementParams = {
+    /**
+     * While `true`, the announcement is (re)scheduled; when it flips back to `false` the armed/spoken
+     * state resets, so the message can fire again the next time `active` becomes `true`.
+     */
+    active: boolean;
+    /** The message to announce. The latest value is used when the announcement fires. */
+    message: string;
+    /**
+     * A value whose identity changes whenever the surrounding UI is still "in motion" — e.g. the
+     * array/string being edited, or a counter you bump on each relevant change. Every change restarts
+     * the idle timer, so the announcement only fires once activity has stopped. Pass a value that is
+     * stable between changes (an immutably-updated array/string works; avoid a fresh object literal
+     * each render, which would reset the timer forever).
+     */
+    settleKey: unknown;
+    /** Idle window (ms) the `settleKey` must be unchanged before announcing. Default `1500`. */
+    idleMs?: number;
+    /** Announce at most once per `active` epoch. When `false`, re-announces each time it settles again
+     * while still active. Default `true`. */
+    once?: boolean;
+    /** Live-region priority. Default `'polite'`. */
+    priority?: AriaLivePriority;
+};
+/**
+ * Announce a message via a live region, but only after the surrounding UI has gone idle.
+ *
+ * Use this when an immediate announcement would be **swallowed by the screen reader's own speech** —
+ * its typing echo, or the field/group re-read it performs when nearby DOM mutates. Such a read-out
+ * supersedes a competing live-region update *at any priority*, so the fix is not to fight it but to
+ * wait it out: each change to `settleKey` restarts an idle timer, and the message is announced only
+ * once the user has paused and the screen reader has fallen quiet — landing in a calm moment instead
+ * of being cut off.
+ *
+ * Typical shape: `active` is the condition that makes the announcement relevant (e.g. some controls
+ * just became available), and `settleKey` is the thing still changing (e.g. the list/text being
+ * edited). The announcement fires once per `active` epoch and re-arms when `active` goes false.
+ *
+ * Composable L2 policy over `announce` (from `useAriaLiveAnnouncer`), like
+ * {@link useDebouncedAnnounce}. React 17/18/19 compatible — `useEffect`/`useRef` only; the pending
+ * timer is cleared on unmount.
+ *
+ * ## When to use this vs. {@link useDebouncedAnnounce}
+ *
+ * Both wait out screen-reader noise (the typing echo / field re-read) before speaking, but they
+ * model different problems:
+ *
+ * - **`useSettledAnnouncement` — a declarative ONE-SHOT cue for a STATE CHANGE.** You pass
+ *   `{ active, message, settleKey }` and it reacts: it announces *once* when `active`, deferred
+ *   until `settleKey` stops changing, then stays silent until `active` flips false and true again.
+ *   The message is fixed; the point is "say this single fact once the UI settles". Canonical case:
+ *   "the reorder/remove controls just became available" once the option list stops mutating.
+ *
+ * - **{@link useDebouncedAnnounce} — an imperative throttle for a value you announce REPEATEDLY.**
+ *   You call `announce(key, message, ...)` yourself whenever you have a fresh value; rapid calls on
+ *   a key collapse to the last. The message typically *changes* and it fires *again and again* (once
+ *   per pause). Canonical case: the autocomplete result count re-announced as the user keeps typing.
+ *   It has no notion of `active`/`once`/re-arming.
+ *
+ * | | `useDebouncedAnnounce` | `useSettledAnnouncement` |
+ * | --- | --- | --- |
+ * | Style | Imperative — you call `announce(key, …)` | Declarative — reacts to `{ active, message, settleKey }` |
+ * | Repetition | Fires repeatedly, once per pause | Once per `active` epoch (re-arms on reset) |
+ * | Message | Typically changes each time | Fixed fact |
+ * | Timer reset | Each explicit call | Each `settleKey` change |
+ * | Streams | Many, independent per `key` | One logical cue |
+ * | Canonical case | Autocomplete count while typing | "Controls just became available" |
+ *
+ * Rule of thumb: announcing a **fixed fact once, after things settle** → this hook. Announcing the
+ * **latest value of a changing thing** (repeatedly) → `useDebouncedAnnounce`.
+ */
+export declare const useSettledAnnouncement: (announce: AriaLiveAnnounce, { active, idleMs, message, once, priority, settleKey, }: UseSettledAnnouncementParams) => void;
+//# sourceMappingURL=useSettledAnnouncement.d.ts.map

package/dist/types/components/Accessibility/scheduling/useSettledAnnouncement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSettledAnnouncement.d.ts","sourceRoot":"","sources":["../../../../../src/components/Accessibility/scheduling/useSettledAnnouncement.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAElF,MAAM,MAAM,4BAA4B,GAAG;IACzC;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;6CACyC;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gDAAgD;IAChD,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,gBAAgB,EAC1B,yDAOG,4BAA4B,SA4ChC,CAAC"}

package/dist/types/components/Accessibility/useAriaLiveAnnouncer.d.ts

@@ -1,5 +1,28 @@
 export type AriaLivePriority = 'assertive' | 'polite';
-export type AriaLiveAnnounce = (message: string, priority?: AriaLivePriority) => void;
+export type AriaLiveAnnounceOptions = {
+    priority?: AriaLivePriority;
+    /**
+     * Delay (ms) before the message is placed in the live region. Use to let a competing
+     * screen-reader utterance settle first — e.g. a dialog-identity announcement made while a
+     * field is being auto-focused is otherwise superseded by the field's focus announcement.
+     * Omitted/0 announces immediately.
+     */
+    delayMs?: number;
+    /**
+     * When set, an identical `message` is announced at most once per this window (ms); a repeat
+     * within the window is suppressed (returns a no-op cancel). The window starts when the message
+     * is actually announced. Guards against duplicate announcements — e.g. an effect double-invoked
+     * by React StrictMode, or rapid re-renders firing the same message.
+     */
+    dedupeMs?: number;
+};
+/**
+ * Announce `message` to assistive technology. Delivery is controlled by an options object
+ * (`priority` defaults to `'polite'`). Returns a `cancel` function: for a delayed announcement it
+ * prevents a still-pending message from being announced (call it from effect cleanup so a closing
+ * surface does not announce after unmount); for an immediate announcement it is a no-op.
+ */
+export type AriaLiveAnnounce = (message: string, options?: AriaLiveAnnounceOptions) => () => void;
 export type AriaLiveAnnouncerContextValue = {
     announce: AriaLiveAnnounce;
 };

package/dist/types/components/Accessibility/useAriaLiveAnnouncer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAriaLiveAnnouncer.d.ts","sourceRoot":"","sources":["../../../../src/components/Accessibility/useAriaLiveAnnouncer.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,QAAQ,CAAC;AACtD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEtF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAIF,eAAO,MAAM,wBAAwB,oEAEzB,CAAC;AAEb,eAAO,MAAM,oBAAoB,wBAYhC,CAAC"}
+{"version":3,"file":"useAriaLiveAnnouncer.d.ts","sourceRoot":"","sources":["../../../../src/components/Accessibility/useAriaLiveAnnouncer.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEtD,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,uBAAuB,KAC9B,MAAM,IAAI,CAAC;AAEhB,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAIF,eAAO,MAAM,wBAAwB,oEAEzB,CAAC;AAEb,eAAO,MAAM,oBAAoB,wBAYhC,CAAC"}

package/dist/types/components/Attachment/AttachmentActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AttachmentActions.d.ts","sourceRoot":"","sources":["../../../../src/components/Attachment/AttachmentActions.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAItD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAIjF,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG;IAChD,wBAAwB;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+HAA+H;IAC/H,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,+EAA+E;IAC/E,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG,OAAO,CACvD,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAChD,CAAC;AAEF,eAAO,MAAM,oCAAoC,EAAE,mCAElD,CAAC;AAEF,QAAA,MAAM,2BAA2B,GAAI,OAAO,sBAAsB,4CA6DjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAEzB,OAAO,2BAA2B,CAAC"}
+{"version":3,"file":"AttachmentActions.d.ts","sourceRoot":"","sources":["../../../../src/components/Attachment/AttachmentActions.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAMjF,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG;IAChD,wBAAwB;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+HAA+H;IAC/H,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,+EAA+E;IAC/E,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG,OAAO,CACvD,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAChD,CAAC;AAEF,eAAO,MAAM,oCAAoC,EAAE,mCAElD,CAAC;AAEF,QAAA,MAAM,2BAA2B,GAAI,OAAO,sBAAsB,4CAoKjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAEzB,OAAO,2BAA2B,CAAC"}

package/dist/types/components/Attachment/Giphy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Giphy.d.ts","sourceRoot":"","sources":["../../../../src/components/Attachment/Giphy.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAa9C,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,gBAAgB,oBAAoB,mDAqDzD,CAAC"}
+{"version":3,"file":"Giphy.d.ts","sourceRoot":"","sources":["../../../../src/components/Attachment/Giphy.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAc9C,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,gBAAgB,oBAAoB,mDA4DzD,CAAC"}

package/dist/types/components/Attachment/giphyAccessibility.d.ts

@@ -0,0 +1,11 @@
+/** True when a string looks like a media URL (so it must NOT be used as an accessible name). */
+export declare const looksLikeUrl: (value?: string | null) => boolean;
+/**
+ * Resolve a human, non-URL giphy title for accessible naming/announcements, or `undefined`.
+ * Giphy payloads rarely carry a real title (they often fall back to a media URL), so callers
+ * should provide a generic label when this returns `undefined`. Shared by `Giphy` (the image's
+ * accessible name) and `AttachmentActions` (the shuffle announcement) so the
+ * two stay in sync.
+ */
+export declare const getGiphyDescriptiveTitle: (title?: string | null) => string | undefined;
+//# sourceMappingURL=giphyAccessibility.d.ts.map

package/dist/types/components/Attachment/giphyAccessibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"giphyAccessibility.d.ts","sourceRoot":"","sources":["../../../../src/components/Attachment/giphyAccessibility.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,GAAG,IAAI,KAAG,OACV,CAAC;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,SAClB,CAAC"}

package/dist/types/components/AudioPlayback/WithAudioPlayback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WithAudioPlayback.d.ts","sourceRoot":"","sources":["../../../../src/components/AudioPlayback/WithAudioPlayback.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+B,MAAM,OAAO,CAAC;AAEpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAQxD,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAMF,eAAO,MAAM,iBAAiB,GAAI,wCAG/B,sBAAsB,4CAexB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC;AAKrD,eAAO,MAAM,cAAc,GAAI,uGAU5B,mBAAmB,oDAuCrB,CAAC;AAMF,eAAO,MAAM,oBAAoB,8DAKhC,CAAC"}
+{"version":3,"file":"WithAudioPlayback.d.ts","sourceRoot":"","sources":["../../../../src/components/AudioPlayback/WithAudioPlayback.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA0C,MAAM,OAAO,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AASxD,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAMF,eAAO,MAAM,iBAAiB,GAAI,wCAG/B,sBAAsB,4CAexB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC;AAKrD,eAAO,MAAM,cAAc,GAAI,uGAU5B,mBAAmB,oDAyCrB,CAAC;AAMF,eAAO,MAAM,oBAAoB,8DAKhC,CAAC"}

package/dist/types/components/ChannelList/ChannelListUI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChannelListUI.d.ts","sourceRoot":"","sources":["../../../../src/components/ChannelList/ChannelListUI.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAMhF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,qEAAqE;IACrE,KAAK,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IAClD,+GAA+G;IAC/G,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,WAAW,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;CAC/D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,iBAAiB,CAAC,kBAAkB,CAAC,4CAqBzE,CAAC"}
+{"version":3,"file":"ChannelListUI.d.ts","sourceRoot":"","sources":["../../../../src/components/ChannelList/ChannelListUI.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiB,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOhF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,qEAAqE;IACrE,KAAK,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IAClD,+GAA+G;IAC/G,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,WAAW,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;CAC/D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,iBAAiB,CAAC,kBAAkB,CAAC,4CA2BzE,CAAC"}

package/dist/types/components/ChannelList/hooks/index.d.ts

@@ -1,5 +1,6 @@
 export * from './useConnectionRecoveredListener';
 export * from './usePaginatedChannels';
+export * from './useChannelListKeyboardNavigation';
 export * from './useChannelMembershipState';
 export * from './useChannelMembersState';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/components/ChannelList/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/ChannelList/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/ChannelList/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC;AACvC,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC"}

package/dist/types/components/ChannelList/hooks/useChannelListKeyboardNavigation.d.ts

@@ -0,0 +1,17 @@
+import type { MouseEvent as ReactMouseEvent, RefObject } from 'react';
+/**
+ * Keyboard navigation for the channel list (`role="listbox"`). Returns handlers to spread onto the
+ * listbox element:
+ * - **ArrowUp/ArrowDown/Home/End** move focus between the channel rows (`role="option"`) and the
+ *   **Load more** button (the last roving target when present).
+ * - **ArrowRight** moves focus from a row to its actions button (the menu is then navigable with
+ *   Up/Down via the ContextMenu's own roving focus).
+ * - **ArrowLeft** moves focus from a row's actions back to the row.
+ * - When **Load more** is activated, focus moves to the **first item of the newly loaded page** once
+ *   it renders.
+ */
+export declare const useChannelListKeyboardNavigation: (listboxRef: RefObject<HTMLElement | null>) => {
+    onClickCapture: (event: ReactMouseEvent<HTMLElement>) => void;
+    onKeyDown: (event: import("react").KeyboardEvent<HTMLElement>) => void;
+};
+//# sourceMappingURL=useChannelListKeyboardNavigation.d.ts.map

package/dist/types/components/ChannelList/hooks/useChannelListKeyboardNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChannelListKeyboardNavigation.d.ts","sourceRoot":"","sources":["../../../../../src/components/ChannelList/hooks/useChannelListKeyboardNavigation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,IAAI,eAAe,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAsBtE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gCAAgC,GAC3C,YAAY,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC;4BAyCV,eAAe,CAAC,WAAW,CAAC;;CA+C5D,CAAC"}

package/dist/types/components/ChannelListItem/ChannelListItem.d.ts

@@ -3,8 +3,15 @@ import type { ReactNode } from 'react';
 import type { Channel, LocalMessage } from 'stream-chat';
 import type { MessageDeliveryStatus } from './hooks/useMessageDeliveryStatus';
 import type { GroupChannelDisplayInfo } from './utils';
+import type { ChannelListItemLabelConfig } from './utils.a11y';
 import { type ChatContextValue, type TranslationContextValue } from '../../context';
 export type ChannelListItemUIProps = ChannelListItemProps & {
+    /**
+     * Configures the row's composed accessible name (part overrides, order, separator, or a full
+     * `build`). Supply it from a `ComponentContext`-provided `ChannelListItemUI` to customize the
+     * announcement. See `composeChannelListItemAccessibleLabel`.
+     */
+    accessibleLabelConfig?: ChannelListItemLabelConfig;
     /** Image of Channel to display */
     displayImage?: string;
     /** Title of Channel to display */

package/dist/types/components/ChannelListItem/ChannelListItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChannelListItem.d.ts","sourceRoot":"","sources":["../../../../src/components/ChannelListItem/ChannelListItem.tsx"],"names":[],"mappings":"AACA,OAAO,KAAmD,MAAM,OAAO,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAS,YAAY,EAAE,MAAM,aAAa,CAAC;AAQhE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAG7B,MAAM,eAAe,CAAC;AAGvB,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,GAAG;IAC1D,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,6CAA6C;IAC7C,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,8FAA8F;IAC9F,oBAAoB,CAAC,EAAE,SAAS,CAAC;IACjC,4JAA4J;IAC5J,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,uDAAuD;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,6MAA6M;IAC7M,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,uBAAuB,CAAC,EAAE,CACxB,OAAO,EAAE,OAAO,EAChB,CAAC,EAAE,uBAAuB,CAAC,GAAG,CAAC,EAC/B,YAAY,EAAE,uBAAuB,CAAC,cAAc,CAAC,EACrD,oBAAoB,EAAE,gBAAgB,CAAC,sBAAsB,CAAC,KAC3D,SAAS,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;IAC7C,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;IACxD,2CAA2C;IAC3C,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD,CAAC;AAMF,eAAO,MAAM,yBAAyB;aAJwB,OAAO;CAIY,CAAC;AAElF,eAAO,MAAM,eAAe,GAAI,OAAO,oBAAoB,mDA4I1D,CAAC"}
+{"version":3,"file":"ChannelListItem.d.ts","sourceRoot":"","sources":["../../../../src/components/ChannelListItem/ChannelListItem.tsx"],"names":[],"mappings":"AACA,OAAO,KAAmD,MAAM,OAAO,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAS,YAAY,EAAE,MAAM,aAAa,CAAC;AAQhE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAG7B,MAAM,eAAe,CAAC;AAGvB,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,GAAG;IAC1D;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,0BAA0B,CAAC;IACnD,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,6CAA6C;IAC7C,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,8FAA8F;IAC9F,oBAAoB,CAAC,EAAE,SAAS,CAAC;IACjC,4JAA4J;IAC5J,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,uDAAuD;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,6MAA6M;IAC7M,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,uBAAuB,CAAC,EAAE,CACxB,OAAO,EAAE,OAAO,EAChB,CAAC,EAAE,uBAAuB,CAAC,GAAG,CAAC,EAC/B,YAAY,EAAE,uBAAuB,CAAC,cAAc,CAAC,EACrD,oBAAoB,EAAE,gBAAgB,CAAC,sBAAsB,CAAC,KAC3D,SAAS,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;IAC7C,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;IACxD,2CAA2C;IAC3C,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD,CAAC;AAMF,eAAO,MAAM,yBAAyB;aAJwB,OAAO;CAIY,CAAC;AAElF,eAAO,MAAM,eAAe,GAAI,OAAO,oBAAoB,mDA4I1D,CAAC"}

package/dist/types/components/ChannelListItem/ChannelListItemActionButtons.defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChannelListItemActionButtons.defaults.d.ts","sourceRoot":"","sources":["../../../../src/components/ChannelListItem/ChannelListItemActionButtons.defaults.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAI3B,MAAM,OAAO,CAAC;AAmIf,KAAK,iBAAiB,GAClB,CAAC,CAAC;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,UAAU,CAAA;CAAE,CAAC,GAAG;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC;CAChC,CAAC,GACF;IACE,SAAS,EAAE,uBAAuB,CAAC;IACnC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;CACjE,CAAC;AA8SN,eAAO,MAAM,uBAAuB,EAAE,iBAAiB,EA8BtD,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,kBAAkB,iBAAiB,EAAE,wBAiClF,CAAC"}
+{"version":3,"file":"ChannelListItemActionButtons.defaults.d.ts","sourceRoot":"","sources":["../../../../src/components/ChannelListItem/ChannelListItemActionButtons.defaults.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAK3B,MAAM,OAAO,CAAC;AAiUf,KAAK,iBAAiB,GAClB,CAAC,CAAC;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,UAAU,CAAA;CAAE,CAAC,GAAG;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC;CAChC,CAAC,GACF;IACE,SAAS,EAAE,uBAAuB,CAAC;IACnC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;CACjE,CAAC;AAoJN,eAAO,MAAM,uBAAuB,EAAE,iBAAiB,EA8BtD,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,kBAAkB,iBAAiB,EAAE,wBAiClF,CAAC"}

package/dist/types/components/ChannelListItem/ChannelListItemUI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChannelListItemUI.d.ts","sourceRoot":"","sources":["../../../../src/components/ChannelListItem/ChannelListItemUI.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE,QAAA,MAAM,2BAA2B,GAAI,OAAO,sBAAsB,4CA8FjE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAEzB,OAAO,2BAA2B,CAAC"}
+{"version":3,"file":"ChannelListItemUI.d.ts","sourceRoot":"","sources":["../../../../src/components/ChannelListItem/ChannelListItemUI.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAIhE,QAAA,MAAM,2BAA2B,GAAI,OAAO,sBAAsB,4CAkJjE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAEzB,OAAO,2BAA2B,CAAC"}

package/dist/types/components/ChannelListItem/index.d.ts

@@ -4,4 +4,5 @@ export * from './ChannelListItemActionButtons';
 export * from './ChannelListItemTimestamp';
 export * from './hooks';
 export * from './utils';
+export * from './utils.a11y';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/components/ChannelListItem/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ChannelListItem/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/ChannelListItem/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}

package/dist/types/components/ChannelListItem/utils.a11y.d.ts

@@ -0,0 +1,112 @@
+import type { Channel, LocalMessage, StreamChat } from 'stream-chat';
+import type { ChatContextValue } from '../../context';
+import type { TranslationContextValue } from '../../context/TranslationContext';
+import { type AccessibleLabelConfig, type AccessibleLabelPart } from '../../a11y/accessibleLabel';
+import { MessageDeliveryStatus } from './hooks/useMessageDeliveryStatus';
+/**
+ * Everything a label part needs. Gathered by `ChannelListItemUI` from its props + contexts and
+ * handed to each {@link ChannelListItemLabelPart}.
+ */
+export type ChannelListItemLabelData = {
+    /** Whether the row is the active (currently open) channel. */
+    active?: boolean;
+    /** The channel whose latest message is summarized. */
+    channel: Channel;
+    /** Client, used to detect whether the latest message is the current user's own. */
+    client: StreamChat;
+    /** Channel display name. */
+    displayTitle?: string;
+    isMessageAIGenerated?: ChatContextValue['isMessageAIGenerated'];
+    /**
+     * The channel's latest message. {@link composeChannelListItemAccessibleLabel} resolves this once
+     * (to the last entry of `channel.state.latestMessages` when omitted) and passes the SAME message
+     * to every part, so all segments (sender, preview, attachments, time) describe one message.
+     */
+    latestMessage?: LocalMessage;
+    /** Delivery/read status of the latest message when it is the current user's own. */
+    messageDeliveryStatus?: MessageDeliveryStatus;
+    t: TranslationContextValue['t'];
+    tDateTimeParser: TranslationContextValue['tDateTimeParser'];
+    /** Unread count for the channel. */
+    unreadCount?: number;
+    userLanguage?: TranslationContextValue['userLanguage'];
+};
+/** Produces one segment of the accessible name; return `undefined`/empty to omit it. */
+export type ChannelListItemLabelPart = AccessibleLabelPart<ChannelListItemLabelData>;
+/**
+ * The default, named label parts. Each is independently overridable via
+ * {@link ChannelListItemLabelConfig.parts}. The active (currently open) state is announced here (not
+ * left to the row's `aria-selected` alone, which is not reliably spoken across screen readers for an
+ * option with a custom name); `aria-selected` is kept on the active row for listbox semantics.
+ */
+export declare const defaultChannelListItemLabelParts: {
+    active: AccessibleLabelPart<{
+        t: TranslationContextValue["t"];
+    } & {
+        active?: boolean;
+    }>;
+    attachments: ({ latestMessage, t }: ChannelListItemLabelData) => string | undefined;
+    deliveryStatus: ({ messageDeliveryStatus, t }: ChannelListItemLabelData) => string | undefined;
+    lastMessage: ({ channel, client, isMessageAIGenerated, latestMessage, t, userLanguage, }: ChannelListItemLabelData) => string;
+    linkPreview: ({ latestMessage, t }: ChannelListItemLabelData) => string | undefined;
+    name: ({ displayTitle }: ChannelListItemLabelData) => string | undefined;
+    time: ({ latestMessage, t, tDateTimeParser }: ChannelListItemLabelData) => string | undefined;
+    unreadCount: AccessibleLabelPart<{
+        t: TranslationContextValue["t"];
+    } & {
+        unreadCount?: number;
+    }>;
+};
+/** Default order the parts are assembled in (reading order). */
+export declare const DEFAULT_CHANNEL_LIST_ITEM_LABEL_ORDER: readonly ["name", "active", "unreadCount", "lastMessage", "attachments", "linkPreview", "deliveryStatus", "time"];
+export type ChannelListItemLabelConfig = AccessibleLabelConfig<ChannelListItemLabelData>;
+/**
+ * Composes a single, coherent accessible name for a channel list row from named parts. The default
+ * reading order is name → unread → last message (sender + preview) → delivery status → time.
+ *
+ * ## Customizing the label
+ *
+ * The label is generated by `ChannelListItemUI`, which accepts an `accessibleLabelConfig` prop. To
+ * customize it, supply your own `ChannelListItemUI` through `ComponentContext` (the same way the
+ * component is overridden) and forward the config — no new plumbing:
+ *
+ * ```tsx
+ * const MyChannelPreview = (props) => (
+ *   <DefaultChannelListItemUI {...props} accessibleLabelConfig={accessibleLabelConfig} />
+ * );
+ * // <ComponentProvider value={{ ChannelListItemUI: MyChannelPreview }}> … </ComponentProvider>
+ * ```
+ *
+ * ### Adding custom parts (e.g. Pinned, Muted, Frozen)
+ *
+ * - {@link ChannelListItemLabelConfig.parts} is merged over {@link defaultChannelListItemLabelParts},
+ *   so a new key is *added* and a same-named key *overrides* the default.
+ * - A part returns its segment string, or `undefined`/`''` to be omitted (so e.g. "Pinned" is only
+ *   spoken when actually pinned).
+ * - {@link ChannelListItemLabelConfig.order} decides which parts are included AND their sequence —
+ *   **a part not listed in `order` is never rendered**, even if defined. Spread
+ *   {@link DEFAULT_CHANNEL_LIST_ITEM_LABEL_ORDER} to keep the defaults and insert your own.
+ * - Each part receives {@link ChannelListItemLabelData}. `active`/`unreadCount`/
+ *   `messageDeliveryStatus` are passed directly and `latestMessage` is pre-resolved by the composer
+ *   (see its doc); everything else (mute/pin state, `frozen`, member count, custom `channel.data`) is
+ *   read off `channel`. Parts call `t`, so provide your own i18n keys (or return plain strings) —
+ *   the SDK does not ship `Pinned`/`Muted`/`Frozen` strings.
+ *
+ * ```tsx
+ * const accessibleLabelConfig: ChannelListItemLabelConfig = {
+ *   parts: {
+ *     pinned: ({ channel, t }) => (channel.state.membership?.pinned_at ? t('Pinned') : undefined),
+ *     muted: ({ channel, t }) => (channel.muteStatus().muted ? t('Muted') : undefined),
+ *     frozen: ({ channel, t }) => (channel.data?.frozen ? t('Frozen') : undefined),
+ *   },
+ *   order: ['name', 'pinned', 'muted', 'frozen', ...DEFAULT_CHANNEL_LIST_ITEM_LABEL_ORDER.slice(1)],
+ * };
+ * // → "General. Pinned. Muted. 3 unread messages. Last message from Alice: hi. 2 days ago"
+ * ```
+ *
+ * For full control, set {@link ChannelListItemLabelConfig.build} (return the entire string), or
+ * write a custom `ChannelListItemUI` that calls this function directly — importing
+ * {@link defaultChannelListItemLabelParts} to reuse the built-ins.
+ */
+export declare const composeChannelListItemAccessibleLabel: (data: ChannelListItemLabelData, config?: ChannelListItemLabelConfig) => string;
+//# sourceMappingURL=utils.a11y.d.ts.map

package/dist/types/components/ChannelListItem/utils.a11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.a11y.d.ts","sourceRoot":"","sources":["../../../../src/components/ChannelListItem/utils.a11y.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EAIzB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,mFAAmF;IACnF,MAAM,EAAE,UAAU,CAAC;IACnB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IAChE;;;;OAIG;IACH,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,oFAAoF;IACpF,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,CAAC,EAAE,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAChC,eAAe,EAAE,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;IAC5D,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,uBAAuB,CAAC,cAAc,CAAC,CAAC;CACxD,CAAC;AAEF,wFAAwF;AACxF,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,CAAC,wBAAwB,CAAC,CAAC;AAErF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;CA6EO,CAAC;AAErD,gEAAgE;AAChE,eAAO,MAAM,qCAAqC,mHASxC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAAG,qBAAqB,CAAC,wBAAwB,CAAC,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,eAAO,MAAM,qCAAqC,GAChD,MAAM,wBAAwB,EAC9B,SAAQ,0BAA+B,KACtC,MAcA,CAAC"}

package/dist/types/components/ChannelListItem/utils.d.ts

@@ -1,9 +1,17 @@
 import type { ReactNode } from 'react';
-import type { Channel } from 'stream-chat';
+import type { Channel, LocalMessage } from 'stream-chat';
 import type { ChatContextValue } from '../../context';
 import type { TranslationContextValue } from '../../context/TranslationContext';
 export declare const renderPreviewText: (text: string) => import("react/jsx-runtime").JSX.Element;
-export declare const getLatestMessagePreview: (channel: Channel, t: TranslationContextValue["t"], userLanguage?: TranslationContextValue["userLanguage"], isMessageAIGenerated?: ChatContextValue["isMessageAIGenerated"]) => ReactNode;
+/**
+ * The text announced for the channel's latest message (for an accessible name / live region).
+ * Non-text content gets a concise, screen-reader-friendly phrasing that may differ from the visible
+ * preview: a poll announces its question, an attachment its type, a shared location and a deleted
+ * message a plain phrase. User-message text is stripped of markdown so the words are read, not the
+ * syntax (AI-generated text is returned verbatim, matching the display path).
+ */
+export declare const getLatestMessagePreviewText: (channel: Channel, t: TranslationContextValue["t"], userLanguage?: TranslationContextValue["userLanguage"], isMessageAIGenerated?: ChatContextValue["isMessageAIGenerated"], latestMessage?: LocalMessage) => string;
+export declare const getLatestMessagePreview: (channel: Channel, t: TranslationContextValue["t"], userLanguage?: TranslationContextValue["userLanguage"], isMessageAIGenerated?: ChatContextValue["isMessageAIGenerated"], latestMessage?: LocalMessage) => ReactNode;
 export type GroupChannelDisplayInfoMember = {
     imageUrl?: string;
     userName?: string;

package/dist/types/components/ChannelListItem/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/components/ChannelListItem/utils.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,aAAa,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAahF,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,4CAI7C,CAAC;AAeF,eAAO,MAAM,uBAAuB,GAClC,SAAS,OAAO,EAChB,GAAG,uBAAuB,CAAC,GAAG,CAAC,EAC/B,eAAc,uBAAuB,CAAC,cAAc,CAAQ,EAC5D,uBAAuB,gBAAgB,CAAC,sBAAsB,CAAC,KAC9D,SAiEF,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACzC,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,OAAO,EAChB,gBAAgB,MAAM,KACrB,MAAM,GAAG,SAWX,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,SAAS,OAAO,KACf,uBAAuB,GAAG,SAa5B,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/components/ChannelListItem/utils.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAY,MAAM,aAAa,CAAC;AAKnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAahF,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,4CAI7C,CAAC;AAkNF;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,GACtC,SAAS,OAAO,EAChB,GAAG,uBAAuB,CAAC,GAAG,CAAC,EAC/B,eAAc,uBAAuB,CAAC,cAAc,CAAQ,EAC5D,uBAAuB,gBAAgB,CAAC,sBAAsB,CAAC,EAC/D,gBAAgB,YAAY,KAC3B,MA2CF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,SAAS,OAAO,EAChB,GAAG,uBAAuB,CAAC,GAAG,CAAC,EAC/B,eAAc,uBAAuB,CAAC,cAAc,CAAQ,EAC5D,uBAAuB,gBAAgB,CAAC,sBAAsB,CAAC,EAC/D,gBAAgB,YAAY,KAC3B,SAeF,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACzC,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,OAAO,EAChB,gBAAgB,MAAM,KACrB,MAAM,GAAG,SAWX,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,SAAS,OAAO,KACf,uBAAuB,GAAG,SAa5B,CAAC"}

package/dist/types/components/Chat/Chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../../src/components/Chat/Chat.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAGL,gBAAgB,EAEjB,MAAM,aAAa,CAAC;AAIrB,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,kBAAkB,CAAC;AAK1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI/D,OAAO,EACL,KAAK,mBAAmB,EAGzB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AA6CxD,MAAM,MAAM,SAAS,GAAG;IACtB,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,8FAA8F;IAC9F,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,oGAAoG;IACpG,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,8BAA8B;IAC9B,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,8EAA8E;IAC9E,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC,GAAG,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,CAAC,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,IAAI,GAAI,OAAO,iBAAiB,CAAC,SAAS,CAAC,mDA2EvD,CAAC"}
+{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../../src/components/Chat/Chat.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAGL,gBAAgB,EAEjB,MAAM,aAAa,CAAC;AAQrB,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,kBAAkB,CAAC;AAK1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI/D,OAAO,EACL,KAAK,mBAAmB,EAGzB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAqDxD,MAAM,MAAM,SAAS,GAAG;IACtB,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,8FAA8F;IAC9F,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,oGAAoG;IACpG,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,8BAA8B;IAC9B,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,8EAA8E;IAC9E,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC,GAAG,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,CAAC,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,IAAI,GAAI,OAAO,iBAAiB,CAAC,SAAS,CAAC,mDA8EvD,CAAC"}

package/dist/types/components/ChatView/ChatView.a11y.utility.d.ts

@@ -1,25 +1,17 @@
 /**
- * Right now, a11y in ChatView does one thing: it provides correct ARIA
- * relationships for tabs.
+ * ChatView is a top-level view switcher between two parallel, independent
+ * surfaces (channels and threads). It is NOT a WAI-ARIA Tabs widget: each view
+ * owns its own composer and message list and is not a panel of a single
+ * composite widget. The selector is a navigation landmark (role="navigation")
+ * whose buttons mark the active surface via aria-current="true" (generic
+ * "current item"; not "page", since the SDK may be embedded in a larger host UI).
  *
- * Specifically:
- * - ChatView.Selector is role="tablist".
- * - Each selector button is role="tab" with:
- *   - unique id
- *   - aria-controls=<panel-id>
- *   - aria-selected
- *   - tabIndex=0 (all tabs tabbable)
- * - Active panel container is role="tabpanel" with:
- *   - id=<panel-id>
- *   - aria-labelledby=<tab-id>
- *
- * The a11y helper module exists to generate and share those tab/panel IDs per
- * ChatView instance, so tab ↔ tabpanel linkage stays correct and collision-safe
- * when multiple ChatViews exist.
+ * The helper generates stable per-instance DOM ids for the view containers so
+ * integrators (skip-links, programmatic focus) have predictable hooks even
+ * when multiple ChatViews coexist.
  */
 export type ChatViewA11yContextValue = {
     chatViewPanelIds: Record<'channels' | 'threads', string>;
-    chatViewTabIds: Record<'channels' | 'threads', string>;
 };
 export declare const DEFAULT_CHAT_VIEW_A11Y_CONTEXT_VALUE: ChatViewA11yContextValue;
 export declare const createChatViewA11yContextValue: (chatViewId: string) => ChatViewA11yContextValue;

package/dist/types/components/ChatView/ChatView.a11y.utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatView.a11y.utility.d.ts","sourceRoot":"","sources":["../../../../src/components/ChatView/ChatView.a11y.utility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,wBAAwB,GAAG;IAErC,gBAAgB,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,EAAE,MAAM,CAAC,CAAC;IACzD,cAAc,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,EAAE,MAAM,CAAC,CAAC;CACxD,CAAC;AAEF,eAAO,MAAM,oCAAoC,EAAE,wBASlD,CAAC;AAEF,eAAO,MAAM,8BAA8B,GACzC,YAAY,MAAM,KACjB,wBAUD,CAAC"}
+{"version":3,"file":"ChatView.a11y.utility.d.ts","sourceRoot":"","sources":["../../../../src/components/ChatView/ChatView.a11y.utility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,gBAAgB,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,EAAE,MAAM,CAAC,CAAC;CAC1D,CAAC;AAEF,eAAO,MAAM,oCAAoC,EAAE,wBAKlD,CAAC;AAEF,eAAO,MAAM,8BAA8B,GACzC,YAAY,MAAM,KACjB,wBAKD,CAAC"}

package/dist/types/components/ChatView/ChatView.d.ts

@@ -4,13 +4,13 @@ import type { PropsWithChildren } from 'react';
 import type { Thread } from 'stream-chat';
 export type ChatView = 'channels' | 'threads';
 /**
- * ChatView accessibility contract (WAI-ARIA Tabs):
- * 1) Selector container is role="tablist".
- * 2) Each selector button is role="tab", with id + aria-controls=<panel-id>.
- * 3) Each view container is role="tabpanel", with id + aria-labelledby=<tab-id>.
- * 4) Tab activation updates the active panel.
- * 5) Tabs are always tabbable (tabIndex=0), so users can reach both without
- *    arrow-key navigation.
+ * ChatView switches between two independent surfaces, not panels in a single
+ * WAI-ARIA Tabs widget. The selector is a navigation landmark
+ * (`role="navigation"`) holding one button per surface; the button for the
+ * surface currently shown is marked with `aria-current="true"` (the "current
+ * item in a set" — not `"page"`, since this SDK view may be embedded in a larger
+ * host UI that owns the page). View wrappers stay plain `<div>`s to avoid leaking
+ * ancestor context into descendants like the composer textarea.
  */
 type ChatViewContextValue = {
     activeChatView: ChatView;

package/dist/types/components/ChatView/ChatView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatView.d.ts","sourceRoot":"","sources":["../../../../src/components/ChatView/ChatView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EACZ,KAAK,aAAa,EAMnB,MAAM,OAAO,CAAC;AAGf,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAsBrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AAE9D,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE9C;;;;;;;;GAQG;AACH,KAAK,oBAAoB,GAAG;IAC1B,cAAc,EAAE,QAAQ,CAAC;IACzB,iBAAiB,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF,eAAO,MAAM,eAAe,iDAA6D,CAAC;AAK1F,eAAO,MAAM,kBAAkB,4BAW9B,CAAC;AAGF,eAAO,MAAM,QAAQ;mBAAkB,iBAAiB;6BAsBpB,iBAAiB;4BA+BlB,iBAAiB;kCAqEf,iBAAiB;uCAoLnD,qBAAqB;CA1RvB,CAAC;AAqBF,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,eAAe,EAAE,CAAC,EAAE,EAAE,uBAAuB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;CACxE,CAAC;AAOF,eAAO,MAAM,qBAAqB,+BAAuC,CAAC;AA4B1E,eAAO,MAAM,eAAe,GAAI,kBAAkB;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,SAuB1E,CAAC;AAkDF,eAAO,MAAM,sBAAsB,GAAI,+EASpC,WAAW,GAAG;IACf,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,4CA6BA,CAAC;AAWF,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,8BAA8B,GAAI,eAE5C,yBAAyB,4CAuB3B,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,eAE3C,yBAAyB,4CAkC3B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAC1D,IAAI,EAAE,MAAM,GAAG,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAEzD,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACnC,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,qBAAqB,EASjE,CAAC"}
+{"version":3,"file":"ChatView.d.ts","sourceRoot":"","sources":["../../../../src/components/ChatView/ChatView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EACZ,KAAK,aAAa,EAMnB,MAAM,OAAO,CAAC;AAGf,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAsBrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AAE9D,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE9C;;;;;;;;GAQG;AACH,KAAK,oBAAoB,GAAG;IAC1B,cAAc,EAAE,QAAQ,CAAC;IACzB,iBAAiB,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF,eAAO,MAAM,eAAe,iDAA6D,CAAC;AAK1F,eAAO,MAAM,kBAAkB,4BAW9B,CAAC;AAGF,eAAO,MAAM,QAAQ;mBAAkB,iBAAiB;6BAsBpB,iBAAiB;4BA0BlB,iBAAiB;kCAgEf,iBAAiB;uCAgLnD,qBAAqB;CA5QvB,CAAC;AAgBF,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,eAAe,EAAE,CAAC,EAAE,EAAE,uBAAuB,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;CACxE,CAAC;AAOF,eAAO,MAAM,qBAAqB,+BAAuC,CAAC;AAuB1E,eAAO,MAAM,eAAe,GAAI,kBAAkB;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,SAuB1E,CAAC;AAkDF,eAAO,MAAM,sBAAsB,GAAI,+EASpC,WAAW,GAAG;IACf,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,4CA6BA,CAAC;AAWF,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,8BAA8B,GAAI,eAE5C,yBAAyB,4CAkB3B,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,eAE3C,yBAAyB,4CAmC3B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAC1D,IAAI,EAAE,MAAM,GAAG,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAEzD,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACnC,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,qBAAqB,EASjE,CAAC"}

package/dist/types/components/Dialog/components/ContextMenu.d.ts

@@ -84,7 +84,7 @@ type ButtonWithSubmenuProps = {
 };
 type ContextMenuButtonProps = BaseContextMenuButtonProps & Partial<ButtonWithSubmenuProps>;
 export declare const ContextMenuButton: (props: ContextMenuButtonProps) => import("react/jsx-runtime").JSX.Element;
-export declare const ContextMenuBackButton: ({ children, className, role, ...props }: ComponentProps<"button">) => import("react/jsx-runtime").JSX.Element;
+export declare const ContextMenuBackButton: ({ "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, children, className, role, ...props }: ComponentProps<"button">) => import("react/jsx-runtime").JSX.Element;
 export declare const ContextMenuHeader: ({ children, className, ...props }: ComponentProps<"div">) => import("react/jsx-runtime").JSX.Element;
 export declare const ContextMenuBody: ({ children, className, ...props }: ComponentProps<"div">) => import("react/jsx-runtime").JSX.Element;
 export declare const ContextMenuRoot: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
@@ -101,6 +101,15 @@ type ContextMenuFocusRestoreRequest = {
     index: number;
     target: HTMLElement | null;
 };
+/**
+ * Where focus should land when a submenu OPENS (forward navigation):
+ * - `'first-item'` (default): the first focusable item that is NOT in the header — i.e. the first
+ *   real menu option, skipping a back-button header — falling back to the very first item when the
+ *   body has none.
+ * - `'first'`: the first focusable item overall (the back-button header when present).
+ * - `'none'`: do not move focus on open.
+ */
+export type ContextMenuSubmenuInitialFocus = 'first' | 'first-item' | 'none';
 export type ContextMenuKeyboardNavigation = {
     /**
      * CSS selector used to collect focusable menu items.
@@ -119,6 +128,11 @@ type ContextMenuContextValue = {
 export declare const useContextMenuContext: () => ContextMenuContextValue;
 type ContextMenuLevel = {
     focusRestoreRequest?: ContextMenuFocusRestoreRequest;
+    /**
+     * Where focus lands when this level is opened as a submenu (forward navigation). Defaults to
+     * `'first-item'`. Ignored for the root level (its initial focus is the dialog's `autoFocus`).
+     */
+    initialFocus?: ContextMenuSubmenuInitialFocus;
     items?: ContextMenuItemComponent[];
     Submenu?: ContextMenuSubmenu;
     Header?: ContextMenuHeaderComponent;
@@ -126,6 +140,7 @@ type ContextMenuLevel = {
     menuClassName?: string;
 };
 type ContextMenuBaseProps = ComponentPropsWithoutRef<'div'> & {
+    backButtonAriaLabel?: string;
     backLabel?: ReactNode;
     enableAnimations?: boolean;
     Header?: ContextMenuHeaderComponent;
@@ -155,7 +170,7 @@ export type ContextMenuContentProps = ContextMenuBaseProps & {
  * customize submenu/back navigation behavior while keeping the same anchor/focus
  * handling from `ContextMenu`.
  */
-export declare function ContextMenuContent({ anchorReferenceElement, backLabel, children, className, enableAnimations, Header, items, ItemsWrapper, keyboardNavigation, menuClassName, onClose, onMenuLevelChange, transitionDirection, ...props }: ContextMenuContentProps): import("react/jsx-runtime").JSX.Element;
+export declare function ContextMenuContent({ anchorReferenceElement, backButtonAriaLabel, backLabel, children, className, enableAnimations, Header, items, ItemsWrapper, keyboardNavigation, menuClassName, onClose, onMenuLevelChange, transitionDirection, ...props }: ContextMenuContentProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Contextual actions menu that can be used in two modes:
  *