@shopify/hydrogen 2026.4.5 → 2026.10.0-preview.2

package/dist/development/core/money/format.mjs

@@ -0,0 +1,243 @@
+import { getFormatter } from "./cache.mjs";
+
+//#region src/core/money/format.ts
+/**
+* Intl.NumberFormat part types that make up the raw numeric amount.
+* Used to extract "19.99" from a formatted string like "$19.99" by
+* filtering out currency symbols, sign, and other non-numeric parts.
+*/
+const NUMERIC_PART_TYPES = new Set([
+	"decimal",
+	"fraction",
+	"group",
+	"integer",
+	"literal"
+]);
+const WELL_FORMED_CURRENCY_CODE = /^[a-z]{3}$/i;
+function parseAmount(money) {
+	const parsed = parseFloat(money.amount);
+	if (Number.isNaN(parsed)) throw new Error(`formatMoney: "${money.amount}" is not a valid numeric amount for currency ${money.currencyCode}`);
+	return parsed;
+}
+function normalizeCurrencyCode(currencyCode) {
+	return currencyCode.toUpperCase();
+}
+/**
+* Intl accepts well-formed three-letter currency codes. Non-standard but
+* well-formed codes render as codes; malformed codes such as USDC throw.
+*/
+function isWellFormedCurrencyCode(currencyCode) {
+	return WELL_FORMED_CURRENCY_CODE.test(currencyCode);
+}
+function hasTrailingZeros(amount) {
+	return amount % 1 === 0;
+}
+function shouldStripTrailingZeros(amount, options) {
+	return options.withoutTrailingZeros === true && hasTrailingZeros(amount);
+}
+function hasExplicitFractionDigits(options) {
+	return options.minimumFractionDigits != null || options.maximumFractionDigits != null;
+}
+function decimalFractionOptions(options) {
+	return {
+		minimumFractionDigits: options.minimumFractionDigits ?? 2,
+		maximumFractionDigits: options.maximumFractionDigits ?? 2
+	};
+}
+function buildFormatOptions(currencyCode, supported, options, amount) {
+	const withoutCurrency = options.withoutCurrency === true || !supported;
+	const trailingZeros = shouldStripTrailingZeros(amount, options);
+	if (withoutCurrency) return trailingZeros ? {
+		minimumFractionDigits: 0,
+		maximumFractionDigits: 0
+	} : decimalFractionOptions(options);
+	return {
+		style: "currency",
+		currency: currencyCode,
+		...options.currencyDisplay && { currencyDisplay: options.currencyDisplay },
+		...trailingZeros && {
+			minimumFractionDigits: 0,
+			maximumFractionDigits: 0
+		},
+		...!trailingZeros && options.minimumFractionDigits != null && { minimumFractionDigits: options.minimumFractionDigits },
+		...!trailingZeros && options.maximumFractionDigits != null && { maximumFractionDigits: options.maximumFractionDigits }
+	};
+}
+function appendUnsupportedCurrencyCode(formatted, currencyCode) {
+	return `${formatted} ${currencyCode}`;
+}
+function extractNumericAmount(parts) {
+	return parts.filter((part) => NUMERIC_PART_TYPES.has(part.type)).map((part) => part.value).join("");
+}
+function findCurrencyPart(parts) {
+	return parts.find((part) => part.type === "currency")?.value ?? "";
+}
+function formatRange(formatter, min, max) {
+	const rangeFormatter = formatter;
+	return rangeFormatter.formatRange ? rangeFormatter.formatRange(min, max) : `${formatter.format(min)} - ${formatter.format(max)}`;
+}
+function isMoneyRange(money) {
+	return Array.isArray(money);
+}
+function buildRangeOptions(currencyCode, supported, options, amounts) {
+	const wholeRange = amounts.every(hasTrailingZeros);
+	return buildFormatOptions(currencyCode, supported, {
+		...options,
+		withoutTrailingZeros: options.withoutTrailingZeros ?? (wholeRange && !hasExplicitFractionDigits(options))
+	}, amounts[0] ?? 0);
+}
+function sortMoneyRangeEntries(entries) {
+	const sorted = [];
+	for (const entry of entries) {
+		const index = sorted.findIndex((candidate) => entry.amount < candidate.amount);
+		if (index === -1) sorted.push(entry);
+		else sorted.splice(index, 0, entry);
+	}
+	return sorted;
+}
+/**
+* All structured fields are computed lazily on first access and cached.
+* localizedString is the exception — it's computed eagerly in the constructor
+* so that the common `${price}` path never touches the getter machinery.
+*/
+var FormattedMoneyValue = class {
+	#amount;
+	#options;
+	#currencyCode;
+	#supported;
+	localizedString;
+	#defaultFormatter;
+	#formatterParts;
+	#parts;
+	#amountString;
+	#currencySymbol;
+	#currencyNarrowSymbol;
+	#currencyName;
+	#withoutTrailingZeros;
+	#withoutTrailingZerosAndCurrency;
+	constructor(money, options) {
+		this.#amount = parseAmount(money);
+		this.#options = options;
+		this.#currencyCode = normalizeCurrencyCode(money.currencyCode);
+		this.#supported = isWellFormedCurrencyCode(money.currencyCode);
+		this.#defaultFormatter = getFormatter(options.locale, buildFormatOptions(this.#currencyCode, this.#supported, options, this.#amount));
+		const formatted = this.#defaultFormatter.format(this.#amount);
+		this.localizedString = this.#supported || options.withoutCurrency === true ? formatted : appendUnsupportedCurrencyCode(formatted, this.#currencyCode);
+	}
+	get amount() {
+		this.#amountString ??= extractNumericAmount(this.formatterParts);
+		return this.#amountString;
+	}
+	get numericAmount() {
+		return this.#amount;
+	}
+	get currencySymbol() {
+		this.#currencySymbol ??= this.#supported ? findCurrencyPart(this.parts) : this.#currencyCode;
+		return this.#currencySymbol;
+	}
+	get currencyNarrowSymbol() {
+		this.#currencyNarrowSymbol ??= this.#supported ? findCurrencyPart(getFormatter(this.#options.locale, {
+			style: "currency",
+			currency: this.#currencyCode,
+			currencyDisplay: "narrowSymbol",
+			...this.#options.minimumFractionDigits != null && { minimumFractionDigits: this.#options.minimumFractionDigits },
+			...this.#options.maximumFractionDigits != null && { maximumFractionDigits: this.#options.maximumFractionDigits }
+		}).formatToParts(this.#amount)) : this.#currencyCode;
+		return this.#currencyNarrowSymbol;
+	}
+	get currencyName() {
+		this.#currencyName ??= this.#supported ? findCurrencyPart(getFormatter(this.#options.locale, {
+			style: "currency",
+			currency: this.#currencyCode,
+			currencyDisplay: "name",
+			...this.#options.minimumFractionDigits != null && { minimumFractionDigits: this.#options.minimumFractionDigits },
+			...this.#options.maximumFractionDigits != null && { maximumFractionDigits: this.#options.maximumFractionDigits }
+		}).formatToParts(this.#amount)) || this.#currencyCode : this.#currencyCode;
+		return this.#currencyName;
+	}
+	get parts() {
+		if (!this.#parts) this.#parts = this.#supported || this.#options.withoutCurrency === true ? this.formatterParts : [
+			...this.formatterParts,
+			{
+				type: "literal",
+				value: " "
+			},
+			{
+				type: "currency",
+				value: this.#currencyCode
+			}
+		];
+		return this.#parts;
+	}
+	get withoutTrailingZeros() {
+		if (!this.#withoutTrailingZeros) {
+			const options = {
+				...this.#options,
+				withoutTrailingZeros: true
+			};
+			const formatted = getFormatter(options.locale, buildFormatOptions(this.#currencyCode, this.#supported, options, this.#amount)).format(this.#amount);
+			this.#withoutTrailingZeros = this.#supported || this.#options.withoutCurrency === true ? formatted : appendUnsupportedCurrencyCode(formatted, this.#currencyCode);
+		}
+		return this.#withoutTrailingZeros;
+	}
+	get withoutTrailingZerosAndCurrency() {
+		if (!this.#withoutTrailingZerosAndCurrency) {
+			const options = {
+				...this.#options,
+				withoutCurrency: true,
+				withoutTrailingZeros: true
+			};
+			this.#withoutTrailingZerosAndCurrency = getFormatter(options.locale, buildFormatOptions(this.#currencyCode, this.#supported, options, this.#amount)).format(this.#amount);
+		}
+		return this.#withoutTrailingZerosAndCurrency;
+	}
+	get formatterParts() {
+		this.#formatterParts ??= this.#defaultFormatter.formatToParts(this.#amount);
+		return this.#formatterParts;
+	}
+	toString() {
+		return this.localizedString;
+	}
+};
+var FormattedMoneyRangeValue = class {
+	localizedString;
+	min;
+	max;
+	currencyCode;
+	constructor(range, options) {
+		if (range.length === 0) throw new Error("formatMoney: money range must contain at least one value");
+		const entries = sortMoneyRangeEntries(range.map((money) => ({
+			money,
+			amount: parseAmount(money),
+			currencyCode: normalizeCurrencyCode(money.currencyCode)
+		})));
+		const [first] = entries;
+		if (!first) throw new Error("formatMoney: money range must contain at least one value");
+		const mismatched = entries.find((entry) => entry.currencyCode !== first.currencyCode);
+		if (mismatched) throw new Error(`formatMoney: range values must share one currency, received ${first.currencyCode} and ${mismatched.currencyCode}`);
+		const last = entries[entries.length - 1] ?? first;
+		this.min = first.money;
+		this.max = last.money;
+		this.currencyCode = first.currencyCode;
+		if (first.amount === last.amount) {
+			this.localizedString = new FormattedMoneyValue(first.money, {
+				...options,
+				withoutTrailingZeros: options.withoutTrailingZeros ?? !hasExplicitFractionDigits(options)
+			}).localizedString;
+			return;
+		}
+		const supported = isWellFormedCurrencyCode(first.currencyCode);
+		const formatted = formatRange(getFormatter(options.locale, buildRangeOptions(first.currencyCode, supported, options, entries.map((entry) => entry.amount))), first.amount, last.amount);
+		this.localizedString = supported || options.withoutCurrency === true ? formatted : appendUnsupportedCurrencyCode(formatted, first.currencyCode);
+	}
+	toString() {
+		return this.localizedString;
+	}
+};
+function formatMoney(money, options) {
+	return isMoneyRange(money) ? new FormattedMoneyRangeValue(money, options) : new FormattedMoneyValue(money, options);
+}
+
+//#endregion
+export { formatMoney };
+//# sourceMappingURL=format.mjs.map

package/dist/development/core/money/format.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.mjs","names":["#amount","#options","#currencyCode","#supported","#defaultFormatter","#amountString","#currencySymbol","#currencyNarrowSymbol","#currencyName","#parts","#withoutTrailingZeros","#withoutTrailingZerosAndCurrency","#formatterParts"],"sources":["../../../../src/core/money/format.ts"],"sourcesContent":["import { getFormatter } from \"./cache\";\nimport type { FormatMoneyOptions, FormattedMoney, FormattedMoneyRange, MoneyV2 } from \"./types\";\n\n/**\n * Intl.NumberFormat part types that make up the raw numeric amount.\n * Used to extract \"19.99\" from a formatted string like \"$19.99\" by\n * filtering out currency symbols, sign, and other non-numeric parts.\n */\nconst NUMERIC_PART_TYPES = new Set([\"decimal\", \"fraction\", \"group\", \"integer\", \"literal\"]);\nconst WELL_FORMED_CURRENCY_CODE = /^[a-z]{3}$/i;\n\ntype RangeFormatter = Intl.NumberFormat & {\n  formatRange?: (start: number, end: number) => string;\n};\n\ntype MoneyRangeEntry = {\n  money: MoneyV2;\n  amount: number;\n  currencyCode: string;\n};\n\nfunction parseAmount(money: MoneyV2): number {\n  const parsed = parseFloat(money.amount);\n  if (Number.isNaN(parsed)) {\n    throw new Error(\n      `formatMoney: \"${money.amount}\" is not a valid numeric amount for currency ${money.currencyCode}`,\n    );\n  }\n  return parsed;\n}\n\nfunction normalizeCurrencyCode(currencyCode: string): string {\n  return currencyCode.toUpperCase();\n}\n\n/**\n * Intl accepts well-formed three-letter currency codes. Non-standard but\n * well-formed codes render as codes; malformed codes such as USDC throw.\n */\nfunction isWellFormedCurrencyCode(currencyCode: string): boolean {\n  return WELL_FORMED_CURRENCY_CODE.test(currencyCode);\n}\n\nfunction hasTrailingZeros(amount: number): boolean {\n  return amount % 1 === 0;\n}\n\nfunction shouldStripTrailingZeros(amount: number, options: FormatMoneyOptions): boolean {\n  return options.withoutTrailingZeros === true && hasTrailingZeros(amount);\n}\n\nfunction hasExplicitFractionDigits(options: FormatMoneyOptions): boolean {\n  return options.minimumFractionDigits != null || options.maximumFractionDigits != null;\n}\n\nfunction decimalFractionOptions(options: FormatMoneyOptions): Intl.NumberFormatOptions {\n  return {\n    minimumFractionDigits: options.minimumFractionDigits ?? 2,\n    maximumFractionDigits: options.maximumFractionDigits ?? 2,\n  };\n}\n\nfunction buildFormatOptions(\n  currencyCode: string,\n  supported: boolean,\n  options: FormatMoneyOptions,\n  amount: number,\n): Intl.NumberFormatOptions {\n  const withoutCurrency = options.withoutCurrency === true || !supported;\n  const trailingZeros = shouldStripTrailingZeros(amount, options);\n\n  if (withoutCurrency) {\n    return trailingZeros\n      ? { minimumFractionDigits: 0, maximumFractionDigits: 0 }\n      : decimalFractionOptions(options);\n  }\n\n  return {\n    style: \"currency\",\n    currency: currencyCode,\n    ...(options.currencyDisplay && { currencyDisplay: options.currencyDisplay }),\n    ...(trailingZeros && {\n      minimumFractionDigits: 0,\n      maximumFractionDigits: 0,\n    }),\n    ...(!trailingZeros &&\n      options.minimumFractionDigits != null && {\n        minimumFractionDigits: options.minimumFractionDigits,\n      }),\n    ...(!trailingZeros &&\n      options.maximumFractionDigits != null && {\n        maximumFractionDigits: options.maximumFractionDigits,\n      }),\n  };\n}\n\nfunction appendUnsupportedCurrencyCode(formatted: string, currencyCode: string): string {\n  return `${formatted} ${currencyCode}`;\n}\n\nfunction extractNumericAmount(parts: Intl.NumberFormatPart[]): string {\n  return parts\n    .filter((part) => NUMERIC_PART_TYPES.has(part.type))\n    .map((part) => part.value)\n    .join(\"\");\n}\n\nfunction findCurrencyPart(parts: Intl.NumberFormatPart[]): string {\n  return parts.find((part) => part.type === \"currency\")?.value ?? \"\";\n}\n\nfunction formatRange(formatter: Intl.NumberFormat, min: number, max: number): string {\n  const rangeFormatter = formatter as RangeFormatter;\n  return rangeFormatter.formatRange\n    ? rangeFormatter.formatRange(min, max)\n    : `${formatter.format(min)} - ${formatter.format(max)}`;\n}\n\nfunction isMoneyRange(money: MoneyV2 | readonly MoneyV2[]): money is readonly MoneyV2[] {\n  return Array.isArray(money);\n}\n\nfunction buildRangeOptions(\n  currencyCode: string,\n  supported: boolean,\n  options: FormatMoneyOptions,\n  amounts: number[],\n): Intl.NumberFormatOptions {\n  const wholeRange = amounts.every(hasTrailingZeros);\n  const rangeOptions = {\n    ...options,\n    withoutTrailingZeros:\n      options.withoutTrailingZeros ?? (wholeRange && !hasExplicitFractionDigits(options)),\n  };\n\n  return buildFormatOptions(currencyCode, supported, rangeOptions, amounts[0] ?? 0);\n}\n\nfunction sortMoneyRangeEntries(entries: MoneyRangeEntry[]): MoneyRangeEntry[] {\n  const sorted: MoneyRangeEntry[] = [];\n\n  for (const entry of entries) {\n    const index = sorted.findIndex((candidate) => entry.amount < candidate.amount);\n    if (index === -1) {\n      sorted.push(entry);\n    } else {\n      sorted.splice(index, 0, entry);\n    }\n  }\n\n  return sorted;\n}\n\n/**\n * All structured fields are computed lazily on first access and cached.\n * localizedString is the exception — it's computed eagerly in the constructor\n * so that the common `${price}` path never touches the getter machinery.\n */\nclass FormattedMoneyValue implements FormattedMoney {\n  readonly #amount: number;\n  readonly #options: FormatMoneyOptions;\n  readonly #currencyCode: string;\n  readonly #supported: boolean;\n  readonly localizedString: string;\n\n  readonly #defaultFormatter: Intl.NumberFormat;\n  #formatterParts?: Intl.NumberFormatPart[];\n  #parts?: Intl.NumberFormatPart[];\n  #amountString?: string;\n  #currencySymbol?: string;\n  #currencyNarrowSymbol?: string;\n  #currencyName?: string;\n  #withoutTrailingZeros?: string;\n  #withoutTrailingZerosAndCurrency?: string;\n\n  constructor(money: MoneyV2, options: FormatMoneyOptions) {\n    this.#amount = parseAmount(money);\n    this.#options = options;\n    this.#currencyCode = normalizeCurrencyCode(money.currencyCode);\n    this.#supported = isWellFormedCurrencyCode(money.currencyCode);\n    this.#defaultFormatter = getFormatter(\n      options.locale,\n      buildFormatOptions(this.#currencyCode, this.#supported, options, this.#amount),\n    );\n\n    const formatted = this.#defaultFormatter.format(this.#amount);\n    this.localizedString =\n      this.#supported || options.withoutCurrency === true\n        ? formatted\n        : appendUnsupportedCurrencyCode(formatted, this.#currencyCode);\n  }\n\n  get amount(): string {\n    this.#amountString ??= extractNumericAmount(this.formatterParts);\n    return this.#amountString;\n  }\n\n  get numericAmount(): number {\n    return this.#amount;\n  }\n\n  get currencySymbol(): string {\n    this.#currencySymbol ??= this.#supported ? findCurrencyPart(this.parts) : this.#currencyCode;\n    return this.#currencySymbol;\n  }\n\n  get currencyNarrowSymbol(): string {\n    this.#currencyNarrowSymbol ??= this.#supported\n      ? findCurrencyPart(\n          getFormatter(this.#options.locale, {\n            style: \"currency\",\n            currency: this.#currencyCode,\n            currencyDisplay: \"narrowSymbol\",\n            ...(this.#options.minimumFractionDigits != null && {\n              minimumFractionDigits: this.#options.minimumFractionDigits,\n            }),\n            ...(this.#options.maximumFractionDigits != null && {\n              maximumFractionDigits: this.#options.maximumFractionDigits,\n            }),\n          }).formatToParts(this.#amount),\n        )\n      : this.#currencyCode;\n    return this.#currencyNarrowSymbol;\n  }\n\n  get currencyName(): string {\n    this.#currencyName ??= this.#supported\n      ? findCurrencyPart(\n          getFormatter(this.#options.locale, {\n            style: \"currency\",\n            currency: this.#currencyCode,\n            currencyDisplay: \"name\",\n            ...(this.#options.minimumFractionDigits != null && {\n              minimumFractionDigits: this.#options.minimumFractionDigits,\n            }),\n            ...(this.#options.maximumFractionDigits != null && {\n              maximumFractionDigits: this.#options.maximumFractionDigits,\n            }),\n          }).formatToParts(this.#amount),\n        ) || this.#currencyCode\n      : this.#currencyCode;\n    return this.#currencyName;\n  }\n\n  get parts(): Intl.NumberFormatPart[] {\n    if (!this.#parts) {\n      this.#parts =\n        this.#supported || this.#options.withoutCurrency === true\n          ? this.formatterParts\n          : [\n              ...this.formatterParts,\n              { type: \"literal\" as const, value: \" \" },\n              { type: \"currency\" as const, value: this.#currencyCode },\n            ];\n    }\n\n    return this.#parts;\n  }\n\n  get withoutTrailingZeros(): string {\n    if (!this.#withoutTrailingZeros) {\n      const options = { ...this.#options, withoutTrailingZeros: true };\n      const formatter = getFormatter(\n        options.locale,\n        buildFormatOptions(this.#currencyCode, this.#supported, options, this.#amount),\n      );\n      const formatted = formatter.format(this.#amount);\n      this.#withoutTrailingZeros =\n        this.#supported || this.#options.withoutCurrency === true\n          ? formatted\n          : appendUnsupportedCurrencyCode(formatted, this.#currencyCode);\n    }\n\n    return this.#withoutTrailingZeros;\n  }\n\n  get withoutTrailingZerosAndCurrency(): string {\n    if (!this.#withoutTrailingZerosAndCurrency) {\n      const options = { ...this.#options, withoutCurrency: true, withoutTrailingZeros: true };\n      this.#withoutTrailingZerosAndCurrency = getFormatter(\n        options.locale,\n        buildFormatOptions(this.#currencyCode, this.#supported, options, this.#amount),\n      ).format(this.#amount);\n    }\n\n    return this.#withoutTrailingZerosAndCurrency;\n  }\n\n  private get formatterParts(): Intl.NumberFormatPart[] {\n    this.#formatterParts ??= this.#defaultFormatter.formatToParts(this.#amount);\n    return this.#formatterParts;\n  }\n\n  toString(): string {\n    return this.localizedString;\n  }\n}\n\nclass FormattedMoneyRangeValue implements FormattedMoneyRange {\n  readonly localizedString: string;\n  readonly min: MoneyV2;\n  readonly max: MoneyV2;\n  readonly currencyCode: string;\n\n  constructor(range: readonly MoneyV2[], options: FormatMoneyOptions) {\n    if (range.length === 0) {\n      throw new Error(\"formatMoney: money range must contain at least one value\");\n    }\n\n    const entries = sortMoneyRangeEntries(\n      range.map((money) => ({\n        money,\n        amount: parseAmount(money),\n        currencyCode: normalizeCurrencyCode(money.currencyCode),\n      })),\n    );\n\n    const [first] = entries;\n    if (!first) {\n      throw new Error(\"formatMoney: money range must contain at least one value\");\n    }\n\n    const mismatched = entries.find((entry) => entry.currencyCode !== first.currencyCode);\n    if (mismatched) {\n      throw new Error(\n        `formatMoney: range values must share one currency, received ${first.currencyCode} and ${mismatched.currencyCode}`,\n      );\n    }\n\n    const last = entries[entries.length - 1] ?? first;\n    this.min = first.money;\n    this.max = last.money;\n    this.currencyCode = first.currencyCode;\n\n    if (first.amount === last.amount) {\n      this.localizedString = new FormattedMoneyValue(first.money, {\n        ...options,\n        withoutTrailingZeros: options.withoutTrailingZeros ?? !hasExplicitFractionDigits(options),\n      }).localizedString;\n      return;\n    }\n\n    const supported = isWellFormedCurrencyCode(first.currencyCode);\n    const formatter = getFormatter(\n      options.locale,\n      buildRangeOptions(\n        first.currencyCode,\n        supported,\n        options,\n        entries.map((entry) => entry.amount),\n      ),\n    );\n\n    const formatted = formatRange(formatter, first.amount, last.amount);\n    this.localizedString =\n      supported || options.withoutCurrency === true\n        ? formatted\n        : appendUnsupportedCurrencyCode(formatted, first.currencyCode);\n  }\n\n  toString(): string {\n    return this.localizedString;\n  }\n}\n\n/**\n * Format a MoneyV2 value or a same-currency range of MoneyV2 values for display.\n *\n * Returns an object that stringifies to the locale-formatted price via\n * toString(). Structured fields on single prices are computed lazily when\n * accessed, so the common string path stays cheap.\n */\nexport function formatMoney(money: MoneyV2, options: FormatMoneyOptions): FormattedMoney;\nexport function formatMoney(\n  money: readonly MoneyV2[],\n  options: FormatMoneyOptions,\n): FormattedMoneyRange;\n\n// This is the implementation of the formatMoney function overloading the other two.\n// It checks if the input is a range and creates the appropriate object.\nexport function formatMoney(\n  money: MoneyV2 | readonly MoneyV2[],\n  options: FormatMoneyOptions,\n): FormattedMoney | FormattedMoneyRange {\n  return isMoneyRange(money)\n    ? new FormattedMoneyRangeValue(money, options)\n    : new FormattedMoneyValue(money, options);\n}\n"],"mappings":"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"}

package/dist/development/core/money/types.d.mts

@@ -0,0 +1,47 @@
+//#region src/core/money/types.d.ts
+/**
+ * Matches the Storefront API's MoneyV2 shape.
+ * Uses `string` for currencyCode instead of the generated CurrencyCode enum
+ * so the utility also accepts Customer Account API currencies (e.g. USDC)
+ * that may not be in the Storefront API's enum.
+ */
+type MoneyV2 = {
+  amount: string;
+  currencyCode: string;
+};
+type FormatMoneyOptions = {
+  /** BCP 47 locale string. e.g. 'en-US', 'fr-CA', 'ja-JP'. */locale: string; /** Omit the currency symbol/code from the output. */
+  withoutCurrency?: boolean; /** Strip trailing fractional zeros. '$19.00' → '$19'. */
+  withoutTrailingZeros?: boolean; /** Override Intl minimumFractionDigits. */
+  minimumFractionDigits?: number; /** Override Intl maximumFractionDigits. */
+  maximumFractionDigits?: number;
+  /**
+   * Intl.NumberFormat currencyDisplay option.
+   * 'symbol' (default) | 'narrowSymbol' | 'code' | 'name'
+   *
+   * 'narrowSymbol' is useful for disambiguating $ across CAD/AUD/USD.
+   */
+  currencyDisplay?: Intl.NumberFormatOptions["currencyDisplay"];
+};
+type FormattedMoney = {
+  /** The full locale-formatted string. Also returned by toString(). */localizedString: string; /** Just the numeric portion, no currency. '19.99' or '1,299.00'. */
+  amount: string; /** Currency symbol from Intl. '$', '€', '¥', 'CA$', etc. */
+  currencySymbol: string; /** Narrow symbol. '$' even for CAD. Empty string if unavailable. */
+  currencyNarrowSymbol: string; /** Full currency name. 'US dollars', 'Canadian dollars'. */
+  currencyName: string; /** The raw numeric amount as a number. parseFloat(money.amount). */
+  numericAmount: number; /** The raw Intl.NumberFormat parts array. */
+  parts: Intl.NumberFormatPart[]; /** Formatted string with trailing zeros removed. '$19.00' → '$19'. */
+  withoutTrailingZeros: string; /** Amount without currency and without trailing zeros. '19.00' → '19'. */
+  withoutTrailingZerosAndCurrency: string; /** Returns localizedString so the object works in template literals and string concatenation. */
+  toString(): string;
+};
+type FormattedMoneyRange = {
+  /** The full locale-formatted range string. Also returned by toString(). */localizedString: string; /** Lowest value in the input range after sorting. */
+  min: MoneyV2; /** Highest value in the input range after sorting. */
+  max: MoneyV2; /** Shared currency code for every range member. */
+  currencyCode: string; /** Returns localizedString so the object works in template literals and string concatenation. */
+  toString(): string;
+};
+//#endregion
+export { FormatMoneyOptions, FormattedMoney, FormattedMoneyRange, MoneyV2 };
+//# sourceMappingURL=types.d.mts.map

package/dist/development/core/observable.mjs

@@ -0,0 +1,46 @@
+//#region src/core/observable.ts
+function createObservable(initialState) {
+	let currentState = initialState;
+	let listeners = [];
+	function setState(next) {
+		const nextState = typeof next === "function" ? next(currentState) : next;
+		if (Object.is(currentState, nextState)) return;
+		currentState = nextState;
+		const snapshot = listeners.slice();
+		for (const listener of snapshot) {
+			if (!listeners.includes(listener)) continue;
+			if (listener.selector) {
+				const nextSlice = listener.selector(currentState);
+				if (listener.isEqual(listener.prev, nextSlice)) continue;
+				listener.prev = nextSlice;
+				listener.fn(nextSlice);
+			} else listener.fn(currentState);
+		}
+	}
+	function subscribe(fn, selector, isEqual) {
+		const listener = {
+			fn,
+			selector,
+			isEqual: isEqual ?? Object.is,
+			prev: selector ? selector(currentState) : void 0
+		};
+		listeners.push(listener);
+		let subscribed = true;
+		return () => {
+			if (!subscribed) return;
+			subscribed = false;
+			listeners = listeners.filter((l) => l !== listener);
+		};
+	}
+	return {
+		get state() {
+			return currentState;
+		},
+		subscribe,
+		setState
+	};
+}
+
+//#endregion
+export { createObservable };
+//# sourceMappingURL=observable.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observable.mjs","names":[],"sources":["../../../src/core/observable.ts"],"sourcesContent":["interface Observable<T> {\n  readonly state: T;\n  subscribe(fn: (state: T) => void): () => void;\n  subscribe<S>(\n    fn: (slice: S) => void,\n    selector: (state: T) => S,\n    isEqual?: (a: S, b: S) => boolean,\n  ): () => void;\n}\n\ntype InternalObservable<T> = Observable<T> & {\n  setState(next: T | ((prev: T) => T)): void;\n};\n\ntype Listener<T> = {\n  fn: (value: unknown) => void;\n  selector?: (state: T) => unknown;\n  isEqual: (a: unknown, b: unknown) => boolean;\n  prev: unknown;\n};\n\nexport function createObservable<T>(initialState: T): InternalObservable<T> {\n  let currentState = initialState;\n  let listeners: Listener<T>[] = [];\n\n  function setState(next: T | ((prev: T) => T)): void {\n    const nextState = typeof next === \"function\" ? (next as (prev: T) => T)(currentState) : next;\n\n    if (Object.is(currentState, nextState)) return;\n\n    currentState = nextState;\n\n    const snapshot = listeners.slice();\n    for (const listener of snapshot) {\n      if (!listeners.includes(listener)) continue;\n\n      if (listener.selector) {\n        const nextSlice = listener.selector(currentState);\n        if (listener.isEqual(listener.prev, nextSlice)) continue;\n        listener.prev = nextSlice;\n        listener.fn(nextSlice);\n      } else {\n        listener.fn(currentState);\n      }\n    }\n  }\n\n  function subscribe(fn: (state: T) => void): () => void;\n  function subscribe<S>(\n    fn: (slice: S) => void,\n    selector: (state: T) => S,\n    isEqual?: (a: S, b: S) => boolean,\n  ): () => void;\n  function subscribe<S>(\n    fn: (value: T | S) => void,\n    selector?: (state: T) => S,\n    isEqual?: (a: S, b: S) => boolean,\n  ): () => void {\n    const listener: Listener<T> = {\n      fn: fn as (value: unknown) => void,\n      selector,\n      isEqual: (isEqual as ((a: unknown, b: unknown) => boolean) | undefined) ?? Object.is,\n      prev: selector ? selector(currentState) : undefined,\n    };\n\n    listeners.push(listener);\n\n    let subscribed = true;\n    return () => {\n      if (!subscribed) return;\n      subscribed = false;\n      listeners = listeners.filter((l) => l !== listener);\n    };\n  }\n\n  return {\n    get state() {\n      return currentState;\n    },\n    subscribe,\n    setState,\n  };\n}\n"],"mappings":";AAqBA,SAAgB,iBAAoB,cAAwC;CAC1E,IAAI,eAAe;CACnB,IAAI,YAA2B,EAAE;CAEjC,SAAS,SAAS,MAAkC;EAClD,MAAM,YAAY,OAAO,SAAS,aAAc,KAAwB,aAAa,GAAG;AAExF,MAAI,OAAO,GAAG,cAAc,UAAU,CAAE;AAExC,iBAAe;EAEf,MAAM,WAAW,UAAU,OAAO;AAClC,OAAK,MAAM,YAAY,UAAU;AAC/B,OAAI,CAAC,UAAU,SAAS,SAAS,CAAE;AAEnC,OAAI,SAAS,UAAU;IACrB,MAAM,YAAY,SAAS,SAAS,aAAa;AACjD,QAAI,SAAS,QAAQ,SAAS,MAAM,UAAU,CAAE;AAChD,aAAS,OAAO;AAChB,aAAS,GAAG,UAAU;SAEtB,UAAS,GAAG,aAAa;;;CAW/B,SAAS,UACP,IACA,UACA,SACY;EACZ,MAAM,WAAwB;GACxB;GACJ;GACA,SAAU,WAAiE,OAAO;GAClF,MAAM,WAAW,SAAS,aAAa,GAAG;GAC3C;AAED,YAAU,KAAK,SAAS;EAExB,IAAI,aAAa;AACjB,eAAa;AACX,OAAI,CAAC,WAAY;AACjB,gBAAa;AACb,eAAY,UAAU,QAAQ,MAAM,MAAM,SAAS;;;AAIvD,QAAO;EACL,IAAI,QAAQ;AACV,UAAO;;EAET;EACA;EACD"}

package/dist/development/core/predictive-search/constants.d.mts

@@ -0,0 +1,5 @@
+//#region src/core/predictive-search/constants.d.ts
+declare const PREDICTIVE_SEARCH_GET_METHOD: "GET";
+//#endregion
+export { PREDICTIVE_SEARCH_GET_METHOD };
+//# sourceMappingURL=constants.d.mts.map

package/dist/development/core/predictive-search/constants.mjs

@@ -0,0 +1,6 @@
+//#region src/core/predictive-search/constants.ts
+const PREDICTIVE_SEARCH_API_PATH = "/api/predictive-search";
+
+//#endregion
+export { PREDICTIVE_SEARCH_API_PATH };
+//# sourceMappingURL=constants.mjs.map

package/dist/development/core/predictive-search/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","names":[],"sources":["../../../../src/core/predictive-search/constants.ts"],"sourcesContent":["export const PREDICTIVE_SEARCH_API_PATH = \"/api/predictive-search\" as const;\nexport const PREDICTIVE_SEARCH_GET_METHOD = \"GET\" as const;\nexport const PREDICTIVE_SEARCH_QUERY_PARAM = \"q\" as const;\n"],"mappings":";AAAA,MAAa,6BAA6B"}

