@sanity/workflow-studio-plugin 0.30.0 → 0.31.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @sanity/workflow-studio-plugin
 
+## 0.31.0
+
+### Minor Changes
+
+- ae876ad: The Workflows tool Overview table and board cards now say how late a run is instead of only that it is late. A run with one overdue task shows a calendar glyph and a compact span in caution — `4d` — and a run with several shows the count instead (`3 tasks`). Hovering the mark opens the same stage-tasks panel the row's people open when a listed human task is late, and that panel now carries the same calendar and span beside each task title, so the row's figure can be traced to the task it counts. Lateness that sits on an automation has no row in that panel, even if other human tasks are still open, and keeps a sentence: `3 tasks overdue — the longest by 4d`.
+
+  A run that cannot continue now wears a critical disc rather than a bare outline glyph, and its hover text names the cause instead of restating that the document is blocked: a task sent back is quoted by title, an automation that reported a failure reads `Automation “Notify legal” failed`, and one that was claimed and never reported back reads `Automation “Notify legal” didn’t finish` — the two are no longer told as the same fault.
+
+  The Tasks column now fits as many assignee groups as the column is actually wide enough for, rather than always three, and keeps room for the `+N` counter. Previously a row whose tasks were held by several people pushed the counter past the column's edge, where it lost its number and left a stray `+` sitting against the next column; a wide window now also fills the column it was given instead of stopping at three groups.
+
+  **No upgrade action required.** Both marks are derived from the same committed instance state as before; no definition, stored field, or configuration changes.
+
+  **Docs impact:** Update the Workflows tool guide wherever it pictures or describes the Overview attention column and the board cards' marks — the overdue mark is now a calendar with a span rather than a warning triangle, it opens the stage-tasks panel, and the blocked mark names its cause.
+
+- b593a51: The Workflows tool Overview Open runs table labels its people column **Tasks**, and each cell (and each board card) groups holders by the current stage's human activities instead of flattening them into one stack. Overlap means one task, a gap means the next, a dashed circle with a person glyph means nobody is holding that task, and hover lists every task in the stage. Inside a mixed group, role squares sit before people.
+
+  Automated activities are left out of the cell only when the deployed workflow the run is pinned to says so. A run pinned to an older version, or one whose workflow the catalog no longer carries, shows all of its open activities as tasks rather than risking a hidden one.
+
+  The run scope picker beside the workflow picker now rests on the surrounding surface — white in a light scheme, the panel colour in a dark one — instead of a filled grey chip, and keeps its outline and hover feedback.
+
+  **No upgrade action required.**
+
+  **Docs impact:** Update the Workflows tool guide wherever it names the Overview Assignees column or implies a run itself has assignees.
+
+- 7832486: The Workflows tool Open runs header now keeps the applied filter chips and **Clear filters** at the right of the row, next to the **Add filter** button and the Table/Board toggle, instead of at the left beside the workflow and scope pickers. The workflow picker and the open/closed scope picker stay on the left. Applied filters grow leftward from the **Add filter** button, so adding a chip no longer moves that button, and a row too wide for the viewport wraps the filter group rather than pushing the pickers off the line.
+
+  **No upgrade action required.** Filter behaviour, the saved view, and the URL parameters that address a filtered view are unchanged.
+
+  **Docs impact:** Update any Workflows tool guide screenshot or prose that places the applied filters beside the workflow picker at the left of the Open runs header.
+
+### Patch Changes
+
+- ff72ece: Reader-model errors and the Studio Workflows tool now link to the canonical `/docs/workflows` documentation routes.
+
+  **No upgrade action required.** Permanent redirects preserve the former `/docs/editorial-workflows` URLs.
+
+  **Docs impact:** Publish the Workflows documentation at `/docs/workflows` and retain permanent redirects from every previously published `/docs/editorial-workflows` route.
+
+- Updated dependencies [ff72ece]
+  - @sanity/workflow-engine@0.31.0
+  - @sanity/workflow-components@0.31.0
+  - @sanity/workflow-diagram@0.31.0
+  - @sanity/workflow-react@0.31.0
+  - @sanity/workflow-studio@0.31.0
+
 ## 0.30.0
 
 ### Minor Changes

