@runtypelabs/persona 4.19.0 → 4.20.0

package/dist/approval-ui.d.cts

@@ -1224,27 +1224,66 @@ interface ComposerSegmentedTokens {
     itemPadding?: string;
 }
 /**
- * Model picker popover (`composer.modelPicker.presentation: "popover"`).
+ * Model picker chrome (`composer.models`).
+ *
+ * The surface keys (`background`, `hoverBackground`, `borderColor`,
+ * `borderRadius`, `labelColor`) style the CLOSED control, so the native
+ * `<select>` and the `presentation: "popover"` trigger share one vocabulary.
+ * The `menu*`, `rowHoverBackground`, and `descriptionColor` keys style the
+ * popover panel and are inert under the native select, as is `suffixColor`,
+ * which a `<select>` cannot carry either.
  *
  * Every key is optional and unset ones emit nothing: the stylesheet's `var()`
  * fallbacks own the default look, which derives from the surface and ghost
- * button tokens. Inert under the native `<select>` presentation, except
- * `suffixColor`, which the native control cannot carry either.
+ * button tokens.
  */
 interface ComposerModelPickerTokens {
+    /** Closed control fill. @default the ghost button fill (transparent) */
+    background?: TokenReference<'color'>;
+    /** Closed control fill under hover. @default the ghost hover wash */
+    hoverBackground?: TokenReference<'color'>;
+    /**
+     * Closed control outline, drawn as a 1px inset ring so setting it never
+     * resizes the control. @default none
+     */
+    borderColor?: TokenReference<'color'>;
+    /** Closed control corner radius. @default the ghost button radius */
+    borderRadius?: TokenReference<'radius'>;
     /** Panel fill behind the rows. @default semantic.colors.surface */
     menuBackground?: TokenReference<'color'>;
     /** Panel corner radius. @default palette.radius.lg */
     menuBorderRadius?: TokenReference<'radius'>;
     /** Row fill under hover and the focused option. @default the ghost hover wash */
     rowHoverBackground?: TokenReference<'color'>;
-    /** Row label and closed-control label color. @default inherited text */
+    /**
+     * Row label color, plus the closed control's text and chevron in both
+     * presentations. @default the ghost button foreground
+     */
     labelColor?: TokenReference<'color'>;
     /** Second line under a row label. @default semantic.colors.textMuted */
     descriptionColor?: TokenReference<'color'>;
     /** `composer.modelPicker.suffix` on the closed control. @default semantic.colors.textMuted */
     suffixColor?: TokenReference<'color'>;
 }
