vona-cli-set-api 1.1.61 → 1.1.62

package/cli/templates/create/project/cabloy-basic/boilerplate/__VONA__

@@ -0,0 +1 @@
+

package/cli/templates/create/project/cabloy-start/boilerplate/__VONA__

@@ -0,0 +1 @@
+

package/cli/templates/create/project/cabloy-start/boilerplate/src/suite/a-home/modules/home-user/src/dto/login.ts

@@ -3,7 +3,7 @@ import type { IDecoratorDtoOptions } from 'vona-module-a-web';
 import { DtoCaptchaVerify } from 'vona-module-a-captcha';
 import { Api, v } from 'vona-module-a-openapiutils';
 import { Dto } from 'vona-module-a-web';
-import { ZovaRender } from 'zova-rest-cabloy-basic-admin';
+import { ZovaRender } from 'zova-rest-cabloy-start-admin';
 
 export interface IDtoOptionsLogin extends IDecoratorDtoOptions {}
 
@@ -18,7 +18,7 @@ export class DtoLogin {
   @Api.field(
     v.required(),
     ZovaRender.layout({ iconPrefix: ':editor:code-block' }),
-    ZovaRender.field('basic-captcha:formFieldCaptcha'),
+    ZovaRender.field('start-captcha:formFieldCaptcha'),
   )
   captcha: DtoCaptchaVerify;
 }

package/cli/templates/create/project/cabloy-start/boilerplate/src/suite/a-home/modules/home-user/src/dto/register.ts

@@ -3,7 +3,7 @@ import type { IDecoratorDtoOptions } from 'vona-module-a-web';
 import { DtoCaptchaVerify } from 'vona-module-a-captcha';
 import { Api, v } from 'vona-module-a-openapiutils';
 import { Dto } from 'vona-module-a-web';
-import { ZovaRender } from 'zova-rest-cabloy-basic-admin';
+import { ZovaRender } from 'zova-rest-cabloy-start-admin';
 
 export interface IDtoOptionsRegister extends IDecoratorDtoOptions {}
 
@@ -23,6 +23,6 @@ export class DtoRegister {
   @Api.field(v.min(6), v.max(20))
   passwordConfirm: string;
 
-  @Api.field(ZovaRender.field('basic-captcha:formFieldCaptcha'))
+  @Api.field(ZovaRender.field('start-captcha:formFieldCaptcha'))
   captcha: DtoCaptchaVerify;
 }

package/cli/templates/tools/crudStart/boilerplate/src/controller/{{resourceName}}.ts_

@@ -0,0 +1,49 @@
+import type { TableIdentity } from 'table-identity';
+import type { IQueryParams } from 'vona-module-a-orm';
+import type { IDecoratorControllerOptions } from 'vona-module-a-web';
+
+import { BeanBase } from 'vona';
+import { Api, Resource, v } from 'vona-module-a-openapiutils';
+import { Arg, Controller, Web } from 'vona-module-a-web';
+
+import type { Model<%=argv.resourceNameCapitalize%> } from '../model/<%=argv.resourceName%>.ts';
+
+import { Dto<%=argv.resourceNameCapitalize%>Create } from '../dto/<%=argv.resourceName%>Create.tsx';
+import { Dto<%=argv.resourceNameCapitalize%>SelectReq } from '../dto/<%=argv.resourceName%>SelectReq.tsx';
+import { Dto<%=argv.resourceNameCapitalize%>SelectRes } from '../dto/<%=argv.resourceName%>SelectRes.tsx';
+import { Dto<%=argv.resourceNameCapitalize%>Update } from '../dto/<%=argv.resourceName%>Update.tsx';
+import { Dto<%=argv.resourceNameCapitalize%>View } from '../dto/<%=argv.resourceName%>View.tsx';
+
+export interface IControllerOptions<%=argv.resourceNameCapitalize%> extends IDecoratorControllerOptions {}
+
+@Controller<IControllerOptions<%=argv.resourceNameCapitalize%>>('<%=argv.resourceName%>')
+@Resource()
+export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
+  @Web.post()
+  @Api.body(v.tableIdentity())
+  async create(@Arg.body() <%=argv.resourceName%>: Dto<%=argv.resourceNameCapitalize%>Create): Promise<TableIdentity> {
+    return (await this.scope.service.<%=argv.resourceName%>.create(<%=argv.resourceName%>)).id;
+  }
+
+  @Web.get()
+  @Api.body(Dto<%=argv.resourceNameCapitalize%>SelectRes)
+  async select(@Arg.filter(Dto<%=argv.resourceNameCapitalize%>SelectReq) params: IQueryParams<Model<%=argv.resourceNameCapitalize%>>): Promise<Dto<%=argv.resourceNameCapitalize%>SelectRes> {
+    return await this.scope.service.<%=argv.resourceName%>.select(params);
+  }
+
+  @Web.get(':id')
+  @Api.body(v.optional(), v.object(Dto<%=argv.resourceNameCapitalize%>View))
+  async view(@Arg.param('id', v.tableIdentity()) id: TableIdentity): Promise<Dto<%=argv.resourceNameCapitalize%>View | undefined> {
+    return await this.scope.service.<%=argv.resourceName%>.view(id);
+  }
+
+  @Web.patch(':id')
+  async update(@Arg.param('id', v.tableIdentity()) id: TableIdentity, @Arg.body() <%=argv.resourceName%>: Dto<%=argv.resourceNameCapitalize%>Update) {
+    return await this.scope.service.<%=argv.resourceName%>.update(id, <%=argv.resourceName%>);
+  }
+
+  @Web.delete(':id')
+  async delete(@Arg.param('id', v.tableIdentity()) id: TableIdentity) {
+    return await this.scope.service.<%=argv.resourceName%>.delete(id);
+  }
+}

