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/helpers/click-everything.ts

@@ -51,7 +51,7 @@ const DEFAULT_SKIP = [
  * record any console errors, network 4xx/5xx responses, or click failures.
  *
  * Why: a fast smoke check that no UI element 500s, throws, or routes to a
- * stale endpoint after a refactor — without writing per-button assertions.
+ * stale endpoint after a refactor - without writing per-button assertions.
  *
  * The helper is intentionally tolerant: a single click that fails only adds
  * to `errors` rather than throwing, so the caller can attribute failures to
@@ -94,7 +94,7 @@ export async function clickEverythingOnPage(
       try {
         outerHtml = (await el.evaluate((n) => (n as HTMLElement).outerHTML)).slice(0, 200);
       } catch {
-        // Element detached between locator and evaluate — skip silently.
+        // Element detached between locator and evaluate - skip silently.
         continue;
       }
 

tests/helpers/factories.ts

@@ -3,11 +3,11 @@
  *
  * Two flavours:
  *  1. Async DB-inserting factories (makePort, makeClient, makeBerth, makeYacht,
- *     makeCompany, ...) — insert a row via the app's `db` handle and return the
+ *     makeCompany, ...) - insert a row via the app's `db` handle and return the
  *     inserted record. Use these from integration tests that need real FK /
  *     unique-index enforcement. They require DATABASE_URL to be reachable.
  *  2. Plain-data helpers (makeAuditMeta, makeCreateClientInput, makeCreate*)
- *     — return in-memory objects suitable for unit tests with mocked `db`.
+ *     - return in-memory objects suitable for unit tests with mocked `db`.
  */
 
 import { and, eq, sql } from 'drizzle-orm';
@@ -299,7 +299,7 @@ export function makeAuditMeta(overrides?: Partial<AuditMeta>): AuditMeta {
 
 import type { RolePermissions } from '@/lib/db/schema/users';
 
-/** Full permissions — every action allowed. */
+/** Full permissions - every action allowed. */
 export function makeFullPermissions(): RolePermissions {
   return {
     clients: { view: true, create: true, edit: true, delete: true, merge: true, export: true },
@@ -387,7 +387,7 @@ export function makeFullPermissions(): RolePermissions {
   };
 }
 
-/** Read-only viewer permissions — no create/update/delete. */
+/** Read-only viewer permissions - no create/update/delete. */
 export function makeViewerPermissions(): RolePermissions {
   return {
     clients: { view: true, create: false, edit: false, delete: false, merge: false, export: false },
@@ -475,7 +475,7 @@ export function makeViewerPermissions(): RolePermissions {
   };
 }
 
-/** Sales agent permissions — own clients/interests, no admin. */
+/** Sales agent permissions - own clients/interests, no admin. */
 export function makeSalesAgentPermissions(): RolePermissions {
   return {
     clients: { view: true, create: true, edit: true, delete: false, merge: false, export: false },
@@ -563,7 +563,7 @@ export function makeSalesAgentPermissions(): RolePermissions {
   };
 }
 
-/** Sales manager — can do most things, limited admin. */
+/** Sales manager - can do most things, limited admin. */
 export function makeSalesManagerPermissions(): RolePermissions {
   return {
     clients: { view: true, create: true, edit: true, delete: true, merge: true, export: true },
@@ -651,7 +651,7 @@ export function makeSalesManagerPermissions(): RolePermissions {
   };
 }
 
-/** Director — everything except system backup. */
+/** Director - everything except system backup. */
 export function makeDirectorPermissions(): RolePermissions {
   return {
     ...makeFullPermissions(),