astro-llm-translator 0.1.0

package/dist/starlight/index.js

@@ -0,0 +1,182 @@
+// src/starlight/index.ts
+import fs2 from "fs/promises";
+import path2 from "path";
+
+// src/starlight/sidebar-utils.ts
+import fs from "fs";
+import path from "path";
+import GithubSlugger from "github-slugger";
+import matter from "gray-matter";
+function getMetadata(filePath) {
+  try {
+    const content = fs.readFileSync(filePath, "utf-8");
+    const parsed = matter(content);
+    return {
+      title: parsed.data.title,
+      slug: parsed.data.slug,
+      sidebar: parsed.data.sidebar || {}
+    };
+  } catch {
+    return { title: void 0, slug: void 0, sidebar: {} };
+  }
+}
+function getTranslations(baseContentDir, relPath, targetLocales, sourceLocale) {
+  const translations = {};
+  for (const lang of targetLocales) {
+    const targetFullPath = path.join(baseContentDir, lang, relPath);
+    if (fs.existsSync(targetFullPath)) {
+      const { title, sidebar } = getMetadata(targetFullPath);
+      if (sidebar.label) {
+        translations[lang] = sidebar.label;
+      } else if (title) {
+        translations[lang] = title;
+      }
+    }
+  }
+  return translations;
+}
+function generateWebPath(relativeDir, fileName, frontmatterSlug) {
+  if (frontmatterSlug) {
+    return frontmatterSlug;
+  }
+  const baseName = path.basename(fileName, path.extname(fileName));
+  const segments = relativeDir ? relativeDir.split(path.sep) : [];
+  segments.push(baseName);
+  return segments.map((s) => new GithubSlugger().slug(s)).join("/");
+}
+function generateMultilingualSidebar(baseContentDir, relativeDir, sourceLocale, targetLocales, segmentState) {
+  const scanRoot = sourceLocale === "root" ? baseContentDir : path.join(baseContentDir, sourceLocale);
+  const fullScanDir = path.join(scanRoot, relativeDir);
+  if (!fs.existsSync(fullScanDir)) return [];
+  const items = [];
+  let entries = [];
+  try {
+    entries = fs.readdirSync(fullScanDir).sort((a, b) => a.localeCompare(b));
+  } catch (e) {
+    return [];
+  }
+  for (const entry of entries) {
+    if (entry.startsWith(".")) continue;
+    const fullPath = path.join(fullScanDir, entry);
+    let stat;
+    try {
+      stat = fs.statSync(fullPath);
+    } catch {
+      continue;
+    }
+    if (stat.isDirectory()) {
+      const segment = entry;
+      const translations = {};
+      if (segmentState[segment]) {
+        targetLocales.forEach((lang) => {
+          if (segmentState[segment][lang]) {
+            translations[lang] = segmentState[segment][lang];
+          }
+        });
+      }
+      const children = generateMultilingualSidebar(
+        baseContentDir,
+        path.join(relativeDir, entry),
+        sourceLocale,
+        targetLocales,
+        segmentState
+      );
+      if (children.length > 0) {
+        const label = segment.charAt(0).toUpperCase() + segment.slice(1);
+        items.push({
+          label,
+          items: children,
+          translations
+        });
+      }
+    } else if (/\.mdx?$/.test(entry)) {
+      const { title, slug, sidebar } = getMetadata(fullPath);
+      if (sidebar.hidden) continue;
+      const label = sidebar.label || title || path.basename(entry, path.extname(entry));
+      const relPath = path.join(relativeDir, entry);
+      const translations = getTranslations(
+        baseContentDir,
+        relPath,
+        targetLocales,
+        sourceLocale
+      );
+      const link = generateWebPath(relativeDir, entry, slug);
+      const { hidden, order, label: _, ...extraProps } = sidebar;
+      items.push({
+        label,
+        link,
+        translations,
+        ...extraProps
+      });
+    }
+  }
+  return items;
+}
+
+// src/starlight/index.ts
+function starlightTranslator() {
+  return {
+    name: "astro-llm-translator-starlight",
+    hooks: {
+      async setup({ config, updateConfig, logger }) {
+        let segmentState = {};
+        try {
+          const statePath = path2.resolve(
+            process.cwd(),
+            "src",
+            ".translator-segments.json"
+          );
+          const content = await fs2.readFile(statePath, "utf-8");
+          segmentState = JSON.parse(content);
+        } catch (e) {
+        }
+        const locales = config.locales ? Object.keys(config.locales) : ["root"];
+        const sourceLocale = config.defaultLocale || "root";
+        const targetLocales = locales.filter((l) => l !== sourceLocale);
+        const expandItems = (items) => {
+          return items.flatMap((item) => {
+            if (item.autogenerate) {
+              const dir = item.autogenerate.directory;
+              const generated = generateMultilingualSidebar(
+                "src/content/docs",
+                dir,
+                sourceLocale,
+                targetLocales,
+                segmentState
+              );
+              if (item.label) {
+                return [
+                  {
+                    label: item.label,
+                    translations: item.translations,
+                    items: generated,
+                    collapsed: item.collapsed
+                  }
+                ];
+              }
+              return generated;
+            } else if (item.items) {
+              return [
+                {
+                  ...item,
+                  items: expandItems(item.items)
+                }
+              ];
+            }
+            return [item];
+          });
+        };
+        if (Array.isArray(config.sidebar)) {
+          const newSidebar = expandItems(config.sidebar);
+          updateConfig({
+            sidebar: newSidebar
+          });
+          logger.info("Starlight sidebar expanded with multilingual labels.");
+        }
+      }
+    }
+  };
+}
+export {
+  starlightTranslator as default
+};

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "astro-llm-translator",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "Astro integration to automatically translate content using LLMs.",
+  "keywords": [
+    "astro",
+    "astro-integration",
+    "i18n",
+    "translation",
+    "llm",
+    "openai"
+  ],
+  "author": "Noa Virellia",
+  "license": "GPL-3.0-only",
+  "exports": {
+    ".": {
+      "types": "./dist/integration/index.d.ts",
+      "import": "./dist/integration/index.js"
+    },
+    "./starlight": {
+      "types": "./dist/starlight/index.d.ts",
+      "import": "./dist/starlight/index.js"
+    }
+  },
+  "main": "./dist/integration/index.js",
+  "types": "./dist/integration/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "astro dev",
+    "build": "astro build",
+    "build:lib": "tsup src/integration/index.ts src/starlight/index.ts --format esm --dts --clean",
+    "preview": "astro preview",
+    "astro": "astro",
+    "test": "vitest run",
+    "format": "biome format --write .",
+    "lint": "biome check ."
+  },
+  "dependencies": {
+    "dotenv": "^17.2.3",
+    "github-slugger": "^2.0.0",
+    "glob": "^13.0.0",
+    "gray-matter": "^4.0.3",
+    "zod": "3"
+  },
+  "peerDependencies": {
+    "astro": "^5.0.0",
+    "openai": "^4.0.0 || ^5.0.0 || ^6.0.0"
+  },
+  "devDependencies": {
+    "@astrojs/starlight": "^0.37.3",
+    "@biomejs/biome": "2.3.11",
+    "@types/github-slugger": "^2.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.0.9",
+    "astro": "^5.16.11",
+    "openai": "^6.16.0",
+    "tsup": "^8.5.1",
+    "vitest": "^4.0.17"
+  }
+}