@goast/core 0.5.3 → 0.6.0-beta.2

package/script/src/utils/string.utils.d.ts

@@ -109,6 +109,25 @@ export declare function toCustomCase(str: Nullable<string>, options: CustomCaseO
  * @param str The string to escape.
  */
 export declare function escapeRegExp(str: string): string;
+/**
+ * Compares two strings for sorting, case-insensitively, without any dependency on the host locale.
+ *
+ * Deliberately not `String.prototype.localeCompare`: its collation depends on the host locale and ICU
+ * version, so the same input would sort differently on different machines — which would make
+ * generated output non-reproducible. `toLowerCase` is Unicode default case conversion and carries no
+ * locale dependency.
+ *
+ * Comparison is case-insensitive so that, for example, `awaitBody` sorts alphabetically beside
+ * `WebClient` rather than after every capitalized name. Strings differing only in case fall back to a
+ * case-sensitive comparison, so their relative order is still stable. Non-ASCII characters order by
+ * code point rather than alphabetically — `Ähre` sorts after `Zebra` — which is less pretty than
+ * locale collation but entirely reproducible.
+ *
+ * @param a The first string.
+ * @param b The second string.
+ * @returns A negative number if `a` sorts first, a positive number if `b` does, otherwise 0.
+ */
+export declare function compareString(a: string, b: string): number;
 /**
  * Removes characters from a string and, if necessary, inserts new characters in their place, returning the spliced string.
  * @param str The string to splice.

package/script/src/utils/string.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string.utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/string.utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"string.utils.d.ts","sourceRoot":"","sources":["../../../src/src/utils/string.utils.ts"],"names":[],"mappings":"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"}

package/script/src/utils/string.utils.js

@@ -14,6 +14,7 @@ exports.toKebabCase = toKebabCase;
 exports.toSnakeCase = toSnakeCase;
 exports.toCustomCase = toCustomCase;
 exports.escapeRegExp = escapeRegExp;
+exports.compareString = compareString;
 exports.spliceString = spliceString;
 exports.trimIndent = trimIndent;
 exports.trimEnd = trimEnd;
@@ -267,6 +268,31 @@ function toCustomCase(str, options) {
 function escapeRegExp(str) {
     return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
+/**
+ * Compares two strings for sorting, case-insensitively, without any dependency on the host locale.
+ *
+ * Deliberately not `String.prototype.localeCompare`: its collation depends on the host locale and ICU
+ * version, so the same input would sort differently on different machines — which would make
+ * generated output non-reproducible. `toLowerCase` is Unicode default case conversion and carries no
+ * locale dependency.
+ *
+ * Comparison is case-insensitive so that, for example, `awaitBody` sorts alphabetically beside
+ * `WebClient` rather than after every capitalized name. Strings differing only in case fall back to a
+ * case-sensitive comparison, so their relative order is still stable. Non-ASCII characters order by
+ * code point rather than alphabetically — `Ähre` sorts after `Zebra` — which is less pretty than
+ * locale collation but entirely reproducible.
+ *
+ * @param a The first string.
+ * @param b The second string.
+ * @returns A negative number if `a` sorts first, a positive number if `b` does, otherwise 0.
+ */
+function compareString(a, b) {
+    const lowerA = a.toLowerCase();
+    const lowerB = b.toLowerCase();
+    if (lowerA !== lowerB)
+        return lowerA < lowerB ? -1 : 1;
+    return a < b ? -1 : a > b ? 1 : 0;
+}
 /**
  * Removes characters from a string and, if necessary, inserts new characters in their place, returning the spliced string.
  * @param str The string to splice.

package/src/_dnt.shims.ts

@@ -1,69 +0,0 @@
-import { fetch, File, FormData, Headers, Request, Response } from "undici";
-export { fetch, File, FormData, Headers, Request, Response, type BodyInit, type HeadersInit, type ReferrerPolicy, type RequestInit, type RequestCache, type RequestMode, type RequestRedirect, type ResponseInit } from "undici";
-
-const dntGlobals = {
-  fetch,
-  File,
-  FormData,
-  Headers,
-  Request,
-  Response,
-};
-export const dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
-
-function createMergeProxy<T extends object, U extends object>(
-  baseObj: T,
-  extObj: U,
-): Omit<T, keyof U> & U {
-  return new Proxy(baseObj, {
-    get(_target, prop, _receiver) {
-      if (prop in extObj) {
-        return (extObj as any)[prop];
-      } else {
-        return (baseObj as any)[prop];
-      }
-    },
-    set(_target, prop, value) {
-      if (prop in extObj) {
-        delete (extObj as any)[prop];
-      }
-      (baseObj as any)[prop] = value;
-      return true;
-    },
-    deleteProperty(_target, prop) {
-      let success = false;
-      if (prop in extObj) {
-        delete (extObj as any)[prop];
-        success = true;
-      }
-      if (prop in baseObj) {
-        delete (baseObj as any)[prop];
-        success = true;
-      }
-      return success;
-    },
-    ownKeys(_target) {
-      const baseKeys = Reflect.ownKeys(baseObj);
-      const extKeys = Reflect.ownKeys(extObj);
-      const extKeysSet = new Set(extKeys);
-      return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
-    },
-    defineProperty(_target, prop, desc) {
-      if (prop in extObj) {
-        delete (extObj as any)[prop];
-      }
-      Reflect.defineProperty(baseObj, prop, desc);
-      return true;
-    },
-    getOwnPropertyDescriptor(_target, prop) {
-      if (prop in extObj) {
-        return Reflect.getOwnPropertyDescriptor(extObj, prop);
-      } else {
-        return Reflect.getOwnPropertyDescriptor(baseObj, prop);
-      }
-    },
-    has(_target, prop) {
-      return prop in extObj || prop in baseObj;
-    },
-  }) as any;
-}

package/src/mod.ts

@@ -1,35 +0,0 @@
-export * from './src/ast/node.js';
-
-export * from './src/codegen/config.js';
-export * from './src/codegen/endpoints-generator.js';
-export * from './src/codegen/generator.js';
-export * from './src/codegen/schemas-generator.js';
-export * from './src/codegen/services-generator.js';
-export * from './src/codegen/types.js';
-
-export * from './src/parse/openapi-types.js';
-export * from './src/parse/parser.js';
-export * from './src/parse/types.js';
-
-export * from './src/transform/api-types.js';
-export * from './src/transform/transformer.js';
-
-export * from './src/utils/api-data.utils.js';
-export * from './src/utils/array.utils.js';
-export * from './src/utils/asset-manager.js';
-export * from './src/utils/class.utils.js';
-export * from './src/utils/common.utils.js';
-export * from './src/utils/endpoint.utils.js';
-export * from './src/utils/error.utils.js';
-export * from './src/utils/factory.js';
-export * from './src/utils/file-system.utils.js';
-export * from './src/utils/generator.utils.js';
-export * from './src/utils/object.utils.js';
-export * from './src/utils/schema.utils.js';
-export * from './src/utils/source-builder.js';
-export * from './src/utils/string-builder/options.js';
-export { type AppendParam, StringBuilder } from './src/utils/string-builder/string-builder.js';
-export * from './src/utils/string-builder/utils.js';
-export * from './src/utils/string.utils.js';
-export * from './src/utils/string.utils.types.js';
-export * from './src/utils/type.utils.js';

package/src/src/ast/node.ts

@@ -1,46 +0,0 @@
-import type { StringBuilder } from '../utils/string-builder/string-builder.js';
-import type { AppendValue } from '../utils/string-builder/utils.js';
-import type { Prettify } from '../utils/type.utils.js';
-
-const NODE_HISTORY_SYMBOL = Symbol('node-history');
-type BuilderWithHistory<T extends StringBuilder = StringBuilder> = T & { [NODE_HISTORY_SYMBOL]?: AstNode[] };
-
-export type AstNodeInject<TBuilder extends StringBuilder, TInjects extends string> = {
-  [K in `${'after' | 'before'}${Capitalize<TInjects>}`]?: AppendValue<TBuilder>;
-};
-
-export type AstNodeOptions<
-  // deno-lint-ignore no-explicit-any
-  TBase extends abstract new (...args: any) => any,
-  // deno-lint-ignore ban-types
-  TExtensions extends object = {},
-> = Prettify<TExtensions & ConstructorParameters<TBase>[0]>;
-
-export abstract class AstNode<TBuilder extends StringBuilder = StringBuilder, TInjects extends string = never> {
-  public inject: AstNodeInject<TBuilder, TInjects | ''>;
-
-  constructor(options: { inject?: AstNode<TBuilder, TInjects>['inject'] }) {
-    this.inject = options.inject ?? {};
-  }
-
-  public write(builder: TBuilder): void {
-    let history = (builder as BuilderWithHistory)[NODE_HISTORY_SYMBOL];
-    if (!history) {
-      history = [];
-      (builder as BuilderWithHistory)[NODE_HISTORY_SYMBOL] = history;
-    }
-
-    history.push(this);
-    builder.append(this.inject.before);
-    this.onWrite(builder);
-    builder.append(this.inject.after);
-    history.pop();
-  }
-
-  protected getParentNode(builder: TBuilder): AstNode | undefined {
-    const history = (builder as BuilderWithHistory)[NODE_HISTORY_SYMBOL];
-    return history?.at(-2);
-  }
-
-  protected abstract onWrite(builder: TBuilder): void;
-}

package/src/src/codegen/config.ts

@@ -1,41 +0,0 @@
-import type { OpenApiParserOptions } from '../parse/types.js';
-import { defaultOpenApiTransformerOptions } from '../transform/types.js';
-import { defaultSourceBuilderOptions, type SourceBuilderOptions } from '../utils/source-builder.js';
-
-export type OpenApiGeneratorConfig =
-  & SourceBuilderOptions
-  & OpenApiParserOptions
-  & {
-    /**
-     * The directory where the generated files should be saved.
-     * @default 'generated'
-     */
-    outputDir: string;
-
-    /**
-     * Whether to clear the output directory before generating the files.
-     * @default true
-     */
-    clearOutputDir: boolean;
-
-    /**
-     * How to handle existing files in the output directory.
-     * - 'override': overwrite existing files.
-     * - 'skip': skip generating files that already exist.
-     * - 'error': throw an error if a file already exists.
-     *
-     * Is is recommended to use `'error'` to prevent issues of two schemas generating the same file and overwriting each other.
-     * If `clearOutputDir` is set to `false`, it is recommended to use `'override'` to ensure that the generated files are up to date.
-     * @default 'error'
-     */
-    existingFileBehavior: 'override' | 'skip' | 'error';
-  };
-
-export const defaultOpenApiGeneratorConfig: OpenApiGeneratorConfig = {
-  ...defaultSourceBuilderOptions,
-  ...defaultOpenApiTransformerOptions,
-
-  outputDir: 'generated',
-  clearOutputDir: true,
-  existingFileBehavior: 'error',
-};

