feat(printer): 添加文件生成警告信息

- 在打印输出中添加了生成文件的警告信息，提示用户不要手动编辑
- 新增了 #printAlert 方法来生成警告信息
- 在 Printer 类的构造方法中添加了 hideAlert 参数，用于控制是否显示警告信息
- 在 printer/types.ts 中添加了 hideAlert 的类型定义

Author: cloudcome

src/printer/index.ts

@@ -1,6 +1,7 @@
 import type { OpenAPILatest } from '../types/openapi';
 import type { OpenApiLatest_Media, OpenApiLatest_Operation, OpenApiLatest_Parameter, OpenApiLatest_PathItem, OpenApiLatest_Request, OpenApiLatest_Response, OpenApiLatest_Schema } from './helpers';
 import type { PrinterConfigs, PrinterOptions } from './types';
+import { pkgName, pkgVersion } from '../const';
 import { OpenAPIVersion } from '../types/openapi';
 import { toImportPath } from '../utils/path';
 import { isString, isUndefined } from '../utils/type-is';
@@ -272,6 +273,7 @@ export class Printer {
       hideHeaders,
       hideHelpers,
       hideFooters,
+      hideAlert,
       hideInfo,
       hideComponents,
       hideImports,
@@ -282,6 +284,7 @@ export class Printer {
 
     return [
       !hideHeaders && header,
+      !hideAlert && this.#printAlert(),
       !hideInfo && this.#printInfo(),
       !hideImports && this.#printImports(),
       !hideHelpers && Printer.helpersCode,
@@ -293,6 +296,20 @@ export class Printer {
       .join('\n\n');
   }
 
+  #printAlert() {
+    return [
+      `/**`,
+      ` * This file is generated by ${pkgName}@${pkgVersion}.`,
+      ` * Please do not edit it manually.`,
+      ` * If you use the following tools, you can refer to the corresponding documentation`,
+      ` * and ignore the check of this file.`,
+      ` * - [ESLint](https://eslint.org/docs/latest/use/configure/ignore)`,
+      ` * - [Prettier](https://prettier.io/docs/en/ignore.html)`,
+      ` * - [Biome](https://biomejs.dev/guides/configure-biome/#ignore-files)`,
+      ` */`,
+    ].join(`\n`);
+  }
+
   #printInfo() {
     const {
       contact,

src/printer/types.ts

@@ -131,6 +131,7 @@ export interface PrinterConfigs {
   hideHeaders?: boolean;
   hideHelpers?: boolean;
   hideFooters?: boolean;
+  hideAlert?: boolean;
   hideInfo?: boolean;
   hideImports?: boolean;
   hideComponents?: boolean;