@vef-framework-react/approval 2.29.0 → 2.31.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (186) hide show
  1. package/dist/cjs/api/admin-api.cjs +1 -1
  2. package/dist/cjs/api/flow-api.cjs +1 -1
  3. package/dist/cjs/api/instance-api.cjs +1 -1
  4. package/dist/cjs/api/my-api.cjs +1 -1
  5. package/dist/cjs/components/action-dialog/index.cjs +1 -1
  6. package/dist/cjs/components/action-dialog/user-selection.cjs +1 -0
  7. package/dist/cjs/components/annotations/composers.cjs +1 -0
  8. package/dist/cjs/components/annotations/field-anchor.cjs +1 -0
  9. package/dist/cjs/components/annotations/index.cjs +1 -0
  10. package/dist/cjs/components/annotations/use-annotations.cjs +1 -0
  11. package/dist/cjs/components/business-form.cjs +1 -0
  12. package/dist/cjs/components/capped-modal.cjs +1 -0
  13. package/dist/cjs/components/detail/action-modals.cjs +1 -1
  14. package/dist/cjs/components/detail/admin.cjs +1 -1
  15. package/dist/cjs/components/detail/index.cjs +1 -1
  16. package/dist/cjs/components/flow-graph/node.cjs +1 -1
  17. package/dist/cjs/components/flow-graph/people-overlay.cjs +1 -1
  18. package/dist/cjs/components/form-panel/index.cjs +1 -1
  19. package/dist/cjs/components/format.cjs +1 -1
  20. package/dist/cjs/components/index.cjs +1 -1
  21. package/dist/cjs/components/instance-list-title.cjs +1 -0
  22. package/dist/cjs/components/principal/index.cjs +1 -1
  23. package/dist/cjs/components/status/colors.cjs +1 -1
  24. package/dist/cjs/components/status/index.cjs +1 -1
  25. package/dist/cjs/components/status/labels.cjs +1 -1
  26. package/dist/cjs/components/timeline/index.cjs +1 -1
  27. package/dist/cjs/components/user/index.cjs +1 -1
  28. package/dist/cjs/components/void/direct-dialog.cjs +1 -0
  29. package/dist/cjs/components/void/form.cjs +1 -0
  30. package/dist/cjs/components/void/request-renderer.cjs +1 -0
  31. package/dist/cjs/components/void/summary.cjs +1 -0
  32. package/dist/cjs/components/void/use-refresh.cjs +1 -0
  33. package/dist/cjs/index.cjs +1 -1
  34. package/dist/cjs/pages/admin-page/apply-handovers.cjs +1 -0
  35. package/dist/cjs/pages/admin-page/index.cjs +1 -1
  36. package/dist/cjs/pages/admin-page/instances.cjs +1 -1
  37. package/dist/cjs/pages/admin-page/metrics.cjs +1 -1
  38. package/dist/cjs/pages/admin-page/tasks.cjs +1 -1
  39. package/dist/cjs/pages/category-page/index.cjs +1 -1
  40. package/dist/cjs/pages/delegation-page/index.cjs +1 -1
  41. package/dist/cjs/pages/flow-page/columns.cjs +1 -1
  42. package/dist/cjs/pages/flow-page/designer/basic-step.cjs +1 -1
  43. package/dist/cjs/pages/flow-page/designer/field-catalog.cjs +1 -0
  44. package/dist/cjs/pages/flow-page/designer/form-step.cjs +1 -1
  45. package/dist/cjs/pages/flow-page/designer/index.cjs +1 -1
  46. package/dist/cjs/pages/flow-page/designer/review-step.cjs +1 -1
  47. package/dist/cjs/pages/flow-page/designer/types.cjs +1 -1
  48. package/dist/cjs/pages/flow-page/designer/void-policy.cjs +1 -0
  49. package/dist/cjs/pages/flow-page/index.cjs +1 -1
  50. package/dist/cjs/pages/index.cjs +1 -1
  51. package/dist/cjs/pages/initiate-page/index.cjs +1 -1
  52. package/dist/cjs/pages/initiate-page/start-drawer.cjs +1 -1
  53. package/dist/cjs/pages/my-instances-page/index.cjs +1 -1
  54. package/dist/cjs/pages/task-center-page/index.cjs +1 -1
  55. package/dist/cjs/permissions.cjs +1 -1
  56. package/dist/cjs/plugins/index.cjs +1 -1
  57. package/dist/cjs/types/annotation.cjs +1 -0
  58. package/dist/cjs/types/detail.cjs +1 -0
  59. package/dist/cjs/types/enums.cjs +1 -1
  60. package/dist/cjs/types/index.cjs +1 -1
  61. package/dist/cjs/types/void.cjs +1 -0
  62. package/dist/es/api/admin-api.js +5 -2
  63. package/dist/es/api/category-api.js +1 -1
  64. package/dist/es/api/delegation-api.js +1 -1
  65. package/dist/es/api/flow-api.js +19 -15
  66. package/dist/es/api/index.js +1 -1
  67. package/dist/es/api/instance-api.js +3 -1
  68. package/dist/es/api/my-api.js +2 -1
  69. package/dist/es/api/query.js +1 -1
  70. package/dist/es/components/action-dialog/index.js +64 -41
  71. package/dist/es/components/action-dialog/user-selection.js +48 -0
  72. package/dist/es/components/annotations/composers.js +231 -0
  73. package/dist/es/components/annotations/field-anchor.js +18 -0
  74. package/dist/es/components/annotations/index.js +271 -0
  75. package/dist/es/components/annotations/use-annotations.js +77 -0
  76. package/dist/es/components/business-form.js +36 -0
  77. package/dist/es/components/capped-modal.js +27 -0
  78. package/dist/es/components/detail/action-modals.js +120 -132
  79. package/dist/es/components/detail/admin.js +109 -74
  80. package/dist/es/components/detail/drawer.js +1 -1
  81. package/dist/es/components/detail/index.js +298 -233
  82. package/dist/es/components/flow-graph/index.js +1 -1
  83. package/dist/es/components/flow-graph/node.js +26 -26
  84. package/dist/es/components/flow-graph/people-overlay.js +104 -100
  85. package/dist/es/components/flow-graph/people.js +1 -1
  86. package/dist/es/components/form-panel/index.js +10 -9
  87. package/dist/es/components/format.js +7 -4
  88. package/dist/es/components/icon.js +1 -1
  89. package/dist/es/components/index.js +11 -8
  90. package/dist/es/components/instance-list-title.js +31 -0
  91. package/dist/es/components/principal/index.js +4 -2
  92. package/dist/es/components/status/colors.js +3 -2
  93. package/dist/es/components/status/index.js +14 -14
  94. package/dist/es/components/status/labels.js +7 -3
  95. package/dist/es/components/timeline/index.js +79 -69
  96. package/dist/es/components/user/index.js +32 -25
  97. package/dist/es/components/void/direct-dialog.js +62 -0
  98. package/dist/es/components/void/form.js +100 -0
  99. package/dist/es/components/void/request-renderer.js +91 -0
  100. package/dist/es/components/void/summary.js +142 -0
  101. package/dist/es/components/void/use-refresh.js +22 -0
  102. package/dist/es/index.js +33 -27
  103. package/dist/es/pages/admin-page/apply-handovers.js +185 -0
  104. package/dist/es/pages/admin-page/index.js +50 -43
  105. package/dist/es/pages/admin-page/instances.js +50 -52
  106. package/dist/es/pages/admin-page/metrics.js +34 -33
  107. package/dist/es/pages/admin-page/projections.js +1 -1
  108. package/dist/es/pages/admin-page/tasks.js +59 -57
  109. package/dist/es/pages/category-page/columns.js +1 -1
  110. package/dist/es/pages/category-page/form.js +1 -1
  111. package/dist/es/pages/category-page/index.js +21 -21
  112. package/dist/es/pages/delegation-page/columns.js +1 -1
  113. package/dist/es/pages/delegation-page/form.js +1 -1
  114. package/dist/es/pages/delegation-page/index.js +19 -19
  115. package/dist/es/pages/flow-page/columns.js +6 -6
  116. package/dist/es/pages/flow-page/designer/basic-step.js +202 -146
  117. package/dist/es/pages/flow-page/designer/field-catalog.js +47 -0
  118. package/dist/es/pages/flow-page/designer/flow-step.js +1 -1
  119. package/dist/es/pages/flow-page/designer/form-step.js +14 -14
  120. package/dist/es/pages/flow-page/designer/index.js +248 -204
  121. package/dist/es/pages/flow-page/designer/review-step.js +38 -60
  122. package/dist/es/pages/flow-page/designer/types.js +13 -5
  123. package/dist/es/pages/flow-page/designer/void-policy.js +135 -0
  124. package/dist/es/pages/flow-page/index.js +18 -18
  125. package/dist/es/pages/flow-page/search.js +1 -1
  126. package/dist/es/pages/flow-page/versions.js +1 -1
  127. package/dist/es/pages/index.js +9 -9
  128. package/dist/es/pages/initiate-page/index.js +133 -86
  129. package/dist/es/pages/initiate-page/start-drawer.js +153 -64
  130. package/dist/es/pages/my-instances-page/index.js +57 -77
  131. package/dist/es/pages/task-center-page/index.js +73 -68
  132. package/dist/es/pages/task-center-page/search.js +1 -1
  133. package/dist/es/permissions.js +6 -3
  134. package/dist/es/plugins/form-context.js +1 -1
  135. package/dist/es/plugins/index.js +33 -21
  136. package/dist/es/types/annotation.js +18 -0
  137. package/dist/es/types/detail.js +7 -0
  138. package/dist/es/types/enums.js +3 -2
  139. package/dist/es/types/index.js +6 -3
  140. package/dist/es/types/void.js +5 -0
  141. package/dist/types/api/admin-api.d.ts +4 -1
  142. package/dist/types/api/flow-api.d.ts +4 -2
  143. package/dist/types/api/instance-api.d.ts +5 -1
  144. package/dist/types/api/my-api.d.ts +2 -1
  145. package/dist/types/components/action-dialog/index.d.ts +8 -2
  146. package/dist/types/components/action-dialog/user-selection.d.ts +18 -0
  147. package/dist/types/components/annotations/composers.d.ts +14 -0
  148. package/dist/types/components/annotations/field-anchor.d.ts +3 -0
  149. package/dist/types/components/annotations/index.d.ts +22 -0
  150. package/dist/types/components/annotations/use-annotations.d.ts +24 -0
  151. package/dist/types/components/business-form.d.ts +14 -0
  152. package/dist/types/components/capped-modal.d.ts +2 -0
  153. package/dist/types/components/detail/admin.d.ts +2 -1
  154. package/dist/types/components/form-panel/index.d.ts +3 -2
  155. package/dist/types/components/format.d.ts +1 -0
  156. package/dist/types/components/index.d.ts +1 -0
  157. package/dist/types/components/instance-list-title.d.ts +5 -0
  158. package/dist/types/components/timeline/index.d.ts +3 -1
  159. package/dist/types/components/user/index.d.ts +4 -0
  160. package/dist/types/components/void/direct-dialog.d.ts +8 -0
  161. package/dist/types/components/void/form.d.ts +27 -0
  162. package/dist/types/components/void/request-renderer.d.ts +3 -0
  163. package/dist/types/components/void/summary.d.ts +16 -0
  164. package/dist/types/components/void/use-refresh.d.ts +4 -0
  165. package/dist/types/index.d.ts +3 -3
  166. package/dist/types/pages/admin-page/apply-handovers.d.ts +3 -0
  167. package/dist/types/pages/admin-page/index.d.ts +2 -0
  168. package/dist/types/pages/admin-page/instances.d.ts +2 -1
  169. package/dist/types/pages/flow-page/designer/basic-step.d.ts +7 -2
  170. package/dist/types/pages/flow-page/designer/field-catalog.d.ts +5 -0
  171. package/dist/types/pages/flow-page/designer/review-step.d.ts +2 -1
  172. package/dist/types/pages/flow-page/designer/types.d.ts +13 -2
  173. package/dist/types/pages/flow-page/designer/void-policy.d.ts +14 -0
  174. package/dist/types/pages/initiate-page/start-drawer.d.ts +7 -1
  175. package/dist/types/permissions.d.ts +8 -0
  176. package/dist/types/plugins/index.d.ts +39 -4
  177. package/dist/types/types/admin.d.ts +27 -0
  178. package/dist/types/types/annotation.d.ts +60 -0
  179. package/dist/types/types/detail.d.ts +8 -1
  180. package/dist/types/types/enums.d.ts +5 -10
  181. package/dist/types/types/flow.d.ts +25 -5
  182. package/dist/types/types/index.d.ts +3 -1
  183. package/dist/types/types/instance.d.ts +1 -2
  184. package/dist/types/types/my.d.ts +16 -0
  185. package/dist/types/types/void.d.ts +58 -0
  186. package/package.json +8 -7
