feat(i18n): country/phone/timezone/subdivision primitives + form wiring

Cross-cutting i18n polish for forms across the marina + residential + company
domains. Introduces a single source of truth for country/phone/timezone/
subdivision data and replaces every nationality-as-free-text and timezone-
as-string Input with a dedicated combobox.

PR1  Countries — ALL_COUNTRY_CODES (~250 ISO-3166-1 alpha-2), Intl.DisplayNames
     for localized labels, detectDefaultCountry() with navigator-region
     fallback to US, CountryCombobox with regional-indicator flag glyphs +
     compact mode for inline use.
PR2  Phone — libphonenumber-js wrapper (parsePhone / formatAsYouType /
     callingCodeFor), PhoneInput with flag dropdown + national-format
     AsYouType + paste-detect that flips the country dropdown for pasted
     international strings.
PR3  Timezones — country->IANA map (250 entries, multi-zone for AU/BR/CA/CD/
     ID/KZ/MN/MX/RU/US), formatTimezoneLabel ("Europe/London (UTC+1)"),
     TimezoneCombobox with Suggested/All grouping driven by countryHint.
PR4  Subdivisions — wraps the iso-3166-2 npm package (~5000 ISO 3166-2
     codes for every country), per-country cache, SubdivisionCombobox with
     "Pick a country first" / "No regions available" empty states.
PR5  Schema deltas (migration 0015) — clients.nationality_iso, clientContacts
     {value_e164, value_country}, clientAddresses {country_iso, subdivision_iso},
     residentialClients {phone_e164, phone_country, nationality_iso, timezone,
     place_of_residence_country_iso, subdivision_iso}, companies {incorporation_
     country_iso, incorporation_subdivision_iso}, companyAddresses {country_iso,
     subdivision_iso}. Plus shared zod validators (validators/i18n.ts) used
     by every entity validator + route handler.
PR6  ClientForm + ClientDetail — CountryCombobox replaces nationality Input,
     TimezoneCombobox replaces timezone Input (driven by nationalityIso hint),
     PhoneInput conditionally rendered for phone/whatsapp contacts. Inline
     editors (InlineCountryField / InlineTimezoneField / InlinePhoneField)
     for the detail-page overview rows + ContactsEditor.
PR7  Residential client form + detail — phone -> PhoneInput, nationality/
     timezone/place-of-residence-country/subdivision rows in both create
     sheet and inline-editable detail view. Subdivision wipes when country
     flips since codes are country-scoped.
PR8  Company form + detail — incorporation country -> CountryCombobox,
     incorporation region -> SubdivisionCombobox in both modes.
PR9  Public inquiry endpoint — accepts pre-normalized phoneE164/phoneCountry
     and i18n fields from newer website builds, server-side parsePhone()
     fallback for legacy raw-international submissions. Old Nuxt builds
     keep working unchanged.

Tests: 4 unit suites for the primitives (25 tests), 1 integration spec for
the public phone-normalization path (3 tests), 1 smoke spec asserting the
combobox triggers render in all three create sheets.

Test totals: vitest 713 -> 741 (+28).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

src/components/shared/timezone-combobox.tsx

