@escape-game-over/atlas 0.1.100 → 0.1.101

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@escape-game-over/atlas",
-    "version": "0.1.100",
+    "version": "0.1.101",
     "type": "module",
     "description": "Typed, data-driven machinery for static multi-locale, multi-deployment Astro sites.",
     "private": false,

package/src/astro/client.ts

@@ -10,8 +10,11 @@
  */
 
 export {
+    formatTime,
+    type HourCycle,
     type OpenStatus,
     openStatus,
+    type TimeFormat,
     type VenueNow,
 } from "../hours.ts";
 export * from "./attribution.ts";

package/src/contact-form.ts

@@ -28,8 +28,10 @@ export type ContactFormType =
     | "birthday_party"
     | "board_games"
     | "group_booking"
+    | "school_trips"
     | "team_building"
-    | "voucher";
+    | "voucher"
+    | "vr_games";
 
 /** Where a deployment's contact mail goes. */
 export interface MailEndpoint {

package/src/hours.ts

@@ -164,6 +164,13 @@ export function groupHours(
     return [...groups.values()];
 }
 
+/**
+ * Which clock times print on: `"h23"` as written (`14:00`), `"h12"` on a
+ * 12-hour clock (`2:00 PM`). Never the locale's default, which gives Greek a
+ * 12-hour clock nobody there uses on a door.
+ */
+export type HourCycle = "h12" | "h23";
+
 /**
  * How to print a week. Day names come from `Intl` in `locale`; "closed" is
  * copy, so the caller translates it.
@@ -175,12 +182,8 @@ export interface HoursFormat {
     weekday?: "short" | "long";
     /** The word for a day the venue is shut. */
     closed: string;
-    /**
-     * Times print as written (`14:00`) unless this is `"h12"` (`2:00 PM`).
-     * Not the locale's default, which gives Greek a 12-hour clock nobody there
-     * uses on a door.
-     */
-    hourCycle?: "h12";
+    /** As written (`"h23"`) when absent. */
+    hourCycle?: HourCycle;
     /** Between the ends of a span: `Mon–Thu`, `14:00–23:30`. */
     between?: string;
     /** Between spans: `Mon–Thu, Sun`. */
@@ -304,6 +307,33 @@ export function hoursSentence(
         .join(semicolon);
 }
 
+/** How `formatTime` prints a time. */
+export interface TimeFormat {
+    /** The language the clock is read in, e.g. `"en-US"`. */
+    readonly locale: string;
+    /** As written (`"h23"`) when absent. */
+    readonly hourCycle?: HourCycle;
+}
+
+/**
+ * One time as the hours print it: as written (`14:00`), or on a 12-hour clock
+ * (`2:00 PM`). For a line that quotes a single time, such as "open until",
+ * so it reads like the table beside it.
+ */
+export function formatTime(at: TimeOfDay, format: TimeFormat): string {
+    if (format.hourCycle !== "h12") return at;
+    return new Intl.DateTimeFormat(format.locale, {
+        hour: "numeric",
+        minute: "2-digit",
+        hourCycle: "h12",
+        timeZone: "UTC",
+    }).format(
+        new Date(
+            Date.UTC(2024, 0, 1, Number(at.slice(0, 2)), Number(at.slice(3, 5)))
+        )
+    );
+}
+
 /** Day names and times as `format` prints them. */
 function printer(
     format: Pick<HoursFormat, "locale" | "weekday" | "hourCycle">
@@ -315,29 +345,7 @@ function printer(
     });
     const dayName = (day: Weekday): string =>
         names.format(new Date(Date.UTC(2024, 0, 1 + WEEK.indexOf(day))));
-    const clock =
-        format.hourCycle === "h12"
-            ? new Intl.DateTimeFormat(format.locale, {
-                  hour: "numeric",
-                  minute: "2-digit",
-                  hourCycle: "h12",
-                  timeZone: "UTC",
-              })
-            : undefined;
-    const time = (at: TimeOfDay): string =>
-        clock === undefined
-            ? at
-            : clock.format(
-                  new Date(
-                      Date.UTC(
-                          2024,
-                          0,
-                          1,
-                          Number(at.slice(0, 2)),
-                          Number(at.slice(3, 5))
-                      )
-                  )
-              );
+    const time = (at: TimeOfDay): string => formatTime(at, format);
     return { dayName, time };
 }
 

package/src/index.ts

@@ -120,13 +120,16 @@ export {
     type DayHours,
     type FormattedHours,
     formatHours,
+    formatTime,
     groupHours,
+    type HourCycle,
     type HoursFormat,
     type HoursGroup,
     type HoursSentenceFormat,
     hoursSentence,
     type OpenStatus,
     openStatus,
+    type TimeFormat,
     type TimeOfDay,
     type TimeRange,
     type VenueNow,