@weaverse/next 0.1.0-alpha.2 → 0.1.0-alpha.20

package/src/use-weaverse-next-studio.tsx

@@ -0,0 +1,106 @@
+'use client'
+
+import { useRouter } from 'next/navigation'
+import { useRef } from 'react'
+import {
+  DEFAULT_REVALIDATE_ENDPOINT,
+  revalidateWeaverseNextItem,
+} from './revalidate-item'
+import type { WeaverseNextRuntime } from './runtime'
+import { WeaverseNextStudioBridge } from './studio-bridge'
+import {
+  type CreateWeaverseNextStudioInternalsOptions,
+  createWeaverseNextStudioInternals,
+  type WeaverseNextStudioInternals,
+} from './studio-router'
+import type { WeaverseNextRuntimeInternal } from './types'
+
+/**
+ * Resolve stable Studio `navigate` / `revalidate` callbacks from the Next App
+ * Router. `useRouter()` is stable across renders, but the derived callbacks are
+ * cached in a ref keyed on the router instance so the bridge's bind effect
+ * (which depends on `navigate` / `revalidate` identity) doesn't re-run — and
+ * re-`refreshStudio` — on every render.
+ */
+export function useWeaverseNextStudioInternals(
+  options?: CreateWeaverseNextStudioInternalsOptions
+): WeaverseNextStudioInternals {
+  let router = useRouter()
+  let ref = useRef<{
+    internals: WeaverseNextStudioInternals
+    replace: boolean | undefined
+    router: typeof router
+  } | null>(null)
+
+  if (
+    !ref.current ||
+    ref.current.router !== router ||
+    ref.current.replace !== options?.replace
+  ) {
+    ref.current = {
+      internals: createWeaverseNextStudioInternals(router, options),
+      replace: options?.replace,
+      router,
+    }
+  }
+
+  return ref.current.internals
+}
+
+/** Props for the page-level Next App Router Studio binder. */
+export interface WeaverseNextStudioProps
+  extends CreateWeaverseNextStudioInternalsOptions {
+  /**
+   * Route the app mounted with `createWeaverseNextRevalidateHandler`.
+   * Defaults to `/api/weaverse/revalidate`.
+   */
+  revalidateEndpoint?: string
+  /** Browser runtime to bind to Builder Studio. */
+  runtime: WeaverseNextRuntime
+}
+
+/**
+ * Page-level Studio binder wired to the Next App Router. Mirrors Hydrogen's
+ * `useStudio` (which binds the runtime and feeds it React Router's `navigate` /
+ * `revalidate`): it resolves the App Router callbacks via
+ * {@link useWeaverseNextStudioInternals} and hands them to
+ * {@link WeaverseNextStudioBridge}, so consuming apps get Studio navigation and
+ * revalidation without manually wiring `next/navigation`.
+ *
+ * Client-only — it is the single place `@weaverse/next` touches
+ * `next/navigation`, keeping the runtime/renderer and `@weaverse/next/server`
+ * free of router imports.
+ */
+export function WeaverseNextStudio(props: WeaverseNextStudioProps) {
+  let { runtime, replace, revalidateEndpoint } = props
+  let { navigate, revalidate } = useWeaverseNextStudioInternals({ replace })
+  let endpoint = revalidateEndpoint ?? DEFAULT_REVALIDATE_ENDPOINT
+  // Cache per runtime+endpoint so the bridge bind effect (keyed on callback
+  // identity) doesn't re-run — and re-`refreshStudio` — on every render.
+  // `itemInstances` is a static registry shared by all Weaverse runtimes, so
+  // any live runtime reference resolves the edited item.
+  let revalidateItemRef = useRef<{
+    endpoint: string
+    revalidateItem: NonNullable<WeaverseNextRuntimeInternal['revalidateItem']>
+    runtime: WeaverseNextRuntime
+  } | null>(null)
+  if (
+    revalidateItemRef.current?.endpoint !== endpoint ||
+    revalidateItemRef.current.runtime !== runtime
+  ) {
+    revalidateItemRef.current = {
+      endpoint,
+      revalidateItem: (draftItem) =>
+        revalidateWeaverseNextItem(runtime, draftItem, endpoint),
+      runtime,
+    }
+  }
+  return (
+    <WeaverseNextStudioBridge
+      navigate={navigate}
+      revalidate={revalidate}
+      revalidateItem={revalidateItemRef.current.revalidateItem}
+      runtime={runtime}
+    />
+  )
+}

