cabloy 5.1.176 → 5.1.178

package/.cabloy-version

@@ -1 +1 @@
-5.1.176
+5.1.178

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 5.1.178
+
+### Features
+
+- Add `setPageMeta` support for configuring page metadata.
+
+### Bug Fixes
+
+- Fix router behavior.
+- Correct `isAttemptActive` handling.
+- Ensure route resources are ready before initializing controller data.
+
+## 5.1.177
+
+### Improvements
+
+- Update the menu guide documentation.
+- Refresh the pnpm lockfile.
+
 ## 5.1.176
 
 ### Improvements

package/package.json

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

package/repo-docs/backend/menu-guide.md

@@ -55,9 +55,11 @@ This makes menu retrieval part of the broader backend contract surface.
 
 In the current repo implementation, the out-of-the-box menu controller is public and delegates directly to `this.scope.service.menu.retrieveMenus(publicPath)`.
 
-## Static menu visibility
+## SSR Site targeting
 
-`@SsrMenu(...)` items can declare static role visibility without changing the public menu DTO:
+`@SsrMenu(...)` and `@SsrMenuGroup(...)` use `site` to select the SSR Site onion(s) that receive the declaration. It is a navigation-composition filter, not a site-admission, role-visibility, or backend-authorization decision.
+
+Use `site` for navigation owned by one SSR Site or deliberately exclusive to a known subset of sites:
 
 ```typescript
 @SsrMenu({
@@ -66,10 +68,41 @@ In the current repo implementation, the out-of-the-box menu controller is public
     link: 'presetResource',
     roles: ['systemAdmin'],
   },
-  site: 'basic-siteadmin:admin',
+  // This Basic Admin-owned entry intentionally targets one SSR Site.
+  site: ['basic-siteadmin:admin'],
+})
+```
+
+For a shared module declaration intended for every compatible SSR Admin site, omit `site`:
+
+```typescript
+@SsrMenu({
+  item: {
+    title: $locale('SharedOperations'),
+    link: 'presetResource',
+    roles: ['systemAdmin'],
+  },
+  // No `site`: the shared declaration is available to compatible SSR Admin sites.
 })
 ```
 
+Do not bind a shared Admin menu or menu group to the current/default Admin site merely to keep a new independent site's navigation narrow. Isolate an independent site through its enabled module composition and site-owned menus/groups. When a shared capability needs genuinely different navigation contracts per site, use an explicit, approved site-specific composition or owner instead of narrowing the shared declaration by default.
+
+`site` is distinct from a role's `siteIds`, menu `roles` or role-menu associations, and Passport/RBAC authorization:
+
+```text
+site              -> which SSR Site receives a menu/group declaration
+siteIds           -> which frontend Site a subject may enter
+roles / role-menu -> which admitted subject may discover a menu leaf
+Passport / RBAC   -> which backend actions or data the subject may use
+```
+
+See [Menu Authorization](/backend/menu-authorization) for the site-admission, navigation-disclosure, and backend-authority boundaries.
+
+## Static menu visibility
+
+`@SsrMenu(...)` items can declare static role visibility without changing the public menu DTO:
+
 - Omit `roles` to make an item visible to anonymous and authenticated callers.
 - Use `roles: []` when an item has no static role visibility and is intended to be disclosed only through dynamic Role-menu configuration.
 - A nonempty `roles` array is visible when the current Passport has at least one matching role name; it can also be disclosed through dynamic Role-menu configuration.
@@ -107,5 +140,6 @@ When editing SSR menu behavior, ask:
 2. is there a default fallback menu that should remain available?
 3. does the menu contract belong in backend API design, frontend route design, or both?
 4. does the active edition affect the menu structure or public path assumptions?
+5. is this declaration site-owned or deliberately site-exclusive (specify `site`), or shared across compatible SSR Admin sites (omit `site`)?
 
 That helps AI keep menu behavior aligned with Cabloy’s shared SSR architecture.

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

@@ -28,6 +28,16 @@ function collectPageErrors(page: Page) {
   return errors;
 }
 
