@shopify/hydrogen-react 2026.4.1 → 2026.4.2

package/dist/browser-prod/optionValueDecoder.mjs

@@ -1,92 +1,110 @@
-const OPTION_VALUE_SEPARATOR = ",";
-const V1_CONTROL_CHARS = {
-  OPTION: ":",
-  END_OF_PREFIX: ",",
-  SEQUENCE_GAP: " ",
-  RANGE: "-"
+//#region src/optionValueDecoder.ts
+var OPTION_VALUE_SEPARATOR = ",";
+var V1_CONTROL_CHARS = {
+	OPTION: ":",
+	END_OF_PREFIX: ",",
+	SEQUENCE_GAP: " ",
+	RANGE: "-"
 };
-const isOptionValueCombinationInEncodedVariant = /* @__PURE__ */ (() => {
-  const decodedOptionValues = /* @__PURE__ */ new Map();
-  return function(targetOptionValueCombination, encodedVariantField) {
-    var _a;
-    if (targetOptionValueCombination.length === 0) {
-      return false;
-    }
-    if (!decodedOptionValues.has(encodedVariantField)) {
-      const decodedOptionValuesSet = /* @__PURE__ */ new Set();
-      for (const optionValue of decodeEncodedVariant(encodedVariantField)) {
-        decodedOptionValuesSet.add(optionValue.join(OPTION_VALUE_SEPARATOR));
-        for (let i = 0; i < optionValue.length; i++) {
-          decodedOptionValuesSet.add(
-            optionValue.slice(0, i + 1).join(OPTION_VALUE_SEPARATOR)
-          );
-        }
-      }
-      decodedOptionValues.set(encodedVariantField, decodedOptionValuesSet);
-    }
-    return Boolean(
-      (_a = decodedOptionValues.get(encodedVariantField)) == null ? void 0 : _a.has(targetOptionValueCombination.join(OPTION_VALUE_SEPARATOR))
-    );
-  };
+/**
+* Determine whether an option value combination is present in an encoded option value string. Function is memoized by encodedVariantField.
+*
+* @param targetOptionValueCombination - Indices of option values to look up in the encoded option value string. A partial set of indices may be passed to determine whether a node or any children is present. For example, if a product has 3 options, passing [0] will return true if any option value combination for the first option's option value is present in the encoded string.
+* @param encodedVariantField - Encoded option value string from the Storefront API, e.g. [product.encodedVariantExistence](/docs/api/storefront/2026-04/objects/Product#field-encodedvariantexistence) or [product.encodedVariantAvailability](/docs/api/storefront/2026-04/objects/Product#field-encodedvariantavailability)
+* @returns - True if a full or partial targetOptionValueIndices is present in the encoded option value string, false otherwise.
+* @publicDocs
+*/
+var isOptionValueCombinationInEncodedVariant = (() => {
+	const decodedOptionValues = /* @__PURE__ */ new Map();
+	return function(targetOptionValueCombination, encodedVariantField) {
+		if (targetOptionValueCombination.length === 0) return false;
+		if (!decodedOptionValues.has(encodedVariantField)) {
+			const decodedOptionValuesSet = /* @__PURE__ */ new Set();
+			for (const optionValue of decodeEncodedVariant(encodedVariantField)) {
+				decodedOptionValuesSet.add(optionValue.join(OPTION_VALUE_SEPARATOR));
+				for (let i = 0; i < optionValue.length; i++) decodedOptionValuesSet.add(optionValue.slice(0, i + 1).join(OPTION_VALUE_SEPARATOR));
+			}
+			decodedOptionValues.set(encodedVariantField, decodedOptionValuesSet);
+		}
+		return Boolean(decodedOptionValues.get(encodedVariantField)?.has(targetOptionValueCombination.join(OPTION_VALUE_SEPARATOR)));
+	};
 })();
+/**
+* For an encoded option value string, decode into option value combinations. Entries represent a valid combination formatted as an array of option value positions.
+* @param encodedVariantField - Encoded option value string from the Storefront API, e.g. [product.encodedVariantExistence](/docs/api/storefront/2026-04/objects/Product#field-encodedvariantexistence) or [product.encodedVariantAvailability](/docs/api/storefront/2026-04/objects/Product#field-encodedvariantavailability)
+* @returns Decoded option value combinations
+* @publicDocs
+*/
 function decodeEncodedVariant(encodedVariantField) {
-  if (!encodedVariantField) return [];
-  if (encodedVariantField.startsWith("v1_")) {
-    return v1Decoder(stripVersion(encodedVariantField));
-  }
-  throw new Error("Unsupported option value encoding");
+	if (!encodedVariantField) return [];
+	if (encodedVariantField.startsWith("v1_")) return v1Decoder(stripVersion(encodedVariantField));
+	throw new Error("Unsupported option value encoding");
 }
-const stripVersion = (encodedVariantField) => encodedVariantField.replace(/^v1_/, "");
+var stripVersion = (encodedVariantField) => encodedVariantField.replace(/^v1_/, "");
+/**
+* We encode an array of arrays representing variants, expressed in terms of options and option values, as a trie.
+*
+* This encoding strategy allows extremely large numbers of variants to be expressed in an extremely compact data structure.
+*
+* Integers represent option and values, so [0,0,0] represents option_value at array index 0 for the options at array indexes 0, 1 and 2
+*
+* `:`, `,`, ` ` and `-` are control characters.
+* `:` indicates a new option
+* `,` indicates the end of a repeated prefix, mulitple consecutive commas indicate the end of multiple repeated prefixes.
+* ` ` indicates a gap in the sequence of option values
+* `-` indicates a continuous range of option values
+*
+* Encoding process:
+*
+* example input array: [[0,0,0], [0,1,0], [0,1,1], [1,0,0], [1,0,1], [1,1,1], [2,0,1], [2,1,0]]
+*
+* step 1: encode as string: "0:0:0,0:1:0,0:1:1,1:0:0,1:0:1,1:1:1,2:0:1,2:1:0,"
+* step 2: combine nodes that share a prefix: "0:0:0,0:1:0 1,1:0:0 1,1:1:1,2:0:1,2:1:0,"
+* step 3: encode data as a trie so no prefixes need to be repeated: "0:0:0,1:0 1,,1:0:0 1,1:1,,2:0:1,1:0,,"
+* step 4: since the options are sorted, use a dash to express ranges: "0:0:0,1:0-1,,1:0:0-1,1:1,,2:0:1,1:0,,"
+*/
 function v1Decoder(encodedVariantField) {
-  const tokenizer = /[ :,-]/g;
-  let index = 0;
-  let token;
-  const options = [];
-  const currentOptionValue = [];
-  let depth = 0;
-  let rangeStart = null;
-  while (token = tokenizer.exec(encodedVariantField)) {
-    const operation = token[0];
-    const optionValueIndex = Number.parseInt(encodedVariantField.slice(index, token.index)) || 0;
-    if (rangeStart !== null) {
-      for (; rangeStart < optionValueIndex; rangeStart++) {
-        currentOptionValue[depth] = rangeStart;
-        options.push([...currentOptionValue]);
-      }
-      rangeStart = null;
-    }
-    currentOptionValue[depth] = optionValueIndex;
-    if (operation === V1_CONTROL_CHARS.RANGE) {
-      rangeStart = optionValueIndex;
-    } else if (operation === V1_CONTROL_CHARS.OPTION) {
-      depth++;
-    } else {
-      if (operation === V1_CONTROL_CHARS.SEQUENCE_GAP || operation === V1_CONTROL_CHARS.END_OF_PREFIX && encodedVariantField[token.index - 1] !== V1_CONTROL_CHARS.END_OF_PREFIX) {
-        options.push([...currentOptionValue]);
-      }
-      if (operation === V1_CONTROL_CHARS.END_OF_PREFIX) {
-        currentOptionValue.pop();
-        depth--;
-      }
-    }
-    index = tokenizer.lastIndex;
-  }
-  const encodingEndsWithIndex = encodedVariantField.match(/\d+$/g);
-  if (encodingEndsWithIndex) {
-    const finalValueIndex = parseInt(encodingEndsWithIndex[0]);
-    if (rangeStart != null) {
-      for (; rangeStart <= finalValueIndex; rangeStart++) {
-        currentOptionValue[depth] = rangeStart;
-        options.push([...currentOptionValue]);
-      }
-    } else {
-      options.push([finalValueIndex]);
-    }
-  }
-  return options;
+	const tokenizer = /[ :,-]/g;
+	let index = 0;
+	let token;
+	const options = [];
+	const currentOptionValue = [];
+	let depth = 0;
+	let rangeStart = null;
+	while (token = tokenizer.exec(encodedVariantField)) {
+		const operation = token[0];
+		const optionValueIndex = Number.parseInt(encodedVariantField.slice(index, token.index)) || 0;
+		if (rangeStart !== null) {
+			for (; rangeStart < optionValueIndex; rangeStart++) {
+				currentOptionValue[depth] = rangeStart;
+				options.push([...currentOptionValue]);
+			}
+			rangeStart = null;
+		}
+		currentOptionValue[depth] = optionValueIndex;
+		if (operation === V1_CONTROL_CHARS.RANGE) rangeStart = optionValueIndex;
+		else if (operation === V1_CONTROL_CHARS.OPTION) depth++;
+		else {
+			if (operation === V1_CONTROL_CHARS.SEQUENCE_GAP || operation === V1_CONTROL_CHARS.END_OF_PREFIX && encodedVariantField[token.index - 1] !== V1_CONTROL_CHARS.END_OF_PREFIX) options.push([...currentOptionValue]);
+			if (operation === V1_CONTROL_CHARS.END_OF_PREFIX) {
+				currentOptionValue.pop();
+				depth--;
+			}
+		}
+		index = tokenizer.lastIndex;
+	}
+	const encodingEndsWithIndex = encodedVariantField.match(/\d+$/g);
+	if (encodingEndsWithIndex) {
+		const finalValueIndex = parseInt(encodingEndsWithIndex[0]);
+		if (rangeStart != null) for (; rangeStart <= finalValueIndex; rangeStart++) {
+			currentOptionValue[depth] = rangeStart;
+			options.push([...currentOptionValue]);
+		}
+		else options.push([finalValueIndex]);
+	}
+	return options;
 }
-export {
-  decodeEncodedVariant,
-  isOptionValueCombinationInEncodedVariant
-};
-//# sourceMappingURL=optionValueDecoder.mjs.map
+//#endregion
+export { decodeEncodedVariant, isOptionValueCombinationInEncodedVariant };
+
+//# sourceMappingURL=optionValueDecoder.mjs.map

package/dist/browser-prod/optionValueDecoder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"optionValueDecoder.mjs","sources":["../../src/optionValueDecoder.ts"],"sourcesContent":["/**\n * This file provides utility functions for determining whether or not an option value combination is present in an encoded option value string.\n *\n * In V1 of the encoding strategy, option value arrays are encoded as a trie with the following rules:\n *  - `:` `,` ` ` and `-` are control characters.\n *  - `:` indicates a new option. ex: 0:1 indicates value 0 for the option in position 1, value 1 for the option in position 2.\n *  - `,` indicates the end of a repeated prefix, mulitple consecutive commas indicate the end of multiple repeated prefixes.\n *  - ` ` indicates a gap in the sequence of option values. ex: `0 4` indicates option values in position 0 and 4 are present.\n *  - `-` indicates a continuous range of option values. ex: `0 1-3 4`. Ranges are only present encoded in the final option value position, so for example the trie for the set [[0,0,0],[0,0,1], ..., [0,2,2]] will be structured as `0:0:0-2,1:0-2,2:0-2`, not `0:0-2:0-2`.\n */\n\nimport {Product} from './storefront-api-types.js';\n\nconst OPTION_VALUE_SEPARATOR = ',';\n\nconst V1_CONTROL_CHARS = {\n  OPTION: ':',\n  END_OF_PREFIX: ',',\n  SEQUENCE_GAP: ' ',\n  RANGE: '-',\n};\n\n/** @publicDocs */\nexport type IsOptionValueCombinationInEncodedVariant = (\n  targetOptionValueCombination: number[],\n  encodedVariantField: string,\n) => boolean;\n\n/**\n * Determine whether an option value combination is present in an encoded option value string. Function is memoized by encodedVariantField.\n *\n * @param targetOptionValueCombination - Indices of option values to look up in the encoded option value string. A partial set of indices may be passed to determine whether a node or any children is present. For example, if a product has 3 options, passing [0] will return true if any option value combination for the first option's option value is present in the encoded string.\n * @param encodedVariantField - Encoded option value string from the Storefront API, e.g. [product.encodedVariantExistence](/docs/api/storefront/2026-04/objects/Product#field-encodedvariantexistence) or [product.encodedVariantAvailability](/docs/api/storefront/2026-04/objects/Product#field-encodedvariantavailability)\n * @returns - True if a full or partial targetOptionValueIndices is present in the encoded option value string, false otherwise.\n * @publicDocs\n */\nexport const isOptionValueCombinationInEncodedVariant: IsOptionValueCombinationInEncodedVariant =\n  ((): IsOptionValueCombinationInEncodedVariant => {\n    const decodedOptionValues = new Map<string, Set<string>>();\n\n    return function (\n      targetOptionValueCombination: number[],\n      encodedVariantField: string,\n    ): boolean {\n      if (targetOptionValueCombination.length === 0) {\n        return false;\n      }\n\n      if (!decodedOptionValues.has(encodedVariantField)) {\n        const decodedOptionValuesSet = new Set<string>();\n\n        for (const optionValue of decodeEncodedVariant(encodedVariantField)) {\n          // add the complete option value to the decoded option values set\n          decodedOptionValuesSet.add(optionValue.join(OPTION_VALUE_SEPARATOR));\n\n          // add all composite parts of the option value to the decoded option values set. e.g. if the option value is [0,1,2], add \"0\", \"0,1\", \"0,1,2\"\n          for (let i = 0; i < optionValue.length; i++) {\n            decodedOptionValuesSet.add(\n              optionValue.slice(0, i + 1).join(OPTION_VALUE_SEPARATOR),\n            );\n          }\n        }\n\n        decodedOptionValues.set(encodedVariantField, decodedOptionValuesSet);\n      }\n\n      return Boolean(\n        decodedOptionValues\n          .get(encodedVariantField)\n          ?.has(targetOptionValueCombination.join(OPTION_VALUE_SEPARATOR)),\n      );\n    };\n  })();\n\ntype EncodedVariantField =\n  | Product['encodedVariantAvailability']\n  // eslint-disable-next-line @typescript-eslint/no-duplicate-type-constituents\n  | Product['encodedVariantExistence'];\ntype DecodedOptionValues = number[][];\n\n/**\n * For an encoded option value string, decode into option value combinations. Entries represent a valid combination formatted as an array of option value positions.\n * @param encodedVariantField - Encoded option value string from the Storefront API, e.g. [product.encodedVariantExistence](/docs/api/storefront/2026-04/objects/Product#field-encodedvariantexistence) or [product.encodedVariantAvailability](/docs/api/storefront/2026-04/objects/Product#field-encodedvariantavailability)\n * @returns Decoded option value combinations\n * @publicDocs\n */\nexport function decodeEncodedVariant(\n  encodedVariantField: EncodedVariantField,\n): DecodedOptionValues {\n  if (!encodedVariantField) return [];\n\n  if (encodedVariantField.startsWith('v1_')) {\n    return v1Decoder(stripVersion(encodedVariantField));\n  }\n\n  throw new Error('Unsupported option value encoding');\n}\n\nconst stripVersion: (encodedVariantField: string) => string = (\n  encodedVariantField: string,\n) => encodedVariantField.replace(/^v1_/, '');\n\n/**\n * We encode an array of arrays representing variants, expressed in terms of options and option values, as a trie.\n *\n * This encoding strategy allows extremely large numbers of variants to be expressed in an extremely compact data structure.\n *\n * Integers represent option and values, so [0,0,0] represents option_value at array index 0 for the options at array indexes 0, 1 and 2\n *\n * `:`, `,`, ` ` and `-` are control characters.\n * `:` indicates a new option\n * `,` indicates the end of a repeated prefix, mulitple consecutive commas indicate the end of multiple repeated prefixes.\n * ` ` indicates a gap in the sequence of option values\n * `-` indicates a continuous range of option values\n *\n * Encoding process:\n *\n * example input array: [[0,0,0], [0,1,0], [0,1,1], [1,0,0], [1,0,1], [1,1,1], [2,0,1], [2,1,0]]\n *\n * step 1: encode as string: \"0:0:0,0:1:0,0:1:1,1:0:0,1:0:1,1:1:1,2:0:1,2:1:0,\"\n * step 2: combine nodes that share a prefix: \"0:0:0,0:1:0 1,1:0:0 1,1:1:1,2:0:1,2:1:0,\"\n * step 3: encode data as a trie so no prefixes need to be repeated: \"0:0:0,1:0 1,,1:0:0 1,1:1,,2:0:1,1:0,,\"\n * step 4: since the options are sorted, use a dash to express ranges: \"0:0:0,1:0-1,,1:0:0-1,1:1,,2:0:1,1:0,,\"\n */\nfunction v1Decoder(encodedVariantField: string): number[][] {\n  const tokenizer = /[ :,-]/g;\n  let index = 0;\n  let token: RegExpExecArray | null;\n  const options: number[][] = [];\n  const currentOptionValue: number[] = [];\n  let depth = 0;\n  let rangeStart: number | null = null;\n\n  // iterate over control characters\n  while ((token = tokenizer.exec(encodedVariantField))) {\n    const operation = token[0];\n    const optionValueIndex =\n      Number.parseInt(encodedVariantField.slice(index, token.index)) || 0;\n\n    if (rangeStart !== null) {\n      // If a range has been started, iterate over the range and add each option value to the list of options\n      // - `rangeStart` is set if the last control char was a dash, e.g. `0` for 0-2. It represents the numeric option value position for the start of the range.\n      // - `optionValueIndex` is the numeric option value position for the end of the range\n      for (; rangeStart < optionValueIndex; rangeStart++) {\n        currentOptionValue[depth] = rangeStart;\n        options.push([...currentOptionValue]);\n      }\n      // indicates the range has been processed\n      rangeStart = null;\n    }\n\n    currentOptionValue[depth] = optionValueIndex;\n\n    if (operation === V1_CONTROL_CHARS.RANGE) {\n      // dash operation indicates we are in a range. e.g. 0-2 means option values 0, 1, 2\n      rangeStart = optionValueIndex;\n    } else if (operation === V1_CONTROL_CHARS.OPTION) {\n      // colon operation indicates that we are moving down to the next layer of option values. e.g. 0:0:0-2 means we traverse down from option1 to option3 and represents [[0,0,0], [0,0,1], [0,0,2]]\n      depth++;\n    } else {\n      if (\n        operation === V1_CONTROL_CHARS.SEQUENCE_GAP ||\n        (operation === V1_CONTROL_CHARS.END_OF_PREFIX &&\n          encodedVariantField[token.index - 1] !==\n            V1_CONTROL_CHARS.END_OF_PREFIX)\n      ) {\n        // add the current option value to the list of options if we hit a gap in our sequence or we are at the end of our depth and need to move back up\n        options.push([...currentOptionValue]);\n      }\n      if (operation === V1_CONTROL_CHARS.END_OF_PREFIX) {\n        // go up an option level, trash the last item in currentOptionValue\n        currentOptionValue.pop();\n        depth--;\n      }\n    }\n    index = tokenizer.lastIndex;\n  }\n\n  // The while loop only iterates control characters, meaning if an encoded string ends with an index it will not be processed.\n  const encodingEndsWithIndex = encodedVariantField.match(/\\d+$/g);\n  if (encodingEndsWithIndex) {\n    const finalValueIndex = parseInt(encodingEndsWithIndex[0]);\n    if (rangeStart != null) {\n      // process final range\n      for (; rangeStart <= finalValueIndex; rangeStart++) {\n        currentOptionValue[depth] = rangeStart;\n        options.push([...currentOptionValue]);\n      }\n    } else {\n      // process final index\n      options.push([finalValueIndex]);\n    }\n  }\n\n  return options;\n}\n"],"names":[],"mappings":"AAaA,MAAM,yBAAyB;AAE/B,MAAM,mBAAmB;AAAA,EACvB,QAAQ;AAAA,EACR,eAAe;AAAA,EACf,cAAc;AAAA,EACd,OAAO;AACT;AAgBO,MAAM,2CACV,uBAAgD;AAC/C,QAAM,0CAA0B,IAAA;AAEhC,SAAO,SACL,8BACA,qBACS;AA9Bf;AA+BM,QAAI,6BAA6B,WAAW,GAAG;AAC7C,aAAO;AAAA,IACT;AAEA,QAAI,CAAC,oBAAoB,IAAI,mBAAmB,GAAG;AACjD,YAAM,6CAA6B,IAAA;AAEnC,iBAAW,eAAe,qBAAqB,mBAAmB,GAAG;AAEnE,+BAAuB,IAAI,YAAY,KAAK,sBAAsB,CAAC;AAGnE,iBAAS,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;AAC3C,iCAAuB;AAAA,YACrB,YAAY,MAAM,GAAG,IAAI,CAAC,EAAE,KAAK,sBAAsB;AAAA,UAAA;AAAA,QAE3D;AAAA,MACF;AAEA,0BAAoB,IAAI,qBAAqB,sBAAsB;AAAA,IACrE;AAEA,WAAO;AAAA,OACL,yBACG,IAAI,mBAAmB,MAD1B,mBAEI,IAAI,6BAA6B,KAAK,sBAAsB;AAAA,IAAC;AAAA,EAErE;AACF,GAAA;AAcK,SAAS,qBACd,qBACqB;AACrB,MAAI,CAAC,oBAAqB,QAAO,CAAA;AAEjC,MAAI,oBAAoB,WAAW,KAAK,GAAG;AACzC,WAAO,UAAU,aAAa,mBAAmB,CAAC;AAAA,EACpD;AAEA,QAAM,IAAI,MAAM,mCAAmC;AACrD;AAEA,MAAM,eAAwD,CAC5D,wBACG,oBAAoB,QAAQ,QAAQ,EAAE;AAwB3C,SAAS,UAAU,qBAAyC;AAC1D,QAAM,YAAY;AAClB,MAAI,QAAQ;AACZ,MAAI;AACJ,QAAM,UAAsB,CAAA;AAC5B,QAAM,qBAA+B,CAAA;AACrC,MAAI,QAAQ;AACZ,MAAI,aAA4B;AAGhC,SAAQ,QAAQ,UAAU,KAAK,mBAAmB,GAAI;AACpD,UAAM,YAAY,MAAM,CAAC;AACzB,UAAM,mBACJ,OAAO,SAAS,oBAAoB,MAAM,OAAO,MAAM,KAAK,CAAC,KAAK;AAEpE,QAAI,eAAe,MAAM;AAIvB,aAAO,aAAa,kBAAkB,cAAc;AAClD,2BAAmB,KAAK,IAAI;AAC5B,gBAAQ,KAAK,CAAC,GAAG,kBAAkB,CAAC;AAAA,MACtC;AAEA,mBAAa;AAAA,IACf;AAEA,uBAAmB,KAAK,IAAI;AAE5B,QAAI,cAAc,iBAAiB,OAAO;AAExC,mBAAa;AAAA,IACf,WAAW,cAAc,iBAAiB,QAAQ;AAEhD;AAAA,IACF,OAAO;AACL,UACE,cAAc,iBAAiB,gBAC9B,cAAc,iBAAiB,iBAC9B,oBAAoB,MAAM,QAAQ,CAAC,MACjC,iBAAiB,eACrB;AAEA,gBAAQ,KAAK,CAAC,GAAG,kBAAkB,CAAC;AAAA,MACtC;AACA,UAAI,cAAc,iBAAiB,eAAe;AAEhD,2BAAmB,IAAA;AACnB;AAAA,MACF;AAAA,IACF;AACA,YAAQ,UAAU;AAAA,EACpB;AAGA,QAAM,wBAAwB,oBAAoB,MAAM,OAAO;AAC/D,MAAI,uBAAuB;AACzB,UAAM,kBAAkB,SAAS,sBAAsB,CAAC,CAAC;AACzD,QAAI,cAAc,MAAM;AAEtB,aAAO,cAAc,iBAAiB,cAAc;AAClD,2BAAmB,KAAK,IAAI;AAC5B,gBAAQ,KAAK,CAAC,GAAG,kBAAkB,CAAC;AAAA,MACtC;AAAA,IACF,OAAO;AAEL,cAAQ,KAAK,CAAC,eAAe,CAAC;AAAA,IAChC;AAAA,EACF;AAEA,SAAO;AACT;"}
+{"version":3,"file":"optionValueDecoder.mjs","names":[],"sources":["../../src/optionValueDecoder.ts"],"sourcesContent":["/**\n * This file provides utility functions for determining whether or not an option value combination is present in an encoded option value string.\n *\n * In V1 of the encoding strategy, option value arrays are encoded as a trie with the following rules:\n *  - `:` `,` ` ` and `-` are control characters.\n *  - `:` indicates a new option. ex: 0:1 indicates value 0 for the option in position 1, value 1 for the option in position 2.\n *  - `,` indicates the end of a repeated prefix, mulitple consecutive commas indicate the end of multiple repeated prefixes.\n *  - ` ` indicates a gap in the sequence of option values. ex: `0 4` indicates option values in position 0 and 4 are present.\n *  - `-` indicates a continuous range of option values. ex: `0 1-3 4`. Ranges are only present encoded in the final option value position, so for example the trie for the set [[0,0,0],[0,0,1], ..., [0,2,2]] will be structured as `0:0:0-2,1:0-2,2:0-2`, not `0:0-2:0-2`.\n */\n\nimport {Product} from './storefront-api-types.js';\n\nconst OPTION_VALUE_SEPARATOR = ',';\n\nconst V1_CONTROL_CHARS = {\n  OPTION: ':',\n  END_OF_PREFIX: ',',\n  SEQUENCE_GAP: ' ',\n  RANGE: '-',\n};\n\n/** @publicDocs */\nexport type IsOptionValueCombinationInEncodedVariant = (\n  targetOptionValueCombination: number[],\n  encodedVariantField: string,\n) => boolean;\n\n/**\n * Determine whether an option value combination is present in an encoded option value string. Function is memoized by encodedVariantField.\n *\n * @param targetOptionValueCombination - Indices of option values to look up in the encoded option value string. A partial set of indices may be passed to determine whether a node or any children is present. For example, if a product has 3 options, passing [0] will return true if any option value combination for the first option's option value is present in the encoded string.\n * @param encodedVariantField - Encoded option value string from the Storefront API, e.g. [product.encodedVariantExistence](/docs/api/storefront/2026-04/objects/Product#field-encodedvariantexistence) or [product.encodedVariantAvailability](/docs/api/storefront/2026-04/objects/Product#field-encodedvariantavailability)\n * @returns - True if a full or partial targetOptionValueIndices is present in the encoded option value string, false otherwise.\n * @publicDocs\n */\nexport const isOptionValueCombinationInEncodedVariant: IsOptionValueCombinationInEncodedVariant =\n  ((): IsOptionValueCombinationInEncodedVariant => {\n    const decodedOptionValues = new Map<string, Set<string>>();\n\n    return function (\n      targetOptionValueCombination: number[],\n      encodedVariantField: string,\n    ): boolean {\n      if (targetOptionValueCombination.length === 0) {\n        return false;\n      }\n\n      if (!decodedOptionValues.has(encodedVariantField)) {\n        const decodedOptionValuesSet = new Set<string>();\n\n        for (const optionValue of decodeEncodedVariant(encodedVariantField)) {\n          // add the complete option value to the decoded option values set\n          decodedOptionValuesSet.add(optionValue.join(OPTION_VALUE_SEPARATOR));\n\n          // add all composite parts of the option value to the decoded option values set. e.g. if the option value is [0,1,2], add \"0\", \"0,1\", \"0,1,2\"\n          for (let i = 0; i < optionValue.length; i++) {\n            decodedOptionValuesSet.add(\n              optionValue.slice(0, i + 1).join(OPTION_VALUE_SEPARATOR),\n            );\n          }\n        }\n\n        decodedOptionValues.set(encodedVariantField, decodedOptionValuesSet);\n      }\n\n      return Boolean(\n        decodedOptionValues\n          .get(encodedVariantField)\n          ?.has(targetOptionValueCombination.join(OPTION_VALUE_SEPARATOR)),\n      );\n    };\n  })();\n\ntype EncodedVariantField =\n  | Product['encodedVariantAvailability']\n  // eslint-disable-next-line @typescript-eslint/no-duplicate-type-constituents\n  | Product['encodedVariantExistence'];\ntype DecodedOptionValues = number[][];\n\n/**\n * For an encoded option value string, decode into option value combinations. Entries represent a valid combination formatted as an array of option value positions.\n * @param encodedVariantField - Encoded option value string from the Storefront API, e.g. [product.encodedVariantExistence](/docs/api/storefront/2026-04/objects/Product#field-encodedvariantexistence) or [product.encodedVariantAvailability](/docs/api/storefront/2026-04/objects/Product#field-encodedvariantavailability)\n * @returns Decoded option value combinations\n * @publicDocs\n */\nexport function decodeEncodedVariant(\n  encodedVariantField: EncodedVariantField,\n): DecodedOptionValues {\n  if (!encodedVariantField) return [];\n\n  if (encodedVariantField.startsWith('v1_')) {\n    return v1Decoder(stripVersion(encodedVariantField));\n  }\n\n  throw new Error('Unsupported option value encoding');\n}\n\nconst stripVersion: (encodedVariantField: string) => string = (\n  encodedVariantField: string,\n) => encodedVariantField.replace(/^v1_/, '');\n\n/**\n * We encode an array of arrays representing variants, expressed in terms of options and option values, as a trie.\n *\n * This encoding strategy allows extremely large numbers of variants to be expressed in an extremely compact data structure.\n *\n * Integers represent option and values, so [0,0,0] represents option_value at array index 0 for the options at array indexes 0, 1 and 2\n *\n * `:`, `,`, ` ` and `-` are control characters.\n * `:` indicates a new option\n * `,` indicates the end of a repeated prefix, mulitple consecutive commas indicate the end of multiple repeated prefixes.\n * ` ` indicates a gap in the sequence of option values\n * `-` indicates a continuous range of option values\n *\n * Encoding process:\n *\n * example input array: [[0,0,0], [0,1,0], [0,1,1], [1,0,0], [1,0,1], [1,1,1], [2,0,1], [2,1,0]]\n *\n * step 1: encode as string: \"0:0:0,0:1:0,0:1:1,1:0:0,1:0:1,1:1:1,2:0:1,2:1:0,\"\n * step 2: combine nodes that share a prefix: \"0:0:0,0:1:0 1,1:0:0 1,1:1:1,2:0:1,2:1:0,\"\n * step 3: encode data as a trie so no prefixes need to be repeated: \"0:0:0,1:0 1,,1:0:0 1,1:1,,2:0:1,1:0,,\"\n * step 4: since the options are sorted, use a dash to express ranges: \"0:0:0,1:0-1,,1:0:0-1,1:1,,2:0:1,1:0,,\"\n */\nfunction v1Decoder(encodedVariantField: string): number[][] {\n  const tokenizer = /[ :,-]/g;\n  let index = 0;\n  let token: RegExpExecArray | null;\n  const options: number[][] = [];\n  const currentOptionValue: number[] = [];\n  let depth = 0;\n  let rangeStart: number | null = null;\n\n  // iterate over control characters\n  while ((token = tokenizer.exec(encodedVariantField))) {\n    const operation = token[0];\n    const optionValueIndex =\n      Number.parseInt(encodedVariantField.slice(index, token.index)) || 0;\n\n    if (rangeStart !== null) {\n      // If a range has been started, iterate over the range and add each option value to the list of options\n      // - `rangeStart` is set if the last control char was a dash, e.g. `0` for 0-2. It represents the numeric option value position for the start of the range.\n      // - `optionValueIndex` is the numeric option value position for the end of the range\n      for (; rangeStart < optionValueIndex; rangeStart++) {\n        currentOptionValue[depth] = rangeStart;\n        options.push([...currentOptionValue]);\n      }\n      // indicates the range has been processed\n      rangeStart = null;\n    }\n\n    currentOptionValue[depth] = optionValueIndex;\n\n    if (operation === V1_CONTROL_CHARS.RANGE) {\n      // dash operation indicates we are in a range. e.g. 0-2 means option values 0, 1, 2\n      rangeStart = optionValueIndex;\n    } else if (operation === V1_CONTROL_CHARS.OPTION) {\n      // colon operation indicates that we are moving down to the next layer of option values. e.g. 0:0:0-2 means we traverse down from option1 to option3 and represents [[0,0,0], [0,0,1], [0,0,2]]\n      depth++;\n    } else {\n      if (\n        operation === V1_CONTROL_CHARS.SEQUENCE_GAP ||\n        (operation === V1_CONTROL_CHARS.END_OF_PREFIX &&\n          encodedVariantField[token.index - 1] !==\n            V1_CONTROL_CHARS.END_OF_PREFIX)\n      ) {\n        // add the current option value to the list of options if we hit a gap in our sequence or we are at the end of our depth and need to move back up\n        options.push([...currentOptionValue]);\n      }\n      if (operation === V1_CONTROL_CHARS.END_OF_PREFIX) {\n        // go up an option level, trash the last item in currentOptionValue\n        currentOptionValue.pop();\n        depth--;\n      }\n    }\n    index = tokenizer.lastIndex;\n  }\n\n  // The while loop only iterates control characters, meaning if an encoded string ends with an index it will not be processed.\n  const encodingEndsWithIndex = encodedVariantField.match(/\\d+$/g);\n  if (encodingEndsWithIndex) {\n    const finalValueIndex = parseInt(encodingEndsWithIndex[0]);\n    if (rangeStart != null) {\n      // process final range\n      for (; rangeStart <= finalValueIndex; rangeStart++) {\n        currentOptionValue[depth] = rangeStart;\n        options.push([...currentOptionValue]);\n      }\n    } else {\n      // process final index\n      options.push([finalValueIndex]);\n    }\n  }\n\n  return options;\n}\n"],"mappings":";AAaA,IAAM,yBAAyB;AAE/B,IAAM,mBAAmB;CACvB,QAAQ;CACR,eAAe;CACf,cAAc;CACd,OAAO;CACR;;;;;;;;;AAgBD,IAAa,kDACsC;CAC/C,MAAM,sCAAsB,IAAI,KAA0B;AAE1D,QAAO,SACL,8BACA,qBACS;AACT,MAAI,6BAA6B,WAAW,EAC1C,QAAO;AAGT,MAAI,CAAC,oBAAoB,IAAI,oBAAoB,EAAE;GACjD,MAAM,yCAAyB,IAAI,KAAa;AAEhD,QAAK,MAAM,eAAe,qBAAqB,oBAAoB,EAAE;AAEnE,2BAAuB,IAAI,YAAY,KAAK,uBAAuB,CAAC;AAGpE,SAAK,IAAI,IAAI,GAAG,IAAI,YAAY,QAAQ,IACtC,wBAAuB,IACrB,YAAY,MAAM,GAAG,IAAI,EAAE,CAAC,KAAK,uBAAuB,CACzD;;AAIL,uBAAoB,IAAI,qBAAqB,uBAAuB;;AAGtE,SAAO,QACL,oBACG,IAAI,oBAAoB,EACvB,IAAI,6BAA6B,KAAK,uBAAuB,CAAC,CACnE;;IAED;;;;;;;AAcN,SAAgB,qBACd,qBACqB;AACrB,KAAI,CAAC,oBAAqB,QAAO,EAAE;AAEnC,KAAI,oBAAoB,WAAW,MAAM,CACvC,QAAO,UAAU,aAAa,oBAAoB,CAAC;AAGrD,OAAM,IAAI,MAAM,oCAAoC;;AAGtD,IAAM,gBACJ,wBACG,oBAAoB,QAAQ,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;AAwB5C,SAAS,UAAU,qBAAyC;CAC1D,MAAM,YAAY;CAClB,IAAI,QAAQ;CACZ,IAAI;CACJ,MAAM,UAAsB,EAAE;CAC9B,MAAM,qBAA+B,EAAE;CACvC,IAAI,QAAQ;CACZ,IAAI,aAA4B;AAGhC,QAAQ,QAAQ,UAAU,KAAK,oBAAoB,EAAG;EACpD,MAAM,YAAY,MAAM;EACxB,MAAM,mBACJ,OAAO,SAAS,oBAAoB,MAAM,OAAO,MAAM,MAAM,CAAC,IAAI;AAEpE,MAAI,eAAe,MAAM;AAIvB,UAAO,aAAa,kBAAkB,cAAc;AAClD,uBAAmB,SAAS;AAC5B,YAAQ,KAAK,CAAC,GAAG,mBAAmB,CAAC;;AAGvC,gBAAa;;AAGf,qBAAmB,SAAS;AAE5B,MAAI,cAAc,iBAAiB,MAEjC,cAAa;WACJ,cAAc,iBAAiB,OAExC;OACK;AACL,OACE,cAAc,iBAAiB,gBAC9B,cAAc,iBAAiB,iBAC9B,oBAAoB,MAAM,QAAQ,OAChC,iBAAiB,cAGrB,SAAQ,KAAK,CAAC,GAAG,mBAAmB,CAAC;AAEvC,OAAI,cAAc,iBAAiB,eAAe;AAEhD,uBAAmB,KAAK;AACxB;;;AAGJ,UAAQ,UAAU;;CAIpB,MAAM,wBAAwB,oBAAoB,MAAM,QAAQ;AAChE,KAAI,uBAAuB;EACzB,MAAM,kBAAkB,SAAS,sBAAsB,GAAG;AAC1D,MAAI,cAAc,KAEhB,QAAO,cAAc,iBAAiB,cAAc;AAClD,sBAAmB,SAAS;AAC5B,WAAQ,KAAK,CAAC,GAAG,mBAAmB,CAAC;;MAIvC,SAAQ,KAAK,CAAC,gBAAgB,CAAC;;AAInC,QAAO"}

package/dist/browser-prod/packages/hydrogen-react/package.mjs

@@ -0,0 +1,6 @@
+//#region package.json
+var version = "2026.4.2";
+//#endregion
+export { version };
+
+//# sourceMappingURL=package.mjs.map

package/dist/browser-prod/packages/hydrogen-react/package.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.mjs","names":[],"sources":["../../../../package.json"],"sourcesContent":["{\n  \"name\": \"@shopify/hydrogen-react\",\n  \"version\": \"2026.4.2\",\n  \"description\": \"React components, hooks, and utilities for creating custom Shopify storefronts\",\n  \"homepage\": \"https://github.com/Shopify/hydrogen/tree/main/packages/hydrogen-react\",\n  \"license\": \"MIT\",\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"@shopify:registry\": \"https://registry.npmjs.org\"\n  },\n  \"files\": [\n    \"dist\",\n    \"storefront.schema.json\",\n    \"customer-account.schema.json\"\n  ],\n  \"type\": \"commonjs\",\n  \"exports\": {\n    \".\": {\n      \"node\": {\n        \"require\": {\n          \"types\": \"./dist/types/index.d.cts\",\n          \"development\": \"./dist/node-dev/index.js\",\n          \"default\": \"./dist/node-prod/index.js\"\n        },\n        \"import\": {\n          \"types\": \"./dist/types/index.d.ts\",\n          \"development\": \"./dist/node-dev/index.mjs\",\n          \"default\": \"./dist/node-prod/index.mjs\"\n        },\n        \"default\": \"./dist/node-prod/index.js\"\n      },\n      \"module\": {\n        \"types\": \"./dist/types/index.d.ts\",\n        \"development\": \"./dist/browser-dev/index.mjs\",\n        \"default\": \"./dist/browser-prod/index.mjs\"\n      },\n      \"import\": {\n        \"types\": \"./dist/types/index.d.ts\",\n        \"development\": \"./dist/browser-dev/index.mjs\",\n        \"default\": \"./dist/browser-prod/index.mjs\"\n      },\n      \"require\": {\n        \"types\": \"./dist/types/index.d.cts\",\n        \"development\": \"./dist/node-dev/index.js\",\n        \"default\": \"./dist/node-prod/index.js\"\n      },\n      \"default\": \"./dist/browser-prod/index.mjs\"\n    },\n    \"./storefront-api-types\": \"./dist/types/storefront-api-types.d.ts\",\n    \"./storefront.schema.json\": \"./storefront.schema.json\",\n    \"./customer-account.schema.json\": \"./customer-account.schema.json\",\n    \"./customer-account-api-types\": \"./dist/types/customer-account-api-types.d.ts\",\n    \"./package.json\": \"./package.json\",\n    \"./*\": {\n      \"node\": {\n        \"require\": {\n          \"types\": \"./dist/types/*.d.cts\",\n          \"development\": \"./dist/node-dev/*.js\",\n          \"default\": \"./dist/node-prod/*.js\"\n        },\n        \"import\": {\n          \"types\": \"./dist/types/*.d.ts\",\n          \"development\": \"./dist/node-dev/*.mjs\",\n          \"default\": \"./dist/node-prod/*.mjs\"\n        },\n        \"default\": \"./dist/node-prod/*.js\"\n      },\n      \"module\": {\n        \"types\": \"./dist/types/*.d.ts\",\n        \"development\": \"./dist/browser-dev/*.mjs\",\n        \"default\": \"./dist/browser-prod/*.mjs\"\n      },\n      \"import\": {\n        \"types\": \"./dist/types/*.d.ts\",\n        \"development\": \"./dist/browser-dev/*.mjs\",\n        \"default\": \"./dist/browser-prod/*.mjs\"\n      },\n      \"require\": {\n        \"types\": \"./dist/types/*.d.cts\",\n        \"development\": \"./dist/node-dev/*.js\",\n        \"default\": \"./dist/node-prod/*.js\"\n      },\n      \"default\": \"./dist/browser-prod/*.mjs\"\n    }\n  },\n  \"typesVersions\": {\n    \"*\": {\n      \"storefront-api-types\": [\n        \"./dist/types/storefront-api-types.d.ts\"\n      ]\n    }\n  },\n  \"main\": \"./dist/node-prod/index.js\",\n  \"module\": \"./dist/node-prod/index.mjs\",\n  \"browser\": \"./dist/browser-prod/index.mjs\",\n  \"types\": \"./dist/types/index.d.ts\",\n  \"unpkg\": \"./dist/umd/hydrogen-react.prod.js\",\n  \"jsdelivr\": \"./dist/umd/hydrogen-react.prod.js\",\n  \"sideEffects\": false,\n  \"scripts\": {\n    \"build-docs\": \"sh ./docs/build-docs.sh && pnpm run format\",\n    \"clean-dist\": \"rimraf ./dist\",\n    \"dev\": \"run-s dev:demo\",\n    \"dev:story\": \"ladle serve\",\n    \"dev:demo\": \"run-p dev:demo:* copy-api-types\",\n    \"dev:demo:browser-dev\": \"vite build --watch --emptyOutDir false --clearScreen false --mode devbuild\",\n    \"dev:demo:ts\": \"tsc --watch --emitDeclarationOnly\",\n    \"build\": \"npm-run-all --sequential clean-dist --parallel build:vite:* build:tsc:es --parallel build:tsc:cjs copy-api-types\",\n    \"build:vite:browser-dev\": \"vite build --mode devbuild\",\n    \"build:vite:browser-prod\": \"vite build\",\n    \"build:vite:node-dev\": \"vite build --mode devbuild --ssr\",\n    \"build:vite:node-prod\": \"vite build --ssr\",\n    \"build:vite:umddev\": \"vite build --mode umdbuilddev\",\n    \"build:vite:umdprod\": \"vite build --mode umdbuild\",\n    \"build:tsc:cjs\": \"cpy ./dist/types/index.d.ts ./dist/types/ --rename=index.d.cts --flat\",\n    \"build:tsc:es\": \"tsc --emitDeclarationOnly --project tsconfig.typeoutput.json\",\n    \"copy-api-types\": \"cpy ./src/storefront-api-types.d.ts ./src/customer-account-api-types.d.ts ./dist/types/ --flat\",\n    \"format\": \"prettier --write \\\"{src,docs}/**/*\\\" --ignore-unknown\",\n    \"graphql-types\": \"graphql-codegen --config codegen.ts && pnpm run format\",\n    \"test\": \"vitest run --coverage\",\n    \"test:watch\": \"vitest\",\n    \"typecheck\": \"run-p typecheck:*\",\n    \"typecheck:code\": \"tsc --noEmit\",\n    \"typecheck:examples\": \"tsc --noEmit --project tsconfig.examples.json\",\n    \"preview-docs\": \"pnpm --dir ../../docs/preview run dev\"\n  },\n  \"devDependencies\": {\n    \"@faker-js/faker\": \"^9.4.0\",\n    \"@graphql-codegen/add\": \"^5.0.3\",\n    \"@graphql-codegen/cli\": \"^5.0.4\",\n    \"@graphql-codegen/introspection\": \"^4.0.3\",\n    \"@graphql-codegen/typescript\": \"^4.1.3\",\n    \"@ladle/react\": \"^5.0.1\",\n    \"@shopify/generate-docs\": \"catalog:\",\n    \"@testing-library/jest-dom\": \"^6.6.3\",\n    \"@testing-library/react\": \"^14.0.0\",\n    \"@testing-library/user-event\": \"^14.6.1\",\n    \"@types/react\": \"catalog:\",\n    \"@types/react-dom\": \"catalog:\",\n    \"@vitejs/plugin-react\": \"^6.0.1\",\n    \"@vitest/coverage-v8\": \"^3.2.4\",\n    \"cpy-cli\": \"^5.0.0\",\n    \"eslint\": \"9.19.0\",\n    \"eslint-config-prettier\": \"10.0.1\",\n    \"eslint-import-resolver-typescript\": \"3.7.0\",\n    \"eslint-plugin-eslint-comments\": \"3.2.0\",\n    \"eslint-plugin-import\": \"2.31.0\",\n    \"eslint-plugin-jest\": \"28.11.0\",\n    \"eslint-plugin-jsx-a11y\": \"6.10.2\",\n    \"eslint-plugin-node\": \"11.1.0\",\n    \"eslint-plugin-prettier\": \"4.2.1\",\n    \"eslint-plugin-react\": \"7.37.4\",\n    \"eslint-plugin-react-hooks\": \"5.1.0\",\n    \"eslint-plugin-simple-import-sort\": \"12.1.1\",\n    \"eslint-plugin-tsdoc\": \"0.2.14\",\n    \"happy-dom\": \"^20.8.9\",\n    \"npm-run-all\": \"^4.1.5\",\n    \"react\": \"catalog:\",\n    \"react-dom\": \"catalog:\",\n    \"rimraf\": \"^6.0.1\",\n    \"ts-expect\": \"^1.3.0\",\n    \"typescript\": \"5.9.2\",\n    \"vite\": \"^8.0.1\",\n    \"vitest\": \"^3.2.4\"\n  },\n  \"peerDependencies\": {\n    \"react\": \"^18.3.1 || ~19.0.3 || ~19.1.4 || ^19.2.3\",\n    \"react-dom\": \"^18.3.1 || ~19.0.3 || ~19.1.4 || ^19.2.3\",\n    \"vite\": \"^5.1.0 || ^6.2.1 || ^7.0.0 || ^8.0.0\"\n  },\n  \"dependencies\": {\n    \"@google/model-viewer\": \"^4.0.0\",\n    \"@xstate/fsm\": \"2.0.0\",\n    \"ast-v8-to-istanbul\": \"^0.3.11\",\n    \"graphql\": \"^16.10.0\",\n    \"type-fest\": \"^4.33.0\",\n    \"worktop\": \"^0.7.3\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/Shopify/hydrogen.git\",\n    \"directory\": \"packages/hydrogen-react\"\n  },\n  \"bugs\": \"https://github.com/shopify/hydrogen/issues\"\n}\n"],"mappings":""}

package/dist/browser-prod/parse-metafield.mjs

@@ -1,151 +1,139 @@
 import { flattenConnection } from "./flatten-connection.mjs";
+//#region src/parse-metafield.ts
+/**
+* A function that uses `metafield.type` to parse the Metafield's `value` or `reference` or `references` (depending on the `metafield.type`) and places the result in `metafield.parsedValue`
+*
+* TypeScript developers can use the type `ParsedMetafields` from this package to get the returned object's type correct. For example:
+*
+* ```
+* parseMetafield<ParsedMetafields['boolean']>({type: 'boolean', value: 'false'}
+* ```
+* @publicDocs
+*/
 function parseMetafield(metafield) {
-  if (!metafield.type) {
-    const noTypeError = `parseMetafield(): The 'type' field is required in order to parse the Metafield.`;
-    {
-      console.error(`${noTypeError} Returning 'parsedValue' of 'null'`);
-      return {
-        ...metafield,
-        parsedValue: null
-      };
-    }
-  }
-  switch (metafield.type) {
-    case "boolean":
-      return {
-        ...metafield,
-        parsedValue: metafield.value === "true"
-      };
-    case "article_reference":
-    case "collection_reference":
-    case "file_reference":
-    case "page_reference":
-    case "product_reference":
-    case "variant_reference":
-      return {
-        ...metafield,
-        parsedValue: metafield.reference
-      };
-    case "color":
-    case "multi_line_text_field":
-    case "single_line_text_field":
-    case "url":
-      return {
-        ...metafield,
-        parsedValue: metafield.value
-      };
-    // TODO: 'money' should probably be parsed even further to like `useMoney()`, but that logic needs to be extracted first so it's not a hook
-    case "money": {
-      let parsedValue = null;
-      try {
-        const parsed = parseJSON(metafield.value ?? "");
-        if (parsed && typeof parsed === "object" && "currency_code" in parsed) {
-          const moneyData = parsed;
-          parsedValue = {
-            amount: moneyData.amount,
-            currencyCode: moneyData.currency_code
-          };
-        } else if (parsed && typeof parsed === "object" && "currencyCode" in parsed) {
-          parsedValue = parsed;
-        } else {
-          parsedValue = parsed;
-        }
-      } catch (err) {
-        const parseError = `parseMetafield(): attempted to JSON.parse the 'metafield.value' property, but failed.`;
-        {
-          console.error(`${parseError} Returning 'null' for 'parsedValue'`);
-        }
-        parsedValue = null;
-      }
-      return {
-        ...metafield,
-        parsedValue
-      };
-    }
-    case "dimension":
-    case "json":
-    case "rating":
-    case "volume":
-    case "weight":
-    case "rich_text_field":
-    case "list.color":
-    case "list.dimension":
-    case "list.number_integer":
-    case "list.number_decimal":
-    case "list.rating":
-    case "list.single_line_text_field":
-    case "list.url":
-    case "list.volume":
-    case "list.weight": {
-      let parsedValue = null;
-      try {
-        parsedValue = parseJSON(metafield.value ?? "");
-      } catch (err) {
-        const parseError = `parseMetafield(): attempted to JSON.parse the 'metafield.value' property, but failed.`;
-        {
-          console.error(`${parseError} Returning 'null' for 'parsedValue'`);
-        }
-        parsedValue = null;
-      }
-      return {
-        ...metafield,
-        parsedValue
-      };
-    }
-    case "date":
-    case "date_time":
-      return {
-        ...metafield,
-        parsedValue: new Date(metafield.value ?? "")
-      };
-    case "list.date":
-    case "list.date_time": {
-      const jsonParseValue = parseJSON((metafield == null ? void 0 : metafield.value) ?? "");
-      return {
-        ...metafield,
-        parsedValue: jsonParseValue.map((dateString) => new Date(dateString))
-      };
-    }
-    case "number_decimal":
-    case "number_integer":
-      return {
-        ...metafield,
-        parsedValue: Number(metafield.value)
-      };
-    case "list.article_reference":
-    case "list.collection_reference":
-    case "list.file_reference":
-    case "list.page_reference":
-    case "list.product_reference":
-    case "list.variant_reference":
-      return {
-        ...metafield,
-        parsedValue: flattenConnection(metafield.references ?? void 0)
-      };
-    default: {
-      const typeNotFoundError = `parseMetafield(): the 'metafield.type' you passed in is not supported. Your type: "${metafield.type}". If you believe this is an error, please open an issue on GitHub.`;
-      {
-        console.error(
-          `${typeNotFoundError}  Returning 'parsedValue' of 'null'`
-        );
-        return {
-          ...metafield,
-          parsedValue: null
-        };
-      }
-    }
-  }
+	if (!metafield.type) {
+		console.error(`parseMetafield(): The 'type' field is required in order to parse the Metafield. Returning 'parsedValue' of 'null'`);
+		return {
+			...metafield,
+			parsedValue: null
+		};
+	}
+	switch (metafield.type) {
+		case "boolean": return {
+			...metafield,
+			parsedValue: metafield.value === "true"
+		};
+		case "article_reference":
+		case "collection_reference":
+		case "file_reference":
+		case "page_reference":
+		case "product_reference":
+		case "variant_reference": return {
+			...metafield,
+			parsedValue: metafield.reference
+		};
+		case "color":
+		case "multi_line_text_field":
+		case "single_line_text_field":
+		case "url": return {
+			...metafield,
+			parsedValue: metafield.value
+		};
+		case "money": {
+			let parsedValue = null;
+			try {
+				const parsed = parseJSON(metafield.value ?? "");
+				if (parsed && typeof parsed === "object" && "currency_code" in parsed) {
+					const moneyData = parsed;
+					parsedValue = {
+						amount: moneyData.amount,
+						currencyCode: moneyData.currency_code
+					};
+				} else if (parsed && typeof parsed === "object" && "currencyCode" in parsed) parsedValue = parsed;
+				else parsedValue = parsed;
+			} catch (err) {
+				console.error(`parseMetafield(): attempted to JSON.parse the 'metafield.value' property, but failed. Returning 'null' for 'parsedValue'`);
+				parsedValue = null;
+			}
+			return {
+				...metafield,
+				parsedValue
+			};
+		}
+		case "dimension":
+		case "json":
+		case "rating":
+		case "volume":
+		case "weight":
+		case "rich_text_field":
+		case "list.color":
+		case "list.dimension":
+		case "list.number_integer":
+		case "list.number_decimal":
+		case "list.rating":
+		case "list.single_line_text_field":
+		case "list.url":
+		case "list.volume":
+		case "list.weight": {
+			let parsedValue = null;
+			try {
+				parsedValue = parseJSON(metafield.value ?? "");
+			} catch (err) {
+				console.error(`parseMetafield(): attempted to JSON.parse the 'metafield.value' property, but failed. Returning 'null' for 'parsedValue'`);
+				parsedValue = null;
+			}
+			return {
+				...metafield,
+				parsedValue
+			};
+		}
+		case "date":
+		case "date_time": return {
+			...metafield,
+			parsedValue: new Date(metafield.value ?? "")
+		};
+		case "list.date":
+		case "list.date_time": {
+			const jsonParseValue = parseJSON(metafield?.value ?? "");
+			return {
+				...metafield,
+				parsedValue: jsonParseValue.map((dateString) => new Date(dateString))
+			};
+		}
+		case "number_decimal":
+		case "number_integer": return {
+			...metafield,
+			parsedValue: Number(metafield.value)
+		};
+		case "list.article_reference":
+		case "list.collection_reference":
+		case "list.file_reference":
+		case "list.page_reference":
+		case "list.product_reference":
+		case "list.variant_reference": return {
+			...metafield,
+			parsedValue: flattenConnection(metafield.references ?? void 0)
+		};
+		default: {
+			const typeNotFoundError = `parseMetafield(): the 'metafield.type' you passed in is not supported. Your type: "${metafield.type}". If you believe this is an error, please open an issue on GitHub.`;
+			console.error(`${typeNotFoundError}  Returning 'parsedValue' of 'null'`);
+			return {
+				...metafield,
+				parsedValue: null
+			};
+		}
+	}
 }
+/**
+* Parses a JSON string while preventing prototype injection attacks.
+*/
 function parseJSON(json) {
-  if (String(json).includes("__proto__")) {
-    return JSON.parse(json, (k, v) => {
-      if (k !== "__proto__") return v;
-    });
-  }
-  return JSON.parse(json);
+	if (String(json).includes("__proto__")) return JSON.parse(json, (k, v) => {
+		if (k !== "__proto__") return v;
+	});
+	return JSON.parse(json);
 }
-export {
-  parseJSON,
-  parseMetafield
-};
-//# sourceMappingURL=parse-metafield.mjs.map
+//#endregion
+export { parseMetafield };
+
+//# sourceMappingURL=parse-metafield.mjs.map