@shopify/ui-extensions 2025.10.0-rc.1 → 2025.10.0-rc.3

package/build/ts/surfaces/admin/targets/admin.product-details.block.render.d.ts

@@ -1387,11 +1387,25 @@ export interface LinkJSXProps extends Partial<LinkProps>, Pick<LinkProps$1, 'id'
     onClick?: ((event: CallbackEvent<typeof LinktagName>) => void) | null;
 }
 
-export interface LinkPreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface LinkPreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface LinkClickOptions {
@@ -2330,11 +2344,25 @@ export interface ClickableJSXProps extends Partial<ClickableProps>, Pick<Clickab
     onBlur?: ((event: CallbackEvent<typeof tagName>) => void) | null;
 }
 
-export interface ClickablePreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface ClickablePreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface ClickableClickOptions {
@@ -2692,11 +2720,25 @@ export interface ButtonJSXProps extends Partial<ButtonProps>, Pick<ButtonProps$1
     onBlur?: ((event: CallbackEvent<typeof tagName>) => void) | null;
 }
 
-export interface PreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface PreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface ButtonClickOptions {
@@ -2935,7 +2977,9 @@ declare global {
 
 export interface BannerJSXProps extends Partial<BannerProps>, Pick<BannerProps$1, 'id'> {
     /**
-     * The secondary actions to display at the bottom of the banner. Only a maximum of two `s-button` components are allowed.
+     * The secondary actions to display at the bottom of the banner.
+     *
+     * A maximum of two `s-button` components are allowed, and only buttons with the `variant` of "secondary" are permitted.
      */
     secondaryActions?: ComponentChild;
     onDismiss?: ((event: CallbackEvent<typeof BannertagName>) => void) | null;

package/build/ts/surfaces/admin/targets/admin.product-details.configuration.render.d.ts

@@ -1387,11 +1387,25 @@ export interface LinkJSXProps extends Partial<LinkProps>, Pick<LinkProps$1, 'id'
     onClick?: ((event: CallbackEvent<typeof LinktagName>) => void) | null;
 }
 
-export interface LinkPreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface LinkPreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface LinkClickOptions {
@@ -2330,11 +2344,25 @@ export interface ClickableJSXProps extends Partial<ClickableProps>, Pick<Clickab
     onBlur?: ((event: CallbackEvent<typeof tagName>) => void) | null;
 }
 
-export interface ClickablePreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface ClickablePreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface ClickableClickOptions {
@@ -2692,11 +2720,25 @@ export interface ButtonJSXProps extends Partial<ButtonProps>, Pick<ButtonProps$1
     onBlur?: ((event: CallbackEvent<typeof tagName>) => void) | null;
 }
 
-export interface PreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface PreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface ButtonClickOptions {
@@ -2935,7 +2977,9 @@ declare global {
 
 export interface BannerJSXProps extends Partial<BannerProps>, Pick<BannerProps$1, 'id'> {
     /**
-     * The secondary actions to display at the bottom of the banner. Only a maximum of two `s-button` components are allowed.
+     * The secondary actions to display at the bottom of the banner.
+     *
+     * A maximum of two `s-button` components are allowed, and only buttons with the `variant` of "secondary" are permitted.
      */
     secondaryActions?: ComponentChild;
     onDismiss?: ((event: CallbackEvent<typeof BannertagName>) => void) | null;

package/build/ts/surfaces/admin/targets/admin.product-details.print-action.render.d.ts

@@ -1335,11 +1335,25 @@ export interface LinkJSXProps extends Partial<LinkProps>, Pick<LinkProps$1, 'id'
     onClick?: ((event: CallbackEvent<typeof LinktagName>) => void) | null;
 }
 
-export interface LinkPreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface LinkPreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface LinkClickOptions {
@@ -2278,11 +2292,25 @@ export interface ClickableJSXProps extends Partial<ClickableProps>, Pick<Clickab
     onBlur?: ((event: CallbackEvent<typeof tagName>) => void) | null;
 }
 
-export interface ClickablePreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface ClickablePreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface ClickableClickOptions {
@@ -2640,11 +2668,25 @@ export interface ButtonJSXProps extends Partial<ButtonProps>, Pick<ButtonProps$1
     onBlur?: ((event: CallbackEvent<typeof tagName>) => void) | null;
 }
 
-export interface PreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface PreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface ButtonClickOptions {
@@ -2883,7 +2925,9 @@ declare global {
 
 export interface BannerJSXProps extends Partial<BannerProps>, Pick<BannerProps$1, 'id'> {
     /**
-     * The secondary actions to display at the bottom of the banner. Only a maximum of two `s-button` components are allowed.
+     * The secondary actions to display at the bottom of the banner.
+     *
+     * A maximum of two `s-button` components are allowed, and only buttons with the `variant` of "secondary" are permitted.
      */
     secondaryActions?: ComponentChild;
     onDismiss?: ((event: CallbackEvent<typeof BannertagName>) => void) | null;

package/build/ts/surfaces/admin/targets/admin.product-details.reorder.render.d.ts

@@ -1387,11 +1387,25 @@ export interface LinkJSXProps extends Partial<LinkProps>, Pick<LinkProps$1, 'id'
     onClick?: ((event: CallbackEvent<typeof LinktagName>) => void) | null;
 }
 
-export interface LinkPreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface LinkPreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface LinkClickOptions {
@@ -2330,11 +2344,25 @@ export interface ClickableJSXProps extends Partial<ClickableProps>, Pick<Clickab
     onBlur?: ((event: CallbackEvent<typeof tagName>) => void) | null;
 }
 
-export interface ClickablePreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface ClickablePreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface ClickableClickOptions {
@@ -2692,11 +2720,25 @@ export interface ButtonJSXProps extends Partial<ButtonProps>, Pick<ButtonProps$1
     onBlur?: ((event: CallbackEvent<typeof tagName>) => void) | null;
 }
 
-export interface PreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface PreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface ButtonClickOptions {
@@ -2935,7 +2977,9 @@ declare global {
 
 export interface BannerJSXProps extends Partial<BannerProps>, Pick<BannerProps$1, 'id'> {
     /**
-     * The secondary actions to display at the bottom of the banner. Only a maximum of two `s-button` components are allowed.
+     * The secondary actions to display at the bottom of the banner.
+     *
+     * A maximum of two `s-button` components are allowed, and only buttons with the `variant` of "secondary" are permitted.
      */
     secondaryActions?: ComponentChild;
     onDismiss?: ((event: CallbackEvent<typeof BannertagName>) => void) | null;

package/build/ts/surfaces/admin/targets/admin.product-index.action.render.d.ts

@@ -1346,11 +1346,25 @@ export interface LinkJSXProps extends Partial<LinkProps>, Pick<LinkProps$1, 'id'
     onClick?: ((event: CallbackEvent<typeof LinktagName>) => void) | null;
 }
 
-export interface LinkPreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface LinkPreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface LinkClickOptions {
@@ -2289,11 +2303,25 @@ export interface ClickableJSXProps extends Partial<ClickableProps>, Pick<Clickab
     onBlur?: ((event: CallbackEvent<typeof tagName>) => void) | null;
 }
 
-export interface ClickablePreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface ClickablePreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface ClickableClickOptions {
@@ -2651,11 +2679,25 @@ export interface ButtonJSXProps extends Partial<ButtonProps>, Pick<ButtonProps$1
     onBlur?: ((event: CallbackEvent<typeof tagName>) => void) | null;
 }
 
-export interface PreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface PreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface ButtonClickOptions {
@@ -2894,7 +2936,9 @@ declare global {
 
 export interface BannerJSXProps extends Partial<BannerProps>, Pick<BannerProps$1, 'id'> {
     /**
-     * The secondary actions to display at the bottom of the banner. Only a maximum of two `s-button` components are allowed.
+     * The secondary actions to display at the bottom of the banner.
+     *
+     * A maximum of two `s-button` components are allowed, and only buttons with the `variant` of "secondary" are permitted.
      */
     secondaryActions?: ComponentChild;
     onDismiss?: ((event: CallbackEvent<typeof BannertagName>) => void) | null;

package/build/ts/surfaces/admin/targets/admin.product-index.selection-action.render.d.ts

@@ -1346,11 +1346,25 @@ export interface LinkJSXProps extends Partial<LinkProps>, Pick<LinkProps$1, 'id'
     onClick?: ((event: CallbackEvent<typeof LinktagName>) => void) | null;
 }
 
-export interface LinkPreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface LinkPreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface LinkClickOptions {
@@ -2289,11 +2303,25 @@ export interface ClickableJSXProps extends Partial<ClickableProps>, Pick<Clickab
     onBlur?: ((event: CallbackEvent<typeof tagName>) => void) | null;
 }
 
-export interface ClickablePreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface ClickablePreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface ClickableClickOptions {
@@ -2651,11 +2679,25 @@ export interface ButtonJSXProps extends Partial<ButtonProps>, Pick<ButtonProps$1
     onBlur?: ((event: CallbackEvent<typeof tagName>) => void) | null;
 }
 
-export interface PreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface PreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface ButtonClickOptions {
@@ -2894,7 +2936,9 @@ declare global {
 
 export interface BannerJSXProps extends Partial<BannerProps>, Pick<BannerProps$1, 'id'> {
     /**
-     * The secondary actions to display at the bottom of the banner. Only a maximum of two `s-button` components are allowed.
+     * The secondary actions to display at the bottom of the banner.
+     *
+     * A maximum of two `s-button` components are allowed, and only buttons with the `variant` of "secondary" are permitted.
      */
     secondaryActions?: ComponentChild;
     onDismiss?: ((event: CallbackEvent<typeof BannertagName>) => void) | null;

package/build/ts/surfaces/admin/targets/admin.product-index.selection-print-action.render.d.ts

@@ -1335,11 +1335,25 @@ export interface LinkJSXProps extends Partial<LinkProps>, Pick<LinkProps$1, 'id'
     onClick?: ((event: CallbackEvent<typeof LinktagName>) => void) | null;
 }
 
-export interface LinkPreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface LinkPreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface LinkClickOptions {
@@ -2278,11 +2292,25 @@ export interface ClickableJSXProps extends Partial<ClickableProps>, Pick<Clickab
     onBlur?: ((event: CallbackEvent<typeof tagName>) => void) | null;
 }
 
-export interface ClickablePreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface ClickablePreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface ClickableClickOptions {
@@ -2640,11 +2668,25 @@ export interface ButtonJSXProps extends Partial<ButtonProps>, Pick<ButtonProps$1
     onBlur?: ((event: CallbackEvent<typeof tagName>) => void) | null;
 }
 
-export interface PreactOverlayControlProps extends Required<Pick<InteractionProps, 'commandFor'>> {
+export interface PreactOverlayControlProps extends Pick<InteractionProps, 'commandFor'> {
+    /**
+     * Sets the action the `commandFor` should take when this clickable is activated.
+     *
+     * See the documentation of particular components for the actions they support.
+     *
+     * - `--auto`: a default action for the target component.
+     * - `--show`: shows the target component.
+     * - `--hide`: hides the target component.
+     * - `--toggle`: toggles the target component.
+     *
+     * @default '--auto'
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#command
+     */
     command: Extract<
         InteractionProps['command'],
         '--show' | '--hide' | '--toggle' | '--auto'
         >;
+    commandFor: Extract<InteractionProps['commandFor'], string>;
 }
 
 export interface ButtonClickOptions {
@@ -2883,7 +2925,9 @@ declare global {
 
 export interface BannerJSXProps extends Partial<BannerProps>, Pick<BannerProps$1, 'id'> {
     /**
-     * The secondary actions to display at the bottom of the banner. Only a maximum of two `s-button` components are allowed.
+     * The secondary actions to display at the bottom of the banner.
+     *
+     * A maximum of two `s-button` components are allowed, and only buttons with the `variant` of "secondary" are permitted.
      */
     secondaryActions?: ComponentChild;
     onDismiss?: ((event: CallbackEvent<typeof BannertagName>) => void) | null;