@escape-game-over/atlas 0.1.24 → 0.1.26

package/src/index.ts

@@ -1,27 +1,19 @@
 /**
  * The public API. A consuming project should need nothing outside this module.
  *
- * The flow is four steps, each inferring its types from the values of the last:
+ * Everything starts from `defineSite`:
  *
  * ```ts
- * // 1. site.config.ts — which languages exist, how URLs are shaped
- * export default defineSiteConfig({ locales: {...}, defaultRouting: {...} })
- *
- * // 2. src/data — the base copy and routes
- * export const baseMessages = defineMessages(config, {...})
- * export const baseRoutes   = defineRoutes(config, {...})
- *
- * // 3. projects/<name>/project.ts — one deployment's overlay
- * export default defineProject(config, baseMessages, baseRoutes, {...})
- *
- * // 4. src/site.ts — the API the pages use
- * export const site = createSite(config, baseMessages, baseRoutes, project)
+ * export const atlas = defineSite({ locales: {...}, defaultRouting: {...} })  // site.config.ts
+ * export const defaultMessages = atlas.messages({...})                        // messages.ts
+ * export const defaultRoutes = atlas.routes({...})                            // routes.ts
+ * export default atlas.project(defaultMessages, defaultRoutes, {...})         // projects/<name>/project.ts
+ * export const site = atlas.site(defaultMessages, defaultRoutes, project)     // site.ts
  * ```
  */
 
 export {
     type AnalyticsSettings,
-    type AnalyticsTag,
     type AnalyticsTags,
     CONSENT_UPDATE_GLOBAL,
     type ConsentDefaults,
@@ -32,14 +24,13 @@ export {
     type UmamiSettings,
     type UmamiTracker,
 } from "./analytics/index.ts";
-export {
-    defineSiteConfig,
-    type LanguageTag,
-    type LocaleMeta,
-    type LocalesOf,
-    type ResolvedLocaleMeta,
-    type RoutingConfig,
-    type SiteConfigShape,
+export type {
+    LanguageTag,
+    LocaleMeta,
+    LocalesOf,
+    ResolvedLocaleMeta,
+    RoutingConfig,
+    SiteConfigShape,
 } from "./config.ts";
 export {
     assertCoordinates,
@@ -100,13 +91,11 @@ export {
     type Weekday,
     type WeeklyHours,
 } from "./hours.ts";
-export {
-    type BaseCatalog,
-    type CatalogCovers,
-    defineMessageOverrides,
-    defineMessages,
-    type MessageOverrides,
-    type OverrideCatalog,
+export type {
+    BaseCatalog,
+    CatalogCovers,
+    MessageOverrides,
+    OverrideCatalog,
 } from "./i18n/define.ts";
 export type {
     EntryPlaceholders,
@@ -171,10 +160,8 @@ export {
     type ArticleContent,
     buildMeta,
     buildNotFoundMeta,
-    type ImageFormat,
     type MetaContent,
     type MetaTag,
-    type OgImage,
     type OpenGraphType,
     type PageKind,
     type RobotsPolicy,
@@ -197,7 +184,7 @@ export {
     type TieredPrice,
     tierRange,
 } from "./money.ts";
-export { defineProject, type ProjectInput } from "./project.ts";
+export type { ProjectInput } from "./project.ts";
 export {
     buildCloudflareRedirects,
     buildRedirects,
@@ -212,15 +199,14 @@ export {
     type ValidateRedirectTargets,
 } from "./redirects.ts";
 export type { RobotsConfig, RobotsGroup } from "./robots.ts";
-export {
-    type ChangeFreq,
-    defineRouteOverrides,
-    defineRoutes,
-    type EnabledRouteIdFor,
-    type RouteData,
-    type RouteOverride,
-    type RouteRegistry,
-    type RouteSitemap,
+export type {
+    ChangeFreq,
+    EnabledRouteIdFor,
+    RouteData,
+    RouteOverride,
+    RouteOverrides,
+    RouteRegistry,
+    RouteSitemap,
 } from "./routes/define.ts";
 export {
     enableRoutes,
@@ -229,24 +215,21 @@ export {
     type FamilyOptions,
     familyGuard,
     type RouteIdsOf,
-    routeFamily,
 } from "./routes/family.ts";
 export type { RouteEntry } from "./routes/resolve.ts";
-export {
-    type Alternate,
-    type Crumb,
-    createSite,
-    type LinkOptions,
-    type LlmsOptions,
-    type LocaleLink,
-    type PageContent,
-    type PageMeta,
-    type PageProps,
-    type PerRoute,
-    type RouteIdOf,
-    type Site,
-    type StaticPath,
-    type WhenEnabled,
+export { defineSite } from "./site/define.ts";
+export type {
+    Alternate,
+    Crumb,
+    LinkOptions,
+    LlmsOptions,
+    LocaleLink,
+    PageContent,
+    PageMeta,
+    PageProps,
+    PerRoute,
+    Site,
+    StaticPath,
 } from "./site/index.ts";
 export type { Sitemap, SitemapConfig } from "./sitemap.ts";
 export type { IsoDate, Letter, StringKeys } from "./types.ts";

package/src/meta/index.ts

@@ -29,6 +29,7 @@ import {
     notFoundAnalytics,
 } from "../analytics/index.ts";
 import type { ResolvedLocaleMeta } from "../config.ts";
+import type { ImageAsset } from "../image.ts";
 import {
     article,
     type BreadcrumbStep,
@@ -42,11 +43,10 @@ import { robotsContent, warnAboutRobots } from "./robots.ts";
 import {
     iconLinks,
     type OgImage,
-    type SiteIcon,
     warnAboutShareImage,
     warnIfClipped,
 } from "./share-image.ts";
-import { asMetaTag, link, type MetaTag, meta, preamble } from "./tag.ts";
+import { link, type MetaTag, meta, preamble } from "./tag.ts";
 import { type SiteVerification, verificationTags } from "./verification.ts";
 
 export type {
@@ -57,13 +57,7 @@ export type {
     ThemeColor,
 } from "./content.ts";
 export type { RobotsDirective, RobotsPolicy } from "./robots.ts";
-export {
-    type ImageFormat,
-    type OgImage,
-    resolveShareImage,
-    type ShareImage,
-    type SiteIcon,
-} from "./share-image.ts";
+export { resolveShareImage, type ShareImage } from "./share-image.ts";
 export type { MetaTag } from "./tag.ts";
 export type { SiteVerification } from "./verification.ts";
 
@@ -155,7 +149,7 @@ interface MetaInputDerived<L extends string> extends ChromeInput {
  */
 export interface ChromeInput {
     /** The site's square icon, used for every icon link. */
-    readonly icon: SiteIcon;
+    readonly icon: ImageAsset;
     /**
      * Tints the browser UI — Android Chrome's bar, iOS Safari, an installed PWA.
      * Two values emit one tag per `prefers-color-scheme`.
@@ -250,8 +244,8 @@ export function buildMeta<L extends string>(input: MetaInput<L>): DocumentTags {
     // that must precede every tag reading them, and a tag that got there first
     // would silently apply the permissive implicit default instead.
     const analytics = analyticsScripts(input.analytics, input.canonical);
-    for (const script of analytics.head) tags.push(asMetaTag(script));
-    const bodyTags: MetaTag[] = analytics.body.map(asMetaTag);
+    tags.push(...analytics.head);
+    const bodyTags: MetaTag[] = [...analytics.body];
 
     if (input.llmsUrl !== undefined) {
         // Points a client at the file describing this page, per llmstxt.org.
@@ -473,7 +467,7 @@ export function buildNotFoundMeta(input: NotFoundInput): MetaTag[] {
             name: "robots",
             content: robotsContent({ index: false, follow: true }),
         }),
-        ...notFoundAnalytics(input.analytics).map(asMetaTag),
+        ...notFoundAnalytics(input.analytics),
         ...chromeTags(input),
     ];
 }

package/src/meta/share-image.ts

@@ -3,14 +3,7 @@ import { absoluteUrl, type HttpsUrl } from "../url.ts";
 import { warn } from "../warn.ts";
 import { link, type MetaTag } from "./tag.ts";
 
-export type ImageFormat =
-    | "png"
-    | "jpg"
-    | "jpeg"
-    | "webp"
-    | "avif"
-    | "gif"
-    | "svg";
+type ImageFormat = "png" | "jpg" | "jpeg" | "webp" | "avif" | "gif" | "svg";
 
 const IMAGE_MIME: Readonly<Record<ImageFormat, string>> = {
     png: "image/png",
@@ -85,23 +78,6 @@ export interface ShareImage {
     readonly alt: string;
 }
 
-/**
- * The site's icon: one square asset, used for every icon link.
- *
- * Site-wide rather than per page, because search engines use one favicon per
- * hostname, read from the home page — a per-page icon changes the browser tab
- * and nothing else.
- *
- * One asset rather than a set, because one square PNG already covers every
- * consumer: browsers accept PNG for `rel="icon"`, and Apple scales it for
- * `apple-touch-icon`. A `/favicon.ico` in `public/` is still requested by
- * browsers on its own if you want the legacy fallback.
- *
- * Unlike `og:image`, the href stays as written — root-relative is correct for an
- * icon, and absolutising it would only hard-code the origin.
- */
-export type SiteIcon = ImageAsset;
-
 /** One page's resolved share image. */
 export interface OgImage {
     readonly url: HttpsUrl;
@@ -229,7 +205,7 @@ export function resolveShareImage(
  * already has the page, so root-relative is correct and making it absolute would
  * only hard-code the origin.
  */
-export function iconLinks(icon: SiteIcon): MetaTag[] {
+export function iconLinks(icon: ImageAsset): MetaTag[] {
     const mime = imageMime(icon.format);
     const attrs = {
         href: icon.src,

package/src/meta/tag.ts

@@ -1,11 +1,4 @@
-import type { AnalyticsTag } from "../analytics/index.ts";
-
-/**
- * A head tag as data, not markup.
- *
- * lib does not render HTML — that would tie it to one framework and to one
- * templating syntax. It describes the tags; the consumer spreads them.
- */
+/** A head tag as data; `AtlasDocument` renders it. */
 export type MetaTag =
     | { readonly kind: "title"; readonly text: string }
     | {
@@ -68,43 +61,6 @@ export const link = (attrs: Readonly<Record<string, string>>): MetaTag => ({
     attrs,
 });
 
-/**
- * An analytics tag as a head tag. The two vocabularies overlap but are not the
- * same type: `analytics/` knows nothing of `MetaTag`, which is what keeps this
- * folder free to import it without a cycle.
- *
- * Every kind is named rather than left to a trailing `else`, so that adding one
- * to `AnalyticsTag` and forgetting it here is a *compile* error and not a tag
- * that quietly disappears: `script` narrows to `never` only while the list is
- * complete, and assigning anything else to `never` does not type-check.
- */
-export function asMetaTag(script: AnalyticsTag): MetaTag {
-    if (script.kind === "inline") {
-        return { kind: "script", content: script.content };
-    }
-    if (script.kind === "external") {
-        return {
-            kind: "externalScript",
-            src: script.src,
-            attrs: script.attributes,
-        };
-    }
-    if (script.kind === "noscriptFrame") {
-        return { kind: "noscriptFrame", src: script.src };
-    }
-    if (script.kind === "preconnect") {
-        // A `link` rather than a kind of its own: the head vocabulary already
-        // has the shape, and a preconnect is a link in every sense the renderer
-        // cares about. See `AnalyticsTag` for why no `crossorigin`.
-        return {
-            kind: "link",
-            attrs: { rel: "preconnect", href: script.origin },
-        };
-    }
-    const unhandled: never = script;
-    throw new Error(`Unhandled analytics tag: ${JSON.stringify(unhandled)}`);
-}
-
 const DEFAULT_VIEWPORT = "width=device-width, initial-scale=1";
 
 interface Preamble {

package/src/money.ts

@@ -1,13 +1,168 @@
-import type { Letter } from "./types.ts";
-
 /**
  * An ISO 4217 currency code: `"EUR"`, `"RON"`, `"GBP"`.
  *
- * Three uppercase letters, which is what `priceCurrency` is read as. A symbol —
- * `€`, `lei` — is how a price is *printed* in one place for one audience, and
- * two currencies can share one symbol, so it identifies nothing.
+ * A code rather than a symbol — `€`, `lei` — because two currencies can share a
+ * symbol, and `priceCurrency` is read as a code.
+ *
+ * Circulating currencies from ISO 4217 List One (SIX, published 2026-09-17):
+ * fund, precious-metal, testing and accounting-unit codes left out.
  */
-export type CurrencyCode = `${Letter}${Letter}${Letter}`;
+export type CurrencyCode =
+    | "AED"
+    | "AFN"
+    | "ALL"
+    | "AMD"
+    | "AOA"
+    | "ARS"
+    | "AUD"
+    | "AWG"
+    | "AZN"
+    | "BAM"
+    | "BBD"
+    | "BDT"
+    | "BHD"
+    | "BIF"
+    | "BMD"
+    | "BND"
+    | "BOB"
+    | "BRL"
+    | "BSD"
+    | "BTN"
+    | "BWP"
+    | "BYN"
+    | "BZD"
+    | "CAD"
+    | "CDF"
+    | "CHF"
+    | "CLP"
+    | "CNY"
+    | "COP"
+    | "CRC"
+    | "CUP"
+    | "CVE"
+    | "CZK"
+    | "DJF"
+    | "DKK"
+    | "DOP"
+    | "DZD"
+    | "EGP"
+    | "ERN"
+    | "ETB"
+    | "EUR"
+    | "FJD"
+    | "FKP"
+    | "GBP"
+    | "GEL"
+    | "GHS"
+    | "GIP"
+    | "GMD"
+    | "GNF"
+    | "GTQ"
+    | "GYD"
+    | "HKD"
+    | "HNL"
+    | "HTG"
+    | "HUF"
+    | "IDR"
+    | "ILS"
+    | "INR"
+    | "IQD"
+    | "IRR"
+    | "ISK"
+    | "JMD"
+    | "JOD"
+    | "JPY"
+    | "KES"
+    | "KGS"
+    | "KHR"
+    | "KMF"
+    | "KPW"
+    | "KRW"
+    | "KWD"
+    | "KYD"
+    | "KZT"
+    | "LAK"
+    | "LBP"
+    | "LKR"
+    | "LRD"
+    | "LSL"
+    | "LYD"
+    | "MAD"
+    | "MDL"
+    | "MGA"
+    | "MKD"
+    | "MMK"
+    | "MNT"
+    | "MOP"
+    | "MRU"
+    | "MUR"
+    | "MVR"
+    | "MWK"
+    | "MXN"
+    | "MYR"
+    | "MZN"
+    | "NAD"
+    | "NGN"
+    | "NIO"
+    | "NOK"
+    | "NPR"
+    | "NZD"
+    | "OMR"
+    | "PAB"
+    | "PEN"
+    | "PGK"
+    | "PHP"
+    | "PKR"
+    | "PLN"
+    | "PYG"
+    | "QAR"
+    | "RON"
+    | "RSD"
+    | "RUB"
+    | "RWF"
+    | "SAR"
+    | "SBD"
+    | "SCR"
+    | "SDG"
+    | "SEK"
+    | "SGD"
+    | "SHP"
+    | "SLE"
+    | "SOS"
+    | "SRD"
+    | "SSP"
+    | "STN"
+    | "SVC"
+    | "SYP"
+    | "SZL"
+    | "THB"
+    | "TJS"
+    | "TMT"
+    | "TND"
+    | "TOP"
+    | "TRY"
+    | "TTD"
+    | "TWD"
+    | "TZS"
+    | "UAH"
+    | "UGX"
+    | "USD"
+    | "UYU"
+    | "UZS"
+    | "VED"
+    | "VES"
+    | "VND"
+    | "VUV"
+    | "WST"
+    | "XAF"
+    | "XCD"
+    | "XCG"
+    | "XOF"
+    | "XPF"
+    | "YER"
+    | "ZAR"
+    | "ZMW"
+    | "ZWG";
 
 /**
  * An amount and what it is denominated in, kept together.