@almadar/ui 2.0.1 → 2.0.3

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

@@ -1,441 +0,0 @@
-/**
- * Component Pattern Wrappers
- *
- * Pattern wrappers for atomic UI components that can be rendered via render_ui.
- * These bridge the shell's atomic components with the pattern system.
- *
- * Interactive components emit events via useEventBus for the closed circuit pattern.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import { type ButtonVariant, type ButtonSize } from '../atoms/Button';
-import { type BadgeVariant } from '../atoms/Badge';
-import { type AlertVariant } from '../molecules/Alert';
-/**
- * Base closed circuit props required by all organism components.
- */
-interface ClosedCircuitProps {
-    className?: string;
-    isLoading?: boolean;
-    error?: Error | null;
-    entity?: string;
-}
-export interface ButtonPatternProps extends ClosedCircuitProps {
-    label: string;
-    variant?: ButtonVariant;
-    size?: ButtonSize;
-    disabled?: boolean;
-    onClick?: string;
-    icon?: string;
-    iconPosition?: 'left' | 'right';
-    className?: string;
-}
-/**
- * Button pattern that emits events via the event bus.
- */
-export declare function ButtonPattern({ label, variant, size, disabled, onClick, icon, iconPosition, className, }: ButtonPatternProps): React.ReactElement;
-export declare namespace ButtonPattern {
-    var displayName: string;
-}
-export interface IconButtonPatternProps extends ClosedCircuitProps {
-    icon: string;
-    variant?: ButtonVariant;
-    size?: ButtonSize;
-    onClick?: string;
-    ariaLabel?: string;
-    className?: string;
-}
-/**
- * Icon-only button pattern.
- */
-export declare function IconButtonPattern({ icon, variant, size, onClick, ariaLabel, className, }: IconButtonPatternProps): React.ReactElement;
-export declare namespace IconButtonPattern {
-    var displayName: string;
-}
-export interface LinkPatternProps extends ClosedCircuitProps {
-    label: string;
-    href?: string;
-    external?: boolean;
-    onClick?: string;
-    className?: string;
-}
-/**
- * Link pattern for navigation.
- */
-export declare function LinkPattern({ label, href, external, onClick, className, }: LinkPatternProps): React.ReactElement;
-export declare namespace LinkPattern {
-    var displayName: string;
-}
-export interface TextPatternProps extends ClosedCircuitProps {
-    content: string;
-    variant?: 'body' | 'caption' | 'overline';
-    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-    weight?: 'normal' | 'medium' | 'semibold' | 'bold';
-    color?: string;
-    align?: 'left' | 'center' | 'right';
-    className?: string;
-}
-/**
- * Text pattern for typography.
- */
-export declare function TextPattern({ content, variant, size, weight, color, align, className, }: TextPatternProps): React.ReactElement;
-export declare namespace TextPattern {
-    var displayName: string;
-}
-export interface HeadingPatternProps extends ClosedCircuitProps {
-    content: string;
-    level?: 1 | 2 | 3 | 4 | 5 | 6;
-    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
-    className?: string;
-}
-/**
- * Heading pattern.
- */
-export declare function HeadingPattern({ content, level, size, className, }: HeadingPatternProps): React.ReactElement;
-export declare namespace HeadingPattern {
-    var displayName: string;
-}
-export interface BadgePatternProps extends ClosedCircuitProps {
-    label: string;
-    variant?: BadgeVariant;
-    size?: 'sm' | 'md';
-    className?: string;
-}
-/**
- * Badge pattern for status/counts.
- */
-export declare function BadgePattern({ label, variant, size, className, }: BadgePatternProps): React.ReactElement;
-export declare namespace BadgePattern {
-    var displayName: string;
-}
-export interface AvatarPatternProps extends ClosedCircuitProps {
-    src?: string;
-    alt?: string;
-    name?: string;
-    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-    className?: string;
-}
-/**
- * Avatar pattern.
- */
-export declare function AvatarPattern({ src, alt, name, size, className, }: AvatarPatternProps): React.ReactElement;
-export declare namespace AvatarPattern {
-    var displayName: string;
-}
-export interface IconPatternProps extends ClosedCircuitProps {
-    name: string;
-    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-    color?: string;
-    className?: string;
-}
-/**
- * Icon pattern.
- */
-export declare function IconPattern({ name, size, color, className, }: IconPatternProps): React.ReactElement;
-export declare namespace IconPattern {
-    var displayName: string;
-}
-export interface ImagePatternProps extends ClosedCircuitProps {
-    src: string;
-    alt: string;
-    width?: number | string;
-    height?: number | string;
-    objectFit?: 'cover' | 'contain' | 'fill';
-    fallback?: string;
-    className?: string;
-}
-/**
- * Image pattern.
- */
-export declare function ImagePattern({ src, alt, width, height, objectFit, className, }: ImagePatternProps): React.ReactElement;
-export declare namespace ImagePattern {
-    var displayName: string;
-}
-export interface CardPatternProps extends ClosedCircuitProps {
-    title?: string;
-    subtitle?: string;
-    padding?: 'none' | 'sm' | 'md' | 'lg';
-    shadow?: 'none' | 'sm' | 'md' | 'lg';
-    onClick?: string;
-    className?: string;
-    children?: React.ReactNode;
-}
-/**
- * Card pattern.
- */
-export declare function CardPattern({ title, subtitle, padding, shadow, onClick, className, children, }: CardPatternProps): React.ReactElement;
-export declare namespace CardPattern {
-    var displayName: string;
-}
-export interface ProgressBarPatternProps extends ClosedCircuitProps {
-    value: number;
-    max?: number;
-    variant?: 'default' | 'primary' | 'success' | 'warning' | 'danger';
-    size?: 'sm' | 'md' | 'lg';
-    showLabel?: boolean;
-    className?: string;
-}
-/**
- * Progress bar pattern.
- */
-export declare function ProgressBarPattern({ value, max, variant, size, showLabel, className, }: ProgressBarPatternProps): React.ReactElement;
-export declare namespace ProgressBarPattern {
-    var displayName: string;
-}
-export interface SpinnerPatternProps extends ClosedCircuitProps {
-    size?: 'xs' | 'sm' | 'md' | 'lg';
-    color?: string;
-    className?: string;
-}
-/**
- * Spinner pattern.
- */
-export declare function SpinnerPattern({ size, className, }: SpinnerPatternProps): React.ReactElement;
-export declare namespace SpinnerPattern {
-    var displayName: string;
-}
-export interface InputPatternProps extends ClosedCircuitProps {
-    value?: string;
-    placeholder?: string;
-    inputType?: 'text' | 'email' | 'password' | 'number' | 'tel' | 'url';
-    disabled?: boolean;
-    /** Field-level validation error message */
-    fieldError?: string;
-    onChange?: string;
-    onBlur?: string;
-    className?: string;
-}
-/**
- * Input pattern.
- */
-export declare function InputPattern({ value, placeholder, inputType, disabled, fieldError, onChange, onBlur, className, }: InputPatternProps): React.ReactElement;
-export declare namespace InputPattern {
-    var displayName: string;
-}
-export interface TextareaPatternProps extends ClosedCircuitProps {
-    value?: string;
-    placeholder?: string;
-    rows?: number;
-    disabled?: boolean;
-    /** Field-level validation error message */
-    fieldError?: string;
-    onChange?: string;
-    className?: string;
-}
-/**
- * Textarea pattern.
- */
-export declare function TextareaPattern({ value, placeholder, rows, disabled, fieldError, onChange, className, }: TextareaPatternProps): React.ReactElement;
-export declare namespace TextareaPattern {
-    var displayName: string;
-}
-export interface SelectPatternProps extends ClosedCircuitProps {
-    value?: string;
-    options: Array<{
-        value: string;
-        label: string;
-    }>;
-    placeholder?: string;
-    disabled?: boolean;
-    /** Field-level validation error message */
-    fieldError?: string;
-    onChange?: string;
-    className?: string;
-}
-/**
- * Select pattern.
- */
-export declare function SelectPattern({ value, options, placeholder, disabled, fieldError, onChange, className, }: SelectPatternProps): React.ReactElement;
-export declare namespace SelectPattern {
-    var displayName: string;
-}
-export interface CheckboxPatternProps extends ClosedCircuitProps {
-    checked?: boolean;
-    label?: string;
-    disabled?: boolean;
-    onChange?: string;
-    className?: string;
-}
-/**
- * Checkbox pattern.
- */
-export declare function CheckboxPattern({ checked, label, disabled, onChange, className, }: CheckboxPatternProps): React.ReactElement;
-export declare namespace CheckboxPattern {
-    var displayName: string;
-}
-export interface RadioPatternProps extends ClosedCircuitProps {
-    value: string;
-    checked?: boolean;
-    name?: string;
-    label?: string;
-    disabled?: boolean;
-    onChange?: string;
-    className?: string;
-}
-/**
- * Radio pattern.
- */
-export declare function RadioPattern({ value, checked, name, label, disabled, onChange, className, }: RadioPatternProps): React.ReactElement;
-export declare namespace RadioPattern {
-    var displayName: string;
-}
-export interface LabelPatternProps extends ClosedCircuitProps {
-    text: string;
-    htmlFor?: string;
-    required?: boolean;
-    className?: string;
-}
-/**
- * Label pattern.
- */
-export declare function LabelPattern({ text, htmlFor, required, className, }: LabelPatternProps): React.ReactElement;
-export declare namespace LabelPattern {
-    var displayName: string;
-}
-export interface AlertPatternProps extends ClosedCircuitProps {
-    message: string;
-    title?: string;
-    variant?: AlertVariant;
-    dismissible?: boolean;
-    onDismiss?: string;
-    className?: string;
-}
-/**
- * Alert pattern.
- */
-export declare function AlertPattern({ message, title, variant, dismissible, onDismiss, className, }: AlertPatternProps): React.ReactElement;
-export declare namespace AlertPattern {
-    var displayName: string;
-}
-export interface TooltipPatternProps extends ClosedCircuitProps {
-    content: string;
-    position?: 'top' | 'bottom' | 'left' | 'right';
-    className?: string;
-    children?: React.ReactNode;
-}
-/**
- * Tooltip pattern.
- */
-export declare function TooltipPattern({ content, position, className, children, }: TooltipPatternProps): React.ReactElement;
-export declare namespace TooltipPattern {
-    var displayName: string;
-}
-export interface PopoverPatternProps extends ClosedCircuitProps {
-    content: React.ReactNode;
-    position?: 'top' | 'bottom' | 'left' | 'right';
-    trigger?: 'click' | 'hover';
-    className?: string;
-    children?: React.ReactNode;
-}
-/**
- * Popover pattern.
- */
-export declare function PopoverPattern({ content, position, trigger, className, children, }: PopoverPatternProps): React.ReactElement;
-export declare namespace PopoverPattern {
-    var displayName: string;
-}
-export interface MenuPatternProps extends ClosedCircuitProps {
-    items: Array<{
-        label: string;
-        event: string;
-        icon?: string;
-        disabled?: boolean;
-        variant?: 'default' | 'danger';
-    }>;
-    trigger?: React.ReactNode;
-    position?: 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
-    className?: string;
-}
-/**
- * Menu pattern.
- */
-export declare function MenuPattern({ items, trigger, position, className, }: MenuPatternProps): React.ReactElement;
-export declare namespace MenuPattern {
-    var displayName: string;
-}
-export interface AccordionPatternProps extends ClosedCircuitProps {
-    items: Array<{
-        title: string;
-        content: React.ReactNode;
-    }>;
-    multiple?: boolean;
-    defaultOpen?: number[];
-    className?: string;
-}
-/**
- * Accordion pattern.
- */
-export declare function AccordionPattern({ items, multiple, defaultOpen, className, }: AccordionPatternProps): React.ReactElement;
-export declare namespace AccordionPattern {
-    var displayName: string;
-}
-export interface ContainerPatternProps extends ClosedCircuitProps {
-    maxWidth?: 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'full';
-    padding?: 'none' | 'sm' | 'md' | 'lg';
-    className?: string;
-    children?: React.ReactNode;
-}
-/**
- * Container pattern.
- */
-export declare function ContainerPattern({ maxWidth, padding, className, children, }: ContainerPatternProps): React.ReactElement;
-export declare namespace ContainerPattern {
-    var displayName: string;
-}
-export interface SimpleGridPatternProps extends ClosedCircuitProps {
-    minChildWidth?: string;
-    gap?: 'xs' | 'sm' | 'md' | 'lg';
-    className?: string;
-    children?: React.ReactNode;
-}
-/**
- * Simple grid pattern.
- */
-export declare function SimpleGridPattern({ minChildWidth, gap, className, children, }: SimpleGridPatternProps): React.ReactElement;
-export declare namespace SimpleGridPattern {
-    var displayName: string;
-}
-export interface FloatButtonPatternProps extends ClosedCircuitProps {
-    icon: string;
-    onClick?: string;
-    position?: 'bottom-right' | 'bottom-left' | 'bottom-center';
-    variant?: 'primary' | 'secondary';
-    className?: string;
-}
-/**
- * Floating action button pattern.
- */
-export declare function FloatButtonPattern({ icon, onClick, position, variant, className, }: FloatButtonPatternProps): React.ReactElement;
-export declare namespace FloatButtonPattern {
-    var displayName: string;
-}
-export declare const COMPONENT_PATTERNS: {
-    readonly button: typeof ButtonPattern;
-    readonly 'icon-button': typeof IconButtonPattern;
-    readonly link: typeof LinkPattern;
-    readonly text: typeof TextPattern;
-    readonly heading: typeof HeadingPattern;
-    readonly badge: typeof BadgePattern;
-    readonly avatar: typeof AvatarPattern;
-    readonly icon: typeof IconPattern;
-    readonly image: typeof ImagePattern;
-    readonly card: typeof CardPattern;
-    readonly 'progress-bar': typeof ProgressBarPattern;
-    readonly spinner: typeof SpinnerPattern;
-    readonly input: typeof InputPattern;
-    readonly textarea: typeof TextareaPattern;
-    readonly select: typeof SelectPattern;
-    readonly checkbox: typeof CheckboxPattern;
-    readonly radio: typeof RadioPattern;
-    readonly label: typeof LabelPattern;
-    readonly alert: typeof AlertPattern;
-    readonly tooltip: typeof TooltipPattern;
-    readonly popover: typeof PopoverPattern;
-    readonly menu: typeof MenuPattern;
-    readonly accordion: typeof AccordionPattern;
-    readonly container: typeof ContainerPattern;
-    readonly 'simple-grid': typeof SimpleGridPattern;
-    readonly 'float-button': typeof FloatButtonPattern;
-};
-export {};

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

