create-fullstack-scaffold 0.1.0

package/template/package.json

@@ -0,0 +1,158 @@
+{
+  "name": "biomimic-todo-app",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "biomimic": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "npm run build:client && npm run build:server",
+    "build:client": "vite build",
+    "build:server": "tsup",
+    "build:cli": "tsup --config tsup.config.ts",
+    "build:cloudflare": "npm run build:client && tsup --config tsup.config.ts",
+    "build:all": "npm run build:client && npm run build:server && npm run build:cli",
+    "cli": "node dist/cli/index.js",
+    "preview": "vite preview",
+    "start": "NODE_ENV=production node dist/server/node.js",
+    "start:dev": "NODE_ENV=development node --import tsx src/server/entries/node.ts",
+    "dev:cf": "wrangler dev",
+    "deploy:cf": "npm run build:cloudflare && wrangler deploy",
+    "typecheck": "tsc --noEmit && eslint . --max-warnings=0",
+    "test": "vitest",
+    "test:smart": "node --import tsx/esm lint-scripts/smart-test.ts",
+    "test:smart:staged": "node --import tsx/esm lint-scripts/smart-test.ts --staged",
+    "test:infrastructure": "node --import tsx/esm lint-scripts/smart-test.ts --infrastructure",
+    "test:all": "node --import tsx/esm lint-scripts/smart-test.ts --all",
+    "test:coverage": "vitest run --coverage",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:ui": "vitest run --ui",
+    "test:e2e": "playwright test",
+    "test:e2e:ui": "playwright test --ui",
+    "test:e2e:debug": "playwright test --debug",
+    "test:track": "node --import tsx/esm lint-scripts/test-tracker.ts",
+    "test:history": "node --import tsx/esm lint-scripts/test-history.ts",
+    "test:history:list": "node --import tsx/esm lint-scripts/test-history.ts list",
+    "test:history:show": "node --import tsx/esm lint-scripts/test-history.ts show",
+    "test:history:compare": "node --import tsx/esm lint-scripts/test-history.ts compare",
+    "test:history:failed": "node --import tsx/esm lint-scripts/test-history.ts failed",
+    "test:full": "npm run test:all && npm run test:integration && npm run test:e2e",
+    "coverage": "vitest --coverage",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "validate:all": "node --import tsx/esm lint-scripts/validate-all.ts",
+    "validate:watch": "node --import tsx/esm lint-scripts/watch-validator.ts",
+    "validate:vite-routes": "node --import tsx/esm lint-scripts/validate-vite-routes.ts",
+    "validate:modules": "npx tsx src/server/core/module-loader.ts",
+    "check:refs": "node --import tsx/esm lint-scripts/check-refs.ts",
+    "create:module": "node --import tsx/esm scripts/create-template.ts",
+    "postinstall": "patch-package",
+    "prepare": "husky",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:push": "drizzle-kit push",
+    "db:studio": "drizzle-kit studio",
+    "framework:init": "node --import tsx/esm lint-scripts/framework/init-baseline.ts",
+    "framework:update": "node --import tsx/esm lint-scripts/framework/update-baseline.ts",
+    "framework:check": "node --import tsx/esm lint-scripts/framework/check-modify.ts",
+    "dev:context": "node --import tsx/esm lint-scripts/dev-context-analyzer.ts",
+    "dev:guide": "node --import tsx/esm lint-scripts/dev-guide-generator.ts",
+    "ai:context": "node --import tsx/esm lint-scripts/ai-context-generator.ts"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.14.4",
+    "@hono/zod-openapi": "1.2.2",
+    "@hono/zod-validator": "0.7.6",
+    "@libsql/client": "^0.17.0",
+    "antd": "^5.24.0",
+    "bcryptjs": "^3.0.3",
+    "commander": "^12.0.0",
+    "dotenv": "^16.5.0",
+    "drizzle-orm": "^0.45.1",
+    "hono": "^4.12.16",
+    "jsonwebtoken": "^9.0.3",
+    "lucide-react": "^0.576.0",
+    "pino": "^9.7.0",
+    "pino-pretty": "^13.0.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-helmet-async": "^3.0.0",
+    "react-router-dom": "^7.13.1",
+    "ws": "^8.18.3",
+    "zod": "^4.4.3",
+    "zustand": "^5.0.2"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20260503.1",
+    "@commitlint/cli": "^20.4.3",
+    "@commitlint/config-conventional": "^20.4.3",
+    "@eslint/js": "^9.39.4",
+    "@hono/vite-dev-server": "^0.23.0",
+    "@playwright/test": "^1.50.0",
+    "@prerenderer/renderer-jsdom": "^1.1.9",
+    "@prerenderer/renderer-puppeteer": "^1.2.4",
+    "@prerenderer/rollup-plugin": "^0.3.12",
+    "@tailwindcss/postcss": "^4.2.1",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^6.8.0",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.5.2",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/node": "^22.13.10",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "@types/ws": "^8.18.0",
+    "@vitejs/plugin-react": "^5.1.4",
+    "@vitest/coverage-v8": "^4.0.16",
+    "@vitest/ui": "^4.0.16",
+    "autoprefixer": "^10.4.27",
+    "bun-types": "^1.3.10",
+    "drizzle-kit": "^0.31.9",
+    "eslint": "^9.21.0",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-react-refresh": "^0.4.19",
+    "eventsource": "^4.1.0",
+    "glob": "^13.0.6",
+    "globals": "^16.0.0",
+    "husky": "^9.1.7",
+    "jsdom": "^26.0.3",
+    "lint-staged": "^15.5.0",
+    "minimatch": "^10.2.4",
+    "patch-package": "^8.0.0",
+    "playwright": "^1.50.0",
+    "postcss": "^8.5.6",
+    "prettier": "^3.5.3",
+    "tailwindcss": "^4.2.1",
+    "tsup": "^8.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.25.0",
+    "vite": "^6.2.3",
+    "vitest": "^4.0.16",
+    "wrangler": "^4.75.0"
+  },
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx}": [
+      "prettier --write",
+      "eslint --fix",
+      "eslint --max-warnings=0 --no-warn-ignored"
+    ],
+    "*.{json,md,css}": [
+      "prettier --write"
+    ],
+    "src/server/**/*routes*.ts": [
+      "npm run validate:all"
+    ],
+    "src/client/**/*.{ts,tsx}": [
+      "npm run validate:all"
+    ]
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "overrides": {
+    "esbuild": "^0.25.0"
+  }
+}

