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

package/dist/index.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.program = void 0;
+const commander_1 = require("commander");
+const app_1 = require("./commands/app");
+const config_1 = require("./commands/config");
+const control_1 = require("./commands/control");
+const field_1 = require("./commands/field");
+const form_1 = require("./commands/form");
+const locale_1 = require("./commands/locale");
+const logger_1 = require("./utils/logger");
+const VERSION = '2.0.0';
+const program = new commander_1.Command();
+exports.program = program;
+program
+    .name('llc')
+    .description('低代码表单引擎命令行工具：创建表单 / 获取可用字段 / 自动完善表单字段')
+    .version(VERSION, '-v, --version', '查看版本号')
+    .helpOption('-h, --help', '显示帮助信息')
+    .addHelpCommand(false)
+    .option('--base-url <url>', '服务端基址（全局覆盖，等同各子命令参数）')
+    .option('--token <token>', '鉴权 Token（全局覆盖）');
+// 将全局选项透传到子命令
+program.hook('preAction', (thisCommand, actionCommand) => {
+    const globals = thisCommand.opts();
+    if (globals.baseUrl && actionCommand.getOptionValue('baseUrl') === undefined) {
+        actionCommand.setOptionValue('baseUrl', globals.baseUrl);
+    }
+    if (globals.token && actionCommand.getOptionValue('token') === undefined) {
+        actionCommand.setOptionValue('token', globals.token);
+    }
+});
+(0, config_1.registerConfigCommand)(program);
+(0, app_1.registerAppCommand)(program);
+(0, form_1.registerFormCommand)(program);
+(0, field_1.registerFieldCommand)(program);
+(0, locale_1.registerLocaleCommand)(program);
+(0, control_1.registerControlCommand)(program);
+/**
+ * 子命令组不再生成内置的 `help [command]`（英文文案），
+ * 统一由根部的 `llc help [command...]` 提供。
+ */
+function disableBuiltinHelpCommands(cmd) {
+    cmd.addHelpCommand(false);
+    cmd.commands.forEach(disableBuiltinHelpCommands);
+}
+disableBuiltinHelpCommands(program);
+/**
+ * `llc help [command...]`：显示帮助。
+ *
+ * 支持多级路径（`llc help form create`），commander 内置的 `help [command]`
+ * 只能解析一级，因此这里自行按段向下查找命令树。
+ */
+program
+    .command('help [command...]')
+    .description('显示帮助信息（支持多级，如 help form create）')
+    .action((parts = []) => {
+    let target = program;
+    for (const part of parts) {
+        const next = target.commands.find((cmd) => cmd.name() === part || cmd.aliases().includes(part));
+        if (!next) {
+            logger_1.logger.error(`未知命令：llc ${parts.join(' ')}（在 "${target.name()}" 下找不到 "${part}"）`);
+            process.exit(1);
+        }
+        target = next;
+    }
+    target.outputHelp();
+});
+program.addHelpText('after', `
+${logger_1.color.bold('从零到一')}
+  ${logger_1.color.gray('# 1. 配置服务端与 Token（一次性，也可用环境变量）')}
+  llc config set --base-url http://host/data --token <X-AUTH-TOKEN>
+
+  ${logger_1.color.gray('# 2. 创建应用（返回 appId，后端会同时创建默认首页）')}
+  llc app create --name 客户管理 --code crm
+
+  ${logger_1.color.gray('# 3. 查看环境可用控件（--add-field 第三段的取值依据）')}
+  llc control list
+  llc control show --type moneytext
+
+  ${logger_1.color.gray('# 4. 创建复杂表单并发布')}
+  llc form create --name 客户信息 --app-id <appId> --publish \\
+    --add-field "fd_col_name:客户名称" \\
+    --add-field "fd_col_level:客户等级:select" \\
+    --option "fd_col_level=A级,B级,C级" \\
+    --detail "联系人明细=fd_pname:姓名,fd_pphone:电话:phoneNumber" \\
+    --layout tabs --tabs "基本信息:fd_col_name,fd_col_level" --tab-layout grid --grid-columns 3 \\
+    --required "fd_col_name" --readonly "fd_col_code" --hidden "fd_col_inner" \\
+    --locale all
+
+  ${logger_1.color.gray('# 5. 校验与查看')}
+  llc app forms --id <appId>
+  llc form get --id <fdId>
+  llc field list --form-id <fdId>
+
+  ${logger_1.color.gray('# 6. 迭代调整（布局默认保持不动；--layout 才会重建布局）')}
+  llc form autofill --id <fdId> --apply --publish --locale all
+
+  ${logger_1.color.gray('# 7. 反悔 / 清理（均需 --yes 确认）')}
+  llc form delete --id <fdId> --yes
+  llc app delete --id <appId> --yes
+
+${logger_1.color.bold('常用查询')}
+  llc app list [--keyword 名称] [--no-auth]     应用列表（fdId 即 --app-id）
+  llc app forms --id <appId>                    应用下表单列表
+  llc locale list                               环境提供了哪些语言译文
+  llc field library [--keyword 关键词]           字段库
+
+环境变量：
+  LLC_BASE_URL    服务端基址
+  LLC_TOKEN       鉴权 Token
+
+更多信息：llc <command> --help（如 llc form create --help），或查阅 README.md
+`);
+async function main() {
+    try {
+        await program.parseAsync(process.argv);
+        // 显式退出：避免未关闭的 keep-alive 连接令 Windows 下的 Node 触发
+        // libuv 断言（Assertion failed: !(handle->flags & UV_HANDLE_CLOSING)）
+        // 而以非零退出码结束，干扰脚本判断。
+        process.exit(0);
+    }
+    catch (err) {
+        // 显示帮助/版本属于正常行为，退出码应为 0（commander 默认抛 1）
+        if (err instanceof commander_1.CommanderError &&
+            (err.code === 'commander.helpDisplayed' || err.code === 'commander.version')) {
+            process.exit(0);
+        }
+        logger_1.logger.error(err.message || String(err));
+        if (process.env.LLC_DEBUG) {
+            console.error(err);
+        }
+        process.exit(1);
+    }
+}
+main();

