@rytass/bpm-core-react 0.16.2 → 0.17.1

package/dist/views/admin/users/index.d.cts

@@ -0,0 +1 @@
+export * from './AdminUsersView.cjs';

package/dist/views/admin/users/index.d.ts

@@ -1 +1 @@
-export * from './AdminUsersView';
+export * from './AdminUsersView.js';

package/dist/views/admin/users/index.js

@@ -1 +1 @@
-export { t as AdminUsersView } from "../../../chunks/users-BSVo_eNe.js";
+export { t as AdminUsersView } from "../../../chunks/users-DRbuDYF1.js";

package/dist/views/admin/webhook-endpoints/AdminWebhookEndpointsView.d.cts

@@ -0,0 +1,8 @@
+import { ReactElement } from 'react';
+/**
+ * Back-office management of database webhook endpoints (ADR 18 §3.13):
+ * create, edit, disable, rotate the signing secret, test-send and read the
+ * change history. Header values and secrets are entered here and never shown
+ * again. Administrator-only on the server.
+ */
+export declare function AdminWebhookEndpointsView(): ReactElement;

package/dist/views/admin/webhook-endpoints/index.d.cts

@@ -0,0 +1 @@
+export * from './AdminWebhookEndpointsView.cjs';

package/dist/views/admin/webhook-endpoints/index.d.ts

@@ -1 +1 @@
-export * from './AdminWebhookEndpointsView';
+export * from './AdminWebhookEndpointsView.js';

package/dist/views/cc/CcView.d.cts

@@ -0,0 +1,7 @@
+import { ReactElement } from 'react';
+/**
+ * Framework-agnostic view for the BPM "cc" inbox — instances the current
+ * member is copied on. Mechanical port of
+ * `apps/client/src/app/cc/page.tsx`.
+ */
+export declare function CcView(): ReactElement;

package/dist/views/cc/index.d.cts

@@ -0,0 +1 @@
+export * from './CcView.cjs';

package/dist/views/cc/index.d.ts

@@ -1 +1 @@
-export * from './CcView';
+export * from './CcView.js';

package/dist/views/dashboard/DashboardView.d.cts

@@ -0,0 +1,7 @@
+import { ReactElement } from 'react';
+/**
+ * Framework-agnostic view for the BPM dashboard. Delegates to the shared
+ * `<DashboardPage>` component. Mechanical port of
+ * `apps/client/src/app/dashboard/page.tsx`.
+ */
+export declare function DashboardView(): ReactElement;

package/dist/views/dashboard/index.d.cts

@@ -0,0 +1 @@
+export * from './DashboardView.cjs';

package/dist/views/dashboard/index.d.ts

@@ -1 +1 @@
-export * from './DashboardView';
+export * from './DashboardView.js';

package/dist/views/delegations/DelegationsView.d.cts

@@ -0,0 +1,2 @@
+import { ReactElement } from 'react';
+export declare function DelegationsView(): ReactElement;

package/dist/views/delegations/index.d.cts

@@ -0,0 +1 @@
+export * from './DelegationsView.cjs';

package/dist/views/delegations/index.d.ts

@@ -1 +1 @@
-export * from './DelegationsView';
+export * from './DelegationsView.js';

package/dist/views/forms/builder/FormBuilderView.d.cts

@@ -0,0 +1,18 @@
+import { ReactElement } from 'react';
+import { FormDefinitionSchema, FormUiSchema } from '@rytass/bpm-core-shared/form';
+export interface FormBuilderViewProps {
+    /**
+     * Initial (or controlled) schema value.
+     * If omitted, the builder starts with empty schema / uiSchema.
+     */
+    readonly value?: {
+        readonly schema: FormDefinitionSchema;
+        readonly uiSchema: FormUiSchema;
+    };
+    /** Called whenever the schema or uiSchema changes. */
+    readonly onChange?: (next: {
+        readonly schema: FormDefinitionSchema;
+        readonly uiSchema: FormUiSchema;
+    }) => void;
+}
+export declare function FormBuilderView({ onChange, value, }: FormBuilderViewProps): ReactElement;

package/dist/views/forms/builder/index.d.cts

@@ -0,0 +1 @@
+export * from './FormBuilderView.cjs';

package/dist/views/forms/builder/index.d.ts

