@shopify/hydrogen 2026.4.4 → 2026.10.0-preview.1

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

@@ -0,0 +1,224 @@
+import { createObservable } from "../observable.mjs";
+import { PREDICTIVE_SEARCH_API_PATH } from "./constants.mjs";
+import { getEmptyPredictiveSearchResult } from "./search.mjs";
+
+//#region src/core/predictive-search/store.ts
+/** Default delay before predictive search sends a request after a term changes. */
+const DEFAULT_PREDICTIVE_SEARCH_DEBOUNCE_IN_MS = 150;
+/** Default minimum trimmed term length required before predictive search sends a request. */
+const DEFAULT_PREDICTIVE_SEARCH_MIN_TERM_LENGTH = 1;
+function createPredictiveSearchStore(options = {}) {
+	const resolvedFetch = options.fetch ?? resolveGlobalFetch();
+	if (typeof resolvedFetch !== "function") throw new Error("No fetch function available. Pass a fetch option or ensure globalThis.fetch exists.");
+	const context = {
+		observable: createObservable(createInitialState()),
+		predictiveSearchEndpoint: options.predictiveSearchEndpoint ?? "/api/predictive-search",
+		debounceInMs: sanitizeDebounceInMs(options.debounceInMs),
+		minTermLength: sanitizeMinTermLength(options.minTermLength),
+		fetch: resolvedFetch,
+		searchOptions: {
+			limit: options.limit,
+			limitScope: options.limitScope,
+			types: options.types,
+			searchableFields: options.searchableFields,
+			unavailableProducts: options.unavailableProducts
+		},
+		abortController: null,
+		debounceTimer: null,
+		requestId: 0,
+		pendingResolve: null,
+		destroyed: false
+	};
+	return {
+		connect: () => connect(context),
+		getState: () => context.observable.state,
+		subscribe: (listener) => context.observable.subscribe(listener),
+		search: (term) => search(context, term),
+		clear: () => clear(context),
+		destroy: () => destroy(context)
+	};
+}
+function connect(context) {
+	context.destroyed = false;
+}
+function resolveGlobalFetch() {
+	if (typeof globalThis.fetch !== "function") return void 0;
+	return globalThis.fetch.bind(globalThis);
+}
+function sanitizeDebounceInMs(debounceInMs) {
+	if (typeof debounceInMs !== "number") return 150;
+	if (!Number.isFinite(debounceInMs)) return 150;
+	if (debounceInMs < 0) return 150;
+	return Math.trunc(debounceInMs);
+}
+function sanitizeMinTermLength(minTermLength) {
+	if (typeof minTermLength !== "number") return DEFAULT_PREDICTIVE_SEARCH_MIN_TERM_LENGTH;
+	if (!Number.isFinite(minTermLength)) return DEFAULT_PREDICTIVE_SEARCH_MIN_TERM_LENGTH;
+	if (minTermLength < 0) return DEFAULT_PREDICTIVE_SEARCH_MIN_TERM_LENGTH;
+	return Math.trunc(minTermLength);
+}
+function createInitialState() {
+	return {
+		term: "",
+		status: "idle",
+		result: getEmptyPredictiveSearchResult(""),
+		error: null
+	};
+}
+function search(context, term) {
+	resolvePending(context);
+	cancelScheduledWork(context);
+	if (context.destroyed) return Promise.resolve();
+	const trimmedTerm = term.trim();
+	if (trimmedTerm.length < context.minTermLength) {
+		resetState(context, trimmedTerm);
+		return Promise.resolve();
+	}
+	return new Promise((resolve) => {
+		context.pendingResolve = resolve;
+		context.requestId += 1;
+		context.observable.setState({
+			...context.observable.state,
+			term: trimmedTerm,
+			status: "loading",
+			error: null
+		});
+		scheduleSearch(context, trimmedTerm, context.requestId);
+	});
+}
+function clear(context) {
+	context.requestId += 1;
+	resolvePending(context);
+	cancelScheduledWork(context);
+	resetState(context, "");
+}
+function destroy(context) {
+	context.destroyed = true;
+	context.requestId += 1;
+	resolvePending(context);
+	cancelScheduledWork(context);
+}
+function scheduleSearch(context, term, requestId) {
+	if (context.debounceInMs === 0) {
+		executeSearch(context, term, requestId);
+		return;
+	}
+	context.debounceTimer = setTimeout(() => {
+		context.debounceTimer = null;
+		executeSearch(context, term, requestId);
+	}, context.debounceInMs);
+}
+async function executeSearch(context, term, requestId) {
+	const abortController = new AbortController();
+	context.abortController = abortController;
+	try {
+		settleSuccess(context, requestId, await readResponse(await context.fetch(buildRequestUrl(context, term), { signal: abortController.signal })));
+	} catch (error) {
+		if (isAbortError(error)) return;
+		settleError(context, requestId, getErrorMessage(error));
+	}
+}
+async function readResponse(response) {
+	const body = await readJson(response);
+	if (response.ok) return body;
+	throw new Error(getResponseErrorMessage(body, response));
+}
+async function readJson(response) {
+	try {
+		return await response.json();
+	} catch {
+		return null;
+	}
+}
+function settleSuccess(context, requestId, result) {
+	if (!isActiveRequest(context, requestId)) return;
+	context.observable.setState({
+		term: result.term,
+		status: "success",
+		result,
+		error: null
+	});
+	finishActiveRequest(context);
+}
+function settleError(context, requestId, message) {
+	if (!isActiveRequest(context, requestId)) return;
+	context.observable.setState({
+		...context.observable.state,
+		status: "error",
+		error: message
+	});
+	finishActiveRequest(context);
+}
+function finishActiveRequest(context) {
+	context.abortController = null;
+	resolvePending(context);
+}
+function resetState(context, term) {
+	context.observable.setState({
+		term,
+		status: "idle",
+		result: getEmptyPredictiveSearchResult(term),
+		error: null
+	});
+}
+function cancelScheduledWork(context) {
+	clearDebounceTimer(context);
+	abortRequest(context);
+}
+function clearDebounceTimer(context) {
+	if (context.debounceTimer === null) return;
+	clearTimeout(context.debounceTimer);
+	context.debounceTimer = null;
+}
+function abortRequest(context) {
+	context.abortController?.abort();
+	context.abortController = null;
+}
+function resolvePending(context) {
+	context.pendingResolve?.();
+	context.pendingResolve = null;
+}
+function isActiveRequest(context, requestId) {
+	return !context.destroyed && context.requestId === requestId;
+}
+function buildRequestUrl(context, term) {
+	const url = new URL(context.predictiveSearchEndpoint, "https://hydrogen.local");
+	url.searchParams.set("q", term);
+	appendSearchOptions(url.searchParams, context.searchOptions);
+	if (URL.canParse(context.predictiveSearchEndpoint)) return url.href;
+	return `${url.pathname}${url.search}`;
+}
+function appendSearchOptions(searchParams, options) {
+	setOptionalParam(searchParams, "limit", options.limit);
+	setOptionalParam(searchParams, "limitScope", options.limitScope);
+	setOptionalParam(searchParams, "types", options.types?.join(","));
+	setOptionalParam(searchParams, "searchableFields", options.searchableFields?.join(","));
+	setOptionalParam(searchParams, "unavailableProducts", options.unavailableProducts);
+}
+function setOptionalParam(searchParams, name, value) {
+	if (value === void 0) return;
+	searchParams.set(name, String(value));
+}
+function getResponseErrorMessage(body, response) {
+	const message = getNestedErrorMessage(body);
+	if (message) return message;
+	return `Predictive search request failed with status ${response.status}`;
+}
+function getNestedErrorMessage(body) {
+	if (!body || typeof body !== "object") return null;
+	if (!("error" in body)) return null;
+	const error = body.error;
+	if (!error || typeof error !== "object") return null;
+	if (!("message" in error)) return null;
+	return typeof error.message === "string" ? error.message : null;
+}
+function getErrorMessage(error) {
+	return error instanceof Error ? error.message : "Predictive search request failed";
+}
+function isAbortError(error) {
+	return error instanceof DOMException && error.name === "AbortError";
+}
+
+//#endregion
+export { createPredictiveSearchStore };
+//# sourceMappingURL=store.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.mjs","names":[],"sources":["../../../../src/core/predictive-search/store.ts"],"sourcesContent":["import type {\n  PredictiveSearchLimitScope,\n  PredictiveSearchType,\n  SearchUnavailableProductsType,\n  SearchableField,\n} from \"../../graphql/generated/storefront-api-types\";\nimport { createObservable } from \"../observable\";\nimport { PREDICTIVE_SEARCH_API_PATH, PREDICTIVE_SEARCH_QUERY_PARAM } from \"./constants\";\nimport { getEmptyPredictiveSearchResult, type PredictiveSearchData } from \"./search\";\n\n/** Default delay before predictive search sends a request after a term changes. */\nexport const DEFAULT_PREDICTIVE_SEARCH_DEBOUNCE_IN_MS = 150;\n\n/** Default minimum trimmed term length required before predictive search sends a request. */\nconst DEFAULT_PREDICTIVE_SEARCH_MIN_TERM_LENGTH = 1;\n\n/** Lifecycle state for the predictive search client store. */\nexport type PredictiveSearchStatus = \"idle\" | \"loading\" | \"success\" | \"error\";\n\n/** Current predictive search snapshot exposed to UI bindings. */\nexport type PredictiveSearchState<TData extends PredictiveSearchData = PredictiveSearchData> = {\n  /** Latest trimmed search term known to the store. */\n  term: string;\n  /** Request lifecycle state for the current term. */\n  status: PredictiveSearchStatus;\n  /** Predictive search data for the current term, or an empty result while idle. */\n  result: TData;\n  /** Error message for the latest failed request, or null when there is no active error. */\n  error: string | null;\n};\n\n/** Options for creating a framework-neutral predictive search client store. */\nexport type CreatePredictiveSearchStoreOptions = {\n  /**\n   * Same-origin JSON endpoint used for browser predictive-search requests.\n   *\n   * The endpoint must return JSON matching the data payload from\n   * `await predictiveSearchHandlers.get(...)`.\n   */\n  predictiveSearchEndpoint?: string;\n  /** Delay before sending a request after the term changes. */\n  debounceInMs?: number;\n  /** Minimum trimmed term length required before searching. */\n  minTermLength?: number;\n  /** Fetch implementation, injectable for tests and non-browser runtimes. */\n  fetch?: typeof globalThis.fetch;\n  /** Maximum result count requested from the Storefront API. */\n  limit?: number;\n  /** Whether `limit` applies to each result type or all result types combined. */\n  limitScope?: PredictiveSearchLimitScope;\n  /** Storefront API result types to include in predictive search. */\n  types?: PredictiveSearchType[];\n  /** Storefront API fields to search. */\n  searchableFields?: SearchableField[];\n  /** Storefront API unavailable-product behavior. */\n  unavailableProducts?: SearchUnavailableProductsType;\n};\n\n/** Framework-neutral predictive search store used by UI bindings. */\nexport type PredictiveSearchStore<TData extends PredictiveSearchData = PredictiveSearchData> = {\n  /** Reactivates store updates after destroy(). */\n  connect(): void;\n  /** Returns the current predictive search state snapshot. */\n  getState(): PredictiveSearchState<TData>;\n  /** Subscribes to state changes and returns an unsubscribe callback. */\n  subscribe(listener: (state: PredictiveSearchState<TData>) => void): () => void;\n  /** Searches for a term using the configured debounce and request lifecycle. */\n  search(term: string): Promise<void>;\n  /** Cancels pending work and resets the store to an empty state. */\n  clear(): void;\n  /** Cancels pending work and pauses store updates until reconnect. */\n  destroy(): void;\n};\n\ntype PredictiveSearchStoreContext<TData extends PredictiveSearchData> = {\n  observable: ReturnType<typeof createObservable<PredictiveSearchState<TData>>>;\n  // API route used to fetch predictive search results.\n  predictiveSearchEndpoint: string;\n  // Delay before firing a search request after the term changes.\n  debounceInMs: number;\n  // Minimum term length required before searching.\n  minTermLength: number;\n  // Fetch implementation, injectable for tests and non-browser runtimes.\n  fetch: typeof globalThis.fetch;\n  // Storefront API search options forwarded to the server handler.\n  searchOptions: StoreSearchOptions;\n  abortController: AbortController | null;\n  // Active debounce timer waiting to start the next search.\n  debounceTimer: ReturnType<typeof setTimeout> | null;\n  // Monotonic counter used to ignore responses from older requests.\n  requestId: number;\n  // Resolver for the current debounced search promise.\n  pendingResolve: (() => void) | null;\n  // Prevents future work after the store has been torn down.\n  destroyed: boolean;\n};\n\ntype StoreSearchOptions = Pick<\n  CreatePredictiveSearchStoreOptions,\n  \"limit\" | \"limitScope\" | \"types\" | \"searchableFields\" | \"unavailableProducts\"\n>;\n\nexport function createPredictiveSearchStore<\n  TData extends PredictiveSearchData = PredictiveSearchData,\n>(options: CreatePredictiveSearchStoreOptions = {}): PredictiveSearchStore<TData> {\n  // Prefer an injected fetch for tests and non-browser runtimes, then fall back to the ambient runtime fetch.\n  const resolvedFetch = options.fetch ?? resolveGlobalFetch();\n  if (typeof resolvedFetch !== \"function\") {\n    throw new Error(\n      \"No fetch function available. Pass a fetch option or ensure globalThis.fetch exists.\",\n    );\n  }\n\n  const context: PredictiveSearchStoreContext<TData> = {\n    observable: createObservable(createInitialState<TData>()),\n    predictiveSearchEndpoint: options.predictiveSearchEndpoint ?? PREDICTIVE_SEARCH_API_PATH,\n    debounceInMs: sanitizeDebounceInMs(options.debounceInMs),\n    minTermLength: sanitizeMinTermLength(options.minTermLength),\n    fetch: resolvedFetch,\n    searchOptions: {\n      limit: options.limit,\n      limitScope: options.limitScope,\n      types: options.types,\n      searchableFields: options.searchableFields,\n      unavailableProducts: options.unavailableProducts,\n    },\n    abortController: null,\n    debounceTimer: null,\n    requestId: 0,\n    pendingResolve: null,\n    destroyed: false,\n  };\n\n  return {\n    connect: () => connect(context),\n    getState: () => context.observable.state,\n    subscribe: (listener) => context.observable.subscribe(listener),\n    search: (term) => search(context, term),\n    clear: () => clear(context),\n    destroy: () => destroy(context),\n  };\n}\n\nfunction connect<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n): void {\n  context.destroyed = false;\n}\n\nfunction resolveGlobalFetch(): typeof globalThis.fetch | undefined {\n  if (typeof globalThis.fetch !== \"function\") return undefined;\n  return globalThis.fetch.bind(globalThis);\n}\n\nfunction sanitizeDebounceInMs(debounceInMs: number | undefined): number {\n  if (typeof debounceInMs !== \"number\") return DEFAULT_PREDICTIVE_SEARCH_DEBOUNCE_IN_MS;\n  if (!Number.isFinite(debounceInMs)) return DEFAULT_PREDICTIVE_SEARCH_DEBOUNCE_IN_MS;\n  if (debounceInMs < 0) return DEFAULT_PREDICTIVE_SEARCH_DEBOUNCE_IN_MS;\n  return Math.trunc(debounceInMs);\n}\n\nfunction sanitizeMinTermLength(minTermLength: number | undefined): number {\n  if (typeof minTermLength !== \"number\") return DEFAULT_PREDICTIVE_SEARCH_MIN_TERM_LENGTH;\n  if (!Number.isFinite(minTermLength)) return DEFAULT_PREDICTIVE_SEARCH_MIN_TERM_LENGTH;\n  if (minTermLength < 0) return DEFAULT_PREDICTIVE_SEARCH_MIN_TERM_LENGTH;\n  return Math.trunc(minTermLength);\n}\n\nfunction createInitialState<TData extends PredictiveSearchData>(): PredictiveSearchState<TData> {\n  return {\n    term: \"\",\n    status: \"idle\",\n    result: getEmptyPredictiveSearchResult(\"\") as TData,\n    error: null,\n  };\n}\n\nfunction search<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n  term: string,\n): Promise<void> {\n  resolvePending(context);\n  cancelScheduledWork(context);\n\n  if (context.destroyed) return Promise.resolve();\n\n  const trimmedTerm = term.trim();\n  if (trimmedTerm.length < context.minTermLength) {\n    resetState(context, trimmedTerm);\n    return Promise.resolve();\n  }\n\n  return new Promise((resolve) => {\n    context.pendingResolve = resolve;\n    context.requestId += 1;\n    context.observable.setState({\n      ...context.observable.state,\n      term: trimmedTerm,\n      status: \"loading\",\n      error: null,\n    });\n    scheduleSearch(context, trimmedTerm, context.requestId);\n  });\n}\n\nfunction clear<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n): void {\n  context.requestId += 1;\n  resolvePending(context);\n  cancelScheduledWork(context);\n  resetState(context, \"\");\n}\n\nfunction destroy<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n): void {\n  context.destroyed = true;\n  context.requestId += 1;\n  resolvePending(context);\n  cancelScheduledWork(context);\n}\n\nfunction scheduleSearch<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n  term: string,\n  requestId: number,\n): void {\n  if (context.debounceInMs === 0) {\n    void executeSearch(context, term, requestId);\n    return;\n  }\n\n  context.debounceTimer = setTimeout(() => {\n    context.debounceTimer = null;\n    void executeSearch(context, term, requestId);\n  }, context.debounceInMs);\n}\n\nasync function executeSearch<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n  term: string,\n  requestId: number,\n): Promise<void> {\n  const abortController = new AbortController();\n  context.abortController = abortController;\n\n  try {\n    const response = await context.fetch(buildRequestUrl(context, term), {\n      signal: abortController.signal,\n    });\n    const result = await readResponse<TData>(response);\n    settleSuccess(context, requestId, result);\n  } catch (error) {\n    if (isAbortError(error)) return;\n    settleError(context, requestId, getErrorMessage(error));\n  }\n}\n\nasync function readResponse<TData extends PredictiveSearchData>(\n  response: Response,\n): Promise<TData> {\n  const body = await readJson(response);\n  if (response.ok) return body as TData;\n  throw new Error(getResponseErrorMessage(body, response));\n}\n\nasync function readJson(response: Response): Promise<unknown> {\n  try {\n    return await response.json();\n  } catch {\n    return null;\n  }\n}\n\nfunction settleSuccess<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n  requestId: number,\n  result: TData,\n): void {\n  if (!isActiveRequest(context, requestId)) return;\n  context.observable.setState({\n    term: result.term,\n    status: \"success\",\n    result,\n    error: null,\n  });\n  finishActiveRequest(context);\n}\n\nfunction settleError<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n  requestId: number,\n  message: string,\n): void {\n  if (!isActiveRequest(context, requestId)) return;\n  context.observable.setState({\n    ...context.observable.state,\n    status: \"error\",\n    error: message,\n  });\n  finishActiveRequest(context);\n}\n\nfunction finishActiveRequest<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n): void {\n  context.abortController = null;\n  resolvePending(context);\n}\n\nfunction resetState<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n  term: string,\n): void {\n  context.observable.setState({\n    term,\n    status: \"idle\",\n    result: getEmptyPredictiveSearchResult(term) as TData,\n    error: null,\n  });\n}\n\nfunction cancelScheduledWork<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n): void {\n  clearDebounceTimer(context);\n  abortRequest(context);\n}\n\nfunction clearDebounceTimer<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n): void {\n  if (context.debounceTimer === null) return;\n  clearTimeout(context.debounceTimer);\n  context.debounceTimer = null;\n}\n\nfunction abortRequest<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n): void {\n  context.abortController?.abort();\n  context.abortController = null;\n}\n\nfunction resolvePending<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n): void {\n  context.pendingResolve?.();\n  context.pendingResolve = null;\n}\n\nfunction isActiveRequest<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n  requestId: number,\n): boolean {\n  return !context.destroyed && context.requestId === requestId;\n}\n\nfunction buildRequestUrl<TData extends PredictiveSearchData>(\n  context: PredictiveSearchStoreContext<TData>,\n  term: string,\n): string {\n  const url = new URL(context.predictiveSearchEndpoint, \"https://hydrogen.local\");\n  url.searchParams.set(PREDICTIVE_SEARCH_QUERY_PARAM, term);\n  appendSearchOptions(url.searchParams, context.searchOptions);\n  if (URL.canParse(context.predictiveSearchEndpoint)) return url.href;\n  return `${url.pathname}${url.search}`;\n}\n\nfunction appendSearchOptions(searchParams: URLSearchParams, options: StoreSearchOptions): void {\n  setOptionalParam(searchParams, \"limit\", options.limit);\n  setOptionalParam(searchParams, \"limitScope\", options.limitScope);\n  setOptionalParam(searchParams, \"types\", options.types?.join(\",\"));\n  setOptionalParam(searchParams, \"searchableFields\", options.searchableFields?.join(\",\"));\n  setOptionalParam(searchParams, \"unavailableProducts\", options.unavailableProducts);\n}\n\nfunction setOptionalParam(\n  searchParams: URLSearchParams,\n  name: string,\n  value: number | string | undefined,\n): void {\n  if (value === undefined) return;\n  searchParams.set(name, String(value));\n}\n\nfunction getResponseErrorMessage(body: unknown, response: Response): string {\n  const message = getNestedErrorMessage(body);\n  if (message) return message;\n  return `Predictive search request failed with status ${response.status}`;\n}\n\nfunction getNestedErrorMessage(body: unknown): string | null {\n  if (!body || typeof body !== \"object\") return null;\n  if (!(\"error\" in body)) return null;\n\n  const error = body.error;\n  if (!error || typeof error !== \"object\") return null;\n  if (!(\"message\" in error)) return null;\n\n  return typeof error.message === \"string\" ? error.message : null;\n}\n\nfunction getErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : \"Predictive search request failed\";\n}\n\nfunction isAbortError(error: unknown): boolean {\n  return error instanceof DOMException && error.name === \"AbortError\";\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,41 @@
+import { ShopifyRouteTemplates } from "../standard-routes/types.mjs";
+import { PredictiveSearchData } from "./search.mjs";
+
+//#region src/core/predictive-search/url.d.ts
+type PredictiveSearchItems = PredictiveSearchData["items"];
+type PredictiveSearchProductItem = PredictiveSearchItems["products"][number];
+type PredictiveSearchCollectionItem = PredictiveSearchItems["collections"][number];
+type PredictiveSearchPageItem = PredictiveSearchItems["pages"][number];
+type PredictiveSearchArticleItem = PredictiveSearchItems["articles"][number];
+type PredictiveSearchQueryItem = PredictiveSearchItems["queries"][number];
+type PredictiveSearchResourceItem = PredictiveSearchProductItem | PredictiveSearchCollectionItem | PredictiveSearchPageItem | PredictiveSearchArticleItem;
+type PredictiveSearchItem = PredictiveSearchResourceItem | PredictiveSearchQueryItem;
+type PredictiveSearchItemUrlOptions = {
+  pathPrefix?: string;
+  routes: ShopifyRouteTemplates;
+  term: string;
+};
+type PredictiveSearchQueryItemUrlOptions = {
+  pathPrefix?: string;
+  routes?: ShopifyRouteTemplates;
+  searchPath?: string;
+};
+type SearchResultUrlOptions = {
+  baseUrl: string;
+  term: string;
+  trackingParameters?: string | null;
+  params?: Record<string, string>;
+  searchParamName?: string;
+};
+declare function getPredictiveSearchItemUrl(item: PredictiveSearchQueryItem, options?: PredictiveSearchQueryItemUrlOptions): string;
+declare function getPredictiveSearchItemUrl(item: PredictiveSearchResourceItem, options: PredictiveSearchItemUrlOptions): string;
+declare function getSearchResultUrl({
+  baseUrl,
+  term,
+  trackingParameters,
+  params,
+  searchParamName
+}: SearchResultUrlOptions): string;
+//#endregion
+export { PredictiveSearchArticleItem, PredictiveSearchCollectionItem, PredictiveSearchItem, PredictiveSearchItemUrlOptions, PredictiveSearchPageItem, PredictiveSearchProductItem, PredictiveSearchQueryItem, PredictiveSearchQueryItemUrlOptions, PredictiveSearchResourceItem, getPredictiveSearchItemUrl, getSearchResultUrl };
+//# sourceMappingURL=url.d.mts.map

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

