@cloudhal/cli 0.0.0-stage → 0.1.0

package/dist/assets/starters/blog/src/settings.ts

@@ -0,0 +1,312 @@
+/**
+ * This theme's design settings (RFC-0017 §1): what Studio's Appearance form, agents
+ * (`get_theme_settings` / `set_theme_settings`) and the generator may change about its look.
+ * The site's values live in `Site.theme.config`, are checked against this schema, and reach the
+ * page as CSS variables and `data-ch-*` attributes (`themeVariables` in `layouts/Base.astro`,
+ * used by `styles/features/*.css`). Defaults keep the starter's look.
+ *
+ * Keep this file data only, with type imports only (the CLI loads it on its own).
+ */
+import type { PropsSchema } from "@cloudhal/core-ts/blocks";
+
+export const themeSettings: PropsSchema = {
+  type: "object",
+  additionalProperties: false,
+  properties: {
+    // RFC-0023 §1: one seed color and three choices; the color roles (and dark mode) follow.
+    // Without a seed (and in light mode) the four colors below apply, as before.
+    seed: {
+      type: "string",
+      format: "color",
+      title: { en: "Seed color", tr: "Ana renk" },
+      description: {
+        en: "One color the whole palette is built from, light and dark, always readable.",
+        tr: "Tüm paletin, açık ve koyu, okunaklı kalarak üretildiği tek renk.",
+      },
+    },
+    scheme: {
+      type: "string",
+      enum: ["tonal", "vibrant", "neutral", "mono"],
+      "x-labels": {
+        tonal: { en: "Tonal", tr: "Tonlu" },
+        vibrant: { en: "Vibrant", tr: "Canlı" },
+        neutral: { en: "Neutral", tr: "Nötr" },
+        mono: { en: "Monochrome", tr: "Tek renk" },
+      },
+      default: "tonal",
+      "x-widget": "radio",
+      title: { en: "Palette", tr: "Palet" },
+    },
+    contrast: {
+      type: "string",
+      enum: ["standard", "high"],
+      "x-labels": {
+        standard: { en: "Standard (AA)", tr: "Standart (AA)" },
+        high: { en: "High (AAA)", tr: "Yüksek (AAA)" },
+      },
+      default: "standard",
+      title: { en: "Contrast", tr: "Kontrast" },
+    },
+    mode: {
+      type: "string",
+      enum: ["light", "dark", "auto"],
+      "x-labels": {
+        light: { en: "Light", tr: "Açık" },
+        dark: { en: "Dark", tr: "Koyu" },
+        auto: { en: "Follow the reader", tr: "Okura göre" },
+      },
+      default: "light",
+      "x-widget": "radio",
+      title: { en: "Mode", tr: "Mod" },
+    },
+    brand: {
+      type: "string",
+      format: "color",
+      default: "#18181b",
+      title: { en: "Brand color", tr: "Marka rengi" },
+      description: { en: "Buttons and calls to action.", tr: "Butonlar ve çağrılar." },
+    },
+    link: {
+      type: "string",
+      format: "color",
+      default: "#0369a1",
+      title: { en: "Link color", tr: "Bağlantı rengi" },
+    },
+    surface: {
+      type: "string",
+      format: "color",
+      default: "#ffffff",
+      title: { en: "Background", tr: "Arka plan" },
+    },
+    text: {
+      type: "string",
+      format: "color",
+      default: "#18181b",
+      title: { en: "Text", tr: "Metin" },
+    },
+    // RFC-0023 §2: a curated font pairing (self-hosted in public/fonts) and a fluid type scale.
+    // Without a pairing the typeface below applies; without a scale the sizes stay fixed.
+    typePairing: {
+      type: "string",
+      enum: ["system", "editorial", "modern", "humanist", "technical", "classic"],
+      "x-labels": {
+        system: { en: "System", tr: "Sistem" },
+        editorial: { en: "Editorial (Fraunces and Inter)", tr: "Editoryal (Fraunces ve Inter)" },
+        modern: { en: "Modern (Space Grotesk and Inter)", tr: "Modern (Space Grotesk ve Inter)" },
+        humanist: { en: "Humanist (Source Sans)", tr: "Hümanist (Source Sans)" },
+        technical: {
+          en: "Technical (JetBrains Mono and Inter)",
+          tr: "Teknik (JetBrains Mono ve Inter)",
+        },
+        classic: { en: "Classic (Source Serif)", tr: "Klasik (Source Serif)" },
+      },
+      default: "system",
+      title: { en: "Font pairing", tr: "Yazı tipi eşleşmesi" },
+      description: {
+        en: "Headings and text set in fonts that go together. System uses the typeface below.",
+        tr: "Başlıklar ve metin birbirine uyan yazı tipleriyle. Sistem, aşağıdaki yazı tipini kullanır.",
+      },
+    },
+    typeScale: {
+      type: "string",
+      enum: ["compact", "balanced", "dramatic"],
+      "x-labels": {
+        compact: { en: "Compact", tr: "Sıkı" },
+        balanced: { en: "Balanced", tr: "Dengeli" },
+        dramatic: { en: "Dramatic", tr: "Çarpıcı" },
+      },
+      "x-widget": "radio",
+      title: { en: "Type scale", tr: "Yazı ölçeği" },
+      description: {
+        en: "How much bigger headings are than text; sizes adapt to the screen.",
+        tr: "Başlıkların metinden ne kadar büyük olduğu; boyutlar ekrana uyar.",
+      },
+    },
+    font: {
+      type: "string",
+      enum: ["system", "serif", "humanist", "mono"],
+      "x-labels": {
+        system: { en: "System", tr: "Sistem" },
+        serif: { en: "Serif", tr: "Tırnaklı" },
+        humanist: { en: "Humanist", tr: "Hümanist" },
+        mono: { en: "Monospace", tr: "Eş aralıklı" },
+      },
+      default: "system",
+      "x-widget": "radio",
+      title: { en: "Typeface", tr: "Yazı tipi" },
+    },
+    // RFC-0023 §3: corners for buttons, fields, cards and bands, and how much room things get.
+    radius: {
+      type: "string",
+      enum: ["none", "small", "medium", "large", "full"],
+      "x-labels": {
+        none: { en: "Square", tr: "Köşeli" },
+        small: { en: "Slightly rounded", tr: "Hafif yuvarlak" },
+        medium: { en: "Medium", tr: "Orta" },
+        large: { en: "Rounded", tr: "Yuvarlak" },
+        full: { en: "Pill buttons", tr: "Hap düğmeler" },
+      },
+      default: "small",
+      title: { en: "Corners", tr: "Köşeler" },
+    },
+    density: {
+      type: "string",
+      enum: ["compact", "cozy", "airy"],
+      "x-labels": {
+        compact: { en: "Compact", tr: "Sıkı" },
+        cozy: { en: "Cozy", tr: "Rahat" },
+        airy: { en: "Airy", tr: "Ferah" },
+      },
+      default: "cozy",
+      "x-widget": "radio",
+      title: { en: "Spacing", tr: "Boşluk" },
+      description: {
+        en: "How much room sections, cards and buttons get.",
+        tr: "Bölümlerin, kartların ve düğmelerin ne kadar yer kapladığı.",
+      },
+    },
+    // RFC-0024 §1: how much the site moves; a page can set its own level, and readers who ask for
+    // reduced motion always get less.
+    motion: {
+      type: "string",
+      enum: ["none", "subtle", "standard", "expressive"],
+      "x-labels": {
+        none: { en: "Still", tr: "Durağan" },
+        subtle: { en: "Subtle", tr: "İnce" },
+        standard: { en: "Standard", tr: "Standart" },
+        expressive: { en: "Expressive", tr: "Etkileyici" },
+      },
+      default: "none",
+      "x-widget": "radio",
+      title: { en: "Motion", tr: "Hareket" },
+      description: {
+        en: "How much sections move as people scroll and point. Readers who ask for reduced motion always see less.",
+        tr: "Bölümlerin kaydırırken ve üzerine gelirken ne kadar hareket ettiği. Daha az hareket isteyen okurlar her zaman daha azını görür.",
+      },
+    },
+    // RFC-0024 §5: how one page gives way to the next.
+    pageTransition: {
+      type: "string",
+      enum: ["none", "crossfade", "slide", "morph"],
+      "x-labels": {
+        none: { en: "None", tr: "Yok" },
+        crossfade: { en: "Crossfade", tr: "Geçişli solma" },
+        slide: { en: "Slide", tr: "Kaydırma" },
+        morph: { en: "Morph shared parts", tr: "Ortak öğeleri dönüştür" },
+      },
+      default: "none",
+      "x-widget": "radio",
+      title: { en: "Page transition", tr: "Sayfa geçişi" },
+      description: {
+        en: "How one page gives way to the next, in browsers that support it.",
+        tr: "Bir sayfanın diğerine nasıl geçtiği (destekleyen tarayıcılarda).",
+      },
+    },
+    // RFC-0026 26c: how heavy the site's icons are drawn.
+    iconWeight: {
+      type: "string",
+      enum: ["light", "regular", "bold", "fill"],
+      "x-labels": {
+        light: { en: "Light", tr: "İnce" },
+        regular: { en: "Regular", tr: "Normal" },
+        bold: { en: "Bold", tr: "Kalın" },
+        fill: { en: "Filled", tr: "Dolu" },
+      },
+      default: "regular",
+      "x-widget": "radio",
+      title: { en: "Icons", tr: "İkonlar" },
+      description: {
+        en: "Light suits airy, editorial sites; bold and filled read better small and on busy pages.",
+        tr: "İnce, ferah ve editoryal sitelere uyar; kalın ve dolu, küçük boyutta ve kalabalık sayfalarda daha iyi okunur.",
+      },
+    },
+    // RFC-0033 §4a: the theme's own words in a language it does not ship, or worded otherwise.
+    strings: {
+      type: "array",
+      maxItems: 50,
+      title: { en: "Theme words", tr: "Tema metinleri" },
+      description: {
+        en: "The theme's own words (notices, buttons, labels) in a language, over the theme's: one item per language. Agents can draft them; people review.",
+        tr: "Temanın kendi metinleri (bildirimler, düğmeler, etiketler), bir dilde, temanınkilerin yerine: her dil için bir öğe. Agent'lar taslak hazırlayabilir; kişiler gözden geçirir.",
+      },
+      items: {
+        type: "object",
+        additionalProperties: false,
+        required: ["locale"],
+        properties: {
+          locale: { type: "string", maxLength: 35, title: { en: "Language", tr: "Dil" } },
+          machineTranslated: {
+            type: "string",
+            maxLength: 300,
+            title: { en: "Machine translation notice", tr: "Makine çevirisi notu" },
+          },
+          machineReviewed: {
+            type: "string",
+            maxLength: 300,
+            title: { en: "Reviewed translation notice", tr: "İncelenmiş çeviri notu" },
+          },
+          readOriginal: {
+            type: "string",
+            maxLength: 300,
+            title: { en: "Read the original", tr: "Orijinalini oku" },
+          },
+          notTranslated: {
+            type: "string",
+            maxLength: 300,
+            title: { en: "Not translated notice", tr: "Çevrilmemiş sayfa notu" },
+          },
+          languages: { type: "string", maxLength: 300, title: { en: "Languages", tr: "Diller" } },
+          home: { type: "string", maxLength: 300, title: { en: "Home", tr: "Ana sayfa" } },
+          menu: { type: "string", maxLength: 300, title: { en: "Menu", tr: "Menü" } },
+          search: { type: "string", maxLength: 300, title: { en: "Search", tr: "Ara" } },
+          searchLabel: {
+            type: "string",
+            maxLength: 300,
+            title: { en: "Search label", tr: "Arama etiketi" },
+          },
+          searchPlaceholder: {
+            type: "string",
+            maxLength: 300,
+            title: { en: "Search placeholder", tr: "Arama ipucu" },
+          },
+          related: {
+            type: "string",
+            maxLength: 300,
+            title: { en: "Related posts", tr: "İlgili yazılar" },
+          },
+          skipToContent: {
+            type: "string",
+            maxLength: 300,
+            title: { en: "Skip to content", tr: "İçeriğe geç" },
+          },
+          notFoundTitle: {
+            type: "string",
+            maxLength: 300,
+            title: { en: "Not found: title", tr: "Bulunamadı: başlık" },
+          },
+          notFoundText: {
+            type: "string",
+            maxLength: 300,
+            title: { en: "Not found: text", tr: "Bulunamadı: metin" },
+          },
+          notFoundHome: {
+            type: "string",
+            maxLength: 300,
+            title: { en: "Not found: home link", tr: "Bulunamadı: ana sayfa bağlantısı" },
+          },
+          notFoundSearch: {
+            type: "string",
+            maxLength: 300,
+            title: { en: "Not found: search prompt", tr: "Bulunamadı: arama çağrısı" },
+          },
+        },
+      },
+    },
+  },
+  // WCAG 2.2 AA: body text 4.5:1, links 4.5:1, buttons and other UI parts 3:1 against the page.
+  "x-contrast": [
+    ["text", "surface", 4.5],
+    ["link", "surface", 4.5],
+    ["brand", "surface", 3],
+  ],
+};