+/**
+ * Composer overflow `+` menu panel (`composer.actionOverflow`).
+ *
+ * Every key is optional and unset ones emit nothing: the stylesheet's `var()`
+ * fallbacks own the default look. The panel is portaled outside the themed
+ * mount, so the menu forwards the configured values onto it when it opens.
+ */
+interface ComposerOverflowMenuTokens {
+    /** Panel fill behind the rows. @default semantic.colors.surface */
+    background?: TokenReference<'color'>;
+    /** Panel border color. @default semantic.colors.border */
+    borderColor?: TokenReference<'color'>;
+    /** Panel corner radius. @default palette.radius.lg */
+    borderRadius?: TokenReference<'radius'>;
+    /** Row text and glyph color. @default semantic.colors.text */
+    foreground?: TokenReference<'color'>;
+    /** Panel elevation (raw CSS box-shadow, `none` allowed). @default palette.shadows.md */
+    shadow?: string;
+}
 /** Composer (message input) chrome. */
 interface ComposerChromeTokens {
     /** Box-shadow on the composer form (raw CSS, e.g. `none`). */
@@ -1279,8 +1318,10 @@ interface ComposerChromeTokens {
     overlayBand?: string;
     /** Segmented mode-group track. */
     segmented?: ComposerSegmentedTokens;
-    /** Model picker popover chrome. */
+    /** Model picker chrome (closed control plus popover panel). */
     modelPicker?: ComposerModelPickerTokens;
+    /** Overflow `+` menu panel chrome. */
+    overflowMenu?: ComposerOverflowMenuTokens;
 }
 /**
  * Motion timing shared by every composer animation.
@@ -5717,6 +5758,15 @@ type ComposerActionPlacement = "start" | "end";
  * it, `"overflow"` and `"auto"` both render in the bar.
  */
 type ComposerActionPresentation = "bar" | "overflow" | "auto";
+/**
+ * When a composer action is mounted, as a function of the draft.
+ *
+ * - `"always"` (default): the control is always mounted.
+ * - `"when-empty"`: hidden as soon as the draft holds text or an attachment,
+ *   and while a response streams.
+ * - `"when-text"`: the inverse, on the same draft state the send control reads.
+ */
+type ComposerActionVisibility = "always" | "when-empty" | "when-text";
 /**
  * Fields shared by every composer action.
  *
@@ -5732,6 +5782,13 @@ type ComposerActionBase = {
     presentation?: ComposerActionPresentation;
     order?: number;
     visible?: boolean | ((state: Readonly<ComposerState>) => boolean);
+    /**
+     * Draft-driven visibility, on the same state `sendButton.visibility` reads.
+     * Hidden removes the control from layout and tab order. Combined with
+     * `visible`: both must pass.
+     * @default "always"
+     */
+    visibility?: ComposerActionVisibility;
     disabled?: boolean | ((state: Readonly<ComposerState>) => boolean);
     /** Disable while a response streams, through the composer's own mechanism. */
     disableWhenStreaming?: boolean;
@@ -5878,6 +5935,15 @@ type ComposerMode = {
  *   row, never in the overflow menu.
  */
 type ComposerModeGroupPresentation = "buttons" | "segmented";
+/**
+ * Whether a group's active modes also render as removable chips.
+ *
+ * - `"auto"` (default): one chip per active mode, except under `"segmented"`
+ *   presentation, where the track already shows the state.
+ * - `"hidden"`: no chips for this group under any presentation. The pressed bar
+ *   button carries the state, and deselection stays on the button.
+ */
+type ComposerModeChipVisibility = "auto" | "hidden";
 /**
  * Selection policy for a set of modes. `"single"` deselects siblings when one
  * is chosen; `"multiple"` toggles independently.
@@ -5887,6 +5953,12 @@ type ComposerModeGroup = {
     selection: "single" | "multiple";
     /** @default "buttons" */
     presentation?: ComposerModeGroupPresentation;
+    /**
+     * Chip row policy for this group's active modes. The chip row itself is
+     * derived from its children, so a group with no other chips leaves no gap.
+     * @default "auto"
+     */
+    chipVisibility?: ComposerModeChipVisibility;
     /**
      * Accessible name for a segmented track. With it the track is a labelled
      * `role="group"`; without it the segments stand on their own names.

package/dist/approval-ui.d.ts

@@ -1224,27 +1224,66 @@ interface ComposerSegmentedTokens {
     itemPadding?: string;
 }
 /**
- * Model picker popover (`composer.modelPicker.presentation: "popover"`).
+ * Model picker chrome (`composer.models`).
+ *
+ * The surface keys (`background`, `hoverBackground`, `borderColor`,
+ * `borderRadius`, `labelColor`) style the CLOSED control, so the native
+ * `<select>` and the `presentation: "popover"` trigger share one vocabulary.
+ * The `menu*`, `rowHoverBackground`, and `descriptionColor` keys style the
+ * popover panel and are inert under the native select, as is `suffixColor`,
+ * which a `<select>` cannot carry either.
  *
  * Every key is optional and unset ones emit nothing: the stylesheet's `var()`
  * fallbacks own the default look, which derives from the surface and ghost
- * button tokens. Inert under the native `<select>` presentation, except
- * `suffixColor`, which the native control cannot carry either.
+ * button tokens.
  */
 interface ComposerModelPickerTokens {
+    /** Closed control fill. @default the ghost button fill (transparent) */
+    background?: TokenReference<'color'>;
+    /** Closed control fill under hover. @default the ghost hover wash */
+    hoverBackground?: TokenReference<'color'>;
+    /**
+     * Closed control outline, drawn as a 1px inset ring so setting it never
+     * resizes the control. @default none
+     */
+    borderColor?: TokenReference<'color'>;
+    /** Closed control corner radius. @default the ghost button radius */
+    borderRadius?: TokenReference<'radius'>;
     /** Panel fill behind the rows. @default semantic.colors.surface */
     menuBackground?: TokenReference<'color'>;
     /** Panel corner radius. @default palette.radius.lg */
     menuBorderRadius?: TokenReference<'radius'>;
     /** Row fill under hover and the focused option. @default the ghost hover wash */
     rowHoverBackground?: TokenReference<'color'>;
-    /** Row label and closed-control label color. @default inherited text */
+    /**
+     * Row label color, plus the closed control's text and chevron in both
+     * presentations. @default the ghost button foreground
+     */
     labelColor?: TokenReference<'color'>;
     /** Second line under a row label. @default semantic.colors.textMuted */
     descriptionColor?: TokenReference<'color'>;
     /** `composer.modelPicker.suffix` on the closed control. @default semantic.colors.textMuted */
     suffixColor?: TokenReference<'color'>;
 }
+/**
+ * Composer overflow `+` menu panel (`composer.actionOverflow`).
+ *
+ * Every key is optional and unset ones emit nothing: the stylesheet's `var()`
+ * fallbacks own the default look. The panel is portaled outside the themed
+ * mount, so the menu forwards the configured values onto it when it opens.
+ */
+interface ComposerOverflowMenuTokens {
+    /** Panel fill behind the rows. @default semantic.colors.surface */
+    background?: TokenReference<'color'>;
+    /** Panel border color. @default semantic.colors.border */
+    borderColor?: TokenReference<'color'>;
+    /** Panel corner radius. @default palette.radius.lg */
+    borderRadius?: TokenReference<'radius'>;
+    /** Row text and glyph color. @default semantic.colors.text */
+    foreground?: TokenReference<'color'>;
+    /** Panel elevation (raw CSS box-shadow, `none` allowed). @default palette.shadows.md */
+    shadow?: string;
+}
 /** Composer (message input) chrome. */
 interface ComposerChromeTokens {
     /** Box-shadow on the composer form (raw CSS, e.g. `none`). */
@@ -1279,8 +1318,10 @@ interface ComposerChromeTokens {
     overlayBand?: string;
     /** Segmented mode-group track. */
     segmented?: ComposerSegmentedTokens;
-    /** Model picker popover chrome. */
+    /** Model picker chrome (closed control plus popover panel). */
     modelPicker?: ComposerModelPickerTokens;
+    /** Overflow `+` menu panel chrome. */
+    overflowMenu?: ComposerOverflowMenuTokens;
 }
 /**
  * Motion timing shared by every composer animation.
@@ -5717,6 +5758,15 @@ type ComposerActionPlacement = "start" | "end";
  * it, `"overflow"` and `"auto"` both render in the bar.
  */
 type ComposerActionPresentation = "bar" | "overflow" | "auto";
+/**
+ * When a composer action is mounted, as a function of the draft.
+ *
+ * - `"always"` (default): the control is always mounted.
+ * - `"when-empty"`: hidden as soon as the draft holds text or an attachment,
+ *   and while a response streams.
+ * - `"when-text"`: the inverse, on the same draft state the send control reads.
+ */
+type ComposerActionVisibility = "always" | "when-empty" | "when-text";
 /**
  * Fields shared by every composer action.
  *
@@ -5732,6 +5782,13 @@ type ComposerActionBase = {
     presentation?: ComposerActionPresentation;
     order?: number;
     visible?: boolean | ((state: Readonly<ComposerState>) => boolean);
+    /**
+     * Draft-driven visibility, on the same state `sendButton.visibility` reads.
+     * Hidden removes the control from layout and tab order. Combined with
+     * `visible`: both must pass.
+     * @default "always"
+     */
+    visibility?: ComposerActionVisibility;
     disabled?: boolean | ((state: Readonly<ComposerState>) => boolean);
     /** Disable while a response streams, through the composer's own mechanism. */
     disableWhenStreaming?: boolean;
@@ -5878,6 +5935,15 @@ type ComposerMode = {
  *   row, never in the overflow menu.
  */
 type ComposerModeGroupPresentation = "buttons" | "segmented";
+/**
+ * Whether a group's active modes also render as removable chips.
+ *
+ * - `"auto"` (default): one chip per active mode, except under `"segmented"`
+ *   presentation, where the track already shows the state.
+ * - `"hidden"`: no chips for this group under any presentation. The pressed bar
+ *   button carries the state, and deselection stays on the button.
+ */
+type ComposerModeChipVisibility = "auto" | "hidden";
 /**
  * Selection policy for a set of modes. `"single"` deselects siblings when one
  * is chosen; `"multiple"` toggles independently.
@@ -5887,6 +5953,12 @@ type ComposerModeGroup = {
     selection: "single" | "multiple";
     /** @default "buttons" */
     presentation?: ComposerModeGroupPresentation;
+    /**
+     * Chip row policy for this group's active modes. The chip row itself is
+     * derived from its children, so a group with no other chips leaves no gap.
+     * @default "auto"
+     */
+    chipVisibility?: ComposerModeChipVisibility;
     /**
      * Accessible name for a segmented track. With it the track is a labelled
      * `role="group"`; without it the segments stand on their own names.

package/dist/artifacts-ui.d.cts

@@ -1226,27 +1226,66 @@ interface ComposerSegmentedTokens {
     itemPadding?: string;
 }
 /**
- * Model picker popover (`composer.modelPicker.presentation: "popover"`).
+ * Model picker chrome (`composer.models`).
+ *
+ * The surface keys (`background`, `hoverBackground`, `borderColor`,
+ * `borderRadius`, `labelColor`) style the CLOSED control, so the native
+ * `<select>` and the `presentation: "popover"` trigger share one vocabulary.
+ * The `menu*`, `rowHoverBackground`, and `descriptionColor` keys style the
+ * popover panel and are inert under the native select, as is `suffixColor`,
+ * which a `<select>` cannot carry either.
  *
  * Every key is optional and unset ones emit nothing: the stylesheet's `var()`
  * fallbacks own the default look, which derives from the surface and ghost
- * button tokens. Inert under the native `<select>` presentation, except
- * `suffixColor`, which the native control cannot carry either.
+ * button tokens.
  */
 interface ComposerModelPickerTokens {
+    /** Closed control fill. @default the ghost button fill (transparent) */
+    background?: TokenReference<'color'>;
+    /** Closed control fill under hover. @default the ghost hover wash */
+    hoverBackground?: TokenReference<'color'>;
+    /**
+     * Closed control outline, drawn as a 1px inset ring so setting it never
+     * resizes the control. @default none
+     */
+    borderColor?: TokenReference<'color'>;
+    /** Closed control corner radius. @default the ghost button radius */
+    borderRadius?: TokenReference<'radius'>;
     /** Panel fill behind the rows. @default semantic.colors.surface */
     menuBackground?: TokenReference<'color'>;
     /** Panel corner radius. @default palette.radius.lg */
     menuBorderRadius?: TokenReference<'radius'>;
     /** Row fill under hover and the focused option. @default the ghost hover wash */
     rowHoverBackground?: TokenReference<'color'>;
-    /** Row label and closed-control label color. @default inherited text */
+    /**
+     * Row label color, plus the closed control's text and chevron in both
+     * presentations. @default the ghost button foreground
+     */
     labelColor?: TokenReference<'color'>;
     /** Second line under a row label. @default semantic.colors.textMuted */
     descriptionColor?: TokenReference<'color'>;
     /** `composer.modelPicker.suffix` on the closed control. @default semantic.colors.textMuted */
     suffixColor?: TokenReference<'color'>;
 }
+/**
+ * Composer overflow `+` menu panel (`composer.actionOverflow`).
+ *
+ * Every key is optional and unset ones emit nothing: the stylesheet's `var()`
+ * fallbacks own the default look. The panel is portaled outside the themed
+ * mount, so the menu forwards the configured values onto it when it opens.
+ */
+interface ComposerOverflowMenuTokens {
+    /** Panel fill behind the rows. @default semantic.colors.surface */
+    background?: TokenReference<'color'>;
+    /** Panel border color. @default semantic.colors.border */
+    borderColor?: TokenReference<'color'>;
+    /** Panel corner radius. @default palette.radius.lg */
+    borderRadius?: TokenReference<'radius'>;
+    /** Row text and glyph color. @default semantic.colors.text */
+    foreground?: TokenReference<'color'>;
+    /** Panel elevation (raw CSS box-shadow, `none` allowed). @default palette.shadows.md */
+    shadow?: string;
+}
 /** Composer (message input) chrome. */
 interface ComposerChromeTokens {
     /** Box-shadow on the composer form (raw CSS, e.g. `none`). */
@@ -1281,8 +1320,10 @@ interface ComposerChromeTokens {
     overlayBand?: string;
     /** Segmented mode-group track. */
     segmented?: ComposerSegmentedTokens;
-    /** Model picker popover chrome. */
+    /** Model picker chrome (closed control plus popover panel). */
     modelPicker?: ComposerModelPickerTokens;
+    /** Overflow `+` menu panel chrome. */
+    overflowMenu?: ComposerOverflowMenuTokens;
 }
 /**
  * Motion timing shared by every composer animation.
@@ -5719,6 +5760,15 @@ type ComposerActionPlacement = "start" | "end";
  * it, `"overflow"` and `"auto"` both render in the bar.
  */
 type ComposerActionPresentation = "bar" | "overflow" | "auto";
+/**
+ * When a composer action is mounted, as a function of the draft.
+ *
+ * - `"always"` (default): the control is always mounted.
+ * - `"when-empty"`: hidden as soon as the draft holds text or an attachment,
+ *   and while a response streams.
+ * - `"when-text"`: the inverse, on the same draft state the send control reads.
+ */
+type ComposerActionVisibility = "always" | "when-empty" | "when-text";
 /**
  * Fields shared by every composer action.
  *
@@ -5734,6 +5784,13 @@ type ComposerActionBase = {
     presentation?: ComposerActionPresentation;
     order?: number;
     visible?: boolean | ((state: Readonly<ComposerState>) => boolean);
+    /**
+     * Draft-driven visibility, on the same state `sendButton.visibility` reads.
+     * Hidden removes the control from layout and tab order. Combined with
+     * `visible`: both must pass.
+     * @default "always"
+     */
+    visibility?: ComposerActionVisibility;
     disabled?: boolean | ((state: Readonly<ComposerState>) => boolean);
     /** Disable while a response streams, through the composer's own mechanism. */
     disableWhenStreaming?: boolean;
@@ -5880,6 +5937,15 @@ type ComposerMode = {
  *   row, never in the overflow menu.
  */
 type ComposerModeGroupPresentation = "buttons" | "segmented";
+/**
+ * Whether a group's active modes also render as removable chips.
+ *
+ * - `"auto"` (default): one chip per active mode, except under `"segmented"`
+ *   presentation, where the track already shows the state.
+ * - `"hidden"`: no chips for this group under any presentation. The pressed bar
+ *   button carries the state, and deselection stays on the button.
+ */
+type ComposerModeChipVisibility = "auto" | "hidden";
 /**
  * Selection policy for a set of modes. `"single"` deselects siblings when one
  * is chosen; `"multiple"` toggles independently.
@@ -5889,6 +5955,12 @@ type ComposerModeGroup = {
     selection: "single" | "multiple";
     /** @default "buttons" */
     presentation?: ComposerModeGroupPresentation;
+    /**
+     * Chip row policy for this group's active modes. The chip row itself is
+     * derived from its children, so a group with no other chips leaves no gap.
+     * @default "auto"
+     */
+    chipVisibility?: ComposerModeChipVisibility;
     /**
      * Accessible name for a segmented track. With it the track is a labelled
      * `role="group"`; without it the segments stand on their own names.

package/dist/artifacts-ui.d.ts

@@ -1226,27 +1226,66 @@ interface ComposerSegmentedTokens {
     itemPadding?: string;
 }
 /**
- * Model picker popover (`composer.modelPicker.presentation: "popover"`).
+ * Model picker chrome (`composer.models`).
+ *
+ * The surface keys (`background`, `hoverBackground`, `borderColor`,
+ * `borderRadius`, `labelColor`) style the CLOSED control, so the native
+ * `<select>` and the `presentation: "popover"` trigger share one vocabulary.
+ * The `menu*`, `rowHoverBackground`, and `descriptionColor` keys style the
+ * popover panel and are inert under the native select, as is `suffixColor`,
+ * which a `<select>` cannot carry either.
  *
  * Every key is optional and unset ones emit nothing: the stylesheet's `var()`
  * fallbacks own the default look, which derives from the surface and ghost
- * button tokens. Inert under the native `<select>` presentation, except
- * `suffixColor`, which the native control cannot carry either.
+ * button tokens.
  */
 interface ComposerModelPickerTokens {
+    /** Closed control fill. @default the ghost button fill (transparent) */
+    background?: TokenReference<'color'>;
+    /** Closed control fill under hover. @default the ghost hover wash */
+    hoverBackground?: TokenReference<'color'>;
+    /**
+     * Closed control outline, drawn as a 1px inset ring so setting it never
+     * resizes the control. @default none
+     */
+    borderColor?: TokenReference<'color'>;
+    /** Closed control corner radius. @default the ghost button radius */
+    borderRadius?: TokenReference<'radius'>;
     /** Panel fill behind the rows. @default semantic.colors.surface */
     menuBackground?: TokenReference<'color'>;
     /** Panel corner radius. @default palette.radius.lg */
     menuBorderRadius?: TokenReference<'radius'>;
     /** Row fill under hover and the focused option. @default the ghost hover wash */
     rowHoverBackground?: TokenReference<'color'>;
-    /** Row label and closed-control label color. @default inherited text */
+    /**
+     * Row label color, plus the closed control's text and chevron in both
+     * presentations. @default the ghost button foreground
+     */
     labelColor?: TokenReference<'color'>;
     /** Second line under a row label. @default semantic.colors.textMuted */
     descriptionColor?: TokenReference<'color'>;
     /** `composer.modelPicker.suffix` on the closed control. @default semantic.colors.textMuted */
     suffixColor?: TokenReference<'color'>;
 }
+/**
+ * Composer overflow `+` menu panel (`composer.actionOverflow`).
+ *
+ * Every key is optional and unset ones emit nothing: the stylesheet's `var()`
+ * fallbacks own the default look. The panel is portaled outside the themed
+ * mount, so the menu forwards the configured values onto it when it opens.
+ */
+interface ComposerOverflowMenuTokens {
+    /** Panel fill behind the rows. @default semantic.colors.surface */
+    background?: TokenReference<'color'>;
+    /** Panel border color. @default semantic.colors.border */
+    borderColor?: TokenReference<'color'>;
+    /** Panel corner radius. @default palette.radius.lg */
+    borderRadius?: TokenReference<'radius'>;
+    /** Row text and glyph color. @default semantic.colors.text */
+    foreground?: TokenReference<'color'>;
+    /** Panel elevation (raw CSS box-shadow, `none` allowed). @default palette.shadows.md */
+    shadow?: string;
+}
 /** Composer (message input) chrome. */
 interface ComposerChromeTokens {
     /** Box-shadow on the composer form (raw CSS, e.g. `none`). */
@@ -1281,8 +1320,10 @@ interface ComposerChromeTokens {
     overlayBand?: string;
     /** Segmented mode-group track. */
     segmented?: ComposerSegmentedTokens;
-    /** Model picker popover chrome. */
+    /** Model picker chrome (closed control plus popover panel). */
     modelPicker?: ComposerModelPickerTokens;
+    /** Overflow `+` menu panel chrome. */
+    overflowMenu?: ComposerOverflowMenuTokens;
 }
 /**
  * Motion timing shared by every composer animation.
@@ -5719,6 +5760,15 @@ type ComposerActionPlacement = "start" | "end";
  * it, `"overflow"` and `"auto"` both render in the bar.
  */
 type ComposerActionPresentation = "bar" | "overflow" | "auto";
+/**
+ * When a composer action is mounted, as a function of the draft.
+ *
+ * - `"always"` (default): the control is always mounted.
+ * - `"when-empty"`: hidden as soon as the draft holds text or an attachment,
+ *   and while a response streams.
+ * - `"when-text"`: the inverse, on the same draft state the send control reads.
+ */
+type ComposerActionVisibility = "always" | "when-empty" | "when-text";
 /**
  * Fields shared by every composer action.
  *
@@ -5734,6 +5784,13 @@ type ComposerActionBase = {
     presentation?: ComposerActionPresentation;
     order?: number;
     visible?: boolean | ((state: Readonly<ComposerState>) => boolean);
+    /**
+     * Draft-driven visibility, on the same state `sendButton.visibility` reads.
+     * Hidden removes the control from layout and tab order. Combined with
+     * `visible`: both must pass.
+     * @default "always"
+     */
+    visibility?: ComposerActionVisibility;
     disabled?: boolean | ((state: Readonly<ComposerState>) => boolean);
     /** Disable while a response streams, through the composer's own mechanism. */
     disableWhenStreaming?: boolean;
@@ -5880,6 +5937,15 @@ type ComposerMode = {
  *   row, never in the overflow menu.
  */
 type ComposerModeGroupPresentation = "buttons" | "segmented";
+/**
+ * Whether a group's active modes also render as removable chips.
+ *
+ * - `"auto"` (default): one chip per active mode, except under `"segmented"`
+ *   presentation, where the track already shows the state.
+ * - `"hidden"`: no chips for this group under any presentation. The pressed bar
+ *   button carries the state, and deselection stays on the button.
+ */
+type ComposerModeChipVisibility = "auto" | "hidden";
 /**
  * Selection policy for a set of modes. `"single"` deselects siblings when one
  * is chosen; `"multiple"` toggles independently.
@@ -5889,6 +5955,12 @@ type ComposerModeGroup = {
     selection: "single" | "multiple";
     /** @default "buttons" */
     presentation?: ComposerModeGroupPresentation;
+    /**
+     * Chip row policy for this group's active modes. The chip row itself is
+     * derived from its children, so a group with no other chips leaves no gap.
+     * @default "auto"
+     */
+    chipVisibility?: ComposerModeChipVisibility;
     /**
      * Accessible name for a segmented track. With it the track is a labelled
      * `role="group"`; without it the segments stand on their own names.

package/dist/codegen.cjs

@@ -1,4 +1,4 @@
-"use strict";var w=Object.defineProperty;var _=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var R=(e,i)=>{for(var r in i)w(e,r,{get:i[r],enumerable:!0})},W=(e,i,r,s)=>{if(i&&typeof i=="object"||typeof i=="function")for(let a of T(i))!M.call(e,a)&&a!==r&&w(e,a,{get:()=>i[a],enumerable:!(s=_(i,a))||s.enumerable});return e};var H=e=>W(w({},"__esModule",{value:!0}),e);var z={};R(z,{generateCodeSnippet:()=>P});module.exports=H(z);var S="4.19.0";var j=S;function $(e){return e?.cdnBase?.trim().replace(/\/+$/,"").replace(/[\\'"<>`]/g,r=>`%${r.charCodeAt(0).toString(16).toUpperCase().padStart(2,"0")}`)||`https://cdn.jsdelivr.net/npm/@runtypelabs/persona@${j}/dist`}function u(e){if(e!==void 0)return typeof e=="string"?e:Array.isArray(e)?`[${e.map(i=>i.toString()).join(", ")}]`:e.toString()}function q(e){if(e)return{getHeaders:u(e.getHeaders),onFeedback:u(e.onFeedback),onCopy:u(e.onCopy),requestMiddleware:u(e.requestMiddleware),actionHandlers:u(e.actionHandlers),actionParsers:u(e.actionParsers),postprocessMessage:u(e.postprocessMessage),contextProviders:u(e.contextProviders),streamParser:u(e.streamParser)}}var A=`({ text, message }: any) => {
+"use strict";var w=Object.defineProperty;var _=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var R=(e,i)=>{for(var r in i)w(e,r,{get:i[r],enumerable:!0})},W=(e,i,r,s)=>{if(i&&typeof i=="object"||typeof i=="function")for(let a of T(i))!M.call(e,a)&&a!==r&&w(e,a,{get:()=>i[a],enumerable:!(s=_(i,a))||s.enumerable});return e};var H=e=>W(w({},"__esModule",{value:!0}),e);var z={};R(z,{generateCodeSnippet:()=>P});module.exports=H(z);var S="4.20.0";var j=S;function $(e){return e?.cdnBase?.trim().replace(/\/+$/,"").replace(/[\\'"<>`]/g,r=>`%${r.charCodeAt(0).toString(16).toUpperCase().padStart(2,"0")}`)||`https://cdn.jsdelivr.net/npm/@runtypelabs/persona@${j}/dist`}function u(e){if(e!==void 0)return typeof e=="string"?e:Array.isArray(e)?`[${e.map(i=>i.toString()).join(", ")}]`:e.toString()}function q(e){if(e)return{getHeaders:u(e.getHeaders),onFeedback:u(e.onFeedback),onCopy:u(e.onCopy),requestMiddleware:u(e.requestMiddleware),actionHandlers:u(e.actionHandlers),actionParsers:u(e.actionParsers),postprocessMessage:u(e.postprocessMessage),contextProviders:u(e.contextProviders),streamParser:u(e.streamParser)}}var A=`({ text, message }: any) => {
   const jsonSource = (message as any).rawContent || text || message.content;
   if (!jsonSource || typeof jsonSource !== 'string') return null;
   let cleanJson = jsonSource

package/dist/codegen.js

@@ -1,4 +1,4 @@
-var x="4.19.0";var S=x;function w(e){return e?.cdnBase?.trim().replace(/\/+$/,"").replace(/[\\'"<>`]/g,r=>`%${r.charCodeAt(0).toString(16).toUpperCase().padStart(2,"0")}`)||`https://cdn.jsdelivr.net/npm/@runtypelabs/persona@${S}/dist`}function u(e){if(e!==void 0)return typeof e=="string"?e:Array.isArray(e)?`[${e.map(i=>i.toString()).join(", ")}]`:e.toString()}function I(e){if(e)return{getHeaders:u(e.getHeaders),onFeedback:u(e.onFeedback),onCopy:u(e.onCopy),requestMiddleware:u(e.requestMiddleware),actionHandlers:u(e.actionHandlers),actionParsers:u(e.actionParsers),postprocessMessage:u(e.postprocessMessage),contextProviders:u(e.contextProviders),streamParser:u(e.streamParser)}}var j=`({ text, message }: any) => {
+var x="4.20.0";var S=x;function w(e){return e?.cdnBase?.trim().replace(/\/+$/,"").replace(/[\\'"<>`]/g,r=>`%${r.charCodeAt(0).toString(16).toUpperCase().padStart(2,"0")}`)||`https://cdn.jsdelivr.net/npm/@runtypelabs/persona@${S}/dist`}function u(e){if(e!==void 0)return typeof e=="string"?e:Array.isArray(e)?`[${e.map(i=>i.toString()).join(", ")}]`:e.toString()}function I(e){if(e)return{getHeaders:u(e.getHeaders),onFeedback:u(e.onFeedback),onCopy:u(e.onCopy),requestMiddleware:u(e.requestMiddleware),actionHandlers:u(e.actionHandlers),actionParsers:u(e.actionParsers),postprocessMessage:u(e.postprocessMessage),contextProviders:u(e.contextProviders),streamParser:u(e.streamParser)}}var j=`({ text, message }: any) => {
   const jsonSource = (message as any).rawContent || text || message.content;
   if (!jsonSource || typeof jsonSource !== 'string') return null;
   let cleanJson = jsonSource