@weaverse/hydrogen 6.1.2 → 6.2.0

package/dist/{weaverse-client-D59mBW0j.mjs → weaverse-client-CXnM9ayH.mjs}

@@ -1,5 +1,5 @@
-import { a as getWeaverseConfigs, c as WeaverseError, d as hasWeaverseStudio, i as getRequestQueries, l as WeaverseLoadError, n as generateDataFromSchema, o as getStudioScriptSrc, p as isProjectIdFunction, r as getPreviewData, s as resolveStudioScriptSrc, t as getNestedKey, u as hasError } from "./nested-key-_k9aW_Wd.mjs";
-import { n as TranslationStore } from "./translation-store-BBrw0FOk.mjs";
+import { a as getPreviewData, c as getStudioScriptSrc, d as WeaverseLoadError, f as hasError, h as isProjectIdFunction, i as generateDataFromSchema, l as resolveStudioScriptSrc, n as TranslationStore, o as getRequestQueries, p as hasWeaverseStudio, s as getWeaverseConfigs, u as WeaverseError } from "./translation-store-JFs-4lvf.mjs";
+import { t as createTranslate } from "./translate-Celryv8j.mjs";
 import { StudioSelectionStore, StudioSelectionStoreContext, Weaverse, WeaverseItemStore, WeaverseRoot, isBrowser, loadScript, useSafeExternalStore } from "@weaverse/react";
 import { createSchema } from "@weaverse/schema";
 import { Suspense, createContext, memo, useContext, useEffect, useMemo, useRef, useState } from "react";
@@ -8,62 +8,11 @@ import { Cache, createFetchWithCache, getSelectedProductOptions } from "@shopify
 import { ErrorBoundary } from "react-error-boundary";
 import { Await, useLoaderData, useLocation, useMatches, useNavigate, useNavigation, useRevalidator, useRouteLoaderData } from "react-router";
 //#region src/hooks/translation-context.tsx
-/**
-* Replace `{{variable}}` patterns in a string with provided values.
-*
-* @example
-* interpolate('Hello {{name}}!', { name: 'World' }) // => 'Hello World!'
-* interpolate('-{{percentage}}% Off', { percentage: 15 }) // => '-15% Off'
-*/
-function interpolate(template, variables) {
-	if (!variables) return template;
-	return template.replace(/\{\{(\w+)\}\}/g, (match, key) => {
-		const value = variables[key];
-		return value === void 0 ? match : String(value);
-	});
-}
 const TranslationContext = createContext(null);
 TranslationContext.displayName = "WeaverseTranslationContext";
-/**
-* Build the `t()` translation function over a fixed set of sources.
-*
-* Resolution order, highest priority first:
-* 1. `externalT`         – host i18n (e.g. Shopify), unless it echoes the key
-* 2. `designOverrides`   – live design-mode edits, flat dot-path keys
-* 3. `merchantOverrides` – locale overrides from the API, nested
-* 4. `staticContent`     – the theme's default locale JSON
-* 5. the key itself
-*
-* Design overrides are looked up per-key (own properties only) rather than
-* merged into `merchantOverrides`: a flat key like `cart.title` must override
-* exactly that leaf without wiping sibling keys (`cart.subtitle`), and a
-* per-key own-property lookup never builds nested objects from
-* merchant-controlled keys, so it cannot pollute `Object.prototype`.
-*/
-function createTranslate(sources) {
-	const { staticContent, merchantOverrides, designOverrides, externalT } = sources;
-	return (key, variables) => {
-		if (externalT) {
-			const external = externalT(key, variables);
-			if (external && external !== key) return external;
-		}
-		const design = designOverrides && Object.hasOwn(designOverrides, key) ? designOverrides[key] : void 0;
-		const override = merchantOverrides ? getNestedKey(merchantOverrides, key) : void 0;
-		const staticValue = getNestedKey(staticContent, key);
-		return interpolate(design ?? override ?? staticValue ?? key, variables);
-	};
-}
 const EMPTY = {};
 const NOOP_SUBSCRIBE = () => () => {};
 const NOOP_SNAPSHOT = () => EMPTY;
-/**
-* Provider that wraps the app to expose the `t()` function.
-*
-* - `staticContent`      – the theme's default locale JSON (from themeSchema.i18n)
-* - `merchantOverrides`  – locale-specific overrides fetched from the API
-* - `translationStore`   – optional store for live design-mode text overrides
-*   (the deprecated `themeTextStore` prop is accepted as a fallback)
-*/
 function TranslationProvider({ staticContent, merchantOverrides, t: externalT, translationStore, themeTextStore, children }) {
 	const store = translationStore ?? themeTextStore ?? null;
 	const designOverrides = useSafeExternalStore(store?.subscribe ?? NOOP_SUBSCRIBE, store?.getSnapshot ?? NOOP_SNAPSHOT, store?.getServerSnapshot ?? NOOP_SNAPSHOT);
@@ -89,55 +38,15 @@ function TranslationProvider({ staticContent, merchantOverrides, t: externalT, t
 		children
 	});
 }
-/**
-* Hook to access the translation `t()` function.
-*
-* Must be used inside a component wrapped by `withWeaverse` or `TranslationProvider`.
-*
-* @example
-* ```tsx
-* function CartTitle() {
-*   const { t } = useTranslation()
-*   return <h2>{t('cart.title')}</h2>
-* }
-* ```
-*/
 function useTranslation() {
 	const ctx = useContext(TranslationContext);
 	if (!ctx) throw new Error("useTranslation must be used within <TranslationProvider>. Wrap your app with withWeaverse().");
 	return ctx;
 }
-/**
-* Legacy name for {@link TranslationProvider}.
-* @deprecated Use {@link TranslationProvider} instead.
-*/
 const ThemeTextProvider = TranslationProvider;
-/**
-* Legacy name for {@link useTranslation}.
-* @deprecated Use {@link useTranslation} instead.
-*/
 const useThemeText = useTranslation;
 //#endregion
 //#region src/seo.ts