@@ -0,0 +1,71 @@
+import { getStandardRoute } from "../standard-routes/build.mjs";
+
+//#region src/core/predictive-search/url.ts
+const RELATIVE_URL_BASE = "https://hydrogen.local";
+function getPredictiveSearchItemUrl(item, options) {
+	return getSearchResultUrl({
+		baseUrl: getPredictiveSearchItemBaseUrl(item, options),
+		term: getPredictiveSearchItemSearchTerm(item, options),
+		trackingParameters: item.trackingParameters
+	});
+}
+function getSearchResultUrl({ baseUrl, term, trackingParameters, params, searchParamName = "q" }) {
+	const url = new URL(baseUrl, RELATIVE_URL_BASE);
+	for (const [name, value] of Object.entries(params ?? {})) url.searchParams.set(name, value);
+	url.searchParams.set(searchParamName, term);
+	appendTrackingParameters(url.searchParams, trackingParameters);
+	if (isAbsoluteUrl(baseUrl)) return url.href;
+	return `${url.pathname}${url.search}${url.hash}`;
+}
+function getPredictiveSearchItemBaseUrl(item, options) {
+	if (item.__typename === "SearchQuerySuggestion") return getQueryBaseUrl(options);
+	const { pathPrefix, routes } = requirePredictiveSearchItemUrlOptions(options);
+	return getResourceBaseUrl(item, routes, pathPrefix);
+}
+function getQueryBaseUrl(options) {
+	if (options && "searchPath" in options && options.searchPath) return options.searchPath;
+	return getStandardRoute(options?.routes ?? {}, "search", {}, { pathPrefix: options?.pathPrefix });
+}
+function getResourceBaseUrl(item, routes, pathPrefix) {
+	switch (item.__typename) {
+		case "Product": return getProductBaseUrl(item, routes, pathPrefix);
+		case "Collection": return getCollectionBaseUrl(item, routes, pathPrefix);
+		case "Page": return getPageBaseUrl(item, routes, pathPrefix);
+		case "Article": return getArticleBaseUrl(item, routes, pathPrefix);
+	}
+}
+function getProductBaseUrl(product, routes, pathPrefix) {
+	return getStandardRoute(routes, "product", { productHandle: product.handle }, { pathPrefix });
+}
+function getCollectionBaseUrl(collection, routes, pathPrefix) {
+	return getStandardRoute(routes, "collection", { collectionHandle: collection.handle }, { pathPrefix });
+}
+function getPageBaseUrl(page, routes, pathPrefix) {
+	return getStandardRoute(routes, "page", { pageHandle: page.handle }, { pathPrefix });
+}
+function getArticleBaseUrl(article, routes, pathPrefix) {
+	return getStandardRoute(routes, "article", {
+		articleHandle: article.handle,
+		blogHandle: article.blog.handle
+	}, { pathPrefix });
+}
+function getPredictiveSearchItemSearchTerm(item, options) {
+	if (item.__typename === "SearchQuerySuggestion") return item.text;
+	return requirePredictiveSearchItemUrlOptions(options).term;
+}
+function requirePredictiveSearchItemUrlOptions(options) {
+	if (options && "term" in options && "routes" in options) return options;
+	throw new Error("Predictive search resource URLs require route templates and the typed search term.");
+}
+function appendTrackingParameters(params, trackingParameters) {
+	if (!trackingParameters) return;
+	const tracking = new URLSearchParams(trackingParameters);
+	for (const [name, value] of tracking) params.append(name, value);
+}
+function isAbsoluteUrl(url) {
+	return URL.canParse(url);
+}
+
+//#endregion
+export { getPredictiveSearchItemUrl, getSearchResultUrl };
+//# sourceMappingURL=url.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url.mjs","names":[],"sources":["../../../../src/core/predictive-search/url.ts"],"sourcesContent":["import { getStandardRoute, type ShopifyRouteTemplates } from \"../standard-routes/index\";\nimport type { PredictiveSearchData } from \"./search\";\n\nconst RELATIVE_URL_BASE = \"https://hydrogen.local\";\n\ntype PredictiveSearchItems = PredictiveSearchData[\"items\"];\n\nexport type PredictiveSearchProductItem = PredictiveSearchItems[\"products\"][number];\nexport type PredictiveSearchCollectionItem = PredictiveSearchItems[\"collections\"][number];\nexport type PredictiveSearchPageItem = PredictiveSearchItems[\"pages\"][number];\nexport type PredictiveSearchArticleItem = PredictiveSearchItems[\"articles\"][number];\nexport type PredictiveSearchQueryItem = PredictiveSearchItems[\"queries\"][number];\n\nexport type PredictiveSearchResourceItem =\n  | PredictiveSearchProductItem\n  | PredictiveSearchCollectionItem\n  | PredictiveSearchPageItem\n  | PredictiveSearchArticleItem;\n\nexport type PredictiveSearchItem = PredictiveSearchResourceItem | PredictiveSearchQueryItem;\n\nexport type PredictiveSearchItemUrlOptions = {\n  pathPrefix?: string;\n  routes: ShopifyRouteTemplates;\n  term: string;\n};\n\nexport type PredictiveSearchQueryItemUrlOptions = {\n  pathPrefix?: string;\n  routes?: ShopifyRouteTemplates;\n  searchPath?: string;\n};\n\ntype AnyPredictiveSearchItemUrlOptions =\n  | PredictiveSearchItemUrlOptions\n  | PredictiveSearchQueryItemUrlOptions;\n\ntype SearchResultUrlOptions = {\n  baseUrl: string;\n  term: string;\n  trackingParameters?: string | null;\n  params?: Record<string, string>;\n  searchParamName?: string;\n};\n\nexport function getPredictiveSearchItemUrl(\n  item: PredictiveSearchQueryItem,\n  options?: PredictiveSearchQueryItemUrlOptions,\n): string;\nexport function getPredictiveSearchItemUrl(\n  item: PredictiveSearchResourceItem,\n  options: PredictiveSearchItemUrlOptions,\n): string;\nexport function getPredictiveSearchItemUrl(\n  item: PredictiveSearchItem,\n  options?: AnyPredictiveSearchItemUrlOptions,\n): string {\n  return getSearchResultUrl({\n    baseUrl: getPredictiveSearchItemBaseUrl(item, options),\n    term: getPredictiveSearchItemSearchTerm(item, options),\n    trackingParameters: item.trackingParameters,\n  });\n}\n\nexport function getSearchResultUrl({\n  baseUrl,\n  term,\n  trackingParameters,\n  params,\n  searchParamName = \"q\",\n}: SearchResultUrlOptions): string {\n  const url = new URL(baseUrl, RELATIVE_URL_BASE);\n\n  for (const [name, value] of Object.entries(params ?? {})) {\n    url.searchParams.set(name, value);\n  }\n\n  url.searchParams.set(searchParamName, term);\n  appendTrackingParameters(url.searchParams, trackingParameters);\n\n  if (isAbsoluteUrl(baseUrl)) return url.href;\n  return `${url.pathname}${url.search}${url.hash}`;\n}\n\nfunction getPredictiveSearchItemBaseUrl(\n  item: PredictiveSearchItem,\n  options: AnyPredictiveSearchItemUrlOptions | undefined,\n): string {\n  if (item.__typename === \"SearchQuerySuggestion\") return getQueryBaseUrl(options);\n\n  const { pathPrefix, routes } = requirePredictiveSearchItemUrlOptions(options);\n  return getResourceBaseUrl(item, routes, pathPrefix);\n}\n\nfunction getQueryBaseUrl(options: AnyPredictiveSearchItemUrlOptions | undefined): string {\n  if (options && \"searchPath\" in options && options.searchPath) return options.searchPath;\n\n  return getStandardRoute(\n    options?.routes ?? {},\n    \"search\",\n    {},\n    {\n      pathPrefix: options?.pathPrefix,\n    },\n  );\n}\n\nfunction getResourceBaseUrl(\n  item: PredictiveSearchResourceItem,\n  routes: ShopifyRouteTemplates,\n  pathPrefix: string | undefined,\n): string {\n  switch (item.__typename) {\n    case \"Product\":\n      return getProductBaseUrl(item, routes, pathPrefix);\n    case \"Collection\":\n      return getCollectionBaseUrl(item, routes, pathPrefix);\n    case \"Page\":\n      return getPageBaseUrl(item, routes, pathPrefix);\n    case \"Article\":\n      return getArticleBaseUrl(item, routes, pathPrefix);\n  }\n}\n\nfunction getProductBaseUrl(\n  product: PredictiveSearchProductItem,\n  routes: ShopifyRouteTemplates,\n  pathPrefix: string | undefined,\n): string {\n  return getStandardRoute(routes, \"product\", { productHandle: product.handle }, { pathPrefix });\n}\n\nfunction getCollectionBaseUrl(\n  collection: PredictiveSearchCollectionItem,\n  routes: ShopifyRouteTemplates,\n  pathPrefix: string | undefined,\n): string {\n  return getStandardRoute(\n    routes,\n    \"collection\",\n    { collectionHandle: collection.handle },\n    { pathPrefix },\n  );\n}\n\nfunction getPageBaseUrl(\n  page: PredictiveSearchPageItem,\n  routes: ShopifyRouteTemplates,\n  pathPrefix: string | undefined,\n): string {\n  return getStandardRoute(routes, \"page\", { pageHandle: page.handle }, { pathPrefix });\n}\n\nfunction getArticleBaseUrl(\n  article: PredictiveSearchArticleItem,\n  routes: ShopifyRouteTemplates,\n  pathPrefix: string | undefined,\n): string {\n  return getStandardRoute(\n    routes,\n    \"article\",\n    { articleHandle: article.handle, blogHandle: article.blog.handle },\n    { pathPrefix },\n  );\n}\n\nfunction getPredictiveSearchItemSearchTerm(\n  item: PredictiveSearchItem,\n  options: AnyPredictiveSearchItemUrlOptions | undefined,\n): string {\n  if (item.__typename === \"SearchQuerySuggestion\") return item.text;\n  return requirePredictiveSearchItemUrlOptions(options).term;\n}\n\nfunction requirePredictiveSearchItemUrlOptions(\n  options: AnyPredictiveSearchItemUrlOptions | undefined,\n): PredictiveSearchItemUrlOptions {\n  if (options && \"term\" in options && \"routes\" in options) return options;\n\n  throw new Error(\n    \"Predictive search resource URLs require route templates and the typed search term.\",\n  );\n}\n\nfunction appendTrackingParameters(params: URLSearchParams, trackingParameters?: string | null) {\n  if (!trackingParameters) return;\n\n  const tracking = new URLSearchParams(trackingParameters);\n  for (const [name, value] of tracking) {\n    params.append(name, value);\n  }\n}\n\nfunction isAbsoluteUrl(url: string): boolean {\n  return URL.canParse(url);\n}\n"],"mappings":";;;AAGA,MAAM,oBAAoB;AAkD1B,SAAgB,2BACd,MACA,SACQ;AACR,QAAO,mBAAmB;EACxB,SAAS,+BAA+B,MAAM,QAAQ;EACtD,MAAM,kCAAkC,MAAM,QAAQ;EACtD,oBAAoB,KAAK;EAC1B,CAAC;;AAGJ,SAAgB,mBAAmB,EACjC,SACA,MACA,oBACA,QACA,kBAAkB,OACe;CACjC,MAAM,MAAM,IAAI,IAAI,SAAS,kBAAkB;AAE/C,MAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,UAAU,EAAE,CAAC,CACtD,KAAI,aAAa,IAAI,MAAM,MAAM;AAGnC,KAAI,aAAa,IAAI,iBAAiB,KAAK;AAC3C,0BAAyB,IAAI,cAAc,mBAAmB;AAE9D,KAAI,cAAc,QAAQ,CAAE,QAAO,IAAI;AACvC,QAAO,GAAG,IAAI,WAAW,IAAI,SAAS,IAAI;;AAG5C,SAAS,+BACP,MACA,SACQ;AACR,KAAI,KAAK,eAAe,wBAAyB,QAAO,gBAAgB,QAAQ;CAEhF,MAAM,EAAE,YAAY,WAAW,sCAAsC,QAAQ;AAC7E,QAAO,mBAAmB,MAAM,QAAQ,WAAW;;AAGrD,SAAS,gBAAgB,SAAgE;AACvF,KAAI,WAAW,gBAAgB,WAAW,QAAQ,WAAY,QAAO,QAAQ;AAE7E,QAAO,iBACL,SAAS,UAAU,EAAE,EACrB,UACA,EAAE,EACF,EACE,YAAY,SAAS,YACtB,CACF;;AAGH,SAAS,mBACP,MACA,QACA,YACQ;AACR,SAAQ,KAAK,YAAb;EACE,KAAK,UACH,QAAO,kBAAkB,MAAM,QAAQ,WAAW;EACpD,KAAK,aACH,QAAO,qBAAqB,MAAM,QAAQ,WAAW;EACvD,KAAK,OACH,QAAO,eAAe,MAAM,QAAQ,WAAW;EACjD,KAAK,UACH,QAAO,kBAAkB,MAAM,QAAQ,WAAW;;;AAIxD,SAAS,kBACP,SACA,QACA,YACQ;AACR,QAAO,iBAAiB,QAAQ,WAAW,EAAE,eAAe,QAAQ,QAAQ,EAAE,EAAE,YAAY,CAAC;;AAG/F,SAAS,qBACP,YACA,QACA,YACQ;AACR,QAAO,iBACL,QACA,cACA,EAAE,kBAAkB,WAAW,QAAQ,EACvC,EAAE,YAAY,CACf;;AAGH,SAAS,eACP,MACA,QACA,YACQ;AACR,QAAO,iBAAiB,QAAQ,QAAQ,EAAE,YAAY,KAAK,QAAQ,EAAE,EAAE,YAAY,CAAC;;AAGtF,SAAS,kBACP,SACA,QACA,YACQ;AACR,QAAO,iBACL,QACA,WACA;EAAE,eAAe,QAAQ;EAAQ,YAAY,QAAQ,KAAK;EAAQ,EAClE,EAAE,YAAY,CACf;;AAGH,SAAS,kCACP,MACA,SACQ;AACR,KAAI,KAAK,eAAe,wBAAyB,QAAO,KAAK;AAC7D,QAAO,sCAAsC,QAAQ,CAAC;;AAGxD,SAAS,sCACP,SACgC;AAChC,KAAI,WAAW,UAAU,WAAW,YAAY,QAAS,QAAO;AAEhE,OAAM,IAAI,MACR,qFACD;;AAGH,SAAS,yBAAyB,QAAyB,oBAAoC;AAC7F,KAAI,CAAC,mBAAoB;CAEzB,MAAM,WAAW,IAAI,gBAAgB,mBAAmB;AACxD,MAAK,MAAM,CAAC,MAAM,UAAU,SAC1B,QAAO,OAAO,MAAM,MAAM;;AAI9B,SAAS,cAAc,KAAsB;AAC3C,QAAO,IAAI,SAAS,IAAI"}

