@rytass/bpm-core-react 0.18.0 → 0.19.0

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

@@ -0,0 +1,211 @@
+import { ApproverResolver, ApproverResolverFallback } 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';
+export type ApproverResolverMode = Extract<ApproverResolver['type'], 'DIRECT' | 'DYNAMIC_FORM' | 'NODE_ACTOR' | 'ORG_MANAGER' | 'ORG_MANAGER_CHAIN' | 'ORG_UNIT_MANAGER' | 'ORG_UNIT_MEMBER' | 'ORG_UNIT_POSITION' | 'POSITION'>;
+export type ApproverResolverModeOption = Readonly<{
+    id: ApproverResolverMode;
+    name: string;
+}>;
+export type ManagerLevelOption = Readonly<{
+    id: string;
+    name: string;
+    value: number;
+}>;
+export type MemberSelectOption = Readonly<{
+    displayName: string;
+    email: string;
+    id: string;
+    memberId: string;
+    name: string;
+    /**
+     * Set on the placeholder written when a member's profile could not be
+     * fetched. Marking it explicitly lets {@link mergeMemberOptions} replace the
+     * placeholder once the real profile turns up, instead of the "未知會員"
+     * sentinel sticking for the rest of the session.
+     */
+    unresolved?: boolean;
+}>;
+export declare const APPROVER_RESOLVER_MODE_OPTIONS: readonly ApproverResolverModeOption[];
+export declare const MANAGER_LEVEL_OPTIONS: readonly ManagerLevelOption[];
+export type NodeNameRecord = Readonly<{
+    id: string;
+    name: string;
+}>;
+/**
+ * The 簽核人 choices of the two sources that start from "someone": the person
+ * the source names, or their manager one to three levels up. `value` 0 is the
+ * person themselves; it is what the select stores for a source with no
+ * manager level.
+ */
+export declare const FORM_MEMBER_SUBJECT_OPTIONS: readonly ManagerLevelOption[];
+export declare const NODE_ACTOR_SUBJECT_OPTIONS: readonly ManagerLevelOption[];
+export type OrgUnitManagerSource = 'FIXED' | 'FORM_FIELD';
+export declare const ORG_UNIT_SOURCE_OPTIONS: readonly Readonly<{
+    id: OrgUnitManagerSource;
+    name: string;
+}>[];
+/**
+ * The option for a stored level. A level this screen has no option for (a
+ * hand-written or AI-written definition) is shown as itself rather than
+ * mistaken for another one.
+ */
+export declare function readApproverSubjectOption(options: readonly ManagerLevelOption[], levelsUp: number): ManagerLevelOption;
+/**
+ * The option for the manager level a FORM_MEMBER_MANAGER / NODE_ACTOR_MANAGER
+ * definition stores. Those types always name a manager, so a level below 1 (or
+ * not a whole number) is a broken definition: it is shown as an invalid level
+ * rather than as the option whose `value` happens to be 0 (本人). The stored
+ * JSON is never touched by this read; the publish lint is what blocks it.
+ */
+export declare function readStoredManagerLevelOption(options: readonly ManagerLevelOption[], levelsUp: number): ManagerLevelOption;
+export declare function readApproverResolverMode(value: string): ApproverResolverMode;
+export declare function readDefaultApproverResolver(value: string | null, positions: readonly PositionRecord[]): ApproverResolver;
+export declare function updateApproverResolverFallback(resolver: ApproverResolver, fallback: ApproverResolverFallback): ApproverResolver;
+export declare function readManagerLevelOption(levelsUp: number): ManagerLevelOption;
+export declare function readManagerLevelOptionById(id: string | null): ManagerLevelOption;
+/**
+ * Every member id a resolver names outright, so the designer can pre-fetch
+ * their display names on load.
+ *
+ * The manager resolvers' `DIRECT` fallback ("固定改派") counts: it is a member
+ * the author picked and the property form renders it through
+ * `readMemberSelectOption`, which falls back to the "未知會員" sentinel for any
+ * id it cannot find. Leaving it out meant a saved fallback always rendered as
+ * 未知會員 until an unrelated search happened to return that member.
+ */
+export declare function readApproverResolverMemberIds(resolver: ApproverResolver): readonly string[];
+export declare function readApproverResolverSummary(resolver: ApproverResolver, memberOptions: readonly MemberSelectOption[], orgUnits: readonly OrgUnitRecord[], positions: readonly PositionRecord[], formSchema: FormDefinitionSchema | null, nodes?: readonly NodeNameRecord[]): string;
+export declare function readMemberEmailSummary(memberIds: readonly string[], memberOptions: readonly MemberSelectOption[], emptyLabel: string): string;
+export declare function readOrgUnitDisplayName(orgUnits: readonly OrgUnitRecord[], orgUnitId: string): string;
+export declare function readPositionDisplayName(positions: readonly PositionRecord[], positionId: string): string;
+export declare function readSelectedOrgUnitOption(orgUnits: readonly OrgUnitRecord[], orgUnitId: string): OrgUnitOption | null;
+export declare function readSelectedPositionOption(positions: readonly PositionRecord[], positionId: string): PositionOption | null;
+export declare function readMemberSelectOption(options: readonly MemberSelectOption[], memberId: string): MemberSelectOption;
+export declare function readFallbackMemberSelectOption(memberId: string): MemberSelectOption;
+/**
+ * The one label for a resolver `type` this build does not know (a definition
+ * saved by a newer BPMCore): the designer's read-only 簽核來源 entry, the node
+ * summary and the compose review table all say it with this.
+ */
+export declare function readUnsupportedApproverSourceLabel(type: string): string;
+/**
+ * The short 簽核方式 label the compose review table shows for a user task.
+ */
+export declare function readApproverResolverDetail(resolver: ApproverResolver): string;
+type ManagerRule = Readonly<{
+    fallback?: ApproverResolverFallback;
+    preferClosestOrgUnit?: boolean;
+}>;
+/**
+ * What the 簽核來源 panel edits. The three sources with two stored types each
+ * (本人／主管, 固定組織／表單欄位) carry the screen's own choice instead of the
+ * JSON type; every other known type is held as saved and edited field by
+ * field, and a type this build does not know is held as saved, read-only.
+ *
+ * `levelsUp` is `null` for the 本人 choice (no manager level), otherwise the
+ * stored level.
+ */
+export type ApproverResolverEditorState = (Readonly<{
+    formPath: string;
+    levelsUp: number | null;
+    mode: 'DYNAMIC_FORM';
+}> & ManagerRule) | (Readonly<{
+    formPath: string;
+    mode: 'ORG_UNIT_MANAGER';
+    orgSource: OrgUnitManagerSource;
+    orgUnitId: string;
+}> & ManagerRule) | (Readonly<{
+    levelsUp: number | null;
+    mode: 'NODE_ACTOR';
+    nodeIds: readonly string[];
+}> & ManagerRule) | Readonly<{
+    mode: 'AS_STORED';
+    resolver: ApproverResolver;
+}> | Readonly<{
+    mode: 'UNSUPPORTED';
+    resolver: ApproverResolver;
+    type: string;
+}>;
+export declare function readApproverResolverEditorState(resolver: ApproverResolver): ApproverResolverEditorState;
+/**
+ * The JSON for a screen state. Only the fields that belong to the chosen type
+ * are written, so a field left over from the choice the author switched away
+ * from (the manager level after 回到欄位裡的人, the formPath after 改選固定組織)
+ * never reaches the saved definition.
+ */
+export declare function buildApproverResolver(state: ApproverResolverEditorState): ApproverResolver;
+/**
+ * Applies the 簽核人 select: 0 is the person themselves, 1-3 their manager.
+ * Sources with no such choice come back as the same state.
+ */
+export declare function withApproverSubject(state: ApproverResolverEditorState, value: number): ApproverResolverEditorState;
+/**
+ * Applies the 組織 choice of 指定組織主管. A form-field org starts with 只取最近
+ * 一層主管 on (SPEC 3.3) unless the author already chose; a fixed org keeps the
+ * stored choice as it is. Switching back does not take the default off again:
+ * the toggle keeps whatever value the resolver has, and stays visible.
+ */
+export declare function withOrgUnitSource(state: ApproverResolverEditorState, source: OrgUnitManagerSource): ApproverResolverEditorState;
+/** The id of the read-only entry an unknown resolver type is shown as. */
+export declare const UNSUPPORTED_APPROVER_SOURCE_OPTION_ID = "UNSUPPORTED";
+export type ApproverSourceChoice = Readonly<{
+    /** Hint under the select, `null` when nothing needs saying. */
+    hint: string | null;
+    options: readonly Readonly<{
+        id: string;
+        name: string;
+    }>[];
+    selected: Readonly<{
+        id: string;
+        name: string;
+    }>;
+}>;
+/**
+ * The 簽核來源 select: the source options, plus, for a type this build does
+ * not know, a read-only entry carrying its name that is the current value: it
+ * is shown, never edited, and nothing is written unless the author explicitly
+ * picks a different source (which replaces the stored one).
+ * `readApproverResolverMode` would call such a type 指定會員.
+ */
+export declare function readApproverSourceChoice(state: ApproverResolverEditorState): ApproverSourceChoice;
+/**
+ * The resolver a 簽核來源 pick produces, or `null` when the pick must change
+ * nothing: no option, an id that is not an option (the read-only unsupported
+ * entry included), or the source already stored. Re-picking the shown source
+ * used to rebuild a clean default and wipe what the author had filled in.
+ *
+ * "Already stored" is the state's own mode, not the displayed option: an
+ * EXPRESSION resolver is displayed as 指定會員 but is not one, so picking 指定會員
+ * still switches it.
+ */
+export declare function readApproverSourcePick(resolver: ApproverResolver, optionId: string | null, positions: readonly PositionRecord[]): ApproverResolver | null;
+export type ApproverSubjectChoice = Readonly<{
+    /** The stored level is below 1 (or fractional): shown, not offered again. */
+    invalid: boolean;
+    options: readonly ManagerLevelOption[];
+    selected: ManagerLevelOption;
+}>;
+/**
+ * The 簽核人 select of ② and ③. A stored manager level the list has no option
+ * for (invalid, or a level above 3) is appended so the select can show it.
+ */
+export declare function readApproverSubjectChoice(state: ApproverResolverEditorState): ApproverSubjectChoice | null;
+/**
+ * The state a 簽核人 pick produces, or `null` for a no-op (the shown choice
+ * picked again, the invalid-level entry, an id that is not an option).
+ */
+export declare function readApproverSubjectPick(state: ApproverResolverEditorState, optionId: string | null): ApproverResolverEditorState | null;
+export type ApproverManagerRuleView = Readonly<{
+    fallback: ApproverResolverFallback;
+    preferClosestOrgUnit: boolean;
+    /** 主管鏈 has no 只取最近一層主管. */
+    showPreferClosestOrgUnit: boolean;
+}>;
+/**
+ * The 只取最近一層主管 / 無主管時 pair of a resolver that looks a manager up,
+ * `null` for one that does not (so 本人 shows neither).
+ */
+export declare function readApproverManagerRule(resolver: ApproverResolver): ApproverManagerRuleView | null;
+export declare function withPreferClosestOrgUnit(resolver: ApproverResolver, preferClosestOrgUnit: boolean): ApproverResolver;
+export {};

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

