@weaverse/next 0.1.0-alpha.0 → 0.1.0-alpha.1

package/dist/index.d.ts

@@ -1,163 +1,11 @@
-import { WeaverseElement, WeaverseResourcePickerData } from '@weaverse/react';
+import { Weaverse } from '@weaverse/react';
 export { isBrowser, isIframe, useChildInstances, useItemInstance, useParentInstance, useWeaverse } from '@weaverse/react';
-import { PageType, SchemaType } from '@weaverse/schema';
 export { InspectorGroup, PageType, SchemaType, createSchema } from '@weaverse/schema';
-import * as react from 'react';
-import { ReactNode, ComponentType, ForwardRefExoticComponent } from 'react';
+import { d as WeaverseNextClientConfig, c as WeaverseNextClient, e as WeaverseNextCommerceContext, q as WeaverseNextRequestContext, n as WeaverseNextLoaderData, r as WeaverseNextRequestInfo, t as WeaverseNextRuntimeInternal, s as WeaverseNextRuntimeConfig, A as WeaverseNextThemeSettingsStore } from './types-DvEeLX6L.js';
+export { W as WeaverseCollection, f as WeaverseNextComponent, g as WeaverseNextComponentData, h as WeaverseNextComponentLoaderArgs, i as WeaverseNextComponentProps, l as WeaverseNextI18n, m as WeaverseNextLoadPageInput, o as WeaverseNextPageData, x as WeaverseNextStorefront, B as WeaverseProduct } from './types-DvEeLX6L.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-
-/**
- * Locale/market info passed through to component loaders and the Storefront
- * client. Kept structurally close to Hydrogen's `WeaverseI18n` but without the
- * `@shopify/hydrogen` `I18nBase` dependency so the adapter stays framework
- * neutral.
- */
-interface WeaverseNextI18n {
-    country?: string;
-    label?: string;
-    language?: string;
-    locale?: string;
-    pathPrefix?: string;
-    [key: string]: unknown;
-}
-/**
- * Minimal Storefront client shape required by component loaders. The host app
- * provides this (public or private token mode); Weaverse never owns it.
- */
-interface WeaverseNextStorefront {
-    i18n?: WeaverseNextI18n;
-    query: (query: string, options?: unknown) => Promise<unknown>;
-    [key: string]: unknown;
-}
-/**
- * App-provided commerce context. `storefront` is the only v0 must-have; cart
- * and customer-account stay app-owned and are passed through untouched.
- */
-interface WeaverseNextCommerceContext {
-    cart?: unknown;
-    customerAccount?: unknown;
-    storefront?: WeaverseNextStorefront;
-    [key: string]: unknown;
-}
-/**
- * Explicit, framework-neutral replacement for React Router's
- * `LoaderFunctionArgs`. Built by the Next route/page from params + headers +
- * searchParams instead of an implicit loader context.
- */
-interface WeaverseNextRequestContext {
-    handle?: string;
-    headers?: Headers;
-    i18n?: WeaverseNextI18n;
-    isDesignMode?: boolean;
-    isPreviewMode?: boolean;
-    isRevisionPreview?: boolean;
-    pageType?: PageType;
-    pathname?: string;
-    searchParams?: URLSearchParams;
-    sectionType?: string;
-    url?: URL | string;
-    [key: string]: unknown;
-}
-/** A single serialized item in a Weaverse page tree. */
-interface WeaverseNextComponentData {
-    children?: WeaverseNextComponentData[] | {
-        id: string;
-    }[];
-    data?: Record<string, unknown>;
-    id: string;
-    /** Attached by {@link runWeaverseComponentLoaders} after a loader runs. */
-    loaderData?: unknown;
-    type: string;
-    [key: string]: unknown;
-}
-/** Serialized page tree fetched from Weaverse. */
-interface WeaverseNextPageData {
-    id: string;
-    items: WeaverseNextComponentData[];
-    name?: string;
-    rootId?: string;
-    [key: string]: unknown;
-}
-/**
- * Top-level payload returned by `client.loadPage`. Kept close to Hydrogen's
- * `WeaverseLoaderData` so registered components stay portable.
- */
-interface WeaverseNextLoaderData {
-    configs?: Record<string, unknown>;
-    page: WeaverseNextPageData;
-    pageAssignment?: Record<string, unknown>;
-    project?: Record<string, unknown>;
-    [key: string]: unknown;
-}
-/** Props injected into every registered Weaverse component. */
-interface WeaverseNextComponentProps<L = unknown> extends Partial<WeaverseElement> {
-    children?: ReactNode;
-    className?: string;
-    loaderData?: L;
-    [key: string]: unknown;
-}
-/**
- * Arguments passed to a component `loader`. `commerce.storefront` is the
- * explicit contract; `weaverse.storefront` exists as a compatibility alias for
- * Pilot-style loaders that call `weaverse.storefront.query(...)`.
- */
-interface WeaverseNextComponentLoaderArgs<TData = unknown> {
-    commerce?: WeaverseNextCommerceContext;
-    context?: WeaverseNextRequestContext;
-    data: TData;
-    weaverse: WeaverseNextClient;
-}
-/** Registered component module shape: `default` + `schema` + optional `loader`. */
-interface WeaverseNextComponent<TProps extends WeaverseNextComponentProps = WeaverseNextComponentProps> {
-    default: ComponentType<TProps> | ForwardRefExoticComponent<TProps>;
-    loader?: (args: WeaverseNextComponentLoaderArgs) => Promise<unknown>;
-    schema: SchemaType;
-}
-/** Input for `client.loadPage`. The Next route maps `params` → `type/handle`. */
-interface WeaverseNextLoadPageInput {
-    handle?: string;
-    locale?: string;
-    type?: PageType;
-    [key: string]: unknown;
-}
-interface WeaverseNextClientConfig {
-    commerce?: WeaverseNextCommerceContext;
-    components: WeaverseNextComponent[];
-    /**
-     * Injected page fetcher. v0 delegates network I/O to the host app so the
-     * adapter can be tested without real Weaverse API calls.
-     */
-    fetchPage?: (input: WeaverseNextLoadPageInput) => Promise<WeaverseNextLoaderData | null>;
-    /** Injected theme-settings fetcher. */
-    fetchThemeSettings?: (context?: WeaverseNextRequestContext) => Promise<unknown>;
-    projectId: string;
-    requestContext?: WeaverseNextRequestContext;
-    themeSchema?: unknown;
-    themeSettings?: Record<string, unknown>;
-}
-/**
- * Request-safe client returned by {@link createWeaverseNextClient}. Holds the
- * registry/config plus the currently loaded page data, and is the object passed
- * to component loaders as `weaverse`.
- */
-interface WeaverseNextClient {
-    commerce?: WeaverseNextCommerceContext;
-    components: WeaverseNextComponent[];
-    /** Currently loaded page payload (set by `loadPage`). */
-    data: WeaverseNextLoaderData | null;
-    /** Data-connector context handed to the React renderer. */
-    dataContext: Record<string, unknown>;
-    loadPage: (input?: WeaverseNextLoadPageInput) => Promise<WeaverseNextLoaderData | null>;
-    loadThemeSettings: (context?: WeaverseNextRequestContext) => Promise<unknown>;
-    projectId: string;
-    requestContext?: WeaverseNextRequestContext;
-    /** Compatibility alias for `commerce.storefront`. */
-    storefront?: WeaverseNextStorefront;
-    themeSchema?: unknown;
-    themeSettings: Record<string, unknown>;
-}
-type WeaverseProduct = WeaverseResourcePickerData;
-type WeaverseCollection = WeaverseResourcePickerData;
+import * as react from 'react';
+import { ReactNode } from 'react';
 
 /**
  * Create a {@link WeaverseNextClient} from explicit config.
@@ -187,8 +35,9 @@ declare function useWeaversePageData<T = unknown>(): T;
 /** Read the app-provided commerce context (storefront/cart/customer). */
 declare function useWeaverseCommerce<T = WeaverseNextCommerceContext>(): T;
 /**
- * Read Weaverse theme settings. Next version backed by provider root/theme
- * data (`client.themeSettings`), not the Hydrogen theme-settings store.
+ * Read live Weaverse theme settings. The Studio bridge updates the provider's
+ * external store via `updateThemeSettings`, so components re-render during live
+ * design-mode edits.
  */
 declare function useThemeSettings<T = Record<string, unknown>>(): T;
 