package/README.md

@@ -377,7 +377,7 @@ into its workflows, so instances whose documents are gone stay in-flight
 until something settles them. A document-delete
 function settles them the moment the deletion happens, on the robot token —
 see the cookbook recipe
-[Handle a deleted subject document](https://www.sanity.io/docs/editorial-workflows/cookbook-handle-deleted-subject).
+[Handle a deleted subject document](https://www.sanity.io/docs/workflows/cookbook-handle-deleted-subject).
 
 ## Limitations
 

package/dist/_chunks-cjs/index.cjs

@@ -408,9 +408,12 @@ function formatShortAgo(value, now) {
 }
 
 function formatShortSpan(value, now) {
-    const d = new Date(value);
-    if (Number.isNaN(d.getTime())) return "—";
-    const seconds = Math.floor((now.getTime() - d.getTime()) / 1e3);
+    return shortSpanOf(new Date(value), now);
+}
+
+function shortSpanOf(from, now) {
+    if (from === void 0 || Number.isNaN(from.getTime())) return "—";
+    const seconds = Math.floor((now.getTime() - from.getTime()) / 1e3);
     if (seconds < 60) return "now";
     const minutes = Math.floor(seconds / 60);
     if (minutes < 60) return `${minutes}m`;
@@ -725,6 +728,10 @@ function assigneesOf(entries) {
     return entries.flatMap(entry => entry._type === "assignees" ? entry.value : []);
 }
 
+function userIdsOf(assignees) {
+    return assignees.flatMap(assignee => assignee.type === "user" ? [ assignee.id ] : []);
+}
+
 function assigneeEdit(current, next) {
     const changed = changedAssignee(current, next);
     if (changed !== void 0) return next.some(item => workflowComponents.sameAssignee(item, changed)) ? {
@@ -904,8 +911,15 @@ const ACTIVITY_STATUS_LABEL = {
     skipped: "Skipped"
 };
 
+function isHandsOff(args) {
+    return args.classification === "autonomous" && args.completesWithoutCaller === "yes";
+}
+
 function showsAutomatedPill(activityEval) {
-    return !workflowEngine.isTerminalActivityStatus(activityEval.status) && activityEval.classification === "autonomous" && activityEval.autonomy.completesWithoutCaller === "yes";
+    return !workflowEngine.isTerminalActivityStatus(activityEval.status) && isHandsOff({
+        classification: activityEval.classification,
+        completesWithoutCaller: activityEval.autonomy.completesWithoutCaller
+    });
 }
 
 function showsBlockedTag(activityEval) {
@@ -1318,6 +1332,10 @@ function disambiguatedNames(displays) {
     return displays.map(display => (counts.get(display.name) ?? 0) < 2 || display.loginProvider === void 0 ? display.name : `${display.name} (${workflowComponents.providerTitle(display.loginProvider) ?? display.loginProvider})`);
 }
 
+function uniqueIds(ids) {
+    return [ ...new Set(ids) ];
+}
+
 function useUserDisplays(ids) {
     const {members: members} = useProjectMembers(), {users: users} = workflowStudio.useStudioProjectUsers(), meRaw = sanity.useCurrentUser(), me = react.useMemo(() => meRaw === null ? null : {
         ...meRaw,
@@ -4480,7 +4498,7 @@ function AvatarButton({avatar: avatar, onClick: onClick, onMouseDown: onMouseDow
 }
 
 function RowAssignees({assignees: assignees, hint: hint}) {
-    const ids = assignees.flatMap(item => item.type === "user" ? [ item.id ] : []), vocabulary = useProjectMembers(), roles = assignees.flatMap(item => item.type === "role" ? [ workflowComponents.memberRoleFor(vocabulary, item.role) ] : []), displays = useUserDisplays(ids);
+    const ids = userIdsOf(assignees), vocabulary = useProjectMembers(), roles = assignees.flatMap(item => item.type === "role" ? [ workflowComponents.memberRoleFor(vocabulary, item.role) ] : []), displays = useUserDisplays(ids);
     if (ids.length === 0 && roles.length === 0) return null;
     const bothKinds = roles.length > 0 && displays.length > 0;
     /* @__PURE__ */
@@ -5737,6 +5755,13 @@ function GroupHeading({busy: busy, count: count, title: title, end: end}) {
 
 const EMPTY_METRIC_OPACITY = .5;
 
+function labelledImgProps(label) {
+    return label === void 0 ? {} : {
+        "aria-label": label,
+        role: "img"
+    };
+}
+
 function MetricText({children: children, tone: tone}) {
     return tone === void 0 ? /* @__PURE__ */ jsxRuntime.jsx(ui.Text, {
         muted: !0,
@@ -5749,33 +5774,41 @@ function MetricText({children: children, tone: tone}) {
     });
 }
 
-function MetricPair({Icon: Icon, empty: empty, face: face, tone: tone, value: value}) {
+function MetricPair({face: face, ...lockup}) {
     /* @__PURE__ */
     return jsxRuntime.jsx(HoverHint, {
         ...face,
-        children: /* @__PURE__ */ jsxRuntime.jsxs(ui.Flex, {
-            align: "center",
-            gap: 2,
-            style: empty ? {
-                opacity: EMPTY_METRIC_OPACITY
-            } : void 0,
-            children: [ 
-            /* @__PURE__ */ jsxRuntime.jsx(MetricText, {
-                tone: tone,
-                children: /* @__PURE__ */ jsxRuntime.jsx(Icon, {
-                    style: {
-                        color: "inherit"
-                    }
-                })
-            }), 
-            /* @__PURE__ */ jsxRuntime.jsx(MetricText, {
-                tone: tone,
-                children: value
-            }) ]
+        children: /* @__PURE__ */ jsxRuntime.jsx(MetricLockup, {
+            ...lockup
         })
     });
 }
 
+function MetricLockup({Icon: Icon, empty: empty, label: label, tone: tone, value: value}) {
+    /* @__PURE__ */
+    return jsxRuntime.jsxs(ui.Flex, {
+        align: "center",
+        gap: 2,
+        style: empty ? {
+            opacity: EMPTY_METRIC_OPACITY
+        } : void 0,
+        ...labelledImgProps(label),
+        children: [ 
+        /* @__PURE__ */ jsxRuntime.jsx(MetricText, {
+            tone: tone,
+            children: /* @__PURE__ */ jsxRuntime.jsx(Icon, {
+                style: {
+                    color: "inherit"
+                }
+            })
+        }), 
+        /* @__PURE__ */ jsxRuntime.jsx(MetricText, {
+            tone: tone,
+            children: value
+        }) ]
+    });
+}
+
 function AlertGlyph({Icon: Icon, hint: hint, label: label, tone: tone}) {
     /* @__PURE__ */
     return jsxRuntime.jsx(HoverHint, {
@@ -5784,10 +5817,7 @@ function AlertGlyph({Icon: Icon, hint: hint, label: label, tone: tone}) {
             size: 1,
             tone: tone,
             children: /* @__PURE__ */ jsxRuntime.jsx(Icon, {
-                ...label === void 0 ? {} : {
-                    "aria-label": label,
-                    role: "img"
-                },
+                ...labelledImgProps(label),
                 style: {
                     color: "inherit"
                 }
@@ -5796,6 +5826,37 @@ function AlertGlyph({Icon: Icon, hint: hint, label: label, tone: tone}) {
     });
 }
 
+function AlertChip({Icon: Icon, hint: hint, label: label, tone: tone}) {
+    const glyph = useTextIconSize(), disc = glyph + useSpaceToken(1) * 2;
+    /* @__PURE__ */
+    return jsxRuntime.jsx(HoverHint, {
+        text: hint,
+        children: /* @__PURE__ */ jsxRuntime.jsx(ui.Card, {
+            radius: "full",
+            style: {
+                alignItems: "center",
+                display: "flex",
+                height: disc,
+                justifyContent: "center",
+                width: disc
+            },
+            tone: tone,
+            children: /* @__PURE__ */ jsxRuntime.jsx(sanity.TextWithTone, {
+                size: 1,
+                tone: tone,
+                children: /* @__PURE__ */ jsxRuntime.jsx(Icon, {
+                    ...labelledImgProps(label),
+                    style: {
+                        color: "inherit",
+                        height: glyph,
+                        width: glyph
+                    }
+                })
+            })
+        })
+    });
+}
+
 function ActivityDateControl({instanceId: instanceId, state: state, surface: surface, dueDates: dueDates}) {
     const editField = useEditField(surface), {save: save} = useSaveField({
         instanceId: instanceId
@@ -6409,7 +6470,7 @@ function AvatarCapAligned({children: children}) {
 }
 
 function AssigneesFace({assignees: assignees}) {
-    const vocabulary = useProjectMembers(), userIds = assignees.flatMap(a => a.type === "user" ? [ a.id ] : []), roles = assignees.flatMap(a => a.type === "role" ? [ workflowComponents.roleLabelFor(vocabulary, a.role) ] : []);
+    const vocabulary = useProjectMembers(), userIds = userIdsOf(assignees), roles = assignees.flatMap(a => a.type === "role" ? [ workflowComponents.roleLabelFor(vocabulary, a.role) ] : []);
     /* @__PURE__ */
     return jsxRuntime.jsxs(jsxRuntime.Fragment, {
         children: [ userIds.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx(AvatarCapAligned, {
@@ -11580,6 +11641,8 @@ exports.ActivityLog = ActivityLog;
 
 exports.AgoStamp = AgoStamp;
 
+exports.AlertChip = AlertChip;
+
 exports.AlertGlyph = AlertGlyph;
 
 exports.CodeChip = CodeChip;
@@ -11608,6 +11671,8 @@ exports.LogEventOnMount = LogEventOnMount;
 
 exports.MetaRow = MetaRow;
 
+exports.MetricLockup = MetricLockup;
+
 exports.MetricPair = MetricPair;
 
 exports.NoteBanner = NoteBanner;
@@ -11616,8 +11681,6 @@ exports.RUN_SEARCH_PARAM = RUN_SEARCH_PARAM;
 
 exports.RoleAssignedNotice = RoleAssignedNotice;
 
-exports.RowAssignees = RowAssignees;
-
 exports.SpinnerSlot = SpinnerSlot;
 
 exports.TOOL_TABS = TOOL_TABS;
@@ -11638,6 +11701,8 @@ exports.WorkflowTitleSeedDrifted = WorkflowTitleSeedDrifted;
 
 exports.WorkflowToolOpened = WorkflowToolOpened;
 
+exports.activityLabel = activityLabel;
+
 exports.assigneesOf = assigneesOf;
 
 exports.countBy = countBy;
@@ -11648,6 +11713,8 @@ exports.definitionsRouteOf = definitionsRouteOf;
 
 exports.describeError = describeError;
 
+exports.disambiguatedNames = disambiguatedNames;
+
 exports.dueDatesOf = dueDatesOf;
 
 exports.findActivity = findActivity;
@@ -11668,6 +11735,8 @@ exports.isDueDatePast = isDueDatePast;
 
 exports.isEvaluationStale = isEvaluationStale;
 
+exports.isHandsOff = isHandsOff;
+
 exports.isLiveEntry = isLiveEntry;
 
 exports.isOpenActivityStatus = isOpenActivityStatus;
@@ -11686,6 +11755,8 @@ exports.parseStoredDateValue = parseStoredDateValue;
 
 exports.readDeployedDefinitions = readDeployedDefinitions;
 
+exports.shortSpanOf = shortSpanOf;
+
 exports.stageTitle = stageTitle;
 
 exports.tabSelectionNavigates = tabSelectionNavigates;
@@ -11694,6 +11765,8 @@ exports.toolRoute = toolRoute;
 
 exports.toolTabState = toolTabState;
 
+exports.uniqueIds = uniqueIds;
+
 exports.useAssignmentIdentity = useAssignmentIdentity;
 
 exports.useAvatarSize = useAvatarSize;
@@ -11726,6 +11799,8 @@ exports.useWorkflowContext = useWorkflowContext;
 
 exports.useWorkflowInstanceEntry = useWorkflowInstanceEntry;
 
+exports.userIdsOf = userIdsOf;
+
 exports.workflowDefaultDocumentNode = workflowDefaultDocumentNode;
 
 exports.workflowState = workflowState;