@almadar/ui 2.0.1 → 2.0.3

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

@@ -1,65 +0,0 @@
-/**
- * Sidebar Organism Component
- *
- * A sidebar component with logo, navigation items, user section, and collapse/expand.
- * Styled to match the main Layout component with theme-aware CSS variables.
- */
-import React from 'react';
-import type { LucideIcon } from 'lucide-react';
-export interface SidebarItem {
-    /** Item ID */
-    id: string;
-    /** Item label */
-    label: string;
-    /** Item icon */
-    icon?: LucideIcon;
-    /** Item badge */
-    badge?: string | number;
-    /** Item href */
-    href?: string;
-    /** Item click handler */
-    onClick?: () => void;
-    /** Is active */
-    active?: boolean;
-    /** @deprecated Use `active` instead */
-    isActive?: boolean;
-    /** Sub-items (for nested navigation) */
-    subItems?: SidebarItem[];
-}
-export interface SidebarProps {
-    /** Logo/Brand content - can be a ReactNode or logo config */
-    logo?: React.ReactNode;
-    /** Logo image source */
-    logoSrc?: string;
-    /** Brand/App name */
-    brandName?: string;
-    /** Navigation items */
-    items: SidebarItem[];
-    /** User section content */
-    userSection?: React.ReactNode;
-    /** Footer content (e.g., theme toggle) */
-    footerContent?: React.ReactNode;
-    /** Collapsed state (controlled) */
-    collapsed?: boolean;
-    /** Default collapsed state */
-    defaultCollapsed?: boolean;
-    /** Callback when collapse state changes */
-    onCollapseChange?: (collapsed: boolean) => void;
-    /** Hide the collapse/expand button */
-    hideCollapseButton?: boolean;
-    /** Show a close button (for mobile) */
-    showCloseButton?: boolean;
-    /** Callback when close button is clicked */
-    onClose?: () => void;
-    /** Callback when logo/brand is clicked */
-    onLogoClick?: () => void;
-    /** Additional CSS classes */
-    className?: string;
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
-}
-export declare const Sidebar: React.FC<SidebarProps>;

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