@@ -1 +1 @@
-export * from './FormBuilderView';
+export * from './FormBuilderView.js';

package/dist/views/forms/builder/json-code-editor.d.cts

@@ -0,0 +1,11 @@
+import { ReactElement } from 'react';
+interface JsonCodeEditorProps {
+    readonly disabled?: boolean;
+    readonly height: string;
+    readonly name: string;
+    readonly onChange: (value: string) => void;
+    readonly placeholder: string;
+    readonly value: string;
+}
+export declare function JsonCodeEditor({ disabled, height, name, onChange, placeholder, value, }: JsonCodeEditorProps): ReactElement;
+export {};

package/dist/views/forms/renderer/FormRendererView.d.cts

@@ -0,0 +1,24 @@
+import { CSSProperties, ReactElement } from 'react';
+import { FormDataSourceValueSnapshots, FormDefinitionSchema, FormFieldDefinition, FormUiSchema } from '@rytass/bpm-core-shared/form';
+import { FormRendererValues } from '@rytass/bpm-core-client/form';
+import { FormDataSourceFieldState, FormRendererDataSourceContext } from './form-data-source-field.cjs';
+export interface FormRendererProps {
+    readonly dataSourceContext?: FormRendererDataSourceContext;
+    readonly dataSourceInitialValues?: FormRendererValues;
+    readonly emptyText?: string;
+    readonly errors?: Readonly<Record<string, string>>;
+    readonly maxWidth?: CSSProperties['maxWidth'];
+    readonly onChange?: (values: FormRendererValues) => void;
+    readonly onDataSourceStateChange?: (fieldKey: string, state: Pick<FormDataSourceFieldState, 'hasValue' | 'invalidValues' | 'status'>) => void;
+    readonly onUploadAttachment?: (field: FormFieldDefinition, file: File) => Promise<{
+        readonly id: string;
+    }>;
+    readonly optionSnapshots?: FormDataSourceValueSnapshots;
+    readonly readonly?: boolean;
+    readonly schema: FormDefinitionSchema;
+    readonly singleColumn?: boolean;
+    readonly uiSchema: FormUiSchema;
+    readonly value?: FormRendererValues;
+}
+export declare function FormRenderer({ dataSourceContext, dataSourceInitialValues, emptyText, errors, maxWidth, onChange, onDataSourceStateChange, onUploadAttachment, optionSnapshots, readonly, schema, singleColumn, uiSchema, value, }: FormRendererProps): ReactElement;
+export { FormRenderer as FormRendererView };

package/dist/views/forms/renderer/FormRendererView.d.ts

@@ -1,7 +1,7 @@
 import { CSSProperties, ReactElement } from 'react';
 import { FormDataSourceValueSnapshots, FormDefinitionSchema, FormFieldDefinition, FormUiSchema } from '@rytass/bpm-core-shared/form';
 import { FormRendererValues } from '@rytass/bpm-core-client/form';
