worsoft-frontend-codegen-local-mcp 0.1.23 → 0.1.24

package/mcp_server.js

@@ -5,7 +5,7 @@ const fs = require('fs');
 const path = require('path');
 
 const SERVER_NAME = 'worsoft-codegen-local';
-const SERVER_VERSION = '0.1.23';
+const SERVER_VERSION = '0.1.24';
 const PROTOCOL_VERSION = '2024-11-05';
 const TOOL_NAME = 'worsoft_codegen_local_generate_frontend';
 const TEMPLATE_LIBRARY_ROOT = path.resolve(__dirname, '..', 'template');
@@ -16,25 +16,27 @@ const DEFAULT_DICT_REGISTRY_KEYS = {
   trade_standard_type: 'TRADE_STANDARD_TYPE',
   trade_score_standard: 'TRADE_SCORE_STANDARD',
 };
-const DEFAULT_CRUD_SCHEMA_TEMPLATE = `export interface FieldMeta {
-  show: boolean;
-  alwaysHide: boolean;
-  smart: boolean;
-  labelKey: string;
+const DEFAULT_CRUD_SCHEMA_TEMPLATE = `export interface FieldMeta {
+  show: boolean;
+  listShow: boolean;
+  alwaysHide: boolean;
+  smart: boolean;
+  labelKey: string;
   label?: string;
   width: string;
   dictType?: string;
 }
 