package/cli/templates/tools/crudStart/boilerplate/src/dto/{{resourceName}}Create.tsx_

@@ -0,0 +1,28 @@
+import type { IDecoratorDtoOptions } from 'vona-module-a-web';
+
+import { $Dto } from 'vona-module-a-orm';
+import { Dto } from 'vona-module-a-web';
+import { ZovaRender } from 'zova-rest-cabloy-start-admin';
+
+import { Model<%=argv.resourceNameCapitalize%> } from '../model/<%=argv.resourceName%>.ts';
+
+export interface IDtoOptions<%=argv.resourceNameCapitalize%>Create extends IDecoratorDtoOptions {}
+
+@Dto<IDtoOptions<%=argv.resourceNameCapitalize%>Create>({
+  blocks: [
+    ZovaRender.block('start-pageentry:blockPageEntry', {
+      blocks: [
+        ZovaRender.block('start-pageentry:blockForm'),
+        ZovaRender.block('start-pageentry:blockToolbarRow', {
+          actions: [
+            ZovaRender.formActionRow('start-form:actionSubmit', {
+              permission: { action: 'update', formScene: ['create', 'edit'] },
+            }),
+            ZovaRender.formActionRow('start-form:actionBack', { permission: { public: true } }),
+          ],
+        }),
+      ],
+    }),
+  ],
+})
+export class Dto<%=argv.resourceNameCapitalize%>Create extends $Dto.create(() => Model<%=argv.resourceNameCapitalize%>) {}

package/cli/templates/tools/crudStart/boilerplate/src/dto/{{resourceName}}SelectReq.tsx_

@@ -0,0 +1,21 @@
+import type { IDecoratorDtoOptions } from 'vona-module-a-web';
+
+import { Api, v } from 'vona-module-a-openapiutils';
+import { $Dto } from 'vona-module-a-orm';
+import { Dto } from 'vona-module-a-web';
+import z from 'zod';
+
+import { Entity<%=argv.resourceNameCapitalize%> } from '../entity/<%=argv.resourceName%>.tsx';
+
+export interface IDtoOptions<%=argv.resourceNameCapitalize%>SelectReq extends IDecoratorDtoOptions {}
+
+@Dto<IDtoOptions<%=argv.resourceNameCapitalize%>SelectReq>({
+  openapi: { filter: { table: '<%=argv.moduleResourceName%>' } },
+  fields: {
+    createdAt: z.string().optional(),
+  },
+})
+export class Dto<%=argv.resourceNameCapitalize%>SelectReq extends $Dto.queryPage(Entity<%=argv.resourceNameCapitalize%>, ['name', 'createdAt']) {
+  @Api.field(v.optional())
+  name?: string;
+}

package/cli/templates/tools/crudStart/boilerplate/src/dto/{{resourceName}}SelectRes.tsx_

@@ -0,0 +1,11 @@
+import type { IDecoratorDtoOptions } from 'vona-module-a-web';
+
+import { $Dto } from 'vona-module-a-orm';
+import { Dto } from 'vona-module-a-web';
+
+import { Dto<%=argv.resourceNameCapitalize%>SelectResItem } from './<%=argv.resourceName%>SelectResItem.tsx';
+
+export interface IDtoOptions<%=argv.resourceNameCapitalize%>SelectRes extends IDecoratorDtoOptions {}
+
+@Dto<IDtoOptions<%=argv.resourceNameCapitalize%>SelectRes>()
+export class Dto<%=argv.resourceNameCapitalize%>SelectRes extends $Dto.listAndCount(Dto<%=argv.resourceNameCapitalize%>SelectResItem) {}

package/cli/templates/tools/crudStart/boilerplate/src/dto/{{resourceName}}SelectResItem.tsx_

@@ -0,0 +1,36 @@
+import type { IDecoratorDtoOptions } from 'vona-module-a-web';
+
+import { Api, v } from 'vona-module-a-openapiutils';
+import { $Dto } from 'vona-module-a-orm';
+import { Dto } from 'vona-module-a-web';
+import { ZovaRender } from 'zova-rest-cabloy-start-admin';
+
+import { $locale } from '../.metadata/locales.ts';
+import { Model<%=argv.resourceNameCapitalize%> } from '../model/<%=argv.resourceName%>.ts';
+
+export interface IDtoOptions<%=argv.resourceNameCapitalize%>SelectResItem extends IDecoratorDtoOptions {}
+
+@Dto<IDtoOptions<%=argv.resourceNameCapitalize%>SelectResItem>({
+  blocks: [
+    ZovaRender.block('start-page:blockPage', {
+      blocks: [
+        ZovaRender.block('start-page:blockFilter'),
+        ZovaRender.block('start-page:blockToolbarBulk', {
+          actions: [ZovaRender.tableActionBulk('start-table:actionCreate')],
+        }),
+        ZovaRender.block('start-page:blockTable'),
+        ZovaRender.block('start-page:blockPager'),
+      ],
+    }),
+  ],
+})
+export class Dto<%=argv.resourceNameCapitalize%>SelectResItem extends $Dto.get(() => Model<%=argv.resourceNameCapitalize%>) {
+  @Api.field(
+    v.title($locale('Operations')),
+    ZovaRender.order(1, 'max'),
+    ZovaRender.cell('start-table:actionOperationsRow', {
+      actions: [ZovaRender.tableActionRow('start-table:actionUpdate'), ZovaRender.tableActionRow('start-table:actionDelete')],
+    }),
+  )
+  _operationsRow?: unknown;
+}