@@ -0,0 +1,150 @@
+'use client';
+
+import { useMemo, useState } from 'react';
+import { Check, ChevronsUpDown } from 'lucide-react';
+
+import { Button } from '@/components/ui/button';
+import {
+  Command,
+  CommandEmpty,
+  CommandGroup,
+  CommandInput,
+  CommandItem,
+  CommandList,
+  CommandSeparator,
+} from '@/components/ui/command';
+import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';
+import { cn } from '@/lib/utils';
+import { formatTimezoneLabel, listAllTimezones, timezonesForCountry } from '@/lib/i18n/timezones';
+import type { CountryCode } from '@/lib/i18n/countries';
+
+interface TimezoneComboboxProps {
+  value: string | null | undefined;
+  onChange: (iana: string | null) => void;
+  /** When set, the dropdown surfaces matching zones first under a "Suggested" group. */
+  countryHint?: CountryCode;
+  placeholder?: string;
+  disabled?: boolean;
+  className?: string;
+  clearable?: boolean;
+  id?: string;
+  'data-testid'?: string;
+}
+
+export function TimezoneCombobox({
+  value,
+  onChange,
+  countryHint,
+  placeholder = 'Select timezone…',
+  disabled,
+  className,
+  clearable = true,
+  id,
+  'data-testid': testId,
+}: TimezoneComboboxProps) {
+  const [open, setOpen] = useState(false);
+
+  const allOptions = useMemo(() => {
+    return listAllTimezones().map((tz) => ({
+      tz,
+      label: formatTimezoneLabel(tz),
+    }));
+  }, []);
+
+  const suggested = useMemo(() => {
+    if (!countryHint) return [];
+    const set = new Set(timezonesForCountry(countryHint));
+    return allOptions.filter((o) => set.has(o.tz));
+  }, [allOptions, countryHint]);
+
+  const rest = useMemo(() => {
+    if (!suggested.length) return allOptions;
+    const suggestedSet = new Set(suggested.map((s) => s.tz));
+    return allOptions.filter((o) => !suggestedSet.has(o.tz));
+  }, [allOptions, suggested]);
+
+  const selectedLabel = value ? formatTimezoneLabel(value) : placeholder;
+
+  return (
+    <Popover open={open} onOpenChange={setOpen}>
+      <PopoverTrigger asChild>
+        <Button
+          id={id}
+          variant="outline"
+          role="combobox"
+          aria-expanded={open}
+          disabled={disabled}
+          className={cn('w-full justify-between', !value && 'text-muted-foreground', className)}
+          data-testid={testId}
+        >
+          <span className="truncate text-sm">{selectedLabel}</span>
+          <ChevronsUpDown className="ml-2 h-4 w-4 shrink-0 opacity-50" />
+        </Button>
+      </PopoverTrigger>
+      <PopoverContent className="w-[360px] p-0" align="start">
+        <Command>
+          <CommandInput placeholder="Search timezones…" />
+          <CommandList>
+            <CommandEmpty>No timezone found.</CommandEmpty>
+            {clearable && value ? (
+              <CommandGroup>
+                <CommandItem
+                  value="__clear__"
+                  onSelect={() => {
+                    onChange(null);
+                    setOpen(false);
+                  }}
+                  className="text-muted-foreground"
+                >
+                  Clear selection
+                </CommandItem>
+              </CommandGroup>
+            ) : null}
+            {suggested.length > 0 ? (
+              <>
+                <CommandGroup heading="Suggested">
+                  {suggested.map((opt) => (
+                    <CommandItem
+                      key={opt.tz}
+                      value={opt.tz}
+                      onSelect={() => {
+                        onChange(opt.tz);
+                        setOpen(false);
+                      }}
+                    >
+                      <Check
+                        className={cn(
+                          'mr-2 h-4 w-4',
+                          value === opt.tz ? 'opacity-100' : 'opacity-0',
+                        )}
+                      />
+                      <span className="truncate text-sm">{opt.label}</span>
+                    </CommandItem>
+                  ))}
+                </CommandGroup>
+                <CommandSeparator />
+              </>
+            ) : null}
+            <CommandGroup heading={suggested.length > 0 ? 'All zones' : undefined}>
+              {rest.map((opt) => (
+                <CommandItem
+                  key={opt.tz}
+                  value={opt.tz}
+                  onSelect={() => {
+                    onChange(opt.tz);
+                    setOpen(false);
+                  }}
+                >
+                  <Check
+                    className={cn('mr-2 h-4 w-4', value === opt.tz ? 'opacity-100' : 'opacity-0')}
+                  />
+                  <span className="truncate text-sm">{opt.label}</span>
+                </CommandItem>
+              ))}
+            </CommandGroup>
+          </CommandList>
+        </Command>
+      </PopoverContent>
+    </Popover>
+  );
+}