@goast/typescript 0.6.0-beta.1 → 0.6.0

package/src/src/ast/nodes/object.ts

@@ -0,0 +1,48 @@
+import { type AstNodeOptions, type BasicAppendValue, notNullish, type Nullable, type SourceBuilder } from '@goast/core';
+
+import { TsNode } from '../node.js';
+import { writeTsMembers } from '../utils/write-ts-members.js';
+import { writeTsNodes } from '../utils/write-ts-nodes.js';
+
+import type { TsMethod } from './method.js';
+import type { TsProperty } from './property.js';
+
+type Injects = never;
+
+type Options<TBuilder extends SourceBuilder, TInjects extends string = never> = AstNodeOptions<
+  typeof TsNode<TBuilder, TInjects | Injects>,
+  {
+    members?: Nullable<Nullable<Member<TBuilder>>[]>;
+  }
+>;
+
+type Member<TBuilder extends SourceBuilder> = TsProperty<TBuilder> | TsMethod<TBuilder> | BasicAppendValue<TBuilder>;
+
+export class TsObject<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
+  TBuilder,
+  TInjects | Injects
+> {
+  public members: Member<TBuilder>[];
+
+  constructor(options: Options<TBuilder, TInjects>) {
+    super(options);
+    this.members = options.members?.filter(notNullish) ?? [];
+  }
+
+  protected override onWrite(builder: TBuilder): void {
+    builder.parenthesize(
+      '{}',
+      (b) => {
+        writeTsMembers(b, this.members);
+      },
+      { multiline: this.members.length > 0 },
+    );
+  }
+}
+
+const createObject = <TBuilder extends SourceBuilder>(options?: Options<TBuilder>): TsObject<TBuilder> =>
+  new TsObject<TBuilder>(options ?? {});
+
+export const tsObject: typeof createObject & { write: typeof writeTsNodes } = Object.assign(createObject, {
+  write: writeTsNodes,
+});

package/src/src/ast/nodes/parameter.ts

@@ -0,0 +1,85 @@
+import {
+  type AstNodeOptions,
+  type BasicAppendValue,
+  notNullish,
+  type Nullable,
+  type Prettify,
+  type SourceBuilder,
+} from '@goast/core';
+
+import { TsNode } from '../node.js';
+import { writeTsNode } from '../utils/write-ts-nodes.js';
+import { writeTsParameters } from '../utils/write-ts-parameters.js';
+import { type TsDecorator, tsDecorator } from './decorator.js';
+import type { TsType, TsValue } from './types.js';
+
+type Injects = 'decorators' | 'name' | 'type' | 'default';
+
+type Options<TBuilder extends SourceBuilder, TInjects extends string = never> = AstNodeOptions<
+  typeof TsNode<TBuilder, TInjects | Injects>,
+  {
+    name: string;
+    description?: Nullable<BasicAppendValue<TBuilder>>;
+    decorators?: Nullable<Nullable<TsDecorator<TBuilder>>[]>;
+    type?: Nullable<TsType<TBuilder>>;
+    optional?: Nullable<boolean>;
+    default?: Nullable<TsValue<TBuilder>>;
+  }
+>;
+
+export class TsParameter<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
+  TBuilder,
+  TInjects | Injects
+> {
+  public name: string;
+  public description: BasicAppendValue<TBuilder> | null;
+  public decorators: TsDecorator<TBuilder>[];
+  public type: TsType<TBuilder> | null;
+  public optional: boolean;
+  public default: TsValue<TBuilder> | null;
+
+  constructor(options: Options<TBuilder, TInjects>) {
+    super(options);
+    this.name = options.name;
+    this.description = options.description ?? null;
+    this.decorators = options.decorators?.filter(notNullish) ?? [];
+    this.type = options.type ?? null;
+    this.optional = options.optional ?? false;
+    this.default = options.default ?? null;
+  }
+
+  protected override onWrite(builder: TBuilder): void {
+    builder.append(this.inject.beforeDecorators);
+    tsDecorator.write(builder, this.decorators);
+    builder.append(this.inject.afterDecorators);
+
+    builder.append(this.inject.beforeName, this.name, this.inject.afterName);
+    if (this.optional) builder.append('?');
+
+    if (this.type) {
+      builder.append(': ');
+      builder.append(this.inject.beforeType);
+      writeTsNode(builder, this.type);
+      builder.append(this.inject.afterType);
+    }
+
+    if (this.default) {
+      builder.append(' = ');
+      builder.append(this.inject.beforeDefault);
+      writeTsNode(builder, this.default);
+      builder.append(this.inject.afterDefault);
+    }
+  }
+}
+
+const createParameter = <TBuilder extends SourceBuilder>(
+  name: Options<TBuilder>['name'],
+  options?: Prettify<Omit<Options<TBuilder>, 'name'>>,
+): TsParameter<TBuilder> => new TsParameter<TBuilder>({ ...options, name });
+
+export const tsParameter: typeof createParameter & { write: typeof writeTsParameters } = Object.assign(
+  createParameter,
+  {
+    write: writeTsParameters,
+  },
+);

