@almadar/ui 5.111.0 → 5.113.0

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

@@ -1,20 +0,0 @@
-/**
- * DocBreadcrumb Molecule Component
- *
- * A breadcrumb navigation component for documentation pages.
- * Composes from HStack, Typography, and Icon atoms.
- */
-import React from 'react';
-export interface DocBreadcrumbItem {
-    /** Display label */
-    label: string;
-    /** Navigation href (omit for the current/last item) */
-    href?: string;
-}
-export interface DocBreadcrumbProps {
-    /** Breadcrumb path items, last item is treated as current page */
-    items: DocBreadcrumbItem[];
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare const DocBreadcrumb: React.FC<DocBreadcrumbProps>;

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

@@ -1,21 +0,0 @@
-/**
- * DocPagination Molecule
- *
- * Previous/Next navigation links for documentation pages.
- * Composed from HStack, Box, VStack, Icon, and Typography atoms.
- */
-import React from 'react';
-export interface DocPaginationLink {
-    label: string;
-    href: string;
-    category?: string;
-}
-export interface DocPaginationProps {
-    /** Previous page link */
-    prev?: DocPaginationLink;
-    /** Next page link */
-    next?: DocPaginationLink;
-    /** Additional class names */
-    className?: string;
-}
-export declare function DocPagination({ prev, next, className }: DocPaginationProps): React.JSX.Element | null;

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

@@ -1,22 +0,0 @@
-/**
- * DocSearch — documentation search input with inline results dropdown (distinct from SearchInput).
- * SearchInput emits bus events for entity-list filtering with debounce.
- * DocSearch drives a callback-based result list with keyboard navigation and
- * popover dropdown; designed for docs site navigation, not data-list filtering.
- */
-import React from 'react';
-export interface DocSearchResult {
-    title: string;
-    href: string;
-    excerpt?: string;
-    category?: string;
-}
-export interface DocSearchProps {
-    /** Placeholder text for the input */
-    placeholder?: string;
-    /** Callback invoked with the search query, returns results */
-    onSearch?: (query: string) => DocSearchResult[] | Promise<DocSearchResult[]>;
-    /** Additional class names */
-    className?: string;
-}
-export declare function DocSearch({ placeholder, onSearch, className, }: DocSearchProps): React.JSX.Element;

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

@@ -1,24 +0,0 @@
-/**
- * DocSidebar — collapsible documentation navigation sidebar.
- * Renders a nested item tree with expand/collapse per category and active-item
- * highlighting. Not a generic nav; it owns doc-site-specific UX (uppercase
- * category headers, indented children, active highlight).
- */
-import React from 'react';
-export interface DocSidebarItem {
-    /** Display label */
-    label: string;
-    /** Navigation href */
-    href?: string;
-    /** Nested child items (makes this a collapsible category) */
-    items?: DocSidebarItem[];
-    /** Whether this item is currently active */
-    active?: boolean;
-}
-export interface DocSidebarProps {
-    /** Sidebar navigation items */
-    items: DocSidebarItem[];
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare const DocSidebar: React.FC<DocSidebarProps>;

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

@@ -1,24 +0,0 @@
-/**
- * DocTOC Molecule Component
- *
- * A table of contents component with active section highlighting.
- * Composes from Box, VStack, and Typography atoms.
- */
-import React from 'react';
-export interface DocTOCItem {
-    /** Heading element id to link to */
-    id: string;
-    /** Display label */
-    label: string;
-    /** Heading level: 2 for h2, 3 for h3, etc. */
-    level: number;
-}
-export interface DocTOCProps {
-    /** Table of contents items */
-    items: DocTOCItem[];
-    /** Currently active section id */
-    activeId?: string;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare const DocTOC: React.FC<DocTOCProps>;

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

@@ -1,61 +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";
-import type { AssetUrl } from "@almadar/core";
-import type { UiError } from '../atoms/types';
-export type DocumentType = "pdf" | "text" | "html" | "markdown";
-export interface DocumentAction {
-    label: string;
-    event?: string;
-    navigatesTo?: string;
-    variant?: "primary" | "secondary" | "ghost";
-}
-export interface DocumentItem {
-    label: string;
-    src?: AssetUrl;
-    content?: string;
-    documentType?: DocumentType;
-}
-export interface DocumentViewerProps {
-    /** Document title */
-    title?: string;
-    /** Document URL (for PDF/external documents) */
-    src?: AssetUrl;
-    /** 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 DocumentItem[];
-    /** Loading state */
-    isLoading?: boolean;
-    /** Error state */
-    error?: UiError | null;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare const DocumentViewer: React.FC<DocumentViewerProps>;

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

@@ -1,47 +0,0 @@
-/**
- * Drawer Molecule Component
- *
- * A slide-in drawer component for displaying secondary content.
- * Used by the UI Slot system for render_ui effects targeting the drawer slot.
- *
- * Features:
- * - Left/right positioning
- * - Configurable width
- * - Overlay backdrop
- * - Click-outside to dismiss
- * - Slide animation
- * - Escape key to close
- *
- * @packageDocumentation
- */
-import React from "react";
-import type { EventKey } from "@almadar/core";
-export type DrawerPosition = "left" | "right";
-export type DrawerSize = "sm" | "md" | "lg" | "xl" | "full";
-export interface DrawerProps {
-    /** Whether the drawer is open (defaults to true when rendered by slot wrapper) */
-    isOpen?: boolean;
-    /** Callback when drawer should close (injected by slot wrapper) */
-    onClose?: () => void;
-    /** Drawer title */
-    title?: string;
-    /** Drawer content (can be empty if using slot content) */
-    children?: React.ReactNode;
-    /** Footer content */
-    footer?: React.ReactNode;
-    /** Position (left or right) */
-    position?: DrawerPosition;
-    /** Width (CSS value or preset size) */
-    width?: string | DrawerSize;
-    /** Show close button */
-    showCloseButton?: boolean;
-    /** Close on overlay click */
-    closeOnOverlayClick?: boolean;
-    /** Close on escape key */
-    closeOnEscape?: boolean;
-    /** Additional class name */
-    className?: string;
-    /** Declarative close event — emits UI:{closeEvent} via eventBus when drawer should close */
-    closeEvent?: EventKey;
-}
-export declare const Drawer: React.FC<DrawerProps>;

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

@@ -1,36 +0,0 @@
-/**
- * EdgeDecoration Molecule
- *
- * Standalone SVG decorative elements positioned on section edges.
- * Unlike GeometricPattern (which tiles small units), these are large
- * singular shapes placed at specific positions: left edge, right edge,
- * or both.
- *
- * Variants:
- *   arch       — Concentric pointed mihrab arches (half-circles opening inward)
- *   vine       — Flowing arabesque scroll tendrils running vertically
- *   lattice    — Fine curved diamond lattice mesh
- *
- * Each variant renders as an absolutely-positioned SVG on one or both
- * sides of the parent container.
- */
-import React from 'react';
-import type { ColorToken } from '../atoms/types';
-export type EdgeVariant = 'arch' | 'vine' | 'lattice';
-export type EdgeSide = 'left' | 'right' | 'both';
-export interface EdgeDecorationProps {
-    /** Which decorative element */
-    variant?: EdgeVariant;
-    /** Which side(s) to place the decoration */
-    side?: EdgeSide;
-    /** Overall opacity (default: 0.15) */
-    opacity?: number;
-    /** Semantic palette token or a raw CSS color value for the stroke. */
-    color?: ColorToken | string;
-    /** Stroke width */
-    strokeWidth?: number;
-    /** Width of the decoration area as percentage of container (default: 15) */
-    width?: number;
-    className?: string;
-}
-export declare const EdgeDecoration: React.FC<EdgeDecorationProps>;

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

@@ -1,29 +0,0 @@
-import React from "react";
-import type { EventEmit } from "@almadar/core";
-import type { IconInput } from "../atoms/index";
-export type EmptyStateLook = "illustrated" | "icon-only" | "text-only" | "mascot";
-export interface EmptyStateProps {
-    /**
-     * Icon to display. Accepts either:
-     * - A Lucide icon component (LucideIcon)
-     * - A string icon name (e.g., "check-circle", "x-circle")
-     */
-    icon?: IconInput;
-    /** Primary text to display - use title or message (message is alias for backwards compat) */
-    title?: string;
-    /** Alias for title - used by schema patterns */
-    message?: string;
-    description?: string;
-    actionLabel?: string;
-    onAction?: () => void;
-    className?: string;
-    /** Destructive styling for confirmation dialogs */
-    destructive?: boolean;
-    /** Variant for color styling */
-    variant?: "default" | "success" | "error" | "warning" | "info";
-    /** Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked */
-    actionEvent?: EventEmit<Record<string, never>>;
-    /** Layer 2 visual treatment — orthogonal to the semantic variant (which carries status color). */
-    look?: EmptyStateLook;
-}
-export declare const EmptyState: React.FC<EmptyStateProps>;

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

@@ -1,54 +0,0 @@
-import React from 'react';
-import type { ReactNode, ErrorInfo } from 'react';
-export interface ErrorBoundaryProps {
-    /** Content to render when no error */
-    children: ReactNode;
-    /** Fallback UI when an error is caught — ReactNode or render function */
-    fallback?: ReactNode | ((error: Error, reset: () => void) => ReactNode);
-    /** Additional CSS classes for the wrapper */
-    className?: string;
-    /** Called when an error is caught (for logging/telemetry) */
-    onError?: (error: Error, errorInfo: ErrorInfo) => void;
-}
-interface ErrorBoundaryState {
-    error: Error | null;
-}
-/**
- * ErrorBoundary — catches React render errors in child components.
- *
- * Uses `getDerivedStateFromError` and `componentDidCatch` to capture errors
- * and render a fallback UI. Supports both static ReactNode fallbacks and
- * render-function fallbacks that receive the error and a reset function.
- *
- * @example
- * ```tsx
- * // Static fallback
- * <ErrorBoundary fallback={<Alert variant="error">Something broke</Alert>}>
- *   <MyComponent />
- * </ErrorBoundary>
- *
- * // Render function fallback with reset
- * <ErrorBoundary fallback={(error, reset) => (
- *   <VStack>
- *     <Typography>Error: {error.message}</Typography>
- *     <Button onClick={reset}>Try Again</Button>
- *   </VStack>
- * )}>
- *   <MyComponent />
- * </ErrorBoundary>
- *
- * // Default fallback (uses ErrorState molecule)
- * <ErrorBoundary>
- *   <MyComponent />
- * </ErrorBoundary>
- * ```
- */
-export declare class ErrorBoundary extends React.Component<ErrorBoundaryProps, ErrorBoundaryState> {
-    static displayName: string;
-    constructor(props: ErrorBoundaryProps);
-    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
-    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
-    private reset;
-    render(): ReactNode;
-}
-export default ErrorBoundary;

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

@@ -1,14 +0,0 @@
-import React from "react";
-import type { EventEmit } from "@almadar/core";
-export interface ErrorStateProps {
-    title?: string;
-    /** Error message to display */
-    message?: string;
-    /** Alias for message (schema compatibility) */
-    description?: string;
-    onRetry?: () => void;
-    className?: string;
-    /** Declarative retry event — emits UI:{retryEvent} via eventBus when retry button is clicked */
-    retryEvent?: EventEmit<Record<string, never>>;
-}
-export declare const ErrorState: React.FC<ErrorStateProps>;

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

@@ -1,19 +0,0 @@
-/**
- * FeatureGrid Molecule Component
- *
- * A responsive grid layout for displaying multiple FeatureCards.
- * Composes SimpleGrid and FeatureCard molecules.
- */
-import React from 'react';
-import { type FeatureCardProps } from '../../marketing/molecules/FeatureCard';
-export interface FeatureGridProps {
-    /** Array of feature card configurations */
-    items: FeatureCardProps[];
-    /** Number of grid columns */
-    columns?: 2 | 3 | 4 | 6;
-    /** Gap between grid items */
-    gap?: 'sm' | 'md' | 'lg';
-    /** Additional class names */
-    className?: string;
-}
-export declare const FeatureGrid: React.FC<FeatureGridProps>;

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

@@ -1,37 +0,0 @@
-/**
- * FileTree Molecule
- *
- * A filesystem tree navigator with folder expand/collapse, file-type icons,
- * and click-to-select. Used by the Workspace tab to browse the agent's
- * workspace directory.
- *
- * Follows atomic design: composes Box, Icon, Typography atoms.
- */
-import React from 'react';
-export interface FileTreeNode {
-    /** File or directory name */
-    name: string;
-    /** Relative path from workspace root */
-    path: string;
-    /** 'file' or 'dir' */
-    type: 'file' | 'dir';
-    /** Children (only for directories) */
-    children?: FileTreeNode[];
-    /** File size in bytes (optional, for display) */
-    size?: number;
-    /** Detected language for syntax highlighting */
-    language?: string;
-}
-export interface FileTreeProps {
-    /** The tree data */
-    tree: FileTreeNode[];
-    /** Currently selected file path */
-    selectedPath?: string;
-    /** Called when a file is clicked */
-    onFileSelect?: (path: string) => void;
-    /** CSS class */
-    className?: string;
-    /** Indent size per level in px (default: 16) */
-    indent?: number;
-}
-export declare const FileTree: React.FC<FileTreeProps>;

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

@@ -1,61 +0,0 @@
-/**
- * FilterGroup Molecule Component
- *
- * A component for filtering entity data. Composes atoms (Button, Select, Badge, HStack)
- * and follows the design system using CSS variables.
- *
- * Implements the Closed Circuit principle:
- * - FilterGroup updates QuerySingleton filters via query prop
- * - FilterGroup emits UI:FILTER events for trait state machines
- * - entity-list/entity-cards read filtered data via query prop
- *
- * Supports Query Singleton pattern via `query` prop for std/Filter behavior.
- */
-import React from "react";
-/**
- * Layer 2 visual treatment for the filter-group pattern — orthogonal to the
- * semantic `variant` (which conveys layout / role).
- */
-export type FilterGroupLook = "toolbar" | "chips" | "pills" | "popover-trigger" | "inline-column-header";
-/** Filter definition from schema */
-export interface FilterDefinition {
-    field: string;
-    label: string;
-    /** Filter type - 'text' free-text input, 'date' renders a date picker, 'date-range'/'daterange' renders two date pickers */
-    filterType?: "text" | "select" | "toggle" | "checkbox" | "date" | "daterange" | "date-range";
-    /** Alias for filterType (schema compatibility) */
-    type?: "text" | "select" | "toggle" | "checkbox" | "date" | "daterange" | "date-range";
-    /** Options for select/toggle filters */
-    options?: readonly string[];
-}
-export interface FilterGroupProps {
-    /** Entity name to filter */
-    entity: string;
-    /** Filter definitions from schema */
-    filters: readonly FilterDefinition[];
-    /** Callback when a filter changes - for EntityStore integration */
-    onFilterChange?: (field: string, value: string | null) => void;
-    /** Callback to clear all filters */
-    onClearAll?: () => void;
-    /** Additional CSS classes */
-    className?: string;
-    /** Variant style */
-    variant?: "default" | "compact" | "pills" | "vertical";
-    /** Show filter icon */
-    showIcon?: boolean;
-    /**
-     * Query singleton binding for state management.
-     * When provided, syncs filter state with the query singleton.
-     * Example: "@TaskQuery"
-     */
-    query?: string;
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Layer 2 visual treatment — orthogonal to the semantic variant. */
-    look?: FilterGroupLook;
-}
-/**
- * FilterGroup - Renders filter controls for entity data
- * Uses atoms: Button, Select, Badge, HStack
- */
-export declare const FilterGroup: React.FC<FilterGroupProps>;

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

@@ -1,43 +0,0 @@
-/**
- * Flex — full-surface flexbox primitive (distinct from Stack).
- * Stack covers the 95% case (VStack/HStack with gap/align/justify).
- * Flex exposes direction, wrap, grow, shrink, basis individually; use it
- * when you need those extra axes or inline-flex behavior.
- */
-import React from 'react';
-export type FlexDirection = 'row' | 'row-reverse' | 'col' | 'col-reverse';
-export type FlexWrap = 'nowrap' | 'wrap' | 'wrap-reverse';
-export type FlexAlign = 'start' | 'center' | 'end' | 'stretch' | 'baseline';
-export type FlexJustify = 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
-export type FlexGap = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
-export interface FlexProps {
-    /** Flex direction */
-    direction?: FlexDirection;
-    /** Flex wrap */
-    wrap?: FlexWrap;
-    /** Align items */
-    align?: FlexAlign;
-    /** Justify content */
-    justify?: FlexJustify;
-    /** Gap between items */
-    gap?: FlexGap;
-    /** Inline flex */
-    inline?: boolean;
-    /** Flex grow */
-    grow?: boolean | number;
-    /** Flex shrink */
-    shrink?: boolean | number;
-    /** Flex basis */
-    basis?: string | number;
-    /** Custom class name */
-    className?: string;
-    /** Children elements */
-    children: React.ReactNode;
-    /** HTML element to render as */
-    as?: React.ElementType;
-}
-/**
- * Flex - Full-featured flexbox container
- */
-export declare const Flex: React.FC<FlexProps>;
-export default Flex;

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

@@ -1,24 +0,0 @@
-/**
- * FlipCard — two-sided card molecule with front/back faces (distinct from FlipContainer).
- * FlipContainer is the raw 3D-transform atom; FlipCard wraps it with card styling,
- * absolute face positioning, and `front`/`back` ReactNode props for lolo consumers.
- */
-import React from 'react';
-export interface FlipCardProps {
-    /** Content rendered on the front face */
-    front: React.ReactNode;
-    /** Content rendered on the back face */
-    back: React.ReactNode;
-    /** Controlled flip state */
-    flipped?: boolean;
-    /** Callback when the card is clicked to flip */
-    onFlip?: () => void;
-    /** Optional className for the outer container */
-    className?: string;
-    /** Card height as a Tailwind class (default: 'h-64') */
-    height?: string;
-}
-export declare const FlipCard: {
-    ({ front, back, flipped, onFlip, className, height, }: FlipCardProps): React.JSX.Element;
-    displayName: string;
-};

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

@@ -1,83 +0,0 @@
-/**
- * FloatingActionButton Molecule Component
- *
- * A floating action button that can expand into multiple actions vertically.
- * Uses Button atom.
- *
- * Props mirror Button's `action`/`actionPayload` convention so a schema can
- * declare `{ type: "floating-action-button", action: "INIT", icon: "plus" }`
- * and have the FAB emit `UI:INIT` via the event bus on click — same shape
- * any other clickable surface uses.
- */
-import React from "react";
-import type { EventKey, EventPayload } from "@almadar/core";
-import type { IconInput } from "../atoms/index";
-export interface FloatingAction {
-    /**
-     * Action ID
-     */
-    id: string;
-    /**
-     * Action label
-     */
-    label: string;
-    /**
-     * Action icon — Lucide icon name or component
-     */
-    icon: IconInput;
-    /**
-     * Action click handler
-     */
-    onClick?: () => void;
-    /** Event name to emit when clicked (for trait state machine integration) */
-    event?: string;
-    /**
-     * Action variant
-     */
-    variant?: "primary" | "secondary" | "success" | "danger" | "warning";
-}
-export interface FloatingActionButtonProps {
-    /**
-     * Declarative event name. When set, clicking the FAB emits `UI:{action}`
-     * via the event bus and (if also provided) calls `onClick`. Mirrors the
-     * Button atom's `action` prop so schemas can write
-     * `{ type: "floating-action-button", action: "INIT" }` uniformly.
-     */
-    action?: EventKey;
-    /**
-     * Payload to include with the dispatched action event.
-     */
-    actionPayload?: EventPayload;
-    /**
-     * Multiple actions. When provided, the button expands to show all of them.
-     */
-    actions?: FloatingAction[];
-    /**
-     * Icon: a canonical icon name string (resolved by Button) or a Lucide component.
-     */
-    icon?: IconInput;
-    /**
-     * Optional direct click handler. Runs after the action emit when both are
-     * present.
-     */
-    onClick?: () => void;
-    /**
-     * Visual variant.
-     */
-    variant?: "primary" | "secondary" | "success" | "danger" | "warning";
-    /**
-     * Optional label shown via `aria-label` (visually hidden in single-action
-     * mode; rendered as a tooltip beside expanded actions in multi-action mode).
-     */
-    label?: string;
-    /**
-     * Button position
-     * @default 'bottom-right'
-     */
-    position?: "bottom-right" | "bottom-left" | "bottom-center" | "top-right" | "top-left" | "top-center" | string;
-    /**
-     * Additional CSS classes
-     */
-    className?: string;
-}
-export declare const FloatingActionButton: React.FC<FloatingActionButtonProps>;

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

@@ -1,16 +0,0 @@
-/**
- * FormField Molecule Component
- *
- * A form field wrapper with label, hint, and error message support.
- * **Atomic Design**: Composed using Label and Typography atoms.
- */
-import React from 'react';
-export interface FormFieldProps {
-    label: string;
-    required?: boolean;
-    error?: string;
-    hint?: string;
-    className?: string;
-    children: React.ReactNode;
-}
-export declare const FormField: React.FC<FormFieldProps>;