@shopify/hydrogen 2026.4.5 → 2026.10.0-preview.2

package/dist/core/cart/state.d.mts

@@ -0,0 +1,137 @@
+import { CartErrorCode, CartWarningCode } from "../../graphql/generated/storefront-api-types.mjs";
+
+//#region src/core/cart/state.d.ts
+interface Money {
+  amount: string;
+  currencyCode: string;
+}
+interface CartCost {
+  subtotalAmount: Money;
+  totalAmount: Money;
+  checkoutChargeAmount: Money;
+}
+interface CartLineCost {
+  totalAmount: Money;
+  subtotalAmount: Money;
+  amountPerQuantity: Money;
+  compareAtAmountPerQuantity: Money | null;
+}
+interface CartLineMerchandise {
+  id: string;
+  title?: string;
+  selectedOptions?: Array<{
+    name: string;
+    value: string;
+  }>;
+  product: {
+    title: string;
+    handle?: string;
+    [key: string]: unknown;
+  };
+  image?: {
+    id?: string | null;
+    url: string;
+    altText?: string | null;
+    width?: number | null;
+    height?: number | null;
+    [key: string]: unknown;
+  } | null;
+  quantityAvailable?: number | null;
+  [key: string]: unknown;
+}
+interface CartLine {
+  id: string;
+  quantity: number;
+  attributes?: Attribute[];
+  cost: CartLineCost;
+  merchandise?: CartLineMerchandise;
+  sellingPlanAllocation?: {
+    sellingPlan: {
+      id: string;
+    };
+  } | null;
+  parentRelationship?: {
+    parent: {
+      id: string;
+    };
+  } | null;
+  lineComponents?: CartLine[];
+}
+interface CartLineConnection {
+  nodes: CartLine[];
+  [key: string]: unknown;
+}
+interface DiscountCode {
+  code: string;
+  applicable: boolean;
+}
+interface CartUserError {
+  code: CartErrorCode | null;
+  message: string;
+  field?: string[];
+}
+interface CartWarning {
+  code: CartWarningCode;
+  message: string;
+}
+interface CartErrorGroup {
+  userErrors: CartUserError[];
+  warnings: CartWarning[];
+}
+interface CartNetworkEntry {
+  message: string;
+  status?: number;
+}
+interface Attribute {
+  key: string;
+  value: string | null;
+}
+interface CartPending {
+  lines: Set<string>;
+  note: boolean;
+  attributes: boolean;
+  discountCodes: Set<string>;
+  cost?: boolean;
+}
+interface CartErrorState {
+  cart: CartErrorGroup;
+  lines: Map<string, CartErrorGroup>;
+  note: CartErrorGroup;
+  attributes: Map<string, CartErrorGroup>;
+  discountCodes: Map<string, CartErrorGroup>;
+  network: CartNetworkEntry[];
+  lastUpdatedAt: number;
+  cartUpdatedAt: number;
+  linesUpdatedAt: number;
+  noteUpdatedAt: number;
+  attributesUpdatedAt: number;
+  discountCodesUpdatedAt: number;
+  networkUpdatedAt: number;
+}
+interface CartData {
+  id: string | null;
+  checkoutUrl?: string | null;
+  totalQuantity: number;
+  cost: CartCost;
+  note?: string | null;
+  attributes: Attribute[];
+  lines: CartLineConnection;
+  discountCodes: DiscountCode[];
+  [key: string]: unknown;
+}
+interface CartState<TData extends CartData = CartData> {
+  data: TData;
+  loading: boolean;
+  /** Non-rejecting signal that resolves when the current full-cart load settles or is invalidated. */
+  readonly readyPromise?: PromiseLike<void>;
+  pending: CartPending;
+  revalidating?: boolean;
+  errors: CartErrorState;
+}
+declare function createEmptyErrorGroup(): CartErrorGroup;
+declare function createEmptyCartErrors(): CartErrorState;
+declare const EMPTY_CART_DATA: CartData;
+declare const EMPTY_CART_STATE: CartState;
+//#endregion
+export { Attribute, CartCost, CartData, CartErrorGroup, CartErrorState, CartLine, CartLineConnection, CartLineCost, CartLineMerchandise, CartNetworkEntry, CartPending, CartState, CartUserError, CartWarning, DiscountCode, EMPTY_CART_DATA, EMPTY_CART_STATE, createEmptyCartErrors, createEmptyErrorGroup };
+//# sourceMappingURL=state.d.mts.map

package/dist/core/cart/state.mjs

@@ -0,0 +1,76 @@
+//#region src/core/cart/state.ts
+function createEmptyPending() {
+	return {
+		lines: /* @__PURE__ */ new Set(),
+		note: false,
+		attributes: false,
+		discountCodes: /* @__PURE__ */ new Set(),
+		cost: false
+	};
+}
+function createEmptyErrorGroup() {
+	return {
+		userErrors: [],
+		warnings: []
+	};
+}
+function createEmptyCartErrors() {
+	return {
+		cart: createEmptyErrorGroup(),
+		lines: /* @__PURE__ */ new Map(),
+		note: createEmptyErrorGroup(),
+		attributes: /* @__PURE__ */ new Map(),
+		discountCodes: /* @__PURE__ */ new Map(),
+		network: [],
+		lastUpdatedAt: 0,
+		cartUpdatedAt: 0,
+		linesUpdatedAt: 0,
+		noteUpdatedAt: 0,
+		attributesUpdatedAt: 0,
+		discountCodesUpdatedAt: 0,
+		networkUpdatedAt: 0
+	};
+}
+const EMPTY_CART_DATA = Object.freeze({
+	id: null,
+	checkoutUrl: null,
+	totalQuantity: 0,
+	cost: Object.freeze({
+		subtotalAmount: Object.freeze({
+			amount: "0",
+			currencyCode: ""
+		}),
+		totalAmount: Object.freeze({
+			amount: "0",
+			currencyCode: ""
+		}),
+		checkoutChargeAmount: Object.freeze({
+			amount: "0",
+			currencyCode: ""
+		})
+	}),
+	note: "",
+	attributes: [],
+	lines: Object.freeze({ nodes: [] }),
+	discountCodes: []
+});
+function createCartState(data, { loading = false } = {}) {
+	return {
+		data,
+		loading,
+		pending: createEmptyPending(),
+		errors: createEmptyCartErrors()
+	};
+}
+function createEmptyCartState({ loading = true } = {}) {
+	return createCartState({
+		...EMPTY_CART_DATA,
+		lines: { nodes: [] },
+		discountCodes: []
+	}, { loading });
+}
+const EMPTY_CART_STATE = createEmptyCartState();
+
+//#endregion
+export { EMPTY_CART_DATA, EMPTY_CART_STATE, createCartState, createEmptyCartErrors, createEmptyCartState, createEmptyErrorGroup };
+//# sourceMappingURL=state.mjs.map

