cabloy 5.1.174 → 5.1.176

package/repo-docs/fullstack/a-pay-payment-suite.md

@@ -1,6 +1,6 @@
 # A-Pay Payment Suite
 
-This guide explains the current payment architecture in Cabloy Basic across Vona, Zova, and the Commerce domain.
+This guide explains the current payment architecture shared by Cabloy Basic and Cabloy Start across Vona, Zova, and the Commerce domain.
 
 It is a source-oriented architecture guide for:
 
@@ -50,12 +50,26 @@ zova/src/suite-vendor/a-pay/
 
 The general suite/module organization is described in [Suites and Modules](/fullstack/suites-and-modules). The payment suite follows the vendor-suite layout rather than being a complete user-facing page package.
 
-| Module       | Vona responsibility                                                                                       | Zova responsibility                                                                         |
-| ------------ | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
-| `a-pay`      | Payment sessions, provider operations, callbacks, webhooks, normalized contracts, audit/outbox boundaries | Payment-session API/model, generated contracts, next-action component, redirect coordinator |
-| `pay-mock`   | Deterministic development/test provider and simulator webhook path                                        | Mock completion mutation used by the Commerce test surface                                  |
-| `pay-paypal` | PayPal API, capture, query, refund, and webhook translation                                               | Provider identity and metadata surface; no PayPal SDK execution in the browser              |
-| `pay-stripe` | Stripe Checkout, query, refund, and webhook translation                                                   | Provider identity and metadata surface; no Stripe SDK execution in the browser              |
+The shared suite contains payment-domain state and browser-safe coordination only. Presentation is owned by the active edition:
+
+```text
+zova/src/suite/cabloy-basic/modules/basic-pay/
+└── paymentNextAction  # DaisyUI and Tailwind CSS presenter
+
+zova/src/suite/cabloy-start/modules/start-pay/
+└── paymentNextAction  # Vuetify presenter
+```
+
+Each edition module exposes its own `ZPaymentNextAction` wrapper, while consuming the neutral `IPaymentNextActionProps` contract and `ServicePaymentCoordinator` from `a-pay`.
+
+| Module       | Vona responsibility                                                                                       | Zova responsibility                                                                                |
+| ------------ | --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| `a-pay`      | Payment sessions, provider operations, callbacks, webhooks, normalized contracts, audit/outbox boundaries | Payment-session API/model, generated contracts, normalized next-action input, redirect coordinator |
+| `basic-pay`  | —                                                                                                         | Cabloy Basic next-action presentation using DaisyUI and Tailwind CSS                               |
+| `start-pay`  | —                                                                                                         | Cabloy Start next-action presentation using Vuetify                                                |
+| `pay-mock`   | Deterministic development/test provider and simulator webhook path                                        | Mock completion mutation used by the Commerce test surface                                         |
+| `pay-paypal` | PayPal API, capture, query, refund, and webhook translation                                               | Provider identity and metadata surface; no PayPal SDK execution in the browser                     |
+| `pay-stripe` | Stripe Checkout, query, refund, and webhook translation                                                   | Provider identity and metadata surface; no Stripe SDK execution in the browser                     |
 
 The actual Web payment page is owned by the Commerce consumer, not by `zova-module-a-pay`:
 
@@ -143,7 +157,7 @@ The following flow is source-confirmed by the current Commerce and A-Pay impleme
 6. Commerce navigates to an authenticated Commerce payment route with the payment-session and order identifiers. Callback continuation remains server-selected and allowlisted; do not derive it from provider or browser input.
 7. The customer starts the session. Zova calls `POST /api/pay/payment-session/{id}/start`; A-Pay claims a provider operation with a stable idempotency key before making the external provider call.
 8. The provider adapter returns a normalized snapshot and optional `nextAction`. Redirect-capable providers normally return `requires_action` with a redirect action.
