@amplifyup/sdk 0.1.67 → 0.1.69

package/dist/react.js

@@ -1,13 +1,13 @@
 'use client';
 'use strict';
 
-var React2 = require('react');
+var React3 = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 var marked = require('marked');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-var React2__default = /*#__PURE__*/_interopDefault(React2);
+var React3__default = /*#__PURE__*/_interopDefault(React3);
 
 /* @amplifyup/sdk - https://amplifyup.ai */
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
@@ -440,6 +440,13 @@ function isFieldEnvelope(value) {
   const rec = value;
   return typeof rec.name === "string" && "value" in rec && !("url" in rec);
 }
+var OBJECT_FIELD_KINDS = /* @__PURE__ */ new Set(["object", "array", "list"]);
+function isLeafFieldKind(kind) {
+  if (typeof kind !== "string") return false;
+  const normalized = kind.trim().toLowerCase();
+  if (!normalized) return false;
+  return !OBJECT_FIELD_KINDS.has(normalized);
+}
 function isPageResourceSentinel(value) {
   return !!value && typeof value === "object" && !Array.isArray(value) && typeof value.__amplifyupPageResource === "string";
 }
@@ -579,6 +586,10 @@ function toFieldEnvelopes(source, prefix = "", scope) {
       out[key] = { value: envelopeListRows(raw, owner), name: path };
       continue;
     }
+    if (ctx.leaf?.(path)) {
+      out[key] = withLeaf({ value: emptyValue(raw), name: path }, ctx);
+      continue;
+    }
     if (raw && typeof raw === "object" && !Array.isArray(raw) && !isPortableImageShape(raw) && !raw.$$typeof) {
       out[key] = toFieldEnvelopes(raw, path, ctx);
       continue;
@@ -607,15 +618,33 @@ function envelopeListRow(item, owner) {
   }
   return row;
 }
+var warnedMissingFieldKind = /* @__PURE__ */ new Set();
+function warnMissingFieldKind(fieldName) {
+  if (process.env.NODE_ENV === "production") return;
+  if (warnedMissingFieldKind.has(fieldName)) return;
+  warnedMissingFieldKind.add(fieldName);
+  console.warn(
+    `[AmplifyUp SDK] Field "${fieldName}" has no schema kind; using value-shape detection. Republish the component definition so its fields carry a type.`
+  );
+}
 function attachFieldEnvelopes(props, sources) {
   const raw = props && typeof props === "object" ? { ...props } : {};
   if (isBrandedFields(raw.fields)) return raw;
   const { fields: existing, ...content } = raw;
   const source = existing && typeof existing === "object" && !isFieldEnvelope(existing) ? existing : content;
+  const { reads } = normalizeEnvelopeSources(sources);
+  if (reads) {
+    for (const [fieldName, read] of Object.entries(reads)) {
+      if (!read?.kind) warnMissingFieldKind(fieldName);
+    }
+  }
   return {
     ...raw,
     fields: toFieldEnvelopes(source, "", {
-      owners: (fieldName) => listOwnerForField(fieldName, source, sources)
+      owners: (fieldName) => listOwnerForField(fieldName, source, sources),
+      // Top-level field paths equal field names; nested paths have no schema
+      // entry and fall back to shape-based handling.
+      leaf: (path) => isLeafFieldKind(reads?.[path]?.kind)
     })
   };
 }
