cabloy 5.1.236 → 5.1.239

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

@@ -1,3 +1,4 @@
+import type { RouteConfig } from '@cabloy/zod-to-openapi';
 import type {
   OpenAPIObject as OpenAPIObject30,
   SchemaObject as SchemaObject30,
@@ -36,6 +37,11 @@ import {
 import { SymbolRequestMappingHandler } from 'vona-module-a-web';
 import { z } from 'zod';
 
+import type {
+  IControllerActionContract,
+  IControllerActionRequest,
+  IGenerateJsonOfControllerActionOptions,
+} from '../types/contract.ts';
 import type { RouteHandlerArgumentMetaDecorator } from '../types/decorator.ts';
 
 const __ArgumentTypes = ['param', 'query', 'body', 'headers', 'fields', 'field', 'files', 'file'];
@@ -180,6 +186,7 @@ export class ServiceOpenapi extends BeanBase {
     moduleName: string,
     controller: Constructable,
     actionKey?: string,
+    options: IGenerateJsonOfControllerActionOptions = {},
   ) {
     // info
     const info = ModuleInfo.parseInfo(moduleName)!;
@@ -193,14 +200,21 @@ export class ServiceOpenapi extends BeanBase {
       SymbolOpenApiOptions,
       controller,
     );
-    if (controllerOpenApiOptions?.exclude) return;
+    if (controllerOpenApiOptions?.exclude && !options.includeExcluded) return;
     // descs
     const descs = Object.getOwnPropertyDescriptors(controller.prototype);
     const actionKeys = actionKey ? [actionKey] : Object.keys(descs);
     for (const actionKey of actionKeys) {
-      const desc = descs[actionKey];
+      let desc = descs[actionKey];
+      if (actionKey && !desc) {
+        let prototype = Object.getPrototypeOf(controller.prototype);
+        while (prototype && !desc) {
+          desc = Object.getOwnPropertyDescriptor(prototype, actionKey)!;
+          prototype = Object.getPrototypeOf(prototype);
+        }
+      }
       if (['constructor'].includes(actionKey)) continue;
-      if (!desc.value || typeof desc.value !== 'function') continue;
+      if (!desc?.value || typeof desc.value !== 'function') continue;
       this._registerControllerAction(
         registry,
         info,
@@ -211,6 +225,7 @@ export class ServiceOpenapi extends BeanBase {
         controllerOpenApiOptions,
         actionKey,
         desc,
+        options,
       );
     }
   }
@@ -225,6 +240,7 @@ export class ServiceOpenapi extends BeanBase {
     controllerOpenApiOptions: IOpenapiOptions | undefined,
     actionKey: string,
     _desc: PropertyDescriptor,
+    options: IGenerateJsonOfControllerActionOptions,
   ) {
     // app
     const app = this.app;
@@ -235,7 +251,7 @@ export class ServiceOpenapi extends BeanBase {
       controller.prototype,
       actionKey,
     );
-    if (actionOpenApiOptions?.exclude) return;
+    if (actionOpenApiOptions?.exclude && !options.includeExcluded) return;
 
     // actionPath/actionMethod
     if (!appMetadata.hasMetadata(SymbolRequestMappingHandler, controller.prototype, actionKey))
@@ -302,12 +318,71 @@ export class ServiceOpenapi extends BeanBase {
     });
   }
 
+  /** Resolve validators in the current context; do not retain across locale changes. */
+  public getControllerActionContract(
+    controller: Constructable,
+    actionKey: string,
+  ): IControllerActionContract {
+    const beanOptions = appResource.getBean(controller);
+    if (!beanOptions) throw new Error('invalid controller');
+    const info = ModuleInfo.parseInfo(beanOptions.module)!;
+    const actionOpenApiOptions = appMetadata.getMetadata<IOpenapiOptions>(
+      SymbolOpenApiOptions,
+      controller.prototype,
+      actionKey,
+    );
+    const controllerOpenApiOptions = appMetadata.getMetadata<IOpenapiOptions>(
+      SymbolOpenApiOptions,
+      controller,
+    );
+    const { request } = this._groupRequestSchemas(
+      info,
+      controller,
+      actionKey,
+      actionOpenApiOptions,
+      controllerOpenApiOptions,
+    );
+    return {
+      request,
+      response: this._getBodySchema(controller, actionKey, actionOpenApiOptions),
+      contentType: actionOpenApiOptions?.contentType || 'application/json',
+      openapiOptions: actionOpenApiOptions,
+      argsMeta: this._getArgsMeta(controller, actionKey) ?? [],
+    };
+  }
+
   private _collectRequest(
     info: ModuleInfo.IModuleInfo,
     controller: Constructable,
     actionKey: string,
     actionOpenApiOptions: IOpenapiOptions | undefined,
     controllerOpenApiOptions: IOpenapiOptions | undefined,
+  ) {
+    const { request: schemas, isUpload } = this._groupRequestSchemas(
+      info,
+      controller,
+      actionKey,
+      actionOpenApiOptions,
+      controllerOpenApiOptions,
+    );
+    const { body, ...request } = schemas;
+    if (!body) return request as RouteConfig['request'];
+    const contentType = isUpload ? 'multipart/form-data' : 'application/json';
+    return {
+      ...request,
+      body: {
+        required: isUpload || !body.safeParse(undefined).success,
+        content: { [contentType]: { schema: body } },
+      },
+    } as RouteConfig['request'];
+  }
+
+  private _groupRequestSchemas(
+    info: ModuleInfo.IModuleInfo,
+    controller: Constructable,
+    actionKey: string,
+    actionOpenApiOptions: IOpenapiOptions | undefined,
+    controllerOpenApiOptions: IOpenapiOptions | undefined,
   ) {
     // meta
     const argsMeta = this._prepareArgsMeta(
@@ -316,12 +391,11 @@ export class ServiceOpenapi extends BeanBase {
       actionOpenApiOptions,
       controllerOpenApiOptions,
     );
-    if (!argsMeta) return;
     // args
     const argsMapWithField: any = {};
     const argsMapIsolate: any = {};
     let isUpload;
-    for (const argMeta of argsMeta) {
+    for (const argMeta of argsMeta ?? []) {
       if (!argMeta) continue;
       if (!__ArgumentTypes.includes(argMeta.type)) continue;
       if (['fields', 'field', 'files', 'file'].includes(argMeta.type)) {
@@ -339,7 +413,7 @@ export class ServiceOpenapi extends BeanBase {
       }
     }
     // request
-    const request: any = {};
+    const request: IControllerActionRequest = {};
     if (isUpload) {
       const schemaObj: any = {};
       // not check argsMapIsolate.fields
@@ -348,16 +422,7 @@ export class ServiceOpenapi extends BeanBase {
       if (argsMapWithField.files) Object.assign(schemaObj, argsMapWithField.files);
       if (argsMapWithField.file) Object.assign(schemaObj, argsMapWithField.file);
       if (argsMapIsolate.files) schemaObj.blobs = argsMapIsolate.files;
-      const schema = z.object(schemaObj);
-      // body
-      request.body = {
-        required: true,
-        content: {
-          'multipart/form-data': {
-            schema,
-          },
-        },
-      };
+      request.body = z.object(schemaObj);
     } else {
       for (const argumentType of __ArgumentTypes) {
         let schema: z.ZodType | undefined = argsMapIsolate[argumentType];
@@ -375,26 +440,12 @@ export class ServiceOpenapi extends BeanBase {
             `Invalid Openapi argument type: ${info.relativeName}:${controller.name}.${actionKey}#${argumentType}`,
           );
         }
-        // record
-        if (argumentType === 'body') {
-          // body
-          request.body = {
-            required: !schema.safeParse(undefined).success,
-            content: {
-              'application/json': {
-                schema,
-              },
-            },
-          };
-        } else {
-          // others
-          const name = argumentType === 'param' ? 'params' : argumentType;
-          request[name] = schema;
-        }
+        const name = argumentType === 'param' ? 'params' : argumentType;
+        request[name] = schema;
       }
     }
 
-    return request;
+    return { request, isUpload: !!isUpload };
   }
 
   private _collectResponses(
@@ -431,14 +482,7 @@ export class ServiceOpenapi extends BeanBase {
     actionOpenApiOptions: IOpenapiOptions | undefined,
     contentType: string,
   ) {
-    // bodySchema
-    let bodySchema: z.ZodType;
-    if (actionOpenApiOptions?.bodySchema) {
-      bodySchema = actionOpenApiOptions.bodySchema;
-    } else {
-      const metaType = appMetadata.getDesignReturntype(controller.prototype, actionKey);
-      bodySchema = $schema(metaType as any);
-    }
+    const bodySchema = this._getBodySchema(controller, actionKey, actionOpenApiOptions);
     // wrapper
     if (contentType !== 'application/json') return bodySchema;
     if (actionOpenApiOptions?.bodySchemaWrapper === false) return bodySchema;
@@ -446,18 +490,33 @@ export class ServiceOpenapi extends BeanBase {
     return wrapper(bodySchema);
   }
 
-  private _prepareArgsMeta(
+  private _getBodySchema(
     controller: Constructable,
     actionKey: string,
     actionOpenApiOptions: IOpenapiOptions | undefined,
-    controllerOpenApiOptions: IOpenapiOptions | undefined,
-  ) {
-    // meta
-    let argsMeta = appMetadata.getMetadata<RouteHandlerArgumentMetaDecorator[]>(
+  ): z.ZodType {
+    if (actionOpenApiOptions?.bodySchema) return actionOpenApiOptions.bodySchema;
+    const metaType = appMetadata.getDesignReturntype(controller.prototype, actionKey);
+    return $schema(metaType as any);
+  }
+
+  private _getArgsMeta(controller: Constructable, actionKey: string) {
+    const argsMeta = appMetadata.getMetadata<RouteHandlerArgumentMetaDecorator[]>(
       SymbolRouteHandlersArgumentsMeta,
       controller.prototype,
       actionKey,
     );
+    return argsMeta?.map(item => item && { ...item, pipes: item.pipes?.slice() });
+  }
+
+  private _prepareArgsMeta(
+    controller: Constructable,
+    actionKey: string,
+    actionOpenApiOptions: IOpenapiOptions | undefined,
+    controllerOpenApiOptions: IOpenapiOptions | undefined,
+  ) {
+    // meta
+    let argsMeta = this._getArgsMeta(controller, actionKey);
     // headers
     const objHeaders = Object.assign(
       {} as any,
@@ -467,7 +526,7 @@ export class ServiceOpenapi extends BeanBase {
     if (isEmptyObject(objHeaders)) return argsMeta;
     // merge
     if (!argsMeta) argsMeta = [];
-    let argHeaders = argsMeta.find(item => item.type === 'headers' && !item.field);
+    let argHeaders = argsMeta.find(item => item?.type === 'headers' && !item.field);
     if (!argHeaders) {
       argHeaders = { type: 'headers', field: undefined, schema: z.object(objHeaders) } as any;
       argsMeta.push(argHeaders!);

package/vona/src/suite-vendor/a-vona/modules/a-openapi/src/types/contract.ts

@@ -0,0 +1,25 @@
+import type { IOpenapiOptions, TypeResponseContentType } from 'vona-module-a-openapiutils';
+import type { z } from 'zod';
+
+import type { RouteHandlerArgumentMetaDecorator } from './decorator.ts';
+
+export interface IControllerActionRequest {
+  params?: z.ZodType;
+  query?: z.ZodType;
+  body?: z.ZodType;
+  headers?: z.ZodType;
+}
+
+export interface IControllerActionContract {
+  request: IControllerActionRequest;
+  /** The controller return validator, without the HTTP response wrapper. */
+  response: z.ZodType;
+  contentType: TypeResponseContentType;
+  openapiOptions?: IOpenapiOptions;
+  /** Copies of the original executor metadata, without synthetic documentation headers. */
+  argsMeta: RouteHandlerArgumentMetaDecorator[];
+}
+
+export interface IGenerateJsonOfControllerActionOptions {
+  includeExcluded?: boolean;
+}

package/vona/src/suite-vendor/a-vona/modules/a-openapi/src/types/index.ts

@@ -1,5 +1,6 @@
 import '@cabloy/zod-query';
 
+export * from './contract.ts';
 export * from './decorator.ts';
 export * from './formMeta.ts';
 export * from './order.ts';

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

@@ -1,6 +1,6 @@
 {
   "name": "vona-module-a-openapiutils",
-  "version": "5.1.22",
+  "version": "5.1.23",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "",
   "keywords": [

package/vona/src/suite-vendor/a-vona/modules/a-openapiutils/src/lib/const/decorator.ts

@@ -2,6 +2,7 @@ export const SymbolRouteHandlersArgumentsMeta = Symbol('SymbolRouteHandlersArgum
 export const SymbolRouteHandlersArgumentsValue = Symbol('SymbolRouteHandlersArgumentsValue');
 
 export const SymbolOpenApiOptions = Symbol('SymbolOpenApiOptions');
+export const SymbolMcpOptions = Symbol('SymbolMcpOptions');
 export const SymbolControllerResource = Symbol('SymbolControllerResource');
 export const SymbolDecoratorRule = Symbol('SymbolDecoratorRule');
 export const SymbolDecoratorDtoOpenapi = Symbol('SymbolDecoratorDtoOpenapi');

package/vona/src/suite-vendor/a-vona/modules/a-openapiutils/src/lib/decorator/index.ts

@@ -1,2 +1,3 @@
 export * from './api.ts';
+export * from './mcp.ts';
 export * from './resource.ts';

package/vona/src/suite-vendor/a-vona/modules/a-openapiutils/src/lib/decorator/mcp.ts

@@ -0,0 +1,28 @@
+import type { MetadataKey } from 'vona';
+
+import { appMetadata } from 'vona';
+
+import type { IMcpToolOptions } from '../../types/api.ts';
+
+import { SymbolMcpOptions } from '../const/decorator.ts';
+
+function tool(options?: Omit<IMcpToolOptions, 'name'>): ClassDecorator & MethodDecorator;
+function tool(options: IMcpToolOptions): MethodDecorator;
+function tool(options: IMcpToolOptions = {}): ClassDecorator & MethodDecorator {
+  return function (target: object, prop?: MetadataKey, descriptor?: PropertyDescriptor) {
+    if (prop === undefined && options.name !== undefined) {
+      throw new Error('mcp.tool name is only valid on a controller action');
+    }
+    // An options object, including an empty one, is the explicit opt-in marker.
+    const metadata = appMetadata.getOwnMetadataMap(
+      true,
+      SymbolMcpOptions,
+      target,
+      prop,
+    ) as IMcpToolOptions;
+    Object.assign(metadata, options);
+    return descriptor;
+  } as ClassDecorator & MethodDecorator;
+}
+
+export const mcp = { tool };

package/vona/src/suite-vendor/a-vona/modules/a-openapiutils/src/types/api.ts

@@ -34,6 +34,14 @@ export interface IOpenapiSchemaObject {
 
 export type TypeSecuritySchemes = Record<string, ((this: VonaApplication) => object) | object>;
 
+export interface IMcpToolOptions {
+  /** A public tool name override, valid only on an action. */
+  name?: string;
+  description?: string | ILocaleMagic;
+  readOnly?: boolean;
+  output?: { pick: string[] };
+}
+
 export interface IOpenapiOptions {
   public?: boolean;
   description?: string | ILocaleMagic;

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

@@ -1,6 +1,6 @@
 {
   "name": "vona-module-a-permission",
-  "version": "5.1.32",
+  "version": "5.1.33",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "",
   "keywords": [

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

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

package/vona/src/suite-vendor/a-vona/modules/a-queue/src/config/config.ts

@@ -4,6 +4,8 @@ import type { VonaApplication } from 'vona';
 export function config(_app: VonaApplication) {
   return {
     worker: {
+      removeOnComplete: { count: 0 },
+      removeOnFail: { count: 0 },
       lockDuration: 30 * 1000,
       maxStalledCount: 1000,
       stalledInterval: 10 * 1000,

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

@@ -1,6 +1,6 @@
 {
   "name": "vona-module-a-ratelimit",
-  "version": "5.1.2",
+  "version": "5.1.3",
   "description": "",
   "keywords": [
     "Vona Module"

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

@@ -34,7 +34,9 @@ export class ServiceRateLimit extends BeanBase {
     const identity = this._getIdentity(policy);
     const identityHash = createHash('sha256').update(identity).digest('base64url');
     const policyName = policy.name ?? `${route.controllerBeanFullName}:${String(route.action)}`;
-    const routeName = `${route.routeMethod}:${route.routePathRaw}`;
+    const routeName = policy.route
+      ? `${policy.route.method}:${policy.route.path}`
+      : `${route.routeMethod}:${route.routePathRaw}`;
     const windowStart = Math.floor(now / policy.windowMs) * policy.windowMs;
     const instanceName = this.ctx.instanceName ?? 'default';
     return [

package/vona/src/suite-vendor/a-vona/modules/a-ratelimit/src/types/rateLimit.ts

@@ -7,6 +7,10 @@ export interface IRateLimitPolicy {
   windowMs: number;
   key: RateLimitKey;
   name?: string;
+  route?: {
+    method: string;
+    path: string;
+  };
   headers: boolean;
 }
 

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

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

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

@@ -1,6 +1,6 @@
 {
   "name": "zova-jsx",
-  "version": "1.1.94",
+  "version": "1.1.95",
   "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.94"
+    "zova-core": "^5.1.95"
   },
   "devDependencies": {
     "clean-package": "^2.2.0",

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

@@ -1,6 +1,6 @@
 {
   "name": "zova",
-  "version": "5.1.176",
+  "version": "5.1.177",
   "gitHead": "2c5c19284bab738e492856189acb6fad74b8a7b7",
   "description": "A vue3 framework with ioc",
   "keywords": [
@@ -45,8 +45,8 @@
     "postpack": "clean-package restore"
   },
   "dependencies": {
-    "zova-core": "^5.1.94",
-    "zova-suite-a-zova": "^5.1.175"
+    "zova-core": "^5.1.95",
+    "zova-suite-a-zova": "^5.1.176"
   },
   "devDependencies": {
     "clean-package": "^2.2.0",

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

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

package/zova/packages-zova/zova-core/src/core/component/locale.ts

@@ -12,6 +12,7 @@ import type {
 import { BeanSimple } from '../../bean/beanSimple.ts';
 import { LocaleModuleNameSeparator } from '../../bean/resource/locale/type.ts';
 import { cast } from '../../types/index.ts';
+import { normalizeLocale } from '../sys/config.ts';
 
 const SymbolLocaleCurrent = Symbol('SymbolLocaleCurrent');
 const SymbolTzCurrent = Symbol('SymbolTzCurrent');
@@ -31,12 +32,11 @@ export class AppLocale extends BeanSimple {
     if (!locale) {
       locale = this.metaCookie.getItem(this.sys.config.locale.storeKey);
     }
-    if (!locale) locale = this.sys.config.locale.default;
-    return locale as keyof ILocaleRecord;
+    return this.normalize(locale);
   }
 
   set current(value: keyof ILocaleRecord | '' | undefined) {
-    if (!value) value = this.sys.config.locale.default;
+    value = this.normalize(value);
     if (this[SymbolLocaleCurrent].value === value) return;
     this[SymbolLocaleCurrent].value = value;
     if (this._cookieEnabled()) {
@@ -44,6 +44,16 @@ export class AppLocale extends BeanSimple {
     }
   }
 
+  public normalize(value: unknown): keyof ILocaleRecord {
+    return normalizeLocale(value, this.sys.config.locale);
+  }
+
+  public getItems(items?: Partial<Record<keyof ILocaleRecord, string>>) {
+    const enabled = this.sys.config.locale.items;
+    if (!items) return enabled;
+    return Object.fromEntries(Object.entries(items).filter(([key]) => Object.hasOwn(enabled, key)));
+  }
+
   private _cookieEnabled() {
     return !process.env.SERVER || cast(this.ctx.meta).$ssr.profileOptions.useCookie;
   }

package/zova/packages-zova/zova-core/src/core/sys/config.ts

@@ -87,7 +87,7 @@ export interface ZovaConfig {
   locale: {
     default: keyof ILocaleRecord;
     storeKey: string;
-    items: Record<keyof ILocaleRecord, string>;
+    items: Partial<Record<keyof ILocaleRecord, string>>;
   };
   tz: {
     storeKey: string;
@@ -105,3 +105,30 @@ export interface ZovaConfig {
 }
 
 export type ZovaConfigOptional = PowerPartial<ZovaConfig>;
+
+export function validateLocaleConfig(locale: ZovaConfig['locale']) {
+  if (!locale?.items || Object.keys(locale.items).length === 0) {
+    throw new Error('config.locale.items must contain at least one enabled locale');
+  }
+  for (const [key, label] of Object.entries(locale.items)) {
+    if (
+      !key ||
+      key.trim().toLowerCase().replaceAll('_', '-') !== key ||
+      typeof label !== 'string'
+    ) {
+      throw new Error(`config.locale.items contains an invalid locale: ${key}`);
+    }
+  }
+  if (!Object.hasOwn(locale.items, locale.default)) {
+    throw new Error('config.locale.default must be an enabled own key of config.locale.items');
+  }
+}
+
+export function normalizeLocale(value: unknown, locale: ZovaConfig['locale']): keyof ILocaleRecord {
+  validateLocaleConfig(locale);
+  const canonical =
+    typeof value === 'string' ? value.trim().toLowerCase().replaceAll('_', '-') : '';
+  return Object.hasOwn(locale.items, canonical)
+    ? (canonical as keyof ILocaleRecord)
+    : locale.default;
+}

package/zova/packages-zova/zova-core/src/core/sys/locale.ts

@@ -36,6 +36,30 @@ export class SysLocale extends AppLocale {
     }
   }
 
+  /** @internal */
+  public _registerProviderLocales(
+    locales: TypeModuleResourceLocales,
+    modules: Record<string, unknown>,
+  ) {
+    if (!locales) return;
+    for (const [locale, resource] of Object.entries(locales)) {
+      const { modules: targets, ...globals } = resource as {
+        modules?: Record<string, Record<string, string>>;
+        [key: string]: unknown;
+      };
+      // Provider envelopes are data, never a message or a provider-owned scope.
+      const strings = Object.fromEntries(
+        Object.entries(globals).filter(([, value]) => typeof value === 'string'),
+      );
+      this.locales[locale] = Object.assign({}, strings, this.locales[locale]);
+      for (const [moduleName, dictionary] of Object.entries(targets ?? {})) {
+        // Membership, not installation: a translated target must remain lazy.
+        if (!Object.hasOwn(modules, moduleName)) continue;
+        this._registerLocale(moduleName, locale, dictionary);
+      }
+    }
+  }
+
   private _registerLocale(moduleName: string, locale: string, moduleLocales: object) {
     // locales
     this.locales[locale] = Object.assign({}, moduleLocales, this.locales[locale]);

package/zova/packages-zova/zova-core/src/core/sys/module.ts

@@ -29,6 +29,7 @@ export class SysModule extends BeanSimple {
   public async initialize(modulesMeta: PluginZovaModulesMeta) {
     this.modulesMeta = modulesMeta;
     await this._loadAllMonkeysAndSyncsAndPreloads();
+    await this._requireAllSpecifics('locale');
     await this._requireAllSpecifics('preload');
     await this._requireAllSpecifics('monkey');
     await this._requireAllSpecifics('sync');
@@ -123,7 +124,8 @@ export class SysModule extends BeanSimple {
         process.env.SERVER ||
         info.capabilities?.monkey ||
         info.capabilities?.sync ||
-        info.capabilities?.preload;
+        info.capabilities?.preload ||
+        info.capabilities?.locale;
       if (shouldLoad) {
         const moduleResource = module.resource as any;
         if (typeof moduleResource === 'function') {
@@ -159,7 +161,7 @@ export class SysModule extends BeanSimple {
     }
   }
 
-  private async _requireAllSpecifics(capabilityName: 'preload' | 'monkey' | 'sync') {
+  private async _requireAllSpecifics(capabilityName: 'locale' | 'preload' | 'monkey' | 'sync') {
     const modulesMeta = this._ensureModulesMeta();
     const moduleNames = modulesMeta.moduleNames.filter(moduleName => {
       const module = modulesMeta.modules[moduleName];
@@ -182,7 +184,10 @@ export class SysModule extends BeanSimple {
       const module = modulesMeta.modules[moduleName];
       const info = module.info;
       const shouldInstall =
-        !info.capabilities?.monkey && !info.capabilities?.sync && !info.capabilities?.preload;
+        !info.capabilities?.locale &&
+        !info.capabilities?.monkey &&
+        !info.capabilities?.sync &&
+        !info.capabilities?.preload;
       if (shouldInstall) {
         await this._install(moduleName, module);
       }
@@ -257,7 +262,14 @@ export class SysModule extends BeanSimple {
   }
 
   private _registerLocales(module: IModule) {
-    this.sys.meta.locale._registerLocales(module.info.relativeName, module.resource.locales);
+    if (module.info.capabilities?.locale) {
+      this.sys.meta.locale._registerProviderLocales(
+        module.resource.localesProvider,
+        this._ensureModulesMeta().modules,
+      );
+    } else {
+      this.sys.meta.locale._registerLocales(module.info.relativeName, module.resource.locales);
+    }
   }
 
   private _registerConstants(module: IModule) {