neutronium 2.5.3 → 2.8.0

package/index.d.ts

@@ -0,0 +1,117 @@
+// @types/netronium/index.d.ts
+
+type StateUpdater<T> = (newValue: T) => void;
+type Component<T = any> = (props?: T) => HTMLElement | DocumentFragment;
+
+let globalState: any[] = [];
+let stateIndex = 0;
+
+// Reset index before each render
+export function resetStateIndex(): void {
+  stateIndex = 0;
+}
+
+// Custom useState
+export function useState<T>(initialValue: T): [T, StateUpdater<T>] {
+  const currentIndex = stateIndex;
+
+  if (globalState[currentIndex] === undefined) {
+    globalState[currentIndex] = initialValue;
+  }
+
+  function setState(newValue: T): void {
+    globalState[currentIndex] = newValue;
+
+    // Re-render
+    const root = window.__NEUTRONIUM_ROOT__ as HTMLElement | null;
+    const renderFn = window.__NEUTRONIUM_RENDER_FN__ as (() => Node) | null;
+
+    if (root && typeof renderFn === 'function') {
+      root.innerHTML = '';
+      resetStateIndex();
+      const newVNode = renderFn();
+      root.appendChild(newVNode);
+    }
+  }
+
+  stateIndex++;
+  return [globalState[currentIndex], setState];
+}
+
+// JSX-compatible hyperscript function
+export function h(
+  type: string | Component,
+  props: { [key: string]: any } = {},
+  ...children: any[]
+): HTMLElement | DocumentFragment {
+  if (typeof type === 'function') {
+    props = props || {};
+    props.children = children.flat();
+    return type(props);
+  }
+
+  const el = document.createElement(type);
+
+  for (const [key, value] of Object.entries(props)) {
+    if (key.startsWith('on') && typeof value === 'function') {
+      el.addEventListener(key.slice(2).toLowerCase(), value);
+    } else if (key === 'ref' && typeof value === 'function') {
+      value(el);
+    } else {
+      el.setAttribute(key, value);
+    }
+  }
+
+  children.flat().forEach(child => {
+    if (typeof child === 'string' || typeof child === 'number') {
+      el.appendChild(document.createTextNode(child));
+    } else if (child instanceof Node) {
+      el.appendChild(child);
+    }
+  });
+
+  return el;
+}
+
+// Mount app to DOM
+export function createApp(component: () => Node) {
+  return {
+    mount(selector: string | HTMLElement): Node | null {
+      const root =
+        typeof selector === 'string'
+          ? document.querySelector(selector)
+          : selector;
+
+      if (!root) {
+        console.error(`❌ Root element '${selector}' not found`);
+        return null;
+      }
+
+      window.__NEUTRONIUM_ROOT__ = root;
+      window.__NEUTRONIUM_RENDER_FN__ = component;
+
+      resetStateIndex();
+      const vnode = component();
+      root.innerHTML = '';
+      root.appendChild(vnode);
+
+      return vnode;
+    }
+  };
+}
+
+// Fragment support
+export function Fragment(props: { children?: any[] }): DocumentFragment {
+  const frag = document.createDocumentFragment();
+  const children = props.children ?? [];
+
+  (Array.isArray(children) ? children : [children]).forEach(child => {
+    if (typeof child === 'string' || typeof child === 'number') {
+      frag.appendChild(document.createTextNode(child));
+    } else if (child instanceof Node) {
+      frag.appendChild(child);
+    }
+  });
+
+  return frag;
+}

package/package.json

@@ -1,41 +1,14 @@
 {
   "name": "neutronium",
-  "version": "2.5.3",
-  "description": "A dense, efficient JavaScript framework for building modern web applications",
-  "main": "src/index.js",
-  "type": "commonjs",
+  "version": "2.8.0",
+  "description": "",
+  "main": "index.ts",
   "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
   },