-9. Zova renders the generic next-action component. On the client, the redirect coordinator uses `window.location.assign(...)`; it does not call a provider SDK or decide whether the order is paid.
+9. Zova renders the edition-owned next-action presenter: `ZPaymentNextAction` from `basic-pay` in Cabloy Basic or from `start-pay` in Cabloy Start. On the client, the shared redirect coordinator uses `window.location.assign(...)`; it does not call a provider SDK or decide whether the order is paid.
 10. The provider returns through the server callback route, or sends a webhook to the public webhook route. A return callback can request confirmation or reconciliation, but cannot assert success.
 11. A-Pay verifies provider webhook input using the selected server-side client and the raw request body, then correlates provider, client, environment, amount, currency, and identifiers with the persisted session.
 12. Verified facts are deduplicated and applied to payment state. The state transition, audit entry, and `payment.outcome.v1` outbox record are written durably.
@@ -212,9 +226,9 @@ Read the frontend in Zova’s own roles first:
 | Zova role                        | Current A-Pay responsibility                                                                                      |
 | -------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
 | `ModelPaymentSession`            | Model-owned query and mutation state for `view`, `start`, and `reconcile`, including invalidation after mutations |
-| `ControllerPaymentNextAction`    | Component-controller behavior for redirect, pending, completed, and embedded action rendering                     |
+| `IPaymentNextActionProps`        | Shared neutral input contract for edition-owned next-action presenters                                            |
 | `ServicePaymentCoordinator`      | Client-only execution of a normalized redirect action                                                             |
-| `ZPaymentNextAction`             | Metadata-backed public component wrapper for the action controller                                                |
+| `basic-pay` / `start-pay`        | Edition-owned `ControllerPaymentNextAction` and `ZPaymentNextAction` presentation wrappers                        |
 | Commerce payment page controller | Route state, start/reconcile decisions, settlement polling, and order navigation                                  |
 
 This is not page-local Vue fetching rewritten with classes. The model bean owns remote query/mutation state; the controller owns interaction and lifecycle decisions; the service bean owns reusable browser-side behavior; the render/component wrapper exposes the controller to consumers.
@@ -223,10 +237,10 @@ The core frontend reading path is:
 
 1. `zova/src/suite-vendor/a-pay/modules/a-pay/src/types/payment.ts`
 2. `zova/src/suite-vendor/a-pay/modules/a-pay/src/model/paymentSession.ts`
-3. `zova/src/suite-vendor/a-pay/modules/a-pay/src/api/paymentSession.ts`
-4. `zova/src/suite-vendor/a-pay/modules/a-pay/src/apiSchema/paymentSession.ts`
+3. `zova/src/suite-vendor/a-pay/modules/a-pay/src/api/payPaymentSession.ts`
+4. `zova/src/suite-vendor/a-pay/modules/a-pay/src/apiSchema/payPaymentSession.ts`
 5. `zova/src/suite-vendor/a-pay/modules/a-pay/src/service/paymentCoordinator.ts`
-6. `zova/src/suite-vendor/a-pay/modules/a-pay/src/component/paymentNextAction/controller.tsx`
+6. `zova/src/suite/cabloy-basic/modules/basic-pay/src/component/paymentNextAction/controller.tsx` or `zova/src/suite/cabloy-start/modules/start-pay/src/component/paymentNextAction/controller.tsx`
 7. `zova/src/suite/a-commerce/modules/commerce-trade/src/page/payment/controller.tsx`
 
 When a consumer uses `controllerRef` on `ZPaymentNextAction`, it receives the Zova component controller instance. It is not a generic DOM or Vue component reference.
@@ -235,7 +249,7 @@ When a consumer uses `controllerRef` on `ZPaymentNextAction`, it receives the Zo
 
 - Keep payment-session query/mutation state in `ModelPaymentSession`.
 - Consume generated API types and schemas; do not hand-patch generated files.
-- Pass the normalized `nextAction` to the generic action component instead of adding provider-specific branches to Commerce pages.
+- Pass the normalized `nextAction` and shared `IPaymentNextActionProps` to the active edition's action component instead of adding provider-specific branches to Commerce pages.
 - Execute redirects only in the browser.
 - Keep mock simulator controls limited to mock sessions and development/test surfaces.
 - Treat payment-session terminal state and Commerce order settlement as separate observations.
@@ -303,10 +317,10 @@ For frontend contracts and consumption:
 
 1. `zova/src/suite-vendor/a-pay/modules/a-pay/src/types/payment.ts`
 2. `zova/src/suite-vendor/a-pay/modules/a-pay/src/model/paymentSession.ts`