@@ -1,50 +0,0 @@
-/**
- * ConfirmDialog Component
- *
- * Confirmation dialog for destructive or important actions.
- * Composes Modal molecule with Button atoms.
- *
- * Uses wireframe theme styling (high contrast, sharp edges).
- */
-import React from "react";
-import { type ModalSize } from "../molecules/Modal";
-export type ConfirmDialogVariant = "danger" | "warning" | "info" | "default";
-export interface ConfirmDialogProps {
-    /** Whether the dialog is open (defaults to true when rendered by slot wrapper) */
-    isOpen?: boolean;
-    /** Callback when dialog is closed (injected by slot wrapper) */
-    onClose?: () => void;
-    /** Callback when action is confirmed (injected by slot wrapper) */
-    onConfirm?: () => void;
-    /** Dialog title */
-    title: string;
-    /** Dialog message/description */
-    message?: string | React.ReactNode;
-    /** Alias for message (schema compatibility) */
-    description?: string | React.ReactNode;
-    /** Confirm button text */
-    confirmText?: string;
-    /** Alias for confirmText (schema compatibility) */
-    confirmLabel?: string;
-    /** Cancel button text */
-    cancelText?: string;
-    /** Alias for cancelText (schema compatibility) */
-    cancelLabel?: string;
-    /** Dialog variant */
-    variant?: ConfirmDialogVariant;
-    /** Dialog size */
-    size?: ModalSize;
-    /** Loading state for confirm button */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
-    /** Additional CSS classes */
-    className?: string;
-}
-/**
- * ConfirmDialog - Confirmation dialog for important actions
- */
-export declare const ConfirmDialog: React.FC<ConfirmDialogProps>;
-export default ConfirmDialog;

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

