addonova 1.0.0

package/bin/index.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import process from 'node:process';
+import { init } from '../src/commands/init.js';
+
+const [command, ...args] = process.argv.slice(2);
+
+switch (command) {
+  case 'init':
+    await init(args);
+    break;
+  case '--help':
+  case '-h':
+  default:
+    console.log(`
+  addonova — Cross-browser WebExtension toolkit
+
+  Usage:
+    npx addonova init <project-name>   Scaffold a new extension project
+    npx addonova --help                 Show this help
+    `);
+    break;
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "addonova",
+  "version": "1.0.0",
+  "description": "Web Extension Framework",
+  "type": "module",
+  "bin": {
+    "addonova": "./bin/index.js"
+  },
+  "exports": {
+    ".": "./src/index.js",
+    "./*": "./src/*.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "template/"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "webextension",
+    "browser-extension",
+    "chrome-extension",
+    "firefox-addon",
+    "scaffold",
+    "cli"
+  ],
+  "license": "ISC",
+  "author": "Hemanta gayen",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/code-hemu/addonova.git"
+  },
+  "homepage": "https://github.com/code-hemu/addonova#readme",
+  "bugs": {
+    "url": "https://github.com/code-hemu/addonova/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/commands/init.js

@@ -0,0 +1,108 @@
+import { existsSync } from 'node:fs';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import process from 'node:process';
+import { selectBrowsers, askQuestion } from '../utils/prompts.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TEMPLATE_DIR = path.resolve(__dirname, '../../template');
+
+const VARIABLE_RE = /\{\{\s*(\w+)\s*\}\}/g;
+
+function render(template, vars) {
+  return template.replace(VARIABLE_RE, (_, key) => vars[key] ?? `{{${key}}}`);
+}
+
+async function copyDir(src, dest, vars) {
+  await fs.mkdir(dest, { recursive: true });
+  const entries = await fs.readdir(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name.replace(/\.tpl$/, ''));
+
+    if (entry.isDirectory()) {
+      await copyDir(srcPath, destPath, vars);
+    } else if (entry.name.endsWith('.tpl')) {
+      const content = await fs.readFile(srcPath, 'utf-8');
+      await fs.writeFile(destPath, render(content, vars), 'utf-8');
+    } else {
+      await fs.copyFile(srcPath, destPath);
+    }
+  }
+}
+
+async function installDependencies(projectDir) {
+  console.log('\n⚡ Installing dependencies...');
+  const { execSync } = await import('node:child_process');
+  execSync('npm install', { cwd: projectDir, stdio: 'inherit' });
+}
+
+async function detectPackageManager() {
+  const hasLock = f => existsSync(path.join(process.cwd(), f));
+
+  if (hasLock('pnpm-lock.yaml')) return 'pnpm';
+  if (hasLock('yarn.lock')) return 'yarn';
+  if (hasLock('package-lock.json') || hasLock('bun.lock')) return 'npm';
+  return 'npm';
+}
+
+export async function init(args) {
+  let projectName = args[0];
+
+  if (!projectName) {
+    projectName = await askQuestion('Project name: ');
+  }
+
+  if (!projectName) {
+    console.error('❌ Project name is required.');
+    process.exit(1);
+  }
+
+  const projectDir = path.resolve(process.cwd(), projectName);
+
+  if (existsSync(projectDir)) {
+    console.error(`❌ Directory "${projectName}" already exists.`);
+    process.exit(1);
+  }
+
+  const browsers = await selectBrowsers();
+  const selected = browsers.length > 0 ? browsers : ['chrome', 'firefox'];
+
+  const vars = {
+    name: projectName,
+    description: 'A cross-browser WebExtension',
+    version: '1.0.0',
+    browsers: JSON.stringify(selected),
+    browsersList: selected.join(', '),
+    year: new Date().getFullYear().toString(),
+  };
+
+  console.log(`\n📁 Scaffolding "${projectName}" for: ${selected.join(', ')}`);
+  await copyDir(TEMPLATE_DIR, projectDir, vars);
+
+  console.log('✔ Template files created.');
+
+  const pm = detectPackageManager();
+  const shouldInstall = await askQuestion('\nRun npm install now? (Y/n): ');
+  if (shouldInstall.toLowerCase() !== 'n') {
+    await installDependencies(projectDir);
+  }
+
+  console.log(`
+┌──────────────────────────────────────────────┐
+│  ✅  "${projectName}" is ready!                │
+│                                              │
+│  ${projectDir}               │
+│                                              │
+│  Next steps:                                 │
+│    cd ${projectName}                          │
+│    npm run build -- --all                     │
+│    npm run build -- --chrome --debug          │
+│    npm run build -- --firefox --watch         │
+│                                              │
+│  Targets: ${selected.join(', ').padEnd(30)}│
+└──────────────────────────────────────────────┘
+`);
+}