package/src/utils.ts

@@ -0,0 +1,37 @@
+import type { SchemaType } from '@weaverse/schema'
+import type { WeaverseNextThemeSchema } from './types'
+
+/**
+ * Generate default component data from a schema's `settings` inputs.
+ *
+ * Mirrors Hydrogen's `generateDataFromSchema` (settings → `{ [name]:
+ * defaultValue }`) but is kept local so `@weaverse/next` doesn't depend on
+ * `@weaverse/hydrogen`. Falls back to the deprecated `inspector` array when a
+ * schema predates `settings`.
+ */
+export function generateDataFromSchema(
+  schema: SchemaType | WeaverseNextThemeSchema | undefined
+): Record<string, unknown> {
+  let data: Record<string, unknown> = {}
+  if (!schema) {
+    return data
+  }
+
+  let groups =
+    (schema.settings as {
+      inputs?: { name?: string; defaultValue?: unknown }[]
+    }[]) ??
+    (schema as { inspector?: typeof groups }).inspector ??
+    []
+
+  for (let group of groups) {
+    for (let input of group?.inputs ?? []) {
+      let { name, defaultValue } = input
+      if (name && defaultValue !== null && defaultValue !== undefined) {
+        data[name] = defaultValue
+      }
+    }
+  }
+
+  return data
+}

package/dist/chunk-SS6QUKYY.mjs

