zova-module-a-action 5.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016-present Zova
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/cli/action/boilerplate/{{sceneName}}.{{beanName}}.tsx_

@@ -0,0 +1,14 @@
+import { BeanBase } from 'zova';
+import { Action, IActionExecute, IDecoratorActionOptions, NextActionExecute } from 'zova-module-a-action';
+import { IJsxRenderContextBase } from 'zova-module-a-openapi';
+
+export type TypeAction<%=argv.beanNameCapitalize%>Result = unknown;
+
+export interface IActionOptions<%=argv.beanNameCapitalize%> extends IDecoratorActionOptions<TypeAction<%=argv.beanNameCapitalize%>Result> {}
+
+@Action<IActionOptions<%=argv.beanNameCapitalize%>>()
+export class Action<%=argv.beanNameCapitalize%> extends BeanBase implements IActionExecute {
+  execute(_options: IActionOptions<%=argv.beanNameCapitalize%>, _renderContext: IJsxRenderContextBase, next: NextActionExecute) {
+    return next();
+  }
+}

package/cli/action/metadata/generate.ts

@@ -0,0 +1,61 @@
+import type { IMetadataCustomGenerateOptions } from '@cabloy/cli';
+import type { IGlobBeanFile } from '@cabloy/module-info';
+
+import { combineResourceName } from '@cabloy/utils';
+import { toUpperCaseFirstChar } from '@cabloy/word-utils';
+import fse from 'fs-extra';
+import path from 'node:path';
+
+import { generateRestIndex } from './utils.ts';
+
+export default async function (options: IMetadataCustomGenerateOptions): Promise<string> {
+  const { globFiles } = options;
+  for (const globFile of globFiles) {
+    if (globFile.isIgnore) continue;
+    // restComponent
+    await generateRestAction(options, globFile);
+  }
+  return '';
+}
+
+async function generateRestAction(options: IMetadataCustomGenerateOptions, globFile: IGlobBeanFile) {
+  const { moduleName, modulePath } = options;
+  const { beanName, beanNameCapitalize, fileNameJS } = globFile;
+  // options
+  const typeOptionsName = `IActionOptions${beanNameCapitalize}`;
+  // import
+  const contentImports: string[] = [];
+  contentImports.push("import type { TypeActionOptionsRest } from 'zova-module-a-action';");
+  contentImports.push(`import type { ${typeOptionsName} } from '../../src/bean/${fileNameJS}';`);
+  // component
+  const componentNamePrefix = 'AA';
+  const componentName = beanName;
+  const componentNameFull = `${componentNamePrefix}${toUpperCaseFirstChar(combineResourceName(componentName, moduleName, true, true))}`;
+  const contentComponent = `export function ${componentNameFull}(
+  _props: TypeActionOptionsRest<${typeOptionsName}>,
+) {
+  return '${moduleName}:${beanName}';
+}`;
+  // content
+  const content = `${contentImports.join('\n')}
+
+${contentComponent}
+`;
+  // output
+  const fileDest = path.join(modulePath, `rest/action/${beanName}.ts`);
+  await fse.outputFile(fileDest, content);
+  // actions
+  const fileComponents = path.join(modulePath, 'rest/actions.ts');
+  let contentComponents = '';
+  if (fse.existsSync(fileComponents)) {
+    contentComponents = (await fse.readFile(fileComponents)).toString();
+  }
+  const exportContent = `export * from './action/${beanName}.js';`;
+  if (!contentComponents.includes(exportContent)) {
+    contentComponents = `${contentComponents}${exportContent}\n`;
+    await fse.outputFile(fileComponents, contentComponents);
+  }
+  // index
+  const exportIndexContent = "export * from './actions.js';";
+  await generateRestIndex(modulePath, exportIndexContent);
+}

package/cli/action/metadata/utils.ts

@@ -0,0 +1,15 @@
+import fse from 'fs-extra';
+import path from 'node:path';
+
+export async function generateRestIndex(modulePath: string, append: string) {
+  // index
+  const fileIndex = path.join(modulePath, 'rest/index.ts');
+  let contentIndex = '';
+  if (fse.existsSync(fileIndex)) {
+    contentIndex = (await fse.readFile(fileIndex)).toString();
+  }
+  if (!contentIndex.includes(append)) {
+    contentIndex = `${contentIndex}${append}\n`;
+    await fse.outputFile(fileIndex, contentIndex);
+  }
+}

