extension-create 2.2.1 → 3.1.0-next.11

package/README.md

@@ -1,29 +1,24 @@
 [npm-version-image]: https://img.shields.io/npm/v/extension-create.svg?color=0971fe
 [npm-version-url]: https://www.npmjs.com/package/extension-create
-[downloads-image]: https://img.shields.io/npm/dm/extension-create.svg?color=2ecc40
-[downloads-url]: https://npmjs.org/package/extension-create
-[empowering-image]: https://img.shields.io/badge/Empowering-Extension.js-0971fe
-[empowering-url]: https://extension.js.org
+[npm-downloads-image]: https://img.shields.io/npm/dm/extension-create.svg?color=0971fe
+[npm-downloads-url]: https://www.npmjs.com/package/extension-create
+[action-image]: https://github.com/extension-js/create/actions/workflows/ci.yml/badge.svg?branch=main
+[action-url]: https://github.com/extension-js/create/actions/workflows/ci.yml
 
-[![Empowering][empowering-image]][empowering-url] [![Version][npm-version-image]][npm-version-url] [![Downloads][downloads-image]][downloads-url]
+[![Version][npm-version-image]][npm-version-url] [![Downloads][npm-downloads-image]][npm-downloads-url] [![CI][action-image]][action-url]
 
 # extension-create
 
