@rigel-cms/rigel 1.0.0 → 1.2.0

package/src/editor/lib/VisualEditor.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+  import { t } from "../i18n";
   import { mount, unmount, onDestroy, tick, type Snippet } from "svelte";
   import BlockEditor from "./BlockEditor.svelte";
   import { tooltipRoot } from "./tooltip";
@@ -93,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) {
@@ -165,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 };
     }
@@ -263,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);
   }
 
@@ -314,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;
@@ -324,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();
   }
 
@@ -337,7 +338,7 @@
     structureSignature = "";
     const doc = docElement();
     if (!doc) {
-      error = "The page could not be loaded in the preview.";
+      error = $t("richtext.pageLoadError");
       return;
     }
     try {
@@ -348,12 +349,12 @@
       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("This page isn’t set up for live editing. Changes won’t appear in this preview.");
+      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();
     } catch (cause) {
-      error = cause instanceof Error ? cause.message : "Preview unavailable";
+      error = cause instanceof Error ? cause.message : $t("richtext.previewUnavailable");
     }
   }
 
@@ -438,14 +439,14 @@
 <div class="visual-editor" bind:clientWidth={editorWidth} class:with-panel={panelOpen} class:resizing-properties={resizing} style={`--properties-width: ${panelWidth}px`}>
   <div class="visual-canvas">
     <div class="visual-toolbar">
-      <div class="mode-toggle" role="group" aria-label="Preview mode">
-        <button type="button" aria-pressed={mode === "browse"} onclick={() => setMode("browse")}>Browse</button>
-        <button type="button" aria-pressed={mode === "edit"} onclick={() => setMode("edit")}>Edit</button>
+      <div class="mode-toggle" role="group" aria-label={$t("richtext.previewMode")}>
+        <button type="button" aria-pressed={mode === "browse"} onclick={() => setMode("browse")}>{$t("richtext.browse")}</button>
+        <button type="button" aria-pressed={mode === "edit"} onclick={() => setMode("edit")}>{$t("richtext.edit")}</button>
       </div>
-      <span class="visual-hint">{mode === "edit" ? "Click a region to edit it. Scripts, forms and links stay disabled." : "Scripts, forms and links are disabled in this preview."}</span>
+      <span class="visual-hint">{mode === "edit" ? $t("richtext.editPreviewHint") : $t("richtext.browsePreviewHint")}</span>
       <div class="visual-actions">
