jax-hono 1.0.24 → 1.0.25

package/README.md

@@ -1,32 +1,32 @@
-# Jax-hono
-
-Jax 是本项目的轻量框架层。完整说明见 [docs/jax.md](docs/jax.md)。
-
-给 Codex、Claude 等代码代理看的维护说明见 [docs/agent.md](docs/agent.md)。
-
-维护 Jax 内部代码时按目录职责放置文件：
-
-```txt
-core/       Hono runtime、生命周期、Controller/Service
-middleware/ 框架中间件
-plugins/    插件定义、内置插件配置、内置插件实现
-build/      代码生成/扫描注册
-helpers/    框架辅助函数
-utils/      纯工具函数
-errors/     统一错误类型
-types/      框架公共类型
-```
-
-`.jax-hono` 目录只存在于调用项目中，不放在 `jax-hono` 包内，也不会从包内链接到某个项目。
-
-需要 `bun --compile` 的项目可以用 setup 包裹 Bun 构建命令：
-
-```powershell
-bun node_modules/jax-hono/setup.ts src/index.ts -- bun build src/index.ts --compile --production --target=bun-windows-x64 --outfile dist/app.exe
-```
-
-setup 会在执行命令期间临时把入口里对 `jax-hono` 的导入切到项目生成入口，命令结束后恢复源码。业务入口仍然写：
-
-```ts
-import { config, createApp } from 'jax-hono';
-```
+# Jax-hono
+
+Jax 是本项目的轻量框架层。完整说明见 [docs/jax.md](docs/jax.md)。
+
+给 Codex、Claude 等代码代理看的维护说明见 [docs/agent.md](docs/agent.md)。
+
+维护 Jax 内部代码时按目录职责放置文件：
+
+```txt
+core/       Hono runtime、生命周期、Controller/Service
+middleware/ 框架中间件
+plugins/    插件定义、内置插件配置、内置插件实现
+build/      代码生成/扫描注册
+helpers/    框架辅助函数
+utils/      纯工具函数
+errors/     统一错误类型
+types/      框架公共类型
+```
+
+`.jax-hono` 目录只存在于调用项目中，不放在 `jax-hono` 包内，也不会从包内链接到某个项目。
+
+需要 `bun --compile` 的项目可以用 setup 包裹 Bun 构建命令：
+
+```powershell
+bun node_modules/jax-hono/setup.ts src/index.ts -- bun build src/index.ts --compile --production --target=bun-windows-x64 --outfile dist/app.exe
+```
+
+setup 会在执行命令期间临时把入口里对 `jax-hono` 的导入切到项目生成入口，命令结束后恢复源码。业务入口仍然写：
+
+```ts
+import { config, createApp } from 'jax-hono';
+```

package/bin/jax.js

@@ -1,66 +1,66 @@
-#!/usr/bin/env node
-
-import { spawn } from "node:child_process";
-import { existsSync } from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const cliPath = path.join(__dirname, "jax.ts");
-
-function getBunCommand() {
-  const candidates = [];
-
-  if (process.env.BUN_INSTALL) {
-    candidates.push(
-      path.join(
-        process.env.BUN_INSTALL,
-        "bin",
-        process.platform === "win32" ? "bun.exe" : "bun",
-      ),
-    );
-  }
-
-  if (process.platform === "win32") {
-    const nodeDir = path.dirname(process.execPath);
-    candidates.push(
-      path.join(nodeDir, "bun.exe"),
-      path.join(nodeDir, "node_modules", "bun", "bin", "bun.exe"),
-    );
-  }
-
-  for (const candidate of candidates) {
-    if (existsSync(candidate)) {
-      return candidate;
-    }
-  }
-
-  return "bun";
-}
-
-const child = spawn(getBunCommand(), [cliPath, ...process.argv.slice(2)], {
-  stdio: "inherit",
-  windowsHide: true,
-});
-
-child.on("error", (error) => {
-  if (error.code === "ENOENT") {
-    console.error(
-      "未找到 Bun。请从 https://bun.sh 安装 Bun，或确认 bun 已加入 PATH。",
-    );
-    process.exit(1);
-  }
-
-  console.error(error.message);
-  process.exit(1);
-});
-
-child.on("exit", (code, signal) => {
-  if (signal) {
-    process.kill(process.pid, signal);
-    return;
-  }
-
-  process.exit(code ?? 0);
-});
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const cliPath = path.join(__dirname, "jax.ts");
+
+function getBunCommand() {
+  const candidates = [];
+
+  if (process.env.BUN_INSTALL) {
+    candidates.push(
+      path.join(
+        process.env.BUN_INSTALL,
+        "bin",
+        process.platform === "win32" ? "bun.exe" : "bun",
+      ),
+    );
+  }
+
+  if (process.platform === "win32") {
+    const nodeDir = path.dirname(process.execPath);
+    candidates.push(
+      path.join(nodeDir, "bun.exe"),
+      path.join(nodeDir, "node_modules", "bun", "bin", "bun.exe"),
+    );
+  }
+
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+  }
+
+  return "bun";
+}
+
+const child = spawn(getBunCommand(), [cliPath, ...process.argv.slice(2)], {
+  stdio: "inherit",
+  windowsHide: true,
+});
+
+child.on("error", (error) => {
+  if (error.code === "ENOENT") {
+    console.error(
+      "未找到 Bun。请从 https://bun.sh 安装 Bun，或确认 bun 已加入 PATH。",
+    );
+    process.exit(1);
+  }
+
+  console.error(error.message);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+
+  process.exit(code ?? 0);
+});

