radui 1.0.0__py3-none-any.whl

genesis/__init__.py

@@ -0,0 +1,563 @@
+"""RADUI Core 1.0.0: Python-first frontend application framework for AI, analytics, and full-stack software."""
+
+import warnings
+
+warnings.warn(
+    "The 'genesis' package has been rebranded to 'radui' (Reactive Application Development User Interface). "
+    "Please update your imports to 'import radui as ui'. "
+    "'genesis' will remain as a backward-compatible alias until v2.0.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+from radui.components import (
+    Accordion,
+    AccordionItem,
+    ActionCard,
+    Avatar,
+    AvatarGroup,
+    Badge,
+    Breadcrumb,
+    BreadcrumbItem,
+    Button,
+    Callout,
+    Card,
+    ChatInput,
+    ChatMessage,
+    ChatView,
+    Checkbox,
+    CodeBlock,
+    Column,
+    Component,
+    Container,
+    DataGrid,
+    DatePicker,
+    Diagram,
+    DiagramEdge,
+    DiagramNode,
+    Divider,
+    Drawer,
+    DropdownMenu,
+    DropdownMenuItem,
+    DynamicCard,
+    Element,
+    EmptyState,
+    ErrorBoundary,
+    FileUpload,
+    Form,
+    GenerativeSlot,
+    Grid,
+    Heading,
+    Input,
+    JobPanel,
+    Kbd,
+    Link,
+    MetricCard,
+    Modal,
+    Pagination,
+    Plot,
+    Popover,
+    ProgressBar,
+    ProgressCircle,
+    RadioGroup,
+    Row,
+    Select,
+    Skeleton,
+    Slider,
+    Spacer,
+    SplitPanel,
+    Stack,
+    StepTimeline,
+    StreamingText,
+    Switch,
+    TabItem,
+    Table,
+    Tabs,
+    Tag,
+    Text,
+    Textarea,
+    ThemeToggle,
+    TimePicker,
+    Toast,
+    ToastContainer,
+    Tooltip,
+    TreeNode,
+    TreeView,
+    VirtualList,
+    accordion,
+    accordion_item,
+    action_card,
+    avatar,
+    avatar_group,
+    badge,
+    breadcrumb,
+    breadcrumb_item,
+    button,
+    callout,
+    card,
+    chat_input,
+    chat_message,
+    chat_view,
+    checkbox,
+    code_block,
+    column,
+    container,
+    data_grid,
+    date_picker,
+    diagram,
+    diagram_edge,
+    diagram_node,
+    divider,
+    drawer,
+    dropdown_menu,
+    dropdown_menu_item,
+    dynamic_card,
+    empty_state,
+    error_boundary,
+    file_upload,
+    form,
+    form_from_model,
+    generative_slot,
+    grid,
+    heading,
+    input,
+    job_panel,
+    kbd,
+    link,
+    metric_card,
+    modal,
+    pagination,
+    plot,
+    popover,
+    progress_bar,
+    progress_circle,
+    radio_group,
+    row,
+    select,
+    skeleton,
+    slider,
+    spacer,
+    split_panel,
+    stack,
+    step_timeline,
+    streaming_text,
+    switch,
+    tab_item,
+    table,
+    tabs,
+    tag,
+    text,
+    textarea,
+    theme_toggle,
+    time_picker,
+    toast,
+    toast_container,
+    tooltip,
+    tree_node,
+    tree_view,
+    virtual_list,
+)
+from radui.core import (
+    App,
+    ApplicationIR,
+    CommandContext,
+    CommandSpec,
+    ComponentRegistry,
+    DuplicateComponentRegistrationError,
+    JobSpec,
+    UnregisteredComponentError,
+    notify,
+)
+from radui.core.auth import RBACPolicy, User
+from radui.core.theme import Theme
+from radui.testing import TestHarness
+from radui.inspector import (
+    OTLPExporter,
+    TraceCategory,
+    TraceCollector,
+    TraceRecord,
+    extract_dag_structure,
+    generate_dag_svg,
+)
+from radui.ai import (
+    AGUIEvent,
+    AGUIEventJournal,
+    AGUIEventType,
+    ChatMessageRecord,
+    MCPToolDescriptor,
+    MCPToolRegistry,
+    SQLiteChatRepository,
+    StreamingFenceParser,
+    TokenStream,
+    a2ui_to_component,
+)
+from radui.state import (
+    BatchContext,
+    ComputedRef,
+    CyclicDependencyError,
+    InMemoryStateBackend,
+    Invalidation,
+    PostgreSQLStateBackend,
+    RedisStateBackend,
+    SQLiteStateBackend,
+    StateBackend,
+    StateBackendUnavailableError,
+    StateChange,
+    StateContext,
+    StateMiddleware,
+    StateRef,
+    StateRuntime,
+    StateScope,
+    TenantRequiredError,
+    TransactionContext,
+    UserRequiredError,
+    computed,
+    state,
+)
+from radui.transport import (
+    Event,
+    EventBackend,
+    EventBroker,
+    EventRecord,
+    InMemoryEventBackend,
+    PostgreSQLEventBackend,
+    RedisEventBackend,
+    SQLiteEventBackend,
+)
+from radui.core.idempotency import (
+    IdempotencyBackend,
+    IdempotencyBackendUnavailableError,
+    IdempotencyConflictError,
+    IdempotencyError,
+    IdempotencyRecord,
+    IdempotencyResult,
+    InMemoryIdempotencyBackend,
+    PostgreSQLIdempotencyBackend,
+    RedisIdempotencyBackend,
+    SQLiteIdempotencyBackend,
+    StaleLeaseError,
+    compute_payload_fingerprint,
+)
+from radui.core.outbox import (
+    OutboxRecord,
+    OutboxStatus,
+    StaleOutboxLeaseError,
+    TransactionalOutbox,
+)
+from radui.jobs import (
+    JobBackend,
+    JobCancelledError,
+    JobCapacityError,
+    JobContext,
+    JobDefinition,
+    JobError,
+    JobNotFoundError,
+    JobSnapshot,
+    JobStatus,
+    LocalJobBackend,
+    RedisJobBackend,
+    SQLiteJobBackend,
+)
+from radui.data import (
+    QueryCache,
+    QueryEntry,
+    aquery,
+    cached,
+    download_button,
+    invalidate_query,
+    paginate,
+    query,
+)
+from radui.i18n import (
+    Translator,
+    format_currency,
+    format_date,
+    format_number,
+    get_locale,
+    set_locale,
+    t,
+)
+from radui.plugins import Plugin, PluginManager
+from radui.core.security import RateLimiter, RateLimitMiddleware
+from radui.benchmarks import BenchmarkResult, BenchmarkSuite
+from radui import motion
+
+__version__ = "1.0.0"
+
+__all__ = [
+    # Core
+    "App",
+    "ApplicationIR",
+    "ComponentRegistry",
+    "DuplicateComponentRegistrationError",
+    "UnregisteredComponentError",
+    "CommandContext",
+    "CommandSpec",
+    "JobSpec",
+    "notify",
+    "__version__",
+    "User",
+    "RBACPolicy",
+    "Theme",
+    "TestHarness",
+    "StateBackend",
+    "InMemoryStateBackend",
+    "SQLiteStateBackend",
+    "RedisStateBackend",
+    "PostgreSQLStateBackend",
+    "StateBackendUnavailableError",
+
+    # Motion & Animation
+    "motion",
+
+    # Data Engine
+    "query",
+    "aquery",
+    "invalidate_query",
+    "cached",
+    "paginate",
+    "download_button",
+    "QueryCache",
+    "QueryEntry",
+
+    # Components & Factories
+    "Accordion",
+    "AccordionItem",
+    "ActionCard",
+    "Avatar",
+    "AvatarGroup",
+    "Badge",
+    "Breadcrumb",
+    "BreadcrumbItem",
+    "Button",
+    "Callout",
+    "Card",
+    "ChatInput",
+    "ChatMessage",
+    "ChatView",
+    "Checkbox",
+    "CodeBlock",
+    "Column",
+    "Component",
+    "Container",
+    "DataGrid",
+    "DatePicker",
+    "Diagram",
+    "DiagramEdge",
+    "DiagramNode",
+    "Divider",
+    "Drawer",
+    "DropdownMenu",
+    "DropdownMenuItem",
+    "DynamicCard",
+    "EmptyState",
+    "ErrorBoundary",
+    "FileUpload",
+    "Form",
+    "GenerativeSlot",
+    "Grid",
+    "Heading",
+    "Input",
+    "JobPanel",
+    "Kbd",
+    "Link",
+    "MetricCard",
+    "Modal",
+    "Pagination",
+    "Plot",
+    "Popover",
+    "ProgressBar",
+    "ProgressCircle",
+    "RadioGroup",
+    "Row",
+    "Select",
+    "Skeleton",
+    "Slider",
+    "Spacer",
+    "SplitPanel",
+    "Stack",
+    "StepTimeline",
+    "StreamingText",
+    "Switch",
+    "TabItem",
+    "Table",
+    "Tabs",
+    "Tag",
+    "Text",
+    "Textarea",
+    "ThemeToggle",
+    "TimePicker",
+    "Toast",
+    "ToastContainer",
+    "Tooltip",
+    "TreeNode",
+    "TreeView",
+    "VirtualList",
+    "accordion",
+    "accordion_item",
+    "action_card",
+    "avatar",
+    "avatar_group",
+    "badge",
+    "breadcrumb",
+    "breadcrumb_item",
+    "button",
+    "callout",
+    "card",
+    "chat_input",
+    "chat_message",
+    "chat_view",
+    "checkbox",
+    "code_block",
+    "column",
+    "container",
+    "data_grid",
+    "date_picker",
+    "diagram",
+    "diagram_edge",
+    "diagram_node",
+    "divider",
+    "drawer",
+    "dropdown_menu",
+    "dropdown_menu_item",
+    "dynamic_card",
+    "empty_state",
+    "error_boundary",
+    "file_upload",
+    "form",
+    "form_from_model",
+    "generative_slot",
+    "grid",
+    "heading",
+    "input",
+    "job_panel",
+    "kbd",
+    "link",
+    "metric_card",
+    "modal",
+    "pagination",
+    "plot",
+    "popover",
+    "progress_bar",
+    "progress_circle",
+    "radio_group",
+    "row",
+    "select",
+    "skeleton",
+    "slider",
+    "spacer",
+    "split_panel",
+    "stack",
+    "step_timeline",
+    "streaming_text",
+    "switch",
+    "tab_item",
+    "tabs",
+    "table",
+    "tag",
+    "text",
+    "textarea",
+    "theme_toggle",
+    "time_picker",
+    "toast",
+    "toast_container",
+    "tooltip",
+    "tree_node",
+    "tree_view",
+    "virtual_list",
+
+    # AI & Agent protocols
+    "a2ui_to_component",
+    "AGUIEvent",
+    "AGUIEventJournal",
+    "AGUIEventType",
+    "ChatMessageRecord",
+    "MCPToolDescriptor",
+    "MCPToolRegistry",
+    "SQLiteChatRepository",
+    "StreamingFenceParser",
+    "TokenStream",
+
+    # Internationalization (i18n)
+    "Translator",
+    "t",
+    "set_locale",
+    "get_locale",
+    "format_number",
+    "format_currency",
+    "format_date",
+
+    # Plugins & Extensions
+    "Plugin",
+    "PluginManager",
+
+    # Security
+    "RateLimiter",
+    "RateLimitMiddleware",
+
+    # Inspector & Telemetry
+    "BenchmarkResult",
+    "BenchmarkSuite",
+    "OTLPExporter",
+    "TraceCategory",
+    "TraceCollector",
+    "TraceRecord",
+    "extract_dag_structure",
+    "generate_dag_svg",
+
+    # Events & Jobs
+    "Event",
+    "EventBackend",
+    "EventBroker",
+    "EventRecord",
+    "InMemoryEventBackend",
+    "SQLiteEventBackend",
+    "RedisEventBackend",
+    "PostgreSQLEventBackend",
+    "JobBackend",
+    "JobCancelledError",
+    "JobCapacityError",
+    "JobContext",
+    "JobDefinition",
+    "JobError",
+    "JobNotFoundError",
+    "JobSnapshot",
+    "JobStatus",
+    "LocalJobBackend",
+    "RedisJobBackend",
+    "SQLiteJobBackend",
+
+    # Idempotency Engine
+    "IdempotencyBackend",
+    "IdempotencyRecord",
+    "IdempotencyResult",
+    "IdempotencyError",
+    "IdempotencyConflictError",
+    "IdempotencyBackendUnavailableError",
+    "InMemoryIdempotencyBackend",
+    "SQLiteIdempotencyBackend",
+    "RedisIdempotencyBackend",
+    "PostgreSQLIdempotencyBackend",
+    "StaleLeaseError",
+    "compute_payload_fingerprint",
+
+    # Transactional Outbox
+    "OutboxRecord",
+    "OutboxStatus",
+    "StaleOutboxLeaseError",
+    "TransactionalOutbox",
+
+    # Reactive State
+    "BatchContext",
+    "ComputedRef",
+    "CyclicDependencyError",
+    "StateChange",
+    "StateContext",
+    "StateMiddleware",
+    "StateRef",
+    "StateRuntime",
+    "StateScope",
+    "TransactionContext",
+    "computed",
+    "state",
+]

