@escape-game-over/atlas 0.1.113 → 0.1.115

package/README.md

@@ -109,7 +109,9 @@ declares, and `override` and every `override*` is a patch over it.
 The copy comes first so a deployment's other files can name its messages by
 key. Anything declared before the project, its venues or its settings, types a
 message as `CatalogKey<typeof messages>`: the default catalog's keys and the
-deployment's own, exactly the ones `t()` takes. A typo fails on its line.
+deployment's own, exactly the ones `t()` takes. A typo fails on its line. A
+field that only ever names one kind of message narrows to it:
+`CatalogKey<typeof messages, \`events.facts.${string}\`>`.
 
 ## The four steps
 

package/package.json

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

package/src/i18n/catalog.ts

@@ -36,10 +36,14 @@ export interface ProjectCatalog<Base, Published extends string, Override, Add> {
  *
  * What a site built from the project translates, so a key typed with it is
  * one `t()` takes as it is.
+ *
+ * `Family` narrows to one kind of message, for a field that only ever names
+ * that kind: `CatalogKey<typeof messages, \`events.facts.${string}\`>` is the
+ * event facts the catalog has, the base's and the project's own.
  */
-export type CatalogKey<C> =
+export type CatalogKey<C, Family extends string = string> =
     C extends ProjectCatalog<infer Base, string, unknown, infer Add>
-        ? StringKeys<Base> | StringKeys<Add>
+        ? Extract<StringKeys<Base> | StringKeys<Add>, Family>
         : never;
 
 /** The messages a site built from the catalog reads: the base's and its own. */

package/src/site/api.ts

@@ -1,3 +1,4 @@
+import type { AnalyticsSettings } from "../analytics/index.ts";
 import type { ResolvedLocaleMeta } from "../config.ts";
 import type {
     MessageBindings,
@@ -157,6 +158,14 @@ export interface Site<
      * value that then drifts from the one every page's `<head>` carries.
      */
     readonly themeColor: ThemeColor;
+    /**
+     * The project's analytics, as declared: what the site's pages load, and so
+     * what a consent banner and a storage notice must name.
+     *
+     * Exposed so shared code reads it here rather than from the linked project,
+     * whose file is one project's and not what every project guarantees.
+     */
+    readonly analytics: AnalyticsSettings | undefined;
     readonly localeMeta: Readonly<Record<L, ResolvedLocaleMeta>>;
     /** The site's `defaultFonts` with this project's `overrideFonts` applied. */
     readonly fonts: Fonts;

package/src/site/create.ts

@@ -880,6 +880,7 @@ export function createSite<
         url: siteUrl,
         siteName: project.siteName,
         themeColor: project.themeColor,
+        analytics: project.analytics,
         localeMeta,
         fonts,
         routes: enabledRouteIds,