@rytass/bpm-core-react 0.17.0 → 0.17.1

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.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/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[];

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

@@ -0,0 +1,141 @@
+import { ActivityLogRecord, ApprovalInstanceRecord, AttachmentRecord, MemberProfileRecord, SignatureRecord, SignatureVerificationRecord, TaskDecisionRecord, TaskRecord, WorkflowTokenRecord } from '@rytass/bpm-core-client/workflow';
+import { WorkflowDefinition, WorkflowNode } from '@rytass/bpm-core-shared/workflow';
+export type TaskRow = Readonly<Record<string, unknown> & TaskRecord & {
+    assigneeLabel: string;
+    key: string;
+    nodeLabel: string;
+    statusLabel: string;
+}>;
+export type AttachmentRow = Readonly<Record<string, unknown> & {
+    attachment: AttachmentRecord;
+    createdAt: string;
+    filename: string;
+    id: string;
+    key: string;
+    mimeType: string;
+    sizeLabel: string;
+}>;
+export type SignatureRow = Readonly<Record<string, unknown> & {
+    algorithm: string;
+    hashLabel: string;
+    key: string;
+    keyVersion: number;
+    signedAtLabel: string;
+    signerMemberId: string;
+}>;
+export type MemberOption = Readonly<{
+    email: string | null;
+    id: string;
+    name: string;
+}>;
+export type ActivityStepDescriptionPart = Readonly<{
+    text: string;
+    type: 'text';
+}> | Readonly<{
+    email: string | null;
+    label: string;
+    memberId: string | null;
+    prefix: string;
+    type: 'member';
+}>
+/**
+ * What an approver actually wrote. Kept apart from the `text` parts so the
+ * timeline can give it its own line instead of burying it mid-sentence
+ * between the node, the actor, the timestamp and the signature hash.
+ */
+ | Readonly<{
+    label: string;
+    text: string;
+    tone: 'danger' | 'neutral';
+    type: 'comment';
+}>;
+export interface ActivityStepRecord {
+    readonly descriptionParts: readonly ActivityStepDescriptionPart[];
+    readonly error: boolean;
+    readonly forcePending?: boolean;
+    readonly id: string;
+    readonly title: string;
+}
+interface DelegationChainStep {
+    readonly from: string;
+    readonly reason: string;
+    readonly ruleId: string | null;
+    readonly to: string;
+}
+export declare function readDelegationChain(value: string): readonly DelegationChainStep[];
+export declare function readStringField(record: Readonly<Record<string, unknown>>, key: string): string | null;
+export declare function readStringArrayField(record: Readonly<Record<string, unknown>>, key: string): readonly string[];
+export declare function readNumberField(record: Readonly<Record<string, unknown>>, key: string): number | null;
+export declare function isPresentText(value: string | null): value is string;
+export declare function isRecord(value: unknown): value is Readonly<Record<string, unknown>>;
+export declare function isPendingTask(task: TaskRecord): boolean;
+export declare function readErrorMessage(error: unknown): string;
+export declare function formatFileSize(sizeBytes: number): string;
+export declare function readShortHash(hash: string): string;
+export declare function readInstanceStateLabel(state: string): string;
+export declare function readTaskStatusLabel(status: TaskRecord['status']): string;
+export declare function readTaskDecisionActionLabel(action: string): string;
+export declare function readNodeKindLabel(type: WorkflowNode['type']): string;
+export declare function readNodeDisplayLabel(nodeId: string, workflow: WorkflowDefinition | null): string;
+export declare function readMemberDisplayText(memberId: string | null, memberProfilesById: ReadonlyMap<string, MemberProfileRecord>): string;
+export declare function readTaskAssigneeLabel(task: TaskRecord, memberProfilesById?: ReadonlyMap<string, MemberProfileRecord>): string;
+export declare function canMemberActOnTask(task: TaskRecord, memberId: string | null): boolean;
+export declare function readReturnTargetOptions(workflow: WorkflowDefinition, node: WorkflowNode): readonly {
+    readonly id: string;
+    readonly name: string;
+}[];
+export declare function readMemberOption(profile: MemberProfileRecord): MemberOption;
+/**
+ * The target an ad-hoc directive is sent to, or the reason it cannot be built
+ * yet. Kept out of the component so the "which shape do we send" decision is
+ * testable on its own — it is the part that changed when the member picker
+ * went from one selection to many.
+ */
+export type AdhocTargetDraft = Readonly<{
+    target: Readonly<{
+        kind: 'MEMBER';
+        memberIds: readonly string[];
+    }> | Readonly<{
+        kind: 'WEBHOOK';
+        webhookUrl: string;
+    }>;
+    valid: true;
+}> | Readonly<{
+    error: string;
+    valid: false;
+}>;
+export declare function readAdhocTargetDraft({ memberIds, useWebhookTarget, webhookUrl, }: {
+    readonly memberIds: readonly string[];
+    readonly useWebhookTarget: boolean;
+    readonly webhookUrl: string;
+}): AdhocTargetDraft;
+export declare function isPresentMemberOption(option: MemberOption | null): option is MemberOption;
+export declare function readMemberOptionFromValue(value: unknown): MemberOption | null;
+export declare function readUniqueMemberOption(searchText: string, options: readonly MemberOption[]): MemberOption | null;
+export declare function readTextDescriptionPart(text: string | null): ActivityStepDescriptionPart | null;
+export declare function readCommentDescriptionPart(label: string, text: string | null, tone?: 'danger' | 'neutral'): ActivityStepDescriptionPart | null;
+export declare function readMemberDescriptionPart(prefix: string, memberId: string | null, memberProfilesById: ReadonlyMap<string, MemberProfileRecord>, fallbackLabel: string): ActivityStepDescriptionPart;
+export declare function isActivityDescriptionPart(part: ActivityStepDescriptionPart | null): part is ActivityStepDescriptionPart;
+export declare function readCurrentActivityStep(activitySteps: readonly ActivityStepRecord[]): number;
+export declare function isUserMeaningfulActivity(activityLog: ActivityLogRecord): boolean;
+/**
+ * Member ids that only appear inside the payload of the sequential-signing
+ * events, so the timeline can load their profiles and show names, not ids.
+ */
+export declare function readSequentialActivityPayloadMemberIds(activityLog: ActivityLogRecord): readonly string[];
+export declare function readActivityEventLabel(eventType: string, payload: Readonly<Record<string, unknown>>): string;
+export declare function readActivityPayload(activityLog: ActivityLogRecord): Readonly<Record<string, unknown>>;
+export declare function isActivityError(activityLog: ActivityLogRecord, payload: Readonly<Record<string, unknown>>): boolean;
+export declare function formatActivityDateTime(value: string): string;
+export declare function readActivityDetailParts(activityLog: ActivityLogRecord, payload: Readonly<Record<string, unknown>>, workflow: WorkflowDefinition | null, taskDecisionsByTaskId: ReadonlyMap<string, TaskDecisionRecord>, signaturesById: ReadonlyMap<string, SignatureRecord>, signatureVerification: SignatureVerificationRecord | null, memberProfilesById: ReadonlyMap<string, MemberProfileRecord>): readonly ActivityStepDescriptionPart[];
+export declare function isFutureTimelineNode(node: WorkflowNode, tasks: readonly TaskRecord[], tokens: readonly WorkflowTokenRecord[], instanceState: ApprovalInstanceRecord['state'], representedNodeIds: ReadonlySet<string>): boolean;
+export declare function readFutureTimelineNodes(workflow: WorkflowDefinition, tasks: readonly TaskRecord[], tokens: readonly WorkflowTokenRecord[], instanceState: ApprovalInstanceRecord['state'], representedNodeIds: ReadonlySet<string>): readonly WorkflowNode[];
+export declare function readFutureNodeStepTitle(node: WorkflowNode): string;
+export declare function readActivityStepRecords(activityLogs: readonly ActivityLogRecord[], tasks: readonly TaskRecord[], tokens: readonly WorkflowTokenRecord[], workflow: WorkflowDefinition | null, instanceState: ApprovalInstanceRecord['state'], memberProfilesById: ReadonlyMap<string, MemberProfileRecord>, taskDecisionsByTaskId: ReadonlyMap<string, TaskDecisionRecord>, signaturesById: ReadonlyMap<string, SignatureRecord>, signatureVerification: SignatureVerificationRecord | null): ActivityStepRecord[];
+type RuntimeTone = 'cancelled' | 'completed' | 'current' | 'neutral' | 'waiting';
+export declare function readNodeRuntimeState(node: WorkflowNode, tasks: readonly TaskRecord[], tokens: readonly WorkflowTokenRecord[], instanceState: string): Readonly<{
+    secondaryLabel: string;
+    statusLabel: string;
+    tone: RuntimeTone;
+}>;
+export {};

