@goast/typescript 0.5.2 → 0.5.3-beta.1

package/src/src/ast/nodes/export.ts

@@ -1,54 +0,0 @@
-import type { AstNodeOptions, Nullable, Prettify, SourceBuilder } from '@goast/core';
-
-import type { TypeScriptExportType } from '../../common-results.js';
-import { TypeScriptFileBuilder } from '../../file-builder.js';
-import { TsNode } from '../node.js';
-import { writeTsNodes } from '../utils/write-ts-nodes.js';
-
-type Injects = never;
-
-type Options<TBuilder extends SourceBuilder, TInjects extends string = never> = AstNodeOptions<
-  typeof TsNode<TBuilder, TInjects | Injects>,
-  {
-    name: string;
-    filePath: string;
-    kind?: Nullable<TypeScriptExportType>;
-  }
->;
-
-export class TsExport<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
-  TBuilder,
-  TInjects | Injects
-> {
-  public name: string;
-  public filePath: string;
-  public kind: TypeScriptExportType;
-
-  constructor(options: Options<TBuilder, TInjects>) {
-    super(options);
-    this.name = options.name;
-    this.filePath = options.filePath;
-    this.kind = options.kind ?? 'export';
-  }
-
-  protected override onWrite(builder: TBuilder): void {
-    if (builder instanceof TypeScriptFileBuilder) {
-      builder.addExport(this.name, this.filePath, { type: this.kind });
-    } else {
-      builder.appendLine(
-        this.kind === 'type-export' ? 'export type' : 'export',
-        ` { ${this.name} } from '${this.filePath}';`,
-      );
-    }
-  }
-}
-
-export const createExport = <TBuilder extends SourceBuilder>(
-  name: Options<TBuilder>['name'],
-  filePath: Options<TBuilder>['filePath'],
-  options?: Prettify<Omit<Options<TBuilder>, 'name' | 'filePath'>>,
-): TsExport<TBuilder> => new TsExport<TBuilder>({ ...options, name, filePath });
-
-export const tsExport: typeof createExport & { write: typeof writeTsNodes } = Object.assign(createExport, {
-  write: writeTsNodes,
-});

package/src/src/ast/nodes/function-type.ts

@@ -1,60 +0,0 @@
-import { type AstNodeOptions, type BasicAppendValue, notNullish, type Nullable, type SourceBuilder } from '@goast/core';
-
-import { TsNode } from '../node.js';
-import { writeTsNode, writeTsNodes } from '../utils/write-ts-nodes.js';
-import { type TsGenericParameter, tsGenericParameter } from './generic-parameter.js';
-import { type TsParameter, tsParameter } from './parameter.js';
-import type { TsType } from './types.js';
-
-type Injects = 'generics' | 'params' | 'returnType';
-
-type Options<TBuilder extends SourceBuilder, TInjects extends string = never> = AstNodeOptions<
-  typeof TsNode<TBuilder, TInjects | Injects>,
-  {
-    generics?: Nullable<Nullable<TsGenericParameter<TBuilder> | BasicAppendValue<TBuilder>>[]>;
-    parameters?: Nullable<Nullable<TsParameter<TBuilder> | BasicAppendValue<TBuilder>>[]>;
-    returnType?: Nullable<TsType<TBuilder>>;
-  }
->;
-
-export class TsFunctionType<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
-  TBuilder,
-  TInjects | Injects
-> {
-  public generics: (TsGenericParameter<TBuilder> | BasicAppendValue<TBuilder>)[];
-  public parameters: (TsParameter<TBuilder> | BasicAppendValue<TBuilder>)[];
-  public returnType: TsType<TBuilder> | null;
-
-  constructor(options: Options<TBuilder, TInjects>) {
-    super(options);
-    this.generics = options.generics?.filter(notNullish) ?? [];
-    this.parameters = options.parameters?.filter(notNullish) ?? [];
-    this.returnType = options.returnType ?? null;
-  }
-
-  protected override onWrite(builder: TBuilder): void {
-    builder.append(this.inject.beforeGenerics);
-    tsGenericParameter.write(builder, this.generics);
-    builder.append(this.inject.afterGenerics);
-
-    builder.append(this.inject.beforeParams);
-    tsParameter.write(builder, this.parameters);
-    builder.append(this.inject.afterParams);
-
-    builder.append(' => ');
-
-    builder.append(this.inject.beforeReturnType);
-    writeTsNode(builder, this.returnType ?? 'void');
-    builder.append(this.inject.afterReturnType);
-  }
-}
-
-const createFunctionType = <TBuilder extends SourceBuilder>(options?: Options<TBuilder>): TsFunctionType<TBuilder> =>
-  new TsFunctionType<TBuilder>(options ?? {});
-
-export const tsFunctionType: typeof createFunctionType & { write: typeof writeTsNodes } = Object.assign(
-  createFunctionType,
-  {
-    write: writeTsNodes,
-  },
-);

