@goast/typescript 0.8.0 → 0.9.0-beta.1

package/src/src/ast/nodes/doc.ts

@@ -1,102 +0,0 @@
-import {
-  type AstNodeOptions,
-  type BasicAppendValue,
-  createOverwriteProxy,
-  getIsInstanceOf,
-  notNullish,
-  type Nullable,
-  type SourceBuilder,
-} from '@goast/core';
-
-import { TsNode } from '../node.js';
-import { writeTsNodes } from '../utils/write-ts-nodes.js';
-import { type TsDocTag, tsDocTag } from './doc-tag.js';
-import { TsGenericParameter } from './generic-parameter.js';
-import { TsParameter } from './parameter.js';
-
-type Injects = never;
-
-type Options<TBuilder extends SourceBuilder, TInjects extends string = never> = AstNodeOptions<
-  typeof TsNode<TBuilder, TInjects | Injects>,
-  {
-    description?: Nullable<BasicAppendValue<TBuilder>>;
-    tags?: Nullable<Nullable<TsDocTag<TBuilder>>[]>;
-  }
->;
-
-export class TsDoc<TBuilder extends SourceBuilder, TInjects extends string = never>
-  extends TsNode<TBuilder, TInjects | Injects> {
-  public description: BasicAppendValue<TBuilder> | null;
-  public tags: TsDocTag<TBuilder>[];
-
-  constructor(options: Options<TBuilder, TInjects>) {
-    super(options);
-    this.description = options.description ?? null;
-    this.tags = options.tags?.filter(notNullish) ?? [];
-  }
-
-  protected override onWrite(builder: TBuilder): void {
-    if (!this.description && this.tags.length === 0) {
-      return;
-    }
-
-    builder
-      .ensureCurrentLineEmpty()
-      .parenthesize(
-        ['/**', ' */'],
-        (b) =>
-          b.appendWithLinePrefix(' * ', (b) => {
-            if (this.description) {
-              b.append(this.description);
-            }
-
-            if (this.tags.length > 0) {
-              b.ensurePreviousLineEmpty();
-              tsDocTag.write(b, this.tags, { separator: '\n' });
-            }
-          }),
-        { multiline: true, indent: false },
-      )
-      .appendLine();
-  }
-}
-
-const createDoc = <TBuilder extends SourceBuilder>(options?: Options<TBuilder>): TsDoc<TBuilder> =>
-  new TsDoc<TBuilder>(options ?? {});
-
-function getDoc<TBuilder extends SourceBuilder>(
-  baseDoc: TsDoc<TBuilder> | null,
-  options: {
-    parameters?: Nullable<Nullable<TsParameter<TBuilder> | BasicAppendValue<TBuilder>>[]>;
-    generics?: Nullable<Nullable<TsGenericParameter<TBuilder> | BasicAppendValue<TBuilder>>[]>;
-  },
-): TsDoc<TBuilder> | null {
-  const paramsWithDesc = options.parameters
-    ?.filter(getIsInstanceOf(TsParameter<TBuilder>))
-    .filter((x): x is TsParameter<TBuilder> & { description: NonNullable<unknown> } => !!x.description) ?? [];
-  const genericsWithDesc = options.generics
-    ?.filter(getIsInstanceOf(TsGenericParameter<TBuilder>))
-    .filter((x): x is TsGenericParameter<TBuilder> & { description: NonNullable<unknown> } => !!x.description) ?? [];
-  if (paramsWithDesc.length === 0 && genericsWithDesc.length === 0) {
-    return baseDoc;
-  }
-  const doc = baseDoc ? createOverwriteProxy(baseDoc) : createDoc<TBuilder>();
-  const paramTags = paramsWithDesc.map<TsDocTag<TBuilder>>((p) => tsDocTag('param', p.name, p.description));
-  const genericTags = genericsWithDesc.map<TsDocTag<TBuilder>>((p) => tsDocTag('template', p.name, p.description));
-  doc.tags.splice(0, 0, ...genericTags, ...paramTags);
-  return doc;
-}
-
-function isDocEmpty(doc: Nullable<TsDoc<SourceBuilder>>): boolean {
-  return !doc || (!doc.description && doc.tags.length === 0);
-}
-
-export const tsDoc: typeof createDoc & {
-  write: typeof writeTsNodes;
-  get: typeof getDoc;
-  isEmpty: typeof isDocEmpty;
-} = Object.assign(createDoc, {
-  write: writeTsNodes,
-  get: getDoc,
-  isEmpty: isDocEmpty,
-});

package/src/src/ast/nodes/enum-value.ts

