@almadar/ui 2.60.5 → 2.61.1

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);
@@ -46684,16 +46693,19 @@ function SlotContentRenderer({
     let finalProps;
     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 {
       finalProps = renderedProps;
     }
+    const resolvedItems = Array.isArray(
+      finalProps.entity
+    ) ? finalProps.entity : null;
+    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);
@@ -46638,16 +46647,19 @@ function SlotContentRenderer({
     let finalProps;
     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 {
       finalProps = renderedProps;
     }
+    const resolvedItems = Array.isArray(
+      finalProps.entity
+    ) ? finalProps.entity : null;
+    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);
@@ -37506,16 +37515,19 @@ function SlotContentRenderer({
     let finalProps;
     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 {
       finalProps = renderedProps;
     }
+    const resolvedItems = Array.isArray(
+      finalProps.entity
+    ) ? finalProps.entity : null;
+    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);
@@ -37461,16 +37470,19 @@ function SlotContentRenderer({
     let finalProps;
     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 {
       finalProps = renderedProps;
     }
+    const resolvedItems = Array.isArray(
+      finalProps.entity
+    ) ? finalProps.entity : null;
+    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,7 +36,19 @@ 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.
+     *
+     * Accepts three shapes today; the string branch is deprecated:
+     * - `readonly T[]`: pre-resolved array for list patterns (authoring
+     *   pattern: `entity: @payload.data` from the calling trait).
+     * - `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 when the
+     *   entity store itself is deleted; the prop shape will collapse to
+     *   `readonly T[] | T | undefined`.
+     */
     entity?: string | T | readonly T[];
     /** Additional CSS classes */
     className?: string;

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);
@@ -38016,16 +38025,19 @@ function SlotContentRenderer({
     let finalProps;
     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 {
       finalProps = renderedProps;
     }
+    const resolvedItems = Array.isArray(
+      finalProps.entity
+    ) ? finalProps.entity : null;
+    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);
@@ -37971,16 +37980,19 @@ function SlotContentRenderer({
     let finalProps;
     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 {
       finalProps = renderedProps;
     }
+    const resolvedItems = Array.isArray(
+      finalProps.entity
+    ) ? finalProps.entity : null;
+    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);
@@ -37589,16 +37598,19 @@ function SlotContentRenderer({
     let finalProps;
     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 {
       finalProps = renderedProps;
     }
+    const resolvedItems = Array.isArray(
+      finalProps.entity
+    ) ? finalProps.entity : null;
+    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);
@@ -37544,16 +37553,19 @@ function SlotContentRenderer({
     let finalProps;
     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 {
       finalProps = renderedProps;
     }
+    const resolvedItems = Array.isArray(
+      finalProps.entity
+    ) ? finalProps.entity : null;
+    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.1",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",