package/src/src/ast/nodes/function.ts

@@ -1,107 +0,0 @@
-import {
-  type AppendValue,
-  type AstNodeOptions,
-  notNullish,
-  type Nullable,
-  type Prettify,
-  type SourceBuilder,
-} from '@goast/core';
-
-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 { type TsGenericParameter, tsGenericParameter } from './generic-parameter.js';
-import { type TsParameter, tsParameter } from './parameter.js';
-import type { TsType } from './types.js';
-
-type Injects = 'doc' | 'decorators' | 'modifiers' | 'name' | 'generics' | 'params' | 'returnType' | 'body';
-
-type Options<TBuilder extends SourceBuilder, TInjects extends string = never> = AstNodeOptions<
-  typeof TsNode<TBuilder, TInjects | Injects>,
-  {
-    doc?: Nullable<TsDoc<TBuilder>>;
-    decorators?: Nullable<Nullable<TsDecorator<TBuilder>>[]>;
-    export?: boolean;
-    name: string;
-    generics?: Nullable<Nullable<TsGenericParameter<TBuilder>>[]>;
-    parameters?: Nullable<Nullable<TsParameter<TBuilder>>[]>;
-    returnType?: Nullable<TsType<TBuilder>>;
-    body?: Nullable<AppendValue<TBuilder>>;
-  }
->;
-
-export class TsFunction<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
-  TBuilder,
-  TInjects | Injects
-> {
-  public doc: TsDoc<TBuilder> | null;
-  public decorators: TsDecorator<TBuilder>[];
-  public export: boolean;
-  public name: string;
-  public generics: TsGenericParameter<TBuilder>[];
-  public parameters: TsParameter<TBuilder>[];
-  public returnType: TsType<TBuilder> | null;
-  public body: AppendValue<TBuilder> | null;
-
-  constructor(options: Options<TBuilder, TInjects>) {
-    super(options);
-    this.doc = options.doc ?? null;
-    this.decorators = options.decorators?.filter(notNullish) ?? [];
-    this.export = options.export ?? false;
-    this.name = options.name;
-    this.generics = options.generics?.filter(notNullish) ?? [];
-    this.parameters = options.parameters?.filter(notNullish) ?? [];
-    this.returnType = options.returnType ?? null;
-    this.body = options.body ?? null;
-  }
-
-  protected override onWrite(builder: TBuilder): void {
-    builder.append(this.inject.beforeDoc);
-    tsDoc.write(builder, tsDoc.get(this.doc, { generics: this.generics }));
-    builder.append(this.inject.afterDoc);
-
-    builder.append(this.inject.beforeDecorators);
-    tsDecorator.write(builder, this.decorators, { multiline: true });
-    builder.append(this.inject.afterDecorators);
-
-    builder.append(this.inject.beforeModifiers);
-    if (this.export) builder.append('export ');
-    builder.append(this.inject.afterModifiers);
-
-    builder.append('function ');
-    builder.append(this.inject.beforeName, this.name, this.inject.afterName);
-
-    builder.append(this.inject.beforeGenerics);
-    tsGenericParameter.write(builder, this.generics);
-    builder.append(this.inject.afterGenerics);
-
-    builder.append(this.inject.beforeParams);
-    tsParameter.write(builder, this.parameters);
-    builder.append(this.inject.afterParams);
-
-    if (this.returnType) {
-      builder.append(': ');
-      builder.append(this.inject.beforeReturnType);
-      writeTsNode(builder, this.returnType);
-      builder.append(this.inject.afterReturnType);
-    }
-
-    builder.append(' ');
-
-    builder.append(this.inject.beforeBody);
-    builder.parenthesize('{}', this.body, { multiline: !!this.body });
-    builder.append(this.inject.afterBody);
-
-    builder.appendLine();
-  }
-}
-
-const createFunction = <TBuilder extends SourceBuilder>(
-  name: Options<TBuilder>['name'],
-  options?: Prettify<Omit<Options<TBuilder>, 'name'>>,
-): TsFunction<TBuilder> => new TsFunction<TBuilder>({ ...options, name });
-
-export const tsFunction: typeof createFunction & { write: typeof writeTsNodes } = Object.assign(createFunction, {
-  write: writeTsNodes,
-});

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

