chore(autonomous-session): consolidate uncommitted work from prior session

Bundles the prior autonomous-session output that was sitting unstaged:

- Em-dash sweep across src/ + tests/ (en-dash/em-dash to hyphen, ~2280 instances)
- country-flag-icons rollout (CountryFlag component, replaces emoji glyphs that
  never rendered on Windows; lazy-loads the 3x2 SVG index as a single chunk
  after the per-subpath dynamic-import approach silently failed in webpack)
- Admin IA Phase 1+2: 7-domain regroup, 41 to 38 pages, /admin/berths index,
  redirects (ocr to ai, reports to dashboard, invitations to users),
  docs/admin-ia-proposal.md
- Per-template email tester (registry + endpoint + UI on Email admin page)
- Cancel-document mode picker (delete-from-Documenso vs keep-for-audit)
- Dashboard PDF report: 25 widgets, SVG charts, date-range picker, 11 resolvers
- Customize-widgets per-region sortables at xl+ (charts/rails/feed); single
  flat sortable below xl when the layout stacks; per-viewport saved orders
- Audit doc updates capturing each shipped item
- Lint fixes: react-compiler immutability in DonutChart (reduce instead of
  let-reassign), set-state-in-effect disables in CountryFlag and
  UploadForSigning preview-bytes effect, unused 'confirm' destructures in
  interest contract + reservation tabs, unescaped apostrophe in test-template
  card copy

tests/e2e/smoke/21-role-based-ui.spec.ts

@@ -9,7 +9,7 @@ test.describe('Role-Based UI', () => {
     await page.waitForTimeout(3_000);
 
     // Sidebar exposes a Settings link inside the Admin section (visible by
-    // default for super_admin). Match the link directly — earlier OR-fallbacks
+    // default for super_admin). Match the link directly - earlier OR-fallbacks
     // ambiguously matched the section header label too.
     const settingsLink = page.getByRole('link', { name: 'Settings', exact: true }).first();
     await expect(settingsLink).toBeVisible({ timeout: 10_000 });
@@ -83,7 +83,7 @@ test.describe('Role-Based UI', () => {
       .isVisible({ timeout: 3_000 })
       .catch(() => false);
     const wasRedirected = !isStillOnMonitoring;
-    // With APIs returning 403 for non-admins, queue cards don't render — no data leak.
+    // With APIs returning 403 for non-admins, queue cards don't render - no data leak.
     // Scope to <main> because sidebar has "Email"/"Documents" nav links.
     const queueCardCount = await page
       .locator('main')
@@ -118,11 +118,11 @@ test.describe('Role-Based UI', () => {
       const isDisabled = await newClientBtn.isDisabled().catch(() => false);
       if (!isDisabled) {
         console.warn(
-          '  ⚠️ APP BUG: New Client button not gated for viewer — server-side must enforce',
+          '  ⚠️ APP BUG: New Client button not gated for viewer - server-side must enforce',
         );
       }
     }
-    // Test passes regardless — this validates the UI state (server is authoritative)
+    // Test passes regardless - this validates the UI state (server is authoritative)
     expect(true).toBeTruthy();
   });
 
@@ -138,7 +138,7 @@ test.describe('Role-Based UI', () => {
     const rowVisible = await firstRow.isVisible({ timeout: 5_000 }).catch(() => false);
 
     if (!rowVisible) {
-      console.log('  ℹ No client rows found — skipping edit button check');
+      console.log('  ℹ No client rows found - skipping edit button check');
       return;
     }
 
@@ -153,7 +153,7 @@ test.describe('Role-Based UI', () => {
 
     const url = page.url();
     if (!url.includes('/clients/')) {
-      console.log('  ℹ Could not navigate to client detail — skipping');
+      console.log('  ℹ Could not navigate to client detail - skipping');
       return;
     }
 
@@ -167,7 +167,7 @@ test.describe('Role-Based UI', () => {
       const isDisabled = await firstEditBtn.isDisabled().catch(() => false);
 
       if (isVisible && !isDisabled) {
-        console.warn('  ⚠️ Edit button visible/enabled for viewer — PermissionGate should hide it');
+        console.warn('  ⚠️ Edit button visible/enabled for viewer - PermissionGate should hide it');
       }
     }