pulse-js-framework 1.7.16 → 1.7.18

package/README.md

@@ -163,6 +163,12 @@ pulse test --create <name>       # Generate test file
 pulse doctor                     # Run project diagnostics
 pulse doctor --verbose           # Detailed diagnostics
 
+# Creating .pulse Files
+pulse new <name>                 # Create component (src/components/<Name>.pulse)
+pulse new <name> --type page     # Create page (src/pages/<Name>.pulse)
+pulse new <name> --type layout   # Create layout (src/layouts/<Name>.pulse)
+pulse new <name> --props         # Include props section
+
 # Scaffolding
 pulse scaffold component <name>  # Generate component
 pulse scaffold page <name>       # Generate page

package/cli/help.js

@@ -66,6 +66,40 @@ Merges with existing package.json if present.`,
     ]
   },
 
+  new: {
+    name: 'new',
+    summary: 'Create a new .pulse file',
+    usage: 'pulse new <name> [options]',
+    description: `
+Creates a new .pulse file with a component template. This is a shorthand for
+"pulse scaffold component/page/layout" that makes it quick to create new
+Pulse components from the command line.
+
+File types:
+- component: Reusable UI component (default)
+- page: Page component with routing support
+- layout: Layout component with slots`,
+    arguments: [
+      { name: '<name>', description: 'Name of the component (PascalCase recommended)' }
+    ],
+    options: [
+      { flag: '--type, -t <type>', description: 'Type: component, page, layout (default: component)' },
+      { flag: '--dir, -d <path>', description: 'Output directory (default: based on type)' },
+      { flag: '--force, -f', description: 'Overwrite existing files' },
+      { flag: '--props', description: 'Include props section' },
+      { flag: '--no-state', description: 'Skip state section' },
+      { flag: '--no-style', description: 'Skip style section' }
+    ],
+    examples: [
+      { cmd: 'pulse new Button', desc: 'Create src/components/Button.pulse' },
+      { cmd: 'pulse new Dashboard --type page', desc: 'Create src/pages/Dashboard.pulse' },
+      { cmd: 'pulse new Admin --type layout', desc: 'Create src/layouts/Admin.pulse' },
+      { cmd: 'pulse new Modal --props', desc: 'Create component with props section' },
+      { cmd: 'pulse new Card -d src/ui', desc: 'Create in custom directory' },
+      { cmd: 'pulse new Header --no-style', desc: 'Create without style block' }
+    ]
+  },
+
   dev: {
     name: 'dev',
     summary: 'Start development server',
@@ -505,7 +539,7 @@ function showGeneralHelp() {
     'Development': ['dev', 'build', 'preview'],
     'Code Quality': ['compile', 'lint', 'format', 'analyze'],
     'Testing': ['test', 'doctor'],
-    'Scaffolding': ['scaffold', 'docs'],
+    'Scaffolding': ['new', 'scaffold', 'docs'],
     'Release': ['release'],
     'Mobile': ['mobile'],
     'Information': ['version', 'help']

package/cli/index.js

@@ -24,6 +24,7 @@ const commands = {
   version: showVersion,
   create: createProject,
   init: initProject,
+  new: newPulseFile,
   dev: runDev,
   build: runBuild,
   preview: runPreview,
@@ -73,7 +74,9 @@ const commandAliases = {
   'scaffod': 'scaffold',
   'scafflod': 'scaffold',
   'doc': 'docs',
-  'dcos': 'docs'
+  'dcos': 'docs',
+  'nwe': 'new',
+  'enw': 'new'
 };
 
 /**
@@ -683,6 +686,80 @@ async function runScaffoldCmd(args) {
   await runScaffold(args);
 }
 
+/**
+ * Create a new .pulse file
+ * Usage: pulse new <name> [options]
+ * Options:
+ *   --type, -t <type>  Type: component, page, layout (default: component)
+ *   --dir, -d <path>   Output directory (default: src/components or based on type)
+ *   --force, -f        Overwrite existing files
+ *   --props            Include props section
+ *   --no-state         Skip state section
+ *   --no-style         Skip style section
+ */
+async function newPulseFile(args) {
+  const { options, patterns } = parseArgs(args);
+  const name = patterns[0];
+
+  if (!name) {
+    log.error('Please provide a name for the .pulse file.');
+    log.info(`
+Usage: pulse new <name> [options]
+
+Options:
+  --type, -t <type>  Type: component, page, layout (default: component)
+  --dir, -d <path>   Output directory
+  --force, -f        Overwrite existing files
+  --props            Include props section
+  --no-state         Skip state section
+  --no-style         Skip style section
+
+Examples:
+  pulse new Button                   Create src/components/Button.pulse
+  pulse new Dashboard --type page    Create src/pages/Dashboard.pulse
+  pulse new Admin --type layout      Create src/layouts/Admin.pulse
+  pulse new Modal --props            Create component with props section
+  pulse new Card -d src/ui           Create in custom directory
+`);
+    process.exit(1);
+  }
+
+  // Determine type
+  const type = options.type || options.t || 'component';
+  const validTypes = ['component', 'page', 'layout'];
+
+  if (!validTypes.includes(type)) {
+    log.error(`Invalid type: ${type}`);
+    log.info(`Valid types: ${validTypes.join(', ')}`);
+    process.exit(1);
+  }
+
+  // Map type to scaffold type and delegate
+  const { runScaffold } = await import('./scaffold.js');
+
+  // Build args for scaffold command
+  const scaffoldArgs = [type, name];
+
+  // Pass through options
+  if (options.dir || options.d) {
+    scaffoldArgs.push('--dir', options.dir || options.d);
+  }
+  if (options.force || options.f) {
+    scaffoldArgs.push('--force');
+  }
+  if (options.props) {
+    scaffoldArgs.push('--props');
+  }
+  if (options.state === false) {
+    scaffoldArgs.push('--no-state');
+  }
+  if (options.style === false) {
+    scaffoldArgs.push('--no-style');
+  }
+
+  await runScaffold(scaffoldArgs);
+}
+
 /**
  * Run docs command
  */

package/cli/release.js

@@ -350,14 +350,15 @@ function updateDocsChangelog(newVersion, title, changes) {
 }
 
 /**
- * Escape HTML entities
+ * Escape HTML entities and convert backticks to <code> tags
  */
 function escapeHtml(str) {
   return str
     .replace(/&/g, '&amp;')
     .replace(/</g, '&lt;')
     .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;');
+    .replace(/"/g, '&quot;')
+    .replace(/`([^`]+)`/g, '<code>$1</code>');
 }
 
 /**

package/cli/utils/file-utils.js

@@ -247,6 +247,10 @@ export function resolveImportPath(fromFile, importPath) {
 
 /**
  * Parse CLI arguments into options and file patterns
+ * Supports:
+ * - Boolean flags: --verbose, -v
+ * - Value options: --dir /path, -d /path
+ * - Negation: --no-state
  * @param {string[]} args - Command line arguments
  * @returns {{ options: object, patterns: string[] }}
  */
