nucleus-core-ts 0.10.135 → 0.10.137

package/dist/.build-ok

@@ -1 +1 @@
-0.10.135
+0.10.137

package/dist/fe/components/VerificationFlowPage/components/PendingTab.js

@@ -357,6 +357,12 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
    */ const renderRevisionCard = (item)=>{
         const returned = returnedSentence(say, item);
         const confirming = withdrawingId === item.instance_id;
+        /*
+     * Round 1 of a chain that OPENS on the author's step — "the author confirms
+     * the draft, then the reviewers" — has sent nothing back. Measured on the
+     * running panel: the card said "returned to you for a correction" and
+     * offered "I fixed it, send again" for a record nobody had looked at yet.
+     */ const firstRound = (item.pass_no ?? 1) <= 1 && !item.sent_back;
         return /*#__PURE__*/ _jsxs("div", {
             className: "flex flex-wrap items-start justify-between gap-3",
             children: [
@@ -365,13 +371,14 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                     children: [
                         /*#__PURE__*/ _jsx("p", {
                             className: theme.pending.card.title,
-                            children: say.revisionCardTitle
+                            children: firstRound ? say.revisionFirstTitle : say.revisionCardTitle
                         }),
                         /*#__PURE__*/ _jsxs("p", {
                             className: theme.pending.card.subtitle,
                             children: [
                                 say.pendingCardTitle(item.flow_name, item.step_order),
-                                item.step_name ? ` · ${item.step_name}` : null
+                                item.step_name ? ` · ${item.step_name}` : null,
+                                !firstRound && item.pass_no ? ` · ${say.pendingRound(item.pass_no, item.max_passes ?? item.pass_no)}` : null
                             ]
                         }),
                         returned ? /*#__PURE__*/ _jsx("p", {
@@ -428,7 +435,7 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                             },
                             "aria-describedby": `resubmit-hint-${item.instance_id}`,
                             className: theme.pending.approveButton,
-                            children: say.resubmit
+                            children: firstRound ? say.submitForReview : say.resubmit
                         }),
                         /*#__PURE__*/ _jsx("button", {
                             type: "button",
@@ -446,7 +453,7 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                         /*#__PURE__*/ _jsx("p", {
                             id: `resubmit-hint-${item.instance_id}`,
                             className: theme.pending.card.decisionMeta,
-                            children: say.resubmitHint
+                            children: firstRound ? say.submitForReviewHint : say.resubmitHint
                         })
                     ]
                 })
@@ -467,6 +474,13 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                             className: theme.pending.card.subtitle,
                             children: item.step_name
                         }) : null,
+                        item.sent_back?.reason ? /*#__PURE__*/ _jsxs("p", {
+                            className: theme.pending.card.decisionMeta,
+                            children: [
+                                typeof item.pass_no === 'number' && typeof item.max_passes === 'number' ? `${say.pendingRound(item.pass_no, item.max_passes)} · ` : null,
+                                say.previousRoundReason(item.sent_back.reason)
+                            ]
+                        }) : null,
                         renderRecord(item)
                     ]
                 }),

package/dist/fe/components/VerificationFlowPage/components/VerificationFlowPage.js

