@escape-game-over/atlas 0.1.103 → 0.1.105

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@escape-game-over/atlas",
-    "version": "0.1.103",
+    "version": "0.1.105",
     "type": "module",
     "description": "Typed, data-driven machinery for static multi-locale, multi-deployment Astro sites.",
     "private": false,
@@ -18,6 +18,7 @@
         "./client": "./src/astro/client.ts",
         "./astro/auto-dialog": "./src/astro/AutoDialog.astro",
         "./astro/background-video": "./src/astro/BackgroundVideo.astro",
+        "./astro/booking-widget": "./src/astro/BookingWidget.astro",
         "./astro/consent-banner": "./src/astro/ConsentBanner.astro",
         "./astro/document": "./src/astro/Document.astro",
         "./astro/element": "./src/astro/AtlasElement.astro",

package/src/analytics/storage.ts

@@ -1,3 +1,4 @@
+import type { BookingVendor } from "../booking/widget.ts";
 import {
     CONSENT_KEY,
     CONSENT_MONTHS,
@@ -35,13 +36,6 @@ export type StorageVendor =
     | "drip"
     | "clarity";
 
-/**
- * A booking widget a site embeds, which keeps its own storage on the site's
- * domain: rows the analytics settings cannot know about, so the site names
- * the widgets it embeds.
- */
-export type BookingWidget = "4escape";
-
 /**
  * Each vendor's product as it calls itself, for a table's "set by" column.
  * Names, not copy: the same in every language, so a project translates only
@@ -58,7 +52,7 @@ export const STORAGE_VENDOR_NAMES = {
     drip: "Drip",
     clarity: "Microsoft Clarity",
     "4escape": "4escape",
-} as const satisfies Record<StorageVendor | BookingWidget, string>;
+} as const satisfies Record<StorageVendor | BookingVendor, string>;
 
 /** A span `Intl.NumberFormat` can word in any locale: `{ 2, "year" }`. */
 export interface Lifetime {
@@ -73,7 +67,7 @@ type OwnRow = `${VendorWithOwn}-own`;
 export type AtlasStoredId = "atlas-locale" | "atlas-campaign" | "atlas-consent";
 
 /** A booking widget's rows: what it keeps, and what it keeps for the tab. */
-type BookingRow = BookingWidget | `${BookingWidget}-tab`;
+type BookingRow = BookingVendor | `${BookingVendor}-tab`;
 
 /** One row's id: what a project keys the row's wording by. */
 export type StoredId = AtlasStoredId | StorageVendor | OwnRow | BookingRow;
@@ -83,7 +77,7 @@ export interface StoredItem {
     /** As the browser shows them; a pattern like `_ga_<id>` where the vendor appends one. */
     readonly names: readonly string[];
     /** Who sets it: this site, or the vendor. */
-    readonly provider: "site" | StorageVendor | BookingWidget;
+    readonly provider: "site" | StorageVendor | BookingVendor;
     /** Set on the vendor's own domains rather than the site's; absent for the site's. */
     readonly domains?: readonly string[];
     /** A span; `tab` for session storage; `kept` until the visitor clears it. */
@@ -97,8 +91,12 @@ export interface StoredItemsOptions {
     readonly rememberLocale?: boolean;
     /** As passed to `Document`, and with its default: `false`. */
     readonly rememberCampaign?: boolean;
-    /** The booking widgets the site embeds anywhere. */
-    readonly booking?: readonly BookingWidget[];
+    /**
+     * The vendors of the booking widgets the site embeds anywhere: their
+     * storage is on the site's domain, where the analytics settings cannot
+     * see it.
+     */
+    readonly booking?: readonly BookingVendor[];
     /**
      * Rows the site sets first, then by what has to be granted — nothing,
      * analytics, marketing — and otherwise in catalog order. Off, the rows
@@ -283,7 +281,7 @@ const BOOKING = {
         tab: ["forescape"],
     },
 } as const satisfies Record<
-    BookingWidget,
+    BookingVendor,
     { readonly kept: readonly string[]; readonly tab: readonly string[] }
 >;
 

package/src/astro/BookingWidget.astro

@@ -0,0 +1,31 @@
+---
+/**
+ * A booking widget, whatever its vendor: the one place that picks the
+ * vendor's component, so a site passes what its config holds and nothing
+ * else. Attributes go to that component's element.
+ *
+ * ```astro
+ * <BookingWidget widget={settings.booking} locale={locale} class="my-8" />
+ * ```
+ */
+import type { HTMLAttributes } from "astro/types";
+import type { BookingWidget } from "../booking/widget.ts";
+import FourEscape from "./FourEscape.astro";
+
+type Props = HTMLAttributes<"div"> & {
+    readonly widget: BookingWidget;
+    /** The page's: the widget speaks it when its vendor has it. */
+    readonly locale: string;
+};
+
+const { widget, locale, ...attrs } = Astro.props;
+---
+
+{widget.vendor === "4escape" && (
+    <FourEscape
+        {...attrs}
+        widgetId={widget.widgetId}
+        domain={widget.domain}
+        locale={locale}
+    />
+)}

package/src/booking/widget.ts

@@ -0,0 +1,10 @@
+import type { FourEscapeWidget } from "./four-escape.ts";
+
+/**
+ * A booking widget a site embeds, by its vendor: what a site's config names,
+ * and what picks the component that draws it.
+ */
+export type BookingWidget = { readonly vendor: "4escape" } & FourEscapeWidget;
+
+/** Who makes a booking widget: what `storedItems` takes for their rows. */
+export type BookingVendor = BookingWidget["vendor"];

package/src/index.ts

@@ -45,7 +45,6 @@ export {
 } from "./analytics/index.ts";
 export {
     type AtlasStoredId,
-    type BookingWidget,
     compareStoredItems,
     type Lifetime,
     STORAGE_VENDOR_NAMES,
@@ -66,6 +65,7 @@ export {
     fourEscapeLanguage,
     fourEscapeSettings,
 } from "./booking/four-escape.ts";
+export type { BookingVendor, BookingWidget } from "./booking/widget.ts";
 export type {
     LanguageTag,
     LocaleMeta,