@almadar/ui 2.0.1 → 2.0.3

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

@@ -1,71 +0,0 @@
-/**
- * DetailPanel Organism Component
- *
- * Composes atoms and molecules to create a professional detail view.
- *
- * Data is provided by the trait via the `data` prop (render-ui effect).
- * See EntityDisplayProps in ./types.ts for base prop contract.
- */
-import React from "react";
-import type { LucideIcon } from "lucide-react";
-import type { EntityDisplayProps } from "./types";
-export interface DetailField {
-    label: string;
-    value: React.ReactNode;
-    icon?: LucideIcon;
-    copyable?: boolean;
-}
-export interface DetailSection {
-    title: string;
-    fields: (DetailField | string)[];
-}
-/**
- * Action definition for DetailPanel
- */
-export interface DetailPanelAction {
-    label: string;
-    icon?: LucideIcon;
-    onClick?: () => void;
-    /** Event to emit via event bus */
-    event?: string;
-    /** Navigation URL */
-    navigatesTo?: string;
-    /** Button variant (primary for main action, others for secondary) */
-    variant?: "primary" | "secondary" | "ghost" | "danger";
-}
-/**
- * Field definition for unified interface - can be a simple string or object
- */
-export type FieldDef = string | {
-    key: string;
-    header?: string;
-};
-export interface DetailPanelProps extends Omit<EntityDisplayProps<Record<string, unknown>>, 'data'> {
-    title?: string;
-    subtitle?: string;
-    status?: {
-        label: string;
-        variant?: "default" | "success" | "warning" | "danger" | "info";
-    };
-    avatar?: React.ReactNode;
-    sections?: readonly DetailSection[];
-    /** Unified actions array - first action with variant='primary' is the main action */
-    actions?: readonly DetailPanelAction[];
-    footer?: React.ReactNode;
-    slideOver?: boolean;
-    /** Fields to display - accepts string[], {key, header}[], or DetailField[] */
-    fields?: readonly (FieldDef | DetailField)[];
-    /** Alias for fields - backwards compatibility */
-    fieldNames?: readonly string[];
-    /** Data object provided by the trait via render-ui */
-    data?: Record<string, unknown> | unknown;
-    /** Initial data for edit mode (passed by compiler) */
-    initialData?: Record<string, unknown> | unknown;
-    /** Display mode (passed by compiler) */
-    mode?: string;
-    /** Panel position (for drawer/sidebar placement) */
-    position?: "left" | "right";
-    /** Panel width (CSS value, e.g., '400px', '50%') */
-    width?: string;
-}
-export declare const DetailPanel: React.FC<DetailPanelProps>;

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

@@ -1,60 +0,0 @@
-/**
- * DocumentViewer Organism Component
- *
- * A document viewer for displaying PDFs, documents, and rich text content.
- * Uses iframe for PDF rendering (necessary) and atoms for all surrounding UI.
- *
- * 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";
-export type DocumentType = "pdf" | "text" | "html" | "markdown";
-export interface DocumentAction {
-    label: string;
-    event?: string;
-    navigatesTo?: string;
-    variant?: "primary" | "secondary" | "ghost";
-}
-export interface DocumentViewerProps {
-    /** Document title */
-    title?: string;
-    /** Document URL (for PDF/external documents) */
-    src?: string;
-    /** Document content (for text/html/markdown) */
-    content?: string;
-    /** Document type */
-    documentType?: DocumentType;
-    /** Current page (for multi-page documents) */
-    currentPage?: number;
-    /** Total pages */
-    totalPages?: number;
-    /** Viewer height */
-    height?: number | string;
-    /** Show toolbar */
-    showToolbar?: boolean;
-    /** Show download button */
-    showDownload?: boolean;
-    /** Show print button */
-    showPrint?: boolean;
-    /** Actions */
-    actions?: readonly DocumentAction[];
-    /** Multiple documents (tabbed view) */
-    documents?: readonly {
-        label: string;
-        src?: string;
-        content?: string;
-        documentType?: DocumentType;
-    }[];
-    /** 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 DocumentViewer: React.FC<DocumentViewerProps>;

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

@@ -1,39 +0,0 @@
-/**
- * DrawerSlot Component
- *
- * Wraps drawer slot content in a proper Drawer component.
- * Used by trait-driven pages to display drawer UI from render_ui effects.
- *
- * Handles:
- * - Auto-open when content is present
- * - Dispatches CLOSE/CANCEL events when closed
- * - Extracts title from Form or DetailPanel components
- * - Configurable position and size
- */
-import React from 'react';
-import { DrawerPosition, DrawerSize } from '../molecules/Drawer';
-export interface DrawerSlotProps {
-    /** Content to display in the drawer */
-    children?: React.ReactNode;
-    /** Override drawer title (extracted from children if not provided) */
-    title?: string;
-    /** Drawer position */
-    position?: DrawerPosition;
-    /** Drawer size */
-    size?: DrawerSize;
-    /** Custom class name */
-    className?: string;
-    /** Loading state */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
-}
-/**
- * DrawerSlot - Wrapper for drawer slot content
- *
- * Automatically shows drawer when children are present,
- * and dispatches close events when drawer is dismissed.
- */
-export declare const DrawerSlot: React.FC<DrawerSlotProps>;

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