@@ -2,11 +2,11 @@ import { KindDescriptor } from '@vef-framework-react/approval-flow-editor';
2
2
  /**
3
3
  * Lifecycle status of an approval instance.
4
4
  */
5
- export type InstanceStatus = "running" | "approved" | "rejected" | "withdrawn" | "returned" | "terminated";
5
+ export type InstanceStatus = "running" | "approved" | "rejected" | "withdrawn" | "returned" | "terminated" | "voided";
6
6
  /**
7
- * The instance statuses that are final — no further transition can occur.
7
+ * The instance statuses that are final for approval processing.
8
8
  */
9
- export declare const FINAL_INSTANCE_STATUSES: readonly ["approved", "rejected", "terminated"];
9
+ export declare const FINAL_INSTANCE_STATUSES: readonly ["approved", "rejected", "terminated", "voided"];
10
10
  /**
11
11
  * Whether an instance status is final, mirroring `InstanceStatus.IsFinal`.
12
12
  */
@@ -26,7 +26,7 @@ export type NodeProgressStatus = "pending" | "active" | "passed" | "rejected" |
26
26
  /**
27
27
  * Action types recorded in the action log, mirroring `approval.ActionType`.
28
28
  */
29
- export type ActionType = "submit" | "approve" | "handle" | "reject" | "transfer" | "withdraw" | "cancel" | "rollback" | "add_assignee" | "remove_assignee" | "execute" | "resubmit" | "reassign" | "terminate" | "add_cc";
29
+ export type ActionType = "submit" | "approve" | "handle" | "reject" | "transfer" | "withdraw" | "cancel" | "rollback" | "add_assignee" | "remove_assignee" | "execute" | "resubmit" | "reassign" | "terminate" | "add_cc" | "handover" | "void";
30
30
  /**
31
31
  * The activity vocabulary of timeline / flow-graph projections: every
32
32
  * `ActionType` plus `urge` (persisted as urge records, not action logs).
@@ -44,11 +44,6 @@ export type AddAssigneeType = "before" | "after" | "parallel";
44
44
  * Status of a flow version.
45
45
  */