package/dist/development/core/product/form.d.mts

@@ -0,0 +1,63 @@
+import { ProductVariantInput } from "./state.mjs";
+
+//#region src/core/product/form.d.ts
+/** Props returned by {@link ProductFormRegister} for the `merchandiseId` input. */
+interface ProductMerchandiseIdProps {
+  name: "merchandiseId";
+  /** The currently selected variant ID, or an empty string when no variant is resolved. */
+  value: string;
+}
+/** Props returned by {@link ProductFormRegister} for a quantity input. */
+interface ProductQuantityProps {
+  name: "quantity";
+  value: string;
+}
+/** Props returned by {@link ProductFormRegister} for an uncontrolled quantity input. */
+interface ProductQuantityDefaultProps {
+  name: "quantity";
+  defaultValue: string;
+}
+/** Props returned by {@link ProductFormRegister} for a variant option value control. */
+interface ProductOptionValueProps {
+  name: string;
+  value: string;
+  onChange: () => void;
+  onClick: () => void;
+}
+/** Props returned by {@link ProductFormRegister} for the add-to-cart submit button. */
+interface ProductAddToCartProps {
+  name: "add-to-cart";
+  type: "submit";
+}
+/**
+ * Register function returned by `useProductForm`.
+ *
+ * Product forms only register product-relevant fields:
+ * `merchandiseId`, `quantity`, `optionValue`, and `addToCart`.
+ *
+ * Option values return form identity and activation handlers. UI props such as
+ * `type`, `checked`, `disabled`, and `aria-pressed` belong to the caller — use
+ * the state available on `options` (e.g. `value.selected`, `value.available`).
+ */
+type ProductFormRegister = {
+  (field: "merchandiseId", opts: {}): ProductMerchandiseIdProps;
+  (field: "quantity", opts: {
+    value: number;
+  }): ProductQuantityProps;
+  (field: "quantity", opts: {
+    defaultValue: number;
+  }): ProductQuantityDefaultProps;
+  (field: "optionValue", opts: {
+    optionName: string;
+    value: string;
+  }): ProductOptionValueProps;
+  (field: "addToCart", opts: {}): ProductAddToCartProps;
+};
+/**
+ * Creates a {@link ProductFormRegister} function bound to the current variant
+ * state and `selectOption` dispatcher.
+ */
+declare function createProductFormRegister(selectedVariant: ProductVariantInput | null, selectOption: (name: string, value: string) => void): ProductFormRegister;
+//#endregion
+export { ProductAddToCartProps, ProductFormRegister, ProductMerchandiseIdProps, ProductOptionValueProps, ProductQuantityDefaultProps, ProductQuantityProps, createProductFormRegister };
+//# sourceMappingURL=form.d.mts.map