-  "export": {
-    ".": "src/index.js"
-  },
-  "bin": {
-    "neu-cli": "./cli/index.js",
-    "neu": "src/index.js"
-  },
-  "exports": {
-    ".": "./src/index.js"
-  },
-  "keywords": [
-    "framework",
-    "javascript",
-    "frontend",
-    "ui",
-    "components"
-  ],
-  "author": "PFMCODES",
-  "license": "MIT",
-  "dependencies": {
-    "chokidar": "^4.0.3",
-    "inquirer": "^12.7.0",
-    "jsdom": "^26.1.0",
-    "mime": "^4.0.7",
-    "open": "^10.1.2",
-    "ws": "^8.18.3",
-    "@babel/cli": "^7.28.0",
-    "@babel/core": "^7.28.0",
-    "@babel/plugin-transform-react-jsx": "^7.27.1",
-    "@babel/preset-env": "^7.28.0",
-    "@babel/preset-react": "^7.27.1"
-  }
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "types": "./index.d.ts"
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 PFMCODES
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,52 +0,0 @@
-# ⚛️ Neutronium
-
-**Ultra-dense JavaScript framework – maximum performance, minimal overhead**
-
-[![NPM Downloads](https://img.shields.io/npm/dw/neutronium?style=flat-square)](https://www.npmjs.com/package/neutronium)
-[![License: MIT](https://img.shields.io/npm/l/neutronium?style=flat-square)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/npm/v/neutronium?style=flat-square)](https://www.npmjs.com/package/neutronium)
-
----
-
-## 🚀 About
-
-**Neutronium** is a lightweight, efficient JavaScript framework designed for building modern web applications with **React-like simplicity** but **minimal overhead**.
-
-> Ultra-fast ⚡️. Tiny footprint 📦. No build tools 🛠️. Pure JavaScript ✨.
-
----
-
-## ✨ Features
-
-- ⚡️ **Blazing fast rendering**
-- 🧠 **Simple component logic**
-- 🔌 **No dependencies or virtual DOM**
-- 📦 **Small size (~139kB unpacked)**
-- 🛠️ **Works out of the box**
-- 🔁 **Easy JSX-style structure**
-
----
-
-## 📦 Installation
-
-```bash
-npm i neutronium
-```
-
-## Usage Example
-```jsx
-// App.js
-function Greeting(props) {
-  return <h2>Hello, {props.name}!</h2>;
-}
-
-export default function App() {
-  return (
-    <>
-      <h1>Welcome to Neutronium</h1>
-      {Greeting({ name: "Krushna" })}
-    </>
-  );
-}
-```
-

package/cli/index.js

@@ -1,178 +0,0 @@
-#!/usr/bin/env node
-
-// --- Module Imports ---
-const { default: inquirer } = require('inquirer');
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
-const { transformSync } = require('@babel/core');
-const { compileProject, compileProjectWatch } = require('../compiler/compiler');
-
-// --- CLI Arguments ---
-const [, , command, ...args] = process.argv;
-
-// --- Default Babel Config ---
-const babelRc = `{
-"plugins": [
-  ["@babel/plugin-transform-react-jsx", {
-    "pragma": "_neutronium.h",
-    "pragmaFrag": "_neutronium.Fragment",
-    "runtime": "classic",
-    "useBuiltIns": false,
-    "sourceMaps": true,
-    "comments": false,
-    "minified": true,
-  }]
-]
-`;
-
-// --- Default App.js Starter Template ---
-const AppJs = `
-import { h, createApp } from 'neutronium';
-
-function App() {
-    return (
-        <div class="container">
-            <h1>Hello from Neutronium!</h1>
-            <p>Start building your app in JSX!</p>
-        </div>
-    );
-}
-
-createApp(App).mount('#app');
-`;
-
-// --- Basic HTML Template Function ---
-const htmlTemplate = (title, jsCode) => `
-<!DOCTYPE html>
-<html>
-<head>
-  <meta charset="UTF-8" />
-  <title>${title}</title>
-</head>
-<body>
-  <div id="app"></div>
-  <script type="module">
-  ${jsCode}
-  </script>
-</body>
-</html>
-`.trim();
-
-// --- Project Initializer Function ---
-async function init() {
-  let targetPath = process.cwd();   // default to current folder
-  let createdFolder = false;
-
-  // Prompt user for init location
-  const { confirmInit } = await inquirer.prompt([
-    {
-      type: 'confirm',
-      name: 'confirmInit',
-      message: 'Initialize a Neutronium app in this folder?',
-      default: true
-    }
-  ]);
-
-  let appName = 'neutronium-app';
-
-  // If no, ask for folder name and create it
-  if (!confirmInit) {
-    const { projectName } = await inquirer.prompt([
-      {
-        type: 'input',
-        name: 'projectName',
-        message: 'Please enter your project name:',
-        default: 'neutronium-app'
-      }
-    ]);
-    appName = projectName;
-    targetPath = path.resolve(process.cwd(), projectName);
-    createdFolder = true;
-    if (!fs.existsSync(targetPath)) fs.mkdirSync(targetPath);
-    else console.log('⚠️ Folder already exists. Using it anyway.');
-  }
-
-  // Write App.js
-  const appPath = path.join(targetPath, 'App.js');
-  fs.writeFileSync(appPath, AppJs.trim());
-
-  // Write .babelrc
-  fs.writeFileSync(path.join(targetPath, '.babelrc'), babelRc);
-
-  // Init NPM and install dependencies
-  execSync('npm init -y', { cwd: targetPath, stdio: 'inherit' });
-  execSync('npm install neutronium', { cwd: targetPath, stdio: 'inherit' });
-  execSync('npm install --save-dev @babel/core @babel/cli @babel/plugin-transform-react-jsx', {
-    cwd: targetPath,
-    stdio: 'inherit'
-  });
-
-  // Transpile App.js (in-memory) for preview HTML
-  const jsxWithImport = `import * as _neutronium from 'neutronium';\n\n${AppJs}`;
-  const result = transformSync(jsxWithImport, {
-    filename: 'App.js',
-    babelrc: false,
-    configFile: false,
-    presets: [],
-    plugins: [
-      ['@babel/plugin-transform-react-jsx', {
-        pragma: '_neutronium.h',
-        pragmaFrag: '_neutronium.Fragment',
-        runtime: 'classic',
-        useBuiltIns: false,
-        sourceMaps: true,
-        comments: false,
-        minified: true,
-      }]
-    ]
-  });
-
-  // Write dist/index.html with inlined JS
-  const finalHtml = htmlTemplate(appName, result.code);
-  const distPath = path.join(targetPath, 'dist');
-  if (!fs.existsSync(distPath)) fs.mkdirSync(distPath);
-  fs.writeFileSync(path.join(distPath, 'index.html'), finalHtml);
-
-  // Print instructions to user
-  const folderCmd = createdFolder ? `cd ${path.basename(targetPath)}` : '';
-  console.log('\n✅ Neutronium app is ready!');
-  console.log(`➡️  Run the following to get started:\n\n   ${folderCmd}\n   npx serve dist\n`);
-}
-
-// --- CLI Command Routing ---
-switch (command) {
-  case 'init':
-  case 'create-app':
-  case 'create-neu-app':
-  case 'create-new-app':
-  case 'create-neutronium-app':
-    init();
-    break;
-
-  case 'start':
-    // Watch mode for development
-    if (args[0] === '--watch') {
-      compileProjectWatch();
-    } else {
-      // Build once without watching
-      compileProject();
-    }
-    break;
-
-  default:
-    // Help text
-    console.log('❌ Unknown command.');
-    console.log(`
-Available Commands:
-
-  init | create-app | create-neutronium-app
-      👉 Initialize a new Neutronium project
-
-  start
-      👉 Compiles your app once
-
-  start --watch
-      👉 Start dev server and rebuild on changes
-`);
-}

package/compiler/compiler.js

@@ -1,131 +0,0 @@
-const babel = require('@babel/core');
-const path = require('path');
-const fs = require('fs');
-const { baseHtml } = require('./template');
-const { log, writeFile, ensureDir } = require('./utils');
-const chokidar = require('chokidar');
-const http = require('http');
-const { default: Mime } = require('mime');
-const WebSocket = require('ws');
-const { default: open } = require('open');
-
-function compileProject(projectDir = process.cwd()) {
-  const appJsPath = path.join(projectDir, 'App.js');
-  const distDir = path.join(projectDir, 'dist');
-  const outHtmlPath = path.join(distDir, 'index.html');
-  const outJsPath = path.join(distDir, 'App.compiled.js');
-  const neutroniumPath = '../node_modules/neutronium/src/index.js';
-
-  try {
-    log('📖 Reading App.js...');
-    const sourceCode = fs.readFileSync(appJsPath, 'utf-8');
-
-    log('⚙️ Compiling JSX with Babel...');
-    let { code: transpiled } = babel.transformSync(sourceCode, {
-  filename: 'App.js', // or use path.basename(appJsPath)
-  babelrc: false,
-  configFile: false,
-  presets: [],
-  plugins: [
-  ['@babel/plugin-transform-react-jsx', {
-    pragma: '_neutronium.h',
-    pragmaFrag: '_neutronium.Fragment',
-    runtime: 'classic',
-    useBuiltIns: false, // <- IMPORTANT
-    sourceMaps: true,
-    comments: false,
-    minified: true,
-  }]
-]
-});
-
-    // Remove CommonJS require if present
-    transpiled = transpiled.replace(
-      /(const|var|let)\s+_neutronium\s*=\s*require\(["']neutronium["']\);?/g,
-      ''
-    );
-    transpiled = transpiled.replace("from 'neutronium';", "from '../node_modules/neutronium/src/index.js';")
-
-    const finalJsCode = `
-import * as _neutronium from '${neutroniumPath}';
-
-"use strict";
-
-${transpiled}
-
-_neutronium.createApp(App).mount('#app');
-`.trim();
-
-    ensureDir(distDir);
-    writeFile(outJsPath, finalJsCode);
-
-    log('🛠️ Generating index.html...');
-    const finalHtml = baseHtml(`<div id="app"></div>`, 'App.compiled.js');
-    writeFile(outHtmlPath, finalHtml);
-
-    log('✅ Compilation complete!');
-    log(`➡️ Output: ${outHtmlPath}`);
-  } catch (e) {
-    console.error('❌ Compilation failed:', e.message);
-  }
-}
-
-function compileProjectWatch(projectDir = process.cwd(), port = 3000) {
-  const appJsPath = path.join(projectDir, 'App.js');
-
-  const server = serveProject(projectDir, port);
-  compileProject(projectDir);
-
-  log('👀 Watching App.js for changes...');
-  chokidar.watch(appJsPath).on('change', () => {
-    console.clear();
-    log('🔁 Detected change in App.js...');
-    compileProject(projectDir);
-    if (server.broadcastReload) {
-      server.broadcastReload();
-    }
-  });
-}
-
-function serveProject(projectDir = process.cwd(), port = 3000) {
-  const distDir = path.join(projectDir, 'dist');
-
-  const server = http.createServer((req, res) => {
-    let reqPath = req.url;
-
-    // Redirect "/" to "dist/index.html"
-    if (reqPath === '/' || reqPath === '/index.html') {
-      reqPath = '/dist/index.html';
-    }
-
-    const filePath = path.join(projectDir, reqPath);
-
-    if (!fs.existsSync(filePath)) {
-      res.writeHead(404);
-      return res.end('404 Not Found');
-    }
-
-    const content = fs.readFileSync(filePath);
-    res.writeHead(200, { 'Content-Type': Mime.getType(filePath) });
-    res.end(content);
-  });
-
-  const wss = new WebSocket.Server({ server });
-
-  server.broadcastReload = () => {
-    wss.clients.forEach(client => {
-      if (client.readyState === WebSocket.OPEN) {
-        client.send('reload');
-      }
-    });
-  };
-
-  server.listen(port, () => {
-    log(`🚀 Server running at http://localhost:${port}`);
-    open(`http://localhost:${port}/dist/index.html`);
-  });
-
-  return server;
-}
-
-module.exports = { compileProject, compileProjectWatch };

package/compiler/template.js

@@ -1,26 +0,0 @@
-function baseHtml(appHtml, scriptName) {
-  return `
-<!DOCTYPE html>
-<html>
-<head>
-  <meta charset="UTF-8">
-  <title>Neutronium App</title>
-</head>
-<body>
-  ${appHtml}
-  <script type="module" src="./${scriptName}"></script>
-  <script>
-    const ws = new WebSocket('ws://' + location.host);
-    ws.onmessage = (msg) => {
-      if (msg.data === 'reload') {
-        console.log('[Neutronium] Reloading...');
-        location.reload();
-      }
-    };
-  </script>
-</body>
-</html>
-`.trim();
-}
-
-module.exports = { baseHtml };

package/compiler/utils.js

@@ -1,22 +0,0 @@
-// compiler/utils.js
-
-const fs = require('fs');
-const path = require('path');
-
-function writeFile(filePath, content) {
-    fs.writeFileSync(filePath, content, 'utf-8');
-}
-
-function readFile(filePath) {
-    return fs.readFileSync(filePath, 'utf-8');
-}
-
-function ensureDir(dir) {
-    if (!fs.existsSync(dir)) fs.mkdirSync(dir);
-}
-
-function log(msg) {
-    console.log(`🔹 ${msg}`);
-}
-
-module.exports = { writeFile, readFile, ensureDir, log };

package/src/index.js

@@ -1,104 +0,0 @@
-// src/index.js
-
-let globalState = [];
-let stateIndex = 0;
-
-// This will be called before rendering begins
-export function resetStateIndex() {
-  stateIndex = 0;
-}
-
-// Custom useState implementation
-function useState(initialValue) {
-  const current = stateIndex;
-
-  if (globalState[current] === undefined) {
-    globalState[current] = initialValue;
-  }
-
-  function setState(newValue) {
-    globalState[current] = newValue;
-
-    // Re-render the entire app
-    if (window.__NEUTRONIUM_ROOT__ && typeof window.__NEUTRONIUM_RENDER_FN__ === 'function') {
-      window.__NEUTRONIUM_ROOT__.innerHTML = '';
-      resetStateIndex();
-      const newVNode = window.__NEUTRONIUM_RENDER_FN__();
-      window.__NEUTRONIUM_ROOT__.appendChild(newVNode);
-    }
-  }
-
-  stateIndex++;
-  return [globalState[current], setState];
-}
-
-function h(type, props = {}, ...children) {
-  if (typeof type === 'function') {
-    // 🔧 Add children to props
-    props = props || {};
-    props.children = children.flat(); // ✅ critical fix
-    return type(props);
-  }
-
-  const el = document.createElement(type);
-
-  for (const [key, value] of Object.entries(props || {})) {
-    if (key.startsWith('on') && typeof value === 'function') {
-      el.addEventListener(key.slice(2).toLowerCase(), value);
-    } else if (key === 'ref' && typeof value === 'function') {
-      value(el);
-    } else {
-      el.setAttribute(key, value);
-    }
-  }
-
-  children.flat().forEach(child => {
-    if (typeof child === 'string' || typeof child === 'number') {
-      el.appendChild(document.createTextNode(child));
-    } else if (child instanceof Node) {
-      el.appendChild(child);
-    }
-  });
-
-  return el;
-}
-
-function createApp(component) {
-  return {
-    mount(selector) {
-      const root = typeof selector === 'string' ? document.querySelector(selector) : selector;
-      if (!root) {
-        console.error(`❌ Root element '${selector}' not found`);
-        return null; // return something explicit
-      }
-      // Save render function + root globally so useState can use them
-      window.__NEUTRONIUM_ROOT__ = root;
-      window.__NEUTRONIUM_RENDER_FN__ = component;
-
-      // Reset before first render
-      resetStateIndex();
-      const vnode = component();
-      root.innerHTML = '';
-      root.appendChild(vnode);
-
-      return vnode; // ✅ REQUIRED
-    }
-  };
-}
-
-function Fragment(props = {}) {
-  const frag = document.createDocumentFragment();
-  const children = props.children || [];
-
-  (Array.isArray(children) ? children : [children]).forEach(child => {
-    if (typeof child === 'string' || typeof child === 'number') {
-      frag.appendChild(document.createTextNode(child));
-    } else if (child instanceof Node) {
-      frag.appendChild(child);
-    }
-  });
-
-  return frag;
-}
-
-export { h, createApp, Fragment, useState };