@@ -1,203 +0,0 @@
-/**
- * Form Organism Component
- *
- * A form container component with submit/reset handling.
- * Supports both children-based and schema-based form generation.
- * Renders correct input types based on field definitions including relations.
- *
- * Extended for inspection forms with:
- * - Conditional field visibility via S-expressions
- * - Hidden calculations that emit GLOBAL_VARIABLE_SET events
- * - Violation triggers that emit VIOLATION_DETECTED events
- * - Nested sections with collapsible support
- */
-import React from "react";
-import { type SelectOption } from "../atoms/Select";
-import { type RelationOption } from "../molecules/RelationSelect";
-import { type SExpr } from "@almadar/evaluator";
-/**
- * S-Expression type for conditional logic (re-export from @almadar/evaluator)
- */
-export type SExpression = SExpr;
-/**
- * Form-specific evaluation context
- */
-export interface FormEvaluationContext {
-    formValues: Record<string, unknown>;
-    globalVariables: Record<string, unknown>;
-    localVariables?: Record<string, unknown>;
-    entity?: Record<string, unknown>;
-}
-/**
- * Hidden calculation definition
- */
-export interface HiddenCalculation {
-    variableName: string;
-    expression: SExpression;
-    triggerFields: string[];
-}
-/**
- * Violation definition
- */
-export interface ViolationDefinition {
-    law: string;
-    article: string;
-    actionType: "measure" | "admin" | "penalty";
-    message: string;
-}
-/**
- * Violation trigger definition
- */
-export interface ViolationTrigger {
-    condition: SExpression;
-    violation: ViolationDefinition;
-    fieldId?: string;
-}
-/**
- * Form section definition for nested sections
- */
-export interface FormSection {
-    id: string;
-    title: string;
-    condition?: SExpression;
-    fields: SchemaField[];
-    collapsible?: boolean;
-}
-/**
- * Form tab definition for tabbed inspection forms
- */
-export interface FormTabDefinition {
-    /** Unique tab identifier */
-    id: string;
-    /** Tab display label */
-    label: string;
-    /** Icon name for the tab (from Icon component) */
-    icon?: string;
-    /** Sections within this tab */
-    sections: FormSection[];
-    /** Condition for showing/hiding the entire tab */
-    condition?: SExpression;
-    /** Badge count or text to display on tab */
-    badge?: string | number;
-    /** Whether this tab has validation errors */
-    hasErrors?: boolean;
-}
-/**
- * Relation configuration for foreign key fields
- */
-export interface RelationConfig {
-    /** Target entity name (e.g., 'User', 'Project') */
-    entity: string;
-    /** Field on target entity to display (defaults to 'name') */
-    displayField?: string;
-    /** Cardinality: one-to-one or one-to-many */
-    cardinality?: "one" | "many";
-}
-/**
- * Schema field definition
- * Supports both 'name' and 'field' for compatibility with different schema formats
- */
-export interface SchemaField {
-    /** Field name (primary) */
-    name?: string;
-    /** Field name (alias for compatibility) */
-    field?: string;
-    /** Display label */
-    label?: string;
-    /** Field type (string, number, email, date, boolean, enum, relation, etc.) */
-    type?: string;
-    /** Input type for rendering (text, select, textarea, checkbox, etc.) */
-    inputType?: string;
-    /** Placeholder text */
-    placeholder?: string;
-    /** Whether field is required */
-    required?: boolean;
-    /** Default value */
-    defaultValue?: unknown;
-    /** Options for select/enum fields - accepts readonly for generated const arrays */
-    options?: readonly SelectOption[];
-    /** Enum values (alternative to options, just strings) - accepts readonly for generated const arrays */
-    values?: readonly string[];
-    /** Relation configuration for foreign key references */
-    relation?: RelationConfig;
-    /** Minimum value (for number) or length (for string) */
-    min?: number;
-    /** Maximum value or length */
-    max?: number;
-    /** Pattern for validation */
-    pattern?: string;
-    /** Validation rules */
-    validation?: Record<string, unknown>;
-    /** Whether field is readonly (displays value but cannot edit) */
-    readonly?: boolean;
-    /** Whether field is disabled (alternative to readonly for compatibility) */
-    disabled?: boolean;
-}
-/**
- * Form is the ONE EXCEPTION to the "no internal state" rule for organisms.
- * It manages local `formData` state for field input tracking.
- * See EntityDisplayProps in ./types.ts for documentation.
- */
-export interface FormProps extends Omit<React.FormHTMLAttributes<HTMLFormElement>, "onSubmit"> {
-    /** Form fields (traditional React children) */
-    children?: React.ReactNode;
-    /** Submit event name for trait dispatch (emitted via eventBus as UI:{onSubmit}) */
-    onSubmit?: string;
-    /** Cancel event name for trait dispatch (emitted via eventBus as UI:{onCancel}) */
-    onCancel?: string;
-    /** Form layout */
-    layout?: "vertical" | "horizontal" | "inline";
-    /** Gap between fields */
-    gap?: "sm" | "md" | "lg";
-    /** Additional CSS classes */
-    className?: string;
-    /** Entity type name (schema format) */
-    entity?: string;
-    /** Form mode - 'create' for new records, 'edit' for updating existing */
-    mode?: "create" | "edit";
-    /** Fields definition (schema format) - accepts readonly for generated const arrays */
-    fields?: readonly Readonly<SchemaField>[];
-    /** Initial form data */
-    initialData?: Record<string, unknown> | unknown;
-    /** Loading state */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Submit button label */
-    submitLabel?: string;
-    /** Cancel button label (if provided, shows cancel button) */
-    cancelLabel?: string;
-    /** Show cancel button (defaults to true for schema forms) */
-    showCancel?: boolean;
-    /** Form title (used by ModalSlot to extract title) */
-    title?: string;
-    /** Event to dispatch on successful submit (defaults to 'SAVE') */
-    submitEvent?: string;
-    /** Event to dispatch on cancel (defaults to 'CANCEL') */
-    cancelEvent?: string;
-    /** Data for relation fields: { fieldName: RelationOption[] } */
-    relationsData?: Record<string, readonly RelationOption[]>;
-    /** Loading state for relation data: { fieldName: boolean } */
-    relationsLoading?: Record<string, boolean>;
-    /** Map of fieldId → S-expression condition for conditional field display (boolean true means enabled but config loaded separately) */
-    conditionalFields?: Record<string, SExpression> | boolean;
-    /** Hidden calculations that emit GLOBAL_VARIABLE_SET on field change (boolean true means enabled but config loaded separately) */
-    hiddenCalculations?: HiddenCalculation[] | boolean;
-    /** Violation conditions that emit VIOLATION_DETECTED when met (boolean true means enabled but config loaded separately) */
-    violationTriggers?: ViolationTrigger[] | boolean;
-    /** Context for S-expression evaluation - accepts flexible types from generated code */
-    evaluationContext?: FormEvaluationContext | Record<string, unknown>;
-    /** Nested form sections with optional conditions */
-    sections?: FormSection[];
-    /** Callback when any field value changes */
-    onFieldChange?: (change: {
-        fieldId: string;
-        value: unknown;
-        formValues: Record<string, unknown>;
-    }) => void;
-    /** Config path for form configuration (schema-driven) */
-    configPath?: string;
-    /** Whether the form supports repeatable entries */
-    repeatable?: boolean;
-}
-export declare const Form: React.FC<FormProps>;

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