genesis/__main__.py

@@ -0,0 +1,9 @@
+"""Main entry point for running RADUI as a module: python -m radui."""
+
+from __future__ import annotations
+
+import sys
+from radui.cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

genesis/ai/__init__.py

@@ -0,0 +1,21 @@
+"""RADUI AI & Agent-Native subsystem: A2UI, AG-UI, MCP, and streaming parsers."""
+
+from .a2ui import a2ui_to_component
+from .ag_ui import AGUIEvent, AGUIEventJournal, AGUIEventType
+from .mcp import MCPToolDescriptor, MCPToolRegistry
+from .persistence import ChatMessageRecord, SQLiteChatRepository
+from .streaming import StreamingFenceParser, TokenStream
+
+__all__ = [
+    "a2ui_to_component",
+    "AGUIEvent",
+    "AGUIEventJournal",
+    "AGUIEventType",
+    "ChatMessageRecord",
+    "MCPToolDescriptor",
+    "MCPToolRegistry",
+    "SQLiteChatRepository",
+    "StreamingFenceParser",
+    "TokenStream",
+]
+

genesis/ai/a2ui.py

@@ -0,0 +1,82 @@
+from __future__ import annotations
+
+from typing import Any
+import radui.components.nodes as nodes
+
+
+def a2ui_to_component(spec: dict[str, Any]) -> nodes.Component:
+    """
+    Maps an A2UI 1.0 component specification into a native RADUI Component node.
+    Enforces safe property mapping and type safety.
+    """
+    comp_type = spec.get("type", "").lower()
+    cid = spec.get("id")
+    props = spec.get("props", {})
+
+    if comp_type == "text":
+        return nodes.text(str(props.get("text", "")), id=cid)
+
+    if comp_type == "heading":
+        return nodes.heading(
+            str(props.get("text", "")),
+            level=int(props.get("level", 1)),
+            id=cid,
+        )
+
+    if comp_type in {"column", "vertical_layout"}:
+        children = [a2ui_to_component(c) for c in spec.get("children", []) if isinstance(c, dict)]
+        return nodes.column(*children, gap=int(props.get("gap", 16)), id=cid)
+
+    if comp_type in {"row", "horizontal_layout"}:
+        children = [a2ui_to_component(c) for c in spec.get("children", []) if isinstance(c, dict)]
+        return nodes.row(*children, gap=int(props.get("gap", 12)), id=cid)
+
+    if comp_type == "card":
+        children = [a2ui_to_component(c) for c in spec.get("children", []) if isinstance(c, dict)]
+        return nodes.card(*children, id=cid)
+
+    if comp_type == "badge":
+        return nodes.badge(
+            str(props.get("label", "")),
+            variant=props.get("variant", "neutral"),
+            id=cid,
+        )
+
+    if comp_type == "callout":
+        return nodes.callout(
+            str(props.get("message", "")),
+            title=str(props.get("title", "")),
+            variant=props.get("variant", "info"),
+            id=cid,
+        )
+
+    if comp_type in {"metric", "stat"}:
+        delta_val = props.get("delta") or props.get("change")
+        trend_val = props.get("delta_type") or props.get("trend", "neutral")
+        return nodes.metric_card(
+            title=str(props.get("title", "")),
+            value=str(props.get("value", "")),
+            delta=str(delta_val) if delta_val is not None else None,
+            delta_type=trend_val,
+            subtitle=str(props.get("subtitle", "")),
+            id=cid,
+        )
+
+    if comp_type == "button":
+        return nodes.button(str(props.get("label", "Click")), id=cid)
+
+    if comp_type == "table":
+        headers = props.get("headers") or props.get("columns") or []
+        return nodes.table(
+            headers=headers,
+            rows=props.get("rows", []),
+            id=cid,
+        )
+
+    # Fallback for dynamic/unmapped components: wrap in DynamicCard
+    return nodes.dynamic_card(
+        title=str(props.get("title", comp_type)),
+        block_type=comp_type,
+        payload=spec,
+        id=cid,
+    )