package/cli/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../../tsconfig.base",
+  "compilerOptions": {
+    "allowImportingTsExtensions": true,
+    "rewriteRelativeImportExtensions": true,
+    "verbatimModuleSyntax": true
+  }
+}

package/dist/index.js

@@ -0,0 +1,59 @@
+import { BeanInfo, BeanScopeBase, BeanSimple, beanFullNameFromOnionName, cast, createBeanDecorator, deepExtend } from "zova";
+import { Scope } from "zova-module-a-bean";
+//#region src/lib/performAction.ts
+function $performAction(sys, actionName, options, renderContext, next) {
+	if (!next) next = (actionRes) => {
+		return actionRes;
+	};
+	const beanFullName = beanFullNameFromOnionName(actionName, "action");
+	const beanInstance = sys.bean._getBeanSyncOnly(beanFullName);
+	if (beanInstance) return _renderEventActionNormal_inner(beanInstance, options, renderContext, next);
+	return sys.bean._getBean(beanFullName, false).then((beanInstance) => {
+		return _renderEventActionNormal_inner(beanInstance, options, renderContext, next);
+	});
+}
+function _renderEventActionNormal_inner(beanInstance, options, renderContext, next) {
+	const onionOptions = beanInstance.$onionOptions;
+	const props = onionOptions ? deepExtend({}, onionOptions, options) : options ?? {};
+	return beanInstance.execute(props, renderContext, next);
+}
+//#endregion
+//#region src/monkey.ts
+var Monkey = class extends BeanSimple {
+	async beanInit(bean, beanInstance) {
+		const self = this;
+		bean.defineProperty(beanInstance, "$performAction", {
+			enumerable: false,
+			configurable: true,
+			get() {
+				return function(actionName, options, renderContext, next) {
+					renderContext = Object.assign({
+						app: cast(beanInstance).app,
+						ctx: cast(beanInstance).ctx,
+						$host: beanInstance
+					}, renderContext);
+					return $performAction(self.sys, actionName, options, renderContext, next);
+				};
+			}
+		});
+	}
+};
+//#endregion
+//#region src/.metadata/index.ts
+/** monkey: end */
+/** scope: begin */
+var _dec, _dec2, _class;
+var ScopeModuleAAction = (_dec = Scope(), _dec2 = BeanInfo({ module: "a-action" }), _dec(_class = _dec2(_class = class ScopeModuleAAction extends BeanScopeBase {}) || _class) || _class);
+/** scope: end */
+//#endregion
+//#region src/lib/action.ts
+function Action(options) {
+	return createBeanDecorator("action", "sys", true, options);
+}
+//#endregion
+//#region src/types/action.ts
+var SymbolActionResult = Symbol("SymbolActionResult");
+//#endregion
+export { $performAction, Action, Monkey, ScopeModuleAAction, SymbolActionResult };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/lib/performAction.ts","../src/monkey.ts","../src/.metadata/index.ts","../src/lib/action.ts","../src/types/action.ts"],"sourcesContent":["import type { ZovaSys } from 'zova';\nimport type { IJsxRenderContextBase } from 'zova-module-a-openapi';\n\nimport { beanFullNameFromOnionName, deepExtend } from 'zova';\n\nimport type { IActionRecord, SymbolActionResult } from '../types/action.js';\n\nexport function $performAction<T extends keyof IActionRecord>(\n  sys: ZovaSys,\n  actionName: T,\n  options: Partial<IActionRecord[T]> | undefined,\n  renderContext: IJsxRenderContextBase,\n  next?: Function,\n): IActionRecord[T][typeof SymbolActionResult] {\n  if (!next) {\n    next = actionRes => {\n      return actionRes;\n    };\n  }\n  // action\n  const beanFullName = beanFullNameFromOnionName(actionName, 'action');\n  const beanInstance = sys.bean._getBeanSyncOnly(beanFullName);\n  if (beanInstance) {\n    // sync\n    return _renderEventActionNormal_inner(beanInstance, options, renderContext, next);\n  }\n  // async\n  return sys.bean._getBean(beanFullName, false).then(beanInstance => {\n    return _renderEventActionNormal_inner(beanInstance, options, renderContext, next);\n  });\n}\n\nfunction _renderEventActionNormal_inner(beanInstance: any, options: {} | undefined, renderContext: IJsxRenderContextBase, next?: Function) {\n  const onionOptions = beanInstance.$onionOptions;\n  // props\n  const props = onionOptions ? deepExtend({}, onionOptions, options) : (options ?? {});\n  return beanInstance.execute(props, renderContext, next);\n}\n","import type { BeanBase, BeanContainer, IMonkeyBeanInit } from 'zova';\nimport type { IJsxRenderContextBase } from 'zova-module-a-openapi';\n\nimport { BeanSimple, cast } from 'zova';\n\nimport type { IActionRecord } from './types/action.js';\n\nimport { $performAction } from './lib/performAction.js';\n\nexport class Monkey extends BeanSimple implements IMonkeyBeanInit {\n  async beanInit(bean: BeanContainer, beanInstance: BeanBase) {\n    const self = this;\n    bean.defineProperty(beanInstance, '$performAction', {\n      enumerable: false,\n      configurable: true,\n      get() {\n        return function <T extends keyof IActionRecord>(\n          actionName: T,\n          options: Partial<IActionRecord[T]> | undefined,\n          renderContext?: IJsxRenderContextBase,\n          next?: Function,\n        ) {\n          renderContext = Object.assign(\n            {\n              app: cast(beanInstance).app,\n              ctx: cast(beanInstance).ctx,\n              $host: beanInstance,\n            },\n            renderContext,\n          );\n          return $performAction(self.sys, actionName, options, renderContext, next);\n        };\n      },\n    });\n  }\n}\n","// eslint-disable\n/** monkey: begin */\nexport * from '../monkey.js';\n/** monkey: end */\n/** scope: begin */\nimport { BeanScopeBase, type BeanScopeUtil } from 'zova';\nimport { Scope } from 'zova-module-a-bean';\n\n@Scope()\nexport class ScopeModuleAAction extends BeanScopeBase {}\n\nexport interface ScopeModuleAAction {\n  util: BeanScopeUtil;\n}\n\nimport 'zova';\ndeclare module 'zova' {\n  export interface IBeanScopeRecord {\n    'a-action': ScopeModuleAAction;\n  }\n  \n  \n\n  \n\n  \n}\n  \n/** scope: end */\n","import type { PowerPartial } from 'zova';\n\nimport { createBeanDecorator } from 'zova';\n\nimport type { IDecoratorActionOptions } from '../types/action.js';\n\nexport function Action<T extends IDecoratorActionOptions>(options?: PowerPartial<T>): ClassDecorator {\n  return createBeanDecorator('action', 'sys', true, options);\n}\n","import type { OmitNever } from 'zova';\nimport type { ServiceOnion } from 'zova-module-a-bean';\nimport type { IJsxRenderContextBase } from 'zova-module-a-openapi';\n\nexport const SymbolActionResult = Symbol('SymbolActionResult');\n\nexport type TypeActionOptionsRest<T> = Omit<T, typeof SymbolActionResult> & { res?: string };\n\nexport type NextActionExecute = (res?: any) => any | Promise<any>;\n\nexport interface IActionsRecord {}\n\nexport interface IActionRecord {}\n\nexport interface IActionExecute {\n  execute(options: IDecoratorActionOptions, renderContext: IJsxRenderContextBase, next: NextActionExecute): any | Promise<any>;\n}\n\nexport interface IDecoratorActionOptions<Result = any> {\n  [SymbolActionResult]: Result;\n  // res?: string; // need not define here\n}\n\ndeclare module 'zova-module-a-bean' {\n  export interface SysOnion {\n    action: ServiceOnion<IDecoratorActionOptions, keyof IActionRecord>;\n  }\n}\n\ndeclare module 'zova' {\n  export interface ConfigOnions {\n    action: OmitNever<IActionRecord>;\n  }\n\n  export interface IBeanSceneRecord {\n    action: never;\n  }\n}\n"],"mappings":";;;AACA,SAAc,eAAA,KAAsB,YAAY,SAAS,eAAS,MAAA;WAElE,SAAS,cAAA;;;CAKP,MAAK,eAAO,0BAAA,YAAA,SAAA;CACZ,MAAA,eAAa,IAAA,KAAA,iBAAA,aAAA;AACb,KAAA,aAEA,QAAO,+BAAQ,cAAA,SAAA,eAAA,KAAA;AAGf,QAAO,IAAE,KAAA,SAAa,cAAA,MAAA,CAAA,MAAA,iBAAA;AACpB,SAAE,+BAAgB,cAAA,SAAA,eAAA,KAAA;GAClB;;AAEJ,SAAK,+BAAA,cAAA,SAAA,eAAA,MAAA;CACH,MAAM,eAAe,aAAA;CAErB,MAAI,QAAA,eAAc,WAAA,EAAA,EAAA,cAAA,QAAA,GAAA,WAAA,EAAA;AAClB,QAAK,aAAA,QAAA,OAAA,eAAA,KAAA;;;;;CCpBP,MAAQ,SAAC,MAAY,cAAa;;AAElC,OAAO,eAAO,cAAwB,kBAAgB;;GAEhD,cAAI;;AAEH,WAAM,SAAO,YAAQ,SAAW,eAAW,MAAgB;AAC1D,qBAAe,OAAA,OAAe;MAC5B,KAAO,KAAI,aAAA,CAAA;MACZ,KAAA,KAAA,aAAe,CAAY;MAC9B,OAAY;MACZ,EAAA,cAAkB;AACd,YAAE,eAAA,KAAA,KAAA,YAAA,SAAA,eAAA,KAAA;;;GAGP,CAAC;;;;;;;AClBN,IAAG,MAAO,OAAA;AASV,IAAO,sBAAyB,OAAQ,OAAA,EAAA,QAAe,SAAA,EAAA,QAAA,YAEvD,CAAA,EAAA,KAAO,SAAU,MAAA,SAAA,MAAmB,2BAAA,cAAA,GAAA,IAAA,OAAA,IAAA;;;;;ACTpC,QAAS,oBAAoB,UAAQ,OAAK,MAAA,QAAA;;;;ACF1C,IAAa,qBAAmB,OAAK,qBAAA"}

package/dist-cli/action/metadata/generate.js

@@ -0,0 +1,56 @@
+import { combineResourceName } from '@cabloy/utils';
+import { toUpperCaseFirstChar } from '@cabloy/word-utils';
+import fse from 'fs-extra';
+import path from 'node:path';
+import { generateRestIndex } from "./utils.js";
+export default async function (options) {
+    const { globFiles } = options;
+    for (const globFile of globFiles) {
+        if (globFile.isIgnore)
+            continue;
+        // restComponent
+        await generateRestAction(options, globFile);
+    }
+    return '';
+}
+async function generateRestAction(options, globFile) {
+    const { moduleName, modulePath } = options;
+    const { beanName, beanNameCapitalize, fileNameJS } = globFile;
+    // options
+    const typeOptionsName = `IActionOptions${beanNameCapitalize}`;
+    // import
+    const contentImports = [];
+    contentImports.push("import type { TypeActionOptionsRest } from 'zova-module-a-action';");
+    contentImports.push(`import type { ${typeOptionsName} } from '../../src/bean/${fileNameJS}';`);
+    // component
+    const componentNamePrefix = 'AA';
+    const componentName = beanName;
+    const componentNameFull = `${componentNamePrefix}${toUpperCaseFirstChar(combineResourceName(componentName, moduleName, true, true))}`;
+    const contentComponent = `export function ${componentNameFull}(
+  _props: TypeActionOptionsRest<${typeOptionsName}>,
+) {
+  return '${moduleName}:${beanName}';
+}`;
+    // content
+    const content = `${contentImports.join('\n')}
+
+${contentComponent}
+`;
+    // output
+    const fileDest = path.join(modulePath, `rest/action/${beanName}.ts`);
+    await fse.outputFile(fileDest, content);
+    // actions
+    const fileComponents = path.join(modulePath, 'rest/actions.ts');
+    let contentComponents = '';
+    if (fse.existsSync(fileComponents)) {
+        contentComponents = (await fse.readFile(fileComponents)).toString();
+    }
+    const exportContent = `export * from './action/${beanName}.js';`;
+    if (!contentComponents.includes(exportContent)) {
+        contentComponents = `${contentComponents}${exportContent}\n`;
+        await fse.outputFile(fileComponents, contentComponents);
+    }
+    // index
+    const exportIndexContent = "export * from './actions.js';";
+    await generateRestIndex(modulePath, exportIndexContent);
+}

package/dist-cli/action/metadata/utils.js

@@ -0,0 +1,14 @@
+import fse from 'fs-extra';
+import path from 'node:path';
+export async function generateRestIndex(modulePath, append) {
+    // index
+    const fileIndex = path.join(modulePath, 'rest/index.ts');
+    let contentIndex = '';
+    if (fse.existsSync(fileIndex)) {
+        contentIndex = (await fse.readFile(fileIndex)).toString();
+    }
+    if (!contentIndex.includes(append)) {
+        contentIndex = `${contentIndex}${append}\n`;
+        await fse.outputFile(fileIndex, contentIndex);
+    }
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "zova-module-a-action",
+  "version": "5.1.0",
+  "description": "",
+  "keywords": [
+    "Zova Module"
+  ],
+  "author": "",
+  "files": [
+    "cli",
+    "dist",
+    "mock",
+    "src",
+    "icons",
+    "assets",
+    "rest",
+    "dist-cli"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": [
+        "./src/index.ts",
+        "./dist/index.d.ts"
+      ],
+      "default": "./dist/index.js"
+    },
+    "./*": "./*"
+  },
+  "scripts": {
+    "clean": "rimraf dist dist-cli tsconfig.build.tsbuildinfo tsconfig.cli.tsbuildinfo",
+    "tsc:publish": "npm run clean && zova :bin:buildModule --sourcemap && tsc -p tsconfig.cli.json",
+    "prepublishOnly": "npm run tsc:publish",
+    "prepack": "clean-package",
+    "postpack": "clean-package restore && npm run clean"
+  },
+  "title": "a-action",
+  "zovaModule": {
+    "onions": {
+      "action": {
+        "beanGeneral": true,
+        "optionsGlobalInterfaceName": "IDecoratorActionOptions",
+        "optionsGlobalInterfaceFrom": "zova-module-a-action",
+        "boilerplate": "action/boilerplate",
+        "metadataCustom": "action/metadata/generate.ts"
+      }
+    },
+    "capabilities": {
+      "monkey": true
+    },
+    "dependencies": {}
+  },
+  "gitHead": "bf1ceb4582381c74ba41ccf11b89d3b9e7b73628"
+}

