@shopify/hydrogen 2026.10.0-preview.4 → 2026.10.0

package/dist/development/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/development/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/development/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"}

package/dist/development/core/shopify-scripts/types.d.mts

@@ -4,17 +4,23 @@ import { ShopifyGlobal } from "../../globals.mjs";
 import { ConsentConfig, ShopAnalyticsChannel, StorefrontAnalyticsConfig } from "../analytics/types.mjs";
 
 //#region src/core/shopify-scripts/types.d.ts
+/** The sales channel and custom data for the analytics bus. */
 type ShopifyScriptsAnalyticsConfig = {
-  channel?: ShopAnalyticsChannel;
+  /** The sales channel that Shopify attributes analytics to. Defaults to `hydrogen`. */channel?: ShopAnalyticsChannel; /** Extra values that analytics destinations can read from the bus configuration. */
   customData?: StorefrontAnalyticsConfig["customData"];
 };
-type ShopifyScriptsI18n = Pick<I18nConfig, "country" | "language"> & Partial<Pick<I18nConfig, "pathPrefix">> & {
+/** The locale that Shopify's scripts read from the browser's Shopify global. */
+interface ShopifyScriptsI18n extends Pick<I18nConfig, "country" | "language">, Partial<Pick<I18nConfig, "pathPrefix">> {
+  /** The active currency code. Hydrogen converts it to uppercase. */
   currency?: string;
-};
+}
+/** The values of the HTML `crossorigin` attribute. */
 type ShopifyCrossOrigin = "" | "anonymous" | "use-credentials";
+/** Custom `data-*` HTML attributes with string values. */
 type ShopifyDataAttributes = {
   [name: `data-${string}`]: string;
 };
+/** The HTML attributes of a generated script tag, with lowercase attribute names. */
 type ShopifyScriptTagAttributes = ShopifyDataAttributes & Partial<{
   async: boolean;
   crossorigin: ShopifyCrossOrigin;
@@ -24,58 +30,85 @@ type ShopifyScriptTagAttributes = ShopifyDataAttributes & Partial<{
   src: string;
   type: string;
 }>;
+/** The HTML attributes of a generated link tag. */
 type ShopifyLinkTagAttributes = Partial<{
-  as: "script";
-  crossorigin: ShopifyCrossOrigin;
-  href: string;
+  /** The resource type for a prefetch link. Always `script`. */as: "script"; /** The CORS mode for fetching the linked resource. */
+  crossorigin: ShopifyCrossOrigin; /** The URL of the origin to preconnect to, or the script to prefetch. */
+  href: string; /** Whether the link preconnects to an origin or prefetches a script. */
   rel: "preconnect" | "prefetch";
 }>;
+/** A script tag to render in the document head. */
 type ShopifyScriptDescriptor = {
-  tagName: "script";
-  attributes?: ShopifyScriptTagAttributes;
+  /** Always `script` for a script tag. */tagName: "script"; /** The script tag's HTML attributes, such as its source URL and nonce. */
+  attributes?: ShopifyScriptTagAttributes; /** The inline script content, for scripts that have no source URL. */
   innerHTML?: string;
 };
+/** A link tag to render in the document head. */
 type ShopifyLinkDescriptor = {
-  tagName: "link";
-  attributes: ShopifyLinkTagAttributes;
+  /** Always `link` for a link tag. */tagName: "link";
+  attributes: ShopifyLinkTagAttributes; /** Link tags have no content. */
   innerHTML?: never;
 };
+/** A script or link tag to render in the document head. */
 type ShopifyScriptTagDescriptor = ShopifyScriptDescriptor | ShopifyLinkDescriptor;
+/** The generated link and script tags, as separate lists and as one combined list. */
 type ShopifyScriptTagDescriptors = {
   /** Link descriptors for framework head APIs that split links from scripts. */readonly links: readonly ShopifyLinkDescriptor[]; /** Script descriptors for framework head APIs that split scripts from links. */
   readonly scripts: readonly ShopifyScriptDescriptor[]; /** All generated descriptors as a mixed list, with links before scripts. */
   readonly tags: readonly ShopifyScriptTagDescriptor[];
 };
+/** The shop identifiers that Shopify's scripts and analytics use. */
 type ShopifyScriptsShop = {
-  shopId: string;
-  storefrontId: string; /** The shop's permanent `*.myshopify.com` domain, exposed as `window.Shopify.shop`. */
+  /** The shop's ID, as a numeric string or a Shop GID. */shopId: string; /** The Hydrogen storefront's ID. Hydrogen leaves it out of Headless channel analytics. */
+  storefrontId: string; /** The shop's permanent `*.myshopify.com` domain. Hydrogen sets it as `window.Shopify.shop`. */
   myshopifyDomain: string;
 };
+/** The shop details and the features whose scripts to load. */
 type ShopifyScriptTagsOptions = {
   /**
-   * Loads the customer account component. Render `<shopify-account>` where you want the account UI to appear.
-   * @see {@link https://shopify.dev/docs/api/storefront-web-components/components/shopify-account | shopify-account}
+   * Loads the customer account component. Render `shopify-account` where you want the account UI to appear.
+   * @see [shopify-account](https://shopify.dev/docs/api/storefront-web-components/components/shopify-account)
    */
-  account?: boolean;
-  analytics?: ShopifyScriptsAnalyticsConfig;
-  consent?: ConsentConfig;
+  account?: boolean; /** The sales channel and custom data for the analytics bus. */
+  analytics?: ShopifyScriptsAnalyticsConfig; /** Which consent script to load and how the analytics bus waits for consent. */
+  consent?: ConsentConfig; /** Development-only debugging tools. */
   debug?: {
     /** Loads Shopify's standard events inspector in development builds. */standardEventsInspector?: boolean;
-  };
-  i18n?: ShopifyScriptsI18n; /** Loads Inbox. Render `<shopify-chat>` where you want the chat UI to appear. */
+  }; /** The country, language, currency, and path prefix for Shopify's scripts. Defaults to US English. */
+  i18n?: ShopifyScriptsI18n; /** Loads Inbox. Render `shopify-chat` where you want the chat UI to appear. */
   inbox?: boolean;
-  nonce?: string;
-  shop: ShopifyScriptsShop;
+  /**
+   * Adds a `nonce` attribute to every script tag.
+   */
+  nonce?: string; /** The shop's IDs and permanent domain. */
+  shop: ShopifyScriptsShop; /** Loads Shopify's storefront analytics script. Defaults to `true`. */
   shopifyAnalytics?: boolean;
 };
