@nocobase/plugin-workflow-loop 0.17.0-alpha.4

package/client.d.ts

@@ -0,0 +1,2 @@
+export * from './dist/client';
+export { default } from './dist/client';

package/client.js

@@ -0,0 +1 @@
+module.exports = require('./dist/client/index.js');

package/dist/client/LoopInstruction.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+import { VariableOption, WorkflowVariableInput, Instruction } from '@nocobase/plugin-workflow/client';
+export default class extends Instruction {
+    title: string;
+    type: string;
+    group: string;
+    description: string;
+    fieldset: {
+        target: {
+            type: string;
+            title: string;
+            description: string;
+            'x-decorator': string;
+            'x-component': string;
+            'x-component-props': {
+                changeOnSelect: boolean;
+                useTypedConstant: string[];
+                className: string;
+            };
+            required: boolean;
+        };
+    };
+    components: {
+        WorkflowVariableInput: typeof WorkflowVariableInput;
+    };
+    Component({ data }: {
+        data: any;
+    }): React.JSX.Element;
+    useScopeVariables(node: any, options: any): VariableOption[];
+}

package/dist/client/index.d.ts

@@ -0,0 +1,6 @@
+import { Plugin } from '@nocobase/client';
+export default class extends Plugin {
+    afterAdd(): Promise<void>;
+    beforeLoad(): Promise<void>;
+    load(): Promise<void>;
+}

package/dist/client/index.js

@@ -0,0 +1,13 @@
+(function(n,e){typeof exports=="object"&&typeof module!="undefined"?e(exports,require("@nocobase/client"),require("react/jsx-runtime"),require("@ant-design/icons"),require("@nocobase/plugin-workflow/client"),require("react-i18next")):typeof define=="function"&&define.amd?define(["exports","@nocobase/client","react/jsx-runtime","@ant-design/icons","@nocobase/plugin-workflow/client","react-i18next"],e):(n=typeof globalThis!="undefined"?globalThis:n||self,e(n["@nocobase/plugin-workflow-loop"]={},n["@nocobase/client"],n.jsxRuntime,n["@ant-design/icons"],n["@nocobase/plugin-workflow"],n["react-i18next"]))})(this,function(n,e,o,v,s,k){"use strict";var V=Object.defineProperty,W=Object.defineProperties;var P=Object.getOwnPropertyDescriptors;var O=Object.getOwnPropertySymbols;var F=Object.prototype.hasOwnProperty,M=Object.prototype.propertyIsEnumerable;var I=(n,e,o)=>e in n?V(n,e,{enumerable:!0,configurable:!0,writable:!0,value:o}):n[e]=o,N=(n,e)=>{for(var o in e||(e={}))F.call(e,o)&&I(n,o,e[o]);if(O)for(var o of O(e))M.call(e,o)&&I(n,o,e[o]);return n},T=(n,e)=>W(n,P(e));var g=(n,e,o)=>(I(n,typeof e!="symbol"?e+"":e,o),o);var y=(n,e,o)=>new Promise((v,s)=>{var k=i=>{try{d(o.next(i))}catch(w){s(w)}},u=i=>{try{d(o.throw(i))}catch(w){s(w)}},d=i=>i.done?v(i.value):Promise.resolve(i.value).then(k,u);d((o=o.apply(n,e)).next())});const u="workflow-loop";function d(p,f={}){const{t}=i(f);return t(p)}function i(p){return k.useTranslation(u,p)}function w(p,f){let t=p,h=null;for(let a=0;a<f.length;a++){const c=f[a],r=t.find(m=>m.value===c);if(!r)return null;h=r,!r.isLeaf&&r.loadChildren&&r.loadChildren(r),r.children&&(t=r.children)}return h}class j extends s.Instruction{constructor(){super(...arguments);g(this,"title",`{{t("Loop", { ns: "${u}" })}}`);g(this,"type","loop");g(this,"group","control");g(this,"description",`{{t("By using a loop node, you can perform the same operation on multiple sets of data. The source of these sets can be either multiple records from a query node or multiple associated records of a single record. Loop node can also be used for iterating a certain number of times or for looping through each character in a string. However, excessive looping may cause performance issues, so use with caution.", { ns: "${u}" })}}`);g(this,"fieldset",{target:{type:"string",title:`{{t("Loop target", { ns: "${u}" })}}`,description:`{{t("A single number will be treated as a loop count, a single string will be treated as an array of characters, and other non-array values will be converted to arrays. The loop node ends when the loop count is reached, or when the array loop is completed. You can also add condition nodes to the loop to terminate it.", { ns: "${u}" })}}`,"x-decorator":"FormItem","x-component":"WorkflowVariableInput","x-component-props":{changeOnSelect:!0,useTypedConstant:["string","number","null"],className:e.css`
+          width: 100%;
+
+          .variable {
+            flex: 1;
+          }
+
+          .ant-input.null-value {
+            width: 100%;
+          }
+        `},required:!0}});g(this,"components",{WorkflowVariableInput:s.WorkflowVariableInput})}Component({data:t}){var r;const{nodes:h}=s.useFlowContext(),{styles:a}=s.useStyles(),c=h.find(m=>m.upstreamId===t.id&&m.branchIndex!=null);return o.jsx(s.NodeDefaultView,{data:t,children:o.jsx("div",{className:a.nodeSubtreeClass,children:o.jsxs("div",{className:e.cx(a.branchBlockClass,e.css`
+                padding-left: 20em;
+              `),children:[o.jsx(s.Branch,{from:t,entry:c,branchIndex:(r=c==null?void 0:c.branchIndex)!=null?r:0}),o.jsxs("div",{className:a.branchClass,children:[o.jsx("div",{className:"workflow-branch-lines"}),o.jsx("div",{className:e.cx(a.addButtonClass,a.loopLineClass),children:o.jsx(v.ArrowUpOutlined,{})})]})]})})})}useScopeVariables(t,h){const a=e.useCompile(),c=d("Loop target"),r=d("Loop index"),m=d("Loop length"),{target:x}=t.config;if(!x)return null;const{fieldNames:l=s.defaultFieldNames}=h;let L={key:"item",[l.value]:"item",[l.label]:c};if(typeof x=="string"&&x.startsWith("{{")&&x.endsWith("}}")){const S=x.slice(2,-2).split(".").map(b=>b.trim()),A=[s.scopeOptions,s.nodesOptions,s.triggerOptions].map(b=>{const C=b.useOptions(T(N({},h),{current:t})).filter(Boolean);return{[l.label]:a(b.label),[l.value]:b.value,key:b.value,[l.children]:C,disabled:C&&!C.length}}),B=w(A,S);L=Object.assign({},B,L)}return[L,{key:"index",[l.value]:"index",[l.label]:r},{key:"length",[l.value]:"length",[l.label]:m}]}}class q extends e.Plugin{afterAdd(){return y(this,null,function*(){})}beforeLoad(){return y(this,null,function*(){})}load(){return y(this,null,function*(){const f=this.app.pm.get("workflow"),t=new j;f.instructions.register(t.type,t)})}}n.default=q,Object.defineProperties(n,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})});