package/src/.metadata/index.ts

@@ -0,0 +1,29 @@
+// eslint-disable
+/** monkey: begin */
+export * from '../monkey.js';
+/** monkey: end */
+/** scope: begin */
+import { BeanScopeBase, type BeanScopeUtil } from 'zova';
+import { Scope } from 'zova-module-a-bean';
+
+@Scope()
+export class ScopeModuleAAction extends BeanScopeBase {}
+
+export interface ScopeModuleAAction {
+  util: BeanScopeUtil;
+}
+
+import 'zova';
+declare module 'zova' {
+  export interface IBeanScopeRecord {
+    'a-action': ScopeModuleAAction;
+  }
+  
+  
+
+  
+
+  
+}
+  
+/** scope: end */

package/src/.metadata/this.ts

@@ -0,0 +1,2 @@
+export const __ThisModule__ = 'a-action';
+export { ScopeModuleAAction as ScopeModule } from './index.js';

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './.metadata/index.js';
+export * from './lib/index.js';
+export * from './types/index.js';

package/src/lib/action.ts

@@ -0,0 +1,9 @@
+import type { PowerPartial } from 'zova';
+
+import { createBeanDecorator } from 'zova';
+
+import type { IDecoratorActionOptions } from '../types/action.js';
+
+export function Action<T extends IDecoratorActionOptions>(options?: PowerPartial<T>): ClassDecorator {
+  return createBeanDecorator('action', 'sys', true, options);
+}

