@escape-game-over/atlas 0.1.109 → 0.1.110

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@escape-game-over/atlas",
-    "version": "0.1.109",
+    "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",

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,