@shopify/hydrogen 2026.4.5 → 2026.10.0-preview.2

package/dist/graphql/generated/storefront-api-types.d.mts

@@ -0,0 +1,47 @@
+//#region src/graphql/generated/storefront-api-types.d.ts
+/**
+ * Error codes returned by [`CartUserError`](https://shopify.dev/docs/api/storefront/current/objects/CartUserError) during cart mutations. Covers validation failures for addresses, quantities, delivery options, merchandise lines, discount codes, and metafields.
+ *
+ */
+type CartErrorCode = /** The specified address field contains emojis. */"ADDRESS_FIELD_CONTAINS_EMOJIS" /** The specified address field contains HTML tags. */ | "ADDRESS_FIELD_CONTAINS_HTML_TAGS" /** The specified address field contains a URL. */ | "ADDRESS_FIELD_CONTAINS_URL" /** The specified address field does not match the expected pattern. */ | "ADDRESS_FIELD_DOES_NOT_MATCH_EXPECTED_PATTERN" /** The specified address field is required. */ | "ADDRESS_FIELD_IS_REQUIRED" /** The specified address field is too long. */ | "ADDRESS_FIELD_IS_TOO_LONG" /** Bundles and addons cannot be mixed. */ | "BUNDLES_AND_ADDONS_CANNOT_BE_MIXED" /** Buyer cannot purchase for company location. */ | "BUYER_CANNOT_PURCHASE_FOR_COMPANY_LOCATION" /** The cart is too large to save. */ | "CART_TOO_LARGE" /** The specified gift card recipient is invalid. */ | "GIFT_CARD_RECIPIENT_INVALID" /** The input value is invalid. */ | "INVALID" /** Company location not found or not allowed. */ | "INVALID_COMPANY_LOCATION" /** The delivery address was not found. */ | "INVALID_DELIVERY_ADDRESS_ID" /** Delivery group was not found in cart. */ | "INVALID_DELIVERY_GROUP" /** Delivery option was not valid. */ | "INVALID_DELIVERY_OPTION" /** The quantity must be a multiple of the specified increment. */ | "INVALID_INCREMENT" /** Merchandise line was not found in cart. */ | "INVALID_MERCHANDISE_LINE" /** The metafields were not valid. */ | "INVALID_METAFIELDS" /** The payment wasn't valid. */ | "INVALID_PAYMENT" /** The payment is invalid. Deferred payment is required. */ | "INVALID_PAYMENT_DEFERRED_PAYMENT_REQUIRED" /** Cannot update payment on an empty cart */ | "INVALID_PAYMENT_EMPTY_CART" /** The given zip code is invalid for the provided country. */ | "INVALID_ZIP_CODE_FOR_COUNTRY" /** The given zip code is invalid for the provided province. */ | "INVALID_ZIP_CODE_FOR_PROVINCE" /** The input value should be less than the maximum value allowed. */ | "LESS_THAN" /** The quantity must be below the specified maximum for the item. */ | "MAXIMUM_EXCEEDED" /** An error occurred while processing cart transformations. */ | "MERCHANDISE_LINE_TRANSFORMERS_RUN_ERROR" /** Item cannot be purchased as configured. */ | "MERCHANDISE_NOT_APPLICABLE" /** The quantity must be above the specified minimum for the item. */ | "MINIMUM_NOT_MET" /** The customer access token is required when setting a company location. */ | "MISSING_CUSTOMER_ACCESS_TOKEN" /** Missing discount code. */ | "MISSING_DISCOUNT_CODE" /** Missing note. */ | "MISSING_NOTE" /** The note length must be below the specified maximum. */ | "NOTE_TOO_LONG" /** Only one delivery address can be selected. */ | "ONLY_ONE_DELIVERY_ADDRESS_CAN_BE_SELECTED" /** Cannot reference existing parent lines by variant_id. */ | "PARENT_LINE_INVALID_REFERENCE" /** Parent line nesting is too deep or circular. */ | "PARENT_LINE_NESTING_TOO_DEEP" /** Parent line not found. */ | "PARENT_LINE_NOT_FOUND" /** Nested cartlines are blocked due to an incompatibility. */ | "PARENT_LINE_OPERATION_BLOCKED" /** Credit card has expired. */ | "PAYMENTS_CREDIT_CARD_BASE_EXPIRED" /** Credit card gateway is not supported. */ | "PAYMENTS_CREDIT_CARD_BASE_GATEWAY_NOT_SUPPORTED" /** Credit card error. */ | "PAYMENTS_CREDIT_CARD_GENERIC" /** Credit card month is invalid. */ | "PAYMENTS_CREDIT_CARD_MONTH_INCLUSION" /** Credit card number is invalid. */ | "PAYMENTS_CREDIT_CARD_NUMBER_INVALID" /** Credit card number format is invalid. */ | "PAYMENTS_CREDIT_CARD_NUMBER_INVALID_FORMAT" /** Credit card verification value is blank. */ | "PAYMENTS_CREDIT_CARD_VERIFICATION_VALUE_BLANK" /** Credit card verification value is invalid for card type. */ | "PAYMENTS_CREDIT_CARD_VERIFICATION_VALUE_INVALID_FOR_CARD_TYPE" /** Credit card has expired. */ | "PAYMENTS_CREDIT_CARD_YEAR_EXPIRED" /** Credit card expiry year is invalid. */ | "PAYMENTS_CREDIT_CARD_YEAR_INVALID_EXPIRY_YEAR" /** The payment method is not applicable. */ | "PAYMENT_METHOD_NOT_APPLICABLE" /** The payment method is not supported. */ | "PAYMENT_METHOD_NOT_SUPPORTED" /** The delivery group is in a pending state. */ | "PENDING_DELIVERY_GROUPS" /** The given province cannot be found. */ | "PROVINCE_NOT_FOUND" /** Selling plan is not applicable. */ | "SELLING_PLAN_NOT_APPLICABLE" /** An error occurred while saving the cart. */ | "SERVICE_UNAVAILABLE" /** Too many delivery addresses on Cart. */ | "TOO_MANY_DELIVERY_ADDRESSES" /** A general error occurred during address validation. */ | "UNSPECIFIED_ADDRESS_ERROR" /** Validation failed. */ | "VALIDATION_CUSTOM" /** Variant can only be purchased with a selling plan. */ | "VARIANT_REQUIRES_SELLING_PLAN" /** The given zip code is unsupported. */ | "ZIP_CODE_NOT_SUPPORTED";
+/** The code for the cart warning. */
+type CartWarningCode = /** The discount code cannot be honored. */"DISCOUNT_CODE_NOT_HONOURED" /** The discount is currently inactive. */ | "DISCOUNT_CURRENTLY_INACTIVE" /** The customer is not eligible for this discount. */ | "DISCOUNT_CUSTOMER_NOT_ELIGIBLE" /** The customer's discount usage limit has been reached. */ | "DISCOUNT_CUSTOMER_USAGE_LIMIT_REACHED" /** An eligible customer is missing for this discount. */ | "DISCOUNT_ELIGIBLE_CUSTOMER_MISSING" /** The purchase type is incompatible with this discount. */ | "DISCOUNT_INCOMPATIBLE_PURCHASE_TYPE" /** The discount was not found. */ | "DISCOUNT_NOT_FOUND" /** There are no entitled line items for this discount. */ | "DISCOUNT_NO_ENTITLED_LINE_ITEMS" /** There are no entitled shipping lines for this discount. */ | "DISCOUNT_NO_ENTITLED_SHIPPING_LINES" /** The purchase is not in range for this discount. */ | "DISCOUNT_PURCHASE_NOT_IN_RANGE" /** The quantity is not in range for this discount. */ | "DISCOUNT_QUANTITY_NOT_IN_RANGE" /** The discount usage limit has been reached. */ | "DISCOUNT_USAGE_LIMIT_REACHED" /** A delivery address with the same details already exists on this cart. */ | "DUPLICATE_DELIVERY_ADDRESS" /** The merchandise does not have enough stock. */ | "MERCHANDISE_NOT_ENOUGH_STOCK" /** The merchandise is out of stock. */ | "MERCHANDISE_OUT_OF_STOCK" /** Only one-time purchase is available for B2B orders. */ | "MERCHANDISE_SELLING_PLAN_NOT_APPLICABLE_ON_COMPANY_LOCATION" /** Gift cards are not available as a payment method. */ | "PAYMENTS_GIFT_CARDS_UNAVAILABLE";
+/**
+ * The code designating a country/region, which generally follows ISO 3166-1 alpha-2 guidelines.
+ * If a territory doesn't have a country code value in the `CountryCode` enum, then it might be considered a subdivision
+ * of another country. For example, the territories associated with Spain are represented by the country code `ES`,
+ * and the territories associated with the United States of America are represented by the country code `US`.
+ *
+ */
+type CountryCode = /** Ascension Island. */"AC" /** Andorra. */ | "AD" /** United Arab Emirates. */ | "AE" /** Afghanistan. */ | "AF" /** Antigua & Barbuda. */ | "AG" /** Anguilla. */ | "AI" /** Albania. */ | "AL" /** Armenia. */ | "AM" /** Netherlands Antilles. */ | "AN" /** Angola. */ | "AO" /** Argentina. */ | "AR" /** Austria. */ | "AT" /** Australia. */ | "AU" /** Aruba. */ | "AW" /** Åland Islands. */ | "AX" /** Azerbaijan. */ | "AZ" /** Bosnia & Herzegovina. */ | "BA" /** Barbados. */ | "BB" /** Bangladesh. */ | "BD" /** Belgium. */ | "BE" /** Burkina Faso. */ | "BF" /** Bulgaria. */ | "BG" /** Bahrain. */ | "BH" /** Burundi. */ | "BI" /** Benin. */ | "BJ" /** St. Barthélemy. */ | "BL" /** Bermuda. */ | "BM" /** Brunei. */ | "BN" /** Bolivia. */ | "BO" /** Caribbean Netherlands. */ | "BQ" /** Brazil. */ | "BR" /** Bahamas. */ | "BS" /** Bhutan. */ | "BT" /** Bouvet Island. */ | "BV" /** Botswana. */ | "BW" /** Belarus. */ | "BY" /** Belize. */ | "BZ" /** Canada. */ | "CA" /** Cocos (Keeling) Islands. */ | "CC" /** Congo - Kinshasa. */ | "CD" /** Central African Republic. */ | "CF" /** Congo - Brazzaville. */ | "CG" /** Switzerland. */ | "CH" /** Côte d’Ivoire. */ | "CI" /** Cook Islands. */ | "CK" /** Chile. */ | "CL" /** Cameroon. */ | "CM" /** China. */ | "CN" /** Colombia. */ | "CO" /** Costa Rica. */ | "CR" /** Cuba. */ | "CU" /** Cape Verde. */ | "CV" /** Curaçao. */ | "CW" /** Christmas Island. */ | "CX" /** Cyprus. */ | "CY" /** Czechia. */ | "CZ" /** Germany. */ | "DE" /** Djibouti. */ | "DJ" /** Denmark. */ | "DK" /** Dominica. */ | "DM" /** Dominican Republic. */ | "DO" /** Algeria. */ | "DZ" /** Ecuador. */ | "EC" /** Estonia. */ | "EE" /** Egypt. */ | "EG" /** Western Sahara. */ | "EH" /** Eritrea. */ | "ER" /** Spain. */ | "ES" /** Ethiopia. */ | "ET" /** Finland. */ | "FI" /** Fiji. */ | "FJ" /** Falkland Islands. */ | "FK" /** Faroe Islands. */ | "FO" /** France. */ | "FR" /** Gabon. */ | "GA" /** United Kingdom. */ | "GB" /** Grenada. */ | "GD" /** Georgia. */ | "GE" /** French Guiana. */ | "GF" /** Guernsey. */ | "GG" /** Ghana. */ | "GH" /** Gibraltar. */ | "GI" /** Greenland. */ | "GL" /** Gambia. */ | "GM" /** Guinea. */ | "GN" /** Guadeloupe. */ | "GP" /** Equatorial Guinea. */ | "GQ" /** Greece. */ | "GR" /** South Georgia & South Sandwich Islands. */ | "GS" /** Guatemala. */ | "GT" /** Guinea-Bissau. */ | "GW" /** Guyana. */ | "GY" /** Hong Kong SAR. */ | "HK" /** Heard & McDonald Islands. */ | "HM" /** Honduras. */ | "HN" /** Croatia. */ | "HR" /** Haiti. */ | "HT" /** Hungary. */ | "HU" /** Indonesia. */ | "ID" /** Ireland. */ | "IE" /** Israel. */ | "IL" /** Isle of Man. */ | "IM" /** India. */ | "IN" /** British Indian Ocean Territory. */ | "IO" /** Iraq. */ | "IQ" /** Iran. */ | "IR" /** Iceland. */ | "IS" /** Italy. */ | "IT" /** Jersey. */ | "JE" /** Jamaica. */ | "JM" /** Jordan. */ | "JO" /** Japan. */ | "JP" /** Kenya. */ | "KE" /** Kyrgyzstan. */ | "KG" /** Cambodia. */ | "KH" /** Kiribati. */ | "KI" /** Comoros. */ | "KM" /** St. Kitts & Nevis. */ | "KN" /** North Korea. */ | "KP" /** South Korea. */ | "KR" /** Kuwait. */ | "KW" /** Cayman Islands. */ | "KY" /** Kazakhstan. */ | "KZ" /** Laos. */ | "LA" /** Lebanon. */ | "LB" /** St. Lucia. */ | "LC" /** Liechtenstein. */ | "LI" /** Sri Lanka. */ | "LK" /** Liberia. */ | "LR" /** Lesotho. */ | "LS" /** Lithuania. */ | "LT" /** Luxembourg. */ | "LU" /** Latvia. */ | "LV" /** Libya. */ | "LY" /** Morocco. */ | "MA" /** Monaco. */ | "MC" /** Moldova. */ | "MD" /** Montenegro. */ | "ME" /** St. Martin. */ | "MF" /** Madagascar. */ | "MG" /** North Macedonia. */ | "MK" /** Mali. */ | "ML" /** Myanmar (Burma). */ | "MM" /** Mongolia. */ | "MN" /** Macao SAR. */ | "MO" /** Martinique. */ | "MQ" /** Mauritania. */ | "MR" /** Montserrat. */ | "MS" /** Malta. */ | "MT" /** Mauritius. */ | "MU" /** Maldives. */ | "MV" /** Malawi. */ | "MW" /** Mexico. */ | "MX" /** Malaysia. */ | "MY" /** Mozambique. */ | "MZ" /** Namibia. */ | "NA" /** New Caledonia. */ | "NC" /** Niger. */ | "NE" /** Norfolk Island. */ | "NF" /** Nigeria. */ | "NG" /** Nicaragua. */ | "NI" /** Netherlands. */ | "NL" /** Norway. */ | "NO" /** Nepal. */ | "NP" /** Nauru. */ | "NR" /** Niue. */ | "NU" /** New Zealand. */ | "NZ" /** Oman. */ | "OM" /** Panama. */ | "PA" /** Peru. */ | "PE" /** French Polynesia. */ | "PF" /** Papua New Guinea. */ | "PG" /** Philippines. */ | "PH" /** Pakistan. */ | "PK" /** Poland. */ | "PL" /** St. Pierre & Miquelon. */ | "PM" /** Pitcairn Islands. */ | "PN" /** Palestinian Territories. */ | "PS" /** Portugal. */ | "PT" /** Paraguay. */ | "PY" /** Qatar. */ | "QA" /** Réunion. */ | "RE" /** Romania. */ | "RO" /** Serbia. */ | "RS" /** Russia. */ | "RU" /** Rwanda. */ | "RW" /** Saudi Arabia. */ | "SA" /** Solomon Islands. */ | "SB" /** Seychelles. */ | "SC" /** Sudan. */ | "SD" /** Sweden. */ | "SE" /** Singapore. */ | "SG" /** St. Helena. */ | "SH" /** Slovenia. */ | "SI" /** Svalbard & Jan Mayen. */ | "SJ" /** Slovakia. */ | "SK" /** Sierra Leone. */ | "SL" /** San Marino. */ | "SM" /** Senegal. */ | "SN" /** Somalia. */ | "SO" /** Suriname. */ | "SR" /** South Sudan. */ | "SS" /** São Tomé & Príncipe. */ | "ST" /** El Salvador. */ | "SV" /** Sint Maarten. */ | "SX" /** Syria. */ | "SY" /** Eswatini. */ | "SZ" /** Tristan da Cunha. */ | "TA" /** Turks & Caicos Islands. */ | "TC" /** Chad. */ | "TD" /** French Southern Territories. */ | "TF" /** Togo. */ | "TG" /** Thailand. */ | "TH" /** Tajikistan. */ | "TJ" /** Tokelau. */ | "TK" /** Timor-Leste. */ | "TL" /** Turkmenistan. */ | "TM" /** Tunisia. */ | "TN" /** Tonga. */ | "TO" /** Türkiye. */ | "TR" /** Trinidad & Tobago. */ | "TT" /** Tuvalu. */ | "TV" /** Taiwan. */ | "TW" /** Tanzania. */ | "TZ" /** Ukraine. */ | "UA" /** Uganda. */ | "UG" /** U.S. Outlying Islands. */ | "UM" /** United States. */ | "US" /** Uruguay. */ | "UY" /** Uzbekistan. */ | "UZ" /** Vatican City. */ | "VA" /** St. Vincent & Grenadines. */ | "VC" /** Venezuela. */ | "VE" /** British Virgin Islands. */ | "VG" /** Vietnam. */ | "VN" /** Vanuatu. */ | "VU" /** Wallis & Futuna. */ | "WF" /** Samoa. */ | "WS" /** Kosovo. */ | "XK" /** Yemen. */ | "YE" /** Mayotte. */ | "YT" /** South Africa. */ | "ZA" /** Zambia. */ | "ZM" /** Zimbabwe. */ | "ZW" /** Unknown Region. */ | "ZZ";
+/**
+ * Supported languages for retrieving translated storefront content. Pass a language code to the [`@inContext`](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/in-context) directive to return product titles, descriptions, and other translatable fields in that language.
+ *
+ * The [`Localization`](https://shopify.dev/docs/api/storefront/current/objects/Localization) object provides the list of available languages for the active country, and each [`Country`](https://shopify.dev/docs/api/storefront/current/objects/Country) in [`availableCountries`](https://shopify.dev/docs/api/storefront/current/objects/Localization#field-Localization.fields.availableCountries) includes its own available languages.
+ *
+ */
+type LanguageCode = /** Afrikaans. */"AF" /** Akan. */ | "AK" /** Amharic. */ | "AM" /** Arabic. */ | "AR" /** Assamese. */ | "AS" /** Azerbaijani. */ | "AZ" /** Belarusian. */ | "BE" /** Bulgarian. */ | "BG" /** Bambara. */ | "BM" /** Bangla. */ | "BN" /** Tibetan. */ | "BO" /** Breton. */ | "BR" /** Bosnian. */ | "BS" /** Catalan. */ | "CA" /** Chechen. */ | "CE" /** Central Kurdish. */ | "CKB" /** Czech. */ | "CS" /** Church Slavic. */ | "CU" /** Welsh. */ | "CY" /** Danish. */ | "DA" /** German. */ | "DE" /** Dzongkha. */ | "DZ" /** Ewe. */ | "EE" /** Greek. */ | "EL" /** English. */ | "EN" /** Esperanto. */ | "EO" /** Spanish. */ | "ES" /** Estonian. */ | "ET" /** Basque. */ | "EU" /** Persian. */ | "FA" /** Fulah. */ | "FF" /** Finnish. */ | "FI" /** Filipino. */ | "FIL" /** Faroese. */ | "FO" /** French. */ | "FR" /** Western Frisian. */ | "FY" /** Irish. */ | "GA" /** Scottish Gaelic. */ | "GD" /** Galician. */ | "GL" /** Gujarati. */ | "GU" /** Manx. */ | "GV" /** Hausa. */ | "HA" /** Hebrew. */ | "HE" /** Hindi. */ | "HI" /** Croatian. */ | "HR" /** Hungarian. */ | "HU" /** Armenian. */ | "HY" /** Interlingua. */ | "IA" /** Indonesian. */ | "ID" /** Igbo. */ | "IG" /** Sichuan Yi. */ | "II" /** Icelandic. */ | "IS" /** Italian. */ | "IT" /** Japanese. */ | "JA" /** Javanese. */ | "JV" /** Georgian. */ | "KA" /** Kikuyu. */ | "KI" /** Kazakh. */ | "KK" /** Kalaallisut. */ | "KL" /** Khmer. */ | "KM" /** Kannada. */ | "KN" /** Korean. */ | "KO" /** Kashmiri. */ | "KS" /** Kurdish. */ | "KU" /** Cornish. */ | "KW" /** Kyrgyz. */ | "KY" /** Latin. */ | "LA" /** Luxembourgish. */ | "LB" /** Ganda. */ | "LG" /** Lingala. */ | "LN" /** Lao. */ | "LO" /** Lithuanian. */ | "LT" /** Luba-Katanga. */ | "LU" /** Latvian. */ | "LV" /** Malagasy. */ | "MG" /** Māori. */ | "MI" /** Macedonian. */ | "MK" /** Malayalam. */ | "ML" /** Mongolian. */ | "MN" /** Moldavian. */ | "MO" /** Marathi. */ | "MR" /** Malay. */ | "MS" /** Maltese. */ | "MT" /** Burmese. */ | "MY" /** Norwegian (Bokmål). */ | "NB" /** North Ndebele. */ | "ND" /** Nepali. */ | "NE" /** Dutch. */ | "NL" /** Norwegian Nynorsk. */ | "NN" /** Norwegian. */ | "NO" /** Oromo. */ | "OM" /** Odia. */ | "OR" /** Ossetic. */ | "OS" /** Punjabi. */ | "PA" /** Polish. */ | "PL" /** Pashto. */ | "PS" /** Portuguese. */ | "PT" /** Portuguese (Brazil). */ | "PT_BR" /** Portuguese (Portugal). */ | "PT_PT" /** Quechua. */ | "QU" /** Romansh. */ | "RM" /** Rundi. */ | "RN" /** Romanian. */ | "RO" /** Russian. */ | "RU" /** Kinyarwanda. */ | "RW" /** Sanskrit. */ | "SA" /** Sardinian. */ | "SC" /** Sindhi. */ | "SD" /** Northern Sami. */ | "SE" /** Sango. */ | "SG" /** Serbo-Croatian. */ | "SH" /** Sinhala. */ | "SI" /** Slovak. */ | "SK" /** Slovenian. */ | "SL" /** Shona. */ | "SN" /** Somali. */ | "SO" /** Albanian. */ | "SQ" /** Serbian. */ | "SR" /** Sundanese. */ | "SU" /** Swedish. */ | "SV" /** Swahili. */ | "SW" /** Tamil. */ | "TA" /** Telugu. */ | "TE" /** Tajik. */ | "TG" /** Thai. */ | "TH" /** Tigrinya. */ | "TI" /** Turkmen. */ | "TK" /** Tongan. */ | "TO" /** Turkish. */ | "TR" /** Tatar. */ | "TT" /** Uyghur. */ | "UG" /** Ukrainian. */ | "UK" /** Urdu. */ | "UR" /** Uzbek. */ | "UZ" /** Vietnamese. */ | "VI" /** Volapük. */ | "VO" /** Wolof. */ | "WO" /** Xhosa. */ | "XH" /** Yiddish. */ | "YI" /** Yoruba. */ | "YO" /** Chinese. */ | "ZH" /** Chinese (Simplified). */ | "ZH_CN" /** Chinese (Traditional). */ | "ZH_TW" /** Zulu. */ | "ZU";
+/** Decides the distribution of results. */
+type PredictiveSearchLimitScope = /** Return results up to limit across all types. */"ALL" /** Return results up to limit per type. */ | "EACH";
+/** The types of search items to perform predictive search on. */
+type PredictiveSearchType = /** Returns matching articles. */"ARTICLE" /** Returns matching collections. */ | "COLLECTION" /** Returns matching pages. */ | "PAGE" /** Returns matching products. */ | "PRODUCT" /** Returns matching query strings. */ | "QUERY";
+/**
+ * Sort options for products within a [`Collection`](https://shopify.dev/docs/api/storefront/current/objects/Collection). Used by the [`products`](https://shopify.dev/docs/api/storefront/current/objects/Collection#field-Collection.fields.products) connection to order results by best-selling, price, title, creation date, or the collection's default and manual ordering.
+ *
+ * > Note: The [`RELEVANCE`](https://shopify.dev/docs/api/storefront/current/enums/ProductCollectionSortKeys#enums-RELEVANCE) key applies only when you specify a search query.
+ *
+ */
+type ProductCollectionSortKeys = /** Sort by the `best-selling` value. */"BEST_SELLING" /** Sort by the `collection-default` value. */ | "COLLECTION_DEFAULT" /** Sort by the `created` value. */ | "CREATED" /** Sort by the `id` value. */ | "ID" /** Sort by the `manual` value. */ | "MANUAL" /** Sort by the `price` value. */ | "PRICE"
+/**
+ * Sort by relevance to the search terms when the `query` parameter is specified on the connection.
+ * Don't use this sort key when no search query is specified.
+ *
+ */
+| "RELEVANCE" /** Sort by the `title` value. */ | "TITLE";
+/** Specifies whether to display results for unavailable products. */
+type SearchUnavailableProductsType = /** Exclude unavailable products. */"HIDE" /** Show unavailable products after all other matching results. This is the default. */ | "LAST" /** Show unavailable products in the order that they're found. */ | "SHOW";
+/** Specifies the list of resource fields to search. */
+type SearchableField = /** Author of the page or article. */"AUTHOR" /** Body of the page or article or product description or collection description. */ | "BODY" /** Product type. */ | "PRODUCT_TYPE" /** Tag associated with the product or article. */ | "TAG" /** Title of the page or article or product title or collection title. */ | "TITLE" /** Variant barcode. */ | "VARIANTS_BARCODE" /** Variant SKU. */ | "VARIANTS_SKU" /** Variant title. */ | "VARIANTS_TITLE" /** Product vendor. */ | "VENDOR";
+//#endregion
+export { CartErrorCode, CartWarningCode, CountryCode, LanguageCode, PredictiveSearchLimitScope, PredictiveSearchType, ProductCollectionSortKeys, SearchUnavailableProductsType, SearchableField };
+//# sourceMappingURL=storefront-api-types.d.mts.map

