@vef-framework-react/approval 2.30.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 -202
  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 +32 -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 +2 -2
  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 +28 -3
  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
@@ -0,0 +1,24 @@
1
+ import { AnnotationView, FieldAnchor, InstanceDetail, TimelineEntry } from '../../types';
2
+ import { ViewerTask, SaveAnnotationParams } from '../..';
3
+ import { UseMutateAsyncFunction } from '@tanstack/react-query';
4
+ export interface AnnotationThread {
5
+ annotation: AnnotationView;
6
+ responses: AnnotationView[];
7
+ }
8
+ export interface AnnotationGroup {
9
+ entry?: TimelineEntry;
10
+ name: string;
11
+ threads: AnnotationThread[];
12
+ }
13
+ export declare function matchesField(annotation: AnnotationView, location: FieldAnchor): boolean;
14
+ export declare function matchesFieldSlot(annotation: AnnotationView, location: FieldAnchor): boolean;
15
+ export declare function useAnnotations(detail: InstanceDetail): {
16
+ groups: AnnotationGroup[];
17
+ task: ViewerTask | undefined;
18
+ canRespond: boolean;
19
+ save: UseMutateAsyncFunction<AnnotationView, Error, SaveAnnotationParams, unknown>;
20
+ remove: UseMutateAsyncFunction<unknown, Error, {
21
+ id: string;
22
+ }, unknown>;
23
+ pending: boolean;
24
+ };
@@ -0,0 +1,14 @@
1
+ import { BusinessFormHandle } from '../plugins';
2
+ import { BusinessKindRenderer } from '..';
3
+ import { RefObject } from 'react';
4
+ export declare function MissingBusinessKind(): import("@emotion/react/jsx-runtime").JSX.Element;
5
+ export declare function useBusinessForm(kind?: string): {
6
+ renderer: BusinessKindRenderer | undefined;
7
+ handle: RefObject<BusinessFormHandle | null>;
8
+ ready: boolean;
9
+ blockedReason: string | undefined;
10
+ onAvailabilityChange: (available: boolean, reason?: string) => void;
11
+ collect: ({ inlineError }?: {
12
+ inlineError?: boolean | undefined;
13
+ }) => Promise<Record<string, unknown>>;
14
+ };
@@ -0,0 +1,2 @@
1
+ import { ModalProps } from '@vef-framework-react/components';
2
+ export declare function CappedModal(props: Omit<ModalProps, "centered" | "styles">): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -1,5 +1,6 @@
1
1
  export interface AdminInstanceDetailPanelProps {
2
2
  instanceId: string;
3
+ voidPermission?: string;
3
4
  }
4
5
  /**
5
6
  * The supervision detail of an instance: the same header / form / timeline /
@@ -8,4 +9,4 @@ export interface AdminInstanceDetailPanelProps {
8
9
  * audit trail. Admin write actions (terminate, reassign) live on the admin
9
10
  * page rows, not in this panel.
10
11
  */
11
- export declare function AdminInstanceDetailPanel({ instanceId }: AdminInstanceDetailPanelProps): import("@emotion/react/jsx-runtime").JSX.Element;
12
+ export declare function AdminInstanceDetailPanel({ instanceId, voidPermission }: AdminInstanceDetailPanelProps): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -1,7 +1,8 @@
1
- import { FormRendererApi, FormSchema, PresentationDevice } from '@vef-framework-react/form-editor';
1
+ import { FormRendererApi, FormRendererProps, FormSchema, PresentationDevice } from '@vef-framework-react/form-editor';
2
2
  import { RefObject } from 'react';
3
3
  import { FieldPermission, FormData, UserInfo } from '../../types';