package/dist/types.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * 低代码表单引擎 - 公共类型定义
+ *
+ * 注意：此文件为 Node 端独立实现，不依赖任何前端包（@ekp-infra/*、@ekp-runtime/*）。
+ * 类型依据后端 mk-sys-xform 的 DTO 与 sys-xform 前端的持久化结构整理而来。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FORM_TYPE_LABEL = exports.FORM_TYPE_ALIAS = exports.EFormDefineType = void 0;
+/**
+ * 表单类型（对应后端 com.landray.sys.xform.constant.FormDefineType）
+ */
+var EFormDefineType;
+(function (EFormDefineType) {
+    /** 普通表单 */
+    EFormDefineType[EFormDefineType["Common"] = 1] = "Common";
+    /** 审批意见表单 */
+    EFormDefineType[EFormDefineType["General"] = 2] = "General";
+    /** 全局配置项表单 */
+    EFormDefineType[EFormDefineType["Config"] = 3] = "Config";
+    /** 弹窗表单 */
+    EFormDefineType[EFormDefineType["Modal"] = 4] = "Modal";
+    /** 通用表单 */
+    EFormDefineType[EFormDefineType["Template"] = 5] = "Template";
+    /** 引用者表单 */
+    EFormDefineType[EFormDefineType["Refer"] = 6] = "Refer";
+})(EFormDefineType || (exports.EFormDefineType = EFormDefineType = {}));
+exports.FORM_TYPE_ALIAS = {
+    common: EFormDefineType.Common,
+    '普通表单': EFormDefineType.Common,
+    general: EFormDefineType.General,
+    '审批意见表单': EFormDefineType.General,
+    config: EFormDefineType.Config,
+    '全局配置项表单': EFormDefineType.Config,
+    modal: EFormDefineType.Modal,
+    '弹窗表单': EFormDefineType.Modal,
+    template: EFormDefineType.Template,
+    '通用表单': EFormDefineType.Template,
+    refer: EFormDefineType.Refer,
+    reference: EFormDefineType.Refer,
+    '引用者表单': EFormDefineType.Refer,
+};
+exports.FORM_TYPE_LABEL = {
+    [EFormDefineType.Common]: '普通表单',
+    [EFormDefineType.General]: '审批意见表单',
+    [EFormDefineType.Config]: '全局配置项表单',
+    [EFormDefineType.Modal]: '弹窗表单',
+    [EFormDefineType.Template]: '通用表单',
+    [EFormDefineType.Refer]: '引用者表单',
+};