package/dist/externalVersion.js

@@ -0,0 +1,8 @@
+module.exports = {
+  "react": "18.2.0",
+  "@ant-design/icons": "5.1.4",
+  "@nocobase/client": "0.17.0-alpha.4",
+  "@nocobase/plugin-workflow": "0.17.0-alpha.4",
+  "react-i18next": "11.18.6",
+  "@nocobase/server": "0.17.0-alpha.4"
+};

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './server';
+export { default } from './server';

package/dist/index.js

@@ -0,0 +1,39 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var src_exports = {};
+__export(src_exports, {
+  default: () => import_server.default
+});
+module.exports = __toCommonJS(src_exports);
+__reExport(src_exports, require("./server"), module.exports);
+var import_server = __toESM(require("./server"));
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./server")
+});

package/dist/locale/en-US.json

@@ -0,0 +1,9 @@
+{
+  "Loop": "Loop",
+  "Loop target": "Loop target",
+  "Loop index": "Loop index",
+  "Loop length": "Loop length",
+  "By using a loop node, you can perform the same operation on multiple sets of data. The source of these sets can be either multiple records from a query node or multiple associated records of a single record. Loop node can also be used for iterating a certain number of times or for looping through each character in a string. However, excessive looping may cause performance issues, so use with caution.": "By using a loop node, you can perform the same operation on multiple sets of data. The source of these sets can be either multiple records from a query node or multiple associated records of a single record. Loop node can also be used for iterating a certain number of times or for looping through each character in a string. However, excessive looping may cause performance issues, so use with caution.",
+  "Scope variables": "Scope variables",
+  "A single number will be treated as a loop count, a single string will be treated as an array of characters, and other non-array values will be converted to arrays. The loop node ends when the loop count is reached, or when the array loop is completed. You can also add condition nodes to the loop to terminate it.": "A single number will be treated as a loop count, a single string will be treated as an array of characters, and other non-array values will be converted to arrays. The loop node ends when the loop count is reached, or when the array loop is completed. You can also add condition nodes to the loop to terminate it."
+}