package/cli/templates/tools/crudStart/boilerplate/src/dto/{{resourceName}}Update.tsx_

@@ -0,0 +1,28 @@
+import type { IDecoratorDtoOptions } from 'vona-module-a-web';
+
+import { $Dto } from 'vona-module-a-orm';
+import { Dto } from 'vona-module-a-web';
+import { ZovaRender } from 'zova-rest-cabloy-start-admin';
+
+import { Model<%=argv.resourceNameCapitalize%> } from '../model/<%=argv.resourceName%>.ts';
+
+export interface IDtoOptions<%=argv.resourceNameCapitalize%>Update extends IDecoratorDtoOptions {}
+
+@Dto<IDtoOptions<%=argv.resourceNameCapitalize%>Update>({
+  blocks: [
+    ZovaRender.block('start-pageentry:blockPageEntry', {
+      blocks: [
+        ZovaRender.block('start-pageentry:blockForm'),
+        ZovaRender.block('start-pageentry:blockToolbarRow', {
+          actions: [
+            ZovaRender.formActionRow('start-form:actionSubmit', {
+              permission: { action: 'update', formScene: ['create', 'edit'] },
+            }),
+            ZovaRender.formActionRow('start-form:actionBack', { permission: { public: true } }),
+          ],
+        }),
+      ],
+    }),
+  ],
+})
+export class Dto<%=argv.resourceNameCapitalize%>Update extends $Dto.update(() => Model<%=argv.resourceNameCapitalize%>) {}

package/cli/templates/tools/crudStart/boilerplate/src/dto/{{resourceName}}View.tsx_

@@ -0,0 +1,23 @@
+import type { IDecoratorDtoOptions } from 'vona-module-a-web';
+
+import { $Dto } from 'vona-module-a-orm';
+import { Dto } from 'vona-module-a-web';
+import { ZovaRender } from 'zova-rest-cabloy-start-admin';
+
+import { Model<%=argv.resourceNameCapitalize%> } from '../model/<%=argv.resourceName%>.ts';
+
+export interface IDtoOptions<%=argv.resourceNameCapitalize%>View extends IDecoratorDtoOptions {}
+
+@Dto<IDtoOptions<%=argv.resourceNameCapitalize%>View>({
+  blocks: [
+    ZovaRender.block('start-pageentry:blockPageEntry', {
+      blocks: [
+        ZovaRender.block('start-pageentry:blockForm'),
+        ZovaRender.block('start-pageentry:blockToolbarRow', {
+          actions: [ZovaRender.formActionRow('start-form:actionBack', { permission: { public: true } })],
+        }),
+      ],
+    }),
+  ],
+})
+export class Dto<%=argv.resourceNameCapitalize%>View extends $Dto.get(() => Model<%=argv.resourceNameCapitalize%>) {}

package/cli/templates/tools/crudStart/boilerplate/src/entity/{{resourceName}}.tsx_

@@ -0,0 +1,49 @@
+import type { IDecoratorEntityOptions } from 'vona-module-a-orm';
+
+import { $makeMetadata, Api, v } from 'vona-module-a-openapiutils';
+import { Entity, EntityBase } from 'vona-module-a-orm';
+import { ZovaRender } from 'zova-rest-cabloy-start-admin';
+
+import { $locale } from '../.metadata/locales.ts';
+
+export interface IEntityOptions<%=argv.resourceNameCapitalize%> extends IDecoratorEntityOptions {}
+
+@Entity<IEntityOptions<%=argv.resourceNameCapitalize%>>('<%=argv.moduleResourceName%>', {
+  openapi: { title: $locale('<%=argv.resourceNameCapitalize%>') },
+  fields: {
+    id: $makeMetadata(ZovaRender.order(1, 'core')),
+    iid: $makeMetadata(ZovaRender.visible(false)),
+    deleted: $makeMetadata(ZovaRender.visible(false)),
+    createdAt: $makeMetadata(
+      ZovaRender.order(-2, 'max'),
+      ZovaRender.field('start-date:formFieldDate'),
+      ZovaRender.cell('start-date:date'),
+      ZovaRender.field('start-date:formFieldDateRange', undefined, 'filter'),
+      v.filterTransform('a-web:dateRange'),
+    ),
+    updatedAt: $makeMetadata(
+      ZovaRender.order(-1, 'max'),
+      ZovaRender.field('start-date:formFieldDate'),
+      ZovaRender.cell('start-date:date'),
+      ZovaRender.field('start-date:formFieldDateRange', undefined, 'filter'),
+      v.filterTransform('a-web:dateRange'),
+    ),
+  },
+})
+export class Entity<%=argv.resourceNameCapitalize%> extends EntityBase {
+  @Api.field(
+    v.title($locale('Name')),
+    v.required(),
+    v.min(2),
+    ZovaRender.order(1),
+    ZovaRender.cell('start-table:actionView'),
+  )
+  name: string;
+
+  @Api.field(
+    v.title($locale('Description')),
+    v.optional(),
+    ZovaRender.order(2),
+  )
+  description?: string;
+}

package/cli/templates/tools/crudStart/boilerplate/src/model/{{resourceName}}.ts_