package/dist/graphql/graphql.d.mts

@@ -0,0 +1,40 @@
+import { introspection } from "./generated/graphql-env.mjs";
+import { StorefrontScalars } from "./scalars.mjs";
+import { InferResult, InferVariables } from "./type-resolver.mjs";
+import { DocumentDecoration, initGraphQLTada } from "gql.tada";
+
+//#region src/graphql/graphql.d.ts
+type StorefrontTadaGql = initGraphQLTada<{
+  introspection: introspection;
+  scalars: StorefrontScalars;
+}>;
+type StorefrontQueryMetadata<Source extends string = string> = {
+  readonly __hydrogenQueryBrand: true;
+  readonly __hydrogenQuerySource?: Source;
+};
+/**
+ * A branded string that carries phantom Result and Variables types.
+ *
+ * Honest about being a `string` at runtime (unlike `TadaDocumentNode`
+ * which claims to be an AST). Implements `DocumentDecoration` so
+ * `ResultOf<>` and `VariablesOf<>` work on it.
+ */
+type StorefrontQueryString<Result = any, Variables = any, Source extends string = string> = string & DocumentDecoration<Result, Variables> & {
+  readonly __hydrogenQueryBrand: true;
+  readonly __hydrogenQuerySource?: Source;
+};
+type AnyStorefrontQueryString = string & StorefrontQueryMetadata;
+type SourceOf<Doc> = Doc extends {
+  readonly __hydrogenQuerySource?: infer Source extends string;
+} ? Source : never;
+type FragmentSources<Fragments extends readonly AnyStorefrontQueryString[]> = Fragments extends readonly [] ? "" : Fragments extends readonly [infer Only extends AnyStorefrontQueryString] ? SourceOf<Only> : Fragments extends readonly [infer First extends AnyStorefrontQueryString, ...infer Rest extends readonly AnyStorefrontQueryString[]] ? `${SourceOf<First>}\n${FragmentSources<Rest>}` : string;
+type ComposedSource<Source extends string, Fragments extends readonly AnyStorefrontQueryString[]> = FragmentSources<Fragments> extends "" ? Source : `${Source}\n${FragmentSources<Fragments>}`;
+type StorefrontGql = {
+  <const Document extends AnyStorefrontQueryString, const Fragments extends readonly AnyStorefrontQueryString[], const DocumentSource extends string = ComposedSource<SourceOf<Document>, Fragments>>(document: Document, fragments: Fragments): StorefrontQueryString<InferResult<DocumentSource>, InferVariables<DocumentSource>, DocumentSource>;
+  <const Source extends string>(source: Source): StorefrontQueryString<InferResult<Source>, InferVariables<Source>, Source>;
+  <const Source extends string, const Fragments extends readonly AnyStorefrontQueryString[], const DocumentSource extends string = ComposedSource<Source, Fragments>>(source: Source, fragments: Fragments): StorefrontQueryString<InferResult<DocumentSource>, InferVariables<DocumentSource>, DocumentSource>;
+} & StorefrontTadaGql;
+declare const gql: StorefrontGql;
+//#endregion
+export { AnyStorefrontQueryString, ComposedSource, SourceOf, StorefrontQueryString, gql };
+//# sourceMappingURL=graphql.d.mts.map