@@ -262,4 +111,74 @@ interface WeaverseNextRendererProps {
  */
 declare const WeaverseNextRenderer: react.MemoExoticComponent<(props: WeaverseNextRendererProps) => react_jsx_runtime.JSX.Element | null>;
 
-export { type RunComponentLoadersArgs, type WeaverseCollection, type WeaverseNextClient, type WeaverseNextClientConfig, type WeaverseNextCommerceContext, type WeaverseNextComponent, type WeaverseNextComponentData, type WeaverseNextComponentLoaderArgs, type WeaverseNextComponentProps, type WeaverseNextI18n, type WeaverseNextLoadPageInput, type WeaverseNextLoaderData, type WeaverseNextPageData, WeaverseNextProvider, type WeaverseNextProviderProps, WeaverseNextRenderer, type WeaverseNextRendererProps, type WeaverseNextRequestContext, type WeaverseNextStorefront, type WeaverseProduct, createWeaverseNextClient, runWeaverseComponentLoaders, useThemeSettings, useWeaverseCommerce, useWeaversePageData, useWeaverseRootData };
+/**
+ * Build the Hydrogen-like request info shape consumed by the Studio bridge.
+ * Duplicate query keys keep the last value, matching `URLSearchParams` iteration
+ * assignment and Hydrogen's practical query-object behavior.
+ */
+declare function buildWeaverseNextRequestInfo(context?: WeaverseNextRequestContext): WeaverseNextRequestInfo;
+
+declare global {
+    interface Window {
+        __weaverse?: WeaverseNextRuntime;
+        __weaverses?: Record<string, WeaverseNextRuntime>;
+    }
+}
+declare class WeaverseNextRuntime extends Weaverse {
+    pageId: string;
+    internal: WeaverseNextRuntimeInternal;
+    requestInfo: WeaverseNextRequestInfo;
+    isPreviewMode: boolean;
+    isRevisionPreview: boolean;
+    sectionType?: string;
+    translationMap: Record<string, unknown>;
+    translationLocale: string;
+    translationLanguageId: string;
+    constructor(config: WeaverseNextRuntimeConfig);
+    extractTranslationSidecar: () => undefined;
+    setTranslationSidecar: (map?: Record<string, unknown>, locale?: string, languageId?: string) => void;
+    updateTranslation: () => undefined;
+    getTranslationChanges: () => undefined;
+}
+declare function createWeaverseNextRuntime(config: WeaverseNextRuntimeConfig): WeaverseNextRuntime;
+declare function bindWeaverseNextStudioRuntime(runtime: WeaverseNextRuntime): boolean;
+
+interface WeaverseNextStudioBridgeProps {
+    navigate?: WeaverseNextRuntimeInternal['navigate'];
+    revalidate?: WeaverseNextRuntimeInternal['revalidate'];
+    runtime: WeaverseNextRuntime;
+}
+/** Page-level Studio runtime binder. */
+declare function WeaverseNextStudioBridge(props: WeaverseNextStudioBridgeProps): null;
+
+interface WeaverseNextStudioConnectProps {
+    context?: WeaverseNextRequestContext;
+    storefrontHostname?: string;
+}
+/** Root-level Studio script connector for Next client boundaries. */
+declare function WeaverseNextStudioConnect(props: WeaverseNextStudioConnectProps): null;
+
+interface ResolveWeaverseNextStudioScriptSrcOptions {
+    framework?: 'hydrogen' | 'next';
+    storefrontHostname?: string;
+}
+/**
+ * Resolve the Studio script URL from request/search context. v0 intentionally
+ * reuses the existing structural Hydrogen bridge script until a concrete Builder
+ * incompatibility requires a dedicated Next bundle.
+ */
+declare function resolveWeaverseNextStudioScriptSrc(context?: WeaverseNextRequestContext, options?: ResolveWeaverseNextStudioScriptSrcOptions): string | null;
+
+interface CreateWeaverseNextThemeSettingsStoreOptions {
+    publicEnv?: Record<string, string | undefined>;
+    schema?: unknown;
+    settings?: Record<string, unknown>;
+}
+/**
+ * Small external store shape compatible with the Studio bridge and React's
+ * `useSyncExternalStore` contract. The bridge calls `updateThemeSettings` during
+ * live theme edits, so keep that method name stable.
+ */
+declare function createWeaverseNextThemeSettingsStore(options?: CreateWeaverseNextThemeSettingsStoreOptions): WeaverseNextThemeSettingsStore;
+
+export { type CreateWeaverseNextThemeSettingsStoreOptions, type ResolveWeaverseNextStudioScriptSrcOptions, type RunComponentLoadersArgs, WeaverseNextClient, WeaverseNextClientConfig, WeaverseNextCommerceContext, WeaverseNextLoaderData, WeaverseNextProvider, type WeaverseNextProviderProps, WeaverseNextRenderer, type WeaverseNextRendererProps, WeaverseNextRequestContext, WeaverseNextRequestInfo, WeaverseNextRuntime, WeaverseNextRuntimeConfig, WeaverseNextRuntimeInternal, WeaverseNextStudioBridge, type WeaverseNextStudioBridgeProps, WeaverseNextStudioConnect, type WeaverseNextStudioConnectProps, WeaverseNextThemeSettingsStore, bindWeaverseNextStudioRuntime, buildWeaverseNextRequestInfo, createWeaverseNextClient, createWeaverseNextRuntime, createWeaverseNextThemeSettingsStore, resolveWeaverseNextStudioScriptSrc, runWeaverseComponentLoaders, useThemeSettings, useWeaverseCommerce, useWeaversePageData, useWeaverseRootData };