Reviewing files that changed from the base of the PR and between 7680d96 and c322c77.

• pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

• .github/workflows/nodejs.yml (1 hunks)
• packages/taro-h5/package.json (3 hunks)
• packages/taro-h5/rollup.config.ts (3 hunks)
• packages/taro-h5/tsconfig.json (1 hunks)
• packages/taro-platform-harmony-hybrid/package.json (1 hunks)
• packages/taro-platform-harmony-hybrid/rollup.config.ts (4 hunks)
• packages/taro-platform-harmony-hybrid/tsconfig.json (1 hunks)
• packages/taro-platform-harmony/package.json (1 hunks)
• packages/taro-platform-harmony/rollup.config.ts (6 hunks)
• packages/taro-router/package.json (1 hunks)
• packages/taro-runtime/package.json (2 hunks)
• packages/taro-runtime/rollup.config.ts (2 hunks)

• .github/workflows/nodejs.yml
• packages/taro-runtime/rollup.config.ts
• packages/taro-runtime/package.json

• packages/taro-platform-harmony-hybrid/tsconfig.json
• packages/taro-platform-harmony/package.json
• packages/taro-h5/tsconfig.json
• packages/taro-platform-harmony-hybrid/rollup.config.ts
• packages/taro-router/package.json
• packages/taro-platform-harmony-hybrid/package.json
• packages/taro-platform-harmony/rollup.config.ts
• packages/taro-h5/package.json

packages/taro-h5/rollup.config.ts (4)

3-3: 从旧的 TypeScript 插件切换到 @rollup/plugin-typescript

此更改将 Rollup 的 TypeScript 插件从先前的插件（可能是 rollup-plugin-ts）更换为官方推荐的 @rollup/plugin-typescript，这有助于保持与最新 TypeScript 版本的兼容性并获得更好的社区支持。

---

6-6: 添加 rollup-plugin-dts 支持生成 TypeScript 声明文件

新增了 rollup-plugin-dts 插件以支持生成打包的 TypeScript 声明文件（.d.ts），这对于 TypeScript 项目的下游消费者非常重要。

---

28-28: 优化 TypeScript 插件配置

通过明确排除 rollup.config.ts 文件避免了构建过程中的自引用问题，这是一个良好的实践。

---

50-62:

❓ Verification inconclusive

重要：修复 definition.json API 生成问题

这些新增的配置是本次 PR 的核心修复点，特别是第二个配置块（第 57-62 行）:

1. 第一个配置生成打包的 ESM 模块（dist/index.esm.js）
2. 第二个配置生成打包的类型声明文件（dist/index.esm.d.ts）

根据第 59 行的注释，这个声明文件是 taro-platform-h5 生成 API 定义所必需的。缺少这个配置会导致 definition.json 中的 API 为空，正是本 PR 要修复的问题。这个修复有效地恢复了之前在 PR #17543 中移除的功能。

---

🏁 Script executed:

#!/bin/bash
# 验证构建后是否能正确生成 index.esm.d.ts 文件和 definition.json 文件

# 检查构建输出目录中是否存在这些文件
echo "检查 index.esm.d.ts 和相关文件的存在性："
fd "index\.esm\.d\.ts|definition\.json" packages/taro-h5/ -t f

# 检查 definition.json 解析器源码，了解它如何依赖 index.esm.d.ts
echo -e "\n解析器代码如何使用 index.esm.d.ts:"
fd "parser\.ts" packages/taro-h5/build -t f | xargs cat

Length of output: 366

---

为了确认 taro-platform-h5 中 parser.ts 如何依赖生成的 .d.ts，请执行以下脚本来定位并查看该文件的前几行内容：

---

🏁 Script executed:

#!/bin/bash
# 查找所有 parser.ts 文件的位置
echo "查找 parser.ts 文件位置："
fd 'parser\.ts' -t f

# 查看 taro-platform-h5 下 parser.ts 的前 30 行
parser_file=$(fd 'taro-platform-h5/build/definition-json/parser.ts' -t f | head -n1)
if [ -n "$parser_file" ]; then
  echo -e "\n查看 $parser_file 前 30 行内容："
  sed -n '1,30p' "$parser_file"
else
  echo "未找到 taro-platform-h5/build/definition-json/parser.ts 文件。"
fi

Length of output: 568

---

请再次定位并查看正确路径下的 parser.ts，确认它如何引用生成的 .d.ts 文件。执行：

---

🏁 Script executed:

#!/bin/bash
# 定位 parser.ts
parser_file=$(fd 'packages/taro-platform-h5/build/definition-json/parser.ts' -t f | head -n1)
if [ -n "$parser_file" ]; then
  echo "找到文件：$parser_file，下面输出前50行内容："
  sed -n '1,50p' "$parser_file"
else
  echo "未找到 packages/taro-platform-h5/build/definition-json/parser.ts"
fi

Length of output: 244

---

请执行以下脚本，查看 packages/taro-platform-h5/build/definition-json/parser.ts 的前 200 行内容，以确认它如何引用生成的 .d.ts 文件：

---

🏁 Script executed:

#!/bin/bash
# 确认 parser.ts 路径并输出前200行
parser_file=$(fd 'packages/taro-platform-h5/build/definition-json/parser.ts' -t f | head -n1)
if [ -n "$parser_file" ]; then
  echo "找到 parser.ts：$parser_file，输出前200行内容："
  sed -n '1,200p' "$parser_file"
else
  echo "未找到 packages/taro-platform-h5/build/definition-json/parser.ts"
fi

Length of output: 244

---

重要：修复 definition.json API 生成问题

文件：packages/taro-h5/rollup.config.ts
行号：50–62

variesConfig.push({
  input: 'src/index.ts',
  output: {
    file: 'dist/index.esm.js',
    inlineDynamicImports: true
  }
}, {
  // 需要该配置才能生成打包的 .d.ts 文件供 taro-platform-h5/build/definition-json/parser.ts 生成 apis 配置
  input: 'src/index.ts',
  output: { file: 'dist/index.esm.d.ts' },
  plugins: [dts()]
})

这些新增配置是本次 PR 的核心修复点：

• 第一块用于打包并输出 ESM 模块（dist/index.esm.js）
• 第二块用于打包并输出类型声明文件（dist/index.esm.d.ts），供后续生成 definition.json 的解析器使用

⚠️ 请注意：目前在源码中未能直接定位到 packages/taro-platform-h5/build/definition-json/parser.ts，请手动确认该解析器是否已正确读取 dist/index.esm.d.ts，以避免缺少声明文件导致生成的 API 定义为空。