package/dist/development/core/predictive-search/form.d.mts

@@ -0,0 +1,31 @@
+//#region src/core/predictive-search/form.d.ts
+/** Props returned by {@link PredictiveSearchFormRegister} for the query input. */
+interface PredictiveSearchQueryInputAttributes {
+  name: "q";
+  type: "search";
+  autoComplete: "off";
+  autoCapitalize: "off";
+  spellCheck: false;
+}
+/** Props returned by {@link getPredictiveSearchFormAttributes} for the search form. */
+interface PredictiveSearchFormAttributes {
+  action: string;
+  method: "get";
+  role: "search";
+}
+/**
+ * Register function returned by predictive search form bindings.
+ *
+ * Predictive search forms only register the Storefront API query input.
+ */
+type PredictiveSearchFormRegister = {
+  (field: "query"): PredictiveSearchQueryInputAttributes;
+};
+/** Creates a {@link PredictiveSearchFormRegister} for framework-neutral form fields. */
+declare function createPredictiveSearchFormRegister(): PredictiveSearchFormRegister;
+/** Returns progressive-enhancement attributes for a predictive search form. */
+declare function getPredictiveSearchFormAttributes(action?: string): PredictiveSearchFormAttributes;
+declare function readPredictiveSearchFormTerm(formData: FormData): string;
+//#endregion
+export { PredictiveSearchFormAttributes, PredictiveSearchFormRegister, PredictiveSearchQueryInputAttributes, createPredictiveSearchFormRegister, getPredictiveSearchFormAttributes, readPredictiveSearchFormTerm };
+//# sourceMappingURL=form.d.mts.map