@@ -1,72 +0,0 @@
-import type {
-  AppendValue,
-  AstNodeOptions,
-  BasicAppendValue,
-  Nullable,
-  Prettify,
-  SingleOrMultiple,
-  SourceBuilder,
-} from '@goast/core';
-
-import { TsNode } from '../node.js';
-import { writeTsNode, writeTsNodes } from '../utils/write-ts-nodes.js';
-import type { TsDoc } from './doc.js';
-import type { TsString } from './string.js';
-
-type Injects = 'doc' | 'name' | 'value';
-
-type Options<TBuilder extends SourceBuilder, TInjects extends string = never> = AstNodeOptions<
-  typeof TsNode<TBuilder, TInjects | Injects>,
-  {
-    doc?: Nullable<TsDoc<TBuilder>>;
-    name: string;
-    value?: Nullable<TsString<TBuilder> | BasicAppendValue<TBuilder>>;
-  }
->;
-
-export class TsEnumValue<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
-  TBuilder,
-  TInjects | Injects
-> {
-  public doc: TsDoc<TBuilder> | null;
-  public name: string;
-  public value: TsString<TBuilder> | BasicAppendValue<TBuilder> | null;
-
-  constructor(options: Options<TBuilder, TInjects>) {
-    super(options);
-    this.name = options.name;
-    this.doc = options.doc ?? null;
-    this.value = options.value ?? null;
-  }
-
-  protected override onWrite(builder: TBuilder): void {
-    builder.append(this.inject.beforeDoc);
-    this.doc?.write(builder);
-    builder.append(this.inject.afterDoc);
-
-    builder.append(this.inject.beforeName, this.name, this.inject.afterName);
-
-    if (this.value) {
-      builder.append(' = ');
-      builder.append(this.inject.beforeValue);
-      writeTsNode(builder, this.value);
-      builder.append(this.inject.afterValue);
-    }
-  }
-}
-
-const createEnumValue = <TBuilder extends SourceBuilder>(
-  name: Options<TBuilder>['name'],
-  options?: Prettify<Omit<Options<TBuilder>, 'name'>>,
-): TsEnumValue<TBuilder> => new TsEnumValue<TBuilder>({ ...options, name });
-
-const writeEnumValues = <TBuilder extends SourceBuilder>(
-  builder: TBuilder,
-  nodes: SingleOrMultiple<Nullable<TsEnumValue<TBuilder> | AppendValue<TBuilder>>>,
-): void => {
-  writeTsNodes(builder, nodes, { separator: ',\n' });
-};
-
-export const tsEnumValue: typeof createEnumValue & { write: typeof writeEnumValues } = Object.assign(createEnumValue, {
-  write: writeEnumValues,
-});

package/src/src/ast/nodes/enum.ts

@@ -1,77 +0,0 @@
-import { type AstNodeOptions, notNullish, type Nullable, type Prettify, type SourceBuilder } from '@goast/core';
-
-import { TsNode } from '../node.js';
-import { writeTsNodes } from '../utils/write-ts-nodes.js';
-import type { TsDoc } from './doc.js';
-import { type TsEnumValue, tsEnumValue } from './enum-value.js';
-
-type Injects = 'doc' | 'modifiers' | 'name' | 'body' | 'members';
-
-type Options<TBuilder extends SourceBuilder, TInjects extends string = never> = AstNodeOptions<
-  typeof TsNode<TBuilder, TInjects | Injects>,
-  {
-    doc?: Nullable<TsDoc<TBuilder>>;
-    export?: Nullable<boolean>;
-    const?: Nullable<boolean>;
-    name: string;
-    members?: Nullable<Nullable<TsEnumValue<TBuilder>>[]>;
-  }
->;
-
-export class TsEnum<TBuilder extends SourceBuilder, TInjects extends string = never> extends TsNode<
-  TBuilder,
-  TInjects | Injects
-> {
-  public doc: TsDoc<TBuilder> | null;
-  public export: boolean;
-  public const: boolean;
-  public name: string;
-  public members: TsEnumValue<TBuilder>[];
-
-  constructor(options: Options<TBuilder, TInjects>) {
-    super(options);
-    this.doc = options.doc ?? null;
-    this.export = options.export ?? false;
-    this.const = options.const ?? false;
-    this.name = options.name;
-    this.members = options.members?.filter(notNullish) ?? [];
-  }
-
-  protected override onWrite(builder: TBuilder): void {
-    builder.append(this.inject.beforeDoc);
-    this.doc?.write(builder);
-    builder.append(this.inject.afterDoc);
-
-    builder.append(this.inject.beforeModifiers);
-    if (this.export) builder.append('export ');
-    if (this.const) builder.append('const ');
-    builder.append(this.inject.afterModifiers);
-
-    builder.append('enum ');
-    builder.append(this.inject.beforeName, this.name, this.inject.afterName);
-    builder.append(' ');
-
-    builder.append(this.inject.beforeBody);
-    builder.parenthesize(
-      '{}',
-      (b) => {
-        b.append(this.inject.beforeMembers);
-        tsEnumValue.write(b, this.members);
-        b.append(this.inject.afterMembers);
-      },
-      { multiline: this.members.length > 0 },
-    );
-    builder.append(this.inject.afterBody);
-
-    builder.appendLine();
-  }
-}
-
-const createEnum = <TBuilder extends SourceBuilder>(
-  name: Options<TBuilder>['name'],
-  options?: Prettify<Omit<Options<TBuilder>, 'name'>>,
-): TsEnum<TBuilder> => new TsEnum<TBuilder>({ ...options, name });
-
-export const tsEnum: typeof createEnum & { write: typeof writeTsNodes } = Object.assign(createEnum, {
-  write: writeTsNodes,
-});

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,
-});