package/bin/jax.ts

@@ -1,5 +1,5 @@
-#!/usr/bin/env bun
-
+#!/usr/bin/env bun
+
 import { cac } from "cac";
 import { $ } from "bun";
 import path from "node:path";
@@ -41,12 +41,12 @@ cli
     const shouldUseNodeModules =
       existsSync(path.join(cwd, "package.json")) ||
       existsSync(path.join(cwd, "node_modules"));
-    const targetRoot = shouldUseNodeModules
-      ? path.join(cwd, "node_modules")
-      : cwd;
-    const targetName = shouldUseNodeModules ? "jax-hono" : "jax";
-    const targetDir = path.resolve(targetRoot, targetName);
-
+    const targetRoot = shouldUseNodeModules
+      ? path.join(cwd, "node_modules")
+      : cwd;
+    const targetName = shouldUseNodeModules ? "jax-hono" : "jax";
+    const targetDir = path.resolve(targetRoot, targetName);
+
     if (shouldUseNodeModules) {
       await mkdir(targetRoot, { recursive: true });
     }

package/build/build.ts

@@ -1,19 +1,19 @@
-import { setupJax } from '../setup'
-
-setupJax()
-
-const result = await Bun.build({
-  entrypoints: ['src/index.ts'],
-  outdir: 'dist',
-  target: 'bun',
-})
-
-if (!result.success) {
-  for (const log of result.logs) {
-    console.error(log)
-  }
-
-  process.exit(1)
-}
-
-console.log('Build completed.')
+import { setupJax } from '../setup'
+
+setupJax()
+
+const result = await Bun.build({
+  entrypoints: ['src/index.ts'],
+  outdir: 'dist',
+  target: 'bun',
+})
+
+if (!result.success) {
+  for (const log of result.logs) {
+    console.error(log)
+  }
+
+  process.exit(1)
+}
+
+console.log('Build completed.')

package/build/generate-config.ts

