@runtypelabs/persona 4.19.0 → 4.20.0

package/dist/forms-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.
@@ -5829,6 +5870,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.
  *
@@ -5844,6 +5894,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;
@@ -5990,6 +6047,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.
@@ -5999,6 +6065,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/forms-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.
@@ -5829,6 +5870,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.
  *
@@ -5844,6 +5894,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;
@@ -5990,6 +6047,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.
@@ -5999,6 +6065,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.