+/**
+ * Route settings for Shopify's scripts: the storefront's route templates and a callback for
+ * client-side navigation.
+ */
 type ShopifyRoutesOptions = {
-  navigate?: ShopifyGlobal["routes"]["navigate"];
+  /**
+   * Navigates to a URL after Shopify's scripts resolve it to your app's route. Defaults to a full
+   * page load. Checkout, cart permalink, buy permalink, and customer account paths always use a full page load.
+   */
+  navigate?: ShopifyGlobal["routes"]["navigate"]; /** Your app's custom route templates, which Shopify's scripts use to match and resolve storefront URLs. */
   routes?: ShopifyRouteTemplates;
 };
-type InitializeShopifyScriptsOptions = ShopifyRoutesOptions & {
-  /** Pass the same consent configuration used to render the script tags. Setup runs once per bus. */consent?: ConsentConfig;
+/** The route, consent, and WebMCP settings for starting Shopify's scripts in the browser. */
+interface InitializeShopifyScriptsOptions extends ShopifyRoutesOptions {
+  /** The consent configuration that you passed to the script tags. The bus runs the setup callback once. */
+  consent?: ConsentConfig;
+  /** Loads Shopify WebMCP tools when the browser supports WebMCP. Defaults to `true`. */
   webMcp?: boolean;
-};
+}
+/**
+ * Options for both `getShopifyScriptTags` and `initializeShopifyScripts`. Build one object and pass
+ * it to both functions.
+ *
+ * @publicDocs
+ */
 type ShopifyScriptsOptions = ShopifyScriptTagsOptions & InitializeShopifyScriptsOptions;
 //#endregion
 export { InitializeShopifyScriptsOptions, ShopifyRoutesOptions, ShopifyScriptTagDescriptor, ShopifyScriptTagDescriptors, ShopifyScriptTagsOptions, ShopifyScriptsAnalyticsConfig, ShopifyScriptsI18n, ShopifyScriptsOptions, ShopifyScriptsShop };

package/dist/development/core/standard-routes/build.d.mts

@@ -2,21 +2,19 @@ import { ShopifyRouteTemplates } from "./types.mjs";
 
 //#region src/core/standard-routes/build.d.ts
 /**
- * Creates a typed map of custom route templates for Shopify standard storefront routes.
+ * Tells Hydrogen where your app serves products, collections, and other Shopify resources. Pass
+ * the returned object to `handleShopifyRoutes`, `handleShopifyRedirects`, the `ShopifyScripts` `routes`
+ * option, and the predictive search URL helpers.
  *
- * Use the returned object anywhere Hydrogen needs to understand the app's URL shape for
- * Shopify resources and utility pages: `handleShopifyRedirects({routeTemplates})`, `ShopifyScripts`
- * `routes={routeTemplates}`, and predictive search URL helpers.
+ * Add a key only for a route that your app serves at a non-standard path. Hydrogen uses Shopify's
+ * default path for each key that you leave out. Pass an empty object when your app serves every
+ * route at its default path. Each template starts with `/` and includes the handle placeholders
+ * for its route. Leave the locale path prefix out of templates. Hydrogen adds the prefix for you.
  *
- * Each key represents a Shopify standard route identity, while each value is the app's custom
- * pathname template. Templates must start with `/` and include the required named handle
- * placeholders for routes that identify a resource. Do not include an i18n path prefix in the
- * template; Hydrogen applies `i18n.pathPrefix` separately when resolving routes. Pass an empty
- * object when the app uses standard storefront routes so there is still one app-owned routing
- * manifest to update if routes change later. When matching the current page, standard storefront
- * routes retain their page-template identities even if a configured template resolves another
- * route to the same pathname.
+ * TypeScript checks the shape of each template. The function returns the object that you pass.
  *
+ * @param routes The non-standard paths that your app serves, keyed by standard route name.
+ * @returns The route templates, typed for Hydrogen's route, redirect, and URL helpers.
  * @example
  * ```ts
  * const routeTemplates = createShopifyRouteTemplates({
@@ -27,6 +25,7 @@ import { ShopifyRouteTemplates } from "./types.mjs";
  *   policy: "/legal/:policyHandle",
  * });
  * ```
+ * @publicDocs
  */
 declare function createShopifyRouteTemplates<const TRoutes extends ShopifyRouteTemplates>(routes: TRoutes): TRoutes;
 //#endregion

