@shopify/ui-extensions 2026.4.0-rc.3 → 2026.4.1

package/src/surfaces/admin/components/Avatar.d.ts

@@ -10,6 +10,7 @@ import type {AvatarProps$1, ComponentChildren} from './shared.d.ts';
 
 /**
  * The properties for the avatar component. An avatar displays a user or entity image with fallback initials when the image isn't available. Properties include `src` for the image URL, `initials` for the fallback text, `alt` for accessibility text, and `size` for controlling the avatar dimensions.
+ * @publicDocs
  */
 export interface AvatarProps
   extends Required<Pick<AvatarProps$1, 'initials' | 'src' | 'alt' | 'size'>> {
@@ -38,10 +39,12 @@ export interface AvatarProps
 
 /**
  * A string containing CSS styles for a custom element.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * The configuration for rendering a custom element with Preact.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -55,6 +58,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * The properties of an activation event, such as a click or keypress. These properties capture which modifier keys were pressed and which mouse button was used during the event.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -76,6 +80,7 @@ export interface ActivationEventEsque {
 }
 /**
  * The options for triggering a synthetic click event.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -131,6 +136,7 @@ declare abstract class PreactCustomElement extends BaseClass {
 
 /**
  * A callback event that's typed to a specific HTML element.
+ * @publicDocs
  */
 export type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
   /**
@@ -140,6 +146,7 @@ export type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
 };
 /**
  * An event listener for callback events, typed to a specific HTML element.
+ * @publicDocs
  */
 export type CallbackEventListener<T extends keyof HTMLElementTagNameMap> =
   | (EventListener & {
@@ -148,6 +155,7 @@ export type CallbackEventListener<T extends keyof HTMLElementTagNameMap> =
   | null;
 /**
  * The base properties for Preact elements that don't have children, providing essential attributes like keys and refs for component management.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -210,6 +218,7 @@ declare module 'preact' {
 declare const tagName = 's-avatar';
 /**
  * The properties for the avatar component when it's used in JSX.
+ * @publicDocs
  */
 export interface AvatarJSXProps
   extends Partial<AvatarProps>,

package/src/surfaces/admin/components/Badge.d.ts

@@ -15,6 +15,7 @@ import type {
 
 /**
  * The configuration for icons used within Badge components. Defines the visual appearance, size, and semantic meaning of icons displayed in badges.
+ * @publicDocs
  */
 export interface IconProps
   extends Pick<
@@ -61,6 +62,7 @@ export interface IconProps
 
 /**
  * The properties for the badge component. Badges display status information through compact visual indicators with customizable tones, sizes, and optional icons.
+ * @publicDocs
  */
 export interface BadgeProps
   extends Pick<BadgeProps$1, 'color' | 'icon' | 'size' | 'tone'> {
@@ -107,10 +109,12 @@ export interface BadgeProps
 
 /**
  * The CSS styles as a string, used for styling web components within their shadow DOM.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * The implementation configuration for rendering a Preact component into a shadow root. Defines the render function that returns JSX elements and optional CSS styles to apply to the component's shadow DOM.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -124,6 +128,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * The properties of an activation event (such as a click or keyboard press) that describe which modifier keys and mouse buttons were involved. This is used to determine intended behavior like opening links in new tabs when Command/Control is pressed.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -145,6 +150,7 @@ export interface ActivationEventEsque {
 }
 /**
  * The options for controlling how a synthetic click behaves. Allows passing modifier key states and button information from an original event to influence link behavior such as opening in new tabs or background tabs.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -197,6 +203,7 @@ declare abstract class PreactCustomElement extends BaseClass {
 
 /**
  * The base properties for Preact elements without children. Provides key, ref, and slot properties for element identification, DOM access, and slot-based positioning.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -214,6 +221,7 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 }
 /**
  * The base properties for Preact elements with children. Extends `PreactBaseElementProps` with the ability to render child elements.
+ * @publicDocs
  */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
@@ -261,6 +269,7 @@ declare module 'preact' {
 declare const tagName = 's-badge';
 /**
  * The JSX props for the badge component. These properties extend `BadgeProps` with an optional `id` and `children` for rendering badge content in JSX.
+ * @publicDocs
  */
 export interface BadgeJSXProps
   extends Partial<BadgeProps>,

package/src/surfaces/admin/components/Banner.d.ts

@@ -10,6 +10,7 @@ import type {ComponentChildren, BannerProps$1} from './shared.d.ts';
 
 /**
  * A callback event that's typed to a specific HTML element.
+ * @publicDocs
  */
 export type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
   /**
@@ -19,6 +20,7 @@ export type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
 };
 /**
  * An event listener for callback events, typed to a specific HTML element.
+ * @publicDocs
  */
 export type CallbackEventListener<T extends keyof HTMLElementTagNameMap> =
   | (EventListener & {
@@ -27,6 +29,7 @@ export type CallbackEventListener<T extends keyof HTMLElementTagNameMap> =
   | null;
 /**
  * The base properties for Preact elements that don't have children, providing essential attributes like keys and refs for component management.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -44,6 +47,7 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 }
 /**
  * The base properties for Preact elements that have children, extending the base element properties to include child content.
+ * @publicDocs
  */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
@@ -55,10 +59,12 @@ export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
 
 /**
  * All properties for the banner component marked as required.
+ * @publicDocs
  */
 export type RequiredBannerProps = Required<BannerProps$1>;
 /**
  * The properties for the banner component. These properties define an important message or notification with visual styling that conveys its semantic meaning.
+ * @publicDocs
  */
 export interface BannerProps
   extends Pick<
@@ -78,10 +84,12 @@ export interface BannerProps
 
 /**
  * A string containing CSS styles for the component.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * The implementation details for rendering a custom element with Preact.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -95,6 +103,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * An event-like object that contains activation information for synthetic clicks.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -116,6 +125,7 @@ export interface ActivationEventEsque {
 }
 /**
  * Options for customizing synthetic click behavior.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -213,6 +223,7 @@ declare module 'preact' {
 declare const tagName = 's-banner';
 /**
  * The JSX properties for the banner component. These properties define how a banner is rendered in Preact or JSX.
+ * @publicDocs
  */
 export interface BannerJSXProps
   extends Partial<BannerProps>,

package/src/surfaces/admin/components/Box.d.ts

@@ -16,6 +16,7 @@ import type {
 
 /**
  * A type that allows a value to be responsive using container query syntax.
+ * @publicDocs
  */
 export type MakeResponsive<T> = T | `@container${string}`;
 /**
@@ -33,6 +34,7 @@ export type MakeResponsive<T> = T | `@container${string}`;
  *   margin: string | `@container${string}`;
  *   padding: number | `@container${string}`;
  * }
+ * @publicDocs
  */
 export type MakeResponsivePick<TType, TProperty extends keyof TType> = {
   [P in TProperty]: MakeResponsive<TType[P]>;
@@ -40,10 +42,12 @@ export type MakeResponsivePick<TType, TProperty extends keyof TType> = {
 
 /**
  * A version of the box properties with all fields required.
+ * @publicDocs
  */
 export type RequiredBoxProps = Required<BoxProps$1>;
 /**
  * The allowed border radius values for a box component.
+ * @publicDocs
  */
 export type BoxBorderRadii = Extract<
   RequiredBoxProps['borderRadius'],
@@ -58,6 +62,7 @@ export type BoxBorderRadii = Extract<
 >;
 /**
  * The allowed border style values for a box component.
+ * @publicDocs
  */
 export type BoxBorderStyles = Extract<
   RequiredBoxProps['borderStyle'],
@@ -65,6 +70,7 @@ export type BoxBorderStyles = Extract<
 >;
 /**
  * The box properties that support responsive values through container queries.
+ * @publicDocs
  */
 export type ResponsiveBoxProps = MakeResponsivePick<
   RequiredBoxProps,
@@ -79,6 +85,7 @@ export type ResponsiveBoxProps = MakeResponsivePick<
 >;
 /**
  * The properties for the box component. A box provides control over layout, spacing, sizing, borders, and background styling for its content.
+ * @publicDocs
  */
 export interface BoxProps
   extends Pick<
@@ -257,10 +264,12 @@ export interface BoxProps
 
 /**
  * A string containing CSS styles for a custom element.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * The configuration for rendering a custom element with Preact.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -274,6 +283,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * The properties of an activation event, such as a click or keypress. These properties capture which modifier keys were pressed and which mouse button was used during the event.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -295,6 +305,7 @@ export interface ActivationEventEsque {
 }
 /**
  * The options for triggering a synthetic click event.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -461,6 +472,7 @@ declare class BoxElement extends PreactCustomElement implements BoxProps {
 
 /**
  * The base properties for Preact elements that don't have children, providing essential attributes like keys and refs for component management.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -478,6 +490,7 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 }
 /**
  * The base properties for Preact elements that have children, extending the base element properties to include child content.
+ * @publicDocs
  */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
@@ -507,6 +520,7 @@ declare module 'preact' {
 declare const tagName = 's-box';
 /**
  * The properties for the box component when it's used in JSX.
+ * @publicDocs
  */
 export interface BoxJSXProps
   extends Partial<BoxProps>,

package/src/surfaces/admin/components/Button.d.ts

@@ -16,6 +16,7 @@ import type {
 
 /**
  * A callback event with a strongly-typed `currentTarget` property that corresponds to a specific HTML element. This provides better type safety when handling events from custom elements.
+ * @publicDocs
  */
 export type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
   /**
@@ -25,6 +26,7 @@ export type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
 };
 /**
  * An event listener function type for callback events with a strongly-typed `currentTarget`. This ensures the event handler receives the correct element type.
+ * @publicDocs
  */
 export type CallbackEventListener<T extends keyof HTMLElementTagNameMap> =
   | (EventListener & {
@@ -33,6 +35,7 @@ export type CallbackEventListener<T extends keyof HTMLElementTagNameMap> =
   | null;
 /**
  * The base properties for Preact elements without children. Provides `key`, `ref`, and `slot` properties for element identification, DOM access, and slot-based positioning.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -50,6 +53,7 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 }
 /**
  * The base properties for Preact elements with children. Extends `PreactBaseElementProps` with the ability to render child elements.
+ * @publicDocs
  */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
@@ -61,6 +65,7 @@ export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
 
 /**
  * The configuration for icons used within Button components. Defines the visual appearance, size, and semantic meaning of icons displayed in buttons.
+ * @publicDocs
  */
 export interface IconProps
   extends Pick<
@@ -107,6 +112,7 @@ export interface IconProps
 
 /**
  * The button-specific properties extracted from the base button props type, used internally for type safety.
+ * @publicDocs
  */
 export type ButtonOnlyProps = Extract<
   ButtonProps$1,
@@ -116,6 +122,7 @@ export type ButtonOnlyProps = Extract<
 >;
 /**
  * The base required properties for the button component, including all essential button configuration options. This type ensures all button properties have default values.
+ * @publicDocs
  */
 export type ButtonBaseProps = Required<
   Pick<
@@ -138,6 +145,7 @@ export type ButtonBaseProps = Required<
 >;
 /**
  * The properties for the button component. Buttons trigger actions or navigation when clicked, with customizable visual styles, states, and optional icons.
+ * @publicDocs
  */
 export interface ButtonProps extends ButtonBaseProps {
   /**
@@ -159,10 +167,12 @@ export interface ButtonProps extends ButtonBaseProps {
 
 /**
  * The CSS styles as a string, used for styling web components within their shadow DOM.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * The implementation configuration for rendering a Preact component into a shadow root. Defines the render function that returns JSX elements and optional CSS styles to apply to the component's shadow DOM.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -176,6 +186,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * The properties of an activation event (such as a click or keyboard press) that describe which modifier keys and mouse buttons were involved. This is used to determine intended behavior like opening links in new tabs when Command/Control is pressed.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -197,6 +208,7 @@ export interface ActivationEventEsque {
 }
 /**
  * The options for controlling how a synthetic click behaves. Allows passing modifier key states and button information from an original event to influence link behavior such as opening in new tabs or background tabs.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -249,6 +261,7 @@ declare abstract class PreactCustomElement extends BaseClass {
 
 /**
  * The properties for controlling overlay interactions via commands. These properties enable buttons to control other components like modals, popovers, and dialogs using declarative commands.
+ * @publicDocs
  */
 export interface PreactOverlayControlProps
   extends Pick<InteractionProps, 'commandFor' | 'interestFor'> {
@@ -358,6 +371,7 @@ declare module 'preact' {
 declare const tagName = 's-button';
 /**
  * The JSX props for the button component. These properties extend `ButtonProps` with event callbacks and additional options for rendering buttons in JSX.
+ * @publicDocs
  */
 export interface ButtonJSXProps
   extends Partial<ButtonProps>,

package/src/surfaces/admin/components/ButtonGroup.d.ts

@@ -10,16 +10,19 @@ import type {ComponentChildren, ButtonGroupProps$1} from './shared.d.ts';
 
 /**
  * Properties for rendering a button group that arranges multiple buttons together with consistent spacing and semantic grouping.
+ * @publicDocs
  */
 export interface ButtonGroupProps
   extends Required<Pick<ButtonGroupProps$1, 'gap' | 'accessibilityLabel'>> {}
 
 /**
  * CSS styles that will be applied to the component's shadow DOM.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * Configuration for rendering a custom element with Preact and shadow DOM.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -33,6 +36,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * Information about modifier keys and mouse buttons that were active during an interaction.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -54,6 +58,7 @@ export interface ActivationEventEsque {
 }
 /**
  * Options for influencing how a programmatic click behaves.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -106,6 +111,7 @@ declare abstract class PreactCustomElement extends BaseClass {
 
 /**
  * The base properties for Preact elements that don't have children, providing essential attributes like keys and refs for component management.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -124,6 +130,7 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 
 /**
  * The base properties for Preact elements that have children, extending the base element properties to include child content.
+ * @publicDocs
  */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
@@ -173,6 +180,7 @@ declare const tagName = 's-button-group';
 
 /**
  * Properties for using the button group component in JSX with React-style props.
+ * @publicDocs
  */
 export interface ButtonGroupJSXProps
   extends Partial<ButtonGroupProps>,

package/src/surfaces/admin/components/Checkbox.d.ts

@@ -14,6 +14,7 @@ import type {
 
 /**
  * An event that includes a strongly-typed reference to the element that triggered it.
+ * @publicDocs
  */
 export type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
   /**
@@ -23,13 +24,15 @@ export type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
 };
 /**
  * A function that handles events for a specific element type, or null if no handler is set.
+ * @publicDocs
  */
 export type CallbackEventListener<T extends keyof HTMLElementTagNameMap> =
   | (EventListener & {
       (event: CallbackEvent<T>): void;
     })
   | null;
-/** Used when an element does not have children. */
+/** Used when an element does not have children. * @publicDocs
+ */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
    * A unique identifier for this element within its parent. Preact uses keys to optimize rendering performance when lists change by tracking which items have been added, removed, or reordered.
@@ -47,10 +50,12 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 
 /**
  * CSS styles that will be applied to the component's shadow DOM.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * Configuration for rendering a custom element with Preact and shadow DOM.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -64,6 +69,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * Information about modifier keys and mouse buttons that were active during an interaction.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -85,6 +91,7 @@ export interface ActivationEventEsque {
 }
 /**
  * Options for influencing how a programmatic click behaves.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -138,6 +145,7 @@ declare abstract class PreactCustomElement extends BaseClass {
 declare const internals: unique symbol;
 /**
  * The core properties that all input elements need to function within forms.
+ * @publicDocs
  */
 export type PreactInputProps = Required<
   Pick<TextFieldProps, 'disabled' | 'id' | 'name' | 'value'>
@@ -185,6 +193,7 @@ declare class PreactInputElement
 
 /**
  * Properties that are common to checkbox-style components.
+ * @publicDocs
  */
 export interface PreactCheckboxProps
   extends Required<
@@ -255,6 +264,7 @@ declare class PreactCheckboxElement
 
 /**
  * Properties for rendering a checkbox that supports checked, unchecked, and indeterminate states for complex selection scenarios.
+ * @publicDocs
  */
 export interface CheckboxProps extends PreactCheckboxProps {
   /**
@@ -298,6 +308,7 @@ declare module 'preact' {
 declare const tagName = 's-checkbox';
 /**
  * Props for using the checkbox component in JSX with React-style event handlers.
+ * @publicDocs
  */
 export interface CheckboxJSXProps
   extends Partial<CheckboxProps>,

package/src/surfaces/admin/components/Chip.d.ts

@@ -20,7 +20,8 @@ declare class PolarisCustomElement extends PreactCustomElement {
   constructor(renderImpl: Omit<RenderImpl, 'globalShadowCSS'>);
 }
 
-/** Used when an element does not have children. */
+/** Used when an element does not have children. * @publicDocs
+ */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /** Assigns a unique key to this element. */
   key?: preact.Key;
@@ -29,7 +30,8 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /** Assigns this element to a parent's slot. */
   slot?: Lowercase<string>;
 }
-/** Used when an element has children. */
+/** Used when an element has children. * @publicDocs
+ */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
   children?: preact.ComponentChildren;

package/src/surfaces/admin/components/Choice.d.ts

@@ -10,6 +10,7 @@ import type {ComponentChildren, ChoiceProps$1} from './shared.d.ts';
 
 /**
  * Properties for rendering a single choice within a choice list that can be selected using a radio button or checkbox.
+ * @publicDocs
  */
 export interface ChoiceProps
   extends Required<
@@ -25,10 +26,12 @@ export interface ChoiceProps
 
 /**
  * CSS styles that will be applied to the component's shadow DOM.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * Configuration for rendering a custom element with Preact and shadow DOM.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -42,6 +45,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * Information about modifier keys and mouse buttons that were active during an interaction.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -63,6 +67,7 @@ export interface ActivationEventEsque {
 }
 /**
  * Options for influencing how a programmatic click behaves.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -113,7 +118,8 @@ declare abstract class PreactCustomElement extends BaseClass {
   click({sourceEvent}?: ClickOptions): void;
 }
 
-/** Used when an element does not have children. */
+/** Used when an element does not have children. * @publicDocs
+ */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
    * A unique identifier for this element within its parent. Preact uses keys to optimize rendering performance when lists change by tracking which items have been added, removed, or reordered.
@@ -128,7 +134,8 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
    */
   slot?: Lowercase<string>;
 }
-/** Used when an element has children. */
+/** Used when an element has children. * @publicDocs
+ */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
   children?: preact.ComponentChildren;
@@ -182,6 +189,7 @@ declare module 'preact' {
 declare const tagName = 's-choice';
 /**
  * Properties for using the choice component in JSX with React-style props.
+ * @publicDocs
  */
 export interface ChoiceJSXProps
   extends Partial<ChoiceProps>,