@almadar/ui 5.16.4 → 5.17.1

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

@@ -9,6 +9,7 @@
  */
 import React from "react";
 import type { EventKey, EventPayload } from "@almadar/core";
+import type { UiError } from "../atoms/types";
 /**
  * Allowed element types for custom patterns.
  */
@@ -52,7 +53,7 @@ export interface CustomPatternProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name */
     entity?: string;
 }

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

@@ -23,6 +23,10 @@ export interface RowAction<T> {
     show?: (row: T) => boolean;
     event?: string;
 }
+export interface DataTableEmptyAction {
+    label: string;
+    event?: string;
+}
 export interface DataTableProps<T extends EntityRow & {
     id: string | number;
 }> extends EntityDisplayProps<T> {
@@ -41,13 +45,10 @@ export interface DataTableProps<T extends EntityRow & {
         variant?: "default" | "primary" | "secondary" | "ghost" | "danger" | string;
         onClick?: (row: T) => void;
     }[];
-    emptyIcon?: LucideIcon;
+    emptyIcon?: LucideIcon | string;
     emptyTitle?: string;
     emptyDescription?: string;
-    emptyAction?: {
-        label: string;
-        event?: string;
-    };
+    emptyAction?: DataTableEmptyAction;
     selectable?: boolean;
     searchable?: boolean;
     searchPlaceholder?: string;

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

@@ -44,15 +44,16 @@ export type FieldDef = string | {
     name: string;
     type: string;
 };
+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>;
     title?: string;
     subtitle?: string;
-    status?: {
-        label: string;
-        variant?: "default" | "success" | "warning" | "danger" | "info";
-    };
+    status?: DetailPanelStatus;
     avatar?: React.ReactNode;
     sections?: readonly DetailSection[];
     /** Unified actions array - first action with variant='primary' is the main action */

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

@@ -11,6 +11,7 @@
  * - className for external styling
  */
 import React from "react";
+import type { UiError } from '../atoms/types';
 export type DocumentType = "pdf" | "text" | "html" | "markdown";
 export interface DocumentAction {
     label: string;
@@ -18,6 +19,12 @@ export interface DocumentAction {
     navigatesTo?: string;
     variant?: "primary" | "secondary" | "ghost";
 }
+export interface DocumentItem {
+    label: string;
+    src?: string;
+    content?: string;
+    documentType?: DocumentType;
+}
 export interface DocumentViewerProps {
     /** Document title */
     title?: string;
@@ -42,18 +49,13 @@ export interface DocumentViewerProps {
     /** Actions */
     actions?: readonly DocumentAction[];
     /** Multiple documents (tabbed view) */
-    documents?: readonly {
-        label: string;
-        src?: string;
-        content?: string;
-        documentType?: DocumentType;
-    }[];
+    documents?: readonly DocumentItem[];
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Additional CSS classes */
     className?: string;
 }

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

@@ -12,6 +12,7 @@
  */
 import React from 'react';
 import { DrawerPosition, DrawerSize } from '../molecules/Drawer';
+import type { UiError } from '../atoms/types';
 export interface DrawerSlotProps {
     /** Content to display in the drawer */
     children?: React.ReactNode;
@@ -26,7 +27,7 @@ export interface DrawerSlotProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
 }

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

@@ -12,11 +12,12 @@
  * - Nested sections with collapsible support
  */
 import React from "react";
-import type { EventKey } from "@almadar/core";
+import type { EventKey, FieldValue } from "@almadar/core";
 import { type SelectOption } from "../atoms/Select";
 import { type RelationOption } from "../molecules/RelationSelect";
 import type { OrbitalEntity } from "@almadar/core";
 import { type SExpr } from "@almadar/evaluator";
+import type { UiError } from '../atoms/types';
 /**
  * S-Expression type for conditional logic (re-export from @almadar/evaluator)
  */
@@ -169,7 +170,7 @@ export interface FormProps extends Omit<React.FormHTMLAttributes<HTMLFormElement
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Submit button label */
     submitLabel?: string;
     /** Cancel button label (if provided, shows cancel button) */
@@ -201,8 +202,8 @@ export interface FormProps extends Omit<React.FormHTMLAttributes<HTMLFormElement
     /** Callback when any field value changes */
     onFieldChange?: (change: {
         fieldId: string;
-        value: unknown;
-        formValues: Record<string, unknown>;
+        value: FieldValue | undefined;
+        formValues: Record<string, FieldValue | undefined>;
     }) => void;
     /** Config path for form configuration (schema-driven) */
     configPath?: string;

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

@@ -12,6 +12,7 @@
  */
 import React from "react";
 import type { EventEmit, EventPayload } from "@almadar/core";
+import type { UiError } from '../atoms/types';
 export type GraphNode = EventPayload & {
     id: string;
     label?: string;
@@ -65,7 +66,7 @@ export interface GraphCanvasProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Additional CSS classes */
     className?: string;
 }

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

@@ -6,7 +6,21 @@
  */
 import React from "react";
 import type { LucideIcon } from "lucide-react";
+import type { UiError } from '../atoms/types';
 export type HeaderLook = "hero" | "compact-bar" | "breadcrumb" | "contextual" | "editorial-banner";
+export interface HeaderNavigationItem {
+    label: string;
+    href?: string;
+    onClick?: () => void;
+    icon?: LucideIcon;
+    badge?: string | number;
+    active?: boolean;
+}
+export interface HeaderUserAvatar {
+    src?: string;
+    alt?: string;
+    initials?: string;
+}
 export interface HeaderProps {
     /**
      * Logo/Brand content
@@ -23,14 +37,7 @@ export interface HeaderProps {
     /**
      * Navigation items (for desktop header variant)
      */
-    navigationItems?: Array<{
-        label: string;
-        href?: string;
-        onClick?: () => void;
-        icon?: LucideIcon;
-        badge?: string | number;
-        active?: boolean;
-    }>;
+    navigationItems?: HeaderNavigationItem[];
     /**
      * Show menu toggle button
      * @default true
@@ -60,11 +67,7 @@ export interface HeaderProps {
     /**
      * User avatar configuration
      */
-    userAvatar?: {
-        src?: string;
-        alt?: string;
-        initials?: string;
-    };
+    userAvatar?: HeaderUserAvatar;
     /**
      * User name (display name or email)
      */
@@ -104,7 +107,7 @@ export interface HeaderProps {
     /**
      * Error state (closed circuit)
      */
-    error?: Error | null;
+    error?: UiError | null;
     /**
      * Entity name for schema-driven auto-fetch (closed circuit)
      */

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

@@ -9,6 +9,7 @@
  */
 import React from 'react';
 import type { OrbitalSchema, Trait as CoreTrait } from '@almadar/core';
+import type { UiError } from '../atoms/types';
 type SmTrait = CoreTrait;
 type SmSchema = OrbitalSchema;
 export interface JazariStateMachineProps {
@@ -17,7 +18,7 @@ export interface JazariStateMachineProps {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Full schema — extracts first trait's state machine */
     schema?: SmSchema;
     /** Or pass a single trait directly */

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

@@ -10,6 +10,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { UiError } from '../atoms/types';
 import { type StackGap, type StackAlign, type StackJustify } from '../atoms/Stack';
 import { type BoxPadding, type BoxBg, type BoxRounded, type BoxShadow } from '../atoms/Box';
 import { type GridCols, type GridGap, type ResponsiveGridCols } from '../molecules/Grid';
@@ -27,7 +28,7 @@ export interface LayoutPatternProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name */
     entity?: string;
 }
@@ -130,7 +131,7 @@ export interface SpacerPatternProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name */
     entity?: string;
 }
@@ -157,7 +158,7 @@ export interface DividerPatternProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name */
     entity?: string;
 }

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

@@ -21,7 +21,7 @@ import type { EventKey } from "@almadar/core";
 import type { LucideIcon } from "lucide-react";
 import { type MenuItem } from "../molecules/Menu";
 import type { EntityDisplayProps } from "./types";
-export interface ListItem {
+export type ListItem = {
     id: string;
     title?: string;
     description?: string;
@@ -38,7 +38,7 @@ export interface ListItem {
     completed?: boolean;
     [key: string]: unknown;
     _fields?: Record<string, unknown>;
-}
+};
 export interface SchemaItemAction {
     label: string;
     /** Event to dispatch on click */

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

@@ -11,6 +11,7 @@
  * - className for external styling
  */
 import React from "react";
+import type { UiError } from '../atoms/types';
 export type MeterVariant = "linear" | "radial" | "segmented";
 export interface MeterThreshold {
     value: number;
@@ -51,7 +52,7 @@ export interface MeterProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Additional CSS classes */
     className?: string;
 }

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

@@ -10,6 +10,7 @@
  * - Extracts title from Form components
  */
 import React from 'react';
+import type { UiError } from '../atoms/types';
 export interface ModalSlotProps {
     /** Content to display in the modal */
     children?: React.ReactNode;
@@ -22,7 +23,7 @@ export interface ModalSlotProps {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
 }

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

@@ -6,6 +6,7 @@
  */
 import React from 'react';
 import type { LucideIcon } from 'lucide-react';
+import type { UiError } from '../atoms/types';
 export interface NavigationItem {
     /**
      * Item ID
@@ -61,7 +62,7 @@ export interface NavigationProps {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
 }

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

@@ -14,6 +14,7 @@
  * - 4f (61+): Multi-lobe - Violet
  */
 import React from "react";
+import type { UiError } from '../atoms/types';
 export interface OrbitalVisualizationProps {
     /** Full KFlow schema object */
     schema?: {
@@ -40,7 +41,7 @@ export interface OrbitalVisualizationProps {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
 }

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

@@ -1,6 +1,7 @@
 import React from "react";
 import type { EventEmit } from "@almadar/core";
 import { LucideIcon } from "lucide-react";
+import type { UiError } from '../atoms/types';
 export interface PageBreadcrumb {
     label: string;
     href?: string;
@@ -21,6 +22,10 @@ export interface SchemaAction {
     loading?: boolean;
     disabled?: boolean;
 }
+export interface PageHeaderStatus {
+    label: string;
+    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;
@@ -33,16 +38,13 @@ export interface PageHeaderProps {
     /** Breadcrumbs */
     breadcrumbs?: readonly PageBreadcrumb[];
     /** Status badge */
-    status?: {
-        label: string;
-        variant?: "default" | "success" | "warning" | "danger" | "info";
-    };
+    status?: PageHeaderStatus;
     /** Actions array - first action with variant='primary' (or first action) is the main action */
     actions?: readonly Readonly<SchemaAction>[];
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
     /** Tabs for sub-navigation */

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

@@ -5,6 +5,7 @@
  * Perfect for grouping related content with consistent spacing.
  */
 import React from 'react';
+import type { UiError } from '../atoms/types';
 export type SectionPadding = 'none' | 'sm' | 'md' | 'lg' | 'xl';
 export type SectionVariant = 'default' | 'card' | 'bordered' | 'filled';
 export interface SectionProps {
@@ -33,7 +34,7 @@ export interface SectionProps {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
 }

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

@@ -12,6 +12,7 @@
 import React from 'react';
 import type { EventEmit } from '@almadar/core';
 import type { LucideIcon } from 'lucide-react';
+import type { UiError } from '../atoms/types';
 export interface SidebarItem {
     /** Item ID */
     id: string;
@@ -38,7 +39,7 @@ export interface SidebarProps {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Logo/Brand content - can be a ReactNode or logo config */
     logo?: React.ReactNode;
     /** Logo image source */

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

@@ -12,6 +12,7 @@
  */
 import React from "react";
 import type { EventEmit } from "@almadar/core";
+import type { UiError } from '../atoms/types';
 export interface SignaturePadProps {
     /** Label above the pad */
     label?: string;
@@ -40,7 +41,7 @@ export interface SignaturePadProps {
     /** Loading state */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Additional CSS classes */
     className?: string;
 }

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

@@ -5,6 +5,7 @@
  * Perfect for sidebar/content layouts or side-by-side comparisons.
  */
 import React from 'react';
+import type { UiError } from '../atoms/types';
 export type SplitRatio = '1:1' | '1:2' | '2:1' | '1:3' | '3:1' | '1:4' | '4:1' | '2:3' | '3:2';
 export type SplitGap = 'none' | 'sm' | 'md' | 'lg' | 'xl';
 export interface SplitProps {
@@ -31,7 +32,7 @@ export interface SplitProps {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
 }

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

@@ -16,23 +16,27 @@
  */
 import React from 'react';
 import type { DomLayoutData, DomStateNode, DomTransitionLabel, VisualizerConfig } from '../../lib/visualizer/index.js';
+import type { UiError } from '../atoms/types';
 /** Bundled transitions between same from→to states */
-export interface TransitionBundle {
+export type TransitionBundle = {
     id: string;
     from: string;
     to: string;
     labels: DomTransitionLabel[];
     isBidirectional: boolean;
     isReverse: boolean;
-}
+};
 export interface StateMachineViewProps {
     /** Additional CSS classes */
     className?: string;
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
-    layoutData: DomLayoutData;
+    error?: UiError | null;
+    /** Pre-computed visualizer layout. Optional: when absent the view renders
+     *  nothing (an author wires real layout via config; the generic factory
+     *  can't synthesize a `DomLayoutData`). */
+    layoutData?: DomLayoutData;
     /** Custom state node renderer — when provided, replaces the default circle nodes */
     renderStateNode?: (state: DomStateNode, config: VisualizerConfig) => React.ReactNode;
 }

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

@@ -14,6 +14,7 @@ import React from "react";
 import type { EventKey } from "@almadar/core";
 import type { EntityCollection, EntityRow } from "@almadar/core";
 import type { LucideIcon } from "lucide-react";
+import type { UiError } from '../atoms/types';
 export type TimelineItemStatus = "complete" | "active" | "pending" | "error";
 /**
  * Layer 2 visual treatment for the timeline pattern — orthogonal to the
@@ -48,7 +49,7 @@ export interface TimelineProps {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /**
      * Schema entity data typed against @almadar/core's EntityRow. Items from
      * `entity` are normalised into `items` when `items` is omitted. UI-specific

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

@@ -11,6 +11,7 @@
  */
 import React from 'react';
 import { ToastVariant } from '../molecules/Toast';
+import type { UiError } from '../atoms/types';
 export interface ToastSlotProps {
     /** Content to display in the toast (message or ReactNode) */
     children?: React.ReactNode;
@@ -25,7 +26,7 @@ export interface ToastSlotProps {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
 }

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

@@ -30,6 +30,7 @@ export declare function SuspenseConfigProvider({ config, children, }: {
 export declare namespace SuspenseConfigProvider {
     var displayName: string;
 }
+import type { UiError } from '../atoms/types';
 interface UISlotComponentProps {
     slot: UISlot;
     portal?: boolean;
@@ -37,7 +38,7 @@ interface UISlotComponentProps {
     className?: string;
     draggable?: boolean;
     isLoading?: boolean;
-    error?: Error | null;
+    error?: UiError | null;
     entity?: string;
     /** Compiled mode: render children directly instead of resolving from context */
     children?: React.ReactNode;
@@ -57,7 +58,7 @@ interface SlotContentRendererProps {
     onDismiss: () => void;
     className?: string;
     isLoading?: boolean;
-    error?: Error | null;
+    error?: UiError | null;
     entity?: string;
     /** Schema-compatible path for WYSIWYG drop targeting (e.g., "root.children.0"). */
     patternPath?: string;
@@ -82,7 +83,7 @@ export interface UISlotRendererProps {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity name for schema-driven auto-fetch */
     entity?: string;
     /**

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

@@ -7,6 +7,7 @@
  * Uses wireframe theme styling (high contrast, sharp edges).
  */
 import React from "react";
+import type { UiError } from '../atoms/types';
 /** Form field definition for wizard sections */
 export interface WizardField {
     id: string;
@@ -149,7 +150,7 @@ export interface WizardContainerProps {
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
-    error?: Error | null;
+    error?: UiError | null;
     /** Entity type name (schema-driven) */
     entity?: string;
 }

package/dist/components/organisms/book/types.d.ts

@@ -22,12 +22,12 @@ export interface BookPart {
     title: string;
     chapters: BookChapter[];
 }
-export interface BookChapter {
+export type BookChapter = {
     id: string;
     title: string;
     content: string;
     orbitalSchema?: OrbitalSchema;
-}
+};
 /**
  * Maps raw entity field names to canonical BookData field names.
  * Each key is a canonical field, each value is the entity field name.

package/dist/components/organisms/game/BattleBoard.d.ts

@@ -25,7 +25,7 @@ import type { ResolvedFrame } from './types/spriteAnimation';
 /** Battle phases an encounter walks through */
 export type BattlePhase = 'observation' | 'selection' | 'movement' | 'action' | 'enemy_turn' | 'game_over';
 /** A unit participating in battle */
-export interface BattleUnit {
+export type BattleUnit = {
     id: string;
     name: string;
     unitType?: string;
@@ -54,7 +54,7 @@ export interface BattleUnit {
         states: string[];
         cooldown?: number;
     }[];
-}
+};
 /** Minimal tile for map generation */
 export interface BattleTile {
     x: number;
@@ -100,7 +100,7 @@ export interface BattleEntity {
     selectedUnitId: string | null;
 }
 /** Context exposed to render-prop slots */
-export interface BattleSlotContext {
+export type BattleSlotContext = {
     phase: BattlePhase;
     turn: number;
     selectedUnit: BattleUnit | null;
@@ -120,7 +120,7 @@ export interface BattleSlotContext {
         x: number;
         y: number;
     };
-}
+};
 export interface BattleBoardProps extends Omit<EntityDisplayProps, 'entity'> {
     /** Entity containing all board data */
     entity: BattleEntity;