@almadar/ui 5.69.0 → 5.71.0

package/dist/components/avl/molecules/AvlEventWireEdge.d.ts

@@ -6,7 +6,8 @@
  */
 import React from 'react';
 import { type Edge, type EdgeProps } from '@xyflow/react';
-export interface AvlEventWireEdgeData extends Record<string, unknown> {
+export interface AvlEventWireEdgeData {
+    [key: string]: string | boolean | undefined;
     event: string;
     compatible?: boolean;
 }

package/dist/components/avl/molecules/AvlTransitionEdge.d.ts

@@ -7,7 +7,8 @@
  */
 import React from 'react';
 import { type Edge, type EdgeProps } from '@xyflow/react';
-export interface AvlTransitionEdgeData extends Record<string, unknown> {
+export interface AvlTransitionEdgeData {
+    [key: string]: string | boolean | undefined;
     event: string;
     hasGuard?: boolean;
     hasEffects?: boolean;

package/dist/components/avl/molecules/avl-behavior-compose-converter.d.ts

@@ -39,11 +39,13 @@ export interface BehaviorRegistryRecord {
         }>;
     };
     connectableEvents: string[];
-    eventPayloads: Record<string, Array<{
-        name: string;
-        type: string;
-        required?: boolean;
-    }>>;
+    eventPayloads: {
+        [k: string]: Array<{
+            name: string;
+            type: string;
+            required?: boolean;
+        }>;
+    };
     composableWith: string[];
 }
 /**

package/dist/components/avl/molecules/avl-behavior-compose-types.d.ts

@@ -11,53 +11,73 @@
  *   Overview: One node per orbital showing live UI (OrbPreviewNode)
  *   Expanded: One node per UI state within an orbital (OrbPreviewNode)
  */
-import type { EntityPersistence, EventPayloadField } from '@almadar/core';
-import type { BehaviorLevel, BehaviorGlyphChild, BehaviorGlyphConnection } from './AvlBehaviorGlyph';
-import type { AvlEffectType } from '../atoms/types';
+import type { JsonObject } from '@almadar/core';
+import type { BehaviorLevel } from './AvlBehaviorGlyph';
+/** Serializable payload field — mirrors EventPayloadField from @almadar/core. */
+export interface SerializedPayloadField extends JsonObject {
+    name: string;
+    type: string;
+    required: boolean | null;
+    description: string | null;
+}
+/** Serializable behavior glyph child — mirrors BehaviorGlyphChild from AvlBehaviorGlyph. */
+export interface SerializedGlyphChild extends JsonObject {
+    name: string;
+    fieldCount: number | null;
+    stateCount: number | null;
+    persistence: string | null;
+    effectTypes: string[];
+}
+/** Serializable behavior glyph connection — mirrors BehaviorGlyphConnection from AvlBehaviorGlyph. */
+export interface SerializedGlyphConnection extends JsonObject {
+    from: string;
+    to: string;
+    event: string;
+}
 /** Extended view level adding 'behavior' to the existing overview/expanded. */
 export type ComposeViewLevel = 'behavior' | 'overview' | 'expanded';
 /** An event that can be wired between behaviors. */
-export interface ConnectableEvent {
+export interface ConnectableEvent extends JsonObject {
     /** Event name (e.g., "ADD_TO_CART"). */
     event: string;
     /** Typed payload fields if declared. */
-    payloadFields?: EventPayloadField[];
+    payloadFields: SerializedPayloadField[] | null;
     /** Vertical position hint (0..1) for handle placement on the node. */
     positionHint: number;
 }
 /** Data for a BehaviorComposeNode in React Flow. */
-export interface BehaviorComposeNodeData extends Record<string, unknown> {
+export interface BehaviorComposeNodeData extends JsonObject {
     /** Behavior name from registry (e.g., "std-cart"). */
     behaviorName: string;
     /** Composition level: atom, molecule, organism. */
-    level: BehaviorLevel;
+    level: string;
     /** Domain for color coding (e.g., "commerce"). */
-    domain?: string;
+    domain: string | null;
     /** Layer classification (e.g., "Domain", "UI Patterns"). */
-    layer?: string;
+    layer: string | null;
     /** Primary entity name (e.g., "CartItem"). */
     entityName: string;
     /** Number of states in the behavior. */
     stateCount: number;
     /** Number of entity fields. */
-    fieldCount?: number;
+    fieldCount: number | null;
     /** Persistence kind. */
-    persistence?: EntityPersistence;
+    persistence: string | null;
     /** Effect types used by this behavior. */
-    effectTypes?: AvlEffectType[];
+    effectTypes: string[] | null;
     /** Child behaviors for molecule/organism glyphs. */
-    children?: BehaviorGlyphChild[];
+    children: SerializedGlyphChild[] | null;
     /** Connections between children (for organism glyphs). */
-    connections?: BehaviorGlyphConnection[];
+    connections: SerializedGlyphConnection[] | null;
     /** Events this behavior can emit (source handles). */
     connectableEvents: ConnectableEvent[];
     /** Behaviors this is composable with (for palette hints). */
-    composableWith?: string[];
+    composableWith: string[] | null;
     /** Names of orbitals produced by this behavior (for drill-down). */
     orbitalNames: string[];
 }
 /** Edge data for behavior-level wiring. */
-export interface BehaviorWireEdgeData extends Record<string, unknown> {
+export interface BehaviorWireEdgeData extends JsonObject {
     /** The event name displayed on the edge. */
     event: string;
     /** Source behavior name. */
@@ -65,7 +85,7 @@ export interface BehaviorWireEdgeData extends Record<string, unknown> {
     /** Target behavior name. */
     targetBehavior: string;
     /** Typed payload fields if declared. */
-    payloadFields?: EventPayloadField[];
+    payloadFields: SerializedPayloadField[] | null;
 }
 /** Mapping from behavior name to its metadata + produced orbitals. */
 export interface BehaviorCanvasEntry {
@@ -84,13 +104,13 @@ export interface BehaviorCanvasEntry {
     /** Number of entity fields. */
     fieldCount?: number;
     /** Persistence kind. */
-    persistence?: EntityPersistence;
+    persistence?: string;
     /** Effect types used. */
-    effectTypes?: AvlEffectType[];
+    effectTypes?: string[];
     /** Child behaviors (molecule/organism). */
-    children?: BehaviorGlyphChild[];
+    children?: SerializedGlyphChild[];
     /** Connections between children (organism). */
-    connections?: BehaviorGlyphConnection[];
+    connections?: SerializedGlyphConnection[];
     /** Events available for wiring. */
     connectableEvents: ConnectableEvent[];
     /** Compatible behavior names. */

package/dist/components/avl/molecules/avl-canvas-types.d.ts

@@ -4,6 +4,7 @@
  * Types for the unified AVL + Flow canvas. These define the data shapes
  * for React Flow nodes and edges that render AVL primitives.
  */
+import type { JsonObject } from '@almadar/core';
 import type { FieldInfo, OrbitalTraitInfo, OrbitalPageInfo, ExternalLink, TraitLevelData } from '../organisms/avl-schema-parser';
 /** The four zoom bands of the unified AVL canvas. */
 export type ZoomBand = 'system' | 'module' | 'behavior' | 'detail';
@@ -15,22 +16,24 @@ export declare const ZOOM_BAND_THRESHOLDS: {
     readonly detail: readonly [2.5, 5];
 };
 /** Data carried by every orbital node in the unified canvas. */
-export interface AvlNodeData extends Record<string, unknown> {
+export interface AvlNodeData extends JsonObject {
     orbitalName: string;
     entityName: string;
     persistence: string;
     fields: FieldInfo[];
     traits: OrbitalTraitInfo[];
     pages: OrbitalPageInfo[];
-    traitDetails: Record<string, TraitLevelData>;
+    traitDetails: {
+        [k: string]: TraitLevelData;
+    };
     externalLinks: ExternalLink[];
 }
 /** Edge kind determines visual style. */
 export type AvlEdgeKind = 'eventWire' | 'page';
 /** Data carried by edges in the unified canvas. */
-export interface AvlEdgeData extends Record<string, unknown> {
-    edgeKind: AvlEdgeKind;
-    event?: string;
-    fromTrait?: string;
-    toTrait?: string;
+export interface AvlEdgeData extends JsonObject {
+    edgeKind: string;
+    event: string | null;
+    fromTrait: string | null;
+    toTrait: string | null;
 }

package/dist/components/avl/molecules/avl-preview-converter.d.ts

@@ -13,13 +13,13 @@
  * Uses @almadar/core types for schema-level constructs.
  */
 import type { Node, Edge } from '@xyflow/react';
-import type { OrbitalSchema } from '@almadar/core';
+import type { OrbitalSchema, EntityData } from '@almadar/core';
 import type { PreviewNodeData, EventEdgeData, ScreenSize } from './avl-preview-types';
 /**
  * Build a React Flow graph for the overview level.
  * Each orbital gets one node showing its INIT transition's UI.
  */
-export declare function schemaToOverviewGraph(schema: OrbitalSchema, mockData?: Record<string, unknown[]>, behaviorMeta?: Record<string, {
+export declare function schemaToOverviewGraph(schema: OrbitalSchema, mockData?: EntityData, behaviorMeta?: Record<string, {
     layer: string;
 }>, layoutHint?: 'pipeline' | 'grid', orbitalStatus?: Record<string, PreviewNodeData['status']>, screenSize?: ScreenSize): {
     nodes: Node<PreviewNodeData>[];
@@ -36,7 +36,7 @@ export declare function schemaToOverviewGraph(schema: OrbitalSchema, mockData?:
  * anonymous `INIT` peers (STUDIO-1). Drill into a grouped card to reach
  * L3 (`orbitalAliasToExpandedGraph`).
  */
-export declare function orbitalToExpandedGraph(schema: OrbitalSchema, orbitalName: string, mockData?: Record<string, unknown[]>, screenSize?: ScreenSize): {
+export declare function orbitalToExpandedGraph(schema: OrbitalSchema, orbitalName: string, mockData?: EntityData, screenSize?: ScreenSize): {
     nodes: Node<PreviewNodeData>[];
     edges: Edge<EventEdgeData>[];
 };
@@ -47,7 +47,7 @@ export declare function orbitalToExpandedGraph(schema: OrbitalSchema, orbitalNam
  * `orbitalToExpandedGraph` but scoped to traits where
  * `sourceBehavior.alias === alias`. STUDIO-1.
  */
-export declare function orbitalAliasToExpandedGraph(schema: OrbitalSchema, orbitalName: string, alias: string, mockData?: Record<string, unknown[]>, screenSize?: ScreenSize): {
+export declare function orbitalAliasToExpandedGraph(schema: OrbitalSchema, orbitalName: string, alias: string, mockData?: EntityData, screenSize?: ScreenSize): {
     nodes: Node<PreviewNodeData>[];
     edges: Edge<EventEdgeData>[];
 };
@@ -65,7 +65,7 @@ export declare function orbitalAliasToExpandedGraph(schema: OrbitalSchema, orbit
  * with `data.kind === 'trait-card'` so `FlowCanvas`'s NODE_TYPES routes
  * them to `TraitCardNode`.
  */
-export declare function orbitalToTraitGraph(schema: OrbitalSchema, orbitalName: string, _mockData?: Record<string, unknown[]>): {
+export declare function orbitalToTraitGraph(schema: OrbitalSchema, orbitalName: string, _mockData?: EntityData): {
     nodes: Node<PreviewNodeData>[];
     edges: Edge<EventEdgeData>[];
 };

package/dist/components/avl/molecules/avl-preview-types.d.ts

@@ -7,7 +7,8 @@
  *
  * Uses @almadar/core types for schema-level constructs.
  */
-import type { Expression, UISlot } from '@almadar/core';
+import type { Expression, EntityData, OrbitalSchema, UISlot } from '@almadar/core';
+import type { AnyPatternConfig } from '@almadar/patterns';
 /**
  * The navigation levels of the FlowCanvas.
  *
@@ -84,10 +85,15 @@ export interface PatternEventSource {
 /** A slot + pattern config pair extracted from a render-ui effect. */
 export interface RenderUIEntry {
     slot: UISlot | string;
-    pattern: Record<string, unknown>;
+    pattern: AnyPatternConfig;
 }
 /** Data for a preview node (used at both overview and expanded levels). */
-export interface PreviewNodeData extends Record<string, unknown> {
+export interface PreviewNodeData {
+    [key: string]: string | number | boolean | string[] | Expression | null | RenderUIEntry[] | PatternEventSource[] | Array<{
+        event: string;
+        fromState: string;
+        toState: string;
+    }> | OrbitalSchema | EntityData | undefined;
     /** Orbital this node belongs to. */
     orbitalName: string;
     /** Trait name (only at expanded level). */
@@ -202,9 +208,14 @@ export interface PreviewNodeData extends Record<string, unknown> {
      * trait operates on. Mirrors `Trait.linkedEntity` from the resolved schema.
      */
     linkedEntity?: string;
+    /** Full parsed schema threaded to node renderers (e.g. TraitCardNode). */
+    _fullSchema?: OrbitalSchema;
+    /** Mock entity data for the orbital preview. */
+    _mockData?: EntityData;
 }
 /** Data for event flow edges. */
-export interface EventEdgeData extends Record<string, unknown> {
+export interface EventEdgeData {
+    [key: string]: string | boolean | undefined;
     /** The event name displayed on the edge. */
     event: string;
     /** Source state name (expanded level). */

package/dist/components/avl/organisms/FlowCanvas.d.ts

@@ -12,12 +12,12 @@
  * Escape to go back. AVL overlays on hover (future).
  */
 import React from 'react';
-import type { OrbitalSchema, ThemeDefinition } from '@almadar/core';
+import type { OrbitalSchema, ThemeDefinition, EntityData } from '@almadar/core';
 import type { ViewLevel, PreviewNodeData } from '../molecules/avl-preview-types';
 import type { ComposeViewLevel, BehaviorCanvasEntry, BehaviorWireEdgeData } from '../molecules/avl-behavior-compose-types';
 export interface FlowCanvasProps {
     schema: OrbitalSchema | string;
-    mockData?: Record<string, unknown[]>;
+    mockData?: EntityData;
     className?: string;
     width?: number | string;
     height?: number | string;

package/dist/components/avl/organisms/avl-schema-parser.d.ts

@@ -8,7 +8,11 @@
  *
  * @packageDocumentation
  */
-import type { OrbitalSchema } from '@almadar/core';
+import type { OrbitalSchema, JsonValue, JsonObject } from '@almadar/core';
+interface SerializedEffect extends JsonObject {
+    type: string;
+    args: JsonValue[];
+}
 export interface ApplicationOrbitalData {
     name: string;
     entityName: string;
@@ -32,13 +36,13 @@ export interface ApplicationLevelData {
     orbitals: ApplicationOrbitalData[];
     crossLinks: CrossLink[];
 }
-export interface FieldInfo {
+export interface FieldInfo extends JsonObject {
     name: string;
     type: string;
     required: boolean;
     hasDefault: boolean;
 }
-export interface OrbitalTraitInfo {
+export interface OrbitalTraitInfo extends JsonObject {
     name: string;
     stateCount: number;
     eventCount: number;
@@ -46,14 +50,14 @@ export interface OrbitalTraitInfo {
     emits: string[];
     listens: string[];
 }
-export interface OrbitalPageInfo {
+export interface OrbitalPageInfo extends JsonObject {
     name: string;
     route: string;
 }
-export interface ExternalLink {
+export interface ExternalLink extends JsonObject {
     targetOrbital: string;
     eventName: string;
-    direction: 'out' | 'in';
+    direction: string;
     traitName: string;
 }
 export interface OrbitalLevelData {
@@ -67,23 +71,20 @@ export interface OrbitalLevelData {
     pages: OrbitalPageInfo[];
     externalLinks: ExternalLink[];
 }
-export interface TraitStateInfo {
+export interface TraitStateInfo extends JsonObject {
     name: string;
-    isInitial?: boolean;
-    isTerminal?: boolean;
+    isInitial: boolean | null;
+    isTerminal: boolean | null;
 }
-export interface TraitTransitionInfo {
+export interface TraitTransitionInfo extends JsonObject {
     from: string;
     to: string;
     event: string;
-    guard?: unknown;
-    effects: Array<{
-        type: string;
-        args: unknown[];
-    }>;
+    guard: JsonValue | null;
+    effects: SerializedEffect[];
     index: number;
 }
-export interface TraitLevelData {
+export interface TraitLevelData extends JsonObject {
     name: string;
     linkedEntity: string;
     states: TraitStateInfo[];
@@ -124,3 +125,4 @@ export declare function parseTraitLevel(schema: OrbitalSchema, orbitalName: stri
  * Parse a single transition for the detail view.
  */
 export declare function parseTransitionLevel(schema: OrbitalSchema, orbitalName: string, traitName: string, transitionIndex: number): TransitionLevelData | null;
+export {};

package/dist/components/core/atoms/Button.d.ts

@@ -25,5 +25,7 @@ export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElemen
     label?: string;
     /** Disable the button (greys out, blocks click events) */
     disabled?: boolean;
+    /** Test identifier for automated tests */
+    'data-testid'?: string;
 }
 export declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;

package/dist/components/core/atoms/ConditionalWrapper.d.ts

@@ -6,14 +6,15 @@
  */
 import React from 'react';
 import { type SExpr } from '@almadar/evaluator';
+import { type JsonObject } from '@almadar/core';
 /**
  * Context for conditional evaluation
  */
 export type ConditionalContext = {
-    formValues: Record<string, unknown>;
-    globalVariables: Record<string, unknown>;
-    localVariables?: Record<string, unknown>;
-    entity?: Record<string, unknown>;
+    formValues: JsonObject;
+    globalVariables: JsonObject;
+    localVariables?: JsonObject;
+    entity?: JsonObject;
 };
 export interface ConditionalWrapperProps {
     /** The S-expression condition to evaluate */

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

@@ -6,7 +6,7 @@
  * Pure UI molecule with no entity binding.
  */
 import React from 'react';
-import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { AssetUrl, EventEmit, JsonObject } from '@almadar/core';
 /** Default shape for carousel slide items when no generic is provided. */
 export interface CarouselItem {
     id?: string;
@@ -35,7 +35,7 @@ export interface CarouselProps<T = CarouselItem> {
         index: number;
     }>;
     /** Payload to include with the slide change event */
-    slideChangePayload?: Record<string, unknown>;
+    slideChangePayload?: JsonObject;
     /** Additional CSS classes */
     className?: string;
 }

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

@@ -15,16 +15,17 @@
  */
 import React from "react";
 import type { UiError } from '../atoms/types';
+import type { JsonValue } from '@almadar/core';
 export interface OrbitalVisualizationProps {
     /** Full KFlow schema object */
     schema?: {
-        dataEntities?: unknown[];
+        dataEntities?: JsonValue[];
         ui?: {
             pages?: {
-                sections?: unknown[];
+                sections?: JsonValue[];
             }[];
         };
-        traits?: unknown[];
+        traits?: JsonValue[];
     };
     /** Direct complexity override (1-100+) */
     complexity?: number;

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

@@ -27,10 +27,10 @@ export interface PageHeaderStatus {
     variant?: "default" | "success" | "warning" | "danger" | "info";
 }
 export interface PageHeaderProps {
-    /** Page title - accepts unknown to handle generated code accessing dynamic entity data */
-    title?: string | number | unknown;
+    /** Page title - accepts string or number from generated code accessing dynamic entity data */
+    title?: string | number;
     /** Optional subtitle/description */
-    subtitle?: string | number | unknown;
+    subtitle?: string | number;
     /** Show back button */
     showBack?: boolean;
     /** Event to emit when back is clicked (default: BACK) */

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

@@ -11,13 +11,14 @@
  * - Emits: UI:SECTION_REMOVED { sectionType, index, itemId }
  */
 import React from "react";
+import type { JsonValue } from "@almadar/core";
 export type RepeatableItem = {
     id: string;
     /** State in which this item was added (for audit trails) */
-    addedInState?: string;
+    addedInState: string | null;
     /** Timestamp when item was added */
-    addedAt?: string;
-    [key: string]: unknown;
+    addedAt: string | null;
+    [key: string]: JsonValue;
 };
 export interface RepeatableFormSectionProps {
     /** Section type identifier */

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

@@ -40,5 +40,7 @@ export interface ViolationAlertProps {
     compact?: boolean;
     /** Additional CSS classes */
     className?: string;
+    /** Fallback message from playground render-ui */
+    message?: string;
 }
 export declare const ViolationAlert: React.FC<ViolationAlertProps>;

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

@@ -7,6 +7,7 @@
  * Uses wireframe theme styling (high contrast, sharp edges).
  */
 import React from "react";
+import type { JsonValue, JsonObject } from "@almadar/core";
 import type { UiError } from '../atoms/types';
 /** Form field definition for wizard sections */
 export interface WizardField {
@@ -20,38 +21,38 @@ export interface WizardField {
         label: string;
         isDefault?: boolean;
     }>;
-    defaultValue?: unknown;
-    condition?: unknown[];
+    defaultValue?: JsonValue;
+    condition?: JsonValue[];
     placeholder?: string;
     entityField?: string;
     minLength?: number;
     maxLength?: number;
-    dataSource?: Record<string, unknown>;
+    dataSource?: JsonObject;
     displayFields?: string[];
-    searchConfig?: Record<string, unknown>;
+    searchConfig?: JsonObject;
     hiddenCalculations?: Array<{
         variable: string;
-        expression: unknown;
+        expression: string;
         scope?: string;
     }>;
-    signatureConfig?: Record<string, unknown>;
-    displayTemplate?: Record<string, unknown>;
-    lawReference?: Record<string, unknown>;
+    signatureConfig?: JsonObject;
+    displayTemplate?: JsonObject;
+    lawReference?: JsonObject;
     contextMenu?: string[];
-    calculated?: Record<string, unknown>;
+    calculated?: JsonObject;
     readOnly?: boolean;
-    minDate?: unknown;
+    minDate?: JsonValue;
     stats?: Array<{
         label: string;
-        value: unknown;
+        value: JsonValue;
         icon?: string;
     }>;
     items?: Array<{
         id: string;
         label: string;
-        autoCheck?: unknown;
+        autoCheck?: JsonValue;
     }>;
-    [key: string]: unknown;
+    [key: string]: JsonValue | undefined;
 }
 /** Section within a wizard step */
 export interface WizardSection {
@@ -60,18 +61,18 @@ export interface WizardSection {
     description?: string;
     fields?: WizardField[];
     subsections?: WizardSection[];
-    condition?: unknown[];
+    condition?: JsonValue[];
     repeatable?: boolean;
     minItems?: number;
     addButtonLabel?: string;
     hiddenCalculations?: Array<{
         variable: string;
-        expression: unknown;
+        expression: string;
         scope?: string;
     }>;
-    dataSource?: Record<string, unknown>;
+    dataSource?: JsonObject;
     readOnly?: boolean;
-    [key: string]: unknown;
+    [key: string]: JsonValue | WizardField[] | WizardSection[] | undefined;
 }
 /** Entity mapping configuration */
 export interface WizardEntityMapping {
@@ -79,11 +80,11 @@ export interface WizardEntityMapping {
     mode: "search_or_create" | "create_multiple" | "select_one" | "update" | string;
     parentField?: string;
     idField?: string;
-    [key: string]: unknown;
+    [key: string]: JsonValue | undefined;
 }
 /** Validation rule for wizard steps */
 export interface WizardValidationRule {
-    condition: unknown[];
+    condition: JsonValue[];
     message: string;
 }
 /** Law reference for compliance */
@@ -128,13 +129,13 @@ export interface WizardStep {
     /** Context menu actions */
     contextMenu?: string[];
     /** Allow additional properties from schema */
-    [key: string]: unknown;
+    [key: string]: JsonValue | React.ReactNode | WizardSection[] | WizardEntityMapping | WizardValidationRule[] | WizardLawReference[] | (() => boolean) | undefined;
 }
 export interface WizardContainerProps {
     /** Wizard steps */
     steps: WizardStep[];
-    /** Current step index (controlled) - accepts unknown for generated code compatibility */
-    currentStep?: number | string | unknown;
+    /** Current step index (controlled) - accepts number or string for generated code compatibility */
+    currentStep?: number | string;
     /** Callback when step changes */
     onStepChange?: (stepIndex: number) => void;
     /** Callback when wizard is completed */

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

@@ -9,7 +9,7 @@
  * for pagination, filtering, or search. All state is owned by the trait state machine.
  */
 import React from 'react';
-import type { EventKey } from "@almadar/core";
+import type { EventKey, EventPayload } from "@almadar/core";
 import type { DisplayStateProps } from './types';
 import type { EntityRow } from '@almadar/core';
 export type CardGridGap = 'none' | 'sm' | 'md' | 'lg' | 'xl';
@@ -24,7 +24,7 @@ export interface CardItemAction {
     /** Navigation URL - supports template interpolation like "/products/{{row.id}}" */
     navigatesTo?: string;
     /** Callback on click */
-    onClick?: (item: unknown) => void;
+    onClick?: (item: EventPayload) => void;
     /** Action used by generated code - alternative to event */
     action?: EventKey;
     /** Action placement - accepts string for compatibility with generated code */