package/template/patches/@hono+zod-openapi+1.2.2.patch

@@ -0,0 +1,67 @@
+diff --git a/node_modules/@hono/zod-openapi/dist/index.d.ts b/node_modules/@hono/zod-openapi/dist/index.d.ts
+index 7355946..9e2bb70 100644
+--- a/node_modules/@hono/zod-openapi/dist/index.d.ts
++++ b/node_modules/@hono/zod-openapi/dist/index.d.ts
+@@ -23,7 +23,7 @@ type RequestTypes = {
+ };
+ type IsJson<T$1> = T$1 extends string ? T$1 extends `application/${infer Start}json${infer _End}` ? Start extends "" | `${string}+` | `vnd.${string}+` ? "json" : never : never : never;
+ type IsForm<T$1> = T$1 extends string ? T$1 extends `multipart/form-data${infer _Rest}` | `application/x-www-form-urlencoded${infer _Rest}` ? "form" : never : never;
+-type ReturnJsonOrTextOrResponse<ContentType, Content$1, Status$1 extends keyof StatusCodeRangeDefinitions | StatusCode> = ContentType extends string ? ContentType extends `application/${infer Start}json${infer _End}` ? Start extends "" | `${string}+` | `vnd.${string}+` ? TypedResponse<JSONParsed<Content$1>, ExtractStatusCode<Status$1>, "json"> : never : ContentType extends `text/plain${infer _Rest}` ? TypedResponse<Content$1, ExtractStatusCode<Status$1>, "text"> : Response : never;
++type ReturnJsonOrTextOrResponse<ContentType, Content$1, Status$1 extends keyof StatusCodeRangeDefinitions | StatusCode> = ContentType extends string ? ContentType extends `application/${infer Start}json${infer _End}` ? Start extends "" | `${string}+` | `vnd.${string}+` ? TypedResponse<JSONParsed<Content$1>, ExtractStatusCode<Status$1>, "json"> : never : ContentType extends `text/plain${infer _Rest}` ? TypedResponse<Content$1, ExtractStatusCode<Status$1>, "text"> : ContentType extends `text/event-stream` ? TypedResponse<Content$1, ExtractStatusCode<Status$1>, "sse"> : ContentType extends `websocket` ? TypedResponse<Content$1, ExtractStatusCode<Status$1>, "ws"> : ContentType extends `image/svg+xml${infer _Rest}` ? TypedResponse<Content$1, ExtractStatusCode<Status$1>, "svg"> : ContentType extends `image/${infer _Type}` ? TypedResponse<Content$1, ExtractStatusCode<Status$1>, "image"> : ContentType extends `multipart/form-data${infer _Rest}` ? TypedResponse<Content$1, ExtractStatusCode<Status$1>, "form"> : ContentType extends `application/${infer _Rest}` ? TypedResponse<Content$1, ExtractStatusCode<Status$1>, "file"> : Response : never;
+ type RequestPart<R$1 extends RouteConfig, Part extends string> = Part extends keyof R$1["request"] ? R$1["request"][Part] : {};
+ type HasUndefined<T$1> = undefined extends T$1 ? true : false;
+ type InputTypeBase<R$1 extends RouteConfig, Part extends string, Type extends keyof ValidationTargets> = R$1["request"] extends RequestTypes ? RequestPart<R$1, Part> extends ZodType ? {
+@@ -63,9 +63,9 @@ type ExtractStatusCode<T$1 extends RouteConfigStatusCode> = T$1 extends keyof St
+ type DefinedStatusCodes<R$1 extends RouteConfig> = keyof R$1["responses"] & RouteConfigStatusCode;
+ type RouteConfigToTypedResponse<R$1 extends RouteConfig> = { [Status in DefinedStatusCodes<R$1>]: R$1["responses"][Status] extends {
+   content: infer Content;
+-} ? undefined extends Content ? never : ReturnJsonOrTextOrResponse<keyof R$1["responses"][Status]["content"], ExtractContent<R$1["responses"][Status]["content"]>, Status> : TypedResponse<{}, ExtractStatusCode<Status>, string> }[DefinedStatusCodes<R$1>] | ("default" extends keyof R$1["responses"] ? R$1["responses"]["default"] extends {
++} ? undefined extends Content ? never : ReturnJsonOrTextOrResponse<keyof R$1["responses"][Status]["content"], ExtractContent<R$1["responses"][Status]["content"]>, Status> : TypedResponse<{}, ExtractStatusCode<Status>, "json"> }[DefinedStatusCodes<R$1>] | ("default" extends keyof R$1["responses"] ? R$1["responses"]["default"] extends {
+   content: infer Content;
+-} ? undefined extends Content ? never : ReturnJsonOrTextOrResponse<keyof Content, ExtractContent<Content>, Exclude<StatusCode, ExtractStatusCode<DefinedStatusCodes<R$1>>>> : TypedResponse<{}, Exclude<StatusCode, ExtractStatusCode<DefinedStatusCodes<R$1>>>, string> : never);
++} ? undefined extends Content ? never : ReturnJsonOrTextOrResponse<keyof Content, ExtractContent<Content>, Exclude<StatusCode, ExtractStatusCode<DefinedStatusCodes<R$1>>>> : TypedResponse<{}, Exclude<StatusCode, ExtractStatusCode<DefinedStatusCodes<R$1>>>, "json"> : never);
+ type Hook<T$1, E$1 extends Env, P$1 extends string, R$1> = (result: {
+   target: keyof ValidationTargets;
+ } & ({
+@@ -104,15 +104,7 @@ type OfHandlerType<T$1 extends MiddlewareHandler> = T$1 extends MiddlewareHandle
+ type MiddlewareToHandlerType<M extends MiddlewareHandler<any, any, any>[]> = M extends [infer First, infer Second, ...infer Rest] ? First extends MiddlewareHandler<any, any, any> ? Second extends MiddlewareHandler<any, any, any> ? Rest extends MiddlewareHandler<any, any, any>[] ? MiddlewareToHandlerType<[MiddlewareHandler<DeepSimplify<OfHandlerType<First>["env"] & OfHandlerType<Second>["env"]>, OfHandlerType<First>["path"], OfHandlerType<First>["input"]>, ...Rest]> : never : never : never : M extends [infer Last] ? Last : MiddlewareHandler<Env>;
+ type RouteMiddlewareParams<R$1 extends RouteConfig> = OfHandlerType<MiddlewareToHandlerType<AsArray<R$1["middleware"]>>>;
+ type RouteConfigToEnv<R$1 extends RouteConfig> = RouteMiddlewareParams<R$1> extends never ? Env : RouteMiddlewareParams<R$1>["env"];
+-type RouteHandler<R$1 extends RouteConfig, E$1 extends Env = RouteConfigToEnv<R$1>, I$1 extends Input = InputTypeParam<R$1> & InputTypeQuery<R$1> & InputTypeHeader<R$1> & InputTypeCookie<R$1> & InputTypeForm<R$1> & InputTypeJson<R$1>, P$1 extends string = ConvertPathType<R$1["path"]>> = Handler<E$1, P$1, I$1, R$1 extends {
+-  responses: {
+-    [statusCode: number]: {
+-      content: {
+-        [mediaType: string]: ZodMediaTypeObject;
+-      };
+-    };
+-  };
+-} ? MaybePromise<RouteConfigToTypedResponse<R$1>> : MaybePromise<RouteConfigToTypedResponse<R$1>> | MaybePromise<Response>>;
++type RouteHandler<R$1 extends RouteConfig, E$1 extends Env = RouteConfigToEnv<R$1>, I$1 extends Input = InputTypeParam<R$1> & InputTypeQuery<R$1> & InputTypeHeader<R$1> & InputTypeCookie<R$1> & InputTypeForm<R$1> & InputTypeJson<R$1>, P$1 extends string = ConvertPathType<R$1["path"]>> = Handler<E$1, P$1, I$1, MaybePromise<TypedResponse<any, StatusCode, "json" | "sse" | "ws"> | Response>>;
+ type RouteHook<R$1 extends RouteConfig, E$1 extends Env = RouteConfigToEnv<R$1>, I$1 extends Input = InputTypeParam<R$1> & InputTypeQuery<R$1> & InputTypeHeader<R$1> & InputTypeCookie<R$1> & InputTypeForm<R$1> & InputTypeJson<R$1>, P$1 extends string = ConvertPathType<R$1["path"]>> = Hook<I$1, E$1, P$1, RouteConfigToTypedResponse<R$1> | Response | Promise<Response> | void | Promise<void>>;
+ type OpenAPIObjectConfig = Parameters<InstanceType<typeof OpenApiGeneratorV3>["generateDocument"]>[0];
+ type OpenAPIObjectConfigure<E$1 extends Env, P$1 extends string> = OpenAPIObjectConfig | ((context: Context<E$1, P$1>) => OpenAPIObjectConfig);
+@@ -181,23 +173,7 @@ declare class OpenAPIHono<E$1 extends Env = Env, S$1 extends Schema = {}, BasePa
+     middleware: routeMiddleware,
+     hide,
+     ...route
+-  }: R, handler: Handler<R["middleware"] extends MiddlewareHandler[] | MiddlewareHandler ? RouteMiddlewareParams<R>["env"] & E$1 : E$1, P, I, R extends {
+-    responses: {
+-      [statusCode: number]: {
+-        content: {
+-          [mediaType: string]: ZodMediaTypeObject;
+-        };
+-      };
+-    };
+-  } ? MaybePromise<RouteConfigToTypedResponse<R>> : MaybePromise<RouteConfigToTypedResponse<R>> | MaybePromise<Response>>, hook?: Hook<I, E$1, P, R extends {
+-    responses: {
+-      [statusCode: number]: {
+-        content: {
+-          [mediaType: string]: ZodMediaTypeObject;
+-        };
+-      };
+-    };
+-  } ? MaybePromise<RouteConfigToTypedResponse<R>> | undefined : MaybePromise<RouteConfigToTypedResponse<R>> | MaybePromise<Response> | undefined> | undefined) => OpenAPIHono<E$1, S$1 & ToSchema<R["method"], MergePath<BasePath, P>, I, RouteConfigToTypedResponse<R>>, BasePath>;
++  }: R, handler: Handler<R["middleware"] extends MiddlewareHandler[] | MiddlewareHandler ? RouteMiddlewareParams<R>["env"] & E$1 : E$1, P, I, MaybePromise<Response | TypedResponse<any, StatusCode, "json" | "sse" | "ws">>>, hook?: Hook<I, E$1, P, MaybePromise<TypedResponse<any, StatusCode, "json" | "sse" | "ws"> | Response | void>> | undefined) => OpenAPIHono<E$1, S$1 & ToSchema<R["method"], MergePath<BasePath, P>, I, RouteConfigToTypedResponse<R>>, BasePath>;
+   getOpenAPIDocument: (objectConfig: OpenAPIObjectConfig, generatorConfig?: OpenAPIGeneratorOptions) => OpenAPIObject;
+   getOpenAPI31Document: (objectConfig: OpenAPIObjectConfig, generatorConfig?: OpenAPIGeneratorOptions) => OpenAPIObject$1;
+   doc: <P extends string>(path: P, configureObject: OpenAPIObjectConfigure<E$1, P>, configureGenerator?: OpenAPIGeneratorConfigure<E$1, P>) => OpenAPIHono<E$1, S$1 & ToSchema<"get", MergePath<BasePath, P>, {}, {}>, BasePath>;

