texlite 0.8.0 → 0.8.2

package/dist/client/assets/{minus-DR-ttrx3.js → minus-B08vgSQJ.js}

@@ -1 +1 @@
-import{j as e}from"./index-vpWlpUOr.js";const n=e("Maximize2",[["polyline",{points:"15 3 21 3 21 9",key:"mznyad"}],["polyline",{points:"9 21 3 21 3 15",key:"1avn1i"}],["line",{x1:"21",x2:"14",y1:"3",y2:"10",key:"ota7mn"}],["line",{x1:"3",x2:"10",y1:"21",y2:"14",key:"1atl0r"}]]);const a=e("Minus",[["path",{d:"M5 12h14",key:"1ays0h"}]]);export{a as M,n as a};
+import{j as e}from"./index-Dx9UqMyC.js";const n=e("Maximize2",[["polyline",{points:"15 3 21 3 21 9",key:"mznyad"}],["polyline",{points:"9 21 3 21 3 15",key:"1avn1i"}],["line",{x1:"21",x2:"14",y1:"3",y2:"10",key:"ota7mn"}],["line",{x1:"3",x2:"10",y1:"21",y2:"14",key:"1atl0r"}]]);const a=e("Minus",[["path",{d:"M5 12h14",key:"1ays0h"}]]);export{a as M,n as a};

package/dist/client/assets/{spellCheck-Wn7_eF9j.js → spellCheck-9fdyhJtV.js}

@@ -1 +1 @@
-import{a as k}from"./index-vpWlpUOr.js";import"./react-BoEjKzFZ.js";const S=5,u=new Map,x=12;let p=!1,f=null;class h extends Error{constructor(){super("A newer writing check replaced this request."),this.name="HarperLintSupersededError"}}function A(t){return t instanceof h}function v(t){const e=[0];let n=0;for(const r of t)n+=r.length,e.push(n);return e}function L(t){return[...new Set(t.map(e=>e.trim()).filter(Boolean))].sort((e,n)=>e.localeCompare(n)).join("\0")}async function C(t,e,n){return(await k(`/api/projects/${t}/spellcheck`,{method:"POST",body:JSON.stringify({path:e,source:n})})).lints}function R(t,e,n){if(!e.problem)return null;const r={from:e.start,to:e.end},o={from:n[e.start]??-1,to:n[e.end]??-1},i=c=>c.from>=0&&c.to>c.from&&c.to<=t.length,a=c=>i(c)&&t.slice(c.from,c.to)===e.problem;return a(o)?o:a(r)?r:null}function $(t,e,n){const r=R(t,e,n);if(!r)return null;const{from:o,to:i}=r,a=t.slice(o,i);if(!a.trim()||!/[A-Za-z]/.test(a)||e.kind==="Formatting")return null;const c=e.kind==="Spelling"||e.kind==="Typo"?"spelling":"grammar",m=e.suggestions.filter((d,s,l)=>s<S&&l.indexOf(d)===s);return{from:o,to:i,word:a,kind:c,message:e.message,suggestions:m}}function g(t,e){let n=2166136261;for(let r=0;r<e.length;r+=1)n^=e.charCodeAt(r),n=Math.imul(n,16777619);return`${t}\0${e.length}:${n>>>0}`}function y(t,e,n){const r=g(t,e),o=u.get(r);return!o||o.path!==t||o.source!==e||o.dictionary!==n?null:(u.delete(r),u.set(r,o),o.issues)}function j(t,e,n,r){const o=g(t,e);for(u.set(o,{path:t,source:e,dictionary:n,issues:r});u.size>x;){const i=u.keys().next().value;if(i===void 0)break;u.delete(i)}}async function q(t,e,n,r="main.tex"){const o=L(e),i=y(r,t,o);if(i)return i;const a=v(t),c=new Set(e.map(s=>s.trim().toLocaleLowerCase("en-US")).filter(Boolean)),m=new Set,d=n.map(s=>$(t,s,a)).filter(s=>!!s).filter(s=>s.kind!=="spelling"||!c.has(s.word.trim().toLocaleLowerCase("en-US"))).filter(s=>{const l=`${s.from}:${s.to}:${s.kind}`;return m.has(l)?!1:(m.add(l),!0)}).sort((s,l)=>s.from-l.from||s.to-l.to);return j(r,t,o,d),d}async function b(t,e,n,r){const o=L(r),i=y(e,n,o);if(i)return i;const a=await C(t,e,n);return q(n,r,a,e)}async function w(){if(p||!f)return;const t=f;f=null,p=!0;try{t.resolve(await b(t.projectId,t.path,t.source,t.customWords))}catch(e){t.reject(e)}finally{p=!1,w()}}function B(t,e,n,r=[]){return new Promise((o,i)=>{f?.reject(new h),f={projectId:t,path:e,source:n,customWords:[...r],resolve:o,reject:i},w()})}export{h as HarperLintSupersededError,A as isHarperLintSupersededError,B as lintLatex,q as mapLatexLints};
+import{a as k}from"./index-Dx9UqMyC.js";import"./react-BoEjKzFZ.js";const S=5,u=new Map,x=12;let p=!1,f=null;class h extends Error{constructor(){super("A newer writing check replaced this request."),this.name="HarperLintSupersededError"}}function A(t){return t instanceof h}function v(t){const e=[0];let n=0;for(const r of t)n+=r.length,e.push(n);return e}function L(t){return[...new Set(t.map(e=>e.trim()).filter(Boolean))].sort((e,n)=>e.localeCompare(n)).join("\0")}async function C(t,e,n){return(await k(`/api/projects/${t}/spellcheck`,{method:"POST",body:JSON.stringify({path:e,source:n})})).lints}function R(t,e,n){if(!e.problem)return null;const r={from:e.start,to:e.end},o={from:n[e.start]??-1,to:n[e.end]??-1},i=c=>c.from>=0&&c.to>c.from&&c.to<=t.length,a=c=>i(c)&&t.slice(c.from,c.to)===e.problem;return a(o)?o:a(r)?r:null}function $(t,e,n){const r=R(t,e,n);if(!r)return null;const{from:o,to:i}=r,a=t.slice(o,i);if(!a.trim()||!/[A-Za-z]/.test(a)||e.kind==="Formatting")return null;const c=e.kind==="Spelling"||e.kind==="Typo"?"spelling":"grammar",m=e.suggestions.filter((d,s,l)=>s<S&&l.indexOf(d)===s);return{from:o,to:i,word:a,kind:c,message:e.message,suggestions:m}}function g(t,e){let n=2166136261;for(let r=0;r<e.length;r+=1)n^=e.charCodeAt(r),n=Math.imul(n,16777619);return`${t}\0${e.length}:${n>>>0}`}function y(t,e,n){const r=g(t,e),o=u.get(r);return!o||o.path!==t||o.source!==e||o.dictionary!==n?null:(u.delete(r),u.set(r,o),o.issues)}function j(t,e,n,r){const o=g(t,e);for(u.set(o,{path:t,source:e,dictionary:n,issues:r});u.size>x;){const i=u.keys().next().value;if(i===void 0)break;u.delete(i)}}async function q(t,e,n,r="main.tex"){const o=L(e),i=y(r,t,o);if(i)return i;const a=v(t),c=new Set(e.map(s=>s.trim().toLocaleLowerCase("en-US")).filter(Boolean)),m=new Set,d=n.map(s=>$(t,s,a)).filter(s=>!!s).filter(s=>s.kind!=="spelling"||!c.has(s.word.trim().toLocaleLowerCase("en-US"))).filter(s=>{const l=`${s.from}:${s.to}:${s.kind}`;return m.has(l)?!1:(m.add(l),!0)}).sort((s,l)=>s.from-l.from||s.to-l.to);return j(r,t,o,d),d}async function b(t,e,n,r){const o=L(r),i=y(e,n,o);if(i)return i;const a=await C(t,e,n);return q(n,r,a,e)}async function w(){if(p||!f)return;const t=f;f=null,p=!0;try{t.resolve(await b(t.projectId,t.path,t.source,t.customWords))}catch(e){t.reject(e)}finally{p=!1,w()}}function B(t,e,n,r=[]){return new Promise((o,i)=>{f?.reject(new h),f={projectId:t,path:e,source:n,customWords:[...r],resolve:o,reject:i},w()})}export{h as HarperLintSupersededError,A as isHarperLintSupersededError,B as lintLatex,q as mapLatexLints};