package/dist/locale/index.d.ts

@@ -0,0 +1,3 @@
+export declare const NAMESPACE = "workflow-loop";
+export declare function useLang(key: string, options?: {}): string;
+export declare function usePluginTranslation(options: any): import("react-i18next").UseTranslationResponse<"workflow-loop", undefined>;

package/dist/locale/index.js

@@ -0,0 +1,39 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var locale_exports = {};
+__export(locale_exports, {
+  NAMESPACE: () => NAMESPACE,
+  useLang: () => useLang,
+  usePluginTranslation: () => usePluginTranslation
+});
+module.exports = __toCommonJS(locale_exports);
+var import_react_i18next = require("react-i18next");
+const NAMESPACE = "workflow-loop";
+function useLang(key, options = {}) {
+  const { t } = usePluginTranslation(options);
+  return t(key);
+}
+function usePluginTranslation(options) {
+  return (0, import_react_i18next.useTranslation)(NAMESPACE, options);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NAMESPACE,
+  useLang,
+  usePluginTranslation
+});

package/dist/locale/zh-CN.json

@@ -0,0 +1,9 @@
+{
+  "Loop": "循环",
+  "Loop target": "循环对象",
+  "Loop index": "当前索引",
+  "Loop length": "循环长度",
+  "By using a loop node, you can perform the same operation on multiple sets of data. The source of these sets can be either multiple records from a query node or multiple associated records of a single record. Loop node can also be used for iterating a certain number of times or for looping through each character in a string. However, excessive looping may cause performance issues, so use with caution.": "使用循环节点可以对多条数据进行同样的操作，多条数据的来源可以是查询节点的多条结果，或者一条数据的多条关系数据。也可以用于一定次数的循环，或者对字符串中每一个字符的循环处理。循环次数过高可能引起性能问题，请谨慎使用。",
+  "Scope variables": "局域变量",
+  "A single number will be treated as a loop count, a single string will be treated as an array of characters, and other non-array values will be converted to arrays. The loop node ends when the loop count is reached, or when the array loop is completed. You can also add condition nodes to the loop to terminate it.": "单一数字值将被视为循环次数，单一字符串值将被视为字符数组，其他非数组值将被转换为数组。达到循环次数，或者将数组循环完成后，循环节点结束。你也可以在循环中添加条件节点，以终止循环。"
+}

package/dist/server/LoopInstruction.d.ts

@@ -0,0 +1,13 @@
+import { Processor, Instruction, FlowNodeModel, JobModel } from '@nocobase/plugin-workflow';
+export default class extends Instruction {
+    run(node: FlowNodeModel, prevJob: JobModel, processor: Processor): Promise<{
+        status: number;
+        result: number;
+    }>;
+    resume(node: FlowNodeModel, branchJob: any, processor: Processor): Promise<any>;
+    getScope(node: any, index: any, processor: any): {
+        item: any;
+        index: any;
+        length: number;
+    };
+}

package/dist/server/LoopInstruction.js

