lan-low-code-cli 2.0.0 → 2.2.0

package/dist/constants.js

@@ -3,7 +3,8 @@
  * 常量定义：与 sys-xform 前端 util/constant.ts 中的约定保持一致。
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_DETAIL_CONTROL_STYLE = exports.DEFAULT_CONTROL_STYLE = exports.DEFAULT_MOBILE_THEME = exports.DEFAULT_DESKTOP_THEME = exports.DEFAULT_FORM_ICON_JSON = exports.DEFAULT_FORM_ICON = exports.FIELD_NAME_PREFIX = exports.LOCALE_PATTERN = exports.LOCALE_ALL = exports.LOCALES = exports.DEFAULT_LOCALE = exports.DEFAULT_SPAN = exports.OPTION_DICT_TYPE = exports.OPTION_CONTROL_TYPES = exports.DETAIL_CONTROL_DEFAULTS = exports.DETAIL_ROW_FLAGS = exports.DETAIL_OPERATIONS = exports.DETAIL_SYSTEM_FIELDS = exports.DETAIL_CONTROL = exports.CONTROL_TYPE_MAP = exports.FALLBACK_CONTROL = exports.DEFAULT_CONTROL_MAP = exports.ELEMENT_ARTIFACT_PREFIX = exports.DEFAULT_SCENE_NAME = exports.DEFAULT_SCENE_CODE = exports.MODELING_ENTITY_CODE = exports.MODELING_ENTITY_NAME = exports.ENTITY_CODE = exports.ENTITY_NAME = exports.MODULE = exports.REQUIRED_PROP_DEFAULTS = exports.I18N_PROP_TABS = exports.TAB_PANE_MOBILE = exports.TAB_PANE = exports.TABS_MOBILE = exports.TABS = exports.TAB_APPEARANCE_MOBILE = exports.TAB_APPEARANCE = exports.LAYOUT_GRID_ITEM = exports.LAYOUT_GRID = exports.LAYOUT = exports.ROW = exports.APPEARANCE = exports.MAIN = void 0;
+exports.DEFAULT_MOBILE_THEME = exports.DEFAULT_DESKTOP_THEME = exports.DEFAULT_FORM_ICON_JSON = exports.DEFAULT_FORM_ICON = exports.FIELD_NAME_PREFIX = exports.LOCALE_PATTERN = exports.LOCALE_ALL = exports.LOCALES = exports.DEFAULT_LOCALE = exports.DEFAULT_SPAN = exports.OPTION_DICT_TYPE = exports.OPTION_CONTROL_TYPES = exports.DETAIL_CONTROL_DEFAULTS = exports.DETAIL_ROW_FLAGS = exports.DETAIL_OPERATIONS = exports.DETAIL_SYSTEM_FIELDS = exports.DETAIL_CONTROL = exports.CONTROL_DESIGNER_NOTES = exports.CONTROL_NOTE_WITHOUT_ERRORS = exports.RELATION_FRONT_EXTEND_PATHS = exports.CONTROL_DEFAULT_PROPS = exports.CONTROL_SEMANTIC_RULES = exports.PLACEHOLDER_LANG_KEY_CANDIDATES = exports.CONTROL_PLACEHOLDER_LANG_KEYS = exports.CONTAINER_CONTROL_TYPES = exports.CONTROL_TYPE_MAP = exports.FALLBACK_CONTROL = exports.DEFAULT_CONTROL_MAP = exports.ELEMENT_ARTIFACT_PREFIX = exports.DEFAULT_SCENE_NAME = exports.DEFAULT_SCENE_CODE = exports.MODELING_ENTITY_CODE = exports.MODELING_ENTITY_NAME = exports.ENTITY_CODE = exports.ENTITY_NAME = exports.MODULE = exports.REQUIRED_PROP_DEFAULTS = exports.I18N_PROP_TABS = exports.TAB_PANE_MOBILE = exports.TAB_PANE = exports.TABS_MOBILE = exports.TABS = exports.TAB_APPEARANCE_MOBILE = exports.TAB_APPEARANCE = exports.LAYOUT_GRID_ITEM = exports.LAYOUT_GRID = exports.LAYOUT = exports.ROW = exports.APPEARANCE = exports.MAIN = void 0;
+exports.DEFAULT_DETAIL_CONTROL_STYLE = exports.DEFAULT_CONTROL_STYLE = void 0;
 /** 设计器主容器 key */
 exports.MAIN = 'main';
 /** 外观容器 */