package/dist/graphql/graphql.mjs

@@ -0,0 +1,16 @@
+//#region src/graphql/graphql.ts
+const gql = ((source, fragments) => {
+	let query = source;
+	if (fragments) {
+		const seen = /* @__PURE__ */ new Set();
+		for (const fragment of fragments) if (!seen.has(fragment)) {
+			seen.add(fragment);
+			query += "\n" + fragment;
+		}
+	}
+	return query;
+});
+
+//#endregion
+export { gql };
+//# sourceMappingURL=graphql.mjs.map

package/dist/graphql/graphql.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.mjs","names":[],"sources":["../../src/graphql/graphql.ts"],"sourcesContent":["import type { DocumentDecoration, initGraphQLTada as InitGraphQLTada } from \"gql.tada\";\n\nimport type { introspection } from \"./generated/graphql-env\";\nimport type { StorefrontScalars } from \"./scalars\";\nimport type { InferResult, InferVariables } from \"./type-resolver\";\n\ntype StorefrontTadaGql = InitGraphQLTada<{\n  introspection: introspection;\n  scalars: StorefrontScalars;\n}>;\n\ntype StorefrontQueryMetadata<Source extends string = string> = {\n  readonly __hydrogenQueryBrand: true;\n  readonly __hydrogenQuerySource?: Source;\n};\n\n/**\n * A branded string that carries phantom Result and Variables types.\n *\n * Honest about being a `string` at runtime (unlike `TadaDocumentNode`\n * which claims to be an AST). Implements `DocumentDecoration` so\n * `ResultOf<>` and `VariablesOf<>` work on it.\n */\nexport type StorefrontQueryString<\n  Result = any,\n  Variables = any,\n  Source extends string = string,\n> = string &\n  DocumentDecoration<Result, Variables> & {\n    readonly __hydrogenQueryBrand: true;\n    readonly __hydrogenQuerySource?: Source;\n  };\n\nexport type AnyStorefrontQueryString = string & StorefrontQueryMetadata;\n\nexport type SourceOf<Doc> = Doc extends {\n  readonly __hydrogenQuerySource?: infer Source extends string;\n}\n  ? Source\n  : never;\n\nexport type FragmentSources<Fragments extends readonly AnyStorefrontQueryString[]> =\n  Fragments extends readonly []\n    ? \"\"\n    : Fragments extends readonly [infer Only extends AnyStorefrontQueryString]\n      ? SourceOf<Only>\n      : Fragments extends readonly [\n            infer First extends AnyStorefrontQueryString,\n            ...infer Rest extends readonly AnyStorefrontQueryString[],\n          ]\n        ? `${SourceOf<First>}\\n${FragmentSources<Rest>}`\n        : string;\n\nexport type ComposedSource<\n  Source extends string,\n  Fragments extends readonly AnyStorefrontQueryString[],\n> = FragmentSources<Fragments> extends \"\" ? Source : `${Source}\\n${FragmentSources<Fragments>}`;\n\ntype StorefrontGql = {\n  // Composes an already-declared document with additional fragments. Declared\n  // before the raw-source overloads so branded documents recover their literal\n  // source through SourceOf instead of binding Source to the branded type,\n  // which would degrade ComposedSource and kill inference.\n  <\n    const Document extends AnyStorefrontQueryString,\n    const Fragments extends readonly AnyStorefrontQueryString[],\n    const DocumentSource extends string = ComposedSource<SourceOf<Document>, Fragments>,\n  >(\n    document: Document,\n    fragments: Fragments,\n  ): StorefrontQueryString<\n    InferResult<DocumentSource>,\n    InferVariables<DocumentSource>,\n    DocumentSource\n  >;\n  <const Source extends string>(\n    source: Source,\n  ): StorefrontQueryString<InferResult<Source>, InferVariables<Source>, Source>;\n  <\n    const Source extends string,\n    const Fragments extends readonly AnyStorefrontQueryString[],\n    const DocumentSource extends string = ComposedSource<Source, Fragments>,\n  >(\n    source: Source,\n    fragments: Fragments,\n  ): StorefrontQueryString<\n    InferResult<DocumentSource>,\n    InferVariables<DocumentSource>,\n    DocumentSource\n  >;\n} & StorefrontTadaGql;\n\n// oxlint-disable-next-line typescript-eslint/consistent-type-assertions -- gql.tada adds phantom helper properties to the function type that are not used at runtime.\nexport const gql = ((source: string, fragments?: Array<string>) => {\n  let query = source;\n\n  if (fragments) {\n    const seen = new Set<string>();\n    for (const fragment of fragments) {\n      if (!seen.has(fragment)) {\n        seen.add(fragment);\n        query += \"\\n\" + fragment;\n      }\n    }\n  }\n\n  return query;\n}) as unknown as StorefrontGql;\n"],"mappings":";AA6FA,MAAa,QAAQ,QAAgB,cAA8B;CACjE,IAAI,QAAQ;AAEZ,KAAI,WAAW;EACb,MAAM,uBAAO,IAAI,KAAa;AAC9B,OAAK,MAAM,YAAY,UACrB,KAAI,CAAC,KAAK,IAAI,SAAS,EAAE;AACvB,QAAK,IAAI,SAAS;AAClB,YAAS,OAAO;;;AAKtB,QAAO"}