package/template/patches/@hono+zod-validator+0.7.6.patch

@@ -0,0 +1,13 @@
+diff --git a/node_modules/@hono/zod-validator/dist/index.d.ts b/node_modules/@hono/zod-validator/dist/index.d.ts
+index 0cbb442..8f29d1f 100644
+--- a/node_modules/@hono/zod-validator/dist/index.d.ts
++++ b/node_modules/@hono/zod-validator/dist/index.d.ts
+@@ -49,7 +49,7 @@ type Hook<T$1, E extends Env, P extends string, Target extends keyof ValidationT
+ type HasUndefined<T$1> = undefined extends T$1 ? true : false;
+ type ExtractValidationResponse<VF> = VF extends ((value: any, c: any) => infer R) ? R extends Promise<infer PR> ? PR extends TypedResponse<infer T, infer S, infer F> ? TypedResponse<T, S, F> : PR extends Response ? PR : PR extends undefined ? never : never : R extends TypedResponse<infer T, infer S, infer F> ? TypedResponse<T, S, F> : R extends Response ? R : R extends undefined ? never : never : never;
+ type DefaultInput<Target extends keyof ValidationTargets, In, Out> = {
+-  in: HasUndefined<In> extends true ? { [K in Target]?: [In] extends [ValidationTargets[K]] ? In : InferInput<In, K> } : { [K in Target]: [In] extends [ValidationTargets[K]] ? In : InferInput<In, K> };
++  in: { [K in Target]: [In] extends [ValidationTargets[K]] ? In : InferInput<In, K> };
+   out: { [K in Target]: Out };
+ };
+ declare function zValidatorFunction<T$1 extends ZodSchema, Target extends keyof ValidationTargets, E extends Env, P extends string, In = zInput<T$1>, Out = zOutput<T$1>, I extends Input = DefaultInput<Target, In, Out>, V extends I = I>(target: Target, schema: T$1): MiddlewareHandler<E, P, V>;

