Release v3.8.0

[caohuilin]

What's Changed

New Features 🎉

• feat: bundle version-matched docs into @modern-js/app-tools and generate AGENTS.md / CLAUDE.md pointing at them, so AI coding agents read docs matching the installed version in feat: make the bundled docs agent-readable #8781
• feat: agent knowledge supply — bundle version-matched English docs into the app-tools tarball (docs/) on publish, and generate AGENTS.md / CLAUDE.md in new projects created by @modern-js/create (skip with --no-agents-md). Existing projects can run npx @modern-js/create --agents-md-only to add or idempotently refresh these files after an upgrade (managed marker block is updated in place, user content is preserved). Also fixes boolean flags swallowing the following positional argument (e.g. create --sub my-app). in feat: make the bundled docs agent-readable #8781
• feat: support configuring the Mock directory through dev.mockDir in feat(app-tools): support dev.mockDir #8780

Bug Fixes 🐞

• fix: guard language detector process access for edge runtimes in fix(i18n-utils): guard globalThis.process access in languageDetector for edge runtimes #8751
• fix: type render route misses explicitly in fix(server-core): type matchRoute miss explicitly instead of casting [] to a matched tuple #8754
• fix(server-core): share the hono request context storage across duplicated module copies via a process-global AsyncLocalStorage, so BFF handlers no longer fail with "Can't call useContext out of server scope" when the host and plugin resolve different server-core instances in fix(server-core): share hono context storage across duplicated module copies #8776
• fix: make custom server output runnable under native ESM (pass moduleType, resolve .tsx / .jsx entries, transform JSX) in fix(server): make custom server output runnable under native ESM #8784
• fix: respect output.module for service-worker environment output in fix(builder): respect output.module with ESM output in the service-worker environment #8752

Other Changes ✨

• Export the programmatic deploy API and make it own the build, server plugin in feat(app-tools): support programmatic dev/build lifecycle #8783
• Export closeServer from the package root. Programmatic dev and start in feat(app-tools): support programmatic dev/build lifecycle #8783
• Export the programmatic build API and its options from the package root, initialize the builder when build is supplied through the app-context command, and close completed non-watch builds before returning. The onPrepare dist cleanup now also recognizes the programmatic appContext.command, so programmatic dev/build clean stale output the same way the CLI does (still honoring output.cleanDistPath and running before nestedRoutes.json is generated). in feat(app-tools): support programmatic dev/build lifecycle #8783

更新内容

新特性 🎉

• feat: 随包分发与安装版本一致的文档，并生成指向它的 AGENTS.md / CLAUDE.md，让 AI 编码助手读到与所装版本匹配的文档， 详情可查看 feat: make the bundled docs agent-readable #8781
• feat: Agent 知识供给 —— 发布时将版本匹配的英文文档打进 app-tools tarball（docs/），并在 @modern-js/create 新建项目时默认生成 AGENTS.md / CLAUDE.md（--no-agents-md 可跳过）。已有项目可运行 npx @modern-js/create --agents-md-only 在升级后补齐或幂等更新这两个文件（就地更新托管标记块，保留用户自定义内容）。同时修复布尔参数吞掉后续位置参数的问题（如 create --sub my-app）。， 详情可查看 feat: make the bundled docs agent-readable #8781
• feat: 支持通过 dev.mockDir 配置 Mock 目录， 详情可查看 feat(app-tools): support dev.mockDir #8780

Bug 修复 🐞

• fix: 修复语言检测器在 Edge 运行时访问 process 的问题， 详情可查看 fix(i18n-utils): guard globalThis.process access in languageDetector for edge runtimes #8751
• fix: 明确渲染路由未命中的类型， 详情可查看 fix(server-core): type matchRoute miss explicitly instead of casting [] to a matched tuple #8754
• fix(server-core): 通过进程级 AsyncLocalStorage 让 hono 请求上下文在重复加载的模块副本间共享，宿主与插件解析到不同 server-core 实例时 BFF 不再报 "Can't call useContext out of server scope"， 详情可查看 fix(server-core): share hono context storage across duplicated module copies #8776
• fix: 修复自定义 Server 在原生 ESM 下的产物不可运行问题（透传 moduleType、支持 .tsx / .jsx 入口解析、编译 JSX）， 详情可查看 fix(server): make custom server output runnable under native ESM #8784
• fix: 在 service-worker 环境中遵循 output.module 输出配置， 详情可查看 fix(builder): respect output.module with ESM output in the service-worker environment #8752

其他变更 ✨

• loading, and deploy hook lifecycle.， 详情可查看 feat(app-tools): support programmatic dev/build lifecycle #8783
• initialization now uses the app-context command when no CLI build command is
  present, including occupied port selection.， 详情可查看 feat(app-tools): support programmatic dev/build lifecycle #8783
• 从包根导出程序化 build API 及其选项，在通过 app-context command 传入 build 时初始化 builder，并在返回前关闭已完成的非 watch 构建。onPrepare 的 dist 清理现在也识别程序化的 appContext.command，使程序化 dev/build 与 CLI 一样清理陈旧产物（仍遵循 output.cleanDistPath，并在生成 nestedRoutes.json 之前执行）。， 详情可查看 feat(app-tools): support programmatic dev/build lifecycle #8783

[changeset-bot]

⚠️ No Changeset found

Latest commit: 20ac7ad

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[netlify]

✅ Deploy Preview for modernjs-byted ready!

Name	Link
🔨 Latest commit	20ac7ad
🔍 Latest deploy log	https://app.netlify.com/projects/modernjs-byted/deploys/6a74102950893c0008ffd09f
😎 Deploy Preview	https://deploy-preview-8796--modernjs-byted.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
Lighthouse	1 paths audited Performance: 99 (🟢 up 3 from production) Accessibility: 100 (no change from production) Best Practices: 100 (no change from production) SEO: 100 (no change from production) PWA: - View the detailed breakdown and full score reports
🤖 Make changes	Run an agent on this branch

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[github-actions]

Rsdoctor Bundle Diff Analysis

📊 Quick Summary

Project	Total Size	Change
bundle-diff	471.8 KB	0

Generated by Rsdoctor GitHub Action