@@ -0,0 +1,8 @@
+import type { IDecoratorModelOptions } from 'vona-module-a-orm';
+import { BeanModelBase, Model } from 'vona-module-a-orm';
+import { Entity<%=argv.resourceNameCapitalize%> } from '../entity/<%=argv.resourceName%>.tsx';
+
+export interface IModelOptions<%=argv.resourceNameCapitalize%> extends IDecoratorModelOptions<Entity<%=argv.resourceNameCapitalize%>> {}
+
+@Model<IModelOptions<%=argv.resourceNameCapitalize%>>({ entity: Entity<%=argv.resourceNameCapitalize%> })
+export class Model<%=argv.resourceNameCapitalize%> extends BeanModelBase<Entity<%=argv.resourceNameCapitalize%>> {}

package/cli/templates/tools/crudStart/boilerplate/src/service/{{resourceName}}.ts_

@@ -0,0 +1,35 @@
+import type { TableIdentity } from 'table-identity';
+import type { IQueryParams } from 'vona-module-a-orm';
+
+import { BeanBase } from 'vona';
+import { Service } from 'vona-module-a-bean';
+
+import type { Dto<%=argv.resourceNameCapitalize%>Create } from '../dto/<%=argv.resourceName%>Create.tsx';
+import type { Dto<%=argv.resourceNameCapitalize%>SelectRes } from '../dto/<%=argv.resourceName%>SelectRes.tsx';
+import type { Dto<%=argv.resourceNameCapitalize%>Update } from '../dto/<%=argv.resourceName%>Update.tsx';
+import type { Dto<%=argv.resourceNameCapitalize%>View } from '../dto/<%=argv.resourceName%>View.tsx';
+import type { Entity<%=argv.resourceNameCapitalize%> } from '../entity/<%=argv.resourceName%>.tsx';
+import type { Model<%=argv.resourceNameCapitalize%> } from '../model/<%=argv.resourceName%>.ts';
+
+@Service()
+export class Service<%=argv.resourceNameCapitalize%> extends BeanBase {
+  async create(<%=argv.resourceName%>: Dto<%=argv.resourceNameCapitalize%>Create): Promise<Entity<%=argv.resourceNameCapitalize%>> {
+    return await this.scope.model.<%=argv.resourceName%>.insert(<%=argv.resourceName%>);
+  }
+
+  async select(params?: IQueryParams<Model<%=argv.resourceNameCapitalize%>>): Promise<Dto<%=argv.resourceNameCapitalize%>SelectRes> {
+    return await this.scope.model.<%=argv.resourceName%>.selectAndCount(params);
+  }
+
+  async view(id: TableIdentity): Promise<Dto<%=argv.resourceNameCapitalize%>View | undefined> {
+    return await this.scope.model.<%=argv.resourceName%>.getById(id);
+  }
+
+  async update(id: TableIdentity, <%=argv.resourceName%>: Dto<%=argv.resourceNameCapitalize%>Update) {
+    return await this.scope.model.<%=argv.resourceName%>.updateById(id, <%=argv.resourceName%>);
+  }
+
+  async delete(id: TableIdentity) {
+    return await this.scope.model.<%=argv.resourceName%>.deleteById(id);
+  }
+}

package/cli/templates/tools/crudStart/boilerplate/test/{{resourceName}}.test.ts_

@@ -0,0 +1,43 @@
+import type { Dto<%=argv.resourceNameCapitalize%>Create, Dto<%=argv.resourceNameCapitalize%>SelectRes, Dto<%=argv.resourceNameCapitalize%>Update, Entity<%=argv.resourceNameCapitalize%> } from 'vona-module-<%=argv.moduleInfo.relativeName%>';
+import assert from 'node:assert';
+import { describe, it } from 'node:test';
+import { app } from 'vona-mock';
+
+describe('<%=argv.resourceName%>.test.ts', () => {
+  it('action:<%=argv.resourceName%>', async () => {
+    await app.bean.executor.mockCtx(async () => {
+      // data
+      const data: Dto<%=argv.resourceNameCapitalize%>Create = {
+        name: '__Tom__',
+        description: 'This is a test',
+      };
+      const dataUpdate: Dto<%=argv.resourceNameCapitalize%>Update = {
+        name: '__TomNew__',
+        description: 'This is a test',
+      };
+      // login
+      await app.bean.passport.signinMock();
+      // create
+      const <%=argv.resourceName%>Id = await app.bean.executor.performAction('post', '<%=argv.moduleActionPathRaw%>', { body: data });
+      assert.equal(!!<%=argv.resourceName%>Id, true);
+      // findMany
+      const selectRes: Dto<%=argv.resourceNameCapitalize%>SelectRes = await app.bean.executor.performAction('get', '<%=argv.moduleActionPathRaw%>');
+      assert.equal(selectRes.list.findIndex(item => item.name === data.name) > -1, true);
+      // update
+      await app.bean.executor.performAction('patch', '<%=argv.moduleActionPathRaw%>/:id', {
+        params: { id: <%=argv.resourceName%>Id },
+        body: dataUpdate,
+      });
+      // findOne
+      let <%=argv.resourceName%>: Entity<%=argv.resourceNameCapitalize%> = await app.bean.executor.performAction('get', '<%=argv.moduleActionPathRaw%>/:id', { params: { id: <%=argv.resourceName%>Id } });
+      assert.equal(<%=argv.resourceName%>.name, dataUpdate.name);
+      // delete
+      await app.bean.executor.performAction('delete', '<%=argv.moduleActionPathRaw%>/:id', { params: { id: <%=argv.resourceName%>.id } });
+      // findOne
+      <%=argv.resourceName%> = await app.bean.executor.performAction('get', '<%=argv.moduleActionPathRaw%>/:id', { params: { id: <%=argv.resourceName%>.id } });
+      assert.equal(<%=argv.resourceName%>, undefined);
+      // logout
+      await app.bean.passport.signout();
+    });
+  });
+});

