@weaverse/next 0.1.0-alpha.3 → 0.1.0-alpha.5

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 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 { d as WeaverseNextClientConfig, c as WeaverseNextClient, e as WeaverseNextCommerceContext, q as WeaverseNextRequestContext, n as WeaverseNextLoaderData, r as WeaverseNextRequestInfo, g as WeaverseNextComponentData, t as WeaverseNextRuntimeInternal, s as WeaverseNextRuntimeConfig, A as WeaverseNextThemeSettingsStore } from './types-DvwaU20C.mjs';
+export { W as WeaverseCollection, f as WeaverseNextComponent, h as WeaverseNextComponentLoaderArgs, i as WeaverseNextComponentProps, l as WeaverseNextI18n, m as WeaverseNextLoadPageInput, o as WeaverseNextPageData, x as WeaverseNextStorefront, B as WeaverseProduct } from './types-DvwaU20C.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
@@ -118,6 +118,31 @@ declare const WeaverseNextRenderer: react.MemoExoticComponent<(props: WeaverseNe
  */
 declare function buildWeaverseNextRequestInfo(context?: WeaverseNextRequestContext): WeaverseNextRequestInfo;
 
+declare const DEFAULT_REVALIDATE_ENDPOINT = "/api/weaverse/revalidate";
+/**
+ * Minimal runtime surface the in-place apply needs. Structural (not the
+ * concrete `WeaverseNextRuntime` class) so unit tests can drive it with a
+ * plain mock.
+ */
+interface RevalidateItemRuntimeLike {
+    itemInstances: Map<string, {
+        setData: (update: Record<string, unknown>) => unknown;
+    }>;
+}
+/**
+ * Studio per-item loader revalidation: POST the unsaved draft item to the
+ * app's revalidate route (see `createWeaverseNextRevalidateHandler`) and apply
+ * the returned `loaderData` to the live item instance in place.
+ *
+ * No `router.refresh()` is involved, so the RSC tree is never re-applied — no
+ * page remount, no scroll reset, and the draft payload never touches the URL.
+ *
+ * Throws on any failure (missing route, non-OK response, unknown item) so the
+ * Builder Studio bridge can detect the miss and fall back to its legacy
+ * refresh-based revalidation for this window.
+ */
+declare function revalidateWeaverseNextItem(runtime: RevalidateItemRuntimeLike, draftItem: WeaverseNextComponentData, endpoint?: string): Promise<void>;
+
 declare global {
     interface Window {
         __weaverse?: WeaverseNextRuntime;
@@ -146,6 +171,7 @@ declare function bindWeaverseNextStudioRuntime(runtime: WeaverseNextRuntime): bo
 interface WeaverseNextStudioBridgeProps {
     navigate?: WeaverseNextRuntimeInternal['navigate'];
     revalidate?: WeaverseNextRuntimeInternal['revalidate'];
+    revalidateItem?: WeaverseNextRuntimeInternal['revalidateItem'];
     runtime: WeaverseNextRuntime;
 }
 /** Page-level Studio runtime binder. */
@@ -200,13 +226,11 @@ interface CreateWeaverseNextStudioInternalsOptions {
 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.
+ * Resolve the Studio script URL from request/search context. `@weaverse/next`
+ * uses the dedicated Next bridge path served by Builder.
  */
 declare function resolveWeaverseNextStudioScriptSrc(context?: WeaverseNextRequestContext, options?: ResolveWeaverseNextStudioScriptSrcOptions): string | null;
 
@@ -231,6 +255,11 @@ declare function createWeaverseNextThemeSettingsStore(options?: CreateWeaverseNe
  */
 declare function useWeaverseNextStudioInternals(options?: CreateWeaverseNextStudioInternalsOptions): WeaverseNextStudioInternals;
 interface WeaverseNextStudioProps extends CreateWeaverseNextStudioInternalsOptions {
+    /**
+     * Route the app mounted with `createWeaverseNextRevalidateHandler`.
+     * Defaults to `/api/weaverse/revalidate`.
+     */
+    revalidateEndpoint?: string;
     runtime: WeaverseNextRuntime;
 }
 /**
@@ -247,4 +276,4 @@ interface WeaverseNextStudioProps extends CreateWeaverseNextStudioInternalsOptio
  */
 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 };
+export { type CreateWeaverseNextStudioInternalsOptions, type CreateWeaverseNextThemeSettingsStoreOptions, DEFAULT_REVALIDATE_ENDPOINT, type ResolveWeaverseNextStudioScriptSrcOptions, type RevalidateItemRuntimeLike, type RunComponentLoadersArgs, WeaverseNextClient, WeaverseNextClientConfig, WeaverseNextCommerceContext, WeaverseNextComponentData, 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, revalidateWeaverseNextItem, runWeaverseComponentLoaders, useThemeSettings, useWeaverseCommerce, useWeaverseNextStudioInternals, useWeaversePageData, useWeaverseRootData };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 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.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 { d as WeaverseNextClientConfig, c as WeaverseNextClient, e as WeaverseNextCommerceContext, q as WeaverseNextRequestContext, n as WeaverseNextLoaderData, r as WeaverseNextRequestInfo, g as WeaverseNextComponentData, t as WeaverseNextRuntimeInternal, s as WeaverseNextRuntimeConfig, A as WeaverseNextThemeSettingsStore } from './types-DvwaU20C.js';
+export { W as WeaverseCollection, f as WeaverseNextComponent, h as WeaverseNextComponentLoaderArgs, i as WeaverseNextComponentProps, l as WeaverseNextI18n, m as WeaverseNextLoadPageInput, o as WeaverseNextPageData, x as WeaverseNextStorefront, B as WeaverseProduct } from './types-DvwaU20C.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
@@ -118,6 +118,31 @@ declare const WeaverseNextRenderer: react.MemoExoticComponent<(props: WeaverseNe
  */
 declare function buildWeaverseNextRequestInfo(context?: WeaverseNextRequestContext): WeaverseNextRequestInfo;
 
+declare const DEFAULT_REVALIDATE_ENDPOINT = "/api/weaverse/revalidate";
+/**
+ * Minimal runtime surface the in-place apply needs. Structural (not the
+ * concrete `WeaverseNextRuntime` class) so unit tests can drive it with a
+ * plain mock.
+ */
+interface RevalidateItemRuntimeLike {
+    itemInstances: Map<string, {
+        setData: (update: Record<string, unknown>) => unknown;
+    }>;
+}
+/**
+ * Studio per-item loader revalidation: POST the unsaved draft item to the
+ * app's revalidate route (see `createWeaverseNextRevalidateHandler`) and apply
+ * the returned `loaderData` to the live item instance in place.
+ *
+ * No `router.refresh()` is involved, so the RSC tree is never re-applied — no
+ * page remount, no scroll reset, and the draft payload never touches the URL.
+ *
+ * Throws on any failure (missing route, non-OK response, unknown item) so the
+ * Builder Studio bridge can detect the miss and fall back to its legacy
+ * refresh-based revalidation for this window.
+ */
+declare function revalidateWeaverseNextItem(runtime: RevalidateItemRuntimeLike, draftItem: WeaverseNextComponentData, endpoint?: string): Promise<void>;
+
 declare global {
     interface Window {
         __weaverse?: WeaverseNextRuntime;
@@ -146,6 +171,7 @@ declare function bindWeaverseNextStudioRuntime(runtime: WeaverseNextRuntime): bo
 interface WeaverseNextStudioBridgeProps {
     navigate?: WeaverseNextRuntimeInternal['navigate'];
     revalidate?: WeaverseNextRuntimeInternal['revalidate'];
+    revalidateItem?: WeaverseNextRuntimeInternal['revalidateItem'];
     runtime: WeaverseNextRuntime;
 }
 /** Page-level Studio runtime binder. */
@@ -200,13 +226,11 @@ interface CreateWeaverseNextStudioInternalsOptions {
 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.
+ * Resolve the Studio script URL from request/search context. `@weaverse/next`
+ * uses the dedicated Next bridge path served by Builder.
  */
 declare function resolveWeaverseNextStudioScriptSrc(context?: WeaverseNextRequestContext, options?: ResolveWeaverseNextStudioScriptSrcOptions): string | null;
 
@@ -231,6 +255,11 @@ declare function createWeaverseNextThemeSettingsStore(options?: CreateWeaverseNe
  */
 declare function useWeaverseNextStudioInternals(options?: CreateWeaverseNextStudioInternalsOptions): WeaverseNextStudioInternals;
 interface WeaverseNextStudioProps extends CreateWeaverseNextStudioInternalsOptions {
+    /**
+     * Route the app mounted with `createWeaverseNextRevalidateHandler`.
+     * Defaults to `/api/weaverse/revalidate`.
+     */
+    revalidateEndpoint?: string;
     runtime: WeaverseNextRuntime;
 }
 /**
@@ -247,4 +276,4 @@ interface WeaverseNextStudioProps extends CreateWeaverseNextStudioInternalsOptio
  */
 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 };
+export { type CreateWeaverseNextStudioInternalsOptions, type CreateWeaverseNextThemeSettingsStoreOptions, DEFAULT_REVALIDATE_ENDPOINT, type ResolveWeaverseNextStudioScriptSrcOptions, type RevalidateItemRuntimeLike, type RunComponentLoadersArgs, WeaverseNextClient, WeaverseNextClientConfig, WeaverseNextCommerceContext, WeaverseNextComponentData, 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, revalidateWeaverseNextItem, runWeaverseComponentLoaders, useThemeSettings, useWeaverseCommerce, useWeaverseNextStudioInternals, useWeaversePageData, useWeaverseRootData };

package/dist/index.js

@@ -464,6 +464,7 @@ function createWeaverseNextRuntime(config) {
     if (!(existing.isDesignMode || nextIsDesignMode)) {
       existing.setProjectData(page);
     }
+    existing.__weaverseNextLatestData = page;
     existing.dataContext = resolveDataContext(config);
     existing.requestInfo = requestInfo;
     existing.projectId = resolveProjectId(config.client, config.data, page.id);
@@ -489,6 +490,7 @@ function createWeaverseNextRuntime(config) {
   }
   let runtime = new WeaverseNextRuntime(config);
   runtime.__weaverseNextRequestKey = requestKey;
+  runtime.__weaverseNextLatestData = page;
   registerRuntime(runtime);
   return runtime;
 }
@@ -507,16 +509,39 @@ function bindWeaverseNextStudioRuntime(runtime) {
     return true;
   }
   studio.refreshStudio?.({
-    data: runtime.data,
+    data: boundRuntime.__weaverseNextLatestData ?? runtime.data,
     pageId: runtime.pageId,
     requestInfo: runtime.requestInfo
   });
   return true;
 }
+
+// src/revalidate-item.ts
+var DEFAULT_REVALIDATE_ENDPOINT = "/api/weaverse/revalidate";
+async function revalidateWeaverseNextItem(runtime, draftItem, endpoint = DEFAULT_REVALIDATE_ENDPOINT) {
+  let instance = runtime.itemInstances.get(draftItem.id);
+  if (!instance) {
+    throw new Error(
+      `[weaverse-next] No live item instance for "${draftItem.id}".`
+    );
+  }
+  let response = await fetch(endpoint, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ draftItem })
+  });
+  if (!response.ok) {
+    throw new Error(
+      `[weaverse-next] Revalidate endpoint responded ${response.status}.`
+    );
+  }
+  let { loaderData } = await response.json();
+  instance.setData({ loaderData: loaderData ?? null });
+}
 var STUDIO_BIND_RETRY_INTERVAL_MS = 50;
 var STUDIO_BIND_MAX_ATTEMPTS = 100;
 function WeaverseNextStudioBridge(props) {
-  let { runtime, navigate, revalidate } = props;
+  let { runtime, navigate, revalidate, revalidateItem } = props;
   let lastRuntimeRef = react$1.useRef(runtime);
   let lastRuntimeDataRef = react$1.useRef(runtime.data);
   let lastRequestInfoRef = react$1.useRef(runtime.requestInfo);
@@ -527,6 +552,9 @@ function WeaverseNextStudioBridge(props) {
     if (revalidate) {
       runtime.internal.revalidate = revalidate;
     }
+    if (revalidateItem) {
+      runtime.internal.revalidateItem = revalidateItem;
+    }
     if (bindWeaverseNextStudioRuntime(runtime) || !runtime.isDesignMode) {
       return;
     }
@@ -538,7 +566,7 @@ function WeaverseNextStudioBridge(props) {
       }
     }, STUDIO_BIND_RETRY_INTERVAL_MS);
     return () => window.clearInterval(interval);
-  }, [runtime, navigate, revalidate]);
+  }, [runtime, navigate, revalidate, revalidateItem]);
   react$1.useEffect(() => {
     if (lastRuntimeRef.current !== runtime) {
       lastRuntimeRef.current = runtime;
@@ -591,13 +619,23 @@ function useWeaverseNextStudioInternals(options) {
   return ref.current.internals;
 }
 function WeaverseNextStudio(props) {
-  let { runtime, replace } = props;
+  let { runtime, replace, revalidateEndpoint } = props;
   let { navigate, revalidate } = useWeaverseNextStudioInternals({ replace });
+  let endpoint = revalidateEndpoint ?? DEFAULT_REVALIDATE_ENDPOINT;
+  let revalidateItemRef = react$1.useRef(null);
+  if (revalidateItemRef.current?.endpoint !== endpoint || revalidateItemRef.current.runtime !== runtime) {
+    revalidateItemRef.current = {
+      endpoint,
+      revalidateItem: (draftItem) => revalidateWeaverseNextItem(runtime, draftItem, endpoint),
+      runtime
+    };
+  }
   return /* @__PURE__ */ jsxRuntime.jsx(
     WeaverseNextStudioBridge,
     {
       navigate,
       revalidate,
+      revalidateItem: revalidateItemRef.current.revalidateItem,
       runtime
     }
   );
@@ -700,10 +738,9 @@ function resolveWeaverseNextStudioScriptSrc(context, options = {}) {
   if (!isTrustedStudioOrigin(origin, storefrontHostname)) {
     return null;
   }
-  let framework = options.framework ?? "hydrogen";
   let bundle = isDesignMode ? "index.js" : "preview.js";
   let version = last(searchParams, "weaverseVersion");
-  let url = `${origin}/static/studio/${framework}/${bundle}`;
+  let url = `${origin}/static/studio/next/${bundle}`;
   return version ? `${url}?v=${encodeURIComponent(version)}` : url;
 }
 
@@ -774,6 +811,7 @@ Object.defineProperty(exports, "createSchema", {
   enumerable: true,
   get: function () { return schema.createSchema; }
 });
+exports.DEFAULT_REVALIDATE_ENDPOINT = DEFAULT_REVALIDATE_ENDPOINT;
 exports.WeaverseNextProvider = WeaverseNextProvider;
 exports.WeaverseNextRenderer = WeaverseNextRenderer;
 exports.WeaverseNextRuntime = WeaverseNextRuntime;
@@ -787,6 +825,7 @@ exports.createWeaverseNextRuntime = createWeaverseNextRuntime;
 exports.createWeaverseNextStudioInternals = createWeaverseNextStudioInternals;
 exports.createWeaverseNextThemeSettingsStore = createWeaverseNextThemeSettingsStore;
 exports.resolveWeaverseNextStudioScriptSrc = resolveWeaverseNextStudioScriptSrc;
+exports.revalidateWeaverseNextItem = revalidateWeaverseNextItem;
 exports.runWeaverseComponentLoaders = runWeaverseComponentLoaders;
 exports.useThemeSettings = useThemeSettings;
 exports.useWeaverseCommerce = useWeaverseCommerce;