-3. `zova/src/suite-vendor/a-pay/modules/a-pay/src/api/paymentSession.ts`
-4. `zova/src/suite-vendor/a-pay/modules/a-pay/src/apiSchema/paymentSession.ts`
+3. `zova/src/suite-vendor/a-pay/modules/a-pay/src/api/payPaymentSession.ts`
+4. `zova/src/suite-vendor/a-pay/modules/a-pay/src/apiSchema/payPaymentSession.ts`
 5. `zova/src/suite-vendor/a-pay/modules/a-pay/src/service/paymentCoordinator.ts`
-6. `zova/src/suite-vendor/a-pay/modules/a-pay/src/component/paymentNextAction/controller.tsx`
+6. `zova/src/suite/cabloy-basic/modules/basic-pay/src/component/paymentNextAction/controller.tsx` or `zova/src/suite/cabloy-start/modules/start-pay/src/component/paymentNextAction/controller.tsx`
 7. `zova/src/suite/a-commerce/modules/commerce-trade/src/routes.ts`
 8. `zova/src/suite/a-commerce/modules/commerce-trade/src/page/checkout/controller.tsx`
 9. `zova/src/suite/a-commerce/modules/commerce-trade/src/page/payment/controller.tsx`

package/repo-e2e/specs/cabloy-basic.spec.ts

@@ -916,6 +916,17 @@ test(
         await expect(selectionStatus).toHaveText('Selected 2 items');
         await expect(rowFor(selectedNames[0])).toHaveAttribute('aria-selected', 'true');
         await expect(rowFor(selectedNames[1])).toHaveAttribute('aria-selected', 'true');
+
+        const errorDialog = page.getByRole('dialog').filter({
+          hasText: 'Bulk deletion temporarily unavailable',
+        });
+        await expect(errorDialog).toBeVisible();
+        await expect(errorDialog.getByRole('button', { name: 'Close', exact: true })).toBeVisible();
+        await errorDialog.getByRole('button', { name: 'Close', exact: true }).click();
+        await expect(errorDialog).toHaveCount(0);
+        await expect(deleteBulk).toBeEnabled();
+        await expect(deleteBulk).not.toHaveAttribute('aria-busy', 'true');
+        await expect(deleteBulk.locator('.loading.loading-spinner')).toHaveCount(0);
       } finally {
         await page.unroute(bulkDeleteRoute, bulkDeleteFailureHandler);
       }

package/repo-e2e/specs/controller-boundary.spec.ts