package/dist/views/instances/detail/submitted-by.d.cts

@@ -0,0 +1,23 @@
+/**
+ * Who filed an approval instance on someone's behalf.
+ *
+ * `submittedByMemberId` is `null` on rows written before the column existed
+ * and equals `initiatorMemberId` when the applicant submitted it themselves;
+ * only a different, non-empty value means somebody else filed it. This is the
+ * one place the detail page reads that rule.
+ */
+interface SubmittedByFields {
+    readonly initiatorMemberId: string | null | undefined;
+    readonly submittedByMemberId?: string | null;
+}
+interface NamedMember {
+    readonly name: string;
+}
+export declare function readDistinctSubmitterMemberId({ initiatorMemberId, submittedByMemberId, }: SubmittedByFields): string | null;
+/**
+ * 「由 {submitter} 代 {initiator} 送出」, or `null` when the applicant
+ * submitted it themselves. A member whose profile did not load shows by id,
+ * like every other member on the page.
+ */
+export declare function readSubmittedOnBehalfLabel(fields: SubmittedByFields, memberProfilesById: ReadonlyMap<string, NamedMember>): string | null;
+export {};

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

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

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

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

package/dist/views/instances/new/InstanceNewView.d.cts

@@ -0,0 +1,15 @@
+import { ReactElement } from 'react';
+export interface InstanceNewViewProps {
+    /**
+     * Optional template id pre-selected by the host. The Server Component
+     * page should read `?templateId=` from its `searchParams` and pass the
+     * value through this prop.
+     */
+    readonly templateId?: string | null;
+}
+/**
+ * Framework-agnostic view for the BPM "發起簽核" launch page. Mechanical port
+ * of `apps/client/src/app/instances/new/page.tsx` — picks a launchable
+ * template and submits the launch form.
+ */
+export declare function InstanceNewView(props?: InstanceNewViewProps): ReactElement;

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

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

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

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

