feat: snip a region into chat, and make links clickable (#14)

src/__tests__/location.test.ts

@@ -1,21 +1,53 @@
 import { describe, expect, it } from "vitest";
-import { describeTimezone, getLocationContext, utcOffsetLabel, weekdayName } from "../lib/location";
+import {
+  describeTimezoneArea,
+  getLocationContext,
+  localeRegion,
+  utcOffsetLabel,
+  weekdayName,
+} from "../lib/location";
 
-describe("describeTimezone", () => {
-  it("splits a simple zone into region and city", () => {
-    expect(describeTimezone("Asia/Manila")).toEqual({ region: "Asia", city: "Manila" });
+describe("describeTimezoneArea", () => {
+  it("keeps the zone's own label", () => {
+    expect(describeTimezoneArea("Asia/Manila")).toEqual({ area: "Manila" });
   });
 
   it("handles zones with more than two segments", () => {
-    expect(describeTimezone("America/Argentina/Salta")).toEqual({ region: "America", city: "Salta" });
+    expect(describeTimezoneArea("America/Argentina/Salta")).toEqual({ area: "Salta" });
   });
 
-  it("underscores become spaces", () => {
-    expect(describeTimezone("America/New_York")).toEqual({ region: "America", city: "New York" });
+  it("turns underscores into spaces", () => {
+    expect(describeTimezoneArea("America/New_York")).toEqual({ area: "New York" });
+  });
+
+  it("drops the continent grouping, which answers a question nobody asked", () => {
+    // "Asia" beside a locale region of "Philippines" reads as two answers to
+    // the same question.
+    expect(describeTimezoneArea("Asia/Manila")).not.toHaveProperty("region");
   });
 
   it("returns nothing for a bare zone like UTC", () => {
-    expect(describeTimezone("UTC")).toEqual({});
+    expect(describeTimezoneArea("UTC")).toEqual({});
+  });
+});
+
+describe("localeRegion", () => {
+  it("reads the region the user configured, rather than inferring one", () => {
+    expect(localeRegion("en-PH")).toEqual({ code: "PH", name: "Philippines" });
+  });
+
+  it("handles other regions", () => {
+    expect(localeRegion("de-DE")?.name).toBe("Germany");
+    expect(localeRegion("en-US")?.code).toBe("US");
+  });
+
+  it("has nothing to say for a locale with no region", () => {
+    expect(localeRegion("en")).toBeUndefined();
+  });
+
+  it("does not throw on a malformed locale", () => {
+    expect(localeRegion("not a locale")).toBeUndefined();
+    expect(localeRegion("")).toBeUndefined();
   });
 });
 
@@ -54,10 +86,11 @@ describe("getLocationContext", () => {
     const context = getLocationContext(new Date("2026-01-02T03:04:05Z"), "Asia/Manila");
 
     expect(context.timezone).toBe("Asia/Manila");
-    expect(context.city).toBe("Manila");
-    expect(context.region).toBe("Asia");
     expect(context.utcOffset).toContain("+08:00");
     expect(context.locale.length).toBeGreaterThan(0);
+    // The zone's label is reported as such, never as the user's city.
+    expect(context.timezoneArea).toBe("Manila");
+    expect(context).not.toHaveProperty("city");
   });
 
   it("still returns a usable context for an unknown zone", () => {
@@ -65,4 +98,15 @@ describe("getLocationContext", () => {
     expect(context.timezone).toBe("Not/AReal_Zone");
     expect(context.utcOffset).toBe("UTC");
   });
+
+  it("carries the configured place through verbatim", () => {
+    const context = getLocationContext(new Date(), "Asia/Manila", "  Cebu City, Philippines  ");
+    expect(context.place).toBe("Cebu City, Philippines");
+  });
+
+  it("treats an empty or whitespace place as unset", () => {
+    expect(getLocationContext(new Date(), "Asia/Manila", "").place).toBeUndefined();
+    expect(getLocationContext(new Date(), "Asia/Manila", "   ").place).toBeUndefined();
+    expect(getLocationContext(new Date(), "Asia/Manila").place).toBeUndefined();
+  });
 });