@escape-game-over/atlas 0.1.84 → 0.1.86

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/docs/client-scripts.md

@@ -521,6 +521,12 @@ is what every embed needs and has no taste in:
 - **Focus moves to the player.** The button that had it has just left the page,
   which would drop a keyboard reader back at the top of the document.
 
+Two choices stay with the project. `rel` lets the player suggest videos from
+other channels, and is off by default, so `rel=0` keeps the suggestions to the
+channel's own; YouTube has no setting that removes them altogether. `playsInline`
+keeps the video in the page on an iPhone rather than going full screen on the
+press.
+
 `frame` is called after all of that and before the iframe is in the page, so its
 word is the last one and nothing is drawn unstyled first.
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@escape-game-over/atlas",
-    "version": "0.1.84",
+    "version": "0.1.86",
     "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/astro/youtube.ts

@@ -55,6 +55,19 @@ export interface YouTubeEmbedOptions {
      * player has no way to tell which video it is.
      */
     readonly title: string;
+    /**
+     * Whether the player may suggest videos from other channels. Off unless
+     * asked for: with `rel=0` it suggests only the channel's own, so a trailer
+     * on a project's page does not end on someone else's video.
+     *
+     * YouTube has no setting that removes the suggestions altogether.
+     */
+    readonly rel?: boolean;
+    /**
+     * Whether an iPhone plays the video in the page rather than taking it
+     * full screen on the press.
+     */
+    readonly playsInline?: boolean;
     /**
      * Anything the project wants on the iframe — classes, above all.
      *
@@ -106,7 +119,7 @@ const ALLOW =
     "accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share";
 
 export function youtubeEmbed(options: YouTubeEmbedOptions): YouTubeEmbed {
-    const { id, title, frame } = options;
+    const { id, title, rel = false, playsInline = false, frame } = options;
 
     if (!VIDEO_ID.test(id)) {
         throw new Error(
@@ -122,7 +135,10 @@ export function youtubeEmbed(options: YouTubeEmbedOptions): YouTubeEmbed {
     // `youtube-nocookie.com` rather than `youtube.com`: the same player, which
     // sets no cookie until the video is played — and here it is only ever
     // loaded to be played, so nothing is lost by it.
-    const src = `https://www.youtube-nocookie.com/embed/${id}?autoplay=1`;
+    const url = new URL(`https://www.youtube-nocookie.com/embed/${id}`);
+    url.searchParams.set("autoplay", "1");
+    url.searchParams.set("rel", rel ? "1" : "0");
+    if (playsInline) url.searchParams.set("playsinline", "1");
 
     return {
         attach(trigger, container) {
@@ -133,7 +149,7 @@ export function youtubeEmbed(options: YouTubeEmbedOptions): YouTubeEmbed {
                 () => {
                     const iframe =
                         container.ownerDocument.createElement("iframe");
-                    iframe.src = src;
+                    iframe.src = url.href;
                     iframe.title = title;
                     iframe.allow = ALLOW;
                     iframe.allowFullscreen = true;

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>,