@@ -1,59 +0,0 @@
-import React from "react";
-export interface FormSectionProps {
-    /** Section title */
-    title?: string;
-    /** Section description */
-    description?: string;
-    /** Form fields */
-    children: React.ReactNode;
-    /** Collapsible */
-    collapsible?: boolean;
-    /** Default collapsed state */
-    defaultCollapsed?: boolean;
-    /** Use card wrapper */
-    card?: boolean;
-    /** Grid columns for fields */
-    columns?: 1 | 2 | 3;
-    className?: string;
-    /** Loading state */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Entity name */
-    entity?: string;
-}
-export declare const FormSection: React.FC<FormSectionProps>;
-/**
- * Form layout with multiple sections
- */
-export interface FormLayoutProps {
-    children: React.ReactNode;
-    /** Show section dividers */
-    dividers?: boolean;
-    className?: string;
-    /** Loading state */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Entity name */
-    entity?: string;
-}
-export declare const FormLayout: React.FC<FormLayoutProps>;
-/**
- * Form actions bar (submit/cancel buttons)
- */
-export interface FormActionsProps {
-    children: React.ReactNode;
-    /** Sticky at bottom */
-    sticky?: boolean;
-    /** Alignment */
-    align?: "left" | "right" | "between" | "center";
-    className?: string;
-    /** Loading state */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Entity name */
-    entity?: string;
-}
-export declare const FormActions: React.FC<FormActionsProps>;

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