package/dist/utils/icon.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeIcon = normalizeIcon;
+const constants_1 = require("../constants");
+/**
+ * 规范化图标输入：始终输出合法 JSON 字符串。
+ *
+ * 用户传图标名时补全为标准结构；传 JSON 时原样规范化；不传则用内置默认图标。
+ * 表单（`fdIcon`）与应用（`fdIcon`）共用 —— sys-modeling 编辑页存在
+ * `JSON.parse(\`${fdIcon}\` || '{}')` 的写法，undefined 会变成真值字符串
+ * "undefined" 并抛 `SyntaxError`，导致编辑器无法进入。
+ */
+function normalizeIcon(input) {
+    const raw = input?.trim();
+    if (!raw)
+        return constants_1.DEFAULT_FORM_ICON_JSON;
+    if (raw.startsWith('{')) {
+        try {
+            return JSON.stringify(JSON.parse(raw));
+        }
+        catch {
+            /* 非合法 JSON，按图标名处理 */
+        }
+    }
+    return JSON.stringify({ ...constants_1.DEFAULT_FORM_ICON, name: raw });
+}

package/dist/utils/locale.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toLocaleCode = toLocaleCode;
+exports.normalizeLocale = normalizeLocale;
+exports.normalizeLangMap = normalizeLangMap;
+const constants_1 = require("../constants");
+/**
+ * 原始语言码 → 前端语言码。
+ *
+ * 与前端 `sys-xform/src/util/pureUtils.ts#getLocale` 完全一致：
+ * 取 `-` 后的第二段并首字母大写。
+ *
+ * ```ts
+ * toLocaleCode('zh-cn') // 'Cn'
+ * toLocaleCode('en-us') // 'Us'
+ * toLocaleCode('zh-tw') // 'Tw'
+ * toLocaleCode('zh')    // ''  （无 `-`，前端同样返回 undefined）
+ * ```
+ */
+function toLocaleCode(raw) {
+    if (!raw)
+        return '';
+    const parts = String(raw).split('-');
+    if (parts.length < 2)
+        return '';
+    const tail = parts[1].toLowerCase();
+    return tail.charAt(0).toUpperCase() + tail.slice(1);
+}
+/** 归一化用户传入的语言码：`cn` / `US` → `Cn` / `Us`；非法则抛错 */
+function normalizeLocale(input) {
+    const raw = input.trim();
+    if (!constants_1.LOCALE_PATTERN.test(raw)) {
+        throw new Error(`非法的语言码：${input}（应为 zh-cn/zh-tw 的第二段，如 Cn、Us、Tw）`);
+    }
+    return raw[0].toUpperCase() + raw.slice(1).toLowerCase();
+}
+/**
+ * 把接口返回的「原始语言码 → 文案」映射归一为「前端语言码 → 文案」。
+ *
+ * ```ts
+ * normalizeLangMap({ 'zh-cn': '请输入', 'en-us': 'Please enter' })
+ * // { Cn: '请输入', Us: 'Please enter' }
+ * ```
+ */
+function normalizeLangMap(raw) {
+    const result = {};
+    for (const [code, value] of Object.entries(raw)) {
+        const locale = toLocaleCode(code);
+        if (locale)
+            result[locale] = value;
+    }
+    return result;
+}

package/dist/utils/logger.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * 极简终端输出工具（零依赖，自行实现 ANSI 着色）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.color = void 0;
+const noColor = process.env.NO_COLOR !== undefined || process.env.LLC_NO_COLOR !== undefined;
+const wrap = (code) => (text) => (noColor ? text : `\u001b[${code}m${text}\u001b[0m`);
+exports.color = {
+    red: wrap(31),
+    green: wrap(32),
+    yellow: wrap(33),
+    blue: wrap(34),
+    magenta: wrap(35),
+    cyan: wrap(36),
+    gray: wrap(90),
+    bold: wrap(1),
+};
+/**
+ * 说明：除 `json()` 外全部输出到 **stderr**，
+ * 以便 `--json` 时可直接 `> out.json` 得到纯 JSON。
+ */
+exports.logger = {
+    info(msg) {
+        console.error(msg);
+    },
+    step(msg) {
+        console.error(`${exports.color.cyan('›')} ${msg}`);
+    },
+    success(msg) {
+        console.error(`${exports.color.green('✔')} ${msg}`);
+    },
+    warn(msg) {
+        console.error(`${exports.color.yellow('!')} ${msg}`);
+    },
+    error(msg) {
+        console.error(`${exports.color.red('✖')} ${msg}`);
+    },
+    title(msg) {
+        console.error(exports.color.bold(msg));
+    },
+    /** 输出 JSON（stdout） */
+    json(data) {
+        console.log(JSON.stringify(data, null, 2));
+    },
+    /** 输出表格（左对齐文本表格，stderr） */
+    table(rows, columns) {
+        if (!rows || rows.length === 0) {
+            console.error(exports.color.gray('（无数据）'));
+            return;
+        }
+        const cols = columns ?? Object.keys(rows[0]);
+        const widths = cols.map((c) => Math.max(displayWidth(c), ...rows.map((r) => displayWidth(formatCell(r[c])))));
+        const line = (cells) => cells.map((cell, i) => padRight(cell, widths[i])).join('  ');
+        console.error(exports.color.gray(line(cols)));
+        console.error(exports.color.gray(widths.map((w) => '─'.repeat(w)).join('──')));
+        rows.forEach((r) => console.error(line(cols.map((c) => formatCell(r[c])))));
+    },
+};
+function formatCell(value) {
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value === 'object')
+        return JSON.stringify(value);
+    return String(value);
+}
+/** 粗略计算显示宽度（中日韩字符按 2 计） */
+function displayWidth(text) {
+    let width = 0;
+    for (const ch of text) {
+        width += /[\u1100-\u115F\u2E80-\uA4CF\uAC00-\uD7A3\uF900-\uFAFF\uFE30-\uFE6F\uFF00-\uFF60\uFFE0-\uFFE6]/.test(ch) ? 2 : 1;
+    }
+    return width;
+}
+function padRight(text, width) {
+    const diff = width - displayWidth(text);
+    return diff > 0 ? text + ' '.repeat(diff) : text;
+}