-import { FormDataSourceFieldState, FormRendererDataSourceContext } from './form-data-source-field';
+import { FormDataSourceFieldState, FormRendererDataSourceContext } from './form-data-source-field.js';
 export interface FormRendererProps {
     readonly dataSourceContext?: FormRendererDataSourceContext;
     readonly dataSourceInitialValues?: FormRendererValues;

package/dist/views/forms/renderer/form-data-source-field.d.cts

@@ -0,0 +1,65 @@
+import { FormDataSourceValueSnapshots, FormDefinitionSchema, FormFieldDefinition, FormFieldOption, FormFieldValue, FormUiSchema } from '@rytass/bpm-core-shared/form';
+import { FormDataSourceFieldStatus, FormRendererValues } from '@rytass/bpm-core-client/form';
+export type FormRendererDataSourceContext = {
+    readonly kind: 'preview';
+} | {
+    readonly instanceId?: string | null;
+    readonly kind: 'runtime';
+    readonly templateId?: string | null;
+};
+export interface FormDataSourceFieldState {
+    /**
+     * False when nothing can be re-requested — a read-only or context-less field
+     * has no query to retry, so the view must not offer a dead retry action.
+     */
+    readonly canRetry: boolean;
+    readonly error: string | null;
+    readonly hasValue: boolean;
+    readonly hasNextPage: boolean;
+    readonly invalidValues: readonly string[];
+    readonly onReachBottom: () => void;
+    readonly onSearch: (searchText: string) => void;
+    readonly options: readonly FormFieldOption[];
+    readonly retry: () => void;
+    readonly status: FormDataSourceFieldStatus;
+}
+/**
+ * What makes a table cell different from a top-level field: it is addressed by
+ * a schema path, snapshotted under an instance path, and its `ROW_FIELD`
+ * bindings read from its own row rather than the form (ADR 16 §3.3, §3.5).
+ */
+export interface UseFormDataSourceFieldRow {
+    /** The row as it was loaded, so a returned case can tell what changed. */
+    readonly initialValues?: FormRendererValues;
+    readonly values: FormRendererValues;
+}
+export interface UseFormDataSourceFieldInput {
+    readonly context?: FormRendererDataSourceContext;
+    readonly field: FormFieldDefinition;
+    /** Schema path used to address the field; defaults to its own key. */
+    readonly fieldPath?: string;
+    readonly formData: FormRendererValues;
+    readonly initialFormData?: FormRendererValues;
+    readonly initialValue?: FormFieldValue | undefined;
+    readonly optionSnapshots?: FormDataSourceValueSnapshots;
+    readonly readonly: boolean;
+    /** Set only for a table cell. */
+    readonly row?: UseFormDataSourceFieldRow;
+    readonly schema: FormDefinitionSchema;
+    /** Snapshot map key; defaults to the field key. */
+    readonly snapshotKey?: string;
+    readonly uiSchema: FormUiSchema;
+}
+export declare function useFormDataSourceField(input: UseFormDataSourceFieldInput): FormDataSourceFieldState;
+export declare function readFormDataSourceFieldStatusMessage(state: FormDataSourceFieldState): string | null;
+export declare function isFormDataSourceFieldSubmissionBlocked(state: Pick<FormDataSourceFieldState, 'hasValue' | 'status'>): boolean;
+/**
+ * The copy to show when a submission is refused because of dynamic options.
+ * `LOADING` and `STALE` clear on their own once the pending query answers, so
+ * saying "finish validating" reads as a dead end for what is really a "wait a
+ * moment"; the caller would otherwise show the same permanent-sounding line for
+ * both cases.
+ *
+ * Returns `null` when nothing blocks the submission.
+ */
+export declare function readFormDataSourceSubmissionBlockMessage(states: readonly Pick<FormDataSourceFieldState, 'hasValue' | 'status'>[]): string | null;

package/dist/views/forms/renderer/form-field-link.d.cts

@@ -0,0 +1,16 @@
+export interface FormFieldLink {
+    /** Absolute links open in a new tab; site-relative ones stay in this tab. */
+    readonly external: boolean;
+    readonly href: string;
+}
+/**
+ * Decides whether a `displayAs: 'link'` text value may become an anchor.
+ * Returns `null` for everything that must stay plain text.
+ *
+ * Allowed: a site-relative path (`/` first, never `//`) or an absolute
+ * `http(s)://` URL with a host and no embedded credentials. Everything else —
+ * `javascript:`, `data:`, protocol-relative `//host`, backslash tricks
+ * (`/\host` is `//host` to a browser), padded or multi-line values, non-strings
+ * — is refused rather than repaired.
+ */
+export declare function resolveFormFieldLink(value: unknown): FormFieldLink | null;

package/dist/views/forms/renderer/index.d.cts

@@ -0,0 +1,2 @@
+export * from './FormRendererView.cjs';
+export * from './form-data-source-field.cjs';

package/dist/views/forms/renderer/index.d.ts

@@ -1,2 +1,2 @@
-export * from './FormRendererView';
-export * from './form-data-source-field';
+export * from './FormRendererView.js';
+export * from './form-data-source-field.js';

package/dist/views/forms/renderer/member-field-options.d.cts

@@ -0,0 +1,39 @@
+import { FormFieldValue } from '@rytass/bpm-core-shared/form';
+/**
+ * One pickable member, shaped for Mezzanine `AutoComplete` (`id` + `name`).
+ * `unresolved` marks the placeholder written when a stored id has no profile,
+ * so a real profile arriving later replaces it instead of the placeholder
+ * sticking (the designer does the same for its approver list).
+ */
+export type MemberFieldOption = Readonly<{
+    id: string;
+    name: string;
+    unresolved?: boolean;
+}>;
+export declare const UNKNOWN_MEMBER_NAME = "\u672A\u77E5\u6703\u54E1";
+export declare function readMemberFieldOption(member: {
+    readonly email: string;
+    readonly memberId: string;
+    readonly name: string;
+}): MemberFieldOption;
+export declare function readUnresolvedMemberFieldOption(memberId: string): MemberFieldOption;
+/**
+ * Adds `nextOptions` to `currentOptions`. A resolved option replaces an
+ * unresolved placeholder with the same id; otherwise the first one seen wins.
+ * Returns `currentOptions` itself when nothing changed, so state setters can
+ * bail out of a re-render.
+ */
+export declare function mergeMemberFieldOptions(currentOptions: readonly MemberFieldOption[], nextOptions: readonly MemberFieldOption[]): readonly MemberFieldOption[];
+/** Ids in the stored value that no known option covers yet. */
+export declare function readUnresolvedMemberIds(value: FormFieldValue | undefined, knownOptions: readonly MemberFieldOption[]): readonly string[];
+/**
+ * The stored value as options, in stored order. An id with no known profile
+ * still shows up (as 「未知會員」) so the filler can see and remove it.
+ */
+export declare function readSelectedMemberFieldOptions(value: FormFieldValue | undefined, knownOptions: readonly MemberFieldOption[]): readonly MemberFieldOption[];
+/**
+ * What a picker change writes back. Nothing picked is `undefined`, the same as
+ * every other optional field, so the renderer's own initial value (`[]` for a
+ * multiple member field) is restored by `buildFormRendererValues`.
+ */
+export declare function readMemberFieldValue(selected: readonly MemberFieldOption[], multiple: boolean): FormFieldValue | undefined;

package/dist/views/forms/renderer/member-field.d.cts

@@ -0,0 +1,21 @@
+import { ReactElement } from 'react';
+import { FormFieldValue } from '@rytass/bpm-core-shared/form';
+export interface MemberFieldControlProps {
+    readonly multiple: boolean;
+    readonly name: string;
+    readonly onChange: (value: FormFieldValue | undefined) => void;
+    readonly placeholder?: string;
+    readonly readonly: boolean;
+    readonly size?: 'main' | 'sub';
+    readonly value: FormFieldValue | undefined;
+}
+/**
+ * 人員選擇 picker. Searching and name lookup reuse the directory queries the
+ * admin member picker and the workflow designer already call
+ * (`searchMembers` / `resolveMembers`); nothing new is added server side.
+ *
+ * Stored values are member ids. The names shown here are resolved on mount and
+ * whenever a stored id has no profile yet, so a read-only view of a submitted
+ * form (instance detail) shows names, not ids.
+ */
+export declare function MemberFieldControl({ multiple, name, onChange, placeholder, readonly, size, value, }: MemberFieldControlProps): ReactElement;

package/dist/views/inbox/InboxView.d.cts

@@ -0,0 +1,7 @@
+import { ReactElement } from 'react';
+/**
+ * Framework-agnostic view for the BPM "我的待簽" inbox. Mechanical port of
+ * `apps/client/src/app/inbox/page.tsx` — renders pending tasks, tracking,
+ * and history tabs.
+ */
+export declare function InboxView(): ReactElement;

package/dist/views/inbox/index.d.cts

@@ -0,0 +1 @@
+export * from './InboxView.cjs';

package/dist/views/inbox/index.d.ts

@@ -1 +1 @@
-export * from './InboxView';
+export * from './InboxView.js';

package/dist/views/instances/detail/InstanceDetailView.d.cts

@@ -0,0 +1,27 @@
+import { ReactElement } from 'react';
+export interface InstanceDetailViewProps {
+    /** Approval instance id (Next.js `params.id` resolved by the page shim). */
+    readonly instanceId: string;
+    /** Show the form snapshot section (default: true). */
+    readonly showForm?: boolean;
+    /** Show the attachments section (default: true). */
+    readonly showAttachments?: boolean;
+    /** Show the tasks section (default: true). */
+    readonly showTasks?: boolean;
+    /** Show the signatures section (default: true). */
+    readonly showSignatures?: boolean;
+    /** Show the history section (default: true). */
+    readonly showHistory?: boolean;
+    /**
+     * Show the notify-node webhook deliveries section (default: true). Only
+     * administrators ever see it, and only when the instance queued any.
+     */
+    readonly showWebhookDeliveries?: boolean;
+}
+/**
+ * Framework-agnostic view for the BPM approval instance detail page.
+ * Mechanical port of `apps/client/src/app/instances/[id]/page.tsx`. The
+ * `instanceId` is provided by the host page wrapper (typically resolved
+ * from `params.id` in the Next.js Server Component shim).
+ */
+export declare function InstanceDetailView({ instanceId, showAttachments, showForm, showHistory, showSignatures, showTasks, showWebhookDeliveries, }: InstanceDetailViewProps): ReactElement;

package/dist/views/instances/detail/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/detail-DKobK4Cg.cjs");exports.InstanceAttachmentsSection=e.o,exports.InstanceDetailView=e.t,exports.InstanceFormSection=e.s,exports.InstanceHistorySection=e.r,exports.InstanceSignaturesSection=e.i,exports.InstanceTasksSection=e.a,exports.InstanceWebhookDeliveriesSection=e.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../chunks/detail-DRCTnuKm.cjs");exports.InstanceAttachmentsSection=e.o,exports.InstanceDetailView=e.t,exports.InstanceFormSection=e.s,exports.InstanceHistorySection=e.r,exports.InstanceSignaturesSection=e.i,exports.InstanceTasksSection=e.a,exports.InstanceWebhookDeliveriesSection=e.n;

