@weaverse/hydrogen 5.9.0 → 5.9.2

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { SelectedOptionInput } from '@shopify/hydrogen/storefront-api-types';
-import { EventEmitter, Weaverse, WeaverseItemStore, ElementData, WeaverseElement, WeaverseProjectDataType, WeaverseCoreParams, WeaverseResourcePickerData } from '@weaverse/react';
+import { Weaverse, WeaverseItemStore, ElementData, WeaverseElement, WeaverseProjectDataType, WeaverseCoreParams, WeaverseResourcePickerData } from '@weaverse/react';
 export { PositionInputValue, WeaverseImage, WeaverseVideo, isBrowser, isIframe, useChildInstances, useItemInstance, useParentInstance, useWeaverse } from '@weaverse/react';
 import { PageType, InspectorGroup, SchemaType, ComponentPresets, SchemaValidationResult } from '@weaverse/schema';
 export * from '@weaverse/schema';
@@ -17,14 +17,20 @@ type WeaverseThemeData = {
     schema?: HydrogenThemeSchema;
     publicEnv?: PublicEnv;
 };
-declare class ThemeSettingsStore extends EventEmitter {
+declare class ThemeSettingsStore {
     settings: HydrogenThemeSettings;
     schema?: HydrogenThemeSchema;
     publicEnv?: PublicEnv;
+    private listeners;
+    private readonly MAX_LISTENERS;
+    private isDestroyed;
     constructor(data: WeaverseThemeData);
     updateThemeSettings: (newSettings: HydrogenThemeSettings) => void;
     getSnapshot: () => HydrogenThemeSettings;
     getServerSnapshot: () => HydrogenThemeSettings;
+    subscribe: (callback: () => void) => () => void;
+    private emit;
+    destroy: () => void;
 }
 
 declare class WeaverseHydrogenItem extends WeaverseItemStore {
@@ -43,6 +49,7 @@ declare class WeaverseHydrogen extends Weaverse {
     weaverseVersion: string;
     isDesignMode: boolean;
     isPreviewMode: boolean;
+    isRevisionPreview: boolean;
     sectionType: string;
     ItemConstructor: typeof WeaverseHydrogenItem;
     data: HydrogenPageData;
@@ -50,14 +57,69 @@ declare class WeaverseHydrogen extends Weaverse {
     static elementRegistry: Map<string, HydrogenElement>;
     constructor(params: WeaverseHydrogenParams);
 }
+/**
+ * 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' }
+ *   }
+ * })
+ * ```
+ */
 declare function registerComponent(element: HydrogenElement): void;
 declare const WeaverseHydrogenRoot: React$1.MemoExoticComponent<({ components, errorComponent: ErrorComponent, }: {
     components: HydrogenComponent[];
     errorComponent?: React.FC<{
-        error: any;
+        error: Error | unknown;
     }>;
 }) => react_jsx_runtime.JSX.Element>;
+/**
+ * Higher-order component that wraps your app with Weaverse theme settings context.
+ * Provides theme settings to all child components via React context.
+ *
+ * @param Component - The root component to wrap
+ * @returns Wrapped component with theme settings provider
+ *
+ * @example
+ * ```typescript
+ * import { withWeaverse } from '@weaverse/hydrogen'
+ *
+ * function App() {
+ *   return <div>My App</div>
+ * }
+ *
+ * export default withWeaverse(App)
+ * ```
+ */
 declare function withWeaverse(Component: ComponentType<any>): (props: JSX.IntrinsicAttributes) => react_jsx_runtime.JSX.Element;
+/**
+ * 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>
+ * }
+ * ```
+ */
 declare function useThemeSettings<T = HydrogenThemeSettings>(): T;
 
 declare class WeaverseClient {
@@ -162,11 +224,76 @@ declare class WeaverseClient {
      */
     private readonly directFetch;
     private getApiUrl;
+    /**
+     * Fetch data with caching support for both design mode and production.
+     * Uses direct fetch in design mode, Hydrogen's withCache 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: <T = unknown>(url: string, options?: RequestInit & {
         strategy?: CachingStrategy;
     }) => Promise<T>;
+    /**
+     * 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: (strategy?: CachingStrategy) => Promise<ThemeSettingsResponse>;
+    /**
+     * 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 HydrogenPageData with single main component containing the message
+     */
     generateFallbackPage: (message: string) => HydrogenPageData;
+    /**
+     * 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 (HOME, 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: 'HOME' })
+     *
+     * // Route-level project override
+     * const data = await weaverse.loadPage({
+     *   type: 'PAGE',
+     *   handle: 'about',
+     *   projectId: 'campaign-project-123'
+     * })
+     * ```
+     */
     loadPage: (params?: LoadPageParams) => Promise<WeaverseLoaderData | null>;
     execComponentLoader: (item: HydrogenComponentData) => Promise<HydrogenComponentData>;
 }
@@ -180,16 +307,17 @@ interface RouteLoaderArgs extends LoaderFunctionArgs {
         weaverse: WeaverseClient;
     };
 }
+type ComponentDataValue = string | number | boolean | undefined | null;
 interface HydrogenComponentData extends ElementData {
-    data?: {
-        [key: string]: any;
-    };
     children?: {
         id: string;
     }[];
     createdAt?: string;
-    updatedAt?: string;
+    data?: Record<string, ComponentDataValue | Record<string, unknown>>;
     deletedAt?: string;
+    id: string;
+    type: string;
+    updatedAt?: string;
 }
 /**
  * Optimized: Use Zod-inferred SchemaType directly instead of extending
@@ -197,9 +325,9 @@ interface HydrogenComponentData extends ElementData {
  */
 type HydrogenComponentSchema = SchemaType;
 interface HydrogenComponentProps<L = any> extends WeaverseElement {
+    children?: React$1.JSX.Element[];
     className?: string;
     loaderData?: L;
-    children?: React$1.JSX.Element[];
 }
 type WeaverseLoaderRequestInfo = {
     search: string;
@@ -238,18 +366,19 @@ type HydrogenElement = {
 };
 interface WeaverseHydrogenParams extends Omit<WeaverseCoreParams, 'ItemConstructor'> {
     data: HydrogenPageData;
-    pageId: string;
+    dataContext?: Record<string, unknown> | null;
     internal: Partial<WeaverseInternal>;
-    requestInfo: WeaverseLoaderRequestInfo;
+    isDesignMode?: boolean;
+    isPreviewMode?: boolean;
+    isRevisionPreview?: boolean;
+    pageId: string;
     projectId: string;
-    weaverseHost: string;
+    requestInfo: WeaverseLoaderRequestInfo;
+    sectionType?: string;
     weaverseApiBase: string;
     weaverseApiKey: string;
+    weaverseHost: string;
     weaverseVersion?: string;
-    isDesignMode?: boolean;
-    isPreviewMode?: boolean;
-    sectionType?: string;
-    dataContext?: Record<string, unknown> | null;
 }
 type HydrogenComponent<T extends HydrogenComponentProps = any> = {
     default: ForwardRefExoticComponent<T> | ((props: T) => React$1.JSX.Element);
@@ -278,6 +407,7 @@ type WeaverseProjectConfigs = {
     weaverseVersion?: string;
     isDesignMode?: boolean;
     isPreviewMode?: boolean;
+    isRevisionPreview?: boolean;
     sectionType?: string;
     publicEnv?: PublicEnv;
 };
@@ -301,10 +431,10 @@ type WeaverseLoaderData = {
     pageAssignment?: HydrogenPageAssignment;
 };
 interface HydrogenPageData extends WeaverseProjectDataType {
+    __cacheId?: string;
     id: string;
-    name: string;
     items: HydrogenComponentData[];
-    __cacheId?: string;
+    name: string;
     [key: string]: any;
 }
 type WeaverseI18n = I18nBase & {
@@ -562,11 +692,18 @@ type CreateHydrogenSchemaOptions = {
 };
 declare global {
     interface Window {
-        __weaverse: WeaverseHydrogen;
-        __weaverses: Record<string, WeaverseHydrogen>;
-        __weaverseThemeSettingsStore: ThemeSettingsStore;
+        __weaverse?: WeaverseHydrogen;
+        __weaverses?: Record<string, WeaverseHydrogen>;
+        __weaverseThemeSettingsStore?: ThemeSettingsStore;
     }
 }
+interface WeaverseStudio {
+    init: (weaverse: WeaverseHydrogen) => void;
+    refreshStudio: (params: WeaverseHydrogenParams) => void;
+}
+declare function hasWeaverseStudio(window: Window): window is Window & {
+    weaverseStudio: WeaverseStudio;
+};
 declare module '@shopify/remix-oxygen' {
     interface AppLoadContext {
         weaverse: WeaverseClient;
@@ -574,20 +711,20 @@ declare module '@shopify/remix-oxygen' {
 }
 declare module '@shopify/hydrogen' {
     interface HydrogenEnv {
-        WEAVERSE_PROJECT_ID: string;
-        WEAVERSE_HOST?: string;
-        WEAVERSE_API_BASE?: string;
-        WEAVERSE_API_KEY: string;
-        PUBLIC_STORE_DOMAIN: string;
-        PUBLIC_STOREFRONT_API_TOKEN: string;
-        PUBLIC_GOOGLE_GTM_ID: string;
-        JUDGEME_PRIVATE_API_TOKEN: string;
         CUSTOM_COLLECTION_BANNER_METAFIELD: string;
-        METAOBJECT_COLORS_TYPE: string;
+        JUDGEME_PRIVATE_API_TOKEN: string;
+        KLAVIYO_PRIVATE_API_TOKEN: string;
         METAOBJECT_COLOR_NAME_KEY: string;
         METAOBJECT_COLOR_VALUE_KEY: string;
-        KLAVIYO_PRIVATE_API_TOKEN: string;
+        METAOBJECT_COLORS_TYPE: string;
+        PUBLIC_GOOGLE_GTM_ID: string;
         PUBLIC_SHOPIFY_INBOX_SHOP_ID: string;
+        PUBLIC_STORE_DOMAIN: string;
+        PUBLIC_STOREFRONT_API_TOKEN: string;
+        WEAVERSE_API_BASE?: string;
+        WEAVERSE_API_KEY: string;
+        WEAVERSE_HOST?: string;
+        WEAVERSE_PROJECT_ID: string;
     }
 }
 /**
@@ -739,6 +876,21 @@ declare function getWeaverseConfigs(request: Request, env: HydrogenEnv): Weavers
 declare function generateDataFromSchema(schema: HydrogenComponentSchema | HydrogenThemeSchema): Record<string, any>;
 declare function getPreviewData(type: string, components: HydrogenComponent[], weaverseHost: string): WeaverseLoaderData;
 
+/**
+ * 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
+ * }
+ * ```
+ */
 declare function getSelectedProductOptions(request: Request): SelectedOptionInput[];
 declare const IMAGES_PLACEHOLDERS: {
     logo_white: string;
@@ -772,4 +924,4 @@ declare const IMAGES_PLACEHOLDERS: {
     product_18: string;
 };
 
-export { type CacheResponseValidator, type ComponentLoaderArgs, type CreateHydrogenSchemaOptions, 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, 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, createWeaverseDataContext, defaultComponents, generateDataFromSchema, getPreviewData, getRequestQueries, getSelectedProductOptions, getWeaverseConfigs, hasError, isFetchProjectPayload, isProjectIdFunction, isThemeSettingsResponse, isValidHydrogenSchema, isWithCacheFetchResponse, registerComponent, useThemeSettings, useWeaverseDataContext, withWeaverse };
+export { type CacheResponseValidator, type ComponentDataValue, type ComponentLoaderArgs, type CreateHydrogenSchemaOptions, 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, 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, createWeaverseDataContext, defaultComponents, generateDataFromSchema, getPreviewData, getRequestQueries, getSelectedProductOptions, getWeaverseConfigs, hasError, hasWeaverseStudio, isFetchProjectPayload, isProjectIdFunction, isThemeSettingsResponse, isValidHydrogenSchema, isWithCacheFetchResponse, registerComponent, useThemeSettings, useWeaverseDataContext, withWeaverse };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { SelectedOptionInput } from '@shopify/hydrogen/storefront-api-types';
-import { EventEmitter, Weaverse, WeaverseItemStore, ElementData, WeaverseElement, WeaverseProjectDataType, WeaverseCoreParams, WeaverseResourcePickerData } from '@weaverse/react';
+import { Weaverse, WeaverseItemStore, ElementData, WeaverseElement, WeaverseProjectDataType, WeaverseCoreParams, WeaverseResourcePickerData } from '@weaverse/react';
 export { PositionInputValue, WeaverseImage, WeaverseVideo, isBrowser, isIframe, useChildInstances, useItemInstance, useParentInstance, useWeaverse } from '@weaverse/react';
 import { PageType, InspectorGroup, SchemaType, ComponentPresets, SchemaValidationResult } from '@weaverse/schema';
 export * from '@weaverse/schema';
@@ -17,14 +17,20 @@ type WeaverseThemeData = {
     schema?: HydrogenThemeSchema;
     publicEnv?: PublicEnv;
 };
-declare class ThemeSettingsStore extends EventEmitter {
+declare class ThemeSettingsStore {
     settings: HydrogenThemeSettings;
     schema?: HydrogenThemeSchema;
     publicEnv?: PublicEnv;
+    private listeners;
+    private readonly MAX_LISTENERS;
+    private isDestroyed;
     constructor(data: WeaverseThemeData);
     updateThemeSettings: (newSettings: HydrogenThemeSettings) => void;
     getSnapshot: () => HydrogenThemeSettings;
     getServerSnapshot: () => HydrogenThemeSettings;
+    subscribe: (callback: () => void) => () => void;
+    private emit;
+    destroy: () => void;
 }
 
 declare class WeaverseHydrogenItem extends WeaverseItemStore {
@@ -43,6 +49,7 @@ declare class WeaverseHydrogen extends Weaverse {
     weaverseVersion: string;
     isDesignMode: boolean;
     isPreviewMode: boolean;
+    isRevisionPreview: boolean;
     sectionType: string;
     ItemConstructor: typeof WeaverseHydrogenItem;
     data: HydrogenPageData;
@@ -50,14 +57,69 @@ declare class WeaverseHydrogen extends Weaverse {
     static elementRegistry: Map<string, HydrogenElement>;
     constructor(params: WeaverseHydrogenParams);
 }
+/**
+ * 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' }
+ *   }
+ * })
+ * ```
+ */
 declare function registerComponent(element: HydrogenElement): void;
 declare const WeaverseHydrogenRoot: React$1.MemoExoticComponent<({ components, errorComponent: ErrorComponent, }: {
     components: HydrogenComponent[];
     errorComponent?: React.FC<{
-        error: any;
+        error: Error | unknown;
     }>;
 }) => react_jsx_runtime.JSX.Element>;
+/**
+ * Higher-order component that wraps your app with Weaverse theme settings context.
+ * Provides theme settings to all child components via React context.
+ *
+ * @param Component - The root component to wrap
+ * @returns Wrapped component with theme settings provider
+ *
+ * @example
+ * ```typescript
+ * import { withWeaverse } from '@weaverse/hydrogen'
+ *
+ * function App() {
+ *   return <div>My App</div>
+ * }
+ *
+ * export default withWeaverse(App)
+ * ```
+ */
 declare function withWeaverse(Component: ComponentType<any>): (props: JSX.IntrinsicAttributes) => react_jsx_runtime.JSX.Element;
+/**
+ * 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>
+ * }
+ * ```
+ */
 declare function useThemeSettings<T = HydrogenThemeSettings>(): T;
 
 declare class WeaverseClient {
@@ -162,11 +224,76 @@ declare class WeaverseClient {
      */
     private readonly directFetch;
     private getApiUrl;
+    /**
+     * Fetch data with caching support for both design mode and production.
+     * Uses direct fetch in design mode, Hydrogen's withCache 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: <T = unknown>(url: string, options?: RequestInit & {
         strategy?: CachingStrategy;
     }) => Promise<T>;
+    /**
+     * 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: (strategy?: CachingStrategy) => Promise<ThemeSettingsResponse>;
+    /**
+     * 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 HydrogenPageData with single main component containing the message
+     */
     generateFallbackPage: (message: string) => HydrogenPageData;
+    /**
+     * 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 (HOME, 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: 'HOME' })
+     *
+     * // Route-level project override
+     * const data = await weaverse.loadPage({
+     *   type: 'PAGE',
+     *   handle: 'about',
+     *   projectId: 'campaign-project-123'
+     * })
+     * ```
+     */
     loadPage: (params?: LoadPageParams) => Promise<WeaverseLoaderData | null>;
     execComponentLoader: (item: HydrogenComponentData) => Promise<HydrogenComponentData>;
 }
@@ -180,16 +307,17 @@ interface RouteLoaderArgs extends LoaderFunctionArgs {
         weaverse: WeaverseClient;
     };
 }
+type ComponentDataValue = string | number | boolean | undefined | null;
 interface HydrogenComponentData extends ElementData {
-    data?: {
-        [key: string]: any;
-    };
     children?: {
         id: string;
     }[];
     createdAt?: string;
-    updatedAt?: string;
+    data?: Record<string, ComponentDataValue | Record<string, unknown>>;
     deletedAt?: string;
+    id: string;
+    type: string;
+    updatedAt?: string;
 }
 /**
  * Optimized: Use Zod-inferred SchemaType directly instead of extending
@@ -197,9 +325,9 @@ interface HydrogenComponentData extends ElementData {
  */
 type HydrogenComponentSchema = SchemaType;
 interface HydrogenComponentProps<L = any> extends WeaverseElement {
+    children?: React$1.JSX.Element[];
     className?: string;
     loaderData?: L;
-    children?: React$1.JSX.Element[];
 }
 type WeaverseLoaderRequestInfo = {
     search: string;
@@ -238,18 +366,19 @@ type HydrogenElement = {
 };
 interface WeaverseHydrogenParams extends Omit<WeaverseCoreParams, 'ItemConstructor'> {
     data: HydrogenPageData;
-    pageId: string;
+    dataContext?: Record<string, unknown> | null;
     internal: Partial<WeaverseInternal>;
-    requestInfo: WeaverseLoaderRequestInfo;
+    isDesignMode?: boolean;
+    isPreviewMode?: boolean;
+    isRevisionPreview?: boolean;
+    pageId: string;
     projectId: string;
-    weaverseHost: string;
+    requestInfo: WeaverseLoaderRequestInfo;
+    sectionType?: string;
     weaverseApiBase: string;
     weaverseApiKey: string;
+    weaverseHost: string;
     weaverseVersion?: string;
-    isDesignMode?: boolean;
-    isPreviewMode?: boolean;
-    sectionType?: string;
-    dataContext?: Record<string, unknown> | null;
 }
 type HydrogenComponent<T extends HydrogenComponentProps = any> = {
     default: ForwardRefExoticComponent<T> | ((props: T) => React$1.JSX.Element);
@@ -278,6 +407,7 @@ type WeaverseProjectConfigs = {
     weaverseVersion?: string;
     isDesignMode?: boolean;
     isPreviewMode?: boolean;
+    isRevisionPreview?: boolean;
     sectionType?: string;
     publicEnv?: PublicEnv;
 };
@@ -301,10 +431,10 @@ type WeaverseLoaderData = {
     pageAssignment?: HydrogenPageAssignment;
 };
 interface HydrogenPageData extends WeaverseProjectDataType {
+    __cacheId?: string;
     id: string;
-    name: string;
     items: HydrogenComponentData[];
-    __cacheId?: string;
+    name: string;
     [key: string]: any;
 }
 type WeaverseI18n = I18nBase & {
@@ -562,11 +692,18 @@ type CreateHydrogenSchemaOptions = {
 };
 declare global {
     interface Window {
-        __weaverse: WeaverseHydrogen;
-        __weaverses: Record<string, WeaverseHydrogen>;
-        __weaverseThemeSettingsStore: ThemeSettingsStore;
+        __weaverse?: WeaverseHydrogen;
+        __weaverses?: Record<string, WeaverseHydrogen>;
+        __weaverseThemeSettingsStore?: ThemeSettingsStore;
     }
 }
+interface WeaverseStudio {
+    init: (weaverse: WeaverseHydrogen) => void;
+    refreshStudio: (params: WeaverseHydrogenParams) => void;
+}
+declare function hasWeaverseStudio(window: Window): window is Window & {
+    weaverseStudio: WeaverseStudio;
+};
 declare module '@shopify/remix-oxygen' {
     interface AppLoadContext {
         weaverse: WeaverseClient;
@@ -574,20 +711,20 @@ declare module '@shopify/remix-oxygen' {
 }
 declare module '@shopify/hydrogen' {
     interface HydrogenEnv {
-        WEAVERSE_PROJECT_ID: string;
-        WEAVERSE_HOST?: string;
-        WEAVERSE_API_BASE?: string;
-        WEAVERSE_API_KEY: string;
-        PUBLIC_STORE_DOMAIN: string;
-        PUBLIC_STOREFRONT_API_TOKEN: string;
-        PUBLIC_GOOGLE_GTM_ID: string;
-        JUDGEME_PRIVATE_API_TOKEN: string;
         CUSTOM_COLLECTION_BANNER_METAFIELD: string;
-        METAOBJECT_COLORS_TYPE: string;
+        JUDGEME_PRIVATE_API_TOKEN: string;
+        KLAVIYO_PRIVATE_API_TOKEN: string;
         METAOBJECT_COLOR_NAME_KEY: string;
         METAOBJECT_COLOR_VALUE_KEY: string;
-        KLAVIYO_PRIVATE_API_TOKEN: string;
+        METAOBJECT_COLORS_TYPE: string;
+        PUBLIC_GOOGLE_GTM_ID: string;
         PUBLIC_SHOPIFY_INBOX_SHOP_ID: string;
+        PUBLIC_STORE_DOMAIN: string;
+        PUBLIC_STOREFRONT_API_TOKEN: string;
+        WEAVERSE_API_BASE?: string;
+        WEAVERSE_API_KEY: string;
+        WEAVERSE_HOST?: string;
+        WEAVERSE_PROJECT_ID: string;
     }
 }
 /**
@@ -739,6 +876,21 @@ declare function getWeaverseConfigs(request: Request, env: HydrogenEnv): Weavers
 declare function generateDataFromSchema(schema: HydrogenComponentSchema | HydrogenThemeSchema): Record<string, any>;
 declare function getPreviewData(type: string, components: HydrogenComponent[], weaverseHost: string): WeaverseLoaderData;
 
+/**
+ * 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
+ * }
+ * ```
+ */
 declare function getSelectedProductOptions(request: Request): SelectedOptionInput[];
 declare const IMAGES_PLACEHOLDERS: {
     logo_white: string;
@@ -772,4 +924,4 @@ declare const IMAGES_PLACEHOLDERS: {
     product_18: string;
 };
 
-export { type CacheResponseValidator, type ComponentLoaderArgs, type CreateHydrogenSchemaOptions, 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, 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, createWeaverseDataContext, defaultComponents, generateDataFromSchema, getPreviewData, getRequestQueries, getSelectedProductOptions, getWeaverseConfigs, hasError, isFetchProjectPayload, isProjectIdFunction, isThemeSettingsResponse, isValidHydrogenSchema, isWithCacheFetchResponse, registerComponent, useThemeSettings, useWeaverseDataContext, withWeaverse };
+export { type CacheResponseValidator, type ComponentDataValue, type ComponentLoaderArgs, type CreateHydrogenSchemaOptions, 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, 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, createWeaverseDataContext, defaultComponents, generateDataFromSchema, getPreviewData, getRequestQueries, getSelectedProductOptions, getWeaverseConfigs, hasError, hasWeaverseStudio, isFetchProjectPayload, isProjectIdFunction, isThemeSettingsResponse, isValidHydrogenSchema, isWithCacheFetchResponse, registerComponent, useThemeSettings, useWeaverseDataContext, withWeaverse };