@@ -0,0 +1,211 @@
+import { ApproverResolver, ApproverResolverFallback } 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';
+export type ApproverResolverMode = Extract<ApproverResolver['type'], 'DIRECT' | 'DYNAMIC_FORM' | 'NODE_ACTOR' | 'ORG_MANAGER' | 'ORG_MANAGER_CHAIN' | 'ORG_UNIT_MANAGER' | 'ORG_UNIT_MEMBER' | 'ORG_UNIT_POSITION' | 'POSITION'>;
+export type ApproverResolverModeOption = Readonly<{
+    id: ApproverResolverMode;
+    name: string;
+}>;
+export type ManagerLevelOption = Readonly<{
+    id: string;
+    name: string;
+    value: number;
+}>;
+export type MemberSelectOption = Readonly<{
+    displayName: string;
+    email: string;
+    id: string;
+    memberId: string;
+    name: string;
+    /**
+     * Set on the placeholder written when a member's profile could not be
+     * fetched. Marking it explicitly lets {@link mergeMemberOptions} replace the
+     * placeholder once the real profile turns up, instead of the "未知會員"
+     * sentinel sticking for the rest of the session.
+     */
+    unresolved?: boolean;
+}>;
+export declare const APPROVER_RESOLVER_MODE_OPTIONS: readonly ApproverResolverModeOption[];
+export declare const MANAGER_LEVEL_OPTIONS: readonly ManagerLevelOption[];
+export type NodeNameRecord = Readonly<{
+    id: string;
+    name: string;
+}>;
+/**
+ * The 簽核人 choices of the two sources that start from "someone": the person
+ * the source names, or their manager one to three levels up. `value` 0 is the
+ * person themselves; it is what the select stores for a source with no
+ * manager level.
+ */
+export declare const FORM_MEMBER_SUBJECT_OPTIONS: readonly ManagerLevelOption[];
+export declare const NODE_ACTOR_SUBJECT_OPTIONS: readonly ManagerLevelOption[];
+export type OrgUnitManagerSource = 'FIXED' | 'FORM_FIELD';
+export declare const ORG_UNIT_SOURCE_OPTIONS: readonly Readonly<{
+    id: OrgUnitManagerSource;
+    name: string;
+}>[];
+/**
+ * The option for a stored level. A level this screen has no option for (a
+ * hand-written or AI-written definition) is shown as itself rather than
+ * mistaken for another one.
+ */
+export declare function readApproverSubjectOption(options: readonly ManagerLevelOption[], levelsUp: number): ManagerLevelOption;
+/**
+ * The option for the manager level a FORM_MEMBER_MANAGER / NODE_ACTOR_MANAGER
+ * definition stores. Those types always name a manager, so a level below 1 (or
+ * not a whole number) is a broken definition: it is shown as an invalid level
+ * rather than as the option whose `value` happens to be 0 (本人). The stored
+ * JSON is never touched by this read; the publish lint is what blocks it.
+ */
+export declare function readStoredManagerLevelOption(options: readonly ManagerLevelOption[], levelsUp: number): ManagerLevelOption;
+export declare function readApproverResolverMode(value: string): ApproverResolverMode;
+export declare function readDefaultApproverResolver(value: string | null, positions: readonly PositionRecord[]): ApproverResolver;
+export declare function updateApproverResolverFallback(resolver: ApproverResolver, fallback: ApproverResolverFallback): ApproverResolver;
+export declare function readManagerLevelOption(levelsUp: number): ManagerLevelOption;
+export declare function readManagerLevelOptionById(id: string | null): ManagerLevelOption;
+/**
+ * Every member id a resolver names outright, so the designer can pre-fetch
+ * their display names on load.
+ *
+ * The manager resolvers' `DIRECT` fallback ("固定改派") counts: it is a member
+ * the author picked and the property form renders it through
+ * `readMemberSelectOption`, which falls back to the "未知會員" sentinel for any
+ * id it cannot find. Leaving it out meant a saved fallback always rendered as
+ * 未知會員 until an unrelated search happened to return that member.
+ */
+export declare function readApproverResolverMemberIds(resolver: ApproverResolver): readonly string[];
+export declare function readApproverResolverSummary(resolver: ApproverResolver, memberOptions: readonly MemberSelectOption[], orgUnits: readonly OrgUnitRecord[], positions: readonly PositionRecord[], formSchema: FormDefinitionSchema | null, nodes?: readonly NodeNameRecord[]): string;
+export declare function readMemberEmailSummary(memberIds: readonly string[], memberOptions: readonly MemberSelectOption[], emptyLabel: string): string;
+export declare function readOrgUnitDisplayName(orgUnits: readonly OrgUnitRecord[], orgUnitId: string): string;
+export declare function readPositionDisplayName(positions: readonly PositionRecord[], positionId: string): string;
+export declare function readSelectedOrgUnitOption(orgUnits: readonly OrgUnitRecord[], orgUnitId: string): OrgUnitOption | null;
+export declare function readSelectedPositionOption(positions: readonly PositionRecord[], positionId: string): PositionOption | null;
+export declare function readMemberSelectOption(options: readonly MemberSelectOption[], memberId: string): MemberSelectOption;
+export declare function readFallbackMemberSelectOption(memberId: string): MemberSelectOption;
+/**
+ * The one label for a resolver `type` this build does not know (a definition
+ * saved by a newer BPMCore): the designer's read-only 簽核來源 entry, the node
+ * summary and the compose review table all say it with this.
+ */
+export declare function readUnsupportedApproverSourceLabel(type: string): string;
+/**
+ * The short 簽核方式 label the compose review table shows for a user task.
+ */
+export declare function readApproverResolverDetail(resolver: ApproverResolver): string;
+type ManagerRule = Readonly<{
+    fallback?: ApproverResolverFallback;
+    preferClosestOrgUnit?: boolean;
+}>;
+/**
+ * What the 簽核來源 panel edits. The three sources with two stored types each
+ * (本人／主管, 固定組織／表單欄位) carry the screen's own choice instead of the
+ * JSON type; every other known type is held as saved and edited field by
+ * field, and a type this build does not know is held as saved, read-only.
+ *
+ * `levelsUp` is `null` for the 本人 choice (no manager level), otherwise the
+ * stored level.
+ */
+export type ApproverResolverEditorState = (Readonly<{
+    formPath: string;
+    levelsUp: number | null;
+    mode: 'DYNAMIC_FORM';
+}> & ManagerRule) | (Readonly<{
+    formPath: string;
+    mode: 'ORG_UNIT_MANAGER';
+    orgSource: OrgUnitManagerSource;
+    orgUnitId: string;
+}> & ManagerRule) | (Readonly<{
+    levelsUp: number | null;
+    mode: 'NODE_ACTOR';
+    nodeIds: readonly string[];
+}> & ManagerRule) | Readonly<{
+    mode: 'AS_STORED';
+    resolver: ApproverResolver;
+}> | Readonly<{
+    mode: 'UNSUPPORTED';
+    resolver: ApproverResolver;
+    type: string;
+}>;
+export declare function readApproverResolverEditorState(resolver: ApproverResolver): ApproverResolverEditorState;
+/**
+ * The JSON for a screen state. Only the fields that belong to the chosen type
+ * are written, so a field left over from the choice the author switched away
+ * from (the manager level after 回到欄位裡的人, the formPath after 改選固定組織)
+ * never reaches the saved definition.
+ */
+export declare function buildApproverResolver(state: ApproverResolverEditorState): ApproverResolver;
+/**
+ * Applies the 簽核人 select: 0 is the person themselves, 1-3 their manager.
+ * Sources with no such choice come back as the same state.
+ */
+export declare function withApproverSubject(state: ApproverResolverEditorState, value: number): ApproverResolverEditorState;
+/**
+ * Applies the 組織 choice of 指定組織主管. A form-field org starts with 只取最近
+ * 一層主管 on (SPEC 3.3) unless the author already chose; a fixed org keeps the
+ * stored choice as it is. Switching back does not take the default off again:
+ * the toggle keeps whatever value the resolver has, and stays visible.
+ */
+export declare function withOrgUnitSource(state: ApproverResolverEditorState, source: OrgUnitManagerSource): ApproverResolverEditorState;
+/** The id of the read-only entry an unknown resolver type is shown as. */
+export declare const UNSUPPORTED_APPROVER_SOURCE_OPTION_ID = "UNSUPPORTED";
+export type ApproverSourceChoice = Readonly<{
+    /** Hint under the select, `null` when nothing needs saying. */
+    hint: string | null;
+    options: readonly Readonly<{
+        id: string;
+        name: string;
+    }>[];
+    selected: Readonly<{
+        id: string;
+        name: string;
+    }>;
+}>;
+/**
+ * The 簽核來源 select: the source options, plus, for a type this build does
+ * not know, a read-only entry carrying its name that is the current value: it
+ * is shown, never edited, and nothing is written unless the author explicitly
+ * picks a different source (which replaces the stored one).
+ * `readApproverResolverMode` would call such a type 指定會員.
+ */
+export declare function readApproverSourceChoice(state: ApproverResolverEditorState): ApproverSourceChoice;
+/**
+ * The resolver a 簽核來源 pick produces, or `null` when the pick must change
+ * nothing: no option, an id that is not an option (the read-only unsupported
+ * entry included), or the source already stored. Re-picking the shown source
+ * used to rebuild a clean default and wipe what the author had filled in.
+ *
+ * "Already stored" is the state's own mode, not the displayed option: an
+ * EXPRESSION resolver is displayed as 指定會員 but is not one, so picking 指定會員
+ * still switches it.
+ */
+export declare function readApproverSourcePick(resolver: ApproverResolver, optionId: string | null, positions: readonly PositionRecord[]): ApproverResolver | null;
+export type ApproverSubjectChoice = Readonly<{
+    /** The stored level is below 1 (or fractional): shown, not offered again. */
+    invalid: boolean;
+    options: readonly ManagerLevelOption[];
+    selected: ManagerLevelOption;
+}>;
+/**
+ * The 簽核人 select of ② and ③. A stored manager level the list has no option
+ * for (invalid, or a level above 3) is appended so the select can show it.
+ */
+export declare function readApproverSubjectChoice(state: ApproverResolverEditorState): ApproverSubjectChoice | null;
+/**
+ * The state a 簽核人 pick produces, or `null` for a no-op (the shown choice
+ * picked again, the invalid-level entry, an id that is not an option).
+ */
+export declare function readApproverSubjectPick(state: ApproverResolverEditorState, optionId: string | null): ApproverResolverEditorState | null;
+export type ApproverManagerRuleView = Readonly<{
+    fallback: ApproverResolverFallback;
+    preferClosestOrgUnit: boolean;
+    /** 主管鏈 has no 只取最近一層主管. */
+    showPreferClosestOrgUnit: boolean;
+}>;
+/**
+ * The 只取最近一層主管 / 無主管時 pair of a resolver that looks a manager up,
+ * `null` for one that does not (so 本人 shows neither).
+ */
+export declare function readApproverManagerRule(resolver: ApproverResolver): ApproverManagerRuleView | null;
+export declare function withPreferClosestOrgUnit(resolver: ApproverResolver, preferClosestOrgUnit: boolean): ApproverResolver;
+export {};