package/dist/views/instances/detail/index.d.cts

@@ -0,0 +1,7 @@
+export * from './InstanceDetailView.cjs';
+export * from './sections/InstanceFormSection.cjs';
+export * from './sections/InstanceAttachmentsSection.cjs';
+export * from './sections/InstanceTasksSection.cjs';
+export * from './sections/InstanceSignaturesSection.cjs';
+export * from './sections/InstanceHistorySection.cjs';
+export * from './sections/InstanceWebhookDeliveriesSection.cjs';

package/dist/views/instances/detail/index.d.ts

@@ -1,7 +1,7 @@
-export * from './InstanceDetailView';
-export * from './sections/InstanceFormSection';
-export * from './sections/InstanceAttachmentsSection';
-export * from './sections/InstanceTasksSection';
-export * from './sections/InstanceSignaturesSection';
-export * from './sections/InstanceHistorySection';
-export * from './sections/InstanceWebhookDeliveriesSection';
+export * from './InstanceDetailView.js';
+export * from './sections/InstanceFormSection.js';
+export * from './sections/InstanceAttachmentsSection.js';
+export * from './sections/InstanceTasksSection.js';
+export * from './sections/InstanceSignaturesSection.js';
+export * from './sections/InstanceHistorySection.js';
+export * from './sections/InstanceWebhookDeliveriesSection.js';

