@shopify/ui-extensions 2026.4.0-rc.2 → 2026.4.0

package/src/surfaces/admin/api/resource-picker/resource-picker.ts

@@ -1,12 +1,14 @@
 /**
  * A monetary value represented as a string (for example, `"19.99"` or `"0.00"`). The format always includes the decimal point and cents, even for whole dollar amounts. Use this type for prices, costs, and other currency values.
+ * @publicDocs
  */
-type Money = string;
+export type Money = string;
 
 /**
  * The sort order that determines how products appear in a collection. This controls the default product arrangement that customers see when viewing the collection on the storefront.
+ * @publicDocs
  */
-enum CollectionSortOrder {
+export enum CollectionSortOrder {
   /** Products arranged in the custom order set by the merchant. Use this when merchants have manually organized products for specific merchandising. */
   Manual = 'MANUAL',
   /** Products sorted by sales volume, with best-sellers first. Use this to highlight popular products. */
@@ -29,8 +31,9 @@ enum CollectionSortOrder {
 
 /**
  * The types of fulfillment services that can handle order fulfillment. This determines how products are delivered to customers.
+ * @publicDocs
  */
-enum FulfillmentServiceType {
+export enum FulfillmentServiceType {
   /** Digital gift card fulfillment with automatic delivery. No physical shipping required. */
   GiftCard = 'GIFT_CARD',
   /** Manual fulfillment handled directly by the merchant. The merchant packs and ships orders themselves. */
@@ -41,8 +44,9 @@ enum FulfillmentServiceType {
 
 /**
  * The unit of measurement for product weight. Use this with the weight value to calculate shipping costs or display product specifications.
+ * @publicDocs
  */
-enum WeightUnit {
+export enum WeightUnit {
   /** Weight measured in kilograms (kg). Commonly used in metric system countries. */
   Kilograms = 'KILOGRAMS',
   /** Weight measured in grams (g). Used for lightweight items in metric system. */
@@ -55,8 +59,9 @@ enum WeightUnit {
 
 /**
  * The inventory policy that determines whether customers can purchase a variant when it's out of stock. Use this to control checkout behavior for low or zero inventory items.
+ * @publicDocs
  */
-enum ProductVariantInventoryPolicy {
+export enum ProductVariantInventoryPolicy {
   /** Prevents purchases when inventory reaches zero. Customers can't add out-of-stock variants to their cart. Use this to avoid overselling. */
   Deny = 'DENY',
   /** Allows purchases even when inventory is zero or negative. Customers can continue buying out-of-stock variants. Use this for backorders or made-to-order products. */
@@ -65,8 +70,9 @@ enum ProductVariantInventoryPolicy {
 
 /**
  * The system responsible for tracking inventory levels for a variant. This determines where stock counts are managed and updated.
+ * @publicDocs
  */
-enum ProductVariantInventoryManagement {
+export enum ProductVariantInventoryManagement {
   /** Inventory tracked and managed by Shopify. Stock levels update through Shopify admin or API. Use this for standard inventory management. */
   Shopify = 'SHOPIFY',
   /** Inventory not tracked. The variant is always considered in stock. Use this for services, digital goods, or custom products with unlimited availability. */
@@ -77,8 +83,9 @@ enum ProductVariantInventoryManagement {
 
 /**
  * The publication status indicating a product's availability state. Use this to filter products or determine which products customers can see and purchase.
+ * @publicDocs
  */
-enum ProductStatus {
+export enum ProductStatus {
   /** The product is published and available for sale on active sales channels. Customers can view and purchase this product. */
   Active = 'ACTIVE',
   /** The product is archived and no longer available. Archived products don't appear on storefronts and can't be purchased. Use this for discontinued items. */
@@ -89,8 +96,9 @@ enum ProductStatus {
 
 /**
  * An image associated with a product, variant, or collection. Use image data to display thumbnails, galleries, or product previews in your extension.
+ * @publicDocs
  */
-interface ResourceImage {
+export interface ResourceImage {
   /** The unique identifier for the image file. Use this ID for image-related GraphQL operations. */
   id: string;
   /** Alternative text describing the image for screen readers and accessibility. This text appears when images fail to load. Use descriptive alt text to make your extension accessible. */
@@ -101,24 +109,27 @@ interface ResourceImage {
 
 /**
  * The base resource structure with a unique identifier.
+ * @publicDocs
  */
-interface Resource {
+export interface Resource {
   /** The resource identifier in GraphQL global ID format (for example, `gid://shopify/Product/123`). */
   id: string;
 }
 
 /**
  * A resource structure that can optionally include associated variants. Use this type for specifying preselected items in the resource picker when you need to include variant selections.
+ * @publicDocs
  */
-interface BaseResource extends Resource {
+export interface BaseResource extends Resource {
   /** An array of variant resources to preselect along with the main resource. Only applicable when the main resource is a product that has variants you want to preselect. */
   variants?: Resource[];
 }
 
 /**
  * A single rule that defines product inclusion criteria for an automated collection. Rules filter products based on their attributes to automatically populate a collection.
+ * @publicDocs
  */
-interface CollectionRule {
+export interface CollectionRule {
   /** The product field to evaluate (for example, `'title'`, `'tag'`, `'vendor'`, or `'product_type'`). This determines which product attribute the rule checks. */
   column: string;
   /** The value to compare against. For example, if checking tags, this might be `'summer'` or `'featured'`. The product attribute must match this condition value according to the relation. */
@@ -129,8 +140,9 @@ interface CollectionRule {
 
 /**
  * A set of rules that determine which products are automatically included in a collection. Use this to understand how an automated collection populates itself with products.
+ * @publicDocs
  */
-interface RuleSet {
+export interface RuleSet {
   /** The logical operator for combining multiple rules. When `true`, products are included if they match ANY rule (OR logic). When `false`, products must match ALL rules (AND logic). Use this to understand the collection's filtering strategy. */
   appliedDisjunctively: boolean;
   /** An array of rules that define product inclusion criteria. Each rule checks a different product attribute. Products are added to the collection based on how these rules are combined (see `appliedDisjunctively`). */
@@ -139,8 +151,9 @@ interface RuleSet {
 
 /**
  * A collection resource selected from the resource picker. Collections are groups of products organized by manual curation or automated rules. Use collection data to access product groupings, organizational information, and collection metadata.
+ * @publicDocs
  */
-interface Collection extends Resource {
+export interface Collection extends Resource {
   /** The number of sales channels where this collection can be published. Use this to understand the collection's potential reach across different storefronts. */
   availablePublicationCount: number;
   /** The collection description as plain text without HTML formatting. Use this when you need the description without markup. */
@@ -184,8 +197,9 @@ interface Collection extends Resource {
 
 /**
  * A product variant resource selected from the resource picker. Product variants represent specific combinations of product options (for example, a t-shirt in size Medium and color Blue). Use variant data to access pricing, inventory, and option-specific information.
+ * @publicDocs
  */
-interface ProductVariant extends Resource {
+export interface ProductVariant extends Resource {
   /** Whether the variant is currently available for purchase. When `false`, the variant can't be added to orders even if inventory exists. Use this to check if customers can buy this variant. */
   availableForSale: boolean;
   /** The barcode, UPC, or ISBN number for the variant. Use this to scan products, integrate with inventory systems, or match physical products to Shopify data. */
@@ -245,8 +259,9 @@ interface ProductVariant extends Resource {
 
 /**
  * A product resource selected from the resource picker. Products are the items sold in a Shopify store and can have multiple variants representing different options (like size or color). Use product data to access titles, descriptions, images, pricing, and variant information.
+ * @publicDocs
  */
-interface Product extends Resource {
+export interface Product extends Resource {
   /** The number of sales channels where this product can be published. Use this to understand the product's potential reach across different storefronts. */
   availablePublicationCount: number;
   /** ISO 8601 timestamp when the product was first created in the catalog. Use this to track product age or sort by creation date. */
@@ -323,15 +338,17 @@ type WithSelection<T> = T & {
 
 /**
  * The payload returned when resources are selected from the picker.
+ * @publicDocs
  */
-type SelectPayload<Type extends keyof ResourceTypes> = WithSelection<
+export type SelectPayload<Type extends keyof ResourceTypes> = WithSelection<
   ResourceSelection<Type>[]
 >;
 
 /**
  * Filter options that control which resources appear in the resource picker. Use filters to restrict the available resources based on publication status, resource type, or custom search criteria.
+ * @publicDocs
  */
-interface Filters {
+export interface Filters {
   /**
    * Whether to include products that aren't published on any sales channels. When `false`, only products published to at least one sales channel appear in the picker. Use this to ensure merchants only select products that customers can purchase.
    * @defaultValue true
@@ -360,6 +377,7 @@ interface Filters {
 
 /**
  * The `ResourcePickerOptions` object defines how the resource picker behaves, including which resource type to display, selection limits, filters, and preselected items. Access the following properties on the `ResourcePickerOptions` object to configure the resource picker's appearance and functionality.
+ * @publicDocs
  */
 export interface ResourcePickerOptions {
   /**
@@ -394,6 +412,7 @@ export interface ResourcePickerOptions {
 
 /**
  * Opens the resource picker modal for selecting products, variants, or collections. Returns the selected resources when the user confirms their selection, or undefined if they cancel.
+ * @publicDocs
  */
 export type ResourcePickerApi = (
   options: ResourcePickerOptions,

package/src/surfaces/admin/api/shared.ts

@@ -1,5 +1,6 @@
 /**
  * The `Data` object provides access to currently viewed or selected resources in the admin context.
+ * @publicDocs
  */
 export interface Data {
   /**
@@ -10,6 +11,7 @@ export interface Data {
 
 /**
  * The supported [metafield definition types](/docs/apps/build/metafields/list-of-data-types) for storing extension configuration data. Use these types to specify how metafield values should be formatted, validated, and displayed. Types prefixed with `list.` store arrays of values, while other types store single values. Choose a type that matches your data format (for example, use `'number_integer'` for whole numbers, `'single_line_text_field'` for short text, or `'json'` for complex structured data).
+ * @publicDocs
  */
 export type SupportedDefinitionType =
   | 'boolean'

package/src/surfaces/admin/api/standard/standard-rendering.ts

@@ -3,6 +3,9 @@ import type {ResourcePickerApi} from '../resource-picker/resource-picker';
 import type {StandardApi} from './standard';
 import type {ExtensionTarget as AnyExtensionTarget} from '../../extension-targets';
 
+/**
+ * @publicDocs
+ */
 export interface StandardRenderingExtensionApi<
   ExtensionTarget extends AnyExtensionTarget,
 > extends StandardApi<ExtensionTarget> {

package/src/surfaces/admin/api/standard/standard.ts

@@ -8,6 +8,7 @@ export type {Intents} from '../intents/intents';
 
 /**
  * The GraphQL error returned by the [GraphQL Admin API](/docs/api/admin-graphql).
+ * @publicDocs
  */
 export interface GraphQLError {
   /**
@@ -27,8 +28,9 @@ export interface GraphQLError {
 
 /**
  * The `Auth` object provides authentication methods for secure communication with your app backend.
+ * @publicDocs
  */
-interface Auth {
+export interface Auth {
   /**
    * Retrieves a [Shopify OpenID Connect ID token](/docs/api/app-home/apis/id-token) for the current user. Use this token to authenticate requests to your app backend and verify the user's identity. The token is a signed JWT that contains user information and can be validated using Shopify's public keys. Returns `null` if the token can't be retrieved.
    */
@@ -37,6 +39,7 @@ interface Auth {
 
 /**
  * The `StandardApi` object provides core methods available to all extension targets. Access the following properties on the `StandardApi` object to authenticate users, query the [GraphQL Admin API](/docs/api/admin-graphql), translate content, handle intents, and persist data.
+ * @publicDocs
  */
 export interface StandardApi<ExtensionTarget extends AnyExtensionTarget> {
   /**

package/src/surfaces/admin/api/standard/storage.ts

@@ -1,3 +1,6 @@
+/**
+ * @publicDocs
+ */
 export interface Storage<
   BaseStorageTypes extends Record<string, any> = Record<string, unknown>,
 > {
@@ -98,6 +101,7 @@ export interface Storage<
 
 /**
  * Error thrown when storage operations exceed the available storage quota. This can occur during `set()` or `setMany()` operations when the total stored data size exceeds the limit allocated to your extension.
+ * @publicDocs
  */
 export interface StorageExceededError extends Error {
   name: 'StorageExceededError';

package/src/surfaces/admin/api.ts

@@ -15,3 +15,4 @@ export type {OrderRoutingRuleApi} from './api/order-routing-rule/order-routing-r
 export type {ValidationSettingsApi} from './api/checkout-rules/validation-settings';
 export type {PurchaseOptionsCardConfigurationApi} from './api/purchase-options-card-action';
 export type {DiscountFunctionSettingsApi} from './api/discount-function-settings/discount-function-settings';
+export type {IntentRenderApi} from './api/intents/intent-render';

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

@@ -9,6 +9,7 @@ import type {ComponentChildren, AdminActionProps$1} from './shared.d.ts';
 
 /**
  * The properties for the admin action component. These properties configure the heading and loading state of the admin action extension interface.
+ * @publicDocs
  */
 export interface AdminActionProps
   extends Pick<AdminActionProps$1, 'heading' | 'loading'> {}
@@ -17,6 +18,7 @@ declare const tagName = 's-admin-action';
 
 /**
  * The JSX props for the admin action component. These properties extend `AdminActionProps` with slots for primary and secondary action buttons that merchants can interact with.
+ * @publicDocs
  */
 export interface AdminActionJSXProps
   extends Partial<AdminActionProps>,
@@ -33,10 +35,12 @@ export interface AdminActionJSXProps
 
 /**
  * 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'> & {
   /**
@@ -50,6 +54,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 {
   /**
@@ -71,6 +76,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 {
   /**

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

@@ -9,6 +9,7 @@ import type {AdminBlockProps$1, ComponentChildren} from './shared.d.ts';
 
 /**
  * The properties for the admin block component. These properties configure the heading and collapsed summary of collapsible content blocks in the admin interface.
+ * @publicDocs
  */
 export interface AdminBlockProps
   extends Pick<AdminBlockProps$1, 'heading' | 'collapsedSummary'> {}
@@ -17,6 +18,7 @@ declare const tagName = 's-admin-block';
 
 /**
  * The JSX props for the admin block component. These properties extend `AdminBlockProps` with an optional `id` for element identification in JSX rendering.
+ * @publicDocs
  */
 export interface AdminBlockJSXProps
   extends Partial<AdminBlockProps>,
@@ -24,10 +26,12 @@ export interface AdminBlockJSXProps
 
 /**
  * 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'> & {
   /**
@@ -41,6 +45,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 {
   /**
@@ -62,6 +67,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 {
   /**

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

@@ -9,6 +9,7 @@ import type {AdminPrintActionProps$1, ComponentChildren} from './shared.d.ts';
 
 /**
  * The properties for the admin print action component. These properties configure the source URL for printing content within admin extensions.
+ * @publicDocs
  */
 export interface AdminPrintActionProps
   extends Pick<AdminPrintActionProps$1, 'src'> {}
@@ -17,6 +18,7 @@ declare const tagName = 's-admin-print-action';
 
 /**
  * The JSX props for the admin print action component. These properties extend `AdminPrintActionProps` with an optional `id` for element identification in JSX rendering.
+ * @publicDocs
  */
 export interface AdminPrintActionJSXProps
   extends Partial<AdminPrintActionProps>,
@@ -24,10 +26,12 @@ export interface AdminPrintActionJSXProps
 
 /**
  * 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'> & {
   /**
@@ -41,6 +45,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 {
   /**
@@ -62,6 +67,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 {
   /**

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

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

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

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

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

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