@shopify/hydrogen 2026.10.0-preview.4 → 2026.10.0

package/dist/core/shop-pay/shop-pay.d.mts

@@ -1,55 +1,67 @@
 //#region src/core/shop-pay/shop-pay.d.ts
+/**
+ * Tag name of the Shop Pay button custom element, `hydrogen-shop-pay-button`.
+ *
+ * Use the tag directly on a framework without a Hydrogen binding.
+ *
+ * @publicDocs
+ */
 declare const SHOP_PAY_BUTTON_TAG_NAME = "hydrogen-shop-pay-button";
+/** Checkout target, attribution, and display settings shared by every Shop Pay button. */
 type ShopPayButtonBaseOptions = {
   /**
-   * Absolute checkout base URL. Omit it to emit same-origin `/checkout` and
-   * `/cart` permalink paths, which `handleShopifyRoutes` redirects to the
-   * store's real checkout.
+   * Absolute checkout base URL. Omit the URL to link to the same-origin `/checkout` and
+   * `/cart` permalink paths, which Hydrogen's Shopify route handler redirects to the
+   * store's checkout.
+   *
+   * Pass the cart's checkout URL when your app doesn't send same-origin checkout paths through the Shopify route handler. The button URL keeps the query params of the checkout URL, replaces any params that Shop Pay sets, and drops the hash. A bare domain such as `my-store.myshopify.com` gets an HTTPS scheme. The Shop Pay functions throw an error when the value isn't a valid URL.
    */
   checkoutUrl?: string;
   /**
-   * Checkout payment mode. Defaults to `"shop_pay"`. Use
-   * `"shop_pay_installments"` only when the checkout path should open Shop Pay
-   * Installments.
+   * Checkout payment mode. Defaults to `shop_pay`. Use
+   * `shop_pay_installments` to open Shop Pay Installments at checkout.
    */
   paymentOption?: "shop_pay" | "shop_pay_installments";
   /**
-   * Attribution source appended to the checkout URL as `source`. Defaults to
-   * `"hydrogen"`. Most storefronts should not override this.
+   * Attribution source that the checkout URL carries as `source`.
+   * Defaults to `hydrogen`. Most storefronts shouldn't change the source.
    */
   source?: string;
   /**
-   * Optional attribution token appended to the checkout URL as `source_token`.
-   * Only pass a value when Shopify has provided one for the integration.
+   * Attribution token that the checkout URL carries as `source_token`.
    */
   sourceToken?: string;
   /**
-   * Content Security Policy nonce applied to the shadow root's inline style.
+   * Content Security Policy nonce for the button's style element.
+   *
+   * The nonce covers only the style element. Custom width and border radius values render as an inline style attribute, which a strict Content Security Policy must allow.
    */
   nonce?: string;
   /**
-   * Sales channel that issued the Storefront API token. Omit it unless checkout
-   * needs explicit `"headless"` or `"hydrogen"` attribution.
+   * Sales channel that the checkout URL carries as `channel`. Omit the channel unless
+   * checkout needs explicit `headless` or `hydrogen` attribution.
    */
   channel?: "headless" | "hydrogen";
   /**
-   * Disables the button. Disabled buttons render without an `href` and include
+   * Disables the button. A disabled button renders without an `href` and with
    * `aria-disabled="true"`.
    */
   disabled?: boolean;
   /**
-   * CSS width for the rendered anchor, for example `"100%"`. Omit it to use
-   * the Shop Pay default width.
+   * CSS width of the button, such as `100%`. Defaults to `260px`.
+   *
+   * Pass a single CSS value. The Shop Pay functions throw an error when the width contains a semicolon or a curly brace.
    */
   width?: string;
   /**
-   * CSS border radius for the rendered anchor, for example `"8px"`. Omit it to
-   * use the Shop Pay default radius.
+   * CSS border radius of the button, such as `8px`. Defaults to `12px`.
+   *
+   * Pass a single CSS value. The Shop Pay functions throw an error when the radius contains a semicolon or a curly brace.
    */
   borderRadius?: string;
   /**
-   * Localized accessible label for the Shop Pay logo. Defaults to `"Buy with Shop Pay"`.
-   * Never translate the brand name `"Shop Pay"`; keep it in Latin script in every locale.
+   * Localized accessible label for the button. Defaults to `"Buy with Shop Pay"`.
+   * Keep the brand name Shop Pay untranslated and in Latin script in every locale.
    *
    * @example English
    * `"Buy with Shop Pay"`
@@ -65,37 +77,61 @@ type ShopPayButtonBaseOptions = {
    */
   accessibilityLabel?: string;
 };
+/** A variant ID and an optional quantity for a Shop Pay checkout. */
 type ShopPayVariantWithQuantity = {
-  /** ProductVariant GID or bare numeric ProductVariant ID. Product IDs are invalid. */id: string; /** Quantity for this variant. Defaults to `1`. */
+  /** Product variant GID or numeric variant ID. Product IDs throw an error. */id: string; /** Quantity of the variant. Defaults to `1`. */
   quantity?: number;
 };
+/** Variants for a Shop Pay checkout, as all ID strings or all objects with an ID and a quantity. */
 type ShopPayVariants = readonly string[] | readonly ShopPayVariantWithQuantity[];
-type ShopPayButtonOptions = ShopPayButtonBaseOptions & {
+/** Checkout target, variants, attribution, and display settings for a Shop Pay button. */
+interface ShopPayButtonOptions extends ShopPayButtonBaseOptions {
   /**
-   * Variants to check out immediately via a Shopify cart permalink. Omit this
-   * for cart checkout mode, where `/checkout` checks out the current cart.
+   * Variants that the customer buys right away through a Shopify cart permalink. Omit the variants
+   * to check out the current cart.
+   *
+   * Pass either all variant ID strings or all objects with an `id` and an optional `quantity`. Each quantity must be a positive integer. The Shop Pay functions throw an error for product IDs, non-numeric variant IDs, invalid quantities, and mixed formats.
    */
   variants?: ShopPayVariants;
-};
+}
 /**
- * Builds the checkout URL the Shop Pay button navigates to, or `null` when the
- * button is disabled. Variant mode produces a cart permalink; otherwise the
- * current cart checks out.
+ * Returns the checkout URL for a Shop Pay button. Use the URL to build your own Shop Pay link.
+ *
+ * With variants, the URL is a cart permalink that checks out those variants. Without variants, the URL checks out the current cart.
+ *
+ * @param options The variants, checkout URL, payment mode, attribution, and disabled state for the checkout URL.
+ * @returns The checkout URL, or `null` when `disabled` is `true`.
+ * @publicDocs
  */
 declare function getShopPayButtonUrl(options: ShopPayButtonOptions): string | null;
 /**
- * Renders the Shop Pay button as an HTML string: a self-contained wrapper
- * element carrying the styles and anchor it needs to work without client
- * JavaScript. Use it from server templates or frameworks without a Hydrogen
- * binding.
+ * Returns the Shop Pay button as an HTML string for server templates and frameworks without a Hydrogen binding.
+ *
+ * On the server, the markup includes the button's styles and link, and the button works without client JavaScript. In the browser, the function returns an empty element that renders the button when you add the element to the page.
+ *
+ * @param options The variants, checkout URL, and display settings for the button.
+ * @returns The Shop Pay button markup.
+ * @publicDocs
  */
 declare function renderShopPayButton(options: ShopPayButtonOptions): string;
 /**
- * Creates the Shop Pay button as a detached DOM element. The returned element
- * carries the button styles with it.
+ * Creates a Shop Pay button element in the browser. Append the element to the page.
+ *
+ * The function requires a DOM. Use `renderShopPayButton` during server rendering.
+ *
+ * @param options The variants, checkout URL, and display settings for the button.
+ * @returns The Shop Pay button element, ready to append to the page.
+ * @publicDocs
  */
 declare function createShopPayButton(options: ShopPayButtonOptions): HTMLElement;
-/** Registers the Shop Pay custom element. No-ops during SSR or when already registered. */
+/**
+ * Registers the Shop Pay button custom element in the browser. Call the function when you use the `hydrogen-shop-pay-button` tag directly on a framework without a Hydrogen binding.
+ *
+ * The Hydrogen Shop Pay components, `createShopPayButton`, and `renderShopPayButton` register the element for you. The function does nothing during server rendering or when the browser already has the element.
+ *
+ * @returns Nothing.
+ * @publicDocs
+ */
 declare function defineShopPayButton(): void;
 //#endregion
 export { SHOP_PAY_BUTTON_TAG_NAME, ShopPayButtonOptions, createShopPayButton, defineShopPayButton, getShopPayButtonUrl, renderShopPayButton };

package/dist/core/shop-pay/shop-pay.mjs

@@ -6,6 +6,13 @@ const DEFAULT_SOURCE = "hydrogen";
 const DEFAULT_ACCESSIBILITY_LABEL = "Buy with Shop Pay";
 const ERROR_PREFIX = "[hydrogen:error:ShopPay]";
 const CAN_USE_DOM = typeof document !== "undefined";