-export interface FieldConfig {
-  key: string;
-  labelKey?: string;
-  label?: string;
-  width?: string;
-  show?: boolean;
-  alwaysHide?: boolean;
-  smart?: boolean;
-  dictType?: string;
+export interface FieldConfig {
+  key: string;
+  labelKey?: string;
+  label?: string;
+  width?: string;
+  show?: boolean;
+  listShow?: boolean;
+  alwaysHide?: boolean;
+  smart?: boolean;
+  dictType?: string;
 }
 
 export interface CrudSchemaDefinition {
@@ -52,11 +54,12 @@ export interface CrudSchema {
 
 const DEFAULT_WIDTH = '120';
 
-export const field = (labelKey: string, width = DEFAULT_WIDTH): FieldMeta => ({
-  show: true,
-  alwaysHide: false,
-  smart: false,
-  labelKey,
+export const field = (labelKey: string, width = DEFAULT_WIDTH): FieldMeta => ({
+  show: true,
+  listShow: true,
+  alwaysHide: false,
+  smart: false,
+  labelKey,
   width,
 });
 
@@ -79,10 +82,11 @@ export const collectDictTypes = (...groups: Array<Record<string, FieldMeta>>) =>
     )
   );
 
-const normalizeField = (item: FieldConfig): FieldMeta => ({
-  show: item.show ?? true,
-  alwaysHide: item.alwaysHide ?? false,
-  smart: item.smart ?? false,
+const normalizeField = (item: FieldConfig): FieldMeta => ({
+  show: item.show ?? true,
+  listShow: item.listShow ?? item.show ?? true,
+  alwaysHide: item.alwaysHide ?? false,
+  smart: item.smart ?? false,
   labelKey: item.labelKey ?? item.label ?? item.key,
   ...(item.label ? { label: item.label } : {}),
   width: item.width ?? DEFAULT_WIDTH,
@@ -145,6 +149,7 @@ const TOOL_SCHEMA = {
           required: { type: ['boolean', 'string'], description: 'Whether the field is required.' },
           readonly: { type: ['boolean', 'string'], description: 'Whether the field is readonly on the page.' },
           show: { type: ['boolean', 'string'], description: 'Whether the field is shown on the page.' },
+          listShow: { type: ['boolean', 'string'], description: 'Whether the field is shown on the list page.' },
           dictType: { type: 'string', description: 'Dictionary type code from the API document.' },
           defaultValue: { type: ['string', 'number', 'boolean'], description: 'Optional default value.' },
           description: { type: 'string', description: 'Field description or notes.' },
@@ -181,6 +186,7 @@ const TOOL_SCHEMA = {
                 required: { type: ['boolean', 'string'], description: 'Whether the field is required.' },
                 readonly: { type: ['boolean', 'string'], description: 'Whether the field is readonly on the page.' },
                 show: { type: ['boolean', 'string'], description: 'Whether the field is shown on the page.' },
+                listShow: { type: ['boolean', 'string'], description: 'Whether the field is shown on the list page.' },
                 dictType: { type: 'string', description: 'Dictionary type code from the API document.' },
                 defaultValue: { type: ['string', 'number', 'boolean'], description: 'Optional default value.' },
                 description: { type: 'string', description: 'Field description or notes.' },
@@ -428,20 +434,20 @@ function buildChildSectionTitleKey(model, childModel) {
   return `${buildI18nNamespace(model)}.children.${childModel.listName}.title`;
 }
 
-function buildLocaleLeaf(model) {
-  const leaf = {
-    title: model.tableComment,
-    fields: Object.fromEntries(model.visibleFields.map((field) => [field.attrName, stripDictAnnotation(field.comment)])),
-  };
+function buildLocaleLeaf(model) {
+  const leaf = {
+    title: model.tableComment,
+    fields: Object.fromEntries(model.optionFields.map((field) => [field.attrName, stripDictAnnotation(field.comment)])),
+  };
 
   if (model.children.length) {
     leaf.children = Object.fromEntries(
       model.children.map((childModel) => [
         childModel.listName,
-        {
-          title: childModel.tableComment,
-          fields: Object.fromEntries(childModel.visibleFields.map((field) => [field.attrName, stripDictAnnotation(field.comment)])),
-        },
+        {
+          title: childModel.tableComment,
+          fields: Object.fromEntries(childModel.optionFields.map((field) => [field.attrName, stripDictAnnotation(field.comment)])),
+        },
       ])
     );
   }
@@ -778,6 +784,7 @@ function normalizeStructuredField(inputField, index, contextLabel) {
     defaultValue: normalizeDefaultValue(inputField.defaultValue),
     readonly: parseBooleanLike(inputField.readonly, false),
     show: parseBooleanLike(inputField.show, true),
+    listShow: parseBooleanLike(inputField.listShow, parseBooleanLike(inputField.show, true)),
     sourceKind: normalizeStructuredSourceKind(inputField.sourceKind),
     primary: parseBooleanLike(inputField.primary, fieldName === 'id'),
   };
@@ -903,9 +910,10 @@ function buildChildModels(safeArgs, mainFields, mainPk) {
     });
     const mainRelationField = ensureFieldExists(mainFields, relation.mainField, safeArgs.tableName, 'Main relation');
     const childRelationField = ensureFieldExists(childFields, relation.childField, relation.childTableName, 'Child relation');
-    const childVisibleFields = childFields.filter(
-      (field) => field.fieldName !== childPk.fieldName && !field.isAudit && field.fieldName !== relation.childField && field.show !== false
+    const childOptionFields = childFields.filter(
+      (field) => field.fieldName !== childPk.fieldName && !field.isAudit && field.fieldName !== relation.childField
     );
+    const childVisibleFields = childOptionFields.filter((field) => field.show !== false);
     const payloadField = relation.payloadField;
     const listName = payloadField;
 
@@ -919,6 +927,7 @@ function buildChildModels(safeArgs, mainFields, mainPk) {
       payloadFieldSource: 'arguments',
       pk: childPk,
       fields: childFields,
+      optionFields: childOptionFields,
       visibleFields: childVisibleFields,
       mainField: mainRelationField,
       childField: childRelationField,
@@ -932,11 +941,13 @@ function buildModel(safeArgs) {
   const fields = normalizeFields({
     fields: safeArgs.fields,
   });
-  const visibleFields = fields.filter((field) => field.fieldName !== pkField.fieldName && !field.isAudit && field.show !== false);
-  const gridFields = visibleFields.slice(0, 8);
+  const optionFields = fields.filter((field) => field.fieldName !== pkField.fieldName && !field.isAudit);
+  const visibleFields = optionFields.filter((field) => field.show !== false);
+  const listFields = optionFields.filter((field) => field.listShow !== false);
+  const gridFields = listFields.slice(0, 8);
   const children = buildChildModels(safeArgs, fields, pkField);
-  const childDictTypes = children.flatMap((child) => child.visibleFields.map((field) => field.dictType).filter(Boolean));
-  const dictTypes = [...new Set([...visibleFields.map((field) => field.dictType).filter(Boolean), ...childDictTypes])];
+  const childDictTypes = children.flatMap((child) => child.optionFields.map((field) => field.dictType).filter(Boolean));
+  const dictTypes = [...new Set([...optionFields.map((field) => field.dictType).filter(Boolean), ...childDictTypes])];
 
   const functionName = toCamelCase(safeArgs.tableName);
   const apiPath = safeArgs.apiPath || functionName;
@@ -950,7 +961,9 @@ function buildModel(safeArgs) {
     moduleName: normalizeModulePathForFeature(safeArgs.moduleName, functionName, apiPath),
     pk: pkField,
     fields,
+    optionFields,
     visibleFields,
+    listFields,
     gridFields,
     dictTypes,
     frontendPath: path.resolve(safeArgs.frontendPath),
@@ -1211,27 +1224,34 @@ function getDefaultOptionFieldWidthV2(field) {
   return '100';
 }
 
-function renderOptionFieldV2(field, labelKey, dictRegistryRefs, indent = '    ') {
-  const parts = [`key: '${field.attrName}'`, `labelKey: '${labelKey}'`];
+function renderOptionFieldV2(field, labelKey, dictRegistryRefs, indent = '    ') {
+  const fallbackLabel = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
+  const parts = [`key: '${field.attrName}'`, `labelKey: '${labelKey}'`, `label: '${fallbackLabel}'`];
   const width = getDefaultOptionFieldWidthV2(field);
 
   if (width !== '120') {
     parts.push(`width: '${width}'`);
   }
 
-  if (field.dictType) {
-    parts.push(`dictType: ${getDictRegistryReference(field.dictType, dictRegistryRefs)}`);
-  }
-
-  return `${indent}{ ${parts.join(', ')} },`;
-}
+  if (field.dictType) {
+    parts.push(`dictType: ${getDictRegistryReference(field.dictType, dictRegistryRefs)}`);
+  }
+  if (field.show === false) {
+    parts.push('show: false');
+  }
+  if (field.listShow === false) {
+    parts.push('listShow: false');
+  }
+
+  return `${indent}{ ${parts.join(', ')} },`;
+}
 
 function renderChildOptionGroupV2(model, childModel, dictRegistryRefs) {
   return [
     `    ${childModel.listName}: [`,
-    childModel.visibleFields
-      .map((field) => renderOptionFieldV2(field, buildChildFieldLabelKey(model, childModel, field), dictRegistryRefs, '      '))
-      .join('\n'),
+    childModel.optionFields
+      .map((field) => renderOptionFieldV2(field, buildChildFieldLabelKey(model, childModel, field), dictRegistryRefs, '      '))
+      .join('\n'),
     '    ],',
   ].join('\n');
 }
@@ -1443,7 +1463,7 @@ function buildReplacements(model, sharedSupport) {
       TABLE_COLUMNS: model.gridFields.map((field) => renderTableColumnV2(field, dictRegistryRefs)).join('\n'),
       FORM_DEFAULTS: renderFormDefaults(model),
       DICT_REGISTRY_IMPORT_BLOCK: model.dictTypes.length ? "import { DictRegistry } from '/@/enums/dict-registry';" : '',
-      MASTER_OPTION_FIELDS: model.visibleFields.map((field) => renderOptionFieldV2(field, buildFieldLabelKey(model, field), dictRegistryRefs)).join('\n'),
+      MASTER_OPTION_FIELDS: model.optionFields.map((field) => renderOptionFieldV2(field, buildFieldLabelKey(model, field), dictRegistryRefs)).join('\n'),
       CHILD_OPTION_GROUPS: model.children.map((childModel) => renderChildOptionGroupV2(model, childModel, dictRegistryRefs)).join('\n'),
       FORM_RULES: renderFormRulesV2(model.visibleFields),
       CHILD_FORM_LIST_DEFAULTS: renderChildFormListDefaults(model.children),
@@ -1582,7 +1602,8 @@ function buildManifest(model, safeArgs, stylePreset, sharedTemplates, files, not
     summary: {
       totalFields: model.fields.length,
       visibleFields: model.visibleFields.length,
-      dictFields: model.visibleFields.filter((field) => field.dictType).map((field) => field.attrName),
+      listVisibleFields: model.listFields.length,
+      dictFields: model.optionFields.filter((field) => field.dictType).map((field) => field.attrName),
       skippedAuditFields: model.fields.filter((field) => field.isAudit).map((field) => field.fieldName),
       childCount: model.children.length,
       childTables: model.children.map((childModel) => childModel.tableName),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "worsoft-frontend-codegen-local-mcp",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "Worsoft frontend local-template code generation MCP server.",
   "license": "UNLICENSED",
   "author": "worsoft <sw@worsoft.vip>",