@@ -30,7 +31,17 @@ exports.TAB_PANE = '@elem/xform-tabpane';
 exports.TAB_PANE_MOBILE = '@elem/xform-m-tabpane';
 /** 页签标题的多语言 prop 取值（前端 EI18nProp.tabs） */
 exports.I18N_PROP_TABS = 'tabs';
-/** 控件必填属性的兜底默认值（键为 desktop 控件包名），取值依据见 README「控件必填属性校验」 */
+/**
+ * 控件必填属性的兜底默认值（键为 desktop 控件包名），取值依据见 README「控件必填属性校验」。
+ *
+ * 支持两个占位符（在 `buildFieldAttribute` 中按字段解析）：
+ * - `$title`：字段的多语言 key（`langKey`），用于「描述文字」这类默认取标题的属性
+ * - `$name`：字段物理名（`fdName`）
+ *
+ * 高级控件部分只填**中立且安全**的取值（枚举默认值、空结构），
+ * 需要选择环境对象（主数据 / 配置项 / 关联范围 / 识别类型 …）的属性**不伪造**，
+ * 保持为空并在发布校验时提示（与设计器行为一致，可用 `--force` 跳过）。
+ */
 exports.REQUIRED_PROP_DEFAULTS = {
     '@elem/xform-textarea': { height: '3' },
     '@elem/xform-rate': { max: 5 },
@@ -38,10 +49,106 @@ exports.REQUIRED_PROP_DEFAULTS = {
     '@elem/xform-rich-text': { height: 300 },
     '@elem/xform-bar-code': { height: 80 },
     '@elem/xform-hyperlinks': { largestSet: 'infinit' },
+    // address = 地址本（组织/人员选择器，非地址文本）：orgTypeArr 位掩码
+    // 1=组织 2=部门 4=岗位 8=人员 16=用户组；默认仅人员、单选、全部范围
     '@elem/xform-address': {
         org: { orgTypeArr: ['8'], defaultValueType: 'null' },
         multi: false,
     },
+    // ---------- 高级控件 ----------
+    // 取值依据：控件 config.json 的枚举选项 + 真实表单落库数据（controlProps）
+    '@elem/xform-description': { defaultTextValue: '$title' },
+    '@elem/xform-tag': {
+        tabsRange: { categorys: [], targs: [], rangeType: 'all' },
+        multi: true,
+    },
+    '@elem/xform-location': {
+        allowed: false,
+        mapContent: { address: 'formattedAddress' },
+        searchNearBy: { isLocation: false, checkboxvalue: false, inputvalue: '' },
+    },
+    '@elem/xform-area': {
+        // 'null' 时精确定位（defaultValue）为非条件项，无需填写
+        defaultValueType: 'null',
+        precisionRegion: 'county',
+        showHierarchy: 'all',
+        showText: false,
+        passValue: false,
+    },
+    '@elem/xform-html': {
+        source: { html: '', css: '', javascript: '' },
+        hiddenLabel: true,
+    },
+    '@elem/xform-iframe': { heigth: 150, complexMode: false, expressionFormulaVO: {} },
+    '@elem/xform-file-edit': {
+        height: 600,
+        allowImport: true,
+        accept: { defaultFileType: 'docx', fileType: ['.doc,.docx'] },
+        supportList: false,
+    },
+    '@elem/xform-association': {
+        // mode / processStatus 为枚举，取真实表单的取值；xlistColumn（列表列配置）需设计器选择
+        mode: 'multiple',
+        processStatus: ['30'],
+    },
+    '@elem/xform-attach-demo': { supportTemplateData: true },
+    '@elem/xform-agency': { multi: false },
+    '@elem/xform-mdm': {
+        renderMode: 'singlelist',
+        direction: 'column',
+        rowCount: 3,
+        trace: false,
+    },
+    '@elem/xform-dynamic': { direction: 'column', rowCount: 3 },
+    '@elem/xform-calculate': {
+        statisticMode: 'SUM',
+        statisticData: [],
+        showText: false,
+        passValue: false,
+        defaultValueType: 'empty',
+    },
+    '@elem/xform-cfg': {
+        renderMode: 'select',
+        cascader: true,
+        direction: 'column',
+        rowCount: 3,
+        showLevel: 'lastLevel',
+        selectLevel: 'allLevel',
+        levelOption: 0,
+        showText: false,
+        passValue: false,
+        trace: false,
+    },
+    '@elem/xform-review': {
+        isOperation: false,
+        isAuditNote: true,
+        useType: 'node',
+        reviewOptConfig: { optType: 'simple', advancedOptions: ['handler_pass'] },
+        auditNoteConfig: {
+            isSet: false,
+            notShowEmpty: false,
+            notShowRejection: false,
+            showLastOnSameDept: false,
+            showLastOnSameHandler: false,
+            notShowCancelCommunicate: false,
+            ascTime: true,
+            descTime: false,
+            ascApproverOrder: false,
+            descApproverOrder: false,
+            showNodeNote: false,
+            showPrependSignNote: false,
+        },
+    },
+    '@elem/xform-interval': {
+        controlWidth: 'default',
+        height: 16,
+        marginTop: 16,
+        marginBottom: 16,
+        maxColor: '#F8F8F8',
+    },
+    '@elem/xform-associated-fields': { showText: false, canChangeSpan: true },
+    '@elem/xform-time-axis': { showText: false },
+    '@elem/xform-button': { hiddenLabel: true },
 };
 /** 后端模块前缀（拼在 baseUrl 之后） */
 exports.MODULE = 'sys-xform';
@@ -118,6 +225,223 @@ exports.CONTROL_TYPE_MAP = {
     timeZone: { desktop: '@elem/xform-time-zone', mobile: '@elem/xform-m-time-zone', logicalType: 'timeZone', dataType: 'varchar' },
     relation: { desktop: '@elem/xform-relation', mobile: '@elem/xform-m-relation', logicalType: 'relation', dataType: 'relation' },
     relationQuery: { desktop: '@elem/xform-relation-query', mobile: '@elem/xform-relation-query', logicalType: 'relationQuery', dataType: 'relation' },
+    // ---------- 高级控件 ----------
+    // 下列条目的 dataType / dictType / defaultLength / isStored 均取自真实环境：
+    // 控件包 `config.json` 的 xform 元数据（`llc control list` 可查）＋ 真实表单落库数据核对。
+    // 元素类控件（isStored=false）同样会写入 dataModel，但 `fdIsStored=false`（不建物理列）。
+    // 元素类（仅渲染）
+    desc: { desktop: '@elem/xform-description', mobile: '@elem/xform-m-description', logicalType: 'desc', dataType: 'varchar', isStored: false },
+    interval: { desktop: '@elem/xform-interval', mobile: '@elem/xform-m-interval', logicalType: 'interval', dataType: 'varchar', dictType: 'simpleDict', isStored: false },
+    button: { desktop: '@elem/xform-button', mobile: '@elem/xform-m-button', logicalType: 'button', dataType: 'varchar', dictType: 'simpleDict', isStored: false },
+    html: { desktop: '@elem/xform-html', mobile: '@elem/xform-html', logicalType: 'html', dataType: 'varchar', dictType: 'simpleDict', isStored: false },
+    iframe: { desktop: '@elem/xform-iframe', mobile: '@elem/xform-iframe', logicalType: 'iframe', dataType: 'varchar', dictType: 'simpleDict', isStored: false },
+    attdemo: { desktop: '@elem/xform-attach-demo', mobile: '@elem/xform-attach-demo', logicalType: 'attdemo', dataType: 'varchar', dictType: 'attachmentDict', isStored: false },
+    imageDemo: { desktop: '@elem/xform-image-demo', mobile: '@elem/xform-image-demo', logicalType: 'imageDemo', dataType: 'varchar', dictType: 'attachmentDict', isStored: false },
+    review: { desktop: '@elem/xform-review', mobile: '@elem/xform-review', logicalType: 'review', dataType: 'varchar', dictType: 'lbpmAuditDict', isStored: false },
+    timeAxis: { desktop: '@elem/xform-time-axis', mobile: '@elem/xform-m-time-axis', logicalType: 'timeAxis', dataType: 'clob', dictType: 'timeAxisDict', isStored: false },
+    associatedFields: { desktop: '@elem/xform-associated-fields', mobile: '@elem/xform-associated-fields', logicalType: 'associatedFields', dataType: 'clob', dictType: 'refFieldDict', defaultLength: 100, isStored: false },
+    'serial-number': { desktop: '@elem/xform-detail-table-serial-number', mobile: '@elem/xform-detail-table-serial-number', logicalType: 'serial-number', dataType: 'varchar', isStored: false },
+    // 编号类（落库，fdDictType=serialNumberDict）
+    mechnumber: { desktop: '@elem/xform-mechnumber', mobile: '@elem/xform-mechnumber', logicalType: 'mechnumber', dataType: 'varchar', dictType: 'serialNumberDict', defaultLength: 200, isStored: true },
+    manualNumber: { desktop: '@elem/xform-manual-number', mobile: '@elem/xform-manual-number', logicalType: 'manualNumber', dataType: 'varchar', dictType: 'serialNumberDict', defaultLength: 200, isStored: true },
+    reserveNumber: { desktop: '@elem/xform-reserve-number', mobile: '@elem/xform-reserve-number', logicalType: 'reserveNumber', dataType: 'varchar', dictType: 'serialNumberDict', defaultLength: 200, isStored: true },
+    // 关联 / 数据类
+    association: { desktop: '@elem/xform-association', mobile: '@elem/xform-m-association', logicalType: 'association', dataType: 'clob', dictType: 'simpleDict', isStored: true },
+    refTemplate: { desktop: '@elem/xform-association-template', mobile: '@elem/xform-m-association-template', logicalType: 'refTemplate', dataType: 'other', dictType: 'refTemplate', isStored: true },
+    foreignKey: { desktop: '@elem/xform-relation-foreignkey', mobile: '@elem/xform-m-relation-foreignkey', logicalType: 'foreignKey', dataType: 'object', dictType: 'foreignKeyDict', isStored: true },
+    cfg: { desktop: '@elem/xform-cfg', mobile: '@elem/xform-m-cfg', logicalType: 'cfg', dataType: 'other', dictType: 'baseCfgDict', isStored: true },
+    mdm: { desktop: '@elem/xform-mdm', mobile: '@elem/xform-mdm', logicalType: 'mdm', dataType: 'other', dictType: 'mdmDataDict', isStored: true },
+    dynamic: { desktop: '@elem/xform-dynamic', mobile: '@elem/xform-m-dynamic', logicalType: 'dynamic', dataType: 'other', dictType: 'dynamicDict', isStored: true },
+    component: { desktop: '@elem/xform-component', mobile: '@elem/xform-component', logicalType: 'component', dataType: 'other', dictType: 'componentDict', defaultLength: 100, isStored: true },
+    agency: { desktop: '@elem/xform-agency', mobile: '@elem/xform-m-agency', logicalType: 'agency', dataType: 'other', dictType: 'manyToManyDict', isStored: true },
+    area: { desktop: '@elem/xform-area', mobile: '@elem/xform-m-area', logicalType: 'area', dataType: 'other', dictType: 'areaDict', isStored: true },
+    tags: { desktop: '@elem/xform-tag', mobile: '@elem/xform-m-tag', logicalType: 'tags', dataType: 'other', dictType: 'manyToManyDict', defaultLength: 2000, isStored: true },
+    location: { desktop: '@elem/xform-location', mobile: '@elem/xform-m-location', logicalType: 'location', dataType: 'relation', dictType: 'mapDict', isStored: true },
+    calculate: { desktop: '@elem/xform-calculate', mobile: '@elem/xform-calculate', logicalType: 'calculate', dataType: 'number', dictType: 'numberDict', isStored: true },
+    fileEdit: { desktop: '@elem/xform-file-edit', mobile: '@elem/xform-file-edit', logicalType: 'fileEdit', dataType: 'varchar', dictType: 'attachmentDict', defaultLength: 2000, isStored: true },
+    invoice: { desktop: '@elem/xform-invoice', mobile: '@elem/xform-m-invoice', logicalType: 'invoice', dataType: 'varchar', dictType: 'attachmentDict', defaultLength: 200, isStored: true },
+    ocr: { desktop: '@elem/xform-ocr', mobile: '@elem/xform-m-ocr', logicalType: 'ocr', dataType: 'varchar', dictType: 'attachmentDict', defaultLength: 200, isStored: true },
+    auditNote: { desktop: '@elem/xform-audit-notes', mobile: '@elem/xform-audit-notes', logicalType: 'auditNote', dataType: 'varchar' },
+    template: { desktop: '@elem/xform-template', mobile: '@elem/xform-template', logicalType: 'template', dataType: 'varchar', dictType: 'simpleDict', isStored: true },
+    // 知识类（内容型组织组件）
+    'ikm-author': { desktop: '@elem/xform-ikm-author', mobile: '@elem/xform-ikm-author', logicalType: 'ikm-author', dataType: 'clob', dictType: 'simpleDict', defaultLength: 0, isStored: true },
+    'ikm-category': { desktop: '@elem/xform-ikm-category', mobile: '@elem/xform-ikm-category', logicalType: 'ikm-category', dataType: 'clob', dictType: 'simpleDict', defaultLength: 0, isStored: true },
+    'ikm-content': { desktop: '@elem/xform-ikm-content', mobile: '@elem/xform-ikm-content', logicalType: 'ikm-content', dataType: 'clob', dictType: 'simpleDict', defaultLength: 0, isStored: true },
+    'ikm-player': { desktop: '@elem/xform-ikm-player', mobile: '@elem/xform-ikm-player', logicalType: 'ikm-player', dataType: 'clob', dictType: 'simpleDict', defaultLength: 0, isStored: true },
+};
+/**
+ * 容器类控件：**不能**作为 `--add-field` 的数据项（它们在平台里是「数据模型」或视图容器，
+ * 而非字段）。用专用参数创建，或由设计器配置。
+ *
+ * 真实环境（1628 个表单）核对：模型 `fdType` 仅有 `main` / `detail` / `single`；
+ * `bigDetail`、`paged` 两个控件包存在但无任何表单使用。
+ */
+exports.CONTAINER_CONTROL_TYPES = {
+    detail: { pkg: '@elem/xform-detail-table', hint: '明细表：请用 --detail "标题=字段:标题[:类型],..." 创建' },
+    bigDetail: { pkg: '@elem/xform-big-data-detail-table', hint: '大数据明细表：暂不支持（环境中无使用样例可核对）' },
+    paged: { pkg: '@elem/xform-paged', hint: '分页容器：暂不支持（环境中无使用样例可核对）' },
+};
+/**
+ * 控件「提示文字」的多语言资源键名（资源键为 `{pkg}###langs###{键名}`）。
+ *
+ * 来源：各控件源码的 `defaultProps.placeholder`（如 `el-form/widget/xform-datetime` →
+ * `@elem/xform-datetime###langs###pleaseEnter`、`xform-m-datetime` → `...###langs###enter`、
+ * `xform-area` → `...###langs###pleaseSelect`；其余控件为 `placeholder`）。
+ * **键名不对就取不到文案**——日期控件提示文字缺失正是此前一律查 `placeholder` 所致。
+ */
+exports.CONTROL_PLACEHOLDER_LANG_KEYS = {
+    '@elem/xform-datetime': 'pleaseEnter',
+    '@elem/xform-m-datetime': 'enter',
+    '@elem/xform-timepicker': 'pleaseEnter',
+    '@elem/xform-m-timepicker': 'pleaseEnter',
+    '@elem/xform-area': 'pleaseSelect',
+    '@elem/xform-m-area': 'pleaseSelect',
+};
+/** 提示文字资源键的兜底探测顺序（映射表未命中时按序尝试；环境对不存在的键返回 null） */
+exports.PLACEHOLDER_LANG_KEY_CANDIDATES = [
+    'placeholder',
+    'pleaseEnter',
+    'enter',
+    'pleaseSelect',
+];
+/** 业务关联（relation）的属性面板由平台拼装，故语义规则在此声明 */
+exports.CONTROL_SEMANTIC_RULES = {
+    relation: [
+        {
+            // 关联表单（业务对象）：必须选到表单并设置显示值
+            message: '关联表单不能为空：需在设计器中选择业务对象并设置显示值（relationCfg.appCode / relationCfg.refFieldName）',
+            ok: (get) => Boolean(get('relationCfg.appCode') && get('relationCfg.refFieldName')),
+        },
+        {
+            message: '列表设置为必填项：需在数据源配置中选择显示项（datasource.columns）',
+            renderModes: ['singlelist', 'mullist', 'treeList', 'multiTreeList'],
+            ok: (get) => {
+                const columns = get('datasource.columns');
+                return Array.isArray(columns) && columns.length > 0;
+            },
+        },
+        {
+            message: '卡片设置为必填项：需配置卡片标题、卡片封面与显示项（datasource.card.displayName / displayImage / datasource.columns）',
+            renderModes: ['card', 'multiCard', 'treeCard', 'multiTreeCard'],
+            ok: (get) => {
+                const columns = get('datasource.columns');
+                return Boolean(get('datasource.card.displayImage') && get('datasource.card.displayName')) &&
+                    Array.isArray(columns) && columns.length > 0;
+            },
+        },
+        {
+            message: '导航设置为必填项：需配置连接设置与自循环字段（datasource.tree.conditionsFromTree / relationConditions / relationCfg）',
+            renderModes: ['treeCard', 'multiTreeCard', 'treeList', 'multiTreeList'],
+            ok: (get) => {
+                if (get('datasource.tree.navigationMode') === 'category')
+                    return true;
+                const conditions = get('datasource.tree.relationConditions');
+                const valid = Array.isArray(conditions) &&
+                    conditions.some((item) => item?.field?.name && item?.value?.field?.name);
+                return Boolean(get('datasource.tree.conditionsFromTree') &&
+                    get('datasource.tree.relationCfg.refFieldName') &&
+                    get('datasource.tree.relationCfg.modelId') &&
+                    valid);
+            },
+        },
+        {
+            message: '树层级设置为必填项：需配置自循环字段（datasource.tree.relationConditions）',
+            renderModes: ['panel', 'multiPanel', 'tree', 'multiTree'],
+            ok: (get) => {
+                if (get('datasource.tree.treeLoop') === false)
+                    return true;
+                const conditions = get('datasource.tree.relationConditions');
+                return Array.isArray(conditions) &&
+                    conditions.some((item) => item?.field?.name && item?.value?.field?.name);
+            },
+        },
+    ],
+};
+/**
+ * 设计器为新控件写入的默认属性（控件包 `config.json` 未声明、由设计器给定）。
+ *
+ * 取值依据：环境内该控件真实落库数据的分布（占比见注释），用于让 CLI 生成的控件
+ * 与设计器创建的控件保持一致。
+ */
+exports.CONTROL_DEFAULT_PROPS = {
+    // 环境内 1371 个业务关联字段：renderMode=singlelist 95%、direction=column 99%、rowCount=3 99%、isForwardView=no 98%
+    // （mappedType 仅 5% 字段有值，属按需配置，不做默认）
+    '@elem/xform-relation': {
+        renderMode: 'singlelist',
+        direction: 'column',
+        rowCount: 3,
+        isForwardView: 'no',
+    },
+    // 环境内 115 个金额字段：precision 出现率 100%（88% 为 2、9% 为 4）；控件包 config.json
+    // 未声明该项默认值，平台数据迁移代码（sys-xform/src/components/ide/util/dataMigration.ts）
+    // 在缺省时按 0 位小数落库，故显式写 2 位，与设计器新建字段（如「参考单价」）一致。
+    // symbol（币种）属业务选择——环境内 69% 为 CNY、28% 为空——取中立的空值，不替用户假定币种。
+    '@elem/xform-money': { precision: 2, symbol: '' },
+};
+/**
+ * 业务关联控件的前端扩展数据路径。
+ *
+ * 来源：控件源码 JSDoc（`sys-modeling/src/elem/widget/xform-relation/index.tsx`）——
+ * `relationCfg` 声明 `@frontExtendData {children:['modelId','refFieldName','tableType','tableName']}`、
+ * `datasource` 声明 `@frontExtendData {children:['queryCondition','querySorters','columns','filters',
+ * 'tree','card','isForwardView','conditionSetting']}`，另有 `renderMode`、`outParams`。
+ * 运行时/公式依赖 `fdFontExtendData` 里的这些键（与 `controlProps` 两处并存）。
+ */
+exports.RELATION_FRONT_EXTEND_PATHS = [
+    'modelName',
+    'relationCfg.modelId',
+    'relationCfg.refFieldName',
+    'relationCfg.tableType',
+    'relationCfg.tableName',
+    'datasource.queryCondition',
+    'datasource.querySorters',
+    'datasource.columns',
+    'datasource.filters',
+    'datasource.tree',
+    'datasource.card',
+    'datasource.isForwardView',
+    'datasource.conditionSetting',
+    'renderMode',
+    'outParams',
+];
+/**
+ * 需要到设计器完成配置的控件（按键为控件逻辑类型）。
+ *
+ * 这些控件的关键属性是「环境对象选择」（选主数据 / 配置项 / 关联范围 / 编号规则 …），
+ * CLI 只创建控件骨架，无法替用户选择，因此生成时给出提示。
+ * 多数会在发布前校验中被拦下（缺必填属性）；`associatedFields` 是例外——
+ * 它没有必填属性，但未配置关联源时**后端发布会直接失败**（HTTP 500，已实测）。
+ */
+/**
+ * 即使**没有**触发必填/语义校验错误也要提示「需设计器配置」的控件。
+ *
+ * 其余控件的关系是：提示仅在该字段确实缺配置（有校验错误）时输出——
+ * 例如已配置好的业务关联字段不该再被提示「只建骨架会得到不可用控件」。
+ * `associatedFields` 是例外：它没有必填属性，问题要到后端发布时才暴露（HTTP 500），
+ * 提示是唯一的信号，必须无条件给出。
+ */
+exports.CONTROL_NOTE_WITHOUT_ERRORS = new Set(['associatedFields']);
+exports.CONTROL_DESIGNER_NOTES = {
+    associatedFields: '关联字段：需在设计器中指定关联源字段/引用表单；未配置时后端发布会失败',
+    // 业务关联：控件包本身被平台标记为 deprecated（xform.group='deprecated'），
+    // 且必须配置业务对象（relationCfg）/数据源（datasource）/传出参数（outParams）才有意义，
+    // 而它**没有必填属性**——只建骨架会静默产出一个不可用控件，必须在生成时提示。
+    relation: '业务关联：需在设计器中配置业务对象（relationCfg）、数据源（datasource）与传出参数（outParams）——只建骨架会得到一个没有数据源的控件（能保存能发布，但不可用）。控件包已被平台标记为废弃（group=deprecated），存量表单使用较多；新表单建议改用 association（关联选择）或 relationQuery（关联查询）',
+    relationQuery: '关联查询：需在设计器中配置查询页签与数据源（tabs）',
+    association: '关联选择：需在设计器中配置关联范围与列表列',
+    refTemplate: '关联模板：需在设计器中指定关联模板',
+    foreignKey: '外键关联：需在设计器中指定映射类型与目标模型',
+    cfg: '配置控件：需在设计器中指定配置项',
+    mdm: '主数据：需在设计器中指定主数据模型',
+    dynamic: '动态控件：需在设计器中指定接口',
+    mechnumber: '机制编号：需在设计器中配置编号规则',
+    manualNumber: '手工编号：需在设计器中配置编号规则',
+    reserveNumber: '预留编号：需在设计器中配置编号规则',
+    invoice: '票据识别：需在设计器中指定识别类型',
+    ocr: 'OCR 识别：需在设计器中指定识别类型',
+    auditNote: '审批意见：需在设计器中指定显示字段',
+    attdemo: '附件（模板）：需在设计器中指定默认附件',
+    imageDemo: '图片（模板）：需在设计器中指定默认图片',
 };
 /** 明细表控件（数据项类型为 varchar，控件逻辑类型 detail） */
 exports.DETAIL_CONTROL = {