+function collectConsoleErrors(page: Page) {
+  const errors: string[] = [];
+  page.on('console', message => {
+    if (message.type() === 'error') {
+      errors.push(message.text());
+    }
+  });
+  return errors;
+}
+
 async function loginAsAdmin(page: Page) {
   await page.goto('/admin/', { waitUntil: 'load' });
   if (page.url().includes('/admin/login')) {
@@ -319,7 +329,64 @@ test(
 );
 
 test(
-  'ATP-BASIC-FLOW-01: Training Student flow filter wraps and submits queries',
+  'ATP-BASIC-FLOW-01: cold Admin navigation initializes dynamic resource selectors',
+  { tag: ['@admin', '@flow'] },
+  async ({ browser }) => {
+    const context = await browser.newContext();
+    const page = await context.newPage();
+    const pageErrors = collectPageErrors(page);
+    const consoleErrors = collectConsoleErrors(page);
+    try {
+      await page.goto('/admin/login', { waitUntil: 'load' });
+      await page.evaluate(() => {
+        indexedDB.deleteDatabase('localforage');
+        localStorage.clear();
+        sessionStorage.clear();
+      });
+      await page.goto('/admin/login?returnTo=/rest/resource/training-student%253Astudent', {
+        waitUntil: 'load',
+      });
+      await page.getByPlaceholder('Your Username').fill('admin');
+      await page.getByPlaceholder('Your Password').fill('123456');
+      await expect(page.getByPlaceholder('Please input captcha')).not.toHaveValue('');
+
+      const initialSelect = waitForStudentSelect(page);
+      await page.getByRole('button', { name: 'Login', exact: true }).click();
+      try {
+        await expect(page).toHaveURL(studentResourceUrl);
+        await initialSelect;
+      } finally {
+        await initialSelect.catch(() => {});
+      }
+      await expect(page.getByLabel('Student Name')).toBeVisible();
+
+      await page.getByRole('link', { name: 'Home', exact: true }).click();
+      await expect(page).toHaveURL(/\/admin\/(?:\?|$)/);
+      await expect(page.locator('html')).toHaveAttribute('data-zova-hydrated', 'admin');
+      await expect(
+        page.getByRole('heading', { name: 'Vona integrated SSR', exact: true }),
+      ).toBeVisible();
+      await expect(
+        page.getByRole('heading', { name: 'Zova standalone SSR', exact: true }),
+      ).toBeVisible();
+      await expect(page.locator('body')).toBeVisible();
+
+      expect(pageErrors).toEqual([]);
+      expect(
+        consoleErrors.some(
+          error =>
+            error.includes("Cannot read properties of undefined (reading 'resource')") ||
+            error.includes('resource not specified'),
+        ),
+      ).toBeFalsy();
+    } finally {
+      await context.close();
+    }
+  },
+);
+
+test(
+  'ATP-BASIC-FLOW-02: Training Student flow filter wraps and submits queries',
   { tag: ['@admin', '@flow'] },
   async ({ page }) => {
     await page.setViewportSize({ width: 1440, height: 900 });

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

@@ -101,6 +101,48 @@ test(
   },
 );
 
+test(
+  'ATP-BASIC-CONTROLLER-BOUNDARY-06: disposed and stale loads do not surface errors',
+  { tag: ['@web', '@flow'] },
+  async ({ page }) => {
+    const pageErrors = collectPageErrors(page);
+    const consoleErrors = collectConsoleErrors(page);
+    const response = await page.goto('/demo/basic/controllerBoundary', { waitUntil: 'load' });
+    expect(response?.ok()).toBeTruthy();
+    await expect(page.locator('html')).toHaveAttribute('data-zova-hydrated', 'web');
+    await page.waitForTimeout(1_000);
+
+    const loading = page.getByRole('status');
+    const error = page.locator('.alert.alert-error');
+    const ready = page.getByText('Controller boundary probe ready', { exact: true });
+
+    const disposedLoading = loading.waitFor({ state: 'visible' });
+    await page.getByRole('button', { name: 'Mount failing probe', exact: true }).click();
+    await disposedLoading;
+    await page.getByRole('button', { name: 'Clear probe', exact: true }).click();
+    await page.waitForTimeout(1_000);
+    await expect(loading).toHaveCount(0);
+    await expect(error).toHaveCount(0);
+    await expect(ready).toHaveCount(0);
+
+    const staleLoading = loading.waitFor({ state: 'visible' });
+    await page.getByRole('button', { name: 'Mount failing probe', exact: true }).click();
+    await staleLoading;
+    await page.getByRole('button', { name: 'Mount fast success probe', exact: true }).click();
+    await expect(ready).toBeVisible();
+    await page.waitForTimeout(1_000);
+    await expect(error).toHaveCount(0);
+    await expect(ready).toBeVisible();
+
+    expect(pageErrors).toEqual([]);
+    expect(
+      consoleErrors.filter(error =>
+        /Cannot read properties of null \(reading ['"]state['"]\)/.test(error),
+      ),
+    ).toEqual([]);
+  },
+);
+
 test(
   'ATP-BASIC-CONTROLLER-BOUNDARY-02: inline boundaries preserve phrasing-content markup',
   { tag: ['@web', '@flow'] },

package/repo-e2e/specs/routed-dialog.spec.ts

@@ -195,6 +195,21 @@ test(
     await expect(dialogA.getByRole('button', { name: 'Back', exact: true })).toHaveCount(0);
     expect(page.url()).toBe(browserUrl);
 
+    await page.keyboard.press('Escape');
+    await expect(dialogA).toHaveCount(0);
+    expect(page.url()).toBe(browserUrl);
+
+    await page.getByRole('button', { name: 'Open A', exact: true }).click();
+    await expect(dialogA).toHaveCount(1);
+    await expect(
+      dialogA.getByRole('heading', { name: 'Routed Dialog Entry', exact: true }),
+    ).toBeVisible();
+    await dialogA.getByRole('button', { name: 'Local push to detail', exact: true }).click();
+    await expect(
+      dialogA.getByRole('heading', { name: 'Routed Dialog Detail', exact: true }),
+    ).toBeVisible();
+    expect(page.url()).toBe(browserUrl);
+
     await page.keyboard.press('Escape');
     await expect(dialogA).toHaveCount(0);
     expect(page.url()).toBe(browserUrl);

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

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

package/vona/packages-cli/cli-set-api/cli/templates/tools/crudBasic/boilerplate/src/controller/{{resourceName}}.ts_

@@ -65,5 +65,5 @@ export class Controller<%=argv.resourceNameCapitalize%> extends BeanBase {
   @Passport.systemAdmin()
   async deleteBulk(@Arg.body() command: Dto<%=argv.resourceNameCapitalize%>DeleteBulk): Promise<void> {
     await this.scope.service.<%=argv.resourceName%>.deleteBulk(command.ids);
-  }  
+  }
 }

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

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

package/zova/packages-utils/zova-jsx/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zova-jsx",
-  "version": "1.1.90",
+  "version": "1.1.91",
   "gitHead": "2c5c19284bab738e492856189acb6fad74b8a7b7",
   "description": "Zova JSX",
   "keywords": [
@@ -50,7 +50,7 @@
     "@cabloy/word-utils": "^2.1.14",
     "typestyle": "^2.4.0",
     "vue": "^3.5.38",
-    "zova-core": "^5.1.90"
+    "zova-core": "^5.1.91"
   },
   "devDependencies": {
     "clean-package": "^2.2.0",

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

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

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

@@ -1,6 +1,6 @@
 {
   "name": "zova-core",
-  "version": "5.1.90",
+  "version": "5.1.91",
   "gitHead": "2c5c19284bab738e492856189acb6fad74b8a7b7",
   "description": "A vue3 framework with ioc",
   "keywords": [

package/zova/packages-zova/zova-core/src/bean/beanContainer.ts

@@ -489,6 +489,10 @@ export class BeanContainer {
       // throw new Error(`bean not found: ${beanFullName}`);
       return null!;
     }
+    // controller module: ensure route resources are ready before controller data initialization
+    if (controllerData) {
+      await this._useModule(beanOptions.module);
+    }
     // beanFullName
     return await this._createBeanInstance<T>(
       record,

package/zova/packages-zova/zova-core/src/composables/useController.ts

@@ -111,6 +111,7 @@ async function _useController(
   }
 
   function isAttemptActive(attemptId: number) {
+    if (ctx.disposed || !ctx.meta) return false;
     return ctx.meta.state.isLoadAttemptActive(attemptId);
   }
 
@@ -133,9 +134,9 @@ async function _useController(
       true,
       false,
       controller => {
+        if (!isAttemptActive(attemptId)) return;
         loadBeans.add(controller as object);
         ctx.meta.state.setLoadBeanAttempt(controller as object, attemptId);
-        if (!isAttemptActive(attemptId)) return;
         ctx.meta.state.setLoadController(controller);
         setLoadBoundaryOptions((controller as any).constructor);
       },
@@ -151,6 +152,7 @@ async function _useController(
         true,
         false,
         style => {
+          if (!isAttemptActive(attemptId)) return;
           loadBeans.add(style as object);
           ctx.meta.state.setLoadBeanAttempt(style as object, attemptId);
         },
@@ -167,6 +169,7 @@ async function _useController(
         true,
         false,
         render => {
+          if (!isAttemptActive(attemptId)) return;
           loadBeans.add(render as object);
           ctx.meta.state.setLoadBeanAttempt(render as object, attemptId);
         },

package/zova/pnpm-lock.yaml

@@ -1019,7 +1019,7 @@ importers:
   src/suite-vendor/a-pay:
     dependencies:
       zova-module-a-pay:
-        specifier: ^5.0.8
+        specifier: ^5.0.9
         version: link:modules/a-pay
       zova-module-pay-mock:
         specifier: ^5.0.5

package/zova/src/suite/a-home/modules/home-indexadmin/src/page/dashboard/controller.tsx

@@ -4,6 +4,37 @@ import { ZPage, ZSiteEntryTables } from 'zova-module-home-base';
 
 @Controller()
 export class ControllerPageDashboard extends BeanControllerPageBase {
+  private _timer?: number;
+  currentTime = '';
+
+  protected __init__() {
+    if (!this.$pageRoute) return;
+    this.$ssr.handleDirectOrOnHydrated(() => {
+      this.currentTime = new Date().toLocaleTimeString();
+      this._timer = window.setInterval(() => {
+        this.currentTime = new Date().toLocaleTimeString();
+      }, 1000);
+    });
+    this.$router.setPageMeta(this.$pageRoute, {
+      onCustomRenderIsolate: () => (
+        <div class="flex w-full items-center justify-center">
+          <div class="badge badge-lg gap-2 border border-primary/30 bg-primary/10 px-4 py-3 text-primary shadow-sm">
+            <span class="h-2 w-2 animate-pulse rounded-full bg-primary" aria-hidden="true"></span>
+            <span class="font-mono text-base font-semibold tracking-wide tabular-nums">
+              {this.currentTime || '--:--:--'}
+            </span>
+          </div>
+        </div>
+      ),
+    });
+  }
+
+  protected __dispose__() {
+    if (this._timer !== undefined) {
+      window.clearInterval(this._timer);
+    }
+  }
+
   protected render() {
     return (
       <ZPage>

package/zova/src/suite/a-home/modules/home-layoutadmin/src/component/layoutAdmin/render.tabs.tsx

@@ -63,6 +63,20 @@ export class RenderTabs extends BeanRenderBase {
     const tabCurrent = $$modelTabs.tabCurrent;
     if (!tabCurrent || !tabCurrent.items) return;
     const tabKey = tabCurrent.tabKey;
+    const tabItemAnchor = tabCurrent.items.find(item => item.componentKey === tabKey);
+    const onCustomRenderIsolate = tabItemAnchor?.pageMeta?.onCustomRenderIsolate;
+    if (onCustomRenderIsolate) {
+      const domContent = onCustomRenderIsolate(tabCurrent);
+      if (!this.$$modelTabs.cache) return domContent;
+      return <ClientOnly>{domContent}</ClientOnly>;
+    }
+    const pageTitleAnchor = tabItemAnchor?.pageMeta?.pageTitle;
+    if (pageTitleAnchor) {
+      const domWrapper = <div class="flex items-center justify-center">{pageTitleAnchor}</div>;
+      if (!this.$$modelTabs.cache) return domWrapper;
+      return <ClientOnly>{domWrapper}</ClientOnly>;
+    }
+
     const domTabs: VNode[] = [];
     for (const tabItem of tabCurrent.items) {
       // ignore first
@@ -70,7 +84,9 @@ export class RenderTabs extends BeanRenderBase {
       const { componentKey, pageMeta } = tabItem;
       const className =
         componentKey === $$modelTabs.componentKeyCurrent ? 'tab-active text-primary' : '';
-      const pageTitle = pageMeta?.pageTitle || '';
+      const pageContent = pageMeta?.onCustomRender
+        ? pageMeta.onCustomRender(tabItem)
+        : pageMeta?.pageTitle || '';
       const tabItemIcon = this.getTabItemIcon(tabItem);
       const domTab = (
         <a
@@ -86,7 +102,7 @@ export class RenderTabs extends BeanRenderBase {
             class="overflow-hidden text-ellipsis whitespace-nowrap"
             style={{ display: 'inline-block', maxWidth: this.scope.config.tabItem.maxWidth }}
           >
-            {pageTitle}
+            {pageContent}
           </div>
           <ZIcon
             class="tab-close hidden hover:bg-slate-400 rounded-sm"

package/zova/src/suite-vendor/a-zova/modules/a-router/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zova-module-a-router",
-  "version": "5.1.39",
+  "version": "5.1.40",
   "gitHead": "09d901d17140a80ee0764211b441cda72fd94663",
   "description": "router",
   "keywords": [

package/zova/src/suite-vendor/a-zova/modules/a-router/src/bean/bean.router.ts

@@ -6,9 +6,10 @@ import type {
   RouterOptions,
 } from '@cabloy/vue-router';
 
-import { BeanBase, TypeEventOff, Use } from 'zova';
+import { BeanBase, Use } from 'zova';
 import { Bean } from 'zova-module-a-bean';
 
+import { RouterGuardDisposers } from '../lib/routerGuardDisposers.js';
 import { BeanRouterViewBase } from '../lib/routerViewBase.js';
 import { ModelPageData } from '../model/pageData.js';
 import { IPageMeta } from '../types/pageMeta.js';
@@ -30,7 +31,7 @@ export interface BeanRouter extends Omit<
 @Bean()
 export class BeanRouter extends BeanBase {
   private _vueRouterApp: Router;
-  private _eventRouterGuards: TypeEventOff[] = [];
+  private _routerGuardDisposers = new RouterGuardDisposers();
   private _routerViews: BeanRouterViewBase[] = [];
   private _disposed = false;
 
@@ -65,16 +66,9 @@ export class BeanRouter extends BeanBase {
   }
 
   public dispose() {
-    this.__dispose__();
-  }
-
-  protected __dispose__() {
     if (this._disposed) return;
     this._disposed = true;
-    for (const fn of this._eventRouterGuards) {
-      fn();
-    }
-    this._eventRouterGuards = [];
+    this._routerGuardDisposers.dispose();
     this._routerViews = [];
     const router = this._vueRouterApp as Router & {
       __prepareNavigation?: (to: unknown) => Promise<void> | void;
@@ -82,6 +76,11 @@ export class BeanRouter extends BeanBase {
     if (router) router.__prepareNavigation = undefined;
   }
 
+  protected __dispose__() {
+    // Router instances can be borrowed through page host providers. Their
+    // creator explicitly calls dispose() when the router itself is finished.
+  }
+
   protected __get__(prop: string) {
     // SymbolRouter first
     const value = this._vueRouterApp?.[prop];
@@ -140,27 +139,19 @@ export class BeanRouter extends BeanBase {
   }
 
   beforeEach(guard: NavigationGuardWithThis<undefined>): () => void {
-    const fn = this._vueRouterApp.beforeEach(guard);
-    this._eventRouterGuards.push(fn);
-    return fn;
+    return this._routerGuardDisposers.add(this._vueRouterApp.beforeEach(guard));
   }
 
   beforeResolve(guard: NavigationGuardWithThis<undefined>): () => void {
-    const fn = this._vueRouterApp.beforeResolve(guard);
-    this._eventRouterGuards.push(fn);
-    return fn;
+    return this._routerGuardDisposers.add(this._vueRouterApp.beforeResolve(guard));
   }
 
   afterEach(guard: NavigationHookAfter): () => void {
-    const fn = this._vueRouterApp.afterEach(guard);
-    this._eventRouterGuards.push(fn);
-    return fn;
+    return this._routerGuardDisposers.add(this._vueRouterApp.afterEach(guard));
   }
 
   onError(handler: TypeErrorListener): () => void {
-    const fn = this._vueRouterApp.onError(handler);
-    this._eventRouterGuards.push(fn);
-    return fn;
+    return this._routerGuardDisposers.add(this._vueRouterApp.onError(handler));
   }
 
   setPageMeta(route: RouteLocationNormalizedLoadedGeneric, pageMeta: IPageMeta) {

package/zova/src/suite-vendor/a-zova/modules/a-router/src/bean/sys.router.ts

@@ -388,6 +388,7 @@ export class SysRouter extends BeanBase {
       routeData = {
         name: routeNameParent,
         path,
+        ...(route.alias ? { alias: route.alias } : {}),
         component: this.createAsyncComponent(layout as any),
         children: [{ ...route, name, path: '', component, meta }],
       };

package/zova/src/suite-vendor/a-zova/modules/a-router/src/lib/routerGuardDisposers.ts

@@ -0,0 +1,19 @@
+export class RouterGuardDisposers {
+  private _disposers: (() => void)[] = [];
+  private _disposed = false;
+
+  add(disposer: () => void) {
+    this._disposers.push(disposer);
+    return disposer;
+  }
+
+  dispose() {
+    if (this._disposed) return;
+    this._disposed = true;
+    const disposers = this._disposers;
+    this._disposers = [];
+    for (const disposer of disposers) {
+      disposer();
+    }
+  }
+}

package/zova/src/suite-vendor/a-zova/modules/a-router/src/monkey.ts

@@ -99,6 +99,7 @@ export class Monkey
     if (this.serviceRouterGuards) {
       this.serviceRouterGuards.dispose();
     }
+    this._beanRouter?.dispose();
   }
 
   async appReady() {

package/zova/src/suite-vendor/a-zova/modules/a-router/src/service/routerGuards.ts

@@ -12,9 +12,18 @@ export class ServiceRouterGuards extends BeanRouterGuardsBase {
     const self = this;
     router.beforeEach(async to => {
       // match path
-      let match = to.matched.find(item => item.aliasOf);
-      if (match) {
-        match = match.aliasOf;
+      const aliasMatch = to.matched.find(item => item.aliasOf);
+      let match = aliasMatch;
+      if (aliasMatch) {
+        match = aliasMatch.aliasOf;
+        // A path-config alias can initially resolve to a componentless placeholder
+        // before its module registers the real layout route. Reload the same path
+        // after loading so the router resolves the newly registered component.
+        if (!match?.components || Object.keys(match.components).length === 0) {
+          const resLoadModule = await this._forceLoadModule(router, match?.name, match?.path);
+          if (resLoadModule && resLoadModule !== true) return resLoadModule;
+          return to.fullPath;
+        }
       } else {
         match = to.matched[to.matched.length - 1];
         // prepareCheck

package/zova/src/suite-vendor/a-zova/modules/a-router/src/types/pageMeta.ts

@@ -1,7 +1,12 @@
-import { IFormMeta } from 'zova-module-a-openapi';
+import type { VNodeChild } from 'vue';
+import type { IFormMeta } from 'zova-module-a-openapi';
+
+import type { IRouteViewRouteItem, IRouteViewTabCurrent } from './routerView.js';
 
 export interface IPageMeta {
   pageTitle?: string;
   pageDirty?: boolean;
   formMeta?: IFormMeta;
+  onCustomRender?: (tabItem: IRouteViewRouteItem) => VNodeChild;
+  onCustomRenderIsolate?: (tabCurrent: IRouteViewTabCurrent) => VNodeChild;
 }

package/zova/src/suite-vendor/a-zova/modules/a-router/src/types/routerView.ts

@@ -14,6 +14,11 @@ export interface IRouteViewRouteItem extends IRouteViewRouteItemBase {
   pageMeta?: IPageMeta;
 }
 
+export interface IRouteViewTabCurrent {
+  tabKey: string;
+  items?: IRouteViewRouteItem[];
+}
+
 export interface IRouteViewRouteMeta extends IRouteViewRouteItemBase {
   tabKey: string;
 }

package/zova/src/suite-vendor/a-zova/modules/a-router/test/lib/routerGuardDisposers.test.ts

@@ -0,0 +1,24 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import { RouterGuardDisposers } from '../../src/lib/routerGuardDisposers.js';
+
+test('router guard disposers release every callback only once', () => {
+  const disposers = new RouterGuardDisposers();
+  const calls: string[] = [];
+
+  const beforeEach = () => calls.push('beforeEach');
+  const beforeResolve = () => calls.push('beforeResolve');
+  const afterEach = () => calls.push('afterEach');
+  const onError = () => calls.push('onError');
+
+  assert.equal(disposers.add(beforeEach), beforeEach);
+  assert.equal(disposers.add(beforeResolve), beforeResolve);
+  assert.equal(disposers.add(afterEach), afterEach);
+  assert.equal(disposers.add(onError), onError);
+
+  disposers.dispose();
+  disposers.dispose();
+
+  assert.deepEqual(calls, ['beforeEach', 'beforeResolve', 'afterEach', 'onError']);
+});

package/zova/src/suite-vendor/a-zova/modules/a-zova/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zova-module-a-zova",
-  "version": "5.1.106",
+  "version": "5.1.107",
   "gitHead": "2c5c19284bab738e492856189acb6fad74b8a7b7",
   "description": "zova",
   "keywords": [
@@ -43,7 +43,7 @@
     "@cabloy/word-utils": "^2.1.14",
     "defu": "^6.1.7",
     "luxon": "^3.7.2",
-    "zova-jsx": "^1.1.90"
+    "zova-jsx": "^1.1.91"
   },
   "devDependencies": {
     "@cabloy/cli": "^3.1.29",

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

@@ -1,6 +1,6 @@
 {
   "name": "zova-suite-a-zova",
-  "version": "5.1.163",
+  "version": "5.1.164",
   "gitHead": "2c5c19284bab738e492856189acb6fad74b8a7b7",
   "description": "zova",
   "license": "MIT",
@@ -22,7 +22,7 @@
     "zova-module-a-meta": "^5.1.22",
     "zova-module-a-model": "^5.1.37",
     "zova-module-a-openapi": "^5.1.54",
-    "zova-module-a-router": "^5.1.39",
+    "zova-module-a-router": "^5.1.40",
     "zova-module-a-routerstack": "^5.1.29",
     "zova-module-a-routertabs": "^5.1.34",
     "zova-module-a-ssr": "^5.1.40",
@@ -31,7 +31,7 @@
     "zova-module-a-style": "^5.1.35",
     "zova-module-a-table": "^5.1.43",
     "zova-module-a-zod": "^5.1.37",
-    "zova-module-a-zova": "^5.1.106"
+    "zova-module-a-zova": "^5.1.107"
   },
   "title": "a-zova"
 }