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

src/app/api/v1/berths/[id]/interest-documents/route.ts

@@ -6,7 +6,7 @@ import { listDealDocumentsForBerth } from '@/lib/services/documents.service';
 
 /**
  * GET /api/v1/berths/[id]/interest-documents (renamed from
- * `/deal-documents` in the 2026-05-14 terminology sweep — canonical
+ * `/deal-documents` in the 2026-05-14 terminology sweep - canonical
  * noun is "interest").
  *
  * Lists documents attached to interests currently linked to this berth.

src/app/api/v1/berths/[id]/pdf-upload-url/handlers.ts

@@ -21,7 +21,7 @@ import { getStorageBackend } from '@/lib/storage';
 
 const postBodySchema = z.object({
   fileName: z.string().min(1).max(255),
-  /** Size hint in bytes — used to early-reject oversized uploads before we
+  /** Size hint in bytes - used to early-reject oversized uploads before we
    *  burn a presigned URL. */
   sizeBytes: z.number().int().nonnegative().optional(),
 });

src/app/api/v1/berths/[id]/pdf-versions/handlers.ts

@@ -44,7 +44,7 @@ export const getHandler: RouteHandler = async (_req, ctx, params) => {
 // and pdf-upload-url tenant-scopes the berth lookup. Without this regex,
 // a rep with berths.edit could ship the storage key of a foreign-port
 // PDF (signed EOI, brochure blob, another port's berth) and have the
-// service repoint THIS berth's currentPdfVersionId at it — subsequent
+// service repoint THIS berth's currentPdfVersionId at it - subsequent
 // pdf-download serves those bytes under the rep's own permission gate.
 const STORAGE_KEY_RE =
   /^berths\/[A-Za-z0-9_-]+\/uploads\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}_/;