-/**
-* Convert a Weaverse page-level SEO payload into React Router
-* `MetaDescriptor[]`. Pure, synchronous, tree-shakeable — does not fetch.
-*
-* Behavior:
-* - `title` → top-level `{ title }` descriptor.
-* - `description` / `keywords` → `<meta name="...">`.
-* - `canonicalUrl` → `<link rel="canonical">`.
-* - `openGraph.*` → `<meta property="og:*">`. `og:type` defaults to
-*   `'website'` when any other OG field is present.
-* - `twitter.*` → `<meta name="twitter:*">`. `twitter:card` defaults to
-*   `'summary'` when any other Twitter field is present.
-* - `robots` is always emitted (defaults to `'index,follow'`) so themes
-*   stacking multiple SEO sources have a deterministic last word on
-*   indexing for Weaverse-managed pages.
-* - Empty strings / missing fields are filtered before return so empty
-*   descriptors don't override earlier sources (e.g. Hydrogen
-*   `getSeoMeta`).
-*/
 function formatMetaDescriptors(seo) {
 	if (!seo) return [{
 		name: "robots",
@@ -204,38 +113,12 @@ function formatMetaDescriptors(seo) {
 	});
 	return descriptors;
 }
-/**
-* Convenience accessor: pull `page.seo` out of a `WeaverseLoaderData`
-* (or `WeaversePageData`) and emit `MetaDescriptor[]`. Null-safe.
-*
-* @example
-* ```ts
-* export const meta: MetaFunction<typeof loader> = ({ data }) => {
-*   return getWeaverseSeoMeta(data?.weaverseData)
-* }
-* ```
-*/
 function getWeaverseSeoMeta(data) {
 	if (!data) return formatMetaDescriptors(null);
 	return formatMetaDescriptors(("items" in data && "id" in data ? data : data.page ?? null)?.seo ?? null);
 }
 //#endregion
 //#region src/utils/product-options.ts
-/**
-* Filter out Weaverse-specific query parameters from product options.
-* Removes `isDesignMode` and any parameters starting with `weaverse` prefix.
-*
-* @param request - The incoming HTTP request
-* @returns Filtered product options for Shopify Hydrogen
-*
-* @example
-* ```typescript
-* export async function loader({ request }: LoaderFunctionArgs) {
-*   const selectedOptions = getSelectedProductOptions(request)
-*   // Use selectedOptions for product queries without Weaverse params
-* }
-* ```
-*/
 function getSelectedProductOptions$1(request) {
 	return getSelectedProductOptions({ searchParams: new URL(request.url).searchParams }).filter(({ name }) => name !== "isDesignMode" && !name.startsWith("weaverse"));
 }
@@ -251,7 +134,6 @@ function Main(props) {
 }
 //#endregion
 //#region src/components/index.ts
-/** Built-in components required to render the root of every Weaverse page. */
 let defaultComponents = [{
 	default: Main,
 	schema: createSchema({
@@ -261,68 +143,19 @@ let defaultComponents = [{
 }];
 //#endregion
 //#region src/hooks/use-weaverse-data-context.ts
-/**
-* Creates flat route-keyed structure from matches
-* Target: {root: {...rootData}, "routes/product": {...productData}}
-* Eliminates all duplication by using route IDs as keys
-*/
 function createFlatDataContext(matches) {
 	const context = {};
 	for (const match of matches) if (match.data && typeof match.data === "object") context[match.id] = match.data;
 	return context;
 }
-/**
-* Hook to get flat route-keyed data context from matches
-* Returns: {root: {...}, "routes/xxx": {...}}
-* No more useLoaderData dependency - everything comes from matches
-*/
 function useWeaverseDataContext() {
 	return createFlatDataContext(useMatches());
 }
-/**
-* Helper function to create flat route-keyed data context from useMatches() result
-* Returns: {root: {...}, "routes/xxx": {...}}
-*/
 function createWeaverseDataContext(matches) {
 	return createFlatDataContext(matches);
 }
 //#endregion
 //#region src/utils/pick-weaverse-data.ts
-/**
-* Resolve the `weaverseData` payload for a `<WeaverseHydrogenRoot>` instance.
-*
-* Resolution order (first match wins):
-*
-*  1. **Explicit prop** — the caller passed `data` directly. Used as-is,
-*     including when it is a `Promise` (handled upstream via `<Await>`) or
-*     an explicit `null` (suppresses rendering).
-*  2. **Own route's loader data** — the loader data for the route that
-*     rendered this component, obtained via `useLoaderData()`. This is
-*     React Router's route-scoped primitive and is what makes nested
-*     layout + child Weaverse pages work: each `<WeaverseContent />`
-*     resolves to *its own* route's `weaverseData` regardless of siblings.
-*  3. **Ancestor match fallback** — walk `useMatches()` from leaf to root
-*     and return the first ancestor whose `loaderData` exposes a
-*     `weaverseData` key. This preserves the long-standing behaviour where
-*     a child route with no loader (e.g. an `index.tsx` that omits
-*     `weaverseData`) still renders its layout's Weaverse page.
-*
-* The helper is intentionally pure (no hook calls) so it can be unit-tested
-* without a React Router context. Hook calls happen in the component.
-*
-* ## Back-compat contract
-*
-* Themes that pre-date the `data` prop addition pass `dataProp === undefined`,
-* so resolution starts at Tier 2. For the canonical single-instance pattern
-* (one `<WeaverseContent />` inside a route whose loader returns
-* `{ weaverseData }`), Tier 2 returns the same value the old `useMatches()`
-* walk did. For the index-without-loader pattern (leaf route exposes no
-* `weaverseData`, layout does), Tier 3's leaf→root walk produces an
-* identical result to the pre-fix code. The only intentional behaviour
-* change is the issue #451 case: two `<WeaverseContent />` instances on the
-* same URL (layout + child, both with their own `weaverseData`) now each
-* render their own page instead of both rendering the deepest one.
-*/
 function pickWeaverseData(dataProp, ownLoaderData, matches) {
 	if (dataProp !== void 0) return dataProp;
 	if (hasWeaverseData(ownLoaderData)) return ownLoaderData.weaverseData;
@@ -350,15 +183,6 @@ function getQueriesFromSearch(search) {
 	else queries[key] = value;
 	return queries;
 }
-/**
-* React Router v7 single-fetch revalidation can render client data returned
-* from a `*.data` request while the browser is still on the canonical URL.
-* Instance identity must follow the browser URL, not the transient data
-* endpoint, otherwise the SDK creates a fresh Weaverse instance mid-session:
-* in design mode that drops the existing Studio bridge/interactions, and in
-* the live theme it resets every section's runtime state after any
-* revalidation (cart mutations, locale switches, `revalidate()`). See #451.
-*/
 function normalizeRequestInfo(params, browserLocation = getBrowserLocation()) {
 	if (!browserLocation) return params;
 	let { pathname, search } = browserLocation;
@@ -375,50 +199,12 @@ function normalizeRequestInfo(params, browserLocation = getBrowserLocation()) {
 }
 //#endregion
 //#region src/utils/is-same-loader-payload.ts
-/**
-* Structural comparison used to detect whether a reused Weaverse instance
-* must adopt a fresh loader payload.
-*
-* `JSON.stringify` cannot do this job on the client:
-*
-* - Route loader data reaches `dataContext` unserialized, so deferred values
-*   are still `Promise`s. React 19 development builds hang an enumerable,
-*   self-referencing `_debugInfo` off those promises, and stringifying one
-*   throws `TypeError: Converting circular structure to JSON` during render
-*   (issue #511).
-* - In production every promise stringifies to `{}`, so a *fresh* deferred
-*   value looks unchanged and the reused instance keeps serving the previous
-*   render's promise. Tokenizing promises to a constant (`'[[promise]]'`) has
-*   the same defect — it is stable by construction, therefore blind to
-*   identity.
-*
-* Semantics, chosen deliberately:
-*
-* - **Promises/thenables are atomic**: compared by identity, never traversed.
-*   A fresh promise is a change; the same promise is not. Debug metadata is
-*   invisible to the comparison.
-* - **Opaque objects are atomic**: anything that is not a plain object, an
-*   array, or `toJSON`-serializable (`Map`, `Set`, `URL`, `RegExp`, streams,
-*   async iterators, cross-realm promises, class instances) is compared by
-*   identity. `JSON.stringify` flattens all of them to `{}`, which would
-*   silently collapse two distinct async values into "unchanged".
-* - **Cyclic graphs are compared coinductively**: a pair already being
-*   compared is assumed equal, so equal self/mutual cycles are equal while a
-*   differing leaf anywhere still reports a change. Nothing throws.
-* - **JSON-visible fields only**: `undefined`/function/symbol properties are
-*   omitted from objects and read as `null` in arrays, and NaN/±Infinity read
-*   as `null` — matching the previous `JSON.stringify` behavior for plain wire
-*   payloads. Key order is irrelevant, which removes the old "false mismatch
-*   costs a re-render" caveat.
-*/
-/** `JSON.stringify` drops these from objects and nulls them inside arrays. */
 function isJsonOmitted(value) {
 	return value === void 0 || typeof value === "function" || typeof value === "symbol";
 }
 function isObjectLike(value) {
 	return value !== null && typeof value === "object";
 }
-/** Duck-typed so cross-realm promises and hand-rolled thenables also match. */
 function isThenable(value) {
 	return typeof value.then === "function";
 }
@@ -426,15 +212,12 @@ function isPlainObject$1(value) {
 	const proto = Object.getPrototypeOf(value);
 	return proto === Object.prototype || proto === null;
 }
-/** Returns the `toJSON()` projection, or the value itself when there is none. */
 function toJsonValue(value) {
 	return typeof value.toJSON === "function" ? value.toJSON() : value;
 }
-/** Maps NaN/±Infinity to `null`, matching how `JSON.stringify` renders them. */
 function toFiniteOrNull(value) {
 	return typeof value === "number" && !Number.isFinite(value) ? null : value;
 }
-/** Compares two loader payloads for JSON-visible structural equality. */
 function isSameLoaderPayload(left, right) {
 	const activePairs = [];
 	function isSame(rawA, rawB) {
@@ -481,25 +264,6 @@ function isSameLoaderPayload(left, right) {
 }
 //#endregion
 //#region src/utils/sync-reused-instance.ts
-/**
-* Apply a fresh loader payload to a reused Weaverse instance.
-*
-* With requestInfo normalized to the browser URL, same-URL revalidations
-* (cart mutations, `useRevalidator()`, locale-neutral re-fetches) reuse the
-* cached `window.__weaverses[pageId]` instance instead of constructing a new
-* one — which preserves section state, but would silently drop the fresh
-* `data`/`dataContext` the loaders just returned. Sync them here.
-*
-* Design mode is excluded by the caller: Studio owns the instance data there
-* (unsaved drafts must not be clobbered) and applies updates via
-* `refreshStudio` instead.
-*
-* Change detection uses {@link isSameLoaderPayload}: a structural comparison
-* that treats promises/thenables and other opaque objects as atomic values
-* compared by identity, and tolerates cyclic graphs. `dataContext` carries
-* live route loader data — including unresolved deferred promises whose React
-* development metadata is cyclic — so it cannot be JSON-serialized here.
-*/
 function syncReusedInstance(weaverse, params) {
 	weaverse.requestInfo = params.requestInfo;
 	weaverse.internal = params.internal;
@@ -512,18 +276,13 @@ function syncReusedInstance(weaverse, params) {
 }
 //#endregion
 //#region src/utils/use-theme-settings-store.ts
-/** Mutable, subscribable store for theme settings received from the root loader. */
 var ThemeSettingsStore = class {
-	/** Current merged theme setting values. */
 	settings = {};
-	/** Theme schema exposed to Studio, when available. */
 	schema;
-	/** Storefront-safe environment values, when available. */
 	publicEnv;
 	listeners = /* @__PURE__ */ new Set();
 	hasWarnedListenerCount = false;
 	isDestroyed = false;
-	/** Creates a theme settings store from root-loader theme data. */
 	constructor(data) {
 		const { theme, schema, publicEnv } = data || {};
 		this.settings = { ...theme };
@@ -531,7 +290,6 @@ var ThemeSettingsStore = class {
 		this.publicEnv = publicEnv;
 		if (isBrowser) window.__weaverseThemeSettingsStore = this;
 	}
-	/** Merges setting changes into the current snapshot and notifies subscribers. */
 	updateThemeSettings = (newSettings) => {
 		if (this.isDestroyed) {
 			console.warn("ThemeSettingsStore: Cannot update destroyed store");
@@ -543,11 +301,8 @@ var ThemeSettingsStore = class {
 		};
 		this.emit();
 	};
-	/** Returns the current client snapshot for `useSyncExternalStore`. */
 	getSnapshot = () => this.settings;
-	/** Returns the current server snapshot for `useSyncExternalStore`. */
 	getServerSnapshot = () => this.settings;
-	/** Subscribes to setting changes and returns an unsubscribe callback. */
 	subscribe = (callback) => {
 		if (this.isDestroyed) {
 			console.warn("ThemeSettingsStore: Cannot subscribe to destroyed store");
@@ -571,7 +326,6 @@ var ThemeSettingsStore = class {
 			console.error("ThemeSettingsStore: Listener error", error);
 		}
 	};
-	/** Clears subscribers and detaches the browser-global store reference. */
 	destroy = () => {
 		if (this.isDestroyed) return;
 		this.listeners.clear();
@@ -611,12 +365,6 @@ function useThemeSettingsStore() {
 //#region src/utils/use-studio.ts
 const STUDIO_READY_POLL_MS = 50;
 const STUDIO_READY_TIMEOUT_MS = 5e3;
-/**
-* Resolve once `window.weaverseStudio` is available, or `null` on timeout.
-* The studio script sets the global when it *executes*; `loadScript` can
-* resolve earlier for tags it did not create (e.g. SSR-injected markup),
-* so never assume readiness right after the script promise settles.
-*/
 function waitForStudio() {
 	return new Promise((resolve) => {
 		let startedAt = Date.now();
@@ -631,34 +379,6 @@ function waitForStudio() {
 		check();
 	});
 }
-/**
-* Load the Studio bridge script on every design/preview render so Studio's
-* `checkWeaversePage()` handshake is answered instead of timing out — crucially
-* on routes where the page-scoped {@link useStudio} never mounts: 404s, error
-* boundaries, and non-Weaverse routes. The bridge registers its RPC endpoint
-* and `window.weaverseStudio` the moment the script executes, independent of any
-* page binding. Without this, a content-less route never loads the script and
-* Studio reports a false "Connection lost" instead of "this page has no Weaverse
-* content set up".
-*
-* `loadScript` is idempotent, so on content routes this coexists with the
-* page-scoped {@link useStudio} (same src) — that hook still binds the page via
-* `init`. Gating this on whether a route "has Weaverse data" is deliberately
-* avoided: route matches can't tell whether the page-scoped bridge actually
-* mounts (an `ErrorBoundary` replacing a data route, or data passed via the
-* `data` prop), and suppressing the script there would reintroduce the timeout
-* this fixes. Loading the script is harmless; it only registers the responder.
-*
-* Known limitation: on a route whose `weaverseData` is a deferred Promise, the
-* script can load before the page streams in, so `checkWeaversePage()` may
-* briefly observe `NOT_WEAVERSE_PAGE`. The complete fix is a "loading" state in
-* `checkWeaversePage` so the handshake retries rather than latching — that lives
-* in the Studio script, not here. Tracked in Weaverse/builder#2515.
-*
-* Mounted via {@link withWeaverse}, which must be the root route's `Layout`
-* export so the bridge renders even when a route's `ErrorBoundary` replaces the
-* page. Outside Studio (no design/preview params) it is a no-op.
-*/
 function useStudioConnect() {
 	let { search } = useLocation();
 	useEffect(() => {
@@ -714,16 +434,10 @@ function useStudio(weaverse) {
 }
 //#endregion
 //#region src/WeaverseHydrogenRoot.tsx
-/** Runtime store for one rendered Hydrogen component instance. */
 var WeaverseHydrogenItem = class extends WeaverseItemStore {
-	/**
-	* Cached merged snapshot (base + translations).
-	* Reset to `null` whenever `_store` or the item's translation entry changes.
-	*/
 	_cachedSnapshot = null;
 	_snapshotStoreRef = null;
 	_snapshotTranslationRef = null;
-	/** Creates an item store from serialized component data and its owner. */
 	constructor(initialData, weaverse) {
 		super(initialData, weaverse);
 		const { data, ...rest } = initialData;
@@ -734,26 +448,9 @@ var WeaverseHydrogenItem = class extends WeaverseItemStore {
 		const schemaData = generateDataFromSchema(this.Element.schema);
 		Object.assign(this._store, schemaData, data, rest);
 	}
-	/** Registered component definition for this item's type. */
 	get Element() {
 		return super.Element;
 	}
-	/**
-	* Override setData to flatten serialized `data` the same way the constructor
-	* does. Core's `initProject()` reuses item stores keyed by item id (identical
-	* ids across locales), and the inherited setData only shallow-merges the raw
-	* item — fresh settings would land under `_store.data` while the stale
-	* flattened values keep rendering.
-	*
-	* Schema defaults are re-applied ahead of incoming settings because a
-	* serialized payload can omit fields — or the optional `data` object itself —
-	* when values equal schema defaults. The stored nested `data` is also replaced
-	* so the public serialized state does not retain the previous locale payload.
-	*
-	* An empty update is the context-only refresh from `syncReusedInstance`: swap
-	* the store reference so memoized subscribers re-render, and leave the
-	* settings untouched.
-	*/
 	setData = (update) => {
 		let source = update ?? {};
 		let { data, ...rest } = source;
@@ -780,12 +477,6 @@ var WeaverseHydrogenItem = class extends WeaverseItemStore {
 		this.triggerUpdate();
 		return this.data;
 	};
-	/**
-	* Override getSnapShot to merge translation data when in translation mode.
-	* Memoizes the result: returns the same object reference as long as
-	* both `_store` and the translation entry haven't changed.
-	* This is critical for `useSyncExternalStore` stability.
-	*/
 	getSnapShot = () => {
 		const base = this._store;
 		const translations = this.weaverse.translationMap?.[this._id];
@@ -800,50 +491,22 @@ var WeaverseHydrogenItem = class extends WeaverseItemStore {
 	};
 };
 Weaverse.ItemConstructor = WeaverseHydrogenItem;
-/**
-* Hydrogen-specific Weaverse runtime that owns page data, component stores,
-* Studio state, and translation sidecars for one rendered page.
-*/
 var WeaverseHydrogen = class extends Weaverse {
-	/** Identifier of the rendered page. */
 	pageId;
-	/** Runtime services and project metadata exposed to integrations. */
 	internal;
-	/** Normalized URL and locale information for the current request. */
 	requestInfo;
-	/** Identifier of the project supplying the page. */
 	projectId;
-	/** Origin used for Studio assets and editor communication. */
 	weaverseHost;
-	/** Base URL used for public content API requests. */
 	weaverseApiBase;
-	/**
-	* API key read from environment/configuration for storefront requests or
-	* supplied by Studio requests while editing and previewing.
-	*/
 	weaverseApiKey;
-	/** Studio asset version supplied by the preview request. */
 	weaverseVersion;
-	/** Whether the page is running inside the visual editor. */
 	isDesignMode;
-	/** Whether a single component preview is being rendered. */
 	isPreviewMode;
-	/** Whether a saved page revision is being previewed. */
 	isRevisionPreview;
-	/** Component type requested by section preview mode. */
 	sectionType;
-	/**
-	* Translation map received from the builder in design mode.
-	* Keyed by item ID, each entry maps field names to translated values.
-	* `WeaverseHydrogenItem.getSnapShot()` merges these into the data
-	* returned to components, so translations render without monkey-patching.
-	*/
 	translationMap = {};
-	/** Locale code for the active translation sidecar. */
 	translationLocale = "";
-	/** Builder language identifier for the active translation sidecar. */
 	translationLanguageId = "";
-	/** Creates a page runtime from resolved loader data and request settings. */
 	constructor(params) {
 		const { internal, pageId, requestInfo, ...coreParams } = params;
 		super({ ...coreParams });
@@ -861,11 +524,6 @@ var WeaverseHydrogen = class extends Weaverse {
 		this.sectionType = params.sectionType || "";
 		this.extractTranslationSidecar();
 	}
-	/**
-	* Extract translation sidecar data from `this.data` (the page data).
-	* The builder attaches `translationMap`, `translationLocale`, and
-	* `translationLanguageId` to the page data in design mode.
-	*/
 	extractTranslationSidecar = () => {
 		const pageData = this.data;
 		if (pageData?.translationMap) {
@@ -874,21 +532,12 @@ var WeaverseHydrogen = class extends Weaverse {
 			this.translationLanguageId = pageData.translationLanguageId || "";
 		}
 	};
-	/**
-	* Set the translation sidecar data.
-	* Called by the studio bridge when translation data arrives or changes.
-	* Triggers a re-render of all items so translated snapshots are recalculated.
-	*/
 	setTranslationSidecar = (translationMap, locale, languageId) => {
 		this.translationMap = translationMap;
 		this.translationLocale = locale;
 		this.translationLanguageId = languageId;
 		this.refreshAllItems();
 	};
-	/**
-	* Update a single translation entry for a specific item field.
-	* Used by the studio bridge when the user edits a translatable field.
-	*/
 	updateTranslation = (itemId, key, originalValue, translatedValue) => {
 		if (!this.translationMap[itemId]) this.translationMap[itemId] = {};
 		this.translationMap[itemId] = {
@@ -901,10 +550,6 @@ var WeaverseHydrogen = class extends Weaverse {
 		const instance = this.itemInstances.get(itemId);
 		if (instance) instance.triggerUpdate();
 	};
-	/**
-	* Collect all translation changes across all weaverse instances.
-	* Used by the save flow to persist translation edits.
-	*/
 	getTranslationChanges = () => {
 		const entries = [];
 		const languageId = this.translationLanguageId;
@@ -921,9 +566,6 @@ var WeaverseHydrogen = class extends Weaverse {
 			entries
 		};
 	};
-	/**
-	* Override setProjectData to re-extract translation sidecar from new page data.
-	*/
 	setProjectData = (data) => {
 		this.data = data;
 		this.extractTranslationSidecar();
@@ -955,12 +597,6 @@ const StudioConnect = memo(() => {
 	useStudioConnect();
 	return null;
 });
-/**
-* Component lists already pushed into the element registry. Registration is
-* idempotent (the registry checks `has(type)`), but walking the full list
-* allocates and loops on every render — theme component arrays are
-* module-level constants, so register each list identity once.
-*/
 const registeredComponentLists = /* @__PURE__ */ new WeakSet();
 function RenderRoot(props) {
 	const { data, components, dataContext } = props;
@@ -986,36 +622,9 @@ function RenderRoot(props) {
 	});
 	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(WeaverseRoot, { context: weaverse }), /* @__PURE__ */ jsx(StudioBridge, { context: weaverse })] });
 }
-/**
-* Register a Weaverse component with the global element registry.
-* Must be called before rendering components in WeaverseHydrogenRoot.
-*
-* @param element - Component configuration with schema, Component, and optional loader
-*
-* @example
-* ```typescript
-* import Hero from './sections/Hero'
-* import { schema } from './sections/Hero'
-*
-* registerComponent({
-*   type: 'hero',
-*   Component: Hero,
-*   schema,
-*   loader: async ({ data, weaverse }) => {
-*     return { someData: 'value' }
-*   }
-* })
-* ```
-*/
 function registerComponent(element) {
 	WeaverseHydrogen.registerElement(element);
 }
-/**
-* Renders the Weaverse page for the current React Router route.
-*
-* Pass `data` to override automatic route-loader resolution. A promise is
-* handled with React Router's `Await`, while explicit `null` suppresses output.
-*/
 const WeaverseHydrogenRoot = memo(({ components, data: dataProp, errorComponent: ErrorComponent = ({ error }) => /* @__PURE__ */ jsx("div", { children: error instanceof Error ? error.message : "An unexpected error occurred" }) }) => {
 	const matches = useMatches();
 	const enhancedDataContext = useMemo(() => createWeaverseDataContext(matches), [matches]);
@@ -1046,33 +655,6 @@ const WeaverseHydrogenRoot = memo(({ components, data: dataProp, errorComponent:
 	}
 	return /* @__PURE__ */ jsx(ErrorComponent, { error: { message: "No Weaverse data found in route matches!" } });
 });
-/**
-* Higher-order component that wraps your app with Weaverse theme settings and
-* translation context, and mounts the Studio connect bridge.
-*
-* Export the result as your root route's **`Layout`** (not the default route
-* `Component`). In React Router the root `Layout` wraps both the matched route
-* and its `ErrorBoundary`, so the Studio bridge keeps rendering on 404s and
-* loader/render errors — exactly the pages where Studio must still answer its
-* handshake instead of reporting a false "Connection lost". A default-component
-* wrapper (`export default withWeaverse(App)`) is replaced by the error
-* boundary on those routes and would drop the bridge.
-*
-* @param Component - The root layout component to wrap
-* @param options   - Optional configuration (e.g. an external `t` function)
-* @returns Wrapped component with theme settings + translation providers
-*
-* @example
-* ```typescript
-* import { withWeaverse } from '@weaverse/hydrogen'
-*
-* // Basic usage — export as the root route Layout
-* export const Layout = withWeaverse(RootLayout)
-*
-* // With an external translation function
-* export const Layout = withWeaverse(RootLayout, { t: myI18nFunction })
-* ```
-*/
 function withWeaverse(Component, options) {
 	return (props) => {
 		const themeSettingsStore = useCreateThemeSettingsStore();
@@ -1095,10 +677,6 @@ function withWeaverse(Component, options) {
 		});
 	};
 }
-/**
-* Internal hook to read staticContent and merchantOverrides from root loader data.
-* Similar pattern to useThemeSettingsStore – reads from the 'root' route loader.
-*/
 function useTranslationData() {
 	const data = useRouteLoaderData("root");
 	return {
@@ -1106,22 +684,6 @@ function useTranslationData() {
 		merchantOverrides: data?.weaverseTheme?.merchantOverrides
 	};
 }
-/**
-* React hook to access Weaverse theme settings from anywhere in your component tree.
-* Must be used within a component wrapped by `withWeaverse` or inside `WeaverseHydrogenRoot`.
-*
-* @returns Current theme settings object
-*
-* @example
-* ```typescript
-* function MyComponent() {
-*   const theme = useThemeSettings()
-*   const primaryColor = theme.colors?.primary
-*
-*   return <div style={{ color: primaryColor }}>Styled content</div>
-* }
-* ```
-*/
 function useThemeSettings() {
 	const themeSettingsStore = useThemeSettingsStore();
 	return useSafeExternalStore(themeSettingsStore.subscribe, themeSettingsStore.getSnapshot, themeSettingsStore.getServerSnapshot);
@@ -1129,20 +691,6 @@ function useThemeSettings() {
 //#endregion
 //#region src/utils/normalize-page-url.ts
 const KEPT_PARAM_RE = /^(?:__revisionId|isDesignMode|weaverse)/;
-/**
-* Normalize the storefront URL sent in the Builder page API request body.
-*
-* The POST body participates in Hydrogen's cached fetch key, so a raw
-* `request.url` fragments the cache by every marketing/tracking param:
-* each distinct `?utm_…`/`fbclid` URL is a guaranteed Builder round-trip
-* even when the resolved page is identical — precisely the paid/social
-* traffic that needs the cache most (builder#2450).
-*
-* The Builder reads only the pathname (locale/type/handle fallback) and
-* the params matched above from this URL, so keep exactly those. Params
-* are sorted for a stable cache key regardless of their order in the
-* incoming URL.
-*/
 function normalizePageUrl(url) {
 	let parsed;
 	try {
@@ -1159,41 +707,18 @@ function normalizePageUrl(url) {
 }
 //#endregion
 //#region src/weaverse-client.ts
-/**
-* Cache duration constants (in seconds).
-* These values optimize CDN hit rates while maintaining fresh content.
-*/
 const CACHE_DURATIONS = {
-	/** Freshness for content that can change in Builder */
 	SHORT: 60,
-	/** Long stale window so slow Builder responses do not block storefront rendering */
 	LONG: 86400
 };
-/**
-* Network timeout for fetch requests (in milliseconds).
-* Default is 10 seconds to balance reliability and user experience.
-*/
 const DEFAULT_FETCH_TIMEOUT_MS = 1e4;
-/**
-* Bounded retry for the public API fetch. A single slow/cold origin response,
-* a transient 5xx, or a network blip would otherwise make loadPage return null
-* — rendering the "Please add new section" placeholder or throwing a 404 in
-* the route. Two attempts (one retry) is enough: by the time the first attempt
-* times out, the edge proxy's single-flight leader has usually populated its
-* versioned cache, so the retry lands on a warm HIT.
-*/
 const MAX_FETCH_ATTEMPTS = 2;
 const FETCH_RETRY_BACKOFF_MS = 300;
-/**
-* Retry only transient failures: request timeouts, network errors, and origin
-* 5xx. A 4xx is deterministic (e.g. a genuine 404) — retrying just wastes time.
-*/
 function isRetryableFetchError(error) {
 	if (!(error instanceof WeaverseError)) return false;
 	if (error.code === "TIMEOUT_ERROR" || error.code === "NETWORK_ERROR" || error.code === "INVALID_RESPONSE") return true;
 	return error.code === "FETCH_ERROR" && (error.statusCode ?? 0) >= 500;
 }
-/** Parses a JSON body, or returns the raw text when it is not JSON. */
 function parseResponseText(text) {
 	if (!text) return text;
 	try {
@@ -1205,31 +730,14 @@ function parseResponseText(text) {
 function isPlainObject(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-/**
-* Whether a successful `/project` body is a page envelope.
-*
-* `page: null` is Builder's authoritative "nothing assigned at this URL" and
-* stays valid; anything without a `page` field, with an `error` field, or with
-* a page that has no item list is not an answer about this URL at all.
-*/
 function isProjectEnvelope(payload) {
 	if (!isPlainObject(payload) || hasError(payload) || !("page" in payload)) return false;
 	const { page, project } = payload;
 	return (page === null || isPlainObject(page) && Array.isArray(page.items)) && (project == null || isPlainObject(project));
 }
-/**
-* Whether a successful `/project_configs` body carries theme settings.
-*
-* Builder always sends the `theme` field; `null` means the merchant never
-* saved settings, so schema defaults are the real configuration.
-*/
 function isThemeConfigsEnvelope(payload) {
 	return isPlainObject(payload) && !hasError(payload) && "theme" in payload && (payload.theme === null || isPlainObject(payload.theme));
 }
-/**
-* Classifies a page-load failure. `'absent'` is Builder's 404 for a project
-* that does not exist, which keeps resolving to `null` like before.
-*/
 function classifyPageLoadFailure(error) {
 	if (error instanceof WeaverseLoadError) return error.kind;
 	if (!(error instanceof WeaverseError)) return "invalid-response";
@@ -1242,24 +750,7 @@ function classifyPageLoadFailure(error) {
 	}
 	return "configuration";
 }
-/**
-* Validators for Builder requests made by this client itself, keyed on the
-* exact options object (same reasoning as `bodyFreeCacheRequests`). On the
-* cached path such a request rejects a non-2xx status instead of resolving
-* to `null`, and only stores a body its validator accepts. Every other
-* `fetchWithCache` caller keeps the existing behavior.
-*/
 const builderPayloadValidators = /* @__PURE__ */ new WeakMap();
-/**
-* Gives a rejection from Hydrogen's cached fetch the code `fetchOnce` gives
-* the same failure on the direct path.
-*
-* Hydrogen calls the platform `fetch` itself, so a request that never got a
-* response rejects with the platform's error instead of a `WeaverseError`.
-* The Fetch standard rejects a network failure with a `TypeError` and an
-* aborted request with the signal's `AbortError`/`TimeoutError`; those are
-* outages. Anything else is returned unchanged, so it is not reported as one.
-*/
 function cachedTransportError(error, url) {
 	if (error instanceof WeaverseError || !(error instanceof Error)) return error;
 	if (error.name === "AbortError" || error.name === "TimeoutError") return new WeaverseError("Request timed out", "TIMEOUT_ERROR", void 0, { url });
@@ -1269,89 +760,33 @@ function cachedTransportError(error, url) {
 	});
 	return error;
 }
-/**
-* Weaverse API version path
-*/
 const API_PATH = "v1";
-/**
-* Cache strategy for Weaverse API requests: fresh for a minute, then served
-* stale for a day while it refreshes or while Builder errors.
-*
-* Every Builder resource uses it. Hydrogen 2026.4's subrequest cache only read
-* `max-age` for freshness, so the old per-resource `sMaxAge` values never
-* changed how long an entry stayed fresh.
-*/
 const DEFAULT_CACHE_STRATEGY = Cache({
 	maxAge: CACHE_DURATIONS.SHORT,
 	staleWhileRevalidate: CACHE_DURATIONS.LONG,
 	staleIfError: CACHE_DURATIONS.LONG
 });
-/**
-* Options objects created by the internal `project_configs` request whose
-* subrequest cache identity deliberately excludes the body. Theme settings
-* carry the storefront origin so Builder can attribute hostnames; hashing the
-* body would give every domain of one project its own entry.
-*
-* The SUCCESSFUL theme payload is the same for every storefront of a project,
-* which is what makes one shared entry correct. This is not a claim that
-* Builder can never answer differently per host: a hostname-blocked request
-* returns a 403 `{ error }` body, and `shouldCacheResponse` rejects anything
-* `hasError()` matches, so a refusal is never stored under (or served from)
-* the shared entry. If a future response shape ever varies by host WITHOUT an
-* `error` field, this exclusion has to be revisited.
-*
-* Keyed on the exact options object, NOT on `cacheTarget`: `fetchWithCache`
-* is public API, so gating on the target would silently collapse the cache of
-* any consumer who selects `theme-settings` with varying bodies. An outside
-* caller's options object is never in this set and keeps a body-derived key.
-*
-* The WeakSet-membership slot in the cache key (`has(options)`) is the actual
-* discriminator — no caller-supplied value can reach it. The sentinel is not
-* load-bearing for that; it only keeps the omitted body legible in cache
-* debugging instead of a bare `undefined`.
-*/
 const bodyFreeCacheRequests = /* @__PURE__ */ new WeakSet();
 const BODY_FREE_CACHE_SENTINEL = "\0weaverse:body-free";
-/**
-* Request-scoped client for loading Weaverse pages and theme settings in Hydrogen.
-*
-* Create one client from the Hydrogen app context, then call
-* {@link WeaverseClient.loadPage} from route loaders and
-* {@link WeaverseClient.loadThemeSettings} from the root loader.
-*/
 var WeaverseClient = class {
-	/** Builder API version used by this client. */
 	API = API_PATH;
-	/** Stable project configuration shared by page requests. */
 	basePageConfigs;
-	/** Stable request body fields shared by page requests. */
 	basePageRequestBody;
-	/** Resolved project and rendering-mode configuration. */
 	configs;
-	/** Hydrogen cached fetch used for Builder API requests. */
 	cachedFetch;
-	/** Incoming request associated with this client instance. */
 	request;
-	/** Customer Account API client, when the storefront passes one. */
 	customerAccount;
-	/** Hydrogen Storefront API client and locale context. */
 	storefront;
-	/** Components registered for page rendering and component loaders. */
 	components;
-	/** Theme schema used for defaults and Studio editing. */
 	themeSchema;
-	/** Runtime environment variables. */
 	env;
-	/** Cache storage supplied by the Hydrogen runtime. */
 	cache;
-	/** Background execution hook supplied by the runtime. */
 	waitUntil;
 	parsedUrl;
 	componentsByType;
 	locale;
 	fetchTimeoutMs;
 	throwPageLoadFailures;
-	/** Creates a request-scoped client from the storefront's request context. */
 	constructor(args) {
 		this.request = args.request;
 		this.storefront = args.storefront;
@@ -1369,10 +804,6 @@ var WeaverseClient = class {
 		this.initializeCache(args);
 		this.initializeConfigs(args);
 	}
-	/**
-	* Initialize Hydrogen cache with proper configuration.
-	* Logs warning if waitUntil is missing.
-	*/
 	initializeCache(args) {
 		if (!args.waitUntil) console.warn("⚠️ WeaverseClient: waitUntil not provided, background operations may not complete");
 		this.cachedFetch = createFetchWithCache({
@@ -1380,10 +811,6 @@ var WeaverseClient = class {
 			waitUntil: args.waitUntil
 		});
 	}
-	/**
-	* Initialize configs with projectId resolution and fail-fast validation.
-	* Throws WeaverseError if projectId cannot be resolved.
-	*/
 	initializeConfigs(args) {
 		const baseConfigs = getWeaverseConfigs(args.request, args.env);
 		const resolvedProjectId = this.resolveProjectIdSync(args.projectId, args.request, args.env, baseConfigs);
@@ -1411,30 +838,9 @@ var WeaverseClient = class {
 		Object.freeze(this.basePageConfigs);
 		Object.freeze(this.basePageRequestBody);
 	}
-	/**
-	* Build component lookup map for O(1) access by type.
-	* Significantly improves performance for large component lists.
-	*/
 	buildComponentLookupMap(components) {
 		return new Map(components.map((comp) => [comp.schema?.type, comp]));
 	}
-	/**
-	* Extract comprehensive error information from unknown error type.
-	* Preserves error context, codes, and stack traces for debugging.
-	*
-	* @param error - Unknown error to extract information from
-	* @returns Structured error information with message, code, stack, and context
-	*
-	* @example
-	* ```typescript
-	* try {
-	*   // ... operation
-	* } catch (error) {
-	*   const errorInfo = this.extractErrorInfo(error)
-	*   console.error('Operation failed:', errorInfo.message, errorInfo.context)
-	* }
-	* ```
-	*/
 	extractErrorInfo(error) {
 		if (error instanceof WeaverseError) return {
 			message: error.message,
@@ -1448,22 +854,9 @@ var WeaverseClient = class {
 		};
 		return { message: String(error) };
 	}
-	/**
-	* Extract error message only (for backward compatibility).
-	* Use extractErrorInfo() for more detailed error information.
-	*
-	* @deprecated Use extractErrorInfo() instead to preserve error context
-	*/
 	extractErrorMessage(error) {
 		return this.extractErrorInfo(error).message;
 	}
-	/**
-	* Validates projectId format (alphanumeric, hyphens, underscores only).
-	* Returns detailed validation result with error message.
-	*
-	* @param projectId - Project identifier to validate
-	* @returns Validation result with error message if invalid
-	*/
 	validateProjectId(projectId) {
 		if (!projectId || projectId.trim() === "") return {
 			valid: false,
@@ -1475,30 +868,12 @@ var WeaverseClient = class {
 		};
 		return { valid: true };
 	}
-	/**
-	* Resolves projectId with multi-project architecture support.
-	* Uses priority chain to determine the correct project ID.
-	*
-	* @param projectId - Project identifier (string, function, or undefined)
-	* @param request - HTTP request for context access
-	* @param env - Hydrogen environment with variables
-	* @param baseConfigs - Pre-fetched base configs to avoid duplicate calls
-	* @returns Resolved project ID string (empty string if none found)
-	*/
 	resolveProjectIdSync(projectId, request, env, baseConfigs) {
 		return this.resolveFromQueryParams(request) || this.resolveFromFunction(projectId) || this.resolveFromString(projectId) || this.resolveFromEnvironment(baseConfigs, request, env) || "";
 	}
-	/**
-	* Priority 1: Resolve projectId from URL query parameters.
-	* Used for design mode and preview mode overrides.
-	*/
 	resolveFromQueryParams(request) {
 		return getRequestQueries(request).weaverseProjectId || null;
 	}
-	/**
-	* Priority 2: Resolve projectId from function parameter.
-	* Detects and rejects async functions with helpful error.
-	*/
 	resolveFromFunction(projectId) {
 		if (!isProjectIdFunction(projectId)) return null;
 		if (projectId.constructor.name === "AsyncFunction") throw new WeaverseError("Async projectId functions must be awaited before passing to WeaverseClient. Use: projectId: await getProjectAsync() instead of: projectId: getProjectAsync", "ASYNC_PROJECT_ID");
@@ -1517,9 +892,6 @@ var WeaverseClient = class {
 		}
 		return null;
 	}
-	/**
-	* Priority 3: Resolve projectId from explicit string parameter.
-	*/
 	resolveFromString(projectId) {
 		if (typeof projectId !== "string") return null;
 		const trimmed = projectId.trim();
@@ -1528,18 +900,11 @@ var WeaverseClient = class {
 		if (validation.valid) return trimmed;
 		throw new WeaverseError(validation.error || "Invalid projectId format", "INVALID_PROJECT_ID");
 	}
-	/**
-	* Priority 4: Resolve projectId from environment variables.
-	*/
 	resolveFromEnvironment(baseConfigs, request, env) {
 		const configs = baseConfigs || getWeaverseConfigs(request, env);
 		if (configs.projectId && configs.projectId.trim() !== "") return configs.projectId.trim();
 		return null;
 	}
-	/**
-	* Helper method for direct fetching in design mode.
-	* Includes 10-second timeout to prevent hanging requests.
-	*/
 	fetchOnce = async (url, options, timeoutMs) => {
 		const controller = new AbortController();
 		const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
@@ -1599,23 +964,6 @@ var WeaverseClient = class {
 		const { weaverseApiBase, weaverseHost } = this.configs;
 		return weaverseApiBase !== weaverseHost && url.startsWith(`${weaverseApiBase}/api/public/`);
 	}
-	/**
-	* Fetch data with caching support for both design mode and production.
-	* Uses direct fetch in design mode, Hydrogen's cached fetch in production.
-	* Automatically includes projectId in cache key for multi-project isolation.
-	*
-	* @param url - The URL to fetch from
-	* @param options - Fetch options including optional cache strategy
-	* @returns Promise resolving to the fetched data
-	*
-	* @example
-	* ```typescript
-	* const data = await weaverse.fetchWithCache<MyData>(
-	*   'https://api.example.com/data',
-	*   { method: 'POST', body: JSON.stringify({ key: 'value' }) }
-	* )
-	* ```
-	*/
 	fetchWithCache = async (url, options = {}) => {
 		const { cacheTarget, strategy: strategyOverride, ...fetchOptions } = options;
 		const { body } = fetchOptions;
@@ -1654,30 +1002,11 @@ var WeaverseClient = class {
 		}
 		return parseResponseText(text);
 	};
-	/**
-	* Safe origin of the incoming storefront request: scheme, host and explicit
-	* port. Userinfo, path, query and fragment are dropped, so no customer
-	* route or credential-bearing value leaves the storefront. Returns undefined
-	* for a non-http(s) request so the field is simply omitted.
-	*/
 	safeStorefrontOrigin() {
 		const { protocol, host } = this.parsedUrl;
 		if (protocol !== "http:" && protocol !== "https:") return;
 		return host ? `${protocol}//${host}` : void 0;
 	}
-	/**
-	* Load theme settings from Weaverse API with fallback to schema defaults.
-	* Merges remote settings with local theme schema and handles design mode serialization.
-	*
-	* @param strategy - Optional cache strategy override
-	* @returns Promise resolving to theme settings response
-	*
-	* @example
-	* ```typescript
-	* const settings = await weaverse.loadThemeSettings()
-	* const primaryColor = settings.theme.colors?.primary
-	* ```
-	*/
 	loadThemeSettings = async (strategy) => {
 		const defaultThemeSettings = generateDataFromSchema(this.themeSchema);
 		try {
@@ -1743,11 +1072,6 @@ var WeaverseClient = class {
 			};
 		}
 	};
-	/**
-	* Fetch locale-specific merchant overrides from the translation API.
-	* Returns a nested JSON object with translated values.
-	* Falls back to empty object on error to avoid blocking theme rendering.
-	*/
 	fetchMerchantOverrides = async (strategy) => {
 		try {
 			const { projectId, weaverseHost } = this.configs;
@@ -1769,13 +1093,6 @@ var WeaverseClient = class {
 			return;
 		}
 	};
-	/**
-	* Generate fallback page with default structure when page data is unavailable.
-	* Used internally when API returns no page or when page needs default content.
-	*
-	* @param message - Custom message to display in the fallback page
-	* @returns WeaversePageData with single main component containing the message
-	*/
 	generateFallbackPage = (message) => {
 		const rootId = crypto.randomUUID();
 		return {
@@ -1789,10 +1106,6 @@ var WeaverseClient = class {
 			}]
 		};
 	};
-	/**
-	* Fetch all published custom pages for sitemap generation.
-	* Paginates automatically, never throws, returns accumulated results on partial failure.
-	*/
 	async fetchCustomPages(opts) {
 		const { weaverseApiBase, projectId } = this.configs;
 		const entries = [];
@@ -1820,34 +1133,6 @@ var WeaverseClient = class {
 		console.warn("[Weaverse] Custom pages pagination cap reached (100 iterations)");
 		return entries;
 	}
-	/**
-	* Load page data from Weaverse API with optional route-level project override.
-	* Fetches page content, executes component loaders, and handles empty items fallback.
-	*
-	* @param params - Optional page loading parameters
-	* @param params.type - Page type (INDEX, PAGE, PRODUCT, COLLECTION, etc.)
-	* @param params.handle - Page handle for dynamic routes
-	* @param params.locale - Locale override
-	* @param params.projectId - Route-level project ID override (for multi-project)
-	* @param params.strategy - Custom cache strategy override
-	* @returns Promise resolving to page data or null on error
-	*
-	* @example
-	* ```typescript
-	* // Basic usage
-	* const data = await weaverse.loadPage()
-	*
-	* // With page type
-	* const data = await weaverse.loadPage({ type: 'INDEX' })
-	*
-	* // Route-level project override
-	* const data = await weaverse.loadPage({
-	*   type: 'PAGE',
-	*   handle: 'about',
-	*   projectId: 'campaign-project-123'
-	* })
-	* ```
-	*/
 	loadPage = async (params = {}) => {
 		if (params.projectId !== void 0) {
 			const message = typeof params.projectId === "string" ? this.validateProjectId(params.projectId).error : `must be a string. Received: ${typeof params.projectId}`;
@@ -1953,7 +1238,6 @@ var WeaverseClient = class {
 			throw new WeaverseLoadError("Unable to load Weaverse page", failure, error instanceof WeaverseError ? error.statusCode : void 0);
 		}
 	};
-	/** Executes the registered loader for one component and attaches its result. */
 	execComponentLoader = async (item) => {
 		const { data = {}, type, id } = item;
 		const component = this.componentsByType.get(type);
@@ -1977,6 +1261,6 @@ var WeaverseClient = class {
 	};
 };
 //#endregion
-export { useThemeText as _, registerComponent as a, createWeaverseDataContext as c, getSelectedProductOptions$1 as d, formatMetaDescriptors as f, interpolate as g, TranslationProvider as h, WeaverseHydrogenRoot as i, useWeaverseDataContext as l, ThemeTextProvider as m, WeaverseHydrogen as n, useThemeSettings as o, getWeaverseSeoMeta as p, WeaverseHydrogenItem as r, withWeaverse as s, WeaverseClient as t, defaultComponents as u, useTranslation as v };
+export { useTranslation as _, registerComponent as a, createWeaverseDataContext as c, getSelectedProductOptions$1 as d, formatMetaDescriptors as f, useThemeText as g, TranslationProvider as h, WeaverseHydrogenRoot as i, useWeaverseDataContext as l, ThemeTextProvider as m, WeaverseHydrogen as n, useThemeSettings as o, getWeaverseSeoMeta as p, WeaverseHydrogenItem as r, withWeaverse as s, WeaverseClient as t, defaultComponents as u };
 
-//# sourceMappingURL=weaverse-client-D59mBW0j.mjs.map
+//# sourceMappingURL=weaverse-client-CXnM9ayH.mjs.map