package/src/lib/index.ts

@@ -0,0 +1,2 @@
+export * from './action.js';
+export * from './performAction.js';

package/src/lib/performAction.ts

@@ -0,0 +1,38 @@
+import type { ZovaSys } from 'zova';
+import type { IJsxRenderContextBase } from 'zova-module-a-openapi';
+
+import { beanFullNameFromOnionName, deepExtend } from 'zova';
+
+import type { IActionRecord, SymbolActionResult } from '../types/action.js';
+
+export function $performAction<T extends keyof IActionRecord>(
+  sys: ZovaSys,
+  actionName: T,
+  options: Partial<IActionRecord[T]> | undefined,
+  renderContext: IJsxRenderContextBase,
+  next?: Function,
+): IActionRecord[T][typeof SymbolActionResult] {
+  if (!next) {
+    next = actionRes => {
+      return actionRes;
+    };
+  }
+  // action
+  const beanFullName = beanFullNameFromOnionName(actionName, 'action');
+  const beanInstance = sys.bean._getBeanSyncOnly(beanFullName);
+  if (beanInstance) {
+    // sync
+    return _renderEventActionNormal_inner(beanInstance, options, renderContext, next);
+  }
+  // async
+  return sys.bean._getBean(beanFullName, false).then(beanInstance => {
+    return _renderEventActionNormal_inner(beanInstance, options, renderContext, next);
+  });
+}
+
+function _renderEventActionNormal_inner(beanInstance: any, options: {} | undefined, renderContext: IJsxRenderContextBase, next?: Function) {
+  const onionOptions = beanInstance.$onionOptions;
+  // props
+  const props = onionOptions ? deepExtend({}, onionOptions, options) : (options ?? {});
+  return beanInstance.execute(props, renderContext, next);
+}