package/cli/templates/tools/crudStart/snippets/1-package.json.ts

@@ -0,0 +1,16 @@
+import { metadataCustomSnippet } from '@cabloy/cli';
+
+declare module '@cabloy/cli' {
+  interface ICommandArgv {
+    fileVersion: number;
+  }
+}
+
+export default metadataCustomSnippet({
+  file: 'package.json',
+  language: 'json',
+  async transform({ ast, argv }) {
+    argv.fileVersion = ast.vonaModule.fileVersion = 1 + (ast.vonaModule.fileVersion ?? 0);
+    return ast;
+  },
+});

package/cli/templates/tools/crudStart/snippets/2-meta.index.ts

@@ -0,0 +1,48 @@
+import { metadataCustomSnippet } from '@cabloy/cli';
+import { catchError } from '@cabloy/utils';
+import fs from 'node:fs';
+
+declare module '@cabloy/cli' {
+  interface ICommandArgv {
+    module: string;
+  }
+}
+
+const __snippet_import1 = "import { $tableColumns } from 'vona-module-a-ormutils';";
+const __snippet_update = "...$tableColumns('<%=argv.moduleResourceName%>', 'name'),";
+
+export default metadataCustomSnippet({
+  file: 'src/bean/meta.index.ts',
+  language: 'plain',
+  format: true,
+  init: async ({ cli, argv, targetFile }) => {
+    await catchError(() => {
+      return cli.helper.invokeCli(
+        [':create:bean', 'meta', 'index', `--module=${argv.module}`, '--nometadata', '--noformat'],
+        {
+          cwd: argv.projectPath,
+        },
+      );
+    });
+    return fs.readFileSync(targetFile).toString('utf8');
+  },
+  async transform({ cli, ast }) {
+    // import1
+    if (!ast.includes(__snippet_import1)) {
+      const code = await cli.template.renderContent({ content: __snippet_import1 });
+      ast = ast.replace(
+        "import { Meta } from 'vona-module-a-meta';",
+        `import { Meta } from 'vona-module-a-meta';\n${code}`,
+      );
+    }
+    // update
+    const code = await cli.template.renderContent({ content: __snippet_update });
+    if (ast.includes('indexes: {}')) {
+      ast = ast.replace('indexes: {', `indexes: {\n    ${code}\n  `);
+    } else {
+      ast = ast.replace('indexes: {', `indexes: {\n    ${code}`);
+    }
+    // ok
+    return ast;
+  },
+});

package/cli/templates/tools/crudStart/snippets/2-meta.version.ts

@@ -0,0 +1,55 @@
+import { metadataCustomSnippet } from '@cabloy/cli';
+import { catchError } from '@cabloy/utils';
+import fs from 'node:fs';
+
+declare module '@cabloy/cli' {
+  interface ICommandArgv {
+    module: string;
+  }
+}
+
+const __snippet_update = `if (options.version === <%=argv.fileVersion%>) {
+    const entity<%=argv.resourceNameCapitalize%> = this.scope.entity.<%=argv.resourceName%>;
+    await this.bean.model.createTable(entity<%=argv.resourceNameCapitalize%>.$table, table => {
+      table.comment(entity<%=argv.resourceNameCapitalize%>.$comment.$table);
+      table.basicFields();
+      table.string(entity<%=argv.resourceNameCapitalize%>.name, 50).comment(entity<%=argv.resourceNameCapitalize%>.$comment.name);
+      table.string(entity<%=argv.resourceNameCapitalize%>.description, 255).comment(entity<%=argv.resourceNameCapitalize%>.$comment.description);
+    });
+  }
+`;
+
+export default metadataCustomSnippet({
+  file: 'src/bean/meta.version.ts',
+  language: 'gogo',
+  format: true,
+  init: async ({ cli, argv, targetFile }) => {
+    await catchError(() => {
+      return cli.helper.invokeCli(
+        [
+          ':create:bean',
+          'meta',
+          'version',
+          `--module=${argv.module}`,
+          '--nometadata',
+          '--noformat',
+        ],
+        {
+          cwd: argv.projectPath,
+        },
+      );
+    });
+    return fs.readFileSync(targetFile).toString('utf8');
+  },
+  async transform({ cli, ast }) {
+    // update
+    ast.replace(
+      'async update(_options: IMetaVersionUpdateOptions) {$$$1}',
+      'async update(options: IMetaVersionUpdateOptions) {$$$1}',
+    );
+    const code = await cli.template.renderContent({ content: __snippet_update });
+    ast.replace('async update($$$0) {$$$1}', `async update($$$0) {\n  $$$1\n  ${code}}`);
+    // ok
+    return ast;
+  },
+});

package/cli/templates/tools/crudStart/snippets/3-en-us.ts