@@ -0,0 +1,94 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var LoopInstruction_exports = {};
+__export(LoopInstruction_exports, {
+  default: () => LoopInstruction_default
+});
+module.exports = __toCommonJS(LoopInstruction_exports);
+var import_plugin_workflow = require("@nocobase/plugin-workflow");
+function getTargetLength(target) {
+  let length = 0;
+  if (typeof target === "number") {
+    if (target < 0) {
+      throw new Error("Loop target in number type must be greater than 0");
+    }
+    length = Math.floor(target);
+  } else {
+    const targets = (Array.isArray(target) ? target : [target]).filter((t) => t != null);
+    length = targets.length;
+  }
+  return length;
+}
+class LoopInstruction_default extends import_plugin_workflow.Instruction {
+  async run(node, prevJob, processor) {
+    const [branch] = processor.getBranches(node);
+    const target = processor.getParsedValue(node.config.target, node.id);
+    const length = getTargetLength(target);
+    if (!branch || !length) {
+      return {
+        status: import_plugin_workflow.JOB_STATUS.RESOLVED,
+        result: 0
+      };
+    }
+    const job = await processor.saveJob({
+      status: import_plugin_workflow.JOB_STATUS.PENDING,
+      // save loop index
+      result: 0,
+      nodeId: node.id,
+      upstreamId: (prevJob == null ? void 0 : prevJob.id) ?? null
+    });
+    await processor.run(branch, job);
+    return null;
+  }
+  async resume(node, branchJob, processor) {
+    const job = processor.findBranchParentJob(branchJob, node);
+    const loop = processor.nodesMap.get(job.nodeId);
+    const [branch] = processor.getBranches(node);
+    const { result, status } = job;
+    if (status !== import_plugin_workflow.JOB_STATUS.PENDING) {
+      return processor.exit();
+    }
+    const nextIndex = result + 1;
+    const target = processor.getParsedValue(loop.config.target, node.id);
+    if (branchJob.status > import_plugin_workflow.JOB_STATUS.PENDING) {
+      job.set({ result: nextIndex });
+      const length = getTargetLength(target);
+      if (nextIndex < length) {
+        await processor.saveJob(job);
+        await processor.run(branch, job);
+        return null;
+      }
+    }
+    job.set({
+      status: branchJob.status
+    });
+    return job;
+  }
+  getScope(node, index, processor) {
+    const target = processor.getParsedValue(node.config.target, node.id);
+    const targets = (Array.isArray(target) ? target : [target]).filter((t) => t != null);
+    const length = getTargetLength(target);
+    const item = typeof target === "number" ? index : targets[index];
+    const result = {
+      item,
+      index,
+      length
+    };
+    return result;
+  }
+}

package/dist/server/Plugin.d.ts

@@ -0,0 +1,6 @@
+import { Plugin } from '@nocobase/server';
+import { default as WorkflowPlugin } from '@nocobase/plugin-workflow';
+export default class extends Plugin {
+    workflow: WorkflowPlugin;
+    load(): Promise<void>;
+}

package/dist/server/Plugin.js

@@ -0,0 +1,42 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Plugin_exports = {};
+__export(Plugin_exports, {
+  default: () => Plugin_default
+});
+module.exports = __toCommonJS(Plugin_exports);
+var import_server = require("@nocobase/server");
+var import_LoopInstruction = __toESM(require("./LoopInstruction"));
+class Plugin_default extends import_server.Plugin {
+  workflow;
+  async load() {
+    const workflowPlugin = this.app.getPlugin("workflow");
+    this.workflow = workflowPlugin;
+    workflowPlugin.instructions.register("loop", new import_LoopInstruction.default(workflowPlugin));
+  }
+}

package/dist/server/index.d.ts

@@ -0,0 +1 @@
+export { default } from './Plugin';

package/dist/server/index.js

@@ -0,0 +1,33 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var server_exports = {};
+__export(server_exports, {
+  default: () => import_Plugin.default
+});
+module.exports = __toCommonJS(server_exports);
+var import_Plugin = __toESM(require("./Plugin"));

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@nocobase/plugin-workflow-loop",
+  "displayName": "Workflow: Loop node",
+  "displayName.zh-CN": "工作流：循环节点",
+  "description": "Useful plugin for doing dynamic calculation based on expression collection records in workflow.",
+  "description.zh-CN": "用于在工作流中进行基于数据行的动态表达式计算。",
+  "version": "0.17.0-alpha.4",
+  "license": "AGPL-3.0",
+  "main": "./dist/server/index.js",
+  "devDependencies": {
+    "@ant-design/icons": "5.x",
+    "react": "18.x",
+    "react-i18next": "^11.15.1"
+  },
+  "peerDependencies": {
+    "@nocobase/client": "0.x",
+    "@nocobase/database": "0.x",
+    "@nocobase/plugin-workflow": ">=0.17.0-alpha.3",
+    "@nocobase/plugin-workflow-test": ">=0.17.0-alpha.3",
+    "@nocobase/server": "0.x",
+    "@nocobase/test": "0.x"
+  },
+  "gitHead": "663b03a3799a70ba1a2bc6a0d686e679331a50ad"
+}

package/server.d.ts

@@ -0,0 +1,2 @@
+export * from './dist/server';
+export { default } from './dist/server';

package/server.js

@@ -0,0 +1 @@
+module.exports = require('./dist/server/index.js');

package/src/client/LoopInstruction.tsx

