@almadar/ui 4.23.0 → 4.25.0

package/dist/avl/index.cjs

@@ -47023,7 +47023,8 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
     if (!child || typeof child !== "object") return null;
     const childId = `${parentId}-${index}`;
     const childPath = parentPath === "root" ? `root.children.${index}` : `${parentPath}.children.${index}`;
-    const { type: _childType, props: nestedProps, _id: _childNodeId, children: _childChildren, ...flatProps } = child;
+    const childAsRecord = child;
+    const { type: _childType, props: nestedProps, _id: _childNodeId, children: _childChildren, ...flatProps } = childAsRecord;
     const resolvedProps = nestedProps !== void 0 ? nestedProps : flatProps;
     if (_childChildren !== void 0 && nestedProps === void 0) {
       resolvedProps.children = _childChildren;
@@ -47051,7 +47052,46 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
   });
 }
 function isPatternConfig(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value) && "type" in value && typeof value.type === "string";
+  if (value === null || value === void 0) return false;
+  if (typeof value !== "object") return false;
+  if (Array.isArray(value)) return false;
+  if (React127__namespace.default.isValidElement(value)) return false;
+  if (value instanceof Date) return false;
+  if (typeof value === "function") return false;
+  const record = value;
+  return "type" in record && typeof record.type === "string";
+}
+function isPlainConfigObject(value) {
+  if (React127__namespace.default.isValidElement(value)) return false;
+  if (value instanceof Date) return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+function substituteTraitRefsDeep(value, pathKey) {
+  if (typeof value === "string") {
+    const match = TRAIT_BINDING_RE.exec(value);
+    if (match) {
+      const traitName = match[1];
+      return /* @__PURE__ */ jsxRuntime.jsx(TraitFrame, { traitName }, `${pathKey}:${traitName}`);
+    }
+    return value;
+  }
+  if (typeof value === "number" || typeof value === "boolean" || value === null || value === void 0 || typeof value === "function") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map(
+      (item, i) => substituteTraitRefsDeep(item, `${pathKey}[${i}]`)
+    );
+  }
+  if (typeof value === "object" && isPlainConfigObject(value)) {
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+      out[k] = substituteTraitRefsDeep(v, `${pathKey}.${k}`);
+    }
+    return out;
+  }
+  return value;
 }
 function renderPatternProps(props, onDismiss) {
   const rendered = {};
@@ -47059,17 +47099,19 @@ function renderPatternProps(props, onDismiss) {
     if (key === "children") {
       rendered[key] = value;
     } else if (isPatternConfig(value)) {
+      const nestedProps = {};
+      for (const [k, v] of Object.entries(value)) {
+        if (k !== "type") nestedProps[k] = v;
+      }
       const childContent = {
         id: `prop-${key}`,
         pattern: value.type,
-        props: Object.fromEntries(
-          Object.entries(value).filter(([k]) => k !== "type")
-        ),
+        props: nestedProps,
         priority: 0
       };
       rendered[key] = /* @__PURE__ */ jsxRuntime.jsx(SlotContentRenderer, { content: childContent, onDismiss });
     } else {
-      rendered[key] = value;
+      rendered[key] = substituteTraitRefsDeep(value, `prop:${key}`);
     }
   }
   return rendered;
@@ -51680,7 +51722,7 @@ function resolveLambdaBindings(body, argName, arg) {
     let cur = arg;
     for (const seg of path.split(".")) {
       if (cur === null || cur === void 0) return void 0;
-      if (typeof cur !== "object") return void 0;
+      if (typeof cur !== "object" || Array.isArray(cur)) return void 0;
       cur = cur[seg];
     }
     return cur;
@@ -51696,7 +51738,7 @@ function resolveLambdaBindings(body, argName, arg) {
   if (Array.isArray(body)) {
     return body.map((b) => resolveLambdaBindings(b, argName, arg));
   }
-  if (body !== null && typeof body === "object") {
+  if (body !== null && typeof body === "object" && !React127__namespace.default.isValidElement(body) && !(body instanceof Date) && typeof body !== "function") {
     const out = {};
     for (const [k, v] of Object.entries(body)) {
       out[k] = resolveLambdaBindings(v, argName, arg);
@@ -51715,7 +51757,7 @@ function getSlotContentRenderer2() {
 function makeLambdaFn(argName, lambdaBody, callerKey) {
   return (item, index) => {
     const resolvedBody = resolveLambdaBindings(lambdaBody, argName, item);
-    if (resolvedBody === null || typeof resolvedBody !== "object" || Array.isArray(resolvedBody)) {
+    if (resolvedBody === null || typeof resolvedBody !== "object" || Array.isArray(resolvedBody) || typeof resolvedBody === "function" || React127__namespace.default.isValidElement(resolvedBody) || resolvedBody instanceof Date) {
       return null;
     }
     const record = resolvedBody;
@@ -51723,12 +51765,14 @@ function makeLambdaFn(argName, lambdaBody, callerKey) {
       return null;
     }
     const SlotContentRenderer2 = getSlotContentRenderer2();
+    const childProps = {};
+    for (const [k, v] of Object.entries(record)) {
+      if (k !== "type") childProps[k] = v;
+    }
     const childContent = {
       id: `lambda-${callerKey}-${index}`,
       pattern: record.type,
-      props: Object.fromEntries(
-        Object.entries(record).filter(([k]) => k !== "type")
-      ),
+      props: childProps,
       priority: 0
     };
     return React127__namespace.default.createElement(SlotContentRenderer2, { content: childContent });
@@ -51741,15 +51785,16 @@ function convertNode(node, callerKey) {
       const [, argName, body] = node;
       return makeLambdaFn(argName, body, callerKey);
     }
+    const arr = node;
     let anyChanged = false;
-    const mapped = node.map((item, i) => {
+    const mapped = arr.map((item, i) => {
       const next = convertNode(item, `${callerKey}[${i}]`);
       if (next !== item) anyChanged = true;
       return next;
     });
     return anyChanged ? mapped : node;
   }
-  if (typeof node === "object") {
+  if (typeof node === "object" && !React127__namespace.default.isValidElement(node) && !(node instanceof Date)) {
     return convertObjectProps(node);
   }
   return node;
@@ -52773,6 +52818,7 @@ function prepareSchemaForPreview(input) {
 // runtime/OrbPreview.tsx
 init_logger();
 var xOrbitalLog2 = createLogger("almadar:runtime:cross-orbital");
+var navLog = createLogger("almadar:runtime:navigation");
 function normalizeChild(child) {
   if (typeof child === "string") return child;
   if (child === null || typeof child !== "object" || Array.isArray(child)) {
@@ -52848,6 +52894,19 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
   }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, embeddedTraits]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName, orbitalsByTrait, embeddedTraits } : { navigate: onNavigate, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits };
   const { sendEvent } = useTraitStateMachine(traits2, uiSlots, opts);
+  const prevTraitNamesRef = React127.useRef("");
+  React127.useEffect(() => {
+    const traitNames = traits2.map((b) => b.trait?.name ?? "").filter(Boolean).sort().join(",");
+    if (prevTraitNamesRef.current && prevTraitNamesRef.current !== traitNames) {
+      navLog.info("page:trait-set-changed", {
+        from: prevTraitNamesRef.current,
+        to: traitNames,
+        action: "clearAll-slots"
+      });
+      uiSlots.clearAll();
+    }
+    prevTraitNamesRef.current = traitNames;
+  }, [traits2, uiSlots]);
   const initSentRef = React127.useRef(false);
   React127.useEffect(() => {
     if (!orbitalNames?.length) {
@@ -52862,6 +52921,10 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
     }, 5e3);
     return () => clearTimeout(fallback);
   }, [traits2, orbitalNames, sendEvent, onLocalFallback]);
+  const orbitalsKey = (orbitalNames ?? []).slice().sort().join(",");
+  React127.useEffect(() => {
+    initSentRef.current = false;
+  }, [orbitalsKey]);
   React127.useEffect(() => {
     if (!bridge.connected || !orbitalNames?.length || initSentRef.current) return;
     initSentRef.current = true;
@@ -53102,8 +53165,19 @@ function OrbPreview({
   }, [initialPageName, currentPage]);
   const handleNavigate = React127.useCallback((path) => {
     const match = pages.find(({ page }) => page.path === path);
+    navLog.info("handleNavigate", {
+      path,
+      matched: match?.page.name ?? null,
+      availablePaths: pages.map((p2) => p2.page.path)
+    });
     if (match) {
       setCurrentPage(match.page.name);
+      if (typeof window !== "undefined") {
+        const url = new URL(window.location.href);
+        url.searchParams.set("page", path);
+        window.history.pushState({}, "", url.toString());
+        window.dispatchEvent(new PopStateEvent("popstate"));
+      }
     }
   }, [pages]);
   if (!parseResult.ok) {
@@ -53115,18 +53189,30 @@ function OrbPreview({
   const containerRef = React127.useRef(null);
   React127.useEffect(() => {
     const el = containerRef.current;
-    if (!el || pages.length <= 1) return;
+    if (!el) return;
+    if (pages.length <= 1) {
+      navLog.info("interceptor:skipped", { reason: "single-page schema", pageCount: pages.length });
+      return;
+    }
     const handler = (e) => {
       const anchor = e.target.closest("a");
       if (!anchor) return;
       const href = anchor.getAttribute("href") ?? anchor.getAttribute("to") ?? "";
-      if (!href || href.startsWith("http") || href.startsWith("mailto:") || href.startsWith("#")) return;
+      navLog.info("click:intercepted", {
+        href,
+        anchorText: anchor.textContent?.trim().slice(0, 40)
+      });
+      if (!href || href.startsWith("http") || href.startsWith("mailto:") || href.startsWith("#")) {
+        navLog.info("click:skipped", { href, reason: "external/empty/hash" });
+        return;
+      }
       e.preventDefault();
       e.stopPropagation();
       e.stopImmediatePropagation();
       handleNavigate(href);
     };
     el.addEventListener("click", handler, true);
+    navLog.info("interceptor:installed", { pageCount: pages.length, paths: pages.map((p2) => p2.page.path) });
     return () => el.removeEventListener("click", handler, true);
   }, [pages, handleNavigate]);
   return /* @__PURE__ */ jsxRuntime.jsxs(

package/dist/avl/index.js

@@ -46977,7 +46977,8 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
     if (!child || typeof child !== "object") return null;
     const childId = `${parentId}-${index}`;
     const childPath = parentPath === "root" ? `root.children.${index}` : `${parentPath}.children.${index}`;
-    const { type: _childType, props: nestedProps, _id: _childNodeId, children: _childChildren, ...flatProps } = child;
+    const childAsRecord = child;
+    const { type: _childType, props: nestedProps, _id: _childNodeId, children: _childChildren, ...flatProps } = childAsRecord;
     const resolvedProps = nestedProps !== void 0 ? nestedProps : flatProps;
     if (_childChildren !== void 0 && nestedProps === void 0) {
       resolvedProps.children = _childChildren;
@@ -47005,7 +47006,46 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
   });
 }
 function isPatternConfig(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value) && "type" in value && typeof value.type === "string";
+  if (value === null || value === void 0) return false;
+  if (typeof value !== "object") return false;
+  if (Array.isArray(value)) return false;
+  if (React127__default.isValidElement(value)) return false;
+  if (value instanceof Date) return false;
+  if (typeof value === "function") return false;
+  const record = value;
+  return "type" in record && typeof record.type === "string";
+}
+function isPlainConfigObject(value) {
+  if (React127__default.isValidElement(value)) return false;
+  if (value instanceof Date) return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+function substituteTraitRefsDeep(value, pathKey) {
+  if (typeof value === "string") {
+    const match = TRAIT_BINDING_RE.exec(value);
+    if (match) {
+      const traitName = match[1];
+      return /* @__PURE__ */ jsx(TraitFrame, { traitName }, `${pathKey}:${traitName}`);
+    }
+    return value;
+  }
+  if (typeof value === "number" || typeof value === "boolean" || value === null || value === void 0 || typeof value === "function") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map(
+      (item, i) => substituteTraitRefsDeep(item, `${pathKey}[${i}]`)
+    );
+  }
+  if (typeof value === "object" && isPlainConfigObject(value)) {
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+      out[k] = substituteTraitRefsDeep(v, `${pathKey}.${k}`);
+    }
+    return out;
+  }
+  return value;
 }
 function renderPatternProps(props, onDismiss) {
   const rendered = {};
@@ -47013,17 +47053,19 @@ function renderPatternProps(props, onDismiss) {
     if (key === "children") {
       rendered[key] = value;
     } else if (isPatternConfig(value)) {
+      const nestedProps = {};
+      for (const [k, v] of Object.entries(value)) {
+        if (k !== "type") nestedProps[k] = v;
+      }
       const childContent = {
         id: `prop-${key}`,
         pattern: value.type,
-        props: Object.fromEntries(
-          Object.entries(value).filter(([k]) => k !== "type")
-        ),
+        props: nestedProps,
         priority: 0
       };
       rendered[key] = /* @__PURE__ */ jsx(SlotContentRenderer, { content: childContent, onDismiss });
     } else {
-      rendered[key] = value;
+      rendered[key] = substituteTraitRefsDeep(value, `prop:${key}`);
     }
   }
   return rendered;
@@ -51634,7 +51676,7 @@ function resolveLambdaBindings(body, argName, arg) {
     let cur = arg;
     for (const seg of path.split(".")) {
       if (cur === null || cur === void 0) return void 0;
-      if (typeof cur !== "object") return void 0;
+      if (typeof cur !== "object" || Array.isArray(cur)) return void 0;
       cur = cur[seg];
     }
     return cur;
@@ -51650,7 +51692,7 @@ function resolveLambdaBindings(body, argName, arg) {
   if (Array.isArray(body)) {
     return body.map((b) => resolveLambdaBindings(b, argName, arg));
   }
-  if (body !== null && typeof body === "object") {
+  if (body !== null && typeof body === "object" && !React127__default.isValidElement(body) && !(body instanceof Date) && typeof body !== "function") {
     const out = {};
     for (const [k, v] of Object.entries(body)) {
       out[k] = resolveLambdaBindings(v, argName, arg);
@@ -51669,7 +51711,7 @@ function getSlotContentRenderer2() {
 function makeLambdaFn(argName, lambdaBody, callerKey) {
   return (item, index) => {
     const resolvedBody = resolveLambdaBindings(lambdaBody, argName, item);
-    if (resolvedBody === null || typeof resolvedBody !== "object" || Array.isArray(resolvedBody)) {
+    if (resolvedBody === null || typeof resolvedBody !== "object" || Array.isArray(resolvedBody) || typeof resolvedBody === "function" || React127__default.isValidElement(resolvedBody) || resolvedBody instanceof Date) {
       return null;
     }
     const record = resolvedBody;
@@ -51677,12 +51719,14 @@ function makeLambdaFn(argName, lambdaBody, callerKey) {
       return null;
     }
     const SlotContentRenderer2 = getSlotContentRenderer2();
+    const childProps = {};
+    for (const [k, v] of Object.entries(record)) {
+      if (k !== "type") childProps[k] = v;
+    }
     const childContent = {
       id: `lambda-${callerKey}-${index}`,
       pattern: record.type,
-      props: Object.fromEntries(
-        Object.entries(record).filter(([k]) => k !== "type")
-      ),
+      props: childProps,
       priority: 0
     };
     return React127__default.createElement(SlotContentRenderer2, { content: childContent });
@@ -51695,15 +51739,16 @@ function convertNode(node, callerKey) {
       const [, argName, body] = node;
       return makeLambdaFn(argName, body, callerKey);
     }
+    const arr = node;
     let anyChanged = false;
-    const mapped = node.map((item, i) => {
+    const mapped = arr.map((item, i) => {
       const next = convertNode(item, `${callerKey}[${i}]`);
       if (next !== item) anyChanged = true;
       return next;
     });
     return anyChanged ? mapped : node;
   }
-  if (typeof node === "object") {
+  if (typeof node === "object" && !React127__default.isValidElement(node) && !(node instanceof Date)) {
     return convertObjectProps(node);
   }
   return node;
@@ -52727,6 +52772,7 @@ function prepareSchemaForPreview(input) {
 // runtime/OrbPreview.tsx
 init_logger();
 var xOrbitalLog2 = createLogger("almadar:runtime:cross-orbital");
+var navLog = createLogger("almadar:runtime:navigation");
 function normalizeChild(child) {
   if (typeof child === "string") return child;
   if (child === null || typeof child !== "object" || Array.isArray(child)) {
@@ -52802,6 +52848,19 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
   }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, embeddedTraits]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName, orbitalsByTrait, embeddedTraits } : { navigate: onNavigate, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits };
   const { sendEvent } = useTraitStateMachine(traits2, uiSlots, opts);
+  const prevTraitNamesRef = useRef("");
+  useEffect(() => {
+    const traitNames = traits2.map((b) => b.trait?.name ?? "").filter(Boolean).sort().join(",");
+    if (prevTraitNamesRef.current && prevTraitNamesRef.current !== traitNames) {
+      navLog.info("page:trait-set-changed", {
+        from: prevTraitNamesRef.current,
+        to: traitNames,
+        action: "clearAll-slots"
+      });
+      uiSlots.clearAll();
+    }
+    prevTraitNamesRef.current = traitNames;
+  }, [traits2, uiSlots]);
   const initSentRef = useRef(false);
   useEffect(() => {
     if (!orbitalNames?.length) {
@@ -52816,6 +52875,10 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
     }, 5e3);
     return () => clearTimeout(fallback);
   }, [traits2, orbitalNames, sendEvent, onLocalFallback]);
+  const orbitalsKey = (orbitalNames ?? []).slice().sort().join(",");
+  useEffect(() => {
+    initSentRef.current = false;
+  }, [orbitalsKey]);
   useEffect(() => {
     if (!bridge.connected || !orbitalNames?.length || initSentRef.current) return;
     initSentRef.current = true;
@@ -53056,8 +53119,19 @@ function OrbPreview({
   }, [initialPageName, currentPage]);
   const handleNavigate = useCallback((path) => {
     const match = pages.find(({ page }) => page.path === path);
+    navLog.info("handleNavigate", {
+      path,
+      matched: match?.page.name ?? null,
+      availablePaths: pages.map((p2) => p2.page.path)
+    });
     if (match) {
       setCurrentPage(match.page.name);
+      if (typeof window !== "undefined") {
+        const url = new URL(window.location.href);
+        url.searchParams.set("page", path);
+        window.history.pushState({}, "", url.toString());
+        window.dispatchEvent(new PopStateEvent("popstate"));
+      }
     }
   }, [pages]);
   if (!parseResult.ok) {
@@ -53069,18 +53143,30 @@ function OrbPreview({
   const containerRef = useRef(null);
   useEffect(() => {
     const el = containerRef.current;
-    if (!el || pages.length <= 1) return;
+    if (!el) return;
+    if (pages.length <= 1) {
+      navLog.info("interceptor:skipped", { reason: "single-page schema", pageCount: pages.length });
+      return;
+    }
     const handler = (e) => {
       const anchor = e.target.closest("a");
       if (!anchor) return;
       const href = anchor.getAttribute("href") ?? anchor.getAttribute("to") ?? "";
-      if (!href || href.startsWith("http") || href.startsWith("mailto:") || href.startsWith("#")) return;
+      navLog.info("click:intercepted", {
+        href,
+        anchorText: anchor.textContent?.trim().slice(0, 40)
+      });
+      if (!href || href.startsWith("http") || href.startsWith("mailto:") || href.startsWith("#")) {
+        navLog.info("click:skipped", { href, reason: "external/empty/hash" });
+        return;
+      }
       e.preventDefault();
       e.stopPropagation();
       e.stopImmediatePropagation();
       handleNavigate(href);
     };
     el.addEventListener("click", handler, true);
+    navLog.info("interceptor:installed", { pageCount: pages.length, paths: pages.map((p2) => p2.page.path) });
     return () => el.removeEventListener("click", handler, true);
   }, [pages, handleNavigate]);
   return /* @__PURE__ */ jsxs(

package/dist/components/index.cjs

@@ -37769,7 +37769,8 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
     if (!child || typeof child !== "object") return null;
     const childId = `${parentId}-${index}`;
     const childPath = parentPath === "root" ? `root.children.${index}` : `${parentPath}.children.${index}`;
-    const { type: _childType, props: nestedProps, _id: _childNodeId, children: _childChildren, ...flatProps } = child;
+    const childAsRecord = child;
+    const { type: _childType, props: nestedProps, _id: _childNodeId, children: _childChildren, ...flatProps } = childAsRecord;
     const resolvedProps = nestedProps !== void 0 ? nestedProps : flatProps;
     if (_childChildren !== void 0 && nestedProps === void 0) {
       resolvedProps.children = _childChildren;
@@ -37797,7 +37798,46 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
   });
 }
 function isPatternConfig(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value) && "type" in value && typeof value.type === "string";
+  if (value === null || value === void 0) return false;
+  if (typeof value !== "object") return false;
+  if (Array.isArray(value)) return false;
+  if (React110__namespace.default.isValidElement(value)) return false;
+  if (value instanceof Date) return false;
+  if (typeof value === "function") return false;
+  const record = value;
+  return "type" in record && typeof record.type === "string";
+}
+function isPlainConfigObject(value) {
+  if (React110__namespace.default.isValidElement(value)) return false;
+  if (value instanceof Date) return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+function substituteTraitRefsDeep(value, pathKey) {
+  if (typeof value === "string") {
+    const match = TRAIT_BINDING_RE.exec(value);
+    if (match) {
+      const traitName = match[1];
+      return /* @__PURE__ */ jsxRuntime.jsx(TraitFrame, { traitName }, `${pathKey}:${traitName}`);
+    }
+    return value;
+  }
+  if (typeof value === "number" || typeof value === "boolean" || value === null || value === void 0 || typeof value === "function") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map(
+      (item, i) => substituteTraitRefsDeep(item, `${pathKey}[${i}]`)
+    );
+  }
+  if (typeof value === "object" && isPlainConfigObject(value)) {
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+      out[k] = substituteTraitRefsDeep(v, `${pathKey}.${k}`);
+    }
+    return out;
+  }
+  return value;
 }
 function renderPatternProps(props, onDismiss) {
   const rendered = {};
@@ -37805,17 +37845,19 @@ function renderPatternProps(props, onDismiss) {
     if (key === "children") {
       rendered[key] = value;
     } else if (isPatternConfig(value)) {
+      const nestedProps = {};
+      for (const [k, v] of Object.entries(value)) {
+        if (k !== "type") nestedProps[k] = v;
+      }
       const childContent = {
         id: `prop-${key}`,
         pattern: value.type,
-        props: Object.fromEntries(
-          Object.entries(value).filter(([k]) => k !== "type")
-        ),
+        props: nestedProps,
         priority: 0
       };
       rendered[key] = /* @__PURE__ */ jsxRuntime.jsx(SlotContentRenderer, { content: childContent, onDismiss });
     } else {
-      rendered[key] = value;
+      rendered[key] = substituteTraitRefsDeep(value, `prop:${key}`);
     }
   }
   return rendered;

package/dist/components/index.js

@@ -37724,7 +37724,8 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
     if (!child || typeof child !== "object") return null;
     const childId = `${parentId}-${index}`;
     const childPath = parentPath === "root" ? `root.children.${index}` : `${parentPath}.children.${index}`;
-    const { type: _childType, props: nestedProps, _id: _childNodeId, children: _childChildren, ...flatProps } = child;
+    const childAsRecord = child;
+    const { type: _childType, props: nestedProps, _id: _childNodeId, children: _childChildren, ...flatProps } = childAsRecord;
     const resolvedProps = nestedProps !== void 0 ? nestedProps : flatProps;
     if (_childChildren !== void 0 && nestedProps === void 0) {
       resolvedProps.children = _childChildren;
@@ -37752,7 +37753,46 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
   });
 }
 function isPatternConfig(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value) && "type" in value && typeof value.type === "string";
+  if (value === null || value === void 0) return false;
+  if (typeof value !== "object") return false;
+  if (Array.isArray(value)) return false;
+  if (React110__default.isValidElement(value)) return false;
+  if (value instanceof Date) return false;
+  if (typeof value === "function") return false;
+  const record = value;
+  return "type" in record && typeof record.type === "string";
+}
+function isPlainConfigObject(value) {
+  if (React110__default.isValidElement(value)) return false;
+  if (value instanceof Date) return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+function substituteTraitRefsDeep(value, pathKey) {
+  if (typeof value === "string") {
+    const match = TRAIT_BINDING_RE.exec(value);
+    if (match) {
+      const traitName = match[1];
+      return /* @__PURE__ */ jsx(TraitFrame, { traitName }, `${pathKey}:${traitName}`);
+    }
+    return value;
+  }
+  if (typeof value === "number" || typeof value === "boolean" || value === null || value === void 0 || typeof value === "function") {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map(
+      (item, i) => substituteTraitRefsDeep(item, `${pathKey}[${i}]`)
+    );
+  }
+  if (typeof value === "object" && isPlainConfigObject(value)) {
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+      out[k] = substituteTraitRefsDeep(v, `${pathKey}.${k}`);
+    }
+    return out;
+  }
+  return value;
 }
 function renderPatternProps(props, onDismiss) {
   const rendered = {};
@@ -37760,17 +37800,19 @@ function renderPatternProps(props, onDismiss) {
     if (key === "children") {
       rendered[key] = value;
     } else if (isPatternConfig(value)) {
+      const nestedProps = {};
+      for (const [k, v] of Object.entries(value)) {
+        if (k !== "type") nestedProps[k] = v;
+      }
       const childContent = {
         id: `prop-${key}`,
         pattern: value.type,
-        props: Object.fromEntries(
-          Object.entries(value).filter(([k]) => k !== "type")
-        ),
+        props: nestedProps,
         priority: 0
       };
       rendered[key] = /* @__PURE__ */ jsx(SlotContentRenderer, { content: childContent, onDismiss });
     } else {
-      rendered[key] = value;
+      rendered[key] = substituteTraitRefsDeep(value, `prop:${key}`);
     }
   }
   return rendered;

package/dist/context/UISlotContext.d.ts

@@ -19,7 +19,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import { type UISlotManager, type UISlot, type SlotContent, type RenderUIConfig, type SlotAnimation, type SlotChangeCallback } from '../hooks/useUISlots';
+import { type UISlotManager, type UISlot, type SlotContent, type SlotProps, type SlotPropValue, type SlotCallback, type RenderUIConfig, type SlotAnimation, type SlotChangeCallback } from '../hooks/useUISlots';
 /**
  * Context for the UI Slot Manager
  */
@@ -72,4 +72,4 @@ export declare function useSlotContent(slot: UISlot): SlotContent | null;
  * Hook to check if a slot has content.
  */
 export declare function useSlotHasContent(slot: UISlot): boolean;
-export { UISlotContext, type UISlotManager, type UISlot, type SlotContent, type RenderUIConfig, type SlotAnimation, type SlotChangeCallback, };
+export { UISlotContext, type UISlotManager, type UISlot, type SlotContent, type SlotProps, type SlotPropValue, type SlotCallback, type RenderUIConfig, type SlotAnimation, type SlotChangeCallback, };