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/lib/db/migrations/0015_i18n_columns.sql

@@ -0,0 +1,16 @@
+ALTER TABLE "client_addresses" ADD COLUMN "subdivision_iso" text;--> statement-breakpoint
+ALTER TABLE "client_addresses" ADD COLUMN "country_iso" text;--> statement-breakpoint
+ALTER TABLE "client_contacts" ADD COLUMN "value_e164" text;--> statement-breakpoint
+ALTER TABLE "client_contacts" ADD COLUMN "value_country" text;--> statement-breakpoint
+ALTER TABLE "clients" ADD COLUMN "nationality_iso" text;--> statement-breakpoint
+ALTER TABLE "companies" ADD COLUMN "incorporation_country_iso" text;--> statement-breakpoint
+ALTER TABLE "companies" ADD COLUMN "incorporation_subdivision_iso" text;--> statement-breakpoint
+ALTER TABLE "company_addresses" ADD COLUMN "subdivision_iso" text;--> statement-breakpoint
+ALTER TABLE "company_addresses" ADD COLUMN "country_iso" text;--> statement-breakpoint
+ALTER TABLE "residential_clients" ADD COLUMN "phone_e164" text;--> statement-breakpoint
+ALTER TABLE "residential_clients" ADD COLUMN "phone_country" text;--> statement-breakpoint
+ALTER TABLE "residential_clients" ADD COLUMN "nationality_iso" text;--> statement-breakpoint
+ALTER TABLE "residential_clients" ADD COLUMN "timezone" text;--> statement-breakpoint
+ALTER TABLE "residential_clients" ADD COLUMN "place_of_residence_country_iso" text;--> statement-breakpoint
+ALTER TABLE "residential_clients" ADD COLUMN "subdivision_iso" text;--> statement-breakpoint
+CREATE INDEX "idx_clients_nationality_iso" ON "clients" USING btree ("nationality_iso");

src/lib/db/migrations/meta/_journal.json

@@ -106,6 +106,13 @@
       "when": 1777379952283,
       "tag": "0014_black_banshee",
       "breakpoints": true
+    },
+    {
+      "idx": 15,
+      "version": "7",
+      "when": 1777391373291,
+      "tag": "0015_i18n_columns",
+      "breakpoints": true
     }
   ]
 }

src/lib/db/schema/clients.ts

@@ -22,8 +22,12 @@ export const clients = pgTable(
       .references(() => ports.id),
     fullName: text('full_name').notNull(),
     nationality: text('nationality'),
+    /** ISO-3166-1 alpha-2 nationality code. Supersedes `nationality`
+     *  after the i18n backfill (PR10) drops the legacy column. */
+    nationalityIso: text('nationality_iso'),
     preferredContactMethod: text('preferred_contact_method'), // email, phone, whatsapp
     preferredLanguage: text('preferred_language'),
+    /** IANA timezone, e.g. 'Europe/Warsaw'. Validated client + server. */
     timezone: text('timezone'),
     source: text('source'), // website, manual, referral, broker
     sourceDetails: text('source_details'),
@@ -35,6 +39,7 @@ export const clients = pgTable(
     index('idx_clients_port').on(table.portId),
     index('idx_clients_name').on(table.portId, table.fullName),
     index('idx_clients_archived').on(table.portId, table.archivedAt),
+    index('idx_clients_nationality_iso').on(table.nationalityIso),
   ],
 );
 
@@ -49,6 +54,10 @@ export const clientContacts = pgTable(
       .references(() => clients.id, { onDelete: 'cascade' }),
     channel: text('channel').notNull(), // email, phone, whatsapp, other
     value: text('value').notNull(),
+    /** E.164-normalized phone number (only set when channel='phone'/'whatsapp'). */
+    valueE164: text('value_e164'),
+    /** ISO-3166-1 alpha-2 of the country this number was parsed against. */
+    valueCountry: text('value_country'),
     label: text('label'), // primary, secondary, work, personal, broker, assistant
     isPrimary: boolean('is_primary').notNull().default(false),
     notes: text('notes'),
@@ -154,8 +163,12 @@ export const clientAddresses = pgTable(
     streetAddress: text('street_address'),
     city: text('city'),
     stateProvince: text('state_province'),
+    /** ISO 3166-2 subdivision code (e.g. 'PL-MZ', 'US-CA'). Optional. */
+    subdivisionIso: text('subdivision_iso'),
     postalCode: text('postal_code'),
     country: text('country'),
+    /** ISO-3166-1 alpha-2 country code. Supersedes `country` after backfill. */
+    countryIso: text('country_iso'),
     isPrimary: boolean('is_primary').notNull().default(true),
     createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
     updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),

src/lib/db/schema/companies.ts

@@ -25,6 +25,11 @@ export const companies = pgTable(
     taxId: text('tax_id'),
     registrationNumber: text('registration_number'),
     incorporationCountry: text('incorporation_country'),
+    /** ISO-3166-1 alpha-2 country of incorporation. Replaces the
+     *  free-text `incorporation_country` after the i18n backfill. */
+    incorporationCountryIso: text('incorporation_country_iso'),
+    /** ISO 3166-2 subdivision (state/province) of incorporation. Optional. */
+    incorporationSubdivisionIso: text('incorporation_subdivision_iso'),
     incorporationDate: timestamp('incorporation_date', { withTimezone: true, mode: 'date' }),
     status: text('status').notNull().default('active'), // 'active' | 'dissolved'
     billingEmail: text('billing_email'),
@@ -89,8 +94,12 @@ export const companyAddresses = pgTable(
     streetAddress: text('street_address'),
     city: text('city'),
     stateProvince: text('state_province'),
+    /** ISO 3166-2 subdivision code. Optional. */
+    subdivisionIso: text('subdivision_iso'),
     postalCode: text('postal_code'),
     country: text('country'),
+    /** ISO-3166-1 alpha-2 country code. Supersedes `country` after backfill. */
+    countryIso: text('country_iso'),
     isPrimary: boolean('is_primary').notNull().default(true),
     createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
     updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),

src/lib/db/schema/residential.ts

@@ -20,7 +20,21 @@ export const residentialClients = pgTable(
     fullName: text('full_name').notNull(),
     email: text('email'),
     phone: text('phone'),
+    /** E.164-normalized phone, populated alongside `phone` once the i18n
+     *  PhoneInput component lands. The free-text `phone` column stays
+     *  for one release as a fallback for unparseable rows. */
+    phoneE164: text('phone_e164'),
+    /** ISO-3166-1 alpha-2 — country the phone was parsed against. */
+    phoneCountry: text('phone_country'),
+    /** ISO-3166-1 alpha-2 nationality. */
+    nationalityIso: text('nationality_iso'),
+    /** IANA timezone for scheduling/reminders. */
+    timezone: text('timezone'),
     placeOfResidence: text('place_of_residence'),
+    /** ISO-3166-1 alpha-2 country of residence. */
+    placeOfResidenceCountryIso: text('place_of_residence_country_iso'),
+    /** ISO 3166-2 subdivision code for place of residence. Optional. */
+    subdivisionIso: text('subdivision_iso'),
     preferredContactMethod: text('preferred_contact_method'), // email | phone
     /**
      * Lifecycle: prospect | active | inactive. Distinct from