vona-cli-set-api 1.1.110 → 1.1.117

package/cli/templates/create/module/boilerplate/_package.json

@@ -25,7 +25,7 @@
     "tsc:publish": "npm run clean && node <%=argv.suite?'../../../../../':'../../../'%>packages-cli/cli/src/bin/vona.ts :bin:buildModule --sourcemap && tsc -p tsconfig.build.json",
     "prepublishOnly": "npm run tsc:publish",
     "prepack": "clean-package",
-    "postpack": "clean-package restore && npm run clean"
+    "postpack": "clean-package restore"
   },
   "clean-package": {
     "indent": 2,

package/cli/templates/tools/masterDetail/boilerplate/dto/<%=argv.detailDtoBaseName%>.tsx_

@@ -0,0 +1,18 @@
+import type { IDecoratorDtoOptions } from 'vona-module-a-web';
+
+import { $makeMetadata } from 'vona-module-a-openapiutils';
+import { $Dto } from 'vona-module-a-orm';
+import { Dto } from 'vona-module-a-web';
+import { Model<%=argv.detailResourceNameCapitalize%> } from '<%=argv.detailPackageName%>';
+import { ZovaRender } from 'zova-rest-cabloy-basic-admin';
+
+export interface IDtoOptions<%=cli.helper.firstCharToUpperCase(argv.detailDtoBaseName)%> extends IDecoratorDtoOptions {}
+
+@Dto<IDtoOptions<%=cli.helper.firstCharToUpperCase(argv.detailDtoBaseName)%>>({
+  fields: {
+    id: $makeMetadata(ZovaRender.visible(false)),
+  },
+})
+export class Dto<%=cli.helper.firstCharToUpperCase(argv.detailDtoBaseName)%> extends $Dto.get(() => Model<%=argv.detailResourceNameCapitalize%>, {
+  columns: ['id', 'deleted', 'name', 'description'],
+}) {}

package/cli/templates/tools/masterDetail/boilerplate/dto/<%=argv.detailDtoMutateName%>.tsx_

@@ -0,0 +1,17 @@
+import type { IDecoratorDtoOptions } from 'vona-module-a-web';
+
+import { $Dto } from 'vona-module-a-orm';
+import { Dto } from 'vona-module-a-web';
+import { Model<%=argv.detailResourceNameCapitalize%> } from '<%=argv.detailPackageName%>';
+import { ZovaRender } from 'zova-rest-cabloy-basic-admin';
+
+import { Dto<%=cli.helper.firstCharToUpperCase(argv.detailDtoBaseName)%> } from './<%=argv.detailDtoBaseName%>.tsx';
+
+export interface IDtoOptions<%=cli.helper.firstCharToUpperCase(argv.detailDtoMutateName)%> extends IDecoratorDtoOptions {}
+
+@Dto<IDtoOptions<%=cli.helper.firstCharToUpperCase(argv.detailDtoMutateName)%>>({
+  blocks: [ZovaRender.block('basic-details:blockForm')],
+})
+export class Dto<%=cli.helper.firstCharToUpperCase(argv.detailDtoMutateName)%> extends $Dto.mutate(() => Model<%=argv.detailResourceNameCapitalize%>, {
+  dtoClass: Dto<%=cli.helper.firstCharToUpperCase(argv.detailDtoBaseName)%>,
+}) {}

package/cli/templates/tools/masterDetail/boilerplate/dto/<%=argv.detailDtoResItemName%>.tsx_

@@ -0,0 +1,60 @@
+import type { IDecoratorDtoOptions } from 'vona-module-a-web';
+
+import { $makeMetadata, Api, v } from 'vona-module-a-openapiutils';
+import { $Dto } from 'vona-module-a-orm';
+import { Dto } from 'vona-module-a-web';
+import { Model<%=argv.detailResourceNameCapitalize%> } from '<%=argv.detailPackageName%>';
+import { ZovaRender } from 'zova-rest-cabloy-basic-admin';
+
+import { $locale } from '../.metadata/locales.ts';
+import { Dto<%=cli.helper.firstCharToUpperCase(argv.detailDtoBaseName)%> } from './<%=argv.detailDtoBaseName%>.tsx';
+
+export interface IDtoOptions<%=cli.helper.firstCharToUpperCase(argv.detailDtoResItemName)%> extends IDecoratorDtoOptions {}
+
+@Dto<IDtoOptions<%=cli.helper.firstCharToUpperCase(argv.detailDtoResItemName)%>>({
+  blocks: [
+    ZovaRender.block('basic-details:blockDetails', {
+      blocks: [
+        ZovaRender.block('basic-details:blockToolbarBulk', {
+          actions: [
+            ZovaRender.detailsActionBulk('basic-details:actionCreate', {
+              dialogOptions: { title: $locale('Add<%=argv.detailDialogTitleCapitalize%>') },
+              permission: { formScene: ['create', 'edit'] },
+            }),
+          ],
+        }),
+        ZovaRender.block('basic-details:blockTable'),
+      ],
+    }),
+  ],
+  fields: {
+    name: $makeMetadata(
+      ZovaRender.cell('basic-details:actionView', {
+        dialogOptions: { title: $locale('View<%=argv.detailDialogTitleCapitalize%>') },
+      }),
+    ),
+  },
+})
+export class Dto<%=cli.helper.firstCharToUpperCase(argv.detailDtoResItemName)%> extends $Dto.get(() => Model<%=argv.detailResourceNameCapitalize%>, {
+  dtoClass: Dto<%=cli.helper.firstCharToUpperCase(argv.detailDtoBaseName)%>,
+}) {
+  @Api.field(v.title('#'), ZovaRender.order(1, 'core'), ZovaRender.cell('basic-details:lineNumber'))
+  _lineNumber?: number;
+
+  @Api.field(
+    v.title($locale('Operations')),
+    ZovaRender.order(1, 'max'),
+    ZovaRender.cell('basic-details:actionOperationsRow', {
+      actions: [
+        ZovaRender.detailsActionRow('basic-details:actionUpdate', {
+          dialogOptions: { title: $locale('Edit<%=argv.detailDialogTitleCapitalize%>') },
+          permission: { formScene: ['create', 'edit'] },
+        }),
+        ZovaRender.detailsActionRow('basic-details:actionDelete', {
+          permission: { formScene: ['create', 'edit'] },
+        }),
+      ],
+    }),
+  )
+  _operationsRow?: unknown;
+}

package/cli/templates/tools/masterDetail/boilerplate/dto/<%=argv.detailDtoViewName%>.tsx_

@@ -0,0 +1,17 @@
+import type { IDecoratorDtoOptions } from 'vona-module-a-web';
+
+import { $Dto } from 'vona-module-a-orm';
+import { Dto } from 'vona-module-a-web';
+import { Model<%=argv.detailResourceNameCapitalize%> } from '<%=argv.detailPackageName%>';
+import { ZovaRender } from 'zova-rest-cabloy-basic-admin';
+
+import { Dto<%=cli.helper.firstCharToUpperCase(argv.detailDtoBaseName)%> } from './<%=argv.detailDtoBaseName%>.tsx';
+
+export interface IDtoOptions<%=cli.helper.firstCharToUpperCase(argv.detailDtoViewName)%> extends IDecoratorDtoOptions {}
+
+@Dto<IDtoOptions<%=cli.helper.firstCharToUpperCase(argv.detailDtoViewName)%>>({
+  blocks: [ZovaRender.block('basic-details:blockForm')],
+})
+export class Dto<%=cli.helper.firstCharToUpperCase(argv.detailDtoViewName)%> extends $Dto.get(() => Model<%=argv.detailResourceNameCapitalize%>, {
+  dtoClass: Dto<%=cli.helper.firstCharToUpperCase(argv.detailDtoBaseName)%>,
+}) {}

package/dist/index.js

@@ -1067,12 +1067,8 @@ class CliCreateBean extends BeanCliBase {
     argv.ssrSiteRestNpmWeb = fs.existsSync(path.join(argv.projectPath, 'src/suite/cabloy-start')) ? 'zova-rest-cabloy-start-web' : 'zova-rest-cabloy-basic-web';
     // module name/info
     const moduleName = argv.module;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     // scene name
@@ -1166,12 +1162,9 @@ class CliCreateModule extends BeanCliBase {
     // suite name/info
     const suiteName = argv.suite;
     if (suiteName) {
-      argv.suiteInfo = this.helper.parseSuiteInfo(suiteName);
+      argv.suiteInfo = this.helper.parseSuiteInfoCanonical(suiteName);
       // check if exists
-      argv._suite = this.helper.findSuite(suiteName);
-      if (!argv._suite) {
-        throw new Error(`suite does not exist: ${suiteName}`);
-      }
+      argv._suite = this.helper.findSuiteCanonical(suiteName);
     }
     // nameMeta
     const nameMeta = this.helper.parseNameMeta(argv.name);
@@ -1179,7 +1172,7 @@ class CliCreateModule extends BeanCliBase {
     argv.name = nameMeta.short;
     // module name/info
     const moduleName = argv.name;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
     argv.relativeNameCapitalize = this.helper.stringToCapitalize(argv.moduleInfo.relativeName, '-');
     // check if exists
     const _module = this.helper.findModule(moduleName);
@@ -1246,7 +1239,7 @@ class CliCreateSuite extends BeanCliBase {
     argv.name = nameMeta.short;
     // suite name/info
     const suiteName = argv.name;
-    argv.suiteInfo = this.helper.parseSuiteInfo(suiteName);
+    argv.suiteInfo = this.helper.parseSuiteInfoCanonical(suiteName);
     // check if exists
     const _suite = this.helper.findSuite(suiteName);
     if (_suite) {
@@ -1274,12 +1267,8 @@ class CliCreateTest extends BeanCliBase {
     await super.execute();
     // module name/info
     const moduleName = argv.module;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     // name
@@ -1441,12 +1430,8 @@ class CliInitAsset extends BeanCliBase {
     await super.execute();
     // module name/info
     const moduleName = argv.module;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     // scene
@@ -1470,12 +1455,8 @@ class CliInitConfig extends BeanCliBase {
     // module name/info
     const moduleName = argv._[0];
     if (!moduleName) return;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     const configFile = path.join(targetDir, 'src/config/config.ts');
@@ -1508,12 +1489,8 @@ class CliInitConstant extends BeanCliBase {
     // module name/info
     const moduleName = argv._[0];
     if (!moduleName) return;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     const constantFile = path.join(targetDir, 'src/config/constants.ts');
@@ -1546,12 +1523,8 @@ class CliInitError extends BeanCliBase {
     // module name/info
     const moduleName = argv._[0];
     if (!moduleName) return;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     const errorFile = path.join(targetDir, 'src/config/errors.ts');
@@ -1595,12 +1568,8 @@ class CliInitLib extends BeanCliBase {
     // module name/info
     const moduleName = argv._[0];
     if (!moduleName) return;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     const mainFile = path.join(targetDir, 'src/lib/index.ts');
@@ -1633,12 +1602,8 @@ class CliInitLocale extends BeanCliBase {
     // module name/info
     const moduleName = argv._[0];
     if (!moduleName) return;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     const localeFile = path.join(targetDir, 'src/config/locale');
@@ -1671,12 +1636,8 @@ class CliInitMain extends BeanCliBase {
     // module name/info
     const moduleName = argv._[0];
     if (!moduleName) return;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     const mainFile = path.join(targetDir, 'src/main.ts');
@@ -1709,12 +1670,8 @@ class CliInitMonkey extends BeanCliBase {
     // module name/info
     const moduleName = argv._[0];
     if (!moduleName) return;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     const monkeyFile = path.join(targetDir, 'src/monkey.ts');
@@ -1771,12 +1728,8 @@ class CliInitStatic extends BeanCliBase {
     // module name/info
     const moduleName = argv._[0];
     if (!moduleName) return;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     const staticDir = path.join(targetDir, 'assets/static');
@@ -1807,12 +1760,8 @@ class CliInitTypes extends BeanCliBase {
     // module name/info
     const moduleName = argv._[0];
     if (!moduleName) return;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     const mainFile = path.join(targetDir, 'src/types/index.ts');
@@ -1849,12 +1798,8 @@ class CliToolsCrud extends BeanCliBase {
     argv.ssrSiteGroupName = isCabloyStart ? 'start-siteadmin:management' : 'basic-siteadmin:management';
     // module name/info
     const moduleName = argv.module;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     // resourceName
@@ -1895,12 +1840,8 @@ class CliToolsCrudBasic extends BeanCliBase {
     await super.execute();
     // module name/info
     const moduleName = argv.module;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     // resourceName
@@ -1939,12 +1880,8 @@ class CliToolsCrudStart extends BeanCliBase {
     await super.execute();
     // module name/info
     const moduleName = argv.module;
-    argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
-    // check if exists
-    const _module = this.helper.findModule(moduleName);
-    if (!_module) {
-      throw new Error(`module does not exist: ${moduleName}`);
-    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(moduleName);
+    const _module = this.helper.findModuleCanonical(moduleName);
     // target dir
     const targetDir = await this.helper.ensureDir(_module.root);
     // resourceName
@@ -2049,6 +1986,529 @@ class CliToolsDeps extends BeanCliBase {
   }
 }
 
+class CliToolsMasterDetail extends BeanCliBase {
+  async execute() {
+    await super.execute();
+    this._prepareArgv();
+    await this._ensureDetailModule();
+    await this._ensureDetailResourceShape();
+    await this._patchDetailModule();
+    await this._renderMasterDetailDtos();
+    await this._patchMasterModule();
+    await this._refreshMetadata();
+  }
+  _prepareArgv() {
+    const {
+      argv
+    } = this.context;
+    argv.detailMode = argv.detailMode || 'aggregate';
+    if (argv.detailMode !== 'aggregate' && argv.detailMode !== 'standalone') {
+      throw new Error(`mode is not valid: ${argv.detailMode}`);
+    }
+    argv.moduleInfo = this.helper.parseModuleInfoCanonical(argv.module, 'master module');
+    const _module = this.helper.findModuleCanonical(argv.module, 'master module');
+    argv._module = _module;
+    argv.resourceNameCapitalize = this.helper.firstCharToUpperCase(argv.resourceName);
+    argv.detailModuleInfo = this.helper.parseModuleInfoCanonical(argv.detailModule, 'detail module');
+    argv._detailModule = this.helper.findModule(argv.detailModule);
+    argv.detailResourceNameCapitalize = this.helper.firstCharToUpperCase(argv.detailResourceName);
+    argv.relationName = argv.relationName || `${argv.detailResourceName}s`;
+    argv.relationNameCapitalize = this.helper.firstCharToUpperCase(argv.relationName);
+    argv.fk = argv.fk || `${argv.resourceName}Id`;
+    argv.detailPackageName = `vona-module-${argv.detailModuleInfo.relativeName}`;
+    argv.detailModuleCapitalize = this.helper.stringToCapitalize(argv.detailModuleInfo.relativeName, '-');
+    argv.detailDtoBaseName = `detail${argv.detailResourceNameCapitalize}Base`;
+    argv.detailDtoMutateName = `detail${argv.detailResourceNameCapitalize}Mutate`;
+    argv.detailDtoViewName = `detail${argv.detailResourceNameCapitalize}View`;
+    argv.detailDtoResItemName = `detail${argv.detailResourceNameCapitalize}ResItem`;
+    argv.detailFieldPrivateName = `_${argv.relationName}`;
+    argv.detailDialogTitleCapitalize = argv.detailModuleCapitalize;
+  }
+  async _ensureDetailModule() {
+    const {
+      argv
+    } = this.context;
+    if (argv._detailModule) return;
+    const args = [':create:module', argv.detailModule, '--nometadata'];
+    if (argv._module.suite) {
+      args.push(`--suite=${argv._module.suite}`);
+    }
+    await this.helper.invokeCli(args, {
+      cwd: argv.projectPath
+    });
+    argv.createdDetailModule = true;
+    argv._detailModule = this.helper.findModule(argv.detailModule);
+    if (!argv._detailModule) {
+      const root = this._resolveCreatedDetailModuleRoot();
+      argv._detailModule = {
+        name: argv.detailModuleInfo.relativeName,
+        info: argv.detailModuleInfo,
+        root,
+        pkg: path.join(root, 'package.json'),
+        package: await this.helper.loadJSONFile(path.join(root, 'package.json')),
+        suite: argv._module.suite
+      };
+    }
+  }
+  async _ensureDetailResourceShape() {
+    const {
+      argv
+    } = this.context;
+    const {
+      hasCoreDetailFiles,
+      hasStandaloneSurface
+    } = this._detailModuleShape();
+    if (!hasCoreDetailFiles) {
+      await this._createDetailCoreResource();
+      argv.createdDetailResource = true;
+    }
+    if (argv.detailMode === 'aggregate') {
+      this._handleAggregateDetailMode(hasStandaloneSurface);
+      return;
+    }
+    this._handleStandaloneDetailMode();
+  }
+  async _patchDetailModule() {
+    await this._runSequential(this._detailPatchTasks());
+  }
+  async _patchDetailEntity() {
+    const {
+      argv
+    } = this.context;
+    await this._patchFileContent({
+      fileName: this._detailPaths().entity,
+      existsNeedle: `${argv.fk}: TableIdentity;`,
+      patch: (content, fileName) => {
+        content = this._patchDetailEntityImport(content);
+        return this._patchDetailEntityField(content, fileName);
+      }
+    });
+  }
+  _patchDetailEntityImport(content) {
+    if (!content.includes("import type { TableIdentity } from 'table-identity';")) {
+      content = `import type { TableIdentity } from 'table-identity';\n${content}`;
+    }
+    return content;
+  }
+  _patchDetailEntityField(content, fileName) {
+    const {
+      argv
+    } = this.context;
+    const marker = `export class Entity${argv.detailResourceNameCapitalize} extends EntityBase {\n`;
+    if (!content.includes(marker)) {
+      throw new Error(`detail entity is not in the expected shape: ${fileName}`);
+    }
+    const fieldCode = `  @Api.field(v.required(), ZovaRender.visible(false))\n  ${argv.fk}: TableIdentity;\n\n`;
+    return content.replace(marker, `${marker}${fieldCode}`);
+  }
+  async _patchDetailMetaVersion() {
+    const {
+      argv
+    } = this.context;
+    await this._patchFileByMarker({
+      fileName: this._detailPaths().metaVersion,
+      existsNeedle: `entity${argv.detailResourceNameCapitalize}.${argv.fk}`,
+      marker: '        table.basicFields();\n',
+      line: this._detailMetaVersionLine(),
+      shapeName: 'detail meta.version'
+    });
+  }
+  async _patchDetailMetaIndex() {
+    const {
+      argv
+    } = this.context;
+    await this._patchFileByMarker({
+      fileName: this._detailPaths().metaIndex,
+      existsNeedle: `'${argv.fk}'`,
+      marker: '  indexes: {\n',
+      line: this._detailMetaIndexLine(),
+      shapeName: 'detail meta.index'
+    });
+  }
+  _detailMetaVersionLine() {
+    const {
+      argv
+    } = this.context;
+    return `        table.tableIdentity(entity${argv.detailResourceNameCapitalize}.${argv.fk}).comment(entity${argv.detailResourceNameCapitalize}.$comment.${argv.fk});\n`;
+  }
+  _detailMetaIndexLine() {
+    const {
+      argv
+    } = this.context;
+    return `    ...$tableColumns('${this.helper.combineModuleNameAndResource(argv.detailModuleInfo.relativeName, argv.detailResourceName)}', '${argv.fk}'),\n`;
+  }
+  async _patchFileByMarker({
+    fileName,
+    existsNeedle,
+    marker,
+    line,
+    shapeName
+  }) {
+    let content = this._readFile(fileName);
+    if (content.includes(existsNeedle)) return;
+    if (!content.includes(marker)) {
+      throw new Error(`${shapeName} is not in the expected shape: ${fileName}`);
+    }
+    content = content.replace(marker, `${marker}${line}`);
+    await this._saveFile(fileName, content);
+  }
+  async _patchFileContent({
+    fileName,
+    existsNeedle,
+    patch
+  }) {
+    let content = this._readFile(fileName);
+    if (content.includes(existsNeedle)) return;
+    content = patch(content, fileName);
+    await this._saveFile(fileName, content);
+  }
+  async _renderMasterDetailDtos() {
+    await this.helper.ensureDir(this._masterPaths().dtoDir);
+    for (const [dtoBaseName, templateBaseName] of this._detailDtoTemplates()) {
+      await this._renderMasterDetailDtoFile(dtoBaseName, templateBaseName);
+    }
+  }
+  async _patchMasterModule() {
+    await this._runSequential(this._masterPatchTasks());
+  }
+  _detailPatchTasks() {
+    return [() => this._patchDetailEntity(), () => this._patchDetailMetaVersion(), () => this._patchDetailMetaIndex()];
+  }
+  _masterPatchTasks() {
+    return [() => this._patchMasterModel(), () => this._patchMasterService(), ...this._masterDtoScenes().map(scene => () => this._patchMasterDto(scene)), ...this._masterLocales().map(locale => () => this._patchMasterLocale(locale))];
+  }
+  async _runSequential(tasks) {
+    for (const task of tasks) {
+      await task();
+    }
+  }
+  async _patchMasterModel() {
+    const {
+      argv
+    } = this.context;
+    const fileName = this._masterPaths().model;
+    let content = this._readFile(fileName);
+    if (content.includes(`${argv.relationName}: $relation.hasMany(`)) return;
+    content = this._patchMasterModelImport(content, fileName);
+    content = this._patchMasterModelRelations(content, fileName);
+    await this._saveFile(fileName, content);
+  }
+  async _patchMasterService() {
+    const {
+      argv
+    } = this.context;
+    const fileName = this._masterPaths().service;
+    let content = this._readFile(fileName);
+    if (content.includes(`include: { ${argv.relationName}: true }`)) return;
+    for (const [search, replacement] of this._masterServiceIncludeReplacements()) {
+      content = this._replaceStrict(content, search, replacement, fileName);
+    }
+    await this._saveFile(fileName, content);
+  }
+  _patchMasterModelImport(content, fileName) {
+    if (content.includes("import { $relation, BeanModelBase, Model } from 'vona-module-a-orm';")) {
+      return content;
+    }
+    return this._replaceStrict(content, "import { BeanModelBase, Model } from 'vona-module-a-orm';", "import { $relation, BeanModelBase, Model } from 'vona-module-a-orm';", fileName);
+  }
+  _patchMasterModelRelations(content, fileName) {
+    const relationsBlockMarker = '  relations: {\n';
+    if (content.includes(relationsBlockMarker)) {
+      return content.replace(relationsBlockMarker, `${relationsBlockMarker}${this._masterModelRelationCode()}`);
+    }
+    return this._patchMasterModelDecorator(content, fileName);
+  }
+  _patchMasterModelDecorator(content, fileName) {
+    const {
+      argv
+    } = this.context;
+    const marker = `@Model<IModelOptions${argv.resourceNameCapitalize}>({ entity: Entity${argv.resourceNameCapitalize} })`;
+    if (!content.includes(marker)) {
+      throw new Error(`master model is not in the expected shape: ${fileName}`);
+    }
+    return content.replace(marker, `@Model<IModelOptions${argv.resourceNameCapitalize}>({\n  entity: Entity${argv.resourceNameCapitalize},\n  relations: {\n${this._masterModelRelationCode()}  },\n})`);
+  }
+  _masterModelRelationCode() {
+    const {
+      argv
+    } = this.context;
+    return `    ${argv.relationName}: $relation.hasMany('${argv.detailModuleInfo.relativeName}:${argv.detailResourceName}', '${argv.fk}', {\n      columns: ['id', 'name', 'description'],\n    }),\n`;
+  }
+  _masterServiceIncludeReplacements() {
+    const {
+      argv
+    } = this.context;
+    return [[`    return await this.scope.model.${argv.resourceName}.insert(${argv.resourceName});`, `    return await this.scope.model.${argv.resourceName}.insert(${argv.resourceName}, { include: { ${argv.relationName}: true } });`], [`    return await this.scope.model.${argv.resourceName}.getById(id);`, `    return await this.scope.model.${argv.resourceName}.getById(id, { include: { ${argv.relationName}: true } });`], [`    return await this.scope.model.${argv.resourceName}.updateById(id, ${argv.resourceName});`, `    return await this.scope.model.${argv.resourceName}.updateById(id, ${argv.resourceName}, {\n      include: { ${argv.relationName}: true },\n    });`], [`    return await this.scope.model.${argv.resourceName}.deleteById(id);`, `    return await this.scope.model.${argv.resourceName}.deleteById(id, { include: { ${argv.relationName}: true } });`]];
+  }
+  async _patchMasterDto(scene) {
+    const {
+      argv
+    } = this.context;
+    const fileName = path.join(argv._module.root, 'src/dto', `${argv.resourceName}${scene}.tsx`);
+    let content = this._readFile(fileName);
+    const detailDtoResItemCapitalize = this._detailDtoResItemCapitalize();
+    const detailDtoClassCapitalize = this._detailDtoClassCapitalize(scene);
+    if (content.includes(`${argv.detailFieldPrivateName}?: Dto${detailDtoResItemCapitalize}[];`)) {
+      return;
+    }
+    content = this._patchMasterDtoImports(content, fileName, scene, detailDtoClassCapitalize, detailDtoResItemCapitalize);
+    content = this._patchMasterDtoFields(content, fileName, scene);
+    content = this._patchMasterDtoClass(content, fileName, scene, detailDtoClassCapitalize, detailDtoResItemCapitalize);
+    await this._saveFile(fileName, content);
+  }
+  async _patchMasterLocale(locale) {
+    const fileName = path.join(this._masterPaths().localeDir, `${locale}.ts`);
+    let content = this._readFile(fileName);
+    content = this._patchLocaleAdditions(content, this._masterLocaleAdditions(locale));
+    await this._saveFile(fileName, content);
+  }
+  async _refreshMetadata() {
+    const {
+      argv
+    } = this.context;
+    for (const moduleName of this._metadataModules()) {
+      await this.helper.invokeCli([':tools:metadata', moduleName], {
+        cwd: argv.projectPath
+      });
+    }
+  }
+  _patchLocaleAdditions(content, additions) {
+    for (const addition of additions) {
+      const key = this._localeAdditionKey(addition);
+      if (content.includes(`${key}:`)) continue;
+      content = content.replace('};\n', `  ${addition},\n};\n`);
+    }
+    return content;
+  }
+  _localeAdditionKey(addition) {
+    return addition.split(':')[0];
+  }
+  _metadataModules() {
+    const {
+      argv
+    } = this.context;
+    return [argv.detailModule, argv.module];
+  }
+  async _renderMasterDetailDtoFile(dtoBaseName, templateBaseName) {
+    const targetFile = path.join(this._masterPaths().dtoDir, `${dtoBaseName}.tsx`);
+    if (fs.existsSync(targetFile)) return;
+    const templateFile = this.template.resolveTemplatePath(__ThisSetName__, `tools/masterDetail/boilerplate/dto/${templateBaseName}`);
+    const templateContent = fs.readFileSync(templateFile).toString('utf8');
+    const renderedContent = await this.template.renderContent({
+      content: templateContent
+    });
+    await this._saveFile(targetFile, renderedContent);
+  }
+  _patchMasterDtoImports(content, fileName, scene, detailDtoClassCapitalize, detailDtoResItemCapitalize) {
+    const {
+      argv
+    } = this.context;
+    if (!content.includes("import { $makeMetadata, Api, v } from 'vona-module-a-openapiutils';")) {
+      content = this._replaceStrict(content, "import { $Dto } from 'vona-module-a-orm';", "import { $makeMetadata, Api, v } from 'vona-module-a-openapiutils';\nimport { $Dto } from 'vona-module-a-orm';", fileName);
+    }
+    if (!content.includes("import { $locale } from '../.metadata/locales.ts';")) {
+      content = this._replaceStrict(content, "import { ZovaRender } from 'zova-rest-cabloy-basic-admin';\n", "import { ZovaRender } from 'zova-rest-cabloy-basic-admin';\n\nimport { $locale } from '../.metadata/locales.ts';\n", fileName);
+    }
+    const importMarker = `import { Model${argv.resourceNameCapitalize} } from '../model/${argv.resourceName}.ts';\n`;
+    if (!content.includes(`import { Dto${detailDtoClassCapitalize} } from './`)) {
+      content = this._replaceStrict(content, importMarker, `${importMarker}${this._masterDtoDetailImports(scene, detailDtoClassCapitalize, detailDtoResItemCapitalize)}`, fileName);
+    }
+    return content;
+  }
+  _patchMasterDtoFields(content, fileName, scene) {
+    const fieldCode = this._masterDtoFieldCode(scene);
+    if (content.includes('  fields: {\n')) {
+      return content.replace('  fields: {\n', `  fields: {\n${fieldCode}`);
+    }
+    const decoratorMarker = '  ],\n})';
+    if (!content.includes(decoratorMarker)) {
+      throw new Error(`master dto decorator is not in the expected shape: ${fileName}`);
+    }
+    return content.replace(decoratorMarker, `  ],\n  fields: {\n${fieldCode}  },\n})`);
+  }
+  _patchMasterDtoClass(content, fileName, scene, detailDtoClassCapitalize, detailDtoResItemCapitalize) {
+    const classReplaceSource = this._masterDtoClassReplaceSource(scene);
+    if (!content.includes(classReplaceSource)) {
+      throw new Error(`master dto class is not in the expected generated shape: ${fileName}`);
+    }
+    return content.replace(classReplaceSource, this._masterDtoClassReplaceTarget(scene, detailDtoClassCapitalize, detailDtoResItemCapitalize));
+  }
+  _masterDtoDetailImports(scene, detailDtoClassCapitalize, detailDtoResItemCapitalize) {
+    const {
+      argv
+    } = this.context;
+    return `import { Dto${detailDtoClassCapitalize} } from './${scene === 'View' ? argv.detailDtoViewName : argv.detailDtoMutateName}.tsx';\nimport { Dto${detailDtoResItemCapitalize} } from './${argv.detailDtoResItemName}.tsx';\n`;
+  }
+  _masterDtoFieldCode(scene) {
+    const {
+      argv
+    } = this.context;
+    return `    ${argv.relationName}: $makeMetadata(\n      v.title($locale('${argv.relationNameCapitalize}')),\n      ZovaRender.order(5),\n      ZovaRender.field('basic-details:formFieldDetails'),\n${scene === 'Create' ? '      v.optional(),\n' : ''}    ),\n`;
+  }
+  _masterDtoClassReplaceSource(scene) {
+    const {
+      argv
+    } = this.context;
+    const kind = scene === 'Create' ? 'create' : scene === 'Update' ? 'update' : 'get';
+    return `export class Dto${argv.resourceNameCapitalize}${scene} extends $Dto.${kind}(() => Model${argv.resourceNameCapitalize}) {}`;
+  }
+  _masterDtoClassReplaceTarget(scene, detailDtoClassCapitalize, detailDtoResItemCapitalize) {
+    const {
+      argv
+    } = this.context;
+    const kind = scene === 'Create' ? 'create' : scene === 'Update' ? 'update' : 'get';
+    return `export class Dto${argv.resourceNameCapitalize}${scene} extends $Dto.${kind}(() => Model${argv.resourceNameCapitalize}, {\n  include: { ${argv.relationName}: { dtoClass: Dto${detailDtoClassCapitalize} } },\n}) {\n  @Api.field(ZovaRender.visible(false), v.optional(), v.array(Dto${detailDtoResItemCapitalize}))\n  ${argv.detailFieldPrivateName}?: Dto${detailDtoResItemCapitalize}[];\n}`;
+  }
+  _detailDtoClassCapitalize(scene) {
+    const {
+      argv
+    } = this.context;
+    return scene === 'View' ? this._capitalize(argv.detailDtoViewName) : this._capitalize(argv.detailDtoMutateName);
+  }
+  _masterLocaleAdditions(locale) {
+    const {
+      argv
+    } = this.context;
+    if (locale === 'en-us') {
+      return [`${argv.relationNameCapitalize}: '${this._titleize(argv.relationName)}'`, `Add${argv.detailDialogTitleCapitalize}: 'Add ${this._titleize(argv.detailModuleInfo.relativeName)}'`, `Edit${argv.detailDialogTitleCapitalize}: 'Edit ${this._titleize(argv.detailModuleInfo.relativeName)}'`, `View${argv.detailDialogTitleCapitalize}: 'View ${this._titleize(argv.detailModuleInfo.relativeName)}'`];
+    }
+    return [`${argv.relationNameCapitalize}: '明细'`, `Add${argv.detailDialogTitleCapitalize}: '添加明细'`, `Edit${argv.detailDialogTitleCapitalize}: '编辑明细'`, `View${argv.detailDialogTitleCapitalize}: '查看明细'`];
+  }
+  async _createDetailCoreResource() {
+    const {
+      argv
+    } = this.context;
+    await this.helper.invokeCli([':tools:crudBasic', argv.detailResourceName, `--module=${argv.detailModule}`, '--nometadata'], {
+      cwd: argv.projectPath
+    });
+  }
+  _handleAggregateDetailMode(hasStandaloneSurface) {
+    const {
+      argv
+    } = this.context;
+    if (hasStandaloneSurface && !argv.createdDetailResource) {
+      throw new Error(`detail module already has a standalone resource surface: ${argv.detailModule}:${argv.detailResourceName}`);
+    }
+    if (this._hasStandaloneDetailSurface()) {
+      this._removeStandaloneDetailSurface();
+    }
+  }
+  _handleStandaloneDetailMode() {
+    const {
+      argv
+    } = this.context;
+    if (!this._hasStandaloneDetailSurface()) {
+      throw new Error(`detail module does not have a standalone resource surface: ${argv.detailModule}:${argv.detailResourceName}`);
+    }
+  }
+  _detailModuleShape() {
+    const files = this._detailPaths();
+    return {
+      hasCoreDetailFiles: fs.existsSync(files.entity) && fs.existsSync(files.model),
+      hasStandaloneSurface: this._hasStandaloneDetailSurface()
+    };
+  }
+  _masterPaths() {
+    const {
+      argv
+    } = this.context;
+    const masterRoot = argv._module.root;
+    return {
+      root: masterRoot,
+      model: path.join(masterRoot, 'src/model', `${argv.resourceName}.ts`),
+      service: path.join(masterRoot, 'src/service', `${argv.resourceName}.ts`),
+      dtoDir: path.join(masterRoot, 'src/dto'),
+      localeDir: path.join(masterRoot, 'src/config/locale')
+    };
+  }
+  _detailPaths() {
+    const {
+      argv
+    } = this.context;
+    const detailRoot = argv._detailModule.root;
+    return {
+      root: detailRoot,
+      entity: path.join(detailRoot, 'src/entity', `${argv.detailResourceName}.tsx`),
+      model: path.join(detailRoot, 'src/model', `${argv.detailResourceName}.ts`),
+      controller: path.join(detailRoot, 'src/controller', `${argv.detailResourceName}.ts`),
+      service: path.join(detailRoot, 'src/service', `${argv.detailResourceName}.ts`),
+      dtoDir: path.join(detailRoot, 'src/dto'),
+      test: path.join(detailRoot, 'test', `${argv.detailResourceName}.test.ts`),
+      metaVersion: path.join(detailRoot, 'src/bean', 'meta.version.ts'),
+      metaIndex: path.join(detailRoot, 'src/bean', 'meta.index.ts')
+    };
+  }
+  _hasStandaloneDetailSurface() {
+    const files = this._detailPaths();
+    return fs.existsSync(files.controller) || fs.existsSync(files.service) || fs.existsSync(files.dtoDir);
+  }
+  _removeStandaloneDetailSurface() {
+    const files = this._detailPaths();
+    for (const file of [files.controller, files.service, files.test]) {
+      if (fs.existsSync(file)) {
+        fs.rmSync(file, {
+          force: true
+        });
+      }
+    }
+    if (fs.existsSync(files.dtoDir)) {
+      fs.rmSync(files.dtoDir, {
+        recursive: true,
+        force: true
+      });
+    }
+  }
+  _detailDtoResItemCapitalize() {
+    return this._capitalize(this.context.argv.detailDtoResItemName);
+  }
+  _detailDtoTemplates() {
+    const {
+      argv
+    } = this.context;
+    return [[argv.detailDtoBaseName, '<%=argv.detailDtoBaseName%>.tsx_'], [argv.detailDtoMutateName, '<%=argv.detailDtoMutateName%>.tsx_'], [argv.detailDtoViewName, '<%=argv.detailDtoViewName%>.tsx_'], [argv.detailDtoResItemName, '<%=argv.detailDtoResItemName%>.tsx_']];
+  }
+  _masterDtoScenes() {
+    return ['Create', 'Update', 'View'];
+  }
+  _masterLocales() {
+    return ['en-us', 'zh-cn'];
+  }
+  _resolveCreatedDetailModuleRoot() {
+    const {
+      argv
+    } = this.context;
+    if (argv._module.suite) {
+      return path.join(argv.projectPath, 'src/suite', argv._module.suite, 'modules', argv.detailModule);
+    }
+    return path.join(argv.projectPath, 'src/module', argv.detailModule);
+  }
+  _capitalize(name) {
+    return this.helper.firstCharToUpperCase(name);
+  }
+  _titleize(name) {
+    return this.helper.stringToCapitalize(name, '-').replace(/([A-Z])/g, ' $1').trim();
+  }
+  _readFile(fileName) {
+    if (!fs.existsSync(fileName)) {
+      throw new Error(`file does not exist: ${fileName}`);
+    }
+    return fs.readFileSync(fileName).toString('utf8');
+  }
+  async _saveFile(fileName, content) {
+    fs.writeFileSync(fileName, content);
+    await this.helper.formatFile({
+      fileName,
+      logPrefix: 'format: '
+    });
+  }
+  _replaceStrict(content, search, replacement, fileName) {
+    if (!content.includes(search)) {
+      throw new Error(`file is not in the expected shape: ${fileName}`);
+    }
+    return content.replace(search, replacement);
+  }
+}
+
 function checkIgnoreOfParts(parts) {
   const indexLast = parts.length - 1;
   if (parts[indexLast].endsWith('_')) {
@@ -2542,8 +3002,7 @@ class CliToolsMetadata extends BeanCliBase {
     }
   }
   async _generateMetadata(moduleName, force) {
-    const module = this.helper.findModule(moduleName);
-    if (!module) throw new Error(`module not found: ${moduleName}`);
+    const module = this.helper.findModuleCanonical(moduleName);
     const modulePath = module.root;
     const metaDir = path.join(modulePath, 'src/.metadata');
     const metaIndexFile = path.join(metaDir, 'index.ts');
@@ -2788,7 +3247,8 @@ const beans = {
   'tools.metadata': CliToolsMetadata,
   'tools.crudBasic': CliToolsCrudBasic,
   'tools.crudStart': CliToolsCrudStart,
-  'tools.crud': CliToolsCrud
+  'tools.crud': CliToolsCrud,
+  'tools.masterDetail': CliToolsMasterDetail
 };
 
 var binBuild = {
@@ -3361,6 +3821,84 @@ var toolsDeps = {
   options: {}
 };
 
+var toolsMasterDetail = {
+  bean: 'tools.masterDetail',
+  info: {
+    version: '5.0.0',
+    title: 'Cli: Tools: Master Detail',
+    usage: 'npm run vona :tools:masterDetail resourceName -- [--module=] [--detailModule=] [--detailResourceName=] [--relationName=] [--fk=] [--detailMode=aggregate|standalone]'
+  },
+  options: {
+    module: {
+      description: 'master module relative name, such as training-student',
+      type: 'string'
+    },
+    detailModule: {
+      description: 'detail module relative name, such as training-record',
+      type: 'string'
+    },
+    detailResourceName: {
+      description: 'detail resource name',
+      type: 'string'
+    },
+    relationName: {
+      description: 'master relation name',
+      type: 'string'
+    },
+    fk: {
+      description: 'detail foreign key field name',
+      type: 'string'
+    },
+    detailMode: {
+      description: 'detail mode: aggregate or standalone',
+      type: 'string'
+    }
+  },
+  groups: {
+    default: {
+      questions: {
+        resourceName: {
+          type: 'input',
+          message: 'master resourceName',
+          initial: {
+            expression: 'arg0'
+          },
+          required: true
+        },
+        module: {
+          type: 'input',
+          message: 'master module relative name (for example training-student)',
+          required: true
+        },
+        detailModule: {
+          type: 'input',
+          message: 'detail module relative name (for example training-record)',
+          required: true
+        },
+        detailResourceName: {
+          type: 'input',
+          message: 'detail resourceName',
+          required: true
+        },
+        relationName: {
+          type: 'input',
+          message: 'master relation name'
+        },
+        fk: {
+          type: 'input',
+          message: 'detail foreign key field name'
+        },
+        detailMode: {
+          type: 'input',
+          message: 'detail mode (aggregate|standalone)',
+          initial: 'aggregate',
+          required: true
+        }
+      }
+    }
+  }
+};
+
 var toolsMetadata = {
   bean: 'tools.metadata',
   info: {
@@ -3415,7 +3953,8 @@ const commands = {
     metadata: toolsMetadata,
     crudBasic: toolsCrudBasic,
     crudStart: toolsCrudStart,
-    crud: toolsCrud
+    crud: toolsCrud,
+    masterDetail: toolsMasterDetail
   }
 };
 

package/dist/lib/bean/cli.tools.masterDetail.d.ts

@@ -0,0 +1,94 @@
+import type { IModule, IModuleInfo } from '@cabloy/module-info';
+import { BeanCliBase } from '@cabloy/cli';
+type DetailMode = 'aggregate' | 'standalone';
+declare module '@cabloy/cli' {
+    interface ICommandArgv {
+        module: string;
+        moduleInfo: IModuleInfo;
+        _module: IModule;
+        resourceName: string;
+        resourceNameCapitalize: string;
+        detailModule: string;
+        detailModuleInfo: IModuleInfo;
+        _detailModule?: IModule;
+        detailResourceName: string;
+        detailResourceNameCapitalize: string;
+        relationName: string;
+        relationNameCapitalize: string;
+        fk: string;
+        detailMode: DetailMode;
+        detailPackageName: string;
+        detailModuleCapitalize: string;
+        detailDtoBaseName: string;
+        detailDtoMutateName: string;
+        detailDtoViewName: string;
+        detailDtoResItemName: string;
+        detailFieldPrivateName: string;
+        detailDialogTitleCapitalize: string;
+        createdDetailModule?: boolean;
+        createdDetailResource?: boolean;
+    }
+}
+export declare class CliToolsMasterDetail extends BeanCliBase {
+    execute(): Promise<void>;
+    private _prepareArgv;
+    private _ensureDetailModule;
+    private _ensureDetailResourceShape;
+    private _patchDetailModule;
+    private _patchDetailEntity;
+    private _patchDetailEntityImport;
+    private _patchDetailEntityField;
+    private _patchDetailMetaVersion;
+    private _patchDetailMetaIndex;
+    private _detailMetaVersionLine;
+    private _detailMetaIndexLine;
+    private _patchFileByMarker;
+    private _patchFileContent;
+    private _renderMasterDetailDtos;
+    private _patchMasterModule;
+    private _detailPatchTasks;
+    private _masterPatchTasks;
+    private _runSequential;
+    private _patchMasterModel;
+    private _patchMasterService;
+    private _patchMasterModelImport;
+    private _patchMasterModelRelations;
+    private _patchMasterModelDecorator;
+    private _masterModelRelationCode;
+    private _masterServiceIncludeReplacements;
+    private _patchMasterDto;
+    private _patchMasterLocale;
+    private _refreshMetadata;
+    private _patchLocaleAdditions;
+    private _localeAdditionKey;
+    private _metadataModules;
+    private _renderMasterDetailDtoFile;
+    private _patchMasterDtoImports;
+    private _patchMasterDtoFields;
+    private _patchMasterDtoClass;
+    private _masterDtoDetailImports;
+    private _masterDtoFieldCode;
+    private _masterDtoClassReplaceSource;
+    private _masterDtoClassReplaceTarget;
+    private _detailDtoClassCapitalize;
+    private _masterLocaleAdditions;
+    private _createDetailCoreResource;
+    private _handleAggregateDetailMode;
+    private _handleStandaloneDetailMode;
+    private _detailModuleShape;
+    private _masterPaths;
+    private _detailPaths;
+    private _hasStandaloneDetailSurface;
+    private _removeStandaloneDetailSurface;
+    private _detailDtoResItemCapitalize;
+    private _detailDtoTemplates;
+    private _masterDtoScenes;
+    private _masterLocales;
+    private _resolveCreatedDetailModuleRoot;
+    private _capitalize;
+    private _titleize;
+    private _readFile;
+    private _saveFile;
+    private _replaceStrict;
+}
+export {};

package/dist/lib/beans.d.ts

@@ -26,6 +26,7 @@ import { CliToolsCrud } from './bean/cli.tools.crud.ts';
 import { CliToolsCrudBasic } from './bean/cli.tools.crudBasic.ts';
 import { CliToolsCrudStart } from './bean/cli.tools.crudStart.ts';
 import { CliToolsDeps } from './bean/cli.tools.deps.ts';
+import { CliToolsMasterDetail } from './bean/cli.tools.masterDetail.ts';
 import { CliToolsMetadata } from './bean/cli.tools.metadata.ts';
 export declare const beans: {
     'default.list': typeof CliDefaultList;
@@ -57,4 +58,5 @@ export declare const beans: {
     'tools.crudBasic': typeof CliToolsCrudBasic;
     'tools.crudStart': typeof CliToolsCrudStart;
     'tools.crud': typeof CliToolsCrud;
+    'tools.masterDetail': typeof CliToolsMasterDetail;
 };

package/dist/lib/command/tools.masterDetail.d.ts

@@ -0,0 +1,78 @@
+declare const _default: {
+    bean: string;
+    info: {
+        version: string;
+        title: string;
+        usage: string;
+    };
+    options: {
+        module: {
+            description: string;
+            type: string;
+        };
+        detailModule: {
+            description: string;
+            type: string;
+        };
+        detailResourceName: {
+            description: string;
+            type: string;
+        };
+        relationName: {
+            description: string;
+            type: string;
+        };
+        fk: {
+            description: string;
+            type: string;
+        };
+        detailMode: {
+            description: string;
+            type: string;
+        };
+    };
+    groups: {
+        default: {
+            questions: {
+                resourceName: {
+                    type: string;
+                    message: string;
+                    initial: {
+                        expression: string;
+                    };
+                    required: boolean;
+                };
+                module: {
+                    type: string;
+                    message: string;
+                    required: boolean;
+                };
+                detailModule: {
+                    type: string;
+                    message: string;
+                    required: boolean;
+                };
+                detailResourceName: {
+                    type: string;
+                    message: string;
+                    required: boolean;
+                };
+                relationName: {
+                    type: string;
+                    message: string;
+                };
+                fk: {
+                    type: string;
+                    message: string;
+                };
+                detailMode: {
+                    type: string;
+                    message: string;
+                    initial: string;
+                    required: boolean;
+                };
+            };
+        };
+    };
+};
+export default _default;

package/dist/lib/commands.d.ts

@@ -545,5 +545,82 @@ export declare const commands: {
                 };
             };
         };
+        masterDetail: {
+            bean: string;
+            info: {
+                version: string;
+                title: string;
+                usage: string;
+            };
+            options: {
+                module: {
+                    description: string;
+                    type: string;
+                };
+                detailModule: {
+                    description: string;
+                    type: string;
+                };
+                detailResourceName: {
+                    description: string;
+                    type: string;
+                };
+                relationName: {
+                    description: string;
+                    type: string;
+                };
+                fk: {
+                    description: string;
+                    type: string;
+                };
+                detailMode: {
+                    description: string;
+                    type: string;
+                };
+            };
+            groups: {
+                default: {
+                    questions: {
+                        resourceName: {
+                            type: string;
+                            message: string;
+                            initial: {
+                                expression: string;
+                            };
+                            required: boolean;
+                        };
+                        module: {
+                            type: string;
+                            message: string;
+                            required: boolean;
+                        };
+                        detailModule: {
+                            type: string;
+                            message: string;
+                            required: boolean;
+                        };
+                        detailResourceName: {
+                            type: string;
+                            message: string;
+                            required: boolean;
+                        };
+                        relationName: {
+                            type: string;
+                            message: string;
+                        };
+                        fk: {
+                            type: string;
+                            message: string;
+                        };
+                        detailMode: {
+                            type: string;
+                            message: string;
+                            initial: string;
+                            required: boolean;
+                        };
+                    };
+                };
+            };
+        };
     };
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vona-cli-set-api",
-  "version": "1.1.110",
-  "gitHead": "ca10457f38716ad28bf5918dd67c85dd1f7dc9d0",
+  "version": "1.1.117",
+  "gitHead": "1a39e8008e1b48001cfeff475ddd53a2a0d867c4",
   "description": "vona cli-set-api",
   "keywords": [
     "framework",
@@ -35,13 +35,13 @@
     "tsc:publish": "npm run clean && node ../cli/src/bin/vona.ts :bin:buildGeneral && tsc -p tsconfig.build.json && tsc -p tsconfig.cli.json && tsc -p tsconfig.isolate.json",
     "prepublishOnly": "npm run tsc:publish",
     "prepack": "clean-package",
-    "postpack": "clean-package restore && npm run clean"
+    "postpack": "clean-package restore"
   },
   "dependencies": {
     "@babel/plugin-proposal-decorators": "^7.29.0",
     "@babel/plugin-transform-class-properties": "^7.28.6",
     "@babel/plugin-transform-typescript": "^7.28.6",
-    "@cabloy/cli": "^3.1.18",
+    "@cabloy/cli": "^3.1.23",
     "@cabloy/dotenv": "^1.2.8",
     "@cabloy/extend": "^3.2.8",
     "@cabloy/module-glob": "^5.3.13",
@@ -73,7 +73,7 @@
     "ts-node-maintained": "^10.9.6",
     "urllib": "^4.9.0",
     "uuid": "^11.1.0",
-    "vona-core": "^5.1.23",
+    "vona-core": "^5.1.24",
     "why-is-node-running": "^3.2.2",
     "yargs-parser": "^22.0.0"
   }