@weaverse/next 0.1.0-alpha.9 → 1.0.0

package/dist/index.mjs

@@ -1,9 +1,9 @@
-import { buildWeaverseNextRequestInfo, generateDataFromSchema } from './chunk-6PMZ77RA.mjs';
-export { buildWeaverseNextRequestInfo, formatWeaverseNextSeoMetadata, getWeaverseNextSeoMetadata, runWeaverseComponentLoaders } from './chunk-6PMZ77RA.mjs';
+import { buildWeaverseNextRequestInfo, DEFAULT_REVALIDATE_ENDPOINT, revalidateWeaverseNextItem, generateDataFromSchema } from './chunk-LH6AAEIK.mjs';
+export { DEFAULT_REVALIDATE_ENDPOINT, buildWeaverseNextRequestInfo, buildWeaverseNextRevalidateRouteContext, formatWeaverseNextSeoMetadata, generateDataFromSchema, getWeaverseNextSeoMetadata, revalidateWeaverseNextItem, runWeaverseComponentLoaders } from './chunk-LH6AAEIK.mjs';
 import { WeaverseRoot, Weaverse, WeaverseItemStore, useSafeExternalStore } from '@weaverse/react';
 export { isBrowser, isIframe, useChildInstances, useItemInstance, useParentInstance, useWeaverse } from '@weaverse/react';
 import { createSchema } from '@weaverse/schema';
-export { createSchema } from '@weaverse/schema';
+export * from '@weaverse/schema';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 import { createContext, memo, useContext, useMemo, useEffect, useLayoutEffect, useRef, useSyncExternalStore } from 'react';
 import { useRouter } from 'next/navigation';
