@almadar/ui 2.60.5 → 2.61.0

package/dist/avl/index.cjs

@@ -46671,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);
@@ -46682,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);
@@ -46793,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";
@@ -46812,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

@@ -46625,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);
@@ -46636,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);
@@ -46747,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";
@@ -46766,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

@@ -37493,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);
@@ -37504,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);
@@ -37615,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";
@@ -37632,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

@@ -37448,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);
@@ -37459,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);
@@ -37570,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";
@@ -37587,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

@@ -38003,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);
@@ -38014,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);
@@ -38125,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";
@@ -38142,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

@@ -37958,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);
@@ -37969,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);
@@ -38080,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";
@@ -38097,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

@@ -37576,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);
@@ -37587,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);
@@ -37698,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";
@@ -37715,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

@@ -37531,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);
@@ -37542,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);
@@ -37653,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";
@@ -37670,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.5",
+  "version": "2.61.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",