package/dist/development/core/product/form.mjs

@@ -0,0 +1,44 @@
+//#region src/core/product/form.ts
+/**
+* Creates a {@link ProductFormRegister} function bound to the current variant
+* state and `selectOption` dispatcher.
+*/
+function createProductFormRegister(selectedVariant, selectOption) {
+	return ((field, opts) => {
+		if (field === "merchandiseId") return {
+			name: "merchandiseId",
+			value: selectedVariant?.id ?? ""
+		};
+		if (field === "quantity") {
+			if (typeof opts?.defaultValue === "number") return {
+				name: "quantity",
+				defaultValue: String(opts.defaultValue)
+			};
+			const value = typeof opts?.value === "number" ? opts.value : 1;
+			return {
+				name: "quantity",
+				value: String(value)
+			};
+		}
+		if (field === "optionValue") {
+			const optionName = String(opts?.optionName ?? "");
+			const value = String(opts?.value ?? "");
+			const handleSelect = () => selectOption(optionName, value);
+			return {
+				name: optionName,
+				value,
+				onChange: handleSelect,
+				onClick: handleSelect
+			};
+		}
+		if (field === "addToCart") return {
+			name: "add-to-cart",
+			type: "submit"
+		};
+		throw new Error(`Unknown product form field: "${field}".`);
+	});
+}
+
+//#endregion
+export { createProductFormRegister };
+//# sourceMappingURL=form.mjs.map