@@ -0,0 +1,161 @@
+import React from 'react';
+import { ArrowUpOutlined } from '@ant-design/icons';
+
+import { css, cx, useCompile } from '@nocobase/client';
+
+import {
+  NodeDefaultView,
+  Branch,
+  useFlowContext,
+  useStyles,
+  VariableOption,
+  WorkflowVariableInput,
+  defaultFieldNames,
+  nodesOptions,
+  scopeOptions,
+  triggerOptions,
+  Instruction,
+} from '@nocobase/plugin-workflow/client';
+import { NAMESPACE, useLang } from '../locale';
+
+function findOption(options: VariableOption[], paths: string[]) {
+  let opts = options;
+  let option = null;
+  for (let i = 0; i < paths.length; i++) {
+    const path = paths[i];
+    const current = opts.find((item) => item.value === path);
+    if (!current) {
+      return null;
+    }
+    option = current;
+    if (!current.isLeaf && current.loadChildren) {
+      current.loadChildren(current);
+    }
+    if (current.children) {
+      opts = current.children;
+    }
+  }
+  return option;
+}
+
+export default class extends Instruction {
+  title = `{{t("Loop", { ns: "${NAMESPACE}" })}}`;
+  type = 'loop';
+  group = 'control';
+  description = `{{t("By using a loop node, you can perform the same operation on multiple sets of data. The source of these sets can be either multiple records from a query node or multiple associated records of a single record. Loop node can also be used for iterating a certain number of times or for looping through each character in a string. However, excessive looping may cause performance issues, so use with caution.", { ns: "${NAMESPACE}" })}}`;
+  fieldset = {
+    target: {
+      type: 'string',
+      title: `{{t("Loop target", { ns: "${NAMESPACE}" })}}`,
+      description: `{{t("A single number will be treated as a loop count, a single string will be treated as an array of characters, and other non-array values will be converted to arrays. The loop node ends when the loop count is reached, or when the array loop is completed. You can also add condition nodes to the loop to terminate it.", { ns: "${NAMESPACE}" })}}`,
+      'x-decorator': 'FormItem',
+      'x-component': 'WorkflowVariableInput',
+      'x-component-props': {
+        changeOnSelect: true,
+        useTypedConstant: ['string', 'number', 'null'],
+        className: css`
+          width: 100%;
+
+          .variable {
+            flex: 1;
+          }
+
+          .ant-input.null-value {
+            width: 100%;
+          }
+        `,
+      },
+      required: true,
+    },
+  };
+  components = {
+    WorkflowVariableInput,
+  };
+  Component({ data }) {
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    const { nodes } = useFlowContext();
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    const { styles } = useStyles();
+    const entry = nodes.find((node) => node.upstreamId === data.id && node.branchIndex != null);
+
+    return (
+      <NodeDefaultView data={data}>
+        <div className={styles.nodeSubtreeClass}>
+          <div
+            className={cx(
+              styles.branchBlockClass,
+              css`
+                padding-left: 20em;
+              `,
+            )}
+          >
+            <Branch from={data} entry={entry} branchIndex={entry?.branchIndex ?? 0} />
+
+            <div className={styles.branchClass}>
+              <div className="workflow-branch-lines" />
+              <div className={cx(styles.addButtonClass, styles.loopLineClass)}>
+                <ArrowUpOutlined />
+              </div>
+            </div>
+          </div>
+        </div>
+      </NodeDefaultView>
+    );
+  }
+  useScopeVariables(node, options) {
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    const compile = useCompile();
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    const langLoopTarget = useLang('Loop target');
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    const langLoopIndex = useLang('Loop index');
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    const langLoopLength = useLang('Loop length');
+    const { target } = node.config;
+    if (!target) {
+      return null;
+    }
+
+    const { fieldNames = defaultFieldNames } = options;
+
+    // const { workflow } = useFlowContext();
+    // const current = useNodeContext();
+    // const upstreams = useAvailableUpstreams(current);
+    // find target data model by path described in `config.target`
+    // 1. get options from $context/$jobsMapByNodeKey
+    // 2. route to sub-options and use as loop target options
+    let targetOption: VariableOption = {
+      key: 'item',
+      [fieldNames.value]: 'item',
+      [fieldNames.label]: langLoopTarget,
+    };
+
+    if (typeof target === 'string' && target.startsWith('{{') && target.endsWith('}}')) {
+      const paths = target
+        .slice(2, -2)
+        .split('.')
+        .map((path) => path.trim());
+
+      const targetOptions = [scopeOptions, nodesOptions, triggerOptions].map((item: any) => {
+        const opts = item.useOptions({ ...options, current: node }).filter(Boolean);
+        return {
+          [fieldNames.label]: compile(item.label),
+          [fieldNames.value]: item.value,
+          key: item.value,
+          [fieldNames.children]: opts,
+          disabled: opts && !opts.length,
+        };
+      });
+
+      const found = findOption(targetOptions, paths);
+
+      targetOption = Object.assign({}, found, targetOption);
+    }
+
+    return [
+      targetOption,
+      { key: 'index', [fieldNames.value]: 'index', [fieldNames.label]: langLoopIndex },
+      { key: 'length', [fieldNames.value]: 'length', [fieldNames.label]: langLoopLength },
+    ];
+  }
+}