@@ -0,0 +1,30 @@
+import { metadataCustomSnippet } from '@cabloy/cli';
+import { catchError } from '@cabloy/utils';
+import fs from 'node:fs';
+
+import { locale_transform } from '../utils.ts';
+
+const __resources = { Name: 'Name', Description: 'Description', Operations: 'Operations' };
+
+declare module '@cabloy/cli' {
+  interface ICommandArgv {
+    module: string;
+    resourceNameCapitalize: string;
+  }
+}
+
+export default metadataCustomSnippet({
+  file: 'src/config/locale/en-us.ts',
+  language: 'plain',
+  init: async ({ cli, argv, targetFile }) => {
+    await catchError(() => {
+      return cli.helper.invokeCli([':init:locale', argv.module, '--nometadata', '--noformat'], {
+        cwd: argv.projectPath,
+      });
+    });
+    return fs.readFileSync(targetFile).toString('utf8');
+  },
+  async transform({ ast, argv }) {
+    return locale_transform({ ast, argv, resources: __resources });
+  },
+});

package/cli/templates/tools/crudStart/snippets/4-zh-cn.ts

@@ -0,0 +1,13 @@
+import { metadataCustomSnippet } from '@cabloy/cli';
+
+import { locale_transform } from '../utils.ts';
+
+const __resources = { Name: '名称', Description: '描述', Operations: '操作' };
+
+export default metadataCustomSnippet({
+  file: 'src/config/locale/zh-cn.ts',
+  language: 'plain',
+  async transform({ ast, argv }) {
+    return locale_transform({ ast, argv, resources: __resources });
+  },
+});

package/cli/templates/tools/crudStart/utils.ts

@@ -0,0 +1,27 @@
+import { evaluateSimple } from '@cabloy/utils';
+
+export async function locale_transform({
+  ast,
+  argv,
+  resources,
+}: {
+  ast: string;
+  argv: any;
+  resources: any;
+}) {
+  const values = evaluateSimple(ast.replace('export default', '').replace(';', ''));
+  resources = Object.assign(
+    {},
+    resources,
+    { [argv.resourceNameCapitalize]: argv.resourceNameCapitalize },
+    values,
+  );
+  const keys = Object.keys(resources).sort();
+  let content = '';
+  for (const key of keys) {
+    content += `  ${key}: '${resources[key].replaceAll("'", "\\'")}',\n`;
+  }
+  ast = `export default {\n${content}};\n`;
+  // ok
+  return ast;
+}

package/dist/index.js

