@flarum/cli 2.0.0-beta.8 → 3.0.0

package/lib/steps/gen-ext-scaffolder.js

@@ -3,12 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.genExtScaffolder = exports.EXTENSION_MODULES = exports.EXTENSION_PARAMS = void 0;
 const tslib_1 = require("tslib");
 const scaffolder_1 = require("boilersmith/scaffolding/scaffolder");
-const chalk_1 = (0, tslib_1.__importDefault)(require("chalk"));
+const chalk_1 = tslib_1.__importDefault(require("chalk"));
 const mem_fs_editor_1 = require("mem-fs-editor");
-const node_path_1 = require("node:path");
-const simple_git_1 = (0, tslib_1.__importDefault)(require("simple-git"));
-const simple_1 = (0, tslib_1.__importDefault)(require("spdx-license-list/simple"));
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const simple_git_1 = tslib_1.__importDefault(require("simple-git"));
+const simple_1 = tslib_1.__importDefault(require("spdx-license-list/simple"));
 const composer_1 = require("../utils/composer");
+const string_1 = tslib_1.__importDefault(require("string"));
 function assertUnreachable(_x) {
     throw new Error("Didn't expect to get here");
 }
@@ -21,8 +24,8 @@ exports.EXTENSION_PARAMS = [
     'extensionName',
     'licenseType',
     'mainGitBranch',
+    'jsPackageManager',
     'licenseText',
-    'packageNamespaceEscapedSlash',
     'extensionId',
     'year',
     'backendDirectory',
@@ -36,8 +39,8 @@ function paramNamesToDef(name) {
                     name,
                     type: 'text',
                     message: `Package ${chalk_1.default.dim('(vendor/extension-name)')}`,
-                    validate: s => /^([\dA-Za-z-]{2,})\/([\dA-Za-z-]{2,})$/.test(s.trim()) || 'Invalid package name format',
-                    format: s => s.toLowerCase(),
+                    validate: (s) => /^([\dA-Za-z-]{2,})\/([\dA-Za-z-]{2,})$/.test(s.trim()) || 'Invalid package name format',
+                    format: (s) => s.toLowerCase(),
                 },
                 getCurrVal: async (fs, paths) => {
                     const json = (0, composer_1.getComposerJson)(fs, paths);
@@ -63,18 +66,24 @@ function paramNamesToDef(name) {
                     name,
                     type: 'text',
                     message: `Package namespace ${chalk_1.default.dim('(Vendor\\ExtensionName)')}`,
-                    validate: s => /^([\dA-Za-z]+)\\([\dA-Za-z]+)$/.test(s.trim()) || 'Invalid namespace format',
+                    initial: (_prev, values) => values
+                        .get('packageName')
+                        .replace('/flarum-', '/')
+                        .split('/')
+                        .map((b) => (0, string_1.default)(b).camelize().capitalize().toString())
+                        .join('\\'),
+                    validate: (s) => /^([\dA-Za-z]+)\\([\dA-Za-z]+)$/.test(s.trim()) || 'Invalid namespace format',
                     format: (str) => str &&
                         str
                             .split('\\')
-                            .map(s => s[0].toUpperCase() + s.slice(1))
+                            .map((s) => s[0].toUpperCase() + s.slice(1))
                             .join('\\'),
                 },
                 getCurrVal: async (fs, paths) => {
                     var _a, _b, _c, _d, _e;
                     const json = (0, composer_1.getComposerJson)(fs, paths);
                     const namespace = (_e = ((_d = (_c = Object.keys((_b = (_a = json === null || json === void 0 ? void 0 : json.autoload) === null || _a === void 0 ? void 0 : _a['psr-4']) !== null && _b !== void 0 ? _b : {})) === null || _c === void 0 ? void 0 : _c[0]) !== null && _d !== void 0 ? _d : '')) === null || _e === void 0 ? void 0 : _e.slice(0, -1);
-                    return namespace || '';
+                    return (namespace || '').replace('\\\\', '\\');
                 },
             };
         case 'authorName':
@@ -96,7 +105,7 @@ function paramNamesToDef(name) {
                     name,
                     type: 'text',
                     message: 'Author email',
-                    validate: s => !s || /^[\w!#$%&*+./=?^`{|}~’-]+@[\dA-Za-z-]+(?:\.[\dA-Za-z-]+)*$/.test(s) || 'Invalid email format',
+                    validate: (s) => !s || /^[\w!#$%&*+./=?^`{|}~’-]+@[\dA-Za-z-]+(?:\.[\dA-Za-z-]+)*$/.test(s) || 'Invalid email format',
                 },
                 getCurrVal: async (fs, paths) => {
                     var _a, _b, _c;
@@ -110,8 +119,13 @@ function paramNamesToDef(name) {
                     name,
                     type: 'text',
                     message: 'Extension name',
-                    validate: str => Boolean(str.trim()) || 'The extension name is required',
-                    format: str => str
+                    validate: (str) => Boolean(str.trim()) || 'The extension name is required',
+                    initial: (_prev, values) => (0, string_1.default)(values.get('packageName').split('/')[1])
+                        .replaceAll('flarum-', '')
+                        .humanize()
+                        .capitalize()
+                        .toString(),
+                    format: (str) => str
                         .split(' ')
                         .map((s) => (s.length > 3 ? s[0].toUpperCase() + s.slice(1) : s))
                         .join(' '),
@@ -130,7 +144,8 @@ function paramNamesToDef(name) {
                     name,
                     type: 'autocomplete',
                     message: 'License',
-                    choices: [...simple_1.default].map(e => ({ title: e, value: e })),
+                    choices: [...simple_1.default, 'proprietary'].map((e) => ({ title: e, value: e })),
+                    initial: 'MIT',
                 },
                 getCurrVal: async (fs, paths) => {
                     var _a;
@@ -142,13 +157,7 @@ function paramNamesToDef(name) {
             return {
                 name,
                 uses: ['licenseType'],
-                compute: async (_paths, licenseType) => (licenseType ? require(`spdx-license-list/licenses/${licenseType}`).licenseText : ''),
-            };
-        case 'packageNamespaceEscapedSlash':
-            return {
-                name,
-                uses: ['packageNamespace'],
-                compute: async (_paths, packageNamespace) => packageNamespace.replace('\\', '\\\\'),
+                compute: async (_paths, licenseType) => licenseType && licenseType !== 'proprietary' ? require(`spdx-license-list/licenses/${licenseType}`).licenseText : '',
             };
         case 'extensionId':
             return {
@@ -169,12 +178,37 @@ function paramNamesToDef(name) {
                     type: 'text',
                     message: `Main git branch ${chalk_1.default.dim('(JS will automatically build when changes are pushed to GitHub on this branch)')}`,
                     // See https://stackoverflow.com/a/12093994/11091039
-                    validate: s => /^(?!.*\/\.)(?!.*\.\.)(?!\/)(?!.*\/\/)(?!.*@{)(?!.*\\)[^\000-\037 *:?[^~\177]+(?<!\.lock)(?<!\/)(?<!\.)$/.test(s.trim()) || 'Invalid git branch',
+                    validate: (s) => /^(?!.*\/\.)(?!.*\.\.)(?!\/)(?!.*\/\/)(?!.*@{)(?!.*\\)[^\000-\037 *:?[^~\177]+(?<!\.lock)(?<!\/)(?<!\.)$/.test(s.trim()) ||
+                        'Invalid git branch',
                     initial: 'main',
                 },
-                getCurrVal: async () => {
-                    var _a;
-                    return (_a = (await (0, simple_git_1.default)().getConfig('init.defaultBranch')).value) !== null && _a !== void 0 ? _a : 'main';
+                getCurrVal: async (_fs, paths) => {
+                    var _a, _b;
+                    const cwd = (_a = paths.monorepo()) !== null && _a !== void 0 ? _a : paths.package();
+                    try {
+                        const remotes = (0, child_process_1.execSync)('git remote', { cwd, timeout: 2000 }).toString().split('\n');
+                        if (remotes.includes('origin')) {
+                            return (0, child_process_1.execSync)("git remote show origin | grep 'HEAD branch' | cut -d' ' -f5", { cwd, timeout: 2000 }).toString();
+                        }
+                    }
+                    catch (_c) { }
+                    return (_b = (await (0, simple_git_1.default)(cwd, { timeout: { block: 2000 } }).getConfig('init.defaultBranch')).value) !== null && _b !== void 0 ? _b : 'main';
+                },
+            };
+        case 'jsPackageManager':
+            return {
+                prompt: {
+                    name,
+                    type: 'select',
+                    message: 'JS Package Manager',
+                    initial: 0,
+                    choices: [
+                        { title: 'Yarn', value: 'yarn' },
+                        { title: 'NPM', value: 'npm' },
+                    ],
+                },
+                getCurrVal: async (fs, paths) => {
+                    return (0, mem_fs_editor_1.create)(fs).exists(paths.package('js/yarn.lock')) ? 'yarn' : 'npm';
                 },
             };
         case 'backendDirectory':
@@ -201,6 +235,8 @@ function paramNamesToDef(name) {
 exports.EXTENSION_MODULES = [
     'core',
     'icon',
+    'admin',
+    'forum',
     'js',
     'jsCommon',
     'css',
@@ -210,7 +246,9 @@ exports.EXTENSION_MODULES = [
     'prettier',
     'typescript',
     'bundlewatch',
+    'frontendTesting',
     'backendTesting',
+    'phpstan',
     'editorConfig',
     'styleci',
 ];
@@ -222,14 +260,7 @@ function moduleNameToDef(name) {
                 updatable: false,
                 togglable: false,
                 shortDescription: 'Core Functionality',
-                filesToReplace: [
-                    'extend.php',
-                    'README.md',
-                    'LICENSE.md',
-                    { path: 'js/src/admin/index.js', needsOtherModules: ['js'] },
-                    { path: 'js/src/forum/index.js', needsOtherModules: ['js'] },
-                    { path: 'js/src/common/index.js', needsOtherModules: ['js', 'jsCommon'] },
-                ],
+                filesToReplace: ['extend.php', 'README.md', 'LICENSE.md'],
                 jsonToAugment: {
                     'composer.json': [
                         'name',
@@ -239,15 +270,17 @@ function moduleNameToDef(name) {
                         'license',
                         'require.flarum/core',
                         'authors',
-                        'autoload.psr-4.${params.packageNamespaceEscapedSlash}\\',
+                        'autoload.psr-4.${params.packageNamespace}\\',
                         'extra.flarum-extension.title',
                         'extra.flarum-extension.category',
+                        'minimum-stability',
+                        'prefer-stable',
                     ],
                 },
                 needsTemplateParams: [
                     'packageName',
                     'packageNamespace',
-                    'packageNamespaceEscapedSlash',
+                    'packageNamespace',
                     'packageDescription',
                     'extensionName',
                     'licenseType',
@@ -270,6 +303,50 @@ function moduleNameToDef(name) {
                 },
                 needsTemplateParams: [],
             };
+        case 'admin':
+            return {
+                name,
+                updatable: true,
+                defaultEnabled: true,
+                dependsOn: [],
+                togglable: true,
+                shortDescription: 'Admin Frontend',
+                filesToReplace: [
+                    { path: 'js/admin.js', moduleDeps: ['js', { module: 'typescript', enabled: false }] },
+                    { path: 'js/admin.ts', moduleDeps: ['js', { module: 'typescript', enabled: true }] },
+                    { path: 'js/src/admin/index.js', doNotUpdate: true, moduleDeps: ['js', { module: 'typescript', enabled: false }] },
+                    { path: 'js/src/admin/index.ts', doNotUpdate: true, moduleDeps: ['js', { module: 'typescript', enabled: true }] },
+                ],
+                jsonToAugment: {},
+                needsTemplateParams: [],
+                inferEnabled: async (_fs, paths) => {
+                    if (!(0, fs_1.existsSync)(paths.package('js')))
+                        undefined;
+                    return (0, fs_1.existsSync)(paths.package('js/src/admin'));
+                },
+            };
+        case 'forum':
+            return {
+                name,
+                updatable: true,
+                defaultEnabled: true,
+                dependsOn: [],
+                togglable: true,
+                shortDescription: 'Forum Frontend',
+                filesToReplace: [
+                    { path: 'js/forum.js', moduleDeps: ['js', { module: 'typescript', enabled: false }] },
+                    { path: 'js/forum.ts', moduleDeps: ['js', { module: 'typescript', enabled: true }] },
+                    { path: 'js/src/forum/index.js', doNotUpdate: true, moduleDeps: ['js', { module: 'typescript', enabled: false }] },
+                    { path: 'js/src/forum/index.ts', doNotUpdate: true, moduleDeps: ['js', { module: 'typescript', enabled: true }] },
+                ],
+                jsonToAugment: {},
+                needsTemplateParams: [],
+                inferEnabled: async (_fs, paths) => {
+                    if (!(0, fs_1.existsSync)(paths.package('js')))
+                        undefined;
+                    return (0, fs_1.existsSync)(paths.package('js/src/forum'));
+                },
+            };
         case 'js':
             return {
                 name,
@@ -279,11 +356,30 @@ function moduleNameToDef(name) {
                 shortDescription: 'Javascript',
                 longDescription: "Files, tools, and scripts to build Flarum's frontend.",
                 dependsOn: [],
-                filesToReplace: ['js/webpack.config.js', 'js/admin.js', 'js/forum.js'],
+                filesToReplace: [
+                    'js/webpack.config.cjs',
+                    { path: 'js/admin.js', moduleDeps: ['admin', { module: 'typescript', enabled: false }] },
+                    { path: 'js/forum.js', moduleDeps: ['forum', { module: 'typescript', enabled: false }] },
+                    { path: 'js/admin.ts', moduleDeps: ['admin', { module: 'typescript', enabled: true }] },
+                    { path: 'js/forum.ts', moduleDeps: ['forum', { module: 'typescript', enabled: true }] },
+                    { path: 'js/src/admin/index.js', doNotUpdate: true, moduleDeps: ['admin', { module: 'typescript', enabled: false }] },
+                    { path: 'js/src/forum/index.js', doNotUpdate: true, moduleDeps: ['forum', { module: 'typescript', enabled: false }] },
+                    { path: 'js/src/common/index.js', doNotUpdate: true, moduleDeps: ['jsCommon', { module: 'typescript', enabled: false }] },
+                    { path: 'js/src/admin/index.ts', doNotUpdate: true, moduleDeps: ['admin', { module: 'typescript', enabled: true }] },
+                    { path: 'js/src/forum/index.ts', doNotUpdate: true, moduleDeps: ['forum', { module: 'typescript', enabled: true }] },
+                    { path: 'js/src/common/index.ts', doNotUpdate: true, moduleDeps: ['jsCommon', { module: 'typescript', enabled: true }] },
+                    { path: 'js/src/admin/extend.js', doNotUpdate: true, moduleDeps: ['admin', { module: 'typescript', enabled: false }] },
+                    { path: 'js/src/forum/extend.js', doNotUpdate: true, moduleDeps: ['forum', { module: 'typescript', enabled: false }] },
+                    { path: 'js/src/common/extend.js', doNotUpdate: true, moduleDeps: ['jsCommon', { module: 'typescript', enabled: false }] },
+                    { path: 'js/src/admin/extend.ts', doNotUpdate: true, moduleDeps: ['admin', { module: 'typescript', enabled: true }] },
+                    { path: 'js/src/forum/extend.ts', doNotUpdate: true, moduleDeps: ['forum', { module: 'typescript', enabled: true }] },
+                    { path: 'js/src/common/extend.ts', doNotUpdate: true, moduleDeps: ['jsCommon', { module: 'typescript', enabled: true }] },
+                ],
                 jsonToAugment: {
                     'js/package.json': [
                         'name',
                         'private',
+                        'version',
                         'devDependencies.flarum-webpack-config',
                         'devDependencies.webpack',
                         'devDependencies.webpack-cli',
@@ -292,33 +388,52 @@ function moduleNameToDef(name) {
                         'scripts.analyze',
                     ],
                 },
-                needsTemplateParams: ['packageName'],
+                needsTemplateParams: ['packageName', 'jsPackageManager'],
+                inferEnabled: async (_fs, paths) => {
+                    return (0, fs_1.existsSync)(paths.package('js'));
+                },
             };
         case 'jsCommon':
             return {
                 name,
-                updatable: false,
+                updatable: true,
                 togglable: true,
-                defaultEnabled: false,
+                defaultEnabled: true,
                 shortDescription: 'JS common code',
                 longDescription: 'Shared code between the forum and the admin frontends',
                 dependsOn: ['js'],
-                filesToReplace: [],
+                filesToReplace: [
+                    { path: 'js/admin.js', moduleDeps: ['admin', { module: 'typescript', enabled: false }] },
+                    { path: 'js/forum.js', moduleDeps: ['forum', { module: 'typescript', enabled: false }] },
+                    { path: 'js/admin.ts', moduleDeps: ['admin', { module: 'typescript', enabled: true }] },
+                    { path: 'js/forum.ts', moduleDeps: ['forum', { module: 'typescript', enabled: true }] },
+                    { path: 'js/src/common/index.js', doNotUpdate: true, moduleDeps: [{ module: 'typescript', enabled: false }] },
+                    { path: 'js/src/common/index.ts', doNotUpdate: true, moduleDeps: [{ module: 'typescript', enabled: true }] },
+                ],
                 jsonToAugment: {},
                 needsTemplateParams: [],
+                inferEnabled: async (_fs, paths) => {
+                    return (0, fs_1.existsSync)(paths.package('js/src/common'));
+                },
             };
         case 'css':
             return {
                 name,
-                updatable: false,
+                updatable: true,
                 togglable: true,
                 defaultEnabled: true,
                 shortDescription: 'CSS',
                 longDescription: "LESS starter files for Flarum's frontend styling.",
                 dependsOn: [],
-                filesToReplace: ['less/admin.less', 'less/forum.less'],
+                filesToReplace: [
+                    { path: 'less/admin.less', doNotUpdate: true, moduleDeps: ['admin'] },
+                    { path: 'less/forum.less', doNotUpdate: true, moduleDeps: ['forum'] },
+                ],
                 jsonToAugment: {},
                 needsTemplateParams: [],
+                inferEnabled: async (_fs, paths) => {
+                    return (0, fs_1.existsSync)(paths.package('less'));
+                },
             };
         case 'locale':
             return {
@@ -329,9 +444,12 @@ function moduleNameToDef(name) {
                 shortDescription: 'Locale',
                 longDescription: 'Translation starter files.',
                 dependsOn: [],
-                filesToReplace: ['locale/en.yml'],
+                filesToReplace: [{ path: 'locale/en.yml', doNotUpdate: true }],
                 jsonToAugment: {},
                 needsTemplateParams: [],
+                inferEnabled: async (_fs, paths) => {
+                    return (0, fs_1.existsSync)(paths.package('locale'));
+                },
             };
         case 'gitConf':
             return {
@@ -342,7 +460,11 @@ function moduleNameToDef(name) {
                 shortDescription: 'Git Configuration',
                 longDescription: 'Git config files (e.g. .gitignore, .gitattributes).',
                 dependsOn: [],
-                filesToReplace: [{ path: 'gitignore', destPath: '.gitignore' }, { path: 'js/gitignore', needsOtherModules: ['js'], destPath: 'js/.gitignore' }, '.gitattributes'],
+                filesToReplace: [
+                    { path: 'gitignore', destPath: '.gitignore' },
+                    { path: 'js/gitignore', moduleDeps: ['js'], destPath: 'js/.gitignore' },
+                    { path: '.gitattributes', monorepoPath: '.gitattributes' },
+                ],
                 jsonToAugment: {},
                 needsTemplateParams: [],
             };
@@ -356,8 +478,23 @@ function moduleNameToDef(name) {
                 longDescription: 'Automatically run checks via GitHub Actions CI. Free for open source projects.',
                 dependsOn: [],
                 filesToReplace: [
-                    { path: '.github/workflows/frontend.yml', monorepoPath: '.github/workflows/${params.extensionId}-frontend.yml' },
-                    { path: '.github/workflows/backend.yml', monorepoPath: '.github/workflows/${params.extensionId}-backend.yml' },
+                    {
+                        path: '.github/workflows/frontend.yml',
+                        monorepoPath: '.github/workflows/${params.extensionId}-frontend.yml',
+                        requireMonorepo: false,
+                        moduleDeps: ['js'],
+                    },
+                    {
+                        path: '.github/workflows/backend.yml',
+                        monorepoPath: '.github/workflows/${params.extensionId}-backend.yml',
+                        requireMonorepo: false,
+                    },
+                    {
+                        path: '.github/workflows/phpstan.yml',
+                        monorepoPath: '.github/workflows/${params.extensionId}-phpstan.yml',
+                        requireMonorepo: false,
+                        moduleDeps: ['phpstan'],
+                    },
                 ],
                 jsonToAugment: {},
                 needsTemplateParams: ['frontendDirectory', 'backendDirectory', 'mainGitBranch', 'extensionId', 'extensionName'],
@@ -372,9 +509,21 @@ function moduleNameToDef(name) {
                 dependsOn: ['js'],
                 filesToReplace: [],
                 jsonToAugment: {
-                    'js/package.json': ['prettier', 'devDependencies.prettier', 'devDependencies.@flarum/prettier-config', 'scripts.format', 'scripts.format-check'],
+                    'js/package.json': [
+                        'prettier',
+                        'devDependencies.prettier',
+                        'devDependencies.@flarum/prettier-config',
+                        'scripts.format',
+                        'scripts.format-check',
+                    ],
                 },
                 needsTemplateParams: [],
+                inferEnabled: async (_fs, paths) => {
+                    if (!(0, fs_1.existsSync)(paths.package('js/package.json'))) {
+                        return false;
+                    }
+                    return (0, fs_1.readFileSync)(paths.package('js/package.json')).includes('prettier');
+                },
             };
         case 'typescript':
             return {
@@ -387,15 +536,20 @@ function moduleNameToDef(name) {
                 filesToReplace: ['js/tsconfig.json'],
                 jsonToAugment: {
                     'js/package.json': [
-                        'prettier',
                         'devDependencies.flarum-tsconfig',
                         'devDependencies.typescript',
                         'devDependencies.typescript-coverage-report',
+                        'scripts.clean-typings',
+                        'scripts.build-typings',
+                        'scripts.post-build-typings',
                         'scripts.check-typings',
                         'scripts.check-typings-coverage',
                     ],
                 },
                 needsTemplateParams: [],
+                inferEnabled: async (_fs, paths) => {
+                    return (0, fs_1.existsSync)(paths.package('js/tsconfig.json'));
+                },
             };
         case 'bundlewatch':
             return {
@@ -408,6 +562,32 @@ function moduleNameToDef(name) {
                 filesToReplace: ['js/.bundlewatch.config.json'],
                 jsonToAugment: {},
                 needsTemplateParams: [],
+                inferEnabled: async (_fs, paths) => {
+                    return (0, fs_1.existsSync)(paths.package('js/.bundlewatch.config.json'));
+                },
+            };
+        case 'frontendTesting':
+            return {
+                name,
+                updatable: true,
+                togglable: true,
+                defaultEnabled: true,
+                shortDescription: 'Frontend testing via Jest and Mithril Query.',
+                dependsOn: ['js'],
+                filesToReplace: [
+                    'js/jest.config.cjs',
+                    'js/tsconfig.test.json',
+                    'js/webpack.config.cjs',
+                    'js/tests/unit/.gitkeep',
+                    'js/tests/integration/.gitkeep',
+                ],
+                jsonToAugment: {
+                    'js/package.json': ['devDependencies.@flarum/jest-config', 'scripts.test', 'type'],
+                },
+                needsTemplateParams: [],
+                inferEnabled: async (_fs, paths) => {
+                    return (0, fs_1.existsSync)(paths.package('js/jest.config.cjs'));
+                },
             };
         case 'backendTesting':
             return {
@@ -426,7 +606,7 @@ function moduleNameToDef(name) {
                 ],
                 jsonToAugment: {
                     'composer.json': [
-                        'autoload-dev.psr-4.${params.packageNamespaceEscapedSlash}\\Tests\\',
+                        'autoload-dev.psr-4.${params.packageNamespace}\\Tests\\',
                         'scripts.test',
                         'scripts.test:unit',
                         'scripts.test:integration',
@@ -438,7 +618,32 @@ function moduleNameToDef(name) {
                         'require-dev.flarum/testing',
                     ],
                 },
-                needsTemplateParams: ['packageNamespaceEscapedSlash'],
+                needsTemplateParams: ['packageNamespace'],
+                inferEnabled: async (_fs, paths) => {
+                    return (0, fs_1.existsSync)(paths.package('tests'));
+                },
+            };
+        case 'phpstan':
+            return {
+                name,
+                updatable: true,
+                togglable: true,
+                defaultEnabled: false,
+                shortDescription: 'Static analysis of PHP code with PHPStan.',
+                dependsOn: [],
+                filesToReplace: ['phpstan.neon'],
+                jsonToAugment: {
+                    'composer.json': [
+                        'scripts.analyse:phpstan',
+                        'scripts.clear-cache:phpstan',
+                        'scripts-descriptions.analyse:phpstan',
+                        'require-dev.flarum/phpstan',
+                    ],
+                },
+                needsTemplateParams: [],
+                inferEnabled: async (_fs, paths) => {
+                    return (0, fs_1.existsSync)(paths.package('phpstan.neon'));
+                },
             };
         case 'editorConfig':
             return {
@@ -460,9 +665,7 @@ function moduleNameToDef(name) {
                 defaultEnabled: true,
                 shortDescription: 'StyleCI config file',
                 dependsOn: [],
-                filesToReplace: [
-                    { path: '.styleci.yml', monorepoPath: '.styleci.yml' },
-                ],
+                filesToReplace: [{ path: '.styleci.yml', monorepoPath: '.styleci.yml', requireMonorepo: false }],
                 jsonToAugment: {},
                 needsTemplateParams: [],
             };
@@ -475,9 +678,9 @@ function genExtScaffolder() {
         return cached;
     const moduleStatusCache = {
         get: async (module, fs, paths) => {
-            var _a, _b, _c, _d;
+            var _a, _b, _c;
             const json = (0, composer_1.getComposerJson)(fs, paths);
-            return !module.togglable || ((_d = (_c = (_b = (_a = json === null || json === void 0 ? void 0 : json.extra) === null || _a === void 0 ? void 0 : _a['flarum-cli']) === null || _b === void 0 ? void 0 : _b.modules) === null || _c === void 0 ? void 0 : _c[module.name]) !== null && _d !== void 0 ? _d : module.defaultEnabled);
+            return !module.togglable || ((_c = (_b = (_a = json === null || json === void 0 ? void 0 : json.extra) === null || _a === void 0 ? void 0 : _a['flarum-cli']) === null || _b === void 0 ? void 0 : _b.modules) === null || _c === void 0 ? void 0 : _c[module.name]);
         },
         set: async (module, enabled, fs, paths) => {
             const json = {
@@ -493,11 +696,14 @@ function genExtScaffolder() {
         },
     };
     const excludeScaffoldingFunc = (fs, paths) => {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e, _f;
         const json = (0, composer_1.getComposerJson)(fs, paths);
-        return (_c = (_b = (_a = json === null || json === void 0 ? void 0 : json.extra) === null || _a === void 0 ? void 0 : _a['flarum-cli']) === null || _b === void 0 ? void 0 : _b.excludeScaffolding) !== null && _c !== void 0 ? _c : [];
+        return {
+            files: (_c = (_b = (_a = json === null || json === void 0 ? void 0 : json.extra) === null || _a === void 0 ? void 0 : _a['flarum-cli']) === null || _b === void 0 ? void 0 : _b.excludeScaffolding) !== null && _c !== void 0 ? _c : [],
+            configKeys: (_f = (_e = (_d = json === null || json === void 0 ? void 0 : json.extra) === null || _d === void 0 ? void 0 : _d['flarum-cli']) === null || _e === void 0 ? void 0 : _e.excludeScaffoldingConfigKeys) !== null && _f !== void 0 ? _f : {},
+        };
     };
-    const scaffolder = new scaffolder_1.Scaffolder((0, node_path_1.resolve)(__dirname, '../../boilerplate/skeleton/extension'), moduleStatusCache, excludeScaffoldingFunc);
+    const scaffolder = new scaffolder_1.Scaffolder((0, path_1.resolve)(__dirname, '../../boilerplate/skeleton/extension'), moduleStatusCache, excludeScaffoldingFunc);
     for (const name of exports.EXTENSION_MODULES) {
         scaffolder.registerModule(moduleNameToDef(name));
     }

package/lib/steps/js/base.d.ts

@@ -1,15 +1,24 @@
 import { Store } from 'mem-fs';
+import { Editor } from 'mem-fs-editor';
 import { IO } from 'boilersmith/io';
 import { Paths } from 'boilersmith/paths';
 import { Step } from 'boilersmith/step-manager';
 import { FlarumProviders } from '../../providers';
+import { ExtenderGenerationSchema } from '../extenders/base';
+import { ModuleImport } from '../../utils/ast';
+export type InitializerDefinition = {
+    code: string;
+    imports: ModuleImport[];
+};
 export declare abstract class BaseJsStep implements Step<FlarumProviders> {
     abstract type: string;
+    protected abstract schema: ExtenderGenerationSchema | null;
     composable: boolean;
-    run(fs: Store, paths: Paths, io: IO, _providers: FlarumProviders): Promise<Store>;
-    protected abstract getDefinition(io: IO): Promise<string>;
-    protected abstract getImports(frontend: string, paths: Paths, io: IO): Promise<string>;
-    protected importPath(frontend: string, classNamespace: string): string;
-    exposes: never[];
+    exposes: string[];
     getExposed(_paths: Paths, _paramProvider: IO): Record<string, unknown>;
+    protected params: Record<string, unknown>;
+    run(fs: Store, paths: Paths, io: IO, _providers: FlarumProviders): Promise<Store>;
+    protected abstract getDefinition(frontend: string, paths: Paths, io: IO): Promise<InitializerDefinition | null>;
+    protected compileParams(io: IO): Promise<Record<string, unknown>>;
+    protected ensureFrontendFilesExist(paths: Paths, fsEditor: Editor): void;
 }