package/dist/client/index.html

@@ -10,9 +10,9 @@
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fontsource/iosevka@5.2.5/400.css" />
     <link rel="icon" type="image/svg+xml" href="/logo.svg" />
     <title>TexLite</title>
-    <script type="module" crossorigin src="/assets/index-vpWlpUOr.js"></script>
+    <script type="module" crossorigin src="/assets/index-Dx9UqMyC.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/react-BoEjKzFZ.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-CdiutUgf.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-DzzqNm9b.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/server/app.js

@@ -31,7 +31,9 @@ import { registerProjectGitRoutes } from "./routes/projectGit.js";
 import { registerProjectCatalogRoutes } from "./routes/projects.js";
 import { registerSystemRoutes } from "./routes/system.js";
 import { registerUserManagementRoutes } from "./routes/users.js";
+import { registerWordCountRoutes } from "./routes/wordCount.js";
 import { HarperService } from "./harper.js";
+import { TexcountService } from "./texcount.js";
 // Retained public helper for callers and tests; implementation lives with the file routes.
 export { escapeGlobPattern } from "./routes/projectShared.js";
 const SESSION_CLEANUP_INTERVAL_MS = 15 * 60_000;
@@ -50,6 +52,7 @@ export async function buildApp(config, db, options = {}) {
     const latexCompletions = new LatexCompletionService(config);
     const projectOutlines = new ProjectOutlineService(config);
     const harper = new HarperService();
+    const texcount = new TexcountService();
     // Probe the optional host Harper CLI without delaying startup. Its absence is
     // supported: the browser spellchecker remains the writing-check fallback.
     void harper.preload().catch((error) => app.log.info({ err: error }, "Optional Harper CLI is unavailable"));
@@ -106,6 +109,7 @@ export async function buildApp(config, db, options = {}) {
     app.addHook("onClose", async () => {
         eventLoopDelay.disable();
         await harper.dispose();
+        await texcount.dispose();
     });
     await app.register(cookie, { hook: "onRequest" });
     await app.register(websocket, { options: { maxPayload: 6 * 1024 * 1024 } });
@@ -195,6 +199,7 @@ export async function buildApp(config, db, options = {}) {
         harper,
         recordHistory
     });
+    registerWordCountRoutes(app, { config, db, projectMutations, texcount });
     registerCompileRoutes(app, { config, db, collaboration, projectMutations, compileCoordinator, metrics, pruneCompileRuns });
     // The factory owns shared services and lifecycle hooks; route modules own endpoint behavior.
     app.addHook("onRequest", async (request) => {

package/dist/server/cli.js

@@ -8,7 +8,7 @@ import { fileURLToPath } from "node:url";
 import { CONFIG_DEFAULTS, loadConfig } from "./config.js";
 import { activeAdminCount, openDatabase } from "./db.js";
 import { hashPassword, MIN_PASSWORD_LENGTH } from "./security.js";
-import { assertEnvironment, assertGitAvailable } from "./environment.js";
+import { assertEnvironment, hostRequirementsSatisfied, inspectHostEnvironment, inspectHostRequirements } from "./environment.js";
 import { serve } from "./index.js";
 import { processStatus, restartManaged, startManaged, stopManaged, streamLogs, waitForOnline } from "./pm2.js";
 import { defaultDataDirectory, resolveConfigPath } from "./runtimePaths.js";
@@ -18,42 +18,38 @@ Usage:
   texlite <command> [options]
 
 Commands:
-  init       Create the configuration, initialize storage, and create the first administrator.
-  serve      Run the server in the foreground for debugging, Docker, or systemd.
-  start      Start the server in the background under PM2.
-  status     Show the status of the PM2-managed server.
-  stop       Stop the PM2-managed server.
-  restart    Restart (or start) the PM2-managed server.
-  logs       Stream logs from the PM2-managed server.
-  doctor     Validate configuration, paths, LaTeX, and the administrator.
-  config     Print the effective configuration as JSON without changing it.
-  help       Show this help message.
-  version    Print the installed TexLite version.
+  init          Create the configuration, initialize storage, and create the first administrator.
+  serve         Run the server in the foreground for debugging, Docker, or systemd.
+  start         Start the server in the background under PM2.
+  status        Show the status of the PM2-managed server.
+  stop          Stop the PM2-managed server.
+  restart       Restart (or start) the PM2-managed server.
+  logs          Stream logs from the PM2-managed server.
+  doctor        Check configuration, application state, and host dependencies.
+  requirements  Check host software on PATH without loading TexLite configuration.
+  config        Print the effective configuration as JSON without changing it.
+  help          Show this help message.
+  version       Print the installed TexLite version.
 
 Options:
   --config PATH  Use this configuration file instead of TEXLITE_CONFIG or the XDG default.
-  --git          Make doctor check the optional Git integration as well.
-  --json         Print status as JSON for scripts instead of the terminal view.
+                 Requirements does not accept this option.
+  --json         Print status, doctor, or requirements results as JSON for scripts.
   -h, --help     Show this help message.
   -v, --version  Print the installed TexLite version.
 `;
 export function parseArgs(args) {
     let command = "help";
     let configPath;
-    let checkGit = false;
     let json = false;
     for (let index = 0; index < args.length; index += 1) {
         const argument = args[index];
         if (!argument)
             continue;
         if (argument === "-h" || argument === "--help")
-            return { command: "help", configPath, checkGit, json };
+            return { command: "help", configPath, json };
         if (argument === "-v" || argument === "--version")
-            return { command: "version", configPath, checkGit, json };
-        if (argument === "--git") {
-            checkGit = true;
-            continue;
-        }
+            return { command: "version", configPath, json };
         if (argument === "--json") {
             json = true;
             continue;
@@ -78,7 +74,10 @@ export function parseArgs(args) {
             throw new Error(`Only one command may be specified (already received ${command})`);
         command = argument;
     }
-    return { command, configPath, checkGit, json };
+    if (command === "requirements" && configPath) {
+        throw new Error("`texlite requirements` does not use --config.");
+    }
+    return { command, configPath, json };
 }
 function output(message) {
     stdout.write(`${message}\n`);
@@ -209,16 +208,64 @@ async function assertAdmin(config) {
 }
 async function doctor(options) {
     const { config, configPath } = await loadValidatedConfig(options);
-    const environment = await assertEnvironment(config);
-    await assertAdmin(config);
-    output(`Configuration is valid: ${configPath}`);
-    output(`Data directory: ${config.dataDir}`);
-    output(`Client assets: ${config.clientDir}`);
-    output(`Environment: ${environment.map((item) => `${item.name} ${item.version}`).join("; ")}`);
-    if (options.checkGit)
-        output(`Git: ${(await assertGitAvailable(config)).version}`);
-    else
-        output("Git: not checked (Git integration is optional; use --git to check it)");
+    const application = inspectDoctorApplication(config, configPath);
+    const hostTools = await inspectHostEnvironment(config);
+    const report = {
+        configPath,
+        dataDir: config.dataDir,
+        clientDir: config.clientDir,
+        application,
+        hostTools,
+        ok: application.every((check) => check.status === "passed")
+            && hostRequirementsSatisfied(hostTools)
+    };
+    output(options.json ? JSON.stringify(report, null, 2) : formatDoctorReport(report, terminalColorsEnabled()));
+    if (!report.ok)
+        process.exitCode = 2;
+}
+async function requirements(options) {
+    const hostTools = await inspectHostRequirements();
+    const report = { hostTools, ok: hostRequirementsSatisfied(hostTools) };
+    output(options.json ? JSON.stringify(report, null, 2) : formatRequirementsReport(report, terminalColorsEnabled()));
+    if (!report.ok)
+        process.exitCode = 2;
+}
+function inspectDoctorApplication(config, configPath) {
+    const checks = [
+        { name: "Configuration", status: "passed", detail: `Valid: ${configPath}` },
+        inspectClientAssets(config)
+    ];
+    let db = null;
+    try {
+        db = openDatabase(config);
+        checks.push({ name: "Data and database", status: "passed", detail: `Opened: ${config.databasePath}` });
+        const administrators = activeAdminCount(db);
+        checks.push(administrators > 0
+            ? { name: "Administrator", status: "passed", detail: `${administrators} active administrator${administrators === 1 ? "" : "s"}` }
+            : { name: "Administrator", status: "failed", detail: "No active administrator. Run `texlite init`." });
+    }
+    catch (error) {
+        const detail = errorMessage(error);
+        checks.push({ name: "Data and database", status: "failed", detail });
+        checks.push({ name: "Administrator", status: "failed", detail: "Could not inspect because the database is unavailable." });
+    }
+    finally {
+        db?.close();
+    }
+    return checks;
+}
+function inspectClientAssets(config) {
+    const entry = path.join(config.clientDir, "index.html");
+    try {
+        const stat = fs.statSync(entry);
+        if (stat.isFile())
+            return { name: "Client assets", status: "passed", detail: `Found: ${entry}` };
+    }
+    catch { /* Report a concise diagnostic below. */ }
+    return { name: "Client assets", status: "failed", detail: `Missing ${entry}; run \`npm run build\` or reinstall TexLite.` };
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message.replace(/\s+/g, " ").slice(0, 240) : String(error).slice(0, 240);
 }
 async function printConfig(options) {
     const { config, configPath } = await loadValidatedConfig(options);
@@ -282,6 +329,94 @@ function terminalColorsEnabled() {
 function colorize(value, color, enabled) {
     return enabled ? `${ANSI[color]}${value}${ANSI.reset}` : value;
 }
+export function formatDoctorReport(report, colors = false) {
+    const titleColor = report.ok ? "green" : "red";
+    const title = report.ok ? "all required checks passed" : "required checks need attention";
+    const applicationRows = report.application.map((check) => [
+        { text: check.name },
+        { text: "Required" },
+        { text: check.status === "passed" ? "Passed" : "Failed", color: check.status === "passed" ? "green" : "red" },
+        { text: shortenDoctorCell(check.detail, 68) }
+    ]);
+    return [
+        `${colorize("●", titleColor, colors)} ${colors ? `${ANSI.bold}TexLite doctor${ANSI.reset}` : "TexLite doctor"} — ${colorize(title, titleColor, colors)}`,
+        `     Config: ${report.configPath}`,
+        `       Data: ${report.dataDir}`,
+        `     Client: ${report.clientDir}`,
+        "",
+        "Application checks",
+        formatDoctorTable(["Check", "Need", "Status", "Details"], applicationRows, colors),
+        "",
+        "Host software",
+        formatHostSoftwareTable(report.hostTools, colors),
+        "",
+        hostRequirementNote(report.hostTools, "start TexLite"),
+        "Harper CLI is used by TexLite; harper-ls is reported for host diagnostics and external editor integrations."
+    ].join("\n");
+}
+export function formatRequirementsReport(report, colors = false) {
+    const titleColor = report.ok ? "green" : "red";
+    const title = report.ok ? "all host requirements passed" : "host requirements need attention";
+    return [
+        `${colorize("●", titleColor, colors)} ${colors ? `${ANSI.bold}TexLite requirements${ANSI.reset}` : "TexLite requirements"} — ${colorize(title, titleColor, colors)}`,
+        "",
+        "Host software (default commands on PATH)",
+        formatHostSoftwareTable(report.hostTools, colors),
+        "",
+        hostRequirementNote(report.hostTools, "compile with TexLite"),
+        "This command does not read a TexLite configuration, data directory, database, or administrator state.",
+        "Harper CLI is used by TexLite; harper-ls is reported for host diagnostics and external editor integrations."
+    ].join("\n");
+}
+function formatHostSoftwareTable(hostTools, colors) {
+    const hostRows = hostTools.map((tool) => [
+        { text: shortenDoctorCell(tool.command === tool.name ? tool.name : `${tool.name} (${tool.command})`, 32) },
+        { text: requirementLabel(tool.requirement) },
+        hostToolStatusCell(tool),
+        { text: shortenDoctorCell(tool.version ?? tool.detail ?? "—", 56) }
+    ]);
+    return formatDoctorTable(["Tool / command", "Need", "Status", "Version / diagnostic"], hostRows, colors);
+}
+function requirementLabel(requirement) {
+    if (requirement === "required")
+        return "Required";
+    if (requirement === "one-of")
+        return "One of";
+    return "Optional";
+}
+function hostRequirementNote(hostTools, action) {
+    const oneOf = hostTools.some((tool) => tool.requirement === "one-of");
+    return oneOf
+        ? `Required tools and at least one tool in every “One of” group must be installed to ${action}. Optional tools enable their named feature without blocking the editor.`
+        : `Required tools must be installed to ${action}. Optional tools enable their named feature without blocking the editor.`;
+}
+function hostToolStatusCell(tool) {
+    if (tool.status === "installed")
+        return { text: "Installed", color: "green" };
+    if (tool.status === "missing") {
+        return { text: tool.requirement === "required" ? "Missing" : "Not installed", color: tool.requirement === "required" ? "red" : "yellow" };
+    }
+    return { text: "Failed", color: "red" };
+}
+function shortenDoctorCell(value, maxLength) {
+    const normalized = value.replace(/\s+/g, " ").trim();
+    return normalized.length > maxLength ? `${normalized.slice(0, Math.max(1, maxLength - 1))}…` : normalized;
+}
+function formatDoctorTable(headers, rows, colors) {
+    const widths = headers.map((header, index) => Math.max(header.length, ...rows.map((row) => row[index]?.text.length ?? 0)));
+    const line = (left, middle, right, fill) => `${left}${widths.map((width) => fill.repeat(width + 2)).join(middle)}${right}`;
+    const renderRow = (cells) => `│${cells.map((cell, index) => {
+        const padded = (cell?.text ?? "").padEnd(widths[index] ?? 0);
+        return ` ${cell?.color ? colorize(padded, cell.color, colors) : padded} `;
+    }).join("│")}│`;
+    return [
+        line("┌", "┬", "┐", "─"),
+        renderRow(headers.map((text) => ({ text }))),
+        line("├", "┼", "┤", "─"),
+        ...rows.map(renderRow),
+        line("└", "┴", "┘", "─")
+    ].join("\n");
+}
 function duration(value) {
     if (value === null)
         return "n/a";
@@ -371,6 +506,9 @@ async function run(options) {
         case "doctor":
             await doctor(options);
             return;
+        case "requirements":
+            await requirements(options);
+            return;
         case "config":
             await printConfig(options);
             return;

package/dist/server/db.js

@@ -39,6 +39,7 @@ function migrate(db) {
       main_file TEXT NOT NULL DEFAULT 'main.tex',
       latexmkrc TEXT,
       engine TEXT NOT NULL DEFAULT 'xelatex' CHECK (engine IN ('pdflatex', 'xelatex', 'lualatex')),
+      icon TEXT,
       created_at TEXT NOT NULL,
       updated_at TEXT NOT NULL
     );
@@ -231,6 +232,9 @@ function migrate(db) {
     if (!projectColumns.some((column) => column.name === "last_modified_by")) {
         db.exec("ALTER TABLE projects ADD COLUMN last_modified_by TEXT REFERENCES users(id) ON DELETE SET NULL");
     }
+    if (!projectColumns.some((column) => column.name === "icon")) {
+        db.exec("ALTER TABLE projects ADD COLUMN icon TEXT");
+    }
     const commentColumns = db.prepare("PRAGMA table_info(comments)").all();
     const additions = [
         ["start_offset", "INTEGER NOT NULL DEFAULT 0"],

package/dist/server/environment.js

@@ -1,50 +1,167 @@
 import { spawn } from "node:child_process";
+import { LATEX_ENGINES } from "./config.js";
 import { httpError } from "./http.js";
 import { detachedProcessGroup, killProcessGroup } from "./processTree.js";
-export async function assertEnvironment(config) {
-    const commands = [
-        { name: "latexmk", command: config.latexmk },
-        ...config.allowedEngines.map((command) => ({ name: command, command }))
-    ];
-    const checked = [];
-    const seen = new Set();
-    for (const item of commands) {
-        if (seen.has(item.command))
+export const MIN_NODE_MAJOR = 24;
+const commandProbeTimeoutMs = 10_000;
+const maxCommandOutputBytes = 64 * 1024;
+/**
+ * Probe all tools that are relevant to a TexLite host. Optional tools are
+ * included deliberately: their absence must be visible in `doctor`, but does
+ * not prevent TexLite from starting.
+ */
+export async function inspectHostEnvironment(config) {
+    return Promise.all(hostToolDefinitions(config).map((tool) => inspectTool(tool)));
+}
+/**
+ * Probe the default commands on PATH without loading a TexLite configuration.
+ * This supports pre-installation checks through `texlite requirements`.
+ */
+export async function inspectHostRequirements() {
+    return Promise.all(hostRequirementToolDefinitions().map((tool) => inspectTool(tool)));
+}
+export function hostRequirementsSatisfied(tools) {
+    if (tools.some((tool) => tool.requirement === "required" && tool.status !== "installed"))
+        return false;
+    const oneOfGroups = new Map();
+    for (const tool of tools) {
+        if (tool.requirement !== "one-of")
             continue;
-        seen.add(item.command);
-        const result = await commandVersion(item.command, 10_000);
-        if (result.error || result.status !== 0) {
-            const detail = result.error || result.stderr.trim() || `exit ${result.status ?? "unknown"}`;
-            throw new Error(`Environment check failed: could not run the ${item.name} command "${item.command}" (${detail}). Initialization/startup has been stopped.`);
-        }
-        const version = `${result.stdout || result.stderr}`.trim().split("\n")[0]?.slice(0, 160) || "available";
-        checked.push({ ...item, version });
+        const group = tool.requirementGroup ?? tool.id;
+        const members = oneOfGroups.get(group) ?? [];
+        members.push(tool);
+        oneOfGroups.set(group, members);
+    }
+    return [...oneOfGroups.values()].every((members) => members.some((tool) => tool.status === "installed"));
+}
+export async function assertEnvironment(config) {
+    const tools = await Promise.all(requiredToolDefinitions(config).map((tool) => inspectTool(tool)));
+    const unavailable = tools.find((tool) => tool.status !== "installed");
+    if (unavailable) {
+        const detail = unavailable.detail ?? "unknown error";
+        throw new Error(`Environment check failed: could not run the ${unavailable.name} command "${unavailable.command}" (${detail}). Initialization/startup has been stopped.`);
     }
-    return checked;
+    return tools.map(({ name, command, version }) => ({ name, command, version: version ?? "available" }));
 }
 export async function assertGitAvailable(config) {
-    const item = { name: "Git", command: config.git };
-    const result = await commandVersion(item.command, Math.min(config.gitOperationTimeoutMs, 10_000));
-    if (result.error || result.status !== 0) {
-        const detail = result.error || result.stderr.trim() || `exit ${result.status ?? "unknown"}`;
-        // Command output can reveal host paths; it remains a startup diagnostic,
-        // while API clients receive the localized, stable error code.
-        void detail;
+    const tool = await inspectTool(gitToolDefinition(config.git, Math.min(config.gitOperationTimeoutMs, commandProbeTimeoutMs)));
+    if (tool.status !== "installed")
         throw httpError(503, "GIT_UNAVAILABLE");
+    return { name: tool.name, command: tool.command, version: tool.version ?? "available" };
+}
+function requiredToolDefinitions(config) {
+    return [
+        { id: "node", name: `Node.js ${MIN_NODE_MAJOR}+`, command: "node", requirement: "required", purpose: "TexLite runtime" },
+        { id: "latexmk", name: "latexmk", command: config.latexmk, requirement: "required", purpose: "LaTeX compilation" },
+        ...config.allowedEngines.map((command) => ({
+            id: `engine:${command}`, name: command, command, requirement: "required",
+            purpose: "Configured LaTeX engine"
+        }))
+    ];
+}
+function hostToolDefinitions(config) {
+    return [
+        ...requiredToolDefinitions(config),
+        ...optionalToolDefinitions(config.git, Math.min(config.gitOperationTimeoutMs, commandProbeTimeoutMs))
+    ];
+}
+function hostRequirementToolDefinitions() {
+    return [
+        { id: "node", name: `Node.js ${MIN_NODE_MAJOR}+`, command: "node", requirement: "required", purpose: "TexLite runtime" },
+        { id: "latexmk", name: "latexmk", command: "latexmk", requirement: "required", purpose: "LaTeX compilation" },
+        ...LATEX_ENGINES.map((command) => ({
+            id: `engine:${command}`, name: command, command, requirement: "one-of",
+            requirementGroup: "latex-engine", purpose: "Supported LaTeX engine"
+        })),
+        ...optionalToolDefinitions("git", commandProbeTimeoutMs)
+    ];
+}
+function optionalToolDefinitions(gitCommand, gitTimeoutMs) {
+    return [
+        gitToolDefinition(gitCommand, gitTimeoutMs),
+        { id: "texcount", name: "TeXcount", command: "texcount", requirement: "optional", purpose: "Word and character statistics", versionArgs: ["-version"] },
+        { id: "bibtex", name: "BibTeX", command: "bibtex", requirement: "optional", purpose: "BibTeX bibliography builds" },
+        { id: "biber", name: "Biber", command: "biber", requirement: "optional", purpose: "Biber bibliography builds" },
+        { id: "makeindex", name: "MakeIndex", command: "makeindex", requirement: "optional", purpose: "Index generation", versionArgs: [] },
+        { id: "harper-cli", name: "Harper CLI", command: "harper-cli", requirement: "optional", purpose: "TexLite spelling and grammar checks" },
+        { id: "harper-ls", name: "Harper language server", command: "harper-ls", requirement: "optional", purpose: "External editor integration (not used by TexLite)" }
+    ];
+}
+function gitToolDefinition(command, timeoutMs) {
+    return { id: "git", name: "Git", command, requirement: "optional", purpose: "Git and GitHub backup", timeoutMs };
+}
+async function inspectTool(tool) {
+    if (tool.id === "node")
+        return inspectNode(tool);
+    const identity = toolIdentity(tool);
+    const result = await commandVersion(tool.command, tool.timeoutMs ?? commandProbeTimeoutMs, tool.versionArgs ?? ["--version"]);
+    if (!result.error && result.status === 0) {
+        return { ...identity, status: "installed", version: versionFromResult(result), detail: null };
     }
-    const version = `${result.stdout || result.stderr}`.trim().split("\n")[0]?.slice(0, 160) || "available";
-    return { ...item, version };
+    const missing = result.errorCode === "ENOENT";
+    return {
+        ...identity,
+        status: missing ? "missing" : "failed",
+        version: null,
+        detail: commandFailureDetail(result)
+    };
+}
+function inspectNode(tool) {
+    const identity = toolIdentity(tool);
+    const match = /^v(\d+)/.exec(process.version);
+    const major = match ? Number(match[1]) : Number.NaN;
+    if (Number.isInteger(major) && major >= MIN_NODE_MAJOR) {
+        return { ...identity, status: "installed", version: process.version, detail: null };
+    }
+    return {
+        ...identity,
+        status: "failed",
+        version: process.version || null,
+        detail: `TexLite requires Node.js ${MIN_NODE_MAJOR} or newer.`
+    };
+}
+function toolIdentity(tool) {
+    return {
+        id: tool.id,
+        name: tool.name,
+        command: tool.command,
+        requirement: tool.requirement,
+        requirementGroup: tool.requirementGroup,
+        purpose: tool.purpose
+    };
+}
+function versionFromResult(result) {
+    const lines = `${result.stdout}\n${result.stderr}`.split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line && !/^warning\b/i.test(line) && !/^possible precedence problem\b/i.test(line));
+    const versionLine = lines.find((line) => /\bversion\b|\bv?\d+\.\d+/i.test(line)) ?? lines[0];
+    return (versionLine ?? "available").slice(0, 160);
 }
-function commandVersion(command, timeoutMs) {
+function commandFailureDetail(result) {
+    const detail = result.error || result.stderr.trim() || result.stdout.trim() || `exit ${result.status ?? "unknown"}`;
+    return detail.replace(/\s+/g, " ").slice(0, 240);
+}
+function commandVersion(command, timeoutMs, args) {
     return new Promise((resolve) => {
-        const child = spawn(command, ["--version"], {
-            env: { ...process.env, LC_ALL: "C" }, shell: false, detached: detachedProcessGroup(),
-            stdio: ["ignore", "pipe", "pipe"]
-        });
+        let child;
+        try {
+            child = spawn(command, args, {
+                env: { ...process.env, LC_ALL: "C" }, shell: false, detached: detachedProcessGroup(),
+                stdio: ["ignore", "pipe", "pipe"]
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const errorCode = error && typeof error === "object" && "code" in error && typeof error.code === "string" ? error.code : null;
+            resolve({ status: null, stdout: "", stderr: "", error: message, errorCode });
+            return;
+        }
         const stdout = [];
         const stderr = [];
+        let outputBytes = 0;
         let settled = false;
         let timedOut = false;
+        let outputExceeded = false;
         const finish = (result) => {
             if (settled)
                 return;
@@ -53,11 +170,24 @@ function commandVersion(command, timeoutMs) {
             resolve({ ...result, stdout: Buffer.concat(stdout).toString("utf8"), stderr: Buffer.concat(stderr).toString("utf8") });
         };
         const timer = setTimeout(() => { timedOut = true; killProcessGroup(child); }, timeoutMs);
-        child.stdout.on("data", (chunk) => { if (Buffer.concat(stdout).length < 64 * 1024)
-            stdout.push(chunk); });
-        child.stderr.on("data", (chunk) => { if (Buffer.concat(stderr).length < 64 * 1024)
-            stderr.push(chunk); });
-        child.once("error", (error) => finish({ status: null, error: error.message }));
-        child.once("close", (status) => finish({ status, error: timedOut ? "command timed out" : null }));
+        const collect = (target) => (chunk) => {
+            if (settled)
+                return;
+            outputBytes += chunk.length;
+            if (outputBytes > maxCommandOutputBytes) {
+                outputExceeded = true;
+                killProcessGroup(child);
+                return;
+            }
+            target.push(chunk);
+        };
+        child.stdout.on("data", collect(stdout));
+        child.stderr.on("data", collect(stderr));
+        child.once("error", (error) => finish({ status: null, error: error.message, errorCode: error.code ?? null }));
+        child.once("close", (status) => finish({
+            status,
+            error: timedOut ? "command timed out" : outputExceeded ? "command produced too much output" : null,
+            errorCode: null
+        }));
     });
 }

package/dist/server/i18n.js

@@ -69,6 +69,7 @@ const enMessages = {
     PROJECT_CREATE_FORBIDDEN: "You do not have permission to create projects.",
     PROJECT_DELETE_FORBIDDEN: "Only the project owner can delete this project.",
     PROJECT_EDIT_FORBIDDEN: "You do not have edit permission for this project.",
+    PROJECT_ICON_INVALID: "Enter a valid installed Lucide icon short name.",
     PROJECT_NOT_FOUND: "The project does not exist or is no longer accessible.",
     PROJECT_OWNER_ONLY: "Only the project owner can perform this action.",
     PROJECT_TRANSFER_FORBIDDEN: "Only the current project owner can transfer ownership.",
@@ -91,10 +92,15 @@ const enMessages = {
     SYMLINK_FORBIDDEN: "Symbolic links are not allowed in project sources.",
     SYNC_PDF_INVALID: "The PDF location is invalid.",
     SYNC_SOURCE_INVALID: "The source location is invalid.",
+    TAG_NAME_EXISTS: "You already have a tag with this name.",
     TAG_NOT_FOUND: "The selected tag does not exist.",
     UPLOAD_EMPTY: "No file was selected for upload.",
     USERNAME_INVALID: "The username may contain only letters, numbers, dots, hyphens, or underscores.",
     USER_NOT_FOUND: "The user does not exist or is disabled.",
+    WORD_COUNT_FAILED: "TeXcount could not count this source.",
+    WORD_COUNT_SOURCE_INVALID: "Select LaTeX source text to count.",
+    WORD_COUNT_SOURCE_TOO_LARGE: "The selected source is too large to count.",
+    WORD_COUNT_UNAVAILABLE: "TeXcount is not available on this server. Install it from TeX Live and try again.",
     ZIP_DUPLICATE_ENTRY: "The ZIP archive contains a duplicate filename: {{path}}.",
     ZIP_ENTRY_READ_FAILED: "A ZIP archive entry could not be read.",
     ZIP_ENTRY_TOO_LARGE: "The ZIP archive contains a file that exceeds the permitted size.",
@@ -189,6 +195,7 @@ const zhMessages = {
     PROJECT_CREATE_FORBIDDEN: "管理员尚未授予你创建项目的权限。",
     PROJECT_DELETE_FORBIDDEN: "只有项目所有者可以删除项目。",
     PROJECT_EDIT_FORBIDDEN: "你没有此项目的编辑权限。",
+    PROJECT_ICON_INVALID: "请输入已安装的有效 Lucide 图标短名称。",
     PROJECT_NOT_FOUND: "项目不存在或你已无法访问。",
     PROJECT_OWNER_ONLY: "只有项目所有者可以执行此操作。",
     PROJECT_TRANSFER_FORBIDDEN: "只有当前项目所有者可以转让项目。",
@@ -211,10 +218,15 @@ const zhMessages = {
     SYMLINK_FORBIDDEN: "项目源码中不允许使用符号链接。",
     SYNC_PDF_INVALID: "PDF 位置无效。",
     SYNC_SOURCE_INVALID: "源码位置无效。",
+    TAG_NAME_EXISTS: "你已经有同名标签。",
     TAG_NOT_FOUND: "所选标签不存在。",
     UPLOAD_EMPTY: "没有选择要上传的文件。",
     USERNAME_INVALID: "用户名只能包含字母、数字、点、横线或下划线。",
     USER_NOT_FOUND: "用户不存在或已被禁用。",
+    WORD_COUNT_FAILED: "TeXcount 无法统计这段源码。",
+    WORD_COUNT_SOURCE_INVALID: "请选择 LaTeX 源码后再统计。",
+    WORD_COUNT_SOURCE_TOO_LARGE: "所选源码过大，无法统计。",
+    WORD_COUNT_UNAVAILABLE: "服务器未安装 TeXcount，请安装 TeX Live 后重试。",
     ZIP_DUPLICATE_ENTRY: "ZIP 压缩包包含重复文件名：{{path}}。",
     ZIP_ENTRY_READ_FAILED: "无法读取 ZIP 压缩包中的文件。",
     ZIP_ENTRY_TOO_LARGE: "ZIP 压缩包中存在超过限制的文件。",