@@ -35,6 +35,7 @@ var WeaverseNextItem = class extends WeaverseItemStore {
   _cachedSnapshot = null;
   _snapshotStoreRef = null;
   _snapshotTranslationRef = null;
+  /** Create an item store from serialized component data and its runtime. */
   constructor(initialData, weaverse) {
     super(initialData, weaverse);
     let schemaData = generateDataFromSchema(this.Element?.schema);
@@ -43,15 +44,31 @@ var WeaverseNextItem = class extends WeaverseItemStore {
   /**
    * Flatten nested `data` on updates exactly like the constructor does. Core's
    * `initProject()` calls `setData(item)` when a new runtime serves a page
-   * whose item instances already exist (e.g. locale/client navigation), and
-   * the inherited shallow merge would leave stale top-level props behind.
-   * Assigning through the inherited `data` setter swaps the `_store` ref,
-   * which invalidates the memoized snapshot below. The subscriber emit is
-   * queued instead of fired when a render-phase deferral is active (see
-   * `collectDeferredItemUpdates`).
+   * whose item instances already exist (e.g. locale/client navigation).
+   *
+   * A complete serialized item (it carries `id` and `type`; core's
+   * `initProject()` always passes one) replaces the store the way the
+   * constructor builds it: the schema defaults of the item's own `type` — the
+   * Builder can replace a section in place, keeping its id — then the item's
+   * settings. A payload omits a setting — or the whole optional `data` — when
+   * its value equals the schema default, so merging into the previous store
+   * would keep the previous locale's value visible. Partial updates still
+   * merge. Either way the `_store` ref changes, which invalidates the memoized
+   * snapshot below. The subscriber emit is queued instead of fired when a
+   * render-phase deferral is active (see `collectDeferredItemUpdates`).
    */
   setData = (update) => {
-    this.data = flattenItemData(update);
+    if ("id" in update && "type" in update) {
+      let { data, type } = update;
+      let schema = this.weaverse.elementRegistry.get(type)?.schema;
+      this._store = {
+        ...generateDataFromSchema(schema),
+        ...data === void 0 ? {} : { data },
+        ...flattenItemData(update)
+      };
+    } else {
+      this.data = flattenItemData(update);
+    }
     if (deferredItemUpdates) {
       deferredItemUpdates.add(this);
     } else {
@@ -300,18 +317,24 @@ var useThemeText = useTranslation;
 
 // src/translation-store.ts
 var TranslationStore = class {
+  /** Current flat translation overrides keyed by dot path. */
   overrides = {};
   listeners = /* @__PURE__ */ new Set();
+  /** Replace every override and notify subscribers. */
   setOverrides = (overrides) => {
     this.overrides = { ...overrides };
     this.emit();
   };
+  /** Merge changed overrides into the current values and notify subscribers. */
   updateOverrides = (newOverrides) => {
     this.overrides = { ...this.overrides, ...newOverrides };
     this.emit();
   };
+  /** Return the current client-side override snapshot. */
   getSnapshot = () => this.overrides;
+  /** Return the override snapshot used during server rendering. */
   getServerSnapshot = () => this.overrides;
+  /** Subscribe to override changes and return an unsubscribe function. */
   subscribe = (callback) => {
     this.listeners.add(callback);
     return () => {
@@ -502,6 +525,12 @@ function getConfigString(configs, key) {
   let value = configs?.[key];
   return typeof value === "string" ? value : void 0;
 }
+function resolveModeFlag(config, key) {
+  return config.client?.requestContext?.[key] === true || config.data.configs?.[key] === true;
+}
+function resolveSectionType(config) {
+  return config.client?.requestContext?.sectionType || getConfigString(config.data.configs, "sectionType") || void 0;
+}
 function getRecordString(record, key) {
   let value = record?.[key];
   return typeof value === "string" ? value : void 0;
@@ -538,12 +567,30 @@ function registerRuntime(runtime) {
   runtimeWindow.__weaverses[runtime.pageId] = runtime;
   runtimeWindow.__weaverse = runtime;
 }
+function rebindPageItemsToRuntime(runtime) {
+  let items = runtime.data?.items;
+  if (!items) {
+    return;
+  }
+  for (let { id } of items) {
+    let instance = runtime.itemInstances.get(id);
+    if (instance && instance.weaverse !== runtime) {
+      instance.weaverse = runtime;
+    }
+  }
+}
 var WeaverseNextRuntime = class extends Weaverse {
+  /** Stable ID of the page owned by this runtime. */
   pageId;
+  /** Mutable callbacks and stores consumed by the Studio bridge. */
   internal;
+  /** Path, query, and locale metadata for Studio navigation. */
   requestInfo;
+  /** Whether this runtime renders a component preview. */
   isPreviewMode;
+  /** Whether this runtime renders a saved revision. */
   isRevisionPreview;
+  /** Component type rendered in section preview mode. */
   sectionType;
   // ─── Item-level translation sidecar (design mode only) ─────────────
   /**
@@ -552,7 +599,9 @@ var WeaverseNextRuntime = class extends Weaverse {
    * components, so translations render without mutating the base `_store`.
    */
   translationMap = {};
+  /** Locale associated with the item-level translation sidecar. */
   translationLocale = String();
+  /** Weaverse language ID used when saving translation changes. */
   translationLanguageId = String();
   /**
    * Fresh page data captured while React was rendering. Runtime reuse happens
@@ -570,27 +619,32 @@ var WeaverseNextRuntime = class extends Weaverse {
    * deferred to `flushRenderPhaseUpdates()`.
    */
   pendingItemUpdates = [];
+  /** Create a browser runtime from a loaded page and its request context. */
   constructor(config) {
     let { client, data } = config;
     let page = getRenderablePage(data);
     let configs = data.configs;
     let requestContext = client?.requestContext;
+    let isDesignMode = resolveModeFlag(config, "isDesignMode");
+    let isPreviewMode = resolveModeFlag(config, "isPreviewMode");
+    let isRevisionPreview = resolveModeFlag(config, "isRevisionPreview");
+    let sectionType = resolveSectionType(config);
     let projectId = resolveProjectId(client, data, page.id);
     ensureNextItemConstructor();
     super({
       projectId,
       data: page,
-      isDesignMode: requestContext?.isDesignMode ?? false,
+      isDesignMode,
       weaverseHost: getConfigString(configs, "weaverseHost"),
       weaverseVersion: getConfigString(configs, "weaverseVersion")
     });
     this.pageId = page.id;
     this.dataContext = resolveDataContext(config);
     this.requestInfo = buildWeaverseNextRequestInfo(requestContext);
-    this.isDesignMode = requestContext?.isDesignMode ?? false;
-    this.isPreviewMode = requestContext?.isPreviewMode ?? false;
-    this.isRevisionPreview = requestContext?.isRevisionPreview ?? false;
-    this.sectionType = requestContext?.sectionType;
+    this.isDesignMode = isDesignMode;
+    this.isPreviewMode = isPreviewMode;
+    this.isRevisionPreview = isRevisionPreview;
+    this.sectionType = sectionType;
     let translationStore = config.translationStore ?? new TranslationStore();
     this.internal = {
       merchantOverrides: config.merchantOverrides,
@@ -722,7 +776,11 @@ function createWeaverseNextRuntime(config) {
   let existing = runtimeWindow?.__weaverses?.[page.id];
   let requestKey = getRuntimeKey(page.id, requestInfo);
   if (existing?.__weaverseNextRequestKey === requestKey) {
-    let nextIsDesignMode = config.client?.requestContext?.isDesignMode ?? false;
+    let configs = config.data.configs;
+    let nextIsDesignMode = resolveModeFlag(config, "isDesignMode");
+    let nextIsPreviewMode = resolveModeFlag(config, "isPreviewMode");
+    let nextIsRevisionPreview = resolveModeFlag(config, "isRevisionPreview");
+    let nextSectionType = resolveSectionType(config);
     if (existing.isDesignMode || nextIsDesignMode) {
       existing.pendingProjectData = void 0;
     } else {
@@ -733,11 +791,11 @@ function createWeaverseNextRuntime(config) {
     existing.requestInfo = requestInfo;
     existing.projectId = resolveProjectId(config.client, config.data, page.id);
     existing.isDesignMode = nextIsDesignMode;
-    existing.isPreviewMode = config.client?.requestContext?.isPreviewMode ?? false;
-    existing.isRevisionPreview = config.client?.requestContext?.isRevisionPreview ?? false;
-    existing.sectionType = config.client?.requestContext?.sectionType;
-    existing.weaverseHost = getConfigString(config.data.configs, "weaverseHost") ?? existing.weaverseHost;
-    existing.weaverseVersion = getConfigString(config.data.configs, "weaverseVersion") ?? existing.weaverseVersion;
+    existing.isPreviewMode = nextIsPreviewMode;
+    existing.isRevisionPreview = nextIsRevisionPreview;
+    existing.sectionType = nextSectionType;
+    existing.weaverseHost = getConfigString(configs, "weaverseHost") ?? existing.weaverseHost;
+    existing.weaverseVersion = getConfigString(configs, "weaverseVersion") ?? existing.weaverseVersion;
     existing.internal.pageAssignment = config.data.pageAssignment;
     existing.internal.project = config.data.project;
     if (config.navigate) {
@@ -761,6 +819,7 @@ function createWeaverseNextRuntime(config) {
     () => new WeaverseNextRuntime(config)
   );
   runtime.pendingItemUpdates = refreshedItems;
+  rebindPageItemsToRuntime(runtime);
   runtime.__weaverseNextRequestKey = requestKey;
   runtime.__weaverseNextLatestData = page;
   registerRuntime(runtime);
@@ -775,7 +834,10 @@ function bindWeaverseNextStudioRuntime(runtime) {
     return false;
   }
   let boundRuntime = runtime;
-  if (!boundRuntime.__weaverseNextStudioBound) {
+  let activeRuntime = studio.weaverse;
+  let activeRequestInfo = activeRuntime?.requestInfo;
+  let isActiveUrl = !activeRequestInfo || activeRequestInfo.pathname === runtime.requestInfo.pathname && activeRequestInfo.search === runtime.requestInfo.search;
+  if (!(boundRuntime.__weaverseNextStudioBound && isActiveUrl)) {
     studio.init?.(runtime);
     boundRuntime.__weaverseNextStudioBound = true;
     return true;
@@ -787,29 +849,6 @@ function bindWeaverseNextStudioRuntime(runtime) {
   });
   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) {
@@ -1024,7 +1063,7 @@ function resolveWeaverseNextStudioScriptSrc(context, options = {}) {
   if (!isTrustedStudioOrigin(origin, storefrontHostname)) {
     return null;
   }
-  let bundle = isDesignMode ? "index.js" : "preview.js";
+  let bundle = isPreviewMode || isRevisionPreview ? "preview.js" : "index.js";
   let version = last(searchParams, "weaverseVersion");
   let url = `${origin}/static/studio/next/${bundle}`;
   return version ? `${url}?v=${encodeURIComponent(version)}` : url;
@@ -1074,6 +1113,6 @@ function WeaverseNextStudioConnect(props) {
   return null;
 }
 
-export { DEFAULT_REVALIDATE_ENDPOINT, ThemeTextProvider, ThemeTextStore, TranslationProvider, TranslationStore, WeaverseNextProvider, WeaverseNextRenderer, WeaverseNextRootProvider, WeaverseNextRuntime, WeaverseNextStudio, WeaverseNextStudioBridge, WeaverseNextStudioConnect, bindWeaverseNextStudioRuntime, createTranslate, createWeaverseNextClient, createWeaverseNextRuntime, createWeaverseNextStudioInternals, createWeaverseNextThemeSettingsStore, getNestedKey, interpolate, loadWeaverseNextStudioScript, resolveWeaverseNextStudioScriptSrc, revalidateWeaverseNextItem, useThemeSettings, useThemeText, useTranslation, useWeaverseCommerce, useWeaverseNextStudioInternals, useWeaversePageData, useWeaverseRootData };
+export { ThemeTextProvider, ThemeTextStore, TranslationProvider, TranslationStore, WeaverseNextProvider, WeaverseNextRenderer, WeaverseNextRootProvider, WeaverseNextRuntime, WeaverseNextStudio, WeaverseNextStudioBridge, WeaverseNextStudioConnect, bindWeaverseNextStudioRuntime, createTranslate, createWeaverseNextClient, createWeaverseNextRuntime, createWeaverseNextStudioInternals, createWeaverseNextThemeSettingsStore, getNestedKey, interpolate, loadWeaverseNextStudioScript, resolveWeaverseNextStudioScriptSrc, useThemeSettings, useThemeText, useTranslation, useWeaverseCommerce, useWeaverseNextStudioInternals, useWeaversePageData, useWeaverseRootData };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map