@shopify/ui-extensions 2026.1.1 → 2026.1.3

package/build/ts/surfaces/admin/api/checkout-rules/validation-settings.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation-settings.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/checkout-rules/validation-settings.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BA4CX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"validation-settings.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/checkout-rules/validation-settings.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BA2FX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/admin/api/customer-segment-template/customer-segment-template.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"customer-segment-template.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/customer-segment-template/customer-segment-template.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAsCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"customer-segment-template.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/customer-segment-template/customer-segment-template.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAqFX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/admin/api/discount-function-settings/discount-function-settings.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discount-function-settings.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/discount-function-settings/discount-function-settings.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAkDX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"discount-function-settings.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/discount-function-settings/discount-function-settings.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BA0FX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/admin/api/discount-function-settings/launch-options.d.ts

@@ -19,14 +19,7 @@ interface Metafield {
 /**
  * The discount class that determines where the discount applies in the purchase flow. Use this to understand what type of discount the merchant is configuring (product-level, order-level, or shipping).
  */
-export declare enum DiscountClass {
-    /** The discount applies to specific products or product variants. Use this for discounts that reduce the price of individual line items (for example, "20% off selected products"). */
-    Product = "PRODUCT",
-    /** The discount applies to the entire order total. Use this for cart-wide discounts that reduce the subtotal (for example, "$10 off orders over $50"). */
-    Order = "ORDER",
-    /** The discount applies to shipping costs. Use this for free shipping or reduced shipping rate discounts (for example, "Free shipping on orders over $100"). */
-    Shipping = "SHIPPING"
-}
+export type DiscountClass = 'product' | 'order' | 'shipping';
 /**
  * The method used to apply a discount. Use `'automatic'` for discounts that apply automatically at checkout, or `'code'` for discounts that require a code entered by the customer.
  */

package/build/ts/surfaces/admin/api/discount-function-settings/launch-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launch-options.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/discount-function-settings/launch-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,UAAU,SAAS;IACjB,qKAAqK;IACrK,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mIAAmI;IACnI,EAAE,EAAE,MAAM,CAAC;IACX,2JAA2J;IAC3J,SAAS,EAAE,MAAM,CAAC;IAClB,mMAAmM;IACnM,GAAG,EAAE,MAAM,CAAC;IACZ,8HAA8H;IAC9H,KAAK,EAAE,MAAM,CAAC;IACd,sMAAsM;IACtM,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,uLAAuL;IACvL,OAAO,YAAY;IACnB,0JAA0J;IAC1J,KAAK,UAAU;IACf,gKAAgK;IAChK,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,KAAK,cAAc,GAAG,WAAW,GAAG,MAAM,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,4PAA4P;IAC5P,EAAE,EAAE,MAAM,CAAC;IACX,2PAA2P;IAC3P,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,eAAe,EAAE,kBAAkB,CAAC,aAAa,EAAE,CAAC,CAAC;IACrD;;OAEG;IACH,qBAAqB,EAAE,oBAAoB,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7D;;OAEG;IACH,cAAc,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC;CACpD"}
+{"version":3,"file":"launch-options.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/discount-function-settings/launch-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,UAAU,SAAS;IACjB,qKAAqK;IACrK,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mIAAmI;IACnI,EAAE,EAAE,MAAM,CAAC;IACX,2JAA2J;IAC3J,SAAS,EAAE,MAAM,CAAC;IAClB,mMAAmM;IACnM,GAAG,EAAE,MAAM,CAAC;IACZ,8HAA8H;IAC9H,KAAK,EAAE,MAAM,CAAC;IACd,sMAAsM;IACtM,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAE7D;;GAEG;AACH,KAAK,cAAc,GAAG,WAAW,GAAG,MAAM,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,4PAA4P;IAC5P,EAAE,EAAE,MAAM,CAAC;IACX,2PAA2P;IAC3P,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,eAAe,EAAE,kBAAkB,CAAC,aAAa,EAAE,CAAC,CAAC;IACrD;;OAEG;IACH,qBAAqB,EAAE,oBAAoB,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7D;;OAEG;IACH,cAAc,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC;CACpD"}

package/build/ts/surfaces/admin/api/intents/intents.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intents.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/intents/intents.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAolBX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"intents.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/intents/intents.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BA6mBX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/admin/api/order-routing-rule/order-routing-rule.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"order-routing-rule.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/order-routing-rule/order-routing-rule.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAuCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"order-routing-rule.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/order-routing-rule/order-routing-rule.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAsFX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/admin/api/picker/picker.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"picker.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/picker/picker.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAuHX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"picker.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/picker/picker.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAkIX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/admin/api/print-action/print-action.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"print-action.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/print-action/print-action.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAuCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"print-action.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/print-action/print-action.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAsFX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/admin/api/product-configuration/product-details-configuration.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"product-details-configuration.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/product-configuration/product-details-configuration.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAuCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"product-details-configuration.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/product-configuration/product-details-configuration.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAsFX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/admin/api/product-configuration/product-variant-details-configuration.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"product-variant-details-configuration.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/product-configuration/product-variant-details-configuration.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAuCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"product-variant-details-configuration.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/product-configuration/product-variant-details-configuration.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAsFX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/admin/api/purchase-options-card-action.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"purchase-options-card-action.doc.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/admin/api/purchase-options-card-action.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAsCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"purchase-options-card-action.doc.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/admin/api/purchase-options-card-action.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAqFX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/admin/api/resource-picker/resource-picker.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-picker.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/resource-picker/resource-picker.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BA0KX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"resource-picker.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/resource-picker/resource-picker.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAoLX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/admin/api/should-render/should-render.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"should-render.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/should-render/should-render.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAoCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"should-render.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/should-render/should-render.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAmFX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/admin/api/standard/standard.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/standard/standard.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAuCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"standard.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/api/standard/standard.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAsFX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/build/ts/surfaces/admin/api/standard/storage.d.ts

@@ -9,7 +9,7 @@ export interface Storage<BaseStorageTypes extends Record<string, any> = Record<s
      */
     set<StorageTypes extends BaseStorageTypes = BaseStorageTypes, Keys extends keyof StorageTypes = keyof StorageTypes>(key: Keys, value: StorageTypes[Keys]): Promise<void>;
     /**
-     * Sets multiple key-value pairs in the storage at once. Use this for efficient batch operations when you need to save multiple related values together, such as form data or configuration settings. This operation is atomic: if it fails, no changes are made to storage, ensuring data consistency.
+     * Sets multiple key-value pairs in the storage at once. Use this for efficient batch operations when you need to save multiple related values together, such as form data or configuration settings.
      *
      * @param entries - An object containing key-value pairs to store. Values can be any primitive type supported by `JSON.stringify`.
      *

package/build/ts/surfaces/admin/components/ActionExtensionComponents.d.ts

@@ -1,6 +1,6 @@
 import { StandardComponents } from './StandardComponents';
 /**
- * The components available for building action extensions. Includes all standard components plus the `AdminAction` component required for action extension setup.
+ * The components available for building action extensions. Includes all standard components plus the admin action component required for action extension setup.
  */
 export type ActionExtensionComponents = StandardComponents | 'AdminAction';
 export default ActionExtensionComponents;

package/build/ts/surfaces/admin/components/AdminAction/AdminAction.ext.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdminAction.ext.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/AdminAction/AdminAction.ext.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAsCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"AdminAction.ext.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/AdminAction/AdminAction.ext.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAyHX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

@@ -1,44 +1,145 @@
-/** VERSION: 1.38.0 **/
+/** VERSION: 1.25.0 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
 
 // eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment
 /// <reference lib="DOM" />
-import type {
-  ComponentChildren,
-  AdminActionProps$1,
-  PreactCustomElement,
-  RenderImpl,
-} from './shared.d.ts';
+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.
+ */
 export interface AdminActionProps
   extends Pick<AdminActionProps$1, 'heading' | 'loading'> {}
 
 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.
+ */
 export interface AdminActionJSXProps
   extends Partial<AdminActionProps>,
     Pick<AdminActionProps$1, 'id'> {
   /**
-   * The primary action to display in the admin action.
+   * The primary action button or link to display in the admin action area. This is the main call-to-action that appears prominently in the interface. Typically uses a button component with `variant="primary"` to complete or advance the workflow.
    */
   primaryAction: ComponentChildren;
   /**
-   * The secondary actions to display in the admin action.
+   * The secondary action buttons or links to display in the admin action area. These are supporting actions like cancel, back, or alternative operations. Typically uses button components with `variant="secondary"` or `variant="tertiary"`.
    */
   secondaryActions: ComponentChildren;
 }
 
-declare class PolarisCustomElement extends PreactCustomElement {
-  constructor(renderImpl: Omit<RenderImpl, 'globalShadowCSS'>);
+/**
+ * The CSS styles as a string, used for styling web components within their shadow DOM.
+ */
+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.
+ */
+export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
+  /**
+   * The render function that returns Preact/JSX elements to display in the component's shadow root.
+   */
+  ShadowRoot: (element: any) => ComponentChildren;
+  /**
+   * The optional CSS styles to inject into the component's shadow DOM.
+   */
+  styles?: Styles;
+};
+/**
+ * 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.
+ */
+export interface ActivationEventEsque {
+  /**
+   * Whether the Shift key was pressed during the activation event.
+   */
+  shiftKey: boolean;
+  /**
+   * Whether the Meta key (Command on Mac, Windows key on Windows) was pressed during the activation event.
+   */
+  metaKey: boolean;
+  /**
+   * Whether the Control key was pressed during the activation event.
+   */
+  ctrlKey: boolean;
+  /**
+   * The mouse button that was pressed during the activation event. `0` for primary button (left click), `1` for auxiliary button (middle click), `2` for secondary button (right click).
+   */
+  button: number;
+}
+/**
+ * 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.
+ */
+export interface ClickOptions {
+  /**
+   * The activation event (such as a click or keyboard event) whose modifier key state and button information should influence the synthetic click behavior. For example, passing an event with `metaKey: true` will cause links to open in a new tab.
+   */
+  sourceEvent?: ActivationEventEsque;
+}
+/**
+ * Base class for creating custom elements with Preact.
+ * While this class could be used in both Node and the browser, the constructor will only be used in the browser.
+ * So we give it a type of HTMLElement to avoid typing issues later where it's used, which will only happen in the browser.
+ */
+declare const BaseClass: typeof globalThis.HTMLElement;
+declare abstract class PreactCustomElement extends BaseClass {
+  /** @private */
+  static get observedAttributes(): string[];
+  constructor({
+    styles,
+    ShadowRoot: renderFunction,
+    delegatesFocus,
+    ...options
+  }: RenderImpl);
+
+  /** @private */
+  setAttribute(name: string, value: string): void;
+  /** @private */
+  attributeChangedCallback(name: string): void;
+  /** @private */
+  connectedCallback(): void;
+  /** @private */
+  disconnectedCallback(): void;
+  /** @private */
+  adoptedCallback(): void;
+  /**
+   * Queue a run of the render function.
+   * You shouldn't need to call this manually - it should be handled by changes to @property values.
+   * @private
+   */
+  queueRender(): void;
+  /**
+   * Like the standard `element.click()`, but you can influence the behavior with a `sourceEvent`.
+   *
+   * For example, if the `sourceEvent` was a middle click, or has particular keys held down,
+   * components will attempt to produce the desired behavior on links, such as opening the page in the background tab.
+   * @private
+   * @param options
+   */
+  click({sourceEvent}?: ClickOptions): void;
 }
 
+/**
+ * The admin action custom element class that renders action controls in the Shopify admin interface. This component creates a standardized action area with a heading and slots for primary and secondary action buttons, used exclusively in admin action extensions.
+ */
 declare class AdminAction
-  extends PolarisCustomElement
+  extends PreactCustomElement
   implements AdminActionProps
 {
+  /**
+   * The heading text to display at the top of the action area. This title describes the action or task the merchant is performing. If not provided, the extension name is used as the heading.
+   */
   heading: string;
+
+  /**
+   * Whether the action extension is currently in a loading state, such as during initial data fetching or when opening the action. When `true`, the action area might display loading indicators and prevent user interaction until loading completes.
+   *
+   * @default false
+   */
   loading: boolean;
+
   constructor();
 }
 declare global {

package/build/ts/surfaces/admin/components/AdminBlock/AdminBlock.ext.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdminBlock.ext.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/AdminBlock/AdminBlock.ext.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BA4CX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"AdminBlock.ext.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/AdminBlock/AdminBlock.ext.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BA4HX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

@@ -1,34 +1,134 @@
-/** VERSION: 1.38.0 **/
+/** VERSION: 1.25.0 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
 
 // eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment
 /// <reference lib="DOM" />
-import type {
-  AdminBlockProps$1,
-  PreactCustomElement,
-  RenderImpl,
-} from './shared.d.ts';
+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.
+ */
 export interface AdminBlockProps
   extends Pick<AdminBlockProps$1, 'heading' | 'collapsedSummary'> {}
 
 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.
+ */
 export interface AdminBlockJSXProps
   extends Partial<AdminBlockProps>,
     Pick<AdminBlockProps$1, 'id'> {}
 
-declare class PolarisCustomElement extends PreactCustomElement {
-  constructor(renderImpl: Omit<RenderImpl, 'globalShadowCSS'>);
+/**
+ * The CSS styles as a string, used for styling web components within their shadow DOM.
+ */
+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.
+ */
+export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
+  /**
+   * The render function that returns Preact/JSX elements to display in the component's shadow root.
+   */
+  ShadowRoot: (element: any) => ComponentChildren;
+  /**
+   * The optional CSS styles to inject into the component's shadow DOM.
+   */
+  styles?: Styles;
+};
+/**
+ * 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.
+ */
+export interface ActivationEventEsque {
+  /**
+   * Whether the Shift key was pressed during the activation event.
+   */
+  shiftKey: boolean;
+  /**
+   * Whether the Meta key (Command on Mac, Windows key on Windows) was pressed during the activation event.
+   */
+  metaKey: boolean;
+  /**
+   * Whether the Control key was pressed during the activation event.
+   */
+  ctrlKey: boolean;
+  /**
+   * The mouse button that was pressed during the activation event. `0` for primary button (left click), `1` for auxiliary button (middle click), `2` for secondary button (right click).
+   */
+  button: number;
+}
+/**
+ * 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.
+ */
+export interface ClickOptions {
+  /**
+   * The activation event (such as a click or keyboard event) whose modifier key state and button information should influence the synthetic click behavior. For example, passing an event with `metaKey: true` will cause links to open in a new tab.
+   */
+  sourceEvent?: ActivationEventEsque;
+}
+/**
+ * Base class for creating custom elements with Preact.
+ * While this class could be used in both Node and the browser, the constructor will only be used in the browser.
+ * So we give it a type of HTMLElement to avoid typing issues later where it's used, which will only happen in the browser.
+ */
+declare const BaseClass: typeof globalThis.HTMLElement;
+declare abstract class PreactCustomElement extends BaseClass {
+  /** @private */
+  static get observedAttributes(): string[];
+  constructor({
+    styles,
+    ShadowRoot: renderFunction,
+    delegatesFocus,
+    ...options
+  }: RenderImpl);
+
+  /** @private */
+  setAttribute(name: string, value: string): void;
+  /** @private */
+  attributeChangedCallback(name: string): void;
+  /** @private */
+  connectedCallback(): void;
+  /** @private */
+  disconnectedCallback(): void;
+  /** @private */
+  adoptedCallback(): void;
+  /**
+   * Queue a run of the render function.
+   * You shouldn't need to call this manually - it should be handled by changes to @property values.
+   * @private
+   */
+  queueRender(): void;
+  /**
+   * Like the standard `element.click()`, but you can influence the behavior with a `sourceEvent`.
+   *
+   * For example, if the `sourceEvent` was a middle click, or has particular keys held down,
+   * components will attempt to produce the desired behavior on links, such as opening the page in the background tab.
+   * @private
+   * @param options
+   */
+  click({sourceEvent}?: ClickOptions): void;
 }
 
+/**
+ * The admin block custom element class that renders a collapsible content block in the Shopify admin interface. This component organizes content into expandable sections with headings and provides a summary when collapsed.
+ */
 declare class AdminBlock
-  extends PolarisCustomElement
+  extends PreactCustomElement
   implements AdminBlockProps
 {
+  /**
+   * The heading text to display at the top of the block. This title describes the content section the merchant is viewing. If not provided, no heading is displayed.
+   */
   heading: string;
+
+  /**
+   * The summary text to display when the block is collapsed. This provides merchants with a preview of the block's contents without expanding it. If not provided, no summary is displayed.
+   */
   collapsedSummary: string;
+
   constructor();
 }
 declare global {

package/build/ts/surfaces/admin/components/AdminPrintAction/AdminPrintAction.ext.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdminPrintAction.ext.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/AdminPrintAction/AdminPrintAction.ext.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BAiCX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"AdminPrintAction.ext.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/AdminPrintAction/AdminPrintAction.ext.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,QAAA,MAAM,IAAI,EAAE,6BA8FX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

@@ -1,33 +1,129 @@
-/** VERSION: 1.38.0 **/
+/** VERSION: 1.25.0 **/
 /* eslint-disable import/extensions */
 
 /* eslint-disable @typescript-eslint/no-namespace */
 
 // eslint-disable-next-line @typescript-eslint/triple-slash-reference, spaced-comment
 /// <reference lib="DOM" />
-import type {
-  AdminPrintActionProps$1,
-  PreactCustomElement,
-  RenderImpl,
-} from './shared.d.ts';
+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.
+ */
 export interface AdminPrintActionProps
   extends Pick<AdminPrintActionProps$1, 'src'> {}
 
 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.
+ */
 export interface AdminPrintActionJSXProps
   extends Partial<AdminPrintActionProps>,
     Pick<AdminPrintActionProps$1, 'id'> {}
 
-declare class PolarisCustomElement extends PreactCustomElement {
-  constructor(renderImpl: Omit<RenderImpl, 'globalShadowCSS'>);
+/**
+ * The CSS styles as a string, used for styling web components within their shadow DOM.
+ */
+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.
+ */
+export type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
+  /**
+   * The render function that returns Preact/JSX elements to display in the component's shadow root.
+   */
+  ShadowRoot: (element: any) => ComponentChildren;
+  /**
+   * The optional CSS styles to inject into the component's shadow DOM.
+   */
+  styles?: Styles;
+};
+/**
+ * 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.
+ */
+export interface ActivationEventEsque {
+  /**
+   * Whether the Shift key was pressed during the activation event.
+   */
+  shiftKey: boolean;
+  /**
+   * Whether the Meta key (Command on Mac, Windows key on Windows) was pressed during the activation event.
+   */
+  metaKey: boolean;
+  /**
+   * Whether the Control key was pressed during the activation event.
+   */
+  ctrlKey: boolean;
+  /**
+   * The mouse button that was pressed during the activation event. `0` for primary button (left click), `1` for auxiliary button (middle click), `2` for secondary button (right click).
+   */
+  button: number;
+}
+/**
+ * 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.
+ */
+export interface ClickOptions {
+  /**
+   * The activation event (such as a click or keyboard event) whose modifier key state and button information should influence the synthetic click behavior. For example, passing an event with `metaKey: true` will cause links to open in a new tab.
+   */
+  sourceEvent?: ActivationEventEsque;
 }
+/**
+ * Base class for creating custom elements with Preact.
+ * While this class could be used in both Node and the browser, the constructor will only be used in the browser.
+ * So we give it a type of HTMLElement to avoid typing issues later where it's used, which will only happen in the browser.
+ */
+declare const BaseClass: typeof globalThis.HTMLElement;
+declare abstract class PreactCustomElement extends BaseClass {
+  /** @private */
+  static get observedAttributes(): string[];
+  constructor({
+    styles,
+    ShadowRoot: renderFunction,
+    delegatesFocus,
+    ...options
+  }: RenderImpl);
 
+  /** @private */
+  setAttribute(name: string, value: string): void;
+  /** @private */
+  attributeChangedCallback(name: string): void;
+  /** @private */
+  connectedCallback(): void;
+  /** @private */
+  disconnectedCallback(): void;
+  /** @private */
+  adoptedCallback(): void;
+  /**
+   * Queue a run of the render function.
+   * You shouldn't need to call this manually - it should be handled by changes to @property values.
+   * @private
+   */
+  queueRender(): void;
+  /**
+   * Like the standard `element.click()`, but you can influence the behavior with a `sourceEvent`.
+   *
+   * For example, if the `sourceEvent` was a middle click, or has particular keys held down,
+   * components will attempt to produce the desired behavior on links, such as opening the page in the background tab.
+   * @private
+   * @param options
+   */
+  click({sourceEvent}?: ClickOptions): void;
+}
+
+/**
+ * The admin print action custom element class that renders a print interface in the Shopify admin. This component enables merchants to print content from a specified source URL using the browser's print functionality.
+ */
 declare class AdminPrintAction
-  extends PolarisCustomElement
+  extends PreactCustomElement
   implements AdminPrintActionProps
 {
+  /**
+   * The source URL of the content to print. This should point to the document or page that'll be sent to the printer when the merchant initiates the print action.
+   */
   src: string;
+
   constructor();
 }
 declare global {

package/build/ts/surfaces/admin/components/Avatar/Avatar.doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Avatar.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Avatar/Avatar.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAgRX,CAAC;AAEF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Avatar.doc.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/admin/components/Avatar/Avatar.doc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,kBAAkB,CAAC;AAGpE,QAAA,MAAM,IAAI,EAAE,kCAuJX,CAAC;AAEF,eAAe,IAAI,CAAC"}