@mikro-orm/entity-generator 7.0.3 → 7.0.4-dev.1

package/SourceFile.js

@@ -1,13 +1,4 @@
-import {
-  Cascade,
-  Config,
-  DecimalType,
-  ReferenceKind,
-  SCALAR_TYPES,
-  UnknownType,
-  Utils,
-  inspect,
-} from '@mikro-orm/core';
+import { Cascade, Config, DecimalType, ReferenceKind, SCALAR_TYPES, UnknownType, Utils, inspect, } from '@mikro-orm/core';
 import { parse, relative } from 'node:path';
 import { POSSIBLE_TYPE_IMPORTS } from './CoreImportsHelper.js';
 /**
@@ -16,1003 +7,944 @@ import { POSSIBLE_TYPE_IMPORTS } from './CoreImportsHelper.js';
 export const identifierRegex = /^(?:[$_\p{ID_Start}])(?:[$\u200C\u200D\p{ID_Continue}])*$/u;
 const primitivesAndLibs = [...SCALAR_TYPES, 'unknown', 'object', 'any'];
 export class SourceFile {
-  meta;
-  namingStrategy;
-  platform;
-  options;
-  coreImports = new Set();
-  decoratorImports = new Set();
-  entityImports = new Set();
-  enumImports = new Map();
-  constructor(meta, namingStrategy, platform, options) {
-    this.meta = meta;
-    this.namingStrategy = namingStrategy;
-    this.platform = platform;
-    this.options = options;
-  }
-  generate() {
-    let ret = '';
-    if (this.meta.embeddable || this.meta.collection) {
-      if (this.meta.embeddable) {
-        const options = this.getEmbeddableDeclOptions();
-        ret += `@${this.referenceDecoratorImport('Embeddable')}(${Utils.hasObjectKeys(options) ? this.serializeObject(options) : ''})\n`;
-      } else {
-        const options = this.getEntityDeclOptions();
-        ret += `@${this.referenceDecoratorImport('Entity')}(${Utils.hasObjectKeys(options) ? this.serializeObject(options) : ''})\n`;
-      }
-    }
-    for (const index of this.meta.indexes) {
-      if (index.properties?.length === 1 && typeof this.meta.properties[index.properties[0]] !== 'undefined') {
-        continue;
-      }
-      ret += `@${this.referenceDecoratorImport('Index')}(${this.serializeObject(this.getIndexOptions(index))})\n`;
-    }
-    for (const index of this.meta.uniques) {
-      if (index.properties?.length === 1 && typeof this.meta.properties[index.properties[0]] !== 'undefined') {
-        continue;
-      }
-      ret += `@${this.referenceDecoratorImport('Unique')}(${this.serializeObject(this.getUniqueOptions(index))})\n`;
-    }
-    let classHead = '';
-    if (this.meta.className === this.options.customBaseEntityName) {
-      const defineConfigTypeSettings = {};
-      defineConfigTypeSettings.forceObject = this.platform.getConfig().get('serialization').forceObject ?? false;
-      classHead += `\n${' '.repeat(2)}[${this.referenceCoreImport('Config')}]?: ${this.referenceCoreImport('DefineConfig')}<${this.serializeObject(defineConfigTypeSettings)}>;\n\n`;
-    }
-    if (this.meta.repositoryClass) {
-      this.entityImports.add(this.meta.repositoryClass);
-      classHead += `\n${' '.repeat(2)}[${this.referenceCoreImport('EntityRepositoryType')}]?: ${this.meta.repositoryClass};\n`;
-    }
-    const enumDefinitions = [];
-    const eagerProperties = [];
-    const primaryProps = [];
-    let classBody = '';
-    Object.values(this.meta.properties).forEach(prop => {
-      const decorator = this.getPropertyDecorator(prop, 2);
-      const definition = this.getPropertyDefinition(prop, 2);
-      classBody += decorator;
-      classBody += definition;
-      classBody += '\n';
-      if (prop.enum) {
-        const def = this.getEnumClassDefinition(prop, 2);
-        if (def.length) {
-          enumDefinitions.push(def);
-        }
-      }
-      if (prop.eager) {
-        eagerProperties.push(prop);
-      }
-      if (prop.primary && (!['id', '_id', 'uuid'].includes(prop.name) || this.meta.compositePK)) {
-        primaryProps.push(prop);
-      }
-    });
-    if (primaryProps.length > 0) {
-      const primaryPropNames = primaryProps.map(prop => `'${prop.name}'`);
-      if (primaryProps.length > 1) {
-        classHead += `\n${' '.repeat(2)}[${this.referenceCoreImport('PrimaryKeyProp')}]?: [${primaryPropNames.join(', ')}];\n`;
-      } else {
-        classHead += `\n${' '.repeat(2)}[${this.referenceCoreImport('PrimaryKeyProp')}]?: ${primaryPropNames[0]};\n`;
-      }
-    }
-    if (eagerProperties.length > 0) {
-      const eagerPropertyNames = eagerProperties.map(prop => `'${prop.name}'`).sort();
-      classHead += `\n${' '.repeat(2)}[${this.referenceCoreImport('EagerProps')}]?: ${eagerPropertyNames.join(' | ')};\n`;
-    }
-    ret += this.getEntityClass(classBody ? `${classHead}\n${classBody}` : classHead);
-    ret = `${this.generateImports()}\n\n${enumDefinitions.length ? enumDefinitions.join('\n') + '\n' : ''}${ret}`;
-    return ret;
-  }
-  /**
-   * Convert index column options to quoted output format.
-   */
-  getColumnOptions(columns) {
-    if (!columns?.length) {
-      return undefined;
-    }
-    return columns.map(col => {
-      const colOpt = { name: this.quote(col.name) };
-      if (col.sort) {
-        colOpt.sort = this.quote(col.sort.toUpperCase());
-      }
-      if (col.nulls) {
-        colOpt.nulls = this.quote(col.nulls.toUpperCase());
-      }
-      if (col.length != null) {
-        colOpt.length = col.length;
-      }
-      if (col.collation) {
-        colOpt.collation = this.quote(col.collation);
-      }
-      return colOpt;
-    });
-  }
-  getIndexOptions(index, isAtEntityLevel = true) {
-    const indexOpt = {};
-    if (typeof index.name === 'string') {
-      indexOpt.name = this.quote(index.name);
-    }
-    if (typeof index.expression === 'string') {
-      indexOpt.expression = this.quote(index.expression);
-    } else if (typeof index.expression === 'function') {
-      indexOpt.expression = `${index.expression}`.replace(')=>`', ') => `');
-    }
-    if (isAtEntityLevel && index.properties) {
-      indexOpt.properties = Utils.asArray(index.properties).map(prop => this.quote('' + prop));
-    }
-    // Index type (e.g., 'fulltext', 'spatial', 'btree', 'hash')
-    if (index.type) {
-      indexOpt.type = this.quote(index.type);
-    }
-    // Advanced index options
-    const columns = this.getColumnOptions(index.columns);
-    if (columns) {
-      indexOpt.columns = columns;
-    }
-    if (index.include) {
-      indexOpt.include = Utils.asArray(index.include).map(prop => this.quote('' + prop));
-    }
-    if (index.fillFactor != null) {
-      indexOpt.fillFactor = index.fillFactor;
-    }
-    if (index.invisible) {
-      indexOpt.invisible = true;
-    }
-    if (index.disabled) {
-      indexOpt.disabled = true;
-    }
-    if (index.clustered) {
-      indexOpt.clustered = true;
-    }
-    return indexOpt;
-  }
-  getUniqueOptions(index, isAtEntityLevel = true) {
-    const uniqueOpt = {};
-    if (typeof index.name === 'string') {
-      uniqueOpt.name = this.quote(index.name);
-    }
-    if (typeof index.expression === 'string') {
-      uniqueOpt.expression = this.quote(index.expression);
-    } else if (typeof index.expression === 'function') {
-      uniqueOpt.expression = `${index.expression}`.replace(')=>`', ') => `');
-    }
-    if (isAtEntityLevel && index.properties) {
-      uniqueOpt.properties = Utils.asArray(index.properties).map(prop => this.quote('' + prop));
-    }
-    if (index.deferMode) {
-      uniqueOpt.deferMode = `${this.referenceCoreImport('DeferMode')}.INITIALLY_${index.deferMode.toUpperCase()}`;
-    }
-    const columns = this.getColumnOptions(index.columns);
-    if (columns) {
-      uniqueOpt.columns = columns;
-    }
-    if (index.include) {
-      uniqueOpt.include = Utils.asArray(index.include).map(prop => this.quote('' + prop));
-    }
-    if (index.fillFactor != null) {
-      uniqueOpt.fillFactor = index.fillFactor;
-    }
-    if (index.disabled) {
-      uniqueOpt.disabled = true;
-    }
-    return uniqueOpt;
-  }
-  generateImports() {
-    const imports = new Set();
-    if (this.coreImports.size > 0) {
-      imports.add(
-        `import { ${[...this.coreImports]
-          .sort()
-          .map(t => {
-            let ret = POSSIBLE_TYPE_IMPORTS.includes(t) ? `type ${t}` : t;
-            if (this.options.coreImportsPrefix) {
-              const resolvedIdentifier = `${this.options.coreImportsPrefix}${t}`;
-              ret += ` as ${resolvedIdentifier}`;
-            }
-            return ret;
-          })
-          .join(', ')} } from '@mikro-orm/core';`,
-      );
-    }
-    if (this.decoratorImports.size > 0) {
-      const type = this.options.decorators;
-      imports.add(
-        `import { ${[...this.decoratorImports]
-          .sort()
-          .map(t => {
-            let ret = t;
-            if (this.options.coreImportsPrefix) {
-              const resolvedIdentifier = `${this.options.coreImportsPrefix}${t}`;
-              ret += ` as ${resolvedIdentifier}`;
-            }
-            return ret;
-          })
-          .join(', ')} } from '@mikro-orm/decorators/${type}';`,
-      );
-    }
-    const extension = this.options.esmImport ? '.js' : '';
-    const { dir, base } = parse(`${this.options.path ?? '.'}/${this.getBaseName()}`);
-    const basePath = relative(dir, this.options.path ?? '.') || '.';
-    (this.options.extraImports?.(basePath, base) ?? []).forEach(v => this.entityImports.add(v));
-    const entityImports = [...this.entityImports].filter(e => e !== this.meta.className);
-    const importMap = new Map();
-    for (const entity of entityImports) {
-      const file = this.options.onImport?.(entity, basePath, extension, base) ?? {
-        path: `${basePath}/${this.options.fileName(entity)}${extension}`,
-        name: entity,
-      };
-      if (file.path === '') {
-        if (file.name === '') {
-          continue;
-        }
-        importMap.set(file.path, `import ${this.quote(file.name)};`);
-        continue;
-      }
-      if (file.name === '') {
-        importMap.set(file.path, `import * as ${entity} from ${this.quote(file.path)};`);
-        continue;
-      }
-      if (file.name === 'default') {
-        importMap.set(file.path, `import ${entity} from ${this.quote(file.path)};`);
-        continue;
-      }
-      if (file.name === entity) {
-        importMap.set(file.path, `import { ${entity} } from ${this.quote(file.path)};`);
-        continue;
-      }
-      importMap.set(
-        file.path,
-        `import { ${identifierRegex.test(file.name) ? file.name : this.quote(file.name)} as ${entity} } from ${this.quote(file.path)};`,
-      );
-    }
-    if (this.enumImports.size) {
-      for (const [name, exports] of this.enumImports.entries()) {
-        const file = this.options.onImport?.(name, basePath, extension, base) ?? {
-          path: `${basePath}/${this.options.fileName(name)}${extension}`,
-          name,
-        };
-        importMap.set(file.path, `import { ${exports.join(', ')} } from ${this.quote(file.path)};`);
-      }
-    }
-    for (const key of [...importMap.keys()].sort()) {
-      imports.add(importMap.get(key));
-    }
-    return Array.from(imports.values()).join('\n');
-  }
-  getEntityClass(classBody) {
-    let ret = `export `;
-    if (this.meta.abstract) {
-      ret += `abstract `;
-    }
-    ret += `class ${this.meta.className}`;
-    if (this.meta.extends) {
-      this.entityImports.add(Utils.className(this.meta.extends));
-      ret += ` extends ${Utils.className(this.meta.extends)}`;
-    } else if (this.options.useCoreBaseEntity) {
-      ret += ` extends ${this.referenceCoreImport('BaseEntity')}`;
-    }
-    ret += ` {\n${classBody}}\n`;
-    return ret;
-  }
-  getBaseName(extension = '.ts') {
-    return `${this.options.fileName(this.meta.className)}${extension}`;
-  }
-  quote(val) {
-    const backtick = val.startsWith(`'`) || val.includes('\n');
-    /* v8 ignore next */
-    return backtick ? `\`${val.replaceAll('`', '\\``')}\`` : `'${val.replaceAll(`'`, `\\'`)}'`;
-  }
-  getPropertyDefinition(prop, padLeft) {
-    const padding = ' '.repeat(padLeft);
-    const propName = identifierRegex.test(prop.name) ? prop.name : this.quote(prop.name);
-    const enumMode = this.options.enumMode;
-    let hiddenType = '';
-    if (prop.hidden) {
-      hiddenType += ` & ${this.referenceCoreImport('Hidden')}`;
-    }
-    if ([ReferenceKind.ONE_TO_MANY, ReferenceKind.MANY_TO_MANY].includes(prop.kind)) {
-      return `${padding}${propName}${hiddenType ? `: ${this.referenceCoreImport('Collection')}<${prop.type}>${hiddenType}` : ''} = new ${this.referenceCoreImport('Collection')}<${prop.type}>(this);\n`;
-    }
-    const isScalar = typeof prop.kind === 'undefined' || prop.kind === ReferenceKind.SCALAR;
-    let breakdownOfIType;
-    const propType = prop.mapToPk
-      ? (() => {
-          const runtimeTypes = prop.columnTypes.map(
-            (t, i) => (prop.customTypes?.[i] ?? this.platform.getMappedType(t)).runtimeType,
-          );
-          return runtimeTypes.length === 1 ? runtimeTypes[0] : this.serializeObject(runtimeTypes);
-        })()
-      : (() => {
-          if (isScalar) {
+    meta;
+    namingStrategy;
+    platform;
+    options;
+    coreImports = new Set();
+    decoratorImports = new Set();
+    entityImports = new Set();
+    enumImports = new Map();
+    constructor(meta, namingStrategy, platform, options) {
+        this.meta = meta;
+        this.namingStrategy = namingStrategy;
+        this.platform = platform;
+        this.options = options;
+    }
+    generate() {
+        let ret = '';
+        if (this.meta.embeddable || this.meta.collection) {
+            if (this.meta.embeddable) {
+                const options = this.getEmbeddableDeclOptions();
+                ret += `@${this.referenceDecoratorImport('Embeddable')}(${Utils.hasObjectKeys(options) ? this.serializeObject(options) : ''})\n`;
+            }
+            else {
+                const options = this.getEntityDeclOptions();
+                ret += `@${this.referenceDecoratorImport('Entity')}(${Utils.hasObjectKeys(options) ? this.serializeObject(options) : ''})\n`;
+            }
+        }
+        for (const index of this.meta.indexes) {
+            if (index.properties?.length === 1 && typeof this.meta.properties[index.properties[0]] !== 'undefined') {
+                continue;
+            }
+            ret += `@${this.referenceDecoratorImport('Index')}(${this.serializeObject(this.getIndexOptions(index))})\n`;
+        }
+        for (const index of this.meta.uniques) {
+            if (index.properties?.length === 1 && typeof this.meta.properties[index.properties[0]] !== 'undefined') {
+                continue;
+            }
+            ret += `@${this.referenceDecoratorImport('Unique')}(${this.serializeObject(this.getUniqueOptions(index))})\n`;
+        }
+        let classHead = '';
+        if (this.meta.className === this.options.customBaseEntityName) {
+            const defineConfigTypeSettings = {};
+            defineConfigTypeSettings.forceObject = this.platform.getConfig().get('serialization').forceObject ?? false;
+            classHead += `\n${' '.repeat(2)}[${this.referenceCoreImport('Config')}]?: ${this.referenceCoreImport('DefineConfig')}<${this.serializeObject(defineConfigTypeSettings)}>;\n\n`;
+        }
+        if (this.meta.repositoryClass) {
+            this.entityImports.add(this.meta.repositoryClass);
+            classHead += `\n${' '.repeat(2)}[${this.referenceCoreImport('EntityRepositoryType')}]?: ${this.meta.repositoryClass};\n`;
+        }
+        const enumDefinitions = [];
+        const eagerProperties = [];
+        const primaryProps = [];
+        let classBody = '';
+        Object.values(this.meta.properties).forEach(prop => {
+            const decorator = this.getPropertyDecorator(prop, 2);
+            const definition = this.getPropertyDefinition(prop, 2);
+            classBody += decorator;
+            classBody += definition;
+            classBody += '\n';
             if (prop.enum) {
-              const method = enumMode === 'ts-enum' ? 'getEnumClassName' : 'getEnumTypeName';
-              if (prop.nativeEnumName) {
-                return this.namingStrategy[method](prop.nativeEnumName, undefined, this.meta.schema);
-              }
-              return this.namingStrategy[method](prop.fieldNames[0], this.meta.collection, this.meta.schema);
-            }
-            breakdownOfIType = this.breakdownOfIType(prop);
-            if (typeof breakdownOfIType !== 'undefined') {
-              if (breakdownOfIType.length >= 3) {
-                hiddenType = '';
-              }
-              return `${this.referenceCoreImport('IType')}<${breakdownOfIType.join(', ')}>`;
-            }
-            return prop.runtimeType;
-          }
-          return prop.type;
-        })();
-    const hasUsableNullDefault = prop.nullable && !this.options.forceUndefined && prop.default === null;
-    const useDefault =
-      hasUsableNullDefault ||
-      (!(typeof prop.default === 'undefined' || prop.default === null) &&
-        propType !== 'unknown' &&
-        typeof breakdownOfIType === 'undefined');
-    const optional = prop.nullable && (this.options.forceUndefined || prop.optional) ? '?' : useDefault ? '' : '!';
-    let ret = `${propName}${optional}: `;
-    const isArray = prop.array && (prop.kind === ReferenceKind.EMBEDDED || prop.enum);
-    const complexType = isArray ? `${propType}[]` : propType;
-    let wrappedType = prop.ref
-      ? `${this.referenceCoreImport('Ref')}<${complexType}${isScalar && prop.nullable && !this.options.forceUndefined ? ' | null' : ''}>`
-      : this.options.esmImport && !isScalar
-        ? `${this.referenceCoreImport('Rel')}<${complexType}>`
-        : complexType;
-    if (
-      prop.nullable &&
-      !this.options.forceUndefined &&
-      (!isScalar || (!prop.ref && !wrappedType.includes(' | null')))
-    ) {
-      wrappedType += ' | null';
-    }
-    const optionalType = optional !== '?' && prop.optional ? ` & ${this.referenceCoreImport('Opt')}` : '';
-    ret +=
-      !this.options.forceUndefined && prop.nullable && (hiddenType || optionalType) ? `(${wrappedType})` : wrappedType;
-    ret += hiddenType;
-    ret += optionalType;
-    if (!useDefault) {
-      return `${padding}${ret};\n`;
-    }
-    if (prop.enum && typeof prop.default === 'string') {
-      if (enumMode === 'union-type') {
-        return `${padding}${ret} = ${this.quote(prop.default)};\n`;
-      }
-      const enumClassName = prop.nativeEnumName
-        ? this.namingStrategy.getEnumClassName(prop.nativeEnumName, undefined, this.meta.schema)
-        : this.namingStrategy.getEnumClassName(prop.fieldNames[0], this.meta.collection, this.meta.schema);
-      const enumVal = this.namingStrategy.enumValueToEnumProperty(
-        prop.default,
-        prop.fieldNames[0],
-        this.meta.collection,
-        this.meta.schema,
-      );
-      return `${padding}${ret} = ${enumClassName}${identifierRegex.test(enumVal) ? `.${enumVal}` : `[${this.quote(enumVal)}]`};\n`;
-    }
-    if (prop.fieldNames?.length > 1) {
-      // TODO: Composite FKs with default values require additions to default/defaultRaw that are not yet supported.
-      return `${padding}${ret};\n`;
-    }
-    const defaultVal = typeof prop.default === 'string' ? this.quote(prop.default) : prop.default;
-    if (isScalar) {
-      return `${padding}${ret} = ${prop.ref ? `${this.referenceCoreImport('ref')}(${defaultVal})` : defaultVal};\n`;
-    }
-    if (hasUsableNullDefault) {
-      return `${padding}${ret} = null;\n`;
-    }
-    return `${padding}${ret} = ${prop.ref ? this.referenceCoreImport('ref') : this.referenceCoreImport('rel')}(${propType}, ${defaultVal});\n`;
-  }
-  getEnumClassDefinition(prop, padLeft) {
-    const enumMode = this.options.enumMode;
-    if (prop.nativeEnumName) {
-      const imports = [];
-      if (enumMode !== 'union-type') {
-        imports.push(prop.runtimeType);
-      }
-      if (!this.options.inferEntityType && enumMode !== 'ts-enum') {
-        const enumTypeName = this.namingStrategy.getEnumTypeName(prop.nativeEnumName, undefined, this.meta.schema);
-        imports.push(enumTypeName);
-      }
-      this.enumImports.set(prop.runtimeType, imports);
-      return '';
-    }
-    const enumClassName = this.namingStrategy.getEnumClassName(
-      prop.fieldNames[0],
-      this.meta.collection,
-      this.meta.schema,
-    );
-    const enumTypeName = this.namingStrategy.getEnumTypeName(
-      prop.fieldNames[0],
-      this.meta.collection,
-      this.meta.schema,
-    );
-    const padding = ' '.repeat(padLeft);
-    const enumValues = prop.items;
-    if (enumMode === 'union-type') {
-      return `export type ${enumTypeName} = ${enumValues.map(item => this.quote(item)).join(' | ')};\n`;
-    }
-    let ret = '';
-    if (enumMode === 'dictionary') {
-      ret += `export const ${enumClassName} = {\n`;
-    } else {
-      ret += `export enum ${enumClassName} {\n`;
-    }
-    for (const enumValue of enumValues) {
-      const enumName = this.namingStrategy.enumValueToEnumProperty(
-        enumValue,
-        prop.fieldNames[0],
-        this.meta.collection,
-        this.meta.schema,
-      );
-      if (enumMode === 'dictionary') {
-        ret += `${padding}${identifierRegex.test(enumName) ? enumName : this.quote(enumName)}: ${this.quote(enumValue)},\n`;
-      } else {
-        ret += `${padding}${identifierRegex.test(enumName) ? enumName : this.quote(enumName)} = ${this.quote(enumValue)},\n`;
-      }
-    }
-    if (enumMode === 'dictionary') {
-      ret += '} as const;\n';
-    } else {
-      ret += '}\n';
-    }
-    if (enumMode === 'dictionary') {
-      ret += `\nexport type ${enumTypeName} = (typeof ${enumClassName})[keyof typeof ${enumClassName}];\n`;
-    }
-    return ret;
-  }
-  serializeObject(options, wordwrap, spaces, level = 0) {
-    if (typeof wordwrap === 'number' && !Object.hasOwn(options, Config)) {
-      const res = this.serializeObject(options, undefined, undefined, level);
-      if (res.length <= wordwrap) {
-        return res;
-      }
-    }
-    const nextWordwrap = typeof wordwrap === 'number' ? 80 - (spaces ?? 0) - level * 2 : undefined;
-    const sep = typeof spaces === 'undefined' ? ', ' : `,\n${' '.repeat(spaces)}`;
-    const doIndent = typeof spaces !== 'undefined';
-    if (Array.isArray(options)) {
-      return `[${doIndent ? `\n${' '.repeat(spaces)}` : ''}${options.map(val => `${doIndent ? ' '.repeat(level * 2 + (spaces + 2)) : ''}${this.serializeValue(val, typeof nextWordwrap === 'number' ? nextWordwrap : undefined, doIndent ? spaces : undefined, level + 1)}`).join(sep)}${doIndent ? `${options.length > 0 ? ',\n' : ''}${' '.repeat(spaces + level * 2)}` : ''}]`;
-    }
-    const entries = Object.entries(options);
-    return `{${doIndent ? `\n${' '.repeat(spaces)}` : ' '}${entries
-      .map(([opt, val]) => {
-        const key = identifierRegex.test(opt) ? opt : this.quote(opt);
-        return `${doIndent ? ' '.repeat(level * 2 + (spaces + 2)) : ''}${key}: ${this.serializeValue(val, typeof nextWordwrap === 'number' ? nextWordwrap - key.length - 2 /* ': '.length*/ : undefined, doIndent ? spaces : undefined, level + 1)}`;
-      })
-      .join(sep)}${doIndent ? `${entries.length > 0 ? ',\n' : ''}${' '.repeat(spaces + level * 2)}` : ' '}}`;
-  }
-  serializeValue(val, wordwrap, spaces, level = 1) {
-    if (typeof val === 'object' && val !== null) {
-      return this.serializeObject(val, wordwrap, spaces, level);
-    }
-    return val;
-  }
-  getEntityDeclOptions() {
-    const options = {};
-    if (this.meta.tableName !== this.namingStrategy.classToTableName(this.meta.className)) {
-      options.tableName = this.quote(this.meta.tableName);
-    }
-    if (this.meta.schema && this.meta.schema !== this.platform.getDefaultSchemaName()) {
-      options.schema = this.quote(this.meta.schema);
-    }
-    if (typeof this.meta.expression === 'string') {
-      options.expression = this.quote(this.meta.expression);
-    } else if (typeof this.meta.expression === 'function') {
-      options.expression = this.meta.expression.toString();
-    }
-    if (this.meta.repositoryClass) {
-      this.entityImports.add(this.meta.repositoryClass);
-      options.repository = `() => ${this.meta.repositoryClass}`;
-    }
-    if (this.meta.comment) {
-      options.comment = this.quote(this.meta.comment);
-    }
-    if (this.meta.readonly && !this.meta.virtual) {
-      options.readonly = this.meta.readonly;
-    }
-    if (this.meta.virtual) {
-      options.virtual = this.meta.virtual;
-    }
-    return this.getCollectionDecl(options);
-  }
-  getEmbeddableDeclOptions() {
-    const options = {};
-    const result = this.getCollectionDecl(options);
-    if (result.discriminatorColumn) {
-      result.discriminator = result.discriminatorColumn;
-      delete result.discriminatorColumn;
-    }
-    return result;
-  }
-  getCollectionDecl(options) {
-    if (this.meta.abstract) {
-      options.abstract = true;
-    }
-    if (this.meta.discriminatorValue) {
-      options.discriminatorValue =
-        typeof this.meta.discriminatorValue === 'string'
-          ? this.quote(this.meta.discriminatorValue)
-          : this.meta.discriminatorValue;
-    }
-    if (this.meta.discriminatorColumn) {
-      options.discriminatorColumn = this.quote(this.meta.discriminatorColumn);
-    }
-    if (this.meta.discriminatorMap) {
-      options.discriminatorMap = Object.fromEntries(
-        Object.entries(this.meta.discriminatorMap).map(([discriminatorValue, cls]) => [
-          discriminatorValue,
-          this.quote(Utils.className(cls)),
-        ]),
-      );
-    }
-    return options;
-  }
-  getPropertyDecorator(prop, padLeft) {
-    const padding = ' '.repeat(padLeft);
-    const options = {};
-    let decorator = `@${this.referenceDecoratorImport(this.getDecoratorType(prop))}`;
-    if (prop.kind === ReferenceKind.MANY_TO_MANY) {
-      this.getManyToManyDecoratorOptions(options, prop);
-    } else if (prop.kind === ReferenceKind.ONE_TO_MANY) {
-      this.getOneToManyDecoratorOptions(options, prop);
-    } else if (prop.kind === ReferenceKind.SCALAR || typeof prop.kind === 'undefined') {
-      this.getScalarPropertyDecoratorOptions(options, prop);
-    } else if (prop.kind === ReferenceKind.EMBEDDED) {
-      this.getEmbeddedPropertyDeclarationOptions(options, prop);
-    } else {
-      this.getForeignKeyDecoratorOptions(options, prop);
-    }
-    this.getCommonDecoratorOptions(options, prop);
-    const indexes = this.getPropertyIndexes(prop, options);
-    decorator = [...indexes.sort(), decorator].map(d => padding + d).join('\n');
-    const decoratorArgs = [];
-    if (prop.formula) {
-      decoratorArgs.push(prop.formula.toString());
-    }
-    if (Utils.hasObjectKeys(options)) {
-      decoratorArgs.push(this.serializeObject(options));
-    }
-    return `${decorator}(${decoratorArgs.join(', ')})\n`;
-  }
-  getPropertyIndexes(prop, options) {
-    const processIndex = type => {
-      const propType = prop[type];
-      if (!propType) {
-        return;
-      }
-      const defaultName = this.platform.getIndexName(this.meta.collection, prop.fieldNames, type);
-      options[type] = propType === true || defaultName === propType ? 'true' : this.quote(propType);
-      const expected = {
-        index: this.platform.indexForeignKeys(),
-        unique: prop.kind === ReferenceKind.ONE_TO_ONE,
-      };
-      if (expected[type] && options[type] === 'true') {
-        delete options[type];
-      }
-    };
-    processIndex('index');
-    processIndex('unique');
-    const ret = [];
-    let propIndexIsNonTrivialIndex = false;
-    const nonTrivialIndexes = this.meta.indexes.filter(
-      i => i.properties?.length === 1 && i.properties[0] === prop.name,
-    );
-    for (const i of nonTrivialIndexes) {
-      ret.push(`@${this.referenceDecoratorImport('Index')}(${this.serializeObject(this.getIndexOptions(i, false))})`);
-      if (prop.index === i.name) {
-        propIndexIsNonTrivialIndex = true;
-        delete options.index;
-      }
-    }
-    if (prop.index && !options.index && !propIndexIsNonTrivialIndex) {
-      ret.push(
-        `@${this.referenceDecoratorImport('Index')}(${typeof prop.index === 'string' ? `{ name: ${this.quote(prop.index)} }` : ''})`,
-      );
-    }
-    let propIndexIsNonTrivialUnique = false;
-    const nonTrivialUnique = this.meta.uniques.filter(i => i.properties?.length === 1 && i.properties[0] === prop.name);
-    for (const i of nonTrivialUnique) {
-      ret.push(`@${this.referenceDecoratorImport('Unique')}(${this.serializeObject(this.getUniqueOptions(i, false))})`);
-      if (prop.unique === i.name) {
-        propIndexIsNonTrivialUnique = true;
-        delete options.unique;
-      }
-    }
-    if (prop.unique && !options.unique && !propIndexIsNonTrivialUnique) {
-      ret.push(
-        `@${this.referenceDecoratorImport('Unique')}(${typeof prop.unique === 'string' ? `{ name: ${this.quote(prop.unique)} }` : ''})`,
-      );
-    }
-    return ret;
-  }
-  getCommonDecoratorOptions(options, prop) {
-    if (!prop.mappedBy && (prop.nullable || prop.customTypes?.[0]?.prop?.nullable)) {
-      options.nullable = true;
-    }
-    if (prop.primary && (prop.enum || !(typeof prop.kind === 'undefined' || prop.kind === ReferenceKind.SCALAR))) {
-      options.primary = true;
-    }
-    ['persist', 'hydrate'].filter(key => prop[key] === false).forEach(key => (options[key] = false));
-    ['onCreate', 'onUpdate', 'serializer']
-      .filter(key => typeof prop[key] === 'function')
-      .forEach(key => (options[key] = `${prop[key]}`));
-    if (typeof prop.serializedName === 'string') {
-      options.serializedName = this.quote(prop.serializedName);
-    }
-    if (Array.isArray(prop.groups)) {
-      options.groups = prop.groups.map(group => this.quote(group));
+                const def = this.getEnumClassDefinition(prop, 2);
+                if (def.length) {
+                    enumDefinitions.push(def);
+                }
+            }
+            if (prop.eager) {
+                eagerProperties.push(prop);
+            }
+            if (prop.primary && (!['id', '_id', 'uuid'].includes(prop.name) || this.meta.compositePK)) {
+                primaryProps.push(prop);
+            }
+        });
+        if (primaryProps.length > 0) {
+            const primaryPropNames = primaryProps.map(prop => `'${prop.name}'`);
+            if (primaryProps.length > 1) {
+                classHead += `\n${' '.repeat(2)}[${this.referenceCoreImport('PrimaryKeyProp')}]?: [${primaryPropNames.join(', ')}];\n`;
+            }
+            else {
+                classHead += `\n${' '.repeat(2)}[${this.referenceCoreImport('PrimaryKeyProp')}]?: ${primaryPropNames[0]};\n`;
+            }
+        }
+        if (eagerProperties.length > 0) {
+            const eagerPropertyNames = eagerProperties.map(prop => `'${prop.name}'`).sort();
+            classHead += `\n${' '.repeat(2)}[${this.referenceCoreImport('EagerProps')}]?: ${eagerPropertyNames.join(' | ')};\n`;
+        }
+        ret += this.getEntityClass(classBody ? `${classHead}\n${classBody}` : classHead);
+        ret = `${this.generateImports()}\n\n${enumDefinitions.length ? enumDefinitions.join('\n') + '\n' : ''}${ret}`;
+        return ret;
+    }
+    /**
+     * Convert index column options to quoted output format.
+     */
+    getColumnOptions(columns) {
+        if (!columns?.length) {
+            return undefined;
+        }
+        return columns.map(col => {
+            const colOpt = { name: this.quote(col.name) };
+            if (col.sort) {
+                colOpt.sort = this.quote(col.sort.toUpperCase());
+            }
+            if (col.nulls) {
+                colOpt.nulls = this.quote(col.nulls.toUpperCase());
+            }
+            if (col.length != null) {
+                colOpt.length = col.length;
+            }
+            if (col.collation) {
+                colOpt.collation = this.quote(col.collation);
+            }
+            return colOpt;
+        });
     }
-    ['hidden', 'version', 'concurrencyCheck', 'eager', 'lazy', 'orphanRemoval']
-      .filter(key => prop[key])
-      .forEach(key => (options[key] = true));
-    if (prop.cascade && (prop.cascade.length !== 1 || prop.cascade[0] !== Cascade.PERSIST)) {
-      options.cascade = `[${prop.cascade.map(value => `${this.referenceCoreImport('Cascade')}.${value.toUpperCase()}`).join(', ')}]`;
+    getIndexOptions(index, isAtEntityLevel = true) {
+        const indexOpt = {};
+        if (typeof index.name === 'string') {
+            indexOpt.name = this.quote(index.name);
+        }
+        if (typeof index.expression === 'string') {
+            indexOpt.expression = this.quote(index.expression);
+        }
+        else if (typeof index.expression === 'function') {
+            indexOpt.expression = `${index.expression}`.replace(')=>`', ') => `');
+        }
+        if (isAtEntityLevel && index.properties) {
+            indexOpt.properties = Utils.asArray(index.properties).map(prop => this.quote('' + prop));
+        }
+        // Index type (e.g., 'fulltext', 'spatial', 'btree', 'hash')
+        if (index.type) {
+            indexOpt.type = this.quote(index.type);
+        }
+        // Advanced index options
+        const columns = this.getColumnOptions(index.columns);
+        if (columns) {
+            indexOpt.columns = columns;
+        }
+        if (index.include) {
+            indexOpt.include = Utils.asArray(index.include).map(prop => this.quote('' + prop));
+        }
+        if (index.fillFactor != null) {
+            indexOpt.fillFactor = index.fillFactor;
+        }
+        if (index.invisible) {
+            indexOpt.invisible = true;
+        }
+        if (index.disabled) {
+            indexOpt.disabled = true;
+        }
+        if (index.clustered) {
+            indexOpt.clustered = true;
+        }
+        return indexOpt;
     }
-    if (typeof prop.comment === 'string') {
-      options.comment = this.quote(prop.comment);
+    getUniqueOptions(index, isAtEntityLevel = true) {
+        const uniqueOpt = {};
+        if (typeof index.name === 'string') {
+            uniqueOpt.name = this.quote(index.name);
+        }
+        if (typeof index.expression === 'string') {
+            uniqueOpt.expression = this.quote(index.expression);
+        }
+        else if (typeof index.expression === 'function') {
+            uniqueOpt.expression = `${index.expression}`.replace(')=>`', ') => `');
+        }
+        if (isAtEntityLevel && index.properties) {
+            uniqueOpt.properties = Utils.asArray(index.properties).map(prop => this.quote('' + prop));
+        }
+        if (index.deferMode) {
+            uniqueOpt.deferMode =
+                `${this.referenceCoreImport('DeferMode')}.INITIALLY_${index.deferMode.toUpperCase()}`;
+        }
+        const columns = this.getColumnOptions(index.columns);
+        if (columns) {
+            uniqueOpt.columns = columns;
+        }
+        if (index.include) {
+            uniqueOpt.include = Utils.asArray(index.include).map(prop => this.quote('' + prop));
+        }
+        if (index.fillFactor != null) {
+            uniqueOpt.fillFactor = index.fillFactor;
+        }
+        if (index.disabled) {
+            uniqueOpt.disabled = true;
+        }
+        return uniqueOpt;
+    }
+    generateImports() {
+        const imports = new Set();
+        if (this.coreImports.size > 0) {
+            imports.add(`import { ${[...this.coreImports]
+                .sort()
+                .map(t => {
+                let ret = POSSIBLE_TYPE_IMPORTS.includes(t) ? `type ${t}` : t;
+                if (this.options.coreImportsPrefix) {
+                    const resolvedIdentifier = `${this.options.coreImportsPrefix}${t}`;
+                    ret += ` as ${resolvedIdentifier}`;
+                }
+                return ret;
+            })
+                .join(', ')} } from '@mikro-orm/core';`);
+        }
+        if (this.decoratorImports.size > 0) {
+            const type = this.options.decorators;
+            imports.add(`import { ${[...this.decoratorImports]
+                .sort()
+                .map(t => {
+                let ret = t;
+                if (this.options.coreImportsPrefix) {
+                    const resolvedIdentifier = `${this.options.coreImportsPrefix}${t}`;
+                    ret += ` as ${resolvedIdentifier}`;
+                }
+                return ret;
+            })
+                .join(', ')} } from '@mikro-orm/decorators/${type}';`);
+        }
+        const extension = this.options.esmImport ? '.js' : '';
+        const { dir, base } = parse(`${this.options.path ?? '.'}/${this.getBaseName()}`);
+        const basePath = relative(dir, this.options.path ?? '.') || '.';
+        (this.options.extraImports?.(basePath, base) ?? []).forEach(v => this.entityImports.add(v));
+        const entityImports = [...this.entityImports].filter(e => e !== this.meta.className);
+        const importMap = new Map();
+        for (const entity of entityImports) {
+            const file = this.options.onImport?.(entity, basePath, extension, base) ?? {
+                path: `${basePath}/${this.options.fileName(entity)}${extension}`,
+                name: entity,
+            };
+            if (file.path === '') {
+                if (file.name === '') {
+                    continue;
+                }
+                importMap.set(file.path, `import ${this.quote(file.name)};`);
+                continue;
+            }
+            if (file.name === '') {
+                importMap.set(file.path, `import * as ${entity} from ${this.quote(file.path)};`);
+                continue;
+            }
+            if (file.name === 'default') {
+                importMap.set(file.path, `import ${entity} from ${this.quote(file.path)};`);
+                continue;
+            }
+            if (file.name === entity) {
+                importMap.set(file.path, `import { ${entity} } from ${this.quote(file.path)};`);
+                continue;
+            }
+            importMap.set(file.path, `import { ${identifierRegex.test(file.name) ? file.name : this.quote(file.name)} as ${entity} } from ${this.quote(file.path)};`);
+        }
+        if (this.enumImports.size) {
+            for (const [name, exports] of this.enumImports.entries()) {
+                const file = this.options.onImport?.(name, basePath, extension, base) ?? {
+                    path: `${basePath}/${this.options.fileName(name)}${extension}`,
+                    name,
+                };
+                importMap.set(file.path, `import { ${exports.join(', ')} } from ${this.quote(file.path)};`);
+            }
+        }
+        for (const key of [...importMap.keys()].sort()) {
+            imports.add(importMap.get(key));
+        }
+        return Array.from(imports.values()).join('\n');
     }
-    // TODO: Composite FKs with default values require additions to default/defaultRaw that are not yet supported.
-    if (prop.fieldNames?.length <= 1) {
-      if (
-        typeof prop.defaultRaw !== 'undefined' &&
-        prop.defaultRaw !== 'null' &&
-        prop.defaultRaw !== '' &&
-        prop.defaultRaw !== (typeof prop.default === 'string' ? this.quote(prop.default) : `${prop.default}`)
-      ) {
-        options.defaultRaw = `\`${prop.defaultRaw}\``;
-      } else if (
-        !(typeof prop.default === 'undefined' || prop.default === null) &&
-        (prop.ref ||
-          (!prop.enum &&
-            (typeof prop.kind === 'undefined' || prop.kind === ReferenceKind.SCALAR) &&
-            (prop.type === 'unknown' || typeof this.breakdownOfIType(prop) !== 'undefined')))
-      ) {
-        options.default = typeof prop.default === 'string' ? this.quote(prop.default) : prop.default;
-      }
+    getEntityClass(classBody) {
+        let ret = `export `;
+        if (this.meta.abstract) {
+            ret += `abstract `;
+        }
+        ret += `class ${this.meta.className}`;
+        if (this.meta.extends) {
+            this.entityImports.add(Utils.className(this.meta.extends));
+            ret += ` extends ${Utils.className(this.meta.extends)}`;
+        }
+        else if (this.options.useCoreBaseEntity) {
+            ret += ` extends ${this.referenceCoreImport('BaseEntity')}`;
+        }
+        ret += ` {\n${classBody}}\n`;
+        return ret;
+    }
+    getBaseName(extension = '.ts') {
+        return `${this.options.fileName(this.meta.className)}${extension}`;
+    }
+    quote(val) {
+        const backtick = val.startsWith(`'`) || val.includes('\n');
+        /* v8 ignore next */
+        return backtick ? `\`${val.replaceAll('`', '\\``')}\`` : `'${val.replaceAll(`'`, `\\'`)}'`;
+    }
+    getPropertyDefinition(prop, padLeft) {
+        const padding = ' '.repeat(padLeft);
+        const propName = identifierRegex.test(prop.name) ? prop.name : this.quote(prop.name);
+        const enumMode = this.options.enumMode;
+        let hiddenType = '';
+        if (prop.hidden) {
+            hiddenType += ` & ${this.referenceCoreImport('Hidden')}`;
+        }
+        if ([ReferenceKind.ONE_TO_MANY, ReferenceKind.MANY_TO_MANY].includes(prop.kind)) {
+            return `${padding}${propName}${hiddenType ? `: ${this.referenceCoreImport('Collection')}<${prop.type}>${hiddenType}` : ''} = new ${this.referenceCoreImport('Collection')}<${prop.type}>(this);\n`;
+        }
+        const isScalar = typeof prop.kind === 'undefined' || prop.kind === ReferenceKind.SCALAR;
+        let breakdownOfIType;
+        const propType = prop.mapToPk
+            ? (() => {
+                const runtimeTypes = prop.columnTypes.map((t, i) => (prop.customTypes?.[i] ?? this.platform.getMappedType(t)).runtimeType);
+                return runtimeTypes.length === 1 ? runtimeTypes[0] : this.serializeObject(runtimeTypes);
+            })()
+            : (() => {
+                if (isScalar) {
+                    if (prop.enum) {
+                        const method = enumMode === 'ts-enum' ? 'getEnumClassName' : 'getEnumTypeName';
+                        if (prop.nativeEnumName) {
+                            return this.namingStrategy[method](prop.nativeEnumName, undefined, this.meta.schema);
+                        }
+                        return this.namingStrategy[method](prop.fieldNames[0], this.meta.collection, this.meta.schema);
+                    }
+                    breakdownOfIType = this.breakdownOfIType(prop);
+                    if (typeof breakdownOfIType !== 'undefined') {
+                        if (breakdownOfIType.length >= 3) {
+                            hiddenType = '';
+                        }
+                        return `${this.referenceCoreImport('IType')}<${breakdownOfIType.join(', ')}>`;
+                    }
+                    return prop.runtimeType;
+                }
+                return prop.type;
+            })();
+        const hasUsableNullDefault = prop.nullable && !this.options.forceUndefined && prop.default === null;
+        const useDefault = hasUsableNullDefault ||
+            (!(typeof prop.default === 'undefined' || prop.default === null) &&
+                propType !== 'unknown' &&
+                typeof breakdownOfIType === 'undefined');
+        const optional = prop.nullable && (this.options.forceUndefined || prop.optional) ? '?' : useDefault ? '' : '!';
+        let ret = `${propName}${optional}: `;
+        const isArray = prop.array && (prop.kind === ReferenceKind.EMBEDDED || prop.enum);
+        const complexType = isArray ? `${propType}[]` : propType;
+        let wrappedType = prop.ref
+            ? `${this.referenceCoreImport('Ref')}<${complexType}${isScalar && prop.nullable && !this.options.forceUndefined ? ' | null' : ''}>`
+            : this.options.esmImport && !isScalar
+                ? `${this.referenceCoreImport('Rel')}<${complexType}>`
+                : complexType;
+        if (prop.nullable &&
+            !this.options.forceUndefined &&
+            (!isScalar || (!prop.ref && !wrappedType.includes(' | null')))) {
+            wrappedType += ' | null';
+        }
+        const optionalType = optional !== '?' && prop.optional ? ` & ${this.referenceCoreImport('Opt')}` : '';
+        ret +=
+            !this.options.forceUndefined && prop.nullable && (hiddenType || optionalType) ? `(${wrappedType})` : wrappedType;
+        ret += hiddenType;
+        ret += optionalType;
+        if (!useDefault) {
+            return `${padding}${ret};\n`;
+        }
+        if (prop.enum && typeof prop.default === 'string') {
+            if (enumMode === 'union-type') {
+                return `${padding}${ret} = ${this.quote(prop.default)};\n`;
+            }
+            const enumClassName = prop.nativeEnumName
+                ? this.namingStrategy.getEnumClassName(prop.nativeEnumName, undefined, this.meta.schema)
+                : this.namingStrategy.getEnumClassName(prop.fieldNames[0], this.meta.collection, this.meta.schema);
+            const enumVal = this.namingStrategy.enumValueToEnumProperty(prop.default, prop.fieldNames[0], this.meta.collection, this.meta.schema);
+            return `${padding}${ret} = ${enumClassName}${identifierRegex.test(enumVal) ? `.${enumVal}` : `[${this.quote(enumVal)}]`};\n`;
+        }
+        if (prop.fieldNames?.length > 1) {
+            // TODO: Composite FKs with default values require additions to default/defaultRaw that are not yet supported.
+            return `${padding}${ret};\n`;
+        }
+        const defaultVal = typeof prop.default === 'string' ? this.quote(prop.default) : prop.default;
+        if (isScalar) {
+            return `${padding}${ret} = ${prop.ref ? `${this.referenceCoreImport('ref')}(${defaultVal})` : defaultVal};\n`;
+        }
+        if (hasUsableNullDefault) {
+            return `${padding}${ret} = null;\n`;
+        }
+        return `${padding}${ret} = ${prop.ref ? this.referenceCoreImport('ref') : this.referenceCoreImport('rel')}(${propType}, ${defaultVal});\n`;
+    }
+    getEnumClassDefinition(prop, padLeft) {
+        const enumMode = this.options.enumMode;
+        if (prop.nativeEnumName) {
+            const imports = [];
+            if (enumMode !== 'union-type') {
+                imports.push(prop.runtimeType);
+            }
+            if (!this.options.inferEntityType && enumMode !== 'ts-enum') {
+                const enumTypeName = this.namingStrategy.getEnumTypeName(prop.nativeEnumName, undefined, this.meta.schema);
+                imports.push(enumTypeName);
+            }
+            this.enumImports.set(prop.runtimeType, imports);
+            return '';
+        }
+        const enumClassName = this.namingStrategy.getEnumClassName(prop.fieldNames[0], this.meta.collection, this.meta.schema);
+        const enumTypeName = this.namingStrategy.getEnumTypeName(prop.fieldNames[0], this.meta.collection, this.meta.schema);
+        const padding = ' '.repeat(padLeft);
+        const enumValues = prop.items;
+        if (enumMode === 'union-type') {
+            return `export type ${enumTypeName} = ${enumValues.map(item => this.quote(item)).join(' | ')};\n`;
+        }
+        let ret = '';
+        if (enumMode === 'dictionary') {
+            ret += `export const ${enumClassName} = {\n`;
+        }
+        else {
+            ret += `export enum ${enumClassName} {\n`;
+        }
+        for (const enumValue of enumValues) {
+            const enumName = this.namingStrategy.enumValueToEnumProperty(enumValue, prop.fieldNames[0], this.meta.collection, this.meta.schema);
+            if (enumMode === 'dictionary') {
+                ret += `${padding}${identifierRegex.test(enumName) ? enumName : this.quote(enumName)}: ${this.quote(enumValue)},\n`;
+            }
+            else {
+                ret += `${padding}${identifierRegex.test(enumName) ? enumName : this.quote(enumName)} = ${this.quote(enumValue)},\n`;
+            }
+        }
+        if (enumMode === 'dictionary') {
+            ret += '} as const;\n';
+        }
+        else {
+            ret += '}\n';
+        }
+        if (enumMode === 'dictionary') {
+            ret += `\nexport type ${enumTypeName} = (typeof ${enumClassName})[keyof typeof ${enumClassName}];\n`;
+        }
+        return ret;
     }
-    if (typeof prop.extra === 'string') {
-      options.extra = this.quote(prop.extra);
+    serializeObject(options, wordwrap, spaces, level = 0) {
+        if (typeof wordwrap === 'number' && !Object.hasOwn(options, Config)) {
+            const res = this.serializeObject(options, undefined, undefined, level);
+            if (res.length <= wordwrap) {
+                return res;
+            }
+        }
+        const nextWordwrap = typeof wordwrap === 'number' ? 80 - (spaces ?? 0) - level * 2 : undefined;
+        const sep = typeof spaces === 'undefined' ? ', ' : `,\n${' '.repeat(spaces)}`;
+        const doIndent = typeof spaces !== 'undefined';
+        if (Array.isArray(options)) {
+            return `[${doIndent ? `\n${' '.repeat(spaces)}` : ''}${options.map(val => `${doIndent ? ' '.repeat(level * 2 + (spaces + 2)) : ''}${this.serializeValue(val, typeof nextWordwrap === 'number' ? nextWordwrap : undefined, doIndent ? spaces : undefined, level + 1)}`).join(sep)}${doIndent ? `${options.length > 0 ? ',\n' : ''}${' '.repeat(spaces + level * 2)}` : ''}]`;
+        }
+        const entries = Object.entries(options);
+        return `{${doIndent ? `\n${' '.repeat(spaces)}` : ' '}${entries
+            .map(([opt, val]) => {
+            const key = identifierRegex.test(opt) ? opt : this.quote(opt);
+            return `${doIndent ? ' '.repeat(level * 2 + (spaces + 2)) : ''}${key}: ${this.serializeValue(val, typeof nextWordwrap === 'number' ? nextWordwrap - key.length - 2 /* ': '.length*/ : undefined, doIndent ? spaces : undefined, level + 1)}`;
+        })
+            .join(sep)}${doIndent ? `${entries.length > 0 ? ',\n' : ''}${' '.repeat(spaces + level * 2)}` : ' '}}`;
+    }
+    serializeValue(val, wordwrap, spaces, level = 1) {
+        if (typeof val === 'object' && val !== null) {
+            return this.serializeObject(val, wordwrap, spaces, level);
+        }
+        return val;
     }
-    if (prop.deferMode) {
-      options.deferMode = `${this.referenceCoreImport('DeferMode')}.INITIALLY_${prop.deferMode.toUpperCase()}`;
+    getEntityDeclOptions() {
+        const options = {};
+        if (this.meta.tableName !== this.namingStrategy.classToTableName(this.meta.className)) {
+            options.tableName = this.quote(this.meta.tableName);
+        }
+        if (this.meta.schema && this.meta.schema !== this.platform.getDefaultSchemaName()) {
+            options.schema = this.quote(this.meta.schema);
+        }
+        if (typeof this.meta.expression === 'string') {
+            options.expression = this.quote(this.meta.expression);
+        }
+        else if (typeof this.meta.expression === 'function') {
+            options.expression = this.meta.expression.toString();
+        }
+        if (this.meta.repositoryClass) {
+            this.entityImports.add(this.meta.repositoryClass);
+            options.repository = `() => ${this.meta.repositoryClass}`;
+        }
+        if (this.meta.comment) {
+            options.comment = this.quote(this.meta.comment);
+        }
+        if (this.meta.readonly && !this.meta.virtual) {
+            options.readonly = this.meta.readonly;
+        }
+        if (this.meta.virtual) {
+            options.virtual = this.meta.virtual;
+        }
+        return this.getCollectionDecl(options);
+    }
+    getEmbeddableDeclOptions() {
+        const options = {};
+        const result = this.getCollectionDecl(options);
+        if (result.discriminatorColumn) {
+            result.discriminator = result.discriminatorColumn;
+            delete result.discriminatorColumn;
+        }
+        return result;
     }
-    if (typeof prop.ignoreSchemaChanges !== 'undefined') {
-      options.ignoreSchemaChanges ??= [];
-      options.ignoreSchemaChanges.push(...prop.ignoreSchemaChanges.map(v => this.quote(v)));
+    getCollectionDecl(options) {
+        if (this.meta.abstract) {
+            options.abstract = true;
+        }
+        if (this.meta.discriminatorValue) {
+            options.discriminatorValue =
+                typeof this.meta.discriminatorValue === 'string'
+                    ? this.quote(this.meta.discriminatorValue)
+                    : this.meta.discriminatorValue;
+        }
+        if (this.meta.discriminatorColumn) {
+            options.discriminatorColumn = this.quote(this.meta.discriminatorColumn);
+        }
+        if (this.meta.discriminatorMap) {
+            options.discriminatorMap = Object.fromEntries(Object.entries(this.meta.discriminatorMap).map(([discriminatorValue, cls]) => [
+                discriminatorValue,
+                this.quote(Utils.className(cls)),
+            ]));
+        }
+        return options;
+    }
+    getPropertyDecorator(prop, padLeft) {
+        const padding = ' '.repeat(padLeft);
+        const options = {};
+        let decorator = `@${this.referenceDecoratorImport(this.getDecoratorType(prop))}`;
+        if (prop.kind === ReferenceKind.MANY_TO_MANY) {
+            this.getManyToManyDecoratorOptions(options, prop);
+        }
+        else if (prop.kind === ReferenceKind.ONE_TO_MANY) {
+            this.getOneToManyDecoratorOptions(options, prop);
+        }
+        else if (prop.kind === ReferenceKind.SCALAR || typeof prop.kind === 'undefined') {
+            this.getScalarPropertyDecoratorOptions(options, prop);
+        }
+        else if (prop.kind === ReferenceKind.EMBEDDED) {
+            this.getEmbeddedPropertyDeclarationOptions(options, prop);
+        }
+        else {
+            this.getForeignKeyDecoratorOptions(options, prop);
+        }
+        this.getCommonDecoratorOptions(options, prop);
+        const indexes = this.getPropertyIndexes(prop, options);
+        decorator = [...indexes.sort(), decorator].map(d => padding + d).join('\n');
+        const decoratorArgs = [];
+        if (prop.formula) {
+            decoratorArgs.push(prop.formula.toString());
+        }
+        if (Utils.hasObjectKeys(options)) {
+            decoratorArgs.push(this.serializeObject(options));
+        }
+        return `${decorator}(${decoratorArgs.join(', ')})\n`;
     }
-  }
-  #propTypeBreakdowns = new WeakMap();
-  breakdownOfIType(prop) {
-    if (this.#propTypeBreakdowns.has(prop)) {
-      return this.#propTypeBreakdowns.get(prop);
+    getPropertyIndexes(prop, options) {
+        const processIndex = (type) => {
+            const propType = prop[type];
+            if (!propType) {
+                return;
+            }
+            const defaultName = this.platform.getIndexName(this.meta.collection, prop.fieldNames, type);
+            options[type] = propType === true || defaultName === propType ? 'true' : this.quote(propType);
+            const expected = {
+                index: this.platform.indexForeignKeys(),
+                unique: prop.kind === ReferenceKind.ONE_TO_ONE,
+            };
+            if (expected[type] && options[type] === 'true') {
+                delete options[type];
+            }
+        };
+        processIndex('index');
+        processIndex('unique');
+        const ret = [];
+        let propIndexIsNonTrivialIndex = false;
+        const nonTrivialIndexes = this.meta.indexes.filter(i => i.properties?.length === 1 && i.properties[0] === prop.name);
+        for (const i of nonTrivialIndexes) {
+            ret.push(`@${this.referenceDecoratorImport('Index')}(${this.serializeObject(this.getIndexOptions(i, false))})`);
+            if (prop.index === i.name) {
+                propIndexIsNonTrivialIndex = true;
+                delete options.index;
+            }
+        }
+        if (prop.index && !options.index && !propIndexIsNonTrivialIndex) {
+            ret.push(`@${this.referenceDecoratorImport('Index')}(${typeof prop.index === 'string' ? `{ name: ${this.quote(prop.index)} }` : ''})`);
+        }
+        let propIndexIsNonTrivialUnique = false;
+        const nonTrivialUnique = this.meta.uniques.filter(i => i.properties?.length === 1 && i.properties[0] === prop.name);
+        for (const i of nonTrivialUnique) {
+            ret.push(`@${this.referenceDecoratorImport('Unique')}(${this.serializeObject(this.getUniqueOptions(i, false))})`);
+            if (prop.unique === i.name) {
+                propIndexIsNonTrivialUnique = true;
+                delete options.unique;
+            }
+        }
+        if (prop.unique && !options.unique && !propIndexIsNonTrivialUnique) {
+            ret.push(`@${this.referenceDecoratorImport('Unique')}(${typeof prop.unique === 'string' ? `{ name: ${this.quote(prop.unique)} }` : ''})`);
+        }
+        return ret;
     }
-    const mappedDeclaredType = this.platform.getMappedType(prop.type);
-    const mappedRawType =
-      prop.customTypes?.[0] ??
-      (prop.type !== 'unknown' && mappedDeclaredType instanceof UnknownType
-        ? this.platform.getMappedType(prop.columnTypes[0])
-        : mappedDeclaredType);
-    const rawType = mappedRawType.runtimeType;
-    const mappedSerializedType = prop.customType ?? mappedRawType;
-    const serializedType = mappedSerializedType.runtimeType;
-    // Add non-lib imports where needed.
-    for (const typeSpec of [prop.runtimeType, rawType, serializedType]) {
-      const simplePropType = typeSpec.replace(/\[]+$/, '');
-      if (!primitivesAndLibs.includes(simplePropType)) {
-        this.entityImports.add(simplePropType);
-      }
+    getCommonDecoratorOptions(options, prop) {
+        if (!prop.mappedBy && (prop.nullable || prop.customTypes?.[0]?.prop?.nullable)) {
+            options.nullable = true;
+        }
+        if (prop.primary && (prop.enum || !(typeof prop.kind === 'undefined' || prop.kind === ReferenceKind.SCALAR))) {
+            options.primary = true;
+        }
+        ['persist', 'hydrate'].filter(key => prop[key] === false).forEach(key => (options[key] = false));
+        ['onCreate', 'onUpdate', 'serializer']
+            .filter(key => typeof prop[key] === 'function')
+            .forEach(key => (options[key] = `${prop[key]}`));
+        if (typeof prop.serializedName === 'string') {
+            options.serializedName = this.quote(prop.serializedName);
+        }
+        if (Array.isArray(prop.groups)) {
+            options.groups = prop.groups.map(group => this.quote(group));
+        }
+        ['hidden', 'version', 'concurrencyCheck', 'eager', 'lazy', 'orphanRemoval']
+            .filter(key => prop[key])
+            .forEach(key => (options[key] = true));
+        if (prop.cascade && (prop.cascade.length !== 1 || prop.cascade[0] !== Cascade.PERSIST)) {
+            options.cascade = `[${prop.cascade.map(value => `${this.referenceCoreImport('Cascade')}.${value.toUpperCase()}`).join(', ')}]`;
+        }
+        if (typeof prop.comment === 'string') {
+            options.comment = this.quote(prop.comment);
+        }
+        // TODO: Composite FKs with default values require additions to default/defaultRaw that are not yet supported.
+        if (prop.fieldNames?.length <= 1) {
+            if (typeof prop.defaultRaw !== 'undefined' &&
+                prop.defaultRaw !== 'null' &&
+                prop.defaultRaw !== '' &&
+                prop.defaultRaw !== (typeof prop.default === 'string' ? this.quote(prop.default) : `${prop.default}`)) {
+                options.defaultRaw = `\`${prop.defaultRaw}\``;
+            }
+            else if (!(typeof prop.default === 'undefined' || prop.default === null) &&
+                (prop.ref ||
+                    (!prop.enum &&
+                        (typeof prop.kind === 'undefined' || prop.kind === ReferenceKind.SCALAR) &&
+                        (prop.type === 'unknown' || typeof this.breakdownOfIType(prop) !== 'undefined')))) {
+                options.default = typeof prop.default === 'string' ? this.quote(prop.default) : prop.default;
+            }
+        }
+        if (typeof prop.extra === 'string') {
+            options.extra = this.quote(prop.extra);
+        }
+        if (prop.deferMode) {
+            options.deferMode = `${this.referenceCoreImport('DeferMode')}.INITIALLY_${prop.deferMode.toUpperCase()}`;
+        }
+        if (typeof prop.ignoreSchemaChanges !== 'undefined') {
+            options.ignoreSchemaChanges ??= [];
+            options.ignoreSchemaChanges.push(...prop.ignoreSchemaChanges.map(v => this.quote(v)));
+        }
     }
-    const nullables = [
-      prop.nullable ?? false,
-      mappedRawType.prop?.nullable ?? prop.nullable ?? false,
-      mappedSerializedType.prop?.nullable ?? prop.nullable ?? false,
-    ];
-    const hasMixedNullability = new Set(nullables).size > 1;
-    if (prop.runtimeType !== rawType || rawType !== serializedType || hasMixedNullability) {
-      const nullType = this.options.forceUndefined ? ' | undefined' : ' | null';
-      if (
-        rawType !== serializedType ||
-        nullables[1] !== nullables[2] ||
-        (prop.hidden && nullables[0] !== nullables[1])
-      ) {
-        const r = [prop.runtimeType, rawType, serializedType];
-        if (hasMixedNullability || prop.hidden) {
-          for (let i = r.length - 1; i >= 0; --i) {
-            if (nullables[i]) {
-              r[i] += nullType;
-            }
-          }
-          if (prop.hidden) {
-            r[2] = `(${r[2]}) & ${this.referenceCoreImport('Hidden')}`;
-          }
+    #propTypeBreakdowns = new WeakMap();
+    breakdownOfIType(prop) {
+        if (this.#propTypeBreakdowns.has(prop)) {
+            return this.#propTypeBreakdowns.get(prop);
+        }
+        const mappedDeclaredType = this.platform.getMappedType(prop.type);
+        const mappedRawType = prop.customTypes?.[0] ??
+            (prop.type !== 'unknown' && mappedDeclaredType instanceof UnknownType
+                ? this.platform.getMappedType(prop.columnTypes[0])
+                : mappedDeclaredType);
+        const rawType = mappedRawType.runtimeType;
+        const mappedSerializedType = prop.customType ?? mappedRawType;
+        const serializedType = mappedSerializedType.runtimeType;
+        // Add non-lib imports where needed.
+        for (const typeSpec of [prop.runtimeType, rawType, serializedType]) {
+            const simplePropType = typeSpec.replace(/\[]+$/, '');
+            if (!primitivesAndLibs.includes(simplePropType)) {
+                this.entityImports.add(simplePropType);
+            }
+        }
+        const nullables = [
+            prop.nullable ?? false,
+            mappedRawType.prop?.nullable ?? prop.nullable ?? false,
+            mappedSerializedType.prop?.nullable ?? prop.nullable ?? false,
+        ];
+        const hasMixedNullability = new Set(nullables).size > 1;
+        if (prop.runtimeType !== rawType || rawType !== serializedType || hasMixedNullability) {
+            const nullType = this.options.forceUndefined ? ' | undefined' : ' | null';
+            if (rawType !== serializedType ||
+                nullables[1] !== nullables[2] ||
+                (prop.hidden && nullables[0] !== nullables[1])) {
+                const r = [prop.runtimeType, rawType, serializedType];
+                if (hasMixedNullability || prop.hidden) {
+                    for (let i = r.length - 1; i >= 0; --i) {
+                        if (nullables[i]) {
+                            r[i] += nullType;
+                        }
+                    }
+                    if (prop.hidden) {
+                        r[2] = `(${r[2]}) & ${this.referenceCoreImport('Hidden')}`;
+                    }
+                }
+                this.#propTypeBreakdowns.set(prop, r);
+                return r;
+            }
+            const r = [prop.runtimeType, rawType];
+            if (hasMixedNullability) {
+                for (let i = r.length - 1; i >= 0; --i) {
+                    if (nullables[i]) {
+                        r[i] += nullType;
+                    }
+                }
+            }
+            this.#propTypeBreakdowns.set(prop, r);
+            return r;
         }
+        const r = undefined;
         this.#propTypeBreakdowns.set(prop, r);
         return r;
-      }
-      const r = [prop.runtimeType, rawType];
-      if (hasMixedNullability) {
-        for (let i = r.length - 1; i >= 0; --i) {
-          if (nullables[i]) {
-            r[i] += nullType;
-          }
-        }
-      }
-      this.#propTypeBreakdowns.set(prop, r);
-      return r;
-    }
-    const r = undefined;
-    this.#propTypeBreakdowns.set(prop, r);
-    return r;
-  }
-  getScalarPropertyDecoratorOptions(options, prop, quote = true) {
-    if (prop.fieldNames[0] !== this.namingStrategy.propertyToColumnName(prop.name)) {
-      options.fieldName = this.quote(prop.fieldNames[0]);
-    }
-    if (prop.enum) {
-      if (this.options.enumMode === 'union-type') {
-        options.items = `[${prop.items.map(item => this.quote(item)).join(', ')}]`;
-      } else if (prop.nativeEnumName) {
-        const enumClassName = this.namingStrategy.getEnumClassName(prop.nativeEnumName, undefined, this.meta.schema);
-        options.items = `() => ${enumClassName}`;
-        options.nativeEnumName = this.quote(prop.nativeEnumName);
-      } else {
-        const enumClassName = this.namingStrategy.getEnumClassName(
-          prop.fieldNames[0],
-          this.meta.collection,
-          this.meta.schema,
-        );
-        options.items = `() => ${enumClassName}`;
-      }
-    }
-    // For enum properties, we don't need a column type
-    // or the property length or other information in the decorator.
-    if (prop.enum) {
-      return;
-    }
-    const mappedColumnType = this.platform.getMappedType(prop.columnTypes[0]);
-    // If the column's runtimeType matches the declared runtimeType, assume it's the same underlying type.
-    const mappedRuntimeType =
-      mappedColumnType.runtimeType === prop.runtimeType
-        ? mappedColumnType
-        : this.platform.getMappedType(prop.runtimeType);
-    const mappedDeclaredType = this.platform.getMappedType(prop.type);
-    const isTypeStringMissingFromMap = prop.type !== 'unknown' && mappedDeclaredType instanceof UnknownType;
-    if (isTypeStringMissingFromMap) {
-      this.entityImports.add(prop.type);
-      options.type = prop.type;
-    } else {
-      if (
-        this.options.scalarTypeInDecorator || // always output type if forced by the generator options
-        (prop.nullable && !this.options.forceUndefined) || // also when there is the "| null" type modifier (because reflect-metadata can't extract the base)
-        prop.hidden || // also when there is the "& Hidden" type modifier (because reflect-metadata can't extract the base)
-        new Set([
-          mappedRuntimeType.name,
-          mappedColumnType.name,
-          mappedDeclaredType.name,
-          this.platform.getMappedType(prop.runtimeType === 'Date' ? 'datetime' : prop.runtimeType).name,
-        ]).size > 1 || // also, if there's any ambiguity in the type
-        (() => {
-          const hasUsableNullDefault = prop.nullable && !this.options.forceUndefined && prop.default === null;
-          const useDefault = hasUsableNullDefault || !(typeof prop.default === 'undefined' || prop.default === null);
-          return (useDefault && !hasUsableNullDefault) || (prop.optional && !prop.nullable);
-        })() // also when there is the "| Opt" type modifier (because reflect-metadata can't extract the base)
-      ) {
-        options.type = quote ? this.quote(prop.type) : prop.type;
-      }
-    }
-    const columnTypeFromMappedRuntimeType = mappedRuntimeType.getColumnType(
-      { ...prop, autoincrement: false },
-      this.platform,
-    );
-    const columnTypeFromMappedColumnType = mappedColumnType.getColumnType(
-      { ...prop, autoincrement: false },
-      this.platform,
-    );
-    const columnTypeFromMappedDeclaredType = mappedDeclaredType.getColumnType(
-      { ...prop, autoincrement: false },
-      this.platform,
-    );
-    const needsExplicitColumnType = () => {
-      if (
-        isTypeStringMissingFromMap ||
-        [mappedRuntimeType, mappedColumnType, columnTypeFromMappedDeclaredType].some(t => t instanceof UnknownType)
-      ) {
-        return true;
-      }
-      if (
-        this.platform.normalizeColumnType(prop.columnTypes[0], prop) !==
-        this.platform.normalizeColumnType(columnTypeFromMappedColumnType, prop)
-      ) {
-        return prop.columnTypes[0] !== columnTypeFromMappedColumnType;
-      }
-      return (
-        columnTypeFromMappedRuntimeType !== columnTypeFromMappedColumnType ||
-        columnTypeFromMappedDeclaredType !== columnTypeFromMappedColumnType
-      );
-    };
-    if (needsExplicitColumnType()) {
-      options.columnType = this.quote(prop.columnTypes[0]);
-    }
-    const assign = key => {
-      if (prop[key] != null) {
-        options[key] = prop[key];
-      }
-    };
-    if (
-      !options.columnType &&
-      (typeof mappedColumnType.getDefaultLength === 'undefined' ||
-        mappedColumnType.getDefaultLength(this.platform) !== prop.length)
-    ) {
-      assign('length');
-    }
-    // those are already included in the `columnType` in most cases, and when that option is present, they would be ignored anyway
-    /* v8 ignore next */
-    if (mappedColumnType instanceof DecimalType && !options.columnType) {
-      assign('precision');
-      assign('scale');
-    }
-    if (
-      this.platform.supportsUnsigned() &&
-      ((!prop.primary && prop.unsigned) ||
-        (prop.primary && !prop.unsigned && this.platform.isNumericColumn(mappedColumnType)))
-    ) {
-      assign('unsigned');
-    }
-    if (prop.autoincrement) {
-      if (
-        !prop.primary ||
-        !this.platform.isNumericColumn(mappedColumnType) ||
-        this.meta.getPrimaryProps().length !== 1
-      ) {
-        options.autoincrement = true;
-      }
-    } else if (
-      prop.primary &&
-      this.platform.isNumericColumn(mappedColumnType) &&
-      this.meta.getPrimaryProps().length === 1
-    ) {
-      options.autoincrement = false;
-    }
-    if (prop.generated) {
-      options.generated = typeof prop.generated === 'string' ? this.quote(prop.generated) : `${prop.generated}`;
-    }
-  }
-  getManyToManyDecoratorOptions(options, prop) {
-    this.entityImports.add(prop.type);
-    options.entity = `() => ${prop.type}`;
-    if (prop.orderBy) {
-      options.orderBy = inspect(prop.orderBy);
-    }
-    if (prop.mappedBy) {
-      options.mappedBy = this.quote(prop.mappedBy);
-      return;
-    }
-    if (
-      prop.pivotTable !==
-      this.namingStrategy.joinTableName(this.meta.collection, prop.type, prop.name, this.meta.tableName)
-    ) {
-      options.pivotTable = this.quote(prop.pivotTable);
-    }
-    if (prop.pivotEntity && Utils.className(prop.pivotEntity) !== prop.pivotTable) {
-      this.entityImports.add(Utils.className(prop.pivotEntity));
-      options.pivotEntity = `() => ${Utils.className(prop.pivotEntity)}`;
-    }
-    if (prop.joinColumns.length === 1) {
-      options.joinColumn = this.quote(prop.joinColumns[0]);
-    } else {
-      options.joinColumns = `[${prop.joinColumns.map(c => this.quote(c)).join(', ')}]`;
-    }
-    if (prop.inverseJoinColumns.length === 1) {
-      options.inverseJoinColumn = this.quote(prop.inverseJoinColumns[0]);
-    } else {
-      options.inverseJoinColumns = `[${prop.inverseJoinColumns.map(c => this.quote(c)).join(', ')}]`;
-    }
-    if (prop.fixedOrder) {
-      options.fixedOrder = true;
-      if (prop.fixedOrderColumn && prop.fixedOrderColumn !== this.namingStrategy.referenceColumnName()) {
-        options.fixedOrderColumn = this.quote(prop.fixedOrderColumn);
-      }
     }
-  }
-  getOneToManyDecoratorOptions(options, prop) {
-    this.entityImports.add(prop.type);
-    options.entity = `() => ${prop.type}`;
-    options.mappedBy = this.quote(prop.mappedBy);
-    if (prop.orderBy) {
-      options.orderBy = inspect(prop.orderBy);
-    }
-  }
-  getEmbeddedPropertyDeclarationOptions(options, prop) {
-    this.entityImports.add(prop.type);
-    options.entity = `() => ${prop.type}`;
-    if (prop.array) {
-      options.array = true;
-    }
-    if (prop.object && !prop.array) {
-      options.object = true;
-    }
-    if (prop.prefix === false || typeof prop.prefix === 'string') {
-      options.prefix = prop.prefix === false ? false : this.quote(prop.prefix);
-    }
-  }
-  getForeignKeyDecoratorOptions(options, prop) {
-    this.entityImports.add(prop.type);
-    options.entity = `() => ${prop.type}`;
-    if (prop.ref) {
-      options.ref = true;
-    }
-    if (prop.mapToPk) {
-      options.mapToPk = true;
-    }
-    if (prop.mappedBy) {
-      options.mappedBy = this.quote(prop.mappedBy);
-      return;
-    }
-    if (prop.fieldNames.length === 1) {
-      if (prop.fieldNames[0] !== this.namingStrategy.joinKeyColumnName(prop.name, prop.referencedColumnNames[0])) {
-        options.fieldName = this.quote(prop.fieldNames[0]);
-      }
-    } else {
-      if (
-        prop.fieldNames.length > 1 &&
-        prop.fieldNames.some(
-          (fieldName, i) =>
-            fieldName !== this.namingStrategy.joinKeyColumnName(prop.name, prop.referencedColumnNames[i]),
-        )
-      ) {
-        options.fieldNames = prop.fieldNames.map(fieldName => this.quote(fieldName));
-      }
-    }
-    if (prop.ownColumns && prop.ownColumns.length !== prop.fieldNames.length) {
-      options.referencedColumnNames = prop.referencedColumnNames.map(fieldName => this.quote(fieldName));
-    }
-    if (prop.updateRule) {
-      options.updateRule = this.quote(prop.updateRule);
-    }
-    if (prop.deleteRule) {
-      options.deleteRule = this.quote(prop.deleteRule);
-    }
-    if (prop.primary) {
-      options.primary = true;
-    }
-    if (prop.generated) {
-      options.generated = typeof prop.generated === 'string' ? this.quote(prop.generated) : `${prop.generated}`;
-    }
-    if (prop.fieldNames.length > 1 && !(typeof prop.default === 'undefined' || prop.default === null)) {
-      // TODO: Composite FKs with default values require additions to default/defaultRaw that are not yet supported.
-      options.ignoreSchemaChanges = [this.quote('default')];
-    }
-  }
-  getDecoratorType(prop) {
-    if (prop.kind === ReferenceKind.ONE_TO_ONE) {
-      return 'OneToOne';
+    getScalarPropertyDecoratorOptions(options, prop, quote = true) {
+        if (prop.fieldNames[0] !== this.namingStrategy.propertyToColumnName(prop.name)) {
+            options.fieldName = this.quote(prop.fieldNames[0]);
+        }
+        if (prop.enum) {
+            if (this.options.enumMode === 'union-type') {
+                options.items = `[${prop.items.map(item => this.quote(item)).join(', ')}]`;
+            }
+            else if (prop.nativeEnumName) {
+                const enumClassName = this.namingStrategy.getEnumClassName(prop.nativeEnumName, undefined, this.meta.schema);
+                options.items = `() => ${enumClassName}`;
+                options.nativeEnumName = this.quote(prop.nativeEnumName);
+            }
+            else {
+                const enumClassName = this.namingStrategy.getEnumClassName(prop.fieldNames[0], this.meta.collection, this.meta.schema);
+                options.items = `() => ${enumClassName}`;
+            }
+        }
+        // For enum properties, we don't need a column type
+        // or the property length or other information in the decorator.
+        if (prop.enum) {
+            return;
+        }
+        const mappedColumnType = this.platform.getMappedType(prop.columnTypes[0]);
+        // If the column's runtimeType matches the declared runtimeType, assume it's the same underlying type.
+        const mappedRuntimeType = mappedColumnType.runtimeType === prop.runtimeType
+            ? mappedColumnType
+            : this.platform.getMappedType(prop.runtimeType);
+        const mappedDeclaredType = this.platform.getMappedType(prop.type);
+        const isTypeStringMissingFromMap = prop.type !== 'unknown' && mappedDeclaredType instanceof UnknownType;
+        if (isTypeStringMissingFromMap) {
+            this.entityImports.add(prop.type);
+            options.type = prop.type;
+        }
+        else {
+            if (this.options.scalarTypeInDecorator || // always output type if forced by the generator options
+                (prop.nullable && !this.options.forceUndefined) || // also when there is the "| null" type modifier (because reflect-metadata can't extract the base)
+                prop.hidden || // also when there is the "& Hidden" type modifier (because reflect-metadata can't extract the base)
+                new Set([
+                    mappedRuntimeType.name,
+                    mappedColumnType.name,
+                    mappedDeclaredType.name,
+                    this.platform.getMappedType(prop.runtimeType === 'Date' ? 'datetime' : prop.runtimeType).name,
+                ]).size > 1 || // also, if there's any ambiguity in the type
+                (() => {
+                    const hasUsableNullDefault = prop.nullable && !this.options.forceUndefined && prop.default === null;
+                    const useDefault = hasUsableNullDefault || !(typeof prop.default === 'undefined' || prop.default === null);
+                    return (useDefault && !hasUsableNullDefault) || (prop.optional && !prop.nullable);
+                })() // also when there is the "| Opt" type modifier (because reflect-metadata can't extract the base)
+            ) {
+                options.type = quote ? this.quote(prop.type) : prop.type;
+            }
+        }
+        const columnTypeFromMappedRuntimeType = mappedRuntimeType.getColumnType({ ...prop, autoincrement: false }, this.platform);
+        const columnTypeFromMappedColumnType = mappedColumnType.getColumnType({ ...prop, autoincrement: false }, this.platform);
+        const columnTypeFromMappedDeclaredType = mappedDeclaredType.getColumnType({ ...prop, autoincrement: false }, this.platform);
+        const needsExplicitColumnType = () => {
+            if (isTypeStringMissingFromMap ||
+                [mappedRuntimeType, mappedColumnType, columnTypeFromMappedDeclaredType].some(t => t instanceof UnknownType)) {
+                return true;
+            }
+            if (this.platform.normalizeColumnType(prop.columnTypes[0], prop) !==
+                this.platform.normalizeColumnType(columnTypeFromMappedColumnType, prop)) {
+                return prop.columnTypes[0] !== columnTypeFromMappedColumnType;
+            }
+            return (columnTypeFromMappedRuntimeType !== columnTypeFromMappedColumnType ||
+                columnTypeFromMappedDeclaredType !== columnTypeFromMappedColumnType);
+        };
+        if (needsExplicitColumnType()) {
+            options.columnType = this.quote(prop.columnTypes[0]);
+        }
+        const assign = (key) => {
+            if (prop[key] != null) {
+                options[key] = prop[key];
+            }
+        };
+        if (!options.columnType &&
+            (typeof mappedColumnType.getDefaultLength === 'undefined' ||
+                mappedColumnType.getDefaultLength(this.platform) !== prop.length)) {
+            assign('length');
+        }
+        // those are already included in the `columnType` in most cases, and when that option is present, they would be ignored anyway
+        /* v8 ignore next */
+        if (mappedColumnType instanceof DecimalType && !options.columnType) {
+            assign('precision');
+            assign('scale');
+        }
+        if (this.platform.supportsUnsigned() &&
+            ((!prop.primary && prop.unsigned) ||
+                (prop.primary && !prop.unsigned && this.platform.isNumericColumn(mappedColumnType)))) {
+            assign('unsigned');
+        }
+        if (prop.autoincrement) {
+            if (!prop.primary ||
+                !this.platform.isNumericColumn(mappedColumnType) ||
+                this.meta.getPrimaryProps().length !== 1) {
+                options.autoincrement = true;
+            }
+        }
+        else if (prop.primary &&
+            this.platform.isNumericColumn(mappedColumnType) &&
+            this.meta.getPrimaryProps().length === 1) {
+            options.autoincrement = false;
+        }
+        if (prop.generated) {
+            options.generated = typeof prop.generated === 'string' ? this.quote(prop.generated) : `${prop.generated}`;
+        }
     }
-    if (prop.kind === ReferenceKind.MANY_TO_ONE) {
-      return 'ManyToOne';
+    getManyToManyDecoratorOptions(options, prop) {
+        this.entityImports.add(prop.type);
+        options.entity = `() => ${prop.type}`;
+        if (prop.orderBy) {
+            options.orderBy = inspect(prop.orderBy);
+        }
+        if (prop.mappedBy) {
+            options.mappedBy = this.quote(prop.mappedBy);
+            return;
+        }
+        if (prop.pivotTable !==
+            this.namingStrategy.joinTableName(this.meta.collection, prop.type, prop.name, this.meta.tableName)) {
+            options.pivotTable = this.quote(prop.pivotTable);
+        }
+        if (prop.pivotEntity && Utils.className(prop.pivotEntity) !== prop.pivotTable) {
+            this.entityImports.add(Utils.className(prop.pivotEntity));
+            options.pivotEntity = `() => ${Utils.className(prop.pivotEntity)}`;
+        }
+        if (prop.joinColumns.length === 1) {
+            options.joinColumn = this.quote(prop.joinColumns[0]);
+        }
+        else {
+            options.joinColumns = `[${prop.joinColumns.map(c => this.quote(c)).join(', ')}]`;
+        }
+        if (prop.inverseJoinColumns.length === 1) {
+            options.inverseJoinColumn = this.quote(prop.inverseJoinColumns[0]);
+        }
+        else {
+            options.inverseJoinColumns = `[${prop.inverseJoinColumns.map(c => this.quote(c)).join(', ')}]`;
+        }
+        if (prop.fixedOrder) {
+            options.fixedOrder = true;
+            if (prop.fixedOrderColumn && prop.fixedOrderColumn !== this.namingStrategy.referenceColumnName()) {
+                options.fixedOrderColumn = this.quote(prop.fixedOrderColumn);
+            }
+        }
     }
-    if (prop.kind === ReferenceKind.ONE_TO_MANY) {
-      return 'OneToMany';
+    getOneToManyDecoratorOptions(options, prop) {
+        this.entityImports.add(prop.type);
+        options.entity = `() => ${prop.type}`;
+        options.mappedBy = this.quote(prop.mappedBy);
+        if (prop.orderBy) {
+            options.orderBy = inspect(prop.orderBy);
+        }
     }
-    if (prop.kind === ReferenceKind.MANY_TO_MANY) {
-      return 'ManyToMany';
+    getEmbeddedPropertyDeclarationOptions(options, prop) {
+        this.entityImports.add(prop.type);
+        options.entity = `() => ${prop.type}`;
+        if (prop.array) {
+            options.array = true;
+        }
+        if (prop.object && !prop.array) {
+            options.object = true;
+        }
+        if (prop.prefix === false || typeof prop.prefix === 'string') {
+            options.prefix = prop.prefix === false ? false : this.quote(prop.prefix);
+        }
     }
-    if (prop.kind === ReferenceKind.EMBEDDED) {
-      return 'Embedded';
+    getForeignKeyDecoratorOptions(options, prop) {
+        this.entityImports.add(prop.type);
+        options.entity = `() => ${prop.type}`;
+        if (prop.ref) {
+            options.ref = true;
+        }
+        if (prop.mapToPk) {
+            options.mapToPk = true;
+        }
+        if (prop.mappedBy) {
+            options.mappedBy = this.quote(prop.mappedBy);
+            return;
+        }
+        if (prop.fieldNames.length === 1) {
+            if (prop.fieldNames[0] !== this.namingStrategy.joinKeyColumnName(prop.name, prop.referencedColumnNames[0])) {
+                options.fieldName = this.quote(prop.fieldNames[0]);
+            }
+        }
+        else {
+            if (prop.fieldNames.length > 1 &&
+                prop.fieldNames.some((fieldName, i) => fieldName !== this.namingStrategy.joinKeyColumnName(prop.name, prop.referencedColumnNames[i]))) {
+                options.fieldNames = prop.fieldNames.map(fieldName => this.quote(fieldName));
+            }
+        }
+        if (prop.ownColumns && prop.ownColumns.length !== prop.fieldNames.length) {
+            options.referencedColumnNames = prop.referencedColumnNames.map(fieldName => this.quote(fieldName));
+        }
+        if (prop.updateRule) {
+            options.updateRule = this.quote(prop.updateRule);
+        }
+        if (prop.deleteRule) {
+            options.deleteRule = this.quote(prop.deleteRule);
+        }
+        if (prop.primary) {
+            options.primary = true;
+        }
+        if (prop.generated) {
+            options.generated = typeof prop.generated === 'string' ? this.quote(prop.generated) : `${prop.generated}`;
+        }
+        if (prop.fieldNames.length > 1 && !(typeof prop.default === 'undefined' || prop.default === null)) {
+            // TODO: Composite FKs with default values require additions to default/defaultRaw that are not yet supported.
+            options.ignoreSchemaChanges = [this.quote('default')];
+        }
     }
-    if (prop.enum) {
-      return 'Enum';
+    getDecoratorType(prop) {
+        if (prop.kind === ReferenceKind.ONE_TO_ONE) {
+            return 'OneToOne';
+        }
+        if (prop.kind === ReferenceKind.MANY_TO_ONE) {
+            return 'ManyToOne';
+        }
+        if (prop.kind === ReferenceKind.ONE_TO_MANY) {
+            return 'OneToMany';
+        }
+        if (prop.kind === ReferenceKind.MANY_TO_MANY) {
+            return 'ManyToMany';
+        }
+        if (prop.kind === ReferenceKind.EMBEDDED) {
+            return 'Embedded';
+        }
+        if (prop.enum) {
+            return 'Enum';
+        }
+        if (prop.primary) {
+            return 'PrimaryKey';
+        }
+        if (prop.formula) {
+            return 'Formula';
+        }
+        return 'Property';
     }
-    if (prop.primary) {
-      return 'PrimaryKey';
+    referenceCoreImport(identifier) {
+        this.coreImports.add(identifier);
+        return this.options.coreImportsPrefix ? `${this.options.coreImportsPrefix}${identifier}` : identifier;
     }
-    if (prop.formula) {
-      return 'Formula';
+    referenceDecoratorImport(identifier) {
+        this.decoratorImports.add(identifier);
+        return this.options.coreImportsPrefix ? `${this.options.coreImportsPrefix}${identifier}` : identifier;
     }
-    return 'Property';
-  }
-  referenceCoreImport(identifier) {
-    this.coreImports.add(identifier);
-    return this.options.coreImportsPrefix ? `${this.options.coreImportsPrefix}${identifier}` : identifier;
-  }
-  referenceDecoratorImport(identifier) {
-    this.decoratorImports.add(identifier);
-    return this.options.coreImportsPrefix ? `${this.options.coreImportsPrefix}${identifier}` : identifier;
-  }
 }