package/src/src/codegen/endpoints-generator.ts

@@ -1,72 +0,0 @@
-import type { ApiEndpoint } from '../transform/api-types.js';
-import type { MaybePromise } from '../utils/type.utils.js';
-import { type DefaultGenerationProviderConfig, OpenApiGenerationProviderBase } from './generator.js';
-import { addSourceIfTest } from './internal-utils.js';
-import type {
-  AnyConfig,
-  OpenApiGenerationProviderContext,
-  OpenApiGeneratorContext,
-  OpenApiGeneratorInput,
-  OpenApiGeneratorOutput,
-} from './types.js';
-
-export type OpenApiEndpointsGenerationProviderContext<
-  TInput extends OpenApiGeneratorInput,
-  TOutput extends OpenApiGeneratorOutput,
-  TConfig extends AnyConfig,
-  TEndpointOutput extends OpenApiGeneratorOutput,
-> = OpenApiGenerationProviderContext<TInput, TConfig> & {
-  existingEndpointResults: Map<string, TEndpointOutput>;
-  output: TOutput;
-};
-
-export abstract class OpenApiEndpointsGenerationProviderBase<
-  TInput extends OpenApiGeneratorInput,
-  TOutput extends OpenApiGeneratorOutput,
-  TConfig extends AnyConfig,
-  TEndpointOutput extends OpenApiGeneratorOutput,
-  TContext extends OpenApiEndpointsGenerationProviderContext<TInput, TOutput, TConfig, TEndpointOutput>,
-> extends OpenApiGenerationProviderBase<TInput, TOutput, TConfig, TContext> {
-  protected override getProviderContext(
-    context: OpenApiGeneratorContext<TInput>,
-    config: Partial<TConfig> | undefined,
-    defaultConfig: DefaultGenerationProviderConfig<TConfig>,
-  ): OpenApiEndpointsGenerationProviderContext<TInput, TOutput, TConfig, TEndpointOutput> {
-    const ctx = super.getProviderContext(context, config, defaultConfig);
-    return Object.assign(ctx, {
-      existingEndpointResults: new Map<string, TEndpointOutput>(),
-      output: this.initResult(ctx),
-    });
-  }
-
-  protected override async onGenerate(ctx: TContext): Promise<TOutput> {
-    for (const endpoint of ctx.data.endpoints) {
-      await this.getEndpointResult(ctx, endpoint);
-    }
-
-    await this.generateAdditionalFiles(ctx);
-
-    return ctx.output;
-  }
-
-  public async getEndpointResult(ctx: TContext, endpoint: ApiEndpoint): Promise<TEndpointOutput> {
-    const existingResult = ctx.existingEndpointResults.get(endpoint.id);
-    if (existingResult) return existingResult;
-
-    const result = await this.generateEndpoint(ctx, endpoint);
-    addSourceIfTest(ctx.config, result, () => `${endpoint.$src.file}#${endpoint.$src.path}`);
-    this.addEndpointResult(ctx, endpoint, result);
-    return result;
-  }
-
-  protected abstract initResult(ctx: OpenApiGenerationProviderContext<TInput, TConfig>): TOutput;
-
-  protected abstract generateEndpoint(ctx: TContext, endpoint: ApiEndpoint): Promise<TEndpointOutput>;
-
-  protected abstract addEndpointResult(ctx: TContext, endpoint: ApiEndpoint, result: TEndpointOutput): void;
-
-  // deno-lint-ignore no-unused-vars
-  protected generateAdditionalFiles(ctx: TContext): MaybePromise<void> {
-    // Override if needed
-  }
-}