package/dist/graphql/index.d.mts

@@ -0,0 +1,2 @@
+import { InferResult, InferVariables } from "./type-resolver.mjs";
+import { AnyStorefrontQueryString, ComposedSource, SourceOf, StorefrontQueryString, gql } from "./graphql.mjs";

package/dist/graphql/scalars.d.mts

@@ -0,0 +1,26 @@
+//#region src/graphql/scalars.d.ts
+declare const STOREFRONT_API_SCALARS: {
+  readonly Color: "string";
+  readonly DateTime: "string";
+  readonly Decimal: "string";
+  readonly HTML: "string";
+  readonly JSON: "string";
+  readonly URL: "string";
+  readonly UnsignedInt64: "string";
+};
+declare const CUSTOMER_ACCOUNT_API_SCALARS: {
+  readonly BigInt: "string";
+  readonly DateTime: "string";
+  readonly Decimal: "string";
+  readonly HTML: "string";
+  readonly ISO8601DateTime: "string";
+  readonly JSON: "string";
+  readonly URL: "string";
+  readonly UnsignedInt64: "string";
+};
+type StringScalarTypes<Scalars extends Record<string, string>> = { [Scalar in keyof Scalars]: string };
+type StorefrontScalars = StringScalarTypes<typeof STOREFRONT_API_SCALARS>;
+type CustomerAccountScalars = StringScalarTypes<typeof CUSTOMER_ACCOUNT_API_SCALARS>;
+//#endregion
+export { CustomerAccountScalars, StorefrontScalars };
+//# sourceMappingURL=scalars.d.mts.map