@@ -1,69 +0,0 @@
-/**
- * GraphCanvas Organism Component
- *
- * A force-directed graph visualization component for node-link data.
- * Uses canvas (necessary for performant graph rendering) with atom wrappers.
- *
- * 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";
-export interface GraphNode {
-    id: string;
-    label?: string;
-    group?: string;
-    color?: string;
-    size?: number;
-    /** Position (optional, computed if missing) */
-    x?: number;
-    y?: number;
-}
-export interface GraphEdge {
-    source: string;
-    target: string;
-    label?: string;
-    weight?: number;
-    color?: string;
-}
-export interface GraphAction {
-    label: string;
-    event?: string;
-    navigatesTo?: string;
-    variant?: "primary" | "secondary" | "ghost";
-}
-export interface GraphCanvasProps {
-    /** Graph title */
-    title?: string;
-    /** Graph nodes */
-    nodes?: readonly GraphNode[];
-    /** Graph edges */
-    edges?: readonly GraphEdge[];
-    /** Canvas height */
-    height?: number;
-    /** Show node labels */
-    showLabels?: boolean;
-    /** Enable zoom/pan */
-    interactive?: boolean;
-    /** Enable node dragging */
-    draggable?: boolean;
-    /** Actions */
-    actions?: readonly GraphAction[];
-    /** On node click */
-    onNodeClick?: (node: GraphNode) => void;
-    /** Node click event */
-    nodeClickEvent?: string;
-    /** Layout algorithm */
-    layout?: "force" | "circular" | "grid";
-    /** 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 GraphCanvas: React.FC<GraphCanvasProps>;

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

@@ -1,110 +0,0 @@
-/**
- * Header Organism Component
- *
- * A header component for mobile/responsive layouts with menu toggle, brand, and user avatar.
- * Styled to match the main Layout component's mobile header.
- */
-import React from "react";
-import type { LucideIcon } from "lucide-react";
-export interface HeaderProps {
-    /**
-     * Logo/Brand content
-     */
-    logo?: React.ReactNode;
-    /**
-     * Logo image source
-     */
-    logoSrc?: string;
-    /**
-     * Brand/App name
-     */
-    brandName?: string;
-    /**
-     * Navigation items (for desktop header variant)
-     */
-    navigationItems?: Array<{
-        label: string;
-        href?: string;
-        onClick?: () => void;
-        icon?: LucideIcon;
-        badge?: string | number;
-        active?: boolean;
-    }>;
-    /**
-     * Show menu toggle button
-     * @default true
-     */
-    showMenuToggle?: boolean;
-    /**
-     * Is menu open (for toggle icon)
-     */
-    isMenuOpen?: boolean;
-    /**
-     * Menu toggle callback
-     */
-    onMenuToggle?: () => void;
-    /**
-     * Show search input
-     * @default false
-     */
-    showSearch?: boolean;
-    /**
-     * Search placeholder
-     */
-    searchPlaceholder?: string;
-    /**
-     * Search callback
-     */
-    onSearch?: (value: string) => void;
-    /**
-     * User avatar configuration
-     */
-    userAvatar?: {
-        src?: string;
-        alt?: string;
-        initials?: string;
-    };
-    /**
-     * User name (display name or email)
-     */
-    userName?: string;
-    /**
-     * Callback when user avatar is clicked
-     */
-    onUserClick?: () => void;
-    /**
-     * Action buttons (right side)
-     */
-    actions?: React.ReactNode;
-    /**
-     * Sticky header
-     * @default true
-     */
-    sticky?: boolean;
-    /**
-     * Variant - mobile shows menu toggle, desktop shows full nav
-     * @default 'mobile'
-     */
-    variant?: "mobile" | "desktop";
-    /**
-     * Callback when logo/brand is clicked
-     */
-    onLogoClick?: () => void;
-    /**
-     * Additional CSS classes
-     */
-    className?: string;
-    /**
-     * Loading state indicator (closed circuit)
-     */
-    isLoading?: boolean;
-    /**
-     * Error state (closed circuit)
-     */
-    error?: Error | null;
-    /**
-     * Entity name for schema-driven auto-fetch (closed circuit)
-     */
-    entity?: string;
-}
-export declare const Header: React.FC<HeaderProps>;

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

@@ -1,60 +0,0 @@
-/**
- * JazariStateMachine — Al-Jazari themed state machine diagram.
- *
- * Thin wrapper around StateMachineView that:
- * 1. Extracts a state machine from an orbital schema (or accepts a trait directly)
- * 2. Converts it to DomLayoutData via the visualizer lib
- * 3. Applies Al-Jazari brass/gold/lapis color theme
- * 4. Renders gear-shaped state nodes via the renderStateNode prop
- */
-import React from 'react';
-import type { EntityDisplayProps } from './types';
-interface SmState {
-    name: string;
-    isInitial?: boolean;
-    isTerminal?: boolean;
-    isFinal?: boolean;
-}
-interface SmTransition {
-    from: string;
-    to: string;
-    event: string;
-    guard?: unknown;
-    effects?: unknown[];
-}
-interface SmStateMachine {
-    states: SmState[];
-    transitions: SmTransition[];
-}
-interface SmTrait {
-    name: string;
-    stateMachine?: SmStateMachine;
-    linkedEntity?: string;
-}
-interface SmEntity {
-    name: string;
-    fields?: Array<{
-        name: string;
-    }>;
-}
-interface SmOrbital {
-    entity?: SmEntity;
-    traits?: SmTrait[];
-}
-interface SmSchema {
-    orbitals?: SmOrbital[];
-}
-export interface JazariStateMachineProps extends EntityDisplayProps {
-    /** Full schema — extracts first trait's state machine */
-    schema?: SmSchema;
-    /** Or pass a single trait directly */
-    trait?: SmTrait;
-    /** Which trait to visualize (default: 0) */
-    traitIndex?: number;
-    /** Override entity field labels */
-    entityFields?: string[];
-    /** Text direction (default: 'ltr') */
-    direction?: 'ltr' | 'rtl';
-}
-export declare const JazariStateMachine: React.FC<JazariStateMachineProps>;
-export {};