@finesoft/front 0.5.1 → 0.5.3

package/dist/vite-Cj4SPA8D.d.mts

@@ -0,0 +1,277 @@
+import { n as ProxyRouteConfig } from "./proxy-2dSWO-Xw.mjs";
+import { t as ControllerTypeOptions } from "./controller-types-CgmJ6-le.mjs";
+import { Hono } from "hono";
+//#region ../../node_modules/.pnpm/magic-string@0.30.21/node_modules/magic-string/dist/magic-string.es.d.mts
+type SourceMapSegment = [number] | [number, number, number, number] | [number, number, number, number, number];
+interface DecodedSourceMap {
+  file: string;
+  sources: string[];
+  sourcesContent?: string[];
+  names: string[];
+  mappings: SourceMapSegment[][];
+  x_google_ignoreList?: number[];
+}
+declare class SourceMap {
+  constructor(properties: DecodedSourceMap);
+  version: number;
+  file: string;
+  sources: string[];
+  sourcesContent?: string[];
+  names: string[];
+  mappings: string;
+  x_google_ignoreList?: number[];
+  debugId?: string;
+  /**
+   * Returns the equivalent of `JSON.stringify(map)`
+   */
+  toString(): string;
+  /**
+   * Returns a DataURI containing the sourcemap. Useful for doing this sort of thing:
+   * `generateMap(options?: SourceMapOptions): SourceMap;`
+   */
+  toUrl(): string;
+}
+//#endregion
+//#region ../server/src/adapters/types.d.ts
+/** 适配器上下文 — 由 vite-plugin 的 closeBundle 构造后传入 adapter.build() */
+interface AdapterContext {
+  /** Automatically shared client/SSR build identity. */
+  buildId?: string;
+  /** 项目根路径 */
+  root: string;
+  /** SSR 入口文件相对路径（如 "src/ssr.ts"） */
+  ssrEntry: string;
+  /** setup 文件相对路径（如 "src/proxies.ts"），仅当 options.setup 为 string 时有值 */
+  setupPath?: string;
+  /** dist/client/index.html 的内容 */
+  templateHtml: string;
+  /** Vite 的 resolve 配置 */
+  resolvedResolve: unknown;
+  /** Vite 的 css 配置 */
+  resolvedCss: unknown;
+  /**
+   * 按路由覆盖的渲染模式。
+   * key: 精确路径或 glob 模式，value: "ssr" | "csr" | "prerender"
+   */
+  renderModes?: Record<string, string>;
+  /** 声明式代理路由配置 */
+  proxies?: ProxyRouteConfig[];
+  /** 支持的 locale 列表（用于预渲染 locale 矩阵） */
+  locales?: string[];
+  /** 默认 locale（CSR shell 使用） */
+  defaultLocale?: string;
+  vite: any;
+  fs: typeof import("node:fs");
+  path: {
+    resolve: (...args: string[]) => string;
+    join: (...args: string[]) => string;
+  };
+  /** 生成 serverless/edge function 入口源码 */
+  generateSSREntry(opts: GenerateSSREntryOptions): string;
+  /** 用 Vite SSR 模式构建 bundle */
+  buildBundle(opts: BuildBundleOptions): Promise<void>;
+  /** 复制 dist/client 静态资源到目标目录 */
+  copyStaticAssets(destDir: string, opts?: CopyStaticAssetsOptions): void;
+}
+interface GenerateSSREntryOptions {
+  /** Host capability for protected outbound requests. */
+  dnsPolicy?: "node" | "hostname";
+  /** 平台特定的导入语句（如 `import { handle } from "hono/vercel";`） */
+  platformImport: string;
+  /** 平台特定的导出语句（如 `export default handle(app);`） */
+  platformExport: string;
+  /**
+   * 平台特定的 ISR 缓存实现代码（可选）。
+   * 需提供 `async function platformCacheGet(url)` 返回 string|null，
+   * 和 `async function platformCacheSet(url, html)` 的函数定义。
+   * 不提供时使用内置的内存 Map 缓存。
+   */
+  platformCache?: string;
+  /** CDN headers applied by the shared handler only to explicitly public cache-eligible HTML. */
+  publicCacheHeaders?: Record<string, string>;
+  /**
+   * 平台特定的中间件代码（可选）。
+   * 插入在 catch-all GET 路由之前，可用于添加静态文件服务等。
+   * 代码中可使用变量 `app`（Hono 实例）。
+   */
+  platformMiddleware?: string;
+}
+interface BuildBundleOptions {
+  /** 临时入口文件路径 */
+  entry: string;
+  /** 输出目录 */
+  outDir: string;
+  /** 构建 target（默认 "node18"） */
+  target?: string;
+  /** 输出文件名（默认 "index.mjs"） */
+  fileName?: string;
+  /** 排除的模块（默认 ["vite", "esbuild", "rollup", "fsevents", "lightningcss"]） */
+  external?: string[];
+  /** 是否打包所有依赖（默认 true） */
+  noExternal?: boolean;
+  /** 构建前是否清空 outDir（默认 true）。与 SSR 构建共享目录时应设为 false */
+  emptyOutDir?: boolean;
+}
+interface CopyStaticAssetsOptions {
+  /** 是否排除 index.html（默认 true） */
+  excludeHtml?: boolean;
+}
+/** 适配器接口 */
+interface Adapter {
+  /** 适配器名称（用于日志） */
+  name: string;
+  /** 生成目标平台部署产物 */
+  build(ctx: AdapterContext): Promise<void>;
+}
+//#endregion
+//#region ../server/src/vite-plugin.d.ts
+interface FinesoftFrontViteOptions {
+  /** Maintain route-derived class parameter types. Enabled by default for TypeScript apps. */
+  controllerTypes?: ControllerTypeOptions | false;
+  /** Optional reproducible build identity; otherwise generated for each paired build. */
+  buildId?: string;
+  /** SSR 配置 */
+  ssr?: {
+    /** SSR 入口文件路径（默认 "src/ssr.ts"） */
+    entry?: string;
+  };
+  /**
+   * 声明式代理路由配置。
+   * 框架统一执行路径校验（SSRF 防护）、Host 限制、错误处理、响应头控制。
+   * 代理路由在 setup 之前注册，优先级高于自定义路由。
+   */
+  proxies?: ProxyRouteConfig[];
+  /**
+   * 注册自定义路由（非代理类）。
+   * - 传入 Function：仅 dev/preview 时可用。
+   * - 传入 string（文件路径）：dev/preview/adapter 均可用，
+   *   文件需 export default 一个 (app: Hono) => void 函数。
+   * 注意：代理路由请使用 proxies 选项，不要在 setup 中手写代理。
+   */
+  setup?: ((app: Hono) => void | Promise<void>) | string;
+  /**
+   * 部署适配器。
+   * - 字符串快捷方式："vercel" | "cloudflare" | "netlify" | "node" | "static" | "auto"
+   * - 自定义 Adapter 对象：{ name, build(ctx) }
+   * - 不设置则不生成部署产物
+   */
+  adapter?: string | Adapter;
+  /**
+   * 按路由覆盖渲染模式（优先级高于 RouteDefinition.renderMode）。
+   * key: 精确路径或 glob 模式，如 "/search" 或 "/blog/*"
+   * value: "ssr" | "csr" | "prerender"
+   *
+   * @example
+   * ```ts
+   * renderModes: {
+   *   "/search": "csr",
+   *   "/blog/*": "prerender",
+   * }
+   * ```
+   */
+  renderModes?: Record<string, "ssr" | "csr" | "prerender">;
+  /**
+   * 默认 locale（如 "zh-Hans"、"en-US"）。
+   * 用于 CSR 壳注入 `<html lang="" dir="">`，以及预渲染时的默认语言。
+   */
+  defaultLocale?: string;
+  /**
+   * 预渲染支持的语言列表。
+   * 提供后，每个 prerender 路由会与每个 locale 组合生成 `/:locale/path` 版本。
+   * `defaultLocale` 的路由同时输出无前缀版本。
+   */
+  locales?: string[];
+  /**
+   * i18n JSON 字典目录。
+   * 文件名必须与 locale 一致，例如 `en-US.json`、`zh-Hans.json`。
+   * 配置后，框架会自动为 SSR / CSR 生成共享的消息加载器。
+   */
+  i18n?: {
+    messagesDir: string;
+  };
+}
+declare function finesoftFrontViteConfig(options?: FinesoftFrontViteOptions): {
+  name: string;
+  enforce: "pre";
+  config(userConfig: Record<string, any>): Record<string, any>;
+  configResolved(config: Record<string, any>): void;
+  resolveId(this: any, id: string, importer?: string, buildOptions?: {
+    ssr?: boolean;
+    scan?: boolean;
+  }): string | Promise<any> | null;
+  load(this: any, id: string, buildOptions?: {
+    ssr?: boolean;
+  }): Promise<string | {
+    code: string;
+    map: {
+      version: number;
+      sources: never[];
+      names: never[];
+      mappings: string;
+      sourcesContent: never[];
+    };
+  } | null>;
+  buildStart(this: any): Promise<void>;
+  transform: (code: string, id: string) => {
+    code: string;
+    map: SourceMap;
+  } | null;
+  watchChange(file: string): void;
+  /**
+   * Dev 模式 CSS 内联 — 消除 SSR 首屏布局抖动
+   *
+   * Vite dev 模式下，global.scss 等非组件 CSS 通过 JS 模块系统异步加载，
+   * 导致 SSR HTML 初次渲染缺少布局关键样式（box-sizing、flex 布局、padding-top 等）。
+   *
+   * 此 hook 在 HTML 模板变换阶段（SSR 渲染之前）：
+   * 1. 找到浏览器入口脚本（排除 /@vite/client 等内部脚本）
+   * 2. 编译入口脚本，填充 Vite 模块图
+   * 3. 遍历模块图收集所有 CSS 依赖（排除 .svelte 组件 CSS，由 SSR 渲染自行处理）
+   * 4. 通过 ssrLoadModule 获取编译后 CSS（SCSS→CSS）
+   * 5. 注入 <style data-vite-dev-id> 标签到 <head>
+   *
+   * data-vite-dev-id 确保 Vite HMR 客户端复用已有标签，避免重复注入。
+   */
+  transformIndexHtml: {
+    order: "pre";
+    handler(html: string, ctx: any): Promise<{
+      tag: string;
+      attrs: Record<string, string>;
+      children: string;
+      injectTo: "head";
+    }[] | undefined>;
+  };
+  configureServer(server: any): () => Promise<void>;
+  configurePreviewServer(server: any): () => Promise<void>;
+  closeBundle(): Promise<void>;
+};
+//#endregion
+//#region ../server/src/adapters/auto.d.ts
+declare function autoAdapter(): Adapter;
+//#endregion
+//#region ../server/src/adapters/cloudflare.d.ts
+declare function cloudflareAdapter(): Adapter;
+//#endregion
+//#region ../server/src/adapters/netlify.d.ts
+declare function netlifyAdapter(): Adapter;
+//#endregion
+//#region ../server/src/adapters/node.d.ts
+declare function nodeAdapter(): Adapter;
+//#endregion
+//#region ../server/src/adapters/static.d.ts
+interface StaticAdapterOptions {
+  /** Optional module exporting routes or a Web definition; built render.routes is the default. */
+  routesExport?: string;
+  /** Concrete pathnames for dynamic routes, e.g. /products/42. */
+  dynamicRoutes?: string[];
+}
+declare function staticAdapter(options?: StaticAdapterOptions): Adapter;
+//#endregion
+//#region ../server/src/adapters/vercel.d.ts
+declare function vercelAdapter(): Adapter;
+//#endregion
+//#region ../server/src/adapters/resolve.d.ts
+declare function resolveAdapter(value: string | Adapter): Adapter;
+//#endregion
+export { netlifyAdapter as a, FinesoftFrontViteOptions as c, AdapterContext as d, nodeAdapter as i, finesoftFrontViteConfig as l, vercelAdapter as n, cloudflareAdapter as o, staticAdapter as r, autoAdapter as s, resolveAdapter as t, Adapter as u };
+//# sourceMappingURL=vite-Cj4SPA8D.d.mts.map

package/dist/vite.d.mts

@@ -0,0 +1,4 @@
+import { i as generateProxyCode, n as ProxyRouteConfig, t as ProxyAuthConfig } from "./proxy-2dSWO-Xw.mjs";
+import { a as netlifyAdapter, c as FinesoftFrontViteOptions, d as AdapterContext, i as nodeAdapter, l as finesoftFrontViteConfig, n as vercelAdapter, o as cloudflareAdapter, r as staticAdapter, s as autoAdapter, t as resolveAdapter, u as Adapter } from "./vite-Cj4SPA8D.mjs";
+import { n as ControllerTypeResult, r as generateControllerTypes, t as ControllerTypeOptions } from "./controller-types-CgmJ6-le.mjs";
+export { type Adapter, type AdapterContext, type ControllerTypeOptions, type ControllerTypeResult, type FinesoftFrontViteOptions, type ProxyAuthConfig, type ProxyRouteConfig, autoAdapter, cloudflareAdapter, finesoftFrontViteConfig, generateControllerTypes, generateProxyCode, netlifyAdapter, nodeAdapter, resolveAdapter, staticAdapter, vercelAdapter };