package/dist/core/cart/state.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.mjs","names":[],"sources":["../../../src/core/cart/state.ts"],"sourcesContent":["import type { CartErrorCode, CartWarningCode } from \"../../graphql/generated/storefront-api-types\";\n\nexport interface Money {\n  amount: string;\n  currencyCode: string;\n}\n\nexport interface CartCost {\n  subtotalAmount: Money;\n  totalAmount: Money;\n  checkoutChargeAmount: Money;\n}\n\nexport interface CartLineCost {\n  totalAmount: Money;\n  subtotalAmount: Money;\n  amountPerQuantity: Money;\n  compareAtAmountPerQuantity: Money | null;\n}\n\nexport interface CartLineMerchandise {\n  id: string;\n  title?: string;\n  selectedOptions?: Array<{ name: string; value: string }>;\n  product: {\n    title: string;\n    handle?: string;\n    [key: string]: unknown;\n  };\n  image?: {\n    id?: string | null;\n    url: string;\n    altText?: string | null;\n    width?: number | null;\n    height?: number | null;\n    [key: string]: unknown;\n  } | null;\n  quantityAvailable?: number | null;\n  [key: string]: unknown;\n}\n\nexport interface CartLine {\n  id: string;\n  quantity: number;\n  attributes?: Attribute[];\n  cost: CartLineCost;\n  merchandise?: CartLineMerchandise;\n  sellingPlanAllocation?: { sellingPlan: { id: string } } | null;\n  parentRelationship?: { parent: { id: string } } | null;\n  lineComponents?: CartLine[];\n}\n\nexport interface CartLineConnection {\n  nodes: CartLine[];\n  [key: string]: unknown;\n}\n\nexport interface DiscountCode {\n  code: string;\n  applicable: boolean;\n}\n\nexport interface CartUserError {\n  code: CartErrorCode | null;\n  message: string;\n  field?: string[];\n}\n\nexport interface CartWarning {\n  code: CartWarningCode;\n  message: string;\n}\n\nexport interface CartErrorGroup {\n  userErrors: CartUserError[];\n  warnings: CartWarning[];\n}\n\nexport interface CartNetworkEntry {\n  message: string;\n  status?: number;\n}\n\nexport interface Attribute {\n  key: string;\n  value: string | null;\n}\n\nexport interface CartPending {\n  lines: Set<string>;\n  note: boolean;\n  attributes: boolean;\n  discountCodes: Set<string>;\n  cost?: boolean;\n}\n\nexport interface CartErrorState {\n  cart: CartErrorGroup;\n  lines: Map<string, CartErrorGroup>;\n  note: CartErrorGroup;\n  attributes: Map<string, CartErrorGroup>;\n  discountCodes: Map<string, CartErrorGroup>;\n  network: CartNetworkEntry[];\n  lastUpdatedAt: number;\n  cartUpdatedAt: number;\n  linesUpdatedAt: number;\n  noteUpdatedAt: number;\n  attributesUpdatedAt: number;\n  discountCodesUpdatedAt: number;\n  networkUpdatedAt: number;\n}\n\nexport interface CartData {\n  id: string | null;\n  checkoutUrl?: string | null;\n  totalQuantity: number;\n  cost: CartCost;\n  note?: string | null;\n  attributes: Attribute[];\n  lines: CartLineConnection;\n  discountCodes: DiscountCode[];\n  [key: string]: unknown;\n}\n\nexport interface CartState<TData extends CartData = CartData> {\n  data: TData;\n  loading: boolean;\n  /** Non-rejecting signal that resolves when the current full-cart load settles or is invalidated. */\n  readonly readyPromise?: PromiseLike<void>;\n  pending: CartPending;\n  revalidating?: boolean;\n  errors: CartErrorState;\n}\n\nexport function createEmptyPending(): CartPending {\n  return {\n    lines: new Set(),\n    note: false,\n    attributes: false,\n    discountCodes: new Set(),\n    cost: false,\n  };\n}\n\nexport function createEmptyErrorGroup(): CartErrorGroup {\n  return { userErrors: [], warnings: [] };\n}\n\nexport function createEmptyCartErrors(): CartErrorState {\n  return {\n    cart: createEmptyErrorGroup(),\n    lines: new Map(),\n    note: createEmptyErrorGroup(),\n    attributes: new Map(),\n    discountCodes: new Map(),\n    network: [],\n    lastUpdatedAt: 0,\n    cartUpdatedAt: 0,\n    linesUpdatedAt: 0,\n    noteUpdatedAt: 0,\n    attributesUpdatedAt: 0,\n    discountCodesUpdatedAt: 0,\n    networkUpdatedAt: 0,\n  };\n}\n\nexport const EMPTY_CART_DATA: CartData = Object.freeze({\n  id: null,\n  checkoutUrl: null,\n  totalQuantity: 0,\n  cost: Object.freeze({\n    subtotalAmount: Object.freeze({ amount: \"0\", currencyCode: \"\" }),\n    totalAmount: Object.freeze({ amount: \"0\", currencyCode: \"\" }),\n    checkoutChargeAmount: Object.freeze({ amount: \"0\", currencyCode: \"\" }),\n  }),\n  note: \"\",\n  attributes: [] as Attribute[],\n  lines: Object.freeze({ nodes: [] as CartLine[] }),\n  discountCodes: [] as DiscountCode[],\n});\n\nexport function createCartState<TData extends CartData>(\n  data: TData,\n  { loading = false }: { loading?: boolean } = {},\n): CartState<TData> {\n  return {\n    data,\n    loading,\n    pending: createEmptyPending(),\n    errors: createEmptyCartErrors(),\n  };\n}\n\nexport function createEmptyCartState({ loading = true }: { loading?: boolean } = {}): CartState {\n  return createCartState(\n    {\n      ...EMPTY_CART_DATA,\n      lines: { nodes: [] },\n      discountCodes: [],\n    },\n    { loading },\n  );\n}\n\nexport const EMPTY_CART_STATE: CartState = createEmptyCartState();\n"],"mappings":";AAsIA,SAAgB,qBAAkC;AAChD,QAAO;EACL,uBAAO,IAAI,KAAK;EAChB,MAAM;EACN,YAAY;EACZ,+BAAe,IAAI,KAAK;EACxB,MAAM;EACP;;AAGH,SAAgB,wBAAwC;AACtD,QAAO;EAAE,YAAY,EAAE;EAAE,UAAU,EAAE;EAAE;;AAGzC,SAAgB,wBAAwC;AACtD,QAAO;EACL,MAAM,uBAAuB;EAC7B,uBAAO,IAAI,KAAK;EAChB,MAAM,uBAAuB;EAC7B,4BAAY,IAAI,KAAK;EACrB,+BAAe,IAAI,KAAK;EACxB,SAAS,EAAE;EACX,eAAe;EACf,eAAe;EACf,gBAAgB;EAChB,eAAe;EACf,qBAAqB;EACrB,wBAAwB;EACxB,kBAAkB;EACnB;;AAGH,MAAa,kBAA4B,OAAO,OAAO;CACrD,IAAI;CACJ,aAAa;CACb,eAAe;CACf,MAAM,OAAO,OAAO;EAClB,gBAAgB,OAAO,OAAO;GAAE,QAAQ;GAAK,cAAc;GAAI,CAAC;EAChE,aAAa,OAAO,OAAO;GAAE,QAAQ;GAAK,cAAc;GAAI,CAAC;EAC7D,sBAAsB,OAAO,OAAO;GAAE,QAAQ;GAAK,cAAc;GAAI,CAAC;EACvE,CAAC;CACF,MAAM;CACN,YAAY,EAAE;CACd,OAAO,OAAO,OAAO,EAAE,OAAO,EAAE,EAAgB,CAAC;CACjD,eAAe,EAAE;CAClB,CAAC;AAEF,SAAgB,gBACd,MACA,EAAE,UAAU,UAAiC,EAAE,EAC7B;AAClB,QAAO;EACL;EACA;EACA,SAAS,oBAAoB;EAC7B,QAAQ,uBAAuB;EAChC;;AAGH,SAAgB,qBAAqB,EAAE,UAAU,SAAgC,EAAE,EAAa;AAC9F,QAAO,gBACL;EACE,GAAG;EACH,OAAO,EAAE,OAAO,EAAE,EAAE;EACpB,eAAe,EAAE;EAClB,EACD,EAAE,SAAS,CACZ;;AAGH,MAAa,mBAA8B,sBAAsB"}