package/dist/development/core/product/form.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.mjs","names":[],"sources":["../../../../src/core/product/form.ts"],"sourcesContent":["import type { ProductVariantInput } from \"./state\";\n\n/** Props returned by {@link ProductFormRegister} for the `merchandiseId` input. */\nexport interface ProductMerchandiseIdProps {\n  name: \"merchandiseId\";\n  /** The currently selected variant ID, or an empty string when no variant is resolved. */\n  value: string;\n}\n\n/** Props returned by {@link ProductFormRegister} for a quantity input. */\nexport interface ProductQuantityProps {\n  name: \"quantity\";\n  value: string;\n}\n\n/** Props returned by {@link ProductFormRegister} for an uncontrolled quantity input. */\nexport interface ProductQuantityDefaultProps {\n  name: \"quantity\";\n  defaultValue: string;\n}\n\n/** Props returned by {@link ProductFormRegister} for a variant option value control. */\nexport interface ProductOptionValueProps {\n  name: string;\n  value: string;\n  onChange: () => void;\n  onClick: () => void;\n}\n\n/** Props returned by {@link ProductFormRegister} for the add-to-cart submit button. */\nexport interface ProductAddToCartProps {\n  name: \"add-to-cart\";\n  type: \"submit\";\n}\n\n/**\n * Register function returned by `useProductForm`.\n *\n * Product forms only register product-relevant fields:\n * `merchandiseId`, `quantity`, `optionValue`, and `addToCart`.\n *\n * Option values return form identity and activation handlers. UI props such as\n * `type`, `checked`, `disabled`, and `aria-pressed` belong to the caller — use\n * the state available on `options` (e.g. `value.selected`, `value.available`).\n */\nexport type ProductFormRegister = {\n  (field: \"merchandiseId\", opts: {}): ProductMerchandiseIdProps;\n  (field: \"quantity\", opts: { value: number }): ProductQuantityProps;\n  (field: \"quantity\", opts: { defaultValue: number }): ProductQuantityDefaultProps;\n  (field: \"optionValue\", opts: { optionName: string; value: string }): ProductOptionValueProps;\n  (field: \"addToCart\", opts: {}): ProductAddToCartProps;\n};\n\n/**\n * Creates a {@link ProductFormRegister} function bound to the current variant\n * state and `selectOption` dispatcher.\n */\nexport function createProductFormRegister(\n  selectedVariant: ProductVariantInput | null,\n  selectOption: (name: string, value: string) => void,\n): ProductFormRegister {\n  return ((field: string, opts?: Record<string, unknown>) => {\n    if (field === \"merchandiseId\") {\n      return { name: \"merchandiseId\", value: selectedVariant?.id ?? \"\" };\n    }\n\n    if (field === \"quantity\") {\n      if (typeof opts?.defaultValue === \"number\") {\n        return { name: \"quantity\" as const, defaultValue: String(opts.defaultValue) };\n      }\n      const value = typeof opts?.value === \"number\" ? opts.value : 1;\n      return { name: \"quantity\" as const, value: String(value) };\n    }\n\n    if (field === \"optionValue\") {\n      const optionName = String(opts?.optionName ?? \"\");\n      const value = String(opts?.value ?? \"\");\n      const handleSelect = () => selectOption(optionName, value);\n      return { name: optionName, value, onChange: handleSelect, onClick: handleSelect };\n    }\n\n    if (field === \"addToCart\") {\n      return { name: \"add-to-cart\", type: \"submit\" } satisfies ProductAddToCartProps;\n    }\n\n    throw new Error(`Unknown product form field: \"${field}\".`);\n  }) as ProductFormRegister;\n}\n"],"mappings":";;;;;AAyDA,SAAgB,0BACd,iBACA,cACqB;AACrB,UAAS,OAAe,SAAmC;AACzD,MAAI,UAAU,gBACZ,QAAO;GAAE,MAAM;GAAiB,OAAO,iBAAiB,MAAM;GAAI;AAGpE,MAAI,UAAU,YAAY;AACxB,OAAI,OAAO,MAAM,iBAAiB,SAChC,QAAO;IAAE,MAAM;IAAqB,cAAc,OAAO,KAAK,aAAa;IAAE;GAE/E,MAAM,QAAQ,OAAO,MAAM,UAAU,WAAW,KAAK,QAAQ;AAC7D,UAAO;IAAE,MAAM;IAAqB,OAAO,OAAO,MAAM;IAAE;;AAG5D,MAAI,UAAU,eAAe;GAC3B,MAAM,aAAa,OAAO,MAAM,cAAc,GAAG;GACjD,MAAM,QAAQ,OAAO,MAAM,SAAS,GAAG;GACvC,MAAM,qBAAqB,aAAa,YAAY,MAAM;AAC1D,UAAO;IAAE,MAAM;IAAY;IAAO,UAAU;IAAc,SAAS;IAAc;;AAGnF,MAAI,UAAU,YACZ,QAAO;GAAE,MAAM;GAAe,MAAM;GAAU;AAGhD,QAAM,IAAI,MAAM,gCAAgC,MAAM,IAAI"}

