@sanity/workflow-studio 0.25.0 → 0.27.0

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # @sanity/workflow-studio
 
+## 0.27.0
+
+### Minor Changes
+
+- 780cf93: **BREAKING:** `ProjectMember.roles` is now `readonly {name: string; title?: string}[]` instead of `readonly string[]`, and `AssigneeStack`'s `roles` prop takes the same records rather than name strings. This affects integrations that build or read `ProjectMember` rows directly, or render `AssigneeStack` themselves. Read `role.name` wherever a role name was read before, and pass role records rather than name strings into `projectMemberRow` and `AssigneeStack`. Until migrated, TypeScript fails at those sites. Integrations using `useProjectMembers` from `@sanity/workflow-sdk` or the Studio plugin's own equivalent get the new shape without changes, because the adapters own the projection.
+
+  A role now reads as its project title rather than its machine name — `Administrator`, not `administrator` — wherever one is shown: picker role rows, assignee badges, the instance-snapshot pills, and the hover hint naming a collapsed assignee cluster. A square role avatar takes its letters from the title too, so `Blueprints Deployer` reads as `BD` where `blueprints-deployer` could only ever give one letter; its colour still derives from the machine name, so retitling a project role keeps the role's colour. A role whose membership record carries no title — or a title that is only whitespace, which counts as none — and a role named by an assignee that no current member holds, both still read as the machine name. `roleLabel`, `roleLabelFor`, and `memberRoleFor` are exported for callers rendering their own role labels.
+
+  Both people-pickers now say who a person is, so choosing one no longer requires knowing the org chart. Search matches role names and titles as well as display name and email, so typing a role narrows the list to its holders. Members are also listed by display name rather than in the order the host supplied them, which was the sequence people joined the project — expect the list order to change, and on a large project to become usable. And hovering a row previews the account behind the name — a larger avatar badged with the person's identity provider, their email, and the roles they hold. Marks exist for Google, GitHub, and `saml-`-prefixed deployments; any other provider badges nothing rather than showing an empty circle. That is what tells two members sharing a display name apart, which no role label could. Rows share one tooltip delay group, so the wait to open is paid once and moving along the list swaps the preview rather than waiting again at each row.
+
+  `MemberAvatar` takes an optional `loginProvider` to badge the provider mark onto its corner. `ProjectMember` gains optional `loginProvider` and `isCurrentUser`; both are populated by the adapters, so integrations using `useProjectMembers` get them without changes.
+
+  Neither picker ranks or groups its member rows by the roles those members hold, and neither claims who is eligible for an activity. (The roles-and-members picker still lists selectable roles above the members, as it did before.) An activity has no role gate; only an action does, and a manually fired action's `roles` is folded into its `filter` at desugar, so the accepted set is not readable from a deployed definition. A picker has nothing to derive eligibility from, and a ranked list would assert something no engine or Content Lake check backs.
+
+  Stored values are unchanged. An assignee still persists the machine role name, and titles are display only.
+
+  **Docs impact:** Update the `@sanity/workflow-components` member-selection reference for the `ProjectMember.roles` and `AssigneeStack` `roles` shapes and the `roleLabel` / `roleLabelFor` / `memberRoleFor` exports (done in this package's README). Any concept or guide page showing a role in Studio UI should show titles rather than machine names, and the assignment guide should state that a picker never restricts or ranks who may be assigned. Add the `ProjectMember.roles` migration to the release notes.
+
+### Patch Changes
+
+- Updated dependencies [780cf93]
+- Updated dependencies [b7c8bed]
+  - @sanity/workflow-engine@0.27.0
+  - @sanity/workflow-sdk@0.27.0
+  - @sanity/workflow-react@0.27.0
+
+## 0.26.0
+
+### Patch Changes
+
+- @sanity/workflow-engine@0.26.0
+  - @sanity/workflow-react@0.26.0
+  - @sanity/workflow-sdk@0.26.0
+
 ## 0.25.0
 
 ### Patch Changes

package/dist/index.cjs

@@ -194,11 +194,11 @@ function isRecord(value) {
 }
 
 function isRole(value) {
-    return isRecord(value) && typeof value.name == "string";
+    return isRecord(value) && typeof value.name == "string" && (value.title === void 0 || typeof value.title == "string");
 }
 
 function isMembership(value) {
-    return isRecord(value) && typeof value.id == "string" && (value.isRobot === void 0 || typeof value.isRobot == "boolean") && (value.roles === void 0 || Array.isArray(value.roles) && value.roles.every(isRole));
+    return isRecord(value) && typeof value.id == "string" && (value.isRobot === void 0 || typeof value.isRobot == "boolean") && (value.isCurrentUser === void 0 || typeof value.isCurrentUser == "boolean") && (value.roles === void 0 || Array.isArray(value.roles) && value.roles.every(isRole));
 }
 
 async function fetchProjectUsers(client, projectId) {

package/dist/index.d.cts

@@ -39,8 +39,10 @@ export declare interface StudioObserverOptions {
 export declare interface StudioProjectMembership {
   readonly id: string;
   readonly isRobot?: boolean;
+  readonly isCurrentUser?: boolean;
   readonly roles?: readonly {
     readonly name: string;
+    readonly title?: string;
   }[];
   readonly [key: string]: unknown;
 }

package/dist/index.d.ts

@@ -39,8 +39,10 @@ export declare interface StudioObserverOptions {
 export declare interface StudioProjectMembership {
   readonly id: string;
   readonly isRobot?: boolean;
+  readonly isCurrentUser?: boolean;
   readonly roles?: readonly {
     readonly name: string;
+    readonly title?: string;
   }[];
   readonly [key: string]: unknown;
 }

package/dist/index.js

@@ -202,11 +202,11 @@ function isRecord(value) {
 }
 
 function isRole(value) {
-    return isRecord(value) && typeof value.name == "string";
+    return isRecord(value) && typeof value.name == "string" && (value.title === void 0 || typeof value.title == "string");
 }
 
 function isMembership(value) {
-    return isRecord(value) && typeof value.id == "string" && (value.isRobot === void 0 || typeof value.isRobot == "boolean") && (value.roles === void 0 || Array.isArray(value.roles) && value.roles.every(isRole));
+    return isRecord(value) && typeof value.id == "string" && (value.isRobot === void 0 || typeof value.isRobot == "boolean") && (value.isCurrentUser === void 0 || typeof value.isCurrentUser == "boolean") && (value.roles === void 0 || Array.isArray(value.roles) && value.roles.every(isRole));
 }
 
 async function fetchProjectUsers(client, projectId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/workflow-studio",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "description": "React adapter that drives the @sanity/workflow-engine reactive session in Sanity Studio through the App SDK store.",
   "keywords": [
     "sanity",
@@ -50,17 +50,17 @@
     "react-dom": "^19.2.7",
     "sanity": "^6",
     "vitest": "^4.1.8",
-    "@sanity/workflow-react": "0.25.0",
-    "@sanity/workflow-sdk": "0.25.0",
-    "@sanity/workflow-engine": "0.25.0"
+    "@sanity/workflow-react": "0.27.0",
+    "@sanity/workflow-engine": "0.27.0",
+    "@sanity/workflow-sdk": "0.27.0"
   },
   "peerDependencies": {
     "@sanity/sdk": "^2.12.0",
     "react": "^19.2.7",
     "sanity": "^6",
-    "@sanity/workflow-react": "0.25.0",
-    "@sanity/workflow-engine": "0.25.0",
-    "@sanity/workflow-sdk": "0.25.0"
+    "@sanity/workflow-react": "0.27.0",
+    "@sanity/workflow-sdk": "0.27.0",
+    "@sanity/workflow-engine": "0.27.0"
   },
   "engines": {
     "node": ">=20"