package/src/src/codegen/generator.ts

@@ -1,192 +0,0 @@
-import { resolve } from 'node:path';
-
-
-import fs from 'fs-extra';
-
-import { OpenApiParser } from '../parse/parser.js';
-import type { ApiData } from '../transform/api-types.js';
-import { ActionProvider } from '../utils/action-provider.js';
-import { type DirectoryScanOptions, getFiles } from '../utils/file-system.utils.js';
-import type { EmptyConstructor, Merge } from '../utils/type.utils.js';
-import { defaultOpenApiGeneratorConfig, type OpenApiGeneratorConfig } from './config.js';
-import type {
-  AnyConfig,
-  OpenApiGenerationProvider,
-  OpenApiGenerationProviderContext,
-  OpenApiGenerationProviderFn,
-  OpenApiGeneratorContext,
-  OpenApiGeneratorInput,
-  OpenApiGeneratorOutput,
-} from './types.js';
-
-type OpenApiGenerationProviders = {
-  provider: ActionProvider<OpenApiGenerationProviderFn>;
-  config: AnyConfig | undefined;
-}[];
-
-type VInput<TActual, TExpected> = TExpected extends TActual ? TActual
-  : { __error: 'The current output of the generator does not satisfy the input of this generator.' };
-
-class _OpenApiGenerator<TOutput extends OpenApiGeneratorInput> {
-  private readonly _providers: OpenApiGenerationProviders;
-  private readonly _config: OpenApiGeneratorConfig;
-  private readonly _parser: OpenApiParser;
-
-  constructor(config: OpenApiGeneratorConfig, providers: OpenApiGenerationProviders, parser: OpenApiParser) {
-    this._providers = providers;
-    this._config = config;
-    this._parser = parser;
-  }
-
-  public use<PInput extends OpenApiGeneratorInput, POutput extends OpenApiGeneratorOutput, PConfig extends AnyConfig>(
-    provider: ActionProvider<OpenApiGenerationProviderFn<VInput<PInput, TOutput>, POutput, PConfig>>,
-    config?: Partial<PConfig>,
-  ): _OpenApiGenerator<Merge<[TOutput, POutput]>> {
-    // deno-lint-ignore no-explicit-any
-    this._providers.push({ provider: provider as any, config });
-    return new _OpenApiGenerator<Merge<[TOutput, POutput]>>(this._config, [...this._providers], this._parser);
-  }
-
-  public useType<
-    PInput extends OpenApiGeneratorInput,
-    POutput extends OpenApiGeneratorOutput,
-    PConfig extends AnyConfig,
-  >(
-    type: EmptyConstructor<OpenApiGenerationProvider<VInput<PInput, TOutput>, POutput, PConfig>>,
-    config?: Partial<PConfig>,
-  ): _OpenApiGenerator<Merge<[TOutput, POutput]>> {
-    return this.use(ActionProvider.fromType(type, 'generate'), config);
-  }
-
-  public useFn<PInput extends TOutput, POutput extends OpenApiGeneratorOutput, PConfig extends AnyConfig>(
-    fn: OpenApiGenerationProviderFn<VInput<PInput, TOutput>, POutput, PConfig>,
-    config?: Partial<PConfig>,
-  ): _OpenApiGenerator<Merge<[TOutput, POutput]>> {
-    return this.use(ActionProvider.fromFn(fn), config);
-  }
-
-  public useValue<PInput extends TOutput, POutput extends OpenApiGeneratorOutput, PConfig extends AnyConfig>(
-    value: OpenApiGenerationProvider<VInput<PInput, TOutput>, POutput, PConfig>,
-    config?: Partial<PConfig>,
-  ): _OpenApiGenerator<Merge<[TOutput, POutput]>> {
-    return this.use(ActionProvider.fromValue(value, 'generate'), config);
-  }
-
-  public async generate<T extends ApiData>(data: T): Promise<TOutput> {
-    const absOutputPath = resolve(this._config.outputDir);
-    if (this._config.clearOutputDir) {
-      await fs.emptyDir(absOutputPath);
-    } else {
-      await fs.ensureDir(absOutputPath);
-    }
-
-    this._providers.forEach(({ config }) => {
-      if (config && 'outputDir' in config && config.outputDir && typeof config.outputDir === 'string') {
-        const providerOutputDir = resolve(config.outputDir);
-        if (this._config.clearOutputDir) {
-          fs.emptyDirSync(providerOutputDir);
-        } else {
-          fs.ensureDirSync(providerOutputDir);
-        }
-      }
-    });
-
-    let input = {} as TOutput;
-    for (const generator of this._providers) {
-      const context = {
-        data,
-        input,
-        config: this._config,
-      };
-
-      const result = await generator.provider.run(context, generator.config);
-      if (result) {
-        input = mergeDeep(input, result);
-      }
-    }
-
-    return input;
-  }
-
-  public async parseAndGenerate(...fileNames: (string | string[])[]): Promise<TOutput> {
-    const data = await this._parser.parseApisAndTransform(...fileNames);
-    return await this.generate(data);
-  }
-
-  public async parseAndGenerateFromDir(dir: string, options?: Partial<DirectoryScanOptions>): Promise<TOutput> {
-    const filter = (file: string) =>
-      (file.endsWith('.yml') || file.endsWith('.yaml') || file.endsWith('.json')) && (options?.filter?.(file) ?? true);
-    return this.parseAndGenerate(...(await getFiles(dir, { ...options, filter })));
-  }
-}
-
-// deno-lint-ignore ban-types
-export class OpenApiGenerator extends _OpenApiGenerator<{}> {
-  constructor(config?: Partial<OpenApiGeneratorConfig>) {
-    super(
-      { ...defaultOpenApiGeneratorConfig, ...config },
-      [],
-      new OpenApiParser({ ...defaultOpenApiGeneratorConfig, ...config }),
-    );
-  }
-}
-
-function mergeDeep<T extends Record<string, unknown>, U extends Record<string, unknown>[]>(
-  target: T,
-  ...sources: U
-): T & U[number] {
-  if (!sources.length) return target;
-  const source = sources.shift();
-
-  for (const key in source) {
-    const value = source[key];
-    if (value && typeof value === 'object') {
-      if (!target[key]) Object.assign(target, { [key]: value });
-      else mergeDeep(target[key] as Record<string, unknown>, value as Record<string, unknown>);
-    } else if (Array.isArray(value)) {
-      if (!target[key]) Object.assign(target, { [key]: value });
-      else Object.assign(target, { [key]: [...(target[key] as Iterable<unknown>), ...value] });
-    } else {
-      Object.assign(target, { [key]: value });
-    }
-  }
-
-  return mergeDeep(target, ...sources);
-}
-
-export type DefaultGenerationProviderConfig<T extends AnyConfig> =
-  & Omit<T, keyof OpenApiGeneratorConfig>
-  & Partial<Pick<T, keyof OpenApiGeneratorConfig>>;
-
-export abstract class OpenApiGenerationProviderBase<
-  TInput extends OpenApiGeneratorInput,
-  TOutput extends OpenApiGeneratorOutput,
-  TConfig extends AnyConfig,
-  TContext extends OpenApiGenerationProviderContext<TInput, TConfig>,
-> implements OpenApiGenerationProvider<TInput, TOutput, TConfig> {
-  public async generate(
-    context: OpenApiGeneratorContext<TInput>,
-    config?: Partial<TConfig> | undefined,
-  ): Promise<TOutput> {
-    const ctx = await this.buildContext(context, config);
-    return await this.onGenerate(ctx);
-  }
-
-  protected getProviderContext(
-    context: OpenApiGeneratorContext<TInput>,
-    config: Partial<TConfig> | undefined,
-    defaultConfig: DefaultGenerationProviderConfig<TConfig>,
-  ): OpenApiGenerationProviderContext<TInput, TConfig> {
-    const c = { ...context.config, ...defaultConfig, ...config } as unknown as OpenApiGeneratorConfig & TConfig;
-    return Object.assign(context, {
-      config: c,
-    });
-  }
-
-  protected abstract buildContext(
-    context: OpenApiGeneratorContext<TInput>,
-    config?: Partial<TConfig> | undefined,
-  ): TContext | Promise<TContext>;
-
-  protected abstract onGenerate(ctx: TContext): TOutput | Promise<TOutput>;
-}