@@ -1,71 +0,0 @@
-import type { AstNodeOptions, BasicAppendValue, Nullable, Prettify, SourceBuilder } from '@goast/core';
-
-import { TsNode } from '../node.js';
-import { writeTsGenericParameters } from '../utils/write-ts-generic-parameters.js';
-import { writeTsNode } from '../utils/write-ts-nodes.js';
-import type { TsType } from './types.js';
-
-type Injects = 'modifiers' | 'name' | 'constraint' | 'default';
-
-type Options<TBuilder extends SourceBuilder, TInjects extends string = never> = AstNodeOptions<
-  typeof TsNode<TBuilder, TInjects | Injects>,
-  {
-    description?: Nullable<BasicAppendValue<TBuilder>>;
-    const?: Nullable<boolean>;
-    name: string;
-    constraint?: Nullable<TsType<TBuilder>>;
-    default?: Nullable<TsType<TBuilder>>;
-  }
->;
-
-export class TsGenericParameter<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
-  TBuilder,
-  TInjects | Injects
-> {
-  public description: BasicAppendValue<TBuilder> | null;
-  public const: boolean;
-  public name: string;
-  public constraint: TsType<TBuilder> | null;
-  public default: TsType<TBuilder> | null;
-
-  constructor(options: Options<TBuilder, TInjects>) {
-    super(options);
-    this.description = options.description ?? null;
-    this.const = options.const ?? false;
-    this.name = options.name;
-    this.constraint = options.constraint ?? null;
-    this.default = options.default ?? null;
-  }
-
-  protected override onWrite(builder: TBuilder): void {
-    builder.append(this.inject.beforeModifiers);
-    builder.appendIf(this.const, 'const ');
-    builder.append(this.inject.afterModifiers);
-
-    builder.append(this.inject.beforeName, this.name, this.inject.afterName);
-
-    if (this.constraint !== null) {
-      builder.append(' extends ');
-      builder.append(this.inject.beforeConstraint);
-      writeTsNode(builder, this.constraint);
-      builder.append(this.inject.afterConstraint);
-    }
-
-    if (this.default !== null) {
-      builder.append(' = ');
-      builder.append(this.inject.beforeDefault);
-      writeTsNode(builder, this.default);
-      builder.append(this.inject.afterDefault);
-    }
-  }
-}
-
-const createGenericParameter = <TBuilder extends SourceBuilder>(
-  name: Options<TBuilder>['name'],
-  options?: Prettify<Omit<Options<TBuilder>, 'name'>>,
-): TsGenericParameter<TBuilder> => new TsGenericParameter<TBuilder>({ ...options, name });
-
-export const tsGenericParameter: typeof createGenericParameter & { write: typeof writeTsGenericParameters } = Object
-  .assign(createGenericParameter, {
-    write: writeTsGenericParameters,
-  });

package/src/src/ast/nodes/indexer.ts

