@shopify/ui-extensions 2025.10.14 → 2025.10.15

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

@@ -19,6 +19,9 @@ export type ComponentChildren = preact.ComponentChildren;
  * Represents string-only children for components that specifically require text content.
  */
 export type StringChildren = string;
+/**
+ * @publicDocs
+ */
 export interface GlobalProps {
   /**
    * A unique identifier for the element. Use this to reference the element in JavaScript,
@@ -26,12 +29,19 @@ export interface GlobalProps {
    */
   id?: string;
 }
+/**
+ * @publicDocs
+ */
 export interface ActionProps {
   /**
    * The text to use as the action modal's title. If not provided, the name of the extension will be used.
    */
   heading?: string;
 }
+/**
+ * The admin action component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface ActionSlots {
   /**
    * The primary action button or link, representing the main or most important action available in this context.
@@ -70,6 +80,9 @@ interface AdminPrintActionProps$1 extends GlobalProps {
    */
   src?: string;
 }
+/**
+ * @publicDocs
+ */
 export interface BaseOverlayProps {
   /**
    * A callback fired immediately after the overlay is shown.
@@ -94,6 +107,8 @@ export interface BaseOverlayProps {
  * All methods are required (not optional) because components implementing this interface must provide
  * consistent JavaScript APIs. Unlike props/attributes, methods are not rendered in HTML and consumers
  * expect them to be available on all component instances.
+ *
+ * @publicDocs
  */
 export interface BaseOverlayMethods {
   /**
@@ -115,6 +130,11 @@ export interface BaseOverlayMethods {
    */
   toggleOverlay: () => void;
 }
+/**
+ * Props for focus and blur event callbacks on focusable components.
+ *
+ * @publicDocs
+ */
 export interface FocusEventProps {
   /**
    * A callback fired when the component loses focus. Learn more about the [blur event](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event).
@@ -125,6 +145,11 @@ export interface FocusEventProps {
    */
   onFocus?: (event: FocusEvent) => void;
 }
+/**
+ * Props for toggle event callbacks on elements that can open and close.
+ *
+ * @publicDocs
+ */
 export interface ToggleEventProps {
   /**
    * A callback fired when the element state changes, after any toggle animations have finished.
@@ -154,6 +179,8 @@ export interface ToggleEventProps {
  *
  * - `open`: The element is visible or expanded.
  * - `closed`: The element is hidden or collapsed.
+ *
+ * @publicDocs
  */
 export type ToggleState = 'open' | 'closed';
 interface ToggleEvent$1 extends Event {
@@ -166,6 +193,9 @@ interface ToggleEvent$1 extends Event {
    */
   readonly oldState: ToggleState;
 }
+/**
+ * @publicDocs
+ */
 export interface ExtendableEvent extends Event {
   /**
    * A method that accepts a promise signaling the duration and eventual success or failure of event-related actions.
@@ -175,6 +205,9 @@ export interface ExtendableEvent extends Event {
    */
   waitUntil?: (promise: Promise<void>) => void;
 }
+/**
+ * @publicDocs
+ */
 export interface AggregateError<T extends Error> extends Error {
   /**
    * An array of individual errors that have been aggregated together.
@@ -182,6 +215,9 @@ export interface AggregateError<T extends Error> extends Error {
    */
   errors: T[];
 }
+/**
+ * @publicDocs
+ */
 export interface AggregateErrorEvent<T extends Error> extends ErrorEvent {
   /**
    * The aggregated error object containing multiple individual errors.
@@ -273,6 +309,9 @@ interface AvatarProps$1 extends GlobalProps {
  *
  */
 export type BackgroundColorKeyword = 'transparent' | ColorKeyword;
+/**
+ * @publicDocs
+ */
 export interface BackgroundProps {
   /**
    * The background color of the element. Use `transparent` for no background, `subdued` for a subtle background, `base` for standard background, or `strong` for a prominent background.
@@ -1046,6 +1085,9 @@ interface BannerProps$1 extends GlobalProps, ActionSlots {
    */
   hidden?: boolean;
 }
+/**
+ * @publicDocs
+ */
 export interface DisplayProps {
   /**
    * The outer display type of the component, The outer type sets a component’s participation in [flow layout](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_flow_layout).
@@ -1059,6 +1101,9 @@ export interface DisplayProps {
    */
   display?: MaybeResponsive<'auto' | 'none'>;
 }
+/**
+ * @publicDocs
+ */
 export interface AccessibilityRoleProps {
   /**
    * The semantic meaning of the component’s content. When set,
@@ -1218,6 +1263,9 @@ export type AccessibilityRole =
    * Learn more about the [`none` role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/none_role) in the MDN web docs.
    */
   | 'none';
+/**
+ * @publicDocs
+ */
 export interface AccessibilityVisibilityProps {
   /**
    * The visibility mode of the element for both visual and assistive technology users.
@@ -1230,6 +1278,9 @@ export interface AccessibilityVisibilityProps {
    */
   accessibilityVisibility?: 'visible' | 'hidden' | 'exclusive';
 }
+/**
+ * @publicDocs
+ */
 export interface LabelAccessibilityVisibilityProps {
   /**
    * Controls whether the label is visible to all users or only to screen readers.
@@ -1254,6 +1305,9 @@ export interface LabelAccessibilityVisibilityProps {
  * - `none`: No padding.
  */
 export type PaddingKeyword = SizeKeyword | 'none';
+/**
+ * @publicDocs
+ */
 export interface PaddingProps {
   /**
    * The padding applied to all edges of the component.
@@ -1354,6 +1408,9 @@ export type SizeUnitsOrAuto = SizeUnits | 'auto';
  * - `none`: No size constraint, allowing unlimited growth.
  */
 export type SizeUnitsOrNone = SizeUnits | 'none';
+/**
+ * @publicDocs
+ */
 export interface SizingProps {
   /**
    * The vertical size of the element in standard layouts (height in left-to-right or right-to-left writing modes).
@@ -1457,6 +1514,9 @@ export type BorderShorthand =
   | BorderSizeKeyword
   | `${BorderSizeKeyword} ${ColorKeyword}`
   | `${BorderSizeKeyword} ${ColorKeyword} ${BorderStyleKeyword}`;
+/**
+ * @publicDocs
+ */
 export interface BorderProps {
   /**
    * A border applied using shorthand syntax to specify width, color, and style in a single property.
@@ -1535,6 +1595,9 @@ export interface BorderProps {
    */
   borderRadius?: MaybeAllValuesShorthandProperty<BorderRadiusKeyword>;
 }
+/**
+ * @publicDocs
+ */
 export interface OverflowProps {
   /**
    * The overflow behavior of the element.
@@ -1548,6 +1611,9 @@ export interface OverflowProps {
    */
   overflow?: 'hidden' | 'visible';
 }
+/**
+ * @publicDocs
+ */
 export interface BaseBoxProps
   extends AccessibilityVisibilityProps,
     BackgroundProps,
@@ -1565,10 +1631,16 @@ export interface BaseBoxProps
    */
   accessibilityLabel?: string;
 }
+/**
+ * @publicDocs
+ */
 export interface BaseBoxPropsWithRole
   extends BaseBoxProps,
     AccessibilityRoleProps {}
 interface BoxProps$1 extends BaseBoxPropsWithRole, GlobalProps {}
+/**
+ * @publicDocs
+ */
 export interface ButtonBehaviorProps extends InteractionProps, FocusEventProps {
   /**
    * The behavior of the button component.
@@ -1601,6 +1673,9 @@ export interface ButtonBehaviorProps extends InteractionProps, FocusEventProps {
    */
   loading?: boolean;
 }
+/**
+ * @publicDocs
+ */
 export interface LinkBehaviorProps extends InteractionProps, FocusEventProps {
   /**
    * The URL to navigate to when clicked. The `click` event fires first, then navigation occurs. If `commandFor` is also set, the command executes instead of navigation.
@@ -1639,9 +1714,12 @@ export interface LinkBehaviorProps extends InteractionProps, FocusEventProps {
    */
   onClick?: (event: Event) => void;
 }
+/**
+ * @publicDocs
+ */
 export interface InteractionProps {
   /**
-   * The ID of the component to control when this component is activated. Pair with the `command` property to specify what action to perform on the target component. Learn more about the [commandfor attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#commandfor).
+   * The ID of the component to control when this component is activated. Pair with the `command` property to specify what action to perform on the target component. Learn more about the [`commandFor` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#commandfor).
    */
   commandFor?: string;
   /**
@@ -1663,6 +1741,9 @@ export interface InteractionProps {
    */
   interestFor?: string;
 }
+/**
+ * @publicDocs
+ */
 export interface BaseClickableProps
   extends ButtonBehaviorProps,
     LinkBehaviorProps {}
@@ -1740,6 +1821,9 @@ interface ButtonGroupProps$1 extends GlobalProps, ActionSlots {
    */
   accessibilityLabel?: string;
 }
+/**
+ * @publicDocs
+ */
 export interface BaseInputProps {
   /**
    * The name attribute for the field, used to identify the field's value when the form is submitted. Must be unique within the nearest containing form.
@@ -1752,6 +1836,9 @@ export interface BaseInputProps {
    */
   disabled?: boolean;
 }
+/**
+ * @publicDocs
+ */
 export interface InputProps extends BaseInputProps {
   /**
    * A callback fired when the user has finished editing the field, such as when they blur the field or press Enter. Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).
@@ -1769,6 +1856,9 @@ export interface InputProps extends BaseInputProps {
    */
   defaultValue?: string;
 }
+/**
+ * @publicDocs
+ */
 export interface MultipleInputProps extends BaseInputProps {
   /**
    * A callback fired when the user has selected one or more options. Learn more about the [change event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event).
@@ -1783,6 +1873,9 @@ export interface MultipleInputProps extends BaseInputProps {
    */
   values?: string[];
 }
+/**
+ * @publicDocs
+ */
 export interface FileInputProps extends BaseInputProps {
   /**
    * A callback fired when the user has finished selecting one or more files.
@@ -1812,6 +1905,9 @@ export interface FileInputProps extends BaseInputProps {
    */
   files?: ReadonlyArray<File>;
 }
+/**
+ * @publicDocs
+ */
 export interface FieldErrorProps {
   /**
    * An error message displayed below the checkbox to indicate validation problems.
@@ -1819,6 +1915,9 @@ export interface FieldErrorProps {
    */
   error?: string;
 }
+/**
+ * @publicDocs
+ */
 export interface BasicFieldProps
   extends FieldErrorProps,
     LabelAccessibilityVisibilityProps {
@@ -1834,6 +1933,9 @@ export interface BasicFieldProps
    */
   label?: string;
 }
+/**
+ * @publicDocs
+ */
 export interface FieldDetailsProps {
   /**
    * Supplementary text displayed below the checkbox to provide additional context, instructions, or help.
@@ -1842,6 +1944,9 @@ export interface FieldDetailsProps {
    */
   details?: string;
 }
+/**
+ * @publicDocs
+ */
 export interface FieldProps
   extends BasicFieldProps,
     InputProps,
@@ -1852,6 +1957,9 @@ export interface FieldProps
    */
   placeholder?: string;
 }
+/**
+ * @publicDocs
+ */
 export interface BaseTextFieldProps extends FieldProps {
   /**
    * Whether the field is read-only and can't be edited. Read-only fields remain focusable and their content is announced by screen readers.
@@ -1860,6 +1968,9 @@ export interface BaseTextFieldProps extends FieldProps {
    */
   readOnly?: boolean;
 }
+/**
+ * @publicDocs
+ */
 export interface FieldDecorationProps {
   /**
    * A non-editable text value displayed immediately after the editable portion of the field. This is useful for displaying an implied part of the value, such as `@shopify.com` or `%`.
@@ -1891,6 +2002,9 @@ export interface FieldDecorationProps {
    */
   accessory?: ComponentChildren;
 }
+/**
+ * @publicDocs
+ */
 export interface NumberConstraintsProps {
   /**
    * The highest decimal or integer value accepted for the field. When used with `step`, the value rounds down to the maximum number.
@@ -1929,6 +2043,9 @@ export interface NumberConstraintsProps {
    */
   controls?: 'auto' | 'stepper' | 'none';
 }
+/**
+ * @publicDocs
+ */
 export interface MinMaxLengthProps {
   /**
    * The maximum number of characters allowed in the field.
@@ -1943,6 +2060,9 @@ export interface MinMaxLengthProps {
    */
   minLength?: number;
 }
+/**
+ * @publicDocs
+ */
 export interface BaseSelectableProps {
   /**
    * A label that describes the purpose or content of the component for assistive technologies like screen readers. Use this to provide additional context when the visible content alone doesn't clearly convey the component's purpose.
@@ -1961,6 +2081,9 @@ export interface BaseSelectableProps {
    */
   value?: string;
 }
+/**
+ * @publicDocs
+ */
 export interface BaseOptionProps extends BaseSelectableProps {
   /**
    * Whether the option is currently selected. Use this for controlled components where you manage the selection state.
@@ -1978,6 +2101,9 @@ export interface BaseOptionProps extends BaseSelectableProps {
    */
   defaultSelected?: boolean;
 }
+/**
+ * @publicDocs
+ */
 export interface BaseCheckableProps
   extends BaseSelectableProps,
     InteractionProps {
@@ -2055,6 +2181,9 @@ interface CheckboxProps$1
    */
   required?: boolean;
 }
+/**
+ * @publicDocs
+ */
 export interface ChipProps$1 extends GlobalProps {
   /**
    * The text label displayed within the chip component, typically representing a selected filter, tag, or removable item.
@@ -2263,6 +2392,9 @@ interface ColorPickerProps$1
    */
   defaultValue?: string;
 }
+/**
+ * @publicDocs
+ */
 export interface AutocompleteProps<
   AutocompleteField extends AnyAutocompleteField,
 > {
@@ -2783,6 +2915,7 @@ interface FunctionSettingsProps$1 extends GlobalProps, FormProps$1 {
  * These errors are returned when the extension-provided data fails validation or causes
  * issues during the commit process to Shopify's servers. Handle these errors in the
  * `onError` callback to provide feedback to users about what went wrong.
+ * @publicDocs
  */
 export interface FunctionSettingsError extends Error {
   /**
@@ -2804,6 +2937,9 @@ export interface FunctionSettingsError extends Error {
  * Defines the spacing size between elements, using the standard size scale or `none` for no spacing.
  */
 export type SpacingKeyword = SizeKeyword | 'none';
+/**
+ * @publicDocs
+ */
 export interface GapProps {
   /**
    * The spacing between child elements.
@@ -3015,6 +3151,9 @@ interface GridItemProps$1 extends GlobalProps, BaseBoxPropsWithRole {
    */
   gridRow?: `span ${number}` | 'auto';
 }
+/**
+ * @publicDocs
+ */
 export interface BaseTypographyProps {
   /**
    * The color emphasis level that controls visual intensity.
@@ -3077,6 +3216,9 @@ export interface BaseTypographyProps {
    */
   dir?: 'ltr' | 'rtl' | 'auto' | '';
 }
+/**
+ * @publicDocs
+ */
 export interface BlockTypographyProps {
   /**
    * The maximum number of lines to display before truncating the text content.
@@ -3151,6 +3293,9 @@ interface IconProps$1
    */
   type?: IconType | AnyString;
 }
+/**
+ * @publicDocs
+ */
 export interface BaseImageProps {
   /**
    * Alternative text that describes the image for accessibility.
@@ -3654,6 +3799,9 @@ interface SwitchProps$1
     BasicFieldProps,
     FieldDetailsProps,
     FieldErrorProps {}
+/**
+ * @publicDocs
+ */
 export interface PaginationProps {
   /**
    * Whether to use pagination controls.
@@ -3953,6 +4101,9 @@ export type URLAutocompleteField = ExtractStrict<
 //
 // Preact Virtual DOM
 // -----------------------------------
+/**
+ * @publicDocs
+ */
 export interface VNode<P = {}> {
   /**
    * The component type or HTML element tag name that this VNode represents.
@@ -3993,6 +4144,9 @@ export interface VNode<P = {}> {
  * Can be a string, number, or any other value.
  */
 export type Key = string | number | any;
+/**
+ * @publicDocs
+ */
 export interface RefObject<T> {
   /**
    * The current value of the ref, which holds a reference to the DOM element or component instance.
@@ -4023,6 +4177,9 @@ export type ComponentChild =
   | null
   | undefined;
 type ComponentChildren$1 = ComponentChild[] | ComponentChild;
+/**
+ * @publicDocs
+ */
 export interface Attributes {
   /**
    * A unique key used to identify this element in lists for efficient reconciliation during re-renders.
@@ -4033,6 +4190,9 @@ export interface Attributes {
    */
   jsx?: boolean | undefined;
 }
+/**
+ * @publicDocs
+ */
 export interface ErrorInfo {
   /**
    * A string representation of the component stack trace at the point where an error occurred.
@@ -4060,6 +4220,9 @@ export type RenderableProps<P, RefType = any> = P &
  * Represents any valid component type, either a class component or a function component.
  */
 export type ComponentType<P = {}> = ComponentClass<P> | FunctionComponent<P>;
+/**
+ * @publicDocs
+ */
 export interface FunctionComponent<P = {}> {
   (props: RenderableProps<P>, context?: any): ComponentChildren$1;
   /**
@@ -4071,6 +4234,9 @@ export interface FunctionComponent<P = {}> {
    */
   defaultProps?: Partial<P> | undefined;
 }
+/**
+ * @publicDocs
+ */
 export interface ComponentClass<P = {}, S = {}> {
   new (props: P, context?: any): Component<P, S>;
   /**
@@ -4091,6 +4257,9 @@ export interface ComponentClass<P = {}, S = {}> {
   ): Partial<S> | null;
   getDerivedStateFromError?(error: any): Partial<S> | null;
 }
+/**
+ * @publicDocs
+ */
 export interface Component<P = {}, S = {}> {
   componentWillMount?(): void;
   componentDidMount?(): void;
@@ -4171,6 +4340,9 @@ declare abstract class Component<P, S> {
 //
 // Context
 // -----------------------------------
+/**
+ * @publicDocs
+ */
 export interface Consumer<T>
   extends FunctionComponent<{
     /**
@@ -4179,6 +4351,9 @@ export interface Consumer<T>
      */
     children: (value: T) => ComponentChildren$1;
   }> {}
+/**
+ * @publicDocs
+ */
 export interface Provider<T>
   extends FunctionComponent<{
     /**
@@ -4190,6 +4365,9 @@ export interface Provider<T>
      */
     children?: ComponentChildren$1;
   }> {}
+/**
+ * @publicDocs
+ */
 export interface Context<T> extends Provider<T> {
   /**
    * A component that consumes the context value and re-renders when it changes.
@@ -4717,6 +4895,9 @@ type IconType$1 =
   | 'x'
   | 'x-circle';
 
+/**
+ * @publicDocs
+ */
 export interface AvatarProps
   extends Required<Pick<AvatarProps$1, 'initials' | 'src' | 'size'>> {
   /**
@@ -4761,6 +4942,9 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   ShadowRoot: (element: any) => ComponentChildren;
   styles?: Styles;
 };
+/**
+ * @publicDocs
+ */
 export interface ActivationEventEsque {
   /**
    * Whether the Shift key was pressed when the event occurred.
@@ -4779,6 +4963,9 @@ export interface ActivationEventEsque {
    */
   button: number;
 }
+/**
+ * @publicDocs
+ */
 export interface ClickOptions {
   /**
    * The event you want to influence the synthetic click.
@@ -4878,6 +5065,9 @@ export type CallbackErrorEventListener<
       ): void;
     })
   | null;
+/**
+ * @publicDocs
+ */
 export interface CallbackExtendableEvent<
   TTagName extends keyof HTMLElementTagNameMap,
 > extends CallbackEvent<TTagName>,
@@ -4893,6 +5083,9 @@ export type CallbackExtendableEventListener<
       (event: CallbackExtendableEvent<TTagName>): void;
     })
   | null;
+/**
+ * @publicDocs
+ */
 export interface FieldReactProps<T extends keyof HTMLElementTagNameMap> {
   /**
    * A callback fired when the user makes changes to the field value. This fires before `onChange`.
@@ -4914,6 +5107,7 @@ export interface FieldReactProps<T extends keyof HTMLElementTagNameMap> {
 /**
  * Base props for Preact custom elements without children support.
  * Includes common properties like key, ref, and slot for elements that don't accept child content.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -4936,6 +5130,7 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 /**
  * Base props for Preact custom elements with children support.
  * Extends PreactBaseElementProps with the ability to render child elements.
+ * @publicDocs
  */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
@@ -4945,6 +5140,10 @@ export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   children?: preact.ComponentChildren;
 }
 
+/**
+ * Configure the following properties on the avatar component.
+ * @publicDocs
+ */
 declare class Avatar extends PreactCustomElement implements AvatarProps {
   accessor initials: AvatarProps['initials'];
   accessor src: AvatarProps['src'];
@@ -4966,6 +5165,9 @@ declare module 'preact' {
 }
 
 declare const tagName$Z = 's-avatar';
+/**
+ * @publicDocs
+ */
 export interface AvatarJSXProps
   extends Partial<AvatarProps>,
     Pick<AvatarProps$1, 'id'> {
@@ -4979,6 +5181,9 @@ export interface AvatarJSXProps
   onError?: () => void;
 }
 
+/**
+ * @publicDocs
+ */
 export interface IconProps
   extends Pick<
     IconProps$1,
@@ -5006,6 +5211,9 @@ export interface IconProps
   size: Extract<IconProps$1['size'], 'small' | 'base'>;
 }
 
+/**
+ * @publicDocs
+ */
 export interface BadgeProps
   extends Pick<BadgeProps$1, 'color' | 'icon' | 'size' | 'tone'> {
   color: Extract<BadgeProps$1['color'], 'base' | 'strong'>;
@@ -5024,6 +5232,10 @@ export interface BadgeProps
   >;
 }
 
+/**
+ * Configure the following properties on the badge component.
+ * @publicDocs
+ */
 declare class Badge extends PreactCustomElement implements BadgeProps {
   accessor color: BadgeProps['color'];
   accessor icon: BadgeProps['icon'];
@@ -5045,6 +5257,9 @@ declare module 'preact' {
 }
 
 declare const tagName$Y = 's-badge';
+/**
+ * @publicDocs
+ */
 export interface BadgeJSXProps
   extends Partial<BadgeProps>,
     Pick<BadgeProps$1, 'id' | 'children'> {
@@ -5058,6 +5273,9 @@ export interface BadgeJSXProps
  * Represents the banner component props with all properties marked as required.
  */
 export type RequiredBannerProps = Required<BannerProps$1>;
+/**
+ * @publicDocs
+ */
 export interface BannerProps
   extends Pick<
     RequiredBannerProps,
@@ -5069,6 +5287,10 @@ export interface BannerProps
   >;
 }
 
+/**
+ * Configure the following properties on the banner component.
+ * @publicDocs
+ */
 declare class Banner extends PreactCustomElement implements BannerProps {
   accessor heading: BannerProps['heading'];
   accessor tone: BannerProps['tone'];
@@ -5091,6 +5313,9 @@ declare module 'preact' {
 }
 
 declare const tagName$X = 's-banner';
+/**
+ * @publicDocs
+ */
 export interface BannerJSXProps
   extends Partial<BannerProps>,
     Pick<BannerProps$1, 'id' | 'children'> {
@@ -5195,6 +5420,9 @@ export type ResponsiveBoxProps = MakeResponsivePick<
   | 'paddingInlineEnd'
   | 'display'
 >;
+/**
+ * @publicDocs
+ */
 export interface BoxProps
   extends Pick<
     RequiredBoxProps,
@@ -5451,6 +5679,10 @@ declare class BoxElement extends PreactCustomElement implements BoxProps {
   accessor display: BoxProps['display'];
 }
 
+/**
+ * Configure the following properties on the box component.
+ * @publicDocs
+ */
 declare class Box extends BoxElement implements BoxProps {
   constructor();
 }
@@ -5468,6 +5700,9 @@ declare module 'preact' {
 }
 
 declare const tagName$W = 's-box';
+/**
+ * @publicDocs
+ */
 export interface BoxJSXProps
   extends Partial<BoxProps>,
     Pick<BoxProps$1, 'id' | 'children'> {
@@ -5509,11 +5744,17 @@ export type ButtonBaseProps = Required<
     | 'download'
   >
 >;
+/**
+ * @publicDocs
+ */
 export interface ButtonProps extends ButtonBaseProps {
   tone: Extract<ButtonProps$1['tone'], 'neutral' | 'critical' | 'auto'>;
   icon: IconProps['type'];
 }
 
+/**
+ * @publicDocs
+ */
 export interface PreactOverlayControlProps
   extends Pick<InteractionProps, 'commandFor' | 'interestFor'> {
   /**
@@ -5544,6 +5785,10 @@ declare const Button_base: (abstract new (
   args_0: RenderImpl,
 ) => PreactCustomElement & PreactOverlayControlProps) &
   Pick<typeof PreactCustomElement, 'prototype' | 'observedAttributes'>;
+/**
+ * Configure the following properties on the button component.
+ * @publicDocs
+ */
 declare class Button extends Button_base implements ButtonProps {
   accessor disabled: ButtonProps['disabled'];
   accessor icon: ButtonProps['icon'];
@@ -5571,6 +5816,9 @@ declare module 'preact' {
 }
 
 declare const tagName$V = 's-button';
+/**
+ * @publicDocs
+ */
 export interface ButtonJSXProps
   extends Partial<ButtonProps>,
     Pick<ButtonProps$1, 'id' | 'children'> {
@@ -5592,9 +5840,16 @@ export interface ButtonJSXProps
   onBlur?: ((event: CallbackEvent<typeof tagName$V>) => void) | null;
 }
 
+/**
+ * @publicDocs
+ */
 export interface ButtonGroupProps
   extends Required<Pick<ButtonGroupProps$1, 'gap' | 'accessibilityLabel'>> {}
 
+/**
+ * Configure the following properties on the button group component.
+ * @publicDocs
+ */
 declare class ButtonGroup
   extends PreactCustomElement
   implements ButtonGroupProps
@@ -5621,6 +5876,9 @@ declare module 'preact' {
 }
 
 declare const tagName$U = 's-button-group';
+/**
+ * @publicDocs
+ */
 export interface ButtonGroupJSXProps
   extends Partial<ButtonGroupProps>,
     Pick<ButtonGroupProps$1, 'id' | 'children'> {
@@ -5667,6 +5925,9 @@ declare class PreactInputElement
   constructor(renderImpl: RenderImpl);
 }
 
+/**
+ * @publicDocs
+ */
 export interface PreactCheckboxProps
   extends Required<
     Pick<
@@ -5710,6 +5971,9 @@ declare class PreactCheckboxElement
   constructor(renderImpl: RenderImpl);
 }
 
+/**
+ * @publicDocs
+ */
 export interface CheckboxProps extends PreactCheckboxProps {
   /**
    * Whether the checkbox displays in an indeterminate state (neither checked nor unchecked),
@@ -5733,6 +5997,10 @@ export interface CheckboxProps extends PreactCheckboxProps {
   defaultIndeterminate: Required<CheckboxProps$1>['defaultIndeterminate'];
 }
 
+/**
+ * Configure the following properties on the checkbox component.
+ * @publicDocs
+ */
 declare class Checkbox extends PreactCheckboxElement implements CheckboxProps {
   get indeterminate(): CheckboxProps['indeterminate'];
   set indeterminate(indeterminate: CheckboxProps['indeterminate']);
@@ -5753,6 +6021,9 @@ declare module 'preact' {
 }
 
 declare const tagName$T = 's-checkbox';
+/**
+ * @publicDocs
+ */
 export interface CheckboxJSXProps
   extends Partial<CheckboxProps>,
     Pick<CheckboxProps$1, 'id'> {
@@ -5766,9 +6037,16 @@ export interface CheckboxJSXProps
   onInput?: ((event: CallbackEvent<typeof tagName$T>) => void) | null;
 }
 
+/**
+ * @publicDocs
+ */
 export interface ChipProps
   extends Required<Pick<ChipProps$2, 'color' | 'accessibilityLabel'>> {}
 
+/**
+ * Configure the following properties on the chip component.
+ * @publicDocs
+ */
 declare class Chip extends PreactCustomElement implements ChipProps {
   accessor color: ChipProps['color'];
   accessor accessibilityLabel: ChipProps['accessibilityLabel'];
@@ -5789,6 +6067,9 @@ declare module 'preact' {
 }
 
 declare const tagName$S = 's-chip';
+/**
+ * @publicDocs
+ */
 export interface ChipJSXProps
   extends Partial<ChipProps>,
     Pick<ChipProps$2, 'id' | 'children'> {
@@ -5802,6 +6083,9 @@ export interface ChipJSXProps
   graphic?: ComponentChildren;
 }
 
+/**
+ * @publicDocs
+ */
 export interface ChoiceProps
   extends Required<
     Pick<
@@ -5814,6 +6098,10 @@ export interface ChoiceProps
     >
   > {}
 
+/**
+ * Configure the following properties on the choice component.
+ * @publicDocs
+ */
 declare class Choice extends PreactCustomElement implements ChoiceProps {
   accessor disabled: ChoiceProps['disabled'];
   get selected(): boolean;
@@ -5842,6 +6130,9 @@ declare module 'preact' {
 }
 
 declare const tagName$R = 's-choice';
+/**
+ * @publicDocs
+ */
 export interface ChoiceJSXProps
   extends Partial<ChoiceProps>,
     Pick<ChoiceProps$1, 'id' | 'children' | 'details'> {
@@ -5864,6 +6155,9 @@ export interface ChoiceJSXProps
   details?: ComponentChildren;
 }
 
+/**
+ * @publicDocs
+ */
 export interface ChoiceListProps
   extends Required<
     Pick<
@@ -5886,6 +6180,10 @@ declare class BaseClass$3 extends PreactCustomElement {
   /** @private */
   [internals$3]: ElementInternals;
 }
+/**
+ * Configure the following properties on the choice list component.
+ * @publicDocs
+ */
 declare class ChoiceList extends BaseClass$3 implements ChoiceListProps {
   accessor disabled: ChoiceListProps['disabled'];
   accessor name: ChoiceListProps['name'];
@@ -5919,6 +6217,9 @@ declare module 'preact' {
 }
 
 declare const tagName$Q = 's-choice-list';
+/**
+ * @publicDocs
+ */
 export interface ChoiceListJSXProps
   extends Partial<ChoiceListProps>,
     Pick<ChoiceListProps$1, 'id' | 'children'> {
@@ -5957,6 +6258,9 @@ export type ClickableBaseProps = Required<
     | 'type'
   >
 >;
+/**
+ * @publicDocs
+ */
 export interface ClickableProps
   extends Required<BoxProps>,
     ClickableBaseProps {}
@@ -5965,6 +6269,10 @@ declare const Clickable_base: (abstract new (
   renderImpl: RenderImpl,
 ) => BoxElement & PreactOverlayControlProps) &
   Pick<typeof BoxElement, 'prototype' | 'observedAttributes'>;
+/**
+ * Configure the following properties on the clickable component.
+ * @publicDocs
+ */
 declare class Clickable extends Clickable_base implements ClickableProps {
   accessor disabled: ClickableProps['disabled'];
   accessor loading: ClickableProps['loading'];
@@ -5989,6 +6297,9 @@ declare module 'preact' {
 }
 
 declare const tagName$P = 's-clickable';
+/**
+ * @publicDocs
+ */
 export interface ClickableJSXProps
   extends Partial<ClickableProps>,
     Pick<ClickableProps$1, 'id' | 'children'> {
@@ -6010,6 +6321,9 @@ export interface ClickableJSXProps
   onBlur?: ((event: CallbackEvent<typeof tagName$P>) => void) | null;
 }
 
+/**
+ * @publicDocs
+ */
 export interface ClickableChipProps
   extends Required<
     Pick<
@@ -6030,6 +6344,10 @@ declare const ClickableChip_base: (abstract new (
   args_0: RenderImpl,
 ) => PreactCustomElement & PreactOverlayControlProps) &
   Pick<typeof PreactCustomElement, 'prototype' | 'observedAttributes'>;
+/**
+ * Configure the following properties on the clickable chip component.
+ * @publicDocs
+ */
 declare class ClickableChip
   extends ClickableChip_base
   implements ClickableChipProps
@@ -6057,6 +6375,9 @@ declare module 'preact' {
 }
 
 declare const tagName$O = 's-clickable-chip';
+/**
+ * @publicDocs
+ */
 export interface ClickableChipJSXProps
   extends Partial<ClickableChipProps>,
     Pick<ClickableChipProps$1, 'id' | 'children'> {
@@ -6175,6 +6496,10 @@ export type ColorFieldProps = Omit<
 > &
   Required<Pick<ColorFieldProps$1, 'alpha' | 'value' | 'defaultValue'>>;
 
+/**
+ * Configure the following properties on the color field component.
+ * @publicDocs
+ */
 declare class ColorField
   extends PreactFieldElement<ColorFieldProps['autocomplete']>
   implements ColorFieldProps
@@ -6202,6 +6527,9 @@ declare module 'preact' {
 }
 
 declare const tagName$N = 's-color-field';
+/**
+ * @publicDocs
+ */
 export interface ColorFieldJSXProps
   extends Partial<
       Omit<ColorFieldProps, 'accessory' | 'value' | 'defaultValue'>
@@ -6212,6 +6540,9 @@ export interface ColorFieldJSXProps
   onChange?: (event: CallbackEvent<typeof tagName$N>) => void;
 }
 
+/**
+ * @publicDocs
+ */
 export interface ColorPickerProps
   extends Required<
     Pick<ColorPickerProps$1, 'id' | 'alpha' | 'value' | 'defaultValue' | 'name'>
@@ -6224,6 +6555,10 @@ declare class BaseClass$2 extends PreactCustomElement {
   /** @private */
   [internals$2]: ElementInternals;
 }
+/**
+ * Configure the following properties on the color picker component.
+ * @publicDocs
+ */
 declare class ColorPicker extends BaseClass$2 implements ColorPickerProps {
   accessor alpha: boolean;
   accessor name: string;
@@ -6250,6 +6585,9 @@ declare module 'preact' {
 }
 
 declare const tagName$M = 's-color-picker';
+/**
+ * @publicDocs
+ */
 export interface ColorPickerJSXProps
   extends Partial<ColorPickerProps>,
     Pick<
@@ -6260,6 +6598,9 @@ export interface ColorPickerJSXProps
   onChange?: (event: CallbackEvent<typeof tagName$M>) => void | null;
 }
 
+/**
+ * @publicDocs
+ */
 export interface DateFieldProps
   extends Omit<
       PreactFieldProps<DateAutocompleteField>,
@@ -6279,6 +6620,10 @@ export interface DateFieldProps
       >
     > {}
 
+/**
+ * Configure the following properties on the date field component.
+ * @publicDocs
+ */
 declare class DateField
   extends PreactFieldElement<DateFieldProps['autocomplete']>
   implements DateFieldProps
@@ -6306,6 +6651,9 @@ declare module 'preact' {
 }
 
 declare const tagName$L = 's-date-field';
+/**
+ * @publicDocs
+ */
 export interface DateFieldJSXProps
   extends Partial<Omit<DateFieldProps, 'value' | 'defaultValue'>>,
     Pick<DateFieldProps$1, 'id' | 'value' | 'defaultValue'> {
@@ -6335,6 +6683,9 @@ export interface DateFieldJSXProps
   onViewChange?: ((event: CallbackEvent<typeof tagName$L>) => void) | null;
 }
 
+/**
+ * @publicDocs
+ */
 export interface DatePickerProps
   extends Required<
     Pick<
@@ -6369,6 +6720,10 @@ declare class BaseClass$1 extends PreactCustomElement {
   /** @private */
   [internals$1]: ElementInternals;
 }
+/**
+ * Configure the following properties on the date picker component.
+ * @publicDocs
+ */
 declare class DatePicker extends BaseClass$1 implements DatePickerProps {
   accessor defaultView: string;
   set view(view: string);
@@ -6402,6 +6757,9 @@ declare module 'preact' {
 }
 
 declare const tagName$K = 's-date-picker';
+/**
+ * @publicDocs
+ */
 export interface DatePickerJSXProps
   extends Partial<DatePickerProps>,
     Pick<DatePickerProps$1, 'id'> {
@@ -6427,12 +6785,19 @@ export interface DatePickerJSXProps
   onChange?: ((event: CallbackEvent<typeof tagName$K>) => void) | null;
 }
 
+/**
+ * @publicDocs
+ */
 export interface DividerProps
   extends Pick<DividerProps$1, 'direction' | 'color'> {
   direction: Extract<DividerProps$1['direction'], 'inline' | 'block'>;
   color: Extract<DividerProps$1['color'], 'base' | 'strong'>;
 }
 
+/**
+ * Configure the following properties on the divider component.
+ * @publicDocs
+ */
 declare class Divider extends PreactCustomElement implements DividerProps {
   accessor direction: DividerProps['direction'];
   accessor color: DividerProps['color'];
@@ -6452,10 +6817,16 @@ declare module 'preact' {
 }
 
 declare const tagName$J = 's-divider';
+/**
+ * @publicDocs
+ */
 export interface DividerJSXProps
   extends Partial<DividerProps>,
     Pick<DividerProps$1, 'id'> {}
 
+/**
+ * @publicDocs
+ */
 export interface DropZoneProps
   extends Required<
     Pick<
@@ -6490,6 +6861,10 @@ declare class BaseClass extends PreactCustomElement {
   /** @private */
   [internals]: ElementInternals;
 }
+/**
+ * Configure the following properties on the drop zone component.
+ * @publicDocs
+ */
 declare class DropZone extends BaseClass implements DropZoneProps {
   accessor accept: DropZoneProps['accept'];
   accessor accessibilityLabel: DropZoneProps['accessibilityLabel'];
@@ -6533,6 +6908,9 @@ declare module 'preact' {
 }
 
 declare const tagName$I = 's-drop-zone';
+/**
+ * @publicDocs
+ */
 export interface DropZoneJSXProps
   extends Partial<DropZoneProps>,
     Pick<DropZoneProps$1, 'id'> {
@@ -6563,6 +6941,10 @@ export type EmailFieldProps = PreactFieldProps<
 > &
   Required<Pick<EmailFieldProps$1, 'maxLength' | 'minLength'>>;
 
+/**
+ * Configure the following properties on the email field component.
+ * @publicDocs
+ */
 declare class EmailField
   extends PreactFieldElement<EmailFieldProps['autocomplete']>
   implements EmailFieldProps
@@ -6591,6 +6973,9 @@ declare module 'preact' {
 }
 
 declare const tagName$H = 's-email-field';
+/**
+ * @publicDocs
+ */
 export interface EmailFieldJSXProps
   extends Partial<Omit<EmailFieldProps, 'accessory'>>,
     Pick<EmailFieldProps$1, 'id'>,
@@ -6609,6 +6994,9 @@ export type ResponsiveGridProps = MakeResponsivePick<
   RequiredAlignedProps,
   'rowGap' | 'columnGap' | 'gap' | 'gridTemplateColumns' | 'gridTemplateRows'
 >;
+/**
+ * @publicDocs
+ */
 export interface GridProps
   extends BoxProps,
     Required<
@@ -6713,6 +7101,10 @@ export interface GridProps
   gridTemplateRows: ResponsiveGridProps['gridTemplateRows'];
 }
 
+/**
+ * Configure the following properties on the grid component.
+ * @publicDocs
+ */
 declare class Grid extends BoxElement implements GridProps {
   constructor();
   accessor gridTemplateColumns: GridProps['gridTemplateColumns'];
@@ -6741,6 +7133,9 @@ declare module 'preact' {
 }
 
 declare const tagName$G = 's-grid';
+/**
+ * @publicDocs
+ */
 export interface GridJSXProps
   extends Partial<GridProps>,
     Pick<GridProps$1, 'id' | 'children'> {
@@ -6754,6 +7149,9 @@ export interface GridJSXProps
  * Represents the grid item component props with all properties marked as required.
  */
 export type RequiredGridItemProps = Required<GridItemProps$1>;
+/**
+ * @publicDocs
+ */
 export interface GridItemProps
   extends BoxProps,
     Required<Pick<GridItemProps$1, 'gridColumn' | 'gridRow'>> {
@@ -6761,6 +7159,10 @@ export interface GridItemProps
   gridRow: RequiredGridItemProps['gridRow'];
 }
 
+/**
+ * Configure the following properties on the grid item component.
+ * @publicDocs
+ */
 declare class GridItem extends BoxElement implements GridItemProps {
   accessor gridColumn: GridItemProps['gridColumn'];
   accessor gridRow: GridItemProps['gridRow'];
@@ -6781,6 +7183,9 @@ declare module 'preact' {
 }
 
 declare const tagName$F = 's-grid-item';
+/**
+ * @publicDocs
+ */
 export interface GridItemJSXProps
   extends Partial<GridItemProps>,
     Pick<GridItemProps$1, 'id' | 'children'> {
@@ -6790,6 +7195,9 @@ export interface GridItemJSXProps
   children?: ComponentChildren;
 }
 
+/**
+ * @publicDocs
+ */
 export interface HeadingProps
   extends Required<
     Pick<
@@ -6798,6 +7206,10 @@ export interface HeadingProps
     >
   > {}
 
+/**
+ * Configure the following properties on the heading component.
+ * @publicDocs
+ */
 declare class Heading extends PreactCustomElement implements HeadingProps {
   accessor accessibilityRole: HeadingProps['accessibilityRole'];
   accessor lineClamp: HeadingProps['lineClamp'];
@@ -6819,6 +7231,9 @@ declare module 'preact' {
 }
 
 declare const tagName$E = 's-heading';
+/**
+ * @publicDocs
+ */
 export interface HeadingJSXProps
   extends Partial<HeadingProps>,
     Pick<HeadingProps$1, 'id' | 'children'> {
@@ -6828,6 +7243,10 @@ export interface HeadingJSXProps
   children?: ComponentChildren;
 }
 
+/**
+ * Configure the following properties on the icon component.
+ * @publicDocs
+ */
 declare class Icon extends PreactCustomElement implements IconProps {
   accessor color: IconProps['color'];
   accessor tone: IconProps['tone'];
@@ -6850,10 +7269,16 @@ declare module 'preact' {
 }
 
 declare const tagName$D = 's-icon';
+/**
+ * @publicDocs
+ */
 export interface IconJSXProps
   extends Partial<IconProps>,
     Pick<IconProps$1, 'id'> {}
 
+/**
+ * @publicDocs
+ */
 export interface ImageProps
   extends Required<
       Pick<
@@ -6880,6 +7305,10 @@ export interface ImageProps
       >
     > {}
 
+/**
+ * Configure the following properties on the image component.
+ * @publicDocs
+ */
 declare class Image extends PreactCustomElement implements ImageProps {
   accessor src: ImageProps['src'];
   accessor srcSet: ImageProps['srcSet'];
@@ -6926,6 +7355,9 @@ declare module 'preact' {
 }
 
 declare const tagName$C = 's-image';
+/**
+ * @publicDocs
+ */
 export interface ImageJSXProps
   extends Partial<ImageProps>,
     Pick<ImageProps$1, 'id'> {
@@ -6960,6 +7392,9 @@ export type LinkBaseProps = Required<
     | 'tone'
   >
 >;
+/**
+ * @publicDocs
+ */
 export interface LinkProps extends LinkBaseProps {
   tone: Extract<RequiredLinkProps['tone'], 'auto' | 'neutral' | 'critical'>;
 }
@@ -6968,6 +7403,10 @@ declare const Link_base: (abstract new (
   args_0: RenderImpl,
 ) => PreactCustomElement & PreactOverlayControlProps) &
   Pick<typeof PreactCustomElement, 'prototype' | 'observedAttributes'>;
+/**
+ * Configure the following properties on the link component.
+ * @publicDocs
+ */
 declare class Link extends Link_base implements LinkProps {
   accessor tone: LinkProps['tone'];
   accessor accessibilityLabel: LinkProps['accessibilityLabel'];
@@ -6991,6 +7430,9 @@ declare module 'preact' {
 }
 
 declare const tagName$B = 's-link';
+/**
+ * @publicDocs
+ */
 export interface LinkJSXProps
   extends Partial<LinkProps>,
     Pick<LinkProps$1, 'id' | 'lang' | 'children'> {
@@ -7004,8 +7446,17 @@ export interface LinkJSXProps
   onClick?: ((event: CallbackEvent<typeof tagName$B>) => void) | null;
 }
 
+/**
+ * @publicDocs
+ */
 export interface ListItemProps extends ListItemProps$1 {}
 
+/**
+ * The list item component represents a single entry within an ordered list or unordered list. Use list item to structure individual points, steps, or items within a list, with each item automatically receiving appropriate list markers (bullets or numbers) from its parent list.
+ *
+ * List item must be used as a direct child of ordered list or unordered list components. Each list item can contain text, inline formatting, or other components to create rich list content.
+ * @publicDocs
+ */
 declare class ListItem extends PreactCustomElement implements ListItemProps {
   constructor();
 }
@@ -7024,6 +7475,9 @@ declare module 'preact' {
 }
 
 declare const tagName$A = 's-list-item';
+/**
+ * @publicDocs
+ */
 export interface ListItemJSXProps
   extends Partial<ListItemProps>,
     Pick<ListItemProps$1, 'id' | 'children'> {
@@ -7033,6 +7487,9 @@ export interface ListItemJSXProps
   children?: ComponentChildren;
 }
 
+/**
+ * @publicDocs
+ */
 export interface MenuProps
   extends Required<Pick<MenuProps$1, 'id' | 'accessibilityLabel'>> {}
 
@@ -7084,6 +7541,10 @@ declare class PreactOverlayElement extends PreactCustomElement {
   [overlayHideFrameId]?: number;
 }
 
+/**
+ * Configure the following properties on the menu component.
+ * @publicDocs
+ */
 declare class Menu extends PreactOverlayElement implements MenuProps {
   accessor accessibilityLabel: string;
   constructor();
@@ -7106,6 +7567,9 @@ declare module 'preact' {
 }
 
 declare const tagName$z = 's-menu';
+/**
+ * @publicDocs
+ */
 export interface MenuJSXProps
   extends Partial<MenuProps>,
     Pick<MenuProps$1, 'id' | 'children'> {
@@ -7119,6 +7583,9 @@ export interface MenuJSXProps
  * Represents the modal component props with all properties marked as required.
  */
 export type RequiredAlignedModalProps = Required<ModalProps$1>;
+/**
+ * @publicDocs
+ */
 export interface ModalProps
   extends Pick<
     RequiredAlignedModalProps,
@@ -7139,6 +7606,9 @@ export interface ModalProps
   >;
 }
 
+/**
+ * @publicDocs
+ */
 export interface Context<T> {
   /**
    * The default value for this context, used when no Provider is found in the component tree.
@@ -7198,6 +7668,10 @@ declare const abortController: unique symbol;
 declare const onChildModalChange: unique symbol;
 declare const childrenRerenderObserver: unique symbol;
 declare const shadowDomRerenderObserver: unique symbol;
+/**
+ * Configure the following properties on the modal component.
+ * @publicDocs
+ */
 declare class Modal extends PreactOverlayElement implements ModalProps {
   accessor accessibilityLabel: ModalProps['accessibilityLabel'];
   accessor heading: ModalProps['heading'];
@@ -7255,6 +7729,9 @@ declare module 'preact' {
 }
 
 declare const tagName$y = 's-modal';
+/**
+ * @publicDocs
+ */
 export interface ModalJSXProps
   extends Partial<ModalProps>,
     Pick<ModalProps$1, 'id' | 'children'> {
@@ -7296,12 +7773,19 @@ export interface ModalJSXProps
  * Represents the money field component props with all properties marked as required.
  */
 export type RequiredMoneyFieldProps = Required<MoneyFieldProps$1>;
+/**
+ * @publicDocs
+ */
 export interface MoneyFieldProps
   extends Omit<PreactFieldProps, 'value'>,
     Pick<RequiredMoneyFieldProps, 'max' | 'min'> {
   value: Required<MoneyFieldProps$1>['value'];
 }
 
+/**
+ * Configure the following properties on the money field component.
+ * @publicDocs
+ */
 declare class MoneyField
   extends PreactFieldElement<MoneyFieldProps['autocomplete']>
   implements MoneyFieldProps
@@ -7329,11 +7813,17 @@ declare module 'preact' {
 }
 
 declare const tagName$x = 's-money-field';
+/**
+ * @publicDocs
+ */
 export interface MoneyFieldJSXProps
   extends Partial<MoneyFieldProps>,
     FieldReactProps<typeof tagName$x>,
     Pick<MoneyFieldProps$1, 'id'> {}
 
+/**
+ * @publicDocs
+ */
 export interface NumberFieldProps
   extends Omit<
       PreactFieldProps<Required<NumberFieldProps$1>['autocomplete']>,
@@ -7348,6 +7838,10 @@ export interface NumberFieldProps
   value: Required<NumberFieldProps$1>['value'];
 }
 
+/**
+ * Configure the following properties on the number field component.
+ * @publicDocs
+ */
 declare class NumberField
   extends PreactFieldElement<NumberFieldProps['autocomplete']>
   implements NumberFieldProps
@@ -7379,16 +7873,26 @@ declare module 'preact' {
 }
 
 declare const tagName$w = 's-number-field';
+/**
+ * @publicDocs
+ */
 export interface NumberFieldJSXProps
   extends Partial<NumberFieldProps>,
     Pick<NumberFieldProps$1, 'id'>,
     FieldReactProps<typeof tagName$w> {}
 
+/**
+ * @publicDocs
+ */
 export interface OptionProps
   extends Required<
     Pick<OptionProps$1, 'disabled' | 'value' | 'selected' | 'defaultSelected'>
   > {}
 
+/**
+ * Configure the following properties on the option component.
+ * @publicDocs
+ */
 declare class Option extends PreactCustomElement implements OptionProps {
   accessor selected: OptionProps['selected'];
   accessor defaultSelected: OptionProps['defaultSelected'];
@@ -7410,6 +7914,9 @@ declare module 'preact' {
 }
 
 declare const tagName$v = 's-option';
+/**
+ * @publicDocs
+ */
 export interface OptionJSXProps
   extends Partial<OptionProps>,
     Pick<OptionProps$1, 'id' | 'children'> {
@@ -7419,9 +7926,16 @@ export interface OptionJSXProps
   children?: ComponentChildren;
 }
 
+/**
+ * @publicDocs
+ */
 export interface OptionGroupProps
   extends Required<Pick<OptionGroupProps$1, 'disabled' | 'label'>> {}
 
+/**
+ * Configure the following properties on the option group component.
+ * @publicDocs
+ */
 declare class OptionGroup
   extends PreactCustomElement
   implements OptionGroupProps
@@ -7445,6 +7959,9 @@ declare module 'preact' {
 }
 
 declare const tagName$u = 's-option-group';
+/**
+ * @publicDocs
+ */
 export interface OptionGroupJSXProps
   extends Partial<OptionGroupProps>,
     Pick<OptionGroupProps$1, 'id' | 'children'> {
@@ -7454,8 +7971,15 @@ export interface OptionGroupJSXProps
   children?: ComponentChildren;
 }
 
+/**
+ * @publicDocs
+ */
 export interface OrderedListProps extends OrderedListProps$1 {}
 
+/**
+ * Configure the following properties on the ordered list component.
+ * @publicDocs
+ */
 declare class OrderedList
   extends PreactCustomElement
   implements OrderedListProps
@@ -7477,6 +8001,9 @@ declare module 'preact' {
 }
 
 declare const tagName$t = 's-ordered-list';
+/**
+ * @publicDocs
+ */
 export interface OrderedListJSXProps
   extends Partial<OrderedListProps>,
     Pick<OrderedListProps$1, 'id'> {
@@ -7486,11 +8013,18 @@ export interface OrderedListJSXProps
   children?: ComponentChildren;
 }
 
+/**
+ * @publicDocs
+ */
 export interface PageProps
   extends Required<Pick<PageProps$1, 'inlineSize' | 'heading'>> {
   inlineSize: Extract<PageProps$1['inlineSize'], 'base' | 'large' | 'small'>;
 }
 
+/**
+ * Configure the following properties on the page component.
+ * @publicDocs
+ */
 declare class Page extends PreactCustomElement implements PageProps {
   accessor inlineSize: PageProps['inlineSize'];
   accessor heading: PageProps['heading'];
@@ -7518,6 +8052,9 @@ declare module 'preact' {
 }
 
 declare const tagName$s = 's-page';
+/**
+ * @publicDocs
+ */
 export interface PageJSXProps
   extends Partial<PageProps>,
     Pick<PageProps$1, 'id' | 'children'> {
@@ -7552,6 +8089,9 @@ export interface PageJSXProps
   breadcrumbActions?: ComponentChildren;
 }
 
+/**
+ * @publicDocs
+ */
 export interface ParagraphProps
   extends Required<
     Pick<
@@ -7580,6 +8120,10 @@ export interface ParagraphProps
   color: Extract<ParagraphProps$1['color'], 'base' | 'subdued'>;
 }
 
+/**
+ * Configure the following properties on the paragraph component.
+ * @publicDocs
+ */
 declare class Paragraph extends PreactCustomElement implements ParagraphProps {
   accessor fontVariantNumeric: ParagraphProps['fontVariantNumeric'];
   accessor lineClamp: ParagraphProps['lineClamp'];
@@ -7614,6 +8158,9 @@ declare module 'preact' {
 }
 
 declare const tagName$r = 's-paragraph';
+/**
+ * @publicDocs
+ */
 export interface ParagraphJSXProps
   extends Partial<ParagraphProps>,
     Pick<ParagraphProps$1, 'id' | 'children'> {
@@ -7649,6 +8196,10 @@ export type PasswordFieldProps = PreactFieldProps<
     >
   >;
 
+/**
+ * Configure the following properties on the password field component.
+ * @publicDocs
+ */
 declare class PasswordField
   extends PreactFieldElement<PasswordFieldProps['autocomplete']>
   implements PasswordFieldProps
@@ -7677,11 +8228,17 @@ declare module 'preact' {
 }
 
 declare const tagName$q = 's-password-field';
+/**
+ * @publicDocs
+ */
 export interface PasswordFieldJSXProps
   extends Partial<PasswordFieldProps>,
     Pick<PasswordFieldProps$1, 'id'>,
     FieldReactProps<typeof tagName$q> {}
 
+/**
+ * @publicDocs
+ */
 export interface PopoverProps
   extends Required<
     Pick<
@@ -7708,6 +8265,10 @@ declare class PreactPopoverElement<TTagName extends keyof HTMLElementTagNameMap>
   accessor maxInlineSize: BoxProps['maxInlineSize'];
 }
 
+/**
+ * Configure the following properties on the popover component.
+ * @publicDocs
+ */
 declare class Popover
   extends PreactPopoverElement<typeof tagName$p>
   implements PopoverProps
@@ -7729,6 +8290,9 @@ declare module 'preact' {
 }
 
 declare const tagName$p = 's-popover';
+/**
+ * @publicDocs
+ */
 export interface PopoverJSXProps
   extends Partial<PopoverProps>,
     Pick<PopoverProps$1, 'id' | 'children'> {
@@ -7762,9 +8326,16 @@ export interface PopoverJSXProps
   onAfterToggle?: (event: CallbackToggleEvent<typeof tagName$p>) => void | null;
 }
 
+/**
+ * @publicDocs
+ */
 export interface QueryContainerProps
   extends Required<Pick<QueryContainerProps$1, 'id' | 'containerName'>> {}
 
+/**
+ * Configure the following properties on the query container component.
+ * @publicDocs
+ */
 declare class QueryContainer
   extends PreactCustomElement
   implements QueryContainerProps
@@ -7789,6 +8360,9 @@ declare module 'preact' {
 }
 
 declare const tagName$o = 's-query-container';
+/**
+ * @publicDocs
+ */
 export interface QueryContainerJSXProps
   extends Partial<QueryContainerProps$1>,
     Pick<QueryContainerProps$1, 'id' | 'children'> {
@@ -7827,6 +8401,10 @@ export type SearchFieldProps = PreactFieldProps<
     >
   >;
 
+/**
+ * Configure the following properties on the search field component.
+ * @publicDocs
+ */
 declare class SearchField
   extends PreactFieldElement<SearchFieldProps['autocomplete']>
   implements SearchFieldProps
@@ -7854,6 +8432,9 @@ declare module 'preact' {
 }
 
 declare const tagName$n = 's-search-field';
+/**
+ * @publicDocs
+ */
 export interface SearchFieldJSXProps
   extends Partial<SearchFieldProps>,
     Pick<TextFieldProps$1, 'id'>,
@@ -7863,6 +8444,9 @@ export interface SearchFieldJSXProps
  * Represents the section component props with all properties marked as required.
  */
 export type RequiredSectionProps = Required<SectionProps$1>;
+/**
+ * @publicDocs
+ */
 export interface SectionProps
   extends Pick<
     RequiredSectionProps,
@@ -7873,6 +8457,10 @@ export interface SectionProps
   padding: RequiredSectionProps['padding'];
 }
 
+/**
+ * Configure the following properties on the section component.
+ * @publicDocs
+ */
 declare class Section extends PreactCustomElement implements SectionProps {
   constructor();
   /** @private */
@@ -7896,6 +8484,9 @@ declare module 'preact' {
 }
 
 declare const tagName$m = 's-section';
+/**
+ * @publicDocs
+ */
 export interface SectionJSXProps
   extends Partial<SectionProps>,
     Pick<SectionProps$1, 'id' | 'children'> {
@@ -7905,6 +8496,9 @@ export interface SectionJSXProps
   children?: ComponentChildren;
 }
 
+/**
+ * @publicDocs
+ */
 export interface SelectProps
   extends Omit<PreactInputProps, 'value'>,
     Required<
@@ -7928,6 +8522,10 @@ export interface SelectProps
 declare const usedFirstOptionSymbol: unique symbol;
 declare const hasInitialValueSymbol: unique symbol;
 
+/**
+ * Configure the following properties on the select component.
+ * @publicDocs
+ */
 declare class Select extends PreactInputElement implements SelectProps {
   accessor icon: SelectProps['icon'];
   accessor details: SelectProps['details'];
@@ -7977,6 +8575,9 @@ declare module 'preact' {
 }
 
 declare const tagName$l = 's-select';
+/**
+ * @publicDocs
+ */
 export interface SelectJSXProps
   extends Partial<SelectProps>,
     Pick<SelectProps$1, 'id' | 'children'> {
@@ -7990,6 +8591,9 @@ export interface SelectJSXProps
   onFocus?: (event: CallbackEvent<typeof tagName$l>) => void;
 }
 
+/**
+ * @publicDocs
+ */
 export interface SpinnerProps
   extends Required<Pick<SpinnerProps$1, 'accessibilityLabel'>> {
   /**
@@ -8002,6 +8606,10 @@ export interface SpinnerProps
   size: Extract<SpinnerProps$1['size'], 'large' | 'large-100' | 'base'>;
 }
 
+/**
+ * Configure the following properties on the spinner component.
+ * @publicDocs
+ */
 declare class Spinner extends PreactCustomElement implements SpinnerProps {
   accessor accessibilityLabel: string;
   accessor size: SpinnerProps['size'];
@@ -8021,6 +8629,9 @@ declare module 'preact' {
 }
 
 declare const tagName$k = 's-spinner';
+/**
+ * @publicDocs
+ */
 export interface SpinnerJSXProps
   extends Partial<SpinnerProps>,
     Pick<SpinnerProps$1, 'id'> {}
@@ -8038,6 +8649,9 @@ export type ResponsiveStackProps = MakeResponsivePick<
   AlignedStackProps,
   'gap' | 'rowGap' | 'columnGap' | 'direction'
 >;
+/**
+ * @publicDocs
+ */
 export interface StackProps
   extends BoxProps,
     Pick<
@@ -8113,6 +8727,10 @@ export interface StackProps
   direction: ResponsiveStackProps['direction'];
 }
 
+/**
+ * Configure the following properties on the stack component.
+ * @publicDocs
+ */
 declare class Stack extends BoxElement implements StackProps {
   constructor();
   accessor direction: StackProps['direction'];
@@ -8137,6 +8755,9 @@ declare module 'preact' {
 }
 
 declare const tagName$j = 's-stack';
+/**
+ * @publicDocs
+ */
 export interface StackJSXProps
   extends Partial<StackProps>,
     Pick<StackProps$1, 'id' | 'children'> {
@@ -8146,10 +8767,17 @@ export interface StackJSXProps
   children?: ComponentChildren;
 }
 
+/**
+ * @publicDocs
+ */
 export interface SwitchProps
   extends PreactCheckboxProps,
     Required<Pick<SwitchProps$1, 'labelAccessibilityVisibility'>> {}
 
+/**
+ * Configure the following properties on the switch component.
+ * @publicDocs
+ */
 declare class Switch extends PreactCheckboxElement implements SwitchProps {
   accessor labelAccessibilityVisibility: SwitchProps['labelAccessibilityVisibility'];
   constructor();
@@ -8168,6 +8796,9 @@ declare module 'preact' {
 }
 
 declare const tagName$i = 's-switch';
+/**
+ * @publicDocs
+ */
 export interface SwitchJSXProps
   extends Partial<SwitchProps>,
     Pick<SwitchProps$1, 'id'> {
@@ -8181,6 +8812,9 @@ export interface SwitchJSXProps
   onInput?: ((event: CallbackEvent<typeof tagName$i>) => void) | null;
 }
 
+/**
+ * @publicDocs
+ */
 export interface TableProps
   extends Required<
     Pick<
@@ -8203,6 +8837,12 @@ export type HeaderFormat = Extract<
   TableHeaderProps$1['format'],
   'base' | 'currency' | 'numeric'
 >;
+/**
+ * The table header component represents a single column header within a table header row. Use table header as a child of table header row to define column headings and optionally enable column sorting.
+ *
+ * Table header provides semantic meaning for screen readers and can include sorting controls when configured. Each header corresponds to a column in the table body.
+ * @publicDocs
+ */
 export interface TableHeaderProps
   extends Pick<TableHeaderProps$1, 'listSlot' | 'format'> {
   listSlot: Extract<
@@ -8221,6 +8861,10 @@ declare const tableHeadersSharedDataSymbol: unique symbol;
  */
 export type ActualTableVariant = 'table' | 'list';
 
+/**
+ * Configure the following properties on the table component.
+ * @publicDocs
+ */
 declare class Table extends PreactCustomElement implements TableProps {
   accessor variant: TableProps['variant'];
   accessor loading: TableProps['loading'];
@@ -8258,6 +8902,9 @@ declare module 'preact' {
 }
 
 declare const tagName$h = 's-table';
+/**
+ * @publicDocs
+ */
 export interface TableJSXProps
   extends Partial<TableProps>,
     Pick<TableProps$1, 'id' | 'children' | 'onNextPage' | 'onPreviousPage'> {
@@ -8271,8 +8918,20 @@ export interface TableJSXProps
   filters?: ComponentChildren;
 }
 
+/**
+ * The table body component represents the main content area of a table, containing the data rows. Use table body as a child of table to structure your table data, with each table row within the body representing a single record or entry.
+ *
+ * Table body must contain table row components, which in turn contain table cell components for the actual data values.
+ * @publicDocs
+ */
 export interface TableBodyProps extends TableBodyProps$1 {}
 
+/**
+ * The table body component represents the main content area of a table, containing the data rows. Use table body as a child of table to structure your table data, with each table row within the body representing a single record or entry.
+ *
+ * Table body must contain table row components, which in turn contain table cell components for the actual data values.
+ * @publicDocs
+ */
 declare class TableBody extends PreactCustomElement implements TableBodyProps {
   constructor();
 }
@@ -8291,6 +8950,9 @@ declare module 'preact' {
 }
 
 declare const tagName$g = 's-table-body';
+/**
+ * @publicDocs
+ */
 export interface TableBodyJSXProps
   extends Partial<TableBodyProps>,
     Pick<TableBodyProps$1, 'id' | 'children'> {
@@ -8301,10 +8963,22 @@ export interface TableBodyJSXProps
   children?: ComponentChildren;
 }
 
+/**
+ * The table cell component represents a single data cell within a table row. Use table cell as a child of table row to display individual data values, with each cell corresponding to a column in the table.
+ *
+ * Table cell automatically inherits styling and alignment from its parent table structure and supports text content or other inline components.
+ * @publicDocs
+ */
 export interface TableCellProps extends TableCellProps$1 {}
 
 declare const headerFormatSymbol: unique symbol;
 
+/**
+ * The table cell component represents a single data cell within a table row. Use table cell as a child of table row to display individual data values, with each cell corresponding to a column in the table.
+ *
+ * Table cell automatically inherits styling and alignment from its parent table structure and supports text content or other inline components.
+ * @publicDocs
+ */
 declare class TableCell extends PreactCustomElement implements TableCellProps {
   constructor();
   /** @private */
@@ -8327,6 +9001,9 @@ declare module 'preact' {
 }
 
 declare const tagName$f = 's-table-cell';
+/**
+ * @publicDocs
+ */
 export interface TableCellJSXProps
   extends Partial<TableCellProps>,
     Pick<TableCellProps$1, 'id' | 'children'> {
@@ -8336,6 +9013,12 @@ export interface TableCellJSXProps
   children?: ComponentChildren;
 }
 
+/**
+ * The table header component represents a single column header within a table header row. Use table header as a child of table header row to define column headings and optionally enable column sorting.
+ *
+ * Table header provides semantic meaning for screen readers and can include sorting controls when configured. Each header corresponds to a column in the table body.
+ * @publicDocs
+ */
 declare class TableHeader
   extends PreactCustomElement
   implements TableHeaderProps
@@ -8359,6 +9042,9 @@ declare module 'preact' {
 }
 
 declare const tagName$e = 's-table-header';
+/**
+ * @publicDocs
+ */
 export interface TableHeaderJSXProps
   extends Partial<TableHeaderProps>,
     Pick<TableHeaderProps$1, 'id' | 'children'> {
@@ -8368,8 +9054,20 @@ export interface TableHeaderJSXProps
   children?: ComponentChildren;
 }
 
+/**
+ * The table header row component represents the header row of a table, containing column headings. Use table header row as the first child of table (before table body) to define the table structure and provide column labels.
+ *
+ * Table header row must contain table header components for each column. These headers provide context for the data columns and can support sorting functionality.
+ * @publicDocs
+ */
 export interface TableHeaderRowProps extends TableHeaderRowProps$1 {}
 
+/**
+ * The table header row component represents the header row of a table, containing column headings. Use table header row as the first child of table (before table body) to define the table structure and provide column labels.
+ *
+ * Table header row must contain table header components for each column. These headers provide context for the data columns and can support sorting functionality.
+ * @publicDocs
+ */
 declare class TableHeaderRow
   extends PreactCustomElement
   implements TableHeaderRowProps
@@ -8395,6 +9093,9 @@ declare module 'preact' {
 }
 
 declare const tagName$d = 's-table-header-row';
+/**
+ * @publicDocs
+ */
 export interface TableHeaderRowJSXProps
   extends Partial<TableHeaderRowProps>,
     Pick<TableHeaderRowProps$1, 'id' | 'children'> {
@@ -8405,9 +9106,21 @@ export interface TableHeaderRowJSXProps
   children?: ComponentChildren;
 }
 
+/**
+ * The table row component represents a single row of data within a table body. Use table row as a child of table body to structure individual records or entries in the table.
+ *
+ * Table row must contain table cell components, with each cell representing a data value for the corresponding column. The number of cells should match the number of headers in the table.
+ * @publicDocs
+ */
 export interface TableRowProps
   extends Pick<TableRowProps$1, 'children' | 'clickDelegate'> {}
 
+/**
+ * The table row component represents a single row of data within a table body. Use table row as a child of table body to structure individual records or entries in the table.
+ *
+ * Table row must contain table cell components, with each cell representing a data value for the corresponding column. The number of cells should match the number of headers in the table.
+ * @publicDocs
+ */
 declare class TableRow extends PreactCustomElement implements TableRowProps {
   constructor();
   accessor clickDelegate: string;
@@ -8427,6 +9140,9 @@ declare module 'preact' {
 }
 
 declare const tagName$c = 's-table-row';
+/**
+ * @publicDocs
+ */
 export interface TableRowJSXProps
   extends Partial<TableRowProps>,
     Pick<TableRowProps$1, 'id' | 'children'> {
@@ -8437,6 +9153,9 @@ export interface TableRowJSXProps
   children?: ComponentChildren;
 }
 
+/**
+ * @publicDocs
+ */
 export interface TextProps
   extends Required<
     Pick<
@@ -8490,6 +9209,10 @@ export interface TextProps
   >;
 }
 
+/**
+ * Configure the following properties on the text component.
+ * @publicDocs
+ */
 declare class Text extends PreactCustomElement implements TextProps {
   accessor fontVariantNumeric: TextProps['fontVariantNumeric'];
   accessor color: TextProps['color'];
@@ -8533,6 +9256,9 @@ declare module 'preact' {
 }
 
 declare const tagName$b = 's-text';
+/**
+ * @publicDocs
+ */
 export interface TextJSXProps
   extends Partial<TextProps>,
     Pick<TextProps$1, 'id' | 'children'> {
@@ -8551,6 +9277,10 @@ export type TextAreaProps = PreactFieldProps<
 > &
   Required<Pick<TextAreaProps$1, 'maxLength' | 'minLength' | 'rows'>>;
 
+/**
+ * Configure the following properties on the text area component.
+ * @publicDocs
+ */
 declare class TextArea
   extends PreactFieldElement<TextAreaProps['autocomplete']>
   implements TextAreaProps
@@ -8579,6 +9309,9 @@ declare module 'preact' {
 }
 
 declare const tagName$a = 's-text-area';
+/**
+ * @publicDocs
+ */
 export interface TextAreaJSXProps
   extends Partial<TextAreaProps>,
     Pick<TextAreaProps$1, 'id'>,
@@ -8599,6 +9332,10 @@ export type TextFieldProps = PreactFieldProps<
     >
   >;
 
+/**
+ * Configure the following properties on the text field component.
+ * @publicDocs
+ */
 declare class TextField
   extends PreactFieldElement<TextFieldProps['autocomplete']>
   implements TextFieldProps
@@ -8630,6 +9367,9 @@ declare module 'preact' {
 }
 
 declare const tagName$9 = 's-text-field';
+/**
+ * @publicDocs
+ */
 export interface TextFieldJSXProps
   extends Partial<Omit<TextFieldProps, 'accessory'>>,
     Pick<TextFieldProps$1, 'id'>,
@@ -8640,6 +9380,9 @@ export interface TextFieldJSXProps
   accessory?: ComponentChildren;
 }
 
+/**
+ * @publicDocs
+ */
 export interface ThumbnailProps
   extends Required<Pick<ThumbnailProps$1, 'src' | 'alt' | 'size'>> {
   /**
@@ -8658,6 +9401,10 @@ export interface ThumbnailProps
   >;
 }
 
+/**
+ * Configure the following properties on the thumbnail component.
+ * @publicDocs
+ */
 declare class Thumbnail extends PreactCustomElement implements ThumbnailProps {
   accessor src: ThumbnailProps['src'];
   accessor alt: ThumbnailProps['alt'];
@@ -8678,6 +9425,9 @@ declare module 'preact' {
 }
 
 declare const tagName$8 = 's-thumbnail';
+/**
+ * @publicDocs
+ */
 export interface ThumbnailJSXProps
   extends Partial<ThumbnailProps>,
     Pick<ThumbnailProps$1, 'id'> {
@@ -8691,8 +9441,15 @@ export interface ThumbnailJSXProps
   onError?: ((event: CallbackEvent<typeof tagName$8>) => void) | null;
 }
 
+/**
+ * @publicDocs
+ */
 export interface TooltipProps extends Required<Pick<TooltipProps$1, 'id'>> {}
 
+/**
+ * Configure the following properties on the tooltip component.
+ * @publicDocs
+ */
 declare class Tooltip extends PreactOverlayElement implements TooltipProps {
   constructor();
 }
@@ -8711,6 +9468,9 @@ declare module 'preact' {
 }
 
 declare const tagName$7 = 's-tooltip';
+/**
+ * @publicDocs
+ */
 export interface TooltipJSXProps
   extends Partial<TooltipProps>,
     Pick<TooltipProps$1, 'id' | 'children'> {
@@ -8731,6 +9491,10 @@ export type URLFieldProps = PreactFieldProps<
 > &
   Required<Pick<URLFieldProps$1, 'maxLength' | 'minLength'>>;
 
+/**
+ * Configure the following properties on the URL field component.
+ * @publicDocs
+ */
 declare class URLField
   extends PreactFieldElement<URLFieldProps['autocomplete']>
   implements URLFieldProps
@@ -8759,13 +9523,23 @@ declare module 'preact' {
 }
 
 declare const tagName$6 = 's-url-field';
+/**
+ * @publicDocs
+ */
 export interface URLFieldJSXProps
   extends Partial<Omit<URLFieldProps, 'accessory'>>,
     Pick<URLFieldProps$1, 'id'>,
     FieldReactProps<typeof tagName$6> {}
 
+/**
+ * @publicDocs
+ */
 export interface UnorderedListProps extends UnorderedListProps$1 {}
 
+/**
+ * Configure the following properties on the unordered list component.
+ * @publicDocs
+ */
 declare class UnorderedList
   extends PreactCustomElement
   implements UnorderedListProps
@@ -8787,6 +9561,9 @@ declare module 'preact' {
 }
 
 declare const tagName$5 = 's-unordered-list';
+/**
+ * @publicDocs
+ */
 export interface UnorderedListJSXProps
   extends Partial<UnorderedListProps>,
     Pick<UnorderedListProps$1, 'id'> {
@@ -8796,10 +9573,17 @@ export interface UnorderedListJSXProps
   children?: ComponentChildren;
 }
 
+/**
+ * Configure the following properties on the admin action component.
+ * @publicDocs
+ */
 export interface AdminActionProps
   extends Pick<AdminActionProps$1, 'heading' | 'loading'> {}
 
 declare const tagName$4 = 's-admin-action';
+/**
+ * @publicDocs
+ */
 export interface AdminActionJSXProps
   extends Partial<AdminActionProps>,
     Pick<AdminActionProps$1, 'id'> {
@@ -8815,6 +9599,10 @@ export interface AdminActionJSXProps
   secondaryActions: ComponentChildren;
 }
 
+/**
+ * Configure the following properties on the admin action component.
+ * @publicDocs
+ */
 declare class AdminAction
   extends PreactCustomElement
   implements AdminActionProps
@@ -8848,14 +9636,25 @@ declare module 'preact' {
   }
 }
 
+/**
+ * Configure the following properties on the admin block component.
+ * @publicDocs
+ */
 export interface AdminBlockProps
   extends Pick<AdminBlockProps$1, 'heading' | 'collapsedSummary'> {}
 
 declare const tagName$3 = 's-admin-block';
+/**
+ * @publicDocs
+ */
 export interface AdminBlockJSXProps
   extends Partial<AdminBlockProps>,
     Pick<AdminBlockProps$1, 'id'> {}
 
+/**
+ * Configure the following properties on the admin block component.
+ * @publicDocs
+ */
 declare class AdminBlock
   extends PreactCustomElement
   implements AdminBlockProps
@@ -8885,14 +9684,25 @@ declare module 'preact' {
   }
 }
 
+/**
+ * Configure the following properties on the admin print action component.
+ * @publicDocs
+ */
 export interface AdminPrintActionProps
   extends Pick<AdminPrintActionProps$1, 'src'> {}
 
 declare const tagName$2 = 's-admin-print-action';
+/**
+ * @publicDocs
+ */
 export interface AdminPrintActionJSXProps
   extends Partial<AdminPrintActionProps>,
     Pick<AdminPrintActionProps$1, 'id'> {}
 
+/**
+ * Configure the following properties on the admin print action component.
+ * @publicDocs
+ */
 declare class AdminPrintAction
   extends PreactCustomElement
   implements AdminPrintActionProps
@@ -8920,9 +9730,15 @@ declare module 'preact' {
   }
 }
 
+/**
+ * @publicDocs
+ */
 export interface FormProps extends Pick<FormProps$1, 'id'> {}
 
 declare const tagName$1 = 's-form';
+/**
+ * @publicDocs
+ */
 export interface FormJSXProps extends Partial<FormProps> {
   /**
    * A callback that is run when the form is submitted.
@@ -8936,6 +9752,10 @@ export interface FormJSXProps extends Partial<FormProps> {
   onReset?: ((event: CallbackEvent<typeof tagName$1>) => void) | null;
 }
 
+/**
+ * Configure the following properties on the form component.
+ * @publicDocs
+ */
 declare class Form extends PreactCustomElement implements FormProps {
   constructor();
 }
@@ -8954,10 +9774,16 @@ declare module 'preact' {
   }
 }
 
+/**
+ * @publicDocs
+ */
 export interface FunctionSettingsProps
   extends Pick<FunctionSettingsProps$1, 'id'> {}
 
 declare const tagName = 's-function-settings';
+/**
+ * @publicDocs
+ */
 export interface FunctionSettingsJSXProps
   extends Partial<
     FunctionSettingsProps & Pick<FunctionSettingsProps$1, 'onError'>
@@ -8984,6 +9810,10 @@ export interface FunctionSettingsJSXProps
 export type FunctionSettingsErrorEvent = Parameters<
   NonNullable<FunctionSettingsProps$1['onError']>
 >[0];
+/**
+ * Configure the following properties on the function settings component.
+ * @publicDocs
+ */
 declare class FunctionSettings
   extends PreactCustomElement
   implements FunctionSettingsProps
@@ -9134,6 +9964,10 @@ export type {
   UnorderedListJSXProps,
 };
 
+/**
+ * The avatar component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface AvatarEvents {
   /**
    * A callback fired when the avatar image successfully loads.
@@ -9149,6 +9983,10 @@ export interface AvatarEvents {
   error: OnErrorEventHandler = null;
 }
 
+/**
+ * The badge component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface BadgeSlots {
   /**
    * The text label displayed within the badge component, typically a short status indicator or category label.
@@ -9156,6 +9994,10 @@ export interface BadgeSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The banner component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface BannerEvents {
   /**
    * A callback fired when the banner is dismissed.
@@ -9167,6 +10009,10 @@ export interface BannerEvents {
   afterhide: CallbackEventListener<typeof tagName> | null = null;
 }
 
+/**
+ * The banner component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface BannerSlots {
   /**
    * The main message content displayed within the banner component, providing important information or guidance to users.
@@ -9179,6 +10025,10 @@ export interface BannerSlots {
   'secondary-actions'?: HTMLElement;
 }
 
+/**
+ * The box component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface BoxSlots {
   /**
    * The content displayed within the box component, which serves as a flexible container for organizing and styling other components.
@@ -9186,6 +10036,10 @@ export interface BoxSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The button component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface ButtonEvents {
   /**
    * A callback fired when the button is clicked.
@@ -9207,6 +10061,10 @@ export interface ButtonEvents {
   focus: CallbackEventListener<typeof tagName> | null = null;
 }
 
+/**
+ * The button component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface ButtonSlots {
   /**
    * The label text or elements displayed inside the button component, describing the action that will be performed when clicked.
@@ -9214,6 +10072,10 @@ export interface ButtonSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The button group component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface ButtonGroupSlots {
   /**
    * The buttons displayed within the button group component, which are arranged together as a cohesive set of related actions.
@@ -9235,6 +10097,10 @@ export interface ButtonGroupSlots {
   'secondary-actions'?: HTMLElement;
 }
 
+/**
+ * The checkbox component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface CheckboxEvents {
   /**
    * A callback fired when the checkbox value changes.
@@ -9250,6 +10116,10 @@ export interface CheckboxEvents {
   input: CallbackEventListener<'input'>;
 }
 
+/**
+ * The chip component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface ChipSlots {
   /**
    * The text label displayed within the chip component, typically representing a selected filter, tag, or removable item.
@@ -9261,6 +10131,10 @@ export interface ChipSlots {
   graphic?: HTMLElement;
 }
 
+/**
+ * The choice component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface ChoiceSlots {
   /**
    * The label text or elements that identify this selectable choice to users.
@@ -9281,6 +10155,10 @@ export interface ChoiceSlots {
   details?: HTMLElement;
 }
 
+/**
+ * The choice list component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface ChoiceListEvents {
   /**
    * A callback fired when the choice list selection changes.
@@ -9296,6 +10174,10 @@ export interface ChoiceListEvents {
   input: CallbackEventListener<typeof tagName> | null = null;
 }
 
+/**
+ * The choice list component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface ChoiceListSlots {
   /**
    * The choices a user can select from.
@@ -9305,6 +10187,10 @@ export interface ChoiceListSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The clickable component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface ClickableEvents {
   /**
    * A callback fired when the component is clicked.
@@ -9326,6 +10212,10 @@ export interface ClickableEvents {
   focus: CallbackEventListener<typeof tagName> | null = null;
 }
 
+/**
+ * The clickable component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface ClickableSlots {
   /**
    * The content displayed within the clickable component, which makes any content interactive and clickable without the semantic meaning of a button or link.
@@ -9333,6 +10223,10 @@ export interface ClickableSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The clickable chip component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface ClickableChipEvents {
   /**
    * A callback fired when the chip is clicked.
@@ -9350,6 +10244,10 @@ export interface ClickableChipEvents {
   afterhide: CallbackEventListener<typeof tagName> | null = null;
 }
 
+/**
+ * The clickable chip component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface ClickableChipSlots {
   /**
    * The text label displayed within the chip, which represents an interactive filter, tag, or selectable item.
@@ -9361,6 +10259,10 @@ export interface ClickableChipSlots {
   graphic?: HTMLElement;
 }
 
+/**
+ * The color field component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface ColorFieldEvents {
   /**
    * A callback fired when the color field value changes.
@@ -9388,6 +10290,10 @@ export interface ColorFieldEvents {
   focus: CallbackEventListener<'input'>;
 }
 
+/**
+ * The color picker component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface ColorPickerEvents {
   /**
    * A callback fired when the color picker value changes.
@@ -9403,6 +10309,10 @@ export interface ColorPickerEvents {
   input: CallbackEventListener<typeof tagName> | null = null;
 }
 
+/**
+ * The date field component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface DateFieldEvents {
   /**
    * A callback fired when the date field value changes.
@@ -9440,6 +10350,10 @@ export interface DateFieldEvents {
   invalid: CallbackEventListener<typeof tagName> | null = null;
 }
 
+/**
+ * The date picker component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface DatePickerEvents {
   /**
    * A callback fired when the calendar view changes, such as when navigating between months.
@@ -9471,6 +10385,10 @@ export interface DatePickerEvents {
   change: CallbackEventListener<typeof tagName> | null = null;
 }
 
+/**
+ * The drop zone component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface DropZoneEvents {
   /**
    * A callback fired when the drop zone value changes.
@@ -9490,6 +10408,10 @@ export interface DropZoneEvents {
   droprejected: CallbackEventListener<typeof tagName> = null;
 }
 
+/**
+ * The drop zone component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface DropZoneSlots {
   /**
    * The content to include inside the drop zone container
@@ -9497,6 +10419,10 @@ export interface DropZoneSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The email field component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface EmailFieldEvents {
   /**
    * A callback fired when the email field value changes.
@@ -9524,6 +10450,10 @@ export interface EmailFieldEvents {
   focus: CallbackEventListener<'input'>;
 }
 
+/**
+ * The grid component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface GridSlots {
   /**
    * The child elements displayed within the grid component, which are arranged in a flexible grid layout with configurable columns, rows, and spacing.
@@ -9531,6 +10461,10 @@ export interface GridSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The grid item component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface GridItemSlots {
   /**
    * The content displayed within the grid item component, which represents a single cell in the grid layout and can span multiple columns or rows.
@@ -9538,6 +10472,10 @@ export interface GridItemSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The heading component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface HeadingSlots {
   /**
    * The heading text displayed within the heading component, which provides a title or section header for content.
@@ -9545,6 +10483,10 @@ export interface HeadingSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The image component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface ImageEvents {
   /**
    * A callback fired when the image successfully loads.
@@ -9560,6 +10502,10 @@ export interface ImageEvents {
   error: OnErrorEventHandler = null;
 }
 
+/**
+ * The link component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface LinkEvents {
   /**
    * A callback fired when the link is clicked.
@@ -9569,6 +10515,10 @@ export interface LinkEvents {
   click: CallbackEventListener<typeof tagName> | null = null;
 }
 
+/**
+ * The link component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface LinkSlots {
   /**
    * The text or elements displayed within the link component, which navigates users to a different location when activated.
@@ -9576,6 +10526,10 @@ export interface LinkSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The list item component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface ListItemSlots {
   /**
    * The content displayed within the list item, which represents a single entry in an ordered or unordered list.
@@ -9583,6 +10537,10 @@ export interface ListItemSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The menu component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface MenuSlots {
   /**
    * The items displayed within the menu. Only accepts button and section components. Use button for individual menu actions and section to group related items.
@@ -9590,6 +10548,10 @@ export interface MenuSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The modal component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface ModalEvents {
   /**
    * A callback fired when the modal is hidden.
@@ -9609,6 +10571,10 @@ export interface ModalEvents {
   aftershow: CallbackEventListener<typeof tagName> | null = null;
 }
 
+/**
+ * The modal component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface ModalSlots {
   /**
    * The content displayed within the modal component, typically including form fields, information, or interactive elements.
@@ -9628,6 +10594,10 @@ export interface ModalSlots {
   'secondary-actions'?: HTMLElement;
 }
 
+/**
+ * The money field component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface MoneyFieldEvents {
   /**
    * A callback fired when the money field value changes.
@@ -9655,6 +10625,10 @@ export interface MoneyFieldEvents {
   focus: CallbackEventListener<'input'>;
 }
 
+/**
+ * The number field component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface NumberFieldEvents {
   /**
    * A callback fired when the number field value changes.
@@ -9682,6 +10656,10 @@ export interface NumberFieldEvents {
   focus: CallbackEventListener<'input'>;
 }
 
+/**
+ * The option component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface OptionSlots {
   /**
    * The text or elements displayed as the option label, which identifies the selectable choice to users in a dropdown or selection list.
@@ -9689,6 +10667,10 @@ export interface OptionSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The option group component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface OptionGroupSlots {
   /**
    * The selectable options displayed in the dropdown list. Accepts option components for individual selectable items within this group.
@@ -9696,6 +10678,10 @@ export interface OptionGroupSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The ordered list component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface OrderedListSlots {
   /**
    * The list entries displayed within the ordered list, where each item is numbered sequentially. Only accepts list item components as children. Each list item represents a single numbered entry in the sequence.
@@ -9703,6 +10689,10 @@ export interface OrderedListSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The page component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface PageSlots {
   /**
    * The main page content displayed within the page component, which serves as the primary container for the page's information and interface elements.
@@ -9735,6 +10725,10 @@ export interface PageSlots {
   'breadcrumb-actions'?: HTMLElement;
 }
 
+/**
+ * The paragraph component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface ParagraphSlots {
   /**
    * The paragraph text content displayed within the paragraph component, which presents a block of related text with appropriate styling.
@@ -9742,6 +10736,10 @@ export interface ParagraphSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The password field component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface PasswordFieldEvents {
   /**
    * A callback fired when the password field value changes.
@@ -9769,6 +10767,10 @@ export interface PasswordFieldEvents {
   focus: CallbackEventListener<'input'>;
 }
 
+/**
+ * The popover component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface PopoverEvents {
   /**
    * A callback fired when the popover is shown.
@@ -9796,6 +10798,10 @@ export interface PopoverEvents {
   aftertoggle: CallbackEventListener<TTagName> | null;
 }
 
+/**
+ * The popover component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface PopoverSlots {
   /**
    * The content displayed within the popover component, which appears in an overlay positioned relative to its trigger element.
@@ -9803,6 +10809,10 @@ export interface PopoverSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The query container component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface QueryContainerSlots {
   /**
    * The content displayed within the query container component, which enables container queries for responsive styling based on the container's size rather than the viewport.
@@ -9810,6 +10820,10 @@ export interface QueryContainerSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The search field component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface SearchFieldEvents {
   /**
    * A callback fired when the search field value changes.
@@ -9837,6 +10851,10 @@ export interface SearchFieldEvents {
   focus: CallbackEventListener<'input'>;
 }
 
+/**
+ * The section component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface SectionSlots {
   /**
    * The content displayed within the section component, which groups related elements together in a logical unit with an optional heading.
@@ -9844,6 +10862,10 @@ export interface SectionSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The select component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface SelectEvents {
   /**
    * A callback fired when the select value changes.
@@ -9859,6 +10881,10 @@ export interface SelectEvents {
   input: CallbackEventListener<'input'>;
 }
 
+/**
+ * The select component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface SelectSlots {
   /**
    * The selectable options displayed in the dropdown list. Accepts option components for individual selectable items, and option group components to organize related options into logical groups with labels.
@@ -9866,6 +10892,10 @@ export interface SelectSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The stack component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface StackSlots {
   /**
    * The child elements displayed within the stack component, which are arranged vertically or horizontally with consistent spacing.
@@ -9873,6 +10903,10 @@ export interface StackSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The switch component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface SwitchEvents {
   /**
    * A callback fired when the switch value changes.
@@ -9888,6 +10922,10 @@ export interface SwitchEvents {
   input: CallbackEventListener<'input'>;
 }
 
+/**
+ * The table component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface TableEvents {
   /**
    * A callback fired when the user navigates to the previous page.
@@ -9899,6 +10937,10 @@ export interface TableEvents {
   nextpage: CallbackEventListener<typeof tagName> | null = null;
 }
 
+/**
+ * The table component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface TableSlots {
   /**
    * The table structure defining headers and data rows.
@@ -9914,6 +10956,10 @@ export interface TableSlots {
   filters?: HTMLElement;
 }
 
+/**
+ * The table body component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface TableBodySlots {
   /**
    * The data rows displayed in the table body.
@@ -9923,6 +10969,10 @@ export interface TableBodySlots {
   children?: HTMLElement;
 }
 
+/**
+ * The table cell component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface TableCellSlots {
   /**
    * The data value displayed in this cell.
@@ -9932,6 +10982,10 @@ export interface TableCellSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The table header component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface TableHeaderSlots {
   /**
    * The column heading text.
@@ -9941,6 +10995,10 @@ export interface TableHeaderSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The table header row component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface TableHeaderRowSlots {
   /**
    * The column headers displayed in the table header row.
@@ -9950,6 +11008,10 @@ export interface TableHeaderRowSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The table row component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface TableRowSlots {
   /**
    * The data cells displayed in this table row.
@@ -9959,6 +11021,10 @@ export interface TableRowSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The text component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface TextSlots {
   /**
    * The text content displayed within the text component, which applies semantic meaning and styling appropriate to the specified text type.
@@ -9966,6 +11032,10 @@ export interface TextSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The text area component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface TextAreaEvents {
   /**
    * A callback fired when the text area value changes.
@@ -9993,6 +11063,10 @@ export interface TextAreaEvents {
   focus: CallbackEventListener<'input'>;
 }
 
+/**
+ * The text field component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface TextFieldEvents {
   /**
    * A callback fired when the text field value changes.
@@ -10020,6 +11094,10 @@ export interface TextFieldEvents {
   focus: CallbackEventListener<'input'>;
 }
 
+/**
+ * The text field component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface TextFieldSlots {
   /**
    * Additional interactive content displayed within the text field.
@@ -10029,6 +11107,10 @@ export interface TextFieldSlots {
   accessory?: HTMLElement;
 }
 
+/**
+ * The thumbnail component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface ThumbnailEvents {
   /**
    * A callback fired when the thumbnail image successfully loads.
@@ -10044,6 +11126,10 @@ export interface ThumbnailEvents {
   error: OnErrorEventHandler = null;
 }
 
+/**
+ * The tooltip component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface TooltipSlots {
   /**
    * The informational text or elements displayed within the tooltip overlay, providing helpful context or explanations when users interact with the associated element.
@@ -10053,6 +11139,10 @@ export interface TooltipSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The URL field component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface URLFieldEvents {
   /**
    * A callback fired when the URL field value changes.
@@ -10080,6 +11170,10 @@ export interface URLFieldEvents {
   focus: CallbackEventListener<'input'>;
 }
 
+/**
+ * The unordered list component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface UnorderedListSlots {
   /**
    * The list entries displayed within the unordered list, where each item is marked with a bullet point. Only accepts list item components as children. Each list item represents a single bulleted entry in the list.
@@ -10087,6 +11181,10 @@ export interface UnorderedListSlots {
   children?: HTMLElement;
 }
 
+/**
+ * The admin action component supports slots for additional content placement within the component. Learn more about [using slots](/docs/api/polaris/using-polaris-web-components#slots).
+ * @publicDocs
+ */
 export interface AdminActionSlots {
   /**
    * The main action button or link displayed in the admin action modal.
@@ -10100,6 +11198,10 @@ export interface AdminActionSlots {
   'secondary-actions': HTMLElement;
 }
 
+/**
+ * The form component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface FormEvents {
   /**
    * A callback that is run when the form is submitted.
@@ -10111,6 +11213,10 @@ export interface FormEvents {
   reset: CallbackEventListener<typeof tagName> | null = null;
 }
 
+/**
+ * The function settings component provides event callbacks for handling user interactions. Learn more about [handling events](/docs/api/polaris/using-polaris-web-components#handling-events).
+ * @publicDocs
+ */
 export interface FunctionSettingsEvents {
   /**
    * An optional callback function that will be run by the admin when the user