@escape-game-over/atlas 0.1.68 → 0.1.69

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@escape-game-over/atlas",
-    "version": "0.1.68",
+    "version": "0.1.69",
     "type": "module",
     "description": "Typed, data-driven machinery for static multi-locale, multi-deployment Astro sites.",
     "private": false,
@@ -34,7 +34,7 @@
         "README.md"
     ],
     "engines": {
-        "node": ">=22.12.0"
+        "node": ">=24.0.0"
     },
     "scripts": {
         "test": "npm run test:types && npm run test:unit && npm run test:examples",

package/src/config.ts

@@ -2,20 +2,21 @@ import type { Fonts } from "./fonts.ts";
 import type { LlmsConfig } from "./llms.ts";
 import type { RobotsConfig } from "./robots.ts";
 import type { SitemapConfig } from "./sitemap.ts";
-import type { StringKeys } from "./types.ts";
+import type { NoExcessKeys, StringKeys } from "./types.ts";
 
 export interface LocaleMeta {
     /** Name of the language, written in that language. */
     readonly label: string;
     // No language tag here: the locale's own key is the tag. One identifier,
     // used for the URL segment, `lang`, `hreflang` and `og:locale` alike.
-    readonly dir: "ltr" | "rtl";
+    // No `dir` either: writing direction follows from the tag too.
 }
 
 /** `LocaleMeta` after defaults are filled in. */
 export interface ResolvedLocaleMeta {
     readonly label: string;
     readonly htmlLang: string;
+    /** Derived: the writing direction of the tag's script, from `Intl`. */
     readonly dir: "ltr" | "rtl";
     /** Derived: `htmlLang` with `-` swapped for `_`, which is the OG form. */
     readonly ogLocale: string;
@@ -55,7 +56,7 @@ interface MalformedLanguageTag<T extends string> {
 type ValidateLocales<T> = {
     [K in StringKeys<T>]: [LanguageTag<K>] extends [never]
         ? MalformedLanguageTag<K>
-        : LocaleMeta;
+        : LocaleMeta & NoExcessKeys<T[K], keyof LocaleMeta>;
 };
 
 export interface RoutingConfig<L extends string> {
@@ -156,10 +157,9 @@ export function defineSiteConfig<
 /**
  * What a project may restate about a locale.
  *
- * `dir` is deliberately not here: writing direction is a fact about the script a
- * language is written in, not a choice a deployment makes. Greek is
- * left-to-right for everybody, and a project that could say otherwise would only
- * ever be wrong. The label is the one part that is a matter of taste.
+ * Only the label: writing direction is a fact about the script a language is
+ * written in, not a choice a deployment makes, so it is derived from the tag.
+ * The label is the one part that is a matter of taste.
  */
 export type LocaleMetaOverride = Pick<LocaleMeta, "label">;
 
@@ -184,6 +184,8 @@ export interface LocaleNotEnabled<L extends string> {
  *
  * The locale key is the language tag, and `ogLocale` is that tag with `-`
  * swapped for `_` — Open Graph writes `en_US` where BCP 47 writes `en-US`.
+ * `dir` comes from the tag's script, so `ar-EG` and `az-Arab-IR` are
+ * right-to-left and `az-AZ` is not.
  */
 export function mergeLocaleMeta<L extends string>(
     base: Readonly<Record<L, LocaleMeta>>,
@@ -199,10 +201,20 @@ export function mergeLocaleMeta<L extends string>(
         const meta = { ...defaults, ...overrides?.[locale] };
         merged[locale] = {
             label: meta.label,
-            dir: meta.dir,
+            dir: writingDirection(locale),
             htmlLang: locale,
             ogLocale: locale.replace(/-/g, "_"),
         };
     }
     return merged as Readonly<Record<L, ResolvedLocaleMeta>>;
 }
+
+function writingDirection(tag: string): "ltr" | "rtl" {
+    const direction = new Intl.Locale(tag).getTextInfo().direction;
+    if (direction === undefined) {
+        throw new Error(
+            `This runtime cannot tell the writing direction of "${tag}".`
+        );
+    }
+    return direction;
+}