package/dist/development/core/predictive-search/form.mjs

@@ -0,0 +1,31 @@
+//#region src/core/predictive-search/form.ts
+/** Creates a {@link PredictiveSearchFormRegister} for framework-neutral form fields. */
+function createPredictiveSearchFormRegister() {
+	return registerPredictiveSearchFormField;
+}
+function registerPredictiveSearchFormField(field) {
+	if (field !== "query") throw new Error(`Unknown predictive search form field: "${field}".`);
+	return {
+		name: "q",
+		type: "search",
+		autoComplete: "off",
+		autoCapitalize: "off",
+		spellCheck: false
+	};
+}
+/** Returns progressive-enhancement attributes for a predictive search form. */
+function getPredictiveSearchFormAttributes(action = "/search") {
+	return {
+		action,
+		method: "get",
+		role: "search"
+	};
+}
+function readPredictiveSearchFormTerm(formData) {
+	const value = formData.get("q");
+	return typeof value === "string" ? value : "";
+}
+
+//#endregion
+export { createPredictiveSearchFormRegister, getPredictiveSearchFormAttributes, readPredictiveSearchFormTerm };
+//# sourceMappingURL=form.mjs.map

package/dist/development/core/predictive-search/form.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.mjs","names":[],"sources":["../../../../src/core/predictive-search/form.ts"],"sourcesContent":["import { PREDICTIVE_SEARCH_QUERY_PARAM } from \"./constants\";\n\n/** Props returned by {@link PredictiveSearchFormRegister} for the query input. */\nexport interface PredictiveSearchQueryInputAttributes {\n  name: \"q\";\n  type: \"search\";\n  autoComplete: \"off\";\n  autoCapitalize: \"off\";\n  spellCheck: false;\n}\n\n/** Props returned by {@link getPredictiveSearchFormAttributes} for the search form. */\nexport interface PredictiveSearchFormAttributes {\n  action: string;\n  method: \"get\";\n  role: \"search\";\n}\n\n/**\n * Register function returned by predictive search form bindings.\n *\n * Predictive search forms only register the Storefront API query input.\n */\nexport type PredictiveSearchFormRegister = {\n  (field: \"query\"): PredictiveSearchQueryInputAttributes;\n};\n\n/** Creates a {@link PredictiveSearchFormRegister} for framework-neutral form fields. */\nexport function createPredictiveSearchFormRegister(): PredictiveSearchFormRegister {\n  return registerPredictiveSearchFormField;\n}\n\nfunction registerPredictiveSearchFormField(field: string): PredictiveSearchQueryInputAttributes {\n  if (field !== \"query\") {\n    throw new Error(`Unknown predictive search form field: \"${field}\".`);\n  }\n\n  return {\n    name: \"q\",\n    type: \"search\",\n    autoComplete: \"off\",\n    autoCapitalize: \"off\",\n    spellCheck: false,\n  };\n}\n\n/** Returns progressive-enhancement attributes for a predictive search form. */\nexport function getPredictiveSearchFormAttributes(\n  action: string = \"/search\",\n): PredictiveSearchFormAttributes {\n  return {\n    action,\n    method: \"get\",\n    role: \"search\",\n  };\n}\n\nexport function readPredictiveSearchFormTerm(formData: FormData): string {\n  const value = formData.get(PREDICTIVE_SEARCH_QUERY_PARAM);\n  return typeof value === \"string\" ? value : \"\";\n}\n"],"mappings":";;AA4BA,SAAgB,qCAAmE;AACjF,QAAO;;AAGT,SAAS,kCAAkC,OAAqD;AAC9F,KAAI,UAAU,QACZ,OAAM,IAAI,MAAM,0CAA0C,MAAM,IAAI;AAGtE,QAAO;EACL,MAAM;EACN,MAAM;EACN,cAAc;EACd,gBAAgB;EAChB,YAAY;EACb;;;AAIH,SAAgB,kCACd,SAAiB,WACe;AAChC,QAAO;EACL;EACA,QAAQ;EACR,MAAM;EACP;;AAGH,SAAgB,6BAA6B,UAA4B;CACvE,MAAM,QAAQ,SAAS,QAAkC;AACzD,QAAO,OAAO,UAAU,WAAW,QAAQ"}

