Roadmap

Project Roadmap

This document summarizes the progress of eQuantic.UI and the next steps planned for the framework.

✅ Completed

🛡️ Security (Phase 1)

• Authorization in Server Actions ([Authorize], [AllowAnonymous])
• Payload validation and request size limits.
• Type whitelist for secure deserialization.

🧪 Compiler & Language Support (Phase 2)

• Source Maps: Integrated native C# debugging in the browser.
• Modern C# Support: Recursive patterns, using var, and advanced switch expressions.
• Comprehensive test suite (37+ unit and snapshot tests).
• Implementation of identifier heuristics (this.).

⚡ Performance - Runtime (Phase 3)

• Keyed Diffing: Intelligent reconciliation based on keys.
• WeakMap Event Tracking: Memory optimization to prevent leaks.
• Optimized Runtime build with Vite.

🛠️ Developer Experience - DX (Phase 4)

• Hot Module Replacement (HMR): Kestrel server in the CLI with WebSockets for instant feedback.
• VS Code Extension: Snippets for pages, components, and styles.
• Debugging: Integrated Source Maps for TS/JS debugging.

📦 Ecosystem & Styling (Phase 5)

• Tailwind Components: New Badge and Alert components.
• Zero-runtime CSS Extraction: Static extraction of styles during build time.
• 100% Theme Extension: Full theme coverage for Switch, Select, Table, Modal, Tabs, Avatar via IAppTheme.
• Core Refactoring: Removal of hardcoded classes in favor of AppTheme.
• DX: Added IsNative property for choosing between standard and rich HTML rendering.

🎨 Phase 6: Theme and Component Maturity

• Standardization of Variant and Size enums.
• Implementation of StyleBuilder (CVA pattern).
• Decoupling of semantic colors via IColorTheme.
• Component refactoring (Button, Alert, Badge, Avatar, Input).
• Duplicate cleanup and folder reorganization.

🏗️ Phase 6.5: Component Robustness (Completed - Feb 2026)

• Compound Components Pattern: Card with semantic sub-components (CardHeader, CardTitle, CardDescription, CardBody, CardFooter).
• Granular Variants: CardVariant enum with 5 options (Default, Outline, Elevated, Subtle, Ghost).
• Controlled/Uncontrolled Components: DefaultValue/DefaultChecked props for TextInput, Select, Checkbox.
• Loading States: Button.Loading prop with automatic spinner and disabled state.
• Error States & Validation: FormField component with label, error messages, and helper text.
• Input Groups: InputGroup and InputAddon for composite inputs (URLs, currency, etc.).
• Data & ARIA Attributes: Native support via HtmlElement.DataAttributes and AriaAttributes.
• XML Documentation: Complete IntelliSense support for all component props.
• Tailwind Package Updates: ButtonTheme, CardTheme, InputTheme with variant support.
• Wiki Documentation: ComponentRobustness.md and TailwindUpdates.md added.

Result: Components now match shadcn/ui robustness with additional C# type safety advantages.

---

🚀 Next Steps

🟠 Short Term

• True Keyed Diffing: Implement Longest Increasing Subsequence (LIS) algorithm for efficient node movement (Critical Performance).
• E2E Testing: Implement real functional tests with Playwright in TodoListApp.
• Linting & Formatting: Rigorous standardization of TS code in the Runtime.

🚀 Phase 7: Documentation and Enterprise Readiness (In Progress)

• Update Wiki with new styling patterns and Source Map details.
• Create interactive Showcase with all components ("Playground").
• DataGrid Pro: Enterprise-grade data grid with remote pagination and editing.
• Enterprise Monetization Plan: Define licensing and premium support structures.
• CLI improvements for component scaffolding.
• Dynamic Theme support (Dark Mode switcher).

🟢 Long Term

• UI Component Library: Create eQuantic.UI.Lucide, eQuantic.UI.Heroicons, eQuantic.UI.Charts ecosystem.
• eQuantic Playground: Online editor via WASM.
• Full SSR Support: Complete initial server-side rendering for SEO and performance.
• eQuantic DevTools: Browser extension to inspect component tree and state.