4
4
  export interface InstanceFormPanelProps {
5
+ renderFieldExtra?: FormRendererProps["renderFieldExtra"];
5
6
  /**
6
7
  * The version-pinned host form-designer document. Absent for flows without
7
8
  * a form — renders an empty state.
@@ -47,4 +48,4 @@ export interface InstanceFormPanelProps {
47
48
  * come from `ApprovalProvider` (defaulting to the approval profile); the
48
49
  * applicant and the form-visible globals form its evaluation context.
49
50
  */
50
- export declare function InstanceFormPanel({ schema, formData, fieldPermissions, applicant, globals, disabled, device, apiRef, onSubmit }: InstanceFormPanelProps): import("@emotion/react/jsx-runtime").JSX.Element;
51
+ export declare function InstanceFormPanel({ schema, formData, fieldPermissions, applicant, globals, disabled, device, apiRef, onSubmit, renderFieldExtra }: InstanceFormPanelProps): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -1,3 +1,4 @@
1
+ export declare function displayInstanceTitle(title?: string, instanceNo?: string): string;
1
2
  /**
2
3
  * Format a backend timestamp (`YYYY-MM-DD HH:mm:ss`) for display, or a dash
3
4
  * when empty.
@@ -1,3 +1,4 @@
1
+ export { AnnotationComposer, AnnotationList, AnnotationResponseComposer, useAnnotations } from './annotations';
1
2
  export { InstanceDetailPanel, InstanceHeader, type InstanceDetailPanelProps, type UrgeTarget } from './detail';
2
3
  export { AdminInstanceDetailPanel, type AdminInstanceDetailPanelProps } from './detail/admin';
3
4
  export { InstanceDetailDrawer, type InstanceDetailDrawerProps } from './detail/drawer';
@@ -0,0 +1,5 @@
1
+ export declare function InstanceListTitle({ title, instanceNo, unread }: {
2
+ title: string;
3
+ instanceNo: string;
4
+ unread?: boolean;
5
+ }): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -1,5 +1,7 @@
1
+ import { ReactNode } from 'react';
1
2
  import { TimelineEntry } from '../../types';
2
3
  export interface InstanceTimelineProps {
4
+ renderEntryExtra?: (entry: TimelineEntry) => ReactNode;
3
5
  timeline: TimelineEntry[];
4
6
  }
5
7
  /**
@@ -8,4 +10,4 @@ export interface InstanceTimelineProps {
8
10
  * milestones. Participants, carbon copies, and side activities render
9
11
  * beneath each node header.
10
12
  */
11
- export declare function InstanceTimeline({ timeline }: InstanceTimelineProps): import("@emotion/react/jsx-runtime").JSX.Element;
13
+ export declare function InstanceTimeline({ timeline, renderEntryExtra }: InstanceTimelineProps): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -27,6 +27,10 @@ export interface UserLabelProps {
27
27
  * omitting them.
28
28
  */
29
29
  export declare function UserLabel({ user, showAvatar, avatarSize }: UserLabelProps): import("@emotion/react/jsx-runtime").JSX.Element;
30
+ export declare function PredecessorLabel({ user, reason }: {
31
+ user: UserInfo;
32
+ reason?: string;
33
+ }): import("@emotion/react/jsx-runtime").JSX.Element;
30
34
  export interface UserGroupProps {
31
35
  users: UserInfo[];
32
36
  /**
@@ -0,0 +1,8 @@
1
+ import { VoidTarget } from '../../types';
2
+ export declare function DirectVoidDialog({ open, target, onClose }: {
3
+ open: boolean;
4
+ target: VoidTarget & {
5
+ instanceId: string;
6
+ };
7
+ onClose: () => void;
8
+ }): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -0,0 +1,27 @@
1
+ import { UploadedFileMeta, UploadFile } from '@vef-framework-react/components';
2
+ import { VoidOptions, VoidRecord, VoidTarget } from '../../types';
3
+ import { Dispatch, SetStateAction } from 'react';
4
+ import { UseQueryResult } from '@tanstack/react-query';
5
+ import { PlanVoidResult, VoidPlan } from '../..';
6
+ export declare function useVoidDraft(target: VoidTarget & {
7
+ instanceId: string;
8
+ }, mode: "admin" | "requester", record?: VoidRecord): {
9
+ reason: string;
10
+ setReason: Dispatch<SetStateAction<string>>;
11
+ options: VoidOptions;
12
+ setOptions: Dispatch<SetStateAction<VoidOptions>>;
13
+ existing: string[];
14
+ setExisting: Dispatch<SetStateAction<string[]>>;
15
+ files: (UploadFile<any> & Partial<UploadedFileMeta>)[];
16
+ setFiles: Dispatch<SetStateAction<(UploadFile<any> & Partial<UploadedFileMeta>)[]>>;
17
+ preview: UseQueryResult<NoInfer< PlanVoidResult>, Error>;
18
+ plan: VoidPlan | undefined;
19
+ previewIssue: string | undefined;
20
+ uploadIssue: string | undefined;
21
+ issue: string | undefined;
22
+ attachments: string[];
23
+ };
24
+ export declare function VoidFormFields({ target, draft }: {
25
+ target: VoidTarget;
26
+ draft: ReturnType<typeof useVoidDraft>;
27
+ }): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -0,0 +1,3 @@
1
+ import { BusinessKindRenderer } from '../../plugins';
2
+ export declare const VoidRequestStartForm: BusinessKindRenderer["StartForm"];
3
+ export declare const VoidRequestDetailView: BusinessKindRenderer["DetailView"];
@@ -0,0 +1,16 @@
1
+ import { ReactNode } from 'react';
2
+ import { VoidPlan, VoidRecord, VoidRequestSummary, VoidTarget } from '../../types';
3
+ export declare function PlanSummary({ plan }: {
4
+ plan: VoidPlan;
5
+ }): import("@emotion/react/jsx-runtime").JSX.Element;
6
+ export declare function TargetSummary({ target }: {
7
+ target: VoidTarget;
8
+ }): import("@emotion/react/jsx-runtime").JSX.Element;
9
+ export declare function VoidRecordSummary({ record }: {
10
+ record: VoidRecord;
11
+ }): import("@emotion/react/jsx-runtime").JSX.Element;
12
+ export declare function VoidBanners({ record, request, renderRequest }: {
13
+ record?: VoidRecord;
14
+ request?: VoidRequestSummary;
15
+ renderRequest: (id: string) => ReactNode;
16
+ }): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -0,0 +1,4 @@
1
+ /**
2
+ * A void changes both views of the target, even if an open detail cache has already gone stale.
3
+ */
4
+ export declare function useRefreshVoidTarget(): (instanceId: string) => Promise<[void, void, ...void[]]>;
@@ -2,9 +2,9 @@ export * from './api';
2
2
  export * from './components';
3
3
  export * from './pages';
4
4
  export { APPROVAL_PERMISSIONS } from './permissions';
5
- export type { ActionLogPermissionCodes, ApprovalPermissions, BindingPermissionCodes, CategoryPermissionCodes, DelegationPermissionCodes, FlowPermissionCodes, InstancePermissionCodes, MetricsPermissionCodes, TaskPermissionCodes } from './permissions';
5
+ export type { ActionLogPermissionCodes, ApprovalPermissions, BindingPermissionCodes, CategoryPermissionCodes, DelegationPermissionCodes, FlowPermissionCodes, HandoverPermissionCodes, InstancePermissionCodes, MetricsPermissionCodes, TaskPermissionCodes } from './permissions';
6
6
  export { ApprovalProvider, toEditorPlugins, useApprovalPlugins } from './plugins';
7
- export type { ApprovalPlugins, ApprovalProviderProps, ResolvedApprovalPlugins } from './plugins';
7
+ export type { ApprovalPlugins, ApprovalProviderProps, BusinessFormHandle, BusinessKindRenderer, ResolvedApprovalPlugins } from './plugins';
8
8
  export type { FormGlobalDefinition } from './plugins/form-context';
9
9
  export * from './types';
10
10
  export type { EditorPlugins, KindDescriptor, PickerProps, PrincipalKind, SelectionMode, TenantOption } from '@vef-framework-react/approval-flow-editor';
@@ -0,0 +1,3 @@
1
+ export declare function ApplyHandoversAction({ detailPermission }: {
2
+ detailPermission: string;
3
+ }): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -7,11 +7,13 @@ export interface ApprovalAdminPageProps {
7
7
  instanceQuery?: string;
8
8
  instanceDetail?: string;
9
9
  instanceTerminate?: string;
10
+ instanceVoid?: string;
10
11
  taskQuery?: string;
11
12
  taskReassign?: string;
12
13
  bindingQuery?: string;
13
14
  bindingRetry?: string;
14
15
  metricsQuery?: string;
16
+ handoverApply?: string;
15
17
  };
16
18
  /**
17
19
  * Scope the metrics view to one tenant; omit for the caller's default
@@ -1,9 +1,10 @@
1
1
  export interface InstancesPanelProps {
2
2
  detailPermission: string;
3
+ voidPermission?: string;
3
4
  terminatePermission: string;
4
5
  }
5
6
  /**
6
7
  * Cross-user instance supervision: the paginated list, the read-only admin
7
8
  * detail (with the audit trail), and force termination.
8
9
  */
9
- export declare function InstancesPanel({ detailPermission, terminatePermission }: InstancesPanelProps): import("@emotion/react/jsx-runtime").JSX.Element;
10
+ export declare function InstancesPanel({ detailPermission, voidPermission, terminatePermission }: InstancesPanelProps): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -1,9 +1,14 @@
1
1
  import { KindDescriptor } from '@vef-framework-react/approval-flow-editor';
2
- import { InitiatorKind, InitiatorParams } from '../../../types';
2
+ import { BusinessKindDescriptor, Flow, InitiatorKind, InitiatorParams } from '../../../types';
3
3
  import { CategoryTreeOption } from '../../category-page/form';
4
4
  import { FlowDraftBasic } from './types';
5
5
  export interface BasicStepProps {
6
6
  basic: FlowDraftBasic;
7
+ businessKinds?: BusinessKindDescriptor[];
8
+ loadingBusinessKinds: boolean;
9
+ businessKindsError?: string;
10
+ isVoidable: boolean | undefined;
11
+ selectedVoidFlow?: Flow | null;
7
12
  initiators: InitiatorParams[];
8
13
  /**
9
14
  * The initiator kinds this application registers, from
@@ -24,4 +29,4 @@ export interface BasicStepProps {
24
29
  * the business binding. Everything here lands in `create`/`update`; the
25
30
  * deployable definition follows in the next steps.
26
31
  */
27
- export declare function BasicStep({ basic, initiators, initiatorKinds, categoryOptions, isEditing, onBasicChange, onInitiatorsChange }: BasicStepProps): import("@emotion/react/jsx-runtime").JSX.Element;
32
+ export declare function BasicStep({ basic, businessKinds, loadingBusinessKinds, businessKindsError, isVoidable, selectedVoidFlow, initiators, initiatorKinds, categoryOptions, isEditing, onBasicChange, onInitiatorsChange }: BasicStepProps): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -0,0 +1,5 @@
1
+ import { ApprovalFormField } from '@vef-framework-react/approval-form-bridge';
2
+ export declare function FieldCatalog({ fields, title }: {
3
+ fields: ApprovalFormField[];
4
+ title: string;
5
+ }): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -2,6 +2,7 @@ import { ApprovalFormField } from '@vef-framework-react/approval-form-bridge';
2
2
  import { FlowDraft } from './types';
3
3
  export interface ReviewStepProps {
4
4
  draft: FlowDraft;
5
+ businessKindLabel?: string;
5
6
  /**
6
7
  * The deploy-derived field inventory (from the client-side projection).
7
8
  */
@@ -15,4 +16,4 @@ export interface ReviewStepProps {
15
16
  * Step 4 — review the assembled draft and choose the release options. Submit
16
17
  * runs create/update → deploy → optional publish as one chain.
17
18
  */
18
- export declare function ReviewStep({ draft, fields, versionDescription, publishNow, onVersionDescriptionChange, onPublishNowChange }: ReviewStepProps): import("@emotion/react/jsx-runtime").JSX.Element;
19
+ export declare function ReviewStep({ draft, businessKindLabel, fields, versionDescription, publishNow, onVersionDescriptionChange, onPublishNowChange }: ReviewStepProps): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -1,6 +1,7 @@
1
1
  import { FlowDefinition } from '@vef-framework-react/approval-flow-editor';
2
+ import { WindowRule } from '@vef-framework-react/calendar';
2
3
  import { FormSchema } from '@vef-framework-react/form-editor';
3
- import { BindingMode, BusinessBindingConfig, InitiatorParams, StorageMode } from '../../../types';
4
+ import { BusinessBindingConfig, InitiatorParams, StorageMode, VoidPolicy } from '../../../types';
4
5
  /**
5
6
  * The flow-settings half of the designer draft — everything
6
7
  * `approval/flow.create` / `update` consumes.
@@ -17,11 +18,14 @@ export interface FlowDraftBasic {
17
18
  icon?: string;
18
19
  description?: string;
19
20
  labels: Record<string, string>;
20
- bindingMode: BindingMode;
21
+ businessKind?: string;
21
22
  businessBinding?: BusinessBindingConfig;
22
23
  adminUserIds: string[];
23
24
  isAllInitiationAllowed: boolean;
24
25
  instanceTitleTemplate: string;
26
+ initiationWindow?: WindowRule;
27
+ voidPolicy?: VoidPolicy;
28
+ voidFlowCode?: string;
25
29
  }
26
30
  /**
27
31
  * The complete designer draft: flow settings plus the deployable definition.
@@ -47,6 +51,13 @@ export declare function createEmptyDraft(tenantId: string): FlowDraft;
47
51
  * SQL identifiers.
48
52
  */
49
53
  export declare const BUSINESS_IDENTIFIER_PATTERN: RegExp;
54
+ /**
55
+ * Check direct field substitutions used by the title input. Advanced Go
56
+ * templates may rebind dot; only the server can parse those authoritatively.
57
+ */
58
+ export declare function missingTitleField(template: string, fields: ReadonlyArray<{
59
+ key: string;
60
+ }>): string | undefined;
50
61
  /**
51
62
  * The initiator rules a draft should be saved with.
52
63
  *
@@ -0,0 +1,14 @@
1
+ import { Flow } from '../../../types';
2
+ import { FlowDraftBasic } from './types';
3
+ import { UseQueryResult } from '@tanstack/react-query';
4
+ /**
5
+ * A saved code can lie on any page. The server's keyword filter searches names.
6
+ */
7
+ export declare function useSelectedVoidFlow(tenantId: string, code?: string): UseQueryResult<NoInfer<Flow | null>, Error>;
8
+ export declare function voidPolicyIssue(basic: FlowDraftBasic, isVoidable: boolean | undefined, selected?: Flow | null): string | undefined;
9
+ export declare function VoidPolicySection({ basic, isVoidable, selected, onChange }: {
10
+ basic: FlowDraftBasic;
11
+ isVoidable: boolean | undefined;
12
+ selected?: Flow | null;
13
+ onChange: (patch: Partial<FlowDraftBasic>) => void;
14
+ }): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -1,3 +1,4 @@
1
+ import { VoidTarget } from '../../types';
1
2
  export interface StartInstanceDrawerProps {
2
3
  /**
3
4
  * The flow to start; `null` keeps the drawer closed.
@@ -13,10 +14,15 @@ export interface StartInstanceDrawerProps {
13
14
  * Fired with the submission acknowledged, after the drawer closes.
14
15
  */
15
16
  onStarted?: () => void;
17
+ /**
18
+ * Presents the server's reason after a closed initiation window dismisses the drawer.
19
+ */
20
+ onWindowClosed?: (message: string) => void;
21
+ voidTarget?: VoidTarget;
16
22
  }
17
23
  /**
18
24
  * The initiation drawer: loads the published form document through the
19
25
  * start-gate (`my.get_start_form`) and submits `instance.start` with the
20
26
  * renderer-validated form data.
21
27
  */
22
- export declare function StartInstanceDrawer({ flowCode, businessRef, onClose, onStarted }: StartInstanceDrawerProps): import("@emotion/react/jsx-runtime").JSX.Element;
28
+ export declare function StartInstanceDrawer({ flowCode, businessRef, voidTarget, onClose, onStarted, onWindowClosed }: StartInstanceDrawerProps): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -31,6 +31,7 @@ export declare const APPROVAL_PERMISSIONS: {
31
31
  readonly resubmit: "approval.instance.resubmit";
32
32
  readonly cc: "approval.instance.cc";
33
33
  readonly terminate: "approval.instance.terminate";
34
+ readonly void: "approval.instance.void";
34
35
  };
35
36
  readonly task: {
36
37
  readonly query: "approval.task.query";
@@ -56,6 +57,12 @@ export declare const APPROVAL_PERMISSIONS: {
56
57
  readonly update: "approval.delegation.update";
57
58
  readonly delete: "approval.delegation.delete";
58
59
  };
60
+ readonly annotation: {
61
+ readonly write: "approval.annotation.write";
62
+ };
63
+ readonly handover: {
64
+ readonly apply: "approval.handover.apply";
65
+ };
59
66
  };
60
67
  export type ApprovalPermissions = typeof APPROVAL_PERMISSIONS;
61
68
  export type CategoryPermissionCodes = ApprovalPermissions["category"];
@@ -66,3 +73,4 @@ export type ActionLogPermissionCodes = ApprovalPermissions["actionLog"];
66
73
  export type MetricsPermissionCodes = ApprovalPermissions["metrics"];
67
74
  export type BindingPermissionCodes = ApprovalPermissions["binding"];
68
75
  export type DelegationPermissionCodes = ApprovalPermissions["delegation"];
76
+ export type HandoverPermissionCodes = ApprovalPermissions["handover"];
@@ -1,14 +1,38 @@
1
1
  import { EditorPlugins, FormFieldDefinition, PickerProps, TenantOption } from '@vef-framework-react/approval-flow-editor';
2
2
  import { CodeSetDescriptor, DataSourceApi, DataSourceResolver, DeviceRegistries, LinkageEvaluators } from '@vef-framework-react/form-editor';
3
- import { FC, PropsWithChildren, ReactNode } from 'react';
4
- import { KindOptions } from '../types';
3
+ import { FC, PropsWithChildren, ReactNode, Ref } from 'react';
4
+ import { InstanceDetail, KindOptions, StartForm, ViewerTask, VoidOptions, VoidTarget } from '../types';
5
5
  import { FormGlobalDefinition } from './form-context';
6
+ export interface BusinessFormHandle {
7
+ collect: () => Promise<Record<string, unknown>>;
8
+ }
9
+ export interface BusinessKindRenderer {
10
+ StartForm: FC<{
11
+ flow: StartForm;
12
+ businessRef?: string;
13
+ handle: Ref<BusinessFormHandle>;
14
+ voidTarget?: VoidTarget;
15
+ onAvailabilityChange?: (available: boolean, reason?: string) => void;
16
+ }>;
17
+ VoidOptions?: FC<{
18
+ value: VoidOptions;
19
+ onChange: (value: VoidOptions) => void;
20
+ }>;
21
+ DetailView: FC<{
22
+ detail: InstanceDetail;
23
+ view: unknown;
24
+ myTask?: ViewerTask;
25
+ handle: Ref<BusinessFormHandle>;
26
+ onAvailabilityChange?: (available: boolean, reason?: string) => void;
27
+ }>;
28
+ }
6
29
  /**
7
30
  * Host-integration points shared by every approval page and component. Wrap
8
31
  * the approval routes in one `ApprovalProvider` and every picker, registry,
9
32
  * and renderer below is resolved from it — pages never take these as props.
10
33
  */
11
34
  export interface ApprovalPlugins {
35
+ businessKinds?: Record<string, BusinessKindRenderer>;
12
36
  /**
13
37
  * Pickers that resolve concrete ids, keyed by kind. The flow designer and
14
38
  * the runtime action dialogs (transfer, add assignee, CC) share them.
@@ -99,6 +123,7 @@ export interface ApprovalPlugins {
99
123
  export interface ResolvedApprovalPlugins extends ApprovalPlugins {
100
124
  registries: DeviceRegistries;
101
125
  }
126
+ export declare function resolveBusinessRenderer(kinds: ApprovalPlugins["businessKinds"], kind?: string): BusinessKindRenderer | undefined;
102
127
  export interface ApprovalProviderProps extends PropsWithChildren {
103
128
  plugins?: ApprovalPlugins;
104
129
  }
@@ -122,4 +147,4 @@ export declare function useApprovalPlugins(): ResolvedApprovalPlugins;
122
147
  * still loading the editor falls back to the framework built-ins, which is
123
148
  * why the designer stays usable before the query resolves.
124
149
  */
125
- export declare function toEditorPlugins(plugins: ResolvedApprovalPlugins, formFields: FormFieldDefinition[], kindOptions?: KindOptions): EditorPlugins;
150
+ export declare function toEditorPlugins(plugins: ResolvedApprovalPlugins, formFields: FormFieldDefinition[] | undefined, kindOptions?: KindOptions): EditorPlugins;
@@ -1,7 +1,9 @@
1
1
  import { FormSchema } from '@vef-framework-react/form-editor';
2
+ import { AnnotationView } from './annotation';
2
3
  import { FormData, UserInfo } from './base';
3
4
  import { InstanceFlowGraph, TimelineEntry } from './detail';
4
5
  import { ActionType, BindingProjectionStatus, InstanceStatus, TaskStatus } from './enums';
6
+ import { VoidPolicy, VoidRecord, VoidRequestSummary } from './void';
5
7
  /**
6
8
  * An approval instance in the admin view, mirroring `admin.Instance`.
7
9
  */
@@ -25,6 +27,7 @@ export interface AdminTask {
25
27
  taskId: string;
26
28
  instanceId: string;
27
29
  instanceTitle: string;
30
+ instanceNo: string;
28
31
  flowName: string;
29
32
  nodeName: string;
30
33
  assignee: UserInfo;
@@ -32,6 +35,7 @@ export interface AdminTask {
32
35
  createdAt: string;
33
36
  deadline?: string;
34
37
  finishedAt?: string;
38
+ predecessor?: UserInfo;
35
39
  }
36
40
  /**
37
41
  * The instance's runtime state within an admin detail view, mirroring
@@ -52,7 +56,10 @@ export interface AdminInstanceInfo {
52
56
  status: InstanceStatus;
53
57
  currentNodeId?: string;
54
58
  currentNodeName?: string;
59
+ businessKind?: string;
55
60
  businessRef?: string;
61
+ voidPolicy?: VoidPolicy;
62
+ voidFlowCode?: string | null;
56
63
  formData?: FormData;
57
64
  /**
58
65
  * The form-visible part of the instance's globals snapshot — the form's
@@ -70,6 +77,11 @@ export interface AdminInstanceInfo {
70
77
  export interface AdminInstanceDetail {
71
78
  instance: AdminInstanceInfo;
72
79
  formSchema?: FormSchema;
80
+ businessView?: unknown;
81
+ annotations?: AnnotationView[];
82
+ voidRecord?: VoidRecord;
83
+ voidRequest?: VoidRequestSummary;
84
+ availableActions?: Array<"void">;
73
85
  timeline: TimelineEntry[];
74
86
  flowGraph: InstanceFlowGraph;
75
87
  }
@@ -189,3 +201,18 @@ export interface ReassignTaskParams {
189
201
  export interface RetryBusinessProjectionParams {
190
202
  projectionId: string;
191
203
  }
204
+ export interface ApplyHandoversParams {
205
+ userIds: string[];
206
+ }
207
+ export interface HandoverItem {
208
+ instanceId: string;
209
+ taskId?: string;
210
+ ccRecordId?: string;
211
+ predecessor: UserInfo;
212
+ successor?: UserInfo;
213
+ }
214
+ export interface HandoverReport {
215
+ transferred: HandoverItem[];
216
+ unassigned: HandoverItem[];
217
+ awaitingApplicant: string[];
218
+ }
@@ -0,0 +1,60 @@
1
+ import { UserInfo } from './base';
2
+ export type AnnotationStatus = "draft" | "published" | "discarded";
3
+ export type AnnotationResolution = "addressed" | "declined";
4
+ export type AnnotationAudience = {
5
+ scope: "participants" | "applicant";
6
+ } | {
7
+ scope: "nodes";
8
+ nodeIds: string[];
9
+ } | {
10
+ scope: "users";
11
+ userIds: string[];
12
+ };
13
+ export interface FieldAnchor {
14
+ field: string;
15
+ row?: number;
16
+ column?: string;
17
+ }
18
+ export interface AnnotationView {
19
+ id: string;
20
+ instanceId: string;
21
+ nodeId: string;
22
+ nodeName: string;
23
+ visitId?: string;
24
+ taskId?: string;
25
+ author: UserInfo;
26
+ status: AnnotationStatus;
27
+ anchor?: unknown;
28
+ content: string;
29
+ audience: AnnotationAudience;
30
+ parentId?: string;
31
+ resolution?: AnnotationResolution;
32
+ publishedAt?: string;
33
+ createdAt?: string;
34
+ }
35
+ export type SaveAnnotationParams = {
36
+ id?: string;
37
+ taskId: string;
38
+ content: string;
39
+ anchor?: unknown;
40
+ audience?: AnnotationAudience;
41
+ } | {
42
+ id?: string;
43
+ parentId: string;
44
+ resolution: AnnotationResolution;
45
+ content: string;
46
+ };
47
+ export declare const APPROVAL_ERROR_CODES: {
48
+ readonly businessKindNotRegistered: 40029;
49
+ readonly businessKindRequired: 40030;
50
+ readonly annotationNotFound: 40031;
51
+ readonly annotationNotEditable: 40032;
52
+ readonly annotationAnchorInvalid: 40033;
53
+ readonly annotationAudienceInvalid: 40034;
54
+ readonly annotationNotAllowed: 40035;
55
+ readonly voidNotAllowed: 40036;
56
+ readonly instanceNotVoidable: 40037;
57
+ readonly voidBlocked: 40038;
58
+ readonly voidRequestPending: 40039;
59
+ readonly voidPolicyInvalid: 40040;
60
+ };
@@ -1,6 +1,10 @@
1
1
  import { NodeKind } from '@vef-framework-react/approval-flow-editor';
2
+ import { AdminInstanceDetail } from './admin';
2
3
  import { UserInfo } from './base';
3
4
  import { ActivityAction, NodeProgressStatus, NodeVisitStatus } from './enums';
5
+ import { MyInstanceDetail } from './my';
6
+ export type InstanceDetail = MyInstanceDetail | AdminInstanceDetail;
7
+ export declare function isMyInstanceDetail(detail: InstanceDetail): detail is MyInstanceDetail;
4
8
  /**
5
9
  * One assignee's involvement at an approval/handle node during a single
6
10
  * visit, mirroring the Go `approval.NodeParticipant`. `taskId` is what task
@@ -18,6 +22,8 @@ export interface NodeParticipant {
18
22
  attachments?: string[];
19
23
  actionTime?: string;
20
24
  transferTo?: UserInfo;
25
+ predecessor?: UserInfo;
26
+ handoverReason?: string;
21
27
  }
22
28
  /**
23
29
  * A side action recorded at a node, mirroring the Go `approval.Activity`.
@@ -53,7 +59,7 @@ export interface CCRecipient {
53
59
  * milestone the way withdraw and terminate do, and a rejection stops on the
54
60
  * approval node with a `rejected` visit instead of traversing to the end.
55
61
  */
56
- export type TimelineEntryKind = "start" | "approval" | "handle" | "cc" | "end" | "withdraw" | "terminate";
62
+ export type TimelineEntryKind = "start" | "approval" | "handle" | "cc" | "end" | "withdraw" | "terminate" | "void";
57
63
  /**
58
64
  * One step of the instance timeline — the chronological, node-by-node account
59
65
  * of the path an instance actually took, mirroring `approval.TimelineEntry`.
@@ -61,6 +67,7 @@ export type TimelineEntryKind = "start" | "approval" | "handle" | "cc" | "end" |
61
67
  * predicted.
62
68
  */
63
69
  export interface TimelineEntry {
70
+ visitId?: string;
64
71
  kind: TimelineEntryKind;
65
72
  nodeId?: string;
66
73
  name?: string;
@@ -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";