package/src/index.js

@@ -0,0 +1 @@
+export { init } from './commands/init.js';

package/src/utils/prompts.js

@@ -0,0 +1,32 @@
+import * as readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+
+export async function askQuestion(query) {
+  const rl = readline.createInterface({ input, output });
+  const answer = await rl.question(query);
+  rl.close();
+  return answer.trim();
+}
+
+export async function confirm(query) {
+  const answer = await askQuestion(`${query} (Y/n): `);
+  return answer.toLowerCase() !== 'n';
+}
+
+export async function selectBrowsers() {
+  const allBrowsers = [
+    { value: 'chrome', label: 'Chrome (MV3)' },
+    { value: 'edge', label: 'Edge' },
+    { value: 'firefox', label: 'Firefox' },
+    { value: 'opera', label: 'Opera' },
+    { value: 'naver', label: 'Naver Whale' },
+    { value: 'thunderbird', label: 'Thunderbird' },
+  ];
+
+  console.log('\nSelect target browsers (comma-separated, e.g. 1,3,5):');
+  allBrowsers.forEach((b, i) => console.log(`  [${i + 1}] ${b.label} (${b.value})`));
+
+  const answer = await askQuestion('Browsers: ');
+  const indices = answer.split(',').map(s => parseInt(s.trim(), 10) - 1);
+  return indices.filter(i => i >= 0 && i < allBrowsers.length).map(i => allBrowsers[i].value);
+}

package/template/config/chrome.js

@@ -0,0 +1,29 @@
+export default {
+  js: {
+    entry: {
+      '': ['src/js/background.js', 'src/js/popup.js'],
+    },
+    filename: '[name]',
+    minify: true,
+    sourcemap: false,
+  },
+  scss: {
+    entry: {
+      '': ['src/scss/popup.scss'],
+    },
+    filename: '[name]',
+    minify: true,
+    sourcemap: false,
+  },
+  html: {
+    entry: {
+      '': ['src/html/popup.html'],
+    },
+    filename: '[name]',
+  },
+  assets: {
+    entry: {
+      '': ['src/assets/**/*'],
+    },
+  },
+};

package/template/config/edge.js

@@ -0,0 +1,29 @@
+export default {
+  js: {
+    entry: {
+      '': ['src/js/background.js', 'src/js/popup.js'],
+    },
+    filename: '[name]',
+    minify: true,
+    sourcemap: false,
+  },
+  scss: {
+    entry: {
+      '': ['src/scss/popup.scss'],
+    },
+    filename: '[name]',
+    minify: true,
+    sourcemap: false,
+  },
+  html: {
+    entry: {
+      '': ['src/html/popup.html'],
+    },
+    filename: '[name]',
+  },
+  assets: {
+    entry: {
+      '': ['src/assets/**/*'],
+    },
+  },
+};

package/template/config/firefox.js

@@ -0,0 +1,29 @@
+export default {
+  js: {
+    entry: {
+      '': ['src/js/background.js', 'src/js/popup.js'],
+    },
+    filename: '[name]',
+    minify: true,
+    sourcemap: false,
+  },
+  scss: {
+    entry: {
+      '': ['src/scss/popup.scss'],
+    },
+    filename: '[name]',
+    minify: true,
+    sourcemap: false,
+  },
+  html: {
+    entry: {
+      '': ['src/html/popup.html'],
+    },
+    filename: '[name]',
+  },
+  assets: {
+    entry: {
+      '': ['src/assets/**/*'],
+    },
+  },
+};

package/template/config/naver.js

@@ -0,0 +1,29 @@
+export default {
+  js: {
+    entry: {
+      '': ['src/js/background.js', 'src/js/popup.js'],
+    },
+    filename: '[name]',
+    minify: true,
+    sourcemap: false,
+  },
+  scss: {
+    entry: {
+      '': ['src/scss/popup.scss'],
+    },
+    filename: '[name]',
+    minify: true,
+    sourcemap: false,
+  },
+  html: {
+    entry: {
+      '': ['src/html/popup.html'],
+    },
+    filename: '[name]',
+  },
+  assets: {
+    entry: {
+      '': ['src/assets/**/*'],
+    },
+  },
+};

