v1.5.1

changelog.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 2026-05-02 - 1.5.1 - fix(sdig-workspace)
+make workspace view externally controllable and preserve explicit initial state
+
+- change the workspace view from internal state to a reflected public property
+- only apply initialView during connection when no non-default view has already been set
+
+## 2026-05-02 - 1.5.0 - feat(elements)
+add reusable context menu element for recipient role selection
+
+- introduces a new sdig-contextmenu web component with configurable actions, selection state, and viewport-aware positioning
+- exports the new context menu from the shared elements index
+- refactors workspace compose to use the reusable context menu for recipient role changes while preserving signer role safeguards
+
+## 2026-05-02 - 1.4.0 - feat(workspace-compose)
+add recipient routing roles and drag-and-drop routing management
+
+- Introduce recipient roles for signers, final-copy recipients, and step-update recipients.
+- Replace simple recipient reordering with role-based drag-and-drop routing sections and contextual role assignment.
+- Limit field assignment and active field tools to signing recipients, with automatic field reassignment when a signer is moved out of the signing flow.
+
 ## 2026-05-02 - 1.3.0 - feat(workspace)
 introduce a responsive signature workspace demo and remove legacy contract editor components
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signature.digital/catalog",
-  "version": "1.3.0",
+  "version": "1.5.1",
   "private": false,
   "description": "A comprehensive catalog of customizable web components designed for building and managing e-signature applications.",
   "exports": {

ts_web/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@signature.digital/catalog',
-  version: '1.3.0',
+  version: '1.5.1',
   description: 'A comprehensive catalog of customizable web components designed for building and managing e-signature applications.'
 }

ts_web/elements/index.ts

@@ -1,4 +1,5 @@
 // Signature components
+export * from './sdig-contextmenu/index.js';
 export * from './sdig-signbox/index.js';
 export * from './sdig-signpad/index.js';
 

ts_web/elements/sdig-contextmenu/index.ts

@@ -0,0 +1 @@
+export * from './sdig-contextmenu.js';

ts_web/elements/sdig-contextmenu/sdig-contextmenu.ts

