@escape-game-over/atlas 0.1.84 → 0.1.85

package/README.md

@@ -109,6 +109,10 @@ export const { project, redirects } = atlas.project(baseMessages, baseRoutes, {.
 export const site = atlas.site(baseMessages, baseRoutes, project)
 ```
 
+A site that publishes one language under several regions writes the words once:
+`atlas.perLanguage({ en: "Home", fr: "Accueil" })` fills in `en-GB`, `en-IE` and
+`fr-FR` for one entry of `atlas.messages`, with placeholders still checked.
+
 Step 4 returns `t()`, `rich()`, `plain()`, `pathFor()`, `urlFor()`, `fileUrl()`,
 `localeLinksFor()`, `metaFor()`, `breadcrumbFor()`,
 `getStaticPaths()`, `routes`, `sitemap()`, `robots()` and `llms()` already

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@escape-game-over/atlas",
-    "version": "0.1.84",
+    "version": "0.1.85",
     "type": "module",
     "description": "Typed, data-driven machinery for static multi-locale, multi-deployment Astro sites.",
     "private": false,
@@ -58,7 +58,7 @@
         "vite": ">= 8"
     },
     "devDependencies": {
-        "@biomejs/biome": "2.6.4",
+        "@biomejs/biome": "2.6.5",
         "@types/node": "26.6.6",
         "@vitest/coverage-istanbul": "5.1.0",
         "astro": "7.4.5",

package/src/i18n/per-language.ts

@@ -0,0 +1,45 @@
+/** `"en"` for `"en-GB"`: everything before the first dash. */
+export type LanguageOf<L extends string> =
+    L extends `${infer Language}-${string}` ? Language : never;
+
+/**
+ * Every locale, holding its language's text.
+ *
+ * Keeps each string's literal type, so a message built this way has its
+ * placeholders checked exactly like one written out by hand.
+ */
+export type PerLanguage<L extends string, T> = {
+    readonly [K in L]: T[LanguageOf<K> & keyof T];
+};
+
+/**
+ * One message, written once per language and filled in for each of its tags.
+ *
+ * For a site that publishes one language under several regions, where `en-GB`
+ * and `en-IE` are different tags for `hreflang` but the same words. Checked here
+ * as well as in the types, because the cast below stops the compiler seeing
+ * this body, and a caller's `as any` would otherwise publish `undefined`.
+ */
+export function expandLanguages<L extends string, T>(
+    locales: readonly L[],
+    texts: T
+): PerLanguage<L, T> {
+    const given = texts as Readonly<Record<string, string>>;
+    const languages = new Set(locales.map((tag) => tag.split("-")[0]));
+    for (const language of Object.keys(given)) {
+        if (!languages.has(language)) {
+            throw new Error(
+                `perLanguage: "${language}" is not a language this site declares.`
+            );
+        }
+    }
+    const entries = locales.map((tag) => {
+        const language = tag.split("-")[0] as string;
+        const text = given[language];
+        if (text === undefined) {
+            throw new Error(`perLanguage: no text for "${language}" (${tag}).`);
+        }
+        return [tag, text];
+    });
+    return Object.fromEntries(entries) as PerLanguage<L, T>;
+}

package/src/site/define.ts

@@ -10,6 +10,11 @@ import {
     type NoExtraLocales,
     type ValidateBase,
 } from "../i18n/define.ts";
+import {
+    expandLanguages,
+    type LanguageOf,
+    type PerLanguage,
+} from "../i18n/per-language.ts";
 import {
     bindRedirects,
     type DefinedProject,
@@ -86,6 +91,13 @@ export function defineSite<
             return defineMessages(config, catalog as never) as T;
         },
 
+        /** One message per language, filled in for each of that language's tags. */
+        perLanguage<const T extends Readonly<Record<LanguageOf<L>, string>>>(
+            texts: T & Readonly<Record<Exclude<keyof T, LanguageOf<L>>, never>>
+        ): PerLanguage<L, T> {
+            return expandLanguages(Object.keys(config.locales) as L[], texts);
+        },
+
         /** One deployment: what differs from the defaults. */
         project<
             const Catalog extends BaseCatalog<L>,