@@ -890,6 +919,8 @@ function hydrateFieldsBag(bag, fields) {
     if (val && typeof val === "object" && !Array.isArray(val) && typeof val.name === "string" && "value" in val && !("url" in val)) {
       const env = val;
       out[key] = {
+        // Keep ref / readOnly / source — dropping them severs the write target.
+        ...val,
         name: env.name,
         value: isPageResourceSentinel2(env.value) ? hydratePageResourceValue(env.value, fields) : env.value
       };
@@ -971,6 +1002,51 @@ function sdkDebugOnce(key, ...args) {
   console.log(...args);
 }
 
+// src/content/layoutProviderCache.ts
+var SETTLED_TTL_MS = 5e3;
+var inflight = /* @__PURE__ */ new Map();
+var settled = /* @__PURE__ */ new Map();
+function layoutProviderCacheKey(opts) {
+  const route = (opts.route || "/").split("?")[0] || "/";
+  return [
+    route,
+    opts.trackingId || "",
+    opts.instanceId || "",
+    opts.preview ? "1" : "0",
+    opts.working ? "1" : "0",
+    opts.zoneId || "",
+    opts.compositionId || ""
+  ].join("|");
+}
+function getSettledLayoutProvider(key) {
+  const entry = settled.get(key);
+  if (!entry) return void 0;
+  if (Date.now() - entry.at > SETTLED_TTL_MS) {
+    settled.delete(key);
+    return void 0;
+  }
+  return entry.value;
+}
+function dedupeLayoutProviderFetch(key, fetchFn) {
+  const cached = getSettledLayoutProvider(key);
+  if (cached !== void 0) return Promise.resolve(cached);
+  const existing = inflight.get(key);
+  if (existing) return existing;
+  const pending = fetchFn().then((value) => {
+    settled.set(key, { value, at: Date.now() });
+    return value;
+  }).finally(() => {
+    inflight.delete(key);
+  });
+  inflight.set(key, pending);
+  return pending;
+}
+function previewLayoutReady(opts) {
+  if (opts.hasClientLayout) return true;
+  if (opts.clientLoading) return false;
+  return true;
+}
+
 // src/edge/normalizeRoute.ts
 function normalizeRoute(route) {
   let path = String(route || "").trim();
@@ -2384,6 +2460,32 @@ Available Console Commands:
    */
   async fetchPageConfig(route, preview = false) {
     const url = this.buildLayoutProviderUrl(route, preview);
+    const pageSearch = typeof window !== "undefined" ? new URLSearchParams(window.location.search) : null;
+    const cacheKey = layoutProviderCacheKey({
+      route,
+      trackingId: this.getTrackingId(),
+      instanceId: getInstanceId(),
+      preview,
+      working: pageSearch ? isWorkingContentRequest(pageSearch) : false,
+      zoneId: pageSearch?.get("zoneId"),
+      compositionId: pageSearch?.get("compositionId")
+    });
+    return dedupeLayoutProviderFetch(cacheKey, async () => {
+      const startedAt = Date.now();
+      sdkDebug("[AmplifyUp SDK] layout/provider request", {
+        route,
+        at: new Date(startedAt).toISOString()
+      });
+      const page = await this.fetchPageConfigUncached(url);
+      sdkDebug("[AmplifyUp SDK] layout/provider response", {
+        route,
+        durationMs: Date.now() - startedAt,
+        hasPage: !!page
+      });
+      return page;
+    });
+  }
+  async fetchPageConfigUncached(url) {
     const response = await fetch(url);
     if (!response.ok) {
       if (response.status === 404) {
@@ -2742,6 +2844,12 @@ Available Console Commands:
           );
           return;
         }
+        if (event.data?.type === "AMPLIFYUP_LAYOUT_PATCH") {
+          window.dispatchEvent(
+            new CustomEvent("amplifyup:layout-patch", { detail: event.data })
+          );
+          return;
+        }
         if (event.data?.type === "COMPONENT_DELETABLE_STATUS") {
           const { componentId, deletable, nodeId } = event.data;
           const element = document.querySelector(`[data-component-id="${componentId}"]`);
@@ -3782,6 +3890,13 @@ function getSDK(adapter) {
 var trackContentView = (contentId, contentType, properties) => getSDK().trackContentView(contentId, contentType, properties);
 var refreshEventTracking = () => getSDK().refreshEventTracking();
 getSDK();
+function useComposerPreviewFlag(force = false) {
+  const [detected, setDetected] = React3.useState(false);
+  React3.useEffect(() => {
+    if (!force && isComposerPreview()) setDetected(true);
+  }, [force]);
+  return force || detected;
+}
 
 // src/composer-store.ts
 var ComposerFieldStore = class {
@@ -3824,19 +3939,19 @@ var ComposerFieldStore = class {
     for (const fn of set) fn();
   }
 };
-var ComposerStoreContext = React2.createContext(null);
-var ComposerNodeContext = React2.createContext(void 0);
+var ComposerStoreContext = React3.createContext(null);
+var ComposerNodeContext = React3.createContext(void 0);
 function applyComposerPatch(store, name, value, ref, layoutNodeId) {
   store.set(composerStoreKey(name, ref, layoutNodeId), value);
 }
 function ComposerProvider({
   children
 }) {
-  const existing = React2.useContext(ComposerStoreContext);
-  const storeRef = React2.useRef(null);
+  const existing = React3.useContext(ComposerStoreContext);
+  const storeRef = React3.useRef(null);
   if (!storeRef.current) storeRef.current = new ComposerFieldStore();
   const store = existing || storeRef.current;
-  React2.useEffect(() => {
+  React3.useEffect(() => {
     if (existing) return;
     const applyField = (fieldName, value, nodeId, ref) => {
       if (!fieldName || typeof fieldName !== "string") return;
@@ -3900,10 +4015,10 @@ function ComposerProvider({
   return /* @__PURE__ */ jsxRuntime.jsx(ComposerStoreContext.Provider, { value: store, children });
 }
 function useComposerFieldValue(name, fallback, ref) {
-  const store = React2.useContext(ComposerStoreContext);
-  const layoutNodeId = React2.useContext(ComposerNodeContext);
+  const store = React3.useContext(ComposerStoreContext);
+  const layoutNodeId = React3.useContext(ComposerNodeContext);
   const key = composerStoreKey(name, ref, layoutNodeId);
-  const subscribe = React2.useCallback(
+  const subscribe = React3.useCallback(
     (onStoreChange) => {
       if (!store || !name) return () => {
       };
@@ -3911,11 +4026,11 @@ function useComposerFieldValue(name, fallback, ref) {
     },
     [store, name, key]
   );
-  const getSnapshot = React2.useCallback(() => {
+  const getSnapshot = React3.useCallback(() => {
     if (!store || !name) return void 0;
     return store.get(key);
   }, [store, name, key]);
-  const overlay = React2.useSyncExternalStore(subscribe, getSnapshot, () => void 0);
+  const overlay = React3.useSyncExternalStore(subscribe, getSnapshot, () => void 0);
   return overlay !== void 0 ? overlay : fallback;
 }
 function MaybeComposerProvider({
@@ -3923,7 +4038,7 @@ function MaybeComposerProvider({
   layoutNodeId,
   children
 }) {
-  const content = React2.useMemo(() => children, [children]);
+  const content = React3.useMemo(() => children, [children]);
   if (!enabled) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: content });
   return /* @__PURE__ */ jsxRuntime.jsx(ComposerProvider, { children: /* @__PURE__ */ jsxRuntime.jsx(ComposerNodeContext.Provider, { value: layoutNodeId, children }) });
 }
@@ -3943,7 +4058,7 @@ function nodeRenderProps(node) {
     fields: branded
   };
 }
-var ComponentRenderBoundary = class extends React2.Component {
+var ComponentRenderBoundary = class extends React3.Component {
   constructor() {
     super(...arguments);
     this.state = { error: null };
@@ -3998,16 +4113,9 @@ function NodeWithFields({
   renderComponent,
   composerPreview
 }) {
-  return /* @__PURE__ */ jsxRuntime.jsx(
-    MaybeComposerProvider,
-    {
-      enabled: !!(composerPreview || isComposerPreview()),
-      layoutNodeId: nodeId,
-      children: renderComponent(componentId, props, slots, {
-        layoutNodeId: nodeId
-      })
-    }
-  );
+  return /* @__PURE__ */ jsxRuntime.jsx(MaybeComposerProvider, { enabled: !!composerPreview, layoutNodeId: nodeId, children: renderComponent(componentId, props, slots, {
+    layoutNodeId: nodeId
+  }) });
 }
 function AmplifyRendererInner({
   renderComponent,
@@ -4018,12 +4126,13 @@ function AmplifyRendererInner({
   composerPreview
 }) {
   const clientHook = useAmplifyUp();
+  const composerPreviewFlag = useComposerPreviewFlag(!!composerPreview);
   const pageConfig = serverPageConfig || clientHook.pageConfig || null;
   const loading = serverPageConfig ? false : clientHook.loading;
   const error = serverPageConfig ? null : clientHook.error;
   const contentSource = clientHook.source;
-  const [variantCache, setVariantCache] = React2.useState({});
-  React2.useEffect(() => {
+  const [variantCache, setVariantCache] = React3.useState({});
+  React3.useEffect(() => {
     if (typeof window !== "undefined") {
       if (window.__AMPLIFYUP_PREVIEW_MODE__ === true) {
         return;
@@ -4049,7 +4158,7 @@ function AmplifyRendererInner({
       });
     }
   }, [pageConfig]);
-  React2.useEffect(() => {
+  React3.useEffect(() => {
     if (!pageConfig?.eventTracking?.length) return;
     const sdk = getSDK();
     if (!sdk.isInitialized()) return;
@@ -4067,7 +4176,7 @@ function AmplifyRendererInner({
       window.clearTimeout(t2);
     };
   }, [pageConfig?.id, pageConfig?.eventTracking]);
-  React2.useEffect(() => {
+  React3.useEffect(() => {
     if (!pageConfig) return;
     const t = window.setTimeout(() => {
       getSDK().setupComponentViewTracking();
@@ -4075,7 +4184,7 @@ function AmplifyRendererInner({
     }, 100);
     return () => window.clearTimeout(t);
   }, [variantCache, pageConfig?.id]);
-  React2.useEffect(() => {
+  React3.useEffect(() => {
     const isVisualEditorMode = () => {
       if (typeof window === "undefined") return false;
       const urlParams = new URLSearchParams(window.location.search);
@@ -4169,7 +4278,7 @@ function AmplifyRendererInner({
       );
     }
   }, [pageConfig]);
-  React2.useEffect(() => {
+  React3.useEffect(() => {
     if (!pageConfig?.layoutTree || !pageConfig.layoutId) return;
     const roots = pageConfig.layoutTree;
     const fromEdge = contentSource === "edge" || roots.some((n) => n._contentSource === "edge");
@@ -4310,7 +4419,7 @@ function AmplifyRendererInner({
               "data-amplifyup-slot": "content",
               "data-parent-node-id": node.id,
               "data-parent-component-id": "AmplifyZone",
-              children: children.filter(Boolean).map((child) => /* @__PURE__ */ jsxRuntime.jsx(React2.Fragment, { children: renderNode(child) }, child.id))
+              children: children.filter(Boolean).map((child) => /* @__PURE__ */ jsxRuntime.jsx(React3.Fragment, { children: renderNode(child) }, child.id))
             }
           )
         }
@@ -4343,7 +4452,7 @@ function AmplifyRendererInner({
             "data-zone-id": slot.zoneId || void 0,
             "data-parent-node-id": node.id,
             "data-parent-component-id": node.componentId,
-            children: safeChildren.filter(Boolean).map((child) => /* @__PURE__ */ jsxRuntime.jsx(React2.Fragment, { children: renderNode(child) }, child.id))
+            children: safeChildren.filter(Boolean).map((child) => /* @__PURE__ */ jsxRuntime.jsx(React3.Fragment, { children: renderNode(child) }, child.id))
           },
           slot.slotId
         );
@@ -4370,7 +4479,7 @@ function AmplifyRendererInner({
                 props: nodeRenderProps(node),
                 slots: slotsToPass,
                 renderComponent,
-                composerPreview
+                composerPreview: composerPreviewFlag
               }
             )
           }
@@ -4383,18 +4492,19 @@ function AmplifyRendererInner({
   if (layoutTree.length === 0) {
     return /* @__PURE__ */ jsxRuntime.jsx("main", { children: emptyComponent || /* @__PURE__ */ jsxRuntime.jsx("div", { className: "container mx-auto px-4 py-16", children: /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-muted-foreground", children: "No content configured for this page." }) }) });
   }
-  return /* @__PURE__ */ jsxRuntime.jsx(ComposerProvider, { children: /* @__PURE__ */ jsxRuntime.jsx("main", { children: composerPreview || isComposerPreview() ? /* @__PURE__ */ jsxRuntime.jsx(
+  return /* @__PURE__ */ jsxRuntime.jsx(ComposerProvider, { children: /* @__PURE__ */ jsxRuntime.jsx("main", { children: composerPreviewFlag ? /* @__PURE__ */ jsxRuntime.jsx(
     "div",
     {
       "data-slot-id": "main",
       "data-amplifyup-slot": "main",
       "data-slot-source": "page",
+      "data-slot-state": layoutTree.length === 0 ? "empty" : "filled",
       "data-slot-empty": layoutTree.length === 0 ? "true" : void 0,
-      children: layoutTree.map((node) => /* @__PURE__ */ jsxRuntime.jsx(React2.Fragment, { children: renderNode(node) }, node.id))
+      children: layoutTree.map((node) => /* @__PURE__ */ jsxRuntime.jsx(React3.Fragment, { children: renderNode(node) }, node.id))
     }
-  ) : layoutTree.map((node) => /* @__PURE__ */ jsxRuntime.jsx(React2.Fragment, { children: renderNode(node) }, node.id)) }) });
+  ) : layoutTree.map((node) => /* @__PURE__ */ jsxRuntime.jsx(React3.Fragment, { children: renderNode(node) }, node.id)) }) });
 }
-var AmplifyRenderer = React2.memo(AmplifyRendererInner);
+var AmplifyRenderer = React3.memo(AmplifyRendererInner);
 function AddComponentIcon({ size = 28 }) {
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "svg",
@@ -4489,16 +4599,34 @@ function EmptySlotHint({
     }
   );
 }
-function defaultPreviewCanvas() {
+var ComposerLayoutStatusContext = React3.createContext({
+  ready: true
+});
+function ComposerLayoutStatusProvider({
+  ready,
+  children
+}) {
+  return /* @__PURE__ */ jsxRuntime.jsx(ComposerLayoutStatusContext.Provider, { value: { ready }, children });
+}
+function useComposerLayoutStatus() {
+  return React3.useContext(ComposerLayoutStatusContext);
+}
+function previewPageSlot(state) {
   return /* @__PURE__ */ jsxRuntime.jsx(
     "div",
     {
       "data-slot-id": "main",
       "data-amplifyup-slot": "main",
       "data-slot-source": "page",
-      "data-slot-empty": "true",
-      style: { minHeight: "50vh", width: "100%", display: "block", position: "relative" },
-      children: /* @__PURE__ */ jsxRuntime.jsx(EmptySlotHint, {})
+      "data-slot-state": state,
+      "data-slot-empty": state === "empty" ? "true" : void 0,
+      style: {
+        minHeight: state === "empty" ? "50vh" : void 0,
+        width: "100%",
+        display: "block",
+        position: "relative"
+      },
+      children: state === "empty" ? /* @__PURE__ */ jsxRuntime.jsx(EmptySlotHint, {}) : null
     }
   );
 }
@@ -4532,7 +4660,7 @@ function AmplifyPageContent({
   errorComponent
 }) {
   const client = useAmplifyUp();
-  const preview = forceComposerPreview || isComposerPreview();
+  const preview = useComposerPreviewFlag(forceComposerPreview);
   const clientLayout = hasAmplifyLayout(client.pageConfig) ? client.pageConfig : null;
   const serverLayout = hasAmplifyLayout(pageConfigProp) ? pageConfigProp : null;
   let pageConfig = serverLayout ?? clientLayout;
@@ -4545,20 +4673,26 @@ function AmplifyPageContent({
   }
   const loading = !hasAmplifyLayout(pageConfig) && client.loading;
   const error = hasAmplifyLayout(pageConfig) ? null : pageConfigProp ? null : client.error;
-  const previewCanvas = previewEmptyComponent ?? defaultPreviewCanvas();
-  const previewLoading = previewLoadingComponent ?? previewCanvas;
+  const previewEmpty = previewEmptyComponent ?? previewPageSlot("empty");
+  const previewLoading = previewLoadingComponent ?? previewPageSlot("loading");
   if (preview) {
-    return /* @__PURE__ */ jsxRuntime.jsx(
+    const ready = previewLayoutReady({
+      clientLoading: client.loading,
+      hasClientLayout: !!clientLayout});
+    if (!ready) {
+      return /* @__PURE__ */ jsxRuntime.jsx(ComposerLayoutStatusProvider, { ready: false, children: previewLoading });
+    }
+    return /* @__PURE__ */ jsxRuntime.jsx(ComposerLayoutStatusProvider, { ready: true, children: /* @__PURE__ */ jsxRuntime.jsx(
       AmplifyRenderer,
       {
         pageConfig: pageConfig ?? void 0,
         renderComponent,
         composerPreview: true,
         loadingComponent: loadingComponent ?? previewLoading,
-        emptyComponent: emptyComponent ?? previewCanvas,
-        errorComponent: errorComponent ?? (() => previewCanvas)
+        emptyComponent: emptyComponent ?? previewEmpty,
+        errorComponent: errorComponent ?? (() => previewEmpty)
       }
-    );
+    ) });
   }
   if (loading) {
     return loadingComponent ? /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: loadingComponent }) : null;
@@ -4582,6 +4716,24 @@ function AmplifyPageContent({
   );
 }
 
+// src/slot-state.ts
+function resolveSlotState(opts) {
+  if (!opts.layoutReady) return "loading";
+  return opts.hasContent ? "filled" : "empty";
+}
+function slotShowsAddComponent(state) {
+  return state === "empty";
+}
+function slotStateFromEl(el) {
+  if (!el) return null;
+  const explicit = el.getAttribute("data-slot-state");
+  if (explicit === "loading" || explicit === "empty" || explicit === "filled") {
+    return explicit;
+  }
+  if (el.getAttribute("data-slot-empty") === "true") return "empty";
+  return null;
+}
+
 // src/composer-edit-mode.ts
 function isComposerEditMode() {
   if (typeof window === "undefined") return false;
@@ -4596,7 +4748,7 @@ function subscribeComposerEdit(onStoreChange) {
 function getComposerEditModeServer() {
   return false;
 }
-var ComponentContext = React2.createContext(null);
+var ComponentContext = React3.createContext(null);
 function ComponentContextProvider({
   children,
   slots,
@@ -4617,13 +4769,18 @@ function Slot({
   name,
   className
 }) {
-  const context = React2.useContext(ComponentContext);
+  const context = React3.useContext(ComponentContext);
   if (!context) {
     console.warn(`[AmplifyUp SDK] Slot "${name}" used outside ComponentContextProvider`);
     return null;
   }
   const slotContent = context.slots?.[name];
-  const isEmpty = !slotContent;
+  const { ready: layoutReady } = useComposerLayoutStatus();
+  const slotState = resolveSlotState({
+    layoutReady,
+    hasContent: !!slotContent
+  });
+  const isEmpty = slotState === "empty";
   const isEditorMode = typeof window !== "undefined" && // Check for preview mode flag set by proxy
   (window.__AMPLIFYUP_PREVIEW_MODE__ === true || // Check URL query params
   new URLSearchParams(window.location.search).get("preview") === "true" || new URLSearchParams(window.location.search).get("visualEditor") === "true" || // Check if in iframe from orchestrator (check referrer hostname/port)
@@ -4639,6 +4796,7 @@ function Slot({
     `slot:${context.layoutNodeId || ""}:${name}`,
     `[Slot:${name}]`,
     {
+      slotState,
       isEmpty,
       isEditorMode,
       availableSlotKeys: context.slots ? Object.keys(context.slots) : []
@@ -4651,6 +4809,7 @@ function Slot({
       "data-slot-name": name,
       "data-slot-id": name,
       "data-amplifyup-slot": name,
+      "data-slot-state": slotState,
       "data-slot-empty": isEmpty ? "true" : void 0,
       "data-parent-node-id": context.layoutNodeId || void 0,
       "data-parent-component-id": context.componentId || void 0,
@@ -4660,7 +4819,7 @@ function Slot({
         // Only add position relative for overlay positioning in editor mode
         position: isEditorMode ? "relative" : void 0
       },
-      children: isEmpty ? isEditorMode ? /* @__PURE__ */ jsxRuntime.jsx(EmptySlotHint, { compact: true }) : /* @__PURE__ */ jsxRuntime.jsx(
+      children: slotState === "loading" ? null : isEmpty ? isEditorMode ? /* @__PURE__ */ jsxRuntime.jsx(EmptySlotHint, { compact: true }) : /* @__PURE__ */ jsxRuntime.jsx(
         "div",
         {
           className: "amplifyup-slot-placeholder",
@@ -4732,7 +4891,7 @@ function canInlineEditRichText(name, value) {
   return true;
 }
 function useComposerEditMode() {
-  return React2.useSyncExternalStore(
+  return React3.useSyncExternalStore(
     subscribeComposerEdit,
     isComposerEditMode,
     getComposerEditModeServer
@@ -4810,14 +4969,14 @@ function ComposerInlineField({
   fieldRef,
   rich = false
 }) {
-  const [focused, setFocused] = React2.useState(false);
-  const elRef = React2.useRef(null);
+  const [focused, setFocused] = React3.useState(false);
+  const elRef = React3.useRef(null);
   const storedEmpty = isComposerEmptyText(value);
   const text = storedEmpty ? "" : formatFieldValue(value);
   const hint = COMPOSER_EMPTY_FIELD_HINT;
   const idleDisplay = storedEmpty ? hint : text;
   const showHint = storedEmpty && !focused;
-  React2.useEffect(() => {
+  React3.useEffect(() => {
     const el = elRef.current;
     if (!el) return;
     if (document.activeElement === el) return;
@@ -4935,8 +5094,8 @@ function ComposerInlineHtml({
   componentId,
   fieldRef
 }) {
-  const elRef = React2.useRef(null);
-  React2.useEffect(() => {
+  const elRef = React3.useRef(null);
+  React3.useEffect(() => {
     const el = elRef.current;
     if (!el) return;
     if (el.innerHTML !== html) el.innerHTML = html;
@@ -4954,7 +5113,7 @@ function ComposerInlineHtml({
       fieldRef
     });
   };
-  return React2__default.default.createElement(Tag, {
+  return React3__default.default.createElement(Tag, {
     ref: elRef,
     className,
     "data-amplifyup-field": name,
@@ -5011,6 +5170,18 @@ function warnNotScalarField(component, field, fieldValue) {
   }
   return false;
 }
+function assertNamedEnvelope(component, field) {
+  if (process.env.NODE_ENV === "production") return;
+  if (!field || typeof field !== "object" || Array.isArray(field)) return;
+  const rec = field;
+  if (!("value" in rec)) return;
+  if (typeof rec.name === "string" && rec.name) return;
+  throw new Error(
+    `[AmplifyUp SDK] ${component} received an envelope-shaped object with a \`value\` but no \`name\` \u2014 a partial envelope was manufactured upstream (keys: ${Object.keys(
+      rec
+    ).join(", ")}). Find the producer; do not strip or rebuild envelopes.`
+  );
+}
 var warnedReadOnlyFields = /* @__PURE__ */ new Set();
 function warnReadOnlyRowField(name) {
   if (process.env.NODE_ENV === "production") return;
@@ -5041,11 +5212,12 @@ function hasOwnProp(props, key) {
 }
 function Field(props) {
   const { field, value, name, className } = props;
-  const context = React2.useContext(ComponentContext);
+  const context = React3.useContext(ComponentContext);
   const composerEdit = useComposerEditMode();
   const hasField = isFieldEnvelope(field);
   const hasValue = hasOwnProp(props, "value");
   const { editName, fieldValue, ref } = useBoundField(field, value, name, "Field");
+  assertNamedEnvelope("Field", field);
   warnProjectionProps("Field", hasField, hasValue, name);
   if (warnNotScalarField("Field", field, fieldValue)) {
     return null;
@@ -5094,7 +5266,7 @@ function RichText(props) {
     as: Tag = "div",
     children
   } = props;
-  const context = React2.useContext(ComponentContext);
+  const context = React3.useContext(ComponentContext);
   const composerEdit = useComposerEditMode();
   const childrenValue = typeof children === "string" || typeof children === "number" ? String(children) : void 0;
   const hasField = isFieldEnvelope(field);
@@ -5106,6 +5278,7 @@ function RichText(props) {
     name,
     "RichText"
   );
+  assertNamedEnvelope("RichText", field);
   if (!hasField && !hasValueProp && !name) {
     return null;
   }
@@ -5216,7 +5389,8 @@ function Image(props) {
     height: heightProp,
     ...imgProps
   } = props;
-  const context = React2.useContext(ComponentContext);
+  const context = React3.useContext(ComponentContext);
+  assertNamedEnvelope("Image", field);
   const coerced = coerceImageField(field, value, name);
   const boundField = coerced.field;
   const hasField = isFieldEnvelope(boundField);
@@ -5302,7 +5476,7 @@ if (typeof window !== "undefined") {
   } catch {
   }
 }
-var AmplifyUpContext = React2.createContext(null);
+var AmplifyUpContext = React3.createContext(null);
 function normalizeRoutePath2(route) {
   if (!route) return "";
   const path = route.split("?")[0] || "/";
@@ -5314,12 +5488,12 @@ function AmplifyUpProvider({
   config,
   pageContext
 }) {
-  const [initialized, setInitialized] = React2.useState(false);
-  const [pageConfig, setPageConfig] = React2.useState(null);
-  const [loading, setLoading] = React2.useState(true);
-  const [error, setError] = React2.useState(null);
-  const [source, setSource] = React2.useState(null);
-  const [meta, setMeta] = React2.useState(null);
+  const [initialized, setInitialized] = React3.useState(false);
+  const [pageConfig, setPageConfig] = React3.useState(null);
+  const [loading, setLoading] = React3.useState(true);
+  const [error, setError] = React3.useState(null);
+  const [source, setSource] = React3.useState(null);
+  const [meta, setMeta] = React3.useState(null);
   const getActualRoute = () => {
     if (typeof window === "undefined") return "";
     const currentPath = window.location.pathname;
@@ -5336,15 +5510,15 @@ function AmplifyUpProvider({
     }
     return currentPath;
   };
-  const loadedRouteRef = React2.useRef(null);
+  const loadedRouteRef = React3.useRef(null);
   const nextPathname = usePathname ? usePathname() : null;
-  const [pathname, setPathname] = React2.useState(() => {
+  const [pathname, setPathname] = React3.useState(() => {
     if (typeof window !== "undefined") {
       return getActualRoute();
     }
     return "";
   });
-  React2.useEffect(() => {
+  React3.useEffect(() => {
     if (typeof window !== "undefined") {
       const actualRoute = getActualRoute();
       if (window.location.pathname === "/api/pages/proxy" || window.location.pathname.startsWith("/api/pages/proxy")) {
@@ -5371,11 +5545,11 @@ function AmplifyUpProvider({
     }
   }, [nextPathname]);
   const pageContextKey = pageContext ? `${pageContext.resourceType}:${pageContext.key}` : "";
-  React2.useEffect(() => {
+  React3.useEffect(() => {
     if (!initialized || !pageContext) return;
     getSDK().setPageContext(pageContext);
   }, [initialized, pageContextKey]);
-  React2.useEffect(() => {
+  React3.useEffect(() => {
     let cancelled = false;
     const sdk = getSDK();
     const run = async () => {
@@ -5452,6 +5626,13 @@ function AmplifyUpProvider({
           description: "This page has not been published yet.",
           layoutTree: []
         };
+        if (result.pageConfig) {
+          sdk.applyResolvedPageData(
+            result.pageConfig.pageData || null,
+            result.pageConfig.route,
+            extractRouteParams(result.pageConfig.route, actualRoute)
+          );
+        }
         setInitialized(true);
         setSource((prev) => prev === result.source ? prev : result.source);
         setMeta(
@@ -5464,13 +5645,6 @@ function AmplifyUpProvider({
           }
           return nextConfig;
         });
-        if (result.pageConfig) {
-          sdk.applyResolvedPageData(
-            result.pageConfig.pageData || null,
-            result.pageConfig.route,
-            extractRouteParams(result.pageConfig.route, actualRoute)
-          );
-        }
         loadedRouteRef.current = actualRoute;
       } catch (err) {
         if (cancelled) return;
@@ -5497,6 +5671,39 @@ function AmplifyUpProvider({
     config.clientPersonalization,
     pageContextKey
   ]);
+  React3.useEffect(() => {
+    const applyLayoutTree = (layoutTree) => {
+      if (!Array.isArray(layoutTree)) return;
+      setPageConfig((prev) => {
+        const next = envelopePageConfig({
+          ...prev || {
+            id: "patched",
+            route: getActualRoute(),
+            title: "",
+            layoutTree: []
+          },
+          layoutTree
+        });
+        return next;
+      });
+      setLoading(false);
+    };
+    const onMessage = (event) => {
+      if (event.data?.type === "AMPLIFYUP_LAYOUT_PATCH") {
+        applyLayoutTree(event.data.layoutTree);
+      }
+    };
+    const onCustom = (event) => {
+      const detail = event.detail || {};
+      applyLayoutTree(detail.layoutTree);
+    };
+    window.addEventListener("message", onMessage);
+    window.addEventListener("amplifyup:layout-patch", onCustom);
+    return () => {
+      window.removeEventListener("message", onMessage);
+      window.removeEventListener("amplifyup:layout-patch", onCustom);
+    };
+  }, []);
   return /* @__PURE__ */ jsxRuntime.jsx(
     AmplifyUpContext.Provider,
     {
@@ -5506,7 +5713,7 @@ function AmplifyUpProvider({
   );
 }
 function useAmplifyUp() {
-  const context = React2.useContext(AmplifyUpContext);
+  const context = React3.useContext(AmplifyUpContext);
   if (!context) {
     throw new Error("useAmplifyUp must be used within AmplifyUpProvider");
   }
@@ -5517,6 +5724,7 @@ exports.AmplifyPageContent = AmplifyPageContent;
 exports.AmplifyRenderer = AmplifyRenderer;
 exports.AmplifyUpProvider = AmplifyUpProvider;
 exports.ComponentContextProvider = ComponentContextProvider;
+exports.ComposerLayoutStatusProvider = ComposerLayoutStatusProvider;
 exports.ComposerProvider = ComposerProvider;
 exports.Field = Field;
 exports.Image = Image;
@@ -5537,8 +5745,11 @@ exports.isWorkingContentRequest = isWorkingContentRequest;
 exports.listOwnerFromSpec = listOwnerFromSpec;
 exports.nextPageSpec = nextPageSpec;
 exports.queryContent = queryContent;
+exports.resolveSlotState = resolveSlotState;
 exports.searchSpec = searchSpec;
 exports.selectVariants = selectVariants;
+exports.slotShowsAddComponent = slotShowsAddComponent;
+exports.slotStateFromEl = slotStateFromEl;
 exports.toFieldEnvelopes = toFieldEnvelopes;
 exports.useAmplifyUp = useAmplifyUp;
 //# sourceMappingURL=react.js.map