@@ -1972,9 +1972,10 @@ class CliToolsCrud extends BeanCliBase {
     // noformat
     // argv.noformat = true;
     // ssrSiteModuleName
-    argv.ssrSiteModuleName = fs.existsSync(path.join(argv.projectPath, 'src/suite/cabloy-start')) ? 'vona-module-start-siteadmin' : 'vona-module-basic-siteadmin';
-    argv.ssrSiteOnionName = fs.existsSync(path.join(argv.projectPath, 'src/suite/cabloy-start')) ? 'start-siteadmin:admin' : 'basic-siteadmin:admin';
-    argv.ssrSiteGroupName = fs.existsSync(path.join(argv.projectPath, 'src/suite/cabloy-start')) ? 'start-siteadmin:management' : 'basic-siteadmin:management';
+    const isCabloyStart = fs.existsSync(path.join(argv.projectPath, '__CABLOY_START__'));
+    argv.ssrSiteModuleName = isCabloyStart ? 'vona-module-start-siteadmin' : 'vona-module-basic-siteadmin';
+    argv.ssrSiteOnionName = isCabloyStart ? 'start-siteadmin:admin' : 'basic-siteadmin:admin';
+    argv.ssrSiteGroupName = isCabloyStart ? 'start-siteadmin:management' : 'basic-siteadmin:management';
     // module name/info
     const moduleName = argv.module;
     argv.moduleInfo = this.helper.parseModuleInfo(moduleName);
@@ -1994,7 +1995,8 @@ class CliToolsCrud extends BeanCliBase {
       throw new Error(`resource exists: ${resourceName}`);
     }
     // tools:crud
-    await this.helper.invokeCli([':tools:crudBasic', resourceName, `--module=${argv.module}`, '--nometadata'], {
+    const commandName = isCabloyStart ? ':tools:crudStart' : ':tools:crudBasic';
+    await this.helper.invokeCli([commandName, resourceName, `--module=${argv.module}`, '--nometadata'], {
       cwd: argv.projectPath
     });
     // render
@@ -2059,6 +2061,52 @@ class CliToolsCrudBasic extends BeanCliBase {
   }
 }
 
+class CliToolsCrudStart extends BeanCliBase {
+  async execute() {
+    const {
+      argv
+    } = this.context;
+    // super
+    await super.execute();
+    // noformat
+    // argv.noformat = true;
+    // 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}`);
+    }
+    // target dir
+    const targetDir = await this.helper.ensureDir(_module.root);
+    // resourceName
+    const resourceName = argv.resourceName;
+    argv.resourceNameCapitalize = this.helper.firstCharToUpperCase(resourceName);
+    // moduleResourceName
+    argv.moduleResourceName = this.helper.combineModuleNameAndResource(argv.moduleInfo.relativeName, argv.resourceName);
+    argv.moduleActionPathRaw = combineApiPathControllerAndActionRaw(moduleName, resourceName, '', true);
+    // controller
+    const controllerFile = path.join(targetDir, 'src/controller', `${resourceName}.ts`);
+    if (fs.existsSync(controllerFile)) {
+      throw new Error(`resource exists: ${resourceName}`);
+    }
+    // render
+    await this.template.renderBoilerplateAndSnippets({
+      targetDir,
+      setName: __ThisSetName__,
+      snippetsPath: 'tools/crudStart/snippets',
+      boilerplatePath: 'tools/crudStart/boilerplate'
+    });
+    // tools.metadata
+    if (!argv.nometadata) {
+      await this.helper.invokeCli([':tools:metadata', moduleName], {
+        cwd: argv.projectPath
+      });
+    }
+  }
+}
+
 class CliToolsDeps extends BeanCliBase {
   async execute() {
     const {
@@ -2868,6 +2916,7 @@ const beans = {
   'tools.deps': CliToolsDeps,
   'tools.metadata': CliToolsMetadata,
   'tools.crudBasic': CliToolsCrudBasic,
+  'tools.crudStart': CliToolsCrudStart,
   'tools.crud': CliToolsCrud
 };
 
@@ -3445,6 +3494,40 @@ var toolsCrudBasic = {
   }
 };
 
+var toolsCrudStart = {
+  bean: 'tools.crudStart',
+  info: {
+    version: '5.0.0',
+    title: 'Cli: Tools: Crud Start',
+    usage: 'vona :tools:crudStart resourceName [--module=]'
+  },
+  options: {
+    module: {
+      description: 'module name',
+      type: 'string'
+    }
+  },
+  groups: {
+    default: {
+      questions: {
+        resourceName: {
+          type: 'input',
+          message: 'resourceName',
+          initial: {
+            expression: 'arg0'
+          },
+          required: true
+        },
+        module: {
+          type: 'input',
+          message: 'module name',
+          required: true
+        }
+      }
+    }
+  }
+};
+
 var toolsDeps = {
   bean: 'tools.deps',
   info: {
@@ -3509,6 +3592,7 @@ const commands = {
     deps: toolsDeps,
     metadata: toolsMetadata,
     crudBasic: toolsCrudBasic,
+    crudStart: toolsCrudStart,
     crud: toolsCrud
   }
 };

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

@@ -0,0 +1,15 @@
+import type { IModuleInfo } from '@cabloy/module-info';
+import { BeanCliBase } from '@cabloy/cli';
+declare module '@cabloy/cli' {
+    interface ICommandArgv {
+        module: string;
+        moduleInfo: IModuleInfo;
+        resourceName: string;
+        resourceNameCapitalize: string;
+        moduleResourceName: string;
+        moduleActionPathRaw: string;
+    }
+}
+export declare class CliToolsCrudStart extends BeanCliBase {
+    execute(): Promise<void>;
+}

package/dist/lib/beans.d.ts

@@ -25,6 +25,7 @@ import { CliInitStatic } from './bean/cli.init.static.ts';
 import { CliInitTypes } from './bean/cli.init.types.ts';
 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 { CliToolsMetadata } from './bean/cli.tools.metadata.ts';
 export declare const beans: {
@@ -56,5 +57,6 @@ export declare const beans: {
     'tools.deps': typeof CliToolsDeps;
     'tools.metadata': typeof CliToolsMetadata;
     'tools.crudBasic': typeof CliToolsCrudBasic;
+    'tools.crudStart': typeof CliToolsCrudStart;
     'tools.crud': typeof CliToolsCrud;
 };

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

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

package/dist/lib/commands.d.ts

@@ -523,6 +523,39 @@ export declare const commands: {
                 };
             };
         };
+        crudStart: {
+            bean: string;
+            info: {
+                version: string;
+                title: string;
+                usage: string;
+            };
+            options: {
+                module: {
+                    description: string;
+                    type: string;
+                };
+            };
+            groups: {
+                default: {
+                    questions: {
+                        resourceName: {
+                            type: string;
+                            message: string;
+                            initial: {
+                                expression: string;
+                            };
+                            required: boolean;
+                        };
+                        module: {
+                            type: string;
+                            message: string;
+                            required: boolean;
+                        };
+                    };
+                };
+            };
+        };
         crud: {
             bean: string;
             info: {

package/dist-cli/templates/tools/crudStart/snippets/1-package.json.js

@@ -0,0 +1,9 @@
+import { metadataCustomSnippet } from '@cabloy/cli';
+export default metadataCustomSnippet({
+    file: 'package.json',
+    language: 'json',
+    async transform({ ast, argv }) {
+        argv.fileVersion = ast.vonaModule.fileVersion = 1 + (ast.vonaModule.fileVersion ?? 0);
+        return ast;
+    },
+});

package/dist-cli/templates/tools/crudStart/snippets/2-meta.index.js

@@ -0,0 +1,35 @@
+import { metadataCustomSnippet } from '@cabloy/cli';
+import { catchError } from '@cabloy/utils';
+import fs from 'node:fs';
+const __snippet_import1 = "import { $tableColumns } from 'vona-module-a-ormutils';";
+const __snippet_update = "...$tableColumns('<%=argv.moduleResourceName%>', 'name'),";
+export default metadataCustomSnippet({
+    file: 'src/bean/meta.index.ts',
+    language: 'plain',
+    format: true,
+    init: async ({ cli, argv, targetFile }) => {
+        await catchError(() => {
+            return cli.helper.invokeCli([':create:bean', 'meta', 'index', `--module=${argv.module}`, '--nometadata', '--noformat'], {
+                cwd: argv.projectPath,
+            });
+        });
+        return fs.readFileSync(targetFile).toString('utf8');
+    },
+    async transform({ cli, ast }) {
+        // import1
+        if (!ast.includes(__snippet_import1)) {
+            const code = await cli.template.renderContent({ content: __snippet_import1 });
+            ast = ast.replace("import { Meta } from 'vona-module-a-meta';", `import { Meta } from 'vona-module-a-meta';\n${code}`);
+        }
+        // update
+        const code = await cli.template.renderContent({ content: __snippet_update });
+        if (ast.includes('indexes: {}')) {
+            ast = ast.replace('indexes: {', `indexes: {\n    ${code}\n  `);
+        }
+        else {
+            ast = ast.replace('indexes: {', `indexes: {\n    ${code}`);
+        }
+        // ok
+        return ast;
+    },
+});

package/dist-cli/templates/tools/crudStart/snippets/2-meta.version.js

@@ -0,0 +1,41 @@
+import { metadataCustomSnippet } from '@cabloy/cli';
+import { catchError } from '@cabloy/utils';
+import fs from 'node:fs';
+const __snippet_update = `if (options.version === <%=argv.fileVersion%>) {
+    const entity<%=argv.resourceNameCapitalize%> = this.scope.entity.<%=argv.resourceName%>;
+    await this.bean.model.createTable(entity<%=argv.resourceNameCapitalize%>.$table, table => {
+      table.comment(entity<%=argv.resourceNameCapitalize%>.$comment.$table);
+      table.basicFields();
+      table.string(entity<%=argv.resourceNameCapitalize%>.name, 50).comment(entity<%=argv.resourceNameCapitalize%>.$comment.name);
+      table.string(entity<%=argv.resourceNameCapitalize%>.description, 255).comment(entity<%=argv.resourceNameCapitalize%>.$comment.description);
+    });
+  }
+`;
+export default metadataCustomSnippet({
+    file: 'src/bean/meta.version.ts',
+    language: 'gogo',
+    format: true,
+    init: async ({ cli, argv, targetFile }) => {
+        await catchError(() => {
+            return cli.helper.invokeCli([
+                ':create:bean',
+                'meta',
+                'version',
+                `--module=${argv.module}`,
+                '--nometadata',
+                '--noformat',
+            ], {
+                cwd: argv.projectPath,
+            });
+        });
+        return fs.readFileSync(targetFile).toString('utf8');
+    },
+    async transform({ cli, ast }) {
+        // update
+        ast.replace('async update(_options: IMetaVersionUpdateOptions) {$$$1}', 'async update(options: IMetaVersionUpdateOptions) {$$$1}');
+        const code = await cli.template.renderContent({ content: __snippet_update });
+        ast.replace('async update($$$0) {$$$1}', `async update($$$0) {\n  $$$1\n  ${code}}`);
+        // ok
+        return ast;
+    },
+});

package/dist-cli/templates/tools/crudStart/snippets/3-en-us.js

@@ -0,0 +1,20 @@
+import { metadataCustomSnippet } from '@cabloy/cli';
+import { catchError } from '@cabloy/utils';
+import fs from 'node:fs';
+import { locale_transform } from "../utils.js";
+const __resources = { Name: 'Name', Description: 'Description', Operations: 'Operations' };
+export default metadataCustomSnippet({
+    file: 'src/config/locale/en-us.ts',
+    language: 'plain',
+    init: async ({ cli, argv, targetFile }) => {
+        await catchError(() => {
+            return cli.helper.invokeCli([':init:locale', argv.module, '--nometadata', '--noformat'], {
+                cwd: argv.projectPath,
+            });
+        });
+        return fs.readFileSync(targetFile).toString('utf8');
+    },
+    async transform({ ast, argv }) {
+        return locale_transform({ ast, argv, resources: __resources });
+    },
+});

package/dist-cli/templates/tools/crudStart/snippets/4-zh-cn.js

@@ -0,0 +1,10 @@
+import { metadataCustomSnippet } from '@cabloy/cli';
+import { locale_transform } from "../utils.js";
+const __resources = { Name: '名称', Description: '描述', Operations: '操作' };
+export default metadataCustomSnippet({
+    file: 'src/config/locale/zh-cn.ts',
+    language: 'plain',
+    async transform({ ast, argv }) {
+        return locale_transform({ ast, argv, resources: __resources });
+    },
+});

package/dist-cli/templates/tools/crudStart/utils.js

@@ -0,0 +1,13 @@
+import { evaluateSimple } from '@cabloy/utils';
+export async function locale_transform({ ast, argv, resources, }) {
+    const values = evaluateSimple(ast.replace('export default', '').replace(';', ''));
+    resources = Object.assign({}, resources, { [argv.resourceNameCapitalize]: argv.resourceNameCapitalize }, values);
+    const keys = Object.keys(resources).sort();
+    let content = '';
+    for (const key of keys) {
+        content += `  ${key}: '${resources[key].replaceAll("'", "\\'")}',\n`;
+    }
+    ast = `export default {\n${content}};\n`;
+    // ok
+    return ast;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-cli-set-api",
-  "version": "1.1.61",
+  "version": "1.1.62",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "vona cli-set-api",
   "keywords": [
@@ -63,12 +63,12 @@
     "why-is-node-running": "^3.2.2",
     "yargs-parser": "^22.0.0",
     "@cabloy/cli": "^3.1.10",
-    "@cabloy/dotenv": "^1.2.5",
     "@cabloy/extend": "^3.2.5",
     "@cabloy/module-glob": "^5.3.8",
+    "@cabloy/dotenv": "^1.2.5",
     "babel-plugin-vona-bean-module": "^1.1.6",
-    "vona-core": "^5.1.13",
-    "@cabloy/utils": "^2.1.17"
+    "@cabloy/utils": "^2.1.17",
+    "vona-core": "^5.1.13"
   },
   "scripts": {
     "clean": "rimraf dist dist-cli dist-toolsIsolate tsconfig.build.tsbuildinfo tsconfig.cli.tsbuildinfo tsconfig.isolate.tsbuildinfo",