package/template/patches/hono+4.12.16.patch

@@ -0,0 +1,246 @@
+diff --git a/node_modules/hono/dist/cjs/client/client.js b/node_modules/hono/dist/cjs/client/client.js
+index 3c87c3b..615acdc 100644
+--- a/node_modules/hono/dist/cjs/client/client.js
++++ b/node_modules/hono/dist/cjs/client/client.js
+@@ -179,6 +179,46 @@ const hc = (baseUrl, options) => createProxy(function proxyCallback(opts) {
+     };
+     return establishWebSocket(targetUrl.toString());
+   }
++  if (method === "sse") {
++    const sseUrl = (0, import_utils.replaceUrlProtocol)(
++      opts.args[0] && opts.args[0].param ? (0, import_utils.replaceUrlParam)(url, opts.args[0].param) : url,
++      "http"
++    );
++    const targetUrl = new URL(sseUrl);
++    const queryParams = opts.args[0]?.query;
++    if (queryParams) {
++      Object.entries(queryParams).forEach(([key, value]) => {
++        if (Array.isArray(value)) {
++          value.forEach((item) => targetUrl.searchParams.append(key, item));
++        } else {
++          targetUrl.searchParams.set(key, value);
++        }
++      });
++    }
++    const establishSSE = options?.sse || ((u) => new EventSource(u));
++    return establishSSE(targetUrl.toString());
++  }
++  if (method === "image" || method === "svg") {
++    const req2 = new ClientRequestImpl(url, "get", {
++      buildSearchParams: buildSearchParamsOption
++    });
++    options ??= {};
++    const args = (0, import_utils.deepMerge)(options, { ...opts.args[1] });
++    return req2.fetch(opts.args[0], args).then((res) => {
++      if (method === "svg") {
++        return res.text();
++      }
++      return res.blob();
++    });
++  }
++  if (method === "download") {
++    const req2 = new ClientRequestImpl(url, "get", {
++      buildSearchParams: buildSearchParamsOption
++    });
++    options ??= {};
++    const args = (0, import_utils.deepMerge)(options, { ...opts.args[1] });
++    return req2.fetch(opts.args[0], args).then((res) => res.blob());
++  }
+   const req = new ClientRequestImpl(url, method, {
+     buildSearchParams: buildSearchParamsOption
+   });
+diff --git a/node_modules/hono/dist/client/client.js b/node_modules/hono/dist/client/client.js
+index 5bbbe00..b391357 100644
+--- a/node_modules/hono/dist/client/client.js
++++ b/node_modules/hono/dist/client/client.js
+@@ -165,6 +165,46 @@ var hc = (baseUrl, options) => createProxy(function proxyCallback(opts) {
+     };
+     return establishWebSocket(targetUrl.toString());
+   }
++  if (method === "sse") {
++    const sseUrl = replaceUrlProtocol(
++      opts.args[0] && opts.args[0].param ? replaceUrlParam(url, opts.args[0].param) : url,
++      "http"
++    );
++    const targetUrl = new URL(sseUrl);
++    const queryParams = opts.args[0]?.query;
++    if (queryParams) {
++      Object.entries(queryParams).forEach(([key, value]) => {
++        if (Array.isArray(value)) {
++          value.forEach((item) => targetUrl.searchParams.append(key, item));
++        } else {
++          targetUrl.searchParams.set(key, value);
++        }
++      });
++    }
++    const establishSSE = options?.sse || ((u) => new EventSource(u));
++    return establishSSE(targetUrl.toString());
++  }
++  if (method === "image" || method === "svg") {
++    const req2 = new ClientRequestImpl(url, "get", {
++      buildSearchParams: buildSearchParamsOption
++    });
++    options ??= {};
++    const args = deepMerge(options, { ...opts.args[1] });
++    return req2.fetch(opts.args[0], args).then((res) => {
++      if (method === "svg") {
++        return res.text();
++      }
++      return res.blob();
++    });
++  }
++  if (method === "download") {
++    const req2 = new ClientRequestImpl(url, "get", {
++      buildSearchParams: buildSearchParamsOption
++    });
++    options ??= {};
++    const args = deepMerge(options, opts.args?.[1] || {});
++    return req2.fetch(opts.args?.[0], args).then((res) => res.blob());
++  }
+   const req = new ClientRequestImpl(url, method, {
+     buildSearchParams: buildSearchParamsOption
+   });
+diff --git a/node_modules/hono/dist/types/client/types.d.ts b/node_modules/hono/dist/types/client/types.d.ts
+index b4effd2..500e4bc 100644
+--- a/node_modules/hono/dist/types/client/types.d.ts
++++ b/node_modules/hono/dist/types/client/types.d.ts
+@@ -4,6 +4,7 @@ import type { METHODS, METHOD_NAME_ALL_LOWERCASE } from '../router';
+ import type { Endpoint, ExtractSchema, KnownResponseFormat, ResponseFormat, Schema } from '../types';
+ import type { StatusCode, SuccessStatusCode } from '../utils/http-status';
+ import type { HasRequiredKeys } from '../utils/types';
++import type { WSClient, SSEClient, SSEClientFromOutput } from './ws-client';
+ /**
+  * Type representing the '$all' method name
+  */
+@@ -26,6 +27,7 @@ export type BuildSearchParamsFn = (query: Record<string, string | string[]>) =>
+ export type ClientRequestOptions<T = unknown> = {
+     fetch?: typeof fetch | HonoRequest;
+     webSocket?: (...args: ConstructorParameters<typeof WebSocket>) => WebSocket;
++    sse?: (url: string) => unknown;
+     /**
+      * Standard `RequestInit`, caution that this take highest priority
+      * and could be used to overwrite things that Hono sets for you, like `body | method | headers`.
+@@ -53,10 +55,11 @@ export type ClientRequestOptions<T = unknown> = {
+ } : {
+     headers: T | (() => T | Promise<T>);
+ });
++type IsEmptyObject<T> = keyof T extends never ? true : false;
+ export type ClientRequest<Prefix extends string, Path extends string, S extends Schema> = {
+     [M in keyof ExpandAllMethod<S>]: ExpandAllMethod<S>[M] extends Endpoint & {
+         input: infer R;
+-    } ? R extends object ? HasRequiredKeys<R> extends true ? (args: R, options?: ClientRequestOptions) => Promise<ClientResponseOfEndpoint<ExpandAllMethod<S>[M]>> : (args?: R, options?: ClientRequestOptions) => Promise<ClientResponseOfEndpoint<ExpandAllMethod<S>[M]>> : never : never;
++    } ? R extends object ? IsEmptyObject<R> extends true ? (options?: ClientRequestOptions) => Promise<ClientResponseOfEndpoint<ExpandAllMethod<S>[M]>> : HasRequiredKeys<R> extends true ? (args: R, options?: ClientRequestOptions) => Promise<ClientResponseOfEndpoint<ExpandAllMethod<S>[M]>> : (args?: R, options?: ClientRequestOptions) => Promise<ClientResponseOfEndpoint<ExpandAllMethod<S>[M]>> : never : never;
+ } & {
+     $url: <const Arg extends (S[keyof S] extends {
+         input: infer R;
+@@ -91,12 +94,41 @@ export type ClientRequest<Prefix extends string, Path extends string, S extends
+         query: Q;
+     } : {} : {}) | undefined = undefined>(arg?: Arg) => BuildPath<Path, Arg>;
+ } & (S['$get'] extends {
+-    outputFormat: 'ws';
+-} ? S['$get'] extends {
++    outputFormat: infer F;
++    output: infer O;
++} ? 'sse' extends F ? S['$get'] extends {
++    input: infer I;
++} ? {
++    $sse: (args?: I) => SSEClientFromOutput<O>;
++} : {} : {} : {}) & (S['$get'] extends {
++    outputFormat: infer F;
++    output: infer O;
++} ? 'ws' extends F ? S['$get'] extends {
++    input: infer I;
++} ? {
++    $ws: (args?: I) => WSClient<O>;
++} : {} : {} : {}) & (S['$get'] extends {
++    outputFormat: infer F;
++    output: infer O;
++} ? 'image' extends F ? S['$get'] extends {
++    input: infer I;
++} ? {
++    $image: (args?: I) => Promise<Blob>;
++} : {} : {} : {}) & (S['$get'] extends {
++    outputFormat: infer F;
++    output: infer O;
++} ? 'svg' extends F ? S['$get'] extends {
++    input: infer I;
++} ? {
++    $svg: (args?: I) => Promise<string>;
++} : {} : {} : {}) & (S['$get'] extends {
++    outputFormat: infer F;
++    output: infer O;
++} ? 'file' extends F ? S['$get'] extends {
+     input: infer I;
+ } ? {
+-    $ws: (args?: I) => WebSocket;
+-} : {} : {});
++    $download: (args?: I) => Promise<Blob>;
++} : {} : {} : {});
+ type ClientResponseOfEndpoint<T extends Endpoint = Endpoint> = T extends {
+     output: infer O;
+     outputFormat: infer F;
+diff --git a/node_modules/hono/dist/types/client/ws-client.d.ts b/node_modules/hono/dist/types/client/ws-client.d.ts
+new file mode 100644
+index 0000000..2cb2bd1
+--- /dev/null
++++ b/node_modules/hono/dist/types/client/ws-client.d.ts
+@@ -0,0 +1,46 @@
++export type WSStatus = 'connecting' | 'open' | 'closed' | 'reconnecting'
++
++export interface WSProtocol {
++  rpc: Record<string, { in: unknown; out: unknown }>
++  events: Record<string, unknown>
++}
++
++export interface SSEProtocol {
++  events: Record<string, unknown>
++}
++
++export interface WSClient<T = WSProtocol> {
++  readonly status: WSStatus
++  getSocket(): WebSocket | null
++
++  call<K extends keyof T['rpc']>(
++    method: K,
++    params: T['rpc'][K] extends { in: infer I } ? I : never,
++    timeout?: number
++  ): Promise<T['rpc'][K] extends { out: infer O } ? O : never>
++
++  emit<K extends keyof T['events']>(type: K, payload: T['events'][K]): void
++
++  on<K extends keyof T['events']>(type: K, handler: (payload: T['events'][K]) => void): () => void
++
++  onStatusChange(handler: (status: WSStatus) => void): () => void
++
++  close(): void
++}
++
++export interface SSEClient<T = SSEProtocol> {
++  readonly status: 'connecting' | 'open' | 'closed'
++
++  on<K extends keyof T['events']>(type: K, handler: (payload: T['events'][K]) => void): () => void
++
++  onStatusChange(handler: (status: 'connecting' | 'open' | 'closed') => void): () => void
++  onError(handler: (error: Error) => void): () => void
++
++  abort(): void
++}
++
++export type SSEClientFromOutput<O> = SSEClient<{ events: UnionToIntersection<ExtractEvents<O>> }>
++
++type ExtractEvents<O> = O extends { events: infer E } ? E : {}
++
++type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends ((k: infer I) => void) ? I : never
+diff --git a/node_modules/hono/dist/types/types.d.ts b/node_modules/hono/dist/types/types.d.ts
+index 74c3409..2cfce1b 100644
+--- a/node_modules/hono/dist/types/types.d.ts
++++ b/node_modules/hono/dist/types/types.d.ts
+@@ -524,7 +524,7 @@ export type AddParam<I, P extends string> = ParamKeys<P> extends never ? I : I e
+ };
+ type AddDollar<T extends string> = `$${Lowercase<T>}`;
+ export type MergePath<A extends string, B extends string> = B extends '' ? MergePath<A, '/'> : A extends '' ? B : A extends '/' ? B : A extends `${infer P}/` ? B extends `/${infer Q}` ? `${P}/${Q}` : `${P}/${B}` : B extends `/${infer Q}` ? Q extends '' ? A : `${A}/${Q}` : `${A}/${B}`;
+-export type KnownResponseFormat = 'json' | 'text' | 'redirect';
++export type KnownResponseFormat = 'json' | 'text' | 'redirect' | 'ws' | 'sse' | 'image' | 'svg' | 'file' | 'form';
+ export type ResponseFormat = KnownResponseFormat | string;
+ export type TypedResponse<T = unknown, U extends StatusCode = StatusCode, F extends ResponseFormat = T extends string ? 'text' : T extends JSONValue ? 'json' : ResponseFormat> = {
+     _data: T;

package/template/patches/typescript+5.8.3.patch

@@ -0,0 +1,26 @@
+diff --git a/node_modules/typescript/lib/_tsc.js b/node_modules/typescript/lib/_tsc.js
+index ae2f844..7355946 100644
+--- a/node_modules/typescript/lib/_tsc.js
++++ b/node_modules/typescript/lib/_tsc.js
+@@ -62701,7 +62701,7 @@ function createTypeChecker(host) {
+     if (!couldContainTypeVariables(type)) {
+       return type;
+     }
+-    if (instantiationDepth === 100 || instantiationCount >= 5e6) {
++    if (instantiationDepth === 1000 || instantiationCount >= 50e6) {
+       (_a = tracing) == null ? void 0 : _a.instant(tracing.Phase.CheckTypes, "instantiateType_DepthLimit", { typeId: type.id, instantiationDepth, instantiationCount });
+       error(currentNode, Diagnostics.Type_instantiation_is_excessively_deep_and_possibly_infinite);
+       return errorType;
+diff --git a/node_modules/typescript/lib/typescript.js b/node_modules/typescript/lib/typescript.js
+index 927ce9..01fcfa 100644
+--- a/node_modules/typescript/lib/typescript.js
++++ b/node_modules/typescript/lib/typescript.js
+@@ -67311,7 +67311,7 @@ function createTypeChecker(host) {
+     if (!couldContainTypeVariables(type)) {
+       return type;
+     }
+-    if (instantiationDepth === 100 || instantiationCount >= 5e6) {
++    if (instantiationDepth === 1000 || instantiationCount >= 50e6) {
+       (_a = tracing) == null ? void 0 : _a.instant(tracing.Phase.CheckTypes, "instantiateType_DepthLimit", { typeId: type.id, instantiationDepth, instantiationCount });
+       error2(currentNode, Diagnostics.Type_instantiation_is_excessively_deep_and_possibly_infinite);
+       return errorType;

package/template/playwright.config.ts

@@ -0,0 +1,60 @@
+import { defineConfig, devices } from '@playwright/test'
+import { fileURLToPath } from 'url'
+import { dirname, join } from 'path'
+import dotenv from 'dotenv'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+dotenv.config({ path: join(__dirname, '.env.test') })
+
+const browserExecutablePath = process.env.PLAYWRIGHT_TEST_BROWSER_EXECUTABLE_PATH
+
+export default defineConfig({
+  testDir: './tests/e2e',
+  testMatch: '**/*.spec.ts',
+  timeout: 30 * 1000,
+  expect: { timeout: 5 * 1000 },
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: 3,
+  globalSetup: join(__dirname, 'tests', 'e2e', 'global-setup.ts'),
+  globalTeardown: join(__dirname, 'tests', 'e2e', 'global-teardown.ts'),
+  reporter: [
+    ['html', { outputFolder: 'playwright-report/html', open: 'never' }],
+    ['json', { outputFile: 'playwright-report/results.json' }],
+    ['list'],
+  ],
+  outputDir: 'playwright-artifacts',
+  use: {
+    trace: 'on-first-retry',
+    screenshot: 'only-on-failure',
+    video: 'retain-on-failure',
+    locale: 'zh-CN',
+    timezoneId: 'Asia/Shanghai',
+    viewport: { width: 1280, height: 720 },
+  },
+  projects: [
+    {
+      name: 'chromium',
+      use: {
+        ...devices['Desktop Chrome'],
+        ...(browserExecutablePath
+          ? { launchOptions: { executablePath: browserExecutablePath } }
+          : {}),
+      },
+    },
+    {
+      name: 'firefox',
+      use: {
+        ...devices['Desktop Firefox'],
+      },
+    },
+    {
+      name: 'webkit',
+      use: {
+        ...devices['Desktop Safari'],
+      },
+    },
+  ],
+})