@@ -316,6 +316,7 @@ export function VerificationFlowPage({ entityName, title, subtitle, flowListActi
    * a ref here, because the render needs it too — to tell this editor's save
    * from one left behind — and a ref restarted at 0 on each mount.
    */ /** The latest readiness question; any older answer is about another graph. */ const feasibilityTicketRef = useRef(0);
+    /** The pending automatic re-check after an edit; see `scheduleFeasibility`. */ const feasibilityTimerRef = useRef(null);
     /*
    * The id a NEW flow is saved under, minted at its first save and reused
    * until one succeeds. It is not written to `selectedFlowId` before then:
@@ -756,22 +757,40 @@ export function VerificationFlowPage({ entityName, title, subtitle, flowListActi
             }
         });
     });
+    /*
+   * Re-ask once the author PAUSES, with the graph they paused on.
+   *
+   * The answer was dropped on every edit and came back only on "Şimdi kontrol
+   * et" or a save, so adding a third step left the card blank ("henüz
+   * karşılaştırılmadı") exactly when it should have turned red (found by the
+   * re-check). A request per keystroke is not the fix either; one request
+   * 700ms after the last edit is. The ticket still discards an answer that
+   * lands after a newer edit.
+   */ const scheduleFeasibility = useEffectEvent(()=>{
+        if (feasibilityTimerRef.current) clearTimeout(feasibilityTimerRef.current);
+        feasibilityTimerRef.current = setTimeout(()=>{
+            feasibilityTimerRef.current = null;
+            checkFeasibility();
+        }, 700);
+    });
+    useEffect(()=>()=>{
+            if (feasibilityTimerRef.current) clearTimeout(feasibilityTimerRef.current);
+        }, []);
     const handleModel2Change = useEffectEvent((next, notes)=>{
         store.setModel2Graph(next);
         if (notes.length > 0) store.setModel2Notes(notes);
         store.markEdited();
-        /*
-     * The readiness answer is about a graph that no longer exists the moment an
-     * edit lands, so it is dropped rather than left on screen. Re-asking on
-     * every keystroke would be a request per character; the author asks again
-     * with the button, and a save always re-asks on the server anyway.
-     */ dropFeasibility();
+        // The old answer is about a graph that no longer exists: drop it now,
+        // re-ask when the author pauses.
+        dropFeasibility();
+        scheduleFeasibility();
     });
     const handleMaxPassesChange = useEffectEvent((value)=>{
         store.setMaxPasses(value);
         store.markEdited();
         // The round limit is part of the question the card answered.
         dropFeasibility();
+        scheduleFeasibility();
     });
     // ─── Flow details ─────────────────────────────────────────────
     //

package/dist/fe/components/VerificationFlowPage/labels.d.ts

@@ -443,6 +443,8 @@ export type VerificationFlowLabels = {
     reviewStartedNote: string;
     /** On the reviewer's card: which round, and what Reject will do. */
     pendingRound: (pass: number, max: number) => string;
+    /** On a reviewer's card in a later round: why the previous round was rejected. */
+    previousRoundReason: (reason: string) => string;
     pendingRejectSendsBack: (stepLabel: string) => string;
     pendingRejectEndsReview: string;
     pendingLastRoundWarning: string;
@@ -480,6 +482,10 @@ export type VerificationFlowLabels = {
     maxPassesOutOfRange: string;
     /** The author's correction card — a correction step, not a review. */
     revisionCardTitle: string;
+    /** The same card on round 1, before anything has been sent back. */
+    revisionFirstTitle: string;
+    submitForReview: string;
+    submitForReviewHint: string;
     returnedBecause: (reason: string) => string;
     returnedNoReason: string;
     resubmit: string;

package/dist/fe/components/VerificationFlowPage/labels.js

@@ -235,7 +235,7 @@
     approvalModeAll: 'Everyone listed',
     approvalModeAllHint: 'Every person above must decide before the record moves on.',
     approvalModeAny: 'Any one of them',
-    approvalModeAnyHint: 'The first decision closes the step, and the others are no longer asked.',
+    approvalModeAnyHint: 'The first person listed to finish closes the step, and the others are no longer asked. A role set to "every member" finishes only when all its members have signed.',
     outcomes: 'Where each answer sends it',
     onApproved: 'If approved',
     onApprovedNext: 'Go to the next step',
@@ -320,6 +320,7 @@
     startReviewFailed: 'The review could not be started.',
     reviewStartedNote: 'Sent for review.',
     pendingRound: (pass, max)=>`Round ${pass} (at most ${max})`,
+    previousRoundReason: (reason)=>`Rejected last round because: ${reason}`,
     pendingRejectSendsBack: (stepLabel)=>`Rejecting sends this back to ${stepLabel}.`,
     pendingRejectEndsReview: 'Rejecting ends this review.',
     pendingLastRoundWarning: 'This is the last round this flow allows, so rejecting now ends the review for good — the record will not go back to its author again.',
@@ -350,6 +351,9 @@
     liveFlowLocked: (n)=>`${n} review${n === 1 ? ' is' : 's are'} running under this flow, so its steps are locked. You can still rename steps and edit what they send.`,
     maxPassesOutOfRange: 'Between 1 and 20.',
     revisionCardTitle: 'Returned to you for a correction',
+    revisionFirstTitle: 'Check your record before the reviewers see it',
+    submitForReview: 'Send to the reviewers',
+    submitForReviewHint: 'Make any last changes on the record first; the reviewers read it as it is when you send it.',
     returnedBecause: (reason)=>`Why it came back: ${reason}`,
     returnedNoReason: 'The reviewer did not give a reason.',
     resubmit: 'Fixed — send back for review',
@@ -428,7 +432,12 @@ export function recipientTypeLabels(say) {
 // one, the engine's sentence when it does not, and a generic line only when
 // the engine sent nothing at all.
 export function refusalSentence(say, code, detail, fallback, generic) {
-    const own = code ? say.flowRefusalByCode[code] : undefined;
+    /*
+   * Publish refuses with the READINESS codes too (a chain needing more people
+   * than the install has). A host that worded those only for the readiness
+   * card got the English sentence in the publish banner — measured by the
+   * re-check on the Turkish panel.
+   */ const own = code ? say.flowRefusalByCode[code] ?? say.feasibilityByCode[code] : undefined;
     if (own) return own(detail ?? {});
     const decision = code ? say.decisionRefusalByCode[code] : undefined;
     if (decision) return decision;

package/dist/fe/components/VerificationFlowPage/model2/StepCard.js

@@ -251,7 +251,9 @@ export function StepCard({ step, graph, isFirst, isLast, roles, users, triggerLa
                                     step_node_id: step.node_id
                                 },
                                 actions: stepActions,
-                                triggers: STEP_TRIGGERS,
+                                // "The author sent it back" can only happen on the author's own
+                                // correction step; offered elsewhere it saved and never fired.
+                                triggers: (step.kind ?? 'approval') === 'revision' ? STEP_TRIGGERS : STEP_TRIGGERS.filter((t)=>t !== 'on_resubmitted'),
                                 triggerLabels: triggerLabels,
                                 recipientTypeLabels: recipientTypeLabels,
                                 channelLabels: channelLabels,

package/dist/fe/components/VerificationFlowPage/model2/editorGraph.js

@@ -412,7 +412,15 @@ export function updateActionAt(graph, index, patch) {
 /** The steps an approval on `nodeId` may skip to: strictly later ones. */ export function approveTargets(graph, nodeId) {
     const step = (graph.steps ?? []).find((s)=>s.node_id === nodeId);
     if (!step) return [];
-    return (graph.steps ?? []).filter((s)=>s.step_order > step.step_order).sort(byOrder);
+    const later = (graph.steps ?? []).filter((s)=>s.step_order > step.step_order).sort(byOrder);
+    if ((step.kind ?? 'approval') !== 'revision') return later;
+    /*
+   * A correction step may not jump OVER a reviewer. Two correction steps at
+   * the front with different jumps gave each round a different entry, and a
+   * reviewer walked in round 1 but jumped over in round 2 kept a signature on
+   * the old text (found by the re-check). Mirrors `revision_skips_reviewers`.
+   */ const firstReviewer = later.find((s)=>(s.kind ?? 'approval') !== 'revision');
+    return firstReviewer ? later.filter((s)=>s.step_order <= firstReviewer.step_order) : later;
 }
 /**
  * The approval outcomes the step card may OFFER for `nodeId`.
@@ -547,10 +555,12 @@ export const MAX_PASSES_MAX = 20;
  * first (found in the audit). Telling the author the two buttons do the same
  * thing there is telling them a choice that matters does not.
  */ export function approvalModeHasNoEffect(step) {
-    const slots = step.assignees ?? [];
-    if (slots.length !== 1) return false;
-    const only = slots[0];
-    return !(only?.verifier_type === 'role' && only.role_quorum === 'all');
+    /*
+   * The engine reads "any one of them" as any one SLOT, and a slot of "every
+   * member" is finished only when every member has signed (0.10.135). So with
+   * ONE slot the two modes are the same rule whatever its quorum — the
+   * exception this carried described the engine before that fix.
+   */ return (step.assignees ?? []).length === 1;
 }
 /**
  * The part of a step patch a live flow still accepts: its wording.

package/dist/fe/components/VerificationFlowPage/model2/theme.js

@@ -12,7 +12,11 @@
  */ const dark = {
     editor: {
         root: 'flex-1 min-h-0 flex flex-col bg-[#08080d]',
-        scroll: 'flex-1 overflow-y-auto px-6 py-5',
+        // `relative`: the scroll box must be the positioning context. Without it the
+        // editor's `sr-only` labels (position: absolute) anchored to the page, not
+        // to this box, escaped its clipping and stretched the DOCUMENT to ~3000px —
+        // a second scrollbar, and the panel's sticky header sliding over Kaydet.
+        scroll: 'relative flex-1 overflow-y-auto px-6 py-5',
         header: 'flex-shrink-0 px-6 pt-5 pb-3 flex items-start justify-between gap-4',
         headerTitle: 'text-[13px] font-semibold text-white/90 tracking-tight',
         headerSubtitle: 'text-[11px] text-white/40 mt-1 leading-relaxed max-w-prose',
@@ -140,7 +144,11 @@
 const light = {
     editor: {
         root: 'flex-1 min-h-0 flex flex-col bg-slate-50',
-        scroll: 'flex-1 overflow-y-auto px-6 py-5',
+        // `relative`: the scroll box must be the positioning context. Without it the
+        // editor's `sr-only` labels (position: absolute) anchored to the page, not
+        // to this box, escaped its clipping and stretched the DOCUMENT to ~3000px —
+        // a second scrollbar, and the panel's sticky header sliding over Kaydet.
+        scroll: 'relative flex-1 overflow-y-auto px-6 py-5',
         header: 'flex-shrink-0 px-6 pt-5 pb-3 flex items-start justify-between gap-4',
         headerTitle: 'text-[13px] font-semibold text-slate-800 tracking-tight',
         headerSubtitle: 'text-[11px] text-slate-500 mt-1 leading-relaxed max-w-prose',

package/dist/fe/components/VerificationFlowPage/theme/index.js

@@ -47,7 +47,7 @@ export const verificationFlowPageTheme = {
         select: 'rounded-lg border border-white/[0.08] bg-white/[0.04] px-3 py-1.5 text-[11px] text-white/70 outline-none focus:border-white/20'
     },
     palette: {
-        container: 'flex-1 overflow-auto p-4',
+        container: 'relative flex-1 overflow-auto p-4',
         title: 'text-[10px] font-bold uppercase tracking-[0.15em] text-white/30 mb-3 px-1',
         item: 'flex items-start gap-3 rounded-xl p-3 mb-2 cursor-grab active:cursor-grabbing transition-all border border-transparent hover:border-white/[0.08]',
         itemIcon: 'w-9 h-9 rounded-lg flex items-center justify-center flex-shrink-0',
@@ -107,7 +107,7 @@ export const verificationFlowPageTheme = {
         header: 'flex items-center justify-between px-4 py-3 border-b border-white/[0.06]',
         headerTitle: 'text-[12px] font-semibold text-white/80',
         closeButton: 'w-6 h-6 rounded-md flex items-center justify-center text-white/30 hover:text-white/60 hover:bg-white/[0.06] transition-all',
-        body: 'flex-1 overflow-auto p-4 space-y-5',
+        body: 'relative flex-1 overflow-auto p-4 space-y-5',
         help: 'rounded-lg bg-white/[0.04] px-3 py-2.5 text-[11px] leading-relaxed text-white/50',
         readOnlyRow: 'flex items-baseline justify-between gap-3 rounded-lg bg-white/[0.04] px-3 py-2 text-[11px] text-white/50',
         readOnlyValue: 'text-[12px] font-semibold tabular-nums text-white/80',
@@ -193,7 +193,7 @@ export const verificationFlowPageTheme = {
         }
     },
     flowList: {
-        container: 'flex-1 overflow-auto p-6',
+        container: 'relative flex-1 overflow-auto p-6',
         grid: 'grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4 max-w-6xl mx-auto',
         createButton: 'group flex flex-col items-center justify-center rounded-xl border-2 border-dashed border-white/[0.08] bg-white/[0.02] p-8 min-h-[180px] cursor-pointer hover:border-white/[0.15] hover:bg-white/[0.04] transition-all',
         createButtonIcon: 'text-white/20 group-hover:text-white/40 transition-colors mb-3',
@@ -274,7 +274,7 @@ export const verificationFlowPageLightTheme = {
         select: 'rounded-lg border border-gray-200 bg-gray-50 px-3 py-1.5 text-[11px] text-gray-600 outline-none focus:border-gray-400'
     },
     palette: {
-        container: 'flex-1 overflow-auto p-4',
+        container: 'relative flex-1 overflow-auto p-4',
         title: 'text-[10px] font-bold uppercase tracking-[0.15em] text-gray-400 mb-3 px-1',
         item: 'flex items-start gap-3 rounded-xl p-3 mb-2 cursor-grab active:cursor-grabbing transition-all border border-transparent hover:border-gray-200',
         itemIcon: 'w-9 h-9 rounded-lg flex items-center justify-center flex-shrink-0',
@@ -343,7 +343,7 @@ export const verificationFlowPageLightTheme = {
         header: 'flex items-center justify-between px-4 py-3 border-b border-gray-200',
         headerTitle: 'text-[12px] font-semibold text-gray-800',
         closeButton: 'w-6 h-6 rounded-md flex items-center justify-center text-gray-400 hover:text-gray-600 hover:bg-gray-100 transition-all',
-        body: 'flex-1 overflow-auto p-4 space-y-5',
+        body: 'relative flex-1 overflow-auto p-4 space-y-5',
         help: 'rounded-lg bg-gray-50 border border-gray-200 px-3 py-2.5 text-[11px] leading-relaxed text-gray-600',
         readOnlyRow: 'flex items-baseline justify-between gap-3 rounded-lg bg-gray-50 border border-gray-200 px-3 py-2 text-[11px] text-gray-500',
         readOnlyValue: 'text-[12px] font-semibold tabular-nums text-gray-800',
@@ -429,7 +429,7 @@ export const verificationFlowPageLightTheme = {
         }
     },
     flowList: {
-        container: 'flex-1 overflow-auto p-6',
+        container: 'relative flex-1 overflow-auto p-6',
         grid: 'grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4 max-w-6xl mx-auto',
         createButton: 'group flex flex-col items-center justify-center rounded-xl border-2 border-dashed border-gray-300 bg-gray-50 p-8 min-h-[180px] cursor-pointer hover:border-gray-400 hover:bg-gray-100 transition-all',
         createButtonIcon: 'text-gray-400 group-hover:text-gray-600 transition-colors mb-3',