fix: update output handling in plugins and add output documentation

Author: max-scopp

packages/openapi-ts/src/generate/legacy/output.ts

@@ -88,7 +88,7 @@ export const generateLegacyOutput = async ({
 
   for (const name of config.pluginOrder) {
     const plugin = config.plugins[name]!;
-    const outputParts = (plugin.output ?? '').toString().split('/');
+    const outputParts = (plugin.output ?? '').split('/');
     const outputDir = path.resolve(
       config.output.path,
       ...outputParts.slice(0, outputParts.length - 1),

packages/openapi-ts/src/ir/context.ts

@@ -142,7 +142,7 @@ export class IRContext<Spec extends Record<string, any> = any> {
       dependencies: plugin.dependencies ?? [],
       handler: plugin.handler,
       name: plugin.name,
-      output: plugin.output! as string,
+      output: plugin.output!,
     });
     this.plugins[instance.name] = instance;
     return instance;

packages/openapi-ts/src/plugins/@angular/common/types.d.ts

@@ -56,6 +56,13 @@ export type UserConfig = Plugin.Name<'@angular/common'> & {
    * Options for generating HTTP resource APIs.
    */
   httpResource?: AngularHttpResourceOptions;
+
+  /**
+   * Name of the generated file.
+   *
+   * @default '@angular/common'
+   */
+  output?: string;
 };
 
 export type AngularCommonPlugin = DefinePlugin<UserConfig, UserConfig>;