package/dist/views/login/LoginView.d.cts

@@ -0,0 +1,47 @@
+import { ReactElement } from 'react';
+export interface LoginViewProps {
+    /**
+     * Logo image URL. Renders an inline `<img>` so the view stays framework
+     * agnostic (no `next/image` dependency). Defaults to
+     * `/rytass-logo.png` — host should serve a static asset at that path or
+     * override via this prop.
+     */
+    readonly logoSrc?: string;
+    /**
+     * Pre-fill the identifier input. Defaults to the seeded demo account
+     * email so the form is usable out of the box.
+     */
+    readonly defaultIdentifier?: string;
+    /**
+     * Pre-fill the password input. Defaults to the seeded demo password
+     * (`'demo'`). Production hosts should pass an empty string.
+     */
+    readonly defaultPassword?: string;
+    /**
+     * Custom redirect target after a successful login. Defaults to reading
+     * `?next=` from the host router's search params, falling back to `'/'`.
+     */
+    readonly defaultNextPath?: string;
+    /**
+     * Override the BPM admin brand title shown above the form. Defaults to
+     * `'BPM Admin'`.
+     */
+    readonly brandTitle?: string;
+    /**
+     * Override the brand subtitle shown above the form. Defaults to
+     * `'BPM API 登入'`.
+     */
+    readonly brandSubtitle?: string;
+}
+/**
+ * Login UI for the BPM admin host. Renders the brand mark, identifier /
+ * password fields, and a "test members" picker fed by
+ * `listApiTestMembers()`. Self-contained: composes Mezzanine UI primitives,
+ * reads the auth context, and uses the host router adapter to redirect on
+ * success.
+ *
+ * Wrap with `<AuthProvider>` (and indirectly `<RouterAdapterProvider>`)
+ * higher in the tree. The `pages/login` subpath ships a thin Next.js
+ * wrapper that exports `default` (Server Component) and `metadata`.
+ */
+export declare function LoginView({ logoSrc, defaultIdentifier, defaultPassword, defaultNextPath, brandTitle, brandSubtitle, }?: LoginViewProps): ReactElement;

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

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

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

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

package/dist/views/root/RootView.d.cts

@@ -0,0 +1,10 @@
+import { ReactElement } from 'react';
+/**
+ * Framework-agnostic placeholder for the BPM root path. Server-side redirect
+ * to `/dashboard` is the consumer's responsibility (Next.js `middleware.ts`
+ * or `app/page.tsx`). This view renders nothing so it can be safely mounted
+ * during the redirect flash.
+ *
+ * Mechanical port of `apps/client/src/app/page.tsx`.
+ */
+export declare function RootView(): ReactElement | null;

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

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

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

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

package/dist/views/search/SearchView.d.cts

@@ -0,0 +1,7 @@
+import { ReactElement } from 'react';
+/**
+ * Framework-agnostic view for the BPM case search page — list of all
+ * instances the current member has visibility on. Mechanical port of
+ * `apps/client/src/app/search/page.tsx`.
+ */
+export declare function SearchView(): ReactElement;

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

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

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

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