pulse-js-framework 1.4.3 → 1.4.5

package/README.md

@@ -14,6 +14,7 @@ A declarative DOM framework with CSS selector-based structure and reactive pulsa
 - **Lightweight** - Minimal footprint, maximum performance
 - **Router & Store** - Built-in SPA routing and state management
 - **Mobile Apps** - Build native Android & iOS apps (zero dependencies)
+- **TypeScript Support** - Full type definitions for IDE autocomplete
 
 ## Installation
 
@@ -398,6 +399,27 @@ onNativeReady(({ platform }) => {
 
 **Available APIs:** Storage, Device Info, Network Status, Toast, Vibration, Clipboard, App Lifecycle
 
+## TypeScript Support
+
+Pulse includes full TypeScript definitions for IDE autocomplete and type checking:
+
+```typescript
+import { pulse, effect, computed, Pulse } from 'pulse-js-framework/runtime';
+import { el, list, when } from 'pulse-js-framework/runtime';
+import { createRouter, Router } from 'pulse-js-framework/runtime/router';
+import { createStore, Store } from 'pulse-js-framework/runtime/store';
+
+// Full autocomplete for all APIs
+const count: Pulse<number> = pulse(0);
+const doubled = computed(() => count.get() * 2);
+
+effect(() => {
+  console.log(count.get()); // Type-safe access
+});
+```
+
+Types are automatically detected by IDEs (VS Code, WebStorm) without additional configuration.
+
 ## Examples
 
 - [Blog](examples/blog) - Full blog app with CRUD, categories, search, dark mode

package/cli/index.js

@@ -7,11 +7,14 @@
 import { fileURLToPath } from 'url';
 import { dirname, join, resolve } from 'path';
 import { existsSync, mkdirSync, writeFileSync, readFileSync, cpSync } from 'fs';
+import { log } from './logger.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-const VERSION = '1.4.3';
+// Version - read dynamically from package.json
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+const VERSION = pkg.version;
 
 // Command handlers
 const commands = {
@@ -38,8 +41,8 @@ async function main() {
   if (command in commands) {
     await commands[command](args.slice(1));
   } else {
-    console.error(`Unknown command: ${command}`);
-    console.log('Run "pulse help" for usage information.');
+    log.error(`Unknown command: ${command}`);
+    log.info('Run "pulse help" for usage information.');
     process.exit(1);
   }
 }
@@ -48,7 +51,7 @@ async function main() {
  * Show help message
  */
 function showHelp() {
-  console.log(`
+  log.info(`
 Pulse Framework CLI v${VERSION}
 
 Usage: pulse <command> [options]
@@ -102,7 +105,7 @@ Documentation: https://github.com/vincenthirtz/pulse-js-framework
  * Show version
  */
 function showVersion() {
-  console.log(`Pulse Framework v${VERSION}`);
+  log.info(`Pulse Framework v${VERSION}`);
 }
 
 /**
@@ -112,19 +115,19 @@ async function createProject(args) {
   const projectName = args[0];
 
   if (!projectName) {
-    console.error('Please provide a project name.');
-    console.log('Usage: pulse create <project-name>');
+    log.error('Please provide a project name.');
+    log.info('Usage: pulse create <project-name>');
     process.exit(1);
   }
 
   const projectPath = resolve(process.cwd(), projectName);
 
   if (existsSync(projectPath)) {
-    console.error(`Directory "${projectName}" already exists.`);
+    log.error(`Directory "${projectName}" already exists.`);
     process.exit(1);
   }
 
-  console.log(`Creating new Pulse project: ${projectName}`);
+  log.info(`Creating new Pulse project: ${projectName}`);
 
   // Create project structure
   mkdirSync(projectPath);
@@ -281,7 +284,7 @@ dist
 
   writeFileSync(join(projectPath, '.gitignore'), gitignore);
 
-  console.log(`
+  log.info(`
 Project created successfully!
 
 Next steps:
@@ -297,7 +300,7 @@ Happy coding with Pulse!
  * Run development server
  */
 async function runDev(args) {
-  console.log('Starting Pulse development server...');
+  log.info('Starting Pulse development server...');
 
   // Use dynamic import for the dev server module
   const { startDevServer } = await import('./dev.js');
@@ -308,7 +311,7 @@ async function runDev(args) {
  * Build for production
  */
 async function runBuild(args) {
-  console.log('Building Pulse project for production...');
+  log.info('Building Pulse project for production...');
 
   const { buildProject } = await import('./build.js');
   await buildProject(args);
@@ -318,7 +321,7 @@ async function runBuild(args) {
  * Preview production build
  */
 async function runPreview(args) {
-  console.log('Starting Pulse preview server...');
+  log.info('Starting Pulse preview server...');
 
   const { previewBuild } = await import('./build.js');
   await previewBuild(args);
@@ -363,13 +366,13 @@ async function compileFile(args) {
   const inputFile = args[0];
 
   if (!inputFile) {
-    console.error('Please provide a file to compile.');
-    console.log('Usage: pulse compile <file.pulse>');
+    log.error('Please provide a file to compile.');
+    log.info('Usage: pulse compile <file.pulse>');
     process.exit(1);
   }
 
   if (!existsSync(inputFile)) {
-    console.error(`File not found: ${inputFile}`);
+    log.error(`File not found: ${inputFile}`);
     process.exit(1);
   }
 
@@ -381,11 +384,11 @@ async function compileFile(args) {
   if (result.success) {
     const outputFile = inputFile.replace(/\.pulse$/, '.js');
     writeFileSync(outputFile, result.code);
-    console.log(`Compiled: ${inputFile} -> ${outputFile}`);
+    log.info(`Compiled: ${inputFile} -> ${outputFile}`);
   } else {
-    console.error('Compilation failed:');
+    log.error('Compilation failed:');
     for (const error of result.errors) {
-      console.error(`  ${error.message}`);
+      log.error(`  ${error.message}`);
     }
     process.exit(1);
   }
@@ -393,6 +396,6 @@ async function compileFile(args) {
 
 // Run main
 main().catch(error => {
-  console.error('Error:', error.message);
+  log.error('Error:', error.message);
   process.exit(1);
 });

package/cli/logger.js

@@ -0,0 +1,122 @@
+/**
+ * Pulse CLI Logger
+ * Lightweight logger for CLI tools with support for verbose mode
+ * @module pulse-cli/logger
+ */
+
+/** @type {boolean} */
+let verboseMode = false;
+
+/**
+ * Enable or disable verbose mode for debug output
+ * @param {boolean} enabled - Whether to enable verbose mode
+ * @returns {void}
+ * @example
+ * setVerbose(true);
+ * log.debug('This will now be shown');
+ */
+export function setVerbose(enabled) {
+  verboseMode = enabled;
+}
+
+/**
+ * Check if verbose mode is currently enabled
+ * @returns {boolean} True if verbose mode is enabled
+ * @example
+ * if (isVerbose()) {
+ *   // Perform additional logging
+ * }
+ */
+export function isVerbose() {
+  return verboseMode;
+}
+
+/**
+ * CLI Logger object with console-like API
+ * @namespace log
+ */
+export const log = {
+  /**
+   * Log an info message (always shown)
+   * @param {...*} args - Values to log
+   * @returns {void}
+   * @example
+   * log.info('Starting server on port', 3000);
+   */
+  info(...args) {
+    console.log(...args);
+  },
+
+  /**
+   * Log a success message (always shown)
+   * @param {...*} args - Values to log
+   * @returns {void}
+   * @example
+   * log.success('Build completed successfully!');
+   */
+  success(...args) {
+    console.log(...args);
+  },
+
+  /**
+   * Log a warning message
+   * @param {...*} args - Values to log
+   * @returns {void}
+   * @example
+   * log.warn('Deprecated feature used');
+   */
+  warn(...args) {
+    console.warn(...args);
+  },
+
+  /**
+   * Log an error message
+   * @param {...*} args - Values to log
+   * @returns {void}
+   * @example
+   * log.error('Failed to compile:', error.message);
+   */
+  error(...args) {
+    console.error(...args);
+  },
+
+  /**
+   * Log a debug message (only shown in verbose mode)
+   * @param {...*} args - Values to log
+   * @returns {void}
+   * @example
+   * log.debug('Processing file:', filename);
+   */
+  debug(...args) {
+    if (verboseMode) {
+      console.log('[debug]', ...args);
+    }
+  },
+
+  /**
+   * Log a verbose message (only shown in verbose mode)
+   * @param {...*} args - Values to log
+   * @returns {void}
+   * @example
+   * log.verbose('Additional details:', data);
+   */
+  verbose(...args) {
+    if (verboseMode) {
+      console.log(...args);
+    }
+  },
+
+  /**
+   * Print a blank line for spacing
+   * @returns {void}
+   * @example
+   * log.info('Section 1');
+   * log.newline();
+   * log.info('Section 2');
+   */
+  newline() {
+    console.log();
+  }
+};
+
+export default log;

package/cli/mobile.js

@@ -4,7 +4,7 @@
  */
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync, readdirSync } from 'fs';
-import { join, resolve, dirname } from 'path';
+import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { execSync } from 'child_process';
 
@@ -14,6 +14,38 @@ const __dirname = dirname(__filename);
 const MOBILE_DIR = 'mobile';
 const CONFIG_FILE = 'pulse.mobile.json';
 
+// ============================================================================
+// Helper functions
+// ============================================================================
+
+/** Create directory if it doesn't exist */
+const mkdirp = (path) => !existsSync(path) && mkdirSync(path, { recursive: true });
+
+/** Create multiple directories at once */
+const mkdirs = (base, dirs) => dirs.forEach(d => mkdirp(join(base, d)));
+
+/** Write file (auto-creates parent directories) */
+const writeFile = (path, content) => {
+  mkdirp(dirname(path));
+  writeFileSync(path, content.trim());
+};
+
+/** Apply template variables to content */
+const applyTemplate = (content, config) => content
+  .replace(/\{\{APP_NAME\}\}/g, config.name)
+  .replace(/\{\{DISPLAY_NAME\}\}/g, config.displayName)
+  .replace(/\{\{PACKAGE_ID\}\}/g, config.packageId)
+  .replace(/\{\{VERSION\}\}/g, config.version)
+  .replace(/\{\{MIN_SDK\}\}/g, String(config.android?.minSdkVersion || 24))
+  .replace(/\{\{TARGET_SDK\}\}/g, String(config.android?.targetSdkVersion || 34))
+  .replace(/\{\{COMPILE_SDK\}\}/g, String(config.android?.compileSdkVersion || 34))
+  .replace(/\{\{IOS_TARGET\}\}/g, config.ios?.deploymentTarget || '13.0');
+
+/** Convert string to PascalCase */
+const toPascalCase = (str) => str
+  .replace(/[-_](.)/g, (_, c) => c.toUpperCase())
+  .replace(/^(.)/, (_, c) => c.toUpperCase());
+
 /**
  * Handle mobile subcommands
  */
@@ -419,67 +451,35 @@ function loadConfig(root) {
   return JSON.parse(readFileSync(configPath, 'utf-8'));
 }
 
-/**
- * Copy and process template files
- */
+/** Copy and process template files */
 function copyAndProcessTemplate(src, dest, config) {
-  if (!existsSync(src)) {
-    return;
-  }
-
-  mkdirSync(dest, { recursive: true });
+  if (!existsSync(src)) return;
+  mkdirp(dest);
 
-  const files = readdirSync(src, { withFileTypes: true });
-
-  for (const file of files) {
+  for (const file of readdirSync(src, { withFileTypes: true })) {
     const srcPath = join(src, file.name);
     const destPath = join(dest, file.name);
 
     if (file.isDirectory()) {
       copyAndProcessTemplate(srcPath, destPath, config);
     } else {
-      let content = readFileSync(srcPath, 'utf-8');
-
-      // Replace template variables
-      content = content
-        .replace(/\{\{APP_NAME\}\}/g, config.name)
-        .replace(/\{\{DISPLAY_NAME\}\}/g, config.displayName)
-        .replace(/\{\{PACKAGE_ID\}\}/g, config.packageId)
-        .replace(/\{\{VERSION\}\}/g, config.version)
-        .replace(/\{\{MIN_SDK\}\}/g, String(config.android?.minSdkVersion || 24))
-        .replace(/\{\{TARGET_SDK\}\}/g, String(config.android?.targetSdkVersion || 34))
-        .replace(/\{\{COMPILE_SDK\}\}/g, String(config.android?.compileSdkVersion || 34))
-        .replace(/\{\{IOS_TARGET\}\}/g, config.ios?.deploymentTarget || '13.0');
-
-      writeFileSync(destPath, content);
+      writeFileSync(destPath, applyTemplate(readFileSync(srcPath, 'utf-8'), config));
     }
   }
 }
 
-/**
- * Create Android project from scratch
- */
+/** Create Android project from scratch */
 function createAndroidProject(androidDir, config) {
   const packagePath = config.packageId.replace(/\./g, '/');
 
   // Create directory structure
-  const dirs = [
+  mkdirs(androidDir, [
     'app/src/main/java/' + packagePath,
-    'app/src/main/res/layout',
-    'app/src/main/res/values',
-    'app/src/main/res/drawable',
-    'app/src/main/res/mipmap-hdpi',
-    'app/src/main/res/mipmap-mdpi',
-    'app/src/main/res/mipmap-xhdpi',
-    'app/src/main/res/mipmap-xxhdpi',
-    'app/src/main/res/mipmap-xxxhdpi',
-    'app/src/main/assets/www',
-    'gradle/wrapper'
-  ];
-
-  for (const dir of dirs) {
-    mkdirSync(join(androidDir, dir), { recursive: true });
-  }
+    'app/src/main/res/layout', 'app/src/main/res/values', 'app/src/main/res/drawable',
+    'app/src/main/res/mipmap-hdpi', 'app/src/main/res/mipmap-mdpi',
+    'app/src/main/res/mipmap-xhdpi', 'app/src/main/res/mipmap-xxhdpi', 'app/src/main/res/mipmap-xxxhdpi',
+    'app/src/main/assets/www', 'gradle/wrapper'
+  ]);
 
   // MainActivity.java
   writeFileSync(join(androidDir, 'app/src/main/java', packagePath, 'MainActivity.java'), `
@@ -906,21 +906,9 @@ gradle %*
 `.trim());
 }
 
-/**
- * Create iOS project from scratch
- */
+/** Create iOS project from scratch */
 function createIOSProject(iosDir, config) {
-  // Create directory structure
-  const dirs = [
-    'PulseApp',
-    'PulseApp/www',
-    'PulseApp/Assets.xcassets',
-    'PulseApp.xcodeproj'
-  ];
-
-  for (const dir of dirs) {
-    mkdirSync(join(iosDir, dir), { recursive: true });
-  }
+  mkdirs(iosDir, ['PulseApp', 'PulseApp/www', 'PulseApp/Assets.xcassets', 'PulseApp.xcodeproj']);
 
   // AppDelegate.swift
   writeFileSync(join(iosDir, 'PulseApp/AppDelegate.swift'), `
@@ -1430,18 +1418,7 @@ function generateXcodeProject(config) {
 `;
 }
 
-/**
- * Convert string to PascalCase
- */
-function toPascalCase(str) {
-  return str
-    .replace(/[-_](.)/g, (_, char) => char.toUpperCase())
-    .replace(/^(.)/, (_, char) => char.toUpperCase());
-}
-
-/**
- * Show mobile help
- */
+/** Show mobile help */
 function showMobileHelp() {
   console.log(`
 Pulse Mobile - Zero-Dependency Mobile Platform