@@ -254,15 +258,33 @@ export function parseArgs(args) {
   const options = {};
   const patterns = [];
 
+  // Options that take a value (not boolean)
+  const valueOptions = new Set([
+    'dir', 'd', 'output', 'o', 'type', 't', 'format', 'f', 'filter', 'timeout', 'title', 'from'
+  ]);
+
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
-    if (arg.startsWith('--')) {
+    if (arg.startsWith('--no-')) {
+      // Negation: --no-state -> state: false
+      const key = arg.slice(5);
+      options[key] = false;
+    } else if (arg.startsWith('--')) {
       const key = arg.slice(2);
-      // Boolean flags - don't consume next argument
-      options[key] = true;
+      // Check if this option takes a value
+      if (valueOptions.has(key) && i + 1 < args.length && !args[i + 1].startsWith('-')) {
+        options[key] = args[++i];
+      } else {
+        options[key] = true;
+      }
     } else if (arg.startsWith('-') && arg.length === 2) {
       const key = arg.slice(1);
-      options[key] = true;
+      // Check if this option takes a value
+      if (valueOptions.has(key) && i + 1 < args.length && !args[i + 1].startsWith('-')) {
+        options[key] = args[++i];
+      } else {
+        options[key] = true;
+      }
     } else {
       patterns.push(arg);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pulse-js-framework",
-  "version": "1.7.16",
+  "version": "1.7.18",
   "description": "A declarative DOM framework with CSS selector-based structure and reactive pulsations",
   "type": "module",
   "main": "index.js",

package/runtime/index.js

@@ -1,27 +1,89 @@
 /**
  * Pulse Runtime - Main exports
+ *
+ * Core modules are re-exported here for convenience.
+ * Development-only modules (devtools, hmr) should be imported directly
+ * from their respective paths to enable tree-shaking in production.
  */
 
+// Core reactivity
 export * from './pulse.js';
+
+// DOM creation and manipulation
 export * from './dom.js';
+
+// Routing
 export * from './router.js';
+
+// State management
 export * from './store.js';
-export * from './native.js';
-export * from './logger.js';
-export * from './a11y.js';
+
+// Context API
 export * from './context.js';
+
+// Async primitives (useAsync, useResource, usePolling)
+export * from './async.js';
+
+// Form handling (useForm, useField, validators)
+export * from './form.js';
+
+// HTTP client
+export * from './http.js';
+
+// WebSocket client
 export * from './websocket.js';
+
+// GraphQL client
 export * from './graphql.js';
+
+// Server-side rendering
 export * from './ssr.js';
 
+// Accessibility utilities
+export * from './a11y.js';
+
+// Native mobile bridge
+export * from './native.js';
+
+// Logging
+export * from './logger.js';
+
+// Security utilities (XSS prevention, URL sanitization)
+export * from './utils.js';
+
+// Error classes
+export * from './errors.js';
+
+// LRU Cache
+export * from './lru-cache.js';
+
+// DOM Adapter (for SSR/testing)
+export * from './dom-adapter.js';
+
+// Default exports for namespace imports
 export { default as PulseCore } from './pulse.js';
 export { default as PulseDOM } from './dom.js';
 export { default as PulseRouter } from './router.js';
 export { default as PulseStore } from './store.js';
-export { default as PulseNative } from './native.js';
-export { default as PulseLogger } from './logger.js';
-export { default as PulseA11y } from './a11y.js';
 export { default as PulseContext } from './context.js';
+export { default as PulseAsync } from './async.js';
+export { default as PulseForm } from './form.js';
+export { default as PulseHttp } from './http.js';
 export { default as PulseWebSocket } from './websocket.js';
 export { default as PulseGraphQL } from './graphql.js';
 export { default as PulseSSR } from './ssr.js';
+export { default as PulseA11y } from './a11y.js';
+export { default as PulseNative } from './native.js';
+export { default as PulseLogger } from './logger.js';
+
+// Note: The following modules are intentionally NOT re-exported here
+// to enable tree-shaking. Import them directly when needed:
+//
+// Development tools (adds overhead, use only in dev):
+//   import { enableDevTools, trackedPulse } from 'pulse-js-framework/runtime/devtools';
+//
+// HMR utilities (Vite/webpack integration):
+//   import { createHMRContext } from 'pulse-js-framework/runtime/hmr';
+//
+// Lite build (minimal ~5KB bundle):
+//   import { pulse, effect, el, mount } from 'pulse-js-framework/runtime/lite';