package/dist/views/instances/detail/index.js

@@ -1 +1 @@
-export { o as InstanceAttachmentsSection, t as InstanceDetailView, s as InstanceFormSection, r as InstanceHistorySection, i as InstanceSignaturesSection, a as InstanceTasksSection, n as InstanceWebhookDeliveriesSection } from "../../../chunks/detail-C6NdVijG.js";
+export { o as InstanceAttachmentsSection, t as InstanceDetailView, s as InstanceFormSection, r as InstanceHistorySection, i as InstanceSignaturesSection, a as InstanceTasksSection, n as InstanceWebhookDeliveriesSection } from "../../../chunks/detail-DScLf42P.js";

package/dist/views/instances/detail/sections/InstanceAttachmentsSection.d.cts

@@ -0,0 +1,15 @@
+import { ReactElement } from 'react';
+import { AttachmentRecord } from '@rytass/bpm-core-client/workflow';
+export interface InstanceAttachmentsSectionProps {
+    /** The list of attachments for this instance. */
+    readonly attachments: readonly AttachmentRecord[];
+    /** Called when the user clicks the download action for an attachment. */
+    readonly onDownload: (attachment: AttachmentRecord) => void;
+    /** Called when the user clicks the preview action for a PDF attachment. */
+    readonly onPreview: (attachment: AttachmentRecord) => void;
+}
+/**
+ * Renders the attachments section of the approval instance detail page.
+ * Shows a table of attachments with download and (for PDFs) preview actions.
+ */
+export declare function InstanceAttachmentsSection({ attachments, onDownload, onPreview, }: InstanceAttachmentsSectionProps): ReactElement;

