lan-low-code-cli 0.0.0-stage → 2.0.0

package/dist/commands/control.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerControlCommand = registerControlCommand;
+const config_1 = require("../config");
+const constants_1 = require("../constants");
+const logger_1 = require("../utils/logger");
+const widgets_1 = require("../widgets");
+function createRegistry(opts) {
+    const runtime = (0, config_1.resolveRuntime)({ baseUrl: opts.baseUrl, token: opts.token });
+    return new widgets_1.WidgetRegistry({
+        baseUrl: runtime.baseUrl,
+        token: runtime.token,
+        timeout: runtime.timeout,
+    });
+}
+function flattenConfig(items, path = '', out = []) {
+    if (!Array.isArray(items))
+        return out;
+    items.forEach((item) => {
+        if (!item || typeof item !== 'object')
+            return;
+        const node = item;
+        const nextPath = node.key ? `${path}${path ? '.' : ''}${node.key}` : path;
+        if (node.key)
+            out.push({ path: nextPath, default: node.default });
+        if (Array.isArray(node.children))
+            flattenConfig(node.children, nextPath, out);
+    });
+    return out;
+}
+/** 桌面端控件包（排除移动端与子包） */
+function desktopPackages(packages) {
+    return packages.filter((p) => p.name.startsWith('@elem/xform-') && !p.name.startsWith('@elem/xform-m-'));
+}
+function registerControlCommand(program) {
+    const control = program
+        .command('control')
+        .description('查询环境可用的表单控件及其属性（--add-field 的取值依据）');
+    registerListCommand(control);
+    registerShowCommand(control);
+}
+function registerListCommand(control) {
+    control
+        .command('list')
+        .description('列出环境中可用的表单控件（数据源：@elem/index.json + 各控件 config.json）')
+        .option('--kind <kind>', '按 xform.kind 过滤：control（默认）| layout | appearance')
+        .option('--all', '包含全部 kind（不过滤）')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出')
+        .action(async (opts) => {
+        const registry = createRegistry(opts);
+        const packages = await registry.listPackages();
+        if (packages.length === 0) {
+            logger_1.logger.warn('未获取到控件包清单，请检查 --base-url / --token');
+            logger_1.logger.info('  数据源：{origin}/web/sys/artifact/elements/index.json');
+            return;
+        }
+        const desktops = desktopPackages(packages);
+        const mobileNames = new Set(packages.map((p) => p.name));
+        logger_1.logger.step(`解析 ${desktops.length} 个控件包的元数据（首次运行会逐个拉取并缓存，稍等）`);
+        const rows = [];
+        for (const pkg of desktops) {
+            const meta = await registry.get(pkg.name);
+            const xform = (meta?.xform ?? {});
+            const short = pkg.name.replace(/^@elem\/xform-/, '');
+            const mobileCandidate = `@elem/xform-m-${short}`;
+            const type = String(xform.type ?? '');
+            rows.push({
+                type,
+                dataType: String(xform.dataType ?? ''),
+                dictType: String(xform.dictType ?? ''),
+                for: String(xform.for ?? ''),
+                kind: String(xform.kind ?? ''),
+                desktop: pkg.name,
+                mobile: mobileNames.has(mobileCandidate) ? mobileCandidate : pkg.name,
+                registered: Boolean(constants_1.CONTROL_TYPE_MAP[type]),
+                options: xform.dictType === constants_1.OPTION_DICT_TYPE,
+            });
+        }
+        const kind = opts.all ? undefined : String(opts.kind ?? 'control');
+        const filtered = kind ? rows.filter((r) => r.kind === kind) : rows;
+        filtered.sort((a, b) => a.dataType === b.dataType ? a.type.localeCompare(b.type) : a.dataType.localeCompare(b.dataType));
+        if (opts.json) {
+            logger_1.logger.json(filtered);
+            return;
+        }
+        logger_1.logger.table(filtered.map((r) => ({
+            控件类型: r.type,
+            数据项类型: r.dataType,
+            适用: r.for,
+            桌面端: r.desktop,
+            移动端: r.mobile === r.desktop ? '同桌面端' : r.mobile,
+            备注: [r.registered ? '已登记' : '', r.options ? '支持选项' : ''].filter(Boolean).join('/'),
+        })));
+        const registered = filtered.filter((r) => r.registered).length;
+        logger_1.logger.info(logger_1.color.gray(`共 ${filtered.length} 个（kind=${kind ?? '全部'}）；其中 ${registered} 个已登记到 CONTROL_TYPE_MAP，可直接用于 --add-field`));
+    });
+}
+/* PART3 */
+/** control show：查看某个控件的详细元数据与属性面板配置项（含默认值） */
+function registerShowCommand(control) {
+    control
+        .command('show')
+        .description('查看某个控件的详细元数据与属性面板配置项（含默认值）')
+        .option('--element <pkg>', '控件包名，如 @elem/xform-money')
+        .option('--type <type>', '按控件逻辑类型查找，如 moneytext / select')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出')
+        .action(async (opts) => {
+        const registry = createRegistry(opts);
+        let pkg = opts.element;
+        if (!pkg && opts.type) {
+            const wanted = String(opts.type).trim();
+            pkg = (constants_1.CONTROL_TYPE_MAP[wanted] ?? constants_1.DEFAULT_CONTROL_MAP[wanted])?.desktop;
+            if (!pkg) {
+                logger_1.logger.step('按类型在控件包中查找: ' + wanted);
+                for (const item of desktopPackages(await registry.listPackages())) {
+                    const meta = await registry.get(item.name);
+                    if (meta?.xform?.type === wanted) {
+                        pkg = item.name;
+                        break;
+                    }
+                }
+            }
+        }
+        if (!pkg) {
+            logger_1.logger.warn('请用 --element <控件包名> 或 --type <控件类型> 指定控件');
+            return;
+        }
+        const meta = await registry.get(pkg);
+        if (!meta) {
+            logger_1.logger.warn('未获取到控件元数据: ' + pkg);
+            return;
+        }
+        const items = flattenConfig(meta.config);
+        if (opts.json) {
+            logger_1.logger.json({ pkg, meta, configItems: items });
+            return;
+        }
+        logger_1.logger.title('控件: ' + pkg);
+        logger_1.logger.info('  xform = ' + JSON.stringify(meta.xform));
+        logger_1.logger.info('  platform = ' + JSON.stringify(meta.platform));
+        logger_1.logger.info('  version = ' + JSON.stringify(meta.version));
+        logger_1.logger.info('  配置项（' + items.length + '）:');
+        // 属性面板的「字段权限」分组（对应 auth 的 required/editable/visible）
+        const perm = items.filter((i) => i.path.startsWith('control.fieldPermission'));
+        if (perm.length) {
+            logger_1.logger.info('  [字段权限] ' + perm.map((i) => i.path.split('.').pop()).join(' / '));
+        }
+        items.forEach((i) => {
+            const d = i.default !== undefined ? '  default=' + JSON.stringify(i.default) : '';
+            logger_1.logger.info('    ' + i.path + d);
+        });
+        logger_1.logger.info(logger_1.color.gray('提示: 默认值来自控件 config.json；未标 default 的属性由前端写死'));
+    });
+}