46
46
  export type VersionStatus = "draft" | "published" | "archived";
47
- /**
48
- * Flow-level binding mode: `standalone` stores form data in the approval
49
- * tables, `business` write-backs into an existing business table.
50
- */
51
- export type BindingMode = "standalone" | "business";
52
47
  /**
53
48
  * Version-level physical storage mode of form data.
54
49
  */
@@ -84,4 +79,4 @@ export type FieldPermission = "visible" | "editable" | "hidden" | "required";
84
79
  * task, and the node's permission toggles (`computeActions` in
85
80
  * `get_my_instance_detail.go` is the source of truth).
86
81
  */
87
- export type InstanceAction = "approve" | "reject" | "handle" | "transfer" | "rollback" | "withdraw" | "resubmit" | "add_assignee" | "remove_assignee" | "add_cc" | "urge";
82
+ export type InstanceAction = "approve" | "reject" | "handle" | "transfer" | "rollback" | "withdraw" | "resubmit" | "add_assignee" | "remove_assignee" | "add_cc" | "urge" | "request_void";
@@ -1,9 +1,12 @@
1
1
  import { AssigneeKind, CcKind, FlowDefinition, FormFieldDefinition, KindDescriptor } from '@vef-framework-react/approval-flow-editor';
2
+ import { ApprovalFormField } from '@vef-framework-react/approval-form-bridge';
3
+ import { WindowRule } from '@vef-framework-react/calendar';
2
4
  import { FormSchema } from '@vef-framework-react/form-editor';