package/dist/views/templates/designer/dry-run-assignee-label.d.cts

@@ -11,6 +11,8 @@ export type DryRunAssigneeDirectory = Readonly<{
     formFields: readonly FormFieldRecord[];
     /** Display name of a real member id, or `null` when it is not known. */
     memberName: (memberId: string) => string | null;
+    /** Nodes of the workflow, to name the stages a `nodeActor:` placeholder lists. */
+    nodes: readonly NamedRecord[];
     orgUnits: readonly NamedRecord[];
     positions: readonly NamedRecord[];
 }>;

package/dist/views/templates/designer/dry-run-assignee-label.d.ts

@@ -11,6 +11,8 @@ export type DryRunAssigneeDirectory = Readonly<{
     formFields: readonly FormFieldRecord[];
     /** Display name of a real member id, or `null` when it is not known. */
     memberName: (memberId: string) => string | null;
+    /** Nodes of the workflow, to name the stages a `nodeActor:` placeholder lists. */
+    nodes: readonly NamedRecord[];
     orgUnits: readonly NamedRecord[];
     positions: readonly NamedRecord[];
 }>;

package/dist/views/templates/designer/dry-run-sample-data.d.cts

@@ -7,3 +7,9 @@ export declare function readDryRunSampleFormData(schema: FormDefinitionSchema |
  * excludes the initiator look skipped or stopped when it would not be.
  */
 export declare function readDryRunFormMemberPlaceholder(fieldKey: string): string;
+/**
+ * Sample value of an org_unit field: a placeholder, since the dry run has no
+ * way to know which organization a submitter would pick. The engine reports
+ * 依表單欄位的組織主管 by field key, not by this value.
+ */
+export declare function readDryRunFormOrgUnitPlaceholder(fieldKey: string): string;

package/dist/views/templates/designer/dry-run-sample-data.d.ts

@@ -7,3 +7,9 @@ export declare function readDryRunSampleFormData(schema: FormDefinitionSchema |
  * excludes the initiator look skipped or stopped when it would not be.
  */
 export declare function readDryRunFormMemberPlaceholder(fieldKey: string): string;
+/**
+ * Sample value of an org_unit field: a placeholder, since the dry run has no
+ * way to know which organization a submitter would pick. The engine reports
+ * 依表單欄位的組織主管 by field key, not by this value.
+ */
+export declare function readDryRunFormOrgUnitPlaceholder(fieldKey: string): string;

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

@@ -18,6 +18,8 @@ export type DynamicFormFieldChoice = Readonly<{
     selected: MemberFieldOption | null;
 }>;
 export declare const NO_MEMBER_FIELD_HINT = "\u8868\u55AE\u4E2D\u6C92\u6709\u300C\u4EBA\u54E1\u9078\u64C7\u300D\u6B04\u4F4D\uFF0C\u8ACB\u5148\u5230\u8868\u55AE\u8A2D\u8A08\u52A0\u5165";
+export declare const NO_SINGLE_MEMBER_FIELD_HINT = "\u8868\u55AE\u4E2D\u6C92\u6709\u55AE\u9078\u7684\u300C\u4EBA\u54E1\u9078\u64C7\u300D\u6B04\u4F4D\uFF0C\u8ACB\u5148\u5230\u8868\u55AE\u8A2D\u8A08\u52A0\u5165";
+export declare const NO_ORG_UNIT_FIELD_HINT = "\u8868\u55AE\u4E2D\u6C92\u6709\u300C\u7D44\u7E54\u9078\u64C7\u300D\u6B04\u4F4D\uFF0C\u8ACB\u5148\u5230\u8868\u55AE\u8A2D\u8A08\u52A0\u5165";
 /** Only member fields can feed a 依表單欄位指定 approver resolver. */
 export declare function readMemberFieldOptions(schema: FormDefinitionSchema | null): readonly MemberFieldOption[];
 /**
@@ -28,8 +30,31 @@ export declare function readMemberFieldOptions(schema: FormDefinitionSchema | nu
  * back — the resolver stays invalid until a real field is chosen.
  */
 export declare function readDynamicFormFieldChoice(schema: FormDefinitionSchema | null, formPath: string): DynamicFormFieldChoice;
+/**
+ * Member fields a manager can be looked up from: one person per submission,
+ * so a multi-select member field is not offered (SPEC 5.2). Same warnings as
+ * {@link readMemberFieldOptions}.
+ */
+export declare function readSingleMemberFieldOptions(schema: FormDefinitionSchema | null): readonly MemberFieldOption[];
+/** The field picker for 簽核人 = 直屬／第二層／第三層主管 of a form person. */
+export declare function readFormMemberManagerFieldChoice(schema: FormDefinitionSchema | null, formPath: string): DynamicFormFieldChoice;
+/**
+ * Every 組織選擇 field of the form, optional or hidden ones included; the
+ * ones that cannot be published carry the reason as `warning`, the way member
+ * fields do.
+ */
+export declare function readOrgUnitFieldOptions(schema: FormDefinitionSchema | null): readonly MemberFieldOption[];
+/** The field picker for 組織 = 表單欄位 of 指定組織主管. */
+export declare function readFormOrgUnitFieldChoice(schema: FormDefinitionSchema | null, formPath: string): DynamicFormFieldChoice;
 /**
  * 依表單欄位：<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.
  */
 export declare function readDynamicFormSummary(schema: FormDefinitionSchema | null, formPath: string): string;
+/**
+ * 依表單欄位：<label>的<level>; marks a field that cannot feed a manager lookup
+ * (not a member field, or one that takes several people).
+ */
+export declare function readFormMemberManagerSummary(schema: FormDefinitionSchema | null, formPath: string, levelName: string): string;
+/** 依表單欄位：<label>所選組織的主管, with a marker for a non-org field. */
+export declare function readFormOrgUnitManagerSummary(schema: FormDefinitionSchema | null, formPath: string): string;

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

@@ -18,6 +18,8 @@ export type DynamicFormFieldChoice = Readonly<{
     selected: MemberFieldOption | null;
 }>;
 export declare const NO_MEMBER_FIELD_HINT = "\u8868\u55AE\u4E2D\u6C92\u6709\u300C\u4EBA\u54E1\u9078\u64C7\u300D\u6B04\u4F4D\uFF0C\u8ACB\u5148\u5230\u8868\u55AE\u8A2D\u8A08\u52A0\u5165";
+export declare const NO_SINGLE_MEMBER_FIELD_HINT = "\u8868\u55AE\u4E2D\u6C92\u6709\u55AE\u9078\u7684\u300C\u4EBA\u54E1\u9078\u64C7\u300D\u6B04\u4F4D\uFF0C\u8ACB\u5148\u5230\u8868\u55AE\u8A2D\u8A08\u52A0\u5165";
+export declare const NO_ORG_UNIT_FIELD_HINT = "\u8868\u55AE\u4E2D\u6C92\u6709\u300C\u7D44\u7E54\u9078\u64C7\u300D\u6B04\u4F4D\uFF0C\u8ACB\u5148\u5230\u8868\u55AE\u8A2D\u8A08\u52A0\u5165";
 /** Only member fields can feed a 依表單欄位指定 approver resolver. */
 export declare function readMemberFieldOptions(schema: FormDefinitionSchema | null): readonly MemberFieldOption[];
 /**
@@ -28,8 +30,31 @@ export declare function readMemberFieldOptions(schema: FormDefinitionSchema | nu
  * back — the resolver stays invalid until a real field is chosen.
  */
 export declare function readDynamicFormFieldChoice(schema: FormDefinitionSchema | null, formPath: string): DynamicFormFieldChoice;
+/**
+ * Member fields a manager can be looked up from: one person per submission,
+ * so a multi-select member field is not offered (SPEC 5.2). Same warnings as
+ * {@link readMemberFieldOptions}.
+ */
+export declare function readSingleMemberFieldOptions(schema: FormDefinitionSchema | null): readonly MemberFieldOption[];
+/** The field picker for 簽核人 = 直屬／第二層／第三層主管 of a form person. */
+export declare function readFormMemberManagerFieldChoice(schema: FormDefinitionSchema | null, formPath: string): DynamicFormFieldChoice;
+/**
+ * Every 組織選擇 field of the form, optional or hidden ones included; the
+ * ones that cannot be published carry the reason as `warning`, the way member
+ * fields do.
+ */
+export declare function readOrgUnitFieldOptions(schema: FormDefinitionSchema | null): readonly MemberFieldOption[];
+/** The field picker for 組織 = 表單欄位 of 指定組織主管. */
+export declare function readFormOrgUnitFieldChoice(schema: FormDefinitionSchema | null, formPath: string): DynamicFormFieldChoice;
 /**
  * 依表單欄位：<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.
  */
 export declare function readDynamicFormSummary(schema: FormDefinitionSchema | null, formPath: string): string;
+/**
+ * 依表單欄位：<label>的<level>; marks a field that cannot feed a manager lookup
+ * (not a member field, or one that takes several people).
+ */
+export declare function readFormMemberManagerSummary(schema: FormDefinitionSchema | null, formPath: string, levelName: string): string;
+/** 依表單欄位：<label>所選組織的主管, with a marker for a non-org field. */
+export declare function readFormOrgUnitManagerSummary(schema: FormDefinitionSchema | null, formPath: string): string;

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

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

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

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

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

@@ -0,0 +1,38 @@
+import { WorkflowDefinition } from '@rytass/bpm-core-shared/workflow';
+export type NodeActorOption = Readonly<{
+    id: string;
+    name: string;
+}>;
+export type NodeActorStageChoice = Readonly<{
+    /** What the 關卡 picker offers, with any stale stored choice appended. */
+    options: readonly NodeActorOption[];
+    /**
+     * Live problems of the whole selection (coverage, parallel branches, a stage
+     * that can be skipped, ...), or the hint that nothing can be picked.
+     */
+    problems: readonly string[];
+    selected: readonly NodeActorOption[];
+}>;
+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 of 依前面關卡的簽核者: the user tasks upstream of `nodeId`
+ * that always end with a real signer (`readNodeActorSourceSkipReasons` is
+ * empty: no entry condition, no 跳過此關, no 逾時自動核准). Whether the whole group
+ * covers every path, or straddles a parallel split, is a property of the
+ * selection, not of one stage, so it is reported as `problems` and never used
+ * to filter the list (SPEC 5.2: the 154 CF_HR_0002 cases rest on two mutually
+ * exclusive stages that would each fail the coverage test alone).
+ *
+ * A stored stage that no longer qualifies stays in the list, marked, so the
+ * stored choice stays visible until the author fixes it.
+ */
+export declare function readNodeActorStageChoice(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
+ * designer to show before publish. An empty stage list is left to
+ * `readApproverResolverIssue`, which owns that message.
+ */
+export declare function readNodeActorGraphIssues(definition: WorkflowDefinition): readonly string[];

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

@@ -0,0 +1,38 @@
+import { WorkflowDefinition } from '@rytass/bpm-core-shared/workflow';
+export type NodeActorOption = Readonly<{
+    id: string;
+    name: string;
+}>;
+export type NodeActorStageChoice = Readonly<{
+    /** What the 關卡 picker offers, with any stale stored choice appended. */
+    options: readonly NodeActorOption[];
+    /**
+     * Live problems of the whole selection (coverage, parallel branches, a stage
+     * that can be skipped, ...), or the hint that nothing can be picked.
+     */
+    problems: readonly string[];
+    selected: readonly NodeActorOption[];
+}>;
+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 of 依前面關卡的簽核者: the user tasks upstream of `nodeId`
+ * that always end with a real signer (`readNodeActorSourceSkipReasons` is
+ * empty: no entry condition, no 跳過此關, no 逾時自動核准). Whether the whole group
+ * covers every path, or straddles a parallel split, is a property of the
+ * selection, not of one stage, so it is reported as `problems` and never used
+ * to filter the list (SPEC 5.2: the 154 CF_HR_0002 cases rest on two mutually
+ * exclusive stages that would each fail the coverage test alone).
+ *
+ * A stored stage that no longer qualifies stays in the list, marked, so the
+ * stored choice stays visible until the author fixes it.
+ */
+export declare function readNodeActorStageChoice(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
+ * designer to show before publish. An empty stage list is left to
+ * `readApproverResolverIssue`, which owns that message.
+ */
+export declare function readNodeActorGraphIssues(definition: WorkflowDefinition): readonly string[];