@@ -1,44 +0,0 @@
-/**
- * SignaturePad Organism Component
- *
- * A canvas-based signature capture pad.
- * Uses a minimal canvas wrapper (necessary for drawing) but composes all
- * surrounding UI with atoms and molecules.
- *
- * Orbital Component Interface Compliance:
- * - Event emission via useEventBus (UI:* events)
- * - isLoading and error state props
- * - className for external styling
- */
-import React from "react";
-export interface SignaturePadProps {
-    /** Label above the pad */
-    label?: string;
-    /** Helper text */
-    helperText?: string;
-    /** Stroke color */
-    strokeColor?: string;
-    /** Stroke width */
-    strokeWidth?: number;
-    /** Pad height */
-    height?: number;
-    /** Whether the pad is read-only */
-    readOnly?: boolean;
-    /** Existing signature image URL */
-    value?: string;
-    /** Callback when signature changes */
-    onChange?: (dataUrl: string | null) => void;
-    /** Event to emit on sign */
-    signEvent?: string;
-    /** Event to emit on clear */
-    clearEvent?: string;
-    /** Entity name for schema-driven context */
-    entity?: string;
-    /** Loading state */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare const SignaturePad: React.FC<SignaturePadProps>;

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

@@ -1,42 +0,0 @@
-/**
- * Split Component
- *
- * A two-column layout with configurable ratios.
- * Perfect for sidebar/content layouts or side-by-side comparisons.
- */
-import React from 'react';
-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 {
-    /** Size ratio between left and right panels */
-    ratio?: SplitRatio;
-    /** Gap between panels */
-    gap?: SplitGap;
-    /** Reverse the order (right first) */
-    reverse?: boolean;
-    /** Stack vertically on mobile */
-    stackOnMobile?: boolean;
-    /** Breakpoint to switch from stacked to side-by-side */
-    stackBreakpoint?: 'sm' | 'md' | 'lg' | 'xl';
-    /** Align items vertically */
-    align?: 'start' | 'center' | 'end' | 'stretch';
-    /** Custom class name */
-    className?: string;
-    /** Left/first panel class name */
-    leftClassName?: string;
-    /** Right/second panel class name */
-    rightClassName?: string;
-    /** Exactly two children: [left, right] */
-    children: [React.ReactNode, React.ReactNode];
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
-}
-/**
- * Split - Two-column layout with flexible ratios
- */
-export declare const Split: React.FC<SplitProps>;
-export default Split;

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

@@ -1,66 +0,0 @@
-import React from "react";
-import { LucideIcon } from "lucide-react";
-/**
- * Schema metric definition
- * Supports both computed metrics (with field) and static metrics (with value)
- */
-export interface MetricDefinition {
-    /** Field name for computed metrics (optional if value is provided) */
-    field?: string;
-    /** Display label */
-    label: string;
-    /** Static value for display (alternative to field-based computation) */
-    value?: string | number;
-    /** Icon name for display */
-    icon?: string;
-    /** Value format (e.g., 'currency', 'percent', 'number') */
-    format?: "currency" | "percent" | "number" | string;
-}
-export interface StatCardProps {
-    /** Main label */
-    label?: string;
-    /** Title (alias for label) */
-    title?: string;
-    /** Primary value - accepts array/unknown from generated code (will use first element or length) */
-    value?: string | number | (string | number | undefined)[] | unknown;
-    /** Previous value for comparison */
-    previousValue?: number;
-    /** Current value as number for trend calculation */
-    currentValue?: number;
-    /** Manual trend percentage (overrides calculation) */
-    trend?: number;
-    /** Trend direction (overrides calculation) */
-    trendDirection?: "up" | "down" | "neutral";
-    /** Whether up is good (green) or bad (red) */
-    invertTrend?: boolean;
-    /** Icon to display */
-    icon?: LucideIcon;
-    /** Icon background color */
-    iconBg?: string;
-    /** Icon color */
-    iconColor?: string;
-    /** Subtitle or description */
-    subtitle?: string;
-    /** Action button */
-    action?: {
-        label: string;
-        /** Event to dispatch via event bus (for trait state machine integration) */
-        event?: string;
-        /** Navigation URL - supports template interpolation */
-        navigatesTo?: string;
-        /** Legacy onClick callback */
-        onClick?: () => void;
-    };
-    className?: string;
-    /** Entity name for schema-driven stats */
-    entity?: string;
-    /** Metrics to display (schema format) - accepts readonly for compatibility with generated const arrays */
-    metrics?: readonly MetricDefinition[];
-    /** Data to calculate stats from - accepts readonly for compatibility with generated const arrays */
-    data?: readonly Record<string, unknown>[];
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-}
-export declare const StatCard: React.FC<StatCardProps>;

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

@@ -1,36 +0,0 @@
-/**
- * StateMachineView - Reusable State Machine Visualizer
- *
- * A hybrid DOM/SVG component for visualizing state machines.
- * Uses SVG for arrow paths, DOM for tooltips.
- *
- * Moved from projects/builder to @almadar/ui for reuse across projects.
- *
- * BUNDLING: When multiple transitions exist between the same states (same direction),
- * they are bundled into a single arrow with a badge showing the count.
- * Hovering shows all events and their effects in a detailed tooltip.
- *
- * Events Emitted:
- * - UI:STATE_CLICK - When a state node is clicked
- * - UI:TRANSITION_CLICK - When a transition bundle is clicked
- */
-import React from 'react';
-import type { DomLayoutData, DomStateNode, DomTransitionLabel, VisualizerConfig } from '../../lib/visualizer/index.js';
-import type { EntityDisplayProps } from './types';
-/** Bundled transitions between same from→to states */
-export interface TransitionBundle {
-    id: string;
-    from: string;
-    to: string;
-    labels: DomTransitionLabel[];
-    isBidirectional: boolean;
-    isReverse: boolean;
-}
-export interface StateMachineViewProps extends EntityDisplayProps {
-    layoutData: DomLayoutData;
-    /** Custom state node renderer — when provided, replaces the default circle nodes */
-    renderStateNode?: (state: DomStateNode, config: VisualizerConfig) => React.ReactNode;
-}
-export declare const StateMachineView: React.FC<StateMachineViewProps>;
-export { StateMachineView as DomStateMachineVisualizer };
-export { StateMachineView as OrbitalStateMachineView };

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

@@ -1,99 +0,0 @@
-/**
- * Table Organism Component
- *
- * A dumb table component with header row, data rows, pagination, sorting, and search.
- * Emits events via useEventBus — never manages internal state for search, sort,
- * selection, or pagination. All state is owned by the trait state machine.
- *
- * Uses Pagination, SearchInput, ButtonGroup, Card, Menu molecules and Button, Icon, Checkbox, Typography, Badge, Divider atoms.
- */
-import React from "react";
-import { MenuItem } from "../molecules/Menu";
-import type { EntityDisplayProps } from "./types";
-export type SortDirection = "asc" | "desc";
-export interface TableColumn<T = any> {
-    /**
-     * Column key
-     */
-    key: string;
-    /**
-     * Column header label
-     */
-    label: string;
-    /**
-     * Sortable column
-     * @default false
-     */
-    sortable?: boolean;
-    /**
-     * Custom cell renderer
-     */
-    render?: (value: any, row: T, index: number) => React.ReactNode;
-    /**
-     * Column width
-     */
-    width?: string;
-}
-export interface TableProps<T = Record<string, unknown>> extends EntityDisplayProps<T> {
-    /**
-     * Table columns
-     */
-    columns: TableColumn<T>[];
-    /**
-     * Enable row selection
-     * @default false
-     */
-    selectable?: boolean;
-    /**
-     * Enable sorting
-     * @default false
-     */
-    sortable?: boolean;
-    /**
-     * Current sort column (display hint, mapped from sortBy)
-     */
-    sortColumn?: string;
-    /**
-     * Current sort direction (display hint)
-     */
-    sortDirection?: SortDirection;
-    /**
-     * Enable search/filter
-     * @default false
-     */
-    searchable?: boolean;
-    /**
-     * Search placeholder
-     */
-    searchPlaceholder?: string;
-    /**
-     * Enable pagination
-     * @default false
-     */
-    paginated?: boolean;
-    /**
-     * Current page (display hint)
-     */
-    currentPage?: number;
-    /**
-     * Total pages (display hint)
-     */
-    totalPages?: number;
-    /**
-     * Row actions menu items
-     */
-    rowActions?: (row: T) => MenuItem[];
-    /**
-     * Empty state message
-     */
-    emptyMessage?: string;
-    /**
-     * Loading state
-     * @default false
-     */
-    loading?: boolean;
-}
-export declare const Table: {
-    <T extends Record<string, any>>({ columns, entity, data, className, isLoading, error, sortBy, sortDirection: entitySortDirection, searchValue, page, pageSize, totalCount, selectedIds, selectable, sortable, sortColumn: sortColumnProp, sortDirection: sortDirectionProp, searchable, searchPlaceholder, paginated, currentPage: currentPageProp, totalPages: totalPagesProp, rowActions, emptyMessage, loading, }: TableProps<T>): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};

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

@@ -1,58 +0,0 @@
-/**
- * Timeline Organism Component
- *
- * A vertical timeline component for displaying chronological events.
- * Composes atoms and molecules for layout, uses CSS variables for theming.
- *
- * Orbital Component Interface Compliance:
- * - Entity binding with auto-fetch when entity is a string
- * - Event emission via useEventBus (UI:* events)
- * - isLoading and error state props
- * - className for external styling
- */
-import React from "react";
-import type { LucideIcon } from "lucide-react";
-export type TimelineItemStatus = "complete" | "active" | "pending" | "error";
-export interface TimelineItem {
-    /** Unique identifier */
-    id: string;
-    /** Item title */
-    title: string;
-    /** Item description */
-    description?: string;
-    /** Timestamp string */
-    date?: string;
-    /** Status indicator */
-    status?: TimelineItemStatus;
-    /** Icon override */
-    icon?: LucideIcon;
-    /** Additional metadata tags */
-    tags?: readonly string[];
-}
-export interface TimelineAction {
-    label: string;
-    event?: string;
-    navigatesTo?: string;
-    variant?: "primary" | "secondary" | "ghost";
-}
-export interface TimelineProps {
-    /** Timeline title */
-    title?: string;
-    /** Timeline items */
-    items?: readonly TimelineItem[];
-    /** Schema-driven data */
-    data?: readonly Record<string, unknown>[];
-    /** Fields to display */
-    fields?: readonly string[];
-    /** Actions per item */
-    itemActions?: readonly TimelineAction[];
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
-    /** Loading state */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare const Timeline: React.FC<TimelineProps>;

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

@@ -1,38 +0,0 @@
-/**
- * ToastSlot Component
- *
- * Wraps toast slot content in a proper Toast component with positioning.
- * Used by trait-driven pages to display toast UI from render_ui effects.
- *
- * Handles:
- * - Auto-show when content is present
- * - Dispatches DISMISS event when dismissed
- * - Fixed positioning in corner of screen
- */
-import React from 'react';
-import { ToastVariant } from '../molecules/Toast';
-export interface ToastSlotProps {
-    /** Content to display in the toast (message or ReactNode) */
-    children?: React.ReactNode;
-    /** Toast variant */
-    variant?: ToastVariant;
-    /** Toast title */
-    title?: string;
-    /** Auto-dismiss duration in ms (0 = no auto-dismiss) */
-    duration?: number;
-    /** Custom class name */
-    className?: string;
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
-}
-/**
- * ToastSlot - Wrapper for toast slot content
- *
- * Automatically shows toast when children are present,
- * and dispatches dismiss events when toast is dismissed.
- */
-export declare const ToastSlot: React.FC<ToastSlotProps>;

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

@@ -1,112 +0,0 @@
-/**
- * UISlotRenderer Component
- *
- * Renders all UI slots. This is the central component that displays
- * content rendered by traits via render_ui effects.
- *
- * Slots are rendered as:
- * - Layout slots: Inline in the page flow (main, sidebar)
- * - Portal slots: Rendered via portals (modal, drawer, toast, etc.)
- * - HUD slots: Fixed position overlays (hud-top, hud-bottom)
- *
- * @packageDocumentation
- */
-import React from "react";
-import { type UISlot, type SlotContent } from "../../context/UISlotContext";
-export interface SuspenseConfig {
-    /** Enable Suspense boundaries around slot content */
-    enabled: boolean;
-    /** Custom fallback per slot, overrides default Skeleton variant */
-    slotFallbacks?: Partial<Record<UISlot, React.ReactNode>>;
-}
-/**
- * Provider for Suspense configuration.
- * When enabled, each UI slot is wrapped in `<ErrorBoundary><Suspense>`.
- */
-export declare function SuspenseConfigProvider({ config, children, }: {
-    config: SuspenseConfig;
-    children: React.ReactNode;
-}): React.FunctionComponentElement<React.ProviderProps<SuspenseConfig>>;
-export declare namespace SuspenseConfigProvider {
-    var displayName: string;
-}
-/**
- * Maps component names to actual React components.
- * The pattern resolver returns a component name (e.g., "DataTable"),
- * and this registry provides the actual component.
- *
- * Component names match those in orbital-shared/patterns/component-mapping.json
- */
-export declare const COMPONENT_REGISTRY: Record<string, React.ComponentType<any>>;
-interface UISlotComponentProps {
-    slot: UISlot;
-    portal?: boolean;
-    position?: "left" | "right" | "top-right" | "top-left" | "bottom-right" | "bottom-left";
-    className?: string;
-    draggable?: boolean;
-    isLoading?: boolean;
-    error?: Error | null;
-    entity?: string;
-}
-/**
- * Individual slot renderer.
- *
- * Handles different slot types with appropriate wrappers.
- */
-declare function UISlotComponent({ slot, portal, position, className, }: UISlotComponentProps): React.ReactElement | null;
-interface SlotContentRendererProps {
-    content: SlotContent;
-    onDismiss: () => void;
-    className?: string;
-    isLoading?: boolean;
-    error?: Error | null;
-    entity?: string;
-}
-/**
- * Renders the actual content of a slot.
- *
- * Dynamically renders pattern components from the registry.
- * For layout patterns with `hasChildren`, recursively renders nested patterns.
- */
-declare function SlotContentRenderer({ content, onDismiss, }: SlotContentRendererProps): React.ReactElement;
-export interface UISlotRendererProps {
-    /** Include HUD slots */
-    includeHud?: boolean;
-    /** Include floating slot */
-    includeFloating?: boolean;
-    /** Additional class name for the container */
-    className?: string;
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
-    /**
-     * Enable Suspense boundaries around each slot.
-     * When true, each inline slot is wrapped in `<ErrorBoundary><Suspense>` with
-     * Skeleton fallbacks. Opt-in — existing isLoading prop pattern still works.
-     */
-    suspense?: boolean | SuspenseConfig;
-}
-/**
- * Main UI Slot Renderer component.
- *
- * Renders all slot containers. Place this in your page/layout component.
- *
- * @example
- * ```tsx
- * function PageLayout() {
- *   return (
- *     <div className="page-layout">
- *       <UISlotRenderer />
- *     </div>
- *   );
- * }
- * ```
- */
-export declare function UISlotRenderer({ includeHud, includeFloating, className, suspense, }: UISlotRendererProps): React.ReactElement;
-export declare namespace UISlotRenderer {
-    var displayName: string;
-}
-export { UISlotComponent, SlotContentRenderer };