cabloy 5.1.108 → 5.1.109

package/.cabloy-version

@@ -1 +1 @@
-5.1.108
+5.1.109

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 5.1.109
+
+### Features
+
+- Add DTO-driven form layouts.
+- Add configurable filter form layouts.
+- Add a student view form layout.
+- Display form error counts on layout tabs.
+- Allow form layout IDs to be optional.
+
+### Improvements
+
+- Upgrade TanStack Vue Form.
+- Replace the deprecated TanStack Form store hook.
+- Localize form layout tab state.
+- Clarify DTO render field typing boundaries in the documentation.
+
 ## 5.1.108
 
 ### Features

package/cabloy-docs/frontend/table-resource-crud-cookbook.md

@@ -162,8 +162,8 @@ This block uses `ZForm` with:
 
 - `schema={$$page.schemaFilter}`
 - `schemaScene="filter"`
-- inline layout
 - page-owned filter data
+- field-level `formFieldLayout.inline: true` by default
 
 Its job is not to duplicate the list query logic.
 
@@ -178,6 +178,38 @@ A practical rule is:
 - if you need to refine which filter fields exist, start from backend filter-side metadata and schema
 - if you need to refine how filter submission affects the list, inspect `blockFilter` and `blockPage.onFilter(...)`
 
+### Use blocks for a structural filter layout
+
+A bare `basic-page:blockFilter` keeps the default schema field rendering and adds Search/Reset controls automatically. For a structured filter, compose the existing form layout block with the filter-specific action block:
+
+```tsx
+ZovaRender.block('basic-page:blockFilter', {
+  formFieldLayout: { inline: false },
+  blocks: [
+    ZovaRender.block('basic-form:blockFormLayout', {
+      formLayout: {
+        children: [
+          {
+            type: 'section',
+            columns: { default: 1, md: 2 },
+            children: [
+              { type: 'field', name: 'name' },
+              { type: 'field', name: 'level' },
+              { type: 'field', name: 'createdAt', span: { default: 1, md: 2 } },
+            ],
+          },
+        ],
+      },
+    }),
+    ZovaRender.block('basic-page:blockFilterActions'),
+  ],
+});
+```
+
+`basic-form:blockFormLayout` only places schema fields. `basic-page:blockFilterActions` owns Search/Reset placement and invokes the filter command surface supplied through the form scope, so it preserves filter normalization and page-query behavior. A nonempty `blocks` list replaces the automatic body and footer; include the action block explicitly to make the filter operable.
+
+`ZForm.inline` is no longer a form API. Use `formFieldLayout.inline` for field-level compact layout, or use blocks plus `basic-form:blockFormLayout` for structural layout.
+
 ## Step 5: Let `blockToolbarBulk` own bulk-action display
 
 The standard bulk toolbar block is:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cabloy",