-The standalone extension creation engine from [Extension.js](https://github.com/extension-js/extension.js). It provides an intuitive API for programmatically creating browser extensions with support for multiple frameworks and templates.
+The standalone extension creation engine for Extension.js.
+Use it to scaffold a new extension project from a template.
 
-## Installation
-
-Install the package using your preferred package manager:
+## Install
 
 ```bash
 npm install extension-create
-# or
-pnpm add extension-create
-# or
-yarn add extension-create
 ```
 
-## Quick Start
+## Usage
 
 Create a new extension with a single function call:
 
@@ -42,7 +37,7 @@ await extensionCreate('my-react-extension', {
 })
 ```
 
-## API Reference
+## API reference
 
 ### `extensionCreate(projectName, options)`
 
@@ -58,7 +53,7 @@ Creates a new extension project with the specified configuration.
 
 ## Templates
 
-Templates are sourced from the public Examples repository. See the catalog at `https://github.com/extension-js/examples` and reference templates by name, e.g. `content`, `content-react`, `content-vue`, etc.
+Templates are sourced from the public examples repository. Browse the catalog in the [Extension.js examples](https://github.com/extension-js/examples) and reference templates by name (for example, `content`, `content-react`, `content-vue`).
 
 ## License
 

package/dist/lib/find-manifest-json.d.ts

@@ -0,0 +1 @@
+export declare function findManifestJsonPath(projectPath: string): Promise<string>;

package/dist/lib/messages.d.ts

@@ -2,7 +2,7 @@ export declare function destinationNotWriteable(workingDir: string): string;
 export declare function directoryHasConflicts(projectPath: string, conflictingFiles: string[]): Promise<string>;
 export declare function noProjectName(): string;
 export declare function noUrlAllowed(): string;
-export declare function successfullInstall(projectPath: string, projectName: string): Promise<string>;
+export declare function successfullInstall(projectPath: string, projectName: string, depsInstalled: boolean): Promise<string>;
 export declare function startingNewExtension(projectName: string): string;
 export declare function checkingIfPathIsWriteable(): string;
 export declare function scanningPossiblyConflictingFiles(): string;

package/dist/lib/types.d.ts

@@ -5,7 +5,7 @@ declare namespace NodeJS {
         EXTENSION_PUBLIC_BROWSER: 'chrome' | 'edge' | 'firefox' | 'chromium-based' | 'gecko-based';
         EXTENSION_PUBLIC_MODE: 'development' | 'production';
         EXTENSION_PUBLIC_DESCRIPTION_TEXT: string;
-        EXTENSION_PUBLIC_OPENAI_API_KEY: string;
+        EXTENSION_PUBLIC_LLM_API_KEY: string;
         EXTENSION_ENV: 'development' | 'production';
     }
 }

package/dist/module.js

@@ -1,6 +1,6 @@
 "use strict";
 const __rslib_import_meta_url__ = /*#__PURE__*/ function() {
-    return 'undefined' == typeof document ? new (require('url'.replace('', ''))).URL('file:' + __filename).href : document.currentScript && document.currentScript.src || new URL('main.js', document.baseURI).href;
+    return "u" < typeof document ? new (require('url'.replace('', ''))).URL('file:' + __filename).href : document.currentScript && document.currentScript.src || new URL('main.js', document.baseURI).href;
 }();
 var __webpack_require__ = {};
 (()=>{
@@ -25,7 +25,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {
@@ -45,30 +45,30 @@ var external_pintor_default = /*#__PURE__*/ __webpack_require__.n(external_pinto
 const external_package_manager_detector_namespaceObject = require("package-manager-detector");
 function destinationNotWriteable(workingDir) {
     const workingDirFolder = external_path_namespaceObject.basename(workingDir);
-    return `${external_pintor_default().red('ERROR')} Failed to write in the destination directory.\n${external_pintor_default().red('Path is not writable. Ensure you have write permissions for this folder.')}\n${external_pintor_default().red('NOT WRITEABLE')} ${external_pintor_default().underline(workingDirFolder)}`;
+    return `${external_pintor_default().red('Error')} Couldn't write to the destination directory.\n${external_pintor_default().red('Next step: choose a writable path or update folder permissions.')}\n${external_pintor_default().red('Path')} ${external_pintor_default().underline(workingDirFolder)}`;
 }
 async function directoryHasConflicts(projectPath, conflictingFiles) {
     const projectName = external_path_namespaceObject.basename(projectPath);
-    let message = `Conflict! Path to ${external_pintor_default().blue(projectName)} includes conflicting files.\n\n`;
+    let message = `Conflicting files found in ${external_pintor_default().blue(projectName)}.\n\n`;
     for (const file of conflictingFiles){
         const stats = await external_fs_namespaceObject.promises.lstat(external_path_namespaceObject.join(projectPath, file));
         message += stats.isDirectory() ? `   ${external_pintor_default().yellow('-')} ${external_pintor_default().yellow(file)}\n` : `   ${external_pintor_default().yellow('-')} ${external_pintor_default().yellow(file)}\n`;
     }
-    message += `\n${external_pintor_default().red('You need to either rename/remove the files listed above, or choose a new directory name for your extension.')}\n\nPath to conflicting directory: ${external_pintor_default().underline(projectPath)}`;
+    message += `\n${external_pintor_default().red('Next step: remove or rename the files above, or choose a different directory name.')}\n\nPath: ${external_pintor_default().underline(projectPath)}`;
     return message;
 }
 function noProjectName() {
-    return `${external_pintor_default().red('ERROR')} You need to provide an extension name to create one. See ${external_pintor_default().blue('--help')} for command info.`;
+    return `${external_pintor_default().red('Error')} Project name is required.\nNext step: provide a project name (for example, ${external_pintor_default().blue('my-extension')}) or run ${external_pintor_default().blue('--help')} for usage.`;
 }
 function noUrlAllowed() {
-    return `${external_pintor_default().red('ERROR')} URLs are not allowed as a project path. Either write a name or a path to a local folder.`;
+    return `${external_pintor_default().red('Error')} URLs are not allowed as a project path.\nNext step: provide a project name or a local directory path.`;
 }
-async function successfullInstall(projectPath, projectName) {
+async function successfullInstall(projectPath, projectName, depsInstalled) {
     const relativePath = external_path_namespaceObject.relative(process.cwd(), projectPath);
     const pm = await (0, external_package_manager_detector_namespaceObject.detect)();
     let command = 'npm run';
     let installCmd = 'npm install';
-    switch(null == pm ? void 0 : pm.name){
+    switch(pm?.name){
         case 'yarn':
             command = 'yarn dev';
             installCmd = 'yarn';
@@ -87,86 +87,88 @@ async function successfullInstall(projectPath, projectName) {
             installCmd = 'pnpm install';
         }
     }
-    return `\u{1F9E9} - ${external_pintor_default().green('Success!')} Extension ${external_pintor_default().blue(projectName)} created.\n\nTo get started developing your extension, do the following:\n\n   1. ${external_pintor_default().blue('cd')} ${external_pintor_default().underline(relativePath)}\n   2. ${external_pintor_default().blue(installCmd)} to install dependencies\n   3. ${external_pintor_default().blue(command)} to open a new browser instance with your extension loaded\n\n${external_pintor_default().green('You are ready')}. Time to hack on your extension!\n`;
+    const steps = depsInstalled ? `  1. ${external_pintor_default().blue('cd')} ${external_pintor_default().underline(relativePath)}\n  2. ${external_pintor_default().blue(command)} (runs a fresh browser profile with your extension loaded)\n` : `  1. ${external_pintor_default().blue('cd')} ${external_pintor_default().underline(relativePath)}\n  2. ${external_pintor_default().blue(installCmd)}\n  3. ${external_pintor_default().blue(command)} (runs a fresh browser profile with your extension loaded)\n`;
+    const depsNote = depsInstalled ? `\n${external_pintor_default().gray('Dependencies installed. You can start developing now.')}\n` : '\n';
+    return `${external_pintor_default().green('Created')} ${external_pintor_default().blue(projectName)}\n\nNext steps:\n\n` + steps + depsNote;
 }
 function startingNewExtension(projectName) {
-    return `\u{1F423} - Starting a new browser extension named ${external_pintor_default().blue(projectName)}...`;
+    return `Creating ${external_pintor_default().blue(projectName)}...`;
 }
 function checkingIfPathIsWriteable() {
-    return `\u{1F91E} - Checking if destination path is writeable...`;
+    return 'Checking if the destination path is writable...';
 }
 function scanningPossiblyConflictingFiles() {
-    return "\uD83D\uDD0E - Scanning for potential conflicting files...";
+    return 'Scanning for conflicting files...';
 }
 function createDirectoryError(projectName, error) {
-    return `${external_pintor_default().red('ERROR')} Can't create directory ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error))}`;
+    return `${external_pintor_default().red('Error')} Couldn't create directory ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error))}\n${external_pintor_default().red('Next step: check the path and permissions, then try again.')}`;
 }
 function writingTypeDefinitions(projectName) {
-    return `\u{1F537} - Writing type definitions for ${external_pintor_default().blue(projectName)}...`;
+    return `Writing type definitions for ${external_pintor_default().blue(projectName)}...`;
 }
 function writingTypeDefinitionsError(error) {
-    return `${external_pintor_default().red('ERROR')} Failed to write the extension type definition.\n${external_pintor_default().red(String(error))}`;
+    return `${external_pintor_default().red('Error')} Couldn't write the extension type definitions.\n${external_pintor_default().red(String(error))}\n${external_pintor_default().red('Next step: check file permissions, then try again.')}`;
 }
 function installingFromTemplate(projectName, templateName) {
-    if ('init' === templateName) return `\u{1F9F0} - Installing ${external_pintor_default().blue(projectName)}...`;
-    return `\u{1F9F0} - Installing ${external_pintor_default().blue(projectName)} from template ${external_pintor_default().yellow(templateName)}...`;
+    if ('init' === templateName) return `Installing ${external_pintor_default().blue(projectName)}...`;
+    return `Installing ${external_pintor_default().blue(projectName)} from template ${external_pintor_default().yellow(templateName)}...`;
 }
 function installingFromTemplateError(projectName, template, error) {
-    return `${external_pintor_default().red('ERROR')} Can't find template ${external_pintor_default().yellow(template)} for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error))}`;
+    return `${external_pintor_default().red('Error')} Couldn't find template ${external_pintor_default().yellow(template)} for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error))}\n${external_pintor_default().red('Next step: choose a valid template name or URL.')}`;
 }
 function initializingGitForRepository(projectName) {
-    return `\u{1F332} - Initializing git repository for ${external_pintor_default().blue(projectName)}...`;
+    return `Initializing git repository for ${external_pintor_default().blue(projectName)}...`;
 }
 function initializingGitForRepositoryFailed(gitCommand, gitArgs, code) {
-    return `${external_pintor_default().red('ERROR')} Command ${external_pintor_default().yellow(gitCommand)} ${external_pintor_default().yellow(gitArgs.join(' '))} failed.\n${external_pintor_default().red(`exit code ${external_pintor_default().yellow(String(code))}`)}`;
+    return `${external_pintor_default().red('Error')} Command ${external_pintor_default().yellow(gitCommand)} ${external_pintor_default().yellow(gitArgs.join(' '))} failed.\n${external_pintor_default().red(`Exit code: ${external_pintor_default().yellow(String(code))}`)}\n${external_pintor_default().red('Next step: run the command manually to inspect the error.')}`;
 }
 function initializingGitForRepositoryProcessError(projectName, error) {
-    return `${external_pintor_default().red('ERROR')} Child process error: Can't initialize ${external_pintor_default().yellow('git')} for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String((null == error ? void 0 : error.message) || error))}`;
+    return `${external_pintor_default().red('Error')} Child process failed while initializing ${external_pintor_default().yellow('git')} for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error?.message || error))}\n${external_pintor_default().red('Next step: retry initialization or create the repository manually.')}`;
 }
 function initializingGitForRepositoryError(projectName, error) {
-    return `${external_pintor_default().red('ERROR')} Can't initialize ${external_pintor_default().yellow('git')} for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String((null == error ? void 0 : error.message) || error))}`;
+    return `${external_pintor_default().red('Error')} Couldn't initialize ${external_pintor_default().yellow('git')} for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error?.message || error))}\n${external_pintor_default().red('Next step: retry initialization or create the repository manually.')}`;
 }
 function installingDependencies() {
-    return "\uD83D\uDEE0  - Installing dependencies... (takes a moment)";
+    return 'Installing dependencies (this may take a moment)...';
 }
 function installingDependenciesFailed(gitCommand, gitArgs, code) {
-    return `${external_pintor_default().red('ERROR')} Command ${external_pintor_default().yellow(gitCommand)} ${external_pintor_default().yellow(gitArgs.join(' '))} failed.\n${external_pintor_default().red(`exit code ${external_pintor_default().yellow(String(code))}`)}`;
+    return `${external_pintor_default().red('Error')} Command ${external_pintor_default().yellow(gitCommand)} ${external_pintor_default().yellow(gitArgs.join(' '))} failed.\n${external_pintor_default().red(`Exit code: ${external_pintor_default().yellow(String(code))}`)}\n${external_pintor_default().red('Next step: run the command manually to inspect the error.')}`;
 }
 function installingDependenciesProcessError(projectName, error) {
-    return `${external_pintor_default().red('ERROR')} Child process error: Can't install dependencies for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error))}`;
+    return `${external_pintor_default().red('Error')} Child process failed while installing dependencies for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error))}\n${external_pintor_default().red('Next step: run the install command manually to inspect the error.')}`;
 }
 function cantInstallDependencies(projectName, error) {
-    return `${external_pintor_default().red('ERROR')} Can't install dependencies for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String((null == error ? void 0 : error.message) || error))}`;
+    return `${external_pintor_default().red('Error')} Couldn't install dependencies for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error?.message || error))}\n${external_pintor_default().red('Next step: check your package manager settings, then try again.')}`;
 }
 function writingPackageJsonMetadata() {
-    return `\u{1F4DD} - Writing ${external_pintor_default().yellow('package.json')} metadata...`;
+    return `Writing ${external_pintor_default().yellow('package.json')}...`;
 }
 function writingPackageJsonMetadataError(projectName, error) {
-    return `${external_pintor_default().red('ERROR')} Can't write ${external_pintor_default().yellow('package.json')} for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error))}`;
+    return `${external_pintor_default().red('Error')} Couldn't write ${external_pintor_default().yellow('package.json')} for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error))}\n${external_pintor_default().red('Next step: check file permissions, then try again.')}`;
 }
 function writingManifestJsonMetadata() {
-    return `\u{1F4DC} - Writing ${external_pintor_default().yellow('manifest.json')} metadata...`;
+    return `Writing ${external_pintor_default().yellow('manifest.json')}...`;
 }
 function writingManifestJsonMetadataError(projectName, error) {
-    return `${external_pintor_default().red('ERROR')} Can't write ${external_pintor_default().yellow('manifest.json')} for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error))}`;
+    return `${external_pintor_default().red('Error')} Couldn't write ${external_pintor_default().yellow('manifest.json')} for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error))}\n${external_pintor_default().red('Next step: check file permissions, then try again.')}`;
 }
 function writingReadmeMetaData() {
-    return `\u{1F4C4} - Writing ${external_pintor_default().yellow('README.md')} metadata...`;
+    return `Writing ${external_pintor_default().yellow('README.md')}...`;
 }
 function writingGitIgnore() {
-    return `\u{1F648} - Writing ${external_pintor_default().yellow('.gitignore')} lines...`;
+    return `Writing ${external_pintor_default().yellow('.gitignore')}...`;
 }
 function writingReadmeMetaDataEError(projectName, error) {
-    return `${external_pintor_default().red('ERROR')} Can't write the ${external_pintor_default().yellow('README.md')} file for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error))}`;
+    return `${external_pintor_default().red('Error')} Couldn't write ${external_pintor_default().yellow('README.md')} for ${external_pintor_default().blue(projectName)}.\n${external_pintor_default().red(String(error))}\n${external_pintor_default().red('Next step: check file permissions, then try again.')}`;
 }
 function folderExists(projectName) {
-    return `\u{1F91D} - Ensuring ${external_pintor_default().blue(projectName)} folder exists...`;
+    return `Ensuring ${external_pintor_default().blue(projectName)} exists...`;
 }
 function writingDirectoryError(error) {
-    return `${external_pintor_default().red('ERROR')} Error while checking directory writability.\n${external_pintor_default().red(String(error))}`;
+    return `${external_pintor_default().red('Error')} Couldn't check directory writability.\n${external_pintor_default().red(String(error))}\n${external_pintor_default().red('Next step: check the path and permissions, then try again.')}`;
 }
 function cantSetupBuiltInTests(projectName, error) {
-    return `${external_pintor_default().red('ERROR')} Can't setup built-in tests for ${external_pintor_default().yellow(projectName)}.\n${external_pintor_default().red(String(error))}`;
+    return `${external_pintor_default().red('Error')} Couldn't set up built-in tests for ${external_pintor_default().yellow(projectName)}.\n${external_pintor_default().red(String(error))}\n${external_pintor_default().red('Next step: run the setup step again or skip tests.')}`;
 }
 const promises_namespaceObject = require("fs/promises");
 const external_url_namespaceObject = require("url");
@@ -225,7 +227,7 @@ async function getInstallCommand() {
     if (process.env.npm_config_user_agent) {
         if (process.env.npm_config_user_agent.includes('pnpm')) return 'pnpm';
     }
-    switch(null == pm ? void 0 : pm.name){
+    switch(pm?.name){
         case 'yarn':
             command = 'yarn';
             break;
@@ -296,7 +298,6 @@ var external_go_git_it_default = /*#__PURE__*/ __webpack_require__.n(external_go
 const import_external_template_filename = (0, external_url_namespaceObject.fileURLToPath)(__rslib_import_meta_url__);
 const import_external_template_dirname = external_path_namespaceObject.dirname(import_external_template_filename);
 async function importExternalTemplate(projectPath, projectName, template) {
-    external_path_namespaceObject.dirname(projectPath);
     const templateName = external_path_namespaceObject.basename(template);
     const examplesUrl = 'https://github.com/extension-js/examples/tree/main/examples';
     const templateUrl = `${examplesUrl}/${template}`;
@@ -306,7 +307,24 @@ async function importExternalTemplate(projectPath, projectName, template) {
         });
         if ('development' === process.env.EXTENSION_ENV) {
             console.log(installingFromTemplate(projectName, template));
-            const localTemplatePath = external_path_namespaceObject.join(import_external_template_dirname, '..', '..', '..', 'examples', templateName);
+            async function findTemplatesRoot(startDir) {
+                let current = startDir;
+                const maxDepth = 6;
+                for(let i = 0; i < maxDepth; i++){
+                    const candidate = external_path_namespaceObject.join(current, 'templates');
+                    try {
+                        const stats = await promises_namespaceObject.stat(candidate);
+                        if (stats.isDirectory()) return candidate;
+                    } catch  {}
+                    const parent = external_path_namespaceObject.dirname(current);
+                    if (parent === current) break;
+                    current = parent;
+                }
+            }
+            const localTemplatesRoot = await findTemplatesRoot(import_external_template_dirname);
+            if (!localTemplatesRoot) throw new Error('Local templates directory not found');
+            const localTemplateName = 'init' === templateName ? "javascript" : templateName;
+            const localTemplatePath = external_path_namespaceObject.join(localTemplatesRoot, localTemplateName);
             await copyDirectoryWithSymlinks(localTemplatePath, projectPath);
         } else {
             const tempRoot = await promises_namespaceObject.mkdtemp(external_path_namespaceObject.join(external_os_namespaceObject.tmpdir(), 'extension-js-create-'));
@@ -320,8 +338,7 @@ async function importExternalTemplate(projectPath, projectName, template) {
                 const originalStdoutWrite = process.stdout.write.bind(process.stdout);
                 const originalStderrWrite = process.stderr.write.bind(process.stderr);
                 const shouldFilter = (chunk)=>{
-                    var _chunk_toString;
-                    const s = 'string' == typeof chunk ? chunk : (null == chunk ? void 0 : null == (_chunk_toString = chunk.toString) ? void 0 : _chunk_toString.call(chunk)) ?? '';
+                    const s = 'string' == typeof chunk ? chunk : chunk?.toString?.() ?? '';
                     if (!s) return false;
                     return /Using git version/i.test(s) || /GitHub API rate limit reached, continuing without connectivity check/i.test(s);
                 };
@@ -353,7 +370,7 @@ async function importExternalTemplate(projectPath, projectName, template) {
                     responseType: 'arraybuffer',
                     maxRedirects: 5
                 });
-                const contentType = String((null == headers ? void 0 : headers['content-type']) || '');
+                const contentType = String(headers?.['content-type'] || '');
                 const looksZip = /zip|octet-stream/i.test(contentType) || template.toLowerCase().endsWith('.zip');
                 if (!looksZip) throw new Error(`Remote template does not appear to be a ZIP archive: ${template}`);
                 const zip = new (external_adm_zip_default())(Buffer.from(data));
@@ -377,7 +394,9 @@ async function importExternalTemplate(projectPath, projectName, template) {
 const extensionJsPackageJsonScripts = {
     dev: 'development' === process.env.EXTENSION_ENV ? 'node node_modules/extension dev' : 'extension dev',
     start: 'development' === process.env.EXTENSION_ENV ? 'node node_modules/extension start' : 'extension start',
-    build: 'development' === process.env.EXTENSION_ENV ? 'node node_modules/extension build' : 'extension build'
+    build: 'development' === process.env.EXTENSION_ENV ? 'node node_modules/extension build' : 'extension build',
+    'build:firefox': 'development' === process.env.EXTENSION_ENV ? 'node node_modules/extension build --browser firefox' : 'extension build --browser firefox',
+    'build:edge': 'development' === process.env.EXTENSION_ENV ? 'node node_modules/extension build --browser edge' : 'extension build --browser edge'
 };
 async function overridePackageJson(projectPath, projectName, { template, cliVersion }) {
     const templatePath = getTemplatePath(process.cwd());
@@ -461,21 +480,62 @@ async function installDependencies(projectPath, projectName) {
         throw error;
     }
 }
+const manifestSearchMaxDepth = 3;
+const ignoredManifestDirs = new Set([
+    'node_modules',
+    '.git'
+]);
+async function findManifestJsonPath(projectPath) {
+    const candidates = [
+        external_path_namespaceObject.join(projectPath, 'manifest.json'),
+        external_path_namespaceObject.join(projectPath, 'src', 'manifest.json'),
+        external_path_namespaceObject.join(projectPath, 'extension', 'manifest.json'),
+        external_path_namespaceObject.join(projectPath, 'extension', 'src', 'manifest.json')
+    ];
+    for (const candidate of candidates)try {
+        await external_fs_namespaceObject.promises.access(candidate);
+        return candidate;
+    } catch  {}
+    const queue = [
+        {
+            dir: projectPath,
+            depth: 0
+        }
+    ];
+    while(queue.length > 0){
+        const current = queue.shift();
+        if (!current) continue;
+        let entries;
+        try {
+            entries = await external_fs_namespaceObject.promises.readdir(current.dir, {
+                withFileTypes: true
+            });
+        } catch  {
+            continue;
+        }
+        for (const entry of entries){
+            if (entry.isFile() && 'manifest.json' === entry.name) return external_path_namespaceObject.join(current.dir, entry.name);
+            if (entry.isDirectory() && current.depth < manifestSearchMaxDepth && !ignoredManifestDirs.has(entry.name)) queue.push({
+                dir: external_path_namespaceObject.join(current.dir, entry.name),
+                depth: current.depth + 1
+            });
+        }
+    }
+    throw new Error(`Could not locate manifest.json under ${projectPath}. Checked common paths and searched up to depth ${manifestSearchMaxDepth}.`);
+}
 async function writeReadmeFile(projectPath, projectName) {
     try {
         await promises_namespaceObject.access(external_path_namespaceObject.join(projectPath, 'README.md'));
         return;
     } catch  {}
     const initTemplateReadme = `
-<a href="https://extension.js.org" target="_blank"><img src="https://img.shields.io/badge/Powered%20by%20%7C%20Extension.js-0971fe" alt="Powered by Extension.js" align="right" /></a>
+<a href="https://extension.js.org" target="_blank" rel="noopener noreferrer"><img src="https://img.shields.io/badge/Powered%20by%20%7C%20Extension.js-0971fe" alt="Powered by Extension.js" align="right" /></a>
 
 # [projectName]
 
 > [templateDescription]
 
-What this example does in the scope of a browser extension. The description should 
-describe for an audience of developers looking to use the example. Avoid jargon and 
-use simple language.
+This project was created with Extension.js. Use the commands below to run and build it.
 
 ## Installation
 
@@ -489,18 +549,26 @@ npm install
 
 ### dev
 
-Run the extension in development mode.
+Run the extension in development mode. You can target a specific browser using the
+\`--browser <browser>\` flag. Supported values: \`chrome\`, \`firefox\`, \`edge\`.
 
 \`\`\`bash
-[runCommand] dev
+[runCommand] dev --browser chrome
+# or
+[runCommand] dev --browser firefox
+# or
+[runCommand] dev --browser edge
 \`\`\`
 
 ### build
 
-Build the extension for production.
+Build the extension for production. Use \`--browser <browser>\` to select a target.
 
 \`\`\`bash
-[runCommand] build
+[runCommand] build (defaults to Chrome)
+# or use convenience scripts
+[runCommand] build:firefox (Firefox)
+[runCommand] build:edge (Edge)
 \`\`\`
 
 ### Preview
@@ -513,10 +581,10 @@ Preview the extension in the browser.
 
 ## Learn more
 
-Learn more about this and other examples at @https://extension.js.org/
+Learn more in the [Extension.js docs](https://extension.js.org).
   `;
     const installCommand = await getInstallCommand();
-    const manifestJsonPath = external_path_namespaceObject.join(projectPath, 'manifest.json');
+    const manifestJsonPath = await findManifestJsonPath(projectPath);
     const manifestJson = JSON.parse(await promises_namespaceObject.readFile(manifestJsonPath, 'utf-8'));
     const readmeFileEdited = initTemplateReadme.replaceAll('[projectName]', projectName).replaceAll("[templateDescription]", manifestJson.description).replaceAll('[runCommand]', installCommand);
     try {
@@ -531,7 +599,7 @@ Learn more about this and other examples at @https://extension.js.org/
     }
 }
 async function writeManifestJson(projectPath, projectName) {
-    const manifestJsonPath = external_path_namespaceObject.join(projectPath, 'manifest.json');
+    const manifestJsonPath = await findManifestJsonPath(projectPath);
     const manifestJsonContent = await promises_namespaceObject.readFile(manifestJsonPath);
     const manifestJson = JSON.parse(manifestJsonContent.toString());
     const manifestMetadata = {
@@ -541,7 +609,7 @@ async function writeManifestJson(projectPath, projectName) {
     };
     try {
         console.log(writingManifestJsonMetadata());
-        await promises_namespaceObject.writeFile(external_path_namespaceObject.join(projectPath, 'manifest.json'), JSON.stringify(manifestMetadata, null, 2));
+        await promises_namespaceObject.writeFile(manifestJsonPath, JSON.stringify(manifestMetadata, null, 2));
     } catch (error) {
         console.error(writingManifestJsonMetadataError(projectName, error));
         throw error;
@@ -693,7 +761,7 @@ async function extensionCreate(projectNameInput, { cliVersion, template = 'init'
         await writeGitignore(projectPath);
         await setupBuiltInTests(projectPath, projectName);
         if (isTypeScriptTemplate(template)) await generateExtensionTypes(projectPath, projectName);
-        const successfulInstall = await successfullInstall(projectPath, projectName);
+        const successfulInstall = await successfullInstall(projectPath, projectName, Boolean(install));
         console.log(successfulInstall);
     } catch (error) {
         console.error(error);
@@ -701,9 +769,9 @@ async function extensionCreate(projectNameInput, { cliVersion, template = 'init'
     }
 }
 exports.extensionCreate = __webpack_exports__.extensionCreate;
-for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+for(var __rspack_i in __webpack_exports__)if (-1 === [
     "extensionCreate"
-].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true
 });

package/package.json

@@ -1,14 +1,16 @@
 {
   "license": "MIT",
+  "packageManager": "pnpm@10.28.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/extension-js/create.git"
+    "url": "https://github.com/extension-js/extension.js.git"
   },
   "engines": {
     "node": ">=18"
   },
   "exports": {
     ".": {
+      "development": "./module.ts",
       "types": "./dist/module.d.ts",
       "import": "./dist/module.js",
       "require": "./dist/module.js"
@@ -20,7 +22,7 @@
     "dist"
   ],
   "name": "extension-create",
-  "version": "2.2.1",
+  "version": "3.1.0-next.11",
   "description": "The standalone extension creation engine for Extension.js",
   "author": {
     "name": "Cezar Augusto",
@@ -32,6 +34,16 @@
     "registry": "https://registry.npmjs.org",
     "tag": "latest"
   },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "watch": "rslib build --watch",
+    "compile": "rslib build",
+    "format": "prettier --write \"**/*.{ts,tsx,md,js,json}\"",
+    "lint": "eslint .",
+    "pretest:create": "pnpm compile",
+    "test:create": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  },
   "keywords": [
     "webextension",
     "browser-extension",
@@ -55,40 +67,30 @@
     "edge-extension"
   ],
   "dependencies": {
-    "adm-zip": "^0.5.12",
-    "axios": "^1.12.0",
+    "adm-zip": "^0.5.16",
+    "axios": "^1.13.2",
     "cross-spawn": "^7.0.6",
-    "go-git-it": "^5.0.0",
-    "package-manager-detector": "^0.2.7",
+    "go-git-it": "^5.0.3",
+    "package-manager-detector": "^1.6.0",
     "pintor": "0.3.0",
     "tiny-glob": "^0.2.9"
   },
   "devDependencies": {
-    "@changesets/cli": "^2.29.6",
-    "@eslint/js": "^9.16.0",
-    "@rslib/core": "^0.6.9",
-    "@types/adm-zip": "^0.5.6",
-    "@types/chrome": "^0.0.287",
+    "@changesets/cli": "^2.29.8",
+    "@eslint/js": "^9.39.2",
+    "@rslib/core": "^0.19.2",
+    "@types/adm-zip": "^0.5.7",
+    "@types/chrome": "^0.1.33",
     "@types/cross-spawn": "^6.0.6",
-    "@types/node": "^22.10.1",
-    "@types/webextension-polyfill": "0.12.3",
-    "@vitest/coverage-v8": "^3.2.4",
-    "eslint": "^9.16.0",
-    "globals": "^15.13.0",
-    "prettier": "^3.4.2",
+    "@types/node": "^25.0.9",
+    "@types/webextension-polyfill": "0.12.4",
+    "@vitest/coverage-v8": "^4.0.17",
+    "eslint": "^9.39.2",
+    "globals": "^17.0.0",
+    "prettier": "^3.8.0",
     "tsconfig": "*",
-    "typescript": "5.7.2",
-    "vitest": "^3.2.4",
+    "typescript": "5.9.3",
+    "vitest": "^4.0.17",
     "webextension-polyfill": "^0.12.0"
-  },
-  "scripts": {
-    "clean": "rm -rf dist",
-    "watch": "rslib build --watch",
-    "compile": "rslib build",
-    "format": "prettier --write \"**/*.{ts,tsx,md,js,json}\"",
-    "lint": "eslint .",
-    "pretest:create": "pnpm compile",
-    "test:create": "vitest run",
-    "test:coverage": "vitest run --coverage"
   }
-}
+}

package/dist/test-template-init/README.md

@@ -1,47 +0,0 @@
-<a href="https://extension.js.org" target="_blank"><img src="https://img.shields.io/badge/Powered%20by%20%7C%20Extension.js-0971fe" alt="Powered by Extension.js" align="right" /></a>
-
-# init
-
-> A basic browser extension example built with Extension.js. Perfect starting point for developers learning browser extension development with modern tooling.
-
-What this example does in the scope of a browser extension. The description should
-describe for an audience of developers looking to use the example. Avoid jargon and
-use simple language.
-
-## Installation
-
-```bash
-npx extension@latest create <project-name> --template init
-cd <project-name>
-npm install
-```
-
-## Commands
-
-### dev
-
-Run the extension in development mode.
-
-```bash
-npx extension@latest dev
-```
-
-### build
-
-Build the extension for production.
-
-```bash
-npx extension@latest build
-```
-
-### Preview
-
-Preview the extension in the browser.
-
-```bash
-npx extension@latest preview
-```
-
-## Learn more
-
-Learn more about this and other examples at @https://extension.js.org/

package/dist/test-template-init/index.js

@@ -1 +0,0 @@
-console.log('test')

package/dist/test-template-init/manifest.json

@@ -1,11 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/chrome-manifest.json",
-  "manifest_version": 3,
-  "version": "0.0.1",
-  "name": "test-template-init",
-  "description": "A basic browser extension example built with Extension.js. Perfect starting point for developers learning browser extension development with modern tooling.",
-  "icons": {
-    "48": "images/extension_48.png"
-  },
-  "author": "Your Name"
-}

package/dist/test-template-init/package.json

@@ -1,22 +0,0 @@
-{
-  "private": true,
-  "name": "test-template-init",
-  "description": "A basic browser extension example built with Extension.js. Perfect starting point for developers learning browser extension development with modern tooling.",
-  "version": "0.0.1",
-  "license": "MIT",
-  "type": "module",
-  "author": {
-    "name": "Your Name",
-    "email": "your@email.com",
-    "url": "https://yourwebsite.com"
-  },
-  "scripts": {
-    "dev": "extension dev",
-    "start": "extension start",
-    "build": "extension build"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "extension": "^undefined"
-  }
-}