radui 1.0.0__tar.gz

radui-1.0.0/.dockerignore

@@ -0,0 +1,29 @@
+__pycache__
+*.pyc
+*.pyo
+*.pyd
+.Python
+env/
+venv/
+.venv/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+.pytest_cache/
+.coverage
+htmlcov/
+.git
+.gitignore
+.gemini

radui-1.0.0/.github/workflows/deploy-pages.yml

@@ -0,0 +1,51 @@
+name: Deploy Documentation to GitHub Pages
+
+on:
+  push:
+    branches: ["gh-pages"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install Dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+
+      - name: Export RADUI-Native Static Documentation
+        run: |
+          python -m radui export docs_site/app.py --static --output ./dist_docs
+          mkdir -p ./dist_docs/assets
+          cp -R ./docs_site/assets/. ./dist_docs/assets/
+          touch ./dist_docs/.nojekyll
+
+      - name: Upload Pages Artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./dist_docs
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

radui-1.0.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,48 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build:
+    name: Build distribution package
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install build tools
+        run: python -m pip install --upgrade build hatchling
+      - name: Build sdist and wheel
+        run: python -m build
+      - name: Store distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish-to-pypi:
+    name: Publish package to PyPI
+    needs: [build]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/radui
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distribution packages
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

radui-1.0.0/.gitignore

@@ -0,0 +1,49 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+dist_docs/
+eggs/
+.eggs/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Testing and coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+nosetests.xml
+coverage.xml
+*.cover
+
+# Caches and indexing tools
+.graphify/
+.mypy_cache/
+.ruff_cache/
+
+# Databases and local states
+*.db
+*.sqlite
+*.sqlite3
+*.log
+
+# Environment variables & secrets
+.env
+.env.*
+!.env.example
+
+# OS generated files
+.DS_Store
+Thumbs.db
+Desktop.ini

radui-1.0.0/ARCHITECTURE.md

@@ -0,0 +1,156 @@
+# RADUI Architecture Specification (Version 0.9.0)
+
+RADUI is an open-source, Python-first frontend application framework designed for AI/ML/agents, analytics dashboards, and full-stack software.
+
+---
+
+## Architecture Flow
+
+The architecture follows a strict 5-stage unidirectional execution lifecycle with SWR query caching, distributed multi-worker backends, and persistent layouts:
+
+```mermaid
+flowchart TD
+    S1["<b>1. User interacts</b><br/>Button, form, input or navigation"]
+    S2["<b>2. Command dispatcher</b><br/>Validate, authorize, deduplicate"]
+    S3["<b>3. Application runtime</b><br/>Resolve session and state references"]
+    
+    subgraph Execution ["Execution Pathways"]
+        direction LR
+        S3A["<b>State update</b><br/>Derived values and invalidations"]
+        S3B["<b>Job submission</b><br/>External or local executor"]
+    end
+    
+    S4["<b>4. Event journal</b><br/>Ordered events, revisions, trace references"]
+    S5["<b>5. Renderer and browser</b><br/>HTML fragments, state updates and progress"]
+
+    S1 --> S2
+    S2 --> S3
+    S3 --> S3A
+    S3 --> S3B
+    S3A --> S4
+    S3B --> S4
+    S4 --> S5
+```
+
+---
+
+## Detailed Lifecycle Stages
+
+### 1. User Interacts
+- **Inputs & Controls**: Form fields, text inputs, textareas, selects, switches, radio groups, and chat inputs.
+- **Triggers**: Buttons, action card approval/rejection triggers, and navigation links.
+- **Transport**: Standard form submissions or asynchronous AJAX `fetch()` calls carrying signed `_csrf` tokens, `_gx_action_id` idempotency keys, and `_gx_view_id` route references.
+
+### 2. Command Dispatcher
+- **Validation**: Enforces strict payload bounds (`max_form_bytes`), character sets, and content types (`application/x-www-form-urlencoded`).
+- **Authorization & Security**: Validates constant-time CSRF tokens (`secrets.compare_digest`), checks origin headers against base URLs, and blocks cross-site request forgery (`Sec-Fetch-Site`).
+- **Deduplication & Idempotency**: Atomic in-memory action reservations (`_reserve_action`) prevent duplicate executions of identical `_gx_action_id` requests while caching and replaying identical responses.
+
+### 3. Application Runtime
+- **Identity Resolution**: Resolves signed browser session identity (`SessionMiddleware`) and optional user identification hooks (`user_id_resolver`).
+- **Context Binding**: Allocates an isolated `StateContext` identifying the active session, user, and view scope.
+- **Execution Dispatch**: Invokes registered Python async/sync command handlers with an injected `CommandContext`.
+
+#### Pathway A: State Update
+- Writes to typed `StateRef` references across four isolated scopes:
+  - `view`: Scoped to `(session_id, view_id)`.
+  - `session`: Scoped to `session_id`.
+  - `user`: Shared across sessions of an authenticated `user_id`.
+  - `app`: Global singleton process-wide state.
+- Computes derived values, increments revisions, and calculates surgical component dependency invalidations.
+
+#### Pathway B: Job Submission
+- Asynchronously schedules background long-running workloads (`@app.job`) through the pluggable `JobBackend` (`LocalJobBackend` default).
+- Enforces active concurrency capacity limits, cancellation guards, and progress event publication.
+
+### 4. Event Journal
+- **Ordered Events**: Ordered SSE journal publishing granular `invalidate` and `reset` events tagged with monotonic sequence numbers.
+- **Revisions & Replay**: Maintains bounded in-memory event buffers to allow seamless client reconnection with `Last-Event-ID` or `since` parameters.
+- **Trace References**: Telemetry captured by the `TraceCollector` recording latency, state diffs, command invocations, job progress, and errors.
+
+### 5. Renderer and Browser
+- **Surgical HTML Patches**: Server-side `HTMLRenderer` renders targeted HTML fragments for only invalidated components.
+- **Progressive Delivery**: Browser applies DOM updates without full-page refreshes.
+- **Native Motion Engine (`RADUI.motion`)**:
+  - **FLIP Layout Interpolation**: Intercepts `applyPatches` and smoothly transitions DOM replacements using WAAPI.
+  - **Spring Physics Solver**: Analytical damped harmonic oscillator driving 120fps hardware-accelerated animations (`transform`, `opacity`).
+  - **Number Tweening**: Smooth animated number counting on metric updates (`animate_number=True`).
+  - **Micro-interactions**: Declarative hover elevation and tactile tap depression.
+  - **View Transitions**: Integrated with browser native `document.startViewTransition`.
+  - **Accessibility**: Automatic enforcement of `prefers-reduced-motion`.
+- **Client Script**: Lightweight vanilla client (`/_gx/client.js`) manages EventSource reconnects, form dispatching, job cancellation, optimistic rollbacks, and developer inspector drawer inspection.
+
+---
+
+## Enterprise & Resilience Extensions (0.6)
+
+### 1. SQLite WAL Job Backend (`SQLiteJobBackend`)
+- Durable, file-backed job persistence using standard library `sqlite3` with `PRAGMA journal_mode=WAL;`.
+- Recovers safely from server crashes and process restarts without losing job logs, progress, or returned result payloads.
+
+### 2. Built-in Auth & Role-Based Access Control (RBAC)
+- Role-based decorators: `@app.command(require_auth=True)`, `@app.command(require_role="admin")`, `@app.require_auth`, `@app.require_role(...)`.
+- First-class `User` and `RBACPolicy` models with inherited permissions and contextual guards.
+
+### 3. Optimistic UI Updates & Automatic Rollback
+- Forms and triggers marked with `optimistic=True` apply instantaneous local state while awaiting network resolution.
+- Automatically reverts to snapshot on network failure or server rejection.
+
+### 4. Scoped GenerativeSlot Mutations
+- Dedicated sub-renderers and targeted slot patching for streaming AI responses without re-rendering parent tree nodes.
+
+---
+
+## Complete Frontend & Enterprise Architecture (0.7.0 Final)
+
+### 1. Global Command Palette (`Ctrl+K`)
+- Native modal dialog with fuzzy keyboard search filtering, arrow navigation, and instant command/page triggers.
+- Provides immediate keyboard accessibility for developers and enterprise operators.
+
+### 2. Design System & Theming Engine (`Theme`)
+- Token-based theming architecture compiling declarative palettes (`primary`, `surface`, `bg`, `text`, `radius`) directly to CSS custom properties.
+- Dynamic runtime theme switching via `ThemeToggle` component with client-side event dispatching and `localStorage` persistence.
+
+### 3. Responsive Breakpoint Layout Engine
+- Declarative column dictionaries (`columns={"sm": 1, "md": 2, "lg": 4}`) compiled into responsive CSS custom properties (`--gx-cols-{bp}`).
+- Zero JavaScript overhead on resize; handled directly by modern browser CSS grid media queries.
+
+### 4. Reflection-Based Model Forms (`form_from_model`)
+- Introspects Pydantic model schemas and automatically synthesizes fully-typed RADUI Forms.
+- Auto-generates type-safe form controls (`Checkbox` for bools, `Select` for Enums, `Textarea` for long text, number inputs for numeric fields).
+
+### 5. High-Performance Virtualization (`VirtualList`)
+- Windowed viewport slicing algorithm maintaining steady 60fps scrolling over 50,000+ items.
+- Minimal DOM node footprint using pure CSS translateY positioning inside sized spacer elements.
+
+### 6. Declarative Testing Harness (`TestHarness`)
+- In-memory headless test runner for rendering component trees, extracting pre-filled forms and CSRF tokens, and dispatching command interactions without spinning up real browsers.
+
+### 7. Micro-Frontend Embedding (`/_gx/embed.js`)
+- Universal `<RADUI-view>` Web Component wrapper allowing RADUI views to be seamlessly mounted within React, Angular, Vue, or legacy enterprise web portals.
+
+---
+
+## Distributed Hardening & Advanced Routing (0.8.0 Final)
+
+### 1. Dynamic Routing & Signature-Driven Path Injection
+- Path parameter pattern matching (`/users/{user_id}`, `/orgs/{org}/repos/{repo}`).
+- Auto-extracts URL path segments and injects them directly into typed Python page handler arguments.
+- Route-level security guards: `@app.page("/admin", require_auth=True, require_role="admin")` blocking unauthenticated or unpermitted access with standard 401/403 responses.
+
+### 2. Pluggable State Storage Architecture (`StateBackend`)
+- Decouples reactive state management from process memory.
+- `InMemoryStateBackend`: Ultra-low-latency in-memory dictionary for single-process local development and unit testing.
+- `SQLiteStateBackend`: Durable file-backed ACID store running in SQLite WAL mode. Permits multiple Uvicorn workers and container restarts to read and write shared `user`, `session`, and `app` state without partition divergence.
+
+### 3. Component-Level Error Boundaries (`ErrorBoundary`)
+- Wraps arbitrary visual subtrees in an isolated execution sandbox.
+- Intercepts render exceptions and displays localized error cards with customized failure messages and [Retry] buttons without crashing the overall view or dashboard.
+
+### 4. Modal Focus Trap & Accessible Keyboard Management
+- Traps keyboard `Tab` cycling strictly inside open modal dialogs to comply with WCAG 2.2 AA accessibility standards.
+- Saves previously active element and restores focus upon modal dismissal (`Escape` or backdrop click).
+
+### 5. Client Connection State & Offline Awareness
+- Native browser `online`/`offline` listener and SSE EventSource state monitor.
+- Automatically surfaces a non-intrusive floating connection banner (`.gx-connection-banner`) during network drops and dismisses it upon reconnection.

radui-1.0.0/CHANGELOG.md

@@ -0,0 +1,180 @@
+# RADUI Framework Changelog
+
+## [0.9.0] - 2026-11-15
+
+### Added
+- **68 Core Component Primitives (Component Expansion)**:
+  - Added 19 modern UI components exceeding the 60+ component target:
+    - `Toast` & `ToastContainer`: Real-time notification cards with auto-dismiss timers and stacked placement.
+    - `Tooltip`: Accessible hover & focus hint wrappers.
+    - `Popover`: Anchored floating panels with trigger button.
+    - `Accordion` & `AccordionItem`: Collapsible disclosure sections with smooth transitions.
+    - `Drawer`: Slide-out side panel modals (left, right, top, bottom).
+    - `Breadcrumb` & `BreadcrumbItem`: Accessible hierarchical navigation trails.
+    - `Pagination`: Page navigation buttons with current/total indicators.
+    - `ProgressBar`: Determinate and indeterminate progress bars with percentage text, striped patterns, and animated shimmer.
+    - `ProgressCircle`: SVG circular gauge with percentage indicator.
+    - `Avatar` & `AvatarGroup`: User profile pictures with initials fallback, status badges, and grouped overflow indicators (`+2`).
+    - `DatePicker`: Accessible date selector bound to reactive state.
+    - `TimePicker`: Accessible time selector bound to reactive state.
+    - `Slider`: Range slider input with live value preview label.
+    - `SplitPanel`: Resizable horizontal and vertical split panes with draggable separator handle.
+    - `DropdownMenu` & `DropdownMenuItem`: Action dropdowns with icons, shortcuts, and destructive styling.
+    - `Kbd`: Styled keyboard shortcut key badges.
+    - `Container`: Centered responsive max-width layout wrapper.
+    - `Stack`: Flexible vertical and horizontal spacing container.
+    - `Tag`: Dismissible and categorized feature tags/chips.
+- **RADUI Data Engine (`RADUI.data`)**:
+  - `gx.query(key, fetch_fn, stale_time=60, retry=3)`: SWR query caching engine with concurrent request deduplication.
+  - `@gx.cached(ttl=60)`: Function decorator for server-side query caching.
+  - `gx.invalidate_query(key_or_prefix)`: Cache invalidation triggering instant client re-renders.
+  - `gx.paginate(items, page, page_size)`: Utility for dataset slicing and pagination metadata.
+  - `gx.download_button(...)`: Client-side file download trigger.
+- **Persistent Nested Route Layouts (`@app.layout`)**:
+  - `@app.layout(path_prefix="/...")`: Hierarchical layout wrappers wrapping child page outlets (`outlet=page_root`) without duplicating navigation or shells across routes.
+- **Distributed Production Providers**:
+  - `RedisStateBackend`: Redis-backed distributed state storage for multi-worker / multi-pod deployments.
+  - `PostgreSQLStateBackend`: Relational persistent state storage.
+  - `RedisJobBackend`: Distributed job backend with lease acquisition, heartbeats, and worker broadcast.
+- **Toast Notifications & Real-Time Dispatch (`app.notify`)**:
+  - `app.notify(message, title, variant, duration)`: Publishes real-time toast notifications via SSE stream (`gx:toast`) rendered dynamically on the client.
+- **Scroll Reveal Animations**:
+  - `[data-gx-reveal]` with `IntersectionObserver` triggering hardware-accelerated entry animations when elements enter viewport.
+- **Offline Mutation Queue**:
+  - Automatic buffering of client form submissions and actions during network disconnections, with automatic replay on reconnect.
+- **Internationalization (RTL)**:
+  - `Theme(direction="rtl")` generating `dir="rtl"` and logical CSS direction rules.
+- **Automated A11y & Quality Auditor CLI**:
+  - `RADUI audit [app.py] --a11y`: Scans routes for heading hierarchies, form input labels, theme contrast, and ARIA live regions.
+- **Static Site Generation (SSG)**:
+  - `RADUI export [app.py] --static`: Generates full standalone HTML document bundles ready for CDN deployment.
+
+### Added
+- **Dynamic Routing & Path Parameters**:
+  - Full path template matching: `@app.page("/users/{user_id}")` and `@app.page("/orgs/{org}/repos/{repo}")`.
+  - Type-safe signature introspection automatically extracting and injecting path parameters into page handlers.
+  - Route guards: `@app.page("/admin", require_auth=True, require_role="admin", require_permission="...")` blocking unauthorized access with standard 401/403 responses.
+- **Pluggable Multi-Worker State Backend (`StateBackend`)**:
+  - `InMemoryStateBackend`: High-throughput, thread-safe in-memory store for single-process runtimes and tests.
+  - `SQLiteStateBackend`: Crash-resilient, multi-worker persistent state backend in SQLite WAL mode. Allows multiple Uvicorn workers and container restarts to share synchronized `user`, `session`, and `app` state.
+- **Component-Level Error Boundary (`ErrorBoundary` / `gx.error_boundary`)**:
+  - Gracefully isolates individual component rendering errors without crashing the entire page or surrounding layout.
+  - Displays localized error banner with custom fallback message and instant [Retry] trigger.
+- **Accessible Modal Focus Trap & ARIA Hardening**:
+  - Enhanced client-side modal lifecycle with automatic focus acquisition on open and focus restoration to the trigger element on close (`Escape` or backdrop click).
+  - Keyboard `Tab` focus trap preventing focus escape outside open dialogs.
+  - Injected `role="dialog"`, `aria-modal="true"`, and `aria-labelledby` semantics.
+- **Offline Detection & Reconnection Status Banner**:
+  - Automatic browser `online` / `offline` event monitoring.
+  - Dedicated client status banner (`.gx-connection-banner`) alerting users to network disconnects and auto-dismissing upon SSE reconnection.
+- **Registry & Catalog Alignment**:
+  - Synchronized component catalog dynamically introspected from `ComponentRegistry.builtins()` (44 registered built-in components).
+
+## [0.7.0] - 2026-11-15
+
+### Added
+- **Global `Ctrl+K` Command Palette**:
+  - Built-in keyboard-driven command navigation palette with search filtering, arrow navigation, Enter trigger, and Esc close.
+  - Pre-wired shortcuts for navigation, page transitions, and theme toggling.
+- **Responsive Layout Engine & Breakpoints**:
+  - `Grid` accepts responsive breakpoint mappings: `columns={"sm": 1, "md": 2, "lg": 4}`.
+  - Generates `--gx-cols-{bp}` responsive CSS variables paired with clean `@media` queries without inline JavaScript.
+- **Native Design System & Theming (`RADUI.core.theme` / `gx.Theme`)**:
+  - First-class `Theme` engine with token serialization, CSS variable compilation, and runtime theme switching.
+  - Built-in theme presets: `Theme.dark()`, `Theme.indigo()`, `Theme.emerald()`, `Theme.zinc()`.
+  - `ThemeToggle` (`gx.theme_toggle`) component with client-side theme switching and `localStorage` persistence.
+- **Universal UI State Primitives**:
+  - `Skeleton` (`gx.skeleton`): Shimmering placeholders (`@keyframes gx-shimmer`) with customizable shapes (`text`, `rect`, `circle`) and dimensions.
+  - `EmptyState` (`gx.empty_state`): First-class zero-data UI state with visual icon, heading, description, and call-to-action.
+- **Form-from-Model Reflection (`form_from_model`)**:
+  - Automatic conversion of Pydantic models into typed RADUI forms.
+  - Inferred types: booleans $\to$ checkboxes, Enums $\to$ dropdown selects, ints/floats $\to$ number inputs, passwords $\to$ masked inputs, descriptions $\to$ textareas.
+  - Pre-populates bound `StateRef` references and defaults.
+- **High-Performance Virtual List (`VirtualList` / `gx.virtual_list`)**:
+  - Windowed DOM rendering engine capable of scrolling 50,000+ items at 60fps.
+  - Dynamic scroll translation with sized spacer container and viewport clipping.
+- **Drag-and-Drop File Upload (`FileUpload` / `gx.file_upload`)**:
+  - Client-side drag-and-drop dropzone with file type and size constraints, progress styling, and file list previews.
+- **Declarative Testing Harness (`RADUI.testing.TestHarness`)**:
+  - Headless component and full-stack application testing harness.
+  - Form extraction (`extract_form`, `get_forms`), headless page rendering (`get_page`, `render`), command dispatching (`dispatch`), and DOM assertions.
+- **Micro-Frontend Embed Endpoint (`/_gx/embed.js`)**:
+  - Lightweight Web Component `<RADUI-view>` for embedding RADUI views into external React, Vue, Angular, or standard HTML web apps.
+- **Accessibility & A11y Polish**:
+  - Dedicated `aria-live="polite"` polite announcer region for screen-reader notifications during real-time SSE patch updates.
+  - System-wide `prefers-reduced-motion` compliance.
+
+## [0.6.0] - 2026-11-14
+
+### Added
+- **Native Motion & Visual Interaction Engine (`RADUI.motion` / `gx.motion`)**:
+  - **Zero-Dependency WAAPI Driver**: Bundled analytical spring physics solver and Web Animations API executor with zero external CDN requirements.
+  - **Damped Harmonic Oscillator Physics**: Configurable `spring(stiffness, damping, mass)` generating hardware-accelerated 120fps motion curves.
+  - **FLIP Layout Interpolation**: Intercepts `applyPatches` and smoothly transitions DOM replacements using First, Last, Invert, Play algorithms.
+  - **Animated Number Tweening**: Seamless counter rolling for `MetricCard` value updates (`animate_number=True`).
+  - **Micro-Interactions**: Declarative pointer hover elevation (`hover=gx.motion.hover(...)`) and tactile tap depression (`tap=gx.motion.tap(...)`).
+  - **Staggered Container Cascades**: Cascaded delay animations for children in `Grid`, `Column`, and `TreeView` (`stagger_children=0.05`).
+  - **View Transitions API Integration**: Seamless page-level transitions via native `document.startViewTransition`.
+  - **Accessibility Compliance**: Built-in OS-level `prefers-reduced-motion` safety enforcement.
+- **SQLite WAL Job Backend (`SQLiteJobBackend`)**:
+  - Durable, file-backed background task execution with multi-process query persistence.
+  - Automatic process-restart recovery marking interrupted jobs without data loss.
+- **Built-in Auth & Role-Based Access Control (RBAC)**:
+  - `@app.command(require_auth=True)`, `@app.command(require_role="admin")`, `@app.require_auth`, `@app.require_role(...)`.
+  - First-class `User` and `RBACPolicy` models with inherited permissions.
+- **Optimistic UI Signals & Rollback**:
+  - Instantaneous client-side feedback on form/action submission with automatic rollback on network failure or 4xx/5xx responses.
+- **Scoped GenerativeSlot Mutations**:
+  - Isolated sub-rendering and incremental streaming updates for AI components without parent tree re-renders.
+
+## [0.5.0] - 2026-11-14
+
+### Added
+- **Interactive Architecture Diagram & Flowchart Engine**:
+  - `Diagram`, `DiagramNode`, `DiagramEdge` models and factory helpers.
+  - Zero-dependency pure SVG rendering with smooth cubic bezier curves and directional arrow markers.
+  - Animated flowlines (`animated=True`), pulsing status beacons (`active`, `success`, `warning`, `danger`), and custom shapes (`pill`, `diamond`, `database`, `rounded`).
+  - Bi-directional node click triggers dispatching RADUI commands with structured payload.
+- **Developer & Enterprise Component Suite**:
+  - `CodeBlock`: Monospace presentation with line numbers, copy-to-clipboard, and language badges.
+  - `TreeView` & `TreeNode`: Collapsible directory, AST, and component hierarchy trees with expand/collapse carets.
+  - `DataGrid`: Advanced client-side searchable, sortable, and paginated data table.
+  - `GenerativeSlot`: Container slot for dynamic agent-generated or runtime-swapped UI components.
+- **CLI Runner & Library Distribution (`radui`)**:
+  - `RADUI run <app.py> --port 8000 --reload` for running any RADUI app on a specified port.
+  - `RADUI info` displaying system information and component registry stats.
+  - `RADUI new <name>` scaffolding new RADUI applications.
+  - `[project.scripts]` registration in `pyproject.toml` and `python -m RADUI` support.
+- **Expanded Component Catalog**:
+  - Layout & Containers: `Grid`, `Badge`, `Callout`, `Spacer`, `Tabs`, `TabItem`, `Modal`.
+  - Advanced Form Controls: `Textarea`, `Select`, `Switch`, `RadioGroup`.
+  - Analytics & Data: `MetricCard`, `Table`, `Plot` (with zero-dependency pure SVG bar and line rendering).
+  - AI & Agent Native: `ChatView`, `ChatMessage`, `ChatInput`, `StreamingText`, `ActionCard`, `StepTimeline`, `DynamicCard`.
+- **Runtime Inspector & Telemetry**:
+  - `TraceCollector` recording circular telemetry logs for `render`, `state`, `command`, `job`, and `error`.
+  - Built-in developer endpoints: `/_gx/inspect`, `/_gx/inspect/traces`, `/_gx/inspect/stats`.
+  - Inline collapsible developer drawer (toggle with `Ctrl+Shift+I` or badge click).
+- **AI & Agent Subsystem (`RADUI.ai`)**:
+  - `StreamingFenceParser` for real-time extraction of structured UI blocks from streaming LLM output.
+  - `a2ui_to_component` mapping external agent UI schemas to RADUI native component nodes.
+  - `AGUIEventJournal` for tracking agent execution steps and generating reactive timelines.
+  - `MCPToolRegistry` with human-in-the-loop validation support.
+- **Modern Responsive Design System**:
+  - Comprehensive CSS variables with light and dark mode support.
+  - Interactive client-side tab switching, modal dialogs, and action card dispatchers.
+- **Three Showcase Applications**:
+  - `examples/ai_agent_workbench`: Full-stack agent workbench with streaming chat, background RAG indexing, execution journals, and action approval cards.
+  - `examples/analytics_dashboard`: Multi-region executive BI cockpit with reactive filtering, metric cards, pure SVG charts, and OLAP refresh jobs.
+  - `examples/saas_admin`: Multi-route administrative governance platform with user management, tabbed settings, and backup tasks.
+
+## [0.4.0] - Prior Milestone
+- Background job backend, progress tracking, cancellation endpoints, and `JobPanel` component.
+
+## [0.3.0] - Prior Milestone
+- Interactive forms, commands, CSRF protection, idempotency cache, and SSE event streaming.
+
+## [0.2.0] - Prior Milestone
+- Multi-scoped reactive state (`view`, `session`, `user`, `app`) and fine-grained dependency tracking.
+
+## [0.1.0] - Prior Milestone
+- Initial Application IR and HTML renderer.

radui-1.0.0/Dockerfile

@@ -0,0 +1,50 @@
+# Production Dockerfile for RADUI v1.0.0 Applications
+FROM python:3.12-slim AS builder
+
+WORKDIR /build
+
+# Install build tools and compile dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gcc \
+    libpq-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY pyproject.toml README.md ./
+COPY RADUI ./RADUI
+
+RUN pip install --no-cache-dir --upgrade pip && \
+    pip install --no-cache-dir hatchling && \
+    pip install --no-cache-dir ".[server,postgres,redis]"
+
+# Runtime stage
+FROM python:3.12-slim AS runner
+
+WORKDIR /app
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    libpq5 \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create unprivileged application user
+RUN groupadd -r RADUI && useradd -r -g RADUI -d /app -s /sbin/nologin appuser
+
+# Copy installed packages from builder
+COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
+COPY --from=builder /usr/local/bin /usr/local/bin
+
+COPY . /app
+RUN chown -R appuser:RADUI /app
+
+USER appuser
+
+ENV PYTHONUNBUFFERED=1 \
+    PORT=3000 \
+    HOST=0.0.0.0
+
+EXPOSE 3000
+
+HEALTHCHECK --interval=15s --timeout=3s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:3000/_gx/health || exit 1
+
+CMD ["python", "-m", "RADUI.cli", "serve", "--port", "3000", "--host", "0.0.0.0"]