package/dist/graphql/type-resolver.d.mts

@@ -0,0 +1,229 @@
+import { introspection } from "./generated/graphql-env.mjs";
+import { StorefrontScalars } from "./scalars.mjs";
+import { parseDocument } from "gql.tada";
+
+//#region src/graphql/type-resolver.d.ts
+type DefaultScalars = {
+  readonly ID: string;
+  readonly Boolean: boolean;
+  readonly String: string;
+  readonly Float: number;
+  readonly Int: number;
+};
+type ScalarMap<CustomScalars extends Record<string, unknown>> = { [P in keyof CustomScalars | keyof DefaultScalars]: {
+  name: P;
+  type: P extends keyof CustomScalars ? CustomScalars[P] : P extends keyof DefaultScalars ? DefaultScalars[P] : never;
+} };
+type GraphQLSchemaFor<SchemaIntrospection extends {
+  name: any;
+  query: string;
+  mutation?: any;
+  subscription?: any;
+  types: {
+    [name: string]: any;
+  };
+}, CustomScalars extends Record<string, unknown>> = {
+  name: SchemaIntrospection["name"];
+  query: SchemaIntrospection["query"];
+  mutation: SchemaIntrospection["mutation"];
+  subscription: SchemaIntrospection["subscription"];
+  types: ScalarMap<CustomScalars> & SchemaIntrospection["types"];
+};
+type StorefrontSchema = GraphQLSchemaFor<introspection, StorefrontScalars>;
+type Obj<T> = T extends {
+  [key: string | number]: any;
+} ? { [K in keyof T]: T[K] } : never;
+type ObjectLikeType = {
+  kind: "OBJECT" | "INTERFACE" | "UNION";
+  name: string;
+  fields: {
+    [key: string]: any;
+  };
+};
+type SchemaLike = {
+  name?: any;
+  query: string;
+  mutation?: any;
+  subscription?: any;
+  types: {
+    [name: string]: any;
+  };
+};
+type FieldAlias<Node> = Node extends {
+  alias: undefined;
+  name: any;
+} ? Node["name"]["value"] : Node extends {
+  alias: any;
+} ? Node["alias"]["value"] : never;
+type IsConditional<Node> = Node extends {
+  directives: any[];
+} ? Node["directives"][number]["name"]["value"] & ("include" | "skip" | "defer") extends never ? false : true : false;
+type TypeDirective<Node> = Node extends {
+  directives: any[];
+} ? Node["directives"][number]["name"]["value"] & ("required" | "_required") extends never ? Node["directives"][number]["name"]["value"] & ("optional" | "_optional") extends never ? void : true : false : void;
+type UnwrapOutputType<Type, SelectionSet, Schema extends SchemaLike, Fragments extends {
+  [name: string]: any;
+}, IsOptional> = Type extends {
+  readonly kind: "NON_NULL";
+  readonly ofType: any;
+} ? UnwrapOutputType<Type["ofType"], SelectionSet, Schema, Fragments, IsOptional extends void ? false : IsOptional> : Type extends {
+  readonly kind: "LIST";
+  readonly ofType: any;
+} ? IsOptional extends false ? Array<UnwrapOutputType<Type["ofType"], SelectionSet, Schema, Fragments, void>> : null | Array<UnwrapOutputType<Type["ofType"], SelectionSet, Schema, Fragments, void>> : Type extends {
+  readonly name: string;
+} ? Schema["types"][Type["name"]] extends ObjectLikeType ? SelectionSet extends {
+  kind: "SelectionSet";
+  selections: any;
+} ? IsOptional extends false ? ResolveSelection<SelectionSet["selections"], Schema["types"][Type["name"]], Schema, Fragments> : null | ResolveSelection<SelectionSet["selections"], Schema["types"][Type["name"]], Schema, Fragments> : unknown : Schema["types"][Type["name"]] extends {
+  type: any;
+} ? IsOptional extends false ? Schema["types"][Type["name"]]["type"] : Schema["types"][Type["name"]]["type"] | null : IsOptional extends false ? Schema["types"][Type["name"]]["enumValues"] : Schema["types"][Type["name"]]["enumValues"] | null : unknown;
+type TypenameOf<Type> = (Type extends {
+  name: any;
+} ? Type["name"] : never) | (Type extends {
+  possibleTypes: any;
+} ? Type["possibleTypes"] : never);
+type SpreadSubtype<Node, BaseType extends ObjectLikeType, Schema extends SchemaLike, Fragments extends {
+  [name: string]: any;
+}> = Node extends {
+  kind: "InlineFragment";
+  typeCondition?: any;
+} ? Node["typeCondition"] extends {
+  kind: "NamedType";
+  name: any;
+} ? Schema["types"][Node["typeCondition"]["name"]["value"]] : BaseType : Node extends {
+  kind: "FragmentSpread";
+  name: any;
+} ? Node["name"]["value"] extends keyof Fragments ? Schema["types"][Fragments[Node["name"]["value"]]["typeCondition"]["name"]["value"]] : void : void;
+type FragmentSelection<Node, PossibleType extends string, Type extends ObjectLikeType, Schema extends SchemaLike, Fragments extends {
+  [name: string]: any;
+}> = Node extends {
+  kind: "InlineFragment";
+  selectionSet: any;
+} ? SelectionWalker<Node["selectionSet"]["selections"], PossibleType, Type, Schema, Fragments> : Node extends {
+  kind: "FragmentSpread";
+  name: any;
+} ? Node["name"]["value"] extends keyof Fragments ? SelectionWalker<Fragments[Node["name"]["value"]]["selectionSet"]["selections"], PossibleType, Type, Schema, Fragments> : never : never;
+interface SelectionAcc<Fields extends {} = {}, Rest = unknown> {
+  fields: Fields;
+  rest: Rest;
+}
+type SelectionWalker<Selections, PossibleType extends string, Type extends ObjectLikeType, Schema extends SchemaLike, Fragments extends {
+  [name: string]: any;
+}, Acc extends SelectionAcc = SelectionAcc> = Selections extends [infer Node, ...infer Rest] ? SelectionWalker<Rest, PossibleType, Type, Schema, Fragments, Node extends {
+  kind: "FragmentSpread" | "InlineFragment";
+} ? SpreadSubtype<Node, Type, Schema, Fragments> extends infer Sub extends ObjectLikeType ? PossibleType extends TypenameOf<Sub> ? IsConditional<Node> extends true ? SelectionAcc<Acc["fields"], Acc["rest"] & ({} | FragmentSelection<Node, PossibleType, Sub, Schema, Fragments>)> : SelectionAcc<Acc["fields"] & FragmentSelection<Node, PossibleType, Sub, Schema, Fragments>, Acc["rest"]> : Acc : Acc : Node extends {
+  kind: "Field";
+  name: any;
+  selectionSet: any;
+} ? IsConditional<Node> extends true ? SelectionAcc<Acc["fields"] & { [P in FieldAlias<Node>]?: Node["name"]["value"] extends "__typename" ? PossibleType : UnwrapOutputType<Type["fields"][Node["name"]["value"]]["type"], Node["selectionSet"], Schema, Fragments, TypeDirective<Node>> }, Acc["rest"]> : SelectionAcc<Acc["fields"] & { [P in FieldAlias<Node>]: Node["name"]["value"] extends "__typename" ? PossibleType : UnwrapOutputType<Type["fields"][Node["name"]["value"]]["type"], Node["selectionSet"], Schema, Fragments, TypeDirective<Node>> }, Acc["rest"]> : Acc> : Acc["rest"] extends infer T ? Obj<Acc["fields"] & T> : never;
+type ResolveSelection<Selections, Type extends ObjectLikeType, Schema extends SchemaLike, Fragments extends {
+  [name: string]: any;
+}> = Type extends {
+  kind: "UNION" | "INTERFACE";
+  possibleTypes: any;
+} ? { [PT in Type["possibleTypes"]]: SelectionWalker<Selections, PT, Type, Schema, Fragments, SelectionAcc<{
+  __typename?: PT;
+}>> }[Type["possibleTypes"]] : Type extends {
+  kind: "OBJECT";
+  name: any;
+} ? SelectionWalker<Selections, Type["name"], Type, Schema, Fragments> : {};
+type FragmentMap<Defs, Map = {}> = Defs extends readonly [infer Def, ...infer Rest] ? FragmentMap<Rest, Def extends {
+  kind: "FragmentDefinition";
+  name: any;
+} ? { [N in Def["name"]["value"]]: Def } & Map : Map> : Map;
+type FirstOperation<Defs> = Defs extends readonly [infer Def, ...infer Rest] ? Def extends {
+  kind: "OperationDefinition";
+} ? Def : FirstOperation<Rest> : never;
+type SingleOperation<Defs, Operation = never> = Defs extends readonly [infer Def, ...infer Rest] ? Def extends {
+  kind: "OperationDefinition";
+} ? [Operation] extends [never] ? SingleOperation<Rest, Def> : never : SingleOperation<Rest, Operation> : Operation;
+type FirstFragment<Defs> = Defs extends readonly [infer Def, ...infer Rest] ? Def extends {
+  kind: "FragmentDefinition";
+} ? Def : FirstFragment<Rest> : never;
+type OperationType<Def, Schema extends SchemaLike, Fragments extends {
+  [name: string]: any;
+}> = Def extends {
+  kind: "OperationDefinition";
+  selectionSet: any;
+  operation: any;
+} ? Schema["types"][Schema[Def["operation"]]] extends infer T extends ObjectLikeType ? ResolveSelection<Def["selectionSet"]["selections"], T, Schema, Fragments> : {} : never;
+type FragmentType<Def, Schema extends SchemaLike, Fragments extends {
+  [name: string]: any;
+}> = Def extends {
+  kind: "FragmentDefinition";
+  selectionSet: any;
+  typeCondition: any;
+} ? Schema["types"][Def["typeCondition"]["name"]["value"]] extends infer T extends ObjectLikeType ? ResolveSelection<Def["selectionSet"]["selections"], T, Schema, Fragments> : never : never;
+type DocumentType<Doc, Schema extends SchemaLike> = Doc extends {
+  kind: "Document";
+  definitions: infer Defs extends readonly unknown[];
+} ? FirstOperation<Defs> extends infer Operation ? [Operation] extends [never] ? FragmentType<FirstFragment<Defs>, Schema, FragmentMap<Defs>> : OperationType<Operation, Schema, FragmentMap<Defs>> : never : never;
+type ResolveInputScalar<TypeName, Schema extends SchemaLike> = TypeName extends keyof Schema["types"] ? Schema["types"][TypeName] extends {
+  kind: "INPUT_OBJECT";
+  inputFields: any;
+  isOneOf?: any;
+} ? Schema["types"][TypeName]["isOneOf"] extends true ? InputObjectOneOf<Schema["types"][TypeName]["inputFields"], Schema> : InputObject<Schema["types"][TypeName]["inputFields"], Schema> : Schema["types"][TypeName] extends {
+  type: any;
+} ? Schema["types"][TypeName]["type"] : Schema["types"][TypeName]["enumValues"] : never;
+type InputObject<Fields, Schema extends SchemaLike, Acc = {}> = Fields extends [infer F, ...infer Rest] ? InputObject<Rest, Schema, (F extends {
+  name: any;
+  type: any;
+} ? F extends {
+  defaultValue?: undefined | null;
+  type: {
+    kind: "NON_NULL";
+  };
+} ? { [N in F["name"]]: UnwrapInputRef<F["type"], Schema, true> } : { [N in F["name"]]?: UnwrapInputRef<F["type"], Schema, true> | null } : {}) & Acc> : Obj<Acc>;
+type InputObjectOneOf<Fields, Schema extends SchemaLike, Acc = never> = Fields extends [infer F, ...infer Rest] ? InputObjectOneOf<Rest, Schema, (F extends {
+  name: any;
+  type: any;
+} ? { [N in F["name"]]: UnwrapInputRef<F["type"], Schema, false> } : never) | Acc> : Acc;
+type UnwrapInputRef<Type, Schema extends SchemaLike, IsOptional> = Type extends {
+  kind: "NON_NULL";
+  ofType: any;
+} ? UnwrapInputRef<Type["ofType"], Schema, false> : Type extends {
+  kind: "LIST";
+  ofType: any;
+} ? IsOptional extends false ? Array<UnwrapInputRef<Type["ofType"], Schema, true>> : null | Array<UnwrapInputRef<Type["ofType"], Schema, true>> : Type extends {
+  name: any;
+} ? IsOptional extends false ? ResolveInputScalar<Type["name"], Schema> : null | ResolveInputScalar<Type["name"], Schema> : unknown;
+type UnwrapVarTypeRef<Type, Schema extends SchemaLike, IsOptional> = Type extends {
+  kind: "NonNullType";
+  type: any;
+} ? UnwrapVarTypeRef<Type["type"], Schema, false> : Type extends {
+  kind: "ListType";
+  type: any;
+} ? IsOptional extends false ? Array<UnwrapVarTypeRef<Type["type"], Schema, true>> : null | Array<UnwrapVarTypeRef<Type["type"], Schema, true>> : Type extends {
+  kind: "NamedType";
+  name: any;
+} ? IsOptional extends false ? ResolveInputScalar<Type["name"]["value"], Schema> : null | ResolveInputScalar<Type["name"]["value"], Schema> : unknown;
+type VariablesWalker<Vars, Schema extends SchemaLike, Acc = {}> = Vars extends [infer V, ...infer Rest] ? VariablesWalker<Rest, Schema, (V extends {
+  kind: "VariableDefinition";
+  variable: any;
+  type: any;
+} ? V extends {
+  defaultValue: undefined;
+  type: {
+    kind: "NonNullType";
+  };
+} ? { [N in V["variable"]["name"]["value"]]: UnwrapVarTypeRef<V["type"], Schema, true> } : { [N in V["variable"]["name"]["value"]]?: UnwrapVarTypeRef<V["type"], Schema, true> } : {}) & Acc> : Obj<Acc>;
+type VariablesType<Doc, Schema extends SchemaLike> = Doc extends {
+  kind: "Document";
+  definitions: infer Defs extends readonly unknown[];
+} ? FirstOperation<Defs> extends {
+  variableDefinitions: any;
+} ? VariablesWalker<FirstOperation<Defs>["variableDefinitions"], Schema> : {} : {};
+type OperationKindType<Doc> = Doc extends {
+  kind: "Document";
+  definitions: infer Defs extends readonly unknown[];
+} ? [SingleOperation<Defs>] extends [never] ? "unknown" : SingleOperation<Defs> extends {
+  operation: infer Operation extends string;
+} ? Operation : "unknown" : "unknown";
+type InferResultForSchema<T extends string, Schema extends SchemaLike> = parseDocument<T> extends infer Doc ? Doc extends never ? never : DocumentType<Doc, Schema> : never;
+type InferVariablesForSchema<T extends string, Schema extends SchemaLike> = parseDocument<T> extends infer Doc ? Doc extends never ? never : VariablesType<Doc, Schema> : never;
+type InferResult<T extends string> = InferResultForSchema<T, StorefrontSchema>;
+type InferVariables<T extends string> = InferVariablesForSchema<T, StorefrontSchema>;
+type InferOperationKind<T extends string> = parseDocument<T> extends infer Doc ? [Doc] extends [never] ? "unknown" : OperationKindType<Doc> : "unknown";
+//#endregion
+export { GraphQLSchemaFor, InferOperationKind, InferResult, InferResultForSchema, InferVariables, InferVariablesForSchema };
+//# sourceMappingURL=type-resolver.d.mts.map