@@ -1,23 +0,0 @@
-/**
- * ContentRenderer Organism
- *
- * Renders rich content as a sequence of typed segments: markdown, code,
- * orbital diagrams (via JazariStateMachine), and quiz blocks. Accepts
- * either raw content string (auto-parsed) or pre-parsed segments.
- *
- * Event Contract:
- * - Delegates to child components (CodeBlock -> UI:COPY_CODE)
- * - entityAware: false
- */
-import React from 'react';
-import { type ContentSegment } from '../../lib/parseContentSegments';
-import type { EntityDisplayProps } from './types';
-export interface ContentRendererProps extends EntityDisplayProps {
-    /** Raw content string — auto-parsed into segments */
-    content?: string;
-    /** Pre-parsed segments (overrides content) */
-    segments?: ContentSegment[];
-    /** Text direction for markdown */
-    direction?: 'rtl' | 'ltr';
-}
-export declare const ContentRenderer: React.FC<ContentRendererProps>;

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

@@ -1,104 +0,0 @@
-/**
- * CustomPattern Component
- *
- * Renders freeform elements with Tailwind classes for custom UI designs.
- * Uses Box with the `as` prop to render different element types.
- * Supports nested children and the closed circuit pattern (action prop for events).
- *
- * @packageDocumentation
- */
-import React from "react";
-/**
- * Allowed element types for custom patterns.
- */
-export declare const ALLOWED_CUSTOM_COMPONENTS: readonly ["div", "span", "button", "a", "p", "h1", "h2", "h3", "h4", "h5", "h6", "header", "footer", "section", "article", "nav", "main", "aside", "ul", "ol", "li", "img", "label", "input", "form"];
-export type AllowedCustomComponent = (typeof ALLOWED_CUSTOM_COMPONENTS)[number];
-/**
- * Check if a component name is allowed.
- */
-export declare function isAllowedComponent(component: string): component is AllowedCustomComponent;
-/**
- * Check if an element is interactive (requires action for closed circuit).
- */
-export declare function isInteractiveElement(component: string): boolean;
-export interface CustomPatternProps {
-    /** Element type to render */
-    component: AllowedCustomComponent;
-    /** Tailwind classes */
-    className?: string;
-    /** Token path(s) for design token resolution */
-    token?: string | string[];
-    /** Text content (for leaf elements) */
-    content?: string;
-    /** Event to emit on click (REQUIRED for interactive elements) */
-    action?: string;
-    /** Event payload */
-    payload?: Record<string, unknown>;
-    /** Nested children patterns */
-    children?: React.ReactNode;
-    /** Image source (for img elements) */
-    src?: string;
-    /** Image alt text (for img elements) */
-    alt?: string;
-    /** Link href (for a elements) */
-    href?: string;
-    /** Open link in new tab */
-    external?: boolean;
-    /** Disabled state */
-    disabled?: boolean;
-    /** Additional HTML attributes */
-    htmlProps?: Record<string, unknown>;
-    /** Loading state */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Entity name */
-    entity?: string;
-}
-/**
- * Renders a custom element with Tailwind styling.
- *
- * Follows the closed circuit pattern - interactive elements emit events via action prop.
- * Uses Box with `as` prop for all element types to comply with the design system.
- *
- * @example
- * ```tsx
- * <CustomPattern
- *   component="button"
- *   className="bg-blue-500 text-white px-4 py-2 rounded"
- *   action="SUBMIT"
- *   content="Submit"
- * />
- * ```
- */
-export declare function CustomPattern({ component, className, content, action, payload, children, src, alt, href, external, disabled, htmlProps, }: CustomPatternProps): React.ReactElement | null;
-export declare namespace CustomPattern {
-    var displayName: string;
-}
-export interface CustomPatternConfig {
-    type: "custom";
-    component: AllowedCustomComponent;
-    className?: string;
-    token?: string | string[];
-    content?: string;
-    action?: string;
-    payload?: Record<string, unknown>;
-    children?: CustomPatternConfig[];
-    src?: string;
-    alt?: string;
-    href?: string;
-    external?: boolean;
-    disabled?: boolean;
-    [key: string]: unknown;
-}
-/**
- * Check if a pattern config is a custom pattern.
- */
-export declare function isCustomPatternConfig(config: unknown): config is CustomPatternConfig;
-/**
- * Recursively render custom pattern configurations.
- *
- * Use this to render nested custom patterns from render_ui effects.
- */
-export declare function renderCustomPattern(config: CustomPatternConfig, key?: string | number): React.ReactElement;
-export { ALLOWED_CUSTOM_COMPONENTS as CUSTOM_COMPONENT_TYPES };

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

