@kontourai/survey 1.11.0 → 1.13.0

package/dist/src/review-workbench/review-workbench.d.ts

@@ -1,7 +1,7 @@
 import { type ReviewQueueSessionState, type ReviewWorkbenchDecision, type ReviewWorkbenchState } from "./review-queue-session.js";
 import { type ReviewSessionReplayIssue } from "./review-session-replay.js";
 import { type ReviewPresentationAdapter } from "./review-presentation.js";
-import { type ReviewCandidate, type ReviewDecision, type ReviewItem, type ReviewSession, type ReviewSessionEvent } from "../review-resource.js";
+import { type ReviewCandidate, type ReviewDecision, type ReviewItem, type ReviewSession, type ReviewSessionEvent, type ReviewValueDescriptor } from "../review-resource.js";
 export { buildReviewSessionEvents, buildReviewSessionEvent, buildReviewSessionResource, candidateForDecision, currentReviewItem, currentReviewWorkbenchState, defaultReviewSessionName, deriveQueueRowStatus, initialReviewQueueSessionState, initialReviewWorkbenchState, nextUnresolvedItemName, replayReviewSessionEvents, reviewSessionSummary, reviewWorkbenchSessionStorageKey, selectedCandidateRole, workbenchDecisionDefinitions, type ReviewQueueRowStatus, type ReviewQueueSessionState, type ReviewSessionSummary, type ReviewWorkbenchDecision, type ReviewWorkbenchState, } from "./review-queue-session.js";
 export { buildReviewCandidatePresentation, buildReviewItemPresentation, buildReviewResultPresentation, humanizeIdentifier, type ReviewCandidatePresentation, type ReviewCandidatePresentationContext, type ReviewItemPresentation, type ReviewItemPresentationContext, type ReviewPresentationAdapter, type ReviewPresentationLink, type ReviewResultPresentation, type ReviewTracePresentationContext, type ReviewTraceRef, type ReviewValuePresentationContext, } from "./review-presentation.js";
 export { buildSurfaceProjectionPreview, type PreviewAuthorityTrace, type PreviewCandidateHistory, type PreviewClaim, type PreviewIntegrityPosture, type PreviewReviewEvent, type PreviewSourceAuthority, type PreviewSourceEvidence, type SurfaceProjectionPreview, } from "./review-surface-preview.js";
@@ -92,8 +92,18 @@ export interface ReviewWorkbenchResult {
     readonly selectedCandidate: ReviewCandidate;
     readonly selectedCandidateId: string;
     readonly selectedCandidateRole?: ReviewCandidate["role"];
+    /** The selected candidate's original value, unaffected by any reviewer edit. Used
+     *  for candidate-identity matching (see `matchingSelectedCandidate`); consumers who
+     *  want the reviewer's edited value should read `effectiveValue` instead. */
     readonly selectedValue: unknown;
     readonly selectedDisplayValue: string;
+    /** Reviewer-edited override captured for an accept-proposed decision, if the
+     *  reviewer changed the proposed value before applying it. Additive/optional. */
+    readonly editedValue?: unknown;
+    /** The value that should actually be applied: `editedValue` when present (and the
+     *  decision selects the proposed candidate), otherwise `selectedValue`. */
+    readonly effectiveValue: unknown;
+    readonly effectiveDisplayValue: string;
     readonly unselectedCandidates: readonly ReviewCandidate[];
     readonly reviewDecision: ReviewDecision;
     readonly status: ReviewDecision["spec"]["status"];
@@ -166,9 +176,19 @@ export declare function persistReviewSessionEvents(options: PersistReviewSession
 export declare function createPersistentReviewSessionEventStore(options: PersistentReviewSessionEventStoreOptions): ReviewSessionEventStore & {
     events(): readonly ReviewSessionEvent[];
 };
-export declare function renderReviewWorkbenchHtml(state: ReviewWorkbenchState | ReviewQueueSessionState, events?: readonly ReviewSessionEvent[], options?: {
+export declare function renderReviewWorkbenchHtml(state: ReviewWorkbenchState | ReviewQueueSessionState, _events?: readonly ReviewSessionEvent[], options?: {
     readonly presentationAdapter?: ReviewPresentationAdapter;
 }): string;
+/**
+ * Validates a reviewer's raw (string) edit of a proposed value against the
+ * field's neutral {@link ReviewValueDescriptor}, returning a human-readable
+ * error message when the value violates the declared type/enum constraint, or
+ * `undefined` when it is acceptable — including when there is no descriptor or
+ * the type carries no single-line constraint (string/array/object). This is a
+ * FORMAT check only: it never coerces or rewrites the value (the workbench
+ * stores the reviewer's string edit unchanged, as it did before typed editors).
+ */
+export declare function validateProposedValue(descriptor: ReviewValueDescriptor | undefined, rawValue: string): string | undefined;
 export declare function mountReviewWorkbench(root: HTMLElement, startState?: ReviewQueueSessionState | ReviewWorkbenchState, options?: MountReviewWorkbenchOptions): void;
 export declare function browserReviewWorkbenchStartState(): ReviewQueueSessionState | ReviewWorkbenchState | undefined;
 declare global {