package/dist/views/instances/detail/sections/InstanceFormSection.d.cts

@@ -0,0 +1,36 @@
+import { ReactElement } from 'react';
+import { FormFieldDefinition } from '@rytass/bpm-core-shared/form';
+import { ApprovalInstanceRecord, WorkflowFormData } from '@rytass/bpm-core-client/workflow';
+import { FormDataSourceFieldState } from '../../../forms/renderer/form-data-source-field.cjs';
+export interface InstanceFormSectionProps {
+    /** The loaded approval instance, or null while loading. */
+    readonly instance: ApprovalInstanceRecord | null;
+    /** Whether the instance is in a loading state. */
+    readonly loading: boolean;
+    /** Error message to display, if any. */
+    readonly error: string | null;
+    /** Whether the current user can resubmit (edit + resubmit the returned form). */
+    readonly canResubmitInstance: boolean;
+    /** Current form data for the resubmit flow. */
+    readonly resubmitFormData: WorkflowFormData;
+    /** Validation error map for the resubmit form. */
+    readonly resubmitFormErrors: Readonly<Record<string, string>>;
+    /** Whether a decision/submit action is in progress. */
+    readonly deciding: boolean;
+    /** Called when the form data changes in the resubmit flow. */
+    readonly onResubmitFormChange: (values: WorkflowFormData) => void;
+    /** Called when a dynamic option field changes validation state. */
+    readonly onDataSourceStateChange: (fieldKey: string, state: Pick<FormDataSourceFieldState, 'hasValue' | 'invalidValues' | 'status'>) => void;
+    /** Called when the user clicks "重新送出". */
+    readonly onResubmitInstance: () => void;
+    /** Called when an attachment upload is requested via the form field. */
+    readonly onUploadAttachment: (field: FormFieldDefinition, file: File) => Promise<{
+        readonly id: string;
+    }>;
+}
+/**
+ * Renders the form snapshot section of the approval instance detail page.
+ * Displays the form in read-only mode normally, or editable mode when the
+ * instance has been returned and the current member can resubmit it.
+ */
+export declare function InstanceFormSection({ canResubmitInstance, deciding, error, instance, loading, onDataSourceStateChange, onResubmitFormChange, onResubmitInstance, onUploadAttachment, resubmitFormData, resubmitFormErrors, }: InstanceFormSectionProps): ReactElement;

package/dist/views/instances/detail/sections/InstanceFormSection.d.ts

@@ -1,7 +1,7 @@
 import { ReactElement } from 'react';
 import { FormFieldDefinition } from '@rytass/bpm-core-shared/form';
 import { ApprovalInstanceRecord, WorkflowFormData } from '@rytass/bpm-core-client/workflow';