package/dist/utils/random.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCmptKey = generateCmptKey;
+exports.generateTemplateCode = generateTemplateCode;
+exports.generateColId = generateColId;
+exports.uuid = uuid;
+exports.isMessageKey = isMessageKey;
+exports.generateMessageKey = generateMessageKey;
+exports.generateFieldName = generateFieldName;
+exports.cloneDeep = cloneDeep;
+exports.safeJsonParse = safeJsonParse;
+exports.toSnakeCase = toSnakeCase;
+exports.sanitizeIdentifier = sanitizeIdentifier;
+/** 与前端 generateCmptKey 一致的随机短串：type~xxxxxx */
+function generateCmptKey(type) {
+    return `${type}~${Math.random().toString(36).slice(-6)}`;
+}
+/** 生成模板编码 template_xxxxxx */
+function generateTemplateCode() {
+    return `template_${Date.now().toString(36).slice(-6)}`;
+}
+/** 生成列编码 fd_col_xxxxxx */
+function generateColId() {
+    return `fd_col_${Math.random().toString(36).slice(-6)}`;
+}
+/**
+ * 生成随机的多语言 messageKey 主体。
+ *
+ * 必须与前端 `sys-xform/src/util/runtimeUtil.ts#uuid` 完全一致：
+ *   Date.now().toString(36) + Math.random().toString(36).slice(2)
+ *
+ * ⚠️ 只能是 `[0-9a-z]`（base36），**不能含连字符**。
+ * 因为前端识别多语言标记的正则是 `/\!\{([\w\.]*)\}/gi`
+ * （见 `store/i18n/syncApi.ts#isCustomI18n`、`components/runtime/utils.ts`），
+ * `\w` 不包含 `-`，用 RFC4122 UUID 会导致 key 无法被识别，界面上会原样显示 `!{...}`。
+ */
+function uuid() {
+    return Date.now().toString(36) + Math.random().toString(36).slice(2);
+}
+/** 合法的多语言 messageKey：!{仅含 [\w.]} */
+const MESSAGE_KEY_PATTERN = /^!\{[\w.]+\}$/;
+/** 判断是否为前端可识别的多语言 messageKey */
+function isMessageKey(value) {
+    return !!value && MESSAGE_KEY_PATTERN.test(value);
+}
+/** 生成多语言 messageKey（!{xxxx}） */
+function generateMessageKey() {
+    return `!{${uuid()}}`;
+}
+/** 字段物理名兜底：fd_xxxxxx */
+function generateFieldName(prefix = 'fd') {
+    return `${prefix}_${Math.random().toString(36).slice(-6)}`;
+}
+/** 深度克隆（JSON 安全） */
+function cloneDeep(value) {
+    return value === undefined ? value : JSON.parse(JSON.stringify(value));
+}
+/** 安全 JSON 解析 */
+function safeJsonParse(text, fallback) {
+    if (!text)
+        return fallback;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return fallback;
+    }
+}
+/** 驼峰/下划线转小写下划线 */
+function toSnakeCase(input) {
+    return input
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+        .replace(/[-\s]+/g, '_')
+        .toLowerCase();
+}
+/** 生成合法的表名前缀（不含系统模块前缀） */
+function sanitizeIdentifier(input) {
+    return input.replace(/[^a-zA-Z0-9_]/g, '_');
+}