@escape-game-over/atlas 0.1.83 → 0.1.84

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@escape-game-over/atlas",
-    "version": "0.1.83",
+    "version": "0.1.84",
     "type": "module",
     "description": "Typed, data-driven machinery for static multi-locale, multi-deployment Astro sites.",
     "private": false,
@@ -60,9 +60,9 @@
     "devDependencies": {
         "@biomejs/biome": "2.6.4",
         "@types/node": "26.6.6",
-        "@vitest/coverage-istanbul": "5.0.5",
-        "astro": "7.4.4",
+        "@vitest/coverage-istanbul": "5.1.0",
+        "astro": "7.4.5",
         "typescript": "6.0.3",
-        "vitest": "5.0.5"
+        "vitest": "5.1.0"
     }
 }

package/src/jsonld/organization.ts

@@ -5,6 +5,7 @@ import {
     type PostalAddress,
 } from "../contact.ts";
 import type { ImageAsset } from "../image.ts";
+import type { IsoDate } from "../types.ts";
 import { absoluteUrl, type HttpsUrl, joinUrl, type UrlPath } from "../url.ts";
 import { organizationId } from "./ids.ts";
 import { alternateName, type JsonLdNode } from "./node.ts";
@@ -15,6 +16,16 @@ export interface OrganizationInput {
     readonly name: string;
     /** The brand's own home. Also its identity, see `@id` below. */
     readonly url: HttpsUrl;
+    /**
+     * What the brand is, in a sentence. Google lists it as a recommended
+     * property of an organization.
+     */
+    readonly description?: string;
+    /**
+     * When the brand was founded: a full date, or just the year where that is
+     * all anyone can honestly state. Both are valid ISO 8601.
+     */
+    readonly foundingDate?: IsoDate | `${number}`;
     /**
      * Another name the brand actually goes by — an acronym, a short form.
      *
@@ -162,6 +173,12 @@ export function organization(brand: OrganizationInput): JsonLdNode {
         name: brand.name,
         url: brand.url,
         ...alternateName(brand.name, brand.alternateName),
+        ...(brand.description === undefined
+            ? {}
+            : { description: brand.description }),
+        ...(brand.foundingDate === undefined
+            ? {}
+            : { foundingDate: brand.foundingDate }),
         ...(brand.logo === undefined
             ? {}
             : { logo: joinUrl(brand.url, brand.logo) }),

package/src/llms.ts

@@ -68,6 +68,11 @@ export interface LlmsInput {
         readonly tag: string;
         readonly url: HttpsUrl;
     }[];
+    /**
+     * Whether any page's slug differs between languages. Decides what the file
+     * tells a reader about reaching the same page in another one.
+     */
+    readonly translatedSlugs?: boolean;
     readonly sections: readonly LlmsSection[];
 }
 
@@ -104,14 +109,18 @@ export function buildLlms(input: LlmsInput): GeneratedFile {
     // Which language the links are in, and how to get to the others — stated
     // only when there *are* others.
     //
-    // Not "swap the prefix": a slug is translated too, so the Greek `/about-us`
-    // is `/el-GR/sxetika-me-emas` and a reader told to substitute the prefix
-    // would construct a URL that 404s. The sitemap is where that mapping
-    // actually lives, one `xhtml:link` per page per language, so this points at
-    // it rather than describing a rule that does not hold.
+    // Whether "swap the prefix" works depends on the site, so it is stated only
+    // where it holds. Where a slug is translated, the Greek `/about-us` is
+    // `/el-GR/sxetika-me-emas` and a reader told to substitute the prefix would
+    // construct a URL that 404s; the sitemap is where that mapping lives, one
+    // `xhtml:link` per page per language.
     if (input.otherLanguages !== undefined && input.otherLanguages.length > 0) {
         lines.push(
-            `Every URL below is the ${input.language.tag} version. Other languages translate their slugs, so the same page is not this URL with a different prefix — the sitemap lists each page in every language.`,
+            `Every URL below is the ${input.language.tag} version. ${
+                input.translatedSlugs === true
+                    ? "Other languages might translate their slugs, so the same page is not always this URL with a different prefix —"
+                    : "Other languages use the same path under their own address above —"
+            } the sitemap lists each page in every language.`,
             ""
         );
     }

package/src/site/create.ts

@@ -761,6 +761,18 @@ export function createSite<
                 tag: localeMeta[other].htmlLang,
                 url: joinUrl(siteUrl, buildPath("", other, pathContext)),
             })),
+            // Read off the routes, so the file cannot claim something the URLs
+            // do not do.
+            translatedSlugs: enabledRouteIds.some((id) => {
+                const route = resolved[id];
+                return (
+                    route !== undefined &&
+                    others.some(
+                        (other) =>
+                            slugFor(route, other) !== slugFor(route, locale)
+                    )
+                );
+            }),
             sections,
         });
     }