-import { FormDataSourceFieldState } from '../../../forms/renderer/form-data-source-field';
+import { FormDataSourceFieldState } from '../../../forms/renderer/form-data-source-field.js';
 export interface InstanceFormSectionProps {
     /** The loaded approval instance, or null while loading. */
     readonly instance: ApprovalInstanceRecord | null;

package/dist/views/instances/detail/sections/InstanceHistorySection.d.cts

@@ -0,0 +1,29 @@
+import { ReactElement } from 'react';
+import { ActivityLogRecord, ApprovalInstanceRecord, MemberProfileRecord, SignatureRecord, SignatureVerificationRecord, TaskDecisionRecord, TaskRecord, WorkflowTokenRecord } from '@rytass/bpm-core-client/workflow';
+import { WorkflowDefinition } from '@rytass/bpm-core-shared/workflow';
+export interface InstanceHistorySectionProps {
+    /** Activity log records for this instance. */
+    readonly activityLogs: readonly ActivityLogRecord[];
+    /** All tasks for this instance (used to compute pending/future steps). */
+    readonly tasks: readonly TaskRecord[];
+    /** All workflow tokens for this instance. */
+    readonly workflowTokens: readonly WorkflowTokenRecord[];
+    /** The workflow definition snapshot, or null if not yet loaded. */
+    readonly workflowSnapshot: WorkflowDefinition | null;
+    /** The current state of the instance. */
+    readonly instanceState: ApprovalInstanceRecord['state'];
+    /** Member profiles indexed by memberId. */
+    readonly memberProfilesById: ReadonlyMap<string, MemberProfileRecord>;
+    /** Task decisions indexed by taskId (latest per task). */
+    readonly taskDecisionsByTaskId: ReadonlyMap<string, TaskDecisionRecord>;
+    /** Signatures indexed by id. */
+    readonly signaturesById: ReadonlyMap<string, SignatureRecord>;
+    /** Signature chain verification result, or null. */
+    readonly signatureVerification: SignatureVerificationRecord | null;
+}
+/**
+ * Renders the activity history section of the approval instance detail page.
+ * Computes the step records from the provided data and renders them as a
+ * vertical dot stepper.
+ */
+export declare function InstanceHistorySection({ activityLogs, instanceState, memberProfilesById, signatureVerification, signaturesById, taskDecisionsByTaskId, tasks, workflowSnapshot, workflowTokens, }: InstanceHistorySectionProps): ReactElement;

package/dist/views/instances/detail/sections/InstanceSignaturesSection.d.cts

@@ -0,0 +1,14 @@
+import { ReactElement } from 'react';
+import { SignatureRecord, SignatureVerificationRecord } from '@rytass/bpm-core-client/workflow';
+export interface InstanceSignaturesSectionProps {
+    /** The list of signatures for this instance. */
+    readonly signatures: readonly SignatureRecord[];
+    /** The signature chain verification result, or null if not yet loaded. */
+    readonly signatureVerification: SignatureVerificationRecord | null;
+}
+/**
+ * Renders the signatures section of the approval instance detail page.
+ * Shows the signature chain verification status and a table of individual
+ * signature records.
+ */
+export declare function InstanceSignaturesSection({ signatureVerification, signatures, }: InstanceSignaturesSectionProps): ReactElement;

package/dist/views/instances/detail/sections/InstanceTasksSection.d.cts

@@ -0,0 +1,55 @@
+import { AdhocDirectiveRecord, ApprovalInstanceRecord, MemberProfileRecord, TaskRecord } from '@rytass/bpm-core-client/workflow';
+/**
+ * Imperative handle exposed by InstanceTasksSection via ref.
+ * The container uses these to wire PageHeader action buttons to the
+ * section's internal modal state without lifting state up.
+ */
+export type AdhocActionMode = 'COMPLETION_NOTIFY' | 'COUNTERSIGN' | 'PRE_APPROVAL' | 'STAGE_NOTIFY';
+export interface InstanceTasksSectionHandle {
+    /** Whether a task action (decision) is currently in flight. */
+    readonly deciding: boolean;
+    /** Whether the current user has an actionable pending task. */
+    readonly hasCurrentTask: boolean;
+    /** Whether the current task's node allows a return action. */
+    readonly canReturnCurrentTask: boolean;
+    /** Whether the current task's node allows a reject action. */
+    readonly canRejectCurrentTask: boolean;
+    /** Whether the current task's node allows a transfer action. */
+    readonly canTransferCurrentTask: boolean;
+    /** Whether the current task's node allows ad-hoc countersign/pre-approval. */
+    readonly canAddSignerCurrentTask: boolean;
+    /** Opens the reject-reason modal. */
+    openRejectModal(): void;
+    /** Opens the return modal. */
+    openReturnModal(): void;
+    /** Opens the transfer modal. */
+    openTransferModal(): void;
+    /** Opens the ad-hoc action modal in the given mode. */
+    openAdhocModal(mode: AdhocActionMode): void;
+    /** Opens the approve-comment modal. */
+    handleApprove(): void;
+}
+export interface InstanceTasksSectionProps {
+    /** All tasks for this instance. */
+    readonly tasks: readonly TaskRecord[];
+    /** Ad-hoc directives recorded on this instance. */
+    readonly adhocDirectives: readonly AdhocDirectiveRecord[];
+    /** The loaded approval instance (used to read workflowSnapshot node labels). */
+    readonly instance: ApprovalInstanceRecord | null;
+    /** Member profiles indexed by memberId, for displaying assignee labels. */
+    readonly memberProfilesById: ReadonlyMap<string, MemberProfileRecord>;
+    /** The currently authenticated member's id. */
+    readonly currentMemberId: string | null;
+    /**
+     * Called after any task decision action (approve / reject / return /
+     * transfer) completes successfully. The container should refresh data.
+     */
+    readonly onChanged: () => void | Promise<void>;
+}
+/**
+ * Renders the tasks section of the approval instance detail page.
+ * Contains the task table plus all decision action modals
+ * (reject, return, transfer). Approve is also handled here via the
+ * imperative handle exposed through the forwarded ref.
+ */
+export declare const InstanceTasksSection: import('react').ForwardRefExoticComponent<InstanceTasksSectionProps & import('react').RefAttributes<InstanceTasksSectionHandle>>;

package/dist/views/instances/detail/sections/InstanceWebhookDeliveriesSection.d.cts

@@ -0,0 +1,20 @@
+import { ReactElement } from 'react';
+import { WorkflowWebhookDeliveryRecord } from '@rytass/bpm-core-client/workflow';
+export interface InstanceWebhookDeliveriesSectionProps {
+    /** The instance's notify-node webhook deliveries, oldest first. */
+    readonly deliveries: readonly WorkflowWebhookDeliveryRecord[];
+    /** Resolves a node id to the label shown to the reader. */
+    readonly readNodeLabel: (nodeId: string) => string;
+    /**
+     * Re-queues a `FAILED` delivery. A rejection is shown in the section, so
+     * the caller only needs to refresh what it displays on success.
+     */
+    readonly onRetry: (delivery: WorkflowWebhookDeliveryRecord) => Promise<void>;
+}
+/**
+ * Administrator-only view of the webhooks this instance's notify nodes sent
+ * (ADR 18 §3.10): where each delivery stands, how many attempts it took, the
+ * last error, and a retry for the ones that gave up. Carries no URL or
+ * payload — the server never sends them to the browser.
+ */
+export declare function InstanceWebhookDeliveriesSection({ deliveries, onRetry, readNodeLabel, }: InstanceWebhookDeliveriesSectionProps): ReactElement;

package/dist/views/instances/detail/sections/container-helpers.d.cts

@@ -0,0 +1,10 @@
+import { ActivityLogRecord, AdhocDirectiveRecord, ApprovalInstanceRecord, MemberProfileRecord, TaskDecisionRecord, TaskRecord } from '@rytass/bpm-core-client/workflow';
+export { canMemberActOnTask, readErrorMessage, readInstanceStateLabel, readNodeRuntimeState, } from './shared.cjs';
+export declare function readMemberProfilesForTimeline({ activityLogs, adhocDirectives, instance, tasks, }: {
+    readonly activityLogs: readonly ActivityLogRecord[];
+    readonly adhocDirectives?: readonly AdhocDirectiveRecord[];
+    readonly instance?: Pick<ApprovalInstanceRecord, 'initiatorMemberId' | 'submittedByMemberId'>;
+    readonly tasks: readonly TaskRecord[];
+}): Promise<readonly MemberProfileRecord[]>;
+export declare function readTaskDecisionsForTasks(tasks: readonly TaskRecord[]): Promise<readonly TaskDecisionRecord[]>;
+export declare function readLatestTaskDecisionsByTaskId(taskDecisions: readonly TaskDecisionRecord[]): ReadonlyMap<string, TaskDecisionRecord>;

package/dist/views/instances/detail/sections/container-helpers.d.ts

@@ -1,5 +1,5 @@
 import { ActivityLogRecord, AdhocDirectiveRecord, ApprovalInstanceRecord, MemberProfileRecord, TaskDecisionRecord, TaskRecord } from '@rytass/bpm-core-client/workflow';
-export { canMemberActOnTask, readErrorMessage, readInstanceStateLabel, readNodeRuntimeState, } from './shared';
+export { canMemberActOnTask, readErrorMessage, readInstanceStateLabel, readNodeRuntimeState, } from './shared.js';
 export declare function readMemberProfilesForTimeline({ activityLogs, adhocDirectives, instance, tasks, }: {
     readonly activityLogs: readonly ActivityLogRecord[];
     readonly adhocDirectives?: readonly AdhocDirectiveRecord[];