@@ -1,63 +0,0 @@
-import React from "react";
-import { LucideIcon } from "lucide-react";
-import { EntityDisplayProps } from "./types";
-export interface Column<T> {
-    key: keyof T | string;
-    header: string;
-    width?: string;
-    sortable?: boolean;
-    render?: (value: unknown, row: T, index: number) => React.ReactNode;
-}
-export interface RowAction<T> {
-    label: string;
-    icon?: LucideIcon;
-    onClick: (row: T) => void;
-    variant?: "default" | "danger";
-    show?: (row: T) => boolean;
-    event?: string;
-}
-export interface DataTableProps<T extends {
-    id: string | number;
-}> extends EntityDisplayProps<T> {
-    /** Fields to display - accepts string[] or Column[] for unified interface. Alias for columns */
-    fields?: readonly Column<T>[] | readonly string[];
-    /** Columns can be Column objects or simple string field names */
-    columns?: readonly Column<T>[] | readonly string[];
-    /** Item actions from generated code - maps to rowActions */
-    itemActions?: readonly {
-        label: string;
-        event?: string;
-        navigatesTo?: string;
-        action?: string;
-        placement?: "row" | "bulk" | string;
-        icon?: LucideIcon;
-        variant?: "default" | "primary" | "secondary" | "ghost" | "danger" | string;
-        onClick?: (row: T) => void;
-    }[];
-    emptyIcon?: LucideIcon;
-    emptyTitle?: string;
-    emptyDescription?: string;
-    emptyAction?: {
-        label: string;
-        event?: string;
-    };
-    selectable?: boolean;
-    searchable?: boolean;
-    searchPlaceholder?: string;
-    rowActions?: readonly RowAction<T>[];
-    bulkActions?: ReadonlyArray<{
-        label: string;
-        icon?: LucideIcon;
-        onClick: (selectedRows: T[]) => void;
-        variant?: "default" | "danger";
-    }>;
-    headerActions?: React.ReactNode;
-    /** Show total count in pagination */
-    showTotal?: boolean;
-}
-export declare function DataTable<T extends {
-    id: string | number;
-}>({ fields, columns, data, entity, itemActions, isLoading, error, emptyIcon, emptyTitle, emptyDescription, emptyAction, selectable, selectedIds, sortBy, sortDirection, searchable, searchValue, searchPlaceholder, page, pageSize, totalCount, rowActions: externalRowActions, bulkActions, headerActions, showTotal, className, }: DataTableProps<T>): import("react/jsx-runtime").JSX.Element;
-export declare namespace DataTable {
-    var displayName: string;
-}