@weaverse/hydrogen 6.1.3 → 6.2.0

package/dist/{weaverse-client-C9IgIH7O.js → weaverse-client-BmceZc5q.js}

@@ -1,5 +1,5 @@
-const require_nested_key = require("./nested-key-CR3-YMFi.js");
-const require_translation_store = require("./translation-store-4fAV771j.js");
+const require_translation_store = require("./translation-store-BmGxBALf.js");
+const require_translate = require("./translate-Kt1BYL1n.js");
 let _weaverse_react = require("@weaverse/react");
 let _weaverse_schema = require("@weaverse/schema");
 let react = require("react");
@@ -8,67 +8,16 @@ let _shopify_hydrogen = require("@shopify/hydrogen");
 let react_error_boundary = require("react-error-boundary");
 let react_router = require("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 = (0, react.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 ? require_nested_key.getNestedKey(merchantOverrides, key) : void 0;
-		const staticValue = require_nested_key.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 = (0, _weaverse_react.useSafeExternalStore)(store?.subscribe ?? NOOP_SUBSCRIBE, store?.getSnapshot ?? NOOP_SNAPSHOT, store?.getServerSnapshot ?? NOOP_SNAPSHOT);
 	const value = (0, react.useMemo)(() => ({
-		t: createTranslate({
+		t: require_translate.createTranslate({
 			staticContent,
 			merchantOverrides,
 			designOverrides,
@@ -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 = (0, react.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(request) {
 	return (0, _shopify_hydrogen.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: (0, _weaverse_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((0, react_router.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 (_weaverse_react.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,17 +365,11 @@ 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();
 		function check() {
-			if (require_nested_key.hasWeaverseStudio(window)) return resolve(window.weaverseStudio);
+			if (require_translation_store.hasWeaverseStudio(window)) return resolve(window.weaverseStudio);
 			if (Date.now() - startedAt >= STUDIO_READY_TIMEOUT_MS) {
 				console.warn("[Weaverse] Studio script did not initialize in time");
 				return resolve(null);
@@ -631,38 +379,10 @@ 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 } = (0, react_router.useLocation)();
 	(0, react.useEffect)(() => {
-		let src = require_nested_key.resolveStudioScriptSrc(search, typeof window === "undefined" ? "" : window.location.hostname);
+		let src = require_translation_store.resolveStudioScriptSrc(search, typeof window === "undefined" ? "" : window.location.hostname);
 		if (src) (0, _weaverse_react.loadScript)(src).catch(console.error);
 	}, [search]);
 }
@@ -683,7 +403,7 @@ function useStudio(weaverse) {
 	let { isDesignMode, weaverseHost, weaverseVersion, isPreviewMode, isRevisionPreview } = weaverse;
 	(0, react.useEffect)(() => {
 		if (navigation.state !== "idle") return;
-		let src = require_nested_key.getStudioScriptSrc({
+		let src = require_translation_store.getStudioScriptSrc({
 			isDesignMode,
 			isPreviewMode,
 			isRevisionPreview,
@@ -714,16 +434,10 @@ function useStudio(weaverse) {
 }
 //#endregion
 //#region src/WeaverseHydrogenRoot.tsx
-/** Runtime store for one rendered Hydrogen component instance. */
 var WeaverseHydrogenItem = class extends _weaverse_react.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;
@@ -731,29 +445,12 @@ var WeaverseHydrogenItem = class extends _weaverse_react.WeaverseItemStore {
 			console.error("Element is missing schema or not found!");
 			return;
 		}
-		const schemaData = require_nested_key.generateDataFromSchema(this.Element.schema);
+		const schemaData = require_translation_store.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;
@@ -764,7 +461,7 @@ var WeaverseHydrogenItem = class extends _weaverse_react.WeaverseItemStore {
 			let isSerializedItem = "id" in source && "type" in source;
 			if (schema && (data !== void 0 || isSerializedItem)) {
 				let { data: _previousData, ...store } = this._store;
-				let schemaData = require_nested_key.generateDataFromSchema(schema);
+				let schemaData = require_translation_store.generateDataFromSchema(schema);
 				this._store = {
 					...store,
 					...data === void 0 ? {} : { data },
@@ -780,12 +477,6 @@ var WeaverseHydrogenItem = class extends _weaverse_react.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 _weaverse_react.WeaverseItemStore {
 	};
 };
 _weaverse_react.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_react.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_react.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_react.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_react.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_react.Weaverse {
 			entries
 		};
 	};
-	/**
-	* Override setProjectData to re-extract translation sidecar from new page data.
-	*/
 	setProjectData = (data) => {
 		this.data = data;
 		this.extractTranslationSidecar();
@@ -941,7 +583,7 @@ function createWeaverseInstance(params) {
 		runtimeWindow.__weaverses[normalizedParams.pageId] = weaverse;
 		if (weaverse.isDesignMode) {
 			weaverse.requestInfo = normalizedParams.requestInfo;
-			if (require_nested_key.hasWeaverseStudio(window)) window.weaverseStudio.refreshStudio(normalizedParams);
+			if (require_translation_store.hasWeaverseStudio(window)) window.weaverseStudio.refreshStudio(normalizedParams);
 		} else if (isReused) syncReusedInstance(weaverse, normalizedParams);
 		return weaverse;
 	}
@@ -955,12 +597,6 @@ const StudioConnect = (0, react.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__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_weaverse_react.WeaverseRoot, { context: weaverse }), /* @__PURE__ */ (0, react_jsx_runtime.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 = (0, react.memo)(({ components, data: dataProp, errorComponent: ErrorComponent = ({ error }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { children: error instanceof Error ? error.message : "An unexpected error occurred" }) }) => {
 	const matches = (0, react_router.useMatches)();
 	const enhancedDataContext = (0, react.useMemo)(() => createWeaverseDataContext(matches), [matches]);
@@ -1046,33 +655,6 @@ const WeaverseHydrogenRoot = (0, react.memo)(({ components, data: dataProp, erro
 	}
 	return /* @__PURE__ */ (0, react_jsx_runtime.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 = (0, react_router.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 (0, _weaverse_react.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 require_nested_key.WeaverseError)) return false;
+	if (!(error instanceof require_translation_store.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,34 +730,17 @@ 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) || require_nested_key.hasError(payload) || !("page" in payload)) return false;
+	if (!isPlainObject(payload) || require_translation_store.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) && !require_nested_key.hasError(payload) && "theme" in payload && (payload.theme === null || isPlainObject(payload.theme));
+	return isPlainObject(payload) && !require_translation_store.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 require_nested_key.WeaverseLoadError) return error.kind;
-	if (!(error instanceof require_nested_key.WeaverseError)) return "invalid-response";
+	if (error instanceof require_translation_store.WeaverseLoadError) return error.kind;
+	if (!(error instanceof require_translation_store.WeaverseError)) return "invalid-response";
 	if (error.code === "TIMEOUT_ERROR" || error.code === "NETWORK_ERROR") return "unavailable";
 	if (error.code === "INVALID_RESPONSE") return "invalid-response";
 	if (error.code === "FETCH_ERROR") {
@@ -1242,116 +750,43 @@ 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 require_nested_key.WeaverseError || !(error instanceof Error)) return error;
-	if (error.name === "AbortError" || error.name === "TimeoutError") return new require_nested_key.WeaverseError("Request timed out", "TIMEOUT_ERROR", void 0, { url });
-	if (error instanceof TypeError) return new require_nested_key.WeaverseError("Network error during fetch", "NETWORK_ERROR", void 0, {
+	if (error instanceof require_translation_store.WeaverseError || !(error instanceof Error)) return error;
+	if (error.name === "AbortError" || error.name === "TimeoutError") return new require_translation_store.WeaverseError("Request timed out", "TIMEOUT_ERROR", void 0, { url });
+	if (error instanceof TypeError) return new require_translation_store.WeaverseError("Network error during fetch", "NETWORK_ERROR", void 0, {
 		url,
 		cause: error.message
 	});
 	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 = (0, _shopify_hydrogen.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 = (0, _shopify_hydrogen.createFetchWithCache)({
@@ -1380,14 +811,10 @@ 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 = require_nested_key.getWeaverseConfigs(args.request, args.env);
+		const baseConfigs = require_translation_store.getWeaverseConfigs(args.request, args.env);
 		const resolvedProjectId = this.resolveProjectIdSync(args.projectId, args.request, args.env, baseConfigs);
-		if (!resolvedProjectId || resolvedProjectId.trim() === "") throw new require_nested_key.WeaverseError("Failed to initialize WeaverseClient: No valid projectId found. Set WEAVERSE_PROJECT_ID environment variable or provide projectId parameter.", "MISSING_PROJECT_ID");
+		if (!resolvedProjectId || resolvedProjectId.trim() === "") throw new require_translation_store.WeaverseError("Failed to initialize WeaverseClient: No valid projectId found. Set WEAVERSE_PROJECT_ID environment variable or provide projectId parameter.", "MISSING_PROJECT_ID");
 		this.configs = {
 			...baseConfigs,
 			projectId: resolvedProjectId
@@ -1411,32 +838,11 @@ 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 require_nested_key.WeaverseError) return {
+		if (error instanceof require_translation_store.WeaverseError) return {
 			message: error.message,
 			code: error.code,
 			context: error.context,
@@ -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,71 +868,43 @@ 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 require_nested_key.getRequestQueries(request).weaverseProjectId || null;
+		return require_translation_store.getRequestQueries(request).weaverseProjectId || null;
 	}
-	/**
-	* Priority 2: Resolve projectId from function parameter.
-	* Detects and rejects async functions with helpful error.
-	*/
 	resolveFromFunction(projectId) {
-		if (!require_nested_key.isProjectIdFunction(projectId)) return null;
-		if (projectId.constructor.name === "AsyncFunction") throw new require_nested_key.WeaverseError("Async projectId functions must be awaited before passing to WeaverseClient. Use: projectId: await getProjectAsync() instead of: projectId: getProjectAsync", "ASYNC_PROJECT_ID");
+		if (!require_translation_store.isProjectIdFunction(projectId)) return null;
+		if (projectId.constructor.name === "AsyncFunction") throw new require_translation_store.WeaverseError("Async projectId functions must be awaited before passing to WeaverseClient. Use: projectId: await getProjectAsync() instead of: projectId: getProjectAsync", "ASYNC_PROJECT_ID");
 		try {
 			const result = projectId();
-			if (result instanceof Promise) throw new require_nested_key.WeaverseError("Async projectId functions must be awaited before passing to WeaverseClient. Use: projectId: await getProjectAsync() instead of: projectId: getProjectAsync", "ASYNC_PROJECT_ID");
+			if (result instanceof Promise) throw new require_translation_store.WeaverseError("Async projectId functions must be awaited before passing to WeaverseClient. Use: projectId: await getProjectAsync() instead of: projectId: getProjectAsync", "ASYNC_PROJECT_ID");
 			if (result && result.trim() !== "") {
 				const trimmed = result.trim();
 				const validation = this.validateProjectId(trimmed);
 				if (validation.valid) return trimmed;
-				throw new require_nested_key.WeaverseError(validation.error || "Invalid projectId format", "INVALID_PROJECT_ID");
+				throw new require_translation_store.WeaverseError(validation.error || "Invalid projectId format", "INVALID_PROJECT_ID");
 			}
 		} catch (err) {
-			if (err instanceof require_nested_key.WeaverseError) throw err;
-			throw new require_nested_key.WeaverseError(`Failed to evaluate projectId function: ${err instanceof Error ? err.message : String(err)}`, "PROJECT_ID_FUNCTION_ERROR", void 0, { cause: err instanceof Error ? err.stack : String(err) });
+			if (err instanceof require_translation_store.WeaverseError) throw err;
+			throw new require_translation_store.WeaverseError(`Failed to evaluate projectId function: ${err instanceof Error ? err.message : String(err)}`, "PROJECT_ID_FUNCTION_ERROR", void 0, { cause: err instanceof Error ? err.stack : String(err) });
 		}
 		return null;
 	}
-	/**
-	* Priority 3: Resolve projectId from explicit string parameter.
-	*/
 	resolveFromString(projectId) {
 		if (typeof projectId !== "string") return null;
 		const trimmed = projectId.trim();
 		if (trimmed === "") return null;
 		const validation = this.validateProjectId(trimmed);
 		if (validation.valid) return trimmed;
-		throw new require_nested_key.WeaverseError(validation.error || "Invalid projectId format", "INVALID_PROJECT_ID");
+		throw new require_translation_store.WeaverseError(validation.error || "Invalid projectId format", "INVALID_PROJECT_ID");
 	}
-	/**
-	* Priority 4: Resolve projectId from environment variables.
-	*/
 	resolveFromEnvironment(baseConfigs, request, env) {
-		const configs = baseConfigs || require_nested_key.getWeaverseConfigs(request, env);
+		const configs = baseConfigs || require_translation_store.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);
@@ -1550,7 +915,7 @@ var WeaverseClient = class {
 			});
 			if (!response.ok) {
 				const errorText = await response.text();
-				throw new require_nested_key.WeaverseError(`HTTP ${response.status}: ${response.statusText}`, "FETCH_ERROR", response.status, {
+				throw new require_translation_store.WeaverseError(`HTTP ${response.status}: ${response.statusText}`, "FETCH_ERROR", response.status, {
 					url,
 					errorText
 				});
@@ -1560,19 +925,19 @@ var WeaverseClient = class {
 				data = await response.json();
 			} catch (parseError) {
 				if (parseError?.name === "AbortError") throw parseError;
-				throw new require_nested_key.WeaverseError("Response body is not valid JSON", "INVALID_RESPONSE", response.status, { url });
+				throw new require_translation_store.WeaverseError("Response body is not valid JSON", "INVALID_RESPONSE", response.status, { url });
 			}
 			return {
 				data,
 				response
 			};
 		} catch (err) {
-			if (err instanceof require_nested_key.WeaverseError) throw err;
-			if (err.name === "AbortError") throw new require_nested_key.WeaverseError(`Request timeout after ${timeoutMs}ms`, "TIMEOUT_ERROR", void 0, {
+			if (err instanceof require_translation_store.WeaverseError) throw err;
+			if (err.name === "AbortError") throw new require_translation_store.WeaverseError(`Request timeout after ${timeoutMs}ms`, "TIMEOUT_ERROR", void 0, {
 				url,
 				timeoutMs
 			});
-			throw new require_nested_key.WeaverseError("Network error during fetch", "NETWORK_ERROR", void 0, {
+			throw new require_translation_store.WeaverseError("Network error during fetch", "NETWORK_ERROR", void 0, {
 				url,
 				cause: err instanceof Error ? err.message : String(err)
 			});
@@ -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;
@@ -1641,7 +989,7 @@ var WeaverseClient = class {
 					if (fetchOptions.signal?.aborted) return false;
 					const payload = parseResponseText(await readText());
 					if (validateBuilderPayload && !validateBuilderPayload(payload)) return false;
-					return !require_nested_key.hasError(payload) && payload !== null && payload !== "";
+					return !require_translation_store.hasError(payload) && payload !== null && payload !== "";
 				}
 			});
 			text = await response.text();
@@ -1649,37 +997,18 @@ var WeaverseClient = class {
 			throw validateBuilderPayload ? cachedTransportError(error, url) : error;
 		}
 		if (!response.ok) {
-			if (validateBuilderPayload) throw new require_nested_key.WeaverseError(`HTTP ${response.status}: ${response.statusText}`, "FETCH_ERROR", response.status, { url });
+			if (validateBuilderPayload) throw new require_translation_store.WeaverseError(`HTTP ${response.status}: ${response.statusText}`, "FETCH_ERROR", response.status, { url });
 			return null;
 		}
 		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 = require_nested_key.generateDataFromSchema(this.themeSchema);
+		const defaultThemeSettings = require_translation_store.generateDataFromSchema(this.themeSchema);
 		try {
 			const { configs } = this;
 			const { projectId, isDesignMode } = configs;
@@ -1703,7 +1032,7 @@ var WeaverseClient = class {
 			bodyFreeCacheRequests.add(themeSettingsOptions);
 			builderPayloadValidators.set(themeSettingsOptions, isThemeConfigsEnvelope);
 			const [data, merchantOverrides] = await Promise.all([this.fetchWithCache(url, themeSettingsOptions), this.fetchMerchantOverrides(strategy)]);
-			if (!isThemeConfigsEnvelope(data)) throw new require_nested_key.WeaverseError("Invalid theme settings response format", "INVALID_RESPONSE");
+			if (!isThemeConfigsEnvelope(data)) throw new require_translation_store.WeaverseError("Invalid theme settings response format", "INVALID_RESPONSE");
 			let result = data;
 			if (this.themeSchema?.settings || this.themeSchema?.inspector) if (!result.theme || typeof result.theme !== "object") result.theme = defaultThemeSettings;
 			else result.theme = {
@@ -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,40 +1133,12 @@ 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}`;
 			if (message) {
 				console.error(`Route-level projectId validation failed: ${message}`);
-				if (this.throwPageLoadFailures) throw new require_nested_key.WeaverseLoadError("Route-level projectId validation failed", "configuration");
+				if (this.throwPageLoadFailures) throw new require_translation_store.WeaverseLoadError("Route-level projectId validation failed", "configuration");
 				return null;
 			}
 		}
@@ -1861,8 +1146,8 @@ var WeaverseClient = class {
 			const { request, basePageRequestBody, basePageConfigs } = this;
 			const { projectId: clientProjectId, weaverseHost, isPreviewMode, sectionType } = this.configs;
 			const effectiveProjectId = params.projectId || clientProjectId;
-			if (isPreviewMode) return require_nested_key.getPreviewData(sectionType || "", this.components, weaverseHost);
-			if (!effectiveProjectId) throw new require_nested_key.WeaverseLoadError("Missing Weaverse projectId!", "configuration");
+			if (isPreviewMode) return require_translation_store.getPreviewData(sectionType || "", this.components, weaverseHost);
+			if (!effectiveProjectId) throw new require_translation_store.WeaverseLoadError("Missing Weaverse projectId!", "configuration");
 			const { strategy, ...pageLoadParams } = params;
 			const body = {
 				...basePageRequestBody,
@@ -1888,9 +1173,9 @@ var WeaverseClient = class {
 			};
 			builderPayloadValidators.set(projectOptions, isProjectEnvelope);
 			const projectData = await this.fetchWithCache(url, projectOptions);
-			if (require_nested_key.hasError(projectData)) throw new require_nested_key.WeaverseLoadError("Weaverse API returned an error body", "invalid-response");
+			if (require_translation_store.hasError(projectData)) throw new require_translation_store.WeaverseLoadError("Weaverse API returned an error body", "invalid-response");
 			if (!isProjectEnvelope(projectData)) {
-				if (this.throwPageLoadFailures) throw new require_nested_key.WeaverseLoadError("Invalid project data structure received from API", "invalid-response");
+				if (this.throwPageLoadFailures) throw new require_translation_store.WeaverseLoadError("Invalid project data structure received from API", "invalid-response");
 				console.warn("Invalid project data structure received from API, using fallback data", { projectId: effectiveProjectId });
 			}
 			const responseData = projectData;
@@ -1923,7 +1208,7 @@ var WeaverseClient = class {
 					...basePageConfigs,
 					requestInfo: {
 						i18n: this.locale,
-						queries: require_nested_key.getRequestQueries(request),
+						queries: require_translation_store.getRequestQueries(request),
 						pathname: this.parsedUrl.pathname,
 						search: this.parsedUrl.search
 					}
@@ -1933,7 +1218,7 @@ var WeaverseClient = class {
 			const failure = classifyPageLoadFailure(error);
 			const errorMessage = "❌ Page load failed";
 			const errorContext = { projectId: params.projectId || this.configs.projectId };
-			if (error instanceof require_nested_key.WeaverseError) console.error(errorMessage, {
+			if (error instanceof require_translation_store.WeaverseError) console.error(errorMessage, {
 				code: error.code,
 				message: error.message,
 				...errorContext,
@@ -1949,11 +1234,10 @@ var WeaverseClient = class {
 				...errorContext
 			});
 			if (failure === "absent" || !this.throwPageLoadFailures) return null;
-			if (error instanceof require_nested_key.WeaverseLoadError) throw error;
-			throw new require_nested_key.WeaverseLoadError("Unable to load Weaverse page", failure, error instanceof require_nested_key.WeaverseError ? error.statusCode : void 0);
+			if (error instanceof require_translation_store.WeaverseLoadError) throw error;
+			throw new require_translation_store.WeaverseLoadError("Unable to load Weaverse page", failure, error instanceof require_translation_store.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);
@@ -1963,7 +1247,7 @@ var WeaverseClient = class {
 				...item,
 				loaderData: await Promise.resolve(loader({
 					data: {
-						...require_nested_key.generateDataFromSchema(component.schema),
+						...require_translation_store.generateDataFromSchema(component.schema),
 						...data
 					},
 					weaverse: this
@@ -2043,12 +1327,6 @@ Object.defineProperty(exports, "getWeaverseSeoMeta", {
 		return getWeaverseSeoMeta;
 	}
 });
-Object.defineProperty(exports, "interpolate", {
-	enumerable: true,
-	get: function() {
-		return interpolate;
-	}
-});
 Object.defineProperty(exports, "registerComponent", {
 	enumerable: true,
 	get: function() {
@@ -2086,4 +1364,4 @@ Object.defineProperty(exports, "withWeaverse", {
 	}
 });
 
-//# sourceMappingURL=weaverse-client-C9IgIH7O.js.map
+//# sourceMappingURL=weaverse-client-BmceZc5q.js.map