@@ -0,0 +1,234 @@
+import { DeesElement, property, state, html, customElement, type TemplateResult, css } from '@design.estate/dees-element';
+
+export interface ISdigContextMenuAction {
+  id: string;
+  label: string;
+  description?: string;
+  selected?: boolean;
+  disabled?: boolean;
+  danger?: boolean;
+}
+
+export interface ISdigContextMenuActionEventDetail {
+  id: string;
+  action: ISdigContextMenuAction;
+}
+
+type TMenuPosition = {
+  x: number;
+  y: number;
+  ready: boolean;
+};
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'sdig-contextmenu': SdigContextmenu;
+  }
+}
+
+@customElement('sdig-contextmenu')
+export class SdigContextmenu extends DeesElement {
+  public static demo = () => html`
+    <div style="position: relative; min-height: 260px; padding: 24px; --bg-card: hsl(0 0% 7%); --bg-input: hsl(0 0% 9%); --border: hsl(0 0% 14.9%); --border-subtle: hsl(0 0% 11%); --text: hsl(0 0% 98%); --text-sec: hsl(0 0% 63.9%); --text-muted: hsl(0 0% 48%); --hover: rgba(255,255,255,0.06); --error: #ef4444;">
+      <sdig-contextmenu
+        .anchorX=${80}
+        .anchorY=${70}
+        .title=${'Recipient'}
+        .actions=${[
+          { id: 'signer', label: 'Needs signature', selected: true },
+          { id: 'copy', label: 'Final copy only' },
+          { id: 'updates', label: 'Every step update' },
+        ]}
+      ></sdig-contextmenu>
+    </div>
+  `;
+  public static demoGroups = ['Signature Digital Primitives'];
+
+  @property({ type: Number }) public accessor anchorX: number = 0;
+  @property({ type: Number }) public accessor anchorY: number = 0;
+  @property({ type: String }) public accessor title: string = '';
+  @property({ attribute: false }) public accessor actions: ISdigContextMenuAction[] = [];
+  @state() private accessor position: TMenuPosition = { x: 0, y: 0, ready: false };
+
+  private positionUpdateFrame: number | null = null;
+
+  public static styles = css`
+    :host { display: contents; }
+
+    .menu {
+      position: fixed;
+      z-index: 1000;
+      min-width: 190px;
+      max-width: min(280px, calc(100vw - 16px));
+      padding: 6px;
+      border: 1px solid var(--border, hsl(0 0% 14.9%));
+      border-radius: 8px;
+      background: var(--bg-card, hsl(0 0% 7%));
+      color: var(--text, hsl(0 0% 98%));
+      box-shadow: 0 16px 42px rgba(0,0,0,0.36);
+      box-sizing: border-box;
+    }
+
+    .title {
+      padding: 7px 8px;
+      margin-bottom: 4px;
+      border-bottom: 1px solid var(--border-subtle, hsl(0 0% 11%));
+      font-size: 11px;
+      font-weight: 700;
+      color: var(--text-sec, hsl(0 0% 63.9%));
+    }
+
+    .action {
+      width: 100%;
+      min-height: 34px;
+      padding: 8px;
+      border: 0;
+      border-radius: 6px;
+      background: transparent;
+      color: var(--text-sec, hsl(0 0% 63.9%));
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      text-align: left;
+      font: inherit;
+      font-size: 11px;
+      cursor: pointer;
+    }
+
+    .action:hover { background: var(--hover, rgba(255,255,255,0.06)); color: var(--text, hsl(0 0% 98%)); }
+    .action.danger { color: var(--error, #ef4444); }
+    .action[disabled] { opacity: 0.45; cursor: not-allowed; }
+    .action[disabled]:hover { background: transparent; color: var(--text-sec, hsl(0 0% 63.9%)); }
+
+    .action-mark {
+      width: 12px;
+      height: 12px;
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      flex-shrink: 0;
+    }
+
+    .action-mark.selected::before {
+      content: '';
+      width: 7px;
+      height: 4px;
+      border-left: 1.5px solid currentColor;
+      border-bottom: 1.5px solid currentColor;
+      transform: rotate(-45deg) translate(1px, -1px);
+    }
+
+    .action-copy {
+      min-width: 0;
+      display: flex;
+      flex-direction: column;
+      gap: 2px;
+    }
+
+    .action-label {
+      overflow: hidden;
+      white-space: nowrap;
+      text-overflow: ellipsis;
+    }
+
+    .action-description {
+      overflow: hidden;
+      white-space: nowrap;
+      text-overflow: ellipsis;
+      color: var(--text-muted, hsl(0 0% 48%));
+      font-size: 10px;
+      line-height: 1.25;
+    }
+  `;
+
+  public connectedCallback = async () => {
+    await super.connectedCallback();
+    window.addEventListener('resize', this.queuePositionUpdate);
+  };
+
+  public disconnectedCallback = async () => {
+    window.removeEventListener('resize', this.queuePositionUpdate);
+    if (this.positionUpdateFrame !== null) {
+      globalThis.cancelAnimationFrame(this.positionUpdateFrame);
+      this.positionUpdateFrame = null;
+    }
+    await super.disconnectedCallback();
+  };
+
+  public updated() {
+    this.queuePositionUpdate();
+  }
+
+  private queuePositionUpdate = () => {
+    if (this.positionUpdateFrame !== null) return;
+    this.positionUpdateFrame = globalThis.requestAnimationFrame(() => {
+      this.positionUpdateFrame = null;
+      this.positionMenu();
+    });
+  };
+
+  private positionMenu() {
+    const menu = this.shadowRoot?.querySelector('.menu') as HTMLElement | null;
+    if (!menu) return;
+
+    const margin = 8;
+    const gap = 4;
+    const rect = menu.getBoundingClientRect();
+    const viewportWidth = globalThis.innerWidth;
+    const viewportHeight = globalThis.innerHeight;
+    const spaceRight = viewportWidth - this.anchorX - margin;
+    const spaceLeft = this.anchorX - margin;
+    const spaceBelow = viewportHeight - this.anchorY - margin;
+    const spaceAbove = this.anchorY - margin;
+    let x = this.anchorX + gap;
+    let y = this.anchorY + gap;
+
+    if (spaceRight < rect.width + gap && spaceLeft > spaceRight) {
+      x = this.anchorX - rect.width - gap;
+    }
+
+    if (spaceBelow < rect.height + gap && spaceAbove > spaceBelow) {
+      y = this.anchorY - rect.height - gap;
+    }
+
+    const maxX = Math.max(margin, viewportWidth - rect.width - margin);
+    const maxY = Math.max(margin, viewportHeight - rect.height - margin);
+    const nextPosition = {
+      x: Math.round(Math.max(margin, Math.min(maxX, x))),
+      y: Math.round(Math.max(margin, Math.min(maxY, y))),
+      ready: true,
+    };
+
+    if (this.position.x !== nextPosition.x || this.position.y !== nextPosition.y || this.position.ready !== nextPosition.ready) {
+      this.position = nextPosition;
+    }
+  }
+
+  private selectAction(action: ISdigContextMenuAction) {
+    if (action.disabled) return;
+    this.dispatchEvent(new CustomEvent<ISdigContextMenuActionEventDetail>('contextmenu-action', {
+      detail: { id: action.id, action },
+      bubbles: true,
+      composed: true,
+    }));
+  }
+
+  public render(): TemplateResult {
+    const x = this.position.ready ? this.position.x : this.anchorX;
+    const y = this.position.ready ? this.position.y : this.anchorY;
+    return html`
+      <div class="menu" style="left: ${x}px; top: ${y}px; visibility: ${this.position.ready ? 'visible' : 'hidden'};" @click=${(event: Event) => event.stopPropagation()} @contextmenu=${(event: Event) => event.preventDefault()}>
+        ${this.title ? html`<div class="title">${this.title}</div>` : ''}
+        ${this.actions.map((action) => html`
+          <button class="action ${action.danger ? 'danger' : ''}" ?disabled=${action.disabled} @click=${() => this.selectAction(action)}>
+            <span class="action-mark ${action.selected ? 'selected' : ''}"></span>
+            <span class="action-copy">
+              <span class="action-label">${action.label}</span>
+              ${action.description ? html`<span class="action-description">${action.description}</span>` : ''}
+            </span>
+          </button>
+        `)}
+      </div>
+    `;
+  }
+}

ts_web/elements/sdig-workspace/sdig-workspace-compose.ts

@@ -1,5 +1,7 @@
 import { DeesElement, state, html, customElement, type TemplateResult, css } from '@design.estate/dees-element';