package/src/src/ast/nodes/property-accessor.ts

@@ -0,0 +1,173 @@
+import { type AppendValue, type AstNodeOptions, notNullish, type Nullable, type SourceBuilder } from '@goast/core';
+
+import type { TsAccessModifier } from '../common.js';
+import { TsNode } from '../node.js';
+import { writeTsNode } from '../utils/write-ts-nodes.js';
+import { type TsDecorator, tsDecorator } from './decorator.js';
+import { type TsDoc, tsDoc } from './doc.js';
+import type { TsProperty } from './property.js';
+import type { TsType } from './types.js';
+
+type Injects = never;
+
+type Options<TBuilder extends SourceBuilder, TInjects extends string = never> = AstNodeOptions<
+  typeof TsNode<TBuilder, TInjects | Injects>,
+  {
+    propertyName?: Nullable<string>;
+    doc?: Nullable<TsDoc<TBuilder>>;
+    type?: Nullable<TsType<TBuilder>>;
+    decorators?: Nullable<Nullable<TsDecorator<TBuilder>>[]>;
+    body?: Nullable<AppendValue<TBuilder>>;
+    accessModifier?: Nullable<TsAccessModifier>;
+    static?: Nullable<boolean>;
+    abstract?: Nullable<boolean>;
+    override?: Nullable<boolean>;
+  }
+>;
+
+abstract class TsPropertyAccessor<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
+  TBuilder,
+  TInjects | Injects
+> {
+  private _propertyName: string | null;
+  private _type: TsType<TBuilder> | null;
+  private _accessModifier: TsAccessModifier | null;
+  private _static: boolean;
+  private _abstract: boolean;
+  private _override: boolean;
+
+  public doc: TsDoc<TBuilder> | null;
+  public decorators: TsDecorator<TBuilder>[];
+  public body: AppendValue<TBuilder> | null;
+
+  public get propertyName(): string {
+    return this.property?.name ?? this._propertyName ?? 'someProperty';
+  }
+  public set propertyName(value: string | null) {
+    this._propertyName = value;
+  }
+
+  public get type(): TsType<TBuilder> | null {
+    return this.property?.type ?? this._type;
+  }
+  public set type(value: TsType<TBuilder> | null) {
+    this._type = value;
+  }
+
+  public get accessModifier(): TsAccessModifier | null {
+    return this.property?.accessModifier ?? this._accessModifier;
+  }
+  public set accessModifier(value: TsAccessModifier | null) {
+    this._accessModifier = value;
+  }
+
+  public get static(): boolean {
+    return this.property?.static ?? this._static;
+  }
+  public set static(value: boolean) {
+    this._static = value;
+  }
+
+  public get abstract(): boolean {
+    return this.property?.abstract ?? this._abstract;
+  }
+  public set abstract(value: boolean) {
+    this._abstract = value;
+  }
+
+  public get override(): boolean {
+    return this.property?.override ?? this._override;
+  }
+  public set override(value: boolean) {
+    this._override = value;
+  }
+
+  protected property?: TsProperty<TBuilder>;
+
+  constructor(options: Options<TBuilder, TInjects>) {
+    super(options);
+    this._propertyName = options.propertyName ?? null;
+    this.doc = options.doc ?? null;
+    this._type = options.type ?? null;
+    this.decorators = options.decorators?.filter(notNullish) ?? [];
+    this.body = options.body ?? null;
+    this._accessModifier = options.accessModifier ?? null;
+    this._static = options.static ?? false;
+    this._abstract = options.abstract ?? false;
+    this._override = options.override ?? false;
+  }
+}
+
+export class TsPropertySetter<TBuilder extends SourceBuilder, TInjects extends string = never>
+  extends TsPropertyAccessor<
+    TBuilder,
+    TInjects
+  > {
+  protected override onWrite(builder: TBuilder): void {
+    tsDoc.write(builder, this.doc);
+    tsDecorator.write(builder, this.decorators);
+
+    if (this.accessModifier) builder.append(this.accessModifier, ' ');
+    if (this.static) builder.append('static ');
+    if (this.abstract) builder.append('abstract ');
+    if (this.override) builder.append('override ');
+
+    builder.append('set ', this.propertyName);
+    builder.parenthesize('()', (b) => {
+      b.append('value');
+      if (this.type !== null) {
+        b.append(': ');
+        writeTsNode(b, this.type);
+      }
+    });
+
+    if (this.body !== null) {
+      builder.append(' ');
+      builder.parenthesize('{}', this.body, { multiline: true });
+    } else {
+      builder.append(';');
+    }
+
+    builder.appendLine();
+  }
+}
+
+export class TsPropertyGetter<TBuilder extends SourceBuilder, TInjects extends string = never>
+  extends TsPropertyAccessor<
+    TBuilder,
+    TInjects
+  > {
+  protected override onWrite(builder: TBuilder): void {
+    tsDoc.write(builder, this.doc);
+    tsDecorator.write(builder, this.decorators);
+
+    if (this.accessModifier) builder.append(this.accessModifier, ' ');
+    if (this.static) builder.append('static ');
+    if (this.abstract) builder.append('abstract ');
+    if (this.override) builder.append('override ');
+
+    builder.append('get ', this.propertyName, '()');
+
+    if (this.type) {
+      builder.append(': ');
+      writeTsNode(builder, this.type);
+    }
+
+    if (this.body !== null) {
+      builder.append(' ');
+      builder.parenthesize('{}', this.body, { multiline: true });
+    } else {
+      builder.append(';');
+    }
+
+    builder.appendLine();
+  }
+}
+
+export const createPropertySetter = <TBuilder extends SourceBuilder>(
+  options?: Options<TBuilder>,
+): TsPropertySetter<TBuilder> => new TsPropertySetter<TBuilder>(options ?? {});
+
+export const createPropertyGetter = <TBuilder extends SourceBuilder>(
+  options?: Options<TBuilder>,
+): TsPropertyGetter<TBuilder> => new TsPropertyGetter<TBuilder>(options ?? {});

