@almadar/ui 5.21.12 → 5.22.2

package/dist/components/core/molecules/CalendarGrid.d.ts

@@ -6,14 +6,7 @@
  * Composes DayCell and TimeSlotCell atoms into a 7-day grid.
  */
 import React from "react";
-import type { EventEmit, EventPayload, EntityCollection } from "@almadar/core";
-export type CalendarEvent = {
-    id: string;
-    title: string;
-    startTime: string | Date;
-    endTime?: string | Date;
-    color?: string;
-};
+import type { EventEmit, EventPayload, EntityRow, EntityWith } from "@almadar/core";
 /**
  * Number of day columns rendered at once. Matches the responsiveness-
  * audit tiers exactly: 1 day on mobile (≤640), 3 on tablet (641–1024),
@@ -26,13 +19,13 @@ export interface CalendarGridProps {
     /** Time slot labels (defaults to 09:00-17:00) */
     timeSlots?: string[];
     /** Events to display on the grid */
-    events?: EntityCollection<CalendarEvent>;
+    events?: readonly EntityWith<'id' | 'title' | 'startTime'>[];
     /** Called when a time slot is clicked */
     onSlotClick?: (day: Date, time: string) => void;
     /** Called when a day header is clicked */
     onDayClick?: (day: Date) => void;
     /** Called when an event is clicked */
-    onEventClick?: (event: CalendarEvent) => void;
+    onEventClick?: (event: EntityRow) => void;
     /** Additional CSS classes */
     className?: string;
     /** Event emitted on long-press of a time slot: UI:{longPressEvent} with { date, time, ...longPressPayload } */

package/dist/components/core/molecules/ContentRenderer.d.ts

@@ -11,8 +11,8 @@
  */
 import React from 'react';
 import { type ContentSegment } from '../../../lib/parseContentSegments';