package/dist/commands/field.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFieldCommand = registerFieldCommand;
+const formDefine_1 = require("../api/formDefine");
+const client_1 = require("../client");
+const config_1 = require("../config");
+const logger_1 = require("../utils/logger");
+function createClient(opts) {
+    return new client_1.LcodeClient((0, config_1.resolveRuntime)({ baseUrl: opts.baseUrl, token: opts.token }));
+}
+/** 将字段数组扁平化输出 */
+function printFields(fields, json) {
+    if (json) {
+        logger_1.logger.json(fields);
+        return;
+    }
+    if (!fields || fields.length === 0) {
+        logger_1.logger.warn('未获取到字段');
+        return;
+    }
+    logger_1.logger.table(fields.map((f) => ({
+        字段名: f.fdName,
+        标题: f.fdLabel,
+        数据类型: f.fdDataType,
+        控件类型: f.fdType,
+        长度: f.fdLength ?? '',
+        系统字段: f.fdIsSystem ? '是' : '否',
+        uuid: f.uuid ?? '',
+    })));
+    logger_1.logger.info(logger_1.color.gray(`共 ${fields.length} 个字段`));
+}
+function registerFieldCommand(program) {
+    const field = program.command('field').description('获取可用字段（表单字段 / 外部表字段 / 字段库）');
+    field
+        .command('list')
+        .description('列出表单已有字段（--form-id）或外部表字段（--table）')
+        .option('--form-id <fdId>', '表单 id，从表单数据模型获取字段')
+        .option('--table <tableName>', '表名，从外部映射表获取字段')
+        .option('--model-id <fdId>', '数据模型 id，直接获取该模型字段')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出')
+        .action(async (opts) => {
+        if (!opts.formId && !opts.table && !opts.modelId) {
+            throw new Error('请至少指定 --form-id、--model-id 或 --table 之一');
+        }
+        const client = createClient(opts);
+        if (opts.formId) {
+            logger_1.logger.step(`加载表单数据模型：${opts.formId}`);
+            const models = await formDefine_1.dataModelApi.loadByFormId(client, opts.formId);
+            if (opts.json) {
+                logger_1.logger.json(models);
+                return;
+            }
+            if (!models || models.length === 0) {
+                logger_1.logger.warn('该表单暂无数据模型/字段');
+                return;
+            }
+            models.forEach((model) => {
+                logger_1.logger.title(`\n[${model.fdType}] ${model.fdName}  (表：${model.fdTableName})`);
+                printFields(model.fdFields ?? []);
+            });
+            return;
+        }
+        if (opts.modelId) {
+            logger_1.logger.step(`加载数据模型字段：${opts.modelId}`);
+            const fields = await formDefine_1.dataModelApi.getModelFields(client, opts.modelId);
+            printFields(fields ?? [], opts.json);
+            return;
+        }
+        logger_1.logger.step(`获取外部表字段：${opts.table}`);
+        const fields = await formDefine_1.dataModelApi.loadFieldMeta(client, { fdTableName: opts.table });
+        printFields(fields ?? [], opts.json);
+    });
+    field
+        .command('library')
+        .description('查询字段库列表')
+        .option('--keyword <keyword>', '按名称模糊搜索')
+        .option('--page-no <n>', '页码', (v) => Number(v), 1)
+        .option('--page-size <n>', '每页数量', (v) => Number(v), 20)
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .option('--json', '以 JSON 输出')
+        .action(async (opts) => {
+        const client = createClient(opts);
+        const conditions = opts.keyword
+            ? { fdName: { $contains: String(opts.keyword).trim() } }
+            : undefined;
+        const result = await formDefine_1.wordsFieldApi.list(client, {
+            pageNo: opts.pageNo,
+            pageSize: opts.pageSize,
+            conditions,
+            columns: ['fdId', 'fdName', 'fdCode', 'fdDisplayName', 'fdControlType', 'fdSourceType'],
+        });
+        const content = result?.content ?? [];
+        if (opts.json) {
+            logger_1.logger.json(result);
+            return;
+        }
+        logger_1.logger.table(content.map((item) => ({
+            fdId: item.fdId ?? '',
+            名称: item.fdName ?? '',
+            编码: item.fdCode ?? '',
+            显示名: item.fdDisplayName ?? '',
+            控件类型: item.fdControlType ?? '',
+            来源: item.fdSourceType ?? '',
+        })));
+        logger_1.logger.info(logger_1.color.gray(`共 ${content.length} 条`));
+    });
+    field
+        .command('gen-key')
+        .description('根据名称生成字段编码（编码自动填充）')
+        .option('--name <name>', '字段名称')
+        .option('--table <tableName>', '所属表名')
+        .option('--base-url <url>', '服务端基址（覆盖配置）')
+        .option('--token <token>', '鉴权 Token（覆盖配置）')
+        .action(async (opts) => {
+        const client = createClient(opts);
+        const code = await formDefine_1.wordsFieldApi.generateFdKey(client, {
+            fdName: opts.name,
+            fdTableName: opts.table,
+        });
+        logger_1.logger.success(`生成编码：${typeof code === 'string' ? code : JSON.stringify(code)}`);
+    });
+}