huozige-ontology-builder 0.1.0

package/README.md

@@ -0,0 +1,157 @@
+# huozige-ontology-builder
+
+一个可发布到 npm 的 TypeScript CLI，用纯规则方式解析活字格工程，提取：
+
+- 表结构
+- 公开服务端命令
+- 服务端命令在页面中的引用位置
+
+整个解析过程不使用 AI，只依赖文件扫描、JSON 结构分析和固定规则。
+
+## 解析范围
+
+- 表：`Tables/*.json`
+- 服务端命令：`ServerCommands/*.json`
+- 页面引用：`Pages/**/*.json`、`MasterPages/**/*.json`
+
+当前“公开服务端命令”的判定规则是：
+
+- `ServerCommands` 中存在 `PostRequestTrigger`
+
+## 输出模板
+
+CLI 输出遵循当前项目约定的模板结构：
+
+```json
+{
+  "repo-name": "simple-forguncy-reporting-system",
+  "huozige-version": "11.0.104.0",
+  "builder-version": "0.1.0",
+  "tables": [
+    {
+      "table-name": "工序",
+      "table-description": "存储工序信息",
+      "columns": [
+        {
+          "column-name": "工序编号",
+          "column-alias": "工序唯一标识",
+          "column-datatype": "Number",
+          "column-required": true,
+          "column-unique": true
+        }
+      ]
+    }
+  ],
+  "servercommands": [
+    {
+      "servercommand-name": "添加报工记录",
+      "servercommand-description": "PostRequestTrigger",
+      "verb": "post",
+      "input-arguments": [
+        {
+          "argument-name": "工序编号",
+          "argument-type": "number",
+          "argument-description": "type=number; source=Triggers.$values[].Parameters",
+          "argument-required": true
+        }
+      ],
+      "output-arguments": [
+        {
+          "argument-name": "OrderID",
+          "argument-type": "unknown",
+          "argument-description": "type=unknown; source=ReturnProperties",
+          "argument-required": true
+        }
+      ],
+      "used-by": []
+    }
+  ]
+}
+```
+
+字段说明：
+
+- `repo-name`：仓库目录名。
+- `huozige-version`：从 `DocumentInfo` 中读取的活字格版本。
+- `builder-version`：当前解析器版本，来自工具自身的 `package.json`。
+- `tables`：工程中的逻辑表定义。
+- `servercommands`：公开服务端命令列表。
+- `input-arguments`：来自 `PostRequestTrigger.Parameters`。
+- `input-arguments[].argument-type`：确定性推导出的参数类型。
+- `output-arguments`：来自 `ReturnProperties`，并结合命令流推导返回值类型。
+- `output-arguments[].argument-type`：确定性推导出的返回参数类型。
+- `used-by`：页面中对该服务端命令的引用位置。
+- `used-by[].page`：页面相对路径，不带 `.json` 后缀。
+- `used-by[].page-title`：页面标题，来自 `PageInfo.Title`。
+- `used-by[].location`：人类可读的位置说明。
+- `used-by[].component-type`：组件类型，例如 `Button`、`ComboBox`。
+- `used-by[].event`：触发事件，例如 `click`、`change`、`page-load`。
+
+## 安装
+
+默认使用方式：
+
+```bash
+npm install -g huozige-ontology-builder
+```
+
+## 使用
+
+安装完成后，直接执行 CLI：
+
+```bash
+hzg-ontology-builder https://gitee.com/nimotea/simple-forguncy-reporting-system --out sample.json
+```
+
+本地开发调试时再使用源码构建后的入口：
+
+```bash
+npm install
+npm run build
+node dist/cli.js https://gitee.com/nimotea/simple-forguncy-reporting-system --workdir /tmp --out sample.json
+```
+
+参数说明：
+
+- `--out <file>`：输出文件路径，默认 `./ontology-output.json`
+- `--workdir <dir>`：克隆目标仓库时使用的工作目录，默认 `./.tmp`
+
+## 代码结构
+
+- [src/core/parser.ts](/Users/ningwei/VSCodeProjects/huozige-ontology-builder/src/core/parser.ts)
+  负责聚合各解析器并合并结果
+- [src/core/parsers/server-commands.ts](/Users/ningwei/VSCodeProjects/huozige-ontology-builder/src/core/parsers/server-commands.ts)
+  负责解析公开服务端命令、输入参数、输出参数
+- [src/core/parsers/pages.ts](/Users/ningwei/VSCodeProjects/huozige-ontology-builder/src/core/parsers/pages.ts)
+  负责解析页面中的 `RequestServerCommand` 引用和触发位置
+- [src/core/parsers/tables.ts](/Users/ningwei/VSCodeProjects/huozige-ontology-builder/src/core/parsers/tables.ts)
+  负责解析逻辑表定义
+- [src/core/parsers/shared/forguncy-json.ts](/Users/ningwei/VSCodeProjects/huozige-ontology-builder/src/core/parsers/shared/forguncy-json.ts)
+  负责活字格导出 JSON 的容错解析
+
+## 设计约束
+
+- 不使用 AI 推断内容
+- 同一份输入应产生稳定输出
+- 不直接依赖活字格运行时
+- 优先解析导出的设计期 JSON，而不是运行时数据库
+
+## 示例文件
+
+- 样例模板：[src/sample.json](/Users/ningwei/VSCodeProjects/huozige-ontology-builder/src/sample.json)
+- 示例输出 1：[sample.json](/Users/ningwei/VSCodeProjects/huozige-ontology-builder/sample.json)
+- 示例输出 2：[sample-simple-reporting.json](/Users/ningwei/VSCodeProjects/huozige-ontology-builder/sample-simple-reporting.json)
+
+## 校验与发布
+
+```bash
+npm run check
+npm run build
+env npm_config_cache=/tmp/hzg-ontology-builder-npm-cache npm pack --dry-run
+```
+
+正式发布：
+
+```bash
+npm publish
+```

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import process from 'node:process';
+import { cloneRepo } from './core/git.js';
+import { ensureDir, exists, writeText } from './core/fs.js';
+import { buildSampleOutput, stringifyOutput } from './core/output.js';
+import { extractInterfaces } from './core/parser.js';
+import { CliError } from './core/errors.js';
+function printHelp() {
+    process.stdout.write([
+        'Usage: hzg-ontology-builder <git-url> [options]',
+        '',
+        'Options:',
+        '  --out <file>      Output JSON file path. Default: ./ontology-output.json',
+        '  --workdir <dir>   Directory used to clone the target repository. Default: ./.tmp',
+        '  -h, --help        Show this help message',
+        '',
+    ].join('\n'));
+}
+function parseArgs(argv) {
+    if (argv.includes('-h') || argv.includes('--help')) {
+        printHelp();
+        process.exit(0);
+    }
+    const positional = argv.filter((value) => !value.startsWith('-'));
+    if (positional.length === 0) {
+        throw new CliError('missing required git repository url');
+    }
+    const repoUrl = positional[0];
+    let outFile = path.resolve('ontology-output.json');
+    let workdir = path.resolve('.tmp');
+    for (let index = 0; index < argv.length; index += 1) {
+        const current = argv[index];
+        if (current === '--out') {
+            outFile = path.resolve(argv[index + 1] ?? '');
+            index += 1;
+        }
+        else if (current === '--workdir') {
+            workdir = path.resolve(argv[index + 1] ?? '');
+            index += 1;
+        }
+    }
+    return { repoUrl, outFile, workdir };
+}
+function repoDirName(repoUrl) {
+    const trimmed = repoUrl.replace(/\/+$/, '');
+    const lastSegment = trimmed.split('/').at(-1) ?? 'repo';
+    return lastSegment.endsWith('.git') ? lastSegment.slice(0, -4) : lastSegment;
+}
+async function main() {
+    const options = parseArgs(process.argv.slice(2));
+    await ensureDir(options.workdir);
+    const repoPath = path.join(options.workdir, repoDirName(options.repoUrl));
+    if (!(await exists(repoPath))) {
+        await cloneRepo(options.repoUrl, repoPath);
+    }
+    const result = await extractInterfaces(options.repoUrl, repoPath);
+    const output = await buildSampleOutput(result);
+    await writeText(options.outFile, stringifyOutput(output));
+    process.stdout.write(`analysis written to ${options.outFile}\n`);
+}
+main().catch((error) => {
+    if (error instanceof CliError) {
+        process.stderr.write(`${error.message}\n`);
+        process.exit(error.exitCode);
+        return;
+    }
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    process.stderr.write(`${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class CliError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, exitCode?: number);
+}

package/dist/core/errors.js

@@ -0,0 +1,9 @@
+export class CliError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = 'CliError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACK;IAAtC,YAAY,OAAe,EAAW,WAAW,CAAC;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,aAAQ,GAAR,QAAQ,CAAI;QAEhD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/core/fs.d.ts

@@ -0,0 +1,5 @@
+export declare function ensureDir(targetPath: string): Promise<void>;
+export declare function exists(targetPath: string): Promise<boolean>;
+export declare function readText(targetPath: string): Promise<string>;
+export declare function writeText(targetPath: string, content: string): Promise<void>;
+export declare function walkFiles(rootDir: string): Promise<string[]>;

package/dist/core/fs.js

@@ -0,0 +1,51 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+const DEFAULT_IGNORES = new Set([
+    '.git',
+    'node_modules',
+    'dist',
+    'coverage',
+    '.idea',
+    '.vscode',
+]);
+export async function ensureDir(targetPath) {
+    await fs.mkdir(targetPath, { recursive: true });
+}
+export async function exists(targetPath) {
+    try {
+        await fs.access(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function readText(targetPath) {
+    return fs.readFile(targetPath, 'utf8');
+}
+export async function writeText(targetPath, content) {
+    await ensureDir(path.dirname(targetPath));
+    await fs.writeFile(targetPath, content, 'utf8');
+}
+export async function walkFiles(rootDir) {
+    const results = [];
+    async function visit(currentDir) {
+        const entries = await fs.readdir(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (DEFAULT_IGNORES.has(entry.name)) {
+                continue;
+            }
+            const fullPath = path.join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                await visit(fullPath);
+            }
+            else if (entry.isFile()) {
+                results.push(fullPath);
+            }
+        }
+    }
+    await visit(rootDir);
+    results.sort((left, right) => left.localeCompare(right));
+    return results;
+}
+//# sourceMappingURL=fs.js.map

package/dist/core/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/core/fs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,MAAM;IACN,cAAc;IACd,MAAM;IACN,UAAU;IACV,OAAO;IACP,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAAkB;IAChD,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,UAAkB;IAC7C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAAkB;IAC/C,OAAO,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAAkB,EAAE,OAAe;IACjE,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1C,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe;IAC7C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,UAAU,KAAK,CAAC,UAAkB;QACrC,MAAM,OAAO,GAAa,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;YACxB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACzD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/git.d.ts

@@ -0,0 +1 @@
+export declare function cloneRepo(repoUrl: string, targetDir: string): Promise<void>;

package/dist/core/git.js

@@ -0,0 +1,24 @@
+import { spawn } from 'node:child_process';
+import { CliError } from './errors.js';
+function runGit(args, cwd) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('git', args, {
+            cwd,
+            stdio: 'inherit',
+        });
+        child.on('error', (error) => {
+            reject(new CliError(`failed to run git: ${error.message}`));
+        });
+        child.on('exit', (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new CliError(`git ${args.join(' ')} exited with code ${code ?? 'unknown'}`));
+        });
+    });
+}
+export async function cloneRepo(repoUrl, targetDir) {
+    await runGit(['clone', '--depth', '1', repoUrl, targetDir]);
+}
+//# sourceMappingURL=git.js.map

package/dist/core/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/core/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,SAAS,MAAM,CAAC,IAAc,EAAE,GAAY;IAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE;YAC/B,GAAG;YACH,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,MAAM,CAAC,IAAI,QAAQ,CAAC,sBAAsB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YAED,MAAM,CAAC,IAAI,QAAQ,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,qBAAqB,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe,EAAE,SAAiB;IAChE,MAAM,MAAM,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/core/json.d.ts

@@ -0,0 +1 @@
+export declare function stringifyStable(value: unknown): string;

package/dist/core/json.js

@@ -0,0 +1,16 @@
+export function stringifyStable(value) {
+    return JSON.stringify(sortValue(value), null, 2);
+}
+function sortValue(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortValue);
+    }
+    if (value && typeof value === 'object') {
+        const entries = Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, entryValue]) => [key, sortValue(entryValue)]);
+        return Object.fromEntries(entries);
+    }
+    return value;
+}
+//# sourceMappingURL=json.js.map

package/dist/core/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/core/json.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;aAC7D,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;aACpD,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAE5D,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/output.d.ts

@@ -0,0 +1,4 @@
+import type { ExtractionResult } from '../types/schema.js';
+import type { SampleOutput } from '../types/output.js';
+export declare function buildSampleOutput(result: ExtractionResult): Promise<SampleOutput>;
+export declare function stringifyOutput(output: SampleOutput): string;

package/dist/core/output.js

@@ -0,0 +1,169 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { readText } from './fs.js';
+export async function buildSampleOutput(result) {
+    return {
+        'repo-name': path.basename(result.repoPath),
+        'huozige-version': await readHuozigeVersion(result.repoPath),
+        'builder-version': await readBuilderVersion(),
+        tables: result.tables.map(toSampleTable).sort((left, right) => left['table-name'].localeCompare(right['table-name'])),
+        servercommands: result.interfaces
+            .map((item) => toSampleServerCommand(item))
+            .sort((left, right) => left['servercommand-name'].localeCompare(right['servercommand-name'])),
+    };
+}
+async function readHuozigeVersion(repoPath) {
+    try {
+        const content = await readText(path.join(repoPath, 'DocumentInfo'));
+        const parsed = JSON.parse(content);
+        return typeof parsed.VersionString === 'string' ? parsed.VersionString : 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+async function readBuilderVersion() {
+    try {
+        const currentFilePath = fileURLToPath(import.meta.url);
+        const packageJsonPath = path.resolve(path.dirname(currentFilePath), '../../package.json');
+        const content = await readText(packageJsonPath);
+        const parsed = JSON.parse(content);
+        return typeof parsed.version === 'string' ? parsed.version : 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function toSampleServerCommand(item) {
+    return {
+        'servercommand-name': item.name,
+        'servercommand-description': item.description || 'PostRequestTrigger',
+        verb: item.method.toLowerCase(),
+        'input-arguments': item.input
+            .map(toSampleArgument)
+            .sort((left, right) => left['argument-name'].localeCompare(right['argument-name'])),
+        'output-arguments': item.output
+            .map(toSampleArgument)
+            .sort((left, right) => left['argument-name'].localeCompare(right['argument-name'])),
+        'used-by': item.usages.map((usage) => toSampleUsage(item.name, usage)).sort(compareUsage),
+    };
+}
+function toSampleArgument(field) {
+    return {
+        'argument-name': field.name,
+        'argument-type': normalizeArgumentType(field.type),
+        'argument-description': formatArgumentDescription(field),
+        'argument-sharp': field.shape ?? null,
+        'argument-required': field.required,
+    };
+}
+function toSampleUsage(_serverCommandName, usage) {
+    return {
+        page: toPagePath(usage),
+        'page-title': usage.location.pageTitle ?? '',
+        location: usage.location.description,
+        'component-type': usage.location.trigger === 'page-load' ? 'page' : toComponentType(usage.location.componentName),
+        event: toEventName(usage.location.eventName, usage.location.trigger),
+    };
+}
+function compareUsage(left, right) {
+    return left.location.localeCompare(right.location);
+}
+export function stringifyOutput(output) {
+    return `${JSON.stringify(output, null, 2)}\n`;
+}
+function toSampleTable(table) {
+    return {
+        'table-name': table.name,
+        'table-description': table.description,
+        columns: table.columns.map(toSampleColumn).sort((left, right) => left['column-name'].localeCompare(right['column-name'])),
+        relationships: table.relationships
+            .map(toSampleRelationship)
+            .sort((left, right) => left['column-name'].localeCompare(right['column-name'])),
+    };
+}
+function toSampleColumn(column) {
+    return {
+        'column-name': column.name,
+        'column-alias': column.alias,
+        'column-datatype': column.dataType,
+        'column-required': column.required,
+        'column-unique': column.unique,
+    };
+}
+function toSampleRelationship(relationship) {
+    return {
+        'column-name': relationship.columnName,
+        'related-table': relationship.relatedTable,
+        'related-table-column-name': relationship.relatedTableColumnName,
+        'relationship-type': relationship.relationshipType,
+        'relationship-is-master-slave': relationship.relationshipIsMasterSlave,
+    };
+}
+function formatArgumentDescription(field) {
+    return field.description ?? '';
+}
+function normalizeArgumentType(type) {
+    return type === 'unknown' ? 'basic' : type;
+}
+function toPagePath(usage) {
+    return usage.location.filePath.replace(/\.json$/i, '');
+}
+function toComponentType(componentName) {
+    if (!componentName) {
+        return 'Unknown';
+    }
+    if (componentName.endsWith('按钮')) {
+        return 'Button';
+    }
+    if (componentName.endsWith('组合框')) {
+        return 'ComboBox';
+    }
+    if (componentName.endsWith('下拉列表')) {
+        return 'DropDownList';
+    }
+    if (componentName.endsWith('复选框')) {
+        return 'CheckBox';
+    }
+    if (componentName.endsWith('单选框')) {
+        return 'RadioButton';
+    }
+    if (componentName.endsWith('文本框')) {
+        return 'TextBox';
+    }
+    if (componentName.endsWith('图片')) {
+        return 'Image';
+    }
+    if (componentName.endsWith('超链接')) {
+        return 'Hyperlink';
+    }
+    return 'Unknown';
+}
+function toEventName(eventName, trigger) {
+    if (eventName === '点击') {
+        return 'click';
+    }
+    if (eventName === '值改变') {
+        return 'change';
+    }
+    if (eventName === '获得焦点') {
+        return 'focus';
+    }
+    if (eventName === '上传成功') {
+        return 'upload-success';
+    }
+    if (eventName === '页面加载') {
+        return 'page-load';
+    }
+    if (eventName === '定时触发') {
+        return 'timer';
+    }
+    if (trigger === 'button-click') {
+        return 'click';
+    }
+    if (trigger === 'page-load') {
+        return 'page-load';
+    }
+    return 'unknown';
+}
+//# sourceMappingURL=output.js.map

package/dist/core/output.js.map

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

package/dist/core/parser.d.ts

@@ -0,0 +1,2 @@
+import type { ExtractionResult } from '../types/schema.js';
+export declare function extractInterfaces(repoUrl: string, repoPath: string): Promise<ExtractionResult>;

package/dist/core/parser.js

@@ -0,0 +1,31 @@
+import path from 'node:path';
+import { loadPageUsages } from './parsers/pages.js';
+import { loadServerCommands } from './parsers/server-commands.js';
+import { loadTables } from './parsers/tables.js';
+import { uniqueSorted } from './parsers/shared/normalize.js';
+// 聚合三个确定性解析器，并把页面中的引用关系回填到公开服务端命令上。
+export async function extractInterfaces(repoUrl, repoPath) {
+    const normalizedRepoPath = path.resolve(repoPath);
+    const warnings = [];
+    const commands = await loadServerCommands(path.join(normalizedRepoPath, 'ServerCommands'), normalizedRepoPath, warnings);
+    const usages = await loadPageUsages(normalizedRepoPath, warnings);
+    const tables = await loadTables(path.join(normalizedRepoPath, 'Tables'), normalizedRepoPath, warnings);
+    for (const usage of usages) {
+        const target = commands.get(usage.name);
+        if (!target) {
+            warnings.push(`page usage references missing server command "${usage.name}" in ${usage.location.filePath}`);
+            continue;
+        }
+        target.usages.push(usage);
+        target.sourceFiles = uniqueSorted([...target.sourceFiles, usage.location.filePath]);
+    }
+    return {
+        repoUrl,
+        repoPath: normalizedRepoPath,
+        scannedAt: new Date().toISOString(),
+        interfaces: [...commands.values()].sort((left, right) => left.name.localeCompare(right.name)),
+        tables,
+        warnings: uniqueSorted(warnings),
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/core/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/core/parser.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,oCAAoC;AACpC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe,EAAE,QAAgB;IACvE,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CACvC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,EAC/C,kBAAkB,EAClB,QAAQ,CACT,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,EAAE,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IAEvG,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,QAAQ,CAAC,IAAI,CACX,iDAAiD,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAC7F,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,CAAC,WAAW,GAAG,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,OAAO;QACL,OAAO;QACP,QAAQ,EAAE,kBAAkB;QAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,UAAU,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7F,MAAM;QACN,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC;KACjC,CAAC;AACJ,CAAC"}

package/dist/core/parsers/pages.d.ts

@@ -0,0 +1,2 @@
+import type { InterfaceUsage } from '../../types/schema.js';
+export declare function loadPageUsages(repoRoot: string, warnings: string[]): Promise<InterfaceUsage[]>;