@signature.digital/catalog 1.7.0 → 1.9.0

package/readme.md

@@ -28,6 +28,14 @@ Render the product workspace:
 <sdig-workspace accent="#3b82f6" density="comfortable" theme="dark"></sdig-workspace>
 ```
 
+Render the host-controlled application shell:
+
+```html
+<sdig-app-shell workspace-name="Example workspace" active-view="inbox">
+  <your-application-view></your-application-view>
+</sdig-app-shell>
+```
+
 Render a standalone signature box:
 
 ```html
@@ -38,6 +46,7 @@ Render a standalone signature box:
 
 | Component | Tag | Purpose |
 |-----------|-----|---------|
+| `SdigAppShell` | `<sdig-app-shell>` | Host-controlled responsive application chrome with a content slot and navigation intents |
 | `SdigWorkspace` | `<sdig-workspace>` | Product workspace shell with inbox, compose, signing, audit, developer, template, team, and settings views |
 | `SignBox` | `<sdig-signbox>` | Complete signature capture UI with clear, undo, and submit actions |
 | `SignPad` | `<sdig-signpad>` | Canvas-based signature capture primitive backed by `signature_pad` |
@@ -90,6 +99,45 @@ workspace?.addEventListener('view-change', (event) => {
 
 Child views can request navigation by dispatching `workspace-view-request` with `{ view }` in `detail`. The event bubbles and crosses the shadow boundary.
 
+## Controlled Application Shell
+
+`sdig-app-shell` supplies presentation only. The host application owns routes, sessions, authorization, persistence, document state, and the slotted view. Set `navigationItems` as a property and respond to the composed `navigation-request` and `signout-request` events.
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `accent` | `string` | `#007aff` | Application accent color |
+| `activeView` | `string` | `inbox` | ID of the active host view |
+| `workspaceName` | `string` | `Workspace` | Visible workspace label |
+| `deploymentLabel` | `string` | `Host configured` | Visible deployment label |
+| `actorName` | `string` | `Current user` | Current actor label |
+| `actorEmail` | `string` | empty | Current actor email label |
+| `documentCount` | `number` | `0` | Factual document total shown in the status bar |
+| `statusLabel` | `string` | `host controlled` | Host-supplied status text |
+| `productLabel` | `string` | empty | Optional host-supplied product text |
+| `stackLabel` | `string` | `Application services` | Host-supplied service-stack heading |
+| `stackDescription` | `string` | `Configured by host application` | Host-supplied service-stack detail |
+| `navigationItems` | `ISdigShellNavigationItem[]` | Inbox, Compose, Audit Trail | Host-owned navigation model |
+
+```typescript
+const shell = document.querySelector('sdig-app-shell');
+
+if (shell) {
+  shell.navigationItems = [
+    { id: 'inbox', label: 'Inbox', icon: 'inbox', count: 4 },
+    { id: 'compose', label: 'Compose', icon: 'plus' },
+  ];
+}
+
+shell?.addEventListener('navigation-request', (event) => {
+  const { view } = (event as CustomEvent<{ view: string }>).detail;
+  // Route using host application state.
+});
+
+shell?.addEventListener('signout-request', () => {
+  // End the host-owned session.
+});
+```
+
 ## Signature Box
 
 Use `sdig-signbox` when you want the default capture UI with a heading, a signature pad, and built-in action controls:
@@ -102,12 +150,16 @@ Use `sdig-signbox` when you want the default capture UI with a heading, a signat
 const signbox = document.querySelector('sdig-signbox');
 
 signbox?.addEventListener('signature', (event) => {
-  const { signature } = (event as CustomEvent<{ signature: unknown[] }>).detail;
+  const { signature, canvasWidth, canvasHeight } = (event as CustomEvent<{
+    signature: unknown[];
+    canvasWidth: number;
+    canvasHeight: number;
+  }>).detail;
   console.log(signature);
 });
 ```
 
-The `signature` event detail contains the `signature_pad` stroke data returned by `sdig-signpad.toData()`.
+The `signature` event detail contains the `signature_pad` stroke data returned by `sdig-signpad.toData()` plus the actual responsive canvas dimensions used to capture it. Existing consumers that only read `signature` remain compatible.
 
 ## Signature Pad
 

package/ts_web/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@signature.digital/catalog',
-  version: '1.7.0',
-  description: 'A comprehensive catalog of customizable web components designed for building and managing e-signature applications.'
+  version: '1.9.0',
+  description: 'Reusable web components for browser-based signature capture and host-controlled e-signature application surfaces.'
 }

package/ts_web/elements/index.ts

@@ -3,5 +3,8 @@ export * from './sdig-contextmenu/index.js';
 export * from './sdig-signbox/index.js';
 export * from './sdig-signpad/index.js';
 
+// Controlled product application primitives
+export * from './sdig-app-shell/index.js';
+
 // Product workspace component
 export * from './sdig-workspace/index.js';

package/ts_web/elements/sdig-app-shell/index.ts

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

package/ts_web/elements/sdig-app-shell/sdig-app-shell.ts

@@ -0,0 +1,200 @@
+import {
+  DeesElement,
+  property,
+  html,
+  customElement,
+  type TemplateResult,
+  css,
+} from '@design.estate/dees-element';
+
+import { icon } from '../sdig-workspace/sdig-workspace.shared.js';
+
+export interface ISdigShellNavigationItem {
+  id: string;
+  label: string;
+  icon: string;
+  count?: number;
+  disabled?: boolean;
+  title?: string;
+}
+
+export interface ISdigShellNavigationRequestDetail {
+  view: string;
+}
+
+declare global {
+  interface HTMLElementTagNameMap {
+    'sdig-app-shell': SdigAppShell;
+  }
+}
+
+@customElement('sdig-app-shell')
+export class SdigAppShell extends DeesElement {
+  public static demo = () => html`
+    <sdig-app-shell
+      workspace-name="Example workspace"
+      deployment-label="Self-hosted · single instance"
+      actor-name="Workspace owner"
+      actor-email="owner@example.test"
+      active-view="inbox"
+      status-label="self-hosted"
+      product-label="Open Source · MIT"
+      stack-label="foss.global stack"
+      stack-description="Lit · TypedRequest · SmartData · SmartBucket · MongoDB · S3"
+      .documentCount=${4}
+      style="height: 720px"
+    >
+      <div style="height:100%;display:grid;place-items:center;color:var(--text-muted)">Controlled application content</div>
+    </sdig-app-shell>
+  `;
+  public static demoGroups = ['Signature Digital Application'];
+
+  @property({ type: String }) public accessor accent = '#007aff';
+  @property({ type: String, attribute: 'active-view' }) public accessor activeView = 'inbox';
+  @property({ type: String, attribute: 'workspace-name' }) public accessor workspaceName = 'Workspace';
+  @property({ type: String, attribute: 'deployment-label' }) public accessor deploymentLabel = 'Host configured';
+  @property({ type: String, attribute: 'actor-name' }) public accessor actorName = 'Current user';
+  @property({ type: String, attribute: 'actor-email' }) public accessor actorEmail = '';
+  @property({ type: Number, attribute: 'document-count' }) public accessor documentCount = 0;
+  @property({ type: String, attribute: 'status-label' }) public accessor statusLabel = 'host controlled';
+  @property({ type: String, attribute: 'product-label' }) public accessor productLabel = '';
+  @property({ type: String, attribute: 'stack-label' }) public accessor stackLabel = 'Application services';
+  @property({ type: String, attribute: 'stack-description' }) public accessor stackDescription = 'Configured by host application';
+  @property({ attribute: false }) public accessor navigationItems: ISdigShellNavigationItem[] = [
+    { id: 'inbox', label: 'Inbox', icon: 'inbox' },
+    { id: 'compose', label: 'Compose', icon: 'plus' },
+    { id: 'audit', label: 'Audit Trail', icon: 'shield' },
+  ];
+
+  public static styles = css`
+    :host {
+      --accent: #007aff;
+      --bg: hsl(0 0% 100%);
+      --bg-el: hsl(240 9% 96.5%);
+      --bg-card: hsl(0 0% 100%);
+      --sidebar: hsl(240 11% 96%);
+      --border: hsl(240 6% 89%);
+      --border-subtle: hsl(240 6% 92.5%);
+      --text: hsl(240 6% 11%);
+      --text-sec: hsl(240 4% 34%);
+      --text-muted: hsl(240 3% 52%);
+      --text-dim: hsl(240 3% 66%);
+      --success: #34c759;
+      --hover: rgba(0, 0, 0, 0.05);
+      --ui: -apple-system, BlinkMacSystemFont, "SF Pro Text", "Helvetica Neue", Arial, sans-serif;
+      --display: -apple-system, BlinkMacSystemFont, "SF Pro Display", "Helvetica Neue", Arial, sans-serif;
+      --mono: ui-monospace, "SF Mono", Menlo, "Cascadia Mono", monospace;
+      display: block;
+      container-type: inline-size;
+      width: 100%;
+      min-height: 100vh;
+      color: var(--text);
+      background: var(--bg);
+      font-family: var(--ui);
+      -webkit-font-smoothing: antialiased;
+    }
+
+    * { box-sizing: border-box; }
+    button { font: inherit; cursor: pointer; }
+    button:disabled { cursor: not-allowed; opacity: .42; }
+    .shell { min-height: inherit; height: 100%; display: grid; grid-template-columns: 224px minmax(0, 1fr); background: var(--bg); }
+    .sidebar { height: 100%; min-height: inherit; display: flex; flex-direction: column; border-right: 1px solid var(--border-subtle); background: color-mix(in srgb, var(--sidebar) 94%, transparent); backdrop-filter: saturate(180%) blur(20px); }
+    .traffic { display: flex; gap: 8px; padding: 13px 16px 0; }
+    .traffic span { width: 12px; height: 12px; border-radius: 50%; box-shadow: inset 0 0 0 .5px rgba(0,0,0,.12); }
+    .traffic span:nth-child(1) { background: #ff5f57; }
+    .traffic span:nth-child(2) { background: #febc2e; }
+    .traffic span:nth-child(3) { background: #28c840; }
+    .brand { display: flex; align-items: center; gap: 8px; padding: 12px 16px; }
+    .mark { width: 26px; height: 26px; display: grid; place-items: center; position: relative; border: .5px solid rgba(0,0,0,.15); border-radius: 7px; color: white; background: linear-gradient(160deg, var(--accent), color-mix(in srgb, var(--accent) 70%, black)); box-shadow: 0 1px 2px rgba(0,0,0,.18), inset 0 1px 0 rgba(255,255,255,.25); font-family: var(--display); font-size: 13px; font-weight: 700; }
+    .mark::after { content: ''; width: 4px; height: 4px; position: absolute; right: 5px; bottom: 5px; border-radius: 50%; background: rgba(255,255,255,.95); }
+    .wordmark { font-size: 13px; font-weight: 500; letter-spacing: -.02em; white-space: nowrap; }
+    .wordmark .dot { color: var(--text-muted); }
+    .wordmark::after { content: ''; width: 4px; height: 4px; display: inline-block; margin-left: 3px; border-radius: 50%; background: var(--accent); transform: translateY(-1px); }
+    .workspace { display: flex; align-items: center; gap: 8px; margin: 0 12px 8px; padding: 7px 10px; border: 1px solid var(--border); border-radius: 9px; background: var(--bg-card); box-shadow: 0 1px 1.5px rgba(0,0,0,.05); }
+    .workspace-badge { width: 20px; height: 20px; display: grid; place-items: center; flex: none; border-radius: 5px; color: white; background: linear-gradient(135deg, var(--accent), #af52de); font-size: 10px; font-weight: 700; }
+    .workspace strong { display: block; overflow: hidden; font-size: 12px; font-weight: 500; line-height: 1.2; text-overflow: ellipsis; white-space: nowrap; }
+    .workspace small { display: block; margin-top: 1px; color: var(--text-muted); font-size: 10px; }
+    nav { display: grid; gap: 2px; padding: 4px 0; }
+    .nav-item { width: calc(100% - 18px); min-height: 30px; display: flex; align-items: center; gap: 9px; margin: 1px 9px; padding: 6px 9px; border: 0; border-radius: 7px; color: var(--text-sec); background: transparent; text-align: left; font-size: 13px; font-weight: 450; letter-spacing: -.01em; transition: color .1s ease, background .1s ease, box-shadow .1s ease; }
+    .nav-item:hover:not(:disabled) { color: var(--text); background: var(--hover); }
+    .nav-item.active { color: white; background: var(--accent); box-shadow: 0 1px 2px color-mix(in srgb, var(--accent) 42%, transparent); font-weight: 510; }
+    .count { min-width: 18px; margin-left: auto; padding: 1px 7px; border-radius: 999px; color: var(--text-muted); background: var(--bg-el); font: 10px var(--mono); text-align: center; }
+    .nav-item.active .count { color: white; background: rgba(255,255,255,.22); }
+    .stack { margin: auto 12px 8px; padding: 11px; border: 1px solid var(--border); border-radius: 10px; background: var(--bg-card); box-shadow: 0 1px 2px rgba(0,0,0,.04); }
+    .stack strong { display: block; color: var(--text-sec); font: 11px var(--mono); }
+    .stack p { margin: 7px 0 0; color: var(--text-muted); font-size: 10px; line-height: 1.45; }
+    .actor { display: flex; align-items: center; gap: 9px; padding: 8px 12px; border-top: 1px solid var(--border-subtle); }
+    .avatar { width: 26px; height: 26px; display: grid; place-items: center; flex: none; border-radius: 50%; color: white; background: var(--accent); font-size: 10px; font-weight: 700; }
+    .actor-name, .actor-email { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+    .actor-name { font-size: 12px; font-weight: 500; }
+    .actor-email { color: var(--text-muted); font: 10px var(--mono); }
+    .signout { width: 28px; height: 28px; display: grid; place-items: center; border: 0; border-radius: 6px; color: var(--text-muted); background: transparent; }
+    .signout:hover { color: #d70015; background: var(--hover); }
+    .mobile-signout { display: none; margin-left: auto; }
+    .main { min-width: 0; min-height: 0; display: flex; flex-direction: column; }
+    .content { flex: 1; min-height: 0; overflow: auto; }
+    ::slotted(*) { min-height: 100%; }
+    .status { height: 24px; display: flex; align-items: center; gap: 16px; flex: none; padding: 0 16px; border-top: 1px solid var(--border-subtle); color: var(--text-dim); background: var(--bg); font: 10px var(--mono); }
+    .status-dot { width: 6px; height: 6px; border-radius: 50%; background: var(--success); }
+    :focus-visible { outline: 3px solid color-mix(in srgb, var(--accent) 25%, transparent); outline-offset: 2px; }
+
+    @container (max-width: 760px) {
+      .shell { grid-template-columns: 1fr; }
+      .sidebar { height: auto; min-height: 0; border-right: 0; border-bottom: 1px solid var(--border-subtle); }
+      .traffic, .workspace, .stack, .actor { display: none; }
+      .brand { padding: 10px 14px 4px; }
+      .mobile-signout { display: grid; }
+      nav { display: flex; overflow-x: auto; padding: 4px 8px 8px; }
+      .nav-item { width: auto; flex: none; margin: 0 2px; }
+      .status { display: none; }
+    }
+
+    @media (prefers-reduced-motion: reduce) {
+      *, *::before, *::after { transition-duration: .001ms !important; animation-duration: .001ms !important; animation-iteration-count: 1 !important; }
+    }
+  `;
+
+  private initials(valueArg: string, fallbackArg = ''): string {
+    const source = valueArg.trim() || fallbackArg.trim();
+    if (!source) return '?';
+    return source.split(/\s+|@/).filter(Boolean).slice(0, 2).map((part) => part[0]?.toUpperCase() || '').join('');
+  }
+
+  private requestNavigation(itemArg: ISdigShellNavigationItem) {
+    if (itemArg.disabled) return;
+    this.dispatchEvent(new CustomEvent<ISdigShellNavigationRequestDetail>('navigation-request', {
+      detail: { view: itemArg.id },
+      bubbles: true,
+      composed: true,
+    }));
+  }
+
+  private requestSignout() {
+    this.dispatchEvent(new CustomEvent('signout-request', { bubbles: true, composed: true }));
+  }
+
+  public render(): TemplateResult {
+    return html`
+      <div class="shell" style=${`--accent:${this.accent}`}>
+        <aside class="sidebar">
+          <div class="traffic" aria-hidden="true"><span></span><span></span><span></span></div>
+          <div class="brand"><span class="mark">s</span><span class="wordmark">signature<span class="dot">.</span>digital</span><button class="signout mobile-signout" title="Sign out" aria-label="Sign out" @click=${this.requestSignout}>↪</button></div>
+          <div class="workspace"><span class="workspace-badge">${this.initials(this.workspaceName)}</span><div style="min-width:0;flex:1"><strong>${this.workspaceName}</strong><small>${this.deploymentLabel}</small></div></div>
+          <nav aria-label="Workspace navigation">
+            ${this.navigationItems.map((item) => html`
+              <button class="nav-item ${this.activeView === item.id ? 'active' : ''}" ?disabled=${item.disabled} title=${item.title || ''} @click=${() => this.requestNavigation(item)}>
+                ${icon(item.icon, 16)}<span>${item.label}</span>${item.count === undefined ? '' : html`<span class="count">${item.count}</span>`}
+              </button>
+            `)}
+          </nav>
+          <div class="stack"><strong>${this.stackLabel}</strong><p>${this.stackDescription}</p></div>
+          <div class="actor"><span class="avatar">${this.initials(this.actorName, this.actorEmail)}</span><div style="min-width:0;flex:1"><div class="actor-name">${this.actorName}</div><div class="actor-email">${this.actorEmail}</div></div><button class="signout" title="Sign out" aria-label="Sign out" @click=${this.requestSignout}>↪</button></div>
+        </aside>
+        <main class="main">
+          <div class="content"><slot></slot></div>
+          <div class="status"><span class="status-dot"></span><span>${this.statusLabel}</span><span>${this.documentCount} documents</span><div style="flex:1"></div>${this.productLabel ? html`<span style="color:var(--accent)">${this.productLabel}</span>` : ''}</div>
+        </main>
+      </div>
+    `;
+  }
+}

package/ts_web/elements/sdig-signbox/sdig-signbox.ts

@@ -1,4 +1,5 @@
 import { DeesElement, html, customElement, type TemplateResult, css, cssManager } from '@design.estate/dees-element';
+import '../sdig-signpad/index.js';
 
 declare global {
   interface HTMLElementTagNameMap {
@@ -22,6 +23,7 @@ export class SignBox extends DeesElement {
     css`
       .mainbox {
         position: relative;
+        width: 100%;
         background: ${cssManager.bdTheme('#eeeeeb', '#111111')};
         border-radius: 16px;
         max-width: 600px;
@@ -54,6 +56,7 @@ export class SignBox extends DeesElement {
         box-shadow: ${cssManager.bdTheme('0px 0px 8px 0px #00000040', 'none')};
         z-index: 2;
         display: flex;
+        flex-wrap: wrap;
         justify-content: flex-end;
       }
 
@@ -68,6 +71,13 @@ export class SignBox extends DeesElement {
       .button:hover {
         color: ${cssManager.bdTheme('#111111', '#eeeeeb')};
       }
+
+      button.button {
+        appearance: none;
+        border: 0;
+        background: transparent;
+        font: inherit;
+      }
     `
   ];
 
@@ -79,29 +89,37 @@ export class SignBox extends DeesElement {
         </div>
         <sdig-signpad></sdig-signpad>
         <div class="actions">
-          <div class="button" @click=${async () => {
+          <button class="button" data-action="clear" @click=${async () => {
             await this.shadowRoot?.querySelector('sdig-signpad')?.clear();
           }}>
             Clear
-          </div>
-          <div class="button" @click=${async () => {
+          </button>
+          <button class="button" data-action="undo" @click=${async () => {
             await this.shadowRoot?.querySelector('sdig-signpad')?.undo();
           }}>
             Undo
-          </div>
-          <div class="button" @click=${async () => {
+          </button>
+          <button class="button" data-action="submit" @click=${async () => {
             const signaturePad = this.shadowRoot?.querySelector('sdig-signpad');
             if (!signaturePad) return;
+            if (await signaturePad.isEmpty()) return;
             const signature = await signaturePad.toData();
+            const svg = await signaturePad.toSVG();
+            const canvasSize = signaturePad.getCanvasSize();
             this.dispatchEvent(new CustomEvent('signature', {
               detail: {
                 signature,
-              }
+                svg,
+                createdAt: Date.now(),
+                canvasWidth: canvasSize.width,
+                canvasHeight: canvasSize.height,
+              },
+              bubbles: true,
+              composed: true,
             }));
-            console.log(signature);
           }}>
             Submit Signature
-          </div>
+          </button>
         </div>
       </div>
     `;

package/ts_web/elements/sdig-signpad/sdig-signpad.ts

@@ -24,6 +24,7 @@ export class SignPad extends DeesElement {
     css`
       :host {
         display: block;
+        width: 100%;
         color: white;
         position: relative;
         max-width: 600px;
@@ -33,7 +34,8 @@ export class SignPad extends DeesElement {
 
       .mainbox {
         position: relative;
-        width: 600px;
+        width: 100%;
+        max-width: 600px;
         height: 280px;
       }
 
@@ -47,6 +49,8 @@ export class SignPad extends DeesElement {
       }
 
       canvas {
+        display: block;
+        max-width: 100%;
         filter: ${cssManager.bdTheme('invert(0)', 'invert(1)')};
       }
     `
@@ -61,20 +65,26 @@ export class SignPad extends DeesElement {
   }
 
   public signaturePad?: typeof plugins.signaturePad.prototype;
+  private canvas?: HTMLCanvasElement;
 
   public async firstUpdated() {
     await this.domtoolsPromise;
     const mainbox = this.shadowRoot?.querySelector('.mainbox');
     if (!mainbox) return;
-    const canvas = document.createElement('canvas');
-    mainbox.appendChild(canvas);
+    this.canvas = document.createElement('canvas');
+    mainbox.appendChild(this.canvas);
     await this.resizeCanvas();
-    this.signaturePad = new plugins.signaturePad(canvas, {
+    this.signaturePad = new plugins.signaturePad(this.canvas, {
       
     });
     this.signaturePad.on();
   }
 
+  public async disconnectedCallback() {
+    this.signaturePad?.off();
+    await super.disconnectedCallback();
+  }
+
   public async resizeCanvas() {
     const mainbox = this.shadowRoot?.querySelector('.mainbox');
     const canvas = this.shadowRoot?.querySelector('canvas');
@@ -92,12 +102,23 @@ export class SignPad extends DeesElement {
     this.signaturePad?.clear();
   }
 
-  public async toData() {
+  public async isEmpty(): Promise<boolean> {
+    return this.signaturePad?.isEmpty() ?? true;
+  }
+
+  public async toData(): Promise<plugins.TSignaturePadPointGroup[]> {
     const returnData =  this.signaturePad?.toData() || [];
     return returnData;
   }
 
-  public async fromData(dataArrayArg: any[]) {
+  public getCanvasSize(): { width: number; height: number } {
+    return {
+      width: this.canvas?.width || 0,
+      height: this.canvas?.height || 0,
+    };
+  }
+
+  public async fromData(dataArrayArg: plugins.TSignaturePadPointGroup[]) {
     this.signaturePad?.fromData(dataArrayArg);
   }
 

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

@@ -24,16 +24,16 @@ export class SdigWorkspaceAudit extends DeesElement {
     const document = this.document || demoDocuments[1];
     const events = [
       ['2026-05-02 14:32:18 UTC', 'Sarah Chen', 'Document signed', '81.221.4.18 · Brussels, BE', '0x4a7b…f29c', 'success'],
-      ['2026-05-02 14:31:54 UTC', 'Sarah Chen', 'Signature adopted (typed)', '81.221.4.18 · Brussels, BE', '0x4a7b…f29c', 'info'],
+      ['2026-05-02 14:31:54 UTC', 'Sarah Chen', 'Signature strokes captured', 'recipient session', '0x4a7b…f29c', 'info'],
       ['2026-05-02 14:28:02 UTC', 'Sarah Chen', 'Document opened', '81.221.4.18 · Brussels, BE', '', 'default'],
       ['2026-05-02 11:02:11 UTC', 'Philipp K.', 'Document sent for signature', '92.42.114.7 · Berlin, DE', '0x1c8a…3b6f', 'info'],
       ['2026-05-02 10:54:22 UTC', 'Philipp K.', 'Document created', '92.42.114.7 · Berlin, DE', '0x1c8a…3b6f', 'default'],
     ];
     return html`
-      ${topBar({ breadcrumb: ['signature.digital', 'Inbox', document.id, 'Audit Trail'], title: `Audit Trail · ${document.title}`, subtitle: pill(`${document.status} · cryptographically sealed`, document.status === 'declined' ? 'error' : document.status === 'signed' ? 'success' : 'info', true), actions: html`${actionButton('Certificate (PDF)', 'outline', 'download')}${actionButton('Verify on chain', 'outline', 'hash')}` })}
+      ${topBar({ breadcrumb: ['signature.digital', 'Inbox', document.id, 'Audit Trail'], title: `Audit Trail · ${document.title}`, subtitle: pill(`${document.status} · demo application hash chain`, document.status === 'declined' ? 'error' : document.status === 'signed' ? 'success' : 'info', true), actions: html`${actionButton('Evidence export', 'outline', 'download')}` })}
       <div class="content-scroll audit-grid">
-        <div class="card"><div style="height: 36px; padding: 0 16px; border-bottom: 1px solid var(--border-subtle); display: flex; align-items: center; justify-content: space-between;"><span style="font-size: 12px; font-weight: 600;">Event log</span><span class="mono" style="font-size: 10px; color: var(--text-muted);">${events.length} events · immutable</span></div>${events.map((event) => html`<div class="event-row"><div><span style="display: block; width: 8px; height: 8px; border-radius: 50%; background: ${event[5] === 'success' ? 'var(--success)' : event[5] === 'info' ? 'var(--accent)' : 'var(--text-dim)'};"></span></div><div class="mono hide-mobile" style="font-size: 11px; color: var(--text-muted);">${event[0]}</div><div><div style="font-size: 12px; font-weight: 500;">${event[2]}</div><div style="font-size: 10px; color: var(--text-muted); margin-top: 2px;">by ${event[1]} ${event[4] ? html`<span class="mono" style="color: var(--accent); margin-left: 8px;">${event[4]}</span>` : ''}</div></div><div class="mono hide-mobile" style="font-size: 10px; color: var(--text-muted); text-align: right;">${event[3]}</div></div>`)}</div>
-        <div style="display: flex; flex-direction: column; gap: 16px;"><div class="card" style="padding: 16px;"><div class="label-upper">Document hash</div><div class="mono" style="font-size: 11px; color: var(--accent); word-break: break-all; line-height: 1.5; padding: 10px; background: var(--bg-el); border-radius: 4px; border: 1px solid var(--border-subtle);">0x4a7b8f29c91e3d2a5b6c8e0f1d3c5a7b9d2e4f6a8c1e3d5f7b9c1e3a5b7d9f0e</div></div><div class="card" style="padding: 16px;"><div class="label-upper">Signers</div>${demoRecipients.map((recipient) => html`<div class="recipient-line"><span class="avatar" style="background: ${recipient.color};">${recipient.name.split(' ').map((part) => part[0]).slice(0, 2).join('')}</span><div style="flex: 1;"><div style="font-size: 12px;">${recipient.name}</div><div class="mono" style="font-size: 10px; color: var(--text-muted);">${recipient.email}</div></div>${icon('check', 12)}</div>`)}</div><div class="card" style="padding: 16px; border-color: rgba(34,197,94,0.2);"><div style="display: inline-flex; align-items: center; gap: 6px; font-size: 11px; color: var(--success); margin-bottom: 6px;">${icon('shield', 13)} eIDAS Qualified · ESIGN Act compliant</div><div style="font-size: 11px; color: var(--text-muted); line-height: 1.55;">Open-source verifier available. Anyone can independently validate this signature against the public ledger.</div></div></div>
+        <div class="card"><div style="height: 36px; padding: 0 16px; border-bottom: 1px solid var(--border-subtle); display: flex; align-items: center; justify-content: space-between;"><span style="font-size: 12px; font-weight: 600;">Demo event log</span><span class="mono" style="font-size: 10px; color: var(--text-muted);">${events.length} local demo events</span></div>${events.map((event) => html`<div class="event-row"><div><span style="display: block; width: 8px; height: 8px; border-radius: 50%; background: ${event[5] === 'success' ? 'var(--success)' : event[5] === 'info' ? 'var(--accent)' : 'var(--text-dim)'};"></span></div><div class="mono hide-mobile" style="font-size: 11px; color: var(--text-muted);">${event[0]}</div><div><div style="font-size: 12px; font-weight: 500;">${event[2]}</div><div style="font-size: 10px; color: var(--text-muted); margin-top: 2px;">by ${event[1]} ${event[4] ? html`<span class="mono" style="color: var(--accent); margin-left: 8px;">${event[4]}</span>` : ''}</div></div><div class="mono hide-mobile" style="font-size: 10px; color: var(--text-muted); text-align: right;">${event[3]}</div></div>`)}</div>
+        <div style="display: flex; flex-direction: column; gap: 16px;"><div class="card" style="padding: 16px;"><div class="label-upper">Demo document hash</div><div class="mono" style="font-size: 11px; color: var(--accent); word-break: break-all; line-height: 1.5; padding: 10px; background: var(--bg-el); border-radius: 8px; border: 1px solid var(--border-subtle);">4a7b8f29c91e3d2a5b6c8e0f1d3c5a7b9d2e4f6a8c1e3d5f7b9c1e3a5b7d9f0e</div></div><div class="card" style="padding: 16px;"><div class="label-upper">Demo recipients</div>${demoRecipients.map((recipient) => html`<div class="recipient-line"><span class="avatar" style="background: ${recipient.color};">${recipient.name.split(' ').map((part) => part[0]).slice(0, 2).join('')}</span><div style="flex: 1;"><div style="font-size: 12px;">${recipient.name}</div><div class="mono" style="font-size: 10px; color: var(--text-muted);">${recipient.email}</div></div>${recipient.role === 'signer' ? icon('check', 12) : ''}</div>`)}</div><div class="card" style="padding: 16px; border-color: rgba(0,122,255,0.2);"><div style="display: inline-flex; align-items: center; gap: 6px; font-size: 11px; color: var(--accent); margin-bottom: 6px;">${icon('shield', 13)} Application evidence preview</div><div style="font-size: 11px; color: var(--text-muted); line-height: 1.55;">The host application supplies recorded events and SHA-256 values. This demo component does not assert identity, trusted timestamps, blockchain anchoring, or legal signature level.</div></div></div>
       </div>
     `;
   }

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

@@ -60,7 +60,7 @@ const resizeHandles: TResizeHandle[] = ['n', 'ne', 'e', 'se', 's', 'sw', 'w', 'n
 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.' },
+  { role: 'updates', label: 'Host-defined update', shortLabel: 'Updates', description: 'Emits an update-role intent for the host application.' },
 ];
 
 @customElement('sdig-workspace-compose')
@@ -170,6 +170,16 @@ export class SdigWorkspaceCompose extends DeesElement {
     return Math.max(min, Math.min(max, value));
   }
 
+  private parseDragOffset(rawOffset: string | undefined, fallback: { x: number; y: number }): { x: number; y: number } {
+    if (!rawOffset) return fallback;
+    try {
+      const parsed = JSON.parse(rawOffset) as Partial<{ x: number; y: number }>;
+      return Number.isFinite(parsed.x) && Number.isFinite(parsed.y) ? { x: parsed.x!, y: parsed.y! } : fallback;
+    } catch {
+      return fallback;
+    }
+  }
+
   private emitFieldsChange() {
     this.dispatchEvent(new CustomEvent('fields-change', {
       detail: { fields: this.fields },
@@ -473,12 +483,13 @@ export class SdigWorkspaceCompose extends DeesElement {
     if (!this.draggedFieldDefinition && !transferredType) return;
     const definition = this.draggedFieldDefinition || this.fieldDefinition(transferredType);
     const transferredOffset = event.dataTransfer?.getData('application/x-signature-field-offset');
-    const offset = this.draggedFieldGrabOffset || (transferredOffset ? JSON.parse(transferredOffset) as { x: number; y: number } : { x: definition.w / 2, y: definition.h / 2 });
+    const fallbackOffset = { x: definition.w / 2, y: definition.h / 2 };
+    const offset = this.draggedFieldGrabOffset || this.parseDragOffset(transferredOffset, fallbackOffset);
     const rect = page.getBoundingClientRect();
     const x = Math.round(event.clientX - rect.left - offset.x);
     const y = Math.round(event.clientY - rect.top - offset.y);
     const nextField: IFieldPlacement = {
-      id: `field_${Date.now()}`,
+      id: globalThis.crypto?.randomUUID?.() || `field_${Date.now()}_${Math.random().toString(36).slice(2)}`,
       type: definition.type,
       x: Math.max(0, Math.min(Math.max(0, rect.width - definition.w), x)),
       y: Math.max(0, Math.min(Math.max(0, rect.height - definition.h), y)),
@@ -615,7 +626,7 @@ export class SdigWorkspaceCompose extends DeesElement {
     const selectedField = this.fields.find((field) => field.id === this.selectedFieldId);
 
     return html`
-      ${topBar({ breadcrumb: ['signature.digital', 'Inbox', 'Compose'], title: document.title, subtitle: pill('Draft · auto-saved'), actions: html`${actionButton('Save draft', 'ghost')}${actionButton('Preview', 'outline', 'eye')}${actionButton('Send for signature', 'primary', 'send')}` })}
+      ${topBar({ breadcrumb: ['signature.digital', 'Inbox', 'Compose'], title: document.title, subtitle: pill('Draft · host controlled'), actions: html`${actionButton('Save draft', 'ghost')}${actionButton('Preview', 'outline', 'eye')}${actionButton('Send for signature', 'primary', 'send')}` })}
       ${this.renderStepper()}
       <div class="compose-workspace">
         ${this.renderRecipientContextMenu()}
@@ -636,7 +647,7 @@ export class SdigWorkspaceCompose extends DeesElement {
         </div>
         <div class="right-panel">
           <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>
+          <div class="role-hint">Choose visual routing roles. Delivery and notifications remain the host application's responsibility.</div>
           ${this.renderSigningOrder()}
           ${selectedField ? this.renderFieldEditor(selectedField) : ''}
         </div>

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

@@ -1,5 +1,5 @@
 import { DeesElement, html, customElement, type TemplateResult, css } from '@design.estate/dees-element';
-import { actionButton, icon, pill, topBar, workspaceBaseStyles, workspaceDemoFrame } from './sdig-workspace.shared.js';
+import { icon, pill, topBar, workspaceBaseStyles, workspaceDemoFrame } from './sdig-workspace.shared.js';
 
 declare global {
   interface HTMLElementTagNameMap {
@@ -23,23 +23,21 @@ export class SdigWorkspaceDevelopers extends DeesElement {
 
   public render(): TemplateResult {
     return html`
-      ${topBar({ breadcrumb: ['signature.digital', 'Developers'], title: 'Developers', subtitle: pill('API · v0.42', 'info', true), actions: html`${actionButton('View on GitHub', 'outline', 'github')}${actionButton('New API key', 'primary', 'plus')}` })}
+      ${topBar({ breadcrumb: ['signature.digital', 'Developers'], title: 'Developers', subtitle: pill('foss.global · typed end to end', 'info', true) })}
       <div class="content-scroll developer-grid">
         <div style="display: flex; flex-direction: column; gap: 16px;">
-          <div class="card" style="padding: 20px;"><div style="display: flex; align-items: center; justify-content: space-between; margin-bottom: 14px;"><span style="font-size: 14px; font-weight: 600;">Send a document in 8 lines</span><span class="pill">node</span></div><pre class="code mono">import { Signature } from '@signature.digital/sdk';
-
-const sig = new Signature(process.env.SIGD_KEY);
-
-await sig.documents.send({
-  file: './msa.pdf',
-  recipients: [{ name: 'Sarah Chen', email: 'sarah@acme.com' }],
-  fields: 'auto',
-});</pre></div>
-          <div class="stats-grid">${[['Requests this month', '14,892', '+8.2%'], ['P95 latency', '142ms', '-12ms'], ['Error rate', '0.04%', '✓']].map((metric) => html`<div class="card metric-card"><div class="metric-value">${metric[1]}</div><div style="font-size: 10px; color: var(--text-muted); margin-top: 2px;">${metric[0]}</div><div class="mono" style="font-size: 10px; color: var(--success); margin-top: 6px;">${metric[2]}</div></div>`)}</div>
+          <div class="card" style="padding: 20px;"><div style="display: flex; align-items: center; justify-content: space-between; margin-bottom: 14px;"><span style="font-size: 14px; font-weight: 600;">Production application boundary</span><span class="pill">TypeScript</span></div><pre class="code mono">const stack = {
+  ui: 'Lit + design.estate',
+  api: 'TypedRequest + TypedServer',
+  state: 'SmartData + MongoDB',
+  blobs: 'SmartBucket + S3',
+  pdf: 'pdf-lib + PDF.js',
+} as const;</pre></div>
+          <div class="stats-grid">${[['Typed boundary', 'TypedRequest', 'request/response'], ['Persistence', 'SmartData', 'MongoDB'], ['Artifacts', 'SmartBucket', 'S3-compatible']].map((metric) => html`<div class="card metric-card"><div class="metric-value" style="font-size:15px">${metric[1]}</div><div style="font-size: 10px; color: var(--text-muted); margin-top: 2px;">${metric[0]}</div><div class="mono" style="font-size: 10px; color: var(--accent); margin-top: 6px;">${metric[2]}</div></div>`)}</div>
         </div>
         <div style="display: flex; flex-direction: column; gap: 16px;">
-          <div class="card" style="padding: 16px;"><div style="display: flex; align-items: center; gap: 8px; margin-bottom: 10px;">${icon('github', 14)}<span style="font-size: 12px; font-weight: 600;">signature-digital/core</span></div><div style="font-size: 11px; color: var(--text-muted); line-height: 1.5;">MIT-licensed. Self-host on your own infra, or use signature.digital cloud.</div></div>
-          <div class="card" style="padding: 16px;"><div class="label-upper">Self-host status</div>${[['Docker image', 'ghcr.io/signature-digital'], ['Helm chart', 'v0.42.1'], ['Postgres ≥ 14', 'required'], ['S3-compatible', 'optional']].map((row) => html`<div style="display: flex; justify-content: space-between; font-size: 11px; margin-bottom: 6px;"><span style="color: var(--text-muted);">${row[0]}</span><span class="mono" style="color: var(--text-sec);">${row[1]}</span></div>`)}</div>
+          <div class="card" style="padding: 16px;"><div style="display: flex; align-items: center; gap: 8px; margin-bottom: 10px;">${icon('code', 14)}<span style="font-size: 12px; font-weight: 600;">Controlled component contract</span></div><div style="font-size: 11px; color: var(--text-muted); line-height: 1.5;">Hosts inject workspace data and own authentication, routing, persistence, and delivery. Catalog components emit bubbling, composed intent events.</div></div>
+          <div class="card" style="padding: 16px;"><div class="label-upper">Self-hosted application</div>${[['Runtime', 'Node + TypeScript'], ['State', 'MongoDB'], ['Artifacts', 'S3-compatible'], ['License', 'MIT core']].map((row) => html`<div style="display: flex; justify-content: space-between; font-size: 11px; margin-bottom: 6px;"><span style="color: var(--text-muted);">${row[0]}</span><span class="mono" style="color: var(--text-sec);">${row[1]}</span></div>`)}</div>
         </div>
       </div>
     `;