pulse-js-framework 1.7.11 → 1.7.13

package/README.md

@@ -1,9 +1,10 @@
 # Pulse Framework
 
 [![CI](https://github.com/vincenthirtz/pulse-js-framework/actions/workflows/ci.yml/badge.svg)](https://github.com/vincenthirtz/pulse-js-framework/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/vincenthirtz/pulse-js-framework/graph/badge.svg)](https://codecov.io/gh/vincenthirtz/pulse-js-framework)
 [![Netlify Status](https://api.netlify.com/api/v1/badges/2597dac2-228a-4d3e-bea8-4e7ef8ac5c53/deploy-status)](https://app.netlify.com/projects/pulse-js/deploys)
 
-A declarative DOM framework with CSS selector-based structure and reactive pulsations.
+No build. No dependencies. Just JavaScript.
 
 ## Features
 
@@ -37,6 +38,15 @@ npm install
 npm run dev
 ```
 
+### Or with TypeScript
+
+```bash
+npx pulse-js-framework create my-app --typescript
+cd my-app
+npm install
+npm run dev
+```
+
 ### Or use directly
 
 ```javascript
@@ -125,13 +135,43 @@ See [Pulse DSL documentation](docs/pulse-dsl.md) for full syntax reference.
 ## CLI Commands
 
 ```bash
-pulse create <name>    # Create new project
-pulse dev [port]       # Start dev server (default: 3000)
-pulse build            # Build for production
-pulse compile <file>   # Compile .pulse file
-pulse lint [files]     # Validate .pulse files
-pulse format [files]   # Format .pulse files
-pulse analyze          # Analyze bundle
+# Project Creation
+pulse create <name>              # Create new project
+pulse create <name> --typescript # Create TypeScript project
+pulse init --typescript          # Initialize in current directory
+
+# Development
+pulse dev [port]                 # Start dev server (default: 3000)
+pulse build                      # Build for production
+pulse preview [port]             # Preview production build
+pulse compile <file>             # Compile .pulse file
+
+# Code Quality
+pulse lint [files]               # Validate .pulse files
+pulse format [files]             # Format .pulse files
+pulse analyze                    # Analyze bundle
+
+# Testing
+pulse test                       # Run tests with Node.js test runner
+pulse test --coverage            # Run tests with coverage
+pulse test --watch               # Watch mode
+pulse test --create <name>       # Generate test file
+
+# Project Tools
+pulse doctor                     # Run project diagnostics
+pulse doctor --verbose           # Detailed diagnostics
+
+# Scaffolding
+pulse scaffold component <name>  # Generate component
+pulse scaffold page <name>       # Generate page
+pulse scaffold store <name>      # Generate store module
+pulse scaffold hook <name>       # Generate custom hook
+pulse scaffold service <name>    # Generate API service
+
+# Documentation
+pulse docs --generate            # Generate API docs (Markdown)
+pulse docs --generate -f html    # Generate HTML docs
+pulse docs --generate -f json    # Generate JSON docs
 ```
 
 See [CLI documentation](docs/cli.md) for full command reference.
@@ -187,6 +227,38 @@ const { data, loading } = useAsync(() => fetch('/api/users').then(r => r.json())
 const users = useResource('users', fetchUsers, { refreshInterval: 30000 });
 ```
 
+### Accessibility
+
+```javascript
+import {
+  // Announcements
+  announce, createAnnouncementQueue,
+  // Focus management
+  trapFocus, onEscapeKey, createFocusVisibleTracker,
+  // User preferences
+  prefersReducedMotion, prefersReducedTransparency, forcedColorsMode,
+  // ARIA widgets
+  createModal, createTooltip, createAccordion, createMenu,
+  // Color contrast
+  getContrastRatio, meetsContrastRequirement,
+  // Validation
+  validateA11y
+} from 'pulse-js-framework/runtime/a11y';
+
+// Screen reader announcements
+announce('Item saved successfully');
+
+// Accessible modal dialog
+const modal = createModal(dialog, { labelledBy: 'title', closeOnBackdropClick: true });
+modal.open();
+
+// Check color contrast (WCAG)
+const ratio = getContrastRatio('#333', '#fff'); // 12.63
+meetsContrastRequirement(ratio, 'AA'); // true
+```
+
+See [Accessibility documentation](docs/accessibility.md) for full guide.
+
 See [API documentation](docs/api.md) for full reference.
 
 ## Mobile Apps