package/dist/development/core/predictive-search/index.d.mts

@@ -0,0 +1,6 @@
+import { PredictiveSearchFormAttributes, PredictiveSearchFormRegister, PredictiveSearchQueryInputAttributes, createPredictiveSearchFormRegister, getPredictiveSearchFormAttributes, readPredictiveSearchFormTerm } from "./form.mjs";
+import { CreatePredictiveSearchQueriesOptions, PredictiveSearchFragments, makePredictiveSearchQueries, predictiveSearchQueries } from "./queries.mjs";
+import { PredictiveSearchData, PredictiveSearchDataForOptions, QueryPredictiveSearchOptions, queryPredictiveSearch } from "./search.mjs";
+import { CreatePredictiveSearchServerHandlersOptions, createPredictiveSearchServerHandlers } from "./server-handlers.mjs";
+import { CreatePredictiveSearchStoreOptions, PredictiveSearchState, PredictiveSearchStatus, PredictiveSearchStore, createPredictiveSearchStore } from "./store.mjs";
+import { PredictiveSearchArticleItem, PredictiveSearchCollectionItem, PredictiveSearchItem, PredictiveSearchItemUrlOptions, PredictiveSearchPageItem, PredictiveSearchProductItem, PredictiveSearchQueryItem, PredictiveSearchQueryItemUrlOptions, PredictiveSearchResourceItem, getPredictiveSearchItemUrl, getSearchResultUrl } from "./url.mjs";