-  "version": "5.1.108",
+  "version": "5.1.109",
   "gitHead": "2c5c19284bab738e492856189acb6fad74b8a7b7",
   "description": "A Node.js fullstack framework",
   "keywords": [

package/vona/pnpm-lock.yaml

@@ -501,8 +501,8 @@ importers:
         specifier: npm:@cabloy/zod@4.3.8
         version: '@cabloy/zod@4.3.8'
       zova:
-        specifier: ^5.1.135
-        version: 5.1.135(typescript@5.9.3)(vue@3.5.39(typescript@5.9.3))
+        specifier: ^5.1.136
+        version: 5.1.136(typescript@5.9.3)(vue@3.5.39(typescript@5.9.3))
       zova-jsx:
         specifier: ^1.1.78
         version: 1.1.78(typescript@5.9.3)
@@ -573,8 +573,8 @@ importers:
         specifier: npm:@cabloy/zod@4.3.8
         version: '@cabloy/zod@4.3.8'
       zova:
-        specifier: ^5.1.135
-        version: 5.1.135(typescript@5.9.3)(vue@3.5.39(typescript@5.9.3))
+        specifier: ^5.1.136
+        version: 5.1.136(typescript@5.9.3)(vue@3.5.39(typescript@5.9.3))
       zova-jsx:
         specifier: ^1.1.78
         version: 1.1.78(typescript@5.9.3)
@@ -1625,7 +1625,7 @@ importers:
   src/suite-vendor/a-test:
     dependencies:
       vona-module-test-file:
-        specifier: ^5.0.5
+        specifier: ^5.0.6
         version: link:modules/test-file
 
   src/suite-vendor/a-test/modules/test-auth:
@@ -8014,8 +8014,8 @@ packages:
   zova-module-a-ssrhmr@5.1.22:
     resolution: {integrity: sha512-K9D0DqCPuABvESyuAY8tQ7RukMpMEaMol0SV08ixVyed7Zd/b+Ugh49WEC2b5Y5iZCJliW9JJekvzS9Y0DilTA==}
 
-  zova-module-a-ssrserver@5.1.22:
-    resolution: {integrity: sha512-hQcsT94Aa9cn7TEkQM+Do2MNLnpGt4rGaRqxsnUB8Gr1T3knhWWdyYNrroq2kNI10hN81uOKrm/FxnFQRq1phQ==}
+  zova-module-a-ssrserver@5.1.23:
+    resolution: {integrity: sha512-+hpTTRfJP9mVCOueXYlAtt4W82ihQbQDRjJ7TjGVN/pIV3oL9Ca3I491wkd6I3Avq9dT7rjB/iKWs29F6ic3lA==}
 
   zova-module-a-style@5.1.32:
     resolution: {integrity: sha512-2D7XKTWdqY0/Z7jPJQ31Fikl2wNxifF5R/RexfemeJtrJBYap46mpA++BhxgawfOgMDQ8mpT5iQfS5Ep9TILlw==}
@@ -8032,11 +8032,11 @@ packages:
   zova-module-rest-resource@5.1.41:
     resolution: {integrity: sha512-7Y8rLmHdw0pynlWqsyHPWuCWFLwr/0HsNvfef64cPw91LRujf/7OlulVWqH8ZoFNioZZUpfumB+t/+mICoYfFg==}
 
-  zova-suite-a-zova@5.1.134:
-    resolution: {integrity: sha512-XwmEGAM6po9GjzGLryGVCKhkVjtI3MXNY85AhQVxxMUOU6S+3dBtF399LzzDdhlKYXbvfwuHB/yDQiS1PbfS5w==}
+  zova-suite-a-zova@5.1.135:
+    resolution: {integrity: sha512-Fa3U2NegdnFR+NkHeY4V5ejicUK0Th5dKs9Anx20jfpao/p91mCuu3kni88rB9j4U3ztUyqZ/q6k683Y1vATcg==}
 
-  zova@5.1.135:
-    resolution: {integrity: sha512-Avk0YcjocSYpdRUO4A58/yQmeGUoo+bgzbtKZNLCNDit7PSEGMBJZi9p47ct7SNc6LDybhBm7xPf/xioL0Ozdg==}
+  zova@5.1.136:
+    resolution: {integrity: sha512-Xf9ze/weAFo/kHTXjeJgB21RH1kjQC28F3pSBuKtGtzu87oxkdiG2meGKDWyP/n3cCvPs+BzOgRUSgQlsXZnXw==}
 
   zwitch@1.0.5:
     resolution: {integrity: sha512-V50KMwwzqJV0NpZIZFwfOD5/lyny3WlSzRiXgA0G7VUnRlqttta1L6UQIHzd6EuBY/cHGfwTIck7w1yH6Q5zUw==}
@@ -13969,7 +13969,7 @@ snapshots:
       '@cabloy/socket': link:packages-utils/socket
       debounce: 3.0.0
 
-  zova-module-a-ssrserver@5.1.22:
+  zova-module-a-ssrserver@5.1.23:
     dependencies:
       ms: 2.1.3
 
@@ -14010,7 +14010,7 @@ snapshots:
 
   zova-module-rest-resource@5.1.41: {}
 
-  zova-suite-a-zova@5.1.134(typescript@5.9.3)(vue@3.5.39(typescript@5.9.3)):
+  zova-suite-a-zova@5.1.135(typescript@5.9.3)(vue@3.5.39(typescript@5.9.3)):
     dependencies:
       zova-module-a-api: 5.1.21
       zova-module-a-app: 5.1.24
@@ -14032,7 +14032,7 @@ snapshots:
       zova-module-a-routertabs: 5.1.33
       zova-module-a-ssr: 5.1.29
       zova-module-a-ssrhmr: 5.1.22
-      zova-module-a-ssrserver: 5.1.22
+      zova-module-a-ssrserver: 5.1.23
       zova-module-a-style: 5.1.32
       zova-module-a-table: 5.1.37(vue@3.5.39(typescript@5.9.3))
       zova-module-a-zod: 5.1.36
@@ -14044,10 +14044,10 @@ snapshots:
       - typescript
       - vue
 
-  zova@5.1.135(typescript@5.9.3)(vue@3.5.39(typescript@5.9.3)):
+  zova@5.1.136(typescript@5.9.3)(vue@3.5.39(typescript@5.9.3)):
     dependencies:
       zova-core: 5.1.78(patch_hash=ff659aa5f659be32501f56841b72f148c24acf1546f79cce551586e27fcde2ce)(typescript@5.9.3)
-      zova-suite-a-zova: 5.1.134(typescript@5.9.3)(vue@3.5.39(typescript@5.9.3))
+      zova-suite-a-zova: 5.1.135(typescript@5.9.3)(vue@3.5.39(typescript@5.9.3))
     transitivePeerDependencies:
       - '@vue/composition-api'
       - debug

package/vona/src/suite/a-training/modules/training-student/src/config/locale/en-us.ts

@@ -1,6 +1,8 @@
 export default {
   Description: 'Description',
   Level: 'Training Stage',
+  BasicInformation: 'Basic Information',
+  StudentProfile: 'Student Profile',
   LevelAdvanced: 'Advanced Workshop',
   LevelBeginner: 'Foundation Track',
   LevelIntermediate: 'Progress Track',

package/vona/src/suite/a-training/modules/training-student/src/config/locale/zh-cn.ts

@@ -1,6 +1,8 @@
 export default {
   Description: '描述',
   Level: '培训阶段',
+  BasicInformation: '基本信息',
+  StudentProfile: '学生资料',
   LevelAdvanced: '高级研修班',
   LevelBeginner: '基础班',
   LevelIntermediate: '提升班',

package/vona/src/suite/a-training/modules/training-student/src/dto/studentCreate.tsx

@@ -16,7 +16,56 @@ export interface IDtoOptionsStudentCreate extends IDecoratorDtoOptions {}
   blocks: [
     ZovaRender.block('basic-pageentry:blockPageEntry', {
       blocks: [
-        ZovaRender.block('basic-pageentry:blockForm'),
+        ZovaRender.block('basic-pageentry:blockForm', {
+          blocks: [
+            ZovaRender.block('basic-form:blockFormLayout', {
+              formLayout: {
+                children: [
+                  {
+                    type: 'tabs',
+                    children: [
+                      {
+                        type: 'tab',
+                        title: $locale('BasicInformation'),
+                        children: [
+                          {
+                            type: 'group',
+                            title: $locale('StudentProfile'),
+                            children: [
+                              {
+                                type: 'section',
+                                columns: { default: 1, md: 2 },
+                                children: [
+                                  { type: 'field', name: 'name' },
+                                  { type: 'field', name: 'mobile' },
+                                  { type: 'field', name: 'imageId' },
+                                ],
+                              },
+                            ],
+                          },
+                        ],
+                      },
+                      {
+                        type: 'tab',
+                        title: $locale('TrainingRecords'),
+                        children: [
+                          { type: 'field', name: 'level' },
+                          {
+                            type: 'section',
+                            children: [{ type: 'field', name: 'trainingRecords' }],
+                          },
+                        ],
+                      },
+                    ],
+                  },
+                ],
+              },
+            }),
+          ],
+          // blocks: [
+          //   ZovaRender.block('')
+          // ],
+        }),
         ZovaRender.block('basic-pageentry:blockToolbarRow', {
           actions: [
             ZovaRender.formActionRow('basic-form:actionSubmit', {

package/vona/src/suite/a-training/modules/training-student/src/dto/studentSelectResItem.tsx

@@ -15,7 +15,27 @@ export interface IDtoOptionsStudentSelectResItem extends IDecoratorDtoOptions {}
   blocks: [
     ZovaRender.block('basic-page:blockPage', {
       blocks: [
-        ZovaRender.block('basic-page:blockFilter'),
+        ZovaRender.block('basic-page:blockFilter', {
+          formFieldLayout: { inline: false },
+          blocks: [
+            ZovaRender.block('basic-form:blockFormLayout', {
+              formLayout: {
+                children: [
+                  {
+                    type: 'section',
+                    columns: { default: 1, md: 2 },
+                    children: [
+                      { type: 'field', name: 'name' },
+                      { type: 'field', name: 'level' },
+                      { type: 'field', name: 'createdAt', span: { default: 1, md: 2 } },
+                    ],
+                  },
+                ],
+              },
+            }),
+            ZovaRender.block('basic-page:blockFilterActions'),
+          ],
+        }),
         ZovaRender.block('basic-page:blockToolbarBulk', {
           actions: [ZovaRender.tableActionBulk('basic-table:actionCreate')],
         }),

package/vona/src/suite/a-training/modules/training-student/src/dto/studentUpdate.tsx

@@ -16,7 +16,53 @@ export interface IDtoOptionsStudentUpdate extends IDecoratorDtoOptions {}
   blocks: [
     ZovaRender.block('basic-pageentry:blockPageEntry', {
       blocks: [
-        ZovaRender.block('basic-pageentry:blockForm'),
+        ZovaRender.block('basic-pageentry:blockForm', {
+          blocks: [
+            ZovaRender.block('basic-form:blockFormLayout', {
+              formLayout: {
+                children: [
+                  {
+                    type: 'tabs',
+                    children: [
+                      {
+                        type: 'tab',
+                        title: $locale('BasicInformation'),
+                        children: [
+                          {
+                            type: 'group',
+                            title: $locale('StudentProfile'),
+                            children: [
+                              {
+                                type: 'section',
+                                columns: { default: 1, md: 2 },
+                                children: [
+                                  { type: 'field', name: 'name' },
+                                  { type: 'field', name: 'mobile' },
+                                  { type: 'field', name: 'imageId' },
+                                ],
+                              },
+                            ],
+                          },
+                        ],
+                      },
+                      {
+                        type: 'tab',
+                        title: $locale('TrainingRecords'),
+                        children: [
+                          { type: 'field', name: 'level' },
+                          {
+                            type: 'section',
+                            children: [{ type: 'field', name: 'trainingRecords' }],
+                          },
+                        ],
+                      },
+                    ],
+                  },
+                ],
+              },
+            }),
+          ],
+        }),
         ZovaRender.block('basic-pageentry:blockToolbarRow', {
           actions: [
             ZovaRender.formActionRow('basic-form:actionSubmit', {

package/vona/src/suite/a-training/modules/training-student/src/dto/studentView.tsx

@@ -17,7 +17,53 @@ export interface IDtoOptionsStudentView extends IDecoratorDtoOptions {}
   blocks: [
     ZovaRender.block('basic-pageentry:blockPageEntry', {
       blocks: [
-        ZovaRender.block('basic-pageentry:blockForm'),
+        ZovaRender.block('basic-pageentry:blockForm', {
+          blocks: [
+            ZovaRender.block('basic-form:blockFormLayout', {
+              formLayout: {
+                children: [
+                  {
+                    type: 'tabs',
+                    children: [
+                      {
+                        type: 'tab',
+                        title: $locale('BasicInformation'),
+                        children: [
+                          {
+                            type: 'group',
+                            title: $locale('StudentProfile'),
+                            children: [
+                              {
+                                type: 'section',
+                                columns: { default: 1, md: 2 },
+                                children: [
+                                  { type: 'field', name: 'name' },
+                                  { type: 'field', name: 'mobile' },
+                                  { type: 'field', name: 'imageId' },
+                                ],
+                              },
+                            ],
+                          },
+                        ],
+                      },
+                      {
+                        type: 'tab',
+                        title: $locale('TrainingRecords'),
+                        children: [
+                          { type: 'field', name: 'level' },
+                          {
+                            type: 'section',
+                            children: [{ type: 'field', name: 'trainingRecords' }],
+                          },
+                        ],
+                      },
+                    ],
+                  },
+                ],
+              },
+            }),
+          ],
+        }),
         ZovaRender.block('basic-pageentry:blockToolbarRow', {
           actions: [
             ZovaRender.formActionRow('basic-form:actionBack', { permission: { public: true } }),

package/vona/src/suite/a-training/modules/training-student/test/student.test.ts

@@ -1,16 +1,74 @@
 import type {
-  DtoStudentCreate,
   DtoStudentSelectRes,
   DtoStudentSummary,
-  DtoStudentUpdate,
   EntityStudent,
 } from 'vona-module-training-student';
 
 import assert from 'node:assert';
 import { describe, it } from 'node:test';
 import { app } from 'vona-mock';
+import {
+  DtoStudentCreate,
+  DtoStudentSelectResItem,
+  DtoStudentUpdate,
+  DtoStudentView,
+} from 'vona-module-training-student';
 
 describe('student.test.ts', () => {
+  it('action:student:formLayoutMetadata', async () => {
+    await app.bean.executor.mockCtx(async () => {
+      for (const DtoClass of [DtoStudentCreate, DtoStudentUpdate, DtoStudentView]) {
+        const apiJson = await app.bean.openapi.generateJsonOfClass(DtoClass);
+        const component = Object.values(apiJson.components!.schemas as any).find(item => {
+          return (item as any).properties?.trainingRecords;
+        });
+        const blocks = (component as any)?.rest?.blocks;
+        const formLayout =
+          blocks?.[0]?.options?.blocks?.[0]?.options?.blocks?.[0]?.options?.formLayout;
+        const tabs = formLayout?.children[0];
+        const profileSection = tabs?.children[0]?.children[0]?.children[0];
+        const trainingRecordsSection = tabs?.children[1]?.children[1];
+        assert.equal(tabs?.type, 'tabs');
+        assert.equal(tabs?.id, undefined);
+        assert.equal(tabs?.children[1]?.type, 'tab');
+        assert.equal(tabs?.children[1]?.id, undefined);
+        assert.deepEqual(profileSection?.columns, { default: 1, md: 2 });
+        assert.deepEqual(
+          profileSection?.children.map(item => item.name),
+          ['name', 'mobile', 'imageId'],
+        );
+        assert.equal(tabs?.children[1]?.children[0]?.name, 'level');
+        assert.deepEqual(
+          trainingRecordsSection?.children.map(item => item.name),
+          ['trainingRecords'],
+        );
+      }
+    });
+  });
+
+  it('action:student:filterFormLayoutMetadata', async () => {
+    await app.bean.executor.mockCtx(async () => {
+      const apiJson = await app.bean.openapi.generateJsonOfClass(DtoStudentSelectResItem);
+      const component = Object.values(apiJson.components!.schemas as any).find(item => {
+        return (item as any).properties?._operationsRow;
+      });
+      const filterBlock = (component as any)?.rest?.blocks?.[0]?.options?.blocks?.[0];
+      assert.equal(filterBlock?.render, 'basic-page:blockFilter');
+      assert.equal(filterBlock?.options?.formFieldLayout?.inline, false);
+      assert.deepEqual(
+        filterBlock?.options?.blocks?.map(item => item.render),
+        ['basic-form:blockFormLayout', 'basic-page:blockFilterActions'],
+      );
+      const formLayout = filterBlock?.options?.blocks?.[0]?.options?.formLayout;
+      assert.deepEqual(formLayout?.children[0]?.columns, { default: 1, md: 2 });
+      assert.deepEqual(
+        formLayout?.children[0]?.children.map(item => item.name),
+        ['name', 'level', 'createdAt'],
+      );
+      assert.deepEqual(formLayout?.children[0]?.children[2]?.span, { default: 1, md: 2 });
+    });
+  });
+
   it('action:student', async () => {
     await app.bean.executor.mockCtx(async () => {
       // data

package/zova/packages-zova/zova/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zova",
-  "version": "5.1.136",
+  "version": "5.1.137",
   "gitHead": "2c5c19284bab738e492856189acb6fad74b8a7b7",
   "description": "A vue3 framework with ioc",
   "keywords": [
@@ -46,7 +46,7 @@
   },
   "dependencies": {
     "zova-core": "^5.1.78",
-    "zova-suite-a-zova": "^5.1.135"
+    "zova-suite-a-zova": "^5.1.136"
   },
   "devDependencies": {
     "clean-package": "^2.2.0",

package/zova/pnpm-lock.yaml

@@ -1093,8 +1093,11 @@ importers:
   src/suite-vendor/a-zova/modules/a-form:
     dependencies:
       '@tanstack/vue-form':
-        specifier: ^1.32.0
-        version: 1.33.0(vue@3.5.38(typescript@5.9.3))
+        specifier: ^1.33.2
+        version: 1.33.2(vue@3.5.38(typescript@5.9.3))
+      '@tanstack/vue-store':
+        specifier: ^0.11.0
+        version: 0.11.0(vue@3.5.38(typescript@5.9.3))
     devDependencies:
       clean-package:
         specifier: ^2.2.0
@@ -3931,6 +3934,9 @@ packages:
   '@tanstack/form-core@1.33.0':
     resolution: {integrity: sha512-AV4Pw9Dk4orFsuPBcDssfWMJFs+yMYBae7zZ4oTqrCf4ftNGQKxvrQRZeqKHG6A4TkiLeSvf2kzIjcVkrW7E6w==}
 
+  '@tanstack/form-core@1.33.2':
+    resolution: {integrity: sha512-F60zJd15bGrXKonc1kpRYnNRNfiES7F+hgvrPMrsZznPLqZtO2DIg76OU6R25kCYkqYQY5xvuKteuWcUsc587A==}
+
   '@tanstack/match-sorter-utils@8.19.4':
     resolution: {integrity: sha512-Wo1iKt2b9OT7d+YGhvEPD3DXvPv2etTusIMhMUoG7fbhmxcXCtIjJDEygy91Y2JFlwGyjqiBPRozme7UD8hoqg==}
     engines: {node: '>=12'}
@@ -3957,6 +3963,11 @@ packages:
     peerDependencies:
       vue: ^3.4.0
 
+  '@tanstack/vue-form@1.33.2':
+    resolution: {integrity: sha512-yolxEs4XSQu2RhBpM48YgqmmpftR4v28XniH5UjGg9/Z3WOJAv+COSmWwC64ozs2OZIKF+j5ufu1ki62jtP6nA==}
+    peerDependencies:
+      vue: ^3.4.0
+
   '@tanstack/vue-query@5.101.1':
     resolution: {integrity: sha512-w36v/HlCF2xRpdDCz7cygk99AwBWhZaT5No1dJOwqIZ1AR8q7tiovRyPFID/49gkjXG7KgXs/nHfRg+eCydH4Q==}
     peerDependencies:
@@ -9729,6 +9740,12 @@ snapshots:
       '@tanstack/pacer-lite': 0.1.1
       '@tanstack/store': 0.11.0
 
+  '@tanstack/form-core@1.33.2':
+    dependencies:
+      '@tanstack/devtools-event-client': 0.4.4
+      '@tanstack/pacer-lite': 0.1.1
+      '@tanstack/store': 0.11.0
+
   '@tanstack/match-sorter-utils@8.19.4':
     dependencies:
       remove-accents: 0.5.0
@@ -9753,6 +9770,14 @@ snapshots:
     transitivePeerDependencies:
       - '@vue/composition-api'
 
+  '@tanstack/vue-form@1.33.2(vue@3.5.38(typescript@5.9.3))':
+    dependencies:
+      '@tanstack/form-core': 1.33.2
+      '@tanstack/vue-store': 0.11.0(vue@3.5.38(typescript@5.9.3))
+      vue: 3.5.38(typescript@5.9.3)
+    transitivePeerDependencies:
+      - '@vue/composition-api'
+
   '@tanstack/vue-query@5.101.1(vue@3.5.38(typescript@5.9.3))':
     dependencies:
       '@tanstack/match-sorter-utils': 8.19.4

package/zova/src/suite/cabloy-basic/modules/basic-form/src/.metadata/component/blockFormLayout.ts

@@ -0,0 +1,31 @@
+import type { TypeControllerInnerProps } from 'zova';
+
+import { defineComponent } from 'vue';
+import { prepareComponentOptions, useController } from 'zova';
+
+import type { ControllerBlockFormLayoutProps } from '../../component/blockFormLayout/controller.jsx';
+
+import { ControllerBlockFormLayout } from '../../component/blockFormLayout/controller.jsx';
+export type ZBlockFormLayoutProps = {
+  controllerRef?: (ref: ControllerBlockFormLayout) => void;
+} & ControllerBlockFormLayoutProps;
+
+type ControllerInnerProps = TypeControllerInnerProps<
+  ControllerBlockFormLayoutProps,
+  keyof typeof ControllerBlockFormLayout.$propsDefault
+>;
+declare module 'zova-module-basic-form' {
+  export interface ControllerBlockFormLayout {
+    $props: ControllerInnerProps;
+  }
+}
+
+export const ZBlockFormLayout = defineComponent((_props: ZBlockFormLayoutProps) => {
+  useController(ControllerBlockFormLayout, undefined, undefined);
+  return () => {};
+}, prepareComponentOptions(ControllerBlockFormLayout.$componentOptions));
+declare module 'zova-module-a-bean' {
+  export interface IVonaComponentRecord {
+    'basic-form:blockFormLayout': ControllerBlockFormLayoutProps;
+  }
+}

package/zova/src/suite/cabloy-basic/modules/basic-form/src/.metadata/index.ts

@@ -2,6 +2,7 @@
 /** controller: begin */
 export * from '../component/actionBack/controller.jsx';
 export * from '../component/actionSubmit/controller.jsx';
+export * from '../component/blockFormLayout/controller.jsx';
 
 import 'zova';
 declare module 'zova' {
@@ -18,17 +19,24 @@ declare module 'zova-module-basic-form' {
         export interface ControllerActionSubmit {
           /** @internal */
           get scope(): ScopeModuleBasicForm;
+        }
+
+        export interface ControllerBlockFormLayout {
+          /** @internal */
+          get scope(): ScopeModuleBasicForm;
         } 
 }
 /** controller: end */
 /** controller: begin */
 import { ControllerActionBack } from '../component/actionBack/controller.jsx';
 import { ControllerActionSubmit } from '../component/actionSubmit/controller.jsx';
+import { ControllerBlockFormLayout } from '../component/blockFormLayout/controller.jsx';
 import 'zova';
 declare module 'zova' {
   export interface IBeanRecordLocal {
     'basic-form.controller.actionBack': ControllerActionBack;
 'basic-form.controller.actionSubmit': ControllerActionSubmit;
+'basic-form.controller.blockFormLayout': ControllerBlockFormLayout;
   }
 }
 /** controller: end */
@@ -38,19 +46,24 @@ export * from './component/actionBack.js';
 import { ZActionBack } from './component/actionBack.js';
 export * from './component/actionSubmit.js';
 import { ZActionSubmit } from './component/actionSubmit.js';
+export * from './component/blockFormLayout.js';
+import { ZBlockFormLayout } from './component/blockFormLayout.js';
 export const components = {
   'actionBack': ZActionBack,
 'actionSubmit': ZActionSubmit,
+'blockFormLayout': ZBlockFormLayout,
 };
 import 'zova';
 declare module 'zova' {
 export interface IComponentRecord {
   'basic-form:actionBack': ControllerActionBack;
 'basic-form:actionSubmit': ControllerActionSubmit;
+'basic-form:blockFormLayout': ControllerBlockFormLayout;
 }
 export interface IZovaComponentRecord {
   'basic-form:actionBack': typeof ZActionBack;
 'basic-form:actionSubmit': typeof ZActionSubmit;
+'basic-form:blockFormLayout': typeof ZBlockFormLayout;
 }
 }
 /** components: end */