package/dist/development/core/standard-routes/build.mjs

@@ -3,21 +3,19 @@ import { prependPathPrefix } from "./path.mjs";
 
 //#region src/core/standard-routes/build.ts
 /**
-* Creates a typed map of custom route templates for Shopify standard storefront routes.
+* Tells Hydrogen where your app serves products, collections, and other Shopify resources. Pass
+* the returned object to `handleShopifyRoutes`, `handleShopifyRedirects`, the `ShopifyScripts` `routes`
+* option, and the predictive search URL helpers.
 *
-* Use the returned object anywhere Hydrogen needs to understand the app's URL shape for
-* Shopify resources and utility pages: `handleShopifyRedirects({routeTemplates})`, `ShopifyScripts`
-* `routes={routeTemplates}`, and predictive search URL helpers.
+* Add a key only for a route that your app serves at a non-standard path. Hydrogen uses Shopify's
+* default path for each key that you leave out. Pass an empty object when your app serves every
+* route at its default path. Each template starts with `/` and includes the handle placeholders
+* for its route. Leave the locale path prefix out of templates. Hydrogen adds the prefix for you.
 *
-* Each key represents a Shopify standard route identity, while each value is the app's custom
-* pathname template. Templates must start with `/` and include the required named handle
-* placeholders for routes that identify a resource. Do not include an i18n path prefix in the
-* template; Hydrogen applies `i18n.pathPrefix` separately when resolving routes. Pass an empty
-* object when the app uses standard storefront routes so there is still one app-owned routing
-* manifest to update if routes change later. When matching the current page, standard storefront
-* routes retain their page-template identities even if a configured template resolves another
-* route to the same pathname.
+* TypeScript checks the shape of each template. The function returns the object that you pass.
 *
+* @param routes The non-standard paths that your app serves, keyed by standard route name.
+* @returns The route templates, typed for Hydrogen's route, redirect, and URL helpers.
 * @example
 * ```ts
 * const routeTemplates = createShopifyRouteTemplates({
@@ -28,6 +26,7 @@ import { prependPathPrefix } from "./path.mjs";
 *   policy: "/legal/:policyHandle",
 * });
 * ```
+* @publicDocs
 */
 function createShopifyRouteTemplates(routes) {
 	return routes;

package/dist/development/core/standard-routes/build.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build.mjs","names":[],"sources":["../../../../src/core/standard-routes/build.ts"],"sourcesContent":["import { DEFAULT_STANDARD_ROUTES, isStandardRouteParamName } from \"./defaults\";\nimport { prependPathPrefix } from \"./path\";\nimport type {\n  ShopifyRouteTemplates,\n  StandardRouteName,\n  StandardRouteOptions,\n  StandardRouteParams,\n  StandardRouteParamsByName,\n} from \"./types\";\n\n/**\n * Creates a typed map of custom route templates for Shopify standard storefront routes.\n *\n * Use the returned object anywhere Hydrogen needs to understand the app's URL shape for\n * Shopify resources and utility pages: `handleShopifyRedirects({routeTemplates})`, `ShopifyScripts`\n * `routes={routeTemplates}`, and predictive search URL helpers.\n *\n * Each key represents a Shopify standard route identity, while each value is the app's custom\n * pathname template. Templates must start with `/` and include the required named handle\n * placeholders for routes that identify a resource. Do not include an i18n path prefix in the\n * template; Hydrogen applies `i18n.pathPrefix` separately when resolving routes. Pass an empty\n * object when the app uses standard storefront routes so there is still one app-owned routing\n * manifest to update if routes change later. When matching the current page, standard storefront\n * routes retain their page-template identities even if a configured template resolves another\n * route to the same pathname.\n *\n * @example\n * ```ts\n * const routeTemplates = createShopifyRouteTemplates({\n *   product: \"/p/:productHandle\",\n *   collection: \"/c/:collectionHandle\",\n *   article: \"/journal/:blogHandle/:articleHandle\",\n *   cart: \"/basket\",\n *   policy: \"/legal/:policyHandle\",\n * });\n * ```\n */\nexport function createShopifyRouteTemplates<const TRoutes extends ShopifyRouteTemplates>(\n  routes: TRoutes,\n): TRoutes {\n  return routes;\n}\n\nexport function getStandardRoute<const TRoute extends StandardRouteName>(\n  routeTemplates: ShopifyRouteTemplates,\n  route: TRoute,\n  params: StandardRouteParamsByName[TRoute],\n  options: StandardRouteOptions = {},\n): string {\n  const target = routeTemplates[route] ?? DEFAULT_STANDARD_ROUTES[route][0];\n\n  return buildStandardRouteTarget(target, params, options.pathPrefix);\n}\n\n/**\n * Builds a pathname from a route template, handle params, and optional i18n path prefix.\n */\nexport function buildStandardRouteTarget(\n  template: string,\n  params: StandardRouteParams,\n  pathPrefix: string | undefined,\n): string {\n  return prependPathPrefix(interpolateRouteTemplate(template, params), pathPrefix);\n}\n\nfunction interpolateRouteTemplate(template: string, params: StandardRouteParams): string {\n  return template.replace(/:([A-Za-z][A-Za-z0-9_]*)/g, (placeholder, name: string) => {\n    if (!isStandardRouteParamName(name)) return placeholder;\n\n    const value = params[name];\n    return value === undefined ? placeholder : encodeURIComponent(value);\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,4BACd,QACS;AACT,QAAO;;AAGT,SAAgB,iBACd,gBACA,OACA,QACA,UAAgC,EAAE,EAC1B;AAGR,QAAO,yBAFQ,eAAe,UAAU,wBAAwB,OAAO,IAE/B,QAAQ,QAAQ,WAAW;;;;;AAMrE,SAAgB,yBACd,UACA,QACA,YACQ;AACR,QAAO,kBAAkB,yBAAyB,UAAU,OAAO,EAAE,WAAW;;AAGlF,SAAS,yBAAyB,UAAkB,QAAqC;AACvF,QAAO,SAAS,QAAQ,8BAA8B,aAAa,SAAiB;AAClF,MAAI,CAAC,yBAAyB,KAAK,CAAE,QAAO;EAE5C,MAAM,QAAQ,OAAO;AACrB,SAAO,UAAU,SAAY,cAAc,mBAAmB,MAAM;GACpE"}
+{"version":3,"file":"build.mjs","names":[],"sources":["../../../../src/core/standard-routes/build.ts"],"sourcesContent":["import { DEFAULT_STANDARD_ROUTES, isStandardRouteParamName } from \"./defaults\";\nimport { prependPathPrefix } from \"./path\";\nimport type {\n  ShopifyRouteTemplates,\n  StandardRouteName,\n  StandardRouteOptions,\n  StandardRouteParams,\n  StandardRouteParamsByName,\n} from \"./types\";\n\n/**\n * Tells Hydrogen where your app serves products, collections, and other Shopify resources. Pass\n * the returned object to `handleShopifyRoutes`, `handleShopifyRedirects`, the `ShopifyScripts` `routes`\n * option, and the predictive search URL helpers.\n *\n * Add a key only for a route that your app serves at a non-standard path. Hydrogen uses Shopify's\n * default path for each key that you leave out. Pass an empty object when your app serves every\n * route at its default path. Each template starts with `/` and includes the handle placeholders\n * for its route. Leave the locale path prefix out of templates. Hydrogen adds the prefix for you.\n *\n * TypeScript checks the shape of each template. The function returns the object that you pass.\n *\n * @param routes The non-standard paths that your app serves, keyed by standard route name.\n * @returns The route templates, typed for Hydrogen's route, redirect, and URL helpers.\n * @example\n * ```ts\n * const routeTemplates = createShopifyRouteTemplates({\n *   product: \"/p/:productHandle\",\n *   collection: \"/c/:collectionHandle\",\n *   article: \"/journal/:blogHandle/:articleHandle\",\n *   cart: \"/basket\",\n *   policy: \"/legal/:policyHandle\",\n * });\n * ```\n * @publicDocs\n */\nexport function createShopifyRouteTemplates<const TRoutes extends ShopifyRouteTemplates>(\n  routes: TRoutes,\n): TRoutes {\n  return routes;\n}\n\nexport function getStandardRoute<const TRoute extends StandardRouteName>(\n  routeTemplates: ShopifyRouteTemplates,\n  route: TRoute,\n  params: StandardRouteParamsByName[TRoute],\n  options: StandardRouteOptions = {},\n): string {\n  const target = routeTemplates[route] ?? DEFAULT_STANDARD_ROUTES[route][0];\n\n  return buildStandardRouteTarget(target, params, options.pathPrefix);\n}\n\n/**\n * Builds a pathname from a route template, handle params, and optional i18n path prefix.\n */\nexport function buildStandardRouteTarget(\n  template: string,\n  params: StandardRouteParams,\n  pathPrefix: string | undefined,\n): string {\n  return prependPathPrefix(interpolateRouteTemplate(template, params), pathPrefix);\n}\n\nfunction interpolateRouteTemplate(template: string, params: StandardRouteParams): string {\n  return template.replace(/:([A-Za-z][A-Za-z0-9_]*)/g, (placeholder, name: string) => {\n    if (!isStandardRouteParamName(name)) return placeholder;\n\n    const value = params[name];\n    return value === undefined ? placeholder : encodeURIComponent(value);\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,4BACd,QACS;AACT,QAAO;;AAGT,SAAgB,iBACd,gBACA,OACA,QACA,UAAgC,EAAE,EAC1B;AAGR,QAAO,yBAFQ,eAAe,UAAU,wBAAwB,OAAO,IAE/B,QAAQ,QAAQ,WAAW;;;;;AAMrE,SAAgB,yBACd,UACA,QACA,YACQ;AACR,QAAO,kBAAkB,yBAAyB,UAAU,OAAO,EAAE,WAAW;;AAGlF,SAAS,yBAAyB,UAAkB,QAAqC;AACvF,QAAO,SAAS,QAAQ,8BAA8B,aAAa,SAAiB;AAClF,MAAI,CAAC,yBAAyB,KAAK,CAAE,QAAO;EAE5C,MAAM,QAAQ,OAAO;AACrB,SAAO,UAAU,SAAY,cAAc,mBAAmB,MAAM;GACpE"}

package/dist/development/core/standard-routes/types.d.mts

@@ -1,75 +1,78 @@
 //#region src/core/standard-routes/types.d.ts
+/** A path template that starts with `/` and includes the named handle placeholder. */
 type StandardRouteTemplateWithParam<Param extends string> = `/${string}:${Param}` | `/${string}:${Param}/${string}`;
+/** A path template that starts with `/`. */
 type StandardRouteTemplate = `/${string}`;
+/** Your app's custom path templates for Shopify standard storefront routes, keyed by route name. */
 type ShopifyRouteTemplates = {
   /**
-   * Redirects Shopify article routes, for example
-   * `/blogs/news/snowboard-guide`, to the app's custom article route.
+   * The app's article path. Hydrogen redirects Shopify article paths, such as
+   * `/blogs/news/snowboard-guide`, to this template.
    *
    * @example "/journal/:blogHandle/:articleHandle"
    */
   article?: StandardRouteTemplateWithParam<"blogHandle"> & StandardRouteTemplateWithParam<"articleHandle">;
   /**
-   * Redirects Shopify blog routes, for example `/blogs/news`, to the app's
-   * custom blog route.
+   * The app's blog path. Hydrogen redirects Shopify blog paths, such as
+   * `/blogs/news`, to this template.
    *
    * @example "/journal/:blogHandle"
    */
   blog?: StandardRouteTemplateWithParam<"blogHandle">;
   /**
-   * Redirects Shopify's `/cart` route to the app's custom cart route.
+   * The app's cart path. Hydrogen redirects Shopify's `/cart` path to this template.
    *
    * @example "/basket"
    */
   cart?: StandardRouteTemplate;
   /**
-   * Redirects Shopify collection routes, for example `/collections/winter`,
-   * to the app's custom collection route.
+   * The app's collection path. Hydrogen redirects Shopify collection paths, such as
+   * `/collections/winter`, to this template.
    *
    * @example "/c/:collectionHandle"
    */
   collection?: StandardRouteTemplateWithParam<"collectionHandle">;
   /**
-   * Redirects Shopify's collection-listing routes, `/collections` and the
-   * legacy `/products`, to the app's custom collection-listing route.
+   * The app's collection list path. Hydrogen redirects Shopify's `/collections`
+   * path and the legacy `/products` path to this template.
    *
    * @example "/catalog"
    */
   collectionList?: StandardRouteTemplate;
   /**
-   * Redirects Shopify page routes, for example `/pages/about-us`, to the app's
-   * custom page route.
+   * The app's page path. Hydrogen redirects Shopify page paths, such as
+   * `/pages/about-us`, to this template.
    *
    * @example "/content/:pageHandle"
    */
   page?: StandardRouteTemplateWithParam<"pageHandle">;
   /**
-   * Redirects Shopify policy routes, for example `/policies/privacy-policy`,
-   * to the app's custom policy route.
+   * The app's policy path. Hydrogen redirects Shopify policy paths, such as
+   * `/policies/privacy-policy`, to this template.
    *
    * @example "/legal/:policyHandle"
    */
   policy?: StandardRouteTemplateWithParam<"policyHandle">;
   /**
-   * Redirects Shopify product routes, for example `/products/snowboard`,
-   * to the app's custom product route.
+   * The app's product path. Hydrogen redirects Shopify product paths, such as
+   * `/products/snowboard`, to this template.
    *
    * @example "/p/:productHandle"
    */
   product?: StandardRouteTemplateWithParam<"productHandle">;
   /**
-   * Redirects Shopify collection-scoped product routes, for example
-   * `/collections/winter/products/snowboard`, to the app's custom product route.
+   * The app's path for products inside a collection. Hydrogen redirects Shopify
+   * paths such as `/collections/winter/products/snowboard` to this template.
    *
-   * Must include `:productHandle`. May include `:collectionHandle` when the
-   * app's custom product route is also collection-scoped.
+   * The template must include `:productHandle`. Add `:collectionHandle` when the
+   * app's product path also names the collection.
    *
    * @example "/p/:productHandle"
    * @example "/c/:collectionHandle/p/:productHandle"
    */
   productInCollection?: StandardRouteTemplateWithParam<"productHandle">;
   /**
-   * Redirects Shopify's `/search` route to the app's custom search route.
+   * The app's search path. Hydrogen redirects Shopify's `/search` path to this template.
    *
    * @example "/find"
    */
@@ -77,14 +80,17 @@ type ShopifyRouteTemplates = {
 };
 type StandardRouteName = keyof ShopifyRouteTemplates;
 type ShopifyStandardRouteName = StandardRouteName | "index";
+/** The page template name for a standard route. Collection-scoped products use `product`, and the collection list uses `list-collections`. */
 type ShopifyPageTemplateName<TRoute extends ShopifyStandardRouteName = ShopifyStandardRouteName> = TRoute extends "productInCollection" ? "product" : TRoute extends "collectionList" ? "list-collections" : TRoute;
 type StandardRouteParamName = "articleHandle" | "blogHandle" | "collectionHandle" | "pageHandle" | "policyHandle" | "productHandle";
+/** The handle values that fill a route template's placeholders, keyed by placeholder name. */
 type StandardRouteParams = Partial<Record<StandardRouteParamName, string>>;
+/** The standard route that a storefront URL matches, with its handles, page template name, and templates. */
 type ShopifyStandardRouteMatch<TRoute extends ShopifyStandardRouteName = ShopifyStandardRouteName> = {
-  standardPathname: string;
-  params: StandardRouteParams;
-  route: TRoute;
-  pageTemplateName: ShopifyPageTemplateName<TRoute>;
+  /** Shopify's default path for the matched resource, with the locale path prefix applied. */standardPathname: string; /** The decoded handle values from the matched URL. */
+  params: StandardRouteParams; /** The standard route name that the URL matched, or `index` for the home page. */
+  route: TRoute; /** The page template name for the matched route, such as `product` or `list-collections`. */
+  pageTemplateName: ShopifyPageTemplateName<TRoute>; /** Shopify's default template for the matched route and your app's custom template, which falls back to the default. */
   templates: {
     standard: string;
     custom: string;

package/dist/development/core/url.mjs

@@ -24,6 +24,7 @@ const CUSTOMER_ACCOUNT_HANDOFF_PATHS = new Set(Object.values(CUSTOMER_ACCOUNT_PA
 function isHydrogenServerHandoffPath(pathname) {
 	return CHECKOUT_RE.test(pathname) || CART_PERMALINK_RE.test(pathname) || BUY_PERMALINK_RE.test(pathname) || CUSTOMER_ACCOUNT_HANDOFF_PATHS.has(pathname);
 }
+const UCP_RE = /^\/\.well-known\/ucp$/;
 /**
 * Allowlisted `.well-known` resources proxied to the Online Store origin:
 * - `apple-developer-merchantid-domain-association` — Apple Pay domain verification.
@@ -57,5 +58,5 @@ function normalizeStoreDomain(domain) {
 }
 
 //#endregion
-export { AJAX_CART_RE, BUY_PERMALINK_RE, CHECKOUT_RE, CUSTOMER_ACCOUNT_PATHS, MCP_RE, SFAPI_RE, SHOPIFY_API_PROXY_PREFIX, SHOPIFY_API_PROXY_RE, UCP_MCP_RE, WELL_KNOWN_RE, getSameOriginPath, isHydrogenServerHandoffPath, normalizeStoreDomain };
+export { AJAX_CART_RE, BUY_PERMALINK_RE, CHECKOUT_RE, CUSTOMER_ACCOUNT_PATHS, MCP_RE, SFAPI_RE, SHOPIFY_API_PROXY_PREFIX, SHOPIFY_API_PROXY_RE, UCP_MCP_RE, UCP_RE, WELL_KNOWN_RE, getSameOriginPath, isHydrogenServerHandoffPath, normalizeStoreDomain };
 //# sourceMappingURL=url.mjs.map

package/dist/development/core/url.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"url.mjs","names":[],"sources":["../../../src/core/url.ts"],"sourcesContent":["export const SFAPI_RE = /^\\/api\\/(unstable|2\\d{3}-\\d{2})\\/graphql\\.json$/;\nexport const SHOPIFY_API_PROXY_PREFIX = \"/__shopify\";\nexport const SHOPIFY_API_PROXY_RE = /^\\/__shopify(?:\\/|$)/;\nexport const MCP_RE = /^\\/api\\/mcp$/;\nexport const UCP_MCP_RE = /^\\/api\\/ucp\\/mcp$/;\nexport const CHECKOUT_RE = /^\\/checkout$/;\nexport const CART_PERMALINK_RE = /^\\/cart\\/\\d+:\\d+(?:,\\d+:\\d+)*$/;\nconst BUY_ITEM_PAIR = String.raw`(?:[A-Za-z0-9._-]+|~[A-Za-z0-9_-]+):[1-9]\\d*`;\n// Items are required so a storefront's own /buy pages keep routing to the app.\nexport const BUY_PERMALINK_RE = new RegExp(`^/buy/${BUY_ITEM_PAIR}(?:,${BUY_ITEM_PAIR})*$`);\nexport const CUSTOMER_ACCOUNT_PATHS = {\n  authorize: \"/account/authorize\",\n  login: \"/account/login\",\n  logout: \"/account/logout\",\n  refresh: \"/account/refresh\",\n} as const;\n\nconst CUSTOMER_ACCOUNT_HANDOFF_PATHS: ReadonlySet<string> = new Set(\n  Object.values(CUSTOMER_ACCOUNT_PATHS),\n);\n\n/**\n * Returns whether the pathname conventionally represents a Hydrogen document-level server handoff.\n *\n * Keep this aligned with the routes intercepted before framework routing. API and protocol\n * interceptors are intentionally excluded because they are not browser navigation destinations.\n */\nexport function isHydrogenServerHandoffPath(pathname: string): boolean {\n  return (\n    CHECKOUT_RE.test(pathname) ||\n    CART_PERMALINK_RE.test(pathname) ||\n    BUY_PERMALINK_RE.test(pathname) ||\n    CUSTOMER_ACCOUNT_HANDOFF_PATHS.has(pathname)\n  );\n}\n\n/**\n * Allowlisted `.well-known` resources proxied to the Online Store origin:\n * - `apple-developer-merchantid-domain-association` — Apple Pay domain verification.\n * - `shopify/fec/produce` — Frontend Event Collector ingress. On the Online\n *   Store the myshopify.com edge forwards this first-party path to the\n *   collector; headless storefronts have no such edge, so Hydrogen proxies it\n *   to the same origin (used by WebMCP's Event Refinery client).\n */\nexport const WELL_KNOWN_RE =\n  /^\\/\\.well-known\\/(?:apple-developer-merchantid-domain-association|shopify\\/fec\\/produce)$/;\nexport const AJAX_CART_RE =\n  /^(?:\\/[a-z]{2}(?:-[a-z]{2})?)?\\/cart(?:\\.(?:js|json)|\\/(?:add|update|change|clear)(?:\\.(?:js|json))?)$/i;\n\n/**\n * Normalizes `target` to a path on `origin` that is safe to use as a redirect location.\n * Returns `undefined` unless `target` is a path starting with `/` or an absolute URL,\n * stays on `origin`, and its normalized pathname does not start with `//`.\n */\nexport function getSameOriginPath(\n  target: string | null | undefined,\n  origin: string,\n): string | undefined {\n  if (!target) return undefined;\n\n  try {\n    // Parse absolute URLs without a base so scheme-relative forms like `https:evil.example`\n    // resolve to their own host, as a browser would, instead of onto `origin`.\n    const url = target.startsWith(\"/\") ? new URL(target, origin) : new URL(target);\n    if (url.origin !== origin) return undefined;\n    const path = `${url.pathname}${url.search}${url.hash}`;\n    // The parsed pathname can itself start with `//` (e.g. from `/x/..//evil`),\n    // which a redirect would resolve as a protocol-relative URL to another host.\n    return path.startsWith(\"//\") ? undefined : path;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function normalizeStoreDomain(domain: string): string {\n  if (!domain) {\n    throw new Error(\"Storefront `storeDomain` is required.\");\n  }\n\n  if (domain.startsWith(\"http://\") || domain.startsWith(\"https://\")) {\n    return domain.replace(/\\/+$/, \"\");\n  }\n  return `https://${domain}`.replace(/\\/+$/, \"\");\n}\n"],"mappings":";AAAA,MAAa,WAAW;AACxB,MAAa,2BAA2B;AACxC,MAAa,uBAAuB;AACpC,MAAa,SAAS;AACtB,MAAa,aAAa;AAC1B,MAAa,cAAc;AAC3B,MAAa,oBAAoB;AACjC,MAAM,gBAAgB,OAAO,GAAG;AAEhC,MAAa,mBAAmB,IAAI,OAAO,SAAS,cAAc,MAAM,cAAc,KAAK;AAC3F,MAAa,yBAAyB;CACpC,WAAW;CACX,OAAO;CACP,QAAQ;CACR,SAAS;CACV;AAED,MAAM,iCAAsD,IAAI,IAC9D,OAAO,OAAO,uBAAuB,CACtC;;;;;;;AAQD,SAAgB,4BAA4B,UAA2B;AACrE,QACE,YAAY,KAAK,SAAS,IAC1B,kBAAkB,KAAK,SAAS,IAChC,iBAAiB,KAAK,SAAS,IAC/B,+BAA+B,IAAI,SAAS;;;;;;;;;;AAYhD,MAAa,gBACX;AACF,MAAa,eACX;;;;;;AAOF,SAAgB,kBACd,QACA,QACoB;AACpB,KAAI,CAAC,OAAQ,QAAO;AAEpB,KAAI;EAGF,MAAM,MAAM,OAAO,WAAW,IAAI,GAAG,IAAI,IAAI,QAAQ,OAAO,GAAG,IAAI,IAAI,OAAO;AAC9E,MAAI,IAAI,WAAW,OAAQ,QAAO;EAClC,MAAM,OAAO,GAAG,IAAI,WAAW,IAAI,SAAS,IAAI;AAGhD,SAAO,KAAK,WAAW,KAAK,GAAG,SAAY;SACrC;AACN;;;AAIJ,SAAgB,qBAAqB,QAAwB;AAC3D,KAAI,CAAC,OACH,OAAM,IAAI,MAAM,wCAAwC;AAG1D,KAAI,OAAO,WAAW,UAAU,IAAI,OAAO,WAAW,WAAW,CAC/D,QAAO,OAAO,QAAQ,QAAQ,GAAG;AAEnC,QAAO,WAAW,SAAS,QAAQ,QAAQ,GAAG"}
+{"version":3,"file":"url.mjs","names":[],"sources":["../../../src/core/url.ts"],"sourcesContent":["export const SFAPI_RE = /^\\/api\\/(unstable|2\\d{3}-\\d{2})\\/graphql\\.json$/;\nexport const SHOPIFY_API_PROXY_PREFIX = \"/__shopify\";\nexport const SHOPIFY_API_PROXY_RE = /^\\/__shopify(?:\\/|$)/;\nexport const MCP_RE = /^\\/api\\/mcp$/;\nexport const UCP_MCP_RE = /^\\/api\\/ucp\\/mcp$/;\nexport const CHECKOUT_RE = /^\\/checkout$/;\nexport const CART_PERMALINK_RE = /^\\/cart\\/\\d+:\\d+(?:,\\d+:\\d+)*$/;\nconst BUY_ITEM_PAIR = String.raw`(?:[A-Za-z0-9._-]+|~[A-Za-z0-9_-]+):[1-9]\\d*`;\n// Items are required so a storefront's own /buy pages keep routing to the app.\nexport const BUY_PERMALINK_RE = new RegExp(`^/buy/${BUY_ITEM_PAIR}(?:,${BUY_ITEM_PAIR})*$`);\nexport const CUSTOMER_ACCOUNT_PATHS = {\n  authorize: \"/account/authorize\",\n  login: \"/account/login\",\n  logout: \"/account/logout\",\n  refresh: \"/account/refresh\",\n} as const;\n\nconst CUSTOMER_ACCOUNT_HANDOFF_PATHS: ReadonlySet<string> = new Set(\n  Object.values(CUSTOMER_ACCOUNT_PATHS),\n);\n\n/**\n * Returns whether the pathname conventionally represents a Hydrogen document-level server handoff.\n *\n * Keep this aligned with the routes intercepted before framework routing. API and protocol\n * interceptors are intentionally excluded because they are not browser navigation destinations.\n */\nexport function isHydrogenServerHandoffPath(pathname: string): boolean {\n  return (\n    CHECKOUT_RE.test(pathname) ||\n    CART_PERMALINK_RE.test(pathname) ||\n    BUY_PERMALINK_RE.test(pathname) ||\n    CUSTOMER_ACCOUNT_HANDOFF_PATHS.has(pathname)\n  );\n}\n\n// UCP profiles need JSON validation and caching separate from the other well-known resources.\nexport const UCP_RE = /^\\/\\.well-known\\/ucp$/;\n\n/**\n * Allowlisted `.well-known` resources proxied to the Online Store origin:\n * - `apple-developer-merchantid-domain-association` — Apple Pay domain verification.\n * - `shopify/fec/produce` — Frontend Event Collector ingress. On the Online\n *   Store the myshopify.com edge forwards this first-party path to the\n *   collector; headless storefronts have no such edge, so Hydrogen proxies it\n *   to the same origin (used by WebMCP's Event Refinery client).\n */\nexport const WELL_KNOWN_RE =\n  /^\\/\\.well-known\\/(?:apple-developer-merchantid-domain-association|shopify\\/fec\\/produce)$/;\nexport const AJAX_CART_RE =\n  /^(?:\\/[a-z]{2}(?:-[a-z]{2})?)?\\/cart(?:\\.(?:js|json)|\\/(?:add|update|change|clear)(?:\\.(?:js|json))?)$/i;\n\n/**\n * Normalizes `target` to a path on `origin` that is safe to use as a redirect location.\n * Returns `undefined` unless `target` is a path starting with `/` or an absolute URL,\n * stays on `origin`, and its normalized pathname does not start with `//`.\n */\nexport function getSameOriginPath(\n  target: string | null | undefined,\n  origin: string,\n): string | undefined {\n  if (!target) return undefined;\n\n  try {\n    // Parse absolute URLs without a base so scheme-relative forms like `https:evil.example`\n    // resolve to their own host, as a browser would, instead of onto `origin`.\n    const url = target.startsWith(\"/\") ? new URL(target, origin) : new URL(target);\n    if (url.origin !== origin) return undefined;\n    const path = `${url.pathname}${url.search}${url.hash}`;\n    // The parsed pathname can itself start with `//` (e.g. from `/x/..//evil`),\n    // which a redirect would resolve as a protocol-relative URL to another host.\n    return path.startsWith(\"//\") ? undefined : path;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function normalizeStoreDomain(domain: string): string {\n  if (!domain) {\n    throw new Error(\"Storefront `storeDomain` is required.\");\n  }\n\n  if (domain.startsWith(\"http://\") || domain.startsWith(\"https://\")) {\n    return domain.replace(/\\/+$/, \"\");\n  }\n  return `https://${domain}`.replace(/\\/+$/, \"\");\n}\n"],"mappings":";AAAA,MAAa,WAAW;AACxB,MAAa,2BAA2B;AACxC,MAAa,uBAAuB;AACpC,MAAa,SAAS;AACtB,MAAa,aAAa;AAC1B,MAAa,cAAc;AAC3B,MAAa,oBAAoB;AACjC,MAAM,gBAAgB,OAAO,GAAG;AAEhC,MAAa,mBAAmB,IAAI,OAAO,SAAS,cAAc,MAAM,cAAc,KAAK;AAC3F,MAAa,yBAAyB;CACpC,WAAW;CACX,OAAO;CACP,QAAQ;CACR,SAAS;CACV;AAED,MAAM,iCAAsD,IAAI,IAC9D,OAAO,OAAO,uBAAuB,CACtC;;;;;;;AAQD,SAAgB,4BAA4B,UAA2B;AACrE,QACE,YAAY,KAAK,SAAS,IAC1B,kBAAkB,KAAK,SAAS,IAChC,iBAAiB,KAAK,SAAS,IAC/B,+BAA+B,IAAI,SAAS;;AAKhD,MAAa,SAAS;;;;;;;;;AAUtB,MAAa,gBACX;AACF,MAAa,eACX;;;;;;AAOF,SAAgB,kBACd,QACA,QACoB;AACpB,KAAI,CAAC,OAAQ,QAAO;AAEpB,KAAI;EAGF,MAAM,MAAM,OAAO,WAAW,IAAI,GAAG,IAAI,IAAI,QAAQ,OAAO,GAAG,IAAI,IAAI,OAAO;AAC9E,MAAI,IAAI,WAAW,OAAQ,QAAO;EAClC,MAAM,OAAO,GAAG,IAAI,WAAW,IAAI,SAAS,IAAI;AAGhD,SAAO,KAAK,WAAW,KAAK,GAAG,SAAY;SACrC;AACN;;;AAIJ,SAAgB,qBAAqB,QAAwB;AAC3D,KAAI,CAAC,OACH,OAAM,IAAI,MAAM,wCAAwC;AAG1D,KAAI,OAAO,WAAW,UAAU,IAAI,OAAO,WAAW,WAAW,CAC/D,QAAO,OAAO,QAAQ,QAAQ,GAAG;AAEnC,QAAO,WAAW,SAAS,QAAQ,QAAQ,GAAG"}