@ddd-tool/domain-designer-cli 0.0.0-alpha.8 → 0.1.0-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ddd-tool/domain-designer-cli",
-  "version": "0.0.0-alpha.8",
+  "version": "0.1.0-beta.0",
   "private": false,
   "description": "",
   "type": "module",
@@ -27,31 +27,32 @@
   "repository": "https://github.com/ddd-tool/domain-designer-cli-node",
   "license": "Apache-2.0",
   "devDependencies": {
-    "@ddd-tool/domain-designer-core": "0.0.0-alpha.8",
-    "@ddd-tool/domain-designer-ui-component": "0.0.0-alpha.4",
-    "@tsconfig/node22": "^22.0.0",
-    "@types/node": "^22.10.2",
+    "@ddd-tool/domain-designer-core": "0.1.0-beta.1",
+    "@ddd-tool/domain-designer-ui-component": "0.1.0-beta.0",
+    "@primeuix/themes": "^1.0.0",
+    "@types/node": "^22.13.10",
     "@vitejs/plugin-vue": "^5.2.1",
     "@vue/tsconfig": "^0.7.0",
-    "npm-run-all2": "^7.0.1",
+    "esbuild": "^0.24.2",
+    "npm-run-all2": "^7.0.2",
     "primeicons": "^7.0.0",
-    "typescript": "^5.7.2",
-    "vite": "^6.0.3",
+    "primevue": "^4.3.1",
+    "typescript": "^5.8.2",
+    "vite": "^6.2.1",
+    "vite-plugin-top-level-await": "^1.5.0",
     "vue": "^3.5.13",
-    "vue-tsc": "^2.1.10"
-  },
-  "dependencies": {
-    "@primevue/themes": "^4.2.5",
-    "primevue": "^4.2.5"
+    "vue-tsc": "^2.2.8",
+    "zx": "^8.4.0"
   },
   "scripts": {
     "dev": "vite",
-    "build": "run-p build:cli",
-    "build:cli": "run-p verify && zx ./scripts/build-cli.mjs",
     "test": "run-p build:cli && run-p test:fun",
     "test:fun": "vitest",
-    "verify": "tsc -p ./tsconfig.build-cli.json",
-    "demo:init": "node ./bin/domain-designer-cli.cjs init --source=F:/vscode_projects/@ddd-tool/domain-designer-cli-node/demo",
-    "demo:runWeb": "node ./bin/domain-designer-cli.cjs runWeb --source=F:/vscode_projects/@ddd-tool/domain-designer-cli-node/demo"
+    "verify": "tsc -p ./tsconfig.json",
+    "demo:init": "node ./bin/domain-designer-cli.cjs init --source=./demo",
+    "demo:runWeb": "node ./bin/domain-designer-cli.cjs runWeb --source=./demo",
+    "demo:update": "node ./bin/domain-designer-cli.cjs update --source=./demo",
+    "demo:info": "node ./bin/domain-designer-cli.cjs info",
+    "demo:genCode": "node ./bin/domain-designer-cli.cjs genCode --source=./demo"
   }
 }

package/scripts/build-ts.mjs

@@ -0,0 +1,52 @@
+import * as esbuild from 'esbuild'
+import fs from 'fs'
+import path from 'path'
+
+// 获取命令行参数
+const args = process.argv.slice(2) // 从第3个元素开始截取（跳过node和脚本路径）
+// 查找并解析 --source 参数
+let sourcePath = null
+for (const arg of args) {
+  if (arg.startsWith('--source=')) {
+    sourcePath = arg.split('=')[1] // 提取等号后面的值
+    break
+  }
+}
+if (!sourcePath) {
+  throw new Error('missing --source=<path>')
+}
+
+if (
+  !fs.existsSync(path.join(sourcePath, 'node_modules')) ||
+  !fs.statSync(path.join(sourcePath, 'node_modules')).isDirectory() ||
+  fs.existsSync(path.join(sourcePath, 'package.json'))
+) {
+  throw new Error('not a workspace: ' + sourcePath)
+}
+const esmPath = path.resolve(sourcePath, '.output', 'esm')
+if (fs.existsSync(esmPath)) {
+  fs.rmSync(esmPath, { recursive: true, force: true })
+}
+fs.mkdirSync(esmPath, { recursive: true })
+
+const files = fs.readdirSync(sourcePath)
+for (const file of files) {
+  if (file.endsWith('.ts')) {
+    console.log('compile', `${sourcePath.replaceAll('\\', '/')}/${file}`)
+    esbuild.build({
+      bundle: true,
+      entryPoints: [`${sourcePath.replaceAll('\\', '/')}/${file}`],
+      drop: ['debugger'],
+      minify: true,
+      outfile: `${esmPath.replaceAll('\\', '/')}/${file.replace(/\.ts$/, '.mjs')}`,
+      // sourcemap: true,
+      format: 'esm',
+      // format: 'cjs',
+      platform: 'node',
+      plugins: [],
+      target: 'node18',
+      // tsconfig: path.join(__dirname, '..', 'tsconfig.build-cli.json'),
+      tsconfig: path.join(__dirname, '..', 'tsconfig.json'),
+    })
+  }
+}

