@rigel-cms/rigel 1.1.0 → 1.2.0

package/README.md

@@ -22,6 +22,10 @@ Use the [Astro starter](https://github.com/rigel-cms/rigel-starter), or follow t
 
 [Documentation](https://rigelcms.dev/docs/) · [Content model](https://rigelcms.dev/docs/content-model/) · [Previews](https://rigelcms.dev/docs/preview/) · [GitHub setup](https://rigelcms.dev/docs/github-publishing/)
 
+## Content languages
+
+Declare language-specific page types and article collections, then use an optional content-language selector in the editor. See [Content languages](docs/content-locales.md) for configuration. Website routing stays in your Astro templates.
+
 ## Extensions
 
 Register your own slash commands, toolbar buttons and saved article blocks with Svelte components. The [extension guide](docs/extensions.md) covers registration, editable blocks and published rendering.

package/docs/content-locales.md

@@ -0,0 +1,53 @@
+# Content languages
+
+Content languages are optional. Configure them separately from `languages`, which selects the editor's interface translations.
+
+```js
+rigel({
+  contentLocales: {
+    defaultLocale: "en",
+    locales: [
+      { code: "en", label: "English" },
+      { code: "fr", label: "Français" },
+    ],
+  },
+  schema,
+  collections: [
+    { name: "blogEn", label: "Blog", locale: "en", folder: "src/content/blog/en", fields },
+    { name: "blogFr", label: "Articles", locale: "fr", folder: "src/content/blog/fr", fields },
+  ],
+  preview: {
+    documents: {
+      pageEn: { url: "/en/{slug}/" },
+      pageFr: { url: "/fr/{slug}/" },
+    },
+    collections: {
+      blogEn: { url: "/en/blog/{slug}/", new: "/preview/blog-en/" },
+      blogFr: { url: "/fr/blog/{slug}/", new: "/preview/blog-fr/" },
+    },
+  },
+});
+```
+
+Here `schema` and `fields` are your existing document schema and article fields. Add `locale` to each document type that belongs to one content language:
+
+```ts
+defineDocument({
+  name: "pageFr",
+  title: "Pages françaises",
+  type: "document",
+  locale: "fr",
+  folder: "src/content/pages/fr",
+  fields: pageFields,
+});
+```
+
+Each type can have different fields, allowed sections and initial content. You can also annotate an existing `defineCopy` page with `locale`. Rigel reads the annotation, not the folder name.
+
+With multiple configured locales, the editor shows a Content language dropdown. It filters navigation, page lists, collections and search. Switching away from unsaved changes offers the existing Save, Discard and Keep editing choices. New sessions start with `defaultLocale`.
+
+Content without a `locale` remains visible in every language. Use this for common authors, media and other shared records. A shared document type can also have a locale when its records are language-specific. The language filter is an editing convenience, not an access-control boundary: the manifest and publishing batch still contain the site's complete content.
+
+Without `contentLocales`, the editor keeps its existing navigation and shows no content-language dropdown. A single configured locale also needs no dropdown.
+
+Your Astro routes and templates still own website localization, including public language links, HTML `lang`, translated navigation and fallback behavior. Rigel does not translate text, pair translated entries or generate localized routes. Keep each type's URL mapping consistent with the website routes, and prepare its preview bindings as usual.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rigel-cms/rigel",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "A CMS for Astro sites. You edit the text, Git keeps the history.",
   "keywords": [
     "astro",
@@ -53,7 +53,8 @@
     "src",
     "!src/**/*.test.ts",
     "README.md",
-    "docs/extensions.md"
+    "docs/extensions.md",
+    "docs/content-locales.md"
   ],
   "peerDependencies": {
     "astro": "^7.3.0",

package/src/config.ts

@@ -8,6 +8,12 @@ import type { JsonOutput } from "./json-output";
 import { DEFAULT_MAX_FILE_SIZE } from "./media-types";
 import { systemMessage } from "./editor/i18n/format";
 import { localeNames, type Locale } from "./editor/i18n/locales";
+import { validateContentLocales, validateContentLocale } from "./manifest/content-locales";
+
+export interface ContentLocalesConfig {
+  defaultLocale: string;
+  locales: { code: string; label: string }[];
+}
 
 export interface RigelConfig {
   copyDir: string;
@@ -18,6 +24,7 @@ export interface RigelConfig {
   jsonOutput?: JsonOutput;
   demo?: boolean;
   languages?: Locale[];
+  contentLocales?: ContentLocalesConfig;
   extensions?: string[];
   collections?: CollectionConfig[];
   menus?: { folder: string; maxDepth?: number };
@@ -34,6 +41,7 @@ export interface RigelConfig {
 
 export interface CollectionConfig {
   name: string;
+  locale?: string;
   label?: string;
   listTitle?: string;
   folder: string;
@@ -48,6 +56,12 @@ const DEFAULTS: Pick<RigelConfig, "copyDir" | "backend"> = {
 
 export function parseConfig(options: Partial<RigelConfig> = {}): RigelConfig {
   const cfg = { ...DEFAULTS, ...options };
+  if (cfg.contentLocales !== undefined) {
+    validateContentLocales(cfg.contentLocales);
+    cfg.contentLocales = { ...cfg.contentLocales, locales: cfg.contentLocales.locales.map(locale => ({ ...locale })) };
+  }
+  for (const type of cfg.schema?.documents ?? []) validateContentLocale(type.locale, cfg.contentLocales, type.name);
+  for (const collection of cfg.collections ?? []) validateContentLocale(collection.locale, cfg.contentLocales, collection.name);
   if (cfg.extensions === undefined) cfg.extensions = [];
   if (!Array.isArray(cfg.extensions) || Array.from(cfg.extensions).some(module => typeof module !== "string" || !module.startsWith("./") || !module.slice(2).split("/").every(part => /^[a-zA-Z0-9_-][a-zA-Z0-9_.-]*$/.test(part) && part !== "node_modules" && part !== "." && part !== "..")) || new Set(cfg.extensions).size !== cfg.extensions.length) throw new Error("rigel: extensions must be unique explicit ./module paths inside the site project");
   cfg.extensions = [...cfg.extensions];

package/src/editor/App.svelte

@@ -13,6 +13,9 @@
   import ImagePicker from "./lib/ImagePicker.svelte";
   import Settings from "./lib/Settings.svelte";
   import TopBar from "./lib/TopBar.svelte";
+  import Select from "./lib/Select.svelte";
+  import { contentForLocale, selectionInContent } from "../manifest/content-locales";
+  import { validateDocumentSlugs } from "../slugs";
   import Shortcuts from "./lib/Shortcuts.svelte";
   import CollectionPanel from "./lib/CollectionPanel.svelte";
   import { emptyBody, type ArticleBody } from "../article-body";
@@ -43,6 +46,10 @@
   type Sel = Selection;
 
   let manifest = $state<Manifest>({ pages: [] });
+  let selectedContentLocale = $state<string | undefined>(undefined);
+  let localeControlRevision = $state(0);
+  const contentLocale = $derived(selectedContentLocale ?? manifest.contentLocales?.defaultLocale);
+  const visibleContent = $derived(contentForLocale(manifest, contentLocale));
   let ready = $state(false);
   let blueprint: Manifest | null = null;
   let gitContext: GitContext | null = null;
@@ -134,6 +141,7 @@
     } finally { publishBusy = false; }
   }
   let pendingNavigation = $state<(() => void) | null>(null);
+  let pendingNavigationCancel: (() => void) | null = null;
   let actionDialog = $state<{ title: string; description: string; confirmLabel: string; fieldLabel?: string; danger?: boolean; onconfirm: (value: string) => void | Promise<void> } | null>(null);
   let newEntry = $state<{ collection: string; post: CollectionPost } | null>(null);
   let newDocument = $state<{ type: string; id: string; slug: string } | null>(null);
@@ -414,7 +422,7 @@
   });
 
   function findColl(name: string): ManifestCollection | undefined {
-    return manifest.collections?.find((x) => x.name === name);
+    return visibleContent.collections?.find((x) => x.name === name);
   }
 
   function collName(s: Sel | null): string | null {
@@ -469,13 +477,13 @@
     });
   });
 
-  const sidebar = $derived(buildSidebar(manifest, $t));
+  const sidebar = $derived(buildSidebar(visibleContent, $t));
   const pageCategory = $derived(sel?.kind === "pages" ? sel.category : undefined);
   const schema = $derived<Schema | undefined>(manifest.schema);
-  const docTypes = $derived(schema?.documents ?? []);
+  const docTypes = $derived(visibleContent.schema?.documents ?? []);
 
   const pageDocType = $derived(docTypes.find((type) => !type.shared && !type.singleton));
-  const pageDocuments = $derived((manifest.documents ?? []).filter((doc) => docTypes.some(type => type.name === doc.type && !type.shared)));
+  const pageDocuments = $derived((visibleContent.documents ?? []).filter((doc) => docTypes.some(type => type.name === doc.type && !type.shared)));
   function docTypeName(s: Sel | null): string | null {
     return s && (s.kind === "document" || s.kind === "documents") ? s.type : null;
   }
@@ -493,14 +501,15 @@
   });
   function documentPreview(mode: "draft" | "website") {
     if (sel?.kind !== "document" || (mode === "draft" && newDocument?.id === sel.id)) return null;
-    return previewUrl(manifest.preview ?? {}, { kind: "document", type: sel.type, slug: sel.id.slice(sel.type.length + 1), urlSlug: Object.hasOwn(draft, "slug") ? String(draft.slug) : undefined }, mode);
+    const storedSlug = activeDocument ? effectiveSlug(activeDocument.data, activeDocument.slug) : sel.id.slice(sel.type.length + 1);
+    return previewUrl(manifest.preview ?? {}, { kind: "document", type: sel.type, slug: storedSlug, urlSlug: Object.hasOwn(draft, "slug") ? String(draft.slug) : undefined }, mode);
   }
   const standaloneDocument = $derived(sel?.kind === "document" && activeDocType?.shared === true);
   const visualSelection = $derived(sel?.kind === "post" || (sel?.kind === "document" && !standaloneDocument));
 
   const sortedPages = $derived.by(() => {
     const rows = [
-      ...manifest.pages.filter((p) => !p.shared && (pageCategory === undefined || p.category === pageCategory))
+      ...visibleContent.pages.filter((p) => !p.shared && (pageCategory === undefined || p.category === pageCategory))
         .map((p) => ({ slug: p.slug, title: p.label, category: p.category, draft: false, target: { kind: "page", slug: p.slug } as Sel })),
       ...(pageCategory === undefined ? pageDocuments
         .map((doc) => ({ slug: effectiveSlug(doc.data, doc.slug), title: String(doc.data.title ?? doc.slug), category: undefined, draft: doc.data.draft === true, target: { kind: "document", type: doc.type, id: doc.id } as Sel })) : []),
@@ -511,7 +520,7 @@
   function documentCell(doc: ContentDocument, key: string): string {
     return String(key === "title" ? doc.data.title ?? doc.data.name ?? doc.slug : key === "slug" ? activeDocType?.shared ? doc.slug : effectiveSlug(doc.data, doc.slug) : doc.data[key] ?? "");
   }
-  const typeDocuments = $derived((manifest.documents ?? []).filter((doc) => doc.type === docTypeName(sel)).sort((a, b) => documentCell(a, sortBy).localeCompare(documentCell(b, sortBy)) * sortDir));
+  const typeDocuments = $derived((visibleContent.documents ?? []).filter((doc) => doc.type === docTypeName(sel)).sort((a, b) => documentCell(a, sortBy).localeCompare(documentCell(b, sortBy)) * sortDir));
 
 
   const menu = $derived.by(() => { const slug = sel?.kind === "menu" ? sel.slug : null; return manifest.menus?.entries.find((m) => m.slug === slug); });
@@ -587,22 +596,31 @@
     return false;
   }
 
-  function requestNavigation(action: () => void) {
+  function requestNavigation(action: () => void, oncancel: (() => void) | null = null) {
     if (publishOpen || publishBusy) return;
+    pendingNavigationCancel = oncancel;
     if (dirty || saveState === "saving") pendingNavigation = action;
     else action();
   }
 
+  function cancelNavigation() {
+    pendingNavigation = null;
+    pendingNavigationCancel?.();
+    pendingNavigationCancel = null;
+  }
+
   async function saveAndLeave() {
     if (!(await save())) return;
     const action = pendingNavigation;
     pendingNavigation = null;
+    pendingNavigationCancel = null;
     action?.();
   }
 
   function discardAndLeave() {
     const action = pendingNavigation;
     pendingNavigation = null;
+    pendingNavigationCancel = null;
     const fallback: Sel | null = newEntry ? { kind: "collection", name: newEntry.collection } : newDocument ? { kind: "pages" } : sel;
     newEntry = null;
     newDocument = null;
@@ -611,6 +629,7 @@
   }
 
   function select(next: Sel | null) {
+    if (manifest.contentLocales && !selectionInContent(visibleContent, next)) return;
     if (sel && next && sameSel(sel, next)) return;
     requestNavigation(() => openSelection(next));
   }
@@ -655,6 +674,21 @@
 
   }
 
+  function focusContentLocale() {
+    void tick().then(() => document.querySelector<HTMLButtonElement>(".content-language button[role=combobox]")?.focus({ preventScroll: true }));
+  }
+
+  function switchContentLocale(value: string | string[]) {
+    localeControlRevision += 1;
+    if (typeof value !== "string" || value === contentLocale || !manifest.contentLocales?.locales.some(locale => locale.code === value)) return;
+    requestNavigation(() => {
+      const destination = contentForLocale(manifest, value);
+      selectedContentLocale = value;
+      if (!selectionInContent(destination, sel)) openSelection(null);
+      focusContentLocale();
+    }, focusContentLocale);
+  }
+
   function sort(key: string) {
     if (sortBy === key) sortDir = sortDir === 1 ? -1 : 1;
     else {
@@ -697,10 +731,10 @@
       onconfirm: (title) => {
         const slug = slugify(title);
         if (!slug) throw new Error($t("shell.titleRequired"));
-        const taken = [...(manifest.documents ?? []).filter(doc => !type.shared || doc.type === type.name).flatMap((doc) => [doc.slug, ...(type.shared || docTypes.find(type => type.name === doc.type)?.shared ? [] : [effectiveSlug(doc.data, doc.slug)])]), ...(!type.shared ? manifest.pages.map((page) => page.slug) : [])];
-        if (taken.includes(slug)) throw new Error($t("shell.slugAlreadyUsed", { slug }));
+        if (manifest.documents?.some(doc => doc.type === type.name && doc.slug === slug)) throw new Error($t("shell.slugAlreadyUsed", { slug }));
         const id = `${type.name}:${slug}`;
         const data = newDocumentFromTemplate(schema, type.name, title, slug);
+        validateDocumentSlugs(schema, [...(manifest.documents ?? []), { id, type: type.name, slug, data }], manifest.preview, $t);
         newDocument = { type: type.name, id, slug };
         draft = JSON.parse(JSON.stringify(data));
         docBase = null;
@@ -821,7 +855,14 @@
       <img src={logo} alt="" width="32" height="32" />
       <span>Rigel <span class="brand-suffix">CMS</span></span>
     </a>
-    <TopBar {manifest} {sel} onselect={select} />
+    <TopBar manifest={visibleContent} {sel} onselect={select} />
+    {#if manifest.contentLocales && manifest.contentLocales.locales.length > 1}
+      <div class="content-language" data-locale={contentLocale}>
+        {#key localeControlRevision}
+          <Select label={$t("shell.contentLanguage")} value={contentLocale} options={manifest.contentLocales.locales.map(locale => ({ value: locale.code, label: locale.label }))} disabled={publishOpen || publishBusy} onchange={switchContentLocale} />
+        {/key}
+      </div>
+    {/if}
 
     <nav id="rigel-sidebar-navigation" class="rail-scroll" aria-label={$t("shell.content")}>
       {#each sidebar as node}
@@ -1107,7 +1148,7 @@
   <Shortcuts onclose={() => (shortcutsOpen = false)} />
 {/if}
 {#if pendingNavigation}
-  <UnsavedChanges busy={saveState === "saving"} error={saveError} onsave={saveAndLeave} ondiscard={discardAndLeave} oncancel={() => { pendingNavigation = null; }} />
+  <UnsavedChanges busy={saveState === "saving"} error={saveError} onsave={saveAndLeave} ondiscard={discardAndLeave} oncancel={cancelNavigation} />
 {/if}
 {#if actionDialog}
   <ActionDialog {...actionDialog} onclose={() => { actionDialog = null; }} />

package/src/editor/i18n/de/shell.json

@@ -139,6 +139,7 @@
   "shell.privacyPolicy": "Datenschutzerklärung",
   "shell.welcome": "Willkommen",
   "shell.content": "Inhalte",
+  "shell.contentLanguage": "Inhaltssprache",
   "shell.publish": "Veröffentlichen",
   "shell.saveBeforePublishing": "Änderungen vor dem Veröffentlichen speichern",
   "shell.publishSavedChanges": "Gespeicherte Branch-Änderungen veröffentlichen",

package/src/editor/i18n/en/shell.json

@@ -139,6 +139,7 @@
   "shell.privacyPolicy": "Privacy Policy",
   "shell.welcome": "Welcome",
   "shell.content": "Content",
+  "shell.contentLanguage": "Content language",
   "shell.publish": "Publish",
   "shell.saveBeforePublishing": "Save your edits before publishing",
   "shell.publishSavedChanges": "Publish saved branch changes",

package/src/editor/i18n/es/shell.json

@@ -139,6 +139,7 @@
   "shell.privacyPolicy": "Política de privacidad",
   "shell.welcome": "Bienvenido",
   "shell.content": "Contenido",
+  "shell.contentLanguage": "Idioma del contenido",
   "shell.publish": "Publicar",
   "shell.saveBeforePublishing": "Guardar los cambios antes de publicar",
   "shell.publishSavedChanges": "Publicar los cambios guardados de la rama",

package/src/editor/i18n/fr/shell.json

@@ -139,6 +139,7 @@
   "shell.privacyPolicy": "Politique de confidentialité",
   "shell.welcome": "Bienvenue",
   "shell.content": "Contenu",
+  "shell.contentLanguage": "Langue du contenu",
   "shell.publish": "Publier",
   "shell.saveBeforePublishing": "Enregistrer vos modifications avant de publier",
   "shell.publishSavedChanges": "Publier les modifications enregistrées de la branche",

package/src/editor/i18n/it/shell.json

@@ -139,6 +139,7 @@
   "shell.privacyPolicy": "Informativa sulla privacy",
   "shell.welcome": "Benvenuto",
   "shell.content": "Contenuti",
+  "shell.contentLanguage": "Lingua dei contenuti",
   "shell.publish": "Pubblica",
   "shell.saveBeforePublishing": "Salva le modifiche prima di pubblicare",
   "shell.publishSavedChanges": "Pubblica le modifiche salvate nel branch",

package/src/editor/i18n/ja/shell.json

@@ -139,6 +139,7 @@
   "shell.privacyPolicy": "プライバシーポリシー",
   "shell.welcome": "ようこそ",
   "shell.content": "コンテンツ",
+  "shell.contentLanguage": "コンテンツの言語",
   "shell.publish": "公開",
   "shell.saveBeforePublishing": "公開する前に変更を保存してください",
   "shell.publishSavedChanges": "ブランチに保存済みの変更を公開",

package/src/editor/i18n/nl/shell.json

@@ -139,6 +139,7 @@
   "shell.privacyPolicy": "Privacybeleid",
   "shell.welcome": "Welkom",
   "shell.content": "Inhoud",
+  "shell.contentLanguage": "Inhoudstaal",
   "shell.publish": "Publiceren",
   "shell.saveBeforePublishing": "Sla je wijzigingen op voordat je publiceert",
   "shell.publishSavedChanges": "Opgeslagen branchwijzigingen publiceren",

package/src/editor/i18n/ru/shell.json

@@ -139,6 +139,7 @@
   "shell.privacyPolicy": "Политика конфиденциальности",
   "shell.welcome": "Добро пожаловать",
   "shell.content": "Содержимое",
+  "shell.contentLanguage": "Язык содержимого",
   "shell.publish": "Опубликовать",
   "shell.saveBeforePublishing": "Сохраните правки перед публикацией",
   "shell.publishSavedChanges": "Опубликовать сохранённые изменения ветки",

package/src/editor/i18n/zh/shell.json

@@ -139,6 +139,7 @@
   "shell.privacyPolicy": "隐私政策",
   "shell.welcome": "欢迎",
   "shell.content": "内容",
+  "shell.contentLanguage": "内容语言",
   "shell.publish": "发布",
   "shell.saveBeforePublishing": "请先保存修改，再发布",
   "shell.publishSavedChanges": "发布分支中已保存的更改",

package/src/editor/lib/Select.svelte

@@ -60,7 +60,7 @@
     position();
     await tick();
     position();
-    menu.querySelector(`#${CSS.escape(id)}-option-${active}`)?.scrollIntoView({ block: "nearest" });
+    menu?.querySelector(`#${CSS.escape(id)}-option-${active}`)?.scrollIntoView({ block: "nearest" });
   }
 
   function choose(index: number) {
@@ -101,7 +101,7 @@
       if (match >= 0) active = match;
     } else return;
     await tick();
-    menu.querySelector(`#${CSS.escape(id)}-option-${active}`)?.scrollIntoView({ block: "nearest" });
+    menu?.querySelector(`#${CSS.escape(id)}-option-${active}`)?.scrollIntoView({ block: "nearest" });
   }
 
   $effect(() => {

package/src/editor/lib/VisualEditor.svelte

@@ -94,7 +94,7 @@
 
   function anchorSelector(path: string) {
     const escaped = CSS.escape(path);
-    return `[data-rigel-text="${escaped}"],[data-rigel-richtext="${escaped}"],[data-rigel-image="${escaped}"],[data-rigel-alt="${escaped}"],[data-rigel-href="${escaped}"]`;
+    return `[data-rigel-tags="${escaped}"],[data-rigel-text="${escaped}"],[data-rigel-richtext="${escaped}"],[data-rigel-image="${escaped}"],[data-rigel-alt="${escaped}"],[data-rigel-href="${escaped}"]`;
   }
 
   function applySelection(scroll = false) {
@@ -166,7 +166,7 @@
   }
 
   function fieldPathFrom(element: HTMLElement): { path: string; doc: string } | null {
-    for (const attr of ["data-rigel-text", "data-rigel-richtext", "data-rigel-image", "data-rigel-alt", "data-rigel-href"]) {
+    for (const attr of ["data-rigel-tags", "data-rigel-text", "data-rigel-richtext", "data-rigel-image", "data-rigel-alt", "data-rigel-href"]) {
       const value = element.getAttribute(attr);
       if (value) return { path: value, doc: element.getAttribute("data-rigel-doc") ?? docId };
     }
@@ -264,7 +264,7 @@
     if (!target) return;
     const articleBody = target.closest<HTMLElement>('[data-rigel-richtext="$body"]');
     if (inlineBodyEnabled && articleBody) { void startBodyEdit(articleBody, event); return; }
-    const element = target.closest<HTMLElement>("[data-rigel-text],[data-rigel-richtext],[data-rigel-image],[data-rigel-alt],[data-rigel-href],[data-rigel-section]");
+    const element = target.closest<HTMLElement>("[data-rigel-tags],[data-rigel-text],[data-rigel-richtext],[data-rigel-image],[data-rigel-alt],[data-rigel-href],[data-rigel-section]");
     if (element) selectFromElement(element);
   }
 
@@ -315,7 +315,7 @@
     const target = eventElement(event.target);
     if (target && (editingBody?.contains(target) || bodyScope?.contains(target))) return;
     if (!target) return;
-    const element = target.closest<HTMLElement>("[data-rigel-text],[data-rigel-richtext],[data-rigel-image],[data-rigel-alt],[data-rigel-href],[data-rigel-section]");
+    const element = target.closest<HTMLElement>("[data-rigel-tags],[data-rigel-text],[data-rigel-richtext],[data-rigel-image],[data-rigel-alt],[data-rigel-href],[data-rigel-section]");
     if (!element || element === highlighted) return;
     if (hovered && hovered !== element) clearHover();
     hovered = element;
@@ -325,7 +325,7 @@
   function onOut(event: MouseEvent) {
     const target = eventElement(event.target);
     if (!target) return;
-    const element = target.closest<HTMLElement>("[data-rigel-text],[data-rigel-richtext],[data-rigel-image],[data-rigel-alt],[data-rigel-href],[data-rigel-section]");
+    const element = target.closest<HTMLElement>("[data-rigel-tags],[data-rigel-text],[data-rigel-richtext],[data-rigel-image],[data-rigel-alt],[data-rigel-href],[data-rigel-section]");
     if (element && element === hovered) clearHover();
   }
 
@@ -349,7 +349,7 @@
       doc.addEventListener("mouseout", onOut, true);
       doc.addEventListener("submit", (event) => event.preventDefault(), true);
       doc.defaultView?.addEventListener("scroll", () => closeInline(), { passive: true });
-      if (!doc.querySelector(schema ? `[data-rigel-doc="${docId}"]` : "[data-rigel-text],[data-rigel-richtext],[data-rigel-image]")) throw new Error($t("richtext.liveEditingUnavailable"));
+      if (!doc.querySelector(schema ? `[data-rigel-doc="${docId}"]` : "[data-rigel-tags],[data-rigel-text],[data-rigel-richtext],[data-rigel-image]")) throw new Error($t("richtext.liveEditingUnavailable"));
       loaded = true;
       bodyAvailable = !schema && !!body && !!doc.querySelector('[data-rigel-richtext="$body"]');
       patch();

package/src/editor/styles.css

@@ -1161,6 +1161,15 @@
 .rigel .schema-panel { border-left: 1px solid var(--border); overflow-y: auto; min-height: 0; padding: 1rem; background: var(--panel); }
 .rigel .schema-panel section { border: 0; padding: 0 0 1rem; }
 .rigel .custom-select { min-width: 0; max-width: 100%; }
+.rigel .content-language { position: relative; margin: -0.75rem 0.75rem 1.5rem; flex-shrink: 0; }
+.rigel .content-language .select-label { margin-top: 0; }
+.rigel .content-language .select-trigger { min-height: 36px; }
+@media (min-width: 768px) {
+  .rigel.sidebar-collapsed .content-language .select-label { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
+  .rigel.sidebar-collapsed .content-language .select-trigger > * { visibility: hidden; }
+  .rigel.sidebar-collapsed .content-language .select-trigger { gap: 0; padding-inline: 0; }
+  .rigel.sidebar-collapsed .content-language::after { content: attr(data-locale); position: absolute; inset: 0; overflow: hidden; line-height: 36px; text-align: center; text-transform: uppercase; font-size: 0.6875rem; pointer-events: none; }
+}
 .rigel .block-editor { position: relative; margin-top: 1rem; border: 1px solid var(--border-control); }
 .rigel .block-editor [hidden] { display: none !important; }
 .rigel.rigel-inline { display: block; position: fixed; top: 0; left: 0; width: 100%; min-height: 0; height: 0; padding: 0; background: transparent; pointer-events: none; z-index: 120; }

package/src/index.ts

@@ -115,7 +115,7 @@ export { validateMenu } from "./manifest/menu";
 export type { MenuItem, MenuDocument } from "./manifest/menu";
 export { defineCopy } from "./manifest/types";
 export type { CopyField, CopyGroup, CopyPage, Manifest, CollectionField } from "./manifest/types";
-export type { RigelConfig, CollectionConfig } from "./config";
+export type { RigelConfig, CollectionConfig, ContentLocalesConfig } from "./config";
 export type { JsonOutput } from "./json-output";
 export type { ReferenceOption } from "./manifest/references";
 export type { SidebarEntry, SidebarTarget, SidebarIconName } from "./manifest/navigation";

package/src/manifest/content-locales.ts

@@ -0,0 +1,45 @@
+import type { ContentLocalesConfig } from "../config";
+import type { Manifest } from "./types";
+import type { Selection } from "./navigation";
+
+const CODE = /^[A-Za-z]{2,8}(?:-[A-Za-z0-9]{1,8})*$/;
+
+export function validateContentLocales(value: unknown): asserts value is ContentLocalesConfig {
+  const config = value as ContentLocalesConfig | null;
+  if (!config || typeof config !== "object" || !Array.isArray(config.locales) || !config.locales.length || Array.from(config.locales).some(locale => !locale || typeof locale.code !== "string" || !CODE.test(locale.code) || typeof locale.label !== "string" || !locale.label.trim()) || new Set(config.locales.map(locale => locale.code.toLowerCase())).size !== config.locales.length || !config.locales.some(locale => locale.code === config.defaultLocale)) {
+    throw new Error("rigel: contentLocales requires unique locale codes, non-empty labels and a defaultLocale matching a configured code");
+  }
+}
+
+export function validateContentLocale(locale: unknown, config: ContentLocalesConfig | undefined, scope: string): void {
+  if (locale === undefined) return;
+  if (typeof locale !== "string" || !CODE.test(locale)) throw new Error(`rigel: ${scope}: invalid content locale`);
+  if (config && !config.locales.some(entry => entry.code === locale)) throw new Error(`rigel: ${scope}: unknown content locale ${locale}`);
+}
+
+export function contentForLocale(manifest: Manifest, locale: string | undefined): Manifest {
+  if (!manifest.contentLocales) return manifest;
+  const selected = locale ?? manifest.contentLocales.defaultLocale;
+  const visible = (entry: { locale?: string }) => entry.locale === undefined || entry.locale === selected;
+  const types = manifest.schema?.documents.filter(visible);
+  return {
+    ...manifest,
+    pages: manifest.pages.filter(visible),
+    ...(manifest.collections ? { collections: manifest.collections.filter(visible) } : {}),
+    ...(manifest.schema ? { schema: { ...manifest.schema, documents: types! } } : {}),
+    ...(manifest.documents ? { documents: manifest.documents.filter(doc => types?.some(type => type.name === doc.type)) } : {}),
+  };
+}
+
+export function selectionInContent(manifest: Manifest, selection: Selection | null): boolean {
+  if (!selection) return true;
+  switch (selection.kind) {
+    case "page": return manifest.pages.some(page => page.slug === selection.slug);
+    case "pages": return !selection.category || manifest.pages.some(page => !page.shared && page.category === selection.category);
+    case "document":
+    case "documents": return !!manifest.schema?.documents.some(type => type.name === selection.type);
+    case "post": return !!manifest.collections?.some(collection => collection.name === selection.collection);
+    case "collection": return !!manifest.collections?.some(collection => collection.name === selection.name);
+    default: return true;
+  }
+}

package/src/manifest/navigation.ts

@@ -54,6 +54,10 @@ export function buildSidebar(manifest: Manifest, message: Translator = systemMes
   ];
   if (!manifest.sidebar) return defaults;
   const available = new Map(defaults.filter((node): node is SidebarLink => node.kind === "link").map(node => [navigationKey(node.target), node]));
+  for (const type of types) {
+    const target: SidebarTarget = { kind: "documents", type: type.name };
+    available.set(navigationKey(target), link(target, type.title));
+  }
   for (const page of manifest.pages) available.set(navigationKey({ kind: "page", slug: page.slug }), link({ kind: "page", slug: page.slug }, page.label));
   for (const doc of manifest.documents ?? []) {
     const target: SidebarTarget = { kind: "document", type: doc.type, id: doc.id };

package/src/manifest/types.ts

@@ -15,6 +15,7 @@ export interface CopyGroup {
 
 export interface CopyPage {
   slug: string;
+  locale?: string;
   label: string;
   shared?: boolean;
   category?: string;
@@ -36,6 +37,7 @@ export interface GitHubBackendConfig {
 }
 
 export interface Manifest {
+  contentLocales?: import("../config").ContentLocalesConfig;
   backend?: "github";
   github?: GitHubBackendConfig;
   sidebar?: import("./navigation").SidebarEntry[];
@@ -66,6 +68,7 @@ export interface CollectionPost {
 
 export interface ManifestCollection {
   name: string;
+  locale?: string;
   label: string;
   listTitle?: string;
   fields: CollectionField[];

package/src/preview.ts

@@ -100,6 +100,7 @@ function rebindTree(root: Element | DocumentFragment, update: (element: Element)
 }
 
 export function patchPreview(doc: Document, values: Record<string, unknown>, body: "" | import("./article-body").ArticleBody, options: PatchDocuments = {}) {
+  if (!doc.documentElement) return;
   let previews = extensionPreviews.get(doc);
   if (!previews) {
     previews = new Map();
@@ -172,6 +173,19 @@ export function patchPreview(doc: Document, values: Record<string, unknown>, bod
     const result = get(element, element.getAttribute("data-rigel-if")!);
     if (result.found) element.hidden = !result.value;
   }
+  for (const el of doc.querySelectorAll<HTMLElement>("[data-rigel-tags]")) {
+    if (el.tagName !== "UL" && el.tagName !== "OL") continue;
+    const result = get(el, el.dataset.rigelTags!);
+    if (!result.found) continue;
+    const source = typeof result.value === "string" ? result.value : "";
+    if (rendered.get(el) === source) continue;
+    el.replaceChildren(...source.split(",").map(tag => tag.trim()).filter(Boolean).map(tag => {
+      const item = doc.createElement("li");
+      item.textContent = tag;
+      return item;
+    }));
+    rendered.set(el, source);
+  }
   for (const el of doc.querySelectorAll<HTMLElement>("[data-rigel-text]")) {
     const result = get(el, el.dataset.rigelText!);
     if (!result.found) continue;

package/src/schema/types.ts

@@ -35,6 +35,7 @@ export interface DocumentTemplateSection {
 
 export interface DocumentDef {
   name: string;
+  locale?: string;
   title: string;
   type: "document";
   folder: string;

package/src/vite/manifest-plugin.ts

@@ -44,6 +44,7 @@ const __rigelReservedSlugs = new Set(documents.filter((doc) => !documentTypes.fi
     .map(
       (c) => `  {
     name: ${JSON.stringify(c.name)},
+    ${c.locale !== undefined ? `locale: ${JSON.stringify(c.locale)},` : ""}
     label: ${JSON.stringify(c.label ?? c.name)},
     listTitle: ${JSON.stringify(c.listTitle)},
     fields: ${JSON.stringify(c.fields)},
@@ -167,6 +168,7 @@ export const menus = {
           jsonOutput: cfg.jsonOutput,
           demo: cfg.demo,
           languages: cfg.languages,
+          contentLocales: cfg.contentLocales,
           publicDir: publicDir?.href,
           mediaDir: cfg.mediaDir,
           maxFileSize: cfg.maxFileSize,
@@ -205,8 +207,10 @@ export function derefDocument(value) { return deref(value, __rigelIndex); }
       return `
 import { validateBody as __rigelValidateBody } from ${JSON.stringify(fileURLToPath(new URL("../article-body.ts", import.meta.url)))};
 import { validateCollectionValues as __rigelValidateCollectionValues } from ${JSON.stringify(fileURLToPath(new URL("../manifest/collections.ts", import.meta.url)))};
+import { validateContentLocale as __rigelValidateContentLocale } from ${JSON.stringify(fileURLToPath(new URL("../manifest/content-locales.ts", import.meta.url)))};
 const modules = import.meta.glob(${JSON.stringify(pattern)}, { eager: true });
 const loaded = Object.values(modules).map((m) => m.default);
+for (const page of loaded) __rigelValidateContentLocale(page.locale, ${JSON.stringify(cfg.contentLocales)}, page.slug);
 ${documentsSrc}
 export const pages = loaded.filter((page) => !__rigelReservedSlugs.has(page.slug)).sort((a, b) => a.slug.localeCompare(b.slug));
 export const collections = [
@@ -214,7 +218,7 @@ ${collectionCode}
 ];
 for (const collection of collections) __rigelAssertUniqueUrlSlugs(collection.posts.map(post => ({ slug: post.slug, values: post.frontmatter })));
 ${menuCode}
-export default { pages, collections, documents${github ? ', backend: "github", github: ' + JSON.stringify(github) : ""}${cfg.menus ? ", menus" : ""}${cfg.schema ? ", schema: " + JSON.stringify(cfg.schema) : ""}${cfg.preview ? ", preview: " + JSON.stringify(cfg.preview) : ""}${cfg.sidebar ? ", sidebar: " + JSON.stringify(cfg.sidebar) : ""} };
+export default { pages, collections, documents${cfg.contentLocales ? ", contentLocales: " + JSON.stringify(cfg.contentLocales) : ""}${github ? ', backend: "github", github: ' + JSON.stringify(github) : ""}${cfg.menus ? ", menus" : ""}${cfg.schema ? ", schema: " + JSON.stringify(cfg.schema) : ""}${cfg.preview ? ", preview: " + JSON.stringify(cfg.preview) : ""}${cfg.sidebar ? ", sidebar: " + JSON.stringify(cfg.sidebar) : ""} };
 `;
     },
   };