+/**
+* Tag name of the Shop Pay button custom element, `hydrogen-shop-pay-button`.
+*
+* Use the tag directly on a framework without a Hydrogen binding.
+*
+* @publicDocs
+*/
 const SHOP_PAY_BUTTON_TAG_NAME = "hydrogen-shop-pay-button";
 const SHOP_PAY_BUTTON_CLASS_NAME = "shop-pay-button";
 const SHOP_PAY_BUTTON_OBSERVED_ATTRIBUTES = [
@@ -25,9 +32,13 @@ const SHOP_PAY_BUTTON_OBSERVED_ATTRIBUTES = [
 const SHOP_PAY_BUTTON_STYLES = `:host{display:block}.${SHOP_PAY_BUTTON_CLASS_NAME}{position:relative;display:flex;align-items:center;box-sizing:border-box;margin:0;padding:10px 16px;overflow:visible;width:260px;border:none;border-radius:12px;background-color:#5433eb;color:#fff;cursor:pointer;text-decoration:none;transition:all .15s cubic-bezier(.4,0,.2,1)}.${SHOP_PAY_BUTTON_CLASS_NAME}:hover{background-color:#4524db}.${SHOP_PAY_BUTTON_CLASS_NAME}:focus-visible{outline:none;box-shadow:0 0 0 3px #9c83f8}.${SHOP_PAY_BUTTON_CLASS_NAME}[aria-disabled=true]{opacity:.5;pointer-events:none;cursor:default}.${SHOP_PAY_BUTTON_CLASS_NAME}__logo{position:relative;display:inline-block;margin:0 auto;width:88px;height:auto}`;
 const SHOP_PAY_LOGO_SVG = `<svg class="${SHOP_PAY_BUTTON_CLASS_NAME}__logo" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 99 25" aria-hidden="true" focusable="false"><path fill="currentColor" d="M70.842 7.915h2.25c1.561 0 2.328.642 2.328 1.715 0 1.074-.739 1.715-2.259 1.715h-2.32v-3.43ZM80.525 16.142c-.879 0-1.227-.474-1.227-.948 0-.642.725-.935 2.147-1.102l1.115-.125c-.07 1.227-.892 2.175-2.035 2.175Z"/><path fill="currentColor" fill-rule="evenodd" d="M65.645.5a3.64 3.64 0 0 0-3.64 3.64V20.7a3.64 3.64 0 0 0 3.64 3.64h29.668a3.64 3.64 0 0 0 3.64-3.64V4.14A3.64 3.64 0 0 0 95.314.5H65.645Zm5.197 16.674v-4.197h2.64c2.412 0 3.695-1.353 3.695-3.402 0-2.05-1.283-3.277-3.695-3.277h-4.341v10.876h1.7Zm9.334.223c1.297 0 2.147-.572 2.538-1.548.112 1.088.767 1.645 2.189 1.269l.014-1.157c-.572.055-.683-.154-.683-.753v-2.845c0-1.673-1.102-2.663-3.138-2.663-2.008 0-3.165 1.004-3.165 2.705h1.562c0-.809.572-1.297 1.576-1.297 1.06 0 1.547.46 1.534 1.255v.363l-1.8.195c-2.021.223-3.137.99-3.137 2.329 0 1.101.781 2.147 2.51 2.147Zm9.906.32c-.711 1.73-1.855 2.245-3.64 2.245h-.766V18.54h.822c.977 0 1.45-.307 1.966-1.185L85.3 9.923h1.757l2.259 5.424 2.008-5.424h1.715l-2.956 7.795Z" clip-rule="evenodd"/><path fill="currentColor" d="M6.992 11.055c-2.359-.509-3.41-.708-3.41-1.612 0-.85.711-1.274 2.134-1.274 1.25 0 2.165.544 2.839 1.61.05.081.155.11.241.066l2.655-1.335a.186.186 0 0 0 .076-.259c-1.102-1.9-3.137-2.94-5.818-2.94C2.188 5.311 0 7.037 0 9.781c0 2.915 2.664 3.651 5.027 4.16 2.362.51 3.417.709 3.417 1.613s-.769 1.33-2.303 1.33c-1.416 0-2.467-.644-3.102-1.896a.186.186 0 0 0-.251-.082L.14 16.21a.188.188 0 0 0-.083.253c1.051 2.102 3.207 3.285 6.087 3.285 3.668 0 5.885-1.698 5.885-4.527 0-2.83-2.677-3.651-5.037-4.16v-.007ZM21.218 5.311c-1.505 0-2.835.531-3.791 1.477-.06.057-.159.015-.159-.067V.687A.185.185 0 0 0 17.081.5h-3.322a.185.185 0 0 0-.187.187v18.73c0 .104.083.186.187.186h3.322a.185.185 0 0 0 .187-.186V11.2c0-1.587 1.223-2.804 2.87-2.804 1.649 0 2.843 1.191 2.843 2.804v8.216c0 .104.082.186.187.186h3.322a.185.185 0 0 0 .187-.186V11.2c0-3.452-2.274-5.89-5.459-5.89ZM33.415 4.774c-1.803 0-3.493.55-4.706 1.343a.186.186 0 0 0-.06.25l1.464 2.488c.054.089.168.12.257.066a5.853 5.853 0 0 1 3.052-.834c2.899 0 5.03 2.036 5.03 4.726 0 2.292-1.706 3.99-3.868 3.99-1.762 0-2.985-1.022-2.985-2.463 0-.825.352-1.502 1.27-1.98a.183.183 0 0 0 .073-.258l-1.381-2.327a.187.187 0 0 0-.226-.079c-1.85.683-3.15 2.327-3.15 4.533 0 3.338 2.67 5.83 6.396 5.83 4.35 0 7.478-3 7.478-7.303 0-4.612-3.64-7.982-8.644-7.982ZM51.776 5.283c-1.68 0-3.182.62-4.277 1.707a.093.093 0 0 1-.16-.066v-1.31a.185.185 0 0 0-.187-.186h-3.235a.185.185 0 0 0-.188.187v18.702c0 .104.083.186.188.186h3.32a.185.185 0 0 0 .188-.186v-6.133c0-.082.099-.123.16-.07 1.091 1.012 2.536 1.603 4.19 1.603 3.897 0 6.936-3.139 6.936-7.217 0-4.078-3.042-7.217-6.935-7.217Zm-.63 11.266c-2.215 0-3.895-1.754-3.895-4.074S48.928 8.4 51.147 8.4c2.22 0 3.893 1.726 3.893 4.075 0 2.348-1.651 4.074-3.896 4.074h.003Z"/></svg>`;
 /**
-* Builds the checkout URL the Shop Pay button navigates to, or `null` when the
-* button is disabled. Variant mode produces a cart permalink; otherwise the
-* current cart checks out.
+* Returns the checkout URL for a Shop Pay button. Use the URL to build your own Shop Pay link.
+*
+* With variants, the URL is a cart permalink that checks out those variants. Without variants, the URL checks out the current cart.
+*
+* @param options The variants, checkout URL, payment mode, attribution, and disabled state for the checkout URL.
+* @returns The checkout URL, or `null` when `disabled` is `true`.
+* @publicDocs
 */
 function getShopPayButtonUrl(options) {
 	if (options.disabled) return null;
@@ -41,10 +52,13 @@ function getShopPayButtonUrl(options) {
 	return url.toString();
 }
 /**
-* Renders the Shop Pay button as an HTML string: a self-contained wrapper
-* element carrying the styles and anchor it needs to work without client
-* JavaScript. Use it from server templates or frameworks without a Hydrogen
-* binding.
+* Returns the Shop Pay button as an HTML string for server templates and frameworks without a Hydrogen binding.
+*
+* On the server, the markup includes the button's styles and link, and the button works without client JavaScript. In the browser, the function returns an empty element that renders the button when you add the element to the page.
+*
+* @param options The variants, checkout URL, and display settings for the button.
+* @returns The Shop Pay button markup.
+* @publicDocs
 */
 function renderShopPayButton(options) {
 	defineShopPayButton();
@@ -53,8 +67,13 @@ function renderShopPayButton(options) {
 	return `<${SHOP_PAY_BUTTON_TAG_NAME}${attributes ? ` ${attributes}` : ""}>${content}</${SHOP_PAY_BUTTON_TAG_NAME}>`;
 }
 /**
-* Creates the Shop Pay button as a detached DOM element. The returned element
-* carries the button styles with it.
+* Creates a Shop Pay button element in the browser. Append the element to the page.
+*
+* The function requires a DOM. Use `renderShopPayButton` during server rendering.
+*
+* @param options The variants, checkout URL, and display settings for the button.
+* @returns The Shop Pay button element, ready to append to the page.
+* @publicDocs
 */
 function createShopPayButton(options) {
 	defineShopPayButton();
@@ -72,7 +91,14 @@ function initializeShopPayButtonElement(element, options) {
 	}
 	renderShopPayButtonShadowRoot(shadowRoot, options);
 }
-/** Registers the Shop Pay custom element. No-ops during SSR or when already registered. */
+/**
+* Registers the Shop Pay button custom element in the browser. Call the function when you use the `hydrogen-shop-pay-button` tag directly on a framework without a Hydrogen binding.
+*
+* The Hydrogen Shop Pay components, `createShopPayButton`, and `renderShopPayButton` register the element for you. The function does nothing during server rendering or when the browser already has the element.
+*
+* @returns Nothing.
+* @publicDocs
+*/
 function defineShopPayButton() {
 	if (typeof customElements === "undefined" || typeof HTMLElement === "undefined" || customElements.get("hydrogen-shop-pay-button")) return;
 	customElements.define(SHOP_PAY_BUTTON_TAG_NAME, class extends HTMLElement {

package/dist/core/shop-pay/shop-pay.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"shop-pay.mjs","names":["#connected"],"sources":["../../../src/core/shop-pay/shop-pay.ts"],"sourcesContent":["import { normalizeStoreDomain } from \"../url\";\nimport { parseGid } from \"../utils/parse-gid\";\n\nconst DEFAULT_SOURCE = \"hydrogen\";\nconst DEFAULT_ACCESSIBILITY_LABEL = \"Buy with Shop Pay\";\nconst ERROR_PREFIX = \"[hydrogen:error:ShopPay]\";\nconst CAN_USE_DOM = typeof document !== \"undefined\";\nexport const SHOP_PAY_BUTTON_TAG_NAME = \"hydrogen-shop-pay-button\";\nexport const SHOP_PAY_BUTTON_CLASS_NAME = \"shop-pay-button\";\nconst SHOP_PAY_BUTTON_OBSERVED_ATTRIBUTES = [\n  \"accessibility-label\",\n  \"border-radius\",\n  \"channel\",\n  \"checkout-url\",\n  \"disabled\",\n  \"nonce\",\n  \"payment-option\",\n  \"source\",\n  \"source-token\",\n  \"variants\",\n  \"width\",\n] as const;\n\n/** Button styles matching the hosted shop-js pay button. */\nexport const SHOP_PAY_BUTTON_STYLES =\n  `:host{display:block}` +\n  `.${SHOP_PAY_BUTTON_CLASS_NAME}{position:relative;display:flex;align-items:center;box-sizing:border-box;margin:0;padding:10px 16px;overflow:visible;width:260px;border:none;border-radius:12px;background-color:#5433eb;color:#fff;cursor:pointer;text-decoration:none;transition:all .15s cubic-bezier(.4,0,.2,1)}` +\n  `.${SHOP_PAY_BUTTON_CLASS_NAME}:hover{background-color:#4524db}` +\n  `.${SHOP_PAY_BUTTON_CLASS_NAME}:focus-visible{outline:none;box-shadow:0 0 0 3px #9c83f8}` +\n  `.${SHOP_PAY_BUTTON_CLASS_NAME}[aria-disabled=true]{opacity:.5;pointer-events:none;cursor:default}` +\n  `.${SHOP_PAY_BUTTON_CLASS_NAME}__logo{position:relative;display:inline-block;margin:0 auto;width:88px;height:auto}`;\n\nconst SHOP_PAY_LOGO_SVG =\n  `<svg class=\"${SHOP_PAY_BUTTON_CLASS_NAME}__logo\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 99 25\" aria-hidden=\"true\" focusable=\"false\">` +\n  '<path fill=\"currentColor\" d=\"M70.842 7.915h2.25c1.561 0 2.328.642 2.328 1.715 0 1.074-.739 1.715-2.259 1.715h-2.32v-3.43ZM80.525 16.142c-.879 0-1.227-.474-1.227-.948 0-.642.725-.935 2.147-1.102l1.115-.125c-.07 1.227-.892 2.175-2.035 2.175Z\"/>' +\n  '<path fill=\"currentColor\" fill-rule=\"evenodd\" d=\"M65.645.5a3.64 3.64 0 0 0-3.64 3.64V20.7a3.64 3.64 0 0 0 3.64 3.64h29.668a3.64 3.64 0 0 0 3.64-3.64V4.14A3.64 3.64 0 0 0 95.314.5H65.645Zm5.197 16.674v-4.197h2.64c2.412 0 3.695-1.353 3.695-3.402 0-2.05-1.283-3.277-3.695-3.277h-4.341v10.876h1.7Zm9.334.223c1.297 0 2.147-.572 2.538-1.548.112 1.088.767 1.645 2.189 1.269l.014-1.157c-.572.055-.683-.154-.683-.753v-2.845c0-1.673-1.102-2.663-3.138-2.663-2.008 0-3.165 1.004-3.165 2.705h1.562c0-.809.572-1.297 1.576-1.297 1.06 0 1.547.46 1.534 1.255v.363l-1.8.195c-2.021.223-3.137.99-3.137 2.329 0 1.101.781 2.147 2.51 2.147Zm9.906.32c-.711 1.73-1.855 2.245-3.64 2.245h-.766V18.54h.822c.977 0 1.45-.307 1.966-1.185L85.3 9.923h1.757l2.259 5.424 2.008-5.424h1.715l-2.956 7.795Z\" clip-rule=\"evenodd\"/>' +\n  '<path fill=\"currentColor\" d=\"M6.992 11.055c-2.359-.509-3.41-.708-3.41-1.612 0-.85.711-1.274 2.134-1.274 1.25 0 2.165.544 2.839 1.61.05.081.155.11.241.066l2.655-1.335a.186.186 0 0 0 .076-.259c-1.102-1.9-3.137-2.94-5.818-2.94C2.188 5.311 0 7.037 0 9.781c0 2.915 2.664 3.651 5.027 4.16 2.362.51 3.417.709 3.417 1.613s-.769 1.33-2.303 1.33c-1.416 0-2.467-.644-3.102-1.896a.186.186 0 0 0-.251-.082L.14 16.21a.188.188 0 0 0-.083.253c1.051 2.102 3.207 3.285 6.087 3.285 3.668 0 5.885-1.698 5.885-4.527 0-2.83-2.677-3.651-5.037-4.16v-.007ZM21.218 5.311c-1.505 0-2.835.531-3.791 1.477-.06.057-.159.015-.159-.067V.687A.185.185 0 0 0 17.081.5h-3.322a.185.185 0 0 0-.187.187v18.73c0 .104.083.186.187.186h3.322a.185.185 0 0 0 .187-.186V11.2c0-1.587 1.223-2.804 2.87-2.804 1.649 0 2.843 1.191 2.843 2.804v8.216c0 .104.082.186.187.186h3.322a.185.185 0 0 0 .187-.186V11.2c0-3.452-2.274-5.89-5.459-5.89ZM33.415 4.774c-1.803 0-3.493.55-4.706 1.343a.186.186 0 0 0-.06.25l1.464 2.488c.054.089.168.12.257.066a5.853 5.853 0 0 1 3.052-.834c2.899 0 5.03 2.036 5.03 4.726 0 2.292-1.706 3.99-3.868 3.99-1.762 0-2.985-1.022-2.985-2.463 0-.825.352-1.502 1.27-1.98a.183.183 0 0 0 .073-.258l-1.381-2.327a.187.187 0 0 0-.226-.079c-1.85.683-3.15 2.327-3.15 4.533 0 3.338 2.67 5.83 6.396 5.83 4.35 0 7.478-3 7.478-7.303 0-4.612-3.64-7.982-8.644-7.982ZM51.776 5.283c-1.68 0-3.182.62-4.277 1.707a.093.093 0 0 1-.16-.066v-1.31a.185.185 0 0 0-.187-.186h-3.235a.185.185 0 0 0-.188.187v18.702c0 .104.083.186.188.186h3.32a.185.185 0 0 0 .188-.186v-6.133c0-.082.099-.123.16-.07 1.091 1.012 2.536 1.603 4.19 1.603 3.897 0 6.936-3.139 6.936-7.217 0-4.078-3.042-7.217-6.935-7.217Zm-.63 11.266c-2.215 0-3.895-1.754-3.895-4.074S48.928 8.4 51.147 8.4c2.22 0 3.893 1.726 3.893 4.075 0 2.348-1.651 4.074-3.896 4.074h.003Z\"/>' +\n  \"</svg>\";\n\ntype ShopPayButtonBaseOptions = {\n  /**\n   * Absolute checkout base URL. Omit it to emit same-origin `/checkout` and\n   * `/cart` permalink paths, which `handleShopifyRoutes` redirects to the\n   * store's real checkout.\n   */\n  checkoutUrl?: string;\n  /**\n   * Checkout payment mode. Defaults to `\"shop_pay\"`. Use\n   * `\"shop_pay_installments\"` only when the checkout path should open Shop Pay\n   * Installments.\n   */\n  paymentOption?: \"shop_pay\" | \"shop_pay_installments\";\n  /**\n   * Attribution source appended to the checkout URL as `source`. Defaults to\n   * `\"hydrogen\"`. Most storefronts should not override this.\n   */\n  source?: string;\n  /**\n   * Optional attribution token appended to the checkout URL as `source_token`.\n   * Only pass a value when Shopify has provided one for the integration.\n   */\n  sourceToken?: string;\n  /**\n   * Content Security Policy nonce applied to the shadow root's inline style.\n   */\n  nonce?: string;\n  /**\n   * Sales channel that issued the Storefront API token. Omit it unless checkout\n   * needs explicit `\"headless\"` or `\"hydrogen\"` attribution.\n   */\n  channel?: \"headless\" | \"hydrogen\";\n  /**\n   * Disables the button. Disabled buttons render without an `href` and include\n   * `aria-disabled=\"true\"`.\n   */\n  disabled?: boolean;\n  /**\n   * CSS width for the rendered anchor, for example `\"100%\"`. Omit it to use\n   * the Shop Pay default width.\n   */\n  width?: string;\n  /**\n   * CSS border radius for the rendered anchor, for example `\"8px\"`. Omit it to\n   * use the Shop Pay default radius.\n   */\n  borderRadius?: string;\n  /**\n   * Localized accessible label for the Shop Pay logo. Defaults to `\"Buy with Shop Pay\"`.\n   * Never translate the brand name `\"Shop Pay\"`; keep it in Latin script in every locale.\n   *\n   * @example English\n   * `\"Buy with Shop Pay\"`\n   *\n   * @example Japanese\n   * `\"Shop Payで購入\"`\n   *\n   * @example Hindi\n   * `\"Shop Pay से खरीदें\"`\n   *\n   * @example Arabic\n   * `\"الشراء باستخدام Shop Pay\"`\n   */\n  accessibilityLabel?: string;\n};\n\ntype ShopPayVariantWithQuantity = {\n  /** ProductVariant GID or bare numeric ProductVariant ID. Product IDs are invalid. */\n  id: string;\n  /** Quantity for this variant. Defaults to `1`. */\n  quantity?: number;\n};\n\ntype ShopPayVariant = string | ShopPayVariantWithQuantity;\ntype ShopPayVariants = readonly string[] | readonly ShopPayVariantWithQuantity[];\n\nexport type ShopPayButtonOptions = ShopPayButtonBaseOptions & {\n  /**\n   * Variants to check out immediately via a Shopify cart permalink. Omit this\n   * for cart checkout mode, where `/checkout` checks out the current cart.\n   */\n  variants?: ShopPayVariants;\n};\n\n/**\n * Builds the checkout URL the Shop Pay button navigates to, or `null` when the\n * button is disabled. Variant mode produces a cart permalink; otherwise the\n * current cart checks out.\n */\nexport function getShopPayButtonUrl(options: ShopPayButtonOptions): string | null {\n  if (options.disabled) return null;\n\n  const variants = getShopPayVariants(options);\n\n  if (!options.checkoutUrl) {\n    const search = getShopPaySearchParams(options);\n    return `${variants ? `/cart/${variants}` : \"/checkout\"}?${search}`;\n  }\n\n  const url = variants\n    ? getShopPayVariantModeUrl(options.checkoutUrl, variants)\n    : getShopPayCheckoutModeUrl(options.checkoutUrl);\n\n  for (const [name, value] of getShopPaySearchParams(options)) {\n    url.searchParams.set(name, value);\n  }\n\n  return url.toString();\n}\n\n/**\n * Renders the Shop Pay button as an HTML string: a self-contained wrapper\n * element carrying the styles and anchor it needs to work without client\n * JavaScript. Use it from server templates or frameworks without a Hydrogen\n * binding.\n */\nexport function renderShopPayButton(options: ShopPayButtonOptions): string {\n  defineShopPayButton();\n  const attributes = serializeAttributes(getShopPayButtonElementAttributes(options));\n  const content = CAN_USE_DOM ? \"\" : getShopPayButtonDeclarativeShadowDomHtml(options);\n  return `<${SHOP_PAY_BUTTON_TAG_NAME}${attributes ? ` ${attributes}` : \"\"}>${content}</${SHOP_PAY_BUTTON_TAG_NAME}>`;\n}\n\n/**\n * Creates the Shop Pay button as a detached DOM element. The returned element\n * carries the button styles with it.\n */\nexport function createShopPayButton(options: ShopPayButtonOptions): HTMLElement {\n  defineShopPayButton();\n  const element = document.createElement(SHOP_PAY_BUTTON_TAG_NAME);\n  initializeShopPayButtonElement(element, options);\n\n  return element;\n}\n\nexport function initializeShopPayButtonElement(\n  element: HTMLElement,\n  options: ShopPayButtonOptions,\n): void {\n  syncShopPayButtonElementAttributes(element, getShopPayButtonElementAttributes(options));\n\n  const shadowRoot = element.shadowRoot ?? element.attachShadow({ mode: \"open\" });\n  const template = element.querySelector(\"template[shadowrootmode]\");\n\n  if (template instanceof HTMLTemplateElement) {\n    shadowRoot.append(template.content.cloneNode(true));\n    template.remove();\n  }\n\n  renderShopPayButtonShadowRoot(shadowRoot, options);\n}\n\n/** Registers the Shop Pay custom element. No-ops during SSR or when already registered. */\nexport function defineShopPayButton(): void {\n  if (\n    typeof customElements === \"undefined\" ||\n    typeof HTMLElement === \"undefined\" ||\n    customElements.get(SHOP_PAY_BUTTON_TAG_NAME)\n  ) {\n    return;\n  }\n\n  customElements.define(\n    SHOP_PAY_BUTTON_TAG_NAME,\n    class extends HTMLElement {\n      #connected = false;\n\n      static observedAttributes = SHOP_PAY_BUTTON_OBSERVED_ATTRIBUTES;\n\n      connectedCallback(): void {\n        this.#connected = true;\n        initializeShopPayButtonElement(this, getShopPayButtonOptions(this));\n      }\n\n      attributeChangedCallback(): void {\n        if (!this.#connected || !this.shadowRoot) return;\n        renderShopPayButtonShadowRoot(this.shadowRoot, getShopPayButtonOptions(this));\n      }\n    },\n  );\n}\n\n/** Anchor attributes shared by server and browser shadow-root rendering. */\nexport function getShopPayButtonAnchorAttributes(\n  options: ShopPayButtonOptions,\n): Record<string, string> {\n  const attributes: Record<string, string> = {\n    class: SHOP_PAY_BUTTON_CLASS_NAME,\n    target: \"_self\",\n  };\n\n  const href = getShopPayButtonUrl(options);\n  if (href) {\n    attributes.href = href;\n  } else {\n    attributes.role = \"link\";\n    attributes[\"aria-disabled\"] = \"true\";\n  }\n\n  const style = serializeStyleProperties(getShopPayButtonStyleProperties(options));\n  if (style) attributes.style = style;\n\n  attributes[\"aria-label\"] = getShopPayAccessibilityLabel(options.accessibilityLabel);\n\n  return attributes;\n}\n\nexport function getShopPayButtonElementContentHtml(options: ShopPayButtonOptions): string {\n  return `<style${getShopPayButtonStyleNonceAttribute(options)}>${SHOP_PAY_BUTTON_STYLES}</style><a ${serializeAttributes(getShopPayButtonAnchorAttributes(options))}>${getShopPayButtonContentHtml()}</a>`;\n}\n\nexport function getShopPayButtonDeclarativeShadowDomHtml(options: ShopPayButtonOptions): string {\n  return `<template shadowrootmode=\"open\" shadowroot=\"open\">${getShopPayButtonElementContentHtml(options)}</template>`;\n}\n\nexport function getShopPayButtonElementAttributes(\n  options: ShopPayButtonOptions,\n): Record<string, string> {\n  const attributes: Record<string, string> = {};\n  const variants = getShopPayVariants(options);\n\n  if (hasContent(options.accessibilityLabel)) {\n    attributes[\"accessibility-label\"] = options.accessibilityLabel.trim();\n  }\n  if (hasContent(options.borderRadius)) {\n    attributes[\"border-radius\"] = normalizeCssValue(\"borderRadius\", options.borderRadius);\n  }\n  if (options.channel) attributes.channel = options.channel;\n  if (options.checkoutUrl !== undefined) attributes[\"checkout-url\"] = options.checkoutUrl;\n  if (options.disabled) attributes.disabled = \"\";\n  if (hasContent(options.nonce)) attributes.nonce = options.nonce.trim();\n  if (options.paymentOption) attributes[\"payment-option\"] = options.paymentOption;\n  if (options.source !== undefined) attributes.source = options.source;\n  if (options.sourceToken !== undefined) attributes[\"source-token\"] = options.sourceToken;\n  if (variants) attributes.variants = variants;\n  if (hasContent(options.width)) {\n    attributes.width = normalizeCssValue(\"width\", options.width);\n  }\n\n  return attributes;\n}\n\n/** Inner HTML for the shadow root's anchor. */\nexport function getShopPayButtonContentHtml(): string {\n  return SHOP_PAY_LOGO_SVG;\n}\n\nfunction getShopPayButtonStyleProperties(\n  options: Pick<ShopPayButtonOptions, \"width\" | \"borderRadius\">,\n): Record<string, string> {\n  const style: Record<string, string> = {};\n\n  if (hasContent(options.width)) style.width = normalizeCssValue(\"width\", options.width);\n  if (hasContent(options.borderRadius)) {\n    style.borderRadius = normalizeCssValue(\"borderRadius\", options.borderRadius);\n  }\n\n  return style;\n}\n\nfunction getShopPaySearchParams(options: ShopPayButtonOptions): URLSearchParams {\n  const params = new URLSearchParams();\n  params.set(\"payment\", options.paymentOption ?? \"shop_pay\");\n\n  const source = options.source ?? DEFAULT_SOURCE;\n  if (source) params.set(\"source\", source);\n  if (options.sourceToken) params.set(\"source_token\", options.sourceToken);\n  if (options.channel) params.set(\"channel\", options.channel);\n\n  return params;\n}\n\nfunction getShopPayCheckoutModeUrl(checkoutUrl: string): URL {\n  const url = parseCheckoutUrl(checkoutUrl);\n  if (url.pathname === \"/\") url.pathname = \"/checkout\";\n  url.hash = \"\";\n  return url;\n}\n\nfunction getShopPayVariantModeUrl(checkoutUrl: string, variants: string): URL {\n  const url = parseCheckoutUrl(checkoutUrl);\n  url.pathname = `/cart/${variants}`;\n  url.hash = \"\";\n  return url;\n}\n\nfunction parseCheckoutUrl(checkoutUrl: string): URL {\n  try {\n    return new URL(normalizeStoreDomain(checkoutUrl.trim()));\n  } catch {\n    throw shopPayError('Shop Pay requires a valid \"checkoutUrl\" value.');\n  }\n}\n\nfunction getShopPayVariants(options: ShopPayButtonOptions): string | undefined {\n  const variantsInput: readonly ShopPayVariant[] | undefined = options.variants;\n\n  if (!Array.isArray(variantsInput) || variantsInput.length === 0) return undefined;\n\n  if (variantsInput.every(isVariantId)) {\n    return variantsInput.map((id) => `${normalizeVariantId(id)}:1`).join(\",\");\n  }\n\n  if (variantsInput.every(isVariantWithQuantity)) {\n    return variantsInput\n      .map(({ id, quantity }) => {\n        return `${normalizeVariantId(id)}:${normalizeQuantity(quantity)}`;\n      })\n      .join(\",\");\n  }\n\n  throw shopPayError(\n    \"Shop Pay variants must be either variant IDs or objects with an id and quantity.\",\n  );\n}\n\nfunction isVariantId(variant: ShopPayVariant): variant is string {\n  return typeof variant === \"string\";\n}\n\nfunction getShopPayButtonOptions(element: HTMLElement): ShopPayButtonOptions {\n  return {\n    accessibilityLabel: element.getAttribute(\"accessibility-label\") ?? undefined,\n    borderRadius: element.getAttribute(\"border-radius\") ?? undefined,\n    channel: parseChannel(element.getAttribute(\"channel\")),\n    checkoutUrl: element.getAttribute(\"checkout-url\") ?? undefined,\n    disabled: element.hasAttribute(\"disabled\"),\n    nonce: element.nonce || element.getAttribute(\"nonce\") || undefined,\n    paymentOption: parsePaymentOption(element.getAttribute(\"payment-option\")),\n    source: element.getAttribute(\"source\") ?? undefined,\n    sourceToken: element.getAttribute(\"source-token\") ?? undefined,\n    variants: parseVariantsAttribute(element.getAttribute(\"variants\")),\n    width: element.getAttribute(\"width\") ?? undefined,\n  };\n}\n\nfunction parseVariantsAttribute(value: string | null): ShopPayVariants | undefined {\n  if (!value) return undefined;\n\n  return value.split(\",\").map((entry) => {\n    const [id = \"\", quantity] = entry.split(\":\");\n    return { id, quantity: quantity === undefined ? undefined : Number(quantity) };\n  });\n}\n\nfunction parsePaymentOption(value: string | null): ShopPayButtonOptions[\"paymentOption\"] {\n  return value === \"shop_pay\" || value === \"shop_pay_installments\" ? value : undefined;\n}\n\nfunction parseChannel(value: string | null): ShopPayButtonOptions[\"channel\"] {\n  return value === \"headless\" || value === \"hydrogen\" ? value : undefined;\n}\n\nfunction renderShopPayButtonShadowRoot(\n  shadowRoot: ShadowRoot,\n  options: ShopPayButtonOptions,\n): void {\n  let style = shadowRoot.querySelector(\"style\");\n  if (!(style instanceof HTMLStyleElement)) {\n    style = shadowRoot.ownerDocument.createElement(\"style\");\n    shadowRoot.prepend(style);\n  }\n\n  const nextNonce = hasContent(options.nonce) ? options.nonce.trim() : undefined;\n  const nonceChanged = (style.nonce || undefined) !== nextNonce;\n  if (nextNonce) {\n    style.nonce = nextNonce;\n  } else {\n    style.removeAttribute(\"nonce\");\n  }\n  if (nonceChanged) style.textContent = \"\";\n  if (style.textContent !== SHOP_PAY_BUTTON_STYLES) style.textContent = SHOP_PAY_BUTTON_STYLES;\n\n  let anchor = shadowRoot.querySelector(\"a\");\n  if (!(anchor instanceof HTMLAnchorElement)) {\n    anchor = shadowRoot.ownerDocument.createElement(\"a\");\n    shadowRoot.append(anchor);\n  }\n\n  syncAttributes(anchor, getShopPayButtonAnchorAttributes(options));\n  const content = getShopPayButtonContentHtml();\n  if (anchor.innerHTML !== content) anchor.innerHTML = content;\n}\n\nfunction syncAttributes(element: Element, attributes: Record<string, string>): void {\n  for (const name of element.getAttributeNames()) {\n    if (!(name in attributes)) element.removeAttribute(name);\n  }\n\n  for (const [name, value] of Object.entries(attributes)) {\n    if (element.getAttribute(name) !== value) element.setAttribute(name, value);\n  }\n}\n\nfunction syncShopPayButtonElementAttributes(\n  element: Element,\n  attributes: Record<string, string>,\n): void {\n  for (const name of SHOP_PAY_BUTTON_OBSERVED_ATTRIBUTES) {\n    if (!(name in attributes)) element.removeAttribute(name);\n  }\n\n  for (const [name, value] of Object.entries(attributes)) {\n    if (element.getAttribute(name) !== value) element.setAttribute(name, value);\n  }\n}\n\nfunction isVariantWithQuantity(\n  variant: ShopPayVariant | undefined,\n): variant is ShopPayVariantWithQuantity {\n  return typeof variant === \"object\" && variant !== null && typeof variant.id === \"string\";\n}\n\nfunction normalizeVariantId(id: string): string {\n  const parsed = parseGid(id);\n  const bareId = parsed.id || id.trim();\n\n  if (parsed.resource && parsed.resource !== \"ProductVariant\") {\n    throw shopPayError(\n      \"Shop Pay variant IDs must be Shopify ProductVariant GIDs or bare numeric variant IDs.\",\n    );\n  }\n\n  if (/^\\d+$/.test(bareId)) return bareId;\n\n  throw shopPayError(\n    \"Shop Pay variant IDs must be Shopify ProductVariant GIDs or bare numeric variant IDs.\",\n  );\n}\n\nfunction normalizeQuantity(quantity = 1): number {\n  if (!Number.isInteger(quantity) || quantity < 1) {\n    throw shopPayError(\"Shop Pay variant quantities must be positive integers.\");\n  }\n\n  return quantity;\n}\n\nfunction escapeText(value: string): string {\n  return value.replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\");\n}\n\nfunction escapeAttribute(value: string): string {\n  return escapeText(value).replace(/\"/g, \"&quot;\");\n}\n\nfunction getShopPayAccessibilityLabel(label: string | undefined): string {\n  return hasContent(label) ? label.trim() : DEFAULT_ACCESSIBILITY_LABEL;\n}\n\nfunction getShopPayButtonStyleNonceAttribute(options: Pick<ShopPayButtonOptions, \"nonce\">): string {\n  return hasContent(options.nonce) ? ` nonce=\"${escapeAttribute(options.nonce.trim())}\"` : \"\";\n}\n\nfunction hasContent(value: string | undefined): value is string {\n  return typeof value === \"string\" && value.trim() !== \"\";\n}\n\nfunction normalizeCssValue(name: \"width\" | \"borderRadius\", value: string): string {\n  const normalized = value.trim();\n  if (/[;{}]/.test(normalized)) {\n    throw shopPayError(`Shop Pay ${name} must be a single CSS value.`);\n  }\n  return normalized;\n}\n\nfunction serializeAttributes(attributes: Record<string, string>): string {\n  return Object.entries(attributes)\n    .map(([name, value]) => `${name}=\"${escapeAttribute(value)}\"`)\n    .join(\" \");\n}\n\nfunction serializeStyleProperties(style: Record<string, string>): string {\n  return Object.entries(style)\n    .map(([name, value]) => `${hyphenateStyleName(name)}:${value}`)\n    .join(\";\");\n}\n\nfunction hyphenateStyleName(name: string): string {\n  return name.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`);\n}\n\nfunction shopPayError(message: string): Error {\n  return new Error(`${ERROR_PREFIX} ${message}`);\n}\n"],"mappings":"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"}
+{"version":3,"file":"shop-pay.mjs","names":["#connected"],"sources":["../../../src/core/shop-pay/shop-pay.ts"],"sourcesContent":["import { normalizeStoreDomain } from \"../url\";\nimport { parseGid } from \"../utils/parse-gid\";\n\nconst DEFAULT_SOURCE = \"hydrogen\";\nconst DEFAULT_ACCESSIBILITY_LABEL = \"Buy with Shop Pay\";\nconst ERROR_PREFIX = \"[hydrogen:error:ShopPay]\";\nconst CAN_USE_DOM = typeof document !== \"undefined\";\n/**\n * Tag name of the Shop Pay button custom element, `hydrogen-shop-pay-button`.\n *\n * Use the tag directly on a framework without a Hydrogen binding.\n *\n * @publicDocs\n */\nexport const SHOP_PAY_BUTTON_TAG_NAME = \"hydrogen-shop-pay-button\";\nexport const SHOP_PAY_BUTTON_CLASS_NAME = \"shop-pay-button\";\nconst SHOP_PAY_BUTTON_OBSERVED_ATTRIBUTES = [\n  \"accessibility-label\",\n  \"border-radius\",\n  \"channel\",\n  \"checkout-url\",\n  \"disabled\",\n  \"nonce\",\n  \"payment-option\",\n  \"source\",\n  \"source-token\",\n  \"variants\",\n  \"width\",\n] as const;\n\n/** Button styles matching the hosted shop-js pay button. */\nexport const SHOP_PAY_BUTTON_STYLES =\n  `:host{display:block}` +\n  `.${SHOP_PAY_BUTTON_CLASS_NAME}{position:relative;display:flex;align-items:center;box-sizing:border-box;margin:0;padding:10px 16px;overflow:visible;width:260px;border:none;border-radius:12px;background-color:#5433eb;color:#fff;cursor:pointer;text-decoration:none;transition:all .15s cubic-bezier(.4,0,.2,1)}` +\n  `.${SHOP_PAY_BUTTON_CLASS_NAME}:hover{background-color:#4524db}` +\n  `.${SHOP_PAY_BUTTON_CLASS_NAME}:focus-visible{outline:none;box-shadow:0 0 0 3px #9c83f8}` +\n  `.${SHOP_PAY_BUTTON_CLASS_NAME}[aria-disabled=true]{opacity:.5;pointer-events:none;cursor:default}` +\n  `.${SHOP_PAY_BUTTON_CLASS_NAME}__logo{position:relative;display:inline-block;margin:0 auto;width:88px;height:auto}`;\n\nconst SHOP_PAY_LOGO_SVG =\n  `<svg class=\"${SHOP_PAY_BUTTON_CLASS_NAME}__logo\" xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 99 25\" aria-hidden=\"true\" focusable=\"false\">` +\n  '<path fill=\"currentColor\" d=\"M70.842 7.915h2.25c1.561 0 2.328.642 2.328 1.715 0 1.074-.739 1.715-2.259 1.715h-2.32v-3.43ZM80.525 16.142c-.879 0-1.227-.474-1.227-.948 0-.642.725-.935 2.147-1.102l1.115-.125c-.07 1.227-.892 2.175-2.035 2.175Z\"/>' +\n  '<path fill=\"currentColor\" fill-rule=\"evenodd\" d=\"M65.645.5a3.64 3.64 0 0 0-3.64 3.64V20.7a3.64 3.64 0 0 0 3.64 3.64h29.668a3.64 3.64 0 0 0 3.64-3.64V4.14A3.64 3.64 0 0 0 95.314.5H65.645Zm5.197 16.674v-4.197h2.64c2.412 0 3.695-1.353 3.695-3.402 0-2.05-1.283-3.277-3.695-3.277h-4.341v10.876h1.7Zm9.334.223c1.297 0 2.147-.572 2.538-1.548.112 1.088.767 1.645 2.189 1.269l.014-1.157c-.572.055-.683-.154-.683-.753v-2.845c0-1.673-1.102-2.663-3.138-2.663-2.008 0-3.165 1.004-3.165 2.705h1.562c0-.809.572-1.297 1.576-1.297 1.06 0 1.547.46 1.534 1.255v.363l-1.8.195c-2.021.223-3.137.99-3.137 2.329 0 1.101.781 2.147 2.51 2.147Zm9.906.32c-.711 1.73-1.855 2.245-3.64 2.245h-.766V18.54h.822c.977 0 1.45-.307 1.966-1.185L85.3 9.923h1.757l2.259 5.424 2.008-5.424h1.715l-2.956 7.795Z\" clip-rule=\"evenodd\"/>' +\n  '<path fill=\"currentColor\" d=\"M6.992 11.055c-2.359-.509-3.41-.708-3.41-1.612 0-.85.711-1.274 2.134-1.274 1.25 0 2.165.544 2.839 1.61.05.081.155.11.241.066l2.655-1.335a.186.186 0 0 0 .076-.259c-1.102-1.9-3.137-2.94-5.818-2.94C2.188 5.311 0 7.037 0 9.781c0 2.915 2.664 3.651 5.027 4.16 2.362.51 3.417.709 3.417 1.613s-.769 1.33-2.303 1.33c-1.416 0-2.467-.644-3.102-1.896a.186.186 0 0 0-.251-.082L.14 16.21a.188.188 0 0 0-.083.253c1.051 2.102 3.207 3.285 6.087 3.285 3.668 0 5.885-1.698 5.885-4.527 0-2.83-2.677-3.651-5.037-4.16v-.007ZM21.218 5.311c-1.505 0-2.835.531-3.791 1.477-.06.057-.159.015-.159-.067V.687A.185.185 0 0 0 17.081.5h-3.322a.185.185 0 0 0-.187.187v18.73c0 .104.083.186.187.186h3.322a.185.185 0 0 0 .187-.186V11.2c0-1.587 1.223-2.804 2.87-2.804 1.649 0 2.843 1.191 2.843 2.804v8.216c0 .104.082.186.187.186h3.322a.185.185 0 0 0 .187-.186V11.2c0-3.452-2.274-5.89-5.459-5.89ZM33.415 4.774c-1.803 0-3.493.55-4.706 1.343a.186.186 0 0 0-.06.25l1.464 2.488c.054.089.168.12.257.066a5.853 5.853 0 0 1 3.052-.834c2.899 0 5.03 2.036 5.03 4.726 0 2.292-1.706 3.99-3.868 3.99-1.762 0-2.985-1.022-2.985-2.463 0-.825.352-1.502 1.27-1.98a.183.183 0 0 0 .073-.258l-1.381-2.327a.187.187 0 0 0-.226-.079c-1.85.683-3.15 2.327-3.15 4.533 0 3.338 2.67 5.83 6.396 5.83 4.35 0 7.478-3 7.478-7.303 0-4.612-3.64-7.982-8.644-7.982ZM51.776 5.283c-1.68 0-3.182.62-4.277 1.707a.093.093 0 0 1-.16-.066v-1.31a.185.185 0 0 0-.187-.186h-3.235a.185.185 0 0 0-.188.187v18.702c0 .104.083.186.188.186h3.32a.185.185 0 0 0 .188-.186v-6.133c0-.082.099-.123.16-.07 1.091 1.012 2.536 1.603 4.19 1.603 3.897 0 6.936-3.139 6.936-7.217 0-4.078-3.042-7.217-6.935-7.217Zm-.63 11.266c-2.215 0-3.895-1.754-3.895-4.074S48.928 8.4 51.147 8.4c2.22 0 3.893 1.726 3.893 4.075 0 2.348-1.651 4.074-3.896 4.074h.003Z\"/>' +\n  \"</svg>\";\n\n/** Checkout target, attribution, and display settings shared by every Shop Pay button. */\ntype ShopPayButtonBaseOptions = {\n  /**\n   * Absolute checkout base URL. Omit the URL to link to the same-origin `/checkout` and\n   * `/cart` permalink paths, which Hydrogen's Shopify route handler redirects to the\n   * store's checkout.\n   *\n   * Pass the cart's checkout URL when your app doesn't send same-origin checkout paths through the Shopify route handler. The button URL keeps the query params of the checkout URL, replaces any params that Shop Pay sets, and drops the hash. A bare domain such as `my-store.myshopify.com` gets an HTTPS scheme. The Shop Pay functions throw an error when the value isn't a valid URL.\n   */\n  checkoutUrl?: string;\n  /**\n   * Checkout payment mode. Defaults to `shop_pay`. Use\n   * `shop_pay_installments` to open Shop Pay Installments at checkout.\n   */\n  paymentOption?: \"shop_pay\" | \"shop_pay_installments\";\n  /**\n   * Attribution source that the checkout URL carries as `source`.\n   * Defaults to `hydrogen`. Most storefronts shouldn't change the source.\n   */\n  source?: string;\n  /**\n   * Attribution token that the checkout URL carries as `source_token`.\n   */\n  sourceToken?: string;\n  /**\n   * Content Security Policy nonce for the button's style element.\n   *\n   * The nonce covers only the style element. Custom width and border radius values render as an inline style attribute, which a strict Content Security Policy must allow.\n   */\n  nonce?: string;\n  /**\n   * Sales channel that the checkout URL carries as `channel`. Omit the channel unless\n   * checkout needs explicit `headless` or `hydrogen` attribution.\n   */\n  channel?: \"headless\" | \"hydrogen\";\n  /**\n   * Disables the button. A disabled button renders without an `href` and with\n   * `aria-disabled=\"true\"`.\n   */\n  disabled?: boolean;\n  /**\n   * CSS width of the button, such as `100%`. Defaults to `260px`.\n   *\n   * Pass a single CSS value. The Shop Pay functions throw an error when the width contains a semicolon or a curly brace.\n   */\n  width?: string;\n  /**\n   * CSS border radius of the button, such as `8px`. Defaults to `12px`.\n   *\n   * Pass a single CSS value. The Shop Pay functions throw an error when the radius contains a semicolon or a curly brace.\n   */\n  borderRadius?: string;\n  /**\n   * Localized accessible label for the button. Defaults to `\"Buy with Shop Pay\"`.\n   * Keep the brand name Shop Pay untranslated and in Latin script in every locale.\n   *\n   * @example English\n   * `\"Buy with Shop Pay\"`\n   *\n   * @example Japanese\n   * `\"Shop Payで購入\"`\n   *\n   * @example Hindi\n   * `\"Shop Pay से खरीदें\"`\n   *\n   * @example Arabic\n   * `\"الشراء باستخدام Shop Pay\"`\n   */\n  accessibilityLabel?: string;\n};\n\n/** A variant ID and an optional quantity for a Shop Pay checkout. */\ntype ShopPayVariantWithQuantity = {\n  /** Product variant GID or numeric variant ID. Product IDs throw an error. */\n  id: string;\n  /** Quantity of the variant. Defaults to `1`. */\n  quantity?: number;\n};\n\ntype ShopPayVariant = string | ShopPayVariantWithQuantity;\n/** Variants for a Shop Pay checkout, as all ID strings or all objects with an ID and a quantity. */\ntype ShopPayVariants = readonly string[] | readonly ShopPayVariantWithQuantity[];\n\n/** Checkout target, variants, attribution, and display settings for a Shop Pay button. */\nexport interface ShopPayButtonOptions extends ShopPayButtonBaseOptions {\n  /**\n   * Variants that the customer buys right away through a Shopify cart permalink. Omit the variants\n   * to check out the current cart.\n   *\n   * Pass either all variant ID strings or all objects with an `id` and an optional `quantity`. Each quantity must be a positive integer. The Shop Pay functions throw an error for product IDs, non-numeric variant IDs, invalid quantities, and mixed formats.\n   */\n  variants?: ShopPayVariants;\n}\n\n/**\n * Returns the checkout URL for a Shop Pay button. Use the URL to build your own Shop Pay link.\n *\n * With variants, the URL is a cart permalink that checks out those variants. Without variants, the URL checks out the current cart.\n *\n * @param options The variants, checkout URL, payment mode, attribution, and disabled state for the checkout URL.\n * @returns The checkout URL, or `null` when `disabled` is `true`.\n * @publicDocs\n */\nexport function getShopPayButtonUrl(options: ShopPayButtonOptions): string | null {\n  if (options.disabled) return null;\n\n  const variants = getShopPayVariants(options);\n\n  if (!options.checkoutUrl) {\n    const search = getShopPaySearchParams(options);\n    return `${variants ? `/cart/${variants}` : \"/checkout\"}?${search}`;\n  }\n\n  const url = variants\n    ? getShopPayVariantModeUrl(options.checkoutUrl, variants)\n    : getShopPayCheckoutModeUrl(options.checkoutUrl);\n\n  for (const [name, value] of getShopPaySearchParams(options)) {\n    url.searchParams.set(name, value);\n  }\n\n  return url.toString();\n}\n\n/**\n * Returns the Shop Pay button as an HTML string for server templates and frameworks without a Hydrogen binding.\n *\n * On the server, the markup includes the button's styles and link, and the button works without client JavaScript. In the browser, the function returns an empty element that renders the button when you add the element to the page.\n *\n * @param options The variants, checkout URL, and display settings for the button.\n * @returns The Shop Pay button markup.\n * @publicDocs\n */\nexport function renderShopPayButton(options: ShopPayButtonOptions): string {\n  defineShopPayButton();\n  const attributes = serializeAttributes(getShopPayButtonElementAttributes(options));\n  const content = CAN_USE_DOM ? \"\" : getShopPayButtonDeclarativeShadowDomHtml(options);\n  return `<${SHOP_PAY_BUTTON_TAG_NAME}${attributes ? ` ${attributes}` : \"\"}>${content}</${SHOP_PAY_BUTTON_TAG_NAME}>`;\n}\n\n/**\n * Creates a Shop Pay button element in the browser. Append the element to the page.\n *\n * The function requires a DOM. Use `renderShopPayButton` during server rendering.\n *\n * @param options The variants, checkout URL, and display settings for the button.\n * @returns The Shop Pay button element, ready to append to the page.\n * @publicDocs\n */\nexport function createShopPayButton(options: ShopPayButtonOptions): HTMLElement {\n  defineShopPayButton();\n  const element = document.createElement(SHOP_PAY_BUTTON_TAG_NAME);\n  initializeShopPayButtonElement(element, options);\n\n  return element;\n}\n\nexport function initializeShopPayButtonElement(\n  element: HTMLElement,\n  options: ShopPayButtonOptions,\n): void {\n  syncShopPayButtonElementAttributes(element, getShopPayButtonElementAttributes(options));\n\n  const shadowRoot = element.shadowRoot ?? element.attachShadow({ mode: \"open\" });\n  const template = element.querySelector(\"template[shadowrootmode]\");\n\n  if (template instanceof HTMLTemplateElement) {\n    shadowRoot.append(template.content.cloneNode(true));\n    template.remove();\n  }\n\n  renderShopPayButtonShadowRoot(shadowRoot, options);\n}\n\n/**\n * Registers the Shop Pay button custom element in the browser. Call the function when you use the `hydrogen-shop-pay-button` tag directly on a framework without a Hydrogen binding.\n *\n * The Hydrogen Shop Pay components, `createShopPayButton`, and `renderShopPayButton` register the element for you. The function does nothing during server rendering or when the browser already has the element.\n *\n * @returns Nothing.\n * @publicDocs\n */\nexport function defineShopPayButton(): void {\n  if (\n    typeof customElements === \"undefined\" ||\n    typeof HTMLElement === \"undefined\" ||\n    customElements.get(SHOP_PAY_BUTTON_TAG_NAME)\n  ) {\n    return;\n  }\n\n  customElements.define(\n    SHOP_PAY_BUTTON_TAG_NAME,\n    class extends HTMLElement {\n      #connected = false;\n\n      static observedAttributes = SHOP_PAY_BUTTON_OBSERVED_ATTRIBUTES;\n\n      connectedCallback(): void {\n        this.#connected = true;\n        initializeShopPayButtonElement(this, getShopPayButtonOptions(this));\n      }\n\n      attributeChangedCallback(): void {\n        if (!this.#connected || !this.shadowRoot) return;\n        renderShopPayButtonShadowRoot(this.shadowRoot, getShopPayButtonOptions(this));\n      }\n    },\n  );\n}\n\n/** Anchor attributes shared by server and browser shadow-root rendering. */\nexport function getShopPayButtonAnchorAttributes(\n  options: ShopPayButtonOptions,\n): Record<string, string> {\n  const attributes: Record<string, string> = {\n    class: SHOP_PAY_BUTTON_CLASS_NAME,\n    target: \"_self\",\n  };\n\n  const href = getShopPayButtonUrl(options);\n  if (href) {\n    attributes.href = href;\n  } else {\n    attributes.role = \"link\";\n    attributes[\"aria-disabled\"] = \"true\";\n  }\n\n  const style = serializeStyleProperties(getShopPayButtonStyleProperties(options));\n  if (style) attributes.style = style;\n\n  attributes[\"aria-label\"] = getShopPayAccessibilityLabel(options.accessibilityLabel);\n\n  return attributes;\n}\n\nexport function getShopPayButtonElementContentHtml(options: ShopPayButtonOptions): string {\n  return `<style${getShopPayButtonStyleNonceAttribute(options)}>${SHOP_PAY_BUTTON_STYLES}</style><a ${serializeAttributes(getShopPayButtonAnchorAttributes(options))}>${getShopPayButtonContentHtml()}</a>`;\n}\n\nexport function getShopPayButtonDeclarativeShadowDomHtml(options: ShopPayButtonOptions): string {\n  return `<template shadowrootmode=\"open\" shadowroot=\"open\">${getShopPayButtonElementContentHtml(options)}</template>`;\n}\n\nexport function getShopPayButtonElementAttributes(\n  options: ShopPayButtonOptions,\n): Record<string, string> {\n  const attributes: Record<string, string> = {};\n  const variants = getShopPayVariants(options);\n\n  if (hasContent(options.accessibilityLabel)) {\n    attributes[\"accessibility-label\"] = options.accessibilityLabel.trim();\n  }\n  if (hasContent(options.borderRadius)) {\n    attributes[\"border-radius\"] = normalizeCssValue(\"borderRadius\", options.borderRadius);\n  }\n  if (options.channel) attributes.channel = options.channel;\n  if (options.checkoutUrl !== undefined) attributes[\"checkout-url\"] = options.checkoutUrl;\n  if (options.disabled) attributes.disabled = \"\";\n  if (hasContent(options.nonce)) attributes.nonce = options.nonce.trim();\n  if (options.paymentOption) attributes[\"payment-option\"] = options.paymentOption;\n  if (options.source !== undefined) attributes.source = options.source;\n  if (options.sourceToken !== undefined) attributes[\"source-token\"] = options.sourceToken;\n  if (variants) attributes.variants = variants;\n  if (hasContent(options.width)) {\n    attributes.width = normalizeCssValue(\"width\", options.width);\n  }\n\n  return attributes;\n}\n\n/** Inner HTML for the shadow root's anchor. */\nexport function getShopPayButtonContentHtml(): string {\n  return SHOP_PAY_LOGO_SVG;\n}\n\nfunction getShopPayButtonStyleProperties(\n  options: Pick<ShopPayButtonOptions, \"width\" | \"borderRadius\">,\n): Record<string, string> {\n  const style: Record<string, string> = {};\n\n  if (hasContent(options.width)) style.width = normalizeCssValue(\"width\", options.width);\n  if (hasContent(options.borderRadius)) {\n    style.borderRadius = normalizeCssValue(\"borderRadius\", options.borderRadius);\n  }\n\n  return style;\n}\n\nfunction getShopPaySearchParams(options: ShopPayButtonOptions): URLSearchParams {\n  const params = new URLSearchParams();\n  params.set(\"payment\", options.paymentOption ?? \"shop_pay\");\n\n  const source = options.source ?? DEFAULT_SOURCE;\n  if (source) params.set(\"source\", source);\n  if (options.sourceToken) params.set(\"source_token\", options.sourceToken);\n  if (options.channel) params.set(\"channel\", options.channel);\n\n  return params;\n}\n\nfunction getShopPayCheckoutModeUrl(checkoutUrl: string): URL {\n  const url = parseCheckoutUrl(checkoutUrl);\n  if (url.pathname === \"/\") url.pathname = \"/checkout\";\n  url.hash = \"\";\n  return url;\n}\n\nfunction getShopPayVariantModeUrl(checkoutUrl: string, variants: string): URL {\n  const url = parseCheckoutUrl(checkoutUrl);\n  url.pathname = `/cart/${variants}`;\n  url.hash = \"\";\n  return url;\n}\n\nfunction parseCheckoutUrl(checkoutUrl: string): URL {\n  try {\n    return new URL(normalizeStoreDomain(checkoutUrl.trim()));\n  } catch {\n    throw shopPayError('Shop Pay requires a valid \"checkoutUrl\" value.');\n  }\n}\n\nfunction getShopPayVariants(options: ShopPayButtonOptions): string | undefined {\n  const variantsInput: readonly ShopPayVariant[] | undefined = options.variants;\n\n  if (!Array.isArray(variantsInput) || variantsInput.length === 0) return undefined;\n\n  if (variantsInput.every(isVariantId)) {\n    return variantsInput.map((id) => `${normalizeVariantId(id)}:1`).join(\",\");\n  }\n\n  if (variantsInput.every(isVariantWithQuantity)) {\n    return variantsInput\n      .map(({ id, quantity }) => {\n        return `${normalizeVariantId(id)}:${normalizeQuantity(quantity)}`;\n      })\n      .join(\",\");\n  }\n\n  throw shopPayError(\n    \"Shop Pay variants must be either variant IDs or objects with an id and quantity.\",\n  );\n}\n\nfunction isVariantId(variant: ShopPayVariant): variant is string {\n  return typeof variant === \"string\";\n}\n\nfunction getShopPayButtonOptions(element: HTMLElement): ShopPayButtonOptions {\n  return {\n    accessibilityLabel: element.getAttribute(\"accessibility-label\") ?? undefined,\n    borderRadius: element.getAttribute(\"border-radius\") ?? undefined,\n    channel: parseChannel(element.getAttribute(\"channel\")),\n    checkoutUrl: element.getAttribute(\"checkout-url\") ?? undefined,\n    disabled: element.hasAttribute(\"disabled\"),\n    nonce: element.nonce || element.getAttribute(\"nonce\") || undefined,\n    paymentOption: parsePaymentOption(element.getAttribute(\"payment-option\")),\n    source: element.getAttribute(\"source\") ?? undefined,\n    sourceToken: element.getAttribute(\"source-token\") ?? undefined,\n    variants: parseVariantsAttribute(element.getAttribute(\"variants\")),\n    width: element.getAttribute(\"width\") ?? undefined,\n  };\n}\n\nfunction parseVariantsAttribute(value: string | null): ShopPayVariants | undefined {\n  if (!value) return undefined;\n\n  return value.split(\",\").map((entry) => {\n    const [id = \"\", quantity] = entry.split(\":\");\n    return { id, quantity: quantity === undefined ? undefined : Number(quantity) };\n  });\n}\n\nfunction parsePaymentOption(value: string | null): ShopPayButtonOptions[\"paymentOption\"] {\n  return value === \"shop_pay\" || value === \"shop_pay_installments\" ? value : undefined;\n}\n\nfunction parseChannel(value: string | null): ShopPayButtonOptions[\"channel\"] {\n  return value === \"headless\" || value === \"hydrogen\" ? value : undefined;\n}\n\nfunction renderShopPayButtonShadowRoot(\n  shadowRoot: ShadowRoot,\n  options: ShopPayButtonOptions,\n): void {\n  let style = shadowRoot.querySelector(\"style\");\n  if (!(style instanceof HTMLStyleElement)) {\n    style = shadowRoot.ownerDocument.createElement(\"style\");\n    shadowRoot.prepend(style);\n  }\n\n  const nextNonce = hasContent(options.nonce) ? options.nonce.trim() : undefined;\n  const nonceChanged = (style.nonce || undefined) !== nextNonce;\n  if (nextNonce) {\n    style.nonce = nextNonce;\n  } else {\n    style.removeAttribute(\"nonce\");\n  }\n  if (nonceChanged) style.textContent = \"\";\n  if (style.textContent !== SHOP_PAY_BUTTON_STYLES) style.textContent = SHOP_PAY_BUTTON_STYLES;\n\n  let anchor = shadowRoot.querySelector(\"a\");\n  if (!(anchor instanceof HTMLAnchorElement)) {\n    anchor = shadowRoot.ownerDocument.createElement(\"a\");\n    shadowRoot.append(anchor);\n  }\n\n  syncAttributes(anchor, getShopPayButtonAnchorAttributes(options));\n  const content = getShopPayButtonContentHtml();\n  if (anchor.innerHTML !== content) anchor.innerHTML = content;\n}\n\nfunction syncAttributes(element: Element, attributes: Record<string, string>): void {\n  for (const name of element.getAttributeNames()) {\n    if (!(name in attributes)) element.removeAttribute(name);\n  }\n\n  for (const [name, value] of Object.entries(attributes)) {\n    if (element.getAttribute(name) !== value) element.setAttribute(name, value);\n  }\n}\n\nfunction syncShopPayButtonElementAttributes(\n  element: Element,\n  attributes: Record<string, string>,\n): void {\n  for (const name of SHOP_PAY_BUTTON_OBSERVED_ATTRIBUTES) {\n    if (!(name in attributes)) element.removeAttribute(name);\n  }\n\n  for (const [name, value] of Object.entries(attributes)) {\n    if (element.getAttribute(name) !== value) element.setAttribute(name, value);\n  }\n}\n\nfunction isVariantWithQuantity(\n  variant: ShopPayVariant | undefined,\n): variant is ShopPayVariantWithQuantity {\n  return typeof variant === \"object\" && variant !== null && typeof variant.id === \"string\";\n}\n\nfunction normalizeVariantId(id: string): string {\n  const parsed = parseGid(id);\n  const bareId = parsed.id || id.trim();\n\n  if (parsed.resource && parsed.resource !== \"ProductVariant\") {\n    throw shopPayError(\n      \"Shop Pay variant IDs must be Shopify ProductVariant GIDs or bare numeric variant IDs.\",\n    );\n  }\n\n  if (/^\\d+$/.test(bareId)) return bareId;\n\n  throw shopPayError(\n    \"Shop Pay variant IDs must be Shopify ProductVariant GIDs or bare numeric variant IDs.\",\n  );\n}\n\nfunction normalizeQuantity(quantity = 1): number {\n  if (!Number.isInteger(quantity) || quantity < 1) {\n    throw shopPayError(\"Shop Pay variant quantities must be positive integers.\");\n  }\n\n  return quantity;\n}\n\nfunction escapeText(value: string): string {\n  return value.replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\");\n}\n\nfunction escapeAttribute(value: string): string {\n  return escapeText(value).replace(/\"/g, \"&quot;\");\n}\n\nfunction getShopPayAccessibilityLabel(label: string | undefined): string {\n  return hasContent(label) ? label.trim() : DEFAULT_ACCESSIBILITY_LABEL;\n}\n\nfunction getShopPayButtonStyleNonceAttribute(options: Pick<ShopPayButtonOptions, \"nonce\">): string {\n  return hasContent(options.nonce) ? ` nonce=\"${escapeAttribute(options.nonce.trim())}\"` : \"\";\n}\n\nfunction hasContent(value: string | undefined): value is string {\n  return typeof value === \"string\" && value.trim() !== \"\";\n}\n\nfunction normalizeCssValue(name: \"width\" | \"borderRadius\", value: string): string {\n  const normalized = value.trim();\n  if (/[;{}]/.test(normalized)) {\n    throw shopPayError(`Shop Pay ${name} must be a single CSS value.`);\n  }\n  return normalized;\n}\n\nfunction serializeAttributes(attributes: Record<string, string>): string {\n  return Object.entries(attributes)\n    .map(([name, value]) => `${name}=\"${escapeAttribute(value)}\"`)\n    .join(\" \");\n}\n\nfunction serializeStyleProperties(style: Record<string, string>): string {\n  return Object.entries(style)\n    .map(([name, value]) => `${hyphenateStyleName(name)}:${value}`)\n    .join(\";\");\n}\n\nfunction hyphenateStyleName(name: string): string {\n  return name.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`);\n}\n\nfunction shopPayError(message: string): Error {\n  return new Error(`${ERROR_PREFIX} ${message}`);\n}\n"],"mappings":"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"}

package/dist/core/shopify-scripts/index.d.mts

@@ -2,11 +2,15 @@ import { ShopifyRoutesOptions, ShopifyScriptTagDescriptor, ShopifyScriptTagDescr
 import { initializeShopifyScripts } from "./initialize.mjs";
 //#region src/core/shopify-scripts/index.d.ts
 /**
- * Returns grouped Shopify storefront script/link descriptors for SSR frameworks and bindings.
+ * Returns Shopify's storefront script and link tags as descriptors.
  *
- * Framework bindings wrap this with `initializeShopifyScripts()` to form their `ShopifyScripts`
- * component. Frameworks without a binding can render these descriptors during SSR and call
- * `initializeShopifyScripts()` during browser hydration.
+ * Render the descriptors in the document head during server rendering, then call
+ * `initializeShopifyScripts` in the browser. Keep the tags in the returned order. The inline
+ * scripts set up globals that later scripts read.
+ *
+ * @param options - The shop details, the localization, the consent configuration, and the features whose scripts to load.
+ * @returns The link tags, the script tags, and a combined list with links first.
+ * @publicDocs
  */
 declare function getShopifyScriptTags({
   account,
@@ -20,7 +24,13 @@ declare function getShopifyScriptTags({
   inbox
 }: ShopifyScriptTagsOptions): ShopifyScriptTagDescriptors;
 /**
- * Renders all Shopify storefront script/link descriptors to HTML strings.
+ * Renders Shopify's storefront script and link tags to HTML strings.
+ *
+ * Use the function when your framework accepts raw HTML in the document head.
+ *
+ * @param options The shop details and the features, such as account and analytics, whose scripts to load.
+ * @returns One HTML string per tag, with link tags first.
+ * @publicDocs
  */
 declare function renderShopifyScriptTags(options: ShopifyScriptTagsOptions): string[];
 //#endregion

package/dist/core/shopify-scripts/index.mjs

@@ -7,11 +7,15 @@ import { initializeShopifyScripts } from "./initialize.mjs";
 
 //#region src/core/shopify-scripts/index.ts
 /**
-* Returns grouped Shopify storefront script/link descriptors for SSR frameworks and bindings.
+* Returns Shopify's storefront script and link tags as descriptors.
 *
-* Framework bindings wrap this with `initializeShopifyScripts()` to form their `ShopifyScripts`
-* component. Frameworks without a binding can render these descriptors during SSR and call
-* `initializeShopifyScripts()` during browser hydration.
+* Render the descriptors in the document head during server rendering, then call
+* `initializeShopifyScripts` in the browser. Keep the tags in the returned order. The inline
+* scripts set up globals that later scripts read.
+*
+* @param options - The shop details, the localization, the consent configuration, and the features whose scripts to load.
+* @returns The link tags, the script tags, and a combined list with links first.
+* @publicDocs
 */
 function getShopifyScriptTags({ account = false, analytics, consent, debug, i18n, nonce, shop, shopifyAnalytics = true, inbox = false }) {
 	const nonceAttributes = nonce !== void 0 ? { nonce } : void 0;
@@ -126,7 +130,13 @@ function getShopifyScriptTags({ account = false, analytics, consent, debug, i18n
 	};
 }
 /**
-* Renders all Shopify storefront script/link descriptors to HTML strings.
+* Renders Shopify's storefront script and link tags to HTML strings.
+*
+* Use the function when your framework accepts raw HTML in the document head.
+*
+* @param options The shop details and the features, such as account and analytics, whose scripts to load.
+* @returns One HTML string per tag, with link tags first.
+* @publicDocs
 */
 function renderShopifyScriptTags(options) {
 	return getShopifyScriptTags(options).tags.map(renderShopifyScriptTag);

package/dist/core/shopify-scripts/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/core/shopify-scripts/index.ts"],"sourcesContent":["import { getShopifyAnalyticsBusScript, getShopifyAnalyticsConfig } from \"./analytics\";\nimport {\n  SHOPIFY_ACCOUNT_SCRIPT,\n  SHOPIFY_CONSENT_API_SCRIPT,\n  SHOPIFY_CDN_ORIGIN,\n  SHOPIFY_CONSENT_SCRIPT_ID,\n  SHOPIFY_PRIVACY_BANNER_SCRIPT,\n  SHOPIFY_SHOP_APP_ORIGIN,\n  SHOPIFY_INBOX_SCRIPT,\n  SHOPIFY_STOREFRONT_ANALYTICS_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_ACTIONS_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_EVENTS_INSPECTOR_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_EVENTS_SCRIPT,\n} from \"./constants\";\nimport { getShopifyGlobalBootstrapScript } from \"./global\";\nimport { getPerfKitScript } from \"./perfkit\";\nimport { renderShopifyScriptTag } from \"./render\";\nimport type {\n  ShopifyLinkDescriptor,\n  ShopifyScriptDescriptor,\n  ShopifyScriptTagDescriptors,\n  ShopifyScriptTagsOptions,\n} from \"./types\";\n\nexport {\n  CONSENT_TRACKING_API_LOADED_EVENT,\n  SHOPIFY_ACCOUNT_SCRIPT,\n  SHOPIFY_CDN_ORIGIN,\n  SHOPIFY_CONSENT_API_SCRIPT,\n  SHOPIFY_PERF_KIT_SCRIPT,\n  SHOPIFY_PRIVACY_BANNER_SCRIPT,\n  SHOPIFY_SHOP_APP_ORIGIN,\n  SHOPIFY_INBOX_SCRIPT,\n  SHOPIFY_STOREFRONT_ANALYTICS_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_ACTIONS_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_EVENTS_SCRIPT,\n  SHOPIFY_STOREFRONT_WEBMCP_SCRIPT,\n  VISITOR_CONSENT_COLLECTED_EVENT,\n} from \"./constants\";\nexport { getShopifyGlobal, getShopifyGlobalBootstrapScript } from \"./global\";\nexport { initializeShopifyScripts } from \"./initialize\";\nexport { renderShopifyScriptTag } from \"./render\";\nexport type {\n  ShopifyScriptsAnalyticsConfig,\n  ShopifyRoutesOptions,\n  ShopifyScriptTagDescriptor,\n  ShopifyScriptTagDescriptors,\n  ShopifyScriptTagsOptions,\n  ShopifyScriptsOptions,\n  ShopifyScriptsI18n,\n  ShopifyScriptsShop,\n} from \"./types\";\n\n/**\n * Returns grouped Shopify storefront script/link descriptors for SSR frameworks and bindings.\n *\n * Framework bindings wrap this with `initializeShopifyScripts()` to form their `ShopifyScripts`\n * component. Frameworks without a binding can render these descriptors during SSR and call\n * `initializeShopifyScripts()` during browser hydration.\n */\n// oxlint-disable-next-line complexity -- ordered assembly of optional Shopify script tags; each flag adds one branch and splitting would obscure the required load order\nexport function getShopifyScriptTags({\n  account = false,\n  analytics,\n  consent,\n  debug,\n  i18n,\n  nonce,\n  shop,\n  shopifyAnalytics = true,\n  inbox = false,\n}: ShopifyScriptTagsOptions): ShopifyScriptTagDescriptors {\n  const nonceAttributes = nonce !== undefined ? { nonce } : undefined;\n  const analyticsConfig = getShopifyAnalyticsConfig({ analytics, consent, shop });\n\n  const links: ShopifyLinkDescriptor[] = [\n    {\n      tagName: \"link\",\n      attributes: {\n        rel: \"preconnect\",\n        href: SHOPIFY_CDN_ORIGIN,\n      },\n    },\n    {\n      tagName: \"link\",\n      attributes: {\n        rel: \"preconnect\",\n        href: SHOPIFY_SHOP_APP_ORIGIN,\n      },\n    },\n    {\n      tagName: \"link\",\n      attributes: {\n        rel: \"prefetch\",\n        as: \"script\",\n        href: SHOPIFY_STOREFRONT_STANDARD_EVENTS_SCRIPT,\n        crossorigin: \"anonymous\",\n      },\n    },\n  ];\n  const scripts: ShopifyScriptDescriptor[] = [\n    {\n      tagName: \"script\",\n      attributes: { id: \"shopify-global-bootstrap\", ...nonceAttributes },\n      innerHTML: getShopifyGlobalBootstrapScript({ i18n, shop }),\n    },\n    {\n      tagName: \"script\",\n      attributes: {\n        id: \"shopify-standard-actions\",\n        type: \"module\",\n        crossorigin: \"anonymous\",\n        ...nonceAttributes,\n        src: SHOPIFY_STOREFRONT_STANDARD_ACTIONS_SCRIPT,\n      },\n    },\n  ];\n\n  if (__DEV__ && debug?.standardEventsInspector) {\n    scripts.push({\n      tagName: \"script\",\n      attributes: {\n        id: \"shopify-standard-events-inspector\",\n        defer: true,\n        crossorigin: \"anonymous\",\n        ...nonceAttributes,\n        src: SHOPIFY_STOREFRONT_STANDARD_EVENTS_INSPECTOR_SCRIPT,\n      },\n    });\n  }\n\n  if (inbox) {\n    scripts.push({\n      tagName: \"script\",\n      attributes: {\n        id: \"shopify-inbox\",\n        type: \"module\",\n        async: true,\n        crossorigin: \"anonymous\",\n        ...nonceAttributes,\n        src: SHOPIFY_INBOX_SCRIPT,\n      },\n    });\n  }\n\n  if (account) {\n    scripts.push({\n      tagName: \"script\",\n      attributes: {\n        id: \"shopify-account\",\n        type: \"module\",\n        async: true,\n        crossorigin: \"anonymous\",\n        ...nonceAttributes,\n        src: SHOPIFY_ACCOUNT_SCRIPT,\n      },\n    });\n  }\n\n  // Install readiness listeners before loading the async consent library so a\n  // cached script cannot finish initialization before Hydrogen starts listening.\n  scripts.push({\n    tagName: \"script\",\n    attributes: { id: \"shopify-analytics-bus\", ...nonceAttributes },\n    innerHTML: getShopifyAnalyticsBusScript(analyticsConfig),\n  });\n\n  scripts.push({\n    tagName: \"script\",\n    attributes: {\n      id: SHOPIFY_CONSENT_SCRIPT_ID,\n      async: true,\n      crossorigin: \"anonymous\",\n      ...nonceAttributes,\n      src:\n        consent?.mode === \"default-banner\"\n          ? SHOPIFY_PRIVACY_BANNER_SCRIPT\n          : SHOPIFY_CONSENT_API_SCRIPT,\n    },\n  });\n\n  if (shopifyAnalytics) {\n    scripts.push({\n      tagName: \"script\",\n      attributes: {\n        id: \"shopify-storefront-analytics\",\n        async: true,\n        crossorigin: \"anonymous\",\n        ...nonceAttributes,\n        src: SHOPIFY_STOREFRONT_ANALYTICS_SCRIPT,\n      },\n    });\n  }\n\n  const perfKitScript = getPerfKitScript(shop, nonceAttributes);\n  if (perfKitScript) {\n    scripts.push(perfKitScript);\n  }\n\n  return {\n    links,\n    scripts,\n    get tags() {\n      return [...links, ...scripts];\n    },\n  };\n}\n\n/**\n * Renders all Shopify storefront script/link descriptors to HTML strings.\n */\nexport function renderShopifyScriptTags(options: ShopifyScriptTagsOptions): string[] {\n  return getShopifyScriptTags(options).tags.map(renderShopifyScriptTag);\n}\n"],"mappings":";;;;;;;;;;;;;;;AA6DA,SAAgB,qBAAqB,EACnC,UAAU,OACV,WACA,SACA,OACA,MACA,OACA,MACA,mBAAmB,MACnB,QAAQ,SACgD;CACxD,MAAM,kBAAkB,UAAU,SAAY,EAAE,OAAO,GAAG;CAC1D,MAAM,kBAAkB,0BAA0B;EAAE;EAAW;EAAS;EAAM,CAAC;CAE/E,MAAM,QAAiC;EACrC;GACE,SAAS;GACT,YAAY;IACV,KAAK;IACL,MAAM;IACP;GACF;EACD;GACE,SAAS;GACT,YAAY;IACV,KAAK;IACL,MAAM;IACP;GACF;EACD;GACE,SAAS;GACT,YAAY;IACV,KAAK;IACL,IAAI;IACJ,MAAM;IACN,aAAa;IACd;GACF;EACF;CACD,MAAM,UAAqC,CACzC;EACE,SAAS;EACT,YAAY;GAAE,IAAI;GAA4B,GAAG;GAAiB;EAClE,WAAW,gCAAgC;GAAE;GAAM;GAAM,CAAC;EAC3D,EACD;EACE,SAAS;EACT,YAAY;GACV,IAAI;GACJ,MAAM;GACN,aAAa;GACb,GAAG;GACH,KAAK;GACN;EACF,CACF;AAeD,KAAI,MACF,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GACV,IAAI;GACJ,MAAM;GACN,OAAO;GACP,aAAa;GACb,GAAG;GACH,KAAK;GACN;EACF,CAAC;AAGJ,KAAI,QACF,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GACV,IAAI;GACJ,MAAM;GACN,OAAO;GACP,aAAa;GACb,GAAG;GACH,KAAK;GACN;EACF,CAAC;AAKJ,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GAAE,IAAI;GAAyB,GAAG;GAAiB;EAC/D,WAAW,6BAA6B,gBAAgB;EACzD,CAAC;AAEF,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GACV,IAAI;GACJ,OAAO;GACP,aAAa;GACb,GAAG;GACH,KACE,SAAS,SAAS,mBACd,gCACA;GACP;EACF,CAAC;AAEF,KAAI,iBACF,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GACV,IAAI;GACJ,OAAO;GACP,aAAa;GACb,GAAG;GACH,KAAK;GACN;EACF,CAAC;CAGJ,MAAM,gBAAgB,iBAAiB,MAAM,gBAAgB;AAC7D,KAAI,cACF,SAAQ,KAAK,cAAc;AAG7B,QAAO;EACL;EACA;EACA,IAAI,OAAO;AACT,UAAO,CAAC,GAAG,OAAO,GAAG,QAAQ;;EAEhC;;;;;AAMH,SAAgB,wBAAwB,SAA6C;AACnF,QAAO,qBAAqB,QAAQ,CAAC,KAAK,IAAI,uBAAuB"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/core/shopify-scripts/index.ts"],"sourcesContent":["import { getShopifyAnalyticsBusScript, getShopifyAnalyticsConfig } from \"./analytics\";\nimport {\n  SHOPIFY_ACCOUNT_SCRIPT,\n  SHOPIFY_CONSENT_API_SCRIPT,\n  SHOPIFY_CDN_ORIGIN,\n  SHOPIFY_CONSENT_SCRIPT_ID,\n  SHOPIFY_PRIVACY_BANNER_SCRIPT,\n  SHOPIFY_SHOP_APP_ORIGIN,\n  SHOPIFY_INBOX_SCRIPT,\n  SHOPIFY_STOREFRONT_ANALYTICS_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_ACTIONS_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_EVENTS_INSPECTOR_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_EVENTS_SCRIPT,\n} from \"./constants\";\nimport { getShopifyGlobalBootstrapScript } from \"./global\";\nimport { getPerfKitScript } from \"./perfkit\";\nimport { renderShopifyScriptTag } from \"./render\";\nimport type {\n  ShopifyLinkDescriptor,\n  ShopifyScriptDescriptor,\n  ShopifyScriptTagDescriptors,\n  ShopifyScriptTagsOptions,\n} from \"./types\";\n\nexport {\n  CONSENT_TRACKING_API_LOADED_EVENT,\n  SHOPIFY_ACCOUNT_SCRIPT,\n  SHOPIFY_CDN_ORIGIN,\n  SHOPIFY_CONSENT_API_SCRIPT,\n  SHOPIFY_PERF_KIT_SCRIPT,\n  SHOPIFY_PRIVACY_BANNER_SCRIPT,\n  SHOPIFY_SHOP_APP_ORIGIN,\n  SHOPIFY_INBOX_SCRIPT,\n  SHOPIFY_STOREFRONT_ANALYTICS_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_ACTIONS_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_EVENTS_SCRIPT,\n  SHOPIFY_STOREFRONT_WEBMCP_SCRIPT,\n  VISITOR_CONSENT_COLLECTED_EVENT,\n} from \"./constants\";\nexport { getShopifyGlobal, getShopifyGlobalBootstrapScript } from \"./global\";\nexport { initializeShopifyScripts } from \"./initialize\";\nexport { renderShopifyScriptTag } from \"./render\";\nexport type {\n  ShopifyScriptsAnalyticsConfig,\n  ShopifyRoutesOptions,\n  ShopifyScriptTagDescriptor,\n  ShopifyScriptTagDescriptors,\n  ShopifyScriptTagsOptions,\n  ShopifyScriptsOptions,\n  ShopifyScriptsI18n,\n  ShopifyScriptsShop,\n} from \"./types\";\n\n/**\n * Returns Shopify's storefront script and link tags as descriptors.\n *\n * Render the descriptors in the document head during server rendering, then call\n * `initializeShopifyScripts` in the browser. Keep the tags in the returned order. The inline\n * scripts set up globals that later scripts read.\n *\n * @param options - The shop details, the localization, the consent configuration, and the features whose scripts to load.\n * @returns The link tags, the script tags, and a combined list with links first.\n * @publicDocs\n */\n// oxlint-disable-next-line complexity -- ordered assembly of optional Shopify script tags; each flag adds one branch and splitting would obscure the required load order\nexport function getShopifyScriptTags({\n  account = false,\n  analytics,\n  consent,\n  debug,\n  i18n,\n  nonce,\n  shop,\n  shopifyAnalytics = true,\n  inbox = false,\n}: ShopifyScriptTagsOptions): ShopifyScriptTagDescriptors {\n  const nonceAttributes = nonce !== undefined ? { nonce } : undefined;\n  const analyticsConfig = getShopifyAnalyticsConfig({ analytics, consent, shop });\n\n  const links: ShopifyLinkDescriptor[] = [\n    {\n      tagName: \"link\",\n      attributes: {\n        rel: \"preconnect\",\n        href: SHOPIFY_CDN_ORIGIN,\n      },\n    },\n    {\n      tagName: \"link\",\n      attributes: {\n        rel: \"preconnect\",\n        href: SHOPIFY_SHOP_APP_ORIGIN,\n      },\n    },\n    {\n      tagName: \"link\",\n      attributes: {\n        rel: \"prefetch\",\n        as: \"script\",\n        href: SHOPIFY_STOREFRONT_STANDARD_EVENTS_SCRIPT,\n        crossorigin: \"anonymous\",\n      },\n    },\n  ];\n  const scripts: ShopifyScriptDescriptor[] = [\n    {\n      tagName: \"script\",\n      attributes: { id: \"shopify-global-bootstrap\", ...nonceAttributes },\n      innerHTML: getShopifyGlobalBootstrapScript({ i18n, shop }),\n    },\n    {\n      tagName: \"script\",\n      attributes: {\n        id: \"shopify-standard-actions\",\n        type: \"module\",\n        crossorigin: \"anonymous\",\n        ...nonceAttributes,\n        src: SHOPIFY_STOREFRONT_STANDARD_ACTIONS_SCRIPT,\n      },\n    },\n  ];\n\n  if (__DEV__ && debug?.standardEventsInspector) {\n    scripts.push({\n      tagName: \"script\",\n      attributes: {\n        id: \"shopify-standard-events-inspector\",\n        defer: true,\n        crossorigin: \"anonymous\",\n        ...nonceAttributes,\n        src: SHOPIFY_STOREFRONT_STANDARD_EVENTS_INSPECTOR_SCRIPT,\n      },\n    });\n  }\n\n  if (inbox) {\n    scripts.push({\n      tagName: \"script\",\n      attributes: {\n        id: \"shopify-inbox\",\n        type: \"module\",\n        async: true,\n        crossorigin: \"anonymous\",\n        ...nonceAttributes,\n        src: SHOPIFY_INBOX_SCRIPT,\n      },\n    });\n  }\n\n  if (account) {\n    scripts.push({\n      tagName: \"script\",\n      attributes: {\n        id: \"shopify-account\",\n        type: \"module\",\n        async: true,\n        crossorigin: \"anonymous\",\n        ...nonceAttributes,\n        src: SHOPIFY_ACCOUNT_SCRIPT,\n      },\n    });\n  }\n\n  // Install readiness listeners before loading the async consent library so a\n  // cached script cannot finish initialization before Hydrogen starts listening.\n  scripts.push({\n    tagName: \"script\",\n    attributes: { id: \"shopify-analytics-bus\", ...nonceAttributes },\n    innerHTML: getShopifyAnalyticsBusScript(analyticsConfig),\n  });\n\n  scripts.push({\n    tagName: \"script\",\n    attributes: {\n      id: SHOPIFY_CONSENT_SCRIPT_ID,\n      async: true,\n      crossorigin: \"anonymous\",\n      ...nonceAttributes,\n      src:\n        consent?.mode === \"default-banner\"\n          ? SHOPIFY_PRIVACY_BANNER_SCRIPT\n          : SHOPIFY_CONSENT_API_SCRIPT,\n    },\n  });\n\n  if (shopifyAnalytics) {\n    scripts.push({\n      tagName: \"script\",\n      attributes: {\n        id: \"shopify-storefront-analytics\",\n        async: true,\n        crossorigin: \"anonymous\",\n        ...nonceAttributes,\n        src: SHOPIFY_STOREFRONT_ANALYTICS_SCRIPT,\n      },\n    });\n  }\n\n  const perfKitScript = getPerfKitScript(shop, nonceAttributes);\n  if (perfKitScript) {\n    scripts.push(perfKitScript);\n  }\n\n  return {\n    links,\n    scripts,\n    get tags() {\n      return [...links, ...scripts];\n    },\n  };\n}\n\n/**\n * Renders Shopify's storefront script and link tags to HTML strings.\n *\n * Use the function when your framework accepts raw HTML in the document head.\n *\n * @param options The shop details and the features, such as account and analytics, whose scripts to load.\n * @returns One HTML string per tag, with link tags first.\n * @publicDocs\n */\nexport function renderShopifyScriptTags(options: ShopifyScriptTagsOptions): string[] {\n  return getShopifyScriptTags(options).tags.map(renderShopifyScriptTag);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAiEA,SAAgB,qBAAqB,EACnC,UAAU,OACV,WACA,SACA,OACA,MACA,OACA,MACA,mBAAmB,MACnB,QAAQ,SACgD;CACxD,MAAM,kBAAkB,UAAU,SAAY,EAAE,OAAO,GAAG;CAC1D,MAAM,kBAAkB,0BAA0B;EAAE;EAAW;EAAS;EAAM,CAAC;CAE/E,MAAM,QAAiC;EACrC;GACE,SAAS;GACT,YAAY;IACV,KAAK;IACL,MAAM;IACP;GACF;EACD;GACE,SAAS;GACT,YAAY;IACV,KAAK;IACL,MAAM;IACP;GACF;EACD;GACE,SAAS;GACT,YAAY;IACV,KAAK;IACL,IAAI;IACJ,MAAM;IACN,aAAa;IACd;GACF;EACF;CACD,MAAM,UAAqC,CACzC;EACE,SAAS;EACT,YAAY;GAAE,IAAI;GAA4B,GAAG;GAAiB;EAClE,WAAW,gCAAgC;GAAE;GAAM;GAAM,CAAC;EAC3D,EACD;EACE,SAAS;EACT,YAAY;GACV,IAAI;GACJ,MAAM;GACN,aAAa;GACb,GAAG;GACH,KAAK;GACN;EACF,CACF;AAeD,KAAI,MACF,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GACV,IAAI;GACJ,MAAM;GACN,OAAO;GACP,aAAa;GACb,GAAG;GACH,KAAK;GACN;EACF,CAAC;AAGJ,KAAI,QACF,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GACV,IAAI;GACJ,MAAM;GACN,OAAO;GACP,aAAa;GACb,GAAG;GACH,KAAK;GACN;EACF,CAAC;AAKJ,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GAAE,IAAI;GAAyB,GAAG;GAAiB;EAC/D,WAAW,6BAA6B,gBAAgB;EACzD,CAAC;AAEF,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GACV,IAAI;GACJ,OAAO;GACP,aAAa;GACb,GAAG;GACH,KACE,SAAS,SAAS,mBACd,gCACA;GACP;EACF,CAAC;AAEF,KAAI,iBACF,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GACV,IAAI;GACJ,OAAO;GACP,aAAa;GACb,GAAG;GACH,KAAK;GACN;EACF,CAAC;CAGJ,MAAM,gBAAgB,iBAAiB,MAAM,gBAAgB;AAC7D,KAAI,cACF,SAAQ,KAAK,cAAc;AAG7B,QAAO;EACL;EACA;EACA,IAAI,OAAO;AACT,UAAO,CAAC,GAAG,OAAO,GAAG,QAAQ;;EAEhC;;;;;;;;;;;AAYH,SAAgB,wBAAwB,SAA6C;AACnF,QAAO,qBAAqB,QAAQ,CAAC,KAAK,IAAI,uBAAuB"}

package/dist/core/shopify-scripts/initialize.d.mts

@@ -2,11 +2,19 @@ import { InitializeShopifyScriptsOptions } from "./types.mjs";
 
 //#region src/core/shopify-scripts/initialize.d.ts
 /**
- * Initializes Shopify browser script behavior for frameworks without a Hydrogen binding.
+ * Starts Shopify's scripts in the browser for frameworks without a Hydrogen binding. Call it after
+ * hydration, with the consent configuration that you passed to `getShopifyScriptTags`.
  *
- * This is the browser hydration half of `getShopifyScriptTags()`: framework bindings combine both
- * into a `ShopifyScripts` component, while custom integrations can render script tags during SSR
- * and call this helper from their browser lifecycle.
+ * The function sets up `window.Shopify.routes`, and sends a page view event on load and after each
+ * navigation that changes the path or query. In the custom banner consent mode, Hydrogen calls your
+ * setup callback after the Customer Privacy API loads. A custom banner configuration without a
+ * setup callback logs a warning, and analytics events stay blocked. When the browser supports
+ * WebMCP, the function also loads Shopify's WebMCP tools. Set `webMcp` to `false` to skip them.
+ *
+ * @param options - The consent configuration, the route settings, and whether to load WebMCP tools.
+ * @returns A promise that resolves after the WebMCP tools load or fail to load, or right away when the function skips WebMCP.
+ *
+ * @publicDocs
  */
 declare function initializeShopifyScripts({
   consent,

package/dist/core/shopify-scripts/initialize.mjs

@@ -7,11 +7,19 @@ import { loadShopifyWebMcpTools } from "./webmcp.mjs";
 //#region src/core/shopify-scripts/initialize.ts
 const log = getLogger("consent");
 /**
-* Initializes Shopify browser script behavior for frameworks without a Hydrogen binding.
+* Starts Shopify's scripts in the browser for frameworks without a Hydrogen binding. Call it after
+* hydration, with the consent configuration that you passed to `getShopifyScriptTags`.
 *
-* This is the browser hydration half of `getShopifyScriptTags()`: framework bindings combine both
-* into a `ShopifyScripts` component, while custom integrations can render script tags during SSR
-* and call this helper from their browser lifecycle.
+* The function sets up `window.Shopify.routes`, and sends a page view event on load and after each
+* navigation that changes the path or query. In the custom banner consent mode, Hydrogen calls your
+* setup callback after the Customer Privacy API loads. A custom banner configuration without a
+* setup callback logs a warning, and analytics events stay blocked. When the browser supports
+* WebMCP, the function also loads Shopify's WebMCP tools. Set `webMcp` to `false` to skip them.
+*
+* @param options - The consent configuration, the route settings, and whether to load WebMCP tools.
+* @returns A promise that resolves after the WebMCP tools load or fail to load, or right away when the function skips WebMCP.
+*
+* @publicDocs
 */
 function initializeShopifyScripts({ consent, navigate, routes, webMcp = true }) {
 	configureShopifyRouting({

package/dist/core/shopify-scripts/initialize.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"initialize.mjs","names":[],"sources":["../../../src/core/shopify-scripts/initialize.ts"],"sourcesContent":["import { initializeCustomConsent } from \"../analytics/custom-consent\";\nimport { getLogger } from \"../logging\";\nimport { configureShopifyRouting } from \"./global\";\nimport { initializeShopifyPageViewEvents } from \"./page-view\";\nimport type { InitializeShopifyScriptsOptions } from \"./types\";\nimport { loadShopifyWebMcpTools } from \"./webmcp\";\n\nconst log = getLogger(\"consent\");\n\n/**\n * Initializes Shopify browser script behavior for frameworks without a Hydrogen binding.\n *\n * This is the browser hydration half of `getShopifyScriptTags()`: framework bindings combine both\n * into a `ShopifyScripts` component, while custom integrations can render script tags during SSR\n * and call this helper from their browser lifecycle.\n */\nexport function initializeShopifyScripts({\n  consent,\n  navigate,\n  routes,\n  webMcp = true,\n}: InitializeShopifyScriptsOptions): Promise<boolean | void> {\n  configureShopifyRouting({ navigate, routes });\n  initializeShopifyPageViewEvents();\n\n  if (consent?.mode === \"custom-banner\") {\n    if (typeof consent.setup !== \"function\") {\n      log.warn(\n        \"custom-banner requires a consent.setup callback; analytics delivery remains blocked until setup completes\",\n      );\n    } else {\n      try {\n        initializeCustomConsent(consent.setup);\n      } catch (error) {\n        log.error(\"custom consent initialization failed\", { error });\n      }\n    }\n  }\n\n  if (!webMcp) return Promise.resolve();\n\n  return loadShopifyWebMcpTools();\n}\n"],"mappings":";;;;;;;AAOA,MAAM,MAAM,UAAU,UAAU;;;;;;;;AAShC,SAAgB,yBAAyB,EACvC,SACA,UACA,QACA,SAAS,QACkD;AAC3D,yBAAwB;EAAE;EAAU;EAAQ,CAAC;AAC7C,kCAAiC;AAEjC,KAAI,SAAS,SAAS,gBACpB,KAAI,OAAO,QAAQ,UAAU,WAC3B,KAAI,KACF,4GACD;KAED,KAAI;AACF,0BAAwB,QAAQ,MAAM;UAC/B,OAAO;AACd,MAAI,MAAM,wCAAwC,EAAE,OAAO,CAAC;;AAKlE,KAAI,CAAC,OAAQ,QAAO,QAAQ,SAAS;AAErC,QAAO,wBAAwB"}
+{"version":3,"file":"initialize.mjs","names":[],"sources":["../../../src/core/shopify-scripts/initialize.ts"],"sourcesContent":["import { initializeCustomConsent } from \"../analytics/custom-consent\";\nimport { getLogger } from \"../logging\";\nimport { configureShopifyRouting } from \"./global\";\nimport { initializeShopifyPageViewEvents } from \"./page-view\";\nimport type { InitializeShopifyScriptsOptions } from \"./types\";\nimport { loadShopifyWebMcpTools } from \"./webmcp\";\n\nconst log = getLogger(\"consent\");\n\n/**\n * Starts Shopify's scripts in the browser for frameworks without a Hydrogen binding. Call it after\n * hydration, with the consent configuration that you passed to `getShopifyScriptTags`.\n *\n * The function sets up `window.Shopify.routes`, and sends a page view event on load and after each\n * navigation that changes the path or query. In the custom banner consent mode, Hydrogen calls your\n * setup callback after the Customer Privacy API loads. A custom banner configuration without a\n * setup callback logs a warning, and analytics events stay blocked. When the browser supports\n * WebMCP, the function also loads Shopify's WebMCP tools. Set `webMcp` to `false` to skip them.\n *\n * @param options - The consent configuration, the route settings, and whether to load WebMCP tools.\n * @returns A promise that resolves after the WebMCP tools load or fail to load, or right away when the function skips WebMCP.\n *\n * @publicDocs\n */\nexport function initializeShopifyScripts({\n  consent,\n  navigate,\n  routes,\n  webMcp = true,\n}: InitializeShopifyScriptsOptions): Promise<boolean | void> {\n  configureShopifyRouting({ navigate, routes });\n  initializeShopifyPageViewEvents();\n\n  if (consent?.mode === \"custom-banner\") {\n    if (typeof consent.setup !== \"function\") {\n      log.warn(\n        \"custom-banner requires a consent.setup callback; analytics delivery remains blocked until setup completes\",\n      );\n    } else {\n      try {\n        initializeCustomConsent(consent.setup);\n      } catch (error) {\n        log.error(\"custom consent initialization failed\", { error });\n      }\n    }\n  }\n\n  if (!webMcp) return Promise.resolve();\n\n  return loadShopifyWebMcpTools();\n}\n"],"mappings":";;;;;;;AAOA,MAAM,MAAM,UAAU,UAAU;;;;;;;;;;;;;;;;AAiBhC,SAAgB,yBAAyB,EACvC,SACA,UACA,QACA,SAAS,QACkD;AAC3D,yBAAwB;EAAE;EAAU;EAAQ,CAAC;AAC7C,kCAAiC;AAEjC,KAAI,SAAS,SAAS,gBACpB,KAAI,OAAO,QAAQ,UAAU,WAC3B,KAAI,KACF,4GACD;KAED,KAAI;AACF,0BAAwB,QAAQ,MAAM;UAC/B,OAAO;AACd,MAAI,MAAM,wCAAwC,EAAE,OAAO,CAAC;;AAKlE,KAAI,CAAC,OAAQ,QAAO,QAAQ,SAAS;AAErC,QAAO,wBAAwB"}