package/src/monkey.ts

@@ -0,0 +1,36 @@
+import type { BeanBase, BeanContainer, IMonkeyBeanInit } from 'zova';
+import type { IJsxRenderContextBase } from 'zova-module-a-openapi';
+
+import { BeanSimple, cast } from 'zova';
+
+import type { IActionRecord } from './types/action.js';
+
+import { $performAction } from './lib/performAction.js';
+
+export class Monkey extends BeanSimple implements IMonkeyBeanInit {
+  async beanInit(bean: BeanContainer, beanInstance: BeanBase) {
+    const self = this;
+    bean.defineProperty(beanInstance, '$performAction', {
+      enumerable: false,
+      configurable: true,
+      get() {
+        return function <T extends keyof IActionRecord>(
+          actionName: T,
+          options: Partial<IActionRecord[T]> | undefined,
+          renderContext?: IJsxRenderContextBase,
+          next?: Function,
+        ) {
+          renderContext = Object.assign(
+            {
+              app: cast(beanInstance).app,
+              ctx: cast(beanInstance).ctx,
+              $host: beanInstance,
+            },
+            renderContext,
+          );
+          return $performAction(self.sys, actionName, options, renderContext, next);
+        };
+      },
+    });
+  }
+}

package/src/types/action.ts

@@ -0,0 +1,38 @@
+import type { OmitNever } from 'zova';
+import type { ServiceOnion } from 'zova-module-a-bean';
+import type { IJsxRenderContextBase } from 'zova-module-a-openapi';
+
+export const SymbolActionResult = Symbol('SymbolActionResult');
+
+export type TypeActionOptionsRest<T> = Omit<T, typeof SymbolActionResult> & { res?: string };
+
+export type NextActionExecute = (res?: any) => any | Promise<any>;
+
+export interface IActionsRecord {}
+
+export interface IActionRecord {}
+
+export interface IActionExecute {
+  execute(options: IDecoratorActionOptions, renderContext: IJsxRenderContextBase, next: NextActionExecute): any | Promise<any>;
+}
+
+export interface IDecoratorActionOptions<Result = any> {
+  [SymbolActionResult]: Result;
+  // res?: string; // need not define here
+}
+
+declare module 'zova-module-a-bean' {
+  export interface SysOnion {
+    action: ServiceOnion<IDecoratorActionOptions, keyof IActionRecord>;
+  }
+}
+
+declare module 'zova' {
+  export interface ConfigOnions {
+    action: OmitNever<IActionRecord>;
+  }
+
+  export interface IBeanSceneRecord {
+    action: never;
+  }
+}

package/src/types/index.ts

@@ -0,0 +1,2 @@
+export * from './action.js';
+export * from './performAction.js';

package/src/types/performAction.ts

@@ -0,0 +1,15 @@
+import type { IJsxRenderContextBase } from 'zova-module-a-openapi';
+
+import type { IActionRecord, SymbolActionResult } from './action.js';
+import 'zova';
+
+declare module 'zova' {
+  export interface BeanBase {
+    $performAction: <T extends keyof IActionRecord>(
+      actionName: T,
+      options: Partial<IActionRecord[T]> | undefined,
+      renderContext?: IJsxRenderContextBase,
+      next?: Function,
+    ) => IActionRecord[T][typeof SymbolActionResult];
+  }
+}