package/dist/react/cart.d.mts

@@ -0,0 +1,44 @@
+import { CartData, CartState } from "../core/cart/state.mjs";
+import { CartStore, CreateCartStoreOptions } from "../core/cart/cart.mjs";
+import { CartFormRegister } from "../core/cart/form.mjs";
+import { CartDataFromHandlers } from "../core/cart/server-handlers.mjs";
+import { FormHTMLAttributes, ReactNode, SubmitEvent } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/react/cart.d.ts
+type TypedCartProviderProps<TData extends CartData> = {
+  initialData?: CartInitialData<TData>;
+  children?: ReactNode;
+};
+type CartInitialData<TData extends CartData = CartData> = CreateCartStoreOptions<TData>["initialData"];
+/** Actions for reconciling cart state after updates outside Standard Actions. */
+type CartActions = Pick<CartStore, "refresh">;
+type TypedCartComponents<TData extends CartData> = {
+  CartProvider: (props: TypedCartProviderProps<TData>) => ReactNode;
+  useCart: <S>(selector: (state: CartState<TData>) => S, isEqual?: (a: S, b: S) => boolean) => S;
+  useSuspenseCart: <S>(selector: (state: CartState<TData>) => S, isEqual?: (a: S, b: S) => boolean) => S;
+  useOptionalCart: <S>(selector: (state: CartState<TData>) => S, isEqual?: (a: S, b: S) => boolean) => S | undefined;
+  useCartActions: typeof useCartActions;
+  useCartForm: typeof useCartForm;
+};
+declare function createCartComponents<THandlers>(): TypedCartComponents<CartDataFromHandlers<THandlers>>;
+declare function CartProvider({
+  initialData,
+  children
+}: {
+  initialData?: CartInitialData;
+  children?: ReactNode;
+}): _$react_jsx_runtime0.JSX.Element;
+declare function useCart<TData extends CartData = CartData, S = unknown>(selector: (state: CartState<TData>) => S, isEqual?: (a: S, b: S) => boolean): S;
+declare function useCartActions(): CartActions;
+declare function useCartAnalytics(): void;
+declare function useCartForm(): {
+  formProps: (opts?: {
+    beforeSubmit?: (e: SubmitEvent<HTMLFormElement>) => void;
+    afterSubmit?: (e: SubmitEvent<HTMLFormElement>) => void;
+  }) => FormHTMLAttributes<HTMLFormElement>;
+  register: CartFormRegister;
+};
+//#endregion
+export { CartActions, CartProvider, createCartComponents, useCart, useCartActions, useCartAnalytics, useCartForm };
+//# sourceMappingURL=cart.d.mts.map