@@ -1,149 +0,0 @@
-// src/utils.ts
-function generateDataFromSchema(schema) {
-  let data = {};
-  if (!schema) {
-    return data;
-  }
-  let groups = schema.settings ?? schema.inspector ?? [];
-  for (let group of groups) {
-    for (let input of group?.inputs ?? []) {
-      let { name, defaultValue } = input;
-      if (name && defaultValue !== null && defaultValue !== void 0) {
-        data[name] = defaultValue;
-      }
-    }
-  }
-  return data;
-}
-
-// src/loader.ts
-function isItemNode(node) {
-  return typeof node === "object" && node !== null && typeof node.type === "string";
-}
-function cloneItem(item) {
-  return {
-    ...item,
-    children: Array.isArray(item.children) ? item.children.map(
-      (child) => isItemNode(child) ? cloneItem(child) : { ...child }
-    ) : item.children
-  };
-}
-async function runWeaverseComponentLoaders(args) {
-  let { client, context, commerce } = args;
-  let sourceData = args.data ?? client.data;
-  if (!sourceData) {
-    return null;
-  }
-  if (!sourceData.page.items.length) {
-    return sourceData;
-  }
-  let data = {
-    ...sourceData,
-    page: {
-      ...sourceData.page,
-      items: sourceData.page.items.map(cloneItem)
-    }
-  };
-  let items = data.page.items;
-  let componentMap = /* @__PURE__ */ new Map();
-  for (let component of client.components) {
-    if (component?.schema?.type) {
-      componentMap.set(component.schema.type, component);
-    }
-  }
-  let visited = /* @__PURE__ */ new Set();
-  let resolvedContext = context ?? client.requestContext;
-  let resolvedCommerce = commerce ?? client.commerce;
-  let resolvedWeaverse = resolvedCommerce === client.commerce ? client : {
-    ...client,
-    commerce: resolvedCommerce,
-    storefront: resolvedCommerce?.storefront
-  };
-  async function walk(nodes) {
-    for (let item of nodes) {
-      if (!item || visited.has(item.id)) {
-        continue;
-      }
-      visited.add(item.id);
-      let component = componentMap.get(item.type);
-      if (component?.loader) {
-        try {
-          item.loaderData = await component.loader({
-            data: { ...generateDataFromSchema(component.schema), ...item.data },
-            weaverse: resolvedWeaverse,
-            context: resolvedContext,
-            commerce: resolvedCommerce
-          });
-        } catch (error) {
-          console.warn("\u274C Item loader run failed.", item.type, item.id, error);
-        }
-      }
-      let children = item.children;
-      if (Array.isArray(children)) {
-        let inlineChildren = children.filter(
-          isItemNode
-        );
-        if (inlineChildren.length) {
-          await walk(inlineChildren);
-        }
-      }
-    }
-  }
-  await walk(items);
-  return data;
-}
-
-// src/request-info.ts
-function toUrl(value) {
-  return typeof value === "string" ? new URL(value, "http://localhost") : value;
-}
-function getSearchParamsFromContext(context) {
-  if (context?.searchParams) {
-    return new URLSearchParams(context.searchParams);
-  }
-  if (context?.url) {
-    let url = toUrl(context.url);
-    return new URLSearchParams(url.searchParams);
-  }
-  return new URLSearchParams();
-}
-function getPathnameFromContext(context) {
-  if (context?.pathname) {
-    return context.pathname;
-  }
-  if (context?.url) {
-    let url = toUrl(context.url);
-    return url.pathname || "/";
-  }
-  return "/";
-}
-function coerceQueryValue(value) {
-  if (value === "true") {
-    return true;
-  }
-  if (value === "false") {
-    return false;
-  }
-  return value;
-}
-function toQueryRecord(searchParams) {
-  let queries = {};
-  for (let [key, value] of searchParams.entries()) {
-    queries[key] = coerceQueryValue(value);
-  }
-  return queries;
-}
-function buildWeaverseNextRequestInfo(context) {
-  let searchParams = getSearchParamsFromContext(context);
-  let search = searchParams.toString();
-  return {
-    pathname: getPathnameFromContext(context),
-    search: search ? `?${search}` : "",
-    queries: toQueryRecord(searchParams),
-    ...context?.i18n ? { i18n: context.i18n } : {}
-  };
-}
-
-export { buildWeaverseNextRequestInfo, generateDataFromSchema, runWeaverseComponentLoaders };
-//# sourceMappingURL=chunk-SS6QUKYY.mjs.map
-//# sourceMappingURL=chunk-SS6QUKYY.mjs.map