package/src/views/design-en.ts

@@ -1,16 +1,17 @@
 import { createDomainDesigner } from '@ddd-tool/domain-designer-core'
 
 const d = createDomainDesigner()
+const i = d.info
 
 // user
 const user = d.actor('user', 'order user')
 
 // aggregation
-const userAccount = d.info.field.any('userAccount')
-const orderId = d.info.field.id('orderId')
-const orderTime = d.info.field.time('orderTime')
-const productPrice = d.info.field.num('productPrice')
-const productQuantity = d.info.field.num('productQuantity')
+const userAccount = i.valueObj('userAccount')
+const orderId = i.id('orderId')
+const orderTime = i.valueObj('orderTime')
+const productPrice = i.valueObj('productPrice')
+const productQuantity = i.valueObj('productQuantity')
 const orderAmount = d.info.func('orderAmount', [productPrice, productQuantity])
 const orderAggregation = d.agg(
   'orderAggregation',
@@ -19,10 +20,7 @@ const orderAggregation = d.agg(
 )
 
 // command
-const createOrder = d.command('createOrder', [
-  orderAggregation.inner.orderId,
-  userAccount,
-])
+const createOrder = d.command('createOrder', [orderAggregation.inner.orderId, userAccount])
 const autoDeduct = d.command('autoDeduct', [orderId])
 
 // event
@@ -42,10 +40,7 @@ rule 3:
   `
 )
 // service
-const autoDeductService = d.service(
-  'autoDeductService',
-  'initiate automatic payment based on payment rule'
-)
+const autoDeductService = d.service('autoDeductService', 'initiate automatic payment based on payment rule')
 // external system
 const logisticsSystem = d.system('logisticsSystem')
 const mailSystem = d.system('mailSystem')
@@ -57,9 +52,7 @@ const createOrderFailureWorkflow = d.startWorkflow('createOrderFailure')
 user.command(createOrder).agg(orderAggregation).event(orderFailure)
 orderFailure.system(mailSystem)
 
-const createOrderSuccess_AutoDeductFailureWorkflow = d.startWorkflow(
-  'createOrderSuccess_AutoDeductFailure'
-)
+const createOrderSuccess_AutoDeductFailureWorkflow = d.startWorkflow('createOrderSuccess_AutoDeductFailure')
 user
   .command(createOrder)
   .agg(orderAggregation)
@@ -72,9 +65,7 @@ user
 deductFailure.readModel(orderDetail)
 deductFailure.system(mailSystem)
 
-const createOrderSuccess_AutoDeductSuccessWorkflow = d.startWorkflow(
-  'createOrderSuccess_AutoDeductSuccess'
-)
+const createOrderSuccess_AutoDeductSuccessWorkflow = d.startWorkflow('createOrderSuccess_AutoDeductSuccess')
 user
   .command(createOrder)
   .agg(orderAggregation)
@@ -95,18 +86,14 @@ d.startWorkflow('readModel')
 const userRead = d.actor('user', 'user (read model)')
 userRead.readModel(orderDetail)
 
-d.defineUserStory(
-  'as a mall user, I want to place an order and implement automatic payment to get the goods',
-  [
-    createOrderFailureWorkflow,
-    createOrderSuccess_AutoDeductFailureWorkflow,
-    createOrderSuccess_AutoDeductSuccessWorkflow,
-  ]
-)
+d.defineUserStory('as a mall user, I want to place an order and implement automatic payment to get the goods', [
+  createOrderFailureWorkflow,
+  createOrderSuccess_AutoDeductFailureWorkflow,
+  createOrderSuccess_AutoDeductSuccessWorkflow,
+])
 
-d.defineUserStory(
-  'as a mall user, I want to view the order status, so I can know the order status',
-  [createOrderSuccess_AutoDeductSuccessWorkflow]
-)
+d.defineUserStory('as a mall user, I want to view the order status, so I can know the order status', [
+  createOrderSuccess_AutoDeductSuccessWorkflow,
+])
 
 export default d

package/src/views/design-zh.ts

@@ -1,22 +1,19 @@
 import { createDomainDesigner } from '@ddd-tool/domain-designer-core'
 
 const d = createDomainDesigner()
+const i = d.info
 
 // 用户
 const 用户 = d.actor('用户', '下单用户')
 
 // 聚合
-const 用户账号 = d.info.field.any('用户账号')
-const 订单号 = d.info.field.id('订单号')
-const 下单时间 = d.info.field.time('下单时间')
-const 商品价格 = d.info.field.num('商品价格')
-const 商品数量 = d.info.field.num('商品数量')
+const 用户账号 = i.valueObj('用户账号')
+const 订单号 = i.id('订单号')
+const 下单时间 = i.valueObj('下单时间')
+const 商品价格 = i.valueObj('商品价格')
+const 商品数量 = i.valueObj('商品数量')
 const 订单金额 = d.info.func('订单金额', [商品价格, 商品数量])
-const 订单聚合 = d.agg(
-  '订单聚合',
-  [订单号, 下单时间, 用户账号, 商品价格, 商品数量, 订单金额],
-  '这是订单聚合'
-)
+const 订单聚合 = d.agg('订单聚合', [订单号, 下单时间, 用户账号, 商品价格, 商品数量, 订单金额], '这是订单聚合')
 
 // 命令
 const 创建订单 = d.command('创建订单', [订单聚合.inner.订单号, 用户账号])
@@ -51,8 +48,7 @@ const 创建订单失败流程 = d.startWorkflow('创建订单失败')
 用户.command(创建订单).agg(订单聚合).event(下单失败)
 下单失败.system(邮件系统)
 
-const 创建订单成功_自动扣款失败流程 =
-  d.startWorkflow('创建订单成功，自动扣款失败')
+const 创建订单成功_自动扣款失败流程 = d.startWorkflow('创建订单成功，自动扣款失败')
 用户.command(创建订单)
   .agg(订单聚合)
   .event(下单成功)
@@ -64,8 +60,7 @@ const 创建订单成功_自动扣款失败流程 =
 扣款失败.readModel(订单详情)
 扣款失败.system(邮件系统)
 
-const 创建订单成功_自动扣款成功流程 =
-  d.startWorkflow('创建订单成功，自动扣款成功')
+const 创建订单成功_自动扣款成功流程 = d.startWorkflow('创建订单成功，自动扣款成功')
 用户.command(创建订单)
   .agg(订单聚合)
   .event(下单成功)
@@ -85,17 +80,12 @@ d.startWorkflow('读模型')
 const 用户读 = d.actor('用户', '用户(读模型)')
 用户读.readModel(订单详情)
 
-d.defineUserStory(
-  '作为商城用户，我要下单并且实现自动扣款，以便购得心仪得商品',
-  [
-    创建订单失败流程,
-    创建订单成功_自动扣款失败流程,
-    创建订单成功_自动扣款成功流程,
-  ]
-)
-
-d.defineUserStory('作为商城用户，我要查看订单情况，以便了解订单状态', [
+d.defineUserStory('作为商城用户，我要下单并且实现自动扣款，以便购得心仪得商品', [
+  创建订单失败流程,
+  创建订单成功_自动扣款失败流程,
   创建订单成功_自动扣款成功流程,
 ])
 
+d.defineUserStory('作为商城用户，我要查看订单情况，以便了解订单状态', [创建订单成功_自动扣款成功流程])
+
 export default d

package/src/views/index.ts

@@ -1,7 +1,15 @@
-import type { DomainDesigner } from '@ddd-tool/domain-designer-core'
-const data: Record<string, DomainDesigner> = {
-  '示例': (await import('F:/vscode_projects/@ddd-tool/domain-designer-cli-node/demo/示例')).default,
+import { type DomainDesigner, isDomainDesigner } from '@ddd-tool/domain-designer-core'
+
+const __d1 = (await import('D:/vscode-projects/@ddd-tool/domain-designer-cli-node/demo/example-agg')).default
+const __d2 = (await import('D:/vscode-projects/@ddd-tool/domain-designer-cli-node/demo/example')).default
+
+const data: Record<string, DomainDesigner> = {}
+
+if (isDomainDesigner(__d1)) {
+  data['example-agg'] = __d1
+}
+if (isDomainDesigner(__d2)) {
+  data['example'] = __d2
 }
 
 export default data
-  

package/templates/example-agg.ts

@@ -0,0 +1,31 @@
+// noinspection NonAsciiCharacters
+
+import { DomainDesigner } from '@ddd-tool/domain-designer-core'
+
+// 1.可以将聚合与流程分开定义，避免代码混乱、同时也方便比较、思考各个聚合的内部信息
+// 2.根据规则，只有工作空间根目录中默认导出了一个设计器实例的ts文件
+// `export default <DomainDesigner>`
+// 才会被识别为一个'数据源'。其他文件的内容可以自行编排
+export function createOrderAgg(d: DomainDesigner) {
+  const i = d.info
+  const productPrice = i.valueObj('productPrice', '商品价格')
+  const productQuantity = i.valueObj('productQuantity', '商品数量')
+  return d.agg('orderAgg', [
+    i.id('orderId'),
+    'orderTime',
+    ['userAccount', '用户账号'],
+    productPrice,
+    productQuantity,
+    i.func(
+      'orderAmount',
+      [productPrice, productQuantity],
+      d.note`订单金额 = 商品单价${productPrice} x 商品数量${productQuantity}`
+    ),
+    i.version('updateTime'),
+  ])
+}
+
+export function createOtherAgg(d: DomainDesigner) {
+  const i = d.info
+  return d.agg('otherAgg', ['otherId'])
+}

package/templates/example.ts

@@ -0,0 +1,91 @@
+// noinspection NonAsciiCharacters
+
+import { createDomainDesigner } from '@ddd-tool/domain-designer-core'
+import { createOrderAgg } from './example-agg'
+
+// moduleName 用于在代码生成时指定当前领域的分包名称。
+// 也可以不传参数，会默认为当前文件名，所以文件名为中文的时候要指定一下
+// const d = createDomainDesigner()
+const d = createDomainDesigner({ moduleName: 'order' })
+
+const 商城用户 = d.actor('user', '商城用户')
+
+// 聚合是在另一个ts文件中定义的，我们可以像普通esmodule项目一样正常写 import 和 export
+const 订单聚合 = createOrderAgg(d)
+
+// 下面的代码都是“代码即注释”，写起来、读起来不会有什么困难
+// 需要注意的是：`订单聚合.inner.orderId`的写法并不表示谁依赖谁。
+// 这只是为了在业务复杂的时候，表示“这里的orderId就是订单中的orderId”，原因如下：
+// 1 这样写我们就可以借助ts的编译检查来辅助检查，有一定程度的完备性保证
+// 2 在web端的展示中，相同的字段也能同时得到展示方面的加强（加粗闪烁等）
+// 3 经过实践发现ide的智能提示可以轻松地“聚合.inner.字段”，一路“点”出来，
+// 反而比再敲一遍省事，同时避免重复敲会犯错
+
+const 邮件系统 = d.system('logisticsSystem', '邮件系统')
+const 物流系统 = d.system('mailSystem', '物流系统')
+
+const 创建订单失败流程 = d.startWorkflow('创建订单失败流程')
+const 下单命令 = d.command('createOrderCommand', [订单聚合.inner.orderId, 订单聚合.inner.userAccount])
+const 下单失败事件 = d.event('orderFailedEvent', [订单聚合.inner.orderId, 订单聚合.inner.orderTime])
+商城用户.command(下单命令).agg(订单聚合).event(下单失败事件)
+下单失败事件.system(物流系统)
+
+const 创建订单成功_自动扣款失败流程 = d.startWorkflow('创建订单成功_自动扣款失败流程')
+const 自动扣款命令 = d.command('autoDeductCommand', [订单聚合.inner.orderId])
+const 下单成功事件 = d.event('orderSucceedEvent', [订单聚合.inner.orderId, 订单聚合.inner.orderTime])
+const 自动扣款服务 = d.service('autoDeductService', '根据支付规则进行自动扣款')
+const 支付规则 = d.policy(
+  'paymentPolicy',
+  d.note`
+如果 ${订单聚合.inner.userAccount}启用了自动扣款服务,那么开始自动扣款
+规则 1:
+规则 2:
+规则 3:
+... ...
+`
+)
+const 订单详情读模型 = d.readModel('orderDetailReadModel', [订单聚合.inner.orderId, 订单聚合.inner.orderTime])
+const 扣款失败事件 = d.event('deductFailedEvent', [订单聚合.inner.orderId, 订单聚合.inner.orderTime])
+商城用户
+  .command(下单命令)
+  .agg(订单聚合)
+  .event(下单成功事件)
+  .policy(支付规则)
+  .service(自动扣款服务)
+  .command(自动扣款命令)
+  .agg(订单聚合)
+  .event(扣款失败事件)
+扣款失败事件.readModel(订单详情读模型)
+扣款失败事件.system(物流系统)
+
+const 创建订单成功_自动扣款成功流程 = d.startWorkflow('创建订单成功_自动扣款成功流程')
+const 扣款成功事件 = d.event('deductSucceedEvent', [订单聚合.inner.orderId, 订单聚合.inner.orderTime])
+商城用户
+  .command(下单命令)
+  .agg(订单聚合)
+  .event(下单成功事件)
+  .policy(支付规则)
+  .service(自动扣款服务)
+  .command(自动扣款命令)
+  .agg(订单聚合)
+  .event(扣款成功事件)
+扣款成功事件.readModel(订单详情读模型)
+扣款成功事件.system(邮件系统)
+
+d.startWorkflow('未分类流程')
+商城用户.command(下单命令).agg(订单聚合).event(下单失败事件)
+下单失败事件.system(物流系统)
+
+d.startWorkflow('readModel')
+const userRead = d.actor('user', 'user (read model)')
+userRead.readModel(订单详情读模型)
+
+d.defineUserStory('作为商城用户，我要下单并且实现自动扣款，以便购得心仪得商品', [
+  创建订单失败流程,
+  创建订单成功_自动扣款失败流程,
+  创建订单成功_自动扣款成功流程,
+])
+
+d.defineUserStory('作为商城用户，我要查看订单情况，以便了解订单状态', [创建订单成功_自动扣款成功流程])
+
+export default d

package/templates/node_modules/@ddd-tool/domain-designer-core/actor.d.ts

@@ -1,2 +1,2 @@
-import { DomainDesignActorProvider } from '@ddd-tool/domain-designer-core/define';
+import { DomainDesignActorProvider } from './define';
 export declare function createActorProvider(designId: string): DomainDesignActorProvider;

package/templates/node_modules/@ddd-tool/domain-designer-core/common.d.ts

@@ -1,10 +1,11 @@
-import { NonEmptyArray, DomainDesignAgg, DomainDesignAggProvider, DomainDesignCommand, DomainDesignCommandProvider, DomainDesignDescProvider, DomainDesignEvent, DomainDesignEventProvider, DomainDesignFacadeCommand, DomainDesignFacadeCommandProvider, DomainDesignInfoProvider, DomainDesignActor, DomainDesignActorProvider, DomainDesignPolicy, DomainDesignPolicyProvider, DomainDesignService, DomainDesignServiceProvider, DomainDesignSystem, DomainDesignSystemProvider, DomainDesignReadModel, DomainDesignReadModelProvider, CustomInfoArrayToInfoObject, DomainDesignInfo, DomainDesignInfoType } from '@ddd-tool/domain-designer-core/define';
+import { NonEmptyArray, DomainDesignAgg, DomainDesignAggProvider, DomainDesignCommand, DomainDesignCommandProvider, DomainDesignNoteProvider, DomainDesignEvent, DomainDesignEventProvider, DomainDesignFacadeCommand, DomainDesignFacadeCommandProvider, DomainDesignInfoProvider, DomainDesignActor, DomainDesignActorProvider, DomainDesignPolicy, DomainDesignPolicyProvider, DomainDesignService, DomainDesignServiceProvider, DomainDesignSystem, DomainDesignSystemProvider, DomainDesignReadModel, DomainDesignReadModelProvider, CustomInfoArrayToInfoObject, DomainDesignInfo, DomainDesignInfoType, CustomInfo, DomainDesignOptions, DomainObjectSet, DomainDesignObject } from './define';
 export type LinkType = 'Association' | 'Dependency' | 'Aggregation' | 'Composition';
 type Rule = 'Info' | 'Actor' | 'Command' | 'FacadeCommand' | 'Agg' | 'Event' | 'Policy' | 'Service' | 'System' | 'ReadModel';
 export declare function genId(): string;
 type ContextInitializer = () => {
     id: string;
-    createDesc: DomainDesignDescProvider;
+    options?: DomainDesignOptions;
+    createNote: DomainDesignNoteProvider;
     createInfo: DomainDesignInfoProvider;
     createActor: DomainDesignActorProvider;
     createCommand: DomainDesignCommandProvider;
@@ -20,156 +21,24 @@ export type DomainDesignInternalContext = ReturnType<typeof createInternalContex
 declare function createInternalContext(initFn: ContextInitializer): {
     startWorkflow(name: string): string;
     defineUserStory(name: string, workflowNames: NonEmptyArray<string>): void;
-    linkTo(srcRule: Rule, srcCode: string, targetRule: Rule, targetCode: string, linkType?: LinkType): void;
-    getId(): string;
+    linkTo(srcRule: Rule, srcId: string, targetRule: Rule, targetId: string, linkType?: LinkType): void;
+    getDesignerId(): string;
+    getModuleName(): string;
     getWorkflows(): Record<string, string[]>;
     getUserStories(): Record<string, string[]>;
     getLinks(): Record<string, LinkType>;
-    getIdMap(): Record<string, object>;
-    getCommands(): Readonly<{
-        readonly _attributes: {
-            __code: string;
-            rule: "Command";
-            name: string;
-            infos: any;
-            description?: Readonly<{
-                readonly _attributes: {
-                    rule: "Desc";
-                    readonly template: TemplateStringsArray;
-                    readonly values: import("@ddd-tool/domain-designer-core/define").DomainDesignDescValue[];
-                };
-            }> | undefined;
-        };
-        inner: any;
-        agg<AGG extends DomainDesignAgg<any>>(agg: AGG): AGG;
-        agg<G_NAME extends string, ARR extends NonEmptyArray<DomainDesignInfo<DomainDesignInfoType, G_NAME> | G_NAME>>(name: string, agg: ARR, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc): DomainDesignAgg<CustomInfoArrayToInfoObject<ARR>>;
-    }>[];
-    getFacadeCommands(): Readonly<{
-        readonly _attributes: {
-            __code: string;
-            rule: "FacadeCommand";
-            name: string;
-            infos: any;
-            description?: Readonly<{
-                readonly _attributes: {
-                    rule: "Desc";
-                    readonly template: TemplateStringsArray;
-                    readonly values: import("@ddd-tool/domain-designer-core/define").DomainDesignDescValue[];
-                };
-            }> | undefined;
-        };
-        inner: any;
-        agg<AGG extends DomainDesignAgg<any>>(agg: AGG): AGG;
-        agg<G_NAME extends string, ARR extends NonEmptyArray<DomainDesignInfo<DomainDesignInfoType, G_NAME> | G_NAME>>(name: string, agg: ARR, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc): DomainDesignAgg<CustomInfoArrayToInfoObject<ARR>>;
-        service(service: DomainDesignService): DomainDesignService;
-        service(name: string, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc): DomainDesignService;
-    }>[];
-    getActors(): Readonly<{
-        readonly _attributes: {
-            __code: string;
-            rule: "Actor";
-            name: string;
-            description?: import("@ddd-tool/domain-designer-core/define").DomainDesignDesc;
-        };
-        command<COMMAND extends DomainDesignCommand<any>>(command: COMMAND): COMMAND;
-        command<G_NAME extends string, ARR extends NonEmptyArray<DomainDesignInfo<DomainDesignInfoType, G_NAME> | G_NAME>>(name: string, infos: ARR, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc): DomainDesignCommand<CustomInfoArrayToInfoObject<ARR>>;
-        facadeCmd<FACADECMD extends DomainDesignFacadeCommand<any>>(command: FACADECMD): FACADECMD;
-        facadeCmd<G_NAME extends string, ARR extends NonEmptyArray<DomainDesignInfo<DomainDesignInfoType, G_NAME> | G_NAME>>(name: string, infos: ARR, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc): DomainDesignFacadeCommand<CustomInfoArrayToInfoObject<ARR>>;
-        readModel<READ_MODEL extends DomainDesignReadModel<any>>(readModel: READ_MODEL): READ_MODEL;
-        readModel<G_NAME extends string, ARR extends NonEmptyArray<DomainDesignInfo<DomainDesignInfoType, G_NAME> | G_NAME>>(name: string, infos: ARR | import("@ddd-tool/domain-designer-core/define").NonEmptyInitFunc<() => ARR>): DomainDesignReadModel<CustomInfoArrayToInfoObject<ARR>>;
-    }>[];
-    getEvents(): Readonly<{
-        readonly _attributes: {
-            __code: string;
-            rule: "Event";
-            name: string;
-            infos: any;
-            description?: Readonly<{
-                readonly _attributes: {
-                    rule: "Desc";
-                    readonly template: TemplateStringsArray;
-                    readonly values: import("@ddd-tool/domain-designer-core/define").DomainDesignDescValue[];
-                };
-            }> | undefined;
-        };
-        inner: any;
-        policy(policy: DomainDesignPolicy): DomainDesignPolicy;
-        policy(name: string, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc): DomainDesignPolicy;
-        system(system: DomainDesignSystem): DomainDesignSystem;
-        system(name: string, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc): DomainDesignSystem;
-        readModel<READ_MODEL extends DomainDesignReadModel<any>>(readModel: READ_MODEL): READ_MODEL;
-        readModel<G_NAME extends string, ARR extends NonEmptyArray<DomainDesignInfo<DomainDesignInfoType, G_NAME> | G_NAME>>(name: string, infos: ARR | import("@ddd-tool/domain-designer-core/define").NonEmptyInitFunc<() => ARR>): DomainDesignReadModel<CustomInfoArrayToInfoObject<ARR>>;
-    }>[];
-    getPolicies(): Readonly<{
-        readonly _attributes: {
-            __code: string;
-            rule: "Policy";
-            name: string;
-            description?: import("@ddd-tool/domain-designer-core/define").DomainDesignDesc;
-        };
-        service(service: DomainDesignService): DomainDesignService;
-        service(name: string, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc): DomainDesignService;
-    }>[];
-    getServices(): Readonly<{
-        readonly _attributes: {
-            __code: string;
-            rule: "Service";
-            name: string;
-            description?: import("@ddd-tool/domain-designer-core/define").DomainDesignDesc;
-        };
-        command<COMMAND extends DomainDesignCommand<any>>(command: COMMAND): COMMAND;
-        command<G_NAME extends string, ARR extends NonEmptyArray<DomainDesignInfo<DomainDesignInfoType, G_NAME> | G_NAME>>(name: string, infos: ARR, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc): DomainDesignCommand<CustomInfoArrayToInfoObject<ARR>>;
-        facadeCmd<FACADECMD extends DomainDesignFacadeCommand<any>>(facadeCmd: FACADECMD): FACADECMD;
-        facadeCmd<G_NAME extends string, ARR extends NonEmptyArray<DomainDesignInfo<DomainDesignInfoType, G_NAME> | G_NAME>>(name: string, infos: ARR, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc): DomainDesignFacadeCommand<CustomInfoArrayToInfoObject<ARR>>;
-        agg<AGG extends DomainDesignAgg<any>>(agg: AGG): AGG;
-        agg<G_NAME extends string, ARR extends NonEmptyArray<DomainDesignInfo<DomainDesignInfoType, G_NAME> | G_NAME>>(name: string, agg: ARR, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc): DomainDesignAgg<CustomInfoArrayToInfoObject<ARR>>;
-    }>[];
-    getSystems(): Readonly<{
-        readonly _attributes: {
-            __code: string;
-            rule: "System";
-            name: string;
-            description?: import("@ddd-tool/domain-designer-core/define").DomainDesignDesc;
-        };
-        command<COMMAND extends DomainDesignCommand<any>>(command: COMMAND): COMMAND;
-        command<G_NAME extends string, ARR extends NonEmptyArray<DomainDesignInfo<DomainDesignInfoType, G_NAME> | G_NAME>>(name: string, infos: ARR, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc): DomainDesignCommand<CustomInfoArrayToInfoObject<ARR>>;
-        facadeCmd<FACADECMD extends DomainDesignFacadeCommand<any>>(facadeCmd: FACADECMD): FACADECMD;
-        facadeCmd<G_NAME extends string, ARR extends NonEmptyArray<DomainDesignInfo<DomainDesignInfoType, G_NAME> | G_NAME>>(name: string, infos: ARR, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc): DomainDesignFacadeCommand<CustomInfoArrayToInfoObject<ARR>>;
-    }>[];
-    getAggs(): Readonly<{
-        readonly _attributes: {
-            __code: string;
-            rule: "Agg";
-            name: string;
-            infos: any;
-            description?: Readonly<{
-                readonly _attributes: {
-                    rule: "Desc";
-                    readonly template: TemplateStringsArray;
-                    readonly values: import("@ddd-tool/domain-designer-core/define").DomainDesignDescValue[];
-                };
-            }> | undefined;
-        };
-        inner: any;
-        event<EVENT extends DomainDesignEvent<any>>(event: EVENT): EVENT;
-        event<G_NAME extends string, ARR extends NonEmptyArray<DomainDesignInfo<DomainDesignInfoType, G_NAME> | G_NAME>>(name: string, infos: ARR, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc): DomainDesignEvent<CustomInfoArrayToInfoObject<ARR>>;
-    }>[];
-    getReadModels(): Readonly<{
-        readonly _attributes: {
-            __code: string;
-            rule: "ReadModel";
-            name: string;
-            infos: any;
-            description?: Readonly<{
-                readonly _attributes: {
-                    rule: "Desc";
-                    readonly template: TemplateStringsArray;
-                    readonly values: import("@ddd-tool/domain-designer-core/define").DomainDesignDescValue[];
-                };
-            }> | undefined;
-        };
-        inner: any;
-    }>[];
+    getIdMap(): Record<string, DomainDesignObject>;
+    getAssociationMap(): Record<string, DomainObjectSet<DomainDesignObject>>;
+    getCommands(): DomainDesignCommand<any>[];
+    getFacadeCommands(): DomainDesignFacadeCommand<any>[];
+    getActors(): DomainDesignActor[];
+    getEvents(): DomainDesignEvent<any>[];
+    getPolicies(): DomainDesignPolicy[];
+    getServices(): DomainDesignService[];
+    getSystems(): DomainDesignSystem[];
+    getAggs(): DomainDesignAgg<any>[];
+    getReadModels(): DomainDesignReadModel<any>[];
+    registerInfo(info: DomainDesignInfo<any, any>): void;
     registerCommand(command: DomainDesignCommand<any>): void;
     registerFacadeCommand(command: DomainDesignFacadeCommand<any>): void;
     registerActor(actor: DomainDesignActor): void;
@@ -179,13 +48,22 @@ declare function createInternalContext(initFn: ContextInitializer): {
     registerSystem(system: DomainDesignSystem): void;
     registerAgg(agg: DomainDesignAgg<any>): void;
     registerReadModel(readModel: DomainDesignReadModel<any>): void;
-    customInfoArrToInfoObj<G_NAME extends string, ARR extends NonEmptyArray<DomainDesignInfo<any, G_NAME> | G_NAME>>(arr: ARR): CustomInfoArrayToInfoObject<ARR>;
-    createDesc: DomainDesignDescProvider;
+    customInfoArrToInfoObj<G_NAME extends string, ARR extends NonEmptyArray<CustomInfo<G_NAME>>>(arr: ARR): CustomInfoArrayToInfoObject<ARR>;
+    customInfoArrToInfoArr<G_NAME extends string, ARR extends NonEmptyArray<CustomInfo<G_NAME>>>(arr: ARR): DomainDesignInfo<DomainDesignInfoType, string>[];
+    toFormat<OBJ extends {
+        _attributes: {
+            __id: string;
+            name: string;
+        };
+    }>(obj: OBJ): string;
+    createNote: DomainDesignNoteProvider;
     info: {
-        any: <NAME extends string>(name: NAME, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc) => DomainDesignInfo<"Any", NAME>;
-        entity: <NAME extends string, ARR extends Array<DomainDesignInfo<DomainDesignInfoType, string> | string>>(name: NAME, infos?: ARR, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc) => DomainDesignInfo<"Entity", NAME>;
-        func: <NAME extends string>(name: NAME, dependsOn: NonEmptyArray<import("@ddd-tool/domain-designer-core/define").DomainDesignInfoFuncDependsOn | string>, desc?: string | import("@ddd-tool/domain-designer-core/define").DomainDesignDesc) => DomainDesignInfo<"Function", NAME>;
-        field: import("@ddd-tool/domain-designer-core/define").DomainDesignInfoFieldProvider;
+        document<NAME extends string>(name: NAME, note?: string | import("./define").DomainDesignNote): DomainDesignInfo<"Document", NAME>;
+        func<NAME extends string>(name: NAME, note?: string | import("./define").DomainDesignNote): DomainDesignInfo<"Function", NAME>;
+        func<NAME extends string>(name: NAME, dependsOn: NonEmptyArray<import("./define").DomainDesignInfoFuncDependsOn | string | [string, string | import("./define").DomainDesignNote]>, note?: string | import("./define").DomainDesignNote): DomainDesignInfo<"Function", NAME>;
+        id<NAME extends string>(name: NAME, note?: string | import("./define").DomainDesignNote): DomainDesignInfo<"Id", NAME>;
+        valueObj<NAME extends string>(name: NAME, note?: string | import("./define").DomainDesignNote): DomainDesignInfo<"ValueObject", NAME>;
+        version<NAME extends string>(name: NAME, note?: string | import("./define").DomainDesignNote): DomainDesignInfo<"Version", NAME>;
     };
     createPersion: DomainDesignActorProvider;
     createCommand: DomainDesignCommandProvider;