@flarum/cli 3.0.13 → 3.0.15

package/README.md

@@ -49,7 +49,7 @@ $ npm install -g @flarum/cli
 $ flarum-cli COMMAND
 running command...
 $ flarum-cli (-v|--version|version)
-@flarum/cli/3.0.13 darwin-arm64 node-v26.11.1
+@flarum/cli/3.0.15 darwin-arm64 node-v26.12.0
 $ flarum-cli --help [COMMAND]
 USAGE
   $ flarum-cli COMMAND

package/boilerplate/skeleton/extension/js/package.json

@@ -7,15 +7,15 @@
   "dependencies": {
   },
   "devDependencies": {
-    "@flarum/jest-config": "^2.0.0",
+    "@flarum/jest-config": "^2.1.1",
     "@flarum/prettier-config": "^1.0.0",
     "flarum-tsconfig": "^2.0.0",
-    "flarum-webpack-config": "^3.0.7",
-    "prettier": "^2.5.1",
-    "typescript": "^4.9.5",
-    "typescript-coverage-report": "^0.6.1",
+    "flarum-webpack-config": "^3.1.0",
+    "prettier": "^3.9.10",
+    "typescript": "^5.9.3",
+    "typescript-coverage-report": "^0.6.4",
     "webpack": "^5.104.1",
-    "webpack-cli": "^4.9.1"
+    "webpack-cli": "^7.2.3"
   },
   "scripts": {
     "dev": "webpack --mode development --watch",

package/boilerplate/skeleton/extension/js/tsconfig.json

@@ -12,8 +12,8 @@
       "@types/**/*"
 ],
   "compilerOptions": {
-    // Only load the type packages the code imports. Others, such as the
-    // @types/node webpack brings along, use syntax TypeScript 4.9 can't read.
+    // Only load the type packages the code imports, not every one in
+    // node_modules, such as the @types/node webpack brings along.
     "types": [],
     // This will output typings to `dist-typings`
     "declarationDir": "./dist-typings",

package/lib/steps/upgrade/twopointoh/dependencies.d.ts

@@ -1,11 +1,10 @@
-import { AdvancedContent, BaseUpgradeStep, GitCommit, Replacement } from './base';
+import { BaseUpgradeStep, GitCommit, Replacement } from './base';
 export default class Dependencies extends BaseUpgradeStep {
     type: string;
-    /** The TypeScript the extension asked for, when it was not a 4.x. */
+    /** The TypeScript the extension asked for, when it allowed TypeScript 6 or newer. */
     protected typeScriptWas: string | null;
-    /** What was removed from tsconfig.json, as TypeScript 4.9 doesn't have it. */
+    /** What was removed from tsconfig.json, as TypeScript 5.9 refuses it. */
     protected removedCompilerOptions: string[];
-    protected newerSyntax: boolean;
     /** Constraints left as they were, as they already ask for newer versions. */
     protected keptNewer: string[];
     /** Tooling moved from dependencies to devDependencies. */
@@ -14,8 +13,6 @@ export default class Dependencies extends BaseUpgradeStep {
     protected addedTypings: string[];
     replacements(file: string): Replacement[];
     targets(): string[];
-    advancedContent(file: string, code: string): AdvancedContent;
-    updateCode(file: string, code: string, updated: string | AdvancedContent): Promise<string>;
     gitCommit(): GitCommit;
     pauseMessage(): string;
     /**
@@ -42,26 +39,27 @@ export default class Dependencies extends BaseUpgradeStep {
      */
     protected moveToolingToDevDependencies(pkg: Record<string, any>): void;
     /**
-     * Drop the compiler options, and option values, TypeScript 4.9 doesn't have:
-     * it refuses a tsconfig.json with any. A tsconfig.json it can read is left
+     * Drop the compiler options, and option values, TypeScript 5.9 refuses: it
+     * won't read a tsconfig.json with any. A tsconfig.json it can read is left
      * exactly as it was.
      */
     updateTsConfig(): Replacement;
     /**
      * TypeScript loads every type package in node_modules unless told which,
-     * and 4.9 can't read the @types/node that webpack's minimizer brings along.
-     * Load only the ones the code imports. The file is edited as text so its
-     * comments stay.
+     * including the @types/node that webpack's minimizer brings along. Load only
+     * the ones the code imports. The file is edited as text so its comments stay.
      */
     limitTypes(): Replacement;
     /**
      * A test config extending tsconfig.json would no longer load Jest's globals.
      */
     testTypes(): Replacement;
-    /** The extension's js/package.json, or nothing when it has none. */
-    protected packageJson(): Record<string, any>;
     /**
-     * Put a @TODO above each line using syntax TypeScript 4.9 can't compile.
+     * Whether TypeScript 6 and newer accept the extension's tsconfig.json: it
+     * replaces the moduleResolution flarum-tsconfig sets, which they refuse, and
+     * sets no baseUrl, which they refuse too.
      */
-    flagNewerSyntax(): Replacement;
+    protected tsConfigReadsWithSixOrNewer(): boolean;
+    /** The extension's js/package.json, or nothing when it has none. */
+    protected packageJson(): Record<string, any>;
 }

package/lib/steps/upgrade/twopointoh/dependencies.js

@@ -5,19 +5,12 @@ const base_1 = require("./base");
 const chalk_1 = tslib_1.__importDefault(require("chalk"));
 const fs_1 = tslib_1.__importDefault(require("fs"));
 const path_1 = tslib_1.__importDefault(require("path"));
-const typescript_4_9_1 = require("./typescript-4-9");
+const typescript_5_9_1 = require("./typescript-5-9");
 // What `fl init` gave 1.x extensions. `sed -i` with no suffix is GNU sed's
 // form: BSD sed, as on macOS, takes the next argument as the suffix and fails.
 // With the suffix attached, both work.
 const GNU_POST_BUILD_TYPINGS = "find dist-typings -type f -name '*.d.ts' -print0 | xargs -0 sed -i 's,../src/@types,@types,g'";
 const PORTABLE_POST_BUILD_TYPINGS = "find dist-typings -type f -name '*.d.ts' -print0 | xargs -0 sed -i.bak 's,../src/@types,@types,g' && find dist-typings -type f -name '*.d.ts.bak' -delete";
-// Syntax TypeScript 4.9 can't compile, each checked against typescript@4.9.5.
-const NEWER_SYNTAX = [
-    [/(?:\bfrom|^\s*import)\s+(["'])[^\n"']*\1\s+with\s*{/, 'import attributes (TypeScript 5.3); use `assert` instead of `with`'],
-    [/^\s*export\s+type\s+\*/, '`export type *` (TypeScript 5.0)'],
-    [/[,<]\s*const\s+[$A-Z_a-z][\w$]*\s*(?:extends\b|[,=>])/, '`const` type parameters (TypeScript 5.0)'],
-    [/^\s*(?:await\s+)?using\s+[$A-Z_a-z][\w$]*\s*[:=]/, '`using` declarations (TypeScript 5.2)'],
-];
 // Packages an extension only needs to build, check and test its frontend.
 const BUILD_TOOLING = new Set([
     '@flarum/jest-config',
@@ -42,8 +35,8 @@ function scaffoldedPackageJson(packageManager) {
     return JSON.parse(skeleton.replace(/<%= params\.jsPackageManager %>/g, packageManager));
 }
 const TYPES_COMMENT = [
-    'Only load the type packages the code imports. Others, such as the',
-    "@types/node webpack brings along, use syntax TypeScript 4.9 can't read.",
+    'Only load the type packages the code imports, not every one in',
+    'node_modules, such as the @types/node webpack brings along.',
 ];
 /**
  * The tsconfig.json with an option first in its compilerOptions, and the
@@ -64,11 +57,14 @@ function insertCompilerOption(code, comment, option) {
 }
 /** Dependencies in the alphabetical order package managers keep them in. */
 const sortedByName = (dependencies) => Object.fromEntries(Object.entries(dependencies).sort(([a], [b]) => a.localeCompare(b)));
-const isTypeScript = (file) => /\.tsx?$/.test(file);
-/** Whether a version constraint stays within TypeScript 4: `4.9.5`, `^4.5.4`, `~4.7`, `4.x`. */
-const isFourX = (constraint) => {
-    const version = constraint.trim().replace(/^\^|^~/, '');
-    return version === '4' || version.startsWith('4.');
+/**
+ * Whether a TypeScript constraint could resolve to TypeScript 6 or newer:
+ * `^6.0.3`, `>=4.2`, `latest`, `*`. A caret, tilde or exact constraint on 4 or
+ * 5 can't.
+ */
+const allowsSixOrNewer = (constraint) => {
+    const match = constraint.trim().match(/^[=^~]?\s*v?(\d+)(?:\.|$)/);
+    return !match || Number(match[1]) >= 6;
 };
 /**
  * The lowest version a simple constraint allows, as [major, minor, patch]:
@@ -92,11 +88,10 @@ class Dependencies extends base_1.BaseUpgradeStep {
     constructor() {
         super(...arguments);
         this.type = 'Update the extension dependencies to the latest versions.';
-        /** The TypeScript the extension asked for, when it was not a 4.x. */
+        /** The TypeScript the extension asked for, when it allowed TypeScript 6 or newer. */
         this.typeScriptWas = null;
-        /** What was removed from tsconfig.json, as TypeScript 4.9 doesn't have it. */
+        /** What was removed from tsconfig.json, as TypeScript 5.9 refuses it. */
         this.removedCompilerOptions = [];
-        this.newerSyntax = false;
         /** Constraints left as they were, as they already ask for newer versions. */
         this.keptNewer = [];
         /** Tooling moved from dependencies to devDependencies. */
@@ -119,24 +114,11 @@ class Dependencies extends base_1.BaseUpgradeStep {
             case 'js/tsconfig.test.json':
                 replacements.push(this.testTypes());
                 break;
-            default:
-                if (isTypeScript(file)) {
-                    replacements.push(this.flagNewerSyntax());
-                }
         }
         return replacements;
     }
     targets() {
-        return ['composer.json', 'js/package.json', 'js/tsconfig.json', 'js/tsconfig.test.json', 'js/src/**/*.ts', 'js/src/**/*.tsx'];
-    }
-    // TypeScript sources are only searched, line by line: parsing them would
-    // fail on the very syntax being looked for, and reformatting would change
-    // more than the lines flagged.
-    advancedContent(file, code) {
-        return isTypeScript(file) ? null : super.advancedContent(file, code);
-    }
-    async updateCode(file, code, updated) {
-        return isTypeScript(file) && typeof updated === 'string' ? updated : super.updateCode(file, code, updated);
+        return ['composer.json', 'js/package.json', 'js/tsconfig.json', 'js/tsconfig.test.json'];
     }
     gitCommit() {
         return {
@@ -151,10 +133,9 @@ class Dependencies extends base_1.BaseUpgradeStep {
         const npm = chalk_1.default.bgYellowBright('npm install');
         const notes = [
             this.typeScriptWas &&
-                `TypeScript ${this.typeScriptWas} was brought down to ^4.9.5: Flarum 2.0 builds and checks its typings with TypeScript 4.9.`,
+                `TypeScript ${this.typeScriptWas} was brought down to ^5.9.3: flarum-tsconfig resolves modules the way TypeScript 6 refuses without ignoreDeprecations.`,
             this.removedCompilerOptions.length > 0 &&
-                `Removed from js/tsconfig.json, as TypeScript 4.9 does not have them: ${this.removedCompilerOptions.join(', ')}.`,
-            this.newerSyntax && 'Some TypeScript uses syntax 4.9 cannot compile; look for the @TODO comments.',
+                `Removed from js/tsconfig.json, as TypeScript 5.9 refuses them: ${this.removedCompilerOptions.join(', ')}.`,
             this.addedTypings.length > 0 && `Added what the reusable frontend workflow runs to build and check typings: ${this.addedTypings.join(', ')}.`,
             this.movedToDev.length > 0 && `Moved to devDependencies, as the extension only builds with them: ${this.movedToDev.join(', ')}.`,
             this.keptNewer.length > 0 && `Kept, as they already ask for newer versions than Flarum 2.0 needs: ${this.keptNewer.join(', ')}.`,
@@ -232,28 +213,35 @@ class Dependencies extends base_1.BaseUpgradeStep {
         return (_file, _code, advanced) => {
             var _a;
             advanced = advanced;
-            // The versions a new extension is scaffolded with. 3.0.6 is the first
-            // flarum-webpack-config that loads an extension's code-split chunks from
-            // its own build, and 3.0.7 the first that exports a default export as its
-            // value, not under a name taken from its code.
+            // The versions a new extension is scaffolded with. 3.1.0 is the first
+            // flarum-webpack-config that supplies TypeScript 5.9 and only asks for
+            // webpack as a peer, and @flarum/jest-config 2.1.1 tests with the mithril
+            // Flarum ships and requires that flarum-webpack-config. Prettier 3 is what
+            // the upgrade has just formatted the code with.
             const map = {
-                'flarum-webpack-config': '^3.0.7',
+                'flarum-webpack-config': '^3.1.0',
                 'flarum-tsconfig': '^2.0.0',
-                '@flarum/jest-config': '^2.0.0',
+                '@flarum/jest-config': '^2.1.1',
+                prettier: '^3.9.10',
                 webpack: '^5.104.1',
-                'webpack-cli': '^4.9.1',
-                // What Flarum 2.0 builds and checks its typings with.
-                typescript: '^4.9.5',
+                'webpack-cli': '^7.2.3',
+                // What Flarum builds and checks its typings with.
+                typescript: '^5.9.3',
             };
             // Extensions list the tooling under either key, often split between both.
             for (const dependencies of [advanced.dependencies, advanced.devDependencies]) {
                 for (const key of Object.keys(dependencies || {})) {
-                    if (key === 'typescript' && !isFourX(String(dependencies[key]))) {
-                        this.typeScriptWas = dependencies[key];
+                    // TypeScript is the exception: it moves to what Flarum checks typings
+                    // with, whatever the extension asked for. flarum-tsconfig resolves
+                    // modules the way TypeScript 6 refuses, so a newer one comes down,
+                    // unless the extension's tsconfig already resolves them another way.
+                    if (key === 'typescript' && allowsSixOrNewer(String(dependencies[key])) && this.tsConfigReadsWithSixOrNewer()) {
+                        this.keptNewer.push(`${key} ${dependencies[key]}`);
                     }
-                    // TypeScript is the exception: it comes down to what Flarum checks
-                    // typings with, whatever the extension asked for.
-                    if (key === 'typescript') {
+                    else if (key === 'typescript') {
+                        if (allowsSixOrNewer(String(dependencies[key]))) {
+                            this.typeScriptWas = dependencies[key];
+                        }
                         dependencies[key] = map[key];
                     }
                     else if (map[key]) {
@@ -332,8 +320,8 @@ class Dependencies extends base_1.BaseUpgradeStep {
         this.movedToDev.push(...moving);
     }
     /**
-     * Drop the compiler options, and option values, TypeScript 4.9 doesn't have:
-     * it refuses a tsconfig.json with any. A tsconfig.json it can read is left
+     * Drop the compiler options, and option values, TypeScript 5.9 refuses: it
+     * won't read a tsconfig.json with any. A tsconfig.json it can read is left
      * exactly as it was.
      */
     updateTsConfig() {
@@ -342,13 +330,13 @@ class Dependencies extends base_1.BaseUpgradeStep {
             const options = tsconfig.compilerOptions || {};
             const removed = [];
             for (const [name, value] of Object.entries(options)) {
-                const known = Object.prototype.hasOwnProperty.call(typescript_4_9_1.compilerOptions, name) ? typescript_4_9_1.compilerOptions[name] : null;
+                const known = Object.prototype.hasOwnProperty.call(typescript_5_9_1.compilerOptions, name) ? typescript_5_9_1.compilerOptions[name] : null;
                 if (!known) {
                     removed.push(name);
                     delete options[name];
                 }
                 else if (name === 'lib' && Array.isArray(value)) {
-                    const kept = value.filter((lib) => typeof lib === 'string' && typescript_4_9_1.libs.includes(lib.toLowerCase()));
+                    const kept = value.filter((lib) => typeof lib === 'string' && typescript_5_9_1.libs.includes(lib.toLowerCase()));
                     for (const lib of value.filter((lib) => !kept.includes(lib))) {
                         removed.push(`lib "${lib}"`);
                     }
@@ -364,18 +352,14 @@ class Dependencies extends base_1.BaseUpgradeStep {
                     delete options[name];
                 }
             }
-            if (Array.isArray(tsconfig.extends)) {
-                this.leaveTodo('js/tsconfig.json', 'It extends a list of configs, which TypeScript 4.9 cannot read. Extend one, and move the rest into it.');
-            }
             this.removedCompilerOptions.push(...removed);
             return removed.length > 0 ? { updated: tsconfig } : null;
         };
     }
     /**
      * TypeScript loads every type package in node_modules unless told which,
-     * and 4.9 can't read the @types/node that webpack's minimizer brings along.
-     * Load only the ones the code imports. The file is edited as text so its
-     * comments stay.
+     * including the @types/node that webpack's minimizer brings along. Load only
+     * the ones the code imports. The file is edited as text so its comments stay.
      */
     limitTypes() {
         return (_file, code, advanced) => {
@@ -408,6 +392,22 @@ class Dependencies extends base_1.BaseUpgradeStep {
             return updated ? { updated } : null;
         };
     }
+    /**
+     * Whether TypeScript 6 and newer accept the extension's tsconfig.json: it
+     * replaces the moduleResolution flarum-tsconfig sets, which they refuse, and
+     * sets no baseUrl, which they refuse too.
+     */
+    tsConfigReadsWithSixOrNewer() {
+        var _a, _b;
+        try {
+            const code = fs_1.default.readFileSync(path_1.default.join(this.root, 'js/tsconfig.json'), 'utf8');
+            const options = (_b = (_a = this.advancedContent('js/tsconfig.json', code)) === null || _a === void 0 ? void 0 : _a.compilerOptions) !== null && _b !== void 0 ? _b : {};
+            return ['bundler', 'node16', 'nodenext'].includes(String(options.moduleResolution).toLowerCase()) && options.baseUrl === undefined;
+        }
+        catch (_c) {
+            return false;
+        }
+    }
     /** The extension's js/package.json, or nothing when it has none. */
     packageJson() {
         try {
@@ -417,29 +417,5 @@ class Dependencies extends base_1.BaseUpgradeStep {
             return {};
         }
     }
-    /**
-     * Put a @TODO above each line using syntax TypeScript 4.9 can't compile.
-     */
-    flagNewerSyntax() {
-        return (_file, code) => {
-            const flagged = [];
-            for (const line of code.split('\n')) {
-                for (const [pattern, what] of NEWER_SYNTAX) {
-                    if (!pattern.test(line))
-                        continue;
-                    const indent = line.slice(0, line.length - line.trimStart().length);
-                    const todo = `${indent}// @TODO: Flarum 2.0 builds with TypeScript 4.9, which has no ${what}.`;
-                    // An earlier run already flagged it.
-                    if (flagged.slice(-NEWER_SYNTAX.length).some((previous) => previous.trim() === todo.trim()))
-                        continue;
-                    flagged.push(line.endsWith('\r') ? `${todo}\r` : todo);
-                    this.newerSyntax = true;
-                }
-                flagged.push(line);
-            }
-            const updated = flagged.join('\n');
-            return updated === code ? null : { updated };
-        };
-    }
 }
 exports.default = Dependencies;

package/lib/steps/upgrade/twopointoh/typescript-5-9.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The compiler options TypeScript 5.9 accepts, which Flarum builds with, and
+ * the values it accepts for those that take one of a set. A tsconfig.json has
+ * to spell an option exactly so; its values may be in any case, so they are
+ * listed lowercase.
+ *
+ * Generated from typescript@5.9.3: `ts.optionDeclarations`, each name mapped
+ * to true, or to the keys of its type when that is a Map; the libs are the
+ * keys of the `lib` option's element type. Left out are the options and values
+ * 5.9 still declares but refuses, as TypeScript 5.5 removed them:
+ * charset, importsNotUsedAsValues, keyofStringsOnly, noImplicitUseStrict, noStrictGenericChecks, out, preserveValueImports, suppressExcessPropertyErrors, suppressImplicitAnyIndexErrors,
+ * and target ES3.
+ */
+export declare const compilerOptions: Record<string, true | string[]>;
+export declare const libs: string[];

package/lib/steps/upgrade/twopointoh/{typescript-4-9.js → typescript-5-9.js}

@@ -2,17 +2,22 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.libs = exports.compilerOptions = void 0;
 /**
- * The compiler options TypeScript 4.9 knows, which Flarum 2.0 builds with, and
+ * The compiler options TypeScript 5.9 accepts, which Flarum builds with, and
  * the values it accepts for those that take one of a set. A tsconfig.json has
  * to spell an option exactly so; its values may be in any case, so they are
  * listed lowercase.
  *
- * Generated from typescript@4.9.5: `ts.optionDeclarations`, each name mapped
+ * Generated from typescript@5.9.3: `ts.optionDeclarations`, each name mapped
  * to true, or to the keys of its type when that is a Map; the libs are the
- * keys of the `lib` option's element type.
+ * keys of the `lib` option's element type. Left out are the options and values
+ * 5.9 still declares but refuses, as TypeScript 5.5 removed them:
+ * charset, importsNotUsedAsValues, keyofStringsOnly, noImplicitUseStrict, noStrictGenericChecks, out, preserveValueImports, suppressExcessPropertyErrors, suppressImplicitAnyIndexErrors,
+ * and target ES3.
  */
 exports.compilerOptions = {
     all: true,
+    allowArbitraryExtensions: true,
+    allowImportingTsExtensions: true,
     allowJs: true,
     allowSyntheticDefaultImports: true,
     allowUmdGlobalAccess: true,
@@ -21,10 +26,9 @@ exports.compilerOptions = {
     alwaysStrict: true,
     assumeChangesOnlyAffectDirectDependencies: true,
     baseUrl: true,
-    build: true,
-    charset: true,
     checkJs: true,
     composite: true,
+    customConditions: true,
     declaration: true,
     declarationDir: true,
     declarationMap: true,
@@ -37,6 +41,7 @@ exports.compilerOptions = {
     emitBOM: true,
     emitDeclarationOnly: true,
     emitDecoratorMetadata: true,
+    erasableSyntaxOnly: true,
     esModuleInterop: true,
     exactOptionalPropertyTypes: true,
     experimentalDecorators: true,
@@ -48,29 +53,46 @@ exports.compilerOptions = {
     help: true,
     ignoreDeprecations: true,
     importHelpers: true,
-    importsNotUsedAsValues: ['error', 'preserve', 'remove'],
     incremental: true,
     init: true,
     inlineSourceMap: true,
     inlineSources: true,
+    isolatedDeclarations: true,
     isolatedModules: true,
     jsx: ['preserve', 'react', 'react-jsx', 'react-jsxdev', 'react-native'],
     jsxFactory: true,
     jsxFragmentFactory: true,
     jsxImportSource: true,
-    keyofStringsOnly: true,
     lib: true,
+    libReplacement: true,
     listEmittedFiles: true,
     listFiles: true,
     listFilesOnly: true,
     locale: true,
     mapRoot: true,
     maxNodeModuleJsDepth: true,
-    module: ['amd', 'commonjs', 'es2015', 'es2020', 'es2022', 'es6', 'esnext', 'node16', 'nodenext', 'none', 'system', 'umd'],
+    module: [
+        'amd',
+        'commonjs',
+        'es2015',
+        'es2020',
+        'es2022',
+        'es6',
+        'esnext',
+        'node16',
+        'node18',
+        'node20',
+        'nodenext',
+        'none',
+        'preserve',
+        'system',
+        'umd',
+    ],
     moduleDetection: ['auto', 'force', 'legacy'],
-    moduleResolution: ['classic', 'node', 'node16', 'nodenext'],
+    moduleResolution: ['bundler', 'classic', 'node', 'node10', 'node16', 'nodenext'],
     moduleSuffixes: true,
     newLine: ['crlf', 'lf'],
+    noCheck: true,
     noEmit: true,
     noEmitHelpers: true,
     noEmitOnError: true,
@@ -80,28 +102,28 @@ exports.compilerOptions = {
     noImplicitOverride: true,
     noImplicitReturns: true,
     noImplicitThis: true,
-    noImplicitUseStrict: true,
     noLib: true,
     noPropertyAccessFromIndexSignature: true,
     noResolve: true,
-    noStrictGenericChecks: true,
     noUncheckedIndexedAccess: true,
+    noUncheckedSideEffectImports: true,
     noUnusedLocals: true,
     noUnusedParameters: true,
-    out: true,
     outDir: true,
     outFile: true,
     paths: true,
     plugins: true,
     preserveConstEnums: true,
     preserveSymlinks: true,
-    preserveValueImports: true,
     preserveWatchOutput: true,
     pretty: true,
     project: true,
     reactNamespace: true,
     removeComments: true,
     resolveJsonModule: true,
+    resolvePackageJsonExports: true,
+    resolvePackageJsonImports: true,
+    rewriteRelativeImportExtensions: true,
     rootDir: true,
     rootDirs: true,
     showConfig: true,
@@ -111,24 +133,27 @@ exports.compilerOptions = {
     sourceRoot: true,
     strict: true,
     strictBindCallApply: true,
+    strictBuiltinIteratorReturn: true,
     strictFunctionTypes: true,
     strictNullChecks: true,
     strictPropertyInitialization: true,
     stripInternal: true,
-    suppressExcessPropertyErrors: true,
-    suppressImplicitAnyIndexErrors: true,
-    target: ['es2015', 'es2016', 'es2017', 'es2018', 'es2019', 'es2020', 'es2021', 'es2022', 'es3', 'es5', 'es6', 'esnext'],
+    target: ['es2015', 'es2016', 'es2017', 'es2018', 'es2019', 'es2020', 'es2021', 'es2022', 'es2023', 'es2024', 'es5', 'es6', 'esnext'],
     traceResolution: true,
     tsBuildInfoFile: true,
     typeRoots: true,
     types: true,
     useDefineForClassFields: true,
     useUnknownInCatchVariables: true,
+    verbatimModuleSyntax: true,
     version: true,
     watch: true,
 };
 exports.libs = [
+    'decorators',
+    'decorators.legacy',
     'dom',
+    'dom.asynciterable',
     'dom.iterable',
     'es2015',
     'es2015.collection',
@@ -142,7 +167,10 @@ exports.libs = [
     'es2015.symbol.wellknown',
     'es2016',
     'es2016.array.include',
+    'es2016.intl',
     'es2017',
+    'es2017.arraybuffer',
+    'es2017.date',
     'es2017.intl',
     'es2017.object',
     'es2017.sharedmemory',
@@ -179,8 +207,20 @@ exports.libs = [
     'es2022.error',
     'es2022.intl',
     'es2022.object',
-    'es2022.sharedmemory',
+    'es2022.regexp',
     'es2022.string',
+    'es2023',
+    'es2023.array',
+    'es2023.collection',
+    'es2023.intl',
+    'es2024',
+    'es2024.arraybuffer',
+    'es2024.collection',
+    'es2024.object',
+    'es2024.promise',
+    'es2024.regexp',
+    'es2024.sharedmemory',
+    'es2024.string',
     'es5',
     'es6',
     'es7',
@@ -188,13 +228,23 @@ exports.libs = [
     'esnext.array',
     'esnext.asynciterable',
     'esnext.bigint',
+    'esnext.collection',
+    'esnext.decorators',
+    'esnext.disposable',
+    'esnext.error',
+    'esnext.float16',
     'esnext.intl',
+    'esnext.iterator',
+    'esnext.object',
     'esnext.promise',
+    'esnext.regexp',
+    'esnext.sharedmemory',
     'esnext.string',
     'esnext.symbol',
     'esnext.weakref',
     'scripthost',
     'webworker',
+    'webworker.asynciterable',
     'webworker.importscripts',
     'webworker.iterable',
 ];

package/oclif.manifest.json

@@ -1 +1 @@
-{"version":"3.0.13","commands":{"infra":{"id":"infra","description":"Add/Update infrastructure to the latest scaffolding for some module in an extension. For example, you can use this to add/update TypeScript, backend testing, GitHub Actions, and other features.","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"monorepo":{"name":"monorepo","type":"boolean","char":"m","allowNo":false},"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"module","description":"The name of the module to enable/update.","required":true,"options":["core","icon","admin","forum","js","jsCommon","css","locale","gitConf","githubActions","prettier","typescript","bundlewatch","frontendTesting","backendTesting","phpstan","editorConfig","styleci"]},{"name":"path","description":"Where should this command be executed?"}]},"init":{"id":"init","description":"Create a new Flarum extension","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"audit:infra":{"id":"audit:infra","description":"Check for outdated config files, infrastructure, setup, etc.","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"fix":{"name":"fix","type":"boolean","char":"f","allowNo":false},"monorepo":{"name":"monorepo","type":"boolean","char":"m","allowNo":false},"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"flarum:change":{"id":"flarum:change","description":"Related Flarum version information.","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{},"args":[]},"flarum:info":{"id":"flarum:info","description":"Related Flarum version information.","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{},"args":[]},"make:locale":{"id":"make:locale","description":"Generate new locale key value pair.","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"key","description":"The nested key of the locale (e.g. `forum.custom_modal.title`).","required":false},{"name":"value","description":"The value of the locale.","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:model":{"id":"make:model","description":"Generate a model class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:notification":{"id":"make:notification","description":"Generate a new notification","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:post-type":{"id":"make:post-type","description":"Generate a new post type","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"monorepo:create":{"id":"monorepo:create","description":"Create a monorepo of Flarum extensions.","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"config":{"name":"config","type":"option","char":"c","required":false},"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"monorepo:split":{"id":"monorepo:split","description":"Split monorepo changes into subrepos.","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"force":{"name":"force","type":"boolean","char":"f","required":false,"allowNo":false},"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"update:js-imports":{"id":"update:js-imports","description":"Updates JS imports from core to use proper namespaces","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"upgrade:2.0":{"id":"upgrade:2.0","description":"Upgrade an extension to Flarum 2.0","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"json":{"name":"json","type":"boolean","description":"Report each step's outcome, failures, notes and the @TODOs it left as JSON, for a program driving the upgrade. Implies --no-interaction.","required":false,"allowNo":false},"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false},"step":{"name":"step","type":"option","description":"Optionally specify a specific step to run","required":false},"force-steps":{"name":"force-steps","type":"boolean","description":"Force run steps even if already ran","required":false,"allowNo":false},"check":{"name":"check","type":"boolean","description":"Report what the upgrade would change, such as on an extension already on Flarum 2.0, without changing it: the steps run on the last commit, in a temporary git worktree that is removed afterwards. Implies --force-steps and --no-interaction.","required":false,"allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:api-resource":{"id":"make:backend:api-resource","description":"Generate an API resource class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:command":{"id":"make:backend:command","description":"Generate a console command class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:controller":{"id":"make:backend:controller","description":"Generate a controller class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:event-listener":{"id":"make:backend:event-listener","description":"Generate an event listener class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:filter":{"id":"make:backend:filter","description":"Generate a filter class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:handler":{"id":"make:backend:handler","description":"Generate a domain logic handler class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:integration-test":{"id":"make:backend:integration-test","description":"Generate an integration test class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:job":{"id":"make:backend:job","description":"Generate a job class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:mail-driver":{"id":"make:backend:mail-driver","description":"Generate a mail driver class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:middleware":{"id":"make:backend:middleware","description":"Generate a middleware","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:migration":{"id":"make:backend:migration","description":"Generate a migration","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"name","description":"The name of the migration","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:model":{"id":"make:backend:model","description":"Generate a model class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:notification-blueprint":{"id":"make:backend:notification-blueprint","description":"Generate a notification blueprint class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:notification-driver":{"id":"make:backend:notification-driver","description":"Generate a notification driver class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:policy":{"id":"make:backend:policy","description":"Generate a policy class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:post-type":{"id":"make:backend:post-type","description":"Generate a new backend post type class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:repository":{"id":"make:backend:repository","description":"Generate a repository class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:route":{"id":"make:backend:route","description":"Generate a routes extender","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:search-driver":{"id":"make:backend:search-driver","description":"Generate a search driver","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:service-provider":{"id":"make:backend:service-provider","description":"Generate a service provider class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:validator":{"id":"make:backend:validator","description":"Generate a validator class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:frontend:component":{"id":"make:frontend:component","description":"Generate a frontend component","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"frontend","description":"The frontend name","required":false},{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:frontend:forum-page":{"id":"make:frontend:forum-page","description":"Generate a forum page class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"routeName","description":"Route name (unique)","required":false},{"name":"routePath","description":"Route path","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:frontend:gambit":{"id":"make:frontend:gambit","description":"Generate a frontend gambit class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:frontend:modal":{"id":"make:frontend:modal","description":"Generate a modal component","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"frontend","description":"The frontend name","required":false},{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:frontend:model":{"id":"make:frontend:model","description":"Generate a model class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:frontend:notification":{"id":"make:frontend:notification","description":"Generate a frontend notification class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:frontend:post-type":{"id":"make:frontend:post-type","description":"Generate a frontend post type class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]}}}
+{"version":"3.0.15","commands":{"infra":{"id":"infra","description":"Add/Update infrastructure to the latest scaffolding for some module in an extension. For example, you can use this to add/update TypeScript, backend testing, GitHub Actions, and other features.","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"monorepo":{"name":"monorepo","type":"boolean","char":"m","allowNo":false},"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"module","description":"The name of the module to enable/update.","required":true,"options":["core","icon","admin","forum","js","jsCommon","css","locale","gitConf","githubActions","prettier","typescript","bundlewatch","frontendTesting","backendTesting","phpstan","editorConfig","styleci"]},{"name":"path","description":"Where should this command be executed?"}]},"init":{"id":"init","description":"Create a new Flarum extension","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"audit:infra":{"id":"audit:infra","description":"Check for outdated config files, infrastructure, setup, etc.","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"fix":{"name":"fix","type":"boolean","char":"f","allowNo":false},"monorepo":{"name":"monorepo","type":"boolean","char":"m","allowNo":false},"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"flarum:change":{"id":"flarum:change","description":"Related Flarum version information.","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{},"args":[]},"flarum:info":{"id":"flarum:info","description":"Related Flarum version information.","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{},"args":[]},"make:locale":{"id":"make:locale","description":"Generate new locale key value pair.","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"key","description":"The nested key of the locale (e.g. `forum.custom_modal.title`).","required":false},{"name":"value","description":"The value of the locale.","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:model":{"id":"make:model","description":"Generate a model class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:notification":{"id":"make:notification","description":"Generate a new notification","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:post-type":{"id":"make:post-type","description":"Generate a new post type","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"monorepo:create":{"id":"monorepo:create","description":"Create a monorepo of Flarum extensions.","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"config":{"name":"config","type":"option","char":"c","required":false},"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"monorepo:split":{"id":"monorepo:split","description":"Split monorepo changes into subrepos.","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"force":{"name":"force","type":"boolean","char":"f","required":false,"allowNo":false},"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"update:js-imports":{"id":"update:js-imports","description":"Updates JS imports from core to use proper namespaces","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"upgrade:2.0":{"id":"upgrade:2.0","description":"Upgrade an extension to Flarum 2.0","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"json":{"name":"json","type":"boolean","description":"Report each step's outcome, failures, notes and the @TODOs it left as JSON, for a program driving the upgrade. Implies --no-interaction.","required":false,"allowNo":false},"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false},"step":{"name":"step","type":"option","description":"Optionally specify a specific step to run","required":false},"force-steps":{"name":"force-steps","type":"boolean","description":"Force run steps even if already ran","required":false,"allowNo":false},"check":{"name":"check","type":"boolean","description":"Report what the upgrade would change, such as on an extension already on Flarum 2.0, without changing it: the steps run on the last commit, in a temporary git worktree that is removed afterwards. Implies --force-steps and --no-interaction.","required":false,"allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:api-resource":{"id":"make:backend:api-resource","description":"Generate an API resource class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:command":{"id":"make:backend:command","description":"Generate a console command class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:controller":{"id":"make:backend:controller","description":"Generate a controller class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:event-listener":{"id":"make:backend:event-listener","description":"Generate an event listener class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:filter":{"id":"make:backend:filter","description":"Generate a filter class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:handler":{"id":"make:backend:handler","description":"Generate a domain logic handler class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:integration-test":{"id":"make:backend:integration-test","description":"Generate an integration test class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:job":{"id":"make:backend:job","description":"Generate a job class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:mail-driver":{"id":"make:backend:mail-driver","description":"Generate a mail driver class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:middleware":{"id":"make:backend:middleware","description":"Generate a middleware","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:migration":{"id":"make:backend:migration","description":"Generate a migration","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"name","description":"The name of the migration","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:model":{"id":"make:backend:model","description":"Generate a model class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:notification-blueprint":{"id":"make:backend:notification-blueprint","description":"Generate a notification blueprint class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:notification-driver":{"id":"make:backend:notification-driver","description":"Generate a notification driver class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:policy":{"id":"make:backend:policy","description":"Generate a policy class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:post-type":{"id":"make:backend:post-type","description":"Generate a new backend post type class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:repository":{"id":"make:backend:repository","description":"Generate a repository class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:route":{"id":"make:backend:route","description":"Generate a routes extender","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:search-driver":{"id":"make:backend:search-driver","description":"Generate a search driver","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:backend:service-provider":{"id":"make:backend:service-provider","description":"Generate a service provider class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:backend:validator":{"id":"make:backend:validator","description":"Generate a validator class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:frontend:component":{"id":"make:frontend:component","description":"Generate a frontend component","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"frontend","description":"The frontend name","required":false},{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:frontend:forum-page":{"id":"make:frontend:forum-page","description":"Generate a forum page class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"routeName","description":"Route name (unique)","required":false},{"name":"routePath","description":"Route path","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:frontend:gambit":{"id":"make:frontend:gambit","description":"Generate a frontend gambit class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"path","description":"Where should this command be executed?"}]},"make:frontend:modal":{"id":"make:frontend:modal","description":"Generate a modal component","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"frontend","description":"The frontend name","required":false},{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:frontend:model":{"id":"make:frontend:model","description":"Generate a model class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:frontend:notification":{"id":"make:frontend:notification","description":"Generate a frontend notification class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]},"make:frontend:post-type":{"id":"make:frontend:post-type","description":"Generate a frontend post type class","pluginName":"@flarum/cli","pluginType":"core","aliases":[],"flags":{"no-interaction":{"name":"no-interaction","type":"boolean","char":"n","description":"Do not ask any interactive questions, assume defaults. When impossible, error.","allowNo":false},"help":{"name":"help","type":"boolean","char":"h","description":"Show CLI help.","allowNo":false}},"args":[{"name":"className","description":"The name of the class to generate","required":false},{"name":"path","description":"Where should this command be executed?"}]}}}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@flarum/cli",
   "description": "A CLI for developing Flarum extensions",
-  "version": "3.0.13",
+  "version": "3.0.15",
   "author": "Flarum Team",
   "flarum": "2.x",
   "bin": {

package/lib/steps/upgrade/twopointoh/typescript-4-9.d.ts

@@ -1,12 +0,0 @@
-/**
- * The compiler options TypeScript 4.9 knows, which Flarum 2.0 builds with, and
- * the values it accepts for those that take one of a set. A tsconfig.json has
- * to spell an option exactly so; its values may be in any case, so they are
- * listed lowercase.
- *
- * Generated from typescript@4.9.5: `ts.optionDeclarations`, each name mapped
- * to true, or to the keys of its type when that is a Map; the libs are the
- * keys of the `lib` option's element type.
- */
-export declare const compilerOptions: Record<string, true | string[]>;
-export declare const libs: string[];