docs-i18n 0.6.3 → 0.7.0

package/src/admin/server/index.ts

@@ -1,138 +0,0 @@
-import { spawn as nodeSpawn } from 'node:child_process';
-import { createServer } from 'node:http';
-import { readFileSync } from 'node:fs';
-import { resolve, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { Hono } from 'hono';
-import type { DocsI18nConfig } from '../../config';
-import { initStatus } from './services/status';
-import jobRoutes from './routes/jobs';
-import modelRoutes from './routes/models';
-import statusRoutes from './routes/status';
-import { setConfig } from './services/job-manager';
-
-function loadVersion(): string {
-  try {
-    // Walk up from dist/ to find package.json
-    let dir = dirname(fileURLToPath(import.meta.url));
-    for (let i = 0; i < 5; i++) {
-      try {
-        const pkg = JSON.parse(readFileSync(resolve(dir, 'package.json'), 'utf-8'));
-        if (pkg.name === 'docs-i18n') return pkg.version;
-      } catch {}
-      dir = dirname(dir);
-    }
-  } catch {}
-  return 'unknown';
-}
-const PKG_VERSION = loadVersion();
-
-export async function startAdmin(config: DocsI18nConfig, port = 3456) {
-  initStatus(config);
-  setConfig(config);
-
-  const app = new Hono();
-  app.get('/api/version', (c) => c.json({ version: PKG_VERSION }));
-  app.route('/api/status', statusRoutes);
-  app.route('/api/jobs', jobRoutes);
-  app.route('/api/models', modelRoutes);
-  app.get('/api/health', (c) => c.json({ ok: true }));
-  app.get('/api/config', (c) => c.json({ projectRoot: process.cwd() }));
-
-  // Open file in editor
-  app.post('/api/open-file', async (c) => {
-    const { file } = await c.req.json<{ file: string }>();
-    if (!file) return c.json({ error: 'Missing file' }, 400);
-    const fullPath = resolve(process.cwd(), file);
-    if (!fullPath.startsWith(process.cwd())) return c.json({ error: 'Invalid path' }, 400);
-
-    const candidates = process.env.EDITOR_CMD ? [process.env.EDITOR_CMD] : ['code', 'cursor', 'zed'];
-    for (const cmd of candidates) {
-      const found = await new Promise<boolean>((r) => {
-        const p = nodeSpawn('which', [cmd], { stdio: 'ignore' });
-        p.on('exit', (code) => r(code === 0));
-        p.on('error', () => r(false));
-      });
-      if (found) {
-        nodeSpawn(cmd, [fullPath], { stdio: 'ignore', detached: true }).unref();
-        return c.json({ opened: fullPath, editor: cmd });
-      }
-    }
-    const fallback = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
-    nodeSpawn(fallback, [fullPath], { stdio: 'ignore', detached: true }).unref();
-    return c.json({ opened: fullPath, editor: fallback });
-  });
-
-  // Resolve admin UI root — works both in dev (src/admin/) and installed (node_modules/docs-i18n/src/admin/)
-  const thisFile = new URL(import.meta.url).pathname;
-  // In bundled dist: thisFile is like .../dist/cli.js or .../dist/server-XXX.js
-  // Admin UI source is at .../src/admin/
-  const pkgRoot = resolve(thisFile, '..', '..');
-  const adminRoot = resolve(pkgRoot, 'src', 'admin');
-
-  // Try to load Vite for dev mode (SPA)
-  try {
-    const { createServer: createViteServer } = await import('vite');
-    const vite = await createViteServer({
-      root: adminRoot,
-      server: { middlewareMode: true },
-      appType: 'spa',
-    });
-
-    const server = createServer(async (req, res) => {
-      const url = req.url ?? '/';
-      if (url.startsWith('/api')) {
-        const headers = new Headers();
-        for (const [k, v] of Object.entries(req.headers)) {
-          if (v) headers.set(k, Array.isArray(v) ? v.join(', ') : v);
-        }
-        const body = req.method !== 'GET' && req.method !== 'HEAD'
-          ? await new Promise<string>((r) => {
-              let data = '';
-              req.on('data', (c: Buffer) => { data += c.toString(); });
-              req.on('end', () => r(data));
-            })
-          : undefined;
-        const webReq = new Request(`http://localhost:${port}${url}`, {
-          method: req.method,
-          headers,
-          body,
-        });
-        const webRes = await app.fetch(webReq);
-        res.writeHead(webRes.status, Object.fromEntries(webRes.headers.entries()));
-        res.end(Buffer.from(await webRes.arrayBuffer()));
-        return;
-      }
-      vite.middlewares(req, res);
-    });
-
-    server.listen(port, () => {
-      console.log(`🌐 docs-i18n admin → http://localhost:${port}`);
-    });
-  } catch (err) {
-    console.error('Failed to start admin UI with Vite:', (err as Error).message);
-    console.log('Starting API-only mode...');
-    // Fallback: Hono on Node http server without Vite
-    const server = createServer(async (req, res) => {
-      const url = req.url ?? '/';
-      const headers = new Headers();
-      for (const [k, v] of Object.entries(req.headers)) {
-        if (v) headers.set(k, Array.isArray(v) ? v.join(', ') : v);
-      }
-      const body = req.method !== 'GET' && req.method !== 'HEAD'
-        ? await new Promise<string>((r) => {
-            let data = '';
-            req.on('data', (c: Buffer) => { data += c.toString(); });
-            req.on('end', () => r(data));
-          })
-        : undefined;
-      const webReq = new Request(`http://localhost:${port}${url}`, { method: req.method, headers, body });
-      const webRes = await app.fetch(webReq);
-      res.writeHead(webRes.status, Object.fromEntries(webRes.headers.entries()));
-      res.end(Buffer.from(await webRes.arrayBuffer()));
-    });
-    server.listen(port, () => {
-      console.log(`🌐 docs-i18n admin (API only) → http://localhost:${port}`);
-    });
-  }
-}

package/src/admin/server/routes/jobs.ts

@@ -1,113 +0,0 @@
-import { Hono } from 'hono';
-import { streamSSE } from 'hono/streaming';
-import { jobManager } from '../services/job-manager';
-
-const app = new Hono();
-
-/** GET /api/jobs — List all jobs */
-app.get('/', (c) => {
-  return c.json(
-    jobManager.list().map((j) => ({
-      ...j,
-      logLines: (j.logLines ?? []).slice(-20), // Last 20 lines in list view
-    })),
-  );
-});
-
-/** POST /api/jobs — Start a new translation job */
-app.post('/', async (c) => {
-  const body = await c.req.json<{
-    lang: string;
-    version: string;
-    max?: number;
-    concurrency?: number;
-    model?: string;
-    modelRotate?: string[];
-    md5?: boolean;
-    files?: string[];
-  }>();
-
-  if (!body.lang || !body.version) {
-    return c.json({ error: 'Missing lang or version' }, 400);
-  }
-
-  try {
-    const job = jobManager.start(body);
-    return c.json(job, 201);
-  } catch (err) {
-    return c.json(
-      { error: err instanceof Error ? err.message : 'Unknown error' },
-      409,
-    );
-  }
-});
-
-/** GET /api/jobs/:id — Get job details */
-app.get('/:id', (c) => {
-  const job = jobManager.get(c.req.param('id'));
-  if (!job) return c.json({ error: 'Job not found' }, 404);
-  return c.json(job);
-});
-
-/** DELETE /api/jobs/:id — Cancel a running job or remove a finished one */
-app.delete('/:id', (c) => {
-  const id = c.req.param('id');
-  const job = jobManager.get(id);
-  if (!job) return c.json({ error: 'Job not found' }, 404);
-
-  if (job.status === 'running') {
-    jobManager.cancel(id);
-  } else {
-    jobManager.remove(id);
-  }
-  return c.json({ ok: true });
-});
-
-/** GET /api/jobs/:id/stream — SSE stream of job events */
-app.get('/:id/stream', (c) => {
-  const id = c.req.param('id');
-  const job = jobManager.get(id);
-  if (!job) return c.json({ error: 'Job not found' }, 404);
-
-  return streamSSE(c, async (stream) => {
-    // Send current state
-    await stream.writeSSE({
-      data: JSON.stringify({
-        type: 'state',
-        data: { ...job, logLines: (job.logLines ?? []).slice(-50) },
-      }),
-      event: 'message',
-    });
-
-    // Subscribe to future events
-    const unsubscribe = jobManager.subscribe(id, async (event) => {
-      try {
-        await stream.writeSSE({
-          data: JSON.stringify(event),
-          event: 'message',
-        });
-      } catch {
-        // Client disconnected
-        unsubscribe();
-      }
-    });
-
-    // Keep alive until client disconnects or job ends
-    while (true) {
-      const currentJob = jobManager.get(id);
-      if (!currentJob || currentJob.status !== 'running') {
-        // Send final state
-        await stream.writeSSE({
-          data: JSON.stringify({ type: 'done', data: currentJob }),
-          event: 'message',
-        });
-        break;
-      }
-      await stream.sleep(1000);
-    }
-
-    unsubscribe();
-  });
-});
-
-export default app;

package/src/admin/server/routes/status.ts

@@ -1,57 +0,0 @@
-import { Hono } from 'hono';
-import {
-  getCache,
-  getFileBlocks,
-  getFileCoverage,
-  getFileDetail,
-  getLangs,
-  getOverview,
-  getVersions,
-  rescan,
-} from '../services/status';
-
-const app = new Hono();
-
-app.get('/', (c) => {
-  return c.json({
-    versions: getVersions(),
-    langs: ['en', ...getLangs()],
-    data: getOverview(),
-  });
-});
-
-app.get('/:version/:lang', (c) => {
-  const { version, lang } = c.req.param();
-  if (lang === 'en') {
-    const anyLang = getLangs()[0];
-    const coverage = getFileCoverage(version, anyLang);
-    return c.json(coverage.map((f) => ({ file: f.file, total: f.total, translated: f.total })));
-  }
-  return c.json(getFileCoverage(version, lang));
-});
-
-app.get('/:version/:lang/blocks', (c) => {
-  const { version, lang } = c.req.param();
-  const filePath = c.req.query('path');
-  if (!filePath) return c.json({ error: 'Missing path query param' }, 400);
-  const blocks = getFileBlocks(version, lang, filePath);
-  if (!blocks) return c.json({ error: 'File not found' }, 404);
-  return c.json({ file: filePath, lang, version, blocks });
-});
-
-app.delete('/:version/:lang/cache', (c) => {
-  const { lang } = c.req.param();
-  const key = c.req.query('key');
-  if (!key) return c.json({ error: 'Missing key query param' }, 400);
-  const cache = getCache();
-  cache.db.prepare('DELETE FROM translations WHERE lang = ? AND key = ?').run(lang, key);
-  return c.json({ deleted: key, lang });
-});
-
-app.post('/:version/rescan', (c) => {
-  const { version } = c.req.param();
-  const count = rescan(version);
-  return c.json({ version, files: count });
-});
-
-export default app;

package/src/admin/ui/App.tsx

@@ -1,332 +0,0 @@
-import { useQuery } from '@tanstack/react-query';
-import { useCallback, useEffect, useState } from 'react';
-import { FileList } from './components/FileList';
-import { JobDialog } from './components/JobDialog';
-import { JobPanel } from './components/JobPanel';
-import { LangGrid } from './components/LangGrid';
-import { Preview } from './components/Preview';
-import { api } from './lib/api';
-
-type ViewMode = 'split' | 'en' | 'lang';
-type StatusFilter = 'all' | 'complete' | 'partial' | 'missing';
-type SectionFilter = 'all' | 'docs' | 'blog' | 'learn';
-
-// ── URL state helpers ──
-
-function readParams() {
-  const p = new URLSearchParams(window.location.search);
-  return {
-    version: p.get('v') || 'latest',
-    lang: p.get('lang') || null,
-    file: p.get('file') || null,
-    showFiles: p.get('files') !== '0',
-    view: (p.get('view') as ViewMode) || 'lang',
-    toc: p.get('toc') !== '0',
-    nodes: p.get('nodes') === '1',
-    status: (p.get('status') as StatusFilter) || 'all',
-    section: (p.get('section') as SectionFilter) || 'all',
-  };
-}
-
-function setParams(updates: Record<string, string | null>) {
-  const next = new URLSearchParams(window.location.search);
-  for (const [k, v] of Object.entries(updates)) {
-    if (v === null || v === '') next.delete(k);
-    else next.set(k, v);
-  }
-  const qs = next.toString();
-  window.history.replaceState(null, '', qs ? `?${qs}` : '/');
-}
-
-export function App() {
-  // bump to force re-read from URL
-  const [, rerender] = useState(0);
-  const bump = useCallback(() => rerender((n) => n + 1), []);
-
-  // Theme
-  const [theme, setThemeState] = useState(() => {
-    const saved = localStorage.getItem('theme');
-    return saved === 'light' ? 'light' : 'dark';
-  });
-  // Toast
-  const [toast, setToast] = useState<string | null>(null);
-
-  useEffect(() => {
-    document.documentElement.dataset.theme = theme;
-  }, [theme]);
-
-  useEffect(() => {
-    if (!toast) return;
-    const t = setTimeout(() => setToast(null), 3000);
-    return () => clearTimeout(t);
-  }, [toast]);
-
-  const { version, lang, file, showFiles, view, toc, nodes, status, section } =
-    readParams();
-
-  // ── URL setters ──
-
-  const setVersion = useCallback(
-    (v: string) => {
-      setParams({
-        v: v === 'latest' ? null : v,
-        file: null,
-      });
-      bump();
-    },
-    [bump],
-  );
-
-  const setLang = useCallback(
-    (l: string | null) => {
-      setParams({ lang: l });
-      bump();
-    },
-    [bump],
-  );
-
-  const setFile = useCallback(
-    (f: string | null) => {
-      setParams({ file: f });
-      bump();
-    },
-    [bump],
-  );
-
-  const setShowFiles = useCallback(
-    (show: boolean) => {
-      setParams({ files: show ? null : '0' });
-      bump();
-    },
-    [bump],
-  );
-
-  const setView = useCallback(
-    (m: ViewMode) => {
-      setParams({ view: m === 'lang' ? null : m });
-      bump();
-    },
-    [bump],
-  );
-
-  const setNodes = useCallback(
-    (show: boolean) => {
-      setParams({ nodes: show ? '1' : null });
-      bump();
-    },
-    [bump],
-  );
-
-  const setToc = useCallback(
-    (show: boolean) => {
-      setParams({ toc: show ? null : '0' });
-      bump();
-    },
-    [bump],
-  );
-
-  const setStatusFilter = useCallback(
-    (s: StatusFilter) => {
-      setParams({ status: s === 'all' ? null : s });
-      bump();
-    },
-    [bump],
-  );
-
-  const setSectionFilter = useCallback(
-    (s: SectionFilter) => {
-      setParams({ section: s === 'all' ? null : s });
-      bump();
-    },
-    [bump],
-  );
-
-  // ── Non-URL state ──
-  const [selected, setSelected] = useState<Set<string>>(new Set());
-  const [showDialog, setShowDialog] = useState(false);
-  const [dialogFiles, setDialogFiles] = useState<string[] | undefined>();
-
-  // ── Queries ──
-  const { data: statusData } = useQuery({
-    queryKey: ['status'],
-    queryFn: api.status,
-  });
-
-  const { data: versionInfo } = useQuery({
-    queryKey: ['version'],
-    queryFn: api.version,
-    staleTime: Number.POSITIVE_INFINITY,
-  });
-
-  const { data: files } = useQuery({
-    queryKey: ['files', version, lang],
-    queryFn: () => api.fileCoverage(version, lang as string),
-    enabled: !!lang,
-  });
-
-  // ── Handlers ──
-  const handleSelectVersion = useCallback(
-    (v: string) => {
-      setVersion(v);
-      setSelected(new Set());
-    },
-    [setVersion],
-  );
-
-  const handleSelectLang = useCallback(
-    (l: string) => {
-      setLang(l);
-      setSelected(new Set());
-    },
-    [setLang],
-  );
-
-  const handleToggle = useCallback((f: string) => {
-    setSelected((prev) => {
-      const next = new Set(prev);
-      if (next.has(f)) next.delete(f);
-      else next.add(f);
-      return next;
-    });
-  }, []);
-
-  const handleSelectAll = useCallback(
-    (fileList: string[]) => setSelected(new Set(fileList)),
-    [],
-  );
-
-  const handleClear = useCallback(() => setSelected(new Set()), []);
-
-  const handleTranslateSelected = useCallback(() => {
-    setDialogFiles([...selected]);
-    setShowDialog(true);
-  }, [selected]);
-
-  const handleNewJob = useCallback(() => {
-    setDialogFiles(undefined);
-    setShowDialog(true);
-  }, []);
-
-  if (!statusData) return <div className="loading">Loading...</div>;
-
-  return (
-    <>
-      <nav>
-        <h1>🌐 Translation Admin {versionInfo?.version && <span className="version-badge">v{versionInfo.version}</span>}</h1>
-        <span className="spacer" />
-        <button type="button" className="btn" onClick={handleNewJob}>
-          + New Job
-        </button>
-        <button
-          type="button"
-          className="btn btn-icon"
-          onClick={() => {
-            const next = theme === 'light' ? 'dark' : 'light';
-            setThemeState(next);
-            localStorage.setItem('theme', next);
-          }}
-          title="Toggle theme"
-        >
-          {theme === 'light' ? '🌙' : '☀️'}
-        </button>
-      </nav>
-
-      <div className="container">
-        {/* Version tabs */}
-        <div className="tabs">
-          {statusData.versions.map((v) => (
-            <button
-              key={v}
-              type="button"
-              className={`tab${v === version ? ' active' : ''}`}
-              onClick={() => handleSelectVersion(v)}
-            >
-              {v}
-            </button>
-          ))}
-        </div>
-
-        {/* Language cards */}
-        <LangGrid
-          data={statusData}
-          version={version}
-          selectedLang={lang}
-          onSelect={handleSelectLang}
-        />
-
-        {/* Jobs */}
-        <JobPanel />
-
-        {/* File list + Preview */}
-        {lang && files && (
-          <>
-            <div className="file-panel-toolbar">
-              <button
-                type="button"
-                className={`btn btn-sm${showFiles ? ' active' : ''}`}
-                onClick={() => setShowFiles(!showFiles)}
-              >
-                {showFiles ? '◀ Hide files' : '▶ Show files'}
-              </button>
-              {file && <span className="file-panel-current">{file}</span>}
-            </div>
-            <div
-              className={`file-panel${!showFiles ? ' no-list' : ''}${!file ? ' no-preview' : ''}`}
-            >
-              {showFiles && (
-                <FileList
-                  files={files}
-                  lang={lang}
-                  activeFile={file}
-                  selected={selected}
-                  statusFilter={status}
-                  sectionFilter={section}
-                  onStatusFilter={setStatusFilter}
-                  onSectionFilter={setSectionFilter}
-                  onSelect={setFile}
-                  onToggle={handleToggle}
-                  onSelectAll={handleSelectAll}
-                  onClear={handleClear}
-                  onTranslateSelected={handleTranslateSelected}
-                />
-              )}
-              {file && (
-                <Preview
-                  version={version}
-                  lang={lang}
-                  file={file}
-                  viewMode={view}
-                  onViewMode={setView}
-                  showToc={toc}
-                  onToggleToc={() => setToc(!toc)}
-                  showNodes={nodes}
-                  onToggleNodes={() => setNodes(!nodes)}
-                  onClose={() => setFile(null)}
-                />
-              )}
-            </div>
-          </>
-        )}
-      </div>
-
-      {/* Toast */}
-      {toast && <div className="toast">{toast}</div>}
-
-      {/* Job dialog */}
-      {showDialog && (
-        <JobDialog
-          langs={statusData.langs}
-          versions={statusData.versions}
-          defaultLang={lang || undefined}
-          defaultVersion={version}
-          files={dialogFiles}
-          onClose={() => setShowDialog(false)}
-          onSuccess={(msg) => {
-            setShowDialog(false);
-            setToast(msg);
-          }}
-        />
-      )}
-    </>
-  );
-}

package/src/admin/ui/main.tsx

@@ -1,19 +0,0 @@
-import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import { StrictMode } from 'react';
-import { createRoot } from 'react-dom/client';
-import { App } from './App';
-import './styles.css';
-
-const queryClient = new QueryClient({
-  defaultOptions: {
-    queries: { refetchOnWindowFocus: false, retry: 1 },
-  },
-});
-
-createRoot(document.getElementById('root')!).render(
-  <StrictMode>
-    <QueryClientProvider client={queryClient}>
-      <App />
-    </QueryClientProvider>
-  </StrictMode>,
-);