@almadar/ui 3.9.1 → 4.0.1

package/dist/components/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 { EventKey } from '@almadar/core';
+import type { EntityRow, EventKey } from '@almadar/core';
 export interface DataGridField {
     /** Entity field name (dot-notation supported) */
     name: string;
@@ -35,9 +35,16 @@ export interface DataGridItemAction {
     /** Button variant */
     variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
 }
-export interface DataGridProps {
-    /** Entity data array */
-    entity: unknown | readonly unknown[];
+export interface DataGridProps<T extends EntityRow = EntityRow> {
+    /**
+     * 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.
+     */
+    entity: T | readonly T[];
     /** Field definitions for rendering each card */
     fields: readonly DataGridField[];
     /** Alias for fields (compiler generates `columns` for field definitions) */
@@ -68,16 +75,20 @@ export interface DataGridProps {
     loadMoreEvent?: EventKey;
     /** Whether more items are available for infinite scroll */
     hasMore?: boolean;
-    /** Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored. */
-    children?: (item: Record<string, unknown>, index: number) => React.ReactNode;
+    /** 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;
     /**
      * 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: Record<string, unknown>, index: number) => React.ReactNode;
+    renderItem?: (item: T, index: number) => React.ReactNode;
     /** Max items to show before "Show More" button. Defaults to 0 (disabled). */
     pageSize?: number;
 }
-export declare const DataGrid: React.FC<DataGridProps>;
+export declare function DataGrid<T extends EntityRow = EntityRow>({ entity, fields: fieldsProp, columns: columnsProp, itemActions, cols, gap, minCardWidth, className, isLoading, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, }: DataGridProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare namespace DataGrid {
+    var displayName: string;
+}

package/dist/components/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 { EventKey } from "@almadar/core";
+import type { EntityRow, EventKey } from "@almadar/core";
 export interface DataListField {
     /** Entity field name (dot-notation supported) */
     name: string;
@@ -35,9 +35,16 @@ export interface DataListItemAction {
     /** Button variant */
     variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
 }
-export interface DataListProps {
-    /** Entity data array */
-    entity: unknown | readonly unknown[];
+export interface DataListProps<T extends EntityRow = EntityRow> {
+    /**
+     * 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.
+     */
+    entity: T | readonly T[];
     /** Field definitions for rendering each row */
     fields: readonly DataListField[];
     /** Alias for fields (compiler may generate `columns` for field definitions) */
@@ -89,15 +96,23 @@ export interface DataListProps {
     /** Whether more items are available for infinite scroll */
     hasMore?: boolean;
     /** Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored. */
-    children?: (item: Record<string, unknown>, index: number) => React.ReactNode;
+    /**
+     * 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.
+     */
+    children?: (item: T, 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: Record<string, unknown>, index: number) => React.ReactNode;
+    renderItem?: (item: T, index: number) => React.ReactNode;
     /** Max items to show before "Show More" button. Defaults to 5. Set to 0 to disable. */
     pageSize?: number;
 }
-export declare const DataList: React.FC<DataListProps>;
+export declare function DataList<T extends EntityRow = EntityRow>({ entity, fields: fieldsProp, columns: columnsProp, itemActions, 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, }: DataListProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare namespace DataList {
+    var displayName: string;
+}

package/dist/components/molecules/WizardProgress.d.ts

@@ -20,8 +20,8 @@ export interface WizardProgressStep {
     description?: string;
 }
 export interface WizardProgressProps {
-    /** Step definitions (compatible with WizardContainer's WizardStep) */
-    steps: WizardProgressStep[];
+    /** Step definitions (compatible with WizardContainer's WizardStep). A string is shorthand for `{ id: str, title: str }`. */
+    steps: (WizardProgressStep | string)[];
     /** Current step index (0-based) */
     currentStep: number;
     /** Callback when a completed step is clicked */

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

@@ -68,8 +68,6 @@ export interface DetailPanelProps extends EntityDisplayProps {
     position?: "left" | "right";
     /** Panel width (CSS value, e.g., '400px', '50%') */
     width?: string;
-    /** Entity ID for fetching specific entity */
-    entityId?: string;
     /** Display fields (alias for fields) */
     displayFields?: readonly string[];
     /** Show actions flag */

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

@@ -177,8 +177,6 @@ export interface FormProps extends Omit<React.FormHTMLAttributes<HTMLFormElement
     submitEvent?: EventKey;
     /** Event to dispatch on cancel (defaults to 'CANCEL') */
     cancelEvent?: EventKey;
-    /** Entity ID binding for edit mode (triggers initialData from selectedEntity in compiled code) */
-    entityId?: string;
     /** Data for relation fields: { fieldName: RelationOption[] } */
     relationsData?: Record<string, readonly RelationOption[]>;
     /** Loading state for relation data: { fieldName: boolean } */

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

@@ -15,8 +15,6 @@ export interface FormSectionProps extends EntityDisplayProps {
     card?: boolean;
     /** Grid columns for fields */
     columns?: 1 | 2 | 3;
-    /** Entity ID for fetching specific entity */
-    entityId?: string;
 }
 export declare const FormSection: React.FC<FormSectionProps>;
 /**