-import type { EntityDisplayProps } from '../organisms/types';
-export interface ContentRendererProps extends EntityDisplayProps {
+import type { DisplayStateProps } from '../organisms/types';
+export interface ContentRendererProps extends DisplayStateProps {
     /** Raw content string — auto-parsed into segments */
     content?: string;
     /** Pre-parsed segments (overrides content) */

package/dist/components/core/molecules/DataGrid.d.ts

@@ -11,7 +11,7 @@
  * Uses atoms only internally: Box, VStack, HStack, Typography, Badge, Button, Icon.
  */
 import React from 'react';
-import type { EntityRow, EventKey, EntityCollection } from '@almadar/core';
+import type { EntityRow, EventKey } from '@almadar/core';
 import { type DataDndProps } from './useDataDnd';
 import type { UiError } from '../atoms/types';
 export interface DataGridField {
@@ -47,22 +47,13 @@ export interface DataGridItemAction {
     /** Button variant */
     variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
 }
-export interface DataGridProps<T extends EntityRow = EntityRow> extends DataDndProps {
+export interface DataGridProps extends DataDndProps {
     /**
-     * Schema entity data — single record or collection, typed against
-     * `@almadar/core`'s `EntityRow` so the narrow type declared on the
-     * emitting trait's `Event { data : [X] }` flows through to the prop
-     * without widening. The generic `T` lets consumers pass a narrower
-     * entity (e.g. `CartItem`) and have the `children` render function
-     * receive cards typed to that exact shape.
-     *
-     * Declared as the pattern's data INLET via `EntityCollection<T>` (the inlet
-     * half of the circuit, symmetric with the `EventKey` outlet props below):
-     * pattern-sync tags it `kind:"entity", cardinality:"collection"` so consumers
-     * bind the domain entity without name-matching the prop. Structurally still
-     * `T | readonly T[]` — see the brand's doc.
+     * Schema entity data — the collection of rows to render. pattern-sync tags
+     * it `kind:"entity", cardinality:"collection"` so consumers bind the domain
+     * entity without name-matching the prop.
      */
-    entity: EntityCollection<T>;
+    entity: readonly EntityRow[];
     /**
      * Field definitions for rendering each card. The pattern contract in
      * `@almadar/patterns` documents `columns` as the wire-format alias the
@@ -101,16 +92,16 @@ export interface DataGridProps<T extends EntityRow = EntityRow> extends DataDndP
     loadMoreEvent?: EventKey;
     /** Whether more items are available for infinite scroll */
     hasMore?: boolean;
-    /** Render prop for custom per-card content, typed to the grid's entity
-     *  shape `T`. When provided, `fields` and `itemActions` are ignored. */
-    children?: (item: T, index: number) => React.ReactNode;
+    /** Render prop for custom per-card content. When provided, `fields` and
+     *  `itemActions` are ignored. */
+    children?: (item: EntityRow, index: number) => React.ReactNode;
     /**
      * Per-item render function (schema-level alias for children render prop).
      * In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }]
      * The compiler converts this to the children render prop.
      * @deprecated Use children render prop in React code. This prop exists for pattern registry sync.
      */
-    renderItem?: (item: T, index: number) => React.ReactNode;
+    renderItem?: (item: EntityRow, index: number) => React.ReactNode;
     /** Max items to show before "Show More" button. Defaults to 0 (disabled). */
     pageSize?: number;
     /**
@@ -119,7 +110,7 @@ export interface DataGridProps<T extends EntityRow = EntityRow> extends DataDndP
      */
     look?: "dense" | "spacious" | "striped" | "borderless" | "card-rows";
 }
-export declare function DataGrid<T extends EntityRow = EntityRow>({ entity, fields, columns, itemActions, maxInlineActions, scrollX, cols, gap, minCardWidth, className, isLoading, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, look, }: DataGridProps<T>): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
+export declare function DataGrid({ entity, fields, columns, itemActions, maxInlineActions, scrollX, cols, gap, minCardWidth, className, isLoading, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, look, }: DataGridProps): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
 export declare namespace DataGrid {
     var displayName: string;
 }

package/dist/components/core/molecules/DataList.d.ts

@@ -11,7 +11,7 @@
  * Uses atoms only internally: Box, VStack, HStack, Typography, Badge, Button, Icon.
  */
 import React from 'react';
-import type { EntityRow, EntityCollection, EventKey } from "@almadar/core";
+import type { EntityRow, EventKey } from "@almadar/core";
 import { type DataDndProps } from './useDataDnd';
 import type { UiError } from '../atoms/types';
 export interface DataListField {
@@ -45,16 +45,11 @@ export interface DataListSwipeAction {
     /** Button variant */
     variant?: 'primary' | 'secondary' | 'danger' | 'ghost';
 }
-export interface DataListProps<T extends EntityRow = EntityRow> extends DataDndProps {
+export interface DataListProps extends DataDndProps {
     /**
-     * Schema entity data — single record or collection, typed against
-     * `@almadar/core`'s `EntityRow` so the narrow type declared on the
-     * emitting trait's `Event { data : [X] }` flows through to the prop
-     * without widening. The generic `T` lets consumers pass a narrower
-     * entity (e.g. `CartItem`) and have the `children` render function
-     * receive items of that exact shape.
+     * Schema entity data — the collection of rows to render.
      */
-    entity: EntityCollection<T>;
+    entity: readonly EntityRow[];
     /**
      * Field definitions for rendering each row. The pattern contract in
      * `@almadar/patterns` documents `columns` as the wire-format alias the
@@ -108,18 +103,17 @@ export interface DataListProps<T extends EntityRow = EntityRow> extends DataDndP
     hasMore?: boolean;
     /** Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored. */
     /**
-     * Render function for each row's content. Receives an item of the
-     * component's entity type `T` (narrowed via the generic parameter)
-     * and the row's index in the materialised array.
+     * Render function for each row's content. Receives a row and the row's
+     * index in the materialised array.
      */
-    children?: (item: T, index: number) => React.ReactNode;
+    children?: (item: EntityRow, index: number) => React.ReactNode;
     /**
      * Per-item render function (schema-level alias for children render prop).
      * In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }]
      * The compiler converts this to the children render prop.
      * @deprecated Use children render prop in React code. This prop exists for pattern registry sync.
      */
-    renderItem?: (item: T, index: number) => React.ReactNode;
+    renderItem?: (item: EntityRow, index: number) => React.ReactNode;
     /** Max items to show before "Show More" button. Defaults to 5. Set to 0 to disable. */
     pageSize?: number;
     /**
@@ -128,7 +122,7 @@ export interface DataListProps<T extends EntityRow = EntityRow> extends DataDndP
      */
     look?: "dense" | "spacious" | "striped" | "borderless" | "card-rows";
 }
-export declare function DataList<T extends EntityRow = EntityRow>({ entity, fields, columns, itemActions, maxInlineActions, itemClickEvent, gap, variant, groupBy, senderField, currentUser, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, look, }: DataListProps<T>): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
+export declare function DataList({ entity, fields, columns, itemActions, maxInlineActions, itemClickEvent, gap, variant, groupBy, senderField, currentUser, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, look, }: DataListProps): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
 export declare namespace DataList {
     var displayName: string;
 }

package/dist/components/core/molecules/FormSection.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
-import type { EntityDisplayProps } from "../organisms/types";
-export interface FormSectionProps extends EntityDisplayProps {
+import type { DisplayStateProps } from "../organisms/types";
+export interface FormSectionProps extends DisplayStateProps {
     /** Section title */
     title?: string;
     /** Section description */
@@ -20,7 +20,7 @@ export declare const FormSection: React.FC<FormSectionProps>;
 /**
  * Form layout with multiple sections
  */
-export interface FormLayoutProps extends EntityDisplayProps {
+export interface FormLayoutProps extends DisplayStateProps {
     children: React.ReactNode;
     /** Show section dividers */
     dividers?: boolean;
@@ -29,7 +29,7 @@ export declare const FormLayout: React.FC<FormLayoutProps>;
 /**
  * Form actions bar (submit/cancel buttons)
  */
-export interface FormActionsProps extends EntityDisplayProps {
+export interface FormActionsProps extends DisplayStateProps {
     children: React.ReactNode;
     /** Sticky at bottom */
     sticky?: boolean;

package/dist/components/core/molecules/PositionedCanvas.d.ts

@@ -1,26 +1,13 @@
 import React from "react";
-import type { EventEmit, EntityCollection } from "@almadar/core";
+import type { EventEmit, EntityWith } from "@almadar/core";
 export type CanvasItemStatus = 'empty' | 'seated' | 'ordered' | 'awaiting-bill' | 'cleaning';
 export type CanvasItemShape = 'round' | 'rectangle' | 'square';
-export interface CanvasItem {
-    id: string;
-    label: string;
-    x: number;
-    y: number;
-    shape?: CanvasItemShape;
-    capacity: number;
-    status?: CanvasItemStatus;
-    partySize?: number;
-    serverName?: string;
-}
 export interface PositionedCanvasProps {
     /**
-     * Items to render. Accepts either a typed array (direct consumers) or the
-     * runtime payload shape from a render-ui binding (`@payload.data`). The
-     * molecule narrows non-array values to `[]` and validates element shape at
-     * render time via the `id` / `x` / `y` guards.
+     * Items to render. The molecule narrows non-array values to `[]` and reads
+     * each row's `id` / `x` / `y` / `label` fields at render time.
      */
-    items: EntityCollection<CanvasItem>;
+    items: readonly EntityWith<'id' | 'label' | 'x' | 'y'>[];
     width?: number;
     height?: number;
     selectedId?: string | null;

package/dist/components/core/molecules/ReplyTree.d.ts

@@ -5,21 +5,10 @@
  * Composes the VoteStack molecule + Avatar/Typography/Button atoms.
  */
 import React from "react";
-import type { EventEmit, EntityCollection } from "@almadar/core";
+import type { EventEmit, EntityWith } from "@almadar/core";
 import { type VoteValue } from "./VoteStack";
-export interface ReplyNode {
-    id: string;
-    authorName: string;
-    authorAvatarUrl?: string;
-    content: string;
-    postedAt: string;
-    voteCount?: number;
-    userVote?: VoteValue;
-    replies?: ReplyNode[];
-    collapsed?: boolean;
-}
 export interface ReplyTreeProps {
-    nodes: EntityCollection<ReplyNode>;
+    nodes: readonly EntityWith<'id' | 'authorName' | 'content'>[];
     maxDepth?: number;
     onVote?: (nodeId: string, vote: VoteValue) => void;
     onReply?: (parentNodeId: string) => void;

package/dist/components/core/molecules/RichBlockEditor.d.ts

@@ -20,13 +20,10 @@ export interface RichBlock {
 }
 export interface RichBlockEditorProps {
     /**
-     * Initial block payload. Accepts strongly-typed RichBlock[] from native
-     * callers and the wider EntityRow[] shape that orb-bound traits emit
-     * (orb `[object]` lowers to `Record<string, FieldValue | undefined>[]`,
-     * which is structurally EntityRow[]). Items missing id/type are normalized
-     * into paragraph blocks at mount.
+     * Initial block payload — the rows that orb-bound traits emit. Items missing
+     * id/type are normalized into paragraph blocks at mount.
      */
-    initialBlocks?: readonly RichBlock[] | readonly EntityRow[];
+    initialBlocks?: readonly EntityRow[];
     onChange?: (blocks: RichBlock[]) => void;
     changeEvent?: EventEmit<{
         blocks: RichBlock[];

package/dist/components/core/molecules/SortableList.d.ts

@@ -6,13 +6,15 @@
  * Shows a drop indicator line at the target position during drag.
  */
 import React from 'react';
-import type { EntityCollection, EventKey, EventPayload, EventPayloadValue } from "@almadar/core";
-export interface SortableListProps<T extends EventPayloadValue = EventPayload> {
-    items: EntityCollection<T>;
-    renderItem: (item: T, index: number) => React.ReactNode;
+import type { EntityRow, EventKey, EventPayload } from "@almadar/core";
+export interface SortableListProps {
+    items: readonly EntityRow[];
+    renderItem: (item: EntityRow, index: number) => React.ReactNode;
     reorderEvent: EventKey;
     reorderPayload?: EventPayload;
     dragHandlePosition?: 'left' | 'right';
     className?: string;
 }
-export declare const SortableList: <T extends EventPayloadValue = EventPayload>(props: SortableListProps<T>) => React.ReactElement;
+declare function SortableListInner({ items: initialItemsProp, renderItem, reorderEvent, reorderPayload, dragHandlePosition, className, }: SortableListProps): import("react/jsx-runtime").JSX.Element;
+export declare const SortableList: typeof SortableListInner;
+export {};

package/dist/components/core/molecules/TableView.d.ts

@@ -12,7 +12,7 @@
  * Icon, Checkbox, Divider.
  */
 import React from 'react';
-import type { EntityRow, EventKey, EntityCollection } from '@almadar/core';
+import type { EntityRow, EventKey } from '@almadar/core';
 import { type DataDndProps } from './useDataDnd';
 import type { UiError } from '../atoms/types';
 export interface TableViewColumn {
@@ -51,9 +51,9 @@ export interface TableViewItemAction {
     /** Button variant. */
     variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
 }
-export interface TableViewProps<T extends EntityRow = EntityRow> extends DataDndProps {
-    /** Schema entity data — single record or collection. */
-    entity: EntityCollection<T>;
+export interface TableViewProps extends DataDndProps {
+    /** Schema entity data — the collection of rows to render. */
+    entity: readonly EntityRow[];
     /** Column definitions. The compiler emits `columns`; `fields` is the alias. */
     columns?: readonly TableViewColumn[];
     /** Alias for `columns`. */
@@ -91,20 +91,20 @@ export interface TableViewProps<T extends EntityRow = EntityRow> extends DataDnd
      * to this function (columns are ignored for the body; the header still
      * renders). Mirrors DataList's children render prop.
      */
-    children?: (item: T, index: number) => React.ReactNode;
+    children?: (item: EntityRow, index: number) => React.ReactNode;
     /**
      * Per-row render function (schema alias). In .orb: ["fn","item",{...}].
      * The compiler converts this to the children render prop.
      * @deprecated Use children in React code; exists for pattern registry sync.
      */
-    renderItem?: (item: T, index: number) => React.ReactNode;
+    renderItem?: (item: EntityRow, index: number) => React.ReactNode;
     /**
      * Layer 2 visual treatment — mirrors the data-list / entity-table look enum
      * so authors share one knob name across row renderers.
      */
     look?: 'dense' | 'spacious' | 'striped' | 'borderless' | 'bordered';
 }
-export declare function TableView<T extends EntityRow = EntityRow>({ entity, columns, fields, itemActions, maxInlineActions, selectable, selectEvent, selectedIds, sortEvent, sortColumn, sortDirection, className, emptyMessage, isLoading, error, groupBy, pageSize, children, renderItem: _schemaRenderItem, look, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, }: TableViewProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function TableView({ entity, columns, fields, itemActions, maxInlineActions, selectable, selectEvent, selectedIds, sortEvent, sortColumn, sortDirection, className, emptyMessage, isLoading, error, groupBy, pageSize, children, renderItem: _schemaRenderItem, look, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, }: TableViewProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace TableView {
     var displayName: string;
 }

package/dist/components/core/molecules/index.d.ts

@@ -36,7 +36,7 @@ export { MarkdownContent, type MarkdownContentProps } from './markdown/MarkdownC
 export { CodeBlock, type CodeBlockProps } from './markdown/CodeBlock';
 export { QuizBlock, type QuizBlockProps } from './QuizBlock';
 export { ScaledDiagram, type ScaledDiagramProps } from './ScaledDiagram';
-export { CalendarGrid, type CalendarGridProps, type CalendarEvent } from './CalendarGrid';
+export { CalendarGrid, type CalendarGridProps } from './CalendarGrid';
 export { RepeatableFormSection, type RepeatableFormSectionProps, type RepeatableItem } from './RepeatableFormSection';
 export { ViolationAlert, type ViolationAlertProps, type ViolationRecord } from './ViolationAlert';
 export { FormSectionHeader, type FormSectionHeaderProps } from './FormSectionHeader';
@@ -88,9 +88,9 @@ export { LikertScale, type LikertScaleProps, type LikertOption, DEFAULT_LIKERT_O
 export { MatrixQuestion, type MatrixQuestionProps, type MatrixRow, type MatrixColumn, DEFAULT_MATRIX_COLUMNS } from './MatrixQuestion';
 export { QrScanner, type QrScannerProps, type QrScanResult } from './QrScanner';
 export { OptionConstraintGroup, type OptionConstraintGroupProps, type OptionConstraintOption, type OptionConstraint } from './OptionConstraintGroup';
-export { PositionedCanvas, type PositionedCanvasProps, type CanvasItem, type CanvasItemStatus, type CanvasItemShape } from './PositionedCanvas';
+export { PositionedCanvas, type PositionedCanvasProps, type CanvasItemStatus, type CanvasItemShape } from './PositionedCanvas';
 export { RichBlockEditor, type RichBlockEditorProps, type RichBlock, type BlockType } from './RichBlockEditor';
-export { ReplyTree, type ReplyTreeProps, type ReplyNode } from './ReplyTree';
+export { ReplyTree, type ReplyTreeProps } from './ReplyTree';
 export { BranchingLogicBuilder, type BranchingLogicBuilderProps, type BranchingQuestion, type BranchingRule } from './BranchingLogicBuilder';
 export { VersionDiff, type VersionDiffProps, type DiffRevision, type DiffLine as VersionDiffLine, type DiffLineType } from './VersionDiff';
 export { DocBreadcrumb, type DocBreadcrumbProps, type DocBreadcrumbItem } from './DocBreadcrumb';

package/dist/components/core/molecules/useDataDnd.d.ts

@@ -44,11 +44,11 @@ export interface DataDndProps {
      */
     dndRoot?: boolean;
 }
-interface UseDataDndArgs<T extends EntityRow> extends DataDndProps {
-    items: readonly T[];
+interface UseDataDndArgs extends DataDndProps {
+    items: readonly EntityRow[];
     layout: 'list' | 'grid';
 }
-interface UseDataDndResult<T extends EntityRow> {
+interface UseDataDndResult {
     enabled: boolean;
     /** True when this container is a sortable zone (own items are draggable). False in dndRoot-only mode. */
     isZone: boolean;
@@ -57,7 +57,7 @@ interface UseDataDndResult<T extends EntityRow> {
         id: UniqueIdentifier;
         children: React.ReactNode;
     }>;
-    orderedItems: readonly T[];
+    orderedItems: readonly EntityRow[];
 }
-export declare function useDataDnd<T extends EntityRow>(args: UseDataDndArgs<T>): UseDataDndResult<T>;
+export declare function useDataDnd(args: UseDataDndArgs): UseDataDndResult;
 export {};

package/dist/components/core/organisms/CardGrid.d.ts

@@ -10,7 +10,8 @@
  */
 import React from 'react';
 import type { EventKey } from "@almadar/core";
-import type { EntityDisplayProps } from './types';
+import type { DisplayStateProps } from './types';
+import type { EntityRow } from '@almadar/core';
 export type CardGridGap = 'none' | 'sm' | 'md' | 'lg' | 'xl';
 /**
  * Action configuration for card items (schema-driven)
@@ -40,7 +41,9 @@ export type FieldDef = string | {
     name?: string;
     label?: string;
 };
-export interface CardGridProps extends EntityDisplayProps {
+export interface CardGridProps extends DisplayStateProps {
+    /** Entity data (single record or collection). */
+    entity?: EntityRow | readonly EntityRow[];
     /** Minimum width of each card (default: 280px) */
     minCardWidth?: number;
     /** Maximum number of columns */

package/dist/components/core/organisms/CaseStudyOrganism.d.ts

@@ -10,9 +10,10 @@
  * - Never listens to events
  */
 import React from 'react';
-import type { EntityDisplayProps } from './types';
-import type { CaseStudyEntity } from './marketing-types';
-export interface CaseStudyOrganismProps extends EntityDisplayProps<CaseStudyEntity> {
+import type { EntityWith } from '@almadar/core';
+import type { DisplayStateProps } from './types';
+export interface CaseStudyOrganismProps extends DisplayStateProps {
+    entity?: EntityWith<'title'> | readonly EntityWith<'title'>[];
     heading?: string;
     subtitle?: string;
 }

package/dist/components/core/organisms/DataTable.d.ts

@@ -1,7 +1,7 @@
 import React from "react";
 import type { EventKey } from "@almadar/core";
 import { LucideIcon } from "lucide-react";
-import { EntityDisplayProps } from "./types";
+import { DisplayStateProps } from "./types";
 import type { EntityRow } from "@almadar/core";
 export type EntityTableLook = "dense" | "spacious" | "striped" | "borderless" | "card-rows";
 export interface Column<T> {
@@ -29,7 +29,9 @@ export interface DataTableEmptyAction {
 }
 export interface DataTableProps<T extends EntityRow & {
     id: string | number;
-}> extends EntityDisplayProps<T> {
+}> extends DisplayStateProps {
+    /** Entity rows to display (collection cardinality). */
+    entity?: readonly EntityRow[];
     /** Fields to display - accepts string[] or Column[] for unified interface. Alias for columns */
     fields: readonly Column<T>[] | readonly string[];
     /** Columns can be Column objects or simple string field names */

package/dist/components/core/organisms/DetailPanel.d.ts

@@ -4,12 +4,12 @@
  * Composes atoms and molecules to create a professional detail view.
  *
  * Data is provided by the runtime via the `entity` prop.
- * See EntityDisplayProps in ./types.ts for base prop contract.
+ * Extends DisplayStateProps (see ./types.ts) and declares `entity?: EntityRow`.
  */
 import React from "react";
-import type { EntityRecord, EntityRow } from "@almadar/core";
+import type { EntityRow } from "@almadar/core";
 import type { LucideIcon } from "lucide-react";
-import type { EntityDisplayProps } from "./types";
+import type { DisplayStateProps } from "./types";
 export interface DetailField {
     label: string;
     value: React.ReactNode;
@@ -48,9 +48,9 @@ export interface DetailPanelStatus {
     label: string;
     variant?: "default" | "success" | "warning" | "danger" | "info";
 }
-export interface DetailPanelProps extends EntityDisplayProps {
-    /** RECORD-cardinality override: renders ONE record (see body collapse below). */
-    entity?: EntityRecord<EntityRow>;
+export interface DetailPanelProps extends DisplayStateProps {
+    /** RECORD-cardinality: renders ONE record (see body collapse below). */
+    entity?: EntityRow;
     title?: string;
     subtitle?: string;
     status?: DetailPanelStatus;

package/dist/components/core/organisms/FeatureGridOrganism.d.ts

@@ -10,9 +10,10 @@
  * - Never listens to events
  */
 import React from 'react';
-import type { EntityDisplayProps } from './types';
-import type { FeatureEntity } from './marketing-types';
-export interface FeatureGridOrganismProps extends EntityDisplayProps<FeatureEntity> {
+import type { EntityWith } from '@almadar/core';
+import type { DisplayStateProps } from './types';
+export interface FeatureGridOrganismProps extends DisplayStateProps {
+    entity?: EntityWith<'title'> | readonly EntityWith<'title'>[];
     columns?: 2 | 3 | 4 | 6;
     heading?: string;
     subtitle?: string;

package/dist/components/core/organisms/HeroOrganism.d.ts

@@ -10,11 +10,10 @@
  * - Never listens to events
  */
 import React from 'react';
-import type { EntityRecord } from '@almadar/core';
-import type { EntityDisplayProps } from './types';
-import type { HeroEntity } from './marketing-types';
-export interface HeroOrganismProps extends EntityDisplayProps<HeroEntity> {
-    entity?: EntityRecord<HeroEntity>;
+import type { EntityWith } from '@almadar/core';
+import type { DisplayStateProps } from './types';
+export interface HeroOrganismProps extends DisplayStateProps {
+    entity?: EntityWith<'title'>;
     children?: React.ReactNode;
 }
 export declare const HeroOrganism: React.FC<HeroOrganismProps>;

package/dist/components/core/organisms/List.d.ts

@@ -20,7 +20,8 @@ import React from "react";
 import type { EventKey } from "@almadar/core";
 import type { LucideIcon } from "lucide-react";
 import { type MenuItem } from "../molecules/Menu";
-import type { EntityDisplayProps } from "./types";
+import type { DisplayStateProps } from "./types";
+import type { EntityRow } from "@almadar/core";
 export type ListItem = {
     id: string;
     title?: string;
@@ -61,7 +62,9 @@ export type FieldDef = string | {
     name?: string;
     label?: string;
 };
-export interface ListProps extends EntityDisplayProps {
+export interface ListProps extends DisplayStateProps {
+    /** Entity data (single record or collection). */
+    entity?: EntityRow | readonly EntityRow[];
     /** Entity type name for display */
     entityType?: string;
     selectable?: boolean;

package/dist/components/core/organisms/MasterDetail.d.ts

@@ -9,13 +9,15 @@
  * to a sidebar or detail panel when an item is selected.
  */
 import React from 'react';
-import type { EntityDisplayProps } from './types';
+import type { DisplayStateProps } from './types';
 import type { EntityRow } from '@almadar/core';
 export interface MasterDetailProps<T extends EntityRow & {
     id: string | number;
 } = EntityRow & {
     id: string | number;
-}> extends EntityDisplayProps<T> {
+}> extends DisplayStateProps {
+    /** Entity rows to display in the master list (collection cardinality). */
+    entity?: readonly EntityRow[];
     /** Fields to show in the master list (maps to DataTable columns) */
     masterFields: readonly string[];
     /** Fields for detail view (passed through but typically handled by separate render_ui) */

package/dist/components/core/organisms/MediaGallery.d.ts

@@ -12,7 +12,7 @@
  */
 import React from "react";
 import type { EventEmit } from "@almadar/core";
-import type { EntityDisplayProps } from "./types";
+import type { DisplayStateProps } from "./types";
 import type { EntityRow } from "@almadar/core";
 export type MediaItem = EntityRow & {
     /** Unique identifier */
@@ -36,7 +36,9 @@ export interface MediaGalleryAction {
     navigatesTo?: string;
     variant?: "primary" | "secondary" | "ghost";
 }
-export interface MediaGalleryProps extends EntityDisplayProps<EntityRow> {
+export interface MediaGalleryProps extends DisplayStateProps {
+    /** Entity rows to display (collection cardinality). */
+    entity?: readonly EntityRow[];
     /** Gallery title */
     title?: string;
     /** Media items */

package/dist/components/core/organisms/ShowcaseOrganism.d.ts

@@ -10,9 +10,10 @@
  * - Never listens to events
  */
 import React from 'react';
-import type { EntityDisplayProps } from './types';
-import type { ShowcaseEntity } from './marketing-types';
-export interface ShowcaseOrganismProps extends EntityDisplayProps<ShowcaseEntity> {
+import type { EntityWith } from '@almadar/core';
+import type { DisplayStateProps } from './types';
+export interface ShowcaseOrganismProps extends DisplayStateProps {
+    entity?: EntityWith<'title'> | readonly EntityWith<'title'>[];
     columns?: 2 | 3 | 4;
     heading?: string;
     subtitle?: string;

package/dist/components/core/organisms/StatCard.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 import { LucideIcon } from "lucide-react";
-import type { EntityDisplayProps } from "./types";
+import type { DisplayStateProps } from "./types";
+import type { EntityRow } from "@almadar/core";
 /**
  * Schema metric definition
  * Supports both computed metrics (with field) and static metrics (with value)
@@ -17,7 +18,9 @@ export interface MetricDefinition {
     /** Value format (e.g., 'currency', 'percent', 'number') */
     format?: "currency" | "percent" | "number" | string;
 }
-export interface StatCardProps extends EntityDisplayProps {
+export interface StatCardProps extends DisplayStateProps {
+    /** Entity data (single record or collection) used to compute metrics. */
+    entity?: EntityRow | readonly EntityRow[];
     /** Main label */
     label?: string;
     /** Title (alias for label) */

package/dist/components/core/organisms/StepFlowOrganism.d.ts

@@ -9,9 +9,10 @@
  * - No events (display-only)
  */
 import React from 'react';
-import type { EntityDisplayProps } from './types';
-import type { StepEntity } from './marketing-types';
-export interface StepFlowOrganismProps extends EntityDisplayProps<StepEntity> {
+import type { EntityWith } from '@almadar/core';
+import type { DisplayStateProps } from './types';
+export interface StepFlowOrganismProps extends DisplayStateProps {
+    entity?: EntityWith<'title'> | readonly EntityWith<'title'>[];
     orientation?: 'horizontal' | 'vertical';
     showConnectors?: boolean;
     heading?: string;