package/template/config/opera.js

@@ -0,0 +1,29 @@
+export default {
+  js: {
+    entry: {
+      '': ['src/js/background.js', 'src/js/popup.js'],
+    },
+    filename: '[name]',
+    minify: true,
+    sourcemap: false,
+  },
+  scss: {
+    entry: {
+      '': ['src/scss/popup.scss'],
+    },
+    filename: '[name]',
+    minify: true,
+    sourcemap: false,
+  },
+  html: {
+    entry: {
+      '': ['src/html/popup.html'],
+    },
+    filename: '[name]',
+  },
+  assets: {
+    entry: {
+      '': ['src/assets/**/*'],
+    },
+  },
+};

package/template/config/thunderbird.js

@@ -0,0 +1,29 @@
+export default {
+  js: {
+    entry: {
+      '': ['src/js/background.js', 'src/js/popup.js'],
+    },
+    filename: '[name]',
+    minify: true,
+    sourcemap: false,
+  },
+  scss: {
+    entry: {
+      '': ['src/scss/popup.scss'],
+    },
+    filename: '[name]',
+    minify: true,
+    sourcemap: false,
+  },
+  html: {
+    entry: {
+      '': ['src/html/popup.html'],
+    },
+    filename: '[name]',
+  },
+  assets: {
+    entry: {
+      '': ['src/assets/**/*'],
+    },
+  },
+};

package/template/package.json.tpl

@@ -0,0 +1,39 @@
+{
+  "name": "{{name}}",
+  "version": "{{version}}",
+  "description": "{{description}}",
+  "json.schemaValidation": "off",
+  "license": "GPLv3",
+  "author": "{{name}}",
+  "type": "module",
+  "engines": {
+    "node": ">=22",
+    "npm": ">=11"
+  },
+  "scripts": {
+    "build": "node --max-old-space-size=3072 workspace/tasks/cli.js build --all --release",
+    "release": "node workspace/tasks/cli.js build --all --release",
+    "release:chrome": "node --max-old-space-size=3072 workspace/tasks/cli.js build --chrome --release",
+    "release:edge": "node --max-old-space-size=3072 workspace/tasks/cli.js build --edge --release",
+    "release:opera": "node --max-old-space-size=3072 workspace/tasks/cli.js build --opera --release",
+    "release:naver": "node --max-old-space-size=3072 workspace/tasks/cli.js build --naver --release",
+    "edge": "node --max-old-space-size=3072 workspace/tasks/cli.js build --edge --release",
+    "help": "node --max-old-space-size=3072 workspace/tasks/cli.js --help",
+    "debug": "node --max-old-space-size=3072 workspace/tasks/cli.js build --all --debug",
+    "debug:chrome": "node --max-old-space-size=3072 workspace/tasks/cli.js build --chrome --debug",
+    "watch": "node --max-old-space-size=3072 workspace/tasks/cli.js build --all --debug --watch",
+    "zip": "node --max-old-space-size=3072 workspace/tasks/cli.js zip",
+    "chrome:watch": "node --max-old-space-size=3072 workspace/tasks/cli.js build --chrome --release --watch",
+    "locales": "node --max-old-space-size=3072 workspace/tools/translate.js"
+  },
+  "devDependencies": {
+    "@craftamap/esbuild-plugin-html": "^0.9.0",
+    "chokidar": "^5.0.0",
+    "esbuild": "^0.27.3",
+    "esbuild-sass-plugin": "^3.6.0",
+    "globals": "^17.4.0",
+    "globby": "^16.1.0",
+    "sass": "^1.97.3",
+    "yazl": "^3.3.1"
+  }
+}

package/template/src/_locales/en.i18n

@@ -0,0 +1,4 @@
+@extensionName
+{{name}}
+@extensionDescription
+{{description}}

package/template/src/html/popup.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <link rel="stylesheet" href="popup.css" />
+</head>
+<body>
+  <div id="app">
+    <h1 id="heading"></h1>
+    <p id="description"></p>
+  </div>
+  <script src="popup.js"></script>
+</body>
+</html>

package/template/src/js/background.js

@@ -0,0 +1 @@
+console.log('Background service worker started');

package/template/src/js/popup.js

@@ -0,0 +1,6 @@
+document.addEventListener('DOMContentLoaded', () => {
+  document.getElementById('heading').textContent =
+    chrome.i18n.getMessage('extensionName');
+  document.getElementById('description').textContent =
+    chrome.i18n.getMessage('extensionDescription');
+});

package/template/src/manifest/manifest-firefox.json

