@ubean/preset 0.1.12 → 0.2.0

package/dist/index.d.ts

@@ -149,6 +149,340 @@ declare function registerPreset(preset: Preset, meta?: PresetMeta): void;
 declare function getPresetNames(): string[];
 declare function getPresetAliases(): Map<string, string>;
 //#endregion
+//#region src/aws.d.ts
+/**
+ * AWS Lambda preset —— AWS Lambda + API Gateway / Function URL 模式
+ *
+ * 构建输出:`dist/aws/lambda/index.mjs`(Lambda handler)
+ * 预览命令:`sam local start-api`(通过 AWS SAM 本地模拟)
+ * 部署命令:`sam deploy --guided`(交互式部署)
+ *
+ * Lambda handler 签名:
+ * ```typescript
+ * export const handler = async (event, context) => { ... };
+ * ```
+ */
+declare const awsPreset: {
+  extends: string;
+  capabilities: CapabilitySet;
+  entry: string;
+  exportConditions: string[];
+  build: {
+    outputDir: string;
+    format: "esm";
+    externals: string[];
+  };
+  output: {
+    dir: string;
+    serverDir: string;
+    publicDir: string;
+  };
+  runtime: {
+    entry: string;
+    handler: string;
+    compatibilityDate: string;
+  };
+  serve: {
+    host: string;
+    port: number;
+  };
+  commands: {
+    preview: string;
+    deploy: string;
+  };
+  hooks: {
+    'build:before': () => Promise<void>;
+    'build:after': () => Promise<void>;
+  };
+} & {
+  _meta: PresetMeta;
+  name: string;
+};
+/**
+ * AWS SAM 配置文件(`template.yaml`)类型(简化版)
+ *
+ * 完整规范见:https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-specification.html
+ */
+interface AwsSamTemplate {
+  AWSTemplateFormatVersion?: string;
+  Transform?: string;
+  Description?: string;
+  Resources: Record<string, AwsSamResource>;
+  Outputs?: Record<string, {
+    Description?: string;
+    Value: string | Record<string, unknown>;
+    Export?: {
+      Name: string;
+    };
+  }>;
+  Parameters?: Record<string, {
+    Type: string;
+    Default?: string;
+    Description?: string;
+  }>;
+  Globals?: {
+    Function?: {
+      Runtime?: string;
+      MemorySize?: number;
+      Timeout?: number;
+      Environment?: {
+        Variables?: Record<string, string>;
+      };
+      Handler?: string;
+    };
+  };
+}
+interface AwsSamResource {
+  Type: string;
+  Properties: {
+    FunctionName?: string;
+    Handler?: string;
+    Runtime?: string;
+    CodeUri?: string;
+    MemorySize?: number;
+    Timeout?: number;
+    Environment?: {
+      Variables?: Record<string, string>;
+    };
+    Events?: Record<string, {
+      Type: string;
+      Properties: Record<string, unknown>;
+    }>;
+    Policies?: string[];
+    AutoPublishAlias?: string;
+    DeploymentPreference?: {
+      Type: string;
+    };
+    /** 各 SAM 资源类型有不同属性(如 ApiGateway 的 StageName),允许扩展 */
+    [key: string]: unknown;
+  };
+}
+/**
+ * 生成 AWS SAM template.yaml 配置对象
+ */
+declare function generateAwsSamConfig(options: {
+  functionName?: string;
+  handler?: string;
+  runtime?: string;
+  codeUri?: string;
+  memorySize?: number;
+  timeout?: number;
+  environment?: Record<string, string>;
+  apiStage?: string;
+  cronSchedules?: Array<{
+    name: string;
+    schedule: string;
+    enabled?: boolean;
+  }>;
+}): AwsSamTemplate;
+/**
+ * 序列化 AWS SAM template 为 YAML 字符串
+ */
+declare function serializeAwsSamConfig(template: AwsSamTemplate): string;
+//#endregion
+//#region src/azure.d.ts
+/**
+ * Azure Static Web Apps preset
+ *
+ * 构建输出:`dist/azure/functions/index.mjs`(Azure Functions handler)
+ * 预览命令:`swa start`(Azure SWA CLI 本地模拟)
+ * 部署命令:`swa deploy`
+ *
+ * Azure Functions handler 签名:
+ * ```typescript
+ * export default async function handler(context, req) { ... };
+ * ```
+ */
+declare const azurePreset: {
+  extends: string;
+  capabilities: CapabilitySet;
+  entry: string;
+  exportConditions: string[];
+  build: {
+    outputDir: string;
+    format: "esm";
+    externals: string[];
+  };
+  output: {
+    dir: string;
+    serverDir: string;
+    publicDir: string;
+  };
+  runtime: {
+    entry: string;
+    handler: string;
+    compatibilityDate: string;
+  };
+  serve: {
+    host: string;
+    port: number;
+  };
+  commands: {
+    preview: string;
+    deploy: string;
+  };
+  hooks: {
+    'build:before': () => Promise<void>;
+    'build:after': () => Promise<void>;
+  };
+} & {
+  _meta: PresetMeta;
+  name: string;
+};
+/**
+ * Azure Static Web Apps 配置文件(`staticwebapp.config.json`)类型
+ *
+ * 完整规范见:https://learn.microsoft.com/en-us/azure/static-web-apps/configuration
+ */
+interface StaticWebAppConfig {
+  navigationFallback?: {
+    rewrite?: string;
+    redirect?: string;
+    statusCode?: number;
+    exclude?: string[];
+  };
+  routes?: Array<{
+    route: string;
+    rewrite?: string;
+    redirect?: string;
+    statusCode?: number;
+    methods?: string[];
+    headers?: Record<string, string>;
+    allowedRoles?: string[];
+  }>;
+  responseOverrides?: Record<string, {
+    rewrite?: string;
+    redirect?: string;
+    statusCode?: number;
+  }>;
+  mimeTypes?: Record<string, string>;
+  globalHeaders?: Record<string, string>;
+  auth?: {
+    identityProviders?: {
+      azureActiveDirectory?: {
+        registration?: {
+          openIdIssuer?: string;
+          clientIdSettingName?: string;
+          clientSecretSettingName?: string;
+        };
+        userMetadata?: {
+          issuer?: string;
+        };
+      };
+    };
+  };
+  platform?: {
+    apiRuntime?: string;
+    apiRuntimeVersion?: string;
+  };
+}
+/**
+ * 生成 Azure Static Web Apps 配置对象
+ */
+declare function generateStaticWebAppConfig(options: {
+  apiEntry?: string;
+  routes?: Array<{
+    route: string;
+    rewrite?: string;
+    redirect?: string;
+    statusCode?: number;
+    methods?: string[];
+    headers?: Record<string, string>;
+  }>;
+  navigationFallback?: string;
+  globalHeaders?: Record<string, string>;
+  apiRuntime?: string;
+}): StaticWebAppConfig;
+/**
+ * 序列化 staticwebapp.config.json 为 JSON 字符串
+ */
+declare function serializeStaticWebAppConfig(config: StaticWebAppConfig): string;
+//#endregion
+//#region src/bun.d.ts
+/**
+ * Bun preset —— Bun 运行时模式
+ *
+ * 继承 Node preset 的全部能力,使用 Bun 运行时特性:
+ * - 原生 TypeScript 支持(无需编译)
+ * - 内置 SQLite (bun:sqlite)
+ * - 原生 WebSocket (Bun.serve)
+ * - 更快的启动和运行速度
+ *
+ * 构建输出:`dist/bun/server/index.mjs`
+ * 预览命令:`bun run dist/bun/server/index.mjs`
+ * 部署命令:`bun run dist/bun/server/index.mjs`
+ */
+declare const bunPreset: {
+  extends: string;
+  capabilities: CapabilitySet;
+  entry: string;
+  exportConditions: string[];
+  build: {
+    outputDir: string;
+    format: "esm";
+    externals: string[];
+  };
+  output: {
+    dir: string;
+    serverDir: string;
+    publicDir: string;
+  };
+  runtime: {
+    entry: string;
+    handler: string;
+    compatibilityDate: string;
+  };
+  serve: {
+    host: string;
+    port: number;
+  };
+  commands: {
+    preview: string;
+    deploy: string;
+  };
+  hooks: {
+    'build:before': () => Promise<void>;
+    'build:after': () => Promise<void>;
+  };
+} & {
+  _meta: PresetMeta;
+  name: string;
+};
+/**
+ * Bun 配置文件类型
+ *
+ * Bun 使用 `bunfig.toml` 进行配置(可选,大多数场景无需配置)。
+ */
+interface BunfigConfig {
+  install?: {
+    registry?: string;
+    lockfile?: boolean;
+    production?: boolean;
+  };
+  test?: {
+    coverage?: boolean;
+    coverageThreshold?: number;
+    preload?: string[];
+  };
+  macro?: Record<string, string>;
+  bun?: {
+    framework?: boolean;
+  };
+}
+/**
+ * 生成 Bunfig 配置对象
+ */
+declare function generateBunfigConfig(options: {
+  registry?: string;
+  lockfile?: boolean;
+  production?: boolean;
+  preload?: string[];
+}): BunfigConfig;
+/**
+ * 序列化 Bunfig 配置为 TOML 字符串
+ */
+declare function serializeBunfigConfig(config: BunfigConfig): string;
+//#endregion
 //#region src/cloudflare.d.ts
 declare const cloudflarePreset: {
   capabilities: CapabilitySet;
@@ -274,6 +608,206 @@ declare function generateWranglerConfig(options: {
 }): WranglerConfig;
 declare function serializeWranglerToml(config: WranglerConfig): string;
 //#endregion
+//#region src/deno.d.ts
+/**
+ * Deno preset —— Deno 运行时模式
+ *
+ * 继承 Node preset 的配置,使用 Deno 运行时特性:
+ * - 原生 TypeScript 支持(无需编译)
+ * - 内置 Deno KV / Deno.cron / Deno.Queue
+ * - 原生 WebSocket (Deno.serve)
+ * - 安全沙箱(默认无文件系统/网络访问,需显式授权)
+ *
+ * 构建输出:`dist/deno/server/index.mjs`
+ * 预览命令:`deno run --allow-net dist/deno/server/index.mjs`
+ * 部署命令:`deno run --allow-net dist/deno/server/index.mjs`
+ */
+declare const denoPreset: {
+  extends: string;
+  capabilities: CapabilitySet;
+  entry: string;
+  exportConditions: string[];
+  build: {
+    outputDir: string;
+    format: "esm";
+    externals: string[];
+  };
+  output: {
+    dir: string;
+    serverDir: string;
+    publicDir: string;
+  };
+  runtime: {
+    entry: string;
+    handler: string;
+    compatibilityDate: string;
+  };
+  serve: {
+    host: string;
+    port: number;
+  };
+  commands: {
+    preview: string;
+    deploy: string;
+  };
+  hooks: {
+    'build:before': () => Promise<void>;
+    'build:after': () => Promise<void>;
+  };
+} & {
+  _meta: PresetMeta;
+  name: string;
+};
+/**
+ * Deno 配置文件类型
+ *
+ * Deno 使用 `deno.json` / `deno.jsonc` 进行配置。
+ */
+interface DenoConfig {
+  tasks?: Record<string, string>;
+  importMap?: string;
+  compilerOptions?: {
+    strict?: boolean;
+    lib?: string[];
+    jsx?: 'jsx' | 'react-jsx' | 'react-jsxdev' | 'preserve';
+    jsxImportSource?: string;
+  };
+  lint?: boolean | {
+    files?: {
+      include?: string[];
+      exclude?: string[];
+    };
+    rules?: Record<string, 'deny' | 'warn' | 'off'>;
+  };
+  fmt?: boolean | {
+    files?: {
+      include?: string[];
+      exclude?: string[];
+    };
+    options?: {
+      indentWidth?: number;
+      lineWidth?: number;
+      singleQuote?: boolean;
+      semiColons?: boolean;
+    };
+  };
+  lock?: string | false;
+  nodeModulesDir?: boolean;
+  vendor?: boolean;
+  unstable?: string[];
+}
+/**
+ * 生成 Deno 配置对象
+ *
+ * @param options.lock - 传 `false` 禁用 lockfile,传字符串指定 lockfile 路径
+ */
+declare function generateDenoConfig(options: {
+  tasks?: Record<string, string>;
+  importMap?: string;
+  lock?: string | false;
+  nodeModulesDir?: boolean;
+  unstable?: string[];
+}): DenoConfig;
+/**
+ * 序列化 Deno 配置为 JSON 字符串
+ */
+declare function serializeDenoConfig(config: DenoConfig): string;
+//#endregion
+//#region src/netlify.d.ts
+/**
+ * Netlify preset —— Netlify Functions 模式
+ *
+ * 构建输出:`dist/netlify/functions/index.mjs`(Netlify 自动检测 `functions/` 目录)
+ * 预览命令:`netlify dev`
+ * 部署命令:`netlify deploy --prod`
+ */
+declare const netlifyPreset: {
+  extends: string;
+  capabilities: CapabilitySet;
+  entry: string;
+  exportConditions: string[];
+  build: {
+    outputDir: string;
+    format: "esm";
+    externals: string[];
+  };
+  output: {
+    dir: string;
+    serverDir: string;
+    publicDir: string;
+  };
+  runtime: {
+    entry: string;
+    handler: string;
+  };
+  serve: {
+    host: string;
+    port: number;
+  };
+  commands: {
+    preview: string;
+    deploy: string;
+  };
+  hooks: {
+    'build:before': () => Promise<void>;
+    'build:after': () => Promise<void>;
+  };
+} & {
+  _meta: PresetMeta;
+  name: string;
+};
+/**
+ * Netlify 配置文件(`netlify.toml`)类型
+ */
+interface NetlifyConfig {
+  build?: {
+    command?: string;
+    publish?: string;
+    functions?: string;
+    environment?: Record<string, string>;
+  };
+  functions?: {
+    directory?: string;
+    node_bundler?: 'esbuild' | 'zisi' | 'nft';
+    external_node_modules?: string[];
+    included_files?: string[];
+    excluded_files?: string[];
+  };
+  redirects?: Array<{
+    from: string;
+    to: string;
+    status?: number;
+    force?: boolean;
+  }>;
+  headers?: Array<{
+    for: string;
+    values: Record<string, string>;
+  }>;
+}
+/**
+ * 生成 Netlify 配置对象
+ */
+declare function generateNetlifyConfig(options: {
+  functionsDir?: string;
+  publishDir?: string;
+  buildCommand?: string;
+  redirects?: Array<{
+    from: string;
+    to: string;
+    status?: number;
+    force?: boolean;
+  }>;
+  headers?: Array<{
+    for: string;
+    values: Record<string, string>;
+  }>;
+  environment?: Record<string, string>;
+}): NetlifyConfig;
+/**
+ * 序列化 Netlify 配置为 TOML 字符串
+ */
+declare function serializeNetlifyConfig(config: NetlifyConfig): string;
+//#endregion
 //#region src/node.d.ts
 declare const nodePreset: {
   extends: string;
@@ -319,6 +853,173 @@ declare const standardPreset: {
   name: string;
 };
 //#endregion
+//#region src/vercel.d.ts
+/**
+ * Vercel preset —— Serverless Functions 模式
+ *
+ * 构建输出:`dist/vercel/server/index.mjs`(供 Vercel 自动检测为 Serverless Function)
+ * 预览命令:`vercel dev`
+ * 部署命令:`vercel --prod`
+ */
+declare const vercelPreset: {
+  extends: string;
+  capabilities: CapabilitySet;
+  entry: string;
+  exportConditions: string[];
+  build: {
+    outputDir: string;
+    format: "esm";
+    externals: string[];
+  };
+  output: {
+    dir: string;
+    serverDir: string;
+    publicDir: string;
+  };
+  runtime: {
+    entry: string;
+    handler: string;
+  };
+  serve: {
+    host: string;
+    port: number;
+  };
+  commands: {
+    preview: string;
+    deploy: string;
+  };
+  hooks: {
+    'build:before': () => Promise<void>;
+    'build:after': () => Promise<void>;
+  };
+} & {
+  _meta: PresetMeta;
+  name: string;
+};
+/**
+ * Vercel Edge preset —— Edge Functions 模式
+ *
+ * 基于 V8 isolates,无 Node.js 兼容,全球低延迟。
+ * 构建输出:`dist/vercel-edge/edge/index.mjs`
+ */
+declare const vercelEdgePreset: {
+  extends: string;
+  capabilities: CapabilitySet;
+  entry: string;
+  exportConditions: string[];
+  build: {
+    outputDir: string;
+    format: "esm";
+    minify: true;
+    externals: string[];
+    rollupConfig: {
+      external: string[];
+    };
+  };
+  output: {
+    dir: string;
+    serverDir: string;
+    publicDir: string;
+  };
+  runtime: {
+    entry: string;
+    handler: string;
+    compatibilityDate: string;
+  };
+  serve: {
+    host: string;
+    port: number;
+  };
+  commands: {
+    preview: string;
+    deploy: string;
+  };
+} & {
+  _meta: PresetMeta;
+  name: string;
+};
+/**
+ * Vercel 配置文件(`vercel.json`)类型
+ */
+interface VercelConfig {
+  version?: number;
+  builds?: Array<{
+    src: string;
+    use?: string;
+    config?: Record<string, unknown>;
+  }>;
+  functions?: Record<string, {
+    runtime?: string;
+    memory?: number;
+    maxDuration?: number;
+    includeFiles?: string | string[];
+    excludeFiles?: string | string[];
+  }>;
+  routes?: Array<{
+    src: string;
+    dest?: string;
+    status?: number;
+    headers?: Record<string, string>;
+  }>;
+  rewrites?: Array<{
+    source: string;
+    destination: string;
+  }>;
+  redirects?: Array<{
+    source: string;
+    destination: string;
+    permanent?: boolean;
+  }>;
+  headers?: Array<{
+    source: string;
+    headers: Array<{
+      key: string;
+      value: string;
+    }>;
+  }>;
+  cron?: Array<{
+    path: string;
+    schedule: string;
+  }>;
+  env?: Record<string, string>;
+  build?: {
+    env?: Record<string, string>;
+    command?: string;
+  };
+}
+/**
+ * 生成 Vercel 配置对象
+ */
+declare function generateVercelConfig(options: {
+  entry?: string;
+  functions?: Record<string, {
+    maxDuration?: number;
+    memory?: number;
+  }>;
+  rewrites?: Array<{
+    source: string;
+    destination: string;
+  }>;
+  redirects?: Array<{
+    source: string;
+    destination: string;
+    permanent?: boolean;
+  }>;
+  headers?: Array<{
+    source: string;
+    headers: Record<string, string>;
+  }>;
+  cron?: Array<{
+    path: string;
+    schedule: string;
+  }>;
+  env?: Record<string, string>;
+}): VercelConfig;
+/**
+ * 序列化 Vercel 配置为 JSON 字符串
+ */
+declare function serializeVercelConfig(config: VercelConfig): string;
+//#endregion
 //#region src/detect.d.ts
 interface PresetDetectionHints {
   cwd?: string;
@@ -339,4 +1040,4 @@ declare function listDetectablePresets(): PresetDefinition[];
 declare function registerBuiltinPresets(): void;
 declare function resolvePresetByName(name: string): ResolvedPreset;
 //#endregion
-export { CapabilityDiagnosisResult, CapabilityDiagnostic, CapabilityInfo, CapabilityName, CapabilityRequirement, CapabilitySet, DEV_REQUIREMENTS, NODE_CAPABILITIES, NODE_REQUIREMENTS, type Preset, type PresetBuildContext, type PresetDefinition, type PresetDetectionHints, type PresetDetectionResult, type PresetDevContext, type PresetHooks, type PresetMeta, type ResolvedPreset, RuntimeTarget, STANDARD_CAPABILITIES, WORKER_CAPABILITIES, type WranglerConfig, cloudflareDevPreset, cloudflarePreset, createCapabilitySet, definePreset, detectPreset, diagnoseCapabilities, generateWranglerConfig, getPresetAliases, getPresetNames, getRegisteredPresets, listDetectablePresets, nodePreset, registerBuiltinPresets, registerPreset, requireCapability, resolvePreset, resolvePresetByName, resolvePresetWithDetection, serializeWranglerToml, standardPreset };
+export { type AwsSamResource, type AwsSamTemplate, type BunfigConfig, CapabilityDiagnosisResult, CapabilityDiagnostic, CapabilityInfo, CapabilityName, CapabilityRequirement, CapabilitySet, DEV_REQUIREMENTS, type DenoConfig, NODE_CAPABILITIES, NODE_REQUIREMENTS, type NetlifyConfig, type Preset, type PresetBuildContext, type PresetDefinition, type PresetDetectionHints, type PresetDetectionResult, type PresetDevContext, type PresetHooks, type PresetMeta, type ResolvedPreset, RuntimeTarget, STANDARD_CAPABILITIES, type StaticWebAppConfig, type VercelConfig, WORKER_CAPABILITIES, type WranglerConfig, awsPreset, azurePreset, bunPreset, cloudflareDevPreset, cloudflarePreset, createCapabilitySet, definePreset, denoPreset, detectPreset, diagnoseCapabilities, generateAwsSamConfig, generateBunfigConfig, generateDenoConfig, generateNetlifyConfig, generateStaticWebAppConfig, generateVercelConfig, generateWranglerConfig, getPresetAliases, getPresetNames, getRegisteredPresets, listDetectablePresets, netlifyPreset, nodePreset, registerBuiltinPresets, registerPreset, requireCapability, resolvePreset, resolvePresetByName, resolvePresetWithDetection, serializeAwsSamConfig, serializeBunfigConfig, serializeDenoConfig, serializeNetlifyConfig, serializeStaticWebAppConfig, serializeVercelConfig, serializeWranglerToml, standardPreset, vercelEdgePreset, vercelPreset };