docs-i18n 0.1.0

package/README.md

@@ -0,0 +1,59 @@
+# docs-i18n
+
+Universal documentation translation engine. Parse markdown/MDX into translatable nodes, translate via LLM, cache in SQLite/D1, assemble translated files.
+
+## Features
+
+- **AST-based parsing** — splits markdown into translatable nodes with MD5 keys
+- **Incremental translation** — only translates changed/new content
+- **Smart chunking** — respects LLM context window and output token limits
+- **YAML-aware frontmatter** — translates title/description fields individually
+- **SQLite cache** — concurrent-safe with WAL mode, portable to Cloudflare D1
+- **Admin dashboard** — web UI for managing translation progress and jobs
+- **Framework-agnostic** — works with any docs site (Next.js, Astro, TanStack Start, etc.)
+
+## Quick Start
+
+```bash
+npm install docs-i18n
+```
+
+Create `docs-i18n.config.ts`:
+
+```ts
+import { defineConfig } from 'docs-i18n';
+
+export default defineConfig({
+  projects: {
+    mydocs: {
+      sources: { latest: 'content/latest' },
+    },
+  },
+  languages: ['zh-hans', 'ja', 'es'],
+  context: 'MyProject is a TypeScript library for building web apps.',
+});
+```
+
+```bash
+# Translate
+docs-i18n translate --lang zh-hans
+
+# Check status
+docs-i18n status
+
+# Start admin dashboard
+docs-i18n admin
+```
+
+## Runtime Translation (for SSR sites)
+
+```ts
+import { createTranslator } from 'docs-i18n/serve';
+
+const translator = createTranslator();
+const translated = await translator.translate(enMarkdown, 'zh-hans', env.DB);
+```
+
+## License
+
+MIT

package/dist/assemble-IOHQYYHI.js

@@ -0,0 +1,74 @@
+import {
+  assemble
+} from "./chunk-QSVWLTGQ.js";
+import "./chunk-SUIDX6IZ.js";
+import {
+  TranslationCache
+} from "./chunk-XEOYZUHS.js";
+import {
+  flattenSources
+} from "./chunk-3YNFMSJH.js";
+import "./chunk-AKLW2MUS.js";
+
+// src/commands/assemble.ts
+import {
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  writeFileSync
+} from "fs";
+import { dirname, join, resolve } from "path";
+function walkFiles(dir, extensions) {
+  const results = [];
+  if (!existsSync(dir)) return results;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const fullPath = join(dir, entry.name);
+    if (entry.isDirectory()) results.push(...walkFiles(fullPath, extensions));
+    else if (extensions.some((ext) => entry.name.endsWith(ext))) results.push(fullPath);
+  }
+  return results;
+}
+async function assembleAll(config, opts) {
+  const cacheDir = resolve(config.cacheDir ?? ".cache");
+  const outputBase = resolve(opts.outputDir ?? join(cacheDir, "content"));
+  const cache = new TranslationCache(cacheDir);
+  const sources = flattenSources(config);
+  const langs = opts.lang ? [opts.lang] : config.languages;
+  const extensions = (config.include ?? ["**/*.mdx", "**/*.md"]).map(
+    (p) => p.replace("**/*", "")
+  );
+  const t0 = Date.now();
+  let totalWritten = 0;
+  for (const source of sources) {
+    if (opts.project && source.project !== opts.project) continue;
+    if (opts.version && source.version !== opts.version) continue;
+    const enDir = resolve(source.sourcePath);
+    if (!existsSync(enDir)) {
+      console.log(`\u26A0 ${source.versionKey}: source dir not found, skipping`);
+      continue;
+    }
+    const enFiles = walkFiles(enDir, extensions);
+    for (const lang of langs) {
+      let written = 0;
+      for (const enFile of enFiles) {
+        const relPath = enFile.slice(enDir.length + 1);
+        const content = readFileSync(enFile, "utf8");
+        const result = assemble(content, lang, cache, relPath, true);
+        const outPath = join(outputBase, source.versionKey, lang, relPath);
+        mkdirSync(dirname(outPath), { recursive: true });
+        writeFileSync(outPath, result.content);
+        written++;
+      }
+      totalWritten += written;
+      console.log(`[${source.versionKey}/${lang}] ${written} files`);
+    }
+  }
+  const elapsed = ((Date.now() - t0) / 1e3).toFixed(1);
+  console.log(`
+\u2705 Assembled ${totalWritten} files in ${elapsed}s`);
+  cache.db.close();
+}
+export {
+  assembleAll
+};

package/dist/build-4EQEL4NI.js

@@ -0,0 +1,12 @@
+import {
+  createBuilder,
+  resolveBuildPlugins
+} from "./chunk-FYDB7MZX.js";
+import "./chunk-PTIH4GGE.js";
+import "./chunk-VKKNQBDN.js";
+import "./chunk-O35QHRY6.js";
+import "./chunk-AKLW2MUS.js";
+export {
+  createBuilder,
+  resolveBuildPlugins
+};