package/src/client/index.ts

@@ -0,0 +1,19 @@
+import { Plugin } from '@nocobase/client';
+import WorkflowPlugin from '@nocobase/plugin-workflow/client';
+
+import LoopInstruction from './LoopInstruction';
+
+export default class extends Plugin {
+  async afterAdd() {
+    // await this.app.pm.add()
+  }
+
+  async beforeLoad() {}
+
+  // You can get and modify the app instance here
+  async load() {
+    const workflow = this.app.pm.get('workflow') as WorkflowPlugin;
+    const loopInstruction = new LoopInstruction();
+    workflow.instructions.register(loopInstruction.type, loopInstruction);
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './server';
+export { default } from './server';

package/src/locale/en-US.json

@@ -0,0 +1,9 @@
+{
+  "Loop": "Loop",
+  "Loop target": "Loop target",
+  "Loop index": "Loop index",
+  "Loop length": "Loop length",
+  "By using a loop node, you can perform the same operation on multiple sets of data. The source of these sets can be either multiple records from a query node or multiple associated records of a single record. Loop node can also be used for iterating a certain number of times or for looping through each character in a string. However, excessive looping may cause performance issues, so use with caution.": "By using a loop node, you can perform the same operation on multiple sets of data. The source of these sets can be either multiple records from a query node or multiple associated records of a single record. Loop node can also be used for iterating a certain number of times or for looping through each character in a string. However, excessive looping may cause performance issues, so use with caution.",
+  "Scope variables": "Scope variables",
+  "A single number will be treated as a loop count, a single string will be treated as an array of characters, and other non-array values will be converted to arrays. The loop node ends when the loop count is reached, or when the array loop is completed. You can also add condition nodes to the loop to terminate it.": "A single number will be treated as a loop count, a single string will be treated as an array of characters, and other non-array values will be converted to arrays. The loop node ends when the loop count is reached, or when the array loop is completed. You can also add condition nodes to the loop to terminate it."
+}

package/src/locale/index.ts

@@ -0,0 +1,12 @@
+import { useTranslation } from 'react-i18next';
+
+export const NAMESPACE = 'workflow-loop';
+
+export function useLang(key: string, options = {}) {
+  const { t } = usePluginTranslation(options);
+  return t(key);
+}
+
+export function usePluginTranslation(options) {
+  return useTranslation(NAMESPACE, options);
+}

package/src/locale/zh-CN.json

@@ -0,0 +1,9 @@
+{
+  "Loop": "循环",
+  "Loop target": "循环对象",
+  "Loop index": "当前索引",
+  "Loop length": "循环长度",
+  "By using a loop node, you can perform the same operation on multiple sets of data. The source of these sets can be either multiple records from a query node or multiple associated records of a single record. Loop node can also be used for iterating a certain number of times or for looping through each character in a string. However, excessive looping may cause performance issues, so use with caution.": "使用循环节点可以对多条数据进行同样的操作，多条数据的来源可以是查询节点的多条结果，或者一条数据的多条关系数据。也可以用于一定次数的循环，或者对字符串中每一个字符的循环处理。循环次数过高可能引起性能问题，请谨慎使用。",
+  "Scope variables": "局域变量",
+  "A single number will be treated as a loop count, a single string will be treated as an array of characters, and other non-array values will be converted to arrays. The loop node ends when the loop count is reached, or when the array loop is completed. You can also add condition nodes to the loop to terminate it.": "单一数字值将被视为循环次数，单一字符串值将被视为字符数组，其他非数组值将被转换为数组。达到循环次数，或者将数组循环完成后，循环节点结束。你也可以在循环中添加条件节点，以终止循环。"
+}