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

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

@@ -14,6 +14,7 @@ import type {
 
 /**
  * The properties you can set on a table component.
+ * @publicDocs
  */
 export interface TableProps
   extends Required<
@@ -30,6 +31,7 @@ export interface TableProps
 
 /**
  * The format type for a table header, which determines how the cell content is displayed.
+ * @publicDocs
  */
 export type HeaderFormat = Extract<
   TableHeaderProps$1['format'],
@@ -37,6 +39,7 @@ export type HeaderFormat = Extract<
 >;
 /**
  * The properties you can set on a table header component.
+ * @publicDocs
  */
 export interface TableHeaderProps
   extends Pick<TableHeaderProps$1, 'listSlot' | 'format'> {
@@ -55,10 +58,12 @@ export interface TableHeaderProps
 
 /**
  * A string that contains CSS styles to apply to the component.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * The implementation details for rendering a Preact custom element with a shadow root.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -72,6 +77,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * An object that resembles an activation event, containing information about which modifier keys were pressed and which mouse button was used.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -93,6 +99,7 @@ export interface ActivationEventEsque {
 }
 /**
  * The options for customizing how a synthetic click is performed.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -145,6 +152,7 @@ declare abstract class PreactCustomElement extends BaseClass {
 
 /**
  * A context object that provides a default value of a specific type.
+ * @publicDocs
  */
 export interface Context<T> {
   /**
@@ -173,6 +181,7 @@ declare class AddedContext<T> extends EventTarget {
 /**
  * A callback that a context requester provides, which is called with the value that satisfies the request.
  * Context providers can call this callback multiple times as the requested value changes.
+ * @publicDocs
  */
 export type ContextCallback<T> = (value: T) => void;
 /**
@@ -210,11 +219,13 @@ declare const actualTableVariantSymbol: unique symbol;
 declare const tableHeadersSharedDataSymbol: unique symbol;
 /**
  * The actual display variant of the table, which is either a traditional table or a list.
+ * @publicDocs
  */
 export type ActualTableVariant = 'table' | 'list';
 
 /**
  * An event that includes a strongly typed `currentTarget` property based on the element tag name.
+ * @publicDocs
  */
 export type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
   /**
@@ -224,6 +235,7 @@ export type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
 };
 /**
  * An event listener function that receives a strongly typed callback event, or `null` if no listener is attached.
+ * @publicDocs
  */
 export type CallbackEventListener<T extends keyof HTMLElementTagNameMap> =
   | (EventListener & {
@@ -232,6 +244,7 @@ export type CallbackEventListener<T extends keyof HTMLElementTagNameMap> =
   | null;
 /**
  * The base properties for Preact elements that don't have children, providing essential attributes like keys and refs for component management.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -249,6 +262,7 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 }
 /**
  * The base properties for Preact elements that have children, extending the base element properties to include child content.
+ * @publicDocs
  */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
@@ -326,6 +340,7 @@ declare module 'preact' {
 declare const tagName = 's-table';
 /**
  * The JSX properties you can set on a table component.
+ * @publicDocs
  */
 export interface TableJSXProps
   extends Partial<TableProps>,

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

@@ -9,15 +9,18 @@ import type {ComponentChildren, TableBodyProps$1} from './shared.d.ts';
 
 /**
  * The properties you can set on a table body component.
+ * @publicDocs
  */
 export interface TableBodyProps extends TableBodyProps$1 {}
 
 /**
  * A string that contains CSS styles to apply to the component.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * The implementation details for rendering a Preact custom element with a shadow root.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -31,6 +34,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * An object that resembles an activation event, containing information about which modifier keys were pressed and which mouse button was used.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -52,6 +56,7 @@ export interface ActivationEventEsque {
 }
 /**
  * The options for customizing how a synthetic click is performed.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -104,6 +109,7 @@ declare abstract class PreactCustomElement extends BaseClass {
 
 /**
  * The base properties for Preact elements that don't have children, providing essential attributes like keys and refs for component management.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -121,6 +127,7 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 }
 /**
  * The base properties for Preact elements that have children, extending the base element properties to include child content.
+ * @publicDocs
  */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
@@ -156,6 +163,7 @@ declare module 'preact' {
 declare const tagName = 's-table-body';
 /**
  * The JSX properties you can set on a table body component.
+ * @publicDocs
  */
 export interface TableBodyJSXProps
   extends Partial<TableBodyProps>,

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

@@ -13,15 +13,18 @@ import type {
 
 /**
  * The properties you can set on a table cell component.
+ * @publicDocs
  */
 export interface TableCellProps extends TableCellProps$1 {}
 
 /**
  * A string that contains CSS styles to apply to the component.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * The implementation details for rendering a Preact custom element with a shadow root.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -35,6 +38,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * An object that resembles an activation event, containing information about which modifier keys were pressed and which mouse button was used.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -56,6 +60,7 @@ export interface ActivationEventEsque {
 }
 /**
  * The options for customizing how a synthetic click is performed.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -108,6 +113,7 @@ declare abstract class PreactCustomElement extends BaseClass {
 
 /**
  * The base properties for Preact elements that don't have children, providing essential attributes like keys and refs for component management.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -125,6 +131,7 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 }
 /**
  * The base properties for Preact elements that have children, extending the base element properties to include child content.
+ * @publicDocs
  */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
@@ -136,6 +143,7 @@ declare const headerFormatSymbol: unique symbol;
 
 /**
  * The format type for a table header, which determines how the cell content is displayed.
+ * @publicDocs
  */
 export type HeaderFormat = Extract<
   TableHeaderProps['format'],
@@ -175,6 +183,7 @@ declare module 'preact' {
 declare const tagName = 's-table-cell';
 /**
  * The JSX properties you can set on a table cell component.
+ * @publicDocs
  */
 export interface TableCellJSXProps
   extends Partial<TableCellProps>,

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

@@ -10,6 +10,7 @@ import type {ComponentChildren, TableHeaderProps$1} from './shared.d.ts';
 
 /**
  * The format type for a table header, which determines how the cell content is displayed.
+ * @publicDocs
  */
 export type HeaderFormat = Extract<
   TableHeaderProps$1['format'],
@@ -17,6 +18,7 @@ export type HeaderFormat = Extract<
 >;
 /**
  * The properties you can set on a table header component.
+ * @publicDocs
  */
 export interface TableHeaderProps
   extends Pick<TableHeaderProps$1, 'listSlot' | 'format'> {
@@ -35,10 +37,12 @@ export interface TableHeaderProps
 
 /**
  * A string that contains CSS styles to apply to the component.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * The implementation details for rendering a Preact custom element with a shadow root.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -52,6 +56,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * An object that resembles an activation event, containing information about which modifier keys were pressed and which mouse button was used.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -73,6 +78,7 @@ export interface ActivationEventEsque {
 }
 /**
  * The options for customizing how a synthetic click is performed.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -125,6 +131,7 @@ declare abstract class PreactCustomElement extends BaseClass {
 
 /**
  * The base properties for Preact elements that don't have children, providing essential attributes like keys and refs for component management.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -142,6 +149,7 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 }
 /**
  * The base properties for Preact elements that have children, extending the base element properties to include child content.
+ * @publicDocs
  */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
@@ -188,6 +196,7 @@ declare module 'preact' {
 declare const tagName = 's-table-header';
 /**
  * The JSX properties you can set on a table header component.
+ * @publicDocs
  */
 export interface TableHeaderJSXProps
   extends Partial<TableHeaderProps>,

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

@@ -9,15 +9,18 @@ import type {ComponentChildren, TableHeaderRowProps$1} from './shared.d.ts';
 
 /**
  * The properties you can set on a table header row component.
+ * @publicDocs
  */
 export interface TableHeaderRowProps extends TableHeaderRowProps$1 {}
 
 /**
  * A string that contains CSS styles to apply to the component.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * The implementation details for rendering a Preact custom element with a shadow root.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -31,6 +34,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * An object that resembles an activation event, containing information about which modifier keys were pressed and which mouse button was used.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -52,6 +56,7 @@ export interface ActivationEventEsque {
 }
 /**
  * The options for customizing how a synthetic click is performed.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -104,6 +109,7 @@ declare abstract class PreactCustomElement extends BaseClass {
 
 /**
  * The base properties for Preact elements that don't have children, providing essential attributes like keys and refs for component management.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -121,6 +127,7 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 }
 /**
  * The base properties for Preact elements that have children, extending the base element properties to include child content.
+ * @publicDocs
  */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
@@ -163,6 +170,7 @@ declare module 'preact' {
 declare const tagName = 's-table-header-row';
 /**
  * The JSX properties you can set on a table header row component.
+ * @publicDocs
  */
 export interface TableHeaderRowJSXProps
   extends Partial<TableHeaderRowProps>,

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

@@ -9,16 +9,19 @@ import type {ComponentChildren, TableRowProps$1} from './shared.d.ts';
 
 /**
  * The properties you can set on a table row component.
+ * @publicDocs
  */
 export interface TableRowProps
   extends Pick<TableRowProps$1, 'children' | 'clickDelegate'> {}
 
 /**
  * A string that contains CSS styles to apply to the component.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * The implementation details for rendering a Preact custom element with a shadow root.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -32,6 +35,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * An object that resembles an activation event, containing information about which modifier keys were pressed and which mouse button was used.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -53,6 +57,7 @@ export interface ActivationEventEsque {
 }
 /**
  * The options for customizing how a synthetic click is performed.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -105,6 +110,7 @@ declare abstract class PreactCustomElement extends BaseClass {
 
 /**
  * The base properties for Preact elements that don't have children, providing essential attributes like keys and refs for component management.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -122,6 +128,7 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 }
 /**
  * The base properties for Preact elements that have children, extending the base element properties to include child content.
+ * @publicDocs
  */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
@@ -161,6 +168,7 @@ declare module 'preact' {
 declare const tagName = 's-table-row';
 /**
  * The JSX properties you can set on a table row component.
+ * @publicDocs
  */
 export interface TableRowJSXProps
   extends Partial<TableRowProps>,

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

@@ -10,6 +10,11 @@ import type {ComponentChildren, TextProps$1} from './shared.d.ts';
 
 /**
  * The properties for the text component. These properties define inline or small blocks of text content with various visual styles and semantic meanings.
+ * @publicDocs
+ */
+/**
+ * @publicDocs
+ * @publicDocs
  */
 export interface TextProps
   extends Required<
@@ -77,10 +82,14 @@ export interface TextProps
 
 /**
  * A string containing CSS styles.
+ * @publicDocs
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * The configuration for rendering a custom element with a shadow DOM.
+ * @publicDocs
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -95,6 +104,8 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 /**
  * An object that represents the state of modifier keys and mouse button
  * during an activation event like a click.
+ * @publicDocs
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -116,6 +127,8 @@ export interface ActivationEventEsque {
 }
 /**
  * Options for customizing click behavior on an element.
+ * @publicDocs
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -168,6 +181,8 @@ declare abstract class PreactCustomElement extends BaseClass {
 
 /**
  * The base properties for Preact elements that don't have children, providing essential attributes like keys and refs for component management.
+ * @publicDocs
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -185,6 +200,8 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 }
 /**
  * The base properties for Preact elements that have children, extending the base element properties to include child content.
+ * @publicDocs
+ * @publicDocs
  */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
@@ -254,6 +271,8 @@ declare module 'preact' {
 declare const tagName = 's-text';
 /**
  * The JSX properties for the text component. These properties define how text is rendered in Preact or JSX.
+ * @publicDocs
+ * @publicDocs
  */
 export interface TextJSXProps
   extends Partial<TextProps>,

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

@@ -14,6 +14,7 @@ import type {
 
 /**
  * An event with a strongly-typed currentTarget property for a specific HTML element.
+ * @publicDocs
  */
 export type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
   /**
@@ -23,6 +24,7 @@ export type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
 };
 /**
  * A callback function that receives a strongly-typed event for a specific HTML element.
+ * @publicDocs
  */
 export type CallbackEventListener<T extends keyof HTMLElementTagNameMap> =
   | (EventListener & {
@@ -31,6 +33,7 @@ export type CallbackEventListener<T extends keyof HTMLElementTagNameMap> =
   | null;
 /**
  * The React-style event callback props for form field components.
+ * @publicDocs
  */
 export interface FieldReactProps<T extends keyof HTMLElementTagNameMap> {
   /**
@@ -52,6 +55,7 @@ export interface FieldReactProps<T extends keyof HTMLElementTagNameMap> {
 }
 /**
  * The base properties for Preact elements that don't have children, providing essential attributes like keys and refs for component management.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -70,10 +74,12 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 
 /**
  * A string containing CSS styles for the component's shadow DOM.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * The configuration for rendering a Preact component in a shadow root.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -87,6 +93,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * The properties from an event that indicate how the user activated an element.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -108,6 +115,7 @@ export interface ActivationEventEsque {
 }
 /**
  * The options for influencing a programmatic click event.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -161,6 +169,7 @@ declare abstract class PreactCustomElement extends BaseClass {
 declare const internals: unique symbol;
 /**
  * The base properties for an input element that participates in form submission.
+ * @publicDocs
  */
 export type PreactInputProps = Required<
   Pick<TextFieldProps, 'disabled' | 'id' | 'name' | 'value'>
@@ -205,6 +214,7 @@ declare class PreactInputElement
 
 /**
  * The base properties for form field elements that support labels, validation, and autocomplete.
+ * @publicDocs
  */
 export type PreactFieldProps<Autocomplete extends string = string> =
   PreactInputProps &
@@ -325,6 +335,7 @@ declare class PreactFieldElement<Autocomplete extends string = string>
 
 /**
  * The properties for the text area component. These properties configure a multi-line text input field that allows merchants to enter and edit longer text content.
+ * @publicDocs
  */
 export type TextAreaProps = PreactFieldProps<
   Required<TextAreaProps$1>['autocomplete']
@@ -373,6 +384,7 @@ declare module 'preact' {
 declare const tagName = 's-text-area';
 /**
  * The JSX props for the text area component. These properties extend `TextAreaProps` with JSX-specific event callbacks for React-style event handling.
+ * @publicDocs
  */
 export interface TextAreaJSXProps
   extends Partial<TextAreaProps>,

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

@@ -10,6 +10,7 @@ import type {ComponentChildren, TextFieldProps$1} from './shared.d.ts';
 
 /**
  * A callback event with a strongly-typed `currentTarget` property that corresponds to a specific HTML element. This provides better type safety when handling events from custom elements.
+ * @publicDocs
  */
 export type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
   /**
@@ -19,6 +20,7 @@ export type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
 };
 /**
  * An event listener function type for callback events with a strongly-typed `currentTarget`. This ensures the event handler receives the correct element type.
+ * @publicDocs
  */
 export type CallbackEventListener<T extends keyof HTMLElementTagNameMap> =
   | (EventListener & {
@@ -27,6 +29,7 @@ export type CallbackEventListener<T extends keyof HTMLElementTagNameMap> =
   | null;
 /**
  * The JSX-style event callback props for form field components. These properties provide React-like event handling for input, change, focus, and blur events.
+ * @publicDocs
  */
 export interface FieldReactProps<T extends keyof HTMLElementTagNameMap> {
   /**
@@ -48,6 +51,7 @@ export interface FieldReactProps<T extends keyof HTMLElementTagNameMap> {
 }
 /**
  * The base properties for Preact elements without children. Provides `key`, `ref`, and `slot` properties for element identification, DOM access, and slot-based positioning.
+ * @publicDocs
  */
 export interface PreactBaseElementProps<TClass extends HTMLElement> {
   /**
@@ -65,6 +69,7 @@ export interface PreactBaseElementProps<TClass extends HTMLElement> {
 }
 /**
  * The base properties for Preact elements with children. Extends `PreactBaseElementProps` with the ability to render child elements.
+ * @publicDocs
  */
 export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
   extends PreactBaseElementProps<TClass> {
@@ -76,10 +81,12 @@ export interface PreactBaseElementPropsWithChildren<TClass extends HTMLElement>
 
 /**
  * The CSS styles as a string, used for styling web components within their shadow DOM.
+ * @publicDocs
  */
 export type Styles = string;
 /**
  * The implementation configuration for rendering a Preact component into a shadow root. Defines the render function that returns JSX elements and optional CSS styles to apply to the component's shadow DOM.
+ * @publicDocs
  */
 export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
   /**
@@ -93,6 +100,7 @@ export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
 };
 /**
  * The properties of an activation event (such as a click or keyboard press) that describe which modifier keys and mouse buttons were involved. This is used to determine intended behavior like opening links in new tabs when Command/Control is pressed.
+ * @publicDocs
  */
 export interface ActivationEventEsque {
   /**
@@ -114,6 +122,7 @@ export interface ActivationEventEsque {
 }
 /**
  * The options for controlling how a synthetic click behaves. Allows passing modifier key states and button information from an original event to influence link behavior such as opening in new tabs or background tabs.
+ * @publicDocs
  */
 export interface ClickOptions {
   /**
@@ -167,6 +176,7 @@ declare abstract class PreactCustomElement extends BaseClass {
 declare const internals: unique symbol;
 /**
  * The base properties for an input element that participates in form submission. Defines the core properties needed for form integration including identifier, name, value, and disabled state.
+ * @publicDocs
  */
 export type PreactInputProps = Required<
   Pick<TextFieldProps$1, 'disabled' | 'id' | 'name' | 'value'>
@@ -211,6 +221,7 @@ declare class PreactInputElement
 
 /**
  * The base properties for form field elements that support labels, validation, and autocomplete. Extends `PreactInputProps` with additional form field features like labels, placeholders, error messages, and autocomplete hints.
+ * @publicDocs
  */
 export type PreactFieldProps<Autocomplete extends string = string> =
   PreactInputProps &
@@ -321,6 +332,7 @@ declare class PreactFieldElement<Autocomplete extends string = string>
 
 /**
  * The properties for the text field component. Extends `PreactFieldProps` with text-specific features like icons, length constraints, and prefix/suffix content.
+ * @publicDocs
  */
 export type TextFieldProps = PreactFieldProps<
   /** @default 'on' */
@@ -384,6 +396,7 @@ declare module 'preact' {
 declare const tagName = 's-text-field';
 /**
  * The JSX props for the text field component. These properties extend `TextFieldProps` with JSX-specific event callbacks and an accessory slot for rendering additional content at the end of the field.
+ * @publicDocs
  */
 export interface TextFieldJSXProps
   extends Partial<Omit<TextFieldProps, 'accessory'>>,