package/dist/assets/starters/blog/src/strings.ts

@@ -0,0 +1,269 @@
+/**
+ * The theme's own words per language (RFC-0033 §4a). It ships English, Turkish and Japanese; any
+ * other language gets English, with the site's `strings` setting over it. Plain data, no components,
+ * so tests import it directly.
+ */
+/** The few words the theme itself prints (the content brings its own). */
+const STRINGS = {
+  en: {
+    home: "Home",
+    breadcrumb: "Breadcrumb",
+    related: "Related posts",
+    pagination: "Pagination",
+    newer: "← Newer",
+    older: "Older →",
+    pageOf: (page: number, pages: number) => `Page ${page} of ${pages}`,
+    feed: "RSS feed",
+    posts: (n: number) => (n === 1 ? "1 post" : `${n} posts`),
+    by: (name: string) => `By ${name}`,
+    byPrefix: "By ",
+    and: " and ",
+    updated: (when: string) => `Updated ${when}`,
+    minRead: (n: number) => `${n} min read`,
+    onThisPage: "On this page",
+    /** RFC-0019 §2: the corrections list at the end of an article, and the note under the byline. */
+    corrections: "Corrections and updates",
+    correctionKind: { correction: "Correction", clarification: "Clarification", update: "Update" },
+    appended: (kind: string) => `${kind} appended`,
+    /** RFC-0019 §3: the search form in the header and the search page. */
+    /** RFC-0025: the header and footer's own words. */
+    skipToContent: "Skip to content",
+    mainMenu: "Main",
+    footerMenu: "Footer",
+    legalMenu: "Legal",
+    socialLinks: "Social links",
+    secondaryMenu: "Secondary",
+    menu: "Menu",
+    closeMenu: "Close menu",
+    announcement: "Announcement",
+    dismiss: "Dismiss",
+    privacy: "Privacy",
+    consentNotice: "This site keeps only what it needs to work: no tracking cookies.",
+    consentChoices: "Some parts of this site can load content from other services (videos, maps).",
+    consentOk: "OK",
+    consentAll: "Allow all",
+    consentEssential: "Only essential",
+    privacyPolicy: "Privacy policy",
+    copied: "Copied",
+    linkCopied: "Link copied",
+    builtWith: "Built with Cloudhal",
+    search: "Search",
+    searchLabel: "Search this site",
+    searchPlaceholder: "Search the site…",
+    searchResults: (n: number, q: string) =>
+      n === 1 ? `1 result for “${q}”` : `${n} results for “${q}”`,
+    searchNone: (q: string) => `Nothing matches “${q}”. Try fewer or other words.`,
+    searchUpdating: "Search is catching up with the latest changes.",
+    /** RFC-0029 §6: the search modal's words (`data-words`; `{q}` is the query, `#` the count). */
+    searchModal: {
+      kinds: { article: "Articles", page: "Pages", term: "Topics", author: "Authors" },
+      all: "See all results for “{q}”",
+      none: "Nothing matches “{q}”.",
+      recent: "Recent searches",
+      clear: "Clear recent searches",
+      limited: "Too many searches right now.",
+      error: "Search is unavailable right now.",
+      updating: "Search is catching up with the latest changes.",
+      count: { one: "# result", other: "# results" },
+      close: "Close",
+      keys: { move: "move", open: "open", close: "close" },
+    },
+    previous: "← Previous",
+    next: "Next →",
+    /** Previews of an embargoed or expired page or entry (RFC-0008 §7.3); readers never see these. */
+    embargoed: (when: string) => `Embargoed until ${when}. Only previews show it until then.`,
+    expired: (when: string) => `Expired on ${when}. Only previews show it now.`,
+    // RFC-0033: the reader's notice on machine translations, the fallback notice, the switcher.
+    machineTranslated: "This page was translated automatically and has not been reviewed yet.",
+    machineReviewed: "This page was translated automatically and reviewed by a person.",
+    readOriginal: "Read the original",
+    notTranslated:
+      "This page isn't available in your language yet, so it is shown in its original language.",
+    languages: "Languages",
+    // The not-found page (404) when the site has no page at `/404` in the reader's language.
+    notFoundTitle: "Page not found",
+    notFoundText: "The page you are looking for doesn't exist or has moved.",
+    notFoundHome: "Go to the home page",
+    notFoundSearch: "Or search this site:",
+  },
+  tr: {
+    home: "Ana sayfa",
+    breadcrumb: "Sayfa yolu",
+    related: "İlgili yazılar",
+    pagination: "Sayfalar",
+    newer: "← Daha yeni",
+    older: "Daha eski →",
+    pageOf: (page: number, pages: number) => `Sayfa ${page} / ${pages}`,
+    feed: "RSS beslemesi",
+    posts: (n: number) => `${n} yazı`,
+    by: (name: string) => name,
+    byPrefix: "",
+    and: " ve ",
+    updated: (when: string) => `Güncellendi: ${when}`,
+    minRead: (n: number) => `${n} dk okuma`,
+    onThisPage: "Bu sayfada",
+    corrections: "Düzeltmeler ve güncellemeler",
+    correctionKind: { correction: "Düzeltme", clarification: "Açıklama", update: "Güncelleme" },
+    appended: (kind: string) => `${kind} eklendi`,
+    skipToContent: "İçeriğe geç",
+    mainMenu: "Ana menü",
+    footerMenu: "Alt menü",
+    legalMenu: "Yasal",
+    socialLinks: "Sosyal bağlantılar",
+    secondaryMenu: "İkincil menü",
+    menu: "Menü",
+    closeMenu: "Menüyü kapat",
+    announcement: "Duyuru",
+    dismiss: "Kapat",
+    privacy: "Gizlilik",
+    consentNotice: "Bu site yalnızca çalışması için gerekeni saklar: izleme çerezi yok.",
+    consentChoices:
+      "Bu sitenin bazı bölümleri başka servislerden içerik yükleyebilir (videolar, haritalar).",
+    consentOk: "Tamam",
+    consentAll: "Tümüne izin ver",
+    consentEssential: "Yalnız gerekli",
+    privacyPolicy: "Gizlilik politikası",
+    copied: "Kopyalandı",
+    linkCopied: "Bağlantı kopyalandı",
+    builtWith: "Cloudhal ile yapıldı",
+    search: "Ara",
+    searchLabel: "Sitede ara",
+    searchPlaceholder: "Sitede ara…",
+    searchResults: (n: number, q: string) => `“${q}” için ${n} sonuç`,
+    searchNone: (q: string) =>
+      `“${q}” ile eşleşen bir şey yok. Daha az ya da başka sözcükler deneyin.`,
+    searchUpdating: "Arama son değişiklikleri eklemeye devam ediyor.",
+    searchModal: {
+      kinds: { article: "Yazılar", page: "Sayfalar", term: "Konular", author: "Yazarlar" },
+      all: "“{q}” için tüm sonuçlar",
+      none: "“{q}” ile eşleşen bir şey yok.",
+      recent: "Son aramalar",
+      clear: "Son aramaları temizle",
+      limited: "Şu anda çok fazla arama yapıldı.",
+      error: "Arama şu anda kullanılamıyor.",
+      updating: "Arama son değişiklikleri eklemeye devam ediyor.",
+      count: { one: "# sonuç", other: "# sonuç" },
+      close: "Kapat",
+      keys: { move: "gez", open: "aç", close: "kapat" },
+    },
+    previous: "← Önceki",
+    next: "Sonraki →",
+    embargoed: (when: string) =>
+      `${when} tarihine kadar ambargolu. O zamana kadar yalnızca önizlemede görünür.`,
+    expired: (when: string) =>
+      `${when} tarihinde yayından kalktı. Artık yalnızca önizlemede görünür.`,
+    machineTranslated: "Bu sayfa otomatik olarak çevrildi ve henüz gözden geçirilmedi.",
+    machineReviewed: "Bu sayfa otomatik olarak çevrildi ve bir kişi tarafından gözden geçirildi.",
+    readOriginal: "Orijinalini oku",
+    notTranslated: "Bu sayfa henüz dilinizde yok; bu yüzden orijinal dilinde gösteriliyor.",
+    languages: "Diller",
+    notFoundTitle: "Sayfa bulunamadı",
+    notFoundText: "Aradığınız sayfa yok ya da taşınmış.",
+    notFoundHome: "Ana sayfaya dön",
+    notFoundSearch: "Ya da sitede arayın:",
+  },
+  ja: {
+    home: "ホーム",
+    breadcrumb: "パンくずリスト",
+    related: "関連記事",
+    pagination: "ページ送り",
+    newer: "← 新しい記事",
+    older: "古い記事 →",
+    pageOf: (page: number, pages: number) => `${pages} ページ中 ${page} ページ`,
+    feed: "RSS フィード",
+    posts: (n: number) => `${n} 件の記事`,
+    by: (name: string) => `${name} 著`,
+    byPrefix: "著者:",
+    and: "、",
+    updated: (when: string) => `${when} 更新`,
+    minRead: (n: number) => `${n} 分で読めます`,
+    onThisPage: "このページの内容",
+    corrections: "訂正と更新",
+    correctionKind: { correction: "訂正", clarification: "補足", update: "更新" },
+    appended: (kind: string) => `${kind}を追記`,
+    skipToContent: "本文へスキップ",
+    mainMenu: "メイン",
+    footerMenu: "フッター",
+    legalMenu: "法的情報",
+    socialLinks: "ソーシャルリンク",
+    secondaryMenu: "サブメニュー",
+    menu: "メニュー",
+    closeMenu: "メニューを閉じる",
+    announcement: "お知らせ",
+    dismiss: "閉じる",
+    privacy: "プライバシー",
+    consentNotice: "このサイトは動作に必要なものだけを保存します。追跡用 Cookie は使いません。",
+    consentChoices:
+      "このサイトの一部は、ほかのサービスのコンテンツ(動画、地図)を読み込むことがあります。",
+    consentOk: "OK",
+    consentAll: "すべて許可",
+    consentEssential: "必須のみ",
+    privacyPolicy: "プライバシーポリシー",
+    copied: "コピーしました",
+    linkCopied: "リンクをコピーしました",
+    builtWith: "Cloudhal で構築",
+    search: "検索",
+    searchLabel: "サイト内検索",
+    searchPlaceholder: "サイト内を検索…",
+    searchResults: (n: number, q: string) => `「${q}」の検索結果 ${n} 件`,
+    searchNone: (q: string) =>
+      `「${q}」に一致するものはありません。言葉を減らすか、別の言葉でお試しください。`,
+    searchUpdating: "検索は最新の変更を反映している途中です。",
+    searchModal: {
+      kinds: { article: "記事", page: "ページ", term: "トピック", author: "著者" },
+      all: "「{q}」の検索結果をすべて見る",
+      none: "「{q}」に一致するものはありません。",
+      recent: "最近の検索",
+      clear: "最近の検索を消去",
+      limited: "現在、検索が集中しています。",
+      error: "現在、検索を利用できません。",
+      updating: "検索は最新の変更を反映している途中です。",
+      count: { one: "# 件", other: "# 件" },
+      close: "閉じる",
+      keys: { move: "移動", open: "開く", close: "閉じる" },
+    },
+    previous: "← 前へ",
+    next: "次へ →",
+    embargoed: (when: string) =>
+      `${when} まで公開を控えています。それまではプレビューでのみ表示されます。`,
+    expired: (when: string) =>
+      `${when} に掲載期限が切れました。現在はプレビューでのみ表示されます。`,
+    machineTranslated: "このページは自動翻訳されたもので、まだ確認されていません。",
+    machineReviewed: "このページは自動翻訳され、人が確認しました。",
+    readOriginal: "原文を読む",
+    notTranslated: "このページはまだお使いの言語で読めないため、元の言語で表示しています。",
+    languages: "言語",
+    notFoundTitle: "ページが見つかりません",
+    notFoundText: "お探しのページは存在しないか、移動しました。",
+    notFoundHome: "ホームページへ",
+    notFoundSearch: "またはサイト内を検索:",
+  },
+} as const;
+
+export type ThemeStrings = (typeof STRINGS)[keyof typeof STRINGS];
+
+/**
+ * The theme's words in `locale` (its language subtag; English for a language the theme does not
+ * ship, and for any word a shipped language lacks), with the site's own wording over them
+ * (`strings` in the theme settings, RFC-0033 §4a: one item per language, matched on the full tag,
+ * then the language): plain-text words only, the keys the settings declare.
+ */
+export function strings(locale: string, overrides?: unknown): ThemeStrings {
+  const lang = (locale.split("-")[0] ?? locale).toLowerCase();
+  const base: ThemeStrings = Object.hasOwn(STRINGS, lang)
+    ? { ...STRINGS.en, ...STRINGS[lang as keyof typeof STRINGS] }
+    : STRINGS.en;
+  if (!Array.isArray(overrides)) return base;
+  const words = base as Record<string, unknown>;
+  const items = overrides as Array<Record<string, unknown> | null>;
+  const item =
+    items.find((o) => o?.locale === locale) ??
+    items.find((o) => typeof o?.locale === "string" && o.locale.toLowerCase() === lang);
+  if (!item) return base;
+  const own = Object.fromEntries(
+    Object.entries(item).filter(
+      ([k, v]) => k !== "locale" && typeof v === "string" && v && typeof words[k] === "string",
+    ),
+  );
+  return Object.keys(own).length ? ({ ...base, ...own } as ThemeStrings) : base;
+}