@rytass/bpm-core-react 0.20.1 → 0.21.1

package/dist/views/templates/designer/approver-resolver-model.d.cts

@@ -1,4 +1,4 @@
-import { ApproverResolver, ApproverResolverFallback } from '@rytass/bpm-core-shared/workflow';
+import { ApproverResolver, ApproverResolverFallback, OrgManagerChainStart } from '@rytass/bpm-core-shared/workflow';
 import { FormDefinitionSchema } from '@rytass/bpm-core-shared/form';
 import { OrgUnitRecord, PositionRecord } from '@rytass/bpm-core-client/organization';
 import { OrgUnitOption, PositionOption } from '../../../components/admin-picker-options.cjs';
@@ -208,4 +208,108 @@ export type ApproverManagerRuleView = Readonly<{
  */
 export declare function readApproverManagerRule(resolver: ApproverResolver): ApproverManagerRuleView | null;
 export declare function withPreferClosestOrgUnit(resolver: ApproverResolver, preferClosestOrgUnit: boolean): ApproverResolver;
+type OrgManagerChainResolver = Extract<ApproverResolver, {
+    readonly type: 'ORG_MANAGER_CHAIN';
+}>;
+export type OrgManagerChainStartMode = OrgManagerChainStart['type'];
+export type OrgManagerChainStartOption = Readonly<{
+    id: string;
+    name: string;
+}>;
+/** The choices of 從誰的主管開始. Today's behaviour is the first one. */
+export declare const ORG_MANAGER_CHAIN_START_OPTIONS: readonly Readonly<{
+    id: OrgManagerChainStartMode;
+    name: string;
+}>[];
+/** The id of the read-only entry an unknown start is shown as. */
+export declare const UNSUPPORTED_ORG_MANAGER_CHAIN_START_OPTION_ID = "UNSUPPORTED";
+/** The 從職等幾開始簽 choice that leaves the setting out. */
+export declare const NO_START_POSITION_LEVEL_OPTION_ID = "NONE";
+export declare const START_POSITION_LEVEL_HINT = "\u8077\u7B49\u4F4E\u65BC\u9019\u88E1\u7684\u4E3B\u7BA1\u53EA\u6703\u88AB\u7565\u904E\u3001\u4E0D\u7C3D\u6838\uFF1B\u7559\u767D\u5247\u5F9E\u93C8\u4E0A\u7B2C\u4E00\u4F4D\u6709\u8077\u7B49\u7684\u4E3B\u7BA1\u958B\u59CB\u7C3D\u3002\u4E0D\u53EF\u9AD8\u65BC\u300C\u7C3D\u5230\u8077\u7B49\u300D\u3002";
+export declare const START_POSITION_LEVEL_ABOVE_MIN_HINT = "\u8D77\u59CB\u8077\u7B49\u4E0D\u53EF\u9AD8\u65BC\u7C3D\u5230\u8077\u7B49\uFF0C\u767C\u5E03\u524D\u5FC5\u9808\u4FEE\u6B63\u3002";
+/**
+ * Where the chain starts, or `null` for a start this build does not know (a
+ * definition saved by a newer BPMCore): shown read-only, never rewritten.
+ * No `startFrom` is the initiator.
+ */
+export declare function readOrgManagerChainStartMode(resolver: OrgManagerChainResolver): OrgManagerChainStartMode | null;
+export type OrgManagerChainStartChoice = Readonly<{
+    /** Hint under the select: what the chosen start means. */
+    hint: string;
+    options: readonly OrgManagerChainStartOption[];
+    selected: OrgManagerChainStartOption;
+}>;
+/**
+ * The 從誰的主管開始 select. A start this build does not know is the current
+ * value as an extra read-only entry; picking it writes nothing
+ * ({@link readOrgManagerChainStartPick}).
+ */
+export declare function readOrgManagerChainStartChoice(resolver: OrgManagerChainResolver): OrgManagerChainStartChoice;
+/**
+ * The resolver after 從誰的主管開始 is set to `mode`: the initiator drops the
+ * `startFrom` key (the same as never having set it), a form field or earlier
+ * stages starts empty for the author to fill. The start level and the rest of
+ * the resolver are kept.
+ */
+export declare function withOrgManagerChainStart(resolver: OrgManagerChainResolver, mode: OrgManagerChainStartMode): OrgManagerChainResolver;
+/**
+ * The resolver a 從誰的主管開始 pick produces, or `null` when the pick must
+ * change nothing: no option, the read-only unsupported entry, or the start the
+ * resolver already has (re-picking it used to clear the field or stages
+ * already chosen).
+ */
+export declare function readOrgManagerChainStartPick(resolver: ApproverResolver, optionId: string | null): OrgManagerChainResolver | null;
+/** The form field a `FORM_MEMBER` start names, else `null`. */
+export declare function readOrgManagerChainStartFormPath(resolver: OrgManagerChainResolver): string | null;
+/** The stages a `NODE_ACTOR` start names, else `null`. */
+export declare function readOrgManagerChainStartNodeIds(resolver: OrgManagerChainResolver): readonly string[] | null;
+/**
+ * The resolver with the field of a `FORM_MEMBER` start set. Any other start
+ * comes back as the same object: there is no field to write.
+ */
+export declare function withOrgManagerChainStartFormPath(resolver: OrgManagerChainResolver, formPath: string): OrgManagerChainResolver;
+/**
+ * The resolver with the stages of a `NODE_ACTOR` start set. Any other start
+ * comes back as the same object.
+ */
+export declare function withOrgManagerChainStartNodeIds(resolver: OrgManagerChainResolver, nodeIds: readonly string[]): OrgManagerChainResolver;
+/**
+ * The resolver after 簽到職等 is set to `minPositionLevel`: `startFrom`,
+ * `startPositionLevel` and `fallback` stay as they were.
+ */
+export declare function withOrgManagerChainMinPositionLevel(resolver: OrgManagerChainResolver, minPositionLevel: number): OrgManagerChainResolver;
+export type OrgManagerChainStartLevelChoice = Readonly<{
+    /** The stored level is not a whole number: shown, not offered. */
+    invalid: boolean;
+    options: readonly OrgManagerChainStartOption[];
+    selected: OrgManagerChainStartOption;
+}>;
+/**
+ * The 從職等幾開始簽 select: 不指定 plus the position levels at or below
+ * 簽到職等 (a start above it cannot be published, so it is not offered). A
+ * stored level the directory has no position for, or one above 簽到職等, stays
+ * in the list so the select can show it; a stored value that is not a number
+ * is shown as invalid rather than as 不指定.
+ */
+export declare function readOrgManagerChainStartLevelChoice(resolver: OrgManagerChainResolver, positions: readonly PositionRecord[]): OrgManagerChainStartLevelChoice;
+/**
+ * The resolver a 從職等幾開始簽 pick produces, or `null` when the pick must
+ * change nothing: no option, the invalid entry, or the level already stored.
+ * 不指定 drops the `startPositionLevel` key (never writes `undefined`).
+ */
+export declare function readOrgManagerChainStartLevelPick(resolver: ApproverResolver, optionId: string | null): OrgManagerChainResolver | null;
+/**
+ * Why the chosen 簽到職等 and 從職等幾開始簽 cannot be published together, or
+ * `null`. The same rule as the publish check (`readOrgManagerChainIssue`),
+ * said under the select as the author picks.
+ */
+export declare function readOrgManagerChainStartLevelProblem(resolver: OrgManagerChainResolver): string | null;
+/**
+ * The hint under 無主管時 for a manager chain. With neither the start nor the
+ * start level set it is the text it always was. Otherwise it adds the two ways
+ * the engine ends up at the fallback with nobody on the chain: no start person
+ * (`resolveOrgManagerChainStart` returns no member) and no manager at or above
+ * the start level (the chain stays empty and `resolveFallbackAssignees` runs).
+ */
+export declare function readOrgManagerChainFallbackHint(resolver: OrgManagerChainResolver): string;
 export {};

package/dist/views/templates/designer/approver-resolver-model.d.ts

@@ -1,4 +1,4 @@
-import { ApproverResolver, ApproverResolverFallback } from '@rytass/bpm-core-shared/workflow';
+import { ApproverResolver, ApproverResolverFallback, OrgManagerChainStart } from '@rytass/bpm-core-shared/workflow';
 import { FormDefinitionSchema } from '@rytass/bpm-core-shared/form';
 import { OrgUnitRecord, PositionRecord } from '@rytass/bpm-core-client/organization';
 import { OrgUnitOption, PositionOption } from '../../../components/admin-picker-options.js';
@@ -208,4 +208,108 @@ export type ApproverManagerRuleView = Readonly<{
  */
 export declare function readApproverManagerRule(resolver: ApproverResolver): ApproverManagerRuleView | null;
 export declare function withPreferClosestOrgUnit(resolver: ApproverResolver, preferClosestOrgUnit: boolean): ApproverResolver;
+type OrgManagerChainResolver = Extract<ApproverResolver, {
+    readonly type: 'ORG_MANAGER_CHAIN';
+}>;
+export type OrgManagerChainStartMode = OrgManagerChainStart['type'];
+export type OrgManagerChainStartOption = Readonly<{
+    id: string;
+    name: string;
+}>;
+/** The choices of 從誰的主管開始. Today's behaviour is the first one. */
+export declare const ORG_MANAGER_CHAIN_START_OPTIONS: readonly Readonly<{
+    id: OrgManagerChainStartMode;
+    name: string;
+}>[];
+/** The id of the read-only entry an unknown start is shown as. */
+export declare const UNSUPPORTED_ORG_MANAGER_CHAIN_START_OPTION_ID = "UNSUPPORTED";
+/** The 從職等幾開始簽 choice that leaves the setting out. */
+export declare const NO_START_POSITION_LEVEL_OPTION_ID = "NONE";
+export declare const START_POSITION_LEVEL_HINT = "\u8077\u7B49\u4F4E\u65BC\u9019\u88E1\u7684\u4E3B\u7BA1\u53EA\u6703\u88AB\u7565\u904E\u3001\u4E0D\u7C3D\u6838\uFF1B\u7559\u767D\u5247\u5F9E\u93C8\u4E0A\u7B2C\u4E00\u4F4D\u6709\u8077\u7B49\u7684\u4E3B\u7BA1\u958B\u59CB\u7C3D\u3002\u4E0D\u53EF\u9AD8\u65BC\u300C\u7C3D\u5230\u8077\u7B49\u300D\u3002";
+export declare const START_POSITION_LEVEL_ABOVE_MIN_HINT = "\u8D77\u59CB\u8077\u7B49\u4E0D\u53EF\u9AD8\u65BC\u7C3D\u5230\u8077\u7B49\uFF0C\u767C\u5E03\u524D\u5FC5\u9808\u4FEE\u6B63\u3002";
+/**
+ * Where the chain starts, or `null` for a start this build does not know (a
+ * definition saved by a newer BPMCore): shown read-only, never rewritten.
+ * No `startFrom` is the initiator.
+ */
+export declare function readOrgManagerChainStartMode(resolver: OrgManagerChainResolver): OrgManagerChainStartMode | null;
+export type OrgManagerChainStartChoice = Readonly<{
+    /** Hint under the select: what the chosen start means. */
+    hint: string;
+    options: readonly OrgManagerChainStartOption[];
+    selected: OrgManagerChainStartOption;
+}>;
+/**
+ * The 從誰的主管開始 select. A start this build does not know is the current
+ * value as an extra read-only entry; picking it writes nothing
+ * ({@link readOrgManagerChainStartPick}).
+ */
+export declare function readOrgManagerChainStartChoice(resolver: OrgManagerChainResolver): OrgManagerChainStartChoice;
+/**
+ * The resolver after 從誰的主管開始 is set to `mode`: the initiator drops the
+ * `startFrom` key (the same as never having set it), a form field or earlier
+ * stages starts empty for the author to fill. The start level and the rest of
+ * the resolver are kept.
+ */
+export declare function withOrgManagerChainStart(resolver: OrgManagerChainResolver, mode: OrgManagerChainStartMode): OrgManagerChainResolver;
+/**
+ * The resolver a 從誰的主管開始 pick produces, or `null` when the pick must
+ * change nothing: no option, the read-only unsupported entry, or the start the
+ * resolver already has (re-picking it used to clear the field or stages
+ * already chosen).
+ */
+export declare function readOrgManagerChainStartPick(resolver: ApproverResolver, optionId: string | null): OrgManagerChainResolver | null;
+/** The form field a `FORM_MEMBER` start names, else `null`. */
+export declare function readOrgManagerChainStartFormPath(resolver: OrgManagerChainResolver): string | null;
+/** The stages a `NODE_ACTOR` start names, else `null`. */
+export declare function readOrgManagerChainStartNodeIds(resolver: OrgManagerChainResolver): readonly string[] | null;
+/**
+ * The resolver with the field of a `FORM_MEMBER` start set. Any other start
+ * comes back as the same object: there is no field to write.
+ */
+export declare function withOrgManagerChainStartFormPath(resolver: OrgManagerChainResolver, formPath: string): OrgManagerChainResolver;
+/**
+ * The resolver with the stages of a `NODE_ACTOR` start set. Any other start
+ * comes back as the same object.
+ */
+export declare function withOrgManagerChainStartNodeIds(resolver: OrgManagerChainResolver, nodeIds: readonly string[]): OrgManagerChainResolver;
+/**
+ * The resolver after 簽到職等 is set to `minPositionLevel`: `startFrom`,
+ * `startPositionLevel` and `fallback` stay as they were.
+ */
+export declare function withOrgManagerChainMinPositionLevel(resolver: OrgManagerChainResolver, minPositionLevel: number): OrgManagerChainResolver;
+export type OrgManagerChainStartLevelChoice = Readonly<{
+    /** The stored level is not a whole number: shown, not offered. */
+    invalid: boolean;
+    options: readonly OrgManagerChainStartOption[];
+    selected: OrgManagerChainStartOption;
+}>;
+/**
+ * The 從職等幾開始簽 select: 不指定 plus the position levels at or below
+ * 簽到職等 (a start above it cannot be published, so it is not offered). A
+ * stored level the directory has no position for, or one above 簽到職等, stays
+ * in the list so the select can show it; a stored value that is not a number
+ * is shown as invalid rather than as 不指定.
+ */
+export declare function readOrgManagerChainStartLevelChoice(resolver: OrgManagerChainResolver, positions: readonly PositionRecord[]): OrgManagerChainStartLevelChoice;
+/**
+ * The resolver a 從職等幾開始簽 pick produces, or `null` when the pick must
+ * change nothing: no option, the invalid entry, or the level already stored.
+ * 不指定 drops the `startPositionLevel` key (never writes `undefined`).
+ */
+export declare function readOrgManagerChainStartLevelPick(resolver: ApproverResolver, optionId: string | null): OrgManagerChainResolver | null;
+/**
+ * Why the chosen 簽到職等 and 從職等幾開始簽 cannot be published together, or
+ * `null`. The same rule as the publish check (`readOrgManagerChainIssue`),
+ * said under the select as the author picks.
+ */
+export declare function readOrgManagerChainStartLevelProblem(resolver: OrgManagerChainResolver): string | null;
+/**
+ * The hint under 無主管時 for a manager chain. With neither the start nor the
+ * start level set it is the text it always was. Otherwise it adds the two ways
+ * the engine ends up at the fallback with nobody on the chain: no start person
+ * (`resolveOrgManagerChainStart` returns no member) and no manager at or above
+ * the start level (the chain stays empty and `resolveFallbackAssignees` runs).
+ */
+export declare function readOrgManagerChainFallbackHint(resolver: OrgManagerChainResolver): string;
 export {};

package/dist/views/templates/designer/dynamic-form-resolver-options.d.cts

@@ -46,6 +46,11 @@ export declare function readFormMemberManagerFieldChoice(schema: FormDefinitionS
 export declare function readOrgUnitFieldOptions(schema: FormDefinitionSchema | null): readonly MemberFieldOption[];
 /** The field picker for 組織 = 表單欄位 of 指定組織主管. */
 export declare function readFormOrgUnitFieldChoice(schema: FormDefinitionSchema | null, formPath: string): DynamicFormFieldChoice;
+/**
+ * What a form field is called in a sentence: its label, or the field key when
+ * the form has no such field (any more) or the field has no label.
+ */
+export declare function readFormFieldDisplayName(schema: FormDefinitionSchema | null, formPath: string): string;
 /**
  * 依表單欄位：<label>; the field key when the form does not have it (any
  * more), and a marker when the key names something that is not a member field.

package/dist/views/templates/designer/dynamic-form-resolver-options.d.ts

@@ -46,6 +46,11 @@ export declare function readFormMemberManagerFieldChoice(schema: FormDefinitionS
 export declare function readOrgUnitFieldOptions(schema: FormDefinitionSchema | null): readonly MemberFieldOption[];
 /** The field picker for 組織 = 表單欄位 of 指定組織主管. */
 export declare function readFormOrgUnitFieldChoice(schema: FormDefinitionSchema | null, formPath: string): DynamicFormFieldChoice;
+/**
+ * What a form field is called in a sentence: its label, or the field key when
+ * the form has no such field (any more) or the field has no label.
+ */
+export declare function readFormFieldDisplayName(schema: FormDefinitionSchema | null, formPath: string): string;
 /**
  * 依表單欄位：<label>; the field key when the form does not have it (any
  * more), and a marker when the key names something that is not a member field.

package/dist/views/templates/designer/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/designer-CX9bhYJS.cjs");exports.TemplateDesignerView=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/designer-CAUWEKJ4.cjs");exports.TemplateDesignerView=e.t;

package/dist/views/templates/designer/index.js

@@ -1 +1 @@
-export { t as TemplateDesignerView } from "../../../chunks/designer-CZDlQ9Nf.js";
+export { t as TemplateDesignerView } from "../../../chunks/designer-CCy5EbOe.js";

package/dist/views/templates/designer/node-actor-resolver-options.d.cts

@@ -1,4 +1,4 @@
-import { WorkflowDefinition } from '@rytass/bpm-core-shared/workflow';
+import { ExcludeInitiatorWhenEmpty, WorkflowDefinition } from '@rytass/bpm-core-shared/workflow';
 export type NodeActorOption = Readonly<{
     id: string;
     name: string;
@@ -16,6 +16,16 @@ export type NodeActorStageChoice = Readonly<{
 export declare const NO_UPSTREAM_USER_TASK_HINT = "\u9019\u500B\u7BC0\u9EDE\u524D\u9762\u6C92\u6709\u53EF\u4EE5\u9078\u7684\u7C3D\u6838\u95DC\u5361\uFF0C\u8ACB\u5148\u5728\u5B83\u524D\u9762\u52A0\u5165\u7C3D\u6838\u7BC0\u9EDE\uFF08\u6C92\u6709\u9032\u5165\u689D\u4EF6\u3001\u6C92\u8A2D\u8DF3\u904E\u6B64\u95DC\uFF0C\u4E5F\u6C92\u8A2D\u903E\u6642\u81EA\u52D5\u6838\u51C6\uFF09";
 /** The 關卡 picker's hint while the selection has no problem to report. */
 export declare const NODE_ACTOR_STAGE_HINT = "\u7C3D\u6838\u4EBA\u53D6\u81EA\u4F60\u9078\u7684\u524D\u9762\u95DC\u5361\u5BE6\u969B\u7C3D\u6838\u7684\u4EBA\uFF1B\u53EF\u8907\u9078\uFF0C\u6574\u7D44\u8981\u6DB5\u84CB\u6BCF\u689D\u8DEF\u5F91\u3002\u8907\u9078\u591A\u500B\u95DC\u5361\u6642\uFF0C\u53D6\u6700\u8FD1\u5BE6\u969B\u8D70\u5230\u7684\u90A3\u4E00\u95DC\u7684\u7C3D\u6838\u4EBA\uFF0C\u4E0D\u662F\u5168\u90E8\u95DC\u5361\u7684\u7C3D\u6838\u4EBA\u3002";
+/**
+ * The 關卡 picker's hint for a manager chain's 前面關卡的簽核者 start, while
+ * the selection has no problem to report.
+ */
+export declare const ORG_MANAGER_CHAIN_STAGE_HINT = "\u8D77\u9EDE\u662F\u4F60\u9078\u7684\u524D\u9762\u95DC\u5361\u5BE6\u969B\u7C3D\u6838\u7684\u90A3\u4E00\u4F4D\uFF0C\u5F9E\u4ED6\u7684\u4E3B\u7BA1\u958B\u59CB\u5F80\u4E0A\u7C3D\uFF1B\u53EA\u80FD\u9078\u6BCF\u6B21\u53EA\u6703\u6709\u4E00\u4F4D\u7C3D\u6838\u4EBA\u7684\u95DC\u5361\u3002\u53EF\u8907\u9078\uFF0C\u6574\u7D44\u8981\u6DB5\u84CB\u6BCF\u689D\u8DEF\u5F91\uFF0C\u53D6\u6700\u8FD1\u5BE6\u969B\u8D70\u5230\u7684\u90A3\u4E00\u95DC\u7684\u7C3D\u6838\u8005\u3002";
+/**
+ * The 關卡 picker's hint when every stage upstream of a manager chain may end
+ * with several signers, so none can be the start.
+ */
+export declare const ORG_MANAGER_CHAIN_ONLY_MULTI_APPROVER_STAGES_HINT = "\u524D\u9762\u7684\u7C3D\u6838\u95DC\u5361\u90FD\u53EF\u80FD\u6709\u591A\u4F4D\u7C3D\u6838\u4EBA\uFF0C\u6240\u4EE5\u4E0D\u80FD\u7576\u4E3B\u7BA1\u93C8\u7684\u8D77\u9EDE\uFF1B\u8ACB\u6539\u7528\u53EA\u6709\u4E00\u4F4D\u7C3D\u6838\u4EBA\u7684\u95DC\u5361\uFF0C\u6216\u6539\u9078\u5176\u4ED6\u8D77\u9EDE\u3002";
 /**
  * The 關卡 picker of 依前面關卡的簽核者: the user tasks upstream of `nodeId`
  * that always end with a real signer (`readNodeActorSourceSkipReasons` is
@@ -29,6 +39,16 @@ export declare const NODE_ACTOR_STAGE_HINT = "\u7C3D\u6838\u4EBA\u53D6\u81EA\u4F
  * stored choice stays visible until the author fixes it.
  */
 export declare function readNodeActorStageChoice(definition: WorkflowDefinition, nodeId: string, selectedIds: readonly string[]): NodeActorStageChoice;
+/**
+ * The 關卡 picker of a manager chain's 前面關卡的簽核者 start: the same stages
+ * as {@link readNodeActorStageChoice} offers, minus the ones that may end with
+ * several signers. The chain climbs from one person, so a stage that
+ * `canUserTaskHaveMultipleApprovers` is not offered (a 並行全部同意 stage still
+ * is for 依前面關卡的簽核者, which takes everyone). A stored stage of that kind
+ * stays in the list, marked, and the selection's problems include the
+ * single-signer rule the publish lint runs (`readSingleApproverSourceIssues`).
+ */
+export declare function readOrgManagerChainStageChoice(definition: WorkflowDefinition, nodeId: string, selectedIds: readonly string[]): NodeActorStageChoice;
 /**
  * The graph problems of every 依前面關卡的簽核者 node, naming the node: the
  * checks the backend publish lint runs (`readNodeActorSourceIssues`), for the
@@ -36,3 +56,26 @@ export declare function readNodeActorStageChoice(definition: WorkflowDefinition,
  * `readApproverResolverIssue`, which owns that message.
  */
 export declare function readNodeActorGraphIssues(definition: WorkflowDefinition): readonly string[];
+/** The hint under the 不可與前面關卡同一人 picker while it has no problem to report. */
+export declare const EXCLUDE_NODE_ACTORS_STAGE_HINT = "\u6B64\u95DC\u7684\u7C3D\u6838\u4EBA\u4E0D\u6703\u662F\u4F60\u9078\u7684\u524D\u9762\u95DC\u5361\u5BE6\u969B\u7C3D\u6838\u7684\u4EBA\uFF08\u542B\u5176\u4EE3\u7406\u4EBA\uFF09\uFF0C\u4E5F\u4E0D\u80FD\u88AB\u8F49\u7C3D\u6216\u52A0\u7C3D\u5230\u6B64\u95DC\uFF1B\u53EF\u8907\u9078\uFF0C\u6BCF\u500B\u95DC\u5361\u90FD\u6703\u6392\u9664\u3002\u53EA\u80FD\u9078\u6BCF\u689D\u8DEF\u5F91\u90FD\u6703\u7D93\u904E\u3001\u800C\u4E14\u4E00\u5B9A\u6709\u4EBA\u5BE6\u969B\u7C3D\u6838\u7684\u95DC\u5361\uFF08\u6C92\u6709\u9032\u5165\u689D\u4EF6\u3001\u6C92\u8A2D\u8DF3\u904E\u6B64\u95DC\u3001\u6C92\u8A2D\u903E\u6642\u81EA\u52D5\u6838\u51C6\uFF09\uFF1B\u689D\u4EF6\u5F0F\u7684\u95DC\u5361\u3001\u5E73\u884C\u5206\u652F\u4E0A\u7684\u95DC\u5361\u90FD\u4E0D\u652F\u63F4\uFF0C\u689D\u4EF6\u5F0F\u7684\u8ACB\u6539\u7528\u5206\u6D41\u628A\u5169\u95DC\u653E\u5728\u540C\u4E00\u689D\u8DEF\u7DDA\u4E0A\uFF0C\u5E73\u884C\u5206\u652F\u4E0A\u7684\u8ACB\u6539\u6210\u5148\u5F8C\u4E32\u63A5\u3002";
+/** Shown when no earlier stage can be picked. */
+export declare const NO_EXCLUDABLE_STAGE_HINT = "\u9019\u500B\u7BC0\u9EDE\u524D\u9762\u6C92\u6709\u53EF\u4EE5\u9078\u7684\u7C3D\u6838\u95DC\u5361\uFF0C\u8ACB\u5148\u5728\u5B83\u524D\u9762\u52A0\u5165\u7C3D\u6838\u7BC0\u9EDE\uFF08\u6BCF\u689D\u8DEF\u5F91\u90FD\u6703\u7D93\u904E\u3001\u6C92\u6709\u9032\u5165\u689D\u4EF6\u3001\u6C92\u8A2D\u8DF3\u904E\u6B64\u95DC\uFF0C\u4E5F\u6C92\u8A2D\u903E\u6642\u81EA\u52D5\u6838\u51C6\uFF09";
+/**
+ * The 不可與前面關卡同一人 picker: the user tasks that pass the publish
+ * check on their own (`readExcludeNodeActorsIssues` with just that stage
+ * listed: upstream of `nodeId`, on every path to it, not skippable, a real
+ * signer every time). Each listed stage has to pass alone, so unlike the
+ * `NODE_ACTOR` picker nothing is left to the selection as a whole. A stored
+ * stage that does not qualify (gone, no longer upstream, or skippable) stays in
+ * the list, marked, and the selection's `problems` say why, so the stored
+ * choice is never dropped silently.
+ */
+export declare function readExcludeNodeActorStageChoice(definition: WorkflowDefinition, nodeId: string, selectedIds: readonly string[], whenEmpty: ExcludeInitiatorWhenEmpty): NodeActorStageChoice;
+/**
+ * The graph problems of every node with 不可與前面關卡同一人, naming the node:
+ * the checks the backend publish lint runs (`readExcludeNodeActorsIssues`),
+ * for the designer to show before publish. The shape of the setting (no stage
+ * chosen, no 排除後沒有簽核人時) is left to `readExcludeNodeActorsShapeIssue`,
+ * which blocks saving.
+ */
+export declare function readExcludeNodeActorsGraphIssues(definition: WorkflowDefinition): readonly string[];

package/dist/views/templates/designer/node-actor-resolver-options.d.ts

@@ -1,4 +1,4 @@
-import { WorkflowDefinition } from '@rytass/bpm-core-shared/workflow';
+import { ExcludeInitiatorWhenEmpty, WorkflowDefinition } from '@rytass/bpm-core-shared/workflow';
 export type NodeActorOption = Readonly<{
     id: string;
     name: string;
@@ -16,6 +16,16 @@ export type NodeActorStageChoice = Readonly<{
 export declare const NO_UPSTREAM_USER_TASK_HINT = "\u9019\u500B\u7BC0\u9EDE\u524D\u9762\u6C92\u6709\u53EF\u4EE5\u9078\u7684\u7C3D\u6838\u95DC\u5361\uFF0C\u8ACB\u5148\u5728\u5B83\u524D\u9762\u52A0\u5165\u7C3D\u6838\u7BC0\u9EDE\uFF08\u6C92\u6709\u9032\u5165\u689D\u4EF6\u3001\u6C92\u8A2D\u8DF3\u904E\u6B64\u95DC\uFF0C\u4E5F\u6C92\u8A2D\u903E\u6642\u81EA\u52D5\u6838\u51C6\uFF09";
 /** The 關卡 picker's hint while the selection has no problem to report. */
 export declare const NODE_ACTOR_STAGE_HINT = "\u7C3D\u6838\u4EBA\u53D6\u81EA\u4F60\u9078\u7684\u524D\u9762\u95DC\u5361\u5BE6\u969B\u7C3D\u6838\u7684\u4EBA\uFF1B\u53EF\u8907\u9078\uFF0C\u6574\u7D44\u8981\u6DB5\u84CB\u6BCF\u689D\u8DEF\u5F91\u3002\u8907\u9078\u591A\u500B\u95DC\u5361\u6642\uFF0C\u53D6\u6700\u8FD1\u5BE6\u969B\u8D70\u5230\u7684\u90A3\u4E00\u95DC\u7684\u7C3D\u6838\u4EBA\uFF0C\u4E0D\u662F\u5168\u90E8\u95DC\u5361\u7684\u7C3D\u6838\u4EBA\u3002";
+/**
+ * The 關卡 picker's hint for a manager chain's 前面關卡的簽核者 start, while
+ * the selection has no problem to report.
+ */
+export declare const ORG_MANAGER_CHAIN_STAGE_HINT = "\u8D77\u9EDE\u662F\u4F60\u9078\u7684\u524D\u9762\u95DC\u5361\u5BE6\u969B\u7C3D\u6838\u7684\u90A3\u4E00\u4F4D\uFF0C\u5F9E\u4ED6\u7684\u4E3B\u7BA1\u958B\u59CB\u5F80\u4E0A\u7C3D\uFF1B\u53EA\u80FD\u9078\u6BCF\u6B21\u53EA\u6703\u6709\u4E00\u4F4D\u7C3D\u6838\u4EBA\u7684\u95DC\u5361\u3002\u53EF\u8907\u9078\uFF0C\u6574\u7D44\u8981\u6DB5\u84CB\u6BCF\u689D\u8DEF\u5F91\uFF0C\u53D6\u6700\u8FD1\u5BE6\u969B\u8D70\u5230\u7684\u90A3\u4E00\u95DC\u7684\u7C3D\u6838\u8005\u3002";
+/**
+ * The 關卡 picker's hint when every stage upstream of a manager chain may end
+ * with several signers, so none can be the start.
+ */
+export declare const ORG_MANAGER_CHAIN_ONLY_MULTI_APPROVER_STAGES_HINT = "\u524D\u9762\u7684\u7C3D\u6838\u95DC\u5361\u90FD\u53EF\u80FD\u6709\u591A\u4F4D\u7C3D\u6838\u4EBA\uFF0C\u6240\u4EE5\u4E0D\u80FD\u7576\u4E3B\u7BA1\u93C8\u7684\u8D77\u9EDE\uFF1B\u8ACB\u6539\u7528\u53EA\u6709\u4E00\u4F4D\u7C3D\u6838\u4EBA\u7684\u95DC\u5361\uFF0C\u6216\u6539\u9078\u5176\u4ED6\u8D77\u9EDE\u3002";
 /**
  * The 關卡 picker of 依前面關卡的簽核者: the user tasks upstream of `nodeId`
  * that always end with a real signer (`readNodeActorSourceSkipReasons` is
@@ -29,6 +39,16 @@ export declare const NODE_ACTOR_STAGE_HINT = "\u7C3D\u6838\u4EBA\u53D6\u81EA\u4F
  * stored choice stays visible until the author fixes it.
  */
 export declare function readNodeActorStageChoice(definition: WorkflowDefinition, nodeId: string, selectedIds: readonly string[]): NodeActorStageChoice;
+/**
+ * The 關卡 picker of a manager chain's 前面關卡的簽核者 start: the same stages
+ * as {@link readNodeActorStageChoice} offers, minus the ones that may end with
+ * several signers. The chain climbs from one person, so a stage that
+ * `canUserTaskHaveMultipleApprovers` is not offered (a 並行全部同意 stage still
+ * is for 依前面關卡的簽核者, which takes everyone). A stored stage of that kind
+ * stays in the list, marked, and the selection's problems include the
+ * single-signer rule the publish lint runs (`readSingleApproverSourceIssues`).
+ */
+export declare function readOrgManagerChainStageChoice(definition: WorkflowDefinition, nodeId: string, selectedIds: readonly string[]): NodeActorStageChoice;
 /**
  * The graph problems of every 依前面關卡的簽核者 node, naming the node: the
  * checks the backend publish lint runs (`readNodeActorSourceIssues`), for the
@@ -36,3 +56,26 @@ export declare function readNodeActorStageChoice(definition: WorkflowDefinition,
  * `readApproverResolverIssue`, which owns that message.
  */
 export declare function readNodeActorGraphIssues(definition: WorkflowDefinition): readonly string[];
+/** The hint under the 不可與前面關卡同一人 picker while it has no problem to report. */
+export declare const EXCLUDE_NODE_ACTORS_STAGE_HINT = "\u6B64\u95DC\u7684\u7C3D\u6838\u4EBA\u4E0D\u6703\u662F\u4F60\u9078\u7684\u524D\u9762\u95DC\u5361\u5BE6\u969B\u7C3D\u6838\u7684\u4EBA\uFF08\u542B\u5176\u4EE3\u7406\u4EBA\uFF09\uFF0C\u4E5F\u4E0D\u80FD\u88AB\u8F49\u7C3D\u6216\u52A0\u7C3D\u5230\u6B64\u95DC\uFF1B\u53EF\u8907\u9078\uFF0C\u6BCF\u500B\u95DC\u5361\u90FD\u6703\u6392\u9664\u3002\u53EA\u80FD\u9078\u6BCF\u689D\u8DEF\u5F91\u90FD\u6703\u7D93\u904E\u3001\u800C\u4E14\u4E00\u5B9A\u6709\u4EBA\u5BE6\u969B\u7C3D\u6838\u7684\u95DC\u5361\uFF08\u6C92\u6709\u9032\u5165\u689D\u4EF6\u3001\u6C92\u8A2D\u8DF3\u904E\u6B64\u95DC\u3001\u6C92\u8A2D\u903E\u6642\u81EA\u52D5\u6838\u51C6\uFF09\uFF1B\u689D\u4EF6\u5F0F\u7684\u95DC\u5361\u3001\u5E73\u884C\u5206\u652F\u4E0A\u7684\u95DC\u5361\u90FD\u4E0D\u652F\u63F4\uFF0C\u689D\u4EF6\u5F0F\u7684\u8ACB\u6539\u7528\u5206\u6D41\u628A\u5169\u95DC\u653E\u5728\u540C\u4E00\u689D\u8DEF\u7DDA\u4E0A\uFF0C\u5E73\u884C\u5206\u652F\u4E0A\u7684\u8ACB\u6539\u6210\u5148\u5F8C\u4E32\u63A5\u3002";
+/** Shown when no earlier stage can be picked. */
+export declare const NO_EXCLUDABLE_STAGE_HINT = "\u9019\u500B\u7BC0\u9EDE\u524D\u9762\u6C92\u6709\u53EF\u4EE5\u9078\u7684\u7C3D\u6838\u95DC\u5361\uFF0C\u8ACB\u5148\u5728\u5B83\u524D\u9762\u52A0\u5165\u7C3D\u6838\u7BC0\u9EDE\uFF08\u6BCF\u689D\u8DEF\u5F91\u90FD\u6703\u7D93\u904E\u3001\u6C92\u6709\u9032\u5165\u689D\u4EF6\u3001\u6C92\u8A2D\u8DF3\u904E\u6B64\u95DC\uFF0C\u4E5F\u6C92\u8A2D\u903E\u6642\u81EA\u52D5\u6838\u51C6\uFF09";
+/**
+ * The 不可與前面關卡同一人 picker: the user tasks that pass the publish
+ * check on their own (`readExcludeNodeActorsIssues` with just that stage
+ * listed: upstream of `nodeId`, on every path to it, not skippable, a real
+ * signer every time). Each listed stage has to pass alone, so unlike the
+ * `NODE_ACTOR` picker nothing is left to the selection as a whole. A stored
+ * stage that does not qualify (gone, no longer upstream, or skippable) stays in
+ * the list, marked, and the selection's `problems` say why, so the stored
+ * choice is never dropped silently.
+ */
+export declare function readExcludeNodeActorStageChoice(definition: WorkflowDefinition, nodeId: string, selectedIds: readonly string[], whenEmpty: ExcludeInitiatorWhenEmpty): NodeActorStageChoice;
+/**
+ * The graph problems of every node with 不可與前面關卡同一人, naming the node:
+ * the checks the backend publish lint runs (`readExcludeNodeActorsIssues`),
+ * for the designer to show before publish. The shape of the setting (no stage
+ * chosen, no 排除後沒有簽核人時) is left to `readExcludeNodeActorsShapeIssue`,
+ * which blocks saving.
+ */
+export declare function readExcludeNodeActorsGraphIssues(definition: WorkflowDefinition): readonly string[];

package/dist/views/templates/designer/notify-recipient-options.d.cts

@@ -0,0 +1,81 @@
+import { ApproverResolver, ServiceAction } from '@rytass/bpm-core-shared/workflow';
+import { PositionRecord } from '@rytass/bpm-core-client/organization';
+import { ApproverResolverModeOption } from './approver-resolver-model.cjs';
+/**
+ * The 知會對象 sources the designer can edit. The engine accepts more for a
+ * notify node (`isNotifyRecipientResolverType`): 發起人主管, 主管鏈 and 運算式
+ * stay readable and are kept as saved, but the designer does not edit them.
+ *
+ * Keyed by the JSON `type`, not by the approver panel's screen option: that
+ * option folds FORM_MEMBER_MANAGER into 依表單欄位指定 and
+ * FORM_ORG_UNIT_MANAGER into 指定組織主管, neither of which a notify node
+ * may use.
+ */
+export type NotifyRecipientMode = Extract<ApproverResolver['type'], 'DIRECT' | 'DYNAMIC_FORM' | 'ORG_UNIT_MANAGER' | 'ORG_UNIT_MEMBER' | 'ORG_UNIT_POSITION' | 'POSITION'>;
+export declare function isNotifyRecipientEditableType(type: string): type is NotifyRecipientMode;
+/**
+ * The editable sources, worded exactly as the 簽核來源 select words them so
+ * the two panels never name one source two ways.
+ */
+export declare const NOTIFY_RECIPIENT_MODE_OPTIONS: readonly ApproverResolverModeOption[];
+/** The id of the read-only entry a source the designer does not edit is shown as. */
+export declare const READ_ONLY_NOTIFY_RECIPIENT_OPTION_ID = "READ_ONLY";
+/** The recipients of a notify action; the empty 指定會員 when it has none. */
+export declare const EMPTY_NOTIFY_RECIPIENTS: ApproverResolver;
+/**
+ * A notify action's recipients, or the empty 指定會員 for an action that is
+ * not a notify yet (the panel is also what turns one into a notify) or that
+ * carries no readable recipients (raw JSON that has not been linted).
+ */
+export declare function readNotifyRecipients(action: ServiceAction): ApproverResolver;
+export type NotifyRecipientSourceChoice = Readonly<{
+    /** Hint under the select, `null` when nothing needs saying. */
+    hint: string | null;
+    options: readonly Readonly<{
+        id: string;
+        name: string;
+    }>[];
+    /** `true` when the stored source is not one the designer edits. */
+    readOnly: boolean;
+    selected: Readonly<{
+        id: string;
+        name: string;
+    }>;
+}>;
+/**
+ * The 知會對象來源 select. A stored source the designer does not edit
+ * (發起人主管, 主管鏈, 運算式, one a notify node may not use, or one a newer
+ * BPMCore saved) is shown as a read-only entry that is the current value:
+ * nothing is written unless the author explicitly picks another source.
+ */
+export declare function readNotifyRecipientSourceChoice(recipients: ApproverResolver): NotifyRecipientSourceChoice;
+/**
+ * The recipients a 知會對象來源 pick produces, or `null` when the pick must
+ * change nothing: no option, an id that is not an editable source (the
+ * read-only entry included), or the source already stored. Re-picking the
+ * shown source would otherwise rebuild a clean default and wipe what the
+ * author had filled in.
+ */
+export declare function readNotifyRecipientSourcePick(recipients: ApproverResolver, optionId: string | null, positions: readonly PositionRecord[]): ApproverResolver | null;
+/**
+ * The action with new recipients. Only the recipients change: channels,
+ * template and webhooks belong to the same action and survive. An action that
+ * is not a notify yet becomes one with the default channel.
+ */
+export declare function withNotifyRecipients(action: ServiceAction, recipients: ApproverResolver): ServiceAction;
+/**
+ * Picks the organization. 組織特定職位 clears its position (it may not belong
+ * to the new organization); 指定組織主管 goes through the approver editor
+ * state so its 無主管時 and 只取最近一層主管 settings survive.
+ */
+export declare function withNotifyOrgUnit(recipients: ApproverResolver, orgUnitId: string): ApproverResolver;
+/**
+ * Switches 包含下層 of 組織任一人 or 組織特定職位; the latter clears its
+ * position, the way the 簽核來源 panel does, because the positions on offer
+ * change with the scope.
+ */
+export declare function withNotifyIncludeDescendants(recipients: ApproverResolver, includeDescendants: boolean): ApproverResolver;
+/** Picks the position of 指定職位 or 組織特定職位. */
+export declare function withNotifyPosition(recipients: ApproverResolver, positionId: string): ApproverResolver;
+/** Picks the member field of 依表單欄位指定 (the person in the field only). */
+export declare function withNotifyFormPath(recipients: ApproverResolver, formPath: string): ApproverResolver;

package/dist/views/templates/designer/notify-recipient-options.d.ts

@@ -0,0 +1,81 @@
+import { ApproverResolver, ServiceAction } from '@rytass/bpm-core-shared/workflow';
+import { PositionRecord } from '@rytass/bpm-core-client/organization';
+import { ApproverResolverModeOption } from './approver-resolver-model.js';
+/**
+ * The 知會對象 sources the designer can edit. The engine accepts more for a
+ * notify node (`isNotifyRecipientResolverType`): 發起人主管, 主管鏈 and 運算式
+ * stay readable and are kept as saved, but the designer does not edit them.
+ *
+ * Keyed by the JSON `type`, not by the approver panel's screen option: that
+ * option folds FORM_MEMBER_MANAGER into 依表單欄位指定 and
+ * FORM_ORG_UNIT_MANAGER into 指定組織主管, neither of which a notify node
+ * may use.
+ */
+export type NotifyRecipientMode = Extract<ApproverResolver['type'], 'DIRECT' | 'DYNAMIC_FORM' | 'ORG_UNIT_MANAGER' | 'ORG_UNIT_MEMBER' | 'ORG_UNIT_POSITION' | 'POSITION'>;
+export declare function isNotifyRecipientEditableType(type: string): type is NotifyRecipientMode;
+/**
+ * The editable sources, worded exactly as the 簽核來源 select words them so
+ * the two panels never name one source two ways.
+ */
+export declare const NOTIFY_RECIPIENT_MODE_OPTIONS: readonly ApproverResolverModeOption[];
+/** The id of the read-only entry a source the designer does not edit is shown as. */
+export declare const READ_ONLY_NOTIFY_RECIPIENT_OPTION_ID = "READ_ONLY";
+/** The recipients of a notify action; the empty 指定會員 when it has none. */
+export declare const EMPTY_NOTIFY_RECIPIENTS: ApproverResolver;
+/**
+ * A notify action's recipients, or the empty 指定會員 for an action that is
+ * not a notify yet (the panel is also what turns one into a notify) or that
+ * carries no readable recipients (raw JSON that has not been linted).
+ */
+export declare function readNotifyRecipients(action: ServiceAction): ApproverResolver;
+export type NotifyRecipientSourceChoice = Readonly<{
+    /** Hint under the select, `null` when nothing needs saying. */
+    hint: string | null;
+    options: readonly Readonly<{
+        id: string;
+        name: string;
+    }>[];
+    /** `true` when the stored source is not one the designer edits. */
+    readOnly: boolean;
+    selected: Readonly<{
+        id: string;
+        name: string;
+    }>;
+}>;
+/**
+ * The 知會對象來源 select. A stored source the designer does not edit
+ * (發起人主管, 主管鏈, 運算式, one a notify node may not use, or one a newer
+ * BPMCore saved) is shown as a read-only entry that is the current value:
+ * nothing is written unless the author explicitly picks another source.
+ */
+export declare function readNotifyRecipientSourceChoice(recipients: ApproverResolver): NotifyRecipientSourceChoice;
+/**
+ * The recipients a 知會對象來源 pick produces, or `null` when the pick must
+ * change nothing: no option, an id that is not an editable source (the
+ * read-only entry included), or the source already stored. Re-picking the
+ * shown source would otherwise rebuild a clean default and wipe what the
+ * author had filled in.
+ */
+export declare function readNotifyRecipientSourcePick(recipients: ApproverResolver, optionId: string | null, positions: readonly PositionRecord[]): ApproverResolver | null;
+/**
+ * The action with new recipients. Only the recipients change: channels,
+ * template and webhooks belong to the same action and survive. An action that
+ * is not a notify yet becomes one with the default channel.
+ */
+export declare function withNotifyRecipients(action: ServiceAction, recipients: ApproverResolver): ServiceAction;
+/**
+ * Picks the organization. 組織特定職位 clears its position (it may not belong
+ * to the new organization); 指定組織主管 goes through the approver editor
+ * state so its 無主管時 and 只取最近一層主管 settings survive.
+ */
+export declare function withNotifyOrgUnit(recipients: ApproverResolver, orgUnitId: string): ApproverResolver;
+/**
+ * Switches 包含下層 of 組織任一人 or 組織特定職位; the latter clears its
+ * position, the way the 簽核來源 panel does, because the positions on offer
+ * change with the scope.
+ */
+export declare function withNotifyIncludeDescendants(recipients: ApproverResolver, includeDescendants: boolean): ApproverResolver;
+/** Picks the position of 指定職位 or 組織特定職位. */
+export declare function withNotifyPosition(recipients: ApproverResolver, positionId: string): ApproverResolver;
+/** Picks the member field of 依表單欄位指定 (the person in the field only). */
+export declare function withNotifyFormPath(recipients: ApproverResolver, formPath: string): ApproverResolver;

package/dist/views/templates/designer/position-level-options.d.cts

@@ -10,8 +10,10 @@ type PositionLevelSource = Pick<PositionRecord, 'level' | 'name'>;
  * labelled with the positions sitting on that level. A saved level that no
  * position carries (positions deleted or not loaded yet) is still offered so
  * the select never renders blank and the stored value is not silently changed.
+ * `currentLevel` is that saved level; `null` offers only the directory's own
+ * levels, for a field that has no value yet.
  */
-export declare function readMinPositionLevelOptions(positions: readonly PositionLevelSource[], currentLevel: number): readonly PositionLevelOption[];
+export declare function readMinPositionLevelOptions(positions: readonly PositionLevelSource[], currentLevel: number | null): readonly PositionLevelOption[];
 /** The highest level in the directory, or `1` when there are no positions. */
 export declare function readDefaultMinPositionLevel(positions: readonly PositionLevelSource[]): number;
 export {};

package/dist/views/templates/designer/position-level-options.d.ts

@@ -10,8 +10,10 @@ type PositionLevelSource = Pick<PositionRecord, 'level' | 'name'>;
  * labelled with the positions sitting on that level. A saved level that no
  * position carries (positions deleted or not loaded yet) is still offered so
  * the select never renders blank and the stored value is not silently changed.
+ * `currentLevel` is that saved level; `null` offers only the directory's own
+ * levels, for a field that has no value yet.
  */
-export declare function readMinPositionLevelOptions(positions: readonly PositionLevelSource[], currentLevel: number): readonly PositionLevelOption[];
+export declare function readMinPositionLevelOptions(positions: readonly PositionLevelSource[], currentLevel: number | null): readonly PositionLevelOption[];
 /** The highest level in the directory, or `1` when there are no positions. */
 export declare function readDefaultMinPositionLevel(positions: readonly PositionLevelSource[]): number;
 export {};