@escape-game-over/atlas 0.1.108 → 0.1.110

package/README.md

@@ -72,6 +72,7 @@ export const { project, redirects } = atlas.project(
 
         enabledLocales: ["el-GR", "en-US"],
         overrideRouting: { defaultLocale: "el-GR", prefixDefaultLocale: true },
+        clock: { "el-GR": "h23", "en-US": "h12" }, // how each language prints times
 
         overrideMessages: {
             // Greek only — the English copy still falls through to the default catalog.
@@ -243,6 +244,8 @@ regression-tested by an `@ts-expect-error` suite.
 | A `robots` directive that is not a real one                                     | error — the vocabulary is a union            |
 | A project `url` that is not `https://`, or ends in a slash                      | error                                        |
 | `defaultLocale` not among the project's `enabledLocales`                        | error                                        |
+| A `clock` leaving out a published locale, or naming an unpublished one          | error                                        |
+| `site.clockFor` on a project that declares no clock                             | throws, naming the project                   |
 | An unknown field in a project declaration                                       | error — a typo cannot sit there unread       |
 | Two routes resolving to the same URL                                            | build throws, naming both                    |
 | A site icon that is not square, a multiple of 48px, and PNG                     | build throws                                 |

package/docs/checks.md

@@ -42,6 +42,7 @@ sees.
 | unknown message key, or an override dropping a `{placeholder}`                            | two routes resolving to the same URL                                    |
 | a message the project declared mandatory and never wrote (`CatalogCovers`)                |                                                                         |
 | copy or a locale label written for a locale outside `enabledLocales`                      |                                                                         |
+| a `clock` leaving out a published locale, or naming one outside `enabledLocales`          | the same, for a project that was not type-checked first                 |
 | a slug whose translation sits at a different depth, in the registry or across the overlay | the same, when a slug is not a literal (computed, or from an env var)   |
 | unknown route id, or a locale the site does not ship                                      | a locale published twice                                                |
 | a malformed language tag (`en_US`, `en-us`, `EN-US`, bare `en`)                           | an icon that is not square, a multiple of 48, and PNG                   |

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@escape-game-over/atlas",
-    "version": "0.1.108",
+    "version": "0.1.110",
     "type": "module",
     "description": "Typed, data-driven machinery for static multi-locale, multi-deployment Astro sites.",
     "private": false,
@@ -22,6 +22,7 @@
         "./astro/consent-banner": "./src/astro/ConsentBanner.astro",
         "./astro/document": "./src/astro/Document.astro",
         "./astro/element": "./src/astro/AtlasElement.astro",
+        "./astro/escapeall": "./src/astro/EscapeAll.astro",
         "./astro/escape-navigator": "./src/astro/EscapeNavigator.astro",
         "./astro/four-escape": "./src/astro/FourEscape.astro",
         "./astro/google-map": "./src/astro/GoogleMap.astro",
@@ -63,10 +64,10 @@
         "vite": ">= 8"
     },
     "devDependencies": {
-        "@biomejs/biome": "2.6.6",
+        "@biomejs/biome": "2.6.7",
         "@types/node": "26.6.6",
         "@vitest/coverage-istanbul": "5.1.0",
-        "astro": "7.4.10",
+        "astro": "7.4.11",
         "typescript": "6.0.3",
         "vitest": "5.1.0"
     }

package/src/analytics/storage.ts

@@ -53,6 +53,7 @@ export const STORAGE_VENDOR_NAMES = {
     clarity: "Microsoft Clarity",
     "4escape": "4escape",
     escapenavigator: "Escape Navigator",
+    escapeall: "EscapeAll",
     stripe: "Stripe",
 } as const satisfies Record<StorageVendor | BookingVendor | "stripe", string>;
 
@@ -314,6 +315,13 @@ const BOOKING = {
         stripe: true,
         loads: ["google-analytics", "google-ads", "meta"],
     },
+    // Read from its script 2026-11-12: nothing as it renders; the phone
+    // confirmation while a visitor books. Its queue cookie waits for its own
+    // consent cookie, which a site of ours never sets.
+    escapeall: {
+        kept: ["ea-cell-confirmation"],
+        tab: [],
+    },
 } as const satisfies Record<BookingVendor, BookingStorage>;
 
 /**
@@ -452,7 +460,7 @@ export function storedItems(
     let stripe = false;
     for (const widget of new Set(booking)) {
         const entry: BookingStorage = BOOKING[widget];
-        widgetRows.push(
+        const own: StoredItem[] = [
             {
                 id: widget,
                 names: entry.kept,
@@ -466,8 +474,10 @@ export function storedItems(
                 provider: widget,
                 lasts: "tab",
                 consent: "none",
-            }
-        );
+            },
+        ];
+        // A widget that keeps nothing for the tab has no row for it.
+        widgetRows.push(...own.filter((row) => row.names.length > 0));
         for (const vendor of entry.loads ?? []) vendors.add(vendor);
         if (entry.stripe) stripe = true;
     }

package/src/astro/BookingWidget.astro

@@ -14,6 +14,7 @@
  */
 import type { HTMLAttributes } from "astro/types";
 import type { BookingWidget, BookingWidgetVars } from "../booking/widget.ts";