package/src/src/ast/nodes/property.ts

@@ -0,0 +1,192 @@
+import { type AstNodeOptions, notNullish, type Nullable, type Prettify, type SourceBuilder } from '@goast/core';
+
+import type { TsAccessModifier } from '../common.js';
+import { TsNode } from '../node.js';
+import { writeTsNode, writeTsNodes } from '../utils/write-ts-nodes.js';
+import { type TsDecorator, tsDecorator } from './decorator.js';
+import { type TsDoc, tsDoc } from './doc.js';
+import { TsObject } from './object.js';
+import {
+  createPropertyGetter,
+  createPropertySetter,
+  type TsPropertyGetter,
+  type TsPropertySetter,
+} from './property-accessor.js';
+import { tsString } from './string.js';
+import type { TsType, TsValue } from './types.js';
+
+type BaseInjects = never;
+
+type BaseOptions<TBuilder extends SourceBuilder, TInjects extends string = never> = AstNodeOptions<
+  typeof TsNode<TBuilder, TInjects | BaseInjects>,
+  {
+    name: string;
+    doc?: Nullable<TsDoc<TBuilder>>;
+    decorators?: Nullable<Nullable<TsDecorator<TBuilder>>[]>;
+    type?: Nullable<TsType<TBuilder>>;
+    accessModifier?: Nullable<TsAccessModifier>;
+    static?: Nullable<boolean>;
+    abstract?: Nullable<boolean>;
+    override?: Nullable<boolean>;
+  }
+>;
+
+type SimpleOptions<TBuilder extends SourceBuilder, TInjects extends string = never> =
+  & BaseOptions<TBuilder, TInjects>
+  & {
+    value?: Nullable<TsValue<TBuilder>>;
+    readonly?: Nullable<boolean>;
+    optional?: Nullable<boolean>;
+  };
+
+type AccessorOptions<TBuilder extends SourceBuilder, TInjects extends string = never> =
+  & BaseOptions<TBuilder, TInjects>
+  & {
+    get?: Nullable<TsPropertyGetter<TBuilder>>;
+    set?: Nullable<TsPropertySetter<TBuilder>>;
+  };
+
+export abstract class TsProperty<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
+  TBuilder,
+  TInjects | BaseInjects
+> {
+  public name: string;
+  public doc: TsDoc<TBuilder> | null;
+  public decorators: TsDecorator<TBuilder>[];
+  public type: TsType<TBuilder> | null;
+  public accessModifier: TsAccessModifier | null;
+  public static: boolean | null;
+  public abstract: boolean | null;
+  public override: boolean | null;
+
+  constructor(options: BaseOptions<TBuilder, TInjects>) {
+    super(options);
+    this.name = options.name;
+    this.doc = options.doc ?? null;
+    this.decorators = options.decorators?.filter(notNullish) ?? [];
+    this.type = options.type ?? null;
+    this.accessModifier = options.accessModifier ?? null;
+    this.static = options.static ?? null;
+    this.abstract = options.abstract ?? null;
+    this.override = options.override ?? null;
+  }
+}
+
+export class TsSimpleProperty<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsProperty<
+  TBuilder,
+  TInjects
+> {
+  public value: TsValue<TBuilder> | null;
+  public readonly: boolean;
+  public optional: boolean;
+
+  constructor(options: SimpleOptions<TBuilder, TInjects>) {
+    super(options);
+    this.value = options.value ?? null;
+    this.readonly = options.readonly ?? false;
+    this.optional = options.optional ?? false;
+  }
+
+  protected override onWrite(builder: TBuilder): void {
+    const isInObjectDeclaration = this.getParentNode(builder) instanceof TsObject;
+
+    tsDoc.write(builder, this.doc);
+    tsDecorator.write(builder, this.decorators);
+
+    if (this.accessModifier) builder.append(this.accessModifier, ' ');
+    if (this.static) builder.append('static ');
+    if (this.abstract) builder.append('abstract ');
+    if (this.override) builder.append('override ');
+    if (this.readonly) builder.append('readonly ');
+
+    writeTsNode(builder, /^([a-zA-Z_$][a-zA-Z_$0-9]*|[0-9]+)$/.test(this.name) ? this.name : tsString(this.name));
+    if (this.optional) builder.append('?');
+
+    if (this.type && !isInObjectDeclaration) {
+      builder.append(': ');
+      writeTsNode(builder, this.type);
+    }
+
+    if (this.value) {
+      builder.append(isInObjectDeclaration ? ': ' : ' = ');
+      writeTsNode(builder, this.value);
+    }
+
+    builder.append(isInObjectDeclaration ? ',' : ';');
+
+    builder.appendLine();
+  }
+}
+
+export class TsAccessorProperty<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsProperty<
+  TBuilder,
+  TInjects
+> {
+  private _get: TsPropertyGetter<TBuilder> | null = null;
+  private _set: TsPropertySetter<TBuilder> | null = null;
+
+  public get get(): TsPropertyGetter<TBuilder> | null {
+    return this._get;
+  }
+  public set get(value: TsPropertyGetter<TBuilder> | null) {
+    if (value) {
+      value['property'] = this;
+    }
+    if (this._get) {
+      this._get['property'] = undefined;
+    }
+    this._get = value;
+  }
+
+  public get set(): TsPropertySetter<TBuilder> | null {
+    return this._set;
+  }
+  public set set(value: TsPropertySetter<TBuilder> | null) {
+    if (value) {
+      value['property'] = this;
+    }
+    if (this._set) {
+      this._set['property'] = undefined;
+    }
+    this._set = value;
+  }
+
+  constructor(options: AccessorOptions<TBuilder, TInjects>) {
+    super(options);
+    this.get = options.get ?? null;
+    this.set = options.set ?? null;
+  }
+
+  protected override onWrite(builder: TBuilder): void {
+    builder.append(
+      (b) => tsDoc.write(b, this.doc),
+      (b) => tsDecorator.write(b, this.decorators),
+    );
+    if (this.get) {
+      this.get.write(builder);
+    }
+    if (this.set) {
+      this.set.write(builder);
+    }
+  }
+}
+
+const createProperty = <TBuilder extends SourceBuilder>(
+  name: BaseOptions<TBuilder>['name'],
+  options?: Prettify<Omit<SimpleOptions<TBuilder>, 'name'>> | Prettify<Omit<AccessorOptions<TBuilder>, 'name'>>,
+): TsProperty<TBuilder> => {
+  if (options && ('get' in options || 'set' in options)) {
+    return new TsAccessorProperty({ ...options, name });
+  }
+  return new TsSimpleProperty({ ...options, name });
+};
+
+export const tsProperty: typeof createProperty & {
+  write: typeof writeTsNodes;
+  getter: typeof createPropertyGetter;
+  setter: typeof createPropertySetter;
+} = Object.assign(createProperty, {
+  write: writeTsNodes,
+  getter: createPropertyGetter,
+  setter: createPropertySetter,
+});

