@almadar/ui 2.60.4 → 2.61.0

package/dist/avl/index.cjs

@@ -19317,7 +19317,8 @@ var init_Carousel = __esm({
       const scrollRef = React127.useRef(null);
       const autoPlayRef = React127.useRef(null);
       const eventBus = useSafeEventBus3();
-      const totalSlides = items.length;
+      const safeItems = items ?? [];
+      const totalSlides = safeItems.length;
       const emitSlideChange = React127.useCallback(
         (newIndex) => {
           if (slideChangeEvent) {
@@ -19428,7 +19429,7 @@ var init_Carousel = __esm({
             onPointerMove: swipeHandlers.onPointerMove,
             onPointerUp: swipeHandlers.onPointerUp,
             onPointerCancel: swipeHandlers.onPointerCancel,
-            children: items.map((item, index) => /* @__PURE__ */ jsxRuntime.jsx(
+            children: safeItems.map((item, index) => /* @__PURE__ */ jsxRuntime.jsx(
               Box,
               {
                 className: cn(
@@ -19497,7 +19498,7 @@ var init_Carousel = __esm({
           {
             position: "absolute",
             className: "bottom-3 left-0 right-0 z-10",
-            children: /* @__PURE__ */ jsxRuntime.jsx(HStack, { gap: "xs", align: "center", justify: "center", children: items.map((_, index) => {
+            children: /* @__PURE__ */ jsxRuntime.jsx(HStack, { gap: "xs", align: "center", justify: "center", children: safeItems.map((_, index) => {
               const isActive = index === activeIndex;
               return /* @__PURE__ */ jsxRuntime.jsx(
                 Box,
@@ -46428,7 +46429,7 @@ function UISlotComponent({
     );
   }
   const slotContent = /* @__PURE__ */ jsxRuntime.jsx(SlotContentRenderer, { content, onDismiss: handleDismiss });
-  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsxRuntime.jsx(ErrorBoundary, { children: /* @__PURE__ */ jsxRuntime.jsx(React127.Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : slotContent;
+  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsxRuntime.jsx(ErrorBoundary, { children: /* @__PURE__ */ jsxRuntime.jsx(React127.Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : /* @__PURE__ */ jsxRuntime.jsx(ErrorBoundary, { children: slotContent });
   return /* @__PURE__ */ jsxRuntime.jsx(
     Box,
     {
@@ -46670,6 +46671,15 @@ function SlotContentRenderer({
   const entityProp = content.props.entity;
   const entityType = typeof entityProp === "string" ? entityProp : "";
   const storeData = useEntityRef(entityType);
+  React127__namespace.default.useEffect(() => {
+    if (!entityType) return;
+    if (typeof process !== "undefined" && process.env && process.env.NODE_ENV === "production") return;
+    if (STRING_ENTITY_WARNED.has(entityType)) return;
+    STRING_ENTITY_WARNED.add(entityType);
+    console.warn(
+      `[UISlotRenderer] String-entity binding '${entityType}' is deprecated. Pass 'items' or 'entity' as a value prop resolved from @payload.data. See docs/Almadar_Entity_V2_Plan.md \xA75.`
+    );
+  }, [entityType]);
   const schemaCtx = useEntitySchemaOptional();
   const entityDef = entityType && schemaCtx ? schemaCtx.entities.get(entityType) : void 0;
   const PatternComponent = getComponentForPattern(content.pattern);
@@ -46681,18 +46691,21 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restProps } = content.props;
     const renderedProps = renderPatternProps(restProps, onDismiss);
     let finalProps;
+    const resolvedItems = Array.isArray(renderedProps.items) ? renderedProps.items : entityType ? storeData : null;
     if (entityType) {
       finalProps = { ...renderedProps, entity: storeData };
-      if (!finalProps.fields && !finalProps.columns && storeData.length > 0) {
-        const sample = storeData[0];
-        if (sample && typeof sample === "object") {
-          const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
-          finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
-        }
-      }
+    } else if (Array.isArray(renderedProps.items)) {
+      finalProps = { ...renderedProps, entity: renderedProps.items };
     } else {
       finalProps = renderedProps;
     }
+    if (resolvedItems && resolvedItems.length > 0 && !finalProps.fields && !finalProps.columns) {
+      const sample = resolvedItems[0];
+      if (sample && typeof sample === "object") {
+        const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
+        finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
+      }
+    }
     const isFormPattern = FORM_PATTERNS.has(content.pattern) || content.pattern.includes("form");
     if (isFormPattern && entityDef && Array.isArray(finalProps.fields)) {
       finalProps.fields = enrichFormFields(finalProps.fields, entityDef);
@@ -46792,7 +46805,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var TRAIT_BINDING_RE, STRING_ENTITY_WARNED, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -46811,6 +46824,7 @@ var init_UISlotRenderer = __esm({
     init_TraitFrame();
     init_component_registry_generated();
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
+    STRING_ENTITY_WARNED = /* @__PURE__ */ new Set();
     SuspenseConfigContext = React127.createContext({ enabled: false });
     SlotContainedContext = React127.createContext(false);
     SuspenseConfigProvider.displayName = "SuspenseConfigProvider";

package/dist/avl/index.js

@@ -19271,7 +19271,8 @@ var init_Carousel = __esm({
       const scrollRef = useRef(null);
       const autoPlayRef = useRef(null);
       const eventBus = useSafeEventBus3();
-      const totalSlides = items.length;
+      const safeItems = items ?? [];
+      const totalSlides = safeItems.length;
       const emitSlideChange = useCallback(
         (newIndex) => {
           if (slideChangeEvent) {
@@ -19382,7 +19383,7 @@ var init_Carousel = __esm({
             onPointerMove: swipeHandlers.onPointerMove,
             onPointerUp: swipeHandlers.onPointerUp,
             onPointerCancel: swipeHandlers.onPointerCancel,
-            children: items.map((item, index) => /* @__PURE__ */ jsx(
+            children: safeItems.map((item, index) => /* @__PURE__ */ jsx(
               Box,
               {
                 className: cn(
@@ -19451,7 +19452,7 @@ var init_Carousel = __esm({
           {
             position: "absolute",
             className: "bottom-3 left-0 right-0 z-10",
-            children: /* @__PURE__ */ jsx(HStack, { gap: "xs", align: "center", justify: "center", children: items.map((_, index) => {
+            children: /* @__PURE__ */ jsx(HStack, { gap: "xs", align: "center", justify: "center", children: safeItems.map((_, index) => {
               const isActive = index === activeIndex;
               return /* @__PURE__ */ jsx(
                 Box,
@@ -46382,7 +46383,7 @@ function UISlotComponent({
     );
   }
   const slotContent = /* @__PURE__ */ jsx(SlotContentRenderer, { content, onDismiss: handleDismiss });
-  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsx(ErrorBoundary, { children: /* @__PURE__ */ jsx(Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : slotContent;
+  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsx(ErrorBoundary, { children: /* @__PURE__ */ jsx(Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : /* @__PURE__ */ jsx(ErrorBoundary, { children: slotContent });
   return /* @__PURE__ */ jsx(
     Box,
     {
@@ -46624,6 +46625,15 @@ function SlotContentRenderer({
   const entityProp = content.props.entity;
   const entityType = typeof entityProp === "string" ? entityProp : "";
   const storeData = useEntityRef(entityType);
+  React127__default.useEffect(() => {
+    if (!entityType) return;
+    if (typeof process !== "undefined" && process.env && process.env.NODE_ENV === "production") return;
+    if (STRING_ENTITY_WARNED.has(entityType)) return;
+    STRING_ENTITY_WARNED.add(entityType);
+    console.warn(
+      `[UISlotRenderer] String-entity binding '${entityType}' is deprecated. Pass 'items' or 'entity' as a value prop resolved from @payload.data. See docs/Almadar_Entity_V2_Plan.md \xA75.`
+    );
+  }, [entityType]);
   const schemaCtx = useEntitySchemaOptional();
   const entityDef = entityType && schemaCtx ? schemaCtx.entities.get(entityType) : void 0;
   const PatternComponent = getComponentForPattern(content.pattern);
@@ -46635,18 +46645,21 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restProps } = content.props;
     const renderedProps = renderPatternProps(restProps, onDismiss);
     let finalProps;
+    const resolvedItems = Array.isArray(renderedProps.items) ? renderedProps.items : entityType ? storeData : null;
     if (entityType) {
       finalProps = { ...renderedProps, entity: storeData };
-      if (!finalProps.fields && !finalProps.columns && storeData.length > 0) {
-        const sample = storeData[0];
-        if (sample && typeof sample === "object") {
-          const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
-          finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
-        }
-      }
+    } else if (Array.isArray(renderedProps.items)) {
+      finalProps = { ...renderedProps, entity: renderedProps.items };
     } else {
       finalProps = renderedProps;
     }
+    if (resolvedItems && resolvedItems.length > 0 && !finalProps.fields && !finalProps.columns) {
+      const sample = resolvedItems[0];
+      if (sample && typeof sample === "object") {
+        const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
+        finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
+      }
+    }
     const isFormPattern = FORM_PATTERNS.has(content.pattern) || content.pattern.includes("form");
     if (isFormPattern && entityDef && Array.isArray(finalProps.fields)) {
       finalProps.fields = enrichFormFields(finalProps.fields, entityDef);
@@ -46746,7 +46759,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var TRAIT_BINDING_RE, STRING_ENTITY_WARNED, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -46765,6 +46778,7 @@ var init_UISlotRenderer = __esm({
     init_TraitFrame();
     init_component_registry_generated();
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
+    STRING_ENTITY_WARNED = /* @__PURE__ */ new Set();
     SuspenseConfigContext = createContext({ enabled: false });
     SlotContainedContext = createContext(false);
     SuspenseConfigProvider.displayName = "SuspenseConfigProvider";

package/dist/components/index.cjs

@@ -14590,7 +14590,8 @@ var init_Carousel = __esm({
       const scrollRef = React110.useRef(null);
       const autoPlayRef = React110.useRef(null);
       const eventBus = useSafeEventBus3();
-      const totalSlides = items.length;
+      const safeItems = items ?? [];
+      const totalSlides = safeItems.length;
       const emitSlideChange = React110.useCallback(
         (newIndex) => {
           if (slideChangeEvent) {
@@ -14701,7 +14702,7 @@ var init_Carousel = __esm({
             onPointerMove: swipeHandlers.onPointerMove,
             onPointerUp: swipeHandlers.onPointerUp,
             onPointerCancel: swipeHandlers.onPointerCancel,
-            children: items.map((item, index) => /* @__PURE__ */ jsxRuntime.jsx(
+            children: safeItems.map((item, index) => /* @__PURE__ */ jsxRuntime.jsx(
               exports.Box,
               {
                 className: cn(
@@ -14770,7 +14771,7 @@ var init_Carousel = __esm({
           {
             position: "absolute",
             className: "bottom-3 left-0 right-0 z-10",
-            children: /* @__PURE__ */ jsxRuntime.jsx(exports.HStack, { gap: "xs", align: "center", justify: "center", children: items.map((_, index) => {
+            children: /* @__PURE__ */ jsxRuntime.jsx(exports.HStack, { gap: "xs", align: "center", justify: "center", children: safeItems.map((_, index) => {
               const isActive = index === activeIndex;
               return /* @__PURE__ */ jsxRuntime.jsx(
                 exports.Box,
@@ -37250,7 +37251,7 @@ function UISlotComponent({
     );
   }
   const slotContent = /* @__PURE__ */ jsxRuntime.jsx(SlotContentRenderer, { content, onDismiss: handleDismiss });
-  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsxRuntime.jsx(exports.ErrorBoundary, { children: /* @__PURE__ */ jsxRuntime.jsx(React110.Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : slotContent;
+  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsxRuntime.jsx(exports.ErrorBoundary, { children: /* @__PURE__ */ jsxRuntime.jsx(React110.Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : /* @__PURE__ */ jsxRuntime.jsx(exports.ErrorBoundary, { children: slotContent });
   return /* @__PURE__ */ jsxRuntime.jsx(
     exports.Box,
     {
@@ -37492,6 +37493,15 @@ function SlotContentRenderer({
   const entityProp = content.props.entity;
   const entityType = typeof entityProp === "string" ? entityProp : "";
   const storeData = providers.useEntityRef(entityType);
+  React110__namespace.default.useEffect(() => {
+    if (!entityType) return;
+    if (typeof process !== "undefined" && process.env && process.env.NODE_ENV === "production") return;
+    if (STRING_ENTITY_WARNED.has(entityType)) return;
+    STRING_ENTITY_WARNED.add(entityType);
+    console.warn(
+      `[UISlotRenderer] String-entity binding '${entityType}' is deprecated. Pass 'items' or 'entity' as a value prop resolved from @payload.data. See docs/Almadar_Entity_V2_Plan.md \xA75.`
+    );
+  }, [entityType]);
   const schemaCtx = useEntitySchemaOptional();
   const entityDef = entityType && schemaCtx ? schemaCtx.entities.get(entityType) : void 0;
   const PatternComponent = getComponentForPattern(content.pattern);
@@ -37503,18 +37513,21 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restProps } = content.props;
     const renderedProps = renderPatternProps(restProps, onDismiss);
     let finalProps;
+    const resolvedItems = Array.isArray(renderedProps.items) ? renderedProps.items : entityType ? storeData : null;
     if (entityType) {
       finalProps = { ...renderedProps, entity: storeData };
-      if (!finalProps.fields && !finalProps.columns && storeData.length > 0) {
-        const sample = storeData[0];
-        if (sample && typeof sample === "object") {
-          const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
-          finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
-        }
-      }
+    } else if (Array.isArray(renderedProps.items)) {
+      finalProps = { ...renderedProps, entity: renderedProps.items };
     } else {
       finalProps = renderedProps;
     }
+    if (resolvedItems && resolvedItems.length > 0 && !finalProps.fields && !finalProps.columns) {
+      const sample = resolvedItems[0];
+      if (sample && typeof sample === "object") {
+        const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
+        finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
+      }
+    }
     const isFormPattern = FORM_PATTERNS.has(content.pattern) || content.pattern.includes("form");
     if (isFormPattern && entityDef && Array.isArray(finalProps.fields)) {
       finalProps.fields = enrichFormFields(finalProps.fields, entityDef);
@@ -37614,7 +37627,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var TRAIT_BINDING_RE, STRING_ENTITY_WARNED, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -37631,6 +37644,7 @@ var init_UISlotRenderer = __esm({
     init_TraitFrame();
     init_component_registry_generated();
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
+    STRING_ENTITY_WARNED = /* @__PURE__ */ new Set();
     SuspenseConfigContext = React110.createContext({ enabled: false });
     SlotContainedContext = React110.createContext(false);
     SuspenseConfigProvider.displayName = "SuspenseConfigProvider";

package/dist/components/index.js

@@ -14545,7 +14545,8 @@ var init_Carousel = __esm({
       const scrollRef = useRef(null);
       const autoPlayRef = useRef(null);
       const eventBus = useSafeEventBus3();
-      const totalSlides = items.length;
+      const safeItems = items ?? [];
+      const totalSlides = safeItems.length;
       const emitSlideChange = useCallback(
         (newIndex) => {
           if (slideChangeEvent) {
@@ -14656,7 +14657,7 @@ var init_Carousel = __esm({
             onPointerMove: swipeHandlers.onPointerMove,
             onPointerUp: swipeHandlers.onPointerUp,
             onPointerCancel: swipeHandlers.onPointerCancel,
-            children: items.map((item, index) => /* @__PURE__ */ jsx(
+            children: safeItems.map((item, index) => /* @__PURE__ */ jsx(
               Box,
               {
                 className: cn(
@@ -14725,7 +14726,7 @@ var init_Carousel = __esm({
           {
             position: "absolute",
             className: "bottom-3 left-0 right-0 z-10",
-            children: /* @__PURE__ */ jsx(HStack, { gap: "xs", align: "center", justify: "center", children: items.map((_, index) => {
+            children: /* @__PURE__ */ jsx(HStack, { gap: "xs", align: "center", justify: "center", children: safeItems.map((_, index) => {
               const isActive = index === activeIndex;
               return /* @__PURE__ */ jsx(
                 Box,
@@ -37205,7 +37206,7 @@ function UISlotComponent({
     );
   }
   const slotContent = /* @__PURE__ */ jsx(SlotContentRenderer, { content, onDismiss: handleDismiss });
-  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsx(ErrorBoundary, { children: /* @__PURE__ */ jsx(Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : slotContent;
+  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsx(ErrorBoundary, { children: /* @__PURE__ */ jsx(Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : /* @__PURE__ */ jsx(ErrorBoundary, { children: slotContent });
   return /* @__PURE__ */ jsx(
     Box,
     {
@@ -37447,6 +37448,15 @@ function SlotContentRenderer({
   const entityProp = content.props.entity;
   const entityType = typeof entityProp === "string" ? entityProp : "";
   const storeData = useEntityRef(entityType);
+  React110__default.useEffect(() => {
+    if (!entityType) return;
+    if (typeof process !== "undefined" && process.env && process.env.NODE_ENV === "production") return;
+    if (STRING_ENTITY_WARNED.has(entityType)) return;
+    STRING_ENTITY_WARNED.add(entityType);
+    console.warn(
+      `[UISlotRenderer] String-entity binding '${entityType}' is deprecated. Pass 'items' or 'entity' as a value prop resolved from @payload.data. See docs/Almadar_Entity_V2_Plan.md \xA75.`
+    );
+  }, [entityType]);
   const schemaCtx = useEntitySchemaOptional();
   const entityDef = entityType && schemaCtx ? schemaCtx.entities.get(entityType) : void 0;
   const PatternComponent = getComponentForPattern(content.pattern);
@@ -37458,18 +37468,21 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restProps } = content.props;
     const renderedProps = renderPatternProps(restProps, onDismiss);
     let finalProps;
+    const resolvedItems = Array.isArray(renderedProps.items) ? renderedProps.items : entityType ? storeData : null;
     if (entityType) {
       finalProps = { ...renderedProps, entity: storeData };
-      if (!finalProps.fields && !finalProps.columns && storeData.length > 0) {
-        const sample = storeData[0];
-        if (sample && typeof sample === "object") {
-          const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
-          finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
-        }
-      }
+    } else if (Array.isArray(renderedProps.items)) {
+      finalProps = { ...renderedProps, entity: renderedProps.items };
     } else {
       finalProps = renderedProps;
     }
+    if (resolvedItems && resolvedItems.length > 0 && !finalProps.fields && !finalProps.columns) {
+      const sample = resolvedItems[0];
+      if (sample && typeof sample === "object") {
+        const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
+        finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
+      }
+    }
     const isFormPattern = FORM_PATTERNS.has(content.pattern) || content.pattern.includes("form");
     if (isFormPattern && entityDef && Array.isArray(finalProps.fields)) {
       finalProps.fields = enrichFormFields(finalProps.fields, entityDef);
@@ -37569,7 +37582,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var TRAIT_BINDING_RE, STRING_ENTITY_WARNED, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -37586,6 +37599,7 @@ var init_UISlotRenderer = __esm({
     init_TraitFrame();
     init_component_registry_generated();
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
+    STRING_ENTITY_WARNED = /* @__PURE__ */ new Set();
     SuspenseConfigContext = createContext({ enabled: false });
     SlotContainedContext = createContext(false);
     SuspenseConfigProvider.displayName = "SuspenseConfigProvider";

package/dist/components/organisms/types.d.ts

@@ -36,8 +36,26 @@ export interface SelectPayload {
     ids: (string | number)[];
 }
 export interface EntityDisplayProps<T = unknown> {
-    /** Entity name (string) or data injected by the runtime (array for lists, single object for detail) */
+    /**
+     * Entity data or a legacy entity-name string.
+     *
+     * V2 Phase 2 accepts three shapes here (value-first is the canonical path):
+     * - `readonly T[]`: pre-resolved array for list patterns.
+     * - `T`: pre-resolved single record for detail patterns.
+     * - `string`: legacy entity-type name resolved by the renderer via
+     *   `useEntityRef`. Emits a dev-mode deprecation warning; removal
+     *   scheduled for Phase 6 of docs/Almadar_Entity_V2_Plan.md.
+     *
+     * Prefer `items` for list shapes so organisms never depend on the
+     * renderer's string resolution at all.
+     */
     entity?: string | T | readonly T[];
+    /**
+     * Pre-resolved list of records. V2 Phase 2 addition. When set, organisms
+     * should read data from here instead of `entity`. Resolving from the
+     * calling trait's `@payload.data` is the authoring pattern.
+     */
+    items?: readonly T[];
     /** Additional CSS classes */
     className?: string;
     /** Loading state indicator */

package/dist/providers/index.cjs

@@ -16134,7 +16134,8 @@ var init_Carousel = __esm({
       const scrollRef = React116.useRef(null);
       const autoPlayRef = React116.useRef(null);
       const eventBus = useSafeEventBus3();
-      const totalSlides = items.length;
+      const safeItems = items ?? [];
+      const totalSlides = safeItems.length;
       const emitSlideChange = React116.useCallback(
         (newIndex) => {
           if (slideChangeEvent) {
@@ -16245,7 +16246,7 @@ var init_Carousel = __esm({
             onPointerMove: swipeHandlers.onPointerMove,
             onPointerUp: swipeHandlers.onPointerUp,
             onPointerCancel: swipeHandlers.onPointerCancel,
-            children: items.map((item, index) => /* @__PURE__ */ jsxRuntime.jsx(
+            children: safeItems.map((item, index) => /* @__PURE__ */ jsxRuntime.jsx(
               Box,
               {
                 className: cn(
@@ -16314,7 +16315,7 @@ var init_Carousel = __esm({
           {
             position: "absolute",
             className: "bottom-3 left-0 right-0 z-10",
-            children: /* @__PURE__ */ jsxRuntime.jsx(HStack, { gap: "xs", align: "center", justify: "center", children: items.map((_, index) => {
+            children: /* @__PURE__ */ jsxRuntime.jsx(HStack, { gap: "xs", align: "center", justify: "center", children: safeItems.map((_, index) => {
               const isActive = index === activeIndex;
               return /* @__PURE__ */ jsxRuntime.jsx(
                 Box,
@@ -37760,7 +37761,7 @@ function UISlotComponent({
     );
   }
   const slotContent = /* @__PURE__ */ jsxRuntime.jsx(SlotContentRenderer, { content, onDismiss: handleDismiss });
-  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsxRuntime.jsx(ErrorBoundary, { children: /* @__PURE__ */ jsxRuntime.jsx(React116.Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : slotContent;
+  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsxRuntime.jsx(ErrorBoundary, { children: /* @__PURE__ */ jsxRuntime.jsx(React116.Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : /* @__PURE__ */ jsxRuntime.jsx(ErrorBoundary, { children: slotContent });
   return /* @__PURE__ */ jsxRuntime.jsx(
     Box,
     {
@@ -38002,6 +38003,15 @@ function SlotContentRenderer({
   const entityProp = content.props.entity;
   const entityType = typeof entityProp === "string" ? entityProp : "";
   const storeData = providers.useEntityRef(entityType);
+  React116__namespace.default.useEffect(() => {
+    if (!entityType) return;
+    if (typeof process !== "undefined" && process.env && process.env.NODE_ENV === "production") return;
+    if (STRING_ENTITY_WARNED.has(entityType)) return;
+    STRING_ENTITY_WARNED.add(entityType);
+    console.warn(
+      `[UISlotRenderer] String-entity binding '${entityType}' is deprecated. Pass 'items' or 'entity' as a value prop resolved from @payload.data. See docs/Almadar_Entity_V2_Plan.md \xA75.`
+    );
+  }, [entityType]);
   const schemaCtx = useEntitySchemaOptional();
   const entityDef = entityType && schemaCtx ? schemaCtx.entities.get(entityType) : void 0;
   const PatternComponent = getComponentForPattern(content.pattern);
@@ -38013,18 +38023,21 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restProps } = content.props;
     const renderedProps = renderPatternProps(restProps, onDismiss);
     let finalProps;
+    const resolvedItems = Array.isArray(renderedProps.items) ? renderedProps.items : entityType ? storeData : null;
     if (entityType) {
       finalProps = { ...renderedProps, entity: storeData };
-      if (!finalProps.fields && !finalProps.columns && storeData.length > 0) {
-        const sample = storeData[0];
-        if (sample && typeof sample === "object") {
-          const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
-          finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
-        }
-      }
+    } else if (Array.isArray(renderedProps.items)) {
+      finalProps = { ...renderedProps, entity: renderedProps.items };
     } else {
       finalProps = renderedProps;
     }
+    if (resolvedItems && resolvedItems.length > 0 && !finalProps.fields && !finalProps.columns) {
+      const sample = resolvedItems[0];
+      if (sample && typeof sample === "object") {
+        const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
+        finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
+      }
+    }
     const isFormPattern = FORM_PATTERNS.has(content.pattern) || content.pattern.includes("form");
     if (isFormPattern && entityDef && Array.isArray(finalProps.fields)) {
       finalProps.fields = enrichFormFields(finalProps.fields, entityDef);
@@ -38124,7 +38137,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var TRAIT_BINDING_RE, STRING_ENTITY_WARNED, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -38141,6 +38154,7 @@ var init_UISlotRenderer = __esm({
     init_TraitFrame();
     init_component_registry_generated();
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
+    STRING_ENTITY_WARNED = /* @__PURE__ */ new Set();
     SuspenseConfigContext = React116.createContext({ enabled: false });
     SlotContainedContext = React116.createContext(false);
     SuspenseConfigProvider.displayName = "SuspenseConfigProvider";

package/dist/providers/index.js

@@ -16089,7 +16089,8 @@ var init_Carousel = __esm({
       const scrollRef = useRef(null);
       const autoPlayRef = useRef(null);
       const eventBus = useSafeEventBus3();
-      const totalSlides = items.length;
+      const safeItems = items ?? [];
+      const totalSlides = safeItems.length;
       const emitSlideChange = useCallback(
         (newIndex) => {
           if (slideChangeEvent) {
@@ -16200,7 +16201,7 @@ var init_Carousel = __esm({
             onPointerMove: swipeHandlers.onPointerMove,
             onPointerUp: swipeHandlers.onPointerUp,
             onPointerCancel: swipeHandlers.onPointerCancel,
-            children: items.map((item, index) => /* @__PURE__ */ jsx(
+            children: safeItems.map((item, index) => /* @__PURE__ */ jsx(
               Box,
               {
                 className: cn(
@@ -16269,7 +16270,7 @@ var init_Carousel = __esm({
           {
             position: "absolute",
             className: "bottom-3 left-0 right-0 z-10",
-            children: /* @__PURE__ */ jsx(HStack, { gap: "xs", align: "center", justify: "center", children: items.map((_, index) => {
+            children: /* @__PURE__ */ jsx(HStack, { gap: "xs", align: "center", justify: "center", children: safeItems.map((_, index) => {
               const isActive = index === activeIndex;
               return /* @__PURE__ */ jsx(
                 Box,
@@ -37715,7 +37716,7 @@ function UISlotComponent({
     );
   }
   const slotContent = /* @__PURE__ */ jsx(SlotContentRenderer, { content, onDismiss: handleDismiss });
-  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsx(ErrorBoundary, { children: /* @__PURE__ */ jsx(Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : slotContent;
+  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsx(ErrorBoundary, { children: /* @__PURE__ */ jsx(Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : /* @__PURE__ */ jsx(ErrorBoundary, { children: slotContent });
   return /* @__PURE__ */ jsx(
     Box,
     {
@@ -37957,6 +37958,15 @@ function SlotContentRenderer({
   const entityProp = content.props.entity;
   const entityType = typeof entityProp === "string" ? entityProp : "";
   const storeData = useEntityRef$1(entityType);
+  React116__default.useEffect(() => {
+    if (!entityType) return;
+    if (typeof process !== "undefined" && process.env && process.env.NODE_ENV === "production") return;
+    if (STRING_ENTITY_WARNED.has(entityType)) return;
+    STRING_ENTITY_WARNED.add(entityType);
+    console.warn(
+      `[UISlotRenderer] String-entity binding '${entityType}' is deprecated. Pass 'items' or 'entity' as a value prop resolved from @payload.data. See docs/Almadar_Entity_V2_Plan.md \xA75.`
+    );
+  }, [entityType]);
   const schemaCtx = useEntitySchemaOptional();
   const entityDef = entityType && schemaCtx ? schemaCtx.entities.get(entityType) : void 0;
   const PatternComponent = getComponentForPattern(content.pattern);
@@ -37968,18 +37978,21 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restProps } = content.props;
     const renderedProps = renderPatternProps(restProps, onDismiss);
     let finalProps;
+    const resolvedItems = Array.isArray(renderedProps.items) ? renderedProps.items : entityType ? storeData : null;
     if (entityType) {
       finalProps = { ...renderedProps, entity: storeData };
-      if (!finalProps.fields && !finalProps.columns && storeData.length > 0) {
-        const sample = storeData[0];
-        if (sample && typeof sample === "object") {
-          const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
-          finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
-        }
-      }
+    } else if (Array.isArray(renderedProps.items)) {
+      finalProps = { ...renderedProps, entity: renderedProps.items };
     } else {
       finalProps = renderedProps;
     }
+    if (resolvedItems && resolvedItems.length > 0 && !finalProps.fields && !finalProps.columns) {
+      const sample = resolvedItems[0];
+      if (sample && typeof sample === "object") {
+        const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
+        finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
+      }
+    }
     const isFormPattern = FORM_PATTERNS.has(content.pattern) || content.pattern.includes("form");
     if (isFormPattern && entityDef && Array.isArray(finalProps.fields)) {
       finalProps.fields = enrichFormFields(finalProps.fields, entityDef);
@@ -38079,7 +38092,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var TRAIT_BINDING_RE, STRING_ENTITY_WARNED, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -38096,6 +38109,7 @@ var init_UISlotRenderer = __esm({
     init_TraitFrame();
     init_component_registry_generated();
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
+    STRING_ENTITY_WARNED = /* @__PURE__ */ new Set();
     SuspenseConfigContext = createContext({ enabled: false });
     SlotContainedContext = createContext(false);
     SuspenseConfigProvider.displayName = "SuspenseConfigProvider";

package/dist/runtime/index.cjs

@@ -15939,7 +15939,8 @@ var init_Carousel = __esm({
       const scrollRef = React116.useRef(null);
       const autoPlayRef = React116.useRef(null);
       const eventBus = useSafeEventBus3();
-      const totalSlides = items.length;
+      const safeItems = items ?? [];
+      const totalSlides = safeItems.length;
       const emitSlideChange = React116.useCallback(
         (newIndex) => {
           if (slideChangeEvent) {
@@ -16050,7 +16051,7 @@ var init_Carousel = __esm({
             onPointerMove: swipeHandlers.onPointerMove,
             onPointerUp: swipeHandlers.onPointerUp,
             onPointerCancel: swipeHandlers.onPointerCancel,
-            children: items.map((item, index) => /* @__PURE__ */ jsxRuntime.jsx(
+            children: safeItems.map((item, index) => /* @__PURE__ */ jsxRuntime.jsx(
               Box,
               {
                 className: cn(
@@ -16119,7 +16120,7 @@ var init_Carousel = __esm({
           {
             position: "absolute",
             className: "bottom-3 left-0 right-0 z-10",
-            children: /* @__PURE__ */ jsxRuntime.jsx(HStack, { gap: "xs", align: "center", justify: "center", children: items.map((_, index) => {
+            children: /* @__PURE__ */ jsxRuntime.jsx(HStack, { gap: "xs", align: "center", justify: "center", children: safeItems.map((_, index) => {
               const isActive = index === activeIndex;
               return /* @__PURE__ */ jsxRuntime.jsx(
                 Box,
@@ -37333,7 +37334,7 @@ function UISlotComponent({
     );
   }
   const slotContent = /* @__PURE__ */ jsxRuntime.jsx(SlotContentRenderer, { content, onDismiss: handleDismiss });
-  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsxRuntime.jsx(ErrorBoundary, { children: /* @__PURE__ */ jsxRuntime.jsx(React116.Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : slotContent;
+  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsxRuntime.jsx(ErrorBoundary, { children: /* @__PURE__ */ jsxRuntime.jsx(React116.Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : /* @__PURE__ */ jsxRuntime.jsx(ErrorBoundary, { children: slotContent });
   return /* @__PURE__ */ jsxRuntime.jsx(
     Box,
     {
@@ -37575,6 +37576,15 @@ function SlotContentRenderer({
   const entityProp = content.props.entity;
   const entityType = typeof entityProp === "string" ? entityProp : "";
   const storeData = providers.useEntityRef(entityType);
+  React116__namespace.default.useEffect(() => {
+    if (!entityType) return;
+    if (typeof process !== "undefined" && process.env && process.env.NODE_ENV === "production") return;
+    if (STRING_ENTITY_WARNED.has(entityType)) return;
+    STRING_ENTITY_WARNED.add(entityType);
+    console.warn(
+      `[UISlotRenderer] String-entity binding '${entityType}' is deprecated. Pass 'items' or 'entity' as a value prop resolved from @payload.data. See docs/Almadar_Entity_V2_Plan.md \xA75.`
+    );
+  }, [entityType]);
   const schemaCtx = useEntitySchemaOptional();
   const entityDef = entityType && schemaCtx ? schemaCtx.entities.get(entityType) : void 0;
   const PatternComponent = getComponentForPattern(content.pattern);
@@ -37586,18 +37596,21 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restProps } = content.props;
     const renderedProps = renderPatternProps(restProps, onDismiss);
     let finalProps;
+    const resolvedItems = Array.isArray(renderedProps.items) ? renderedProps.items : entityType ? storeData : null;
     if (entityType) {
       finalProps = { ...renderedProps, entity: storeData };
-      if (!finalProps.fields && !finalProps.columns && storeData.length > 0) {
-        const sample = storeData[0];
-        if (sample && typeof sample === "object") {
-          const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
-          finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
-        }
-      }
+    } else if (Array.isArray(renderedProps.items)) {
+      finalProps = { ...renderedProps, entity: renderedProps.items };
     } else {
       finalProps = renderedProps;
     }
+    if (resolvedItems && resolvedItems.length > 0 && !finalProps.fields && !finalProps.columns) {
+      const sample = resolvedItems[0];
+      if (sample && typeof sample === "object") {
+        const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
+        finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
+      }
+    }
     const isFormPattern = FORM_PATTERNS.has(content.pattern) || content.pattern.includes("form");
     if (isFormPattern && entityDef && Array.isArray(finalProps.fields)) {
       finalProps.fields = enrichFormFields(finalProps.fields, entityDef);
@@ -37697,7 +37710,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var TRAIT_BINDING_RE, STRING_ENTITY_WARNED, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -37714,6 +37727,7 @@ var init_UISlotRenderer = __esm({
     init_TraitFrame();
     init_component_registry_generated();
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
+    STRING_ENTITY_WARNED = /* @__PURE__ */ new Set();
     SuspenseConfigContext = React116.createContext({ enabled: false });
     SlotContainedContext = React116.createContext(false);
     SuspenseConfigProvider.displayName = "SuspenseConfigProvider";

package/dist/runtime/index.js

@@ -15894,7 +15894,8 @@ var init_Carousel = __esm({
       const scrollRef = useRef(null);
       const autoPlayRef = useRef(null);
       const eventBus = useSafeEventBus3();
-      const totalSlides = items.length;
+      const safeItems = items ?? [];
+      const totalSlides = safeItems.length;
       const emitSlideChange = useCallback(
         (newIndex) => {
           if (slideChangeEvent) {
@@ -16005,7 +16006,7 @@ var init_Carousel = __esm({
             onPointerMove: swipeHandlers.onPointerMove,
             onPointerUp: swipeHandlers.onPointerUp,
             onPointerCancel: swipeHandlers.onPointerCancel,
-            children: items.map((item, index) => /* @__PURE__ */ jsx(
+            children: safeItems.map((item, index) => /* @__PURE__ */ jsx(
               Box,
               {
                 className: cn(
@@ -16074,7 +16075,7 @@ var init_Carousel = __esm({
           {
             position: "absolute",
             className: "bottom-3 left-0 right-0 z-10",
-            children: /* @__PURE__ */ jsx(HStack, { gap: "xs", align: "center", justify: "center", children: items.map((_, index) => {
+            children: /* @__PURE__ */ jsx(HStack, { gap: "xs", align: "center", justify: "center", children: safeItems.map((_, index) => {
               const isActive = index === activeIndex;
               return /* @__PURE__ */ jsx(
                 Box,
@@ -37288,7 +37289,7 @@ function UISlotComponent({
     );
   }
   const slotContent = /* @__PURE__ */ jsx(SlotContentRenderer, { content, onDismiss: handleDismiss });
-  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsx(ErrorBoundary, { children: /* @__PURE__ */ jsx(Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : slotContent;
+  const wrappedContent = suspenseConfig.enabled ? /* @__PURE__ */ jsx(ErrorBoundary, { children: /* @__PURE__ */ jsx(Suspense, { fallback: getSlotFallback(slot, suspenseConfig), children: slotContent }) }) : /* @__PURE__ */ jsx(ErrorBoundary, { children: slotContent });
   return /* @__PURE__ */ jsx(
     Box,
     {
@@ -37530,6 +37531,15 @@ function SlotContentRenderer({
   const entityProp = content.props.entity;
   const entityType = typeof entityProp === "string" ? entityProp : "";
   const storeData = useEntityRef(entityType);
+  React116__default.useEffect(() => {
+    if (!entityType) return;
+    if (typeof process !== "undefined" && process.env && process.env.NODE_ENV === "production") return;
+    if (STRING_ENTITY_WARNED.has(entityType)) return;
+    STRING_ENTITY_WARNED.add(entityType);
+    console.warn(
+      `[UISlotRenderer] String-entity binding '${entityType}' is deprecated. Pass 'items' or 'entity' as a value prop resolved from @payload.data. See docs/Almadar_Entity_V2_Plan.md \xA75.`
+    );
+  }, [entityType]);
   const schemaCtx = useEntitySchemaOptional();
   const entityDef = entityType && schemaCtx ? schemaCtx.entities.get(entityType) : void 0;
   const PatternComponent = getComponentForPattern(content.pattern);
@@ -37541,18 +37551,21 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restProps } = content.props;
     const renderedProps = renderPatternProps(restProps, onDismiss);
     let finalProps;
+    const resolvedItems = Array.isArray(renderedProps.items) ? renderedProps.items : entityType ? storeData : null;
     if (entityType) {
       finalProps = { ...renderedProps, entity: storeData };
-      if (!finalProps.fields && !finalProps.columns && storeData.length > 0) {
-        const sample = storeData[0];
-        if (sample && typeof sample === "object") {
-          const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
-          finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
-        }
-      }
+    } else if (Array.isArray(renderedProps.items)) {
+      finalProps = { ...renderedProps, entity: renderedProps.items };
     } else {
       finalProps = renderedProps;
     }
+    if (resolvedItems && resolvedItems.length > 0 && !finalProps.fields && !finalProps.columns) {
+      const sample = resolvedItems[0];
+      if (sample && typeof sample === "object") {
+        const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
+        finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
+      }
+    }
     const isFormPattern = FORM_PATTERNS.has(content.pattern) || content.pattern.includes("form");
     if (isFormPattern && entityDef && Array.isArray(finalProps.fields)) {
       finalProps.fields = enrichFormFields(finalProps.fields, entityDef);
@@ -37652,7 +37665,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var TRAIT_BINDING_RE, STRING_ENTITY_WARNED, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -37669,6 +37682,7 @@ var init_UISlotRenderer = __esm({
     init_TraitFrame();
     init_component_registry_generated();
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
+    STRING_ENTITY_WARNED = /* @__PURE__ */ new Set();
     SuspenseConfigContext = createContext({ enabled: false });
     SlotContainedContext = createContext(false);
     SuspenseConfigProvider.displayName = "SuspenseConfigProvider";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "2.60.4",
+  "version": "2.61.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",