+import EscapeAll from "./EscapeAll.astro";
 import EscapeNavigator from "./EscapeNavigator.astro";
 import FourEscape from "./FourEscape.astro";
 
@@ -39,6 +40,18 @@ const { widget, locale, vars, colorScheme, ...attrs } = Astro.props;
         vars={vars}
     />
 )}
+{widget.vendor === "escapeall" && (
+    <EscapeAll
+        {...attrs}
+        host={widget.host}
+        companyId={widget.companyId}
+        serviceId={widget.serviceId}
+        template={widget.template}
+        skin={widget.skin}
+        players={widget.players}
+        locale={locale}
+    />
+)}
 {widget.vendor === "escapenavigator" && (
     <EscapeNavigator
         {...attrs}

package/src/astro/EscapeAll.astro

@@ -0,0 +1,62 @@
+---
+/**
+ * An EscapeAll booking calendar: one room's, or every room's. See
+ * `escapeall.ts` for what it loads and keeps.
+ *
+ * `locale` is the page's. Attributes go on the calendar's element.
+ *
+ * ```astro
+ * <EscapeAll host="nl.escapeall.com" companyId="…" serviceId="…" template={9} locale={locale} />
+ * ```
+ */
+import type { HTMLAttributes } from "astro/types";
+import {
+    checkEscapeAll,
+    type EscapeAllWidget,
+    escapeAllAssets,
+    escapeAllLanguage,
+} from "../booking/escapeall.ts";
+
+type Props = HTMLAttributes<"div"> &
+    EscapeAllWidget & {
+        readonly locale: string;
+    };
+
+const {
+    host,
+    companyId,
+    serviceId,
+    template,
+    skin,
+    players,
+    locale,
+    id,
+    ...attrs
+} = Astro.props;
+const widget = { host, companyId, serviceId, template, skin, players };
+
+checkEscapeAll(widget, Astro.url.pathname);
+
+const { stylesheets, script } = escapeAllAssets(widget);
+// EscapeAll's script builds its selectors from the one it is given, so the
+// calendar is found by id: the page's own, or one from the room or account.
+const elementId = id ?? `escapeall-${serviceId ?? companyId}`;
+---
+
+{stylesheets.map((href) => (
+    <link
+        rel='stylesheet'
+        href={href}
+    />
+))}
+<script src="./escapeall-calendar.ts"></script>
+<div
+    {...attrs}
+    id={elementId}
+    data-escapeall-company={companyId}
+    data-escapeall-service={serviceId}
+    data-escapeall-template={template}
+    data-escapeall-players={players}
+    data-escapeall-language={escapeAllLanguage(locale)}
+    data-escapeall-script={script}
+></div>

package/src/astro/escapeall-calendar.ts

@@ -0,0 +1,32 @@
+import { appendScript } from "./append-script.ts";
+
+/**
+ * Draws each EscapeAll calendar on the page, once EscapeAll's script has
+ * loaded: the call its store scripts make, with the settings the component
+ * wrote on the element.
+ */
+// Its script builds selectors by appending to the one it is given, so the
+// calendar is named by its id, not handed over as an element.
+type Calendar = (selector: string, settings: Record<string, unknown>) => void;
+
+const host = window as unknown as { GetBookingCalendra?: Calendar };
+
+const elements = [...document.querySelectorAll("[data-escapeall-company]")];
+const [first] = elements;
+if (first instanceof HTMLElement && first.dataset.escapeallScript) {
+    appendScript(first.dataset.escapeallScript).addEventListener("load", () => {
+        for (const element of elements) {
+            if (!(element instanceof HTMLElement)) continue;
+            const { escapeallCompany, escapeallService, escapeallLanguage } =
+                element.dataset;
+            host.GetBookingCalendra?.(`#${CSS.escape(element.id)}`, {
+                CompanyId: [escapeallCompany],
+                ...(escapeallService ? { ServiceId: [escapeallService] } : {}),
+                lang: escapeallLanguage,
+                Template: Number(element.dataset.escapeallTemplate),
+                InitialQuantity: Number(element.dataset.escapeallPlayers ?? 2),
+                FirstWeekDay: "Monday",
+            });
+        }
+    });
+}

package/src/booking/escapeall.ts

@@ -0,0 +1,86 @@
+import { invalidId, UUID, type Uuid } from "../analytics/ids.ts";
+
+/**
+ * EscapeAll's booking calendar: a store's rooms and their free slots, booked
+ * on the page. One room's calendar when `serviceId` names it (EscapeAll calls
+ * a room a service), or every room's.
+ *
+ * EscapeAll's embed is a store script of its own that waits for EscapeAll's
+ * jQuery, then calls `GetBookingCalendra` from the shared `all.js` with the
+ * store's settings. The component makes that call itself, with the page's
+ * language, so it needs no store script. Read 2026-11-12 from Aruba's.
+ *
+ * It stores nothing as it renders, and loads nothing from anyone else; while
+ * a visitor books it keeps a phone confirmation in local storage. Its queue
+ * cookie is written only once the page sets EscapeAll's own consent cookie,
+ * which ours never does. All of it is in `storedItems`.
+ */
+export interface EscapeAllWidget {
+    /** EscapeAll's regional site the account is on: `nl.escapeall.com`. */
+    readonly host: string;
+    /** The account's id, from EscapeAll: the store script's `CompanyId`. */
+    readonly companyId: Uuid;
+    /** One room's id, for its calendar alone; every room's without it. */
+    readonly serviceId?: Uuid;
+    /** The calendar's layout, by EscapeAll's number: the store's `Template`. */
+    readonly template: number;
+    /** The store's stylesheet, as EscapeAll hosts it: `CustomCss/<skin>.css`. */
+    readonly skin?: string;
+    /** The group size the calendar opens on: the store's `InitialQuantity`. */
+    readonly players?: number;
+}
+
+/** EscapeAll's own CSS variables: none it documents, so none taken. */
+export type EscapeAllVars = Readonly<Partial<Record<string, never>>>;
+
+/** The languages the calendar is translated into, as its paths take them. */
+export const ESCAPEALL_LANGUAGES = ["en", "nl", "de"] as const;
+
+export type EscapeAllLanguage = (typeof ESCAPEALL_LANGUAGES)[number];
+
+/** EscapeAll's regional sites: `nl.escapeall.com`. */
+const ESCAPEALL_HOST = /^[a-z]{2}\.escapeall\.com$/;
+
+/** Fails the build on a calendar that would render nothing. */
+export function checkEscapeAll(widget: EscapeAllWidget, at: string): void {
+    if (!ESCAPEALL_HOST.test(widget.host)) {
+        invalidId(
+            at,
+            `EscapeAll host "${widget.host}" is not one of EscapeAll's regional sites, like "nl.escapeall.com".`
+        );
+    }
+    for (const [name, id] of [
+        ["company", widget.companyId],
+        ["service", widget.serviceId],
+    ] as const) {
+        if (id !== undefined && !UUID.test(id)) {
+            invalidId(
+                at,
+                `EscapeAll ${name} id "${id}" is not a UUID, so the calendar would render nothing.`
+            );
+        }
+    }
+}
+
+/** The stylesheets and script a calendar on `host` needs. */
+export function escapeAllAssets(widget: EscapeAllWidget) {
+    const base = `https://${widget.host}`;
+    return {
+        stylesheets: [
+            `${base}/Content/API/styles.css`,
+            ...(widget.skin === undefined
+                ? []
+                : [`${base}/CustomCss/${widget.skin}.css`]),
+        ],
+        script: `${base}/Scripts/API/all.js`,
+    };
+}
+
+/**
+ * The calendar's language for a page's locale: English for one it is not
+ * translated into, as EscapeAll's own embeds fall back.
+ */
+export function escapeAllLanguage(locale: string): EscapeAllLanguage {
+    const { language } = new Intl.Locale(locale);
+    return ESCAPEALL_LANGUAGES.find((known) => known === language) ?? "en";
+}

package/src/booking/widget.ts

@@ -2,6 +2,7 @@ import type {
     EscapeNavigatorVars,
     EscapeNavigatorWidget,
 } from "./escape-navigator.ts";
+import type { EscapeAllVars, EscapeAllWidget } from "./escapeall.ts";
 import type { FourEscapeVars, FourEscapeWidget } from "./four-escape.ts";
 
 /**
@@ -10,7 +11,8 @@ import type { FourEscapeVars, FourEscapeWidget } from "./four-escape.ts";
  */
 export type BookingWidget =
     | ({ readonly vendor: "4escape" } & FourEscapeWidget)
-    | ({ readonly vendor: "escapenavigator" } & EscapeNavigatorWidget);
+    | ({ readonly vendor: "escapenavigator" } & EscapeNavigatorWidget)
+    | ({ readonly vendor: "escapeall" } & EscapeAllWidget);
 
 /** Who makes a booking widget: what `storedItems` takes for their rows. */
 export type BookingVendor = BookingWidget["vendor"];
@@ -19,6 +21,7 @@ export type BookingVendor = BookingWidget["vendor"];
 export interface BookingVendorVars {
     readonly "4escape": FourEscapeVars;
     readonly escapenavigator: EscapeNavigatorVars;
+    readonly escapeall: EscapeAllVars;
 }
 
 /** The CSS variables a widget takes: its own vendor's, and no other's. */

package/src/index.ts

@@ -62,6 +62,15 @@ export {
     type EscapeNavigatorWidget,
     escapeNavigatorLanguage,
 } from "./booking/escape-navigator.ts";
+export {
+    checkEscapeAll,
+    ESCAPEALL_LANGUAGES,
+    type EscapeAllLanguage,
+    type EscapeAllVars,
+    type EscapeAllWidget,
+    escapeAllAssets,
+    escapeAllLanguage,
+} from "./booking/escapeall.ts";
 export {
     checkFourEscape,
     FOUR_ESCAPE_LANGUAGES,

package/src/project.ts

@@ -7,6 +7,7 @@ import type {
     SiteConfigShape,
 } from "./config.ts";
 import type { Fonts } from "./fonts.ts";
+import type { HourCycle } from "./hours.ts";
 import type {
     BaseCatalog,
     OverrideCatalog,
@@ -105,6 +106,21 @@ export interface ProjectInput<L extends string, Routes> {
      * declare is a compile error.
      */
     readonly enabledLocales: readonly L[];
+    /**
+     * The clock each published language prints times on: `"h23"` for 18:00,
+     * `"h12"` for 6:00 PM. Read back with `site.clockFor(locale)`.
+     *
+     * One entry for every locale in `enabledLocales`, and none for any other,
+     * so what each page prints is written down beside the languages that print
+     * it: a bilingual Canadian site reads `{ "en-CA": "h12", "fr-CA": "h23" }`.
+     * Not taken from the locale's own default (`Intl`'s) on purpose: a site may
+     * print a 24-hour clock where its language's default is 12-hour, and that
+     * choice is the site's to state.
+     *
+     * Optional: a project that prints no times declares none, and
+     * `clockFor` refuses to answer for it.
+     */
+    readonly clock?: Readonly<Partial<Record<L, HourCycle>>>;
     /**
      * Replaces parts of the site's `defaultRouting` for this project.
      *
@@ -286,6 +302,17 @@ export type ProjectChecks<
             ? NoExcessKeys<T["overrideLocaleMeta"][K], keyof LocaleMetaOverride>
             : LocaleNotEnabled<K>;
     };
+    // The locales written must be ones this project publishes, as for
+    // `overrideLocaleMeta` above. That every one it publishes is there is
+    // checked in `ProjectOverrideChecks`: a conditional on `T` here would make
+    // the constraint circular.
+    readonly clock?: {
+        readonly [K in StringKeys<
+            T["clock"]
+        >]: K extends T["enabledLocales"][number]
+            ? HourCycle
+            : LocaleNotEnabled<K>;
+    };
 };
 
 /** The same checks that map the whole override objects, in parameter position. */
@@ -312,7 +339,16 @@ export type ProjectOverrideChecks<
               T["enabledLocales"][number]
           >;
       }
-    : unknown);
+    : unknown) &
+    (T extends { readonly clock: object }
+        ? {
+              // A clock, once declared, is declared for every page: a locale
+              // left out would have no clock to print its times on.
+              readonly clock: {
+                  readonly [K in T["enabledLocales"][number]]: HourCycle;
+              };
+          }
+        : unknown);
 
 /** A project's own messages, as a catalog: none when it adds none. */
 export type AddedCatalog<P> = P extends { readonly addMessages: infer A }
@@ -369,5 +405,25 @@ export function defineProject<
             );
         }
     }