package/src/src/ast/nodes/reference.ts

@@ -0,0 +1,194 @@
+import {
+  type AstNodeOptions,
+  notNullish,
+  type Nullable,
+  type Prettify,
+  type SourceBuilder,
+  type TupleWithCount,
+} from '@goast/core';
+
+import type { TypeScriptImportType } from '../../common-results.js';
+import { TypeScriptFileBuilder } from '../../file-builder.js';
+import { TsNode } from '../node.js';
+import { writeTsGenericParameters } from '../utils/write-ts-generic-parameters.js';
+import { writeTsNodes } from '../utils/write-ts-nodes.js';
+import type { TsType } from './types.js';
+
+type Injects = never;
+
+type Options<TBuilder extends SourceBuilder, TInjects extends string = never> = AstNodeOptions<
+  typeof TsNode<TBuilder, TInjects | Injects>,
+  {
+    name: string;
+    moduleNameOrfilePath?: Nullable<string>;
+    generics?: Nullable<Nullable<TsType<TBuilder>>[]>;
+    importType?: Nullable<TypeScriptImportType>;
+  }
+>;
+type FactoryOptions<TBuilder extends SourceBuilder> = {
+  importType?: Nullable<TypeScriptImportType>;
+};
+
+type _AddImportHandler<T> = {
+  // deno-lint-ignore no-explicit-any
+  builderClass: abstract new (...args: any[]) => T;
+  // deno-lint-ignore no-explicit-any
+  handler: (builder: T, reference: TsReference<any>) => void;
+};
+
+export class TsReference<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
+  TBuilder,
+  TInjects | Injects
+> {
+  // deno-lint-ignore no-explicit-any
+  private static readonly addImportHandlers: _AddImportHandler<any>[] = [
+    {
+      builderClass: TypeScriptFileBuilder,
+      handler: (builder: TypeScriptFileBuilder, reference) => {
+        if (reference.moduleNameOrfilePath) {
+          builder.addImport(reference.name, reference.moduleNameOrfilePath, { type: reference.importType });
+        }
+      },
+    },
+  ];
+
+  public name: string;
+  public moduleNameOrfilePath: string | null;
+  public generics: TsType<TBuilder>[];
+  public importType: TypeScriptImportType;
+
+  constructor(options: Options<TBuilder, TInjects>) {
+    super(options);
+    this.name = options.name;
+    this.moduleNameOrfilePath = options.moduleNameOrfilePath ?? null;
+    this.generics = options.generics?.filter(notNullish) ?? [];
+    this.importType = options.importType ?? 'import';
+  }
+
+  protected override onWrite(builder: TBuilder): void {
+    builder.append(this.name);
+    writeTsGenericParameters(builder, this.generics);
+    if (this.moduleNameOrfilePath) {
+      const handler = TsReference.addImportHandlers.find((h) => builder instanceof h.builderClass);
+      if (handler) {
+        handler.handler(builder, this);
+      }
+    }
+  }
+
+  public static registerAddImportHandler<TBuilder extends SourceBuilder>(
+    builderClass: _AddImportHandler<TBuilder>['builderClass'],
+    handler: _AddImportHandler<TBuilder>['handler'],
+  ): void {
+    TsReference.addImportHandlers.push({ builderClass, handler });
+  }
+}
+
+const createReference = <TBuilder extends SourceBuilder>(
+  name: Options<TBuilder>['name'],
+  moduleNameOrfilePath?: Options<TBuilder>['moduleNameOrfilePath'],
+  options?: Prettify<Omit<Options<TBuilder>, 'name' | 'moduleNameOrfilePath'>>,
+): TsReference<TBuilder> => new TsReference<TBuilder>({ ...options, name, moduleNameOrfilePath });
+
+export type TsReferenceFactory =
+  & (<TBuilder extends SourceBuilder>(options?: FactoryOptions<TBuilder>) => TsReference<TBuilder>)
+  & {
+    refName: string;
+    moduleNameOrfilePath: Nullable<string>;
+  };
+export type TsModuleReferenceFactory = TsReferenceFactory & {
+  moduleNameOrfilePath: string;
+};
+
+export type TsGenericReferenceFactory<TGenericCount extends number | number[]> =
+  & (<TBuilder extends SourceBuilder>(
+    generics: TupleWithCount<TsType<TBuilder>, TGenericCount>,
+    options?: FactoryOptions<TBuilder>,
+  ) => TsReference<TBuilder>)
+  & {
+    refName: string;
+    moduleNameOrfilePath: Nullable<string>;
+    infer: <TBuilder extends SourceBuilder>() => TsReference<TBuilder>;
+  };
+export type TsGenericModuleReferenceFactory<TGenericCount extends number | number[]> =
+  & TsGenericReferenceFactory<TGenericCount>
+  & {
+    moduleNameOrfilePath: string;
+  };
+
+function _createFactory(
+  name: string,
+  moduleNameOrfilePath?: Nullable<string>,
+  defaultOptions?: { importType?: Nullable<TypeScriptImportType> },
+): TsReferenceFactory {
+  return Object.assign(
+    <TBuilder extends SourceBuilder>(options?: FactoryOptions<TBuilder>) =>
+      createReference<TBuilder>(name, moduleNameOrfilePath, { ...defaultOptions, ...options }),
+    {
+      refName: name,
+      moduleNameOrfilePath,
+    },
+  );
+}
+function createFactory(
+  name: string,
+  moduleNameOrfilePath: string,
+  defaultOptions?: { importType?: Nullable<TypeScriptImportType> },
+): TsModuleReferenceFactory;
+function createFactory(
+  name: string,
+  moduleNameOrfilePath?: Nullable<string>,
+  defaultOptions?: { importType?: Nullable<TypeScriptImportType> },
+): TsReferenceFactory;
+function createFactory(
+  name: string,
+  moduleNameOrfilePath?: Nullable<string>,
+  defaultOptions?: { importType?: Nullable<TypeScriptImportType> },
+): TsReferenceFactory {
+  return _createFactory(name, moduleNameOrfilePath, defaultOptions);
+}
+
+function _createGenericFactory<TGenericCount extends number | number[]>(
+  name: string,
+  moduleNameOrfilePath?: Nullable<string>,
+  defaultOptions?: { importType?: Nullable<TypeScriptImportType> },
+): TsGenericReferenceFactory<TGenericCount> {
+  return Object.assign(
+    <TBuilder extends SourceBuilder>(
+      generics: TupleWithCount<TsType<TBuilder>, TGenericCount>,
+      options?: FactoryOptions<TBuilder>,
+    ) => createReference<TBuilder>(name, moduleNameOrfilePath, { ...defaultOptions, ...options, generics }),
+    {
+      refName: name,
+      moduleNameOrfilePath,
+      infer: <TBuilder extends SourceBuilder>() => createReference<TBuilder>(name, moduleNameOrfilePath),
+    },
+  );
+}
+function createGenericFactory<TGenericCount extends number | number[]>(
+  name: string,
+  moduleNameOrfilePath: string,
+  defaultOptions?: { importType?: Nullable<TypeScriptImportType> },
+): TsGenericModuleReferenceFactory<TGenericCount>;
+function createGenericFactory<TGenericCount extends number | number[]>(
+  name: string,
+  moduleNameOrfilePath?: Nullable<string>,
+  defaultOptions?: { importType?: Nullable<TypeScriptImportType> },
+): TsGenericReferenceFactory<TGenericCount>;
+function createGenericFactory<TGenericCount extends number | number[]>(
+  name: string,
+  moduleNameOrfilePath?: Nullable<string>,
+  defaultOptions?: { importType?: Nullable<TypeScriptImportType> },
+): TsGenericReferenceFactory<TGenericCount> {
+  return _createGenericFactory<TGenericCount>(name, moduleNameOrfilePath, defaultOptions);
+}
+
+export const tsReference: typeof createReference & {
+  factory: typeof createFactory;
+  genericFactory: typeof createGenericFactory;
+  write: typeof writeTsNodes;
+} = Object.assign(createReference, {
+  factory: createFactory,
+  genericFactory: createGenericFactory,
+  write: writeTsNodes,
+});