package/dist/core/cart/sync-quantity-inputs.mjs

@@ -0,0 +1,16 @@
+//#region src/core/cart/sync-quantity-inputs.ts
+function syncQuantityInputs(updates, cartEndpoint) {
+	const forms = document.querySelectorAll(`form[action="${CSS.escape(cartEndpoint)}"]`);
+	for (const form of forms) for (const { id, quantity } of updates) {
+		if (!form.querySelector(`input[name="lineId"][value="${CSS.escape(id)}"]`)) continue;
+		const quantityInput = form.querySelector("input[name=\"quantity\"]");
+		if (!quantityInput) continue;
+		if (quantityInput.type === "hidden") continue;
+		if (document.activeElement === quantityInput) continue;
+		quantityInput.value = String(quantity);
+	}
+}
+
+//#endregion
+export { syncQuantityInputs };
+//# sourceMappingURL=sync-quantity-inputs.mjs.map

package/dist/core/cart/sync-quantity-inputs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-quantity-inputs.mjs","names":[],"sources":["../../../src/core/cart/sync-quantity-inputs.ts"],"sourcesContent":["export function syncQuantityInputs(\n  updates: Array<{ id: string; quantity: number }>,\n  cartEndpoint: string,\n): void {\n  const forms = document.querySelectorAll<HTMLFormElement>(\n    `form[action=\"${CSS.escape(cartEndpoint)}\"]`,\n  );\n\n  for (const form of forms) {\n    for (const { id, quantity } of updates) {\n      const lineIdInput = form.querySelector<HTMLInputElement>(\n        `input[name=\"lineId\"][value=\"${CSS.escape(id)}\"]`,\n      );\n      if (!lineIdInput) continue;\n\n      const quantityInput = form.querySelector<HTMLInputElement>('input[name=\"quantity\"]');\n      if (!quantityInput) continue;\n      if (quantityInput.type === \"hidden\") continue;\n      if (document.activeElement === quantityInput) continue;\n\n      quantityInput.value = String(quantity);\n    }\n  }\n}\n"],"mappings":";AAAA,SAAgB,mBACd,SACA,cACM;CACN,MAAM,QAAQ,SAAS,iBACrB,gBAAgB,IAAI,OAAO,aAAa,CAAC,IAC1C;AAED,MAAK,MAAM,QAAQ,MACjB,MAAK,MAAM,EAAE,IAAI,cAAc,SAAS;AAItC,MAAI,CAHgB,KAAK,cACvB,+BAA+B,IAAI,OAAO,GAAG,CAAC,IAEhC,CAAE;EAElB,MAAM,gBAAgB,KAAK,cAAgC,2BAAyB;AACpF,MAAI,CAAC,cAAe;AACpB,MAAI,cAAc,SAAS,SAAU;AACrC,MAAI,SAAS,kBAAkB,cAAe;AAE9C,gBAAc,QAAQ,OAAO,SAAS"}

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

@@ -0,0 +1,134 @@
+import { ProductCollectionSortKeys } from "../../graphql/generated/storefront-api-types.mjs";
+import { ProductFilter } from "../../vendor/standard-events.mjs";
+import { CollectionState } from "./state.mjs";
+
+//#region src/core/collection/collection.d.ts
+/** Snapshot from the framework loader for a single collection fetch. */
+type CollectionData = {
+  /** URL-safe collection slug (e.g. `"shoes"`). */handle: string;
+  /**
+   * Search string this data snapshot was fetched for (with or without leading `?`).
+   * Compared against live {@link CreateCollectionStoreOptions.urlSearch} before settling.
+   */
+  dataSearch: string;
+};
+/**
+ * A reactive, framework-agnostic store for collection browse state.
+ *
+ * Manages filters and sorting — the user's *intent*. Server response
+ * data (products, productsCount, availableFilters) lives in the framework's
+ * loader data, not here.
+ *
+ * Mutations are synchronous state changes that set `status: "loading"`.
+ * The framework adapter navigates (URL change), the framework loader re-runs,
+ * and the adapter calls {@link settle} when fresh data arrives.
+ *
+ * @example
+ * ```ts
+ * const store = createCollectionStore({
+ *   data: { handle: "shoes", dataSearch: "" },
+ * });
+ *
+ * store.setFilters([{ tag: "sale" }]); // status → "loading"
+ * // ...framework fetches...
+ * store.settle(); // status → "idle"
+ * ```
+ */
+type CollectionStore = {
+  /** Returns the current snapshot of collection browse state. */getState(): CollectionState;
+  /**
+   * Registers a listener invoked on every state change. Returns an unsubscribe function.
+   * @param listener - Callback receiving the new state snapshot
+   */
+  subscribe(listener: (state: CollectionState) => void): () => void;
+  /**
+   * Replaces the active product filters.
+   * Sets `status: "loading"` — call {@link settle} when the framework fetch completes.
+   */
+  setFilters(filters: ProductFilter[]): void;
+  /**
+   * Adds the filter if not active, removes it if already active.
+   * Sets `status: "loading"` — call {@link settle} when the framework fetch completes.
+   */
+  toggleFilter(filter: ProductFilter): void;
+  /**
+   * Changes the sort order.
+   * Sets `status: "loading"` — call {@link settle} when the framework fetch completes.
+   */
+  setSortKey(sortKey: ProductCollectionSortKeys, reverse?: boolean): void;
+  /**
+   * Resets filters and sort to defaults.
+   * Sets `status: "loading"` — call {@link settle} when the framework fetch completes.
+   */
+  reset(): void;
+  /**
+   * Returns `true` when URL params and current browse state describe the same filters and sort.
+   */
+  matchesParams(searchParams: URLSearchParams): boolean;
+  /**
+   * Applies URL search params to the store when they differ from current state.
+   * Used when the framework router reports an external URL change (back/forward).
+   */
+  syncFromParams(searchParams: URLSearchParams): void;
+  /**
+   * Signals that the framework fetch completed and fresh data is available.
+   * Resets `status` to `"idle"`.
+   */
+  settle(): void;
+  /**
+   * Serializes the store's current filter/sort state into URL search params.
+   * Only includes store-owned keys (`filter.*`, `sort_by`).
+   */
+  serializeToParams(): URLSearchParams;
+  /**
+   * Builds a URL string that removes the given filter from the current params.
+   * Useful for rendering "remove filter" links/buttons.
+   */
+  getFilterRemovalUrl(filter: ProductFilter): string;
+  /**
+   * Parses `FormData` from the submitted form into collection params and applies them.
+   * Callers must call `event.preventDefault()` before invoking this method.
+   */
+  handleFormSubmit(event: SubmitEvent): void;
+  /**
+   * Replaces the callback that runs after user filter/sort changes. Framework
+   * adapters use this to trigger navigation. Pass `null` to remove.
+   */
+  setOnBrowseChange(callback: (() => void) | null): void;
+  /**
+   * Parses a Storefront API filter input JSON string (e.g. from
+   * `FilterValue.input`) and toggles the resulting filter.
+   * No-op if `input` is not valid JSON.
+   */
+  toggleFilterInput(input: string): void;
+  /**
+   * Parses a Liquid-compatible `sort_by` value (e.g. `"price-ascending"`) and
+   * applies the corresponding sort key and direction.
+   */
+  setSortByValue(sortByValue: string): void;
+};
+/** Options for creating a new {@link CollectionStore}. */
+type CreateCollectionStoreOptions = {
+  /** Collection metadata from the framework loader. */data: CollectionData;
+  /**
+   * Live URL search string from the framework router (with or without leading `?`).
+   * Falls back to `data.dataSearch` when omitted.
+   */
+  urlSearch?: string;
+  /**
+   * Called after user-initiated filter/sort changes.
+   * Framework adapters use this to trigger navigation. Not called by
+   * {@link CollectionStore.syncFromParams} or {@link CollectionStore.settle}.
+   */
+  onBrowseChange?: () => void;
+};
+/**
+ * Creates a new collection store for the given collection handle.
+ *
+ * The store manages browse intent (filters, sort) only.
+ * Server response data lives in the framework's loader.
+ */
+declare function createCollectionStore(options: CreateCollectionStoreOptions): CollectionStore;
+//#endregion
+export { CollectionData, CollectionStore, CreateCollectionStoreOptions, createCollectionStore };
+//# sourceMappingURL=collection.d.mts.map

package/dist/core/collection/collection.mjs

@@ -0,0 +1,170 @@
+import { createObservable } from "../observable.mjs";
+import { createInitialCollectionState } from "./state.mjs";
+import { collectionParamsMatchState, filterEquals, getFilterRemovalUrl, isDirectionalSortKey, parseCollectionParams, parseSortByValue, serializeCollectionParams } from "./url.mjs";
+
+//#region src/core/collection/collection.ts
+/**
+* Creates a new collection store for the given collection handle.
+*
+* The store manages browse intent (filters, sort) only.
+* Server response data lives in the framework's loader.
+*/
+function createCollectionStore(options) {
+	const context = {
+		observable: createObservable(buildInitialState(options)),
+		handle: options.data.handle,
+		onBrowseChange: options.onBrowseChange ?? null
+	};
+	return {
+		getState: () => context.observable.state,
+		subscribe: (listener) => context.observable.subscribe(listener),
+		setFilters: (filters) => applyBrowseChange(context, { filters: normalizeFilters(filters) }),
+		toggleFilter: (filter) => toggleFilter(context, filter),
+		setSortKey: (sortKey, reverse) => applyBrowseChange(context, {
+			sortKey,
+			reverse: reverse ?? false
+		}),
+		reset: () => resetStore(context),
+		matchesParams: (searchParams) => matchesParams(context, searchParams),
+		syncFromParams: (searchParams) => syncFromParams(context, searchParams),
+		settle: () => settleStore(context),
+		serializeToParams: () => serializeCollectionParams(context.observable.state),
+		getFilterRemovalUrl: (filter) => getFilterRemovalUrl(serializeCollectionParams(context.observable.state), filter),
+		handleFormSubmit: (event) => handleFormSubmit(context, event),
+		setOnBrowseChange: (callback) => {
+			context.onBrowseChange = callback;
+		},
+		toggleFilterInput: (input) => toggleFilterInput(context, input),
+		setSortByValue: (sortByValue) => setSortByValue(context, sortByValue)
+	};
+}
+function buildInitialState(options) {
+	const base = createInitialCollectionState(options.data.handle);
+	const search = options.urlSearch ?? options.data.dataSearch;
+	if (search) {
+		const parsed = parseCollectionParams(new URLSearchParams(search));
+		base.filters = parsed.filters;
+		base.sortKey = parsed.sortKey;
+		base.reverse = normalizeReverse(parsed.sortKey, parsed.reverse);
+	}
+	return base;
+}
+/**
+* Drops `reverse` for sort keys that do not support direction.
+* Only `PRICE`, `TITLE`, `CREATED`, and `ID` honor ascending/descending.
+*
+* @example normalizeReverse("BEST_SELLING", true) // → false
+* @example normalizeReverse("PRICE", true) // → true
+*/
+function normalizeReverse(sortKey, reverse) {
+	if (!sortKey || !isDirectionalSortKey(sortKey)) return false;
+	return reverse;
+}
+function applyBrowseChange(context, change, notify = true) {
+	context.observable.setState((prev) => {
+		const merged = {
+			...prev,
+			...change,
+			status: "loading"
+		};
+		merged.reverse = normalizeReverse(merged.sortKey, merged.reverse);
+		return merged;
+	});
+	if (notify) context.onBrowseChange?.();
+}
+function toggleFilter(context, filter) {
+	const current = context.observable.state.filters;
+	applyBrowseChange(context, { filters: current.some((f) => filterEquals(f, filter)) ? current.filter((f) => !filterEquals(f, filter)) : normalizeFilters([...current, filter]) });
+}
+function normalizeFilters(filters) {
+	const normalized = [];
+	for (const filter of filters) {
+		if (filter.available != null) {
+			const existingAvailabilityIndex = normalized.findIndex((candidate) => {
+				return candidate.available != null;
+			});
+			if (existingAvailabilityIndex !== -1) {
+				normalized.splice(existingAvailabilityIndex, 1);
+				continue;
+			}
+		}
+		normalized.push(filter);
+	}
+	return normalized;
+}
+function resetStore(context) {
+	const initial = createInitialCollectionState(context.handle);
+	applyBrowseChange(context, {
+		filters: initial.filters,
+		sortKey: initial.sortKey,
+		reverse: initial.reverse
+	});
+}
+function matchesParams(context, searchParams) {
+	return collectionParamsMatchState(searchParams, context.observable.state);
+}
+function syncFromParams(context, searchParams) {
+	if (matchesParams(context, searchParams)) return;
+	const parsed = parseCollectionParams(searchParams);
+	if (context.observable.state.status === "loading") {
+		context.observable.setState((prev) => ({
+			...prev,
+			filters: parsed.filters,
+			sortKey: parsed.sortKey,
+			reverse: normalizeReverse(parsed.sortKey, parsed.reverse),
+			status: "loading"
+		}));
+		return;
+	}
+	/**
+	* URL already changes, so we don't need to notify to call onBrowseChange
+	* again which would cause a double navigate.
+	*/
+	applyBrowseChange(context, {
+		filters: parsed.filters,
+		sortKey: parsed.sortKey,
+		reverse: parsed.reverse
+	}, false);
+}
+function settleStore(context) {
+	context.observable.setState((prev) => {
+		if (prev.status === "idle") return prev;
+		return {
+			...prev,
+			status: "idle"
+		};
+	});
+}
+function handleFormSubmit(context, event) {
+	if (!(event.target instanceof HTMLFormElement)) throw new TypeError(`Expected event.target to be an HTMLFormElement, got ${event.target}`);
+	const formData = new FormData(event.target);
+	const formParams = new URLSearchParams();
+	for (const [key, value] of formData.entries()) if (typeof value === "string") formParams.append(key, value);
+	const parsed = parseCollectionParams(formParams);
+	const change = { filters: normalizeFilters(parsed.filters) };
+	if (formParams.has("sort_by")) {
+		change.sortKey = parsed.sortKey;
+		change.reverse = parsed.reverse;
+	}
+	applyBrowseChange(context, change);
+}
+function toggleFilterInput(context, input) {
+	let parsed;
+	try {
+		parsed = JSON.parse(input);
+	} catch {
+		return;
+	}
+	toggleFilter(context, parsed);
+}
+function setSortByValue(context, sortByValue) {
+	const { sortKey, reverse } = parseSortByValue(sortByValue);
+	applyBrowseChange(context, {
+		sortKey: sortKey ?? "COLLECTION_DEFAULT",
+		reverse: reverse ?? false
+	});
+}
+
+//#endregion
+export { createCollectionStore };
+//# sourceMappingURL=collection.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collection.mjs","names":[],"sources":["../../../src/core/collection/collection.ts"],"sourcesContent":["import type { ProductCollectionSortKeys } from \"../../graphql/generated/storefront-api-types\";\nimport { createObservable } from \"../observable\";\nimport type { CollectionState, ProductFilter } from \"./state\";\nimport { createInitialCollectionState } from \"./state\";\nimport {\n  collectionParamsMatchState,\n  filterEquals,\n  getFilterRemovalUrl,\n  isDirectionalSortKey,\n  parseCollectionParams,\n  parseSortByValue,\n  serializeCollectionParams,\n} from \"./url\";\n\n/** Snapshot from the framework loader for a single collection fetch. */\nexport type CollectionData = {\n  /** URL-safe collection slug (e.g. `\"shoes\"`). */\n  handle: string;\n  /**\n   * Search string this data snapshot was fetched for (with or without leading `?`).\n   * Compared against live {@link CreateCollectionStoreOptions.urlSearch} before settling.\n   */\n  dataSearch: string;\n};\n\n/**\n * A reactive, framework-agnostic store for collection browse state.\n *\n * Manages filters and sorting — the user's *intent*. Server response\n * data (products, productsCount, availableFilters) lives in the framework's\n * loader data, not here.\n *\n * Mutations are synchronous state changes that set `status: \"loading\"`.\n * The framework adapter navigates (URL change), the framework loader re-runs,\n * and the adapter calls {@link settle} when fresh data arrives.\n *\n * @example\n * ```ts\n * const store = createCollectionStore({\n *   data: { handle: \"shoes\", dataSearch: \"\" },\n * });\n *\n * store.setFilters([{ tag: \"sale\" }]); // status → \"loading\"\n * // ...framework fetches...\n * store.settle(); // status → \"idle\"\n * ```\n */\nexport type CollectionStore = {\n  /** Returns the current snapshot of collection browse state. */\n  getState(): CollectionState;\n\n  /**\n   * Registers a listener invoked on every state change. Returns an unsubscribe function.\n   * @param listener - Callback receiving the new state snapshot\n   */\n  subscribe(listener: (state: CollectionState) => void): () => void;\n\n  /**\n   * Replaces the active product filters.\n   * Sets `status: \"loading\"` — call {@link settle} when the framework fetch completes.\n   */\n  setFilters(filters: ProductFilter[]): void;\n\n  /**\n   * Adds the filter if not active, removes it if already active.\n   * Sets `status: \"loading\"` — call {@link settle} when the framework fetch completes.\n   */\n  toggleFilter(filter: ProductFilter): void;\n\n  /**\n   * Changes the sort order.\n   * Sets `status: \"loading\"` — call {@link settle} when the framework fetch completes.\n   */\n  setSortKey(sortKey: ProductCollectionSortKeys, reverse?: boolean): void;\n\n  /**\n   * Resets filters and sort to defaults.\n   * Sets `status: \"loading\"` — call {@link settle} when the framework fetch completes.\n   */\n  reset(): void;\n\n  /**\n   * Returns `true` when URL params and current browse state describe the same filters and sort.\n   */\n  matchesParams(searchParams: URLSearchParams): boolean;\n\n  /**\n   * Applies URL search params to the store when they differ from current state.\n   * Used when the framework router reports an external URL change (back/forward).\n   */\n  syncFromParams(searchParams: URLSearchParams): void;\n\n  /**\n   * Signals that the framework fetch completed and fresh data is available.\n   * Resets `status` to `\"idle\"`.\n   */\n  settle(): void;\n\n  /**\n   * Serializes the store's current filter/sort state into URL search params.\n   * Only includes store-owned keys (`filter.*`, `sort_by`).\n   */\n  serializeToParams(): URLSearchParams;\n\n  /**\n   * Builds a URL string that removes the given filter from the current params.\n   * Useful for rendering \"remove filter\" links/buttons.\n   */\n  getFilterRemovalUrl(filter: ProductFilter): string;\n\n  /**\n   * Parses `FormData` from the submitted form into collection params and applies them.\n   * Callers must call `event.preventDefault()` before invoking this method.\n   */\n  handleFormSubmit(event: SubmitEvent): void;\n\n  /**\n   * Replaces the callback that runs after user filter/sort changes. Framework\n   * adapters use this to trigger navigation. Pass `null` to remove.\n   */\n  setOnBrowseChange(callback: (() => void) | null): void;\n\n  /**\n   * Parses a Storefront API filter input JSON string (e.g. from\n   * `FilterValue.input`) and toggles the resulting filter.\n   * No-op if `input` is not valid JSON.\n   */\n  toggleFilterInput(input: string): void;\n\n  /**\n   * Parses a Liquid-compatible `sort_by` value (e.g. `\"price-ascending\"`) and\n   * applies the corresponding sort key and direction.\n   */\n  setSortByValue(sortByValue: string): void;\n};\n\n/** Options for creating a new {@link CollectionStore}. */\nexport type CreateCollectionStoreOptions = {\n  /** Collection metadata from the framework loader. */\n  data: CollectionData;\n  /**\n   * Live URL search string from the framework router (with or without leading `?`).\n   * Falls back to `data.dataSearch` when omitted.\n   */\n  urlSearch?: string;\n  /**\n   * Called after user-initiated filter/sort changes.\n   * Framework adapters use this to trigger navigation. Not called by\n   * {@link CollectionStore.syncFromParams} or {@link CollectionStore.settle}.\n   */\n  onBrowseChange?: () => void;\n};\n\ntype CollectionStoreContext = {\n  observable: ReturnType<typeof createObservable<CollectionState>>;\n  handle: string;\n  onBrowseChange: (() => void) | null;\n};\n\n/**\n * Creates a new collection store for the given collection handle.\n *\n * The store manages browse intent (filters, sort) only.\n * Server response data lives in the framework's loader.\n */\nexport function createCollectionStore(options: CreateCollectionStoreOptions): CollectionStore {\n  const initialState = buildInitialState(options);\n\n  const context: CollectionStoreContext = {\n    observable: createObservable<CollectionState>(initialState),\n    handle: options.data.handle,\n    onBrowseChange: options.onBrowseChange ?? null,\n  };\n\n  return {\n    getState: () => context.observable.state,\n    subscribe: (listener) => context.observable.subscribe(listener),\n    setFilters: (filters) => applyBrowseChange(context, { filters: normalizeFilters(filters) }),\n    toggleFilter: (filter) => toggleFilter(context, filter),\n    setSortKey: (sortKey, reverse) =>\n      applyBrowseChange(context, { sortKey, reverse: reverse ?? false }),\n    reset: () => resetStore(context),\n    matchesParams: (searchParams) => matchesParams(context, searchParams),\n    syncFromParams: (searchParams) => syncFromParams(context, searchParams),\n    settle: () => settleStore(context),\n    serializeToParams: () => serializeCollectionParams(context.observable.state),\n    getFilterRemovalUrl: (filter) =>\n      getFilterRemovalUrl(serializeCollectionParams(context.observable.state), filter),\n    handleFormSubmit: (event) => handleFormSubmit(context, event),\n    setOnBrowseChange: (callback) => {\n      context.onBrowseChange = callback;\n    },\n    toggleFilterInput: (input) => toggleFilterInput(context, input),\n    setSortByValue: (sortByValue) => setSortByValue(context, sortByValue),\n  };\n}\n\nfunction buildInitialState(options: CreateCollectionStoreOptions): CollectionState {\n  const base = createInitialCollectionState(options.data.handle);\n\n  const search = options.urlSearch ?? options.data.dataSearch;\n  if (search) {\n    const parsed = parseCollectionParams(new URLSearchParams(search));\n    base.filters = parsed.filters;\n    base.sortKey = parsed.sortKey;\n    base.reverse = normalizeReverse(parsed.sortKey, parsed.reverse);\n  }\n\n  return base;\n}\n\ntype BrowseChange = Partial<Pick<CollectionState, \"filters\" | \"sortKey\" | \"reverse\">>;\n\n/**\n * Drops `reverse` for sort keys that do not support direction.\n * Only `PRICE`, `TITLE`, `CREATED`, and `ID` honor ascending/descending.\n *\n * @example normalizeReverse(\"BEST_SELLING\", true) // → false\n * @example normalizeReverse(\"PRICE\", true) // → true\n */\nfunction normalizeReverse(\n  sortKey: ProductCollectionSortKeys | undefined,\n  reverse: boolean,\n): boolean {\n  if (!sortKey || !isDirectionalSortKey(sortKey)) return false;\n  return reverse;\n}\n\nfunction applyBrowseChange(\n  context: CollectionStoreContext,\n  change: BrowseChange,\n  notify = true,\n): void {\n  context.observable.setState((prev) => {\n    const merged = { ...prev, ...change, status: \"loading\" as const };\n    merged.reverse = normalizeReverse(merged.sortKey, merged.reverse);\n    return merged;\n  });\n  if (notify) {\n    context.onBrowseChange?.();\n  }\n}\n\nfunction toggleFilter(context: CollectionStoreContext, filter: ProductFilter): void {\n  const current = context.observable.state.filters;\n  const isActive = current.some((f) => filterEquals(f, filter));\n\n  const next = isActive\n    ? current.filter((f) => !filterEquals(f, filter))\n    : normalizeFilters([...current, filter]);\n\n  applyBrowseChange(context, { filters: next });\n}\n\nfunction normalizeFilters(filters: ProductFilter[]): ProductFilter[] {\n  const normalized: ProductFilter[] = [];\n\n  for (const filter of filters) {\n    if (filter.available != null) {\n      // Availability is a single boolean facet. Duplicate availability params\n      // (filter.v.availability=1&filter.v.availability=0) mean no filter, so\n      // keeping both values here prevents the provider from settling navigation.\n      const existingAvailabilityIndex = normalized.findIndex((candidate) => {\n        return candidate.available != null;\n      });\n\n      if (existingAvailabilityIndex !== -1) {\n        normalized.splice(existingAvailabilityIndex, 1);\n        continue;\n      }\n    }\n\n    normalized.push(filter);\n  }\n\n  return normalized;\n}\n\nfunction resetStore(context: CollectionStoreContext): void {\n  const initial = createInitialCollectionState(context.handle);\n  applyBrowseChange(context, {\n    filters: initial.filters,\n    sortKey: initial.sortKey,\n    reverse: initial.reverse,\n  });\n}\n\nfunction matchesParams(context: CollectionStoreContext, searchParams: URLSearchParams): boolean {\n  return collectionParamsMatchState(searchParams, context.observable.state);\n}\n\nfunction syncFromParams(context: CollectionStoreContext, searchParams: URLSearchParams): void {\n  if (matchesParams(context, searchParams)) return;\n\n  const parsed = parseCollectionParams(searchParams);\n\n  // URL caught up to an in-flight browse change — align state without re-entering loading.\n  if (context.observable.state.status === \"loading\") {\n    context.observable.setState((prev) => ({\n      ...prev,\n      filters: parsed.filters,\n      sortKey: parsed.sortKey,\n      reverse: normalizeReverse(parsed.sortKey, parsed.reverse),\n      status: \"loading\",\n    }));\n    return;\n  }\n\n  /**\n   * URL already changes, so we don't need to notify to call onBrowseChange\n   * again which would cause a double navigate.\n   */\n  applyBrowseChange(\n    context,\n    {\n      filters: parsed.filters,\n      sortKey: parsed.sortKey,\n      reverse: parsed.reverse,\n    },\n    false,\n  );\n}\n\nfunction settleStore(context: CollectionStoreContext): void {\n  context.observable.setState((prev) => {\n    if (prev.status === \"idle\") return prev;\n    return { ...prev, status: \"idle\" };\n  });\n}\n\nfunction handleFormSubmit(context: CollectionStoreContext, event: SubmitEvent): void {\n  if (!(event.target instanceof HTMLFormElement)) {\n    throw new TypeError(`Expected event.target to be an HTMLFormElement, got ${event.target}`);\n  }\n\n  const formData = new FormData(event.target);\n  const formParams = new URLSearchParams();\n\n  for (const [key, value] of formData.entries()) {\n    if (typeof value === \"string\") {\n      formParams.append(key, value);\n    }\n  }\n\n  const parsed = parseCollectionParams(formParams);\n\n  const change: BrowseChange = {\n    filters: normalizeFilters(parsed.filters),\n  };\n\n  if (formParams.has(\"sort_by\")) {\n    change.sortKey = parsed.sortKey;\n    change.reverse = parsed.reverse;\n  }\n\n  applyBrowseChange(context, change);\n}\n\nfunction toggleFilterInput(context: CollectionStoreContext, input: string): void {\n  let parsed: ProductFilter;\n  try {\n    parsed = JSON.parse(input) as ProductFilter;\n  } catch {\n    return;\n  }\n  toggleFilter(context, parsed);\n}\n\nfunction setSortByValue(context: CollectionStoreContext, sortByValue: string): void {\n  const { sortKey, reverse } = parseSortByValue(sortByValue);\n  applyBrowseChange(context, {\n    sortKey: sortKey ?? \"COLLECTION_DEFAULT\",\n    reverse: reverse ?? false,\n  });\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,6 @@
+import { ProductCollectionSortKeys } from "../../graphql/generated/storefront-api-types.mjs";
+import { ProductFilter } from "../../vendor/standard-events.mjs";
+import { AvailableFilter, AvailableFilterValue, CollectionState, FilterPresentation, FilterType, createInitialCollectionState } from "./state.mjs";
+import { CollectionData, CollectionStore, CreateCollectionStoreOptions, createCollectionStore } from "./collection.mjs";
+import { CollectionReconciler, ReconcilerCallbacks, createCollectionReconciler } from "./reconciler.mjs";
+import { CollectionParams, filterEquals, getFilterRemovalUrl, getSortByValue, isFilterInputActive, normalizeCollectionSearch, parseCollectionParams, parseSortByValue, serializeCollectionParams } from "./url.mjs";

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

@@ -0,0 +1,32 @@
+import { CollectionStore } from "./collection.mjs";
+
+//#region src/core/collection/reconciler.d.ts
+type ReconcilerCallbacks = {
+  getStore: () => CollectionStore;
+  readUrlSearch: () => string;
+  emitChange: (searchString: string) => void;
+};
+type CollectionReconciler = {
+  /**
+   * URL ↔ store reconciliation state machine. Call whenever urlSearch,
+   * dataSearch, or store state changes.
+   */
+  reconcile(urlSearch: string, dataSearch: string): void;
+  /**
+   * Callback for {@link CollectionStore.setOnBrowseChange}. Merges current
+   * URL params with store state, tracks the pending navigation, and emits.
+   */
+  handleBrowseChange(): void; /** Clears pending navigation state (call when the store is recreated). */
+  reset(newPrevUrlSearch: string): void;
+};
+/**
+ * Creates a framework-agnostic reconciler that manages the state machine for
+ * keeping the URL, server data, and store in sync during browse-change chains.
+ *
+ * Framework adapters delegate to this so the reconciliation logic
+ * lives in one place.
+ */
+declare function createCollectionReconciler(callbacks: ReconcilerCallbacks, initialPrevUrlSearch?: string): CollectionReconciler;
+//#endregion
+export { CollectionReconciler, ReconcilerCallbacks, createCollectionReconciler };
+//# sourceMappingURL=reconciler.d.mts.map