@shopify/hydrogen 2026.10.0-preview.4 → 2026.10.0

package/dist/core/collection/url.d.mts

@@ -4,70 +4,111 @@ import { CollectionState } from "./state.mjs";
 
 //#region src/core/collection/url.d.ts
 /**
- * Parsed collection URL parameters — the subset of {@link CollectionState}
- * that is derived from the URL query string.
+ * The filters, sort key, and sort direction in a collection URL.
  */
 interface CollectionParams {
-  /** Active product filters parsed from `filter.*` URL keys. */
+  /**
+   * Active product filters from the `filter.*` URL params.
+   *
+   * The filters use the Storefront Standard Events filter type. When your query variables use generated Storefront API types, cast the filters to the generated filter type where you pass them as variables.
+   */
   filters: ProductFilter[];
-  /** Storefront API sort key parsed from the `sort_by` param. `undefined` when absent. */
+  /** Storefront API sort key from the `sort_by` param, or `undefined` when the param is missing or unrecognized. */
   sortKey: ProductCollectionSortKeys | undefined;
   /** `true` when the `sort_by` value ends with `-descending`. */
   reverse: boolean;
 }
 /**
- * Extracts collection state from URL search params.
+ * Reads collection filters and sort from URL search params. Pass the result to your Storefront API collection query.
  *
- * Handles Liquid-compatible filter keys (`filter.p.*`, `filter.v.*`)
- * and the `sort_by` param (with optional `-descending`/`-ascending` suffix).
+ * The function reads Liquid-compatible `filter.p.*` and `filter.v.*` keys and the `sort_by` param.
  *
- * @param searchParams - URL search params to parse
+ * A URL that sets availability to both in stock and out of stock produces no availability filter. The function recognizes the best-selling and manual sort values, plus created, price, and title with an ascending or descending suffix. For other sort values, the sort key is `undefined`. The `parseSortByValue` function also recognizes relevance, collection default, and ID.
+ *
+ * @param searchParams - URL search params to read.
+ * @returns The filters, sort key, and sort direction from the URL.
+ * @publicDocs
  */
 declare function parseCollectionParams(searchParams: URLSearchParams): CollectionParams;
 /**
- * Serializes collection state into URL search params using Liquid-compatible keys.
+ * Converts collection filters and sort to URL search params with Liquid-compatible keys. Use the result to build collection URLs.
+ *
+ * The result holds only the `filter.*` and `sort_by` keys. The function leaves out `sort_by` for the collection's default sort.
  *
- * Only emits store-owned keys (`filter.*`, `sort_by`).
- * Omits `sort_by` when `sortKey` is `undefined` (collection default).
+ * Category filters convert to `filter.p.category`, which `parseCollectionParams` doesn't read. A price filter with a minimum and a maximum produces two params. To build a filter checkbox, parse a filter value's `input` string and convert the parsed filter. The resulting entries give the checkbox name and value.
  *
- * @param state - The filter/sort slice of collection state
+ * @param state - The filters, sort key, and sort direction to convert.
+ * @returns URL search params that hold the filters and sort.
+ * @publicDocs
  */
 declare function serializeCollectionParams(state: Pick<CollectionState, "filters" | "sortKey" | "reverse">): URLSearchParams;
-/** Normalizes a router search string for comparison (strips a leading `?`). */
+/**
+ * Removes a leading `?` from a search string. Normalize search strings before you compare them.
+ *
+ * @param search The search string from your router, with or without a leading `?`.
+ * @returns The search string without a leading `?`.
+ * @publicDocs
+ */
 declare function normalizeCollectionSearch(search: string): string;
 /**
- * Builds a URL query string with the given filter removed from the current params.
+ * Builds a query string from the current URL params, minus the given filter. Use the string in plain remove-filter links.
+ *
+ * The function keeps every other param and drops the `before` and `after` pagination cursors, which sends the customer to the first page of results.
  *
- * Clears pagination cursors so the changed filter state starts from its first page.
- * Returns `"?"` when removing the filter leaves no params. Useful for
- * rendering "remove filter" links without updating store state.
+ * @param currentParams The current URL search params.
+ * @param filter The filter to remove from the URL.
+ * @returns A query string that starts with `?`. The string is `?` alone when no params remain.
+ * @publicDocs
  */
 declare function getFilterRemovalUrl(currentParams: URLSearchParams, filter: ProductFilter): string;
 /**
- * Converts a Storefront API sort key and direction into the Liquid-compatible
- * `sort_by` param value (e.g. `"price-ascending"`, `"best-selling"`).
+ * Converts a Storefront API sort key and direction to a Liquid-compatible
+ * `sort_by` value, such as `price-ascending` or `best-selling`.
  *
- * Direction suffixes are only appended for sort keys that support them
- * (`PRICE`, `TITLE`, `CREATED`, `ID`). Others (like `BEST_SELLING`) return
- * the base value regardless of the `reverse` flag.
+ * Only the price, title, created, and ID sort keys get a direction suffix.
+ * Other sort keys, such as best selling, ignore the direction.
  *
- * @param sortKey - Storefront API `ProductCollectionSortKeys` enum value
- * @param reverse - `true` for descending, `false` for ascending
+ * @param sortKey - Storefront API product collection sort key.
+ * @param reverse - `true` for descending, `false` for ascending.
+ * @returns The value for the `sort_by` URL param.
+ * @publicDocs
  */
 declare function getSortByValue(sortKey: ProductCollectionSortKeys, reverse: boolean): string;
 /**
- * Parses a Liquid-compatible `sort_by` value back into the Storefront API
- * sort key and direction. Inverse of {@link getSortByValue}.
+ * Converts a Liquid-compatible `sort_by` value to a Storefront API
+ * sort key and direction. The `getSortByValue` function does the opposite conversion.
  *
- * @param value - A `sort_by` param value (e.g. `"price-ascending"`, `"best-selling"`)
+ * For unrecognized values, the sort key is `undefined`.
+ *
+ * @param value - A `sort_by` value, such as `price-ascending` or `best-selling`.
+ * @returns The sort key and `reverse`, which reads `true` for descending values.
+ * @publicDocs
  */
 declare function parseSortByValue(value: string): {
   sortKey: ProductCollectionSortKeys | undefined;
   reverse: boolean;
 };
-/** Compares two individual {@link ProductFilter} objects for semantic equality. */
+/**
+ * Checks whether two product filters match.
+ *
+ * Price filters match when the minimum and maximum are equal, including ranges that set only one bound.
+ *
+ * @param a The first filter to compare.
+ * @param b The second filter to compare.
+ * @returns `true` when both filters are the same kind with the same values. `false` for different kinds or unrecognized filters.
+ * @publicDocs
+ */
 declare function filterEquals(a: ProductFilter, b: ProductFilter): boolean;
-/** Returns `true` when `input` (a Storefront API filter JSON string) matches an active filter. */
+/**
+ * Checks whether a filter value's `input` JSON string from the Storefront API matches an active filter. Use the result to set the checked state of a filter control.
+ *
+ * The function compares filters the same way as `filterEquals`.
+ *
+ * @param activeFilters The active filters, such as `filters` from the collection state.
+ * @param input The filter value's `input` JSON string.
+ * @returns `true` when the parsed input matches an active filter. `false` when the input matches no active filter or isn't valid JSON.
+ * @publicDocs
+ */
 declare function isFilterInputActive(activeFilters: ProductFilter[], input: string): boolean;
 //#endregion
 export { CollectionParams, filterEquals, getFilterRemovalUrl, getSortByValue, isFilterInputActive, normalizeCollectionSearch, parseCollectionParams, parseSortByValue, serializeCollectionParams };

package/dist/core/collection/url.mjs