package/dist/development/core/predictive-search/queries.d.mts

@@ -0,0 +1,118 @@
+import { InferResult, InferVariables } from "../../graphql/type-resolver.mjs";
+import { AnyStorefrontQueryString, ComposedSource, SourceOf, StorefrontQueryString } from "../../graphql/graphql.mjs";
+//#region src/core/predictive-search/queries.d.ts
+declare const PREDICTIVE_SEARCH_QUERY: StorefrontQueryString<{
+  predictiveSearch: {
+    articles: {
+      __typename: "Article";
+      id: string;
+      title: string;
+      handle: string;
+      blog: {
+        handle: string;
+      };
+      image: {
+        url: string;
+        altText: string | null;
+        width: number | null;
+        height: number | null;
+      } | null;
+      trackingParameters: string | null;
+    }[];
+    collections: {
+      __typename: "Collection";
+      id: string;
+      title: string;
+      handle: string;
+      image: {
+        url: string;
+        altText: string | null;
+        width: number | null;
+        height: number | null;
+      } | null;
+      trackingParameters: string | null;
+    }[];
+    pages: {
+      __typename: "Page";
+      id: string;
+      title: string;
+      handle: string;
+      trackingParameters: string | null;
+    }[];
+    products: {
+      __typename: "Product";
+      id: string;
+      title: string;
+      handle: string;
+      trackingParameters: string | null;
+      selectedOrFirstAvailableVariant: {
+        id: string;
+        image: {
+          url: string;
+          altText: string | null;
+          width: number | null;
+          height: number | null;
+        } | null;
+        price: {
+          amount: string;
+          currencyCode: "ALL" | "USD" | "EUR" | "GBP" | "CAD" | "AFN" | "DZD" | "AOA" | "ARS" | "AMD" | "AWG" | "AUD" | "BBD" | "AZN" | "BDT" | "BSD" | "BHD" | "BIF" | "BZD" | "BMD" | "BTN" | "BAM" | "BRL" | "BOB" | "BWP" | "BND" | "BGN" | "MMK" | "KHR" | "CVE" | "KYD" | "XAF" | "CLP" | "CNY" | "COP" | "KMF" | "CDF" | "CRC" | "HRK" | "CZK" | "DKK" | "DOP" | "XCD" | "EGP" | "ERN" | "ETB" | "FKP" | "XPF" | "FJD" | "GIP" | "GMD" | "GHS" | "GTQ" | "GYD" | "GEL" | "HTG" | "HNL" | "HKD" | "HUF" | "ISK" | "INR" | "IDR" | "ILS" | "IQD" | "JMD" | "JPY" | "JEP" | "JOD" | "KZT" | "KES" | "KID" | "KWD" | "KGS" | "LAK" | "LVL" | "LBP" | "LSL" | "LRD" | "LTL" | "MGA" | "MKD" | "MOP" | "MWK" | "MVR" | "MRU" | "MXN" | "MYR" | "MUR" | "MDL" | "MAD" | "MNT" | "MZN" | "NAD" | "NPR" | "ANG" | "NZD" | "NIO" | "NGN" | "NOK" | "OMR" | "PAB" | "PKR" | "PGK" | "PYG" | "PEN" | "PHP" | "PLN" | "QAR" | "RON" | "RUB" | "RWF" | "WST" | "SHP" | "SAR" | "RSD" | "SCR" | "SGD" | "SDG" | "SOS" | "SYP" | "ZAR" | "KRW" | "SSP" | "SBD" | "LKR" | "SRD" | "SZL" | "SEK" | "CHF" | "TWD" | "THB" | "TZS" | "TTD" | "TND" | "TRY" | "TMT" | "UGX" | "UAH" | "AED" | "UYU" | "UZS" | "VUV" | "VES" | "VND" | "XOF" | "YER" | "ZMW" | "BYN" | "BYR" | "DJF" | "GNF" | "IRR" | "LYD" | "SLL" | "STD" | "STN" | "TJS" | "TOP" | "VED" | "VEF" | "XXX";
+        };
+      } | null;
+    }[];
+    queries: {
+      __typename: "SearchQuerySuggestion";
+      text: string;
+      styledText: string;
+      trackingParameters: string | null;
+    }[];
+  } | null;
+}, {
+  unavailableProducts?: "HIDE" | "LAST" | "SHOW" | null | undefined;
+  searchableFields?: ("AUTHOR" | "BODY" | "PRODUCT_TYPE" | "TAG" | "TITLE" | "VARIANTS_BARCODE" | "VARIANTS_SKU" | "VARIANTS_TITLE" | "VENDOR")[] | null | undefined;
+  types?: ("ARTICLE" | "COLLECTION" | "PAGE" | "PRODUCT" | "QUERY")[] | null | undefined;
+  term: string;
+  limitScope?: "ALL" | "EACH" | null | undefined;
+  limit?: number | null | undefined;
+  language?: "ID" | "AF" | "AK" | "AM" | "AR" | "AS" | "AZ" | "BE" | "BG" | "BM" | "BN" | "BO" | "BR" | "BS" | "CA" | "CE" | "CKB" | "CS" | "CY" | "DA" | "DE" | "DZ" | "EE" | "EL" | "EN" | "EO" | "ES" | "ET" | "EU" | "FA" | "FF" | "FI" | "FIL" | "FO" | "FR" | "FY" | "GA" | "GD" | "GL" | "GU" | "GV" | "HA" | "HE" | "HI" | "HR" | "HU" | "HY" | "IA" | "IG" | "II" | "IS" | "IT" | "JA" | "JV" | "KA" | "KI" | "KK" | "KL" | "KM" | "KN" | "KO" | "KS" | "KU" | "KW" | "KY" | "LB" | "LG" | "LN" | "LO" | "LT" | "LU" | "LV" | "MG" | "MI" | "MK" | "ML" | "MN" | "MR" | "MS" | "MT" | "MY" | "NB" | "ND" | "NE" | "NL" | "NN" | "NO" | "OM" | "OR" | "OS" | "PA" | "PL" | "PS" | "PT_BR" | "PT_PT" | "QU" | "RM" | "RN" | "RO" | "RU" | "RW" | "SA" | "SC" | "SD" | "SE" | "SG" | "SI" | "SK" | "SL" | "SN" | "SO" | "SQ" | "SR" | "SU" | "SV" | "SW" | "TA" | "TE" | "TG" | "TH" | "TI" | "TK" | "TO" | "TR" | "TT" | "UG" | "UK" | "UR" | "UZ" | "VI" | "WO" | "XH" | "YI" | "YO" | "ZH_CN" | "ZH_TW" | "ZU" | "ZH" | "PT" | "CU" | "VO" | "LA" | "SH" | "MO" | null | undefined;
+  country?: "ID" | "AF" | "AM" | "AR" | "AZ" | "BE" | "BG" | "BM" | "BN" | "BO" | "BR" | "BS" | "CA" | "CY" | "DE" | "DZ" | "EE" | "ES" | "ET" | "FI" | "FO" | "FR" | "GA" | "GD" | "GL" | "HR" | "HU" | "IS" | "IT" | "KI" | "KM" | "KN" | "KW" | "KY" | "LB" | "LT" | "LU" | "LV" | "MG" | "MK" | "ML" | "MN" | "MR" | "MS" | "MT" | "MY" | "NE" | "NL" | "NO" | "OM" | "PA" | "PL" | "PS" | "RO" | "RU" | "RW" | "SA" | "SC" | "SD" | "SE" | "SG" | "SI" | "SK" | "SL" | "SN" | "SO" | "SR" | "SV" | "TA" | "TG" | "TH" | "TK" | "TO" | "TR" | "TT" | "UG" | "UZ" | "PT" | "CU" | "LA" | "SH" | "MO" | "AX" | "AL" | "AD" | "AO" | "AI" | "AG" | "AW" | "AC" | "AU" | "AT" | "BH" | "BD" | "BB" | "BY" | "BZ" | "BJ" | "BT" | "BA" | "BW" | "BV" | "IO" | "BF" | "BI" | "KH" | "CV" | "BQ" | "CF" | "TD" | "CL" | "CN" | "CX" | "CC" | "CO" | "CG" | "CD" | "CK" | "CR" | "CW" | "CZ" | "CI" | "DK" | "DJ" | "DM" | "DO" | "EC" | "EG" | "GQ" | "ER" | "SZ" | "FK" | "FJ" | "GF" | "PF" | "TF" | "GM" | "GE" | "GH" | "GI" | "GR" | "GP" | "GT" | "GG" | "GN" | "GW" | "GY" | "HT" | "HM" | "VA" | "HN" | "HK" | "IN" | "IR" | "IQ" | "IE" | "IM" | "IL" | "JM" | "JP" | "JE" | "JO" | "KZ" | "KE" | "KP" | "XK" | "KG" | "LS" | "LR" | "LY" | "LI" | "MW" | "MV" | "MQ" | "MU" | "YT" | "MX" | "MD" | "MC" | "ME" | "MA" | "MZ" | "MM" | "NA" | "NR" | "NP" | "AN" | "NC" | "NZ" | "NI" | "NG" | "NU" | "NF" | "PK" | "PG" | "PY" | "PE" | "PH" | "PN" | "QA" | "CM" | "RE" | "BL" | "LC" | "MF" | "PM" | "WS" | "SM" | "ST" | "RS" | "SX" | "SB" | "ZA" | "GS" | "KR" | "SS" | "LK" | "VC" | "SJ" | "CH" | "SY" | "TW" | "TJ" | "TZ" | "TL" | "TN" | "TM" | "TC" | "TV" | "UA" | "AE" | "GB" | "US" | "UM" | "UY" | "VU" | "VE" | "VN" | "VG" | "WF" | "EH" | "YE" | "ZM" | "ZW" | "ZZ" | null | undefined;
+}, "query PredictiveSearch(\n    $country: CountryCode\n    $language: LanguageCode\n    $limit: Int\n    $limitScope: PredictiveSearchLimitScope\n    $term: String!\n    $types: [PredictiveSearchType!]\n    $searchableFields: [SearchableField!]\n    $unavailableProducts: SearchUnavailableProductsType\n  ) @inContext(country: $country, language: $language) {\n    predictiveSearch(\n      limit: $limit\n      limitScope: $limitScope\n      query: $term\n      types: $types\n      searchableFields: $searchableFields\n      unavailableProducts: $unavailableProducts\n    ) {\n      articles {\n        ...HydrogenPredictiveSearchArticleFragment\n        ...PredictiveSearchArticleFragment\n      }\n      collections {\n        ...HydrogenPredictiveSearchCollectionFragment\n        ...PredictiveSearchCollectionFragment\n      }\n      pages {\n        ...HydrogenPredictiveSearchPageFragment\n        ...PredictiveSearchPageFragment\n      }\n      products {\n        ...HydrogenPredictiveSearchProductFragment\n        ...PredictiveSearchProductFragment\n      }\n      queries {\n        ...HydrogenPredictiveSearchQueryFragment\n        ...PredictiveSearchQueryFragment\n      }\n    }\n  }\n\n  fragment HydrogenPredictiveSearchProductFragment on Product {\n    __typename\n    id\n    title\n    handle\n    trackingParameters\n    selectedOrFirstAvailableVariant(\n      selectedOptions: []\n      ignoreUnknownOptions: true\n      caseInsensitiveMatch: true\n    ) {\n      id\n      image {\n        url\n        altText\n        width\n        height\n      }\n      price {\n        amount\n        currencyCode\n      }\n    }\n  }\n\n\n  fragment HydrogenPredictiveSearchCollectionFragment on Collection {\n    __typename\n    id\n    title\n    handle\n    image {\n      url\n      altText\n      width\n      height\n    }\n    trackingParameters\n  }\n\n\n  fragment HydrogenPredictiveSearchPageFragment on Page {\n    __typename\n    id\n    title\n    handle\n    trackingParameters\n  }\n\n\n  fragment HydrogenPredictiveSearchArticleFragment on Article {\n    __typename\n    id\n    title\n    handle\n    blog {\n      handle\n    }\n    image {\n      url\n      altText\n      width\n      height\n    }\n    trackingParameters\n  }\n\n\n  fragment HydrogenPredictiveSearchQueryFragment on SearchQuerySuggestion {\n    __typename\n    text\n    styledText\n    trackingParameters\n  }\n">;
+declare const DEFAULT_PRODUCT_FRAGMENT: StorefrontQueryString<{
+  id: string;
+}, never, "\n  fragment PredictiveSearchProductFragment on Product {\n    id\n  }\n">;
+declare const DEFAULT_COLLECTION_FRAGMENT: StorefrontQueryString<{
+  id: string;
+}, never, "\n  fragment PredictiveSearchCollectionFragment on Collection {\n    id\n  }\n">;
+declare const DEFAULT_PAGE_FRAGMENT: StorefrontQueryString<{
+  id: string;
+}, never, "\n  fragment PredictiveSearchPageFragment on Page {\n    id\n  }\n">;
+declare const DEFAULT_ARTICLE_FRAGMENT: StorefrontQueryString<{
+  id: string;
+}, never, "\n  fragment PredictiveSearchArticleFragment on Article {\n    id\n  }\n">;
+declare const DEFAULT_QUERY_FRAGMENT: StorefrontQueryString<{
+  text: string;
+}, never, "\n  fragment PredictiveSearchQueryFragment on SearchQuerySuggestion {\n    text\n  }\n">;
+type PredictiveSearchFragments = {
+  readonly product?: AnyStorefrontQueryString;
+  readonly collection?: AnyStorefrontQueryString;
+  readonly page?: AnyStorefrontQueryString;
+  readonly article?: AnyStorefrontQueryString;
+  readonly query?: AnyStorefrontQueryString;
+};
+type CreatePredictiveSearchQueriesOptions<TFragments extends PredictiveSearchFragments = PredictiveSearchFragments> = {
+  readonly fragments?: TFragments;
+};
+type FragmentForOptions<TOptions, TKey extends keyof PredictiveSearchFragments, TDefault extends AnyStorefrontQueryString> = TOptions extends {
+  readonly fragments: infer TFragments;
+} ? TFragments extends Record<TKey, infer TFragment extends AnyStorefrontQueryString> ? TFragment : TDefault : TDefault;
+type PredictiveSearchQueryFragmentsForOptions<TOptions> = [FragmentForOptions<TOptions, "product", typeof DEFAULT_PRODUCT_FRAGMENT>, FragmentForOptions<TOptions, "collection", typeof DEFAULT_COLLECTION_FRAGMENT>, FragmentForOptions<TOptions, "page", typeof DEFAULT_PAGE_FRAGMENT>, FragmentForOptions<TOptions, "article", typeof DEFAULT_ARTICLE_FRAGMENT>, FragmentForOptions<TOptions, "query", typeof DEFAULT_QUERY_FRAGMENT>];
+type PredictiveSearchQuerySourceForOptions<TOptions> = ComposedSource<SourceOf<typeof PREDICTIVE_SEARCH_QUERY>, PredictiveSearchQueryFragmentsForOptions<TOptions>>;
+type PredictiveSearchQueryForOptions<TOptions> = StorefrontQueryString<InferResult<PredictiveSearchQuerySourceForOptions<TOptions>>, InferVariables<PredictiveSearchQuerySourceForOptions<TOptions>>, PredictiveSearchQuerySourceForOptions<TOptions>>;
+type PredictiveSearchQueriesForOptions<TOptions> = {
+  readonly predictiveSearch: PredictiveSearchQueryForOptions<TOptions>;
+};
+declare function makePredictiveSearchQueries<const TOptions extends CreatePredictiveSearchQueriesOptions>(options: TOptions): PredictiveSearchQueriesForOptions<TOptions>;
+declare function makePredictiveSearchQueries(): PredictiveSearchQueriesForOptions<undefined>;
+declare const predictiveSearchQueries: PredictiveSearchQueriesForOptions<undefined>;
+//#endregion
+export { CreatePredictiveSearchQueriesOptions, PredictiveSearchFragments, PredictiveSearchQueriesForOptions, makePredictiveSearchQueries, predictiveSearchQueries };
+//# sourceMappingURL=queries.d.mts.map