vitepress-plugin-md-api 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vitepress-plugin-md-api contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,181 @@
+# vitepress-plugin-md-api
+
+> 在 VitePress 的 Markdown 中使用 `@API('类型文件', '接口名')`，自动把 TypeScript interface / type 渲染为接口说明表格。
+
+生成的表格支持 **必填、默认值、废弃标记、readonly、方法签名、索引签名、JSDoc 注释**，并内置 **多语言（zh-CN / en-US）**，可扩展任意语言。
+
+## ✨ 特性
+
+- 🧩 一行指令 `@API('../types/user.ts', 'User')` 即生成 API 表格
+- 🔍 基于 TypeScript 编译器 API 解析 AST，类型/方法/索引签名准确还原
+- 📝 自动提取 JSDoc：说明、`@default` 默认值、`@deprecated` 废弃原因
+- 🌐 内置 zh-CN / en-US 界面文案，JSDoc 用 `@locale` 标签做多语言注释
+- 🗂️ 与 VitePress `locales` 目录结构联动，按路径自动切换语言
+- ⚠️ 解析失败时输出警告块，不中断构建
+- 🔥 通过 `addWatchFile` 监听类型文件，修改后文档热更新
+- 🛡️ 代码块内的 `@API(...)` 示例自动遮蔽，不会被误替换
+
+## 📦 安装
+
+```bash
+npm i -D vitepress-plugin-md-api
+# pnpm add -D vitepress-plugin-md-api
+# yarn add -D vitepress-plugin-md-api
+```
+
+## 🚀 快速开始
+
+### 1. 注册插件
+
+在 `.vitepress/config.mts` 中挂载：
+
+```ts
+import { defineConfig } from 'vitepress'
+import { mdApiPlugin } from 'vitepress-plugin-md-api'
+
+export default defineConfig({
+  vite: {
+    plugins: [mdApiPlugin()]
+  }
+})
+```
+
+### 2. 准备类型文件
+
+```ts
+// types/user.ts
+export interface User {
+  /** 用户名 */
+  name: string
+  /** 年龄 @default 18 */
+  age?: number
+  /** @deprecated 请使用 name */
+  oldName?: string
+  readonly id: string
+  /** 打招呼 */
+  greet(greeting: string, loud?: boolean): string
+  [key: string]: any
+}
+```
+
+### 3. 在 Markdown 中使用
+
+```md
+@API('../types/user.ts', 'User')
+```
+
+渲染结果：
+
+| 属性名 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| `name` | `string` | 是 | - | 用户名 |
+| `age` | `number` | 否 | `18` | 年龄 |
+| `oldName` | `string` | 否 | - | **（已废弃：请使用 name）** |
+| `id` _(readonly)_ | `string` | 是 | - | - |
+| `greet(greeting: string, loud?: boolean)` | `string` | 是 | - | 打招呼 |
+| `[key: string]` | `any` | 是 | - | - |
+
+类型文件路径相对当前 markdown 文件解析，省略扩展名时会自动尝试 `.ts` / `.d.ts` / `.tsx` / `.mts` / `.cts`。
+
+## 🌐 多语言支持
+
+### 指令显式指定
+
+第三个参数为语言代码：
+
+```md
+@API('../types/user.ts', 'User', 'en-US')
+```
+
+### JSDoc 多语言注释
+
+在类型文件中用 `@locale <语言代码> <说明>` 提供翻译，未命中的语言回退到默认注释：
+
+```ts
+export interface Book {
+  /**
+   * 书名
+   * @locale en-US Book title
+   * @locale ja-JP 書名
+   */
+  title: string
+}
+```
+
+废弃原因同理：`@deprecatedLocale en-US Use name instead`。
+
+### 语言判定优先级
+
+1. 指令第三参数（支持前缀匹配，`en` 可命中 `en-US`）
+2. Markdown 文件路径前缀检测（VitePress `locales` 目录如 `doc/en/`）
+3. 插件选项 `defaultLocale`（默认 `zh-CN`）
+
+### 自定义语言包
+
+通过 `locales` 选项扩展或覆盖语言包，只写需要覆盖的字段，其余回退内置文案：
+
+```ts
+mdApiPlugin({
+  defaultLocale: 'zh-CN',
+  locales: {
+    'ja-JP': {
+      columnName: 'プロパティ',
+      columnType: '型',
+      columnRequired: '必須',
+      columnDefault: 'デフォルト',
+      columnDescription: '説明',
+      yes: 'はい',
+      no: 'いいえ',
+      readonlyLabel: 'readonly',
+      deprecated: (r) => `**（非推奨${r ? `：${r}` : ''}）**`,
+      noProperties: (n) => `\`${n}\` にプロパティがありません`,
+      parseFailed: '解析失敗：'
+    }
+  }
+})
+```
+
+`LocaleMessages` 完整字段：
+
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| `columnName` | string | 表头「属性名」 |
+| `columnType` | string | 表头「类型」 |
+| `columnRequired` | string | 表头「必填」 |
+| `columnDefault` | string | 表头「默认值」 |
+| `columnDescription` | string | 表头「说明」 |
+| `yes` / `no` | string | 是 / 否 |
+| `readonlyLabel` | string | readonly 标记文本 |
+| `deprecated` | `(reason?: string) => string` | 废弃标记 |
+| `noProperties` | `(name: string) => string` | 空接口提示 |
+| `parseFailed` | string | 解析失败警告块标题 |
+
+## ⚙️ 插件选项
+
+```ts
+interface MdApiPluginOptions {
+  /** 类型文件解析基准目录（绝对路径），默认先相对当前 md 目录再回退到此目录 */
+  baseDir?: string
+  /** 默认界面语言代码，默认 `zh-CN` */
+  defaultLocale?: string
+  /** 自定义 / 覆盖语言包，key 为语言代码，value 为部分或完整 LocaleMessages */
+  locales?: Record<string, Partial<LocaleMessages>>
+}
+```
+
+## 🏗️ 开发 & 发布
+
+```bash
+# 构建
+npm run build          # tsc 输出到 dist/
+
+# 本地测试发布
+npm pack
+
+# 发布到 npm
+npm publish
+```
+
+## 📄 License
+
+MIT

package/dist/generator.d.ts

@@ -0,0 +1,10 @@
+import type { InterfaceInfo } from './parser.js';
+import { type LocaleMessages } from './locales.js';
+/**
+ * 将接口信息生成为 GFM Markdown 表格。
+ * 表头与界面文案由 `t`（LocaleMessages）提供，属性说明按 `localeCode` 选取。
+ */
+export declare function generateTable(info: InterfaceInfo, localeCode: string, t: LocaleMessages): string;
+/** 解析失败时生成警告块，避免静默失效 */
+export declare function generateWarning(fileArg: string, name: string, t: LocaleMessages, message: string): string;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAyC9D;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,aAAa,EACnB,UAAU,EAAE,MAAM,EAClB,CAAC,EAAE,cAAc,GAChB,MAAM,CAmBR;AAED,wBAAwB;AACxB,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,cAAc,EACjB,OAAO,EAAE,MAAM,GACd,MAAM,CAMR"}

package/dist/generator.js

@@ -0,0 +1,61 @@
+import { pickLocale } from './locales.js';
+/** 转义表格单元格中的管道符与换行 */
+function escapeCell(text) {
+    return text
+        .replace(/\r?\n/g, ' ')
+        .replace(/\|/g, '\\|')
+        .trim();
+}
+/** 行内代码单元格：类型里的反引号替换为单引号，换行转为 <br> */
+function codeCell(code) {
+    const safe = code
+        .replace(/`/g, "'")
+        .replace(/\s*\n\s*/g, '<br>')
+        .trim();
+    return '`' + safe + '`';
+}
+/** 选取当前语言的说明文本，未命中时回退到默认 description */
+function localizeDescription(member, localeCode) {
+    return pickLocale(member.descriptions, localeCode) ?? member.description;
+}
+function descriptionCell(member, localeCode, t) {
+    const parts = [];
+    if (member.deprecated) {
+        const reason = pickLocale(member.deprecatedReasons, localeCode) ??
+            (typeof member.deprecated === 'string' ? member.deprecated : undefined);
+        parts.push(t.deprecated(reason));
+    }
+    const description = localizeDescription(member, localeCode);
+    if (description)
+        parts.push(escapeCell(description));
+    return parts.length ? parts.join(' ') : '-';
+}
+/**
+ * 将接口信息生成为 GFM Markdown 表格。
+ * 表头与界面文案由 `t`（LocaleMessages）提供，属性说明按 `localeCode` 选取。
+ */
+export function generateTable(info, localeCode, t) {
+    const header = `| ${t.columnName} | ${t.columnType} | ${t.columnRequired} | ${t.columnDefault} | ${t.columnDescription} |\n` +
+        '| --- | --- | --- | --- | --- |';
+    if (info.members.length === 0) {
+        return `${header}\n| - | - | - | - | ${t.noProperties(info.name)} |`;
+    }
+    const rows = info.members.map((m) => {
+        const name = codeCell(m.name) + (m.readonly ? ` _(${t.readonlyLabel})_` : '');
+        const type = codeCell(m.type);
+        const required = m.required ? t.yes : t.no;
+        const defaultValue = m.default ? codeCell(m.default) : '-';
+        const description = descriptionCell(m, localeCode, t);
+        return `| ${name} | ${type} | ${required} | ${defaultValue} | ${description} |`;
+    });
+    return [header, ...rows].join('\n');
+}
+/** 解析失败时生成警告块，避免静默失效 */
+export function generateWarning(fileArg, name, t, message) {
+    return [
+        '> [!WARNING]',
+        `> \`@API('${fileArg}', '${name}')\` ${t.parseFailed}`,
+        `> ${message.split('\n').join('\n> ')}`
+    ].join('\n');
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAuB,MAAM,cAAc,CAAA;AAE9D,sBAAsB;AACtB,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI;SACR,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,IAAI,EAAE,CAAA;AACX,CAAC;AAED,sCAAsC;AACtC,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,IAAI,GAAG,IAAI;SACd,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC;SAC5B,IAAI,EAAE,CAAA;IACT,OAAO,GAAG,GAAG,IAAI,GAAG,GAAG,CAAA;AACzB,CAAC;AAED,wCAAwC;AACxC,SAAS,mBAAmB,CAAC,MAAiB,EAAE,UAAkB;IAChE,OAAO,UAAU,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,WAAW,CAAA;AAC1E,CAAC;AAED,SAAS,eAAe,CACtB,MAAiB,EACjB,UAAkB,EAClB,CAAiB;IAEjB,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,MAAM,GACV,UAAU,CAAC,MAAM,CAAC,iBAAiB,EAAE,UAAU,CAAC;YAChD,CAAC,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QACzE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;IAClC,CAAC;IACD,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC3D,IAAI,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAA;IACpD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAmB,EACnB,UAAkB,EAClB,CAAiB;IAEjB,MAAM,MAAM,GACV,KAAK,CAAC,CAAC,UAAU,MAAM,CAAC,CAAC,UAAU,MAAM,CAAC,CAAC,cAAc,MAAM,CAAC,CAAC,aAAa,MAAM,CAAC,CAAC,iBAAiB,MAAM;QAC7G,iCAAiC,CAAA;IAEnC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,GAAG,MAAM,uBAAuB,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;IACtE,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QAC7E,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAC7B,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC1C,MAAM,YAAY,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;QAC1D,MAAM,WAAW,GAAG,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;QACrD,OAAO,KAAK,IAAI,MAAM,IAAI,MAAM,QAAQ,MAAM,YAAY,MAAM,WAAW,IAAI,CAAA;IACjF,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACrC,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,IAAY,EACZ,CAAiB,EACjB,OAAe;IAEf,OAAO;QACL,cAAc;QACd,aAAa,OAAO,OAAO,IAAI,QAAQ,CAAC,CAAC,WAAW,EAAE;QACtD,KAAK,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;KACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,83 @@
+import type { Plugin } from 'vite';
+import { type LocaleMessages } from './locales.js';
+export { parseInterface, resolveTypeFile } from './parser.js';
+export type { ApiMember, InterfaceInfo } from './parser.js';
+export { generateTable, generateWarning } from './generator.js';
+export { BUILTIN_LOCALES, detectLocaleFromPath, normalizeLocale, pickLocale, resolveLocaleCode, resolveLocaleMessages } from './locales.js';
+export type { LocaleMessages } from './locales.js';
+export interface MdApiPluginOptions {
+    /**
+     * 解析类型文件的基准目录（绝对路径）。
+     * 默认先相对当前 markdown 文件所在目录解析，再回退到该目录。
+     */
+    baseDir?: string;
+    /**
+     * 默认界面语言代码，默认 `zh-CN`。
+     * 内置支持 `zh-CN`、`en-US`，可通过 locales 选项扩展或覆盖。
+     */
+    defaultLocale?: string;
+    /**
+     * 自定义 / 覆盖界面文案。key 为语言代码，value 为部分或完整 LocaleMessages。
+     * 未提供的字段回退到内置语言包；未知语言则需提供完整字段。
+     *
+     * @example
+     * ```ts
+     * mdApiPlugin({
+     *   locales: {
+     *     'ja-JP': {
+     *       columnName: 'プロパティ',
+     *       columnType: '型',
+     *       // ...
+     *     },
+     *     'en-US': { yes: 'Y' } // 仅覆盖部分字段
+     *   }
+     * })
+     * ```
+     */
+    locales?: Record<string, Partial<LocaleMessages>>;
+}
+/**
+ * VitePress 插件：在 markdown 中使用
+ * `@API('类型文件地址', 'InterfaceName', '语言代码?')`
+ * 自动生成 TypeScript 接口说明表格。
+ *
+ * 语言解析优先级：指令第三参数 > markdown 路径前缀（VitePress locales 目录）
+ * > defaultLocale 选项（默认 zh-CN）。
+ *
+ * @example
+ * ```ts
+ * // .vitepress/config.mts
+ * import { defineConfig } from 'vitepress'
+ * import { mdApiPlugin } from 'vitepress-plugin-md-api'
+ *
+ * export default defineConfig({
+ *   vite: {
+ *     plugins: [
+ *       mdApiPlugin({
+ *         defaultLocale: 'zh-CN',
+ *         locales: {
+ *           'ja-JP': { columnName: 'プロパティ' } // 其余字段需补全
+ *         }
+ *       })
+ *     ]
+ *   }
+ * })
+ * ```
+ *
+ * ```md
+ * @API('../types/Module.d.ts', 'Book')
+ * @API('../types/Module.d.ts', 'Book', 'en-US')
+ * ```
+ *
+ * 类型文件中用 JSDoc 标签提供多语言说明：
+ * ```ts
+ * /**
+ *  * 书名
+ *  * @locale en-US Book title
+ *  *\/
+ * title: string
+ * ```
+ */
+export declare function mdApiPlugin(options?: MdApiPluginOptions): Plugin;
+export default mdApiPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAGlC,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7D,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAA;CAClD;AAyCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CA4DpE;AAED,eAAe,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,124 @@
+import path from 'node:path';
+import { parseInterface, resolveTypeFile } from './parser.js';
+import { generateTable, generateWarning } from './generator.js';
+import { BUILTIN_LOCALES, pickLocale, resolveLocaleCode, resolveLocaleMessages } from './locales.js';
+export { parseInterface, resolveTypeFile } from './parser.js';
+export { generateTable, generateWarning } from './generator.js';
+export { BUILTIN_LOCALES, detectLocaleFromPath, normalizeLocale, pickLocale, resolveLocaleCode, resolveLocaleMessages } from './locales.js';
+/**
+ * 匹配 @API('path/to/file', 'InterfaceName')，
+ * 第三参数为可选语言代码：@API('file', 'User', 'en-US')。
+ * 兼容单/双引号与多余空白。
+ */
+const DIRECTIVE_RE = /@API\(\s*(['"])([^'"]+)\1\s*,\s*(['"])([^'"]+)\3(?:\s*,\s*(['"])([^'"]+)\5)?\s*\)/g;
+/** 围栏代码块（``` / ~~~） */
+const FENCED_CODE_RE = /(^|\n)([ \t]*)(`{3,}|~{3,})[^\n]*\n[\s\S]*?\n[ \t]*\3[ \t]*(?=\n|$)/g;
+/** 行内代码 `...` */
+const INLINE_CODE_RE = /`[^`\n]*`/g;
+const PLACEHOLDER = '\u0000MDAPI_CODE_%s\u0000';
+/**
+ * 遮蔽代码块/行内代码，避免示例代码中的 @API(...) 被误替换。
+ * 返回替换后的文本与还原函数。
+ */
+function maskCode(source) {
+    const blocks = [];
+    const stash = (code) => {
+        blocks.push(code);
+        return PLACEHOLDER.replace('%s', String(blocks.length - 1));
+    };
+    const text = source
+        .replace(FENCED_CODE_RE, (m) => stash(m))
+        .replace(INLINE_CODE_RE, (m) => stash(m));
+    const restore = (s) => s.replace(new RegExp(`\u0000MDAPI_CODE_(\\d+)\u0000`, 'g'), (_, i) => blocks[Number(i)]);
+    return { text, restore };
+}
+/**
+ * VitePress 插件：在 markdown 中使用
+ * `@API('类型文件地址', 'InterfaceName', '语言代码?')`
+ * 自动生成 TypeScript 接口说明表格。
+ *
+ * 语言解析优先级：指令第三参数 > markdown 路径前缀（VitePress locales 目录）
+ * > defaultLocale 选项（默认 zh-CN）。
+ *
+ * @example
+ * ```ts
+ * // .vitepress/config.mts
+ * import { defineConfig } from 'vitepress'
+ * import { mdApiPlugin } from 'vitepress-plugin-md-api'
+ *
+ * export default defineConfig({
+ *   vite: {
+ *     plugins: [
+ *       mdApiPlugin({
+ *         defaultLocale: 'zh-CN',
+ *         locales: {
+ *           'ja-JP': { columnName: 'プロパティ' } // 其余字段需补全
+ *         }
+ *       })
+ *     ]
+ *   }
+ * })
+ * ```
+ *
+ * ```md
+ * @API('../types/Module.d.ts', 'Book')
+ * @API('../types/Module.d.ts', 'Book', 'en-US')
+ * ```
+ *
+ * 类型文件中用 JSDoc 标签提供多语言说明：
+ * ```ts
+ * /**
+ *  * 书名
+ *  * @locale en-US Book title
+ *  *\/
+ * title: string
+ * ```
+ */
+export function mdApiPlugin(options = {}) {
+    const messagesMap = resolveLocaleMessages(options.locales);
+    const localeKeys = Object.keys(messagesMap);
+    const defaultLocale = options.defaultLocale ?? 'zh-CN';
+    return {
+        name: 'vitepress-plugin-md-api',
+        enforce: 'pre',
+        transform(code, id) {
+            const cleanId = id.replace(/[?#].*$/, '');
+            if (!cleanId.endsWith('.md'))
+                return null;
+            if (!code.includes('@API('))
+                return null;
+            const markdownDir = path.dirname(cleanId);
+            const { text, restore } = maskCode(code);
+            let changed = false;
+            const replaced = text.replace(DIRECTIVE_RE, (_match, _q1, fileArg, _q2, nameArg, _q3, localeArg) => {
+                changed = true;
+                try {
+                    const typeFile = resolveTypeFile(fileArg, markdownDir, options.baseDir);
+                    this.addWatchFile(typeFile);
+                    const info = parseInterface(typeFile, nameArg);
+                    const localeCode = resolveLocaleCode({
+                        directive: localeArg,
+                        filePath: cleanId,
+                        localeKeys,
+                        defaultLocale
+                    });
+                    const t = pickLocale(messagesMap, localeCode) ??
+                        messagesMap[defaultLocale] ??
+                        BUILTIN_LOCALES['zh-CN'];
+                    return `\n\n${generateTable(info, localeCode, t)}\n\n`;
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    this.warn(`[vitepress-plugin-md-api] ${message}`);
+                    const fallback = messagesMap[defaultLocale] ?? BUILTIN_LOCALES['zh-CN'];
+                    return `\n\n${generateWarning(fileArg, nameArg, fallback, message)}\n\n`;
+                }
+            });
+            if (!changed)
+                return null;
+            return restore(replaced);
+        }
+    };
+}
+export default mdApiPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/locales.d.ts

@@ -0,0 +1,58 @@
+/** 插件界面文案，可按语言自定义或覆盖 */
+export interface LocaleMessages {
+    /** 表头：属性名 */
+    columnName: string;
+    /** 表头：类型 */
+    columnType: string;
+    /** 表头：必填 */
+    columnRequired: string;
+    /** 表头：默认值 */
+    columnDefault: string;
+    /** 表头：说明 */
+    columnDescription: string;
+    /** 必填：是 */
+    yes: string;
+    /** 必填：否 */
+    no: string;
+    /** readonly 标记文本 */
+    readonlyLabel: string;
+    /** 废弃标记，reason 为废弃原因（可能为空字符串） */
+    deprecated: (reason?: string) => string;
+    /** 接口无属性时的提示文本 */
+    noProperties: (interfaceName: string) => string;
+    /** 警告块标题：解析失败 */
+    parseFailed: string;
+}
+/** 内置语言包 */
+export declare const BUILTIN_LOCALES: Record<string, LocaleMessages>;
+/** 归一化语言代码：小写、下划线转连字符（zh_CN -> zh-cn） */
+export declare function normalizeLocale(code: string): string;
+/**
+ * 按语言代码从映射中取值。
+ * 匹配顺序：精确 → 大小写不敏感 → 前缀（en 匹配 en-US，zh-CN 匹配 zh）。
+ */
+export declare function pickLocale<T>(map: Record<string, T> | undefined, code: string): T | undefined;
+/**
+ * 合并内置语言包与用户自定义语言包。
+ * 用户只需提供部分字段，其余回退到内置文案；全新语言则需提供完整字段。
+ */
+export declare function resolveLocaleMessages(custom?: Record<string, Partial<LocaleMessages>>): Record<string, LocaleMessages>;
+/**
+ * 从 markdown 文件路径中检测语言：
+ * 路径段与 locale key 匹配，如 `doc/en/guide.md` → en-US、`doc/zh-CN/` → zh-CN。
+ * 适配 VitePress locales 的目录结构（根目录为默认语言，子目录为其他语言）。
+ */
+export declare function detectLocaleFromPath(filePath: string, localeKeys: string[]): string | undefined;
+/**
+ * 解析最终使用的语言代码，优先级：
+ * 1. 指令第三参数 `@API('file', 'Interface', 'en-US')`
+ * 2. markdown 文件路径前缀自动检测（VitePress locales 目录）
+ * 3. 插件选项 defaultLocale
+ */
+export declare function resolveLocaleCode(options: {
+    directive?: string;
+    filePath: string;
+    localeKeys: string[];
+    defaultLocale: string;
+}): string;
+//# sourceMappingURL=locales.d.ts.map

package/dist/locales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../src/locales.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,MAAM,WAAW,cAAc;IAC7B,aAAa;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY;IACZ,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY;IACZ,iBAAiB,EAAE,MAAM,CAAA;IACzB,WAAW;IACX,GAAG,EAAE,MAAM,CAAA;IACX,WAAW;IACX,EAAE,EAAE,MAAM,CAAA;IACV,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,iCAAiC;IACjC,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IACvC,kBAAkB;IAClB,YAAY,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,MAAM,CAAA;IAC/C,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,YAAY;AACZ,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CA2B1D,CAAA;AAED,yCAAyC;AACzC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,EAClC,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,SAAS,CAef;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,GAC/C,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAShC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;CACtB,GAAG,MAAM,CAST"}

package/dist/locales.js

@@ -0,0 +1,100 @@
+/** 内置语言包 */
+export const BUILTIN_LOCALES = {
+    'zh-CN': {
+        columnName: '属性名',
+        columnType: '类型',
+        columnRequired: '必填',
+        columnDefault: '默认值',
+        columnDescription: '说明',
+        yes: '是',
+        no: '否',
+        readonlyLabel: 'readonly',
+        deprecated: (reason) => `**（已废弃${reason ? `：${reason}` : ''}）**`,
+        noProperties: (name) => `\`${name}\` 暂无属性`,
+        parseFailed: '解析失败：'
+    },
+    'en-US': {
+        columnName: 'Property',
+        columnType: 'Type',
+        columnRequired: 'Required',
+        columnDefault: 'Default',
+        columnDescription: 'Description',
+        yes: 'Yes',
+        no: 'No',
+        readonlyLabel: 'readonly',
+        deprecated: (reason) => `**(Deprecated${reason ? `: ${reason}` : ''})**`,
+        noProperties: (name) => `\`${name}\` has no properties`,
+        parseFailed: 'failed to parse:'
+    }
+};
+/** 归一化语言代码：小写、下划线转连字符（zh_CN -> zh-cn） */
+export function normalizeLocale(code) {
+    return code.trim().toLowerCase().replace(/_/g, '-');
+}
+/**
+ * 按语言代码从映射中取值。
+ * 匹配顺序：精确 → 大小写不敏感 → 前缀（en 匹配 en-US，zh-CN 匹配 zh）。
+ */
+export function pickLocale(map, code) {
+    if (!map)
+        return undefined;
+    if (map[code])
+        return map[code];
+    const target = normalizeLocale(code);
+    for (const [key, value] of Object.entries(map)) {
+        if (normalizeLocale(key) === target)
+            return value;
+    }
+    const short = target.split('-')[0];
+    for (const [key, value] of Object.entries(map)) {
+        const keyLower = normalizeLocale(key);
+        if (keyLower === short || keyLower.startsWith(short + '-'))
+            return value;
+    }
+    return undefined;
+}
+/**
+ * 合并内置语言包与用户自定义语言包。
+ * 用户只需提供部分字段，其余回退到内置文案；全新语言则需提供完整字段。
+ */
+export function resolveLocaleMessages(custom) {
+    const result = { ...BUILTIN_LOCALES };
+    if (!custom)
+        return result;
+    for (const [code, partial] of Object.entries(custom)) {
+        const base = pickLocale(BUILTIN_LOCALES, code) ?? {};
+        result[code] = { ...base, ...partial };
+    }
+    return result;
+}
+/**
+ * 从 markdown 文件路径中检测语言：
+ * 路径段与 locale key 匹配，如 `doc/en/guide.md` → en-US、`doc/zh-CN/` → zh-CN。
+ * 适配 VitePress locales 的目录结构（根目录为默认语言，子目录为其他语言）。
+ */
+export function detectLocaleFromPath(filePath, localeKeys) {
+    const segments = filePath.split(/[\\/]/).map(normalizeLocale);
+    for (const key of localeKeys) {
+        const keyLower = normalizeLocale(key);
+        const short = keyLower.split('-')[0];
+        if (segments.some((seg) => seg === keyLower || seg === short)) {
+            return key;
+        }
+    }
+    return undefined;
+}
+/**
+ * 解析最终使用的语言代码，优先级：
+ * 1. 指令第三参数 `@API('file', 'Interface', 'en-US')`
+ * 2. markdown 文件路径前缀自动检测（VitePress locales 目录）
+ * 3. 插件选项 defaultLocale
+ */
+export function resolveLocaleCode(options) {
+    if (options.directive) {
+        const keyMap = Object.fromEntries(options.localeKeys.map((k) => [k, k]));
+        return pickLocale(keyMap, options.directive) ?? options.directive;
+    }
+    return (detectLocaleFromPath(options.filePath, options.localeKeys) ??
+        options.defaultLocale);
+}
+//# sourceMappingURL=locales.js.map

package/dist/locales.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.js","sourceRoot":"","sources":["../src/locales.ts"],"names":[],"mappings":"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"}

package/dist/parser.d.ts

@@ -0,0 +1,50 @@
+/** 接口成员（属性 / 方法 / 索引签名）解析结果 */
+export interface ApiMember {
+    /** 成员名称，方法会带参数列表，索引签名形如 [key: string] */
+    name: string;
+    /** 类型文本（属性为类型，方法为返回值类型） */
+    type: string;
+    /** 是否必填（没有 ? 修饰） */
+    required: boolean;
+    /** 是否 readonly */
+    readonly: boolean;
+    /** JSDoc 默认说明（未命中多语言标签时回退使用） */
+    description: string;
+    /**
+     * 多语言说明，来自 `@locale <code> <text>` 标签。
+     * @example
+     * ```ts
+     * /**
+     *  * 书名
+     *  * @locale en-US Book title
+     *  *\/
+     * title: string
+     * ```
+     */
+    descriptions?: Record<string, string>;
+    /** @default 标签内容 */
+    default?: string;
+    /** 是否标记 @deprecated，字符串为默认废弃原因 */
+    deprecated?: boolean | string;
+    /** 多语言废弃原因，来自 `@deprecatedLocale <code> <text>` 标签 */
+    deprecatedReasons?: Record<string, string>;
+}
+export interface InterfaceInfo {
+    /** 接口 / 类型名 */
+    name: string;
+    /** 解析来源文件绝对路径 */
+    sourceFile: string;
+    members: ApiMember[];
+}
+/**
+ * 解析 TypeScript 文件中指定的 interface 或对象类型别名。
+ * @param filePath  .ts / .d.ts 文件绝对路径
+ * @param name      interface 或 type 名称
+ */
+export declare function parseInterface(filePath: string, name: string): InterfaceInfo;
+/**
+ * 解析类型文件路径：优先相对当前 markdown 文件目录，其次相对 baseDir。
+ * 省略扩展名时自动尝试 .ts / .d.ts 等。
+ */
+export declare function resolveTypeFile(fileArg: string, markdownDir: string, baseDir?: string): string;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAIA,+BAA+B;AAC/B,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,oBAAoB;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,kBAAkB;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAC7B,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC3C;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,SAAS,EAAE,CAAA;CACrB;AAmJD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CA+C5E;AAKD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAoBR"}

package/dist/parser.js

@@ -0,0 +1,195 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import ts from 'typescript';
+/** 解析单个成员上的 JSDoc 正文 */
+function getJsDocDescription(node) {
+    const docs = node.jsDoc;
+    if (!docs || docs.length === 0)
+        return '';
+    const doc = docs[docs.length - 1];
+    return jsDocTextToString(doc.comment);
+}
+/** 读取指定 @tag 的文本内容 */
+function getJsDocTagText(node, tagName) {
+    const docs = node.jsDoc;
+    if (!docs)
+        return undefined;
+    for (const doc of docs) {
+        const tag = doc.tags?.find((t) => t.tagName.text === tagName);
+        if (tag) {
+            const text = jsDocTextToString(tag.comment);
+            return text || '';
+        }
+    }
+    return undefined;
+}
+function hasJsDocTag(node, tagName) {
+    return getJsDocTagText(node, tagName) !== undefined;
+}
+/**
+ * 读取 `@tag <语言代码> <文本>` 形式的多语言标签，如：
+ * `@locale en-US Book title`、`@deprecatedLocale ja-JP xxx`
+ */
+function getLocaleTaggedTexts(node, tagName) {
+    const docs = node.jsDoc;
+    if (!docs)
+        return undefined;
+    const map = {};
+    for (const doc of docs) {
+        for (const tag of doc.tags ?? []) {
+            if (tag.tagName.text !== tagName)
+                continue;
+            const text = jsDocTextToString(tag.comment);
+            const match = /^(\S+)\s+([\s\S]+)$/.exec(text);
+            if (match)
+                map[match[1]] = match[2].trim();
+        }
+    }
+    return Object.keys(map).length > 0 ? map : undefined;
+}
+/** JSDoc comment 可能是 string，也可能是 NodeArray（TS 4.7+） */
+function jsDocTextToString(comment) {
+    if (!comment)
+        return '';
+    if (typeof comment === 'string')
+        return comment.trim();
+    return comment
+        .map((c) => ('text' in c ? c.text : ''))
+        .join('')
+        .trim();
+}
+function isReadonly(node) {
+    return (ts.canHaveModifiers(node) &&
+        !!ts.getModifiers(node)?.some((m) => m.kind === ts.SyntaxKind.ReadonlyKeyword));
+}
+/** 提取成员上的 JSDoc 公共字段（说明 / 默认值 / 废弃 / 多语言文案） */
+function docFields(node) {
+    const deprecatedReason = getJsDocTagText(node, 'deprecated');
+    return {
+        description: getJsDocDescription(node),
+        descriptions: getLocaleTaggedTexts(node, 'locale'),
+        default: getJsDocTagText(node, 'default'),
+        deprecated: hasJsDocTag(node, 'deprecated')
+            ? deprecatedReason || true
+            : undefined,
+        deprecatedReasons: getLocaleTaggedTexts(node, 'deprecatedLocale')
+    };
+}
+/** 将属性/方法/索引签名节点转换为 ApiMember */
+function memberToApi(member, sourceFile) {
+    if (ts.isPropertySignature(member) && member.name) {
+        const name = member.name.getText(sourceFile);
+        const type = member.type ? member.type.getText(sourceFile) : 'any';
+        return {
+            name,
+            type: normalizeType(type),
+            required: !member.questionToken,
+            readonly: isReadonly(member),
+            ...docFields(member)
+        };
+    }
+    if (ts.isMethodSignature(member) && member.name) {
+        const params = member.parameters
+            .map((p) => {
+            const pName = p.name.getText(sourceFile) + (p.questionToken ? '?' : '');
+            const pType = p.type ? p.type.getText(sourceFile) : 'any';
+            return `${pName}: ${normalizeType(pType)}`;
+        })
+            .join(', ');
+        const name = `${member.name.getText(sourceFile)}(${params})`;
+        const type = member.type ? member.type.getText(sourceFile) : 'void';
+        return {
+            name,
+            type: normalizeType(type),
+            required: !member.questionToken,
+            readonly: false,
+            ...docFields(member)
+        };
+    }
+    if (ts.isIndexSignatureDeclaration(member)) {
+        const params = member.parameters
+            .map((p) => {
+            const pType = p.type ? p.type.getText(sourceFile) : 'string';
+            return `[${p.name.getText(sourceFile)}: ${normalizeType(pType)}]`;
+        })
+            .join('');
+        return {
+            name: params,
+            type: normalizeType(member.type.getText(sourceFile)),
+            required: true,
+            readonly: isReadonly(member),
+            description: getJsDocDescription(member)
+        };
+    }
+    return null;
+}
+/** 折叠类型文本中的多余空白与换行 */
+function normalizeType(text) {
+    return text.replace(/\s*\n\s*/g, ' ').replace(/\s{2,}/g, ' ').trim();
+}
+/**
+ * 解析 TypeScript 文件中指定的 interface 或对象类型别名。
+ * @param filePath  .ts / .d.ts 文件绝对路径
+ * @param name      interface 或 type 名称
+ */
+export function parseInterface(filePath, name) {
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`类型文件不存在: ${filePath}`);
+    }
+    const sourceText = fs.readFileSync(filePath, 'utf-8');
+    const sourceFile = ts.createSourceFile(filePath, sourceText, ts.ScriptTarget.Latest, true, filePath.endsWith('.tsx') ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
+    let members;
+    const visit = (node) => {
+        if (members)
+            return;
+        if (ts.isInterfaceDeclaration(node) && node.name.text === name) {
+            members = node.members;
+            return;
+        }
+        if (ts.isTypeAliasDeclaration(node) &&
+            node.name.text === name &&
+            ts.isTypeLiteralNode(node.type)) {
+            members = node.type.members;
+            return;
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    if (!members) {
+        throw new Error(`在 ${path.basename(filePath)} 中未找到 interface/type "${name}"`);
+    }
+    const apiMembers = members
+        .map((m) => memberToApi(m, sourceFile))
+        .filter((m) => m !== null);
+    return {
+        name,
+        sourceFile: filePath,
+        members: apiMembers
+    };
+}
+/** 支持的类型文件扩展名 */
+const TYPE_EXTENSIONS = ['.ts', '.d.ts', '.tsx', '.mts', '.cts'];
+/**
+ * 解析类型文件路径：优先相对当前 markdown 文件目录，其次相对 baseDir。
+ * 省略扩展名时自动尝试 .ts / .d.ts 等。
+ */
+export function resolveTypeFile(fileArg, markdownDir, baseDir) {
+    const bases = [markdownDir];
+    if (baseDir)
+        bases.push(baseDir);
+    const candidates = [];
+    for (const base of bases) {
+        const direct = path.resolve(base, fileArg);
+        candidates.push(direct);
+        if (!path.extname(fileArg)) {
+            for (const ext of TYPE_EXTENSIONS)
+                candidates.push(direct + ext);
+        }
+    }
+    const found = candidates.find((c) => fs.existsSync(c) && fs.statSync(c).isFile());
+    if (!found) {
+        throw new Error(`无法解析类型文件 "${fileArg}"，已尝试:\n${candidates.map((c) => `  - ${c}`).join('\n')}`);
+    }
+    return found;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "vitepress-plugin-md-api",
+  "version": "0.1.0",
+  "description": "VitePress plugin: use @API('file', 'Interface') in markdown to generate TypeScript interface API tables",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "vitepress",
+    "vitepress-plugin",
+    "markdown",
+    "typescript",
+    "interface",
+    "api-table"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "typescript": "^5.5.0"
+  },
+  "peerDependencies": {
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0",
+    "vitepress": "^1.0.0 || ^2.0.0-alpha.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.0",
+    "vite": "^7.0.0",
+    "vitepress": "^2.0.0-alpha.20"
+  }
+}