-        {#if websitePath}<a class="icon-btn visual-live" href={websitePath} target="_blank" rel="noopener noreferrer" aria-label="Preview on website" data-tooltip="Preview on website"><Icon name="external" size={18} /></a>{/if}
-        <button type="button" class="icon-btn" aria-pressed={panelOpen} aria-label="Toggle properties panel" data-tooltip="Toggle properties panel" onclick={() => (panelOpen = !panelOpen)}>
+        {#if websitePath}<a class="icon-btn visual-live" href={websitePath} target="_blank" rel="noopener noreferrer" aria-label={$t("richtext.previewOnWebsite")} data-tooltip={$t("richtext.previewOnWebsite")}><Icon name="external" size={18} /></a>{/if}
+        <button type="button" class="icon-btn" aria-pressed={panelOpen} aria-label={$t("richtext.togglePropertiesPanel")} data-tooltip={$t("richtext.togglePropertiesPanel")} onclick={() => (panelOpen = !panelOpen)}>
           <SidebarIcon name="square-half" />
         </button>
       </div>
@@ -455,16 +456,16 @@
         <p class="visual-error" role="status">{error}</p>
       {/if}
       {#if !previewPath}
-        <p class="visual-error" role="status">{creating ? "New page — Save writes the file. The route renders once the site has it." : "No preview URL is mapped to this document. Use the properties panel to edit."}</p>
+        <p class="visual-error" role="status">{creating ? $t("richtext.newPagePreviewHint") : $t("richtext.noDocumentPreview")}</p>
       {:else}
-        <PreviewFrame bind:frame url={previewPath} {reloadToken} title="Website page editor" onload={onLoad} onloading={() => { stopBodyEdit(); inline = null; loaded = false; bodyAvailable = false; error = ""; }} onerror={(message) => { loaded = false; error = message; }} />
+        <PreviewFrame bind:frame url={previewPath} {reloadToken} title={$t("richtext.websitePageEditor")} onload={onLoad} onloading={() => { stopBodyEdit(); inline = null; loaded = false; bodyAvailable = false; error = ""; }} onerror={(message) => { loaded = false; error = message; }} />
       {/if}
       {#if inline}
         <input
           class="inline-editor"
           bind:this={inlineInput}
           type="text"
-          aria-label="Edit text"
+          aria-label={$t("richtext.editText")}
           style={`left:${inline.left}px;top:${inline.top}px;width:${inline.width}px;height:${inline.height}px;font-size:${inline.fontSize}`}
           value={inline.value}
           oninput={(event) => updateInline(event.currentTarget.value)}
@@ -477,7 +478,7 @@
     </div>
   </div>
   {#if panelOpen}
-    <div class="properties-divider" role="separator" tabindex="0" aria-label="Properties panel width" aria-orientation="vertical" aria-valuemin="280" aria-valuemax={panelMax} aria-valuenow={panelWidth} aria-valuetext={`${Math.round(panelWidth)} pixels`} onpointerdown={startResize} onpointermove={moveResize} onpointerup={endResize} onpointercancel={endResize} onlostpointercapture={endResize} onkeydown={keyResize}></div>
+    <div class="properties-divider" role="separator" tabindex="0" aria-label={$t("richtext.propertiesPanelWidth")} aria-orientation="vertical" aria-valuemin="280" aria-valuemax={panelMax} aria-valuenow={panelWidth} aria-valuetext={$t("richtext.panelPixels", { width: Math.round(panelWidth) })} onpointerdown={startResize} onpointermove={moveResize} onpointerup={endResize} onpointercancel={endResize} onlostpointercapture={endResize} onkeydown={keyResize}></div>
   {/if}
   {#if panelOpen && properties}
     {@render properties(selected, focusToken, inlineBodyEnabled || inlineBodyLoading, focusBody, inlineBodyLoading)}

package/src/editor/lib/calendar.ts

@@ -1,5 +1,11 @@
-const display = new Intl.DateTimeFormat("en-US", { month: "long", day: "numeric", year: "numeric", timeZone: "UTC" });
-export const months = Array.from({ length: 12 }, (_, month) => new Intl.DateTimeFormat("en-US", { month: "long", timeZone: "UTC" }).format(new Date(Date.UTC(2000, month, 1))));
+import { get } from "svelte/store";
+import { locale, translate } from "../i18n";
+
+export function monthLabels(t = translate): string[] {
+  return ["january", "february", "march", "april", "may", "june", "july", "august", "september", "october", "november", "december"].map(month => t(`fields.month.${month}`));
+}
+
+export const months = monthLabels();
 
 export function isoDate(date: Date): string {
   return `${String(date.getUTCFullYear()).padStart(4, "0")}-${String(date.getUTCMonth() + 1).padStart(2, "0")}-${String(date.getUTCDate()).padStart(2, "0")}`;
@@ -13,9 +19,9 @@ export function parseDate(value: string): Date | null {
   return isoDate(date) === value ? date : null;
 }
 
-export function formatDate(value: string): string {
+export function formatDate(value: string, language = get(locale)): string {
   const date = parseDate(value);
-  return date ? display.format(date) : value;
+  return date ? new Intl.DateTimeFormat(language === "en" ? "en-US" : language, { month: "long", day: "numeric", year: "numeric", timeZone: "UTC" }).format(date) : value;
 }
 
 export function todayDate(date = new Date()): string {

package/src/editor/lib/embed-preview.ts

@@ -1,13 +1,31 @@
 import { embedProviderLabel, embedWatchUrl, safeEmbed } from "./embeds";
+import { t, translate } from "../i18n";
 
-export function createVideoOverlay(doc: Document, label: string, url: string, editable = false): HTMLElement {
+const labels = new WeakMap<HTMLElement, () => string>();
+
+function mediaLabel(element: HTMLElement, text: () => string) {
+  element.dataset.rigelMediaLabel = "";
+  labels.set(element, text);
+  element.textContent = text();
+}
+
+export function subscribeMediaLabels(root: HTMLElement) {
+  return t.subscribe(() => {
+    for (const element of root.querySelectorAll<HTMLElement>("[data-rigel-media-label]")) {
+      const text = labels.get(element)?.();
+      if (text !== undefined && element.textContent !== text) element.textContent = text;
+    }
+  });
+}
+
+export function createVideoOverlay(doc: Document, label: () => string, url: string, editable = false): HTMLElement {
   const overlay = doc.createElement("div");
   overlay.contentEditable = "false";
   overlay.style.cssText = "position:absolute;inset:0;display:grid;place-items:center;padding:1rem;background:#0006";
   const card = doc.createElement("div");
   card.style.cssText = "box-sizing:border-box;width:100%;max-width:360px;padding:1rem;background:#18181b;color:white;border:1px solid #52525b;font:14px/1.5 system-ui;text-align:left";
   const heading = doc.createElement("strong");
-  heading.textContent = label;
+  mediaLabel(heading, label);
   const link = doc.createElement("div");
   link.textContent = url;
   link.style.cssText = "margin:0.5rem 0 1rem;overflow-wrap:anywhere;color:#e4e4e7";
@@ -19,7 +37,7 @@ export function createVideoOverlay(doc: Document, label: string, url: string, ed
     event.stopPropagation();
     if (event.key === "Enter" || event.key === " ") { event.preventDefault(); edit.click(); }
   });
-  edit.textContent = "Edit video";
+  mediaLabel(edit, () => translate("media.editVideo"));
   edit.hidden = !editable;
   edit.style.cssText = "min-height:44px;padding:0.5rem 0.75rem;border:1px solid #d4d4d8;background:white;color:#18181b;font:inherit;cursor:pointer";
   card.append(heading, link, edit);
@@ -49,9 +67,9 @@ export function createEmbedPreview(value: unknown, doc: Document, editable = fal
     poster.append(image);
   }
   const caption = doc.createElement("figcaption");
-  caption.textContent = `${embedProviderLabel(ref)} · ${title || "Video"}`;
+  mediaLabel(caption, () => translate("media.embedCaption", { provider: embedProviderLabel(ref), title: title || translate("media.video") }));
   caption.style.cssText = "margin-top:0.5rem;font-size:0.875rem;line-height:1.5";
-  poster.append(createVideoOverlay(doc, `${embedProviderLabel(ref)} Video`, embedWatchUrl(ref), editable));
+  poster.append(createVideoOverlay(doc, () => translate("media.providerVideo", { provider: embedProviderLabel(ref) }), embedWatchUrl(ref), editable));
   figure.append(poster, caption);
   return figure;
 }

package/src/editor/lib/extension-preview.ts

@@ -0,0 +1,121 @@
+import modules from "virtual:rigel-extensions";
+import { mount, unmount } from "svelte";
+import { $getRoot, $getNodeByKey, type LexicalEditor } from "lexical";
+import { resolveExtensions } from "../../extensions";
+import type { BlockData, ExtensionBlock } from "../../extensions";
+import { ExtensionNode, cloneBlockData } from "../blocks/extension";
+
+
+const resolved = resolveExtensions(modules);
+export const extensionRegistry = {
+  commands: Object.fromEntries(resolved.commands.map(command => [command.name, command])),
+  blocks: Object.fromEntries(resolved.blocks.map(block => [block.name, block])),
+};
+export function extensionBlock(name: string): ExtensionBlock | undefined {
+  return Object.hasOwn(extensionRegistry.blocks, name) ? extensionRegistry.blocks[name] : undefined;
+}
+export function reportExtensionError(target: HTMLElement, cause: unknown) {
+  const message = cause instanceof Error ? cause.message : String(cause);
+  console.error("Rigel extension:", cause);
+  target.dispatchEvent(new target.ownerDocument.defaultView!.CustomEvent("rigel-extension-error", { bubbles: true, detail: message }));
+}
+type ExtensionMountHandle = (() => void) & { update: (data: BlockData) => void };
+export function mountExtensionComponent(target: HTMLElement, name: string, raw: unknown, onchange?: (data: BlockData) => void): ExtensionMountHandle {
+  const report = (cause: unknown) => reportExtensionError(target, cause);
+  const block = extensionBlock(name);
+  const fallback = (data: unknown) => { target.textContent = `Unavailable extension: ${block?.label ?? name}\n${JSON.stringify(data, null, 2)}`; };
+  const failed = Object.assign(() => {}, { update: fallback });
+  target.replaceChildren();
+  if (!block) { fallback(raw); return failed; }
+  try {
+    let data = cloneBlockData(raw);
+    block.validate(cloneBlockData(data));
+    let disposed = false;
+    let component: { update: (data: BlockData) => void } | undefined;
+    void import("./ExtensionMount.svelte").then(({ default: ExtensionMount }) => {
+      if (disposed || !target.isConnected) return;
+      component = mount(ExtensionMount, { target, props: { component: onchange ? block.editor : block.render, data, onchange, report } }) as unknown as { update: (data: BlockData) => void };
+    }).catch(cause => { if (!disposed) { fallback(data); report(cause); } });
+    return Object.assign(() => { disposed = true; if (component) void unmount(component).catch(report); }, { update: (next: BlockData) => {
+      try { const copy = cloneBlockData(next); block.validate(cloneBlockData(copy)); data = copy; component?.update(copy); }
+      catch (cause) { report(cause); }
+    } });
+  } catch (cause) { fallback(raw); report(cause); return failed; }
+}
+export function createExtensionPreview(name: string, data: unknown, doc: Document) {
+  const element = doc.createElement("div");
+  element.dataset.rigelExtension = name;
+  element.dataset.rigelExtensionData = JSON.stringify(cloneBlockData(data));
+  element.textContent = `Extension: ${name}`;
+  return element;
+}
+const previewMounts = new WeakMap<HTMLElement, ExtensionMountHandle>();
+export function mountExtensionPreviews(root: ParentNode): () => void {
+  const doc = root.nodeType === 9 ? root as Document : root.ownerDocument!;
+  const frame = doc.defaultView?.frameElement;
+  const mounted = new Map<HTMLElement, { stop: ExtensionMountHandle; signature: string }>();
+  const markers = () => [...(root.nodeType === 1 && (root as Element).hasAttribute("data-rigel-extension") ? [root as HTMLElement] : []), ...root.querySelectorAll<HTMLElement>("[data-rigel-extension]")];
+  const sync = () => {
+    if (frame && !frame.isConnected) { cleanup(); return; }
+    for (const [element, entry] of mounted) if (!element.isConnected || !root.contains(element) || element.closest('[contenteditable="true"]')) { entry.stop(); mounted.delete(element); previewMounts.delete(element); }
+    for (const element of markers()) {
+      if (!element.isConnected || element.closest('[contenteditable="true"]')) continue;
+      const signature = `${element.dataset.rigelExtension}\n${element.dataset.rigelExtensionData}`;
+      const existing = mounted.get(element);
+      if (existing?.signature === signature || (!existing && previewMounts.has(element))) continue;
+      if (existing) { existing.stop(); mounted.delete(element); previewMounts.delete(element); }
+      try {
+        const stop = mountExtensionComponent(element, element.dataset.rigelExtension!, JSON.parse(element.dataset.rigelExtensionData ?? "null"));
+        mounted.set(element, { stop, signature }); previewMounts.set(element, stop);
+      } catch (cause) { element.textContent = "Extension unavailable"; reportExtensionError(element, cause); }
+    }
+  };
+  const observer = new doc.defaultView!.MutationObserver(sync);
+  observer.observe(root, { childList: true, subtree: true, attributes: true, attributeFilter: ["data-rigel-extension", "data-rigel-extension-data", "contenteditable"] });
+  if (frame) observer.observe(frame.ownerDocument, { childList: true, subtree: true });
+  const cleanup = () => { observer.disconnect(); for (const [element, entry] of mounted) { entry.stop(); previewMounts.delete(element); } mounted.clear(); doc.defaultView?.removeEventListener("pagehide", cleanup); };
+  doc.defaultView?.addEventListener("pagehide", cleanup);
+  sync();
+  return cleanup;
+}
+
+export function registerExtensionNodes(editor: LexicalEditor) {
+  const mounted = new Map<string, { element: HTMLElement; name: string; json: string; stop: ExtensionMountHandle }>();
+  const doc = editor.getRootElement()!.ownerDocument;
+  const frame = doc.defaultView?.frameElement;
+  let disposed = false;
+  const sync = () => {
+    if (disposed) return;
+    if (frame && !frame.isConnected) { cleanup(); return; }
+    editor.getEditorState().read(() => {
+      const nodes = new Map($getRoot().getChildren().filter((node): node is ExtensionNode => node instanceof ExtensionNode).map(node => [node.getKey(), node]));
+      for (const [key, entry] of mounted) {
+        const node = nodes.get(key), element = editor.getElementByKey(key);
+        if (!node || !element?.isConnected || element !== entry.element || node.__name !== entry.name) { entry.stop(); mounted.delete(key); }
+      }
+      for (const [key, node] of nodes) {
+        const element = editor.getElementByKey(key);
+        if (!element?.isConnected) continue;
+        const json = JSON.stringify(node.__data), existing = mounted.get(key);
+        if (existing) { if (existing.json !== json) { existing.json = json; existing.stop.update(node.__data); } continue; }
+        const stop = mountExtensionComponent(element, node.__name, node.__data, data => {
+          try {
+            const copy = cloneBlockData(data), block = extensionBlock(node.__name);
+            if (disposed || !element.isConnected || !mounted.has(key) || !editor.isEditable() || !block) throw new Error("Extension editor is no longer active");
+            block.validate(cloneBlockData(copy));
+            editor.update(() => { const current = $getNodeByKey(key); if (current instanceof ExtensionNode) current.setData(copy); }, { discrete: true, tag: "history-push" });
+          } catch (cause) { reportExtensionError(element, cause); }
+        });
+        mounted.set(key, { element, name: node.__name, json, stop });
+      }
+    });
+  };
+  const observer = new doc.defaultView!.MutationObserver(sync);
+  observer.observe(doc, { childList: true, subtree: true });
+  if (frame) observer.observe(frame.ownerDocument, { childList: true, subtree: true });
+  const stopUpdates = editor.registerUpdateListener(sync);
+  const cleanup = () => { if (disposed) return; disposed = true; stopUpdates(); observer.disconnect(); for (const entry of mounted.values()) entry.stop(); mounted.clear(); doc.defaultView?.removeEventListener("pagehide", cleanup); };
+  doc.defaultView?.addEventListener("pagehide", cleanup);
+  sync();
+  return cleanup;
+}

package/src/editor/lib/github-auth.ts

@@ -1,3 +1,4 @@
+import { translate } from "../i18n";
 export interface GitHubAccess {
   user: { login: string; name?: string; avatar_url: string; html_url: string };
   status: "ready" | "installation-required" | "read-only";
@@ -12,7 +13,7 @@ export function startGitHubLogin(authOrigin: string): Promise<{ accessToken: str
     try {
       origin = new URL(authOrigin);
       if (origin.username || origin.password || origin.search || origin.hash || origin.pathname !== "/" || (origin.protocol !== "https:" && !(origin.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(origin.hostname)))) throw new Error();
-    } catch { reject(new Error("Invalid authentication gateway origin.")); return; }
+    } catch { reject(new Error(translate("connection.invalidAuthOrigin"))); return; }
     const nonce = Array.from(crypto.getRandomValues(new Uint8Array(32)), byte => byte.toString(16).padStart(2, "0")).join("");
     const url = new URL("/authorize", origin);
     url.searchParams.set("origin", window.location.origin);
@@ -33,27 +34,27 @@ export function startGitHubLogin(authOrigin: string): Promise<{ accessToken: str
       if (!popup || event.source !== popup || event.origin !== origin.origin || !data || data.type !== "rigel:auth" || data.provider !== "github" || data.nonce !== nonce) return;
       if (data.error) {
         finish(data.error === "Authorization denied"
-          ? "GitHub authorization was denied. Sign in again and approve access to continue."
+          ? translate("connection.authorizationDenied")
           : data.error === "Token exchange failed"
-            ? "The auth gateway could not exchange GitHub's authorization code for a token. Repository access has not been checked."
-            : "GitHub login failed. Please try signing in again.");
+            ? translate("connection.tokenExchangeFailed")
+            : translate("connection.loginFailed"));
         return;
       }
-      if (typeof data.access_token !== "string" || !/^ghu_[a-zA-Z0-9_]{1,4092}$/.test(data.access_token) || !Number.isInteger(data.expires_in) || data.expires_in <= 0 || data.expires_in > 86400) { finish("GitHub returned invalid or expired credentials. Please sign in again."); return; }
+      if (typeof data.access_token !== "string" || !/^ghu_[a-zA-Z0-9_]{1,4092}$/.test(data.access_token) || !Number.isInteger(data.expires_in) || data.expires_in <= 0 || data.expires_in > 86400) { finish(translate("connection.invalidCredentials")); return; }
       finish(undefined, { accessToken: data.access_token, expiresAt: Date.now() + data.expires_in * 1000 });
     };
     window.addEventListener("message", receive);
     try { popup = window.open(url.href, "rigel-github-" + nonce, "popup,width=600,height=720"); }
-    catch { finish("Unable to open GitHub login. Allow popups and try again."); return; }
-    if (!popup) { finish("GitHub login popup was blocked. Allow popups and try again."); return; }
-    timer = setInterval(() => { if (popup?.closed) finish("GitHub login was cancelled. Please try again."); }, 250);
-    timeout = setTimeout(() => finish("GitHub login timed out. Please try again."), 120000);
+    catch { finish(translate("connection.loginOpenFailed")); return; }
+    if (!popup) { finish(translate("connection.loginBlocked")); return; }
+    timer = setInterval(() => { if (popup?.closed) finish(translate("connection.loginCancelled")); }, 250);
+    timeout = setTimeout(() => finish(translate("connection.loginTimeout")), 120000);
   });
 }
 
 export async function checkGitHubAccess(token: string, repo: string, appSlug: string): Promise<GitHubAccess> {
-  if (typeof token !== "string" || !/^ghu_[a-zA-Z0-9_]{1,4092}$/.test(token)) throw new Error("GitHub session is invalid. Please sign in again.");
-  if (typeof repo !== "string" || !/^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\/[a-zA-Z0-9_.-]+$/.test(repo) || [".", ".."].includes(repo.split("/")[1]) || typeof appSlug !== "string" || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(appSlug)) throw new Error("Invalid GitHub repository or app configuration.");
+  if (typeof token !== "string" || !/^ghu_[a-zA-Z0-9_]{1,4092}$/.test(token)) throw new Error(translate("connection.invalidSession"));
+  if (typeof repo !== "string" || !/^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?\/[a-zA-Z0-9_.-]+$/.test(repo) || [".", ".."].includes(repo.split("/")[1]) || typeof appSlug !== "string" || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(appSlug)) throw new Error(translate("connection.invalidConfiguration"));
   const get = async (endpoint: string) => {
     let response: Response;
     try {
@@ -61,30 +62,30 @@ export async function checkGitHubAccess(token: string, repo: string, appSlug: st
         method: "GET", redirect: "error", credentials: "omit", cache: "no-store", signal: AbortSignal.timeout(15000),
         headers: { Authorization: `Bearer ${token}`, Accept: "application/vnd.github+json", "X-GitHub-Api-Version": "2022-11-28" },
       });
-    } catch { throw new Error("Unable to reach GitHub. Check your connection and try again."); }
+    } catch { throw new Error(translate("connection.unreachable")); }
     if (!response.ok) {
-      if (response.status === 401) throw Object.assign(new Error("GitHub session expired or was revoked. Please sign in again."), { status: 401 });
-      if (response.status === 429 || (response.status === 403 && (response.headers.get("x-ratelimit-remaining") === "0" || response.headers.has("retry-after")))) throw new Error("GitHub rate limit reached. Wait a few minutes and try again.");
-      if (response.status === 403) throw new Error("GitHub access denied. Check app permissions and organization approval, then sign in again.");
-      if (response.status === 404) throw new Error("GitHub repository or installation is unavailable. Check the repository name and app installation, then try again.");
-      throw new Error("GitHub could not verify access. Please try again later.");
+      if (response.status === 401) throw Object.assign(new Error(translate("connection.sessionExpired")), { status: 401 });
+      if (response.status === 429 || (response.status === 403 && (response.headers.get("x-ratelimit-remaining") === "0" || response.headers.has("retry-after")))) throw new Error(translate("connection.accessRateLimited"));
+      if (response.status === 403) throw new Error(translate("connection.accessDenied"));
+      if (response.status === 404) throw new Error(translate("connection.repositoryUnavailable"));
+      throw new Error(translate("connection.accessCheckFailed"));
     }
     try { return await response.json(); }
-    catch { throw new Error("GitHub returned an invalid access response. Please try again."); }
+    catch { throw new Error(translate("connection.invalidAccessResponse")); }
   };
   const list = async <T>(endpoint: string, key: string): Promise<T[]> => {
     const entries: T[] = [];
     for (let page = 1; page <= 100; page++) {
       const data = await get(`${endpoint}?per_page=100&page=${page}`);
-      if (!data || !Array.isArray(data[key])) throw new Error("GitHub returned an invalid access response. Please try again.");
+      if (!data || !Array.isArray(data[key])) throw new Error(translate("connection.invalidAccessResponse"));
       entries.push(...data[key]);
       if (data[key].length < 100 && !(typeof data.total_count === "number" && entries.length < data.total_count)) return entries;
       if (!data[key].length) break;
     }
-    throw new Error("GitHub access listing is incomplete. Please try again or narrow the app's repository selection.");
+    throw new Error(translate("connection.incompleteAccessListing"));
   };
   const rawUser = await get("/user");
-  if (!rawUser || ![rawUser.login, rawUser.avatar_url, rawUser.html_url].every(value => typeof value === "string" && value)) throw new Error("GitHub returned an invalid user. Please sign in again.");
+  if (!rawUser || ![rawUser.login, rawUser.avatar_url, rawUser.html_url].every(value => typeof value === "string" && value)) throw new Error(translate("connection.invalidUser"));
   const name = typeof rawUser.name === "string" ? rawUser.name.trim() : "";
   const user = { login: rawUser.login, ...(name ? { name } : {}), avatar_url: rawUser.avatar_url, html_url: rawUser.html_url };
   const installUrl = `https://github.com/apps/${appSlug}/installations/new`;
@@ -106,7 +107,7 @@ export async function checkGitHubAccess(token: string, repo: string, appSlug: st
     const repositories = await list<NonNullable<GitHubAccess["repository"]>>(`/user/installations/${installation.id}/repositories`, "repositories");
     const repository = repositories.find(repository => repository && typeof repository.full_name === "string" && repository.full_name.toLowerCase() === repo.toLowerCase());
     if (!repository) continue;
-    if (!Number.isSafeInteger(repository.id) || repository.id <= 0 || typeof repository.default_branch !== "string" || !repository.default_branch) throw new Error("GitHub returned an invalid repository. Please try again.");
+    if (!Number.isSafeInteger(repository.id) || repository.id <= 0 || typeof repository.default_branch !== "string" || !repository.default_branch) throw new Error(translate("connection.invalidRepository"));
     const push = repository.permissions?.push === true;
     return {
       user, status: push && installation.permissions?.contents === "write" && !installation.suspended_at ? "ready" : "read-only", installUrl: configureUrl,