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

package/src/surfaces/admin/api/order-routing-rule/metafields.ts

@@ -45,8 +45,9 @@ const supportedDefinitionTypes = [
 
 /**
  * A metafield update or creation operation. Use this to set or modify metafield values that store order routing rule configuration data.
+ * @publicDocs
  */
-interface MetafieldUpdateChange {
+export interface MetafieldUpdateChange {
   /** Identifies this as an update operation. Always set to `'updateMetafield'` for updates. */
   type: 'updateMetafield';
   /** The unique key identifying the metafield within its namespace. Use descriptive keys that indicate the setting's purpose (for example, `'preferred_location'` or `'routing_priority'`). */
@@ -61,8 +62,9 @@ interface MetafieldUpdateChange {
 
 /**
  * A metafield removal operation. Use this to delete metafields that are no longer needed for your order routing rule configuration.
+ * @publicDocs
  */
-interface MetafieldRemoveChange {
+export interface MetafieldRemoveChange {
   /** Identifies this as a removal operation. Always set to `'removeMetafield'` for deletions. */
   type: 'removeMetafield';
   /** The unique key of the metafield to remove. Must match the key used when the metafield was created. */
@@ -73,8 +75,9 @@ interface MetafieldRemoveChange {
 
 /**
  * One or more metafield change operations to apply to order routing rule settings. Can be a single change or an array of changes for batch operations. Use arrays to apply multiple changes at once.
+ * @publicDocs
  */
-type MetafieldsChange =
+export type MetafieldsChange =
   | MetafieldUpdateChange
   | MetafieldRemoveChange
   | MetafieldUpdateChange[]
@@ -82,10 +85,12 @@ type MetafieldsChange =
 
 /**
  * The supported [metafield definition types](/docs/apps/build/metafields/list-of-data-types) for storing order routing rule 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.
+ * @publicDocs
  */
 export type SupportedDefinitionType = (typeof supportedDefinitionTypes)[number];
 
 /**
  * A function that applies metafield changes to order routing rule settings. Call this function with one or more change operations to update or remove metafields in batch. Use batch operations to apply multiple configuration changes efficiently.
+ * @publicDocs
  */
 export type ApplyMetafieldsChange = (changes: MetafieldsChange[]) => void;

package/src/surfaces/admin/api/order-routing-rule/order-routing-rule.ts

@@ -6,6 +6,7 @@ import {Data} from './data';
 
 /**
  * The `OrderRoutingRuleApi` object provides methods for configuring order routing rules. Access the following properties on the `OrderRoutingRuleApi` object to manage rule settings and metafields.
+ * @publicDocs
  */
 export interface OrderRoutingRuleApi<ExtensionTarget extends AnyExtensionTarget>
   extends StandardRenderingExtensionApi<ExtensionTarget> {

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

@@ -1,7 +1,8 @@
 /**
  * A handle returned when opening a picker dialog. Use this to access the merchant's selection after they confirm or cancel the picker.
+ * @publicDocs
  */
-interface Picker {
+export interface Picker {
   /**
    * A Promise that resolves with an array of selected item IDs when the merchant presses the **Select** button, or `undefined` if they cancel. Await this Promise to handle the selection result.
    */
@@ -10,8 +11,9 @@ interface Picker {
 
 /**
  * The configuration for a table column header in the picker. Each header creates a labeled column that displays corresponding data from items.
+ * @publicDocs
  */
-interface Header {
+export interface Header {
   /**
    * The label text displayed at the top of the table column. Use clear, concise labels that describe the data in that column (for example, "Price", "Status", "Last Updated").
    */
@@ -25,8 +27,9 @@ interface Header {
 
 /**
  * The configuration options for the custom picker dialog. Define the picker's appearance, selection behavior, and data structure.
+ * @publicDocs
  */
-interface PickerOptions {
+export interface PickerOptions {
   /**
    * The heading displayed at the top of the picker modal. Use a clear, descriptive title that tells merchants what they're selecting.
    */
@@ -47,22 +50,26 @@ interface PickerOptions {
 
 /**
  * The visual tone for picker badges indicating status or importance. Use different tones to communicate urgency or state: `'info'` for neutral information, `'success'` for positive states, `'warning'` for caution, or `'critical'` for urgent issues.
+ * @publicDocs
  */
 export type Tone = 'info' | 'success' | 'warning' | 'critical';
 
 /**
  * The progress state for picker badges showing completion status. Use this to indicate how complete an item is: `'incomplete'` for not started, `'partiallyComplete'` for in progress, or `'complete'` for finished.
+ * @publicDocs
  */
 export type Progress = 'incomplete' | 'partiallyComplete' | 'complete';
 
 /**
  * A single data point that can appear in a picker table cell. Can be text, a number, or undefined if the cell should be empty.
+ * @publicDocs
  */
-type DataPoint = string | number | undefined;
+export type DataPoint = string | number | undefined;
 /**
  * A badge displayed next to an item in the picker to show status or progress. Use badges to highlight important item attributes or states that affect selection decisions.
+ * @publicDocs
  */
-interface PickerBadge {
+export interface PickerBadge {
   /** The text content of the badge. Keep this short and descriptive (for example, "Draft", "Active", "Incomplete"). */
   content: string;
   /** The visual tone indicating status or importance. Choose a tone that matches the badge's meaning. */
@@ -73,8 +80,9 @@ interface PickerBadge {
 
 /**
  * An individual item that merchants can select in the picker. Each item appears as a row in the picker table.
+ * @publicDocs
  */
-interface Item {
+export interface Item {
   /**
    * The unique identifier for this item. This ID is returned in the selection array when the merchant selects this item. Use an ID that helps you identify the item in your system (for example, template IDs, review IDs, or custom option keys).
    */
@@ -108,5 +116,6 @@ interface Item {
 
 /**
  * The `picker` function opens a custom selection dialog with your app-specific data. It accepts configuration options to define the picker's heading, items, headers, and selection behavior. It returns a Promise that resolves to a `Picker` object with a `selected` property for accessing the merchant's selection.
+ * @publicDocs
  */
 export type PickerApi = (options: PickerOptions) => Promise<Picker>;

package/src/surfaces/admin/api/print-action/print-action.ts

@@ -4,6 +4,7 @@ import type {Data} from '../shared';
 
 /**
  * The `PrintActionExtensionApi` object provides methods for print action extensions that generate custom printable documents. Access the following properties on the `PrintActionExtensionApi` object to access selected resources and display picker dialogs for print configuration.
+ * @publicDocs
  */
 export interface PrintActionExtensionApi<
   ExtensionTarget extends AnyExtensionTarget,

package/src/surfaces/admin/api/product-configuration/product-details-configuration.ts

@@ -5,8 +5,9 @@ import type {Data} from '../shared';
 /**
  * A product configuration.
  * @deprecated
+ * @publicDocs
  */
-interface Product {
+export interface Product {
   /** The product's unique global identifier (GID). */
   id: string;
   /** The product's display name shown to merchants and customers. */
@@ -41,6 +42,7 @@ interface Product {
 /**
  * A component product that is part of a bundle. Represents an individual product included in a bundle configuration.
  * @deprecated
+ * @publicDocs
  */
 export interface ProductComponent {
   /** The component product's unique global identifier (GID). */
@@ -65,6 +67,7 @@ export interface ProductComponent {
 
 /**
  * The `ProductDetailsConfigurationApi` object provides methods for configuring product bundles and relationships. Access the following properties on the `ProductDetailsConfigurationApi` object to build product configuration interfaces.
+ * @publicDocs
  */
 export interface ProductDetailsConfigurationApi<
   ExtensionTarget extends AnyExtensionTarget,

package/src/surfaces/admin/api/product-configuration/product-variant-details-configuration.ts

@@ -5,8 +5,9 @@ import type {Data} from '../shared';
 /**
  * A product variant configuration.
  * @deprecated
+ * @publicDocs
  */
-interface ProductVariant {
+export interface ProductVariant {
   /** The variant's unique global identifier (GID). */
   id: string;
   /** The Stock Keeping Unit (SKU) identifier for inventory tracking. */
@@ -39,6 +40,7 @@ interface ProductVariant {
 /**
  * A component variant that is part of a product bundle. Represents an individual product variant included in a bundle configuration.
  * @deprecated
+ * @publicDocs
  */
 export interface ProductVariantComponent {
   /** The component variant's unique global identifier (GID). */
@@ -66,6 +68,7 @@ export interface ProductVariantComponent {
 
 /**
  * The `ProductVariantDetailsConfigurationApi` object provides methods for configuring product variant bundles and relationships. Access the following properties on the `ProductVariantDetailsConfigurationApi` object to build variant configuration interfaces.
+ * @publicDocs
  */
 export interface ProductVariantDetailsConfigurationApi<
   ExtensionTarget extends AnyExtensionTarget,

package/src/surfaces/admin/api/purchase-options-card-action.ts

@@ -3,6 +3,7 @@ import type {ExtensionTarget as AnyExtensionTarget} from '../extension-targets';
 
 /**
  * The `PurchaseOptionsCardConfigurationApi` object provides methods for action extensions that interact with purchase options and selling plans. Access the following properties on the `PurchaseOptionsCardConfigurationApi` object to work with selected products and their associated subscription configurations.
+ * @publicDocs
  */
 export interface PurchaseOptionsCardConfigurationApi<
   ExtensionTarget extends AnyExtensionTarget,

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,10 @@ 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';
+export type {
+  ShopifyGeneratedIntentResponse,
+  ShopifyGeneratedIntentVariant,
+  WithGeneratedIntents,
+  WithGeneratedTools,
+} from './api/generated/generated';

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 {
   /**