+    // The clock's rule, for the same reason.
+    if (project.clock !== undefined) {
+        const published: readonly string[] = project.enabledLocales;
+        const missing = published.filter(
+            (locale) => !(locale in (project.clock ?? {}))
+        );
+        if (missing.length > 0) {
+            throw new Error(
+                `Project "${project.siteName}": clock has no ${missing.join(", ")}. A project that declares a clock gives one for every locale it publishes.`
+            );
+        }
+        const extra = Object.keys(project.clock).filter(
+            (locale) => !published.includes(locale)
+        );
+        if (extra.length > 0) {
+            throw new Error(
+                `Project "${project.siteName}": clock names ${extra.join(", ")}, which this project does not publish.`
+            );
+        }
+    }
     return project;
 }

package/src/site/api.ts

@@ -7,6 +7,7 @@ import type {
 import type { GeneratedFile } from "../file.ts";
 import type { PublicFilePath } from "../files.ts";
 import type { Fonts } from "../fonts.ts";
+import type { HourCycle } from "../hours.ts";
 import type { TranslateFor } from "../i18n/translate.ts";
 import type { LlmsSection } from "../llms.ts";
 import type { ThemeColor } from "../meta/index.ts";
@@ -219,6 +220,15 @@ export interface Site<
         bind?: { readonly values?: Readonly<Record<Values, string>> }
     ): PlainTextFor<Catalog, Values>;
 