package/dist/development/core/product/index.d.mts

@@ -0,0 +1,4 @@
+import { ProductInput, ProductOptionInput, ProductOptionValueInput, ProductVariantFrom, ProductVariantInput, SelectedOption, VariantOptionState, VariantOptionValueState } from "./state.mjs";
+import { CreateProductFormStoreOptions, ProductFormErrors, ProductFormOptions, ProductFormStore, ProductFormStoreState, ValidProductSelectionResult, VariantSelectionResult, canAddToCart, createProductFormStore, findCartLineByMerchandiseId, getSelectedVariant } from "./product-form.mjs";
+import { getSelectedProductOptions } from "./options.mjs";
+import { ProductAddToCartProps, ProductFormRegister, ProductMerchandiseIdProps, ProductOptionValueProps, ProductQuantityDefaultProps, ProductQuantityProps, createProductFormRegister } from "./form.mjs";

package/dist/development/core/product/options.d.mts

@@ -0,0 +1,40 @@
+import { SelectedOption } from "./state.mjs";
+
+//#region src/core/product/options.d.ts
+/**
+ * Extracts selected product options from search params.
+ *
+ * Each query parameter is treated as an option name/value pair
+ * (e.g. `?Color=Red&Size=M` → `[{name:"Color",value:"Red"},{name:"Size",value:"M"}]`).
+ *
+ * When `allowedOptionNames` is provided, the search params are filtered to only
+ * entries whose decoded param name exactly matches a product option name.
+ * Passing an empty array filters out every option.
+ *
+ * Pass the result to `createProductFormStore` or `useProductForm` to pre-select
+ * the variant that matches the current URL.
+ *
+ * @example
+ * ```ts
+ * // Loader (React Router / Remix)
+ * const selectedOptions = getSelectedProductOptions({
+ *   searchParams: new URL(request.url).searchParams,
+ * });
+ *
+ * // Filter to known product option names when product data is available
+ * const selectedOptions = getSelectedProductOptions({
+ *   searchParams,
+ *   allowedOptionNames: product.options.map((option) => option.name),
+ * });
+ * ```
+ */
+declare function getSelectedProductOptions({
+  searchParams,
+  allowedOptionNames
+}: {
+  searchParams: URLSearchParams;
+  allowedOptionNames?: readonly string[];
+}): SelectedOption[];
+//#endregion
+export { getSelectedProductOptions };
+//# sourceMappingURL=options.d.mts.map