@weaverse/hydrogen 5.16.3 → 5.17.0

package/dist/index.d.mts

@@ -15,14 +15,15 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 /**
  * Minimal mutable store for design-mode static text overrides.
  *
- * useSyncExternalStore-compatible. Passed into ThemeTextProvider which
+ * useSyncExternalStore-compatible. Passed into TranslationProvider which
  * subscribes internally and merges overrides into merchantOverrides.
- * The studio bridge calls updateOverrides() via weaverse.internal.themeTextStore.
+ * The studio bridge calls updateOverrides() via weaverse.internal.translationStore
+ * (also exposed as the deprecated weaverse.internal.themeTextStore alias).
  *
  * Shape: flat Record<string, string> — dot-notation keys map to values
  * (e.g. "cart.title" → "Shopping Cart").
  */
-declare class ThemeTextStore {
+declare class TranslationStore {
     overrides: Record<string, string>;
     private listeners;
     setOverrides: (overrides: Record<string, string>) => void;
@@ -32,6 +33,16 @@ declare class ThemeTextStore {
     subscribe: (callback: () => void) => () => void;
     private emit;
 }
+/**
+ * @deprecated Use {@link TranslationStore} instead. Kept as a backward-compatible
+ * alias and will remain exported for existing integrations.
+ */
+declare const ThemeTextStore: typeof TranslationStore;
+/**
+ * @deprecated Use {@link TranslationStore} instead. Kept as a backward-compatible
+ * alias and will remain exported for existing integrations.
+ */
+type ThemeTextStore = TranslationStore;
 
 type WeaverseThemeData = {
     theme: HydrogenThemeSettings;
@@ -74,12 +85,12 @@ declare function interpolate(template: string, variables?: Record<string, string
  * Signature for a translation function.
  */
 type TranslateFunction = (key: string, variables?: Record<string, string | number>) => string;
-type ThemeTextValue = {
+type TranslationValue = {
     /**
      * Translate a key with optional variable interpolation.
      *
      * Priority chain (highest wins):
-     * 1. External `t`        (passed into `withWeaverse` / `ThemeTextProvider`)
+     * 1. External `t`        (passed into `withWeaverse` / `TranslationProvider`)
      * 2. `merchantOverrides` (DB overrides for the current locale + design overrides)
      * 3. `staticContent`     (theme default JSON)
      * 4. The key itself      (fallback)
@@ -90,11 +101,16 @@ type ThemeTextValue = {
      */
     t: TranslateFunction;
     /** Exposed for useStudio to attach to weaverse.internal. Null in production. */
-    themeTextStore: ThemeTextStore | null;
+    translationStore: TranslationStore | null;
+    /**
+     * @deprecated Use {@link TranslationValue.translationStore} instead. Kept as a
+     * backward-compatible alias pointing at the same store instance.
+     */
+    themeTextStore: TranslationStore | null;
     /** Active-locale translated keys loaded from the storefront API. */
     merchantOverrides: Record<string, unknown> | null;
 };
-type ThemeTextProviderProps = {
+type TranslationProviderProps = {
     staticContent: Record<string, unknown>;
     merchantOverrides?: Record<string, unknown>;
     /**
@@ -105,7 +121,13 @@ type ThemeTextProviderProps = {
      */
     t?: TranslateFunction;
     /** Optional store for live design-mode text overrides from the builder. */
-    themeTextStore?: ThemeTextStore | null;
+    translationStore?: TranslationStore | null;
+    /**
+     * @deprecated Use {@link TranslationProviderProps.translationStore} instead.
+     * Still accepted for backward compatibility; ignored when `translationStore`
+     * is also provided.
+     */
+    themeTextStore?: TranslationStore | null;
     children: ReactNode;
 };
 /**
@@ -113,23 +135,40 @@ type ThemeTextProviderProps = {
  *
  * - `staticContent`      – the theme's default locale JSON (from themeSchema.i18n)
  * - `merchantOverrides`  – locale-specific overrides fetched from the API
- * - `themeTextStore`     – optional store for live design-mode text overrides
+ * - `translationStore`   – optional store for live design-mode text overrides
+ *   (the deprecated `themeTextStore` prop is accepted as a fallback)
  */
-declare function ThemeTextProvider({ staticContent, merchantOverrides, t: externalT, themeTextStore, children, }: ThemeTextProviderProps): react_jsx_runtime.JSX.Element;
+declare function TranslationProvider({ staticContent, merchantOverrides, t: externalT, translationStore, themeTextStore, children, }: TranslationProviderProps): react_jsx_runtime.JSX.Element;
 /**
- * Hook to access the theme text `t()` function.
+ * Hook to access the translation `t()` function.
  *
- * Must be used inside a component wrapped by `withWeaverse` or `ThemeTextProvider`.
+ * Must be used inside a component wrapped by `withWeaverse` or `TranslationProvider`.
  *
  * @example
  * ```tsx
  * function CartTitle() {
- *   const { t } = useThemeText()
+ *   const { t } = useTranslation()
  *   return <h2>{t('cart.title')}</h2>
  * }
  * ```
  */
-declare function useThemeText(): ThemeTextValue;
+declare function useTranslation(): TranslationValue;
+/**
+ * @deprecated Use {@link TranslationProvider} instead.
+ */
+declare const ThemeTextProvider: typeof TranslationProvider;
+/**
+ * @deprecated Use {@link useTranslation} instead.
+ */
+declare const useThemeText: typeof useTranslation;
+/**
+ * @deprecated Use {@link TranslationValue} instead.
+ */
+type ThemeTextValue = TranslationValue;
+/**
+ * @deprecated Use {@link TranslationProviderProps} instead.
+ */
+type ThemeTextProviderProps = TranslationProviderProps;
 
 type WeaverseDataValue = WeaverseLoaderData | Promise<WeaverseLoaderData> | null;
 
@@ -251,7 +290,7 @@ type WithWeaverseOptions = {
     /**
      * Optional external translation function (e.g. from Shopify i18n).
      * When provided it becomes the **highest-priority** source
-     * in the `t()` resolution chain exposed by `useThemeText()`.
+     * in the `t()` resolution chain exposed by `useTranslation()`.
      */
     t?: TranslateFunction;
 };
@@ -468,7 +507,7 @@ declare class WeaverseClient {
      * Fetches page content, executes component loaders, and handles empty items fallback.
      *
      * @param params - Optional page loading parameters
-     * @param params.type - Page type (HOME, PAGE, PRODUCT, COLLECTION, etc.)
+     * @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)
@@ -481,7 +520,7 @@ declare class WeaverseClient {
      * const data = await weaverse.loadPage()
      *
      * // With page type
-     * const data = await weaverse.loadPage({ type: 'HOME' })
+     * const data = await weaverse.loadPage({ type: 'INDEX' })
      *
      * // Route-level project override
      * const data = await weaverse.loadPage({
@@ -549,7 +588,9 @@ type WeaverseInternal = {
     navigate: NavigateFunction;
     revalidate: () => void;
     themeSettingsStore: ThemeSettingsStore;
-    themeTextStore?: ThemeTextStore | null;
+    translationStore?: TranslationStore | null;
+    /** @deprecated Use translationStore instead. */
+    themeTextStore?: TranslationStore | null;
     merchantOverrides?: Record<string, unknown> | null;
 };
 /**
@@ -913,6 +954,15 @@ type CreateHydrogenSchemaOptions = {
         pages?: PageType[];
         groups?: ('*' | 'header' | 'footer' | 'body')[];
     };
+    enabled?: boolean | ((context: {
+        page: {
+            id: string;
+            type: PageType;
+            handle: string;
+            locale: string;
+        };
+        group: 'body' | 'header' | 'footer';
+    }) => boolean);
     presets?: {
         children?: ComponentPresets[];
         [key: string]: any;
@@ -1216,4 +1266,4 @@ declare const IMAGES_PLACEHOLDERS: {
     product_18: string;
 };
 
-export { type CacheResponseValidator, type ComponentDataValue, type ComponentLoaderArgs, type CreateHydrogenSchemaOptions, type CustomPageEntry, type DirectFetchResponse, type FetchProjectPayload, type FetchProjectRequestBody, type HydrogenComponent, type HydrogenComponentData, type HydrogenComponentPresets, type HydrogenComponentProps, type HydrogenComponentSchema, type HydrogenElement, type HydrogenPageAssignment, type HydrogenPageData, type HydrogenProjectType, type HydrogenSchemaValidationResult, type HydrogenThemeSchema, type HydrogenThemeSettings, IMAGES_PLACEHOLDERS, type LoadPageParams, type ProjectIdValidationResult, type ProjectIdValue, type PublicEnv, type RouteLoaderArgs, type ThemeSettingsResponse, ThemeTextProvider, type ThemeTextProviderProps, ThemeTextStore, type ThemeTextValue, type TranslateFunction, type TranslationChanges, type TranslationEntry, type TranslationItemEntry, type TranslationMap, type TranslationMapEntry, type WeaverseArticle, type WeaverseBlog, WeaverseClient, type WeaverseClientArgs, type WeaverseCollection, type WeaverseDataContext, WeaverseError, WeaverseHydrogen, WeaverseHydrogenItem, type WeaverseHydrogenParams, WeaverseHydrogenRoot, type WeaverseI18n, type WeaverseInternal, type WeaverseLoaderData, type WeaverseLoaderRequestInfo, type WeaverseMetaObject, type WeaverseProduct, type WeaverseProjectConfigs, type WeaverseStudioQueries, type WithCacheFetchResponse, type WithWeaverseOptions, createWeaverseDataContext, defaultComponents, formatMetaDescriptors, generateDataFromSchema, getNestedKey, getPreviewData, getRequestQueries, getSelectedProductOptions, getWeaverseConfigs, getWeaverseSeoMeta, hasError, hasWeaverseStudio, interpolate, isFetchProjectPayload, isProjectIdFunction, isThemeSettingsResponse, isValidHydrogenSchema, isWithCacheFetchResponse, registerComponent, useThemeSettings, useThemeText, useWeaverseDataContext, withWeaverse };
+export { type CacheResponseValidator, type ComponentDataValue, type ComponentLoaderArgs, type CreateHydrogenSchemaOptions, type CustomPageEntry, type DirectFetchResponse, type FetchProjectPayload, type FetchProjectRequestBody, type HydrogenComponent, type HydrogenComponentData, type HydrogenComponentPresets, type HydrogenComponentProps, type HydrogenComponentSchema, type HydrogenElement, type HydrogenPageAssignment, type HydrogenPageData, type HydrogenProjectType, type HydrogenSchemaValidationResult, type HydrogenThemeSchema, type HydrogenThemeSettings, IMAGES_PLACEHOLDERS, type LoadPageParams, type ProjectIdValidationResult, type ProjectIdValue, type PublicEnv, type RouteLoaderArgs, type ThemeSettingsResponse, ThemeTextProvider, type ThemeTextProviderProps, ThemeTextStore, type ThemeTextValue, type TranslateFunction, type TranslationChanges, type TranslationEntry, type TranslationItemEntry, type TranslationMap, type TranslationMapEntry, TranslationProvider, type TranslationProviderProps, TranslationStore, type TranslationValue, type WeaverseArticle, type WeaverseBlog, WeaverseClient, type WeaverseClientArgs, type WeaverseCollection, type WeaverseDataContext, WeaverseError, WeaverseHydrogen, WeaverseHydrogenItem, type WeaverseHydrogenParams, WeaverseHydrogenRoot, type WeaverseI18n, type WeaverseInternal, type WeaverseLoaderData, type WeaverseLoaderRequestInfo, type WeaverseMetaObject, type WeaverseProduct, type WeaverseProjectConfigs, type WeaverseStudioQueries, type WithCacheFetchResponse, type WithWeaverseOptions, createWeaverseDataContext, defaultComponents, formatMetaDescriptors, generateDataFromSchema, getNestedKey, getPreviewData, getRequestQueries, getSelectedProductOptions, getWeaverseConfigs, getWeaverseSeoMeta, hasError, hasWeaverseStudio, interpolate, isFetchProjectPayload, isProjectIdFunction, isThemeSettingsResponse, isValidHydrogenSchema, isWithCacheFetchResponse, registerComponent, useThemeSettings, useThemeText, useTranslation, useWeaverseDataContext, withWeaverse };

package/dist/index.d.ts

@@ -15,14 +15,15 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 /**
  * Minimal mutable store for design-mode static text overrides.
  *
- * useSyncExternalStore-compatible. Passed into ThemeTextProvider which
+ * useSyncExternalStore-compatible. Passed into TranslationProvider which
  * subscribes internally and merges overrides into merchantOverrides.
- * The studio bridge calls updateOverrides() via weaverse.internal.themeTextStore.
+ * The studio bridge calls updateOverrides() via weaverse.internal.translationStore
+ * (also exposed as the deprecated weaverse.internal.themeTextStore alias).
  *
  * Shape: flat Record<string, string> — dot-notation keys map to values
  * (e.g. "cart.title" → "Shopping Cart").
  */
-declare class ThemeTextStore {
+declare class TranslationStore {
     overrides: Record<string, string>;
     private listeners;
     setOverrides: (overrides: Record<string, string>) => void;
@@ -32,6 +33,16 @@ declare class ThemeTextStore {
     subscribe: (callback: () => void) => () => void;
     private emit;
 }
+/**
+ * @deprecated Use {@link TranslationStore} instead. Kept as a backward-compatible
+ * alias and will remain exported for existing integrations.
+ */
+declare const ThemeTextStore: typeof TranslationStore;
+/**
+ * @deprecated Use {@link TranslationStore} instead. Kept as a backward-compatible
+ * alias and will remain exported for existing integrations.
+ */
+type ThemeTextStore = TranslationStore;
 
 type WeaverseThemeData = {
     theme: HydrogenThemeSettings;
@@ -74,12 +85,12 @@ declare function interpolate(template: string, variables?: Record<string, string
  * Signature for a translation function.
  */
 type TranslateFunction = (key: string, variables?: Record<string, string | number>) => string;
-type ThemeTextValue = {
+type TranslationValue = {
     /**
      * Translate a key with optional variable interpolation.
      *
      * Priority chain (highest wins):
-     * 1. External `t`        (passed into `withWeaverse` / `ThemeTextProvider`)
+     * 1. External `t`        (passed into `withWeaverse` / `TranslationProvider`)
      * 2. `merchantOverrides` (DB overrides for the current locale + design overrides)
      * 3. `staticContent`     (theme default JSON)
      * 4. The key itself      (fallback)
@@ -90,11 +101,16 @@ type ThemeTextValue = {
      */
     t: TranslateFunction;
     /** Exposed for useStudio to attach to weaverse.internal. Null in production. */
-    themeTextStore: ThemeTextStore | null;
+    translationStore: TranslationStore | null;
+    /**
+     * @deprecated Use {@link TranslationValue.translationStore} instead. Kept as a
+     * backward-compatible alias pointing at the same store instance.
+     */
+    themeTextStore: TranslationStore | null;
     /** Active-locale translated keys loaded from the storefront API. */
     merchantOverrides: Record<string, unknown> | null;
 };
-type ThemeTextProviderProps = {
+type TranslationProviderProps = {
     staticContent: Record<string, unknown>;
     merchantOverrides?: Record<string, unknown>;
     /**
@@ -105,7 +121,13 @@ type ThemeTextProviderProps = {
      */
     t?: TranslateFunction;
     /** Optional store for live design-mode text overrides from the builder. */
-    themeTextStore?: ThemeTextStore | null;
+    translationStore?: TranslationStore | null;
+    /**
+     * @deprecated Use {@link TranslationProviderProps.translationStore} instead.
+     * Still accepted for backward compatibility; ignored when `translationStore`
+     * is also provided.
+     */
+    themeTextStore?: TranslationStore | null;
     children: ReactNode;
 };
 /**
@@ -113,23 +135,40 @@ type ThemeTextProviderProps = {
  *
  * - `staticContent`      – the theme's default locale JSON (from themeSchema.i18n)
  * - `merchantOverrides`  – locale-specific overrides fetched from the API
- * - `themeTextStore`     – optional store for live design-mode text overrides
+ * - `translationStore`   – optional store for live design-mode text overrides
+ *   (the deprecated `themeTextStore` prop is accepted as a fallback)
  */
-declare function ThemeTextProvider({ staticContent, merchantOverrides, t: externalT, themeTextStore, children, }: ThemeTextProviderProps): react_jsx_runtime.JSX.Element;
+declare function TranslationProvider({ staticContent, merchantOverrides, t: externalT, translationStore, themeTextStore, children, }: TranslationProviderProps): react_jsx_runtime.JSX.Element;
 /**
- * Hook to access the theme text `t()` function.
+ * Hook to access the translation `t()` function.
  *
- * Must be used inside a component wrapped by `withWeaverse` or `ThemeTextProvider`.
+ * Must be used inside a component wrapped by `withWeaverse` or `TranslationProvider`.
  *
  * @example
  * ```tsx
  * function CartTitle() {
- *   const { t } = useThemeText()
+ *   const { t } = useTranslation()
  *   return <h2>{t('cart.title')}</h2>
  * }
  * ```
  */
-declare function useThemeText(): ThemeTextValue;
+declare function useTranslation(): TranslationValue;
+/**
+ * @deprecated Use {@link TranslationProvider} instead.
+ */
+declare const ThemeTextProvider: typeof TranslationProvider;
+/**
+ * @deprecated Use {@link useTranslation} instead.
+ */
+declare const useThemeText: typeof useTranslation;
+/**
+ * @deprecated Use {@link TranslationValue} instead.
+ */
+type ThemeTextValue = TranslationValue;
+/**
+ * @deprecated Use {@link TranslationProviderProps} instead.
+ */
+type ThemeTextProviderProps = TranslationProviderProps;
 
 type WeaverseDataValue = WeaverseLoaderData | Promise<WeaverseLoaderData> | null;
 
@@ -251,7 +290,7 @@ type WithWeaverseOptions = {
     /**
      * Optional external translation function (e.g. from Shopify i18n).
      * When provided it becomes the **highest-priority** source
-     * in the `t()` resolution chain exposed by `useThemeText()`.
+     * in the `t()` resolution chain exposed by `useTranslation()`.
      */
     t?: TranslateFunction;
 };
@@ -468,7 +507,7 @@ declare class WeaverseClient {
      * Fetches page content, executes component loaders, and handles empty items fallback.
      *
      * @param params - Optional page loading parameters
-     * @param params.type - Page type (HOME, PAGE, PRODUCT, COLLECTION, etc.)
+     * @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)
@@ -481,7 +520,7 @@ declare class WeaverseClient {
      * const data = await weaverse.loadPage()
      *
      * // With page type
-     * const data = await weaverse.loadPage({ type: 'HOME' })
+     * const data = await weaverse.loadPage({ type: 'INDEX' })
      *
      * // Route-level project override
      * const data = await weaverse.loadPage({
@@ -549,7 +588,9 @@ type WeaverseInternal = {
     navigate: NavigateFunction;
     revalidate: () => void;
     themeSettingsStore: ThemeSettingsStore;
-    themeTextStore?: ThemeTextStore | null;
+    translationStore?: TranslationStore | null;
+    /** @deprecated Use translationStore instead. */
+    themeTextStore?: TranslationStore | null;
     merchantOverrides?: Record<string, unknown> | null;
 };
 /**
@@ -913,6 +954,15 @@ type CreateHydrogenSchemaOptions = {
         pages?: PageType[];
         groups?: ('*' | 'header' | 'footer' | 'body')[];
     };
+    enabled?: boolean | ((context: {
+        page: {
+            id: string;
+            type: PageType;
+            handle: string;
+            locale: string;
+        };
+        group: 'body' | 'header' | 'footer';
+    }) => boolean);
     presets?: {
         children?: ComponentPresets[];
         [key: string]: any;
@@ -1216,4 +1266,4 @@ declare const IMAGES_PLACEHOLDERS: {
     product_18: string;
 };
 
-export { type CacheResponseValidator, type ComponentDataValue, type ComponentLoaderArgs, type CreateHydrogenSchemaOptions, type CustomPageEntry, type DirectFetchResponse, type FetchProjectPayload, type FetchProjectRequestBody, type HydrogenComponent, type HydrogenComponentData, type HydrogenComponentPresets, type HydrogenComponentProps, type HydrogenComponentSchema, type HydrogenElement, type HydrogenPageAssignment, type HydrogenPageData, type HydrogenProjectType, type HydrogenSchemaValidationResult, type HydrogenThemeSchema, type HydrogenThemeSettings, IMAGES_PLACEHOLDERS, type LoadPageParams, type ProjectIdValidationResult, type ProjectIdValue, type PublicEnv, type RouteLoaderArgs, type ThemeSettingsResponse, ThemeTextProvider, type ThemeTextProviderProps, ThemeTextStore, type ThemeTextValue, type TranslateFunction, type TranslationChanges, type TranslationEntry, type TranslationItemEntry, type TranslationMap, type TranslationMapEntry, type WeaverseArticle, type WeaverseBlog, WeaverseClient, type WeaverseClientArgs, type WeaverseCollection, type WeaverseDataContext, WeaverseError, WeaverseHydrogen, WeaverseHydrogenItem, type WeaverseHydrogenParams, WeaverseHydrogenRoot, type WeaverseI18n, type WeaverseInternal, type WeaverseLoaderData, type WeaverseLoaderRequestInfo, type WeaverseMetaObject, type WeaverseProduct, type WeaverseProjectConfigs, type WeaverseStudioQueries, type WithCacheFetchResponse, type WithWeaverseOptions, createWeaverseDataContext, defaultComponents, formatMetaDescriptors, generateDataFromSchema, getNestedKey, getPreviewData, getRequestQueries, getSelectedProductOptions, getWeaverseConfigs, getWeaverseSeoMeta, hasError, hasWeaverseStudio, interpolate, isFetchProjectPayload, isProjectIdFunction, isThemeSettingsResponse, isValidHydrogenSchema, isWithCacheFetchResponse, registerComponent, useThemeSettings, useThemeText, useWeaverseDataContext, withWeaverse };
+export { type CacheResponseValidator, type ComponentDataValue, type ComponentLoaderArgs, type CreateHydrogenSchemaOptions, type CustomPageEntry, type DirectFetchResponse, type FetchProjectPayload, type FetchProjectRequestBody, type HydrogenComponent, type HydrogenComponentData, type HydrogenComponentPresets, type HydrogenComponentProps, type HydrogenComponentSchema, type HydrogenElement, type HydrogenPageAssignment, type HydrogenPageData, type HydrogenProjectType, type HydrogenSchemaValidationResult, type HydrogenThemeSchema, type HydrogenThemeSettings, IMAGES_PLACEHOLDERS, type LoadPageParams, type ProjectIdValidationResult, type ProjectIdValue, type PublicEnv, type RouteLoaderArgs, type ThemeSettingsResponse, ThemeTextProvider, type ThemeTextProviderProps, ThemeTextStore, type ThemeTextValue, type TranslateFunction, type TranslationChanges, type TranslationEntry, type TranslationItemEntry, type TranslationMap, type TranslationMapEntry, TranslationProvider, type TranslationProviderProps, TranslationStore, type TranslationValue, type WeaverseArticle, type WeaverseBlog, WeaverseClient, type WeaverseClientArgs, type WeaverseCollection, type WeaverseDataContext, WeaverseError, WeaverseHydrogen, WeaverseHydrogenItem, type WeaverseHydrogenParams, WeaverseHydrogenRoot, type WeaverseI18n, type WeaverseInternal, type WeaverseLoaderData, type WeaverseLoaderRequestInfo, type WeaverseMetaObject, type WeaverseProduct, type WeaverseProjectConfigs, type WeaverseStudioQueries, type WithCacheFetchResponse, type WithWeaverseOptions, createWeaverseDataContext, defaultComponents, formatMetaDescriptors, generateDataFromSchema, getNestedKey, getPreviewData, getRequestQueries, getSelectedProductOptions, getWeaverseConfigs, getWeaverseSeoMeta, hasError, hasWeaverseStudio, interpolate, isFetchProjectPayload, isProjectIdFunction, isThemeSettingsResponse, isValidHydrogenSchema, isWithCacheFetchResponse, registerComponent, useThemeSettings, useThemeText, useTranslation, useWeaverseDataContext, withWeaverse };

package/dist/index.js

@@ -56,77 +56,70 @@ function interpolate(template, variables) {
     return value === void 0 ? match : String(value);
   });
 }
-var ThemeTextContext = react$1.createContext(null);
-ThemeTextContext.displayName = "WeaverseThemeTextContext";
-function unflattenKeys(flat) {
-  const result = {};
-  for (const [dotPath, value] of Object.entries(flat)) {
-    const keys = dotPath.split(".");
-    let current = result;
-    for (let i = 0; i < keys.length - 1; i++) {
-      const k = keys[i];
-      if (!(k in current) || typeof current[k] !== "object") {
-        current[k] = {};
+var TranslationContext = react$1.createContext(null);
+TranslationContext.displayName = "WeaverseTranslationContext";
+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;
       }
-      current = current[k];
     }
-    current[keys[keys.length - 1]] = value;
-  }
-  return result;
+    const design = designOverrides && Object.hasOwn(designOverrides, key) ? designOverrides[key] : void 0;
+    const override = merchantOverrides ? getNestedKey(merchantOverrides, key) : void 0;
+    const staticValue = getNestedKey(staticContent, key);
+    const raw = design ?? override ?? staticValue ?? key;
+    return interpolate(raw, variables);
+  };
 }
 var EMPTY = {};
 var NOOP_SUBSCRIBE = () => () => {
 };
 var NOOP_SNAPSHOT = () => EMPTY;
-function ThemeTextProvider({
+function TranslationProvider({
   staticContent,
   merchantOverrides,
   t: externalT,
+  translationStore,
   themeTextStore,
   children
 }) {
+  const store = translationStore ?? themeTextStore ?? null;
   const designOverrides = react.useSafeExternalStore(
-    themeTextStore?.subscribe ?? NOOP_SUBSCRIBE,
-    themeTextStore?.getSnapshot ?? NOOP_SNAPSHOT,
-    themeTextStore?.getServerSnapshot ?? NOOP_SNAPSHOT
+    store?.subscribe ?? NOOP_SUBSCRIBE,
+    store?.getSnapshot ?? NOOP_SNAPSHOT,
+    store?.getServerSnapshot ?? NOOP_SNAPSHOT
   );
-  const mergedOverrides = designOverrides !== EMPTY && Object.keys(designOverrides).length > 0 ? { ...merchantOverrides, ...unflattenKeys(designOverrides) } : merchantOverrides;
-  const value = react$1.useMemo(() => {
-    const t = (key, variables) => {
-      if (externalT) {
-        const external = externalT(key, variables);
-        if (external && external !== key) {
-          return external;
-        }
-      }
-      const override = mergedOverrides ? getNestedKey(mergedOverrides, key) : void 0;
-      const staticValue = getNestedKey(staticContent, key);
-      const raw = override ?? staticValue ?? key;
-      return interpolate(raw, variables);
-    };
-    return {
-      t,
-      themeTextStore: themeTextStore ?? null,
+  const value = react$1.useMemo(
+    () => ({
+      t: createTranslate({
+        staticContent,
+        merchantOverrides,
+        designOverrides,
+        externalT
+      }),
+      translationStore: store,
+      // Deprecated alias — same instance, kept for backward compatibility.
+      themeTextStore: store,
       merchantOverrides: merchantOverrides ?? null
-    };
-  }, [
-    staticContent,
-    merchantOverrides,
-    mergedOverrides,
-    externalT,
-    themeTextStore
-  ]);
-  return /* @__PURE__ */ jsxRuntime.jsx(ThemeTextContext.Provider, { value, children });
+    }),
+    [staticContent, merchantOverrides, designOverrides, externalT, store]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(TranslationContext.Provider, { value, children });
 }
-function useThemeText() {
-  const ctx = react$1.useContext(ThemeTextContext);
+function useTranslation() {
+  const ctx = react$1.useContext(TranslationContext);
   if (!ctx) {
     throw new Error(
-      "useThemeText must be used within <ThemeTextProvider>. Wrap your app with withWeaverse()."
+      "useTranslation must be used within <TranslationProvider>. Wrap your app with withWeaverse()."
     );
   }
   return ctx;
 }
+var ThemeTextProvider = TranslationProvider;
+var useThemeText = useTranslation;
 function createFlatDataContext(matches) {
   const context = {};
   for (const match of matches) {
@@ -520,8 +513,8 @@ function getPreviewData(type, components, weaverseHost) {
   };
 }
 
-// src/utils/theme-text-store.ts
-var ThemeTextStore = class {
+// src/utils/translation-store.ts
+var TranslationStore = class {
   overrides = {};
   listeners = /* @__PURE__ */ new Set();
   setOverrides = (overrides) => {
@@ -545,11 +538,12 @@ var ThemeTextStore = class {
       try {
         listener();
       } catch (error) {
-        console.error("ThemeTextStore: Listener error", error);
+        console.error("TranslationStore: Listener error", error);
       }
     }
   };
 };
+var ThemeTextStore = TranslationStore;
 
 // src/utils/pick-weaverse-data.ts
 function pickWeaverseData(dataProp, ownLoaderData, matches) {
@@ -639,11 +633,14 @@ function syncReusedInstance(weaverse, params) {
 var currentNavigationKey = null;
 var firedPageIds = /* @__PURE__ */ new Set();
 var mountedInstances = 0;
-function shouldFirePixel(navigationKey, pageId) {
+function observeNavigation(navigationKey) {
   if (navigationKey !== currentNavigationKey) {
     currentNavigationKey = navigationKey;
     firedPageIds.clear();
   }
+}
+function shouldFirePixel(navigationKey, pageId) {
+  observeNavigation(navigationKey);
   if (firedPageIds.has(pageId)) {
     return false;
   }
@@ -798,7 +795,7 @@ function useStudio(weaverse) {
   let { pathname, search } = reactRouter.useLocation();
   let navigate = reactRouter.useNavigate();
   let themeSettingsStore = useThemeSettingsStore();
-  let { themeTextStore, merchantOverrides } = useThemeText();
+  let { translationStore, themeTextStore, merchantOverrides } = useTranslation();
   let {
     isDesignMode,
     weaverseHost,
@@ -829,6 +826,8 @@ function useStudio(weaverse) {
         revalidate,
         merchantOverrides,
         themeSettingsStore,
+        translationStore,
+        // Deprecated alias for existing Studio bridge integrations.
         themeTextStore
       };
       react.loadScript(src).then(waitForStudio).then((studio) => studio?.init(weaverse)).catch(console.error);
@@ -839,6 +838,12 @@ function useStudio(weaverse) {
 function usePixel(context) {
   let { projectId, pageId, isDesignMode, weaverseHost } = context;
   let { key: navigationKey } = reactRouter.useLocation();
+  react$1.useEffect(() => {
+    if (!(projectId && pageId) || isDesignMode) {
+      return;
+    }
+    observeNavigation(navigationKey);
+  }, [navigationKey, projectId, pageId, isDesignMode]);
   react$1.useEffect(() => {
     if (!(projectId && pageId) || isDesignMode) {
       return;
@@ -1126,18 +1131,18 @@ var WeaverseHydrogenRoot = react$1.memo(
 function withWeaverse(Component, options) {
   return (props) => {
     const themeSettingsStore = useCreateThemeSettingsStore();
-    const themeTextData = useThemeTextData();
-    const themeTextStoreRef = react$1.useRef(null);
-    if (!themeTextStoreRef.current) {
-      themeTextStoreRef.current = new ThemeTextStore();
+    const translationData = useTranslationData();
+    const translationStoreRef = react$1.useRef(null);
+    if (!translationStoreRef.current) {
+      translationStoreRef.current = new TranslationStore();
     }
     return /* @__PURE__ */ jsxRuntime.jsx(ThemeSettingsStoreContext.Provider, { value: themeSettingsStore, children: /* @__PURE__ */ jsxRuntime.jsxs(
-      ThemeTextProvider,
+      TranslationProvider,
       {
-        merchantOverrides: themeTextData.merchantOverrides,
-        staticContent: themeTextData.staticContent,
+        merchantOverrides: translationData.merchantOverrides,
+        staticContent: translationData.staticContent,
         t: options?.t,
-        themeTextStore: themeTextStoreRef.current,
+        translationStore: translationStoreRef.current,
         children: [
           /* @__PURE__ */ jsxRuntime.jsx(StudioConnect, {}),
           /* @__PURE__ */ jsxRuntime.jsx(Component, { ...props })
@@ -1146,7 +1151,7 @@ function withWeaverse(Component, options) {
     ) });
   };
 }
-function useThemeTextData() {
+function useTranslationData() {
   const data = reactRouter.useRouteLoaderData("root");
   return {
     staticContent: data?.weaverseTheme?.staticContent ?? {},
@@ -1724,6 +1729,9 @@ var WeaverseClient = class {
     try {
       const { projectId, weaverseHost } = this.configs;
       const i18n = this.storefront.i18n;
+      if (!this.themeSchema?.i18n) {
+        return;
+      }
       if (!(projectId && weaverseHost)) {
         return;
       }
@@ -1824,7 +1832,7 @@ var WeaverseClient = class {
    * Fetches page content, executes component loaders, and handles empty items fallback.
    *
    * @param params - Optional page loading parameters
-   * @param params.type - Page type (HOME, PAGE, PRODUCT, COLLECTION, etc.)
+   * @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)
@@ -1837,7 +1845,7 @@ var WeaverseClient = class {
    * const data = await weaverse.loadPage()
    *
    * // With page type
-   * const data = await weaverse.loadPage({ type: 'HOME' })
+   * const data = await weaverse.loadPage({ type: 'INDEX' })
    *
    * // Route-level project override
    * const data = await weaverse.loadPage({
@@ -2080,6 +2088,8 @@ Object.defineProperty(exports, "useWeaverse", {
 exports.IMAGES_PLACEHOLDERS = IMAGES_PLACEHOLDERS;
 exports.ThemeTextProvider = ThemeTextProvider;
 exports.ThemeTextStore = ThemeTextStore;
+exports.TranslationProvider = TranslationProvider;
+exports.TranslationStore = TranslationStore;
 exports.WeaverseClient = WeaverseClient;
 exports.WeaverseError = WeaverseError;
 exports.WeaverseHydrogen = WeaverseHydrogen;
@@ -2106,6 +2116,7 @@ exports.isWithCacheFetchResponse = isWithCacheFetchResponse;
 exports.registerComponent = registerComponent;
 exports.useThemeSettings = useThemeSettings;
 exports.useThemeText = useThemeText;
+exports.useTranslation = useTranslation;
 exports.useWeaverseDataContext = useWeaverseDataContext;
 exports.withWeaverse = withWeaverse;
 Object.keys(schema$1).forEach(function (k) {