@@ -155,10 +155,9 @@ test(
     const ready = overrideHost.getByText('Override Controller boundary probe ready', {
       exact: true,
     });
-    const initialOverrideLoading = loading.waitFor({ state: 'visible' });
+    const initialOverrideLoading = expect(loading).toHaveText('Override loading mode: inline');
     await page.getByRole('button', { name: 'Mount override failing probe', exact: true }).click();
     await initialOverrideLoading;
-    await expect(loading).toHaveText('Override loading mode: inline');
     await expect(error).toHaveText(
       'Override legacy error: Override Controller boundary probe initialization failed',
     );

package/test-results/.last-run.json

@@ -1,4 +1,4 @@
 {
-  "status": "failed",
+  "status": "passed",
   "failedTests": []
 }

package/vona/packages-cli/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-cli",
-  "version": "1.1.149",
+  "version": "1.1.150",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "vona cli",
   "keywords": [

package/vona/packages-cli/cli-set-api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-cli-set-api",
-  "version": "1.1.147",
+  "version": "1.1.148",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "vona cli-set-api",
   "keywords": [

package/vona/packages-vona/vona/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona",
-  "version": "5.1.93",
+  "version": "5.1.94",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "Vona is an intuitive, elegant and powerful Node.js framework for rapidly developing enterprise applications of any size",
   "keywords": [

package/vona/packages-vona/vona-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-core",
-  "version": "5.1.38",
+  "version": "5.1.39",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "vona",
   "keywords": [

package/vona/packages-vona/vona-core/src/lib/utils/util.ts

@@ -183,6 +183,7 @@ export class AppUtil extends BeanSimple {
   createError(data, returnObject?: boolean) {
     const error = returnObject ? ({} as any) : new Error();
     error.code = data.code !== undefined ? data.code : 500;
+    if (data.status !== undefined) error.status = data.status;
     if (data.message && typeof data.message === 'object') {
       error.message = JSON.stringify(data.message, null, 2);
     } else {

package/vona/packages-vona/vona-mock/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-mock",
-  "version": "6.1.38",
+  "version": "6.1.39",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "vona mock",
   "keywords": [

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

@@ -541,7 +541,7 @@ describe('student.test.ts', { concurrency: false }, () => {
         const deleted = await app.bean.executor.performAction(
           'post',
           '/training/student/bulk/delete',
-          { body: { ids: [studentId, studentId, '__missing-student__'] } },
+          { body: { ids: [studentId, studentId, '-1'] } },
         );
         assert.equal(deleted, null);
         assert.equal(

package/vona/src/suite-vendor/a-cabloy/modules/a-layoutprofile/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-module-a-layoutprofile",
-  "version": "5.0.1",
+  "version": "5.0.2",
   "description": "",
   "keywords": [
     "Vona Module"

package/vona/src/suite-vendor/a-cabloy/modules/a-layoutprofile/test/layoutprofile.test.ts

@@ -4,6 +4,7 @@ import { catchError } from '@cabloy/utils';
 import assert from 'node:assert';
 import { randomUUID } from 'node:crypto';
 import { describe, it } from 'node:test';
+import { isDeepStrictEqual } from 'node:util';
 import { app } from 'vona-mock';
 
 import type { ILayoutProfile } from '../src/types/layoutprofile.ts';
@@ -200,9 +201,7 @@ describe('layoutprofile.test.ts', { concurrency: false }, () => {
         });
       });
       assert.equal(persisted.length, 1);
-      assert.ok(
-        profiles.some(profile => JSON.stringify(profile) === JSON.stringify(persisted[0].profile)),
-      );
+      assert.ok(profiles.some(profile => isDeepStrictEqual(profile, persisted[0].profile)));
 
       const loaded = await app.bean.executor.mockCtx(async () => {
         return await performAs(fixture.token, 'get', `${actionPath}/load`, {

package/vona/src/suite-vendor/a-cabloy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-suite-a-cabloy",
-  "version": "5.1.53",
+  "version": "5.1.54",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "",
   "author": "",
@@ -8,7 +8,7 @@
   "type": "module",
   "dependencies": {
     "vona-module-a-cabloy": "workspace:^",
-    "vona-module-a-layoutprofile": "^5.0.1",
+    "vona-module-a-layoutprofile": "^5.0.2",
     "vona-module-a-markdown": "^5.0.3",
     "vona-module-a-rbac": "^5.0.6",
     "vona-module-a-socket": "workspace:^",

package/vona/src/suite-vendor/a-vona/modules/a-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-module-a-core",
-  "version": "5.1.52",
+  "version": "5.1.53",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "",
   "keywords": [

package/vona/src/suite-vendor/a-vona/modules/a-executor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-module-a-executor",
-  "version": "5.1.16",
+  "version": "5.1.17",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "",
   "keywords": [

package/vona/src/suite-vendor/a-vona/modules/a-executor/src/service/executor.ts

@@ -64,10 +64,15 @@ export class ServiceExecutor extends BeanBase {
             throw app.util.createError(ctx.body);
           }
           if (ctx.body && typeof ctx.body === 'object') {
-            throw app.util.createError(ctx.body);
+            throw app.util.createError({
+              ...ctx.body,
+              status: ctx.status,
+              code: (ctx.body as { code?: unknown }).code ?? ctx.status,
+            });
           }
           throw app.util.createError({
             code: ctx.status,
+            status: ctx.status,
             message: ctx.message,
           });
         },

package/vona/src/suite-vendor/a-vona/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-suite-a-vona",
-  "version": "5.1.86",
+  "version": "5.1.87",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "",
   "author": "",

package/zova/package.original.json

@@ -74,7 +74,7 @@
     "zova": "workspace:^"
   },
   "devDependencies": {
-    "@cabloy/lint": "^5.1.33",
+    "@cabloy/lint": "^5.1.35",
     "@cabloy/openapi-typescript": "^7.9.2",
     "@quasar/app-vite": "npm:@cabloy/quasar-app-vite@^2.5.10",
     "@types/node": "^22.19.17",

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

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

package/zova/pnpm-lock.yaml

@@ -77,7 +77,7 @@ importers:
         version: 10.6.0(postcss@8.5.28)
       axios:
         specifier: ^1.18.1
-        version: 1.20.0
+        version: 1.20.0(supports-color@10.2.2)
       compression:
         specifier: ^1.8.1
         version: 1.8.2
@@ -153,9 +153,6 @@ importers:
       zova-module-a-behaviors:
         specifier: workspace:^
         version: link:src/suite-vendor/a-zova/modules/a-behaviors
-      zova-module-a-boundary:
-        specifier: workspace:^
-        version: link:src/suite-vendor/a-zova/modules/a-boundary
       zova-module-a-command:
         specifier: workspace:^
         version: link:src/suite-vendor/a-zova/modules/a-command
@@ -273,6 +270,9 @@ importers:
       zova-module-basic-pageentry:
         specifier: workspace:^
         version: link:src/suite/cabloy-basic/modules/basic-pageentry
+      zova-module-basic-pay:
+        specifier: workspace:^
+        version: link:src/suite/cabloy-basic/modules/basic-pay
       zova-module-basic-resource:
         specifier: workspace:^
         version: link:src/suite/cabloy-basic/modules/basic-resource
@@ -369,10 +369,10 @@ importers:
     devDependencies:
       '@cabloy/cli':
         specifier: ^3.1.29
-        version: 3.1.29(vue@3.5.42(typescript@5.9.3))
+        version: 3.1.29(supports-color@10.2.2)(vue@3.5.42(typescript@5.9.3))
       '@cabloy/lint':
-        specifier: ^5.1.33
-        version: 5.1.33(@typescript-eslint/eslint-plugin@8.70.0(@typescript-eslint/parser@8.70.0(eslint@10.10.0(jiti@2.7.0))(supports-color@10.2.2)(typescript@5.9.3))(eslint@10.10.0(jiti@2.7.0))(typescript@5.9.3))(@typescript-eslint/typescript-estree@8.70.0(typescript@5.9.3))(@typescript-eslint/utils@8.70.0(eslint@10.10.0(jiti@2.7.0))(typescript@5.9.3))(eslint@10.10.0(jiti@2.7.0))(oxfmt@0.62.0)(oxlint@1.82.0)(supports-color@10.2.2)(typescript@5.9.3)(vue-eslint-parser@10.4.1(eslint@10.10.0(jiti@2.7.0)))
+        specifier: ^5.1.35
+        version: 5.1.35(@typescript-eslint/eslint-plugin@8.70.0(@typescript-eslint/parser@8.70.0(eslint@10.10.0(jiti@2.7.0))(supports-color@10.2.2)(typescript@5.9.3))(eslint@10.10.0(jiti@2.7.0))(typescript@5.9.3))(@typescript-eslint/typescript-estree@8.70.0(typescript@5.9.3))(@typescript-eslint/utils@8.70.0(eslint@10.10.0(jiti@2.7.0))(typescript@5.9.3))(eslint@10.10.0(jiti@2.7.0))(oxfmt@0.62.0)(oxlint@1.82.0)(supports-color@10.2.2)(typescript@5.9.3)(vue-eslint-parser@10.4.1(eslint@10.10.0(jiti@2.7.0)))
       '@cabloy/openapi-typescript':
         specifier: ^7.9.2
         version: 7.9.2(typescript@5.9.3)
@@ -444,7 +444,7 @@ importers:
     dependencies:
       '@cabloy/cli':
         specifier: ^3.1.29
-        version: 3.1.29(vue@3.5.42(typescript@5.9.3))
+        version: 3.1.29(supports-color@10.2.2)(vue@3.5.42(typescript@5.9.3))
       '@cabloy/process-helper':
         specifier: ^3.1.8
         version: 3.1.8
@@ -478,7 +478,7 @@ importers:
         version: 7.29.7(@babel/core@7.29.7)
       '@cabloy/cli':
         specifier: ^3.1.29
-        version: 3.1.29(vue@3.5.42(typescript@5.9.3))
+        version: 3.1.29(supports-color@10.2.2)(vue@3.5.42(typescript@5.9.3))
       '@cabloy/extend':
         specifier: ^3.2.8
         version: 3.2.8
@@ -876,7 +876,7 @@ importers:
         specifier: ^5.1.90
         version: link:../zova-core
       zova-suite-a-zova:
-        specifier: ^5.1.162
+        specifier: ^5.1.163
         version: link:../../src/suite-vendor/a-zova
     devDependencies:
       clean-package:
@@ -1019,7 +1019,7 @@ importers:
   src/suite-vendor/a-pay:
     dependencies:
       zova-module-a-pay:
-        specifier: ^5.0.7
+        specifier: ^5.0.8
         version: link:modules/a-pay
       zova-module-pay-mock:
         specifier: ^5.0.5
@@ -1084,9 +1084,6 @@ importers:
       zova-module-a-behaviors:
         specifier: ^5.1.22
         version: link:modules/a-behaviors
-      zova-module-a-boundary:
-        specifier: ^5.1.22
-        version: link:modules/a-boundary
       zova-module-a-command:
         specifier: ^5.1.35
         version: link:modules/a-command
@@ -1115,7 +1112,7 @@ importers:
         specifier: ^5.1.54
         version: link:modules/a-openapi
       zova-module-a-router:
-        specifier: ^5.1.38
+        specifier: ^5.1.39
         version: link:modules/a-router
       zova-module-a-routerstack:
         specifier: ^5.1.29
@@ -1142,7 +1139,7 @@ importers:
         specifier: ^5.1.37
         version: link:modules/a-zod
       zova-module-a-zova:
-        specifier: ^5.1.105
+        specifier: ^5.1.106
         version: link:modules/a-zova
 
   src/suite-vendor/a-zova/modules/a-api:
@@ -1194,15 +1191,6 @@ importers:
         specifier: ^6.1.3
         version: 6.1.3
 
-  src/suite-vendor/a-zova/modules/a-boundary:
-    devDependencies:
-      clean-package:
-        specifier: ^2.2.0
-        version: 2.2.0
-      rimraf:
-        specifier: ^6.1.3
-        version: 6.1.3
-
   src/suite-vendor/a-zova/modules/a-command:
     devDependencies:
       clean-package:
@@ -1216,7 +1204,7 @@ importers:
     dependencies:
       axios:
         specifier: ^1.18.1
-        version: 1.20.0
+        version: 1.20.0(supports-color@10.2.2)
     devDependencies:
       clean-package:
         specifier: ^2.2.0
@@ -1489,7 +1477,7 @@ importers:
     devDependencies:
       '@cabloy/cli':
         specifier: ^3.1.29
-        version: 3.1.29(vue@3.5.42(typescript@5.9.3))
+        version: 3.1.29(supports-color@10.2.2)(vue@3.5.42(typescript@5.9.3))
       '@types/luxon':
         specifier: ^3.7.1
         version: 3.7.5
@@ -1593,6 +1581,9 @@ importers:
       zova-module-a-pay:
         specifier: workspace:^
         version: link:../../../../suite-vendor/a-pay/modules/a-pay
+      zova-module-basic-pay:
+        specifier: workspace:^
+        version: link:../../../cabloy-basic/modules/basic-pay
       zova-module-pay-mock:
         specifier: workspace:^
         version: link:../../../../suite-vendor/a-pay/modules/pay-mock
@@ -1895,6 +1886,9 @@ importers:
       zova-module-basic-pageentry:
         specifier: ^5.0.7
         version: link:modules/basic-pageentry
+      zova-module-basic-pay:
+        specifier: ^5.0.0
+        version: link:modules/basic-pay
       zova-module-basic-resource:
         specifier: ^5.0.0
         version: link:modules/basic-resource
@@ -2103,6 +2097,19 @@ importers:
         specifier: ^6.1.3
         version: 6.1.3
 
+  src/suite/cabloy-basic/modules/basic-pay:
+    dependencies:
+      zova-module-a-pay:
+        specifier: workspace:^
+        version: link:../../../../suite-vendor/a-pay/modules/a-pay
+    devDependencies:
+      clean-package:
+        specifier: ^2.2.0
+        version: 2.2.0
+      rimraf:
+        specifier: ^6.1.3
+        version: 6.1.3
+
   src/suite/cabloy-basic/modules/basic-resource:
     devDependencies:
       clean-package:
@@ -2362,8 +2369,8 @@ packages:
   '@cabloy/json5@1.1.9':
     resolution: {integrity: sha512-jV0WqPaTuLOw5UvFWOVD/1HNaWHKABs8Xd652C7jq7vhKPZsKzBy5de+Az4kd3jgn4JxaPLJgVTID/svynAzFA==}
 
-  '@cabloy/lint@5.1.33':
-    resolution: {integrity: sha512-x02EcUc5Wk0yFuofcb4xdz/P68l/yCJYyxB2TNPMNHEh3FAYto2z8WrKNZmLLEaJxI5TVNP4s44vP/LWh4A7Eg==}
+  '@cabloy/lint@5.1.35':
+    resolution: {integrity: sha512-aWrGyzwYI3ZFgIxuilA0pov18cKcyAmIe3slTgokrNfv8I4xTl2JXxcEPoR+/gk1/qB3N+ESA8199LR6wBBAMA==}
     peerDependencies:
       oxfmt: '>=0.62.0'
       oxlint: '>=1.77.0'
@@ -8844,7 +8851,7 @@ snapshots:
 
   '@bufbuild/protobuf@2.15.0': {}
 
-  '@cabloy/cli@3.1.29(vue@3.5.42(typescript@5.9.3))':
+  '@cabloy/cli@3.1.29(supports-color@10.2.2)(vue@3.5.42(typescript@5.9.3))':
     dependencies:
       '@babel/parser': 7.29.8
       '@cabloy/module-glob': 5.3.18
@@ -8853,7 +8860,7 @@ snapshots:
       '@cabloy/utils': 2.1.27
       '@cabloy/word-utils': link:packages-utils/word-utils
       '@npmcli/config': 10.12.0
-      '@zhennann/common-bin': 4.0.1
+      '@zhennann/common-bin': 4.0.1(supports-color@10.2.2)
       '@zhennann/ejs': 3.0.1
       boxen: 4.2.0
       chalk: 3.0.0
@@ -8891,7 +8898,7 @@ snapshots:
     dependencies:
       json5: 2.2.3
 
-  '@cabloy/lint@5.1.33(@typescript-eslint/eslint-plugin@8.70.0(@typescript-eslint/parser@8.70.0(eslint@10.10.0(jiti@2.7.0))(supports-color@10.2.2)(typescript@5.9.3))(eslint@10.10.0(jiti@2.7.0))(typescript@5.9.3))(@typescript-eslint/typescript-estree@8.70.0(typescript@5.9.3))(@typescript-eslint/utils@8.70.0(eslint@10.10.0(jiti@2.7.0))(typescript@5.9.3))(eslint@10.10.0(jiti@2.7.0))(oxfmt@0.62.0)(oxlint@1.82.0)(supports-color@10.2.2)(typescript@5.9.3)(vue-eslint-parser@10.4.1(eslint@10.10.0(jiti@2.7.0)))':
+  '@cabloy/lint@5.1.35(@typescript-eslint/eslint-plugin@8.70.0(@typescript-eslint/parser@8.70.0(eslint@10.10.0(jiti@2.7.0))(supports-color@10.2.2)(typescript@5.9.3))(eslint@10.10.0(jiti@2.7.0))(typescript@5.9.3))(@typescript-eslint/typescript-estree@8.70.0(typescript@5.9.3))(@typescript-eslint/utils@8.70.0(eslint@10.10.0(jiti@2.7.0))(typescript@5.9.3))(eslint@10.10.0(jiti@2.7.0))(oxfmt@0.62.0)(oxlint@1.82.0)(supports-color@10.2.2)(typescript@5.9.3)(vue-eslint-parser@10.4.1(eslint@10.10.0(jiti@2.7.0)))':
     dependencies:
       '@e18e/eslint-plugin': 0.2.0(eslint@10.10.0(jiti@2.7.0))(oxlint@1.82.0)
       '@eslint/json': 1.2.0
@@ -11041,7 +11048,7 @@ snapshots:
 
   '@vue/shared@3.5.13': {}
 
-  '@zhennann/common-bin@4.0.1':
+  '@zhennann/common-bin@4.0.1(supports-color@10.2.2)':
     dependencies:
       chalk: 4.1.2
       change-case: 4.1.2
@@ -11075,7 +11082,7 @@ snapshots:
 
   acorn@8.18.0: {}
 
-  agent-base@6.0.2:
+  agent-base@6.0.2(supports-color@10.2.2):
     dependencies:
       debug: 4.4.3(supports-color@10.2.2)
     transitivePeerDependencies:
@@ -11183,11 +11190,11 @@ snapshots:
     dependencies:
       possible-typed-array-names: 1.1.0
 
-  axios@1.20.0:
+  axios@1.20.0(supports-color@10.2.2):
     dependencies:
       follow-redirects: 1.16.0
       form-data: 4.0.6
-      https-proxy-agent: 5.0.1
+      https-proxy-agent: 5.0.1(supports-color@10.2.2)
       proxy-from-env: 2.1.0
     transitivePeerDependencies:
       - debug
@@ -12582,9 +12589,9 @@ snapshots:
       statuses: 2.0.2
       toidentifier: 1.0.1
 
-  https-proxy-agent@5.0.1:
+  https-proxy-agent@5.0.1(supports-color@10.2.2):
     dependencies:
-      agent-base: 6.0.2
+      agent-base: 6.0.2(supports-color@10.2.2)
       debug: 4.4.3(supports-color@10.2.2)
     transitivePeerDependencies:
       - supports-color

package/zova/src/suite/a-commerce/modules/commerce-catalog/src/page/product/controller.tsx

@@ -5,6 +5,7 @@ import { z } from 'zod';
 import { BeanControllerPageBase, Use } from 'zova';
 import { Controller } from 'zova-module-a-bean';
 import { $QueryEnsureLoaded } from 'zova-module-a-model';
+import { ZButton } from 'zova-module-basic-button';
 import { ZMarkdownHtml } from 'zova-module-basic-markdown';
 import { ZPage } from 'zova-module-home-base';
 
@@ -88,12 +89,12 @@ export class ControllerPageProduct extends BeanControllerPageBase {
                       <span class="badge badge-success">
                         {this.scope.locale.AvailableCount(sku.available)}
                       </span>
-                      <button
+                      <ZButton
                         class="btn btn-primary btn-sm"
-                        onClick={() => this.addItem(String(sku.id))}
+                        onPerform={() => this.addItem(String(sku.id))}
                       >
                         {this.scope.locale.AddToCart()}
-                      </button>
+                      </ZButton>
                     </div>
                   ))}
                 </div>

package/zova/src/suite/a-commerce/modules/commerce-member/src/page/address/controller.tsx

@@ -7,6 +7,7 @@ import { BeanControllerPageBase, Use } from 'zova';
 import { Controller } from 'zova-module-a-bean';
 import { ZForm } from 'zova-module-a-form';
 import { $QueryEnsureLoaded } from 'zova-module-a-model';
+import { ZButton } from 'zova-module-basic-button';
 import { ZPage } from 'zova-module-home-base';
 
 import type {
@@ -127,12 +128,12 @@ export class ControllerPageAddress extends BeanControllerPageBase {
                         <button class="btn btn-outline btn-sm" onClick={() => this.edit(item)}>
                           {this.scope.locale.EditAddress()}
                         </button>
-                        <button
+                        <ZButton
                           class="btn btn-error btn-outline btn-sm"
-                          onClick={() => this.delete(item)}
+                          onPerform={() => this.delete(item)}
                         >
                           {this.scope.locale.DeleteAddress()}
-                        </button>
+                        </ZButton>
                       </div>
                     </div>
                     <p>{item.addressLine1}</p>