package/dist/react/cart.mjs

@@ -0,0 +1,155 @@
+"use client";
+
+import { trackCartAnalytics } from "../core/analytics/cart-tracker.mjs";
+import { createCartFormRegister } from "../core/cart/form.mjs";
+import { configureCartEndpoint, createCartStore } from "../core/cart/cart.mjs";
+import { attachQuantityInput } from "../core/cart/attach-quantity-input.mjs";
+import { createContext, useContext, useEffect, useMemo, useRef, useSyncExternalStore } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/react/cart.tsx
+let cartEndpoint = "/api/cart";
+const CartContext = createContext(null);
+function getCartEndpoint() {
+	return cartEndpoint;
+}
+function createCartComponents() {
+	function TypedCartProvider({ initialData, children }) {
+		return /* @__PURE__ */ jsx(CartProvider, {
+			initialData,
+			children
+		});
+	}
+	function useTypedCart(selector, isEqual) {
+		return useCart((state) => selector(state), isEqual);
+	}
+	function useTypedOptionalCart(selector, isEqual) {
+		return useOptionalCart((state) => selector(state), isEqual);
+	}
+	function useSuspenseCart(selector, isEqual) {
+		const readyPromise = useCart((state) => state.readyPromise);
+		if (readyPromise) throw readyPromise;
+		return useCart(selector, isEqual);
+	}
+	return {
+		CartProvider: TypedCartProvider,
+		useCart: useTypedCart,
+		useSuspenseCart,
+		useOptionalCart: useTypedOptionalCart,
+		useCartActions,
+		useCartForm
+	};
+}
+function useCartStore(hookName = "useCart") {
+	const store = useContext(CartContext);
+	if (!store) throw new Error(`${hookName} must be used inside <CartProvider>.`);
+	return store;
+}
+function useOptionalCartStore() {
+	return useContext(CartContext);
+}
+function CartProvider({ initialData, children }) {
+	const store = useMemo(() => createCartStore({ initialData }), []);
+	useEffect(() => {
+		configureCartEndpoint(cartEndpoint);
+		store.connect();
+		return () => {
+			store.destroy();
+		};
+	}, [store]);
+	return /* @__PURE__ */ jsx(CartContext.Provider, {
+		value: store,
+		children
+	});
+}
+function useCart(selector, isEqual) {
+	return useCartSelector(useCartStore(), selector, isEqual);
+}
+function useCartActions() {
+	const store = useCartStore("useCartActions");
+	return useMemo(() => ({ refresh: store.refresh }), [store]);
+}
+function useCartAnalytics() {
+	const store = useCartStore();
+	useEffect(() => trackCartAnalytics(store), [store]);
+}
+/**
+* Like `useCart`, but returns `undefined` when rendered outside a `<CartProvider>`.
+* @internal
+*/
+function useOptionalCart(selector, isEqual) {
+	const store = useOptionalCartStore();
+	if (!store) return void 0;
+	return useCartSelector(store, selector, isEqual);
+}
+function useCartSelector(store, selector, isEqual) {
+	const cachedRef = useRef(null);
+	const getSnapshot = () => {
+		const state = store.getState();
+		if (cachedRef.current && cachedRef.current.state === state && cachedRef.current.selector === selector) return cachedRef.current.value;
+		const next = selector(state);
+		if (cachedRef.current && isEqual?.(cachedRef.current.value, next)) {
+			cachedRef.current = {
+				state,
+				selector,
+				value: cachedRef.current.value
+			};
+			return cachedRef.current.value;
+		}
+		cachedRef.current = {
+			state,
+			selector,
+			value: next
+		};
+		return next;
+	};
+	return useSyncExternalStore(store.subscribe, getSnapshot, getSnapshot);
+}
+function useCartForm() {
+	const store = useCartStore();
+	const coreRegister = useMemo(() => createCartFormRegister(), []);
+	const register = useMemo(() => {
+		const wrapped = ((...args) => {
+			const result = coreRegister(...args);
+			const [field, opts] = args;
+			if (field === "quantity" && opts?.interactive) {
+				let cleanup = null;
+				const ref = (el) => {
+					cleanup?.();
+					cleanup = null;
+					if (el) {
+						const form = el.closest("form");
+						if (form) cleanup = attachQuantityInput(el, form);
+					}
+				};
+				const { value: _, ...rest } = result;
+				return {
+					...rest,
+					defaultValue: result.value,
+					ref
+				};
+			}
+			return result;
+		});
+		return wrapped;
+	}, [coreRegister]);
+	const formProps = (opts) => ({
+		onSubmit: (e) => {
+			opts?.beforeSubmit?.(e);
+			if (e.defaultPrevented) return;
+			e.preventDefault();
+			store.handleFormSubmit(e.nativeEvent).catch(() => {});
+			opts?.afterSubmit?.(e);
+		},
+		method: "post",
+		action: cartEndpoint
+	});
+	return {
+		formProps,
+		register
+	};
+}
+
+//#endregion
+export { CartProvider, createCartComponents, getCartEndpoint, useCart, useCartActions, useCartAnalytics, useCartForm, useCartStore };
+//# sourceMappingURL=cart.mjs.map