-import { actionButton, demoFields, demoRecipients, fakeDocument, icon, pill, topBar, workspaceBaseStyles, workspaceDemoFrame, type IFieldPlacement, type IRecipient } from './sdig-workspace.shared.js';
+import { actionButton, demoFields, demoRecipients, fakeDocument, icon, pill, topBar, workspaceBaseStyles, workspaceDemoFrame, type IFieldPlacement, type IRecipient, type TRecipientRole } from './sdig-workspace.shared.js';
+import '../sdig-contextmenu/index.js';
+import { type ISdigContextMenuAction, type ISdigContextMenuActionEventDetail } from '../sdig-contextmenu/index.js';
 
 declare global {
   interface HTMLElementTagNameMap {
@@ -28,6 +30,23 @@ type TFieldInteraction = {
   pageHeight: number;
 };
 
+type TSigningOrderDrag = {
+  recipientId: number;
+  pointerY: number;
+  listTop: number;
+  grabOffsetY: number;
+  itemHeight: number;
+  itemStep: number;
+  targetRole: TRecipientRole;
+  targetIndex: number;
+};
+
+type TRecipientContextMenu = {
+  recipientId: number;
+  x: number;
+  y: number;
+};
+
 const fieldDefinitions: TFieldDefinition[] = [
   { type: 'signature', icon: 'sign', label: 'Signature', w: 200, h: 50 },
   { type: 'initials', icon: 'type', label: 'Initials', w: 120, h: 32 },
@@ -38,6 +57,12 @@ const fieldDefinitions: TFieldDefinition[] = [
 
 const resizeHandles: TResizeHandle[] = ['n', 'ne', 'e', 'se', 's', 'sw', 'w', 'nw'];
 
+const recipientRoleDefinitions: Array<{ role: TRecipientRole; label: string; shortLabel: string; description: string }> = [
+  { role: 'signer', label: 'Needs signature', shortLabel: 'Signer', description: 'Can receive fields and must sign in order.' },
+  { role: 'copy', label: 'Final copy only', shortLabel: 'Copy', description: 'Receives the completed document after signing.' },
+  { role: 'updates', label: 'Every step update', shortLabel: 'Updates', description: 'Receives notifications for every routing step.' },
+];
+
 @customElement('sdig-workspace-compose')
 export class SdigWorkspaceCompose extends DeesElement {
   public static demo = () => workspaceDemoFrame(html`<sdig-workspace-compose></sdig-workspace-compose>`);
@@ -45,10 +70,11 @@ export class SdigWorkspaceCompose extends DeesElement {
 
   @state() private accessor step: number = 2;
   @state() private accessor activeRecipient: number = 0;
-  @state() private accessor draggedRecipientId: number | null = null;
   @state() private accessor selectedFieldId: string | null = null;
   @state() private accessor recipients: IRecipient[] = [...demoRecipients];
   @state() private accessor fields: IFieldPlacement[] = [...demoFields];
+  @state() private accessor signingOrderDrag: TSigningOrderDrag | null = null;
+  @state() private accessor recipientContextMenu: TRecipientContextMenu | null = null;
   private draggedFieldDefinition: TFieldDefinition | null = null;
   private draggedFieldGrabOffset: { x: number; y: number } | null = null;
   private fieldInteraction: TFieldInteraction | null = null;
@@ -70,7 +96,21 @@ export class SdigWorkspaceCompose extends DeesElement {
     .document-stage { flex: 1; overflow: auto; background: hsl(0 0% 8%); display: flex; flex-direction: column; align-items: center; padding: 32px; gap: 20px; }
     :host-context(sdig-workspace[theme='light']) .document-stage { background: hsl(0 0% 92%); }
     .recipient-line { cursor: grab; }
-    .recipient-line.dragging { opacity: 0.45; border-color: var(--accent); }
+    .routing-role-section { margin-bottom: 14px; padding: 10px; border: 1px solid var(--border-subtle); border-radius: 8px; background: color-mix(in srgb, var(--bg-card) 72%, transparent); transition: border-color 0.14s ease, background 0.14s ease; }
+    .routing-role-section.active-drop { border-color: color-mix(in srgb, var(--accent) 48%, var(--border)); background: color-mix(in srgb, var(--accent) 7%, var(--bg-card)); }
+    .routing-role-head { display: flex; align-items: center; justify-content: space-between; gap: 8px; margin-bottom: 8px; }
+    .routing-role-title { font-size: 11px; font-weight: 700; color: var(--text-sec); }
+    .routing-role-description { margin-bottom: 8px; font-size: 10px; line-height: 1.35; color: var(--text-muted); }
+    .role-count { min-width: 18px; height: 18px; padding: 0 6px; border-radius: 999px; display: inline-flex; align-items: center; justify-content: center; background: var(--bg-input); color: var(--text-muted); font-size: 10px; }
+    .role-chip { height: 22px; padding: 0 7px; border-radius: 999px; display: inline-flex; align-items: center; background: var(--bg-input); color: var(--text-muted); font-size: 10px; font-weight: 600; }
+    .signing-order-list { position: relative; min-height: 44px; }
+    .signing-order-list.dragging { height: var(--routing-list-height); min-height: var(--routing-list-height); }
+    .signing-order-list::before { content: ''; position: absolute; left: 11px; top: 10px; bottom: 10px; width: 1px; background: var(--border); }
+    .signing-recipient { position: relative; z-index: 1; transition: transform 0.14s ease, opacity 0.14s ease, border-color 0.14s ease; }
+    .signing-order-list.dragging .signing-recipient:not(.signing-drag-overlay) { position: absolute; left: 0; right: 0; top: var(--routing-top); margin-bottom: 0; transition: top 0.16s ease, transform 0.14s ease, opacity 0.14s ease, border-color 0.14s ease; }
+    .signing-placeholder { position: absolute; left: 0; right: 0; top: var(--routing-top); height: var(--routing-row-height); border: 1.5px dashed var(--accent); border-radius: 6px; background: transparent; pointer-events: none; transition: top 0.16s ease; }
+    .signing-drag-overlay { position: absolute; left: 0; right: 0; z-index: 6; top: var(--routing-top); margin-bottom: 0; cursor: grabbing; pointer-events: none; border-color: var(--accent); box-shadow: 0 10px 28px rgba(0,0,0,0.28); transform: scale(1.015); }
+    .role-hint { margin-top: -2px; margin-bottom: 10px; font-size: 10px; line-height: 1.45; color: var(--text-muted); }
     .page-drop-target { outline: 1px dashed transparent; outline-offset: 8px; }
     .page-drop-target.drag-over { outline-color: var(--accent); }
     .field-box { user-select: none; touch-action: none; }
@@ -97,6 +137,8 @@ export class SdigWorkspaceCompose extends DeesElement {
 
   public disconnectedCallback = async () => {
     this.stopFieldInteraction();
+    this.stopSigningOrderDrag();
+    window.removeEventListener('click', this.closeRecipientContextMenu);
     await super.disconnectedCallback();
   };
 
@@ -115,6 +157,14 @@ export class SdigWorkspaceCompose extends DeesElement {
     return fieldDefinitions.find((definition) => definition.type === type) || fieldDefinitions[0];
   }
 
+  private recipientRoleDefinition(role: TRecipientRole) {
+    return recipientRoleDefinitions.find((definition) => definition.role === role) || recipientRoleDefinitions[0];
+  }
+
+  private signingRecipients(): IRecipient[] {
+    return this.recipients.filter((recipient) => recipient.role === 'signer');
+  }
+
   private clamp(value: number, min: number, max: number): number {
     return Math.max(min, Math.min(max, value));
   }
@@ -146,6 +196,71 @@ export class SdigWorkspaceCompose extends DeesElement {
     this.selectedFieldId = null;
   }
 
+  private updateRecipientRole(recipientId: number, role: TRecipientRole) {
+    const recipient = this.recipients.find((currentRecipient) => currentRecipient.id === recipientId);
+    if (!recipient) return;
+    const signerCount = this.signingRecipients().length;
+    if (recipient.role === 'signer' && role !== 'signer' && signerCount <= 1) return;
+
+    this.moveRecipientToRole(recipientId, role);
+  }
+
+  private moveRecipientToRole(recipientId: number, role: TRecipientRole, targetIndex?: number) {
+    const recipient = this.recipients.find((currentRecipient) => currentRecipient.id === recipientId);
+    if (!recipient) return;
+    const signerCount = this.signingRecipients().length;
+    const nextRole = recipient.role === 'signer' && role !== 'signer' && signerCount <= 1 ? 'signer' : role;
+    const withoutRecipient = this.recipients.filter((currentRecipient) => currentRecipient.id !== recipientId);
+    const nextByRole = new Map<TRecipientRole, IRecipient[]>();
+    for (const roleDefinition of recipientRoleDefinitions) {
+      nextByRole.set(roleDefinition.role, withoutRecipient.filter((currentRecipient) => currentRecipient.role === roleDefinition.role));
+    }
+    const targetMembers = [...(nextByRole.get(nextRole) || [])];
+    const insertIndex = targetIndex === undefined ? targetMembers.length : this.clamp(targetIndex, 0, targetMembers.length);
+    targetMembers.splice(insertIndex, 0, { ...recipient, role: nextRole });
+    nextByRole.set(nextRole, targetMembers);
+    this.recipients = recipientRoleDefinitions.flatMap((roleDefinition) => nextByRole.get(roleDefinition.role) || []).map((currentRecipient, index) => ({ ...currentRecipient, order: index + 1 }));
+
+    const nextSigners = this.recipients.filter((currentRecipient) => currentRecipient.role === 'signer');
+    const fallbackSigner = nextSigners[0];
+
+    if (nextRole !== 'signer' && fallbackSigner) {
+      this.fields = this.fields.map((field) => field.recipient === recipientId ? { ...field, recipient: fallbackSigner.id } : field);
+      if (this.activeRecipient === recipientId) {
+        this.activeRecipient = fallbackSigner.id;
+      }
+    }
+  }
+
+  private openRecipientContextMenu(event: MouseEvent, recipient: IRecipient) {
+    event.preventDefault();
+    event.stopPropagation();
+    this.recipientContextMenu = { recipientId: recipient.id, x: event.clientX, y: event.clientY };
+    window.removeEventListener('click', this.closeRecipientContextMenu);
+    setTimeout(() => window.addEventListener('click', this.closeRecipientContextMenu, { once: true }), 0);
+  }
+
+  private closeRecipientContextMenu = () => {
+    this.recipientContextMenu = null;
+  };
+
+  private recipientContextMenuActions(recipient: IRecipient): ISdigContextMenuAction[] {
+    const signerCount = this.signingRecipients().length;
+    return recipientRoleDefinitions.map((roleDefinition) => ({
+      id: roleDefinition.role,
+      label: roleDefinition.label,
+      selected: recipient.role === roleDefinition.role,
+      disabled: recipient.role === 'signer' && roleDefinition.role !== 'signer' && signerCount <= 1,
+    }));
+  }
+
+  private handleRecipientContextMenuAction(event: CustomEvent<ISdigContextMenuActionEventDetail>, recipient: IRecipient) {
+    const role = event.detail.id as TRecipientRole;
+    if (!recipientRoleDefinitions.some((roleDefinition) => roleDefinition.role === role)) return;
+    this.updateRecipientRole(recipient.id, role);
+    this.closeRecipientContextMenu();
+  }
+
   private handleDocumentClick = (event: MouseEvent) => {
     const target = event.target as HTMLElement | null;
     if (target?.closest('.field-box')) return;
@@ -237,18 +352,81 @@ export class SdigWorkspaceCompose extends DeesElement {
     window.removeEventListener('pointercancel', this.stopFieldInteraction);
   };
 
-  private reorderRecipient(targetId: number) {
-    if (this.draggedRecipientId === null || this.draggedRecipientId === targetId) return;
-    const next = [...this.recipients];
-    const fromIndex = next.findIndex((recipient) => recipient.id === this.draggedRecipientId);
-    const toIndex = next.findIndex((recipient) => recipient.id === targetId);
-    if (fromIndex === -1 || toIndex === -1) return;
-    const [moved] = next.splice(fromIndex, 1);
-    next.splice(toIndex, 0, moved);
-    this.recipients = next.map((recipient, index) => ({ ...recipient, order: index + 1 }));
-    this.draggedRecipientId = null;
+  private visualSigningOrder(): IRecipient[] {
+    if (!this.signingOrderDrag) return this.recipients;
+    const dragged = this.recipients.find((recipient) => recipient.id === this.signingOrderDrag?.recipientId);
+    if (!dragged) return this.recipients;
+    const others = this.recipients.filter((recipient) => recipient.role === this.signingOrderDrag?.targetRole && recipient.id !== dragged.id);
+    const targetIndex = this.clamp(this.signingOrderDrag.targetIndex, 0, others.length);
+    return [...others.slice(0, targetIndex), dragged, ...others.slice(targetIndex)];
   }
 
+  private recipientsForRole(role: TRecipientRole): IRecipient[] {
+    if (!this.signingOrderDrag) return this.recipients.filter((recipient) => recipient.role === role);
+    const dragged = this.recipients.find((recipient) => recipient.id === this.signingOrderDrag?.recipientId);
+    const recipients = this.recipients.filter((recipient) => recipient.role === role && recipient.id !== dragged?.id);
+    if (!dragged || this.signingOrderDrag.targetRole !== role) return recipients;
+    const targetIndex = this.clamp(this.signingOrderDrag.targetIndex, 0, recipients.length);
+    return [...recipients.slice(0, targetIndex), { ...dragged, role }, ...recipients.slice(targetIndex)];
+  }
+
+  private startSigningOrderDrag(event: PointerEvent, recipient: IRecipient) {
+    if (event.button !== 0) return;
+    const target = event.target as HTMLElement | null;
+    if (target?.closest('select, input, button')) return;
+    const item = event.currentTarget as HTMLElement;
+    const list = item.closest('.signing-order-list') as HTMLElement | null;
+    if (!list) return;
+    const section = item.closest('.routing-role-section') as HTMLElement | null;
+    const role = (section?.dataset.role || recipient.role) as TRecipientRole;
+    const itemRect = item.getBoundingClientRect();
+    const listRect = list.getBoundingClientRect();
+    const marginBottom = Number.parseFloat(globalThis.getComputedStyle(item).marginBottom || '0');
+    const startIndex = this.recipients.filter((currentRecipient) => currentRecipient.role === role).findIndex((currentRecipient) => currentRecipient.id === recipient.id);
+    this.signingOrderDrag = {
+      recipientId: recipient.id,
+      pointerY: event.clientY,
+      listTop: listRect.top,
+      grabOffsetY: event.clientY - itemRect.top,
+      itemHeight: itemRect.height,
+      itemStep: itemRect.height + marginBottom,
+      targetRole: role,
+      targetIndex: Math.max(0, startIndex),
+    };
+    event.preventDefault();
+    window.addEventListener('pointermove', this.handleSigningOrderPointerMove, { passive: false });
+    window.addEventListener('pointerup', this.stopSigningOrderDrag);
+    window.addEventListener('pointercancel', this.stopSigningOrderDrag);
+  }
+
+  private handleSigningOrderPointerMove = (event: PointerEvent) => {
+    if (!this.signingOrderDrag) return;
+    event.preventDefault();
+    const drag = this.signingOrderDrag;
+    const target = this.shadowRoot?.elementFromPoint(event.clientX, event.clientY) as HTMLElement | null;
+    const section = target?.closest('.routing-role-section') as HTMLElement | null;
+    const roleCandidate = (section?.dataset.role || drag.targetRole) as TRecipientRole;
+    const draggedRecipient = this.recipients.find((recipient) => recipient.id === drag.recipientId);
+    const targetRole = draggedRecipient?.role === 'signer' && roleCandidate !== 'signer' && this.signingRecipients().length <= 1 ? 'signer' : roleCandidate;
+    const list = this.shadowRoot?.querySelector(`.routing-role-section[data-role="${targetRole}"] .signing-order-list`) as HTMLElement | null;
+    const listRect = list?.getBoundingClientRect();
+    const listTop = listRect?.top ?? drag.listTop;
+    const targetMemberCount = this.recipients.filter((recipient) => recipient.role === targetRole && recipient.id !== drag.recipientId).length;
+    const draggedCenterY = event.clientY - listTop - drag.grabOffsetY + drag.itemStep / 2;
+    const targetIndex = Math.round(this.clamp(draggedCenterY / drag.itemStep, 0, targetMemberCount));
+    this.signingOrderDrag = { ...drag, pointerY: event.clientY, listTop, targetRole, targetIndex };
+  };
+
+  private stopSigningOrderDrag = () => {
+    if (this.signingOrderDrag) {
+      this.moveRecipientToRole(this.signingOrderDrag.recipientId, this.signingOrderDrag.targetRole, this.signingOrderDrag.targetIndex);
+    }
+    this.signingOrderDrag = null;
+    window.removeEventListener('pointermove', this.handleSigningOrderPointerMove);
+    window.removeEventListener('pointerup', this.stopSigningOrderDrag);
+    window.removeEventListener('pointercancel', this.stopSigningOrderDrag);
+  };
+
   private addFieldFromDrop(event: DragEvent) {
     event.preventDefault();
     const page = event.currentTarget as HTMLElement;
@@ -305,7 +483,7 @@ export class SdigWorkspaceCompose extends DeesElement {
         </div>
         <div class="field-editor-grid">
           <label class="field-control full">Label<input .value=${field.label} @input=${(event: Event) => this.updateSelectedField({ label: (event.target as HTMLInputElement).value })} /></label>
-          <label class="field-control full">Assigned signer<select .value=${String(field.recipient)} @change=${(event: Event) => this.updateSelectedField({ recipient: Number((event.target as HTMLSelectElement).value) })}>${this.recipients.map((recipient) => html`<option value=${String(recipient.id)}>${recipient.order}. ${recipient.name}</option>`)}</select></label>
+          <label class="field-control full">Assigned signer<select .value=${String(field.recipient)} @change=${(event: Event) => this.updateSelectedField({ recipient: Number((event.target as HTMLSelectElement).value) })}>${this.signingRecipients().map((recipient) => html`<option value=${String(recipient.id)}>${recipient.order}. ${recipient.name}</option>`)}</select></label>
           <label class="field-control">X<input type="number" min="0" .value=${String(field.x)} @input=${(event: Event) => this.updateSelectedFieldNumber('x', event)} /></label>
           <label class="field-control">Y<input type="number" min="0" .value=${String(field.y)} @input=${(event: Event) => this.updateSelectedFieldNumber('y', event)} /></label>
           <label class="field-control">Width<input type="number" min="16" .value=${String(field.w)} @input=${(event: Event) => this.updateSelectedFieldNumber('w', event)} /></label>
@@ -323,6 +501,58 @@ export class SdigWorkspaceCompose extends DeesElement {
     return html`${resizeHandles.map((handle) => html`<span class="resize-handle ${handle}" @pointerdown=${(event: PointerEvent) => this.startFieldResize(event, field, handle)}></span>`)}`;
   }
 
+  private renderSigningRecipient(recipient: IRecipient, orderNumber: number, options: { overlayTop?: number; rowTop?: number; displayRole?: TRecipientRole } = {}): TemplateResult {
+    const initials = recipient.name.split(' ').map((part) => part[0]).slice(0, 2).join('');
+    const isOverlay = options.overlayTop !== undefined;
+    const top = options.overlayTop ?? options.rowTop;
+    const displayRole = options.displayRole || recipient.role;
+    return html`<div class="recipient-line signing-recipient ${isOverlay ? 'signing-drag-overlay' : ''}" style="${top !== undefined ? `--routing-top: ${top}px;` : ''}" @contextmenu=${(event: MouseEvent) => this.openRecipientContextMenu(event, recipient)} @pointerdown=${!isOverlay ? (event: PointerEvent) => this.startSigningOrderDrag(event, recipient) : undefined}><span class="mono" style="width: 14px; font-size: 10px; color: ${isOverlay ? 'var(--accent)' : 'var(--text-muted)'};">${orderNumber}</span><span class="avatar" style="background: ${recipient.color};">${initials}</span><div style="flex: 1; min-width: 0;"><div style="font-size: 12px; color: var(--text); overflow: hidden; text-overflow: ellipsis; white-space: nowrap;">${recipient.name}</div><div class="mono" style="font-size: 10px; color: var(--text-muted); overflow: hidden; text-overflow: ellipsis; white-space: nowrap;">${this.recipientRoleDefinition(displayRole).description}</div></div><span class="role-chip">${this.recipientRoleDefinition(displayRole).shortLabel}</span></div>`;
+  }
+
+  private renderRoleSection(roleDefinition: typeof recipientRoleDefinitions[number]): TemplateResult {
+    const role = roleDefinition.role;
+    const members = this.recipientsForRole(role);
+    const isTargetRole = this.signingOrderDrag?.targetRole === role;
+    const draggedRecipientId = this.signingOrderDrag?.recipientId;
+    const draggedRecipient = draggedRecipientId !== undefined ? this.recipients.find((recipient) => recipient.id === draggedRecipientId) : undefined;
+
+    if (!this.signingOrderDrag) {
+      return html`<div class="routing-role-section" data-role=${role}><div class="routing-role-head"><span class="routing-role-title">${roleDefinition.label}</span><span class="role-count">${members.length}</span></div><div class="routing-role-description">${roleDefinition.description}</div><div class="signing-order-list">${members.map((recipient, index) => this.renderSigningRecipient(recipient, index + 1))}</div></div>`;
+    }
+
+    const visualIndexById = new Map(members.map((recipient, index) => [recipient.id, index]));
+    const overlayTop = isTargetRole ? this.signingOrderDrag.pointerY - this.signingOrderDrag.listTop - this.signingOrderDrag.grabOffsetY : 0;
+    const draggedOrder = draggedRecipient ? (members.findIndex((recipient) => recipient.id === draggedRecipient.id) + 1 || this.signingOrderDrag.targetIndex + 1) : 0;
+
+    return html`<div class="routing-role-section ${isTargetRole ? 'active-drop' : ''}" data-role=${role}><div class="routing-role-head"><span class="routing-role-title">${roleDefinition.label}</span><span class="role-count">${members.filter((recipient) => recipient.id !== draggedRecipientId).length + (isTargetRole ? 1 : 0)}</span></div><div class="routing-role-description">${roleDefinition.description}</div><div class="signing-order-list dragging" style="--routing-list-height: ${Math.max(1, members.length) * this.signingOrderDrag.itemStep}px;">
+      ${members.filter((recipient) => recipient.id !== draggedRecipientId).map((recipient) => {
+        const visualIndex = visualIndexById.get(recipient.id) ?? 0;
+        return this.renderSigningRecipient(recipient, visualIndex + 1, { rowTop: visualIndex * this.signingOrderDrag!.itemStep, displayRole: role });
+      })}
+      ${isTargetRole ? html`<div class="signing-placeholder" style="--routing-top: ${this.signingOrderDrag.targetIndex * this.signingOrderDrag.itemStep}px; --routing-row-height: ${this.signingOrderDrag.itemHeight}px;"></div>` : ''}
+      ${isTargetRole && draggedRecipient ? this.renderSigningRecipient(draggedRecipient, draggedOrder, { overlayTop, displayRole: role }) : ''}
+    </div></div>`;
+  }
+
+  private renderSigningOrder(): TemplateResult {
+    return html`${recipientRoleDefinitions.map((roleDefinition) => this.renderRoleSection(roleDefinition))}`;
+  }
+
+  private renderRecipientContextMenu(): TemplateResult {
+    if (!this.recipientContextMenu) return html``;
+    const recipient = this.recipients.find((currentRecipient) => currentRecipient.id === this.recipientContextMenu?.recipientId);
+    if (!recipient) return html``;
+    return html`
+      <sdig-contextmenu
+        .anchorX=${this.recipientContextMenu.x}
+        .anchorY=${this.recipientContextMenu.y}
+        .title=${recipient.name}
+        .actions=${this.recipientContextMenuActions(recipient)}
+        @contextmenu-action=${(event: CustomEvent<ISdigContextMenuActionEventDetail>) => this.handleRecipientContextMenuAction(event, recipient)}
+      ></sdig-contextmenu>
+    `;
+  }
+
   private renderStepper(): TemplateResult {
     const labels = ['Upload', 'Place fields', 'Recipients & routing', 'Review & send'];
     return html`
@@ -343,12 +573,13 @@ export class SdigWorkspaceCompose extends DeesElement {
       ${topBar({ breadcrumb: ['signature.digital', 'Inbox', 'Compose'], title: 'Master Services Agreement', subtitle: pill('Draft · auto-saved'), actions: html`${actionButton('Save draft', 'ghost')}${actionButton('Preview', 'outline', 'eye')}${actionButton('Send for signature', 'primary', 'send')}` })}
       ${this.renderStepper()}
       <div class="compose-workspace">
+        ${this.renderRecipientContextMenu()}
         <div class="palette">
           <div class="label-upper">Drag onto document</div>
           ${fieldDefinitions.map((fieldType) => html`<div class="field-tool" style="--tool-w: ${fieldType.w}px; --tool-h: ${fieldType.h}px; --recipient-color: ${this.recipientColor(this.activeRecipient)};" draggable="true" @dragstart=${(event: DragEvent) => this.startFieldToolDrag(event, fieldType)} @dragend=${() => this.endFieldToolDrag()}>${icon(fieldType.icon, 14)}<span style="flex: 1;">${fieldType.label}</span></div>`)}
           <div style="height: 1px; background: var(--border-subtle); margin: 20px 0 16px;"></div>
           <div class="label-upper">Active for</div>
-          ${this.recipients.map((recipient) => html`<div class="recipient-line ${this.activeRecipient === recipient.id ? 'active' : ''}" @click=${() => this.activeRecipient = recipient.id}><span class="swatch" style="--recipient-color: ${recipient.color};"></span><span style="flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;">${recipient.name.split(' ')[0]}</span><span class="mono" style="font-size: 10px; color: var(--text-muted);">${this.fields.filter((field) => field.recipient === recipient.id).length}</span></div>`)}
+          ${this.signingRecipients().map((recipient) => html`<div class="recipient-line ${this.activeRecipient === recipient.id ? 'active' : ''}" @click=${() => this.activeRecipient = recipient.id}><span class="swatch" style="--recipient-color: ${recipient.color};"></span><span style="flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;">${recipient.name.split(' ')[0]}</span><span class="mono" style="font-size: 10px; color: var(--text-muted);">${this.fields.filter((field) => field.recipient === recipient.id).length}</span></div>`)}
         </div>
         <div class="document-stage">
           <div class="document-page page-drop-target" @click=${this.handleDocumentClick} @dragover=${(event: DragEvent) => { event.preventDefault(); if (event.dataTransfer) event.dataTransfer.dropEffect = 'copy'; (event.currentTarget as HTMLElement).classList.add('drag-over'); }} @dragleave=${(event: DragEvent) => (event.currentTarget as HTMLElement).classList.remove('drag-over')} @drop=${(event: DragEvent) => this.addFieldFromDrop(event)}>
@@ -359,8 +590,9 @@ export class SdigWorkspaceCompose extends DeesElement {
           <div style="display: flex; align-items: center; gap: 10px; font-size: 11px; color: var(--text-muted);">${actionButton('Prev', 'outline')}${html`<span class="mono">1 / 14</span>`}${actionButton('Next', 'outline')}</div>
         </div>
         <div class="right-panel">
-          <div class="label-upper">Signing order · drag to reorder</div>
-          ${this.recipients.map((recipient) => html`<div class="recipient-line ${this.draggedRecipientId === recipient.id ? 'dragging' : ''}" draggable="true" @dragstart=${() => this.draggedRecipientId = recipient.id} @dragover=${(event: DragEvent) => event.preventDefault()} @drop=${() => this.reorderRecipient(recipient.id)} @dragend=${() => this.draggedRecipientId = null}><span class="mono" style="width: 14px; font-size: 10px; color: var(--text-muted);">${recipient.order}</span><span class="avatar" style="background: ${recipient.color};">${recipient.name.split(' ').map((part) => part[0]).slice(0, 2).join('')}</span><div style="flex: 1; min-width: 0;"><div style="font-size: 12px; color: var(--text); overflow: hidden; text-overflow: ellipsis; white-space: nowrap;">${recipient.name}</div><div class="mono" style="font-size: 10px; color: var(--text-muted); overflow: hidden; text-overflow: ellipsis; white-space: nowrap;">${recipient.email}</div></div>${icon('more', 12)}</div>`)}
+          <div class="label-upper">Routing order · drag to reorder</div>
+          <div class="role-hint">Choose who signs, who gets the completed copy, and who is notified at every step.</div>
+          ${this.renderSigningOrder()}
           ${selectedField ? this.renderFieldEditor(selectedField) : ''}
         </div>
       </div>

ts_web/elements/sdig-workspace/sdig-workspace.shared.ts

@@ -13,6 +13,7 @@ export type TWorkspaceView =
 
 export type TWorkspaceTheme = 'dark' | 'light';
 export type TDensity = 'compact' | 'comfortable';
+export type TRecipientRole = 'signer' | 'copy' | 'updates';
 
 export interface IDocumentRow {
   id: string;
@@ -31,6 +32,7 @@ export interface IRecipient {
   email: string;
   color: string;
   order: number;
+  role: TRecipientRole;
 }
 
 export interface IFieldPlacement {
@@ -55,9 +57,9 @@ export const demoDocuments: IDocumentRow[] = [
 ];
 
 export const demoRecipients: IRecipient[] = [
-  { id: 0, name: 'Sarah Chen', email: 'sarah@acme.com', color: '#60a5fa', order: 1 },
-  { id: 1, name: 'David Park', email: 'd.park@acme.com', color: '#fbbf24', order: 2 },
-  { id: 2, name: 'Philipp K.', email: 'philipp@lossless.com', color: '#3b82f6', order: 3 },
+  { id: 0, name: 'Sarah Chen', email: 'sarah@acme.com', color: '#60a5fa', order: 1, role: 'signer' },
+  { id: 1, name: 'David Park', email: 'd.park@acme.com', color: '#fbbf24', order: 2, role: 'signer' },
+  { id: 2, name: 'Philipp K.', email: 'philipp@lossless.com', color: '#3b82f6', order: 3, role: 'updates' },
 ];
 
 export const demoFields: IFieldPlacement[] = [

ts_web/elements/sdig-workspace/sdig-workspace.ts

@@ -1,4 +1,4 @@
-import { DeesElement, property, state, html, customElement, type TemplateResult, css } from '@design.estate/dees-element';
+import { DeesElement, property, html, customElement, type TemplateResult, css } from '@design.estate/dees-element';
 import { icon, type TDensity, type TWorkspaceTheme, type TWorkspaceView } from './sdig-workspace.shared.js';
 import './sdig-workspace-inbox.js';
 import './sdig-workspace-compose.js';
@@ -22,11 +22,13 @@ export class SdigWorkspace extends DeesElement {
   @property({ type: String }) public accessor density: TDensity = 'comfortable';
   @property({ type: String, reflect: true }) public accessor theme: TWorkspaceTheme = 'dark';
   @property({ type: String }) public accessor initialView: TWorkspaceView = 'inbox';
-  @state() private accessor view: TWorkspaceView = 'inbox';
+  @property({ type: String, reflect: true }) public accessor view: TWorkspaceView = 'inbox';
 
   public connectedCallback = async () => {
     await super.connectedCallback();
-    this.view = this.initialView || 'inbox';
+    if (this.view === 'inbox' && this.initialView !== 'inbox') {
+      this.view = this.initialView;
+    }
     this.addEventListener('workspace-view-request', this.handleViewRequest as EventListener);
   };