generator-jhipster 8.5.0 → 8.7.0

package/dist/jdl/readers/json-reader.js

@@ -42,14 +42,13 @@ export default function parseFromDir(dir) {
             try {
                 entities.set(entityName, readJSONFile(`${entityDir}/${file}`));
             }
-            catch (error) {
+            catch {
                 // Not an entity file, not adding
             }
         }
     });
     const applicationOptions = readJSONFile(`${dir}/.yo-rc.json`)['generator-jhipster'];
-    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-    // @ts-expect-error
+    // @ts-expect-error TODO
     const jdlObject = convertServerOptionsToJDL(applicationOptions);
     const convertedJDLObject = convertEntitiesToJDL(entities);
     return mergeJDLObjects(jdlObject, convertedJDLObject);

package/dist/jdl/utils/file-utils.js

@@ -54,7 +54,7 @@ function getStatObject(file) {
     try {
         return fs.statSync(file);
     }
-    catch (error) {
+    catch {
         return false;
     }
 }

package/dist/jdl/utils/objects/logger.js

@@ -16,12 +16,11 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { transports, format, createLogger } from 'winston';
-const { Console } = transports;
-const { printf, combine } = format;
-const myFormat = printf(info => `${info.level}: ${info.message}`);
-export default createLogger({
-    transports: [new Console()],
-    format: combine(myFormat),
-    handleExceptions: true,
-});
+import { createJHipsterLogger } from '../../../generators/base/support/logger.js';
+const logger = createJHipsterLogger({ namespace: 'jhipster:jdl' });
+export default {
+    info: (message) => logger.verboseInfo(message),
+    error: (message) => logger.error(message),
+    warn: (message) => logger.warn(message),
+    debug: (message) => logger.debug(message),
+};

package/dist/jdl/validators/deployment-validator.js

@@ -16,8 +16,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { applicationOptions, applicationTypes, databaseTypes, deploymentOptions, searchEngineTypes } from '../jhipster/index.js';
 import Validator from './validator.js';
-import { applicationTypes, databaseTypes, searchEngineTypes, deploymentOptions, applicationOptions } from '../jhipster/index.js';
 const { Options } = deploymentOptions;
 const { MICROSERVICE } = applicationTypes;
 const { NO } = databaseTypes;

package/dist/jdl/validators/entity-validator.js

@@ -16,8 +16,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import Validator from './validator.js';
 import { reservedKeywords } from '../jhipster/index.js';
+import Validator from './validator.js';
 const { isReservedClassName } = reservedKeywords;
 export default class EntityValidator extends Validator {
     constructor() {

package/dist/jdl/validators/enum-validator.js

@@ -16,8 +16,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import Validator from './validator.js';
 import { reservedKeywords } from '../jhipster/index.js';
+import Validator from './validator.js';
 const { isReservedClassName } = reservedKeywords;
 export default class EnumValidator extends Validator {
     constructor() {

package/dist/jdl/validators/jdl-with-application-validator.js

@@ -16,9 +16,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { applicationOptions, fieldTypes, relationshipOptions } from '../jhipster/index.js';
 import EntityValidator from './entity-validator.js';
 import FieldValidator from './field-validator.js';
-import { fieldTypes, applicationOptions, relationshipOptions } from '../jhipster/index.js';
 import ValidationValidator from './validation-validator.js';
 import RelationshipValidator from './relationship-validator.js';
 import EnumValidator from './enum-validator.js';

package/dist/jdl/validators/jdl-without-application-validator.js

@@ -16,16 +16,16 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+import { applicationTypes, binaryOptions, databaseTypes, fieldTypes, relationshipOptions } from '../jhipster/index.js';
+import { isReservedFieldName, isReservedPaginationWords, isReservedTableName } from '../jhipster/reserved-keywords.js';
 import EntityValidator from './entity-validator.js';
 import FieldValidator from './field-validator.js';
-import { fieldTypes, applicationTypes, databaseTypes, binaryOptions, relationshipOptions } from '../jhipster/index.js';
 import ValidationValidator from './validation-validator.js';
 import RelationshipValidator from './relationship-validator.js';
 import EnumValidator from './enum-validator.js';
 import DeploymentValidator from './deployment-validator.js';
 import UnaryOptionValidator from './unary-option-validator.js';
 import BinaryOptionValidator from './binary-option-validator.js';
-import { isReservedFieldName, isReservedPaginationWords, isReservedTableName } from '../jhipster/reserved-keywords.js';
 const { BUILT_IN_ENTITY } = relationshipOptions;
 const { SQL } = databaseTypes;
 /**

package/dist/jdl/validators/relationship-validator.js

@@ -16,9 +16,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import Validator from './validator.js';
 import { relationshipTypes } from '../jhipster/index.js';
 import { relationshipTypeExists } from '../jhipster/relationship-types.js';
+import Validator from './validator.js';
 const { ONE_TO_ONE, MANY_TO_MANY, MANY_TO_ONE, ONE_TO_MANY } = relationshipTypes;
 export default class RelationshipValidator extends Validator {
     constructor() {

package/dist/jdl/validators/validation-validator.js

@@ -16,8 +16,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import Validator from './validator.js';
 import { validations } from '../jhipster/index.js';
+import Validator from './validator.js';
 const { Validations: { exists, needsValue, MINLENGTH, MAXLENGTH, MAXBYTES, MINBYTES }, } = validations;
 export default class ValidationValidator extends Validator {
     constructor() {

package/dist/lib/eslint/base.js

@@ -0,0 +1,46 @@
+import unusedImports from 'eslint-plugin-unused-imports';
+import imports from 'eslint-plugin-import';
+import { fixupPluginRules } from '@eslint/compat';
+/**
+ * @type {import('typescript-eslint').ConfigWithExtends}
+ *
+ * Config applied to transformed source in generation process.
+ * Rules must be compatible with auto fix to be applied.
+ */
+const baseConfig = {
+    plugins: {
+        'unused-imports': unusedImports,
+        import: fixupPluginRules(imports),
+    },
+    rules: {
+        'dot-notation': 'error',
+        eqeqeq: ['error', 'always', { null: 'ignore' }],
+        'no-else-return': 'error',
+        'no-regex-spaces': 'error',
+        'no-useless-computed-key': 'error',
+        'no-useless-return': 'error',
+        'no-var': 'error',
+        'object-shorthand': 'error',
+        'prefer-const': 'error',
+        'prefer-destructuring': ['error', { array: false }],
+        'prefer-object-has-own': 'error',
+        'prefer-object-spread': 'error',
+        'prefer-template': 'error',
+        'sort-imports': ['error', { ignoreDeclarationSort: true }],
+        // Configure unused-imports rule
+        'no-unused-vars': 'off',
+        'import/no-duplicates': 'error',
+        'import/order': 'error',
+        'unused-imports/no-unused-imports': 'error',
+        'unused-imports/no-unused-vars': [
+            'warn',
+            {
+                vars: 'all',
+                varsIgnorePattern: '^_',
+                args: 'after-used',
+                argsIgnorePattern: '^_',
+            },
+        ],
+    },
+};
+export default baseConfig;

package/dist/lib/eslint/index.js

@@ -0,0 +1,4 @@
+import recommended from './recommended.js';
+import base from './base.js';
+recommended.recommended = recommended;
+export default { ...recommended, recommended, base };

package/dist/lib/eslint/recommended.js

@@ -0,0 +1,23 @@
+import js from '@eslint/js';
+import baseConfig from './base.js';
+/** @type {import('typescript-eslint').ConfigWithExtends} */
+const recommended = {
+    languageOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module',
+    },
+    settings: {
+        'import/parsers': {
+            espree: ['.js', '.cjs', '.mjs', '.jsx'],
+        },
+        'import/resolver': {
+            node: true,
+        },
+    },
+    ...baseConfig,
+    rules: {
+        ...js.configs.recommended.rules,
+        ...baseConfig.rules,
+    },
+};
+export default recommended;

package/dist/lib/index.js

@@ -11,5 +11,4 @@ export const getPackageRoot = (relativePath) => {
     const packageDirectory = isDistFolder() ? join(sourceRoot, '..') : sourceRoot;
     return relativePath ? join(packageDirectory, relativePath) : packageDirectory;
 };
-// eslint-disable-next-line import/prefer-default-export
 export const packageJson = JSON.parse(readFileSync(getPackageRoot('package.json')).toString());

package/dist/lib/internal/config-def.js

@@ -8,7 +8,6 @@ export const convertConfigToOption = (name, config) => {
         description: config.description,
         choices,
         scope: config.scope ?? 'storage',
-        ...(config.prompt && typeof config.default !== 'function' ? {} : { default: config.default }),
         ...config.cli,
     };
 };
@@ -20,7 +19,6 @@ export function loadConfig(configsDef, { application, config }) {
                 let source = config;
                 if (!source) {
                     if (def.scope === 'generator') {
-                        // eslint-disable-next-line @typescript-eslint/no-this-alias
                         source = this;
                     }
                     else if (def.scope === 'blueprint') {
@@ -31,8 +29,8 @@ export function loadConfig(configsDef, { application, config }) {
                     }
                 }
                 value = application[name] = source[name] ?? undefined;
-                if (value === undefined && def.default) {
-                    application[name] = typeof def.default === 'function' ? def.default(source) : def.default;
+                if (value === undefined && def.default !== undefined) {
+                    application[name] = typeof def.default === 'function' ? def.default.call(this, source) : def.default;
                 }
             }
         }

package/dist/testing/github.js

@@ -0,0 +1,32 @@
+import { randomUUID } from 'node:crypto';
+import { appendFileSync, existsSync } from 'node:fs';
+import { EOL } from 'node:os';
+import axios from 'axios';
+export const parseIssue = (issue) => {
+    if (issue.includes('#')) {
+        const split = issue.split('/');
+        const split2 = split[1].split('#');
+        return { owner: split[0], repository: split2[0], issue: split2[1] };
+    }
+    return undefined;
+};
+export const setGithubTaskOutput = (name, value) => {
+    const delimiter = `delimiter_${randomUUID()}`;
+    const output = `${name}<<${delimiter}${EOL}${value}${EOL}${delimiter}${EOL}`;
+    const filePath = process.env.GITHUB_OUTPUT;
+    if (filePath && existsSync(filePath)) {
+        appendFileSync(filePath, output, { encoding: 'utf8' });
+    }
+    else {
+        // eslint-disable-next-line no-console
+        console.log(output);
+    }
+};
+export const getGithubIssue = async ({ owner, repository, issue }) => {
+    const response = await axios.get(`https://api.github.com/repos/${owner}/${repository}/issues/${issue}`, {
+        headers: {
+            'X-GitHub-Api-Version': '2022-11-28',
+        },
+    });
+    return response.data;
+};

package/dist/testing/helpers.js

@@ -1,28 +1,31 @@
-import { YeomanTest, RunContext, result } from 'yeoman-test';
-import { merge, set } from 'lodash-es';
-import { globSync } from 'glob';
 import { basename, dirname, join } from 'path';
 import { fileURLToPath } from 'url';
+import { merge, set, snakeCase } from 'lodash-es';
+import { RunContext, YeomanTest, result } from 'yeoman-test';
+import { globSync } from 'glob';
 import EnvironmentBuilder from '../cli/environment-builder.mjs';
 import { JHIPSTER_CONFIG_DIR } from '../generators/generator-constants.js';
 import { GENERATOR_WORKSPACES } from '../generators/generator-list.js';
-import getGenerator from './get-generator.js';
 import { createJHipsterLogger, normalizePathEnd, parseCreationTimestamp } from '../generators/base/support/index.js';
 import BaseGenerator from '../generators/base/index.js';
 import { getPackageRoot, isDistFolder } from '../lib/index.js';
+import getGenerator from './get-generator.js';
 const runResult = result;
 export { runResult, runResult as result };
 const DEFAULT_TEST_SETTINGS = { forwardCwd: true };
 const DEFAULT_TEST_OPTIONS = { skipInstall: true };
 const DEFAULT_TEST_ENV_OPTIONS = { skipInstall: true, dryRun: false };
 const generatorsDir = join(fileURLToPath(import.meta.url), '../../generators');
-const mockedGenerators = [
+const allGenerators = [
     ...globSync('*/index.{j,t}s', { cwd: generatorsDir, posix: true }).map(file => dirname(file)),
     ...globSync('*/generators/*/index.{j,t}s', { cwd: generatorsDir, posix: true }).map(file => dirname(file).replace('/generators/', ':')),
 ]
-    .filter(gen => !gen.startsWith('bootstrap-'))
     .map(gen => `jhipster:${gen}`)
     .sort();
+const filterBootstrapGenerators = (gen) => !gen.startsWith('jhipster:bootstrap-');
+const composedGeneratorsToCheck = allGenerators
+    .filter(filterBootstrapGenerators)
+    .filter(gen => !['jhipster:bootstrap', 'jhipster:project-name'].includes(gen));
 const defaultSharedApplication = Object.fromEntries(['CLIENT_WEBPACK_DIR'].map(key => [key, undefined]));
 let defaultMockFactory;
 export const defineDefaults = async ({ mockFactory } = {}) => {
@@ -183,8 +186,27 @@ class JHipsterRunContext extends RunContext {
         merge(this.sharedApplication, sharedApplication);
         return this.withSharedData({ sharedApplication: this.sharedApplication });
     }
-    withMockedJHipsterGenerators(exceptList = []) {
-        return this.withMockedGenerators(mockedGenerators.filter(gen => !exceptList.includes(gen) && this.Generator !== gen));
+    withMockedNodeDependencies() {
+        return this.withSharedApplication({
+            nodeDependencies: new Proxy({}, { get: (_target, prop) => `${snakeCase(prop.toString()).toUpperCase()}_VERSION` }),
+        });
+    }
+    /**
+     * Mock every built-in generators except the ones in the except and bootstrap-* generators.
+     * Note: Boostrap generator is mocked by default.
+     * @example
+     * withMockedJHipsterGenerators({ except: ['jhipster:bootstrap'] })
+     * @example
+     * withMockedJHipsterGenerators({ except: ['bootstrap', 'server'] })
+     * @example
+     * // Mock every generator including bootstrap-*
+     * withMockedJHipsterGenerators({ filter: () => true })
+     */
+    withMockedJHipsterGenerators(options = {}) {
+        const optionsObj = Array.isArray(options) ? { except: options } : options;
+        const { except = [], filter = filterBootstrapGenerators } = optionsObj;
+        const jhipsterExceptList = except.map(gen => (gen.startsWith('jhipster:') ? gen : `jhipster:${gen}`));
+        return this.withMockedGenerators(allGenerators.filter(filter).filter(gen => !jhipsterExceptList.includes(gen) && this.Generator !== gen));
     }
     withGradleBuildTool() {
         return this.withFiles({
@@ -213,7 +235,7 @@ plugins {
     async run() {
         const runResult = (await super.run());
         if (this.sharedSource) {
-            const sourceCallsArg = Object.fromEntries(Object.entries(this.sharedSource).map(([name, fn]) => [name, fn.mock.calls.map(args => args[0])]));
+            const sourceCallsArg = Object.fromEntries(Object.entries(this.sharedSource).map(([name, fn]) => [name, fn.mock.calls.map(args => (args.length > 1 ? args : args[0]))]));
             if (sourceCallsArg.addEntitiesToClient) {
                 sourceCallsArg.addEntitiesToClient = sourceCallsArg.addEntitiesToClient.map(({ application, entities }) => ({
                     application: `Application[${application.baseName}]`,
@@ -228,7 +250,7 @@ plugins {
             }
             runResult.sourceCallsArg = sourceCallsArg;
         }
-        runResult.composedMockedGenerators = mockedGenerators.filter(gen => runResult.mockedGenerators[gen]?.called && !['jhipster:bootstrap', 'jhipster:project-name'].includes(gen));
+        runResult.composedMockedGenerators = composedGeneratorsToCheck.filter(gen => runResult.mockedGenerators[gen]?.called);
         return runResult;
     }
 }
@@ -301,6 +323,7 @@ const commonTestOptions = {
     noInsight: true,
     useVersionPlaceholders: true,
     fakeKeytool: true,
+    skipGit: true,
 };
 export const basicHelpers = createTestHelpers({ generatorOptions: { ...commonTestOptions } });
 export const defaultHelpers = createTestHelpers({

package/dist/testing/index.js

@@ -1,5 +1,7 @@
 export { default as getGenerator } from './get-generator.js';
 export * from './helpers.js';
+export * from './github.js';
+export * from './sample-config.js';
 // test matrix
 export * from './support/application-samples.js';
 export * from './support/client-samples.js';

package/dist/testing/sample-config.js

@@ -0,0 +1,31 @@
+import { lstat, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { GENERATOR_JHIPSTER } from '../generators/generator-constants.js';
+import { mutateData } from '../generators/base/support/config.js';
+const isFile = async (filename) => {
+    try {
+        return (await lstat(filename)).isFile();
+    }
+    catch {
+        return false;
+    }
+};
+export const prepareSample = async (projectFolder, files, { removeBlueprints } = {}) => {
+    return Promise.all(files.map(async ({ filename, content }) => {
+        filename = join(projectFolder, filename);
+        if (filename.endsWith('.yo-rc.json')) {
+            if (await isFile(filename)) {
+                const { jwtSecretKey, rememberMeKey } = JSON.parse(await readFile(filename, 'utf-8'))[GENERATOR_JHIPSTER];
+                if (jwtSecretKey || rememberMeKey) {
+                    const newContent = JSON.parse(content);
+                    mutateData(newContent[GENERATOR_JHIPSTER], { jwtSecretKey, rememberMeKey });
+                    if (removeBlueprints) {
+                        delete newContent[GENERATOR_JHIPSTER].blueprints;
+                    }
+                    content = JSON.stringify(newContent, null, 2);
+                }
+            }
+        }
+        return { filename, content };
+    }));
+};

package/dist/testing/support/client-samples.js

@@ -1,4 +1,4 @@
-import { MatrixMonolith, MatrixMicroserviceGateway } from './application-samples.js';
+import { MatrixMicroserviceGateway, MatrixMonolith } from './application-samples.js';
 import { buildSamplesFromMatrix, extendFilteredMatrix, extendMatrix, fromMatrix } from './matrix-utils.js';
 const CLIENT_ADDITIONAL_CONFIG_MATRIX = {
     withAdminUi: [false, true],
@@ -18,5 +18,4 @@ export const buildClientSamples = (commonConfig) => {
     clientMatrix = extendMatrix(clientMatrix, CLIENT_ADDITIONAL_CONFIG_MATRIX);
     return buildSamplesFromMatrix(clientMatrix, { commonConfig });
 };
-// eslint-disable-next-line import/prefer-default-export
 export const clientSamples = buildClientSamples();

package/dist/testing/support/matrix-utils.js

@@ -7,18 +7,21 @@ const appendTitle = (title, config, value) => {
     const newTitle = typeof value === 'string' && value !== 'no' ? value : `${config}(${value})`;
     return `${title}${title.length === 0 ? '' : '-'}${newTitle}`;
 };
-export const fromMatrix = configMatrix => {
+/**
+ * Create a matrix from a options
+ * @example
+ * const matrix = fromMatrix({ a: [true, false], b: [true, false] });
+ * // {
+ * //  'a(true)-b(true)': { a: true, b: true },
+ * //  'a(true)-b(false)': { a: true, b: false },
+ * //  'a(false)-b(true)': { a: false, b: true },
+ * //  'a(false)-b(false)': { a: false, b: false },
+ * // }
+ */
+export const fromMatrix = (configMatrix) => {
     const configEntries = Object.entries(configMatrix);
     const samples = configEntries.reduce((previousValue, currentValue) => {
         const [config, configValues] = currentValue;
-        if (previousValue.length === 0) {
-            return configValues.map(value => [
-                value,
-                {
-                    [config]: value,
-                },
-            ]);
-        }
         return previousValue
             .map(([previousName, previousConfig]) => configValues.map(value => {
             return [
@@ -30,7 +33,7 @@ export const fromMatrix = configMatrix => {
             ];
         }))
             .flat();
-    }, []);
+    }, [['', {}]]);
     return Object.fromEntries(samples);
 };
 const applyExtendedMatrix = (matrixEntries, configMatrix) => {
@@ -65,6 +68,15 @@ const applyExtendedMatrix = (matrixEntries, configMatrix) => {
     });
     return matrixEntries;
 };
+/**
+ * Apply new matrix value to existing matrix
+ * @example
+ * const matrix = extendMatrix(fromMatrix({ initialMatrix: [true, false] }), { toBeMerged: [true, false] });
+ * // {
+ * //  'initialMatrix(true)-toBeMerged(true)': { initialMatrix: true, toBeMerged: true },
+ * //  'initialMatrix(false)-toBeMerged(false)': { initialMatrix: false, toBeMerged: false },
+ * // }
+ */
 export const extendMatrix = (matrix, configMatrix) => {
     return Object.fromEntries(applyExtendedMatrix(Object.entries(matrix), configMatrix));
 };

package/dist/testing/support/server-samples.js

@@ -1,6 +1,5 @@
-import { MatrixMonolith, MatrixMicroservice, MatrixGateway } from './application-samples.js';
-import { fromMatrix, extendMatrix, extendFilteredMatrix, buildSamplesFromMatrix } from './matrix-utils.js';
-// eslint-disable-next-line import/prefer-default-export
+import { MatrixGateway, MatrixMicroservice, MatrixMonolith } from './application-samples.js';
+import { buildSamplesFromMatrix, extendFilteredMatrix, extendMatrix, fromMatrix } from './matrix-utils.js';
 export const buildServerMatrix = (matrix = {}) => {
     let serverMatrix = {
         ...fromMatrix({

package/dist/types/cli/commands.d.mts

@@ -2,6 +2,7 @@ export default defaultCommands;
 declare const defaultCommands: {
     add: {
         desc: string;
+        removed: string;
     };
     app: {
         desc: string;
@@ -93,6 +94,7 @@ declare const defaultCommands: {
     };
     page: {
         desc: string;
+        removed: string;
     };
     'project-name': {
         desc: string;

package/dist/types/cli/environment-builder.d.mts

@@ -26,6 +26,7 @@ export default class EnvironmentBuilder {
      * @return {EnvironmentBuilder} envBuilder
      */
     static createDefaultBuilder(...args: any[]): EnvironmentBuilder;
+    static run(args: any, generatorOptions?: {}, envOptions?: {}): Promise<void>;
     /**
      * Class to manipulate yeoman environment for jhipster needs.
      * - Registers jhipster generators.

package/dist/types/generators/base/api.d.ts

@@ -1,11 +1,9 @@
-import type { BaseOptions, BaseFeatures, ArgumentSpec, CliOptionSpec } from 'yeoman-generator';
-import type { SetOptional } from 'type-fest';
+import type { ArgumentSpec, BaseFeatures, BaseOptions, CliOptionSpec } from 'yeoman-generator';
+import type { RequireAtLeastOne, SetOptional } from 'type-fest';
 import type CoreGenerator from '../base-core/index.js';
 
 export type ApplicationWithConfig = {
-  config: {
-    [key: string]: string | boolean | number | string[];
-  };
+  config: Record<string, string | boolean | number | string[]>;
   entities: Record<string, unknown>;
 };
 
@@ -36,6 +34,9 @@ export type JHipsterGeneratorOptions = BaseOptions & {
   entities?: string[];
   disableBlueprints?: boolean;
 
+  /* Init based application */
+  fromInit?: boolean;
+
   /* blueprint options */
   blueprints?: string;
   blueprint?: any;
@@ -70,7 +71,7 @@ export type JHipsterGeneratorFeatures = BaseFeatures & {
   /**
    * Wraps write context and shows removed fields and replacements if exists.
    */
-  jhipster7Migration?: boolean;
+  jhipster7Migration?: boolean | 'verbose' | 'silent';
   sbsBlueprint?: boolean;
   checkBlueprint?: boolean;
   /**
@@ -98,9 +99,20 @@ export type JHipsterGeneratorFeatures = BaseFeatures & {
    * Create transforms for commit.
    */
   commitTransformFactory?: () => any;
+
+  /**
+   * Queue tasks to handle command definitions.
+   *  - parse options and configurations from cli.
+   *  - prompt configurations.
+   *  - configure configurations.
+   *  - compose with generators defined in command.
+   *  - load configurations.
+   *
+   * Defaults to true for built-in generator-jhipster generators and false for blueprints.
+   */
+  queueCommandTasks?: boolean;
 };
 
-// eslint-disable-next-line no-use-before-define
 export type EditFileCallback<Generator = CoreGenerator> = (this: Generator, content: string, filePath: string) => string;
 
 export type EditFileOptions = { create?: boolean; ignoreNonExisting?: boolean | string; assertModified?: boolean };
@@ -114,20 +126,20 @@ export type WriteFileTemplate<Generator = CoreGenerator, DataType = any> =
   | ((this: Generator, data: DataType, filePath: string) => string)
   | {
       /** source file */
-      sourceFile?: ((this: Generator, data: DataType) => string) | string;
+      sourceFile?: string | ((this: Generator, data: DataType) => string);
       /** destination file */
-      destinationFile?: (this: Generator, destinationFile: DataType) => string | string;
+      destinationFile?: string | ((this: Generator, destinationFile: DataType) => string);
       /** @deprecated, use sourceFile instead */
-      file?: ((this: Generator, data: DataType) => string) | string;
+      file?: string | ((this: Generator, data: DataType) => string);
       /** @deprecated, use destinationFile instead */
-      renameTo?: ((this: Generator, data: DataType, filePath: string) => string) | string;
+      renameTo?: string | ((this: Generator, data: DataType, filePath: string) => string);
       /** transforms (files processing) to be applied */
       transform?: boolean | (() => string)[];
       /** binary files skips ejs render, ejs extension and file transform */
       binary?: boolean;
       /** ejs options. Refer to https://ejs.co/#docs */
       options?: Record<string, object>;
-      override?: (this: Generator, data: DataType) => boolean;
+      override?: boolean | ((this: Generator, data: DataType) => boolean);
     };
 
 export type WriteFileBlock<Generator = CoreGenerator, DataType = any> = {
@@ -159,6 +171,13 @@ export type WriteFileOptions<Generator = CoreGenerator, DataType = any> = {
    * Single absolute path or relative path(s) between the templates folder and template path.
    */
   rootTemplatesPath?: string | string[];
+
+  /** @experimental Customize templates sourceFile and destinationFile */
+  customizeTemplatePath?: (file: {
+    sourceFile: string;
+    resolvedSourceFile: string;
+    destinationFile: string;
+  }) => undefined | { sourceFile: string; resolvedSourceFile: string; destinationFile: string };
 } & (
   | {
       sections: WriteFileSection<Generator, DataType>;
@@ -213,8 +232,11 @@ export type ConfigSpec = {
    * The callback receives the generator as input for 'generator' scope.
    * The callback receives jhipsterConfigWithDefaults as input for 'storage' (default) scope.
    * The callback receives blueprintStorage contents as input for 'blueprint' scope.
+   *
+   * Default value will not be applied to generator (using 'generator' scope) in initializing priority. Use cli.default instead.
+   * Default value will be application to templates context object (application) in loading priority.
    */
-  default?: string | boolean | string[] | ((any) => string | boolean | string[]);
+  default?: string | boolean | number | string[] | ((this: CoreGenerator | void, ctx: any) => string | boolean | number | string[]);
   /**
    * Configure the generator according to the selected configuration.
    */
@@ -225,7 +247,7 @@ export type JHipsterArguments = Record<string, JHipsterArgumentConfig>;
 
 export type JHipsterOptions = Record<string, JHipsterOption>;
 
-export type JHipsterConfigs = Record<string, ConfigSpec>;
+export type JHipsterConfigs = Record<string, RequireAtLeastOne<ConfigSpec, 'argument' | 'cli' | 'prompt'>>;
 
 export type JHipsterCommandDefinition = {
   arguments?: JHipsterArguments;

package/dist/types/generators/base/generator.d.ts

@@ -1,7 +1,7 @@
 import type { ComposeOptions } from 'yeoman-generator';
+import CoreGenerator from '../base-core/index.js';
 import { BaseGeneratorDefinition, GenericTaskGroup } from './tasks.js';
 import type { JHipsterGeneratorFeatures, JHipsterGeneratorOptions } from './api.js';
-import CoreGenerator from '../base-core/index.js';
 /**
  * Base class that contains blueprints support.
  */