package/src/src/codegen/internal-utils.ts

@@ -1,6 +0,0 @@
-// deno-lint-ignore no-explicit-any
-export function addSourceIfTest(config: any, result: any, sourceFn: () => any) {
-  if (config.__test__ && !result.__source__) {
-    result.__source__ = sourceFn();
-  }
-}

package/src/src/codegen/schemas-generator.ts

@@ -1,87 +0,0 @@
-import type { ApiSchema } from '../transform/api-types.js';
-import { getSchemaReference } from '../utils/schema.utils.js';
-import type { MaybePromise } from '../utils/type.utils.js';
-import { type DefaultGenerationProviderConfig, OpenApiGenerationProviderBase } from './generator.js';
-import { addSourceIfTest } from './internal-utils.js';
-import type {
-  AnyConfig,
-  OpenApiGenerationProviderContext,
-  OpenApiGeneratorContext,
-  OpenApiGeneratorInput,
-  OpenApiGeneratorOutput,
-} from './types.js';
-
-export type OpenApiSchemasGenerationProviderContext<
-  TInput extends OpenApiGeneratorInput,
-  TOutput extends OpenApiGeneratorOutput,
-  TConfig extends AnyConfig,
-  TSchemaOutput extends OpenApiGeneratorOutput,
-> = OpenApiGenerationProviderContext<TInput, TConfig> & {
-  existingSchemaResults: Map<string, TSchemaOutput>;
-  output: TOutput;
-};
-
-export abstract class OpenApiSchemasGenerationProviderBase<
-  TInput extends OpenApiGeneratorInput,
-  TOutput extends OpenApiGeneratorOutput,
-  TConfig extends AnyConfig,
-  TSchemaOutput extends OpenApiGeneratorOutput,
-  TContext extends OpenApiSchemasGenerationProviderContext<TInput, TOutput, TConfig, TSchemaOutput>,
-> extends OpenApiGenerationProviderBase<TInput, TOutput, TConfig, TContext> {
-  protected override getProviderContext(
-    context: OpenApiGeneratorContext<TInput>,
-    config: Partial<TConfig> | undefined,
-    defaultConfig: DefaultGenerationProviderConfig<TConfig>,
-  ): OpenApiSchemasGenerationProviderContext<TInput, TOutput, TConfig, TSchemaOutput> {
-    const ctx = super.getProviderContext(context, config, defaultConfig);
-    return Object.assign(ctx, {
-      existingSchemaResults: new Map<string, TSchemaOutput>(),
-      output: this.initResult(ctx),
-    });
-  }
-
-  protected override async onGenerate(ctx: TContext): Promise<TOutput> {
-    for (const schema of ctx.data.schemas) {
-      await this.getSchemaResult(ctx, schema);
-    }
-
-    await this.generateAdditionalFiles(ctx);
-
-    return ctx.output;
-  }
-
-  public async getSchemaResult(ctx: TContext, schema: ApiSchema): Promise<TSchemaOutput> {
-    const existingResult = ctx.existingSchemaResults.get(schema.id);
-    if (existingResult) return existingResult;
-
-    let result: TSchemaOutput;
-    const reference = this.getSchemaReference(ctx, schema);
-    if (reference) {
-      result = await this.getSchemaResult(ctx, reference);
-    } else {
-      result = await this.generateSchema(ctx, schema);
-    }
-
-    addSourceIfTest(ctx.config, result, () => `${schema.$src.file}#${schema.$src.path}`);
-    ctx.existingSchemaResults.set(schema.id, result);
-    this.addSchemaResult(ctx, schema, result);
-    return result;
-  }
-
-  // deno-lint-ignore no-unused-vars
-  protected getSchemaReference(ctx: TContext, schema: ApiSchema): ApiSchema | undefined {
-    const ref = getSchemaReference(schema, ['description']);
-    return ref.id !== schema.id ? ref : undefined;
-  }
-
-  protected abstract initResult(ctx: OpenApiGenerationProviderContext<TInput, TConfig>): TOutput;
-
-  protected abstract generateSchema(ctx: TContext, schema: ApiSchema): MaybePromise<TSchemaOutput>;
-
-  protected abstract addSchemaResult(ctx: TContext, schema: ApiSchema, result: TSchemaOutput): void;
-
-  // deno-lint-ignore no-unused-vars
-  protected generateAdditionalFiles(ctx: TContext): MaybePromise<void> {
-    // Override if needed
-  }
-}