pulse-js-framework 1.7.13 → 1.7.16

package/cli/index.js

@@ -9,6 +9,7 @@ import { dirname, join, resolve, relative } from 'path';
 import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, watch } from 'fs';
 import { log } from './logger.js';
 import { findPulseFiles, parseArgs } from './utils/file-utils.js';
+import { runHelp } from './help.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -136,10 +137,28 @@ function suggestCommand(input) {
  */
 async function main() {
   const args = process.argv.slice(2);
-  const command = args[0] || 'help';
+  let command = args[0] || 'help';
+
+  // Handle global --help and -h flags
+  if (command === '--help' || command === '-h') {
+    command = 'help';
+  }
+
+  // Handle --version and -v flags
+  if (command === '--version' || command === '-v') {
+    command = 'version';
+  }
+
+  // Handle command-specific help: pulse <cmd> --help or pulse <cmd> -h
+  const cmdArgs = args.slice(1);
+  if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) {
+    // Show help for the specific command
+    await commands.help([command]);
+    return;
+  }
 
   if (command in commands) {
-    await commands[command](args.slice(1));
+    await commands[command](cmdArgs);
   } else {
     log.error(`Unknown command: ${command}`);
 
@@ -156,110 +175,10 @@ async function main() {
 
 /**
  * Show help message
+ * Supports: pulse help, pulse help <command>
  */
-function showHelp() {
-  log.info(`
-Pulse Framework CLI v${VERSION}
-
-Usage: pulse <command> [options]
-
-Commands:
-  create <name>      Create a new Pulse project
-  init [options]     Initialize project in current directory
-  dev [port]         Start development server (default: 3000)
-  build              Build for production (minified)
-  preview [port]     Preview production build (default: 4173)
-  compile <file>     Compile a .pulse file to JavaScript
-  mobile <cmd>       Mobile app commands (init, build, run)
-  lint [files]       Validate .pulse files for errors and style
-  format [files]     Format .pulse files consistently
-  analyze            Analyze bundle size and dependencies
-  test [files]       Run tests with coverage support
-  doctor             Run project diagnostics
-  scaffold <type>    Generate components, pages, stores
-  docs               Generate API documentation from JSDoc
-  release <type>     Create a new release (patch, minor, major)
-  docs-test          Test documentation (syntax, imports, HTTP)
-  version            Show version number
-  help               Show this help message
-
-Create/Init Options:
-  --typescript       Create TypeScript project
-  --minimal          Create minimal project structure
-
-Compile Options:
-  --watch, -w        Watch files and recompile on changes
-  --dry-run          Show what would be compiled without writing
-  --output, -o       Output directory (default: same as input)
-
-Lint Options:
-  --fix              Auto-fix fixable issues
-  --watch, -w        Watch files and re-lint on changes
-  --dry-run          Show fixes without applying (use with --fix)
-
-Format Options:
-  --check            Check formatting without writing (dry-run)
-  --watch, -w        Watch files and re-format on changes
-  --write            Write formatted output (default)
-
-Analyze Options:
-  --json             Output analysis as JSON
-  --verbose          Show detailed metrics
-
-Test Options:
-  --coverage, -c     Collect code coverage
-  --watch, -w        Watch files and re-run tests
-  --filter, -f       Filter tests by name pattern
-  --timeout, -t      Test timeout in ms (default: 30000)
-  --bail, -b         Stop on first failure
-  --create <name>    Generate a new test file
-
-Doctor Options:
-  --verbose, -v      Show detailed diagnostics
-  --json             Output as JSON
-
-Scaffold Options:
-  --dir, -d <path>   Output directory
-  --force, -f        Overwrite existing files
-  --props            Include props section (components)
-
-Docs Options:
-  --generate, -g     Generate documentation
-  --format, -f       Output format: markdown, json, html
-  --output, -o       Output directory (default: docs/api)
-
-Release Options:
-  --dry-run          Show what would be done without making changes
-  --no-push          Create commit and tag but don't push
-  --title <text>     Release title for changelog
-  --skip-prompt      Use empty changelog (for automation)
-  --skip-docs-test   Skip documentation tests before release
-  --from-commits     Auto-extract changelog from git commits since last tag
-
-Examples:
-  pulse create my-app
-  pulse create my-app --typescript
-  pulse init --typescript
-  pulse dev
-  pulse build
-  pulse test
-  pulse test --coverage --watch
-  pulse test --create MyComponent
-  pulse doctor
-  pulse doctor --verbose
-  pulse scaffold component Button
-  pulse scaffold page Dashboard
-  pulse scaffold store user
-  pulse docs --generate
-  pulse docs --generate --format html
-  pulse compile src/App.pulse
-  pulse lint src/ --fix
-  pulse format --check
-  pulse analyze --json
-  pulse release patch
-
-Documentation: https://github.com/vincenthirtz/pulse-js-framework
-  `);
+function showHelp(args = []) {
+  runHelp(args);
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pulse-js-framework",
-  "version": "1.7.13",
+  "version": "1.7.16",
   "description": "A declarative DOM framework with CSS selector-based structure and reactive pulsations",
   "type": "module",
   "main": "index.js",
@@ -88,7 +88,7 @@
     "./compiler/lexer": "./compiler/lexer.js",
     "./compiler/parser": "./compiler/parser.js",
     "./compiler/transformer": "./compiler/transformer.js",
-    "./core/errors": "./core/errors.js",
+    "./core/errors": "./runtime/errors.js",
     "./vite": {
       "types": "./types/index.d.ts",
       "default": "./loader/vite-plugin.js"
@@ -109,14 +109,17 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "npm run test:compiler && npm run test:sourcemap && npm run test:pulse && npm run test:dom && npm run test:dom-adapter && npm run test:router && npm run test:store && npm run test:hmr && npm run test:lint && npm run test:format && npm run test:analyze && npm run test:cli && npm run test:cli-ui && npm run test:lru-cache && npm run test:utils && npm run test:docs && npm run test:async && npm run test:form && npm run test:http && npm run test:devtools && npm run test:native && npm run test:a11y && npm run test:logger && npm run test:errors && npm run test:security && npm run test:websocket && npm run test:graphql && npm run test:doctor && npm run test:scaffold && npm run test:test-runner && npm run test:build",
+    "test": "npm run test:compiler && npm run test:sourcemap && npm run test:pulse && npm run test:dom && npm run test:dom-element && npm run test:dom-adapter && npm run test:enhanced-mock-adapter && npm run test:router && npm run test:store && npm run test:context && npm run test:hmr && npm run test:lint && npm run test:format && npm run test:analyze && npm run test:cli && npm run test:cli-ui && npm run test:lru-cache && npm run test:utils && npm run test:docs && npm run test:docs-nav && npm run test:async && npm run test:form && npm run test:http && npm run test:devtools && npm run test:native && npm run test:a11y && npm run test:a11y-enhanced && npm run test:logger && npm run test:errors && npm run test:security && npm run test:websocket && npm run test:graphql && npm run test:doctor && npm run test:scaffold && npm run test:test-runner && npm run test:build && npm run test:integration && npm run test:context-stress && npm run test:form-edge-cases && npm run test:graphql-subscriptions && npm run test:http-edge-cases && npm run test:integration-advanced && npm run test:websocket-stress && npm run test:ssr",
     "test:compiler": "node test/compiler.test.js",
     "test:sourcemap": "node test/sourcemap.test.js",
     "test:pulse": "node test/pulse.test.js",
     "test:dom": "node test/dom.test.js",
+    "test:dom-element": "node test/dom-element.test.js",
     "test:dom-adapter": "node test/dom-adapter.test.js",
+    "test:enhanced-mock-adapter": "node test/enhanced-mock-adapter.test.js",
     "test:router": "node test/router.test.js",
     "test:store": "node test/store.test.js",
+    "test:context": "node test/context.test.js",
     "test:hmr": "node test/hmr.test.js",
     "test:lint": "node test/lint.test.js",
     "test:format": "node test/format.test.js",
@@ -126,12 +129,14 @@
     "test:lru-cache": "node test/lru-cache.test.js",
     "test:utils": "node test/utils.test.js",
     "test:docs": "node test/docs.test.js",
+    "test:docs-nav": "node test/docs-navigation.test.js",
     "test:async": "node test/async.test.js",
     "test:form": "node test/form.test.js",
     "test:http": "node test/http.test.js",
     "test:devtools": "node test/devtools.test.js",
     "test:native": "node test/native.test.js",
     "test:a11y": "node test/a11y.test.js",
+    "test:a11y-enhanced": "node test/a11y-enhanced.test.js",
     "test:logger": "node test/logger.test.js",
     "test:errors": "node test/errors.test.js",
     "test:security": "node test/security.test.js",
@@ -141,6 +146,14 @@
     "test:scaffold": "node test/scaffold.test.js",
     "test:test-runner": "node test/test-runner.test.js",
     "test:build": "node test/build.test.js",
+    "test:integration": "node test/integration.test.js",
+    "test:context-stress": "node test/context-stress.test.js",
+    "test:form-edge-cases": "node test/form-edge-cases.test.js",
+    "test:graphql-subscriptions": "node test/graphql-subscriptions.test.js",
+    "test:http-edge-cases": "node test/http-edge-cases.test.js",
+    "test:integration-advanced": "node test/integration-advanced.test.js",
+    "test:websocket-stress": "node test/websocket-stress.test.js",
+    "test:ssr": "node test/ssr.test.js",
     "build:netlify": "node scripts/build-netlify.js",
     "version": "node scripts/sync-version.js",
     "docs": "node cli/index.js dev docs"

package/runtime/async.js

@@ -7,6 +7,7 @@
  */
 
 import { pulse, effect, batch, onCleanup } from './pulse.js';
+import { getSSRAsyncContext, registerAsync, getCachedAsync, hasCachedAsync } from './ssr-async.js';
 
 // ============================================================================
 // Versioned Async - Centralized Race Condition Handling
@@ -328,6 +329,44 @@ export function useAsync(asyncFn, options = {}) {
     retryDelay = 1000
   } = options;
 
+  // SSR MODE: Check for cached data or register async operation
+  const ssrCtx = getSSRAsyncContext();
+  if (ssrCtx) {
+    // Check if we already have cached data (second render pass)
+    if (hasCachedAsync(asyncFn)) {
+      const cachedData = getCachedAsync(asyncFn);
+      return {
+        data: pulse(cachedData),
+        error: pulse(null),
+        loading: pulse(false),
+        status: pulse('success'),
+        execute: () => Promise.resolve(cachedData),
+        reset: () => {},
+        abort: () => {}
+      };
+    }
+
+    // First render pass: register async operation for collection
+    if (immediate) {
+      const promise = asyncFn().catch(err => {
+        // Store error for SSR error handling
+        return null;
+      });
+      registerAsync(asyncFn, promise);
+    }
+
+    // Return loading state for first pass
+    return {
+      data: pulse(initialData),
+      error: pulse(null),
+      loading: pulse(true),
+      status: pulse('loading'),
+      execute: () => Promise.resolve(initialData),
+      reset: () => {},
+      abort: () => {}
+    };
+  }
+
   const data = pulse(initialData);
   const error = pulse(null);
   const loading = pulse(false);