@@ -0,0 +1,29 @@
+{
+  "manifest_version": 3,
+  "name": "__MSG_extensionName__",
+  "version": "{{version}}",
+  "description": "__MSG_extensionDescription__",
+  "default_locale": "en",
+  "icons": {
+    "16": "assets/icon-16.png",
+    "48": "assets/icon-48.png",
+    "128": "assets/icon-128.png"
+  },
+  "action": {
+    "default_popup": "popup.html",
+    "default_icon": {
+      "16": "assets/icon-16.png",
+      "48": "assets/icon-48.png",
+      "128": "assets/icon-128.png"
+    }
+  },
+  "background": {
+    "scripts": ["background.js"]
+  },
+  "browser_specific_settings": {
+    "gecko": {
+      "id": "{{name}}@example.org"
+    }
+  },
+  "permissions": []
+}

package/template/src/manifest/manifest.json

@@ -0,0 +1,24 @@
+{
+  "manifest_version": 3,
+  "name": "__MSG_extensionName__",
+  "version": "{{version}}",
+  "description": "__MSG_extensionDescription__",
+  "default_locale": "en",
+  "icons": {
+    "16": "assets/icon-16.png",
+    "48": "assets/icon-48.png",
+    "128": "assets/icon-128.png"
+  },
+  "action": {
+    "default_popup": "popup.html",
+    "default_icon": {
+      "16": "assets/icon-16.png",
+      "48": "assets/icon-48.png",
+      "128": "assets/icon-128.png"
+    }
+  },
+  "background": {
+    "service_worker": "background.js"
+  },
+  "permissions": []
+}

package/template/src/scss/popup.scss

@@ -0,0 +1,25 @@
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+body {
+  width: 320px;
+  padding: 16px;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+}
+
+#app {
+  text-align: center;
+}
+
+h1 {
+  font-size: 18px;
+  margin-bottom: 8px;
+}
+
+p {
+  font-size: 14px;
+  color: #666;
+}

package/template/tasks/build.js

@@ -0,0 +1,82 @@
+import process from 'node:process';
+import createFolder from './folder.js';
+import bundleCSS from './bundle-css.js';
+import bundleJS from './bundle-js.js';
+import bundleHTML from './bundle-html.js';
+import bundleLocales from './bundle-locales.js';
+import bundleManifest from './bundle-manifest.js';
+import assetsCopy from './copy.js';
+import zip from './zip.js';
+import {log} from './utils.js';
+import {runTasks} from './task.js';
+
+const args = process.argv.slice(2);
+
+const platforms = [
+    'chrome',
+    'edge',
+    'naver',
+    'opera',
+    'firefox',
+    'thunderbird'
+];
+
+let platform = [];
+
+if (args.includes('--all')) {
+    platform = platforms;
+} else {
+    if (args.includes('--chrome')) platform.push('chrome');
+    if (args.includes('--edge')) platform.push('edge');
+    if (args.includes('--opera')) platform.push('opera');
+    if (args.includes('--naver')) platform.push('naver');
+    if (args.includes('--firefox')) platform.push('firefox');
+    if (args.includes('--thunderbird')) platform.push('thunderbird');
+}
+
+const versionArg = args.find((a) => a.startsWith('--version='));
+const version = versionArg ? versionArg.split('=')[1] : null;
+
+const settings = {
+    platforms: platform,
+    version: version,
+    isWatch: args.includes('--watch'),
+    isRelease: args.includes('--release'),
+    isDebug: args.includes('--debug'),
+    isTest: args.includes('--test'),
+    logInfo: args.includes('--log-info'),
+    logWarn: args.includes('--log-warn')
+}
+
+const standardTask = [
+    createFolder,
+    bundleHTML,
+    bundleCSS,
+    bundleJS,
+    bundleLocales,
+    bundleManifest,
+    assetsCopy
+];
+
+const buildTask = [
+    ...standardTask,
+    zip,
+];
+
+(async () => {
+    log.ok('--------------------------------');
+    log.ok('🚀 Build started');
+    try {
+        await runTasks(settings.isDebug ? standardTask : buildTask, settings);
+        if (settings.isWatch) {
+            standardTask.forEach((task) => task.watch(settings.platforms, settings.isDebug));
+            log.ok('👀 Watching...');
+        } else {
+            log.ok('MISSION PASSED! RESPECT +');
+        }
+    }catch (err) {
+        console.log(err);
+        log.error(`MISSION FAILED!`);
+        process.exit(13);
+    }
+})();