@@ -1,60 +0,0 @@
-import type { AstNodeOptions, Nullable, Prettify, SourceBuilder } from '@goast/core';
-
-import { TsNode } from '../node.js';
-import { writeTsNode, 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>,
-  {
-    keyName?: Nullable<string>;
-    keyType: TsType<TBuilder>;
-    valueType: TsType<TBuilder>;
-    readonly?: Nullable<boolean>;
-  }
->;
-
-export class TsIndexer<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
-  TBuilder,
-  TInjects | Injects
-> {
-  public keyName: string;
-  public keyType: TsType<TBuilder>;
-  public valueType: TsType<TBuilder>;
-  public readonly: boolean;
-
-  constructor(options: Options<TBuilder, TInjects>) {
-    super(options);
-    this.keyName = options.keyName ?? 'key';
-    this.keyType = options.keyType;
-    this.valueType = options.valueType;
-    this.readonly = options.readonly ?? false;
-  }
-
-  protected override onWrite(builder: TBuilder): void {
-    if (this.readonly) builder.append('readonly ');
-
-    builder.parenthesize('[]', (b) => {
-      b.append(this.keyName, ': ');
-      writeTsNode(b, this.keyType);
-    });
-
-    builder.append(': ');
-    writeTsNode(builder, this.valueType);
-    builder.append(';');
-
-    builder.appendLine();
-  }
-}
-
-const createIndexer = <TBuilder extends SourceBuilder>(
-  keyType: Options<TBuilder>['keyType'],
-  valueType: Options<TBuilder>['valueType'],
-  options?: Prettify<Omit<Options<TBuilder>, 'keyType' | 'valueType'>>,
-): TsIndexer<TBuilder> => new TsIndexer<TBuilder>({ ...options, keyType, valueType });
-
-export const tsIndexer: typeof createIndexer & { write: typeof writeTsNodes } = Object.assign(createIndexer, {
-  write: writeTsNodes,
-});

package/src/src/ast/nodes/interface.ts

@@ -1,117 +0,0 @@
-import {
-  type AstNodeOptions,
-  type BasicAppendValue,
-  notNullish,
-  type Nullable,
-  type Prettify,
-  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 TsDecorator, tsDecorator } from './decorator.js';
-import { type TsDoc, tsDoc } from './doc.js';
-import { type TsGenericParameter, tsGenericParameter } from './generic-parameter.js';
-import type { TsIndexer } from './indexer.js';
-import type { TsMethod } from './method.js';
-import type { TsProperty } from './property.js';
-import type { TsReference } from './reference.js';
-
-type Injects = 'doc' | 'decorators' | 'modifiers' | 'name' | 'generics' | 'extends' | 'body' | 'members';
-
-type Options<TBuilder extends SourceBuilder, TInjects extends string = never> = AstNodeOptions<
-  typeof TsNode<TBuilder, TInjects | Injects>,
-  {
-    doc?: Nullable<TsDoc<TBuilder>>;
-    decorators?: Nullable<Nullable<TsDecorator<TBuilder>>[]>;
-    export?: Nullable<boolean>;
-    name: string;
-    generics?: Nullable<Nullable<TsGenericParameter<TBuilder> | BasicAppendValue<TBuilder>>[]>;
-    extends?: Nullable<Nullable<TsReference<TBuilder> | BasicAppendValue<TBuilder>>[]>;
-    members?: Nullable<Nullable<Member<TBuilder>>[]>;
-  }
->;
-
-type Member<TBuilder extends SourceBuilder> =
-  | TsIndexer<TBuilder>
-  | TsProperty<TBuilder>
-  | TsMethod<TBuilder>
-  | BasicAppendValue<TBuilder>;
-
-export class TsInterface<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
-  TBuilder,
-  TInjects | Injects
-> {
-  public doc: TsDoc<TBuilder> | null;
-  public decorators: TsDecorator<TBuilder>[];
-  public export: boolean;
-  public name: string;
-  public generics: (TsGenericParameter<TBuilder> | BasicAppendValue<TBuilder>)[];
-  public extends: (TsReference<TBuilder> | BasicAppendValue<TBuilder>)[];
-  public members: Member<TBuilder>[];
-
-  constructor(options: Options<TBuilder, TInjects>) {
-    super(options);
-    this.doc = options.doc ?? null;
-    this.decorators = options.decorators?.filter(notNullish) ?? [];
-    this.export = options.export ?? false;
-    this.name = options.name;
-    this.generics = options.generics?.filter(notNullish) ?? [];
-    this.extends = options.extends?.filter(notNullish) ?? [];
-    this.members = options.members?.filter(notNullish) ?? [];
-  }
-
-  protected override onWrite(builder: TBuilder): void {
-    builder.append(this.inject.beforeDoc);
-    tsDoc.write(builder, tsDoc.get(this.doc, { generics: this.generics }));
-    builder.append(this.inject.afterDoc);
-
-    builder.append(this.inject.beforeDecorators);
-    tsDecorator.write(builder, this.decorators, { multiline: true });
-    builder.append(this.inject.afterDecorators);
-
-    builder.append(this.inject.beforeModifiers);
-    if (this.export) builder.append('export ');
-    builder.append(this.inject.afterModifiers);
-
-    builder.append('interface ');
-    builder.append(this.inject.beforeName, this.name, this.inject.afterName);
-
-    builder.append(this.inject.beforeGenerics);
-    tsGenericParameter.write(builder, this.generics);
-    builder.append(this.inject.afterGenerics);
-
-    if (this.extends.length > 0) {
-      builder.append(' extends ');
-      builder.append(this.inject.beforeExtends);
-      writeTsNodes(builder, this.extends, { separator: ', ' });
-      builder.append(this.inject.afterExtends);
-    }
-
-    builder.append(' ');
-
-    builder.append(this.inject.beforeBody);
-    builder.parenthesize(
-      '{}',
-      (b) => {
-        b.append(this.inject.beforeMembers);
-        writeTsMembers(b, this.members);
-        b.append(this.inject.afterMembers);
-      },
-      { multiline: this.members.length > 0 },
-    );
-    builder.append(this.inject.afterBody);
-
-    builder.appendLine();
-  }
-}
-
-const createInterface = <TBuilder extends SourceBuilder>(
-  name: Options<TBuilder>['name'],
-  options?: Prettify<Omit<Options<TBuilder>, 'name'>>,
-): TsInterface<TBuilder> => new TsInterface<TBuilder>({ ...options, name });
-
-export const tsInterface: typeof createInterface & { write: typeof writeTsNodes } = Object.assign(createInterface, {
-  write: writeTsNodes,
-});

package/src/src/ast/nodes/intersection-type.ts

@@ -1,67 +0,0 @@
-import { type AstNodeOptions, notNullish, type Nullable, type Prettify, type SourceBuilder } from '@goast/core';
-
-import { TsNode } from '../node.js';
-import { writeTsNode, 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>,
-  {
-    types: Nullable<TsType<TBuilder>>[];
-  }
->;
-
-export class TsIntersectionType<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
-  TBuilder,
-  TInjects | Injects
-> {
-  public types: TsType<TBuilder>[];
-
-  constructor(options: Options<TBuilder, TInjects>) {
-    super(options);
-    this.types = options.types.filter(notNullish);
-  }
-
-  protected override onWrite(builder: TBuilder): void {
-    const types = this.types.length === 0 ? ['unknown'] : resolveNestedIntersectionTypes(this);
-    if (types.length === 1) {
-      writeTsNode(builder, types[0]);
-    } else {
-      const multiline = types.length > 3;
-      if (multiline) {
-        builder.appendLine().append('& ');
-      }
-      builder.forEach(types, (b, t) => b.parenthesize('()', (b) => writeTsNode(b, t)), {
-        separator: multiline ? '\n& ' : ' & ',
-      });
-    }
-  }
-}
-
-const createIntersectionType = <TBuilder extends SourceBuilder>(
-  types: Options<TBuilder>['types'],
-  options?: Prettify<Omit<Options<TBuilder>, 'types'>>,
-): TsIntersectionType<TBuilder> => new TsIntersectionType<TBuilder>({ ...options, types });
-
-export const tsIntersectionType: typeof createIntersectionType & { write: typeof writeTsNodes } = Object.assign(
-  createIntersectionType,
-  {
-    write: writeTsNodes,
-  },
-);
-
-function resolveNestedIntersectionTypes<TBuilder extends SourceBuilder>(
-  node: TsIntersectionType<TBuilder>,
-): TsType<TBuilder>[] {
-  const types: TsType<TBuilder>[] = [];
-  for (const type of node.types) {
-    if (type instanceof TsIntersectionType) {
-      types.push(...resolveNestedIntersectionTypes(type));
-    } else {
-      types.push(type);
-    }
-  }
-  return types;
-}

package/src/src/ast/nodes/lookup-type.ts

@@ -1,53 +0,0 @@
-import type { AstNodeOptions, SourceBuilder } from '@goast/core';
-
-import { TsNode } from '../node.js';
-import { writeTsNode, writeTsNodes } from '../utils/write-ts-nodes.js';
-import type { TsType } from './types.js';
-
-type Injects = 'type' | 'index';
-
-type Options<TBuilder extends SourceBuilder, TInjects extends string = never> = AstNodeOptions<
-  typeof TsNode<TBuilder, TInjects | Injects>,
-  {
-    type: TsType<TBuilder>;
-    index: TsType<TBuilder>;
-  }
->;
-
-export class TsLookupType<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
-  TBuilder,
-  TInjects | Injects
-> {
-  public type: TsType<TBuilder>;
-  public index: TsType<TBuilder>;
-
-  constructor(options: Options<TBuilder, TInjects>) {
-    super(options);
-    this.type = options.type;
-    this.index = options.index;
-  }
-
-  protected override onWrite(builder: TBuilder): void {
-    builder
-      .parenthesize('()', (b) => {
-        b.append(this.inject.beforeType);
-        writeTsNode(b, this.type);
-        b.append(this.inject.afterType);
-      })
-      .parenthesize('[]', (b) => {
-        b.append(this.inject.beforeIndex);
-        writeTsNode(b, this.index);
-        b.append(this.inject.afterIndex);
-      });
-  }
-}
-
-const createLookupType = <TBuilder extends SourceBuilder>(
-  type: Options<TBuilder>['type'],
-  index: Options<TBuilder>['index'],
-  options?: Omit<Options<TBuilder>, 'type' | 'index'>,
-): TsLookupType<TBuilder> => new TsLookupType<TBuilder>({ ...options, type, index });
-
-export const tsLookupType: typeof createLookupType & { write: typeof writeTsNodes } = Object.assign(createLookupType, {
-  write: writeTsNodes,
-});