@@ -24,12 +24,15 @@ const STANDARD_EVENTS_COLLECTION_SORT_KEY = {
 	manual: "MANUAL"
 };
 /**
-* Extracts collection state from URL search params.
+* Reads collection filters and sort from URL search params. Pass the result to your Storefront API collection query.
 *
-* Handles Liquid-compatible filter keys (`filter.p.*`, `filter.v.*`)
-* and the `sort_by` param (with optional `-descending`/`-ascending` suffix).
+* The function reads Liquid-compatible `filter.p.*` and `filter.v.*` keys and the `sort_by` param.
 *
-* @param searchParams - URL search params to parse
+* A URL that sets availability to both in stock and out of stock produces no availability filter. The function recognizes the best-selling and manual sort values, plus created, price, and title with an ascending or descending suffix. For other sort values, the sort key is `undefined`. The `parseSortByValue` function also recognizes relevance, collection default, and ID.
+*
+* @param searchParams - URL search params to read.
+* @returns The filters, sort key, and sort direction from the URL.
+* @publicDocs
 */
 function parseCollectionParams(searchParams) {
 	return {
@@ -39,12 +42,15 @@ function parseCollectionParams(searchParams) {
 	};
 }
 /**
-* Serializes collection state into URL search params using Liquid-compatible keys.
+* Converts collection filters and sort to URL search params with Liquid-compatible keys. Use the result to build collection URLs.
+*
+* The result holds only the `filter.*` and `sort_by` keys. The function leaves out `sort_by` for the collection's default sort.
 *
-* Only emits store-owned keys (`filter.*`, `sort_by`).
-* Omits `sort_by` when `sortKey` is `undefined` (collection default).
+* Category filters convert to `filter.p.category`, which `parseCollectionParams` doesn't read. A price filter with a minimum and a maximum produces two params. To build a filter checkbox, parse a filter value's `input` string and convert the parsed filter. The resulting entries give the checkbox name and value.
 *
-* @param state - The filter/sort slice of collection state
+* @param state - The filters, sort key, and sort direction to convert.
+* @returns URL search params that hold the filters and sort.
+* @publicDocs
 */
 function serializeCollectionParams(state) {
 	const params = new URLSearchParams();
@@ -56,7 +62,13 @@ function serializeCollectionParams(state) {
 function isStoreOwnedParam(key) {
 	return key === "sort_by" || key.startsWith("filter.");
 }
-/** Normalizes a router search string for comparison (strips a leading `?`). */
+/**
+* Removes a leading `?` from a search string. Normalize search strings before you compare them.
+*
+* @param search The search string from your router, with or without a leading `?`.
+* @returns The search string without a leading `?`.
+* @publicDocs
+*/
 function normalizeCollectionSearch(search) {
 	return search.startsWith("?") ? search.slice(1) : search;
 }
@@ -85,11 +97,14 @@ function collectionParamsMatchState(searchParams, state) {
 	return parsed.sortKey === state.sortKey && parsed.reverse === state.reverse && filtersEqual(parsed.filters, state.filters);
 }
 /**
-* Builds a URL query string with the given filter removed from the current params.
+* Builds a query string from the current URL params, minus the given filter. Use the string in plain remove-filter links.
+*
+* The function keeps every other param and drops the `before` and `after` pagination cursors, which sends the customer to the first page of results.
 *
-* Clears pagination cursors so the changed filter state starts from its first page.
-* Returns `"?"` when removing the filter leaves no params. Useful for
-* rendering "remove filter" links without updating store state.
+* @param currentParams The current URL search params.
+* @param filter The filter to remove from the URL.
+* @returns A query string that starts with `?`. The string is `?` alone when no params remain.
+* @publicDocs
 */
 function getFilterRemovalUrl(currentParams, filter) {
 	const result = new URLSearchParams(currentParams);
@@ -103,15 +118,16 @@ function isDirectionalSortKey(sortKey) {
 	return sortKey === "PRICE" || sortKey === "TITLE" || sortKey === "CREATED" || sortKey === "ID";
 }
 /**
-* Converts a Storefront API sort key and direction into the Liquid-compatible
-* `sort_by` param value (e.g. `"price-ascending"`, `"best-selling"`).
+* Converts a Storefront API sort key and direction to a Liquid-compatible
+* `sort_by` value, such as `price-ascending` or `best-selling`.
 *
-* Direction suffixes are only appended for sort keys that support them
-* (`PRICE`, `TITLE`, `CREATED`, `ID`). Others (like `BEST_SELLING`) return
-* the base value regardless of the `reverse` flag.
+* Only the price, title, created, and ID sort keys get a direction suffix.
+* Other sort keys, such as best selling, ignore the direction.
 *
-* @param sortKey - Storefront API `ProductCollectionSortKeys` enum value
-* @param reverse - `true` for descending, `false` for ascending
+* @param sortKey - Storefront API product collection sort key.
+* @param reverse - `true` for descending, `false` for ascending.
+* @returns The value for the `sort_by` URL param.
+* @publicDocs
 */
 function getSortByValue(sortKey, reverse) {
 	const base = SORT_KEY_TO_SORT_BY[sortKey] ?? sortKey.toLowerCase();
@@ -119,10 +135,14 @@ function getSortByValue(sortKey, reverse) {
 	return reverse ? `${base}-descending` : `${base}-ascending`;
 }
 /**
-* Parses a Liquid-compatible `sort_by` value back into the Storefront API
-* sort key and direction. Inverse of {@link getSortByValue}.
+* Converts a Liquid-compatible `sort_by` value to a Storefront API
+* sort key and direction. The `getSortByValue` function does the opposite conversion.
 *
-* @param value - A `sort_by` param value (e.g. `"price-ascending"`, `"best-selling"`)
+* For unrecognized values, the sort key is `undefined`.
+*
+* @param value - A `sort_by` value, such as `price-ascending` or `best-selling`.
+* @returns The sort key and `reverse`, which reads `true` for descending values.
+* @publicDocs
 */
 function parseSortByValue(value) {
 	if (value.endsWith(SORT_BY_DESCENDING_SUFFIX)) return {
@@ -283,7 +303,16 @@ function removeFilterParams(params, filter) {
 function clearPaginationCursors(params) {
 	for (const key of PAGINATION_CURSOR_PARAMS) params.delete(key);
 }
-/** Compares two individual {@link ProductFilter} objects for semantic equality. */
+/**
+* Checks whether two product filters match.
+*
+* Price filters match when the minimum and maximum are equal, including ranges that set only one bound.
+*
+* @param a The first filter to compare.
+* @param b The second filter to compare.
+* @returns `true` when both filters are the same kind with the same values. `false` for different kinds or unrecognized filters.
+* @publicDocs
+*/
 function filterEquals(a, b) {
 	const kindA = filterKind(a);
 	if (kindA !== filterKind(b) || kindA == null) return false;
@@ -325,7 +354,16 @@ function filterEquals(a, b) {
 		}
 	}
 }
-/** Returns `true` when `input` (a Storefront API filter JSON string) matches an active filter. */
+/**
+* Checks whether a filter value's `input` JSON string from the Storefront API matches an active filter. Use the result to set the checked state of a filter control.
+*
+* The function compares filters the same way as `filterEquals`.
+*
+* @param activeFilters The active filters, such as `filters` from the collection state.
+* @param input The filter value's `input` JSON string.
+* @returns `true` when the parsed input matches an active filter. `false` when the input matches no active filter or isn't valid JSON.
+* @publicDocs
+*/
 function isFilterInputActive(activeFilters, input) {
 	let parsed;
 	try {

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

@@ -1 +1 @@
-{"version":3,"file":"url.mjs","names":[],"sources":["../../../src/core/collection/url.ts"],"sourcesContent":["import type { ProductFilter } from \"../../../vendor/standard-events\";\nimport type { ProductCollectionSortKeys } from \"../../graphql/generated/storefront-api-types\";\nimport type { CollectionState } from \"./state\";\n\n/**\n * Parsed collection URL parameters — the subset of {@link CollectionState}\n * that is derived from the URL query string.\n */\nexport interface CollectionParams {\n  /** Active product filters parsed from `filter.*` URL keys. */\n  filters: ProductFilter[];\n  /** Storefront API sort key parsed from the `sort_by` param. `undefined` when absent. */\n  sortKey: ProductCollectionSortKeys | undefined;\n  /** `true` when the `sort_by` value ends with `-descending`. */\n  reverse: boolean;\n}\n\nconst SORT_BY_DESCENDING_SUFFIX = \"-descending\";\nconst SORT_BY_ASCENDING_SUFFIX = \"-ascending\";\nconst PAGINATION_CURSOR_PARAMS: readonly string[] = [\"before\", \"after\"];\n\nconst SORT_KEY_TO_SORT_BY: Record<string, string> = {\n  BEST_SELLING: \"best-selling\",\n  CREATED: \"created\",\n  PRICE: \"price\",\n  TITLE: \"title\",\n  MANUAL: \"manual\",\n  ID: \"id\",\n  RELEVANCE: \"relevance\",\n  COLLECTION_DEFAULT: \"collection-default\",\n};\n\nconst SORT_BY_TO_SORT_KEY: Record<string, ProductCollectionSortKeys> = Object.fromEntries(\n  Object.entries(SORT_KEY_TO_SORT_BY).map(([key, value]) => [\n    value,\n    key as ProductCollectionSortKeys,\n  ]),\n);\n\nconst STANDARD_EVENTS_COLLECTION_SORT_KEY: Record<string, ProductCollectionSortKeys> = {\n  \"best-selling\": \"BEST_SELLING\",\n  \"created-ascending\": \"CREATED\",\n  \"created-descending\": \"CREATED\",\n  \"price-ascending\": \"PRICE\",\n  \"price-descending\": \"PRICE\",\n  \"title-ascending\": \"TITLE\",\n  \"title-descending\": \"TITLE\",\n  manual: \"MANUAL\",\n};\n\n/**\n * Extracts collection state from URL search params.\n *\n * Handles Liquid-compatible filter keys (`filter.p.*`, `filter.v.*`)\n * and the `sort_by` param (with optional `-descending`/`-ascending` suffix).\n *\n * @param searchParams - URL search params to parse\n */\nexport function parseCollectionParams(searchParams: URLSearchParams): CollectionParams {\n  const filters = parseProductFilters(searchParams);\n  const sortKey = parseCollectionSortKey(searchParams);\n  const rawSortBy = searchParams.get(\"sort_by\");\n  const reverse = rawSortBy?.endsWith(SORT_BY_DESCENDING_SUFFIX) ?? false;\n\n  return { filters, sortKey, reverse };\n}\n\n/**\n * Serializes collection state into URL search params using Liquid-compatible keys.\n *\n * Only emits store-owned keys (`filter.*`, `sort_by`).\n * Omits `sort_by` when `sortKey` is `undefined` (collection default).\n *\n * @param state - The filter/sort slice of collection state\n */\nexport function serializeCollectionParams(\n  state: Pick<CollectionState, \"filters\" | \"sortKey\" | \"reverse\">,\n): URLSearchParams {\n  const params = new URLSearchParams();\n\n  for (const filter of state.filters) {\n    serializeFilter(params, filter);\n  }\n\n  if (state.sortKey) {\n    params.set(\"sort_by\", getSortByValue(state.sortKey, state.reverse));\n  }\n\n  return params;\n}\n\n/** Returns `true` when the param key is owned by the collection store. */\nfunction isStoreOwnedParam(key: string): boolean {\n  return key === \"sort_by\" || key.startsWith(\"filter.\");\n}\n\n/** Normalizes a router search string for comparison (strips a leading `?`). */\nexport function normalizeCollectionSearch(search: string): string {\n  return search.startsWith(\"?\") ? search.slice(1) : search;\n}\n\n/**\n * Merges store-owned params from `state` into `existing`, preserving\n * unrelated keys (e.g. `grid`, `view`) already present in the URL. Collection\n * pagination cursors (`before`, `after`) are cleared so changed browse intent\n * starts from the first page.\n */\nexport function mergeCollectionParams(\n  existing: URLSearchParams,\n  state: Pick<CollectionState, \"filters\" | \"sortKey\" | \"reverse\">,\n): URLSearchParams {\n  const merged = new URLSearchParams(existing);\n\n  for (const key of Array.from(merged.keys())) {\n    if (isStoreOwnedParam(key)) {\n      merged.delete(key);\n    }\n  }\n\n  clearPaginationCursors(merged);\n\n  for (const [key, value] of serializeCollectionParams(state)) {\n    merged.append(key, value);\n  }\n\n  return merged;\n}\n\n/** Returns `true` when two router search strings describe the same collection filters and sort. */\nexport function collectionSearchEqual(a: string, b: string): boolean {\n  const parsedA = parseCollectionParams(new URLSearchParams(normalizeCollectionSearch(a)));\n  const parsedB = parseCollectionParams(new URLSearchParams(normalizeCollectionSearch(b)));\n\n  return (\n    parsedA.sortKey === parsedB.sortKey &&\n    parsedA.reverse === parsedB.reverse &&\n    filtersEqual(parsedA.filters, parsedB.filters)\n  );\n}\n\n/** Returns `true` when URL params and collection browse state describe the same filters and sort. */\nexport function collectionParamsMatchState(\n  searchParams: URLSearchParams,\n  state: Pick<CollectionState, \"filters\" | \"sortKey\" | \"reverse\">,\n): boolean {\n  const parsed = parseCollectionParams(searchParams);\n\n  return (\n    parsed.sortKey === state.sortKey &&\n    parsed.reverse === state.reverse &&\n    filtersEqual(parsed.filters, state.filters)\n  );\n}\n\n/**\n * Builds a URL query string with the given filter removed from the current params.\n *\n * Clears pagination cursors so the changed filter state starts from its first page.\n * Returns `\"?\"` when removing the filter leaves no params. Useful for\n * rendering \"remove filter\" links without updating store state.\n */\nexport function getFilterRemovalUrl(currentParams: URLSearchParams, filter: ProductFilter): string {\n  const result = new URLSearchParams(currentParams);\n  removeFilterParams(result, filter);\n  clearPaginationCursors(result);\n  const serialized = result.toString();\n  return serialized ? `?${serialized}` : \"?\";\n}\n\n/** Returns `true` when the sort key supports ascending/descending direction suffixes. */\nexport function isDirectionalSortKey(sortKey: ProductCollectionSortKeys): boolean {\n  return sortKey === \"PRICE\" || sortKey === \"TITLE\" || sortKey === \"CREATED\" || sortKey === \"ID\";\n}\n\n/**\n * Converts a Storefront API sort key and direction into the Liquid-compatible\n * `sort_by` param value (e.g. `\"price-ascending\"`, `\"best-selling\"`).\n *\n * Direction suffixes are only appended for sort keys that support them\n * (`PRICE`, `TITLE`, `CREATED`, `ID`). Others (like `BEST_SELLING`) return\n * the base value regardless of the `reverse` flag.\n *\n * @param sortKey - Storefront API `ProductCollectionSortKeys` enum value\n * @param reverse - `true` for descending, `false` for ascending\n */\nexport function getSortByValue(sortKey: ProductCollectionSortKeys, reverse: boolean): string {\n  const base = SORT_KEY_TO_SORT_BY[sortKey] ?? sortKey.toLowerCase();\n\n  if (!isDirectionalSortKey(sortKey)) return base;\n\n  return reverse ? `${base}-descending` : `${base}-ascending`;\n}\n\n/**\n * Parses a Liquid-compatible `sort_by` value back into the Storefront API\n * sort key and direction. Inverse of {@link getSortByValue}.\n *\n * @param value - A `sort_by` param value (e.g. `\"price-ascending\"`, `\"best-selling\"`)\n */\nexport function parseSortByValue(value: string): {\n  sortKey: ProductCollectionSortKeys | undefined;\n  reverse: boolean;\n} {\n  if (value.endsWith(SORT_BY_DESCENDING_SUFFIX)) {\n    const base = value.slice(0, -SORT_BY_DESCENDING_SUFFIX.length);\n    return { sortKey: SORT_BY_TO_SORT_KEY[base], reverse: true };\n  }\n\n  if (value.endsWith(SORT_BY_ASCENDING_SUFFIX)) {\n    const base = value.slice(0, -SORT_BY_ASCENDING_SUFFIX.length);\n    return { sortKey: SORT_BY_TO_SORT_KEY[base], reverse: false };\n  }\n\n  return { sortKey: SORT_BY_TO_SORT_KEY[value], reverse: false };\n}\n\n/**\n * Mirrors `parseProductFilters` from storefront-standard-events.\n *\n * Keep this local because Hydrogen only vendors Standard Events\n * declarations, so importing CollectionUpdateEvent would require runtime JS.\n */\nfunction parseProductFilters(searchParams: URLSearchParams): ProductFilter[] {\n  const filters: ProductFilter[] = [];\n  const price: ProductFilter[\"price\"] = {};\n  const minPrice = searchParams.get(\"filter.v.price.gte\");\n  const maxPrice = searchParams.get(\"filter.v.price.lte\");\n\n  if (minPrice) price.min = parseLocalizedNumber(minPrice);\n  if (maxPrice) price.max = parseLocalizedNumber(maxPrice);\n  if (price.min !== undefined || price.max !== undefined) filters.push({ price });\n\n  const availability = searchParams.getAll(\"filter.v.availability\");\n  const inStock = availability.includes(\"1\");\n  const outOfStock = availability.includes(\"0\");\n  if (inStock && !outOfStock) filters.push({ available: true });\n  if (outOfStock && !inStock) filters.push({ available: false });\n\n  for (const productType of searchParams.getAll(\"filter.p.product_type\")) {\n    filters.push({ productType });\n  }\n\n  for (const productVendor of searchParams.getAll(\"filter.p.vendor\")) {\n    filters.push({ productVendor });\n  }\n\n  for (const tag of searchParams.getAll(\"filter.p.tag\")) {\n    filters.push({ tag });\n  }\n\n  for (const [key, value] of searchParams) {\n    let match: RegExpMatchArray | null;\n\n    if ((match = key.match(/^filter\\.v\\.option\\.(.+)$/))) {\n      filters.push({ variantOption: { name: decodeFilterKeyPart(match[1]), value } });\n      continue;\n    }\n\n    if ((match = key.match(/^filter\\.p\\.m\\.([^.]+)\\.(.+)$/))) {\n      filters.push({\n        productMetafield: {\n          namespace: decodeFilterKeyPart(match[1]),\n          key: decodeFilterKeyPart(match[2]),\n          value,\n        },\n      });\n      continue;\n    }\n\n    if ((match = key.match(/^filter\\.v\\.m\\.([^.]+)\\.(.+)$/))) {\n      filters.push({\n        variantMetafield: {\n          namespace: decodeFilterKeyPart(match[1]),\n          key: decodeFilterKeyPart(match[2]),\n          value,\n        },\n      });\n      continue;\n    }\n\n    if ((match = key.match(/^filter\\.v\\.t\\.([^.]+)\\.(.+)$/))) {\n      filters.push({\n        taxonomyMetafield: {\n          key: `${decodeFilterKeyPart(match[1])}.${decodeFilterKeyPart(match[2])}`,\n          value,\n        },\n      });\n    }\n  }\n\n  return filters;\n}\n\n/** Mirrors `getCollectionSortKey` from storefront-standard-events. */\nfunction parseCollectionSortKey(\n  searchParams: URLSearchParams,\n): ProductCollectionSortKeys | undefined {\n  const rawSortBy = searchParams.get(\"sort_by\");\n  return rawSortBy ? STANDARD_EVENTS_COLLECTION_SORT_KEY[rawSortBy] : undefined;\n}\n\nfunction parseLocalizedNumber(value: string): number {\n  try {\n    const locale = typeof window !== \"undefined\" ? window.Shopify?.locale : undefined;\n    const parts = new Intl.NumberFormat(locale ?? \"en\").formatToParts(1234.5);\n    const group = parts.find((part) => part.type === \"group\")?.value ?? \",\";\n    const decimal = parts.find((part) => part.type === \"decimal\")?.value ?? \".\";\n    const normalized = value.split(group).join(\"\").replace(decimal, \".\");\n    const number = Number(normalized);\n    if (!Number.isNaN(number)) return number;\n  } catch {}\n\n  return Number(value.replace(/[^\\d.]/g, \"\")) || 0;\n}\n\nfunction decodeFilterKeyPart(value: string): string {\n  return decodeURIComponent(value.replace(/\\+/g, \" \"));\n}\n\nfunction getFilterParamEntries(filter: ProductFilter): Array<{ key: string; value: string }> {\n  const entries: Array<{ key: string; value: string }> = [];\n\n  if (filter.available != null) {\n    entries.push({ key: \"filter.v.availability\", value: filter.available ? \"1\" : \"0\" });\n  }\n\n  if (filter.price) {\n    if (filter.price.min != null) {\n      entries.push({ key: \"filter.v.price.gte\", value: String(filter.price.min) });\n    }\n    if (filter.price.max != null) {\n      entries.push({ key: \"filter.v.price.lte\", value: String(filter.price.max) });\n    }\n  }\n\n  if (filter.productType != null) {\n    entries.push({ key: \"filter.p.product_type\", value: filter.productType });\n  }\n\n  if (filter.productVendor != null) {\n    entries.push({ key: \"filter.p.vendor\", value: filter.productVendor });\n  }\n\n  if (filter.tag != null) {\n    entries.push({ key: \"filter.p.tag\", value: filter.tag });\n  }\n\n  if (filter.variantOption) {\n    entries.push({\n      key: `filter.v.option.${encodeURIComponent(filter.variantOption.name)}`,\n      value: filter.variantOption.value ?? \"\",\n    });\n  }\n\n  if (filter.productMetafield) {\n    const { namespace, key, value } = filter.productMetafield;\n    entries.push({\n      key: `filter.p.m.${encodeURIComponent(namespace)}.${encodeURIComponent(key)}`,\n      value: value ?? \"\",\n    });\n  }\n\n  if (filter.variantMetafield) {\n    const { namespace, key, value } = filter.variantMetafield;\n    entries.push({\n      key: `filter.v.m.${encodeURIComponent(namespace)}.${encodeURIComponent(key)}`,\n      value: value ?? \"\",\n    });\n  }\n\n  if (filter.taxonomyMetafield) {\n    const fullKey = filter.taxonomyMetafield.key;\n    const dotIdx = fullKey.indexOf(\".\");\n    const ns = dotIdx >= 0 ? fullKey.slice(0, dotIdx) : fullKey;\n    const k = dotIdx >= 0 ? fullKey.slice(dotIdx + 1) : \"\";\n    entries.push({\n      key: `filter.v.t.${encodeURIComponent(ns)}.${encodeURIComponent(k)}`,\n      value: filter.taxonomyMetafield.value,\n    });\n  }\n\n  if (filter.category) {\n    entries.push({ key: \"filter.p.category\", value: filter.category.id });\n  }\n\n  return entries;\n}\n\nfunction serializeFilter(params: URLSearchParams, filter: ProductFilter): void {\n  for (const { key, value } of getFilterParamEntries(filter)) {\n    params.append(key, value);\n  }\n}\n\nfunction removeFilterParams(params: URLSearchParams, filter: ProductFilter): void {\n  for (const { key, value } of getFilterParamEntries(filter)) {\n    removeParamValue(params, key, value);\n  }\n}\n\nfunction clearPaginationCursors(params: URLSearchParams): void {\n  for (const key of PAGINATION_CURSOR_PARAMS) {\n    params.delete(key);\n  }\n}\n\n/** Compares two individual {@link ProductFilter} objects for semantic equality. */\nexport function filterEquals(a: ProductFilter, b: ProductFilter): boolean {\n  const kindA = filterKind(a);\n  const kindB = filterKind(b);\n  if (kindA !== kindB || kindA == null) return false;\n\n  switch (kindA) {\n    case \"tag\":\n      return a.tag === b.tag;\n    case \"available\":\n      return a.available === b.available;\n    case \"price\":\n      return priceRangeEquals(a.price, b.price);\n    case \"productType\":\n      return a.productType === b.productType;\n    case \"productVendor\":\n      return a.productVendor === b.productVendor;\n    case \"variantOption\": {\n      const aOpt = a.variantOption;\n      const bOpt = b.variantOption;\n      if (aOpt == null || bOpt == null) return false;\n      return aOpt.name === bOpt.name && (aOpt.value ?? \"\") === (bOpt.value ?? \"\");\n    }\n    case \"productMetafield\": {\n      const aMeta = a.productMetafield;\n      const bMeta = b.productMetafield;\n      if (aMeta == null || bMeta == null) return false;\n      return metafieldEquals(aMeta, bMeta);\n    }\n    case \"variantMetafield\": {\n      const aMeta = a.variantMetafield;\n      const bMeta = b.variantMetafield;\n      if (aMeta == null || bMeta == null) return false;\n      return metafieldEquals(aMeta, bMeta);\n    }\n    case \"taxonomyMetafield\": {\n      const aMeta = a.taxonomyMetafield;\n      const bMeta = b.taxonomyMetafield;\n      if (aMeta == null || bMeta == null) return false;\n      return aMeta.key === bMeta.key && aMeta.value === bMeta.value;\n    }\n    case \"category\": {\n      const aCat = a.category;\n      const bCat = b.category;\n      if (aCat == null || bCat == null) return false;\n      return aCat.id === bCat.id;\n    }\n  }\n}\n\n/** Returns `true` when `input` (a Storefront API filter JSON string) matches an active filter. */\nexport function isFilterInputActive(activeFilters: ProductFilter[], input: string): boolean {\n  let parsed: ProductFilter;\n  try {\n    parsed = JSON.parse(input) as ProductFilter;\n  } catch {\n    return false;\n  }\n  return activeFilters.some((filter) => filterEquals(filter, parsed));\n}\n\nfunction filterKind(\n  filter: ProductFilter,\n):\n  | \"tag\"\n  | \"available\"\n  | \"price\"\n  | \"productType\"\n  | \"productVendor\"\n  | \"variantOption\"\n  | \"productMetafield\"\n  | \"variantMetafield\"\n  | \"taxonomyMetafield\"\n  | \"category\"\n  | null {\n  if (filter.tag != null) return \"tag\";\n  if (filter.available != null) return \"available\";\n  if (filter.price != null) return \"price\";\n  if (filter.productType != null) return \"productType\";\n  if (filter.productVendor != null) return \"productVendor\";\n  if (filter.variantOption != null) return \"variantOption\";\n  if (filter.productMetafield != null) return \"productMetafield\";\n  if (filter.variantMetafield != null) return \"variantMetafield\";\n  if (filter.taxonomyMetafield != null) return \"taxonomyMetafield\";\n  if (filter.category != null) return \"category\";\n  return null;\n}\n\nfunction priceRangeEquals(a: ProductFilter[\"price\"], b: ProductFilter[\"price\"]): boolean {\n  if (a == null || b == null) return a === b;\n  return a.min === b.min && a.max === b.max;\n}\n\nfunction metafieldEquals(\n  a: { namespace: string; key: string; value?: string },\n  b: { namespace: string; key: string; value?: string },\n): boolean {\n  return a.namespace === b.namespace && a.key === b.key && (a.value ?? \"\") === (b.value ?? \"\");\n}\n\nfunction filtersEqual(a: ProductFilter[], b: ProductFilter[]): boolean {\n  if (a.length !== b.length) return false;\n\n  const remaining = [...b];\n  for (const filter of a) {\n    const index = remaining.findIndex((candidate) => filterEquals(filter, candidate));\n    if (index === -1) return false;\n    remaining.splice(index, 1);\n  }\n\n  return true;\n}\n\nfunction removeParamValue(params: URLSearchParams, name: string, value: string): void {\n  const remaining = params.getAll(name).filter((v) => v !== value);\n  params.delete(name);\n  for (const v of remaining) {\n    params.append(name, v);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"url.mjs","names":[],"sources":["../../../src/core/collection/url.ts"],"sourcesContent":["import type { ProductFilter } from \"../../../vendor/standard-events\";\nimport type { ProductCollectionSortKeys } from \"../../graphql/generated/storefront-api-types\";\nimport type { CollectionState } from \"./state\";\n\n/**\n * The filters, sort key, and sort direction in a collection URL.\n */\nexport interface CollectionParams {\n  /**\n   * Active product filters from the `filter.*` URL params.\n   *\n   * The filters use the Storefront Standard Events filter type. When your query variables use generated Storefront API types, cast the filters to the generated filter type where you pass them as variables.\n   */\n  filters: ProductFilter[];\n  /** Storefront API sort key from the `sort_by` param, or `undefined` when the param is missing or unrecognized. */\n  sortKey: ProductCollectionSortKeys | undefined;\n  /** `true` when the `sort_by` value ends with `-descending`. */\n  reverse: boolean;\n}\n\nconst SORT_BY_DESCENDING_SUFFIX = \"-descending\";\nconst SORT_BY_ASCENDING_SUFFIX = \"-ascending\";\nconst PAGINATION_CURSOR_PARAMS: readonly string[] = [\"before\", \"after\"];\n\nconst SORT_KEY_TO_SORT_BY: Record<string, string> = {\n  BEST_SELLING: \"best-selling\",\n  CREATED: \"created\",\n  PRICE: \"price\",\n  TITLE: \"title\",\n  MANUAL: \"manual\",\n  ID: \"id\",\n  RELEVANCE: \"relevance\",\n  COLLECTION_DEFAULT: \"collection-default\",\n};\n\nconst SORT_BY_TO_SORT_KEY: Record<string, ProductCollectionSortKeys> = Object.fromEntries(\n  Object.entries(SORT_KEY_TO_SORT_BY).map(([key, value]) => [\n    value,\n    key as ProductCollectionSortKeys,\n  ]),\n);\n\nconst STANDARD_EVENTS_COLLECTION_SORT_KEY: Record<string, ProductCollectionSortKeys> = {\n  \"best-selling\": \"BEST_SELLING\",\n  \"created-ascending\": \"CREATED\",\n  \"created-descending\": \"CREATED\",\n  \"price-ascending\": \"PRICE\",\n  \"price-descending\": \"PRICE\",\n  \"title-ascending\": \"TITLE\",\n  \"title-descending\": \"TITLE\",\n  manual: \"MANUAL\",\n};\n\n/**\n * Reads collection filters and sort from URL search params. Pass the result to your Storefront API collection query.\n *\n * The function reads Liquid-compatible `filter.p.*` and `filter.v.*` keys and the `sort_by` param.\n *\n * A URL that sets availability to both in stock and out of stock produces no availability filter. The function recognizes the best-selling and manual sort values, plus created, price, and title with an ascending or descending suffix. For other sort values, the sort key is `undefined`. The `parseSortByValue` function also recognizes relevance, collection default, and ID.\n *\n * @param searchParams - URL search params to read.\n * @returns The filters, sort key, and sort direction from the URL.\n * @publicDocs\n */\nexport function parseCollectionParams(searchParams: URLSearchParams): CollectionParams {\n  const filters = parseProductFilters(searchParams);\n  const sortKey = parseCollectionSortKey(searchParams);\n  const rawSortBy = searchParams.get(\"sort_by\");\n  const reverse = rawSortBy?.endsWith(SORT_BY_DESCENDING_SUFFIX) ?? false;\n\n  return { filters, sortKey, reverse };\n}\n\n/**\n * Converts collection filters and sort to URL search params with Liquid-compatible keys. Use the result to build collection URLs.\n *\n * The result holds only the `filter.*` and `sort_by` keys. The function leaves out `sort_by` for the collection's default sort.\n *\n * Category filters convert to `filter.p.category`, which `parseCollectionParams` doesn't read. A price filter with a minimum and a maximum produces two params. To build a filter checkbox, parse a filter value's `input` string and convert the parsed filter. The resulting entries give the checkbox name and value.\n *\n * @param state - The filters, sort key, and sort direction to convert.\n * @returns URL search params that hold the filters and sort.\n * @publicDocs\n */\nexport function serializeCollectionParams(\n  state: Pick<CollectionState, \"filters\" | \"sortKey\" | \"reverse\">,\n): URLSearchParams {\n  const params = new URLSearchParams();\n\n  for (const filter of state.filters) {\n    serializeFilter(params, filter);\n  }\n\n  if (state.sortKey) {\n    params.set(\"sort_by\", getSortByValue(state.sortKey, state.reverse));\n  }\n\n  return params;\n}\n\n/** Returns `true` when the param key is owned by the collection store. */\nfunction isStoreOwnedParam(key: string): boolean {\n  return key === \"sort_by\" || key.startsWith(\"filter.\");\n}\n\n/**\n * Removes a leading `?` from a search string. Normalize search strings before you compare them.\n *\n * @param search The search string from your router, with or without a leading `?`.\n * @returns The search string without a leading `?`.\n * @publicDocs\n */\nexport function normalizeCollectionSearch(search: string): string {\n  return search.startsWith(\"?\") ? search.slice(1) : search;\n}\n\n/**\n * Merges store-owned params from `state` into `existing`, preserving\n * unrelated keys (e.g. `grid`, `view`) already present in the URL. Collection\n * pagination cursors (`before`, `after`) are cleared so changed browse intent\n * starts from the first page.\n */\nexport function mergeCollectionParams(\n  existing: URLSearchParams,\n  state: Pick<CollectionState, \"filters\" | \"sortKey\" | \"reverse\">,\n): URLSearchParams {\n  const merged = new URLSearchParams(existing);\n\n  for (const key of Array.from(merged.keys())) {\n    if (isStoreOwnedParam(key)) {\n      merged.delete(key);\n    }\n  }\n\n  clearPaginationCursors(merged);\n\n  for (const [key, value] of serializeCollectionParams(state)) {\n    merged.append(key, value);\n  }\n\n  return merged;\n}\n\n/** Returns `true` when two router search strings describe the same collection filters and sort. */\nexport function collectionSearchEqual(a: string, b: string): boolean {\n  const parsedA = parseCollectionParams(new URLSearchParams(normalizeCollectionSearch(a)));\n  const parsedB = parseCollectionParams(new URLSearchParams(normalizeCollectionSearch(b)));\n\n  return (\n    parsedA.sortKey === parsedB.sortKey &&\n    parsedA.reverse === parsedB.reverse &&\n    filtersEqual(parsedA.filters, parsedB.filters)\n  );\n}\n\n/** Returns `true` when URL params and collection browse state describe the same filters and sort. */\nexport function collectionParamsMatchState(\n  searchParams: URLSearchParams,\n  state: Pick<CollectionState, \"filters\" | \"sortKey\" | \"reverse\">,\n): boolean {\n  const parsed = parseCollectionParams(searchParams);\n\n  return (\n    parsed.sortKey === state.sortKey &&\n    parsed.reverse === state.reverse &&\n    filtersEqual(parsed.filters, state.filters)\n  );\n}\n\n/**\n * Builds a query string from the current URL params, minus the given filter. Use the string in plain remove-filter links.\n *\n * The function keeps every other param and drops the `before` and `after` pagination cursors, which sends the customer to the first page of results.\n *\n * @param currentParams The current URL search params.\n * @param filter The filter to remove from the URL.\n * @returns A query string that starts with `?`. The string is `?` alone when no params remain.\n * @publicDocs\n */\nexport function getFilterRemovalUrl(currentParams: URLSearchParams, filter: ProductFilter): string {\n  const result = new URLSearchParams(currentParams);\n  removeFilterParams(result, filter);\n  clearPaginationCursors(result);\n  const serialized = result.toString();\n  return serialized ? `?${serialized}` : \"?\";\n}\n\n/** Returns `true` when the sort key supports ascending/descending direction suffixes. */\nexport function isDirectionalSortKey(sortKey: ProductCollectionSortKeys): boolean {\n  return sortKey === \"PRICE\" || sortKey === \"TITLE\" || sortKey === \"CREATED\" || sortKey === \"ID\";\n}\n\n/**\n * Converts a Storefront API sort key and direction to a Liquid-compatible\n * `sort_by` value, such as `price-ascending` or `best-selling`.\n *\n * Only the price, title, created, and ID sort keys get a direction suffix.\n * Other sort keys, such as best selling, ignore the direction.\n *\n * @param sortKey - Storefront API product collection sort key.\n * @param reverse - `true` for descending, `false` for ascending.\n * @returns The value for the `sort_by` URL param.\n * @publicDocs\n */\nexport function getSortByValue(sortKey: ProductCollectionSortKeys, reverse: boolean): string {\n  const base = SORT_KEY_TO_SORT_BY[sortKey] ?? sortKey.toLowerCase();\n\n  if (!isDirectionalSortKey(sortKey)) return base;\n\n  return reverse ? `${base}-descending` : `${base}-ascending`;\n}\n\n/**\n * Converts a Liquid-compatible `sort_by` value to a Storefront API\n * sort key and direction. The `getSortByValue` function does the opposite conversion.\n *\n * For unrecognized values, the sort key is `undefined`.\n *\n * @param value - A `sort_by` value, such as `price-ascending` or `best-selling`.\n * @returns The sort key and `reverse`, which reads `true` for descending values.\n * @publicDocs\n */\nexport function parseSortByValue(value: string): {\n  sortKey: ProductCollectionSortKeys | undefined;\n  reverse: boolean;\n} {\n  if (value.endsWith(SORT_BY_DESCENDING_SUFFIX)) {\n    const base = value.slice(0, -SORT_BY_DESCENDING_SUFFIX.length);\n    return { sortKey: SORT_BY_TO_SORT_KEY[base], reverse: true };\n  }\n\n  if (value.endsWith(SORT_BY_ASCENDING_SUFFIX)) {\n    const base = value.slice(0, -SORT_BY_ASCENDING_SUFFIX.length);\n    return { sortKey: SORT_BY_TO_SORT_KEY[base], reverse: false };\n  }\n\n  return { sortKey: SORT_BY_TO_SORT_KEY[value], reverse: false };\n}\n\n/**\n * Mirrors `parseProductFilters` from storefront-standard-events.\n *\n * Keep this local because Hydrogen only vendors Standard Events\n * declarations, so importing CollectionUpdateEvent would require runtime JS.\n */\nfunction parseProductFilters(searchParams: URLSearchParams): ProductFilter[] {\n  const filters: ProductFilter[] = [];\n  const price: ProductFilter[\"price\"] = {};\n  const minPrice = searchParams.get(\"filter.v.price.gte\");\n  const maxPrice = searchParams.get(\"filter.v.price.lte\");\n\n  if (minPrice) price.min = parseLocalizedNumber(minPrice);\n  if (maxPrice) price.max = parseLocalizedNumber(maxPrice);\n  if (price.min !== undefined || price.max !== undefined) filters.push({ price });\n\n  const availability = searchParams.getAll(\"filter.v.availability\");\n  const inStock = availability.includes(\"1\");\n  const outOfStock = availability.includes(\"0\");\n  if (inStock && !outOfStock) filters.push({ available: true });\n  if (outOfStock && !inStock) filters.push({ available: false });\n\n  for (const productType of searchParams.getAll(\"filter.p.product_type\")) {\n    filters.push({ productType });\n  }\n\n  for (const productVendor of searchParams.getAll(\"filter.p.vendor\")) {\n    filters.push({ productVendor });\n  }\n\n  for (const tag of searchParams.getAll(\"filter.p.tag\")) {\n    filters.push({ tag });\n  }\n\n  for (const [key, value] of searchParams) {\n    let match: RegExpMatchArray | null;\n\n    if ((match = key.match(/^filter\\.v\\.option\\.(.+)$/))) {\n      filters.push({ variantOption: { name: decodeFilterKeyPart(match[1]), value } });\n      continue;\n    }\n\n    if ((match = key.match(/^filter\\.p\\.m\\.([^.]+)\\.(.+)$/))) {\n      filters.push({\n        productMetafield: {\n          namespace: decodeFilterKeyPart(match[1]),\n          key: decodeFilterKeyPart(match[2]),\n          value,\n        },\n      });\n      continue;\n    }\n\n    if ((match = key.match(/^filter\\.v\\.m\\.([^.]+)\\.(.+)$/))) {\n      filters.push({\n        variantMetafield: {\n          namespace: decodeFilterKeyPart(match[1]),\n          key: decodeFilterKeyPart(match[2]),\n          value,\n        },\n      });\n      continue;\n    }\n\n    if ((match = key.match(/^filter\\.v\\.t\\.([^.]+)\\.(.+)$/))) {\n      filters.push({\n        taxonomyMetafield: {\n          key: `${decodeFilterKeyPart(match[1])}.${decodeFilterKeyPart(match[2])}`,\n          value,\n        },\n      });\n    }\n  }\n\n  return filters;\n}\n\n/** Mirrors `getCollectionSortKey` from storefront-standard-events. */\nfunction parseCollectionSortKey(\n  searchParams: URLSearchParams,\n): ProductCollectionSortKeys | undefined {\n  const rawSortBy = searchParams.get(\"sort_by\");\n  return rawSortBy ? STANDARD_EVENTS_COLLECTION_SORT_KEY[rawSortBy] : undefined;\n}\n\nfunction parseLocalizedNumber(value: string): number {\n  try {\n    const locale = typeof window !== \"undefined\" ? window.Shopify?.locale : undefined;\n    const parts = new Intl.NumberFormat(locale ?? \"en\").formatToParts(1234.5);\n    const group = parts.find((part) => part.type === \"group\")?.value ?? \",\";\n    const decimal = parts.find((part) => part.type === \"decimal\")?.value ?? \".\";\n    const normalized = value.split(group).join(\"\").replace(decimal, \".\");\n    const number = Number(normalized);\n    if (!Number.isNaN(number)) return number;\n  } catch {}\n\n  return Number(value.replace(/[^\\d.]/g, \"\")) || 0;\n}\n\nfunction decodeFilterKeyPart(value: string): string {\n  return decodeURIComponent(value.replace(/\\+/g, \" \"));\n}\n\nfunction getFilterParamEntries(filter: ProductFilter): Array<{ key: string; value: string }> {\n  const entries: Array<{ key: string; value: string }> = [];\n\n  if (filter.available != null) {\n    entries.push({ key: \"filter.v.availability\", value: filter.available ? \"1\" : \"0\" });\n  }\n\n  if (filter.price) {\n    if (filter.price.min != null) {\n      entries.push({ key: \"filter.v.price.gte\", value: String(filter.price.min) });\n    }\n    if (filter.price.max != null) {\n      entries.push({ key: \"filter.v.price.lte\", value: String(filter.price.max) });\n    }\n  }\n\n  if (filter.productType != null) {\n    entries.push({ key: \"filter.p.product_type\", value: filter.productType });\n  }\n\n  if (filter.productVendor != null) {\n    entries.push({ key: \"filter.p.vendor\", value: filter.productVendor });\n  }\n\n  if (filter.tag != null) {\n    entries.push({ key: \"filter.p.tag\", value: filter.tag });\n  }\n\n  if (filter.variantOption) {\n    entries.push({\n      key: `filter.v.option.${encodeURIComponent(filter.variantOption.name)}`,\n      value: filter.variantOption.value ?? \"\",\n    });\n  }\n\n  if (filter.productMetafield) {\n    const { namespace, key, value } = filter.productMetafield;\n    entries.push({\n      key: `filter.p.m.${encodeURIComponent(namespace)}.${encodeURIComponent(key)}`,\n      value: value ?? \"\",\n    });\n  }\n\n  if (filter.variantMetafield) {\n    const { namespace, key, value } = filter.variantMetafield;\n    entries.push({\n      key: `filter.v.m.${encodeURIComponent(namespace)}.${encodeURIComponent(key)}`,\n      value: value ?? \"\",\n    });\n  }\n\n  if (filter.taxonomyMetafield) {\n    const fullKey = filter.taxonomyMetafield.key;\n    const dotIdx = fullKey.indexOf(\".\");\n    const ns = dotIdx >= 0 ? fullKey.slice(0, dotIdx) : fullKey;\n    const k = dotIdx >= 0 ? fullKey.slice(dotIdx + 1) : \"\";\n    entries.push({\n      key: `filter.v.t.${encodeURIComponent(ns)}.${encodeURIComponent(k)}`,\n      value: filter.taxonomyMetafield.value,\n    });\n  }\n\n  if (filter.category) {\n    entries.push({ key: \"filter.p.category\", value: filter.category.id });\n  }\n\n  return entries;\n}\n\nfunction serializeFilter(params: URLSearchParams, filter: ProductFilter): void {\n  for (const { key, value } of getFilterParamEntries(filter)) {\n    params.append(key, value);\n  }\n}\n\nfunction removeFilterParams(params: URLSearchParams, filter: ProductFilter): void {\n  for (const { key, value } of getFilterParamEntries(filter)) {\n    removeParamValue(params, key, value);\n  }\n}\n\nfunction clearPaginationCursors(params: URLSearchParams): void {\n  for (const key of PAGINATION_CURSOR_PARAMS) {\n    params.delete(key);\n  }\n}\n\n/**\n * Checks whether two product filters match.\n *\n * Price filters match when the minimum and maximum are equal, including ranges that set only one bound.\n *\n * @param a The first filter to compare.\n * @param b The second filter to compare.\n * @returns `true` when both filters are the same kind with the same values. `false` for different kinds or unrecognized filters.\n * @publicDocs\n */\nexport function filterEquals(a: ProductFilter, b: ProductFilter): boolean {\n  const kindA = filterKind(a);\n  const kindB = filterKind(b);\n  if (kindA !== kindB || kindA == null) return false;\n\n  switch (kindA) {\n    case \"tag\":\n      return a.tag === b.tag;\n    case \"available\":\n      return a.available === b.available;\n    case \"price\":\n      return priceRangeEquals(a.price, b.price);\n    case \"productType\":\n      return a.productType === b.productType;\n    case \"productVendor\":\n      return a.productVendor === b.productVendor;\n    case \"variantOption\": {\n      const aOpt = a.variantOption;\n      const bOpt = b.variantOption;\n      if (aOpt == null || bOpt == null) return false;\n      return aOpt.name === bOpt.name && (aOpt.value ?? \"\") === (bOpt.value ?? \"\");\n    }\n    case \"productMetafield\": {\n      const aMeta = a.productMetafield;\n      const bMeta = b.productMetafield;\n      if (aMeta == null || bMeta == null) return false;\n      return metafieldEquals(aMeta, bMeta);\n    }\n    case \"variantMetafield\": {\n      const aMeta = a.variantMetafield;\n      const bMeta = b.variantMetafield;\n      if (aMeta == null || bMeta == null) return false;\n      return metafieldEquals(aMeta, bMeta);\n    }\n    case \"taxonomyMetafield\": {\n      const aMeta = a.taxonomyMetafield;\n      const bMeta = b.taxonomyMetafield;\n      if (aMeta == null || bMeta == null) return false;\n      return aMeta.key === bMeta.key && aMeta.value === bMeta.value;\n    }\n    case \"category\": {\n      const aCat = a.category;\n      const bCat = b.category;\n      if (aCat == null || bCat == null) return false;\n      return aCat.id === bCat.id;\n    }\n  }\n}\n\n/**\n * Checks whether a filter value's `input` JSON string from the Storefront API matches an active filter. Use the result to set the checked state of a filter control.\n *\n * The function compares filters the same way as `filterEquals`.\n *\n * @param activeFilters The active filters, such as `filters` from the collection state.\n * @param input The filter value's `input` JSON string.\n * @returns `true` when the parsed input matches an active filter. `false` when the input matches no active filter or isn't valid JSON.\n * @publicDocs\n */\nexport function isFilterInputActive(activeFilters: ProductFilter[], input: string): boolean {\n  let parsed: ProductFilter;\n  try {\n    parsed = JSON.parse(input) as ProductFilter;\n  } catch {\n    return false;\n  }\n  return activeFilters.some((filter) => filterEquals(filter, parsed));\n}\n\nfunction filterKind(\n  filter: ProductFilter,\n):\n  | \"tag\"\n  | \"available\"\n  | \"price\"\n  | \"productType\"\n  | \"productVendor\"\n  | \"variantOption\"\n  | \"productMetafield\"\n  | \"variantMetafield\"\n  | \"taxonomyMetafield\"\n  | \"category\"\n  | null {\n  if (filter.tag != null) return \"tag\";\n  if (filter.available != null) return \"available\";\n  if (filter.price != null) return \"price\";\n  if (filter.productType != null) return \"productType\";\n  if (filter.productVendor != null) return \"productVendor\";\n  if (filter.variantOption != null) return \"variantOption\";\n  if (filter.productMetafield != null) return \"productMetafield\";\n  if (filter.variantMetafield != null) return \"variantMetafield\";\n  if (filter.taxonomyMetafield != null) return \"taxonomyMetafield\";\n  if (filter.category != null) return \"category\";\n  return null;\n}\n\nfunction priceRangeEquals(a: ProductFilter[\"price\"], b: ProductFilter[\"price\"]): boolean {\n  if (a == null || b == null) return a === b;\n  return a.min === b.min && a.max === b.max;\n}\n\nfunction metafieldEquals(\n  a: { namespace: string; key: string; value?: string },\n  b: { namespace: string; key: string; value?: string },\n): boolean {\n  return a.namespace === b.namespace && a.key === b.key && (a.value ?? \"\") === (b.value ?? \"\");\n}\n\nfunction filtersEqual(a: ProductFilter[], b: ProductFilter[]): boolean {\n  if (a.length !== b.length) return false;\n\n  const remaining = [...b];\n  for (const filter of a) {\n    const index = remaining.findIndex((candidate) => filterEquals(filter, candidate));\n    if (index === -1) return false;\n    remaining.splice(index, 1);\n  }\n\n  return true;\n}\n\nfunction removeParamValue(params: URLSearchParams, name: string, value: string): void {\n  const remaining = params.getAll(name).filter((v) => v !== value);\n  params.delete(name);\n  for (const v of remaining) {\n    params.append(name, v);\n  }\n}\n"],"mappings":"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"}

package/dist/core/constants.d.mts

@@ -1,4 +1,5 @@
 //#region src/core/constants.d.ts
+/** @publicDocs */
 declare const CUSTOMER_ACCOUNT_API_VERSION = "2026-10";
 //#endregion
 export { CUSTOMER_ACCOUNT_API_VERSION };

package/dist/core/constants.mjs

@@ -1,5 +1,6 @@
 //#region src/core/constants.ts
 const STOREFRONT_API_VERSION = "2026-10";
+/** @publicDocs */
 const CUSTOMER_ACCOUNT_API_VERSION = "2026-10";
 const DEFAULT_TIMEOUT_IN_MS = 3e4;
 

package/dist/core/constants.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"constants.mjs","names":[],"sources":["../../src/core/constants.ts"],"sourcesContent":["export const STOREFRONT_API_VERSION = \"2026-10\";\nexport const CUSTOMER_ACCOUNT_API_VERSION = \"2026-10\";\nexport const DEFAULT_TIMEOUT_IN_MS = 30_000;\n"],"mappings":";AAAA,MAAa,yBAAyB;AACtC,MAAa,+BAA+B;AAC5C,MAAa,wBAAwB"}
+{"version":3,"file":"constants.mjs","names":[],"sources":["../../src/core/constants.ts"],"sourcesContent":["export const STOREFRONT_API_VERSION = \"2026-10\";\n/** @publicDocs */\nexport const CUSTOMER_ACCOUNT_API_VERSION = \"2026-10\";\nexport const DEFAULT_TIMEOUT_IN_MS = 30_000;\n"],"mappings":";AAAA,MAAa,yBAAyB;;AAEtC,MAAa,+BAA+B;AAC5C,MAAa,wBAAwB"}

package/dist/core/logging/logging.d.mts

@@ -1,19 +1,25 @@
 import { HydrogenLogger, LogLevel } from "./types.mjs";
 
 //#region src/core/logging/logging.d.ts
+/** The logger and minimum severity for Hydrogen log entries. */
 type ConfigureLoggingOptions = {
-  /** Receives all entries at or above `level`. Defaults to the built-in console logger. */logger?: HydrogenLogger; /** Minimum severity forwarded to the logger. Defaults to `"info"`. */
+  /** Receives all entries at or above `level`. Defaults to the built-in console logger. */logger?: HydrogenLogger; /** The minimum severity that Hydrogen forwards to the logger. Defaults to `info`. */
   level?: LogLevel;
 };
 /**
- * Configures logging for every Hydrogen helper in this JavaScript context.
- * Call it once at startup (app entry on the browser, module init on the
- * server) before Hydrogen helpers run.
+ * Sends Hydrogen's log entries to your logger at the minimum level you choose. Use the function to
+ * forward Hydrogen errors to a monitoring service or to reduce console output.
  *
- * Reconfiguring with different options applies the new options (last call
- * wins). Inline bootstrap scripts that Hydrogen serializes into HTML
- * (analytics, consent) run outside the app bundle and always write to the
- * console with the standard prefix; they cannot receive a custom logger.
+ * Call the function once at startup. In the browser, call the function at app entry. On the
+ * server, call the function during module initialization. The configuration applies to every
+ * Hydrogen helper in the current JavaScript context, including helpers that loaded before the call.
+ * Each call replaces the previous configuration, and options that the call omits reset to their
+ * defaults. Hydrogen's inline analytics and consent scripts run outside your app bundle, and they
+ * always write to the console.
+ *
+ * @param options The logger that receives entries, and the minimum severity to send to the logger.
+ * @returns Nothing.
+ * @publicDocs
  */
 declare function configureLogging(options: ConfigureLoggingOptions): void;
 //#endregion

package/dist/core/logging/logging.mjs

@@ -20,9 +20,9 @@ function writeToConsole(level, message, context) {
 	console[CONSOLE_METHODS[level]](...args);
 }
 /**
-* Built-in sink: writes `[hydrogen:<level>:<scope>] <message>` to a
-* level-specific `console` method, followed by `context.error` and any extra
-* context fields. `trace` uses `console.debug`; `fatal` uses `console.error`.
+* The built-in logger. Writes each entry to the matching console method, with a
+* `[hydrogen:<level>:<scope>]` prefix when the entry has a scope, followed by the error and any
+* extra context fields. Trace entries use `console.debug`, and fatal entries use `console.error`.
 */
 const consoleLogger = {
 	trace: (message, context) => writeToConsole("trace", message, context),
@@ -37,14 +37,19 @@ const state = {
 	level: DEFAULT_LOG_LEVEL
 };
 /**
-* Configures logging for every Hydrogen helper in this JavaScript context.
-* Call it once at startup (app entry on the browser, module init on the
-* server) before Hydrogen helpers run.
+* Sends Hydrogen's log entries to your logger at the minimum level you choose. Use the function to
+* forward Hydrogen errors to a monitoring service or to reduce console output.
 *
-* Reconfiguring with different options applies the new options (last call
-* wins). Inline bootstrap scripts that Hydrogen serializes into HTML
-* (analytics, consent) run outside the app bundle and always write to the
-* console with the standard prefix; they cannot receive a custom logger.
+* Call the function once at startup. In the browser, call the function at app entry. On the
+* server, call the function during module initialization. The configuration applies to every
+* Hydrogen helper in the current JavaScript context, including helpers that loaded before the call.
+* Each call replaces the previous configuration, and options that the call omits reset to their
+* defaults. Hydrogen's inline analytics and consent scripts run outside your app bundle, and they
+* always write to the console.
+*
+* @param options The logger that receives entries, and the minimum severity to send to the logger.
+* @returns Nothing.
+* @publicDocs
 */
 function configureLogging(options) {
 	const logger = options.logger ?? consoleLogger;

package/dist/core/logging/logging.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"logging.mjs","names":[],"sources":["../../../src/core/logging/logging.ts"],"sourcesContent":["import {\n  DEFAULT_LOG_LEVEL,\n  isLevelEnabled,\n  type HydrogenLogger,\n  type LogContext,\n  type LogLevel,\n  type LogSeverity,\n} from \"./types\";\n\nconst CONSOLE_METHODS: Record<LogSeverity, \"debug\" | \"info\" | \"warn\" | \"error\"> = {\n  // `console.trace` prints a stack trace for every call, which is too noisy\n  // for level-gated trace logs; route it to `console.debug` instead.\n  trace: \"debug\",\n  debug: \"debug\",\n  info: \"info\",\n  warn: \"warn\",\n  error: \"error\",\n  fatal: \"error\",\n};\n\nfunction formatLogPrefix(level: LogSeverity, scope: string): string {\n  return `[hydrogen:${level}:${scope}]`;\n}\n\nfunction writeToConsole(level: LogSeverity, message: string, context?: LogContext): void {\n  const { scope, error, ...rest } = context ?? {};\n  const prefixed = scope ? `${formatLogPrefix(level, scope)} ${message}` : message;\n  const args: unknown[] = [prefixed];\n  if (error !== undefined) args.push(error);\n  if (Object.keys(rest).length > 0) args.push(rest);\n\n  // oxlint-disable-next-line no-console -- The built-in sink is the one sanctioned console call site.\n  console[CONSOLE_METHODS[level]](...args);\n}\n\n/**\n * Built-in sink: writes `[hydrogen:<level>:<scope>] <message>` to a\n * level-specific `console` method, followed by `context.error` and any extra\n * context fields. `trace` uses `console.debug`; `fatal` uses `console.error`.\n */\nexport const consoleLogger: HydrogenLogger = {\n  trace: (message, context) => writeToConsole(\"trace\", message, context),\n  debug: (message, context) => writeToConsole(\"debug\", message, context),\n  info: (message, context) => writeToConsole(\"info\", message, context),\n  warn: (message, context) => writeToConsole(\"warn\", message, context),\n  error: (message, context) => writeToConsole(\"error\", message, context),\n  fatal: (message, context) => writeToConsole(\"fatal\", message, context),\n};\n\nexport type ConfigureLoggingOptions = {\n  /** Receives all entries at or above `level`. Defaults to the built-in console logger. */\n  logger?: HydrogenLogger;\n  /** Minimum severity forwarded to the logger. Defaults to `\"info\"`. */\n  level?: LogLevel;\n};\n\ntype LoggingState = {\n  logger: HydrogenLogger;\n  level: LogLevel;\n};\n\nconst state: LoggingState = {\n  logger: consoleLogger,\n  level: DEFAULT_LOG_LEVEL,\n};\n\n/**\n * Configures logging for every Hydrogen helper in this JavaScript context.\n * Call it once at startup (app entry on the browser, module init on the\n * server) before Hydrogen helpers run.\n *\n * Reconfiguring with different options applies the new options (last call\n * wins). Inline bootstrap scripts that Hydrogen serializes into HTML\n * (analytics, consent) run outside the app bundle and always write to the\n * console with the standard prefix; they cannot receive a custom logger.\n */\nexport function configureLogging(options: ConfigureLoggingOptions): void {\n  const logger = options.logger ?? consoleLogger;\n  const level = options.level ?? DEFAULT_LOG_LEVEL;\n\n  state.logger = logger;\n  state.level = level;\n}\n\n/**\n * Scoped logger used by Hydrogen internals. Entries are level-gated and\n * tagged with `scope`, then forwarded to the configured sink. Resolution is\n * lazy: `configureLogging` affects loggers obtained before or after the call.\n */\ntype ScopedLogContext = Omit<LogContext, \"scope\"> & { scope?: never };\n\ntype ScopedLogger = Record<LogSeverity, (message: string, context?: ScopedLogContext) => void>;\n\nfunction emit(scope: string, level: LogSeverity, message: string, context?: LogContext): void {\n  if (!isLevelEnabled(level, state.level)) return;\n\n  try {\n    state.logger[level](message, { ...context, scope });\n  } catch (error) {\n    reportLoggerFailure(error, { level, scope, message, context });\n  }\n}\n\ntype FailedLogEntry = {\n  level: LogSeverity;\n  scope: string;\n  message: string;\n  context?: LogContext;\n};\n\nfunction reportLoggerFailure(error: unknown, failedEntry: FailedLogEntry): void {\n  if (state.logger === consoleLogger) return;\n\n  const fallbackContext: LogContext = {\n    scope: \"logging\",\n    error,\n    originalLevel: failedEntry.level,\n    originalScope: failedEntry.scope,\n    originalMessage: failedEntry.message,\n  };\n  if (failedEntry.context !== undefined) fallbackContext.originalContext = failedEntry.context;\n\n  try {\n    consoleLogger.error(\"configured logger failed\", fallbackContext);\n  } catch {\n    // Logging failures must never change the runtime path that triggered the log.\n  }\n}\n\n/** @internal Returns the lazily-resolved scoped logger for a Hydrogen subsystem. */\nexport function getLogger(scope: string): ScopedLogger {\n  return {\n    trace: (message, context) => emit(scope, \"trace\", message, context),\n    debug: (message, context) => emit(scope, \"debug\", message, context),\n    info: (message, context) => emit(scope, \"info\", message, context),\n    warn: (message, context) => emit(scope, \"warn\", message, context),\n    error: (message, context) => emit(scope, \"error\", message, context),\n    fatal: (message, context) => emit(scope, \"fatal\", message, context),\n  };\n}\n"],"mappings":";;;AASA,MAAM,kBAA4E;CAGhF,OAAO;CACP,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,OAAO;CACR;AAED,SAAS,gBAAgB,OAAoB,OAAuB;AAClE,QAAO,aAAa,MAAM,GAAG,MAAM;;AAGrC,SAAS,eAAe,OAAoB,SAAiB,SAA4B;CACvF,MAAM,EAAE,OAAO,OAAO,GAAG,SAAS,WAAW,EAAE;CAE/C,MAAM,OAAkB,CADP,QAAQ,GAAG,gBAAgB,OAAO,MAAM,CAAC,GAAG,YAAY,QACvC;AAClC,KAAI,UAAU,OAAW,MAAK,KAAK,MAAM;AACzC,KAAI,OAAO,KAAK,KAAK,CAAC,SAAS,EAAG,MAAK,KAAK,KAAK;AAGjD,SAAQ,gBAAgB,QAAQ,GAAG,KAAK;;;;;;;AAQ1C,MAAa,gBAAgC;CAC3C,QAAQ,SAAS,YAAY,eAAe,SAAS,SAAS,QAAQ;CACtE,QAAQ,SAAS,YAAY,eAAe,SAAS,SAAS,QAAQ;CACtE,OAAO,SAAS,YAAY,eAAe,QAAQ,SAAS,QAAQ;CACpE,OAAO,SAAS,YAAY,eAAe,QAAQ,SAAS,QAAQ;CACpE,QAAQ,SAAS,YAAY,eAAe,SAAS,SAAS,QAAQ;CACtE,QAAQ,SAAS,YAAY,eAAe,SAAS,SAAS,QAAQ;CACvE;AAcD,MAAM,QAAsB;CAC1B,QAAQ;CACR,OAAO;CACR;;;;;;;;;;;AAYD,SAAgB,iBAAiB,SAAwC;CACvE,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,QAAQ,QAAQ;AAEtB,OAAM,SAAS;AACf,OAAM,QAAQ;;AAYhB,SAAS,KAAK,OAAe,OAAoB,SAAiB,SAA4B;AAC5F,KAAI,CAAC,eAAe,OAAO,MAAM,MAAM,CAAE;AAEzC,KAAI;AACF,QAAM,OAAO,OAAO,SAAS;GAAE,GAAG;GAAS;GAAO,CAAC;UAC5C,OAAO;AACd,sBAAoB,OAAO;GAAE;GAAO;GAAO;GAAS;GAAS,CAAC;;;AAWlE,SAAS,oBAAoB,OAAgB,aAAmC;AAC9E,KAAI,MAAM,WAAW,cAAe;CAEpC,MAAM,kBAA8B;EAClC,OAAO;EACP;EACA,eAAe,YAAY;EAC3B,eAAe,YAAY;EAC3B,iBAAiB,YAAY;EAC9B;AACD,KAAI,YAAY,YAAY,OAAW,iBAAgB,kBAAkB,YAAY;AAErF,KAAI;AACF,gBAAc,MAAM,4BAA4B,gBAAgB;SAC1D;;;AAMV,SAAgB,UAAU,OAA6B;AACrD,QAAO;EACL,QAAQ,SAAS,YAAY,KAAK,OAAO,SAAS,SAAS,QAAQ;EACnE,QAAQ,SAAS,YAAY,KAAK,OAAO,SAAS,SAAS,QAAQ;EACnE,OAAO,SAAS,YAAY,KAAK,OAAO,QAAQ,SAAS,QAAQ;EACjE,OAAO,SAAS,YAAY,KAAK,OAAO,QAAQ,SAAS,QAAQ;EACjE,QAAQ,SAAS,YAAY,KAAK,OAAO,SAAS,SAAS,QAAQ;EACnE,QAAQ,SAAS,YAAY,KAAK,OAAO,SAAS,SAAS,QAAQ;EACpE"}
+{"version":3,"file":"logging.mjs","names":[],"sources":["../../../src/core/logging/logging.ts"],"sourcesContent":["import {\n  DEFAULT_LOG_LEVEL,\n  isLevelEnabled,\n  type HydrogenLogger,\n  type LogContext,\n  type LogLevel,\n  type LogSeverity,\n} from \"./types\";\n\nconst CONSOLE_METHODS: Record<LogSeverity, \"debug\" | \"info\" | \"warn\" | \"error\"> = {\n  // `console.trace` prints a stack trace for every call, which is too noisy\n  // for level-gated trace logs; route it to `console.debug` instead.\n  trace: \"debug\",\n  debug: \"debug\",\n  info: \"info\",\n  warn: \"warn\",\n  error: \"error\",\n  fatal: \"error\",\n};\n\nfunction formatLogPrefix(level: LogSeverity, scope: string): string {\n  return `[hydrogen:${level}:${scope}]`;\n}\n\nfunction writeToConsole(level: LogSeverity, message: string, context?: LogContext): void {\n  const { scope, error, ...rest } = context ?? {};\n  const prefixed = scope ? `${formatLogPrefix(level, scope)} ${message}` : message;\n  const args: unknown[] = [prefixed];\n  if (error !== undefined) args.push(error);\n  if (Object.keys(rest).length > 0) args.push(rest);\n\n  // oxlint-disable-next-line no-console -- The built-in sink is the one sanctioned console call site.\n  console[CONSOLE_METHODS[level]](...args);\n}\n\n/**\n * The built-in logger. Writes each entry to the matching console method, with a\n * `[hydrogen:<level>:<scope>]` prefix when the entry has a scope, followed by the error and any\n * extra context fields. Trace entries use `console.debug`, and fatal entries use `console.error`.\n */\nexport const consoleLogger: HydrogenLogger = {\n  trace: (message, context) => writeToConsole(\"trace\", message, context),\n  debug: (message, context) => writeToConsole(\"debug\", message, context),\n  info: (message, context) => writeToConsole(\"info\", message, context),\n  warn: (message, context) => writeToConsole(\"warn\", message, context),\n  error: (message, context) => writeToConsole(\"error\", message, context),\n  fatal: (message, context) => writeToConsole(\"fatal\", message, context),\n};\n\n/** The logger and minimum severity for Hydrogen log entries. */\nexport type ConfigureLoggingOptions = {\n  /** Receives all entries at or above `level`. Defaults to the built-in console logger. */\n  logger?: HydrogenLogger;\n  /** The minimum severity that Hydrogen forwards to the logger. Defaults to `info`. */\n  level?: LogLevel;\n};\n\ntype LoggingState = {\n  logger: HydrogenLogger;\n  level: LogLevel;\n};\n\nconst state: LoggingState = {\n  logger: consoleLogger,\n  level: DEFAULT_LOG_LEVEL,\n};\n\n/**\n * Sends Hydrogen's log entries to your logger at the minimum level you choose. Use the function to\n * forward Hydrogen errors to a monitoring service or to reduce console output.\n *\n * Call the function once at startup. In the browser, call the function at app entry. On the\n * server, call the function during module initialization. The configuration applies to every\n * Hydrogen helper in the current JavaScript context, including helpers that loaded before the call.\n * Each call replaces the previous configuration, and options that the call omits reset to their\n * defaults. Hydrogen's inline analytics and consent scripts run outside your app bundle, and they\n * always write to the console.\n *\n * @param options The logger that receives entries, and the minimum severity to send to the logger.\n * @returns Nothing.\n * @publicDocs\n */\nexport function configureLogging(options: ConfigureLoggingOptions): void {\n  const logger = options.logger ?? consoleLogger;\n  const level = options.level ?? DEFAULT_LOG_LEVEL;\n\n  state.logger = logger;\n  state.level = level;\n}\n\n/**\n * Scoped logger used by Hydrogen internals. Entries are level-gated and\n * tagged with `scope`, then forwarded to the configured sink. Resolution is\n * lazy: `configureLogging` affects loggers obtained before or after the call.\n */\ntype ScopedLogContext = Omit<LogContext, \"scope\"> & { scope?: never };\n\ntype ScopedLogger = Record<LogSeverity, (message: string, context?: ScopedLogContext) => void>;\n\nfunction emit(scope: string, level: LogSeverity, message: string, context?: LogContext): void {\n  if (!isLevelEnabled(level, state.level)) return;\n\n  try {\n    state.logger[level](message, { ...context, scope });\n  } catch (error) {\n    reportLoggerFailure(error, { level, scope, message, context });\n  }\n}\n\ntype FailedLogEntry = {\n  level: LogSeverity;\n  scope: string;\n  message: string;\n  context?: LogContext;\n};\n\nfunction reportLoggerFailure(error: unknown, failedEntry: FailedLogEntry): void {\n  if (state.logger === consoleLogger) return;\n\n  const fallbackContext: LogContext = {\n    scope: \"logging\",\n    error,\n    originalLevel: failedEntry.level,\n    originalScope: failedEntry.scope,\n    originalMessage: failedEntry.message,\n  };\n  if (failedEntry.context !== undefined) fallbackContext.originalContext = failedEntry.context;\n\n  try {\n    consoleLogger.error(\"configured logger failed\", fallbackContext);\n  } catch {\n    // Logging failures must never change the runtime path that triggered the log.\n  }\n}\n\n/** @internal Returns the lazily-resolved scoped logger for a Hydrogen subsystem. */\nexport function getLogger(scope: string): ScopedLogger {\n  return {\n    trace: (message, context) => emit(scope, \"trace\", message, context),\n    debug: (message, context) => emit(scope, \"debug\", message, context),\n    info: (message, context) => emit(scope, \"info\", message, context),\n    warn: (message, context) => emit(scope, \"warn\", message, context),\n    error: (message, context) => emit(scope, \"error\", message, context),\n    fatal: (message, context) => emit(scope, \"fatal\", message, context),\n  };\n}\n"],"mappings":";;;AASA,MAAM,kBAA4E;CAGhF,OAAO;CACP,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,OAAO;CACR;AAED,SAAS,gBAAgB,OAAoB,OAAuB;AAClE,QAAO,aAAa,MAAM,GAAG,MAAM;;AAGrC,SAAS,eAAe,OAAoB,SAAiB,SAA4B;CACvF,MAAM,EAAE,OAAO,OAAO,GAAG,SAAS,WAAW,EAAE;CAE/C,MAAM,OAAkB,CADP,QAAQ,GAAG,gBAAgB,OAAO,MAAM,CAAC,GAAG,YAAY,QACvC;AAClC,KAAI,UAAU,OAAW,MAAK,KAAK,MAAM;AACzC,KAAI,OAAO,KAAK,KAAK,CAAC,SAAS,EAAG,MAAK,KAAK,KAAK;AAGjD,SAAQ,gBAAgB,QAAQ,GAAG,KAAK;;;;;;;AAQ1C,MAAa,gBAAgC;CAC3C,QAAQ,SAAS,YAAY,eAAe,SAAS,SAAS,QAAQ;CACtE,QAAQ,SAAS,YAAY,eAAe,SAAS,SAAS,QAAQ;CACtE,OAAO,SAAS,YAAY,eAAe,QAAQ,SAAS,QAAQ;CACpE,OAAO,SAAS,YAAY,eAAe,QAAQ,SAAS,QAAQ;CACpE,QAAQ,SAAS,YAAY,eAAe,SAAS,SAAS,QAAQ;CACtE,QAAQ,SAAS,YAAY,eAAe,SAAS,SAAS,QAAQ;CACvE;AAeD,MAAM,QAAsB;CAC1B,QAAQ;CACR,OAAO;CACR;;;;;;;;;;;;;;;;AAiBD,SAAgB,iBAAiB,SAAwC;CACvE,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,QAAQ,QAAQ;AAEtB,OAAM,SAAS;AACf,OAAM,QAAQ;;AAYhB,SAAS,KAAK,OAAe,OAAoB,SAAiB,SAA4B;AAC5F,KAAI,CAAC,eAAe,OAAO,MAAM,MAAM,CAAE;AAEzC,KAAI;AACF,QAAM,OAAO,OAAO,SAAS;GAAE,GAAG;GAAS;GAAO,CAAC;UAC5C,OAAO;AACd,sBAAoB,OAAO;GAAE;GAAO;GAAO;GAAS;GAAS,CAAC;;;AAWlE,SAAS,oBAAoB,OAAgB,aAAmC;AAC9E,KAAI,MAAM,WAAW,cAAe;CAEpC,MAAM,kBAA8B;EAClC,OAAO;EACP;EACA,eAAe,YAAY;EAC3B,eAAe,YAAY;EAC3B,iBAAiB,YAAY;EAC9B;AACD,KAAI,YAAY,YAAY,OAAW,iBAAgB,kBAAkB,YAAY;AAErF,KAAI;AACF,gBAAc,MAAM,4BAA4B,gBAAgB;SAC1D;;;AAMV,SAAgB,UAAU,OAA6B;AACrD,QAAO;EACL,QAAQ,SAAS,YAAY,KAAK,OAAO,SAAS,SAAS,QAAQ;EACnE,QAAQ,SAAS,YAAY,KAAK,OAAO,SAAS,SAAS,QAAQ;EACnE,OAAO,SAAS,YAAY,KAAK,OAAO,QAAQ,SAAS,QAAQ;EACjE,OAAO,SAAS,YAAY,KAAK,OAAO,QAAQ,SAAS,QAAQ;EACjE,QAAQ,SAAS,YAAY,KAAK,OAAO,SAAS,SAAS,QAAQ;EACnE,QAAQ,SAAS,YAAY,KAAK,OAAO,SAAS,SAAS,QAAQ;EACpE"}