@escape-game-over/atlas 0.1.42 → 0.1.43

package/package.json

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

package/src/astro/Document.astro

@@ -10,6 +10,9 @@
  * `restoreScroll={false}`: the router keeps its own position in the same
  * history state.
  *
+ * A site with a lead form passes `rememberCampaign`, so the `utm_*` tags a
+ * visit landed with survive to the page the form is on; see `attribution.ts`.
+ *
  * ```astro
  * <Document meta={meta} html={{ class: "scroll-smooth" }} body={{ class: "…" }}>
  *     <Fragment slot="head"><link rel="preload" … /></Fragment>
@@ -20,6 +23,7 @@
 import type { HTMLAttributes } from "astro/types";
 import type { PageMeta } from "../site/index.ts";
 import MetaTags from "./MetaTags.astro";
+import RememberCampaign from "./RememberCampaign.astro";
 import ScrollRestore from "./ScrollRestore.astro";
 
 interface Props {
@@ -29,9 +33,17 @@ interface Props {
     readonly body?: HTMLAttributes<"body">;
     /** Defaults to `true`; `false` for a site on `ClientRouter`. */
     readonly restoreScroll?: boolean;
+    /** Off unless stated: a site with no lead form has nothing to keep them for. */
+    readonly rememberCampaign?: boolean;
 }
 
-const { meta, html, body, restoreScroll = true } = Astro.props;
+const {
+    meta,
+    html,
+    body,
+    restoreScroll = true,
+    rememberCampaign = false,
+} = Astro.props;
 ---
 
 <!doctype html>
@@ -49,5 +61,6 @@ const { meta, html, body, restoreScroll = true } = Astro.props;
         <MetaTags tags={meta.bodyTags} />
         <slot />
         {restoreScroll && <ScrollRestore />}
+        {rememberCampaign && <RememberCampaign />}
     </body>
 </html>

package/src/astro/RememberCampaign.astro

@@ -0,0 +1,11 @@
+---
+/**
+ * Keeps the campaign tags a visit landed with for the tab, so a lead form on
+ * another page can still report them — see `attribution.ts`.
+ *
+ * Rendered by `Document` when asked for. A bundled module rather than inline:
+ * the tags are wanted by a form, which cannot be sent before it runs.
+ */
+---
+
+<script src="./remember-campaign.ts" />

package/src/astro/remember-campaign.ts

@@ -0,0 +1,4 @@
+// Every page: a visit can land anywhere before it reaches a form.
+import { rememberCampaign } from "./attribution.ts";
+
+rememberCampaign();