3
5
  import { FullAudited } from './base';
4
- import { BindingMode, InitiatorKind, InstanceStatus, StorageMode, VersionStatus } from './enums';
6
+ import { InitiatorKind, InstanceStatus, StorageMode, VersionStatus } from './enums';
7
+ import { VoidPolicy } from './void';
5
8
  /**
6
- * Business binding for a `business`-mode flow, mirroring the Go
9
+ * Optional projection for a business-kind flow, mirroring the Go
7
10
  * `approval.BusinessBindingConfig`. All table / column names must be plain
8
11
  * SQL identifiers; `keyColumns` must exactly match a complete, non-null
9
12
  * primary or unique key on `tableName`.
@@ -30,6 +33,7 @@ export interface BusinessBindingConfig {
30
33
  * A flow definition record, mirroring the Go `approval.Flow`.
31
34
  */
32
35
  export interface Flow extends FullAudited {
36
+ businessKind?: string;
33
37
  /**
34
38
  * The tenant that owns and manages the flow; it never changes.
35
39
  */
@@ -54,18 +58,21 @@ export interface Flow extends FullAudited {
54
58
  * characters.
55
59
  */
56
60
  labels?: Record<string, string>;
57
- bindingMode: BindingMode;
58
61
  businessBinding?: BusinessBindingConfig | null;
59
62
  adminUserIds: string[];
60
63
  isAllInitiationAllowed: boolean;
61
64
  instanceTitleTemplate: string;
62
65
  isActive: boolean;
63
66
  currentVersion: number;
67
+ initiationWindow?: WindowRule | null;
68
+ voidPolicy?: VoidPolicy;
69
+ voidFlowCode?: string | null;
64
70
  }
65
71
  /**
66
72
  * A versioned snapshot of a flow definition, mirroring `approval.FlowVersion`.
67
73
  */
68
74
  export interface FlowVersion extends FullAudited {
75
+ businessKind?: string;
69
76
  flowId: string;
70
77
  version: number;
71
78
  status: VersionStatus;
@@ -115,6 +122,12 @@ export interface KindOptions {
115
122
  ccs: Array<KindDescriptor<CcKind>>;
116
123
  initiators: Array<KindDescriptor<InitiatorKind>>;
117
124
  }
125
+ export interface BusinessKindDescriptor {
126
+ kind: string;
127
+ label: string;
128
+ formFields: ApprovalFormField[];
129
+ isVoidable: boolean;
130
+ }
118
131
  /**
119
132
  * A flow initiator rule, mirroring `approval.FlowInitiator`.
120
133
  */
@@ -135,6 +148,7 @@ export interface InitiatorParams {
135
148
  * Parameters for `approval/flow.create`.
136
149
  */
137
150
  export interface CreateFlowParams {
151
+ businessKind?: string;
138
152
  tenantId: string;
139
153
  /**
140
154
  * Offers the flow to every tenant (`Flow.isShared`). Its code must then be
@@ -147,29 +161,34 @@ export interface CreateFlowParams {
147
161
  icon?: string;
148
162
  description?: string;
149
163
  labels?: Record<string, string>;
150
- bindingMode: BindingMode;
151
164
  businessBinding?: BusinessBindingConfig;
152
165
  adminUserIds?: string[];
153
166
  isAllInitiationAllowed: boolean;
154
167
  instanceTitleTemplate: string;
155
168
  initiators?: InitiatorParams[];
169
+ initiationWindow?: WindowRule | null;
170
+ voidPolicy?: VoidPolicy;
171
+ voidFlowCode?: string | null;
156
172
  }
157
173
  /**
158
174
  * Parameters for `approval/flow.update`. Omitted `labels` clears the stored
159
175
  * set (full replace semantics).
160
176
  */
161
177
  export interface UpdateFlowParams {
178
+ businessKind?: string;
162
179
  flowId: string;
163
180
  name: string;
164
181
  icon?: string;
165
182
  description?: string;
166
183
  labels?: Record<string, string>;
167
- bindingMode: BindingMode;
168
184
  businessBinding?: BusinessBindingConfig;
169
185
  adminUserIds?: string[];
170
186
  isAllInitiationAllowed: boolean;
171
187
  instanceTitleTemplate: string;
172
188
  initiators?: InitiatorParams[];
189
+ initiationWindow?: WindowRule | null;
190
+ voidPolicy?: VoidPolicy;
191
+ voidFlowCode?: string | null;
173
192
  }
174
193
  /**
175
194
  * Parameters for `approval/flow.deploy` — creates a new draft version from
@@ -213,6 +232,7 @@ export interface FlowSearch {
213
232
  * that tenant, which is what a picker of a tenant's usable flows needs.
214
233
  */
215
234
  includeShared?: boolean;
235
+ businessKind?: string;
216
236
  categoryId?: string;
217
237
  keyword?: string;
218
238
  isActive?: boolean;
@@ -1,9 +1,11 @@
1
1
  export type * from './admin';
2
+ export * from './annotation';
2
3
  export type * from './base';
3
4
  export type * from './category';
4
5
  export type * from './delegation';
5
- export type * from './detail';
6
+ export * from './detail';
6
7
  export * from './enums';
7
8
  export type * from './flow';
8
9
  export type * from './instance';
9
10
  export type * from './my';
11
+ export * from './void';
@@ -9,8 +9,7 @@ import { AddAssigneeType, ProcessTaskAction } from './enums';
9
9
  export interface StartInstanceParams {
10
10
  flowCode: string;
11
11
  /**
12
- * Opaque reference to the bound business record; required by convention for
13
- * business-bound flows unless the host's `BusinessRefProvider` derives one.
12
+ * Existing record submitted to the business handler, or an opaque handle for a form flow.
14
13
  */
15
14
  businessRef?: string;
16
15
  formData?: Record<string, unknown>;
@@ -1,12 +1,16 @@
1
+ import { WindowStatus } from '@vef-framework-react/calendar';
1
2
  import { FormSchema } from '@vef-framework-react/form-editor';
3
+ import { AnnotationView } from './annotation';
2
4
  import { FormData, UserInfo } from './base';
3
5
  import { InstanceFlowGraph, TimelineEntry } from './detail';
4
6
  import { AddAssigneeType, FieldPermission, InstanceAction, InstanceStatus, TaskStatus } from './enums';
7
+ import { VoidPolicy, VoidRecord, VoidRequestSummary } from './void';
5
8
  /**
6
9
  * A flow the current user is allowed to initiate, mirroring
7
10
  * `my.AvailableFlow`.
8
11
  */
9
12
  export interface AvailableFlow {
13
+ businessKind?: string;
10
14
  flowId: string;
11
15
  flowCode: string;
12
16
  flowName: string;
@@ -15,6 +19,7 @@ export interface AvailableFlow {
15
19
  labels?: Record<string, string>;
16
20
  categoryId: string;
17
21
  categoryName: string;
22
+ initiationWindow?: WindowStatus | null;
18
23
  }
19
24
  /**
20
25
  * The pre-submission view of a flow for an applicant, mirroring
@@ -23,6 +28,7 @@ export interface AvailableFlow {
23
28
  * like starting the instance.
24
29
  */
25
30
  export interface StartForm {
31
+ businessKind?: string;
26
32
  flowId: string;
27
33
  flowCode: string;
28
34
  flowName: string;
@@ -41,6 +47,7 @@ export interface StartForm {
41
47
  * the form's `$globals`. Absent when the flow exposes none.
42
48
  */
43
49
  globals?: Record<string, unknown>;
50
+ initiationWindow?: WindowStatus | null;
44
51
  }
45
52
  /**
46
53
  * An approval instance submitted by the current user, mirroring
@@ -72,6 +79,7 @@ export interface PendingTask {
72
79
  createdAt: string;
73
80
  deadline?: string;
74
81
  isTimeout: boolean;
82
+ predecessor?: UserInfo;
75
83
  }
76
84
  /**
77
85
  * A task the current user has already processed, mirroring
@@ -88,6 +96,7 @@ export interface CompletedTask {
88
96
  nodeName: string;
89
97
  status: string;
90
98
  finishedAt?: string;
99
+ predecessor?: UserInfo;
91
100
  }
92
101
  /**
93
102
  * A CC notification addressed to the current user, mirroring `my.CCRecord`.
@@ -132,7 +141,10 @@ export interface MyInstanceInfo {
132
141
  status: InstanceStatus;
133
142
  currentNodeId?: string;
134
143
  currentNodeName?: string;
144
+ businessKind?: string;
135
145
  businessRef?: string;
146
+ voidPolicy?: VoidPolicy;
147
+ voidFlowCode?: string | null;
136
148
  formData?: FormData;
137
149
  /**
138
150
  * The form-visible part of the instance's globals snapshot — the form's
@@ -182,6 +194,10 @@ export interface ViewerTask {
182
194
  export interface MyInstanceDetail {
183
195
  instance: MyInstanceInfo;
184
196
  formSchema?: FormSchema;
197
+ businessView?: unknown;
198
+ annotations?: AnnotationView[];
199
+ voidRecord?: VoidRecord;
200
+ voidRequest?: VoidRequestSummary;
185
201
  timeline: TimelineEntry[];
186
202
  flowGraph: InstanceFlowGraph;
187
203
  availableActions: InstanceAction[];
@@ -0,0 +1,58 @@
1
+ import { FullAudited, UserInfo } from './base';
2
+ export declare const VOID_REQUEST_KIND = "approval.void_request";
3
+ export type VoidPolicy = "disabled" | "direct" | "approval";
4
+ export type VoidOptions = Record<string, unknown>;
5
+ export interface VoidPlan {
6
+ blockers: string[];
7
+ reversals: string[];
8
+ followUps: string[];
9
+ }
10
+ export interface VoidRecord extends FullAudited {
11
+ tenantId: string;
12
+ instanceId?: string;
13
+ status: "requested" | "voided" | "dismissed";
14
+ requestInstanceId?: string;
15
+ operator: UserInfo;
16
+ reason?: string;
17
+ attachments?: string[];
18
+ options?: VoidOptions;
19
+ reversals: string[];
20
+ followUps: string[];
21
+ voidedAt?: string;
22
+ }
23
+ export interface VoidRequestSummary {
24
+ requestInstanceId: string;
25
+ requestInstanceNo: string;
26
+ requestStatus: "running" | "returned";
27
+ applicant: UserInfo;
28
+ createdAt: string;
29
+ }
30
+ export interface VoidTarget {
31
+ instanceId?: string;
32
+ instanceNo?: string;
33
+ title?: string;
34
+ flowName?: string;
35
+ applicant?: UserInfo;
36
+ finishedAt?: string;
37
+ businessKind?: string;
38
+ }
39
+ export interface VoidRequestBusinessView {
40
+ target: VoidTarget;
41
+ plan: VoidPlan;
42
+ record: VoidRecord;
43
+ }
44
+ export interface PlanVoidParams {
45
+ instanceId: string;
46
+ options?: VoidOptions;
47
+ }
48
+ export interface PlanVoidResult {
49
+ policy: VoidPolicy;
50
+ plan: VoidPlan;
51
+ }
52
+ export interface RequesterVoidPlanResult extends PlanVoidResult {
53
+ voidFlowCode: string;
54
+ }
55
+ export interface VoidInstanceParams extends PlanVoidParams {
56
+ reason: string;
57
+ attachments?: string[];
58
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vef-framework-react/approval",
3
- "version": "2.29.0",
3
+ "version": "2.31.0",
4
4
  "private": false,
5
5
  "description": "Approval engine pages and runtime components for VEF framework",
6
6
  "keywords": [
@@ -44,12 +44,13 @@
44
44
  "@xyflow/react": "^12.11.1",
45
45
  "dayjs": "^1.11.0",
46
46
  "lucide-react": "^1.23.0",
47
- "@vef-framework-react/approval-form-bridge": "2.29.0",
48
- "@vef-framework-react/approval-flow-editor": "2.29.0",
49
- "@vef-framework-react/core": "2.29.0",
50
- "@vef-framework-react/form-editor": "2.29.0",
51
- "@vef-framework-react/components": "2.29.0",
52
- "@vef-framework-react/shared": "2.29.0"
47
+ "@vef-framework-react/approval-flow-editor": "2.31.0",
48
+ "@vef-framework-react/calendar": "2.31.0",
49
+ "@vef-framework-react/core": "2.31.0",
50
+ "@vef-framework-react/form-editor": "2.31.0",
51
+ "@vef-framework-react/components": "2.31.0",
52
+ "@vef-framework-react/approval-form-bridge": "2.31.0",
53
+ "@vef-framework-react/shared": "2.31.0"
53
54
  },
54
55
  "devDependencies": {
55
56
  "react": "^19.2.7"