@@ -1,122 +1,122 @@
-import { existsSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'
-import { cwd } from 'node:process'
-import { join, parse, relative } from 'node:path'
-import { ensureGeneratedDir, generatedDir, projectDir } from './generated-path'
-
-const srcDir = join(cwd(), 'src')
-const configDir = join(srcDir, 'config')
-const typesFile = join(srcDir, 'types/index.ts')
-const outputFile = join(generatedDir, 'config.ts')
-const envStages = new Set([
-  'default',
-  'local',
-  'dev',
-  'development',
-  'test',
-  'staging',
-  'pre',
-  'uat',
-  'prod',
-  'production',
-])
-
-function toImportName(fileName: string, index: number) {
-  return `config${index}_${parse(fileName).name.replace(/[^a-zA-Z0-9_$]/g, '_')}`
-}
-
-function getStage(fileName: string) {
-  const stage = parse(fileName).name.split('.').at(-1)
-
-  if (stage && envStages.has(stage)) {
-    return stage
-  }
-
-  return 'base'
-}
-
-function getImportPath(fileName: string) {
-  const { dir, name } = parse(fileName)
-  const path = join(configDir, dir, name).replaceAll('\\', '/')
-
-  return path
-}
-
-function getConfigFiles() {
-  if (!existsSync(configDir)) {
-    return []
-  }
-
-  return readdirSync(configDir)
-    .filter((fileName) => /^config\.[^.]+\.ts$/.test(fileName))
-    .sort((left, right) => {
-      const stageWeight: Record<string, number> = {
-        base: 0,
-        default: 1,
-      }
-
-      const diff = (stageWeight[getStage(left)] ?? 2) - (stageWeight[getStage(right)] ?? 2)
-
-      if (diff !== 0) {
-        return diff
-      }
-
-      return left.localeCompare(right)
-    })
-}
-
-function hasProjectConfigType() {
-  if (!existsSync(typesFile)) {
-    return false
-  }
-
-  const source = readFileSync(typesFile, 'utf8')
-
-  return /\bexport\s+(?:type|interface)\s+ProjectConfig\b/.test(source)
-}
-
-export function generateConfig() {
-  const files = getConfigFiles()
-  const defaultConfigIndex = files.findIndex((fileName) => getStage(fileName) === 'default')
-  const imports = files.map((fileName, index) => {
-    return `import ${toImportName(fileName, index)} from '${getImportPath(fileName)}'`
-  })
-  const modules = files.map((fileName, index) => {
-    return `  { name: '${fileName}', stage: '${getStage(fileName)}', config: ${toImportName(fileName, index)} },`
-  })
-  const hasProjectTypes = hasProjectConfigType()
-  const typeImports = hasProjectTypes ? [`import type { ProjectConfig } from '${join(srcDir, 'types').replaceAll('\\', '/')}'`] : []
-  const projectConfigType = hasProjectTypes
-    ? 'export type { ProjectConfig }'
-    : defaultConfigIndex === -1
-    ? 'export type ProjectConfig = Record<string, unknown>'
-    : `export type ProjectConfig = typeof ${toImportName(files[defaultConfigIndex], defaultConfigIndex)}`
-  const content = `${[...typeImports, ...imports].join('\n')}
-
-export const configModules = [
-${modules.join('\n')}
-] as const
-
-${projectConfigType}
-
-declare module 'jax-hono/core/generated' {
-  interface JaxGenerated {
-    config: ProjectConfig
-  }
-}
-
-export default configModules
-`
-
-  ensureGeneratedDir()
-
-  if (existsSync(outputFile) && readFileSync(outputFile, 'utf8') === content) {
-    return
-  }
-
-  writeFileSync(outputFile, content)
-  console.log(`Generated ${relative(projectDir, outputFile)} with ${files.length} config file(s).`)
-}
-
-if (import.meta.main) {
-  generateConfig()
-}
+import { existsSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'
+import { cwd } from 'node:process'
+import { join, parse, relative } from 'node:path'
+import { ensureGeneratedDir, generatedDir, projectDir } from './generated-path'
+
+const srcDir = join(cwd(), 'src')
+const configDir = join(srcDir, 'config')
+const typesFile = join(srcDir, 'types/index.ts')
+const outputFile = join(generatedDir, 'config.ts')
+const envStages = new Set([
+  'default',
+  'local',
+  'dev',
+  'development',
+  'test',
+  'staging',
+  'pre',
+  'uat',
+  'prod',
+  'production',
+])
+
+function toImportName(fileName: string, index: number) {
+  return `config${index}_${parse(fileName).name.replace(/[^a-zA-Z0-9_$]/g, '_')}`
+}
+
+function getStage(fileName: string) {
+  const stage = parse(fileName).name.split('.').at(-1)
+
+  if (stage && envStages.has(stage)) {
+    return stage
+  }
+
+  return 'base'
+}
+
+function getImportPath(fileName: string) {
+  const { dir, name } = parse(fileName)
+  const path = join(configDir, dir, name).replaceAll('\\', '/')
+
+  return path
+}
+
+function getConfigFiles() {
+  if (!existsSync(configDir)) {
+    return []
+  }
+
+  return readdirSync(configDir)
+    .filter((fileName) => /^config\.[^.]+\.ts$/.test(fileName))
+    .sort((left, right) => {
+      const stageWeight: Record<string, number> = {
+        base: 0,
+        default: 1,
+      }
+
+      const diff = (stageWeight[getStage(left)] ?? 2) - (stageWeight[getStage(right)] ?? 2)
+
+      if (diff !== 0) {
+        return diff
+      }
+
+      return left.localeCompare(right)
+    })
+}
+
+function hasProjectConfigType() {
+  if (!existsSync(typesFile)) {
+    return false
+  }
+
+  const source = readFileSync(typesFile, 'utf8')
+
+  return /\bexport\s+(?:type|interface)\s+ProjectConfig\b/.test(source)
+}
+
+export function generateConfig() {
+  const files = getConfigFiles()
+  const defaultConfigIndex = files.findIndex((fileName) => getStage(fileName) === 'default')
+  const imports = files.map((fileName, index) => {
+    return `import ${toImportName(fileName, index)} from '${getImportPath(fileName)}'`
+  })
+  const modules = files.map((fileName, index) => {
+    return `  { name: '${fileName}', stage: '${getStage(fileName)}', config: ${toImportName(fileName, index)} },`
+  })
+  const hasProjectTypes = hasProjectConfigType()
+  const typeImports = hasProjectTypes ? [`import type { ProjectConfig } from '${join(srcDir, 'types').replaceAll('\\', '/')}'`] : []
+  const projectConfigType = hasProjectTypes
+    ? 'export type { ProjectConfig }'
+    : defaultConfigIndex === -1
+    ? 'export type ProjectConfig = Record<string, unknown>'
+    : `export type ProjectConfig = typeof ${toImportName(files[defaultConfigIndex], defaultConfigIndex)}`
+  const content = `${[...typeImports, ...imports].join('\n')}
+
+export const configModules = [
+${modules.join('\n')}
+] as const
+
+${projectConfigType}
+
+declare module 'jax-hono/core/generated' {
+  interface JaxGenerated {
+    config: ProjectConfig
+  }
+}
+
+export default configModules
+`
+
+  ensureGeneratedDir()
+
+  if (existsSync(outputFile) && readFileSync(outputFile, 'utf8') === content) {
+    return
+  }
+
+  writeFileSync(outputFile, content)
+  console.log(`Generated ${relative(projectDir, outputFile)} with ${files.length} config file(s).`)
+}
+
+if (import.meta.main) {
+  generateConfig()
+}