@open-feishu-card/cli 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cli.d.ts ADDED
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ export declare function run(argv?: string[]): number;
3
+ //# sourceMappingURL=cli.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAmHA,wBAAgB,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,MAAM,CAqBlE"}
package/dist/cli.js ADDED
@@ -0,0 +1,136 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * open-feishu-card CLI
4
+ *
5
+ * 用法:
6
+ * open-feishu-card lint <file...> 校验(Schema + 最佳实践)
7
+ * open-feishu-card validate <file...> 仅 Schema 校验
8
+ * open-feishu-card clean <file> [--out <file>] [--check] 剥离非标属性并写回
9
+ * open-feishu-card format <file> 格式化(2 空格 JSON)
10
+ * open-feishu-card build <file> [--out <file>] 编译为渲染器 RAW JSON
11
+ */
12
+ import { readFileSync, writeFileSync } from 'node:fs';
13
+ import { parse } from '@open-feishu-card/parser';
14
+ import { validateAst } from '@open-feishu-card/validator';
15
+ import { lintAst } from '@open-feishu-card/linter';
16
+ import { sanitize, compile } from '@open-feishu-card/compiler';
17
+ function parseArgs(argv) {
18
+ const [command, ...rest] = argv;
19
+ const files = [];
20
+ const args = { command: command ?? '', files };
21
+ for (let i = 0; i < rest.length; i++) {
22
+ const a = rest[i];
23
+ if (a === '--out')
24
+ args.out = rest[++i];
25
+ else if (a === '--check')
26
+ args.check = true;
27
+ else
28
+ files.push(a);
29
+ }
30
+ return args;
31
+ }
32
+ function fmtPos(p) {
33
+ return `${p.line}:${p.column}`;
34
+ }
35
+ function loadSource(file) {
36
+ return readFileSync(file, 'utf8');
37
+ }
38
+ function cmdLint(files, schemaOnly) {
39
+ let hasError = false;
40
+ for (const file of files) {
41
+ const src = loadSource(file);
42
+ const parsed = parse(src);
43
+ const vdiags = validateAst(parsed);
44
+ const { ast } = parsed;
45
+ const ldiags = schemaOnly ? [] : lintAst(ast);
46
+ const all = [
47
+ ...vdiags.map((d) => ({ sev: d.severity, line: d.range.start.line, col: d.range.start.column, msg: d.message })),
48
+ ...ldiags.map((d) => ({ sev: d.severity, line: d.range.start.line, col: d.range.start.column, msg: `[${d.rule}] ${d.message}` })),
49
+ ].sort((a, b) => a.line - b.line || a.col - b.col);
50
+ for (const d of all) {
51
+ const tag = d.sev === 'error' ? 'error' : d.sev === 'warning' ? 'warn' : 'info';
52
+ console.error(`${file}:${fmtPos({ line: d.line, column: d.col })} ${tag} ${d.msg}`);
53
+ if (d.sev === 'error')
54
+ hasError = true;
55
+ }
56
+ console.error(`✔ ${file}: ${all.filter((d) => d.sev === 'error').length} errors, ${all.length} diagnostics`);
57
+ }
58
+ return hasError ? 1 : 0;
59
+ }
60
+ function cmdClean(file, out, check) {
61
+ const src = loadSource(file);
62
+ const { data } = parse(src);
63
+ const { card, stripped } = sanitize(data, { mode: 'strip' });
64
+ if (check) {
65
+ if (stripped.length > 0) {
66
+ console.error(`${file}: 发现 ${stripped.length} 个非标属性:`);
67
+ for (const p of stripped)
68
+ console.error(` - ${p}`);
69
+ return 1;
70
+ }
71
+ console.error(`${file}: 干净,无非标属性`);
72
+ return 0;
73
+ }
74
+ const target = out ?? file;
75
+ writeFileSync(target, JSON.stringify(card, null, 2) + '\n');
76
+ console.error(`已净化 ${stripped.length} 个非标属性 → ${target}`);
77
+ for (const p of stripped)
78
+ console.error(` - 剥离 ${p}`);
79
+ return 0;
80
+ }
81
+ function cmdFormat(file, out) {
82
+ const { data, errors } = parse(loadSource(file));
83
+ if (errors.length) {
84
+ for (const e of errors)
85
+ console.error(`${file}:${fmtPos(e.range.start)} error ${e.message}`);
86
+ return 1;
87
+ }
88
+ const target = out ?? file;
89
+ writeFileSync(target, JSON.stringify(data, null, 2) + '\n');
90
+ console.error(`已格式化 → ${target}`);
91
+ return 0;
92
+ }
93
+ function cmdBuild(file, out) {
94
+ const { data, errors } = parse(loadSource(file));
95
+ if (errors.length) {
96
+ for (const e of errors)
97
+ console.error(`${file}:${fmtPos(e.range.start)} error ${e.message}`);
98
+ return 1;
99
+ }
100
+ const { raw } = compile(data);
101
+ if (out) {
102
+ writeFileSync(out, JSON.stringify(raw, null, 2) + '\n');
103
+ console.error(`已编译 RAW → ${out}`);
104
+ }
105
+ else {
106
+ console.log(JSON.stringify(raw, null, 2));
107
+ }
108
+ return 0;
109
+ }
110
+ export function run(argv = process.argv.slice(2)) {
111
+ const { command, files, out, check } = parseArgs(argv);
112
+ if (!command || files.length === 0) {
113
+ console.error('用法: open-feishu-card <lint|validate|clean|format|build> <file...> [--out file] [--check]');
114
+ return 2;
115
+ }
116
+ switch (command) {
117
+ case 'lint':
118
+ return cmdLint(files, false);
119
+ case 'validate':
120
+ return cmdLint(files, true);
121
+ case 'clean':
122
+ return cmdClean(files[0], out, check);
123
+ case 'format':
124
+ return cmdFormat(files[0], out);
125
+ case 'build':
126
+ return cmdBuild(files[0], out);
127
+ default:
128
+ console.error(`未知命令: ${command}`);
129
+ return 2;
130
+ }
131
+ }
132
+ // 直接执行时(非测试引入)
133
+ if (process.argv[1] && process.argv[1].endsWith('cli.js')) {
134
+ process.exit(run());
135
+ }
136
+ //# sourceMappingURL=cli.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAS/D,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAS,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC;IACrD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,OAAO;YAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;aACnC,IAAI,CAAC,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;;YACvC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,MAAM,CAAC,CAAmC;IACjD,OAAO,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,OAAO,CAAC,KAAe,EAAE,UAAmB;IACnD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;QACvB,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG;YACV,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAChH,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;SAClI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;YAChF,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACtF,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO;gBAAE,QAAQ,GAAG,IAAI,CAAC;QACzC,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,cAAc,CAAC,CAAC;IAC/G,CAAC;IACD,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAY,EAAE,KAAe;IAC3D,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7D,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,QAAQ,QAAQ,CAAC,MAAM,SAAS,CAAC,CAAC;YACvD,KAAK,MAAM,CAAC,IAAI,QAAQ;gBAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC;QACnC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC;IAC3B,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5D,OAAO,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,MAAM,YAAY,MAAM,EAAE,CAAC,CAAC;IAC1D,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,GAAY;IAC3C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,IAAI,MAAM;YAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/F,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC;IAC3B,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5D,OAAO,CAAC,KAAK,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC;IAClC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAY;IAC1C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,IAAI,MAAM;YAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/F,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,GAAG,EAAE,CAAC;QACR,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAI,GAAa,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACxD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,0FAA0F,CAAC,CAAC;QAC1G,OAAO,CAAC,CAAC;IACX,CAAC;IACD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/B,KAAK,UAAU;YACb,OAAO,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC9B,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACxC,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAClC,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACjC;YACE,OAAO,CAAC,KAAK,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;YAClC,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,eAAe;AACf,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;AACtB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { run } from './cli.js';
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,2 @@
1
+ export { run } from './cli.js';
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC"}
package/package.json ADDED
@@ -0,0 +1,45 @@
1
+ {
2
+ "name": "@open-feishu-card/cli",
3
+ "version": "0.1.0",
4
+ "description": "飞书卡片命令行工具:lint 校验、validate、clean 净化非标属性、format 格式化",
5
+ "type": "module",
6
+ "bin": {
7
+ "open-feishu-card": "./dist/cli.js"
8
+ },
9
+ "main": "./dist/index.js",
10
+ "types": "./dist/index.d.ts",
11
+ "exports": {
12
+ ".": {
13
+ "types": "./dist/index.d.ts",
14
+ "import": "./dist/index.js"
15
+ }
16
+ },
17
+ "files": [
18
+ "dist"
19
+ ],
20
+ "dependencies": {
21
+ "@open-feishu-card/compiler": "0.1.0",
22
+ "@open-feishu-card/linter": "0.1.0",
23
+ "@open-feishu-card/validator": "0.1.0",
24
+ "@open-feishu-card/parser": "0.1.0"
25
+ },
26
+ "devDependencies": {
27
+ "tsx": "^4.19.3",
28
+ "typescript": "^7.0.2",
29
+ "@types/node": "^22.20.1"
30
+ },
31
+ "license": "MIT",
32
+ "publishConfig": {
33
+ "access": "public"
34
+ },
35
+ "repository": {
36
+ "type": "git",
37
+ "url": "git+https://github.com/ztxtxwd/open-feishu-card-monorepo.git",
38
+ "directory": "packages/cli"
39
+ },
40
+ "scripts": {
41
+ "build": "tsc -p tsconfig.json && chmod +x dist/cli.js",
42
+ "typecheck": "tsc --noEmit -p tsconfig.json",
43
+ "test": "tsx --test test/*.test.ts"
44
+ }
45
+ }