+    /**
+     * The clock a locale's pages print times on, as the project's `clock`
+     * states it: hand it to `formatHours`, or to anything formatting a time.
+     *
+     * Throws for a project that declares no clock: one that prints times has
+     * to say how.
+     */
+    clockFor(locale: L): HourCycle;
+
     /** Absolute path of a route in one locale, e.g. `/el/sxetika-me-emas`. */
     pathFor(id: RouteId, locale: L, options?: LinkOptions): UrlPath;
     /** The same, prefixed with the site origin — for canonicals and sitemaps. */

package/src/site/create.ts

@@ -14,6 +14,7 @@ import {
 import type { GeneratedFile } from "../file.ts";
 import type { PublicFilePath } from "../files.ts";
 import { mergeFonts } from "../fonts.ts";
+import type { HourCycle } from "../hours.ts";
 import { type BaseCatalog, mergeCatalog } from "../i18n/define.ts";
 import { createTranslateFactory } from "../i18n/translate.ts";
 import type { ImageAsset } from "../image.ts";
@@ -192,6 +193,18 @@ export function createSite<
 
     const resolved = mergeRoutes<L, Routes>(routes, project.overrideRoutes);
 
+    function clockFor(locale: L): HourCycle {
+        const cycle = project.clock?.[locale];
+        if (cycle === undefined) {
+            throw new Error(
+                project.clock === undefined
+                    ? `Project "${project.siteName}" declares no clock, so it cannot print a time. Add \`clock\`, with an hour cycle for each locale it publishes.`
+                    : `Project "${project.siteName}": clock has no ${locale}.`
+            );
+        }
+        return cycle;
+    }
+
     function pathFor(id: RouteId, locale: L, options?: LinkOptions): UrlPath {
         const route = resolved[id];
         if (route === undefined) {
@@ -867,6 +880,7 @@ export function createSite<
                 ...bind,
             }),
 
+        clockFor,
         pathFor,
         urlFor,
         fileUrl,