package/dist/chunk-SS6QUKYY.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils.ts","../src/loader.ts","../src/request-info.ts"],"names":[],"mappings":"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","file":"chunk-SS6QUKYY.mjs","sourcesContent":["import type { SchemaType } from '@weaverse/schema'\n\n/**\n * Generate default component data from a schema's `settings` inputs.\n *\n * Mirrors Hydrogen's `generateDataFromSchema` (settings → `{ [name]:\n * defaultValue }`) but is kept local so `@weaverse/next` doesn't depend on\n * `@weaverse/hydrogen`. Falls back to the deprecated `inspector` array when a\n * schema predates `settings`.\n */\nexport function generateDataFromSchema(\n  schema: SchemaType | undefined\n): Record<string, unknown> {\n  let data: Record<string, unknown> = {}\n  if (!schema) {\n    return data\n  }\n\n  let groups =\n    (schema.settings as {\n      inputs?: { name?: string; defaultValue?: unknown }[]\n    }[]) ??\n    (schema as { inspector?: typeof groups }).inspector ??\n    []\n\n  for (let group of groups) {\n    for (let input of group?.inputs ?? []) {\n      let { name, defaultValue } = input\n      if (name && defaultValue !== null && defaultValue !== undefined) {\n        data[name] = defaultValue\n      }\n    }\n  }\n\n  return data\n}\n","import type {\n  WeaverseNextClient,\n  WeaverseNextCommerceContext,\n  WeaverseNextComponent,\n  WeaverseNextComponentData,\n  WeaverseNextLoaderData,\n  WeaverseNextRequestContext,\n} from './types'\nimport { generateDataFromSchema } from './utils'\n\nexport interface RunComponentLoadersArgs {\n  client: WeaverseNextClient\n  commerce?: WeaverseNextCommerceContext\n  context?: WeaverseNextRequestContext\n  /** Page payload to walk; defaults to `client.data`. */\n  data?: WeaverseNextLoaderData | null\n}\n\nfunction isItemNode(node: unknown): node is WeaverseNextComponentData {\n  return (\n    typeof node === 'object' &&\n    node !== null &&\n    typeof (node as WeaverseNextComponentData).type === 'string'\n  )\n}\n\nfunction cloneItem(item: WeaverseNextComponentData): WeaverseNextComponentData {\n  return {\n    ...item,\n    children: Array.isArray(item.children)\n      ? item.children.map((child) =>\n          isItemNode(child) ? cloneItem(child) : { ...child }\n        )\n      : item.children,\n  }\n}\n\n/**\n * Walk a serialized page tree and run each registered component's `loader`,\n * attaching the result to the item as `loaderData`.\n *\n * Loaders receive explicit `commerce.storefront` (and `weaverse.storefront` as\n * a compatibility alias via the client). Children are walked recursively when\n * they are inline item objects; flat `items` arrays are covered by the\n * top-level walk.\n *\n * @returns a cloned `data` object with `loaderData` attached to cloned items.\n */\nexport async function runWeaverseComponentLoaders(\n  args: RunComponentLoadersArgs\n): Promise<WeaverseNextLoaderData | null> {\n  let { client, context, commerce } = args\n  let sourceData = args.data ?? client.data\n  if (!sourceData) {\n    return null\n  }\n  if (!sourceData.page.items.length) {\n    return sourceData\n  }\n\n  let data: WeaverseNextLoaderData = {\n    ...sourceData,\n    page: {\n      ...sourceData.page,\n      items: sourceData.page.items.map(cloneItem),\n    },\n  }\n  let items = data.page.items\n\n  let componentMap = new Map<string, WeaverseNextComponent>()\n  for (let component of client.components) {\n    if (component?.schema?.type) {\n      componentMap.set(component.schema.type, component)\n    }\n  }\n\n  let visited = new Set<string>()\n  let resolvedContext = context ?? client.requestContext\n  let resolvedCommerce = commerce ?? client.commerce\n\n  // Per-call `weaverse` alias. When a request-scoped `commerce` is passed, the\n  // `weaverse.storefront` compatibility alias must resolve to *that* storefront,\n  // not the client's construction-time commerce. Pilot-style loaders call\n  // `weaverse.storefront.query(...)`, so a stale alias would query the wrong\n  // (or an undefined) storefront. When no override is given we reuse the client\n  // as-is to preserve its prototype getters.\n  let resolvedWeaverse: WeaverseNextClient =\n    resolvedCommerce === client.commerce\n      ? client\n      : {\n          ...client,\n          commerce: resolvedCommerce,\n          storefront: resolvedCommerce?.storefront,\n        }\n\n  async function walk(nodes: WeaverseNextComponentData[]) {\n    for (let item of nodes) {\n      if (!item || visited.has(item.id)) {\n        continue\n      }\n      visited.add(item.id)\n\n      let component = componentMap.get(item.type)\n      if (component?.loader) {\n        try {\n          item.loaderData = await component.loader({\n            data: { ...generateDataFromSchema(component.schema), ...item.data },\n            weaverse: resolvedWeaverse,\n            context: resolvedContext,\n            commerce: resolvedCommerce,\n          })\n        } catch (error) {\n          console.warn('❌ Item loader run failed.', item.type, item.id, error)\n        }\n      }\n\n      let children = item.children\n      if (Array.isArray(children)) {\n        let inlineChildren = children.filter(\n          isItemNode\n        ) as WeaverseNextComponentData[]\n        if (inlineChildren.length) {\n          await walk(inlineChildren)\n        }\n      }\n    }\n  }\n\n  await walk(items)\n  return data\n}\n","import type {\n  WeaverseNextRequestContext,\n  WeaverseNextRequestInfo,\n} from './types'\n\nfunction toUrl(value: string | URL): URL {\n  return typeof value === 'string' ? new URL(value, 'http://localhost') : value\n}\n\nfunction getSearchParamsFromContext(\n  context?: WeaverseNextRequestContext\n): URLSearchParams {\n  if (context?.searchParams) {\n    return new URLSearchParams(context.searchParams)\n  }\n\n  if (context?.url) {\n    let url = toUrl(context.url)\n    return new URLSearchParams(url.searchParams)\n  }\n\n  return new URLSearchParams()\n}\n\nfunction getPathnameFromContext(context?: WeaverseNextRequestContext): string {\n  if (context?.pathname) {\n    return context.pathname\n  }\n\n  if (context?.url) {\n    let url = toUrl(context.url)\n    return url.pathname || '/'\n  }\n\n  return '/'\n}\n\nfunction coerceQueryValue(value: string): string | boolean {\n  if (value === 'true') {\n    return true\n  }\n  if (value === 'false') {\n    return false\n  }\n  return value\n}\n\nfunction toQueryRecord(\n  searchParams: URLSearchParams\n): Record<string, string | boolean> {\n  let queries: Record<string, string | boolean> = {}\n  for (let [key, value] of searchParams.entries()) {\n    queries[key] = coerceQueryValue(value)\n  }\n  return queries\n}\n\n/**\n * Build the Hydrogen-like request info shape consumed by the Studio bridge.\n * Duplicate query keys keep the last value, matching `URLSearchParams` iteration\n * assignment and Hydrogen's practical query-object behavior.\n */\nexport function buildWeaverseNextRequestInfo(\n  context?: WeaverseNextRequestContext\n): WeaverseNextRequestInfo {\n  let searchParams = getSearchParamsFromContext(context)\n  let search = searchParams.toString()\n\n  return {\n    pathname: getPathnameFromContext(context),\n    search: search ? `?${search}` : '',\n    queries: toQueryRecord(searchParams),\n    ...(context?.i18n ? { i18n: context.i18n } : {}),\n  }\n}\n"]}

package/dist/index.d.mts

@@ -1,250 +0,0 @@
-import { Weaverse } from '@weaverse/react';
-export { isBrowser, isIframe, useChildInstances, useItemInstance, useParentInstance, useWeaverse } from '@weaverse/react';
-export { InspectorGroup, PageType, SchemaType, createSchema } from '@weaverse/schema';
-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.mjs';
-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.mjs';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as react from 'react';
-import { ReactNode } from 'react';
-
-/**
- * Create a {@link WeaverseNextClient} from explicit config.
- *
- * @example
- * ```ts
- * let client = createWeaverseNextClient({
- *   projectId: process.env.WEAVERSE_PROJECT_ID!,
- *   components,
- *   commerce: { storefront },
- *   fetchPage: async ({ type, handle }) => fetchWeaversePage({ type, handle }),
- * })
- * ```
- */
-declare function createWeaverseNextClient(config: WeaverseNextClientConfig): WeaverseNextClient;
-
-/**
- * Read explicit root/global data passed to the provider. Next-native
- * replacement for `useRouteLoaderData('root')`.
- */
-declare function useWeaverseRootData<T = unknown>(): T;
-/**
- * Read explicit page/route commerce data passed to the provider. Next-native
- * replacement for section-level `useLoaderData()`.
- */
-declare function useWeaversePageData<T = unknown>(): T;
-/** Read the app-provided commerce context (storefront/cart/customer). */
-declare function useWeaverseCommerce<T = WeaverseNextCommerceContext>(): T;
-/**
- * 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;
-
-interface RunComponentLoadersArgs {
-    client: WeaverseNextClient;
-    commerce?: WeaverseNextCommerceContext;
-    context?: WeaverseNextRequestContext;
-    /** Page payload to walk; defaults to `client.data`. */
-    data?: WeaverseNextLoaderData | null;
-}
-/**
- * Walk a serialized page tree and run each registered component's `loader`,
- * attaching the result to the item as `loaderData`.
- *
- * Loaders receive explicit `commerce.storefront` (and `weaverse.storefront` as
- * a compatibility alias via the client). Children are walked recursively when
- * they are inline item objects; flat `items` arrays are covered by the
- * top-level walk.
- *
- * @returns a cloned `data` object with `loaderData` attached to cloned items.
- */
-declare function runWeaverseComponentLoaders(args: RunComponentLoadersArgs): Promise<WeaverseNextLoaderData | null>;
-
-interface WeaverseNextProviderProps {
-    children: ReactNode;
-    client?: WeaverseNextClient;
-    /** App-provided commerce context (storefront/cart/customer). */
-    commerce?: WeaverseNextCommerceContext;
-    /** Explicit page/route commerce data (replaces section-level `useLoaderData`). */
-    pageData?: unknown;
-    /** Explicit root/global data (replaces `useRouteLoaderData('root')`). */
-    rootData?: unknown;
-    /** Theme settings override; falls back to `client.themeSettings`. */
-    themeSettings?: Record<string, unknown>;
-}
-/**
- * Client boundary that supplies explicit root/page/commerce data to Weaverse
- * sections. Next-native replacement for `withWeaverse` + route loader data —
- * no React Router route matches are emulated.
- *
- * In App Router, create/pass `client` only from a client component wrapper. A
- * `WeaverseNextClient` contains functions and component references, so it is
- * not serializable across a Server Component → Client Component boundary.
- *
- * @example
- * ```tsx
- * 'use client'
- *
- * <WeaverseNextProvider client={client} rootData={rootData} pageData={pageData} commerce={commerce}>
- *   <WeaverseNextRenderer />
- * </WeaverseNextProvider>
- * ```
- */
-declare function WeaverseNextProvider(props: WeaverseNextProviderProps): react_jsx_runtime.JSX.Element;
-
-interface WeaverseNextRendererProps {
-    /** Client to render from. Defaults to the provider's client. */
-    client?: WeaverseNextClient;
-    /** Page payload to render. Defaults to `client.data`. */
-    data?: WeaverseNextLoaderData | null;
-    /** Data-connector context for `{{...}}` template replacement. */
-    dataContext?: Record<string, unknown>;
-}
-/**
- * Render a serialized Weaverse page tree through `@weaverse/react` primitives.
- *
- * Reads the client/page data from {@link WeaverseNextContext} when no props are
- * passed, or accepts an explicit `client` + `data` for standalone use. Builds a
- * framework-neutral `Weaverse` core instance (no React Router hooks) and hands
- * it to the shared `WeaverseRoot`.
- */
-declare const WeaverseNextRenderer: react.MemoExoticComponent<(props: WeaverseNextRendererProps) => react_jsx_runtime.JSX.Element | null>;
-
-/**
- * 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;
-
-/**
- * Minimal structural shape of the Next App Router returned by `useRouter()`
- * (`next/navigation`) that the Studio bridge needs. Declared locally — rather
- * than importing `AppRouterInstance` from `next` — so the adapter stays a pure
- * function that unit tests can drive with a plain mock and never pulls
- * `next/navigation` into the test graph.
- */
-interface WeaverseNextRouterLike {
-    push: (href: string, options?: {
-        scroll?: boolean;
-    }) => void;
-    refresh: () => void;
-    replace: (href: string, options?: {
-        scroll?: boolean;
-    }) => void;
-}
-/** Resolved Studio navigation/revalidation callbacks for a Next runtime. */
-interface WeaverseNextStudioInternals {
-    navigate: NonNullable<WeaverseNextRuntimeInternal['navigate']>;
-    revalidate: NonNullable<WeaverseNextRuntimeInternal['revalidate']>;
-}
-interface CreateWeaverseNextStudioInternalsOptions {
-    /** Use `router.replace` instead of `router.push` for navigation. */
-    replace?: boolean;
-}
-/**
- * Build Studio `navigate` / `revalidate` callbacks from a Next App Router.
- *
- * Maps Hydrogen's React Router semantics onto Next App Router:
- * - `navigate(to, { preventScrollReset })` → `router.push(to, { scroll })`,
- *   where `scroll` is the inverse of `preventScrollReset`. Studio passes
- *   `preventScrollReset` for in-place edits so the preview viewport is kept,
- *   matching React Router's `navigate({ preventScrollReset })`.
- * - `revalidate()` → `router.refresh()`, the App Router's loader-backed refresh
- *   and the closest equivalent to React Router's `useRevalidator`.
- *
- * Pure (no React, no `next/navigation`) so it is unit-testable with a mock
- * router; the {@link WeaverseNextRouterLike} contract is the only coupling.
- */
-declare function createWeaverseNextStudioInternals(router: WeaverseNextRouterLike, options?: CreateWeaverseNextStudioInternalsOptions): WeaverseNextStudioInternals;
-
-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;
-
-/**
- * Resolve stable Studio `navigate` / `revalidate` callbacks from the Next App
- * Router. `useRouter()` is stable across renders, but the derived callbacks are
- * cached in a ref keyed on the router instance so the bridge's bind effect
- * (which depends on `navigate` / `revalidate` identity) doesn't re-run — and
- * re-`refreshStudio` — on every render.
- */
-declare function useWeaverseNextStudioInternals(options?: CreateWeaverseNextStudioInternalsOptions): WeaverseNextStudioInternals;
-interface WeaverseNextStudioProps extends CreateWeaverseNextStudioInternalsOptions {
-    runtime: WeaverseNextRuntime;
-}
-/**
- * Page-level Studio binder wired to the Next App Router. Mirrors Hydrogen's
- * `useStudio` (which binds the runtime and feeds it React Router's `navigate` /
- * `revalidate`): it resolves the App Router callbacks via
- * {@link useWeaverseNextStudioInternals} and hands them to
- * {@link WeaverseNextStudioBridge}, so consuming apps get Studio navigation and
- * revalidation without manually wiring `next/navigation`.
- *
- * Client-only — it is the single place `@weaverse/next` touches
- * `next/navigation`, keeping the runtime/renderer and `@weaverse/next/server`
- * free of router imports.
- */
-declare function WeaverseNextStudio(props: WeaverseNextStudioProps): react_jsx_runtime.JSX.Element;
-
-export { type CreateWeaverseNextStudioInternalsOptions, type CreateWeaverseNextThemeSettingsStoreOptions, type ResolveWeaverseNextStudioScriptSrcOptions, type RunComponentLoadersArgs, WeaverseNextClient, WeaverseNextClientConfig, WeaverseNextCommerceContext, WeaverseNextLoaderData, WeaverseNextProvider, type WeaverseNextProviderProps, WeaverseNextRenderer, type WeaverseNextRendererProps, WeaverseNextRequestContext, WeaverseNextRequestInfo, type WeaverseNextRouterLike, WeaverseNextRuntime, WeaverseNextRuntimeConfig, WeaverseNextRuntimeInternal, WeaverseNextStudio, WeaverseNextStudioBridge, type WeaverseNextStudioBridgeProps, WeaverseNextStudioConnect, type WeaverseNextStudioConnectProps, type WeaverseNextStudioInternals, type WeaverseNextStudioProps, WeaverseNextThemeSettingsStore, bindWeaverseNextStudioRuntime, buildWeaverseNextRequestInfo, createWeaverseNextClient, createWeaverseNextRuntime, createWeaverseNextStudioInternals, createWeaverseNextThemeSettingsStore, resolveWeaverseNextStudioScriptSrc, runWeaverseComponentLoaders, useThemeSettings, useWeaverseCommerce, useWeaverseNextStudioInternals, useWeaversePageData, useWeaverseRootData };